Embedding Your Website on an External Site

Embedding Eventscribe webpages allows external websites to display content from Education Harvester and Expo Harvester, including event agendas, exhibitor and sponsor listings, and speaker information. This step-by-step guide reviews the process for embedding Eventscribe Website pages into an external website. This guide also outlines considerations, setup instructions, and troubleshooting tips to ensure a smooth integration of Eventscribe pages into the external website.

Process Overview

To embed Eventscribe Website pages into an external website, both the customer and Cadmium must complete specific actions. Below is an overview of the responsibilities. Specific instructions can be found in the Setup section.

1. Customer contacts their Cadmium Account Manager to contract the embedded site functionality.
2. Customer completes the Eventscribe Website ‘Get Started’ mission which will alert your Eventscribe Website Project Manager to schedule a kick-off call.

3. Customer sends Cadmium their external website domain(s) where they will embed Eventscribe Website pages.
4. Cadmium whitelists the requested domain(s).
5. Customer creates their Eventscribe webpages.
6. Customer collects the Eventscribe webpage URLs they want to embed.
7. Customer sends the Eventscribe webpage URLs and code to their web development team and works with their team to implement the embedded pages.
8. Customer thoroughly tests the embedded pages on the external website.

Considerations

Before proceeding, it’s important to assess whether embedding Eventscribe pages aligns with your event's needs. Below are some items to consider prior to implementing an embedded Eventscribe Website.

What is the use case for embedding Eventscribe webpages?

Embedded pages are used when you want to display Education Harvester and Expo Harvester content, such as the event agenda, exhibitor and sponsor listings, and speaker information, on an external website.

When should I avoid using an embedded Eventscribe Website?

Below is a list of common concerns. Please note, this is not an exhaustive list of concerns. To determine if an embedded website is a viable option for you, please consult your Account Manager (if you're a prospect) or your Eventscribe Website Project Manager (if you're an existing customer).

• End users are unable to log in to embedded websites, which means any features that require a login will not function, including:
  • Favoriting
  • Matchmaking
  • Scavenger Hunt
  • Viewing content such as slides, handouts, videos, and live streams
  • Evaluations
  • Audience Response System (ARS) for Q&A and discussion
  • My Experience webpage
  • Attendee List webpage
• Your IT or web team (the team responsible for managing your web domain) will need to use HTML and JavaScript to set up the pages. If you do not have internal resources available for this, this option may not be suitable. Please note that Cadmium staff are unable to complete this step on your behalf.

Are all types of pages able to be embedded?

No, static pages cannot be embedded. A static page is one you build from scratch with a text editor or HTML. Only pages where content is fed from the Education Harvester or Expo Harvester can be embedded.

How many pages can I embed?

There is no limit to the number of Eventscribe pages you can embed on your domain. It is the customer’s responsibility to identify the pages they would like to embed. See Step 2 in the Setup section for more details.

How long does it take to embed Eventscribe webpages?

Cadmium requires three (3) business days to whitelist your domain(s) after receiving a complete list of them. After that, your web development team will be responsible for completing the remaining steps. 

Is a single whitelisted domain good for multiple events or multiple years?

No, the whitelisted domain is only valid for a single event. You will need to complete all the steps in the ‘Process Overview’ section for each event.

Setup

The following steps outline the process for implementing the embedded pages after you've contracted for an embedded website. Please read this section thoroughly before proceeding with any steps.

1. Complete the Eventscribe Website ‘Get Started’ mission.

This will prompt your Eventscribe Website Project Manager to schedule a kick-off call. During this call, you will review the process of building your Eventscribe Website and discuss how embedded websites function, along with their limitations.

2. Send your Eventscribe Website Project Manager your external website domain(s).

You will need to provide a list of the external website domains where you plan to embed Eventscribe webpages. This is typically one domain, but it could be more. Your IT or web team should be able to supply this information. A domain is the part of your external website's URL.

Refer to the image on the right for an example: 

In this case, you would submit "gocadmium.com".

Be sure to include any test server websites and/or subdomains, if applicable. For instance, if Cadmium used a test server, the domain might be "test.gocadmium.com". Or, if Cadmium used a subdomain for its Eventscribe product, the domain might be "eventscribe.gocadmium.com". Your web development team should be able to confirm if this applies to your external website.

