White Label: инструкция по настройке

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

Получите код в личном кабинете, во вкладке "Виджеты и баннеры". В разделе «White Label: полнофунциональный виджет» вам надо кликнуть по кнопке «Получить код баннера».
Cкопируйте полученный код. Он будет выглядеть примерно так:
Разместите в тексте страницы элемент, который будет содержать код виджета и присвойте этому элементу уникальный атрибут id. По умолчанию это:
<div id="kiwitaxi_widget_wrapper"></div>

В случае, когда форма поиска не умещается по ширине на вашей странице, рекомендуется прямо в элементе указать нужные вам тип и ширину, например:
<div id="kiwitaxi_widget_wrapper" style="display: block; width: 830 px;"></div>

Иначе виджет может отображаться не совсем корректно.
Параметры виджета
Укажите параметры/опции виджета в kiwitaxiWidgetOptions. Ниже представлены параметры и их значения, которые встроены в код по умолчанию:
  • language: '', — язык фрейма, "en" для английского, "ru" для русского, "es" для испанского, "de" для немецкого, "fr" для французского, "pt" для португальского и "pl" для польского.
  • theme: '', — тема оформления виджета: выберите значение от 0 до 9, или a, b, c, d.
  • display_currency: '', — валюта, в которой отображается стоимость трансфера: "EUR", "USD", "RUB".
  • payment_currency: '', — валюта, в которой производится предоплата (если отличается от display_currency): "RUB", "EUR", "USD".
  • country: '', — по умолчанию виджет предложит направления в этой стране. Название страны можно ввести на английском, русском или в виде кода IATA (данный параметр ограничивает выдачу по стране). Вот так, например, выглядит виджет с Черногорией:
  • place_from: '', — точка отправления: название города (аэропорта, ж/д вокзала, автовокзала, порта) на русском или английском, либо код IATA. Если будет указана только данная точка, то фрейм будет сразу загружать страницу со всеми маршрутами из данной точки. Это удобно, когда виджет стоит в статье или на сайте по конкретному направлению. Например, из Аэропорта Тиват параметр будет иметь значение: place_from: 'TIV'.
  • place_to: '', — точка назначения: название города (аэропорта, ж/д вокзала, автовокзала, порта) на русском или английском, либо код IATA (действие аналогично заполнению параметра place_from). Например, вы ведете блог о городе Бар. В Черногории два международных аэропорта: в Тивате и Подгорице. Настроив place_to в своем виджете на Бар, вы предложите своему пользователю выбрать маршрут из наиболее удобного для него аэропорта:
  • hide_form_extras: false, — скрыть дополнительные элементы оформления с первой страницы виджета. Значения: true или false.
  • hide_external_links: false, — скрыть внешние ссылки на сайт Кивитакси (справочные материалы и условия перевозки). Значения: true или false.
  • default_form_title: 'Найдите комфортный и недорогой трансфер!', — заголовок формы, когда точки отправления и назначения не выбраны. Указав пустую строку, можно скрыть этот заголовок.
  • max_height: '1000', — максимальная высота виджета в пикселях. Вертикальная полоса прокрутки появляется, если содержимое виджета не умещается в это ограничение.
  • partner_id: '{$refid}', — ваш партнерский идентификатор. Параметр формируется автоматически нашей платформой, не изменяйте его.
  • banner_id: '{$bannerid}', — внутренний идентификатор виджета. Используется нашей платформой, не изменяйте его.
  • target: 'kiwitaxi_widget_wrapper' — идентификатор HTML-контейнера, внутрь которого будет вставлен виджет.
Примечание
В системе управления контентом Wordpress лучше вставлять код одной строкой (без переносов), в случае если абзацы текста автоматически заключаются в парные тэги. Вам поможет сервис http://www.willpeavy.com/minifier/. С его помощью код примет такой вид:
Нименования маршрутных точек и стран могут не совпадать с их официальными названиями, поэтому для корректной работы с указанными параметрами лучше использовать код IATA. Этот код в обязательном порядке указывается для всех стран и всех аэропортов. К сожалению, у городов и других маршрутных точек кода IATA может не быть.

Вы всегда можете скачать наши актуальные списки стран и маршрутных точек по следующим ссылкам: Описание файлов:
  • формат CSV
  • записи разделены символом перевода строки "\n"
  • поля и их значения разделены символом табуляции "\t"
  • в качестве значения "NULL" (пусто) используется комбинация cимволов слэш и N: "\N"
  • первая запись в данных всегда содержит наименование столбца

Файлы в формате CSV можно без проблем импортировать в MS Excel или в OpenOffice.
Глубокие ссылки
для White Label
Можно настроить глубокую ссылку на WhiteLabel, если необходимо направить клиента сразу на бронирование трансфера по определенному маршруту или с определенным классом авто.

Полная ссылка имеет формат:
#/country/<название>/from/<название>/to/<название>/by/<класс>

Пример:
Показать все доступные трансферы по маршруту «El Prat Airport Barcelona — Barcelona»: #/country/Spain/from/BCN/to/Barcelona
Перейти на страницу бронирования трансфера класса «Эконом» по тому же маршруту «El Prat Airport Barcelona - Barcelona, Economy»:
#/country/Spain/from/BCN/to/Barcelona/by/Economy
Показать все маршруты «из точки»
#/country/<название>/from/<название>

Пример: #/country/Spain/from/BCN
Показать все маршруты «в точку»
/#/country/<наименование>/to/<наименование>

Пример:
#/country/Spain/to/Barcelona

Остались вопросы — пишите нам на почту: cpa@kiwitaxi.ru. Успехов в работе!