Feature description
The WordPress + Office 365 plugins not only shines when it comes to its Single Sign-on, User Registration and User Synchronization capabilities. Since v9.0 it now ships with ready made apps that let you seamlessly integrate the world’s most widely used content management system WordPress with Microsoft Office 365, Microsoft Graph and SharePoint Online.
The Documents app gives companies that use WordPress as their intranet platform of choice a simple solution to embed a SharePoint Online / OneDrive library in any post or page.
All plugins now ship by default with the Documents app, but only the WPO365 login INTRANET edition offers users the ability to navigate into folders and back up using a clever breadcrumb navigation. Scroll down to the Configuration section and watch the video to get an impression of what the Documents app can do for you and how simple it is to get up and running in less than 10 minutes.
Configuration
You can watch the video below for instructions on how to configure the plugin and your web application’s registration in Azure AD to configure the Documents app.
Please note that this video needs to be updated and does not yet reflect the recently added capability to simply check the option “Current User’s” OneDrive to connect to a user’s business OneDrive.
Configuration options [BASIC Edition]
This section discusses the individual configuration options for the BASIC edition of the Documents (SharePoint Online / OneDrive) app that ships with the BASIC, PROFESSIONAL and PREMIUM edition of the plugin.
- Hostname is where you enter the hostname portion of your tenant’s SharePoint Online instance. For example, if your SharePoint Online home address is https://wpo365demo.sharepoint.com you would enter here wpo365demo.sharepoint.com (without https:// at the beginning and trailing slash at the end).
- Server relative path library is where you enter the server relative portion of the SharePoint Online Site where the library that you’d like to publish resides. For example, if the library you’d like to publish in WordPress can be found in the site with address https://wpo365demo.sharepoint.com/sites/contoso then would enter here sites/contoso.
- List title is where you enter the title of the list that you want to publish in WordPress e.g. Documents.
- Page size dictates the size of results that should be returned from Microsoft Graph. It doesn’t, however, adds pagination. Instead the app will keep requesting results in batches until all results for the current (root) folder have been retrieved. The page size therefore prevents your app from requesting too much data at once. Instead it does so in batches to keep your app from becoming unresponsive for large libraries.
- Hide message bar will hide the corresponding element when checked and as such would prevent end users from seeing error and warning messages.
Configuration options [INTRANET Edition]
- “Current User’s” OneDrive tells the app to connect to the current signed-in user’s OneDrive instead. Therefore, when you check this option, the previous options will be hidden instead – since hostname, site relative path and list title are automatically retrieved from Microsoft Graph’s special /me endpoint.
Supported versions
| Version | Available |
|---|---|
| Basic | Yes |
| Professional | Yes |
| Premium | Yes |
| Intranet | Yes (Advanced) |
Hello,
I have the Intranet licence version of the plugin and I am trying to integrate OneDrive documents on my site. I want a OneDrive section so that each signed-in user can see their own personal private files.
Page Size: 10
Hostname: sitename-my.sharepoint.com
Server relative library path: [empty field]
List title: OneDrive
I can’t enter [personal/name_surname_sitename_com] as relative library path, since that would display the private files for the specific user.
Is there a way that can resolve my issue?
Thanks
Hi Done. Unfortunately this is not supported at the moment. But I can see that this makes absolutely sense and will add it as soon as possible (but at least before the end of the year). Thank you for bringing this to my attention!
Ps, Did you know that you can also contact support through the website https://www.wpo365.com/contact/? This will create a ticket in the support system and make sure that I respond in a timely fashion!
Hello,
First of all, great feature!
I was wondering how to use the “Columns” field when generating the shortcode. It doesn’t look to have any impact on the final result.
Thanks!
Hi Bastien. Basically it’s a simple JSON “object” where the key (left of the semicolon) refers to a DriveItem field (https://docs.microsoft.com/en-us/graph/api/resources/driveitem?view=graph-rest-1.0) and the corresponding value (right of the semicolon) to the display title in the app. Please let me know what you’d like to achieve and I’ll happily have a look at it!
Regarding the columns, I experience the same issue. I can add an additional json pair (createdByUser in my case), but it has no impact. Additionally, the keys in the generator are not valid keys in the DriveItem endpoint. For example, the generator uses modifedBy where the API uses lastModifiedBy. Something is controlling that – a template perhaps?
Hi Brian. Yes, you are right. There is internally a default column set.
For (Recent) Documents:
Name, Default title
type, ‘Type’
title, ‘Title’
lastActivity, ‘Last Activity’
For (SharePoint / OneDrive) Documents:
Name, Default title
icon, ‘Icon’
name, ‘Name’
modified, ‘Modified’
modifiedBy, ‘Modified By’
size, ‘Size’
Other columns cannot be used currently. But please let me know if you feel that more columns should be added.
Hope this helps!