Requirements

PeoplePress requires ...

• A webserver that runs PHP and that has the ImageMagick 'convert' utility installed
• A MySQL database

Installation

The installation process is a bit primitive at the moment. But here goes ...

Install the Files

• Download the latest peoplepress_r###.zip file to your website's home directory.
• Unzip the file. By default, this unpacks the contents into the 'peoplepress' directory
• Edit config.php to reflect the URL of the PeoplePress directory. E.g.

define('PP_ROOT', 'http://mysite.com/peoplepress');   

note: Make sure you've set the permissions properly so that your web server process can read all files. Also make sure the 'peoplepress/uploads' directory is writeable.

Set up MySQL

• Create the PeoplePress table (named 'pp_entries' by default) as follows:

  mysql -p -u my_login -h my_host my_database < config_schema.sql

(my_login, my_host, and my_database would of course be whatever you use for mysql)

• Edit config.php to reflect your database configuration. E.g:

define('PP_ENTRIES', 'pp_entries');
define('PP_HOST', 'mysql.my_host.com');
define('PP_NAME', 'my_database');
define('PP_PASSWORD', 'my_p4ssw0rd');
define('PP_USER', 'my_login');

Configure the master password

For admin purposes, PeoplePress supports a master password that will allow you to edit/delete any entry on the site. To enable this:

• Create an MD5-encoded password at http://scriptserver.mainframe8.com/md5.php
• Edit config.php and change the PP_MASTER_PWD setting to your MD5 string. E.g.:

define('PP_MASTER_PWD', '5f4dcc3b5aa765d61d8327deb882cf99');

(the above string is the MD5 encoded string for, "password", and is for illustrative purposes only.)

Enable Google Maps Integration

• Visit http://www.google.com/apis/maps/ to sign up for a Google Maps key (it's free and easy).
• Edit config.php to change PP_GEOCODE_KEY to your key: E.g. :

define('PP_GEOCODE_KEY', 'ABQIAAAAI-S195-UESTVKWGNPGsdPxRQjen7QNgPYdAYAkMkEZawfRtjmRSRX4CsmToeM-ZyZP7vRNjq45sZ4w');

(the above key will work if you just want to try things out, but you'll be sharing it with anyone else who uses it. Caveat Emptor.)