README - PageEdit (4.05)

• Release Notes
• Licence Agreement
• Package Contents
• Installation Instructions
• Using the PageEdit
• Creating Custom Templates
• Future Development
• Support

This release marks a new direction in developent. The interface, although somewhat similar to previous versions, has a new, more customisable look. Now you can choose the colours, fonts and font sizes. Also, you are able to enable or disable the features that you want to use.

Other enhancements see a cookie based login system which allows for a much tighter integration of the multi-user add-on and the basic single-user package. As a result, this will also help speed up the process of mataining the package with more regular updates and enhancements.

A minor bug which changed templates when going back to edit webpages has been fixed. Another bug, which broke php tags in has been fixed.

The upload script has been improved to work with OmniWeb browser for Mac OSX. More meaningful error messages have also been included to explain why uploads may have failed.

And finally a much needed help update to the help file has been included in this release.

There has been more, but I don't want to bore you with all the details. In a nutshell, this release is just better than all previous versions.

PageEdit © 2000-2002 Martin Phillips.

Version - 4.05
Released - 12 Jan 2002
Author - Martin Phillips

You should carefully read all of the following notice before installing and using this package. Do not proceed unless you agree, any use of this package, in whole or part indicates your acceptance of these conditions of use.

Martin Phillips hereby grants you, the original purchaser a non-exclusive license to use the PageEdit package subject to this agreement.

You may install this package once only on a single computer/server. You may transfer the package from one computer to another provided that you do not use or permit the installation of the package on more than one computer at the same time.

You may not copy or duplicate the package, except as necessary for archival purposes, application error verification, or to replace defective storage media. You agree to retain the package and all such copies in your possession.

Except as permitted by this paragraph, you may not sub-licence, lease, rent, lend, or distribute the package or any lawful copies thereof; or otherwise transfer any of your rights under this agreement. You may transfer the package (together with all back-up copies you have made) on a permanent basis to a third party so long as you retain no copies, and the transferee agrees to be bound by the terms of this agreement.

The source code of this package (.pl and .cgi files) may not be modified, adapted or translated without written permission from the author and copyright holder, other than the necessary configuration (as described in the installation instructions). The addition of new HTML templates, Style Sheets and HTML navigation templates is permitted.

Selling the code for this package or distributing the package in part or whole without prior written consent is expressly forbidden.

All of the original copyright notices and associated disclaimers must remain intact.

THIS PACKAGE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL THE AUTHOR OR COPYRIGHT HOLDER BE LIABLE FOR LOSS OF PROFIT, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS, INCLUDING BUT NOT LIMITED TO SPECIAL INCIDENTAL CONSEQUENTIAL OR OTHER DAMAGES. LICENSEE WILL NOT HOLD THE AUTHOR OR COPYRIGHT HOLDER RESPONSIBLE FOR ANY CONSEQUENCES ARISING FROM LICENSEE'S USE OF THE PACKAGE. LICENSEE WILL HOLD HARMLESS THE AUTHOR OR COPYRIGHT HOLDER FOR ANY LOSSES OR DAMAGES OF WHATSOEVER NATURE ARISING FROM LICENSEE'S USE OF THIS PACKAGE.

The diagram below shows all the files contained in the PageEdit package, when the package is unzipped. In addition the comments in red are intened to help you better undertand the installation instructions. When installing the package it is important to maintain the same file names and directory structure that is outlined below.

