A free, self-hostable news aggregator…
Hook to modify the list of feeds to actualize (#8655)
pe1ucabca9a5586e8e
diff --git a/app/Controllers/feedController.php b/app/Controllers/feedController.phpindex f3a7edea3..234eb7635 100644--- a/app/Controllers/feedController.php+++ b/app/Controllers/feedController.php@@ -469,6 +469,13 @@ class FreshRSS_feed_Controller extends FreshRSS_ActionController {/** @var array<int,array<string,true>> */$categoriesEntriesTitle = [];+ $feeds = Minz_ExtensionManager::callHook(Minz_HookType::FeedsListBeforeActualize, $feeds);+ if (is_array($feeds)) {+ $feeds = array_filter($feeds, static fn($feed): bool => $feed instanceof FreshRSS_Feed);+ } else {+ $feeds = [];+ }+foreach ($feeds as $feed) {$feed = Minz_ExtensionManager::callHook(Minz_HookType::FeedBeforeActualize, $feed);if (!($feed instanceof FreshRSS_Feed)) {diff --git a/docs/en/developers/03_Backend/05_Extensions.md b/docs/en/developers/03_Backend/05_Extensions.mdindex 3773d9bf8..9488a4d48 100644--- a/docs/en/developers/03_Backend/05_Extensions.md+++ b/docs/en/developers/03_Backend/05_Extensions.md@@ -189,6 +189,7 @@ Example response for a `query_icon_info` request:* `Minz_HookType::EntryBeforeUpdate` (`function($entry) -> Entry | null`): will be executed when a feed is refreshed and just before an entry is updated in the database. Useful for reading the final state of the entry after filter actions have been applied. The updated entry (instance of FreshRSS\_Entry) will be passed as parameter.* `Minz_HookType::FeedBeforeActualize` (`function($feed) -> Feed | null`): will be executed when a feed is updated. The feed (instance of FreshRSS\_Feed) will be passed as parameter.* `Minz_HookType::FeedBeforeInsert` (`function($feed) -> Feed | null`): will be executed when a new feed is imported into the database. The new feed (instance of FreshRSS\_Feed) will be passed as parameter.+* `Minz_HookType::FeedsListBeforeActualize` (`function(array<FreshRSS_Feed> $feedList) -> array | null`): will be executed before FreshRSS tries to update feeds. The list of feeds (array of `FreshRSS_Feed`) to update will be passed as a parameter. Useful for modifying the order in which the feeds will be updated.* `Minz_HookType::FreshrssInit` (`function() -> none`): will be executed at the end of the initialization of FreshRSS, useful to initialize components or to do additional access checks.* `Minz_HookType::FreshrssUserMaintenance` (`function() -> none`): will be executed for each user during the `actualize_script`, useful to run some maintenance tasks on the user.* `Minz_HookType::JsVars` (`function($vars = array) -> array | null`): will be executed if the `jsonVars` in the header will be generated.diff --git a/docs/fr/developers/03_Backend/05_Extensions.md b/docs/fr/developers/03_Backend/05_Extensions.mdindex 69dbbf7ae..75140891e 100644--- a/docs/fr/developers/03_Backend/05_Extensions.md+++ b/docs/fr/developers/03_Backend/05_Extensions.md@@ -249,11 +249,14 @@ The following events are available:* `entries_favorite` (`function(array $ids, bool $is_favorite): void`):will be executed when some entries are marked or unmarked as favorites (starred)* `feed_before_actualize` (`function($feed) -> Feed | null`): will be- executed when a feed is updated. The feed (instance of FreshRSS\_Feed)+ executed when a feed is updated. The feed (instance of `FreshRSS_Feed`)will be passed as parameter.* `feed_before_insert` (`function($feed) -> Feed | null`): will be executedwhen a new feed is imported into the database. The new feed (instance ofFreshRSS\_Feed) will be passed as parameter.+* `feeds_list_before_actualize` (`function(array<FreshRSS_Feed> $feedList) -> array | null`) : exécuté avant que FreshRSS actualise les flux.+ La liste des flux (tableau de `FreshRSS_Feed`) à actualiser sera passé comme le paramètre.+ Utile pour modifier l’ordre dans lequel les flux seront mis à jour* `freshrss_init` (`function() -> none`): will be executed at the end of theinitialization of FreshRSS, useful to initialize components or to doadditional access checksdiff --git a/lib/Minz/HookType.php b/lib/Minz/HookType.phpindex fe95f6517..bdd43035c 100644--- a/lib/Minz/HookType.php+++ b/lib/Minz/HookType.php@@ -11,12 +11,13 @@ enum Minz_HookType: string {case EntriesFavorite = 'entries_favorite'; // function(array $ids, bool $is_favorite): voidcase EntryAutoRead = 'entry_auto_read'; // function(FreshRSS_Entry $entry, string $why): voidcase EntryAutoUnread = 'entry_auto_unread'; // function(FreshRSS_Entry $entry, string $why): void+ case EntryBeforeAdd = 'entry_before_add'; // function(FreshRSS_Entry $entry) -> FreshRSS_Entry | nullcase EntryBeforeDisplay = 'entry_before_display'; // function(FreshRSS_Entry $entry) -> FreshRSS_Entry | nullcase EntryBeforeInsert = 'entry_before_insert'; // function(FreshRSS_Entry $entry) -> FreshRSS_Entry | null- case EntryBeforeAdd = 'entry_before_add'; // function(FreshRSS_Entry $entry) -> FreshRSS_Entry | nullcase EntryBeforeUpdate = 'entry_before_update'; // function(FreshRSS_Entry $entry) -> FreshRSS_Entry | nullcase FeedBeforeActualize = 'feed_before_actualize'; // function(FreshRSS_Feed $feed) -> FreshRSS_Feed | nullcase FeedBeforeInsert = 'feed_before_insert'; // function(FreshRSS_Feed $feed) -> FreshRSS_Feed | null+ case FeedsListBeforeActualize = 'feeds_list_before_actualize'; // function(array $feedsList) -> arraycase FreshrssInit = 'freshrss_init'; // function() -> nonecase FreshrssUserMaintenance = 'freshrss_user_maintenance'; // function() -> nonecase JsVars = 'js_vars'; // function($vars = array) -> array | null@@ -45,16 +46,17 @@ enum Minz_HookType: string {case self::NavEntries:case self::NavMenu:return Minz_HookSignature::NoneToString;+ case self::ActionExecute:case self::CheckUrlBeforeAdd:+ case self::EntryBeforeAdd:case self::EntryBeforeDisplay:case self::EntryBeforeInsert:- case self::EntryBeforeAdd:case self::EntryBeforeUpdate:case self::FeedBeforeActualize:case self::FeedBeforeInsert:+ case self::FeedsListBeforeActualize:case self::JsVars:case self::NavReadingModes:- case self::ActionExecute:case self::ViewModes:return Minz_HookSignature::OneToOne;case self::CustomFaviconBtnUrl: