Description
FullBL Menu Sync for Loyverse connects WordPress directly to the Loyverse API (no intermediary SaaS). It imports categories, items, descriptions, images, prices, availability, and variants into a custom post type and taxonomy, then keeps them updated via manual sync, WP-Cron, and optional webhooks.
Configure a currency symbol and whether it appears before or after the price. Accent color and spacing apply on the frontend via CSS custom properties.
This plugin is not affiliated with or endorsed by Loyverse.
Features
- Direct Loyverse API connection with token and store selection
- Custom post type for dishes and taxonomy for categories
- Idempotent background sync in batches (no duplicates, no parallel runs)
- Manual sync, WP-Cron reconciliation, and webhook endpoint (fast 200; work runs in a job)
- Shortcode
[fbmsl_menu] - Responsive list/grid layouts with accent, gap, and currency display settings
- Editorial locks so sync does not overwrite locked title, content, or image
- Translation-ready (works alongside WPML, Polylang, or TranslatePress)
Shortcode
[fbmsl_menu]
[fbmsl_menu category="antipasti" layout="list" columns="1"]
External services
This plugin communicates with Loyverse when you configure an API token and use sync, connection test, webhook registration, or scheduled sync.
- What is sent: Your Loyverse personal access token (Bearer) in the
Authorizationheader; store ID and webhook URL when registering webhooks; standard HTTP request metadata. Loyverse returns catalog data (categories, items, images, prices, inventory, store list). - When: On “Test connection”, “Sync now”, WP-Cron sync, webhook-triggered sync, and “Register webhook” in Settings → FullBL Menu Sync for Loyverse.
- Where:
https://api.loyverse.com/v1.0(Loyverse REST API). Product images may be downloaded from URLs provided by Loyverse during sync. - Terms: Loyverse Terms of Use
- Privacy: Loyverse Privacy Policy
No other third-party analytics or tracking services are used by this plugin.
Installation
- Upload the plugin folder to
/wp-content/plugins/fullbl-menu-sync-for-loyverseor install via ZIP from Plugins → Add New → Upload Plugin. - Activate the plugin through the Plugins screen.
- Go to Settings → FullBL Menu Sync for Loyverse, enter your Loyverse API token, select a store, and click Sync now.
- Visit
/menu/(or your configured permalink base). Category archives use/menu-category/{slug}/by default.
FAQ
Does this create orders or use WooCommerce?
No. This plugin displays a public menu only.
Will sync overwrite my edits?
By default, yes for title, description, and image. Use the “Sync Locks” metabox on an item to preserve local edits. Price, variants, and availability are always updated from Loyverse.
What happens to items deleted in Loyverse?
After a complete sync pass, missing items are set to draft by default (or moved to trash if you choose that in settings). Optionally delete only the featured image imported by the plugin — never media you attached yourself.
How do I show a currency symbol on prices?
In Settings → Display, set Currency symbol (for example € or $) and Currency position (before or after the price). Leave the symbol empty for a bare number. Developers can still filter output with fbmsl_format_price.
How do webhooks work locally?
The webhook URL must be publicly reachable over HTTPS. For local development use a tunnel (ngrok, cloudflared). WP-Cron and Sync now work without a tunnel.
What happens when I uninstall?
Plugin options, the webhook secret, and scheduled cron events are removed. Synced menu posts and media remain in your database unless you delete them manually.
Screenshots
![The [fbmsl_menu] shortcode on a page (Twenty Twenty-Five): items grouped by category in a responsive grid, with images, descriptions, prices and variants synced from Loyverse.](https://ps.w.org/fullbl-menu-sync-for-loyverse/assets/screenshot-1.png?rev=3720729)
![List layout for a single category: [fbmsl_menu category="coffee" layout="list" columns="1"].](https://ps.w.org/fullbl-menu-sync-for-loyverse/assets/screenshot-2.png?rev=3720729)



Changelog
0.2.0
- More reliable sync: background batches with checkpoints (categories → items → inventory → cleanup).
- Manual sync, cron, and the items.update webhook share one idempotent job (Action Scheduler when available).
- Store-level lock prevents parallel runs; webhook bursts coalesce into a single follow-up.
- API retries with backoff on 429/5xx; invalid/expired tokens stop the run and show an admin notice.
- Skips unchanged items via a sync hash; images re-download only when the Loyverse URL changes.
- Setting for items removed upstream (draft or trash); optional cleanup of plugin-imported images only.
- Admin status shows last run, in-progress phase/items, pending flag, and last error.
- Settings UX: separate toggles for single pages, items archive, and category archives (each with its permalink); columns hidden for list layout; store selection always saved; deferred rewrite flush; fix fatal memory error on Save settings.
0.1.0
- Initial public release.
