​Including a blog in pixolino (BETA feature)

Including a blog in pixolino is very easy: The editor has to generate a new page (or edit an existing one) and choose “Blog” as render mode. This page will contain the blog overview with teaser to all articles of the blog. The articles must be in render mode “Blog Article” and be placed in the page tree as direct child of the blog page—otherwise they won't be recognized as articles of this blog.

It is the responsibility of the template developer to ensure that

  • at least one page template section has a defined area for including those article teasers.
  • the template has a sub template section for rendering article teasers.

Preparation of the page template

For displaying the article teasers you have to insert a dynamic slot called fxBlogArticleTeasers:

{{ fx_page.slot("fxBlogArticleTeasers", _context) }}

The articles teasers will always be rendered at the top position of this slot.

If the slot “fxBlogArticleTeasers” ist not existant, the page will be rendered as regular page – and the blog is not shown.

Sub template for rendering of article teasers

The article teaser are rendered with help of a regular sub template. Which sub template is used for displaying the article teasers is defined in the page settings of the blog's page. Within this sub template some special placeholders are available to display article related content:

  • {{ article.title }} will render the title of the article's page [as string].
  • {{ article.navigationTitle }} will render the navigational title [as string].
  • {{ article.image|raw }} will render the preview image of the page [as HTML <img> tag]. Without the filter “raw” no HTML markup is rendered, but the escaped textual representation of the underlying HTML.
  • {{ article.description }} will render the preview description of the page; if no preview description is provided, it will render the OpenGraph description of the page; if no OpenGraph description is provided, it will render the page's meta description [as string].
  • {{ article.ogDescription }} will render the OpenGraph description of the page [as string].
  • {{ article.metaDescription }} will render the page's meta description [as string].
  • {{ article.link }} will render the link href [as string] to the article. You should use it without any leading slashes (e.g. <a href="LINK">).

Navigating between splitted teaser pages

If a page contains more article teasers than configured as maximum, it is split into several pages which contain an individual set of teasers each. The navigation between those pages is handled with a pagination navigation.