Search & Filter 3D Viewer Fix
Resolves compatibility issues between Search & Filter Pro and 3D Viewer plugins using smart conditional loading.
by @erickacevedor · github.com/erickacevedor/search-filter-3d-viewer-fix · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/erickacevedor/search-filter-3d-viewer-fix/archive/refs/heads/main.zipResolves compatibility issues between Search & Filter Pro and 3D Viewer plugins using smart conditional loading.
Description
This plugin fixes compatibility issues between Search & Filter Pro and 3D Viewer plugins that cause JavaScript conflicts preventing 3D models from rendering properly.
The Problem:
- Search & Filter Pro and 3D Viewer have conflicting JavaScript that causes "replaceAll is not a function" errors
- This prevents 3D models from loading on pages where both plugins are active
The Solution:
- Conditional Loading Strategy: Automatically disables Search & Filter scripts on 3D viewer pages
- Allows both plugins to work perfectly in their respective contexts
- No manual configuration required - works automatically
Features:
- ✅ Automatic plugin conflict detection
- ✅ Smart conditional script loading
- ✅ Works with Avada theme
- ✅ No performance impact
- ✅ Admin dashboard notifications
Installation
- Upload the plugin files to
/wp-content/plugins/search-filter-3d-viewer-fix/ - Activate the plugin through the 'Plugins' screen in WordPress
- The plugin works automatically - no configuration needed
Frequently Asked Questions
Does this disable Search & Filter completely?
No! Search & Filter works normally on all pages except those with "3d" or "model" in the URL where it could conflict with 3D Viewer.
Will this affect my site's performance?
No, the plugin is very lightweight and only runs when both conflicting plugins are detected.
What if I only have one of the plugins?
The plugin remains dormant and has no effect if you don't have both Search & Filter and 3D Viewer installed.
Changelog
1.1.0
- Cleaned up code and removed debug elements
- Simplified conditional loading approach
- Improved performance and stability
- Better admin notifications
1.0.1
- Initial release with conditional loading strategy
- Automatic conflict detection and resolution
Screenshots
- Admin notice showing successful conflict detection
- Console logging with debug information
- Before and after comparison of error resolution
Upgrade Notice
1.0.0
Initial release - Install to fix Search & Filter Pro conflicts with 3D Viewer plugins.
Technical Details
How It Works:
- Detection Phase: The plugin scans for active Search & Filter and 3D Viewer plugins on each page load
- Activation: When both plugins are detected, the compatibility layer activates
- Prevention: JavaScript errors are caught and handled gracefully
- Fallback: Safe alternatives are provided for problematic methods
- Monitoring: Continuous monitoring ensures compatibility during AJAX operations
Files Structure:
/wp-content/plugins/search-filter-3d-viewer-fix/
├── search-filter-3d-viewer-fix.php (Main plugin file)
├── assets/
│ ├── js/conflict-fix.js (JavaScript fixes)
│ └── css/plugin-fixes.css (CSS compatibility)
├── readme.txt (This file)
└── LICENSE (GPL license)
Developer Information:
The plugin follows WordPress coding standards and best practices. It's designed to be lightweight, secure, and maintainable.
For developers wanting to extend or customize the plugin:
- Use
sf3d_fix_status()function to check plugin status - Hook into WordPress actions:
sf3d_fix_activated,sf3d_fix_deactivated - Debug object available at
window.sf3dFixDebugwhen WP_DEBUG is true
Support
For support, feature requests, or bug reports:
- Check the FAQ section above
- Enable WP_DEBUG to see detailed logging
- Contact the plugin author through WordPress.org
Credits
Developed to solve a common WordPress plugin conflict. Special thanks to the Search & Filter Pro and 3D Viewer plugin communities for their feedback and testing.
License
This plugin is licensed under the GPL v2 or later.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.