Cache Optimization Setting - User Guide

ZeobvBundleProducts -  "Only invalidate cache when product availability changes" Configuration Guide.

## What is "Only invalidate cache when product availability changes"?

This setting helps improve your shop's performance by reducing unnecessary cache clearing. When enabled, the system only clears cached data when a product's availability actually changes (from available to unavailable or vice versa), rather than clearing cache every time any product data is updated.

### Scenario: A bundle product contains 3 items
1. Product A - 10 in stock (Available)
2. Product B - 5 in stock (Available)
3. Product C - 0 in stock (Unavailable)

### What happens when stock changes:

**Without the setting:**
- Customer buys Product A → Stock changes from 10 to 9
- System clears ALL cache for the bundle
- Pages reload slower for other customers

With the setting enabled:
- Customer buys Product A → Stock changes from 10 to 9
- Product A is still available (stock > 0)
- ✅ No cache clearing needed - pages stay fast!

When cache WILL be cleared:
- Product B stock goes from 1 to 0 (Available → Unavailable)
- Product C gets restocked from 0 to 5 (Unavailable → Available)
- ✅ Cache cleared only when needed

## Where to find this setting

1. Go to your Shopware admin panel
2. Click Extensions → My Extensions
3. Find ZeobvBundleProducts plugin
4. Click Configuration
5. Look for "Only invalidate cache when product availability changes"

## When to enable this setting

## What this affects

### Bundle Products
- When items in a bundle change stock levels
- When bundle availability is recalculated
- When bundle products are indexed

## Important things to know

### This only affects availability changes
- Stock going from 5 to 4 = No cache clear (still available)
- Stock going from 1 to 0 = Cache cleared (becomes unavailable)
- Stock going from 0 to 1 = Cache cleared (becomes available)

### Other changes still trigger cache updates
- Price changes
- Product name changes
- Description updates
- Image changes

### It's specifically for bundle products
- This setting only affects how bundle products handle cache
- Regular products follow normal Shopware caching rules

## Troubleshooting

### "My product availability isn't updating immediately"
This is expected behavior when the setting is enabled. The system waits for actual availability changes rather than updating on every stock change.

### "I need immediate updates for my integration"
Consider disabling this setting if you have:
- Real-time inventory systems
- Third-party integrations requiring instant updates
- Custom code depending on immediate cache clearing

## Summary

This setting is a simple performance optimization that reduces unnecessary work for your server. For most shops, enabling it will provide better performance with no noticeable downsides. The key benefit is that your shop will run faster during busy periods while still showing accurate product availability to customers.