My ShortList - Расширение Joomla

Руководство по настройке и применению My ShortList для Joomla

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

Материал не повторяет краткое описание продукта. Ниже - практическая карта: что проверить перед установкой, как включить модуль, где разместить кнопку, какие параметры трогать первыми, как протестировать гостевой и авторизованный режим, что делать с отправкой списка, PDF и кешем, а также как понять, что расширение подходит именно вашему сайту.

Часть точных фактов подтверждена карточкой Joomla Extensions Directory и отзывами пользователей, часть относится к обычной безопасной практике Joomla: модули привязываются к пунктам меню, доступ управляется ACL, язык меняется через переопределения, а динамичные блоки осторожно проверяются вместе с кешем. Если в вашей версии расширения названия пунктов отличаются, используйте логику разделов, а точные подписи сверяйте в админ-панели и документации разработчика.

Какую задачу решает расширение и где оно особенно уместно

My ShortList относится к категории Joomla-расширений для закладок, рекомендаций и обмена контентом. В карточке JED оно описано как система избранных элементов, с помощью которой пользователи или гости сайта создают персональные списки статей и элементов других компонентов. Это важная формулировка: расширение работает не только как кнопка "сердце", а как слой, который связывает элемент сайта, выбранный пользователем, и отдельное представление списка.

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

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

Когда шортлист лучше полноценной корзины

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

Если конечное действие - "отправить администратору список выбранного", а не "оплатить сейчас", My ShortList может быть проще и чище, чем подключение большой e-commerce-системы. В JED прямо упоминается сценарий симуляции корзины для Joomla-статей и других компонентов через добавление элементов в избранное и отправку списка администратору. Формулируйте это аккуратно: это не checkout, а заявочная логика.

Когда продукт работает как избранное для контента

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

Почему не стоит начинать с дизайна кнопки

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

Практический ориентир: если вы не можете в одном предложении объяснить, что пользователь делает со списком после добавления элементов, настройка ещё не готова. Кнопка "добавить" должна вести к понятному следующему действию: открыть список, отправить его, скачать PDF, сравнить выбранное или вернуться к подборке позже.

Кому подходит My ShortList и когда лучше выбрать другой путь

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

JED перечисляет широкую совместимость с Joomla-статьями, категориями, VirtueMart, JomSocial, ZOO, EventBooking, CommunityBuilder, EasySocial, SobiPro, AdsManager, JobBoard, NS Pro, AcyMailing, JEA, jDownloads, AcePolls и другими компонентами. Это не означает, что на любом конкретном сайте всё включится без проверки. У каждого компонента свои представления, шаблоны, маршруты, права доступа и кеш. Поэтому правильный подход - сначала проверять один тип элемента, потом расширять применение.

Быстрая оценка подходящего сценария

Ситуация на сайте	Подходит ли расширение	Что проверить до внедрения
Каталог товаров или услуг без онлайн-оплаты	Да, если нужен список интереса или запрос администратору.	Поддерживается ли ваш компонент каталога и есть ли понятная форма отправки списка.
Сайт со статьями, учебными материалами или сериями публикаций	Да, как список "прочитать позже" или личная подборка.	Где будет кнопка, как пользователь откроет список и сохраняется ли выбор для гостей.
Полноценный магазин с оплатой, заказами и доставкой	Только как дополнительный список желаний, не как замена магазину.	Не конфликтует ли логика с корзиной, товарами, пользовательскими группами и кешем.
Небольшой корпоративный сайт без каталога	Обычно нет.	Есть ли реальный пользовательский путь, где список экономит время.
Сообщество, каталог профилей, события или объявления	Да, если выбранный компонент входит в поддерживаемые или интеграция подтверждена.	Как работают права доступа и видит ли пользователь только разрешённые элементы.

Главный риск не в том, что расширение "сложное", а в том, что его часто пытаются внедрить без карты пользовательского пути. Нужно заранее решить, будет ли список личным, публичным, отправляемым администратору, доступным только зарегистрированным пользователям или временным для гостя. Эти решения влияют на текст кнопок, доступ, кеш, уведомления и проверку результата.

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

Подготовка нужна не для формальности. My ShortList добавляет динамичное поведение на публичную часть сайта: кнопка меняет состояние, выбранные элементы попадают в список, список может отправляться по email или скачиваться как PDF. Любая динамика зависит от шаблона, кеша, прав доступа, языка и сторонних компонентов. Чем точнее вы проверите окружение до установки, тем меньше времени уйдёт на диагностику.

