Installation can be as simple as uploading the install script, install-etp.php
, to your webserver
and directing your browser to it. Unzip the archive from the download page and upload install-etp.php
to the directory on your webserver in which you wish to install EditThisPagePHP.
After installation, you can modify any configurations set in the wizard. Configuration is found in a file with a
name like edithispage-index.php
. Please see the README included with this distribution for
more information.
Both the install script and EditThisPagePHP must be able to write
to themselves, and to the directory in which they are located. Some servers are configured to allow
this (through suexec). If not, you will need to change permissions on install-etp.php
and the directory you are installing in. The first step of the install wizard tests for this.
You may need to change permissions on the install file, and the directory in which you are installing EditThisPagePHP so that the webserver can write to them. Most FTP clients have a permissions dialog with checkboxes to make files and directories "world writeable". If not, you may need to do the following from the command line, or from the shell extension of your FTP client:
Change to the directory to which you uploaded install-etp.php Make the file world writeable: chmod a+w install-etp.php Make the directory accessible to all: chgrp chmod a+w,a+x ./
The hostname of your server will need to be set. This is used for creating links to images, RSS feeds and in the administration functions. The installer should be able to guess your hostname correctly.
If you want people to be able to read the page without having an account and password, select "yes" to enable guest access.
Enable email notifications on page changes, and set the user email will appear to be from.
Set the title and description for the RSS feeds. Each page has two feeds, one with the full content of the current page, and a diff feed showing changes made on the page.
You will be asked to confirm your settings here. If any required steps have been missed, you will be prompted to complete them before continuing.
Installation is complete. You can remove the install script and continue to the newly created page, or create another page.
Comments
My ISP has the PHP safe_mode constant turned on. This causes problems with the installation script as ETP is not able to create files in a directory that was created by itsself. For more information about why this is happening have a read of http://uk2.php.net/manual/en/features.safe-mode.php.
Note that ETP is able to create files in directories that already exist and are owned by the same user who owns the ETP.php script, but it is not able to create files in directories that have been created by ETP because the directories created by ETP are owned by the apache user.
Is it absoultely necessary for ETP to create its own directories? If it only needs directories whose names are predefined then these can be created by the FTP user before installation.
Posted by Mark Wrangham at 2005-02-02 03:07:11 / PST