--------------------
| GENU version 2.2 |
--------------------
Copyright: (C) 2003-2005 Raoul Proença <raoul <at> genu <dot> org>
License: GNU GPL (see COPYING)
Website: http://genu.org/
I. Introduction:
----------------
GENU is a comments, news, polls, posts and users management system written with PHP language and using a database server (MySQL, PostgreSQL or SQLite). It is fully customisable since it use templates system and support multiple language.
II. Requirements:
-----------------
Installation of GENU requires the following:
- A webserver or web hosting account
- PHP 4.2.0 or higher (with mail function enabled, preferably)
- A MySQL database (3.23.23 or higher) or a PostgreSQL database (6.5.x or higher) or SQLite database support in PHP 5.x
III. Upgrading from GENU-1.x or GENU-2.x releases: (testing releases not supported)
--------------------------------------------------
You must have a working GENU-1.x or GENU-2.x installation (MySQL database server only).
1) Backup all .css, .tpl and languages files that you have modified in a new directory. You will have to apply these changes to the same files in GENU-2.2 archive if necessary.
2) Decompress the GENU-2.2 archive to a local directory on your system.
3) Replace all files of your current GENU installation. Upload all the files (retaining directories structure) to a web accessible directory on your webserver or hosting account (all .css, .js, .php, .sql and .tpl files should be uploaded in ASCII mode!).
On Linux / Unix systems:
3.1) Change the permissions of these directories to be writeable by all (777 or drwxrwxrwx within your FTP client):
backends/
db/
includes/
images/categories/
images/smilies/
3.2) Change the permissions of these files to be writeable by all (666 or -rw-rw-rw- within your FTP client):
online_users.txt
backends/backend.txt
backends/backend.xml
db/genu.db
includes/config.php
3.3) Do the same with all .css, .js and .tpl files located in the templates directory and its subdirectories.
4) Using your web browser visit the location you placed GENU with the addition of install/upgrade.php, for example http://www.domain.tld/GENU/install/upgrade.php.
5) Fill out all the requested informations and choose which version of GENU you want to upgrade.
IV. Installation:
-----------------
1) Decompress the GENU-2.2 archive to a local directory on your system.
2) Upload all the files (retaining directories structure) to a web accessible directory on your webserver or hosting account (all .css, .js, .php, .sql and .tpl files should be uploaded in ASCII mode!).
On Linux / Unix systems:
2.1) Change the permissions of these directories to be writeable by all (777 or drwxrwxrwx within your FTP client):
backends/
db/
includes/
images/categories/
images/smilies/
2.2) Change the permissions of these files to be writeable by all (666 or -rw-rw-rw- within your FTP client):
online_users.txt
backends/backend.txt
backends/backend.xml
db/genu.db
includes/config.php
2.3) Do the same with all .css, .js and .tpl files located in the templates directory and its subdirectories.
3) Using your web browser visit the location you placed GENU with the addition of install/index.php, for example http://www.domain.tld/GENU/install/index.php.
4) Fill out all the requested informations.
V. Post-installation:
---------------------
1) Remove install folder from your server.
2) Using your favorite editor or from the administration interface, edit all templates files located in templates directory to make your site looks whatever you want.
3) Have a look at the language files located in languages directory if necessary.
4) Don't forget to create at least one category (in the administration area) before trying to add news.
Please, let me know your opinion about GENU.