Совместимость CMS и расширения

В JED текущая карточка указывает совместимость с актуальными поколениями Joomla и показывает, что продукт использует Joomla Update System. В статье не стоит привязывать руководство к конкретной версии, потому что такие данные быстро меняются. Перед установкой откройте карточку JED или страницу разработчика и проверьте совместимость именно с вашей Joomla, PHP и набором сторонних расширений.

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

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

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

Не начинайте с главной страницы или всех карточек каталога. Лучше выбрать один тип контента: например, стандартные Joomla-статьи в тестовой категории. Когда базовая логика подтверждена, переходите к VirtueMart, JomSocial, ZOO, EventBooking или другому компоненту, если он используется на сайте.

Компоненты, с которыми должен работать список

Составьте короткую таблицу своих источников элементов: статьи, категории, товары, объявления, события, профили, файлы. Напротив каждого пункта отметьте, где пользователь видит карточку, где должна появиться кнопка, нужно ли отправлять список администратору и какая информация должна попасть в итоговую подборку. Это простое упражнение быстро показывает, где My ShortList нужен, а где можно обойтись обычной ссылкой или модулем.

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

Кеш и динамические страницы

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

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

Email, PDF и язык сайта

JED подтверждает, что пользователи могут отправлять списки на email, разрешённые администратором, или друзьям, если это разрешено. Также указана возможность скачать список в PDF. Поэтому до установки проверьте отправку почты Joomla, адреса администратора, SPF/DKIM на домене и язык сайта. Отдельный отзыв на JED описывает ограничение PDF-экспорта с китайскими символами и эмодзи; разработчик отвечает, что экспорт использует TCPDF и шрифт можно менять через языковой ключ MOD_MYSHORTLIST_PDF_FONT.

Если сайт русскоязычный или многоязычный, заранее проверьте, как переводятся подписи кнопок, сообщения списка и PDF. Для Joomla безопасный путь - языковые переопределения, а не ручное редактирование файлов расширения. Это сохранит изменения после обновлений.

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

Установка расширения в Joomla технически привычна: загружаете установочный ZIP через менеджер расширений или используете доступный способ установки, если он поддерживается. Но для My ShortList важно не остановиться на зелёном сообщении об успешной установке. Пакет включает разные типы расширений, поэтому после установки нужно найти компонент, модуль и плагин, а затем проверить их вместе.

Шаги установки в общих чертах

1. Скачайте архив расширения из надёжного источника разработчика или с перехода из JED.
2. В админ-панели Joomla откройте установку расширений и загрузите ZIP-пакет.
3. После установки проверьте, появился ли пункт компонента в меню Components или соответствующем разделе админ-панели.
4. Откройте список модулей сайта и найдите модуль My ShortList, если он установлен как отдельный модуль.
5. Проверьте плагины, связанные с интеграцией или выводом кнопки, и включите только те, которые нужны вашему сценарию.
6. Создайте тестовую страницу, назначьте модуль на безопасную позицию и привяжите его к одному пункту меню.
7. Откройте публичную часть сайта в режиме гостя и в режиме авторизованного пользователя.

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

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

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

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

Мини-карта проверки после установки

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

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

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

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

Источник элемента

Источник элемента - это не URL в адресной строке, а объект, который расширение умеет распознать: статья, товар, событие, профиль, файл, запись каталога. В описаниях старых зеркал встречалась формулировка о работе с компонентом и ID вместо URL, но в статье лучше не делать из этого непроверенное техническое обещание. Для практики достаточно помнить: надежнее тестировать добавление на реальном типе элемента, а не на случайной странице.

Кнопка и модульная позиция

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

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

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

Дополнительные действия

JED подтверждает отправку списка администратору или друзьям, а также PDF-скачивание. Эти действия нужно проверять отдельно от обычного добавления. Email зависит от почтовых настроек Joomla и домена, PDF - от шрифтов и библиотеки TCPDF, список для гостя - от хранения состояния в браузере, список авторизованного пользователя - от записи в базе и прав доступа. Одно успешное добавление ещё не доказывает, что весь сценарий готов.

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

Самый полезный этап начинается после установки. Здесь нужно превратить расширение в понятный инструмент для вашего сайта: выбрать область показа, способ хранения, типы списков, тексты, email, PDF, права доступа и поведение с кешем. Названия точных параметров могут отличаться по версии, но порядок настройки остаётся практичным.

