Медиафайлы в WordPress: что проверить новичку до первой загрузки

За 20–30 минут вы выясните, какие файлы принимает ваш WordPress 6.x, увидите, какие копии движок создаёт на диске, и загрузите первую картинку с нормальным именем, описанием и подходящим размером. Это стоит сделать до первой сотни загрузок: имя файла в библиотеке штатно не изменить, а каждая картинка превращается в несколько файлов на диске.

Что нужно до начала

• WordPress 6.x. Названия пунктов меню ниже даны для этой ветки, в старых версиях они могут отличаться.
• Роль Автор, Редактор или Администратор. У роли Участник (Contributor) загружать файлы нельзя, раздела «Медиафайлы» в её меню нет.
• Доступ в панель хостинга, если придётся менять лимиты PHP. Для шагов 1–6 он не нужен.
• Одна тестовая фотография в формате JPEG или PNG.

Шаги

1. Узнайте лимит и редактор изображений. Откройте «Инструменты → Здоровье сайта», вкладка «Информация», раздел Media Handling (в русском интерфейсе он переведён). Нужны две строки: активный редактор (WP_Image_Editor_GD или WP_Image_Editor_Imagick) и максимальный размер загружаемого файла. Проверка: видны оба значения. Если лимит меньше веса ваших исходников, сначала загляните в раздел «Если не получилось».
2. Подготовьте файл до загрузки. Назовите его латиницей через дефис по содержанию: kitchen-oak-table.jpg вместо IMG_4821.jpg. Уменьшите ширину до реально нужной: если колонка текста в теме занимает 800 пикселей, снимок шириной 6000 только съест место. Вес фото в тексте многие держат в пределах нескольких сотен килобайт, но это практика, а не требование движка. Проверка: в свойствах файла стоит задуманная ширина.
3. Загрузите файл. «Медиафайлы → Добавить», перетащите картинку в рамку. Проверка: появилась миниатюра. Клик по ней открывает окно со ссылкой вида /wp-content/uploads/ГОД/МЕСЯЦ/kitchen-oak-table.jpg. Если исходник был шире 2560 пикселей, в имени добавится суффикс -scaled.
4. Заполните поля вложения. Что писать в каждое, показано в таблице ниже. Проверка: после перехода к другому файлу и возврата текст в полях на месте, сохранение идёт автоматически.
5. Вставьте картинку в запись. Добавьте блок «Изображение», выберите файл из библиотеки и укажите размер в панели блока (пункт называется «Разрешение» или «Размер изображения», зависит от версии). Для колонки текста обычно хватает Large. Проверка: откройте запись на сайте и откройте картинку в новой вкладке. В адресе будет суффикс размера, например -1024x683.
6. Просмотрите «Настройки → Медиафайлы». Там задаются размеры миниатюр. Изменения коснутся только новых загрузок, старые картинки останутся с прежними копиями. Проверка: после сохранения значения остались на месте.

Что вписать в поля

[1] Alt-текст читают программы экранного доступа, поэтому он должен описывать смысл картинки, а не повторять ключевые слова.

Какие копии создаёт WordPress

Одна загрузка даёт сразу несколько файлов. Значения по умолчанию такие:

Тема и плагины добавляют собственные размеры, так что на каждую картинку нередко приходится десяток файлов. Проверьте это сами: загрузите тестовое фото и откройте папку месяца в wp-content/uploads через файловый менеджер хостинга.

Загруженный файл живёт в нескольких копиях. Ошибку в имени или размере дешевле исправить до загрузки, чем после.

Если не получилось

The uploaded file exceeds the upload_max_filesize directive in php.ini

Файл тяжелее лимита PHP. Поднимите его в настройках PHP в панели хостинга или в php.ini, если доступ есть. Значения в примере ориентировочные, подберите под свои файлы:

; Лимит на размер одного файла
upload_max_filesize = 64M
; Лимит на весь запрос, не меньше upload_max_filesize
post_max_size = 64M

Проверка: в «Медиафайлы → Добавить» и в Site Health появился новый максимум. Если вместо этого браузер показывает «413 Request Entity Too Large», лимит стоит на веб-сервере. В Nginx это директива client_max_body_size; на виртуальном хостинге попросите поддержку.

Sorry, you are not allowed to upload this file type

WordPress принимает не все форматы. SVG по умолчанию заблокирован: внутри него может быть скрипт. Конвертируйте файл в JPEG, PNG или WebP. Включать SVG плагином стоит, только понимая риски и санитизацию.

Unable to create directory wp-content/uploads/…

У веб-сервера нет прав на запись в папку. Не ставьте права 777: попросите хостинг выдать корректные права на wp-content/uploads.

Post-processing of the image failed likely because the server is busy

Серверу не хватило ресурсов на нарезку копий. Уменьшите исходник до ширины ниже 2560 пикселей и повторите. Если ошибка стабильна, спросите хостинг про лимит памяти PHP.

HTTP error

Универсальный сбой загрузчика. Частые причины: лимиты времени и памяти, защитный плагин или файрвол хостинга. Попробуйте другой браузер и файл меньшего размера, затем загляните в журнал ошибок на хостинге.

Что делать дальше

• Сделайте резервную копию перед чисткой библиотеки. Удаление из неё необратимо, и WordPress не проверяет, где файл используется.
• Выберите формат. WebP принимается с версии 5.8, AVIF с версии 6.5, если серверная библиотека его поддерживает. Проверьте это загрузкой тестового файла.
• Замерьте вес страницы с картинками во вкладке Network инструментов разработчика браузера и сравните до и после.

Сжатие плагинами, ленивая загрузка и CDN — отдельные темы, здесь они не рассматриваются.