WebToDate/Referenční/Funkce Nastavení

V nabídce Administrace – Nastavení naleznete nastavení, která jsou globální pro celou instalaci WebToDate a jsou závislá na jazyce. Pod nabídkou Nastavení se rozbalují další volby. Pokud je v systému definován víc než jeden jazyk, nachází se pod nabídkou Nastavení nejprve jazyk a pak teprve další konkrétní položky, v opačném případě, se název jazyka v nabídce vynechává a objevují se rovnou položky nabídky pro jednotlivé funkce.

Stránkování

Ve formuláři je definován vzhled lišt, která jsou používány pro stránkování seznamů.

V horní části je seznam definic lišt, ve spodní části pak formulář pro definici lišty. Každá definice lišty je pojmenovaná, tzv. Systémový název lze pak použít jako parametr klíčového slova pro umístění stránkovací lišty ve stránce. Přepínač Jazyk zde definuje, pro který jazyk bude definice použita - užití se pak provádí automaticky podle jazyka stránky resp. zprávy, na které je stránkování použito.

Stránkovací lišta je v hlavičce nebo patičce stylu reprezentována klíčovým slovem <!--WTD_LISTS(NAVIG)-->. Pokud je tento výraz uveden v tomto tvaru bez dalších parametrů, vkládá se do stránky výchozí stránkovací lišta, neboli ta, u které je zaškrtnuto Výchozí. Pokud chceme do stránky vložit jinou než výchozí stránkovací lištu, je třeba jako druhý parametr uvést systémový název definice lišty, tedy např. <!--WTD_LISTS(NAVIG,jednoduche_strankovani)-->.

Jako první pole pro vlastní definici výpisu stránkování se vyplňuje uvozující nadpis, který je pak reprezentován ve stránce klíčovým slovem <!--WTD_LISTS(LABEL)-->.

Grafický vzhled jednotlivých prvků navigační lišty se definuje pomocí následujících polí:

1. Předchozí – HTML kód určující formátování odkazu pro přechod na předcházející stránku
2. Následující – HTML kód určující formátování odkazu pro přechod na další stránku
3. První - HTML kód určující formátování odkazu pro přechod na první stránku
4. Poslední - HTML kód určující formátování odkazu pro přechod na poslední stránku
5. Hlavička – HTML kód který je umístěn na počátku výsledného kódu navigační lišty
6. Patička – HTML kód který je umístěn na konci výsledného kódu navigační lišty
7. Číslo stránky – formátování jednotlivých čísel stránky, které umožní odkliknutí na zvolenou stránku
8. Aktivní stránka – formátování údaje o čísle aktuální stránky
9. Separátor – oddělovač mezi jednotlivými čísly stránek.
10. Sestavovat odkazy - pokud ze zvoleno Výchozí tvar, generují se nativní URL; je-li zvoleno Čistá URL, aplikují se následující dvě nastavení
11. URL první stránky - určuje tvar URL pro první stránku v rámci stránkování
12. Suffix URL dalších stránek - určuje, co se připojí za URL první stránky v případě, že se jedná o další stránku v rámci stránkování
13. Počet stránek určuje maximální počet čísel stránek v navigační liště a tím nepřímo ovlivňuje i její šířku.

Pro správnou funkci navigační lišty je nutné do výše popsaných polí zadávat i klíčová slova <!--WTD_NAVIG(URL)--> a <!--WTD_NAVIG(NUMBER)-->. Pro URL první stránky a Suffix URL dalších stránek jsou určena klíčová slova

Pro tato pole jsou k dispozici následující výrazy:

<!--WTD_NAVIG(PAGEID)--> - ID zobrazované stránky nebo zprávy

<!--WTD_NAVIG(ABBREV)--> - zkratka zobrazované zprávy

<!--WTD_NAVIG(SURL)--> - prezentační URL zobrazované stránky

<!--WTD_NAVIG(LISTID)--> - ID stránkovaného seznamu

<!--WTD_NAVIG(PAGINGID)--> - číslo stránky v rámci stránkování seznamu

<!--WTD_NAVIG(URL_PARAMETERS)--> - část URL za otazníkem tak jej generuje stránkovací lišta v nativním tvaru

Viz též Klíčová slova použitelná v definici stránkování a Stránkování seznamů a tvary URL.

Logika vkládání odkazů na první a poslední stránku v rámci stránkování je následující:

• Pole První se vkládá za Hlavičku před Předchozí
• Pole Poslední se vkládá před Patičku za Následující
• Před ani za tato pole se nevkládá separátor
• URL odkazu První je vždy URL první stránky v rámci stránkování
• URL odkazu Poslední je URL poslední stránky v rámci stránkování (mělo by odpovídat číslu stránky dosazovanému za <!--WTD_LISTS(PAGETOTAL)-->)
• Odkaz Poslední se vkládá v případě, že existuje další stránka, která není v číselných odkazech na stránky v liště
• Odkaz První se vkládá v případě, že existuje předchozí stránka, která není v číselných odkazech v liště.

