Embed external content in CMS Lite

Last updated on January 9, 2024

Learn about embedding a map, visualization, event calendar, or iFrame to a CMS Lite page.

On this page


Types of embeddable content

The CMS Lite allows the following external content to be embedded:

  • Map (Data BC or Google Maps)
  • Visualization (Data BC content)
  • Event calendar (WordPress)
  • iFrame (controlled list)

Embed a map

Consult DataBC before embedding a map

Before embedding any maps in the CMS Lite, you will need to discuss your mapping requirements with DataBC.

To contact the DataBC team, please open a ticket with the Data Systems & Services request system

 

Map of British Columbia

Sample map showing the province of British Columbia

How to embed a DataBC or Google map

When pasting an address in the URL field, make sure there are no blank spaces on either side of the URL. Additional spaces will result in an error when viewing the content in QA.

To embed a map:

  1. Place the cursor in the Rich Text Editor (WYSIWYG) where the map is to be inserted
     
  2. Click the Embed External Content Visualization icon icon on the toolbar
    The following options will be displayed
    embed icon options - embed maps or embed visualization
  3. Select Embed Map
    The Map Embed dialogue box will be displayed.
     
  4. Check the box next to the statement "I confirm that I have consulted DataBC Enterprise Date Services and have received their approval." to enable the Map Embed tab

image of the Embed Map approval tab

  1. Click on the Map Embed tab

    To embed a map from DataBC: 
    View information regarding the three DataBC Web Mapping Frameworks. To contact the DataBC team, please open a ticket with the Data Systems & Services request system.

    To embed a Google Map:
    1. Click the [Embed Map] tab
    2. Click SHARE Map share icon
    3. Search for a location on Google Maps
    4.  Copy the secure (https) URL provided into the Embed URL field (you have the correct link if the URL starts with <iframe scr=
       
  2. Click on the Map Embed tab and paste the link into the mandatory Paste Map Embed URL field
     
  3. Enter an applicable title in the mandatory Title field that will be displayed above the map frame
     
  4. If desired, enter a description in the Description field that will be displayed below the map frame
     
  5. The Size defaults to 640px x 360px. Use the drop-down box to choose another option:
    • 1120px x 630px
    • 700px x 700px
    • 560px x 315px
    • 400px x 225px
       
  6. Click the [OK] button 
    The dialogue box will be closed and a place holder image will be inserted at the cursor location. The map will be displayed in a browser window

Map Embed Properties box


Embed a visualization

CMS Lite currently supports embedding visualizations by DataBC into the page. To contact DataBC, please email data@gov.bc.ca.

Troubleshooting: When pasting an address in the URL field, make sure there are no blank spaces on either side of the URL. Additional spaces will result in an error when viewing the content in QA.

To embed a visualization:
  1. Place the cursor in the Rich Text Editor (WYSIWYG) where the visualization object is to be inserted
     
  2. Click the Embed External Content Visualization icon icon on the toolbar
    The following options will be displayed
    embed icon options - embed maps or embed visualization
  3. Select Embed Visualization
    The Embed DataBC Content dialogue box will be displayed.

data visualization instruction tab

  1. Click on the Embed DataBC Content tab
     
  2. Enter a secure (https) URL into the mandatory Paste DataBC Visualization URL field
     
  3. Enter an applicable title in the mandaory Title field that will be displayed above the frame
     
  4. If desired, enter a description in the Description field that will be displayed below the frame
     
  5. The Size defaults to 640px x 360px. Use the drop-down box to choose another option:
    • 1120px x 630px
    • 700px x 700px
    • 560px x 315px
    • 400px x 225px
       
  6. Click the [OK] button 
    The dialogue box will be closed and a place holder image will be inserted at the cursor location. The visualization content will be displayed in a browser window

data visualization embed DataBC content tab


​Embed event calendars

Set up an event calendar

To embed a calendar on CMS Lite, you’ll first need to set one up at events.gov.bc.ca. Only calendars hosted here can be embedded on CMS Lite.

To start this process, please contact the GDX Service Desk at gdx.servicedesk@gov.bc.ca.

Embed an event calendar

  1. Place the cursor in the Rich Text Editor (WYSIWYG) where the calendar is to be inserted
     
  2. Click the Embed External Content Visualization icon icon on the toolbar
    The following options will be displayed
    embed icon options - embed maps or embed visualization
     
  3. Select Embed Event Calendar
    The Embed Event Calendar dialogue box will be displayed

embed event calendar instruction tab

  1. Click on the Embed Event Calendar tab
     
  2. Enter a secure (https) into the mandatory Paste Calendar Event URL field. This plug-in only supports URLs from https://events.gov.bc.ca/. An error message will be displayed if the URL is invalid
     
  3. The Size defaults to 1120px x 630px. If desired, use the drop-down box to choose 700px x 700px
     
  4. Click the [OK] button 
    The dialogue box will be closed and a place holder image will be inserted at the cursor location. The calendar will be displayed in a browser window

embed event calendar tab


Embed an iFrame

An inline frame (iframe) loads another HTML page within the page, putting another webpage within the parent page. iFrame content is not indexed on search engines.

Add an iFrame

To add an iFrame URL to the controlled list, contact the GDX Service Desk at gdx.servicedesk@gov.bc.ca.

How to embed an iFrame

When pasting an address in the URL field, make sure there are no blank spaces on either side of the URL. Additional spaces will result in an error when viewing the content in QA.

To embed an iFrame:
  1. Place the cursor in the Rich Text Editor (WYSIWYG) where the iFrame is to be inserted
     
  2. Click the Embed External Content Visualization icon icon on the toolbar
    The following options will be displayed
    embed icon options - embed maps or embed visualization
  3. Select Embed iFrame
    The Embed iFrame dialogue box will be displayed.

embed iFrame tab

  1. Enter an approved URL into the mandatory Paste iFrame URL field. This plug-in only supports URLs approved by Corporate Online Services. An error message will be displayed if the URL is invalid. See the Instructions tab for more details
     
  2. The Size defaults to 640px x 360px. Use the drop-down box to choose another option:
    • 1120px x 630px
    • 700px x 700px
    • 560px x 315px
    • 400px x 225px
    • 270px x 475px (use for Right Column boxes)
       
  3. Click the [OK] button 
    The dialogue box will be closed and a place holder image will be inserted at the cursor location. The iFrame content will be displayed in a browser window

embed iFrame instructions tab