About this plugin
Velop GiftNote lets shoppers attach an included written greeting card, personal voice, video, or uploaded media message to a WooCommerce order from the product page or checkout. Written cards are saved directly on the WooCommerce order and print without a QR code. Voice, video, and uploaded media use a printable QR card.
Shoppers can reserve a media GiftNote at checkout and complete it from a secure, no-login recording link after payment.
The plugin stores the Velop message ID and written-card details on WooCommerce order metadata and communicates with the Velop API through WordPress AJAX handlers. The Velop API key is stored server-side and is never exposed to the storefront.
External services
media. This service is required to register GiftNotes, create upload URLs, store uploaded media, generate QR viewer links for voice and video messages, render media recipient pages, report GiftNote usage, and sync message status for the merchant portal. Written-card content is also retained directly on the WooCommerce order so the merchant can read and print it without a QR or viewer link.
mp4 so shoppers can quickly understand the QR voice and video GiftNote flow before opening the form.
When a shopper creates a GiftNote, the plugin sends the merchant API key, pending order reference, sender name when provided, media type, and—for written cards—the recipient, occasion, and message text. For media GiftNotes it also sends the MIME type and file size, then uploads the shopper’s media file using the upload URL returned by the API.
When the shopper chooses to record later, Velop creates a private completion token and returns a secure completion URL that WooCommerce stores on the order and includes in customer order communications.
When the upload is confirmed, the plugin sends the Velop message ID, upload path, and duration when available. After checkout, it syncs the final order ID, order number/reference, order status, and billing or shipping name when the GiftNote sender name was left blank. If an order is cancelled, the plugin sends the Velop message ID so the related GiftNote can be cancelled.
media/terms
media/privacy
Source and build process
js so the plugin does not load executable code from a third-party CDN by default.
js.
Build process:
- Run npm install from the Velop project root.
- Run npm --workspace @velop/widget run build to generate the widget bundle.
- Run node apps/portal/scripts/package-plugin.js to copy the built widget into assets/widget.js and include the readable widget source in the release ZIP.