WeDesignHandmade widgets — embed documentation

WeDesignHandmade makes five small widgets for digital invitations: a countdown, a music player, an RSVP form, an add-to-calendar card, and a location map. They’re designed to be embedded in invitations built with Canva (Apps → Embed) or in any web page. People create them with a free account at wedesignhandmade.it/widget/, and each widget gets its own link.

  • Standalone pages served over HTTPS, with no ads, no cookies, and no tracking scripts. Fonts are hosted on our server.
  • Widget settings are saved in the creator’s account. Music files uploaded by the creator are stored on our server. The RSVP form stores guests’ replies for the person who created it. See our privacy policy.
  • Embeddable anywhere: widget pages don’t send X-Frame-Options or a CSP frame-ancestors directive.
  • Responsive: widgets scale to the width of the frame. Widget pages are noindex.

1. Widget links

WidgetLink
Countdown, music player, add-to-calendar card, maphttps://wedesignhandmade.it/widget/w/<code>/
RSVP formhttps://wedesignhandmade.it/widget/rsvp/<code>/ (the /widget/w/<code>/ link also works)

<code> is a random 12-character code. Settings are tied to the code, so the URL itself carries no parameters. Optional: ?cornice=W or ?cornice=WxH (60–1200 px) sets the frame size the widget declares.

The add-to-calendar card and the map can also be set up as plain buttons. In that case, the link redirects (302) to Google Calendar or Google Maps and can’t be embedded.

2. Embed sizes

Widget pages declare an aspect ratio and a maximum width (aspect-ratio: W/H; max-width: W), not a fixed height. Defaults:

WidgetDefault size (px)
Countdown400 × 160 (400 × 100 without labels)
Music player400 × 220
RSVP form440 wide; height depends on the questions (200–1200)
Add-to-calendar card400 × 196, taller with a location or description
Map400 × 130 with one place, 400 × 236 with two

3. Discovery and oEmbed

The <head> of every embeddable widget page includes a <link rel="iframely …"> tag (player audio for the music player, app for the others), a <link rel="alternate" type="application/json+oembed"> tag, og: tags, and a rel="canonical" link.

oEmbed endpoint: https://wedesignhandmade.it/wp-json/wdh-widget/v1/oembed?url=<widget URL>
Supports JSON only. Optional parameters: maxwidth and maxheight (size is scaled down to fit, never up). Returns type: "rich" with an <iframe>. Unknown URLs, and add-to-calendar or map links set up as plain buttons, return 404; formats other than JSON return 501.

4. Previews with URL parameters (no account needed)

Legacy links with settings in the URL still work for quick previews:

WidgetLinkMain parameters
Countdown/widget/countdown/?d=…d event date and time, YYYY-MM-DD or YYYY-MM-DDTHH:MM (required); z time zone (IANA, default Europe/Rome); u units, any combination of y o w d h m s (default dhms); f font: cardo, cormorant, playfair, bodoni, montserrat, roboto, josefin, quicksand, arrotondato (default cardo); l label language, it or en; c number color, hex without # (default 444444); a color of the last unit (default b39ddb); bg background, transparent or hex
Music player/widget/musica/?src=…src direct https link to an .mp3 file, URL-encoded (required); s button style, chiaro (light) or scuro (dark); l language, it or en
RSVP form/widget/rsvp/?…preview only: replies are not sent or saved
Map/widget/dove/?n1=…&i1=…n1, i1, e1 name, address, and label of the first place; n2, i2, e2 for a second place; l language, it or en

The music player never autoplays: playback starts when the guest taps the button, and the track loops. With src, the file plays from where it’s hosted: we don’t copy it or proxy it. Creators must use music they have the rights to.

Contact

WeDesignHandmade — info@wedesignhandmade.it