=== Ambikly – Sell Online: Cart, Checkout & Digital Downloads ===
Contributors: ambikly
Tags: ecommerce, online store, shopping cart, digital downloads, checkout
Requires at least: 5.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv3+
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Sell physical and digital products with one fast, self-hosted store plugin — no required add-ons, no transaction fees, no page builder needed.

== Description ==

**Ambikly is a complete store, not a framework you have to assemble.** Install it, run the setup wizard, and you have products, a cart, checkout, orders, coupons, shipping, tax, and customer accounts working the same day — no separate payments extension, no separate "core" plugin to hunt down first.

**Website:** [ambikly.com](https://ambikly.com/) · **Docs:** [docs.ambikly.com](https://docs.ambikly.com/) · **Free vs Pro:** [ambikly.com/free-vs-pro](https://ambikly.com/free-vs-pro/)

= Zero transaction fees, ever =

Ambikly never takes a cut of your sales. You keep 100% of what you charge, minus only whatever your payment processor (Stripe, PayPal) itself charges — the same as if you'd built the store yourself. There's no "connect a hosted checkout" tier and no fee schedule that changes as you grow.

= Built for real stores, not just one kind of product =

* **Physical products** — variable products with per-variant pricing, images, and stock; shipping zones and methods (flat rate, free shipping, local pickup)
* **Digital downloads** — secure, expiring file delivery with download limits, license-key delivery when Pro's Licenses add-on is active
* **B2B / wholesale** — company accounts with net-terms billing (net-7/15/30/60/90) and multiple buyers sharing one account's credit line
* **Subscriptions, gift cards, marketplaces, and 30+ more** — all available the moment you need them via [Ambikly Pro](https://ambikly.com/pricing/), not a rewrite

= A checkout that's actually finished =

* Cart, checkout, and a customer account area — orders, downloads, saved addresses, profile — all included, not a separate purchase
* **Stripe** and **PayPal** built in, with server-side webhook signature verification before any order is ever marked paid — plus Cash on Delivery, Direct Bank Transfer, and Check Payments for offline sales
* Coupons with usage limits, per-product/category restrictions, and free-shipping rules
* Tax rates by country/state/postcode, tax-inclusive or tax-exclusive

= Run the back office from one screen =

* Orders: line items, notes, refunds, a full status workflow, and printable invoices
* Product reviews with admin moderation
* Transactional emails (order confirmation, status changes) with editable templates, smart tags, and a live preview
* Outgoing webhooks — Zapier, Slack, or any HTTPS endpoint — for order, checkout, and review events, HMAC-signed with a retry/delivery log
* Dark mode and a mobile-responsive admin — check on your store from your phone

= Built for developers, not around them =

* A documented REST API under `/wp-json/ambikly/v1/`, authenticated the same way as any other WordPress endpoint — no separate API key system to manage
* 8 native block-editor blocks (Add to Cart, Mini Cart, Product Grid, Cart, Checkout, Customer Account, Reviews, Featured Product) so a full site editing theme works out of the box, plus shortcodes for classic themes and page builders
* A real PHP hook/filter system throughout checkout, orders, and pricing — extend behavior without forking core files
* Your data lives in your own database tables, in your own WordPress install — export it, query it, or move hosts whenever you want. No platform lock-in, ever

= Need more? 35+ add-ons, one license =

[Ambikly Pro](https://ambikly.com/pricing/) is a single add-on pack for this plugin — one license activates every module below, no per-feature upsells and no separate purchases to track. Full details for each are on its own page at ambikly.com:

**Store experience:** [Advanced Variations](https://ambikly.com/addons/advanced-variations/) · [AJAX Filters](https://ambikly.com/addons/ajax-filters/) · [Product Compare](https://ambikly.com/addons/compare/) · [Quick View](https://ambikly.com/addons/quick-view/) · [Recently Viewed](https://ambikly.com/addons/recently-viewed/) · [Product Badges](https://ambikly.com/addons/product-badges/) · [Smart Search](https://ambikly.com/addons/smart-search/) · [Sticky Add to Cart](https://ambikly.com/addons/sticky-add-to-cart/) · [Size Chart](https://ambikly.com/addons/size-chart/) · [Wishlist](https://ambikly.com/addons/wishlist/)

**Marketing & sales:** [Abandoned Cart Recovery](https://ambikly.com/addons/abandoned-cart/) · [Affiliate System](https://ambikly.com/addons/affiliate/) · [Dynamic Pricing](https://ambikly.com/addons/dynamic-pricing/) · [Flash Sales](https://ambikly.com/addons/flash-sales/) · [Gift Cards](https://ambikly.com/addons/gift-cards/) · [Loyalty Points](https://ambikly.com/addons/loyalty-points/) · [Order Bumps](https://ambikly.com/addons/order-bumps/) · [Popup Campaigns](https://ambikly.com/addons/popup-campaigns/)

**Checkout & recurring revenue:** [Subscriptions](https://ambikly.com/addons/subscriptions/) · [Post-purchase Upsells](https://ambikly.com/addons/post-purchase-upsells/) · [One Page Checkout](https://ambikly.com/addons/one-page-checkout/) · [Checkout Field Editor](https://ambikly.com/addons/checkout-field-editor/)

**Merchandising:** [Product Bundles](https://ambikly.com/addons/bundles/)

**Digital products:** [Software Licensing Pro](https://ambikly.com/addons/license-pro/) · [PDF Stamping](https://ambikly.com/addons/pdf-stamping/) · [Download Analytics](https://ambikly.com/addons/download-analytics/)

**Physical products:** [Advanced Shipping](https://ambikly.com/addons/advanced-shipping/) · [Multi-vendor](https://ambikly.com/addons/multi-vendor/) · [Shipment Tracking](https://ambikly.com/addons/shipment-tracking/)

**Customer features:** [Social Login](https://ambikly.com/addons/social-login/) · [Store Credit Wallet](https://ambikly.com/addons/store-credit/)

**Admin & analytics:** [Advanced Reports](https://ambikly.com/addons/advanced-reports/) · [CRM Sync](https://ambikly.com/addons/crm-sync/)

**AI-assisted:** [AI Product Descriptions](https://ambikly.com/addons/ai-descriptions/) · [Frequently Bought Together](https://ambikly.com/addons/ai-recommendations/)

Browse the [full add-on catalog](https://ambikly.com/addons/) or see the [free vs. Pro feature comparison](https://ambikly.com/free-vs-pro/).

== Installation ==

**Minimum requirements**

* WordPress 5.4 or greater
* PHP 7.4 or greater
* MySQL 5.6 or greater

**Automatic installation**

1. Go to **Plugins → Add New** in your WordPress admin and search for "Ambikly."
2. Click **Install Now**, then **Activate**.
3. Go to **Ambikly** in the admin menu and follow the setup wizard to configure your store name, currency, and first payment method.
4. Add your first product under **Ambikly → Products**.

**Manual installation**

1. Upload the `ambikly` folder to `/wp-content/plugins/`.
2. Activate the plugin through the **Plugins** screen.
3. Follow the same setup wizard steps above.

Need a hand? Full setup guides live at [docs.ambikly.com](https://docs.ambikly.com/).

== Frequently Asked Questions ==

= Does this require another e-commerce plugin? =

No. Ambikly is a standalone store — it does not require, extend, or run on top of any other e-commerce plugin.

= Can I sell digital and physical products together? =

Yes. Each product is created as either a physical product (with shipping, stock, and variations) or a digital product (with file downloads and license delivery, when the Licenses add-on is active), and both can appear in the same shop.

= Which payment gateways are supported? =

Stripe and PayPal are built in, along with Cash on Delivery, Direct Bank Transfer, and Check Payments for offline orders. Webhook signatures are verified server-side for both Stripe and PayPal before an order is ever marked paid.

= Does Ambikly take a cut of my sales? =

No. There are no transaction fees or revenue share of any kind — you pay nothing beyond your own payment processor's standard rates.

= Will Ambikly slow down my site? =

Ambikly's admin is a separate React application that only loads on Ambikly's own admin screens — it never adds weight to your other wp-admin pages. The storefront ships plain, minimal JS/CSS with no framework dependency.

= Is there an API? =

Yes — a REST API is available under `/wp-json/ambikly/v1/` for products, orders, customers, coupons, and more, authenticated the same way as other WordPress REST endpoints. See the [developer docs](https://docs.ambikly.com/) for the full route reference.

= Can I customize the checkout or storefront templates? =

Yes. Every storefront screen is built from overridable templates and fires WordPress actions/filters at the points that matter (cart totals, checkout fields, order creation), so you can adjust behavior from a theme or a small companion plugin without touching Ambikly's own files.

= Will this work with my theme? =

Ambikly's storefront pages (shop, cart, checkout, account) render inside your active theme's normal page template, so they inherit your theme's fonts, colors, and layout automatically. The block-editor blocks work with any full site editing theme.

= I'm moving away from another cart plugin — will my data still be mine? =

Yes. Ambikly stores everything in its own plain database tables inside your own WordPress install. There's no hosted service holding your orders or customer list hostage — export, query, or migrate whenever you want.

= What's the difference between Ambikly and Ambikly Pro? =

Ambikly (this plugin) is a complete, free store: products, checkout, orders, coupons, shipping, tax, and reviews. [Ambikly Pro](https://ambikly.com/pricing/) is an optional add-on pack for stores that need subscriptions, gift cards, marketplaces, bundles, and 30+ other modules — one license, everything included. Compare them side by side at [ambikly.com/free-vs-pro](https://ambikly.com/free-vs-pro/).

= Where can I get support? =

Community support is available on the [wordpress.org support forum](https://wordpress.org/support/plugin/ambikly/). Pro customers get priority email support — see [ambikly.com/support](https://ambikly.com/support/).

== Screenshots ==

1. Dashboard — sales trend, best sellers, and recent orders at a glance
2. Product editor — photos, pricing, and status in one screen
3. Orders — every purchase, filterable by status and payment state
4. Order detail — line items, shipment tracking, and customer notes
5. Storefront shop — the product grid your customers see
6. Checkout — billing details, order summary, and coupon field

== Changelog ==

= 1.0.1 =
* Fix: two admin links (the setup wizard's "Add a product" button and the low-stock/out-of-stock email's "Manage product" link) pointed at an unregistered admin page and returned a 403 instead of opening the product editor.
* Add: a "Add sample products" tool (Setup Wizard finish step and Tools screen) that creates 5 example products — simple, variable with real variations, digital download, digital with multiple pricing plans, and one on sale.
* Add: a "Rerun setup wizard" shortcut on the Tools screen.

= 1.0.0 =
* First stable release.

== Upgrade Notice ==

= 1.0.1 =
Fixes two broken admin links and adds a one-click sample-product importer.

= 1.0.0 =
First stable release.

== External services ==

This plugin connects to the following third-party services when you enable the corresponding payment gateway:

* **Stripe** — card and wallet payments are processed by Stripe when the Stripe gateway is enabled. Checkout data (amount, currency, and billing details you provide) is sent to stripe.com to create and confirm the payment. See [Stripe's Privacy Policy](https://stripe.com/privacy) and [Terms of Service](https://stripe.com/legal).
* **PayPal** — payments are processed by PayPal when the PayPal gateway is enabled. Order and buyer details are sent to paypal.com to create and capture the transaction. See [PayPal's Privacy Policy](https://www.paypal.com/privacy) and [Terms of Service](https://www.paypal.com/legalhub).

Neither service is contacted unless the corresponding gateway is enabled and used at checkout.
