RBA Einbauanleitung: WooCommerce

Anleitung für die Integration des RBA-Widgets in WooCommerce

Benötigte Applikationen

• Shopauskunft Widget Version 0.9.0

• Wordpress Version 5.2.3 (tested)

• WooCommerce Version 3.7.0 (tested)

Installation

Hinweis

Damit der Einbau der Rechtssicheren Bewertungsanfrage (RBA) bei Updates von Wordpress oder dem Plugin “WooCommerce” nicht überschrieben wird, ist es zwingend erforderlich, dass du das nachfolgende RBA-Script im Child-Theme einbaust. Entsprechend zahlreiche Anleitungen zur Nutzung und Erstellung eines Child-Themes findest du im Internet.

Vorgehensweise

Kopiere die Datei ‘thankyou.php’ aus dem Verzeichnis:

in das folgende Verzeichnis:

Gegebenenfalls musst du die Ordnerstruktur “/woocommerce/checkout/” in deinem Child-Theme neu anlegen. Sollte die Datei ‘thankyou.php’ in deinem Child-Theme bereits vorliegen, so muss diese nicht nochmals überschrieben werden und kannst das nachfolgende Script direkt einbauen.

Suche im Quelltext der Datei ‘thankyou.php’ nach

und füge das folgende Script vor diesem Codeblock ein.

Einzufügender Codeblock

<?php
$xc_label = 'SA00xxx'; 
$email = $order->get_billing_email();
$order_value = $order->get_total();
$order_shipping = $order->get_shipping_total();
$url_shop = get_permalink(woocommerce_get_page_id('shop'));
$shop_type = '6';
$seed = $xc_label.'|'.$order->get_id();
$token = base64_encode(openssl_encrypt($seed,'aes128','c2hvcGF1c2t1bmZ0', 0, 'aGFlbmRsZXJidW5k'));
$shopname = get_bloginfo( 'name' );
?>
<script type="text/javascript">
    var fetched_data = {
        'shop_name': '<?= $shopname; ?>',
        'email': '<?= $email; ?>',
        'shop_type': '<?= $shop_type; ?>',
        'order_value': '<?= $order_value; ?>',
        'shipping_value': '<?= $order_shipping; ?>',
        'language': '<?= get_locale(); ?>',
        'url': '<?= $url_shop; ?>',
        'token': '<?= $token; ?>' }
</script>
<script type="text/javascript" src="https://rba.shopauskunft.de/js/rba_widget.js" id="rba_widget" async></script>

Individuelle Anpassung in Code

In $xc_label muss deine Shopauskunft ID hinterlegt werden (z.B. S00033098).

Test-Installation (Sandbox)

Zum Testen der korrekten Enbindung/Konfiguration des Codeblocks im Template kann ein alternatives Widget adressiert werden.
Durch eine Testbestellung und der positiven Beantwortung der Bewertungsanfrage wird sofort im Anschluss eine E-Mail an den Testbesteller versandt, mit dem Hinweis auf die korrekte bzw. fehlerhafte Konfiguration des eingebundenen Codeblocks.

• Vorgehensweise → siehe normale Installation

• alternatives Widget sandbox_widget.js:

        <script type="text/javascript" src="https://rba.shopauskunft.de/js/sandbox_widget.js" async></script>

Hast du noch weitere Fragen? Wir stehen bereit zu helfen.