Quick View integration
What is Quick View?
Free Downloads for WooCommerce integrates seamlessly with Quick View plugins, allowing customers to download files directly from Quick View modals without visiting the product page.
Quick View is a feature that displays product details in a popup modal when customers click a "Quick View" button on shop or archive pages. This allows customers to:
- View product details without leaving the shop page
- See product images and descriptions
- Download files immediately (with this plugin)
- Add products to cart (for paid products)
How It Works
When Quick View is enabled and a customer clicks the Quick View button:
- A modal popup opens showing the product
- The plugin detects it's a Quick View context
- Download buttons/forms are displayed in the modal
- Customers can download immediately
- Modal closes after download (or stays open, depending on settings)
Compatible Quick View Plugins
Free Downloads for WooCommerce works with most popular Quick View plugins:
Tested and Compatible
- WooCommerce Quick View (by WooCommerce)
- YITH WooCommerce Quick View (by YITH)
- Quick View for WooCommerce (by Barn2)
- WPC Smart Quick View (by WPClever)
- Astra Quick View (built into Astra theme)
- OceanWP Quick View (built into OceanWP theme)
Theme-Specific Quick View
Many themes include built-in Quick View functionality:
- Astra - Built-in Quick View
- OceanWP - Built-in Quick View
- Flatsome - Built-in Quick View
- Divi - Via Divi BodyCommerce plugin
- Avada - Built-in Quick View
Setup
No special configuration is needed. The plugin automatically detects Quick View contexts and displays download buttons appropriately.
Verify Quick View is Working
- Install and activate a Quick View plugin
- Go to your shop page
- Click "Quick View" on a free download product
- The download button should appear in the modal
If the download button doesn't appear, see Troubleshooting below.
Quick View Behavior
Single File Products
In Quick View, single file products display:
- Download button (or link, based on settings)
- PDF viewer button (if enabled)
- Login message (if login required)
The display matches your plugin settings for single files.
Multiple File Products
For products with multiple files, Quick View displays:
- Individual file links
- Download all button
- Checkboxes (if enabled)
- Based on your display method settings
The display matches your plugin settings for multiple files.
Download Process
When a customer downloads from Quick View:
- Click the download button
- File downloads immediately
- Modal stays open (customer can continue browsing)
- Or modal closes (depends on Quick View plugin settings)
Customizing Quick View Display
Using Plugin Settings
All plugin settings apply to Quick View:
- Button text - Set in Settings > Single Files / Multiple Files
- Button styling - Set in Settings > General > Button classes/CSS
- Display method - Set in Settings > Single Files / Multiple Files
- Login requirements - Set in Settings > General
Using Custom CSS
Style Quick View downloads differently from regular product pages:
/* Target Quick View modal */
.quick-view-modal .somdn-download-button {
background-color: #ff6600;
padding: 12px 24px;
}
/* Or use your Quick View plugin's class */
.yith-quick-view .somdn-download-button {
font-size: 16px;
}
Using Template Overrides
Create Quick View-specific templates:
// In your theme's functions.php
add_filter('somdn_product_page_args', 'custom_quick_view_args');
function custom_quick_view_args($args) {
// Detect Quick View context
if (defined('DOING_AJAX') && DOING_AJAX) {
// Customize args for Quick View
$args['button_text'] = 'Quick Download';
}
return $args;
}
Pro Features in Quick View
The Pro edition features work seamlessly in Quick View:
Email Capture
When email capture is enabled:
- Customer clicks download in Quick View
- Email capture modal opens
- Customer enters email
- Download starts
- Quick View modal remains open
Download Limits
Download limits are enforced in Quick View:
- Limit checks happen before download
- Error messages display in Quick View
- Customers see remaining downloads
Download Tracking
All Quick View downloads are tracked:
- User data is captured
- Download counts are incremented
- Statistics include Quick View downloads
Upgrade to Pro to access email capture, download limits, and download tracking.
Theme Compatibility
Astra Theme
Astra's built-in Quick View works automatically. No configuration needed.
OceanWP Theme
OceanWP's Quick View works out of the box. Enable it in:
Theme Panel > WooCommerce > Quick View
Flatsome Theme
Flatsome's Quick View is compatible. Enable it in:
Theme Options > WooCommerce > Product Page > Quick View
Divi Theme
For Divi, use the Divi BodyCommerce plugin which includes Quick View functionality compatible with Free Downloads.
Troubleshooting Quick View
Download Button Not Showing
If the button doesn't appear in Quick View:
- ✅ Verify Quick View plugin is active
- ✅ Check product is free, downloadable, and virtual
- ✅ Test on regular product page first
- ✅ Clear all caches
- ✅ Check browser console for JavaScript errors
Download Not Working
If clicking the button doesn't download:
- ✅ Check for JavaScript conflicts
- ✅ Disable other plugins temporarily
- ✅ Test with default WordPress theme
- ✅ Check browser console for errors
- ✅ Verify file URLs are accessible
Modal Closes Immediately
If the Quick View modal closes after clicking download:
- This is normal behavior for some Quick View plugins
- Check your Quick View plugin settings
- Some plugins have "Close on add to cart" settings
- This may apply to download buttons too
Styling Issues
If buttons look wrong in Quick View:
- ✅ Check your theme's Quick View CSS
- ✅ Add custom CSS targeting Quick View
- ✅ Use browser inspector to debug
- ✅ Check for CSS conflicts
Multiple Files Not Displaying
If multiple files don't show properly:
- ✅ Check display method settings
- ✅ Verify all files are attached to product
- ✅ Test on regular product page first
- ✅ Check Quick View modal width (may be too narrow)
Best Practices
User Experience
- Test thoroughly: Test Quick View with all your product types
- Mobile testing: Ensure Quick View works on mobile devices
- Clear messaging: Make it obvious files can be downloaded from Quick View
- Consistent styling: Match Quick View buttons to your site design
Performance
- Optimize images: Use optimized product images for faster Quick View loading
- Minimize plugins: Too many plugins can slow Quick View
- Cache properly: Ensure caching doesn't break Quick View functionality
Accessibility
- Keyboard navigation: Ensure Quick View can be navigated with keyboard
- Screen readers: Test with screen readers
- Focus management: Focus should return properly when modal closes
Advanced Customization
Detect Quick View Context
// Check if in Quick View
function is_quick_view() {
return (defined('DOING_AJAX') && DOING_AJAX) ||
isset($_REQUEST['action']) && $_REQUEST['action'] === 'yith_load_product_quick_view';
}
Custom Quick View Button Text
add_filter('somdn_product_page_args', 'custom_qv_button_text');
function custom_qv_button_text($args) {
if (is_quick_view()) {
$args['button_text'] = 'Quick Download';
}
return $args;
}
Hide Features in Quick View
// Hide PDF viewer in Quick View
add_filter('somdn_show_pdf_viewer', 'hide_pdf_viewer_in_qv', 10, 2);
function hide_pdf_viewer_in_qv($show, $product_id) {
if (is_quick_view()) {
return false;
}
return $show;
}
What's Next
- Display Options - Configure button appearance
- Single File Downloads - Single file behavior
- Multiple File Downloads - Multiple file behavior
Upgrade to Pro for email capture and download tracking in Quick View.