Back to Community

Resolving Common PixelYourSite Fatal Errors and Conflicts

Content

Users of the 'PixelYourSite – Your smart PIXEL (TAG) & API Manager' plugin occasionally encounter PHP fatal errors that can cause site crashes or white screens. Based on community reports, these errors often stem from a few common causes. This guide outlines the most frequent issues and their solutions.

Common Error #1: ArgumentCountError (Too Few Arguments)

Error Example: Uncaught ArgumentCountError: Too few arguments to function PixelYourSitePYS::userLogin() or PixelYourSitePYS::woo_is_order_received_page().

Why it Happens: This occurs when a function within the plugin is called without the required number of parameters. This is typically a bug introduced in a specific plugin version.

Solution: The most common fix is to update the plugin. For example, the 'Too few arguments to function' error was reportedly fixed starting from version 9.3.2. Always ensure you are running the latest version of the core PixelYourSite plugin and any associated add-ons (like the Pinterest add-on).

Common Error #2: Call to Undefined Method or Function

Error Examples:

  • Call to undefined method PixelYourSitePinterest::generateEvents()
  • Call to undefined function PixelYourSiteis_order_received_page()
  • Call to undefined function PixelYourSiteTiktok()
  • Call to undefined method GuzzleHttpUtils::chooseHandler()

Why it Happens: These errors happen for a few reasons:

  • Add-on Version Mismatch: The core plugin is updated, but a companion add-on (like the Pinterest add-on) is not, leading to compatibility issues.
  • Missing WooCommerce: The plugin tries to use a WooCommerce-specific function (like is_order_received_page()) when WooCommerce is not active on the site.
  • Plugin Conflicts: A conflict with another plugin, like BackWpUp, can cause issues with shared libraries (like Guzzle).

Solution:

  • Update Everything: Ensure all PixelYourSite plugins and add-ons are updated to their latest versions. If an error appears after a core update, immediately check for updates to your add-ons.
  • Deactivate if WooCommerce is Missing: If you do not use WooCommerce, ensure the WooCommerce integration is turned off within the plugin's settings. If the site crashes and you cannot access the dashboard to change settings, you may need to temporarily deactivate PixelYourSite via your site's file system (e.g., by renaming its folder via FTP/SFTP).
  • Check for Conflicts: Temporarily deactivate other plugins one by one to identify a potential conflict. The 'GuzzleHttp' error, for instance, often requires one of the conflicting plugins to release a compatibility update.

Common Error #3: PHP Version Compatibility

Error Example: Parse error: syntax error, unexpected 'string' (T_STRING), expecting function (T_FUNCTION) or const (T_CONST) in a file like class-consent.php.

Why it Happens: This error is caused by using a PHP version older than 7.4. The plugin uses code syntax (like property typing) that is only supported in PHP 7.4 and above.

Solution: Contact your web hosting provider and request that they upgrade your site's PHP version to at least 7.4, though 8.1 or higher is recommended for better performance and security.

Common Error #4: Plugin Activation & Database Issues

Error Examples:

  • Plugin could not be activated because it triggered a fatal error. often related to Uncaught Error: Cannot unset string offsets.
  • WooCommerce log spam: ERROR FeaturesUtil::declare_compatibility: .../pixelyoursite.php is not a known WordPress plugin.
  • Database errors mentioning MAX_JOIN_SIZE.

Why it Happens: Activation errors can be due to unusual server configurations or file corruption. The 'not a known plugin' warning is often a minor issue with how the plugin declares itself to WooCommerce and is usually just log spam rather than a critical error. Database errors can occur during complex queries.

Solution:

  • For activation errors, try downloading a fresh copy of the plugin and reinstalling it manually.
  • The 'not a known plugin' error has been reported as fixed in later versions. Updating the plugin should resolve it.
  • Database errors may require a plugin update or adjusting your database configuration, which should be handled by your hosting provider.

General Troubleshooting Steps

  1. Update First: The vast majority of these critical errors are patched by the PixelYourSite team in subsequent updates. Always make sure your plugin is up-to-date before attempting more complex troubleshooting.
  2. Update Add-ons: Ensure any premium add-ons (Pinterest, Super Pack, etc.) are updated simultaneously with the core plugin.
  3. Check PHP Version: Verify your server is running a supported PHP version (7.4 or higher).
  4. Conflict Test: Deactivate all other plugins and switch to a default WordPress theme (like Twenty Twenty-Four). If the error disappears, reactivate your plugins and theme one by one to find the culprit.

If you continue to experience issues after trying these steps, the community on independent forums like this one can be a valuable resource for finding workarounds while waiting for official patches.

Related Support Threads Support