Appearance

Troubleshooting ​

This guide covers the most common issues encountered when using Essentials for YOOtheme Pro and their solutions.

Plugin Execution Error ​

Error Message: A PHP error was triggered while executing yooessentials plugin.

This error appears when an unexpected issue occurs during the execution of an Essentials feature. The error message will only display while previewing your site within the customizer or when there is an active customizer session.

Solution:

  • Review the complete error message for specific details
  • Check that all required dependencies are installed and up to date
  • If the issue persists, contact support with the complete error message

Corrupted Installation ​

Error Message: The Essentials plugin execution has been prevented due to corrupted installation or altered files.

This error indicates that the Essentials file integrity check has detected corrupted or missing files.

Solution:

  1. Reinstall the plugin manually without uninstalling the previous version
  2. Clear all caches after reinstallation
  3. If the issue persists, contact support for assistance

AbstractRule Class Not Found ​

Error Message: Class "ZOOlanders\YOOessentials\Access\AbstractRule" not found

This fatal error typically occurs when a third-party plugin attempts to access this class before Essentials has been able to declare it.

Solution: Set the third-party plugin to load with lower priority than Essentials in your platform's plugin manager.

Authentication Issues ​

Error Messages:

  • Error validating access token...
  • Token expiration...
  • Authentication failed...

These errors indicate that your access token or session has expired or become invalid.

Solution:

  1. Navigate to Essentials → Advanced → Auths panel
  2. Locate the affected authentication entry
  3. Follow the prompts to re-authenticate
  4. Save your changes and retry the failed action

Why Does This Happen?

Access tokens are automatically extended while actively in use. However, once a token expires, it cannot be renewed automatically and requires manual re-authentication.

SMTP Configuration ​

Question: Where should I configure SMTP credentials for email functionality?

Answer:

  • Joomla: Configure SMTP settings in Global Configuration → Mail Settings
  • WordPress: Install an SMTP plugin such as WP Mail SMTP and configure it within the plugin's settings

Config Contains Duplicates ​

Error Message: Execution Error: Essentials configuration contains duplicates

This issue arises when the Essentials configuration includes multiple entries for the same resource. Regardless of the resource, the resolution process is the same.

Steps to Resolve:

  1. Navigate to the Essentials -> Advanced panel and export the current configuration.
  2. Open the exported configuration file and locate the resources section, eg sources.
  3. Carefully identify and remove any duplicate entries within the resource section.
  4. Save the updated configuration file and re-import it via the Essentials -> Advanced panel.
json
"sources": [
    { "id": "source1", "name": "Source One" },
    { "id": "source1", "name": "Source One" } // Duplicate entry to be removed
]