=== SibroX ===
Author: Sibro Commerce Team
Author URI: https://sibrocommerce.com/
Contributors: sibro
Stable tag: 0.0.1
Requires PHP: 7.4
Tags: woocommerce, reseller, marketplace, Sibro, dropshipping
Requires at least: 5.0
Tested up to: 6.9
WC requires at least: 5.0
WC tested up to: 10.2.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect your WooCommerce store to the Sibro reseller marketplace to expand reach and sell through resellers across Nigeria.

== Description ==

👉 Expand Your Reach with Sibro Resellers!

👉 <i>Connect your WooCommerce store to Nigeria's growing reseller marketplace and let thousands of resellers sell your products for you</i>

As an eCommerce vendor, finding new customers and expanding your market reach can be challenging and expensive. What if you could tap into a network of motivated resellers who actively promote and sell your products to their own customer base?

<a href="https://sibrocommerce.com/features/sibrox">sibrox</a> is designed for WooCommerce store owners who want to <strong>scale their business across Nigeria</strong> by connecting with the Sibro reseller marketplace — a fast-growing platform where resellers help vendors like you reach more customers, increase visibility, and boost revenue.

This plugin seamlessly integrates your WooCommerce store with Sibro, allowing you to <strong>sync your products directly to the marketplace</strong> where resellers can discover, promote, and sell them to their networks.

With sibrox, you maintain full control of your inventory while resellers handle the marketing and customer acquisition. It's the perfect solution for <strong>wholesalers, manufacturers, and retailers</strong> looking to expand their distribution channels without additional overhead.

== External Service Disclosure ==

This plugin relies on the Sibro Marketplace API to function.

<strong>Sibro Marketplace</strong>
This service is used to sync your WooCommerce products to the Sibro reseller marketplace, allowing resellers to find and sell your products.
*   <strong>Service URL:</strong> https://sibro.ng
*   <strong>Data Sent:</strong> Product information including title, description, price, stock levels, images, and category data.
*   <strong>When Data is Sent:</strong> Data is sent when you manually trigger a sync, or automatically when product stock changes or orders are placed (if these options are enabled in settings).
*   <strong>Terms of Service:</strong> <a href="https://www.sibro.ng/pages/seller-terms">https://www.sibro.ng/pages/seller-terms</a>
*   <strong>Privacy Policy:</strong> <a href="https://www.sibro.ng/pages/seller-privacy">https://www.sibro.ng/pages/seller-privacy</a>

== 💁 Key Features of sibrox ==

<i>Everything you need to successfully list your products on the Sibro reseller marketplace</i>

The sibrox plugin is equipped with powerful features to make syncing your products simple and efficient:

🔑 <strong>One-Click Product Sync</strong> – Send all your products to Sibro marketplace with a single click
🔑 <strong>Smart Category Mapping</strong> – Map your WooCommerce categories to Sibro's marketplace categories for accurate product placement
🔑 <strong>Real-Time Stock Updates</strong> – Keep inventory synchronized automatically when stock changes
🔑 <strong>Order-Based Sync</strong> – Automatically update Sibro when orders affect your stock levels
🔑 <strong>Selective Product Sync</strong> – Choose which products or categories to sync to the marketplace
🔑 <strong>Sync Status Dashboard</strong> – View all synced products, pending items, and sync history
🔑 <strong>Detailed Activity Logs</strong> – Track every sync operation with comprehensive logging

== 🚀 Why Choose Sibro Reseller Marketplace? ==

= Expand your business without the overhead =

<ul>
<li><strong>Access Thousands of Resellers</strong> – Tap into a network of active resellers across Nigeria</li>
<li><strong>Zero Marketing Cost</strong> – Resellers market your products to their customer base</li>
<li><strong>Increase Sales Volume</strong> – Multiple resellers selling your products means more sales</li>
<li><strong>Maintain Inventory Control</strong> – You fulfill orders while resellers handle sales</li>
<li><strong>Nationwide Reach</strong> – Reach customers in regions you couldn't access before</li>
<li><strong>Build Brand Awareness</strong> – More resellers means more visibility for your products</li>
<li><strong>Flexible Pricing</strong> – Set competitive reseller margins that work for your business</li>
<li><strong>Trusted Platform</strong> – Sibro handles reseller verification and marketplace management</li>
</ul>

== 📋 How It Works ==

= A simple 4-step process to start selling through resellers =

<strong>1. Install & Configure</strong>
Install the plugin, enter your Sibro API key from the mobile app, and configure your sync preferences.

<strong>2. Map Your Categories</strong>
Use the intuitive category mapping interface to match your WooCommerce categories to Sibro marketplace categories.

<strong>3. Sync Your Products</strong>
Click "Sync All Products" to send your inventory to the Sibro marketplace where resellers can find them.

<strong>4. Receive Orders & Fulfill</strong>
When resellers make sales, you receive orders and ship directly to customers — simple!

== 💼 Perfect For ==

= Businesses that benefit most from reseller networks =

