Плагин для Wordpress от Travelpayouts

О плагине

С помощью плагина для Wordpress от Travelpayouts вы можете разместить в своем блоге:

  • информативные виджеты (карта отелей, карту перелетов, список популярных направлений и другие);
  • таблицы с полезной информацией о перелетах и отелях (самые выгодные направления из конкретного города, календарь низких цен, популярные направления авиакомпаний и многие другие);
  • форму для поиска билетов и отелей.

При разработке плагина мы постарались максимально упростить процесс создания и размещения виджетов, таблиц и форм. В этой статье дается пошаговая инструкция, как настроить плагин от Travelpayouts.

Технические требования

Для корректной работы плагина требуется PHP версии 5.3 или выше. Кроме того, рекомендуется использовать самую актуальную версию Wordpress. Это важно не только для корректной работы плагина, но и с точки зрения безопасности и скорости работы вашего сайта.

Кстати, Wordpress настоятельно рекомендует использовать последнюю версию РHP и MySQL.

Совет № 1: чтобы узнать версию PHP есть два способа — установить специальный плагин или написать письмо в службу поддержки вашего хостинга.

Рассмотрим оба способа. Установите и активируйте плагин Display PHP Version, после установки версия PHP отобразится на первой странице админки блога:

Второй вариант — написать примерно такое письмо в саппорт хостинга:

«Здравствуйте. Подскажите, пожалуйста, какая версия PHP установлена на хостинге для сайта www. НазваниеВашегоСайта.хх».

Если выяснится, что версия PHP ниже 5.3 необходимо написать письмо в службу поддержки хостинга примерно такого содержания:

«Здравствуйте. Обновите, пожалуйста, PHP до версии 5.4 на хостинге для сайта www. НазваниеВашегоСайта.хх».

Совет № 2: В письме можно также попросить выставить ограничение памяти (memory_limit) равное 128 Мб или 256 Мб. Хостинг провайдер может и отказать, но если установит, то это пойдет на пользу сайту (при условии, конечно, что до этого ограничение было меньше).

Установка плагина

Устанавливается плагин стандартным образом:

  1. Переходите в раздел «Плагины» панели управления Wordpress.
  2. Нажимаете кнопку «Установить плагин». Выбираете файл с плагином или находите его в списке по ключевому слову «Travelpayouts».
  3. После установки активируйте плагин.

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

Чтобы вы не забыли, плагин будет напоминать об этом специальным сообщением:


Основные настройки плагина

Чтобы произвести настройку плагина, нажмите кнопку «Настроить плагин для начала работы». Откроется страница с формой для ввода партнерского токена и маркера.

Если вы зарегистрированы в партнерской программе Travelpayouts, то следуйте инструкции ниже. Если же у вас еще нет аккаунта в партнерской программе, нажмите кнопку «У меня нет аккаунта Тravelpayouts». На открывшейся странице будет краткая инструкция по регистрации.

После регистрации вернитесь в настройки плагина и заполните поля «Ваш API токен» и «Ваш партнерский маркер».

Значения токена и маркера находятся в личном кабинете в разделе «Разработчикам»:

Поле Дополнительный маркер является необязательным. По умолчанию в поле прописан дополнительный маркер «wpplugin». Он позволит вам понять, какие бронирования были совершены с помощью плагина. Подробнее о доп. маркере читайте в другой статье.

Поле «White Lable» не обязательно к заполнению. Если вы хотите, чтобы при клике на ссылку пользователь видел результат на поддомене вашего сайта, а не переходил к нам, вам нужно настроить White Lable и вписать его адрес в это поле. Адрес указывается в полном формате, например «http://whitelabel.travelpayouts.com».

Дополнительные настройки плагина

После того как вы указали партнерский токен и маркер в основных настройках, можно приступать к работе с плагином. Для дополнительных настроек плагина, перейдите в раздел «Настройки», вкладка «Настройки».

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

  • Сообщение об ошибке — введите в данное поле текст сообщения, которое будет отображаться, если плагин не сможет получить ответ от нашего сервера.
  • После перехода по ссылке
    • Отображать заполненные формы — пользователь перейдет на страницу нашего сайта с заполненной формой поиска. Ему нужно будет нажать кнопку «Найти», чтобы увидеть результат.
    • Отображать результаты поиска — при нажатии сразу запускается поиск и пользователь видит страницу с результатом поиска. Т. е. видит список авиабилетов или отелей, соответствующих информации в виджете/таблице.
  • Единица измерения расстояния — доступны варианты:
    • КМ — километры;
    • М — мили (используйте, если работаете с американской аудиторией).
  • Размер лого Авиакомпании (px) — поддерживаются размеры от. до…
  • Редирект — переход происходит через 301 редирект.
  • Переход по ссылке в новом окне — ссылка открывается в новом окне.
  • Атрибут для ссылок nofollow — все ссылки снабжаются данным атрибутом.
  • Кэшировать через — время хранения данных в базе данных. Кэшированные данные загружаются быстрее.
    • День;
    • Час.
  • Скрипты — место размещения скрипта плагина в коде.
    • Header — шапка сайта. Скрипт грузится в первую очередь, до контента и всего содержимого сайта.
    • Footer — скрипт грузится после всего содержимого сайта. Контент отображается в первую очередь, но виджеты и таблицы могут загружаться с задержкой.
  • Формат даты — поддерживаются стандартные форматы Wordpress.
  • Импорт настроек — загрузка ранее экспортированных настроек.
  • Экспорт — выгрузка текущих настроек в файл.

