Better Preview Pro - Расширение Joomla

Руководство по настройке и проверке предпросмотра в Better Preview Pro

Better Preview Pro нужен не для украшения админ-панели Joomla, а для конкретной редакторской задачи: быстро увидеть, как материал будет выглядеть на публичной части сайта, не переходя вручную на главную страницу и не угадывая правильный пункт меню. В этом руководстве разберём, как использовать расширение как рабочий инструмент для редактора, вебмастера и администратора старого Joomla-сайта: что проверить перед установкой, какие параметры включать первыми, как проверить результат и что делать, если предпросмотр ведёт не туда.

Материал написан с учётом важного ограничения из официальной документации Regular Labs: Better Preview относится к ветке Joomla 3, а для более новых сайтов разработчик предлагает Better Frontend Link. Поэтому руководство не будет обещать универсальную совместимость. Мы отдельно разберём, когда Better Preview Pro ещё имеет смысл на поддерживаемой копии старого сайта, а когда безопаснее планировать замену, миграцию или другой рабочий процесс.

Основной сценарий здесь такой: редактор открывает материал в админ-панели, нажимает кнопку предпросмотра или улучшенную ссылку на публичную часть, получает страницу с правильным шаблоном, модулями и активным пунктом меню, а затем проверяет, что текст, изображения, поля и окружение страницы совпадают с ожиданием. Главная ценность Better Preview Pro - сокращение ручной проверки перед публикацией, но эта ценность появляется только после аккуратной настройки меню, кеша и исключений.

Какую задачу решает расширение для редактора Joomla

В Joomla внешний вид материала зависит не только от самого текста. На итоговую страницу влияют пункт меню, шаблон, назначенные модули, категория, параметры компонента, настройки SEF-ссылок, доступы и кеш. Поэтому обычная кнопка перехода на сайт часто не отвечает на главный вопрос редактора: как конкретная статья будет выглядеть в своём реальном окружении. Better Preview Pro пытается сократить этот разрыв между экраном редактирования и публичной страницей.

Официальная документация описывает два ключевых механизма. Первый - кнопка предпросмотра для статьи, которая открывает модальное окно с видом материала до сохранения или публикации. Второй - улучшение стандартной ссылки View Site в админ-панели: вместо перехода на главную страницу она может вести к публичному эквиваленту редактируемой сущности и показывать выпадающий список родительских страниц, например категорий, а также главную страницу.

Для редактора это означает не просто более удобную кнопку. Расширение меняет привычку проверки контента: вместо цепочки «сохранить черновик, открыть сайт, найти раздел, перейти в статью, обновить страницу» появляется более короткий путь от формы редактирования к странице, где материал будет читать посетитель. Особенно заметно это на сайтах с длинными меню, скрытыми служебными пунктами, несколькими категориями и разными модульными позициями.

Где эффект заметен сильнее всего

Better Preview Pro особенно полезен в редакционных процессах, где статья перед публикацией проходит несколько правок. Например, контент-менеджер проверяет лид, изображения, таблицы, ссылки и заголовки, а затем отдаёт страницу на финальную проверку администратору. Если каждый раз нужно вручную искать публичный URL, проверка становится медленной и непредсказуемой.

Второй типичный случай - сайты, где материал без пункта меню выглядит иначе, чем материал внутри нужной категории. Joomla использует активный пункт меню для выбора параметров вывода, шаблона и модульного окружения. Если предпросмотр не понимает этот контекст, редактор может видеть страницу без нужных боковых модулей, с другой разметкой или с URL, который не совпадает с будущим публичным маршрутом.

Что расширение не должно заменять

Better Preview Pro не является системой согласования публикаций, визуальным конструктором и инструментом миграции. Оно не исправляет ошибки шаблона, не делает старую ветку Joomla безопасной само по себе и не гарантирует, что сторонний компонент корректно поддерживает предпросмотр. Его задача уже: дать удобную ссылку или модальное окно для проверки материала в контексте сайта. Если в проекте нужен полноценный редакционный процесс с ролями, статусами и журналом правок, Better Preview Pro может быть частью процесса, но не его центром.

Текущий статус продукта и совместимость, которую нельзя игнорировать

Самая важная часть оценки Better Preview Pro - не список кнопок, а совместимость. В официальной документации Regular Labs для Better Preview указано, что это документация для Joomla 3, а версии для Joomla 4 и выше у Better Preview нет. Там же разработчик предлагает использовать Better Frontend Link для новых веток Joomla. Это не мелкая сноска, а практическое ограничение, которое должно определять решение о внедрении.

