Плагин "Статьи пользователей" для 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 или панель управления).
Инструкция
- Скачайте плагин скачайте ZIP-архив с GitHub:
- Если скачали ZIP, распакуйте его.
- Загрузите файлы
- Скопируйте папку
userarticles в директорию plugins вашего сайта Cotonti (например, path/to/cotonti/plugins/).
- Установите через админ-панель
- Войдите в админ-панель Cotonti (например,
yourwebsite.com/admin).
- Перейдите в Расширения (
Администрирование > Расширения).
- Найдите "Статьи пользователей" в списке доступных плагинов.
- Нажмите Установить. Это подключит плагин и настроит его хуки в базе данных.
- Настройте параметры (по желанию)
- В админ-панели перейдите в Конфигурация (
Администрирование > Конфигурация).
- Выберите "Статьи пользователей" в списке плагинов.
- Измените настройки, если нужно:
- Максимальное число статей на странице: По умолчанию 25.
- Максимальное число пользователей на странице: По умолчанию 20.
- Сохраните изменения.
- Проверьте работу
-
Откройте страницу плагина на сайте: 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
Тема поддержи и обсуждение плагина.
3 минут чтения Sodium Carbonate