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.2.tar.gz
(430.4 kB
view hashes)
Close
Hashes for wagtailcolumnblocks-0.0.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 141fb8ed353f1171f99145ceae95f196db5ccb26e94b5fcac3c049cec18d308f |
|
MD5 | 1f83b6fb935996c16538c389dd5a8845 |
|
BLAKE2b-256 | 31c0078688634d50b1575fc5ef3a6235057780182db5d28930d47648a0f9da92 |