-
Notifications
You must be signed in to change notification settings - Fork 14
/
readme.txt
210 lines (137 loc) · 9.36 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
=== WP Telegram (Auto Post and Notifications) ===
Contributors: wpsocio, irshadahmad21
Donate link: https://wpsocio.com/donate
Tags: telegram, notifications, posts, channel, group
Requires at least: 6.4
Requires PHP: 7.4
Tested up to: 6.7
Stable tag: 4.2.5
License: GPL-3.0-or-later
License URI: https://www.gnu.org/licenses/gpl-3.0.html
Integrate your WordPress site perfectly with Telegram with full control.
== Description ==
Integrate your WordPress site perfectly with Telegram with full control.
== Modules ==
**1. Post to Telegram**
* 📝 Send posts automatically to Telegram when published or updated
* 📢 You can send to a Telegram Channel, Group, Supergroup or private chat
* 👥 Supports multiple Channels/chats
* 🙂 Has Message Template composer with Emojis
* ⏳ Supports Conditional logic inside Message Template
* 🖼 Supports sending featured image along with the text
* 🏞 You can choose to send only the Featured Image
* ⏱ Supports scheduled (future) posts
* 🕰 Messages can be delayed by a specific interval
* ⬜️ You can add an Inline button for the post URL
* 🛒 Supports WooCommerce products and other Custom Post Types
* ✒️ Direct Support for sending Custom Fields
* 🗃 You can send Custom Taxonomy Terms
* 📋 You can select the post types to be sent
* ⏲ You can choose when to send (New and/or existing posts)
* 🎛 Make use of Custom Rules to filter posts by authors, categories, tags, post formats or custom taxonomy terms
* 🎚 You can override the default settings on post edit page
[WP Telegram Pro](https://wptelegram.pro) supports multiple channels based upon category/tag/author/post type etc. and also supports unlimited Reaction buttons.
**2. Private Notifications**
* 📧 Get your email notifications on Telegram
* 🔔 Supports **WooCommerce** order notifications, **Contact Form 7** and other plugin notifications
* 🔕 Allow users to receive their email notifications on Telegram
* 🔐 Integrated with [WP Telegram Login](https://wordpress.org/plugins/wptelegram-login) to let users connect their Telegram.
* 🖊 Users can also enter their Telegram Chat ID manually on page
**3. Proxy**
* 🚫 If your host blocks Telegram, you can use this module
* ✅ Bypass the ban on Telegram by making use of proxy
* 🚀 Supports **Cloudflare worker as proxy** which supports file upload
* 😍 Option to use custom **Google Script as proxy**
* ❇️ Supports all proxies supported by PHP
* 🔛 You can select Proxy type - HTTP, SOCKS4, SOCKS4A, SOCKS5, SOCKS5_HOSTNAME
== Features ==
* **Excellent LIVE Support on Telegram**
* Easy to install and set up for the admin
* Fully customizable with actions and filters
* Can be extended with custom code
* Translation ready
= Getting Started | Post to Telegram =
https://www.youtube.com/watch?v=m48V-gWz9-o
= WooCommerce, CF7 etc. Notifications =
https://www.youtube.com/watch?v=gVJCtwkorMA
== Contribution ==
Development takes place in our [Github monorepo](https://github.com/wpsocio/wp-projects), and all contributions welcome.
== Excellent LIVE Support on Telegram ==
= Join the Chat =
We have a public group on Telegram to provide help setting up the plugin, discuss issues, features, translations etc. Join [@WPTelegramChat](https://t.me/WPTelegramChat)
For rules, see the pinned message. No spam please.
= Get in touch =
* Website [wpsocio.com](https://wpsocio.com)
* Telegram [@WPTelegram](https://t.me/WPTelegram)
* Facebook [@WPTelegram](https://fb.com/WPTelegram)
* Twitter [@WPTelegram](https://twitter.com/WPTelegram)
= Upgrade to Pro =
WP Telegram Pro comes with more powerful features to give you more control. [Upgrade NOW](https://wptelegram.pro)
== Frequently Asked Questions ==
= How to create a Telegram Bot? =
To create a bot, you need to send `/newbot` command to [@BotFather](https://t.me/BotFather). After completing the steps `@BotFather` will provide you the Bot Token, which you can use in plugin settings.
= Can I send posts to a private channel/group? =
Yes, you need to get the chat ID of the channel or group. For that, you need to message [@MyChatInfoBot](https://t.me/MyChatInfoBot) and follow its instructions to obtain the ID for a channel or group.
= What is "Bad request: Chat ID not found" error? =
It means either you have entered a wrong chat ID in the settings or you forgot to add your own bot to the group or channel. Some users also enter the bot username instead of the channel username.
= What is "Bad Request: wrong file identifier/HTTP URL specified" error? =
If you see that error in Bot API log file, it means that there is some problem with your images/files that you are trying to send to Telegram. You can try to disable **Send files by URL** option in **Advanced Settings** to see if it fixes the issue. More details [here](https://t.me/WPTelegram/187).
= Why do I see a CURL (Connection refused) error for Test Token? =
If your host is in Russia or Iran or it's a free hosting, your host most likely blocks Telegram. You can activate and set up the Proxy module of the plugin to bypass the ban.
= Why posts are not sent to Telegram? =
There can be many reasons for that. To better understand the reason, you can enable both the logs in **Advanced Settings** and then try to send the post again, then share the logs with our support on Telegram - [@WPTelegramSupport](https://t.me/WPTelegramSupport).
= Why the posts in block editor are sent to Telegram even when Send to Telegram is OFF? =
It may be because you hit update button without makes any changes to the post.
= Why posts are duplicated on Telegram? =
It can happen because of multiple submit/publish/update requests, for example in block editor. An easy solution would be to set 1 minute delay in posting in **Post to Telegram** settings.
= Posts/Classifieds/Jobs/Products created via front-end submission are not sent to Telegram, why? =
The users submitting those posts may not have enough permissions to publish/edit those posts. You can enable **Plugin generated posts** option in **Post to Telegram** settings to fix the issue.
= Posts created via import plugins are not sent to Telegram, why? =
Sending of posts when bulk importing is disabled by default to prevent unintended flooding of Telegram channels. If you want to enable it, you can add this one line to `functions.php` of your child theme.
~~~
add_filter( 'wptelegram_p2tg_send_if_importing', '__return_true' );
~~~
= How can I make the post title bold? =
You can use `<b>{post_title}</b>` in the template and set **Formatting** option to **HTML**. More details [here](https://core.telegram.org/bots/api#html-style).
= Can I send posts from different categories to different channels/groups? =
That is possible only in [Pro version](https://wptelegram.pro/).
= How do Private Notifications work? =
**Private Notifications** module watches every email that is sent from your WordPress Website. If the address of that email matches the one added in plugin settings, then that email is sent to Telegram on the given chat/group as added in the settings.
= How do User Notifications work? =
**Private Notifications** module watches every email that is sent from your WordPress Website. When you enable **User Notifications**, you need to connect your users' accounts to their Telegram accounts. Once you do that, then whenever an email is sent to a user, the plugin finds its connected Telegram account and forwards the email to that Telegram account. So, it works for any plugin/system that sends email notifications.
= Can I receive WooCommerce order notifications on Telegram? =
Yes, all you need to do is to setup **Private Notifications** module and use the same email there as set in **WooCommerce** order email settings.
= Can I receive Contact Form 7 submissions on Telegram? =
Yes, all you need to do is to setup **Private Notifications** module and use the same email there as set in "To" field of Mail settings section of the Contact Form.
== Screenshots ==
1. Basic Settings
2. Post To Telegram Settings
3. Post To Telegram Settings (Cont...)
4. Post To Telegram Settings (Cont...)
5. Post To Telegram Settings (Cont...)
6. Private Notifications Settings
7. Private Notifications Settings (Cont...)
8. Proxy Settings
9. Proxy Settings (Cont...)
10. Proxy Settings (Cont...)
11. Advanced Settings
12. Post Edit Page (Classic Editor)
13. Post Edit Page (Block Editor)
== Installation ==
= Automatic installation =
Automatic installation is the easiest way -- WordPress will handle the file transfer, and you won’t need to leave your web browser. To do an automatic install of the plugin:
* Log in to your WordPress dashboard
* Navigate to the Plugins menu, and click "Add New"
* In the search field type "wptelegram" and hit Enter
* Locate the plugin in the list of search results
* Click on "Install Now" and wait for the installation to complete
* Click on "Activate"
= Manual installation =
Manual installation method requires downloading the plugin and uploading it to your web server via your favorite FTP application. The official WordPress documentation contains [instructions on how to do this here](https://wordpress.org/support/article/managing-plugins/#manual-plugin-installation).
= Updating =
Automatic updates should work smoothly, but we still recommend you back up your site.
== Changelog ==
= 4.2.5 =
- Fixed chat ID validation preventing from saving changes
- Updated delay UI to show WP Cron warning as alert
[See full changelog](https://github.com/wpsocio/wptelegram/blob/main/CHANGELOG.md)