Пример создания нового способа оплаты — различия между версиями

Материал из Umicms
Перейти к:навигация, поиск
 
(не показано 5 промежуточных версий 3 участников)
Строка 1: Строка 1:
'''Актуально для версии 2.9'''
+
'''Актуально для версии 19.'''
<br/>
+
 
 +
'''Задача:''' Добавить свой способ оплаты. Ниже мы рассмотрим способ реализации данной задачи в общих чертах, создав простейший кастомный способ оплаты на примере интернет-магазина "Адаптивный" (demomarket).
 +
 
 +
'''Решение:'''<br>
 +
1) Открываем модуль "Шаблоны данных", находим тип данных "Способ оплаты" и добавляем ему дочерний элемент. Назовем его "Тестовый перевод".<br>
 +
2) Добавляем в группу [payment_props] два поля:<br>
 +
"Как платить?" [kak_platit] HTML-текст видимое<br>
 +
"Номер телефона" [phone] строка видимое
 +
 
 +
[[Файл:Способ оплаты 1.png | 1500px]]
 +
 
 +
3) Запоминаем id из адресной строки (/admin/data/type_edit/187/), где вместо 187 у Вас будет свой id.<br>
 +
4) В типах данных находим справочник "Типы способов оплаты". Нажимаем "Посмотреть" и переходим в режим его редактирования.
 +
 
 +
[[Файл:Способ оплаты 2.png | 1500px]]
 +
 
 +
5) Добавляем новое наименование справочника. Название — такое же, "Тестовый перевод". В поле "Тип данных (id)" вставляем ранее запомненный id, в нашем случае это 187. В поле "Тип данных (GUID)" напишем "emarket-payment-187". В поле "Идентификатор типа оплаты" пишем название класса, который мы создадим и будем использовать для работы с данным типом оплаты, в нашем случае это будет Test. Будьте внимательны, данное название ригистрозависимо.
 +
 
 +
[[Файл:Способ оплаты 3.png | 1500px]]
 +
 
 +
6) Заходим в базу данных нашего сайта и с помощью запроса <source lang="sql">UPDATE cms3_object_types SET guid='emarket-payment-187' WHERE id='187'</source> добавляем значение 'guid' для нашего типа данных. В своем запросе Вам нужно изменить guid='emarket-payment-187' на emarket-payment-Ваш-id.<br>
 +
7) В папке /classes/components/emarket/classes/payment/systems/ создаем php файл с названием, аналогичным нашему классу, указанному на 5 шаге, Test.php. Скопируем в него содержимое файла courier.php, расположенного в той же папке.<br>
 +
8) Редактируем код в файле Test.php. Название класса заменяем на "Класс"+"Payment", т.е. в нашем случае название класса будет TestPayment. В классе вносим изменения: получаем массив с данными о заказе и заменяем им редирект.<br>
 +
<source lang="php">
 +
<?php
 +
 
 +
use UmiCms\Service;
 +
 
 +
/** Способ оплаты "Тестовый" */
 +
class TestPayment extends payment {
 +
 
 +
public function process($template = null) {
 +
$order = $this->order;
 +
$order->order();
 +
$controller = cmsController::getInstance();
 +
            $module = $controller->getModule('emarket');
 +
           
 +
            $line['attribute:orderId'] = $order->getId();
 +
$line['attribute:number'] = $order->getValue('number');
 +
$line['attribute:total_price'] = $order->getValue('total_price');
 +
$line['attribute:phone'] = $this->object->phone;
 +
$line['node:value'] = $this->object->kak_platit;
 +
            $lines[] = $line;
 +
            $udata['nodes:item'] = $lines;
 +
//Здесь вернем массив с данными заказа, вместо редиректа
 +
if ($module) {
 +
return $udata;
 +
}
 +
 
 +
return null;
 +
}
 +
 
 +
/** @inheritdoc */
 +
public function poll() {
 +
$buffer = Service::Response()
 +
->getCurrentBuffer();
 +
$buffer->clear();
 +
$buffer->contentType('text/plain');
 +
$buffer->push('Sorry, but this payment system doesn\'t support server polling.' . getRequest('param0'));
 +
$buffer->end();
 +
}
 +
}
 +
</source>
 +
