Download the PHP package nathancox/contentgrid without Composer
On this page you can find all versions of the php package nathancox/contentgrid. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package contentgrid
SilverStripe ContentGrid Module
Adds TinyMCE buttons for creating content structured in grids/columns. You create your own grid markup and classes. Grid rows aren't nestable (yet) and assume assume all the content in the field will be stored in grid rows (you can't have content that isn't in one) so make sure to provide a "100% width" option.
This module is still work in progress
Maintainer Contact
- Nathan Cox [email protected]
Requirements
- silverstripe/cms >=4.0
Installation
composer require "nathancox/contentgrid"
You will have to make your own grid CSS in your site's theme, this module doesn't provide one. The module inserts the following markup:
So basically a wrapper div with a div in it for each column. {your-row-class} is a class specific to each row layout, such as "two-column" for two equal width columns or "with-sidebar" for a content column and a sidebar column. Whatever your needs and grid system require.
In future these class names should be configurable but for now it always uses .content-row
and .grid-row
.
Make sure your grid styles are accessible in editor.css so they work in TinyMCE.
To set up the row dropdown options set the row_types property in your yml config:
Additional configuration options and their defaults:
If enabled
is set to true
then this module will apply to all HTMLEditorFields. Individual fields can be excluded be excluded by using $field->setAttribute('data-content-grid', 'false')
.
If enabled
is false
then grids can be enabled for individual HTMLEditorFields by using $field->setAttribute('data-content-grid', 'false')
.
Usage
- Only content inside grid cells is editable. That means at least one grid row has to be inserted before any content can be put on the page.
- Insert a row by picking an option from the Insert a row dropdown. The new row will either be added at the bottom of the content or immediately after the currently selected row, depending on configuration.
- Use the Move up and Move down buttons to move the currently selected row up or down the page.
- Use the Delete button to delete the current row and all it's content.
- Once you've inserted a row you can't change the number or layout of it's columns. You'll have to insert a new row and copy the content in to that instead.