NOTE: This the 'master' Branch, is the generic version of the project, it's not actively maintained, but major functions may be committed here. The actual regional projects, currently Geograph "Britain and Ireland", "Germany", and "Channel Islands", have their own active branches. https://github.com/geograph-project/geograph-project/tree/british-isles https://github.com/geograph-project/geograph-project/tree/germany https://github.com/geograph-project/geograph-project/tree/channel-islands They will typically have more active development. There are other branches used for development of various things, but these are the actively launched sites. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ======================================================================= GEOGRAPH README ======================================================================= A) Introduction B) Directory Structure C) Installation D) Getting Started E) Adapting for other countries A) Introduction ----------------------------------------------------------------------- GeoGraph is web based project to collect and reference geographically representative images of every square kilometer of the British Isles, but the software is being designed to allow it to be adapted for similar projects in other countries For more info about the UK GeoGraph project visit http://www.geograph.org.uk/ The GeoGraph software is licenced using the GNU General Public Licence, see LICENCE.txt for details. B) Directory Structure ----------------------------------------------------------------------- config-examples/ example configuration for the geograph project libs/adodb/ adodb database library (LGPL) download the latest release from http://adodb.sourceforge.net libs/geograph/ geograph specific classes and library code (GPL) libs/smarty/ Smarty templating library (LGPL) download the latest release from http://smarty.php.net public_html/ web root public_html/templates/basic/ basic smarty template and supporting files - as other site templates are developed, they would go into similar directories at this level. All template specific graphics and CSS files are stored here also. schema/ mysql database schema C) Installation ----------------------------------------------------------------------- This software requires PHP 4.3 or higher, and was designed to run on apache webservers using the php4 module. Y 1. unpack the files into <basedir> 2. configure apache with a virtual host for the geograph site using the file in config-example/apache/geograph.conf as a guide. 3. create a new mysql database and create a user with all privileges on it. 4. initialise the database using schema/schema.mysql (e.g. mysql geograph < schema.mysql) 5. Copy libs/conf/www.exampledomain.com.conf.php to libs/conf/<**yourdomain**>.conf.php 6. Edit this configuration file with your database credentials. You should also edit other configuration entries such as contact_email, register_confirmation_secret and photo_hashing_secret. 7. Restart apache and attempt to access http://<**yourdomain**>/test.php - this will test your installation and report back on anything that must be fixed 8. Once test.php reports success, you're good to go! D) Getting Started ----------------------------------------------------------------------- Register as a user via site to admin privileges. The very first user (user_id=1) is automatically a admin. Now you can log in and access administrative functions of the site. One of the first tasks is to initialise the gridsquare table with valid gridsquares by using a 1km-per-pixel greyscale PNG. Run the admin/gridbuilder.php script to perform this task. (or can use gridsquare.mysql.bz2 to get a empty Britain & Ireland map) Once that is done, the system is ready to accept photographs. E) Adapting for other countries ----------------------------------------------------------------------- The code as supplied is ready for the British Isles, and we're happy to help make changes to support other geographical areas. At the very least, you'll need to do the following: 1. Copy the templates/basic directory to templates/<**country**> and edit the logo graphics and any other British Isles specific text 2. Change the configuration file to specify the new template name, e.g. $CONF['template']='<**country**>'; 3. Clear the gridprefix table and fill it with the grid square prefixes used in your region 4. Create a 1km-per-pixel greyscale PNG of your region, where white is sea and black is land, and shades of grey represent squares with varying degrees of land present, clear the gridsquare table and run the admin/gridbuilder.php script to initialise the gridsquare table.