SommelierX Wine Pairing

الوصف

SommelierX Wine Pairing brings intelligent food-pairing suggestions to your WooCommerce store, powered by SommelierX’s proprietary Wine DNA matching. It helps customers discover the perfect dish for every bottle — increasing engagement, time on page, and conversions.

Install and you’re connected — no account needed. Click one button and the plugin verifies your domain and sets everything up for you. There is no separate sign-up, and no API key to copy or paste. It just works.

Free while we perfect it. SommelierX is free while we build it together with early stores. Tell us what you need and we will build it.

External services disclosure

This plugin relies on the SommelierX service:

  • On “Connect”, the plugin briefly publishes a random verification token at /wp-json/sommelierx/v1/handshake and asks https://api.sommelierx.com to provision your store; SommelierX fetches that token to confirm you own the domain, then returns your widget key. No account or password is involved.
  • On “Import your catalog”, SommelierX reads your published products from the public WooCommerce Store API (/wp-json/wc/store/products) to build your wine assortment.
  • On product pages, the plugin loads a script from https://sommelierx.com/widget/v1.js, which sends the wine’s product information (name, ID, and your widget key) to https://api.sommelierx.com to fetch pairings.
  • No customer personal data is sent — only product and widget usage information.

Terms of service: https://sommelierx.com/terms
Privacy policy: https://sommelierx.com/privacy

Three ways to show pairings:

  • Product mode — Food-pairing suggestions on individual wine product pages: customers see which dishes pair best with the wine they are viewing.
  • Search mode — A search bar where visitors type a dish (or even a single ingredient) and get wine recommendations from your catalog.
  • Multilingual — Search and results in Dutch or English.

Key features:

  • One-click connect — install, click “Connect to SommelierX”, done. No account.
  • One-click catalog import from the WooCommerce Store API — recognised wines go live instantly, the rest are staged for a quick review.
  • Search by dish name or ingredient, in Dutch or English.
  • Light and dark theme to match your store.
  • Configurable accent color for brand consistency.
  • Loads asynchronously — no impact on page speed.
  • Works with WooCommerce HPOS (High-Performance Order Storage).
  • Fully responsive on mobile and desktop.

لقطات الشاشة

التنصيب

  1. Download the plugin ZIP file.
  2. In your WordPress admin, go to Plugins > Add New > Upload Plugin.
  3. Upload the ZIP file and click Install Now, then Activate.
  4. Go to WooCommerce > SommelierX in the admin menu.
  5. Click Connect to SommelierX. That’s it — your store is connected automatically, no account or API key needed.
  6. Click Import your catalog to bring in your wines.
  7. Optionally set your mode, theme, language, and accent color, then Save Settings.

الأسئلة المتكررّة

Do I need a SommelierX account?

No. Click Connect to SommelierX on the settings page and the plugin verifies your domain and sets everything up for you. No sign-up, no API key to copy.

How does the automatic connection work?

When you click Connect, the plugin publishes a one-time random token at /wp-json/sommelierx/v1/handshake. SommelierX fetches that token to confirm you control the domain, then hands back your widget key, which the plugin stores for you. The token is deleted straight after.

How do I import my wines?

Click Import your catalog. SommelierX reads your published products from the public WooCommerce Store API. Wines we recognise go live in the widget immediately; anything we’re unsure about is staged for a quick review.

Is it really free?

Yes — it’s free while we perfect it with early stores. Use the feedback button on the settings page to tell us what you need.

Can I still enter a key manually?

Yes. The API key field is still there as a fallback if you’d rather paste a key from the SommelierX dashboard.

Does this plugin slow down my site?

No. The widget script loads asynchronously with defer, so it does not block page rendering.

Can I customize the widget appearance?

Yes — choose a light or dark theme, set a custom accent color, and optionally add a CSS class for further styling.

Does it work with variable products?

Yes. The widget works on all WooCommerce product types, including simple, variable, and grouped products.

المراجعات

لا توجد مراجعات لهذه الإضافة.

المساهمون والمطوّرون

“SommelierX Wine Pairing” هو برنامج مفتوح المصدر. وقد ساهم هؤلاء الأشخاص بالأسفل في هذه الإضافة.

المساهمون

ترجمة ”SommelierX Wine Pairing“ إلى لغتك.

مُهتم بالتطوير؟

تصفّح الشفرة، تحقق من مستودع SVN، أو الاشتراك في سجل التطوير بواسطة RSS.

سجل التغييرات

1.1.0

  • One-click “Connect to SommelierX” — account-less setup with automatic domain verification (no API key to copy).
  • One-click “Import your catalog” from the WooCommerce Store API — recognised wines go live, the rest are staged for review.
  • Live status line on the settings page (wines live vs. awaiting review).
  • Feedback card — SommelierX is free while we perfect it with early stores.
  • Manual API key field kept as a fallback.

1.0.0

  • Initial release.
  • Product mode and search mode support.
  • Light and dark theme.
  • Dutch and English language support.
  • WordPress color picker for accent color.
  • WooCommerce HPOS compatibility.
  • Clean uninstall — removes all options.