APG Withdrawal for WooCommerce
| 开发者 | artprojectgroup |
|---|---|
| 更新时间 | 2026年5月19日 18:17 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GNU General Public License v3 or later |
| 版权网址: | 版权信息 |
详情介绍:
APG Withdrawal for WooCommerce adds to your WooCommerce store a complete online right of withdrawal workflow compliant with EU consumer protection legislation.
Features
- Customer withdrawal form via the
[apg_withdrawal_form]shortcode. - Configurable withdrawal window (days) and deadline source (completed or created date).
- Optional extra grace days on top of the standard withdrawal window.
- Active request detection: hides the withdrawal button if a request is already open for the order.
- Optional digital-content waiver checkbox at checkout (both classic shortcode and block-based checkout): a configurable selector chooses when to display it — never, only on virtual products (or per-product
_apg_withdrawal_type = digital), on every order, or on selected categories and/or selected products. The customer's choice is persisted to order meta as legal evidence. - Admin request log with full request details (custom post type).
- IP address and browser identifier storage options for legal evidence.
- Email notification to the store admin on every new request.
- Automatic customer acknowledgement email on submission.
- Customer status update emails when the request is accepted, rejected or completed.
- Automation: updates the withdrawal request status automatically when the linked WooCommerce order changes status.
- My Account integration: customers can view their withdrawal request history.
- CSV export of all withdrawal requests.
- 100% compatible with HPOS (High-Performance Order Storage).
- English: by Art Project Group (default language).
- Spanish: by Art Project Group.
安装:
- Install the plugin in one of the following ways:
- Upload the
apg-withdrawal-for-woocommercefolder to the/wp-content/plugins/directory via FTP. - Upload the full ZIP file via Plugins -> Add New -> Upload in the WordPress administration panel.
- Search for APG Withdrawal for WooCommerce in Plugins -> Add New and click Install Now.
- Activate the plugin through the Plugins menu in the WordPress administration panel.
- Configure the plugin in WooCommerce -> Withdrawal or through the Settings link on the plugins page.
- Add the
[apg_withdrawal_form]shortcode to the page configured as the withdrawal page in the settings.
屏幕截图:
常见问题:
How do I configure the plugin?
In the plugin settings you can configure the notification email, the withdrawal page, the withdrawal window in days, the deadline source (completed or created date), the extra grace days and which data to store (IP address, browser identifier).
Is the plugin compatible with HPOS?
Yes. The plugin is fully compatible with WooCommerce High-Performance Order Storage.
Can guest customers submit a withdrawal request?
Yes. The form supports both logged-in customers (with pre-filled data and order selector) and guests (with email lookup of their orders).
Where can I get support?
APG Withdrawal for WooCommerce is a free plugin. Art Project Group does not provide free technical support, but offers a paid technical support service for installation and configuration.
更新日志:
0.4.0
- New setting "Custom checkbox text" in the Digital content waiver section: lets the merchant override the default acknowledgement label rendered at checkout with a custom plain-text string. Leaving the field empty keeps the default translatable text.
- The default page auto-created by the plugin now uses the title "Exercise the right of withdrawal" (translated to "Ejercer derecho de desistimiento" in Spanish) and lets WordPress derive its slug from the title. Existing pages are not modified — only new installations get the new title and slug.
- Internal: corrected the allowed-modes whitelist in the settings sanitiser (
disabled,virtual,all,specific) so the values now match the actual mode selector.
- New: digital-content withdrawal waiver checkbox at checkout. Customers buying digital content or virtual services see an optional acknowledgement that requesting the immediate supply waives their right of withdrawal (EU consumer protection requirement). The checkbox is informational; ticking it is not mandatory and does not block order placement.
- The checkbox is injected in both checkouts: classic shortcode (via
woocommerce_checkout_before_terms_and_conditionswith priority 999) and block-based (via JavaScript that reinserts itself with aMutationObserverto remain right before the native terms checkbox, after any other custom one). - In the block checkout, a generic cleanup pass removes content injected next to our wrapper by third-party plugins whose selectors over-match (e.g. plugins using
.wp-block-woocommerce-checkout-terms-block .wc-block-components-checkboxplus jQuery.after()), avoiding duplicated privacy or marketing notices. - The customer's choice is persisted to order meta
_apg_withdrawal_digital_waiver('1'or'0') on both checkouts: the classic checkout reads the POST value onwoocommerce_checkout_create_order, the block checkout injects the value into the StoreAPI request body underextensions['apg-withdrawal']['digital_waiver']and the server hookwoocommerce_store_api_checkout_update_order_from_requestwrites the same meta. - The block-checkout script reacts to cart changes mid-checkout: it watches StoreAPI cart mutations and, via a nonced AJAX endpoint (
apg_withdrawal_check_cart_waiver), re-checks server-side whether the current cart still qualifies, inserting or removing the checkbox without a full page reload. - New settings section "Digital content waiver" with a single SelectWoo selector for when to show the checkbox: never (default), only on virtual products, on every order, or on products in selected categories or selected products (these two can be combined). Category and product selectors load only when relevant. The "Only on virtual products" mode also matches products with the per-product
_apg_withdrawal_type = digitalsetting, so virtual flag and explicit digital classification are treated as equivalent triggers.
- The frontend form now inherits the native WooCommerce stylesheet (notices, fields, buttons) without requiring custom CSS overrides.
- Notices rendered with
wc_print_notice()so they pick up the correct WooCommerce template for both block themes (block-notices/*.php) and classic themes (notices/*.php). - Dynamic notices (order-not-found feedback and product warning) are pre-rendered server-side via
wc_print_notice()and toggled by JavaScript, instead of being built by hand with legacy markup that breaks on block themes. - Order-not-found feedback follows the native WooCommerce pattern: notice at the top of the form plus
woocommerce-invalidclass on the email field. - Buttons use
wc_wp_theme_get_element_class_name( 'button' )for theme and block-theme compatibility. - Removed inline CSS injected from JavaScript in favour of native WooCommerce notice classes.
- Spanish translation updated to informal "tú" treatment as recommended by the WooCommerce style guide.
- Initial release.