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 to have your area’s meetings 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. Alexandria, LA
  2. Arkansas
  3. Austin, TX
  4. Batavia, IL
  5. Baton Rouge, LA
  6. Bethlehem, PA
  7. Bowling Green, KY
  8. Brainerd, MN
  9. Cancún, Mexico
  10. Charleston, WV
  11. Charlotte, NC
  12. Cincinnati, OH
  13. Continental Europe
  14. Colorado Springs, CO
  15. Corpus Christi, TX
  16. Davis, CA
  17. Dayton, OH
  18. Daytona, FL
  19. DuPage County, IL
  20. East Bay, CA
  21. East Tennessee
  22. Elk Grove Village, IL
  23. Elgin, IL
  24. Fargo, ND
  25. Fresno, CA
  26. Ft. Worth, TX
  27. Greensboro, NC
  28. Harrisburg, PA
  29. Hernando County, FL
  30. Inland Empire, CA
  31. Joliet, IL
  32. Kansas
  33. Kentucky
  34. Lakeland, FL
  35. Lancaster, PA
  36. Langley, Canada
  37. Lewis County, WA
  38. Long Beach, CA
  39. Madison, WI
  40. Maine and New Brunswick
  41. Maui, HI
  42. Mercer County, PA
  43. Mesa, AZ
  44. Miami, FL
  45. Midlands, UK (Polish)
  46. Minneapolis, MN
  47. Minnesota
  48. Mississippi
  49. Modesto, CA
  50. Monterey, CA
  51. Montreal, Canada
  52. Napa, CA
  53. Naples, FL
  54. New Hampshire
  55. New Orleans, LA
  56. New Mexico
  57. New York, NY
  58. North Central Washington
  59. Oahu, HI
  60. Oklahoma
  61. Orlando, FL
  62. Pensacola, FL
  63. Philadelphia, PA
  64. Portland, OR
  65. Québec, Canada (All)
  66. Québec, Canada (Région 87, Southwest)
  67. Québec, Canada (Région 88, Southeast)
  68. Rochester, MN
  69. Rhode Island
  70. Sacramento, CA
  71. Salinas, CA
  72. San Francisco, CA
  73. San Jose, CA
  74. San Mateo, CA
  75. Santa Fe, NM
  76. Savannah, GA
  77. Secular AA
  78. Sonoma County, CA
  79. South Florida District 20
  80. Southern Colorado
  81. Southwestern Missouri
  82. Spokane, WA
  83. St. Louis, MO
  84. State College, PA
  85. Streamwood, IL
  86. Tampa, FL
  87. Tidewater Area, VA
  88. Toronto, Canada
  89. Tri Valley, CA
  90. Topeka, KS
  91. Traverse City, MI
  92. Tulsa, OK
  93. Vacaville, CA
  94. Vancouver, Canada
  95. Ventura County, CA
  96. Virginia
  97. Walnut Creek, CA
  98. Warsaw, IN
  99. Washington, DC
  100. Wenatchee, WA
  101. West Hawaii, HI
  102. West-Central Wisconsin
  103. Western Slope, CA
  104. Western Kentucky
  105. Western Washington
  106. Wilmington, DE
  107. Woodstock, IL

Adult Children of Alcoholics

  1. Arizona
  2. Southern California
  3. Texas

Al-Anon

  1. Lancaster, PA
  2. Naples, FL
  3. Pennsylvania

Co-Dependents Anonymous

  1. Los Angeles, CA
  2. South SF Bay Area, CA

Cocaine Anonymous

  1. Illinois

Debtors Anonymous

  1. Southern California

Heroin Anonymous

  1. Arizona

Narcotics Anonymous

  1. Chinook, CA
  2. Maine
  3. Martha’s Vineyard
  4. Poland
  5. Vienna

Refuge Recovery

  1. Main Website
  2. Oakland, CA

Sex Addicts Anonymous

  1. Indiana

