Samply Documentation

Overview

An “Order a sample” button on product pages: a free or low-price sample added to the cart, one per product, with a limit per order.

• Let customers try first
• Free or paid samples
• Limit per order

Best for: Fabric, paint, flooring, perfume and tea

Installation

1. Download samply-product-samples.zip from My account › My plugins or from your order email. Do not unzip it.
2. In WordPress, go to Plugins › Add New Plugin › Upload Plugin, choose the zip and click Install Now, then Activate.

Requires WordPress 6.0+, PHP 7.4+, WooCommerce 7.0+. Works with any theme, block themes and page builders.

Features

• Order a sample button under add to cart
• Free or at your price, global or per product
• Simple and variable products
• One sample per product, quantity 1
• Maximum samples per order
• Marked as a sample in the cart, order and emails
• Samples do not reduce stock (optional)

Shortcodes

Paste a shortcode in any page, post, widget or page builder text block.

• [samply_preview]

Options of each shortcode are described in the Features above and in the plugin settings page.

For developers

Customize the plugin from your theme’s functions.php or a small plugin, without editing its files (your changes survive updates).

Filters

• samply_active
• samply_sanitize

add_filter( 'samply_active', function ( $value ) {
	// Change $value here.
	return $value;
}, 10, 1 );

Actions

• samply_admin_after_form
• samply_admin_before_form
• samply_admin_form_end

Updates

Updates are free. When a new version is out, it appears in Dashboard › Updates of your WordPress site and you can install it in one click, or turn on automatic updates in Plugins. This works for the zip downloaded from your Woo-Plugins account; older copies can be replaced by downloading the latest version from My plugins. See the changelog.

Frequently asked questions