=== Display During Conditional Shortcode ===
Contributors: gserafini
Donate link: http://bit.ly/display_during_plugin_donation
Tags: shortcode, conditional, display, strtotime
Requires at least: 2.7
Tested up to: 4.9
Stable tag: 1.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Provides ability to use a shortcode to show or hide content depending on time of day, expiration of a certain date and more.

== Description ==

Specify the start and end date / times you'd like content enclosed by the shortcode to be displayed during.  Optionally include a message or different content to display once that time period has passed.

= Shortcodes: =

Insert `[display_during end_day_time="June 27, 2015 10:00 am" message="Sorry, this content no longer available."]CONTENT_TO_DISPLAY[/display_during]` into any post or page to conditionally display whatever is inside of the shortcode.  The `message` parameter you specify will display if the start and end time parameters are not currently valid.

Shortcode parameters

`[display_during start_day_time="Sun 8:00 am" end_day_time="Mon 8:00 pm" timezone_location="America/Denver" message="Sorry, this content is not currently available."]CONTENT_TO_DISPLAY[/display_during]`

* `start_day_time` - OPTIONAL - What day/time or time of day should the contents start being displayed?
* `end_day_time` - REQUIRED - What day/time or time of day should the content of the shortcode stop being displayed?
* `timezone_location` - OPTIONAL - The timezone uses by default whatever is set for the site in Settings > General.  You can use this optional parameter to specify a different timezone location.  Uses the standard [PHP timezones](http://www.php.net/manual/en/timezones.php)


== Installation ==

= Install via Plugins > Install New =
1. Search for "Display During Conditional Shortcode"
2. Click the "Install Now" link
3. Click "Activate Plugin"

= Via ZIP / FTP =
1. Unzip the ZIP file and drop the folder straight into your wp-content/plugins directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.

= Use as a shortcode =

1.  Insert your `[display_during end_day_time="June 27, 2015 10:00 am" message="Sorry, this content no longer available."]CONTENT_TO_DISPLAY[/display_during]` shortcode and insert the content you want to display where CONTENT_TO_DISPLAY is and put the message to display if the time isn't valid in the message parameter.
2. Publish and  view post or page to see output.

== Frequently Asked Questions ==

= What are valid time settings for start_day_time and end_day_time?  =

The plugin uses PHP's [strtotime()](http://php.net/manual/en/function.strtotime.php) function to decipher start and end times.  You can specify either a specific start and end date (i.e. June 27, 2015 10:00 am) or you can also specify a start and end time as days of the week (i.e. start_day_time="Sun 8:00 am" and end_day_time="Mon 8:00 pm".  This second method will display content starting Sunday at 8:00 am and stop displaying it the day after (Monday) at 8:00 pm.

Only end_day_time is required.  If start_day_time is omitted, now is used for the start_day_time, and end_day_time will determine when to stop displaying the content.

= Can I use either Visual or Text mode? =

Yes.  Both are supported, although if you're entering HTML / CSS as the content, you may want to edit the page using Text mode.

= Is support available? =

Yes, use the contact form on the ShareThePractice.org [website](http://sharethepractice.org/contact/).

== Screenshots ==

1. Edit screen - add your shortcode either using Visual or Text
2. Content shown during valid dates
3. Content not available message being shown

== Changelog ==

= 1.1 =
* Public release of plugin to WordPress repository.  Hello World! :)

= 1.0 =
* Initial version of plugin, internal release only

== Upgrade Notice ==

= 1.1 =
Added additional code to manage timezone default better