Category | Application |
Active Installs | 16 |
Rating | |
License | GNU Lesser General Public License 2.1 |
Sources | Issues |
The Google Apps Integration allows you to integrate XWiki with Google's editing application (Google Docs, Spreadsheet, Presentations and Drawing). Thanks to this application it is possible to:
- log in to XWiki using your Google account
- easily import a Google Apps document as an attachment in XWiki (in multiple formats)
- launch editing of an XWiki attachment in Google Apps. Once the editing session is finished you can reimport it in XWiki.
This integration uses the OAuth2 protocol to connect Google Apps with XWiki. It works with individual Google accounts as well as company wide Google Apps accounts.
To activate Google Apps you need to register for OAuth access on Google.com and insert your domain name and key in the settings from the XWki Administration. To see how you can register for OAuth access please read the dedicated section in the Installation instructions.
Once you have properly configured the application, you will be able to log in with your Google credentials and see the feature in the Attachments section of XWiki pages. You can either click on the edit link next to each attachment or use the Import from Google Apps button.
You can also use the drive macro to insert (embed) a Google Document in your page.
Installation Steps
This paid extensions requires XWiki 11.10 or above. In order to install the extension, follow the next steps inside your XWiki instance (on cloud or on premise).
Navigate to the Extension Manager
In the Applications Panel click on "More Applications..." and then "Install new applications...". Alternatively navigate directly to the Administration and select the "Extensions" section.
Install the Extension
Search for the extension you wish to install and use the Install button to install it.
Get a License
Navigate to the "Licenses" section of the Administration, fill your details, look for the extension you just installed in the live table and click the buttons to get a trial license or to buy a license.
Install the License
If you have selected a trial license then you're good and there's nothing else to do. Your trial license is automatically installed.
However if you've selected to buy a license you'll be redirected to a page to perform the payment. At the end you need to come back to the "Licenses" administration section and click on the "Check for Updates" button. This will download and apply the license you bought.
Use the Extension
Start using the Extension! Refer to the extension's documentation to know how to use it.
Installing Paid Apps on Subwikis
If you want to install an application on the whole farm (main wiki + subwikis), you can do so directly from the main wiki’s Extension Manager, as seen below:
Extensions can also be installed only on a particular subwiki by global admins. Subwiki admins will not be able to install these extensions due to their limited rights.
Register for OAuth access
Create a Google project for your app
Go to https://console.developers.google.com/ (see also https://developers.google.com/identity/protocols/OAuth2?hl=en). Create a Google project for your app as shown below:
Enable the Google+ API
Moving forward, you will need to Enable the Google+ API. This API is needed to access the Google account information. To enable it go back to the dashboard and click on ENABLE APIS AND SERVICES, search for Google+ API and click ENABLE
Enable the Google Drive API
This API is needed to access Google documents. Similarly, to enable it go back to the dashboard and click on ENABLE APIS AND SERVICES, search for Google Drive API and click ENABLE
Generate the Google Client ID and Secret
In order to start using the integration, the Google Client ID and Secret will need to be generated and added to the Google Apps Configuration page.
Open the project and go to Credentials > OAuth consent screen.
Set up the OAuth client inside the Google project by filling in the following fields:
- Application name
- Authorized domains
- Application Homepage link
- Application Privacy Policy link
Note Google does not accept localhost for these fields. This tutorial uses the alias apps.xwiki.com. Depending on your OS you will need to also update the hosts file to which you should add the following IP/Alias pair: your IP your Application Homepage link (e.g. 127.0.0.1 apps.xwiki.com).
After setting up the OAuth client go back to Credentials and click on Create credentials > Create OAuth client ID.
Select "Web Application" and fill in the name and the Authorized redirect URI. The Authorized redirect URI needs to end with GoogleApps/Oauth. Make sure you hit enter after filling in the Authorized redirect URI, otherwise the value will not be saved. Then click the Create button.
A popup will appear with the Client ID and Client Secret.
Next you will need to update the Client ID and Secret inside the XWiki Administration from the Google Apps Integration Configuration section.
Activate the Google Authentication
Finally, to activate the Groovy Authentication you need to update the following settings in the xwiki.cfg file (webapps > xwiki > WEB-INF) and restart the wiki:
xwiki.authentication.groovy.pagename=xwiki:GoogleApps.AuthService
If you are an XWiki Cloud user you do not have direct access to this file. You will need to contact the XWiki Support team to perform this change for you.
Options
The price is per year and varies depending on the support level and the number of users.
Support / Users | 10 | 25 | 50 | 100 | 250 | 500 | 1000 | 2500 | 5000 | 10000 | 20000 |
---|---|---|---|---|---|---|---|---|---|---|---|
Silver |
Benefits
What do you get when you purchase an XWiki extension?
1 year license
By purchasing an XWiki extension license, you'll benefit from it during one year.
Free updates
You benefit from all the extension updates during one year. You are always up to date.
Support included
If you are facing an issue, you can reach the XWiki support. Our team is always available to help.
How to Buy
To buy, install this extension from inside your XWiki instance and follow the instructions.
Release notes
v2.3.5
Update the Licensing dependency to version 1.13.2.
v2.3.4
Bugs fixed:
#4 Fix the google links from the Administration section.
#9 Extension's homepage description contains a broken link to Google Apps admin section.
Update the Licensing dependency to version 1.13.1.
v2.3.3
Update the Licensing dependency to version 1.13.
v2.3.2
Update the Licensing dependency to version 1.12.2.
v2.3.1
Update the Licensing dependency to version 1.12.1.
v2.3
Improve the message displayed when there is no valid license.
Update the Licensing dependency to version 1.8.
v2.2
Initial paid version.
Extension details
License
- GNU Lesser General Public License 2.1
Sources
Issues
Type
- xar
Developed by
Compatibility
- Requires XWiki 8.4 or above.
Dependencies
- com.xwiki.licensing:application-licensing-licensor-api 1.13.2
- com.google.api-client:google-api-client 1.20.0
- com.google.gdata:core 1.47.1
- com.google.apis:google-api-services-plus v1-rev318-1.20.0
- com.google.apis:google-api-services-drive v2-rev174-1.20.0