9) В модуле "Интернет-магазин", в настройках модуля, на вкладке "Оплата" добавим новый способ оплаты "Тестовый перевод". Заполним поля "Номер телефона" и "Как платить?".<br>
 +
[[Файл:Способ оплаты 4.png | 1500px]]
 +
<br>10) Добавим вид оплаты в шаблон.<br>
 +
Создаем файл /templates/demomarket/php/emarket/payment/Test.phtml. Реализуем в нем простейший шаблон<br>
 +
<source lang="php">
 +
<?php
 +
//Получаем объект нашего способа оплаты
 +
$payment = umiObjectsCollection::getInstance()->getObject(1472);
 +
//Получаем значения полей
 +
$instruction = $payment->getValue('kak_platit');
 +
$phone = $payment->getValue('nomer_telefona');
 +
?>
 +
 
 +
<div>
 +
    <h3>Инструкция по переводу:</h3>
 +
    <p><?= $instruction ?></p>
 +
    <p>Номер телефона для перевода: <?= $phone ?></p>
 +
</div>
 +
<div>
 +
    <p>Нажмите кнопку завершить, после поступления оплаты наш менеджер свяжется с Вами</p>
 +
    <a href="/emarket/purchase/result/successful/" class="button big">Завершить</a>
 +
</div>
 +
</source>
 +
 
 +
Данный пример лишь демонстрирует последовательность действий для создания своего типа оплаты. При желании Вы можете реализовать класс и шаблон по своему усмотрению.<br><br>
 +
'''Результат:'''<br>
 +
[[Файл:Способ оплаты 5.png | 1500px]]
 +
----
 +
[[Файл:Способ оплаты 6.png | 1500px]]
 +
----
 +
[[Файл:Способ оплаты 7.png | 1500px]]
 +
 
 +
----
 +
----
 +
 
 +
<br/><br/><br/>'''Устарело: актуально для версии 2.9 и старой реализации модулей'''
  
 
'''Задача:''' создать способ оплаты с дополнительным шагом, на котором показать пользователю дополнительную информацию.<br/>
 
'''Задача:''' создать способ оплаты с дополнительным шагом, на котором показать пользователю дополнительную информацию.<br/>
 
'''Решение:''' для решения поставленной задачи, создадим новый способ оплаты.<br/>
 
'''Решение:''' для решения поставленной задачи, создадим новый способ оплаты.<br/>
  
Чтобы добавить новый тип доставки, Вам следует выполнить следующие шаги:<br/>
+
Чтобы добавить новый способ оплаты, Вам следует выполнить следующие шаги:<br/>
 
1. Открыть модуль '''Шаблоны данных''' и найти там "'''Способы оплаты'''". Добавить в него дочерний шаблон, назвав его например, так "''Перевод через сервис Visa QIWI Wallet''".<br/>
 
1. Открыть модуль '''Шаблоны данных''' и найти там "'''Способы оплаты'''". Добавить в него дочерний шаблон, назвав его например, так "''Перевод через сервис Visa QIWI Wallet''".<br/>
 
2. В созданном шаблоне создаем два поля:<br/>
 
2. В созданном шаблоне создаем два поля:<br/>
Строка 93: Строка 191:
 
[[Файл:Newpay5.png]]
 
[[Файл:Newpay5.png]]
  
[[Категория:Модуль Интернет магазин]][[Категория:Написание кастомных макросов]]
+
[[Категория:Модуль Интернет магазин]][[Категория:Написание кастомных макросов]][[category:Верстка в PHP]]

Текущая версия на 16:14, 31 октября 2018

Актуально для версии 19.

Задача: Добавить свой способ оплаты. Ниже мы рассмотрим способ реализации данной задачи в общих чертах, создав простейший кастомный способ оплаты на примере интернет-магазина "Адаптивный" (demomarket).

Решение:
1) Открываем модуль "Шаблоны данных", находим тип данных "Способ оплаты" и добавляем ему дочерний элемент. Назовем его "Тестовый перевод".
2) Добавляем в группу [payment_props] два поля:
"Как платить?" [kak_platit] HTML-текст видимое
"Номер телефона" [phone] строка видимое

Способ оплаты 1.png

3) Запоминаем id из адресной строки (/admin/data/type_edit/187/), где вместо 187 у Вас будет свой id.
4) В типах данных находим справочник "Типы способов оплаты". Нажимаем "Посмотреть" и переходим в режим его редактирования.