Если сайт уже работает на старой ветке Joomla и по техническим причинам не может быть быстро перенесён, Better Preview Pro можно рассматривать как инструмент для аккуратной редакторской проверки. Но перед установкой нужно честно оценить окружение: кто обслуживает сайт, как делаются резервные копии, где тестируется расширение, есть ли план миграции и понимает ли команда риск работы на устаревшей платформе.

Не ставьте Better Preview Pro как способ отложить миграцию. Если сайт можно перевести на актуальную ветку Joomla, логичнее смотреть на Better Frontend Link или штатные инструменты новой версии, а Better Preview оставить только для старой рабочей копии, где он действительно поддерживается окружением.

Как читать сведения о Pro-версии

В старых материалах по Better Preview встречаются упоминания бесплатной и платной редакции. Сторонний tutorial Joomlashack описывает, что функция копирования ссылки в буфер относилась к платной версии, а официальное видео Regular Labs показывает установку Pro-версии через Regular Labs Extension Manager при наличии доступа к Pro-пакетам. В статье не стоит строить критический рабочий процесс на одной платной функции, если вы не проверили её в своём пакете. Формулируйте процесс так, чтобы он работал даже без копирования ссылки: главное - корректный предпросмотр и правильный публичный маршрут.

Какой вывод сделать перед работой

Перед установкой ответьте на простой вопрос: вы обслуживаете существующий Joomla 3-сайт или пытаетесь улучшить современный сайт на Joomla 4, 5 или 6? В первом случае Better Preview Pro может быть полезен как вспомогательный инструмент. Во втором случае лучше не тратить время на попытки поставить неподходящее расширение. Сразу изучайте Better Frontend Link и проверяйте, закрывает ли он ваш сценарий перехода из админ-панели к публичной странице.

Кому подойдёт Better Preview Pro, а кому лучше выбрать другой путь

Расширение хорошо подходит командам, которые регулярно редактируют материалы в Joomla и тратят время на ручную проверку публичного вида. Это могут быть информационные сайты, корпоративные порталы, каталоги статей, образовательные сайты и старые клиентские проекты, где структура меню сложнее, чем одна главная страница и несколько материалов.

Better Preview Pro полезен редактору, который хочет видеть статью в шаблоне сайта, вебмастеру, который проверяет активный пункт меню и модульное окружение, и администратору, который хочет дать команде более понятный путь проверки. Но продукт может не подойти, если вся команда уже работает в актуальной ветке Joomla, если сайт построен преимущественно на стороннем компоненте без поддержки предпросмотра или если главная проблема не в поиске страницы, а в устаревшем шаблоне, ошибках PHP или небезопасном окружении.

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

Что проверить перед установкой на рабочий сайт

Подготовка важна из-за характера продукта: Better Preview Pro вмешивается в админский сценарий предпросмотра и в ссылку перехода на публичную часть. Это не просто текстовый плагин, который можно включить и забыть. Неправильная настройка может не сломать сайт полностью, но легко запутает редактора: кнопка появится, ссылка поведёт не туда, модальное окно покажет старую версию страницы, а команда решит, что материал оформлен неправильно.

Резервная копия и тестовая копия

Перед установкой сделайте резервную копию файлов и базы данных. Если проект обслуживается регулярно, лучше проверить расширение на staging-копии. Это особенно важно для старых сайтов, где могут быть индивидуальные правки шаблона, старые редакторы, нестандартные плагины контента или изменённые файлы ядра. Regular Labs в общих FAQ отдельно подчёркивает, что поддержка предполагает корректное окружение без изменённых файлов ядра и расширений.

Версия Joomla и план замены

Проверьте, что сайт действительно относится к той ветке Joomla, для которой Better Preview предназначен. Если проект уже находится на новой ветке, не пытайтесь заставить старое расширение работать в обход документации. Для новых веток есть Better Frontend Link, который решает близкую задачу перехода к публичному эквиваленту страницы.

Меню, категории и скрытые пункты

Главный источник странного предпросмотра в Joomla - не сама кнопка, а связь материала с пунктом меню. В Joomla пункт меню определяет не только URL, но и параметры вывода страницы. Поэтому перед включением Better Preview Pro полезно открыть структуру меню и понять, какие категории имеют собственный пункт, какие материалы выводятся через Category Blog или Single Article, а какие вообще не привязаны к меню.

