RingList for WooCommerce

RingList is SMS marketing with clean lists and prices shown before you send. This plugin connects your WooCommerce store to your RingList account:

• Every paying customer’s phone number is pushed to RingList automatically when their order is paid or completed.
• Numbers are validated and normalized by RingList — garbage never enters your list, and rejections are logged as order notes with the reason.
• An SMS opt-in checkbox is added to your checkout (recommended, CASL/TCPA friendly). You choose: only opted-in customers, or all paying customers.
• One-click import of your past customers.
• Store-wide default tag — your domain, out of the box and editable — so you always know which site a contact came from. Give specific products their own tags and those replace the default for that product. Tags accumulate across purchases, and WooCommerce’s own product tags are never touched.
• International-ready: billing country is used to send properly prefixed numbers to RingList’s per-country validation.
• Opt-outs are handled by RingList itself: when a customer replies STOP (or ARRÊT), they are unsubscribed permanently.

Your RingList plan’s contact limit applies to contacts added by this plugin.

External services

This plugin connects your store to RingList (https://ringlist.app), the SMS service it is built for. A RingList account and an API key are required; nothing is sent until you enter that key.

What is sent, and when:

• When an order reaches “processing” or “completed” — and, in checkbox consent mode, only if the customer ticked the SMS opt-in box — the plugin sends that customer’s billing phone number, first name, last name, the tags configured for the store or the purchased products, and the word “woocommerce” as the source, to https://ringlist.app/api/v1/contacts.
• The same data is sent for each past order you choose to push with the “Import past customers” button.
• When you click “Test connection”, only your API key is sent, to https://ringlist.app/api/v1/ping, to verify it and read back your account name and plan.

No data is sent on the front end of your site, and nothing is sent about visitors who do not place an order.

RingList is a service by Milotche Media. Its terms of service are available at https://ringlist.app/terms and its privacy policy at https://ringlist.app/privacy. Because you are sending your customers’ personal data to a third party, make sure your own privacy policy says so and that you have the consent required in your jurisdiction (CASL, TCPA, GDPR).

1. Upload and activate the plugin.
2. In RingList → Settings → API keys, create a key and copy it.
3. In WooCommerce → RingList SMS, paste the key and click “Test connection”.
4. Choose your consent mode. Done — new paid orders sync automatically.

1. 

   WooCommerce → RingList SMS: paste your API key, test the connection, set the tags every customer gets, and choose how consent is collected.

2. 

   The SMS opt-in checkbox on the checkout, right above the order button. Only customers who tick it are added — unless you switch to "all paying customers".

3. 

   Per-product RingList tags, in Product data → General. Left empty, buyers get the store default shown as a hint; type tags here and they replace it for this product.

4. 

   Every sync is written to the order as a note, with the normalized number RingList accepted — or the exact reason it was rejected. (Digits masked in this screenshot.)

1.2.1

• Admin JS and CSS are now enqueued from files (wp_enqueue_script / wp_enqueue_style) instead of printed inline.
• The “add your API key” reminder now appears only on the Plugins and WooCommerce screens, and can be dismissed permanently.

1.2.0

• Renamed the plugin folder and text domain to ringlist-for-woocommerce so translations can load. Sites running the 1.1.x zip must deactivate the old copy, install this one, then delete the old — settings are kept.
• “Test connection” now tests the key you just typed instead of the saved one — it no longer fails on a fresh install before you hit Save. On success with an unsaved key it points you at the Save button, and a notice reminds you that nothing syncs until the key is saved.
• Default RingList tags for the whole store (WooCommerce → RingList SMS), pre-filled with your domain and editable. Products without their own tags inherit it; a product’s own tags take priority and replace the default for that product.
• Contacts are no longer tagged “woocommerce” automatically — the store default tag replaces it. The order’s origin still travels to RingList in the API’s source field.
• Removed the “RingList URL” field from the settings screen: a typo there silently broke every sync. Developers can still point another instance with define( 'RINGLIST_API_URL', '…' ) in wp-config.php or the ringlist_api_url filter.

1.1.1

• Fix activation on WordPress multisite (removed the Requires Plugins header, which misbehaves when WooCommerce is active per-site; standards-compliant zip packaging).

1.1.0

• Per-product RingList tags (Product data > General): buyers get the product’s tags on their RingList contact. Tags accumulate across purchases instead of being replaced.

1.0.0

• Initial release: automatic order sync, checkout consent checkbox, past-customer import, connection test.