How To Use The “Where I’m Going” Plugin

Managing Your D
Managing Your "
Showing Your De
Managing Your Destinations

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.

Additional Parameters

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.
    • Examples:
      • “%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.

Examples

  • [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