Hier werden die Unterschiede zwischen zwei Versionen gezeigt.
Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung | ||
public:faqwebp [2021/01/18 16:18] markusmichalski [Installation] |
public:faqwebp [2022/06/01 08:12] (aktuell) markusmichalski [Composer] |
||
---|---|---|---|
Zeile 6: | Zeile 6: | ||
===== Voraussetzungen ===== | ===== 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 | * SSH-Zugang zum Shoproot | ||
* Kein Eintrag unter "sAltImageUrl" in der config.inc.php | * Kein Eintrag unter "sAltImageUrl" in der config.inc.php | ||
Zeile 13: | Zeile 13: | ||
===== Installation ===== | ===== 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 fatchip-gmbh/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. | Erstellen Sie im Verzeichnis //{shoproot}/source/modules// einen Unterordner **fc**, sollte dieser noch nicht existieren. | ||
In dem Pluginpaket befindet sich der Ordner //fcwebp//.\\ | 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|}} | {{public:faq:webp:210118_webp_ftp_upload.png?nolink&800|}} | ||
Zeile 40: | Zeile 60: | ||
**Module configuration has been installed** | **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.\\ | 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** | Öffnen Sie sie .htaccess und fügen Sie **über** | ||
Zeile 50: | Zeile 70: | ||
RewriteCond %{HTTP_ACCEPT} image/webp | RewriteCond %{HTTP_ACCEPT} image/webp | ||
RewriteCond %{REQUEST_URI} (?i)(.*)(\.jpe?g|\.png|\.gif)$ | RewriteCond %{REQUEST_URI} (?i)(.*)(\.jpe?g|\.png|\.gif)$ | ||
+ | RewriteCond %{QUERY_STRING} !.*nowebp=true.* | ||
RewriteCond %{DOCUMENT_ROOT}%1.webp -f | RewriteCond %{DOCUMENT_ROOT}%1.webp -f | ||
RewriteRule (?i)(.*)(\.jpe?g|\.png|\.gif)$ %1\.webp [L,T=image/webp] | 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 %{HTTP_HOST} ^[REPLACE WITH YOUR DOMAIN IN FORM www\.fatchip\.de] | ||
RewriteCond %{REQUEST_URI} (\/out\/pictures\/generated\/) | RewriteCond %{REQUEST_URI} (\/out\/pictures\/generated\/) | ||
+ | RewriteCond %{QUERY_STRING} !.*nowebp=true.* | ||
RewriteCond %{REQUEST_FILENAME} !-d | RewriteCond %{REQUEST_FILENAME} !-d | ||
RewriteRule (\.jpe?g|\.gif|\.png)$ modules/fc/fcwebp/getwebp.php [NC] | 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 %{HTTP_HOST} ^[REPLACE WITH YOUR DOMAIN IN FORM www\.fatchip\.de] | ||
RewriteCond %{REQUEST_URI} (\.jpe?g|\.png|\.gif) | RewriteCond %{REQUEST_URI} (\.jpe?g|\.png|\.gif) | ||
+ | RewriteCond %{QUERY_STRING} !.*nowebp=true.* | ||
RewriteCond %{REQUEST_FILENAME} -f | RewriteCond %{REQUEST_FILENAME} -f | ||
RewriteRule (\.jpe?g|\.gif|\.png)$ modules/fc/fcwebp/getwebp.php [NC] | RewriteRule (\.jpe?g|\.gif|\.png)$ modules/fc/fcwebp/getwebp.php [NC] | ||
Zeile 108: | Zeile 131: | ||
^ Konfiguration ^ Beschreibung ^ | ^ 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.| | |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 132: | Zeile 155: | ||
- [[#Welche OXID eShop Versionen sind mit dem WebP Bilder Konverter Plugin von FATCHIP kompatibel?]] | - [[#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? === | === 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. | 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> |