WebToDate/Referenční/Konfigurace WebToDate

Globální konfigurace WebToDate

V konfiguračním souboru global.php je k dispozici celá řada parametrů, kterými lze ovlivnit chování jednotlivých částí WebToDate. Nejvýznamnější z parametrů již byly zmíněny v jednotlivých kapitolách této příručky, kompletní seznam je pak uveden v tabulce níže. Možné hodnoty parametrů i příklady nastavení jsou rovněž popsány v komentovaném souboru global.php.

Název konstanty	Význam konstanty
Interní cesty k adresářům, souborům a URL
WTDPATH	Fyzická cesta k instalaci WebToDate. Uvádí se včetně posledního lomítka.
WTDPATHSCRIPTS	Fyzická cesta k adresáři se skripty. Podle konstanty WTDPATH se vyhledávají cesty k adresářům WWWROOT a OFFLINEDATA, cesty k ostatním adresářům se hledají podle WTDPATHSCRIPTS. To umožňuje oddělit umístění datových adresářů WWWROOT a OFFLINEDATA od ostatních (DETAILPATH apod.) a umístit je z bezpečnostních či výkonnostních důvodů na jiné místo v diskové struktuře či na jiný disk. Výchozí hodnota WTDPATHSCRIPTS je nicméně nastavena na WTDPATH, takže pokud se např. adresář scripts má nacházet na stejné úrovni adresářové struktury jako wwwroot (což je výchozí umístění), není třeba nic nastavovat.
WWWROOT	Název kořenového adresáře, výchozí hodnota wwwroot
WWWIMAGES	Název kořenového adresáře pro obrázky (funkce Obrázky), výchozí hodnota images
FILES	Název adresáře s přílohami. Používá se pouze z důvodů zpětné kompatibility s předchozími verzemi, výchozí hodnota files
JOBPATH	Název adresáře s úlohami Plánovače úloh (v XML formátu), výchozí hodnota scheduler
ADMINPATH	Název virtuálního adresáře s administračními skripty. Pokud chcete z bezpečnostních důvodů změnit virtuální název adresáře (aby přístup nebyl na adrese název_serveru/admin/), změňte tuto konstantu a virtuální název adresáře v konfiguraci www serveru; výchozí hodnota admin
PHYSADMINPATH	Fyzický název adresáře s administračními skripty, výchozí hodnota application
PUBLICSERVERPREFIX	Protokol, URL a port veřejných skriptů. Je třeba zadat např. v případě, kdy provozujete přístup k administračnímu rozhraní pod protokolem https
DETAILPATH	Název složky s veřejnými skripty, výchozí hodnota scripts
RDATA	Absolutní cesta k adresáři RDATA, výchozí hodnota WTDPATHSCRIPTS + 'rdata/'
RESOURCES	Absolutní cesta k hlavnímu adresáři se zdroji (lokalizačními zprávami apod.), výchozí hodnota WTDPATHSCRIPTS + 'rdata/resources/'
LOC_WTD	Cesta k lokalizačnímu souboru WebToDate.
LOC_MODULES	Cesta k lokalizačnímu souboru modulů.
WTDMENUFILE	Cesta k XML souboru administračního menu WebToDate.
OFFLINEDATA	Název adresáře, kam mohou být ukládána data nepřístupná přímo přes virtuální adresáře www serveru, výchozí hodnota offlinedata
LOGS	Název adresáře s protokoly, cesta je relativní vůči adresáři OFFLINEDATA, výchozí hodnota logs
TEMPDIR	Složka dočasných souborů, uvádí se plná cesta ke složce
Kódování
CHARSET	Znaková sada, ve které je server provozován, např. iso-8859-2
DB_LANGUAGE	Nastavení znakové sady databáze.
DB_INIT_COMMANDS	Pouze pro databázi MySQL. Příkazy vložené do tohoto řetězce se posílají do databáze při každém připojení skriptů k databázi. Je možné využít např. pro nastavení kódování češtiny, pak je vhodné zadat následující hodnotu (pro kódování ISO Latin 2): "SET NAMES latin2; SET CHARACTER SET latin2; SET COLLATION_CONNECTION='latin2_general_ci';"
Připojení k databází
DB_SERVER	Typ databáze ('mysql' nebo 'mssql')
DB_HOST	Název nebo IP adresa databázového serveru.
DB_NAME	Název databáze pro datové tabulky WebToDate
DB_USER	Jméno uživatele databáze
DB_PASS	Heslo uživatele databáze
Vytváření URL stránek
DETAILURL	Vzor URL pro zobrazování zpráv. Je třeba změnit, pokud používáte možnost změny URL zpráv pomocí mod_rewrite či podobné techniky. Výchozí hodnota /scripts/detail.php?id=<!--WTD_F(ID)-->
NEWSABBREV_AUTOFILL	Definuje, co se vkládá jako hodnota pro pole Zkratka v případě, že je předchozí konstanta nastavena na true. Typická hodnota je '<!--WTD_F(ID)-->', neboli vkládá se ID zprávy, nebo '<!--WTD_CONVERT(TITLE)-->', neboli vkládá se konvertovaný nadpis zprávy.
URL_CONVERT_FIND a URL_CONVERT_REPLACE	Tyto dvě konstanty definují mapování jednotlivých znaků (tj. obě musí obsahovat stejný počet znaků) při případné konverzi nadpisu zprávy do URL zprávy.
URL_CONVERT_NOCHAR	Konstanta definuje, které znaky se při případné konverzi nadpisu zprávy do URL bez náhrady odstraňují.
URL_CONVERT_CASE	Konstanta definuje, zda se při generování URL zprávy či zdroje spouští převod na malá nebo velká písmena. Možné hodnoty jsou LOWER (malá písmena) UPPER (velká písmena) nebo prázdná hodnota (nekonvertovat).
$url_convert_entities_map, URL_CONVERT_OTHER_ENTITIES a URL_CONVERT_ENTITIES_CHAR	V poli $url_convert_entities_map se mapují číselné entity na znaky, toto mapování se použije při generování URL zpráv (tedy typicky při převodu nadpisu do URL). Numerické entity, které nejsou v poli, se převedou na znak definovaný v URL_CONVERT_ENTITIES_CHAR (může být i prázdný znak), ale jen v případě, že je nastaveno URL_CONVERT_OTHER_ENTITIES = true.
NEWSURL_MAXLENGTH	Definuje maximální délku obsahu pole Odkaz nadpisu. Pokud je sestavený řetězec delší, ořízne se zprava na tuto hodnotu.
NEWSURL_CONVERT_MAXLENGTH	Definuje maximální délku té části URL, která vzniká konverzí nadpisu pomocí <!--WTD_CONVERT(TITLE)-->. Pokud je tedy výsledek konverze nadpisu delší než zadaná konstanta, ořízne se zprava.
NEWSABBREV_MAXLENGTH	Definuje maximální celkovou délku zkratky, význam je stejný jako u NEWSURL_MAXLENGTH, pouze se aplikuje na obsah pole Zkratka.
NEWSABBREV_CONVERT_MAXLENGTH	Význam konstanty je stejný jako NEWSURL_CONVERT_MAXLENGTH, pouze se aplikuje na obsah pole Zkratka.
NEWSABBREV_UNIQUE_DELIMITER	V případě vygenerování zkratky, která již existuje, se na konec přidává oddělovač a číslo, konstanta definuje tento oddělovač, výchozí hodnota je '_'.
NEWSURL_AUTOUPDATE	Konstanta NEWSURL_AUTOUPDATE definuje režim automatických změn obsahu polí Odkaz nadpisu a Zkratka. Možné hodnoty jsou: 0 - zkratka se automaticky nevyplňuje, URL se přidělí podle konstanty DETAILURL při prvním uložení zprávy a už se nikdy automaticky nemění 1 - zkratka se automaticky vyplňuje pokud je konstanta NEWSABBREV_AUTOFILL neprázdná. Jak zkratka tak URL se vyplní při prvním uložení zprávy a už se automaticky nemění 2 - zkratka a URL se může automaticky změnit při uložení, pokud se změnily údaje, podle kterých se tvoří (seznam údajů je daný konstantami NEWSABBREV_AUTOFILL resp. DETAILURL) a pokud zpráva není ve stavu Publikováno či Archivováno. 3 - stejné jako předchozí případ, ale změna zkratky i URL je povolena i v případě, že zpráva je ve stavu Publikováno či Archivováno.
NEWSABBREV_LOCK	Hodnota false znamená, že pole Zkratka ve zprávách je možné běžným způsobem editovat. Hodnota true znamená, že uživatelé s výjimkou členů týmu Administrátoři nemají možnost hodnotu tohoto pole měnit.
ABBREV_AUTOFILL_ON_PUBLISH	Hodnota true znamená, že je požadováno zachování URL mezi různými verzemi zpráv (tj. při publikaci nové verze se přebírá zkratka a URL předchozí publikované verze), hodnota false znamená, že URL různých verzí zprávy spolu nesouvisejí a chovají se z tohoto hlediska jako samostatné zprávy.Po instalaci je výchozí hodnota false.
URL_PARAMETERS_DELIMITER	Oddělovač parametrů v sestavovaných dynamických URL - výchozí hodnota je '&', můžete ale změnit na '&'
Formátování ve stránkách
DYNAMIC_LINE_BREAK_BEGIN	Počáteční značka používaná při automatickém řádkování těla zpráv.
DYNAMIC_LINE_BREAK_END	Koncová značka používaná při automatickém řádkování těla zpráv.
ADMIN_DATE_FORMAT_STRING	Formát data pro administrační část. Pro formát se používá (stejně jako pro dalších pět níže uvedených konstant) syntaxe PHP funkcí pro formátování data a času. Výchozí hodnota j.n.Y
PUBLIC_DATE_FORMAT_STRING	Formát data pro veřejnou část
ADMIN_TIME_FORMAT_STRING	Formát času pro administrační část
PUBLIC_TIME_FORMAT_STRING	Formát času pro veřejnou část
ADMIN_DATE_TIME_FORMAT_STRING	Formát data a času pro administrační část
PUBLIC_DATE_TIME_FORMAT_STRING	Formát data a času pro veřejnou část
Zapínání a vypínání funkcí v administrační části
BANNER	Aktivace systému správy reklamy.
REDUCE_MENU	Redukce menu pro redaktory - je-li nastaveno na hodnotu true (výchozí hodnota), uživatelé v roli redaktor dostávají hlavní nabídku WebToDate redukovanou jen na položky pro ně potřebné.
RECIPIDS	Reciprocita souvisejících ID u zpráv (souvisí-li zpráva A se zprávou B, uloží se i opačná informace, že B souvisí s A), výchozí hodnota true
AUTHOR_FILL_FIELD	Vyplňování pole Autor jménem přihlášeného uživatele. Hodnota true znamená, že pro zprávy se do pole Autor automaticky vyplní jméno přihlášeného uživatele.
AUTHOR_CHECK_ACCESS_FIELD	Zakázání úpravy pole Autor uživatelem v roli redaktor
ENABLE_KW_ADDING_FROM_USER	Povolení přidávání klíčových slov uživatelem. Pokud je nastaveno na false, klíčová slova do slovníku klíčových slov pro databázi zpráv a zdrojů může přidávat pouze administrátor
ENABLE_KW_ADDING_FROM_XML_IMPORT	Povolení přidávání klíčových slov XML importem.
NEWSLOCK	Zapínání / vypínání systému uzamykání zpráv. Pokud je nastaveno na hodnotu true, systém uzamykání zpráv je aktivní.
Atributy zakládaných souborů
PUBLIC_FILES_ATTRIBUTES	atributy nastavované pro přímo veřejně přístupné soubory ( z hlediska systému Linux, tedy např. 644)
PUBLIC_DIRECTORIES_ATTRIBUTES	atributy nastavované pro přímo veřejně přístupné adresáře
PRIVATE_FILES_ATTRIBUTES	atributy nastavované pro interní soubory vytvářené WebToDate
PRIVATE_DIRECTORIES_ATTRIBUTES	atributy nastavované pro interní adresáře vytvářené WebToDate
Import dokumentů MS Word
WVWARE_EXE	Cesta ke složce s "EXE" souborem programu wvWare (import dokumentů MS Word).
WVWARE_XML_DIR	Cesta ke složce s XML předlohami programu wvWare.
WVWARE_ENCODING	Znaková sad používaná při konverzi wvWare.
Galerie formátů
GALLERY_CACHE	Definuje název adresáře cache pro galerii formátů
GALLERY_CACHE_REFRESH_INTERVAL	Definuje interval (v minutách) expirace položek cache pro galerii formátů
GALLERY_SERVER	Definuje URL serveru pro obsah galerie formátů
GALLERY_URL	Definuje URL výchozího XML souboru pro obsah galerie formátů
Funkce stromu kategorií
NEW_CATEGORY_REGIME	Výchozí režim zakládání výchozích stránek kategorií, Možné hodnoty jsou: 0 – vynucený pokročilý režim, tj. z hlediska aplikace stejné jako 1, ale radiopřepínače pro volbu režimu se ve formuláři pro zakládání nové kategorie vůbec nezobrazuje 1 – pokročilý režim 2 – zjednodušený režim – výchozí jazyk 3 – zjednodušený režim – všechny jazyky
NEW_CATEGORY_PAGE_NAME	Výchozí název souboru s výchozí stránkou. V konstantě lze použít rovněž klíčové slovo <!--WTD_F(LANGUAGEABBREV)--> (zkratka jazyka)
NEW_CATEGORY_PAGE_PATH	Předpisu výchozího tvaru cesty ke stránce. Lze zde použít klíčová slova <!--WTD_F(CATEGORYPATH)--> (cesta daná vnořením složek dle stromu kategorií) a <!--WTD_F(LANGUAGEABBREV)--> (zkratka jazyka)
NEW_CATEGORY_PAGE_PROTOTYPE	Volba vzorové stránky při automatickém zakládání nové stránky. Možné hodnoty jsou: 0 – za vzor pro automatické zakládání výchozích stránek slouží přímo nadřazená kategorie Celé kladné číslo - za vzor pro automatické zakládání výchozích stránek slouží nadřazená kategorie v dané úrovni vnoření, 1= nejvyšší úroveň, 2 = druhá nejvyšší úroveň atd.
NEW_CATEGORY_PAGE_FRAGMENTS	Volba určuje, zda na automaticky zakládané stránky vkládat fragmenty dle vzorové stránky. Možné hodnoty jsou 0 (ne) a 1 (ano)
NEW_CATEGORY_PAGE_LISTS	Volba určuje, zda na automaticky zakládané stránky vkládat seznamy dle vzorové stránky. Možné hodnoty jsou 0 (ne) a 1 (ano, ale jen ty, které jsou parametrizované podle kategorie, ve které se stránka nachází), 2 (ano)
NEW_CATEGORY_PAGE_NAVIGATIONS	Volba určuje, zda na automaticky zakládané stránky vkládat navigace dle vzorové stránky. Možné hodnoty jsou 0 (ne) a 1 (ano)
USE_CATEGORY_PATTERNS	Určuje, kde se hledají výchozí předlohy pro zprávy. Možné hodnoty jsou true – předloha zprávy se hledá nejprve ve výchozí kategorii, pokud není nalezena tak v publikaci false – předloha zprávy se hledá nejprve v publikaci, pokud není nalezena tak ve výchozí kategorii.
TREE_ACCESS_REGIME	Přístupová práva pro vkládání zpráv a zdrojů do stromu kategorií. Možné hodnoty jsou: 1 – členové týmů mohou řadit data do libovolných kategorií 2 – editoři mohou řadit data do libovolných kategorií, redaktoři jen do těch, do kterých mají přístup 3 – členové týmů mohou řadit data jen do těch kategorií, do kterých mají přístup
ALLOW_INSERT_CATEG	Pokud je nastaveno na hodnotu true, mají uživatelé v roli editor právo zakládat podkategorie kategorií, které vlastní tým, v němž figurují v roli editora. Pokud je nastaveno na false, mají možnost zakládat nové kategorie ve stromu kategorií pouze členové týmu Administrátoři.
PRIVATEPAGES	Název adresáře pro ukládání stránek v privátní zóně
PRIVATEPAGES_REGIME	Definuje možnosti ohledně ukládání stránek v privátní zóně. Možné hodnoty jsou: 1 – nové stránky se ukládají do veřejné zóny a uživatelsky toto nelze změnit 2 – uživatel může vybrat způsob uložení, výchozí volba je veřejná zóna 3 – nové stránky se ukládají do privátní zóny a nelze toto uživatelsky změnit 4 - uživatel může vybrat způsob uložení, výchozí volba je privátní zóna
Funkce databáze zdrojů
ASSETS_CREATE_THUMBNAILS	Definuje, zda se spouští funkce na vytváření náhledů. Hodnota true znamená, že se aplikace pokouší vytvářet náhledy pro typ souborů obrázek
ASSETS_THUMBS_WIDTH	Maximální šířka náhledu
ASSETS_THUMBS_HEIGHT	Maximální výška náhledu
ASSETS_CONVERSION_APP_PATH	Cesta k instalaci aplikace ImageMagick
ASSETS_PREFFERED_IMAGE_DIM	Předdefinované rozměry obrázků nabízené ve funkci pro vytváření nových variant obrázků, např. '160x120;200x140;80x60'
ASSETS_UNSHARP_RADIUS	Výchozí poloměr pro funkci Doostřit, výchozí hodnota 1.5
ASSETS_UNSHARP_SIGMA	Výchozí sigma pro funkci Doostřit, výchozí hodnota 1.2
ASSETS_UNSHARP_AMOUNT	Výchozí míra (v procentech) pro funkci Doostřit, výchozí hodnota 100
ASSETS_UNSHARP_THRESHOLD	Výchozí práh (v procentech) pro funkci Doostřit, výchozí hodnota 5
ASSETS_WATERMARK_FILES	Seznam souborů pro vodoznaky, např. '/images/watermark/w1.gif (malé logo); /images/watermark/w2.jpg (velké logo)' - nejprve se uvede URL, v závorce název prezentovaný uživatelům, oddělovačem položek je středník.
ASSETS_WATERMARK_GRAVITY	Výchozí umístění vodoznaku (pořadové číslo z nabídky umístění) pro funkci Vodoznak, výchozí hodnota 9
ASSETS_WATERMARK_BRIGHTNESS	Výchozí jas (v procentech) pro funkci Vodoznak, výchozí hodnota 30
ASSETS_PRIVATEFILES	Název adresáře pro umístění souborů do privátní zóny
ASSETS_PUBLICFILES	Název adresáře pro umístění souborů do veřejné zóny
ASSETS_STORE_TO_DATABASE	Pokud je nastaveno na true, ukládají se soubory do databáze, jinak do souborového systému
ASSETS_NEW_FILE_PATH	Výchozího tvar cesty k souboru. V definici lze použít konstanty <!--WTD_F(CATEGORYPATH)--> (adresáře dané kategoriemi), <!--WTD_F(LANGUAGEABBREV)--> (zkratka jazyka) a <!--WTD_F(CALENDARFOLDERS)--> (dělení adresářů na roky a měsíce). Nastavení konstanty na hodnotu <!--WTD_F(LANGUAGEABBREV)--><!--WTD_F(CATEGORYPATH)--><!--WTD_F(CALENDARFOLDERS)--> tedy vygeneruje cestu ve tvaru /cz/dokumenty/marketing/letaky/2004/12/
ASSETS_SET_SIMPLE_FILENAMES	Možnost přidělování jednoduchých názvů souborů. Pokud je nastavena na hodnotu true, ponechávají se souborům tzv. dočasná jména přidělená PHP uploadem (tedy např. phpnB55YV.jpg).
ASSETS_FILENAME_CONVERT_CASE	Definuje, zda při přejmenování souborů při vkládání do zdroje dochází ke konverzi názvu souboru na malá resp. velká písmena. Možné hodnoty jsou LOWER (malá písmena) UPPER (velká písmena) nebo prázdná hodnota (nekonvertovat).
ASSETS_AUTOREPAIR_FILENAMES	Definuje, zda se při zpracování mění názvy souborů tak, aby neobsahovaly nepřípustné znaky (diakritiku apod.). Pokud je hodnota konstanty jiná než prázdný řetězec, nahrazují se znaky nepovolené v URL zadanou hodnotou. Základní způsob konverze znaků je přitom dán konstantami URL_CONVERT_FIND, URL_CONVERT_REPLACE a URL_CONVERT_NOCHAR. Hodnota této konstanty se použije jen v případě, že je nalezen nežádoucí znak, který není uveden v konstantě URL_CONVERT_FIND ani v URL_CONVERT_NOCHAR.
ASSETS_AUTORENAME_FILENAMES	Pokud je zde prázdný řetězec a ukládá se soubor do adresáře, kde existuje soubor se stejným názvem, nelze soubor vložit a uživateli se zobrazí chybová hláška. Pokud je zde neprázdný řetězec, vytváří se názvy připojením tohoto řetězce + čísla. To znamená, že k souboru obrazek.jpg vznikají další názvy obrazek_1.jpg, obrazek_2.jpg atd. (nikoliv obrazek_1_1.jpg).
ASSETS_PRIVATEFILES_REGIME	Režim ukládání souborů do privátní zóny. Možné hodnoty jsou 1 – nové soubory se ukládají do veřejné zóny a uživatelsky toto nelze změnit 2 – uživatel může vybrat způsob uložení, výchozí volba je veřejná zóna 3 – nové soubory se ukládají do privátní zóny a nelze toto uživatelsky změnit 4 - uživatel může vybrat způsob uložení, výchozí volba je privátní zóna
ASSETS_ENFORCE_STATE_LOCATION	Vynucovat fyzické umístění souborů podle stavu zdroje. Hodnota true znamená, že soubor bude fyzicky v privátní zóně do té doby, než bude zdroj ve stavu publikováno, i když je umístění zvoleno do veřejné zóny.
ASSETS_SIMPLE_ACCESS_RIGHTS	Definuje, zda mohou zdroje publikovat i uživatelé v roli redaktor. Pokud je zde hodnota true, znamená, že to redaktoři mohou pro zdroje nastavovat kterýkoliv stav (pokud zdroj patří jejich týmu) a výchozí stav pro nové zdroje se automaticky předvyplní na Publikováno.
ASETS_USERS_FTP_ACCESS	Definuje přístup k uživatelských schránkám přes protokol FTP, např. 'ftp://mujserver.cz/schranky/'. FTP adresa musí být taková, že směřuje na adresář offlinedata/assets/users/. Aplikace pak doplní adresu tak, že ukazuje na adresář offlinedata/assets/users/id_uživatele/var/. Výchozí hodnota je prázdná, pokud je zde prázdný řetězec, znamená to, že funkce není nakonfigurovaná a v administračním rozhraní WebToDate není přístupná.
ASETS_ALLOW_STATIC_IMAGES	Pokud je následující konstanta nastavena na hodnotu true, mají k funkci Obrázky přístup všichni uživatelé (podobně jako ve verzích WebToDate starších než 4.0), v opačném případě k ní mají přístup pouze administrátoři.
ASSETS_ALLOW_MULTIPLE_FILES	Určuje, zda lze v databázi zdrojů do jednoho zdroje vkládat více než jeden soubor
ASSETS_JPEG_QUALITY	Stupeň JPEG komprese pro náhledy obrázků vytvářené pro potřeby redakčního rozhraní. Pokud konstanta není definována, použije se stejný stupeň komprese jako u původního obrázku. Možné hodnoty jsou 1 – 100 (celé číslo), doporučená hodnota je cca 80.
ASSETS_FRIENDLY_URL	Pokud je konstanta nastavena na hodnotu true, generují se zkratky a URL pro zdroje stejně jako pro zprávy, v opačném případě se zkratky negenerují a URL zdrojů se vytvářejí v systémovém tvaru.
ASSETS_IPTC_CHARSET	V této konstantě lze uvést znakovou sadu, která se použije při načítaní IPTC metadat obrázků. Výchozí hodnota je stejné kódování, v jakém je provozována daná webová prezentace, čili dle konfigurační konstanty CHARSET, jinak se uvede např. 'windows-1250' apod.
VIDEO_CONVERSION_APP_PATH	Plná cesta k adresáři s aplikací FFmpeg pro konverzi videa
VIDEO_THUMBS_DELAY	Z jakého snímku v rámci videosouboru od začátku videosekvence se dělají náhledy, údaj je v sekundách, čili 5 znamená snímek ze začátku páté sekundy, 0 znamená první snímek videosekvence apod.
Chybové výpisy, bezpečnost a interní kontroly a instalace
SESSION_EXPIRE	Časový údaj v minutách, udává po jakém čase se ukončí platnost přihlášení k redakčnímu rozhraní WebToDate v případě neaktivity uživatele
USEMD5PASSWORDS	Používání hesel ve formátu MD5.
MIN_LOGIN_LENGTH	Minimální délka přihlašovacího jména a hesla.
MAX_LOGIN_ATTEMPTS	Maximální počet neúspěšných přihlášení.
CHECK_LOGIN_INTERVAL	Interval pro kontrolu neúspěšných přihlášení do systému (v sekundách)
BLACKLIST_EXPIRATION	Interval vypršení zakázaných IP adres (v sekundách)
INTEGAUTHENT	Způsob autentifikace. Je-li nastaveno na false, používá se interní autentifikace přes formulář, je-li nastaveno na true, používají se autentizační moduly.
AUTH_MODULE	Obsahuje cestu k zásuvnému modulu pro autentizaci, má smysl je pokud je INTEGAUTHENT = true
AUTH_AUTO_ADD_NEW_USER	Definuje, zda je povoleno automatické přidání úspěšně autentizovaného uživatele do seznamu uživatelů WebToDate (hodnota true), má smysl je pokud je INTEGAUTHENT = true
AUTH_AUTO_ADD_SEND_MAIL	Definuje odesílání e-mailů s informací o automatickém založení nového uživatele (hodnota true), má smysl je pokud je INTEGAUTHENT = true
DEBUG	Způsob výpisu databázových chyb. Možné hodnoty 0 (úplné potlačení chybových hlášení aplikace) až 2 (podrobná chybová hlášení.) Hodnota pro instalace v ostrém provozu by měla být 0.
SQL_DEBUG_LIMIT	Pokud není pomocí DEBUG potlačeno vypisování chybových hlášení a dojde při provozu k nějaké chybě SQL příkazu, vypisuje se chybové hlášení obsahující příslušné SQL dotazy. Touto konstantou je možné omezit délku tohoto chybového výpisu, hodnotou je počet znaků, které se mají zobrazit před SQL příkazem, který vyvolal chybu. Výchozí hodnota je 10000.
SHOW_DEVELOPERS_OPTIONS	Pomocný parametr používaný pro ladění skriptů. Pro ostrou instalaci použijte hodnotu false.
DB_CONSTRAINTS_FILE	XML soubor pro databázovou kontrolu.
CHECK_WTD_VERSION	Kontrola konzistence databáze.
CHECK_FILEACCESS_GLOBAL	Zapnutí kontroly neautorizovaných přístupů.
CHECK_FILEACCESS_STRUCTURE	Kontrola přístupových práv souborové struktury. Možné hodnoty: 0 - nekontrolovat 1 – kontrolovat pouze, zda jsou přístupová práva postačující (výchozí hodnota) 2 - kontrolovat pouze, zda jsou přístupová práva postačující a nejsou v některých adresářích nadbytečná (např. zda není povolen zápis do adresáře, kde to není vyžadováno).
ALLOW_PUBLIC_FRAGMENTS	Pokud je tato konstanta nastavena na hodnotu true, lze zobrazovat fragmenty přes prezentační skript /scripts/detail.php?id=xxx. Je-li tato možnost zapnuta, může dojít k nežádoucímu úniku zdrojových kódů případných skriptů generovaných z WebToDate, proto se toto nedoporučuje povolovat. Při nastavení false (výchozí hodnota) je pokus o zobrazení takového URL přesměrován na stránku danou konfigurační konstantou c_error_page_news_nonexistent.
ANTIVIRUS_PLUGIN_PATH	Cesta k pluginu pro antivirovou kontrolu uploadovaných souborů; pokud je tato cesta nastavena na odpovídající plugin pro konkrétní antivirovou aplikaci, provádí se při uploadu souborů (do databáze zdrojů, funkce Obrázky apod.) antivirová kontrola
Cache pro zprávy
CACHE_REGIME	Režim nastavení cache.
CACHE_REFRESH_INTERVAL	Interval automatického vypršení cache.
ALLWAYS_USE_CONNECTION	Vynucené připojování k databázi v případě použití cache pro zprávy
PATH_TO_CACHE	Fyzická cesta ke složce souborů cache.
Verze zpráv a časová platnost zpráv
ON_NEWS_EXPIRATION	Udává stav, který se nastaví, pokud končí platnost zprávy (nastává datum Vyprší dne). 0 = Platnost vypršela, 1 = Archivováno. Výchozí hodnota je 0.
ON_VERSION_PUBLISH	Udává, co se má stát s předchozí verzí, která je ve stavu Publikováno nebo Archivováno ve chvíli, kdy se zpráva publikuje. 0 = předchozí verzi nastavit Platnost vypršela, 1 = předchozí verzi nastavit Archivováno. Výchozí hodnota je 0.
ALLWAYS_ALLOW_PUBLISH	Udává, zda umožnit uživatelům publikovat i zprávy, jejichž interval platnosti se neslučuje a aktuálním časem; true = umožnit. Výchozí hodnota je true.
Různé
LONG_TASK_TIMEOUT	Časový interval v sekundách pro nastavení vypršení platnosti spuštění úloh či funkcí, u kterých se předpokládá delší čas běhu. Většina skriptů WebToDate používá timeout definovaný v konfiguračním souboru PHP, vybrané skripty se pak řídí touto konstantou. Jedná se zejména o: Spuštění plánované úlohy ručně z administračního rozhraní Generování stránek včetně podstromu Vytváření více zdrojů najednou podle obsahu schránky Importy a exporty ve vybraných modulech WebToDate (XML Export / import apod.) Výchozí hodnota je 600 sekund.
PUBLIC_LONG_TASK_TIMEOUT	Časový interval v sekundách pro nastavení vypršení platnosti skriptů v prezentační části webu, u kterých se předpokládá delší čas běhu. V současnosti se aplikuje pouze u skriptu /scripts/file.php pro načítání souborů ze zdrojů. Výchozí hodnota je 600 sekund.
MIN_PRIORITY	Minimální hodnota pole priorita. Platí všude, kde se vyskytuje nějaká priorita (zprávy, kategorie apod.)
MAX_PRIORITY	Maximální hodnota pole priorita. Platí všude, kde se vyskytuje nějaká priorita (zprávy, kategorie apod.). Výchozí hodnota je 1000.
DEFAULT_PRIORITY	Výchozí hodnota pole priorita. Platí pouze pro řazení zpráv na stránky.Výchozí hodnota je 5.
VEDIT_DISABLED_AREAS	V této konstantě lze definovat seznam oblastí, které nelze měnit pomocí vizuálního režimu pro úpravy obsahu stránky. Zadávají se názvy oblastí oddělené středníkem.
INPUT_FIELDS_ROWS	Počet řádek ve formulářových polích, ve kterých se zadává obsah polí přizpůsobitelné struktury databáze zpráv. Výchozí hodnota je 3 řádky.
VARDOCXML	Způsob interního uložení přizpůsobitelné struktury databáze zpráv. Je-li tato nastaveno na true, pak pro obsah vstupních polí přizpůsobitelné struktury existuje jedno databázové pole typu TEXT neomezené délky, data se zde ukládají v XML struktuře. Pokud je nastaveno na false, ukládají se pole rozšířené struktury do speciální databázové tabulky, co pole to jeden sloupec této tabulky.
CONST_IMPORT_KATALOGY_PATH	Cesta ke složce Importu pro modul Formuláře a katalogy.
SCHED_SEQTIMEOUT	Timeout pro sekvence Plánovače úloh.
SCHED_INTERTIMEOUT	Interval pro sekvence Plánovače úloh.
MAX_SEQ_TASKS	Maximální přípustný počet úloh v jedné sekvenci Plánovače. Výchozí hodnota je 10.
MAX_TASK_PARS	Maximální přípustný počet parametrů úloh v Plánovači. Výchozí hodnota je 30.
MAX_SEQ_SCHEDS	Maximální počet různých časování pro jednu sekvenci, které lze v Plánovači úloh nastavit. Výchozí hodnota je 5.
XML_PARSER_TIME_LIMIT	Timeout XML parseru.
XML_PARSER_CHUNK_SIZE	Velikost bloku dat XML parseru.

