WebToDate/Referenční/Funkce Nastavení: Porovnání verzí

Z WebToDate
Skočit na navigaciSkočit na vyhledávání
Řádek 87: Řádek 87:
==== Použití profilu v pohledech ====
==== Použití profilu v pohledech ====


[[Image:referencniprirucka-zpravy-img039.png|center]]


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

Verze z 29. 9. 2011, 10:45

V nabídce AdministraceNastavení 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ů

Použití profilu v pohledech

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

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.