---+ PageEdit
   |
   |---+ README.txt ( Refer to => TEMPLATES/HELP/index.html)
   |
   |---+ PE (copy this directory into your cgi-bin and chmod 777)
   |   |
   |   |---+ edit.cgi (set path to Perl and chmod 755)
   |   |---+ preview.cgi (set path to Perl and chmod 755)
   |   |---+ setup.cgi (set path to Perl and chmod 755)
   |   |---+ upload.cgi (set path to Perl and chmod 755)
   |   |---+ admin.cgi (set path to Perl and chmod 755) * Multi-User Version Only
   |   |---+ config_lib.pl (set config to suit your needs and chmod 644)
   |   |---+ config_multi_user_lib.pl (set config to suit your needs and chmod 644) * Multi-User Version Only
   |   |---+ create_webpage_lib.pl (chmod 644)
   |   |---+ shared_lib.pl (chmod 644)
   |   +---+ templates_lib.pl (chmod 644)
   |
   +---+ TEMPLATES (upload the contents of this directory to your BASEDIR and
       |               set chmod 777 your BASEDIR)
       |
       |---+ PEtemp_001.txt
       |---+ PEtemp_002.txt
       |---+ PEtemp_003.txt
       |---+ PEtemp_004.txt
       |---+ PEtemp_005.txt
       |---+ PEtemp_CSS_001.txt
       |---+ PEtemp_CSS_002.txt
       |---+ PEtemp_CSS_003.txt
       |---+ PEtemp_nav_001.txt
       |---+ PEtemp_nav_002.txt
       |---+ PEtemp_nav_003.txt
       |---+ PEtemp_nav_004.txt
       |
       +---+ images (chmod 777)
       |
       +---+ HELP
           |
           |---+ index.html (this file)
           |---+ help.html (how to use the PageEdit)
           +---+ img.gif

1. Change the first line of the edit.cgi, upload.cgi and setup.cgi to reflect the location of Perl on your server.

2. Change the configuration file (config_lib.pl). Full explanation can be found in that file.

3. Upload the entire PE directory to your cgi-bin. Be sure to do this in ASCII mode.

4. Set permission of the cgi-bin/PE directory and the files it contains as described in the package contents.

  CHMOD 777
      OWNER = Read - Write - Execute
      GROUP = Read - Write - Execute
      OTHER = Read - Write - Execute

  CHMOD 755
      OWNER = Read - Write - Execute
      GROUP = Read -       - Execute
      OTHER = Read -       - Execute

  CHMOD 644
      OWNER = Read - Write - 
      GROUP = Read -       - 
      OTHER = Read -       - 

5. Upload the contents of the contents of the PE_templates directory to the directory on your server where you want your webpages created. This directory is called your BASEDIR. If you have done this correctly you will have an images and a HELP sub directory within your BASEDIR.

6. Set permissions of your BASEDIR and BASEDIR/images directories to chmod 777. Be sure to check with your system administrator before proceeding as this may be seen as a potential security risk.

7. Go to the URL of setup.cgi and check to see if the installation has be properly completed. The first time you use PageEdit you will be prompted for an administrator's login and password. Once you are sure that the installation in complete the setup.cgi file may be deleted from the server.

8. To start using the script point your browser to the URL of the edit.cgi file.

Additional Installation Instructions for Multi-User Add-On

1. Change the first line of the admin.cgi to reflect the location of Perl on your server.

2. Change the multi-user configuration file (config_multi_user_lib.pl). Full explanation can be found in that file.

3. Upload the entire PE directory to your cgi-bin. Be sure to do this in ASCII mode.

4. Set permission of the cgi-bin/PE directory and the files it contains as described in the package contents.

For information about how to use this package to create and maitain your own website CLICK HERE.

If this help document does not provide the answers you are looking for contact support@aus-etrade.com with a detailed description of your problem and the version of the package that you are using.

If you wish to create your own templates, the best starting point is the take a look at the templates included with this package. In the header of each file, there are a few lines defining page elements. And, throughout the templates there are some special tags where content is inserted.

Templates must be named as follows "PE4temp_template.txt". You can insert any text you like where "template" is currently situated.

Colour schemes must be named as follows "PE4temp_CSS_template.txt". You can insert any text you like where "template" is currently situated.

A more detailed set of instructions for creating your own templates will be available soon, be sure to check back at the aus-etrade.com website for updates.

• More templates availablle for download
• Enhanced text editor for editing raw code
• Improved documentation - especially in the area of creating your own templates
• More control over individual users from the admin panel of the multi-user version
• User support forum - to allow sharing of templates and problem solving
• More ideas?? You too can be a part of the future development by providing feedback and suggestions.

For and feedback, un-documented feature (bug) reports, or suggestions for future enhancements, send and email to support@aus-etrade.com.

© 2000-2001, Martin Phillips