=== CatalogCast – Social Publisher for WooCommerce ===
Contributors: goranil
Tags: woocommerce, facebook, social media, products, marketing
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 8.2
Requires Plugins: woocommerce
Stable tag: 1.1.19
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Publish WooCommerce products as native Facebook Page photo posts with editable text, prices, links and plan-based image galleries.

== Description ==

CatalogCast helps WooCommerce store managers prepare and publish product posts to a selected Facebook Page.

Each product is prepared as a separate post. Before publishing, you can review and edit the post text, promotional price, product link and selected images. CatalogCast also records publishing history and shows daily service usage.

Features include:

* Search products by name or exact SKU.
* Filter products by WooCommerce category and previous posting status.
* Preview each Facebook post before publishing.
* Select product-gallery or Media Library images within the active plan limit.
* Publish multiple products as separate native Facebook Page photo posts.
* Review publishing history and Facebook Post IDs.
* Export and import posted-product history.
* Prevent accidental reposts while still allowing confirmed reposting.
* Use the functional Free service plan or activate a paid CatalogCast service plan.

CatalogCast requires WooCommerce and a Facebook Page that you are authorized to manage. Public posts containing product links require a public HTTPS product URL.

== External services ==

CatalogCast uses external services only after an authorized administrator chooses to connect or use them.

= CatalogCast managed service =

The managed CatalogCast service at `https://connect.mileniumkg.com.mk` provides Facebook authorization, securely retains the selected Facebook Page token, publishes posts, enforces service-plan limits and manages optional paid service access.

All PHP and JavaScript functionality included in this plugin is available in the WordPress.org package. CatalogCast plans purchase capacity on the hosted service; they do not unlock hidden or restricted local plugin code. The ongoing Free service plan publishes real Facebook Page posts, has no expiry and is not a sandbox or time-limited trial. Paid plans increase hosted publishing, image and store capacity.

When you start the connection, the plugin sends the store URL, plugin version and WordPress timezone to the CatalogCast service. After connection, signed requests may contain a CatalogCast site identifier, selected connection identifier, local product reference, post text, optional product link, selected public image URLs and a unique publishing-request identifier. Usage and service-plan requests contain the site identifier and signed authentication metadata. A service access key is transmitted only when an administrator explicitly submits the service-plan activation form; it is not stored by this WordPress plugin.

The connection is initiated explicitly from CatalogCast > Facebook Connection. Disconnecting the Page stops managed publishing from that WordPress site.

* CatalogCast website: https://catalogcast.mileniumkg.com.mk/
* Privacy Policy: https://catalogcast.mileniumkg.com.mk/privacy.html
* Terms of Service: https://catalogcast.mileniumkg.com.mk/terms.html

= Dodo Payments =

When a connected administrator chooses to buy or upgrade a hosted CatalogCast plan, the CatalogCast service sends the selected product and return URL to Dodo Payments. For upgrades it also uses the existing Dodo customer ID and the eligible subscription payment. The buyer enters contact and payment details on Dodo's hosted checkout. The plugin does not receive card details. Dodo sends payment and subscription updates to the CatalogCast service for access activation, subscription management and email delivery of the service access key.

* Dodo Payments Privacy Policy: https://dodopayments.com/legal/privacy-policy
* Dodo Payments Buyer Terms: https://dodopayments.com/legal/buyer-terms

= Meta Platform =

The CatalogCast managed service uses the Meta Graph API to authorize a Facebook account, list manageable Pages and publish the post text, link and images selected by the administrator. In the optional legacy own-app mode, the WordPress site communicates with the Meta Graph API directly using credentials supplied by the administrator.

* Meta Privacy Policy: https://www.facebook.com/privacy/policy/
* Meta Terms: https://www.facebook.com/legal/terms

By choosing Connect Facebook and completing Meta authorization, the administrator consents to the service communication required for this functionality.

== Installation ==

