JP AJAX Search - Troubleshooting
Article Index
- JP AJAX Search
- How to install & use
- Basic Module Settings
- Using Language Constants in Text Fields
- Source Status Overview
- Joomla Articles Source
- Product Sources
- Phoca Cart Source
- HikaShop Source
- J2Commerce Source
- OCH Subscriptions Source
- Document and File Sources
- jDownloads Source
- DOCman Source
- eDocman Source
- Event Sources
- Event Booking Source
- JEvents Source
- Frontend Style Presets
- Display Settings
- Smart Relevance Ranking
- Access Levels and Visibility
- Frontend Testing
- Troubleshooting
- Developer Notes
- Recommended Setup
- All Pages
Page 24 of 26
Troubleshooting
No Results Are Shown
- Check that the module is published.
- Check that the module is assigned to the current menu item.
- Check the minimum characters setting.
- Check that at least one source is enabled.
- Check that the related component is installed and enabled.
- Check source-specific search fields.
- Check Joomla access levels and publishing state.
Load More Does Not Appear
- Check that Load more is enabled in the Display tab.
- Check that more results exist than the current Result limit.
- Check Maximum dropdown results.
Wrong or Missing Images
- Check whether the result actually has an image in the source component.
- For Joomla Articles, check the Intro Image and Full Article Image fields.
- Check the Missing image behavior setting.
- Check the fallback image setting.
Non-SEF Article URLs
- JP Ajax Search uses Joomla routing for article URLs.
- If an article has a direct menu item, Joomla should normally generate the proper SEF URL.
- If no suitable menu item exists, Joomla may generate a fallback URL.
- Check your Joomla menu structure if an article URL does not look as expected.
Invalid AJAX JSON
If AJAX responses become invalid JSON, check whether another extension is printing PHP warnings, notices, or deprecated messages before the JSON response.
JP Ajax Search isolates provider errors where possible, but output emitted earlier by another extension can still break JSON responses.
Smart Relevance Looks Unexpected
- Enable Ranking debug temporarily.
- Check the returned
score,final_score, andscore_debugfields. - Remember that source priority is only a small boost in Smart relevance mode.
- Disable Ranking debug again after testing.
Frontend Style Looks Wrong
- Check the Frontend style preset in the Display tab.
- Use UIkit / YOOtheme for YOOtheme Pro and UIkit-based websites.
- Use Bootstrap 5 for Bootstrap-based Joomla templates.
- Use Generic / JP Ajax Search CSS for custom templates or lightweight builds.
- Check custom CSS classes and dropdown color settings if the layout needs site-specific styling.
