Gridder layout for the Django CMS Wagtail.
Project description
Wagtail Gridder
Wagtail Gridder is a Bootstrap 4 enabled layout for the Wagtail CMS. Grid Items are created within categories and displayed on a Grid Index Page. The JavaScript libraries Gridder and MixItUp are included.
Requirements
- Django >= 1.11
- Wagtail >= 2.0
- Bootstrap >= 4
These installation instructions assume you are using Wagtail 2.0 or greater.
Installation
This installation assumes that you already have Django and Wagtail installed as part of your project.
Wagtail Gridder can then be installed like most Django apps. First, install it into your virtualenv:
pip install wagtailgridder
Then add wagtailgridder to your list of INSTALLED_APPS in your Django settings file. You will also need to add wagtail.contrib.modeladmin, if you haven't already. Your final settings may look something like this:
WAGTAIL_APPS = [
'taggit',
'modelcluster',
'wagtail.core',
'wagtail.admin',
'wagtail.documents',
'wagtail.snippets',
'wagtail.users',
'wagtail.images',
'wagtail.embeds',
'wagtail.search',
'wagtail.sites',
]
WAGTAIL_CONTRIB_APPS = [
'wagtailgridder',
'wagtail.contrib.modeladmin',
]
INSTALLED_APPS = INSTALLED_APPS + WAGTAIL_APPS + WAGTAIL_CONTRIB_APPS
This Wagtail Gridder template extends base.html, with the hope that this allows inclusion or your site's top and bottom navigation without much effort. There is an example base.html provided.
Then log into the Wagtail admin, and you should see a "Grid Layouts" section of the menu. The first thing you will want to do is add some "Grid Categories." After that, you can create "Grid Items" (the cards, pictured below) and put them together on a "Grid Index Page."
Settings
WAGTAILGRIDDER_CLEAR_CACHE = False
The default Wagtail Gridder template caches the grid display area to reduce the number of queries performed. Setting WAGTAILGRIDDER_CLEAR_CACHE = True in your Django settings will clear the entire Django cache after a page is edited. This approach is necessary, as Django does not currently support deletion from the cache by pattern. Setting this to True will clear your cache every time you save a Wagtail page. If anyone knows of a better solution that works for Django's supported cache systems, please let us know!
Screenshots
Grid Index Page:
Grid Index Page, with Grid Item expanded:
Optional featured hero region:
Grid Item landing page:
Editing a Grid Item:
Editing a Grid Index Page:
Release Notes
0.10.0
- Bootstrap 4 visual refresh
- deprecated Bootstrap 3 support
0.9.19
- Wagtail 2.0 compatibility.
- Bugfix: a bad relation in
search_fieldsof GridIndexPage caused problems for Elastic Search.
Contributors
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
File details
Details for the file wagtailgridder-0.10.1.tar.gz.
File metadata
- Download URL: wagtailgridder-0.10.1.tar.gz
- Upload date:
- Size: 796.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.6.2 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/3.6.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 3b6ea776f240e273a0c1e0caa2603a45cc31fa899542fbfe7f4fbb9057b9b056 |
|
| MD5 | f0877ed04adfa44eef1b0b5dd2725a0f |
|
| BLAKE2b-256 | e2508194f84118932845ee030a5b3cb0dd8ca03a76a5a45a20ceb68b8c82a7ef |