V konfiguračním souboru se dále nastavuje error_reporting. Jedná se o funkci PHP specifikující úroveň výpisu chyb. Více o nastavení výpisů chyb v PHP naleznete v dokumentaci k PHP na www.php.net.

V konfiguračním souboru dále naleznete konstrukci $g_errorPages = array(…);, ve které jsou uvedeny konstanty vyznačující definované chybové stavy při zobrazování dynamických stránek a URL stránek, na které je uživatel v případě takové chyby přesměrován. Např.

c_error_page_news_no_template => '/errmsg/errorNoTemplate.html'

znamená, že v případě, že se pokoušíme zobrazit zprávu (pomocí skriptu detail.php) a pro zprávu nebyla nalezena předloha, je uživatel přesměrován na URL uvedené v pravé části konstrukce. URL těchto stránek můžete buď změnit, nebo na těchto URL vytvořit stránky s vlastními chybovými hlášeními.

Další možnosti konfigurace

Konfigurace WYSIWYG editoru

WebToDate od verze 4.1 používá jako editor pro HTML kódy FCKeditor. Jednou z vlastností tohoto editoru je rozsáhlá možnost konfigurace a přizpůsobení funkčnosti.

Konfigurační soubory editoru, které lze měnit bez rizika přepsání v případě upgrade systému, se nalézají v adresáři application/fckeditor/webtodate/config/.

