{"id":15065483,"url":"https://github.com/gnowland/wp-jet-fuel","last_synced_at":"2025-07-16T17:33:36.724Z","repository":{"id":57399501,"uuid":"73959416","full_name":"gnowland/wp-jet-fuel","owner":"gnowland","description":"Propel your WordPress installation into the stratosphere with this multi-function plugin!","archived":false,"fork":false,"pushed_at":"2020-11-23T14:33:36.000Z","size":706,"stargazers_count":8,"open_issues_count":5,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-13T15:49:00.485Z","etag":null,"topics":["wordpress","wordpress-development","wordpress-functionality","wordpress-installation","wordpress-plugin","wordpress-setup"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gnowland.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-11-16T20:44:13.000Z","updated_at":"2025-06-05T13:31:27.000Z","dependencies_parsed_at":"2022-09-09T22:21:18.053Z","dependency_job_id":null,"html_url":"https://github.com/gnowland/wp-jet-fuel","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/gnowland/wp-jet-fuel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnowland%2Fwp-jet-fuel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnowland%2Fwp-jet-fuel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnowland%2Fwp-jet-fuel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnowland%2Fwp-jet-fuel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gnowland","download_url":"https://codeload.github.com/gnowland/wp-jet-fuel/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnowland%2Fwp-jet-fuel/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265527591,"owners_count":23782480,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["wordpress","wordpress-development","wordpress-functionality","wordpress-installation","wordpress-plugin","wordpress-setup"],"created_at":"2024-09-25T00:39:10.292Z","updated_at":"2025-07-16T17:33:36.703Z","avatar_url":"https://github.com/gnowland.png","language":"PHP","funding_links":["https://www.buymeacoffee.com/gnowland"],"categories":[],"sub_categories":[],"readme":"# WordPress Jet Fuel #\n[![GitHub release](https://img.shields.io/github/release/gnowland/wp-jet-fuel.svg?style=flat-square)](https://github.com/gnowland/wp-jet-fuel/releases)\n|\n[![Packagist](https://img.shields.io/packagist/v/gnowland/wp-jet-fuel.svg?style=flat-square)](https://packagist.org/packages/gnowland/wp-jet-fuel)\n[![Packagist Downloads](https://img.shields.io/packagist/dt/gnowland/wp-jet-fuel.svg?style=flat-square)](https://packagist.org/packages/gnowland/wp-jet-fuel)\n|\n[![npm](https://img.shields.io/npm/v/wp-jet-fuel.svg?style=flat-square)](https://www.npmjs.com/package/wp-jet-fuel)\n[![npm Downloads](https://img.shields.io/npm/dt/wp-jet-fuel.svg?style=flat-square)](https://www.npmjs.com/package/wp-jet-fuel)\n|\n[![buymeacoffee.com/gnowland](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-donate-yellow.svg?style=flat-square)](https://www.buymeacoffee.com/gnowland)\n\n\nPropel 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. ~(˘▾˘~)\n\n## Complementary Plugins ##\n\nThe 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!\n\n* Admin cleanup \u0026amp; modifications:\u003cbr\u003e[soberwp/intervention](https://github.com/soberwp/intervention)\n* Custom post types \u0026amp; taxonomies:\u003cbr\u003e[soberwp/models](https://github.com/soberwp/models)\n\n## How To Use ##\n\n* Install Plugin (see below)\n* Add `jetfuel('module-name', ['arbitrary', 'options']);` to `functions.php` ...or ideally a file `required()` by `functions.php`, e.g:\n\n```shell\n# functions.php\n$lib_includes = [\n  'lib/mods.php',\n];\n\nforeach ($lib_includes as $file) {\n  if (!$filepath = locate_template($file)) {\n    trigger_error(sprintf(__('Error locating %s for inclusion', 'your-textdomain'), $file), E_USER_ERROR);\n  }\n  require_once $filepath;\n}\nunset($file, $filepath);\n```\n\n## Modules ##\n\n### Deselect Uncategorized (Default Category)\n\n```php\njetfuel('deselect-uncategorized');\n```\n\n![Deselect Uncategorized Screencast](https://raw.githubusercontent.com/gnowland/wp-jet-fuel/master/deselectUncategorized.gif)\n\n@TODO: Add in-depth descriptions of individual modules. Until then, take a peek in [src/Module](src/Module) for available functions.\n\n## Installation ##\n\n### Composer ###\n\n```shell\ncomposer require gnowland/wp-jet-fuel\n```\n\nActivate with [wp-cli](http://wp-cli.org/)\n\n```shell\nwp plugin activate wp-jet-fuel\n```\n\n### Git ###\n\n* `git clone` into your sites plugin folder\n* Activate via WordPress or wp-cli (see above)\n\n### Manual ###\n\n* Download the [zip file](https://github.com/gnowland/wp-jet-fuel/archive/master.zip)\n* Unzip to your sites plugin folder\n* Activate via WordPress or wp-cli (see above)\n\n## Updates ##\n\nIncludes support for [github-updater](https://github.com/afragen/github-updater) to keep track of updates through the WordPress admin.\n\n## Changelog ##\n\nSee [Releases](https://github.com/gnowland/wp-jet-fuel/releases).\n\n## Contributing ##\n\nHeck yea! Baby, we're better together.\n\n* Refactor some gnarly code? Submit a PR.\n* Write a feature addition? Submit a PR.\n* Problems/requests? Make an Issue and I'll look into it ASAP.\n\nThere's no draconian PR standard, if I can't figure out something in your PR we can work it out together.\n\n### Onboarding ###\n\ngit clone git@github.com:gnowland/wp-jet-fuel.git\ncomposer install\n\n### Test ###\n\nMake sure your code complies with PSR-2/SOBER guidelines\n\n```shell\ncomposer test src/\n```\n\n### Build for release ###\n\nCreate `dist/`:\n\n```shell\ncomposer build\n```\n\n## Attribution ##\n\nDon't be a stranger!\n\nContact **Gifford Nowland** \u003c*hi(at symbol)giffordnowland.com*\u003e\n\n```ascii\n\n                                                   ,:\n                                                 ,' |\n                                                /   :\n                                             --'   /\n                                             \\/ /\u003e/\n                                             / /_\\\n                                          __/   /\n                                          )'-. /\n                                          ./  :\\\n                                           /.' '\n                                         '/'\n                                         +\n                                        '\n                                      `.\n                                  .-\"-\n                                 (    |\n                              . .-'  '.\n                             ( (.   )8:\n                         .'    / (_  )\n                          _. :(.   )8P  `\n                      .  (  `-' (  `.   .\n                       .  :  (   .a8a)\n                      /_`( \"a `a. )\"'\n                  (  (/  .  ' )=='\n                 (   (    )  .8\"   +\n                   (`'8a.( _(   (\n                ..-. `8P    ) `  )  +\n              -'   (      -ab:  )\n            '    _  `    (8P\"Ya\n          _(    (    )b  -`.  ) +\n         ( 8)  ( _.aP\" _a   \\( \\   *\n       +  )/    (8P   (88    )  )\n          (a:f   \"     `\"       `\n\n\n```\n\n## Rationale ##\n\nAt 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.\n\n*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!\n\nHere's what some intelligent people say on the subject:\n\u003e \"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.\" \u0026mdash; _[Wordpress.org Plugin Handbook](https://developer.wordpress.org/plugins/custom-post-types-and-taxonomies/registering-custom-post-types/)_\n\n\u003e 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.\n\n## @TODO: ##\n\n- [Set up @wordpress/scripts](https://developer.wordpress.org/block-editor/tutorials/javascript/js-build-setup/) for block editor (Gutenberg) scripts:\n  - `deselectUncategorized.js`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgnowland%2Fwp-jet-fuel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgnowland%2Fwp-jet-fuel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgnowland%2Fwp-jet-fuel/lists"}