Partner-Menübox im Gambio Affiliate-Modul anpassen

Was ist die Partner-Menübox und wie kann ihr Erscheinungsbild verändert werden? Die Menübox aktivieren wir im Admin-Menüpunkt Optionen des Affiliate-Moduls für Gambio. Sie dient eingeloggten Partnern als (Partner-)Linkgenerator während der Navigation durch unseren Onlineshop. Das Erscheinungsbild wird mittels Template-Datei geändert.

Was ist die Partner-Menübox?

Yogamatte (grün), Empfehlungslink zu dieser Seite, Teile und verdienen mit Facebook, Twitter, Pinterest, WhatsApp
Partner-Menübox mit Affiliate-Link zur aktuellen Seite

Die Partner-Menübox erfüllt im Wesentlichen zwei Funktionen. Zum einen zeigt sie eingeloggten Affiliates auf jeder Content-, Artikel- und Kategorieseite unseres Onlineshops den Empfehlungslink zur aktuellen Seite an. Das ist im Grunde die URL der Seite gefolgt von einem Fragezeichen und der Partner-ID. Dennoch erleichtert es dem Partner das Kopieren bzw. Generieren der Empfehlungslinks.

Gleichzeitig enthält die Menübox einen Link zurück in den Partner-Bereich. Auf diese Weise entfallen aufwendig vorzunehmende und zu wartende Einträge in Gambio-Menüleisten via Usermod. Aufgrund der beiden genannten Funktionen ist die Menübox nur außerhalb der zum Partner-Bereich gehörigen Seiten sinnvoll und erscheint folgerichtig auch nur dort.


Wie passen wir sie an?

Inhalt und Layout der Partner-Menübox generiert das Modul aus der Template-Datei /GXModules/Werbe-Markt/PayPerSale/Shop/themes/All/affiliate_menubox.html. Anpassungen nehmen wir Update-sicher über das separate Modul PayPerSaleCustom vor, das per Smarty-Vererbung (extends) gezielt einzelne Blöcke der Original-Datei überschreibt, statt die komplette Datei zu kopieren.

Override-Datei erstellen

Damit daran vorgenommene Änderungen bei der Installation von Updates zum Affiliate-Modul nicht verloren gehen, legen wir unter demselben Dateinamen eine Datei im Custom-Modul unseres Shops an:

/GXModules/Werbe-Markt/PayPerSaleCustom/Shop/themes/All/affiliate_menubox.html

Als erste Zeile enthält diese Datei die Vererbung von der Original-Datei:

{extends file="{$smarty.const.DIR_FS_CATALOG}GXModules/Werbe-Markt/PayPerSale/Shop/themes/All/affiliate_menubox.html"}

Anpassungen vornehmen

Die Positionierung der Box steckt in einem eigenen Block namens affiliate_menubox_style_main. Um die Box beispielsweise statt unten links unten rechts anzuzeigen, überschreiben wir genau diesen Block:

{block name="affiliate_menubox_style_main"}
<style>
#WMAffiliateMenubox{
position:fixed;
bottom:10px;
right:0;
border-top-left-radius:5px;
border-bottom-left-radius:5px;
box-shadow:0 0 3.4px 0 #aaa inset;
background:#fff;
padding:1em;
z-index:10;
}
</style>
{/block}

Auf dieselbe Weise sind selbstverständlich weitere CSS-Anpassungen an der Box möglich, etwa über die ebenfalls einzeln benannten Blöcke affiliate_menubox_style_share (Icons zum Teilen) oder affiliate_menubox_script_main (JavaScript der Box).

Seit Version 1.3.8 des Affiliate-Moduls befindet sich die Partner-Menübox standardmäßig bereits unten links, damit sie nicht mit dem Gambio-Scroll-Top-Pfeil kollidiert – siehe der obige Block. Möchten Sie sie stattdessen wieder unten rechts anzeigen, verwenden Sie das CSS aus dem Beispiel oben.

Änderungen begutachten

Das Modul erkennt das Vorhandensein der Override-Datei automatisch und ohne Löschung eines der Gambio-Caches. Ein einfacher Reload der Seite genügt dennoch nicht, da die Menübox bei jedem Login in den Partner-Bereich generiert und zwischengespeichert wird.

Damit vorgenommene Änderungen wirksam werden, ist ein erneuter Login als Partner erforderlich. Seit Version 1.3 des Moduls genügt hierfür ein Login über den Gambio-Adminbereich. In allen vorherigen Versionen stand die Partner-Menübox nur bei der Anmeldung über das Login-Formular zur Verfügung.