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.
Banner behavior
- 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.
Recommended dimensions
| Integration | Device | Size |
|---|---|---|
| Modal (recommended) | Desktop | 1160 × 700 px |
| Modal (recommended) | Tablet and mobile | 100% × 100dvh |
| Embedded | Desktop | 1200 × 720 px |
| Embedded | Mobile | 100% × 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.