RoxIVE - Das Responsive OXID eshop Theme

Transkript

1

2 Table of Contents 1. Einleitung 2. Systemvoraussetzungen 3. Installation 4. Theme updaten 5. Theme einstellen 6. Theme anpassen 7. Informationen für Entwickler 8. Troubleshooting 9. Hilfe & Support

3 RoxIVE - Das Responsive OXID eshop Theme "RoxIVE" ist ein Responsive Theme für den OXID eshop, welches auf den aktuellsten Technologien der Web-Entwicklung basiert. Dadurch wird Ihr Shop auf allen Endgeräten optimal angezeigt und kann in wenigen Schritten an das Corporate Design des Shop-Betreibers angepasst werden.

4 Systemvoraussetzung Software OXID eshop 4.8.0/5.1.0 oder höher Webserver-Konfiguration IonCube Loader (mind. v4.4.0) PHP-Extension "curl" PHP-Extension "Zip" Dateirechte Folgende Ordner müssen vom Webserver-User beschreibbar sein. Warum? Weil RoxIVE über den OXID eshop admin installiert und aktualisiert wird. Es muss also gewährleistet sein, dass der Webserver alle Dateien an den vorgesehenen Stellen schreiben kann. Shop-Hauptverzeichnis /offline.html /application/views/ /modules/digidesk/dd_roxive_manager/ /out/

5 Installationsanleitung 1. Laden Sie alle Dateien via FTP/SFTP in Ihr Shop-Hauptverzeichnis hoch. 2. Navigieren Sie im OXID eshop admin zu Erweiterungen > Module. 3. Aktivieren Sie das Modul "digidesk - RoxIVE Theme-Manager" 4. Navigieren Sie im OXID eshop admin zu digidesk > RoxIVE Theme-Manager > Übersicht. 5. Klicken Sie auf den Button RoxIVE jetzt installieren. 6. Folgen Sie den Anweisungen. RoxIVE ist nun in Ihrem OXID eshop installiert. 7. Navigieren Sie im OXID eshop admin zu Erweiterungen > Themes und aktivieren Sie das Theme "RoxIVE - Responsive OXID eshop Theme".

6 Theme updaten Erhalte ich eine Information, wenn ein Update verfügbar ist? Navigieren Sie dazu im OXID eshop admin zu digidesk > RoxIVE Theme-Manager > Übersicht. Auf der rechten Seite erscheint dann ein Formular, über welches Sie beim RoxIVE Update Newsletter anmelden können. Sie erhalten nach Bestätigung der Newsletter-Anmeldung dann automatisch eine , sobald eine neue Version von RoxIVE verfügbar ist. Wann sollte ich RoxIVE updaten? Diese Frage lässt sich ziemlich einfach beantworten: Am besten immer! Natürlich ist dies beim Einsatz von stark modifizierten Child-Themes mit Aufwand verbunden, jedoch wird dieser immer größer, je mehr Updates man auslässt. Was ist beim Update zu beachten? Sofern RoxIVE bzw. eines der Standard-Child-Themes nicht verändert wurde, sondern nur Anpassungen in den Theme-Einstellungen gemacht wurden, kann RoxIVE problemlos aktualisiert werden. Wenn RoxIVE bzw. eines der Standard-Child-Themes verändert wurde, was nicht empfohlen wird, sollten Sie zuerst ein eigenes Child-Theme mit den Anpassungen erstellen, da Änderungen an den Standard- Dateien beim Update überschrieben werden. Informieren Sie sich in diesem Fall bitte, wie man ein Child- Theme anlegen kann. Wenn ein eigenes Child-Theme erstellt wurde, sollte man im Changelog schauen, ob Dateien aktualisiert werden, die Ihr Child-Theme verwendet. Sollte dies der Fall sein, sollte das Update zuerst in einer Testumgebung (auch "Staging-System" genannt) durchgeführt werden, um dann die Änderungen durch das Update in die eigens angepassten Dateien zu übernehmen. Dafür vergleicht man die Dateien aus dem Theme dd_roxive mit denen des eigenen Child-Themes am besten mit einem "Diff-Tool" wie z.b. WinMerge. Update anstoßen 1. Navigieren Sie im OXID eshop admin zu digidesk > RoxIVE Theme-Manager > Übersicht. 2. Falls ein Update verfügbar ist, befindet sich ein Hinweis auf der Übersichtsseite. 3. Klicken Sie in dem Hinweis auf den Button RoxIVE jetzt updaten. 4. Folgen Sie den Anweisungen.

