sc_typo3_magento

Vorwort

Der Typo3 Magento Connector besteht aus 2 Bestandteilen!

Einerseits aus dieser Typo3 Erweiterung und desweiteren aus einer Magento Erweiterung welche die normale Magento Api erweitert um mehr zu ermöglichen!

Wichtige Typo3 Anpassungen

• Über das Install Tool muss folgendes gesetzt werden: eine Cookie Domain gesetzt werden ([FE][cookieDomain]) welche auch in Magento gesetzt wurde. [SYS][cookieSecure] muss auf 2 gestellt werden. [FE][cookieName] muss auf PHPSESSID gestellt werden. Ansonsten können keine Magento2 Inbhalte geteilt werden, da die User Session unterschiedlich ist!

Magento 1

Achtung die Magento 1 integration beschränkt sich auf einfache Api Daten, für den vollen Funktionsumfang nutzen Sie den Connector bitte mit Magento 2!

Soap Api

Für Magento 1 nutzen wir die SOAP Api V2!

Folgende Rechte werden für den SOAP User benötigt.

• Core -> Store ( List + Info )
• Catalog -> Category -> read Data + read tree
• Catalog -> Product -> articledata (read)
• Catalog -> Product -> Images (read)

Wichtige Einstellungen in Magenot

• Store Code must be part if the Url ( /en/.... ) and not ?__storeCode=en
• Magento Catalog Url Rewrite will not work, typo3 will generate the normal category url, i think magento will redirect after calling the normal url but its a little bit ugly for SEO stuff (but not tested!)
• category url must be part of the product url ( if not some methods will return wrong url parts )

Installieren/Konfigurieren (Typo3 Seite)

• Typo3 Connector Erweiterung installieren
• Install Tool aufrufen und die Datenbank aktuallisieren
• Unter Erweiterungen die Erweiterungseinstellungen öffnen und die SOAP Daten sowie Store Daten eintragen
• Editieren Sie ihr Seiten "Template" und includieren Sie das entsprechende Typoscript des Modules

Magento 2

Rest Api

Die Magento 2 implementierung nutzt die Rest Api.

Magento Kategorien in Typo3 als Seiten anlegen

Sie können den Connector nutzen um Ihre Magento Kategorien als Typo3 Seiten (oder wahlweise Links) angelegt werden. Legen Sie hierfür eine Seite an oder editieren Sie eine. Sie sehen einen neuen Reiter "Magento Sync". Konfigurieren Sie hier welche Kategorien als Unterseiten(Links) angelegt werden sollen. Sie können auch einzelne Kategorien ausschließen.

Gehen Sie danach auf den Scheduler und fügen den Magento Sync Task hinzu. Sobald dieser ausgeführt wird, wird via Api die Kategorie Struktur anhand ihrer Einstellungen nach Typo3 übertragen.

Kategorie Änderungen

Sollten Sie Magento Kategorie Daten ändern werden diese Automatisch in Typo3 aktuallisiert sobald der Task erneust gestartet wird.

Die Seiten UID wird beibehalten

Kategorie löschen

Sollten Sie in Magento eine Kategorie löschen wird die Typo3 Seite "deaktiviert".

Kategorien deaktivieren

Sollten Sie eine bereits Syncronsierte Kategorie in Magento deaktivieren wird diese in Typo3 ebenfalls deaktiviert.

Kategorien sortieren

Beim Konfigurieren der Typo3 Syncronisation können Sie definieren ob die Position aktuallisiert werden soll.

Ist dies "nicht" aktiviert wird nur beim ersten Syncronsiieren die Position aus Magento übernommen! Nachträgliche Änderungen müssen dann in Typo3 manuell gemacht werden.

Dies ist hilfreich falls Sie andere (normale) Typo3 Seiten zwischen die Magento Kategorie Seiten einsortieren wollen.

Haben Sie hingegen die Option aktiviert wird bei jedem ausführen des Typo3 Tasks die Magento Position aktuallisiert.

Fluid Templates

Der Connector nutzt in Typo3 Fluid Templates.

Sie können ganz normal das Typoscript des Modules überschreiben um Ihre eigene Fluid Template Verzeichnisse anzugeben.

Dadurch können Sie jedes gewünschte Template überschreiben und ihren Anforderungen anpassen.

z.B.:

lib.sc_typo3_magento_subpages {
   templateName = Category/subpages.html
   templateRootPaths {
       90 = YOUR_PATH
   }
}

Magento Inhalte benutzen

Die folgenden "Content" Typen wurden hinzugefügt.

Diese Elemente funktionieren NUR auf Seiten die den Typ "Magento Page" haben!

Grund hierfür ist das die Information für die Magento Kategorie in der Seite hinterlegt sein muss.

Die Felder sind nur bei diesem Seiten Typen vorhanden!

( z.B.: alle automatisch angelegten Seiten über den Syncronisator )

Liste der importierten Unterseiten

Dieses Inhaltselement Zeigt eine Liste aller Unterseiten an.

Entspricht dem "Subpages" Typo3 Elementes bietet jedoch Template Zugriff auf die Connector Api

(siehe DataProcessing Klassen)

Daten einer Kategorie

Dieses Template dient dafür Daten der Kategorie der aktuellen Seite auszulesen und darzustellen.

Produktliste (Api)

Dieses Template bietet die Möglichkeit alle Produkte einer Kategorie auszulesen und darzustellen.

Achtung dies enthält keine Such und/oder Filtermöglichkeiten

Produktliste ( gerenderted HTML von Magento )

Hiermit wird die Magento Produkt Liste einer Kategorie gerendert und als HTML eingebunden.

Achtung es werden hier ebenfalls Magento JS und CSS eingebunden

Achten Sie daher bitte das Sie z.b JQuery und ähnliches nur im "noConflict" Modus benutzen!

Folgende Funktionen existieren derzeit "nicht"

• verschiedene Kategorie Strukturen je Magento Store ( man kann jedoch mit aktiv/inaktiv "in menü" arbeiten )
• automatisches verbinden von Store Code und Typo3 Sprache funktioniert NUR wenn der Store code dem Locale der Type3 Sprache entspricht! Ansonsten wird immer der Fallback Lokale der Erweiterungseinstellung genommen.

Tips

Genereller Typo3 Tip

"oops an error..."

fügt folgendes in euer Typoscript hinzu

page.config.contentObjectExceptionHandler = 0