Download the PHP package christopherbolt/silverstripe-contentmodules without Composer
On this page you can find all versions of the php package christopherbolt/silverstripe-contentmodules. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download christopherbolt/silverstripe-contentmodules
More information about christopherbolt/silverstripe-contentmodules
Files in christopherbolt/silverstripe-contentmodules
Package silverstripe-contentmodules
Short Description A framework for flexible content modules.
License
Homepage https://github.com/christopherbolt/silverstripe-contentmodules
Informations about the package silverstripe-contentmodules
ContentModules
A framework for adding modular content to a page. All kinds of different content types can be added and re-ordered on a page. This is similar to the WidgetArea module but focused on content. Content Modules will be published and unpublished when the page is published/unpublished, ie. changes to content modules will only be published when the page is published which makes this module fully compatible with Workflow. CMS editors can change the content type of a module in a similar why to how you can change the the type of a page in the CMS.
Requirements
SS 4.x see 1.0 branch for SS 3.x
Creating Modules
No content modules are included, you must create your own.
You must create at least one ContentModule type.
Here is how you might code a basic text content module:
mysite/code/modules/TextModule.php:
themes/mytheme/templates/modules/TextModule.ss:
Adding modules to your page
Add the ModularPageExtension extension to your page:
You can now create and add modules to the page in the CMS.
To display the modules in your page template just use:
Multiple module areas on one page
By default the ModularPageExtension adds a ContentModuleArea named "Modules". You can add additional ContentModuleArea areas:
And you can display your "RightColumn" content modules in your page template with $RightColumn
Customise how modules are stacked in your template
By default modules are simply stacked one after the other, but you might want to stack them in a list:
themes/mytheme/templates/ContentModuleArea.ss:
If you wanted to stack different ContentModuleAreas on your page in different ways then you may prefer to add the loop to your page template:
Controlling which module types are allowed on a page
You can restrict what types of content modules can be added to a page, or if you have multiple module areas on your page you can set restrictions for each area.
If you only have the default "Modules" module area or if you have multiple module areas and want to set the same restrictions for all of them:
If you have multiple module areas you can set restrictions for each one like this:
Installation
All versions of silverstripe-contentmodules with dependencies
silverstripe/cms Version ^3.3
silverstripe/framework Version ^3.3
symbiote/silverstripe-gridfieldextensions Version ^2.0
christopherbolt/silverstripe-publishwithme Version 1.0.x