=== Plugin Name ===
Plugin name: SFCe Create Event & Time Tools
Contributors: roggie
Donate link: http://www.rogerh.com/donate.html
Tags: Facebook, event, create
Requires at least: 2.7
Tested up to: 3.0.4
Stable:2.0

Adds PHP function to create Facebook events. This plugin requires the Simple Facebook Connect plugin by Otto. Use it within your theme or other plugins to create Facebook events containing data from your posts.

== Description ==

This plugin lets you create Facebook events from within your site's PHP code. It creates events in personal Facebook profiles, and can also create them for Facebook Pages.

To create a Facebook event with this plugin, simply call the SFCe function from within your site's PHP.

Provided the person using your site is "Connected to Facebook" using the SFC plugin, an event will be created in their Facebook profile or your Facebook Page. When the user is not logged into Facebook, the plugin does nothing. The plugin handles Facebook security properly, and will ask the user to authorize their Facebook app to create events if necessary.

For example, we use it to automatically create public Facebook events for our fan page when certain types of post are published. We also use it to create private Facebook events when other types of post are published.

This plugin requires Otto's Simple Facebook Connect (SFC) plugin is also installed in your WordPress site. Otto's SFC is an excellent set of plugins for integrating Facebook with your Wordpress site. Unfortunately Otto's SFC does not create Facebook Events.
 
<a href="http://www.thehypervisor.com/simple-facebook-connect-extensions">Changelog</a>

<a href="http://www.facebook.com/home.php?sk=lf#!/pages/The-Hypervisor/114689115238103">Follow me on Facebook</a href>

<a href="http://twitter.com/thehypervisor">Follow me on Twitter</a href>

== Installation ==

1. Unzip the sfce-create-event.zip in your Wordpress plugins directory.
2. Login to WordPress as an administrator, go to Plugins and Activate SFCe Facebook Time Tools and SFCe Create Events.
3. Call the sfce-create-event() function from within your site's PHP.

== Frequently Asked Questions ==

<strong>How do I create an array containing the event date/time etc?</strong>
There are several methods of doing this. We use the one below. Please note, in this example we pass some parameters as literal text (e.g. end_min). We pass other parameters as PHP variables (e.g. end_hour). And others we pass as data obtained from an HTML form (e.g. month):

if (function_exists('sfce_create_event') sfce_create_event( array(
				'name' => $name,
				'description' => $fbdescription,
				'host' => $host,
				'post_id' => $post_id,
				'tagline' => 'Let\'s Skate Together!',
				'is_fanpage' => TRUE,
				'privacy' => 'OPEN',
				'timezone' => 'Europe/London',
				'day' => $_POST['eday'],
				'month' => $_POST['emonth'],
				'year' => $_POST['eyear'],
				'start_hour' => $start_hour,
				'start_min' => '45',
				'end_hour' => $end_hour,
				'end_min' => '00')
				);

Note: Many parameters are optional, see the Facebook documentation (below) for a list of the required paramters.

<strong>Where is the Facebook documentation for creating events in this way?</strong>
http://wiki.developers.facebook.com/index.php/Events.create

<strong>The time/date for my events is wrong!</strong>
Facebook has some bugs affecting the time/date of events created using the Facebook API. Facebook API updates may fix or change this bug. If they do we will issue an update so events created with this plugin are correct.

http://bugs.developers.facebook.net/show_bug.cgi?id=7210

== Changelog ==

Click this link to see the <a href="http://www.thehypervisor.com/simple-facebook-connect-extensions">changelog</a>.