Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen gezeigt.

--- public:faqwebp [2021/01/18 14:29]
markusmichalski [Voraussetzungen]
+++ public:faqwebp [2022/03/01 07:26]
markusmichalski [Installation]
@@ Zeile 6: / Zeile 6: @@
 ===== Voraussetzungen =====
-  * OXID CE/PE/EE ab Version 6.0.x bis 6.2.x\\
+  * OXID CE/PE/EE ab Version 6.0.x bis 6.3.x\\
   * SSH-Zugang zum Shoproot
   * Kein Eintrag unter "sAltImageUrl" in der config.inc.php
@@ Zeile 13: / Zeile 13: @@
 ===== Installation =====
+==== Composer ====
+Öffnen Sie die Datei **composer.json** im Stammverzeichnis Ihres Shops und fügen Sie das Repository hinzu oder vervollständigen Sie die vorhandene Konfiguration: \\
+<code yaml>
+"repositories": [{
+  "type": "composer",
+  "url": "https://packages.fatchip.de/packages"
+}]
+</code>
+Nach erfolgter Ergänzung der Datei //composer.json// können Sie da Plugin installieren.\\ Melden Sie sich dazu per SSH an dem Server an, auf dem sich die Shop-Installation befindet, und navigieren Sie zu dem Verzeichnis, in dem sich der Source- und Vendorornder befinden.\\
+Führen Sie folgenden Befehl aus, um das Plugin zu installieren
+    composer require plugin-oxid6-fcwebp
+Beachten Sie, dass der genaue Aufruf des Composers für Ihre konkrete OXID-Installation abweichen kann. \\
+Sie werden nun nach einem Benutzer und einem Passwort gefragt. Geben Sie die Zugangsdaten ein, welche Ihnen per E-Mail übersandt wurden.\\
+Bitte speichern Sie diese Zugangsdaten **nicht** auf Ihrem Server, da es sonst zu Problemen kommt, sollten Sie mehrere unserer Plugins einsetzen oder einsetzen wollen.
+Nach korrekter Eingabe der Zugangsdaten wird das Plugin installiert.
+==== Manuell ====
 Erstellen Sie im Verzeichnis //{shoproot}/source/modules// einen Unterordner **fc**, sollte dieser noch nicht existieren.
 In dem Pluginpaket befindet sich der Ordner //fcwebp//.\\
-Kopieren Sie den Inhalt aus diesem Ordner in das eben erstellte oder schon vorhandene Verzeichnis //fc//(bei FTP - binären Übertragungsmodus nutzen).
+Kopieren Sie diesen Ordner in das eben erstellte oder schon vorhandene Verzeichnis //fc// (bei FTP - binären Übertragungsmodus nutzen).
 {{public:faq:webp:210118_webp_ftp_upload.png?nolink&800|}}
@@ Zeile 40: / Zeile 60: @@
 **Module configuration has been installed**
-=== Anpassung der .htaccess ===
+===== Anpassung der .htaccess =====
 Melden Sie sich per SSH an dem Server an, auf dem sich die Shop-Installation befindet, und navigieren Sie in den "source"-Ordner. Stellen Sie sicher, dass Sie Schreibrechte für die ".htaccess" besitzen.\\
 Öffnen Sie sie .htaccess und fügen Sie **über**
@@ Zeile 50: / Zeile 70: @@
 RewriteCond %{HTTP_ACCEPT} image/webp
 RewriteCond %{REQUEST_URI}  (?i)(.*)(\.jpe?g|\.png|\.gif)$
+RewriteCond %{QUERY_STRING} !.*nowebp=true.*
 RewriteCond %{DOCUMENT_ROOT}%1.webp -f
 RewriteRule (?i)(.*)(\.jpe?g|\.png|\.gif)$ %1\.webp [L,T=image/webp]
@@ Zeile 57: / Zeile 78: @@
 RewriteCond %{HTTP_HOST} ^[REPLACE WITH YOUR DOMAIN IN FORM www\.fatchip\.de]
 RewriteCond %{REQUEST_URI} (\/out\/pictures\/generated\/)
