JP AJAX Search - Troubleshooting

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.

DJ-Catalog2 Products Are Not Found

• Check that the DJ-Catalog2 component is installed and enabled.
• Check that the DJ-Catalog2 source is enabled in JP Ajax Search.
• Check that at least one DJ-Catalog2 search field is enabled, such as product title, SKU, manufacturer, or description.
• Check that the DJ-Catalog2 products are published.
• Check product category state, access level, language, publish up date, and publish down date.
• Enable DJ-Catalog2 debug temporarily if you need to troubleshoot the generated source query.
• Disable DJ-Catalog2 debug again after testing.

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.

DJ-Catalog2 Results Are Missing Images

• Check that the DJ-Catalog2 product has an image assigned in the DJ-Catalog2 product manager.
• Check that the image file exists under the DJ-Catalog2 media image path.
• Check the Missing image behavior setting in JP Ajax Search.
• For tall product images, adjust Thumbnail image fit and Thumbnail image zoom in the Display tab.

Product Thumbnails Look Too Small or Too Cropped

• Use Thumbnail image fit: Cover for normal photo-style thumbnails.
• Use Thumbnail image fit: Contain when the full product image should remain visible.
• Increase Thumbnail image zoom for tall or narrow product images.
• Increase Thumbnail size if the result row has enough space.

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, and score_debug fields.
• 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.