NetRef v3.0
Annuaire de liens pour hébergeurs supportant le PHP 4 et MySQL

****** INSTALLATION :
Pour installer Netref, il vous suffit de de modifier le fichier option.php et d'y modifier les informations suivantes :

• 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 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 :)
• Merci de laisser le lien vers le site Netref en bas de page (il est tout petit :-)

****** 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
• Erreur dans le fichier rech.php lors d'une recherche : Si vous avez activé la sauvegarde des recherches, il vous faudra peutêtre chmoder le fichier recherche.dat en 766

****** OPTIONS
Voci les différentes options décrites présentes dans le fichier option.php

$style="style"; // Permet de chosir le style graphique graphique de netref, le fichier css devra être présnet dans le répertoire include
$messag_confirm=1;// Envoie d'un mesage de confirmationà la personne l'ayant soumis lors de la validation d'un site (1 pour activer - 0 pour désactiver) Ne fonctionne pas chez Free.
$envoie_mail_admin=1; // Enoie 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, Ne fonctionne pas chez Free.
$def_doss="cat.png"; //Icone par défaut pour les catégorie (dans le repertorie /dossier) Le fichier doit être présent
$aff_in=0; // Afficher le nombre d'entrées (1 pour activer - 0 pour désactiver)
$tri_cat="nom"; //Trie des catégories par défaut, nom pou l'odre alpahbétique, id pour la date de soumission
$tri_site="star"; //Trie des sites par défaut compt_in pour le nombre d'entrée, compt_out pour les sorties, nom pou l'odre alpahbétique, star pour les étoiles et date_inser pour les dates de soumission
$autrech=1; //Autoriser la recherche dans l'annuaire. Permet d'afficher le formulaire de recherche
$rech_save=1; //Sauvegarde les recherches utilisateurs dans le fichier recherche.dat du repertoire admin (1 pour activer - 0 pour désactiver) -> Attention, fichier public !! Mettre un fichier .htacces (si votre serveur web est apache pour le protéger)
$aff_trie=1; //Autorise les utilisateurs à chosir le trie des sites (1 pour activer - 0 pour désactiver)
$autsoum=1; //Autoriser la soumission de sites et catégories (1 pour activer - 0 pour désactiver)
$ajout_site_auto=0; //permet d'ajouter les sites sans avoir à les confirmer par l'administrateur (1 pour activer - 0 pour désactiver)
$prof=3; //profondeur de la recherche 1,2 ou 3-> 3 étant la plus profonde, recherche dans les noms, titres et descritpions
$pageindex="index.php"; //page de redirigé pour les visiteurs entrants (index.php vous renverra sur l'index de l'annuaire)
$nbsitebest=10; // Nombre de sites affichés dans le classement "Sites les plus vitées"
$nbsitenew=10; // Nombre de sites affichés dans le classement "Nouveaux sites"
$nbsiteparten=10; Nombre de sites affichés dans le classement "Sites partenaires"
$star_max=5; //Maximum d'etoile (Il est conseiller de laisser 5)
$rech_meta_actif=1; //Recherche des metas lors de la soummission d'un site (1 pour activer - 0 pour désactiver)
$nb_site_page=10; // Nombre de site par page dans l'annuaire, au dela il faudra aller sur la page suivante
$auth_envoie=1; // autorise l'envoie de votre URL lors de la creation de vos tables (1 pour activer - 0 pour désactiver)

****** COMPATIBILITé

• Votre hébergeur doit donc supporter le PHP 4 avec les sessions correctement configurés
• Le navigateur doit supporter les cookies pour que le changement de langue fonctionne. Attention aux anti-virus et autres programmes qui les désactivent
• Pour l'hebergeur free ou 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

Si vous êtes en mode administration, il ne sera pas nécessaire de confirmer l'ajout des sites et catégories, pour le mode normal vous devrez confirmer l'ajout en passant en mode administration et valider les sites ... non validés

****** ADAPTER Netref A 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
Il faut également modifer le fichier style.css pour changer les couleurs et police de caractères.

****** 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 conseillés"
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 soummet un site dans l'annuaire

****** 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)
• Ajouter dans le fichier header.php la ligne pour l'élément sélectionant la langue et eventuellement supprimer celles non utilisées

