17 |
--------------------------------------------------------------------------------
/meeting_guide/templates/wagtailadmin/pages/listing/_page_title_move_AFTER_WAGTAIL_PR_IN_CODERED.html:
--------------------------------------------------------------------------------
1 | {% extends "wagtailadmin/pages/listing/_page_title_move.html" %}
2 |
3 | {% block pages_listing_link_title_extra %}{% if page.specific.formatted_address %} ({{ page.specific.formatted_address }}){% endif %}{% endblock pages_listing_link_title_extra %}
4 | {% block pages_listing_title_extra %}{% if page.specific.formatted_address %} ({{ page.specific.formatted_address }}){% endif %}{% endblock pages_listing_title_extra %}
5 |
--------------------------------------------------------------------------------
/meeting_guide/templatetags/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/code4recovery/wagtail-meeting-guide/7d9e9a472ea7efd178e60789c72f5e8a8995094a/meeting_guide/templatetags/__init__.py
--------------------------------------------------------------------------------
/meeting_guide/templatetags/meeting_guide.py:
--------------------------------------------------------------------------------
1 | from json import dumps as json_dumps
2 |
3 | from django import template
4 |
5 | from meeting_guide.settings import get_meeting_guide_settings
6 |
7 | register = template.Library()
8 |
9 |
10 | @register.inclusion_tag("meeting_guide/tags/meeting_guide.html", takes_context=True)
11 | def meeting_guide(context):
12 | """
13 | Display the ReactJS drive Meeting Guide list.
14 | """
15 | settings = get_meeting_guide_settings()
16 | json_meeting_guide_settings = json_dumps(settings)
17 | return {
18 | "meeting_guide_settings": json_meeting_guide_settings,
19 | "mapbox_key": settings["map"]["key"],
20 | "timezone": settings["timezone"],
21 | }
22 |
--------------------------------------------------------------------------------
/meeting_guide/urls.py:
--------------------------------------------------------------------------------
1 | from django.urls import path
2 |
3 | from .views import MeetingsHomeView, MeetingsAPIView
4 |
5 | app_name = "meeting-guide"
6 |
7 | urlpatterns = [
8 | path("", MeetingsHomeView.as_view(), name="home"),
9 | path("api/", MeetingsAPIView.as_view(), name="api"),
10 | ]
11 |
--------------------------------------------------------------------------------
/meeting_guide/utils.py:
--------------------------------------------------------------------------------
1 | import json
2 | import os
3 | import re
4 | import requests
5 |
6 | from django.core.files import File
7 | from django.conf import settings
8 |
9 | from meeting_guide.models import Region
10 |
11 |
12 | def get_geocode_address(full_address):
13 | """
14 | Given a full address, get the Google address information. Use a local cache.
15 |
16 | Returns `None` if Google doesn't return an address.
17 | """
18 |
19 | address_components = {}
20 | address_components["problem"] = "OK"
21 |
22 | cache_filename = (
23 | "meeting_guide_cache/"
24 | + re.sub("[^0-9a-zA-Z]+", "", full_address.lower().lstrip(" "))
25 | + ".json"
26 | )
27 |
28 | address_components["cache_status"] = "MISS"
29 |
30 | if os.path.isfile(cache_filename):
31 | # grab the json from the cache
32 | with open(cache_filename, "r") as f:
33 | django_file = File(f)
34 | cached_json = django_file.read()
35 |
36 | try:
37 | # JSON is valid
38 | address_data = json.loads(cached_json)
39 | address_components["cache_status"] = "HIT"
40 | except json.JSONDecodeError:
41 | # Invalid JSON, delete the file, get on next run
42 | os.remove(cache_filename)
43 | address_components["cache_status"] = "INVALID"
44 |
45 | if address_components["cache_status"] != "HIT":
46 | payload = {
47 | "bounds": settings.GOOGLE_MAPS_API_BOUNDS,
48 | "key": settings.GOOGLE_MAPS_V3_APIKEY,
49 | "address": full_address.lstrip(" ").replace("'", ""),
50 | }
51 | # payload = {'key': API_KEY, 'address': full_address.lstrip(' ')}
52 | api_request_url = "https://maps.googleapis.com/maps/api/geocode/json"
53 |
54 | # Send the request to Google Maps
55 | r = requests.get(api_request_url, params=payload)
56 | address_data = r.json()
57 |
58 | # Write cache file if status == OK
59 | if address_data["status"] == "OK":
60 | with open(cache_filename, "w") as f:
61 | django_file = File(f)
62 | json.dump(address_data, django_file, indent=4, separators=(",", ": "))
63 |
64 | # We have the data in 'address_data', let's do something with
65 | # each address and the associated meeting information.
66 | # Test to see if LOCATION address exists. If so, return the id from MySQL
67 | if address_data["status"] == "ZERO_RESULTS":
68 | address_components[
69 | "problem"
70 | ] = 'Google returned "ZERO_RESULTS" for address {0}:\n{1}\n\n.'.format(
71 | full_address, address_components
72 | )
73 | elif address_data["status"] == "OVER_QUERY_LIMIT":
74 | address_components[
75 | "problem"
76 | ] = 'Google returned "OVER_QUERY_LIMIT"; have we hit the API too much?'
77 | else:
78 | address_components["formatted_address"] = address_data["results"][0][
79 | "formatted_address"
80 | ]
81 |
82 | for address_component in address_data["results"][0]["address_components"]:
83 | for address_component_type in address_component["types"]:
84 | address_components[address_component_type] = address_component[
85 | "short_name"
86 | ]
87 |
88 | address_components["lat"] = address_data["results"][0]["geometry"]["location"][
89 | "lat"
90 | ]
91 | address_components["lng"] = address_data["results"][0]["geometry"]["location"][
92 | "lng"
93 | ]
94 |
95 | if (
96 | "street_number" not in address_components
97 | or "route" not in address_components
98 | ):
99 | address_components[
100 | "problem"
101 | ] = 'Google did not return "street_number" or "route" for address {0}:\n{1}\n\n.'.format(
102 | full_address, address_components
103 | )
104 | else:
105 | address_components["full_address"] = (
106 | address_components["street_number"] + " " + address_components["route"]
107 | )
108 |
109 | #
110 | # This address is missing an administrative_area_level_2 reported here:
111 | # https://code.google.com/p/gmaps-api-issues/issues/detail?id=11492&thanks=11492&ts=1487542697
112 | #
113 | if "administrative_area_level_2" in address_components:
114 | address_components["region"] = address_components[
115 | "administrative_area_level_2"
116 | ]
117 | else:
118 | address_components[
119 | "problem"
120 | ] = 'Google did not return "administrative_area_level_2" (county / parish) for address {0}:\n{1}\n\n.'.format(
121 | full_address, address_components
122 | )
123 | address_components["region"] = ""
124 |
125 | # Subregion: most granular to least granular
126 | if "neighborhood" in address_components:
127 | address_components["subregion"] = address_components["neighborhood"]
128 | elif "sublocality" in address_components:
129 | address_components["subregion"] = address_components["sublocality"]
130 | elif "locality" in address_components:
131 | address_components["subregion"] = address_components["locality"]
132 | elif "administrative_area_level_3" in address_components:
133 | address_components["subregion"] = address_components[
134 | "administrative_area_level_3"
135 | ]
136 | elif "city" in address_components:
137 | address_components["subregion"] = address_components["city"]
138 | else:
139 | address_components["subregion"] = ""
140 | address_components[
141 | "problem"
142 | ] = 'Google did not return "neighborhood", "locality", "sublocality", "city", or "administrative_area_level_3" for subregion field for address {0}:\n{1}\n\n.'.format(
143 | full_address, address_components
144 | )
145 |
146 | # City: least granular below the county level
147 | if "city" in address_components:
148 | address_components["city"] = address_components["city"]
149 | elif "administrative_area_level_3" in address_components:
150 | address_components["city"] = address_components[
151 | "administrative_area_level_3"
152 | ]
153 | elif "locality" in address_components:
154 | address_components["city"] = address_components["locality"]
155 | elif "sublocality" in address_components:
156 | address_components["city"] = address_components["sublocality"]
157 | elif "neighborhood" in address_components:
158 | address_components["city"] = address_components["neighborhood"]
159 | else:
160 | address_components["city"] = ""
161 | address_components[
162 | "problem"
163 | ] = 'Google did not return "neighborhood", "locality", "city", or "administrative_area_level_3" for city field for address {0}:\n{1}\n\n.'.format(
164 | full_address, address_components
165 | )
166 |
167 | return address_components
168 |
169 |
170 | def build_tree(regions):
171 | """ Build up our regions recursively """
172 | items = []
173 | for r in regions:
174 | item = {"label": r.name, "value": r.id, "children": []}
175 |
176 | if r.children.count():
177 | item["children"] = build_tree(r.children.all())
178 |
179 | items.append(item)
180 |
181 | return items
182 |
183 |
184 | def get_region_tree():
185 | """
186 | Generate deeply nested region data for use by react-dropdown-tree-select
187 | This returns a nested structure of lists and dicts of regions with their
188 | names, ids, and children.
189 | """
190 | top_regions = Region.objects.filter(parent__isnull=True).prefetch_related(
191 | "children"
192 | )
193 | return build_tree(top_regions)
194 |
--------------------------------------------------------------------------------
/meeting_guide/validators.py:
--------------------------------------------------------------------------------
1 | from django.core import validators
2 | from django.utils.deconstruct import deconstructible
3 | from django.utils.translation import gettext_lazy as _
4 |
5 |
6 | @deconstructible
7 | class CashAppUsernameValidator(validators.RegexValidator):
8 | """
9 | Validator for CashApp usernames (from Square).
10 | - Must start with "$"
11 | - Only ASCII alphanumeric characters, hyphens, and underscores are supported.
12 | """
13 | regex = r"^\$[a-zA-Z0-9_-]+$"
14 | message = _(
15 | "Enter a valid CashApp username. Must start with '$', and can contain "
16 | "letters, numbers, '-', and '_'."
17 | )
18 | flags = 0
19 |
20 |
21 | @deconstructible
22 | class ConferencePhoneValidator(validators.RegexValidator):
23 | """
24 | Only allow valid characters for conference phone numbers.
25 | - Only numeric, "+", ",", and "#" characters are allowed.
26 | """
27 | regex = r'^[0-9+,#]+$'
28 | message = _(
29 | "Enter a valid conference phone number. The three groups of numbers in this "
30 | "example are a Zoom phone number, meeting code, and password: "
31 | "+19294362866,,2151234215#,,#,,12341234#"
32 | )
33 | flags = 0
34 |
35 |
36 | @deconstructible
37 | class PayPalUsernameValidator(validators.RegexValidator):
38 | """
39 | Validator for PayPal usernames.
40 | - 8-16 characters
41 | - Only ASCII alphanumeric characters are supported.
42 | """
43 | regex = r'^[a-zA-Z0-9]+$'
44 | message = _(
45 | "Enter a valid PayPal username for https://paypal.me/. Only letters and "
46 | "numbers are valid."
47 | )
48 | flags = 0
49 |
50 |
51 | @deconstructible
52 | class VenmoUsernameValidator(validators.RegexValidator):
53 | """
54 | Validator for Venmo usernames.
55 | - Must start with "@"
56 | - Only ASCII alphanumeric characters, hyphens, and underscores are supported.
57 | """
58 | regex = r"^@[a-zA-Z0-9_-]+$"
59 | message = _(
60 | "Enter a valid Venmo username. Must start with '@', and can contain letters, "
61 | "numbers, '-', and '_'."
62 | )
63 | flags = 0
64 |
--------------------------------------------------------------------------------
/meeting_guide/views.py:
--------------------------------------------------------------------------------
1 | import datetime
2 | import json
3 | import re
4 |
5 | from django.conf import settings
6 | from django.http import HttpResponse
7 | from django.utils.decorators import method_decorator
8 | from django.views.decorators.cache import cache_page
9 | from django.views.decorators.gzip import gzip_page
10 | from django.views.generic import TemplateView
11 |
12 | from .models import Meeting, MeetingType, Region
13 | from .settings import get_meeting_guide_settings
14 |
15 |
16 | @method_decorator(
17 | cache_page(3600 * 24 * 7, key_prefix="wagtail_meeting_guide_api_cache"),
18 | name='dispatch',
19 | )
20 | class MeetingsBaseView(TemplateView):
21 | DAY_OF_WEEK = (
22 | (0, "Sunday"),
23 | (1, "Monday"),
24 | (2, "Tuesday"),
25 | (3, "Wednesday"),
26 | (4, "Thursday"),
27 | (5, "Friday"),
28 | (6, "Saturday"),
29 | )
30 |
31 | def get_meetings(self):
32 | return (
33 | Meeting.objects.live().filter(
34 | status=Meeting.ACTIVE,
35 | ).select_related("meeting_location", "group").prefetch_related(
36 | "meeting_location__region",
37 | # 'types', # ParentalManyToManyField instead of ManyToManyField causes Django to throw up on this
38 | ).order_by("day_of_week", "start_time")
39 | )
40 |
41 |
42 | class MeetingsHomeView(TemplateView):
43 | """
44 | List all meetings in the Meeting Guide ReactJS plugin.
45 | """
46 |
47 | template_name = "meeting_guide/meetings_home.html"
48 |
49 | def get_context_data(self, **kwargs):
50 | context = super().get_context_data(**kwargs)
51 | settings = get_meeting_guide_settings()
52 | context["settings"] = json.dumps(settings)
53 | context["mapbox_key"] = settings["map"]["key"]
54 | context["timezone"] = settings["timezone"]
55 |
56 | return context
57 |
58 |
59 | @method_decorator(gzip_page, name="dispatch")
60 | class MeetingsAPIView(MeetingsBaseView):
61 | """
62 | Return a JSON response of the meeting list.
63 | """
64 |
65 | def get(self, request, *args, **kwargs):
66 | meetings = self.get_meetings()
67 | meetings_dict = []
68 |
69 | # Eager load all regions to reference below.
70 | regions = Region.objects.all().prefetch_related("children")
71 |
72 | for meeting in meetings:
73 | meeting_types = list(
74 | meeting.types.values_list("spec_code", flat=True)
75 | )
76 |
77 | group_info = ""
78 | if len(meeting.district):
79 | location = f"{meeting.meeting_location.title} (D{meeting.district})"
80 | group_info = f"D{meeting.district}"
81 | else:
82 | location = meeting.meeting_location.title
83 |
84 | gso_number = getattr(meeting.group, "gso_number", None)
85 | if gso_number and len(gso_number):
86 | group_info += f" / GSO #{gso_number}"
87 |
88 | region_ancestors = list(
89 | regions.get(id=meeting.meeting_location.region.id)
90 | .get_ancestors(include_self=True)
91 | .values_list("name", flat=True)
92 | )
93 |
94 | notes = meeting.details
95 |
96 | meeting_dict = {
97 | "name": meeting.title,
98 | "slug": meeting.slug,
99 | "notes": notes,
100 | "updated": f"{meeting.last_published_at if meeting.last_published_at else datetime.datetime.now():%Y-%m-%d %H:%M:%S}",
101 | "url": f"{settings.BASE_URL}/meetings/?meeting={meeting.slug}",
102 | "day": meeting.day_of_week,
103 | "time": f"{meeting.start_time:%H:%M}",
104 | "end_time": f"{meeting.end_time:%H:%M}",
105 | "conference_url": meeting.conference_url,
106 | "conference_phone": meeting.conference_phone,
107 | "types": meeting_types,
108 | "location": location,
109 | "formatted_address": meeting.meeting_location.formatted_address,
110 | "latitude": meeting.meeting_location.lat,
111 | "longitude": meeting.meeting_location.lng,
112 | "regions": region_ancestors,
113 | "group": group_info,
114 | }
115 |
116 | if len(meeting.paypal):
117 | meeting_dict["paypal"] = meeting.paypal
118 |
119 | if len(meeting.venmo):
120 | meeting_dict["venmo"] = meeting.venmo
121 |
122 | if "feedback_url" in settings.MEETING_GUIDE:
123 | meeting_dict["feedback_url"] = settings.MEETING_GUIDE["feedback_url"]
124 |
125 | meetings_dict.append(meeting_dict)
126 |
127 | return HttpResponse(json.dumps(meetings_dict), content_type="application/json")
128 |
--------------------------------------------------------------------------------
/meeting_guide/wagtail_hooks.py:
--------------------------------------------------------------------------------
1 | from django.core.cache import cache
2 | from django_filters import ModelChoiceFilter
3 |
4 | from wagtail.admin.filters import WagtailFilterSet
5 | from wagtail.signals import page_published
6 | from wagtail.snippets.models import register_snippet
7 | from wagtail.snippets.views.snippets import SnippetViewSet, SnippetViewSetGroup
8 |
9 | from .models import Group, GroupContribution, MeetingType, Region, Location, Meeting
10 |
11 |
12 | def receiver(sender, **kwargs):
13 | """
14 | Clear the API cache whenever a Location or Meeting is published.
15 | """
16 | cache.delete("wagtail_meeting_guide_api_cache")
17 |
18 |
19 | # Register the signal receive for Location and Meeting publishes.
20 | page_published.connect(receiver, sender=Location)
21 | page_published.connect(receiver, sender=Meeting)
22 |
23 |
24 | class RegionFilter(WagtailFilterSet):
25 | parent = ModelChoiceFilter(
26 | queryset=Region.objects.filter(parent__isnull=True).order_by("name"),
27 | label='Select Region'
28 | )
29 |
30 | class Meta:
31 | model = Region
32 | fields = []
33 |
34 |
35 | class MeetingTypeAdmin(SnippetViewSet):
36 | model = MeetingType
37 | menu_label = "Meeting Types"
38 | menu_icon = "folder-open-1"
39 | add_to_settings_menu = True
40 | list_display = (
41 | "type_name",
42 | "intergroup_code",
43 | "spec_code",
44 | "display_order",
45 | )
46 | ordering = ("display_order", "type_name")
47 | search_fields = ("type_name",)
48 |
49 |
50 | class RegionAdmin(SnippetViewSet):
51 | model = Region
52 | menu_icon = "doc-full-inverse"
53 | empty_value_display = "-----"
54 | list_display = ("parent", "name")
55 | ordering = ("parent", "name")
56 | filterset_class = RegionFilter
57 |
58 |
59 | class GroupAdmin(SnippetViewSet):
60 | model = Group
61 | menu_label = "Groups"
62 | menu_icon = "folder-open-inverse"
63 | add_to_settings_menu = False
64 | list_display = ("name", "gso_number")
65 | search_fields = ("name",)
66 |
67 |
68 | class GroupContributionAdmin(SnippetViewSet):
69 | model = GroupContribution
70 | menu_label = "Contributions"
71 | menu_icon = "folder-open-inverse"
72 | add_to_settings_menu = False
73 | list_display = ("group", "date", "amount")
74 | list_filter = ("group",)
75 | search_fields = ("group",)
76 |
77 |
78 | class MeetingGuideAdminGroup(SnippetViewSetGroup):
79 | menu_label = "Meeting Guide"
80 | menu_icon = "calendar-alt"
81 | menu_order = 1000
82 | items = (MeetingTypeAdmin, RegionAdmin, GroupAdmin, GroupContributionAdmin)
83 |
84 |
85 | register_snippet(MeetingGuideAdminGroup)
86 |
--------------------------------------------------------------------------------
/setup.py:
--------------------------------------------------------------------------------
1 | from setuptools import setup, find_packages
2 |
3 | with open("README.md") as f:
4 | long_description = f.read()
5 |
6 | setup(
7 | name="wagtail-meeting_guide",
8 | description=(
9 | "Meeting Guide compatible Python package for Django's Wagtail CMS: meetings, "
10 | "locations, and API.",
11 | ),
12 | long_description=long_description,
13 | long_description_content_type="text/markdown",
14 | author="Tim Allen",
15 | author_email="flipper@peregrinesalon.com",
16 | url="https://github.com/meeting-guide/wagtail-meeting-guide",
17 | include_package_data=True,
18 | packages=find_packages(),
19 | zip_safe=False,
20 | setup_requires=["setuptools_scm"],
21 | use_scm_version=True,
22 | install_requires=[
23 | "wagtailgeowidget>6",
24 | "django-mptt",
25 | ],
26 | classifiers=[
27 | "Development Status :: 5 - Production/Stable",
28 | "Environment :: Web Environment",
29 | "Intended Audience :: Developers",
30 | "License :: OSI Approved :: BSD License",
31 | "Operating System :: OS Independent",
32 | "Programming Language :: Python :: 3",
33 | "Programming Language :: Python :: 3.7",
34 | "Programming Language :: Python :: 3.8",
35 | "Programming Language :: Python :: 3.9",
36 | "Programming Language :: Python :: 3.10",
37 | "Programming Language :: Python :: 3.11",
38 | "Programming Language :: Python :: 3 :: Only",
39 | "Framework :: Django",
40 | "Framework :: Django :: 2.0",
41 | "Framework :: Django :: 3.0",
42 | "Framework :: Wagtail",
43 | "Framework :: Wagtail :: 2",
44 | "Topic :: Internet :: WWW/HTTP",
45 | "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
46 | ],
47 | )
48 |
--------------------------------------------------------------------------------