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

****** INSTALLATION :

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

Voici la procédure recommandée :

****** FAQ

****** OPTIONS

Les options se modifient dans le fichier option.php qui est largement commenté.

****** COMPATIBILITé

****** 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_netref/ 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/top.php') ?>
Il faudra eventuellement modifier dans le fichier top10.php et 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.

A partir de la version 4.3, un système anti-triche est disponible et permet d'obliger le visiteur à valider son entrée en cliquant sur un bouton "Entrer sur le site".

Il faut pour activer ce système modifier la ligne d'option.php : $confirm_in=true;

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

Pour certains hébergeurs, vous devrez indiquer le chemin absolue de l'URL réecrite, par exemple

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

L'activation de la fonction se fait en modifiant 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 de 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 pouvant ê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)

****** GESTION de la PUBLICITé

Il est possible de gérer des publicités cilbés par catégories. Pour cela, il faut tout d'abord ajouter des publicités dans le menu administration (menu "Gestion des Publicités").
Ensuite il faut modifier une par une les catégoires afin d'affecter des publicités aux catégories. Il est possible d'affecter plusieurs pubs par catégories avec la touche "Control". Dans le cas ou plusieurs catégories sont sélectionnées, une publicité est alors affichée aléatoirement parmis celles-ci.

Pour activer la gestion des publicités, modifier la ligne du fichier option.php : $opt_gest_advertise=true;

****** GESTION des AWARDS

Il est possible d'attribuer des Awards à certains sites. Ces Awards correspondent à des distinctions particulières. Voici quelques exemples d'Awards :

- Charte graphique exeptionnelle
- Site gratuit
- Site certifié sans pop-up
- Site sécurisé
- Site respectant la vie privée, etc.

Pour cela, il faut tout d'abord ajouter des Awards dans le menu administration (menu "Gestion des Awards")
Ensuite il faut modifier un par un les sites afin d'affecter des Awards aux sites. Il est possible d'affecter plusieurs Awards par site avec la touche "Control". Un nouveaux classement "Awards" accessible par la liste déroulante (en bas de page) permet d'afficher les sites par Awards obtenus.

****** HISTORIQUE

v4.3
Les principles evolutions de cette version :

v4.2c
Corrections de quelques bugs
Lien en dur par défaut avec comptage Javascript.
Top 10 avec comptage en dur

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 :

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

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