# =========================================================================== #
# NG CMS // Плагины // Другие новости от пользователя                         #
# =========================================================================== #

## Модернизация с ng-helpers v0.2.2 (2026-02-03)

- Заменено `cacheRetrieveFile/cacheStoreFile` на `cache_get/cache_put`
- Добавлено логирование операций кеша (`engine/logs/other_user_news.log`)
- Требуется **PHP 8.0+** и **NGCMS 23b3116+**

---

Плагин позволяет на сайте вывести другие новости от пользователей в полной новости.

Для работы плагина используется единый TWIG шаблон (по умолчанию other_user_news.tpl).
--------------------------------------------------------------------

Поддерживаемые переменные:
  . {{tpl_url}}     - путь к текущему активному шаблону сайта
  . {{author}}      - имя пользователя, добавившего новость
  . {{author_link}} - ссылка на пользователя, добавившего новость

* Цикл {% for entry in entries %}{% endfor %} - шаблон содержимого (строки) информационного блока
  Поддерживаемые переменные:
  . {{entry.title}}         - заголовок новости
  . {{entry.news_url}}      - URL ссылка новости
  . {{entry.short_news}}    - короткая новость
  . {{entry.postdate}}      - дата добавления новости
  Также доступны любые другие переменные, из таблицы news, например:
  . {{entry.views}}   - содержимое поля views

================================================================================
Варианты использования плагина в шаблонах
================================================================================

Пример вызова:
{{ callPlugin('other_user_news.show', {'number' : 2, 'mode' : 'dt'}) }}
{{ callPlugin('other_user_news.show', {'number' : 10, 'mode' : 'view', 'template': 'other_user_news', 'cacheExpire': 60 }) }}

Доступные переменные (передаются в качестве массива параметров после имени 'other_user_news.show':
* number        - кол-во отображаемых новостей
* mode          - режим сортировки новостей (view, com, dt, rnd)
* template      - имя шаблона
* cacheExpire   - срок жизни кеша (по умолчанию = 0)
__________________________________________
  Поддерживаемые функции
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ Генерацию блока при помощи TWIG функции callPlugin()
+ Кеширование
+ Шаблоны плагина внутри шаблона сайта