Способ оплаты 2.png

5) Добавляем новое наименование справочника. Название — такое же, "Тестовый перевод". В поле "Тип данных (id)" вставляем ранее запомненный id, в нашем случае это 187. В поле "Тип данных (GUID)" напишем "emarket-payment-187". В поле "Идентификатор типа оплаты" пишем название класса, который мы создадим и будем использовать для работы с данным типом оплаты, в нашем случае это будет Test. Будьте внимательны, данное название ригистрозависимо.

Способ оплаты 3.png

6) Заходим в базу данных нашего сайта и с помощью запроса

UPDATE cms3_object_types SET guid='emarket-payment-187' WHERE id='187'

добавляем значение 'guid' для нашего типа данных. В своем запросе Вам нужно изменить guid='emarket-payment-187' на emarket-payment-Ваш-id.

7) В папке /classes/components/emarket/classes/payment/systems/ создаем php файл с названием, аналогичным нашему классу, указанному на 5 шаге, Test.php. Скопируем в него содержимое файла courier.php, расположенного в той же папке.
8) Редактируем код в файле Test.php. Название класса заменяем на "Класс"+"Payment", т.е. в нашем случае название класса будет TestPayment. В классе вносим изменения: получаем массив с данными о заказе и заменяем им редирект.

<?php

	use UmiCms\Service;

	/** Способ оплаты "Тестовый" */
	class TestPayment extends payment {

		public function process($template = null) {
			$order = $this->order;
			$order->order();
			$controller = cmsController::getInstance();
            $module = $controller->getModule('emarket');
            
            $line['attribute:orderId'] = $order->getId();
			$line['attribute:number'] = $order->getValue('number');
			$line['attribute:total_price'] = $order->getValue('total_price');
			$line['attribute:phone'] = $this->object->phone;
			$line['node:value'] = $this->object->kak_platit;
            $lines[] = $line;
            $udata['nodes:item'] = $lines;
			//Здесь вернем массив с данными заказа, вместо редиректа
			if ($module) {
				return $udata;
			}

			return null;
		}

		/** @inheritdoc */
		public function poll() {
			$buffer = Service::Response()
				->getCurrentBuffer();
			$buffer->clear();
			$buffer->contentType('text/plain');
			$buffer->push('Sorry, but this payment system doesn\'t support server polling.' . getRequest('param0'));
			$buffer->end();
		}
	}

9) В модуле "Интернет-магазин", в настройках модуля, на вкладке "Оплата" добавим новый способ оплаты "Тестовый перевод". Заполним поля "Номер телефона" и "Как платить?".
Способ оплаты 4.png
10) Добавим вид оплаты в шаблон.
Создаем файл /templates/demomarket/php/emarket/payment/Test.phtml. Реализуем в нем простейший шаблон

<?php
 //Получаем объект нашего способа оплаты
$payment = umiObjectsCollection::getInstance()->getObject(1472);
//Получаем значения полей
$instruction = $payment->getValue('kak_platit');
$phone = $payment->getValue('nomer_telefona');
?>

<div>
    <h3>Инструкция по переводу:</h3>
    <p><?= $instruction ?></p>
    <p>Номер телефона для перевода: <?= $phone ?></p>
</div>
<div>
    <p>Нажмите кнопку завершить, после поступления оплаты наш менеджер свяжется с Вами</p>
    <a href="/emarket/purchase/result/successful/" class="button big">Завершить</a>
</div>

Данный пример лишь демонстрирует последовательность действий для создания своего типа оплаты. При желании Вы можете реализовать класс и шаблон по своему усмотрению.

Результат:
Способ оплаты 5.png


Способ оплаты 6.png


Способ оплаты 7.png






Устарело: актуально для версии 2.9 и старой реализации модулей

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

