Woo Audio Preview Pro – Settings Guide

Get Started

 General Settings

Display Settings

Enable Audio Preview

  • Type: Toggle (On/Off)
  • Default: On
  • Description: Master switch to enable/disable audio preview functionality across your entire store
  • Use Case: Turn off temporarily during maintenance or troubleshooting

Product Page Position

  • Type: Dropdown
  • Options:
    • Before Add to Cart Form
    • Before Add to Cart Button (Default)
    • After Add to Cart Button
    • Before Product Summary
    • In Product Summary
    • With Product Thumbnails
  • Description: Controls where the audio player appears on single product pages
  • Tip: Test different positions to find what works best with your theme

Default Configuration

Default Player Theme

  • Type: Dropdown
  • Options: Classic, Dark, Minimal, Colorful
  • Default: Classic
  • Description: Sets the default player appearance for all products
  • Note: Can be overridden per product

Default Preview Duration

  • Type: Number (seconds)
  • Range: 0-300
  • Default: 0 (unlimited)
  • Description: How long audio previews play before stopping
  • Examples:
    • 0 = Full track
    • 30 = 30-second preview
    • 60 = 1-minute preview

Multi-vendor Integration

Vendor Audio Upload

  • Type: Toggle
  • Default: On
  • Description: Allow marketplace vendors to upload audio previews
  • Affects: Dokan, WCFM, WC Vendors users

Player Settings

Player Appearance

Show Waveform

 

  • Type: Toggle
  • Default: Off
  • Description: Display visual waveform representation of audio
  • Impact: Adds visual interest but may increase load time

Show Time Display

 

  • Type: Toggle
  • Default: On
  • Description: Shows current playback time and total duration
  • Format: 0:00 / 3:45

Player Width

  • Type: Text
  • Default: 100%
  • Examples:
    • 100% (responsive)
    • 400px (fixed)
    • 80% (percentage)
  • Description: Controls player width on the page

Player Behavior

Autoplay

  • Type: Toggle
  • Default: Off
  • Description: Automatically start playing when page loads
  • Warning: Most browsers block autoplay with sound

Loop Playback

  • Type: Toggle
  • Default: Off
  • Description: Automatically restart audio when it ends
  • Use Case: Good for short ambient samples

Sticky Player (PRO)

  • Type: Toggle
  • Default: Off
  • Description: Keep player visible when scrolling
  • Behavior: Player sticks to top/bottom of viewport

Player Colors

Primary Color

  • Type: Color Picker
  • Default: #667eea
  • Affects: Progress bar, buttons, active states

Background Color

  • Type: Color Picker
  • Default: #f3f4f6
  • Affects: Player background area

Text Color

  • Type: Color Picker
  • Default: #374151
  • Affects: Time display, track names, labels

Watermark Settings

Watermark Configuration

Enable Watermark

  • Type: Toggle
  • Default: Off
  • Description: Add audio watermark to all preview clips
  • Purpose: Protect your audio from unauthorized use

Watermark Type

  • Type: Dropdown
  • Options:
    • Voice Overlay (Default)
    • Beep Sound
    • Custom Audio
  • Description: Choose how to watermark your audio

Voice Overlay Text

  • Type: Text
  • Default: “This is a preview”
  • Visible When: Watermark Type = Voice Overlay
  • Note: Requires text-to-speech API

Custom Watermark Audio

  • Type: File Upload
  • Visible When: Watermark Type = Custom Audio
  • Format: MP3 recommended
  • Tip: Create a branded audio watermark

Watermark Placement

Watermark Interval

  • Type: Number (seconds)
  • Range: 5-60
  • Default: 10
  • Description: How often the watermark repeats

Watermark Volume

  • Type: Slider
  • Range: 10%-100%
  • Default: 30%
  • Description: Volume level of watermark relative to main audio

Fade Effect (PRO)

  • Type: Toggle
  • Default: On
  • Description: Smooth fade in/out for watermark
  • Result: More professional, less jarring

Advanced Protection

Prevent Download

  • Type: Toggle
  • Default: On
  • Description: Disable right-click download option
  • Note: Basic protection, not foolproof

Advanced Settings

Performance Settings

 

Lazy Load Players

  • Type: Toggle
  • Default: On
  • Description: Load players only when visible
  • Benefit: Faster initial page load

Preload Strategy

  • Type: Dropdown
  • Options:
    • None (Default) – Load when play clicked
    • Metadata Only – Load duration/info
    • Auto – Preload entire file
  • Trade-off: Performance vs. instant playback

Buffer Size

  • Type: Number (seconds)
  • Range: 10-120
  • Default: 30
  • Description: Audio buffer for smooth playback
  • Higher: Better for slow connections

CDN & Storage

Enable CDN Support

  • Type: Toggle
  • Default: Off
  • Description: Serve audio files from CDN
  • Benefit: Faster global delivery

CDN URL

  • Type: URL
  • Example: https://cdn.example.com
  • Visible When: CDN Support enabled
  • Setup: Point to your CDN service

External Storage (PRO)

  • Type: Dropdown
  • Options:
    • Local Server (Default)
    • Amazon S3
    • DigitalOcean Spaces
  • Description: Store audio files externally
  • Benefit: Reduce server load

Developer Options

Debug Mode

  • Type: Toggle
  • Default: Off
  • Description: Enable detailed logging
  • Warning: Only for troubleshooting

Custom CSS

  • Type: Textarea
  • Description: Add custom styling
  • Example: 
    .wcap-player {
  border: 2px solid #000;
}

REST API (NEW)

  • Type: Toggle
  • Default: Off
  • Description: Enable REST API endpoints
  • Use: Custom integrations

Settings Management

Import/Export

 

  • Export settings for backup
  • Import to restore or copy between sites
  • Format: JSON file

Reset Options

  • Reset to defaults if needed
  • Individual sections or all settings
  • Confirmation required

Best Practices

 

  1. Start Simple: Use defaults, then customize
  2. Test Changes: Preview on frontend after saving
  3. Mobile Check: Verify settings work on mobile
  4. Performance: Balance features with load time
  5. Security: Enable protection for valuable content
Last updated: November 21, 2025