Tags
загальне

Ви можете встановити розширення Magento 2 WebP Images від Magefan через composer або архів.

Бажаєте, щоб ми встановили та налаштували для вас модуль WebP Images? Наші девелопери зроблять це замість ваc – перегляньте наш інсталяційний сервіс.

Зміст [приховати]

  1. Встановлення через composer (рекомендовано)
  2. Встановлення через архів та FTP 

Увага! Якщо ви встановлюєте розширення на Magento 2.4.0, у ядрі Magento 2.4.0 є відома помилка "Error: main.CRITICAL: Error: Undefined class constant 'XML_PATH_HEADER_TRANSLATE_TITLE'. Тому перед встановленням розширення застосуйте цю зміну до своєї Magento. Зверніть увагу, що це виправлення вже є в Magento 2.4.1.

Встановлення через composer (рекомендовано)

Будь ласка, підіть в свій акаунт Magefan Account > My Downloads > Install via Composer, щоб отримати інсталяційні інструкції. 

Встановлення через архів та FTP

  1. Завантажте ZIP-архів розширення WebP Images на сайті magefan.com (не з GitHub або ж інших джерел).
  2. Вилучіть файли.
  3. Скопіюйте папки app та lib з архіву у свою папку Magento 2.
    Install Magento 2 Extension Using FTP
  4. У командному рядку за допомогою "cd" перейдіть до кореневого каталогу Magento 2.
  5. Запустіть команди CLI:
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

Примітка: якщо ви не хочете, щоб ваш веб-сайт був недоступний під час розгортання статичного контенту, спробуйте команди для zero downtime deployment.

Важливо!

Після встановлення та налаштування розширення Magento 2 WebP Images не забудьте додати налаштування Expire Headers для WebP файлів до налаштувань веб-сервера.

Навіщо вам це?

За замовчуванням Magento 2 має expire headers, написані для веб-серверів Apache, Nginx та PNG, JPG, GIF, CSS, JS. Однак немає їх написаних для webp.

Тоді, якщо ви використовуєте Apache, відкрийте файл .htaccess у кореневій папці Magento (pub/static чи pub/media) і знайдіть такий рядок:

ExpiresByType image/gif

Знайшовши, додайте після нього цей рядок:

ExpiresByType image/webp "access plus 1 year"

Якщо ви використовуєте Nginx, відкрийте файл віртуального хоста (попросіть адміна сервера це зробити, оскільки для цього потрібен доступ до кореневого сервера), знайдіть такий рядок:

location ~* \.(ico|jpg|jpeg|png|gif|svg|js|css|swf|eot|ttf|otf|woff|woff2|json)$ {

і замініть його ось цим рядком:

location ~* \.(ico|jpg|jpeg|png|gif|svg|js|css|swf|eot|ttf|otf|woff|woff2|json|webp)$ {

Не забудьте перезапустити Nginx після зміни налаштувань віртуального хоста.

Після встановлення Magento 2 WebP Images ви можете розпочати налаштування розширення.