// ------------------------------------------------------------------------- //
// 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                               //
// ------------------------------------------------------------------------- //

INFOS
------------
Cette application utilise la classe phplib, Les Visiteurs 2 de J-Pierre Dezelus
(http://www.phpinfo.net/), et l'application Phorum 3.2.11 (http://phorum.org/).
Je tient  remerci bien sr J-Pierre pour son application pour les statistiques
de frquentation, et les crateurs de Phorum et ceux de la classe phplib.

Merci de mettre un lien vers mon site pour ceux qui utilise phpFullAnnu!!


NOUVEAUTES
------------
- Depuis la version 3.3.1 :
	- Ajout du systme de vote avec cookie.
	- Un cookie est envoy pour viter de monter les hits.
	- Un peu plus de templates pour l'apparence des liens, news, livre d'or...
	- On peut vraiment choisir quel module retir.
	- Correction de diffrents bugs.
- Depuis la version 3.3 :
	- Correction du systme de cache.
- Depuis la version 3.0 :
	- Cration du script d'installation.	
	- Insertion du systme de cache.
	- Traduction intgrale en anglais des explications et de l'admin.
	- Le nom des tables peut tre choisi  l'installation et modifier par
          l'administration.
	- Le nombre de liens dans les catgories est indiqu  ct du son nom.

- Depuis la version 2.0 :
	- J'ai chang de classe pour les templates qui tait avant FastTemplate
	  pour passer  phplib qui est semble-t-il plus rapide...
	- Le chemin de catgories indiqu sur la page avec les liens pour retourner
	   la catgorie parente.
	- On peut soumettre les sites  partir de toutes les pages de l'annuaire,
	  il y a donc la liste des catgories qui peuvent contenir des liens sur
	  le formulaire.
	- Bouton pour fermer la fentre des commentaires.
	- Correction d'une erreur sur la page recherche de Phorum.
	- Le visiteur peut trier les liens aux choix dans les deux sens selon : 
		- Nom du site
		- Date de soumission
		- Nombre de hits
	- Insertion des smileys sur Phorum.
	- Module de recherche dans l'administration pour les liens.
	- Pour les heureux possesseurs de la fonction mail, une newsletter.

- Depuis la version 1.0 :
	- Ajout d'un livre d'or.
	- Commentaires sur les liens et les news.
	- Correction de quelques petits oublis :
		- Messages de la catgorie nouveau site vide.
		- Lien d'ajout de site qui s'affichait sur la home quand il n'y
		  avait pas de catgorie.
		- Lorsque l'on tait sur les news  la page 5 par exemple et qu'on
		  passait  l'autre langue qui en avait moins a devenait vide
		  bien sr, donc maintenant retour  la page 1.
		- Question lors de la soumission au lieu d'une alerte.


INSTALLATION
------------
- Dcompressez l'archive dans un rpertoire de votre serveur Web en conservant
  l'arborescence des fichiers.

	#################################################
	#	    Configuration phpFullAnnu		#
	#################################################

- Pour les nouveaux :
	- Allez tout simplement sur votre navigateur prfr au rpertoire install et remplissez
	  les formulaires, tout est gr automatiquement par le script...
  
  ATTENTION : si vous avez une erreur ds l'arrive sur le rpertoire install, n'allez pas plus
              loin, il faut installer en ditant les fichiers config.inc.php3, lang/english.php3,
              lang/french.php3.

  Les tables du forum sont cres automatiquement lorsque vous demandez la
  cration d'un forum, pour les stats voir plus bas.

- Pour tous les utilisateurs des versions antrieures :
	- Reprenez tous les rpertoires et fichiers de phpFullAnnu sauf phorum, stats et install.
	- Dans phorum : 
		Dans le rpertoire include : les fichiers "footer.php3" et "header.php3",
		pour les smileys : read.php3, form.php3 (include), smileys.html pour les smileys.
	- Dans stats :
		De mme reprenez dans le rpertoire include les fichiers "footer.inc.php" et
		"header.inc.php", vous pouvez aussi reprendre si ce n'est pas dj fait,
		le fichier "config.inc.php3" j'y ai ajout la reconnaissance de Win XP
		et IE 6.0.

- Pour les utilisateurs de la version 1.0 :
	- Crez les tables : guestbook  --> guestbook.sql
			     comments   --> comments.sql
			     newsletter --> newsletter.sql
	  Le nom des tables pourra tre modifier par l'administration.

- Pour les utilisateurs de la version 2.0 :
	- Crez la table newsletter --> newsletter.sql

- Pour tous les utilisateurs des versions antrieures :
	- Editez le fichier config.inc.php3 et entrez la valeur pour $weburl.
	- Allez dans l'administration sur le menu "Configuration" pour mettre  jour le fichier de
	  configuration, prenez les tapes dans l'ordre du menu.

- Pour tout le monde :)) :
	- Allez sur votre outil d'administration de base de donnes (ex : phpMyAdmin),
          cliquez sur votre base de donnes, sur le bouton parcourir sous la bote de dialogue,
          et choisissez le fichier modifs.sql et cliquez sur "Excuter", ce fichier permet la mise
           jour des tables pour les votes...
	- Editez les templates qui se trouve dans le rpertoire tpl ( l'origine)

  ATTENTION DANS CES TEMPLATES IL Y A A CHAQUE FOIS UNE PETITE EXPLICATION
  VOUS AVEZ DANS LE COMMENTAIRE LES VARIABLES QUE VOUS POUVEZ UTILISER
  POUR UTILISER CES VARIABLES IL SUFFIT DE METTRE CELLE-CI ENTRE { ET }
  Le {MENU} peut tre mis sur n'importe quel template  plusieurs reprises...
  EX : ADDIMG --> {ADDIMG} ce qui crit l'adresse du site + le rpertoire images
       (votre url : http://www.monsite.com/ et votre rpertoire image : images/
        ce qui donne http://www.monsite.com/images/).

- Editer la feuille de style "style.css" ( l'origine) pour la mettre  votre got.

- Editer les fichiers de javascript :
  Editer les deux fichiers headxx.js avec le titre de votre site (la premire variable)
  De mme diter les deux fichiers paraheadxx.js avec l'url de votre site et les parametres
  de votre menu contextuel perso si vous voulez en changer.

	#################################################
	#	   Configuration Visiteurs 2.0		#
	#################################################

- Configuration des statistiques (Visiteurs 2.0 : http://www.phpinfo.net/) :
  Crez les tables du rpertoire sql-tables dans stats :
	- archives.sql
	- domaines_fr.sql
	- visiteurs.sql
  Editer le fichier "config.inc.php3" en y mettant vos donnes dans les variables :
	- $lvc_db_host
    	- $lvc_db_user
    	- $lvc_db_password
    	- $lvc_db_database
	- $lvc_site_opening_year //anne du dbut de stats
	- $lvc_site_opening_month //mois de dbut de stats
	- $lvc_ignore_referers[] //les deux variables pour viter de compter les visites
				   qui viennent de votre site
	- $lvc_ignore_machines[] //le deuxime pour viter de compter votre machine
  Editer aussi la feuille de style "visiteurs.css" dans le rpertoire css.

	#################################################
	#	       Configuration Phorum		#
	#################################################

- Configuration des forums (Phorum : http://phorum.org) :
  Pour ce qui est de ceci, il vous faut aller sur votre navigateur  l'adresse phorum/admin
  ou par l'admin du site vous avez un lien qui vous y ammene l vous faites :
	- Administrer Phorum --> Configuration base de donnes
	- Fichiers Chemins
	- Configuration HTML
	- Option Globales
	- Retour Menu
	- Nouveau Forum
  Et ensuite  vous de changer comme vous voulez...


UTILISATION
------------
De votre ct :
	- Caches : Ils sont gnrs s'ils sont expirs, attention il peuvent prendre beaucoup de place.
	- Catgories :
		- Tout d'abord vous allez sur l'admin et vous crez vos catgories et sous catgories.
		- Vous ne pouvez diter que les noms des catgories.
		- Vous pouvez supprimer les catgories seulement s'il n'y a plus de sous
		  catgories ni de liens dans celle-ci.
		- Vous pouvez exporter la table : utile pour une migration ou une sauvegarde.
	- Liens :
		- Vous pouvez diter les liens (titre, url, description...).
		- Si vous avez mis l'acceptation automatique, vous n'avez donc pas  accepter.
		- Un systme de recherche est  votre disposition, fonctionne comme celui du site,
		   part que en dessous de deux lettres il ne prend que les ID.
		- Vous pouvez supprimer les liens que vous voulez.
		- Vous pouvez exporter la table : utile pour une migration ou une sauvegarde.
	- News :
		- De mme que pour les liens  part le moteur qui n'est pas intgr...
	- Livre : 
		- Vous pouvez exporter le livre complet (franais et anglais dans le mme fichier).
		- Vous pouvez exporter le livre franais seul.
		- Vous pouvez exporter le livre anglais seul.
		- Vous pouvez supprimer les messages non voulu (genre insulte).
	- Commentaires : 
		- Vous pouvez exporter les commentaires complet (franais/anglais & liens/news dans le mme fichier).
		- Vous pouvez exporter les commentaires franais/liens seul.
		- Vous pouvez exporter les commentaires anglais/liens seul.
		- Vous pouvez exporter les commentaires franais/news seul.
		- Vous pouvez exporter les commentaires anglais/news seul.
		- Vous pouvez supprimer les messages non voulu (genre insulte).
	- Newsletter :
		- Vous envoyez vos newsletter par la partie admin, c'est totalement indpendant des news du site.
		- Vous pouvez exporter la table des inscrits.

Ct utilisateur :
	- Les liens ne peuvent tre soumis que dans les catgories qui ne comportent
          aucune sous catgories, soit par meta rechercher par le script ou par le formulaire.
	  Le lien pour soumettre les sites est disponible sur toutes les pages de l'annuaire.
	- Les mots clefs <= 2 lettres ne sont pas pris en compte dans la recherche.
	- Un clic sur une des flches de tri recharge la page selon le choix du visiteur.
	- Le clic sur "Tlcharger les sources" ramne sur mon site pour tlcharger la dernire
          version de phpFullAnnu.
	- Le livre d'or : une table pour deux langues donc quand on soumet sur le franais, le message
	  ne serra afficher que sur le franais et de mme pour l'anglais.
	- Les commentaires : une table pour deux langues et deux choses (liens/news), fonctionne comme
          le livre.

Voil j'espre n'avoir rien oublier, MERCI @ TOUS!!