
Плагин finance
Плагин Finance
finance управляет балансами пользователей, записывает историю операций и позволяет закрывать платные части новостей. Пополнение баланса выполняется через плагин payments и его активные платёжные адаптеры.
id: "finance"
name: "Finance manager"
version: "1.0.0"
file: "finance.php"
config: "config.php"
install: "install.php"
type: "plugin"
acts: "core, ppages, twig"
minenginebuild: 2020731
description: "Баланс пользователей, платный доступ к новостям и пополнение через Payments"
author: "NGCMS"
finance управляет балансами пользователей, записывает историю операций и позволяет закрывать платные части новостей. Пополнение баланса выполняется через плагин payments и его активные платёжные адаптеры.
id: "finance"
name: "Finance manager"
version: "1.0.0"
file: "finance.php"
config: "config.php"
install: "install.php"
type: "plugin"
acts: "core, ppages, twig"
minenginebuild: 2020731
description: "Баланс пользователей, платный доступ к новостям и пополнение через Payments"
author: "NGCMS"
Требования
- Сборка NGCMS не ниже 2020731.
- Для пополнений должен быть активен и установлен плагин payments.
- payments использует таблицу заказов basket_orders, поэтому плагин basket должен быть установлен.
- В настройках payments должен быть включён хотя бы один платёжный адаптер.
- Валюты finance и payments должны совпадать. RUR в finance считается эквивалентом ISO-кода RUB.
- Таблицы пользователей, истории Finance, заказов Basket и реестра пополнений должны использовать InnoDB для безопасного атомарного зачисления.
Установка и обновление
Перед обновлением сделайте резервную копию файлов и базы данных.
Устанавливайте плагины из панели администратора (Плагины), по очереди:
1. Установите и активируйте xfields, feedback и basket— это зависимости payments.
2. Установите и активируйте payments. Установка создаёт таблицу payments_transactions; заказная таблица basket_orders должна быть создана установкой basket.
3. Установите и активируйте finance. Его установщик добавляет поля балансов и цен блоков новостей, реестр заказов Payments и таблицы учёта лимита скачиваний.
После установки проверьте, что панель не показала ошибку обновления схемы. Если finance уже был установлен до добавления интеграции, примените обновление схемы через штатный механизм установки/обновления плагина. Не удаляйте и не переустанавливайте таблицы с финансовыми данными.
Если Finance уже отмечен как установленный и кнопка установки в списке плагинов не отображается, войдите в админ-панель и откройте admin.php?mod=extra-config&plugin=finance&stype=install, затем подтвердите запуск установщика. Его cmodify-операции сохраняют существующие строки и добавляют недостающие поля цен и таблицы учёта. При сохранении новости Finance дополнительно проверяет и при необходимости создаёт недостающие колонки цен; у пользователя базы данных должно быть разрешение ALTER. Схема учёта скачиваний также создаётся автоматически при первом обращении к приватному вложению. Перед обновлением схемы всё равно сделайте резервную копию.
Существующие данные не конвертируются и не удаляются. После обновления пользовательская страница Finance больше не использует fin_acceptors и fin_wm: пополнения идут через методы, включённые в payments.
Настройка
1. Настройте Payments
Откройте Плагины → payments → Настройки:
- Укажите валюту Payments.
- Включите как минимум один платёжный адаптер и заполните его реквизиты из кабинета провайдера.
- В кабинете провайдера укажите callback/уведомление об оплате по адресу сайта https://ваш-домен/payments/notify/?method=имя_адаптера. Например, для Robokassa: /payments/notify/?method=robokassa.
- Используйте HTTPS и убедитесь, что сайт доступен провайдеру извне. Не отправляйте секретные ключи в чат и не включайте тестовый режим на рабочем магазине.
Список поддерживаемых адаптеров и их поля настройки приведены в документации Payments. Для обычной оплаты товаров через корзину дополнительно укажите форму feedback в настройках basket; для пополнения Finance эта форма не используется.
2. Настройте Finance
Откройте Плагины → finance → Настройки:
- Выберите валюту сайта. Не меняйте её после начала финансовых операций.
- Выберите срок доступа после оплаты новости: без ограничения, 1/2/3 часа, до обновления страницы или до конца сессии. По умолчанию сохраняется прежнее постоянное разрешение; изменение настройки действует только на новые покупки.
- Для сроков 1–3 часа используется существующее поле subscribe_manager.expiration_date; повторно устанавливать Finance или менять схему БД не требуется.
- Для дополнительных балансов 1–4 укажите денежный/неденежный тип, идентификатор и описание.
- Валюта Finance должна совпадать с валютой Payments: RUR соответствует RUB, а USD — USD. EUR используйте только если выбранный шлюз действительно принимает EUR и в Payments указана та же валюта.
Основной денежный баланс имеет номер 0, дополнительные — 1– 4. Денежные значения в API и БД хранятся в минимальных единицах: 1250 означает 12.50.
Для безопасного повторного callback таблицы `{prefix}_basket_orders`, `{prefix}_finance_payment_orders`, `{prefix}_finance_history` и `{uprefix}_users` должны использовать InnoDB. Страница Finance проверяет это и не показывает форму пополнения при неподдерживаемом типе таблиц.
Страница счёта и пополнение
Страница пользователя зарегистрирована по адресу `/plugin/finance/`. Авторизованный пользователь видит общий денежный баланс, последние операции и форму пополнения. После ввода суммы создаётся заказ, затем пользователь переходит на страницу выбора платёжного метода Payments.
Сумма проверяется на сервере, заказ связан с текущим пользователем. При подтверждённой оплате адаптер передаёт проверенную сумму Finance; она сравнивается с суммой заказа. Зачисление и смена статуса записи Finance выполняются в транзакции. Повторный callback не зачисляет уже обработанный заказ повторно.
Payments вызывает обработчики успешной оплаты после проверки шлюзом. Finance обрабатывает только заказы, присутствующие в его таблице finance_payment_orders; обычные заказы корзины не затрагиваются.
Проверочный платёж
1. Включите тестовый режим у провайдера, если он доступен.
2. Войдите на сайт под обычной тестовой учётной записью и откройте /plugin/finance/.
3. Создайте небольшое тестовое пополнение и выберите платёжный метод.
4. После подтверждения callback проверьте баланс и историю на странице Finance.
5. Убедитесь, что повторное уведомление провайдера не начислило сумму ещё раз.
Не используйте реальные платежи для проверки без предварительного согласования с владельцем магазина.
Если пополнение недоступно
- Нет способов оплаты: проверьте, что payments активен и хотя бы один адаптер включён и настроен.
- Сообщение о несовпадении валют: укажите совместимую валюту в настройках обоих плагинов и проверьте её поддержку у провайдера.
- Требуется InnoDB: проверьте тип таблиц пользователей, истории Finance, заказов Basket и реестра пополнений. Перед изменением типа таблиц сделайте резервную копию.
- Заказ отмечен оплаченным, но баланс не изменился: проверьте доступность callback URL, валюту и подтверждённую сумму, затем изучите журналы payments.log и finance.log. Не зачисляйте сумму вручную, пока не проверите статус записи в реестре Finance.
Платный доступ к новости
В настройках Finance выберите от 1 до 5 платных блоков на новость. Для каждого блока в форме создания/редактирования новости задаётся своя цена; нулевая цена оставляет этот блок бесплатным. Блоки оплачиваются независимо. Для первого блока используйте [fin_lock]...[/fin_lock], для следующих — [fin_lock2]...[/fin_lock2] вплоть до [fin_lock5]...[/fin_lock5]. Кнопки этих тегов в панели редактора соответствуют выбранному числу блоков. Оплата одного блока открывает только его; после оплаты Finance возвращает пользователя на новость и показывает toast-уведомление. Настройка срока доступа применяется к каждому отдельно оплаченному блоку. Старые новости сохраняют прежнюю цену в первом блоке, а старые покупки с доступом ко всей новости продолжают открывать все блоки.
В Twig-шаблонах новостей доступны переменные:
Код : xml
| Выражение -----------------------| Значение------------------------------------------------ |
|-----------------------------------------|---------------------------------------------------------------|
| `{{ finance.is_premium }}` | Для новости указана положительная цена. |
| `{{ finance.has_access }}` | Текущий посетитель имеет доступ. Для бесплатной новости значение `true`. |
| `{{ finance.is_locked }}` | Платная новость закрыта для текущего посетителя. |
| `{{ finance.price }}` | Цена с двумя знаками после запятой. |
| `{{ finance.currency }}` | Код валюты Finance. |
| `{{ finance.blocks }}` | Массив блоков 1–5 с ценой и флагами `is_premium`, `has_access` и `is_locked`. |
| `{{ fin_price }}` | Совместимый псевдоним форматированной цены. |
| `{{ plugin_finance_balance }}` | Баланс авторизованного пользователя; для гостя — пустая строка. |
Старые маркеры шаблонов `[finance]...[/finance]`, `[fin_on]...[/fin_on]` и `[fin_off]...[/fin_off]` сохраняют поддержку. Для новых шаблонов используйте Twig:
Код : xml
{% if finance.is_premium %}
<span>{{ finance.price }} {{ finance.currency }}</span>
{% endif %}
{% if finance.is_locked %}
<a href="/plugin/finance/">{{ finance.price }} {{ finance.currency }} — войдите или пополните баланс</a>
{% endif %}[fin_lock]...[/fin_lock] и пронумерованные варианты — разметка содержимого новости, а не Twig-блоки. Finance обрабатывает их в legacy-переменных short-story/full-story и Twig-переменных news.short/news.full.
В админском скине default кнопки с замком появляются только при активном Finance и вставляют выбранный тег вокруг выделенного текста.
Защита текста и файлов
В настройках Finance независимо включаются четыре браузерные меры для текста платной новости, доступной текущему пользователю: заменять выделение точками при копировании, добавлять источник к скопированному тексту, запрещать выделение/перетаскивание/контекстное меню и показывать видимую метку. Текст метки задаётся в настройках; пустое поле использует название сайта. Эти меры усложняют копирование, но не защищают от снимков экрана, OCR и инструментов разработчика.
Лимит скачиваний задаётся от 1 до 10 на пользователя и файл; по умолчанию — 10. Новые вложения, загруженные в поле файлов штатной формы добавления/редактирования новости с положительной Finance-ценой, сохраняются вне каталога сайта и выдаются через Finance после проверки учётной записи и доступа к новости. Повторные Range-запросы в рамках одной временной ссылки учитываются как одно скачивание. Для выдачи и продолжения передачи нужна авторизация.
Существующие вложения не перемещаются и остаются доступными по прежним URL. Загрузка через общий менеджер изображений, внешние URL и внешние видеосервисы не переводятся в приватное хранилище. Пользователь PHP должен иметь право создавать и записывать каталог ../<имя-каталога-сайта>-finance-private рядом с корнем сайта; если это невозможно, загрузка приватного файла завершится явной ошибкой. Не размещайте этот каталог через дополнительные серверные alias или ссылки внутри публичной области.
Twig-шаблоны плагина
Шаблоны находятся в engine/plugins/finance/tpl/:
- screen.tpl — баланс, форма пополнения и история операций.
- enough.tpl — форма оплаты новости при достаточном балансе.
- notenough.tpl — предложение пополнить баланс.
- needauth.tpl — сообщение для незарегистрированного пользователя.
- message.tpl — результат операции.
Настройки плагина тоже выводятся через Twig; уведомления используют общий admin helper `showToast()`.
PHP API
Перед вызовом функций плагин Finance должен быть загружен.
Код : xml
finance_check_money($userlogin, $balance_no = -1)
Код : xml
finance_check_enough_money($userlogin, $type, $tprice, $price)
Код : xml
finance_pay($identity, $payment)
Код : xml
finance_add_money($userlogin, $balance, $sum, $description = '')
Совместимость
Класс Finance_Acceptor и функция finance_register_acceptor() оставлены для стороннего старого кода, но интерфейс Finance больше не загружает fin_acceptors. Новые способы пополнения следует интегрировать через payments.
Скачать:finance_d47c8dc3.zip
Добавить комментарий