Možnosti konfigurace jsou zejména následující:

• Lze přizpůsobit nástrojové lišty, tj. zvolit, které funkce jsou uživatelům přístupny a které nikoliv
• Lze definovat náplň jednotlivých rozevíracích nabídek
• Lze definovat, která kontextová menu (zobrazovaná pravým tlačítkem myši v textu) lze používat
• Lze definovat, kolik kroků zpět je možné se v úpravách vrátit (funkce "undo" a "redo")

Nejdůležitější možnosti konfigurace jsou popsány v této kapitole, další naleznete na stránkách produktu FCKeditor (www.fckeditor.net resp. wiki.fckeditor.net).

V prvé řadě existují dva hlavní konfigurační soubory – jeden se použije pro uživatele, kteří jsou členy týmu Administrátoři, druhý pro ostatní uživatele. To umožňuje, aby např. administrátoři měli bohatší nabídku možností a funkcí, ostatní uživatelé pak pouze to, co mají skutečně používat. Tyto soubory jsou:

• application/fckeditor/webtodate/config/adminconfig.php – konfigurační soubor pro administrátory
• application/fckeditor/webtodate/config/userconfig.php – konfigurační soubor pro ostatní uživatele

Jedná se o PHP soubory, většina kódu je ale v jazyce javascript. PHP kódy neměňte, kódy javascript lze přizpůsobovat dle potřeby.

