Savanna × RumX — Quelque chose d'extraordinaire arrive le 18 avril 💥

Widget RumX pour ton site

Ajoute des évaluations, avis et conseils de dégustation fiables à ta boutique en ligne, ton blog ou ton site — et aide tes visiteurs à choisir la bonne bouteille. Gratuit, sans clé API ni compte.

Pourquoi intégrer le widget RumX

Instaurer la confiance

Affiche de vraies notes communautaires basées sur 284 000+ notes de dégustation de passionnés de rhum

Aide les clients à se décider

Mets en avant les meilleurs avis et impressions de dégustation pour aider les visiteurs à choisir

Pour tous les goûts

La section "Parfait pour" indique à qui chaque rhum convient, du débutant à l'expert

Toujours à jour

Les notes et les avis se synchronisent automatiquement, aucune mise à jour manuelle n'est nécessaire

Léger

Le widget se charge de manière asynchrone et ne ralentit pas ta page

C'est gratuit, sans aucune limite

Pas besoin de clé API, pas besoin de compte, pas de limite d'utilisation


Générateur de code


Guides d'intégration des plateformes

Des instructions étape par étape pour les plateformes les plus populaires. Le widget fonctionne sur n'importe quel site web prenant en charge le HTML personnalisé.

Ajoute le widget RumX à tes pages de produits Shopify à l'aide d'un bloc Liquid personnalisé.

  • 1.
    Ouvre ton modèle de page produit
    Rends-toi dans Boutique en ligne → Thèmes → Personnaliser, puis ouvre le modèle de ta page produit.
  • 2.
    Ajouter un bloc de liquide personnalisé
    Dans la section de la page produit, clique sur « Ajouter un bloc » et sélectionne « Liquid personnalisé ». Colle le code du widget dans le champ Liquid.
  • 3.
    Utilise ce code Liquid pour une intégration automatique basée sur les codes EAN
    Cet extrait de code lit automatiquement le code-barres du produit (EAN) depuis Shopify et le transmet au widget — pas besoin d'entrer manuellement un RXID pour chaque produit.
{%- assign ean = product.selected_or_first_available_variant.barcode -%}
{%- if ean != blank -%}
<div class="rumx-widget"
     data-ean="{{ ean }}"
     data-lang="en">
  <a href="https://rumx.com/en/rums/">RumX Rum Rating</a>
</div>
<script src="https://rumx.com/api/widget/v1/embed.js"></script>
{%- endif -%}

Tip: Assure-toi que tes produits Shopify ont un code-barres (EAN) défini dans la section « Stock ». Le widget trouvera automatiquement le rhum correspondant.

Ajoute le widget RumX aux pages de produits WooCommerce. Tu peux coller le code pour chaque produit ou utiliser un extrait de code PHP pour une intégration automatique.

  • 1.
    Par produit : colle-le dans un bloc HTML personnalisé
    Modifie un produit, passe à l'onglet « Texte » dans l'éditeur de description, puis colle le code HTML de ton widget.
  • 2.
    Automatique : ajoute un extrait de code PHP à ton thème
    Ajoute le code suivant dans le fichier functions.php de ton thème ou dans un plugin de snippets de code. Il lit automatiquement le champ GTIN/EAN (disponible dans WooCommerce 9.2+) et affiche le widget sur chaque page produit.
// Add to functions.php or a code snippets plugin
add_action('woocommerce_single_product_summary', function() {
    global $product;
    $ean = $product->get_global_unique_id(); // WooCommerce 9.2+
    if (!$ean) return;
    echo '<div class="rumx-widget" data-ean="' . esc_attr($ean) . '" data-lang="en">';
    echo '<a href="https://rumx.com/en/rums/">RumX Rum Rating</a>';
    echo '</div>';
    echo '<script src="https://rumx.com/api/widget/v1/embed.js"></script>';
}, 35);

Tip: À partir de la version 9.2 de WooCommerce, un champ GTIN est intégré dans la section « Données du produit » → « Stock ». Pour les versions antérieures, tu peux utiliser un plugin comme « EAN for WooCommerce » pour ajouter des champs EAN.

Ajoute le widget RumX à n'importe quel article ou page WordPress à l'aide de l'éditeur de blocs.

  • 1.
    Ajouter un bloc HTML personnalisé
    Dans l'éditeur de blocs WordPress, ajoute un bloc « HTML personnalisé » et colle ton extrait de code pour le widget.
  • 2.
    Facultatif : créer un shortcode réutilisable
    Ajoute ce bout de code PHP au fichier functions.php de ton thème pour créer un shortcode [rumx_widget] que tu pourras utiliser n'importe où.
