=== 12 Step Meeting List ===
Contributors: meetingguide, aasanjose
Donate link: https://meetingguide.org/donate
Tags: 12-step, aa, al-anon, coda, meetings, na, oa, saa, slaa
Requires at least: 3.2
Tested up to: 4.9
Stable tag: 3.1.3

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

== 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](https://meetingguide.org/) 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](http://www.aa-cenla.org/meetings/?tsml-day=any)
1. [Arkansas](http://arkansascentraloffice.org/meetings/)
1. [Aspen, CO](http://www.coaadistrict14.org/)
1. [Asheville, NC](http://ashevilleaa.org/meetings/)
1. [Austin, TX](http://austinaa.org/meetings/)
1. [Batavia, IL](https://aadistrict61.org/archives/meetings)
1. [Baton Rouge, LA](http://aabatonrouge.org/meetings/)
1. [Bethlehem, PA](https://www.aalv.org/meetings)
1. [Bowling Green, KY](http://bowlinggreenaa.org/meetings/)
1. [Brainerd, MN](http://aacentrallakes.org/meetings/)
1. [Burlington, NC](http://www.aanc33.org/meetings/)
1. [Cancún, Mexico](http://aacancun.org/meetings/)
1. [Charleston, SC](http://tcio.org/meetings)
1. [Charleston, WV](http://aawvdist1.org/wordpress/?post_type=tsml_meeting)
1. [Charlotte, NC](http://charlotteaa.org/meetings/)
1. [Chico, CA](http://www.aabutte-glenn.org/meetings/)
1. [Cincinnati, OH](http://aacincinnati.org/meetings/)
1. [Continental Europe](http://alcoholics-anonymous.eu/meetings/)
1. [Colorado Springs, CO](http://www.coloradospringsaa.org/meetings/)
1. [Columbus, OH](https://aacentralohio.org/meetings/)
1. [Corpus Christi, TX](http://www.cbiaa.org/meetings/)
1. [Davis, CA](http://aadavis.org/meetings/)
1. [Dayton, OH](http://aadaytononline.org/meetings/)
1. [Daytona, FL](http://aadaytona.org/meetings/)
1. [DuPage County, IL](http://dupage41aa.org/meetings/)
1. [East Bay, CA](http://eastbayaa.org/meetings)
1. [East Tennessee](http://www.etiaa.org/meetings/)
1. [Elk Grove Village, IL](http://d15aa.org/d15aa.org/?post_type=meetings)
1. [Elgin, IL](http://dist22.aa-nia.org/meetings/)
1. [Fargo, ND](http://www.fmmeetinglist.org/meetings/)
1. [Fredericksburg, VA](http://www.aadistrict30va.org/wp/meetings/)
1. [Fresno, CA](http://www.fresnoaa.org/gfaia/wp/meetings/)
1. [Ft. Worth, TX](http://fortworthaa.org/?post_type=tsml_meeting)
1. [Greensboro, NC](http://nc23.org/meetings/)
1. [Hagerstown, MD](http://hagerstownaa.org/meetings/)
1. [Harrisburg, IL](http://aa-district16.org/meetings/)
1. [Harrisburg, PA](http://www.aaharrisburg.org/meetings/)
1. [Hernando County, FL](http://www.aahernando.org/meetings/)
1. [Idaho](https://idahoarea18aa.org/meetings)
1. [Inland Empire, CA](https://aainlandempire.org/meetings)
1. [Jacksonville, FL](http://neflaa.org/wiktor/meetings/)
1. [Joliet, IL](http://aadistrict51.org/meetings/)
1. [Kansas](https://ks-aa.org/meetings/)
1. [Kansas City](https://kc-aa.org/meetings/)
1. [Kentucky](http://www.area26.net/wp/?post_type=tsml_meeting)
1. [Lafayette, LA](http://aa-acadiana.org/site/meetings/)
1. [Lakeland, FL](https://www.heartlandintergroup.org/meetings/)
1. [Lancaster, PA](http://www.lancasteraa.org/meetings/)
1. [Langley, Canada](http://www.district43aa.org/meetings/)
1. [Lebanon, PA](http://www.lebanonpaaa.org/meetings/)
1. [Lee County, FL](http://leecountyaa.org/meetings)
1. [Leesburg, FL](http://meetings.aalakesumter.com/)
1. [Lewis County, WA](http://lewiscountyaa.org/meetings/)
1. [Long Beach, CA](https://hacoaa.org/meetings/)
1. [Madison, WI](http://aamadisonwi.org/meetings/)
1. [Maine and New Brunswick](http://csoaamaine.org/meetings/)
1. [Martin County, FL](http://martincountyaa.org/meetings/)
1. [Maui, HI](http://aamaui.org/meetings)
1. [Mercer County, PA](http://www.wpadistrict52aa.org/meetings/)
1. [Mesa, AZ](http://aamesaaz.org/meetings/)
1. [Miami, FL](https://aamiamidade.org/meetings)
1. [Midlands, UK (Polish)](http://intergrupamidlands.co.uk/meetings/)
1. [Minneapolis, MN](http://aaminneapolis.org/meetings/)
1. [Minnesota](http://aaminnesota.com/meetings/)
1. [Mississippi](http://www.aa-mississippi.org/meetings/)
1. [Modesto, CA](http://wp.cviaa.org/meetings/)
1. [Monterey, CA](http://www.aamonterey.org/meetings/)
1. [Montreal, Canada](http://aa87.org/meetings/)
1. [Myrtle Beach, SC](http://aamyrtlebeach.org/meetings/)
1. [Napa, CA](http://www.aanapa.org/meetings)
1. [Naples, FL District 20](http://district20aa.org/meetings/)
1. [Naples, FL Intergroup](http://wp3.aanaples.org/meetings/)
1. [Nassau County, NY](http://nassauaa.org/meetings)
1. [New Hampshire](http://nhaa.net/meetings/)
1. [New Orleans, LA](http://www.aaneworleans.org/meetings/)
1. [New Mexico](https://nm-aa.org/meetings/)
1. [New York, NY](https://www.nyintergroup.org/meetings/)
1. [North Central Washington](http://aancw.org/meetings)
1. [North Coast, LA](http://district12.org/meetings/)
1. [North Port, FL](http://aanorthport.org/meetings/)
1. [Oahu, HI](http://oahucentraloffice.com/meetings/)
1. [Oklahoma](http://aaoklahoma.org/meetings)
1. [Orlando, FL](http://cflintergroup.org/meetings/)
1. [Palm Beach County, FL](http://aa-palmbeachcounty.org/new/meetings)
1. [Palm Springs, CA](http://aainthedesert.org/meetings/)
1. [Pensacola, FL](http://aapensacola.org/meetings/)
1. [Philadelphia, PA](http://www.aasepia.org/meetings/)
1. [Placerville, CA](http://westernsloped22.org/meetings/)
1. [Portland, OR](http://home.pdxaa.org/meetings/)
1. [Québec, Canada (All)](http://aa-quebec.org/aaqc_wp/meetings/)
1. [Québec, Canada (Région 87, Southwest)](http://aa87.org/meetings/)
1. [Québec, Canada (Région 88, Southeast)](http://aa-quebec.org/region88/WP/meetings/)
1. [Regina, Canada](http://www.aaregina.com/meetings/)
1. [Reading, PA](http://readingberksintergroup.org/meetings/)
1. [Rochester, MN](http://aadistrict1.org/blog/meetings/)
1. [Rockland County, NY](https://rocklandnyaa.org/meetings/)
1. [Romania](https://grupuri.aaromania.ro/meetings/)
1. [Rhode Island](https://aainri.com/meetings/)
1. [Sacramento, CA](http://aasacramento.org/meetings/)
1. [Salinas, CA](https://aasalinas.org/meetings/)
1. [San Francisco, CA](https://www.aasf.org/meetings)
1. [San Jose, CA](https://aasanjose.org/meetings)
1. [San Mateo, CA](http://aa-san-mateo.org/meetings)
1. [Santa Fe, NM](http://santafeaa.org/meetings/)
1. [Savannah, GA](http://savannahaa.com/meetings-list/)
1. [Secular AA](https://www.secularaa.org/meetings/)
1. [Shreveport, LA](http://aa-shreveport.org/meetings/)
1. [Snohomish County, WA](http://snocoaa.org/wordpress_4.1/?post_type=tsml_meeting)
1. [Sonoma County, CA](http://www.sonomacountyaa.org/meetings/)
1. [South Lexington, KY](http://aasouthlexingtonky.org/meetings/)
1. [Southeastern Indiana](http://seigaa.org/meetings/)
1. [Southern Colorado](http://www.puebloaa.org/meetings/)
1. [Southern Illinois](http://www.aa-district14.org/meetings/)
1. [Southern New Jersey](http://aasj.org/meetings/)
1. [Southwestern Missouri](https://aaswmo.org/meetings)
1. [Spokane, WA](http://aaspokane.org/meetings/)
1. [St. Louis, MO](https://aastl.org/meetings/)
1. [St. Lucie, FL](http://aastlucieintergroup.com/meetings/)
1. [St. Peters, MO](https://tricountyaa.org/meetings/)
1. [State College, PA](http://www.district43.com/meetings/)
1. [Streamwood, IL](http://dist23.aa-nia.org/meetings)
1. [Syracuse, NY](http://www.aasyracuse.org/meetings/)
1. [Tampa, FL](http://www.meetings.aatampa-area.org/meetings/)
1. [Tidewater Area, VA](http://www.tidewaterintergroup.org/meetings/)
1. [Tokyo, Japan](https://www.aatokyo.org/meetings/)
1. [Toronto, Canada](https://aatoronto.org/meetings/)
1. [Tri Valley, CA](http://trivalleyaa.org/meetings/)
1. [Topeka, KS](http://aatopeka.org/meetings/)
1. [Traverse City, MI](http://district11-aa.org/meetings/)
1. [Tulsa, OK](http://district40aa.com/meetings)
1. [Vacaville, CA](http://aasolanonorth.org/meetings/)
1. [Vancouver, Canada](http://www.vancouveraa.ca/meetings/)
1. [Ventura County, CA](https://aaventuracounty.org/meetings)
1. [Virginia](https://aavirginia.org/meetings/)
1. [Virginia Peninsula](http://vapsc.org/meetings)
1. [Waco, TX](https://centexintergroup.com/meetings/)
1. [Walnut Creek, CA](http://contracostaaa.org/meetings)
1. [Warsaw, IN](http://www.aadistrict4143.com/meetings/)
1. [Washington, DC](https://aa-dc.org/meetings)
1. [Wenatchee, WA](http://aancw.org/meetings)
1. [West Hawaii, HI](http://www.westhawaiiaa.org/meetings/)
1. [West-Central Wisconsin](http://www.district05.org/meetings/)
1. [West Pasco, FL](http://www.aapasco.org/meetings/)
1. [Western Colorado](https://aa-westerncolorado.com/meetings/)
1. [Western Kentucky](http://wkintergroup.org/meetings/)
1. [Western Washington](http://area72aa.org/meetings/)
1. [Wheaton, IL](http://aa-nia-dist40.org/meetings/)
1. [Wilmington, DE](http://ndiaa.org/meetings/)
1. [Woodstock, IL](http://aa-nia-dist11.org/meetings/)

**Adult Children of Alcoholics**

1. [Arizona](http://aca-arizona.org/meetings/?tsml-day=any)
1. [Southern California](http://www.socalaca.org/meetings/?d=any)
1. [Texas](http://lonestaraca.org/meetings/)

**Al-Anon**

1. [Lancaster, PA](http://lanclebalanon.org/meetings/?d=any)
1. [Naples, FL](http://naplesal-anon.org/meetings)
1. [Pennsylvania](http://pa-al-anon.org/meetings/)
1. [Washington](http://wa-al-anon.org/meetings/)

**Co-Dependents Anonymous**

1. [Los Angeles, CA](http://www.lacodapreview.lacoda.org/wp/index.php/meetings/?d=any)
1. [South SF Bay Area, CA](http://www.sbcoda.org/meetings/?d=any&v=list)

**Cocaine Anonymous**

1. [Illinois](http://illinoisareaca.org/meetings)

**Debtors Anonymous**

1. [Southern California](http://socalda.org/meetings/)

**Gamblers Anonymous**

1. [Australia](http://gaaustralia.org.au/meetings/?d=any&v=list)
1. [Los Angeles](https://www.laintergroup.com/meetings/)

**Heroin Anonymous**

1. [Arizona](https://meetings.haazarea.org/meetings/)

**Narcotics Anonymous**

1. [Chinook, CA](http://chinookna.org/meetings/)
1. [Lancaster, PA](http://lancasterpana.org/meetings/)
1. [Maine](http://www.namaine.org/meetings/)
1. [Martha's Vineyard](http://www.mvana.org/meetings/?tsml-day=any)
1. [Marysville, CA](https://middlemountainarea.com/meetings/)
1. [Poland](http://anonimowinarkomani.org/meetings/)
1. [Roseville, CA](https://sfana.org/meetings/)
1. [Sacramento, CA](https://sacramentona.org/meetings/)
1. [Toledo, OH](https://toledonameetings.com/meetings/)
1. [Vienna](https://www.navienna.com/meetings/?d=any)
1. [Western Oklahoma](https://wascokna.org/meetings/)

**Recovering Couples Anonymous**

1. [Main Website](http://recovering-couples.org/meetings/)

**Refuge Recovery**

1. [Main Website](https://refugerecovery.org/meetings/)
1. [Oakland, CA](http://refugerecoveryoakland.org/meetings/)

**Sex Addicts Anonymous**

1. [Indiana](http://indiana-saa.org/meetings/)

**Sexaholics Anonymous**

1. [Main Website](http://ws.sexaholics.org/meetings/)
1. [St. Louis, MO](http://www.sastl.net/meetings/?tsml-day=any)

[Let us know](mailto:info@meetingguide.org) 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."

== 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:

[youtube https://www.youtube.com/watch?v=Qqg1RPX-FTQ]

== Frequently Asked Questions ==

= My meeting type isn't listed! =
If it's a broadly-applicable meeting type, please [contact us](mailto:wordpress@meetingguide.org) so we can include it for you. We want to maintain consistency for the [mobile apps](https://meetingguide.org/), 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.
1. Be careful with the codes ("XYZ" in the above example) as this gives you the ability to replace existing types. 
1. Note that custom meeting types are not imported into the Meeting Guide app.
1. 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.
1. 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](https://codex.wordpress.org/Child_Themes). 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](https://codex.wordpress.org/Plugin_API/Filter_Reference/gettext) 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, 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](https://github.com/meeting-guide/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. 
	
== Screenshots ==

1. Meeting list page
1. Meeting map
1. Meeting detail page
1. Edit meeting
1. Edit location

== Changelog ==

= 3.1.3 =
* Fixing PHP notice when adding a new meeting
* Adding Venmo column to CSV

= 3.1.2 =
* Bug fix, thinks Google is the right thing but it's really Mapbox (SoCal ACA)

= 3.1.1 =
* Bug fix when saving a meeting if you have a database prefix (Ft Worth)
* Paragraph spacing on no-SSL warning
* Badging Import & Settings link if notices present
* Adding link on admin page to enable maps
* Removing empty map on meeting & location detail pages if maps not enabled
* Map infowindow is back on location detail page

= 3.1.0 =
* Mapbox support
* Maps are now optional
* Removed notice from main dashboard page

= 3.0.6 =
* Bugfix: dropdowns could be unresponsive if map not yet invoked

= 3.0.5 =
* Whitelisting

= 3.0.4 =
* Whitelisting
* Only display notice about API key on the main dashboard page

= 3.0.3 =
* Fixing a bug causing the Publish button to be greyed out

= 3.0.2 =
* Whitelisting

= 3.0.1 =
* Whitelisting

= 3.0.0 =
* Responds to [Google's imminent API price increase](https://meetingguide.org/google-api) by requiring most websites to sign up for a Google Maps API key
* Whitelists all existing AA websites we know of
* Provides link for those we don't to request whitelisting
* Provides instructions and form for others to enter their API key
* Reduces usage of Maps API by only loading it on demand
* Caches user geocodes

= 2.17.16 =
* Fixing Varnish cache-related error when generating CSV (Tidewater Intergroup)
* Save location as draft when there are some meetings but they are unpublished (East Bay)

= 2.17.15 =
* Classes for styling / removing control boxes (Sexaholics Anonymous)
* Adding "People of Color" meeting type (East Bay)

= 2.17.14 =
* PDF improvements
* Firefox printing improvements

= 2.17.13 =
* PDF bug fix

= 2.17.12 =
* Adding a draft version of a PDF meeting schedule

= 2.17.11 =
* Changing "Atheist / Agnostic" AA meeting type to "Secular"

= 2.17.10 =
* Changing the way directions links work
* Adding "Indigenous" meeting type
* Adding directions link to the top of location page (same as already exists on meeting page)

= 2.17.9 =
* Removing "Business" meeting type
* Adding group Venmo link option

= 2.17.8 =
* Gamblers Anonymous meeting types (LA Gamblers Anonymous)
* FAQ item about telephone meetings (LA Gamblers Anonymous)
* Sunday issue in change notification emails (Tidewater Intergroup)
* Javascript setting default time value when changing from Appointment to a day

= 2.17.7 =
* Adding meeting type for Al-Anon

= 2.17.6 =
* Fixing CSS spacing issue on mobile
* Changing list heading in meeting list (LA Gamblers Anonymous)
* Adding type description for GA (LA Gamblers Anonymous)

= 2.17.5 =
* Fixing directions links (NC District 33)
* Adding Gamblers Anonymous

= 2.17.4 =
* Contact name wasn't showing up in CSV (Milwaukee)

= 2.17.3 =
* Meeting author support (Connecticut)

= 2.17.2 =
* Fixing Firefox display issue on types checkboxes in meeting edit page (LA ACA)

= 2.17.1 =
* Fixing bug that prevented certain posts from saving (PA Al-Anon)

= 2.17 =
* By default, "apply this updated address to all meetings at this location" is unchecked now (Kentucky)
* "Apply this updated address" now appears while making changes to an address, not after (Kentucky)
* Form submit now disabled while geocodes are pending (NYC)
* Map view no longer displays pins with empty coordinates (NYC)
* Update email now properly reflecting changes to location name and notes (Kentucky)
* Switching search modes no longer clears the current search (Baltimore)