Import Facebook events from an individual Facebook account to Wordpress posts. Then display them in a list or a map.
Allows you to:
- Download events that you've RSVP'd to from Facebook (including image)
- Automatically update if the Facebook event changes
- Add your own events
- Attempt to geocode events without a location using Google Places API
- Display todays events on a map using a shortcode using Google Maps API
- Display a list of events using a shortcode
Contributors: James Elks (jamesee)
Requires at least: 4.4
Tested up to: 4.9.4
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Tested with PHP 7.1.
- Download the master branch (.zip) from GitHub.
- Upload
elks-events
directory to the/wp-content/plugins/
directory - Activate the plugin through the 'Plugins' menu in WordPress
- Log in to Facebook
- Visit Facebook for developers
- Select My
Apps
>Add a new app
- Go to
Dashboard
- Copy your app ID and app secret into the Facebook Events settings page.
- Go to
Settings
- Add your domain to
App Domains
(e.g. test.com) - Select
Add platform
(at the bottom) - Select
Website
and add your domain (e.g. test.com)
-
Create a Google Maps Javascript API key
-
Copy the API key to the Facebook Events settings page.
-
Create a Google Places PI key
-
Copy the API key to the Facebook Events settings page.
Using the instructions above, you should now have your Google API keys, Facebook app ID and Facebook app secret in the plugin settings.
Configure the remaining fields using the instructions on the settings page.
Two shortcodes:
[e2_map_today]
to display a map of todays events.
[e2_list]
to display a list of events for the next time specified in settings. To limit the number of days to fetch events for, use get_days
variable. For example [e2_list get_days="7"]
would get todays events and then the next 6 days of events. [e2_list get_days="1"]
would show only events on today.
To stop an imported event updating when it's Facebook source event is updated:
Add a custom field with name e2_stop_update
and value true
. Note: if the custom field exists (with any value) the post will not be updated. So if you want the post to be updated again you'll need to delete the custom field from the post.
=1.2.2=
- Update to Facebook API version 2.12
=1.2.1=
- Import events marked 'unsure' as well as 'attending'
=1.2.0=
- Enable sorting of events by start date and location in admin
- Email administrator on Facebook import errors
- Check Facebook access token expiry and email administrator 10 days before
- Improve logging
= 1.1.0 =
- Renamed to 'My Facebook Events'
- Simplified manually adding a new custom event (not imported)
= 1.0.0 =
- Initial release. Functional.