Pokud tedy např. existuje 41 stránek a Počet stránek je nastaven na 5, odkaz na první se objeví na stránce č. 4 atd.

WYSIWYG profily

K čemu jsou určeny WYSIWYG profily

Pomocí WYSIWYG profilů je možno definovat vlastnosti vstupních polí typu víceřádkový text v pohledech. Ve formuláři pro úpravu zprávy se typicky nachází několik textových polí, do kterých se zadává prostý nebo HTML formátovaný text. Pro každé takové vstupní pole lze definovat jeho chování ohledně zadávaného obsahu - zda se obsah zadává přímo ve formuláři nebo přes WYSIWYG editor, jaké HTML formátování je povoleno apod. Navíc lze pro úpravu textu pomocí WYSIWYG editoru specifikovat přesnou konfiguraci tohoto editoru, tj. např. jaká je nabídka tlačítek v nástrojové liště, jaké jsou klávesové zkratky apod.

Výsledek definice je znázorněn na následujícím obrázku. Vstupní formulář pro zprávy obsahuje několik textových polí, každé pole ve formuláři se může z hlediska editace textu či HTML kódu chovat naprosto odlišně.

WYSIWYG profil je tedy pojmenovaná sada nastavení pro editaci určitého textového pole vstupního formuláře pro zprávy, kde lze nastavit následující možnosti:

• zda se obsah pole upravuje přímo ve formuláři nebo pomocí WYSIWYG editoru
• kolik řádků má pole ve vstupním formuláři
• možný způsob filtrace HTML kódu - jaké jsou povolené HTML značky a atributy apod.
• konfigurace WYSIWYG editoru, tj. výběr konfiguračního souboru, který může obsahovat jakýkoli popis konfigurace podporovaný WYSIWYG editorem.

Tato funkce podporuje pouze nasazení editoru CKEditor. Pokud daná instalace využívá FCKeditor, nejsou WYSIWYG profily dostupné. Dále je třeba si uvědomit, že pomocí WYSIWYG profilů lze měnit chování editačních polí pro texty pouze v pohledech; chování vstupních polí ve výchozím formuláři pro zprávy nelze tímto nástrojem ovlivňovat.

Vytváření WYSIWYG profilů

V nabídce Administrace – Nastavení - WYSIWYG profily lze vytvářet a měnit pojmenovaná nastavení pro editační textová pole ve zprávách.

Ve formuláři pro definici WYSIWYG profilu se zadává:

• Název profilu - libovolně zvolený název
• Upravovat WYSIWYG - pomocí radiopřepínačů se definuje, zda je povoleno upravovat obsah pole přímo ve formuláři pro zprávu nebo jen WYSIWYG editorem nebo jsou pro uživatele přístupné obě možnosti, případně, zda se WYSIWYG editor má zobrazit přímo ve vstupním poli formuláře pro editaci zpráv
• Konfigurace WYSIWYG editoru - nabídka s výběrem konfiguračního souboru WYSIWYG editoru (viz Vytváření konfiguračních souborů editoru)
• Řádků ve formuláři - kolik řádků má editační textové pole ve formuláři pro zprávu (možné hodnoty 2 až 99)
• HTML filtr - volí se, zda lze do pole vkládat jakékoli HTML nebo filtrované HTML nebo jen prostý text. V případě filtrovaného HTML se zadávají povolené značky (tagy) a atributy. Značky se zadávají kompletní (tedy např. <strong>), u atributů jejich název (tedy např. href). Více položek se odděluje čárkou.

Profily lze zakládat a upravovat libovolně, mazat jen když nejsou použity u nějakého pohledu. Změna nemá zpětnou účinnost, tj. např. když se odstraní nějaká povolená značka a tato značka byla použita v poli zprávy editované pohledem s vybraným profilem, značka ve zprávě zůstává dokud není zpráva znovu uložena.

Použití profilu v pohledech

V případě, že se v rámci definice pohledu nastavují vlastnosti textového víceřádkového pole, je v těchto vlastnostech i WYSIWYG profil, kde se vybírá z existujících definovaných WYSIWYG profilů. V jednom formuláři pro zprávu se tak na různá pole mohou aplikovat různé WYSIWYG profily.

Při editaci zprávy v pohledech platí v případě, že pole má nastaveno WYSIWYG profil, následující pravidla:

