PHPackages                             kunoichi/plugin-recommender - 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/plugin-recommender

ActiveLibrary

kunoichi/plugin-recommender
===========================

A PHP library for WordPress theme to recommend plugins.

1.0.0(3y ago)13.0k[2 issues](https://github.com/kuno1/plugin-recommendor/issues)GPL-3.0-or-laterPHPPHP >=5.6

Since Dec 2Pushed 3y agoCompare

[ Source](https://github.com/kuno1/plugin-recommendor)[ Packagist](https://packagist.org/packages/kunoichi/plugin-recommender)[ RSS](/packages/kunoichi-plugin-recommender/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (2)Dependencies (4)Versions (3)Used By (0)

Plugin Recommendor
==================

[](#plugin-recommendor)

WordPress theme add-on to recommend plugins.

How to Use
----------

[](#how-to-use)

In your theme, install via composer.

```
composer require kunoichi/plugin-recommender

```

Then, include `autoload.php` in your `functions.php`.

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

Now you can refer to class `Kunoichi\PluginRecommender`.

```
Kunoichi\PluginRecommender::bulk_add( [
  [
    slug        => 'jetpack',
    description => __( 'Because automattic recommends this plugin.', 'domain' ),
  ],
  [
    slug     => 'contact-form-7',
    priority => 100,
  ],
] );
```

Properties
----------

[](#properties)

Here's a list of properties that you can set for each plugin.

### slug

[](#slug)

**Required**. This should be the same as WordPress.org.

### source

[](#source)

Optional. The default is `wp`. If you provide some extra repository, set its name. Of course, you need an extra filter `plugin_recommender_information` for it to work properly.

### priority

[](#priority)

Optional. Recommended plugins ordered in descent. Over 90 means "required", over 50 means "integrated", and others are simply recommended.

### description

[](#description)

Optional. If this recommendation requires some explanation to recognize its efficiency, just write.

API
---

[](#api)

`Kunoichi\PluginRecommender::bulk_add( $settings )`

Bulk load settings. Pass array of settings.

`Kunoichi\PluginRecommender::add( $setting )`

Add a single plugin to recommend list.

`Kunoichi\PluginRecommender::load( $json_file_path )`

JSON file, which represents `$settings` is also available. But JSON is not translation-ready.

`Kunoichi\PluginRecommender::load()`

Just put `recommendations.json` in your theme directory.

`Kunoichi\PluginRecommender::set_title( $string )`
`Kunoichi\PluginRecommender::set_menu_title( $string )`
`Kunoichi\PluginRecommender::set_description( $string )`

Change the page title, menu title, and description.

License
-------

[](#license)

GPL 3.0 or later.

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 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

Every ~1099 days

Total

2

Last Release

1260d ago

Major Versions

0.8.0 → 1.0.02022-12-06

PHP version history (2 changes)0.8.0PHP ^7.0|^5.6

1.0.0PHP >=5.6

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/84587?v=4)[Takahashi Fumiki](/maintainers/fumikito)[@fumikito](https://github.com/fumikito)

---

Top Contributors

[![fumikito](https://avatars.githubusercontent.com/u/84587?v=4)](https://github.com/fumikito "fumikito (8 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/kunoichi-plugin-recommender/health.svg)

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

PHPackages © 2026

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