What's inside this article:
- Basic information
- Retrieve embed code
- Adjust embed settings
- Display the widget on a Pangea site
- Display the widget on a content page
Basic information
You can retrieve an embed code for the following Pangea widgets:
- Content widget
- FactCheck widget
- HTML widget
- Live stream widget
- Manual stream widget
- Multimedia widget
- Podcast widget
- Poll widget
- Subscription widget
- Trends widget
The embed code for a Pangea widget might be used as follows:
- Display the widget on another Pangea site.
- Display the widget on an external (non-Pangea) site.
- Display the widget in the body of a content page (such as an article).
After you embed a Pangea widget using an embed code, the content on the embedded widget will update automatically to match the content on the original widget.
Retrieve embed code
You can retrieve the embed code for a Pangea widget if the following conditions are met:
- The widget must already be saved in Pangea CMS. However, the widget does not need to be enabled (visible on the public site).
- The widget must be used on a page / segment. You cannot retrieve an embed code for a widget that is only saved in the Widget library.
To retrieve the embed code for a widget:
- Go to Build in the primary navigation.
- Choose the type of page / segment where the widget is used.
- Select the specific page / segment where the widget is used.
- Ensure Editor is selected in the left panel.
- Select the widget you want to embed. The widget builder opens.
- Select Embed code in the left panel.
- If needed, adjust the embed settings.
- Hit Copy next to the embed code.
The embed code is now copied to your clipboard.
Adjust embed settings
The following embed settings are available:
Width and height
Under Width and Height, optionally adjust the size of the embed. The following conditions apply:
- Width: You can enter a value in percent (%) or pixels (px):
- Percent: If the value you enter is 100 or lower, it is automatically applied as percent. For example, if you enter 100, the embed will cover 100% of the available width. If you enter 50, the embed will cover 50% of the available width.
- Pixels: If the value you enter is 101 or higher, it is automatically applied as pixels. For example, if you enter 500, the width of the embed will be 500px. The maximum value is 10000px.
- Height: You must enter the value in pixels (px). The value must be between 100 and 10000 pixels.
The preview updates automatically to show how the embed will look, according to your defined dimensions.
Enable scrolling
Select Enable scrolling if the whole widget is not visible in the embed. This adds scroll bars to the embed, so the whole widget is visible by manually scrolling.
Display the widget on a Pangea site
Your site can display a widget that was originally created by another Pangea site. This is possible by embedding the external widget on an HTML widget. An HTML widget (including an embedded Pangea widget) might be displayed on any of the following pages / segments:
- Section pages (including your homepage)
- Infopages
- Landings
- Regions
- You Might Also Like (YMAL)
To embed a Pangea widget on an HTML widget:
- Go to Build in the primary navigation.
- Choose the type of page / segment where you want to display the widget.
- Select the specific page / segment where you want to display the widget.
- Ensure Editor is selected in the left panel.
- Select the empty area where you want to display the widget.
- Select New widget > HTML to create a new HTML widget.
- Go to Content > Insert embedded content.
- Select External media.
- Under External media URL or embed code, paste the embed code.
- Under Personal note, optionally enter a note. Personal notes are displayed only in Pangea CMS (not on the public site). The purpose is to let other CMS users verify what has been embedded.
- Hit Attach.
You see a placeholder representing the embedded widget.
To learn about the remaining steps for creating an HTML widget, see the following article:
Display the widget on a content page
You can embed a Pangea widget into the body of a text content page. This option is available for the following content page types:
- Article
- Blog
- FactCheck (embed in the Verdict content)
- Feature
- Feature story
- Live blog (embed in a post)
- News
- Transcript
To embed a Pangea widget on a content page:
- Open the edit screen for the relevant content page in Pangea CMS.
- Via Editor, click inside the main box to reveal the CKEditor bar. Position the cursor where you want to insert the widget.
- Hit the Insert Embedded Content button.
- Follow steps 8 - 11 above.
You see a placeholder representing the embedded widget.