Где искать настройки

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

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

JED указывает, что можно иметь несколько списков на модуль, определённых администратором или пользователями для себя. Это одна из важных особенностей My ShortList. Для простого сайта достаточно одного списка: "Избранное", "Моя подборка", "Список заявки". Для сложного каталога можно разделить сценарии: "Интересно", "Сравнить", "Запросить цену", "План посещения".

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

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

1. Создайте два тестовых списка с разными названиями и назначением.
2. Добавьте один и тот же элемент в каждый список, если интерфейс это позволяет.
3. Проверьте, не смешиваются ли элементы в итоговом представлении.
4. Отправьте каждый список отдельно на тестовый адрес.
5. Очистите кеш и повторите проверку в гостевом режиме.

Гостевой и авторизованный режим

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

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

Кнопка сердца, текст кнопки и состояние после клика

Button-only режим с сердцем удобен для карточек и сеток. Но сердце без текста не всегда понятно в B2B-каталогах, образовательных подборках или заявочных списках. Подберите подписи по сценарию: "Добавить в подборку", "Сохранить материал", "Добавить к заявке", "Убрать из списка". Если точные тексты задаются через языковые строки, используйте языковые переопределения Joomla.

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

Отправка списка администратору или другу

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

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

PDF-экспорт и русские символы

PDF полезен для списков объектов, образовательных маршрутов, музейных подборок или заявок, которые пользователь хочет сохранить. Но PDF сразу добавляет проверку шрифтов. В JED есть отзыв о проблемах с китайскими символами и эмодзи, а разработчик отвечает, что My ShortList использует TCPDF и шрифт можно менять через языковой ключ MOD_MYSHORTLIST_PDF_FONT. Для русскоязычного сайта это важная подсказка: если PDF показывает квадраты или пустые символы, первым делом проверьте шрифт, а не переписывайте шаблон.

Безопасный способ изменения - языковое переопределение. Не редактируйте файлы расширения напрямую. В Joomla создайте override для нужного языка и клиента, затем задайте ключ шрифта. Значение зависит от доступных TCPDF-шрифтов на вашем сайте, поэтому не копируйте случайное название из интернета без проверки.

MOD_MYSHORTLIST_PDF_FONT="dejavusans"

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

Модульная привязка, доступ и кеш

В Joomla модуль можно показывать на всех страницах, только на выбранных пунктах меню или нигде до публикации. Для My ShortList лучше начинать с варианта "только на выбранных страницах". Так вы не получите кнопку в административно странных местах: на странице контактов, форме входа, служебных страницах или карточках, где добавление в список не имеет смысла.

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

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

Размещение кнопки на страницах Joomla, каталога и сторонних компонентов

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

Joomla-статьи и категории

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

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

Каталог товаров, заявок и объектов без checkout

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

Проверьте, что в письмо или PDF попадает достаточно информации для администратора: название элемента, ссылка, количество или комментарий, если такие поля используются. JED упоминает custom fields per item в сторонних описаниях и reviews говорят о параметрах, но точный набор полей нужно проверять в вашей версии. Не обещайте пользователю поля "размер" или "количество", пока они реально не настроены.

VirtueMart и граница между wishlist и корзиной

JED указывает поддержку VirtueMart и отдельный dedicated plugin для добавления кнопки сердца на товары в category pages. Это сильный сценарий, но он требует аккуратной границы. Если у вас уже есть корзина, My ShortList должен быть списком желаний или заявочной подборкой, а не второй корзиной с непонятным статусом. Если полноценной корзины нет, шортлист может сыграть роль "собрать позиции и отправить запрос".

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

Сообщества, события и профили

Для JomSocial, EasySocial, CommunityBuilder и событийных компонентов логика отличается от каталога. Пользователь сохраняет людей, группы, страницы или события. Здесь важнее права доступа и приватность. Нельзя показывать гостю или другому пользователю данные, которые исходный компонент закрывает. Поэтому тестируйте не только добавление, но и просмотр списка под разными группами пользователей.

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

Аккуратная визуальная доработка без правки расширения

Дизайн кнопки и списка лучше адаптировать через настройки, языковые строки, шаблон сайта и переопределения, а не через редактирование файлов расширения. Если нужна небольшая CSS-правка, сначала найдите реальные классы в инспекторе браузера на вашем сайте. Ниже пример показывает принцип, а не гарантированные классы My ShortList. Используйте его только после проверки селекторов.

