WordPress.org

China 简体中文

获取 WordPress
WordPress.org

Plugin Directory

Arik Sahaj Checkout

Arik Sahaj Checkout

作者：Tanmoy Biswas
下载

描述

Arik Sahaj Checkout turns WhatsApp into a real WooCommerce checkout flow. Unlike basic “click-to-chat” plugins, this plugin creates a real WooCommerce order (a shadow order) the moment a customer clicks the WhatsApp button protecting your inventory from overselling while the customer completes the conversation on WhatsApp.

Why a “Shadow Order”?

When a customer clicks the WhatsApp button, the plugin:

  1. Creates a real WooCommerce order with the selected product, quantity, and variations
  2. Reduces stock immediately (atomic no race conditions)
  3. Opens WhatsApp with a pre-filled message including the Order ID
  4. Suppresses transactional emails so admin and customer aren’t notified prematurely

The result: your inventory is protected, your dashboard has a clean record of every WhatsApp inquiry, and you never oversell.

Key Features

  • Real WooCommerce Orders: Every click creates a trackable WooCommerce order
  • Atomic Inventory Protection: Stock reduced via wc_reduce_stock_levels() — safe under concurrent load
  • Variable Product Support: Captures size, color, and other variation selections
  • High-Performance Order Storage (HPOS) compatible: Full support for WooCommerce HPOS
  • Cart & Checkout Blocks compatible: Works alongside the WooCommerce Blocks experience
  • Popup-Blocker Safe: Opens WhatsApp tab synchronously on click; never blocked
  • Honeypot Anti-Spam: Built-in bot protection without CAPTCHA
  • Rate Limiting: Per-IP and per-user, configurable, with HTTP 429 responses
  • Customizable Message Templates: Use placeholders for product name, order ID, total, variations, date
  • Flexible Button Positioning: Before, after, or replace the Add to Cart button
  • Configurable Order Status: Choose any valid WooCommerce status for shadow orders
  • Email Suppression: Shadow orders never trigger admin/customer emails
  • Block Theme Support: Compatible with Twenty Twenty-Four and other block themes
  • Translation Ready: Full i18n/l10n support
  • Multisite Compatible: Network activation with per-site settings
  • Accessibility-First: ARIA attributes, keyboard navigation, prefers-reduced-motion, high-contrast mode
  • RTL Support: Right-to-left languages fully supported
  • WP-CLI Compatible: Plugin activation via wp plugin activate works correctly

How It Works

  1. Customer browses your shop and selects a product
  2. Clicks “Order via WhatsApp”
  3. Plugin creates a real WooCommerce order with status of your choice (default: On Hold)
  4. Stock is reduced automatically
  5. WhatsApp opens in a new tab with a pre-filled message including the Order ID
  6. Customer messages you on WhatsApp you reference the Order ID in your WooCommerce dashboard

Perfect For

  • Stores that primarily take orders via WhatsApp (common in South Asia, MENA, Latin America)
  • Businesses with limited online checkout (no payment gateway, no shipping calculator)
  • Shops wanting inventory protection without complex multi-step checkout
  • Stores selling variable products via WhatsApp
  • Brick-and-mortar businesses using WordPress as a catalog

Theme Compatibility

Tested with the following themes (single product page and shop archive):

  • Storefront
  • Astra
  • OceanWP
  • Divi
  • The7
  • Flatsome
  • Avada
  • GeneratePress
  • Kadence
  • Blocksy
  • Twenty Twenty-Four (block theme)

The plugin uses high-specificity CSS selectors and CSS custom properties to override aggressive !important button rules from popular themes without breaking other site styles.

Technical Highlights

  • Object-oriented PHP architecture with singletons
  • PHP 7.4+ compatible (no PHP 8.x-only syntax)
  • Follows WordPress Coding Standards (WPCS)
  • Security-first: nonce verification, capability checks, input sanitization, output escaping
  • WooCommerce email hooks safely wrapped in try/finally
  • Cryptographically secure token generation via random_bytes()
  • Atomic stock reduction (no race conditions)
  • HPOS-aware uninstall (cleans both wc_orders_meta and postmeta)
  • Multisite-aware uninstall (loops all sites in network)
  • No wp_cache_flush() abuse — targeted cache invalidation only
  • wc_get_logger() integration for production debugging
  • Defensive class/function existence checks throughout

Additional Information

Support & Connect

Privacy Policy

This plugin does not collect or transmit any personal data to external services. All order data is stored locally in your WordPress/WooCommerce database, which you control.

The plugin stores the following data on each shadow order:

  • Customer IP address (standard WooCommerce field for fraud prevention)
  • Customer user agent (standard WooCommerce field for fraud prevention)
  • Product ID, variation ID, quantity, and variation attributes selected
  • Order timestamp

