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

****** INSTALLATION :

• Avant toute installation, veuillez lire la license d'utilisation
• Editez le fichier option.php et modifiez dans un permier temps :
  • Login et mot de passe MySQL
  • Nom de la base MySQL
  • Choisir des mots de passe et login pour l'administration
• Copiez ensuite 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
• Rendez vous maintenant dans le repertoire admin et connectez vous avec les identifiants choisis précédement
• 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é.

$host="kro2"; // Adresse du serveur MySQL
$user="netref"; // Nom d'utilisateur de la base MySQL
$pass=""; //Mot de passe MySQL
$bdd="netref4"; // Nom de la base MySQL

$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

//pseudo(s) de l'administrateur
$psadmin[0]="admin";
$passadmin[0]="ADMIN";

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

//URL du site
$url_site="http://www.yourdomain.com"; //Y mettre l'URL de l'annuaire avec le repertoire d'installation (pas de / a la fin !!)
$nom_netref="Netref"; // Nom de l'annuaire
$email_contact="soumission@yourdomain.com"; //email de contact

//Options
$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
$tri_site="star"; //Trie des sites
$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
• Netref 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

****** MISE A JOUR à PARTIR D'UNE ANCIENNE VERSION DE NETREF

Il suffit de cliquer sur le lien "Mettre a jour les tables MySQL" pour créer les nouveaux champs nécessaires à la version en cours.

****** UTILISATION

Netref a pour but d'être le plus intuitif possible tout un proposant un maximum de fonctions utiles. Les commandes sont donc celles affichés et tombent en principe sous le sens.
Pour l'utilisateur : il lui suffit de suivre les liens.
Pour l'Administrateur, il lui faudra tout d'abord se connecter en se redant sur la page URL DE NETREF/admin/ et de rentrer ses identifiants chosis dans le fichier OPTION.PHP.
Une fois connecté, il vous suffit de gérer l'annuaire en cliquant sur "Administrer l'annuaire". Tout soumission en tant qu'Administrteur sera considéré comme un ajout direct (sans revalidation de votre part).
Dans le menu ADMIN, vous pouvez également gérer les sites et catégories soumis par les utilisateurs et également faire des modifications sur tout l'annuaire. (Des fonctions de traitement par lot sont à votre disposition dans les page "SITES NON VALIDéS", "CORBEILLE" et "AFFICHAGE DE LA STRUCTURE" afin de vous permettre de traiter très rapidement des lots de sites. Vous pourrez les supprimer, les déplacer (dans une catégorie) ou les valider si ce n'est pas deja fait.

****** ADAPTER Netref à VOTRE SITE

Pour intégrer l'annuaire à votre site, il vous faut modifier les fichiers header.php et foot.php du répertoire include qui correspondent au haut et bas de page. Attention cependant à inscrire du code HTML uniquement en dessous des fonctions PHP de session du fichier header.php. Pour cela des commentaires vous indiquant ou ajouter votre code est placé dans ces deux fichiers.
Il faut également modifer le fichier style.css pour changer les couleurs et police de caractères, cadres, tableaux, etc.

****** 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/netref/gestion/in.php?id=idsite 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)

N'hésitez pas à envoyer à langue@netref.net les fichiers langues que vous avez créés pour en faire profiter les autres utilisateurs

****** 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)

****** HISTORIQUE

v4.03
Corrections : Envoie des email de validation, modification de la variable d'envoie de mail à l'admin dans option.php et modification de l'ajout des commentaires

v4.0 7/07/2003

Modification de la license, Netref est maintenant payant pour les sites à but lucratif (voir la license d'utilisation)

Les nouveautés :

• Possibilité de traiter les sites par lot dans l'affichage des categories non validés, la corbeille, et de la structure
• Ajout d'une corbeille pour mettre les sites en transit
• Modification pour pouvoir adapter Netref beaucoup plus facilement - Nouvelle structure sans rafraichissement, les pages visiteurs sont desormais à la racine
• Possibilité aux utilisateurs de recommander un site à un ami

v3.00 1/04/2003

Les nouvelles fonctions :

• Possibilités de mettre un site dan plusieurs categories
• Le moteur de recherche entièrement nouveau, pas encore terminée mais tout à fait opérationnel et capable de supporer plusieurs milliers de sites.
• Possibilité à l'administrateur de supprimer des commentaires
• La personnalisation est maintenant beacoup plus aisée grace à une refonte de la structure
• Le deplacement du fichier script/prove.php vers gestion/in.php qu'il faudra signaler aux sites qui pointe vers vous via ce lien ou alors copier le fichier gestion/in.php vers script/prove.php ce qui n'est pas fait par defaut.
• La modification complète des fichiers de langage, un langage correspond desormais à un repertoire dans le repertoire /lan
  Le langage de reférence étant le Francais, pour en ajouter un, veuillez prendre modèle dessus.
• Tous les les fichiers des personnalisation sont desormais dans le repertoire /inc, le fichier de configuration reste option.php à la racine.
• Déplacement du dossier /dossier qui contenait les images des catégories vers /inc/im_cat

v2.40 01/01/2003
Ajout d'un système de cache pour beaucoup plus de rapidité lorsqu'il y a beaucoup de catégories
Possibilités de chosir le nombre de colonne pour chaque catégorie (la racine prenant la valeur par defaut)
Possibilité d''ajouter des commentaires pour chaque site

v2.20 31/08/2002
Possibilité de personnaliser les mails d'envoie de confirmation et de les adapter aux différentes langues
Possibilité de rechercher dans les catégories Les recherches sont maintenant effectuées sans les accents
Correction de quelques bugs : - tri pas hits et affichage de sous catégorie
Detecteur de balise Meta amélioré Les liens sont maintenant encadrés (personnalisation possible)

v2.11 31/07/2002
Suppression de la partie à propos mais ajout d'un lien sur le site web Netref en petiot en bas de page : merci de le laisser
Ajout de la langue espagnol
Amélioration de l'affichage des classements
Possibilité d'afficher le nombre de hits entrants

v2.10 25/07/2002
Ajout d'un cookie pour limiter le nombre de visite comptée à une par jour par site
Ajout de la version Allemande Amélioration des langues du menu administration
Panneau d'information dans le menu administration
Bug structure de l'annuaire corrigé

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

Rappel : vous devez lire la license d'utilisation
Téléchargez la dernière version sur http://www.netref.net
Vous pouvez adresser vos commentaires et suggestions à l'adresse netref@netref.net
Site officiel : http://www.netref.net
Copyright 2003 - Netref