=== The Events Calendar: Facebook Events ===
Contributors: ModernTribe, barry.hughes, bordoni, borkweb, brianjessee, brook-tribe, faction23, geoffgraham, ggwicz, jazbek, jbrinley, joshlimecuda, leahkoerper, lucatume, mastromktg, mat-lipe, mdbitz, neillmcshea, nicosantos, peterchester, reid.peifer, roblagatta, ryancurban, shane.pearlman, thatdudebutch,  zbtirrell
Tags: modern tribe, tribe, facebook, events, calendar, recurring, event, venue, import, importer, api, dates, date, plugin, posts, conference, workshop, concert, meeting, seminar, summit, sync, social, FB
Donate link: http://m.tri.be/29
Requires at least: 3.9
Tested up to: 4.5.2
Stable tag: 4.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Import events into The Events Calendar from a Facebook organization or page.

== Description ==

With the Facebook Events add-on, you can tap into the growing number of events Facebook users are organizing by importing public events from a specific organization or page directly into your WordPress site.

Import individual Facebook events into <a href="http://m.tri.be/2x">The Events Calendar</a>, or choose to bulk import them from Facebook organization(s) or page(s) that you define. Imported events are automagically created as entries in The Events Calendar. Basic event data along with venue & organizer are populated appropriately. No more entering information in two places, or having to recreate someone else's listing for a public event you want to include on your WordPress calendar.

Make sure to get the free <a href="http://m.tri.be/2x">The Events Calendar</a> plugin first.

== Installation ==

= Install =

1. From the dashboard of your site, navigate to Plugins --> Add New.
2. Select the Upload option and hit "Choose File."
3. When the popup appears select the the-events-calendar-facebook.importer.x.x.zip file from your desktop. (The 'x.x' will change depending on the current version number).
4. Follow the on-screen instructions and wait as the upload completes.
5. When it's finished, activate the plugin via the prompt. A message will show confirming activation was successful.
6. For access to new updates, make sure you have added your valid License Key under Events --> Settings --> Licenses.

= Activate =

1. Activate from the plugins list as you would any other plugin.
2. Navigate to Events --> Settings and go to the Facebook tab.
3. Before you can do bulk import or automatically import events from Facebook, you'll need to get a Facebook ID and enter it here. Follow the instructions on the Facebook settings tab or check out <a href="http://m.tri.be/2y">our tutorial</a>.
4. Once you have your Facebook App ID and Facebook App Secret entered, you're ready to go.

= Requirements =

* PHP 5.2.4 or greater (recommended: PHP 5.4 or greater)
* WordPress 3.9 or above
* jQuery 1.11.x
* The Events Calendar 3.11 or above

== Frequently Asked Questions ==

1. Q: What is the Facebook App ID and App Secret, and where do I find them?

A: Facebook requires a Facebook App ID and App Secret to access data via the Facebook graph API in order to import your events from Facebook. Provided with the plugin is a default set of API credentials, however we encourage you to create your own Facebook App and enter your credentials on the settings page. For more, please see this tutorial: http://m.tri.be/2y.

2. Q: Where can I find a user's or page's username or ID?

A user's username or ID can be found in the URL used to access his or her profile. For example https://www.facebook.com/zuck is the URL used to access Mark Zuckerberg's profile. His username is 'zuck'. If a user doesn't have a username, you will see his or her ID (numerical)in the URL for his profile. The same concept applies to pages, you can find their username or ID in their URL. Modern Tribe's Page is https://www.facebook.com/ModernTribeInc and the username is 'ModernTribeInc'. You can also find the ID of a user or page by visiting the Graph API. For example, to find Modern Tribe's ID, visit https://graph.facebook.com/ModernTribeInc. You will get a json response with information about the user or page. The first result should be the ID.

3. Q: Where can I find an event's Facebook ID?

A: You can determine an event's Facebook ID by looking at the URL of the event. For example, the ID of this event: https://www.facebook.com/events/12345689 would be 123456789

4. Q: Where can I get support if I encounter problems or bugs?

A: Please visit the <a href="http://m.tri.be/2z">Facebook Events support forum.</a>

== Documentation ==

Check out <a href="http://m.tri.be/18w3">our knowledgebase</a> for tips, tutorials, walk throughs, snippets, and more. Developers can find our documentation <a href="http://m.tri.be/30">here</a>

For support, please see question #4 above. If you have any questions about the core The Events Calendar plugin, please take look at <a href="http://wordpress.org/support/plugin/the-events-calendar">the dedicated forum on WordPress.org</a>. Please search before opening a new thread.

== Contributors ==

The plugin is produced by <a href="http://m.tri.be/2s">Modern Tribe Inc</a>.

= Current Contributors =