V prvé řadě je možné definovat, které pluginy editoru jsou přístupné:

FCKConfig.Plugins.Add( 'wtdkeyword', 'cs,en,it' ) ;
FCKConfig.Plugins.Add( 'wtdchapter', 'cs,en,it' ) ;
FCKConfig.Plugins.Add( 'wtdsource', 'cs,en,it' ) ;

První řádek se týká vkládání klíčových slov WebToDate, druhý řádek vkládání klíčových slov modulu Stránkování zpráv, třetí řádek vkládání položek ze zdrojů. Pokud některý z těchto pluginů nepoužíváte, můžete řádek zakomentovat nebo odstranit.

Do editační oblasti editoru lze vložit odkaz na CSS soubor. Pokud tento CSS soubor bude obsahovat podobnou definici CSS tříd, jako se používá v prezentační části, bude vizuálně upravovaný obsah formátován velmi podobně, jako se pak zobrazuje v prezentační části. Toto se provádí příkazem

FCKConfig.EditorAreaCSS = 'URL_CSS_souboru' ;

Užitečná může být volba

FCKConfig.AdditionalNumericEntities  = "'"  ;

Jako hodnotu tohoto parametru lze uvést seznam znaků, které se mají převádět na číselné HTML entity. Je-li potřeba zadat více znaků, oddělují se znakem |, hodnotu lze zadat i jako regulární výraz.

