=== FeeNudge Fee Rules for WooCommerce ===
Contributors: cartchargex
Tags: woocommerce fees, conditional fees, checkout fees, cart fees, fee rules
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
WC requires at least: 8.0
WC tested up to: 10.9.4
Requires Plugins: woocommerce
Stable tag: 0.2.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create flexible WooCommerce fee rules, conditional checkout fees, discounts, and basic cart messages without custom code.

== Description ==

FeeNudge helps WooCommerce stores create smart fees and checkout rules without custom code.

The free version includes core Fee Rules, starter templates, basic Smart Messages, cart/checkout display controls, and Fee Rules and Smart Product Groups import/export. It is fully useful on its own for many common store fee scenarios.
FeeNudge Free is fully functional on its own. Optional add-ons and other Premium features are delivered only in the separately distributed FeeNudge Premium package and are not included in this WordPress.org package.

A separately distributed FeeNudge Premium package adds optional add-ons, product-page offers, payment fees, shipping rules, regional fees, customer groups, bundle rules, advanced Smart Messages, and reporting. Those implementations are not included in the WordPress.org Free package.


=== Common WooCommerce Fee and Discount Use Cases ===

Use FeeNudge when your WooCommerce store needs flexible fee or discount logic without custom code.

* Add a small order fee when cart subtotal is below a set amount.
* Add recycling, disposal, installation, handling, or service fees.
* Create fixed or percentage-based WooCommerce checkout fees.
* Show smart cart and checkout messages before a fee or offer applies.
* Target rules by product, category, tag, cart subtotal, quantity, weight, or checkout context.
* Create customer-facing labels so shoppers understand why a fee or discount appears.
* Use starter templates to build common WooCommerce fee rules faster.
* Import and export Fee Rules and Smart Product Groups for backups, staging, and repeat setups.

Free includes core Fee Rules, starter templates, basic Smart Messages, display controls, and Fee Rules and Smart Product Groups import/export. A separately distributed FeeNudge Premium package adds optional add-ons, product-page offers, payment fees, shipping rules, regional fees, customer groups, bundle rules, advanced Smart Messages, and reporting. Those implementations are not included in the WordPress.org Free package.


=== Cart and Checkout Compatibility ===

FeeNudge Free supports basic Fee Rule and Smart Message display on supported WooCommerce cart and checkout pages, including supported Cart and Checkout Block contexts.

FeeNudge Free also includes manual placement shortcodes for eligible Free Smart Messages:

* [feenwcf_smart_messages context="cart"]
* [feenwcf_smart_messages context="checkout"]

FeeNudge Pro adds advanced cart and checkout presentation, Optional Services, mini-cart support where compatible, FunnelKit compatibility controls, and custom insertion selectors for supported third-party layouts. Compatibility can vary by theme, cart drawer, checkout builder, block implementation, and template customization, so stores should test affected cart and checkout pages after setup.

=== Free vs Premium ===

= Free =

* Core Fee Rules.
* Fixed and percentage fees.
* Starter templates.
* Basic Smart Messages.
* Cart/checkout display controls.
* Fee Rules and Smart Product Groups import/export.

= Premium =

* FeeNudge Pro Optional add-ons.
* FeeNudge Pro product-page offers.
* FeeNudge Pro payment fees.
* FeeNudge Pro shipping rules.
* FeeNudge Pro regional fees.
* FeeNudge Pro customer groups.
* FeeNudge Pro bundle rules.
* FeeNudge Pro Advanced Smart Messages.
* FeeNudge Pro reporting.


== External services ==

FeeNudge uses the following external services.

= Freemius =

FeeNudge includes the Freemius SDK for licensing, account management, in-dashboard upgrade/pricing/checkout flows, plan-status checks, and software update handling.

Data is sent to Freemius when an administrator opts in/connects the plugin, activates or manages a license, views or uses Freemius account/upgrade/checkout screens, or uses Freemius-powered update/account features. Depending on the action, this may include the site URL, WordPress version, PHP version, plugin version, locale, basic site/environment information, administrator/account name and email when provided through the Freemius flow, and license, plan, subscription, payment, product, and account status information needed for licensing, checkout, subscriptions, account management, and updates.

