Trellian

 Domovská stránka
 AFFA
 Produkty
 Vlastnosti
 Demoverze AFFA
 Download
 Technické informace
 FAQ


 
    Rozšířený volně dostupný seznam odkazů CGI     


    Úvod

    Skript byl navržen tak, aby jej bylo možno instalovat prostřednictvím FTP na vzdálený server se skriptem PERL 5 nebo vyšším. Protože je vytvořen tak, aby bylo možné snadné nastavení, je program AFFA schopný provádět výkonné filtrování, což může zabránit přidávání nežádoucí odkazů do Vaší stránky.

    Stažení a instalace

    Instalace AFFA se provádí tak, že nejprve kliknete podle své volby na metodu pro stažení a formát souboru (viz níže) a stáhnete si ho do svého počítače. Soubory, které jsou obsaženy v archívu programu AFFA, bude třeba dekomprimovat. Horní řádky souboru affa.pl můžete editovat a zadat zde cestu k adresáři Vašeho kompilátoru PERL a skripty zasílání pošty. Potom upravte soubor affa.cfg, a zadejte parametry nastavení, které potřebujete pro běh programu. Věnujte patřičnou pozornost cestám k adresářům potřebných souborů.

    MetodaFormát souboruTypPříkaz k dekomprimaci
    HTTPaffa.zipkomprimovaný zipunzip affa.zip


    Doporučujeme, abyste umístili všechny soubory do jednoho adresáře. Je třeba zaručit, aby vybraný adresář měl povolení k přístupu pro umožnění práce se skripty CGI nebo PERL. Soubor email.txt se musí umístit do stejného adresáře jako soubory affa.pl a affa.cfg (pokud se používá soubor affanow.gif, měl by být také v tomto adresáři). Soubory db.txt, header.htm a footer.htm se smí umístit do kteréhokoli adresáře, pokud tato cesta k adresáři je nastavena v souboru affa.cfg.

    Když jsou soubory umístěny na Vašem serveru, musíte nastavit pomocí CHMOD soubor affa.pl na 755. Soubor db.txt musí být nastaven na CHMOD 666.

    Skript lze natáhnout do Vašeho internetového prohlížeče jedním ze dvou způsobů. První způsob vyvolá přímo soubor affa.pl. Například:
    http://www.vasedomena.com/adresar/affa.pl
    V tomto případě nedoplňujte cílový soubor do souboru affa.cfg.
    Nebo můžete natáhnout stránku vytvořenou programem AFFA takto:
    http://www.vasedomena.com/adresar/links.htm
    Při instalaci skriptu tímto způsobem musíte zadat do souboru affa.cfg cílový soubor a program automaticky vygeneruje stránku odkazů. Doporučujeme použít první metodu (přímo natahující skript).

    Uživatelské nastavení programu AFFA

    Program AFFA automaticky vygeneruje soubor ve formátu HTML, přičemž nejdříve přidá soubor záhlaví ve formátu HTML, potom zformátuje a uspořádá databázový soubor odkazů a nakonec připojí soubor zápatí ve formátu HTML. Příklad souborů záhlaví a zápatí ve formátu HTML je poskytován společně s touto verzí.

    Hlavní změny, které asi budete chtít provést, jsou emailová adresa správce a pole TextReject, které uvádí seznam slov, které nebude skript v poště přijímat.

    Program AFFA můžete používat přímo tak, jak je distribuován (měli byste však zadat Vaši emailovou adresu do pole správce v souboru affa.cfg) nebo upravit podle Vašich požadavků skoro každou vlastnost jeho funkce. Program AFFA je konfigurován konfiguračním souborem (`AFFA.cfg'), který můžete editovat pomocí textového editoru. Samotný soubor obsahuje poznámky (kterýkoli řádek začínající s `#'), které popisují každou možnost volby. Dostupné možnosti volby konfigurace jsou následně uvedeny v souhrnu:

    • Umístění (cesta) kteréhokoli ze souborů; zejména,
      • TargetFile - cílový soubor HTML, který se má vytvořit
      • HeaderFile - záhlaví HTML přidávané k cílovému souboru
      • FooterFile - zápatí HTML připojované k cílovému souboru
      • DatabaseFile - databázový soubor odkazů
      • LogFile - soubor záznamů pro zasílání a příjem pošty
    • Administrator - emailová adresa, na kterou se zasílají hlášení.
    • CategoryTemplate - šablona používaná pro zobrazení každé z kategorií.
    • LinkTemplate - šablona používaná pro zobrazení odkazů.
    • TextReject - seznam klíčových slov, pokud je obsažen v poště, může způsobit odmítnutí.
    • TextRejectMessage - zpráva, která se zobrazí, když dojde k odmítnutí textu.
    • CaseTransform - uvádí, zda se má automaticky změnit druhé a následující písmeno slova na malá písmena, aby se zabránilo `SHOUTINGu' (psaní textu velkými písmeny)
    • CaseReject - počet doručených slov psaných velkými písmeny, při kterém dojde k odmítnutí.
    • CaseRejectMessage - zpráva, která se má zobrazit, když dojde k odmítnutí slov psaných velkými písmeny.
    • DuplicateURLReject - zadává, zda se mají odmítnout duplicitní adresy URL (založeno na cestě, ne na názvu souboru).
    • DuplicateURLRejectMessage - zpráva, která se zobrazí, když dojde k odmítnutí duplicitní adresy URL.
    • MaximumCount - maximální počet odkazů, které se mají zachovat; pokud je to nezbytné, nejstarší odkazy se vymažou.
    • MaximumSize - maximální velikost databázového souboru (v kB); pokud je to nezbytné, nejstarší odkazy se vymažou.
    • DomainReject - udává, pro které domény bude odmítnuto zasílání a příjem pošty.
    • DomainRejectMessage - zpráva, která se zobrazí v případě, že dojde k odmítnutí domény.
    • Lifespan - maximální "délka života" (ve dnech) pošty, než se automaticky odstraní.
    • TestURL - zadává, zda se má provádět automatické testování adres URL během zasílání pošty, aby se ověřilo, že odkaz je platný.
    • TestURLTimeout - udává, jak dlouho se má čekat během testování před rozhodnutím, zda adresa URL je neplatná.
    • TestURLMessage - zpráva, která se zobrazí, jestliže výsledek testu adresy URL je negativní.
    • SortOrder - zadává, zda se má zobrazit nová pošta na konci, na začátku nebo v abecedním pořadí.
    • SubstituteList - udává, jak se má pošta změnit před prováděním testů nebo zasláním.
    • Categories - zadává, které kategorie mají být povoleny a které zobrazeny a v jakém pořadí.
    • CategoryRejectMessage - zpráva, která se zobrazí, když je zaslána neznámá kategorie.
    • CategoryParam - název zadaného parametru kategorie pro zasílání.
    • TitleParam - název zadávaného parametru titulu pro zasílání.
    • UrlParam - název zadávaného parametru adresy URL pro zasílání.
    • DescriptionParam - název zadávaného parametru popisu pro zasílání.
    • MaxTitleLen - maximální délka titulu (pokud je delší než tato hodnota, bude zkrácen).
    • MaxDescriptionLen - maximální délka popisu (pokud je delší než tato hodnota, bude zkrácen).
    • RejectIfTooLong - odmítne zaslání, když titul nebo popis překročí jednotlivě MaxTitleLen a MaxDescriptionLen, dříve než se pouze zkrátí.
    • MaxURLLen - maximální dovolená délka adresy URL.
    • RejectIfTooLongMessage - zpráva, která se zobrazí, když dojde k odmítnutí založeném na délce adresy URL, titulu nebo popisu.
    • MinTitleLen - minimální dovolená délka titulu.
    • MinDescriptionLen - minimální dovolená délka titulu.
    • MinURLLen - minimální délka adresy URL.
    • RejectIfTooShortMessage - zpráva, která se zobrazí, jestliže dojde k odmítnutí založeném na délce adresy URL, titulu nebo popisu.
    • AcceptMessage - zpráva, která se zobrazí, bylo-li zaslání akceptováno.
    • URLPrefixAccept - předpony adres URL (jako například http:// nebo ftp://), které jsou akceptovány.
    • Delimiter - znak (znaky) pro rozdělní seznamů položek v konfiguračním souboru.

    Odstraňování chyb

    Systémové chyby

    Systémová chyba 1
    Program AFFA nebyl schopen otevřít databázový soubor pro aktualizaci; to je většinou způsobeno nesprávným nastavením povolení přístupu k databázovému souboru.
    Systémová chyba 2
    Zapnuli jste automatické testování adresy URL, avšak program AFFA nemůže najít nezbytnou knihovnu (PERL library Socket.pm), aby testování mohl provést. Zkontrolujte Vaši instalaci systému PERL, nebo vypněte automatické testování adres URL.
    Systémová chyba 3
    Nakonfigurovali jste neplatnou substituci v konfiguračním souboru (Seznam substitucí). Prosím zkontrolujte pečlivě formát substituce.
    Systémová chyba 4
    Programu AFFA nebyl schopen otevřít cílový soubor HTML pro aktualizaci; to je většinou způsobeno nesprávným nastavením povolení přístupu k cílovému souboru HTML.
    Systémová chyba 5
    Program AFFA nebyl schopen otevřít soubor log pro aktualizaci; to je většinou způsobeno nesprávným nastavení povolení přístupu k souboru log.
    Systémová chyba 6
    Konfigurační soubor nebylo možné otevřít pro čtení. Konfigurační soubor by měl mít název `AFFA.cfg' ve stejném adresáři jako program AFFA, jestliže není zadán v záhlaví programu AFFA (změňte skript).
    Systémová chyba 7
    V konfiguračním souboru je chyba v zadaném řádku. Zkontrolujte syntaktické chyby a překlepy.
Trellian