Локализация

Чтобы изменить язык виджетов и таблиц, перейдите в разделе «Настройки» на вкладку «Локализация».

  • Язык таблиц и виджетов — поддерживается русский и английский языки таблиц и виджетов.
  • Валюта — валюта, в которой отображается стоимость перелетов и отелей (рубли, доллары, евро).
  • Откуда, Куда — падеж, в котором указывается направление откуда и куда перелета (в английской версии скрывается).
  • Названия ячеек — вы можете изменить названия ячеек в таблицах.

Настройки таблиц

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

Во вкладке «Содержание таблиц» настраивается содержимое каждой таблицы по отдельности. На вкладке «Внешний вид таблиц» устанавливается общее оформление для всех таблиц.

Содержимое таблиц

Чтобы настроить конкретную таблицу, нажмите на её название в списке. Откроется блок с полями.



Настройки таблиц включают в себя следующие поля:

  • Дополнительный маркер — укажите маркер, с помощью которого можно будет отследить клики по ссылкам в данной таблице. По умолчанию это поле уже заполнено и вы точно сможете определить, какая таблица генерирует вам заказы.
  • Заголовок — заголовок таблицы. Чтобы в заголовок автоматически подставлялось название авиакомпании, впишите в поле переменную airline. Используйте переменные origin, destination для автоматической подстановки города вылета и назначения. При размещении таблицы в статье вы сможете изменить заголовок.
  • Количество строк на странице — установите сколько строк с данными будет отображаться в таблице. Если фактически данных будет больше, под таблицей отобразится переключатель между страницами (необходимо поставить галку в напротив Пейджинация).
  • Колонки таблицы — вы можете добавить, удалить или изменить порядок колонок в таблице. Обратите внимание, что сортировка таблицы происходит по первой колонке.
  • Куда — укажите пункт назначения.
  • Лимит — укажите максимальное количество строк данных для отображения.
  • Откуда — укажите пункт отправления.
  • Пейджинация — добавить переключатели на продолжение списка данных под таблицей.
  • Пересадки — выбор допустимого количества пересадок (все — отображаются все варианты).
  • Тег заголовка — укажите html тег заголовка таблицы. Это может быть стандартный тег заголовка h1, h2, h3, h4 или тег div.
  • Текст кнопки — введите текст, который будет написан на кнопке в таблице. Чтобы на кнопке была указана стоимость, используйте переменную price.

Внешний вид таблиц

Чтобы настроить оформление таблиц, перейдите на вкладку «Внешний вид таблиц».

В настройках оформления вы можете изменить:

  • стили заголовка;
  • шрифт в таблицах;
  • границы таблиц;
  • фон таблицы;
  • фон шапки таблицы;
  • шрифт в шапке таблицы;
  • отображать данные гиперссылками — при нажатии на ячейку данных будет открываться страница поиска;
  • разрешить горизонтальный скролл — если данные не помещаются по ширине, то будет добавлен горизонтальный скролл и текст в таблице не будет сжиматься.

Настройки виджетов

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



Настройки виджетов содержат:

  • Ссылки помощи:
    • Пример виджета — наведите, чтобы посмотреть превью виджета;
    • Справка Travelpayouts — ссылка на статью о данном виджете в нашем хранилище знаний.
  • В одну сторону — отметьте, чтобы отображались перелеты только в одну сторону.
  • Возможность перетаскивать — разрешить или запретить перемещать карту с помощью мыши.
  • Выбрать цвет — настройки цветов для карты.
  • Дополнительный маркер — используйте дополнительный маркер для отслеживания кликов по виджетам.
  • Куда — укажите в этом поле город назначения.
  • Количество виджетов при вставке в запись — количество виджетов на странице.
  • Отключить зуммирование — включает ограничение на максимальное приближение карты.
  • Откуда — укажите город отправления.
  • Период — укажите период отпуска.
  • Размер (px) — размер виджета.
  • Размер маркера — укажите размер маркера на карте в пикселях.
  • Резиновая — для некоторых виджетов можно задать резиновую ширину, в этом случае виджет будет автоматически подстраиваться под размер страницы.
  • Скрыть логотип — установите, чтобы убрать с виджета логотип Авиасейлз.
  • Только прямые рейсы — установите, чтобы отображались только рейсы без пересадок.
  • Увеличение при прокрутке — изменение масштаба карты с помощью колесика мыши.
  • Ширина (px) — ширина виджета.

