12 Step Meeting List
====================

This plugin is designed to help 12 step programs (AA, NA, Al-Anon, etc) list their meetings. It standardizes addresses, and displays in a list or map.

The best way to install this plugin is via [its home page](https://wordpress.org/plugins/12-step-meeting-list/) in the WordPress Plugin Directory.

Do you have a support issue? Please let us know on the [12 Step Meeting List support forum](https://wordpress.org/support/plugin/12-step-meeting-list/).

## Developer Issues

The GitHub Issues feature is available for development-specific issues, confirmed bug reports, or feature requests.

If you have a general support request, or want to ask about a possible bug, please visit the [12 Step Meeting List support forum](https://wordpress.org/support/plugin/12-step-meeting-list/).

## Helping With Development

Do you want to help develop the plugin? We welcome pull requests! To get started:

* Start by forking this repository to your GitHub space
* Create a development copy of your WordPress site
* Delete the plugin from your development WordPress site
* Clone the repository into your `wp-content/plugins` folder with the following commands (substituting your local path):

```
cd /var/www/wordpress-dev/wp-content/plugins
git clone https://github.com/YourGitHubUsername/12-step-meeting-list
cd 12-step-meeting-list
```

* Add an upstream feed, so you can pull in changes from the root repository:

```
git remote add upstream https://github.com/code4recovery/12-step-meeting-list.git
````

* You should update your copy from the upstream repository frequently, especially before starting work on a new feature or issuing a pull request. Here is how:

```
git fetch --all
git checkout master
git merge upstream/master
```

* To create a new feature, first update your copy from the upstream repository, then from the master branch:

```
git checkout -b my-new-feature
```

* Make all of your changes, get it working, test, test, test...

```
git commit -am"These is my wonderful new feature!"
git push origin my-new-feature
```

* Last, issue a pull request (PR) to the root repository to be merged.
    * In your browser, go to: https://github.com/YourGitHubUsername/12-step-meeting-list
    * Click the "New pull request" button
    * Check the diff provided and make sure everything looks good
    * Click the "Create pull request" button

If you're new to git, you might benefit from [this git tutorial](https://git-scm.com/book/en/v2).