summaryrefslogtreecommitdiff
path: root/Feed-Handler-Plugins.md
diff options
context:
space:
mode:
authorsupahgreg <supahgreg@users.noreply.github.com>2025-10-05 19:53:08 +0000
committersupahgreg <supahgreg@users.noreply.github.com>2025-10-05 19:53:08 +0000
commit987e283677bde3d3f5926655a4673fb38961d08b (patch)
treea28b99f9cabe226b8ebff43e52f71cc8cf3f5141 /Feed-Handler-Plugins.md
parent978c6fafdef0f6efd70f57cb1e86bd0a662188fd (diff)
Switch to GitHub format for alerts/notifications.
Diffstat (limited to 'Feed-Handler-Plugins.md')
-rw-r--r--Feed-Handler-Plugins.md60
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.