© 2015 X2Engine Inc.

Google Integration

From X2Engine
Revision as of 01:23, 26 February 2013 by Demitri (talk | contribs) (Creating the API Project)
Jump to: navigation, search

Enabling Google Integration will let users synchronize their Google Calendars with content from their X2CRM user calendars. It will also allow them to log into X2CRM using their Google accounts.

Creating an API Project

To enable Google integration, you will first need to create a Google API project for your X2CRM installation by going to Google Console while logged into your Google account and clicking "Create Project". You should be directed to the Services tab, where you'll need to turn on the "Calendar" item by clicking on the toggle switch button next to its name and agreeing to the usage terms and conditions of the Calendar API. Then, creating the project proceeds as follows:

  1. Go to the API Access tab and click "Create an OAuth 2.0 client ID".
  2. Enter a product name. This is what users will see when they are prompted to allow the application to access their Google account.
  3. For the type of the application, select "Web Application."
  4. You should see a section entitled "Client ID for Web Applications". In that section, select "Edit Settings."
  5. In the Authorized Redirect URIs box, put in the following two URIs, replacing domain.name/webroot with the domain name and web directory where X2CRM is installed:
http://domain.name/webroot/index.php/calendar/syncActionsToGoogleCalendar
http://domain.name/webroot/index.php/site/googleLogin

Configuring X2CRM

  1. In X2CRM, go to "Google Integration" under the System Settings section of the Admin page.
  2. Check the box to enable integration, and paste the Client ID and Client Secret from the "Client ID for Web Applications" on the API Access page of your Google Console. Don't worry about the API Key field; it's not necessary as of now.

Individual User Login

Each user wishing to log in using their Google account should first go to Update Profile, which can be found in the left menu when they are viewing their profile, and set the Google ID field to their GMail address. Then, to login:

  1. Log out
  2. Click "Login with Google" at the login screen, and follow the link "Login with Google ID"
  3. Click the necessary button button to permit X2CRM to access your Google account.