В разделе описаны первые шаги по работе с модулем: Установка модуля и минимальные действия для начала работы с модулем.
Для установки модуля в демо режиме выполните следующие шаги:
Зайдите по ссылке http://marketplace.1c-bitrix.ru/solutions/ammina.regions/, нажмите кнопку «Попробовать».
Укажите адрес вашего сайта (Например https://www.ammina-demo.ru/) и нажмите кнопку «Попробовать»
Откроется страница загрузки модуля на сайт. Проверьте, что напротив модуля стоит галочка и нажмите кнопку «Загрузить»
Во всплывающем окне поставьте все галочки и нажмите кнопку «Применить»
Дождитесь загрузки модуля и нажмите кнопку «Установить»
Заполните контактную форму и нажмите кнопку «Далее»
Модуль установлен. Теперь необходимо сделать минимальные настройки и действия, чтобы начать пользоваться модулем.
Для установки модуля в платном режиме выполните следующие шаги:
Зайдите по ссылке http://marketplace.1c-bitrix.ru/solutions/ammina.regions/, нажмите кнопку «Купить».
Оплатите покупку и дождитесь письмо с кодом купона для активации модуля на вашем сайте.
Откройте страницу «Marketplace-> Обновление решений -> Активация купона» и в поле «Введите купон» укажите полученный купон купленного решения. Нажмите кнопку «Активировать купон» и дождитесь сообщения об успешной активации.
Откроется страница загрузки модуля на сайт. Проверьте, что напротив модуля стоит галочка и нажмите кнопку «Загрузить»
Дождитесь загрузки модуля и нажмите кнопку «Установить»
Заполните контактную форму и нажмите кнопку «Далее»
Модуль установлен. Теперь необходимо сделать минимальные настройки и действия, чтобы начать пользоваться модулем.
Проверьте что у вас загружены местоположения модуля интернет-магазин и при необходимости обновите базу местоположений.
Для этого откройте страницу «Магазин -> Настройки -> Местоположения -> Импорт местоположений».
Рекомендуем использовать расширенную базу местоположений до уровня «Село».
Откройте страницу «Магазин -> Ammina Regions: Регионы (филиалы и представительства) -> Местоположение по IP -> Обновление базы».
Если вы хотите использовать API определения местоположения пользователя по IP с привязкой к местоположению интернет-магазина (либо для более точной работы службы геолокации при заполнении заказа) - то установите галочку «Привязать города базы IP к местоположениям при импорте».
После этого нажмите кнопку «Начать импорт» и дождитесь окончания процесса импорта базы данных SypexGeo на сайт.
Внимание! Процесс импорта является затратным повремени. Время выполнения может составить от 1 до нескольких часов в зависимости от режима, мощности и нагрузки на сервер.
Если вы хотите использовать вариант работы сайта на одном домене, то в настройках модуля установите соответствующую галочку. Подробнее...
Если вы используете мультидоменный режим, то для корректной работы сайта по отдаче файлов robots.txt и sitemap.xml для каждого домена необходимо в файл .htaccess в корне сайта добавить следующий код:
Это действие можно выполнить при помощи редактирования файла через FTP, либо через административный интерфейс сайта. Для этого зайдите на страницу Контент -> Структура сайта -> Файлы и папки, найдите файл .htaccess и откройте его в режиме редактирования PHP кода.
Добавьте в файл указанную выше конструкцию. Рекомендуем добавлять конструкцию ближе к началу файла.
На странице Магазин -> Ammina Regions: Регионы (филиалы и представительства) -> Филиалы и представительства -> Домены создайте хотя бы 1 домен (обычно в первую очередь стоит создать основной домен сайта, который будет филиалом по умолчанию). Подробнее...
Поздравляем! Модуль готов к работе. Далее Вам необходимо определиться со списком индивидуальных для сайта переменных (зависимых от домена), списком доменов (филиалов), с ценами и моделью управления ценами в пределах филиала, с компаниями и ответственными. А также прочие сопутствующие вопросы по интеграции нашего модуля с сайтом.
В разделе описаны административные страницы модуля.
В разделе описаны административные страницы управления данными доменов (филиалами и представительствами), переменными домена и расчетными типами цен для доменов.
На странице доменов Вы можете просмотреть/отфильтровать список созданных доменов для филиалов/представительств, быстро отредактировать какие-либо данные домена, удалить запись домена, перейти к добавлению нового домена:
Страница добавления/редактирования домена состоит из 3 логических блоков:
Рассмотрим каждый раздел подробно:
Список полей и их значений
Название поля | Описание |
---|---|
Название | Название домена (филиала/представительства) для отображения в публичной и административной части сайта |
Активность | Домен активен |
По умолчанию | Данный домен является доменом по умолчанию для сайта |
Домен | Доменное имя. Без указания http://. Например www.ammina-demo.ru |
Сайт | Сайт, для которого используется данный домен |
Основной город | Основной город домена (филиала/представительства) |
Ответственный сотрудник для заказов | Пользователь, который будет установлен для новых заказов, сделанных на данном домене. |
Компания (офис) для заказов | Компания, на которую будет оформлен новый заказа, сделанный на данном домене. Подробную информацию о компаниях можно узнать на сайте 1С-Битрикс. |
Создать компанию в модуле интернет-магазина | После сохранения домена модуль автоматически создаст новую компанию модуле интернет-магазине. |
Добавить компании ограничение для домена | Для созданной компании будет добавлено ограничение доступности только для текущего домена |
Создать группы для компании (сотрудники и ответственные сотрудники | Для созданной компании будет добавлены группы пользователей - группы, относящиеся к компании и группы ответственных (они же будут добавлены в настройки соответствующей компании) |
Привязать ответственного сотрудника к группам компании | Выбранный ответственный сотрудник по умолчанию будет привязан к указанным выше группам пользователей |
EMail по умолчанию | EMail отправителя по-умолчанию для исходящих писем с данного домена |
Цены | Перечень типов цен, которые доступны на данном домене |
Склады | Перечень складов, которые доступны на данном домене |
Счетчики | Код счетчиков, которые устанавливаются для данного домена |
Строки в HEAD | Дополнительные строки, помещаемые между тэгами HEAD в HTML коде страницы |
Создать настройку для генерации карты сайта домена | Создает настройку для генерации карты сайта. Настройка будет доступна в модуле поисковой оптимизации - страница Маркетинг -> Поисковая оптимизация -> Настройка sitemap.xml |
Создать файл robots.txt для домена | Создает файл robots.txt для данного домена. Файлы доступны для редактирования в каталоге /seofiles/robots/доменное_имя.txt |
Список полей и их значений
Название поля | Описание |
---|---|
Страна | Перечень стран, которые будут обслуживаться данным филиалом |
Регион | Перечень регионов, которые будут обслуживаться данным филиалом |
Город | Перечень городов, которые будут обслуживаться данным филиалом |
Удалить | Удаляет текущую запись обслуживаемой страны/региона/города |
Список полей и их значений
Название поля | Описание |
---|---|
Разделитель множественных значений переменных | Значение шаблона переменной будет слито через указанный разделитель при условии что значение множественное |
Название | Название переменной |
Шаблон | Шаблон, который заменяется на значение переменной. Используется в HTML коде страницы, в СЕО-данных элементов и разделов инфоблоков, а также в почтовых сообщениях |
Глобальная переменная | Название глобальной переменной, которой присваивается значение текущей доменной переменной |
Значение | Сгенерированное либо указываемое администратором сайта значение текущей переменной для редактируемого домена |
Переменные подразделяются на:
На данной странице Вы можете просмотреть информацию по системным и системным редактируемым переменным, а так же добавит/отредактировать собственные пользовательские переменные.
Укажите название, описание переменной, а так же код переменной. Данный код должен быть уникальным и состоять из латинских букв и цифр. Данный код будет использован в названии шаблона и как ключ глобального массива.
Расчетные цены формируются при помощи агента, включаемого и управляемого на странице настроек модуля.
Варианты расчетов цен:
Данная страница позволяет отредактировать или добавить расчетную цену.
Название поля | Описание |
---|---|
Активность | Активность расчета цены в агенте |
Сортировка | Порядок сортировки для расчетов |
Установить валюту | При расчете цена будет сконвертирована по текущему курсу и установлена выбранная валюта |
Базовая цена для расчета | Относительно какой цены будет выполняться расчет |
Расчетная цена | В какой тип цен будет записано вычисленное значение |
Тип расчета | Тип изменения цены |
Значение изменения | Значение, на которое изменится расчетная цена относительно базовой (и в соответствии с типом расчета) |
В разделе описаны административные страницы по управлению типами геозависимого контента и содержимым областей геозависимого контента.
Геозависимый контент заключается в тэги (обычно тэг DIV), у которого прописывается аттрибут ID или CLASS, указываемый у данного типа контента.
В публичной части сайта геозависимый контент выводится соответствующим компонентом. Подробнее...
На данной странице производится редактирование и добавление типа геозависимого контента. Укажите название и необходимые поля.
В публичной части сайта геозависимый контент выводится соответствующим компонентом. Подробнее...
Геозависимый контент может быть:
Кроме того дополнительно содержимое геозависимого контента может меняться:
В публичной части сайта геозависимый контент выводится соответствующим компонентом. Подробнее...
На данной странице производится редактирование и добавление геозависимого контента. Укажите название и необходимые поля.
Название поля | Описание |
---|---|
Тип контента | В каком блоке типа геозависимого контента будет показана данная запись |
Страна | Страна, для которой будет выводиться данный контент |
Регион | Регион, для которого будет выводиться данный контент |
Город | Город, для которого будет выводиться данный контент |
Домен | Домен (филиал), для которого будет выводиться данный контент |
Активность | Флаг активности данной записи |
Геозависимый контент | Контент, который будет выведен при отсутствии совпадений с расширенными условиями контента |
Название поля | Описание |
---|---|
Правило активно | Флаг активности |
Индекс сортировки | Порядок, по которому проверяются расширенные условия до первого совпадения |
Тип правила | Тип условия проверки |
Правило | Условие проверки |
Геозависимый контент | Контент, который будет показан при выполнении условий правила |
Удалить | Удаляет сохраненное правило |
Тип правила | Описание |
---|---|
Время суток (с .. по ..) | В какой период каждых суток будет выводится данный контент. Например вы хотите с 10:00 до 16:59 показывать номер 8-800... В остальное время показываем посетителям номер 8-495... |
Дни недели | В какие дни недели будет выводится данный контент. Например в выходные вы хотите показывать номер 8-495. |
Дата и время (с .. по ..) | В какой период времени выводить данный контент. Например в период новогодних праздников показывать номер 8-495. |
Условие PHP | Свободное условие PHP, которое должно вернуть TRUE для срабатывания правила. Например Ваш разработчик может сделать функцию отслеживания источника захода посетителя на сайт и выводить для разных источников разные номера телефонов. |
В разделе описаны административные страницы по управлению и обновлению базы стран, регионов, городов и блоков IP по которой происходит определение местоположения пользователя по IP адресу.
В данном разделе отображается перечень стран базы данных определения местоположения пользователя по IP
В данном разделе отображается перечень регионов базы данных определения местоположения пользователя по IP
В данном разделе отображается перечень городов базы данных определения местоположения пользователя по IP
После установки Вам необходимо выбрать город по умолчанию, проставив соответствующую галочку, а так же Вы можете выбрать избранные города (для отображения при соответствующей настройке компонента определения местоположения посетителя)
В данном разделе отображается список блоков IP адресов стран базы данных определения местоположения пользователя по IP
Данная страница предназначена для обновления локальной базы данных стран, регионов, городов и блоков IP (для определения местоположения пользователя по IP адресу)
Внимание! Процесс импорта данных может занимать от 1 до нескольких часов в зависимости от настроек, мощности и нагрузки на Ваш хостинг.
Данная страница позволяет настроить параметры модуля Ammina. Регионы (филиалы и представительства)
Страница настроек модуля расположена по адресу административной части сайта: Настройки -> Настройки продукта -> Настройки модулей -> Ammina. Регионы (филиалы и представительства)
При включении данного параметра на сайте будет использоваться схема работы на одном домене. При этом параметры, использующие данные из раздела «Филиалы и представительства» будут подставляться в шаблоны и глобальные переменные в зависимости от указанного пользователем своего города
Группа параметров управления агентом пересчета цен позволяет настроить параметры его работы. Работа агента зависит от системных настроек исполнения агентов (на хитах или в кроне) и устанавливается соответствующими параметрами:
При исполнении агента в кроне выполнение агента осуществляется в 1 шаг.
Данный агент производи расчет доступности товаров в инфоблоках, являющихся каталогами товаров, по доменам, в зависимости от остатков на складах, привязанных к доменам. Работа агента зависит от системных настроек исполнения агентов (на хитах или в кроне) и устанавливается соответствующими параметрами:
При исполнении агента в кроне выполнение агента осуществляется в 1 шаг.
Доступность товаров по складам подставляется в свойство элементов инфоблоков с символьным кодом SYS_DOMAIN_AVAILABLE. Свойство создается автоматически и может применяться для фильтрации отображения товаров каталога по доменам (филиалам/представительствам)
Для автоматического определения доступности товаров по доменам (в соответствии с остатками по складам, привязанных к доменам) и ограничения их доступности в соответствии с настройками, необходимо активировать использование встроенного в модуль собственного провайдера товаров, который является расширением стандартного класса провайдера товаров 1С-Битрикс.
В разделе описаны компоненты публичной части.
Компонент «Геозависимый контент (ammina:regions.geocontent)» предназначен для вывода в публичной части блоков геозависимого контента.
Компонент может быть добавлен через визуальный редактор
либо добавлен как PHP код в нужное место страницы:
Ключ параметра | Название параметра | Описание |
---|---|---|
CONTENT_TYPE | Тип геозависимого контента | ID типа геозависимого контента для показа в данном блоке |
SET_TAG_IDENT | Установить HTML-тэг с идентификатором или классом выбранного типа геозависимого контента | При установке данной галочки, контент будет обрамлен в HTML тэги, которым будет присвоен класс или идентификатор, указанный в настройках типа геозависимого контента. |
SET_TAG_TYPE | Какой HTML-тэг устанавливать | Какой тэг использовать для обрамления (например span или div) |
IP | IP адрес | Какой IP адрес использовать для определения местоположения посетителя (оставьте пустым для автоматического определения IP адреса) |
Компонент «Определение текущего местоположения (ammina:regions.selector)» предназначен для вывода в публичной части формы показа и выбора местоположения посетителя.
Компонент может быть добавлен через визуальный редактор
либо добавлен как PHP код в нужное место страницы:
Ключ параметра | Название параметра | Описание |
---|---|---|
CHANGE_CITY_MANUAL | Разрешить изменение посетителем | Разрешает или запрещает изменение посетителем города (автоматически определенного) |
CITY_VERIFYCATION | Подтверждать определение города | Запрашивать у посетителя подтверждение правильности определения города |
INCLUDE_JQUERY | Подключать JQuery в компоненте | Подключает библиотеку в компоненте. Если на сайте уже подключена данная библиотека (так бывает на многих современных сайтах), то необходимо снять данную галочку |
IP | IP адрес | Какой IP адрес использовать для определения местоположения посетителя (оставьте пустым для автоматического определения IP адреса) |
COUNT_SHOW_CITY | Количество выводимых городов | Какое количество городов выводится во всплывающем окне |
SEARCH_CITY_TYPE | Тип поиска местоположений |
Какое правило будет действовать при сортировке городов при поиске во всплывающем окне (когда посетитель начинает вводить название города):
|
SHOW_CITY_TYPE | Тип отображаемых местоположений по умолчанию |
Указывает, какие местоположения отображать на начальной странице всплывающего окна уточнения местоположения:
|
USE_GPS | Использовать GPS | При уточнении посетителем города пытаться определить ближайший город при помощи GPS координат, передаваемых устройством посетителя. Внимание! Координаты будут доступны при поддержке браузером пользователя данного функционала, при соответствии сайта политике безопасности браузера посетителя (обычно сайт должен работать по HTTPS протоколу), а так же если посетитель разрешит предоставление своих GPS координат сайту. |
Вместе с модулем поставляются несколько пользовательских свойств для элементов инфоблоков и для дополнительных полей (разделов инфоблоков и других модулей, которые поддерживают пользовательские типы свойств):
В разделе описана функциональность, основные сценарии и приёмы работы с модулем для решения поставленных задач.
Модуль Ammina.Regions: Регионы сайта (филиалы и представительства) предоставляет 3 модели управления ценами в пределах домена:
Данный сценарий является стандартным способом работы для сайтов. Вполне возможно, что на Вашем сайте он уже настроен и используется.
Подробную документацию по интеграции с 1С Вы можете найти здесь.
Модуль предоставляет возможность расчитывать одни типы цен относительно других.
Модуль предоставляет возможность ограничивать действие скидок в пределах одного или нескольких доменов.
В результате для выбранных доменов будет выведена скидка:
При это на других доменах эта скидка применяться не будет:
Для корректного вывода цен, доступных для домена, на сайте необходимо произвести следующие действия:
Ниже представлен код для реализации первых 2-х пунктов на примере комплексного компонента «Каталог»
Перейдите к странице, содержащей установленный компонент и откройте ее в режиме редактирования PHP кода.
Данная конструкция является безопасной на случай удаления модуля. Например код присвоения значения ключу PRICE_CODE читается следующим образом:
Модуль Ammina.Regions: Регионы сайта (филиалы и представительства) позволяет ограничить видимость контента (товары, разделы каталога, новости и тд) в пределах определенных доменов (филиалов). Обычно это необходимо для решения следующих задач:
При необходимости не показывать отдельные разделы или элементы информационных блоков на сайте на определенных доменах (филиалах) необходимо произвести (для примера) следующие действия:
Данный функционал может использоваться для ограничения видимости элементов инфоблоков только на выбранных для элемента доменах.
Например, необходимо показывать только товары, у которых есть остатки на складах, привязанных к данному домену (филиалу). В этом случае необходимо активировать агент подсчета остатков по складам и на странице, где расположен комплексный компонент каталога (до подключения компонента) указать следующий код:
Так же не забудьте указать в параметрах компонента название переменной фильтра (в данном случае - arrFilter), и параметр компонента, для корректной работы кэша:
В приложении к данной документации приведены архивы файлов шаблонов, кастомизированных компонентов, файла init.php, которые используются на нашем демонстрационном сайте https://www.ammina-demo.ru/
Данный функционал может использоваться при показе всех активных товаров с сортировкой по наличию в выбранном регионе.
Например, необходимо показывать все активные товары, но при этом товары без остатков выводить в конце списка. В этом случае необходимо активировать агент подсчета остатков по складам и на странице, где расположен комплексный компонент каталога (до подключения компонента) указать следующий код:
Так же не забудьте указать в параметрах компонента название переменной фильтра (в данном случае - arrFilter), и параметр компонента, для корректной работы кэша:
и первое свойство сортировки
Для того, чтобы вывести новости, которые относятся к данному филиалу (домену) необходимо:
Модуль Ammina.Regions: Регионы сайта (филиалы и представительства) предоставляет возможность уникализации мета-данных, заголовков страниц, названий элементов для различных доменов (филиалов), а так же создания отдельно для каждого домена файлов robots.txt и карт сайта.
Все это позволяет улучшить поисковое продвижение для доменов и привлечь дополнительный трафик на сайт без привлечения разработчиков.
На странице редактирования любого домена находится перечень системных и пользовательских переменных с их значениями для редактируемого домена. В колонке «Шаблон» находится шаблон переменной, который будучи размещенным на странице сайта, будет заменен на соответствующее значение.
Добавьте нужные Вам переменные на странице редактирования пользовательских переменных, заполните их значения для доменов (это может быть, например, название филиала в родительном падеже), и вставьте нужные шаблоны переменных в свойствах разделов.
На странице редактирования любого домена находится перечень системных и пользовательских переменных с их значениями для редактируемого домена. В колонке «Шаблон» находится шаблон переменной, который будучи размещенным на странице сайта, будет заменен на соответствующее значение.
Добавьте нужные Вам переменные на странице редактирования пользовательских переменных, заполните их значения для доменов (это может быть, например, название филиала в родительном падеже), и вставьте нужные шаблоны переменных в свойствах страниц, либо в контексте страницы.
На странице редактирования любого домена находится перечень системных и пользовательских переменных с их значениями для редактируемого домена. В колонке «Шаблон» находится шаблон переменной, который будучи размещенным на странице сайта, будет заменен на соответствующее значение.
Добавьте нужные Вам переменные на странице редактирования пользовательских переменных, заполните их значения для доменов (это может быть, например, название филиала в родительном падеже), и вставьте нужные шаблоны переменных в свойствах страниц, либо в контексте страницы.
На вкладке SEO на страница редактирования информационного блока, раздела или элемента информационного блока, в выпадающем меню кнопки показа шаблонов SEO параметров, присутствует пункт «Регионы (филиалы и представительства)», в подменю у которого находится полный список пользовательских и системных переменных для модификации SEO данных по доменах. Отредактируйте SEO шаблоны Ваших информационных блоков, разделов и элементов с использованием этих данных.
При редактировании домена Вы можете указать необходимость генерации настройки для карты сайта редактируемого домена.
Настройка карты сайта будет создана в модуле поисковой оптимизации на соответствующей странице. После этого Вы можете запустить данную настройку для генерации карты сайта домена (доменов)
При редактировании домена Вы можете указать необходимость генерации файла robots.txt редактируемого домена.
Файл robots.txt будет размещен в каталоге /seofiles/robots/ сайта, где Вы можете его отредактировать для каждого домена в отдельности.
Файл robots.txt будет размещен в каталоге /seofiles/robots/ сайта, где Вы можете его отредактировать для каждого домена в отдельности.
Для корректной работы сайта с поисковыми системами и отдаче поисковой системе сайтом файла robots.txt для соответствующего домена, Вам необходимо выполнить шаг 4 из урока "Минимальные настройки для начала работы"
Несомненно, одной из важнейших частей интернет-магазина, является функционал корзины и оформления заказа. При использовании функционала региональности для интернет-магазина, возникает потребность корректной работы данного функционала с учетом региональных настроек. К таким настройкам могут относится:
Весь этот функционал реализован в данном модуле.
При оформлении заказа модуль может подставлять местоположение посетителя в форму оформления заказа.
Для ограничения доступности отдельных служб доставки по доменам необходимо:
Для ограничения доступности отдельных платежных систем по доменам необходимо:
Для ограничения доступности компаний по доменам необходимо:
Кроме того, компания для домена может быть автоматически создана при редактировании домена (филиала) при установке соответствующей галочки на странице редактирования домена.
Ответственный сотрудник, который будет установлен для новых заказов, устанавливается на странице каждого домена в соответствующем поле. Подробнее....
После создания заказа покупателем на определенном домене, у заказа создается служебное свойство «Домен сайта (филиал, представительство)», которое содержит ссылку на домен (филиал), в котором сделан заказ.
При редактировании заказа сохраняются все цены и скидки, доступные для данного домена.
При необходимости заказ можно перенести на другой домен. Для этого:
Для облегчения понимания принципов работы с модулем, а также примерами, реализованными на демонстрационном сайте https://www.ammina-demo.ru/ вы можете скачать архив с файлами, которые содержат публичную часть сайта www.ammina-demo.ru, а так же папку local, в которой находятся кастомизированные компоненты сайта и шаблон сайта www.ammina-demo.ru