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

****** INSTALLATION :

****** FAQ

****** 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
$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é

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

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

****** URL Rewriting

Netref peut convertir a partir de la fonction 4, les URL du type index.php?cat=2 en URL MaCategorie-2.html et ce grace a l'URL Rewriting d'Apache. Cette fonction est desactiee par defaut en raison du fait que certains hebergeurs ne la supporte pas et que pour certains vous devrez modifier la regle de Reecriture qui est la suivante :

RewriteEngine on
RewriteRule ^([^-.]+)-([0-9]+)\.html$ index.php?cat=$2 [QSA,L]

Sur certains hebergeur, vous devrez indiquer le chemin absolue de l'URL reecrite, par exemple

RewriteEngine on
RewriteRule ^([^-.]+)-([0-9]+)\.html$ /netref/index.php?cat=$2 [QSA,L]

Poour activer cette fonction, modifier la ligne suivante dans le fichier option.php : $url_rewriting=true; // Active l'URL Rewriting

****** 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.2
Les principles evolutions de cette version :

v4.1.6
Quelques nouveautés sur cette version et surtout la comptabilité avec les hébergeurs ayant l'option PHP register global=off qui va se généraliser rapidement et notament avec PHP 5.
Vous trouverez également :

v4.06
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

Les nouveautés :

v3.00 1/04/2003

Les nouvelles fonctions :

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