This repository contains the source code for the default WordPress TwentySeventeen child theme used on the NA Western Cape website. It contains custom changes to the 12 Step Meeting List plugin that allows the site to manage a series of meetings that the plugin currently does not support.

This theme customises the 12 Step Meeting List plugin by allowing you to create:

• Online Only meetings
• Hybrid (in-person and online) meetings
• In-Person Only meetings

These meeting types are available when you create or edit a meeting in the WordPress admin area.

With the changes to the plugin this theme also contains various CSS changes that affect the way meetings are displayed in the listing view as well as on the detail page.

On the page where meetings are listed (i.e. /meetings/) the theme will now visually indicate a few new things.

• Online and Hybrid meeting types are now visually indicated by displaying a:
  • Green visual indicator for Online Only meetings.
  • Orange visual indicator for Hybrid meetings.
• For Online Only meetings the address will be removed completely from the listing so only Hybrid or In-Person meetings will show their address fields.

When viewing a meeting's detail (information) page the theme will now:

• Show the type of meeting (either Online or Hybrid) next to the meeting list name.
• Address details for a meeting are crossed out for Online Only meetings as a visual cue to people that the venue is not open.
• Within the Meeting Information box the meeting type is also indicated with a tick next to it to make it clear to people what type of meeting they are viewing.

Your WordPress website must be based on the TwentySeventeen theme for this theme to work. This is a child theme of TwentySeventeen so it won't work unless your website is based off this.

If you do not use the TwentySeventeen theme for your site, you can manually pull the changes from this repository into your own theme. See the Manual Implementation section below.

To install this theme download the latest nawc.zip WordPress zip file (or by clicking here) and go to your WordPress Themes page (i.e. /wp-admin/themes.php) and upload the zip file here. Once uploaded you will need to activate the theme for the new theme to take effect.

With the theme installed (or the manual implementation below) you will now have three new options when creating or editing a meeting in your WordPress admin area. Go to your Meeting list plugin admin area at /wp-admin/edit.php?post_type=tsml_meeting and either click Add New or click on an existing meeting to change it's meeting type.

Please read the following documentation for adding or editing a meeting based on the type of meeting you would like to display:

1. Online Only Meetings
2. Hybrid Meetings (in-person and online)
3. In-Person Only Meetings

For non-twentyseventeen users this section is for you. To implement these changes you need to copy the code from functions.php as well as the CSS styles contained in style.css.

Open up your theme's functions.php file and paste the following code anywhere within it:

/**
 * Meeting List changes to include new meeting types.
 */
if (function_exists('tsml_custom_types')) {
    tsml_custom_types([
        'HYB' => 'Online & In-Person',
        'IPO' => 'In-Person',
    ]);
}

There is quite a bit of css you will need to copy and paste into your own theme and in order to get the right bit make sure you copy these lines of code from the style.css (it should be lines 52 through to 147).

If you want to build this theme you need to install the packages with:

$ yarn install

All releases are deployed using grunt and the Gruntfile.js contains all the deployment configuration details. The Grunt file will update version numbers and create a detailed CHANGELOG of changes from the previous version. All CHANGELOG files are contained in the /docs/tags/ folder. The Gruntfile also has a command to create a zip file of the theme that can be uploaded to the server.

Executing one of the commands below will create a new version of the theme and:

• Bump the version number
• Create a new CHANGELOG file in /docs/tags/
• Create a new zip file of the theme in /dist/
• Publish the version to GitHub

$ npx grunt patch # will upgrade from 0.0.1 -> 0.0.2
$ npx grunt minor # will upgrade from 0.0.1 -> 0.1.0
$ npx grunt major # will upgrade from 0.0.1 -> 1.0.0

This software is release under the MIT License. See the LICENSE file for more details.

For detailed changelogs please go to the /docs/tags/ directory.