Pages, Articles & News
Tools & Plugins
Example / Placeholder Title


Description as an example placeholder. Sample text content for further customization of the "Index36" template.

You are free to edit and customize the template however you like. If you don’t have time or enough knowledge — you can always order template adaptation by contacting me via GitHub or private messages on the digital goods marketplace.

2025-03-19 04:19
Avatar" alt="" class="rounded-circle border border-2 border-light" width="54" height="54">

Описание

Плагин "Статьи пользователей" — это простой и удобный инструмент для сайтов на Cotonti CMF. Он позволяет показать список пользователей с количеством их статей и подробный список статей каждого пользователя. Отлично подходит для сообществ, блогов или любых сайтов, где важно показать контент от пользователей.

Возможности

  • Список пользователей: Показывает всех пользователей и количество их опубликованных статей.
  • Детали статей: Отображает полный список статей выбранного пользователя с категорией, заголовком, датой публикации, датой обновления и количеством просмотров.
  • Пагинация: Удобная навигация по списку пользователей и статей в стиле Bootstrap 5.3.3.
  • Локализация: Поддержка русского (ru) и английского (en) языков с возможностью настройки.
  • Настраиваемые лимиты: Можно указать максимальное число пользователей или статей на странице через админ-панель.

Протестировано на Cotonti 0.9.26 с PHP 8.2.


Установка

Чтобы установить плагин "Статьи пользователей" на сайт под управлением Cotonti, выполните следующие шаги:

Требования

  • Установленная Cotonti CMF (версия 0.9.26 или совместимая).
  • PHP 8.2 или выше.
  • Доступ к файлам сайта (через FTP, SFTP или панель управления).

Инструкция

  1. Скачайте плагин скачайте ZIP-архив с GitHub:
  • Если скачали ZIP, распакуйте его.
  1. Загрузите файлы
  • Скопируйте папку userarticles в директорию plugins вашего сайта Cotonti (например, path/to/cotonti/plugins/).
  1. Установите через админ-панель
  • Войдите в админ-панель Cotonti (например, yourwebsite.com/admin).
  • Перейдите в Расширения (Администрирование > Расширения).
  • Найдите "Статьи пользователей" в списке доступных плагинов.
  • Нажмите Установить. Это подключит плагин и настроит его хуки в базе данных.
  1. Настройте параметры (по желанию)
  • В админ-панели перейдите в Конфигурация (Администрирование > Конфигурация).
  • Выберите "Статьи пользователей" в списке плагинов.
  • Измените настройки, если нужно:
  • Максимальное число статей на странице: По умолчанию 25.
  • Максимальное число пользователей на странице: По умолчанию 20.
  • Сохраните изменения.
  1. Проверьте работу
  • в любом месте своей темы подключите ссылку на плагин по примеру вида:
  	<li>
  	  <a class="uk-link-muted" href="{PHP|cot_url('plug', 'e=userarticles')}">
  		<span class="uk-margin-small-x uk-light">
  		  <i class="fa-solid fa-file-lines fa-xl"></i>
  		</span>
  		<span class="uk-text-middle">{PHP.L.userarticles_title}</span>
  	  </a>
  	</li>
  • Откройте страницу плагина на сайте: yourwebsite.com/index.php?e=userarticles.
  • Вы увидите список пользователей с количеством их статей.
  • Кликните по имени пользователя, чтобы посмотреть его статьи: yourwebsite.com/index.php?e=userarticles&action=details&uid=[user_id].

Использование

  • Страница со списком пользователей: Показывает всех пользователей с ссылками на их статьи.
  • Страница с деталями статей: Выводит таблицу статей выбранного пользователя с пагинацией, если статей больше, чем указано в настройках.
  • Поддержка языков: Плагин использует язык сайта (русский или английский). Добавьте новые языки, создав файлы userarticles.[lang].lang.php в папке lang.

Состав плагина

  • userarticles.php: Основная логика плагина.
  • userarticles.tpl: Шаблон для списка пользователей.
  • userarticles.details.tpl: Шаблон для списка статей пользователя.
  • lang/userarticles.en.lang.php: Локализация на английском.
  • lang/userarticles.ru.lang.php: Локализация на русском.

Настройка

  • Шаблоны: Измените userarticles.tpl и userarticles.details.tpl, чтобы адаптировать дизайн под ваш сайт (по умолчанию используется Bootstrap 5.3.3).
  • Локализация: Отредактируйте или добавьте языковые файлы в папке lang.
  • Параметры: Установите лимиты пагинации в админ-панели.

Замечания

  • Убедитесь, что на вашем сайте включены модули page и users, так как плагин зависит от них.
  • Стилизация выполнена под Bootstrap 5.3.3, но вы можете адаптировать шаблоны под другие фреймворки.
  • в папке plugins/userarticles/tpl/tpl_for_UIkit_3 лежат шаблоны для UIkit 3 Если вы используете UIkit 3, то эти два шаблона userarticles.details.tpl и userarticles.tpl нужно скопировать в папку с вашей темой по адресу:
    /themes/myskin/plugins/userarticles
    где "myskin" - название вашей темы (основной шаблон сайта) и разумеется создать такие папки, если их нет

Как помочь проекту

Если найдёте ошибки или захотите улучшить плагин, создавайте issues или pull requests на GitHub!

 


Скачать исходный код плагина с репозитория на GitHub

This post was edited by webitproff (2025-06-16 06:10, 1 year ago)
Account