Если статья не имеет очевидного пути через меню, предпросмотр может использовать маршрут без активного пункта или опираться на параметр Default Menu ID. Это не ошибка продукта, а следствие логики Joomla. Лучше заранее создать служебный скрытый пункт меню для категории или выбрать дефолтный пункт в настройках, чем потом объяснять редактору, почему страница открылась без нужных модулей.

Права доступа и редакторские роли

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

Установка и первая проверка без лишнего риска

Официальное видео Regular Labs описывает несколько способов установки: загрузка пакета через Joomla installer, установка через Install from Web и использование Regular Labs Extension Manager. Для старого Joomla-сайта выбирайте способ, который уже принят в проекте и лучше контролируется командой. Если у вас есть несколько расширений Regular Labs, Extension Manager удобен для обновлений и просмотра доступных пакетов. Если установка разовая, достаточно обычной загрузки ZIP-пакета через менеджер расширений.

Базовый порядок установки

1. Сделайте резервную копию и проверьте, что можете восстановить сайт.
2. Скачайте установочный пакет Better Preview Pro из доверенного источника, связанного с Regular Labs или вашим легальным архивом проекта.
3. В админ-панели Joomla откройте менеджер установки расширений и используйте вкладку загрузки пакета.
4. После установки найдите системный плагин Better Preview и убедитесь, что он опубликован.
5. Откройте тестовую статью, проверьте наличие кнопки предпросмотра и улучшенной ссылки на публичную часть.
6. Откройте предпросмотр в режиме редактора и сравните результат с ожидаемой страницей на сайте.

Не начинайте с тонкой настройки. Сначала убедитесь, что расширение установилось, плагин включён, кнопка появляется, а предпросмотр вообще открывается. Если базовая проверка не прошла, дальнейшие параметры вроде Default Menu ID или Purge Component Cache только усложнят диагностику.

Что считать успешной первой проверкой

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

Мини-итог: после установки у вас должна появиться проверяемая цепочка «форма редактирования - кнопка предпросмотра - публичный результат». Пока эта цепочка не работает на тестовой статье, не переносите процесс на всю редакцию.

Карта настроек Better Preview Pro после установки

Настройки Better Preview находятся в параметрах системного плагина. Официальная документация группирует их вокруг трёх зон: параметры ссылки View Site, параметры кнопки предпросмотра и расширенные параметры. Удобнее настраивать их именно в таком порядке: сначала решаем, где показывать ссылки, затем как выглядит кнопка, затем как расширение выбирает маршруты и кеш.

Параметры ссылки View Site

В блоке View Site Options проверьте, где расширение должно заменять стандартную ссылку перехода на сайт. Параметры Display Title Link и Display Status Link отвечают за преобразование ссылки в заголовочной или статусной области админ-панели. Если редакторы привыкли к конкретному месту, не включайте сразу всё. Лучше оставить один понятный вход и обучить команду пользоваться им.

Reverse Status Link меняет порядок пунктов в выпадающем списке. Это не критическая функция, но она влияет на привычку команды. Если редакторы чаще переходят к текущей статье, пусть соответствующий пункт будет ближе к началу списка. Если чаще проверяют родительскую категорию, порядок можно развернуть.

Show Type и Show URL Details помогают понимать, куда ведёт ссылка. На простом сайте их можно оставить выключенными, чтобы не перегружать интерфейс. На сайте со сложной структурой лучше включить хотя бы детали URL для администратора: так быстрее видно, почему один материал ведёт через категорию, а другой - через дефолтный пункт меню.

Параметры кнопки предпросмотра

Блок Preview Button Options управляет кнопкой в редакторском сценарии. Display Editor Button добавляет кнопку рядом с редактором, а Display Toolbar Button показывает её в панели инструментов. Для контент-команды обычно удобнее включить оба места на тестовом этапе, посмотреть, где редакторы реально нажимают кнопку, а затем оставить более привычный вариант.

Button Text стоит настроить так, чтобы команда не путала предпросмотр с сохранением. Если интерфейс сайта на русском, можно задать понятную подпись вроде «Предпросмотр». Технические названия лучше не использовать: редактору важна не механика маршрута, а действие.

Primary Button делает кнопку визуально заметнее. Включайте его только если предпросмотр действительно является обязательным шагом перед публикацией. Если кнопка слишком заметна на всех страницах, она начинает конкурировать с сохранением и закрытием материала. Preview Window Width задаёт ширину модального окна. Для проверки длинных статей удобнее оставить максимальную ширину или подобрать значение, при котором не ломается шаблон сайта.

