This is a plugin for creating lists of menu items in a documentation section or a knowledge base of an information or software product.
It works on the selected parent category and all its child categories, including articles published in them.
Plugin for CMF Cotonti Siena 0.9.26+
Version: 2.2.8
License: BSD
Author: webitproff
GitHub: https://github.com/webitproff/cot-menubyparentcat
cot-menubyparentcat is a plugin for manually constructing a menu based on the selected parent category of the Page module.
The cot-menubyparentcat plugin was created specifically to give theme developers, module authors, plugin creators, and website owners using Cotonti Siena a full‑featured, convenient, and flexible tool for building online documentation, user guides, knowledge bases, or internal product wikis.
This is exactly the case when standard auto-generated Cotonti menus (based on category structure or tags) are not suitable:
- they do not allow control over item order
- drafts or technical pages cannot be hidden
- sections cannot be renamed into short and clear menu titles
- no way to place important pages (“Introduction”, “Installation”, “FAQ”) at the top
cot-menubyparentcat solves all these problems at once.
-
Documentation for a theme
Example: you released a premium theme for Cotonti.
You need a “Documentation” section with a clear structure:
Introduction → Installation → Configuration → Components → FAQ → Updates
Using this plugin, you create the root categorytheme-docs, add the needed subsections and pages in the required order — and you get a perfect menu like https://adminlte.io/themes/v4/docs/ -
User guide for a plugin or module
You developed a complex plugin (store, freelance marketplace, CRM).
Customers need a detailed manual.
cot-menubyparentcat allows you to build a menu like:
Overview → Registration → Creating a Project → Payment → Disputes → API
And you can hide pages still under development. -
Knowledge base for a SaaS product
You have an online service based on Cotonti.
You need a “Help” section with:
Tasks → Services → Wallet → Security → Rules
Each section may have dozens of articles, but you display only key ones and hide unfinished materials. -
Technical documentation for a framework/library
You ported Bootstrap, Tailwind, or another UI kit to Cotonti.
You create documentation like the official one:
https://getbootstrap.com/docs/5.3/getting-started/introduction/
The plugin allows replicating such structure and behavior.
| Feature | Why it is critical for documentation |
|---|---|
| Manual ordering of items | Sections follow the logic of learning: from simple to advanced |
| Hiding pages without deleting | You can keep drafts invisible to users |
| Title override | Long page titles → short readable labels in the menu |
| Category labels (separators) | Clear visual separation of major documentation blocks |
| Direct links outside categories | Important pages like “Introduction” and “Quick Start” always stay at the top |
| Auto‑highlight of the current item | Users always see where they are in the structure |
| Accordion with article counters | Modern UX similar to official documentation sites |
User Guide
├── Introduction
├── Quick Start
├── Registration and Profile
├── Tasks and Projects
│ ├── Creating a Task
│ ├── Choosing a Contractor
│ ├── Work Stages
│ └── Disputes and Arbitration
├── Services
│ ├── Creating a Service
│ ├── Packages and Add-ons
│ └── Reviews
├── Payments and Wallet
│ ├── Top-up
│ ├── Withdrawal
│ └── Transaction History
├── Security
└── Frequently Asked Questions
All elements above are either category separators or manually added pages.
Order, visibility, and titles are fully under your control.
Key conclusion and main purpose:
This is a specialized tool for creating professional online documentation for software or any other product.
Using Cotonti + menubyparentcat you can easily create documentation for your developments or products and organize its menu so users quickly find the needed instructions.
menubyparentcat is not just “another menu,” like my plugin Tree Cats Page Plugin for Cotonti Siena 0.9.26 — menubyparentcat is an evolution and an essential component of any information product.
Without well‑structured documentation and author support (plugins, modules, templates, scripts, programs, etc.), users will have difficulties learning and using your product — free or paid.
Here are a few examples of what you can build in terms of your own online documentation:
- GitHub Documentation
- MODX Documentation
- AdminLTE 4 (Admin Dashboard Template/theme and Documentation)
- Sneat Dashboard Tamplate Documentation
- DataLife Engine Documentation
- OpenCart Documentation
- Automatic Price List Processing Module
- UIkit v3 – lightweight and modular front-end framework
The plugin menubyparentcat allows you to:
- manually control menu structure
- sort categories and pages in any order
- hide individual items without deleting
- override titles
- add pages outside category structure
- use categories as section headers
Ideal for building:
- help sections
- user manuals
- complex FAQ structures
- groups of menus with fully custom structure
- Cotonti: Siena 0.9.26+
- PHP: 8.1+ (recommended 8.4)
- MySQL: 8.0+
- Page module: required
The plugin does not conflict with other menus and does not override Cotonti core functions.
- Download the archive: https://github.com/webitproff/cot-menubyparentcat
- Unpack to
plugins/menubyparentcat - In admin panel: Plugins → Installation → menubyparentcat → Install
- After installation open: Admin → Other → Menu by Parent Category
In the admin panel specify:
Parent category code
Examples:
user-guidehelpdocs
This code is taken from Pages → Category Code.
After saving you can add menu items.
Each item has the following parameters:
- Category (cat) — menu section + automatic loading of pages inside it
- Page (page) — direct link to a page
- Category code / Page ID — depends on selected type
- Sort order — integer, smaller means higher
- Title override — custom name if needed
- Include in menu — allows hiding the item
- edit item
- delete item
- change order via numeric values
- prevent duplicates — a page is never shown twice
In any template (e.g. sidebar.tpl):
{PHP|cot_menubyparentcat_build_tree('user-guide')}
If category code is set in plugin settings:
{PHP|cot_menubyparentcat_build_tree()}
Example:
<div class="sidebar-menu">
<h5>Help</h5>
{PHP|cot_menubyparentcat_build_tree('user-guide')}
</div>The plugin uses:
menubyparentcat.tree.tpl
Features:
- Bootstrap 5 menu structure
- collapsible submenus
- alias (SEO URL) support
- active item highlighting
- category rendering with subpages
- direct-page rendering
- full manual control of menu structure
- title overrides
- hidden items support
- direct links to specific pages
- automatic loading of all pages in a category
- duplicate prevention
- correct URL generation
- high performance (indexed queries)
- Repository: https://github.com/webitproff/cot-menubyparentcat
- Issues: use for bugs and feature requests
- Pull Requests: welcome
- Plugin is distributed under the BSD license
If the plugin is useful — please ⭐ the GitHub repo!
© webitproff, 27 Nov 2025, License BSD.
send me a message on this page
Это плагин для создания списков пунктов меню в разделе вашей онлайн-документации или базе знаний, информационного или программного продукта, который разрабатываете, поддерживаете или продаете.
Он работает с выбранной родительской категорией и всеми ее дочерними категориями, включая опубликованные в них статьи. Меню по родительским категориям для CMF Cotonti Siena версии 0.9.26, PHP версии 8.4+, MySQL версии 8.0
Плагин для CMF Cotonti Siena 0.9.26+
Версия: 2.2.8
Лицензия: BSD
Автор: webitproff
GitHub: https://github.com/webitproff/cot-menubyparentcat
cot-menubyparentcat — плагин для ручного конструирования меню на основе выбранной родительской категории модуля Page.
Плагин cot-menubyparentcat создан специально для одной целью — дать разработчикам тем, модулей, плагинов и владельцам сайтов на Cotonti Siena полноценный, удобный и красивый инструмент для создания онлайн-документации, руководства пользователя, базы знаний или внутренней вики по своему продукту.
Это именно тот случай, когда стандартные автогенерируемые меню Cotonti (по структуре категорий или по тегам) не подходят:
- они не дают контроля над порядком пунктов
- нельзя скрыть черновики или технические страницы
- невозможно переименовать разделы под короткие и понятные названия в меню
- нет возможности вынести важные страницы («Введение», «Установка», «ЧаВо») наверх списка
cot-menubyparentcat решает все эти проблемы разом.
-
Документация к теме оформления
Пример: вы выпустили премиум-тему под Cotonti.
Вам нужно сделать раздел «Документация» с чёткой структурой:
Введение → Установка → Настройка → Компоненты → ЧаВо → Обновления
С помощью этого плагина вы создаёте корневую категориюtheme-docs, добавляете туда нужные разделы и страницы в требуемом порядке — и получаете идеальное меню, как у https://adminlte.io/themes/v4/docs/ -
Руководство пользователя для плагина или модуля
Вы разработали сложный плагин (например, магазин, биржу фриланса, CRM).
Покупателям нужна подробная инструкция.
cot-menubyparentcat позволяет сделать меню вида:
Обзор → Регистрация → Создание проекта → Оплата → Споры → API
При этом скрыть страницы, которые ещё в разработке. -
База знаний сервиса / SaaS-продукта
У вас интернет-сервис на Cotonti.
Нужно отдельное меню «Помощь» с разделами:
Задания → Услуги → Кошелёк → Безопасность → Правила
В каждом разделе — десятки статей, но в меню вы показываете только основные, а остальные скрываете до завершения. -
Техническая документация фреймворка/библиотеки
Вы портировали Bootstrap, Tailwind или другой UI-кит под Cotonti.
Делаете документацию по аналогии с официальной:
https://getbootstrap.com/docs/5.3/getting-started/introduction/
Плагин позволяет в точности повторить такую структуру и внешний вид меню.
| Возможность | Почему критично для документации |
|---|---|
| Ручной порядок пунктов | Разделы идут строго по логике обучения: от простого к сложному |
| Скрытие страниц без удаления | Можно писать черновики, не показывая их пользователям |
| Переопределение заголовков | Длинное название страницы → короткое и понятное в меню |
| Разделители (заголовки категорий) | Чёткое визуальное разделение крупных блоков материала |
| Прямые ссылки вне категорий | Важные страницы «Введение», «Быстрый старт» всегда сверху |
| Авто‑подсветка активного пункта | Пользователь всегда видит, где он находится |
| Аккордеон с количеством статей | Современный UX, как в официальных документациях |
Руководство пользователя
├── Введение
├── Быстрый старт
├── Регистрация и профиль
├── Задания и проекты
│ ├── Создание задания
│ ├── Выбор исполнителя
│ ├── Этапы выполнения
│ └── Споры и арбитраж
├── Услуги
│ ├── Создание услуги
│ ├── Пакеты и допы
│ └── Отзывы
├── Платежи и кошелёк
│ ├── Пополнение
│ ├── Вывод средств
│ └── История операций
├── Безопасность
└── Часто задаваемые вопросы
Все пункты выше — это либо категории-разделители, либо вручную добавленные страницы.
Порядок, видимость и названия — полностью под вашим контролем.
Исходя из этого и как следствие ключевое назначение:
Это специализированный инструмент для создания профессиональной онлайн-документации программного или любого другого продукта Используя Cotonti + menubyparentcat легко создать онлайн-документацию для своих разработок или товаров, организовать меню документации так, чтобы пользователь быстро и без путаницы нашёл нужную инструкцию.
menubyparentcat — это не просто «ещё одно меню», например мой плагин Tree Cats Page Plugin for Cotonti Siena 0.9.26 - menubyparentcat - это эволюция и уже неотъемлимый компонет любого информационного продукта.
Без хорошо организованной документации и авторской поддержки пользователей вашей разработки(*), например, при помощи модуля "форумов" на Cotonti CMF - человеку будет сложно ознакомиться и освоить ваш продукт, не важно платный он или нет.
* - (плагин, модуль, шаблон, скрипт, программа и т.д.)
Вот несколько примеров того, что можно сделать, в части организации собственной онлайн-документации:
- Документация по GitHub
- Руководство пользователя UMI.CMS
- DataLife Engine Documentation
- OpenCart Documentation
- Модуль «Автоматическая обработка прайс-листов»
- UIkit v3 - lightweight and modular front-end framework
- AdminLTE 4 (Admin Dashboard Template/theme and Documentation)
- Sneat Dashboard Tamplate Documentation
Он, menubyparentcat позволяет:
- вручную управлять структурой меню
- сортировать категории и страницы в любом порядке
- скрывать отдельные элементы без удаления
- переопределять заголовки
- добавлять страницы вне структуры категорий
- использовать категории как заголовки-разделители
Идеально подходит для создания:
- разделов помощи
- пользовательских руководств
- сложных FAQ
- групп меню с вручную созданной структурой
- Cotonti: Siena 0.9.26+
- PHP: 8.1+ (рекомендуется 8.4)
- MySQL: 8.0+
- Модуль Page: обязателен
Плагин не конфликтует с другими меню и не переопределяет стандартные функции Cotonti.
- Скачать архив: https://github.com/webitproff/cot-menubyparentcat
- Распаковать в
plugins/menubyparentcat - В админке перейти: Плагины → Установка → menubyparentcat → Установить
- После установки открыть: Админка → Другое → Меню по родительской категории
В админке нужно указать:
Код родительской категории
Например:
user-guidehelpdocs
Этот код берётся из структуры модуля Страницы → Код.
После сохранения можно добавлять элементы меню.
Каждый элемент имеет параметры:
- Категория (cat) — раздел меню + автоматическая загрузка страниц внутри неё
- Страница (page) — прямая ссылка на статью
- Код категории / ID страницы — список зависит от выбранного типа
- Порядок сортировки — целое число, чем меньше, тем выше в меню
- Переопределённый заголовок — если нужен свой текст
- Включать в меню — можно скрыть элемент
- редактирование элемента
- удаление
- смена порядка числовыми значениями
- отсутствие дублей — страница не будет показана дважды
В любой шаблон сайта (например, sidebar.tpl):
{PHP|cot_menubyparentcat_build_tree('user-guide')}
Если код категории задан в настройках плагина:
{PHP|cot_menubyparentcat_build_tree()}
Пример:
<div class="sidebar-menu">
<h5>Помощь</h5>
{PHP|cot_menubyparentcat_build_tree('user-guide')}
</div>Плагин использует файл:
menubyparentcat.tree.tpl
В шаблоне реализованы:
- Bootstrap 5 структура меню
- раскрывающиеся подменю
- поддержка alias (ЧПУ)
- активные пункты
- вывод категорий с подстраницами
- вывод прямых страниц
- полный ручной контроль структуры меню
- переопределяемые заголовки
- поддержка скрытых элементов
- прямые ссылки на конкретные статьи
- автоматическая подгрузка всех страниц категории
- защита от повторов
- корректное формирование URL
- высокая производительность (индексированные запросы)
- Репозиторий: https://github.com/webitproff/cot-menubyparentcat
- Issues: используйте для багов и запросов фич
- Pull Requests: приветствуются
- Плагин распространяется бесплатно по лицензии BSD
Если плагин оказался полезным — поставьте ⭐ на GitHub!
© webitproff, 27 Nov 2025, License BSD.
напишите в личные сообщения на этой странице