Trellian


 Accueil
 AFFA
 Produits
 Caractéristiques
 Démo AFFA
 Télécharger
 Infos Techniques
 Questions Fréquentes


 
    Liste de CGI AFFA     


    Introduction

    Le script est conçu pour être installé via FTP sur un serveur distant utilisant PERL 5 ou supérieur. Conçu pour une installation et une configuration facile, AFFA est capable d'un filtrage puissant qui empêche d'ajouter des liens indésirables à votre site.

    Téléchargement et Installation

    Pour installer Affa, cliquez d'abord sur votre choix de méthode téléchargement et de format de fichier (voir ci-dessous) puis Téléchargez le programme sur votre ordinateur. Vous devrez décompresser les fichiers contenus dans les archives Affa. Vous pouvez éditer le haut du fichier affa.pl pour indiquer le chemin d'accès à votre compilateur perl et votre script sendmail. Editez ensuite le fichier affa.cfg pour trouver les paramètres dont vous avez besoin pour faire fonctionner Affa. Faites particulièrement attention aux chemins d'accès pour ces fichiers.

    MéthodeFormat de FichierTypeCommande à utiliser pour extraction
    HTTPaffa.zipZip Compresséunzip affa.zip


    Il vous est recommandé de placer tous les fichiers dans le même répertoire. Vous devez vous assurer que le répertoire choisi est autorisé à exécuter des scripts CGI ou PERL. Le fichier email.txt doit être placé dans le même répertoire que les fichiers affa.pl et affa.cfg (le fichier affanow.gif doit aussi être placé dans le répertoire s'il est utilisé). Les fichiers db.txt, header.htm et footer.htm peuvent être placés dans n'importe quel répertoire du moment que le chemin d'accès est spécifié dans le fichier affa.cfg.

    Lorsque les fichiers sont placés sur votre serveur, vous devez "CHMOD" (changer le mode du) fichier affa.pl en 755. Le fichier db.txt doit ensuite être paramétré en "CHMOD 666".

    Le script peut être chargé dans votre browser web de deux manières. Premièrement, vous pouvez appeler le fichier affa.pl directement. Par exemple:
    http://www.yourdomain.com/directory/affa.pl
    Dans ce cas, ne fournissez pas de fichier de destination dans le fichier affa.cfg.
    Deuxièmement, vous pouvez charger une page créée par Affa de cette façon:
    http://www.yourdomain.com/directory/links.htm
    Pour installer le script de cette façon, vous devez spécifier un fichier de destination dans le fichier affa.cfg et le programme générera automatiquement la page de liens. La première méthode (charger le script directement) est recommandée.

    Personnaliser AFFA

    AFFA génère automatiquement un fichier HTML en mettant en créant un fichier en-tête HTML, puis ne formatant et disposant le fichier base de données de liens, et enfin en ajoutant un fichier pied de page HTML. Des exemples d'en-têtes et de pieds de page sont fournis dans ce package.

    La principale chose que vous souhaiterez peut être changer sont l'email de l'administrateur et le champ TextReject, qui liste des mots que le script n'accepte pas lors d'un postage.

    Vous pouvez utiliser AFFA tel quel immédiatement (Vous devez cependant mettre votre adresse email dans le champ Administrateur du fichier affa.cfg, ou personnaliser pratiquement tous les aspects du programme. AFFA est configuré à travers le fichier de configuration (`AFFA.cfg') que vous pouvez éditer avec un éditeur de texte. le fichier en lui-même contient des commentaires (toutes les ligne commençant par un `#') qui décrivent chacune des options. En résumé, les options de configuration suivantes sont disponibles:

    • la localisation (chemin d'accès) de tous les fichiers; en particulier,
      • Fichier de destination (Target) - le fichier HTML à créer
      • Fichier en-tête (Header) - l'en-tête HTML à ajouter au début du fichier source
      • Fichier pied de page (Footer) - le fichier pied de page HTML à ajouter à la fin du fichier source
      • Fichier base de données - le fichier contenant la base de données des liens
      • LogFile - Le fichier log pour les postages
    • Administrator - l'adresse email à laquelle envoyer les notifications
    • CategoryTemplate - le modèle utlisé pour afficher chacune des catégories.
    • LinkTemplate - le modèle utilisé pour afficher chacun des liens.
    • TextReject - liste de mots clés qui, si contenus dans le postage, doivent causer un rejet.
    • TextRejectMessage - message affiché lorsqu'un rejet de texte se produit.
    • CaseTransform - indique si le programme doit automatiquement transformer le second caractère et suivants d'un mot en minuscules
    • CaseReject - le nombre de mots postés sujets à rejet.
    • CaseRejectMessage - le message affiché lorsqu'un rejet de casse se produit.
    • DuplicateURLReject - Si le programme doit rejeter les URLs dupliquées (basé sur le chemin d'accès pas seulement sur le nom de fichier).
    • DuplicateURLRejectMessage - le message à afficher lorsqu'un rejet pour duplication d'URL se produit.
    • MaximumCount - le nombre maximum de liens à conserver; les liens le plus anciens sont déplacés.
    • MaximumSize - taille maximum de la base de destinée ( en Kb); les liens les plus anciens sont déplacés.
    • DomainReject - domaines à rejeter lors du postage.
    • DomainRejectMessage - message à afficher lorsqu'un domaine est rejeté.
    • Lifespan - durée de vie maximum (en jours) d'un postage, avant que celui-ci ne soit automatiquement retiré
    • TestURL - indique si le programme doit automatiquement tester les URLs pendant le postage pour s'assurer qu'elles sont valides.
    • TestURLTimeout - temps d'attente (pendant le test) avant de décider qu'une URL est invalide.
    • TestURLMessage - le message à afficher si une URL est détectée comme invalide.
    • SortOrder - Indique s'il faut afficher les nouveaux postages au début, à la fin, ou par ordre alphabétique.
    • SubstituteList - comment modifier le postage avant qu'il soit testé ou posté.
    • Categories - Quelles catégories accepter et afficher, et dans quel ordre.
    • CategoryRejectMessage - message à afficher si une catégorie inconnue est postée.
    • CategoryParam - le nom du paramètre de la catégorie fourni pour postage.
    • TitleParam - le nom du paramètre de titre fourni pour postage.
    • UrlParam - le nom du paramètre d'URL fourni pour postage.
    • DescriptionParam - le nom du paramètre de description fourni pour postage
    • MaxTitleLen - longueur maximale du titre (les titres plus longs seront tronqués).
    • MaxDescriptionLen - longueur maximale de la description (les descriptions plus longues seront tronquées).
    • RejectIfTooLong - rejette les postages dont le titre ou la description sont trop longues plutôt que de les tronquer
    • MaxURLLen - longueur maximale de l'URL.
    • RejectIfTooLongMessage - message à afficher si un rejet se produit à cause d'un titre, d'une description ou d'une URL trop longs.
    • MinTitleLen - longueur minimale du titre.
    • MinDescriptionLen - longueur minimale de la description.
    • MinURLLen - longueur minimale de l'URL.
    • RejectIfTooShortMessage - message à afficher si un rejet se produit suite à une URL, un titre ou une description trop courts.
    • AcceptMessage - message à afficher lorsqu'un postage est accepté.
    • URLPrefixAccept - préfixes URL (comme http:// ou ftp://) à accepter.
    • Delimiter - les caractères pour le fractionnement des listes d'éléments dans le fichier de configuration

    Dépannage

    Erreurs Système

    System Error 1
    AFFA n'a pas été capable d'ouvrir la base de données pour mise à jour; ceci est presque toujours dû à des paramètres de permission incorrects dans le fichier de base de données.
    System Error 2
    Vous avez autorisé le test automatique d'URLs, cependant AFFA n'a pas pu trouver la bibliothèque nécessaire (bibliothèque PERL Socket.pm) pour y parvenir. Vérifiez votre installation PERL, ou désactivez cette option.
    System Error 3
    Vous avez configuré une substitution invalide dans le fichier deconfiguration (SubstituteList). Veuillez vérifier le format de substitution avec attention.
    System Error 4
    AFFA n'a pas pu ouvrir le fichier de destination HTML pour mise à jour; ceci est pratiquement toujours dû à des paramètres de permission incorrects dans le fichier de destination.
    System Error 5
    AFFA n'a pas pu ouvrir le fichier log pour mise à jour; ceci est pratiquement toujours dû à des paramètres de permission incorrects dans le fichier log.
    System Error 6
    Le fichier de configuration n'a pas pu être ouvert pour lecture. Le fichier de configuration devrait être nommé `AFFA.cfg' dans le même répertoire que AFFA, à moins qu'il n'en soit autrement dans l'en-tête AFFA (éditer le script pour modification).
    System Error 7
    Le fichier de configuration contient une erreur à la ligne donnée. Vérifiez les erreurs de syntaxe et de typographie.