7 Theme einstellen Im OXID eshop admin unter Erweiterungen > Themes > Einstellungen finden Sie Standard- Einstellungen von RoxIVE. Darüber hinaus können Sie dort auch die erweiterten Einstellungen wie z.b. Google Analytics und Kontaktseite bearbeiten.

8 Theme anpassen Als Entwickler haben Sie die Möglichkeit ein Child-Theme von RoxIVE zu erstellen, um Farb-, Sprachund Templateanpassungen vorzunehmen. Der entscheidende Vorteil eines Child-Themes ist, dass die Update-Fähigkeit von RoxIVE nicht beeinträchtigt wird. Sie können RoxIVE somit immer automatisiert über den RoxIVE Theme-Manager aktualisieren und, wenn nötig, Ihr Child-Theme dementsprechend anpassen. Weiterre Informationen dazu finden Sie übrigens auch in unserer YouTube-Playlist zu RoxIVE.

9 Informationen für Entwickler RoxIVE basiert auf dem Frontend Framework Bootstrap RoxIVE kann durch Child-Themes erweitert werden, wodurch die Update-Fähigkeit vollstens erhalten bleibt. Weitere Tutorials dazu gibt es in unserer YouTube-Playlist zu RoxIVE. LESS wird als CSS-Preprocessor verwendet neu erstellte Seite für Wartungsarbeiten (offline.html) Responsive -Templates Blocks im gesamten Theme, die durch Module überladen werden können, wie man es vom Standard-OXID-Theme gewohnt ist optimale Anzeige auf allen Endgeräten Google Analytics Page Tracking Google Analytics Ecommerce Tracking Google Zertifizierte Händler konfigurierbar FontAwesome Icons für Retina-Displays optimiert kompatibel mit den meisten Standard-Modulen, wie z.b. PayPal einstellbare Google Maps-Karte auf Kontaktseite Theme-Updates per Knopfdruck installieren Einstellbarer Hintergrund

10 Troubleshooting - Die häufigsten Fehler Ich finde keine Einstellungen im RoxIVE Theme! Falls Sie in den Theme-Einstellungen von RoxIVE keine Einstellungen finden, sind nicht alle in den Systemvoraussetzungen genannten Verzeichnisse schreibbar. Bitte prüfen Sie die Dateirechte. Beim Installieren bzw. Updaten von RoxIVE erhalte ich eine Fehlermeldung "No error." Auch hier gibt es Probleme mit den Dateirechten. Bitte prüfen Sie die Dateirechte der in den Systemvoraussetzungen genannten Verzeichnisse. Im Frontend werden Icons nur als Kästchen oder Fragezeichen dargestellt. Dieser Fehler tritt in den meisten Fällen ein, wenn Ihr Shop sowohl unter und meinshop.de aufrufbar ist. Bitte stellen Sie sicher, dass Ihr Shop nur unter einer Adresse erreichbar ist. Dies löst man am besten über eine Regel in der Datei.htaccess, welche sich im Hauptverzeichnis Ihres Shops befindet. Dies verhindert nicht nur "Duplicate Content", sondern auch, dass die Icons fehlerhaft dargestellt werden. Des Weiteren sollte sichergestellt sein, dass die korrekte URL in der Datei config.inc.php, welche sich ebenfalls im Hauptverzeichnis Ihres Shops befindet, eingetragen ist. Beim Aktivieren von PayPal Express auf der Deteilseite rutscht der Button "In den Warenkorb" eine Zeile tiefer. Wir haben nun schon des Öfteren mitbekommen, dass das Standard-PayPal-Modul die Detailseite etwas zerschießt, wenn der PayPal-Express Checkout auf der Detailseite aktiviert wird. Dies ist leider nicht RoxIVE-seitig lösbar, sondern nur im PayPal-Modul selbst. Dazu bitte in die Datei /modules/oe/oepaypal/views/blocks/page/details/oepaypalexpresscheckoutdetailspage.tpl gehen und folgende Zeile entfernen: [{oxscript add='$("#tobasket").prependto($("#paypalexpresscheckoutdetailsbox"))'}]

11 Hilfe & Support Haben Sie Fragen oder benötigen Sie Hilfe bei der Installation? Gerne bieten wir Ihnen auch einen Installationsservice an. Kontaktieren Sie uns einfach über einer der unten stehenden Adressen. Telefon: +49 (0) 5246 / Kontaktformular: Facebook: