Documentation

The add-on comes with 8 Feed Entry blocks and 1 News or Blog Feed block.


Place a Feed Entry block anywhere on your site to create a feed entry. Together with the position of the entry, which is where the feed will link to, a date, a headline, a short copy, an image and an entry name will be saved.

The block also displays the URL to the Feed Entry which can be used to link to it from an external location. To alter the vertical link position of the Feed Entry you can set an offset where a negatve value moves the link position up on the page and a positive value down. Alternatively you can select that the link is simply pointing to the top of the page on which the entry is placed.

The 8 Feed Entry blocks automaticly create entries in a News or Blog Feed block. The entries in the feed block are linked back to the entry blocks where the Feed Entry blocks mark the spot on the page to which the links are pointing to.

You can choose from 7 Feed Entry blocks with additional content (content, flash content, google map, html, image, slideshow, youtube) and 1 general Feed Entry block with no extra content.

Use the general block if the content blocks don't provide the type of content you are looking for. You can build your article with any other blocks you like and place a general Feed Entry block in front of them to create an entry in a feed. The general Feed Entry block will not create any additional content on the page but simply mark the spot to which the link in the feed is pointing to.


The News or Blog Feed block creates a list containing of Feed Entries placed on the entire website. Choose between showing a fixed number of entries or to paginate through the entries.

If you select a fixed amount, you can add as many entries as you want to the feed and choose for each entry to show eather the newest, oldest, a random or specific approved Feed Entry. Double entries will be avoided. If you choose "specific entry", a link beneath the drop down will appear which opens a layer where you can select the entry.

In a paginated feed you can choose the order of the shown entries and if you want to paginate by day, week, month, year or number of entries.

Depending on the template of the feed you are using, each entry in the feed will display its date, headline, copy and image together with a link to the Feed Entry block.

You can narrow down the pages from where the feed takes its entries in the pages setting. Choose for each page of your site to be used, not used or to inherit the setting from its parent page. This enables you to have multiple feeds, each pulling its entries from different areas of the site.

You can also limit the shown entries in a feed by age or time period. Create archives by only showing posts of a certain age.

Feed Entries placed in global areas or stacks can not be added to a feed since they are not binded to a specific page, but you can still link to them.

You can retrieve the number of entries of a feed by using the Feed model. Have a look at the developer section for more detailed inforamation about the Feed model.

To adjust the style of the News or Blog Feed block you can choose between 2 templates (list with or without images) and, if you like, edit the view.css of a template.

 

News & Blog Feed supports the Version Online Time Schedule add-on. If you have installed the Version Online Time Schedule add-on, the specific entries are marked in one of four ways:

- same page version
- in both versions
- in live version
- in newest version

Same page version means that the active version of the page, in which the Feed Entry is set, has either no online timeframes defined or a timeframe fits the current time which makes the active page version the same as the live version.

In both versions means that the Feed Entry is present in the active version which has online timeframes defined but none fit the current time and therefore isn't shown, and in the currently shown live version.

In live version means that the Feed Entry is present in the currently shown live version but not in the active version.

In newest version means that the Feed Entry is not present in the currently shown version but in the active version.

You can build your feed out of all these Feed Entries. The News or Block Feed will always only show the entries which are visible/live at the time.

If you don't want the feed to consider online timeframes, you can check the "Don't mind Version Online Timeframes." checkbox. If checked, the feed block will treat all pages and their Feed Entries as were no online timeframes set.

 

With this Special Offer on Timed News & Blog Feed you can combine the flexible creation of news and blog entries done by this add-on and the easy managing of online time for page versions with the Version Online Time Schedule.

 

The News & Blog Feed add-on works out of the box. In addition, it offers ways to integrate your own custom blocks into the add-on and take advantage of its functionality, build an automatism for feed entry creation and to turn existing content into feed entries in bulk. For more visit the developer section.
It is no programming needed what so ever to use the add-on.

 

More Add-Ons by DreamMedia ...