82 lines
4.1 KiB
HTML
82 lines
4.1 KiB
HTML
<html>
|
|
<head>
|
|
<meta http-equiv="content-type" content="text/html; charset=iso-8859-2">
|
|
<title>Dokumentace: Backend URL</title>
|
|
<style>
|
|
code {
|
|
display: block;
|
|
padding: 5px;
|
|
border: solid 1px #333333;
|
|
background-color: #cccccc;
|
|
}
|
|
</style>
|
|
</head>
|
|
|
|
<body>
|
|
|
|
<h1>Dokumentace k pluginu 'Backend URL'<br />
|
|
<small>(serendipity_event_backend)</small></h1>
|
|
|
|
<p>Dokumentaci k tomuto pluginu přeložil do češtiny Vladimír Ajgl (vlada [zavinac] ajgl [tecka] cz) a naposledy ji aktualizoval dne 22.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>
|
|
|
|
<h1>Javascriptový backend pro zobrazování příspěvků na webových stránkách mimo Váš blog</h1>
|
|
|
|
<h2>Použití</h2>
|
|
|
|
<p>
|
|
Jednoduše přidejte "<script src=[URL]></script>" na Vaší externí webovou stránku přesně v místě, kde se má zobrazit příspěvek.
|
|
</p>
|
|
<p>
|
|
Můžete také použít CSS styl pro změnu vzhledu těchto zobrazených příspěvků. Můžete použít tři css-třídy. Prohlédněte si prosím soubor "<a href="backend.html">backend.html</a>" v tomto adresáři, který obsahuje názorný příklad.
|
|
</p>
|
|
<p>Poznámka: Můžete přidat tolik tagů "<script src=[URL]></script>", kolik chcete. Každý může mít jiné volby a nastavení.
|
|
</p>
|
|
|
|
<p>[URL] má tvar přibližně takovýto:<br />
|
|
http://vas.blog.cz/plugin/[BACKEND_URL]?[VOLBY]<br />
|
|
Kde [BACKEND_URL] je název, který jste zadali v nastavení pluginu v administrační sekci.
|
|
|
|
<p>[VOLBY] mohou být cokoliv z následujícího:</p>
|
|
|
|
<h3>Volby</h3>
|
|
Je několik voleb, které můžete přidat k url adrese skriptu. Ovlivníte jimi vzhled zobrazených příspěvků.
|
|
|
|
<table>
|
|
<tr><th>název volby</th><th>přípustné hodnoty</th><th>vysvětlivky</th></tr>
|
|
|
|
<tr><td>details</td><td>1|0</td><td>zobrazuje buď pouze nadpis nebo celý příspěvek (bez rošířené textové části!)</td></tr>
|
|
|
|
<tr><td>category</td><td>[název kategorie]</td><td>Pokud je nastaveno, budou se zobrazovat pouze příspěvky ze zadané kategorie. Pokud není uvedeno, budou zobrazeny příspěvky ze všech kategorií.</td></tr>
|
|
|
|
<tr><td>categoryid</td><td>[N]</td><td>Výpis můžete omezit na kategorie také podle jejího identifikačního čísla.</td></tr>
|
|
|
|
<tr><td>authorid</td><td>[N]</td><td>Nastavte ID číslo autora pro výpis pouze jeho příspěvků.</td></tr>
|
|
|
|
<tr><td>num</td><td>[N]</td><td>Pokud je nastaveno, bude se zobrazovat [N] příspěvků. Pokud není zadáno, zobrazuje se 10.</td></tr>
|
|
|
|
<tr><td>order</td><td>ASC|DESC</td><td>řazení příspěvků (podel data, ASC = vzestupně, DESC = sestupně)</td></tr>
|
|
|
|
<tr><td>date</td><td>1|0</td><td>Pokud je nastaveno 1, bude se zobrazovat datum vytvoření příspěvků.</td></tr>
|
|
|
|
<tr><td>dateformat</td><td>[formatstring]</td><td>Zformátuje zobrazované datum příspěvku podle zadaného formátovacího řetězce (přípustné je cokoliv, co umožňuje php funkce <a href="http://cz.php.net/manual/en/function.date.php">date()</a>).</td></tr>
|
|
|
|
<tr><td>time</td><td>1|0</td><td>Pokud je nastaveno 1, bude se zobrazovat čas vytvoření příspěvků.</td></tr>
|
|
|
|
<tr><td>timeformat</td><td>[formatstring]</td><td>Zformátuje zobrazovaný čas příspěvku podle zadaného formátovacího řetězce (přípustné je cokoliv, co umožňuje php funkce <a href="http://cz.php.net/manual/en/function.date.php">date()</a>).</td></tr>
|
|
|
|
<tr><td>point</td><td>[řetězcová konstanta, text]</td><td>Použije tento text jako první část nadpisů. Může být použito pro vytvoření seznamu (přidání tagů <li> nebo něco podobného)</td></tr>
|
|
</table>
|
|
|
|
<h3>Příklady</h3>
|
|
|
|
<p>
|
|
Následující příklad zobrazí až 30 nadpisů s date a časem vytvoření, každé s odrážkou "*" a pouze z kategorie "s9y"<br />
|
|
<code><script src="http://blog.linux-stats.org/plugin/backend?category=s9y&num=30&order=DESC&date=1&dateformat=d.m.Y&time=1&timeformat=H:i&point=*"></script>
|
|
</code>
|
|
</p>
|
|
|
|
<p>
|
|
Následující příklad zobrazí kompletní příspěvky, tak jak jsou zadané na původních stránkách.<br />
|
|
<code><script src="http://blog.linux-stats.org/plugin/backend?details=1&category=s9y&num=30&order=DESC&date=1&dateformat=d.m.Y&time=1&timeformat=H:i"></script></code>
|
|
</p>
|