LibCal Hours for WordPress

Embed opening hours for any given location from LibCal into WordPress via short codes.

Installation

Since this plugin is not available for automatic installation, please follow these Manual Plugin Installation steps.

Configuration

In the plugin's Admin Settings form, enter the LibCal Hours API Endpoint URL and save the form.

Instructions on how to get that URL can be found on this Wiki page.

Usage

Embed the [wplibcalhours] short code into your posts and pages.

The short code has the following configuration options.

• location ... The name of the location that you want to display opening hours for. (mandatory)
• num_weeks ... The number of weeks of opening hours to display. Accepted values are 1, 2 and 3. Defaults to 3. (optional).

Examples

[wplibcalhours location="Parnassus Library"] - This will print the opening hours for the "Parnassus Library" location for the next three weeks (starting today).

[wplibcalhours location="Parnassus Library" num_weeks=1] - Prints the opening hours for the "Parnassus Library" for the next week (starting today).

API

This plugin also exposes opening hours via a read-only, public API endpoint.

Requesting the path /wp-admin/admin-ajax.php?action=wplibcalhours on your site will yield a JSON-formatted payload comprised of dates and opening hours, keyed by their location names.

These lists are sorted in chronological order and contain day-of-the-week, date and the day's opening hours information.

Each list starts with the current date.

Example payload

Three locations, the current date is January 3rd.

{
  "Parnassus Library": [
    {
      "day": "Wed",
      "date": "Jan 3",
      "text": "7:45am - 10pm"
    },
    {
      "day": "Thu",
      "date": "Jan 4",
      "text": "7:45am - 10pm"
    }
    /* ... */
  ],
  "Mission Bay Library": [
    {
      "day": "Wed",
      "date": "Jan 3",
      "text": "9am - 6pm"
    },
    {
      "day": "Thu",
      "date": "Jan 4",
      "text": "9am - 6pm"
    }
    /* ... */
  ],
  "Mission Bay Hub": [
    {
      "day": "Wed",
      "date": "Jan 3",
      "text": "24 hours"
    },
    {
      "day": "Thu",
      "date": "Jan 4",
      "text": "24 hours"
    }
    /* ... */
  ]
}

Styling

Please see this Wiki page for ideas on how to customize the styles of this plugin's generated markup.

Attribution

This plugin was created using WordPress Plugin Boilerplate.

Copyright and License

Copyright (c) 2017 The Regents of the University of California

This is Open Source Software, published under the MIT license.