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

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


adcomments

Розбіжності

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

Посилання на цей список змін

Порівняння попередніх версій Попередня ревізія
Наступна ревізія
Попередня ревізія
adcomments [2023/05/19 15:54]
nightfly
adcomments [2023/05/19 16:04] (поточний)
nightfly
Рядок 1: Рядок 1:
 ====== Додаткові примітки ====== ====== Додаткові примітки ======
  
-В Ubilling починаючи зі стабільного релізу 0.6.1з'явилася можливість використати у модулях загальну реалізацію додаткових коментарів.\\+В Ubilling починаючи зі стабільного релізу 0.6.1 з'явилась можливість використовувати у модулях загальну реалізацію додаткових коментарів.\\
 З точки зору юзабіліті, це має виглядати як... грубо форум з розділами, що є по своїй суті представленнями сутностей білінгу, і топіками прив'язаними до конкретних об'єктів у рамках цих сутностей.\\  З точки зору юзабіліті, це має виглядати як... грубо форум з розділами, що є по своїй суті представленнями сутностей білінгу, і топіками прив'язаними до конкретних об'єктів у рамках цих сутностей.\\ 
 З точки зору інтеграції в якийсь абстрактний модуль, який працює з якимись абстрактними об'єктами, все дуже просто: З точки зору інтеграції в якийсь абстрактний модуль, який працює з якимись абстрактними об'єктами, все дуже просто:
Рядок 20: Рядок 20:
 В результаті отримуємо щось на кшталт такого:\\ В результаті отримуємо щось на кшталт такого:\\
  
-{{:adcommentsdev1.png?|}}+{{:undefined:adcommentsdev2.png|}}
  
-Все формочки для создания,редактирования,удаления примечаний - полностью самодостаточны, и присутствуют в возвращаемом методом renderComments() результате.  +Всі формочки для створення, редагування, видалення приміток - повністю самодостатні, і присутні у результаті, що повертається методом renderComments(). 
-Итого, в сухом остатке - две строчки. Создали объект класса ADcomments + показали ему, для кого хотим комментарии. Куда проще? +У сухому залишку - два рядки на все. Створили об'єкт класу ADcomments+, показали йому, для кого хочемо коментарі. Куди простіше?
  
-А что если мы хотим предварительно показать для каких объектов в списке, уже есть существующие дополнительные примечания, но не хотим дергать базу по этому поводу каждый раз? А все так же очень просто. Для этого в ADcomments начиная с Ubilling 0.6.2 появились несколько прубличных метододов: haveComments (возвращает bool) и getCommentsIndicator (возвращает string) а также getCommentsCount (int). Параметром для них передается конкретный item в ранее инициализированном конструктором scope. Относительно нашего предыдущего абстрактного примера это должно выглядеть как-то так: +А якщо ми хочемо попередньо показати для яких об'єктів у списку, вже є існуючі додаткові примітки, але не хочемо смикати базу з цього приводу щоразу? А так само дуже просто. Для цього в ADcomments є декілька публічних методів: haveComments (повертає bool) і getCommentsIndicator (повертає string) та getCommentsCount (повертає int). Параметром для них передається конкретний item у раніше ініціалізованому конструктором scope. Щодо нашого попереднього абстрактного прикладу це має виглядати якось так:
  
 <code php> <code php>
-//допустим, что все объекты нашего абстрактного модуля лежат в массиве $all вида $itemId=>$itemData+//припустимо, що всі об'єкти нашого абстрактного модуля лежать у масиві $all вигляду $itemId=>$itemData
  
         $altCfg=$ubillingConfig->getAlter();         $altCfg=$ubillingConfig->getAlter();
         if ($altCfg['ADCOMMENTS_ENABLED']) {         if ($altCfg['ADCOMMENTS_ENABLED']) {
-            // Один раз создали объект. Забыли.+            // Один раз створили об'єкт та забули
             $adcomments=new ADcomments('ABSTRACTMODULE');             $adcomments=new ADcomments('ABSTRACTMODULE');
         }         }
                  
         if (!empty($all)) {         if (!empty($all)) {
-         // перебираем айтемы поштучно+         // перебираємо айтеми поштучно
           foreach ($all as $id=>$data) {           foreach ($all as $id=>$data) {
-          //не забываем проверять, включена ли фича, и соответственно есть ли у кого спрашивать.+          //не забуваємо перевіряти, чи включена фіча, і відповідно чи є у кого запитувати
            if ($altCfg['ADCOMMENTS_ENABLED']) {            if ($altCfg['ADCOMMENTS_ENABLED']) {
-             //получаем иконку дополнительных комментариев если они присутствуют для него. Вторым параметром можно передать размер.+             //отримуємо іконку додаткових коментарів, якщо вони присутні для нього. Другим параметром можна передати розмір.
              $indicatorIcon=$adcomments->getCommentsIndicator($id);              $indicatorIcon=$adcomments->getCommentsIndicator($id);
                            
-             //ну и если хотим какой-то флаг поднять - вот вам булевое значение+             //ну і якщо хочемо якийсь флажок підняти - ось вам булеве значення
              $adcommentsFlag=$adcomments->haveComments($id);              $adcommentsFlag=$adcomments->haveComments($id);
                            
-             //также можем отдельно получить количество комментариев для айтема. Да 0 - если нету. +             //також можемо окремо отримати кількість коментарів для айтему. Так 0 - якщо нема 
-             $adcommentsFlag=$adcomments->getCommentsCount($id);+             $adcommentsCount=$adcomments->getCommentsCount($id);
              }              }
           }            } 
adcomments.1684500844.txt.gz · Востаннє змінено: 2023/05/19 15:54 повз nightfly