<a href="https://profiles.wordpress.org/barryhughes">Barry Hughes</a>
<a href="https://profiles.wordpress.org/brianjessee">Brian Jessee</a>
<a href="https://profiles.wordpress.org/brook-tribe">Brook Harding</a>
<a href="https://profiles.wordpress.org/cliffpaulick">Clifford Paulick</a>
<a href="https://profiles.wordpress.org/MZAWeb">Daniel Dvorkin</a>
<a href="https://profiles.wordpress.org/geoffgraham">Geoff Graham</a>
<a href="https://profiles.wordpress.org/ggwicz">George Gecewicz</a>
<a href="https://profiles.wordpress.org/bordoni">Gustavo Bordoni</a>
<a href="https://profiles.wordpress.org/jazbek">Jessica Yazbek</a>
<a href="https://profiles.wordpress.org/joshlimecuda">Josh Mallard</a>
<a href="https://profiles.wordpress.org/leahkoerper">Leah Koerper</a>
<a href="https://profiles.wordpress.org/lucatume">Luca Tumedei</a>
<a href="https://profiles.wordpress.org/borkweb">Matthew Batchelder</a>
<a href="https://profiles.wordpress.org/neillmcshea">Neill McShea</a>
<a href="https://profiles.wordpress.org/mastromktg">Nick Mastromattei</a>
<a href="https://profiles.wordpress.org/nicosantos”>Nico Santo</a>
<a href="https://profiles.wordpress.org/peterchester">Peter Chester</a>
<a href="https://profiles.wordpress.org/roblagatta">Rob La Gatta</a>
<a href="https://profiles.wordpress.org/reid.peifer">Reid Peifer</a>
<a href="https://profiles.wordpress.org/shane.pearlman">Shane Pearlman</a>
<a href="https://profiles.wordpress.org/thatdudebutch">Wayne Stratton</a>
<a href="https://profiles.wordpress.org/zbtirrell">Zachary Tirrell</a>

= Past Contributors =

<a href="https://profiles.wordpress.org/caseypatrickdriscoll">Casey Driscoll</a>
<a href="https://profiles.wordpress.org/ckpicker">Casey Picker</a>
<a href="https://profiles.wordpress.org/dancameron">Dan Cameron</a>
<a href="https://profiles.wordpress.org/jkudish">Joachim Kudish</a>
<a href="https://profiles.wordpress.org/jgadbois">John Gadbois</a>
<a href="https://profiles.wordpress.org/jonahcoyote">Jonah West</a>
<a href="https://profiles.wordpress.org/jbrinley">Jonathan Brinley</a>
<a href="https://profiles.wordpress.org/justinendler/">Justin Endler</a>
<a href="https://profiles.wordpress.org/kellykathryn">Kelly Groves</a>
<a href="https://profiles.wordpress.org/kelseydamas">Kelsey Damas</a>
<a href="https://profiles.wordpress.org/kyleunzicker">Kyle Unzicker</a>
<a href="https://profiles.wordpress.org/mdbitz">Matthew Denton</a>
<a href="https://profiles.wordpress.org/mattwiebe">Matt Wiebe</a>
<a href="https://profiles.wordpress.org/mat-lipe">Mat Lipe</a>
<a href="https://profiles.wordpress.org/nickciske">Nick Ciske</a>
<a href="https://profiles.wordpress.org/paulhughes01">Paul Hughes</a>
<a href="https://profiles.wordpress.org/ryancurban">Ryan Urban</a>
<a href="https://profiles.wordpress.org/faction23">Samuel Estok</a>
<a href="https://profiles.wordpress.org/codearachnid">Timothy Wood</a>

= Translations =

Modern Tribe’s premium plugins are translated by volunteers at <a href=“http://m.tri.be/194h”>translations.theeventscalendar.com</a>. There you can find a list of available languages, download translation files, or help update the translations. Thank you to everyone who helps to maintain our translations!

== Add-Ons ==

But wait: there's more! We've got a whole stable of plugins available to help you be awesome at what you do. Check out a full list of the products below, and over at the <a href="http://m.tri.be/33">Modern Tribe website.</a>

Our Free Plugins:

* <a href="wordpress.org/plugins/the-events-calendar/" target="_blank">The Events Calendar</a>
* <a href="https://wordpress.org/plugins/event-tickets" target="_blank">Event Tickets</a>
* <a href="http://wordpress.org/extend/plugins/advanced-post-manager/" target="_blank">Advanced Post Manager</a>
* <a href="http://wordpress.org/plugins/blog-copier/" target="_blank">Blog Copier</a>
* <a href="http://wordpress.org/plugins/image-rotation-repair/" target="_blank">Image Rotation Widget</a>
* <a href="http://wordpress.org/plugins/widget-builder/" target="_blank">Widget Builder</a>

Our Premium Plugins:

