mundschenk-at/check-wp-requirements

A class to allow WordPress plugins to check certain runtime requirements before activation.

v2.0.0 2019-06-25 17:42 UTC

Requires

• php: >=5.2.0

Requires (Dev)

• brain/monkey: ^2.0@dev
• dealerdirect/phpcodesniffer-composer-installer: ^0.5
• mikey179/vfsstream: ~1
• phpcompatibility/php-compatibility: ^9.0
• phpunit/phpunit: 5.*|6.*|7.*
• squizlabs/php_codesniffer: ^3.0
• wp-coding-standards/wpcs: ^2.0

GPL-2.0-or-later

• Peter Putzer

README

A helper class for WordPress plugins to check PHP version and other requirements.

Requirements

• PHP 5.6.0 or above
• WordPress 5.2 or higher.

Installation

The best way to use this package is through Composer:

$ composer require mundschenk-at/check-wp-requirements

Basic Usage

1. Create a \Mundschenk\WP_Requirements object and set the requirements in the constructor.
2. Call the \Mundschenk\WP_Requirements::check() method and start your plugin normally if it returns true.

// Set up autoloader.
require_once __DIR__ . '/vendor/autoload.php';

/**
 * Load the plugin after checking for the necessary PHP version.
 *
 * It's necessary to do this here because main class relies on namespaces.
 */
function run_your_plugin() {

	$requirements = new \Mundschenk\WP_Requirements( 'Your Plugin Name', __FILE__, 'your-textdomain', [
		'php'       => '5.6.0',
		'multibyte' => true,
		'utf-8'     => false,
	] );

	if ( $requirements->check() ) {
		// Autoload the rest of your classes.

		// Create and start the plugin.
		...
	}
}
run_your_plugin();

License

check-wp-requirements is licensed under the GNU General Public License 2 or later - see the LICENSE file for details.