Welcome to the Explore Minnesota Tourism Website

Explore Minnesota Website Accessibility Navigation:

Main Content

Help with the Data Sharing Widget

Overview

This page provides help with the data sharing widget tool that enables you to include listings (attractions, lodging, etc.) from the Explore Minnesota Tourism site into your website.


How are the listings included in my site?

The data sharing widget generates an IFRAME tag that pulls in the listings (based on criteria you specify such as categories, regions, type, etc,) from the Explore Minnesota Tourism site. The IFRAME tag that the widget generates looks like this:

<iframe src="http://www.exploreminnesota.com/data-widget/listings-wide/index.aspx?paging=true&pageSize=3&locationId=0&classifids=39" width="660" height="810" style="padding:0px;background:#FFFFFF;border:none;"></iframe>

When this tag is integrated with your site's source code, the listings will seamlessly display with the content of your site.


Why are there "Full Width" and "Callout Width" sizes in the form?

We created two different sizes so you could choose the size that best fits your needs. The "Full Width" size is meant to be placed within the main content of a page, usually in the middle. The "Callout Width" is narrower and is meant to be placed in a column outside of the main content of a page, so that the list supports, or complements, the main content of the page.

View an example of the "Full Width" IFRAME snippet inserted into a site page

View an example of the "Callout Width" IFRAME snippet inserted into a site page


What are the default dimensions of the IFRAME?

The default dimensions of the "Full Width" IFRAME are 660 pixels wide and 810 pixels high.

The default dimensions of the "Callout Width" IFRAME are 225 pixels wide and 770 pixels high.


Can I adjust the dimensions of the IFRAME?

Yes. Once you have generated the IFRAME code snippet, you can adjust the pixel dimensions of the IFRAME in which the listings are displayed.

To modify the dimensions, the values of the width and height attributes need to be changed. These attributes are highlighted in the following screen capture.

IFRAME code snippet with width and height attributes highlighted

For example, to modify the IFRAME code snippet above to have a width of 700 pixels and a height of 850 pixels, you would replace the "660" with "700" after width= and replace "810" with "850" after height=. Your updated code snippet would then appear as shown below:

IFRAME code snippet with updated width and height attribute values highlighted


How are the listings presented and styled?

The listings are styled to match the design and color scheme of the Explore Minnesota Tourism site. The text size, font face, colors, etc. cannot be changed. Below is an example of how the list will appear. By default, there will not be a border around the list.

Example of the presentation of the list in the IFRAME


Can I add a border around the list?

If you want to add a border around the list, you need to modify the border style of the IFRAME tag. By default, the style will appear in the IFRAME code snippet as:

border:none;

To create a 1 pixel black border around the list, the value of the border style to:

border: 1px solid #000000

This instructs the browser to create a solid 1pixel wide black border around the list. The list would then display as shown in the example below. Note that there may be some slight variation in the display of the border in different web browsers. This is typical behavior since there are differences in the way that browsers interpret and display border styles.

Here's what the code snippet looks like with the updated border style:

IFRAME code snippet with updated border style applied and highlighted


What happens if the list is longer than the IFRAME?

If you generate a list that is longer than the IFRAME, a scrollbar will automatically display in the IFRAME.


Can I include more than 50 items in my list?

Yes. While the data sharing widget was designed for you to include a very specific set of listings on your site, we understand that there may be a need for an extensive list greater than the maximum of 50 that the list generator provides.

To pull in more than 50 listings (provided the list you generated includes more than 50) you can adjust the value of the pageSize parameter in the code snippet.


Will the links to the listings on the Explore Minnesota Tourism site open in the same window as my site?

No. Each link to a listing will open in a new browser window or tab, depending on the type of browser your site visitor is using and how the site visitor has their browser configured. In most cases, if your site visitor is using Internet Explorer, the link will open in a new browser window. If your site visitor is using Firefox, Chrome, or Safari, the link will open in a new tab. Either way, your site visitor will be able to view the information for the listing on the Explore Minnesota Tourism site and then easily return to your site by closing the window or tab.