Если ваша страница Avada внезапно выглядит некорректно (столбцы расположены друг над другом, абсурдные отступы, слайдер переполняется), проблема редко связана с самой Avada. По моему опыту, это почти всегда конфликт ресурсов (CSS/JS), слишком агрессивное кэширование или глобальные CSS-стили, добавленные «наспех» в дочерней теме.
проблема
Конфликты компоновки в Avada (Fusion Builder) часто появляются без четкого сообщения на экране. Вы видите их на внешнем интерфейсе, иногда только на мобильных устройствах, иногда только после авторизации.
Когда приходит сообщение об ошибке, я часто обнаруживаю ошибки JavaScript в консоли браузера или ошибки PHP в логах. Реалистичные примеры:
Uncaught TypeError: Cannot read properties of undefined (reading 'init')
at fusionBuilderApp.init (fusion-builder.min.js:1)
Uncaught ReferenceError: jQuery is not defined
at fusion-something.min.js:1
PHP Fatal error: Uncaught Error: Call to undefined function fusion_library() in /wp-content/themes/Avada-child/functions.php:42
Когда и где это появляется:
- Front-end : колонки, которые становятся 100%-ными, контейнеры, которые теряют свою ширину, элементы, которые перекрываются.
- Админ Редактор Avada Builder больше не загружается, бесконечный индикатор загрузки, неактивные кнопки.
- После обновления Обновлены Avada/Avada Core/Avada Builder, затем выполнена оптимизация кэша, которая по-прежнему использует старые файлы.
- После активации плагина : оптимизация (минификация/комбинирование), безопасность (отключение REST), глобальный плагин CSS/JS, плагин «производительности», отличающийся от jQuery.
Для кого это предназначено: для начинающих пользователей. WordPress Если вы используете Avada/Fusion Builder (версия 6.9.4, апрель 2026 г.), то в конце вы это узнаете:
- Определите, связана ли проблема с CSS, JS, кэшем или конфликтом плагинов.
- Примените 3 распространенных исправления, разместив безопасный код (PHP 8.1+) в нужном месте.
- Проведите надлежащее тестирование (в консоли, мониторе запросов, проверке работоспособности), не "сломав" свой рабочий сайт.
Краткое резюме
- Для начала очистите все кэши. (плагин, сервер/CDN, браузер): это основная причина после обновления Avada.
- Временно отключить оптимизацию CSS/JS. (объединение/задержка/отсрочка): Avada Builder чувствителен к порядку загрузки.
- Найдите глобальные CSS-стили. добавлено в «Пользовательский CSS», дочернюю тему или плагин: просто
.container{width:100%}Этого достаточно, чтобы разрушить энергосеть Avada. - Проверьте консоль браузера. : un
jQuery is not definedЧасто это объясняет ситуацию, когда строитель перестал отвечать на запросы. - Диагностика без риска с функцией проверки работоспособности (режим устранения неполадок) + монитором запросов, на WordPress 6.9.4.
Симптомы
Вот симптомы, которые я чаще всего наблюдаю в Avada (Fusion Builder / Avada Builder). Несколько из них могут сосуществовать.
- Столбчатые колонны : строка 1/2 + 1/2 становится 100% + 100% даже на настольном компьютере.
- Неработающая ширина "всей страницы" Контейнеры во всю ширину экрана либо «обрамляются», либо, наоборот, выходят за горизонтальные границы (прокрутка по оси X).
- Несогласованные пространства : удвоенные поля/отступы, «сжатые» разделы, вставленные заголовки.
- Отсутствуют шрифты/иконки Иконки и заголовки в формате Invisible Font Awesome, заимствованные из резервного шрифта.
- Конструктор, который не загружается В режиме администратора: белый экран, индикатор загрузки, кнопки не реагируют.
- Короткие коды, отображаемые в тексте. Понимаете
[fusion_text]вместо предоставленного контента. - Ошибки 404 в CSS/JS : файлы в
/wp-content/uploads/fusion-styles/ou/wp-content/cache/не найдено. - Различия между подключенным и отключенным состоянием : типично для кэширования страниц или «задержки» JavaScript, применяемой только к посетителям.
Краткая диагностическая таблица (полезна, если вы не знаете, с чего начать):
| симптом | Причина вероятна | проверка | Решение |
|---|---|---|---|
| После обновления столбцы повредились. | Кэш + устаревшие объединенные CSS-файлы | Протестируйте в режиме приватного просмотра + очистите кэш плагина/CDN. | Решение 1 (отключить объединение/задержку, очистку, регенерацию) |
| Горизонтальная прокрутка (переполнение) | Глобальный CSS включен html, body / .container / img |
Инспектор (Инструменты разработчика Chrome) → элемент, выходящий за пределы | Решение 2 (правильный (глобальная переменная CSS, обертка Avada) |
| Административный менеджер застройщика перестал отвечать. | Ошибка JavaScript (jQuery, defer, конфликт плагинов) | Консоль → красные ошибки + вкладка «Сеть» | Решение 1 + Решение 3 |
| Отображаются короткие коды | Плагин Avada Builder/Core отключен, фильтр контента, блок необработанного HTML. | Активны расширения Avada Core/Builder? | Решение 3 (порядок хуков, контент, безопасность) |
| CSS/JS 404 | Удалены права доступа, кэш, перезапись, CDN, сгенерированные файлы. | Сеть → статус 404 + точный путь | Очистить + перегенерировать + проверить права доступа/права перезаписи |
Почему это происходит
Упрощенная версия (для начинающих): Avada создает макеты с помощью комбинации следующих элементов: CSS (для сетки, интервалов, адаптивности) и JavaScript (для интерактивных модулей, конструктора, некоторых эффектов). Если плагин изменяет порядок загрузки, удаляет файл или предоставляет кэшированную версию, макет нарушается.
Вот что происходит за кулисами (более техническая информация):
- Avada и ее плагины (Avada Core/Avada Builder) сохранение и загрузка ресурсов через API WordPress (
wp_enqueue_scriptsлицевая сторона,admin_enqueue_scripts(Административная панель). Ссылка: wp_enqueue_script (). - Плагины оптимизации переписывают итоговый HTML-код: они объединяют, минимизируют и откладывают выполнение скриптов. Скрипт Avada, который должен выполняться после jQuery или другого модуля, может в итоге выполниться слишком рано.
- Глобальные CSS-стили (дочерняя тема, «Пользовательские CSS-стили», плагин) могут переопределять очень общие селекторы. Я часто видел, как
*{box-sizing:border-box}или же агрессивный сброс настроек нарушает расчеты ширины. - Кэш (плагин + CDN + браузер) может отображать старый файл. После обновления Avada HTML-код указывает на новую версию, но CDN возвращает старую, или наоборот.
Вероятные причины, от наиболее частых до самых редких:
- Кэширование/Оптимизация : объединяет CSS/JS, откладывает выполнение JS, «удаляет неиспользуемый CSS», кэширует страницы.
- CSS global слишком широкий (дочерняя тема, пользовательский CSS, плагин), который влияет
.container,.row,img,iframe,body. - конфликт JavaScript : отложенная загрузка jQuery, дублирование скрипта, ошибка JavaScript от стороннего плагина.
- Avada Core / Avada Builder не синхронизированы. : несовместимые версии или один из плагинов отключен.
- Перезапись правил / разрешений : сгенерированные файлы недоступны, ошибки 403/404 для ресурсов.
- Проблемы с сервером Ошибка конфигурации HTTP/2 push, перезапись Brotli/CDN, блокировка REST/AJAX со стороны WAF.
Предварительные условия перед началом обучения
Сохраняйте свою работу перед внесением каких-либо изменений. Никогда не изменяйте ядро WordPress или файлы родительской темы Avada: работайте в чистой, неизмененной среде. ребенок тема или пользовательские плагины.
- WordPress : 6.9.4 (или более поздняя версия).
- PHP Рекомендуемый минимальный балл: 8.1 (8.2/8.3 часто более комфортны). Справочная информация: PHP: Поддерживаемые версии.
- Outils :
- Монитор запросов (Бесплатно) для просмотра ошибок PHP, хуков, запросов, загруженных скриптов/стилей: wordpress.org/plugins/query-monitor.
- Проверка работоспособности и устранение неполадок Чтобы отключить плагины/темы только для себя (режим устранения неполадок): wordpress.org/plugins/health-check.
- Включить ведение журнала (временно) через
wp-config.phpСогласно документации, для фиксации ошибок необходимо следующее: Отладка в WordPress.
Пример конфигурации отладки (для отправки в false (после завершения диагностики):
/**
* Active le debug WordPress (à désactiver après dépannage).
* À placer dans wp-config.php, avant "That's all, stop editing!".
*/
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
Решение 1: CSS/JS загружаются не по порядку (приоритеты, оптимизация, кэширование).
Типичные симптомы: неработающая структура после обновления, неактивные модули Avada, зависание конструктора, ошибки в консоли. jQuery is not defined ou Cannot read properties of undefined.
Проблема часто возникает из-за плагина, повышающего производительность, который:
- объединить CSS/JS,
- отличается (откладывает) или задерживает (задерживает) выполнение скриптов.
- Переместите jQuery в нижний колонтитул.
- или удаляет файлы, которые считаются «ненужными».
Шаг 1 (без кода): Быстрая проверка в режиме поиска и устранения неисправностей.
С помощью функции «Проверка здоровья» активируйте режим устранения неполадок (это можете увидеть только вы), затем:
- Отключите плагины оптимизации (Autoptimize, WP Rocket, LiteSpeed Cache и т. д.).
- Очистите кэш Avada (в Avada > Производительность / Кэш, в зависимости от вашей версии), затем кэш плагинов, а затем кэш CDN.
- Перезагрузите страницу в режиме приватного просмотра.
Если все вернется в норму: вы подтвердили наличие конфликта интересов. Перейдите к шагу 2.
Шаг 2 (с кодом): Предотвращение «отсрочки/задержки» в скриптах Avada.
Применяются некоторые плагины. defer через фильтр WordPress script_loader_tag, фильтры Это функция, которая принимает значение и должна его вернуть (в отличие от...). действие который выполняет код, не возвращая значения).
Куда вставить код в идеале в мю-плагин (Этот плагин обязателен для использования), чтобы оставаться активным даже при смене темы оформления.
Путь : /wp-content/mu-plugins/avada-assets-fix.php (создать папку) mu-plugins (если его не существует).
Сохраните изменения перед внесением. Отсутствие скобки приводит к ошибке 500.
ДО (пример "неработающего" кода, часто добавляемого в functions.php):
<?php
/**
* Exemple de snippet problématique : ajoute defer à (presque) tous les scripts.
* Je l'ai vu copié depuis des tutoriels anciens.
*/
add_filter( 'script_loader_tag', function( $tag, $handle ) {
// ERREUR : on defer aussi les scripts qui doivent s'exécuter immédiatement (Avada, jQuery, etc.)
return str_replace( ' src', ' defer src', $tag );
}, 10, 2 );
ПОСЛЕ (исключая Avada + jQuery + некоторые распространенные обработчики):
<?php
/**
* Plugin MU : exclusions defer/delay pour Avada (WordPress 6.9.4+, PHP 8.1+).
* Fichier : wp-content/mu-plugins/avada-assets-fix.php
*/
defined( 'ABSPATH' ) || exit;
/**
* Retire "defer" (ou empêche son ajout) sur des scripts critiques.
*
* Pourquoi :
* - Avada Builder et certains modules attendent un ordre précis (dépendances JS).
* - Si un script est defer alors que son dépendant ne l'est pas, on obtient des erreurs JS.
*/
add_filter( 'script_loader_tag', function( $tag, $handle ) {
// Liste à adapter : utilisez Query Monitor > Scripts pour voir les handles réels.
$critical_handles = array(
'jquery',
'jquery-core',
'jquery-migrate',
// Avada / Fusion (handles fréquents, selon versions)
'fusion-builder-app',
'fusion-scripts',
'avada-scripts',
);
if ( in_array( $handle, $critical_handles, true ) ) {
// On retire defer si un autre plugin l'a injecté.
$tag = preg_replace( '/sdefer(=(['"]).*?2)?/i', '', $tag );
$tag = preg_replace( '/sdata-no-defer(=(['"]).*?2)?/i', '', $tag );
return $tag;
}
return $tag;
}, 100, 2 );
Почему это исправляет
Avada использует зависимости JavaScript и учитывает время выполнения. Когда плагин "оптимизирует" слишком сильно, в итоге получается следующее:
- скрипт Avada, выполняемый перед jQuery.
- или модули, инициализированные до того, как DOM был готов.
- или непривязанные события (неактивные кнопки в конструкторе).
Исключив критически важные дескрипторы, вы позволяете плагину оптимизации работать с остальными, не нарушая работу Avada.
Требуется проверка (точный диагноз)
- Консоль браузера: ошибка
jQuery is not definedдолжен исчезнуть. - Вкладка «Сеть»: скрипты Avada должны отвечать кодом 200 (а не 404/403).
- Монитор запросов > Скрипты: проверьте порядок и наличие файлов.
Решение 2: Неработающие разделы "на всю ширину" (контейнер, дочерняя тема, глобальные CSS-стили)
Типичные симптомы: контейнеры во всю ширину, которые перестают быть контейнерами во всю ширину, колонки, выходящие за пределы видимой области, горизонтальная прокрутка, разделы, «прилипшие» к краю, или, наоборот, все заключено в рамки фиксированной ширины.
Классический триггер: глобальный CSS-код, добавленный к:
- Avada > Параметры > Пользовательский CSS,
- Внешний вид > Настройка > Дополнительные CSS-стили
- дочерняя тема (style.css),
- плагин для создания фрагментов CSS-кода.
- или сторонний плагин для создания страниц.
Распространенная ошибка: перегрузка .container/.row
ДО (неработающий CSS, который я регулярно вижу):
/* Exemple problématique : trop générique */
.container {
width: 100%;
max-width: 100%;
}
.row {
margin-left: 0;
margin-right: 0;
}
Почему это опасно: Avada использует собственные оболочки и сетку. Если вы принудительно... .container ou .rowВы нарушаете расчеты отступов/полей и адаптивный дизайн.
Диагностика: поиск выигрышного CSS
- Откройте неработающую страницу.
- Щелкните правой кнопкой мыши > Проверить элемент (Chrome/Firefox).
- Выберите элемент, который выходит за пределы допустимого диапазона (чаще всего это контейнер).
- Посмотрите вкладку «Стили»: там вы увидите точное правило и файл кто его применяет.
Если правило исходит из вашей дочерней темы или дополнительных CSS-стилей, исправьте его, ограничив его применение соответствующим контекстом.
Исправление: Используйте область видимости для ваших CSS-стилей вместо изменения общих классов.
ПОСЛЕ (исправленный, целевой CSS):
/* Exemple corrigé : on cible uniquement une zone spécifique */
.page-id-123 .banniere-custom .container {
max-width: 1200px;
margin-left: auto;
margin-right: auto;
}
/* Et si vous voulez du full width, ciblez votre wrapper, pas .container global */
.page-id-123 .banniere-custom {
width: 100%;
max-width: 100%;
}
Куда вставить этот CSS-код:
- Самый чистый: ребенок тема >
style.css. - Итак, начнём: дополнительный CSS (Персонализируйте).
- Избегайте умножения мест расположения (иначе вы уже не будете знать, откуда берется правило).
Типичный случай в Avada: overflow-x hidden "для маскировки" переполнения
Я часто видел, как пользователи добавляют это в раздел "Удалить горизонтальную прокрутку":
html, body { overflow-x: hidden; }
Это маскирует симптом, а не причину. В тот день, когда модулю действительно нужно выйти за пределы видимой области (слайдер, анимация), он обрезается. Вместо этого найдите проблемный элемент (инструменты разработчика) и исправьте его ширину/отступы.
Расширенная опция (с кодом): загрузка корректирующего CSS только на определенных страницах.
Если вы не хотите изменять глобальные CSS-стили, загружайте файл патча для каждой страницы отдельно с помощью хука. крючок В WordPress это хук: действие или фильтр. Здесь мы используем действие. wp_enqueue_scripts.
Куда вставить код : functions.php du ребенок тема (или пользовательский плагин).
Сохраните перед редактированием. Забытая запятая может привести к сбою сайта.
ДО (плохая практика: огромные встроенные CSS-стили по всему сайту):
<?php
add_action( 'wp_head', function() {
// ERREUR : CSS injecté partout, difficile à maintenir, impact perf
echo '<style>.container{max-width:100%!important;}</style>';
} );
ПОСЛЕ (очистка очереди + нацеливание):
<?php
/**
* Thème enfant : charge un CSS correctif seulement sur une page.
* Fichier : wp-content/themes/Avada-child/functions.php
*/
add_action( 'wp_enqueue_scripts', function() {
// Exemple : ne charger que sur la page ID 123.
if ( ! is_page( 123 ) ) {
return;
}
wp_enqueue_style(
'avada-child-layout-fix',
get_stylesheet_directory_uri() . '/assets/css/layout-fix.css',
array(), // Dépendances (si besoin, ajoutez le handle du style Avada)
'2026-04-05'
);
}, 20 );
Почему это лучше: WordPress управляет загрузкой, кэшированием в браузере, и вы избегаете засорения всех страниц.
Решение 3: Шорткоды Fusion не отображаются, а JS Builder не работает (хуки, REST/AJAX, безопасность).
Типичные симптомы:
- Вы можете увидеть короткие коды Avada в виде обычного текста (например:
[fusion_text]). - Программа Builder загружается частично, а затем зависает.
- Сетевые вызовы не проходят (403/401)
/wp-json/ouadmin-ajax.php.
Распространенная причина: отключение Avada Builder/Core или несовместимые версии.
Avada использует вспомогательные плагины. Проверьте в разделе «Расширения»:
- Авада Коре : активный
- AvadaBuilder : активный
Если один из шорткодов неактивен, некоторые из них больше не будут сохраняться, поэтому WordPress будет отображать их как текст.
Распространенная причина: фильтр, который «очищает» контент и нарушает работу шорткодов.
Мне часто попадался этот фрагмент (скопированный из старых источников). статьи), которая удаляет шорткоды из контента:
ДО (сломано):
<?php
/**
* Exemple problématique : supprime les shortcodes du contenu.
* Résultat : Avada ne peut plus rendre ses éléments.
*/
add_filter( 'the_content', function( $content ) {
// ERREUR : retire tout ce qui ressemble à un shortcode
$content = preg_replace( '/[[^]]+]/', '', $content );
return $content;
}, 5 );
ПОСЛЕ (мы избегаем изменения содержимого или ограничиваемся конкретным случаем):
<?php
/**
* Correction : ne supprimez pas les shortcodes globalement.
* Si vous devez nettoyer un contenu, faites-le sur un champ spécifique,
* ou sur un type de contenu précis, et jamais via une regex globale.
*/
add_filter( 'the_content', function( $content ) {
// Exemple : ne rien faire sur les pages Avada (le plus sûr pour débuter).
if ( is_singular() ) {
return $content;
}
return $content;
}, 5 );
Почему это решает проблему: Avada использует шорткоды (или внутренние блоки/структуры в зависимости от конфигурации). Удаление их на уровне the_content Это равносильно отказу от "рецепта" компоновки.
Распространенная причина: блокировка REST API (по соображениям безопасности) и зависимость Builder от вызовов API.
Некоторые плагины безопасности или фрагменты кода блокируют REST API. Однако современный редактор WordPress и ряд конструкторов сайтов полагаются на него. /wp-json/ (хотя у Avada есть свои собственные механизмы).
ДО (опасный фрагмент, слишком агрессивный):
<?php
/**
* Exemple courant : bloque TOUTE la REST API.
* Effets : éditeurs et builders cassés, intégrations KO.
*/
add_filter( 'rest_authentication_errors', function( $result ) {
if ( ! is_user_logged_in() ) {
return new WP_Error( 'rest_forbidden', 'REST API désactivée.', array( 'status' => 403 ) );
}
return $result;
} );
ПОСЛЕ (мы ограничиваем блокировку и, по крайней мере, оставляем открытыми необходимые маршруты):
<?php
/**
* Version plus prudente : ne bloquez pas la REST API globalement.
* Si vous devez restreindre, faites-le par route et avec une logique claire.
*
* OÙ : plugin custom ou mu-plugin (évitez functions.php si vous testez souvent).
*
* Risque sécurité : mal configurer ce filtre peut exposer des données.
* Testez en staging.
*/
add_filter( 'rest_authentication_errors', function( $result ) {
// Si une autre auth a déjà échoué, on respecte.
if ( is_wp_error( $result ) ) {
return $result;
}
$request_uri = isset( $_SERVER['REQUEST_URI'] ) ? (string) $_SERVER['REQUEST_URI'] : '';
// Exemple : autoriser tout /wp/v2/ et laisser WordPress gérer les permissions.
// Adaptez à votre politique réelle.
if ( str_contains( $request_uri, '/wp-json/wp/v2/' ) ) {
return $result;
}
// Bloquer uniquement certaines routes custom (exemple).
if ( str_contains( $request_uri, '/wp-json/mon-plugin-prive/' ) && ! is_user_logged_in() ) {
return new WP_Error(
'rest_forbidden',
'Accès REST restreint.',
array( 'status' => 403 )
);
}
return $result;
} );
Официальная справочная информация по REST API: developer.wordpress.org/rest-api.
Распространенная причина: блокировка AJAX-запросов администратора (nonce/права доступа) или WAF.
Если строитель совершает звонки по admin-ajax.php А если вы видите 403/401, проверьте:
- Плагин безопасности/WAF (Wordfence, Cloudflare WAF, ModSecurity), блокирующий запросы.
- Кэш, который кэширует AJAX-ответ (неправильная конфигурация).
- Нунций скончался: один нунций Это токен защиты от CSRF-атак. Если он недействителен, WordPress отклоняет действие.
Справочная информация о нунциях: Нонсы (безопасность WordPress).
Проверки после внесения исправлений
После каждого решения выполняйте тесты в следующем порядке (в противном случае вы можете "подтвердить" ложноположительный результат из-за кэша):
- Удалять : кеш Avada, кеш плагинов, кеш сервера, кеш CDN.
- навигатор : принудительная перезагрузка (Ctrl+F5) + проверка в режиме приватного просмотра.
- Консоли : больше нет красных ошибок, связанных с Avada/jQuery.
- Mobile : адаптивное тестирование (инструменты разработчика) +, по возможности, тестирование на реальном телефоне.
- Подключено/Отключено : открыть приватное окно, чтобы имитировать присутствие посетителя.
Если вы используете Fusion Builder/Fusion Slider: протестируйте "простую" страницу (1 контейнер, 2 колонки, 1 кнопка). Это позволит вам быстро увидеть, отображается ли сетка.
Если это всё ещё не поможет
Когда возникает сопротивление, я всегда действую методично, иначе мы просто ходим по кругу.
1) Проверьте наличие ошибок (журналы + монитор запросов)
- открытый
wp-content/debug.log(если включена опция WP_DEBUG_LOG). - Установите Query Monitor и наблюдайте:
- ошибки PHP
- Скрипты/стили загружены
- HTTP-запросы
2) Проверка работоспособности: Изолируйте тему/плагины, не нарушая работу общедоступного сайта.
- Активируйте режим устранения неполадок.
- Оставьте Avada + Avada Core + Avada Builder.
- Отключите все остальное.
- Активируйте их по одному, пока не воспроизведете ошибку.
Если вы обнаружили неисправный плагин: перед его удалением найдите опцию «исключить» (исключить скрипты Avada из задержки/комбинации).
3) Проверьте наличие ошибок 404/403 в отношении активов (сети).
В разделе «Инструменты разработчика» > «Сеть»:
- Отфильтруйте по "CSS", затем по "JS".
- Определите статусы 404/403.
- Откройте URL-адрес в новой вкладке: если он выдает ошибку 404, это не проблема браузера, а проблема сервера/прав перезаписи/прав доступа/CDN.
4) Постоянные ссылки / переписывание
Полезный совет: перейдите в «Настройки» > «Постоянные ссылки» и нажмите «Сохранить» (ничего не меняя). Это заново сгенерирует правила перезаписи.
ссылка: flush_rewrite_rules() (Не стоит упоминать об этом на каждой странице, только изредка).
5) Проверьте память PHP
Avada может быть ресурсоемким приложением, особенно при наличии множества модулей и опций. Недостаток памяти может привести к некорректному поведению (и не всегда к простой ошибке).
ссылка: Увеличение объема памяти, выделенной для PHP..
6) Заключительный шаг: временно отключить все серверные кэши.
- Кэш Nginx/FastCGI
- лак
- CDN (режим разработки)
Я видел, как CDN обслуживал CSS-файл Avada, которому было несколько дней, несмотря на "успешную" очистку на стороне плагина. Главный тест: обойти CDN (хостинг или, если возможно, прямой URL-адрес источника), чтобы подтвердить это.
Распространенные ошибки и ловушки
| симптом | Причина вероятна | Рекомендуемое решение |
|---|---|---|
| Ошибка 500 после добавления фрагмента кода. | Код вставлен не в то место, отсутствует точка с запятой. | Удалите фрагмент кода через FTP, используйте mu-плагин, проверьте синтаксис. |
| Конструктор завис, в консоли: jQuery не определен | Плагин Perf, отличающийся от jQuery. | Решение 1 (исключить критически важные обработчики, отключить задержку/отсрочку для Avada) |
| Повсюду многоэтажные колонны. | Глобальные CSS-стили для .container/.row | Решение 2 (ограничить область действия CSS, удалить общие правила) |
| Всё работает, когда подключено, но ломается, когда отключено. | Задержка из-за кэширования страниц и JavaScript различается для посетителей. | Отключите кэширование страниц в конструкторе страниц, очистите кэш, удалите исключения. |
| Отображаются короткие коды | Avada Builder/Core неактивен или фильтр the_content является деструктивным. | Включите плагины Avada, удалите «очистку» регулярных выражений, Решение 3. |
| Исправление применено, но ничего не изменилось. | Кэш браузера/CDN не очищен. | Приватный просмотр + очистка CDN + версионирование CSS (строка запроса) |
| Фрагмент кода «defer» не работает. | Неправильный подход, неправильные приоритеты | Используйте script_loader_tag с высоким приоритетом (100), проверяйте дескрипторы. |
| CSS/JS 404 | Права доступа к файлам, папка загрузок/кэша удалены. | Исправить права доступа, восстановить ресурсы, проверить правила безопасности сервера. |
Часто встречающиеся ошибки среди новичков (которые отнимают время):
- Скопируйте код в родительская тема вместо детской тематики.
- Протестируйте непосредственно на рабочей среде, без сохранения или создания тестовых сред.
- Забыть очистить кэш плагина И CDN (и поверить, что «это не работает»).
- Использую пятилетнее руководство по оптимизации, которое "откладывает всё на потом" (несовместимое с современными конструкторами).
- Путаница между действием и фильтром: фильтр должен возвращение ла валер.
Вариант / альтернатива
Метод без кода: исключения в вашем плагине оптимизации
Большинство плагинов для повышения производительности позволяют исключать следующие параметры:
- скрипты по URL или по ключевому слову (
fusion,avada), - страницы (редактор, конструктор страниц),
- или отключить «задержку JavaScript» только на определенных страницах.
Если вы новичок, это часто лучший компромисс: меньше риска, чем при использовании плохо скопированного PHP-фрагмента.
Более продвинутый метод: точное профилирование активов.
Для технических профилей вы можете:
- Используйте Query Monitor для отображения списка скриптов/стилей и их зависимостей.
- Сравните сгенерированный HTML-код (просмотреть исходный код) в обычном режиме и в режиме устранения неполадок.
- Если у вас установлен WP-CLI, проверьте конфигурацию и выполните целевую очистку (в зависимости от используемой вами платформы).
Справочник WP-CLI (официальный): Команды WP-CLI.
Избегайте этой проблемы в будущем.
- Выполняйте обновления в указанном порядке. WordPress 6.9.4+ → Avada (тема) → Avada Core/Builder → плагины. Затем выполните полную очистку кеша.
- Избегайте фрагментов кода, "использующих магическую оптимизацию". кто подает заявку
defer/asyncПовсюду. Современным строителям нужен стабильный порядок. - Централизуйте ваш CSS : одно место (детская тематика), а не четыре. Правила вы найдете там.
- Ограничьте область действия вашего CSS предпочитать
.page-id-123 .mon-blocа не.containerглобальный характер. - Сохраняйте сцену Даже "дешевый" тестовый сервер предотвратит поломку вашего общедоступного сайта.
- Следите за консолью После добавления каждого плагина: даже одна ошибка JavaScript может привести к поломке всего пользовательского интерфейса.
Если вам нужно добавить фрагмент кода, используйте mu-плагин и версионируйте свои изменения. Это упростит его отключение в экстренных случаях через FTP.
Ресурсы
- Отладка в WordPress (WP_DEBUG)
- wp_enqueue_script() (загрузка JS)
- фильтр script_loader_tag
- Справочник по REST API
- Нонсы (безопасность WordPress)
- Монитор запросов (плагин)
- Проверка состояния и устранение неполадок (плагин)
- Поддерживаемые версии PHP
- Ядро WordPress на GitHub (справочник кода)
Часто задаваемые вопросы
Следует ли отключать Avada Builder, если я больше не редактирую свои страницы?
Нет, если ваши существующие страницы зависят от него. Если контент создан с использованием элементов Avada, отключение Avada Builder/Core может привести к отображению шорткодов в виде обычного текста или нарушению рендеринга.
Почему проблема проявляется только на мобильных устройствах?
Часто это происходит из-за того, что глобальная оптимизация CSS или «критический CSS» не охватывает контрольные точки, или из-за задержки выполнения адаптивного скрипта. Проверьте это, временно отключив «удалить неиспользуемый CSS» и «задержать JS».
Я исправил CSS, но изменений не вижу.
Практически всегда данные кэшируются. Очистите кэш плагина и кэш CDN, затем протестируйте в режиме приватного просмотра. Если вы загружаете CSS-файл, измените его номер версии (например, 2026-04-05) чтобы принудительно запустить браузер.
Где лучше всего вставить фрагмент PHP-кода?
Для устранения неполадок в Avada я предпочитаю... мю-плагин (данс /wp-content/mu-plugins/Оно остаётся активным, и вы можете быстро удалить его через FTP, если допустите ошибку.
В чём разница между действием и фильтром?
Один действие выполняет код в заданный момент времени (например, wp_enqueue_scripts). фильтры получает значение и должен возвращение измененный или неизмененный (например: script_loader_tag).
Может ли плагин кэширования нарушить работу Avada?
Да, особенно если это объединяет/откладывает выполнение JavaScript или кэширует страницы, которые не должны кэшироваться (страницы редактирования, страницы с динамическим контентом). Исключения для каждой страницы и каждого скрипта обычно решают проблему.
Почему в конструкторе сайтов отображается белый экран, а на общедоступном сайте — нет?
Поскольку административная панель загружает разные скрипты, ошибка JavaScript в административном интерфейсе (или ограничение REST/AJAX) может привести к сбою конструктора, не затрагивая при этом внешний интерфейс.
Может ли простая операция «CSS reset» привести к нарушению корректного отображения?
Да. Слишком агрессивные перезагрузки на img, iframe, .container, .row или глобальные правила по box-sizing Они могут нарушить работу сети. Примените правила только к своему блоку.
В сгенерированных CSS-файлах я вижу ошибки 404: что мне делать?
Для начала очистите и заново сгенерируйте кэш (Avada + плагинов). Затем проверьте права доступа/разрешения. wp-content/uploadsЕсли CDN активен, очистите и его сторону.