| Joomla | 2.5 - 3.x |
|---|---|
| Package | module & plugin |
| Version | 1.2.8 |
Уже объявлено о прекращении поддержки Joomla 2.5, поэтому в ближайшее время данное расширение будет обновляться только с учетом подержки joomla 3x.
My City Selector - это расширение для CMS Joomla, позволяющее администратору сайта отображать разную информацию для разных городов.
Расширение совместимо с модулем мультиязычности. Но при этом может понадобиться создать для каждого языка свою копию модуля mod_mycityselector. На данный момент, есть только один серьезный недостаток - это невозможность сопоставить между собой один и тот же город с разными названиями. Поэтому при переключении языка, скорее всего потребуется повторно выбрать город. Данный недочет обязательно будет исправлен в следующей версии.
Примечание: все изображения приводимые здесь основаны на версии Joomla 3.3.6
Принцип работы относительно прост. Расширение оперирует специальными тегами, внутри которых должна содержаться информация для соответствующего города.
Телефон: [city Москва]+7 499 888-77-66[/city][city Владивосток]+7 423 555-66-77[/city]
На одной странице таких тегов может быть много, но на сайте отображается информация только из тех тегов, которые соответствуют текущему выбранному городу. Действие тегов не ограничивается только контентом материалов, вы можете использовать их даже в файлах шаблона. Так например, можно для разных городов отображать разные позиции модулей.
<div class="some-block">
[city Москва]<jdoc:include type="modules" name="position-msk" style="none" />[/city]
[city *]<jdoc:include type="modules" name="position-all" style="none" />[/city]
</div>Таким образом "position-msk" со всеми своими модулями будет отображаться только для Москвы, а вторая позиция - для всех остальных городов.
Вот полный список возможных вариантов использования тега:
- Один город
[city Омск] - Несколько городов
[city Москва,Санкт-Петербург] - Все города
[city *]- точнее любые кроме тех, что указаны явно в других тегах текущей страницы - Любой город кроме указанного (отрицание)
[city !Новосибирск] - Любой город кроме указанных
[city !Омск,Владивосток]
Вот в общем-то и вся хитрость.
Примечание: используя эти теги в редакторе материалов, старайтесь не делать отступов и переносов между закрывающим тегом одного города и открывающим другого, поскольку могут появляться нежелательные отступы или переносы срок (редактор автоматически корректирует html структуру текста и может вставлять между тегами лишние теги).
На данный момент установка возможна только по ссылке или из архива v1.2.8-beta.2.
В ближайшем будущем планируется разместить на JED.
Расширение состоит из плагина и модуля. При корректной установке плагин должен активироваться автоматически. Так что сразу переходим к настройкам модуля. Важные параметры модуля находятся не только на основной вкладке настроек, но и на вкладке дополнительных параметров.
Рассмотрим все параметры по порядку.
Необходим для корректного формирования адресов поддоменов. Автоматическое определение основного домена (в случае, когда вы уже на поддомене) работает только при условии, что у сайта домен второго уровня (site.ru). Если же сайт находится на одном из многочисленных доменов третьего уровня (site.com.ru), то возникает проблема. Вообще, этот параметр устанавливается автоматически при инсталляции расширения (в качестве значения берется имя текущего хоста).
Если данный параметр включен, то при первом входе пользователя на сайт, модуль стразу предложит ему выбрать город из списка. Примечание: если параметр включен, то не будет работать yandex-geolocation, так как происходит конфликт между автоматическим определением города и выбором пользователя.
Функция автоматического определения города. Если автоматически определенный город есть в спике (настройках модуля), то происходит автоматическое переключение контента или редирект на соответствующий поддомен. Доступны следующие варианты:
- SypexGeo - определение города по IP с помощью соответствующего сервиса
- Yandex Geo - определение города посредством связки механизма геолокации браузера и определения города по координатам через сервис Yandex geocode-maps
- связка SypexGeo + YandexGeo, когда первый используется как более быстрого определения, а второй, вроде контрольного выстрела
Примечание: использование YandexGeo вероятнее всего выдаст пользователю запрос на разрешение использовать функционал геолокации, имейте это в виду.
По умолчанию данный функционал отключен.
Представляет из себя таблицу состоящую из четырех столбцов:
- город по умолчанию (какой город будет отображен, если его не удастся определить автоматически)
- название города или группы городов
- название поддомена или URL-префикс для страниц (например "/moscow/" или "/spb/")
- операции "удалить строку" и "переместить строку"
Рассмотрим на примерах, для начала на простом списке без групп и адресов.
При такой конфигурации, контент для всех городов существует в рамках одного домена. То есть при индексации вашего сайта, скорее всего роботы получат контент для города, установленного по умолчанию. Для пользователя, переключение контента будет происходить "на лету", без каких либо перезагрузок страниц.
Теперь, если назначить каждому городу свою страницу на сайте, то при выборе города будет происходить redirect на соответствущую страницу.
Обратите внимание, что основному городу страница не задается, поскольку не может у сайта отсутствовать главная страница (корень сайта). Таким образом главная страница сайта - это главная страница города, указанного по умолчанию. Для лучшего понимания, изображу как должна выглядеть структура такого сайта.
/ (Главная страница для Москвы)
/about-company (О компании)
/services (Услуги)
/contact (Контакты)
/products (Продукция)
/spb/ (Главная страница для Санкт-Петербурга)
/spb/about-company
/spb/services
/spb/contact
/spb/products
/nsk/ (Главная страница для Новосибирска)
/nsk/about-company
/nsk/services
/nsk/contact
/nsk/products
и т.д.
Глядя на такую структуру можно подумать, что вам придется создавать дубликаты каждой страницы из главного города, но это не так. На самом деле достаточно создать страницы только для главного города, а страницы для других городов - это все те же страницы главного города, но с другими url. Дело в том, что структура сайта задается через компонент "Меню", следовательно достаточно для каждого города сделать свое меню, но назначить для адресов страниц свои префиксы (/about-company -> /spb/about-company). То есть в корне города Санкт-Петербург (/spb/) должно отображаться меню, копирующее меню главного города, но с префиксами у адресов. Конечно такой подход не избавит от необходимости вручную создавать копии записей, но вместо копирования материалов, нужно будет создавать копии пунктов меню. Но в то же время удобно управлять контентом, так как информация для всех городов находится в одном материале для каждой страницы.
Самым же правильным и простым способом является привязка каждому городу своего поддомена.
Фактически сайт все равно продолжает существовать в единственном числе, но разные поддомены позволяют пользователям и поисковикам отчетливо осознавать, что они находятся на сайте (поддомене) конкретного города. Принип работы остается таким же как и в первых двух вариантах: один материал - несколько разных блоков [city].
Примечание: Вы должны самостоятельно настроить свой домен так, чтобы все его поддомены работали с основного домена.
Текст отображаемый в заголовке диалогового окна выбоар города. Не знаю зачем, пусть будет :)
Внешний вид диалогового окна выбора города. В "коробке" всего два, не особо выдающихся шаблона (простите, я не дизайнер).
Как и для любого модуля в Joomla можно создать переопределение шаблона или сделать свой (подробнее см. раздел "Кастомизация").
Данное поле позволяет вписывать произвольный javascript код, который будет выпольняться при переключении городов. Вообще эта "фича" нужна только для первого способа (когда города переключаются на лету, нет ни страниц городов, ни поддоменов). Дело в том, что когда происходит переключение города "на лету", многие javascript плагины не делают своей повторной инициализации и ранее скрытые динамические элементы оказываются нерабочими. Например, разные слайдеры для разных городов. При переключении города, отображаемый слайдер оказывается не рабочим (потому что при загрузке страницы он не существовал). Следовательно необходимо в данном поле прописать код инициализации слайдера, чтобы после переключения он заработал.
Позволяет добавить текст перед названием текущего города. Пример:
Изменить внешний вид шаблона модуля можно двумя способами:
- переопределение шаблона модуля из админки
- создание своего шаблона
Первый способ достаточно прост, необходимо зайти в менеджер шаблонов сайта, кликнуть по названию своего текущего шаблона перейти во вкладку "Переопределение", найти в списке модуль "mod_mycityselector" и кликнуть по нему. После чего в папке шаблона сайта появится копия шаблона модуля. Его можно будет менять как вам вздумается.
Второй способ в общем-то делается также как и первый, но после дублирования также необходимо переименовать файлы шаблона (придумать свое имя для шаблона) и на основе данной копии сделать свой шаблон.
Примечание: javascript файл подключаемый в шаблоне имеет очень важное значение, старайтесь его не менять, если в этом нет реальной необходимости.
Если вам кажется, что некоторые моменты можно бы было описать лучше или где-то закралась неточность, то можете написать мне об этом на почту или сделать pull request.