Расширенные параметры

В блоке Advanced Options находятся параметры, которые чаще всего влияют на странные симптомы. SEF Index Timeout (hrs) связан с индексом SEF-адресов. Документация прямо советует увеличить значение, если админские страницы начинают работать медленно. Это хороший пример настройки, которую не нужно трогать заранее: сначала измерьте поведение, затем меняйте.

Purge SEF Index нужен, когда структура адресов изменилась и предпросмотр продолжает опираться на старые данные. Например, вы перенесли категорию, изменили пункт меню или массово поменяли алиасы. После очистки индекса проверьте несколько материалов из разных категорий, а не только одну страницу.

Purge Component Cache может очищать кеш применимого компонента перед предпросмотром. Эта функция полезна, если редакторы видят старую версию страницы, но она может быть лишней на большом сайте с агрессивным кешированием. Включайте её после проверки на копии и смотрите, не замедляет ли она рабочие страницы админ-панели.

Default Menu ID - одна из главных настроек для сайтов со скрытыми или неполными меню. Она задаёт активный пункт меню для URL, если расширение не нашло более подходящий. Disable on Components позволяет исключить компоненты, для которых предпросмотр не нужен или работает неверно. Лучше исключить неподдерживаемый компонент, чем позволить редактору каждый раз получать неправильную страницу.

Кнопка Preview и улучшенный переход View Site в реальной работе

Better Preview Pro полезен потому, что даёт две разные точки входа в проверку. Кнопка предпросмотра нужна, когда редактор находится внутри материала и хочет быстро увидеть текущую страницу. Улучшенная ссылка View Site нужна шире: она помогает перейти к публичному эквиваленту текущей админской страницы и к родительским страницам.

Когда использовать кнопку предпросмотра

Кнопка предпросмотра удобна перед сохранением черновика, после вставки изображений, при проверке таблиц, цитат, списков и встроенных модулей. Её задача - показать материал в близком к реальному виде. Если модальное окно слишком узкое или не показывает ожидаемый контекст, вернитесь к настройке ширины и проверьте связь материала с пунктом меню.

Для редактора полезно ввести правило: перед публикацией открыть предпросмотр и проверить минимум заголовок, первый экран, изображения, ссылки, блоки с кодом, таблицы и боковые модули. Если сайт использует разные шаблоны для разделов, проверка должна включать хотя бы одну статью из каждого важного раздела.

Когда использовать улучшенный View Site

Улучшенный View Site раскрывает больше навигационного контекста. Он может вести к текущему материалу, родительской категории и главной странице. Это полезно, когда администратор проверяет не только сам текст, но и путь пользователя: как посетитель попадёт в раздел, какие модули отображаются на уровне категории, как выглядит список статей и соответствует ли маршрут ожидаемой структуре сайта.

Если редактор жалуется, что «кнопка ведёт не туда», сначала уточните, какой именно вход он использует. Предпросмотр статьи и переход к родительской категории - разные сценарии. Смешение этих двух действий часто воспринимается как ошибка, хотя расширение может работать корректно.

Как не запутать редакцию

Не включайте все возможные элементы интерфейса без объяснения. Сделайте короткую внутреннюю инструкцию: где нажимать предпросмотр, когда проверять родительскую категорию, что делать, если ссылка ведёт на главную, кому сообщать о неправильном маршруте. Better Preview Pro будет полезен только тогда, когда команда понимает, какой результат считать правильным.

Default Menu ID, SEF-адреса и логика активного пункта меню

Самая продуктовая часть настройки Better Preview Pro - работа с активным пунктом меню. Документация Regular Labs объясняет, что при предпросмотре статей и категорий расширение пытается выбрать наиболее подходящий пункт меню на основе типа объекта и родительских категорий. Если подходящего пункта нет, оно может не использовать активный пункт меню, а при необходимости можно указать Default Menu ID.

Чтобы понять важность этого параметра, нужно помнить логику Joomla. Пункт меню - это не только ссылка в навигации. Он задаёт тип страницы, параметры вывода, часть SEO-настроек, активный шаблон и модульное окружение. Поэтому две ссылки на один и тот же материал могут выглядеть по-разному, если они идут через разные пункты меню.

Когда нужен Default Menu ID

