Understanding blocks

Blocks allow the inclusion of pages at runtime. They are ideal for page fragments which may need to be inserted into multiple pages. Since they are inserted at runtime it's possible to also include blocks from other projects. These are called remote blocks.

Remote blocks are handy for page fragments which may need to be updated frequently. For example a footer bar may need to be inserted across many articles but managed in a central location a remote block can be used allowing the content in the footer to be updated without having to republish every article.

1. Any page can be converted into a block by simply hovering over the page tile and clicking the page/block toggle button.

2. When the page is switched to a block a raster overlay will appear over the tile. This is called a block indicator.

3. To add a block to a page simply click the block button in the widget selector popup.

4. Once the block widget is on the page you can use the block settings tool to specify the source of the block. Clicking in the page field will list all available blocks within the project.

If a remote block is desired the project containing the block must first be published. The url to the block will then need to be pasted into the field. The URL format will be as follows:

https://url_to_project/content/views/pages/block_name.html

The block content will then appear on the page at runtime.