RT Express COD – Order Now Button for WooCommerce
| 开发者 |
raintech357
rtao |
|---|---|
| 更新时间 | 2026年8月8日 01:07 |
| PHP版本: | 7.2 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Turn more product-page visitors into completed COD orders by removing checkout friction.
- Fully customizable "Order Now" button — text, four styles (gradient, solid, outline, soft), colors, sizes, full-width, and an optional cart icon, with a live preview in the admin.
- Real, live shipping rates calculated from the customer's address using your existing WooCommerce shipping zones and methods.
- Add an optional COD handling fee as a real order fee line.
- Control exactly which fields customers must fill in — name, phone, email, address, and more — with custom phone validation.
- Restrict Express COD by product type, category, or cart total so it only appears where you want it.
- Built on a fast object-cache/transient caching layer, so it stays quick even on high-traffic product pages.
- Fully HPOS (High-Performance Order Storage) compatible.
- React admin — a modern, tabbed settings screen mounted inside WordPress, talking to a dedicated REST API.
- React storefront form — the product-page form is a self-contained React app, scoped so it survives almost any theme.
- Working cache layer — settings and per-product form configuration are cached through the object cache (Redis / Memcached) with an automatic transient fallback. One versioned namespace means a single click clears everything.
- Advanced options — order status mapping, COD handling fee, configurable fields and validation, category / amount restrictions, redirect behaviour, custom CSS, admin email notifications, debug mode, and cache controls.
- Show the form after the add-to-cart button, before it, or after the product summary.
- Choose which fields appear and which are required (name, phone, email, address, note).
- Custom phone validation via a configurable pattern, enforced on both client and server.
- Map new orders to On hold, Pending payment, or Processing.
- Optional COD handling fee added as a real order fee line.
- Restrict COD by product type, product category, or cart total (min / max).
- Optional redirect to the order-received page or a custom URL after success.
- Per-product configuration is cached for fast, repeat page loads.
- HPOS (High-Performance Order Storage) compatible.
安装:
- Upload the
rt-express-cod-for-woocommercefolder to/wp-content/plugins/, or install the ZIP via Plugins → Add New → Upload Plugin. - Activate the plugin through the Plugins menu in WordPress.
- Make sure WooCommerce is active.
- Go to WooCommerce → Express COD to configure.
build/ folder, so no build step is needed to use it. Developers who want to modify the React source can rebuild with npm install && npm run build (see Frequently Asked Questions).常见问题:
Does this add a Cash on Delivery button to the product page?
Yes. It adds a customizable "Order Now" button near the add-to-cart area. Clicking it opens a modal where the customer enters their details and places a Cash on Delivery order without visiting the full checkout page.
Can I limit Express COD to certain products or order amounts?
Yes. You can restrict it by product type, product category, or a minimum/maximum cart total, so the button only appears where COD makes sense for your store.
Does it calculate real shipping rates?
Yes. The modal calculates live shipping rates from the customer's entered address using your existing WooCommerce shipping zones and methods, and adds the selected rate to the order total.
Does this replace the WooCommerce checkout?
No. It offers a faster path for COD customers on the product page. The normal checkout is untouched and still available.
Where is the data stored?
Orders are created as standard WooCommerce orders (payment method "Cash on Delivery (Express)") so they appear in WooCommerce → Orders like any other order. Each express order carries the meta flags _rt_express_cod and _rt_express_cod_source.
How does caching work?
Reads (settings + per-product form config) go through a small cache wrapper that prefers a persistent object cache and falls back to transients. Everything lives under one versioned key namespace, so clearing the cache is just a version bump — instant and complete. You can clear it any time from the admin screen, and it clears automatically whenever you save settings.
How do I rebuild the React apps?
From the plugin folder run npm install then npm run build (Node 18+). This compiles src/ into build/ using esbuild against WordPress's bundled React (wp.element). Use npm run dev for an unminified build.
Is it translation ready?
Yes. All strings use the rt-express-cod-for-woocommerce text domain, including the React apps via wp_set_script_translations.
更新日志:
- New: the "Order now" button is now fully styleable from the admin — separate button text, four styles (gradient, solid, outline, soft), a colour picker (hover/gradient/glow shades derived automatically), three sizes, full-width, and an optional cart icon.
- New: a live button preview in the settings screen.
- Improved: more refined default button styling (gradient, soft shadow, hover lift, focus ring).
- Changed: the product page now shows an "Order now" button instead of an inline form. Clicking it opens the express checkout in a modal.
- New: the modal shows the cart / order item list with a live order summary — subtotal, shipping, tax, COD fee, and grand total — that updates as the address and shipping method change.
- New:
/summaryREST endpoint backing the modal totals (tax is calculated for the entered destination).
- Fix: "The cart is not available" error when placing an order — the cart/session is now loaded correctly during REST requests, and an order can be built directly from the product on the page when the cart is empty. Quantity and the chosen variation are read from the product form.
- New: live shipping calculation. The form quotes real WooCommerce shipping rates from the customer's address (using your existing shipping zones and methods) and adds the chosen rate to the order. Choose between letting the customer pick a method or auto-applying the cheapest / first rate.
- New: additional, individually toggleable address fields — company, address line 2, city, state/county, postcode/ZIP, and country (with country and state dropdowns sourced from WooCommerce).
- New: Shipping settings tab and a default-country option.
- Rewrite: React-powered admin settings screen with tabs (General, Order, Fields, Restrictions, Advanced).
- Rewrite: React-powered product-page form replacing the old jQuery form.
- New: dedicated REST API namespace
rt-express-cod/v1replacing admin-ajax. - New: object-cache + transient caching layer with versioned invalidation and a Clear Cache control.
- New: advanced options — COD fee, order status mapping, field/validation controls, category & amount restrictions, redirect behaviour, custom CSS, admin notifications, debug mode.
- New: HPOS compatibility declaration.
- Fix: removed duplicate plugin header and undefined version constant from 1.0.0.
- Initial release: jQuery product-page COD form creating an on-hold order via admin-ajax.