PhpGreetz version 0.99 (04/03/01) Documentation
* The latest documentation can be found at http://www.phpgreetz.org/docs/ *
phpGreetz Development Team
http://www.phpgreetz.org/
Prerequsites
To install and run phpGreetz, you will need to have working installations of the following on your
server:
- Apache (www.apache.org) or IIS (www.microsoft.com/iis) Web Server
- PHP version 4.0 or higher (www.php.org) (note 1)
- MySQL version 3.23 or higher (www.mysql.com) (note 2)
- ImageMagick toolkit (www.imagemagick.org)
Notes:
1. PHP may be installed either as a CGI executable or an Apache module. The
recommended version is 4.0.4pl1
2. MySQL does not necessarily need to be installed on the same machine as the web
server. You need to make sure you have access to create a database and import table
structures. It is also recommended that you create a new database user account with
full access to the database you create for phpGreetz. For more information, you may
want to see your system administrator or the MySQL documentation for more
information.
Getting the Latest Version and Unpacking the Archive
The latest version of phpGreetz can be downloaded at http://www.phpgreetz.org/. A list of
mirrors sites is also listed for faster downloading.
To unpack a tar.gz archive, simply run:
- gzip -d {archive name}.tar.gz
- tar xvf {archive name}.tar
To unpack a ZIP archive, typically you would run:
- unzip {archive name}.zip
on UNIX variants
- or on Windows machines, you may use WinZip (www.winzip.com) to uncompress the
archive.
Setting Up MySQL
You will need a privileged account already set up in MySQL to create a new database and
import the table structure. Please see the MySQL documentation for more information on
accounts.
To create a new database, you would simply log into the MySQL client (by running 'mysql -
u{userid} -p{password}') and executing the SQL statement "create database phpgreetz;".
To import the table structure, log back into the MySQL client, this time specifying the database
('mysql -u{userid} -p{password} phpgreetz') and piping in the webgreetz-db-structure.sql file
(an example command would be 'mysql -uroot -psecret < webgreetz-db-structure.sql').
You may also want to create a new user account in MySQL and grant it full access to the
phpGreetz database, however this is optional. It is secure enough to use a 'root' account. See
the MySQL documentation for more information.
Setting Up the Web Server
You will need to set up your web server to recognize index.php as the home page for
phpGreetz. On Apache, you will need to modify your DocumentIndex configuration directive
and on IIS, you need to add index.php to your list of default documents for your particular
virtual website. Please see your web server's documentation for more details and information.
You may opt to create a subdomain or virtual web for serving phpGreetz, however it is not
required. Again, see your web server's documentation for exact details.
Configuring phpGreetz
Open the includes/phpGreetz-global.inc.php file for editing using your favorite text editor.
Within that file are a number of variables that you will need to set and customize to fit your
needs. The file contains examples and more information on each variable you need to change.
Configuring PHP
You need to find out your PHP include path. We have included a sample file, test.php, that will
show your current PHP configuration. Look for the directive "include_path" and copy the
includes/phpGreetz-global.inc.php file into one of those directories (not the "." drectory though
- on Linux it defaults to /usr/local/lib/php directory, which will require superuser access to copy
files to).
Alternatively, you may modify your php.ini or Apache configuration file to set the include path.
Please see the PHP documentation for more information.
Ready to Go!
You should be ready to run phpGreetz and can log into the Administrative interface by going to
the /admin/ directory and logging in as 'admin' and the password 'admin'. From there, you will
be given detailed instructions on how to create a graphic category, upload graphics into the
database, and further configuration of the software.
If you have trouble installing or running the software, please email us at hide@address.com
or check our website at http://www.phpgreetz.org/