Установка «Интеграция сервиса SendPulse»

Введение

Благодарим Вас за покупку товара! Установка займет некоторое время. Пожалуйста, внимательно читайте инструкции и старайтесь поэтапно следовать всем рекомендациям.
Если вы сомневаетесь, что можете самостоятельно проивести установку, то воспользуйтесь дополнительной услугой по установке скрипта на Ваш сайт.

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

Требования к установке:

активная услуга PHP
включенное uAPI

Перед установкой, сделайте полную резервную копию сайта на случай, если вы в какой-то момент решите вернуть прежний вид сайту или отдельным его элементам.

Первый шаг: активация uAPI и PHP

Этап 1. Активация uAPI для нужного модуля

В настройках модулей "Пользовали" и "Интернет-магазин", напротив пункта «Включить uAPI для модуля» установите галочку, затем сохраните изменения.

Этап 2. Получение токен-доступов для uAPI

Перейдите на страницу http://uapi.ucoz.com/uapi_panel, авторизуйтесь под своим uID-профилем.

После авторизации, вы увидите интерфейс управления uAPI-приложений. Нам нужно создать приложение. Нажмите на «Создать» и введите все те данные, которые запросит форма.

В пункте «Название приложения» можно написать свое название (абсолютное любое);
В пункте «Consumer key» введите любой набор латинских букв, как например: hFFSJjknfsdgF87T, рекомендуем сгенерировать;
В пункте «Consumer secret» оставляем всё как есть;
В пункте «Redirect URL» введите ссылку на свой сайт (куда собираетесь подключить скрипт);
Нажмите на Сохранить.

Этап 3. Создание токенов

Перейдите на страницу http://api.ucoz.net/ru/join/reg, выберите «Полуавтоматом». Далее вам предложат ввести данные – их вы можете взять со страницы http://uapi.ucoz.com/uapi_panel. Заполните поля, продолжайте следовать инструкциям системы. В результате вы должны получить токены. Пошаговая иллюстрация:

Активация PHP

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

– перейдите к следующему шагу установки, PHP-услуга у вас активна. Если такой текст отсутствует, значит услуга PHP отключена или просрочена. Для подключения PHP необходимо оплатить премиум пакет, включающий возможность использования PHP-скриптов, либо заказать данную услугу отдельно.

Второй шаг: загрузка скриптов на FTP PHP

Этап 1. Установка пароля

Если у вас задан пароль к FTP PHP, сразу же переходите к следующему этапу.

Перейдите на главную страницу панели управления вашим сайтом, в правой верхней части нажмите на ссылку «PHP детали».

В открывшемся окне кликните на ссылку: «Пароль не установлен.

Мы попадем на страницу установки пароля на FTP PHP. Заполните поля, продолжайте следовать инструкциям системы.

Этап 2. Подключение к PHP FTP серверу

После установки пароля, скачайте FTP-клиент, рекомендуем бесплатный FTP клиент FileZilla. После установки программы, в верхней части вводим параметры подключения:

Сервер: s2000.ucoz.net
Логин (FTP login): введите свой логин, который указан в меню "PHP детали"
Пароль: пароль который вы ввели ранее в специальном разделе

После заполнения полей нажмите на кнопку «Быстрое соединение».

Этап 3. Загрузка скриптов на PHP FTP сервер

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

Теперь загрузите в этот каталог папку из архива со скриптом «sendpulse». Загрузить легко, просто перетащите эту папку в правый диалог (где отображаются каталоги и файлы хранящиеся на сервере).
Узнать статус передачи файлов вы можете в окне статуса, которое находится в нижней части программы, там отображаются файлы которые ожидают передачи и те, которые не удалось передать, в частности которые были успешно переданы.

Третий шаг: подключение uAPI и API SendPulse

После того, как токены uAPI созданы, перейдите на страницу адрес-сайта/php/sendpulse/admin.php вашего сайта, где вам будет предложена форма для ввода токенов.
Внимание! На страницу может перейти только авторизованный пользователь, ID которого проверяется у значения ucoz_getinfo('SITEUSERID') в файле admin.php.

