Плагин "Статьи пользователей" для Cotonti

Плагин "Статьи пользователей" — это простой и удобный инструмент для сайтов на 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, распакуйте его.

2. Загрузите файлы

• Скопируйте папку userarticles в директорию plugins вашего сайта Cotonti (например, path/to/cotonti/plugins/).

3. Установите через админ-панель

• Войдите в админ-панель Cotonti (например, yourwebsite.com/admin).
• Перейдите в Расширения (Администрирование > Расширения).
• Найдите "Статьи пользователей" в списке доступных плагинов.
• Нажмите Установить. Это подключит плагин и настроит его хуки в базе данных.

4. Настройте параметры (по желанию)

• В админ-панели перейдите в Конфигурация (Администрирование > Конфигурация).
• Выберите "Статьи пользователей" в списке плагинов.
• Измените настройки, если нужно:
• Максимальное число статей на странице: По умолчанию 25.
• Максимальное число пользователей на странице: По умолчанию 20.
• Сохраните изменения.

5. Проверьте работу

• в любом месте своей темы подключите ссылку на плагин по примеру вида:

  	<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