PHPackages                             humanmade/hm-primary-category-block - 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. humanmade/hm-primary-category-block

ActiveWordpress-plugin[Utility & Helpers](/categories/utility)

humanmade/hm-primary-category-block
===================================

Displays the primary category for a post.

1.0.0(2mo ago)00[1 issues](https://github.com/humanmade/primary-category/issues)GPL-2.0-or-laterPHPPHP >=8.2CI passing

Since Feb 24Pushed 2mo agoCompare

[ Source](https://github.com/humanmade/primary-category)[ Packagist](https://packagist.org/packages/humanmade/hm-primary-category-block)[ RSS](/packages/humanmade-hm-primary-category-block/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)DependenciesVersions (4)Used By (0)

HM Primary Category Block
=========================

[](#hm-primary-category-block)

Displays the primary category for a post in the WordPress block editor.

Features
--------

[](#features)

- Displays the primary category for a post
- Supports Yoast SEO primary category selection
- Server-side rendered for optimal performance

Usage
-----

[](#usage)

The Primary Category block is automatically available after plugin activation. The block uses the `postId` context and is typically used within:

- Query Loop blocks
- Post Templates
- Single post layouts

### How it works

[](#how-it-works)

1. The block automatically detects the post ID from context
2. If Yoast SEO is active, it uses the primary category set by Yoast
3. For posts with multiple categories, it returns the top-level parent category
4. For single category posts, it returns that category

### Block Name

[](#block-name)

The block is registered as `hm/primary-category` and can be inserted programmatically or used in block patterns.

### Customization

[](#customization)

The block outputs a link with the class `hentry__category` which can be styled via CSS:

```
.hentry__category {
    /* Your custom styles */
}
```

Installation
------------

[](#installation)

1. Clone this repository to your WordPress plugins directory
2. Run `npm install` to install dependencies
3. Run `npm run build` to build the block
4. Activate the plugin in WordPress

Development
-----------

[](#development)

- `npm start` - Start development mode with hot reload
- `npm run build` - Build production files
- `npm run lint` - Run linters

Requirements
------------

[](#requirements)

- WordPress 6.0+
- PHP 8.2+
- Node.js 22+

Release Process
---------------

[](#release-process)

Merges to `main` will automatically [build](https://github.com/humanmade/primary-category/actions/workflows/build-release-branch.yml) to the `release` branch. A project may be set up to track the `release` branch using [composer](http://getcomposer.org/) to pull in the latest built beta version.

Commits on the `release` branch may be tagged for installation via [packagist](https://packagist.org/packages/humanmade/primary-category) and marked as releases in GitHub for manual download using a [manually-dispatched "Tag and Release" GH Actions workflow](https://github.com/humanmade/primary-category/actions/workflows/tag-and-release.yml).

To tag a new release,

1. Review the unreleased features in the [Changelog](./CHANGELOG.md) and choose the target version number for the next release using [semantic versioning](https://semver.org/)
2. Checkout a `prepare-v#.#.#` branch. In that branch,
    - Add a new header into [CHANGELOG.md](./CHANGELOG.md) for any unreleased features
    - Bump the version number in the [hm-primary-category-block.php](./hm-primary-category-block.php) file's PHPDoc header
3. Open a pull request from your branch titled "Prepare release v#.#.#"
4. Review and merge your "Prepare release" pull request
5. Wait for the `release` branch to [update](https://github.com/humanmade/primary-category/actions/workflows/build-release-branch.yml) with the build that includes the new version number
6. On the ["Tag and Release" GH Action page](https://github.com/humanmade/primary-category/actions/workflows/tag-and-release.yml)\],
    - Click the "Run workflow" button in the "workflow\_dispatch" notification banner (see screenshot below)
    - Fill out the "Version tag" field with your target version number
        - This version must match the version in `hm-primary-category-block.php` and your newest Changelog section
        - Use the format `v#.#.#` for your version tag
    - Leave the "Branch to tag" field as `release` (we will add the tag on the release branch containing the latest built code)
    - Click "Run workflow"

[![Screenshot of Run workflow dropdown form being filled out](./.github/docs/release-tagging-action.jpg)](./.github/docs/release-tagging-action.jpg)

Once the workflow completes, your new version should be [tagged](https://github.com/humanmade/primary-category/tags) and available in the list of [releases](https://github.com/humanmade/primary-category/releases)

License
-------

[](#license)

GPL-2.0-or-later

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance84

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 96.4% 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

83d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/55361215?v=4)[Pamela Ribeiro](/maintainers/pamprn09)[@pamprn09](https://github.com/pamprn09)

---

Top Contributors

[![pamprn09](https://avatars.githubusercontent.com/u/55361215?v=4)](https://github.com/pamprn09 "pamprn09 (27 commits)")[![joeleenk](https://avatars.githubusercontent.com/u/6807390?v=4)](https://github.com/joeleenk "joeleenk (1 commits)")

### Embed Badge

![Health badge](/badges/humanmade-hm-primary-category-block/health.svg)

```
[![Health](https://phpackages.com/badges/humanmade-hm-primary-category-block/health.svg)](https://phpackages.com/packages/humanmade-hm-primary-category-block)
```

PHPackages © 2026

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