From 7c853cf507fa206a0157d472b53baa44240d566e Mon Sep 17 00:00:00 2001 From: Tomas Odehnal <62995026+tomasodehnal@users.noreply.github.com> Date: Wed, 28 Jan 2026 07:31:19 +0000 Subject: Update the 'Refreshing feeds' documentation page (#8468) * Update the 'Refreshing feeds' page * add the 'user' parameter and clarify the 'token' parameter usage * remove old token screenshots, add a new one from profile page * update the authentication page screenshot * clarify the anonymous refreshing of the feeds * Add myself to CREDITS.md * Update Refresh feeds docs page content * Tweak the content headings to match the actual headings * Fix the link to Form authentication paragraph * PNG compress more (16 colours + OptiPNG) * Minor typography --------- Co-authored-by: Alexandre Alapetite --- CREDITS.md | 1 + docs/en/img/users/anonymous_access.1.png | Bin 28762 -> 8982 bytes docs/en/img/users/token.1.png | Bin 28656 -> 0 bytes docs/en/img/users/token.png | Bin 0 -> 14281 bytes docs/en/users/09_refreshing_feeds.md | 34 +++++++++++++++---------------- 5 files changed, 18 insertions(+), 17 deletions(-) delete mode 100644 docs/en/img/users/token.1.png create mode 100644 docs/en/img/users/token.png diff --git a/CREDITS.md b/CREDITS.md index 8c370aab8..da564c13d 100644 --- a/CREDITS.md +++ b/CREDITS.md @@ -291,6 +291,7 @@ People are sorted by name so please keep this order. * [ThomasSmallert](https://github.com/ThomasSmallert): [contributions](https://github.com/FreshRSS/FreshRSS/pulls?q=is:pr+author:ThomasSmallert) * [Ths2-9Y-LqJt6](https://github.com/Ths2-9Y-LqJt6): [contributions](https://github.com/FreshRSS/FreshRSS/pulls?q=is:pr+author:Ths2-9Y-LqJt6) * [Tibor Repček](https://github.com/tiborepcek): [contributions](https://github.com/FreshRSS/FreshRSS/pulls?q=is:pr+author:tiborepcek) +* [Tomáš Odehnal](https://github.com/tomasodehnal): [contributions](https://github.com/FreshRSS/FreshRSS/pulls?q=is:pr+author:tomasodehnal) * [tomgue](https://github.com/tomgue): [contributions](https://github.com/FreshRSS/FreshRSS/pulls?q=is:pr+author:tomgue) * [Tommaso Ferrari](https://github.com/raspo): [contributions](https://github.com/FreshRSS/FreshRSS/pulls?q=is:pr+author:raspo), [Web](https://tommasoferrari.com) * [tonitonae](https://github.com/tonitonae): [contributions](https://github.com/FreshRSS/FreshRSS/pulls?q=is:pr+author:tonitonae) diff --git a/docs/en/img/users/anonymous_access.1.png b/docs/en/img/users/anonymous_access.1.png index 58e4e113e..848c231cc 100644 Binary files a/docs/en/img/users/anonymous_access.1.png and b/docs/en/img/users/anonymous_access.1.png differ diff --git a/docs/en/img/users/token.1.png b/docs/en/img/users/token.1.png deleted file mode 100644 index 73ce65cf3..000000000 Binary files a/docs/en/img/users/token.1.png and /dev/null differ diff --git a/docs/en/img/users/token.png b/docs/en/img/users/token.png new file mode 100644 index 000000000..8c9d3c218 Binary files /dev/null and b/docs/en/img/users/token.png differ diff --git a/docs/en/users/09_refreshing_feeds.md b/docs/en/users/09_refreshing_feeds.md index 94b689b0d..a99d826c1 100644 --- a/docs/en/users/09_refreshing_feeds.md +++ b/docs/en/users/09_refreshing_feeds.md @@ -7,9 +7,9 @@ To take full advantage of FreshRSS, it needs to retrieve new items from the feed - [Partial update](#partial-update) - [Automatic update with cron](#automatic-update-with-cron) - [Online cron](#online-cron) - - [For Form Authentication](#for-form-authentication) + - [For Form Authentication (Web form)](#for-form-authentication-web-form) - [For HTTP authentication](#for-http-authentication) - - [For No authentication None](#for-no-authentication-none) + - [For No authentication (None)](#for-no-authentication-none) - [Feed configuration of “Do not automatically refresh more often than”](#feed-configuration-of-do-not-automatically-refresh-more-often-than) - [Background](#background) - [Default value](#default-value) @@ -59,33 +59,33 @@ To do so, you need to create a scheduled task, which need to call a specific URL Special parameters to configure the script - all parameters can be combined: - Parameter `ajax` - -Only a status site is returned and not a complete website. Example: "OK" + + Only a status site is returned and not a complete website. Example: "OK" - Parameter `maxFeeds` - -If *maxFeeds* is set the configured amount of feeds is refreshed at once. The default setting is `10`. + + If *maxFeeds* is set the configured amount of feeds is refreshed at once. The default setting is `10`. -- Parameter `token` - -Security parameter to prevent unauthorized refreshes. For detailed Documentation see "Form authentication". +- Parameters `user` and `token` + + Security parameters that allow a user to refresh their feed when *Web form* authentication is set. For detailed Documentation see “Form authentication” below. -### For Form Authentication +### For Form Authentication (Web form) -If your FreshRSS instance is using Form Authentication, you can configure an authentication token to grant access to the online cron. +If your FreshRSS instance is using Form Authentication, you can configure a *Master authentication token* in a user profile to grant access to the online cron. -![Token configuration](../img/users/token.1.png) +![Token configuration](../img/users/token.png) -You can target a specific user by adding their username to the query string, with `&user=insert-username`: +After setting the authentication token, use the `user` and `token` parameters to call the online cron script. For the above example, the syntax for the scheduled task will look as follows: -The scheduled task syntax should look as follows: + - - -Alternatively, but not recommended, if you configure the application to allow anonymous reading, you can also allow anonymous users to update feeds (“Allow anonymous refresh of the articles”), and that does not require a token. +Alternatively, but not recommended, you can also allow anonymous users to update feeds (*Allow anonymous refresh of the articles*), and that does not require a token. ![Anonymous access configuration](../img/users/anonymous_access.1.png) +This allows anyone to update the feeds of the default user’s subscriptions. + ### For HTTP authentication If your FreshRSS instance is using HTTP authentication, you’ll need to provide your credentials to the scheduled task. -- cgit v1.2.3