Sexaholics Anonymous

  1. St. Louis, MO

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

Installation Instructions

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:

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 for your area. 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?”

How can I make the Region dropdown not be collapsible?

No problem, just add this CSS to your theme:

div#meetings .controls ul.dropdown-menu div.expand { display: none; }
div#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.

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 ‘Province,’ 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 'Province';
        }
    }
    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, you should follow the instructions above for overriding the meeting detail and location detail pages and then drop some or all of these tags in your PHP:

<?php echo $meeting->contact_1_name?>
<?php echo $meeting->contact_1_email?>
<?php echo $meeting->contact_1_phone?>
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.

Reviews

Area 25 Kansas

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!

Very useful and well-designed

All-around outstanding plugin for it’s purpose. The author has a keen idea of design. The ability to manage and import meetings using a .csv and google maps integration is invaluable. Looks great!!!

Read all 17 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

2.16.15

  • @codifryed updated language template file

2.16.14

  • @codifryed put load_plugin_textdomain in the proper hook
  • Fixing end time suggestions (per Greensboro, NC)

2.16.13

  • Fixing empty meeting contact info in CSV (Refuge Recovery)

2.16.12

  • Adding Open & Closed meeting types (Refuge Recovery)

2.16.11

  • Google address override (Refuge Recovery)

2.16.10

  • Google address override (Refuge Recovery)

2.16.9

  • Type descriptions for Women’s and Men’s meetings (Refuge Recovery)

2.16.8

  • Adding second URL field (Refuge Recovery)
  • Showing contact email link even when there are no groups

2.16.7

  • Fixing bugs in Group Notes field (Kentucky)

2.16.6

  • Javascript body class fix (Napa)

2.16.5

  • Geocoding address fix (NYC)

2.16.4

  • Two new shortcodes (DC)
  • Description for meeting change form (DC)
  • Javascript console debug statements (Connecticut)
  • Geocoding address fix (Maine)
  • New language meeting types (Refuge Recovery)

2.16.3

  • Meeting detail page bug fix

2.16.2

  • Adding new setting to make contact info public on meeting detail pages (Refuge Recovery)

2.16.1

  • Fixing unexpected ‘@’ PHP error on meeting edit page

2.16

  • Can save contact information on a meeting without specifying a group (Refuge Recovery)
  • Fixed saving conflict with WP post revisions
  • Fixed bug where lost data source name when refreshing
  • Adding email address to change request email (per NA Poland)
  • Displays error message when there’s a problem with data source (Sacramento)

2.15.5

  • Fixing margin bug on meeting list page
  • Adding meeting type for Milwaukee
  • Adding a notes row class per San Francisco

2.15.4

  • More descriptive ‘request change’ emails (San Francisco)
  • Fixing a bug wherein it wasn’t possible to change an established location name
  • Edit meeting page postboxes are no longer collapsible (was confusing in San Jose)
  • Adding a meeting type for ACA
  • Updating Google API key to be paid by Meeting Guide donation form

2.15.3

  • Fixing error on PHP 5.2
  • Adding Cocaine Anonymous

2.15.2

  • Fixing error message on meeting detail page (NA Poland)
  • Removing User Role Editor support (Area 72)
  • If Google Analytics is installed, capturing search terms (Washington, DC)

2.15.1

  • Meeting edit page improvements and bug fixes by Tech2Serve

2.15

  • Sites now control their level of sharing
  • Columns were not simultaneously both editable and reorderable (Suffolk County, NY)
  • Redesigned sidebar in Import & Settings
  • Support for User Role Editor plugin (Long Beach, CA)
  • Number of upcoming meetings in widget now can be up to 25 (Suffolk County, NY)
  • Adding two new programs: Parents of Addicted Loved Ones and Support Groups
  • Refactoring variables.php for cleaner structure
  • Emails have site name in brackets rather than plugin name (Refuge Recovery)
  • FAQ updates