Third-Party Extensions

Troubleshooting

Monogram works well with most WordPress plugins, but some categories of plugins need special configuration to avoid conflicts. Here how to handle the most common third-party plugin interactions.

#Caching Plugins

Caching plugins (WP Super Cache, W3 Total Cache, LiteSpeed Cache, WP Rocket) can interfere with Monogram AJAX features if they cache dynamic responses.

What to do:

  • Exclude these AJAX action URLs from page and object caching:

    • jkd_load_more - portfolio and blog load-more pagination
    • jkd_auto_load_post - auto-loading the next post on scroll
    • jkd_set_post_like - post like/unlike functionality
    • jkd_faq_load - FAQ item loading
  • In most caching plugins, add /wp-admin/admin-ajax.php to the exclusion list

  • Always clear your cache after updating the theme or core plugin

If portfolio "Load More" or infinite scroll stops working after installing a caching plugin, AJAX exclusions are almost certainly the fix.

#Security Plugins

Security plugins (Wordfence, Sucuri, iThemes Security, All-In-One Security) may block AJAX requests or flag them as suspicious.

What to do:

  • Whitelist the four AJAX endpoints listed above
  • If the plugin has a firewall, ensure admin-ajax.php POST requests are allowed
  • Check the plugin activity log if features suddenly stop working after installing a security plugin

#Optimization Plugins

Plugins that minify, combine, or defer JavaScript (Autoptimize, WP Rocket's file optimization, Asset CleanUp, Perfmatters) can break Monogram scripts if configured too aggressively.

What to do:

  • Do not defer or async-load main.min.js - it needs to run in order for page transitions and animations to initialize correctly
  • Do not defer GSAP scripts - they must load before the theme main script
  • Do not combine Monogram JavaScript with other plugin scripts
  • If using "delay JavaScript execution" features, exclude main.min.js and block.min.js

Combining or reordering Monogram JavaScript files will break Barba.js page transitions and GSAP animations. The theme already ships optimized, minified bundles - additional optimization provides minimal benefit and high risk.

#Translation Plugins

Monogram includes built-in integration for two translation plugins:

  • Weglot - fully supported, language switcher works with SPA page transitions
  • TranslatePress - fully supported, integrates with Barba.js navigation

Other translation plugins (WPML, Polylang) work for basic translation but may need additional configuration for SPA compatibility. If page transitions cause the language to reset, add ?barba_enabled=false to test - then contact support for integration guidance.

#SEO Plugins

Monogram auto-detects and integrates with popular SEO plugins for breadcrumbs:

  • Yoast SEO - breadcrumbs fully supported
  • Rank Math - breadcrumbs fully supported
  • SEOPress - breadcrumbs supported

The theme outputs its own structured data (JSON-LD) for Organization, WebSite, Article, CreativeWork, and FAQPage schemas. If your SEO plugin also outputs structured data, check Google Rich Results Test to ensure there are no conflicts or duplicates.

#Contact Form Plugins

Monogram includes a dedicated Contact Form 7 Elementor widget (jkd_cf7_widget) that provides styled form output matching the theme design. Other form plugins (WPForms, Gravity Forms, Ninja Forms) work fine but use their own styling - you may need custom CSS to match the Monogram aesthetic.

Boxzilla has built-in theme integration and works correctly with SPA page transitions. Other popup plugins may need to reinitialize after Barba.js page transitions. If popups only appear on the first page load but not after navigating, the plugin likely needs SPA-aware initialization.

Last updated

Was this article helpful?

FIND THE ONE THAT FITS YOUR PROJECT

Import a demo, swap the content, adjust the layout. Modern WordPress under the hood, fast even when the site fills up.