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 Content by Search app gives companies that use WordPress as their intranet platform of choice a simple solution to offer employees the ability to search for any type of content – from documents and tasks to people – by tapping into the potential offered to us by Microsoft SharePoint Online.

All plugins now ship by default with the Content by Search app, but only the WPO365 login INTRANET edition offers intranet managers the ability to highly customize this experience. Scroll down to the Configuration section and watch the video to get an impression of what the Content by Search 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 following video for instructions on how to configure the plugin and your web application’s registration in Azure AD to configure the Content by Search (SharePoint Online) app.

Please note that this video needs to be updated and does not yet reflect the recently added capability to customize the app’s appearance using (your own) Handlebars template.

Configuration options [BASIC Edition]

This section discusses the individual configuration options for the BASIC edition of the Content by Search (SharePoint Online) app that ships with the BASIC, PROFESSIONAL and PREMIUM edition of the plugin.

  • Your SharePoint Home URL is be set to the home URL of your SharePoint Online tenant e.g. https://your-tenant.sharepoint.com where you should replace the your-tenant with (host) name that is specific to you. Please note that if you added the Sites.Read.All permission to your (primary or secondary) Azure AD App registration, the Content by Search (SharePoint Online) shortcode generator will try and figure this address out all by itself. If you did not add this permission, you might see a popup, informing you that you must enter this information manually.

Configuration options [INTRANET Edition]

This section discusses the individual configuration options for the INTRANET edition of the Content by Search (SharePoint Online) app that ships with the INTRANET edition of the plugin.

  • Select result source let you switch between SharePoint Online search result sources. Result sources limit searches to certain content or to a subset of search results. Refer to the official Microsoft documentation for instructions on how to manage result sources. The plugin supports all possible result source but has been pre-configured for two:
    • Local SharePoint Results is the default result source that covers most generic requirements to find documents and items saved in your SharePoint tenant.
    • Local People Results is a specific result source that covers requirements to find users registered in your SharePoint tenant.
  • Result source ID is automatically set if you choose the Local SharePoint Results or the Local People Results result sources from the previous drop down list or can be entered manually if you want to use a different / custom result source that is not in the list.
  • Use (Handlebars) template allows you to fully customize how your search results are rendered / presented to your users. The option to use templates has been added since v9.5 and are now the preferred way to render search results. However, you can still uncheck this option and use the legacy placeholders for primary, secondary, tertiary and meta text. Refer to the following online documentation for instructions on how to create your own fully custom Handlebars template.
  • Template (only visible when you checked Use (Handlebars) template) allows you to configure the location where the app should try and download the (custom) Handlebars template from. Please note that for reasons of security modern browsers won’t allow you to download content from other servers than your own (unless CORS has been properly set up). By default the shortcode generator proposes to use the Handlebars template that ships with the plugin.
  • Primary / Secondary / Tertiary / Meta text (only visible when you unchecked Use (Handlebars) template) allows you to connect the built-in static template’s Primary / Secondary / Tertiary / Meta text placeholders with a so-called SharePoint Search Managed Property. Read the Select properties section further down for information on how to retrieve these Managed Properties.
  • Try retrieve user photo tells the app to try and connect to Microsoft Graph and download a user’s Office 365 profile image whenever if finds the Managed Property UserName among the Managed Properties returned for a search result item.
  • Query template allows you to take control of the query entered by the user (if any) using a template that will replace the original query text. Doing so would help you limit the results that are returned by the app. For example the following query template would only return results found in the Shared Documents library in the Contoso Site Collection: Path:https://wpo365demo.sharepoint.com/sites/Contoso/Shared%20Documents {searchterms}
  • Auto search tells the plugin not wait for the user to enter a search query but instead start and search immediately. This is especially usefull when used in combination with a Query Template and / or Add wildcard to each search term (see below).
  • Select properties can be used to request additional Managed Properties to be included for each search result item. Please refer to the Microsoft documentation to gain an understanding of how you can manage the SharePoint Online search schema. If you’d like to experiment hands-on with SharePoint search then please consider downloading the SharePoint Search Query Tool.
  • Results per page allows you to restrict the number of results displayed per page.
  • Min. input length tells the plugin to wait before executing the search query entered by the user until at least a minimal number of characters has been entered into the search box. This setting does not prevent Auto search from executing a search immediately as soon as the app has finished loading.
  • Add wildcard to each search term adds an * (asterix) to each word that the user enters into the search box and will therefore change the behaviour of the app significantly by instructing the app to search in SharePoint for content that contains the query text entered by the user (instead of returning only items that match exactly with the query text entered by the user).
  • Hide Search box / Message bar / Paging will hide the corresponding elements when checked. This is especially usefull when used in combination with an Query template and Auto search.
  • Sort list tells SharePoint to sort the results according to the specific Managed Property entered here. Please note that not all Managed Properties are sortable (see manage the SharePoint Online search schema).

Supported versions

VersionAvailable
BasicYes
ProfessionalYes
PremiumYes
IntranetYes (Advanced)

Leave a Reply

Your email address will not be published. Required fields are marked *