SampleHQ Request Form

SampleHQ Request Form is a free, standalone WordPress plugin for collecting product sample requests. It includes a local sample library, a drag-and-drop form builder, and a submissions dashboard. No external account is required.

Features:

• Sample Library — Manage product samples with categories, images, SKUs, and descriptions
• Visual Form Builder — Drag-and-drop builder with 17 field types and multi-column layouts
• Sample Picker Field — Lets visitors browse and select products with quantities
• Submissions Dashboard — View, search, filter, star, and export submissions as CSV
• Multi-Step Wizard — Split forms into steps with a progress indicator and per-step validation
• Conditional Logic — Show or hide fields based on other field values
• Gutenberg Block — Native block editor integration
• Elementor Widget — Works with Elementor page builder
• Shortcode — Embed with [samplehq_form id="123"] in any page builder
• WooCommerce Integration — Use WooCommerce products in the sample picker; adds a «Request a Sample» button to product pages
• Spam Protection — Honeypot field, rate limiting, CSRF tokens, and optional Cloudflare Turnstile
• File Uploads — Server-side MIME validation, protected upload directory
• Email Notifications — Admin and submitter emails with theme-overridable templates
• Privacy Controls — Consent field, configurable IP retention, WordPress Privacy API (export and erasure)
• Accessibility — Built following WCAG 2.2 Level AA practices

Third-Party Services

This plugin connects to external services only when you explicitly enable them. No data is sent to any third party by default.

SampleHQ (optional): This plugin can optionally connect to SampleHQ, a sample management platform. When connected, form submissions and sample catalog data are sent to your SampleHQ workspace. No data is sent unless you click «Connect to SampleHQ» in the plugin settings and complete the connection flow. The plugin is fully functional without connecting. All features listed above are free and unlimited regardless of connection status.

• Service URL: https://samplehq.io
• Terms of Service: https://samplehq.io/terms
• Privacy Policy: https://samplehq.io/privacy

Cloudflare Turnstile (optional): When enabled in Settings > Spam Protection, form submissions are verified against the Cloudflare Turnstile API. No data is sent to Cloudflare unless you configure a Turnstile site key and secret.

• Service URL: https://www.cloudflare.com/products/turnstile/
• Terms of Service: https://www.cloudflare.com/website-terms/
• Privacy Policy: https://www.cloudflare.com/privacypolicy/

Source Code

The full source code, including unminified JavaScript and build tools, is available at: https://github.com/codeverbojan/samplehq-request-form

To build from source:

1. Clone the repository
2. Run composer install
3. Run npm install
4. Run npm run build