Skip to main content

Integration mode

Integration mode is a developer tool that checks your iframe size. When it's on, the plugin shows a warning banner if the iframe doesn't match the recommended dimensions or is close to a breakpoint.

Development only

Use integration mode only during development and testing. Remove ?mode=integration from the iframe URL before going to production.

How to enable​

Add ?mode=integration to your iframe src:

<iframe
src="https://plugin.pulpoar.com/vto/<project-key>?mode=integration"
width="1200"
height="720"
style="border: none;"
></iframe>

What it detects​

The banner appears when:

  • Incorrect dimensions: the iframe size doesn't match the recommended size for the detected device type (desktop, tablet or mobile).
  • Breakpoint proximity: the iframe width is within 30 px of a breakpoint (700 px or 1135 px). This can make the layout switch unexpectedly.
  • Undersized height: on mobile, the iframe is shorter than the recommended 768 px. Content may be cut off or need too much scrolling.
  • The banner appears at the top of the plugin and doesn't affect the layout.
  • It can be dismissed. It appears again if the iframe is resized.
  • No banner is shown when the iframe matches the recommended dimensions.
IntegrationDeviceSize
Modal (recommended)Desktop1160 × 700 px
Modal (recommended)Tablet and mobile100% × 100dvh
EmbeddedDesktop1200 × 720 px
EmbeddedMobile100% × 768 px

Test tool​

Use the interactive test tool to try different iframe sizes and see how the banner behaves:

Open the Integration Mode Test Tool. Replace <project-key> in the URL with your own.