Skipping or not connecting Freemius keeps the free plugin functional, but licensing, account, upgrade, checkout, and paid-plan services require Freemius.

When you choose an upgrade or purchase link, you are taken to Freemius Checkout. Information you voluntarily enter on that checkout page is submitted directly to Freemius and is handled under the Freemius terms and privacy policy.

Freemius terms: https://freemius.com/terms/
Freemius privacy policy: https://freemius.com/privacy/

= FeeNudge.com links =

FeeNudge includes administrator-initiated links to FeeNudge.com for documentation, support, pricing, terms, privacy, and product information. The FeeNudge logo and product screenshots displayed in the WordPress admin are bundled locally with the plugin and are not loaded from FeeNudge.com.

No store orders, customer records, cart contents, fee rule configuration, or payment data are sent to FeeNudge.com for fee calculation. When an administrator chooses to open a FeeNudge.com link, normal browser request data such as IP address, user agent, referrer, and requested URL may be sent to the destination website.

FeeNudge terms: https://feenudge.com/terms-of-service/
FeeNudge privacy policy: https://feenudge.com/privacy-policy/

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install via the WordPress plugin uploader.
2. Activate **FeeNudge Fee Rules for WooCommerce** in the **Plugins** screen.
3. Confirm WooCommerce is active.
4. Go to **FeeNudge** in the WordPress admin menu.
5. Create your first **Fee Rule**.

== Frequently Asked Questions ==

= Does FeeNudge support FunnelKit layouts? =

FeeNudge Pro includes compatibility controls for supported FunnelKit cart and checkout layouts. Compatibility can vary by FunnelKit configuration, theme, and template customizations, so the affected cart and checkout pages should be tested after setup.

FeeNudge Free does not include the Pro compatibility controls or custom insertion selectors.

= Does FeeNudge work with WooCommerce Blocks? =

Yes. FeeNudge supports WooCommerce Cart Block and Checkout Block.

= Can I manually place Smart Messages? =

Yes. Eligible Free Smart Messages can be placed manually in cart or checkout using the included Smart Messages shortcodes.

[feenwcf_smart_messages context="cart"]
[feenwcf_smart_messages context="checkout"]

= Will my rules/settings remain after plugin updates? =

Yes. Normal plugin updates preserve your FeeNudge rules and settings.

= What happens when I uninstall FeeNudge? =

By default, uninstall does not remove your stored plugin data. Cleanup only removes plugin-owned data when the delete-data setting is enabled.

= What is included in Free vs Premium? =

Free includes core Fee Rules, fixed/percentage fees, starter templates, basic Smart Messages, cart/checkout display controls, and Fee Rules and Smart Product Groups import/export. A separately distributed FeeNudge Premium package adds optional add-ons, product-page offers, payment fees, shipping rules, regional fees, customer groups, bundle rules, advanced Smart Messages, and reporting. Those implementations are not included in the WordPress.org Free package. FeeNudge Free is fully functional on its own.


= Do I need WooCommerce installed? =

Yes. FeeNudge is an add-on for WooCommerce and requires WooCommerce to be installed and active.


= Can FeeNudge create discounts as well as fees? =

Yes. FeeNudge can support discount-style rule behavior where available in the rule editor. Free focuses on core Fee Rules and basic Smart Messages, while the separately distributed FeeNudge Premium package adds customer groups, advanced Smart Messages, reporting, and additional rule modules.

== Changelog ==
= 0.2.1 =
* Bundled FeeNudge admin logos and product screenshots locally.
* Improved Free and Premium package separation and validation.
* Improved Fee Rule data integrity across plugin updates and edition changes.
* Improved Fee Rule import validation and compatibility.
* Improved Smart Message compatibility.
* Added additional packaging and regression safeguards.
* Clarified Free and Pro cart and checkout compatibility descriptions.

= 0.2.0 =
* Verified compatibility with WordPress 7.0 and WooCommerce 10.9.4.
* Fixed admin token-select dropdown behavior so only the active selector opens across Pro Shipping Fees, Pro Regional Fees, and Pro Customer Groups.
* Gated FeeNudge informational diagnostics behind `FEENUDGE_FEE_RULES_DEBUG` to keep standard `debug.log` clean during normal usage.
* Release metadata update to 0.2.0.

