GP Cart Button Master – User Guide
Customize WooCommerce add-to-cart buttons with styling, redirects, icons, prices, limits, and mobile floating actions using rules.
1. Introduction
GP Cart Button Master lets you style and control add-to-cart buttons across your shop using rules. Apply fonts, colors, sizes, icons, prices, quantity limits, direct checkout, and a floating button on mobile.
Important: For variable and out-of-stock products, the plugin will not change button text, will not redirect, and will not add icon or price. Styling can still apply.
2. Requirements & Installation
2.1. Requirements
- WordPress 6.2 or newer.
- WooCommerce active.
- PHP 7.4+.
2.2. Installation
- Go to Plugins > Add New > Upload Plugin and upload the ZIP, or copy the folder to
wp-content/plugins/gp-cart-button-master. - Activate the plugin.
- Ensure WooCommerce is active.
- Open WooCommerce > GP Cart Button Master to configure.
3. Key Concepts
- Rules: Each rule has a scope and options. First matching rule applies.
- Scope: All products or Specific products.
- Tabs:
- General – button text and redirection.
- Button Styling – font, weight, size, colors, radius.
- Advanced – icon, price, shake, floating button, custom qty UI, max quantity.
- Archives toggle: Per tab, choose if features apply on shop/category pages.
- Priority: Specific products rules override All products.
4. Special Behavior
- Variable / Out-of-stock: No button text change, no redirect, no icon, no price. Styling may still show.
- Archives control: Each tab has an “Apply on product archives” switch to affect shop loops.
- Specific beats All: If a product is selected in any “Specific products” rule, that rule wins.
5. Creating and Managing Rules
5.1. Add a Rule
- Go to WooCommerce > GP Cart Button Master.
- In the Rules tab, enter a name and click Add Rule.
- Select the rule in the table to edit.
5.2. Set Scope
- Open Rule Scope.
- Choose All products or Specific products.
- If Specific, pick products from the list.
5.3. General
- Enable the tab.
- Set Button text.
- Enable Redirect to checkout or set a Custom redirect URL.
- Optionally enable Apply on archives.
Note: General does not apply to variable or out-of-stock products.
5.4. Button Styling
- Enable the tab.
- Pick font, weight, size, background, text color, radius.
- Optionally enable Apply on archives.
5.5. Advanced
- Enable the tab.
- Toggle Icon, Price, Shake, Floating, Custom quantity UI.
- Set Maximum quantity and enable the limit.
- Optionally enable Apply on archives.
Note: Icon and Price are suppressed on variable and out-of-stock products.
5.6. Save
Click Save Rule. The table shows a summary of active features per rule.
6. Floating Button and Redirect
- Floating: Shows on single product pages when enabled in Advanced. Uses your Styling tab look.
- Direct checkout: If enabled in General, the add-to-cart action redirects to checkout or your custom URL. On archives, this only triggers if General → Apply on archives is enabled. Blocked on variable/out-of-stock.
7. Quantity Limits
- Enable Maximum quantity limit in Advanced and set Max.
- Validation runs on add-to-cart and cart update. Customers see a notice if they exceed the limit.
8. Compatibility Notes
- Works with default WooCommerce buttons and most themes.
- Archive features depend on loop templates using standard WooCommerce classes and hooks.
- Custom builders that replace buttons may require template adjustments.
9. Troubleshooting
9.1. Button text not changing
- Confirm General is enabled.
- Check if the product is variable or out-of-stock. Text changes are blocked for these.
- If on archives, ensure General → Apply on archives is enabled.
9.2. No redirect after add
- Enable General → Redirect to checkout or set a custom URL.
- Enable Apply on archives for shop/category pages.
- Redirect is blocked on variable/out-of-stock products.
9.3. Icon/Price not visible
- Enable them in Advanced.
- They are intentionally suppressed on variable/out-of-stock products.
9.4. Specific rule not taking effect
- Specific rules override “All products.” Ensure the product is included in the rule’s list.
- Save and clear any caches.
10. Disabling or Uninstalling
10.1. Temporarily disable features
Turn off tabs (General/Styling/Advanced) in the rule and save.
10.2. Deactivate or delete
- Go to Plugins and deactivate GP Cart Button Master.
- Delete the plugin if you no longer need it.
11. FAQ
Q1: Can I use different styles per product?
Yes. Create a rule with Specific products scope and configure its Styling and Advanced tabs.
Q2: Will rules stack?
No. The first matching rule applies. Specific-product rules have higher priority than All-products rules.
Q3: Why doesn’t the button say “Buy Now” on a variable product?
General features are disabled on variable/out-of-stock products by design.
Q4: Can I style archive buttons only?
Yes. Enable Styling and its Apply on archives toggle.
Q5: Where to get support?
Visit goalprevail.com or email [email protected].
