PHPackages                             kunoichi/block-library - 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. kunoichi/block-library

ActiveLibary

kunoichi/block-library
======================

Block library for WordPress.

1.9.4(1y ago)26.6k↓100%[17 issues](https://github.com/kuno1/block-library/issues)[3 PRs](https://github.com/kuno1/block-library/pulls)GPL-3.0-or-laterJavaScriptPHP &gt;=7.2CI passing

Since Jan 16Pushed 1mo agoCompare

[ Source](https://github.com/kuno1/block-library)[ Packagist](https://packagist.org/packages/kunoichi/block-library)[ RSS](/packages/kunoichi-block-library/feed)WikiDiscussions master Synced today

READMEChangelog (8)Dependencies (8)Versions (50)Used By (0)

Kunoich Block Library
=====================

[](#kunoich-block-library)

A block library for WordPress theme.

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

[](#installation)

```
composer require kunoichi/block-library

```

Activate
--------

[](#activate)

First, load autoloader in your theme's `functions.php`.

```
require __DIR__ . '/vendor/autoload.php';
```

2nd, enable block library.

```
Kunoichi\BlockLibrary::enable();
```

Choose Blocks
-------------

[](#choose-blocks)

If you want select blocks to be enabled, explicitly delcare the class names.

```
Kunoichi\BlockLibrary::enable( [
	\Kunoichi\BlockLibrary\Blocks\PostList::class,
	\Kunoichi\BlockLibrary\Blocks\BubbleBlock::class,
] );
```

Available block classes are located in `src/Kunoichi/BlockLibrary/Blocks`.

Or else, you can exclude unwanted blocks with 2nd parameter.

```
// 1st param is inclusive, 2nd param is exclusive.
Kunoichi\BlockLibrary::enable( [], [
	\Kunoichi\BlockLibrary\Blocks\PriceTable::class,
] );
```

How blocks Work
---------------

[](#how-blocks-work)

All blocks are registered via PHP Class and JavaScripts corresponding, thus 1 block has at least 1 php file and 1 js file.

PHP files are located at [src/Kunoichi/BlockLibrary/Blocks](./src/Kunoichi/BlockLibrary/Blocks), JavaScript files are also located at [assts/js/blocks](./assets/js/blocks);

### Registered Blocks

[](#registered-blocks)

18 blocks are available.

#### Alert `kunoichi/alert`

[](#alert-kunoichialert)

Styled alert blocks.

#### Speech Bubble `kunoichi/bubble`

[](#speech-bubble-kunoichibubble)

Speech bubble with avatar.

#### Link Card `kunoichi/card`

[](#link-card-kunoichicard)

Card style link.
*Parents*: available only in `kunoichi/cards`

#### Cards `kunoichi/cards`

[](#cards-kunoichicards)

Display card style links. Helpful as category link list and so on.

#### Clipboard `kunoichi/clipboard`

[](#clipboard-kunoichiclipboard)

Clipboard button for copying text.

#### Call To Action `kunoichi/cta`

[](#call-to-action-kunoichicta)

Display UI parts to invoke user's action.
*Dynamic Block*: see [CallToAction](./src/Kunoichi/BlockLibrary/Blocks/CallToAction.php)

#### Term `kunoichi/dt`

[](#term-kunoichidt)

Definition Term.
*Parents*: available only in `kunoichi/definition-list`

#### Description `kunoichi/dd`

[](#description-kunoichidd)

Definition Description.
*Parents*: available only in `kunoichi/definition-list`

#### Definition List `kunoichi/definition-list`

[](#definition-list-kunoichidefinition-list)

Definition list.

#### Internal Link `kunoichi/internal-link`

[](#internal-link-kunoichiinternal-link)

Same as Oembed link block, but this link is referred as post ID.
*Dynamic Block*: see [InternalLink](./src/Kunoichi/BlockLibrary/Blocks/InternalLink.php)

#### Offer List `kunoichi/offer-list`

[](#offer-list-kunoichioffer-list)

Display offer list of products with price, links, and spec.

#### Offer Content `kunoichi/offer-content`

[](#offer-content-kunoichioffer-content)

Title, price, and specs of an offer.
*Parents*: available only in `kunoichi/offer`

#### Offer Action `kunoichi/offer-action`

[](#offer-action-kunoichioffer-action)

Action link for offer block.
*Parents*: available only in `kunoichi/offer`

#### Offer `kunoichi/offer`

[](#offer-kunoichioffer)

Product offer with price, link, and spec. Helpful for promoting external products.
*Parents*: available only in `kunoichi/offer-list`

#### Panel `kunoichi/panel`

[](#panel-kunoichipanel)

Panel block for emphasized and separated contents.

#### Post List `kunoichi/posts`

[](#post-list-kunoichiposts)

Display post list in various format.
*Dynamic Block*: see [PostList](./src/Kunoichi/BlockLibrary/Blocks/PostList.php)

#### Price Table `kunoichi/price-table`

[](#price-table-kunoichiprice-table)

Display price table. Insert 3 or 4 items.

#### Price Item `kunoichi/price`

[](#price-item-kunoichiprice)

Price item in price tables.
*Parents*: available only in `kunoichi/price-table`

#### Section `kunoichi/section`

[](#section-kunoichisection)

Enhanced group block which supports background.

#### Step `kunoichi/step`

[](#step-kunoichistep)

Step Block
*Parents*: available only in `kunoichi/steps`

#### How-to `kunoichi/steps`

[](#how-to-kunoichisteps)

Step by step how-tos. Ready for JSON-LD.

#### Testimonials `kunoichi/testimonials`

[](#testimonials-kunoichitestimonials)

Display testimonials list.
*Dynamic Block*: see [Testimonials](./src/Kunoichi/BlockLibrary/Blocks/Testimonials.php)

#### Tile `kunoichi/tile`

[](#tile-kunoichitile)

Tile item in tiled grid.
*Parents*: available only in `kunoichi/tiled-grid`

#### Tiled Grid `kunoichi/tiled-grid`

[](#tiled-grid-kunoichitiled-grid)

Grid style layout of panel items. Ready for text &amp; background colors.

#### Toc `kunoichi/toc`

[](#toc-kunoichitoc)

Display TOC extracted from Heading tags in post content.

Widgets
-------

[](#widgets)

You can enable widgets in the same way as blocks.

```
\Kunoichi\BlockLibrary::widgets();
```

This method also has `$includes` and `$excludes` params.

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

[](#development)

This library is not plugin, so it does no effect by itself. Please make a empty theme and load from it.

### Build Assets

[](#build-assets)

This library build assets with npm.

```
# Install npm.
npm install
# Build assets.
npm run package
# Watch changes.
npm run watch

```

License
-------

[](#license)

This library is licensed under GPL 3.0 and later.

© 2019 Kunoichi INC.

###  Health Score

39

↑

LowBetter than 87% of packages

Maintenance45

Moderate activity, may be stable

Popularity23

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

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

Every ~35 days

Recently: every ~61 days

Total

45

Last Release

698d ago

PHP version history (4 changes)1.0.0PHP ^5.6|^7.0

1.7.5PHP &gt;=5.6

1.9.0PHP &gt;=7.0

1.9.4PHP &gt;=7.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/8841e1844df83ec61f46e77357101b1e9d191339e4f0de11edb944b643c100b1?d=identicon)[fumikito](/maintainers/fumikito)

---

Top Contributors

[![fumikito](https://avatars.githubusercontent.com/u/84587?v=4)](https://github.com/fumikito "fumikito (96 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/kunoichi-block-library/health.svg)

```
[![Health](https://phpackages.com/badges/kunoichi-block-library/health.svg)](https://phpackages.com/packages/kunoichi-block-library)
```

PHPackages © 2026

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