CMS Simpla: различия между версиями

Материал из Касса
Перейти к навигации Перейти к поиску
(Новая страница: «{{CMS |cms_name = Плагин для CMS Bitrix |cms_version = 1.3.9 |cms_platform = Bitrix |cms_img = 1c_bitrix_logo.svg.png |cms_url = https://kassa.bifit.com/_files/bifit.bitrix 1.3.9.zip |cms_description = ==Инструкция установки модуля "БИФИТ Касса" для CMS "1С-Битрикс"== # Авторизуемся в панели управления сайта. # Закачайте архив с исходными код...»)
 
Строка 1: Строка 1:
{{CMS
{{CMS
|cms_name = Плагин для CMS Bitrix
|cms_name = Плагин для CMS SIMPLA
|cms_version = 1.3.9
|cms_version = 1.2.3
|cms_platform = Bitrix
|cms_platform = SIMPLA CMS (версия 2.3.8)
|cms_img = 1c_bitrix_logo.svg.png
|cms_img = simpla_logo.png
|cms_url = https://kassa.bifit.com/_files/bifit.bitrix 1.3.9.zip
|cms_url = https://kassa.bifit.com/_files/bifitkassa_Simpla.zip
|cms_description =
|cms_description =


==Инструкция установки модуля "БИФИТ Касса" для CMS "1С-Битрикс"==
==Техническая поддержка==


# Авторизуемся в панели управления сайта.
При необходимости, в рабочее время, Вы можете обратиться в тех-поддержку компании "БИФИТ Касса" и наши специалисты быстро и качественно установят модуль на Вашем сайте (при условии предоставления временного FTP-доступ к файлам сайта). Мы также можем доработать наше расширение согласно требованиям Вашего тех-задания (ТЗ).
# Закачайте архив с исходными кодами модуля на сайт: ''''Контент -> Структура сайта -> Файлы и папки -> /bitrix/modules''''
# Распакуйте архив. После распаковки, можете удалить архив с сайта.
# Установите модуль: ''''Marketplace -> Установленные решения''''
# Настроить модуль Настройки -> Настройки продукта -> Настройки модулей
## Выбираем и заполняем нужные параметры:
### Выбираем Тестовый или Рабочий (боевой) режим работы расширения(*).
### Выбираем активацию параметра "Без дублей", для исключения дублирования отправки данных заказа в фискальный процессинг, при некорректных настройках сторонних модулей интернет-магазина (в разделе изменения статусов заказа, сразу несколько модулей могут устанавливать один и тот же статус заказа, то есть вызывать активацию модуля "БИФИТ Касса" несколько раз подряд). Конечно в случае существования подобной проблемы, правильней выставить корректные настройки сторонних модулей (отключить лишние изменения статуса), но и при активации данного параметра, дубли будут исключены.
### Заполняем полученный токен доступа необходимый для рабочего (боевого) режима работы.
### Вводим фамилию и инициалы кассира, например Иванов И.И.
### Вводим ИНН кассира (12-ть цифр для РФ).
### Вводим место расчёта, например домен сайта, строго по форме (с http или https): https://site.ru
### Выбираем, что выводить в адресе клиента: телефон или e-mail.
### Выбираем выводить или нет ФИО клиента.
### Выбираем признак способа расчёта.
### Выбираем тип оплаты.
### Выбираем режим назначения НДС.
### Выбираем ставку НДС.
## Сохраняем изменённые параметры.
# Настройки для каждого типа документа вынесены в отдельный таб.
## Выбираем и заполняем нужные параметры для каждого типа документа.
### Активируем использование данного типа документа.
### Выбираем учитывать или нет параметр "Заказ оплачен".
### Выбираем систему налогообложения.
### Выбираем один или несколько статусов заказа, при выборе которых будет активирована работа расширения по данной вкладке.
### Выбираем один или несколько способов оплаты, при выборе которых будет активирована работа расширения по данной вкладке.
## Сохраняем изменённые параметры.
# Вкладка "Связь" предназначена для передачи данных заказа в личный кабинет "БИФИТ Касса" и может работать совершенно независимо от фискального процессинга, то есть от настроек модуля в других вкладках. Используются всего три параметра из первой вкладки "Настройки" - это "Признак способа расчёта", "Единый НДС" и "Ставка НДС".
## Выбираем и заполняем нужные параметры для связи.
### Активируем использование связи с кабинетом или нет.
### Активация подробного логирования всех шагов процесса передачи данных заказа в кабинет "БИФИТ Касса". Включен по-умолчанию. Для каждого заказа создаётся свой лог-файл с именем "log_XXX.txt", где "ХХХ" - это номер самого заказа. Файлы сохраняются в папку "/bitrix/modules/bifit.kassa/classes/general/logs/". В зависимости от настроек сайта и сервера, внешний доступ к лог-файлам может быть закрыт. В таком случае файлы будут доступны через встроенный компонент админ-панели "Контент -> Структура сайта -> Файлы и папки".
### Выбираем учитывать или нет параметр "Заказ оплачен".
### Выбираем систему налогообложения.
### Выбираем один или несколько статусов заказа, при выборе которых будет активирована работа расширения по данной вкладке.
### Выбираем один или несколько способов оплаты, при выборе которых будет активирована работа расширения по данной вкладке.
### Вводим логин (номер телефона: +7(XXX)XXX-XX-XX). Допускаются "+", "(", ")", "-", " ".
### Вводим пароль.
### Выбираем организацию (параметр будет доступен при наличии логина и пароля).
### Выбираем торговый объект (параметр будет доступен при наличии логина и пароля).
### При необходимости, обновляем данные по организациям и объектам(**).
### Выбираем доставки сайта подходящие под доставку "Курьером" в кабинете "БИФИТ Касса".
### Выбираем доставки сайта подходящие под доставку "Самовывоз" в кабинете "БИФИТ Касса".
### Выбираем статус для нового заказа "Курьером" в кабинете "БИФИТ Касса".
### Выбираем нужно ли удалять заказ в кабинете "БИФИТ Касса".
### Выбираем статус заказа при котором будет произведено удаление заказа в кабинете "БИФИТ Касса".
### Добавляем названия дополнительных кодов свойств заказа для адреса доставки заказа(***).
## Сохраняем изменённые параметры.
# Всю историю транзакций можно просмотреть в меню Сервисы -> БИФИТ Касса -> Транзакции
==============================================================
(*)  При выборе тестового режима работы, данные будут отправлены с тестовым токеном, даже если в настройках модуля указан рабочий (боевой) токен подключения.
(**)  Для ускорения работы, данные по организациям и объектам заданным в кабинете "БИФИТ Касса", загружаются сразу в базу данных сайта и затем выводятся именно из базы сайта, а не из кабинета "БИФИТ Касса". Для обновления этой информации, то есть повторного запроса и загрузки данных по организациям и объектам из кабинета "БИФИТ Касса", необходимо нажать на кнопку "Обновить организации и объекты".
(***) Перечисление кодов через запятую (например: CITY, STREET, HOUSE, APARTMENT). Названия кодов новых добавленных полей, находятся на странице "Магазин -> Настройки -> Свойства заказа -> Список свойств". Коды по-умолчанию добавлять не нужно.


Перед установкой, настоятельно рекомендуем сделать бэкап (резервную копию) файлов сайта. Для этого откройте меню Автоматизация  Бэкап и нажмите кнопку "Создать бэкап", после чего будет создан файл резерва. Далее, в случае непредвиденной проблемы, вернитесь на эту страницу и нажмите на значок восстановления напротив созданного ранее файла.
== ИНСТРУКЦИЯ ==
Из-за конструктивных особенностей CMS "Simpla", для установки модуля "БИФИТ Касса", потребуется доступ к файлам сайта (FTP-доступ). Далее, необходимо выбрать один из двух способов установки: "Быстрый" или "Обычный". Быстрый способ доступен только в том случае, если файлы из списка ниже никогда не редактировались (не изменялись для других расширений Вами или сторонними специалистами) — список файлов:
# /api/Managers.php
# /api/Simpla.php
# /simpla/IndexAdmin.php
# /simpla/OrderAdmin.php
# /simpla/design/html/index.tpl
# /simpla/design/html/manager.tpl
# /view/OrderView.php
=== БЫСТРЫЙ СПОСОБ (файл "quick.zip") ===
Если Вы точно уверены, что файлы из списка выше никогда не изменялись, то понадобится всего лишь загрузить и распаковать архивный файл "quick.zip" в корневой папке сайта — при этом существующие файлы будут заменены файлами из архива (если в процессе распаковки система укажет, что файлы уже существуют, то выберите замену существующих файлов). Альтернативный вариант — распаковать файл "quick.zip" на компьютере в папке "quick", после чего перенести всё содержимое данной папки в корень сайта (так же с заменой существующих файлов).
=== ОБЫЧНЫЙ СПОСОБ (файл "normal.zip") ===
-------------------------------------------------
Если Вы не уверены или не знаете наверняка о изменениях в файлах из списка выше, то в таком случае потребуется сделать следующие два шага:
Шаг 1. Загрузить и распаковать архивный файл "normal.zip" в корневой папке сайта — все файлы новые, поэтому никаких замен не будет.
Шаг 2. Открыть и добавить небольшой блок кода в каждый из перечисленных ниже файлов:
---------------------------------------------
1. Файл /api/Managers.php
Строка №16 с кодом "public $permissions_list = array("
[скриншот simpla_api_managers_01-1.png]
После открывающей скобки вставляем:
'bifitactions',
[скриншот simpla_api_managers_01-2.png]
---------------------------------------------
2. Файл /api/Simpla.php
Строка №15 с кодом "private $classes = array("
[скриншот simpla_api_simpla_01-1.png]
После открывающей скобки, с новой строки вставляем:
// БИФИТ Касса
'bifitactions' => 'Bifitactions',
[скриншот simpla_api_simpla_01-2.png]
---------------------------------------------
3. Файл /simpla/IndexAdmin.php
Строка №10 с кодом "private $modules_permissions = array("
[скриншот simpla_indexadmin_01-1.png]
После открывающей скобки, с новой строки вставляем:
// "БИФИТ Касса"
'BifitActionsAdmin' => 'bifitactions',
[скриншот simpla_indexadmin_01-2.png]
---------------------------------------------
4. Файл /simpla/OrderAdmin.php
Строка №127 с кодом "}"
[скриншот simpla_orderadmin_01-1.png]
После закрывающей фигурной скобки, с новой строки вставляем:
// БИФИТ Касса
$this->bifitactions->process($order->id);
[скриншот simpla_orderadmin_01-2.png]
---------------------------------------------
5. Файл /simpla/design/html/index.tpl
Строка №96 с кодом "</ul>"
[скриншот simpla_design_index_01-1.png]
Перед указанной выше строкой, вставляем код:
<!-- БИФИТ Касса (старт) -->
{if in_array('bifitactions', $manager->permissions)}
<li><a href="index.php?module=BifitActionsAdmin"><img src="design/images/menu/bifit.png"><b>БИФИТ Касса</b></a></li>
{/if}
<!-- БИФИТ Касса (финиш) -->
[скриншот simpla_design_index_01-2.png]
Строка №16 с кодом "<meta name="viewport" content="width=1024">"
[скриншот simpla_design_index_02-1.png]
Перед указанной выше строкой, вставляем код:
<!-- БИФИТ Касса (старт) -->
<link href="design/css/bifit.css" rel="stylesheet" type="text/css" />
<!-- БИФИТ Касса (финиш) -->
[скриншот simpla_design_index_02-2.png]
---------------------------------------------
6. Файл /simpla/design/html/manager.tpl
Строка №83 с кодом "{$perms = ["
[скриншот simpla_design_manager_01-1.png]
После открывающей квадратной скобки, с новой строки вставляем код:
'bifitactions' =>'БИФИТ Касса транзакции',
[скриншот simpla_design_manager_01-2.png]
---------------------------------------------
7. Файл /view/OrderView.php
Строка №127 с кодом "// Выводим заказ"
[скриншот simpla_view_order_01-1.png]
Перед указанной выше строкой, вставляем код:
// БИФИТ Касса
$this->bifitactions->process($order->id);
[скриншот simpla_view_order_01-2.png]
РЕЗУЛЬТАТ
-------------------------------------------------
После установки, в админ-панели сайта появится новый пункт меню "БИФИТ Касса" (крайний справа). На странице данного пункта будет две вкладки: "Настройки" (параметры для заполнения) и "Отчёты" (список проведённых транзакций).
[скриншот simpla_settings.png]
[скриншот simpla_reports.png]
1. На странице настроек модуля "БИФИТ Касса" выбираем и заполняем нужные параметры:
  1.1. Выбираем и заполняем нужные параметры:
        1.1.1.  Тестовый или Основной режим работы расширения.
        1.1.2.  Заполняем полученный токен доступа необходимый для боевого режима работы.
        1.1.3.  Вводим фамилию и инициалы кассира, например Иванов И.И.
        1.1.4.  Вводим ИНН кассира (12-ть цифр для РФ).
        1.1.5.  Вводим место расчёта, например домен сайта, строго по форме (с http или https): https://site.ru
        1.1.6.  Выбираем, что выводить в адресе клиента: e-mail или телефон.
        1.1.7.  Выбираем выводить или нет ФИО клиента.
        1.1.8.  Выбираем признак способа расчёта.
        1.1.9.  Выбираем тип оплаты.
        1.1.10. Выбираем режим назначения НДС.
        1.1.11. Выбираем ставку НДС.
  1.2. Выбираем какие типы документов нужно использовать (можно все). Для каждого нужного типа необходимо выбрать:
        1.2.1.  Активируем использование данного типа документа.
        1.2.2.  Выбираем нужно ли учитывать оплату заказа.
        1.2.3.  Выбираем систему налогообложения для данного типа документа.
        1.2.4.  Выбираем способ(ы) оплаты для активации данного типа документа.
        1.2.5.  Выбираем статус заказа для активации данного типа документа. У каждого типа документа должен быть свой статус, то есть нельзя использовать один и тот же статус более чем для одного типа документа.
  1.3. Сохраняем изменённые параметры.
2. На странице "Отчёты" будут отображены все проведённые транзакции (последние самые первые) с подробной информацией по каждой их них.
|}}
|}}

Версия 14:08, 12 мая 2022

==Техническая поддержка==

При необходимости, в рабочее время, Вы можете обратиться в тех-поддержку компании "БИФИТ Касса" и наши специалисты быстро и качественно установят модуль на Вашем сайте (при условии предоставления временного FTP-доступ к файлам сайта). Мы также можем доработать наше расширение согласно требованиям Вашего тех-задания (ТЗ).


Перед установкой, настоятельно рекомендуем сделать бэкап (резервную копию) файлов сайта. Для этого откройте меню Автоматизация Бэкап и нажмите кнопку "Создать бэкап", после чего будет создан файл резерва. Далее, в случае непредвиденной проблемы, вернитесь на эту страницу и нажмите на значок восстановления напротив созданного ранее файла.

ИНСТРУКЦИЯ

Из-за конструктивных особенностей CMS "Simpla", для установки модуля "БИФИТ Касса", потребуется доступ к файлам сайта (FTP-доступ). Далее, необходимо выбрать один из двух способов установки: "Быстрый" или "Обычный". Быстрый способ доступен только в том случае, если файлы из списка ниже никогда не редактировались (не изменялись для других расширений Вами или сторонними специалистами) — список файлов:

  1. /api/Managers.php
  2. /api/Simpla.php
  3. /simpla/IndexAdmin.php
  4. /simpla/OrderAdmin.php
  5. /simpla/design/html/index.tpl
  6. /simpla/design/html/manager.tpl
  7. /view/OrderView.php


БЫСТРЫЙ СПОСОБ (файл "quick.zip")

Если Вы точно уверены, что файлы из списка выше никогда не изменялись, то понадобится всего лишь загрузить и распаковать архивный файл "quick.zip" в корневой папке сайта — при этом существующие файлы будут заменены файлами из архива (если в процессе распаковки система укажет, что файлы уже существуют, то выберите замену существующих файлов). Альтернативный вариант — распаковать файл "quick.zip" на компьютере в папке "quick", после чего перенести всё содержимое данной папки в корень сайта (так же с заменой существующих файлов).

ОБЫЧНЫЙ СПОСОБ (файл "normal.zip")


Если Вы не уверены или не знаете наверняка о изменениях в файлах из списка выше, то в таком случае потребуется сделать следующие два шага: Шаг 1. Загрузить и распаковать архивный файл "normal.zip" в корневой папке сайта — все файлы новые, поэтому никаких замен не будет. Шаг 2. Открыть и добавить небольшой блок кода в каждый из перечисленных ниже файлов: --------------------------------------------- 1. Файл /api/Managers.php Строка №16 с кодом "public $permissions_list = array(" [скриншот simpla_api_managers_01-1.png] После открывающей скобки вставляем: 'bifitactions', [скриншот simpla_api_managers_01-2.png] --------------------------------------------- 2. Файл /api/Simpla.php Строка №15 с кодом "private $classes = array(" [скриншот simpla_api_simpla_01-1.png] После открывающей скобки, с новой строки вставляем: // БИФИТ Касса 'bifitactions' => 'Bifitactions', [скриншот simpla_api_simpla_01-2.png] --------------------------------------------- 3. Файл /simpla/IndexAdmin.php Строка №10 с кодом "private $modules_permissions = array(" [скриншот simpla_indexadmin_01-1.png] После открывающей скобки, с новой строки вставляем: // "БИФИТ Касса" 'BifitActionsAdmin' => 'bifitactions', [скриншот simpla_indexadmin_01-2.png] --------------------------------------------- 4. Файл /simpla/OrderAdmin.php Строка №127 с кодом "}" [скриншот simpla_orderadmin_01-1.png] После закрывающей фигурной скобки, с новой строки вставляем: // БИФИТ Касса $this->bifitactions->process($order->id); [скриншот simpla_orderadmin_01-2.png] --------------------------------------------- 5. Файл /simpla/design/html/index.tpl

Строка №96 с кодом ""

[скриншот simpla_design_index_01-1.png] Перед указанной выше строкой, вставляем код: {if in_array('bifitactions', $manager->permissions)}

  • <a href="index.php?module=BifitActionsAdmin"><img src="design/images/menu/bifit.png">БИФИТ Касса</a>
  • {/if} [скриншот simpla_design_index_01-2.png] Строка №16 с кодом "<meta name="viewport" content="width=1024">" [скриншот simpla_design_index_02-1.png] Перед указанной выше строкой, вставляем код: <link href="design/css/bifit.css" rel="stylesheet" type="text/css" /> [скриншот simpla_design_index_02-2.png] --------------------------------------------- 6. Файл /simpla/design/html/manager.tpl Строка №83 с кодом "{$perms = [" [скриншот simpla_design_manager_01-1.png] После открывающей квадратной скобки, с новой строки вставляем код: 'bifitactions' =>'БИФИТ Касса транзакции', [скриншот simpla_design_manager_01-2.png] --------------------------------------------- 7. Файл /view/OrderView.php Строка №127 с кодом "// Выводим заказ" [скриншот simpla_view_order_01-1.png] Перед указанной выше строкой, вставляем код: // БИФИТ Касса $this->bifitactions->process($order->id); [скриншот simpla_view_order_01-2.png] РЕЗУЛЬТАТ

    После установки, в админ-панели сайта появится новый пункт меню "БИФИТ Касса" (крайний справа). На странице данного пункта будет две вкладки: "Настройки" (параметры для заполнения) и "Отчёты" (список проведённых транзакций).

    [скриншот simpla_settings.png] [скриншот simpla_reports.png]

    1. На странице настроек модуля "БИФИТ Касса" выбираем и заполняем нужные параметры:

      1.1. Выбираем и заполняем нужные параметры:
           1.1.1.  Тестовый или Основной режим работы расширения.
           1.1.2.  Заполняем полученный токен доступа необходимый для боевого режима работы.
           1.1.3.  Вводим фамилию и инициалы кассира, например Иванов И.И.
           1.1.4.  Вводим ИНН кассира (12-ть цифр для РФ).
           1.1.5.  Вводим место расчёта, например домен сайта, строго по форме (с http или https): https://site.ru
           1.1.6.  Выбираем, что выводить в адресе клиента: e-mail или телефон.
           1.1.7.  Выбираем выводить или нет ФИО клиента.
           1.1.8.  Выбираем признак способа расчёта.
           1.1.9.  Выбираем тип оплаты.
           1.1.10. Выбираем режим назначения НДС.
           1.1.11. Выбираем ставку НДС.
      1.2. Выбираем какие типы документов нужно использовать (можно все). Для каждого нужного типа необходимо выбрать:
           1.2.1.  Активируем использование данного типа документа.
           1.2.2.  Выбираем нужно ли учитывать оплату заказа.
           1.2.3.  Выбираем систему налогообложения для данного типа документа.
           1.2.4.  Выбираем способ(ы) оплаты для активации данного типа документа.
           1.2.5.  Выбираем статус заказа для активации данного типа документа. У каждого типа документа должен быть свой статус, то есть нельзя использовать один и тот же статус более чем для одного типа документа.
      1.3. Сохраняем изменённые параметры.
    

    2. На странице "Отчёты" будут отображены все проведённые транзакции (последние самые первые) с подробной информацией по каждой их них.

    Название: Плагин для CMS SIMPLA
    Версия: 1.2.3
    CMS: SIMPLA CMS (версия 2.3.8)
    Simpla logo.png
    Ссылка на плагин: скачать