What it does…

This code snippet provides a way to deactivate specific plugins on staging and non-production sites. It checks if the current site URL contains any of the specified staging keywords, indicating a staging environment. If it is a staging site or if the deactivations are forced, it filters out the specified plugins from the list of active plugins. This prevents those plugins from being loaded and executed on the site.

Why it does it…

Deactivating specific plugins on staging and non-production sites is important because it helps prevent any unintended effects or conflicts that may arise from having certain plugins active during development or testing. By selectively deactivating these plugins, developers can ensure a clean and controlled environment for their work, without the risk of interfering with the site’s functionality or introducing bugs.

How it does it…

– The code defines a class called `Deactivate_Plugins_On_Staging` that contains the functionality for deactivating plugins on staging sites.
– The class has a private variable `$stagingKeywords` that holds an array of keywords used to detect staging environments. These keywords include ‘staging’, ‘dev’, ‘local’, ‘test’, ‘sandbox’, and ‘demo’.
– There is another private variable `$forceDeactivations` that can be set to true to force the deactivation of plugins regardless of the environment detection.
– The class has a constant `PLUGINS_TO_DEACTIVATE_ON_STAGING` that lists the slugs of the plugins to be deactivated on staging sites.
– The constructor of the class checks if the deactivations should be applied based on the `$forceDeactivations` setting or if the site is detected as a staging site. If so, it adds a filter to the `option_active_plugins` hook, which calls the `deactivatePluginsOnStaging` method.
– The `isStagingSite` method checks if the current site URL contains any of the staging keywords. It converts the site URL to lowercase and compares it with each keyword. If a match is found, indicating a staging environment, it returns true.
– The `deactivatePluginsOnStaging` method takes the list of currently active plugins’ file paths as a parameter. It iterates over the `PLUGINS_TO_DEACTIVATE_ON_STAGING` array and deactivates the specified plugins by filtering them out from the list of active plugins. It supports wildcard matching for plugin slugs, allowing for more flexibility in specifying plugins to deactivate.
– If a plugin slug in `PLUGINS_TO_DEACTIVATE_ON_STAGING` contains a wildcard character ‘*’, it is replaced with ‘.*’ to create a regular expression pattern. The `array_filter` function is used to filter out the plugins whose slugs match the pattern.
– If a plugin slug doesn’t contain a wildcard, a direct match is performed by comparing the plugin slug with the path of each active plugin. If a match is found, the plugin is unset from the list of active plugins.
– Finally, the modified list of active plugins is returned, ensuring that the array is correctly indexed.