• WYSIWYG profil má přednost před ostatními nastaveními, to znamená, že pokud je v profilu zapnut editor, zobrazí se možnost jej použít i když je to v nastavení uživatele zakázáno, filtrace HTML se řídí definicí v profilu a nikoli nastavením ve vlastnostech uživatele atd.
• Nastavení možnosti vkládat HTML v definici pole přizpůsobitelné struktury zpráv má ale přednost před nastavením v pohledu, tj. aby bylo možné HTML vkládat, musí toto být povoleno jak na úrovni definice struktury, tak na úrovni definice pohledu.
• Pokud ve WYSIWYG profilu není vybrán konfigurační soubor pro editor, použijí se výchozí konfigurační soubory adminconfig.php resp. userconfig.php podle toho, jaký uživatel je přihlášen.

Vytváření konfiguračních souborů editoru

V rozevírací nabídce Konfigurace WYSIWYG editoru ve formuláři pro úpravu WYSIWYG profilu se vypisují soubory z adresáře application/ckeditor/webtodate/config/profiles/, a to všechny soubory, i když smysl mají soubory typu *.js a *.php. Do tohoto adresáře lze ukládat konfigurační soubory CKEditoru, které se pak využijí v jednotlivých WYSIWYG profilech. Více WYSIWYG profilů může využívat jeden konfigurační soubor.

Jedná se o stejný typ souborů jako jsou základní konfigurační soubory editoru application/ckeditor/webtodate/config/adminconfig.php a application/ckeditor/webtodate/config/userconfig.php; více o konfiguračních souborech viz Konfigurace WYSIWYG editoru. Tyto konfigurační soubory není nutné ve WYSIWYG profilech definovat - pokud nejsou v profilu vybrány, aplikují se výchozí konfigurační soubory - ale možnost různé konfigurace editoru pro různá pole je jednou z hlavních možností funkce WYSIWYG profily.

Konfigurační soubory je nutné vytvářet přímým přístupem do adresářové struktury WebToDate, v administračním rozhraní WebToDate přístupném přes www prohlížeč tato funkce není dostupná. Jedná se o běžné textové soubory, ve kterých se specifikuje konfigurace. Doporučujeme vyjít ze základních konfiguračních souborů (např. adminconfig.php), jejich kód zkopírovat do adresáře application/ckeditor/webtodate/config/profiles/ a následně upravovat.

Aby ve všech takovýchto konfiguračních souborech nebyl stále se opakující kód základní konfigurace, doporučujeme vytvořit jeden základní konfigurační soubor v adresáři application/ckeditor/webtodate/config/ a ten pak v ostatních konfiguračních souborech odkazovat pomocí příkazu config.customConfig. Např. tedy v adresáři profiles založíme soubor obsahující

CKEDITOR.editorConfig = function( config )
{
  config.customConfig = '/admin/ckeditor/webtodate/config/uniconfig.php';
  
config.toolbar = 
[ 
['Source','-','Save'], 
['Cut','Copy','Paste','PasteText','PasteFromWord'], 
['Undo','Redo','-','Find','Replace','-','SelectAll','RemoveFormat'], 
['Bold','Italic','Underline'], 
['Link','Unlink','Anchor'], ['SpecialChar']
]; 
};

Tento kód znamená, že ve vlastním konfiguračním souboru se definuje pouze velmi omezený obsah nástrojové lišty, ostatní konfigurační volby se definují v souboru /admin/ckeditor/webtodate/config/uniconfig.php. Je tedy třeba nejprve založit soubor config/uniconfig.php, do kterého se vloží základní konfigurace společná pro všechny konfigurace editoru (tj. např. zacházení s entitami, načtení pluginů editoru apod.) a na který se pak všechny ostatní soubory v adresáři profiles odkazují.

Poznámka: Pokud testujete nově zakládané konfigurační soubory, je třeba po každé změně vymazat vyrovnávací paměť (cache) prohlížeče, jinak se změny v konfiguračním souboru nemusí projevit.

Zdroje

Tato funkce zobrazuje formulář, kde lze nastavit výchozí předlohu pro zdroje. Toto nastavení se prakticky uplatní hlavně v případě, kdy se implementují takové styly pro obrázky, které zobrazují obrázek v menší velikosti (uvnitř textu zprávy nebo v seznamu formátovaném jako fotogalerie) a klepnutí na obrázek otevírá stejný obrázek ve větším rozlišení, který je ale vložen do nějaké HTML stránky zobrazující navíc i textové popisky (popis zdroje, autor apod.). Touto HTML stránkou je pak předloha pro zdroje. Proto se nastavení výchozích předloh pro zdroje provádí globálně pro celý server (pro každý jazyk ovšem zvlášť), specifické případy je třeba řešit přímo ve formuláři pro úpravy zdroje výběrem jiné konkrétní předlohy.