=== 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.3
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Lightweight WordPress eCommerce plugin with a React admin dashboard and theme-friendly storefront.

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

### 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`.

**Storefront experience**

- Shortcodes for shop, product, cart, and checkout pages.
- 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 seven addons you can turn on 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 comes with its own settings and front-end UI so you can enable urgency, social proof, or support tools in one click.

== 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:

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

== 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).

== Frequently Asked Questions ==

= What shortcodes are available? =

- `[kitbix_commerce_products]` — Product listing/grid
- `[kitbix_commerce_product]` — Product page
- `[kitbix_commerce_cart]` — Cart page
- `[kitbix_commerce_checkout]` — Checkout page

= Where do I manage products and orders? =

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


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

= Where is developer documentation? =

Please visit [commerce.kitbix.com/docs](https://commerce.kitbix.com/docs) for hooks, REST endpoints, addon boilerplates, and advanced guides.

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

== Changelog ==

= 1.0.3 =
- Fixed checkout redirect handling

= 1.0.2 =
- Improve wording and directory compliance

= 1.0.1 =
- Update readme.txt

= 1.0.0 =
- Initial release.