Download the PHP package zauberfisch/silverstripe-page-builder without Composer
On this page you can find all versions of the php package zauberfisch/silverstripe-page-builder. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download zauberfisch/silverstripe-page-builder
More information about zauberfisch/silverstripe-page-builder
Files in zauberfisch/silverstripe-page-builder
Package silverstripe-page-builder
Short Description SilverStripe module to allow for modular, block based content in SilverStripe
License BSD-3-Clause
Informations about the package silverstripe-page-builder
SilverStripe PageBuilder module
SilverStripe module to allow for modular, block based, content in SilverStripe
Maintainer Contact
- Zauberfisch [email protected]
Requirements
- silverstripe/framework >=3.7
- zauberfisch/silverstripe-serialized-dataobject >=3.0
- zauberfisch/silverstripe-namespace-templates >=1.0
Installation
composer require "zauberfisch/silverstripe-page-builder"
- Optional: install suggested packages
- composer require
"zauberfisch/silverstripe-page-builder-basic-blocks"
- composer require
- 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
replaceRewriteRule .* framework/main.php?url=%1 [QSA]
withRewriteRule .* index.php?url=%1 [QSA]
and create anindex.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' => \zauberfisch\PageBuilder\Model\DBField::class,
];
public function getCMSFields() {
$fields = parent::getCMSFields();
$fields->addFieldsToTab('Root.Main', [
new \zauberfisch\PageBuilder\Form\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.
Known Issues
- [ ] When using this module with Translatable, the language selection for the TreeDropdownField in the HTMLEditorField insert link dialog does not work
- [ ] GridFields within the dialog might not work
- [ ] Duplicating a Record will duplicate blocks, but ContentBlocks are still linked by their ID, therefore two objects now share the same ContentElement
- [ ] Obsolete ContentElement DataObjects are not deleted (eg if a Text Block is created, but the page is never saved)
- [ ] The Edit Dialog is not ideal for nested content that also requires a dialog (HTMLEditor, GridField, ...)
All versions of silverstripe-page-builder with dependencies
zauberfisch/silverstripe-serialized-dataobject Version ^3.0
zauberfisch/silverstripe-persistent-dataobject Version ^1.0
zauberfisch/silverstripe-namespace-templates Version ^1.0