PHPackages                             maccath/baun-categories - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. maccath/baun-categories

ActiveLibrary[Utility & Helpers](/categories/utility)

maccath/baun-categories
=======================

A categories plugin for BaunCMS

1.0(11y ago)046[1 issues](https://github.com/maccath/baun-categories/issues)MITPHP

Since Apr 19Pushed 9y ago1 watchersCompare

[ Source](https://github.com/maccath/baun-categories)[ Packagist](https://packagist.org/packages/maccath/baun-categories)[ RSS](/packages/maccath-baun-categories/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (6)Used By (0)

Baun Categories Plugin
======================

[](#baun-categories-plugin)

A categories plugin for BaunCMS

Installation Instructions
-------------------------

[](#installation-instructions)

### Using Composer

[](#using-composer)

Install using composer on the commandline:

```
composer require maccath/baun-categories

```

Or in `composer.json`:

```
"require": {
    "maccath/baun-categories": "1.*",
},

```

### Configuration

[](#configuration)

Add the following line to your `config/plugins.php` file:

```
'BaunPlugin\Categories\Categories',

```

Run the following command inside your project directory:

```
php baun publish:config maccath/baun-categories

```

This will create config files inside the `config/plugins/maccath/baun-categories` directory, which you may then edit to your liking.

The following configuration options are available:

- `title` the title used on the categories list page and in the navigation
- `category_url` the path used to access your blog categories, no leading slash
- `exclude_from_nav` (boolean) whether or not to exclude the categories page from the navigation

Usage Instructions
------------------

[](#usage-instructions)

### Adding categories to posts

[](#adding-categories-to-posts)

To add categories to your posts, simply add `categories: categoryOne, categoryTwo` to the top of your blog post files. For example, the following file will create a post with the categories 'volutpat' and 'consectetur':

```
title: Post 1
categories: consectetur, volutpat
----
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quisque ut vehicula erat. Morbi volutpat posuere auctor.
Vivamus condimentum, purus nec tempus euismod, enim massa blandit est, vel elementum lacus nulla ut sem. Integer
orci libero, rutrum id nisl et, euismod auctor augue.

```

### Viewing all posts in a category

[](#viewing-all-posts-in-a-category)

By default, posts for categories will appear at the following path: `/categories/categoryName`. The path used to display categories can be configured in the configuration file found at `config/plugins/maccath/baun-categories/categories.php`

### Editing the categories page template

[](#editing-the-categories-page-template)

Inside your themes directory (typically `public/themes/themeName/`), create `categories.html`. This file can be customised to display a list of categories however you like. The following example is the default file contents, which simply displays an unordered list of categories:

```
{% extends "layout.html" %}

{% block content %}
{{ categories_title }}

    {% for category in categories %}
    {{ category.name }}
    {% endfor %}

{% endblock %}

```

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community5

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

4038d ago

### Community

---

Top Contributors

[![maccath](https://avatars.githubusercontent.com/u/904427?v=4)](https://github.com/maccath "maccath (32 commits)")

### Embed Badge

![Health badge](/badges/maccath-baun-categories/health.svg)

```
[![Health](https://phpackages.com/badges/maccath-baun-categories/health.svg)](https://phpackages.com/packages/maccath-baun-categories)
```

###  Alternatives

[godbout/dash-docset-builder

Dash (LOVE) Docset Builder in PHP (LOVE).

1253.5k](/packages/godbout-dash-docset-builder)[markwalet/laravel-packagist

A Laravel wrapper for the `spatie/packagist-api` package.

132.1k](/packages/markwalet-laravel-packagist)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)