How to Configure Variation Image Settings for Custom Themes in AMS Plugin
Overview
The Variation Image Settings in the AMS Plugin allow you to customize how product variation images are handled, especially when using custom WordPress themes. This feature ensures proper image display for variable products across different theme setups.
Understanding Variation Meta-Keys
What is a Variation Meta-Key?
- A meta-key is a unique identifier used by themes to store and display variation images
- Default WooCommerce has its standard meta-key system
- Custom themes might use different meta-keys for handling variation images
When to Use Custom Meta-Keys
You need to set a custom variation meta-key when:
- Using a custom theme that doesn’t follow WooCommerce defaults
- Experiencing issues with variation image display
- Your theme developer specifically recommends it
Configuration Steps
1. Accessing the Settings
- Go to AMS Plugin Settings
- Locate the “Variation meta-key for custom Themes” section
- Look for the input field with the key icon
2. Setting the Meta-Key
- Leave empty for default WooCommerce behavior (recommended for most users)
- Enter your custom meta-key if required by your theme
- Format example: “theme_variation_images”
Best Practices
Before Making Changes
- Check your current theme documentation
- Consult with your theme developer
- Back up your database
- Test on a staging site if possible
After Making Changes
- Clear your website cache
- Test variable products
- Verify image switching works correctly
- Check mobile responsiveness
Troubleshooting Common Issues
If variation images aren’t displaying correctly:
- Verify the meta-key is correctly entered
- Ensure it matches your theme’s requirements
- Clear cache and refresh
- Check theme compatibility
Tips for Theme Developers
- Document your theme’s meta-key requirements
- Provide clear guidance for users
- Include example configurations
- Support standard WooCommerce implementations when possible
Need Help?
- Contact your theme developer for the correct meta-key
- Review theme documentation
- Reach out to AMS Plugin support
- Test different configurations in a safe environment
Remember: If you’re using a standard WooCommerce theme or aren’t experiencing any issues with variation images, it’s best to leave this field empty and use the default behavior.