335 lines
11 KiB
HTML
335 lines
11 KiB
HTML
<html>
|
|
<head>
|
|
<meta http-equiv="content-type" content="text/html; charset=windows-1250">
|
|
<title>Dokumentace: Freetag</title>
|
|
<style>
|
|
pre {
|
|
display: block;
|
|
padding: 5px;
|
|
border: solid 1px #333333;
|
|
background-color: #cccccc;
|
|
}
|
|
</style>
|
|
</head>
|
|
|
|
<body>
|
|
|
|
<h1>Dokumentace k pluginu 'Freetag'<br />
|
|
<small>(serendipity_event_freetag)</small></h1>
|
|
|
|
<p>Dokumentaci k tomuto pluginu pøeložil do èeštiny Vladimír Ajgl (vlada [zavinac] ajgl [tecka] cz) dne 13.5.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>, <a href="README.txt">"README.txt"</a> a <a href="ChangeLog">ChangeLog</a>.
|
|
<p>
|
|
|
|
<p>Následující kód ukazuje pøíklad, jak použít rozšíøený výstup do smarty šablony. Takto mùže napøíklad vypadat šablona "entries.tpl"
|
|
<pre>
|
|
{if isset($entry.freetag.extended) && $entry.freetag.extended == 1}
|
|
{if $entry.freetag.tags.tags}
|
|
<div class="serendipity_freeTag">{$entry.freetag.tags.description}
|
|
{foreach from=$entry.freetag.tags.tags item="tag"}
|
|
{$tag}
|
|
{/foreach}
|
|
</div>
|
|
|
|
{if $is_single_entry or $is_preview}
|
|
{$entry.freetag.related.description}
|
|
<ul class="serendipity_freeTag_related">
|
|
{foreach from=$entry.freetag.related.entries item="link"}
|
|
<li>{$link}</li>
|
|
{/foreach}
|
|
</ul>
|
|
{/if}
|
|
{/if}
|
|
{else}
|
|
{$entry.freetag}
|
|
{/if}
|
|
</pre>
|
|
</p>
|
|
|
|
<p>
|
|
Pomocí následujícího sql dotazu mùžete v databázi vytvoøit tagy z existujících kategorií:
|
|
<pre>
|
|
INSERT INTO serendipity_entrytags (entryid, tag)
|
|
SELECT serendipity_entries.id, serendipity_category.category_name
|
|
FROM serendipity_entries, serendipity_category, serendipity_entrycat
|
|
WHERE serendipity_entrycat.entryid = serendipity_entries.id
|
|
AND serendipity_category.categoryid = serendipity_entrycat.categoryid;
|
|
</pre>
|
|
(pøevzato z <a href="http://pixelated-dreams.com/archives/229-Spring-Cleaning.html">http://pixelated-dreams.com/archives/229-Spring-Cleaning.html</a>)
|
|
</p>
|
|
<p>
|
|
A nebo mùžete pro vytvoøení tagù z kategorií použít následující skript:
|
|
<pre>
|
|
<?php
|
|
include 'serendipity_config.inc.php';
|
|
|
|
$rows = serendipity_db_query("SELECT e.id, e.title, c.category_name
|
|
FROM {$serendipity['dbPrefix']}entries AS e
|
|
JOIN {$serendipity['dbPrefix']}entrycat AS ec
|
|
ON ec.entryid = e.id
|
|
JOIN {$serendipity['dbPrefix']}category AS c
|
|
ON ec.categoryid = c.categoryid");
|
|
|
|
foreach($rows AS $row) {
|
|
serendipity_db_query(
|
|
sprintf(
|
|
"REPLACE INTO {$serendipity['dbPrefix']}entrytags (entryid, tag) VALUES (%d, %s)",
|
|
(int)$row['id'],
|
|
serendipity_db_escape_string($row['category_name'])
|
|
)
|
|
);
|
|
|
|
printf(
|
|
"Category '%s' added as Tag for Entry #%d, '%s'<br />\n",
|
|
htmlspecialchars($row['category_name']),
|
|
(int)$row['id'],
|
|
htmlspecialchars($row['title'])
|
|
);
|
|
}
|
|
?>
|
|
|
|
</pre>
|
|
</p>
|
|
|
|
<h1>Historie verzí (ChangeLog)</h1>
|
|
<ul>
|
|
<li>verze 3.39</li>
|
|
<ul>
|
|
<li>pøidána specifická kontrola is_array($eventData), díky uživateli [gregman]</li>
|
|
</ul>
|
|
<li>verze 3.38</li>
|
|
<ul>
|
|
<li>Doplnìn chybìjící fieldset v pøípadì, kdy nebylo zadáno nastavení admin_show_taglist (díky uživateli [gregman])</li>
|
|
</ul>
|
|
<li>verze 3.37</li>
|
|
<ul>
|
|
<li>Pøi zveøejòování pøíspìvku, nahrazení cat2tag je nyní provádìnou i v pøípadì, že jsou tagy prázdné, takže pøíspìvek bude mít vždy alespoò tagy shodné se jmény kategorií.</li>
|
|
</ul>
|
|
<li>verze 3.36</li>
|
|
<ul>
|
|
<li>Opraven [tag] v jedné instanci HTML formuláøového pole, díky uživateli [ascger] z diskuzního fóra</li>
|
|
</ul>
|
|
<li>verze 3.35</li>
|
|
<ul>
|
|
<li>Opraveno - Zmìna nìkterých instancí [tag] na %5Btag%5D, který je kompatibilní s HTML - bug è.3427291</li>
|
|
</ul>
|
|
<li>verze 3.34</li>
|
|
<ul>
|
|
<li>Pro mysql použít pouze sql dotaz SHOW.</li>
|
|
</ul>
|
|
<li>verze 3.33</li>
|
|
<ul>
|
|
<li>Odkazy na https:// místo http://, aby správnì fungoval backend na serverech se zapnutým SSL. Díky uživateli [Manko10].</li>
|
|
</ul>
|
|
<li>verze 3.30, 3.31, 3.32</li>
|
|
<ul>
|
|
<li>Aktualizováno - použitý pøiložený tagcloud.swf od WP-Cumulus/Roy Tanck na verzi 1.23.</li>
|
|
<li>Opraveno - Hrozba HTML injection nahlášená uživatelem [MustLive]</li>
|
|
<li>Opraveno - Hrozba XSS (Cross Site Scripting) nahlášená uživatelem [Stefan Schurtz]</li>
|
|
</ul>
|
|
<li>verze 3.28</li>
|
|
<ul>
|
|
<li>Možnost použití konstrukce ?serendipity[tag]=Tag1;Tag2;Tag3</li>
|
|
</ul>
|
|
<li>verze 3.27</li>
|
|
<ul>
|
|
<li>Správná detekce porovnání (collation) v MySQL databázi</li>
|
|
</ul>
|
|
<li>verze 3.26</li>
|
|
<ul>
|
|
<li>Pøidána kontrola is_array() [Timbalu]</li>
|
|
</ul>
|
|
<li>verze 3.25</li>
|
|
<ul>
|
|
<li>Oprava kódování databáze</li>
|
|
</ul>
|
|
<li>verze 3.24</li>
|
|
<ul>
|
|
<li>Pøidáno kórování databáze (MySQL), oprava od uživatele [Vincent]</li>
|
|
</ul>
|
|
<li>verze 3.23</li>
|
|
<ul>
|
|
<li>Pøidána oprava zalamování bílých znakù, viz <a href="http://board.s9y.org/viewtopic.php?f=5&t=17760">http://board.s9y.org/viewtopic.php?f=5&t=17760</a></li>
|
|
</ul>
|
|
<li>verze 3.22</li>
|
|
<ul>
|
|
<li>Ošetøen možný XSS útok (Cross Site Scripting) reportovaný uživatelem [Stefan Schurtz] (SSCHADV2011-004)</li>
|
|
</ul>
|
|
<li>verze 3.21</li>
|
|
<ul>
|
|
<li>Pøidán háèek (event hook) "sort" pro plugin serendipity_event_sort (autor [lazybadger])</li>
|
|
</ul>
|
|
<li>verze 3.20</li>
|
|
<ul>
|
|
<li>Mrak tagù se zobrazuje jako smarty šablona "plugin_freetag.tpl". Pokud si chcete pøizpùsobit výstup, zkopírujte tento soubor do adresáøe vašeho stylu vzhledu a upravte ho dle sebe.</li>
|
|
</ul>
|
|
<li>verze 3.18</li>
|
|
<ul>
|
|
<li>Automatická detekce klíèových slov nyní funguje pouze vnì html tagù, takže nic jako <a href="/serendipity/"> nyní nebude detekováno jako klíèové slovo 'serendipity'</li>
|
|
</ul>
|
|
<li>verze 3.17</li>
|
|
<ul>
|
|
<li>Pøidána funkce do administrátorské sekce: vyèištìní tagù pøiøazených k neexistujícím pøíspìvkùm.</li>
|
|
<li>Text potvrzovacího tlaèítko ve formuláøi pro pøejmenování tagu už není zadán natvrdo, ale dá se pøeložit.</li>
|
|
<li>Opravena chyba v syntaxi HTML ve formuláøi pro pøejmenování tagu, a to použitím odpovídající HTML entity.</li>
|
|
</ul>
|
|
<li>verze 3.16</li>
|
|
<ul>
|
|
<li>Oprava chyby: Klíèová slova (meta-keywords) se nezobrazovala v pøíspìvcích.</li>
|
|
</ul>
|
|
<li>verze 3.15</li>
|
|
<ul>
|
|
<li>Odstranìna nesprávná chybová hláška "FATAL ERROR! Unrecognized type for
|
|
serendipity_event_freetag:: !"
|
|
<br />(Fatální chyba! Neznámý typ pro serendipity_event_freetag:: !)</li>
|
|
</ul>
|
|
<li>verze 3.13, 3.14</li>
|
|
<ul>
|
|
<li>Pøidáno volání funkce mb_internal_encoding() pro správný pøevod znakù na malá písmena.</li>
|
|
</ul>
|
|
<li>verze 3.12.1</li>
|
|
<ul>
|
|
<li>Nahrazeno "wick-based" automatické doplòování jquery pluginem (wick nefungoval v Opeøe) </li>
|
|
</ul>
|
|
<li>verze 3.11.0</li>
|
|
<ul>
|
|
<li>Pøidána volba, zda mají být tagy pøidány na základì automatického hledání klíèových slov.</li>
|
|
<li>Opraveny falešné výsledky pøi zmìnì hledání na regulární výrazy.</li>
|
|
</ul>
|
|
<li>verze 3.10.5</li>
|
|
<ul>
|
|
<li>Chytání oèekávaných chyb v tagcloud query.</li>
|
|
</ul>
|
|
<li>verze 3.10.4</li>
|
|
<ul>
|
|
<li>Pøidána další kontrola na prázdný výsledek pro potlaèení chybových hlášek databáze.</li>
|
|
</ul>
|
|
<li>verze 3.10.3</li>
|
|
<ul>
|
|
<li>Opraveny chybìjící tagy v náhledu uloženého pøíspìvku v pøehledu pøíspìvkù.</li>
|
|
<li>Opraveno pøipojování výstupu k náhledu v editoru.</li>
|
|
</ul>
|
|
<li>verze 3.10.2</li>
|
|
<ul>
|
|
<li>Opravena chybná detekce rozšíøeného/jednoduchého pøíspìvku.</li>
|
|
</ul>
|
|
<li>verze 3.10</li>
|
|
<ul>
|
|
<li>Produkuje podobné èlánky jako neèíslovaný seznam <ul></li>
|
|
<li>Zanoøení o jeden krok níže pøi prohledávání podobných tagù.</li>
|
|
<li>"Podobné tagy" je nyní odstavec <p> míst pùvodního bloku <div></li>
|
|
<li>Zaveden rozšíøený Smarty-Markup</li>
|
|
<li>Vyèištìní kódu v displayEntry()</li>
|
|
</ul>
|
|
<li>verze 3.09</li>
|
|
<ul>
|
|
<li>Opraveno chybìjící escapování promìnných v SQL dotazech.</li>
|
|
</ul>
|
|
<li>verze 3.08 [Chessnut]</li>
|
|
<ul>
|
|
<li>Pøi prohlížení pøíspìvkù podle tagù nejsou používána omezení kategoriemi (jako napøíklad v pluginu startcat)</li>
|
|
</ul>
|
|
<li>verze 3.07</li>
|
|
<ul>
|
|
<li>Kontrola, že se pole array vytvoøí pouze pøi úspìšném provedení SQL dotazu.</li>
|
|
</ul>
|
|
<li>verze 3.06 [garvinhicking]</li>
|
|
<ul>
|
|
<li>Oprava automatického hledání dle klíèových slov i na tagy s velkými písmeny.</li>
|
|
</ul>
|
|
<li>verze 3.05 [garvinhicking]</li>
|
|
<ul>
|
|
<li>Používání pouze flash-bg/fg barev, pokud je flash cloud zapnut.</li>
|
|
</ul>
|
|
<li>verze 3.04 [garvinhicking]</li>
|
|
<ul>
|
|
<li>Pøidána nezdokumentovaná volba pro vložení pøíbuzných pøíspìvkù do pøehledu (<a href="http://board.s9y.org/viewtopic.php?f=10&t=11124&p=83814#p83814">http://board.s9y.org/viewtopic.php?f=10&t=11124&p=83814#p83814</a>)</li>
|
|
</ul>
|
|
<li>verze 3.03 [garvinhicking]</li>
|
|
<ul>
|
|
<li>Pøidáno escapování databáze pøi ètení tagù.</li>
|
|
<li>Opraven duplicitní øetìzec LIMIT v SQl dotazu. (Díky uživateli [rupa])</li>
|
|
</ul>
|
|
<li>verze 3.01 [designor]</li>
|
|
<ul>
|
|
<li>Optimalizace výstupu, použití nejnovìjšího SWFObject.</li>
|
|
</ul>
|
|
<li>verze 3.0 [lstrojny]</li>
|
|
<ul>
|
|
<li>Oprava verze</li>
|
|
</ul>
|
|
<li>verze 2.51 [lstrojny]</li>
|
|
<ul>
|
|
<li>Opraveno øazení tagù pøi použití se šablonou.</li>
|
|
</ul>
|
|
<li>verze 2.5 [lstrojny]</li>
|
|
<ul>
|
|
<li>Pøidání možnosti použití Smarty šablony pro vykreslení postranního sloupce.</li>
|
|
<li>Sjednocení èísel verzí.</li>
|
|
</ul>
|
|
<li>verze 2.105 [RobA]</li>
|
|
<ul>
|
|
<li>Opravy ve Flashi, omezování poètu tagù, výchozí hodnoty nastavení.</li>
|
|
</ul>
|
|
<li>verze 2.103 [RobA]</li>
|
|
<ul>
|
|
<li>Pøidán rotující Flashový tagcloud (mrak tagù)</li>
|
|
</ul>
|
|
<li>verze 2.97 [garvinhicking]</li>
|
|
<ul>
|
|
<li>Možnost umístìní tagù do smarty šablony pomocí {$entry.freetag}, pokud je nastaveno použití smarty.</li>
|
|
</ul>
|
|
<li>verze 2.96 [garvinhicking]</li>
|
|
<ul>
|
|
<li>Oprava XSS pøi zobrazování mraku pøíbuzných tagù, díky [<a href="mailto:Alex@bitsploit.de">Alex@bitsploit.de</a>]</li>
|
|
</ul>
|
|
<li>verze 2.95 [garvinhicking]</li>
|
|
<ul>
|
|
<li>Pøidán nastavitelný obrázek technorati</li>
|
|
</ul>
|
|
<li>verze 2.92/2.45 [brockhaus]</li>
|
|
<ul>
|
|
<li>Pøidáno nastavení pro XML obrázek</li>
|
|
</ul>
|
|
<li>verze 2.88/2.44 [brockhaus]</li>
|
|
<ul>
|
|
<li>Pøidán volitelný tag technorati za tagy v patièce pøíspìvku.</li>
|
|
</ul>
|
|
<li>verze 2.88/2.43 [brockhaus]</li>
|
|
<ul>
|
|
<li>Pøidána možnost nastavení minimální/maximální velikosti fontu v postranním sloupci.</li>
|
|
</ul>
|
|
<li>verze 2.88/2.42 [garvinhicking]</li>
|
|
<ul>
|
|
<li>Øazení tagù v postranním sloupci bez ohledu na velikost písmen.</li>
|
|
</ul>
|
|
<li>verze 2.88/2.41 [brockhaus]</li>
|
|
<ul>
|
|
<li>Plugin pro postranní sloupec vždycky naèetl prvních X tagù podle jména, ne podle pøíbuznosti (tagcount, poèet tagù). Tedy pøíbuzné/podobné tagy tagy na konci abecedy se nezobrazovaly.</li>
|
|
</ul>
|
|
<li>verze 2.70</li>
|
|
<ul>
|
|
<li>Pøidána možnost "automatické tagy". To znamená, které tagy pøiøadit k pøíspìvku, pokud jsou v nìm nalezena klíèová slova svázaná s tagem.</li>
|
|
</ul>
|
|
<li>verze 2.64</li>
|
|
<ul>
|
|
<li>Pøidána volba pro pøevod kategorií na tagy.</li>
|
|
</ul>
|
|
<li>verze 2.48</li>
|
|
<ul>
|
|
<li>Nastavení pro pøevod na mlá písmena, oprava od [Lars Strojny]</li>
|
|
</ul>
|
|
<li>verze 2.47</li>
|
|
<ul>
|
|
<li>Lepší zobrazování meta-informací</li>
|
|
</ul>
|
|
<li>verze 2.44</li>
|
|
<ul>
|
|
<li>Zobrazování podobných pøíspìvkù, oprava od [Stain]</li>
|
|
<li>Zmìna místa zobrazování tagù, nyní nastavitelné uživatelem.</li>
|
|
</ul>
|
|
|
|
</ul>
|
|
|
|
</body>
|
|
</html>
|