Этот параметр стоит настраивать, если часть материалов не имеет собственного публичного пункта меню, но должна проверяться в определённом окружении. Например, все новости выводятся через скрытый пункт меню «Новости», а отдельные статьи не размещаются в основной навигации. В таком случае дефолтный пункт помогает Better Preview Pro выбрать предсказуемый контекст.

Не выбирайте в качестве дефолта случайную главную страницу. Лучше создать служебный пункт меню, который соответствует типу контента: Category Blog для раздела, Single Article для конкретной служебной страницы или другой тип, который реально отражает структуру сайта. Если пункт скрыт из меню, но опубликован, он всё равно может задавать правильный маршрут.

Как проверить, что маршрут выбран правильно

1. Откройте материал из категории, у которой есть явный пункт меню.
2. Нажмите предпросмотр и посмотрите, совпадает ли URL с ожидаемой структурой.
3. Откройте материал из категории без отдельного пункта меню.
4. Проверьте, использовался ли Default Menu ID и появились ли нужные модули.
5. Измените дефолтный пункт только на тестовой копии и повторите проверку.

Если после изменения меню предпросмотр продолжает показывать старый маршрут, очистите SEF-индекс в настройках Better Preview и системный кеш Joomla. Не делайте сразу несколько изменений: сначала меню, потом индекс, потом кеш. Так проще понять, что именно исправило ситуацию.

Почему предпросмотр может отличаться от опубликованной страницы

Разница может быть нормальной, если материал ещё не опубликован, доступен только определённой группе или использует плагины, которые срабатывают иначе в модальном окне. Но если отличие касается шаблона, модулей, меню или URL, почти всегда нужно смотреть активный пункт меню и кеш. Better Preview Pro помогает быстрее обнаружить проблему, но не отменяет стандартную логику маршрутизации Joomla.

Практический пример: проверяем статью до публикации

Разберём реалистичный сценарий. На старом корпоративном сайте есть раздел «Новости», который выводится через пункт меню типа Category Blog. Редактор подготовил новую статью, добавил изображение, таблицу с параметрами и внутреннюю ссылку. Задача - проверить внешний вид до публикации и убедиться, что страница откроется в окружении раздела, а не как изолированный материал без модулей.

Цель

Нужно увидеть статью в шаблоне сайта, проверить боковые модули, убедиться, что таблица не ломает ширину, а изображение отображается в нужном размере. Публикация пока не выполняется, потому что материал ещё проходит проверку.

Подготовка

Перед началом убедитесь, что Better Preview Pro установлен, системный плагин опубликован, у категории «Новости» есть пункт меню, а редактор имеет право редактировать материал. Если категория не привязана к меню, заранее выберите корректный Default Menu ID или создайте служебный пункт меню.

Шаги

1. Откройте статью в админ-панели Joomla и внесите правки.
2. Проверьте категорию, статус публикации, доступ и алиас материала.
3. Нажмите кнопку предпросмотра Better Preview.
4. В модальном окне проверьте первый экран, заголовок, изображение, таблицу и ссылки.
5. Через улучшенную ссылку View Site откройте родительскую категорию и убедитесь, что материал вписывается в список или будет вписываться после публикации.
6. Если видите старую версию страницы, очистите применимый кеш и повторите проверку.

Проверка результата

Результат считается корректным, если предпросмотр показывает материал в нужном визуальном окружении, а родительская страница открывается через ожидаемую категорию. В таблице не должно быть горизонтального развала, изображение не должно вылезать за контентную область, а внутренние ссылки должны вести на существующие страницы.

Нюанс

Если предпросмотр открывает главную страницу, не считайте это сразу поломкой расширения. Проверьте, есть ли подходящий пункт меню, не исключён ли компонент в Disable on Components, не устарел ли SEF-индекс и не мешает ли кеш. Если же проблема воспроизводится только в одном стороннем компоненте, разумнее исключить этот компонент из Better Preview и оставить для него ручную проверку.

Практичные идеи применения в редакционном процессе

Better Preview Pro кажется небольшим расширением, но его можно встроить в несколько рабочих сценариев. Важно не придумывать лишние функции, а использовать подтверждённые возможности: кнопку предпросмотра, улучшенную ссылку к публичному эквиваленту, родительские страницы, дефолтный пункт меню, детали URL и исключение неподходящих компонентов.

Для редактора новостей

