About this plugin
Schedule HTML sections to be shown or not based on a date range using a simple shortcode.
Right now the plug-in is enabled by using the rotator shortcode. For example, To specify we want to show a specific piece of HTML from 9am to 5pm you can use the following code:
[rotator start=”9am” end=”5pm”]
Some custom HTML.
[/rotator]
Where start and end parameters are using the date format specified in the php manual, so you can specify more specific dates like showing the HTML section all Tuesday between 10am and 11am, etc. Read the Other Notes section for more information.
Note: the hour range is server based time and the default timezone is UTC, in other words, it depends on the configured time of the server, you can set that in general settings at the admin console.
There is a page available at “Settings” -> “Schedule generator” in the wp admin console with a basic form which lets you generate the short code configuring different values like start and end times, among others.
Usage
Right now the plug-in is enabled by using the rotator shortcode. For example, To specify we want to show a specific piece of HTML from 9am to 5pm you can use the following code:
[rotator start=”9am” end=”5pm”]
Some custom HTML.
[/rotator]
That will show the contents only if the user access the blog post or page in the specified hour range.
Currently, it supports the following parameters:
- start: a date to specify the start of the hour range, required.
- end: a date to specify the end of the hour range, required.
- visible: false to hide the html section, by default true.
- inverse: to specify if we want to show the html section outside the our range, by default false.
Both start and end are using the date format specified in the php manual. For example, we can specify the timezone of the hour range:
[rotator start=”9am -0600″ end=”5pm -0600″]…[/rotator]
Note: Using GMT notation doesn’t work in some installations, not sure which php version is required for that to work.
Note: the hour range is server based time and the default timezone is UTC, in other words, it depends on the configured time of the server, you can set that in general settings at the admin console.
There is a page available at “Settings” -> “Schedule generator” in the wp admin console with a basic form which lets you generate the short code configuring different values like start and end times, among others.
Configuration
The first lines of the plugin contains some global variables to configure the plugin, for example, if you want to disable the generator from the admin -> settings page, among other configurations.
- WP_HTML_ROTATOR_DEBUG: defines if the plugin echoes debug information.
- WP_HTML_ROTATOR_ENABLE_WIDGETS: enables the shortcode to work on text widgets.
- WP_HTML_ROTATOR_ENABLE_GENERATOR: enable the shortcode generator to be shown in the admin panel or not.