For logged-in customers, the order is attached to their WordPress user account. Anonymous customers have no personally identifying data stored beyond IP/user agent (which WooCommerce stores for all orders, not just shadow orders).

No data is sent to any third-party service. The WhatsApp deep link (wa.me) opens on the customer’s device using only the destination number and message text you configure the plugin does not contact WhatsApp’s servers itself.

Requirements

  • WordPress 6.0 or higher
  • WooCommerce 7.0 or higher (tested up to 9.5)
  • PHP 7.4 or higher
  • MySQL 5.6 or higher / MariaDB 10.1 or higher
  • JSON and Multibyte String PHP extensions

屏幕截图

  • screenshot-1.png
  • screenshot-2.png
  • screenshot-3.png
  • screenshot-4.png
  • screenshot-5.png

安装

Automatic Installation

  1. Go to Plugins Add New
  2. Search for “Arik Sahaj Checkout”
  3. Click Install Now
  4. Click Activate

Manual Installation

  1. Download the plugin ZIP file
  2. Go to Plugins Add New Upload Plugin
  3. Choose the downloaded file and click Install Now
  4. Click Activate

Initial Configuration

  1. Go to WooCommerce WhatsApp Checkout
  2. Enter your WhatsApp number with country code (e.g., +8801719937625)
  3. Customize the message template using available placeholders
  4. Configure the button text, position, and style
  5. Save settings the button appears on product pages immediately

常见问题

Do I need the WhatsApp Business API?

No. The plugin uses the free wa.me deep-link protocol. No API keys, no business verification, no per-message fees.

What happens to stock when someone clicks the WhatsApp button?

A real WooCommerce order is created and stock is reduced via WooCommerce’s built-in wc_reduce_stock_levels(). This is atomic and safe under concurrent customer load.

Does it work with variable products?

Yes. On shop archive pages, variable products redirect the customer to the single product page so they can select size, color, etc. On single product pages, the WhatsApp button is only enabled once a valid variation is selected.

What if the customer doesn’t actually message me on WhatsApp?

The shadow order remains in your WooCommerce dashboard with the status you configured (default: On Hold). You can follow up with the customer or cancel the order — cancelling automatically restores stock.

Will shadow orders send email notifications?

No. The plugin suppresses all WooCommerce transactional emails during shadow order creation. The customer and admin only receive emails when an order is processed through the normal checkout flow.

Does it work on servers where PHP `mail()` is disabled?

Yes. Because the plugin suppresses all email hooks during shadow order creation, mail() is never called. No PHPMailer errors regardless of server configuration.

Does it work with WooCommerce HPOS (High-Performance Order Storage)?

Yes. The plugin declares HPOS compatibility and uses only HPOS-safe APIs (no direct postmeta access on orders).

Does it work with the new Cart & Checkout Blocks?

Yes. The plugin declares cart_checkout_blocks compatibility and doesn’t interfere with the Block-based checkout flow.

Can I customize the WhatsApp message?

Yes. Use placeholders like {product_name}, {order_id}, {quantity}, {total}, {variations}, and {date} in the message template setting.

Can I change the button color and style?

Yes. The plugin includes a Button Style section with color pickers, padding, border radius, font size, icon size, and a custom icon uploader.

Is the plugin translation-ready?

Yes. The plugin is fully internationalized and ready for translation via WordPress.org’s Translate platform or .po/.mo files in /languages.

Does it support multisite?

Yes. Activation, deactivation, and uninstall all handle multisite correctly. Each site has its own settings.

Is it accessible?

Yes. The plugin supports keyboard navigation, ARIA attributes (aria-busy, aria-label, role="alert"), prefers-reduced-motion, and Windows High Contrast Mode.

Does the plugin collect personal data?

No external data is transmitted. The plugin only stores order data locally in your WooCommerce database, which you control. Customer IP address and user agent are stored on the order for fraud prevention (a standard WooCommerce practice).

评价

此插件暂无评价。

贡献者及开发者

「Arik Sahaj Checkout」是开源软件。 以下人员对此插件做出了贡献。

贡献者

帮助将「Arik Sahaj Checkout」翻译成简体中文。

对开发感兴趣吗?

您可以浏览代码，查看SVN仓库，或通过RSS订阅开发日志。

更新日志

1.0.4

Release Date: May 12, 2026

Critical Bug Fixes

  • Fixed fatal error on activation caused by PHP 8.0+ syntax used without proper version requirement. Removed match expressions, mixed type hint, int|WP_Error union return types, : never return type, str_contains(), and declare(strict_types=1) from all files. Plugin now requires PHP 7.4+ which matches the declared header.
  • Fixed is_product_archive() fatal error — this function does not exist in WooCommerce. Replaced with is_woocommerce() plus standard archive checks.
  • Fixed 'replace_add_to_cart' button position breaking variable products by removing the entire add-to-cart template (including variation dropdowns). Now uses CSS-based hiding that preserves variation selection.
  • Fixed woocommerce_is_sold_individually filter being applied globally, affecting all products on the site. Removed entirely.
  • Fixed race condition where stock could be oversold between the stock check and stock reduction. Stock reduction now runs before status change to close the window.
  • Fixed email suppression filters leaking if update_status() threw an exception. Wrapped in try/finally to guarantee filter restoration.

