Установка скрипта «Партнерская программа»

Введение

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

Как это работает?

Все очень просто. Для привлечения на определенный товар новых клиентов, ваш партнер должен использовать в ссылке на товар GET параметр с ID своего аккаунта на сайте. Например, есть товар /shop/156/item/partnerskaja-programma, а ID пользователя 7. Значит он должен использовать ссылку следующего вида: /shop/156/item/partnerskaja-programma?partner=7

Скрипт «Партнерская программа» позволит организовать работу с партнерами для вашего интернет-магазина.

Возможности:

  • Админка управления партнерской программой
  • Статистика партнера

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

  • Активация услуги использования PHP
  • Активация uApi

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

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


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

Для активации 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. Заполните поля, продолжайте следовать инструкциям системы. В результате вы должны получить токены. Пошаговая иллюстрация:








Ура, теперь мы получили токены. Зайдите папку «config», которая находится в архиве со скриптом, найдите в нём файл «config.php» и откройте его в любом текстовом редакторе. Затем пропишите в этом файле данные ключей, которые вы только получили.


Активация 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» в правой части окна программы. Обязательно переходим в этот каталог двойным кликом по нему.

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

Третий шаг: загрузка файлов на сайт


Перейдите в Панель управления » Файловый менеджер.
В правом верхнем углу кликните на кнопку "Создать папку", введите название папки js.
Кликните на галочку и ура, мы создали папку с нужным именем!:) Теперь абсолютно идентичным действиям создайте папку, но только с названием css, а также папку с названием images и папку language.

Теперь зайдите в папку js и загрузите в неё все файлы, которые находятся в архиве в папке «скрипты».
Далее, перейдите в папку css и загрузите в неё все файлы, которые находятся в архиве в папке «стили».
Затем перейдите в папку images и загрузите в неё все файлы, которые находятся в архиве в папке «изображения».
И наконец, перейдите в папку language и загрузите в неё все файлы, которые находятся в архиве со скриптом в папке «язык».

Четвертый шаг: Установка кода в шаблон «Страница пользователя»

Перейдите в шаблон «Страница пользователя» и между тегами <head> и </head> подключите следующие css файлы:

<link type="text/css" rel="StyleSheet" href="/css/partner.css">
<link type="text/css" rel="StyleSheet" href="/css/jquery.dataTables.css">

Затем в этом же шаблоне установите код для вывода статистики партнера:

<?if($USER_ID$ == $_USER_ID$ or $GROUP_ID$ == 4)?> 
<script src="/js/jquery.dataTables.min.js"></script>
<div id="partner"></div> 
<script>
 $.ajax({
 type: "GET",
 url: "/php/partner/index.php", 
 data: "action=account&uid=$_USER_ID$",
 cache: false,
 success: function(html){
 $("#partner").html(html);
 $('#partnerTable').DataTable({
 "language": {
 "url": "/language/dataTables.ru.lang.json"
 }
 });
 }
 });
 </script> 
 <?endif?>

Пятый шаг: Установка кода в шаблон «Страница заказа»

Перейдите в шаблон «Страница заказа» и перед тегом </body> вставьте код:

<script src="/js/jquery.cookie.js"></script>
<script>
$(document).ready(function(){
  var partner = $.cookie('partner');

  if (partner !== null) {
	 $.ajax({
		 type: "GET",
		 url: "/php/partner/index.php", 
		 data: "action=checkout&partner="+ partner+ "&hash=$REQUEST_URI$",
		 cache: false,
		 success: function(html){
			console.log('Партнерская оплата');
			$.cookie('partner', null, { path: '/' });
		 }
	 });
  }
});
</script>

Шестой шаг: Установка кода в шаблон «Страница товара»

Перейдите в шаблон «Страница товара» и перед тегом </body> вставьте код:

<script src="/js/jquery.cookie.js"></script>
<script src="/js/partner.js"></script>
 <script>
 $(document).ready(function(){
  var partner = getUrlVar('product')['partner'];
  $.cookie('partner', partner, { path: '/' });
  console.log('Cookie yes');
 });
 </script>

Седьмой шаг: Установка кода страницы управления партнеркой

Создайте новую страницу, установите необходимые права для групп, например, только для администраторов, и в режиме HTML добавьте следующий код:

<link type="text/css" rel="StyleSheet" href="/css/partner.css">
<link type="text/css" rel="StyleSheet" href="/css/jquery.dataTables.css">
<script src="/js/jquery.dataTables.min.js"></script>
<div id="partner_admin"></div> 
<script>
 $.ajax({
 type: "GET",
 url: "/php/partner/index.php", 
 data: "action=admin",
 cache: false,
 success: function(html){
 $("#partner_admin").html(html);
 $('#partnerTable, #partnerUserTable').DataTable({
 "language": {
 "url": "/language/dataTables.ru.lang.json"
 }
 });
 }
 });
 </script>

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

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