Редактор использует кнопку предпросмотра перед каждой публикацией. Внутренняя инструкция может требовать проверить первый экран, изображение, подпись, таблицы, ссылки и вид в родительской категории. Такой сценарий снижает число мелких ошибок, которые обычно обнаруживаются уже после публикации.

Для администратора сложной структуры меню

Администратор включает Show URL Details и использует улучшенную ссылку View Site как диагностический инструмент. Если материал открывается в неправильном окружении, он смотрит, какой маршрут выбран, есть ли подходящий пункт меню и нужен ли Default Menu ID. Здесь расширение помогает не только редактору, но и человеку, который обслуживает структуру сайта.

Для проверки скрытых разделов

На многих Joomla-сайтах есть скрытые пункты меню для служебных страниц, новостей, лендингов или архивов. Better Preview Pro помогает проверить материал через такой пункт, если структура настроена правильно. Это особенно удобно, когда раздел не должен отображаться в основном меню, но должен иметь собственные параметры вывода.

Для поддержки старого сайта до миграции

Если сайт ещё не перенесён на новую ветку Joomla, Better Preview Pro может временно улучшить редакторскую работу. Но в таком сценарии полезно добавить в чек-лист не только кнопку предпросмотра, но и заметку о миграции: какие разделы зависят от старой логики, какие расширения нужно заменить и где Better Frontend Link сможет занять место Better Preview после обновления.

Проверка результата, кеш и безопасная публикация

После настройки важно проверить не только то, что кнопка работает, но и то, что предпросмотр показывает свежую и правильную страницу. Joomla может кешировать компоненты, модули и целые страницы. Официальное руководство Joomla по кешу объясняет, что изменение материала не всегда автоматически очищает кеш страницы, поэтому редактор может видеть устаревший результат.

В Better Preview есть параметр Purge Component Cache, который может очищать кеш применимого компонента перед рендерингом предпросмотра. Но это не универсальное лекарство. На некоторых сайтах есть дополнительный кеш шаблона, серверный кеш, CDN или сторонние оптимизаторы. Поэтому проверка должна быть многоуровневой.

Мини-чек-лист после настройки

• Откройте тестовую статью и проверьте предпросмотр до сохранения.
• Сохраните материал как черновик и проверьте, изменился ли результат.
• Откройте родительскую категорию через улучшенный View Site.
• Проверьте материал в режиме обычного пользователя, если доступы влияют на вывод.
• Очистите кеш Joomla через System и Clear Cache, если видите старые данные.
• Проверьте, не скрывает ли серверный или внешний кеш свежий результат.

Как отличить кеш от неправильного маршрута

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

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

Редакционный регламент: как встроить предпросмотр в публикацию

Better Preview Pro становится заметно полезнее, когда команда использует его не как случайную кнопку, а как часть регламента. Без такого регламента редактор может нажимать предпросмотр только иногда, администратор будет получать расплывчатые жалобы «страница выглядит не так», а ошибки всё равно окажутся на публичном сайте. Хороший регламент короткий: он не превращает публикацию в бюрократию, но задаёт общий язык для проверки.

Разделите процесс на три роли. Редактор отвечает за содержимое: текст, изображения, таблицы, ссылки, подписи, цитаты и вид первого экрана. Администратор отвечает за технический контекст: пункт меню, шаблон, модули, кеш и исключения Better Preview. Ответственный за публикацию принимает финальное решение: материал можно выпускать, нужно поправить маршрут или стоит отложить публикацию до проверки шаблона.

Минимальный чек-лист редактора

Редактору не нужно понимать всю логику Itemid и SEF-индекса. Ему нужен список признаков, которые он может проверить глазами. После нажатия кнопки предпросмотра он должен убедиться, что заголовок не обрезан, вводный абзац читабелен, изображение не растянуто, таблица помещается в контентную область, ссылки открываются, а боковые блоки не перекрывают основной текст. Если что-то выглядит неправильно, редактор фиксирует не «сломалось», а конкретный симптом.

Удобная формулировка для внутренней задачи: «Материал открывается через предпросмотр, но таблица выходит за правый край» или «Предпросмотр показывает свежий текст, но нет правого модуля новостей». Такие сообщения экономят время администратору, потому что сразу отделяют проблему контента от проблемы маршрута.

Минимальный чек-лист администратора

Администратор проверяет то, что редактор не обязан знать. Сначала он открывает тот же материал и смотрит, какой пункт меню выбирается для предпросмотра. Затем проверяет, есть ли у категории собственный пункт меню, подходит ли Default Menu ID, не исключён ли компонент и не устарел ли SEF-индекс. Если редактор видит старую версию страницы, администратор проверяет кеш Joomla и внешние слои кеширования.

Такой порядок важен: если сначала менять CSS шаблона, а потом выяснится, что предпросмотр открывал не ту страницу, вы потратите время на исправление несуществующей проблемы. Better Preview Pro помогает увидеть симптом, но правильная диагностика всё равно начинается с маршрута.

Как оформлять спорные случаи

Иногда предпросмотр показывает результат, который технически корректен, но не нравится редактору. Например, материал открывается в правильной категории, но боковой модуль кажется лишним. Это уже не ошибка Better Preview Pro, а вопрос структуры сайта: нужно менять назначение модуля, параметры пункта меню или шаблон раздела. В регламенте полезно прямо указать, что расширение не является инструментом дизайна. Оно показывает текущую логику сайта, а не придумывает желаемую.

Если спор касается старой ветки Joomla, фиксируйте его в списке задач миграции. Например: «После перехода на новую ветку проверить замену Better Preview Pro на Better Frontend Link», «Проверить скрытый пункт меню новостей», «Убрать зависимость предпросмотра от устаревшего шаблонного override». Так расширение становится не только удобной кнопкой, но и источником фактов о том, как реально устроен старый сайт.

Когда публикацию лучше остановить

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

Если проблема не критична для текущего материала, можно применить временное решение: вручную открыть публичный URL, проверить страницу обычным пользователем и добавить задачу администратору. Но не делайте такой обход постоянным. Если Better Preview Pro установлен, он должен сокращать ручную проверку, а не превращаться в ещё один источник исключений.

Раз в несколько месяцев полезно пересматривать этот регламент. Меню меняется, редакторы привыкают к новым разделам, часть материалов переносится в архив, а старые скрытые пункты меню теряют смысл. Короткая ревизия помогает понять, какие маршруты больше не нужны, где предпросмотр стабильно работает, а где пора заменить временный обход нормальной настройкой структуры сайта. Отдельно отмечайте разделы, где предпросмотр всегда требует ручной проверки, потому что именно они чаще всего становятся кандидатами на переработку при следующем техническом обновлении.

Безопасные улучшения без правки файлов расширения

Для Better Preview Pro не стоит придумывать PHP-хуки или править файлы расширения: публично подтверждённых точек расширения для такого сценария в найденных источниках нет, а правка ядра расширения усложнит обновления. Но есть безопасные внешние улучшения, которые не вмешиваются в код продукта.

Языковые переопределения для понятной подписи

Если редакторам непонятна подпись кнопки или подсказки, используйте штатные языковые переопределения Joomla, а не правку файлов расширения. Это безопаснее: переопределение можно удалить, оно не пропадает при обычном обновлении и не меняет логику работы плагина. Сначала проверьте, какую языковую константу использует конкретная версия расширения, затем создайте override в админ-панели Joomla.

Служебный скрытый пункт меню

Для материалов без явного маршрута создайте служебный пункт меню, который не отображается в основном меню, но задаёт правильный тип страницы. Это обычная Joomla-практика для управления маршрутом и модульным окружением. После создания пункта укажите его как Default Menu ID или проверьте, стал ли Better Preview выбирать его автоматически через структуру категории.

Аккуратный CSS только для публичного результата

Если предпросмотр показывает, что таблицы или изображения ломают публичную страницу, исправляйте не Better Preview, а шаблон сайта. Для небольших визуальных правок используйте CSS-файл шаблона или custom CSS, если он предусмотрен шаблоном. Не вставляйте стили в материал ради одного предпросмотра. Например, для таблиц в контентной области можно добавить обёртку или правило в шаблоне, но только после проверки на реальных страницах.

.article-content table {
  max-width: 100%;
  overflow-wrap: anywhere;
}

.article-content img {
  max-width: 100%;
  height: auto;
}

Этот фрагмент не относится к API Better Preview Pro. Это безопасная внешняя правка шаблона, которая помогает результату предпросмотра совпадать с устойчивым публичным выводом. Проверяйте её на копии сайта, затем откройте несколько статей с таблицами и изображениями. Откат простой: удалите добавленные строки из custom CSS.

Почему предпросмотр может работать неправильно и как это диагностировать