+RewriteCond %{QUERY_STRING} !.*nowebp=true.*
 RewriteCond %{REQUEST_FILENAME} !-d
 RewriteRule (\.jpe?g|\.gif|\.png)$ modules/fc/fcwebp/getwebp.php [NC]
@@ Zeile 64: / Zeile 86: @@
 RewriteCond %{HTTP_HOST} ^[REPLACE WITH YOUR DOMAIN IN FORM www\.fatchip\.de]
 RewriteCond %{REQUEST_URI} (\.jpe?g|\.png|\.gif)
+RewriteCond %{QUERY_STRING} !.*nowebp=true.*
 RewriteCond %{REQUEST_FILENAME} -f
 RewriteRule (\.jpe?g|\.gif|\.png)$ modules/fc/fcwebp/getwebp.php [NC]
@@ Zeile 69: / Zeile 92: @@
 </code>
 Ersetzen Sie die Platzhalter mit Ihrer Domain.
+Sollten Sie ein **Enterprise Edition** einsetzen, trennen Sie die URLs Ihrer Shops mit einer Pipe
+<code>
+RewriteCond %{HTTP_HOST} ^[REPLACE WITH YOUR DOMAIN IN FORM www\.fatchip\.de|REPLACE WITH YOUR SECOND DOMAIN IN FORM www\.fatchip\.de]
+</code>
 Fügen Sie am Ende der ".htaccess" folgendes ein:
@@ Zeile 104: / Zeile 131: @@
 ^ Konfiguration ^ Beschreibung ^
 |Supportkey|Den Supportkey finden Sie in der E-Mail mit Ihrem Plugin. Ohne Nennung dieses Keys kann Ihnen die FATCHIP GmbH keinen Support leisten.|
-|Webp Qualität|Hier können Sie die gewünschte Qualität für die Webp-Bilder einstellen.\\ Der Standardwert ist 75|
+|Webp Qualität|Hier können Sie die gewünschte Qualität für die Webp-Bilder einstellen.\\ Der Standardwert ist 75\\ **Bitte beachten:**\\ Bei der Verwendung einer Enterprise Edition mit Subshops, muss die Qualität in allen Subshops gleich eingestellt sein.|
 ----
@@ Zeile 128: / Zeile 155: @@
   - [[#Welche OXID eShop Versionen sind mit dem WebP Bilder Konverter Plugin von FATCHIP kompatibel?]]
+  - [[#Wie funktioniert die Auslieferung der WebP-Bilder an den Browser?]]
+  - [[#Wie kann ich das im Shop hinterlegte Bild (z.B. jpg) anstatt das WebP-Bild an den Browser ausliefern?]]
 === 1. Welche OXID eShop Versionen sind mit dem Betreiber-Statistiken Plugin von FATCHIP kompatibel? ===
 Die aktuellsten Informationen hierzu erhalten Sie in der [[https://www.fatchip.de/Plugins/OXID-eShop/OXID-Plugin-WebP-Bildkonverter.html#matrix|Kompatibilitätsmatrix]] in unserem Shop.
+=== 2. Wie funktioniert die Auslieferung der WebP-Bilder an den Browser? ===
+  * Im Quelltext wird immer der ursprüngliche Bildname ausgegeben (z.B. produktbild.jpg).
+  * Per htaccess Regel wird nun geprüft, ob der Browser des Users das Formt WebP unterstützt.
+  * Unterstützt der Browser WebP, redirected die htaccess den Browser per Rewrite Rule im Hintergrund auf das WebP Bild und sendet einen entsprechenden Dateiheader.
+  * Unterstützt der Browser das Format nicht, wird einfach das alte Bild ausgegeben. \\ So ist sichergestellt, dass jeder Browser ein Bild anzeigt.
+=== 3. Wie kann ich das im Shop hinterlegte Bild (z.B. jpg) anstatt das WebP-Bild an den Browser ausliefern? ===
+Über den Parameter //**nowebp=true**// kann das hinterlegte Bild anstatt das webP-Bild ausgeliefert werden.
+<code>/mein_bild.jpg?nowebp=true</code>

Fatchip GmbH Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge