// ------------------------------------------------------------------------- //
// phpFullAnnu - Portail / Annuaire de site avec gestion franais/anglais    //
// ------------------------------------------------------------------------- //
// phpFullAnnu - Portal / Links directory with management french/english     //
// ------------------------------------------------------------------------- //
//       Copyright (C) 2001  Sylvain MICHEL <webmaster@netsliver.com>        //
// ------------------------------------------------------------------------- //
//                   NetSliver <http://www.netsliver.com/>                   //
// ------------------------------------------------------------------------- //
//  This program is free software; you can redistribute it and/or modify     //
//  it under the terms of the GNU General Public License as published by     //
//  the Free Software Foundation; either version 2 of the License, or        //
//  (at your option) any later version.                                      //
//                                                                           //
//  This program is distributed in the hope that it will be useful,          //
//  but WITHOUT ANY WARRANTY; without even the implied warranty of           //
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the            //
//  GNU General Public License for more details.                             //
//                                                                           //
//  You should have received a copy of the GNU General Public License        //
//  along with this program; if not, write to the Free Software              //
//  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA //
// ------------------------------------------------------------------------- //
//                                INSTALLATION                               //
// ------------------------------------------------------------------------- //

INFORMATION
------------
This application uses the phplib class, Visiteurs 2 of J-Pierre Dezelus
(http://www.phpinfo.net/), and the Phorum 3.2.11 application (http://phorum.org/).
I naturally thank J-Pierre for the application for the statistics of
frequence, and the creators of Phorum and those of the phplib class.

Please put a link towards my site for those that use phpFullAnnu!!


NEWS
------------
- Since the version 3.3.1 :
	- Addition of the system to allow voting with cookies.
	- A cookie is sent to avoid users voting more than once.
	- More templates for the appearance of the links, news,
          golden book...
	- You can really choose which modulates removed.
	- Correction of different bugs.
- Since the version 3.3 :
	- Correction of the mask system.
- Since the version 3.0 :
	- Creation of the script of installation.
	- Insertion of the system of mask.
	- Complete translation in english of the explanations and the admin.
	- The name of tables can be chosen in the installation and modify by the
	  administration.
	- The number of links in the categories is indicated next to her name.

- Since the version 2.0 :
	- I changed class for the templates which was before FastTemplate to pass
	  in phplib which is it seems faster...
	- The path of categories indicated on the page with the links to return
	  to the category relative.
	- One can subject sites from all the pages of the links directory, there is
	  so a list of the categories which can contain links on the form.
	- Button to close the window of comments.
	- Correction of an error on the page looks for of Phorum.
	- The guest can sort out the links in choices in both directions according to : 
		- Site name
		- Submit date
		- Number of hits
	- Insertion of smileys on Phorum.
	- Search module in the administration for the links.
	- For the happy owners of the function mail, a newsletter.

- Since the version 1.0 :
	- Addition of a guestbook.
	- Comments on the links and the news.
	- Correction of some small neglect :
		- Messages of the category new empty site.
		- Link of addition of site which displayed on the home when there was
		  no category.
		- When one was on news on the page 5 for example and when one passed
		  in the other language which had less of it that became empty naturally,
		  so maintaining return on the page 1.
		- Question during the submission instead of an alert.


INSTALLATION
------------
- Please, unzip the archives into a directory on your server Web by keeping the arborescence
  of files.

	#################################################
	#	    phpFullAnnu configuration		#
	#################################################

- For the new :
	- Please , simply open your favourite browser and point to the install directory and fill
	  forms, everything is managed automatically by the script...

  ATTENTION: if you have an error from the arrival on the install directory, do not proceed
             any further, it is necessary to install via the script. First edit the following files
             config.inc.php3, lang/english.php3, lang/french.php3.
  
  The tables of the forum are created automatically when you ask to create the forum,
  for stats see below.

- For all the users of the previous versions :
	- Please, resume all the directories and the files of phpFullAnnu except phorum, stats
	  and install.
	- In phorum : 
		In the directory include: files "footer.php3" and "header.php3", 
		for smileys : read.php3 , form.php3 (include), smileys.html for smileys.
	- In stats :
		Also, please, resume in the directory include files "footer.inc.php" and
		"header.inc.php", you can also start again if it is not already made,
		the file "config.inc.php3" I added it Win XP and IE's 6.0 recognition.

- For the users of version 1.0 :	
	- Please, create tables : guestbook  --> guestbook.sql
			          comments   --> comments.sql
			          newsletter --> newsletter.sql
	  The name of tables can be modified via the admin section

- For users of version 2.0 :
	- Please, create table newsletter --> newsletter.sql

- For all users of the previous versions :
	- Edit the file config.inc.php3 and enter the value for $weburl.
	- Please, go to the administration on the menu "Configuration" to update the file
	  of configuration, take the stages in the order of the menu.

- For everyone :)) :
	- Please, go on your tool of administration of database (ex : phpMyAdmin),
          click your database, the button cross under the dialog box,
          and choose the modifs.sql file and click "Execute", this file allows
          the update of tables for the votes... 
	- Please, edit the templates which is in the directory tpl (originally)

  ATTENTION IN THESE TEMPLATES THERE IS EVERY TIME A SMALL EXPLANATION YOU HAVE
  IN THE COMMENT THE VARIABLES WHICH YOU CAN USE TO USE THESE VARIABLES IT IS
  ENOUGH TO PUT THIS ONE ENTERS { AND }
  The {MENU} can be put on any template repeatedly...
  EX : ADDIMG --> {ADDIMG} what writes the address of the site + the directory images
       (your url : http://www.monsite.com/ and your directory image : images/
        what look http://www.monsite.com/images/).

- Edit the style sheet "style.css" (originally).

- Edit the javascript files :
  Edit both headxx.js files with the title of your site (the first variable).
  Also edit both paraheadxx.js files with the url of your site and the parameters
  of your contextual perso menu if you want to change it.

	#################################################
	#	   Visiteurs 2.0 configuration 		#
	#################################################

- Configuration of the statistics (Visiteurs 2.0 : http://www.phpinfo.net/) :
  Create tables in the directory sql-tables in stats :
	- archives.sql
	- domaines_en.sql or domaines_de.sql
	- visiteurs.sql
  Edit the file "config.inc.php3" by putting in your data in the below variables :
	- Change the line include($lvc_include_dir.'lang/french.inc.php'); by
	  include($lvc_include_dir.'lang/english.inc.php');
	- $lvc_db_host
    	- $lvc_db_user
    	- $lvc_db_password
    	- $lvc_db_database
	- $lvc_site_opening_year //year of the beginning of stats
	- $lvc_site_opening_month //month of the beginning of stats
	- $lvc_ignore_referers[] //both variables to avoid counting the visits which
				   come from your site
	- $lvc_ignore_machines[] //the second to avoid counting your machine
  Edit also the style sheet "visiteurs.css" in the directory css.

	#################################################
	#	       Phorum configuration		#
	#################################################

- Configuration of the forums (Phorum : http://phorum.org) :
  Please, change in the forum, the name of the file admin in adminfr and the adminen in 
  admin to have Phorum's administration in english.
  As for this, it is necessary that you open your browser to the phorum/admin address
  or by the admin of the site you have a link which ammene to you to it there, please,
  be made :
	- Phorum Setup --> Database Settings
	- Files/Paths
	- HTML Settings
	- Global Options
	- Main
	- New Forum
  And then change what you want...


USE
------------
From your part :
	- Masks : They are generated if they are expired, attention it can take many place.
	- Categories :
		- First of all you go on the admin and you create your categories and under categories.
		- You can edit only the names of the categories.
		- You can delete the categories only if there are no more sub categories or if there
                   are links  in this one.
		- You can export the table : useful for a migration or a protection.
	- Links :
		- You can edit the links (title, url, description...).
		- If you put the automatic acceptance, you do not have to accept.
		- A search system is at your disposal, works as part of the site, 
		- You can delete the links which you want.
		- You can export the table : useful for a migration or a protection.
	- News :
		- As well as for the links except for the engine which is not integrated...
	- Guestbook : 
		- You can export the complete book (french and english in the same file).
		- You can export the french alone book.
		- You can export the english alone book .
		- You can delete not wanted messages .
	- Comments : 
		- You can export comments suit (french/english & links/news in the same file).
		- You can export comments alone french/links.
		- You can export comments alone english/links.
		- You can export comments alone french/news.
		- You can export comments alone english/news.
		- You can delete not wanted messages.
	- Newsletter :
		- You send your newsletter via the admin section, it is totally independent from the 
                 news section of the site.
		- You can export the table.

User side :
	- The links can be subjected only in the categories which contain no sub categories,
	  or by meta to look for by the script or by the form.
	  The link to subject sites is available on all the pages of the links directory.
	- Keywords <= 2 letters are not taken into account in the search.
	- A click on one of the arrows of sorting reloads the page according to the choice of the guest.
	- The option "Download sources" returns to download the last version of phpFullAnnu. (A link to my site)
	- The guestbook : a table for two languages so when one subjects on french, the message squeezed
	  to post that on french and also for english.
	- Comments : a table for two languages and two things (links/news), works as the book.

This is it, I hope I have not forgotten anything, THANK YOU ALL!!