NetRef v4.4
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
  • L'URL et le mail de votre site.
• 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 d'Administration (www.votredomaine.com/Netref/admin_netref) 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 :)

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

Voici la procédure recommandée :

• Créer un nouveau repertoire sur votre site et copiez la nouvelle version de Netref
• Faites un CHMOD 766 des fichiers inc/recherche.dat, inc/recommand.dat et cache/cat_for.php
• Modifiez le fichier option.php en reprenant les options de votre ancienne version et proffitez en pour configurez les nouvelles options qui ont pu apparaîtres.
• Ecrasez le fichier inc/style.css de votre nouvelle version avec celui de votre ancienne.
• Modifier les fichier head.php et foot.php avec l'aide de vos anciens fichiers.
• Modifiez eventuellement les fichiers de langues (/lan/) si vous y avez apporté des modifications.
• Rendez vous dans le menu administration de votre nouvelle version puis cliquez sur "Mettre a jour les tables MySQL" pour créer les nouvelles colonnes SQL nécessaires à la nouvelle version.
• Renommez le repertoire de votre ancienne version en ajoutant "_old" à la fin par celui de votre ancienne.
• Renommez le repertoire de votre nouvelle version par celui de votre ancienne.

****** 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
• Vous avez des problemes de type " Warning: mysql_num_rows(): supplied argument is not a valid MySQL result resource " sur certaines de vos pages. Il est probable que vos tables SQL ne soient pas à jours et que des colonnes soient manquantes. Il vous faut aloers Mettre à jours vos tables dans le menu Administration de Netref.

****** OPTIONS

****** 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
• Il est recommandé d'activer l'option Register Global=Off de PHP.
• 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

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

• 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

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

• Ajouts des Awards que l'on peut décerner à des sites transversalement aux étoiles affectées aux catégories
• Système de gestion publicitaire par catégorie
• Gestion des entrées anti-triche avec détection de l'IP
• Indexation des catégories
• Gestion des Flux RSS 2.0
• Ajout de la possibilité de prévenir l'administrateur sur la qualité des liens
• Corrections :
  • move.php pour assurer le recomptages des site lors d'un déplacement
  • p_awards.php pour limiter l'affichage par page au nombre déterminé dans option.php
  • correction des flux RSS avec l'URL Rewriting

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 :

• Support de l'URL Rewriting avec Apache desactivable dans le fichier option.php. Son activation permet un meilleur referencement de l'annuaire sur la plupart des moteurs de recherche.
  Certains herbergeurs ne le supportant pas, il faudra eventuellement le desactiver.
• un moteur de recherche optimise avec la possibilite d'activer un cache pour ne pas rechercher dans le base MySQL les recherches frequentes
• Ajout d'un fichier keyword.php dans le repertoire addout/ permettant de selectionner des sites contenant certains mot clefs
• Quelques corrections mineures

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 :

• Meilleur compatibilité avec le navigateur Netscape
• Possibilité d'afficher le nombre total et IN & OUT et de les remettre à 0
• Trie des sites avec mémorisation par cookie afin d'optimiser le référencement : plus que 2 variables de page pour passer à la page suivante - pour meilleur referencement notament sur Google
  Au passage la variable du fichier option de "trie par défaut" est déplacé en haut du fichier index.php :
  ---> $tri_defaut="star"; //trie par defaut des sites
• Possibilité de mettre des des notes dans une catégorie. Le style CSS utilisé est alors cad_info3 et les infos de comptages, de recommandation ne s'affichent alors plus. Pour cela il suffit à l'administrateur de placer un site en gardant l'URL vide.
  

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 :

• 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

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

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