How To Use The “Where I’m Going” Plugin
This video shows you how to add, update, and delete Destinations in the "Where I'm Going" WordPress plugin.
Outputting Destinations With [wig] Shortcode
The “Where I’m Going” plugin features a single powerful shortcode that gives you the ability to output your destinations in virtually any way you can imagine.
To call the shortcode with default settings, use [wig]. This will output your current destination, if you have one.
If you want to custom tailor the output of your Destinations, the [wig] shortcode gives you numerous options. You can use any or all of these when you call the [wig] shortcode.
- display – Accepts any one of the following values:
- past – Shows all Destinations that you visited in the past
- present (Default) – Shows all Destinations that you’re currently in
- future – Shows all Destinations that you’ll be visiting in the future
- all – Shows all Destinations
- post – Shows all Destinations that are tied to a WordPress post or page
- no_post – Shows all Destinations that are not tied to a WordPress post or page
- show – How many Destinations do you want to show if there are more than 1 that match the parameters? Default: 1 (Set to 0 for “all”). If multiple Destinations are output, a line break will be placed after each.
- display_date_start – The start of the search period in Unix time. Overrides display parameter
- display_date_end – The end of the search period in Unix time. Overrides display parameter
- has_post – Accepts: yes, no, all (default)
- format – Accepts the following placeholders (any text is allowed):
- %n% – The Destination name
- %sd% – The Destination start date
- %sdt% – The Destination start datetime
- %st% – The Destination start time
- %ed% – The Destination end date
- %edt% – The Destination end datetime
- %et% – The Destination end time
- %url%…%/url% – If the Destination is tied to a post, the URL will be linked from any text between these. If a Destination is not tied to a post, a URL will not be output.
- “%url%%n%%/url%” outputs
- “%url%%n%%/url% – %sdt% to %edt%” outputs
Key West, FL – Apr 05, 2013 12:00 to Apr 15, 2013 14:00
- “%n%: %sd% at %st% until %ed% at %et%” outputs
Key West, FL: Apr 05, 2013 at 12:00 until Apr 15, 2013 at 14:00
- date_format – Accepts all PHP date options: http://php.net/manual/en/function.date.php. Default: M d, Y (ex: Apr 05, 2013)
- time_format – Accepts all PHP time options: http://php.net/manual/en/function.date.php. Default: H:i (ex: 17:36)
- show_error – Show “No destination(s) found” if there are no matching destinations? Accepts 0 (default) or 1.
[wig]Outputs the current Destination without start and end date/time
[wig display=”past” has_post=”yes” show=0]Outputs all past Destinations that are assigned to a WordPress post/page.
[wig display=”future” format=”%url%%n%%/url%: %sd% at %st% until %ed% at %et%” time_format=”h:i a” show=3]Outputs 3 future Destinations with destination name as a URL (if tied to a post/page), start and end date/time,
and time in the format 04:36 pm