Buyers / Clients English WordPress Plugin

Add to Calendar for Listeo: Client Guide

Setup and operating guide for one-click calendar buttons on Listeo event listings, including providers, display positions, shortcodes, and event data requirements.

Add to Calendar for Listeo Version 1.0 13 min read Updated Jun 30, 2026

Plain-English summary

Add to Calendar for Listeo adds a visitor-facing calendar button to Listeo event listings. Visitors can save the event to Google Calendar, Apple Calendar, Outlook, Office 365, Yahoo Calendar, or download an ICS file.

What this plugin does

Add to Calendar for Listeo helps visitors save Listeo event listings to their personal calendar. The plugin reads event data from the listing, builds calendar provider links, and shows a dropdown button on the listing page.

The plugin works best with Listeo listings that have event date data. If a listing has no valid event date, the calendar button will not appear for normal visitors.

Calendar providers

Google Calendar, Apple Calendar, Outlook.com, Office 365, Yahoo Calendar, and ICS downloads.

Flexible placement

Show the button after the title, in the sidebar, before content, after content, or by shortcode only.

Event listings

Uses Listeo event date fields, listing title, description, address, permalink, and optional coordinates.

Requirements

WordPress 5.8 or newer.
PHP 7.4 or newer.
Listeo Core active.
Listeo listings available under the listing post type.
At least one event listing with an event date.
Administrator access to configure the plugin.
A valid license if your package requires activation.

Install and activate

Upload the plugin. Go to Plugins > Add New > Upload Plugin and upload the ZIP file.
Activate it. Click Activate after WordPress finishes installing it.
Open the plugin screen. Go to ListingPilot > Add to Calendar.
Activate the license. Open License, enter your key, and activate it if required.
Save settings. Open Settings, review the defaults, and save.

Configure the button

Open ListingPilot > Add to Calendar > Settings. These settings control where the button appears and which calendar options visitors see.

Setting	What it controls	Default
Enable Add to Calendar	Turns the frontend button on or off.	Enabled
Button Text	The label visitors see on the button.	Add to Calendar
Show Icon	Shows or hides the calendar icon inside the button.	Enabled
Button Position	Controls where the button appears on single listing pages.	After title
Button Style	Visual style of the button.	Primary
Listing Types	Which Listeo listing types can show the button.	Event

Choose button position

After title

Shows the button in the listing title/tag area. This is the default and usually the best starting point.

Sidebar

Shows a boxed widget at the top of the listing sidebar.

Before content

Shows the button before the listing content area.

After content

Shows the button after the listing content area.

Shortcode only

Disables automatic insertion. Use this when you want full manual control.

Calendar providers

You can choose which providers appear in the dropdown. Disable providers you do not want visitors to use.

Google Calendar: opens Google Calendar in a new tab with event details filled in.
Apple Calendar: downloads an ICS file that Apple Calendar can import.
Outlook.com: opens Outlook.com event creation.
Office 365: opens Office 365 calendar event creation.
Yahoo Calendar: opens Yahoo Calendar event creation.
Download .ics file: downloads the event as a standard calendar file.

Prepare event listings

The plugin needs valid event data from the listing. It uses these fields when available:

Listing data	Used for
Listing title	Calendar event title.
Event date	Calendar start date/time.
Event end date	Calendar end date/time. If missing, the plugin uses one hour after the start.
Listing timezone	Calendar display timezone. If missing, WordPress timezone is used.
Excerpt or content	Calendar event description.
Friendly address or address	Calendar event location.
Latitude and longitude	Optional geo coordinates in the ICS file.
Listing permalink	More info link inside calendar details.

No date means no public button

If the listing has no event date or the date cannot be parsed, the plugin does not show a normal visitor-facing button.

Use the shortcode

Use the shortcode when the Button Position is set to Shortcode only, or when you want to place the button manually in a page, template, or content block.

[listeo_add_to_calendar listing_id="123"]
[listeo_add_to_calendar listing_id="123" button_text="Save Event" show_icon="true"]

Attribute	Purpose
`listing_id`	The listing that provides event data. If omitted, the current post ID is used.
`button_text`	Overrides the button label for that shortcode instance.
`show_icon`	Use `true` or `false`.

Event archive shortcode

The plugin also includes an archive shortcode that lists event listings with calendar buttons.

[listeo_atc_archive]
[listeo_atc_archive limit="20" listing_type="event"]

This shortcode searches published listings with event dates. If a listing type is provided, it limits results to that listing type.

ICS download links

ICS downloads use clean URLs like this:

/calendar/event-slug.ics?t=generated-token

The token protects the download URL. If visitors see a 403 error for an ICS link, regenerate the visible link by reloading the listing page and avoid copying old URLs manually.

Testing checklist

Listeo Core is active.
The plugin is enabled in Add to Calendar settings.
The listing is published.
The listing has a valid event date.
The listing type is allowed in plugin settings, or the listing has event date data.
At least one calendar provider is enabled.
The button opens and the dropdown is not hidden behind the theme header/sidebar.
Google, Outlook, Office 365, Yahoo, and ICS links open or download correctly.

Troubleshooting

Problem	Most likely cause	Fix
The button does not appear.	The plugin is disabled, Listeo Core is inactive, the listing is not an event, or the event date is missing.	Enable the plugin, confirm Listeo Core, and add a valid event date.
The button appears in the wrong place.	The selected Button Position does not match the current listing template.	Try Sidebar or Shortcode only for more predictable placement.
Calendar links open with the wrong time.	WordPress timezone or listing timezone is incorrect.	Check WordPress timezone and any listing-specific timezone field.
ICS download returns 403.	The token in the link is invalid or old.	Reload the listing page and use the current download link.
The dropdown is clipped or hidden.	Theme layout, sticky header, or overflow rules affect the dropdown.	Update the plugin and clear cache. The frontend script portals the dropdown to reduce clipping.

Support handoff

When contacting support, include the site URL, plugin version, Listeo version, the affected listing URL, screenshots of Add to Calendar settings, and the exact calendar provider that fails.