Solltest du eine Lizenz besitzen, findest du hier die letzte von uns verffentlichte Version.
Resource Optimizer
Schnellere Ladezeiten fr Deinen Shop
Solltest du eine Lizenz besitzen, findest du hier die letzte von uns verffentlichte Version.
- JTL-Shop 3/4
- Features
- Dokumentation
- Changelog
Features
Grundfunktionen in der bersicht
- Minifizieren von JavaScript-Dateien
- Minifizieren von CSS-Dateien
- Minifizieren von inline CSS
- Prefixen von CSS
- auch fr Plugin-Dateien - keine Definition im Template ntig
Achtung
Die aktuelle Version des EVO-Templates fr den Shop4 ldt JavaScript-Dateien nun asynchron nach. Diese knnen durch den ResourceOptimizer nicht minifiziert werden.
Hinweis
Bevor Du das Plugin kaufst und direkt installierst und aktivierst, probier die kostenlose Testversion aus, um sicherzustellen, dass es in Deinem Shop wirklich funktioniert. Das Plugin macht komplexe Eingriffe ins HTML und knnte ansonsten dazu fhren, dass Dein Shop nicht mehr funktioniert. Wie Du das Plugin auch in einem produktiven Shop testen kannst, siehst du in der Dokumentation. Solltest du Probleme haben, stelle Deine Fragen im Reiter Service, wir werden dann versuchen, Dir zu helfen.
Dieses Plugin nutzt die freien Programme Minify und CSS-Crush.
Dokumentation
Installation
Der Resource Optimizer ist wie jedes Plugin fr den JTL Shop 3 schnell und einfach zu installieren, lies hierzu bitte unseren Post zur Installation von JTL Shop Plugins.
Zustzlich dazu kopiere bitte den Ordner
min
in das
Wurzel-Verzeichnis Deines Shops
- nicht in den Plugin-Ordner!
Die Datei
min/groupsConfig.php
muss fr den Webserver beschreibbar sein! Setze also ggf. mit Deinem FTP-Client eine Berechtigung wie 644 oder - falls das nicht reicht - 666.
Falls Du auch inline-CSS minifizieren willst, gilt dasselbe auch fr die Datei
version/<version>/frontend/inc/inline_css.php
.
Deaktiviere ggf. bitte auch noch die Funktion "Komprimierung von Javascript und Stylesheets" in den Einstellungen Deines Themes, um Konflikte zu vermeiden.
Wichtig, falls Dein Shop bei 1&1 gehostet ist oder Du 404-Fehler beim Zugriff auf die minifizierten Dateien bekommst: Entferne die Raute in der Zeile
#RewriteBase /min
der Datei /min/.htaccess.
Falls Dein Shop zustzlich in einem Unterordner installiert sein sollte, musst Du die Zeile noch anpassen in z.B.
RewriteBase /mein-ordner/min
Voraussetzungen
In den Plugin-Einstellungen findest Du einen Tab "Voraussetzungen", der Dir sagt, ob das Plugin richtig installiert wurde und funktionsbereit ist. Falls es Probleme gibt, findest Du hier Hinweise.
Wichtig fr JTL Shop 3.18 und das Tiny Template
Nutzt Du das standard Template von JTL Shop 3.18, so setze bitte die Option JavaScript einfgen in auf nach Script (wichtig fr JTL Shop 3.18) und achte darauf, dass das Feld Script-Src einen Wert wie z.B. //code.jquery.com/jquery-migrate-1.2.1.min.js hat. Dies sorgt dafr, dass die minifizierten Skripte direkt nach der dort angegebenen Datei eingebunden werden.
Einstellungen
In den Plugin-Einstellungen kannst Du den ResourceOptimizer komplett deaktivieren, falls es Probleme geben sollte. Auch kannst Du einzelne Funktionalitten deaktivieren.
Setzt Du die Option JavaScript zusammenfassen? auf "Ja", werden alle eingebundenen JavaScript-Dateien kombiniert und minifiziert. Ist diese Option auf "Nein", bleibt alles so wie immer. Dasselbe gilt fr die Option CSS zusammenfassen?. Hier kannst Du zustzlich noch angeben, ob auch inline CSS minifiziert werden soll. So wird aus allen Style-Tags auf Deiner Seite eine temporre Datei erstellt und zusammen mit den restlichen Dateien minifiziert.
Du kannst auch noch angeben, ob minifiziertes JavaScript in den head- oder body-Bereich des Dokuments geschrieben werden soll. Lass diese Option am besten auf "head", auer Du weisst genau, was du tust.
Um das Plugin zu testen ohne bei eventuellen Fehlern Deine Besucher zu verschrecken, kannst Du den Testmodus aktivieren. In der entsprechenden Option kannst Du auswhlen, welche Funktionalitten Du testen mchtest. Um den Test durchzufhren, lade anschlieend Deinen Shop und hnge an die URL den Parameter ?kk-res-opt-test an.
Um also z.B. eine Produktseite mit der URL
http://www.mein-shop.de/mein-produkt
zu testen, rufst Du einfach
http://www.mein-shop.de/mein-produkt?kk-res-opt-test
auf. Falls dabei keine Probleme auftreten, kannst Du das Plugin anschlieend aktivieren und den Testmodus wieder ausschalten.
Um bei Problemen ein paar Hinweise zu erhalten, kannst Du die Option Debugging aktivieren? auf "Ja" stellen. Dann erhltst Du im Frontend Hinweise ber den Plugin-Ablauf.
Erweiterte Einstellungen
CSS und JavaScript vom Minifizieren ausschliessen
Wenn Du CSS oder JavaScript vom Minifizieren ausschlieen mchtest, fge das Attribut data-ignore="true" hinzu. Beispielsweise
<script type="text/javascript" src="http://example.com/script.js" data-ignore="true"></script>
oder
<style type="text/css" data-ignore="true">
body{background:blue;}
</style>
<link href="http://example.com/style.css" rel="stylesheet" type="text/css" data-ignore="true">
Seit Version 1.02 kannst Du auch in den Plugin-Einstellungen den Namen einer Datei angeben, der ausgeschlossen werden soll. Dies ist z.B. beim Plugin UPAC von den Updatern ntig. Dazu einfach "up.activesearch.js" in das Feld "Skripte ausschlieen" eingeben. Mehrere Dateinamen knnen per Komma getrennt angegeben werden.
Schnelleres Caching mit APC
Falls Dein Server die PHP-Extension APC installiert hat - und nur dann -, kannst Du die Kommentare in den Zeilen 59 und 60 der Datei
<shop_root>/min/config.php
entfernen und so den Cache mit APC beschleunigen.
//require dirname(__FILE__) . '/lib/Minify/Cache/APC.php';
//$min_cachePath = new Minify_Cache_APC();
CSS automatisch prfixen
Um CSS automatisch mit Prfixen fr alle gngigen Browser zu versehen, kannst Du die Kommentare in den Zeilen 102 und 103 derselben Datei entfernen.
//$min_serveOptions['postprocessorRequire'] = dirname(__FILE__) . '/lib/css-crush/CssCrush.php';
//$min_serveOptions['postprocessor'] = 'prefixer';
Anschlieend wird jede minifizierte CSS-Datei automatisch mit Prfixen versehen und Du musst nicht mehr soetwas wie
#mein-selektor{
-moz-border-radius: 5px;
-webkit-border-radius: 5px;
border-radius: 5px;
}
schreiben, sondern nur noch
#mein-selektor{
border-radius: 5px;
}
Fehlersuche
Falls JavaScript nach der Installation des Plugins nicht mehr funktioniert, Du einen Hinweis wegen XAJAX bekommst oder das CSS nicht mehr richtig dargestellt wird, prfe bitte, ob der Aufruf der minifizierten Dateien einen Serverfehler verursacht hat.
Im Quelltext Deiner Seite sollte sowas wie
<link type="text/css" rel="stylesheet" href="http://mein-shop.de/min/g=css-20550b4cce6e4cddcc6b40a8390fbeda">
sein. Falls Diese Datei einen 404-Fehler verursacht, probiere aus, ob es nach dem Schema
http://mein-shop.de/min/index.php?g=css-20550b4cce6e4cddcc6b40a8390fbeda
funktioniert. Wenn ja, musst Du wie oben beschrieben die .htaccess-Datei im /min-Ordner anpassen.
Falls Du einen 500er Serverfehler bekommst, sag uns einfach bescheid.
Wartung und Hinweise
Falls die Option
Auch Inline-CSS minimieren?
aktiviert ist, knnen alte Cache-Dateien z.B. mit dem Plugin
Template Cache Loescher
von JTL gelscht werden.
Wenn dies geschieht, muss anschlieend kurz der Button
Cache leeren
im Resource Optimizer geklickt werden.
Changelog
1.07 - 18.01.2016
- kleinere Designanpassungen fr Shop 4
- behebt einen Fehler, durch den das Plugin whrend eines Seitenaufrufs mehrfach ausgefhrt wurde
1.06 - 27.10.2015
- Plugin ist mit JTL Shop4 kompatibel
1.05 - 02.10.2014
- kleinere Verbesserungen und Fehlerbehebungen
1.04 - internes Release
1.03 - 04.01.2014
- Kompatibilitt mit JTL Shop 3.18 und Standard Tiny Template verbessert
1.02 - 26.11.2013
- Manuelles Ausschlieen von Dateien ber das Backend
1.01 - 08.11.2013
- Problem beim Betrieb des Shops in einem Unterordner behoben
1.00 - 13.09.2013
- erstes Release