Skip to main content

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:

  1. A modal popup opens showing the product
  2. The plugin detects it's a Quick View context
  3. Download buttons/forms are displayed in the modal
  4. Customers can download immediately
  5. 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

  1. Install and activate a Quick View plugin
  2. Go to your shop page
  3. Click "Quick View" on a free download product
  4. 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:

  1. Click the download button
  2. File downloads immediately
  3. Modal stays open (customer can continue browsing)
  4. 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:

  1. Customer clicks download in Quick View
  2. Email capture modal opens
  3. Customer enters email
  4. Download starts
  5. 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:

  1. ✅ Verify Quick View plugin is active
  2. ✅ Check product is free, downloadable, and virtual
  3. ✅ Test on regular product page first
  4. ✅ Clear all caches
  5. ✅ Check browser console for JavaScript errors

Download Not Working

If clicking the button doesn't download:

  1. ✅ Check for JavaScript conflicts
  2. ✅ Disable other plugins temporarily
  3. ✅ Test with default WordPress theme
  4. ✅ Check browser console for errors
  5. ✅ Verify file URLs are accessible

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:

  1. ✅ Check your theme's Quick View CSS
  2. ✅ Add custom CSS targeting Quick View
  3. ✅ Use browser inspector to debug
  4. ✅ Check for CSS conflicts

Multiple Files Not Displaying

If multiple files don't show properly:

  1. ✅ Check display method settings
  2. ✅ Verify all files are attached to product
  3. ✅ Test on regular product page first
  4. ✅ 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

Upgrade to Pro for email capture and download tracking in Quick View.