После сохранение вам будет предложено подключить API сервиса SendPulse. Если вы еще не зарегистрированы в SendPulse, то необходимо пройти регистрацию на сайте: https://sendpulse.com/ru

Чтобы подключить API, перейдите на страницу настроек SendPulce https://login.sendpulse.com/settings/ на вкладку API.

Кликните по переключателю "Активировать REST API", скопируйте ID и Secret ключи, затем скопируйте их на странице /php/sendpulse/admin.php:

Если вы ввели правильные данные, то страница обновится и будут доступны настройки скрипта.

Четвертый шаг: настройка скрипта

Рассылка данных подписчиков осуществляется тремя способами:

через формы подписки
автоматически при оформлении заказа
вручную, отправка из панели управления

Этап 1. Создание формы подписки

Перейдите в панель управления и создайте новую почтовую формы:

Укажие название формы и адреса получателей:

После сохранения кликните на "Конструктор полей":

Оставьте в форме лишь два поля - иия и email отправителя:

Кликните на кнопку редактирования шаблона формы отправки:

Скопируйте и поместите в шаблон следующий код:

<div class="sendpulse">
<table style="width: 100%;">
<tr><td width="35%">Имя <span style="color: #f00;">*</span>:</td><td><input class="sendpulse_name" type="text" name="f2" size="30" style="width:95%;" maxlength="70"> </td></tr>
<tr><td>E-mail отправителя <span style="color: #f00;">*</span>:</td><td><input class="sendpulse_email" type="text" name="f1" size="30" style="width:95%;" maxlength="70"> </td></tr>
<tr><td colspan="2" align="center"><br /><input class="sendpulse_btn" type="submit" value="Подписаться"></td></tr>
</table>
</div>

<script>
 $('.sendpulse_btn').on('click', function() {
 var form_id = $('[name="id"]').val();
 sendpulse_name = $('.sendpulse_name').val(),
 sendpulse_email = $('.sendpulse_email').val(); 
 
 if (sendpulse_name != '' && sendpulse_email != '') {
 $.ajax({
 type: "GET",
 url: "/php/sendpulse/index.php", 
 data: "action=form&form_id=" + form_id + "&name=" + sendpulse_name + "&email=" + sendpulse_email,
 cache: false,
 success: function(){
 console.log('Данные в sendpulse успешно отправлены');
 }
 }); 
 }
 });
</script>

Этап 2. Автоматическая отправка данных

Автоматическая отправка данных позволяет отправлять данные покупателя на указанную адресную книгу:

Для начала перейдите в «Панель Управления» - «Интернет магазин» - «Управление полями заказа»:

Если на странице заказа вы используете поле email, то скопируйте его переменную:

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

Далее, для работы функции, перейдите в «Панель Управления» - «Дизайн» - «Интернет магазин» - «Страница заказа» и перед закрывающим тегом </body> разместите код:

 <script> 
$(window).load(function() {
	var email_guest = '$ORDER_FIELD_4$',
	    name_guest = '$ORDER_FIELD_5$';
 $.ajax({
 type: "GET",
 url: "/php/sendpulse/index.php", 
 data: "action=order&user_id=$ORDER_UID$&email_guest="+email_guest+"&name_guest="+name_guest, 
 cache: false,
 success: function(){
 console.log('Данные в sendpulse успешно отправлены');
 }
 }); 
}); 
</script>

В значении переменной email_guest и name_guest укажите укажите операторы полей email и имени, которые вы ранее скопировали.

Этап 3. Ручная отправка в SendPulse

Отправить данные покупателей в SendPulse можно одним кликом кноки:

Выберите статус заказов, данные покупателей которых нужно отправить и адресную книгу, после чего нажимте кнопку "Отправить данные покупателей в SendPulse".
Для всех статусов заказов можно указать отдельную адресную книгу:

Установка завершена!

Если у вас возникли вопросы по товару или проблема с установкой, то Вы можете связаться с нами по адресу электронной почты support@uscript.pro