* <a href="http://m.tri.be/2c" target="_blank">Events Calendar PRO</a>
* <a href="http://m.tri.be/18w5" target="_blank">Event Tickets Plus</a>
* <a href="http://m.tri.be/2e" target="_blank">The Events Calendar: Eventbrite Tickets</a>
* <a href="http://m.tri.be/2g" target="_blank">The Events Calendar: Community Events</a>
* <a href="http://m.tri.be/18w6" target="_blank">The Events Calendar: Community Tickets</a>
* <a href="http://m.tri.be/2h" target="_blank">The Events Calendar: Facebook Events</a>
* <a href="http://m.tri.be/fa" target="_blank">The Events Calendar: Filter Bar</a>
* <a href="http://m.tri.be/18ge" target="_blank">The Events Calendar: iCal Importer</a>

== Changelog ==

= [4.2] 2016-06-08 =

* Tweak - Language files in the `wp-content/languages/plugins` path will be loaded before attempting to load internal language files (Thank you to user @aafhhl for bringing this to our attention!)
* Tweak - Move plugin CSS to PostCSS

= [4.1] 2016-03-15 =

* Feature - When auto-import is enabled, the time of last import and the possible time of the next import is now displayed
* Fix - Resolved issue where some imported events would be duplicated during automated imports (Thanks to all who reported this in the forums and for bearing with us while we figured it out!)

= [4.0] 2015-12-02 =

* Feature - Added the option to re-synchronize an imported event by pulling in the latest information from the matching Facebook event (Thanks to Jon Martin for proposing this on UserVoice!)
* Tweak - Added tribe_events_facebook_event_created hook (provides Event ID, Organizer ID, and Venue ID as parameters) when an event is imported from Facebook

= [3.12] 2015-09-08 =

* Feature - Modified timezone handling to take advantage of new capabilities within The Events Calendar
* Fix - Fixed and removed some incorrectly exposed HTML from the admin environment

= [3.11.1] 2015-07-22 =

* Bug - Upgrading to Graph API v2.4 from v2.2 to fix bug caused by page requests failing using v2.2 (big thanks to media325 on the forums for the first report!)

= [3.11] 2015-07-22 =

* Security - Added escaping to a number of previously un-escaped values
* Tweak - Conformed code to updated coding standards
* Bug - Resolved bug where imported images were attached to posts with an improper file path

= [3.10] 2015-06-16 =

* Tweak - Plugin code has been refactored to new standards: that did result in a new file structure and many renamed classes. Old class names will be deprecated in future releases and, while still working as expected, you can keep track of any deprecated classes yours or third party plugins are calling using the Log Deprecated Notices plugin (https://wordpress.org/plugins/log-deprecated-notices/)
* Tweak - Enhanced the Facebook import process to help reduce the potential for timeouts when large numbers of events/pages need to be scanned (thanks to media325 for the first report of this!)
* Tweak - Added better error message when attempting to import events from age restricted pages
* Tweak - Added some changelog formatting enhancements after seeing keepachangelog.com :)

= 3.9.4 =

* Plugin is now using Facebook Graph API v2.2!


= 3.9.3 =

* Hardened URL output to protect against XSS attacks.

= 3.9.2 =

* Fixed a bug that kept venues from importing properly after a recent change in Facebook API (thanks to hellowebsites in the forum for letting us know!)

= 3.9.1 =

* Fixed a bug where an event could import with the date one day early (thanks to rebatch on the forums for the heads up!)
* Fixed a bug where imported images used same filename causing them to overwrite each other (thanks to honeyl on the forums for reporting this!)

= 3.9 =

* Fixed a bug preventing the import of some images from Facebook (thanks to ayatango on the forums for the initial report!)
* Incorporated new Russian translation files, courtesy of Evgenii Rybak
* Incorporated new Finnish translation files, courtesy of Mikko Seppälä

= 3.8.1 =

* Fix a bug causing events without a specific end time to be imported as all day events (our thanks to Christian Kramer	for highlighting this)

= 3.8 =

* Fixed a bug causing imported events to be assigned to the incorrect venue (thanks to n1112997 for the first report on the forums!)
* Fixed a bug preventing all day events from being imported correctly (thanks to socialist on the forum for this report!)
* Fixed a bug causing a notice-level error when plugin is used alongside Eventbrite Tickets
* Incorporated new Portuguese translation files, courtesy of Sérgio Leite
* Incorporated new Slovenian translation files, courtesy of Žiga Vajdic


= 3.7 =

* Incorporated new Chinese translation files, courtesy of Massound Huang
* Incorporated new Indonesian translation files, courtesy of Didik Priyanto
* Corrected textdomains for proper translations

= 3.6 =

* Fixed markup in the import form (thanks to both Malisa at ManageWP and geekteq)
* Fixed a bug where imported venues and organizers were left without a slug in some cases
* Incorporated updated Czech translation files, courtesy of Petr Bastan
* Incorporated updated French translation files, courtesy of Alaric Breithof

