Files
FreshRSS/config-user.default.php
i @man 2188070aa6 Add option to keep or reset article sort order when navigating (#8969)
* Add option to keep or reset article sort order when navigating

Adds a new per-user reading option, "Keep the current sort order when
navigating between categories and feeds" (config key: sticky_sort), under
Settings > Reading > "Left navigation: Categories". It defaults to enabled,
which reproduces the current behaviour exactly.

Background (addresses #8953)
----------------------------
Once a sort/order was active in one view, it was propagated to every sidebar
link and to the "mark all as read" redirect. Opening another category then
ignored that category's own defaultSort/defaultOrder, because FreshRSS_Context
only applies those defaults when sort/order are absent from the request. As a
result the current view's sort (whether chosen manually or resolved from that
view's default) "bled" into the next category/feed.

Behaviour of the new option
---------------------------
- ON (default): unchanged. The current sort/order stays sticky while
  navigating, exactly as before.
- OFF: sidebar links and the "mark all as read" redirect no longer carry
  sort/order, so each target resolves its own order in FreshRSS_Context:
  feed/category defaultSort/defaultOrder, falling back to the global Reading
  sort criterion when none is configured.

order/sort propagation across the UI (for reference)
----------------------------------------------------
- Categories & feeds (sidebar): now gated by sticky_sort (app/layout/aside_feed.phtml).
- "Mark all as read" -> next category, both the top navigation button and the
  stream-footer button: now gated by sticky_sort
  (app/Controllers/entryController.php::readAction, non-AJAX redirect).
- Custom user queries: unaffected. A query's link is a self-contained URL built
  from that query's own saved parameters, so switching query A -> B never
  carried A's sort; no option is needed there.
- Stream transition links when sorting by category/feed name: intentionally
  left unchanged (out of scope; the sort is intrinsic to that grouping).

Compatibility
-------------
- Not a breaking change: the default (true) reproduces the previous behaviour.
- No database migration. The setting is a standard user configuration value
  with its default declared in config-user.default.php, so existing users keep
  the previous behaviour transparently.
- The read/unread state filter still persists across navigation regardless of
  this option.

i18n
----
English strings authored; en-US marked as IGNORE. Translations for the other
25 languages were produced with an automated (AI) translation service and
should be reviewed by native speakers.

* Update app/i18n/en/conf.php

Co-authored-by: Frans de Jonge <fransdejonge@gmail.com>

* Comments preference

* Update app/i18n/en/conf.php

Co-authored-by: Frans de Jonge <fransdejonge@gmail.com>

* i18n updates and comment

* Update translations to match reworded sticky_sort strings

Re-applies the 24 non-English/French translations of the "sticky_sort"
reading option after the English and French wording was updated to
"Keep manual sort order during navigation".

* improve Dutch

* i18n DIRTY

* i18n en: custom sort order

---------

Co-authored-by: Alexandre Alapetite <alexandre@alapetite.fr>
Co-authored-by: Frans de Jonge <fransdejonge@gmail.com>
2026-07-07 11:04:31 +02:00

152 lines
4.5 KiB
PHP

<?php
# Do not modify this file, which defines default values, but create a
# `./data/config-user.custom.php` file instead, containing the keys you want to
# override.
return array (
'enabled' => true,
'is_admin' => false,
'language' => 'en',
// A timezone identifier such as 'Europe/Paris' https://php.net/timezones or blank for server default
'timezone' => '',
'archiving' => [
'keep_period' => 'P3M',
'keep_max' => 200,
'keep_min' => 50,
'keep_favourites' => true,
'keep_labels' => true,
'keep_unreads' => false,
],
'ttl_default' => 3600,
'dynamic_opml_ttl_default' => 43200,
'mail_login' => '',
'email_validation_token' => '',
'token' => '',
'passwordHash' => '',
'apiPasswordHash' => '',
//feverKey is md5($user . ':' . $apiPasswordPlain)
'feverKey' => '',
'posts_per_page' => 20,
'since_hours_posts_per_rss' => 168,
'max_posts_per_rss' => 400,
'view_mode' => 'normal',
'default_view' => 'adaptive',
'default_state' => FreshRSS_Entry::STATE_NOT_READ,
'show_fav_unread' => false,
'show_title_unread' => true,
# Unread-count visibility in sidebar: 'all' | 'important' | 'none'
'show_unread_count' => 'all',
'auto_load_more' => true,
'display_posts' => false,
'display_categories' => 'active', //{ active, remember, all, none }
'show_tags' => 'f', // {0 => none, b => both, f => footer, h => header}
'show_tags_max' => 7,
'show_author_date' => 'h', // {0 => none, b => both, f => footer, h => header}
'show_feed_name' => 'a', // {0 => none, a => with authors, t => above title}
'show_article_icons' => 't', // {a => with_authors, t => above title}
'hide_read_feeds' => true,
'onread_jump_next' => true,
'lazyload' => true,
'sides_close_article' => false,
'sticky_post' => true,
'reading_confirm' => false,
'auto_remove_article' => false,
# In the case an article has changed (e.g. updated content):
# Set to `true` to mark it unread, or `false` to leave it as-is.
'mark_updated_article_unread' => false, //TODO: -1 => ignore, 0 => update, 1 => update and mark as unread
# 'id'|'c.name'|'date'|'f.name'|'length'|'link'|'rand'|'title'
'sort' => 'id',
'sort_order' => 'DESC',
# 'id'|'date'|'link'|'title'
'secondary_sort' => 'id',
'secondary_sort_order' => 'DESC',
# To carry the manual sort/order over to the next navigation
'sticky_sort' => true,
'anon_access' => false,
'mark_when' => array (
'article' => true,
'gone' => false,
'max_n_unread' => false,
'reception' => false,
'same_title_in_feed' => false,
'scroll' => false,
'focus' => false,
'site' => true,
),
'filters' => [],
'theme' => 'Origine',
'darkMode' => 'auto',
'content_width' => 'thin',
'shortcuts' => array (
'actualize' => 'q',
'mark_read' => 'r',
'mark_favorite' => 'f',
'go_website' => 'space',
'next_entry' => 'j',
'next_unread_entry' => 'h',
'prev_entry' => 'k',
'skip_next_entry' => 'n',
'skip_prev_entry' => 'p',
'first_entry' => 'home',
'last_entry' => 'end',
'collapse_entry' => 'c',
'load_more' => 'm',
'mylabels' => 'l',
'auto_share' => 's',
'focus_search' => 'a',
'user_filter' => 'u',
'help' => 'f1',
'close_menus' => 'escape',
'normal_view' => '1',
'global_view' => '2',
'reading_view' => '3',
'toggle_media' => 'v',
'toggle_aside' => 't',
),
# Disabling favicons and using emojis instead of icons improves performance for users with many feeds
'show_favicons' => true,
'icons_as_emojis' => false,
# Hide the dropdown configuration menu and favicon in the aside list in case of many feeds, for UI performance
'simplify_over_n_feeds' => 1000,
'mark_read_button' => 'big',
'topline_read' => true,
'topline_favorite' => true,
'topline_myLabels' => false,
'topline_sharing' => false,
'topline_website' => 'full',
'topline_thumbnail' => 'none',
'topline_summary' => false,
'topline_display_authors' => false,
'topline_date' => true,
'topline_link' => true,
'bottomline_read' => true,
'bottomline_favorite' => true,
'bottomline_sharing' => true,
'bottomline_tags' => true,
'bottomline_myLabels' => true,
'bottomline_date' => true,
'bottomline_link' => true,
'sharing' => array (
),
'queries' => array (
),
'html5_notif_timeout' => 0,
'html5_enable_notif' => true,
'good_notification_timeout' => 3,
'bad_notification_timeout' => 8,
'show_nav_buttons' => true,
'sidebar_hidden_by_default' => false,
# List of enabled FreshRSS extensions.
'extensions_enabled' => [],
# Privacy settings
'retrieve_extension_list' => true,
'send_referrer_allowlist' => [],
# Extensions configurations
'extensions' => [],
);