Skip to main content

Troubleshooting

This page provides solutions to common issues you might encounter when using FelAIProductAdvisor.

Common Issues​

Recommendations Not Showing​

If recommendations are not showing on your pages, check the following:

  1. API Key Configuration: Make sure your API key is correctly configured in the plugin settings.

  2. Cache: Clear your Shopware cache:

    bin/console cache:clear

  3. JavaScript Errors: Check your browser console for JavaScript errors.

  4. Template Overrides: If you have custom templates, make sure they are correctly overriding the default templates.

  5. Product Data: Ensure your products have sufficient data for the recommendation algorithm to work (descriptions, categories, properties, etc.).

Low-Quality Recommendations​

If the recommendations are not relevant:

  1. Training Data: The recommendation engine needs sufficient data to provide good recommendations. It improves over time as more customers interact with your products.

  2. Algorithm Selection: Try different algorithms in the plugin settings:

    • Collaborative Filtering: Works best with a lot of user interaction data
    • Content-Based: Works best with detailed product attributes
    • Hybrid: A combination of both approaches

  3. Minimum Confidence: Adjust the minimum confidence threshold in the settings.

Performance Issues​

If the recommendations are slow to load:

  1. Caching: Enable caching in the plugin settings.

  2. Limit Recommendations: Reduce the number of recommendations displayed.

  3. Optimize Database: Make sure your database is optimized:

    bin/console dal:refresh:index

  4. Server Resources: Check if your server has sufficient resources.

Error Messages​

"API Key Invalid"​

Your API key is not valid or has expired. Go to the plugin settings and update your API key.

"No Recommendations Available"​

The recommendation engine couldn't find suitable recommendations. This can happen for new products or products with very unique attributes.

"Service Unavailable"​

The recommendation service is temporarily unavailable. Try again later.

Debugging​

Enable Debug Mode​

To enable debug mode, add the following to your .env.local file:

FEL_AI_PRODUCT_ADVISOR_DEBUG=1

This will output additional information to the Shopware log files.

Check Logs​

Check the Shopware logs for errors:

tail -f var/log/prod-*.log

Test API Directly​

You can test the API directly using curl:

curl -X GET "https://your-shop.com/api/fel-ai-product-advisor/recommendations?productId=12345" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contact Support​

If you're still experiencing issues, please contact our support team: