bookmark_borderGravity Forms Debug Add-on

Why use the GF Debug Add-On? The Debug Add-on provides a Conflict Tester tool which allows you to test for a theme/plugin conflict without impacting the site for other users. The conflict test will only apply to the user who initiated it. The site will continue functioning normally for all other users and visitors.

The Debug Add-On is available as an early-access beta. We recommend only using this beta version if you have FTP access to your server and are comfortable removing plugins via FTP.

The Debug Add-On is not compatible with multi-site installations.

Installing the Debug Add-On

Currently, the Debug Add-On must be installed manually and is only recommended for single site WordPress installations. To install, follow the directions below:

  1. Download the add-on plugin: Gravity Forms Debug Add-On
  2. Upload the plugin folder and files via FTP to your wp-content/plugins folder – OR – upload the plugin zip file via the “Add New” plugin menu in WordPress.
  3. Activate the “Gravity Forms Debug Add-On” plugin you just uploaded.

Enabling the Conflict Tester

The Debug Add-on currently provides a single module called the Conflict Tester. The Conflict Tester allows you to easily disable all themes and plugins on your site for the current user. The original theme and activated plugins will continue to load for all other users/visitors on your website.

  1. Go to the “Debug” menu under “Forms” in your WordPress admin menu. The “Conflict Tester” tab will be selected by default.
  2. Before enabling the Conflict Tester, make sure to copy the “Disable Link” to your clipboard which can be used to disable the conflict tester if you encounter any issues.
  3. Click the “Enable Conflict Tester” button.

The Conflict Tester is now enabled. If any WordPress default theme is installed, it will now be activated. All plugins except Gravity Forms and the Debug Add-On have now been deactivated.

Remember, these changes only apply to you and will be reverted to their original state once the Conflict Tester has been disabled. The site will continue functioning normally for all other users and visitors.

The purpose of the Conflict Tester is to help you identify if your theme or any activated plugins are causing a conflict with Gravity Forms. When the Conflict Tester is initially activated, a default WordPress theme will be activated (if available) and all plugins will be deactivated.

You are now ready to activate plugins within the Conflict Tester.

Activating Plugins with Conflict Tester

To activate a plugin:

  1. Click on the plugin label or corresponding checkbox.
  2. Click the “Save Active Plugins” button next to the “Plugins” setting (above the plugin lists).

Deactivating Plugins with Conflict Tester

To deactivate a plugin:

  1. Click on an active plugin label or corresponding checkbox.
  2. Click the “Save Active Plugins” button next to the “Plugins” setting (above the plugin lists).

Disabling the Conflict Tester

When you have completed your theme/plugin conflict test, you can disable the Conflict Tester by following the directions below:

  1. Go to the “Debug” menu under “Forms” in your WordPress admin menu. The “Conflict Tester” tab will be selected by default.
  2. Click the “Disable Conflict Tester” button.

Disabling the Conflict Tester via “Disable Link”

In some rare cases, activating the Conflict Tester will cause an error and the Conflict Tester page will not load. Don’t worry. You can use the “Disable Link” you copied before activating the Conflict Tester to disable the Conflict Tester. Paste the URL into your browser’s address bar and hit enter.

If you forgot to copy this link, you can manually add the required query string parameter to your site URL to disable the Conflict Tester.

http://yoursite.com/?gf_disable_conflict_tester=1

Disabling the Conflict Tester via FTP

Theoretically, this should never happen; however, if you find no other method is working for disabling the Conflict Tester, you can delete the plugin via FTP. To do so, follow these steps:

  1. Connect to your server via FTP.
  2. Navigate to: {wp_root}/wp-content/mu-plugins/
  3. Delete the gf_mu_debug.php file.

FAQ

  1. I’ve activated the Conflict Tester and I can no longer access the Conflict Tester page. How do I disable it?

    See the Disabling the Conflict Tester via Disable Link and Disabling the Conflict Tester via FTP sections above.

  2. I don’t have a default WordPress theme installed. What should I do?

    To complete a full theme/plugin conflict test, you will need to install a WordPress default theme. You can do so from your WordPress admin by following the steps below.

    1. Navigate to Appearance > Themes.
    2. Click the “Add New” button next to the header.
    3. Use the search to search for “Twenty Fifteen”.
    4. Mouse over the “Twenty Fifteen” theme and click the “Install” button.

    Alternately, you can manually install the theme here:

    Twenty Fifteen