12 Step Meeting List

Description

This plugin helps twelve step recovery programs list their meetings. It standardizes addresses, and displays results in a searchable list and map.

It’s also the easiest way for AA service entities to get listed in the Meeting Guide mobile app for iOS and Android devices.

This plugin was originally designed to maintain a list of AA meetings in Santa Clara County, CA. It’s now in use in the following areas:

Alcoholics Anonymous

  1. Albuquerque, NM
  2. Alexandria, LA
  3. Arkansas
  4. Aspen, CO
  5. Asheville, NC
  6. Atlantic City, NJ
  7. Austin, TX
  8. Baltimore, MD
  9. Barrington, IL
  10. Batavia, IL
  11. Baton Rouge, LA
  12. Bethlehem, PA
  13. Boston, MA
  14. Boulder, CO
  15. Bowling Green, KY
  16. Brainerd, MN
  17. Breckenridge, CO
  18. Burlington, NC
  19. Cancún, Mexico
  20. Charleston, SC
  21. Charleston, WV
  22. Charlotte, NC
  23. Chicago, IL
  24. Chico, CA
  25. Cincinnati, OH
  26. Clarksburg, WV
  27. Continental Europe
  28. Colorado Springs, CO
  29. Columbus, OH
  30. Connecticut
  31. Corpus Christi, TX
  32. Dallas, TX
  33. Davenport, IA
  34. Davis, CA
  35. Dayton, OH
  36. Daytona, FL
  37. DuPage County, IL
  38. East Bay, CA
  39. East Hawaii
  40. East Tennessee
  41. Eastern Washington
  42. Edinburgh, UK
  43. Elk Grove Village, IL
  44. Elgin, IL
  45. Fargo, ND
  46. Flagler County, FL
  47. Four Corners, NM AZ UT CO
  48. Fredericksburg, VA
  49. Fresno, CA
  50. Ft. Worth, TX
  51. Gettysburg, PA
  52. Gloucester, VA
  53. Greensboro, NC
  54. Greenville, SC
  55. Hagerstown, MD
  56. Harrisburg, IL
  57. Harrisburg, PA
  58. Hernando County, FL
  59. Houston, TX
  60. Huntsville, AL
  61. Idaho
  62. Inland Empire, CA
  63. Iowa
  64. Israel
  65. Jacksonville, FL
  66. Jacksonville, IL
  67. Joliet, IL
  68. Kansas
  69. Kansas City
  70. Kauai, HI
  71. Kentucky
  72. Krakow, Poland
  73. Lafayette, LA
  74. Lakeland, FL
  75. Lancaster, PA
  76. Langley, Canada
  77. Lawrence, KS
  78. Lebanon, PA
  79. Lee County, FL
  80. Leesburg, FL
  81. Lewis County, WA
  82. Long Beach, CA
  83. Los Angeles, CA
  84. Marblehead, MA
  85. Madison, WI
  86. Maine and New Brunswick
  87. Mansfield, OH
  88. Martin County, FL
  89. Maui, HI
  90. Medford, OR
  91. Memphis, TN
  92. Mercer County, PA
  93. Mesa, AZ
  94. Miami, FL
  95. Midlands, UK (Polish)
  96. Minneapolis, MN
  97. Minnesota
  98. Mississippi
  99. Modesto, CA
  100. Monroe, LA
  101. Monterey, CA
  102. Montreal, Canada
  103. Moore County, NC
  104. Morganton, NC
  105. Myrtle Beach, SC
  106. Napa, CA
  107. Naples, FL District 20
  108. Naples, FL Intergroup
  109. Nassau County, NY
  110. New Hampshire
  111. New Orleans, LA
  112. New Mexico
  113. New York, NY
  114. North Central Washington
  115. North Coast, LA
  116. North County San Diego, CA
  117. North Dakota
  118. North Idaho
  119. North Port, FL
  120. Northeastern New York
  121. Northern Indiana
  122. Northern Nevada
  123. Oahu, HI
  124. Ogden, UT
  125. Oklahoma
  126. Oklahoma City, OK
  127. Olean, NY
  128. Orlando, FL
  129. Oshawa, Canada
  130. Palm Beach County, FL
  131. Palm Springs, CA
  132. Paris, France
  133. Pensacola, FL
  134. Philadelphia, PA
  135. Placerville, CA
  136. Portland, OR
  137. Québec, Canada (All)
  138. Québec, Canada (Région 87, Southwest)
  139. Québec, Canada (Région 88, Southeast)
  140. Racine, WI
  141. Reading, PA
  142. Redmond, OR
  143. Regina, Canada
  144. Rhode Island
  145. Roanoke, VA
  146. Rochester, MN
  147. Rochester, NY
  148. Rockland County, NY
  149. Romania
  150. Sacramento, CA
  151. Salinas, CA
  152. San Francisco, CA
  153. San Luis Obispo, CA
  154. San Jose, CA
  155. San Mateo, CA
  156. Santa Barbara, CA
  157. Santa Fe, NM
  158. Savannah, GA
  159. Seattle, WA
  160. Secular AA
  161. Shreveport, LA
  162. Slovenia
  163. Snohomish County, WA
  164. Sonoma County, CA
  165. South Lexington, KY
  166. South Roxana, IL
  167. Southeastern Indiana
  168. Southern Colorado
  169. Southern Illinois
  170. Southern New Jersey
  171. Southwestern Missouri
  172. Spokane, WA
  173. Springfield, IL
  174. St. Louis, MO
  175. St. Lucie, FL
  176. St. Peters, MO
  177. State College, PA
  178. Staten Island, NY
  179. Streamwood, IL
  180. Syracuse, NY
  181. Tampa, FL
  182. Tidewater Area, VA
  183. Tokyo, Japan
  184. Toronto, Canada
  185. Tri Valley, CA
  186. Topeka, KS
  187. Traverse City, MI
  188. Tulare County, CA
  189. Tulsa, OK
  190. Vacaville, CA
  191. Vancouver, Canada
  192. Ventura County, CA
  193. Victoria, BC, Canada
  194. Vienna, Austria
  195. Virginia
  196. Virginia Peninsula
  197. Waco, TX
  198. Walnut Creek, CA
  199. Warsaw, IN
  200. Washington, DC
  201. Wenatchee, WA
  202. West Hawaii, HI
  203. West-Central Wisconsin
  204. West Pasco, FL
  205. Western Colorado
  206. Western Kentucky
  207. Western Washington
  208. Wheaton, IL
  209. Wilmington, DE
  210. Woodstock, IL
  211. Zurich, Switzerland

