Your Hub's Getting Started Page
Your hub should have a getting started page at <your hub url>/gettingstarted. Most of the items addressed on this page are discussed in further detail below.
Step 1: Setting Up Facebook
- Navigate to (https://developers.facebook.com).
- Begin by logging into a Facebook account or creating a new Facebook account for your Amazon Instance.
- After successfully logging into Facebook, click the My Apps tab, then in the drop-down select Register as a developer.
- Read through the Facebook polices and accept the policies by changing the answer from No to Yes with the switch button, and then click Register.
- Select the My Apps tab again and from the drop-down click Add a New App.
- Select the platform of the new app by clicking the WWW or "Website" icon.
- In the upper right corner of the page, select the Skip and Create App ID button.
- Fill in the Display Name in the name field and select the category of the application depending on your field.
- Fill in the rest of the New App ID information or leave it blank depending on your preference, then click Create App ID.
- On the application dashboard, copy the App ID and App Secret. In order to copy the App Secret you will have to click Show in order to access the full secret code.
Step 2: Enabling Facebook
- Navigate to your Amazon Instance, and access the backend of the hub.
- Click the Extensions tab and then from the drop-down select Plug-in Manager.
- Locate the Authentication-Facebook plug-in and open the plug-in by clicking the plug-in name.
- Inside the plug-in, change the status of the plug-in from Disabled to Enabled.
- Insert the App ID and Consumer Secret into the corresponding fields and click Save & Close.
- The Facebook Authentication will be available for users to use in order to login into the hub.
Step 1: Setting Up LinkedIn
- Navigate to (https://www.linkedin.com/secure/developer).
- Begin by logging into a LinkedIn account or creating a new LinkedIn account for your Amazon Instance.
- After successfully logging into LinkedIn, under the list of applications click Add New Application.
- Fill out the form to register a new application.
- Click Add Application once you have finished filling out all the required fields in the application form.
- Once you receive a message stating, Your application was successfully created, copy the API key and the Secret key.
Step 2: Enabling LinkedIn
- Log into your Amazon Instance and log into the administrative side of the Amazon Instance.
- Under the Extensions tab select from the drop-down Plug-in Manager.
- Inside the Plug-in Manager, locate the Authentication-LinkedIn plug-in.
- Select the title of the plug-in, then inside the plug-in fill in the API key and the Secret key.
- Enable the plug-in by selecting from the Status drop-down, then click Save & Close to save the changes that were made.
- The LinkedIn plug-in will be successfully enabled and available for users to use as another option to login to your Amazon Instance.
Step 1: Set Up Google Analytics on Google
Step 2: Enabling Google Analytics
Step 1: Configuring Google Drive in Projects on a Hub
- Navigate to console.developers.google.com and login with your hub gmail account.
- Click Create Project to create a new project for your hub.
- Enter the Project Name. We suggest using your hub name.
- Enter the Project ID. The Project ID is a globally unique identifier that cannot be renamed. Use the ID given, or specify a new one in the field.
- Click Create.
- Once created, click the link to your project to open it.
- From the Dashboard, click “Enable an API” to select services for the project. From this list, find and turn on Drive API and Drive SDK services by clicking Off next to each to switch them to On. Be sure to accept Terms of Service if asked.
- Next, navigate to the left hand menu to find APIs & auth. Click Consent Screen to set up the branding information. Fill in all required fields.
- Choose the hub email account from the Choose your email dropdown.
- In Product name, type Project Files to Google Drive Connector.
- Click Save.
- Next, click Credentials under APIs & auth.
- Click Create new Client ID.
- On the Create Client ID screen, choose Web Application under Application Type.
- In the Authorized Redirect URIS field, type your hub URL and add /projects/auth (i.e. https://www.yourhub.org/projects/auth).
- Click Create Client ID.
- Under Client ID for web application, note the Client ID and Client Secret, as these will be needed.
- Under Public API Access, click Create New Key.
- Choose Browser key from the Create a new key pop-up.
- In the HTTP Referrers field, type in your hub name followed by/*. Example: yourhub.org/*
- Click Create. Note the API Key: After this step, you will navigate back to the hub to configure.
Step 2: Turning on Google Drive in Projects
- Navigate to yourhub.org/administrator and log in.
- Navigate to the Extensions menu, and click Plug-in Manager.
- In the search, type Projects, and click Search.
- In the results, find the Projects – Files plugin. Click the title to edit.
- Scroll down until you see the Google Connection Enabled option. Choose yes from the drop-down.
- Fill in the Google Client ID, Client Secret, and API Key fields with the information from your account.
- Choose when to auto-sync.
- If you would like to only make Google Drive available to certain projects, type the alias of the project into the Connected Projects.
- Click Save & Close.
CKEditor is a HTML text editor designed to simplify web content creation. It’s a WYSIWYG editor that brings common word processing features directly into the web pages being built. After a Hub has been updated to R1.3.0 various settings need to be adjusted on the administrator backend of the Hub to allow CKEditor for all users.
Step 1: Global Configuration
- On the backend of the Amazon Instance, select the “Site” tab from the top menu.
- Click on the “Global Configuration” from the drop-down to open up the global configuration settings.
- Under the “Site” tab navigate to “Site Settings” and then locate “Default Editor”.
- Select “Editor-CKEditor” from the drop-down.
- Click “Save & Close” to save the newly changed settings.
Step 2: HTML Format Handler Plug-in
- On the backend of the Amazon Instance, select the “Extensions” tab from the top menu.
- Click on the “Plug-in Manager” from the drop-down.
- Enter “Content – HTML Format Handler” into the search box and click “Search”.
- Click on the “Content – HTML Format Handler” title to open up the plug-in.
- In “Details” change the status to “Enabled” and then click “Save & Close”.
Step 1: Set Up ReCAPTCHA on Google
- Navigate to (https://www.google.com/recaptcha/intro/index.html) and select Get reCAPTCHA.
- You will be required to login to a Google account, at this point consider creating a new account for you Amazon Instance or use a previously created account.
- Fill in the Label field and Domain field with the appropriate information.
- Copy the Site key and Secret key.
Step 2: Enabling ReCAPTCHA
- Navigate to your Amazon Instance and log into the administrative side.
- Select the Extensions tab and from the drop-down select Plug-in Manager.
- Locate the CAPTCHA-ReCAPTCHA plug-in and click on the title.
- Change the status of the plug-in from Disabled to Enabled, then fill in the Public key and the Secret key.
- Save the changes by clicking Save & Close, then ReCAPTCHA will be activated on your Amazon Instance.