Skip to main content

KDL Wagtail Base Models

Project description

https://badge.fury.io/py/django-kdl-wagtail.svg https://travis-ci.org/kingsdigitallab/django-kdl-wagtail.svg?branch=master https://codecov.io/gh/kingsdigitallab/django-kdl-wagtail/branch/master/graph/badge.svg

KDL Wagtail Base Models

Documentation

The full documentation is at https://django-kdl-wagtail.readthedocs.io.

Quickstart

Install Django KDL Wagtail:

pip install django-kdl-wagtail

Add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'wagtail.contrib.settings',
    ...
    'kdl_wagtail.core',
    'kdl_wagtail.people',
    ...
)

Features

  • A Core Wagtail application, kdl_wagtail.core with:
    • An abstract BasePage that contains and introduction and image fields, which all the other class in this package extend

    • A RichTextPage with just a RichTextField (WYSIWYG)

    • A StreamPage with a StreamField body

    • An abstract BaseIndexPage, with functions to return the page’s live children, context, and a function to paginate the children

    • An IndexPage

    • A set of reusable StreamField blocks

    • Simple default templates for the pages and blocks defined in the module

  • A public API based on Wagtail’s API https://docs.wagtail.io/en/latest/advanced_topics/api/v2/configuration.html

  • People application, kdl_wagtail_people with:
    • A Person snippet, this is accessible from the Wagtail menu bar

    • A PersonPage

    • A PeopleIndexPage

  • Zotero application, kdl_wagtail_zotero:
    • A Bibliography model to store entried harvested from a Zotero collection

    • A management command, zotero_import, to import entries from a Zotero collection

    • A BibliographyIndexPage, to display all the bibliography entries

    • The Zotero based Bibliography is available from the Wagtail menu bar

  • Custom settings
    • Footer customisation

    • Analytics integration

  • ProxyPage: a new page type to support shortcuts and external links in menus

TODO

  • generic front end search page (with filters for tags, page types, …)

  • generic/abstract wagtail form page
    • contact us page (could possibly inherit from wagtail form page)

  • FAQ page

Running Tests

Does the code actually work?

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install tox
(myenv) $ tox

Credits

Tools used in rendering this package:

History

0.10 (2021-10-08)

  • ProxyPage: a new page type to support shortcuts and external links in menus

0.9.0 (2020-01-23)

  • Integration with Zotero

  • Base search

0.5.0 (2019-02-05)

  • Wagtail settings for footer text and analytics settings

  • kdl_wagtail_core utils:
    • paginate

  • kdl_wagtail_core template tags:
    • get_page_children

    • get_analytics_id

0.1.0 (2019-01-22)

  • First release on PyPI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-kdl-wagtail-0.10.2.tar.gz (33.6 kB view hashes)

Uploaded source

Built Distribution

django_kdl_wagtail-0.10.2-py2.py3-none-any.whl (72.9 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page