Let us know if you’re using this plugin and would like to be listed here.

Notes

  • The Meeting Notes field is for any non-standardized meeting info, such as Basement, or Building C
  • Location should be a simple place-name, eg Queen of the Valley Hospital
  • Address should only be the address; no “Upstairs” or “Building C” or “Near 2nd Ave”
  • You can fill in a very basic address and then when you tab away from that field you will see it try to standardize the address for you. If you write “1000 trancas, napa” it will replace it with “1000 Trancas St, Napa, CA 94558, USA.”

Screenshots

  • Meeting list page
  • Meeting map
  • Meeting detail page
  • Edit meeting
  • Edit location

Installation

Basically you can just install it and you should be good to go. For a quick walkthrough of the process, check out this screencast video:

FAQ

My meeting type isn’t listed!

If it’s a broadly-applicable meeting type, please contact us so we can include it for you. We want to maintain consistency for the mobile apps, so not all proposals are included.

If you have access to your theme’s functions.php, you may add additional meeting types or rename existing ones. Simply adapt the following example to your purposes:

if (function_exists('tsml_custom_types')) {
    tsml_custom_types(array(
        'XYZ' => 'My Custom Type',
    ));
}

Please note a few things about custom types:

  1. Once you’ve added the type, you will see it under ‘More’ on the Meeting edit screen. It will show up in the dropdown once you use it on a meeting.
  2. Be careful with the codes (“XYZ” in the above example) as this gives you the ability to replace existing types.
  3. Note that custom meeting types are not imported into the Meeting Guide app.
  4. They are for searching. If you can’t imagine yourself searching for a meeting this way, then it’s probably not a type you need. Have you ever searched for a 90-minute meeting? If not, then it’s probably information that better belongs in the meeting notes.
  5. Don’t add a type for the default, eg ‘Hour Long Meeting’ or ‘Non-Smoking.’ If you do that, then you have to be careful about tagging every single meeting in order to make the data complete.
Where are my meetings listed?

It depends on your Permalinks setup. The easiest way to find the link is to go to the Dashboard > Meetings > Import & Settings page and look for it under “Where’s My Info?”

