YANP is the acronym for yet another news plugin. It facilitates semi-automatic handling of news of a CMSimple_XH website, that could be shown as newsbox and made available as RSS feed. Consider it an alternative to creating and maintaining newsboxes manually or using a fully automated solution, such as WhatsNew or RSS Feed. If you have further demands, consider using an advanced solution, such as AdvancedNews or Realblog.
Please do read this documentation! It's generally a good idea to read the documentation, before you encounter any problems!
Yanp_XH is a plugin for CMSimple_XH. It requires a UTF-8 encoded version.
The installation is done as with many other CMSimple_XH plugins. See the CMSimple_XH wiki for further details.
The plugin's configuration is done as with many other CMSimple_XH plugins in the website's back-end. Select "Yanp" from "Plugins".
You can change the default settings of Yanp_XH in "Plugin Config". Hints for the options will be displayed when hovering over the help icon with your mouse.
Localization is done in "Plugin Language". You can translate the character strings to your own language, or customize them according to your needs. Particularly have a look at the entries in the "feed" and "news" group.
The look of Yanp_XH can be customized in "Plugin Stylesheet", or alternatively in your template's stylesheet, as the newsbox and the feed link are tied to that very closely.
Yanp_XH's news are related to CMSimple pages. Each page could have an entry in the news. To control this, just switch to the tab "News" above the editor. If you enter any text as description, the page will be added to the news. If you delete the description, the page will be removed from the news. The timestamp of the news is used for ordering these (latest news will be on top). The timestamp will be updated when you save the tab, but it will not be more recent than the timestamp of the last edit of the according page. So, if you've made a typo in the page and correct it later, the timestamp of the news won't be affected. OTOH, if you change the news later, the timestamp won't be affected, as long as you don't save the page.
To display the newsbox you have to edit your template; replace the already existing newsbox() call to:
<?php echo yanp_newsbox()?>
or insert it, perhaps in addition to already existing newsbox() calls.
Furthermore it's possible to display the newsbox on a CMSimple page by inserting the plugin call:
{{{PLUGIN:yanp_newsbox();}}}
The RSS feed is made available to many modern browsers automatically, because a <link rel="alternate"> tag is inserted to the <head> of your website's pages by Yanp_XH. To additionally display the RSS icon with a link to the RSS feed, you have to insert
<?php echo yanp_feedlink()?>
into your template. This basically works like mailformlink(). If you want to display another feed icon, just put it into your template's images/ folder, and give it's filename as parameter:
<?php echo yanp_feedlink('filename.png')?>
Depending on your web server's configuration, the feed will be served as text/xml, what may cause problems with the UTF-8 encoding. So it should be served as application/rss+xml or application/xml. For Apache servers the solution is to put an according .htaccess file into the plugin's data folder, which is already done for the default data/ folder. An alternative might be setting the "feed extension" to "rss". But anyway, you should validate the RSS feed to be informed about possible problems.
Yanp_XH is licensed under GPLv3.
© 2011-2012 Christoph M. Becker
Danish translation © 2011-2012 Jens Maegard
Slovak translation © 2011-2012 Dr. Martin Sereday
Czech translation © 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.