=== Notifications Telegram for WooCommerce ===
Contributors: krasdavid
Tags: telegram, notifications, orders, ecommerce, store alerts
Requires at least: 5.8
Tested up to: 6.8
Requires PHP: 7.2
Stable tag: 1.0.2
Requires Plugins: woocommerce
License: GPLv2 or later
Text Domain: notifications-telegram-for-woocommerce

Get instant Telegram notifications for WooCommerce orders. Real-time alerts with complete order details sent directly to your Telegram messenger.

== Description ==

**Notifications Telegram for WooCommerce** sends real-time order notifications directly to your Telegram messenger. Stay connected with your online store 24/7 and never miss an order again.

This plugin provides instant notifications for WooCommerce orders, helping you respond to customers faster, process orders efficiently, and manage your business on the go.

= Key Features =

* **Instant Notifications** - Receive order alerts in real-time on Telegram
* **Complete Order Details** - Get all order information in one message
* **Customizable Templates** - Format messages exactly how you want
* **Multiple Recipients** - Send notifications to personal chats or groups
* **Status Selection** - Choose which order statuses trigger notifications
* **Product Images** - Optionally include product images in notifications
* **Easy Setup** - Simple configuration with built-in connection testing
* **Secure** - Direct Telegram API integration without third-party services
* **Multilingual** - Available in English, Russian, Spanish, and French

= Perfect For =

* Store owners who want real-time order alerts
* Teams that need to share order information instantly
* Dropshippers requiring immediate order processing
* Multi-store operators managing several shops
* Anyone who wants to stay connected with their business

= Message Customization =

Customize your notification messages with these variables:
* Order details (number, status, date, total)
* Customer information (name, email, phone, address)
* Product list with quantities and prices
* Payment method
* Customer notes
* Direct admin links to orders

= Translations =

This plugin is available in the following languages:
* 🇬🇧 English (default)
* 🇷🇺 Russian (Русский)
* 🇪🇸 Spanish (Español)
* 🇫🇷 French (Français)

Want to translate this plugin to your language? Visit [translate.wordpress.org](https://translate.wordpress.org/projects/wp-plugins/notifications-telegram-for-woocommerce/) or contact us!

= Privacy & Security =

* No data collection or tracking
* Direct connection to Telegram API
* All data stays between your site and Telegram
* GDPR compliant

= Third Party Service =

This plugin uses the Telegram Bot API to send notifications. When you enable notifications, order data is sent to Telegram's servers for message delivery.

* Service: Telegram Bot API
* Purpose: Send order notifications to your Telegram account
* Data sent: Order details, customer information (as configured in templates)
* Privacy Policy: https://telegram.org/privacy
* Terms of Service: https://telegram.org/tos

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/notifications-telegram-for-woocommerce/`
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Create a Telegram bot using @BotFather
4. Configure the plugin at **Telegram Orders** menu with your bot token
5. Get your Chat ID and test the connection
6. Customize your message template and save

= Quick Setup Guide =

1. Open Telegram and search for @BotFather
2. Send `/newbot` command and follow instructions
3. Copy the bot token
4. Find your Chat ID using @getmyid_bot
5. Enter credentials in plugin settings
6. Test connection and start receiving notifications!

== Frequently Asked Questions ==

= Does this plugin work with WooCommerce? =

Yes, this plugin is specifically designed for WooCommerce and requires it to function. The plugin will check for WooCommerce on activation.

= How do I create a Telegram bot? =

Open Telegram, search for @BotFather, send the `/newbot` command, and follow the instructions. You'll receive a bot token to use in the plugin settings.

= How do I find my Chat ID? =

The easiest way is to message @getmyid_bot on Telegram. It will reply with your Chat ID. You can also use the "Get My Chat ID" button in the plugin settings after configuring your bot token.

= Can I send notifications to a group? =

Yes! Add your bot to a Telegram group, then use @getmyid_bot in that group to get the Group Chat ID. Enter this ID in the plugin settings.

= Can I customize the notification message? =

Absolutely! The plugin includes a template editor where you can customize the message format using variables for order details, customer info, and more.

= Which order statuses can trigger notifications? =

You can select any combination of WooCommerce order statuses. Common choices are Processing (new orders), Completed, Cancelled, and Refunded.

= Is this plugin free? =

Yes, this plugin is completely free with no premium version or hidden costs.

= Why don't I see the plugin in my language? =

The plugin includes translations for Russian, Spanish, and French. To see the plugin in your language:
1. Go to Settings → General in your WordPress admin
2. Change "Site Language" to your preferred language
3. Save changes

If translations still don't appear, try clearing your browser cache and deactivating/reactivating the plugin.

== Screenshots ==

1. Main settings page with bot configuration
2. Message template customization
3. Example notification in Telegram
4. Quick setup guide

== Changelog ==

= 1.0.2 =
* Added plugin icon (128x128) and banner (772x250) for WordPress.org repository
* Improved visual design and user interface
* Fixed display issues in settings page
* Enhanced code documentation

= 1.0.1 =
* Added multilingual support with complete translations
* Added translations: Russian (Русский), Spanish (Español), French (Français) 
* Improved code structure for better maintainability
* Fixed minor display issues in settings page
* Added language information to readme
* Updated plugin description with translation details

= 1.0.0 =
* Initial release
* Core notification functionality
* Customizable message templates
* Multi-status support
* Product image support
* Connection testing tools

== Upgrade Notice ==

= 1.0.1 =
This update adds multilingual support (Russian, Spanish, French), improves the user interface, and adds plugin branding assets. Recommended update for all users.