I need to correct a meeting address or change a pin’s location

We get our geocoding positions from Google (this true even if your maps are by Mapbox). Google is correct an amazing amount of the time, but not always. If you need to add a custom location, add this to your theme’s functions.php.

Note you can add multiple entries to the array below.

if (function_exists('tsml_custom_types')) {
    tsml_custom_addresses(array(
        '5 Avenue Anatole France, 75007 Paris, France' => array(
            'formatted_address' => '5 Avenue Anatole France, 75007 Paris, France',
            'city' => 'Paris',
            'latitude' => 48.858372,
            'longitude' => 2.294481,
        ),
    ));
}
How can I make the Region dropdown not be collapsible?

No problem, just add this CSS to your theme:

div#tsml #meetings .controls ul.dropdown-menu div.expand { display: none; }
div#tsml #meetings .controls ul.dropdown-menu ul.children { height: auto; }
How can I show Any Day by default?

The easiest way is to link to that view straight from your navigation. Usually that looks like /meetings/?tsml-day=any, but it can vary depending on your settings.

If you’d prefer to keep the default address, you could add this code to your theme’s functions.php instead:

$tsml_defaults['day'] = null;
How do I change the default search radius for location searches?

Add this to your theme’s functions.php. The value should be an existing value, ie 1, 5, 10, 25 or 50.

$tsml_defaults['distance'] = 25;
Can I get the meeting list to display the full address, including city, state and country?

Add this to your theme’s functions.php.

$tsml_street_only = false;
Can I change the order of the columns on the meeting list page, eg put the Region first?

Add this to your theme’s functions.php. Feel free to change the order or column names (eg ‘Region’) but keep the keys the same (eg ‘region’).

$tsml_columns = array(
    'region' => 'Region',
    'time' => 'Time',
    'distance' => 'Distance',
    'name' => 'Name',
    'location' => 'Location',
    'address' => 'Address',
    'types' => 'Types'
);
Can I change the default sort order on the meeting list page?

By default, the plugin sorts by day, then time, then location name. To set your own sort index, add this to your functions.php:

$tsml_sort_order = 'region'; //options are name, location, address, time, or region
How can I override the meeting list or detail pages?

Copy the files from the plugin’s templates directory into your theme’s root directory. If you’re using a theme from the Theme Directory, you may be better off creating a Child Theme. Now, you may override those pages. The archive-meetings.php file controls the meeting list page, single-meetings.php controls the meetings detail, and single-locations.php controls the location detail.

Please note these pages will evolve over time. If you override, you will someday experience website errors after an update. If that happens, please update your theme’s copy of the plugin pages.

Can I see types in the meeting list? And can I adjust the /Men and /Women after the meeting name?

To see types in the meeting list, one way to do it is to add some CSS to your theme which will make a types column visible.

@media screen and (min-width: 768px) {
    div#tsml #meetings .types { display: table-cell !important; }
}

One drawback of this approach is that it shows all the meeting types, and you might not want all of them to be displayed over and over in the meeting list.

Another approach is to adjust which meeting types are “flagged” in the meeting names, by default for most programs this is /Men and /Women. To adjust this, find the meeting type code for each type you want to show and include it in your theme’s functions.php like this:

if (function_exists('tsml_custom_flags')) {
    tsml_custom_flags(array('M', 'W', 'O', 'C'));
}

The code above will add “Open” and “Closed” flags to the meeting name.

When there are notes on a meeting, can I indicate that somehow in the meeting list?

Yes, with CSS. Rows that have meeting notes will have a ‘notes’ class. To add an asterisk, for example, try this:

div#tsml tr.notes a:after { content: "*"; }
Can I import a custom spreadsheet format?

If you don’t mind some PHP programming, then yes! Create a function called tsml_import_reformat, and use it to
reformat your incoming data to the standard format

if (!function_exists('tsml_import_reformat')) {
    function tsml_import_reformat($meetings) {
        //your code goes here
        return $meetings;
    }
}
How can I change some of the text on the template pages, eg the column headings?

You can make use of the gettext filter to override the plugin’s translation strings. For example, if you wanted to replace ‘Region’ with ‘City,’ you could add the following to your functions.php file.

