Wagtail Meeting Guide

Meeting Guide compatible Python package for the Wagtail CMS on the Django web framework.

This is pre-alpha software, in active development!

Wagtail Meeting Guide requires both Wagtail 2.0 and Django 2.0.

Pre-Requisites

Using this package requires both the Wagtail CMS and Django. Wagtail and Django are fantastic for running your website, but require a developer. If you are new, I would recommend going through both the Django and Wagtail tutorials before trying to use this package.

A Google Geocode API key is also required.

Installation to Your Django Project

• Install with the command pip install wagtail-meeting-guide

• Add meeting_guide, mptt, and wagtailgeowidget to your INSTALLED_APPS.

• Add the following settings, including your Google Geocode API key:

• Run migrations: python manage.py migrate meeting_guide

• Load Meeting Guide's meeting types: python manage.py loaddata meeting_guide_types.json

Configuration

• Enter the Wagtail CMS, and go to Settings, Meeting Types.
• Enter your Intergroup's code for each of the Meeting Guide Code Types
• Go to Regions and enter your regions; regions can have a parent, so you can nest them. For example, you could have Philadelphia County as a region with no parent, and Center City as a sub-region with Philadelphia County as the parent.

Including the Meeting Guide in Your Django Template

The API end point for the locations and meetings you create in Wagtail has to be added to your site's root urls.py. Add a line like this:

urlpatterns = [
    ...
    path("meeting-guide/", include("meeting_guide.urls")),
    ...
]

You can include the Meeting Guide within any Django Template. Here is an example:

{% extends "base.html" %}

{% load meeting_guide %}

{% block content %}
    {% meeting_guide %}
{% endblock content %}

Downloading Meetings as a PDF

To download the meeting list as a PDF, you must have wkhtmltopdf installed on your system. The end point for the download is meeting-guide/download/.

You can change the print and style options in your Django settings. The options are a Python dictionary while the styles are a string containing CSS:

WAGTAIL_MEETING_GUIDE_PRINT_OPTIONS = {
    'page-width': '100mm',
    'page-height': '120mm',
    'margin-top': '10mm',
    'margin-right': '10mm',
    'margin-bottom': '10mm',
    'margin-left': '10mm',
    'header-left': '[section]: [subsection]',
    'encoding': "UTF-8",
    'no-outline': None
}

WAGTAIL_MEETING_GUIDE_PRINT_STYLES = """
html, td {
  font-family: Arial, Helvetica, sans-serif;
  font-size: 9px;
  -webkit-text-size-adjust:100%;
  -ms-text-size-adjust:100%;
  color: red;
}

body {
  margin:0;
}

h1, .h1 {
  font-size: 24px;
}
"""

Release Notes

0.1

Maintainer

• Timothy Allen (https://github.com/FlipperPA/)