toastnz/quickblocks

Silverstripe content blocks module

SilverStripe QuickBlocks

Simple content blocks system. Nothing fancy, easy to implement., _(*1)

Requirements

• silverstripe/cms 4.0.x
• silverstripe/framework 4.0.x
• symbiote/silverstripe-gridfieldextensions 3.1.1
• edgarindustries/youtubefield 1.1
• sheadawson/silverstripe-linkable 2.0.x-dev

Installation

Add the following to your config.yml:, _(*2)

Page:
  extensions:
    - Toast\QuickBlocks\QuickBlocksExtension

Optionally:, _(*3)

PageController:
  extensions:
    - Toast\QuickBlocks\QuickBlocksControllerExtension

Use Page or other class that extends SiteTree., _(*4)

In your Layout/Page.ss template, add the following:, _(*5)

<% loop $ContentBlocks %>
    $ForTemplate
<% end_loop %>

Configuration

Add / remove available block classes

Toast\QuickBlocks\QuickBlocksExtension:
  available_blocks:
    - Toast\QuickBlocks\TextBlock

Create a custom block

Extend QuickBlock to create a new block type., _(*6)

<?php

namespace Toast\QuickBlocks;

class MyBlock extends QuickBlock
{
    private static $singular_name = 'My Block';
    private static $plural_name = 'My Blocks';
    private static $icon = 'mysite/images/blocks/custom.png';

    private static $db = [
        'Content' => 'HTMLText'
    ];

}

/themes/default/templates/Toast/QuickBlocks/MyBlock.ss:, _(*7)

<%-- Your block template here --%>



$Title


$Content

Todo:

• Template global providers
• Zoning
• Duplicate handlers
• Tests
• Through tables for more advanced versioning