=== Kitbix Commerce ===
Contributors: kitbix
Tags: ecommerce, shop, cart, checkout, products
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Lightweight WordPress-native eCommerce with a modern React admin and fast storefront.

== Description ==

Kitbix Commerce is a lightweight eCommerce plugin built for WordPress users who want a fast, simple store without the overhead of bulky platforms.

The storefront stays clean and theme-friendly, while all heavy logic lives inside a modern React-powered admin experience in wp-admin. You get full store control without turning WordPress into something it’s not.

### Why merchants choose Kitbix Commerce

- Set up a store without changing themes or installing page builders.
- Keep the frontend minimal and performance-focused.
- Manage products, orders, and customers from a modern React dashboard.
- Use WordPress-native patterns like shortcodes, REST API, and wp-admin screens.

### Store management

- React-based dashboards for products, orders, and customers.
- Search, filters, and pagination built in.
- Customer profiles showing order count and total spend.
- Dedicated database tables for better performance on large catalogs.

### Storefront experience

- Shortcodes for shop, product, cart, and checkout pages.
- Category filtering on product grids.
- Clean HTML/CSS output that inherits your theme styles.
- Fast cart and checkout powered by REST endpoints.

### Payments and checkout

- Supports Stripe, PayPal, and Cash on Delivery.
- Flexible checkout flows: embedded card fields, redirects, or offline instructions.
- Designed to support additional gateways and extensions.

### Built-in addons

Kitbix Commerce includes several optional addons you can enable from **Kitbix Commerce → Addons**:

1. Live Purchase Toast
2. Live View Counter
3. Payment Trust Badge
4. Product Q&A
5. Related Products
6. Shipping Cutoff Clock
7. WhatsApp Contact Button

Each addon can be enabled independently and includes its own settings and frontend UI.

== 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 your pages.

Recommended pages:

- Shop page: `[kitbix_commerce_products]`
- Product page: `[kitbix_commerce_product]`
- Cart page: `[kitbix_commerce_cart]`
- Checkout page: `[kitbix_commerce_checkout]`

== Frequently Asked Questions ==

= What shortcodes are available? =

- `[kitbix_commerce_products]` — Product listing or grid
- `[kitbix_commerce_product]` — Single product display
- `[kitbix_commerce_cart]` — Shopping cart
- `[kitbix_commerce_checkout]` — Checkout flow

= Where do I manage products and orders? =

Inside wp-admin under **Kitbix Commerce → Dashboard**.

= Does this plugin create database tables? =

Yes. On activation, Kitbix Commerce creates custom tables for products, orders, order items, customers, and related metadata.

= Will uninstalling the plugin delete my data? =

No. Data is preserved by default so you can safely reinstall. Tables can be removed manually if needed.

= Will this slow down my site? =

No. Public-facing templates are lightweight and load minimal CSS and JavaScript. Heavy assets are limited to wp-admin.

= Will it work with my theme? =

Yes. The frontend output uses plain HTML that inherits your theme’s styles. Templates can be overridden if you need deeper customization.

= Where can developers find documentation? =

Visit https://commerce.kitbix.com/docs for hooks, REST endpoints, addon boilerplates, and advanced guides.

== External Services ==

Kitbix Commerce connects to third-party services only when specific features are enabled:

- **Stripe**  
  Loads `https://js.stripe.com/v3/` on checkout and sends payment data to Stripe’s API when processing card payments.  
  Terms: https://stripe.com/legal  
  Privacy: https://stripe.com/privacy

- **PayPal**  
  Communicates with PayPal APIs to create and complete checkout orders.  
  Terms: https://www.paypal.com/us/legalhub/useragreement-full  
  Privacy: https://www.paypal.com/us/legalhub/privacy-full

No data is sent to external services unless the corresponding payment gateway is enabled.

== Screenshots ==

1. Products dashboard
2. Built-in cart and checkout
3. Orders manager
4. Analytics overview
5. Customers list
6. Store settings
7. Addon manager

== Changelog ==

= 1.0.2 = 
- Improve wording and directory compliance

= 1.0.1 =
- Update readme.txt

= 1.0.0 =
- Initial release