96 lines
4.8 KiB
HTML
96 lines
4.8 KiB
HTML
<html>
|
|
<head>
|
|
<meta http-equiv="content-type" content="text/html; charset=windows-1250">
|
|
<title>Dokumentace: Rozšířené typy konfigurace</title>
|
|
<style>
|
|
pre {
|
|
display: block;
|
|
padding: 5px;
|
|
border: solid 1px #333333;
|
|
background-color: #cccccc;
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<h1>Dokumentace k pluginu 'Rozšířené typy konfigurace'<br />
|
|
<small>(serendipity_event_advtypes)</small></h1>
|
|
<p>Dokumentaci k tomuto pluginu přeložil do češtiny Vladimír Ajgl (vlada [zavinac] ajgl [tecka] cz) a naposledy zkontroloval dne 15.1.2012. Od té doby mohl být plugin pozměněn nebo mohly být rozšířené jeho funkce. Zkontrolujte pro jistotu i <a href="README">aktuální anglické README</a>.
|
|
<p>
|
|
|
|
<p>
|
|
Tento plugin jednoduše umožňuje použití typu 'sequence' v konfiguraci témat pro verze blogu nižší než 1.2.2.
|
|
</p>
|
|
|
|
<p>
|
|
I když nic nehrozí, pokud je plugin nainstalován na verzi Serendipity 1.2.2 nebo pozdější, není důvod, proč by měl být nainstalován. V případě, že je nainstalován, má drobný vliv na výkon webu (snižuje ho) a vkládá do hlavičky administrátorské sekce bllogu skript dragdrop.js.
|
|
</p>
|
|
|
|
<p>
|
|
Kdykoliv může být bezpečně odinstalován.
|
|
</p>
|
|
|
|
<p>
|
|
I když budete mít tento plugin nainstalovaný, neuvidíte jeho volby nastavení do té doby, než nainstalujete také téma (styl) vzhledu nebo plugin, který tyto volby využívá.
|
|
</p>
|
|
|
|
<p>
|
|
K pluginu přiložené soubory "index.tpl" a "config.inc.php" představují pouze příklady, jak použít výběr médií ve vašich vlastních šablonách. Tyto soubory konkrétně jsou upravené šablony z tématu vzhledu "One True Layout" od Carla Gallowaye a YellowLeda.
|
|
</p>
|
|
|
|
<p>
|
|
Výběr 'sequence' je poněkud složitější. Nejjednodušší je přidat pole podobné následujícímu do voleb tématu vzhledu nebo do pluginu, konkrétně do části 'introspect':
|
|
<code><pre>
|
|
array(
|
|
'var' => 'category_precedence',
|
|
'name' => 'Pořadí kategorií',
|
|
'description' => 'TESTOVÁNÍ: Pořadí, ve kterém budou otestovány kategorie.',
|
|
'type' => 'sequence',
|
|
'items' => array('cat1', 'cat2', 'cat3'),
|
|
)
|
|
</code></pre>
|
|
|
|
V předešlém příkladu budou zobrazeny položky cat1, cat2, a cat3 v rámečku, který lze přesunout metodou Drag&Drop (a nebo, pokud uživatel nemá povolený Javascript, budou zobrazeny v seznamu se šipkami pro posouvání pořadí). Když uživatel potvrdí změny, Váš skript obdrží seznam položek v nastaveném pořadí, oddělený čárkami, například 'cat1,cat3,cat2'.
|
|
</p>
|
|
|
|
<p>
|
|
Někdy můžete chtít skrýt vlastní identifikátor zobrazovaných položek a chtít zobrazovat místo něj hezčí název. Například chcete umožnit nastavení pořadí kategorií a chcete uživateli poskytnout nikoliv čísla 1,7,18,24 a 32, ale rovnou názvy kategorií.
|
|
|
|
K tomu stačí pole z našeho příkladu pozměnit následovně:
|
|
<code><pre>
|
|
array(
|
|
'var' => 'category_precedence',
|
|
'name' => 'Pořadí kategorií',
|
|
'description' => 'TESTOVÁNÍ: Pořadí, ve kterém budou otestovány kategorie.',
|
|
'type' => 'sequence',
|
|
'items' => array( '1' => array('display' => 'Název kategorie 1'),
|
|
'27' => array('display' => 'Název kategorie 27'),
|
|
'34' => array('display' => 'Název kategorie 34'))
|
|
)
|
|
</code></pre>
|
|
|
|
V tomto případě Váš skript obdrží proměnnou 'category_precedence', která bude obsahovat uložené data uložená ve formátu "1,34,27". Uživatel ale uvidí uspořádatelný seznam s položkami 'Název kategorie 1', 'Název kategorie 27' a 'Název kategorie 34'.
|
|
</p>
|
|
|
|
<p>
|
|
To ale není všechno! Někdy ani zobrazené jméno nestačí. Můžete chtít nabídnout uživatelům náhledy obrázků. V takovém případě přidejte jednoduše do pole klíč 'img', který obsahuje plnou URL adresu obrázku. (K zjištění URL závislé na použité šabloně můžete použít například funkci serendipity_getTemplateFile()).
|
|
<code><pre>
|
|
array(
|
|
'var' => 'category_precedence',
|
|
'name' => 'Pořadí kategorií',
|
|
'description' => 'TESTOVÁNÍ: Pořadí, ve kterém budou otestovány kategorie.',
|
|
'type' => 'sequence',
|
|
'items' => array( '1' => array('display' => 'Tento', 'img' => 'http://judebert.com/wasted_youth/classic.gif'),
|
|
'2' => array('display' => 'Tamten', 'img' => serendipity_getTemplateFile('img/minus.png')),
|
|
'3' => array('display' => 'Ten jiný', 'img' => serendipity_getTemplateFile('img/plus.png'))
|
|
)
|
|
</code></pre>
|
|
|
|
V tomto případě budou volby zobrazeny jako 'Tento' s obrázkem odrazivé koule, 'Tamten' se znamínkem mínus, ovšem z adresáře v aktuální šabloně vzhledu, a 'Ten jiný' se znamínkem plus z aktuální šablony. Váš skript pak obdrží seznam ID '3,2,1'.
|
|
</p>
|
|
|
|
<p>
|
|
Jednotlivé styly zápisu můžete kombinovat dle libosti. Každá položka, která nemá definovaný klíč 'img', nebude zobrazovat žádný obrázek. Každá položka, která nemá definovaný klíč 'display', bude zobrazovat rovnou ID. Můžete zobrazovat proměnné pro některé položky a pro jiné ne. Všechno je v pořádku a projde.
|
|
</p>
|
|
</body>
|
|
</html>
|