Axiom Vendor Calendar

Description

The Axiom Vendor Calendar plugin provides a seamless way for vendors participating in events managed by Axiom Event Systems to display their approved, upcoming event schedule on their own WordPress websites.

By pasting a single, secure API key generated from your Axiom Vendor Portal into the plugin settings, your website will automatically sync with your live event data. The plugin safely caches this data and respects API rate limits to ensure optimal performance.

Features

  • Plug-and-Play Setup: Just paste your Base64URL API key and the plugin handles the rest.
  • Multiple Layouts: Choose from a wide range of layouts to match your theme.
  • Automatic Syncing: Event data is cached and automatically refreshed every 12 hours.
  • Graceful Fallbacks: Handles API rate limits safely by serving cached data.
  • Zero Coding Required: Drop a simple shortcode into any page or post.
  • Shortcode Builder + Live Preview: Generate a shortcode from the settings page and preview it instantly before embedding.
  • Smarter Builder Controls: The shortcode builder hides irrelevant options based on the selected layout.

Shortcode Usage

You can display your events anywhere on your site using the [axiom_vendor_calendar] shortcode.

Available Layouts:

  1. [axiom_vendor_calendar layout="grid"] – A classic, responsive card grid showing event posters, dates, and locations. (Default)
  2. [axiom_vendor_calendar layout="list"] – A minimalist, horizontal row layout perfect for sidebars or footers.
  3. [axiom_vendor_calendar layout="calendar"] – An interactive monthly calendar grid with event previews.
  4. [axiom_vendor_calendar layout="mini-calendar"] – A compact monthly calendar with an “in this month” list underneath.
  5. [axiom_vendor_calendar layout="next-up"] – A prominent hero banner highlighting your very next upcoming event, complete with a live countdown timer.
  6. [axiom_vendor_calendar layout="carousel"] – A swipeable horizontal carousel of event cards.
  7. [axiom_vendor_calendar layout="masonry"] – A poster-wall masonry layout using responsive columns.
  8. [axiom_vendor_calendar layout="compact"] – A tight, sidebar-friendly list with optional thumbnails.
  9. [axiom_vendor_calendar layout="timeline"] – A modern timeline grouped by month.
  10. [axiom_vendor_calendar layout="grouped"] – A grouped list with month headings.
  11. [axiom_vendor_calendar layout="featured"] – A “featured + feed” layout: highlight the next 1–N events then show the rest below.
  12. [axiom_vendor_calendar layout="map"] – An interactive map (powered by Leaflet and OpenStreetMap) pinning all your upcoming event locations.
  13. [axiom_vendor_calendar layout="map-list"] – A map with a clickable list that focuses markers.

Additional Attributes:

  • limit="X" – Restrict the number of events displayed (e.g., [axiom_vendor_calendar layout="grid" limit="3"]).
  • image_fit="contain|cover" – Control how event images are scaled (default: contain).
  • aspect="W:H" – Control the media aspect ratio for grid cards and the Next Up hero (e.g., 16:9, 4:3).
  • columns="1-6" – Set a fixed column count for grid and masonry layouts.
  • show_images="0|1" – Show or hide images (default: 1).
  • show_date="0|1" – Show or hide the event date (default: 1).
  • show_location="0|1" – Show or hide the event location (default: 1).
  • group_by="month|none" – For timeline and grouped layouts: group events by month or show as a single group (default: month).
  • featured_count="N" – For featured layout: number of featured events (default: 1).
  • feed_layout="grid|list|compact" – For featured layout: choose how the remaining events are displayed (default: grid).

Installation

  1. Upload the axiom-vendor-calendar directory to the /wp-content/plugins/ directory, or install the plugin directly through the WordPress plugins screen.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress.
  3. Navigate to Axiom Vendor Calendar in your WordPress admin menu.
  4. Log into your Axiom Vendor Portal, navigate to the API tab in your profile, and click Copy API Key.
  5. Paste the API Key into the plugin settings and click Save Settings.
  6. (Optional) Click Test Connection & Fetch Events to verify the integration.
  7. Use the [axiom_vendor_calendar] shortcode on any post or page to display your events.

FAQ

Where do I find my API Key?

Log into your Axiom Vendor Portal, open your Vendor Profile, and navigate to the API tab. Click the “Generate API Key” button if you haven’t already, then click “Copy API Key”.

My events aren’t updating immediately after I pay for a booth. Why?

To ensure your website loads quickly, the plugin caches your event data for 12 hours. You can force an immediate update by going to the Axiom Vendor Calendar settings page in your WordPress admin and clicking Clear Cache.

What happens if I generate a new API key in the Axiom portal?

Your old API key will instantly stop working. You must copy the new API key and paste it into this plugin’s settings page to restore your calendar feed.

Can I use multiple layouts on the same page?

Yes! You can use the shortcode multiple times with different layout attributes. For example, you could put a next-up layout at the top of your page, and a grid layout below it.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Axiom Vendor Calendar” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

2.1.2

  • Improved the Shortcode Builder so options hide/show based on the selected layout.
  • Refined calendar and mini-calendar day tiles to use cleaner full-bleed hero imagery.
  • Updated map behavior to use a single pin per shared location, linked to the next upcoming event at that location.

2.1.1

  • Improved Plugin Checker compatibility for WordPress 5.0 installs.
  • Replaced newer unique ID usage with a compatibility-safe internal helper.
  • Hardened admin preview request handling and cleaned up escaped output in shortcode rendering.

2.1.0

  • Added additional layouts: carousel, masonry, compact, timeline, grouped, featured, mini-calendar, and map-list.
  • Added shortcode builder + live preview to the settings page.
  • Improved map initialization to support multiple embeds and map-list interaction.
  • Added new shortcode attributes for more control: columns, show_images, show_date, show_location, featured_count, feed_layout.

2.0.0

  • Major visual refresh across all layouts (grid, list, calendar, next-up, map).
  • Added per-shortcode display controls: image_fit and aspect.
  • Improved responsive image rendering for cards and hero.
  • Calendar days now show an event preview (thumbnail + title) instead of a plain dot.
  • Map pins now render reliably with modern SVG markers.

1.0.0

  • Initial release.
  • Added secure Base64URL API key decoding.
  • Included 5 responsive shortcode layouts (grid, list, calendar, next-up, map).
  • Implemented transient caching and rate limit handling.