1. Install and activate WooCommerce.
2. Install and activate CatalogCast.
3. Open CatalogCast > Facebook Connection.
4. Choose Connect Facebook, authorize Meta and select the correct Facebook Page.
5. Open CatalogCast > Service Plan to review the ongoing Free service plan or activate additional hosted-service capacity.
6. Open CatalogCast, select products, review each prepared post and publish.

== Frequently Asked Questions ==

= Is the Free plan functional? =

Yes. The Free plan can connect a store and publish within its displayed daily and image limits. Paid plans increase service limits.

= How many images can I publish? =

The current service limits are displayed inside the plugin. Free supports up to 1 image, Starter Boost up to 3, Pro up to 5 and Business up to 10 images per post.

= Can I publish an already posted product again? =

Yes. CatalogCast displays its previous status and requests confirmation before reposting.

= Does the Facebook promotional price change WooCommerce? =

No. It changes only the Facebook post caption. It does not modify the WooCommerce product or checkout price.

= Why does a product link fail on localhost? =

Facebook must be able to fetch a public HTTPS URL. Localhost can be used to test the interface but cannot be used as a public product link.

= Where are Facebook Page tokens stored? =

With the managed connection, the Page token stays on the CatalogCast service and is not returned to WordPress. The optional legacy own-app mode stores credentials encrypted on the WordPress site.

== Screenshots ==

1. Select WooCommerce products and review the daily publishing limit.
2. Prepare editable Facebook posts and select plan-limited images.
3. Preview the post before publishing.
4. Review the active plan, daily quota and image limit.
5. Check Facebook connection diagnostics and publishing history.

== Changelog ==

= 1.1.19 =

* Added hosted service checkout and plan upgrades in Service Plan.

= 1.1.16 =

* Added billing-owner confirmation for end-of-period cancellation and resuming renewal on supported subscriptions.

= 1.1.15 =

* Documented the five direct database operations required for the one-time settings and history migration.

= 1.1.14 =

* Import the previous Facebook connection, service plan and publishing history on upgrade. Preserve newer connections, post statuses and publishing preferences.

= 1.1.13 =

* Replaced legacy short identifiers with the unique CatalogCast prefix required by the WordPress.org Plugin Directory.
* Moved directory artwork out of the installable plugin package and into the WordPress.org directory assets folder.
* Corrected the contributor account to the submitting WordPress.org user.

= 1.1.12 =

* Assigned distinct plugin and author URLs for WordPress.org submission validation.
* Preserved the clarified hosted-service model and all existing publishing functionality.

= 1.1.11 =

* Clarified that CatalogCast plans purchase hosted-service capacity and do not unlock hidden local plugin code.
* Renamed customer-facing license terminology to Service Plan and Service access key for WordPress.org clarity.
* Preserved the ongoing, non-expiring Free service plan and all existing publishing functionality.

= 1.1.1 =

* Clarified safe prepared database queries for WordPress.org Plugin Check.
* Preserved the existing managed Facebook connection, publishing, licensing and history features.

= 1.1.0 =

* Added WordPress.org Plugin Check compliance improvements for nonce validation, input sanitization, translations and database queries.
* Prepared the separate WordPress.org distribution with standard WordPress.org-managed updates.
* Preserved the existing managed Facebook connection, publishing, licensing and history features.

= 1.0.4 =

* Prepared the plugin for WordPress.org distribution and WordPress.org-managed updates.
* Added transparent documentation for CatalogCast and Meta external services.
* Preserved the existing managed Facebook connection, publishing, licensing and history features.

= 1.0.3 =

* Added branded CatalogCast plugin assets and a Help & Support page.
* Added separate Settings and Facebook Connection screens.
* Added explained publishing defaults for links, descriptions, prices and image selection.

= 1.0.0 =

* Added secure CatalogCast licensing with plan-based daily post, store and image limits.
* Added native multi-photo Facebook Page publishing through the managed CatalogCast service.
* Added live Facebook post previews, exact SKU search and preserved posted-product visibility.

== Upgrade Notice ==

= 1.1.19 =

* Added hosted service checkout and plan upgrades in Service Plan.

= 1.1.16 =

Open the WordPress dashboard after updating to import settings and publishing history from earlier versions.
