somardesignstudios/silverstripe-contentblocks

Add Content Block functionality

Content Blocks

, _(*1)

Add Content Blocks with different Layouts to pages., _(*2)

Installation

Composer

composer require somardesignstudios/silverstripe-contentblocks, _(*3)

Manually

Download the archive and extract it into your web root., _(*4)

Features

This module provides four different Content Block layouts out of the Box., _(*5)

Column Layout

This Content Block enables a up to 3 columns of content with background colour options. The columns heights are matched with the the jQuery match heights plugin., _(*6)

Accordion

This Content Block provides basic Bootstrap panel-collapse functionality., _(*7)

Tile Section

This Content Block provides a landing-page type tile layout. Each Tile can have an image, title, caption and link. Tiles can be displayed in rows of two or three. There is also support for user selected templates., _(*8)

GridFieldDropdownAddNewButton

TO DO, _(*9)

Case Study

TO DO, _(*10)

Usage

ContentBlockExtension will add a ContentBlocks tab and GridField to all Pages. Each class of Content Block has it's own button to add to the page., _(*11)

Currently, you can add these to any template by looping over the ContentBlocks and using $RenderBlock, _(*12)

Layout/Page.ss, _(*13)

<% if ContentBlocks %>
    <% loop ContentBlocks %>
        $RenderBlock
    <% end_loop %>
<% end_if %>

Future improvements include allowing content blocks to be inserted individually via Shortcodes as well as allowing the creation of a ContentBlock via a Dropdown Field as opposed to individual buttons., _(*14)

The styling will be basic if not non-existent, this is to allow you full control of the look and feel of the content blocks apart from the Bootstrap bits ofcourse., _(*15)

Configuration

Base Configuration

include_bootstrap

This module requires Twitter Bootstrap 3 for a number of layouts and components. It is recommended to include Bootstrap in your theme as you will better be able to manage cascading styles however, to get going quickly you can set a configuration flag to include the module's bootstrap library which includes just the CSS needed for the components:, _(*16)

config.yml, _(*17)

ContentBlock:
  include_bootstrap: true

types

Specify what types should be able to be created in the GridFieldDropdownAddNewButton. config.yml, _(*18)

ContentBlock:
  types:
    ClassName: 'Dropdown Label'

Extending

Extension hooks are provided in most appropriate places so you can easily customise the behaviour. If you believe there is one missing, feel free to raise an issue or create a pull request., _(*19)

Templates

You can override any of the default templates in this module by creating Templates of the same name in your themes folder., _(*20)

Column Layout

column_classes

You can configure the classes that will be applied to every column with column_classes option., _(*21)

config.yml, _(*22)

ContentBlock_ColumnLayout:
  column_classes:
    - 'my-custom-css-class'
    - 'another-class'

colour_options

You can configure the background colour options using the colour_options option., _(*23)

config.yml, _(*24)

ContentBlock_ColumnLayout:
  colour_options:
    ffffff: 'White'
    hexcode: 'Dropdown Label'

Accordion

accordion_classes

You can configure the classes that will be applied to all panels with accordion_classes option., _(*25)

config.yml, _(*26)

ContentBlock_Accordion:
  accordion_classes:
    - 'my-custom-css-class'
    - 'another-class'

Tiles Section

TO DO, _(*27)

• tile_classes
• tile_templates

Case Study

TO DO, _(*28)

Development

TO DO, _(*29)

TO DO

• Tests
• Internationalization
• Shortcodes