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.

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.

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 details)
File details
Details for the file wagtailcolumnblocks-0.0.1.tar.gz
.
File metadata
- Download URL: wagtailcolumnblocks-0.0.1.tar.gz
- Upload date:
- Size: 428.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8752fab1bccac603fc1c8cee4eb497383dc002e48dc628261c39d706091eb58f |
|
MD5 | 00eaa6cdab3d50617867c7acfcd9f2fe |
|
BLAKE2b-256 | 07d709781c3c74612c0e7f6e1e3a97ab4f42beb8264dc4cc55d404a928c2794b |