Location: PHPKode > projects > PhpGreetz > phpgreetz-v0.99/PhpGreetz-docs.txt
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/

Return current item: PhpGreetz