Wagtail Column Blocks
Project description
A generic, reusable column block for Wagtail streamfields.
Allows developers to create column layouts with a number of different layout
ratios that are supported in the admin in a visually appealing way.
![Admin interface showing column blocks in a streamfield](/docs/admin.png?raw=true)
A basic frontend template is included, but no frontend CSS. Due to the
variations of responsive layouts and frontend layout frameworks,
frontend templates should be overridden by the developer.
Usage Example
-------------
```python
class CommonBlocks(blocks.StreamBlock):
content = RichTextBlock(group="Common")
image = ImageChooserBlock(group="Common")
embed = EmbedBlock(group="Common")
class ColumnBlocks(blocks.StreamBlock):
column_1_1 = ColumnsBlock(
CommonBlocks(),
ratios=(1, 1),
label="Two halves",
group="Columns",
)
column_2_1 = ColumnsBlock(
CommonBlocks(),
ratios=(2, 1),
label="Two thirds/One third",
group="Columns",
)
column_1_1_1 = ColumnsBlock(
CommonBlocks(),
ratios=(1, 1, 1),
label="Three thirds",
group="Columns",
)
class AllBlocks(ColumnBlocks, CommonBlocks):
pass
```
License
-------
Licensed under the BSD 3-clause "New" or "Revised" License.
(c) 2017, Squareweave. All rights reserved.
Allows developers to create column layouts with a number of different layout
ratios that are supported in the admin in a visually appealing way.
![Admin interface showing column blocks in a streamfield](/docs/admin.png?raw=true)
A basic frontend template is included, but no frontend CSS. Due to the
variations of responsive layouts and frontend layout frameworks,
frontend templates should be overridden by the developer.
Usage Example
-------------
```python
class CommonBlocks(blocks.StreamBlock):
content = RichTextBlock(group="Common")
image = ImageChooserBlock(group="Common")
embed = EmbedBlock(group="Common")
class ColumnBlocks(blocks.StreamBlock):
column_1_1 = ColumnsBlock(
CommonBlocks(),
ratios=(1, 1),
label="Two halves",
group="Columns",
)
column_2_1 = ColumnsBlock(
CommonBlocks(),
ratios=(2, 1),
label="Two thirds/One third",
group="Columns",
)
column_1_1_1 = ColumnsBlock(
CommonBlocks(),
ratios=(1, 1, 1),
label="Three thirds",
group="Columns",
)
class AllBlocks(ColumnBlocks, CommonBlocks):
pass
```
License
-------
Licensed under the BSD 3-clause "New" or "Revised" License.
(c) 2017, Squareweave. All rights reserved.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
wagtailcolumnblocks-0.0.1.tar.gz
(428.7 kB
view hashes)
Close
Hashes for wagtailcolumnblocks-0.0.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8752fab1bccac603fc1c8cee4eb497383dc002e48dc628261c39d706091eb58f |
|
MD5 | 00eaa6cdab3d50617867c7acfcd9f2fe |
|
BLAKE2b-256 | 07d709781c3c74612c0e7f6e1e3a97ab4f42beb8264dc4cc55d404a928c2794b |