=== Telegram & WhatsApp Share Buttons ===
Contributors: snehalpancholi
Tags: telegram share, whatsapp share, social sharing, share buttons, messaging
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add Telegram and WhatsApp share buttons to posts — no external scripts, no API keys needed.

== Description ==

Telegram & WhatsApp Share Buttons inserts one-click share links for Telegram and WhatsApp on any post type. Both networks support direct share URLs that open in the native app on mobile or in the desktop clients, so there is no SDK, no external script, and no API key required.

**Features:**

* Telegram (`t.me/share/url`) and WhatsApp (`api.whatsapp.com/send`) share links
* Auto-insert before content, after content, or both
* `[tws_share]` shortcode for manual placement
* Three button styles: icon + text, icon only, text only
* Fully custom colours and border radius
* Configurable share message with `{title}` and `{url}` tokens
* Custom button labels
* Alignment control: left, center, right
* Per post-type enable/disable

== Installation ==

1. Upload the `telegram-whatsapp-share` folder to `/wp-content/plugins/`
2. Activate through **Plugins > Installed Plugins**
3. Go to **Settings > TG & WA Share** to configure appearance and placement
4. Use `[tws_share]` anywhere for manual placement

== Frequently Asked Questions ==

= Does this require API keys or a bot? =
No. Share links open the standard WhatsApp and Telegram share UIs — no server-side API calls.

= Do WhatsApp links work on desktop? =
Yes. WhatsApp Desktop and the web app (`web.whatsapp.com`) both handle `api.whatsapp.com/send` links.

= Can I show only one of the two buttons? =
Yes — uncheck the network you don't need in **Settings > TG & WA Share > Networks**.

== Changelog ==

= 1.0.0 =
* Initial release.

== Screenshots ==

1. Icon + text style buttons below a post.
2. Icon-only variant with custom colours.
3. Settings page.
