diff options
Diffstat (limited to 'Feed-Handler-Plugins.md')
| -rw-r--r-- | Feed-Handler-Plugins.md | 60 |
1 files changed, 30 insertions, 30 deletions
diff --git a/Feed-Handler-Plugins.md b/Feed-Handler-Plugins.md index 789a5ef..61fe15b 100644 --- a/Feed-Handler-Plugins.md +++ b/Feed-Handler-Plugins.md @@ -1,30 +1,30 @@ -# Feed handler plugins
-
-!!! warning
-
- Unless you have a strong need for these plugins, using them is not recommended. If
- you do use them, at least don't enable them for all feeds.
-
-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.
-
-While having this ability available for plugins is valuable there are several
-downsides:
-
-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.
-
-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.
-
-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 negatively affect
-other users.
+# Feed handler plugins + +[!WARNING] + + Unless you have a strong need for these plugins, using them is not recommended. If + you do use them, at least don't enable them for all feeds. + +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. + +While having this ability available for plugins is valuable there are several +downsides: + +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. + +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. + +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 negatively affect +other users. |