Annuaire 3.0
Annuaire de liens pour hébergeurs supportant le PHP 4 et MySQL 3.23

****** INSTALLATION :

• Avant toute installation, veuillez lire la license d'utilisation
• Copiez les fichiers dans un répertoire de votre serveur Web
• Faites un CHMOD 766 des fichiers inc/recherche.dat, inc/recommand.dat et cache/cat_for.php
• Il vous faut maintenant créer les tables Pour cela cliquer sur "Créez les tables affiché en surbrillance" ou Mettre à jour si vous utilisez une version anterieure
• Voila c'est terminé, reste maintenant à remplir votre annuaire :)
• Lorsque votre installation est terminée, vous pouvez supprimer les commentaires du fichier option.php pour optimiser les performances.

****** FAQ

• Sur free et online : message d'erreur vous indiquent que le repertoire sessions : il faut créer un repertoire "sessions" à la racine du site

****** OPTIONS
Les options se modifient dans le fichier option.php qui est largment commenté.

$table_cat="NRef_cat"; // Table des catégorie
$table_site="NRef_site"; // Table de sites
$table_com="NRef_com"; // Table de Commentaires
$table_word="NRef_rech_word"; //Table de mots
$table_rech_idx="NRef_rech_index"; //Table de'indexation de mots
$table_rech_cache="NRef_rech_cache"; //Table de recherche

//Langue de l'annuaire
$op_lan="fr"; // "fr"->Francais, "en"->English

//URL du site
$nb_col=3; //Nombre de colonnes pour l'affichage des catégories
$def_doss="dossier.png"; //Icone par défaut pour les catégorie (dans le repertorie /inc/im_cat)

$email_ok=true;// Envoie d'un message de confirmation lors de la validation d'un site
$email_refus=true; //envoie un mail en cas de refus d'accceptation
$envoie_mail_admin=1; // Envoie d'un mail à l'administrateur lorsqu'un site est soumis | 0 pour ne pas envoyer, 1 pour envoie lorsque la liste est vide, 2 envoie a chaque soumission,

$aff_in=false; // Afficher le nombre d'entrées
$tri_cat="nom"; //Trie des catégories
$star_max=5; //Maximum d'etoile
$rech_save=true; //Sauvegarde les recherches utilisateurs
$aff_trie=true; //Autorise les utilisateurs à chosir le trie des sites

$ajout_site_auto=false; //permet d'ajouter les sites sans avoir à les confirmer par l'admin

$pageindex="index.php"; //page de redirection pour les visiteurs entrants
$nb_com_page=5; // Nombre de commentaires par page
$nb_site_page=10; // Nombre de site par page
$nb_check_page=5; //nombre de site à checker par page (menu admin)

$auth_soumission=true; //Autoriser la soumission de sites et catégories
$rech_meta_actif=true; //Recherche des metas lors de la soumission d'un site

// Champs obligatoire pour la soumission
$soum_obl_nom=true;
$soum_obl_des=true;
$soum_obl_email=true;
$soum_obl_url=true;

$auth_envoie=true;// autorise l'envoie de votre URL lors de la creation de vos tables

****** COMPATIBILITé

• Votre serveur doit supporter le PHP 4 avec les sessions correctement configurées
• Un serveur de base de données MySQL 3.23 doit être accessible
• Annuaire3.0 n'est pas pour le moment compatible le paramètre register_global = OFF de PHP mais la transition se fait progressivement et un patch sera disponible prochainement.
• Le navigateur doit supporter les cookies pour ne comptabiliser qu'une seule visite par jour.
• Le navigateur doit supporter le Javascript 1.2 pour le mode Administration
• Chez les hébergeurs Free et Online, vous devez créer un repertoire "sessions" à la racine de votre site

****** ADAPTER Annuaire 3.0 à VOTRE SITE

Annuaire 3.0 est conçu uniquement pour le portail pwsphp

****** AFFICHER UN TOP 10 sur votre PAGE d'ACCUEIL

Vous trouverez dans le repertoire addout des fichiers à inclure la ou vous voulez afficher un TOP-10 en faisant un <? include ('addout/top10besst.php') ?>
Il faudra eventuellement modifier dans le fichier top10xxxx.php le include ('XXXXoption.php').

****** COMPTAGE DES ENTREES

