helpfulrobot / zauberfisch-silverstripe-page-builder

SilverStripe PageBuilder module

SilverStripe module to allow for modular, block based, content in SilverStripe

WARNING: this module is still work in progress and may not be suitable for production yet.

Major API changes are more than likely

Maintainer Contact

• Zauberfisch [email protected]

Requirements

• silverstripe/framework >=3.5
• zauberfisch/silverstripe-serialized-dataobject >=1.0

Installation

• composer require "zauberfisch/silverstripe-page-builder"

• Optional: install suggested packages

  composer require "zauberfisch/silverstripe-page-builder-basic-blocks"
  

• rebuild manifest (flush)

• Unfortunately a bug in SilverStripe current breaks the HTMLEditorField file management inside a sub controller within the CMS, to work around this bug the following work around is required:

  In your project .htaccess replace RewriteRule .* framework/main.php?url=%1 [QSA] with RewriteRule .* index.php?url=%1 [QSA] and create an index.php file (you can replace the default SilverStripe file if your server supports mod_rewrite) with the following content:

    <?php
    
    if (isset($_GET['ID'])) {
        # redirect as workaround for inset File dialog in the PageBuilder
        # which is broken because ?ID=<$fileID> is mistaken for a Page ID by LeftAndMain
        # lets replace ID with FileID which is then converted back in PageBuilder
        $match = true;
        $url = $_GET['url'];
        foreach(['PageBuilder', 'EditorToolbar', 'viewfile'] as $str) {
            if (strpos($url, $str) === FALSE) {
                $match = false;
                break;
            }
        }
        if ($match) {
            $id = $_GET['ID'];
            $_GET['url'] = str_replace(['?ID=','&ID='],['?FileID=','&FileID='], $url);
            $_REQUEST['FileID'] = $id;
            $_GET['FileID'] = $id;
            unset($_REQUEST['ID']);
            unset($_GET['ID']);
        }
    }
    
    chdir('framework');
    require 'framework/main.php';
  

Documentation

Add the PageBuilder DB Field and FormField to any DataObject, for example Page:

class Page extends SiteTree {
    private static $db = [
        'PageBuilder' => 'PageBuilder_DBField',
    ];
    
    public function getCMSFields() {
        $fields = parent::getCMSFields();
        $fields->addFieldsToTab('Root.Main', [
            new PageBuilder_Field('PageBuilder', $this->fieldLabel('PageBuilder')),
        ]);
        return $fields;
    }
}

Now, in your template, you can access $PageBuilder and output the content:

<% if $PageBuilder %>
    <div class="my-content-blocks">
        $PageBuilder.Value
    </div>
<% end_if %>

See docs/example.md for example project files with some basic frontend.

However, in the bare installation this module does not provide any content types. It just provides the abstract classes and form fields.
Just like with SilverStripe DataObjects it is up to the individual developer and other modules to define the desired data types.
A good starting point with some basic block types can be found in the basic blocks module.

Documentation for creating custom blocks has not been written yet, please refer to the basic blocks module, they should serve as good examples.