Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/latz/customcategorieslist/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Custom Categories List
A modern WordPress block widget for displaying categories with advanced filtering, sorting, and subcategory support.
⭐ Production Ready | ✅ 43 Tests Passing | 🔒 Security A+
📋 Table of Contents
- Features
- Installation
- Usage
- Features Guide
- Development
- Testing
- Troubleshooting
- Code Quality
- Contributing
- License
✨ Features
Core Features
- 📁 Category Selection — Choose any combination of categories to display
- 🏷️ Post Counts — Optional display of post count per category
- 🔤 Flexible Sorting — Five sort modes:
- Selection order (default)
- Name A→Z and Z→A
- Most posts first / Fewest posts first
- 📚 Subcategories — Automatically show child categories in nested lists
- 🧹 Exclude Empty — Hide categories with zero posts
- 📋 List Styles — Choose between unordered () or ordered () lists
Technical Features
- ✅ Block Editor compatible (WordPress 6.1+)
- ✅ Customizer widget support
- ✅ REST API integration
- ✅ Security hardened (input validation, output escaping)
- ✅ Responsive design
- ✅ Zero external dependencies
📦 Installation
Via WordPress Admin
1. Download the plugin from GitHub or your repository
2. Upload to wp-content/plugins/
3. Act