=== Amen ===
Contributors: UaMV
Donate link: http://wmpl.org/blogs/vandercar/give
Tags: prayer, pray, amen, mission, church, christian, twitter, tweet, custom
Requires at least: 3.0
Tested up to: 3.6
Stable tag: trunk
License: MIT
License URI: http://www.opensource.org/licenses/mit-license.php

Prayer request management with counter. Alternatively, can be used as custom tweet platform.

== Description ==

Adds prayer request, custom tweet, and custom counter functionality to WordPress.

Includes options for prayer moderation, privatization, public posting, tweeting, and a customizable weekly notification digest.

View examples, consult documentation, and give the plugin a test run [here](http://wmpl.org/blogs/vandercar/wp/ "Amen Documentation").

= Shortcode =

> **[amen]**<br /><br />
> **Description:** List and/or manage prayer requests.<br />
> **Attributes:**<br />
> type="_[options:manage,bookmarked,personal]_" (manage: show management form and list. bookmarked: show personally bookmarked prayers. personal: show my personal prayer journal)<br />
> exclude="_[options:author,counter,tweet,date,others]_" (Comma-separated options exclude elements from display)<br />
> page="_page-id_" (Lists prayers tagged with a specific page id.)<br />
> author="_username1,username2_" (Comma-separated authors limits list.)<br />
> count="_integer_" (Integer value lists specific number of requests.)<br />
> title="_text_" (Displays title for list.)<br />
> random="true" (Selects random requests and random order. Best used with count.)<br />
> id="_AmenID1,AmenID2_" (Comma-separated ids to include.)<br />
> noid="_AmenID1,AmenID2_" (Comma-separated ids to exclude.)<br />
> submit="_text_" (Override counter submit text. Accepts {count}, {count-1}, {count+1}, {s}, {1s})<br />
> state1="_text_" (Override counter state one. Accepts {count}, {count-1}, {count+1}, {s}, {1s})<br />
> state2="_text_" (Override counter state two. Accepts {count}, {count-1}, {count+1}, {s}, {1s})<br />
> state3="_text_" (Override counter state three. Accepts {count}, {count-1}, {count+1}, {s}, {1s})<br />

= Custom Settings =

> **Privacy & Moderation:** public posting | private posting (visible to logged in users) | personal posting (visible only to poster) | disable public management | require approval for all public requests | require approval for all requests | disable approval notifications | set custom email(s) for approval notifications<br />
> **Submission & Management:** submission form (title, note, button) | title for management form | author display | public user name | show date<br />
> **Counter Customization:** enable/disable | displayed text<br />
> **Tweeting:** allow/disallow tweeting | tweet via | customize hashtag | tweet type (hashtag or page share) | add hashtag | add author name | custom ID parameter<br />
> **Digest Email:** enable/disable | from email | subject | message | loop | management page<br />
> **Database:** keep options on removal | keep database tables on removal | custom table prefix<br />
> **Page Tagging:** allowed users | allowed pages

== Installation ==

1. Upload the `amen` directory to your `/wp-content/plugins/`
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Add the [amen type="manage"] shortcode in order to allow front-end logged users to manage requests.
1. Add the [amen] shortcode in order to list requests.

== Screenshots ==

1. Prayer Request List
2. Prayer Request Management
3. Amen Settings Page
4. Sample Notification Email

== Frequently Asked Questions ==

= Why does the submission form not show? =

You may still need to enable public posting from the settings page. Alternatively, you may have an early version of the plugin which used the shortcode [amen_manage]. This shortcode should be changed to [amen type="manage"].

== Changelog ==

= 3.3.1 =
* Adds visual editor for email digest

= 3.3.0 =
* Fixes default settings
* Email content type set to HTML

= 3.2.2 =
* Fixes form processing (adds nonce check)
* Fixes user & session coookies
* Adds option to disable public management

= 3.2.1 =
* Corrects URLs in approval email

= 3.2.0 =
* Adds capability for personal prayer journal with shortcode parameter type="personal"
* Adds shortcode parameter exclude="others" to limit management requests shown for admin
* Ability to show date of request (disabled by default). Also remove with exclude="date"

= 3.1.1 =
* Fixed bug in cookie use

= 3.1.0 =
* Allow users to 'bookmark' requests and adds shortcode to display only bookmarked requests

= 3.0.4 =
* Fixes cron database query

= 3.0.3 =
* Fixes database setup for notifications

= 3.0.2 =
* Minor bug fixes
* Added type="text" to inputs for better theme integration

= 3.0.1 =
* Settings page: relocation and better documentation
* Allows public users to post name
* Option for weekly email notification of new prayers (default: off & disabled for existing prayers)
* Allows custom ID for URL
* Adds uninstall.php to restore database on delete of plugin

= 2.1.1 =
* Added uninstall.php to empty database
* Allow setting of custom id parameter for URL included in tweet
* Fix option setting on install
* Fix email notification for update approvals

= 2.1.0 =
* Added UTF-8 support

= 2.0.8 =
* Added shortcode parameters

= 2.0.7 =
* Customization of approval notifications

= 2.0.4 =
* Fixed Twitter share button to include link to request
* Disables widget (not working)

= 2.0.3 =
* Added Amen widget

= 2.0.2 =
* Add shortcode parameter to list request by id

= 2.0.1 =
* Customization options
* Allow editing of posted requests
* Admin notification on new request/update/edit
* Additional shortcode parameters

= 1.0.2 =
* Additional Tweet options
* Fixed call to database table
* Added randomizing attribute to shortcode

= 1.0.1 =
* Added Twitter integration
* Allows custom database table prefix for connecting on multisite install

= 0.3.0 =
* Added functionality for public users to post requests *
* Added request approval option *
* Added data sanitization *

= 0.2.1 =
* Rewrote install/update functions
* Minor changes to shortcode

= 0.0.1 =
* Initial Release

== Upgrade Notice ==

= 3.3.1 =
* Adds visual editor for email digest

= 3.3.0 =
* Fixes default settings
* Email content type set to HTML

= 3.2.2 =
* Fixes form processing (adds nonce check)
* Fixes user & session coookies
* Adds option to disable public management

= 3.2.1 =
* Corrects URLs in approval email

= 3.2.0 =
* Adds capability for personal prayer journal with shortcode parameter type="personal"
* Adds shortcode parameter exclude="others" to limit management requests shown for admin

= 3.1.1 =
* Fixed bug in cookie use

= 3.1.0 =
* Allow users to 'bookmark' requests and adds shortcode to display only bookmarked requests

= 3.0.4 =
* Fixes cron database query

= 3.0.3 =
* Fixes database setup for notifications

= 3.0.2 =
* Minor bug fixes
* Added type="text" to inputs for better theme integration

= 3.0.1 =
* Settings page: relocation and better documentation
* Allows public users to post name
* Option for weekly email notification of new prayers (default: off & disabled for existing prayers)
* Allows custom ID for URL
* Adds uninstall.php to restore database on delete of plugin

= 2.1.1 =
* Added uninstall.php to empty database
* Allow setting of custom id parameter for URL included in tweet
* Fix option setting on install
* Fix email notification for update approvals

= 2.1.0 =
* Adds UTF-8 support

= 2.0.8 =
* Adds shortcode parameters (noid, exclude, submit, state1, state2, state3) and extends 'id' parameter

= 2.0.7 =
* Allows customization of approval notifications (disable and send-to)

= 2.0.4 =
* Fixed Twitter share button to include link to request

= 2.0.3 =
* Adds Amen widget (Note: if updating from 1.0.2 or earlier, check settings and shortcodes)

= 2.0.2 =
* Please, check settings and shortcode, if you encounter troubles after update (New manage shortcode: [amen type="manage"])

= 2.0.1 =
* NOTICE: This update will reset your options. Check options and shortcodes after update. (New manage shortcode: [amen type="manage"])

= 1.0.2 =
* Additional Tweet options
* Fixed call to database table
* Added randomizing attribute to shortcode

= 1.0.1 =
* Added Twitter integration
* Allows custom database table prefix for connecting on multisite install

= 0.3.0 =
* Additional functionality and data sanitization

= 0.2.1 =
* Fixes database table creation