Velantio
All docs

WordPress plugin

Gutenberg block, [velantio] shortcode, optional server-side rendering with a license.

What the plugin gives you

A native Gutenberg block ("Velantio Table") and a [velantio id="..."] shortcode for classic editor and theme templates. Two modes:

  • Lite (free) — wraps the universal JS embed. Identical to dropping the snippet into a Custom HTML block, but more convenient. Available on the WordPress.org plugin directory.
  • Premium (license required) — fetches the table on the server, caches it for an hour in a WordPress transient, and inserts the HTML straight into the page. Search engines see the products in view-source, not just after JavaScript runs.

A license is auto-issued for any Velantio account on a paid Tables plan (Monthly or Annual). Find it at Dashboard → Settings, copy it, paste it into Settings → Velantio in WordPress admin.

Install

  1. WordPress admin → Plugins → Add New → Upload Plugin, upload the ZIP from your dashboard download (or search the WP.org directory for Velantio Tables).
  2. Activate.
  3. (Optional, for SSR) Settings → Velantio → paste your license key → Verify and save. You should see "License verified. Server-side rendering is active."

Use the block

In the post editor, search for Velantio Table. Insert. In the sidebar, paste your table ID (the 12-character string from the URL /dashboard/tables/THIS_PART). Save.

In the editor you'll see a lightweight placeholder so you don't wait on a remote fetch. The front-end shows the real thing.

Use the shortcode

[velantio id="abc123xyz"] — works in classic editor, in theme templates, anywhere shortcodes resolve.

How SSR works

When a license is active:

  1. Plugin checks the local transient cache for this table ID
  2. Cache miss → GET https://velantio.com/v1/t/{id}
  3. Inserts the returned HTML + CSS directly into the post output
  4. Stores the JSON in a 1-hour transient

When you edit the table in the Velantio dashboard, the JSON cache at Cloudflare is purged immediately, so visitors will see fresh content within an hour at most (a refresh of the WP page pulls a new transient).

License lifecycle

  • Activate — Settings page Verify button calls /api/v1/licenses/activate.
  • Heartbeat — daily WP-Cron checks /api/v1/licenses/heartbeat. Cached for 30 days even if Velantio is unreachable, so a transient outage won't downgrade you.
  • Disconnect — the same settings page has a Disconnect license button. Plugin reverts to lite mode and clears local options.
  • Uninstall — removing the plugin sends one final /licenses/deactivate call and removes all options + cached transients.

Local development override

Add to wp-config.php if you're testing against a local Velantio app:

define( 'VELANTIO_API_ORIGIN', 'http://localhost:3000' );

Compatibility

Requires WordPress 6.0+ and PHP 8.0+. Works with the block editor and the classic editor. Compatible with most caching plugins (WP Rocket, W3 Total Cache, LiteSpeed Cache) — the plugin's own transient cache layers cleanly on top of theirs.