Overview

This guide shows you how to create a login application on Twitter that allows students to log in to DigitalChalk with their Twitter account.

Create a Twitter Application

  1. Go to http://apps.twitter.com and log in with your normal Twitter account on the Twitter Apps page.

  1. Click the Create New App button.

  1. The Create an Application page is displayed.

  1. Enter a name for your application in the Name field.  This should be a name that students will recognize, such as your company name, since it is displayed on the page students see when they first log in to DigitalChalk using Twitter.
  2. Enter a description for your application in the Description field.  The description is displayed on the page the student sees when they first log in to DigitalChalk using Twitter.
  3. Enter the URL of your primary website (not your DigitalChalk site) in the Website field. For example “http://www.mycompany.com”. The website is displayed as a link on the page the student sees when they first log in to DigitalChalk using Twitter.
  4. Enter the following URL in the Callback URL field:

https://[myvirtualhost].digitalchalk.com/dc/signin/twitter

  1. Replace [myvirtualhost] with your DigitalChalk virtual host (for example, https://wayne.digitalchalk.com/dc/signin/twitter)
  2. Check Yes, I agree under the Developer Agreement section.
  3. Click the Create your Twitter Application button.
  4. The Dashboard for you new application is displayed with the Details page for the application.

  1. Click the Settings tab
  2. The Settings page is displayed. The Name, Description, Website, and Callback URL fields are filled in for you with the information you entered on the Create an application page.
  3. Check the Allow this application to be used to Sign in with Twitter checkbox.

The following fields are optional, but if you enter information in any of these fields, it is displayed on the page the students see when they first log in to DigitalChalk using Twitter.
  1. Click the Browse button in the Application Icon to select an image to upload as your company’s icon.  This logo is displayed when students log in to your application with Twitter.
  2. Enter your company name for Organization name and your primary website (not your DigitalChalk website) for Organization website.
  3. Click the Update Settings button.

  1. The Dashboard for your application is displayed.
  2. Click the Permissions tab.
  3. The Access page is displayed.
  4. Click the Read Only checkbox.
  5. Click the Update Settings button.

  1. The Dashboard for your application is displayed.
  2. Click the Keys and Access Tokens tab.
You don’t enter any information here, but be sure to note the values of the Consumer Key (API Key) field and the Consumer Secret (API Secret) field, as you will need them when you return to DigitalChalk to complete the setup of your Twitter application.

Configuring DigitalChalk to Use Your Twitter Application

In DigitalChalk, do the following:

  1. Click the Administration tab, then click My Organization from the System Management list.
  2. The Edit Organization Details page is displayed with a task list.
  3. Select Social Apps from the task list.

  1. The Social Applications page is displayed.
  2. Click on the Twitter logo.

  1. The Edit Social Application page for Twitter is displayed.

  1. Enter the Consumer Key and Consumer Secret values from the Keys and Access Tokens page of your Twitter application.  Leave the Project Name field blank.
  2. Select Yes for “Would you like to activate this social app for login”.  (For descriptions of other settings shown here, see Configuring Social Sites for Your Organization.)
  3. Click the Save button when you finish entering information for your Twitter application.
You have completed creating a Twitter login for your DigitalChalk organization. Your students can now log in to DigitalChalk using their Twitter account. If you have any questions, please contact DigitalChalk support for assistance.

4. How Your DigitalChalk Twitter Login Looks To a Student

When students first log in to your DigitalChalk site with Twitter, they must approve the application through Twitter. The page shown here is a sample of what students see the first time they log into DigitalChalk from Twitter. The red boxes show how your settings are displayed on the Twitter approval page.