YANP je zkratka pro yet another news plugin. Usnadňuje automatické zpracování zpráv webových stránek CMSimple_XH, které by mohly být zobrazena v Newsboxxu a je k dispozici jako RSS feed. Považuji to za alternativu k vytváření a udržování newsboxů ručně, nebo pomocí plně automatické řešení, jako je WhatsNew nebo RSS Feed. Máte-li vyšší požadavky, zvažte použití vyspělejšího řešení, jako je například News nebo Realblog_XH.
Přečtěte si prosím tuto dokumentaci! Je to obecně dobrý nápad číst dokumentaci, ať nenarazíte na nějaké problémy!
Yanp_XH je plugin pro CMSimple_XH. Vyžaduje kódování ve verzi UTF-8.
Instalace se provádí stejně jako u mnoha dalších CMSimple_XH pluginů. Navštivte CMSimple_XH wiki pro více podrobností.
Konfigurace se provádí stejně jako u mnoha dalších pluginů CMSimple_XH v administraci stránek. Zvolte "Yanp" v "Pluginech".
Můžete změnit výchozí nastavení pluginu Yanp_XH v "Config". Tipy pro volby se zobrazí při najetí myší na ikony nápovědy.
Lokalizace se provádí v "Jazyk". Můžete přeložit řetězce znaků do vašeho jazyka (if there is no appropriate language file available), nebo je upravit podle vašich potřeb. Zejména se podívejte na záznamy skupiny "feed" a "news".
Vzhled Yanp_XH lze upravit ve volbě "Styl", nebo alternativně ve Vaší šabloně stylů.
Novinky Yanp_XH jsou určeny pro stránky CMSimple. Každá stránka může mít záznam v novinkách. Chcete-li je přidat, stačí přepnout na záložku "News" nad editore. Pokud zadáte libovolný text jako popis, bude zpráva přidána do stránky. Pokud popis odstraníte, bude stránka odstraněna ze zpráv. Časové razítko novinek se používá pro řazení zpráv (novinky budou nahoře). Časové razítko bude aktualizováno při uložení na kartu, ale nebude novější než časové razítko poslední úpravy v souladu se stránkou. Takže, pokud jste provedli překlep na stránce a opravit ji později, bude časové razítko zprávy nedotčeno. Pokud změníte zprávu později, časové razítko nebude ovlivněno, pokud neuložíte stránku.
Chcete-li zobrazit newsbox musíte upravit šablonu, nahradit již existující newsbox() voláním:
<?php echo yanp_newsbox()?>
nebo vložit, do již existujícího newsbox().
Dále je možné zobrazit Newsbox ve stránce CMSimple vložením volání pluginu:
{{{PLUGIN:yanp_newsbox();}}}
RSS feed je k dispozici v mnoha moderních prohlížečích automaticky, protože <link rel="alternate"> tag se vloží do <head> vaší stránky s Yanp_XH. Chcete-li navíc zobrazit ikonu RSS s odkazem na RSS feed, musíte vložit
<?php echo yanp_feedlink()?>
do vašeho templatu. V podstatě funguje obdobně jako mailformlink(). Pokud chcete zobrazit jinou ikonu RSS stačí ji dát do šablony do složky obrázky, a dát název souboru jako parametr:
<?php echo yanp_feedlink('filename.png')?>
V závislosti na konfiguraci vašeho webového serveru, bude se zdroj generovat jako text/xml, co může způsobit problémy s kódováním UTF-8. Může to tedy sloužit jako aplikace/xml. Pro servery Apache je řesením přidání odpovídajícího souboru .htaccess do adresáře data pluginu, který je již obsažen v defaultní instalaci. Alternativou může též být nastaveni "feed extension" na "rss". Stejně by jste však měli zkontrolovat RSS aby jste byli informováni o případných problémech.
Under CMSimple_XH 1.6 - 1.6.2 when saving the News tab there is the spurious error message "Could not save content file". This is caused by a bug in CMSimple_XH and will be fixed with CMSimple_XH 1.6.3.
When the website can be requested with www and without it (e.g. www.example.com and example.com) without redirecting one to the other, the RSS feed may not link correctly back to itself. It is generally recommended that you establish a 301 redirect from www.example.com to example.com or vice versa.
Yanp_XH je licencován pod GPLv3.
© 2011-2014 Christoph M. Becker
Dánský překlad © 2011-2012 Jens Maegard
Slovenský překlad © 2011-2012 Dr. Martin Sereday
Český překlad © 2012 Josef Němec
The plugin icon was designed by cemagraphics. This plugin uses feed icons from Perishable Press, and "free application icons" from Aha-Soft. Many thanks for publishing these icons as freeware.
Many thanks to the community at the CMSimple forum for tips, suggestions and testing.
Last but not least many thanks to Peter Harteg, the "father" of CMSimple, and all developers of CMSimple_XH without whom this amazing CMS wouldn't exist.