Les fichier mail_xxxx.php correspondent au mail qui sont envoyés au utilisateurs. Vous pouvez également bien entendu les traduires, mais il faut faire attention à respecter les balises qui sont utilisés par Netref comme des variables.

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

[url_site] URL de votre site
[nom] Nom du site soumis
[description] Desccription du site soumis
[nom_netref] Nom de votre annuaire
[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 langue que vous avez créé 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.

****** HISTORIQUE

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

La version 3 apporte de nombreux changement au niveau de la structure de l'annuaire. Ce présent fichier est maintenat mis à jour. Si vous voulez connaitre les différentes mise à jour, veuillez comparer avec le fichier readme d'une version antérieure.

• 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é

v2.00 22/06/2002
Affichage d'une fenêtre d'information dans le menu adminstration pour faciliter les mises à jour de l'annuaire
Affichage des sous-catégories possible en petit sous le titre de la catégorie (choix entièrement paramétrable)
Les utilisateurs peuvent mainteant chosir la méthode de comptage dans les catégories à savoir par date, hits ou étoile
Possibilité de choisir l'icone de chaque catégorie
Les images sont stockées dans le fichier /dossier
Bug du warning: line 18 visible avec certains navigateurs lors de la selection des catégories résolu
Ajout du Hollandais
Envoie possible de mail à l'admin lors de la soumission d'un site avec plusieurs parametrages
Optimisation des requêtes

v1.90 12/5/2002
Nombreuses optimisations -> Nombre de requete MySQL moins importante pour les utilisateurs
Affichage par pages des classements
Ajout de langues pour les sites (espagnol & portugais)
Nouvelle présentation de la gestion des sites
Système de vérification de lien semi-automatique
Amélioration du moteur de recherche Mise à jour très simplifié à partir d'une ancienne version
Ajout de la version italienne
Ajout de quelques icones
Comptage des sites par catégorie entièrement automatique
Affichage de la date d'ajout dans les derniers sites

v1.71 1/4/2002
MAJ maintenat très facile à partir d'une ancienne version
Affichage des sites pages par pages dans les catégories avec nb de sites par page reglable
Entièrement multilingue avec ajout de langue tres facile (cf plus haut)
Choix du tri pour les catégories et sites Ajout du nombre de sites dans une catégorie entre parenthese comme ceci : exemple (3)
Amelioration de l'affichage des sites partenaires / conseillés

v1.63 27/3/2002
Possiblité de supprimer la detection des META
Correction du bug des "\'" chez certains hébergeurs ne supportant pas les Magic Quotes

v1.62 15/3/2002
Envoie d'un email lors de la validation d'un site
Version "anglaise" du menu Administration
Correction de bugs mineurs

v1.6 2/3/2002
Ajout de styles prédéfinis Ajout de l'affichage en colonne pour les catégorie
Amélioration du mode administration (icone pour gerer les sites)
Optimisation du code (notamment des sessions)
Affichage complet du chemin dans les sous-catégories

v1.5 25/01/2002
Ajout d'un systeme de notation par des étoiles (de 0 à 5) eventuellement modifiable et gestion de partenariats (site en tete)
Correction du bug lors de la creation des tables (nom erroné)

v1.4 28/12/2001
Correction de bugs, notamment pour l'ajout et la modifcation de site Balises META mieux detectées sur les sites

v1.3 28/11/2001
Ajout du support anglais dans les fichiers du repertoire langue : Attention la traduction est très moyenne !
Corrections de bugs

v1.2 26/11/2001
Recherche de le description des sites ajoutés dans les META
Possibilité de modifier la catégorie d'un site
Fonction de gestions de catégories

v1.1 21/11/20001
Ajout d'un formulaire de modification complète des sites Ajout de classements Compteur d'entrée et sortie des visiteurs

v1.0 10/11/2001
Ajout d'un moteur de recherche avec profondeur paramétrable
Correction de nombreux bugs de session

****** PROCHAINEMENT

Optimisation et possibilités d'utiliser des ET sur le moteur de recherche
Suppression des pages partenaires, best, new : nouveau menu
Sauvegarde des sites en fichiers textes et possibilité de les relire facilement

*********************************************************************
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 2002 - Netref