kaiseki/wp-plugin-ninja-forms

WordPress helpers for the Ninja Forms plugin: register field template paths and remove the append-a-form metabox in the block editor

1.0.0 2026-06-01 09:50 UTC

Requires

• php: ^8.2
• kaiseki/config: ^2.0
• kaiseki/wp-hook: ^2.0
• psr/container: ^1.1 || ^2.0

Requires (Dev)

• bnf/phpstan-psr-container: ^1.1
• kaiseki/php-coding-standard: ^1.0
• maglnet/composer-require-checker: ^4.0
• php-stubs/wordpress-stubs: ^6.2
• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• phpstan/phpstan-strict-rules: ^2.0
• phpunit/phpunit: ^11.0
• roave/security-advisories: dev-latest
• roots/wordpress-core-installer: *
• roots/wordpress-no-content: @stable
• szepeviktor/phpstan-wordpress: ^2.0
• thecodingmachine/phpstan-safe-rule: ^1.4

MIT

• Kaiseki
• David Mondok
• Wolfgang Schaefer

README

WordPress helpers for the Ninja Forms plugin: register field template paths and remove the append-a-form metabox in the block editor.

Two kaiseki/wp-hook HookProviderInterfaces wired through ConfigProvider, both no-ops unless the Ninja Forms plugin is active:

• AddTemplatePaths — registers extra field-template directories with Ninja Forms (the ninja_forms_field_template_file_paths filter).
• RemoveAppendFormMetabox — removes the "append a form" metabox from the block editor, optionally limited to specific post types.

Installation

composer require kaiseki/wp-plugin-ninja-forms

Requires PHP 8.2 or newer.

Usage

Register ConfigProvider with your laminas-style config aggregator, configure the ninja_forms key, and activate the providers you want via kaiseki/wp-hook:

use Kaiseki\WordPress\NinjaForms\AddTemplatePaths;
use Kaiseki\WordPress\NinjaForms\RemoveAppendFormMetabox;

return [
    'ninja_forms' => [
        // Extra directories searched for field templates.
        'template_paths' => [
            get_stylesheet_directory() . '/ninja-forms/templates',
        ],
        // false to keep the metabox, true to remove it everywhere,
        // or a list of post types to remove it from.
        'remove_append_form_metabox' => ['page'],
    ],
    'hook' => [
        'provider' => [
            AddTemplatePaths::class,
            RemoveAppendFormMetabox::class,
        ],
    ],
];

ConfigProvider registers the factories for both providers; each reads its slice of the ninja_forms config from the container. Plugin::isActive() gates the metabox removal so nothing runs when Ninja Forms is inactive.

Development

composer install
composer check   # check-deps, cs-check, phpstan

License

MIT — see LICENSE.