# VW Order Notify for Telegram

![Plugin Icon](https://ps.w.org/vw-order-notify-for-telegram/assets/icon-128x128.png?rev=3592184)

Sends real-time WooCommerce order notifications to a Telegram channel/group with order details.

## Description

VW Order Notify for Telegram is a WordPress plugin that integrates WooCommerce with Telegram, allowing store owners to receive instant order notifications directly in their Telegram channel or group.

### Features

- **Real-time Notifications**: Get instant alerts when new orders are placed
- **Customizable Messages**: Use placeholders to customize your notification template
- **Easy Setup**: Simple configuration with Bot Token and Chat ID
- **Test Functionality**: Send test messages to verify your setup
- **Multiple Triggers**: Choose when to receive notifications (new order, processing status)
- **Mobile Responsive**: Admin settings page works perfectly on all devices

## Installation

1. Upload the `vw-order-notify-for-telegram` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to **VW Order Notify** in the admin menu to configure the plugin

## Configuration

### Step 1: Create a Telegram Bot

1. Open Telegram and search for [@BotFather](https://t.me/BotFather)
2. Send `/newbot` command
3. Follow the instructions to create your bot
4. Copy the API token provided

### Step 2: Get Your Chat ID

1. Create a Telegram channel or group
2. Add your bot as an administrator
3. Get the chat ID (for channels, it starts with `-100`)

### Step 3: Configure the Plugin

1. Navigate to **VW Order Notify** in your WordPress admin
2. Enable the plugin
3. Paste your Bot Token
4. Paste your Chat ID
5. Customize the message template if needed
6. Click **Send Test Message** to verify
7. Save your settings

## Available Placeholders

Use these placeholders in your message template:

| Placeholder | Description |
|-------------|-------------|
| `{order_id}` | The order ID number |
| `{customer_name}` | Customer's full name |
| `{phone}` | Customer's phone number |
| `{total}` | Order total amount |
| `{currency}` | Currency symbol |
| `{product_list}` | List of ordered products |
| `{payment_method}` | Payment method used |

## Frequently Asked Questions

### How do I get my Telegram Chat ID?

For channels, add your bot as an admin, then forward a message from the channel to [@userinfobot](https://t.me/userinfobot) to get the ID. Channel IDs typically start with `-100`.

### Can I customize the notification message?

Yes! The plugin includes a message template editor with support for Markdown formatting and various placeholders.

### Does this work with all payment gateways?

Yes, the plugin hooks into WooCommerce's order system and works with any payment gateway.

## Changelog

### 1.0.0
- Initial release
- Real-time order notifications
- Customizable message templates
- Test message functionality
- Mobile responsive admin interface

## Credits

- **Plugin Name**: VW Order Notify for Telegram
- **Plugin URI**: https://vendweave.com/vw-order-notify-for-telegram
- **Author**: VendWeave, WebExpert Rabbi
- **Author URI**: https://vendweave.com

## License

This plugin is licensed under the GPL v2 or later.

```
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
```