/* Пример безопасной CSS-логики: замените селекторы на реальные классы вашего шаблона */
.myshortlist-button {
  display: inline-flex;
  align-items: center;
  gap: .35rem;
  min-height: 2.25rem;
}

.myshortlist-button.is-active {
  font-weight: 600;
}

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

Практический пример: каталог услуг с отправкой выбранного списка администратору

Рассмотрим сценарий, который хорошо раскрывает смысл My ShortList. На Joomla-сайте есть каталог услуг или объектов. Посетитель выбирает несколько позиций, добавляет их в список, открывает подборку, оставляет контактные данные и отправляет администратору запрос. Оплаты нет, корзины нет, но администратор получает структурированную заявку вместо свободного письма.

Цель сценария

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

Подготовка

• Каталог должен иметь отдельные страницы элементов или понятные карточки в категории.
• На сайте должна работать почта Joomla, желательно через SMTP или проверенный почтовый транспорт.
• Для теста нужен скрытый пункт меню или тестовая категория.
• Кеш страницы на тестовом меню лучше временно отключить или исключить.
• Нужно заранее решить, какие поля запроса обязательны: имя, email, телефон, комментарий.

Шаги настройки

1. Установите расширение и включите только нужные части пакета.
2. Создайте или выберите список с понятным названием, например "Список заявки".
3. Разместите кнопку добавления рядом с карточками каталога или в позиции, которая видна в списке элементов.
4. Назначьте модуль только на меню тестовой категории.
5. Настройте отправку списка администратору на тестовый адрес.
6. Если доступны поля элемента, добавьте только действительно нужные: количество, комментарий, вариант услуги.
7. Откройте публичную часть сайта как гость и добавьте несколько элементов.
8. Откройте страницу списка, удалите один элемент, добавьте другой и отправьте запрос.
9. Проверьте письмо: названия элементов, ссылки, контактные данные и комментарий должны быть понятны без входа в админ-панель.

Ожидаемый результат

Посетитель видит активное состояние выбранных элементов и может открыть подборку. В списке нет дублей, элементы удаляются без неясных ошибок, письмо приходит на нужный адрес, а в письме есть достаточно данных для обработки заявки. Если включён PDF, файл должен совпадать по смыслу с HTML-списком и корректно отображать русские символы.

Нюанс, который часто мешает

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

Практичные идеи применения: не только "избранное"

У My ShortList есть ценность в разных типах проектов, если не сводить его к кнопке "сердце". Ниже - сценарии, которые естественно вытекают из подтверждённых функций: несколько списков, отправка, PDF, кнопка на разных типах элементов и широкая совместимость с компонентами. Каждый сценарий требует своей проверки, но логика внедрения остаётся общей: источник элемента -> действие пользователя -> список -> проверка результата.

Подборка материалов для обучения

На образовательном сайте пользователь может собирать уроки, главы или материалы для повторения. Здесь важно не отправлять список администратору, а дать быстро вернуться к выбранному. Хорошие подписи: "Сохранить урок", "Добавить в план", "Убрать из плана". Проверка результата - открыть список после нескольких переходов по сайту и убедиться, что порядок и названия понятны.

Каталог объектов с заявкой

Для недвижимости, оборудования, аренды, услуг или B2B-каталога список работает как заявочная корзина. Посетитель выбирает несколько элементов, администратор получает запрос и связывается с клиентом. Главное - не создавать ложного ожидания мгновенной покупки. В тексте кнопки лучше использовать "Добавить к запросу", а в подтверждении - "Список отправлен администратору".

Личная программа мероприятий

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

Сообщество и пользовательские подборки

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

Редакционная подборка для администратора

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

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

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

Проверка публичной части

1. Откройте тестовую страницу в приватном окне браузера.
2. Добавьте один элемент, затем обновите страницу.
3. Добавьте второй элемент из другой карточки или категории.
4. Откройте список и проверьте названия, ссылки, порядок и кнопки удаления.
5. Вернитесь к исходному элементу и убедитесь, что состояние кнопки не сбросилось неожиданно.

Если состояние кнопки пропадает, но сам список сохраняется, проблема может быть в шаблоне или кеше вывода. Если не сохраняется и список, проверяйте хранение, права, ошибки JavaScript и плагины интеграции.

Проверка авторизованного пользователя

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

Проверка отправки email

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

Проверка PDF

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

Проверка кеша и маршрутов

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

