RumX Widget for Your Website

Add the RumX widget to WooCommerce product pages. You can paste the code per product, or use a PHP snippet for automatic integration.

• 1.
  Per-product: paste into a Custom HTML block
  Edit a product, switch to the "Text" tab in the description editor, and paste your widget HTML snippet.
• 2.
  Automatic: add a PHP snippet to your theme
  Add the following code to your theme's functions.php or a code snippets plugin. It automatically reads the GTIN/EAN field (available in WooCommerce 9.2+) and renders the widget on every product page.

// 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: WooCommerce 9.2+ has a built-in GTIN field under Product data → Inventory. For older versions, you can use a plugin like "EAN for WooCommerce" to add EAN fields.

Add the RumX widget to any WordPress post or page using the block editor.

• 1.
  Add a Custom HTML block
  In the WordPress block editor, add a "Custom HTML" block and paste your widget snippet.
• 2.
  Optional: create a reusable shortcode
  Add this PHP snippet to your theme's functions.php to create a [rumx_widget] shortcode you can use anywhere.

// 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: Use the shortcode like [rumx_widget rxid="313"] or [rumx_widget ean="8024564013387"] in any post or page.

The widget works on any website — just paste the HTML snippet wherever you want it to appear.

• 1.
  Paste the snippet into your HTML
  Copy the generated code from above and paste it into your page's HTML where you want the widget to appear.
• 2.
  That's it
  The script loads asynchronously and renders the widget automatically. No build step or framework integration needed.

SPA: Using a Single Page Application (React, Vue, Angular)? The embed script includes a MutationObserver that detects dynamically added widget elements. Just insert the div into the DOM and it will render automatically.