Skip to content

Poltio/embed

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 

Repository files navigation

Poltio Embed Widgets

Dynamic Resizing via Poltio Resizer SDK

If you want to use Poltio Widgets in your page multiple times and don't want to give height information for all the widgets, you can use resizer sdk implementation.

Add the following line to somewhere in your HTML once and it will dedect Poltio Widgets and change their height attributes to fit the page. It will do all the calculations inside of the widget so it will not impact your page performance.

<script async src="https://platform.poltio.com/widget.js"></script>

Tracking Votes With Your Own IDs

By default all votes will have a Poltio User ID assigned to them. If you also want to track and match your own user ids with poltio user ids, you add a unique id to poltio widget source as a query string parameter (uuid)

<figure class="op-interactive">
    <iframe 
        id="poltio-embed-poll-148692" 
        class="poltio-embed" 
        src="https://www.poltio.com/e/poll/148692?uuid=XX" 
        width="100%" 
        height="500" 
        frameBorder="0" 
        allowFullScreen="allowfullscreen" 
        scrolling="yes" 
        title="Embed">
    </iframe>
</figure>

Here in this example, you need to update the XX with a unique id to identify that user. You can use your own user ids or create unique ids just to use in poltio widgets. This uuid information will be only available in your Poltio Pro dashboards as Publisher ID

Widget Details

Example Poltio Embed Widget;

<figure class="op-interactive">
    <iframe 
        id="poltio-embed-poll-148692" 
        class="poltio-embed" 
        src="https://www.poltio.com/e/poll/148692" 
        width="100%" 
        height="500" 
        frameBorder="0" 
        allowFullScreen="allowfullscreen" 
        scrolling="yes" 
        title="Embed">
    </iframe>
</figure>
  • Surrounding <figure> element is for article support for sites like Facebook etc...
  • Iframe ID attribute is for Poltio Resizer. If you remove this attribute even if you have resizer sdk on your page, it will not change this widget's sizes.
  • Width is the only fixed attribute, height and scrolling will be overwritten if Resizer SDK is active depending on the perfect fit.

Query String Parameteres

There are options that you can configure how the widget behaves via the Query String options:

uuid: This information is saved in Poltio DB with the Poltio unique user id and can be retrieved by you via our dashboards, api, webhooks or sheethooks. (eg &uuid=XXXX)

disclaimer: If you are already informing your visitors about cookie consent and want to disable Poltio Widget cookie consent, you can set this parameter to off. (eg: &disclaimer=off)

align: Poltio Widgets aligned themselves center by default in their iframe width. You can change this behavior by setting align=left or align=right (eg: &align=center)

loc: Poltio Widgets dedect device language and will use that language to display warnings or static texts. You can modify this by setting loc=en or loc=tr (eg: &loc=tr)

share_url: If you want to set a specific url for social share links at the end of the set, you can use this.

Loading Content Based on URL

If you don't want to put specific iframe snippets in your page and load a content based on your page url, you can refer to our SDK documentation:

https://platform.poltio.com/docs/

Releases

No releases published

Packages

No packages published