=== HopMembers for WooCommerce ===
Contributors: hopmembers
Tags: woocommerce, membership, discord, telegram, whatsapp
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically grant Discord, Telegram, or WhatsApp community access after WooCommerce purchases via HopMembers.

== Description ==

HopMembers for WooCommerce is a connector plugin for the HopMembers service. After a customer pays for a WooCommerce product, HopMembers can automatically grant (or revoke) access to your Discord, Telegram, or WhatsApp community.

This plugin does not process payments itself. WooCommerce remains your checkout. HopMembers is the membership and community-access layer.

= What this plugin does =

* Connects your WooCommerce store to your HopMembers account with a one-time connect code
* Registers WooCommerce webhooks so paid and refunded orders are sent to HopMembers
* Lets HopMembers list your products so you can map them to community channels
* Removes the connection and webhooks when you disconnect or uninstall the plugin

= External service =

This plugin requires a [HopMembers](https://hopmembers.com) account. Connecting the plugin sends data from your WordPress site to HopMembers so access can be provisioned after purchase.

When you click Connect, the plugin sends your connect code, site URL, and site name to HopMembers over HTTPS (`https://hopmembers.com/api/apps/woocommerce/plugin/connect`).

After you connect, WooCommerce delivers order webhooks (create, update, delete, and status changes such as processing, completed, cancelled, and refunded) to HopMembers (`https://hopmembers.com/api/webhooks/woocommerce`). HopMembers also requests your product catalog from this site using a store-specific access token.

A HopMembers account is required. HopMembers is a paid service for creators; see pricing on the HopMembers site. All plugin code in this directory is available under GPLv2 or later.

* Service: [https://hopmembers.com](https://hopmembers.com)
* Terms of Service: [https://hopmembers.com/terms-of-service](https://hopmembers.com/terms-of-service)
* Privacy Policy: [https://hopmembers.com/privacy-policy](https://hopmembers.com/privacy-policy)

= Data sent to HopMembers =

* Site URL and site name, used to identify the store
* The one-time connect code you paste from HopMembers
* WooCommerce order payloads via webhooks (order id, status, line items, customer fields WooCommerce includes in webhooks)
* Product id, name, status, and variation details when HopMembers loads your catalog

No data is sent until a store administrator with WooCommerce management capability connects the plugin. Disconnecting or uninstalling the plugin stops webhooks and tells HopMembers to drop the store connection.

== Installation ==

1. Install and activate WooCommerce.
2. Upload the `hopmembers-for-woocommerce` folder to `/wp-content/plugins/`, or install the zip from Plugins → Add New → Upload Plugin.
3. Activate HopMembers for WooCommerce.
4. In HopMembers, open Apps → WooCommerce and generate a connect code.
5. In WordPress, go to WooCommerce → HopMembers, paste the code, and click Connect.
6. Return to HopMembers and map products to Discord, Telegram, or WhatsApp channels.

== Frequently Asked Questions ==

= Do I need a HopMembers account? =

Yes. This plugin only connects WooCommerce to HopMembers. Create an account at [hopmembers.com](https://hopmembers.com) first.

= What data leaves my WordPress site? =

After you connect, HopMembers receives your site URL, site name, product catalog, and WooCommerce order webhook payloads so it can grant or revoke community access. See the Description section and the [HopMembers Privacy Policy](https://hopmembers.com/privacy-policy).

= Can I change the HopMembers server URL? =

No. There is no setting for this, and the plugin always talks to https://hopmembers.com. Developers running HopMembers locally can override the origin with the `hopmembers_for_woocommerce_api_base` filter. Overrides must use HTTPS unless the `hopmembers_for_woocommerce_allow_url` filter also explicitly permits the URL, which exists only for local development.

= What happens if I deactivate the plugin? =

Deactivating the plugin does not disconnect your store. Use the Disconnect button on WooCommerce → HopMembers, or uninstall the plugin, to remove webhooks and credentials.

= Does this work with High-Performance Order Storage (HPOS)? =

Yes. The plugin uses WooCommerce APIs and webhooks rather than direct order post meta.

= Where do I get support? =

Support is provided through HopMembers. Email info@hopmembers.com or use the contact options on [hopmembers.com](https://hopmembers.com).

== Changelog ==

= 1.0.0 =
* Initial release.