3. Create your Eventscribe webpages.

To gather the URLs you wish to embed on your external site, you will need to build an Eventscribe Website and create sub-pages for the content you want to display. Only configure the elements needed for your embedded site. Your Eventscribe Website Project Manager can assist in identifying what is required and applicable.

Create the desired pages in your Eventscribe Website under Content >>> Navigation Editor. For more instructions about how to add navigation items, please refer to this help tip.

Most Eventscribe webpages can be embedded, except for static pages. Commonly embedded pages include:

• Presentation/session agenda
• Browse by poster title
• Speaker list
• Exhibitor and/or sponsor lists

Once you’ve created the pages, you will either:

1. Click ‘Save & Publish’, then ‘Launch Website’ to view your navigation
2. Or, if you do not wish to publish these navigation items for all to see, use the arrow button next to each navigation item to preview each specific page

4. Collect the Eventscribe webpage URLs you want to embed.

After launching the webpages in your browser, copy and paste the URL for each page into an external document to submit to your web development team. You will need to append ‘&embedded=true’ to the end of each URL.

For example, if you want to embed your full schedule, the URL will look something like this by default:

https://ftfest2021.eventscribe.net/agenda.asp?pfp=FullSchedule

This is the URL you send to your web development team to use:

https://ftfest2021.eventscribe.net/agenda.asp?pfp=FullSchedule&embedded=true

5. Send the URLs mentioned above, along with the following code, to your development team.

Follow these steps to provide your web development team with the necessary URLs and JavaScript code to embed Eventscribe content on your external website using a <div> tag and the appropriate code snippet.

Div Tag

The embedded content will be displayed within a <div> tag. Your web development team will decide the appropriate location for this on your external website. The <div> tag must include an id attribute of “embeddedPage”. Use the JavaScript snippet below to insert your <div> tag.

If you are embedding multiple Eventscribe webpages, you will need to repeat this step for each page.

JavaScript

Use the JavaScript code snippet below to embed the page content. When copying the code, ensure you remove any style formatting. Replace 'ADD-URL-HERE' with the Eventscribe webpage URL from Step 3 in the Setup section. Remember to append ‘&embedded=true’ to the end of each URL.

<div style="overflow-y: scroll;" id="embeddedPage" width="100%"></div>
<script type="text/javascript" src="https://pym.nprapps.org/pym.v1.min.js"></script>
<script>
var pymParent = new pym.Parent('embeddedPage', 'ADD URL HERE’ , {
xdomain: '.+\.eventscribe\.net'
});
</script>

If you are embedding multiple Eventscribe webpages, you will repeat this step for each page.

6. Test and confirm the embedded pages on your external website.

Test the external webpage(s) to ensure they display and function as expected. After you’ve consulted with your web development team, if you have questions or run into issues that you believe are related to Cadmium, please contact your Eventscribe Website Project Manager.

Technical FAQ

In this section, we address some common technical questions related to embedding Eventscribe webpages. Below are detailed answers to help guide you through the process.

How do I include/exclude the Eventscribe Website left navigation?

To control whether the left navigation is visible on a page, you can use the "Show Left Navigation" page setting in the Eventscribe Website dashboard. To do this, follow these steps:

1. Launch the website you want to edit by using the Launch eventScribe as Admin button.

2. Select Page Settings for that page.

3. Find the Show Left Navigation setting and select Yes from the dropdown menu.
4. Select Save Setting.

Page settings are unique to each page, so you will need to repeat this process and adjust this setting individually for each page you plan to embed.

Can I embed the schedule for just one day?

Yes, you can embed the schedule for just one day. To do this, follow the steps below:

1. When adding pages to your navigation (refer to Step 2 in the Setup section), select the ‘Browse by Date’ option. This will create a ‘Browse by Date’ parent item, with a child item for each day of the event.

2. Launch the webpages for each day and save the URLs.

Can embedded pages support ‘popup mode’?

No, popup mode is not supported. Even if the website is configured for popup mode, the embedded version of the page will override that setting and display in full-page mode.