Ninja Quick Buy

A lightweight WooCommerce quick-order / Cash-on-Delivery popup for Arab-region stores.

Ninja Quick Buy adds a "Buy Now" button on your WooCommerce product and catalog pages. Tapping it opens a fast, mobile-first popup that collects the customer's delivery details and places a real WooCommerce order in seconds — no full checkout, no cart, no account required. Built for Cash on Delivery (COD) and e-wallet markets across the Arab region, with full RTL support and translations.

English is the source language; Arabic is bundled as a ready translation (ar). Switch your WordPress site language and the plugin follows.

Features

• Buy Now button on single product pages and shop/catalog loops (each toggleable).
• Lightweight popup collecting name, phone, city, address, and an optional email.
• City field as a Jordan-governorates dropdown or free-text input.
• Discount codes powered by your existing WooCommerce coupons (percent or fixed).
• Payment methods:
  • Cash on Delivery (COD).
  • E-Wallet with configurable holder name, number, instructions, sender number, and transfer-screenshot upload.
• Direct order creation through the WooCommerce API with configurable order status.
• Success animation with optional redirect after a configurable delay.
• Admin dashboard with three views: Overview (stats), Orders (list + detail), Settings.
• Email notifications to admin and (optionally) to the customer.
• Fully internationalized (__(), esc_html__(), etc.) with a .pot template and bundled Arabic translation. RTL-aware.
• HPOS compatible (WooCommerce High-Performance Order Storage).

Installation

1. Download or clone this repository into your WordPress plugins directory:

   wp-content/plugins/ninja-quick-buy/

2. Make sure WooCommerce 7.0+ is installed and active.
3. In the WordPress admin, go to Plugins and activate Ninja Quick Buy.
4. Open Ninja Quick Buy → Settings to configure the button, payment methods, and notifications.

Requirements: WordPress 6.0+, PHP 7.4+, WooCommerce 7.0+.

Usage

1. Enable the plugin and choose where the button appears (product page / catalog).
2. Customize the button text, popup title, accent color, and city field mode.
3. Turn on the payment methods you support (COD and/or E-Wallet) and set their order statuses.
4. (Optional) Enable discount codes — they use your existing WooCommerce coupons.
5. (Optional) Configure admin and customer email notifications.
6. Track and manage incoming quick orders from Ninja Quick Buy → Orders.

Theme helper

Need the configured button label in a custom template?

echo esc_html( ninja_qb_get_button_text() );

Screenshots

Place screenshots in the assets/ folder and reference them here.

1. assets/screenshot-1.png — Buy Now button on the product page.
2. assets/screenshot-2.png — Quick order popup with delivery fields.
3. assets/screenshot-3.png — E-Wallet payment with screenshot upload.
4. assets/screenshot-4.png — Admin Overview dashboard.
5. assets/screenshot-5.png — Orders list and order detail.

FAQ

Does this replace the WooCommerce checkout? No. It creates a real WooCommerce order directly from the popup, so it lives alongside your normal checkout — ideal for COD-first stores.

Which payment methods are supported? Cash on Delivery and a manual E-Wallet flow (transfer + screenshot upload). Both are configurable and can be enabled independently.

Can customers use my existing coupons? Yes. When discount codes are enabled, the popup validates and applies your existing WooCommerce coupons.

Is it translatable / RTL ready? Yes. The source language is English, an Arabic translation is bundled, and a .pot template is provided for additional languages. RTL is fully supported.

Is it compatible with WooCommerce HPOS? Yes. The plugin declares compatibility with High-Performance Order Storage.

Changelog

2.0.2

• Organized the plugin as a standalone project with complete contributor, security, changelog, and release documentation.
• Rebuilt and validated the installable package.

2.0.1

• Made the quick-buy popup open instantly with a GPU-only transition.
• Prevented horizontal page movement while the modal is open.
• Pre-built the popup during idle time for a faster first interaction.

2.0.0

• Internationalized the entire plugin with English as the source language.
• Added a .pot template and a bundled Arabic (ar) translation.
• Added complete WordPress.org-compliant plugin header.
• Declared WooCommerce HPOS (custom order tables) compatibility.
• Locale-aware admin dashboard direction (RTL/LTR).

License

This plugin is licensed under the GPLv2 or later. See the LICENSE file or https://www.gnu.org/licenses/gpl-2.0.html.

Credits

Built by Ninja (7ussam) — https://github.com/7ussamninja.