Download the PHP package gn2/newsletterconnect without Composer
On this page you can find all versions of the php package gn2/newsletterconnect. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download gn2/newsletterconnect
More information about gn2/newsletterconnect
Files in gn2/newsletterconnect
Package newsletterconnect
Short Description gn2 :: NewsletterConnect
License MIT
Homepage https://www.gn2.de
Informations about the package newsletterconnect
gn2/newsletterconnect Installation
Systemvoraussetzungen:
- OXID 6.0+
- PHP 7.0+
A) Mailingwork-Konto einrichten:
Bitte stellen Sie sicher, dass in Ihrem Mailingwork-Account zwei Anmeldesetups existieren. Ein Setup mit Double Opt-In (Hauptanmeldesetup) und ein Setup mit Single Opt-In (Kundenaccount). Beide Anmeldesetups sollten auf die selbe Abonnentenliste zeigen und folgende Felder enthalten:
- Anrede
- Vorname
- Nachname
- Sprache
- Anmeldestatus (optional)
Zudem benötigen Sie mindestens ein Abmeldesetup mit Single Opt-Out, welches auf die gleiche Abonnentenliste zeigt.
In den Berechtigungen des Mailingswork-Kontos muss bei Webservice folgendes aktiviert sein:
- SOAP Server V3
- JSON Rückgabe
- XML Rückgabe
Wir empfehlen zusätzlich einen eigenen Mailingwork-Nutzer für die API anzulegen.
B) gn2/newsletterconnect-Modul installieren
-
OPTIONAL: Vorheriges Modul entfernen Falls Sie bereits ein älteres Newsletterconnect-Modul installiert haben, dann deaktivieren Sie bitte zuerst das Modul.
Sollte Ihr aktuelles Modul älter als Version 3.0.0 sein, dann führen Sie nun folgende Composer-Befehle aus:
composer remove gn2/newsletterconnect
composer config --unset repositories.gn2/newsletterconnect
Entfernen Sie nun folgendes Verzeichnis aus Ihrem Shop (falls vorhanden):
/packages/gn2/newsletterconnect/
-
Führen Sie folgenden Befehl aus, um das neueste Modul zu installieren:
composer require gn2/newsletterconnect
composer update
-
Aktivieren Sie das Modul im OXID-Backend unter "Erweiterungen > Module".
-
Leeren Sie nun den Cache des Shops.
-
Nun können Sie unter "Shopeinstellungen > NewsletterConnect", das Modul konfigurieren.
- Mailingwork Webservice-URL: https://login.mailingwork.de/webservice/webservice/json/
- Benutzername: Benutzer zum Mailingwork-Account
- Passwort: Passwort zum Mailingwork-Account
Wie bereits erwähnt, empfehlen wir eigene Benutzerdaten für Newsletterconnect.
- ID des Hauptanmeldesetups: Dieses Anmeldesetup wird in der Registrierung und im Standalone-Newsletterformular verwendet. Wir empfehlen ein Double Opt-In Setup.
- ID des Hauptabmeldesetups: Dieses Abmeldesetup wird in der Registrierung und im Standalone-Newsletterformular verwendet. Wir empfehlen ein Single Opt-Out Setup.
- ID des Anmeldesetups (Kundenaccount): Dieses Anmeldesetup wird im Kundenaccount verwendet. Wir empfehlen ein Single Opt-In Setup.
- ID des Abmeldesetups (Kundenaccount): Dieses Anmeldesetup wird im Kundenaccount verwendet. Wir empfehlen ein Single Opt-Out Setup. Bestenfalls verwenden Sie das selbe Setup wie für die Hauptabmeldung, sofern Sie mit der selben Abonnentenliste arbeiten.
Mit den 2 Setups kann man die Kunden theoretisch unterschiedlich gruppieren, z.B. für einen Rabatt-Newsletter nur für Registrierte Shopkunden. Braucht man das nicht, dann für beide das selbe Anmeldesetup verwenden.
C) OPTIONAL: Gutscheincodeerweiterung
Falls Mailingwork Gutscheincodes vom Shop holen soll, dann führen Sie bitte die folgenden Schritte durch:
- Eine Gutscheinserie anlegen: "Shopeinstellungen > Gutscheinserien".
- Die gewünschte verfügbare Menge von Gutscheincodes generieren.
- Die API-Konfiguration ausfüllen (siehe Punkt "E").
- Unter "Shopeinstellungen > NewsletterConnect", die neue Gutscheinserie auswählen.
- Die gültigen Gutscheincodes Ihrer Gutscheinserie können nun mit der folgenden URL abgerufen werden (diese URL bitte Mailingwork mitteilen): http://www.ihr-oxid-shop.de/?mos_api=1&mode=getVoucher
D) OPTIONAL: Unterstützung von Profilmanageränderungen
- Die API-Konfiguration ausfüllen (siehe Punkt "E")
- Die erlaubten IP-Adressen können nun Profiländerungen mit der folgenden URL vornehmen (diese URL bitte Mailingwork mitteilen): http://www.ihr-oxid-shop.de/[email protected]&firstname=Bodo&lastname=Ballerböhme
E) OPTIONAL: API-Freischaltung
Tagen Sie unter "Shopeinstellungen > NewsletterConnect" alle IPs der Mailingworkserver und, falls notwendig, Ihre eigene IP ein: Pro Zeile eine IP-Adresse: 127.0.0.0 212.50.2.234 ... ...
F) OPTIONAL: Produktübergabe an Mailingwork
Das gn2_newsletterconnnect-Modul unterstützt die Übergabe von OXID-Produkten an Mailingwork. Diese Funktionalität erfordert eine Freischaltung der OXID-Erweiterung im Mailingwork-Account. Wenden Sie sich hierzu an Mailingwork.
- Im OXID-Backend unter "Benutzer verwalten > Benutzergruppen" eine neue Gruppe namens "Newsletter Admin" anlegen.
- Unter "Benutzer verwalten > Benutzer" einen neuen Benutzer anlegen und diesen Benutzer der Benutzergruppe "Newsletter Admin" zuweisen.
- Nachdem Mailingwork die Oxid-Erweiterung freigeschaltet hat, können Sie unter "Extras > Schnittstellen > OXID" nun die Zugangsdaten und die Shop-URL zu ihrem Shop eintragen.
- Die Produktübergabe kann mit der URL http://www.ihr-oxid-shop.de/modules/gn2/newsletterconnect/products.json getestet werden. Falls die URL nicht funktioniert, überprüfen Sie bitte ob die .htaccess Datei unter /source/modules/gn2_newsletterconnect/.htaccess vorhanden ist. Prüfen Sie auch, ob die RewriteBase der .htaccess entsprechend für Ihre Serverkonfiguration angepasst werden muss.
All versions of newsletterconnect with dependencies
oxid-esales/oxideshop-ce Version ^6.0
ext-curl Version *
ext-json Version *