Common Issues and Solutions

Along with the power of PageLines and WordPress, comes a few common issues that we see relatively often. These issues come with flexibility and usually have a pretty straight forward solution. We'll go through the most common issues here.

Common Issue #1 - Plugin Incompatibility

The most common issues we see are typically related to plugins.

Some plugins may have issues, like javascript errors, that prevent proper operation of DMS. These plugins may be poorly coded, not up to WordPress standards, or there may be a conflict specific to your combination of extensions (e.g. if two plugins use the same function name or similar).

Typical Symptoms

  1. DMS editor is unresponsive or does not save. (Javascript Issue)
  2. DMS loading screen does not fade away on full load of the site. (Javascript Issue)
  3. Drag and drop or other key functions are buggy or unfunctional. (Javascript Issue)
  4. CSS or Graphics appear strange/ugly/not-as-intended. (CSS Issue)

Diagnosing and Fixing

In order to diagnose if a plugin is causing an error, navigate to your Wordpress Administrator Dashboard → Plugins.

  1. Deactivate ALL plugins
  2. Re-visit your website and check to see if the issue persists

If the issue does not persist, one (or more) of your plugins is causing a conflict with PageLines DMS. To determine which plugin(s) is causing the conflict, follow these steps:

  1. Activate each plugin one by one
  2. Check to see if the issue returns after each plugin is activated

Common Issue #2 - Javascript Error(s)

DMS relies heavily on Javascript (JS) for its drag and drop functionality and handling. Because of this, JS errors can cause a lot of problems with DMS.

If you're experiencing issues with DMS functionality this may be due to JavaScript errors or conflicts. These can be created by a plugin, or potentially by custom code/scripts that you've added.

Luckily, diagnosing JavaScript errors/conflicts can quickly be found with your browsers built-in web developer tools.

Typical Symptoms

  1. DMS editor is unresponsive or does not save. (Javascript Issue)
  2. DMS loading screen does not fade away on full load of the site. (Javascript Issue)
  3. Drag and drop or other key functions are buggy or unfunctional. (Javascript Issue)

Diagnosing and Fixing

  1. In Google Chrome go to the page where you are experiencing the error and navigate to View → Developer → JavaScript Console.
  2. The error console will open. If you don't see any errors try reloading the page. The error may be generated when the page loads.

The console will provide you with the error type, the location of the error and the line number

Note: If you prefer to use another browser, you can find instructions on how to identify JavaScript errors from the Wordpress Codex

Common Issue #3 - PHP Errors

If you encounter a white screen of death (WSOD) or receive a PHP error message preventing you from accessing your site, this may be due to a PHP error. This can be caused by a plugin conflict, server error or database issue.

Typical Symptoms

  1. Incomplete rendering of page.
  2. DMS loading screen does not fade away on full load of the site.
  3. Unresponsive editor or page.

Diagnosing and Fixing

You can usually assume a PHP error if you see incomplete page output (tip: view source), or an actual PHP warning/error printed to your screen.

Debugging PHP errors is made simple as WordPress comes with specific debug systems designed to simplify the process.

  1. Open the wp-config.php file.
  2. Located the following line of code define('WP_DEBUG', false);
  3. Replace false with true like so define('WP_DEBUG', true);

Enabling WP_DEBUG will cause all PHP errors, notices and warnings to be displayed, like the image above.