Changeset 3464431

Timestamp:

02/18/2026 02:54:00 PM (2 days ago)

Author:

kitbix

Message:

Release version 1.0.8

File:

• kitbix-commerce/trunk/readme.txt (modified) (3 diffs)

kitbix-commerce/trunk/readme.txt

@@ -1 +1 @@
 === Kitbix Commerce ===
 Contributors: kitbix
-Tags: ecommerce, shop, cart, checkout, products
-Requires at least: 6.0
+Tags: ecommerce, woocommerce alternative, online store, shopping cart, stripe, paypal, digital downloads, subscriptions, wordpress ecommerce
+Requires at least: 5.5
 Tested up to: 6.9
 Requires PHP: 7.4
@@ -9 +9 @@
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
 
-Lightweight WordPress eCommerce plugin with a React admin dashboard and theme-friendly storefront.
+The best lightweight WordPress eCommerce plugin — sell physical products, digital downloads, and subscriptions with Stripe, PayPal, and a modern React admin.
 
 == Description ==
 
-Kitbix Commerce is designed for merchants who want a fast store that feels like WordPress. It keeps the frontend simple (no heavy framework) while shipping a modern React-powered admin inside wp-admin for daily store operations.
-
-Learn more: https://kitbix.com/kitbix-commerce/
-
-### Why merchants install Kitbix Commerce
-
-- Set up a store without changing themes or installing bulky page builders.
-- Use WordPress-native patterns (shortcodes, REST API, wp-admin) for every touchpoint.
-- Keep performance high with a minimal storefront footprint.
-
-### Feature highlights
-
-**Store management**
-
-- React-based product, order, and customer dashboards with search, filters, and pagination.
-- Customer timeline showing order counts and total spend for each buyer.
-- Dedicated database tables so large catalogs stay organized without cluttering `wp_posts`.
-- Order detail modal shows payment gateway + transaction ID and lets admins add customer-facing order notes that sync to emails.
-
-**Storefront experience**
-
-- Shortcodes for shop, product, cart, and checkout pages.
+### 🛒 What is Kitbix Commerce?
+
+**Kitbix Commerce** is a complete WordPress eCommerce plugin that lets you build a professional online store in minutes — without page builders, without theme lock-in, and without the bloat.
+
+Whether you're selling physical goods, digital downloads, or recurring subscriptions, Kitbix Commerce gives you everything you need in one lightweight plugin that works with any WordPress theme out of the box.
+
+👉 **[See the full feature tour at kitbix.com/kitbix-commerce/](https://kitbix.com/kitbix-commerce/)**
+
+---
+
+### 💡 Why Kitbix Commerce Stands Out
+
+Kitbix Commerce is not just another WordPress shop plugin. It's a complete eCommerce system built for speed, simplicity, and developer freedom. Here's why it stands out:
+
+- **You own your data** — all product, order, and customer data stays on your WordPress site. Nothing is sent to external servers unless you enable a payment gateway.
+- **Zero bloat** — the public storefront loads minimal CSS and JavaScript. Your store stays fast.
+- **Works with any WordPress theme** — no theme switching or page builder required. Drop in a shortcode and you're live.
+- **Modern React admin** — manage products, orders, and customers from a beautiful dashboard inside wp-admin.
+- **Built for developers** — PSR-4 autoloading, REST API, hook system, and addon contracts make customisation straightforward.
+- **Stripe, PayPal & COD built in** — start accepting payments in minutes with zero extra plugins.
+
+---
+
+### 🌟 Key Features of Kitbix Commerce
+
+✅ Unlimited products — sell physical goods, digital files, or subscriptions.
+🛒 Shortcode storefront — shop, product, cart, and checkout pages anywhere.
+💳 Payment gateways — Stripe, PayPal, and Cash on Delivery built in.
+📦 Eight free addons — Live Purchase Toast, Live View Counter, Product Q&A, and more.
+⚛️ React admin dashboard — fast, modern product and order management inside wp-admin.
+👥 Customer directory — order history, total spend, and profile insights per buyer.
+🖨️ Order printing — print receipts directly from wp-admin.
+🔌 Extensible — add custom gateways, addons, and templates with clean PHP interfaces.
+🌍 Translation ready — all strings are translatable via standard WordPress tools.
+
+---
+
+### 🛍️ Product & Store Management
+
+Creating and managing products with Kitbix Commerce is simple and powerful. The React-powered admin lets you:
+
+- Create unlimited products with images, descriptions, categories, and pricing.
+- Set regular and sale prices per product.
+- Manage a searchable, filterable product catalog.
+- Import products in bulk for fast catalog setup.
+- Create orders manually from wp-admin when needed.
+- View a customer timeline showing order history and total spend per buyer.
+- Add customer-facing order notes that sync to email notifications.
+- Track payment gateway, transaction ID, and order status per order.
+
+All store data lives in dedicated custom database tables — your `wp_posts` table stays clean and your store scales without performance issues.
+
+---
+
+### 🛒 Storefront & Checkout Experience
+
+Kitbix Commerce gives your customers a smooth, fast shopping experience:
+
+- Place your shop, product, cart, and checkout anywhere using simple shortcodes.
 - Category filtering on the product grid for easier browsing.
-- Theme-friendly HTML/CSS output you can restyle quickly.
-- Cart + checkout flows powered by Kitbix REST endpoints for faster updates.
-
-**Payments & checkout**
-
-- Works with Stripe, PayPal, and Cash on Delivery out of the box.
-- Checkout flow supports card fields, redirects, or offline instructions.
-- Trust-building addons available (Live View Counter, Payment Trust Badge, Product Q&A, more).
-
-**Built-in addons**
-
-The free plugin bundles eight addons you can turn on from **Kitbix Commerce → Addons**:
-
-1. Live Purchase Toast
-2. Live View Counter
-3. Order Printing
-4. Payment Trust Badge
-5. Product Q&A
-6. Related Products
-7. Shipping Cutoff Clock
-8. WhatsApp Contact Button
-
-Each addon comes with its own settings and front-end UI so you can enable urgency, social proof, or support tools in one click.
+- Theme-friendly HTML/CSS output that inherits your active theme's styles automatically.
+- Fast cart and checkout powered by Kitbix REST API — no full page reloads.
+- Checkout loading indicator with button disable state for better UX.
+- Guest checkout supported out of the box — no account required.
+
+---
+
+### 💳 Payments & Gateways
+
+Kitbix Commerce includes three payment gateways ready to use from day one:
+
+- **Stripe** — card payments with Stripe Elements and PaymentIntents for secure, modern card collection.
+- **PayPal** — redirect-based PayPal checkout for buyers who prefer PayPal.
+- **Cash on Delivery** — offline payment support for in-person or bank transfer orders.
+
+Need a custom gateway? Implement the `PaymentGatewayInterface` and hook into `kitbix_commerce_payment_gateways` — the admin UI and checkout pick it up automatically. Webhook support is built in for asynchronous payment confirmation.
+
+---
+
+### 📦 Built-in Free Addons
+
+Enable powerful store features from **Kitbix Commerce → Addons** with a single click — no code required:
+
+1. **Live Purchase Toast** — show real-time purchase notifications to boost social proof.
+2. **Live View Counter** — display how many people are viewing a product right now.
+3. **Order Printing** — print order receipts directly from wp-admin.
+4. **Payment Trust Badge** — display trust icons at checkout to increase conversions.
+5. **Product Q&A** — let shoppers ask questions directly on product pages.
+6. **Related Products** — automatically suggest relevant products to increase average order value.
+7. **Shipping Cutoff Clock** — create urgency with a countdown to the next dispatch time.
+8. **WhatsApp Contact Button** — let customers reach you instantly via WhatsApp.
+
+Each addon has its own settings panel and front-end UI.
+
+---
+
+### 🚀 Upgrade to Kitbix Commerce Pro
+
+Unlock advanced revenue features with **[Kitbix Commerce Pro](https://kitbix.com/kitbix-commerce/)**:
+
+**🔄 Subscriptions & Licensing**
+Sell recurring monthly or yearly subscriptions with Stripe billing. Includes free trial periods, grace periods after failed renewals, automatic renewal via WP-Cron, and optional per-site license key generation. Customers get a direct checkout link for each subscription product.
+
+**📥 Digital Downloads**
+Sell eBooks, software, music, or any file with secure tokenised download links. Set per-file download limits and expiry dates. Customers receive their download links by email automatically after purchase. A dedicated Downloads tab appears in the customer account area.
+
+**👤 Customer Accounts**
+Give customers a secure `/account` portal to view their order history and manage their downloads — all inside your own WordPress site.
+
+**⭐ Product Reviews**
+Collect verified reviews from real buyers and display star ratings on product pages. Fully customisable section headings, subheadings, and empty-state messages.
+
+**🎨 Storefront Design Presets**
+Switch between 30+ curated layouts for product grids, product detail pages, cart, and checkout — no coding needed. Activate any preset instantly from the Design Presets admin panel.
+
+---
+
+### 🔧 For Developers
+
+Kitbix Commerce is built with modern PHP practices and a clean architecture:
+
+- PSR-4 autoloading via Composer.
+- Full REST API for products, orders, customers, and payments.
+- Hook system (`do_action` / `apply_filters`) for every major event.
+- Addon contract interface — build and register your own addons.
+- Custom payment gateway interface — integrate any provider.
+- Shortcodes and Gutenberg blocks for flexible page placement.
+
+📖 Developer docs: [commerce.kitbix.com/docs](https://commerce.kitbix.com/docs)
+
+---
+
+### 💡 Who Should Use Kitbix Commerce?
+
+- **Small business owners** who want a fast, simple store without WooCommerce complexity.
+- **Freelancers and agencies** building client stores that need to stay lean and maintainable.
+- **Digital creators** selling eBooks, courses, or software files (with Pro).
+- **SaaS founders** selling WordPress plugin licenses with recurring billing (with Pro).
+- **Developers** who want a clean, hookable eCommerce foundation to build on.
+
+---
+
+### 🌱 Start Selling Today
+
+Install Kitbix Commerce, add four shortcodes to your pages, and you have a fully working online store — in under five minutes.
+
+👉 **[kitbix.com/kitbix-commerce/](https://kitbix.com/kitbix-commerce/)**
+
+---
+
+### Shortcodes
+
+| Shortcode | Purpose |
+|---|---|
+| `[kitbix_commerce_products]` | Product listing / shop grid |
+| `[kitbix_commerce_product]` | Single product page |
+| `[kitbix_commerce_cart]` | Shopping cart |
+| `[kitbix_commerce_checkout]` | Checkout page |
+| `[kitbix_commerce_cart_count]` | Cart item count badge |
 
 == Installation ==
 
-1. Upload the plugin ZIP via Plugins -> Add New -> Upload Plugin (or copy the `kitbix-commerce` folder into `wp-content/plugins/`).
-2. Activate Kitbix Commerce from the Plugins screen.
-3. Open Kitbix Commerce -> Dashboard in wp-admin.
-4. Create products and add the shortcodes below to pages.
-
-Recommended pages:
+1. Upload the plugin ZIP via **Plugins → Add New → Upload Plugin** (or copy the `kitbix-commerce` folder into `wp-content/plugins/`).
+2. Activate **Kitbix Commerce** from the Plugins screen.
+3. Go to **Kitbix Commerce → Dashboard** in wp-admin.
+4. Create your first product and add the shortcodes to your pages.
+
+**Recommended page setup:**
 
 - Shop page: `[kitbix_commerce_products]`
@@ -76 +189 @@
 == External services ==
 
-Kitbix Commerce can send data to payment providers *only when those gateways are enabled* inside **Settings → Payments**:
-
-- **Stripe** – loads `https://js.stripe.com/v3/` on checkout and sends customer/order details to Stripe’s PHP SDK when charging cards. See the [Stripe Terms](https://stripe.com/legal) and [Stripe Privacy Policy](https://stripe.com/privacy).
-- **PayPal** – communicates with `https://api-m.paypal.com` or sandbox endpoints to create/complete orders. See the [PayPal User Agreement](https://www.paypal.com/us/legalhub/useragreement-full) and [PayPal Privacy Statement](https://www.paypal.com/us/legalhub/privacy-full).
+Kitbix Commerce connects to payment providers **only when those gateways are enabled** inside **Settings → Payments**:
+
+- **Stripe** – loads `https://js.stripe.com/v3/` on checkout and sends customer/order details to Stripe's PHP SDK when charging cards. See the [Stripe Terms](https://stripe.com/legal) and [Stripe Privacy Policy](https://stripe.com/privacy).
+- **PayPal** – communicates with `https://api-m.paypal.com` or sandbox endpoints to create and complete orders. See the [PayPal User Agreement](https://www.paypal.com/us/legalhub/useragreement-full) and [PayPal Privacy Statement](https://www.paypal.com/us/legalhub/privacy-full).
+
+No data is sent to any external service unless the respective gateway is explicitly enabled by the site administrator.
 
 == Frequently Asked Questions ==
 
+= Is Kitbix Commerce free? =
+
+Yes. The core plugin is 100% free and includes unlimited products, orders, customers, Stripe/PayPal/COD payments, and eight built-in addons. [Kitbix Commerce Pro](https://kitbix.com/kitbix-commerce/) adds subscriptions, digital downloads, customer accounts, product reviews, and 30+ design presets.
+
+= Is there a limit on products or orders? =
+
+No. You can create unlimited products and accept unlimited orders with the free plugin.
+
+= Which payment gateways are supported? =
+
+Kitbix Commerce includes Stripe, PayPal, and Cash on Delivery out of the box. Developers can register additional custom gateways using the `PaymentGatewayInterface`.
+
+= Are there any transaction fees from Kitbix Commerce? =
+
+None. The only fees are from your payment processor (Stripe or PayPal). Kitbix Commerce takes no commission.
+
 = What shortcodes are available? =
 
 - `[kitbix_commerce_products]` — Product listing/grid
-- `[kitbix_commerce_product]` — Product page
-- `[kitbix_commerce_cart]` — Cart page
+- `[kitbix_commerce_product]` — Single product page
+- `[kitbix_commerce_cart]` — Shopping cart
 - `[kitbix_commerce_checkout]` — Checkout page
-
-= Where do I manage products and orders? =
-
-In wp-admin under **Kitbix Commerce → Dashboard**.
-
+- `[kitbix_commerce_cart_count]` — Cart item count
+
+= Will it work with my WordPress theme? =
+
+Yes. Kitbix Commerce outputs plain semantic HTML that inherits your theme's styles automatically. You can also override templates from the plugin for pixel-perfect control.
+
+= Will it slow down my site? =
+
+No. The public storefront loads minimal CSS and JavaScript. All heavy admin assets are loaded only inside wp-admin.
 
 = Does it create database tables? =
 
-Yes. Activation runs migrations for orders, order items, products, customers, and metadata.
-
-= Does uninstall remove data? =
-
-No. Data is preserved by default so you can reinstall without losing orders. You can delete tables manually if needed.
-
-= Will this slow down my site? =
-
-No. The public templates are lightweight and load minimal CSS/JS. Heavy assets stay inside wp-admin.
-
-= Will it work with my theme? =
-
-Yes. Output is plain HTML that inherits your theme styles. You can override templates from the plugin if you need pixel-perfect control.
+Yes. On activation, Kitbix Commerce creates dedicated tables for products, orders, order items, customers, and metadata — keeping your `wp_posts` table clean and your store fast.
+
+= Does Kitbix Commerce collect any data? =
+
+No. Kitbix Commerce does not collect product, order, or customer data. All information stays securely within your own WordPress site. Data is only sent to Stripe or PayPal when those gateways are explicitly enabled.
+
+= Does uninstalling remove my store data? =
+
+No. Your store data is preserved by default so you can reinstall without losing orders or products. You can remove the database tables manually if needed.
+
+= Can I add a custom payment gateway? =
+
+Yes. Implement the `KitbixCommerce\Services\Payment\PaymentGatewayInterface` and hook into `kitbix_commerce_payment_gateways` to register it. The admin UI and checkout will pick it up automatically.
 
 = Where is developer documentation? =
 
-Please visit [commerce.kitbix.com/docs](https://commerce.kitbix.com/docs) for hooks, REST endpoints, addon boilerplates, and advanced guides.
+Visit [commerce.kitbix.com/docs](https://commerce.kitbix.com/docs) for REST API references, hook documentation, addon boilerplates, and advanced guides.
+
+= Does Kitbix Commerce offer support? =
+
+Yes. You can get support via the WordPress.org support forum. Pro customers receive priority support through [kitbix.com](https://kitbix.com/kitbix-commerce/).
 
 == Screenshots ==