eComStyle.de UserAgent
Modul zum Abfragen des UserAgents (zB. iphone, android) oder DeviceTypes (Mobile o. Desktop).
Die Useragents können in den Moduleinstellungen angepasst werden.
[text-blocks id=“readme-modul-install“]
Moduleinstellungen:
Unter Erweiterungen/Module/ finden Sie im Bereich „Einstell.“ folgende Einstellmöglichkeiten:
Grundeinstellungen:
Useragents hier eintragen, ein Useragent je Zeile.
Standard:
iphone ipad ipod android webos htc fennec iemobile blackberry bb10 symbianos nokia opera mobi
In diesem Einstellungen sind die Mobile-Useragents einzutragen. Wird ein in dieser Auflistung enthaltener Useragent beim Seitenbesucher erkannt, kann er mit „getUserAgent()“ ausgegeben werden. Mit „getDeviceType()“ wird bei einen erkannten Useragent aus der Auflistung „Mobile“ ausgegeben, ansonsten „Desktop“.
UserAgent ausgeben:
Smarty-Abfragen des Useragents oder des Devicetypes (zB. im Shoptheme oder in Email-CMS-Seiten):
[{* Zeigt den in den Moduleinstellungen hinterlegten Useragent, sofern dieser beim Besucher erkannt wird: *}]
[{$oViewConf->getUserAgent()}]
[{* Wird mit "getuserAgent" ein Useragent erkannt, wird hiermit "Mobile" ausgegeben, ansonsten "Desktop": *}]
[{$oViewConf->getDeviceType()}] Es ist vorteilhaft, die obigen Abfragen nur dann zu nutzen, wenn das Modul tatsächlich aktiviert ist, da ansonsten eine Fehlermeldung ausgegeben wird. Hierfür können die Abfragen in eine weitere Abfrage gesetzt werden, welche zuerst prüft, ob das Modul tatsächlich aktiv ist:
[{if class_exists("useragentviewconfig")}]
[{$oViewConf->getUserAgent()}]
[{$oViewConf->getDeviceType()}]
[{/if}] Eine weitere Abfrage, die stets den gesamten Useragent eines Besuchers ausgibt ist möglich:
{if class_exists("useragentviewconfig")}]
[{$oViewConf->getFullUserAgent()}]
[{/if}] Beispielanwendung in der Bestellbestätigung an den Admin:
Um in der Bestellbestätigungsemail für den Shopadmin den Useragent des Kunden zu zeigen, könnte folgender Beispieltext den Standardtext der CMS-Seite „Ihre Bestellung Admin“ (oxadminorderemail) ersetzen:
Folgende Artikel wurden soeben unter [{ $shop->oxshops__oxname->value }] bestellt:<br>
<br>
[{if class_exists("useragentviewconfig")}]
Endgerät: [{$oViewConf->getUserAgent()}] [{$oViewConf->getDeviceType()}]
<br>
[{/if}] So werden im oberen Bereich der Admin-Email die Infos zum verwendeten Endgerät dargestellt.
Beispielanwendung im Theme oder CMS-Seiten als Abfrage:
Sie können bestimmten UserAgents oder Devicetypes gezielt Inhalte anbieten mit Abfragen gem. folgenden Beispielen:
[{if class_exists("useragentviewconfig")}]
[{if $oViewConf->getUserAgent() == 'iphone'}]Mir gefällt Ihr iPhone![{/if}]
[{if $oViewConf->getDeviceType() == 'Mobile'}]Schön, dass Sie mobil surfen![{/if}]
[{/if}] In obigen Beispiel liefert die erste Abfrage nur für Besucher mit dem Useragent „iphone“ eine Ausgabe, während die zweite Abfrage (Mobile) für sämtliche in den Moduleinstellungen eingetragen Useragents eine Ausgabe liefert.
[text-blocks id=“readme-modul-ende“]