For your app to work inside Facebook, you'll have to first create a Facebook Application.

1. Login to the Facebook developer section and create a new application.

   
   

2. You should arrive in the Settings > Basic section, where you can edit your app icon and name. These elements show up when users login to your site with Facebook for the first time.

   
   

3. In the App Domain section, add in the domain URL of your app which can be found in the Responding Domains section in the App Settings in Media Factory.
4. In the Website section below, enter the public URL of your UGC Contest website. If you have more than one URL, you'll need multiple Facebook Apps for login.
5. You will have to enter the canvas URL of your app in the App on Facebook section. This will be the same as your App Domain, except that you will have to add "http://" for the Canvas URL and "https://" for the Secure Canvas URL
6. Copy the App ID and App Secret keys and paste them into your UGC Contest application settings. See Responding Domains above.
7. Go to the Settings > Auth Dialogue section. Here, you can customize how the Auth Dialogue looks like by entering the details you need to show on it.

   
   

8. In the Configure how Facebook refers users to your app section, make sure you enter email, publish_actions in the "User & Friend Permissions field. In the "Extended Permissions" field, you must enter in publish_stream, offline_access.
9. Go to the Settings > Advanced section and make sure that you have a support email entered. This is a Facebook requirement.

   
   

Tip: You'll need to modify this Facebook application with your live URLs!

When a user submits an entry or adds a comment, they are prompted to add it to Facebook. You can change the default text that appears in the "entry" category of the Translator.

Variable	Default	Notes
facebookApp	on Filemobile's UGC Contest	The text that comes after the title when submitting a new entry.
facebookCaption	Comment on	When submitting a comment, this goes next to the title of the media the user is commenting on.
facebookComment	Your Facebook comment is	When adding a new comment
facebookEvent	uploaded	The text that comes before the entry title when uploading.

Tip: Create a Facebook alter-ego for testing

You are going to be testing the behaviour and copy of messages shared to Facebook. In order to avoid annoying your friends and spoiling the surprise for your sponsor, create a second or third Facebook account. Connect your alter-egos so you can see what the feed messages will look like.