=== WP Telegram Chat Widget ===
Contributors: ninjateam
Tags: telegram, telegram chat, woocommerce, click to chat, social
Requires at least: 3.0
Tested up to: 7.0
Stable tag: 1.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Add a Telegram chat button to your website. Quick, easy, no coding needed.

== Description ==

The Telegram floating widget lets you place a persistent chat button on any page of your WordPress site, so visitors can reach you on Telegram in one click. 

Whether you're [building a WooCommerce store](https://wpbrandy.com/starter-sites/), a blog, or a business site, you can display the widget and button in various shapes and styles to fit your purposes.

**What you can do with it:**

- Connect one or multiple Telegram accounts (agents, channels, or bots) so visitors can choose who to contact
- Customize the widget text, label, colors, and position to match your brand
- Set a response time message so visitors know what to expect
- Control where the widget appears using Display Settings: site-wide or on specific pages only

**Who it's for:**

If you use Telegram as your main support or sales channel and want to make it easier for website visitors to reach you, this plugin gets it done in minutes.

**Getting started:**

1. Go to **Telegram → All Accounts** and add your Telegram username or channel
2. Head to **Floating Widget → Design** to customize how the button looks
3. Check **Display Settings** to control where it appears on your site
4. Save and visit your site. Your widget is now live!

###⚡️ FEATURES

**Telegram Floating Widget**
Connect instantly with your audience and grow your Telegram community faster with built-in elements:

- Agent/Community name
- Agent title
- Custom color & greetings
- Set pre-filled message with dynamic shortcodes
- Custom availability & working hours
- Avatar from the [WordPress media library](https://ninjateam.org/how-to-organize-your-wordpress-media-library/)

**WooCommerce Telegram Button**
Add "Order on Telegram" button on WooCommerce product pages.

- Choose a specific agent/expert for products
- Display WooCommerce Telegram button after "Add to cart"
- Display before "Add to cart", after long description or short description

**In-post/page Telegram Button with shortcode**

- Unlimited display
- Choose a specific agent/expert to fit page/post content
- Optimize audience engagement
- Need to enable bookings or appointments? You can combine it with Bookster, [appointment scheduling system on WordPress](https://wpbookster.com/)

### WHY USE TELEGRAM FOR WORDPRESS?

**Multiple Agent Accounts**
The Telegram Chat plugin lets you add multiple team members’ accounts to display in a single Telegram box, making it easy for customers to reach the right person.

**Easy to Customize**
Match your website's style effortlessly by picking custom colors. You can also tailor each agent's profile with specific working hours, daily schedules, avatars, name tags, and job titles.

**Supports WPML and Multilingual Sites**
Running a multilingual website? No problem! The Telegram Chat plugin is fully compatible with popular translation tools like WPML and Polylang.

**Shortcodes for Flexibility**
Use built-in shortcodes to place the Telegram widget wherever you need it. On pages, posts, sidebars, widgets, or any other element your website builder supports.

**No Coding Required**
We’ve designed a user-friendly interface so you can set everything up without technical skills. Simply activate the plugin, add your Telegram phone numbers, customize the options, and you’re ready to go! 

While you're at it, be sure to explore [FileBird Cloud](https://ninjateam.org/downloads/filebird-cloud-integration-dropbox-and-google-drive/) - a useful addon to expand your collaboration and community!

###🚀 HOW IT WORKS

After activating, you can add your Telegram account number for the floating widget. This is where your visitors can reach you and see multiple Telegram accounts of your store assistants/agents ready with his/her own name, title, avatar and greetings.

The visitor also knows when you/your agents back to work in the exact **remaining amount of hours and minutes** that they have to wait. This is the unique feature of Telegram thanks to its compatibility with all cache plugins:

- W3 Total Cache
- WP Super Cache
- Cache Enabler
- WP Rocket
- Comet Cache
- WP Fastest Cache
- Hyper Cache

== Installation ==
Manual installation is easy and takes fewer than one minute.

1. Download the plugin from wordpress.org, unpack it and upload the <strong>[Telegram]</strong> folder to your <strong>wp-content/plugins/</strong> directory.
2. Activate the plugin through the ‘Plugins‘ menu in WordPress.
3. Go to your main <strong>WordPress menu > Telegram</strong> to add a new Telegram account.
4. Go to Floating Widget to select the Telegram profile to display on your website.

Done! Happy chatting!
Enjoy conversations with your customers anytime & anywhere! It's never been easier to capture your potential leads!

== Frequently Asked Questions ==
= Is this WordPress Telegram plugin GDPR-compliant? = 
Definitely yes! You can enable built-in GDPR cookie notice checkbox so that the visitors have to tick to agree with your terms and conditions before sending messages. It also works with [cookie consent](https://wordpress.org/plugins/ninja-gdpr-compliance/).

= Does it work with multi-language site? =
Yes, You can use translation plugins like WPML to translate any languages on your site easily and quickly.

= I have some issues. How can I find help? =
Check out our [tutorial](https://ninjateam.org/wordpress-Telegram-chat-tutorial/) to see all the setup guide. 
Wanna get in touch? Drop us an email or message [here](https://ninjateam.org/support/).

== Screenshots ==
1. Customize Telegram floating widget in WordPress admin dashboard

== Changelog ==

= May 29, 2025 - Version 1.2 =
- Fixed: Stored Cross-Site Scripting via Username Parameter

= Dec 18, 2024 - Version 1.1 =
- Fixed: Security (Stored Cross-Site Scripting)

= May 28, 2023 - Version 1.0 =
- Initial Release