Facebook integration with ionic framework

In this module, you add Facebook integration to your application. You allow users to login with Facebook, view their profile, and share their favorite sessions on their feed.

In this tutorial, you use OpenFB to perform the integration. OpenFB is a micro-library that lets you integrate your JavaScript applications with Facebook. It works for both browser-based and Cordova/PhoneGap apps. It also doesn't have any dependency: You don't need the Facebook plugin when running in Cordova. You also don't need the Facebook SDK. More information here.

Step 1: Create a Facebook application

1. Login to Facebook
2. Access https://developers.facebook.com/apps, and click Add New App
3. Select www as the platform
4. Type a unique name for your app and click Create New Facebook App ID
5. Specify a Category, and click Create App ID
6. Click My Apps in the menu and select the app you just created
7. Click Settings in the left navigation
8. Click the Advanced Tab
9. In the OAuth Settings section, add the following URLs in the Valid OAuth redirect URIs field:
   • http://localhost:8100/oauthcallback.html (for access using ionic serve)
   • https://www.facebook.com/connect/login_success.html (for access from Cordova)
10. Click Save Changes

Step 2: Initialize OpenFB

1. Add the OpenFB files to your application
   • Copy openfb.js and ngopenfb.js from ionic-tutorial/resources to conference/www/js.
   • Copy oauthcallback.html and logoutcallback.html from ionic-tutorial/resources toconference/www.
   • In conference/www/index.html, add script tags to include openfb.js and ngopenfb.js (before app.js):

     <script src="js/openfb.js"></script>
     <script src="js/ngopenfb.js"></script>
     

     ngOpenFB is just an Angular wrapper around the OpenFB library. It lets you use OpenFB "the Angular way": as an Angular service (called ngFB) instead of a global object, and using promises instead of callbacks.

2. Open conference/www/js/app.js, and add ngOpenFB as a dependency to the starter module:

   angular.module('starter', ['ionic', 'starter.controllers', 'ngOpenFB'])
   

3. Inject ngFB in the run() function declaration:

   .run(function ($ionicPlatform, ngFB) {
   

4. Initialize OpenFB on the first line of the run() function. Replace YOUR_FB_APP_ID with the App ID of your Facebook application.

   ngFB.init({appId: 'YOUR_FB_APP_ID'});
   

Step 3: Add Facebook login

1. Open login.html in the conference/www/templates directory. Add a Login with Facebook button right after the existing Log In button:

   <label class="item">
       <button class="button button-block button-positive" ng-click="fbLogin()">
       Login with Facebook
       </button>
   </label>
   

   Notice that fbLogin() is called on ng-click. You define the fbLogin() function in the next step.

2. Open conference/www/js/controllers.js, and add ngOpenFB as a dependency to the starter.controllersmodule:

   angular.module('starter.controllers', ['starter.services', 'ngOpenFB'])
   

3. Inject ngFB in the AppCtrl controller:

   .controller('AppCtrl', function ($scope, $ionicModal, $timeout, ngFB) {
   

4. Add the fbLogin function in the AppCtrl controller (right after the doLogin function):

   $scope.fbLogin = function () {
       ngFB.login({scope: 'email,read_stream,publish_actions'}).then(
           function (response) {
               if (response.status === 'connected') {
                   console.log('Facebook login succeeded');
                   $scope.closeLogin();
               } else {
                   alert('Facebook login failed');
               }
           });
   };
   

5. Test the application.
   • Make sure ionic serve (your local web server) is still running. If it's running but you closed your app page in the browser, you can reload the app by accessing the following URL: http://localhost:8100. If it's not running, open a command prompt, navigate (cd) to the ionic-tutorial directory and type:

     ionic serve
     

   • In the application, open the side menu and select Login
   • Click the Login with Facebook button
   • Enter your Facebook credentials on the Facebook login screen, and authorize the application
   • Open the browser console: you should see the Facebook login succeeded message

   The next time you login, you won't be asked for your credentials again since you already have a valid token. To test the login process again, simply logout from Facebook. The OpenFB library has additional methods to logout and revoke permissions that are beyond the scope of this tutorial.

Step 4: Display the User Profile

1. Create a template for the user profile view. In the conference/www/templates directory, create a new file named profile.html and implement it as follows:

   <ion-view view-title="Profile">
       <ion-content class="has-header">
           <div class="list card">
               <div class="item">
                   <h2>{{user.name}}</h2>
                   <p>{{user.city}}</p>
               </div>
               <div class="item item-body">
                   <img src="http://graph.facebook.com/{{user.id}}/picture?width=270&height=270"/>
               </div>
           </div>
       </ion-content>
   </ion-view>
   

2. Create a controller for the user profile view. Open controllers.js, and add the following controller:

   .controller('ProfileCtrl', function ($scope, ngFB) {
       ngFB.api({
           path: '/me',
           params: {fields: 'id,name'}
       }).then(
           function (user) {
               $scope.user = user;
           },
           function (error) {
               alert('Facebook error: ' + error.error_description);
           });
   });
   

3. Create a route for the user profile view. Open app.js, and add the following route:

   .state('app.profile', {
       url: "/profile",
       views: {
           'menuContent': {
               templateUrl: "templates/profile.html",
               controller: "ProfileCtrl"
           }
       }
   })
   

4. Open www/templates/menu.html, and add the following menu item:

   <ion-item menu-close href="#/app/profile">
       Profile
   </ion-item>
   

5. Test the application:
   • Make sure ionic serve (your local web server) is still running. If it's running but you closed your app page in the browser, you can reload the app by accessing the following URL: http://localhost:8100. If it's not running, open a command prompt, navigate (cd) to the ionic-tutorial directory and type:

     ionic serve
     

   • Open the side menu and select Login
   • Login with Facebook
   • Open the side menu and select Profile

Step 5: Publish to your feed

1. Open controllers.js, and inject ngFB in the SessionCtrl definition:

   .controller('SessionCtrl', function ($scope, $stateParams, Session, ngFB) {
   

2. Add a share() function to the SessionCtrl controller:

   $scope.share = function (event) {
       ngFB.api({
           method: 'POST',
           path: '/me/feed',
           params: {
               message: "I'll be attending: '" + $scope.session.title + "' by " +
               $scope.session.speaker
           }
       }).then(
           function () {
               alert('The session was shared on Facebook');
           },
           function () {
               alert('An error occurred while sharing this session on Facebook');
           });
   };
   

3. Open session.html in the templates directory and add an ng-click handler to the Share button: invoke the share function:

   <a class="tab-item" ng-click="share()">
       <i class="icon ion-share"></i>
       Share
   </a>
   

4. Test the application:
   • Make sure ionic serve (your local web server) is still running. If it's running but you closed your app page in the browser, you can reload the app by accessing the following URL: http://localhost:8100. If it's not running, open a command prompt, navigate (cd) to the ionic-tutorial directory and type:

     ionic serve
     

   • Open the side menu and select Login
   • Login with Facebook
   • Open the side menu, select Sessions, and select a session in the list
   • Click/Tap the Share button
   • Check your feed on Facebook

Step 6: Test Facebook integration on device (optional)

1. Add the InAppBrowser plugin used by OpenFB when running in Cordova. On the command line, navigate to the ionic-tutorial/conference directory and type:

   cordova plugins add org.apache.cordova.inappbrowser
   

2. Build your application for a specific platform following the steps described in module 8:

   ionic build ios
   

   and/or

   ionic build android
   

   If the build fails after adding the plugin, try removing and re-adding the platform. For example:

   ionic platform remove ios
   ionic platform add ios
   ionic build ios
   

3. Run and test your application on an iOS or Android device or emulator

This blog post was written by RajeshKumar - at Jempoints. For more on how to design and clarifications on Digital and Mobility contact us at www.jempoints.com

Install and create project in ionic framework

Step 1: Install Ionic

In this module, you install the Ionic Framework and Cordova using npm (the Node Package Manager).

Steps

1. Make sure you have an up-to-date version of Node.js installed on your system. If you don't have Node.js installed, you can install it from here.
2. Open a terminal window (Mac) or a command window (Windows), and install Cordova and Ionic:

   npm install -g cordova ionic
   

   On a Mac, you may have to use sudo depending on your system configuration:

   sudo npm install -g cordova ionic
   

3. If you already have Cordova and Ionic installed on your computer, make sure you update to the latest version:

   npm update -g cordova ionic
   

   or

   sudo npm update -g cordova ionic

step 2: Starting the Node Server

In this module, you install and start a Node.js server that exposes the conference data (sessions and speakers) through a set of REST services.

Steps

1. Download the supporting files for this tutorial here, or clone the repository:

   git clone https://github.com/ccoenraets/ionic-tutorial
   

   If you downloaded the zip file, unzip it anywhere on your file system.

2. Open a terminal window (Mac) or a command window (Windows), and navigate (cd) to the ionic-tutorial/serverdirectory
3. Install the server dependencies:

   npm install
   

4. Start the server:

   node server
   

   If you get an error, make sure you don't have another server listening on port 5000.

5. Test the REST services. Open a browser and access the following URLs:
• http://localhost:5000/sessions (for a list of conference sessions returned as a JSON document)
• http://localhost:5000/sessions/1 (for information about a specific session )

step 3: Creating an Ionic Application

In this module, you use the Ionic CLI (command line interface) to create a new application based on the sidemenu starter app.

Steps

1. Open a new terminal window (Mac) or a command window (Windows), and navigate (cd) to the ionic-tutorialdirectory
2. Using the Ionic CLI, create an application named conference based on the sidemenu starter app:

   ionic start conference sidemenu
   

3. Navigate to the conference folder

   cd conference
   

4. Start the application in a browser using ionic serve.

   ionic serve
   

   NOTE: Because of cross domain policy issues (specifically when loading templates), you have to load the application from a server (using the http protocol and not the file protocol). ionic serve is a lightweight local web server with live reload.

5. In the application, open the side menu ("hamburger" icon in the upper left corner) and select Playlists. Select a playlist in the list to see the details view (not much to see at this point).
   In the next modules, you will replace the playlists with a list of conference sessions retrieved from the server using the REST services you experimented with in the previous module.
6. Open the side menu again and select Login. Click the Login button to close the window (Login is not implemented in the starter app).
   In the last module of this tutorial you will implement Login using Facebook.

step 4: Creating the Session Service

In the sidemenu starter app, the playlists are hardcoded in controllers.js. In this module, you create a Session service that uses the Angular resource module (ngResource) to retrieve the conference sessions using REST services.

Steps

1. In the conference/www/js directory, create a file named services.js
2. In services.js, define a module named starter.services with a dependency on ngResource:

   angular.module('starter.services', ['ngResource'])
   

3. In that module, define a service named Session that uses the Angular resource module to provide access to the REST services at the specified endpoint:

   angular.module('starter.services', ['ngResource'])
   
   .factory('Session', function ($resource) {
       return $resource('http://localhost:5000/sessions/:sessionId');
   });
   

   In a real-life application, you would typically externalize the server parameters in a config module.

4. The starter.services module you just created has a dependency on the Angular resource module which is not included by default. Open index.html and add a script tag to include angular-resource.min.js (right after ionic-bundle.js):

   <script src="lib/ionic/js/angular/angular-resource.min.js"></script>
   

5. Add a script tag to include the services.js file you just created (right after app.js):

   <script src="js/services.js"></script>

step 5: Creating the Session Controllers

AngularJS controllers act as the glue between views and services. A controller often invokes a method in a service to get data that it stores in a scope variable so that it can be displayed by the view. In this module, you create two controllers: SessionsCtrl manages the session list view, and SessionCtrl manages the session details view.

Step 1: Declare starter.services as a Dependency

The two controllers you create in this module use the Session service defined in the starter.services module. To add starter.services as a dependency to the starter.controller module:

1. Open conference/www/js/controllers.js
2. Add starter.services as a dependency to make the Session service available to the controllers:

   angular.module('starter.controllers', ['starter.services'])
   

Step 2: Implement the Session List Controller

1. In controllers.js, delete PlayListsCtrl (plural)
2. Replace it with a controller named SessionsCtrl that retrieves the list of conference sessions using the Session service and stores it in a scope variable named sessions:

   .controller('SessionsCtrl', function($scope, Session) {
       $scope.sessions = Session.query();
   })
   

Step 3: Implement the Session Details Controller

1. In controllers.js, delete PlayListCtrl (singular)
2. Replace it with a controller named SessionCtrl that retrieves a specific session using the Session service and stores it in a scope variable named session:

   .controller('SessionCtrl', function($scope, $stateParams, Session) {
       $scope.session = Session.get({sessionId: $stateParams.sessionId});
   });
   

step 6: Creating Templates

In this module, you create two templates: sessions.html to display a list of sessions, and session.html to display the details of a particular session.

Step 1: Create the sessions template

1. In the conference/www/templates directory, rename playlists.html (plural) to sessions.html
2. Implement the template as follows:

   <ion-view view-title="Sessions">
     <ion-content>
       <ion-list>
         <ion-item ng-repeat="session in sessions"
                   href="#/app/sessions/{{session.id}}">{{session.title}}</ion-item>
       </ion-list>
     </ion-content>
   </ion-view>
   

   Notice the use of the ng-repeat directive to display the list of sessions

Step 2: Create the session template

1. Rename playlist.html (singular) to session.html
2. Implement the template as follows:

   <ion-view view-title="Session">
     <ion-content>
       <div class="list card">
         <div class="item">
           <h3>{{session.time}}</h3>
           <h2>{{session.title}}</h2>
           <p>{{session.speaker}}</p>
         </div>
         <div class="item item-body">
           <p>{{session.description}}</p>
         </div>
         <div class="item tabs tabs-secondary tabs-icon-left">
           <a class="tab-item">
             <i class="icon ion-thumbsup"></i>
             Like
           </a>
           <a class="tab-item">
             <i class="icon ion-chatbox"></i>
             Comment
           </a>
           <a class="tab-item">
             <i class="icon ion-share"></i>
             Share
           </a>
         </div>
       </div>
     </ion-content>
   </ion-view>
   

Module 7: Implementing Routing

In this module, you add two new routes (states) to the application: app.sessions loads the session list view, and app.session loads the session details view.

Step 1: Define the app.sessions route

1. Open app.js in conference/www/js
2. Delete the app.playlists state
3. Replace it with an app.sessions state defined as follows:

   .state('app.sessions', {
     url: "/sessions",
     views: {
         'menuContent': {
             templateUrl: "templates/sessions.html",
             controller: 'SessionsCtrl'
         }
     }
   })
   

Step 2: Define the app.session route

1. Delete the app.single state
2. Replace it with an app.session state defined as follows:

   .state('app.session', {
       url: "/sessions/:sessionId",
       views: {
           'menuContent': {
             templateUrl: "templates/session.html",
             controller: 'SessionCtrl'
         }
       }
   });
   

Step 3: Modify the default route

Modify the fallback route to default to the list of sessions (last line in app.js):

$urlRouterProvider.otherwise('/app/sessions');

Step 4: Modify the side menu

1. Open menu.html in conference/www/templates
2. Modify the Playlists menu item as follows (modify both the item label and the href):

   <ion-item menu-close href="#/app/sessions">
       Sessions
   </ion-item>
   

Step 5: Test the application

1. Make sure ionic serve (your local web server) is still running.
   • If it's running but you closed your app page in the browser, you can reload the app by loading the following URL: http://localhost:8100
   • If it's not running, open a command prompt, navigate (cd) to the ionic-tutorial directory and type:

     ionic serve
     

2. In the conference application, open the side menu ("Hamburger" icon in the upper left corner) and selectSessions. Select a session in the list to see the session details.

This blog post was written by RajeshKumar - at Jempoints. For more on how to design and clarifications on Digital and Mobility contact us at www.jempoints.com

IONIC INSTALL ON OSX / MAC

If you are like me and just starting to work with the Ionic Framework and don’t already have a machine setup to do Android, iOS, Node, etc development then many of the guides out there leave out a number of steps that you need to do in order to get everything working.
Even being a windows user I was able to pretty easily get Ionic working on a Mac. The only difference between the Windows setup and the OSx setup is that you can only add iOS to Ionic on a Mac.

Software to be installed

• NodeJS
• Ant
• JDK7
• Android SDK
• Android Studio
• Google Chrome
• Npm Modules: cordova, gulp and ionic
• Genymotion (Android emulator replacement)
• Webstorm (optional)
• Github for OSx (optional)
• XCode

General Install Steps

1. Install homebrew and node js via http://www.johnpapa.net/how-to-use-npm-global-without-sudo-on-osx/
2. NPM packages
   • npm install -g cordova
   • npm install -g ionic
   • npm install -g gulp
3. Google Chrome - Download from https://www.google.com/chrome/browser/desktop/

Android Setup Steps

1. JDK 7
   • Download from http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html
   • After install from the terminal create ~/.bash_profile if it doesn’t already exist. You can use touch ~/.bash_profile to create the file.
   • Open up either vi or nano and add the following line:

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.7.0_72.jdk/Contents/Home

1. Android Studio
   • Download from http://developer.android.com/sdk/index.html#Other
2. Ant
   • Download from http://ant.apache.org/bindownload.cgi
   • Unzip to /users/[Your Username]/Development/ into a apache-ant-1.9.4
   • Open ~/.bash_profile and add the following line:

export ANT_HOME=/users/jpjames/Development/apache-ant-1.9.4

1. Android SDK
   • Download from [http://developer.android.com/sdk/index.html#Other](http://developer.android.com/sdk/index.html#Other_
   • Unzip to /users/[Your username]/Development
   • Open ~/.bash_profile and add the following line:

export PATH=${PATH}:/users/[Your UserName/Development/android-sdk-macosx/tools:/users/[Your UserName/Development/android-sdk-macosx/platforms:${ANT_HOME}/bin

1. Download correct Android API
   • in terminal type source ~/.bash_profile to load the ~/.bash_profile changes.
   • type android from terminal. If everything is working correct it will open up the Android SDK Manager.
   • Install API 22 with SDK Platforms and Arm Image checked
2. Configure Android Emulator
   • In terminal type android avd. If everything is working correct it will open up the Android AVD Manager.
   • Click the create button and add at least 1 device to emulate
3. Configure Genymotion Setup
   • After Genymotion is installed, open up the Genymotion UI and click on the Add Button.
   • Then click the Sign in button and follow the login instructions to login with the account that you create as part of the Genymotion download.
   • After you are logged in, select from the Android Version drop down 4.4.4
   • From the Device model drop down select a device type
   • Then select a device from the available list
   • Click the Next button.
   • Click the Next button and wait for the device to download
   • Click the Finish button.

iOS Setup Steps

1. Install Xcode from app store. This will take awhile since it is ~2 gigs in size.
   • Once install is completed, open xcode and accept the license
2. Install the IOS Simulator that Ionic will use.

npm install -g ios-sim

Verifying that everything works

1. Open terminal
2. Navigate the directory where you store you development projects (I use /users/[Your Username]/projects)
3. From c:\projects type: ionic start todo blank
4. cd into c:\projects\todo (directory was created by the ionic start command)
5. Run the commands:

ionic platform add android
ionic platform add ios

1. Run the command:

ionic build android
ionic build ios

1. If using emulator run the command:
   • Note: The Genymotion emulator is seen as a device and not an emulator.

ionic emulate android
ionic emulate ios

1. If running on a device run the command:
   • For Android, if using the Genymotion emulator, make sure to start the Genymotion device you downloaded before running the command below. You can start the device by selecting the device that you downloaded and clicking the start button.
   • For iOS: In order to run on an iOS device you must go through the Apple provisioning process.

ionic run android
ionic run ios

• Tweet
• Share
• Share
• Share
• Share