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