Введение

В статье описана настройка веб-версии личного кабинета на Apache.

Система предоставляется "как есть" — без каких-либо гарантий.

Настройка

Система работает при интеграции с сайтом клиента. Для тестовой демонстрации можно воспользоваться Denwer.

  1. Взять с фтп сервера компании ЮСИЭС дистрибутив (ftp:/R-Keeper.CRM/versions/WEB/cardsystem.rar) и развернуть у себя на web-сервере
    Примечание: для данного примера дистрибутив был распакован в папку Денвера c:\denwer\home\LKab.ru\www\.
  2. Получить лицензию от компании ЮСИЭС (короткий код - Global Type - запросить);
  3. Настроить файл config.inc.php (ниже приведен пример, где необходимо все проверить и заполнить).

Шаблон конфигурационного файла config.inc.php

<?php
    /**
    *   Конфигурационная информация Личного Кабинета Карточной Системы
    *   @package      Карточная Система
    * 
    @copyright 
   
      Компания "ЮСиЭс"
    *   @created          2009 - 2010
    // параметры подключения к CardSystem Auth Server
    define( 'CARDSYSTEM_IP', '192.137.137.32' ) ;                 // IP-адрес машины с сервером авторизации карт
    define( 'CARDSYSTEM_PORT', 9191 ) ;                               // TCP-порт сервера авторизации карт
    define( 'CARDSYSTEM_TIMEOUT', 60 ) ;
    define( 'CARDSYSTEM_TERMINAL_TYPE', 'lk13732' ) ;                           // код классификатора ПО из редактора карт R-Keeper CRM
    define( 'CARDSYSTEM_GLOBAL_TYPE', 'mR0ZJq0Vm4RF2VB' ) ;       // код лицензии
    define( 'LANG', 'ru' ) ;                // ru или en
    define( 'CS_ACCOUNT_CLASS_ID', 1 ) ;    // какие классы счетов суммируются в балансе
    // приведенные ниже параметры требуется проверить по базе R-Keeper CRM в SQL Server 2012
    define( 'CS_ADDRESS_TYPE_ID', 250 ) ;                       // идентификатор типа адреса по умолчанию. Посмотреть в таблице CARD_ADDRESS_TYPES
    define( 'CS_CONTACT_MOBILE_TYPE_ID', 251 ) ;      //  идентификатор типа контакта (мобильный телефон). Посмотреть в 
  таблице CARD_CONTACT_TYPES
                                                                                      
    define( 'CS_CONTACT_EMAIL_TYPE_ID', 252 ) ;         //  идентификатор типа контакта (Email). 
  Посмотреть в таблице
   CARD_CONTACT_TYPES
    define( 'CS_SELECTED_COUNTRY_ID', 1 ) ;                        //  идентификатор страны. 
  Посмотреть в таблице 
  CARD_COUNTRIES
    define( 'CS_SELECTED_CITY_ID', '10000000000001' ) ;  //  идентификатор города. 
  Посмотреть в таблице 
  CARD_CITIES
    define( 'CS_ALLOW_ADD_STREET', true ) ;         // позволять добавлять улицы
    define( 'REGISTRATION', true ) ;                // отображать модуль регистрации
    define( 'REGISTRATION_TYPE', 'email' ) ;        // вид регистрации по Email или по SMS (значения - email или sms)
    define( 'SUPPORT_PHONE', '8 800 000 080' ) ;    // телефон поддержки
    define( 'ABOUT_COMPANY_LINK', 'http://localhost/cardsystem1/' ) ;   // ссылка на страницу О Компании  
    define( 'SUPPORT_LINK', 'http://localhost/cardsystem2/' ) ;                   // ссылка на страницу Поддержка
    define( 'HELP_LINK', 'http://localhost/cardsystem3/' ) ;                            // ссылка на страницу Помощь
    // кодировка Кабинета, либо сайта куда встраивается Кабинет
    // windows-1251 или utf-8
    // с этой декларацией отправляется xml к CardSystem Протоколу
    define( 'ENCODING', 'windows-1251' ) ;
    // define( 'ENCODING', 'utf-8' ) ;
    // директория, где располагается часть сайта, управляемая этой CMS. ПРОПИСАТЬ !!!
    define( 'BASE_DIR', '/cardsystem/' ) ;
    // директория, где располагается Личный Кабинет. ПРОПИСАТЬ !!!
    define( 'ADMIN_DIR', '/cardsystem/' ) ;
    // может ли Пользователь Кабинета редактировать свою личную информацию в базе Карточной системы
    define( 'ALLOW_EDIT_PERSONAL_INFO', true ) ;
    define( 'ALLOW_CHANGE_PHOTO', true ) ;
    // перекодировка из UTF-8 в CP1251 - если НЕ РАБОТАЕТ вывод Детализации Транзакции R-Keeper-а,
    // возможно в системе не установлены нужные кодировки для функции ICONV
    // Если их не удаётся настроить - проставьте UTF8_DECODE_TABLE = true
    // - "ручная" перекодировка UTF-8
    define( 'UTF8_DECODE_TABLE', false ) ;
    define( 'CS_DYNAMIC_LOG', 'C:\\Denwer\\home\\LKab.ru\\www\\cardsystem\\log\\cs_dynamic.log' ) ;   // путь к лог-файлу. Необходимо проверить!
?>

Запуск

Для тестирования использовали Denwer и дистрибутив был распакован в директорию c:\denwer\home\LK2.ru\www\.
Соответственно, файл с настройками  c:\denwer\home\LKab.ru\www\cardsystem\config.inc.php

После открытия страницы по адресу http://lkab.ru/cardsystem/ вы увидите следующее окно: 

После ввода номера карты и пароля вы попадаете в окно с личной информацией клиента, а также информацией о картах, счетах и транзакциях.

Настройка авторизации в личном кабинете

В конфигураторе настроить связь с смс-провайдером (Карточная система-SMS) или smtp-сервером (Карточная система - SMTP) и выбрать группу владельцев на вкладке Карточная система-Сервер авторизации(API).
В редакторе карт должен быть заполнен справочник Типы контактов: телефон и эл.почта, если отсутствуют.
В файле config.inc.php проверить заполненность параметров:

    define( 'CS_CONTACT_MOBILE_TYPE_ID', 253 ) ;    // тип контакта - мобильный телефон
    define( 'CS_CONTACT_EMAIL_TYPE_ID', 252 ) ;     // тип контакта - Email
    define( 'REGISTRATION', true ) ;                // отображать модуль регистрации
    define( 'REGISTRATION_TYPE', 'email' ) ;        // вид регистрации по Email или по SMS. Принимает значения - email или sms.