-
-
Notifications
You must be signed in to change notification settings - Fork 11
/
readme.txt
156 lines (94 loc) · 4.87 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
=== WebSub (FKA. PubSubHubbub) ===
Contributors: pfefferle, joshfraz, indieweb
Donate link: https://notiz.blog/donate/
Author: PubSubHubbub Team
Author URI: https://github.com/pubsubhubbub/wordpress-pubsubhubbub
Tags: websub, pubsub, indieweb, ostatus, rss
License: MIT
License URI: http://opensource.org/licenses/MIT
Requires at least: 4.5
Tested up to: 6.6
Stable tag: 3.2.1
A better way to tell the world when your blog is updated.
== Description ==
This plugin is a simple way to let people know in real-time when your blog is updated. PubSubHubbub/WebSub is widely adopted and is used by Google Alerts and many other services. Subscription requests are relayed through hubs, which validate and verify the request. Hubs then distribute new and updated content to subscribers when it becomes available.
This plugin:
* Sends realtime notifications when you update your blog
* Supports multi-user installations (Wordpress MU)
* Supports multiple hubs
* Supports all of the feed formats used by WordPress, not just ATOM and RSS2
* Supports latest specs
* PubSubHubbub [Version 0.4](https://pubsubhubbub.github.io/PubSubHubbub/pubsubhubbub-core-0.4.html)
* WebSub [W3C Version](https://www.w3.org/TR/websub/)
* Announces which hubs you are using by adding `<link rel="hub" ...>` declarations to your template header and Atom feed
By default this plugin will ping the following hubs:
* [Demo hub on Google App Engine](https://pubsubhubbub.appspot.com "Demo hub on Google App Engine")
* [SuperFeedr](https://pubsubhubbub.superfeedr.com "SuperFeedr")
* [WebSubHub](https://websubhub.com "WebSubHub")
Please contact me if you operate a hub that you would like to be included as a default option.
== Installation ==
1. Upload the `pubsubhubub` directory to your `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Select custom hubs under your WebSub/PubSubHubbub Settings (optional)
== Frequently Asked Questions ==
= What is WebSub? =
WebSub provides a common mechanism for communication between publishers of any kind of Web content and their subscribers, based on HTTP web hooks. Subscription requests are relayed through hubs, which validate and verify the request. Hubs then distribute new and updated content to subscribers when it becomes available. WebSub was previously known as PubSubHubbub.
= Where can I learn more about the WebSub protocol? =
* [W3C Spec](https://www.w3.org/TR/websub/ "W3C Spec")
* [WebSub on Github](https://github.com/w3c/websub "WebSub on Github")
* [WebSub.rocks - a WebSub validator](https://websub.rocks/ "WebSub.rocks")
= Where can I learn more about the PubSubHubbub protocol? =
* [PubSubHubbub on Github](https://github.com/pubsubhubbub "PubSubHubbub on Github")
* [Latest Spec (0.4)](http://pubsubhubbub.github.io/PubSubHubbub/pubsubhubbub-core-0.4.html)
= What is a Hub? =
A WebSub Hub is an implementation that handles subscription requests and distributes the content to subscribers when the corresponding topic URL has been updated. Hubs MUST support subscription requests with a secret and deliver authenticated requests when requested. Hubs MUST deliver the full contents of the topic URL in the request, and MAY reduce the payload to a diff if the content type supports it.
= What is a Publisher? =
A WebSub Publisher is an implementation that advertises a topic and hub URL on one or more resource URLs.
= What is a Subscriber? =
A WebSub Subscriber is an implementation that discovers the hub and topic URL given a resource URL, subscribes to updates at the hub, and accepts content distribution requests from the hub. The subscriber MAY support authenticated content distribution.
== Screenshots ==
1. The WebSub Settings page allows you to define which hubs you want to use
== Changelog ==
Project maintained on github at [pubsubhubbub/wordpress-pubsubhubbub](https://github.com/pubsubhubbub/wordpress-pubsubhubbub).
= 3.2.1 =
* fix: empty option on fresh install leads to broken feed links
= 3.2.0 =
* improved validating, sanitizing, and escaping
* simplified code
= 3.1.4 =
* add Content-Type header to WebSub requests
= 3.1.3 =
* update configuration files, fix typos, update dependencies
= 3.1.2 =
* add new WebSub Hub
= 3.1.1 =
* fix deprecation issue (PHP8)
* add `_deprecated_function` warnings
= 3.1.0 =
* update wording (more consequent use of WebSub)
* add category-, tag- and author-feeds support
= 3.0.3 =
* update dependencies
= 3.0.2 =
* better `self-link` generator
= 3.0.1 =
* add donation button
= 3.0.0 =
* optimized the DB load
* added help section
* better code encapsulation
= 2.2.2 =
* temporarily remove comment-feed support to be more GDPR compliant
= 2.2.1 =
* display topic URLs on the settings page
= 2.2.0 =
* fixed a discovery bug
* changed http client
= 2.1.0 =
* save pinged URLs to add correct headers
= 2.0.0 =
* Complete rewrite
* Support WebSub
= 1.0.0 =
* First attempt
== Upgrade Notice ==