Баланс пользователя

Модуль относится к части CMS «Интернет магазин» и может быть установлен опционально.

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

В административной части сайта модуль доступен в разделе «Оплата».

Подключение

Подключаемая часть – файл modules/balance/balance.inc.php. В нем описан класс Balance_inc. В модуле к объекту класса можно обратиться через переменную $this->diafan->_balance. Экземпляр класса создается при первом вызове переменной.

Методы

float get ([integer $user_id = false]) – Возврат текущего баланса пользователя.

  • integer $user_id: ID пользователя. По умолчанию текущий пользователь

Пример:

echo 'Ваш баланс: '.$this->diafan->_balance->get().' руб.';
// выведет:
// Ваш баланс: 300 руб.

array details (integer $user_id) – Возврат информаци о плательщике.

  • integer $user_id: ID пользователя

void set (integer $user_id, float $summ, [string $type = 'summ']) – Изменение текущего баланса пользователя.

  • integer $user_id: ID пользователя. По умолчанию текущий пользователь
  • float $summ: новая сумма
  • string $type: тип операции: summ – изменение всей суммы на балансе, plus – добавление, minus – вычитание

Пример:

// добавляет текущему пользователю 300 руб. на баланс
$this->diafan->_balance->set(0, 300, 'plus');

void pay (array $pay) – Добавление средств на баланс пользователя.

  • array $pay: данные платежа

Пример:

// проводит пополнение баланса пользователя ID=4
$pay = DB::fetch_array("SELECT * FROM {payment_history} WHERE element_id=4 AND module_name='balance'");
$this->diafan->_balance->pay($pay);

Баланс

Баланс пользователей

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

Редактирование баланса пользователя

При редактировании баланса можно задать следующие поля.

Основные:

  • Имя пользователя.
  • Средства на балансе.

Настройки

Настройки

  • Название валюты – Название валюты баланса. Параметр имеет разные значения для разных языковых версий сайта.
  • Сообщение о пополнении баланса перед оплатой – Сообщение, получаемое пользователем по окончании пополнения баланса. Параметр имеет разные значения для разных языковых версий сайта.
  • Описание платежа – Используется платежными системами. Можно добавлять:
    • %id – номер платежа.
    Параметр имеет разные значения для разных языковых версий сайта.
  • Платеж успешно принят – Сообщение, которое увидит пользователь, если платеж успешно принят платежной системой.
  • Платеж не принят – Сообщение, которое увидит пользователь, если платеж не принят платежной системой.
  • Тема письма пользователю о пополнении баланса – Можно добавлять:
    • %title – название сайта,
    • %url – адрес сайта (например, site.ru),
    • %id – номер платежа.
    Параметр имеет разные значения для разных языковых версий сайта.
  • Сообщение пользователю о пополнении баланса – Можно добавлять:
    • %title – название сайта,
    • %url – адрес сайта (например, site.ru),
    • %payment – способ оплаты,
    • %fio – имя пользователя,
    • %id – номер платежа.
    Параметр имеет разные значения для разных языковых версий сайта.
  • Тема письма администратору о пополнении баланса – Можно добавлять:
    • %title – название сайта,
    • %url – адрес сайта (например, site.ru),
    • %id – номер платежа.
  • Текст письма администратору о пополнении баланса – Можно добавлять:
    • %title – название сайта,
    • %url – адрес сайта (например, site.ru),
    • %payment – способ оплаты,
    • %fio – имя пользователя, пополнившего баланс,
    • %id – номер платежа.
  • E-mail для уведомлений администратора – Возможные значения:
    • e-mail, указанный в параметрах сайта;
    • другой (при выборе этого значения появляется дополнительное поле впишите e-mail).
  • Уведомлять о пополнении баланса по SMS – Возможность отправлять SMS администратору при пополнении баланса. Параметр можно подключить, если в Параметрах сайта настроены SMS-уведомления.
  • Номер телефона в федеральном формате – Номер телефона для SMS-уведомлений администратора о пополнении баланса. Параметр появляется, если отмечена опция «Уведомлять о пополнении баланса по SMS».
  • Сообщение для уведомлений – Текст сообщения для SMS-уведомлений администратора о пополнении баланса. Не более 800 символов. Параметр появляется, если отмечена опция «Уведомлять о пополнении баланса по SMS».

База данных

{balance} – Баланс пользователей

Файлы

Модуль находится в папке modules/balace и устроен классически.

  1. modules/balance/admin/balance.admin.php – редактирование баланса пользователей;

  2. modules/balance/admin/balance.admin.config.php – настройки модуля;

  3. modules/balance/balance.php – контроллер модуля «Баланс пользователя»;

  4. modules/balance/balance.action.php – обрабатывает полученные данные из формы;

  5. modules/balance/balance.inc.php – подключение модуля «Баланс пользователя»;

  6. modules/balance/balance.install.php – установка модуля;

  7. modules/balance/balance.model.php – модель модуля «Баланс пользователя»;

  8. modules/balance/views/balance.view.form.php – шаблон формы пополнения баланса пользователя;

  9. modules/balance/views/balance.view.payment.php – шаблон формы платежной системы;

  10. modules/balance/views/balance.view.result.php – шаблон подтверждения/опровержения платежа.

Ваши комментарии и дополнения

Ваш комментарий будет первым.

Зарегистрируйтесь или авторизируйтесь для того, чтобы оставить комментарий.