<ul>
<li><strong>Fashion & Apparel Vendors</strong> – Clothing, shoes, accessories, and jewelry</li>
<li><strong>Electronics Retailers</strong> – Phones, gadgets, accessories, and tech products</li>
<li><strong>Health & Beauty Brands</strong> – Cosmetics, skincare, and wellness products</li>
<li><strong>Home & Living Suppliers</strong> – Furniture, décor, and household items</li>
<li><strong>Food & Beverage Producers</strong> – Packaged foods, beverages, and groceries</li>
<li><strong>Wholesalers & Distributors</strong> – Anyone looking to expand their dealer network</li>
<li><strong>Manufacturers</strong> – Direct-to-reseller distribution channels</li>
</ul>

== 💁 Contact Us or Submit Support Ticket ==

Need help getting started or have questions? Our support team is here to assist you!

<ul>
<li><strong>Email Support:</strong> <a href="mailto:connect@sibro.ng">connect@sibro.ng</a></li>
<li><strong>Phone Support:</strong> <a href="tel:+2348167823631">+234 816 782 3631</a></li>
<li><strong>Visit Website:</strong> <a href="https://sibrocommerce.com" target="_blank">sibrocommerce.com</a></li>
</ul>

When contacting support, please include:
<ul>
<li>Your WooCommerce store URL</li>
<li>Description of the issue</li>
<li>Any error messages from the Sync Log</li>
<li>Steps you've already tried</li>
</ul>

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin panel
2. Go to Plugins → Add New
3. Search for "sibrox"
4. Click "Install Now" and then "Activate"
5. Go to Product Sync → Settings to configure your API key

= Manual Installation =

1. Download the plugin ZIP file
2. Log in to your WordPress admin panel
3. Go to Plugins → Add New → Upload Plugin
4. Choose the ZIP file and click "Install Now"
5. Activate the plugin
6. Go to Product Sync → Settings to configure your API key

= Configuration =

1. Open the Sibro mobile app and copy your API key
2. In WordPress, go to Product Sync → Settings
3. Paste your API key and save
4. Navigate to Category Mapping to link your WooCommerce categories to Sibro categories
5. Return to the Dashboard and click "Sync All Products"

== Frequently Asked Questions ==

= Q. How do I get my Sibro API key? =
Ans: Download the Sibro mobile app, create a vendor account, and your API key will be available in your account settings. Contact support if you need assistance.

= Q. Will syncing modify my WooCommerce products? =
Ans: No! The plugin only sends product data TO Sibro. Your WooCommerce products remain unchanged. The sync is one-way: from your store to the marketplace.

= Q. Can I choose which products to sync? =
Ans: Yes! You can filter by product status (published, draft, etc.) or specific categories. You can also enable/disable sync for individual products on their edit pages.

= Q. How does the category mapping work? =
Ans: Navigate to Category Mapping, select each WooCommerce category, and match it to the appropriate Sibro Parent Category → Category → Subcategory. This ensures your products appear in the right place on the marketplace.

= Q. What happens if my stock changes? =
Ans: If you enable "Sync on Stock Change" in settings, the plugin automatically updates Sibro whenever your inventory levels change in WooCommerce.

= Q. Can I set different pricing for resellers? =
Ans: Yes! In Settings, you can set a reseller discount as a percentage or fixed amount. This determines the margin resellers earn when they sell your products.

= Q. Does it work with variable products? =
Ans: Yes! The plugin fully supports simple and variable products, including all variations with their own pricing and stock levels.

= Q. What if the Sibro API is unavailable? =
Ans: The plugin includes robust error handling. All sync attempts are logged, and you can retry failed syncs from the dashboard. Errors are also written to dedicated log files for troubleshooting.

= Q. Does it work with WooCommerce HPOS? =
Ans: Yes! sibrox is fully compatible with WooCommerce High-Performance Order Storage (HPOS).

= Q. Is my data secure? =
Ans: Yes! All API communications use secure HTTPS connections. Admin endpoints are protected with WordPress nonces and capability checks. No customer data is sent to external services.

== Screenshots ==

1. Admin dashboard with sync status, product counts, and quick actions
2. Category mapping interface – map WooCommerce categories to Sibro marketplace categories
3. Settings page – configure API key, sync options, and reseller pricing
4. Sync log – track all synchronization activity with detailed logs
5. Support page – quick access to help documentation and contact options

== Changelog ==
= 1.0.0 =
First stable release. Connect your WooCommerce store to Sibro reseller marketplace!

== Privacy ==

This plugin communicates with the Sibro API (https://sync.sibro.ng) to synchronize product data with the Sibro reseller marketplace. 

<strong>Data sent to Sibro:</strong>
<ul>
<li>Product information (title, description, price, images, stock levels)</li>
<li>Category mappings</li>
<li>Store identifier (API key)</li>
</ul>

<strong>Data NOT sent:</strong>
<ul>
<li>Customer personal information</li>
<li>Order details</li>
<li>Payment information</li>
</ul>

API credentials are stored securely in the WordPress options table. For more information, please review our <a href="https://sibrocommerce.com/privacy">Privacy Policy</a>.

== Notes for Developers ==

* Built using WordPress HTTP API (wp_remote_get, wp_remote_post)
* All admin AJAX endpoints protected by nonces and capability checks (manage_options)
* Follows WordPress coding standards
* Extensible architecture with separate classes for admin, API, products, and categories
* Full support for WooCommerce HPOS (High-Performance Order Storage)
* Database tables created with proper indexes for performance