Розбіжності

Тут показані розбіжності між вибраною ревізією та поточною версією сторінки.

--- stigma [2023/09/27 23:04]
nightfly
+++ stigma [2023/11/04 13:10] (поточний)
nightfly [Типи рендерингу]
@@ Рядок 9: / Рядок 9: @@
 [stigmasettings]
 TYPE=radiolist
+BASECLASS=dashtask
 ACTIVECLASS=todaysig
 ANIMATION=1
+RENDERER=iconic
 [buy]
@@ Рядок 27: / Рядок 29: @@
 ===== Коротко про формат конфігурації =====
-Секція "stigmasettings" є службовою та обов'язковою. Вона вказує на базову поведінку контролів у конкретному скоупі. Можливі типи (TYPE) на даний момент "radiolist" (вибір одного з усіх) або "checklist" (множинна вибірка). ANIMATION просто вказує, чи оновлювати з супутньою анімацією контейнер стигмати під час зміни стану, чи робити це "тихо і непомітно". Оскільки стан "купив у нас роутер" не може бути одночасно і "купив", і "не купив", ми використовуємо тип "radiolist". Опція ACTIVECLASS вказує просто, яким CSS-класом будуть підсвічуватися активні/вибрані стани об'єктів у межах цього scope.
+Секція "stigmasettings" є службовою та обов'язковою. Вона вказує на базову поведінку контролів у конкретному скоупі. Можливі типи (TYPE) на даний момент "radiolist" (вибір одного з усіх) або "checklist" (множинна вибірка). ANIMATION просто вказує, чи оновлювати з супутньою анімацією контейнер стигмати під час зміни стану, чи робити це "тихо і непомітно". Оскільки стан "купив у нас роутер" не може бути одночасно і "купив", і "не купив", ми використовуємо тип "radiolist". Опція ACTIVECLASS вказує просто, яким CSS-класом будуть підсвічуватися активні/вибрані стани об'єктів у межах цього scope. Починаючи з Ubilling 1.4.1 також можна опційно вказувати і BASECLASS, який буде використовуватись для всіх контролів за замовчуванням. Так, це теж ім'я CSS класу.
 Далі всі секції, які не є stigmasettings, описують конкретні стани об'єктів (items) у межах конкретного SCOPE. Їх може бути скільки завгодно. Ім'я секції власне буде ідентифікатором стану, що зберігається в БД, і має бути якомога коротшим та унікальним. Базовими характеристиками стану крім його ідентифікатора є NAME (ім'я) і ICON (ви не повірите! іконка). Іконки станів за замовчуванням зберігаються в **skins/stigma/** з розширенням ***.png**.
@@ Рядок 150: / Рядок 152: @@
 що призведе до завантаження даних про стани тільки для айтема $userLogin у межах scop-а USERBUYROUTER у процесі створення інстансу, і цілком собі дасть нам змогу з ними працювати. Але тільки ось для цього конкретного $userLogin.
+===== Логування змін станів =====
+Базово, підтримується три різноманітні режими логування змін станів, якщо вам це необхідно: TASKMAN, SYSTEM, CUSTOM.
+  * TASKMAN:[стан] - запис до логу "Планування робіт".
+  * SYSTEM:[стан] - запис до системного журналу подій.
+  * CUSTOM:[таблиця] - запис до довільної таблиці в БД.
+Для логування до довільної таблиці, її структура має мати наступний формат:
+<code sql>
+CREATE TABLE IF NOT EXISTS `somecustomlog` (
+  `id` INT(11) NOT NULL AUTO_INCREMENT,
+  `date` datetime NOT NULL,
+  `admin` VARCHAR(64) DEFAULT NULL,
+  `scope` VARCHAR(64) DEFAULT NULL,
+  `itemid` VARCHAR(128) NOT NULL,
+  `action` VARCHAR(32) DEFAULT NULL,
+  `state` VARCHAR(255) DEFAULT NULL,
+   PRIMARY KEY (`id`),
+   KEY `scope` (`scope`),
+   KEY `itemid` (`itemid`)
+) ENGINE=MyISAM DEFAULT CHARSET=utf8 AUTO_INCREMENT=1;
+</code>
+Логування TASKMAN: ви не використовуватимете з ймовірністю 99%, з логуванням SYSTEM:[стан] який ви можете ввімкнути при виклику обробника коллбеків, наступним чином:
+<code php>
+   $leadSource->stigmaController('SYSTEM:якийсь_стан');
+</code>
+в системному лозі з'являтимуться записи наступного вигляду
+<code>
+STIGMA [поточний_SCOPE] CHANGE [ідентифікатор_айтема] `[якийсь_стан]` ON `[ідентифікатор_стану]`
+</code>
+Чим буде заповнюватись табличка somecustomlog при логуванні CUSTOM:somecustomlog викликаному отак:
+<code php>
+   $leadSource->stigmaController('CUSTOM:somecustomlog');
+</code>
+теж доволі зрозуміло з іменування її полів.
+===== Типи рендерингу =====
+Починаючи з Ubilling 1.4.1 в секції конфігурації [stigmasettings] також можна опційно встановити опцію **RENDERER**, яка прямо вказує на тип відображення контролів конкретної стигми.
+Можливі значення опції на даний момент:
+  * iconic  - рендерер, за замовчуванням у вигляді "натискаємих іконок". Він же використовується у випадку якщо опція RENDERER відсутня.
+  * selector - просто стандартний селектор у вигляді "вибирушки". Працює тільки з TYPE=radiolist, що доволі очевидно.
+  * textlink - зображає всі наявні стани в скоупі у вигляді простих текстових посилань.
+  * imagelink - зображає всі наявні стани в скоупі у вигляді простих текстових посилань з маленькими іконками станів.

Ubilling Wiki

Користувальницькькі налаштування

Налаштування сайту

Розбіжності

Налаштування сторінки