Overview
The Date Range extension adds the ability to display posts or events from a specific date range. You can set date ranges to either be absolute (eg: November 1st – November 8th) or relative (eg: 1 week ago – today).
The extension give you the power to create daily, weekly, monthly or yearly feeds of your posts using separate shortcodes to display posts from different date ranges in each.
See the How to Use tab above for more information and examples of how to use the extension.
Below is an example of the Date Range extension used to show events by month.
Shortcodes used above:
March
[custom-facebook-feed type=events from="03/01/14" until="03/31/14"]
April
[custom-facebook-feed type=events from="04/01/14" until="04/30/14"]
See the How to use tab above for directions on how to use the extension.
How to use
Installation
Extensions are installed just like any other WordPress plugin. You can follow the same process used when uploading and installing the Custom Facebook Feed Pro plugin.
Settings Page
Once activated the extension will allow you to set a ‘From’ and ‘Until’ date range to allow you to show posts or events only from between those specific dates.
If you set an ‘Until’ date but don’t set a ‘From’ date then it will display posts from today’s date until the date you set.
If you set a ‘From’ date but don’t set an ‘Until’ date then it will display posts from the date you set until today’s date.
If you don’t set either then the date range won’t be applied.
Shortcode
The Date Range extension also allows you to specify a date range directly in your shortcode like so:
[custom-facebook-feed from="mm/dd/yy" until="mm/dd/yy"]
This then allows you to create separate feeds of posts or events by month like so:
February
[custom-facebook-feed type=events from="02/01/14" until="03/01/14"]
March
[custom-facebook-feed type=events from="03/01/14" until="04/01/14"]
April
[custom-facebook-feed type=events from="04/01/14" until="05/01/14"]
Relative/Moving Dates
The extension also allows you to display posts from relative/moving dates. For example, you could display all posts from the past day by using the following shortcode:
[custom-facebook-feed from="-1 day" until="now"]
Relative dates can only be set via the shortcode and not on the plugin’s Settings page. Below are some other shortcode examples.
Posts from the past two weeks: [custom-facebook-feed from="-2 weeks" until="now"]
Posts from the past month: [custom-facebook-feed from="-1 month" until="now"]
Posts from the last 12 hours: [custom-facebook-feed from="-12 hours" until="now"]
Posts from the last 24 hours to the last 12 hours: [custom-facebook-feed from="-1 day" until="-12 hours"]
Future Event Ranges
You can also show upcoming events from a specific date range, for example to show all events for the coming 2 weeks use:
[custom-facebook-feed type=events eventsource=eventspage from="now" until="+2 weeks"]
Shortcode Options
Name | Attribute | Options | Description | Example |
From | from | mm/dd/yy -x minutes -x hours -x days -x weeks -x months |
The date to display posts from The number of minutes ago The number of hours ago The number of days ago The number of weeks ago The number of months ago |
from=”02/15/14″ from=”-15 minutes” from=”-1 hour” from=”-2 days” from=”-3 weeks” from=”-1 month” |
Until | until | mm/dd/yy now -x minutes -x hours -x days -x weeks -x months |
The date to display posts until Display posts up until now The number of minutes ago The number of hours ago The number of days ago The number of weeks ago The number of months ago |
until=”02/20/14″ until=”now” until=”-15 minutes” until=”-1 hour” until=”-2 days” until=”-3 weeks” until=”-1 month” |
Change Log
= 1.0.2 =
* Tweak: Updated the plugin updater script to reduce requests on the WordPress Plugins page
= 1.0.1 =
* Fix: Changed the date format to mm/dd/yy to workaround a bug with the PHP strtotime function
= 1.0 =
* Launched the Date Range extension