Quickstart

Create a your app with recomendations in just 9 steps. Steps from 1. to 6. creates a full functional Facebook app. Steps from 7. to 8. integrates Eltanin EYE into your Facebook app. At step 9 you will have a fully functional app with recommendations for you and your friends based in their Facebook profiles.

Create a demo app in 9 steps

Heroku and Facebook have an agreement to ease the deployment and creation of Facebook applications. Using this agreement you can have an application ready using Eltanin Eye in less than 5 minutes.

Demo App

Start

1. Become Facebook developer

Register as a Facebook developer in https://developers.facebook.com/apps.

Facebook register as a Developer

Verify your facebook account. Provide your phone number, or any other requested data. Remember to keep your phone number as private if you want it.

Facebook verifies your Account

Now you are a Facebook developer.

Facebook verifies your Account

2. Create a Facebook app

Create a new Facebook app at https://developers.facebook.com/apps.

Facebook verifies your Account

Set a valid app name, and check web hosting with Heroku.

Create a Facebook Heroku app

Select the environment with any of supported languages in this tutorial, PHP for example. Provide a email address for your Heroku account. If you have already a heroku account, make sure to use your heroku account email.

Select environment and Heroku Account

You have now a sample app. Visit it by clicking in go to app button.

You have a Facebook/Heroku app

Write down of your app path and name. It looks like an URL as https://your-app-1234.herokuapp.com. In this case your app name is your-app-1234.

You have a Facebook/Heroku app

3. Set-up the Heroku account

Review your email. You have received an email with a link to set up your account. As alternative method you can login using http://www.heroku.com. Set your password and enter to your dashboard.

Welcome to Heroku

4. Install the Heroku Toolbelt

Download the toolbelt from the dashboard https://dashboard.heroku.com or from https://toolbelt.heroku.com.

Dashboard download Heroku Toolbelt

Install it. It provides git, a heroku client, foreman and ruby tools.

Toolbelt installed

5. Command-line login in Heroku

Login in Heroku from command line. Use the command heroku login.

Terminal login in heroku

This tool creates a SSH key to make secure connections if there is none. If you have more than one Heroku account you cannot share it between two accounts. Look at Heroku docs to learn how to handle this.

6. Clone your app

Clone your app in your workstation.

:::term
$ heroku clone --app your-app-1234
Cloning from app 'your-app-1234'...
Cloning into 'your-app-1234'...
The authenticity of host 'heroku.com (50.19.89.121)' can't be established.
RSA key fingerprint is 12:34:56:78:90:ab:cd:ef:1a:2b:3c:4e:5d:6e:7f:aa.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'heroku,50.19.89.121' (RSA) to the list of known hosts.
remote: Counting objects: 180, done.
remote: Compressing objects: 100% (112/112), done.
remote: Total 180 (delta 82), reused 132 (delta 62)
Receiving objects: 100% (180/180), 167.31 KiB | 160 KiB/s, done.
Resolving deltas: 100% (82/82), done.

Your app is at directory your-app-1234. Enter to this directory.

:::term
$ cd your-app-1234

7. Add the Eltanin add-on

Add to your app the Eltanin add-on.

:::term
$ heroku addons:add eltanin

Look heroku Eltanin add-on page for more details.

8a. Edit with PHP

Download the quick start with PHP files and replace the originals.

:::term
$ wget http://www.eltanin-eye.com/downloads/qs-php.zip
$ unzip -o qs-php.zip

Deploy on Heroku

Push the modified code up to Heroku with git:

:::term 
$ git add Eltanin.php
$ git commit -am "**Eltanin Eye** Quick Start"
$ git push heroku

8b. Edit with Ruby

Download the quick start with Ruby files and replace the originals.

:::term
$ wget http://www.eltanin-eye.com/downloads/qs-ruby.zip
$ unzip -o qs-ruby.zip

Add dependences

Install the gem eltanin for workstation testing:

:::term
$ sudo gem install eltanin

And add the gem eltanin to the Gemfile file and regenerate Gemfile.lock for the Heroku deployment:

:::term
$ echo 'gem "eltanin"' >> Gemfile
$ bundle install

Deploy on Heroku

Push the modified code up to Heroku with git:

:::term 
$ git commit -am "**Eltanin Eye** Quick Start"
$ git push heroku

9. Your app is Ready

Congratulations, your app is ready.

Load the app in your browser (which URL will look like https://your-app-1234.herokuapp.com). You will see the sample app.

This example app has three products and your friends. It is designed as a demonstration and learning puroposes. The app emulates multiple logins with each of your friends using your credentials to obtain their profiles. You can choose for each of them one, and only one, product. Eltanin Eye will provide of recommendations for your friends based on their profiles and your choices.

Learn more

The article Getting Started with Your Facebook App on Heroku is a step by step tutorial about how to deploy and edit a Facebook app. You can use it in order to configure your apps to run locally in your development environment.

You can find a full guide of the API here.

For an detailed explanation about the quickstart example implementation and how to create a production/development environment, please:

Take a look to the readme »