summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorfox <[email protected]>2019-11-14 04:15:19 +0000
committerfox <[email protected]>2019-11-14 04:15:19 +0000
commit69f57e75deb48e74f2d4f45af1c6056ab766a33f (patch)
tree3ebe6e3b142c96395876bdbe84aedb2f8b5876e9
parent2e3320e132debfcbc27ec351e6fd87e134a3fba5 (diff)
Update page 'FeedHandlerPlugins'
-rw-r--r--FeedHandlerPlugins.md14
1 files changed, 9 insertions, 5 deletions
diff --git a/FeedHandlerPlugins.md b/FeedHandlerPlugins.md
index e828ea6..3a135cc 100644
--- a/FeedHandlerPlugins.md
+++ b/FeedHandlerPlugins.md
@@ -1,12 +1,16 @@
-Some plugins utilize global per-feed content hooks which either mangle fetched feed XML content or even generate it entirely, for tt-rss to process.
+Some plugins utilize global per-feed content hooks which either modify fetched feed XML data (i.e. fixing broken XML) or even generate it entirely, for tt-rss to process, for websites that don't actually provide RSS feeds.
-This method of handling feed data entirely bypasses rate-limiting and article duplicate checking done during normal feed update process. A badly written plugin using <code>HOOK_FETCH_FEED</code> may cause your tt-rss feed to keep updating RSS feeds indefinitely, processing articles every time, causing unnecessary CPU load on your server.
+While having this ability available for plugins is valuable there are several downsides:
-If you have full text content plugins enabled, this may cause excessive load on origin server, because your tt-rss instance is going to scrape site content for every article on every feed update.
+1. This entirely bypasses rate-limiting and article duplicate checking done during normal feed update process. A badly written plugin using <code>HOOK_FETCH_FEED</code> may cause your tt-rss feed to keep updating feeds indefinitely, processing all articles every time, causing unnecessary CPU load on your server.
-This may result in your tt-rss instance being banned by origin servers for causing excessive load and/or your VDS being suspended for bad behavior.
+2. If you have full text content plugins enabled, this may cause excessive load on origin server, because your tt-rss instance is going to scrape site content for every provided article on every feed update.
-We recommend not using such plugins unless you have a strong need for them. If you do use them, please don't enable them for all feeds.
+This may result in your tt-rss instance being banned by origin servers for causing excessive load and/or your VDS being suspended for suspected bad behavior.
+
+Additionally, tt-rss being blacklisted by feed publishers may affect other users.
+
+**We recommend not using such plugins unless you have a strong need for them. If you do use them, at least don't enable them for all feeds**.
See also: