CC Free Shipping Documentation
Comprehensive documentation for the CC Free Shipping plugin for WooCommerceTable of contents
1. introduction
2 Installation
3. license activation
4. basic configuration
5. message settings
6. display locations
7. appearance styling
8. advanced settings
9. multi-currency support
10. troubleshooting
11 FAQS.
Completion of CC Free Shipping documentation
12 Using the shortcode
13. integration with Gutenberg
14 Troubleshooting the shortcode
1. introduction
CC Free Shipping is a professional plugin for WooCommerce that allows you to configure free shipping after exceeding a certain order threshold and display personalized messages to encourage customers to increase their cart value.The plugin allows full control over:
- free shipping threshold
- content of messages
- display locations
- visual style of notifications
- advanced options for calculating the threshold
2 Installation
System requirements- WordPress 5.0 or later
- WooCommerce 3.0 or later
- PHP 7.0 or later
- Download the ZIP file of the plugin from official store
- Log in to your WordPress admin panel
- Go to: Plugins > Add New > Submit Plugin
- Select the downloaded ZIP file and click "Install Now".
- When the installation is complete, click "Enable plug-in"
3. license activation
It is necessary to activate the license before using the plugin:After installation, go to: COCOS. > License cc_free_shipping
Enter the license key you received after purchase
Click "Activate License"
After successful activation, you will see a confirmation message
Tip
Without an active license, the plugin will operate in preview mode, without the ability to edit settings.
4. basic configuration
To configure the basic settings of the plugin:- Go to: WooCommerce > Settings > Shipping > Free Shipping.
- Set the following options:
Specify the minimum order amount, beyond which the customer will receive free shipping. The value is given in the default currency of the store.
Taking into account discount coupons
Enable this option if you want the value of discount coupons to be subtracted from the cart value before checking the free shipping threshold.
Consideration of additional charges
Enable that additional charges with a negative value (reducing the value of the shopping cart) are taken into account when calculating the free shipping threshold.
Disabling CSS styles
Check this option if you want to completely disable the default CSS styles and use only your own styles.
5. message settings
In this section you can customize the content of messages displayed to customers:Message below the threshold
Text displayed when the customer has not yet reached the free shipping threshold. Use {remaining}, to display the missing amount.
Message above threshold
Text displayed when a customer has reached the free shipping threshold.
Message at checkout (below threshold)
A special message displayed on the checkout page when the customer has not reached the threshold.
Message at checkout (above threshold)
A special message displayed on the checkout page when a customer has reached the threshold.
Text by shipping method
Text displayed next to the shipping method that has been included in the free delivery.
6. display locations
Select where free shipping messages should be shown:Basket
Display a message on the shopping cart page.
Order page
Display a message on the order (checkout) page.
Before payment methods
Display a message immediately before selecting payment methods.
7. appearance styling
Full control over the appearance of messages:Text colors
Separate settings for messages below and above the threshold.
Background colors
Message background for both states (below/above threshold).
Frame colors
Frame color for both message types.
Frame size
The thickness of the border in pixels.
Rounding the border
Radius of rounded corners in pixels.
Font size
Text size in pixels.
8. advanced settings
Custom CSSEnter your own CSS code to fine-tune the appearance of the messages to your theme. The CSS will be active even if you disable the plugin's default styles.
Sample CSS code:
.ccfs-message {
margin: 15px 0;
font-weight: bold;
}
.ccfs-message.below-threshold {
border-style: dashed !important;
}
.ccfs-message.above-threshold {
text-transform: uppercase;
}
9. multi-currency support
CC Free Shipping supports the most popular currency plugins:- WOOCS - WooCommerce Currency Switcher
- Aelia Currency Switcher
- WPML + WooCommerce Multilingual
- WooCommerce Multi-Currency
- Currency Switcher for WooCommerce by WP Desk.
10. troubleshooting
Messages are not displayed- Check if WooCommerce is configured correctly
- Make sure the license is active
- Check that the correct display locations are enabled
- Verify that there are no conflicts with other plugins
- Check that the threshold value is set correctly
- If you use multiple currencies, make sure the exchange rates are up to date
- Check your settings for including coupons and fees
- Check that your theme does not overwrite the plugin styles
- Try adding custom CSS in the advanced section
- Consider disabling the default styles and implementing your own
11 FAQS.
Does the plugin work with any shipping method?Yes, CC Free Shipping is compatible with all shipping methods available in WooCommerce.
Can I have different thresholds for different shipping methods?
No, the plugin currently supports one global free shipping threshold for all methods.
Does the plugin affect site performance?
CC Free Shipping is designed with performance in mind and has minimal impact on page loading speed.
Are the messages responsive?
Yes, all messages are fully responsive and look good on mobile devices.
Does the plugin support translations?
Yes, all plugin texts can be translated using standard WordPress tools such as Loco Translate or WPML.
How often is the plugin updated?
The plugin is regularly updated to ensure compatibility with the latest versions of WordPress and WooCommerce.
What if I need support?
Technical support is available after purchasing a license. Contact us via support page.
Completion of CC Free Shipping documentation
12 Using the shortcode
CC Free Shipping offers a convenient shortcode that allows you to place free shipping messages anywhere in your store, including in the content of pages, posts and widgets.Basic use of the shortcode
The basic shortcode displays the standard free shipping message:
[cc_free_shipping]Adjusting the message type
The shortcode allows you to specify the type of message to be displayed using the parameter type:
[cc_free_shipping type="checkout"].- cart - standard cart message (default) -
- checkout - message displayed on the checkout page -
- payment - message displayed before payment methods
Application examples:
1. add a message about free shipping on the homepage:
[cc_free_shipping] 2. add the checkout message in the sidebar widget:
[cc_free_shipping type="checkout"].3. adding a payment message in the content of the product page:
[cc_free_shipping type="payment"].Tip
Messages displayed by the shortcode are automatically updated after changes in the shopping cart thanks to AJAX, just like standard messages.
13. integration with Gutenberg
Important
If you are using the Gutenberg editor, free shipping messages must be added via shortcode, as WooCommerce dynamic hookups do not work automatically in Gutenberg blocks.
- Edit a page or post in the Gutenberg editor
- Add a "Shortcode" block (find it in the block finder or in the "Widgets" section)
- Enter the appropriate shortcode in the block field: [cc_free_shipping] Or with a type of your choice, such as. [cc_free_shipping type="checkout"].
- Save and publish the page
Adding in WooCommerce Blocks
If you are using WooCommerce Blocks (e.g. Cart or Checkout in block form), you can add a free shipping message using:
- "HTML custom" block in the appropriate place in the cart/checkout layout
- In the block field, type the shortcode in HTML format:
[cc_free_shipping]
.
Advice
For the best integration with WooCommerce blocks, we recommend placing the shortcode in the "Custom HTML" block rather than the standard "Shortcode" block.
<!-- wp:woocommerce/cart -->
<div class="wp-block-woocommerce-cart is-loading">
<!-- wp:html -->
[cc_free_shipping]
<!-- /wp:html -->
<!-- wp:woocommerce/cart-items-block -->
...
<!-- /wp:woocommerce/cart-items-block -->
</div>
<!-- /wp:woocommerce/cart -->
14 Troubleshooting the shortcode
If the message displayed by the shortcode does not appear or does not update properly: - Check if the WooCommerce shopping cart is active - The shortcode requires an active shopping cart object.
- Enable JavaScript debugging - Check your browser console for AJAX errors.
- Make sure the shortcode ID is unique - Avoid putting multiple shortcodes of the same type on one page.
- Check for conflicts with other plugins - Some plugins can capture AJAX events.
Information
The shortcode only works on front-end pages. It will not work in the admin panel or in the Gutenberg editor preview.
