Google translator »    (Opens in a new window - öffnet in einem neuen Fenster)


Short Documentation Plugin "feed2js"

CMSimple Plugin feed2js 1.0 - released 2014-03

The plugin Feed2js allows you to show RSS feeds in a CMSimple website. It works in the content, in newsboxes and in the template.

The plugin feed2js based on JavaScript and works only if JavaScript is enabled in the browser of the visitor, otherwise a message will be shown. The integration with JavaScript prevents Duplicated Content, because the RSS feed is not included in the sourcecode of the page.


1. System Requirements

Recommended is CMSimple 4.0 or higher.


2. Installation

  1. Download the zip-file and unzip it with a suitable program.
  2. Upload the folder "feed2js" into the folder "./plugins/" of your CMSimple installation.
  3. Define the necessary writing permissions for folders and files by your ftp program.

3. Files- and Folders Permissions

files: chmod 666

folders: chmod 777


4. The Plugin Calls

Insert following plugin calls:

4.1 Simple Plugin Call

{{{PLUGIN:feed2js('full_qualified_url_of_the_feed');}}}

Example:

{{{PLUGIN:feed2js('http://www.tagesschau.de/newsticker.rdf');}}}

If you use the simple plugin call, the RSS Feed will be shown with predefined parameters.

4.2 Plugin Call with Parameters

{{{PLUGIN:feed2js('source','Channel','NumberOf','LinkTarget','Date','Content','Style');}}}

Important hint: If you want to copy the code from here, paste the code in the sourcecode view, so that it contains no formattings.

4.3 The Parameters

The plugin call should be done with all parameters.

Parameter Description Examples
Parameter 1: 'Source' "Source" is the full qualified URL of the RSS Feed, beginning with http://... -
Parameter 2: 'Channel' Controls the display of the RSS feed title.
  • 'title' - shows the title
  • 'y' - shows the title with additional informations
  • 'n' - does not show the title
Parameter 3: 'NumberOf' Number of shown entries.
  • '0' - shows all entries
Parameter 4: 'LinkTarget' New tab/new window.
  • 'y' - opens links in a new tab/new window
  • 'n' - opens links in the same tab/new window
Parameter 5: 'Date' Date of entries
  • 'y' - shows date of entries
  • 'n' - does not show date of entries
Parameter 6: 'Content' Controls the display of the teaser texts
  • 'a' - displays the teaser texts
  • 'p' - does not display the teaser texts
Parameter 7: 'Style' Controls the style of the RSS Feed. The styles must be defined in the stylesheet.css of the plugin.
  • 'default' - activates the default style
  • 'other' - activates 'other' style

Example:

{{{PLUGIN:feed2js('http://www.tagesschau.de/newsticker.rdf','n','6','n','n','a','default');}}}

4.4 Plugin Call in the template.htm

Example:

<?php echo feed2js('http://www.tagesschau.de/newsticker.rdf','n','6','n','n','a','default'); ?>

ge-webdesign.de