Ir para o conteúdo
Fipeo

Fipeo for developers

Widget and WordPress

Early access. The API, the webhooks and the widget are switched off for most accounts while we try them with the first schools and agencies. This documentation is public so you can plan your integration: write to [email protected] and we switch it on for you.

The price widget shows courses with live prices on your own website. The visitor chooses course, start date, weeks and accommodation, sees the price and sends a booking request. For a school, the request reaches its booking inbox (confirmed at once if there are places); for an agency, it enters its CRM as a student with an opportunity. No commission or net price is ever shown.

Create a widget

  1. School: Booking form for your website › Price widget. Agency: Price widget in the menu (owner or administrator).
  2. Choose what it shows (courses and accommodation, or schools for an agency), its language and colour, whether the phone is required, whether to show the price breakdown or only the total, and the link to your terms.
  3. Add the addresses of your website where it will be embedded (for example https://www.myschool.com). The browser only lets the widget appear on those sites.
  4. Switch it on and press Copy the code. You can have up to 10 widgets.

Embed it

The light script (recommended): it creates the iframe and adjusts its height to the content. It reads nothing from your page and sets no cookies.

html
<div data-fipeo-widget="wXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" data-lang="es"></div>
<script src="https://fipeo.net/w/embed.js" async></script>
AttributeWhat it does
data-fipeo-widgetThe key of the widget (w + 31 characters). Required.
data-langen, es, fr, it, de or pt. By default, the language of your page.
data-heightInitial height in pixels (default 640). It then follows the content.
data-titleTitle of the iframe, for screen readers.

Or a plain iframe, if your website does not allow scripts (its height does not adjust by itself):

html
<iframe src="https://fipeo.net/api/v1/public/widget/wXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/frame?lang=es"
        title="Prices and booking" style="width:100%;min-height:640px;border:0" loading="lazy"></iframe>

You can also share a direct link: https://fipeo.net/w/<key>.

WordPress

The Fipeo plugin adds a shortcode. Paste it into any page or post:

text
[fipeo_widget key="wXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" lang="es" height="800"]
  • lang and height are optional (the language of your site and 640 pixels by default).
  • The plugin only prints the widget’s <div> and loads embed.js from Fipeo: it stores nothing and sends nothing from your server.
  • It is not in the WordPress directory yet: ask [email protected] for the .zip and upload it in Plugins › Add new › Upload plugin.

Security

The widget lives in an iframe on fipeo.net, with a strict content security policy: scripts only from Fipeo and frame-ancestors limited to your addresses. Requests are signed and time-limited, have a trap for robots and per-address limits, and the consent box is never pre-ticked (the exact text the visitor accepted is saved).