Meeting Guide compatible Python package for Django's Wagtail CMS: meetings, locations, and API.
Project description
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, andwagtailgeowidgetto yourINSTALLED_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
Regionsand enter your regions; regions can have a parent, so you can nest them. For example, you could havePhiladelphia Countyas a region with no parent, andCenter Cityas a sub-region withPhiladelphia Countyas 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/)
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
Built Distribution
File details
Details for the file wagtail-meeting_guide-0.2.0.tar.gz.
File metadata
- Download URL: wagtail-meeting_guide-0.2.0.tar.gz
- Upload date:
- Size: 322.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/3.6.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 0e915fdba0d6effb402a184a505f446cfa54e76d65d90796d1f460bc4c261380 |
|
| MD5 | 1743ad0561f4ae5693fde093b20a0ba5 |
|
| BLAKE2b-256 | 886e56b90e43664550ad6ddfde7d23f4478be12d9a2d110084d8a7b314c8a361 |
Provenance
File details
Details for the file wagtail_meeting_guide-0.2.0-py3-none-any.whl.
File metadata
- Download URL: wagtail_meeting_guide-0.2.0-py3-none-any.whl
- Upload date:
- Size: 333.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/3.6.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 7988f8072ca5ce22b9aa4f6b7f6a26b9c8cee2a1efce74bf5fb7d41a8697d91c |
|
| MD5 | abc29529ff6a867f68cea16ed2febe80 |
|
| BLAKE2b-256 | fcc90472a72cf22a777e069f73464f325a37efb9aba6403bc4f7b20f4d6db35f |
