WooCommerce Telegram Order Notifier

=== WooCommerce Telegram Order Notifier === Contributors: mitroliti Tags: woocommerce, telegram, notifications, orders, bot Requires at least: 6.0 Tested up to: 6.7 Requires PHP: 7.4 Stable tag: 1.0.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

Sends instant WooCommerce order notifications to a Telegram chat or channel via Telegram Bot API.

== Description ==

WooCommerce Telegram Order Notifier sends detailed order notifications to your Telegram chat or channel every time an order status changes in WooCommerce.

= Features =

• Instant Telegram notifications when an order status changes
• Fully customizable message template with placeholders
• Choose which order statuses trigger a notification
• Test button to verify your bot token and chat ID are correct
• Lightweight — uses WordPress native wp_remote_post(), no extra libraries
• Non-blocking: if Telegram is unreachable, the order is still placed successfully
• Compatible with WooCommerce HPOS (High-Performance Order Storage)

= Available Placeholders =

Use these placeholders in your message template:

• {order_id} — Order number
• {order_date} — Order date and time
• {order_url} — Link to the order in the WordPress admin
• {status} — Human-readable order status
• {total} — Order total amount
• {customer_name} — Customer first and last name
• {customer_phone} — Customer phone number
• {customer_email} — Customer email address
• {payment_method} — Payment method title
• {shipping_method} — Shipping method name
• {shipping_address} — Formatted shipping address
• {items} — List of ordered products (name × qty = price)

== Installation ==

1. Upload the wc-telegram-notifier folder to the /wp-content/plugins/ directory, or install the plugin directly through the WordPress admin panel.
2. Activate the plugin through the Plugins menu in WordPress.
3. Go to WooCommerce → Telegram Notifications to configure the plugin.

= Quick Setup =

1. Create a Telegram bot via @BotFather (send /newbot and follow the instructions).
2. Copy the Bot Token provided by BotFather and paste it into the plugin settings.
3. Get your Chat ID: add the bot to your chat or send it /start, then open https://api.telegram.org/bot<TOKEN>/getUpdates in your browser and find the "id" field inside "chat".
4. Select the order statuses that should trigger a notification.
5. Customize the message template if needed.
6. Click Send Test Message to verify everything works.

== Frequently Asked Questions ==

= Does the plugin slow down the checkout process? =

No. The notification is sent via a non-blocking HTTP request with a 5-second timeout. If Telegram's API is temporarily unavailable, the order is still created normally and the error is written to the server log.

= Can I send notifications to a Telegram channel? =

Yes. Add your bot as an administrator of the channel, then enter the channel username in the format @channel_name or use the numeric channel ID (starting with -100).

= Which order statuses can trigger notifications? =

All WooCommerce order statuses are available: pending, processing, on-hold, completed, cancelled, refunded, failed, and any custom statuses added by other plugins.

= How do I find my Chat ID? =

For a private chat or group: add your bot, send any message, then open: https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates Look for "chat" → "id" in the JSON response.

For a public channel, simply use @channel_username.

= Is the Bot Token stored securely? =

The token is stored in the WordPress options table (same as other plugin settings). The field uses type="password" in the admin UI and the value is sanitized before saving. We recommend keeping your WordPress installation up to date and using a dedicated bot for notifications only.

= Does it support WooCommerce HPOS? =

Yes. The plugin declares full compatibility with WooCommerce High-Performance Order Storage (custom order tables).

== Screenshots ==

1. Plugin settings page — Bot Token, Chat ID, trigger statuses and message template.
2. Example of a Telegram notification message.

== Changelog ==

= 1.0.0 =

• Initial release.

== Upgrade Notice ==

= 1.0.0 = Initial release of WooCommerce Telegram Order Notifier.