Типичные проблемы My ShortList и практичная диагностика

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

Кнопка не появляется на нужной странице

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

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

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

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

Элемент добавляется, но список кажется пустым

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

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

Состояние кнопки сбрасывается после обновления страницы

Симптом: список содержит элемент, но кнопка снова выглядит как неактивная. Частая причина - кеширование HTML-фрагмента кнопки или разная логика вывода в списке и карточке. На страницах с динамичным состоянием не должно быть агрессивного кеша, который одинаково обслуживает всех гостей.

Исправление: временно отключите page cache, затем проверьте кеш модуля. Если проблема исчезла, настройте исключения для страниц со списком и кнопкой. Если проблема остаётся, проверьте JavaScript-ошибки в браузере и корректность интеграции с типом элемента.

Письмо со списком не приходит

Симптом: пользователь отправляет список, но администратор не получает письмо. Возможные причины - не работает почта Joomla, адрес получателя задан неверно, письмо попадает в спам, сервер блокирует отправку или форма не проходит валидацию.

Исправление: сначала отправьте тестовое письмо из Joomla или другого проверенного компонента. Затем отправьте короткий список с одним элементом. Проверьте журналы почтового сервера, SPF/DKIM, адрес отправителя и тему письма. Если почта Joomla не работает, не ищите проблему в My ShortList.

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

Симптом: список в HTML выглядит нормально, а PDF показывает квадраты, пустые места или неправильные символы. В JED есть подтверждённый отзыв по похожей проблеме: разработчик объясняет зависимость от TCPDF-шрифта и языкового ключа MOD_MYSHORTLIST_PDF_FONT.

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

Кнопка выводится там, где не должна

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

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

Список показывает элементы, которые пользователь не должен видеть

Симптом: после смены группы или выхода из аккаунта в списке остаются элементы с закрытым доступом. Это критичный сигнал для сайтов с приватными профилями, документами или закрытыми событиями.

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

Вопросы, которые стоит решить до запуска

Можно ли использовать My ShortList без регистрации пользователей?

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

Подходит ли расширение для полноценного интернет-магазина?

Оно может быть полезным как wishlist или заявочный список, особенно рядом с VirtueMart, но не заменяет полноценный магазин с оплатой, заказами, доставкой и статусами. Если нужен checkout, используйте e-commerce-компонент, а My ShortList рассматривайте как дополнительный слой выбора.

Почему PDF показывает неправильные символы?

В JED есть подтверждённая подсказка от разработчика: PDF-экспорт использует TCPDF, и проблема нелатинских символов может быть связана со шрифтом. Проверьте языковой ключ MOD_MYSHORTLIST_PDF_FONT через Joomla language override и выберите шрифт с поддержкой нужного набора символов.

Что лучше: один список или несколько?

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

Можно ли выводить кнопку только на части страниц?

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

Что делать, если после включения кеша список работает нестабильно?

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

Нужно ли править файлы расширения для перевода и дизайна?

Нет, это плохая практика. Для текста используйте языковые переопределения Joomla. Для внешнего вида используйте настройки расширения, custom CSS шаблона или template override, если вы понимаете структуру. Правка файлов расширения потеряется при обновлении и усложнит поддержку.

Как понять, что расширение не подходит сайту?

Если пользовательский путь заканчивается обычным контактом без списка, на сайте мало элементов, нет поддерживаемого компонента или нужен полноценный checkout, My ShortList может быть лишним. В таком случае лучше использовать форму заявки, магазинный компонент или более узкое решение.

Когда My ShortList будет удачным выбором

My ShortList стоит использовать, когда на Joomla-сайте есть много элементов и пользователю нужно собрать из них личную подборку: материалы, товары, события, профили, объявления, файлы или объекты каталога. Расширение особенно интересно там, где список должен не просто храниться, а отправляться администратору, друзьям или сохраняться в PDF.

Перед запуском проверьте совместимость с вашей Joomla, конкретным компонентом, шаблоном, меню, ACL, кешем, почтой и PDF-шрифтами. Сначала настройте один безопасный сценарий, например список заявки для тестовой категории, и только после успешной проверки расширяйте применение на весь каталог.

Если после проверки вы видите понятную пользу для посетителя и администратора, можно скачать My ShortList и тестировать установочный архив на копии сайта. Не начинайте с дизайна кнопки: сначала добейтесь стабильной цепочки "добавить элемент -> открыть список -> отправить или сохранить -> проверить результат".