=== BilloraOne Connector ===
Contributors: billoraone
Tags: woocommerce, ecommerce, inventory, orders, billora
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.4.19
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
WC tested up to: 9.8

Connect WordPress or WooCommerce to BilloraOne for billing, inventory, ecommerce, customers, and business ops from one cloud platform.

== Description ==

Connect your WordPress or WooCommerce website with BilloraOne to manage billing, inventory, ecommerce, customers, and business operations from one cloud platform.

= Partner with BilloraOne =

Turn your network into income with BilloraOne's powerful partner ecosystem.

* [Referral Program](https://billoraone.com/referrals)
* [Sales Partner Program](https://billoraone.com/partners)
* [White Label Partner Program](https://billoraone.com/whitelabel-partner)

Join, refer, sell, and earn recurring commissions while helping businesses grow.

[BilloraOne](https://billoraone.com) is a complete cloud-based business management platform that helps retailers, wholesalers, and growing businesses manage their entire business from one place.

Instead of using multiple plugins and software, BilloraOne brings everything together, including billing, inventory, ecommerce, accounting, customer management, marketing, and AI-powered automation.

The WordPress Connector securely links your website with your BilloraOne account. All business data stays in BilloraOne while your website displays products, customer information, and other connected features through secure APIs.

**Requires an active BilloraOne account.** Storefront embeds, WooCommerce sync, and insights widgets depend on your BilloraOne plan. This is a SaaS service requirement, not a paid unlock inside the plugin.

= Perfect for =

* Grocery stores and supermarkets
* Fashion and electronics shops
* Mobile and hardware stores
* Furniture stores and gift shops
* Restaurants and cafés
* Wholesale businesses
* Any retail or service business

= Why choose BilloraOne? =

Manage your entire business from a single platform:

* POS billing
* GST invoicing
* Inventory management
* Purchase management
* Customer management
* Supplier management
* Multi-store support
* Barcode management
* Ecommerce integration
* Free business website
* WordPress integration
* Membership and loyalty programs
* Reward points and wallet
* AI SEO blogging
* Google Business Profile integration
* Marketing automation
* Business reports and analytics
* Cloud backup and security

= What this plugin does =

The BilloraOne Connector is a lightweight integration plugin that securely connects your WordPress website with BilloraOne. Using this plugin you can:

* Connect your website in minutes
* Start a free trial
* Securely authenticate your website
* Sync products and customers
* Display BilloraOne products and categories
* Receive real-time updates through secure APIs
* Monitor connection status
* Manage your website from BilloraOne

No complex configuration required.

= Secure and fast =

This plugin does not duplicate your business logic. BilloraOne remains the single source of truth while WordPress connects securely using APIs. This keeps your website fast, secure, and easy to maintain.

= Getting started =

1. Install the plugin.
2. Activate it.
3. Connect your BilloraOne account.
4. Start your 14-day free trial.
5. Manage your business from BilloraOne.

= Support =

* Website: [https://billoraone.com](https://billoraone.com)
* Documentation: [https://billoraone.com/docs](https://billoraone.com/docs)
* Partner program: [https://billoraone.com/partners](https://billoraone.com/partners)
* Whitelabel partner program: [https://billoraone.com/whitelabel-partner](https://billoraone.com/whitelabel-partner)

== Installation ==

1. Install and activate **WooCommerce** (required for order webhooks and product sync).
2. Upload and activate **BilloraOne Connector**.
3. In WordPress admin, go to **BilloraOne → Advanced** and set your **BilloraOne app URL** if you use a white-label portal.
4. Click **Connect with BilloraOne** while logged into your BilloraOne store admin.
5. After authorization, use **Sync products to Woo** or add BilloraOne shortcodes to pages.

You can also download the latest ZIP from BilloraOne → Connect → WordPress in your BilloraOne dashboard.

== External services ==

This plugin connects to BilloraOne APIs to provide its functionality. Data is sent only after a site administrator connects the site.

**Service:** BilloraOne (https://billoraone.com)

**What is sent:**

* On connect: site URL, return URL, one-time OAuth code exchange
* While connected: site token, tenant ID, site ID, plugin version
* Heartbeat (twice daily): WordPress version, PHP version, WooCommerce version, theme name, timezone, locale, currency
* Woo bridge setup: WooCommerce REST consumer key/secret, webhook secret, store URL
* Storefront embeds: product catalog queries (read-only) for shortcodes/blocks
* Customer login shortcode: email and password submitted to BilloraOne storefront customer APIs (browser → BilloraOne; not stored in WordPress)
* Inbound catalog webhooks from BilloraOne (signed) to refresh local caches

**When data is sent:** After an administrator clicks **Connect with BilloraOne**, and whenever connected features run (sync, shortcodes, heartbeat, customer login).

**Default API endpoint:** `https://billoraone.com/api/v1` (overridable in plugin settings)

**Terms and privacy:** See [BilloraOne Terms](https://billoraone.com/terms) and [BilloraOne Privacy](https://billoraone.com/privacy) on the BilloraOne website.

== Frequently Asked Questions ==

= Do I need a BilloraOne subscription? =

Yes. BilloraOne is a cloud business platform, and this connector links your WordPress or WooCommerce site to your BilloraOne workspace. Start with a **14-day free trial**, then keep the plan that includes the modules you need (WooCommerce sync, product display, insights, and more). This is a SaaS service requirement, not a paid unlock inside the plugin.

= Does this replace WooCommerce? =

No. WooCommerce stays on your WordPress site when you sell there. BilloraOne handles billing, inventory, customers, and operations in the cloud while this plugin syncs products and customers, receives order webhooks, and keeps everything connected. You run your business from BilloraOne without maintaining two separate catalogs.

= Where does checkout happen? =

It depends how you sell. Checkout on your WordPress store runs through **WooCommerce**, and orders are sent to BilloraOne automatically. If you direct shoppers to your **BilloraOne storefront**, checkout happens on your BilloraOne domain. Either way, BilloraOne remains your central system for inventory, billing, and customer records.

= Is my data stored in WordPress? =

BilloraOne is the **single source of truth** for products, inventory, customers, and business data. WordPress only stores connection tokens, WooCommerce bridge credentials, and short-lived catalog cache. Sensitive business records stay in BilloraOne, and customer passwords are not stored in WordPress when using BilloraOne storefront login features.

= Can I use a custom BilloraOne domain? =

Yes. For white-label portals or partner environments, open **BilloraOne → Advanced** and set your **BilloraOne app URL** and **BilloraOne API base**. Your site will connect to your branded BilloraOne workspace instead of the default billoraone.com endpoints.

= How can I partner with BilloraOne? =

BilloraOne offers several partner paths. Join the [Referral Program](https://billoraone.com/referrals) to earn from referrals, the [Sales Partner Program](https://billoraone.com/partners) to promote BilloraOne with commissions, or the [White Label Partner Program](https://billoraone.com/whitelabel-partner) to resell the platform under your own brand and pricing.

= Is setup complicated? =

No. Install and activate the plugin, click **Connect with BilloraOne**, and authorize your workspace. Product sync, customer sync, and connection monitoring work through secure APIs with no complex server configuration.

== Screenshots ==

1. BilloraOne Connector — connect WordPress and WooCommerce with one-click sync and secure APIs.
2. Everything your business needs — POS, inventory, ecommerce, accounting, and integrations in one platform.
3. Meet BilloAI — your AI assistant for orders, marketing, content, and insights, 24×7.
4. One platform, every advantage — simplify, automate, and grow from a single BilloraOne workspace.
5. Write once, publish everywhere — share blog content to social channels with one click.
6. Low stock alerts — never run out of stock or lose a sale with smart inventory notifications.
7. AI SEO blogging — keyword research, AI articles, meta tags, and SEO optimization built in.
8. Purchase automation — create POs, manage suppliers, receive stock, and update inventory automatically.
9. Launch your online store in minutes and sync products, stock, and orders with BilloraOne POS.

== Changelog ==

= 1.4.19 =
* Remove Gutenberg block registration so the WordPress.org plugin page no longer shows a Blocks section; use shortcodes for storefront embeds. Existing billora block markup still renders on the front end.

= 1.4.18 =
* WordPress.org review: Contributors set to billoraone; settings flash notices limited to BilloraOne admin page.

= 1.4.17 =
* Plugin URI: https://billoraone.com/ — Author URI: WordPress.org @billoraone profile.

= 1.4.16 =
* Set distinct Plugin URI (docs) and Author URI (homepage) for WordPress.org submission.

= 1.4.15 =
* Version series reset for WordPress.org releases (continues from 1.4.15).
* Update plugin description for WordPress.org / Plugins screen.
* Includes prior 0.3.x readiness fixes (menu icon, text domain, dual-install guard).

= 0.3.15 =
* Update plugin description for WordPress.org / Plugins screen.

= 0.3.14 =
* Fix empty admin menu icon (WordPress strips data: image URIs — use plugin PNG URL instead).

= 0.3.13 =
* Fix activation fatal when an older billora-connector folder is still installed.
* Use the transparent white B1 mark as the left admin menu icon (data URI, no Plugins-list icon).
* Shorten readme short description to 150 characters.

= 0.3.12 =
* Align text domain and package folder with slug billoraone-connector for WordPress.org.
* Fix corrupted ellipsis characters in search/orders UI strings.
* Require https for custom API/app URLs (http only for localhost).
* Soft rate-limit public product search AJAX.

= 0.3.11 =
* Use the BilloraOne B1/WordPress/POS mark as the admin menu and Plugins list icon.

= 0.3.10 =
* Add Settings link on the Plugins screen (next to Deactivate) linking to the BilloraOne connector page.
* Use the BilloraOne favicon as the admin menu icon and on the Plugins list row.

= 0.3.9 =
* Fix unexpected output on activation caused by UTF-8 BOM in packaged PHP files.

= 0.3.8 =
* Unify user-facing branding to BilloraOne across admin UI, blocks, notices, and readme.

= 0.3.7 =
* Security: only attach Billora webhook secret header to the Billora WooCommerce webhook (not all webhooks).

= 0.3.6 =
* Rebrand display name to BilloraOne Connector; update plugin description and author.

= 0.3.5 =
* Plugin Check fixes: translators comments, escaped shortcode search output, languages folder in package.

= 0.3.4 =
* Align hero and insights width with the connected dashboard cards below.

= 0.3.3 =
* Remove "Generate shortcode pages" admin UI — site owners create pages themselves.
* Connected dashboard is a single-column layout (Woo bridge, subscription, advanced).

= 0.3.2 =
* WordPress.org readiness: feature access enforced by Billora API only (no local trialware-style locks).
* High-contrast connect / disconnect admin notices.
* When disconnected, guide new merchants to create a Billora account.
* Tested up to WordPress 7.0; translations load via WordPress.org when listed.

= 0.3.1 =
* Account shortcode shows recent Billora storefront orders after sign-in (not only links).
* Categories shortcode links each category to the Billora shop category page.
* Clarifies that WooCommerce My Account orders are separate from Billora storefront orders.

= 0.3.0 =
* Refreshed admin UI with Billora brand orange (#FC5504).
* Friendly errors when Billora API returns 502 HTML instead of dumping the gateway page.
* Generated storefront pages listed with View links after create.

= 0.2.9 =
* Add "Generate all shortcode pages" to create Shop, On Sale, Search, Categories, Store Links, Login, and Account pages in one click.

= 0.2.8 =
* Fix WooCommerce bridge: REST API keys failed on modern WooCommerce (false "Could not build WooCommerce credentials").
* Clearer errors when the API keys table or admin user is missing.

= 0.2.7 =
* Footer text: "Download latest ZIP" is plain text; only BilloraOne Connect → WordPress stays linked.

= 0.2.6 =
* Keep manually saved Billora app URL / API base (Connect no longer overwrites them).
* Settings form shows the stored app URL, not the billoraone.com fallback.

= 0.2.5 =
* Fix "Download latest ZIP" URL when Billora app URL includes /dashboard (was opening dashboard Not found).
* Normalize saved app URL to site origin only.

= 0.2.4 =
* Use billoraone.com for plugin site links and default API/app URLs (replaced billora.com).

= 0.2.3 =
* Security: OAuth state validation, REST webhook permission callback, safer AJAX search errors.
* Connectivity: server-side disconnect revoke, Woo credential cleanup, silent Woo bridge failures surfaced.
* API: broader catalog cache invalidation, CORS www/apex hosts, appBaseUrl in OAuth exchange.
* License gating fails closed; Woo actions respect plan modules; sync status on dashboard.

= 0.2.2 =
* WordPress.org readiness: readme.txt, GPL license, uninstall cleanup, dismissible admin notices, improved translations.
* Documentation updates for storefront login and account shortcodes.

= 0.2.1 =
* Embedded customer login shortcode and block.
* Catalog push webhooks for cache invalidation.

= 0.2.0 =
* Storefront shortcodes, Gutenberg blocks, live search, plan module gating.

= 0.1.0 =
* Initial release: OAuth connect, Woo bridge, insights widgets.

== Upgrade Notice ==

= 1.4.15 =
New 1.4.x version series for WordPress.org. Reinstall if you still have an older billora-connector folder.

= 0.3.13 =
Fixes activation when an older copy is still installed; refreshes the BilloraOne admin menu icon.

= 0.3.12 =
WordPress.org readiness: text domain / package folder aligned to billoraone-connector.

= 0.3.9 =
Fixes the “unexpected output during activation” warning (UTF-8 BOM).

= 0.3.8 =
User-facing text consistently uses the BilloraOne brand name.

= 0.3.7 =
Security fix: webhook secret is no longer sent on unrelated WooCommerce webhooks.

= 0.3.6 =
Display name and description updated to BilloraOne Connector.

= 0.3.5 =
Plugin Check compliance fixes before WordPress.org submission.

= 0.3.4 =
Admin layout: hero and stats match the width of the sections below.

= 0.3.3 =
Removes the shortcode page generator from the admin UI. Existing pages and shortcodes still work.

= 0.3.2 =
Clearer connect notices and WordPress.org compliance improvements for feature gating.

= 0.3.1 =
Account page now lists recent Billora storefront orders after login.

= 0.3.0 =
Refreshed Billora-branded admin UI and cleaner API error messages (no more raw 502 HTML).

= 0.2.9 =
One-click generation of WordPress pages with Billora storefront shortcodes.

= 0.2.8 =
Fixes WooCommerce REST key creation so Re-sync Woo bridge works on current WooCommerce versions.

= 0.2.7 =
Download latest ZIP is no longer a direct file link.

= 0.2.6 =
Keeps your saved Billora app URL; settings no longer reset to billoraone.com.

= 0.2.5 =
Fixes Download latest ZIP link resolving under /dashboard.

= 0.2.4 =
Updates Visit plugin site and defaults to billoraone.com.

= 0.2.3 =
Security and connectivity hardening. Recommended update for all sites.

= 0.2.2 =
Compliance and documentation update. Recommended before WordPress.org submission.