Поисковые формы

С помощью плагина вы можете добавить форму поиска билетов и отелей на страницы своего блога.

Видео добавления формы:

 

Чтобы создать форму поиска, перейдите в раздел «Поисковые формы» личного кабинета. Подробнее о настройки формы читайте здесь.

После того как форма настроена, снимите галки «Компактный код для вставки» и «Iframe код для вставки» и скопируйте её код. После этого перейдите в раздел плагина «Поисковые формы».



Нажмите кнопку «Добавить шорткод». Откроется страница с полями для создания шорткода поисковой формы.

Введите название шорткода и вставьте скопированный код поисковой формы в поле «Код формы TravelPayouts».

Обратите внимание! Вы можете задать город вылета и назначения в любом из трех мест:

  1. При добавлении шорткода на странице сайта.
  2. При создании шорткода в разделе настроек плагина «Поисковые формы».
  3. При создании поисковой формы в личном кабинете.

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

Размещение виджетов, таблиц и поисковых форм

Чтобы разместить на странице или в записи виджет, таблицу или поисковую форму, воспользуйтесь меню над полем ввода текста:


При добавлении таблицы или виджета откроется модальное окно с выбором.

После того как таблица или виджет выбраны в этом же окне можно указать их настройки:


Чтобы добавить шорткод формы поиска, нажмите кнопку «Вставить поисковую форму». Откроется модальное с полями для выбора города отправления и назначения.

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

После того как выбор сделан и поля заполнены, нажмите Создать. На странице отобразится шорткод таблицы, виджета или формы поиска.

Обратите внимание! Вы можете изменить город отправления и назначения непосредственно в шорт-коде. Для этого используйте IATA-код аэропорта или города.

После публикации страницы на ней появится соответствующий элемент.

Шорткоды

Список всех шорткодов, используемых в плагине:

  • [tp_price_calendar_month_shortcodes origin=MOW destination=SIP title=""] — таблица цены на месяц по направлению, в одну сторону;
  • [tp_price_calendar_week_shortcodes origin=MOW destination=SIP title=""] — таблица билеты по направлению на ближайшие дни;
  • [tp_cheapest_flights_shortcodes origin=MOW destination=SIP title=""] — таблица самые дешевые билеты по направлению;
  • [tp_cheapest_ticket_each_day_month_shortcodes origin=MOW destination=SIP title=""] — таблица самые дешевые билеты по направлению в этом месяце;
  • [tp_cheapest_tickets_each_month_shortcodes origin=MOW destination=SIP title=""] — таблица цены на билеты по месяцам;
  • [tp_direct_flights_route_shortcodes origin=MOW destination=SIP title=""] — таблица билеты без пересадок по направлению;
  • [tp_direct_flights_shortcodes origin=MOW title="" limit=10] — таблица билеты без пересадок ИЗ конкретного города;
  • [tp_popular_destinations_airlines_shortcodes airline=SU title="" limit=] — таблица популярные направления авиакомпании;
  • [tp_our_site_search_shortcodes title="" limit=100] — таблица на нашем сайте искали;
  • [tp_from_our_city_fly_shortcodes origin=MOW title="" limit=100] — таблица дешевые перелеты из города;
  • [tp_in_our_city_fly_shortcodes destination=AMS title="" limit=100] — таблица дешевые перелеты в город;
  • [tp_map_widget origin=MOW width=500 height=500] — виджет карты перелетов;
  • [tp_hotelmap_widget coordinates="55.752041, 37.617508" width=500 height=500] — виджет "Отельная карта";
  • [tp_calendar_widget origin=MOW destination=LED responsive=true] — виджет календаря;
  • [tp_hotel_widget hotel_id=3056 отелей responsive=true] — виджет отеля;
  • [tp_popular_routes_widget destination=MOW responsive=true] — виджет популярных направлений.
  • [tp_search_shortcodes id=1 origin="MOW" destination="LED"] — поисковая форма.

В шорткодах используются следующие параметры:

  • origin — IATA код пункта отправления;
  • destination — IATA код пункта назначения;
  • title — заголовок таблицы;
  • limit — ограничение на количество отображаемых строк в таблице;
  • width — ширина виджета;
  • height — высота виджета;
  • coordinates — координаты отеля;
  • responsive — сделать виджет респонсивным (автоматически подстраивается под разрешение экрана).

Обратите внимание! Параметры шорткодов индивидуальны. Они могут работать в одном шорткоде и не работать в другом. Смотрите внимательно содержимое шорткода в списке выше.

Отчетность

Вся отчетность по работе с партнерской программой собрана в вашем личном кабинете. Для удобства мы продублировали данную информацию в разделе «Статистика».

В этом разделе собрана информация о доходах и выплаченных вознаграждениях.



Узнать подробнее об отчетах вы можете в статье «Статистика и отчеты».

 

Была ли эта статья полезной?

Еще есть вопросы? Отправить запрос