A lightweight, responsive, open source event calendar for use with Ministry Platform databases.

Features:

• Ministry Platform API integration and event synchronization
• Progressive Web App (PWA) compatibility
• Offline caching
• Custom dark and light themes
• ICS hosting -- /api/ics
• ICS calendar invites
• Admin portal for creating custom themes and enabling features -- /admin

Experimental Features:

• Weekly statistics email
• Stats -- use stats(); in browser dev console
• Debug log -- use debug(); in browser dev console

A running example: events.afumc.org

docker build -t mp-events https://github.com/austinginn/mp-events.git
nano .env

See .env section for creating your environment variables.

docker run --env-file ./.env -p 3000:3000 -d --name mp-events mp-events

On a server with node installed:

git clone https://github.com/austinginn/mp-events.git
cd mp-events
git checkout stable
npm install
nano .env

See .env section for creating your environment variables. Once environment variables are configured:

npm start

Create a .env file:

nano .env

Modify it with the following variables:

Your final .env file should look something like this:

CLIENT_ID=client
CLIENT_SECRET=averysecuresecret
ROOT=example
EMAIL_HOST=office.smtp.com
EMAIL_PORT=443
EMAIL_SECURE=false
[email protected]
EMAIL_SECRET=noreplypassword
PORTAL_SECRET=averysecurepassword
UPDATE_SECRET=averysecuresecretforwebhook
[email protected]

*This file contains sensitive information. DO NOT push to a public repository.

With MP admin credentials navigate to your Ministry Platform page - example.ministryplatform.com/ministryplatform.

• Administration -> API Clients -> New
• Fill out the following fields
  • Display Name: MP Events
  • Client ID: mpevents
  • Client Secret: come up with something secure
  • Client User: apiuser
  • Authentication Flow: Client Credentials

• Administration -> Webhooks -> New
• Fill out the following fields
  • Name: MP-Events Webhook
  • HTTP Method: Post
  • URI: your mp-events public domain/api/update -- https://events.example.com/api/update
  • Body Template: { "auth": "come up with something secure" } -- this should match .env UPDATE_SECRET from env section
  • Headers Template: Content-Type: application/json
  • Table Name: Events

There are many things outside of the scope of this document that need to be configured to make your MP-Events Calendar public. We use Digital Ocean at Alpharetta Methodist. You can support this project and get $100 in credits to host your own by creating an account using this link:

Here are some helpful resources from Digital Ocean:

• Nodejs Digital Ocean Droplet
• DNS and subdomains
• HTTPS and SSL Certs

Created and maintained by Austin Ginn for Alpharetta Methodist

• Icons by fontawesome