= 0.1.9 =
* Reworked release packaging around one Freemius source ZIP so Freemius generates the final free and premium packages.
* Marked premium-only modules for Freemius preprocessing while keeping the free plugin independently functional.
* No changes to fee calculation, cart/checkout rendering, Pro Optional Services, Smart Messages, or Freemius licensing behavior.

= 0.1.7 =
* Added light FeeNudge branding for the Freemius in-dashboard upgrade page.
* No changes to fee calculation, cart/checkout rendering, Pro Optional Services, Smart Messages, or Freemius licensing behavior.

= 0.1.6 =
* Added Smart Message badge controls so merchants can hide or customize the badge label across supported rule tabs.
* No changes to fee calculation, cart placement, checkout placement, Pro FunnelKit layout, or Freemius gating.

= 0.1.5 =
* Fixed classic cart totals placement by rendering FeeNudge cart messages outside responsive totals tables, avoiding theme colspan/grid constraints.
* No changes to fee logic, Pro Optional Services logic, Smart Messages logic, Freemius gating, Pro FunnelKit side cart, or checkout layouts.

= 0.1.4 =
* Fixed classic cart totals unified shell packaging validation and full-width table-cell rendering guard for released assets.


= 0.1.3 =
* Improved classic/theme cart totals layout so FeeNudge messages fit the cart totals section more cleanly.
* Added package validation to ensure the final cart totals CSS is included in release ZIPs.
* No fee logic, Pro Optional Services logic, Smart Messages logic, or Freemius gating changes.

= 0.1.2 =
* Added Pro unified multi-surface cart and checkout compatibility rendering.
* Improved Pro Optional Services and Smart Messages display in classic WooCommerce cart totals.
* Improved Pro FunnelKit side cart display and compact drawer layout.
* Improved checkout order-summary placement and responsive sizing.
* Added safer Pro custom cart/checkout selector handling.
* Improved Smart Message layout with inline badges and compact summary cards.
* Improved supported WooCommerce Blocks behavior and FeeNudge Pro compatibility with custom cart/checkout builders.
* Improved release packaging checks for Freemius and WordPress.org readiness.

= 0.1.1 =
* Added the FeeNudge Pro third-party cart/checkout compatibility mode.
* Added Pro FunnelKit compatibility support for Pro optional services and Smart Messages.
* Added Pro custom cart/checkout insert selector settings.
* Added FeeNudge Pro Optional Services shortcodes and builder-template placement support for Smart Messages.

= 0.1.0 =
* Initial public packaging pass for FeeNudge Free.
* Refined readme structure and product positioning.
* Added Free vs Premium comparison and merchant-focused FAQ.

== Upgrade Notice ==
= 0.2.1 =
Improves Free/Premium compatibility, rule preservation, imports, Smart Messages,
and package validation.

= 0.2.0 =
Improves admin token-select UX and gates informational FeeNudge debug logs behind `FEENUDGE_FEE_RULES_DEBUG`.

= 0.1.9 =
Improves Freemius source packaging without changing fee logic, checkout behavior, or licensing flow.

= 0.1.7 =
Adds light FeeNudge branding to the Freemius in-dashboard upgrade page with no fee logic, checkout behavior, or licensing flow changes.

= 0.1.6 =
Adds Smart Message badge visibility and text controls across supported rule tabs.


= 0.1.5 =
Fixes classic cart totals placement by rendering FeeNudge cart messages outside responsive totals tables while keeping fee logic and checkout/Pro FunnelKit behavior unchanged.

= 0.1.3 =
Improves classic cart totals layout packaging and ensures the latest frontend CSS is included in release ZIPs.

= 0.1.2 =
Improves cart/checkout compatibility, Pro FunnelKit side cart display, checkout summary placement, Smart Message layout, and package readiness.

= 0.1.1 =
Adds FeeNudge Pro third-party cart/checkout compatibility, FunnelKit support, custom insertion selectors, and builder-template placement for Pro Optional Services, alongside Smart Message placement improvements.