Nastavení FillEmptyBlocks říká, zda do prázdných buněk HTML tabulky má editor automaticky vkládat entitu  , tedy např.

FCKConfig.FillEmptyBlocks = false ;

Dále je možné upravit obsah nástrojové lišty.

FCKConfig.ToolbarSets["Default"] = [
	['Source','-','Save','Preview','-','Templates'],…

V tomto příkazu můžete odstranit ty funkce, které nechcete používat.

Dále lze definovat, která kontextová menu jsou přístupná:

FCKConfig.ContextMenu = ['Generic','Link','Anchor','Image','Flash','Select',…

Nabídka barev pro formátování textu se definuje v příkazu

FCKConfig.FontColors = '000000,993300,333300,003300,003366,…

Nabídka řezů písma se definuje v příkazu

FCKConfig.FontNames = 'Arial;Comic Sans MS;Courier New;Tahoma;Times New Roman;Verdana' ;

Nabídka velikostí písma se definuje v příkazu

FCKConfig.FontSizes = 'smaller;larger;xx-small;x-small;small;medium;large;x-large;xx-large' ;

Nabídka formátů pro paragrafy se definuje v příkazu

FCKConfig.FontFormats = 'p;div;pre;address;h1;h2;h3;h4;h5;h6' ;

Jaké HTML značky konkrétně jsou vkládány pro základní formátování (tj. zda se tučně vkládá jako <b> či <strong> apod.) se definuje pomocí nastavení FCKConfig.CoreStyles. V tomto nastavení nelze přidávat další značky a výrazy, pouze měnit existující seznam.

Pomocí FCKConfig.Keystrokes se definují klávesové zkratky. Prvních pět zkratek ve výchozí konfiguraci (např. [ CTRL + 65 /*A*/, true ]) jsou klávesové zkratky prohlížeče a je doporučeno je neměnit, ostatní lze volně měnit. Např. výraz [ CTRL + 76 /*L*/, 'Link' ] znamená, že klávesa Ctrl + L zobrazí dialog pro vložení hypertextového odkazu.

Pokud při vkládání tabulek MS Excel ze schránky má dojít k označení buněk v prvním řádku a prvním sloupci tabulky jako <th>, je třeba ponechat nastavení

FCKConfig.MSWReplaceTDTH = true;

a

FCKConfig.CleanWordKeepsStructure = true;

Maximální počet kroků pro funkci Zpět se definuje v příkazu

FCKConfig.MaxUndoLevels = 15 ;

Dále lze zapnout nebo vypnout podporu přímého vkládání obrázků, odkazů či flash animací. Jedná se o následující příkazy:

FCKConfig.LinkBrowser = true ;
FCKConfig.ImageBrowser = true ;
FCKConfig.FlashBrowser = true ;
FCKConfig.LinkUpload = false ;
FCKConfig.ImageUpload = true ;
FCKConfig.FlashUpload = true ;

Editor podporuje nabídku Styl, kterou lze rovněž naplnit podle potřeb dané implementace. Obsah této nabídky se definuje v XML souboru, který je umístěn na adrese application/fckeditor/webtodate/config/fckstyles.xml.

Definovaný XML formát umožňuje v pravé řadě definice CSS tříd, které se při aplikaci daného stylu použijí (vygeneruje se HTML element <span class="xxx''">), lze ale definovat i celé bloky kódů s využitím jiných elementů, např. XML kód

	<Style name="Custom Ruler" element="hr">
		<Attribute name="size" value="1" />
		<Attribute name="color" value="#ff0000" />
	</Style>

se při aplikaci v editoru převede na HTML tag <hr color="#ff0000" size="1"'' />.

Styly v nabídce jsou zobrazovány tak, jak ve skutečnosti vypadají, jak je zřejmé z následujícího otisku obrazovky.

Pokud chceme použít nějakou definici CSS třídy, je třeba postupovat následovně:

1. Definici třídy zadat v konfiguračním XML souboru:

   <Style name="Red on Black Global" element="span">

   <Attribute name="class" value="red" />

   </Style>

2. Definici třídy vytvořit v CSS souboru application/fckeditor/webtodate/config/css/custom.css, který používá editor jako zdroj pro uživatelsky definované CSS třídy:

   .red { color: #ff0000; background: black; }

3. Stejnou definici třídy vložit do CSS souboru, který se je vkládán do stránek na veřejné části webové prezentace.

Tlačítkem Šablony lze vkládat šablony HTML kódů. Tyto šablony se definují v souboru application/fckeditor/webtodate/config/fcktemplates.xml. Definice šablony se v tomto XML kódu skládá z názvu a popisu a pak vlastního HTML kódu (v sekci CDATA XML souboru), který se vkládá do editovaného textu. Lze tak např. připravit šablonu pro strukturovaný HTML kód těla zprávy typu popis produktu, životopis apod.

Filtrace HTML kódu ve zprávách

V definici profilu uživatele (viz kapitola Používání editorů a kódu HTML) lze nastavit, že zprávy zadávané tímto uživatelem mají být filtrovány. To znamená, že při uložení dojde k automatickému odstranění nežádoucích HTML značek z textu zprávy.

Seznam povolených značek se definuje v souboru rdata/config/secureTags.txt, jiné značky než zde uvedené jsou filtrovány.

MIME typy stránek

Podporované typy značkovacích jazyků jsou v databázi v tabulce NEWSMIME. Její sloupce jsou:

• ID - interní číslování
• NAZEV - název značkovacího jazyka
• MIME - MIME typ
• ZKRATKA - typická koncovka pro tento typ stránek / souborů

Význam této tabulky je následující:

• Ve formuláři pro vlastnosti stránky se volí značkovací jazyk. Náplň této nabídky pochází z této tabulky.
• Pokud se stránka zobrazuje dynamicky, prezentační skript vkládá do http hlavičky odpovídající MIME typ podle značkovacího jazyka (podle značkovacího jazyka stránky v případě dynamicky zobrazovaných stránek, podle značkovacího jazyka předlohy v případě zpráv).
• Pokud se stránka generuje a zobrazuje staticky, nemá tato tabulka žádný vliv - MIM typ odesílaný serverem je dán v konfiguraci www serveru, který jej stanoví podle koncovky souboru.

Virtuální servery

Virtuální server se konfiguruje v tabulce NEWSSERVER. Tabulka obsahuje následující sloupce:

• ID - interní číslování
• URL - URL kořene virtuálního serveru
• CESTA - fyzická cesta ke kořenovému adresáři virtuálního serveru
• NAZEV - název virtuálního serveru jak se zobrazuje v administračním rozhraní
• CESTATXT - existuje z důvodů zpětné kompatibility, nepoužívá se

První virtuální server (označovaný pak v administračním rozhraní jako "aktuální") se zde nezadává, přidávají se až další virtuální servery.

Kalendářové tabulky

Při instalaci systému se instalují kalendářové tabulky se seznamem názvů měsíců a prvního dne v týdnu. V současnosti je používá pouze modul Kalendář akcí (pro zobrazování výběrů akcí podle měsíčního kalendáře), v budoucnu je ale mohou používat další funkce systému.

Tabulky jsou po instalaci naplněny pouze pro český jazyk. Pokud provozujete vícejazyčný web, může vzniknout potřeba doplnit další jazyky. Struktura tabulek je následující:

Tabulka CALMONTHS (měsíce v roce):

• MONTHID - pořadové číslo měsíce
• LANGUAGEID - interní číslo jazyka (naleznete v tabulce NEWSLANGUAGE)
• NAME - jméno měsíce
• ABBREV - zkratka měsíce

Tabulka CALWEEKDAY (první den v týdnu):

• LANGUAGEID - interní číslo jazyka (naleznete v tabulce NEWSLANGUAGE)
• FIRSTDAY - pořadové číslo prvního dne v týdnu (1 = pondělí atd.)

Dále existuje tabulka CALHOLS pro ukládání státních svátků (může ji využívat modul Kalendář akcí). Tabulka je ve struktuře

• ID - pomocné číslování položek
• DATEHOL - datum svátku
• NAMEHOL - název svátku
• LANGUAGEID - interní číslo jazyka (naleznete v tabulce NEWSLANGUAGE)

Převod dokumentů MS Word do HTML na straně serveru

Import dokumentů MS Word je realizován prostřednictvím programu wvWare, jehož chování určují následující konstanty v souboru global.php:

define ("WVWARE_EXE", "/usr/bin/wvWare") … cesta ke složce, kde je "exe" soubor" instalovaného programu  wvWare.
define ("WVWARE_XML_DIR", "/usr/share/wv/") …cesta ke složce, kde jsou uloženy XML předlohy WvWare.
define ("WVWARE_ENCODING", "windows-1250") … znaková sada použitá při konverzi dokumentů.

Pokud nejsou tyto konstanty správně definovány, nemusí být tlačítko pro import dokumentů ve formulářích pro zprávy vůbec dostupné.

Výchozí nastavení pro konstantu WVWARE_XML_DIR je

define ("WVWARE_XML_DIR", RDATA."config/wvware/");

To znamená, že konstanta ukazuje na adresář rdata/config/wvware, kde se nacházejí konfigurační soubory upravené tak, aby výsledkem konverze byl HTML kód co nejvíce odpovídající standardům a co nejčistší. Soubory wvHtml.xml (definuje konverzi do HTML) a wvText.xml (definuje konverzi do čistého textu) je povoleno upravovat dle potřeby, při upgrade WebToDate se nepřepisují.

Aplikace pracuje se soubory wvHtml.xml a wvText.xml. Pokud jsou v tomto adresáři pouze soubory wvHtml.release.xml a wvText.release.xml, vytvořte jejich kopie a přejmenujte na názvy bez "release" řetězce.

Původní soubory dodávané s aplikací wvWare naleznete v adresáři této aplikace, např. na serveru MS Windows se jedná ve výchozím umístění o adresář c:\Program Files\GnuWin32\share\wv. Je možné rovněž přesměrovat konstantu WVWARE_XML_DIR na tento adresář a tím využívat originálně dodávané konfigurační soubory.

Antivirová kontrola souborů vkládaných na server

WebToDate podporuje možnost antivirové kontroly na straně serveru, a to následujícím způsobem:

• Na serveru musí být instalována příslušná antivirová aplikace, která umožňuje spouštění kontrol jednotlivých souborů přes řádkový příkaz
• Musí existovat PHP plugin WebToDate pro využití této aplikace
• Cesta k tomuto pluginu musí být specifikována v konfigurační konstantě ANTIVIRUS_PLUGIN_PATH v konfiguračním souboru global.php.

Pokud jsou splněny tyto podmínky, všechny funkce pro upload souborů WebToDate a jeho modulů (vkládání souborů do zdrojů, funkce Obrázky apod.) volají antivirovou kontrolu. Pokud je zjištěn virus, je odeslaný soubor odstraněn a není na původně požadované místo vložen.

Standardně je k dispozici plugin pro antivirovou aplikaci ClamAV. Máte-li instalovánu tuto aplikaci s chcete ji využívat k antivirové kontrole souborů, nastavte v konfiguračním souboru global.php konstantu

define('ANTIVIRUS_PLUGIN_PATH', 'av/_clamav.php');

Pluginy pro jiné antivirové aplikace nejsou standardně dodávány a mohou být vytvořeny zakázkovým způsobem.

Výpis konfigurace WebToDate

V základní nabídce Administrace – Konfigurace naleznete výpis aktuálně nastavených konfiguračních hodnot WebToDate. Tato funkce je přístupná pouze administrátorům.

Naleznete zde zejména výpis konfigurace nastavovaný v konfiguračním souboru global.php a zobrazený srozumitelnější formou s vysvětlujícími popisky, ale i další informace o konfiguraci, která se provádí jiným způsobem (např. nastavení podpory virtuálních serverů).

Informace jsou rozděleny do několika logických celků (např. databáze zpráv, bezpečnost, zdroje apod.).

Je-li nakonfigurována podpora více virtuálních serverů, zobrazuje se zde tabulka se seznamem těchto serverů (název a URL).