Security Hardening

  • Added HTTP method enforcement on AJAX endpoint (POST-only).
  • Added honeypot anti-spam field with ariksac_honeypot_field and ariksac_ajax_pre_check filters for reCAPTCHA/hCaptcha integration.
  • Added per-user rate limiting in addition to per-IP rate limiting (CDN/proxy-safe).
  • Added ariksac_trust_proxy_headers filter (default false) — REMOTE_ADDR is now the authoritative IP source. Prevents X-Forwarded-For spoofing of rate limits and order IP records.
  • Added strict sanitization callbacks for button position, yes/no settings, and order status (whitelisted against wc_get_order_statuses()).
  • Changed message template sanitizer from wp_kses_post to sanitize_textarea_field — WhatsApp messages should be plain text.
  • Added phone number validation with inline admin error feedback.
  • Replaced wp_die(-1) from check_ajax_referer with proper JSON 403 response.

User Experience

  • Fixed popup blocker preventing WhatsApp from opening — window now opens synchronously on click and is navigated after AJAX response.
  • Added HTTP 429 rate-limit detection with dedicated error message.
  • Added HTML entity decoding for server-returned error messages.
  • Added aria-busy toggle during loading state for screen reader accessibility.
  • Added smooth fallback notice container for block themes without .woocommerce-notices-wrapper.
  • Added 30-second AJAX timeout to prevent indefinite hangs.
  • Added double-click prevention via aria-busy state check.
  • Added WC logger integration — errors viewable at WooCommerce Status Logs.

Theme Compatibility

  • Added Twenty Twenty-Four and block theme compatibility selectors.
  • Added Flatsome, Avada, GeneratePress, Kadence, Blocksy compatibility patterns.
  • Added box-sizing: border-box to prevent padding overflow in strict themes.

Accessibility

  • Added prefers-reduced-motion media query for spinner animation.
  • Added Windows High Contrast Mode (forced-colors: active) support.
  • Added aria-live regions for notices.
  • Added print stylesheet (hides WhatsApp UI from printed pages).
  • Added focus-visible states throughout admin and frontend.

Internationalization

  • Added RTL stylesheet rules for Arabic, Hebrew, Urdu, and other RTL languages.
  • Removed translated strings from default database storage — translation now happens at output time, language-switch safe.

Order Quality

  • Logged-in customers now have orders attached to their WordPress account.
  • Pre-fills billing email and name from user profile when available.
  • Added _ariksac_order_source = 'whatsapp' meta for filtering in admin.
  • Added {date} placeholder for message templates.
  • Added ariksac_message_placeholders filter for custom placeholders.
  • Improved wc_price() output cleaning — currency symbols and   now display correctly in WhatsApp messages.
  • User agent truncated to 200 characters for DB column safety.

Uninstall & Cleanup

  • Multisite-aware uninstall loops through all sites in network.
  • Cleans both HPOS wc_orders_meta and legacy postmeta regardless of current mode.
  • Cleans rate-limit transients with proper prefix-based queries.
  • Cleans cron events, user meta, and custom capabilities.
  • Replaced wp_cache_flush() with targeted wp_cache_delete() — no longer impacts other plugins’ Redis/Memcached cache.

Other

  • Bumped minimum WordPress version requirement to 6.0.
  • Bumped tested WooCommerce version to 9.5.
  • Added wp_color_picker palette support in admin.
  • Added Help & Documentation tab with placeholder reference and system requirements check.

1.0.2

Release Date: March 13, 2026

  • Fixed fatal error caused by WooCommerce email notifications firing during shadow order creation on servers with PHP mail() disabled.
  • Fixed update_meta_data() warning on _customer_ip_address and _customer_user_agent. Replaced with proper WC setter methods.
  • Fixed button style settings not applying due to CSS specificity wars with theme !important rules. Added high-specificity selector list.
  • Fixed CSS notice selectors mismatched with JS-applied classes.
  • Fixed debug data exposed in production AJAX error responses.
  • Added button style result caching for performance on archive pages.
  • Added The7 theme compatibility.
  • Added dark mode support for notice styles.

1.0.0

Release Date: January 2026

  • Initial release
  • Shadow order system with WhatsApp integration
  • Variable product support
  • HPOS compatibility
  • Security features (nonce, rate limiting, input sanitization)
  • Customizable message templates
  • Flexible button positioning

额外信息

评级

尚未提交反馈。

Your review

查看全部评论

支持

有话要说吗？是否需要帮助？

查看支持论坛