Основные возможности:
— автоопреление местоположения по ip-адресу, домену, сайту;
— доступен для всех редакций;
— автоматическая переадресация на домены/поддомены, в том числе и на сторонние домены;
— автозаполнение местоположения, в том числе и в оформлении заказа;
— адаптивное окно выбора городов с широкими настройками логики работы;
— автоматическое обновление базы IP адресов, а также — по кнопке в настройке модуля;
— попап подтверждения выбранного города, с возможностью изменить установленный город. Можно показывать только при первом заходе, а можно пока не закроет посетитель. Или вообще не показывать;
— богатые настройки кастомизации окон, под стилистику вашего сайта;
— возможность подмены данных на основе определенного города;
— отображение региона у городов с одинаковыми названиями;
— отображение «избранных» городов в нескольких местах модального окна на выбор;
— автозамена плейсхолдеров на текущее местоположение и привязанный контент;
— удобное api для отображение информации элементов иноблока в зависимости от местоположения;
— отдельный инфоблок (Местоположения -> Контент), элементы которого можно привязать к имени и id местоположения, а так же к id сайта. Что позволяет отображать любые геозависимые данные, а так же привязывать их к отдельным сайтам. Соответствующий элемент легко получить с помощью api модуля. Описание api на вкладке «Установка»;
— ядро модуля на d7;
— поддержка композита.
Данные о местоположении автоматически вставляются в поле с типом «Местоположение» в процессе оформления заказа. Так же модуль может заменить стандартный шаблон компонента выбора местоположения на свой, гораздо более удобный.
Контент с привязкой к местоположению — функции для CEO оптимизации
С помощью нашего модуля можно отображать контент привязанный к местоположению пользователя сайта.
Для каждого города в отдельности вы можете прописать необходимые данные, тайтлы, дескрипшены, телефоны, варианты доставок и другие необходимые геозависимые данные.
Решение поддерживает передачу в компонент оформления заказа выбранный город сразу при загрузке страницы — выбранный город сразу применяется для показа вариантов доставки и оплаты с ограничениями по местоположениям.
Пример: При заходе пользователя на сайт город автоматически определился, добавляем товар в корзину и переходим в оформление заказа. На странице оформления заказа будет указан определенный город и доступные для города способы доставки и оплаты.
Модуль работает на основе базы данных Sypex Geo и не делает запросы на сторонние сервисы, за счёт чего скорость определения местоположения гораздо выше. Также все запросы к базе данных местоположений кешируются, что тоже существенно увеличивает скорость работы.
Модуль работает на всех редакциях!
Для редакций «Бизнес» и «Малый бизнес» список населенных пунктов берется из Местоположений модуля «Интернет-магазин». На младших редакциях по-умолчанию выводится список городов для России и Украины из внутренней базы решения.
Решение устанавливается стандартно. После установки Вы будете перенаправлены в интерфейс настройки модуля.
Для корректной работы модуля на редакциях «Бизнес» и «Малый бизнес» необходимо, чтобы были загружены местоположения в базу модуля «Интернет-магазин» http://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=42&LESSON_ID=3074&LESSON_PATH=3912.4580.4828.3074#load
Подключение компонента улучшенного выбора местоположений
Вы можете вставить ссылку на выбор местоположения города в шапку сайта. Для этого в нужном месте шаблона добавьте вызов компонента:
<?$APPLICATION->IncludeComponent("twofingers:location","",Array());?> |
Если вы используете модифицированный компонент sale.order.ajax, для того, чтобы использовать улучшенный выбор местоположения при оформлении заказа, необходимо для компонента sale.ajax.locations прописать шаблон tf_location. |
Вызов пользовательской javascript-функции
В настройках модуля можно вписать JS функцию, которая будет выполняться при выборе города пользователем. В её названии можно использовать плейсхолдеры:
#TF_LOCATION_CITY_ID# - ID выбранного города #TF_LOCATION_CITY_NAME# - Имя выбранного города Например: handleMePlease('#TF_LOCATION_CITY_ID#', '#TF_LOCATION_CITY_NAME#'); |
Обработка javascript-события onTFLocationSetLocation
Также после выбора местоположения генерируется javascript-событие "onTFLocationSetLocation", в которое передаётся DOM-объект выбранного местоположения. Пример обработчика:
BX.addCustomEvent("onTFLocationSetLocation", function(response) { if (response.hasOwnProperty('location')) { console.log(response.location); } if (response.hasOwnProperty('content')) { console.log(response.content); } }); |
Получение выбранного местоположения на сайте
Выбранное местоположение сохраняется в сессию или куки (в зависимости от настроек) и может быть получено и использовано в любых местах сайта. Например, выведем регион и стран для текущего местоположения:
use Bitrix\Main\Composite\BufferArea; use Bitrix\Main\Loader; use TwoFingers\Location\Entity\Location; use TwoFingers\Location\Factory\LocationFactory; $frame = new BufferArea("my_dynamic_area"); // для композитного режима $frame->begin(); // для композитного режима if (Loader::includeModule('twofingers.location') && $location = LocationFactory::buildByStorage()) { echo $location->getId() . '<br>'; // ID местоположения echo $location->getCode() . '<br>'; // Код местоположения echo $location->getName() . '<br>'; // название местоположения if ($location->hasParent()) { $parents = LocationFactory::buildParentsCollection($location); /** @var Location $parent */ foreach ($parents as $parent) { // выводим только регион и страну if (in_array($parent->getType(), [Location::TYPE_REGION, Location::TYPE_COUNTRY])) { echo $parent->getId() . '<br>'; // ID родительского местоположения echo $parent->getCode() . '<br>'; // Код родительского местоположения echo $parent->getName() . '<br>'; // название родительского местоположения } } } } $frame->end(); // для композитного режима |
use Bitrix\Main\Composite\BufferArea; use Bitrix\Main\Loader; use TwoFingers\Location\Factory\LocationFactory; $frame = new BufferArea("my_dynamic_area"); // для композитного режима $frame->begin(); // для композитного режима if (Loader::includeModule('twofingers.location')) { $location = LocationFactory::buildCurrent(); if ($location) { echo $location->getName(); } } $frame->end(); // для композитного режима |
use Bitrix\Main\Composite\BufferArea; use Bitrix\Main\Loader; use TwoFingers\Location\Factory\LocationFactory; $frame = new BufferArea("my_dynamic_area"); // для композитного режима $frame->begin(); // для композитного режима if (Loader::includeModule('twofingers.location')) { $location = LocationFactory::buildByIp('5.255.255.88'); //yandex.ru if ($location) { echo $location->getName(); } } $frame->end(); // для композитного режима |
use Bitrix\Main\Composite\BufferArea; use Bitrix\Main\Loader; use TwoFingers\Location\Factory\LocationFactory; $frame = new BufferArea("my_dynamic_area"); // для композитного режима $frame->begin(); // для композитного режима if (Loader::includeModule('twofingers.location')) { $location = LocationFactory::buildDefault(); if ($location) { echo $location->getName(); } } $frame->end(); // для композитного режима |
Склонение названия местоположения по падежам (бета)
Чтобы получить склонение названия местоположения в выбранном падеже, надо передать соответствующую константу в метод getName() местоположения.
$location = \TwoFingers\Location\Factory\LocationFactory::buildByStorage(); echo $location->getName(); // Москва echo $location->getName(Location::CASE_ROD); // Москвы echo $location->getName(Location::CASE_DAT); // Москве echo $location->getName(Location::CASE_VIN); // Москву echo $location->getName(Location::CASE_TVOR); // Москвой echo $location->getName(Location::CASE_PRED); // Москве |
Получение информации из инфоблока в зависимости от местоположения
При установке модуля будет создан инфоблок "Контент" в типе "Местоположения". В этом инфоблоке Вы можете создавать элементы и привязывать их к местоположениям. Обратите внимание, что с данным инфоблоком вы можете работать так же, как и со всеми остальными: заполнять все доступные поля, добавлять и удалять свойства (кроме системных LOCATION_ID и SITE_ID). Можно обращаться к нему как к обычному инфоблоку, а можно через специальную сущность:
use Bitrix\Main\Composite\BufferArea; use Bitrix\Main\Loader; use TwoFingers\Location\Factory\ContentFactory; use TwoFingers\Location\Factory\LocationFactory; $frame = new BufferArea("my_dynamic_area"); // для композитного режима $frame->begin(); // для композитного режима if (Loader::includeModule('twofingers.location') && $location = LocationFactory::buildByStorage()) { $content = ContentFactory::buildByLocation($location); if ($content) { echo $content->getPhone() . '<br>'; // вывод значения свойства PHONE инфоблока "Местоположения" -> "Контент", магический метод echo $content->getPropertyValue('PHONE') . '<br>'; // тоже самое без магии echo $content->getPreviewText() . '<br>'; // вывод анонса, магический метод echo $content->getFieldValue('PREVIEW_TEXT') . '<br>'; // анонс без магии echo $content->getDomain(); // домен для перенаправления var_dump($content->getPriceTypes()); // получить доступные типы цен (только для старших редакций Битрикс) var_dump($content->getStores()); // получить доступные склады (только для старших редакций Битрикс) var_dump($content->getData()); // все поля и свойства привязанного элемента } } $frame->end(); // для композитного режима |
|
Настройка автоматического редиректа на домены/поддомены для выбранных местоположений
Редирект можно настроить для метоположений, добавленных в инфоблок "Контент" (тип "Местоположения"). Для этого элементу иноблока необходимо добавить домен в свойство "Домен".
Элемент инфоблока обязательно должен быть связан с местоположением через свойство "ИД местоположения" или название. |
Получение домена для перенаправления для местоположения
use Bitrix\Main\Composite\BufferArea; use Bitrix\Main\Loader; use TwoFingers\Location\Factory\LocationFactory; $frame = new BufferArea("my_dynamic_area"); // для композитного режима $frame->begin(); // для композитного режима if (Loader::includeModule('twofingers.location') && $location = LocationFactory::buildByStorage()) { echo $location->getDomain(); } $frame->end(); // для композитного режима |
Редирект между доменами/поддоментам может быть заблокирован политикой CORS на сайте. Необходимо настроить эту политику самостоятельно! |
Пример работы с переменными без использования инфоблока
Допустим, нам необходимо менять телефон в шапке сайта в зависимости от города. Привяжемся к названию города. Будем показывать один телефон для Москвы и другой телефон для всех остальных городов.
use Bitrix\Main\Composite\BufferArea; use Bitrix\Main\Loader; use TwoFingers\Location\Factory\LocationFactory; $frame = new BufferArea("my_dynamic_area"); // для композитного режима $frame->begin(); // для композитного режима if (Loader::includeModule('twofingers.location') && $location = LocationFactory::buildByStorage()) { if ($location->getName() == 'Москва') echo "+7 (495) 055-65-19"; else echo "8 800 500 40 30"; } $frame->end(); // для композитного режима |
Замена плейсхолдеров
При включенной опции "Заменять плейсхолдеры" в настройке модуля, будут заменены:
- #location_name#, #city_name# — название текущего местоположения;
- #region_name# — название текущего региона, области, края, республики и т.п.;
- #country_name# — название текущей страны;
- #content_%код%# — значение поля или свойства с кодом %код% из привязанного элемента контента. Например, #content_preview_text# будет заменено на анонс, а #content_phone# — на значение свойства PHONE.
Обработка события afterLocationDetect
Событие afterLocationDetect позволяет модифицировать местоположение после того, как оно было определено автоматически.
Пример обработчика события, размещенного в файле init.php:
use Bitrix\Main\EventManager; use TwoFingers\Location\Factory\LocationFactory; use TwoFingers\Location\Storage; EventManager::getInstance()->addEventHandler('twofingers.location', 'afterLocationDetect', function (){ $location = LocationFactory::buildByStorage(); if ($location->getName() == 'Троицк') { $newLocation = LocationFactory::buildByName('Москва'); if ($newLocation) { Storage::setLocation($newLocation); } } }); |
С нами можно свзяться по почте:
as@twofingers.ru
Для покупки товара в нашем интернет-магазине выберите понравившийся товар и добавьте его в корзину. Далее перейдите в Корзину и нажмите на «Оформить заказ» или «Быстрый заказ».
Если оформляете быстрый заказ: напишите ФИО, телефон и e-mail. Вам перезвонит менеджер и уточнит условия заказа. По результатам разговора вам придет подтверждение оформления товара на почту или через СМС. Теперь останется только ждать доставки и радоваться новой покупке.
Оформление заказа в стандартном режиме выглядит следующим образом. Заполняете полностью форму по последовательным этапам: адрес, способ доставки, оплаты, данные о себе. Советуем в комментарии к заказу написать информацию, которая поможет курьеру вас найти. Нажмите кнопку «Оформить заказ».
Оплачивайте покупки удобным способом. В интернет-магазине доступно 3 варианта оплаты:
- Наличные при самовывозе или доставке курьером. Специалист свяжется с вами в день доставки, чтобы уточнить время и заранее подготовить сдачу с любой купюры. Вы подписываете товаросопроводительные документы, вносите денежные средства, получаете товар и чек.
- Безналичный расчет при самовывозе или оформлении в интернет-магазине: карты МИР. Чтобы оплатить покупку на сайте, система перенаправит вас на сервер платежной системы. Здесь нужно ввести номер карты, срок действия и имя держателя.
- Электронные системы при онлайн-заказе: ЮMoney. Для совершения покупки система перенаправит вас на страницу платежного сервиса. Здесь необходимо заполнить форму по инструкции.
- Безналичная оплата на наш расчетный счет по выставленному счету.
Экономьте время на получении заказа. В интернет-магазине доступно 4 варианта доставки:
- Электронная поставка - все необходимые сведения о лицензии, праве пользования, кодах, ключах и др. высылаются покупателю на его e-mail.
- Курьерская доставка. Когда товар будет отправлен с нашего склада, Вам придет уведомление. В день доставки с Вами заблаговременно свяжется курьер для уточнения времени и деталей доставки. Доставка производится "до двери". Осмотрите упаковку на целостность и соответствие указанной комплектации.
- Постамат. Когда заказ поступит на точку, на Ваш телефон или e-mail придет уникальный код. Заказ нужно оплатить в терминале постамата. Срок хранения — 3 дня.
- Доставка Почтой России. Когда заказ придет в отделение, на Ваш адрес придет извещение о посылке. Перед оплатой Вы можете оценить состояние коробки: вес, целостность. Вскрывать коробку самостоятельно Вы можете только после оплаты заказа. Один заказ может содержать не больше 10 позиций и его стоимость не должна превышать 100 000 р.
Дополнительная информация.