PHPackages                             gnowland/wp-jet-fuel - 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. [Framework](/categories/framework)
4. /
5. gnowland/wp-jet-fuel

ActiveWordpress-plugin[Framework](/categories/framework)

gnowland/wp-jet-fuel
====================

Facilitates the addition of custom functionality to a WordPress website, including Custom Post Types, Meta Fields, Widgets, Taxonomies, Shortcodes, Admin Modificaitons etc.

2.6.1(5y ago)10264[5 issues](https://github.com/gnowland/wp-jet-fuel/issues)MITPHPPHP &gt;=5.4.0

Since Aug 23Pushed 5y ago2 watchersCompare

[ Source](https://github.com/gnowland/wp-jet-fuel)[ Packagist](https://packagist.org/packages/gnowland/wp-jet-fuel)[ Docs](https://github.com/gnowland/wp-jet-fuel)[ RSS](/packages/gnowland-wp-jet-fuel/feed)WikiDiscussions master Synced yesterday

READMEChangelog (10)Dependencies (3)Versions (28)Used By (0)

WordPress Jet Fuel
==================

[](#wordpress-jet-fuel)

[![GitHub release](https://camo.githubusercontent.com/7210f0ce6778825022a24320e81ec51d7a3418b8076daed982cf9f77ab762fdc/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f676e6f776c616e642f77702d6a65742d6675656c2e7376673f7374796c653d666c61742d737175617265)](https://github.com/gnowland/wp-jet-fuel/releases)| [![Packagist](https://camo.githubusercontent.com/648e612aaa6b7690604c2d03d0e197a8c08d960eb6096d29f8a9078f70c82712/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f676e6f776c616e642f77702d6a65742d6675656c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/gnowland/wp-jet-fuel)[![Packagist Downloads](https://camo.githubusercontent.com/99ea335f8aee1d9076ff18ef5181830403853dc62141fdd6294ca089483a02a1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f676e6f776c616e642f77702d6a65742d6675656c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/gnowland/wp-jet-fuel)| [![npm](https://camo.githubusercontent.com/21add511b1dfa68bf653640571ef03cfd274eac2d5215208468daf2d3009e591/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f77702d6a65742d6675656c2e7376673f7374796c653d666c61742d737175617265)](https://www.npmjs.com/package/wp-jet-fuel)[![npm Downloads](https://camo.githubusercontent.com/682dc8fca97a8eb18d318be5ed0c7a3d901ada872881ec584c75adca4d1aa7fa/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f64742f77702d6a65742d6675656c2e7376673f7374796c653d666c61742d737175617265)](https://www.npmjs.com/package/wp-jet-fuel)| [![buymeacoffee.com/gnowland](https://camo.githubusercontent.com/97502a84e0349687c40deadb368205e232df6e7ec69b04d13ee3261ee05e6efb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4275792532304d6525323041253230436f666665652d646f6e6174652d79656c6c6f772e7376673f7374796c653d666c61742d737175617265)](https://www.buymeacoffee.com/gnowland)

Propel your WordPress installation into the stratosphere with this multi-function plugin. The combined result of *too many* years making one-off WordPress customizations and filtering hooks... I truly hope it brings inner peace and enlightenment to your world. (˘▾˘)

Complementary Plugins
---------------------

[](#complementary-plugins)

The following plugins are particularly complementary; in fact a notable number of 0.1.0 actions were dropped in 0.2.0 in favor of using the methods from these fantastic plugins instead!

- Admin cleanup &amp; modifications:
    [soberwp/intervention](https://github.com/soberwp/intervention)
- Custom post types &amp; taxonomies:
    [soberwp/models](https://github.com/soberwp/models)

How To Use
----------

[](#how-to-use)

- Install Plugin (see below)
- Add `jetfuel('module-name', ['arbitrary', 'options']);` to `functions.php` ...or ideally a file `required()` by `functions.php`, e.g:

```
# functions.php
$lib_includes = [
  'lib/mods.php',
];

foreach ($lib_includes as $file) {
  if (!$filepath = locate_template($file)) {
    trigger_error(sprintf(__('Error locating %s for inclusion', 'your-textdomain'), $file), E_USER_ERROR);
  }
  require_once $filepath;
}
unset($file, $filepath);
```

Modules
-------

[](#modules)

### Deselect Uncategorized (Default Category)

[](#deselect-uncategorized-default-category)

```
jetfuel('deselect-uncategorized');
```

[![Deselect Uncategorized Screencast](https://raw.githubusercontent.com/gnowland/wp-jet-fuel/master/deselectUncategorized.gif)](https://raw.githubusercontent.com/gnowland/wp-jet-fuel/master/deselectUncategorized.gif)

@TODO: Add in-depth descriptions of individual modules. Until then, take a peek in [src/Module](src/Module) for available functions.

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

[](#installation)

### Composer

[](#composer)

```
composer require gnowland/wp-jet-fuel
```

Activate with [wp-cli](http://wp-cli.org/)

```
wp plugin activate wp-jet-fuel
```

### Git

[](#git)

- `git clone` into your sites plugin folder
- Activate via WordPress or wp-cli (see above)

### Manual

[](#manual)

- Download the [zip file](https://github.com/gnowland/wp-jet-fuel/archive/master.zip)
- Unzip to your sites plugin folder
- Activate via WordPress or wp-cli (see above)

Updates
-------

[](#updates)

Includes support for [github-updater](https://github.com/afragen/github-updater) to keep track of updates through the WordPress admin.

Changelog
---------

[](#changelog)

See [Releases](https://github.com/gnowland/wp-jet-fuel/releases).

Contributing
------------

[](#contributing)

Heck yea! Baby, we're better together.

- Refactor some gnarly code? Submit a PR.
- Write a feature addition? Submit a PR.
- Problems/requests? Make an Issue and I'll look into it ASAP.

There's no draconian PR standard, if I can't figure out something in your PR we can work it out together.

### Onboarding

[](#onboarding)

git clone :gnowland/wp-jet-fuel.git composer install

### Test

[](#test)

Make sure your code complies with PSR-2/SOBER guidelines

```
composer test src/
```

### Build for release

[](#build-for-release)

Create `dist/`:

```
composer build
```

Attribution
-----------

[](#attribution)

Don't be a stranger!

Contact **Gifford Nowland** &lt;*hi(at symbol)giffordnowland.com*&gt;

```

                                                   ,:
                                                 ,' |
                                                /   :
                                             --'   /
                                             \/ />/
                                             / /_\
                                          __/   /
                                          )'-. /
                                          ./  :\
                                           /.' '
                                         '/'
                                         +
                                        '
                                      `.
                                  .-"-
                                 (    |
                              . .-'  '.
                             ( (.   )8:
                         .'    / (_  )
                          _. :(.   )8P  `
                      .  (  `-' (  `.   .
                       .  :  (   .a8a)
                      /_`( "a `a. )"'
                  (  (/  .  ' )=='
                 (   (    )  .8"   +
                   (`'8a.( _(   (
                ..-. `8P    ) `  )  +
              -'   (      -ab:  )
            '    _  `    (8P"Ya
          _(    (    )b  -`.  ) +
         ( 8)  ( _.aP" _a   \( \   *
       +  )/    (8P   (88    )  )
          (a:f   "     `"       `

```

Rationale
---------

[](#rationale)

At its core, this plugin merely facilitates the addition of extended functionality to a WordPress website: Custom Post Types, Meta Fields, Widgets, Taxonomies, Shortcodes, Admin Modifications, etc.

*Why a functionality plugin, you ask?* Think of it this way: instead of tying site architecture and management code to a particular Theme (via `functions.php`), a much more sustainable method is to use what's commonly referred to as a "functionality plugin". This separates *form* (frontend layout) from *function* (administration), allowing you to retain functionality modifications across theme installations!

Here's what some intelligent people say on the subject:

> "We recommend that you always put custom post types in a plugin rather than a theme. This ensures that the user’s content is portable whenever they change their website’s design." — *[Wordpress.org Plugin Handbook](https://developer.wordpress.org/plugins/custom-post-types-and-taxonomies/registering-custom-post-types/)*

> See also: *[Why Custom Post Types Belong in Plugins](http://justintadlock.com/archives/2013/09/14/why-custom-post-types-belong-in-plugins)* and *[How to Create Your Own WordPress Functionality Plugin](http://wpcandy.com/teaches/how-to-create-a-functionality-plugin)* for more supporting evidence behind adding additional site functionality via a plugin instead of a theme's `functions.php` file.

@TODO:
------

[](#todo)

- [Set up @wordpress/scripts](https://developer.wordpress.org/block-editor/tutorials/javascript/js-build-setup/) for block editor (Gutenberg) scripts:
    - `deselectUncategorized.js`

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance10

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity68

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

Every ~47 days

Recently: every ~7 days

Total

26

Last Release

1996d ago

Major Versions

0.2.0.x-dev → 1.0.02017-09-20

v1.3.4 → v2.0.02019-11-22

PHP version history (2 changes)0.1.0PHP &gt;=5.3.2

0.2.0.x-devPHP &gt;=5.4.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4430119?v=4)[Gifford Nowland](/maintainers/gnowland)[@gnowland](https://github.com/gnowland)

---

Top Contributors

[![gnowland](https://avatars.githubusercontent.com/u/4430119?v=4)](https://github.com/gnowland "gnowland (203 commits)")

---

Tags

wordpresswordpress-developmentwordpress-functionalitywordpress-installationwordpress-pluginwordpress-setuppluginwordpresswordpress plugin

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/gnowland-wp-jet-fuel/health.svg)

```
[![Health](https://phpackages.com/badges/gnowland-wp-jet-fuel/health.svg)](https://phpackages.com/packages/gnowland-wp-jet-fuel)
```

###  Alternatives

[justcoded/wordpress-theme-framework

Lightweight theme framework base with Model-View concept for developers who want to better organize their own custom themes.

264.1k2](/packages/justcoded-wordpress-theme-framework)[htmlburger/wpemerge-plugin

A modern WordPress starter plugin which uses the WP Emerge framework

431.2k](/packages/htmlburger-wpemerge-plugin)[alleyinteractive/pest-plugin-wordpress

WordPress Pest Integration

263.7k1](/packages/alleyinteractive-pest-plugin-wordpress)

PHPackages © 2026

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