// Add to functions.php
function rumx_widget_shortcode($atts) {
    $atts = shortcode_atts(['rxid' => '', 'ean' => '', 'lang' => 'en'], $atts);
    $id_attr = $atts['ean'] ? 'data-ean="' . esc_attr($atts['ean']) . '"'
                            : 'data-rxid="' . esc_attr($atts['rxid']) . '"';
    return '<div class="rumx-widget" ' . $id_attr . ' data-lang="' . esc_attr($atts['lang']) . '">'
         . '<a href="https://rumx.com/en/rums/">RumX Rum Rating</a></div>'
         . '<script src="https://rumx.com/api/widget/v1/embed.js"></script>';
}
add_shortcode('rumx_widget', 'rumx_widget_shortcode');

Tip: Utilise le shortcode comme [rumx_widget rxid="313"] ou [rumx_widget ean="8024564013387"] dans n'importe quel article ou page.

Le widget fonctionne sur n'importe quel site web : il suffit de coller le bout de code HTML là où tu veux qu'il s'affiche.

  • 1.
    Colle le bout de code dans ton HTML
    Copie le code généré ci-dessus et colle-le dans le code HTML de ta page, à l'endroit où tu souhaites que le widget apparaisse.
  • 2.
    C'est tout
    Le script se charge de manière asynchrone et affiche automatiquement le widget. Aucune étape de compilation ni intégration à un framework n'est nécessaire.

SPA: Tu utilises une application monopage (React, Vue, Angular) ? Le script d'intégration inclut un MutationObserver qui détecte les éléments de widget ajoutés dynamiquement. Il suffit d'insérer la balise div dans le DOM pour qu'elle s'affiche automatiquement.


Guide de configuration

Personnalise le widget en utilisant ces attributs de données sur la balise div du widget.

AttributeValuesDefaultDescription
data-rxidNumberL'identifiant RumX du rhum à afficher. Tu le trouveras sur n'importe quelle page consacrée au rhum sur rumx.com.
data-eanNumberRecherche un rhum à l'aide de son code EAN/code-barres plutôt que de son RXID. Utile pour les intégrations automatiques avec les boutiques en ligne.
data-shopify-idNumberRecherche un rhum à l'aide de son ID de produit ou de variante Shopify (pour les boutiques partenaires de Shopify).
data-langen, de, frenLangue d'affichage de l'interface du widget.
data-variantfull, badgefullVariantes de mise en page du widget. « full » affiche le widget dans son intégralité, « badge » affiche un badge de notation compact.
data-reviewstrue, falsetrueAfficher ou masquer la section des extraits d'avis (version complète uniquement).
data-perfect-fortrue, falsetrueAfficher ou masquer la section « Idéal pour » contenant des conseils de dégustation (version complète uniquement).
data-themelight, darklightThème de couleurs. Utilise « sombre » sur les arrière-plans sombres.

Questions fréquentes

Oui — le widget est entièrement gratuit. Pas de clé API, pas de compte, pas de limites d’utilisation.

Le widget affiche la note communautaire, le nombre d’avis, les meilleurs avis et les conseils de dégustation “Parfait pour”. Les données sont mises à jour automatiquement.

Oui — colle simplement le snippet HTML dans n’importe quel site ou plateforme supportant le HTML personnalisé. Compatible avec Shopify, WordPress, Squarespace, Wix et plus.

Si un rhum n’est pas trouvé, le widget ne s’affichera tout simplement pas — ta page restera propre, sans éléments défectueux. Tu peux aussi nous contacter pour qu’un rhum soit ajouté à la base de données.

Non. Le script d’intégration est léger (~5 Ko) et se charge de manière asynchrone, il n’empêchera donc pas le chargement de ta page. Les données du widget sont récupérées à la demande et mises en cache.

Oui — utilise l’attribut « data-ean » à la place de « data-rxid ». C’est particulièrement utile pour les intégrations automatiques avec des plateformes de vente en ligne comme Shopify ou WooCommerce.

Utilise l’intégration basée sur les codes EAN avec un extrait de code de plateforme (voir les guides Shopify ou WooCommerce ci-dessus). Cela affiche automatiquement le widget sur chaque page produit pour laquelle un code-barres a été défini. Pour des solutions personnalisées en masse, contacte-nous.

Oui, le widget est entièrement adaptatif et s’adapte à toutes les tailles d’écran, de l’ordinateur de bureau au mobile.

Des questions ou besoin d'aide pour l'intégration ?

Contact avec nous