Back to Community
Home / Community / Plugin → Wpcode

Troubleshooting Common WPCode Snippet Issues: From Caching to Code Errors

31 threads Sep 9, 2025 Plugin → Wpcode

Content

WPCode is a powerful tool for adding custom functionality to your WordPress site without editing theme files. However, like any advanced plugin, users can sometimes run into issues. Based on common community reports, this guide covers the most frequent problems and their solutions.

1. Snippet Output Not Appearing (Caching Conflicts)

The Problem: Your PHP snippet works perfectly when your site's cache is disabled but seems to have no effect when caching is enabled. This is a common issue, as seen in Thread 25.

Why It Happens: Caching plugins serve static HTML files to visitors. PHP code, like a snippet that populates a form field with a dynamic value (e.g., $_SERVER['HTTP_REFERER']), cannot execute from a cached page. The PHP must run on the server before the page is cached to generate the correct value.

The Solution: For snippets that rely on real-time, user-specific data, you must exclude the affected pages from your caching plugin's settings. Consult your caching plugin's documentation for instructions on excluding specific URLs or pages from being cached.

2. "Cannot Redeclare Function" Error

The Problem: You see a fatal error in your logs stating that a function cannot be redeclared. This often occurs when using the same shortcode snippet in multiple posts, as highlighted in Threads 10 and 12.

Why It Happens: If your shortcode snippet contains a function declaration (e.g., function my_custom_function() { ... }), that function is defined every time the shortcode is rendered on a page. If two posts using the same shortcode are loaded, PHP tries to define the function a second time, causing a conflict.

The Solution: Always wrap your function declarations in a check for function_exists().

if ( ! function_exists( 'my_custom_function' ) ) {
    function my_custom_function() {
        // Your code here.
    }
}

Alternatively, restructure your code to avoid declaring functions within shortcodes if possible.

3. Shortcode Attributes Not Being Passed to Variables

The Problem: Your shortcode uses custom attributes (e.g., [wpcode id="123" lang="fr"]), but the variables within the snippet are empty. This was a confirmed bug after an update, as noted in Thread 3.

Why It Happens: This was a specific plugin bug that has since been fixed. However, it serves as a reminder to always keep your plugins updated.

The Solution: Ensure you are running the latest version of the WPCode plugin. The WPCode team promptly addressed this issue in an update. If you encounter a similar problem, check for a plugin update first.

4. Snippet Automatically Deactivates Due to an Error

The Problem: You try to activate a snippet, but it is automatically deactivated, often with a syntax error message like "Unclosed '{' on line 1" (Thread 16) or a generic fatal error (Thread 11).

Why It Happens: This is a safety feature of WPCode. If a snippet contains a syntax error or causes a fatal error upon activation, the plugin will deactivate it to prevent bringing down your entire site.

The Solution:

  • Check for Syntax Errors: Carefully review your code for missing semicolons, unclosed brackets, parentheses, or quotation marks. Using a code editor like VS Code before pasting can help catch these.
  • Enable Error Logging: In your WPCode settings, enable the error logging feature. This will provide a more detailed error message in WPCode > Tools > Logs, helping you pinpoint the exact issue.
  • Test in a Staging Environment: Always test new code on a staging site before deploying it to your live website.

5. PHP Code Not Executing (Using Script Tags)

The Problem: You try to insert PHP code using <?php ... ?> tags in an HTML or text block, but it just renders as text on the page, as mentioned in Thread 18.

Why It Happens: WordPress does not execute PHP code from post or page content by default for security reasons. The <?php ?> tags are treated as plain text.

The Solution: This is exactly what WPCode is for. Instead of pasting the raw PHP into your page:

  1. Create a new PHP Snippet in WPCode.
  2. Paste your PHP code into the code editor (without the <?php and ?> tags).
  3. Set the insertion method to "Shortcode."
  4. Copy the generated shortcode and paste it into your post or page.
The shortcode will now execute your PHP code correctly when the page is loaded.

Conclusion

Most common WPCode issues stem from caching conflicts, code syntax errors, or misunderstandings about how to structure snippets. By following the troubleshooting steps outlined above—checking for caching, using function_exists(), ensuring the plugin is updated, and leveraging the built-in error logging—you can resolve most problems and harness the full power of custom code on your WordPress site.

Related Support Threads Support