How to Import Events into the Listeo Theme (Eventbrite, Facebook, Meetup and iCal)
Listeo is a favourite for directory sites with bookings and listings. Adding events to it makes the site more useful, because visitors can find things to do alongside the places and services you already list. The catch is the effort. Every event needs its own listing, with a title, dates, an address, a map position and an image, and creating them one by one takes time.
The WPEA Listeo Addon lets WP Event Aggregator do the typing. It brings events from Eventbrite, Facebook, Meetup and iCal into Listeo as event listings, with the details placed in the fields Listeo uses. The addon documentation is a handy second reference.
What Your Visitors Will See
Each imported event becomes a Listeo listing with the event listing type. Visitors get:
- The event title and description.
- The event image, shown as the listing image and in its gallery.
- The start and end date and time, and the timezone.
- The venue name and full address, with a map position when the source provides coordinates.
- The event category you chose when importing.
- A link to the original event page in the listing’s website field.
What You Need
- WP Event Aggregator
- WP Event Aggregator Pro
- The Listeo theme, active, together with its Listeo Core plugin
- The WPEA Listeo Addon
If something is missing, the addon shows a notice in your dashboard that tells you what to install or activate.
Setup in Three Steps
Step 1: Activate your license
Go to WP Event Aggregator → Listeo Theme Addon License and enter your license key so the addon can receive updates.
Step 2: Connect your source
Open WP Event Aggregator → Settings and connect the source you plan to use. Eventbrite, Facebook and Meetup each need a quick connection, such as a token or app credentials. iCal needs none. The WP Event Aggregator documentation explains each one.
Step 3: Choose Listeo as the destination
Open the import tab for your source and find Import Into. Select Listeo Theme, pick an event category and a status, and run the import. Imported events arrive as pending unless you choose another status, so you can review them first.
Where Can the Events Come From?
- Eventbrite by Event ID, Organizer ID or Collection ID
- Facebook by Event ID or Facebook Page
- Meetup by Event ID or Group URL
- iCal from an .ics file, an iCal URL or an Outlook Calendar
- CSV, XML and JSON files using the file import in WP Event Aggregator Pro
For sources you want to follow over time, choose a scheduled import and set it to run hourly, twice daily, daily, weekly or monthly.
After the Import: A Two-Minute Review
Open Listings in your dashboard and check one imported event:
- Dates and timezone. Make sure they match the source.
- Address and map. Confirm the pin is in the right place.
- Category and image. Check that the event is in the right category and the image looks good.
- Featured and verified badges. Imported events are marked as featured and verified listings, so remove those on any events you do not want highlighted.
- Status. Publish the events once you are happy.
Good to Know
- Each import creates single events. Repeating events from a source are not set up as repeating events in Listeo.
- Organizer details (name, email and website) are stored with the event, but Listeo does not show them on the page automatically.
- Without Update existing events turned on for the source, events already on your site are skipped when you import again. Turn it on if you want changes at the source to come through.
Frequently Asked Questions
Do I need WP Event Aggregator Pro?
Yes. The addon asks for WP Event Aggregator Pro in addition to the free plugin.
Does it work without the Listeo theme?
No. It is built for Listeo and needs the theme and its Listeo Core plugin to be active.
Which sources can I use?
Eventbrite, Facebook, Meetup, iCal, and CSV, XML and JSON files.
Can I choose the category for imported events?
Yes. You pick the event category in the import form.
Can imports run automatically?
Yes. Use a scheduled import and choose how often it should run.
Will events be published straight away?
Only if you choose that status. They default to pending.
Wrapping Up
With the addon active, adding events to your Listeo site takes a few clicks: choose a source, select Listeo Theme under Import Into, pick a category and import. Review one event, then scale up with organizer, page, group or feed imports and put them on a schedule.
For more detail, see the Listeo addon docs and the WP Event Aggregator docs, or visit the WPEA Listeo Addon page and the WP Event Aggregator page.