Проблемы Better Preview Pro чаще связаны не с одной кнопкой, а с маршрутизацией Joomla, кешем, правами доступа и компонентами, которые не поддерживают ожидаемый сценарий предпросмотра. Поэтому диагностика должна идти от простого к сложному: наличие кнопки, публикация плагина, маршрут, меню, кеш, исключения, сторонний компонент.

Кнопка предпросмотра не появилась

Симптом простой: редактор открывает материал, но не видит кнопку в редакторе или панели инструментов. Возможные причины - системный плагин не опубликован, параметры Display Editor Button и Display Toolbar Button выключены, пользователь смотрит не тот тип контента или админский шаблон скрывает область кнопок.

Что проверить

• Найдите системный плагин Better Preview и убедитесь, что он опубликован.
• Откройте параметры кнопки и проверьте оба переключателя отображения.
• Проверьте кнопку на обычной статье Joomla, а не сразу на стороннем компоненте.
• Очистите кеш админ-панели и обновите страницу редактирования.

Если кнопка появляется на стандартной статье, но не появляется в стороннем компоненте, не пытайтесь лечить это общими настройками. Скорее всего, компонент не даёт подходящего контекста для кнопки или исключён в параметрах.

Предпросмотр открывает главную страницу

Такой симптом обычно говорит о проблеме маршрута. Better Preview пытается найти подходящий публичный путь, но не находит связанный пункт меню или компонент исключён. Ещё один вариант - для текущего типа контента нет поддерживаемого предпросмотра.

Как исправить

1. Проверьте, есть ли у категории или материала опубликованный пункт меню.
2. Создайте служебный скрытый пункт меню, если публичный пункт не нужен в навигации.
3. Укажите корректный Default Menu ID.
4. Очистите SEF-индекс Better Preview и системный кеш.
5. Проверьте, не добавлен ли компонент в Disable on Components.

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

Открывается правильная страница, но виден старый текст

Если маршрут верный, но содержимое устарело, начните с кеша. Joomla может отдавать сохранённую версию страницы, а сторонние оптимизаторы или серверный кеш могут добавлять ещё один слой. Включение Purge Component Cache помогает только в рамках применимого компонента и не заменяет проверку внешних кешей.

Проверьте страницу после очистки кеша Joomla, затем в приватном окне браузера, затем как обычный пользователь. Если свежий текст виден администратору, но не виден гостю, ищите page cache, CDN или правила доступа.

Модули и шаблон отличаются от реального сайта

Этот симптом почти всегда связан с активным пунктом меню. Joomla выбирает модули и параметры шаблона по Itemid, поэтому неправильный маршрут даёт другое окружение. Проверьте, какой пункт меню используется для предпросмотра, и сравните его с тем, через который посетитель реально попадёт на страницу.

Админ-панель стала медленнее после включения расширенных параметров

Если замедление появилось после работы с SEF-индексом или кешем, верните настройки к более осторожным значениям. В документации Better Preview есть прямой совет увеличить SEF Index Timeout (hrs), если админские страницы работают медленно. Меняйте этот параметр постепенно и проверяйте несколько типичных экранов редактирования.

Предпросмотр стороннего компонента выглядит непредсказуемо

Не все компоненты можно корректно показать через общий механизм предпросмотра. Если проблема повторяется только в одном компоненте, добавьте его в Disable on Components и оставьте для него отдельную ручную проверку. Это лучше, чем давать редакторам кнопку, которая постоянно создаёт ложное впечатление о результате.

Когда Better Preview Pro будет удачным выбором

Better Preview Pro стоит использовать, если вы обслуживаете старый Joomla-сайт, где редакторам регулярно нужно видеть материал в реальном окружении до публикации, а структура меню делает ручную проверку слишком медленной. Самый сильный сценарий - статьи и категории, где важны шаблон, модули, скрытые пункты меню и свежий результат после правок.

Перед внедрением проверьте совместимость, сделайте резервную копию, настройте видимость кнопок, выберите понятный Default Menu ID, протестируйте кеш и исключите компоненты, которые не дают надёжного результата. Если сайт уже обновлён до новой ветки Joomla, лучше перейти к Better Frontend Link и не пытаться использовать продукт вне его актуального контекста.

Если после проверки расширение подходит вашему проекту, можно скачать последнюю версию Better Preview Pro и протестировать его сначала на копии сайта. Публиковать материал через новый процесс стоит только после того, как редактор, администратор и ответственный за сайт одинаково понимают, какой предпросмотр считается правильным и как откатить спорную настройку.