Plugin Activation Errors #

If DMSI Service Management fails to activate or produces errors immediately after activation, this guide covers the most common causes.

What DMSI Service Management Adds
The dependency checks described here are performed by this extension’s activation routine. Activation errors are generated by the plugin itself (not WordPress core) when required conditions are not met.

Dependency Check: DMSI-DDLS Core Required #

Error message: “DMSI Service Management requires DMSI-DDLS Core to be installed and active.”

Cause: The extension requires Core as a prerequisite. Core provides the authentication system, customer data, and portal infrastructure that Service Management depends on.

Resolution:
1. Install DMSI-DDLS Core if it is not already installed.
2. Activate DMSI-DDLS Core.
3. Attempt to activate DMSI Service Management again.

Dependency Check: WooCommerce Required #

Error message: “DMSI Service Management requires WooCommerce 7.0 or later.”

Cause: WooCommerce is required for Action Scheduler (background jobs) and for service contract sales integration.

Resolution:
1. Install WooCommerce version 7.0 or later.
2. Activate WooCommerce.
3. Activate DMSI Service Management.

PHP Version Check #

Error message: “DMSI Service Management requires PHP 7.4 or later. Your server is running PHP X.X.”

Cause: The plugin uses PHP features introduced in 7.4 (typed properties, arrow functions) that are not available in earlier versions.

Resolution: Upgrade your server’s PHP version to 7.4 or later. PHP 8.0 or 8.1 is recommended for best performance and security.

Database Error on Activation #

Symptom: Activation completes without an explicit error message, but the plugin does not appear to work correctly. The WordPress debug log contains database errors.

Cause: The installer creates 11 database tables and adds 8 columns to Core’s support_contracts table using dbDelta(). If the database user does not have CREATE TABLE or ALTER TABLE privileges, this will fail silently.

Resolution:
1. Check the WordPress debug log at wp-content/debug.log for database errors.
2. Confirm the WordPress database user has CREATE and ALTER privileges.
3. If the database user’s privileges cannot be changed, contact your hosting provider.
4. After fixing privileges, deactivate and reactivate the plugin to re-run the installer.

White Screen After Activation #

Symptom: After activating the plugin, the WordPress admin shows a white screen (PHP fatal error).

Cause: A PHP fatal error occurred during activation. This typically indicates a PHP version incompatibility or a conflict with another plugin.

Resolution:
1. Enable WordPress debug mode by adding define('WP_DEBUG', true); to wp-config.php.
2. Reload the page to see the actual error message.
3. If the error references another plugin, check for conflicts by deactivating other plugins one by one.
4. If the error references PHP syntax, verify your PHP version meets the minimum requirement (7.4+).