RBA Einbauanleitung: Gambio 3

Anleitung für die Integration des RBA-Widgets in Gambio 3

Benötigte Applikationen

• RBA-Widget Version 0.9.2

• Gambio 3.x

Den entsprechenden Eintrag zum Templateset findst du im Backend unter:

{block name="checkout_success" prepend}
<script type="text/javascript">
    var fetched_data = {
        'shop_name': '{$rba_shop_name}',
        'email': '{$rba_customer_email}',
        'shop_type': '14',
        'order_value': '{$rba_order_value}',
        'shipping_value': '{$rba_shipping_value}',
        'language': 'de',
        'url': '{$rba_url}',
        'token': '{$rba_token}'
    };
</script>
<script type="text/javascript" src="https://rba.shopauskunft.de/js/rba_widget.js" id="rba_widget" async></script>
{/block}

<script type="text/javascript">
    var fetched_data = {
        'shop_name': '{$rba_shop_name}',
        'email': '{$rba_customer_email}',
        'shop_type': '14',
        'order_value': '{$rba_order_value}',
        'shipping_value': '{$rba_shipping_value}',
        'language': 'de',
        'url': '{$rba_url}',
        'token': '{$rba_token}'
    };
</script>
<script type="text/javascript" src="https://rba.shopauskunft.de/js/rba_widget.js" async></script>

Bereitstellung der Daten

Bei Gambio ist es nötig, dass die benötigten Daten für das RBA vorab bereitgestellt werden. Dazu muss ein sogenannter Overload erstellt werden.

Im Ordner GXModules erstelle den Ordner

sofern dieser noch nicht existiert.

Im Ordner GambioCustom erstelle folgende Ordnerstruktur

und erstellen darin die Datei

mit folgendem Inhalt

<?php
/* --------------------------------------------------------------
   RBACheckoutSuccessExtender.inc.php (2019)
   Händlerbund Management AG
   https://www.haendlerbund.de
   --------------------------------------------------------------
*/

/**
 * Class RBACheckoutSuccessExtender
 * This overloads the CheckoutSuccessExtenderComponent.
 */
class RBACheckoutSuccessExtender extends RBACheckoutSuccessExtender_parent
{
    private $shop_name = 'Ihr Shopname';
    private $xc_label = 'SA00xxxxx'; // Shopauskunft Kundennummer bzw. xc_label

    /**
     * Adds custom checkout data to html_output_array.
     */
    public function proceed()
    {
        parent::proceed();

        $orderId = new IdType($this->v_data_array['orders_id']);

        $orderReadService = StaticGXCoreLoader::getService('OrderRead');
        $order = $orderReadService->getOrderById($orderId);

        $seed = $this->xc_label . '|' . (string)$orderId->asInt();
        $token = base64_encode(openssl_encrypt($seed,'aes128','c2hvcGF1c2t1bmZ0', 0, 'aGFlbmRsZXJidW5k'));

        $this->v_output_buffer['rba_order_id'] = (string)$orderId->asInt();
        $this->v_output_buffer['rba_customer_email'] = (string)$order->getCustomerEmail();
        $this->v_output_buffer['rba_order_value'] = (string)$order->getOrderTotals()->getArray()[0]->getValue();
        $this->v_output_buffer['rba_shipping_value'] = (string)$order->getOrderTotals()->getArray()[1]->getValue();
        $this->v_output_buffer['rba_token'] = (string)$token;
        $this->v_output_buffer['rba_shop_name'] = $this->shop_name;
        $this->v_output_buffer['rba_url'] = $_SERVER['HTTP_HOST'];
    }
}

Individuelle Anpassung in Code

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

$shop_name hier bitte deinen Shopnamen eintragen

Cache leeren

im Backend für Administratoren den Cache für die Seitenausgabe und die Modulinformationen leeren

• Gambio Admin → Toolbox → Cache → Cache für Seitenausgabe leeren → [Ausführen]

• Gambio Admin → Toolbox -> Cache → Cache für Modulinformationen leeren → [Ausführen]

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.