/*
    Pagetool
    Copyright 2001,2002 Pagetool Development Team
    pagetool-user@lists.sourceforge.net http://www.pagetool.org/
    $Id: README.txt,v 1.5 2004/03/28 22:59:26 daveguerin Exp $
*/

Pagetool 1.xx

README

For the most recent information about this version of Pagetool (including the 
install instructions, readme, to do, etc.) go to:

http://www.pagetool.org

PRE-INSTALL DIRECTIONS

1. INTRODUCTION

Pagetool is a lightweight "content management system" that allows you to set up 
your website so that people with limited technology skills can make 
modifications to your website without knowledge of HTML programming.

This installation guide is provided along with the Pagetool software 
distribution. An Admin manual for the person who will administer Pagetool, and a 
User guide for those who will be using Pagetool to modify your web site, are 
both include in the distribution.

Details on creating and using Pagetool Plugins is available on the main Pagetool 
web site, http://www.pagetool.org

Various plugins are also available, including:

pt_admin_man_es      The Admin manual in Spanish.
pt_create_plugin     A plugin used to create other plugins.
pt_downloads         Gives a list of files, with descriptions, to download.
pt_edit_this_page    Gives an "edit this page" link on a page.
pt_functions_man_en  Details all the Pagetool functions available to plugins
pt_language_man_en   How to have Pagetool a language other than English.
pt_link_check        Checks all the http links on your site.
pt_mailx             Add and edit forms for e-mail inquiries from your site.
pt_media_sync        Sync the media directory and the Pagetool database.
pt_plugin_man_en     How to create your own Pagetool plugins.
pt_user_man_es       The User manual in Spanish.
pt_whats_new         Gives a page listing "What's New" on your site.

See http://www.pagetool.org/index.php?name=plugins for further details.


2. PREREQUISITES

Before you begin, you need to have a web server or a shared "virtual hosting" 
account on a web server that has at least the following installed and running:

- the PHP4 web scripting language (version 4.00 or higher) installed as a 
module. Pagetool won't work "out of the box" with the CGI version because of the
authentication used. But all is not lost, it is posssible to use Pagetool with 
PHP in cgi mode, please see README_CGI.txt for more details. 

- a version of the MYSQL database server that works with PHP4.
 
- the Apache web server (it may be possible to run Pagetool on an IIS/ISAPI system, 
but we have not tested it yet).


If you are using Pagetool on a shared server, be sure to read the SECURITY.txt 
document to make sure that you do not inadvertently give access to your Pagetool 
passwords or scripts to other accounts on that shared server.

3. STEP-BY-STEP Setup Instructions

a.  Download the Pagetool Software

b.  Unpack the file, either before or after moving it to the home directory of 
your shared hosting account (whichever is easier for you).  The Linux commands 
to unpack the downloaded file are: gunzip <pagetoolfile> tar -xf <unzipped 
pagetool file>

The result of unpacking will be a directory called pagetool-1.xx that will 
contain everything. xx will be the current verison number.

c.  Move all the pagetool files and directories to the directory that houses 
your web site.  (Be sure to scan the list first so that you do not overwrite 
files in your web folder that have identical names.)

Again, in Linux, this might look like: mv pagetool/* www    (or) mv pagetool/* 
/web

Pagetool can be installed in a subfolder of your www folder.  

d.  Next create your database. If you are using an ISP, you may need to ask the 
support department to help you if there is not an option for this on your 
website control panel.  For the next step, you will need to know the database 
name and at least one username/password combo with full access to the data 
(including drop, create, and alter table privileges).

If you are creating the database yourself you will want to first create the 
database:

$ mysqladmin -u root -p create <database-name>

Then run MYSQL as root:

$ mysql -u root -p mysql

To verify your database exists, you can type to mysql:

mysql> show databases

and a list including the database you just created should appear.

Finally, from the mysql> prompt, insert a new user. Admin is a suggestion, but 
you can use any user name that you like.  If your website resides on the same 
server as your database, then leave "localhost" as is.  However, if your web 
site is on a different server, then replace "localhost" with your web domain 
(i.e. www.mydomain.org). The following should be entered as one MYSQL command 
(it's OK to press enter between the lines; MYSQL knows you are done when it sees 
the semicolon at the end):

GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP ON <database-name>.* TO 
admin@localhost IDENTIFIED BY 'make-up-a-password-here';



e.  Once you have successfully created a database, write down the database name, 
user name and password and then run the Pagetool Installer.  This installer can 
be launched from the web by pointing your browser to "src/setup" within the web 
folder where pagetool resides:

http://www.mydomain.org/src/setup/

Then follow the instructions on the screen.

Enjoy! :-)

If you have problems then ask on the pagetool-user email list. See:

http://lists.sourceforge.net/lists/listinfo/pagetool-user

Searching the list archives first might be an idea :-) See:

http://sourceforge.net/mailarchive/forum.php?forum_id=7949