L'annuaire dispose d'un compteur d'entrée ce qui permet de valoriser les sites vous apportant des visiteurs. En effet un classement de ces sites est diponible dans "Sites partenaires"
Il vous suffit pour cela de donner comme adresse de votre site www.votresite.com/index.php?mod=annuaire3.0/gestion&ac=out&url_id=1idsite en remplacant idsite par l'id du site en question (pour la trouver, regarder le lien du site dans l'annuaire)
Une note à ce sujet est affichée lorsque qu'un visiteur soumet un site dans l'annuaire lui incitant à ajouter ce lien.

****** AJOUTER UNE LANGUE

Vous pouvez ajouter une langue très facilement que l'on nomera LA (initiales de la langue), il faut pour cela :

• Créer un dossier langue LA dans le repertoire lan/
• Traduisez tous les fichiers de ce repertoire LA en vous basant sur FR (celui de reference)
• Modifier dans le fichier OPTION.PHP la langue par défaut

Les fichiers mail_xxxx.php correspondent au mail qui seront envoyés aux utilisateurs lors de la validation, du refus d'intégration, d'une recommandation à un ami, ou à l'administrateur pour l'avertir d'un nouvel ajout. Vous pouvez également les modifier facilement en HTML, il vous faudra faire attention à respecter les balises qui sont utilisés par Netref comme des variables.

Voici la liste de ces variables que vous pouvez intercaler la ou vous le souhaitez dans le code : elles seront automatiquement modifiées par le parser avant l'envoie du mail.

[url_site] URL de votre site
[nom] Nom du site soumis
[id] ID du site soumis
[description] Desccription du site soumis
[nom_netref] Nom de votre annuaire
[message_ami] Message écrit par l'utilisateur qui veux recommander un site
[nom_ami] Nom de l'ami qui a recommandé le site
[cat] Numéro de la catégorie dans lequel le site a été soumis
[lan] Langue du site soumis (en deux lettres)
[version] Version de Netref que vous utilisez (merci de laisser un lien Netref dans les mails)

****** VERIFICATION DES LIENS

Une option est prévu dans le menu admin pour vérifier les liens de l'annuaire Si un lien est affiché come brisé, vérifier le et supprimer le ou modifiez le si il le faut Il arrive que certains liens qui fonctionne correctement soit affiché comme brisé. Afin de ne pas surchargez le serveur et d'evitez les erreur de timeout, la verification se fait par lot de 20 sites. Vous pouvez reduite ce nombre dans le fichier (chercher un peu)

***** MODIFIER LES CHAMPS MySQL

Selon vos besoins, il est possible que la longueur des Champs définis par défaut soit insuffisante. Vous pouvez bien entendu augmenter la longueur de ces champs MYSQL (au détriment de l'optimisation)
Par défaut, la plupart des champs texte sont en VAR(X) limité à X. Voici une description des types de champs texte possible.

TEXT ou BLOB : objet d'une longueur maximale de 65535 caractères, TEXT aura un contenu de type ASCII (casse insensible) et BLOB aura un contenu de type binaire (casse sensible).
MEDIUMTEXT ou MEDIUMBLOB : objet d'une longueur maximale de 16777216 caractères, MEDIUMTEXT aura un contenu de type ASCII (casse insensible) et MEDIUMBLOB aura un contenu de type binaire (casse sensible).
LONGTEXT ou LONGBLOB : objet d'une longueur maximale de 4294967295 caractères, LONGTEXT aura un contenu de type ASCII (casse insensible) et LONGBLOB aura un contenu de type binaire (casse sensible).

****** GESTION DES ICONES

Vous pouvez choisir l'icone de chaque catégorie. Pour cela il vous suffit d'editer une catégorie. Les icones disponibles seront ceux disponibles dans le repertorie /inc/im_cat sur lequel vous pouvez y ajouter des icones. Si vous souhaitez supprimer des icones, rendez vous dans le menu administration, un menu est prévu à cet effet pour vous éviter de supprimer des icones en cours d'utilisation.

****** MOTEUR DE RECHERCHE

Le moteur de recherche de Netref pour offrir plus de rapidité indexe tous les mots clefs des sites. Il utilise pour cela une table annexe dans lesquels il stocke les mots lorsque cela est nécessaire à savoir lors e l'ajout d'un site, de sa modification et les supprime lors de la suppresion ou mise en corbeile d'une site. Si vous faites des modifications de tables en dehors de Netref, la modification de cet index ne sera pas faite. C'est pour cela qu'il existe dans le menu administration la possibilité de refaire l'index (en cliquant sur indexer les sites de l'annuaire). Cette opération pouvatn être longue, il vous sera peutetre necessaire de la faire en plusieurs fois à chaque fois prenant de "Debut" le numero du dernier site indexé lors de la précédente passe. (tout en commançant à 0)

*********************************************************************