function theme_override_tsml_strings($translated_text, $text, $domain) {
    if ($domain == '12-step-meeting-list') {
        switch ($translated_text) {
            case 'Region':
                return 'City';
        }
    }
    return $translated_text;
}
add_filter('gettext', 'theme_override_tsml_strings', 20, 3);
How can I temporarily hide a meeting without deleting it?

Save it as a draft by editing the meeting’s Status.

Are there shortcodes?

Yes, you can use [tsml_meeting_count], [tsml_location_count], [tsml_group_count], and [tsml_region_count] to display human-formatted counts of your entities. For example, “Our area currently comprises [tsml_meeting_count] meetings.” Also [tsml_next_meetings count="5"] displays a small table with the next several meetings in it. Use the count parameter to adjust how many are displayed. This will be unstyled if you’re not using bootstrap in your theme.

Additionally, you can use [tsml_types_list] and [tsml_regions_list] to output linked lists to your meeting finder.

Are there translations to other languages?

It is translated into Polish. If you would like to volunteer to help translate another language, we would be pleased to work with you.

I entered contact information into the meeting edit page but don’t see it displayed on the site.

That’s right, we don’t display that information by default for the sake of anonymity. To display it in your theme, go to Import & Settings and set the Meeting/Group Contacts dropdown to “public.”

Can I run this as my main website homepage?

Sure. Try adding this code to your theme’s functions.php:

add_action('pre_get_posts', 'tsml_front_page');

Also check out our One Page Meeting List theme.

Can I use this plugin to list telephone meetings or other meetings without a fixed location?

No, there’s not a good way to do this at this time. All meetings currently need to have a geographic location.

Some sites have used a general geographic area, such as a city name, but this isn’t a very good solution, because a map
pin will still show up for these meetings and people will try to get directions to them.

Can I change the URL of the meetings list?

Yes, try setting the $tsml_slug variable in your functions.php.

$tsml_slug = 'schedule';

To apply these changes, you must go to Settings > Permalinks and click “Save Changes”

Reviews

December 6, 2018
This is a very well thought out plugin and has saved me a lot of time and stress, our website and custom mobile app run on the data provided by the plugin. The plugin support is always very fast and helpful. Keep up the excellent work.
April 22, 2018
Saved me a lot of time trying to come up with a solution that probably would not have done the job nearly as well. Nothing but positive comments from my users; that is all you can ask for.
September 1, 2017
It's not quite perfect, but striving for perfection and constantly making progress. This is THE meeting plugin. It's been a huge time saver for Area 25 Kansas and possibly a life saver. Keep up the great work!
Read all 19 reviews

Contributors & Developers

“12 Step Meeting List” is open source software. The following people have contributed to this plugin.

Contributors

“12 Step Meeting List” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “12 Step Meeting List” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

3.4.15

  • Fixing PDF error (Ft Worth)

3.4.14

  • Geocode (Western MA, Traverse City)

3.4.13

  • Hiding PHP notices for empty locations (Ft Worth)

3.4.12

  • Fixing javascript bug when meeting has no types

3.4.11

  • Fixing meeting types bug introduced in earlier commit

3.4.10

  • Bugfixes relating to meeting type “flag” customization (Akron)

3.4.9

  • PHP 5.2 compatibility (Hanover PA)

3.4.8

  • Geocodes (Bolivia)

3.4.7

  • Fixing night time filter

3.4.6

  • Fixing error message in upcoming meetings widget (Inland Empire)
  • Including slug in export CSV (Northern IL)
  • Update cache when deleting meetings (Southern IL)
  • Removing mention of non-AA programs from readme (San Diego)
  • Fixing code formatting in FAQ

3.4.5

  • Importing fix

3.4.4

  • Syntax error on PHP < 5.4 (Palm Springs)
  • FNV Import Location Field (Minnesota)
  • District filtering working again

3.4.3

  • Fixing filter for parent regions (PA Al Anon)
  • Adding ‘delete all’ AJAX route
  • Fixing JSON Import (San Francisco)

3.4.2

  • Adding Non-Binary meeting type (Los Angeles)
  • Geocodes (Western Mass)

3.4.1

  • 3.4 was missing a file 🙁

3.4

  • Major rewrite to make plugin more CPU-efficient (Ventura)
  • Fixed bug where leaving a space at the end of a data source would cause an error
  • Fixed bug where filters wouldn’t work after switching to Google Map view (SCA)
  • Added post_status to params for tsml_get_meetings() (New England SLAA)
  • Some new geocode overrides