 ******************************************************************************************
 *                           /==============================\                             *
 *                        ~~||     PHP My Ring v. 4.0.2     ||~~                          *
 *                           \==============================/                             *
 *                                                                                        *
 * Script ralis par Nicolas G. <webring@microniko.net> http://www.microniko.net         *
 * Pour voir un exemple allez voir le webring des sites de microbiologie :                *
 *                     -----> http://www.microniko.net/webring <-----                     *
 *                                                                                        *
 * Distribu sous licence GPL (voir le fichier COPYING et GPLfr)                          *
 * Vous devez IMPERATIVEMENT accepter les termes de cette licence pour pouvoir utiliser   *
 * ce script !                                                                            *
 * Si vous modifiez le script, envoyez moi un mail que je modifie mes sources =:-}        *
 ******************************************************************************************

1/ Description
   -----------
   Ce script permet d'installer un webring sur votre site. Il est trs personnalisable
   par l'administrateur et les membres du webring avec un minimum de manipulations.
   Il est possible de modifier l'aspect du webring dans un logiciel WYSIWYG. Mais attention
    ne pas modifier le code PHP!!!! Certains logiciels ne se gnent pas pour le faire
   sans rien demander! Je vous conseille donc de sauvegarder et tester rgulirement
   aprs toute modifications!
   Ce script tourne sous PHP 4 (impratif pour les sessions). Pour un fonctionnement
   optimal, il est prfrable d'utiliser une platefrome non Win32 (GNU/Linux :) et
   un serveur supportant la fonction mail.

2/ Nouvelles versions
   ------------------
   Vous pouvez aller voir la page http://www.phpmyring.fr.st pour
   vrifier si la version (v 4.0.2) que vous avez est la dernire.
   Consultez le fichier change.log pour les connatre les changements apportes
   par cette version.
   Pour mettre  jour le script, Ecraser tous les fichiers dj prsents (il est
   quand mme bon de penser  les sauvegarder avant...) et allez  la page
   http://votreserveur/ledossierduwebring/install. CHoisissez alors le mode "mise  jour".
   Le script rcuprera

3/ Installation
   ------------

   a- Sur un site pas encore quip du webring ou avec une version 2.x
      ----------------------------------------------------------------
   * Dcompression du fichier archive (avec l'option "Use Folder Name",
     si vous lisez a, c'est que vous l'avez dj fait ;-)
   * Si la fonction mail a t dsactiv sur votre serveur, modifiez la fonction
     courrier() dans le fichier 'include/fonctions.php'.
   * Personnalisez les pages haut.php & bas.php, elles apparaissent dans toutes
     les pages
   * Vous pouvez personnaliser l'affichage du webring en ditant les fichiers
     /include/script.php et /include/styles.php pour les CSS. Voyez le fichier
     /install/description_styles pour plus d'infos sur les classes de styles
     utilises.
   * Editez le fichier /include/config.php avec les variables d'accs  MySQL.
   * Tlchargez le tout sur votre serveur et faites un chmod 777 sur le dossier
     /include/.
   * Lancez la configuration de votre script en allant  la page
     http://votreserveur/ledossierduwebring/install. Quelques questions vous
     seront poses, le script se chargera de crer les diffrentes tables ncessaires.
     Pour le cas o vous voulez (?!) configurer  la main le webring, il vous
     faudra crer les tables MySQL  l'aide du fichier create.sql.
   * Ne supprimez pas le dossier /install/, vous ne pourriez plus modifier la
     configuration du webring.
   * Le script utilise les sessions. Il vous faut donc (pour certains serveurs)
     un dossier pour accueillir les fichiers gnrs lors des sessions. C'est le
     fichier /tmp/.
     Vrifiez en utilisant la fonction phpinfo() o ce fichier doit il tre situ.
   * Tester...

   b- Sur un site quip du webring
      -----------------------------
      ################################################################################
      ##      SI VOUS UTILISEZ UNE VERSION < 4.0     :                              ##
      ##      - Sauvegardez le contenu de votre Table "webring" et supprimez-la     ##
      ##      - Choisissez le mode d'installation "INSTALLATION"                    ##
      ##      - Restaurez les donnes de la table "webring"                         ##
      ################################################################################

      * Ecrasez les fichiers dj prsents (aprs les avoir sauvegarder), allez
         la page http://votreserveur/ledossierduwebring/install et choissez le mode
        "Mise  jour". Le script rcuprera les varaibles. Vous pouvez en profiter
        pour les modifier.

4/ Mise  jour des langues
   -----------------------
   Tlchargez l'archive  l'adresse http://sourceforge.net/project/showfiles.php?group_id=67828
   et suivez les instructions d'instalation.

5/ Ce qu'il reste  faire
   ----------------------
   Voir le fichier TODO
   N'hsitez pas  m'envoyer des ides (webring@microniko.net)!

6/ Notes de diffusions
   -------------------
   Ce script est diffus sous licence GPL, vous pouvez le modifier, distribuer
   autant que vous voulez  la condition que les modifications soient galement
   distribues sous licence GPL et que vous laissez la prsente note.

7/ Au secours, j'ai un problme !
   ------------------------------
   Pas de panique (JAMAIS !). Il y a toujours une solution... Certaines erreurs reviennent
   souvent. Vrifiez que vous avez correctement configur votre script. Vrifiez que PHP 4
   est install, actif, MySQL aussi.
   Si aprs avoir vrifi tout a, il y a toujours quelque chose qui ne fonctionne pas,
   voil ce qu'il faut faire :
         - Rassembler un maximum d'infos sur l'erreur (versions de PHP, PHP My Ring,
           le texte de l'erreur renvoy par PHP... et tout ce qui vous passe par la
           tte, rien est inutile !)
         - Vous instcrire  la liste de diffusion
            http://lists.sourceforge.net/lists/listinfo/phpmyring-devel
         - M'envoyer un mail (webring@microniko.net) avec l'URL o se trouve l'erreur, comment
           la reproduire. Joignez aussi, aprs avoir enlev vos mots de passe ( moins que ce soit
           indispensable !), le fichier 'config.php'.
   Vous pouvez aussi dsormais utiliser l'utilitaire de repport de bug (/admin/bug.php).
   Rpondez aux questions poses, l'utilitaire se charge de m'envoyer un courriel (il
   faut bien sur que votre serveur supporte une fonction d'envoi de ce courriel).
   Je veux bien vous aider  condition que vous soyez clair et prcis !!!!!

   Petite remarque :
    De nombreuses personnes m'ont envoy des messages me disant que leur mot de passe
    d'administrateur (celui qui est dans /include/config.php) ne fonctionnait pas.
    Dans TOUS les cas, il s'agissait d'une petite erreur de lecture, je le rappele donc ici :
         - Le fichier '/webring/admin.php' est le fichier d'administration des membres
         - Le dossier '/webring/admin/' est le dossier de l'administrateur (VOUS !)

8/ Petits conseils
   ---------------
   Je vous conseille fortement d'utiliser un logiciel : HAPedit (http://hapedit.free.fr).
   Ce logiciel est tout simplement gnial !
   PHPMyRing a t dvelopp avec ce logiciel.
