Support

Knowledge Base

Browse our knowledge base articles to quickly solve your issue.

Allow SharePoint to Display in iFrames

Out of the box, SharePoint does not allow its Sites to open within an external iFrame without first applying some configuration. To allow a SharePoint Site to be compatible for use within an iFrame, follow the steps in this guide.

SharePoint sites may be arranged hierarchically, the top parent site being known as a 'Site Collection'. There may be several Site Collections.

sharepoint 1

The following directive needs to be added to the HTML code for the Site's pages:

<WebPartPage:AllowFraming runat="server" />

Fortunately, child sites can be configured to inherit settings from their parent site. If the changes are made to a Site Collection, it becomes much easier to make any child site of said Site Collection accessible to Workbooks. This in turn, means that configuration will be easier if all the sites that are required to be accessible from Workbooks descend from a single, or limited, number of Site Collections.

The remainder of this page describes step-by-step how to apply this modification to a site collection and how to configure its child sites to inherit the required settings. Instructions on how to configure the SharePoint Plugin within Workbooks, can be found here.


1. Configure the Site Collection

For the site collection(s) you wish to become available to Workbooks, the 'SharePoint Server Publishing Infrastructure' must be enabled. To do this, navigate to the page 'Site Collection Features' using the following path:

Settings > Site Settings > Site Collection Administration > Site Collection Features

Once within the 'Site Collection Features' page, click the 'Activate' button next to 'SharePoint Sever Publishing Infrastructure', as highlighted in red below. (Click to enlarge.)

sharepoint 2

 Next, 'SharePoint Sever Publishing' needs to be enabled. To do this, navigate to the page 'Manage Site Features' using the following path:

Settings > Site Settings > Site Actions > Manage Site Features

Once within the 'Manage Site Features' page, click the 'Activate' button next to 'SharePoint Sever Publishing'.

Now, the default master file for the site collection needs to be located. To do this, navigate to the 'Master Page Gallery' using the following path:

Settings > Site Settings > Web Designer Galleries > Master Pages and Page Layouts

Once within the Master Page Gallery, page through until you find the file 'seattle.master', as highlighted below.

sharepoint 3

Select the 'seattle.master' file (using right click) and download a copy of the file. 

Rename the downloaded file to be 'seattle-allow-framing.master' and open it in your favourite text editor (eg, Notepad or TextEdit).

There will be a set of lines beginning <%@Register ... (highlighted below in green) near the top of the file.  Add the following line of code after these lines, as highlighted in the screenshot below (click to enlarge):

<WebPartPages:AllowFraming runat="server" />

sharepoint 4

Upload the modified master file to the appropriate site collection via its 'files' tab shown in the screenshots below (once within the site collection). 

sharepoint 5

sharepoint 6

Within the master page gallery right-click on the new file and select 'edit properties'. Set the content type to 'ASP NET Master Page' and the UI version to 15, and then save.

sharepoint 7

Again on the Master Page Gallery, right-click on the new file. Select to 'Publish a Major Version'.

sharepoint 8

Next, navigate to the master page settings via the following path:

Settings > Site Settings > Look and Feel > Master Page

Within the Site Master Page Settings, set both the site master page and the system master page to be 'seattle-allow-framing' and click 'OK'.

sharepoint 9

 

2. Set a Child Site to inherit the configuration of its Parent

The instructions below describe how to set up the configuration of a new child site. To configure a pre-existing child site the steps are the same, but step 2 can be discounted.

NOTE: Part 2 will not work without Part 1 being complete.

Open a Site Collection with the modification described in section 1 above.

Once within the Site Collection, create a new child site via the following path:

Settings > Site Contents > New Subsite

Once the sub-site has been created, its settings must be defaulted to that of the parent site. To do this, navigate to the page 'Manage Site Features' using the following path (from within the chosen child site):

Settings > Site Settings > Site Actions > Manage Site Features

Once within the 'Manage Site Features' page, click the 'Activate' button next to 'SharePoint Server Publishing'.

This has defaulted the settings of the child site to duplicate that of the parent site, and can be checked by going to the 'Master Page' under 'Site Settings', where the default should now be to inherit the master page from its parent.

These sites are now compatible with Workbooks iFrames.

Related content

Email & Integration

An overview of what you can do within the Email & Integration section within Configuration.