A production-grade WordPress plugin that posts to Telegram channels/chats when content changes. Features advanced templating, routing rules, async processing, and comprehensive admin interface.
- Telegram Integration: Send notifications to channels, groups, and private chats
- Advanced Templating: Customizable message templates with dynamic tokens
- Routing Rules: Route different content to different destinations based on categories, tags, or post types
- Async Processing: Non-blocking queue system using Action Scheduler
- Comprehensive Logging: Detailed logs with filtering and export capabilities
- Health Monitoring: Site Health integration for monitoring plugin status
- Modern Admin Interface: React-based admin interface with real-time testing and preview
- WooCommerce Support: Special support for product notifications and price changes
# 1) Install
npm install
composer install
# 2) Build
npm run build
# 3) Run tests
npm run testSee docs/installation.md for platform-specific steps.
Basic usage here. Advanced usage in docs/usage.md.
# Build production assets
npm run build
# Run tests
npm run test
npm run e2e
# Package plugin
npm run package- Minimal config in this README
- Full reference: docs/configuration.md
| Variable | Description | Default |
|---|---|---|
WPTPN_BOT_TOKEN |
Telegram bot token | — |
WPTPN_DESTINATIONS |
Array of destination chat IDs | [] |
WPTPN_TEMPLATE |
Message template with tokens | Default template |
- Start here: docs/examples/example-01.md
- More: docs/examples/
High-level overview: The plugin uses WordPress hooks to detect post changes, processes notifications asynchronously via Action Scheduler, and sends messages to Telegram using the Telegram Bot API. See docs/architecture.md.
Planned milestones live in ROADMAP.md. For changes, see CHANGELOG.md.
We welcome PRs! Please read CONTRIBUTING.md and follow the PR template.
Please report vulnerabilities via SECURITY.md.
This project is licensed under the MIT License - see the LICENSE file for details.