MODX Evolution Shopkeeper

1. Установите модуль

Извлеките из архива папку paykeeper_modx_evo/tmgco в каталог <путь к MODX>/assets/snippets/ на Вашем сайте.
В панели администрирования MODX перейдите в раздел «Элементы» (рисунок 1, цифра 1), выберите подраздел «Управление элементами» (рисунок 1, цифра 2), на открывшейся странице выберите вкладку «Сниппеты» (рисунок 1, цифра 3) и нажмите кнопку «Новый сниппет» (рисунок 1, цифра 4).

Рисунок 1. Создание сниппета.

На открывшейся странице заполните поля следующим образом:

«Название сниппета»: tmgco (рисунок 2, цифра 1)

«Код сниппета (php)»:

<?php
/*******************************************
* tmgco 1.0
* Snippet for payments in MODx + Shopkeeper
*******************************************/
$output = '';
require_once "assets/snippets/tmgco/tmgco.inc.php";
return $output;
?>

<?php

/*******************************************

* tmgco 1.0

* Snippet for payments in MODx + Shopkeeper

*******************************************/

$output = '';

require_once "assets/snippets/tmgco/tmgco.inc.php";

return $output;

(рисунок 2, цифра 2).

После заполнения полей нажмите кнопку «Сохранить» (рисунок 2, цифра 3).

Рисунок 2. Заполнение полей сниппета.

2. Настройте модуль

Внесите изменения в файл <путь к MODX>/assets/snippets/tmgco/config.php следующим образом:

в переменной tmgco_payment_form_url укажите адрес платежной формы, который Вам сообщит технический специалист PayKeeper, например, http://pay.example.com/order/inline/
в переменной tmgco_secret_key укажите ключ, который Вам нужно сгенерировать в личном кабинете PayKeeper (Настройки — Получение информации о платежах — POST-оповещение — Секретное слово)

Пример файла:

<?php
//tmgco config
return array(
'tmgco_payment_form_url' => 'http://pay.example.com/order/inline/',
'tmgco_secret_key' => "my_secret_key"
);
?>

<?php

//tmgco config

return array(

'tmgco_payment_form_url' => 'http://pay.example.com/order/inline/',

'tmgco_secret_key' => "my_secret_key"

);

3. Добавьте способ оплаты

Добавьте способ оплаты tmgco в шаблон оформления заказа (обычно это чанк с именем shopOrderForm или shopOrderFormWebUser).
Пример:

...
Способ оплаты*:
<option value="При получении">При получении</option>
<option value="WebMoney">WebMoney</option>
<option value="tmgco">Банковскими картами</option>
</select>
...

...

Способ оплаты*:

<option value="При получении">При получении</option>

<option value="WebMoney">WebMoney</option>

<option value="tmgco">Банковскими картами</option>

</select>

...

4. Настройте форму оплаты

После заполнения формы заказа покупатель должен перенаправляться на страницу с формой оплаты. Для этого в вызов формы заказа (eForm) следует добавить параметр &gotoid=идентификатор_ресурса. Например:

[!eForm?&formid=`shopOrderForm`&tpl=`shopOrderForm`&report=`shopOrderReport`&vericode=`1`&ccsender=`1`&gotoid=`14`&subject=`Новый заказ`&eFormOnBeforeMailSent=`populateOrderData`&eFormOnMailSent=`sendOrderToManager`!]

1	[!eForm?&formid=`shopOrderForm`&tpl=`shopOrderForm`&report=`shopOrderReport`&vericode=`1`&ccsender=`1`&gotoid=`14`&subject=`Новый заказ`&eFormOnBeforeMailSent=`populateOrderData`&eFormOnMailSent=`sendOrderToManager`!]

Вызов формы заказа (eForm) обычно происходит из ресурса корзины (orderFormPage).

4.1. Если параметр gotoid уже добавлен в вызов формы заказа

