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 < phpgreetz-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 support@phpgreetz.org or check our website at http://www.phpgreetz.org/