= 3.5 =

* Resolved a number of strict standard issues during imports
* Improved messaging when attempting to import from individual Facebook accounts
* Fixed an issue with cover image imports not working as expected (thanks to efromdc for the original report of this at the forums!)
* Incorporated new Italian translation files, courtesy of Daniel Tieghi
* Incorporated updated Romanian translation files, courtesy of Cosmin Vaman
* Incorporated new Norwegian Nynorsk translation files, courtesy of Torbjørn Lauen
* Incorporated new Dutch translation files, courtesy of J.F.M. Cornelissen
* Incorporated updated Spanish translation files, courtesy of Lorenzo Sastre Muntaner

= 3.4 =

* Addressed an issue where the Event Bar datepicker in the core TEC plugin faced infinite load issues on sites running Facebook Events with PHP 5.4
* Fixed a couple minor issues with wording on the Settings page

= 3.3 =

* Incorporated updated French translation files, courtesy of Bastien BC

= 3.2 =

* Adjusted the size of event featured image requested upon import to pull the maximum file size possible (thanks to Thomas on the forums for first reporting this!)
* Incorporated new French translation files, courtesy of Ali Senhaji

= 3.1 =

* Fix API photos URLs
* Fix timezone issues
* Updated translations: Brazilian Portuguese (new), Polish (new), Romanian (new)

= 3.0.1 =

* Improved error handling for Facebook event photos
* Performance improvements to the plugin update engine

= 3.0 =

Updated version number to 3.0.x for plugin version consistency

= 1.0.7 =

* Fix plugin update system on multisite installations

= 1.0.6 =

*Small features, UX and Content Tweaks:*

* We removed the default App Secret & App ID. Users will need to create a new Facebook App Secret/ID before they can continue using the plugin!
* Code modifications to ensure compatibility with The Events Calendar/Events Calendar PRO 3.0.
* Clarification tweaks to tooltips that appear within the plugin.
* Fixed a spelling error on the Import page (oops!).
* Incorporated new French translation files, courtesy of Frederic-Xavier DuBois.
* Incorporated new Dutch translation files, courtesy of Walter Fass.
* Incorporated new Swedish translation files, courtesy of Andreas Bodin.

*Bug Fixes:*

* Updated auto-import to work in all circumstances.
* Fatal errors no longer show when importing after a failed import of a private or all-day event.
* Fixed hour range events no longer import mislabeled as All Day.
* Nonexistent usernames no longer return an ugly error.
* When importing a picture from Facebook fails, it is now handled more gracefully than in previous versions.
* Import errors that arose with certain multi-day events are no longer appearing.

= 1.0.5 =

*Small features, UX and Content Tweaks:*

* Incorporated new Polish language files, courtesy of Marek Kosinski.

*Bug Fixes:*

* International time zones no longer converting to local times by default.
* Various improvements to handling of imports from one time zone into another one.
* Fixed an issue where images were failing to import or generating an error for certain users.
* Improved how plugin addresses venue imports to minimize duplicates (though note: Facebook's API is limited in such a way that we cannot cut out duplicate venues 100% at this time)
* Organizer phone number no longer displays as Facebook page's hovercard ID.
* Fixed an issue with unreachable code in Tribe__Events__Facebook__Importer::json_retrieve().
* Various improvements & enhancements to improve integration with the forthcoming The Events Calendar 3.0 release.

= 1.0.4 =

Minor tweaks to accommodate release of & ensure smooth integration with The Events Calendar 2.0.11 / Events Calendar PRO 2.0.11.

= 1.0.3 =

*Small features, UX and Content Tweaks:*

* Incorporated updated German translation files, courtesy of Mark Galliath.

*Bug Fixes:*

* Fixed an issue impacting some users (due to a recent change in the Facebook API) where attempting to import Facebook events yielded an error.

= 1.0.2 =

*Small features, UX and Content Tweaks:*

* Events that have passed no longer appear on the list of importable Facebook Events.
* Photos that are attached to Facebook Events are now carried over and set as featured image on your WordPress event.
* Plugin now provides written confirmation of how many events were imported with each manual import.
* Incorporated new German translation files, courtesy of Mark Galliath.
* Incorporated new Czech translation files, courtesy of Petr Bastan.

*Bug Fixes:*

* Deleted events no longer continue to be re-imported when auto import is enabled.
* Facebook user IDs with dashes are now accepted across the board.
* Fixed some untranslatable strings found in the 1.0.1 POT file.

= 1.0.1 =

*Bug Fixes:*

* Removed unclear/confusing message warning message regarding the need for plugin consistency and added clearer warnings with appropriate links when plugins or add-ons are out date.

= 1.0 =

* Initial release