Чтобы добавить новый способ оплаты, Вам следует выполнить следующие шаги:
1. Открыть модуль Шаблоны данных и найти там "Способы оплаты". Добавить в него дочерний шаблон, назвав его например, так "Перевод через сервис Visa QIWI Wallet".
2. В созданном шаблоне создаем два поля:
Как платить? [kak_platit] - тип HTML-текст, видимое.
Номер телефона [phone] - тип Строка, видимое.
Newpay1.png
Запоминаем id шаблона из адресной строки браузера:
/admin/data/type_edit/131/ - то есть у меня id=131
Qiwi5.png
3. В этом же модуле, на вкладке Справочники, находим справочник "Типы способов оплаты" и нажимаем на иконку глаза, чтобы открыть содержимое справочника.
Добавляем новое наименование.
В поле "Название" напишем тоже самое "Перевод через сервис Visa QIWI Wallet", в поле "Тип данных (id)" наш запомненный ранее id "131", в поле "Тип данных" напишем "emarket-payment-131", где 131 - это наш id. А вот в поле "Идентификатор типа оплаты" напишем название будущего класса, которое должно отражать предназначение класса. Указывается латинскими буквами. У меня в примере данный класс называется simpleQIWI (Обратите внимание, что название регистрозависимое. Если мы используем прописные буквы, то точно также мы должны их использовать и в дальнейшем).
Qiwi6.png
4. Открываем базу данных через phpMyAdmin и выполняем запрос:

UPDATE `blank`.`cms3_object_types` SET `guid` = 'emarket-payment-131' WHERE `cms3_object_types`.`id` =131;

В данном запросе следует изменить:
'blank' - на название вашей базы данных,
'emarket-payment-131' - на emarket-payment с вашим id
131 - на ваш id
5. Заходим на сайт по FTP, открываем директорию:
\classes\modules\emarket\classes\payment\systems\
где копируем файл courier.php и переименовываем его в simpleqiwi.php - у Вас может быть другое название, которое Вы указали в 3 шаге.
6. Открываем файл на редактирование и изменяем:
название класса courierPayment на simpleQIWIPayment (у вас может быть другое название, указанное на 3 шаге).
7. Доработаем содержимое класса на наше усмотрение. Здесь мы вместо редиректа передаем массив с данными об ID заказа, его номере и итоговую сумму заказа, а также кладем в ячейки массива содержимое полей "Номер телефона" и "Как платить?":

<?php
	class simpleQIWIPayment extends payment {

		public function validate() { return true; }

		public function process($template = null) {
			$order = $this->order;
			$order->order();
			$controller = cmsController::getInstance();
			$module = $controller->getModule("emarket");
			$line['attribute:orderId'] = $order->getId();
			$line['attribute:number'] = $order->getValue('number');
			$line['attribute:total_price'] = $order->getValue('total_price');
			$line['attribute:phone'] = $this->object->phone;
			$line['node:value'] = $this->object->kak_platit;
			$lines[] = $line;
			$udata['nodes:item'] = $lines;
			if($module) {
				return $udata;
			}
			return null;
		}

		public function poll() {
			$buffer = outputBuffer::current();
			$buffer->clear();
			$buffer->contentType('text/plain');
			$buffer->push('Sorry, but this payment system doesn\'t support server polling.' . getRequest('param0'));
			$buffer->end();
		}

	};
?>


8. Проверьте, что файл в кодировке utf-8 (без BOM).
9. В административном интерфейсе сайта, в модуле Интернет-магазин, создайте новый способ оплаты "Перевод через сервис Visa QIWI Wallet", заполните поля Номер телефона и Как платить?.
Newpay2.png
10. Добавим новый шаг в шаблон оформления заказа на этапе выбора способа оплаты: \templates\demodizzy\xslt\modules\emarket\purchase\payment.xsl

	<xsl:template match="purchasing[@stage = 'payment'][@step = 'simpleQIWI']">
               <xsl:apply-templates select="//steps" />
			<div class="ramka">
				<h3>Сведения которые необходимо указать при оплате:</h3>
				<h4>Номер телефона: <xsl:value-of select="item/@phone" /></h4>
				<h4>Сумма к оплате: <xsl:value-of select="item/@total_price" /></h4>
				<h4>Комментарий: Заказ №<xsl:value-of select="item/@number" /></h4>
			</div>
			<br/>
			<xsl:value-of select="item" disable-output-escaping="yes"/>
			<div class="cart-buttons">
				<a href="{$lang-prefix}/emarket/purchase/result/successful/" class="button big">
					<xsl:text>Завершить</xsl:text>
				</a>
			</div>
	</xsl:template>

11. Проверим.
Newpay3.png

Newpay6.png

Newpay5.png