Отредактируйте ресурс, чей идентификатор указан в параметре gotoid, добавив в поле «Содержимое ресурса» вызов сниппета:

[!tmgco!]

[!tmgco!]

Например, в вызове формы заказа написано gotoid=14
Нажимаем на ресурс с идентификатором 14 в дереве ресурсов (рисунок 3, цифра 1), нажимаем кнопку «Редактировать» (рисунок 3, цифра 2).

Рисунок 3. Открытие ресурса.

Добавляем в поле «Содержимое ресурса» текст:

[!tmgco!]

[!tmgco!]

(рисунок 4, цифра 1).

Нажимаем кнопку «Сохранить» (рисунок 4, цифра 2).

Рисунок 4. Редактирование ресурса.

4.2. Если параметр gotoid отсутствует в вызове формы заказа

В панели администрирования MODX нажмите на кнопку «Новый ресурс» в дереве ресурсов (рисунок 5, цифра 1).

Рисунок 5. Создание нового ресурса.
На открывшейся странице заполните поле «Заголовок», например, «После заказа» (рисунок 6, цифра 1), а в поле «Содержимое ресурса» вставьте текст:

[!tmgco!]

1

[!tmgco!]

(рисунок 6, цифра 2).
Перейдите на вкладку «Настройка страницы» (рисунок 6, цифра 3).

Рисунок 6. Заполнение полей на вкладке «Общие» ресурса.

На открывшейся вкладке «Настройка страницы» произведите следующие настройки:
- поле «Публиковать»: флаг установлен (рисунок 7, цифра 1)
- поле «Кэшируемый»: флаг снят (рисунок 7, цифра 2)
Нажмите кнопку «Сохранить» (рисунок 7, цифра 3).

Рисунок 7. Настройка ресурса.
Запомните идентификатор созданного ресурса – цифра в круглых скобках после названия ресурса в дереве ресурсов. Например, идентификатор ресурса «Корзина» (рисунок 7, цифра 4) – 8.
После создания ресурса добавьте в строку вызова формы заказа (eForm) параметр &gotoid=идентификатор, где идентификатор – идентификатор созданного ресурса.

5. Добавьте страницы с результатами обработки платежа

После проведения платежа покупатель перенаправляется в интернет-магазин либо на одну страницу с текстом об успешном платеже, либо на другую страницу с текстом об ошибке в платеже.

5.1. Если страницы уже созданы

Если у Вас уже созданы эти 2 страницы, то переходите к следующему разделу – 6.

5.2. Если страницы еще не созданы

Страница с текстом об успешном платеже
Повторите пункты 1-5 из раздела 4.2 с некоторыми изменениями:
4.2.2: Заполните поле «Заголовок», например, «Успешный платеж». В поле «Содержимое ресурса» впишите текст, который будет отображаться при успешном платеже, например, «Заказ оплачен, спасибо за покупку!»
Страница с текстом об ошибке в платеже
Повторите пункты 1-5 из раздела 4.2 с некоторыми изменениями:
4.2.2: Заполните поле «Заголовок», например, «Ошибка в платеже». В поле «Содержимое ресурса» впишите текст, который будет отображаться при ошибке в платеже, например, «Произошла ошибка при обработке платежа. Свяжитесь с менеджером, пожалуйста.»

6. Заполните анкету «Настройка PayKeeper»

Заполните следующие параметры в анкете «Настройка PayKeeper»:

Раздел 3, параметр 3.2.1 «post»: <флаг установлен>
Раздел 3, параметр 3.2.2 «url «: http://Ваш_домен/assets/snippets/tmgco/notify.php
Раздел 6, параметр 6.1 «backurl.success»:
http://Ваш_домен/index.php?id=идентификатор_ресурса_с_успешным_платежом
Раздел 6, параметр 6.2 «error.backlink»:
http://Ваш_домен/index.php?id=идентификатор_ресурса_с_ошибкой_в_платеже