From b3bf95bfddf557c204362553bf3b324e43575039 Mon Sep 17 00:00:00 2001
From: csisoap <33269526+csisoap@users.noreply.github.com>
Date: Wed, 12 Jul 2023 04:17:38 +0700
Subject: [PATCH 001/716] Replace token for Twitter. (#3522)

---
 lib/TwitterClient.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/TwitterClient.php b/lib/TwitterClient.php
index 605c27ff..18e8d02a 100644
--- a/lib/TwitterClient.php
+++ b/lib/TwitterClient.php
@@ -11,7 +11,7 @@ class TwitterClient
     public function __construct(CacheInterface $cache)
     {
         $this->cache = $cache;
-        $this->authorization = 'AAAAAAAAAAAAAAAAAAAAANRILgAAAAAAnNwIzUejRCOuH5E6I8xnZz4puTs%3D1Zv7ttfk8LF81IUq16cHjhLTvJu4FA33AGWWjCpTnA';
+        $this->authorization = 'AAAAAAAAAAAAAAAAAAAAAGHtAgAAAAAA%2Bx7ILXNILCqkSGIzy6faIHZ9s3Q%3DQy97w6SIrzE7lQwPJEYQBsArEE2fC25caFwRBvAGi456G09vGR';
         $this->data = $cache->loadData() ?? [];
     }
 

From 69aa751f40960bd49060b7bb4696116b182bdc85 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 11 Jul 2023 23:26:22 +0200
Subject: [PATCH 002/716] fix(cache): bug in prior refactor (#3525)

* fix(cache): bug in prior refactor

* yup
---
 lib/TwitterClient.php | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/lib/TwitterClient.php b/lib/TwitterClient.php
index 18e8d02a..cdedcbc1 100644
--- a/lib/TwitterClient.php
+++ b/lib/TwitterClient.php
@@ -12,7 +12,7 @@ class TwitterClient
     {
         $this->cache = $cache;
         $this->authorization = 'AAAAAAAAAAAAAAAAAAAAAGHtAgAAAAAA%2Bx7ILXNILCqkSGIzy6faIHZ9s3Q%3DQy97w6SIrzE7lQwPJEYQBsArEE2fC25caFwRBvAGi456G09vGR';
-        $this->data = $cache->loadData() ?? [];
+        $this->data = $this->cache->loadData() ?? [];
     }
 
     public function fetchUserTweets(string $screenName): \stdClass
@@ -95,6 +95,9 @@ class TwitterClient
         $response = getContents($url, $this->createHttpHeaders(), [CURLOPT_POST => true]);
         $guest_token = json_decode($response)->guest_token;
         $this->data['guest_token'] = $guest_token;
+
+        $this->cache->setScope('twitter');
+        $this->cache->setKey(['cache']);
         $this->cache->saveData($this->data);
         Logger::info("Fetch new guest token: $guest_token");
     }
@@ -119,6 +122,9 @@ class TwitterClient
         }
         $userInfo = $response->data->user;
         $this->data[$screenName] = $userInfo;
+
+        $this->cache->setScope('twitter');
+        $this->cache->setKey(['cache']);
         $this->cache->saveData($this->data);
         return $userInfo;
     }

From 0f2b55fbef10fd3cda7498441c81e27b0518e4f8 Mon Sep 17 00:00:00 2001
From: Fake4d <Fake4d@users.noreply.github.com>
Date: Wed, 12 Jul 2023 11:56:07 +0200
Subject: [PATCH 003/716] Update Configuration.php - Old Version Date in new
 Release (#3526)

Old Version Date in new Release
---
 lib/Configuration.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/Configuration.php b/lib/Configuration.php
index b6b2e4d6..57a7db7e 100644
--- a/lib/Configuration.php
+++ b/lib/Configuration.php
@@ -19,7 +19,7 @@
  */
 final class Configuration
 {
-    private const VERSION = 'dev.2023-03-22';
+    private const VERSION = 'dev.2023-07-11';
 
     private static $config = [];
 

From b9102d7e87726ca42659ff70e62ed6320b2657fb Mon Sep 17 00:00:00 2001
From: Jisagi <Jisagi@users.noreply.github.com>
Date: Thu, 13 Jul 2023 17:23:12 +0200
Subject: [PATCH 004/716] Add Steam Group Announcements Bridge (#3527)

* Create SteamGroupAnnouncementsBridge.php

* Shorten implementation

Maybe this fixes the tests

* test

---------

Co-authored-by: Dag <me@dvikan.no>
---
 bridges/SteamGroupAnnouncementsBridge.php | 25 +++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 bridges/SteamGroupAnnouncementsBridge.php

diff --git a/bridges/SteamGroupAnnouncementsBridge.php b/bridges/SteamGroupAnnouncementsBridge.php
new file mode 100644
index 00000000..2b848850
--- /dev/null
+++ b/bridges/SteamGroupAnnouncementsBridge.php
@@ -0,0 +1,25 @@
+<?php
+
+class SteamGroupAnnouncementsBridge extends FeedExpander
+{
+    const MAINTAINER = 'Jisagi';
+    const NAME = 'Steam Group Announcements';
+    const URI = 'https://steamcommunity.com/';
+    const DESCRIPTION = 'Returns latest announcements from a steam group.';
+
+    const PARAMETERS = [
+        [
+            'g' => [
+                'name' => 'Group name',
+                'exampleValue' => 'freegamesfinders',
+                'required' => true
+            ]
+        ]
+    ];
+
+    public function collectData()
+    {
+        $uri = self::URI . 'groups/' . $this->getInput('g') . '/rss';
+        $this->collectExpandableDatas($uri, 10);
+    }
+}

From a234392f801451f104edbe940c36fe2749757be6 Mon Sep 17 00:00:00 2001
From: alexvong243f <alexvong.n6215@simplelogin.com>
Date: Fri, 14 Jul 2023 03:15:49 +0000
Subject: [PATCH 005/716] docs: improve discoverability of instagram related
 bridges (#3528)

---
 bridges/PicnobBridge.php             | 2 +-
 bridges/PicukiBridge.php             | 2 +-
 docs/10_Bridge_Specific/Instagram.md | 2 ++
 3 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/bridges/PicnobBridge.php b/bridges/PicnobBridge.php
index 68241a8c..1d7d06b4 100644
--- a/bridges/PicnobBridge.php
+++ b/bridges/PicnobBridge.php
@@ -6,7 +6,7 @@ class PicnobBridge extends BridgeAbstract
         const NAME = 'Picnob Bridge';
         const URI = 'https://www.picnob.com/';
         const CACHE_TIMEOUT = 3600; // 1h
-        const DESCRIPTION = 'Returns Picnob posts by user or by hashtag';
+        const DESCRIPTION = 'Returns Picnob (Instagram viewer) posts by user or by hashtag';
 
         const PARAMETERS = [
                 'Username' => [
diff --git a/bridges/PicukiBridge.php b/bridges/PicukiBridge.php
index e90177ed..7a4f9eb5 100644
--- a/bridges/PicukiBridge.php
+++ b/bridges/PicukiBridge.php
@@ -6,7 +6,7 @@ class PicukiBridge extends BridgeAbstract
     const NAME = 'Picuki Bridge';
     const URI = 'https://www.picuki.com/';
     const CACHE_TIMEOUT = 3600; // 1h
-    const DESCRIPTION = 'Returns Picuki posts by user and by hashtag';
+    const DESCRIPTION = 'Returns Picuki (Instagram viewer) posts by user and by hashtag';
 
     const PARAMETERS = [
         'Username' => [
diff --git a/docs/10_Bridge_Specific/Instagram.md b/docs/10_Bridge_Specific/Instagram.md
index 7b9bf6b2..85e7b8a8 100644
--- a/docs/10_Bridge_Specific/Instagram.md
+++ b/docs/10_Bridge_Specific/Instagram.md
@@ -4,6 +4,8 @@ InstagramBridge
 To somehow bypass the [rate limiting issue](https://github.com/RSS-Bridge/rss-bridge/issues/1891)
 it is suggested to deploy a private RSS-Bridge instance that uses a working Instagram account.
 
+**NOTE**: There exists alternative bridges (e.g. PicukiBridge and PicnobBridge) for viewing posts without a working account.
+
 Configuration
 -------------
 

From 9efdf24a6ed4c96a03d4aeb8684d5b082627057c Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Fri, 14 Jul 2023 22:09:45 +0200
Subject: [PATCH 006/716] Add CustomBridge (#3457)

* Add CustomBridge

For advanced users. Create RSS feed using HTML selectors.

* [CssSelectorBridge] Refactor, Allow Unexpanded

Rename bridge to CssSelectorBridge
Allow unexpanded feed, i.e. make feed from home page only (1 request)
Refactor bridge to put most of the code into protected functions
Makes the code more maintainable and allows inheritance for variants

* [CssSelectorBridge] Fix linting
---
 bridges/CssSelectorBridge.php | 208 ++++++++++++++++++++++++++++++++++
 1 file changed, 208 insertions(+)
 create mode 100644 bridges/CssSelectorBridge.php

diff --git a/bridges/CssSelectorBridge.php b/bridges/CssSelectorBridge.php
new file mode 100644
index 00000000..ae135113
--- /dev/null
+++ b/bridges/CssSelectorBridge.php
@@ -0,0 +1,208 @@
+<?php
+
+class CssSelectorBridge extends BridgeAbstract
+{
+    const MAINTAINER = 'ORelio';
+    const NAME = 'CSS Selector Bridge';
+    const URI = 'https://github.com/RSS-Bridge/rss-bridge/';
+    const DESCRIPTION = 'Convert any site to RSS feed using CSS selectors (Advanced Users)';
+    const PARAMETERS = [
+        [
+            'home_page' => [
+                'name' => 'Site URL: Home page with latest articles',
+                'exampleValue' => 'https://example.com/blog/',
+                'required' => true
+            ],
+            'url_selector' => [
+                'name' => 'Selector for article links or their parent elements',
+                'exampleValue' => 'a.article',
+                'required' => true
+            ],
+            'url_pattern' => [
+                'name' => '[Optional] Pattern for site URLs to keep in feed',
+                'exampleValue' => 'https://example.com/article/.*',
+            ],
+            'content_selector' => [
+                'name' => '[Optional] Selector to extract each article content',
+                'exampleValue' => 'article.content',
+            ],
+            'content_cleanup' => [
+                'name' => '[Optional] Content cleanup: List of items to remove',
+                'exampleValue' => 'div.ads, div.comments',
+            ],
+            'title_cleanup' => [
+                'name' => '[Optional] Text to remove from expanded article title',
+                'exampleValue' => ' | BlogName',
+            ],
+            'limit' => self::LIMIT
+        ]
+    ];
+
+    private $feedName = '';
+
+    public function getURI()
+    {
+        $url = $this->getInput('home_page');
+        if (empty($url)) {
+            $url = parent::getURI();
+        }
+        return $url;
+    }
+
+    public function getName()
+    {
+        if (!empty($this->feedName)) {
+            return $this->feedName;
+        }
+        return parent::getName();
+    }
+
+    public function collectData()
+    {
+        $url = $this->getInput('home_page');
+        $url_selector = $this->getInput('url_selector');
+        $url_pattern = $this->getInput('url_pattern');
+        $content_selector = $this->getInput('content_selector');
+        $content_cleanup = $this->getInput('content_cleanup');
+        $title_cleanup = $this->getInput('title_cleanup');
+        $limit = $this->getInput('limit') ?? 10;
+
+        $html = defaultLinkTo(getSimpleHTMLDOM($url), $url);
+        $this->feedName = $this->getPageTitle($html, $title_cleanup);
+        $items = $this->htmlFindLinks($html, $url_selector, $url_pattern, $limit);
+
+        if (empty($content_selector)) {
+            $this->items = $items;
+        } else {
+            foreach ($items as $item) {
+                $this->items[] = $this->expandEntryWithSelector(
+                    $item['uri'],
+                    $content_selector,
+                    $content_cleanup,
+                    $title_cleanup
+                );
+            }
+        }
+    }
+
+    /**
+     * Filter a list of URLs using a pattern and limit
+     * @param array $links List of URLs
+     * @param string $url_pattern Pattern to look for in URLs
+     * @param int $limit Optional maximum amount of URLs to return
+     * @return array Array of URLs
+     */
+    protected function filterUrlList($links, $url_pattern, $limit = 0)
+    {
+        if (!empty($url_pattern)) {
+            $url_pattern = '/' . str_replace('/', '\/', $url_pattern) . '/';
+            $links = array_filter($links, function ($url) {
+                return preg_match($url_pattern, $url) === 1;
+            });
+        }
+
+        if ($limit > 0 && count($links) > $limit) {
+            $links = array_slice($links, 0, $limit);
+        }
+
+        return $links;
+    }
+
+    /**
+     * Retrieve title from webpage URL or DOM
+     * @param string|object $page URL or DOM to retrieve title from
+     * @param string $title_cleanup optional string to remove from webpage title, e.g. " | BlogName"
+     * @return string Webpage title
+     */
+    protected function getPageTitle($page, $title_cleanup = null)
+    {
+        if (is_string($page)) {
+            $page = getSimpleHTMLDOMCached($page);
+        }
+        $title = html_entity_decode($page->find('title', 0)->plaintext);
+        if (!empty($title)) {
+            $title = trim(str_replace($title_cleanup, '', $title));
+        }
+        return $title;
+    }
+
+    /**
+     * Retrieve first N links from webpage URL or DOM satisfying the specified criteria
+     * @param string|object $page URL or DOM to retrieve links from
+     * @param string $url_selector DOM selector for matching links or their parent element
+     * @param string $url_pattern Optional filter to keep only links matching the pattern
+     * @param int $limit Optional maximum amount of URLs to return
+     * @return array of minimal feed items {'uri': entry_url, 'title', entry_title}
+     */
+    protected function htmlFindLinks($page, $url_selector, $url_pattern = '', $limit = 0)
+    {
+        $links = $page->find($url_selector);
+
+        if (empty($links)) {
+            returnClientError('No results for URL selector');
+        }
+
+        $link_to_title = [];
+        foreach ($links as $link) {
+            if ($link->tag != 'a') {
+                $link = $link->find('a', 0);
+            }
+            $link_to_title[$link->href] = $link->plaintext;
+        }
+
+        $links = $this->filterUrlList(array_keys($link_to_title), $url_pattern, $limit);
+
+        if (empty($links)) {
+            returnClientError('No results for URL pattern');
+        }
+
+        $items = [];
+        foreach ($links as $link) {
+            $item = [];
+            $item['uri'] = $link;
+            $item['title'] = $link_to_title[$link];
+            $items[] = $item;
+        }
+
+        return $items;
+    }
+
+    /**
+     * Retrieve article content from its URL using content selector and return a feed item
+     * @param string $entry_url URL to retrieve article from
+     * @param string $content_selector HTML selector for extracting content, e.g. "article.content"
+     * @param string $content_cleanup Optional selector for removing elements, e.g. "div.ads, div.comments"
+     * @param string $title_cleanup Optional string to remove from article title, e.g. " | BlogName"
+     * @return array Entry data: uri, title, content
+     */
+    protected function expandEntryWithSelector($entry_url, $content_selector, $content_cleanup = null, $title_cleanup = null)
+    {
+        if (empty($content_selector)) {
+            returnClientError('Please specify a content selector');
+        }
+
+        $entry_html = getSimpleHTMLDOMCached($entry_url);
+        $article_content = $entry_html->find($content_selector);
+
+        if (!empty($article_content)) {
+            $article_content = $article_content[0];
+        } else {
+            returnClientError('Could not find content selector at URL: ' . $entry_url);
+        }
+
+        if (!empty($content_cleanup)) {
+            foreach ($article_content->find($content_cleanup) as $item_to_clean) {
+                $item_to_clean->outertext = '';
+            }
+        }
+
+        $article_content = convertLazyLoading($article_content);
+        $article_content = defaultLinkTo($article_content, $entry_url);
+
+        $item = [];
+        $item['uri'] = $entry_url;
+        $item['title'] = $this->getPageTitle($entry_html, $title_cleanup);
+        $item['content'] = $article_content;
+        return $item;
+    }
+}

From ea0456ea08b86c3d9bd6b79ddcb48d8faf47b805 Mon Sep 17 00:00:00 2001
From: Ryan Stafford <ryan@nanorex.net>
Date: Fri, 14 Jul 2023 23:58:57 -0400
Subject: [PATCH 007/716] [New Bridge] Qwantz bridge (#3531)

* [QwantzBridge] new bridge

* [QwantzBridge] title fix

* lint fixes
---
 bridges/QwantzBridge.php | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 bridges/QwantzBridge.php

diff --git a/bridges/QwantzBridge.php b/bridges/QwantzBridge.php
new file mode 100644
index 00000000..e48e948a
--- /dev/null
+++ b/bridges/QwantzBridge.php
@@ -0,0 +1,37 @@
+<?php
+
+class QwantzBridge extends FeedExpander
+{
+    const NAME           = 'Dinosaur Comics';
+    const URI            = 'https://qwantz.com/';
+    const DESCRIPTION    = 'Latest comic.';
+
+    protected function parseItem($feedItem)
+    {
+        $item = parent::parseItem($feedItem);
+        $item['author'] = 'Ryan North';
+
+        preg_match('/title="(.*?)"/', $item['content'], $matches);
+        $title = $matches[1];
+
+        $content = str_get_html(html_entity_decode($item['content']));
+        $comicURL = $content->find('img')[0]->{'src'};
+        $subject = $content->find('a')[1]->{'href'};
+        $subject = urldecode(substr($subject, strpos($subject, 'subject') + 8));
+        $p = (string)$content->find('P')[0];
+
+        $item['content'] = "{$subject}<figure><img src=\"{$comicURL}\"><figcaption><p>{$title}</p></figcaption></figure>{$p}";
+
+        return $item;
+    }
+
+    public function collectData()
+    {
+        $this->collectExpandableDatas(self::URI . 'rssfeed.php');
+    }
+
+    public function getIcon()
+    {
+        return self::URI . 'favicon.ico';
+    }
+}

From 73d88dda46b0f6748bfaa795b177aae2a4cbf900 Mon Sep 17 00:00:00 2001
From: Ryan Stafford <ryan@nanorex.net>
Date: Sat, 15 Jul 2023 00:11:00 -0400
Subject: [PATCH 008/716] [New Bridge] Strava bridge (#3533)

* [StravaBridge] new bridge

* [StravaBridge] gpx link, detect parameters
---
 bridges/StravaBridge.php | 81 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 81 insertions(+)
 create mode 100644 bridges/StravaBridge.php

diff --git a/bridges/StravaBridge.php b/bridges/StravaBridge.php
new file mode 100644
index 00000000..da1739cb
--- /dev/null
+++ b/bridges/StravaBridge.php
@@ -0,0 +1,81 @@
+<?php
+
+class StravaBridge extends BridgeAbstract
+{
+    const NAME = 'Strava Bridge';
+    const DESCRIPTION = "Returns an athlete's recent activities";
+    const URI = 'https://www.strava.com';
+    const PARAMETERS = [
+        [
+            'athleteID' => [
+                'name' => 'athleteID',
+                'required' => true
+            ]
+        ],
+    ];
+
+    public function detectParameters($url)
+    {
+        if (preg_match('/strava\.com\/athletes\/([\d]+)/', $url, $matches) > 0) {
+            return [
+                'athleteID' => $matches[1]
+            ];
+        }
+        return null;
+    }
+
+    public function collectData()
+    {
+        $athleteID = $this->getInput('athleteID');
+
+        $dom = getSimpleHTMLDOM(self::URI . '/athletes/' . $athleteID);
+        $scriptRegex = "/data-react-props='(.*?)'/";
+        preg_match($scriptRegex, $dom, $matches) or returnServerError('Could not find json');
+        $jsonData = json_decode(html_entity_decode($matches[1]));
+        $this->feedName = $jsonData->athlete->name . "'s Recent Activities";
+        $this->iconURL = $jsonData->athlete->avatarUrl;
+        foreach ($jsonData->recentActivities as $activity) {
+            $item = [];
+
+            $item['title'] = $activity->name . ' (' . $activity->detailedType . ')';
+            $item['author'] = $jsonData->athlete->name;
+            $item['uri'] = self::URI . '/activities/' . $activity->id;
+            $item['timestamp'] = $activity->startDateLocal;
+
+            $content = '<b>Distance:</b> ' . $activity->distance .
+                       '<br><b>Elev Gain:</b> ' . $activity->elevation .
+                       '<br><b>Time:</b> ' . $activity->movingTime . '<br><br>';
+
+            foreach ($activity->images as $image) {
+                $src = $image->squareSrc;
+                if (empty($src)) {
+                    $src = $image->defaultSrc;
+                }
+                $content .= '<img src="' . $src . '">';
+            }
+            $item['content'] = $content;
+
+            $item['enclosures'][] = $item['uri'] . '/export_gpx';
+
+            $this->items[] = $item;
+        }
+    }
+
+    public function getName()
+    {
+        if (empty($this->feedName)) {
+            return parent::getName();
+        } else {
+            return $this->feedName;
+        }
+    }
+
+    public function getIcon()
+    {
+        if (empty($this->iconURL)) {
+            return parent::getIcon();
+        } else {
+            return $this->iconURL;
+        }
+    }
+}

From c8039d483bb9f0690a4f9aef6700483c055aef22 Mon Sep 17 00:00:00 2001
From: Ryan Stafford <ryan@nanorex.net>
Date: Sat, 15 Jul 2023 09:12:11 -0400
Subject: [PATCH 009/716] [TraktBridge] new bridge (#3534)

---
 bridges/TraktBridge.php | 70 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 bridges/TraktBridge.php

diff --git a/bridges/TraktBridge.php b/bridges/TraktBridge.php
new file mode 100644
index 00000000..7aa90dfd
--- /dev/null
+++ b/bridges/TraktBridge.php
@@ -0,0 +1,70 @@
+<?php
+
+class TraktBridge extends BridgeAbstract
+{
+    const NAME = 'Trakt Bridge';
+    const DESCRIPTION = "Returns a user's watch history";
+    const URI = 'https://www.trakt.tv';
+
+    const PARAMETERS = [
+        [
+            'username' => [
+                'name' => 'username',
+                'required' => true
+            ],
+            'hide_shows' => [
+                'name' => 'Hide shows',
+                'type' => 'checkbox',
+                'title' => 'Hide shows',
+            ],
+
+        ],
+    ];
+
+    public function detectParameters($url)
+    {
+        if (preg_match('/trakt\.tv\/users\/(.*?)\//', $url, $matches) > 0) {
+            return [
+                'username' => $matches[1]
+            ];
+        }
+        return null;
+    }
+
+    public function collectData()
+    {
+        $username = $this->getInput('username');
+        $dom = getSimpleHTMLDOMCached(self::URI . '/users/' . $username . '/history');
+        $this->feedName = $dom->find('#avatar-wrapper h1 a', 0)->plaintext;
+        $this->iconURL = $dom->find('img.avatar', 0)->{'src'};
+
+        foreach ($dom->find('#history-items .posters', 0)->find('div.grid-item') as $div) {
+            if ($this->getInput('hide_shows') && $div->{'data-type'} != 'movie') {
+                continue;
+            }
+            $item = [];
+            $item['author'] = $this->feedName;
+            $item['title'] = $div->find('img.real', 0)->{'title'};
+            $item['timestamp'] = $div->find('.format-date', 0)->plaintext;
+            $item['content'] = '<img src="' . $div->find('img.real', 0)->{'data-original'} . '">';
+            $item['uri'] = self::URI . $div->{'data-url'};
+            $this->items[] = $item;
+        }
+    }
+    public function getName()
+    {
+        if (empty($this->feedName)) {
+            return parent::getName();
+        } else {
+            return $this->feedName;
+        }
+    }
+    public function getIcon()
+    {
+        if (empty($this->iconURL)) {
+            return parent::getIcon();
+        } else {
+            return $this->iconURL;
+        }
+    }
+}

From e5729fdaacb7fc18c3590c406cc3c50eaa0222c8 Mon Sep 17 00:00:00 2001
From: Thomas <mightymt@users.noreply.github.com>
Date: Sat, 15 Jul 2023 15:18:09 +0200
Subject: [PATCH 010/716] [YouTubeCommunityTabBridge] Fix PHP warnings for
 posts w/o text (#3536)

Because "contentText" is always present, PHP warnings were previously
generated for posts without text.
Existence of sub-property "runs" gets checked now to avoid this.
---
 bridges/YouTubeCommunityTabBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/YouTubeCommunityTabBridge.php b/bridges/YouTubeCommunityTabBridge.php
index c9ea5863..32502f61 100644
--- a/bridges/YouTubeCommunityTabBridge.php
+++ b/bridges/YouTubeCommunityTabBridge.php
@@ -92,7 +92,7 @@ class YouTubeCommunityTabBridge extends BridgeAbstract
             $item['author'] = $details->authorText->runs[0]->text;
             $item['content'] = '';
 
-            if (isset($details->contentText)) {
+            if (isset($details->contentText->runs)) {
                 $text = $this->getText($details->contentText->runs);
 
                 $this->itemTitle = $this->ellipsisTitle($text);

From eaea8e664078db55dd32dd227bad34acb6c46229 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 15 Jul 2023 21:16:23 +0200
Subject: [PATCH 011/716] fix: Undefined index: REMOTE_ADDR in non-web sapi'
 (#3538)

---
 lib/Debug.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/Debug.php b/lib/Debug.php
index f6a8d105..48dbb31a 100644
--- a/lib/Debug.php
+++ b/lib/Debug.php
@@ -7,7 +7,7 @@ class Debug
      */
     public static function isEnabled(): bool
     {
-        $ip = $_SERVER['REMOTE_ADDR'];
+        $ip = $_SERVER['REMOTE_ADDR'] ?? 'x.y.z.1';
         $enableDebugMode = Configuration::getConfig('system', 'enable_debug_mode');
         $debugModeWhitelist = Configuration::getConfig('system', 'debug_mode_whitelist') ?: [];
         if ($enableDebugMode && ($debugModeWhitelist === [] || in_array($ip, $debugModeWhitelist))) {

From ef8181478d62b7a558dcf9821076882b13443b0f Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 15 Jul 2023 22:12:16 +0200
Subject: [PATCH 012/716] perf(SqliteCache): add index to updated (#3515)

* refactor(SqliteCache)

* perf(SqliteCache): add index to updated
---
 caches/SQLiteCache.php | 23 ++++++++++-------------
 1 file changed, 10 insertions(+), 13 deletions(-)

diff --git a/caches/SQLiteCache.php b/caches/SQLiteCache.php
index 309b86d1..cb9f33b1 100644
--- a/caches/SQLiteCache.php
+++ b/caches/SQLiteCache.php
@@ -1,8 +1,5 @@
 <?php
 
-/**
- * Cache based on SQLite 3 <https://www.sqlite.org>
- */
 class SQLiteCache implements CacheInterface
 {
     private \SQLite3 $db;
@@ -32,6 +29,7 @@ class SQLiteCache implements CacheInterface
             $this->db = new \SQLite3($config['file']);
             $this->db->enableExceptions(true);
             $this->db->exec("CREATE TABLE storage ('key' BLOB PRIMARY KEY, 'value' BLOB, 'updated' INTEGER)");
+            $this->db->exec('CREATE INDEX idx_storage_updated ON storage (updated)');
         }
         $this->db->busyTimeout($config['timeout']);
     }
@@ -42,20 +40,22 @@ class SQLiteCache implements CacheInterface
         $stmt->bindValue(':key', $this->getCacheKey());
         $result = $stmt->execute();
         if ($result) {
-            $data = $result->fetchArray(\SQLITE3_ASSOC);
-            if (isset($data['value'])) {
-                return unserialize($data['value']);
+            $row = $result->fetchArray(\SQLITE3_ASSOC);
+            $data = unserialize($row['value']);
+            if ($data !== false) {
+                return $data;
             }
         }
-
         return null;
     }
 
     public function saveData($data): void
     {
+        $blob = serialize($data);
+
         $stmt = $this->db->prepare('INSERT OR REPLACE INTO storage (key, value, updated) VALUES (:key, :value, :updated)');
         $stmt->bindValue(':key', $this->getCacheKey());
-        $stmt->bindValue(':value', serialize($data));
+        $stmt->bindValue(':value', $blob);
         $stmt->bindValue(':updated', time());
         $stmt->execute();
     }
@@ -66,12 +66,9 @@ class SQLiteCache implements CacheInterface
         $stmt->bindValue(':key', $this->getCacheKey());
         $result = $stmt->execute();
         if ($result) {
-            $data = $result->fetchArray(\SQLITE3_ASSOC);
-            if (isset($data['updated'])) {
-                return $data['updated'];
-            }
+            $row = $result->fetchArray(\SQLITE3_ASSOC);
+            return $row['updated'];
         }
-
         return null;
     }
 

From e8420b9f39fa5db6272d341d31b090a1be22e211 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 15 Jul 2023 22:44:26 +0200
Subject: [PATCH 013/716] fix(sqlitecache): log failed unserialization (#3539)

---
 caches/SQLiteCache.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/caches/SQLiteCache.php b/caches/SQLiteCache.php
index cb9f33b1..bc110928 100644
--- a/caches/SQLiteCache.php
+++ b/caches/SQLiteCache.php
@@ -41,10 +41,12 @@ class SQLiteCache implements CacheInterface
         $result = $stmt->execute();
         if ($result) {
             $row = $result->fetchArray(\SQLITE3_ASSOC);
-            $data = unserialize($row['value']);
+            $blob = $row['value'];
+            $data = unserialize($blob);
             if ($data !== false) {
                 return $data;
             }
+            Logger::error(sprintf("Failed to unserialize: '%s'", mb_substr($blob, 0, 100)));
         }
         return null;
     }

From 773eea196f028f7576345884df3269054073394a Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 16 Jul 2023 05:29:56 +0200
Subject: [PATCH 014/716] fix(sqlitecache): bug in prior refactor (#3540)

fixes:

rssbridge.WARNING Trying to access array offset on value of type bool at caches/SQLiteCache.php line 72
---
 caches/SQLiteCache.php | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/caches/SQLiteCache.php b/caches/SQLiteCache.php
index bc110928..f9258a88 100644
--- a/caches/SQLiteCache.php
+++ b/caches/SQLiteCache.php
@@ -41,12 +41,14 @@ class SQLiteCache implements CacheInterface
         $result = $stmt->execute();
         if ($result) {
             $row = $result->fetchArray(\SQLITE3_ASSOC);
-            $blob = $row['value'];
-            $data = unserialize($blob);
-            if ($data !== false) {
-                return $data;
+            if ($row !== false) {
+                $blob = $row['value'];
+                $data = unserialize($blob);
+                if ($data !== false) {
+                    return $data;
+                }
+                Logger::error(sprintf("Failed to unserialize: '%s'", mb_substr($blob, 0, 100)));
             }
-            Logger::error(sprintf("Failed to unserialize: '%s'", mb_substr($blob, 0, 100)));
         }
         return null;
     }
@@ -69,7 +71,9 @@ class SQLiteCache implements CacheInterface
         $result = $stmt->execute();
         if ($result) {
             $row = $result->fetchArray(\SQLITE3_ASSOC);
-            return $row['updated'];
+            if ($row !== false) {
+                return $row['updated'];
+            }
         }
         return null;
     }

From 310160fd9286799f5b41438b1c4abe3128567671 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 16 Jul 2023 07:18:38 +0200
Subject: [PATCH 015/716] feat: improve http 429 handling (#3541)

---
 actions/DisplayAction.php | 12 ++++++------
 lib/RssBridge.php         |  2 +-
 lib/contents.php          |  2 +-
 3 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 66acd4cc..91cfb95f 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -142,13 +142,14 @@ class DisplayAction implements ActionInterface
                     'donationUri'  => $bridge->getDonationURI(),
                     'icon' => $bridge->getIcon()
                 ];
-            } catch (\Throwable $e) {
+            } catch (\Exception $e) {
                 if ($e instanceof HttpException) {
-                    // Produce a smaller log record for http exceptions
-                    Logger::warning(sprintf('Exception in %s: %s', $bridgeClassName, create_sane_exception_message($e)));
+                    Logger::warning(sprintf('Exception in DisplayAction(%s): %s', $bridgeClassName, create_sane_exception_message($e)));
+                    if ($e->getCode() === 429) {
+                        return new Response('503 Service Unavailable', 503);
+                    }
                 } else {
-                    // Log the exception
-                    Logger::error(sprintf('Exception in %s', $bridgeClassName), ['e' => $e]);
+                    Logger::error(sprintf('Exception in DisplayAction(%s): %s', $bridgeClassName, create_sane_exception_message($e)), ['e' => $e]);
                 }
 
                 // Emit error only if we are passed the error report limit
@@ -158,7 +159,6 @@ class DisplayAction implements ActionInterface
                         // Emit the error as a feed item in a feed so that feed readers can pick it up
                         $items[] = $this->createFeedItemFromException($e, $bridge);
                     } elseif (Configuration::getConfig('error', 'output') === 'http') {
-                        // Emit as a regular web response
                         throw $e;
                     }
                 }
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index 79d1d710..e8b07a65 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -16,7 +16,7 @@ final class RssBridge
         try {
             $this->run($request);
         } catch (\Throwable $e) {
-            Logger::error('Exception in main', ['e' => $e]);
+            Logger::error(sprintf('Exception in RssBridge::main(): %s', create_sane_exception_message($e)), ['e' => $e]);
             http_response_code(500);
             print render(__DIR__ . '/../templates/error.html.php', ['e' => $e]);
         }
diff --git a/lib/contents.php b/lib/contents.php
index 56dd4be6..c6edba7b 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -197,7 +197,7 @@ function getContents(
                 }
             }
 
-            throw new HttpException($exceptionMessage, $result['code']);
+            throw new HttpException(trim($exceptionMessage), $result['code']);
     }
     if ($returnFull === true) {
         return $response;

From 7b46b97abd4d1d53dea51175ddfe97113058a4e8 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 16 Jul 2023 21:50:44 +0200
Subject: [PATCH 016/716] refactor(spotify): replace manual curl with
 getContents (#3544)

---
 bridges/SpotifyBridge.php | 57 +++++++++++++--------------------------
 1 file changed, 18 insertions(+), 39 deletions(-)

diff --git a/bridges/SpotifyBridge.php b/bridges/SpotifyBridge.php
index 170f4c86..b58d14be 100644
--- a/bridges/SpotifyBridge.php
+++ b/bridges/SpotifyBridge.php
@@ -53,6 +53,7 @@ class SpotifyBridge extends BridgeAbstract
 
     public function collectData()
     {
+        $this->fetchAccessToken();
         $entries = $this->getAllEntries();
         usort($entries, function ($entry1, $entry2) {
             return $this->getDate($entry2) <=> $this->getDate($entry1);
@@ -92,7 +93,7 @@ class SpotifyBridge extends BridgeAbstract
                 'show' => 'episode',
             ];
             if (!isset($types[$type])) {
-                throw new \Exception('Spotify URI not supported');
+                throw new \Exception(sprintf('Unsupported Spotify URI: %s', $uri));
             }
             $entry_type = $types[$type];
 
@@ -111,7 +112,8 @@ class SpotifyBridge extends BridgeAbstract
             $offset = 0;
             while (true) {
                 $query['offset'] = $offset;
-                $partial = $this->fetchContent($url . '?' . http_build_query($query));
+                $json = getContents($url . '?' . http_build_query($query), ['Authorization: Bearer ' . $this->token]);
+                $partial = Json::decode($json);
                 if (empty($partial['items'])) {
                     break;
                 }
@@ -188,12 +190,11 @@ class SpotifyBridge extends BridgeAbstract
         return DateTime::createFromFormat('Y-m-d', $date)->getTimestamp();
     }
 
-    private function getToken()
+    private function fetchAccessToken()
     {
         $cache = RssBridge::getCache();
-        $cache->setScope('SpotifyBridge');
-
         $cacheKey = sprintf('%s:%s', $this->getInput('clientid'), $this->getInput('clientsecret'));
+        $cache->setScope('SpotifyBridge');
         $cache->setKey([$cacheKey]);
 
         $time = null;
@@ -202,45 +203,22 @@ class SpotifyBridge extends BridgeAbstract
         }
 
         if (!$cache->getTime() || $time >= 3600) {
-            $this->fetchToken();
+            // fetch token
+            $basicAuth = base64_encode(sprintf('%s:%s', $this->getInput('clientid'), $this->getInput('clientsecret')));
+            $json = getContents('https://accounts.spotify.com/api/token', [
+                "Authorization: Basic $basicAuth"
+            ], [
+                CURLOPT_POSTFIELDS => 'grant_type=client_credentials'
+            ]);
+            $data = Json::decode($json);
+            $this->token = $data['access_token'];
+
             $cache->saveData($this->token);
         } else {
             $this->token = $cache->loadData();
         }
     }
 
-    private function fetchToken()
-    {
-        $curl = curl_init();
-
-        curl_setopt($curl, CURLOPT_URL, 'https://accounts.spotify.com/api/token');
-        curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
-        curl_setopt($curl, CURLOPT_POST, 1);
-        curl_setopt($curl, CURLOPT_POSTFIELDS, 'grant_type=client_credentials');
-
-        $basic = sprintf('%s:%s', $this->getInput('clientid'), $this->getInput('clientsecret'));
-        curl_setopt($curl, CURLOPT_HTTPHEADER, ['Authorization: Basic ' . base64_encode($basic)]);
-
-        $json = curl_exec($curl);
-        $json = json_decode($json)->access_token;
-        curl_close($curl);
-
-        $this->token = $json;
-    }
-
-    private function fetchContent($url)
-    {
-        $this->getToken();
-        $curl = curl_init();
-        curl_setopt($curl, CURLOPT_URL, $url);
-        curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
-        curl_setopt($curl, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $this->token]);
-        $json = curl_exec($curl);
-        $json = json_decode($json, true);
-        curl_close($curl);
-        return $json;
-    }
-
     public function getURI()
     {
         if (empty($this->uri)) {
@@ -273,7 +251,8 @@ class SpotifyBridge extends BridgeAbstract
                 $query['market'] = $this->getInput('country');
             }
 
-            $item = $this->fetchContent($uri . '?' . http_build_query($query));
+            $json = getContents($uri . '?' . http_build_query($query), ['Authorization: Bearer ' . $this->token]);
+            $item = Json::decode($json);
 
             $this->uri = $item['external_urls']['spotify'];
             $this->name = $item['name'] . ' - Spotify';

From a59793e8d647c77a2537e41a4e8fa3fcca728cff Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 16 Jul 2023 22:07:34 +0200
Subject: [PATCH 017/716] refactor: extract CurlHttpClient (#3532)

* refactor: extract CurlHttpClient

* refactor

* interface
---
 bridges/AO3Bridge.php                         |   7 +-
 .../prepare_release/fetch_contributors.php    |   3 +-
 lib/RssBridge.php                             |  16 +-
 lib/contents.php                              | 257 +++++++++---------
 4 files changed, 145 insertions(+), 138 deletions(-)

diff --git a/bridges/AO3Bridge.php b/bridges/AO3Bridge.php
index 6ca59cc5..57e12fbd 100644
--- a/bridges/AO3Bridge.php
+++ b/bridges/AO3Bridge.php
@@ -92,7 +92,12 @@ class AO3Bridge extends BridgeAbstract
     private function collectWork($id)
     {
         $url = self::URI . "/works/$id/navigate";
-        $response = _http_request($url, ['useragent' => 'rss-bridge bot (https://github.com/RSS-Bridge/rss-bridge)']);
+        $httpClient = RssBridge::getHttpClient();
+
+        $response = $httpClient->request($url, [
+            'useragent' => 'rss-bridge bot (https://github.com/RSS-Bridge/rss-bridge)',
+        ]);
+
         $html = \str_get_html($response['body']);
         $html = defaultLinkTo($html, self::URI);
 
diff --git a/contrib/prepare_release/fetch_contributors.php b/contrib/prepare_release/fetch_contributors.php
index ad04458a..cfe2c5b2 100644
--- a/contrib/prepare_release/fetch_contributors.php
+++ b/contrib/prepare_release/fetch_contributors.php
@@ -14,7 +14,8 @@ while ($next) { /* Collect all contributors */
         'Content-Type' => 'application/json',
         'User-Agent' => 'RSS-Bridge',
     ];
-    $result = _http_request($url, ['headers' => $headers]);
+    $httpClient = new CurlHttpClient();
+    $result = $httpClient->request($url, ['headers' => $headers]);
 
     foreach (json_decode($result['body']) as $contributor) {
         $contributors[] = $contributor;
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index e8b07a65..8969dc54 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -2,6 +2,7 @@
 
 final class RssBridge
 {
+    private static HttpClient $httpClient;
     private static CacheInterface $cache;
 
     public function main(array $argv = [])
@@ -71,9 +72,10 @@ final class RssBridge
         // Consider: ini_set('error_reporting', E_ALL & ~E_DEPRECATED);
         date_default_timezone_set(Configuration::getConfig('system', 'timezone'));
 
-        // Create cache
         $cacheFactory = new CacheFactory();
-        self::setCache($cacheFactory->create());
+
+        self::$httpClient = new CurlHttpClient();
+        self::$cache = $cacheFactory->create();
 
         if (Configuration::getConfig('authentication', 'enable')) {
             $authenticationMiddleware = new AuthenticationMiddleware();
@@ -105,13 +107,13 @@ final class RssBridge
         }
     }
 
+    public static function getHttpClient(): HttpClient
+    {
+        return self::$httpClient;
+    }
+
     public static function getCache(): CacheInterface
     {
         return self::$cache;
     }
-
-    public static function setCache(CacheInterface $cache): void
-    {
-        self::$cache = $cache;
-    }
 }
diff --git a/lib/contents.php b/lib/contents.php
index c6edba7b..419432df 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -99,6 +99,7 @@ function getContents(
     array $curlOptions = [],
     bool $returnFull = false
 ) {
+    $httpClient = RssBridge::getHttpClient();
     $cache = RssBridge::getCache();
     $cache->setScope('server');
     $cache->setKey([$url]);
@@ -141,20 +142,14 @@ function getContents(
         $config['if_not_modified_since'] = $cache->getTime();
     }
 
-    $result = _http_request($url, $config);
-    $response = [
-        'code' => $result['code'],
-        'status_lines' => $result['status_lines'],
-        'header' => $result['headers'],
-        'content' => $result['body'],
-    ];
+    $response = $httpClient->request($url, $config);
 
-    switch ($result['code']) {
+    switch ($response['code']) {
         case 200:
         case 201:
         case 202:
-            if (isset($result['headers']['cache-control'])) {
-                $cachecontrol = $result['headers']['cache-control'];
+            if (isset($response['headers']['cache-control'])) {
+                $cachecontrol = $response['headers']['cache-control'];
                 $lastValue = array_pop($cachecontrol);
                 $directives = explode(',', $lastValue);
                 $directives = array_map('trim', $directives);
@@ -163,7 +158,7 @@ function getContents(
                     break;
                 }
             }
-            $cache->saveData($result['body']);
+            $cache->saveData($response['body']);
             break;
         case 301:
         case 302:
@@ -172,16 +167,16 @@ function getContents(
             break;
         case 304:
             // Not Modified
-            $response['content'] = $cache->loadData();
+            $response['body'] = $cache->loadData();
             break;
         default:
             $exceptionMessage = sprintf(
                 '%s resulted in %s %s %s',
                 $url,
-                $result['code'],
-                Response::STATUS_CODES[$result['code']] ?? '',
+                $response['code'],
+                Response::STATUS_CODES[$response['code']] ?? '',
                 // If debug, include a part of the response body in the exception message
-                Debug::isEnabled() ? mb_substr($result['body'], 0, 500) : '',
+                Debug::isEnabled() ? mb_substr($response['body'], 0, 500) : '',
             );
 
             // The following code must be extracted if it grows too much
@@ -192,137 +187,141 @@ function getContents(
                 '<title>Security | Glassdoor',
             ];
             foreach ($cloudflareTitles as $cloudflareTitle) {
-                if (str_contains($result['body'], $cloudflareTitle)) {
-                    throw new CloudFlareException($exceptionMessage, $result['code']);
+                if (str_contains($response['body'], $cloudflareTitle)) {
+                    throw new CloudFlareException($exceptionMessage, $response['code']);
                 }
             }
-
             throw new HttpException(trim($exceptionMessage), $result['code']);
     }
     if ($returnFull === true) {
+        // For legacy reasons, use content instead of body
+        $response['content'] = $response['body'];
+        unset($response['body']);
         return $response;
     }
-    return $response['content'];
+    return $response['body'];
 }
 
-/**
- * Fetch content from url
- *
- * @internal Private function used internally
- * @throws HttpException
- */
-function _http_request(string $url, array $config = []): array
+interface HttpClient
 {
-    $defaults = [
-        'useragent' => null,
-        'timeout' => 5,
-        'headers' => [],
-        'proxy' => null,
-        'curl_options' => [],
-        'if_not_modified_since' => null,
-        'retries' => 3,
-        'max_filesize' => null,
-        'max_redirections' => 5,
-    ];
-    $config = array_merge($defaults, $config);
+    public function request(string $url, array $config = []): array;
+}
 
-    $ch = curl_init($url);
-    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
-    curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
-    curl_setopt($ch, CURLOPT_MAXREDIRS, $config['max_redirections']);
-    curl_setopt($ch, CURLOPT_HEADER, false);
-    $httpHeaders = [];
-    foreach ($config['headers'] as $name => $value) {
-        $httpHeaders[] = sprintf('%s: %s', $name, $value);
-    }
-    curl_setopt($ch, CURLOPT_HTTPHEADER, $httpHeaders);
-    if ($config['useragent']) {
-        curl_setopt($ch, CURLOPT_USERAGENT, $config['useragent']);
-    }
-    curl_setopt($ch, CURLOPT_TIMEOUT, $config['timeout']);
-    curl_setopt($ch, CURLOPT_ENCODING, '');
-    curl_setopt($ch, CURLOPT_PROTOCOLS, CURLPROTO_HTTP | CURLPROTO_HTTPS);
+final class CurlHttpClient implements HttpClient
+{
+    public function request(string $url, array $config = []): array
+    {
+        $defaults = [
+            'useragent' => null,
+            'timeout' => 5,
+            'headers' => [],
+            'proxy' => null,
+            'curl_options' => [],
+            'if_not_modified_since' => null,
+            'retries' => 3,
+            'max_filesize' => null,
+            'max_redirections' => 5,
+        ];
+        $config = array_merge($defaults, $config);
 
-    if ($config['max_filesize']) {
-        // This option inspects the Content-Length header
-        curl_setopt($ch, CURLOPT_MAXFILESIZE, $config['max_filesize']);
-        curl_setopt($ch, CURLOPT_NOPROGRESS, false);
-        // This progress function will monitor responses who omit the Content-Length header
-        curl_setopt($ch, CURLOPT_PROGRESSFUNCTION, function ($ch, $downloadSize, $downloaded, $uploadSize, $uploaded) use ($config) {
-            if ($downloaded > $config['max_filesize']) {
-                // Return a non-zero value to abort the transfer
-                return -1;
+        $ch = curl_init($url);
+        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+        curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
+        curl_setopt($ch, CURLOPT_MAXREDIRS, $config['max_redirections']);
+        curl_setopt($ch, CURLOPT_HEADER, false);
+        $httpHeaders = [];
+        foreach ($config['headers'] as $name => $value) {
+            $httpHeaders[] = sprintf('%s: %s', $name, $value);
+        }
+        curl_setopt($ch, CURLOPT_HTTPHEADER, $httpHeaders);
+        if ($config['useragent']) {
+            curl_setopt($ch, CURLOPT_USERAGENT, $config['useragent']);
+        }
+        curl_setopt($ch, CURLOPT_TIMEOUT, $config['timeout']);
+        curl_setopt($ch, CURLOPT_ENCODING, '');
+        curl_setopt($ch, CURLOPT_PROTOCOLS, CURLPROTO_HTTP | CURLPROTO_HTTPS);
+
+        if ($config['max_filesize']) {
+            // This option inspects the Content-Length header
+            curl_setopt($ch, CURLOPT_MAXFILESIZE, $config['max_filesize']);
+            curl_setopt($ch, CURLOPT_NOPROGRESS, false);
+            // This progress function will monitor responses who omit the Content-Length header
+            curl_setopt($ch, CURLOPT_PROGRESSFUNCTION, function ($ch, $downloadSize, $downloaded, $uploadSize, $uploaded) use ($config) {
+                if ($downloaded > $config['max_filesize']) {
+                    // Return a non-zero value to abort the transfer
+                    return -1;
+                }
+                return 0;
+            });
+        }
+
+        if ($config['proxy']) {
+            curl_setopt($ch, CURLOPT_PROXY, $config['proxy']);
+        }
+        if (curl_setopt_array($ch, $config['curl_options']) === false) {
+            throw new \Exception('Tried to set an illegal curl option');
+        }
+
+        if ($config['if_not_modified_since']) {
+            curl_setopt($ch, CURLOPT_TIMEVALUE, $config['if_not_modified_since']);
+            curl_setopt($ch, CURLOPT_TIMECONDITION, CURL_TIMECOND_IFMODSINCE);
+        }
+
+        $responseStatusLines = [];
+        $responseHeaders = [];
+        curl_setopt($ch, CURLOPT_HEADERFUNCTION, function ($ch, $rawHeader) use (&$responseHeaders, &$responseStatusLines) {
+            $len = strlen($rawHeader);
+            if ($rawHeader === "\r\n") {
+                return $len;
             }
-            return 0;
+            if (preg_match('#^HTTP/(2|1.1|1.0)#', $rawHeader)) {
+                $responseStatusLines[] = $rawHeader;
+                return $len;
+            }
+            $header = explode(':', $rawHeader);
+            if (count($header) === 1) {
+                return $len;
+            }
+            $name = mb_strtolower(trim($header[0]));
+            $value = trim(implode(':', array_slice($header, 1)));
+            if (!isset($responseHeaders[$name])) {
+                $responseHeaders[$name] = [];
+            }
+            $responseHeaders[$name][] = $value;
+            return $len;
         });
-    }
 
-    if ($config['proxy']) {
-        curl_setopt($ch, CURLOPT_PROXY, $config['proxy']);
-    }
-    if (curl_setopt_array($ch, $config['curl_options']) === false) {
-        throw new \Exception('Tried to set an illegal curl option');
-    }
+        $attempts = 0;
+        while (true) {
+            $attempts++;
+            $data = curl_exec($ch);
+            if ($data !== false) {
+                // The network call was successful, so break out of the loop
+                break;
+            }
+            if ($attempts > $config['retries']) {
+                // Finally give up
+                $curl_error = curl_error($ch);
+                $curl_errno = curl_errno($ch);
+                throw new HttpException(sprintf(
+                    'cURL error %s: %s (%s) for %s',
+                    $curl_error,
+                    $curl_errno,
+                    'https://curl.haxx.se/libcurl/c/libcurl-errors.html',
+                    $url
+                ));
+            }
+        }
 
-    if ($config['if_not_modified_since']) {
-        curl_setopt($ch, CURLOPT_TIMEVALUE, $config['if_not_modified_since']);
-        curl_setopt($ch, CURLOPT_TIMECONDITION, CURL_TIMECOND_IFMODSINCE);
+        $statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
+        curl_close($ch);
+        return [
+            'code' => $statusCode,
+            'status_lines' => $responseStatusLines,
+            'headers' => $responseHeaders,
+            'body' => $data,
+        ];
     }
-
-    $responseStatusLines = [];
-    $responseHeaders = [];
-    curl_setopt($ch, CURLOPT_HEADERFUNCTION, function ($ch, $rawHeader) use (&$responseHeaders, &$responseStatusLines) {
-        $len = strlen($rawHeader);
-        if ($rawHeader === "\r\n") {
-            return $len;
-        }
-        if (preg_match('#^HTTP/(2|1.1|1.0)#', $rawHeader)) {
-            $responseStatusLines[] = $rawHeader;
-            return $len;
-        }
-        $header = explode(':', $rawHeader);
-        if (count($header) === 1) {
-            return $len;
-        }
-        $name = mb_strtolower(trim($header[0]));
-        $value = trim(implode(':', array_slice($header, 1)));
-        if (!isset($responseHeaders[$name])) {
-            $responseHeaders[$name] = [];
-        }
-        $responseHeaders[$name][] = $value;
-        return $len;
-    });
-
-    $attempts = 0;
-    while (true) {
-        $attempts++;
-        $data = curl_exec($ch);
-        if ($data !== false) {
-            // The network call was successful, so break out of the loop
-            break;
-        }
-        if ($attempts > $config['retries']) {
-            // Finally give up
-            $curl_error = curl_error($ch);
-            $curl_errno = curl_errno($ch);
-            throw new HttpException(sprintf(
-                'cURL error %s: %s (%s) for %s',
-                $curl_error,
-                $curl_errno,
-                'https://curl.haxx.se/libcurl/c/libcurl-errors.html',
-                $url
-            ));
-        }
-    }
-
-    $statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
-    curl_close($ch);
-    return [
-        'code'      => $statusCode,
-        'status_lines' => $responseStatusLines,
-        'headers'   => $responseHeaders,
-        'body'      => $data,
-    ];
 }
 
 /**

From 440adf2f3b62a99160166a531f985064344ba4e7 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 16 Jul 2023 22:28:20 +0200
Subject: [PATCH 018/716] fix(githubissue): add 10 min cache (#3545)

---
 bridges/GithubIssueBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/GithubIssueBridge.php b/bridges/GithubIssueBridge.php
index 9ca84010..a75aa252 100644
--- a/bridges/GithubIssueBridge.php
+++ b/bridges/GithubIssueBridge.php
@@ -5,7 +5,7 @@ class GithubIssueBridge extends BridgeAbstract
     const MAINTAINER = 'Pierre Mazière';
     const NAME = 'Github Issue';
     const URI = 'https://github.com/';
-    const CACHE_TIMEOUT = 0; // 10min
+    const CACHE_TIMEOUT = 600; // 10m
     const DESCRIPTION = 'Returns the issues or comments of an issue of a github project';
 
     const PARAMETERS = [

From 08d16322e1066f207875bcbd7f9930aadb080860 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 16 Jul 2023 22:37:37 +0200
Subject: [PATCH 019/716] fix: bug in prior conflict merge (#3546)

---
 lib/contents.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/contents.php b/lib/contents.php
index 419432df..b6b74539 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -191,7 +191,7 @@ function getContents(
                     throw new CloudFlareException($exceptionMessage, $response['code']);
                 }
             }
-            throw new HttpException(trim($exceptionMessage), $result['code']);
+            throw new HttpException(trim($exceptionMessage), $response['code']);
     }
     if ($returnFull === true) {
         // For legacy reasons, use content instead of body

From a1bae7a9a823d5d54074c70596ec59528cf2ed15 Mon Sep 17 00:00:00 2001
From: Paroleen <matteoparolin99@gmail.com>
Date: Tue, 18 Jul 2023 00:43:08 +0200
Subject: [PATCH 020/716] [SpotifyBridge] Add search API support (#3548)

---
 bridges/SpotifyBridge.php | 164 +++++++++++++++++++++++++++++---------
 1 file changed, 125 insertions(+), 39 deletions(-)

diff --git a/bridges/SpotifyBridge.php b/bridges/SpotifyBridge.php
index b58d14be..169075e2 100644
--- a/bridges/SpotifyBridge.php
+++ b/bridges/SpotifyBridge.php
@@ -7,45 +7,86 @@ class SpotifyBridge extends BridgeAbstract
     const DESCRIPTION = 'Fetches the latest items from one or more artists, playlists or podcasts';
     const MAINTAINER = 'Paroleen';
     const CACHE_TIMEOUT = 3600;
-    const PARAMETERS = [ [
-        'clientid' => [
-            'name' => 'Client ID',
-            'type' => 'text',
-            'required' => true
+    const PARAMETERS = [
+        'By Spotify URIs' => [
+            'clientid' => [
+                'name' => 'Client ID',
+                'type' => 'text',
+                'required' => true
+            ],
+            'clientsecret' => [
+                'name' => 'Client secret',
+                'type' => 'text',
+                'required' => true
+            ],
+            'country' => [
+                'name' => 'Country/Market',
+                'type' => 'text',
+                'required' => false,
+                'exampleValue' => 'US',
+                'defaultValue' => 'US'
+            ],
+            'limit' => [
+                'name' => 'Limit',
+                'type' => 'number',
+                'required' => false,
+                'exampleValue' => 10,
+                'defaultValue' => 10
+            ],
+            'spotifyuri' => [
+                'name' => 'Spotify URIs',
+                'type' => 'text',
+                'required' => true,
+                'exampleValue' => 'spotify:artist:4lianjyuR1tqf6oUX8kjrZ [,spotify:playlist:37i9dQZF1DXcBWIGoYBM5M,spotify:show:6ShFMYxeDNMo15COLObDvC]',
+            ],
+            'albumtype' => [
+                'name' => 'Album type',
+                'type' => 'text',
+                'required' => false,
+                'exampleValue' => 'album,single,appears_on,compilation',
+                'defaultValue' => 'album,single'
+            ]
         ],
-        'clientsecret' => [
-            'name' => 'Client secret',
-            'type' => 'text',
-            'required' => true
+        'By Spotify Search' => [
+            'clientid' => [
+                'name' => 'Client ID',
+                'type' => 'text',
+                'required' => true
+            ],
+            'clientsecret' => [
+                'name' => 'Client secret',
+                'type' => 'text',
+                'required' => true
+            ],
+            'market' => [
+                'name' => 'Market',
+                'type' => 'text',
+                'required' => false,
+                'exampleValue' => 'US',
+                'defaultValue' => 'US'
+            ],
+            'limit' => [
+                'name' => 'Limit',
+                'type' => 'number',
+                'required' => false,
+                'exampleValue' => 10,
+                'defaultValue' => 10
+            ],
+            'query' => [
+                'name' => 'Search query',
+                'type' => 'text',
+                'required' => true,
+                'exampleValue' => 'artist:The Beatles',
+            ],
+            'type' => [
+                'name' => 'Type',
+                'type' => 'text',
+                'required' => true,
+                'exampleValue' => 'album,episode',
+                'defaultValue' => 'album,episode'
+            ]
         ],
-        'country' => [
-            'name' => 'Country/Market',
-            'type' => 'text',
-            'required' => false,
-            'exampleValue' => 'US',
-            'defaultValue' => 'US'
-        ],
-        'limit' => [
-            'name' => 'Limit',
-            'type' => 'number',
-            'required' => false,
-            'exampleValue' => 10,
-            'defaultValue' => 10
-        ],
-        'spotifyuri' => [
-            'name' => 'Spotify URIs',
-            'type' => 'text',
-            'required' => true,
-            'exampleValue' => 'spotify:artist:4lianjyuR1tqf6oUX8kjrZ [,spotify:playlist:37i9dQZF1DXcBWIGoYBM5M,spotify:show:6ShFMYxeDNMo15COLObDvC]',
-        ],
-        'albumtype' => [
-            'name' => 'Album type',
-            'type' => 'text',
-            'required' => false,
-            'exampleValue' => 'album,single,appears_on,compilation',
-            'defaultValue' => 'album,single'
-        ]
-    ] ];
+    ];
 
     private $uri = '';
     private $name = '';
@@ -54,7 +95,13 @@ class SpotifyBridge extends BridgeAbstract
     public function collectData()
     {
         $this->fetchAccessToken();
-        $entries = $this->getAllEntries();
+
+        if ($this->queriedContext === 'By Spotify URIs') {
+            $entries = $this->getEntriesFromURIs();
+        } else {
+            $entries = $this->getEntriesFromQuery();
+        }
+
         usort($entries, function ($entry1, $entry2) {
             return $this->getDate($entry2) <=> $this->getDate($entry1);
         });
@@ -78,7 +125,46 @@ class SpotifyBridge extends BridgeAbstract
         }
     }
 
-    private function getAllEntries()
+    private function getEntriesFromQuery()
+    {
+        $entries = [];
+
+        $types = [
+            'albums',
+            'episodes',
+        ];
+
+        $query = [
+            'q' => $this->getInput('query'),
+            'type' => $this->getInput('type'),
+            'market' => $this->getInput('market'),
+            'limit' => 50,
+        ];
+
+        $hasItems = true;
+        $offset = 0;
+
+        while ($hasItems && $offset < 1000) {
+            $hasItems = false;
+
+            $query['offset'] = $offset;
+            $json = getContents('https://api.spotify.com/v1/search?' . http_build_query($query), ['Authorization: Bearer ' . $this->token]);
+            $partial = Json::decode($json);
+
+            foreach ($types as $type) {
+                if (isset($partial[$type]['items'])) {
+                    $entries = array_merge($entries, $partial[$type]['items']);
+                    $hasItems = true;
+                }
+            }
+
+            $offset += 50;
+        }
+
+        return $entries;
+    }
+
+    private function getEntriesFromURIs()
     {
         $entries = [];
         $uris = explode(',', $this->getInput('spotifyuri'));

From 4ce63c88aae24466c6990fa23b73f8ad74dbe3af Mon Sep 17 00:00:00 2001
From: mrtnvgr <48406064+mrtnvgr@users.noreply.github.com>
Date: Wed, 19 Jul 2023 01:48:29 +0700
Subject: [PATCH 021/716] Add DoujinStyleBridge (#3549)

* v1

* improve title

* search support

* random support

* fix categories

* add metadata to content

* fix linter errors

* i'm sorry
---
 bridges/DoujinStyleBridge.php | 148 ++++++++++++++++++++++++++++++++++
 1 file changed, 148 insertions(+)
 create mode 100644 bridges/DoujinStyleBridge.php

diff --git a/bridges/DoujinStyleBridge.php b/bridges/DoujinStyleBridge.php
new file mode 100644
index 00000000..84469739
--- /dev/null
+++ b/bridges/DoujinStyleBridge.php
@@ -0,0 +1,148 @@
+<?php
+
+class DoujinStyleBridge extends BridgeAbstract
+{
+    const NAME = 'DoujinStyle Bridge';
+    const URI = 'https://doujinstyle.com/';
+    const DESCRIPTION = 'Returns submissions from DoujinStyle';
+    const MAINTAINER = 'mrtnvgr';
+
+    // TODO: "Games" support
+
+    const PARAMETERS = [
+        'Most recent submissions' => [],
+        'Randomly selected items' => [],
+        'From search results' => [
+            'query' => [
+                'name' => 'Search query',
+                'required' => true,
+                'exampleValue' => 'FELT',
+            ],
+            'flac' => [
+                'name' => 'Include FLAC',
+                'type' => 'checkbox',
+                'defaultValue' => false,
+            ],
+            'mp3' => [
+                'name' => 'Include MP3',
+                'type' => 'checkbox',
+                'defaultValue' => false,
+            ],
+            'tta' => [
+                'name' => 'Include TTA',
+                'type' => 'checkbox',
+                'defaultValue' => false,
+            ],
+            'opus' => [
+                'name' => 'Include Opus',
+                'type' => 'checkbox',
+                'defaultValue' => false,
+            ],
+            'ogg' => [
+                'name' => 'Include OGG',
+                'type' => 'checkbox',
+                'defaultValue' => false,
+            ]
+        ]
+    ];
+
+    public function collectData()
+    {
+        $html = getSimpleHTMLDOM($this->getURI());
+        $html = defaultLinkTo($html, $this->getURI());
+
+        $submissions = $html->find('.gridBox .gridDetails');
+        foreach ($submissions as $submission) {
+            $item = [];
+
+            $item['uri'] = $submission->find('a', 0)->href;
+
+            $content = getSimpleHTMLDOM($item['uri']);
+            $content = defaultLinkTo($content, $this->getURI());
+
+            $title = $content->find('h2', 0)->plaintext;
+
+            $cover = $content->find('#imgClick a', 0);
+            if (is_null($cover)) {
+                $cover = $content->find('.coverWrap', 0)->src;
+            } else {
+                $cover = $cover->href;
+            }
+
+            $item['content'] = "<img src='$cover'/>";
+
+            $keys = [];
+            foreach ($content->find('.pageWrap .pageSpan') as $key) {
+                $keys[] = $key->plaintext;
+            }
+
+            $values = $content->find('.pageWrap .pageSpan2');
+            $metadata = array_combine($keys, $values);
+
+            $format = 'Unknown';
+
+            foreach ($metadata as $key => $value) {
+                switch ($key) {
+                    case 'Artist':
+                        $artist = $value->find('a', 0)->plaintext;
+                        $item['title'] = "$artist - $title";
+                        $item['content'] .= "<br>Artist: $artist";
+                        break;
+                    case 'Tags:':
+                        $item['categories'] = [];
+                        foreach ($value->find('a') as $tag) {
+                            $tag = str_replace('&#45;', '-', $tag->plaintext);
+                            $item['categories'][] = $tag;
+                        }
+
+                        $item['content'] .= '<br>Tags: ' . join(', ', $item['categories']);
+                        break;
+                    case 'Format:':
+                        $item['content'] .= "<br>Format: $value->plaintext";
+                        break;
+                    case 'Date Added:':
+                        $item['timestamp'] = $value->plaintext;
+                        break;
+                    case 'Provided By:':
+                        $item['author'] = $value->find('a', 0)->plaintext;
+                        break;
+                }
+            }
+
+            $this->items[] = $item;
+        }
+    }
+
+    public function getURI()
+    {
+        $url = self::URI;
+
+        switch ($this->queriedContext) {
+            case 'From search results':
+                $url .= '?p=search&type=blanket';
+                $url .= '&result=' . $this->getInput('query');
+
+                if ($this->getInput('flac') == 1) {
+                    $url .= '&format0=on';
+                }
+                if ($this->getInput('mp3') == 1) {
+                    $url .= '&format1=on';
+                }
+                if ($this->getInput('tta') == 1) {
+                    $url .= '&format2=on';
+                }
+                if ($this->getInput('opus') == 1) {
+                    $url .= '&format3=on';
+                }
+                if ($this->getInput('ogg') == 1) {
+                    $url .= '&format4=on';
+                }
+                break;
+            case 'Randomly selected items':
+                $url .= '?p=random';
+                break;
+        }
+
+        return $url;
+    }
+}

From 087e790ec10d287f944e3abeb5ab3bda9a1a045a Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Wed, 19 Jul 2023 03:28:14 +0200
Subject: [PATCH 022/716] [ImgsedBridge] Add new Instagram Bridge Alternative
 (#3550)

* [ImgsedBridge] Add new Instagram Bridge Alternative

Imgsed is a Website adverstised on instagram website, that's is not
behind Cloudflare Anti Bot feature.
You can select to display Posts, Tags, and Stories of a specific
username

* [ImgsedBridge] Fix empty defaultValue
---
 bridges/ImgsedBridge.php | 256 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 256 insertions(+)
 create mode 100644 bridges/ImgsedBridge.php

diff --git a/bridges/ImgsedBridge.php b/bridges/ImgsedBridge.php
new file mode 100644
index 00000000..6c49facb
--- /dev/null
+++ b/bridges/ImgsedBridge.php
@@ -0,0 +1,256 @@
+<?php
+
+class ImgsedBridge extends BridgeAbstract
+{
+    const MAINTAINER = 'sysadminstory';
+    const NAME = 'Imgsed Bridge';
+    const URI = 'https://imgsed.com/';
+    const INSTAGRAMURI = 'https://www.instagram.com/';
+    const CACHE_TIMEOUT = 3600; // 1h
+    const DESCRIPTION = 'Returns Imgsed (Instagram viewer) content by user';
+
+    const PARAMETERS = [
+        'Username' => [
+            'u' => [
+                'name' => 'username',
+                'type' => 'text',
+                'title' => 'Instagram username you want to follow',
+                'exampleValue' => 'aesoprockwins',
+                'required' => true,
+            ],
+            'post' => [
+                'name' => 'posts',
+                'type' => 'checkbox',
+                'title' => 'Show posts for this Instagram user',
+                'defaultValue' => 'checked',
+            ],
+            'story' => [
+                'name' => 'stories',
+                'type' => 'checkbox',
+                'title' => 'Show stories for this Instagram user',
+            ],
+            'tagged' => [
+                'name' => 'tagged',
+                'type' => 'checkbox',
+                'title' => 'Show tagged post for this Instagram user',
+            ],
+        ]
+    ];
+
+    public function getURI()
+    {
+        if (!is_null($this->getInput('u'))) {
+            return urljoin(self::URI, '/' . $this->getInput('u') . '/');
+        }
+
+        return parent::getURI();
+    }
+
+    public function collectData()
+    {
+        $username = $this->getInput('u');
+        try {
+            // Check if the user exist
+            $html = getSimpleHTMLDOMCached(self::URI . $username . '/');
+            if ($this->getInput('post')) {
+                $this->collectPosts();
+            }
+            if ($this->getInput('story')) {
+                $this->collectStories();
+            }
+            if ($this->getInput('tagged')) {
+                $this->collectTaggeds();
+            }
+        } catch (HttpException $e) {
+            throw new \Exception(sprintf('Unable to find user `%s`', $username));
+        }
+    }
+
+    private function collectPosts()
+    {
+        $username = $this->getInput('u');
+        $html = getSimpleHTMLDOMCached(self::URI . $username . '/');
+        $html = defaultLinkTo($html, self::URI);
+
+        foreach ($html->find('div[class=item]') as $post) {
+            $url = $post->find('a', 0)->href;
+            $instagramURL = $this->convertURLToInstagram($url);
+            $date = $this->parseDate($post->find('div[class=time]', 0)->plaintext);
+            $description = $post->find('img', 0)->alt;
+            $imageUrl = $post->find('img', 0)->src;
+            // Sometimes, there is some lazy image instead of the real URL
+            if ($imageUrl == 'https://imgsed.com/img/lazy.jpg') {
+                $imageUrl = $post->find('img', 0)->getAttribute('data-src');
+            }
+            $download = $post->find('a[class=download]', 0)->href;
+            $author = $username;
+            $uid = $post->find('a', 0)->href;
+            $title = 'Post - ' . $username . ' - ' . $this->descriptionToTitle($description);
+
+            // Checking post type
+            $isVideo = (bool) $post->find('i[class=video]', 0);
+            $videoNote = $isVideo ? '<p><i>(video)</i></p>' : '';
+
+            $isMoreContent = (bool) $post->find('svg', 0);
+            $moreContentNote = $isMoreContent ? '<p><i>(multiple images and/or videos)</i></p>' : '';
+
+
+
+
+            $this->items[] = [
+                'uri'        => $url,
+                'author'     => $author,
+                'timestamp'  => $date,
+                'title'      => $title,
+                'thumbnail'  => $imageUrl,
+                'enclosures' => [$imageUrl, $download],
+                'content'    => <<<HTML
+<a href="{$url}">
+        <img loading="lazy" src="{$imageUrl}" alt="{$description}"/>
+</a>
+{$videoNote}
+{$moreContentNote}
+<p>{$description}<p>
+<p><a href="{$download}">Download</a></p>
+<p><a href="{$instagramURL}">Display on Instagram</a></p>
+HTML,
+                'uid' => $uid
+            ];
+        }
+    }
+
+    private function collectStories()
+    {
+        try {
+            $username = $this->getInput('u');
+            $html = getSimpleHTMLDOMCached(self::URI . 'api/media/?name=' . $username);
+            $json = Json::decode($html);
+
+            foreach ($json as $post) {
+                $url = $post['src'];
+                $imageUrl = $post['thumb'];
+                $download = $url;
+                $author = $username;
+                $uid = $url;
+                $title = 'Story - ' . $username;
+
+                $this->items[] = [
+                    'uri'        => $url,
+                    'author'     => $author,
+                    'title'      => $title,
+                    'thumbnail'  => $imageUrl,
+                    'enclosures' => [$imageUrl, $download],
+                    'content'    => <<<HTML
+    <a href="{$url}">
+            <img loading="lazy" src="{$imageUrl}" alt="story"/>
+    </a>
+    <p><a href="{$download}">Download</a></p>
+    HTML,
+                    'uid' => $uid
+                ];
+            }
+        } catch (Exception $e) {
+            // If it fails, it's because there are no stories, so don't do anything
+        }
+    }
+
+    private function collectTaggeds()
+    {
+        $username = $this->getInput('u');
+        try {
+            $html = getSimpleHTMLDOMCached(self::URI . 'tagged/' . $username . '/');
+            $html = defaultLinkTo($html, self::URI);
+
+            foreach ($html->find('div[class=item]') as $post) {
+                $url = $post->find('a', 1)->href;
+                $instagramURL = $this->convertURLToInstagram($url);
+                $fromURL = $post->find('div[class=username]', 0)->find('a', 0)->href;
+                $fromUsername = $post->find('div[class=username]', 0)->plaintext;
+                $date = $this->parseDate($post->find('div[class=time]', 0)->plaintext);
+                $description = $post->find('img', 0)->alt;
+                $imageUrl = $post->find('img', 0)->src;
+                $download = $post->find('a[class=download]', 0)->href;
+                $author = $fromUsername;
+                $uid = $post->find('a', 0)->href;
+                $title = 'Tagged - ' . $fromUsername . ' - ' . $this->descriptionToTitle($description);
+
+                // Checking post type
+                $isVideo = (bool) $post->find('i[class=video]', 0);
+                $videoNote = $isVideo ? '<p><i>(video)</i></p>' : '';
+
+                $isMoreContent = (bool) $post->find('svg', 0);
+                $moreContentNote = $isMoreContent ? '<p><i>(multiple images and/or videos)</i></p>' : '';
+
+
+                $this->items[] = [
+                    'uri'        => $url,
+                    'author'     => $author,
+                    'timestamp'  => $date,
+                    'title'      => $title,
+                    'thumbnail'  => $imageUrl,
+                    'enclosures' => [$imageUrl, $download],
+                    'content'    => <<<HTML
+<a href="{$url}">
+        <img loading="lazy" src="{$imageUrl}" alt="{$description}"/>
+</a>
+{$videoNote}
+{$moreContentNote}
+<p>From <a href="{$fromURL}">{$fromUsername}</a></p>
+<p>{$description}<p>
+<p><a href="{$download}">Download</a></p>
+<p><a href="{$instagramURL}">Display on Instagram</a></p>
+HTML,
+                    'uid' => $uid
+                ];
+            }
+        } catch (Exception $e) {
+            // If it fails, it's because the account was not tagged
+        }
+    }
+
+    // Parse date, and transform the date into a timetamp, even in a case of a relative date
+    private function parseDate($content)
+    {
+        $date = date_create();
+        $relativeDate = date_interval_create_from_date_string(str_replace(' ago', '', $content));
+        if ($relativeDate) {
+            date_sub($date, $relativeDate);
+        }
+        return date_format($date, 'r');
+    }
+
+    private function convertURLToInstagram($url)
+    {
+        return str_replace(self::URI, self::INSTAGRAMURI, $url);
+    }
+    private function descriptionToTitle($description)
+    {
+        return strlen($description) > 60 ? mb_substr($description, 0, 57) . '...' : $description;
+    }
+
+    public function getName()
+    {
+        if (!is_null($this->getInput('u'))) {
+            $types = [];
+            if ($this->getInput('post')) {
+                $types[] = 'Posts';
+            }
+            if ($this->getInput('story')) {
+                $types[] = 'Stories';
+            }
+            if ($this->getInput('tagged')) {
+                $types[] = 'Tags';
+            }
+            $typesText = $types[0];
+            if (count($types) > 1) {
+                for ($i = 1; $i < count($types) - 1; $i++) {
+                    $typesText .= ', ' . $types[$i];
+                }
+                $typesText .= ' & ' . $types[$i];
+            }
+
+            return 'Username ' . $this->getInput('u') . ' - ' . $typesText . ' - Imgsed Bridge';
+        }
+        return parent::getName();
+    }
+}

From 6254b8593e2f7636db65db23c1228482e38be44f Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 19 Jul 2023 05:05:49 +0200
Subject: [PATCH 023/716] refactor(cache): extract and encapsulate cache
 expiration logic (#3547)

* refactor(cache): extract and encapsulate cache expiration logic

* fix: logic bug in getSimpleHTMLDOMCached

* fix: silly me, index should of course be on the key column

* silly me again, PRIMARY keys get index by default lol

* comment out the delete portion in loadData

* remove a few log statements

* tweak twitter cache timeout
---
 actions/DisplayAction.php | 29 +++++++++++-----------
 bridges/DemoBridge.php    |  1 +
 bridges/SpotifyBridge.php | 17 +++++--------
 bridges/TwitterBridge.php |  6 +----
 caches/FileCache.php      | 30 ++++++++++++++---------
 caches/MemcachedCache.php | 51 ++++++++++++++++++++-------------------
 caches/NullCache.php      |  4 +--
 caches/SQLiteCache.php    | 40 ++++++++++++++++++------------
 lib/BridgeAbstract.php    | 22 ++++-------------
 lib/CacheInterface.php    |  4 +--
 lib/TwitterClient.php     | 15 ++++++------
 lib/contents.php          | 42 ++++++++++++--------------------
 12 files changed, 124 insertions(+), 137 deletions(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 91cfb95f..157937fb 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -90,36 +90,34 @@ class DisplayAction implements ActionInterface
         $cache = RssBridge::getCache();
         $cache->setScope('');
         $cache->setKey($cache_params);
-        // This cache purge will basically delete all cache items older than 24h, regardless of scope and key
-        $cache->purgeCache(86400);
 
         $items = [];
         $infos = [];
-        $mtime = $cache->getTime();
+
+        $feed = $cache->loadData($cacheTimeout);
 
         if (
-            $mtime
-            && (time() - $cacheTimeout < $mtime)
+            $feed
             && !Debug::isEnabled()
         ) {
-            // At this point we found the feed in the cache and debug mode is disabled
-
             if (isset($_SERVER['HTTP_IF_MODIFIED_SINCE'])) {
+                $modificationTime = $cache->getTime();
                 // The client wants to know if the feed has changed since its last check
-                $stime = strtotime($_SERVER['HTTP_IF_MODIFIED_SINCE']);
-                if ($mtime <= $stime) {
-                    $lastModified2 = gmdate('D, d M Y H:i:s ', $mtime) . 'GMT';
+                $modifiedSince = strtotime($_SERVER['HTTP_IF_MODIFIED_SINCE']);
+                if ($modificationTime <= $modifiedSince) {
+                    $lastModified2 = gmdate('D, d M Y H:i:s ', $modificationTime) . 'GMT';
                     return new Response('', 304, ['Last-Modified' => $lastModified2]);
                 }
             }
 
-            // Load the feed from cache and prepare it
-            $cached = $cache->loadData();
-            if (isset($cached['items']) && isset($cached['extraInfos'])) {
-                foreach ($cached['items'] as $item) {
+            if (
+                isset($feed['items'])
+                && isset($feed['extraInfos'])
+            ) {
+                foreach ($feed['items'] as $item) {
                     $items[] = new FeedItem($item);
                 }
-                $infos = $cached['extraInfos'];
+                $infos = $feed['extraInfos'];
             }
         } else {
             // At this point we did NOT find the feed in the cache or debug mode is enabled.
@@ -173,6 +171,7 @@ class DisplayAction implements ActionInterface
                 }, $items),
                 'extraInfos' => $infos
             ]);
+            $cache->purgeCache();
         }
 
         $format->setItems($items);
diff --git a/bridges/DemoBridge.php b/bridges/DemoBridge.php
index 06ec4e1e..15ab7377 100644
--- a/bridges/DemoBridge.php
+++ b/bridges/DemoBridge.php
@@ -6,6 +6,7 @@ class DemoBridge extends BridgeAbstract
     const NAME = 'DemoBridge';
     const URI = 'http://github.com/rss-bridge/rss-bridge';
     const DESCRIPTION = 'Bridge used for demos';
+    const CACHE_TIMEOUT = 15;
 
     const PARAMETERS = [
         'testCheckbox' => [
diff --git a/bridges/SpotifyBridge.php b/bridges/SpotifyBridge.php
index 169075e2..7b7e2b1d 100644
--- a/bridges/SpotifyBridge.php
+++ b/bridges/SpotifyBridge.php
@@ -282,14 +282,10 @@ class SpotifyBridge extends BridgeAbstract
         $cacheKey = sprintf('%s:%s', $this->getInput('clientid'), $this->getInput('clientsecret'));
         $cache->setScope('SpotifyBridge');
         $cache->setKey([$cacheKey]);
-
-        $time = null;
-        if ($cache->getTime()) {
-            $time = (new DateTime())->getTimestamp() - $cache->getTime();
-        }
-
-        if (!$cache->getTime() || $time >= 3600) {
-            // fetch token
+        $token = $cache->loadData(3600);
+        if ($token) {
+            $this->token = $token;
+        } else {
             $basicAuth = base64_encode(sprintf('%s:%s', $this->getInput('clientid'), $this->getInput('clientsecret')));
             $json = getContents('https://accounts.spotify.com/api/token', [
                 "Authorization: Basic $basicAuth"
@@ -298,10 +294,9 @@ class SpotifyBridge extends BridgeAbstract
             ]);
             $data = Json::decode($json);
             $this->token = $data['access_token'];
-
+            $cache->setScope('SpotifyBridge');
+            $cache->setKey([$cacheKey]);
             $cache->saveData($this->token);
-        } else {
-            $this->token = $cache->loadData();
         }
     }
 
diff --git a/bridges/TwitterBridge.php b/bridges/TwitterBridge.php
index befb8064..f0f0ee52 100644
--- a/bridges/TwitterBridge.php
+++ b/bridges/TwitterBridge.php
@@ -7,7 +7,7 @@ class TwitterBridge extends BridgeAbstract
     const API_URI = 'https://api.twitter.com';
     const GUEST_TOKEN_USES = 100;
     const GUEST_TOKEN_EXPIRY = 10800; // 3hrs
-    const CACHE_TIMEOUT = 300; // 5min
+    const CACHE_TIMEOUT = 60 * 15; // 15min
     const DESCRIPTION = 'returns tweets';
     const MAINTAINER = 'arnd-s';
     const PARAMETERS = [
@@ -224,10 +224,6 @@ EOD
         switch ($this->queriedContext) {
             case 'By username':
                 $cache = RssBridge::getCache();
-                $cache->setScope('twitter');
-                $cache->setKey(['cache']);
-                // todo: inspect mtime instead of purging with 3h
-                $cache->purgeCache(60 * 60 * 3);
                 $api = new TwitterClient($cache);
 
                 $screenName = $this->getInput('u');
diff --git a/caches/FileCache.php b/caches/FileCache.php
index a4f48962..6e150cb4 100644
--- a/caches/FileCache.php
+++ b/caches/FileCache.php
@@ -1,5 +1,8 @@
 <?php
 
+/**
+ * @link https://www.php.net/manual/en/function.clearstatcache.php
+ */
 class FileCache implements CacheInterface
 {
     private array $config;
@@ -25,18 +28,25 @@ class FileCache implements CacheInterface
         return $this->config;
     }
 
-    public function loadData()
+    public function loadData(int $timeout = 86400)
     {
+        clearstatcache();
         if (!file_exists($this->getCacheFile())) {
             return null;
         }
-        $data = unserialize(file_get_contents($this->getCacheFile()));
-        if ($data === false) {
-            // Intentionally not throwing an exception
-            Logger::warning(sprintf('Failed to unserialize: %s', $this->getCacheFile()));
-            return null;
+        $modificationTime = filemtime($this->getCacheFile());
+        if (time() - $timeout < $modificationTime) {
+            $data = unserialize(file_get_contents($this->getCacheFile()));
+            if ($data === false) {
+                Logger::warning(sprintf('Failed to unserialize: %s', $this->getCacheFile()));
+                // Intentionally not throwing an exception
+                return null;
+            }
+            return $data;
         }
-        return $data;
+        // It's a good idea to delete the expired item here, but commented out atm
+        // unlink($this->getCacheFile());
+        return null;
     }
 
     public function saveData($data): void
@@ -49,9 +59,7 @@ class FileCache implements CacheInterface
 
     public function getTime(): ?int
     {
-        // https://www.php.net/manual/en/function.clearstatcache.php
         clearstatcache();
-
         $cacheFile = $this->getCacheFile();
         if (file_exists($cacheFile)) {
             $time = filemtime($cacheFile);
@@ -64,7 +72,7 @@ class FileCache implements CacheInterface
         return null;
     }
 
-    public function purgeCache(int $seconds): void
+    public function purgeCache(int $timeout = 86400): void
     {
         if (! $this->config['enable_purge']) {
             return;
@@ -90,7 +98,7 @@ class FileCache implements CacheInterface
                 continue;
             } elseif ($cacheFile->isFile()) {
                 $filepath = $cacheFile->getPathname();
-                if (filemtime($filepath) < time() - $seconds) {
+                if (filemtime($filepath) < time() - $timeout) {
                     // todo: sometimes this file doesn't exists
                     unlink($filepath);
                 }
diff --git a/caches/MemcachedCache.php b/caches/MemcachedCache.php
index 8cd1932b..afc654ea 100644
--- a/caches/MemcachedCache.php
+++ b/caches/MemcachedCache.php
@@ -6,8 +6,6 @@ class MemcachedCache implements CacheInterface
     private string $key;
     private $conn;
     private $expiration = 0;
-    private $time = null;
-    private $data = null;
 
     public function __construct()
     {
@@ -43,50 +41,53 @@ class MemcachedCache implements CacheInterface
         $this->conn = $conn;
     }
 
-    public function loadData()
+    public function loadData(int $timeout = 86400)
     {
-        if ($this->data) {
-            return $this->data;
-        }
-        $result = $this->conn->get($this->getCacheKey());
-        if ($result === false) {
+        $value = $this->conn->get($this->getCacheKey());
+        if ($value === false) {
             return null;
         }
-
-        $this->time = $result['time'];
-        $this->data = $result['data'];
-        return $result['data'];
+        if (time() - $timeout < $value['time']) {
+            return $value['data'];
+        }
+        return null;
     }
 
     public function saveData($data): void
     {
-        $time = time();
-        $object_to_save = [
+        $value = [
             'data' => $data,
-            'time' => $time,
+            'time' => time(),
         ];
-        $result = $this->conn->set($this->getCacheKey(), $object_to_save, $this->expiration);
-
+        $result = $this->conn->set($this->getCacheKey(), $value, $this->expiration);
         if ($result === false) {
-            throw new \Exception('Cannot write the cache to memcached server');
+            Logger::warning('Failed to store an item in memcached', [
+                'scope'         => $this->scope,
+                'key'           => $this->key,
+                'expiration'    => $this->expiration,
+                'code'          => $this->conn->getLastErrorCode(),
+                'message'       => $this->conn->getLastErrorMessage(),
+                'number'        => $this->conn->getLastErrorErrno(),
+            ]);
+            // Intentionally not throwing an exception
         }
-
-        $this->time = $time;
     }
 
     public function getTime(): ?int
     {
-        if ($this->time === null) {
-            $this->loadData();
+        $value = $this->conn->get($this->getCacheKey());
+        if ($value === false) {
+            return null;
         }
-        return $this->time;
+        return $value['time'];
     }
 
-    public function purgeCache(int $seconds): void
+    public function purgeCache(int $timeout = 86400): void
     {
+        $this->conn->flush();
         // Note: does not purges cache right now
         // Just sets cache expiration and leave cache purging for memcached itself
-        $this->expiration = $seconds;
+        $this->expiration = $timeout;
     }
 
     public function setScope(string $scope): void
diff --git a/caches/NullCache.php b/caches/NullCache.php
index 1a01df2f..fe43fe06 100644
--- a/caches/NullCache.php
+++ b/caches/NullCache.php
@@ -12,7 +12,7 @@ class NullCache implements CacheInterface
     {
     }
 
-    public function loadData()
+    public function loadData(int $timeout = 86400)
     {
     }
 
@@ -25,7 +25,7 @@ class NullCache implements CacheInterface
         return null;
     }
 
-    public function purgeCache(int $seconds): void
+    public function purgeCache(int $timeout = 86400): void
     {
     }
 }
diff --git a/caches/SQLiteCache.php b/caches/SQLiteCache.php
index f9258a88..d7ab1374 100644
--- a/caches/SQLiteCache.php
+++ b/caches/SQLiteCache.php
@@ -29,27 +29,37 @@ class SQLiteCache implements CacheInterface
             $this->db = new \SQLite3($config['file']);
             $this->db->enableExceptions(true);
             $this->db->exec("CREATE TABLE storage ('key' BLOB PRIMARY KEY, 'value' BLOB, 'updated' INTEGER)");
-            $this->db->exec('CREATE INDEX idx_storage_updated ON storage (updated)');
         }
         $this->db->busyTimeout($config['timeout']);
     }
 
-    public function loadData()
+    public function loadData(int $timeout = 86400)
     {
-        $stmt = $this->db->prepare('SELECT value FROM storage WHERE key = :key');
+        $stmt = $this->db->prepare('SELECT value, updated FROM storage WHERE key = :key');
         $stmt->bindValue(':key', $this->getCacheKey());
         $result = $stmt->execute();
-        if ($result) {
-            $row = $result->fetchArray(\SQLITE3_ASSOC);
-            if ($row !== false) {
-                $blob = $row['value'];
-                $data = unserialize($blob);
-                if ($data !== false) {
-                    return $data;
-                }
-                Logger::error(sprintf("Failed to unserialize: '%s'", mb_substr($blob, 0, 100)));
-            }
+        if (!$result) {
+            return null;
         }
+        $row = $result->fetchArray(\SQLITE3_ASSOC);
+        if ($row === false) {
+            return null;
+        }
+        $value = $row['value'];
+        $modificationTime = $row['updated'];
+        if (time() - $timeout < $modificationTime) {
+            $data = unserialize($value);
+            if ($data === false) {
+                Logger::error(sprintf("Failed to unserialize: '%s'", mb_substr($value, 0, 100)));
+                return null;
+            }
+            return $data;
+        }
+        // It's a good idea to delete expired cache items.
+        // However I'm seeing lots of  SQLITE_BUSY errors so commented out for now
+        // $stmt = $this->db->prepare('DELETE FROM storage WHERE key = :key');
+        // $stmt->bindValue(':key', $this->getCacheKey());
+        // $stmt->execute();
         return null;
     }
 
@@ -78,13 +88,13 @@ class SQLiteCache implements CacheInterface
         return null;
     }
 
-    public function purgeCache(int $seconds): void
+    public function purgeCache(int $timeout = 86400): void
     {
         if (!$this->config['enable_purge']) {
             return;
         }
         $stmt = $this->db->prepare('DELETE FROM storage WHERE updated < :expired');
-        $stmt->bindValue(':expired', time() - $seconds);
+        $stmt->bindValue(':expired', time() - $timeout);
         $stmt->execute();
     }
 
diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index f024393d..eb9d5a3c 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -409,26 +409,15 @@ abstract class BridgeAbstract implements BridgeInterface
     /**
      * Loads a cached value for the specified key
      *
-     * @param int $duration Cache duration (optional)
+     * @param int $timeout Cache duration (optional)
      * @return mixed Cached value or null if the key doesn't exist or has expired
      */
-    protected function loadCacheValue(string $key, $duration = null)
+    protected function loadCacheValue(string $key, int $timeout = 86400)
     {
         $cache = RssBridge::getCache();
-        // Create class name without the namespace part
-        $scope = $this->getShortName();
-        $cache->setScope($scope);
+        $cache->setScope($this->getShortName());
         $cache->setKey([$key]);
-        $timestamp = $cache->getTime();
-
-        if (
-            $duration
-            && $timestamp
-            && $timestamp < time() - $duration
-        ) {
-            return null;
-        }
-        return $cache->loadData();
+        return $cache->loadData($timeout);
     }
 
     /**
@@ -439,8 +428,7 @@ abstract class BridgeAbstract implements BridgeInterface
     protected function saveCacheValue(string $key, $value)
     {
         $cache = RssBridge::getCache();
-        $scope = $this->getShortName();
-        $cache->setScope($scope);
+        $cache->setScope($this->getShortName());
         $cache->setKey([$key]);
         $cache->saveData($value);
     }
diff --git a/lib/CacheInterface.php b/lib/CacheInterface.php
index 414a9c84..85aa830f 100644
--- a/lib/CacheInterface.php
+++ b/lib/CacheInterface.php
@@ -6,11 +6,11 @@ interface CacheInterface
 
     public function setKey(array $key): void;
 
-    public function loadData();
+    public function loadData(int $timeout = 86400);
 
     public function saveData($data): void;
 
     public function getTime(): ?int;
 
-    public function purgeCache(int $seconds): void;
+    public function purgeCache(int $timeout = 86400): void;
 }
diff --git a/lib/TwitterClient.php b/lib/TwitterClient.php
index cdedcbc1..341610a4 100644
--- a/lib/TwitterClient.php
+++ b/lib/TwitterClient.php
@@ -11,8 +11,13 @@ class TwitterClient
     public function __construct(CacheInterface $cache)
     {
         $this->cache = $cache;
-        $this->authorization = 'AAAAAAAAAAAAAAAAAAAAAGHtAgAAAAAA%2Bx7ILXNILCqkSGIzy6faIHZ9s3Q%3DQy97w6SIrzE7lQwPJEYQBsArEE2fC25caFwRBvAGi456G09vGR';
+
+        $cache->setScope('twitter');
+        $cache->setKey(['cache']);
+        $cache->purgeCache(60 * 60 * 3);
+
         $this->data = $this->cache->loadData() ?? [];
+        $this->authorization = 'AAAAAAAAAAAAAAAAAAAAAGHtAgAAAAAA%2Bx7ILXNILCqkSGIzy6faIHZ9s3Q%3DQy97w6SIrzE7lQwPJEYQBsArEE2fC25caFwRBvAGi456G09vGR';
     }
 
     public function fetchUserTweets(string $screenName): \stdClass
@@ -22,7 +27,6 @@ class TwitterClient
             $userInfo = $this->fetchUserInfoByScreenName($screenName);
         } catch (HttpException $e) {
             if ($e->getCode() === 403) {
-                Logger::info('The guest token has expired');
                 $this->data['guest_token'] = null;
                 $this->fetchGuestToken();
                 $userInfo = $this->fetchUserInfoByScreenName($screenName);
@@ -35,7 +39,6 @@ class TwitterClient
             $timeline = $this->fetchTimeline($userInfo->rest_id);
         } catch (HttpException $e) {
             if ($e->getCode() === 403) {
-                Logger::info('The guest token has expired');
                 $this->data['guest_token'] = null;
                 $this->fetchGuestToken();
                 $timeline = $this->fetchTimeline($userInfo->rest_id);
@@ -88,7 +91,6 @@ class TwitterClient
     private function fetchGuestToken(): void
     {
         if (isset($this->data['guest_token'])) {
-            Logger::info('Reusing cached guest token: ' . $this->data['guest_token']);
             return;
         }
         $url = 'https://api.twitter.com/1.1/guest/activate.json';
@@ -99,7 +101,6 @@ class TwitterClient
         $this->cache->setScope('twitter');
         $this->cache->setKey(['cache']);
         $this->cache->saveData($this->data);
-        Logger::info("Fetch new guest token: $guest_token");
     }
 
     private function fetchUserInfoByScreenName(string $screenName)
@@ -115,7 +116,7 @@ class TwitterClient
             'https://twitter.com/i/api/graphql/hc-pka9A7gyS3xODIafnrQ/UserByScreenName?variables=%s',
             urlencode(json_encode($variables))
         );
-        $response = json_decode(getContents($url, $this->createHttpHeaders()));
+        $response = Json::decode(getContents($url, $this->createHttpHeaders()), false);
         if (isset($response->errors)) {
             // Grab the first error message
             throw new \Exception(sprintf('From twitter api: "%s"', $response->errors[0]->message));
@@ -168,7 +169,7 @@ class TwitterClient
             urlencode(json_encode($variables)),
             urlencode(json_encode($features))
         );
-        $response = json_decode(getContents($url, $this->createHttpHeaders()));
+        $response = Json::decode(getContents($url, $this->createHttpHeaders()), false);
         return $response;
     }
 
diff --git a/lib/contents.php b/lib/contents.php
index b6b74539..454f2066 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -100,9 +100,6 @@ function getContents(
     bool $returnFull = false
 ) {
     $httpClient = RssBridge::getHttpClient();
-    $cache = RssBridge::getCache();
-    $cache->setScope('server');
-    $cache->setKey([$url]);
 
     // Snagged from https://github.com/lwthiker/curl-impersonate/blob/main/firefox/curl_ff102
     $defaultHttpHeaders = [
@@ -138,6 +135,11 @@ function getContents(
     if (Configuration::getConfig('proxy', 'url') && !defined('NOPROXY')) {
         $config['proxy'] = Configuration::getConfig('proxy', 'url');
     }
+
+    $cache = RssBridge::getCache();
+    $cache->setScope('server');
+    $cache->setKey([$url]);
+
     if (!Debug::isEnabled() && $cache->getTime()) {
         $config['if_not_modified_since'] = $cache->getTime();
     }
@@ -384,7 +386,7 @@ function getSimpleHTMLDOM(
  * _Notice_: Cached contents are forcefully removed after 24 hours (86400 seconds).
  *
  * @param string $url The URL.
- * @param int $duration Cache duration in seconds.
+ * @param int $timeout Cache duration in seconds.
  * @param array $header (optional) A list of cURL header.
  * For more information follow the links below.
  * * https://php.net/manual/en/function.curl-setopt.php
@@ -409,7 +411,7 @@ function getSimpleHTMLDOM(
  */
 function getSimpleHTMLDOMCached(
     $url,
-    $duration = 86400,
+    $timeout = 86400,
     $header = [],
     $opts = [],
     $lowercase = true,
@@ -422,29 +424,15 @@ function getSimpleHTMLDOMCached(
     $cache = RssBridge::getCache();
     $cache->setScope('pages');
     $cache->setKey([$url]);
-
-    // Determine if cached file is within duration
-    $time = $cache->getTime();
-    if (
-        $time
-        && time() - $duration < $time
-        && !Debug::isEnabled()
-    ) {
-        // Cache hit
-        $content = $cache->loadData();
-    } else {
-        $content = getContents(
-            $url,
-            $header ?? [],
-            $opts ?? []
-        );
-        if ($content) {
-            $cache->setScope('pages');
-            $cache->setKey([$url]);
-            $cache->saveData($content);
-        }
+    $content = $cache->loadData($timeout);
+    if (!$content || Debug::isEnabled()) {
+        $content = getContents($url, $header ?? [], $opts ?? []);
+    }
+    if ($content) {
+        $cache->setScope('pages');
+        $cache->setKey([$url]);
+        $cache->saveData($content);
     }
-
     return str_get_html(
         $content,
         $lowercase,

From f91723d9e5b3880122bafc365411a4ff6f5bbda1 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 19 Jul 2023 05:18:26 +0200
Subject: [PATCH 024/716] fix(memcached): do not flush entire cache, oops
 (#3551)

---
 caches/MemcachedCache.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/caches/MemcachedCache.php b/caches/MemcachedCache.php
index afc654ea..dcb572c7 100644
--- a/caches/MemcachedCache.php
+++ b/caches/MemcachedCache.php
@@ -84,7 +84,6 @@ class MemcachedCache implements CacheInterface
 
     public function purgeCache(int $timeout = 86400): void
     {
-        $this->conn->flush();
         // Note: does not purges cache right now
         // Just sets cache expiration and leave cache purging for memcached itself
         $this->expiration = $timeout;

From a4a328583a1870fc3cb2617d46072d54553402f0 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 19 Jul 2023 06:39:17 +0200
Subject: [PATCH 025/716] fix(reddit): set custom http ua to fix 429 errors
 (#3552)

* refactor

* refactor

* fix(reddit): set custom http ua to fix 429 errors

* lint
---
 bridges/RedditBridge.php | 108 ++++++++++++++++++++-------------------
 1 file changed, 56 insertions(+), 52 deletions(-)

diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index de80f09d..86d7884b 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -73,47 +73,6 @@ class RedditBridge extends BridgeAbstract
         ]
     ];
 
-    public function detectParameters($url)
-    {
-        $parsed_url = parse_url($url);
-
-        $host = $parsed_url['host'] ?? null;
-
-        if ($host != 'www.reddit.com' && $host != 'old.reddit.com') {
-            return null;
-        }
-
-        $path = explode('/', $parsed_url['path']);
-
-        if ($path[1] == 'r') {
-            return [
-                'r' => $path[2]
-            ];
-        } elseif ($path[1] == 'user') {
-            return [
-                'u' => $path[2]
-            ];
-        } else {
-            return null;
-        }
-    }
-
-    public function getIcon()
-    {
-        return 'https://www.redditstatic.com/desktop2x/img/favicon/favicon-96x96.png';
-    }
-
-    public function getName()
-    {
-        if ($this->queriedContext == 'single') {
-            return 'Reddit r/' . $this->getInput('r');
-        } elseif ($this->queriedContext == 'user') {
-            return 'Reddit u/' . $this->getInput('u');
-        } else {
-            return self::NAME;
-        }
-    }
-
     public function collectData()
     {
         $user = false;
@@ -152,18 +111,22 @@ class RedditBridge extends BridgeAbstract
 
         foreach ($subreddits as $subreddit) {
             $name = trim($subreddit);
-            $values = getContents(self::URI
-                    . '/search.json?q='
-                    . $keywords
-                    . $flair
-                    . ($user ? 'author%3A' : 'subreddit%3A')
-                    . $name
-                    . '&sort='
-                    . $this->getInput('d')
-                    . '&include_over_18=on');
-            $decodedValues = json_decode($values);
+            $url = self::URI
+                . '/search.json?q='
+                . $keywords
+                . $flair
+                . ($user ? 'author%3A' : 'subreddit%3A')
+                . $name
+                . '&sort='
+                . $this->getInput('d')
+                . '&include_over_18=on';
 
-            foreach ($decodedValues->data->children as $post) {
+            $version = 'v0.0.1';
+            $useragent = "rss-bridge $version (https://github.com/RSS-Bridge/rss-bridge)";
+            $json = getContents($url, ['User-Agent: ' . $useragent]);
+            $parsedJson = Json::decode($json, false);
+
+            foreach ($parsedJson->data->children as $post) {
                 if ($post->kind == 't1' && !$comments) {
                     continue;
                 }
@@ -288,6 +251,22 @@ class RedditBridge extends BridgeAbstract
         });
     }
 
+    public function getIcon()
+    {
+        return 'https://www.redditstatic.com/desktop2x/img/favicon/favicon-96x96.png';
+    }
+
+    public function getName()
+    {
+        if ($this->queriedContext == 'single') {
+            return 'Reddit r/' . $this->getInput('r');
+        } elseif ($this->queriedContext == 'user') {
+            return 'Reddit u/' . $this->getInput('u');
+        } else {
+            return self::NAME;
+        }
+    }
+
     private function encodePermalink($link)
     {
         return self::URI . implode(
@@ -307,4 +286,29 @@ class RedditBridge extends BridgeAbstract
     {
         return '<a href="' . $href . '">' . $text . '</a>';
     }
+
+    public function detectParameters($url)
+    {
+        $parsed_url = parse_url($url);
+
+        $host = $parsed_url['host'] ?? null;
+
+        if ($host != 'www.reddit.com' && $host != 'old.reddit.com') {
+            return null;
+        }
+
+        $path = explode('/', $parsed_url['path']);
+
+        if ($path[1] == 'r') {
+            return [
+                'r' => $path[2]
+            ];
+        } elseif ($path[1] == 'user') {
+            return [
+                'u' => $path[2]
+            ];
+        } else {
+            return null;
+        }
+    }
 }

From 93620aa1058e9aca6e3c7f7bd8458630cd478360 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 19 Jul 2023 22:05:26 +0200
Subject: [PATCH 026/716] fix(cache): bug in cache logic (#3553)

It is possible to have a cached item with a very old mtime but it's technically expired.

So, check for presence of time and whether the time it is within 10 days
---
 lib/contents.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/contents.php b/lib/contents.php
index 454f2066..12a98b0c 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -140,7 +140,7 @@ function getContents(
     $cache->setScope('server');
     $cache->setKey([$url]);
 
-    if (!Debug::isEnabled() && $cache->getTime()) {
+    if (!Debug::isEnabled() && $cache->getTime() && $cache->loadData(86400 * 7)) {
         $config['if_not_modified_since'] = $cache->getTime();
     }
 

From 517c7f5c9b003977aa7151b91c6e79342964c60f Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 19 Jul 2023 22:18:42 +0200
Subject: [PATCH 027/716] fix(cache): bug (#3554)

---
 lib/contents.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/contents.php b/lib/contents.php
index 12a98b0c..4429a75c 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -169,7 +169,7 @@ function getContents(
             break;
         case 304:
             // Not Modified
-            $response['body'] = $cache->loadData();
+            $response['body'] = $cache->loadData(86400 * 7);
             break;
         default:
             $exceptionMessage = sprintf(

From 2ffb54c7c2b961c83b0a876bd5d34f7d698c2b13 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pred=C3=A4?= <46051820+PredaaA@users.noreply.github.com>
Date: Thu, 20 Jul 2023 00:52:09 +0200
Subject: [PATCH 028/716] [PicukiBridge] Add count parameter (#3556)

---
 bridges/PicukiBridge.php | 34 +++++++++++++++++++++++++++-------
 1 file changed, 27 insertions(+), 7 deletions(-)

diff --git a/bridges/PicukiBridge.php b/bridges/PicukiBridge.php
index 7a4f9eb5..f1d45e2a 100644
--- a/bridges/PicukiBridge.php
+++ b/bridges/PicukiBridge.php
@@ -9,6 +9,14 @@ class PicukiBridge extends BridgeAbstract
     const DESCRIPTION = 'Returns Picuki (Instagram viewer) posts by user and by hashtag';
 
     const PARAMETERS = [
+        'global' => [
+            'count' => [
+                'name' => 'Count',
+                'type' => 'number',
+                'title' => 'How many posts to fetch',
+                'defaultValue' => 12
+            ]
+        ],
         'Username' => [
             'u' => [
                 'name' => 'username',
@@ -43,6 +51,13 @@ class PicukiBridge extends BridgeAbstract
         $re = '#let short_code = "(.*?)";\s*$#m';
         $html = getSimpleHTMLDOM($this->getURI());
 
+        $requestedCount = $this->getInput('count');
+        if ($requestedCount > 12) {
+            // Picuki shows 12 posts per page at initial load.
+            throw new \Exception('Maximum count is 12');
+        }
+
+        $count = 0;
         foreach ($html->find('.box-photos .box-photo') as $element) {
             // skip ad items
             if (in_array('adv', explode(' ', $element->class))) {
@@ -86,14 +101,19 @@ class PicukiBridge extends BridgeAbstract
                 'source'     => $sourceUrl,
                 'enclosures' => [$imageUrl],
                 'content'    => <<<HTML
-<a href="{$url}">
-	<img loading="lazy" src="{$imageUrl}" />
-</a>
-<a href="{$sourceUrl}">{$sourceUrl}</a>
-{$videoNote}
-<p>{$description}<p>
-HTML
+                    <a href="{$url}">
+                        <img loading="lazy" src="{$imageUrl}" />
+                    </a>
+                    <a href="{$sourceUrl}">{$sourceUrl}</a>
+                    {$videoNote}
+                    <p>{$description}<p>
+                    HTML
             ];
+
+            $count++;
+            if ($count >= $requestedCount) {
+                break;
+            }
         }
     }
 

From 663729cf19da206e62cb65ddc4fdb151c66b3498 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pred=C3=A4?= <46051820+PredaaA@users.noreply.github.com>
Date: Thu, 20 Jul 2023 05:50:45 +0200
Subject: [PATCH 029/716] [TikTokBridge] Use another way to get videos infos to
 include video link (#3557)

* [TikTokBridge] Use another way to get videos infos to include video link

* [TikTokBridge] Use cover if dynamicCover is empty

* [TikTokBridge] Add support for the rest of item params
---
 bridges/TikTokBridge.php | 42 ++++++++++++++++++++++------------------
 1 file changed, 23 insertions(+), 19 deletions(-)

diff --git a/bridges/TikTokBridge.php b/bridges/TikTokBridge.php
index 1a30570d..e7cac825 100644
--- a/bridges/TikTokBridge.php
+++ b/bridges/TikTokBridge.php
@@ -33,32 +33,36 @@ class TikTokBridge extends BridgeAbstract
         $title = $html->find('h1', 0)->plaintext ?? self::NAME;
         $this->feedName = htmlspecialchars_decode($title);
 
-        foreach ($html->find('div.tiktok-x6y88p-DivItemContainerV2') as $div) {
+        $SIGI_STATE_RAW = $html->find('script[id=SIGI_STATE]', 0)->innertext;
+        $SIGI_STATE = json_decode($SIGI_STATE_RAW);
+
+        foreach ($SIGI_STATE->ItemModule as $key => $value) {
             $item = [];
 
-            // todo: find proper link to tiktok item
-            $link = $div->find('a', 0)->href;
-
-            $image = $div->find('img', 0)->src ?? '';
-
-            $views = $div->find('strong.video-count', 0)->plaintext;
-
-            if ($link === 'https://www.tiktok.com/') {
-                $link = $this->getURI();
+            $link = 'https://www.tiktok.com/@' . $value->author . '/video/' . $value->id;
+            $image = $value->video->dynamicCover;
+            if (empty($image)) {
+                $image = $value->video->cover;
             }
+            $views = $value->stats->playCount;
+            $hastags = [];
+            foreach ($value->textExtra as $tag) {
+                $hastags[] = $tag->hashtagName;
+            }
+            $hastags_str = '';
+            foreach ($hastags as $tag) {
+                $hastags_str .= '<a href="https://www.tiktok.com/tag/' . $tag . '">#' . $tag . '</a> ';
+            }
+
             $item['uri'] = $link;
-
-            $a = $div->find('a', 1);
-            if ($a) {
-                $item['title'] = $a->plaintext;
-            } else {
-                $item['title'] = $this->getName();
-            }
+            $item['title'] = $value->desc;
+            $item['timestamp'] = $value->createTime;
+            $item['author'] = '@' . $value->author;
             $item['enclosures'][] = $image;
-
+            $item['categories'] = $hastags;
             $item['content'] = <<<EOD
 <a href="{$link}"><img src="{$image}"/></a>
-<p>{$views} views<p>
+<p>{$views} views<p><br/>Hashtags: {$hastags_str}
 EOD;
 
             $this->items[] = $item;

From 0a118310cb123460e49778ec74791cb2d0b6ba6f Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 20 Jul 2023 19:11:13 +0200
Subject: [PATCH 030/716] fix(sqlitecache): store blob as blob (#3555)

serialize() can return output with null bytes and other
non-text data. The prior behavior truncated data
which later results in unserialize() errors.

This happens when e.g. caching an object with a private field
or when caching e.g. a JPEG file (starts with 0xFFD8FFE1)

Fixes errors such as e.g.:

unserialize(): Error at offset 20 of 24 bytes at caches/SQLiteCache.php line 51
---
 caches/SQLiteCache.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/caches/SQLiteCache.php b/caches/SQLiteCache.php
index d7ab1374..92235862 100644
--- a/caches/SQLiteCache.php
+++ b/caches/SQLiteCache.php
@@ -69,7 +69,7 @@ class SQLiteCache implements CacheInterface
 
         $stmt = $this->db->prepare('INSERT OR REPLACE INTO storage (key, value, updated) VALUES (:key, :value, :updated)');
         $stmt->bindValue(':key', $this->getCacheKey());
-        $stmt->bindValue(':value', $blob);
+        $stmt->bindValue(':value', $blob, \SQLITE3_BLOB);
         $stmt->bindValue(':updated', time());
         $stmt->execute();
     }

From d08b2616ef1adfa69edc10f42e4e7fcb0c9226cb Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 21 Jul 2023 20:26:22 +0200
Subject: [PATCH 031/716] feat(twitter): use account icon as feed icon, fix
 #3348 (#3561)

---
 bridges/TwitterBridge.php | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/bridges/TwitterBridge.php b/bridges/TwitterBridge.php
index f0f0ee52..189203bd 100644
--- a/bridges/TwitterBridge.php
+++ b/bridges/TwitterBridge.php
@@ -124,6 +124,7 @@ EOD
     private $apiKey     = null;
     private $guestToken = null;
     private $authHeaders = [];
+    private ?string $feedIconUrl = null;
 
     public function detectParameters($url)
     {
@@ -309,6 +310,10 @@ EOD
             }
         }
 
+        if ($this->queriedContext === 'By username') {
+            $this->feedIconUrl = $data->user_info->legacy->profile_image_url_https ?? null;
+        }
+
         foreach ($tweets as $tweet) {
             // Skip own Retweets...
             if (isset($tweet->retweeted_status) && $tweet->retweeted_status->user->id_str === $tweet->user->id_str) {
@@ -497,6 +502,11 @@ EOD;
         usort($this->items, ['TwitterBridge', 'compareTweetId']);
     }
 
+    public function getIcon()
+    {
+        return $this->feedIconUrl ?? parent::getIcon();
+    }
+
     private static function compareTweetId($tweet1, $tweet2)
     {
         return (intval($tweet1['id']) < intval($tweet2['id']) ? 1 : -1);

From 39a8346c53997551f0aa68392a1e9387106a356a Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 21 Jul 2023 20:52:20 +0200
Subject: [PATCH 032/716] fix(pokemonnews): throw if antibot, #3327 (#3562)

---
 bridges/PokemonNewsBridge.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/bridges/PokemonNewsBridge.php b/bridges/PokemonNewsBridge.php
index 954e584c..3dacb163 100644
--- a/bridges/PokemonNewsBridge.php
+++ b/bridges/PokemonNewsBridge.php
@@ -14,7 +14,10 @@ final class PokemonNewsBridge extends BridgeAbstract
         // todo: parse json api instead: https://www.pokemon.com/api/1/us/news/get-news.json
         $url = 'https://www.pokemon.com/us/pokemon-news';
         $dom = getSimpleHTMLDOM($url);
-
+        $haystack = (string)$dom;
+        if (str_contains($haystack, 'Request unsuccessful. Incapsula incident')) {
+            throw new \Exception('Blocked by anti-bot');
+        }
         foreach ($dom->find('.news-list ul li') as $item) {
             $title = $item->find('h3', 0)->plaintext;
             $description = $item->find('p.hidden-mobile', 0);

From 38ca124de0886de6e808d1a21526f04f47343326 Mon Sep 17 00:00:00 2001
From: Eugene Molotov <eugene.molotov@yandex.ru>
Date: Sat, 22 Jul 2023 17:00:12 +0500
Subject: [PATCH 033/716] [VkBridge] Better title generation (#3563)

1. Use first parargraph only
2. Remove tags
3. Allow to use comma and colon in title
---
 bridges/VkBridge.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/bridges/VkBridge.php b/bridges/VkBridge.php
index 0cd2fba8..c5a9d4cc 100644
--- a/bridges/VkBridge.php
+++ b/bridges/VkBridge.php
@@ -448,7 +448,9 @@ class VkBridge extends BridgeAbstract
 
     private function getTitle($content)
     {
-        preg_match('/^["\w\ \p{L}\(\)\?#«»-]+/mu', htmlspecialchars_decode($content), $result);
+        $content = explode('<br>', $content)[0];
+        $content = strip_tags($content);
+        preg_match('/^[:,"\w\ \p{L}\(\)\?#«»-]+/mu', htmlspecialchars_decode($content), $result);
         if (count($result) == 0) {
             return 'untitled';
         }

From 74635fd752b4421760b4b80fb058c8488d608b8d Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 23 Jul 2023 23:05:35 +0200
Subject: [PATCH 034/716] fix(DisplayAction): improve error handling and cache
 logic (#3558)

* fix(DisplayAction): improve error handling and cache logic

* restore prev timeouts

* refactor

* yup

* test: fix unit test

* leave twitter client unchanged

* leave twitter bridge unchanged
---
 actions/DisplayAction.php      | 126 +++++++++++++++++++--------------
 bridges/GoogleSearchBridge.php |   2 +-
 lib/contents.php               |   5 ++
 lib/utils.php                  |   6 +-
 4 files changed, 81 insertions(+), 58 deletions(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 157937fb..129d4587 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -1,27 +1,38 @@
 <?php
 
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
 class DisplayAction implements ActionInterface
 {
+    private CacheInterface $cache;
+
     public function execute(array $request)
     {
         if (Configuration::getConfig('system', 'enable_maintenance_mode')) {
             return new Response('503 Service Unavailable', 503);
         }
+        $this->cache = RssBridge::getCache();
+        $this->cache->setScope('http');
+        $this->cache->setKey($request);
+        // avg timeout of 20m
+        $timeout = 60 * 15 + rand(1, 60 * 10);
+        /** @var Response $cachedResponse */
+        $cachedResponse = $this->cache->loadData($timeout);
+        if ($cachedResponse && !Debug::isEnabled()) {
+            //Logger::info(sprintf('Returning cached (http) response: %s', $cachedResponse->getBody()));
+            return $cachedResponse;
+        }
+        $response = $this->createResponse($request);
+        if (in_array($response->getCode(), [429, 503])) {
+            //Logger::info(sprintf('Storing cached (http) response: %s', $response->getBody()));
+            $this->cache->setScope('http');
+            $this->cache->setKey($request);
+            $this->cache->saveData($response);
+        }
+        return $response;
+    }
 
+    private function createResponse(array $request)
+    {
         $bridgeFactory = new BridgeFactory();
-
         $bridgeClassName = $bridgeFactory->createBridgeClassName($request['bridge'] ?? '');
 
         $format = $request['format'] ?? null;
@@ -87,46 +98,36 @@ class DisplayAction implements ActionInterface
             )
         );
 
-        $cache = RssBridge::getCache();
-        $cache->setScope('');
-        $cache->setKey($cache_params);
+        $this->cache->setScope('');
+        $this->cache->setKey($cache_params);
 
         $items = [];
         $infos = [];
 
-        $feed = $cache->loadData($cacheTimeout);
+        $feed = $this->cache->loadData($cacheTimeout);
 
-        if (
-            $feed
-            && !Debug::isEnabled()
-        ) {
+        if ($feed && !Debug::isEnabled()) {
             if (isset($_SERVER['HTTP_IF_MODIFIED_SINCE'])) {
-                $modificationTime = $cache->getTime();
+                $modificationTime = $this->cache->getTime();
                 // The client wants to know if the feed has changed since its last check
                 $modifiedSince = strtotime($_SERVER['HTTP_IF_MODIFIED_SINCE']);
                 if ($modificationTime <= $modifiedSince) {
-                    $lastModified2 = gmdate('D, d M Y H:i:s ', $modificationTime) . 'GMT';
-                    return new Response('', 304, ['Last-Modified' => $lastModified2]);
+                    $modificationTimeGMT = gmdate('D, d M Y H:i:s ', $modificationTime);
+                    return new Response('', 304, ['Last-Modified' => $modificationTimeGMT . 'GMT']);
                 }
             }
 
-            if (
-                isset($feed['items'])
-                && isset($feed['extraInfos'])
-            ) {
+            if (isset($feed['items']) && isset($feed['extraInfos'])) {
                 foreach ($feed['items'] as $item) {
                     $items[] = new FeedItem($item);
                 }
                 $infos = $feed['extraInfos'];
             }
         } else {
-            // At this point we did NOT find the feed in the cache or debug mode is enabled.
             try {
                 $bridge->setDatas($bridge_params);
                 $bridge->collectData();
-
                 $items = $bridge->getItems();
-
                 if (isset($items[0]) && is_array($items[0])) {
                     $feedItems = [];
                     foreach ($items as $item) {
@@ -141,46 +142,62 @@ class DisplayAction implements ActionInterface
                     'icon' => $bridge->getIcon()
                 ];
             } catch (\Exception $e) {
+                $errorOutput = Configuration::getConfig('error', 'output');
+                $reportLimit = Configuration::getConfig('error', 'report_limit');
                 if ($e instanceof HttpException) {
-                    Logger::warning(sprintf('Exception in DisplayAction(%s): %s', $bridgeClassName, create_sane_exception_message($e)));
+                    // Reproduce (and log) these responses regardless of error output and report limit
                     if ($e->getCode() === 429) {
+                        Logger::info(sprintf('Exception in DisplayAction(%s): %s', $bridgeClassName, create_sane_exception_message($e)));
+                        return new Response('429 Too Many Requests', 429);
+                    }
+                    if ($e->getCode() === 503) {
+                        Logger::info(sprintf('Exception in DisplayAction(%s): %s', $bridgeClassName, create_sane_exception_message($e)));
                         return new Response('503 Service Unavailable', 503);
                     }
-                } else {
+                    // Might want to cache other codes such as 504 Gateway Timeout
+                }
+                if (in_array($errorOutput, ['feed', 'none'])) {
                     Logger::error(sprintf('Exception in DisplayAction(%s): %s', $bridgeClassName, create_sane_exception_message($e)), ['e' => $e]);
                 }
-
-                // Emit error only if we are passed the error report limit
-                $errorCount = self::logBridgeError($bridge->getName(), $e->getCode());
-                if ($errorCount >= Configuration::getConfig('error', 'report_limit')) {
-                    if (Configuration::getConfig('error', 'output') === 'feed') {
-                        // Emit the error as a feed item in a feed so that feed readers can pick it up
+                $errorCount = 1;
+                if ($reportLimit > 1) {
+                    $errorCount = $this->logBridgeError($bridge->getName(), $e->getCode());
+                }
+                // Let clients know about the error if we are passed the report limit
+                if ($errorCount >= $reportLimit) {
+                    if ($errorOutput === 'feed') {
+                        // Render the exception as a feed item
                         $items[] = $this->createFeedItemFromException($e, $bridge);
-                    } elseif (Configuration::getConfig('error', 'output') === 'http') {
+                    } elseif ($errorOutput === 'http') {
+                        // Rethrow so that the main exception handler in RssBridge.php produces an HTTP 500
                         throw $e;
+                    } elseif ($errorOutput === 'none') {
+                        // Do nothing (produces an empty feed)
+                    } else {
+                        // Do nothing, unknown error output? Maybe throw exception or validate in Configuration.php
                     }
                 }
             }
 
             // Unfortunately need to set scope and key again because they might be modified
-            $cache->setScope('');
-            $cache->setKey($cache_params);
-            $cache->saveData([
+            $this->cache->setScope('');
+            $this->cache->setKey($cache_params);
+            $this->cache->saveData([
                 'items' => array_map(function (FeedItem $item) {
                     return $item->toArray();
                 }, $items),
                 'extraInfos' => $infos
             ]);
-            $cache->purgeCache();
+            $this->cache->purgeCache();
         }
 
         $format->setItems($items);
         $format->setExtraInfos($infos);
-        $lastModified = $cache->getTime();
-        $format->setLastModified($lastModified);
+        $newModificationTime = $this->cache->getTime();
+        $format->setLastModified($newModificationTime);
         $headers = [];
-        if ($lastModified) {
-            $headers['Last-Modified'] = gmdate('D, d M Y H:i:s ', $lastModified) . 'GMT';
+        if ($newModificationTime) {
+            $headers['Last-Modified'] = gmdate('D, d M Y H:i:s ', $newModificationTime) . 'GMT';
         }
         $headers['Content-Type'] = $format->getMimeType() . '; charset=' . $format->getCharset();
         return new Response($format->stringify(), 200, $headers);
@@ -210,13 +227,12 @@ class DisplayAction implements ActionInterface
         return $item;
     }
 
-    private static function logBridgeError($bridgeName, $code)
+    private function logBridgeError($bridgeName, $code)
     {
-        $cache = RssBridge::getCache();
-        $cache->setScope('error_reporting');
-        $cache->setkey([$bridgeName . '_' . $code]);
-
-        if ($report = $cache->loadData()) {
+        $this->cache->setScope('error_reporting');
+        $this->cache->setkey([$bridgeName . '_' . $code]);
+        $report = $this->cache->loadData();
+        if ($report) {
             $report = Json::decode($report);
             $report['time'] = time();
             $report['count']++;
@@ -227,7 +243,7 @@ class DisplayAction implements ActionInterface
                 'count' => 1,
             ];
         }
-        $cache->saveData(Json::encode($report));
+        $this->cache->saveData(Json::encode($report));
         return $report['count'];
     }
 
diff --git a/bridges/GoogleSearchBridge.php b/bridges/GoogleSearchBridge.php
index 59465e89..9b0713ac 100644
--- a/bridges/GoogleSearchBridge.php
+++ b/bridges/GoogleSearchBridge.php
@@ -5,7 +5,7 @@ class GoogleSearchBridge extends BridgeAbstract
     const MAINTAINER = 'sebsauvage';
     const NAME = 'Google search';
     const URI = 'https://www.google.com/';
-    const CACHE_TIMEOUT = 1800; // 30min
+    const CACHE_TIMEOUT = 60 * 30; // 30m
     const DESCRIPTION = 'Returns max 100 results from the past year.';
 
     const PARAMETERS = [[
diff --git a/lib/contents.php b/lib/contents.php
index 4429a75c..5587a98e 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -63,6 +63,11 @@ final class Response
         return $this->body;
     }
 
+    public function getCode()
+    {
+        return $this->code;
+    }
+
     public function getHeaders()
     {
         return $this->headers;
diff --git a/lib/utils.php b/lib/utils.php
index ea329f8d..94f928cd 100644
--- a/lib/utils.php
+++ b/lib/utils.php
@@ -51,11 +51,13 @@ function get_current_url(): string
 
 function create_sane_exception_message(\Throwable $e): string
 {
+    $sanitizedMessage = sanitize_root($e->getMessage());
+    $sanitizedFilepath = sanitize_root($e->getFile());
     return sprintf(
         '%s: %s in %s line %s',
         get_class($e),
-        sanitize_root($e->getMessage()),
-        sanitize_root($e->getFile()),
+        $sanitizedMessage,
+        $sanitizedFilepath,
         $e->getLine()
     );
 }

From b6fab206010f23145a864da5b896e2aebd384bff Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 23 Jul 2023 23:05:56 +0200
Subject: [PATCH 035/716] docs: improve readme (#3560)

* docs: improve readme
---
 README.md              | 159 ++++++++++++++++++++++++++++++++---------
 config.default.ini.php |   1 +
 2 files changed, 128 insertions(+), 32 deletions(-)

diff --git a/README.md b/README.md
index e9f7360d..e0487e6b 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,11 @@
 
 ![RSS-Bridge](static/logo_600px.png)
 
-RSS-Bridge is a PHP project capable of generating RSS and Atom feeds for websites that don't have one.
+RSS-Bridge is a web application.
+
+It generates web feeds for websites that don't have one.
+
+Officially hosted instance: https://rss-bridge.org/bridge01/
 
 [![LICENSE](https://img.shields.io/badge/license-UNLICENSE-blue.svg)](UNLICENSE)
 [![GitHub release](https://img.shields.io/github/release/rss-bridge/rss-bridge.svg?logo=github)](https://github.com/rss-bridge/rss-bridge/releases/latest)
@@ -17,34 +21,43 @@ RSS-Bridge is a PHP project capable of generating RSS and Atom feeds for website
 |![Screenshot #5](/static/screenshot-5.png?raw=true)|![Screenshot #6](/static/screenshot-6.png?raw=true)|
 |![Screenshot #7](/static/twitter-form.png?raw=true)|![Screenshot #8](/static/twitter-rasmus.png?raw=true)|
 
-## A subset of bridges
+## A subset of bridges (17/412)
 
-* `YouTube` : YouTube user channel, playlist or search
-* `Twitter` : Return keyword/hashtag search or user timeline
-* `Telegram` : Return the latest posts from a public group
-* `Reddit` : Return the latest posts from a subreddit or user
-* `Filter` : Filter an existing feed url
-* `Vk` : Latest posts from a user or group
-* `FeedMerge` : Merge two or more existing feeds into one
-* `Twitch` : Fetch the latest videos from a channel
-* `ThePirateBay` : Returns the newest indexed torrents from [The Pirate Bay](https://thepiratebay.se/) with keywords
-
-And [many more](bridges/), thanks to the community!
+* `CssSelectorBridge`: [Scrape out a feed using CSS selectors](https://rss-bridge.org/bridge01/#bridge-CssSelectorBridge)
+* `FeedMergeBridge`: [Combine multiple feeds into one](https://rss-bridge.org/bridge01/#bridge-FeedMergeBridge)
+* `FeedReducerBridge`: [Reduce a noisy feed by some percentage](https://rss-bridge.org/bridge01/#bridge-FeedReducerBridge)
+* `FilterBridge`: [Filter a feed by excluding/including items by keyword](https://rss-bridge.org/bridge01/#bridge-FilterBridge)
+* `GettrBridge`: [Fetches the latest posts from a GETTR user](https://rss-bridge.org/bridge01/#bridge-GettrBridge)
+* `MastodonBridge`: [Fetches statuses from a Mastodon (ActivityPub) instance](https://rss-bridge.org/bridge01/#bridge-MastodonBridge)
+* `RedditBridge`: [Fetches posts from a user/subredit (with filtering options)](https://rss-bridge.org/bridge01/#bridge-RedditBridge)
+* `RumbleBridge`: [Fetches channel/user videos](https://rss-bridge.org/bridge01/#bridge-RumbleBridge)
+* `SoundcloudBridge`: [Fetches music by username](https://rss-bridge.org/bridge01/#bridge-SoundcloudBridge)
+* `TelegramBridge`: [Fetches posts from a public channel](https://rss-bridge.org/bridge01/#bridge-TelegramBridge)
+* `ThePirateBayBridge:` [Fetches torrents by search/user/category](https://rss-bridge.org/bridge01/#bridge-ThePirateBayBridge)
+* `TikTokBridge`: [Fetches posts by username](https://rss-bridge.org/bridge01/#bridge-TikTokBridge)
+* `TwitchBridge`: [Fetches videos from channel](https://rss-bridge.org/bridge01/#bridge-TwitchBridge)
+* `TwitterBridge`: [Fetches tweets](https://rss-bridge.org/bridge01/#bridge-TwitterBridge)
+* `VkBridge`: [Fetches posts from user/group](https://rss-bridge.org/bridge01/#bridge-VkBridge)
+* `XPathBridge`: [Scrape out a feed using XPath expressions](https://rss-bridge.org/bridge01/#bridge-XPathBridge)
+* `YoutubeBridge`: [Fetches videos by username/channel/playlist/search](https://rss-bridge.org/bridge01/#bridge-YoutubeBridge)
+* `YouTubeCommunityTabBridge`: [Fetches posts from a channel's community tab](https://rss-bridge.org/bridge01/#bridge-YouTubeCommunityTabBridge)
 
 [Full documentation](https://rss-bridge.github.io/rss-bridge/index.html)
 
-Check out RSS-Bridge right now on https://rss-bridge.org/bridge01 or find another
+Check out RSS-Bridge right now on https://rss-bridge.org/bridge01/
+
+Alternatively find another
 [public instance](https://rss-bridge.github.io/rss-bridge/General/Public_Hosts.html).
 
 ## Tutorial
 
-RSS-Bridge requires php 7.4 (or higher).
-
 ### Install with composer or git
 
+Requires minimum PHP 7.4.
+
 ```shell
 cd /var/www
-composer create-project --no-dev rss-bridge/rss-bridge
+composer create-project -v --no-dev rss-bridge/rss-bridge
 ```
 
 ```shell
@@ -80,9 +93,9 @@ server {
 }
 ```
 
-### Install with Docker:
+### Install from Docker Hub:
 
-Install by using docker image from Docker Hub:
+Install by downloading the docker image from Docker Hub:
 
 ```bash
 # Create container
@@ -94,7 +107,7 @@ docker start rss-bridge
 
 Browse http://localhost:3000/
 
-Install by locally building the image:
+### Install by locally building from Dockerfile
 
 ```bash
 # Build image from Dockerfile
@@ -103,13 +116,13 @@ docker build -t rss-bridge .
 # Create container
 docker create --name rss-bridge --publish 3000:80 rss-bridge
 
-# Start the container
+# Start container
 docker start rss-bridge
 ```
 
 Browse http://localhost:3000/
 
-#### Install with docker-compose
+### Install with docker-compose
 
 Create a `docker-compose.yml` file locally with with the following content:
 ```yml
@@ -132,7 +145,7 @@ docker-compose up
 
 Browse http://localhost:3000/
 
-### Alternative installation methods
+### Other installation methods
 
 [![Deploy on Scalingo](https://cdn.scalingo.com/deploy/button.svg)](https://my.scalingo.com/deploy?source=https://github.com/sebsauvage/rss-bridge)
 [![Deploy to Heroku](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)
@@ -175,6 +188,8 @@ Learn more in [bridge api](https://rss-bridge.github.io/rss-bridge/Bridge_API/in
 
 ### How to enable all bridges
 
+Modify `config.ini.php`:
+
     enabled_bridges[] = *
 
 ### How to enable some bridges
@@ -186,14 +201,82 @@ enabled_bridges[] = GettrBridge
 
 ### How to enable debug mode
 
+The 
+[debug mode](https://rss-bridge.github.io/rss-bridge/For_Developers/Debug_mode.html)
+disables the majority of caching operations.
+
     enable_debug_mode = true
 
-Learn more in [debug mode](https://rss-bridge.github.io/rss-bridge/For_Developers/Debug_mode.html).
+### How to switch to memcached as cache backend
+
+```
+[cache]
+
+; Cache backend: file (default), sqlite, memcached, null
+type = "memcached"
+```
+
+### How to switch to sqlite3 as cache backend
+
+    type = "sqlite"
+
+### How to disable bridge errors (as feed items)
+
+When a bridge fails, RSS-Bridge will produce a feed with a single item describing the error.
+
+This way, feed readers pick it up and you are notified.
+
+If you don't want this behaviour, switch the error output to `http`:
+
+    [error]
+
+    ; Defines how error messages are returned by RSS-Bridge
+    ;
+    ; "feed" = As part of the feed (default)
+    ; "http" = As HTTP error message
+    ; "none" = No errors are reported
+    output = "http"
+
+### How to accumulate errors before finally reporting it
+
+Modify `report_limit` so that an error must occur 3 times before it is reported.
+
+    ; Defines how often an error must occur before it is reported to the user
+    report_limit = 3
+
+### How to password-protect the instance
+
+HTTP basic access authentication:
+
+    [authentication]
+
+    enable = true
+    username = "alice"
+    password = "cat"
+
+Will typically require feed readers to be configured with the credentials.
+
+It may also be possible to manually include the credentials in the URL:
+
+https://alice:cat@rss-bridge.org/bridge01/?action=display&bridge=FabriceBellardBridge&format=Html
 
 ### How to create a new output format
 
 [Create a new format](https://rss-bridge.github.io/rss-bridge/Format_API/index.html).
 
+### How to run unit tests and linter
+
+These commands require that you have installed the dev dependencies in `composer.json`.
+
+    ./vendor/bin/phpunit
+    ./vendor/bin/phpcs --standard=phpcs.xml --warning-severity=0 --extensions=php -p ./
+
+### How to spawn a minimal development environment
+
+    php -S 127.0.0.1:9001
+
+http://127.0.0.1:9001/
+
 ## Explanation
 
 We are RSS-Bridge community, a group of developers continuing the project initiated by sebsauvage,
@@ -205,15 +288,19 @@ webmaster of
 See [CONTRIBUTORS.md](CONTRIBUTORS.md)
 
 RSS-Bridge uses caching to prevent services from banning your server for repeatedly updating feeds.
-The specific cache duration can be different between bridges. Cached files are deleted automatically after 24 hours.
+The specific cache duration can be different between bridges.
+Cached files are deleted automatically after 24 hours.
 
 RSS-Bridge allows you to take full control over which bridges are displayed to the user.
 That way you can host your own RSS-Bridge service with your favorite collection of bridges!
 
+Current maintainers (as of 2023): @dvikan and @Mynacol #2519
 
 ## Reference
 
-### FeedItem properties
+### Feed item structure
+
+This is the feed item structure that bridges are expected to produce.
 
 ```php
     $item = [
@@ -236,13 +323,21 @@ That way you can host your own RSS-Bridge service with your favorite collection
     ]
 ```
 
-### Output formats:
+### Output formats
 
-* `Atom` : Atom feed, for use in feed readers
-* `Html` : Simple HTML page
-* `Json` : JSON, for consumption by other applications
-* `Mrss` : MRSS feed, for use in feed readers
-* `Plaintext` : Raw text, for consumption by other applications
+* `Atom`: Atom feed, for use in feed readers
+* `Html`: Simple HTML page
+* `Json`: JSON, for consumption by other applications
+* `Mrss`: MRSS feed, for use in feed readers
+* `Plaintext`: Raw text, for consumption by other applications
+* `Sfeed`: Text, TAB separated
+
+### Cache backends
+
+* `file`
+* `sqlite`
+* `memcached`
+* `null`
 
 ### Licenses
 
diff --git a/config.default.ini.php b/config.default.ini.php
index 1c9a20ae..d0c508f4 100644
--- a/config.default.ini.php
+++ b/config.default.ini.php
@@ -8,6 +8,7 @@
 
 ; Only these bridges are available for feed production
 ; How to enable all bridges: enabled_bridges[] = *
+enabled_bridges[] = CssSelectorBridge
 enabled_bridges[] = FeedMerge
 enabled_bridges[] = FeedReducerBridge
 enabled_bridges[] = Filter

From 1f6c2cd32c9668c5945580a9cfb04948188b0a1d Mon Sep 17 00:00:00 2001
From: Simon Alberny <contact@simounet.net>
Date: Mon, 24 Jul 2023 16:25:09 +0200
Subject: [PATCH 036/716] Allocine Sorties movie date added (#3569)

---
 bridges/AllocineFRSortiesBridge.php | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/bridges/AllocineFRSortiesBridge.php b/bridges/AllocineFRSortiesBridge.php
index b77c2f9b..a75187be 100644
--- a/bridges/AllocineFRSortiesBridge.php
+++ b/bridges/AllocineFRSortiesBridge.php
@@ -24,6 +24,7 @@ class AllocineFRSortiesBridge extends BridgeAbstract
             $thumb = $element->find('figure.thumbnail', 0);
             $meta = $element->find('div.meta-body', 0);
             $synopsis = $element->find('div.synopsis', 0);
+            $date = $element->find('span.date', 0);
 
             $title = $element->find('a[class*=meta-title-link]', 0);
             $content = trim(defaultLinkTo($thumb->outertext . $meta->outertext . $synopsis->outertext, static::URI));
@@ -34,8 +35,32 @@ class AllocineFRSortiesBridge extends BridgeAbstract
 
             $item['content'] = $content;
             $item['title'] = trim($title->innertext);
+            $item['timestamp'] = $this->frenchPubDateToTimestamp($date->plaintext);
             $item['uri'] = static::BASE_URI . '/' . substr($title->href, 1);
             $this->items[] = $item;
         }
     }
+
+    private function frenchPubDateToTimestamp($date)
+    {
+        return strtotime(
+            strtr(
+                strtolower($date),
+                [
+                    'janvier' => 'jan',
+                    'février' => 'feb',
+                    'mars' => 'march',
+                    'avril' => 'apr',
+                    'mai' => 'may',
+                    'juin' => 'jun',
+                    'juillet' => 'jul',
+                    'août' => 'aug',
+                    'septembre' => 'sep',
+                    'octobre' => 'oct',
+                    'novembre' => 'nov',
+                    'décembre' => 'dec'
+                ]
+            )
+        );
+    }
 }

From 2cc89b767c7f357da724c551b8cf2a512fc2f744 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Dawid=20Wr=C3=B3bel?= <me@dawidwrobel.com>
Date: Tue, 25 Jul 2023 20:52:47 +0200
Subject: [PATCH 037/716] [AllegroBridge] fix non-functional bridge (#3571)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

— fix cookie pattern
– use data analytics attributes wherever possible to avoid relying on obfuscated class names
— add support for promoted offers
— include sponsored and promoted offers by default
— some additional refactoring
---
 bridges/AllegroBridge.php | 83 ++++++++++++++++++++-------------------
 1 file changed, 43 insertions(+), 40 deletions(-)

diff --git a/bridges/AllegroBridge.php b/bridges/AllegroBridge.php
index 55457416..be240857 100644
--- a/bridges/AllegroBridge.php
+++ b/bridges/AllegroBridge.php
@@ -16,14 +16,20 @@ class AllegroBridge extends BridgeAbstract
         'sessioncookie' => [
             'name' => 'The \'wdctx\' session cookie',
             'title' => 'Paste the value of the \'wdctx\' cookie from your browser if you want to prevent Allegro imposing rate limits',
-            'pattern' => '^.{250,};?$',
+            'pattern' => '^.{70,};?$',
             // phpcs:ignore
             'exampleValue' => 'v4.1-oCrmXTMqv2ppC21GTUCKLmUwRPP1ssQVALKuqwsZ1VXjcKgL2vO5TTRM5xMxS9GiyqxF1gAeyc-63dl0coUoBKXCXi_nAmr95yyqGpq2RAFoneZ4L399E8n6iYyemcuGARjAoSfjvLHJCEwvvHHynSgaxlFBu7hUnKfuy39zo9sSQdyTUjotJg3CAZ53q9v2raAnPCyGOAR4ytRILd9p24EJnxp7_oR0XbVPIo1hDa4WmjXFOxph8rHaO5tWd',
             'required' => false,
         ],
         'includeSponsoredOffers' => [
             'type' => 'checkbox',
-            'name' => 'Include Sponsored Offers'
+            'name' => 'Include Sponsored Offers',
+            'defaultValue' => 'checked'
+        ],
+        'includePromotedOffers' => [
+            'type' => 'checkbox',
+            'name' => 'Include Promoted Offers',
+            'defaultValue' => 'checked'
         ]
     ]];
 
@@ -63,58 +69,57 @@ class AllegroBridge extends BridgeAbstract
             return;
         }
 
-        $results = $html->find('._6a66d_V7Lel article');
+        $results = $html->find('article[data-analytics-view-custom-context="REGULAR"]');
 
         if (!$this->getInput('includeSponsoredOffers')) {
-            $results = array_filter($results, function ($node) {
-                return $node->{'data-analytics-view-label'} != 'showSponsoredItems';
-            });
+            $results = array_merge($results, $html->find('article[data-analytics-view-custom-context="SPONSORED"]'));
+        }
+
+        if (!$this->getInput('includePromotedOffers')) {
+            $results = array_merge($results, $html->find('article[data-analytics-view-custom-context="PROMOTED"]'));
         }
 
         foreach ($results as $post) {
             $item = [];
 
-            $item['uri'] = $post->find('._6a66d_LX75-', 0)->href;
-
-//TODO: port this over, whatever it does, from https://github.com/MK-PL/AllegroRSS
-//        if (arrayLinks.includes('events/clicks?')) {
-//            let sponsoredLink = new URL(arrayLinks).searchParams.get('redirect')
-//          arrayLinks = sponsoredLink.slice(0, sponsoredLink.indexOf('?'))
-//        }
-
-            $item['title'] = $post->find('._6a66d_LX75-', 0)->innertext;
-
             $item['uid'] = $post->{'data-analytics-view-value'};
 
+            $item_link = $post->find('a[href*="' . $item['uid'] . '"], a[href*="allegrolokalnie"]', 0);
+
+            $item['uri'] = $item_link->href;
+
+            $item['title'] = $item_link->find('img', 0)->alt;
+
+            $image = $item_link->find('img', 0)->{'data-src'} ?: $item_link->find('img', 0)->src ?? false;
+
+            if ($image) {
+                $item['enclosures'] = [$image . '#.image'];
+            }
+
+            $price = $post->{'data-analytics-view-json-custom-price'};
+            if ($price) {
+                $priceDecoded = json_decode(html_entity_decode($price));
+                $price = $priceDecoded->amount . ' ' . $priceDecoded->currency;
+            }
+
             $descriptionPatterns = ['/<\s*dt[^>]*>\b/', '/<\/dt>/', '/<\s*dd[^>]*>\b/', '/<\/dd>/'];
             $descriptionReplacements = ['<span>', ':</span> ', '<strong>', '&emsp;</strong> '];
             $description = $post->find('.m7er_k4.mpof_5r.mpof_z0_s', 0)->innertext;
             $descriptionPretty = preg_replace($descriptionPatterns, $descriptionReplacements, $description);
 
-            $buyNowAuction = $post->find('.mqu1_g3.mvrt_0.mgn2_12', 0)->innertext ?? '';
-            $buyNowAuction = str_replace('</span><span', '</span> <span', $buyNowAuction);
-
-            $auctionTimeLeft = $post->find('._6a66d_ImOzU', 0)->innertext ?? '';
-
-            $price = $post->find('._6a66d_6R3iN', 0)->plaintext;
-            $price = empty($auctionTimeLeft) ? $price : $price . '- kwota licytacji';
-
-            $image = $post->find('._6a66d_44ioA img', 0)->{'data-src'} ?: $post->find('._6a66d_44ioA img', 0)->src ?? false;
-            if ($image) {
-                $item['enclosures'] = [$image . '#.image'];
-            }
-
-            $offerExtraInfo = array_filter($post->find('.mqu1_g3.mgn2_12'), function ($node) {
+            $pricingExtraInfo = array_filter($post->find('.mqu1_g3.mgn2_12'), function ($node) {
                 return empty($node->find('.mvrt_0'));
             });
 
-            $offerExtraInfo = $offerExtraInfo[0]->plaintext ?? '';
+            $pricingExtraInfo = $pricingExtraInfo[0]->plaintext ?? '';
 
-            $isSmart = $post->find('._6a66d_TC2Zk', 0)->innertext ?? '';
-            if (str_contains($isSmart, 'z kurierem')) {
-                $offerExtraInfo .= ', Smart z kurierem';
-            } else {
-                $offerExtraInfo .= ', Smart';
+            $offerExtraInfo = array_map(function ($node) {
+                return str_contains($node->plaintext, 'zapłać później') ? '' : $node->outertext;
+            }, $post->find('div.mpof_ki.mwdn_1.mj7a_4.mgn2_12'));
+
+            $isSmart = $post->find('img[alt="Smart!"]', 0) ?? false;
+            if ($isSmart) {
+                $pricingExtraInfo .= $isSmart->outertext;
             }
 
             $item['categories'] = [];
@@ -131,11 +136,9 @@ class AllegroBridge extends BridgeAbstract
                 . '<div><strong>'
                 . $price
                 . '</strong></div><div>'
-                . $auctionTimeLeft
-                . '</div><div>'
-                . $buyNowAuction
+                . implode('</div><div>', $offerExtraInfo)
                 . '</div><dl>'
-                . $offerExtraInfo
+                . $pricingExtraInfo
                 . '</dl><hr>';
 
             $this->items[] = $item;

From 556bca58cf9ce9c2038c387cbfba9dfa70de6ac6 Mon Sep 17 00:00:00 2001
From: csisoap <33269526+csisoap@users.noreply.github.com>
Date: Wed, 26 Jul 2023 03:36:41 +0700
Subject: [PATCH 038/716] [TwitterBridge] Fix search, user, list ID (#3566)

* Add ability to fetch user, list tweet

* Fix user, search, list ID although list still broke

* clear whitespace

* Revert CACHE_TIMEOUT

* clear whitespace, change single quote

* Clear PHP warning, add ability to get full-text if truncated

* Clear PHP warning

* clear warning

* clear whitespace

* Add check condition for mediaDetails.

* Add whitespace

* Add try catch exception for get full-text tweet

* clear warning

* clear warning
---
 bridges/TwitterBridge.php | 120 ++++++++++-----
 lib/TwitterClient.php     | 314 +++++++++++++++++++++++++++++++++-----
 2 files changed, 364 insertions(+), 70 deletions(-)

diff --git a/bridges/TwitterBridge.php b/bridges/TwitterBridge.php
index 189203bd..1ba00c66 100644
--- a/bridges/TwitterBridge.php
+++ b/bridges/TwitterBridge.php
@@ -210,6 +210,16 @@ EOD
         }
     }
 
+    private function getFullText($id)
+    {
+        $url = sprintf(
+            'https://cdn.syndication.twimg.com/tweet-result?id=%s&lang=en',
+            $id
+        );
+
+        return json_decode(getContents($url), false);
+    }
+
     public function collectData()
     {
         // $data will contain an array of all found tweets (unfiltered)
@@ -220,13 +230,11 @@ EOD
         $tweets = [];
 
         // Get authentication information
-
+        $cache = RssBridge::getCache();
+        $api = new TwitterClient($cache);
         // Try to get all tweets
         switch ($this->queriedContext) {
             case 'By username':
-                $cache = RssBridge::getCache();
-                $api = new TwitterClient($cache);
-
                 $screenName = $this->getInput('u');
                 $screenName = trim($screenName);
                 $screenName = ltrim($screenName, '@');
@@ -238,35 +246,45 @@ EOD
             case 'By keyword or hashtag':
                 // Does not work with the recent twitter changes
                 $params = [
-                'q'                 => urlencode($this->getInput('q')),
-                'tweet_mode'        => 'extended',
-                'tweet_search_mode' => 'live',
+                    'q'                 => urlencode($this->getInput('q')),
+                    'tweet_mode'        => 'extended',
+                    'tweet_search_mode' => 'live',
                 ];
 
-                $data = $this->makeApiCall('/1.1/search/tweets.json', $params)->statuses;
+                $tweets = $api->search($params)->statuses;
+                $data = (object) [
+                    'tweets' => $tweets
+                ];
                 break;
 
             case 'By list':
                 // Does not work with the recent twitter changes
-                $params = [
-                'slug'              => strtolower($this->getInput('list')),
-                'owner_screen_name' => strtolower($this->getInput('user')),
-                'tweet_mode'        => 'extended',
+                // $params = [
+                // 'slug'              => strtolower($this->getInput('list')),
+                // 'owner_screen_name' => strtolower($this->getInput('user')),
+                // 'tweet_mode'        => 'extended',
+                // ];
+                $query = [
+                    'screenName' => strtolower($this->getInput('user')),
+                    'listSlug' => strtolower($this->getInput('list'))
                 ];
 
-                $data = $this->makeApiCall('/1.1/lists/statuses.json', $params);
+                $data = $api->fetchListTweets($query, $this->queriedContext);
                 break;
 
             case 'By list ID':
                 // Does not work with the recent twitter changes
-                $params = [
-                'list_id'           => $this->getInput('listid'),
-                'tweet_mode'        => 'extended',
+                // $params = [
+                // 'list_id'           => $this->getInput('listid'),
+                // 'tweet_mode'        => 'extended',
+                // ];
+
+                $query = [
+                    'listId' => $this->getInput('listid')
                 ];
 
-                $data = $this->makeApiCall('/1.1/lists/statuses.json', $params);
+                $data = $api->fetchListTweets($query, $this->queriedContext);
                 break;
-
             default:
                 returnServerError('Invalid query context !');
         }
@@ -314,6 +332,7 @@ EOD
             $this->feedIconUrl = $data->user_info->legacy->profile_image_url_https ?? null;
         }
 
+        $i = 0;
         foreach ($tweets as $tweet) {
             // Skip own Retweets...
             if (isset($tweet->retweeted_status) && $tweet->retweeted_status->user->id_str === $tweet->user->id_str) {
@@ -325,14 +344,6 @@ EOD
                 continue;
             }
 
-            switch ($this->queriedContext) {
-                case 'By username':
-                    if ($this->getInput('norep') && isset($tweet->in_reply_to_status_id)) {
-                        continue 2;
-                    }
-                    break;
-            }
-
             $item = [];
 
             $realtweet = $tweet;
@@ -341,11 +352,40 @@ EOD
                 $realtweet = $tweet->retweeted_status;
             }
 
-            $item['username']  = $data->user_info->legacy->screen_name;
-            $item['fullname']  = $data->user_info->legacy->name;
-            $item['avatar']    = $data->user_info->legacy->profile_image_url_https;
+            if (isset($realtweet->truncated) && $realtweet->truncated) {
+                try {
+                    $realtweet = $this->getFullText($realtweet->id_str);
+                } catch (HttpException $e) {
+                    $realtweet = $tweet;
+                }
+            }
+
+            switch ($this->queriedContext) {
+                case 'By username':
+                    if ($this->getInput('norep') && isset($tweet->in_reply_to_status_id)) {
+                        continue 2;
+                    }
+                    $item['username']  = $data->user_info->legacy->screen_name;
+                    $item['fullname']  = $data->user_info->legacy->name;
+                    $item['avatar']    = $data->user_info->legacy->profile_image_url_https;
+                    $item['id']        = $realtweet->id_str;
+                    break;
+                case 'By list':
+                case 'By list ID':
+                    $item['username']  = $data->userIds[$i]->legacy->screen_name;
+                    $item['fullname']  = $data->userIds[$i]->legacy->name;
+                    $item['avatar']    = $data->userIds[$i]->legacy->profile_image_url_https;
+                    $item['id']        = $realtweet->conversation_id_str;
+                    break;
+                case 'By keyword or hashtag':
+                    $item['username']  = $realtweet->user->screen_name;
+                    $item['fullname']  = $realtweet->user->name;
+                    $item['avatar']    = $realtweet->user->profile_image_url_https;
+                    $item['id']        = $realtweet->id_str;
+                    break;
+            }
+
             $item['timestamp'] = $realtweet->created_at;
-            $item['id']        = $realtweet->id_str;
             $item['uri']       = self::URI . $item['username'] . '/status/' . $item['id'];
             $item['author']    = (isset($tweet->retweeted_status) ? 'RT: ' : '')
                          . $item['fullname']
@@ -353,7 +393,11 @@ EOD
                          . $item['username'] . ')';
 
             // Convert plain text URLs into HTML hyperlinks
-            $fulltext = $realtweet->full_text;
+            if (isset($realtweet->full_text)) {
+                $fulltext = $realtweet->full_text;
+            } else {
+                $fulltext = $realtweet->text;
+            }
             $cleanedTweet = $fulltext;
 
             $foundUrls = false;
@@ -385,7 +429,7 @@ EOD
             if ($foundUrls === false) {
                 // fallback to regex'es
                 $reg_ex = '/(http|https|ftp|ftps)\:\/\/[a-zA-Z0-9\-\.]+\.[a-zA-Z]{2,3}(\/\S*)?/';
-                if (preg_match($reg_ex, $realtweet->full_text, $url)) {
+                if (preg_match($reg_ex, $fulltext, $url)) {
                     $cleanedTweet = preg_replace(
                         $reg_ex,
                         "<a href='{$url[0]}' target='_blank'>{$url[0]}</a> ",
@@ -410,10 +454,17 @@ EOD
 EOD;
             }
 
+            $medias = [];
+            if (isset($realtweet->extended_entities->media)) {
+                $medias = $realtweet->extended_entities->media;
+            } else if (isset($realtweet->mediaDetails)) {
+                $medias = $realtweet->mediaDetails;
+            }
+
             // Get images
             $media_html = '';
-            if (isset($realtweet->extended_entities->media) && !$this->getInput('noimg')) {
-                foreach ($realtweet->extended_entities->media as $media) {
+            if (!$this->getInput('noimg')) {
+                foreach ($medias as $media) {
                     switch ($media->type) {
                         case 'photo':
                             $image = $media->media_url_https . '?name=orig';
@@ -496,6 +547,7 @@ EOD;
 EOD;
 
             // put out
+            $i++;
             $this->items[] = $item;
         }
 
diff --git a/lib/TwitterClient.php b/lib/TwitterClient.php
index 341610a4..92c797d6 100644
--- a/lib/TwitterClient.php
+++ b/lib/TwitterClient.php
@@ -20,6 +20,88 @@ class TwitterClient
         $this->authorization = 'AAAAAAAAAAAAAAAAAAAAAGHtAgAAAAAA%2Bx7ILXNILCqkSGIzy6faIHZ9s3Q%3DQy97w6SIrzE7lQwPJEYQBsArEE2fC25caFwRBvAGi456G09vGR';
     }
 
+    private function extractTweetAndUsersFromGraphQL($timeline)
+    {
+        if (isset($timeline->data->user)) {
+            $result = $timeline->data->user->result;
+            $instructions = $result->timeline_v2->timeline->instructions;
+        } else {
+            $result = $timeline->data->list->timeline_response;
+            $instructions = $result->timeline->instructions;
+        }
+        if (isset($result->__typename) && $result->__typename === 'UserUnavailable') {
+            throw new \Exception('UserUnavailable');
+        }
+        $instructionTypes = [
+            'TimelineAddEntries',
+            'TimelineClearCache',
+            'TimelinePinEntry', // unclear purpose, maybe pinned tweet?
+        ];
+        if (!isset($instructions[1]) && isset($timeline->data->user)) {
+            throw new \Exception('The account exists but has not tweeted yet?');
+        }
+
+        $entries = null;
+        foreach ($instructions as $instruction) {
+            $instructionType = '';
+            if (isset($instruction->type)) {
+                $instructionType = $instruction->type;
+            } else {
+                $instructionType = $instruction->__typename;
+            }
+
+            if ($instructionType === 'TimelineAddEntries') {
+                $entries = $instruction->entries;
+                break;
+            }
+        }
+        if (!$entries) {
+            throw new \Exception(sprintf('Unable to find time line tweets in: %s', implode(',', array_column($instructions, 'type'))));
+        }
+
+        $tweets = [];
+        $userIds = [];
+        foreach ($entries as $entry) {
+            $entryType = '';
+
+            if (isset($entry->content->entryType)) {
+                $entryType = $entry->content->entryType;
+            } else {
+                $entryType = $entry->content->__typename;
+            }
+
+            if ($entryType !== 'TimelineTimelineItem') {
+                continue;
+            }
+
+            if (isset($timeline->data->user)) {
+                if (!isset($entry->content->itemContent->tweet_results->result->legacy)) {
+                    continue;
+                }
+                $tweets[] = $entry->content->itemContent->tweet_results->result->legacy;
+
+                $userIds[] = $entry->content->itemContent->tweet_results->result->core->user_results->result;
+            } else {
+                if (!isset($entry->content->content->tweetResult->result->legacy)) {
+                    continue;
+                }
+                $tweets[] = $entry->content->content->tweetResult->result->legacy;
+
+                $userIds[] = $entry->content->content->tweetResult->result->core->user_result->result;
+            }
+        }
+
+        return (object) [
+            'userIds' => $userIds,
+            'tweets' => $tweets,
+        ];
+    }
+
+    private function extractTweetFromSearch($searchResult)
+    {
+        return $searchResult->statuses;
+    }
+
     public function fetchUserTweets(string $screenName): \stdClass
     {
         $this->fetchGuestToken();
@@ -36,58 +118,66 @@ class TwitterClient
         }
 
         try {
-            $timeline = $this->fetchTimeline($userInfo->rest_id);
+            $timeline = $this->fetchTimelineUsingSearch($screenName);
         } catch (HttpException $e) {
             if ($e->getCode() === 403) {
                 $this->data['guest_token'] = null;
                 $this->fetchGuestToken();
-                $timeline = $this->fetchTimeline($userInfo->rest_id);
+                $timeline = $this->fetchTimelineUsingSearch($screenName);
             } else {
                 throw $e;
             }
         }
 
-        $result = $timeline->data->user->result;
-        if ($result->__typename === 'UserUnavailable') {
-            throw new \Exception('UserUnavailable');
-        }
-        $instructionTypes = [
-            'TimelineAddEntries',
-            'TimelineClearCache',
-            'TimelinePinEntry', // unclear purpose, maybe pinned tweet?
-        ];
-        $instructions = $result->timeline_v2->timeline->instructions;
-        if (!isset($instructions[1])) {
-            throw new \Exception('The account exists but has not tweeted yet?');
-        }
+        $tweets = $this->extractTweetFromSearch($timeline);
 
-        $entries = null;
-        foreach ($instructions as $instruction) {
-            if ($instruction->type === 'TimelineAddEntries') {
-                $entries = $instruction->entries;
-                break;
-            }
-        }
-        if (!$entries) {
-            throw new \Exception(sprintf('Unable to find time line tweets in: %s', implode(',', array_column($instructions, 'type'))));
-        }
-
-        $tweets = [];
-        foreach ($entries as $entry) {
-            if ($entry->content->entryType !== 'TimelineTimelineItem') {
-                continue;
-            }
-            if (!isset($entry->content->itemContent->tweet_results->result->legacy)) {
-                continue;
-            }
-            $tweets[] = $entry->content->itemContent->tweet_results->result->legacy;
-        }
         return (object) [
             'user_info' => $userInfo,
             'tweets' => $tweets,
         ];
     }
 
+    public function fetchListTweets($query, $operation = '')
+    {
+        $id = '';
+        $this->fetchGuestToken();
+        if ($operation == 'By list') {
+            try {
+                $listInfo = $this->fetchListInfoBySlug($query['screenName'], $query['listSlug']);
+                $id = $listInfo->id_str;
+            } catch (HttpException $e) {
+                if ($e->getCode() === 403) {
+                    $this->data['guest_token'] = null;
+                    $this->fetchGuestToken();
+                    $listInfo = $this->fetchListInfoBySlug($query['screenName'], $query['listSlug']);
+                    $id = $listInfo->id_str;
+                } else {
+                    throw $e;
+                }
+            }
+        } else if ($operation == 'By list ID') {
+            $id = $query['listId'];
+        } else {
+            throw new \Exception('Unknown operation to make list tweets');
+        }
+
+        try {
+            $timeline = $this->fetchListTimeline($id);
+        } catch (HttpException $e) {
+            if ($e->getCode() === 403) {
+                $this->data['guest_token'] = null;
+                $this->fetchGuestToken();
+                $timeline = $this->fetchListTimeline($id);
+            } else {
+                throw $e;
+            }
+        }
+
+        $data = $this->extractTweetAndUsersFromGraphQL($timeline);
+
+        return $data;
+    }
+
     private function fetchGuestToken(): void
     {
         if (isset($this->data['guest_token'])) {
@@ -173,6 +263,158 @@ class TwitterClient
         return $response;
     }
 
+    private function fetchTimelineUsingSearch($screenName)
+    {
+        $params = [
+            'q' => 'from:' . $screenName,
+            'modules' => 'status',
+            'result_type' => 'recent'
+        ];
+        $response = $this->search($params);
+        return $response;
+    }
+
+    public function search($queryParam)
+    {
+         $url = sprintf(
+             'https://api.twitter.com/1.1/search/tweets.json?%s',
+             http_build_query($queryParam)
+         );
+        $response = Json::decode(getContents($url, $this->createHttpHeaders()), false);
+        return $response;
+    }
+
+    private function fetchListInfoBySlug($screenName, $listSlug)
+    {
+        if (isset($this->data[$screenName . '-' . $listSlug])) {
+            return $this->data[$screenName . '-' . $listSlug];
+        }
+
+        $features = [
+            'android_graphql_skip_api_media_color_palette' => false,
+            'blue_business_profile_image_shape_enabled' => false,
+            'creator_subscriptions_subscription_count_enabled' => false,
+            'creator_subscriptions_tweet_preview_api_enabled' => true,
+            'freedom_of_speech_not_reach_fetch_enabled' => false,
+            'graphql_is_translatable_rweb_tweet_is_translatable_enabled' => false,
+            'hidden_profile_likes_enabled' => false,
+            'highlights_tweets_tab_ui_enabled' => false,
+            'interactive_text_enabled' => false,
+            'longform_notetweets_consumption_enabled' => true,
+            'longform_notetweets_inline_media_enabled' => false,
+            'longform_notetweets_richtext_consumption_enabled' => true,
+            'longform_notetweets_rich_text_read_enabled' => false,
+            'responsive_web_edit_tweet_api_enabled' => false,
+            'responsive_web_enhance_cards_enabled' => false,
+            'responsive_web_graphql_exclude_directive_enabled' => true,
+            'responsive_web_graphql_skip_user_profile_image_extensions_enabled' => false,
+            'responsive_web_graphql_timeline_navigation_enabled' => false,
+            'responsive_web_media_download_video_enabled' => false,
+            'responsive_web_text_conversations_enabled' => false,
+            'responsive_web_twitter_article_tweet_consumption_enabled' => false,
+            'responsive_web_twitter_blue_verified_badge_is_enabled' => true,
+            'rweb_lists_timeline_redesign_enabled' => true,
+            'spaces_2022_h2_clipping' => true,
+            'spaces_2022_h2_spaces_communities' => true,
+            'standardized_nudges_misinfo' => false,
+            'subscriptions_verification_info_enabled' => true,
+            'subscriptions_verification_info_reason_enabled' => true,
+            'subscriptions_verification_info_verified_since_enabled' => true,
+            'super_follow_badge_privacy_enabled' => false,
+            'super_follow_exclusive_tweet_notifications_enabled' => false,
+            'super_follow_tweet_api_enabled' => false,
+            'super_follow_user_api_enabled' => false,
+            'tweet_awards_web_tipping_enabled' => false,
+            'tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled' => false,
+            'tweetypie_unmention_optimization_enabled' => false,
+            'unified_cards_ad_metadata_container_dynamic_card_content_query_enabled' => false,
+            'verified_phone_label_enabled' => false,
+            'vibe_api_enabled' => false,
+            'view_counts_everywhere_api_enabled' => false
+        ];
+        $variables = [
+            'screenName' => $screenName,
+            'listSlug' => $listSlug
+        ];
+
+        $url = sprintf(
+            'https://twitter.com/i/api/graphql/-kmqNvm5Y-cVrfvBy6docg/ListBySlug?variables=%s&features=%s',
+            urlencode(json_encode($variables)),
+            urlencode(json_encode($features))
+        );
+
+        $response = Json::decode(getContents($url, $this->createHttpHeaders()), false);
+        if (isset($response->errors)) {
+            // Grab the first error message
+            throw new \Exception(sprintf('From twitter api: "%s"', $response->errors[0]->message));
+        }
+        $listInfo = $response->data->user_by_screen_name->list;
+        $this->data[$screenName . '-' . $listSlug] = $listInfo;
+
+        $this->cache->setScope('twitter');
+        $this->cache->setKey(['cache']);
+        $this->cache->saveData($this->data);
+        return $listInfo;
+    }
+
+    private function fetchListTimeline($listId)
+    {
+        $features = [
+            'android_graphql_skip_api_media_color_palette' => false,
+            'blue_business_profile_image_shape_enabled' => false,
+            'creator_subscriptions_subscription_count_enabled' => false,
+            'creator_subscriptions_tweet_preview_api_enabled' => true,
+            'freedom_of_speech_not_reach_fetch_enabled' => false,
+            'graphql_is_translatable_rweb_tweet_is_translatable_enabled' => false,
+            'hidden_profile_likes_enabled' => false,
+            'highlights_tweets_tab_ui_enabled' => false,
+            'interactive_text_enabled' => false,
+            'longform_notetweets_consumption_enabled' => true,
+            'longform_notetweets_inline_media_enabled' => false,
+            'longform_notetweets_richtext_consumption_enabled' => true,
+            'longform_notetweets_rich_text_read_enabled' => false,
+            'responsive_web_edit_tweet_api_enabled' => false,
+            'responsive_web_enhance_cards_enabled' => false,
+            'responsive_web_graphql_exclude_directive_enabled' => true,
+            'responsive_web_graphql_skip_user_profile_image_extensions_enabled' => false,
+            'responsive_web_graphql_timeline_navigation_enabled' => false,
+            'responsive_web_media_download_video_enabled' => false,
+            'responsive_web_text_conversations_enabled' => false,
+            'responsive_web_twitter_article_tweet_consumption_enabled' => false,
+            'responsive_web_twitter_blue_verified_badge_is_enabled' => true,
+            'rweb_lists_timeline_redesign_enabled' => true,
+            'spaces_2022_h2_clipping' => true,
+            'spaces_2022_h2_spaces_communities' => true,
+            'standardized_nudges_misinfo' => false,
+            'subscriptions_verification_info_enabled' => true,
+            'subscriptions_verification_info_reason_enabled' => true,
+            'subscriptions_verification_info_verified_since_enabled' => true,
+            'super_follow_badge_privacy_enabled' => false,
+            'super_follow_exclusive_tweet_notifications_enabled' => false,
+            'super_follow_tweet_api_enabled' => false,
+            'super_follow_user_api_enabled' => false,
+            'tweet_awards_web_tipping_enabled' => false,
+            'tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled' => false,
+            'tweetypie_unmention_optimization_enabled' => false,
+            'unified_cards_ad_metadata_container_dynamic_card_content_query_enabled' => false,
+            'verified_phone_label_enabled' => false,
+            'vibe_api_enabled' => false,
+            'view_counts_everywhere_api_enabled' => false
+        ];
+        $variables = [
+            'rest_id' => $listId,
+            'count' => 20
+        ];
+
+        $url = sprintf(
+            'https://twitter.com/i/api/graphql/BbGLL1ZfMibdFNWlk7a0Pw/ListTimeline?variables=%s&features=%s',
+            urlencode(json_encode($variables)),
+            urlencode(json_encode($features))
+        );
+        $response = Json::decode(getContents($url, $this->createHttpHeaders()), false);
+        return $response;
+    }
+
     private function createHttpHeaders(): array
     {
         $headers = [

From 977c0db38222e22b364578ba1d78e800445e44f9 Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Wed, 26 Jul 2023 19:41:29 +0200
Subject: [PATCH 039/716] [CssSelectorBridge] Improvements (#3537) (#3573)

* [CssSelectorBridge] Improvements (#3537)

* Improve parameter documentation / add tooltips
* Allow extracting content from home page instead of article page
* Keep titles from home page when every page <title> is the same

* [CssSelectorBridge] Code linting

* [CssSelectorBridge] Code linting (2)

* [CssSelectorBridge] Code linting (3)
---
 bridges/CssSelectorBridge.php | 103 ++++++++++++++++++++++++++--------
 1 file changed, 80 insertions(+), 23 deletions(-)

diff --git a/bridges/CssSelectorBridge.php b/bridges/CssSelectorBridge.php
index ae135113..2d7489de 100644
--- a/bridges/CssSelectorBridge.php
+++ b/bridges/CssSelectorBridge.php
@@ -15,23 +15,40 @@ class CssSelectorBridge extends BridgeAbstract
             ],
             'url_selector' => [
                 'name' => 'Selector for article links or their parent elements',
+                'title' => <<<EOT
+                    This bridge works using CSS selectors, e.g. "a.article" will match all <a class="article" 
+                    href="URL">TITLE</a> on home page, each one being treated as a feed item. &#10;&#13;
+                    Instead of just a link you can selet one of its parent element. Everything inside that
+                    element becomes feed item content, e.g. image and summary present on home page.
+                    When doing so, the first link inside the selected element becomes feed item URL/Title.
+                    EOT,
                 'exampleValue' => 'a.article',
                 'required' => true
             ],
             'url_pattern' => [
                 'name' => '[Optional] Pattern for site URLs to keep in feed',
-                'exampleValue' => 'https://example.com/article/.*',
+                'title' => 'Optionally filter items by applying a regular expression on their URL',
+                'exampleValue' => '/blog/article/.*',
             ],
             'content_selector' => [
-                'name' => '[Optional] Selector to extract each article content',
+                'name' => '[Optional] Selector to expand each article content',
+                'title' => <<<EOT
+                    When specified, the bridge will fetch each article from its URL
+                    and extract content using the provided selector (Slower!)
+                    EOT,
                 'exampleValue' => 'article.content',
             ],
             'content_cleanup' => [
                 'name' => '[Optional] Content cleanup: List of items to remove',
+                'title' => 'Selector for unnecessary elements to remove inside article contents.',
                 'exampleValue' => 'div.ads, div.comments',
             ],
             'title_cleanup' => [
                 'name' => '[Optional] Text to remove from expanded article title',
+                'title' => <<<EOT
+                    When fetching each article page, feed item title comes from page title. 
+                    Specify here some text from page title that need to be removed, e.g. " | BlogName".
+                    EOT,
                 'exampleValue' => ' | BlogName',
             ],
             'limit' => self::LIMIT
@@ -69,7 +86,7 @@ class CssSelectorBridge extends BridgeAbstract
 
         $html = defaultLinkTo(getSimpleHTMLDOM($url), $url);
         $this->feedName = $this->getPageTitle($html, $title_cleanup);
-        $items = $this->htmlFindLinks($html, $url_selector, $url_pattern, $limit);
+        $items = $this->htmlFindEntries($html, $url_selector, $url_pattern, $limit, $content_cleanup);
 
         if (empty($content_selector)) {
             $this->items = $items;
@@ -79,7 +96,8 @@ class CssSelectorBridge extends BridgeAbstract
                     $item['uri'],
                     $content_selector,
                     $content_cleanup,
-                    $title_cleanup
+                    $title_cleanup,
+                    $item['title']
                 );
             }
         }
@@ -127,30 +145,71 @@ class CssSelectorBridge extends BridgeAbstract
     }
 
     /**
-     * Retrieve first N links from webpage URL or DOM satisfying the specified criteria
-     * @param string|object $page URL or DOM to retrieve links from
+     * Remove all elements from HTML content matching cleanup selector
+     * @param string|object $content HTML content as HTML object or string
+     * @return string|object Cleaned content (same type as input)
+     */
+    protected function cleanArticleContent($content, $cleanup_selector)
+    {
+        $string_convert = false;
+        if (is_string($content)) {
+            $string_convert = true;
+            $content = str_get_html($content);
+        }
+
+        if (!empty($cleanup_selector)) {
+            foreach ($content->find($cleanup_selector) as $item_to_clean) {
+                $item_to_clean->outertext = '';
+            }
+        }
+
+        if ($string_convert) {
+            $content = $content->outertext;
+        }
+        return $content;
+    }
+
+    /**
+     * Retrieve first N link+title+truncated-content from webpage URL or DOM satisfying the specified criteria
+     * @param string|object $page URL or DOM to retrieve feed items from
      * @param string $url_selector DOM selector for matching links or their parent element
      * @param string $url_pattern Optional filter to keep only links matching the pattern
      * @param int $limit Optional maximum amount of URLs to return
-     * @return array of minimal feed items {'uri': entry_url, 'title', entry_title}
+     * @param string $content_cleanup Optional selector for removing elements, e.g. "div.ads, div.comments"
+     * @return array of items {'uri': entry_url, 'title': entry_title, ['content': when present in DOM] }
      */
-    protected function htmlFindLinks($page, $url_selector, $url_pattern = '', $limit = 0)
+    protected function htmlFindEntries($page, $url_selector, $url_pattern = '', $limit = 0, $content_cleanup = null)
     {
+        if (is_string($page)) {
+            $page = getSimpleHTMLDOM($page);
+        }
+
         $links = $page->find($url_selector);
 
         if (empty($links)) {
             returnClientError('No results for URL selector');
         }
 
-        $link_to_title = [];
+        $link_to_item = [];
         foreach ($links as $link) {
+            $item = [];
+            if ($link->innertext != $link->plaintext) {
+                $item['content'] = $link->innertext;
+            }
             if ($link->tag != 'a') {
                 $link = $link->find('a', 0);
             }
-            $link_to_title[$link->href] = $link->plaintext;
+            $item['uri'] = $link->href;
+            $item['title'] = $link->plaintext;
+            if (isset($item['content'])) {
+                $item['content'] = convertLazyLoading($item['content']);
+                $item['content'] = defaultLinkTo($item['content'], $item['uri']);
+                $item['content'] = $this->cleanArticleContent($item['content'], $content_cleanup);
+            }
+            $link_to_item[$link->href] = $item;
         }
 
-        $links = $this->filterUrlList(array_keys($link_to_title), $url_pattern, $limit);
+        $links = $this->filterUrlList(array_keys($link_to_item), $url_pattern, $limit);
 
         if (empty($links)) {
             returnClientError('No results for URL pattern');
@@ -158,10 +217,7 @@ class CssSelectorBridge extends BridgeAbstract
 
         $items = [];
         foreach ($links as $link) {
-            $item = [];
-            $item['uri'] = $link;
-            $item['title'] = $link_to_title[$link];
-            $items[] = $item;
+            $items[] = $link_to_item[$link];
         }
 
         return $items;
@@ -173,9 +229,10 @@ class CssSelectorBridge extends BridgeAbstract
      * @param string $content_selector HTML selector for extracting content, e.g. "article.content"
      * @param string $content_cleanup Optional selector for removing elements, e.g. "div.ads, div.comments"
      * @param string $title_cleanup Optional string to remove from article title, e.g. " | BlogName"
+     * @param string $title_default Optional title to use when could not extract title reliably
      * @return array Entry data: uri, title, content
      */
-    protected function expandEntryWithSelector($entry_url, $content_selector, $content_cleanup = null, $title_cleanup = null)
+    protected function expandEntryWithSelector($entry_url, $content_selector, $content_cleanup = null, $title_cleanup = null, $title_default = null)
     {
         if (empty($content_selector)) {
             returnClientError('Please specify a content selector');
@@ -190,18 +247,18 @@ class CssSelectorBridge extends BridgeAbstract
             returnClientError('Could not find content selector at URL: ' . $entry_url);
         }
 
-        if (!empty($content_cleanup)) {
-            foreach ($article_content->find($content_cleanup) as $item_to_clean) {
-                $item_to_clean->outertext = '';
-            }
-        }
-
         $article_content = convertLazyLoading($article_content);
         $article_content = defaultLinkTo($article_content, $entry_url);
+        $article_content = $this->cleanArticleContent($article_content, $content_cleanup);
+
+        $article_title = $this->getPageTitle($entry_html, $title_cleanup);
+        if (!empty($title_default) && (empty($article_title) || $article_title === $this->feedName)) {
+            $article_title = $title_default;
+        }
 
         $item = [];
         $item['uri'] = $entry_url;
-        $item['title'] = $this->getPageTitle($entry_html, $title_cleanup);
+        $item['title'] = $article_title;
         $item['content'] = $article_content;
         return $item;
     }

From 235c084820cab9a75c88e46e5feda046cc63178f Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Wed, 26 Jul 2023 20:41:48 +0200
Subject: [PATCH 040/716] [DilbertBridge] Remove bridge (#3574)

dilbert.com has closed down.
---
 bridges/DilbertBridge.php | 36 ------------------------------------
 1 file changed, 36 deletions(-)
 delete mode 100644 bridges/DilbertBridge.php

diff --git a/bridges/DilbertBridge.php b/bridges/DilbertBridge.php
deleted file mode 100644
index cd509ea4..00000000
--- a/bridges/DilbertBridge.php
+++ /dev/null
@@ -1,36 +0,0 @@
-<?php
-
-class DilbertBridge extends BridgeAbstract
-{
-    const MAINTAINER = 'kranack';
-    const NAME = 'Dilbert Daily Strip';
-    const URI = 'https://dilbert.com';
-    const CACHE_TIMEOUT = 21600; // 6h
-    const DESCRIPTION = 'The Unofficial Dilbert Daily Comic Strip';
-
-    public function collectData()
-    {
-        $html = getSimpleHTMLDOM(self::URI);
-
-        foreach ($html->find('section.comic-item') as $element) {
-            $img = $element->find('img', 0);
-            $link = $element->find('a', 0);
-            $comic = $img->src;
-            $title = $img->alt;
-            $url = $link->href;
-            $date = substr(strrchr($url, '/'), 1);
-            if (empty($title)) {
-                $title = 'Dilbert Comic Strip on ' . $date;
-            }
-            $date = strtotime($date);
-
-            $item = [];
-            $item['uri'] = $url;
-            $item['title'] = $title;
-            $item['author'] = 'Scott Adams';
-            $item['timestamp'] = $date;
-            $item['content'] = '<img src="' . $comic . '" alt="' . $img->alt . '" />';
-            $this->items[] = $item;
-        }
-    }
-}

From bf4ea127196a318b3e0440d0e8be9d96fc186b13 Mon Sep 17 00:00:00 2001
From: Korytov Pavel <thexcloud@gmail.com>
Date: Wed, 26 Jul 2023 22:47:47 +0300
Subject: [PATCH 041/716] [ScientificAmerican] Fix bridge (#3575)

---
 bridges/ScientificAmericanBridge.php | 68 ++++++++++++----------------
 1 file changed, 30 insertions(+), 38 deletions(-)

diff --git a/bridges/ScientificAmericanBridge.php b/bridges/ScientificAmericanBridge.php
index 88635f58..d575bf94 100644
--- a/bridges/ScientificAmericanBridge.php
+++ b/bridges/ScientificAmericanBridge.php
@@ -25,10 +25,11 @@ class ScientificAmericanBridge extends FeedExpander
     ];
 
     const FEED = 'http://rss.sciam.com/ScientificAmerican-Global';
-    const ISSUES = 'https://www.scientificamerican.com/store/archive/?magazineFilterID=all';
+    const ISSUES = 'https://www.scientificamerican.com/archive/issues/2020s/';
 
     public function collectData()
     {
+        $this->collectIssues();
         $items = [
             ...$this->collectFeed(),
             ...$this->collectIssues()
@@ -49,7 +50,7 @@ class ScientificAmericanBridge extends FeedExpander
 
         if ($this->getInput('addContents') == 1) {
             usort($this->items, function ($item1, $item2) {
-                return $item1['timestamp'] < $item2['timestamp'];
+                return $item1['timestamp'] - $item2['timestamp'];
             });
         }
     }
@@ -65,8 +66,8 @@ class ScientificAmericanBridge extends FeedExpander
     private function collectIssues()
     {
         $html = getSimpleHTMLDOMCached(self::ISSUES);
-        $issues_root = $html->find('div.store-listing-group', 0);
-        $issues = $issues_root->find('div.store-listing-group__item');
+        $content = $html->getElementById('content')->children(3);
+        $issues = $content->children();
         $issues_count = min(
             (int)$this->getInput('parseIssues'),
             count($issues)
@@ -74,7 +75,7 @@ class ScientificAmericanBridge extends FeedExpander
 
         $items = [];
         for ($i = 0; $i < $issues_count; $i++) {
-            $a = $issues[$i]->find('a.store-listing__cta', 0);
+            $a = $issues[$i]->find('a', 0);
             $link = 'https://scientificamerican.com' . $a->getAttribute('href');
             array_push($items, ...$this->parseIssue($link));
         }
@@ -86,51 +87,42 @@ class ScientificAmericanBridge extends FeedExpander
         $items = [];
         $html = getSimpleHTMLDOMCached($issue_link);
 
-        $features = $html->find('section[data-issue-column="Features"]', 0);
+        $features = $html->find('[class^=Detail_issue__article__previews__featured]', 0);
         if ($features != null) {
-            $articles = $features->find('article');
+            $articles = $features->find('div', 0)->children();
             foreach ($articles as $article) {
-                $items[] = $this->parseIssueItem($article);
+                $h4 = $article->find('h4', 0);
+                $a = $h4->find('a', 0);
+                $link = 'https://scientificamerican.com' . $a->getAttribute('href');
+                $title = $a->plaintext;
+                $items[] = [
+                    'uri' => $link,
+                    'title' => $title,
+                    'uid' => $link,
+                    'content' => ''
+                ];
             }
         }
 
-        $departments = $html->find('section[data-issue-column="Departments"]', 0);
+        $departments = $html->find('[class^=Detail_issue__article__previews__departments]', 0);
         if ($departments != null) {
-            $lis = $departments->find('ul', 0)->find('li');
-            foreach ($lis as $li) {
-                $items[] = $this->parseIssueItem($li);
+            $headers = $departments->find('[class*=Listing_article__listing__title]');
+            foreach ($headers as $header) {
+                $a = $header->find('a', 0);
+                $link = 'https://scientificamerican.com' . $a->getAttribute('href');
+                $title = $a->plaintext;
+                $items[] = [
+                    'uri' => $link,
+                    'title' => $title,
+                    'uid' => $link,
+                    'content' => ''
+                ];
             }
         }
 
         return $items;
     }
 
-    private function parseIssueItem($article)
-    {
-        $title = $article->getAttribute('data-article-title');
-        $a = $article->find('a', 0);
-        $link = null;
-        if ($a != null) {
-            $link = $a->href;
-        } else {
-            [$kind, $v] = explode('-', $article->getAttribute('id'), 2);
-            $link = 'https://scientificamerican.com/' . $kind . '/' . $v;
-        }
-        $content = '';
-
-        $desc = $article->find('p.listing-wide__inner__desc', 0);
-        if ($desc != null) {
-            $content = $desc->plaintext;
-        }
-
-        return [
-            'uri' => $link,
-            'title' => $title,
-            'uid' => $link,
-            'content' => $content
-        ];
-    }
-
     private function updateItem($item)
     {
         $html = getSimpleHTMLDOMCached($item['uri']);

From f5f76f111b60b723791be05c1cbc521d1cad3aab Mon Sep 17 00:00:00 2001
From: Korytov Pavel <thexcloud@gmail.com>
Date: Wed, 26 Jul 2023 23:59:49 +0300
Subject: [PATCH 042/716] [TldrTechBridge] Add Web Dev and Founders sections
 (#3576)

---
 bridges/TldrTechBridge.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/bridges/TldrTechBridge.php b/bridges/TldrTechBridge.php
index ba7ebf6e..7d8febe1 100644
--- a/bridges/TldrTechBridge.php
+++ b/bridges/TldrTechBridge.php
@@ -23,7 +23,9 @@ class TldrTechBridge extends BridgeAbstract
                 'values' => [
                     'Tech' => 'tech',
                     'Crypto' => 'crypto',
-                    'AI' => 'ai'
+                    'AI' => 'ai',
+                    'Web Dev' => 'engineering',
+                    'Founders' => 'founders'
                 ],
                 'defaultValue' => 'tech'
             ]

From 11ce8b5dcd6f9b84249c974f1403a45b5b99d8f5 Mon Sep 17 00:00:00 2001
From: Aaron F <mail@aaron-fischer.net>
Date: Thu, 27 Jul 2023 23:54:17 +0200
Subject: [PATCH 043/716] CVEDetails got a new HTML layout. (#3577)

This fixes the parser for CVEDetails.
---
 bridges/CVEDetailsBridge.php | 41 ++++++++++++++++++++----------------
 1 file changed, 23 insertions(+), 18 deletions(-)

diff --git a/bridges/CVEDetailsBridge.php b/bridges/CVEDetailsBridge.php
index 38b37bb7..5334c170 100644
--- a/bridges/CVEDetailsBridge.php
+++ b/bridges/CVEDetailsBridge.php
@@ -61,7 +61,7 @@ class CVEDetailsBridge extends BridgeAbstract
         $html = getSimpleHTMLDOM($this->buildUrl());
         $this->html = defaultLinkTo($html, self::URI);
 
-        $vendor = $html->find('#contentdiv > h1 > a', 0);
+        $vendor = $html->find('#contentdiv h1 > a', 0);
         if ($vendor == null) {
             returnServerError('Invalid Vendor ID ' .
                 $this->getInput('vendor_id') .
@@ -70,7 +70,7 @@ class CVEDetailsBridge extends BridgeAbstract
         }
         $this->vendor = $vendor->innertext;
 
-        $product = $html->find('#contentdiv > h1 > a', 1);
+        $product = $html->find('#contentdiv h1 > a', 1);
         if ($product != null) {
             $this->product = $product->innertext;
         }
@@ -102,38 +102,43 @@ class CVEDetailsBridge extends BridgeAbstract
             $this->fetchContent();
         }
 
-        foreach ($this->html->find('#vulnslisttable .srrowns') as $i => $tr) {
+        foreach ($this->html->find('#searchresults > .row') as $i => $tr) {
             // There are some optional vulnerability types, which will be
             // added to the categories as well as the CWE number -- which is
             // always given.
             $categories = [$this->vendor];
             $enclosures = [];
 
-            $cwe = $tr->find('td', 2)->find('a', 0);
-            if ($cwe != null) {
-                $cwe = $cwe->innertext;
-                $categories[] = 'CWE-' . $cwe;
-                $enclosures[] = 'https://cwe.mitre.org/data/definitions/' . $cwe . '.html';
-            }
-            $c = $tr->find('td', 4)->innertext;
-            if (trim($c) != '') {
-                $categories[] = $c;
+            $detailLink = $tr->find('.cveheader > h3 > a', 0);
+            $detailHtml = getSimpleHTMLDOM($detailLink->href);
+
+            $div = $detailHtml->find('.cvedetailssummary', 0);
+
+            // The CVE number itself
+            $title = $div->find('h1 > a', 0)->innertext;
+            $content = $div->find('.ssc-paragraph', 0)->innertext;
+            $cweList = $detailHtml->find('h2', 2)->next_sibling();
+            foreach ($cweList->find('li') as $li) {
+                $cweWithDescription = $li->find('a', 0)->innertext;
+                preg_match('/CWE-(\d+)/', $cweWithDescription, $cwe);
+                if (count($cwe) > 1) {
+                    $categories[] = 'CWE-' . $cwe[1];
+                    $enclosures[] = 'https://cwe.mitre.org/data/definitions/' . $cwe[1] . '.html';
+                }
             }
+
             if ($this->product != '') {
                 $categories[] = $this->product;
             }
 
-            // The CVE number itself
-            $title = $tr->find('td', 1)->find('a', 0)->innertext;
-
             $this->items[] = [
-                'uri' => $tr->find('td', 1)->find('a', 0)->href,
+                'uri' => 'https://cvedetails.com/' . $detailHtml->find('h1 > a', 0)->href,
                 'title' => $title,
                 'timestamp' => $tr->find('td', 5)->innertext,
-                'content' => $tr->next_sibling()->innertext,
+                'content' => $content,
                 'categories' => $categories,
                 'enclosures' => $enclosures,
-                'uid' => $tr->find('td', 1)->find('a', 0)->innertext,
+                'uid' => $title,
             ];
 
             // We only want to fetch the latest 10 CVEs

From 701fe3cfeda0d14f1f49afe2bd0f89296214459e Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 29 Jul 2023 00:14:30 +0200
Subject: [PATCH 044/716] fix: various small fixes (#3578)

---
 bridges/AmazonPriceTrackerBridge.php  |  3 +--
 bridges/EBayBridge.php                | 21 +++++++++++++++-----
 bridges/FB2Bridge.php                 |  6 +++++-
 bridges/FilterBridge.php              | 13 +++++++++----
 bridges/GithubIssueBridge.php         |  3 ++-
 bridges/ImgsedBridge.php              |  5 ++++-
 bridges/ReutersBridge.php             | 28 +++++++++++++--------------
 bridges/RoadAndTrackBridge.php        |  7 ++++++-
 bridges/TikTokBridge.php              |  5 +++--
 bridges/VkBridge.php                  | 10 +++++++---
 bridges/YouTubeCommunityTabBridge.php | 16 +++++++++++----
 lib/Logger.php                        |  2 ++
 lib/TwitterClient.php                 |  7 ++++++-
 13 files changed, 87 insertions(+), 39 deletions(-)

diff --git a/bridges/AmazonPriceTrackerBridge.php b/bridges/AmazonPriceTrackerBridge.php
index 6de451f1..b07bdb7c 100644
--- a/bridges/AmazonPriceTrackerBridge.php
+++ b/bridges/AmazonPriceTrackerBridge.php
@@ -125,14 +125,13 @@ class AmazonPriceTrackerBridge extends BridgeAbstract
      */
     private function getImage($html)
     {
+        $image = 'https://placekitten.com/200/300';
         $imageSrc = $html->find('#main-image-container img', 0);
-
         if ($imageSrc) {
             $hiresImage = $imageSrc->getAttribute('data-old-hires');
             $dynamicImageAttribute = $imageSrc->getAttribute('data-a-dynamic-image');
             $image = $hiresImage ?: $this->parseDynamicImage($dynamicImageAttribute);
         }
-        $image = $image ?: 'https://placekitten.com/200/300';
 
         return <<<EOT
 <img width="300" style="max-width:300;max-height:300" src="$image" alt="{$this->title}" />
diff --git a/bridges/EBayBridge.php b/bridges/EBayBridge.php
index a867a179..66fad10c 100644
--- a/bridges/EBayBridge.php
+++ b/bridges/EBayBridge.php
@@ -66,16 +66,27 @@ class EBayBridge extends BridgeAbstract
                 $new_listing_label->remove();
             }
 
-            $item['title'] = $listing->find('.s-item__title', 0)->plaintext;
+            $listingTitle = $listing->find('.s-item__title', 0);
+            if ($listingTitle) {
+                $item['title'] = $listingTitle->plaintext;
+            }
 
             $subtitle = implode('', $listing->find('.s-item__subtitle'));
 
-            $item['uri'] = $listing->find('.s-item__link', 0)->href;
+            $listingUrl = $listing->find('.s-item__link', 0);
+            if ($listingUrl) {
+                $item['uri'] = $listingUrl->href;
+            } else {
+                $item['uri'] = null;
+            }
 
-            preg_match('/.*\/itm\/(\d+).*/i', $item['uri'], $matches);
-            $item['uid'] = $matches[1];
+            if (preg_match('/.*\/itm\/(\d+).*/i', $item['uri'], $matches)) {
+                $item['uid'] = $matches[1];
+            }
+
+            $priceDom = $listing->find('.s-item__details > .s-item__detail > .s-item__price', 0);
+            $price = $priceDom->plaintext ?? 'N/A';
 
-            $price = $listing->find('.s-item__details > .s-item__detail > .s-item__price', 0)->plaintext;
             $shippingFree = $listing->find('.s-item__details > .s-item__detail > .s-item__freeXDays', 0)->plaintext ?? '';
             $localDelivery = $listing->find('.s-item__details > .s-item__detail > .s-item__localDelivery', 0)->plaintext ?? '';
             $logisticsCost = $listing->find('.s-item__details > .s-item__detail > .s-item__logisticsCost', 0)->plaintext ?? '';
diff --git a/bridges/FB2Bridge.php b/bridges/FB2Bridge.php
index 19030dd2..141ea59b 100644
--- a/bridges/FB2Bridge.php
+++ b/bridges/FB2Bridge.php
@@ -304,7 +304,11 @@ EOD
         $regex = '/"pageID":"([0-9]*)"/';
         preg_match($regex, $pageContent, $matches);
 
-        return ['userId' => $matches[1], 'username' => $username];
+        $arr = [
+            'userId' => $matches[1] ?? null,
+            'username' => $username,
+        ];
+        return $arr;
     }
 
     public function getName()
diff --git a/bridges/FilterBridge.php b/bridges/FilterBridge.php
index 61ce6d78..992fe0c3 100644
--- a/bridges/FilterBridge.php
+++ b/bridges/FilterBridge.php
@@ -80,10 +80,15 @@ class FilterBridge extends FeedExpander
         // Generate title from first 50 characters of content?
         if ($this->getInput('title_from_content') && array_key_exists('content', $item)) {
             $content = str_get_html($item['content']);
-            $pos = strpos($item['content'], ' ', 50);
-            $item['title'] = substr($content->plaintext, 0, $pos);
-            if (strlen($content->plaintext) >= $pos) {
-                $item['title'] .= '...';
+            $plaintext = $content->plaintext;
+            if (mb_strlen($plaintext) < 51) {
+                $item['title'] = $plaintext;
+            } else {
+                $pos = strpos($item['content'], ' ', 50);
+                $item['title'] = substr($plaintext, 0, $pos);
+                if (strlen($plaintext) >= $pos) {
+                    $item['title'] .= '...';
+                }
             }
         }
 
diff --git a/bridges/GithubIssueBridge.php b/bridges/GithubIssueBridge.php
index a75aa252..e4e995e3 100644
--- a/bridges/GithubIssueBridge.php
+++ b/bridges/GithubIssueBridge.php
@@ -137,7 +137,8 @@ class GithubIssueBridge extends BridgeAbstract
     {
         $uri = $this->buildGitHubIssueCommentUri($issueNbr, $comment->id);
 
-        $author = $comment->find('.author', 0)->plaintext;
+        $authorDom = $comment->find('.author', 0);
+        $author = $authorDom->plaintext ?? null;
 
         $header = $comment->find('.timeline-comment-header > h3', 0);
         $title .= ' / ' . ($header ? $header->plaintext : 'Activity');
diff --git a/bridges/ImgsedBridge.php b/bridges/ImgsedBridge.php
index 6c49facb..1555c578 100644
--- a/bridges/ImgsedBridge.php
+++ b/bridges/ImgsedBridge.php
@@ -212,9 +212,12 @@ HTML,
     private function parseDate($content)
     {
         $date = date_create();
-        $relativeDate = date_interval_create_from_date_string(str_replace(' ago', '', $content));
+        $dateString = str_replace(' ago', '', $content);
+        $relativeDate = date_interval_create_from_date_string($dateString);
         if ($relativeDate) {
             date_sub($date, $relativeDate);
+        } else {
+            Logger::info(sprintf('Unable to parse date string: %s', $dateString));
         }
         return date_format($date, 'r');
     }
diff --git a/bridges/ReutersBridge.php b/bridges/ReutersBridge.php
index 63c838c2..2acadfc3 100644
--- a/bridges/ReutersBridge.php
+++ b/bridges/ReutersBridge.php
@@ -143,18 +143,6 @@ class ReutersBridge extends BridgeAbstract
         'wire'
     ];
 
-    /**
-     * Performs an HTTP request to the Reuters API and returns decoded JSON
-     * in the form of an associative array
-     * @param string $feed_uri Full API URL to fetch data
-     * @return array
-     */
-    private function getJson($uri)
-    {
-        $returned_data = getContents($uri);
-        return json_decode($returned_data, true);
-    }
-
     /**
      * Takes in data from Reuters Wire API and
      * creates structured data in the form of a list
@@ -295,8 +283,19 @@ class ReutersBridge extends BridgeAbstract
     {
         // This will make another request to API to get full detail of article and author's name.
         $url = $this->getAPIURL($feed_uri, 'article', $is_article_uid);
-        $rawData = $this->getJson($url);
 
+        try {
+            $json = getContents($url);
+            $rawData = Json::decode($json);
+        } catch (\JsonException $e) {
+            return [
+                'content' => '',
+                'author' => '',
+                'category' => '',
+                'images' => '',
+                'published_at' => ''
+            ];
+        }
         $article_content = '';
         $authorlist = '';
         $category = [];
@@ -494,7 +493,8 @@ EOD;
     {
         $endpoint = $this->getSectionEndpoint();
         $url = $this->getAPIURL($endpoint, 'section');
-        $data = $this->getJson($url);
+        $json = getContents($url);
+        $data = Json::decode($json);
 
         $stories = [];
         $section_name = '';
diff --git a/bridges/RoadAndTrackBridge.php b/bridges/RoadAndTrackBridge.php
index 31bd7ec8..c236036c 100644
--- a/bridges/RoadAndTrackBridge.php
+++ b/bridges/RoadAndTrackBridge.php
@@ -50,7 +50,12 @@ class RoadAndTrackBridge extends BridgeAbstract
         }
 
         $item['author'] = $article->find('.byline-name', 0)->innertext ?? '';
-        $item['timestamp'] = strtotime($article->find('.content-info-date', 0)->getAttribute('datetime'));
+
+        $contentInfoDate = $article->find('.content-info-date', 0);
+        if ($contentInfoDate) {
+            $datetime = $contentInfoDate->getAttribute('datetime');
+            $item['timestamp'] = strtotime($datetime);
+        }
 
         $content = $article->find('.content-container', 0);
         if ($content->find('.content-rail', 0) !== null) {
diff --git a/bridges/TikTokBridge.php b/bridges/TikTokBridge.php
index e7cac825..556e5ffc 100644
--- a/bridges/TikTokBridge.php
+++ b/bridges/TikTokBridge.php
@@ -33,8 +33,9 @@ class TikTokBridge extends BridgeAbstract
         $title = $html->find('h1', 0)->plaintext ?? self::NAME;
         $this->feedName = htmlspecialchars_decode($title);
 
-        $SIGI_STATE_RAW = $html->find('script[id=SIGI_STATE]', 0)->innertext;
-        $SIGI_STATE = json_decode($SIGI_STATE_RAW);
+        $var = $html->find('script[id=SIGI_STATE]', 0);
+        $SIGI_STATE_RAW = $var->innertext;
+        $SIGI_STATE = Json::decode($SIGI_STATE_RAW, false);
 
         foreach ($SIGI_STATE->ItemModule as $key => $value) {
             $item = [];
diff --git a/bridges/VkBridge.php b/bridges/VkBridge.php
index c5a9d4cc..967734ef 100644
--- a/bridges/VkBridge.php
+++ b/bridges/VkBridge.php
@@ -490,18 +490,22 @@ class VkBridge extends BridgeAbstract
 
     private function getContents()
     {
-        $header = ['Accept-language: en', 'Cookie: remixlang=3'];
+        $httpHeaders = [
+            'Accept-language: en',
+            'Cookie: remixlang=3',
+        ];
         $redirects = 0;
         $uri = $this->getURI();
 
         while ($redirects < 2) {
-            $response = getContents($uri, $header, [CURLOPT_FOLLOWLOCATION => false], true);
+            $response = getContents($uri, $httpHeaders, [CURLOPT_FOLLOWLOCATION => false], true);
 
             if (in_array($response['code'], [200, 304])) {
                 return $response['content'];
             }
 
-            $uri = urljoin(self::URI, $response['header']['location'][0]);
+            $headers = $response['headers'];
+            $uri = urljoin(self::URI, $headers['location'][0]);
 
             if (str_contains($uri, '/429.html')) {
                 returnServerError('VK responded "Too many requests"');
diff --git a/bridges/YouTubeCommunityTabBridge.php b/bridges/YouTubeCommunityTabBridge.php
index 32502f61..20822828 100644
--- a/bridges/YouTubeCommunityTabBridge.php
+++ b/bridges/YouTubeCommunityTabBridge.php
@@ -78,19 +78,27 @@ class YouTubeCommunityTabBridge extends BridgeAbstract
             returnServerError('Channel does not have a community tab');
         }
 
-        foreach ($this->getCommunityPosts($json) as $key => $post) {
+        $posts = $this->getCommunityPosts($json);
+        foreach ($posts as $key => $post) {
             $this->itemTitle = '';
 
             if (!isset($post->backstagePostThreadRenderer)) {
                 continue;
             }
 
-            $details = $post->backstagePostThreadRenderer->post->backstagePostRenderer;
+            if (isset($post->backstagePostThreadRenderer->post->backstagePostRenderer)) {
+                $details = $post->backstagePostThreadRenderer->post->backstagePostRenderer;
+            } elseif (isset($post->backstagePostThreadRenderer->post->sharedPostRenderer)) {
+                // todo: properly extract data from this shared post
+                $details = $post->backstagePostThreadRenderer->post->sharedPostRenderer;
+            } else {
+                continue;
+            }
 
             $item = [];
             $item['uri'] = self::URI . '/post/' . $details->postId;
-            $item['author'] = $details->authorText->runs[0]->text;
-            $item['content'] = '';
+            $item['author'] = $details->authorText->runs[0]->text ?? null;
+            $item['content'] = $item['uri'];
 
             if (isset($details->contentText->runs)) {
                 $text = $this->getText($details->contentText->runs);
diff --git a/lib/Logger.php b/lib/Logger.php
index 91b8e3c1..5423f62c 100644
--- a/lib/Logger.php
+++ b/lib/Logger.php
@@ -55,6 +55,8 @@ final class Logger
                 'Unable to find channel. The channel is non-existing or non-public',
                 // fb
                 'This group is not public! RSS-Bridge only supports public groups!',
+                'You must be logged in to view this page',
+                'Unable to get the page id. You should consider getting the ID by hand',
                 // tiktok 404
                 'https://www.tiktok.com/@',
             ];
diff --git a/lib/TwitterClient.php b/lib/TwitterClient.php
index 92c797d6..0c6b9535 100644
--- a/lib/TwitterClient.php
+++ b/lib/TwitterClient.php
@@ -155,7 +155,7 @@ class TwitterClient
                     throw $e;
                 }
             }
-        } else if ($operation == 'By list ID') {
+        } elseif ($operation === 'By list ID') {
             $id = $query['listId'];
         } else {
             throw new \Exception('Unknown operation to make list tweets');
@@ -348,6 +348,11 @@ class TwitterClient
             // Grab the first error message
             throw new \Exception(sprintf('From twitter api: "%s"', $response->errors[0]->message));
         }
+        if (!isset($response->data->user_by_screen_name->list)) {
+            throw new \Exception(
+                sprintf('Unable to find list in twitter response for %s, %s', $screenName, $listSlug)
+            );
+        }
         $listInfo = $response->data->user_by_screen_name->list;
         $this->data[$screenName . '-' . $listSlug] = $listInfo;
 

From 3a57fc800bfb399ee708794c31255566700369da Mon Sep 17 00:00:00 2001
From: mrtnvgr <48406064+mrtnvgr@users.noreply.github.com>
Date: Sun, 30 Jul 2023 11:46:16 +0700
Subject: [PATCH 045/716] DoujinStyleBridge: Update html tags (#3581)

---
 bridges/DoujinStyleBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/DoujinStyleBridge.php b/bridges/DoujinStyleBridge.php
index 84469739..0df96280 100644
--- a/bridges/DoujinStyleBridge.php
+++ b/bridges/DoujinStyleBridge.php
@@ -72,7 +72,7 @@ class DoujinStyleBridge extends BridgeAbstract
             $item['content'] = "<img src='$cover'/>";
 
             $keys = [];
-            foreach ($content->find('.pageWrap .pageSpan') as $key) {
+            foreach ($content->find('.pageWrap .pageSpan1') as $key) {
                 $keys[] = $key->plaintext;
             }
 

From 93eecdf79f83e9c9d19671b0e65e14d6287b4da4 Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Sun, 30 Jul 2023 23:26:59 +0200
Subject: [PATCH 046/716] [core] fix new bridge PRs not generating html preview
 artifacts (#3583)

* [core] replace everything except bridge name to get a valid whitelist.txt

* [core] do not use hard code repository name to improve working with forks

* [core] trim bridge names from whitelist.txt to reduce chance of failure
---
 .github/workflows/prhtmlgenerator.yml | 6 +++---
 lib/Configuration.php                 | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/prhtmlgenerator.yml b/.github/workflows/prhtmlgenerator.yml
index cacb6642..ce82aef1 100644
--- a/.github/workflows/prhtmlgenerator.yml
+++ b/.github/workflows/prhtmlgenerator.yml
@@ -18,11 +18,11 @@ jobs:
       - name: Check out rss-bridge
         run: |
           PR=${{github.event.number}};
-          wget -O requirements.txt https://raw.githubusercontent.com/RSS-Bridge/rss-bridge/master/.github/prtester-requirements.txt;
-          wget https://raw.githubusercontent.com/RSS-Bridge/rss-bridge/master/.github/prtester.py;
+          wget -O requirements.txt https://raw.githubusercontent.com/$GITHUB_REPOSITORY/${{ github.event.pull_request.base.ref }}/.github/prtester-requirements.txt;
+          wget https://raw.githubusercontent.com/$GITHUB_REPOSITORY/${{ github.event.pull_request.base.ref }}/.github/prtester.py;
           wget https://patch-diff.githubusercontent.com/raw/$GITHUB_REPOSITORY/pull/$PR.patch;
           touch DEBUG;
-          cat $PR.patch | grep " bridges/.*\.php" | sed "s= bridges/\(.*\)Bridge.php.*=\1=g" | sort | uniq > whitelist.txt
+          cat $PR.patch | grep "\bbridges/.*Bridge\.php\b" | sed "s=.*\bbridges/\(.*\)Bridge\.php\b.*=\1=g" | sort | uniq > whitelist.txt
       - name: Start Docker - Current
         run: |
           docker run -d -v $GITHUB_WORKSPACE/whitelist.txt:/app/whitelist.txt -v $GITHUB_WORKSPACE/DEBUG:/app/DEBUG -p 3000:80 ghcr.io/rss-bridge/rss-bridge:latest
diff --git a/lib/Configuration.php b/lib/Configuration.php
index 57a7db7e..f5615009 100644
--- a/lib/Configuration.php
+++ b/lib/Configuration.php
@@ -113,7 +113,7 @@ final class Configuration
             if ($enabledBridges === '*') {
                 self::setConfig('system', 'enabled_bridges', ['*']);
             } else {
-                self::setConfig('system', 'enabled_bridges', array_filter(explode("\n", $enabledBridges)));
+                self::setConfig('system', 'enabled_bridges', array_filter(array_map('trim', explode("\n", $enabledBridges))));
             }
         }
 

From f957eea3003a734acd8f9fa72ef13661cee277ed Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Mon, 31 Jul 2023 01:05:38 +0200
Subject: [PATCH 047/716] [FallGuysBridge] new bridge (#3584)

---
 bridges/FallGuysBridge.php | 134 +++++++++++++++++++++++++++++++++++++
 1 file changed, 134 insertions(+)
 create mode 100644 bridges/FallGuysBridge.php

diff --git a/bridges/FallGuysBridge.php b/bridges/FallGuysBridge.php
new file mode 100644
index 00000000..dbb34792
--- /dev/null
+++ b/bridges/FallGuysBridge.php
@@ -0,0 +1,134 @@
+<?php
+
+class FallGuysBridge extends BridgeAbstract
+{
+    const MAINTAINER = 'User123698745';
+    const NAME = 'Fall Guys';
+    const BASE_URI = 'https://www.fallguys.com';
+    const URI = self::BASE_URI . '/news';
+    const CACHE_TIMEOUT = 600; // 10min
+    const DESCRIPTION = 'News from the Fall Guys website';
+    const DEFAULT_LOCALE = 'en-US';
+    const PARAMETERS = [
+        [
+            'locale' => [
+                'name' => 'Language',
+                'type' => 'list',
+                'values' => [
+                    'English' => 'en-US',
+                    'لعربية' => 'ar',
+                    'Deutsch' => 'de',
+                    'Español (Spain)' => 'es-ES',
+                    'Español (LA)' => 'es-MX',
+                    'Français' => 'fr',
+                    'Italiano' => 'it',
+                    '日本語' => 'ja',
+                    '한국어' => 'ko',
+                    'Polski' => 'pl',
+                    'Português (Brasil)' => 'pt-BR',
+                    'Русский' => 'ru',
+                    'Türkçe' => 'tr',
+                    '简体中文' => 'zh-CN',
+                ],
+                'defaultValue' => self::DEFAULT_LOCALE,
+            ]
+        ]
+    ];
+
+    public function collectData()
+    {
+        $html = getSimpleHTMLDOM(self::getURI());
+
+        $data = json_decode($html->find('#__NEXT_DATA__', 0)->innertext);
+
+        foreach ($data->props->pageProps->newsList as $newsItem) {
+            $headerDescription = property_exists($newsItem->header, 'description') ? $newsItem->header->description : '';
+            $headerImage = $newsItem->header->image->src;
+
+            $contentImages = [$headerImage];
+
+            $content = <<<HTML
+            <p>{$headerDescription}</p>
+            <p><img src="{$headerImage}"></p>
+            HTML;
+
+            foreach ($newsItem->content->items as $contentItem) {
+                if (property_exists($contentItem, 'articleCopy')) {
+                    if (property_exists($contentItem->articleCopy, 'title')) {
+                        $title = $contentItem->articleCopy->title;
+
+                        $content .= <<<HTML
+                        <h2>{$title}</h2>
+                        HTML;
+                    }
+
+                    $text = $contentItem->articleCopy->copy;
+
+                    $content .= <<<HTML
+                    <p>{$text}</p>
+                    HTML;
+                } elseif (property_exists($contentItem, 'articleImage')) {
+                    $image = $contentItem->articleImage->imageSrc;
+
+                    if ($image != $headerImage) {
+                        $contentImages[] = $image;
+
+                        $content .= <<<HTML
+                        <p><img src="{$image}"></p>
+                        HTML;
+                    }
+                } elseif (property_exists($contentItem, 'embeddedVideo')) {
+                    $mediaOptions = $contentItem->embeddedVideo->mediaOptions;
+                    $mainContentOptions = $contentItem->embeddedVideo->mainContentOptions;
+
+                    if (count($mediaOptions) == count($mainContentOptions)) {
+                        for ($i = 0; $i < count($mediaOptions); $i++) {
+                            if (property_exists($mediaOptions[$i], 'youtubeVideo')) {
+                                $videoUrl = 'https://youtu.be/' . $mediaOptions[$i]->youtubeVideo->contentId;
+                                $image = $mainContentOptions[$i]->image->src;
+
+                                $content .= '<p>';
+
+                                if ($image != $headerImage) {
+                                    $contentImages[] = $image;
+
+                                    $content .= <<<HTML
+                                    <a href="{$videoUrl}"><img src="{$image}"></a><br>
+                                    HTML;
+                                }
+
+                                $content .= <<<HTML
+                                <i>(Video: <a href="{$videoUrl}">{$videoUrl}</a>)</i>
+                                HTML;
+
+                                $content .= '</p>';
+                            }
+                        }
+                    }
+                }
+            }
+
+            $item = [
+                'uid' => $newsItem->_id,
+                'uri' => self::getURI() . '/' . $newsItem->_slug,
+                'title' => $newsItem->_title,
+                'timestamp' => $newsItem->lastModified,
+                'content' => $content,
+                'enclosures' => $contentImages,
+            ];
+
+            $this->items[] = $item;
+        }
+    }
+
+    public function getURI()
+    {
+        $locale = $this->getInput('locale') ?? self::DEFAULT_LOCALE;
+        return self::BASE_URI . '/' . $locale . '/news';
+    }
+
+    public function getIcon()
+    {
+        return self::BASE_URI . '/favicon.ico';
+    }
+}

From f8fd05f08f114c0fa007075a1da6b780eb6a593f Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Mon, 31 Jul 2023 19:07:34 +0200
Subject: [PATCH 048/716] [CssSelectorBridge] Handling of missing links (#3585)

When using parent element as URL selector:

* If no <a> inside some elements, ignore them
* If no <a> inside ALL elements, report an error

Fixes #3573 #issuecomment-1656943318
---
 bridges/CssSelectorBridge.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/bridges/CssSelectorBridge.php b/bridges/CssSelectorBridge.php
index 2d7489de..ce158758 100644
--- a/bridges/CssSelectorBridge.php
+++ b/bridges/CssSelectorBridge.php
@@ -198,6 +198,9 @@ class CssSelectorBridge extends BridgeAbstract
             }
             if ($link->tag != 'a') {
                 $link = $link->find('a', 0);
+                if (is_null($link)) {
+                    continue;
+                }
             }
             $item['uri'] = $link->href;
             $item['title'] = $link->plaintext;
@@ -209,6 +212,10 @@ class CssSelectorBridge extends BridgeAbstract
             $link_to_item[$link->href] = $item;
         }
 
+        if (empty($link_to_item)) {
+            returnClientError('The provided URL selector matches some elements, but they do not contain links.');
+        }
+
         $links = $this->filterUrlList(array_keys($link_to_item), $url_pattern, $limit);
 
         if (empty($links)) {

From 8b6eecea25c7ffbc9c55b6905f07588881200a90 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Mon, 31 Jul 2023 20:43:11 +0200
Subject: [PATCH 049/716] docs: add note about expensive operation (#3579)

---
 bridges/VkBridge.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/bridges/VkBridge.php b/bridges/VkBridge.php
index 967734ef..8c18f26a 100644
--- a/bridges/VkBridge.php
+++ b/bridges/VkBridge.php
@@ -84,7 +84,10 @@ class VkBridge extends BridgeAbstract
         foreach ($html->find('div.replies') as $comment_block) {
             $comment_block->outertext = '';
         }
-        $html->load($html->save());
+
+        // expensive operation
+        $save = $html->save();
+        $html->load($save);
 
         $pinned_post_item = null;
         $last_post_id = 0;

From 7e4807530ec6199ac9754bce54f025a113edfbbe Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Mon, 31 Jul 2023 20:43:18 +0200
Subject: [PATCH 050/716] fix: various small fixes (#3580)

---
 bridges/AppleMusicBridge.php  |  4 +++-
 bridges/AskfmBridge.php       |  3 ++-
 bridges/FeedReducerBridge.php | 17 +++++++++--------
 bridges/FourchanBridge.php    |  3 ++-
 bridges/GettrBridge.php       |  3 ++-
 bridges/TelegramBridge.php    | 12 ++++++++++--
 bridges/TikTokBridge.php      |  3 +++
 lib/BridgeAbstract.php        |  4 ++++
 8 files changed, 35 insertions(+), 14 deletions(-)

diff --git a/bridges/AppleMusicBridge.php b/bridges/AppleMusicBridge.php
index 4c3e0e2f..900a7009 100644
--- a/bridges/AppleMusicBridge.php
+++ b/bridges/AppleMusicBridge.php
@@ -40,6 +40,8 @@ class AppleMusicBridge extends BridgeAbstract
 
         foreach ($json->results as $obj) {
             if ($obj->wrapperType === 'collection') {
+                $copyright = $obj->copyright ?? '';
+
                 $this->items[] = [
                     'title' => $obj->artistName . ' - ' . $obj->collectionName,
                     'uri' => $obj->collectionViewUrl,
@@ -49,7 +51,7 @@ class AppleMusicBridge extends BridgeAbstract
                     . '><img src="' . $obj->artworkUrl100 . '" /></a><br><br>'
                     . $obj->artistName . ' - ' . $obj->collectionName
                     . '<br>'
-                    . $obj->copyright,
+                    . $copyright,
                 ];
             }
         }
diff --git a/bridges/AskfmBridge.php b/bridges/AskfmBridge.php
index 0a326417..d0422890 100644
--- a/bridges/AskfmBridge.php
+++ b/bridges/AskfmBridge.php
@@ -37,7 +37,8 @@ class AskfmBridge extends BridgeAbstract
 
             $item['timestamp'] = strtotime($element->find('time', 0)->datetime);
 
-            $answer = trim($element->find('div.streamItem_content', 0)->innertext);
+            $var = $element->find('div.streamItem_content', 0);
+            $answer = trim($var->innertext ?? '');
 
             // This probably should be cleaned up, especially for YouTube embeds
             if ($visual = $element->find('div.streamItem_visual', 0)) {
diff --git a/bridges/FeedReducerBridge.php b/bridges/FeedReducerBridge.php
index a37824c9..37bf9809 100644
--- a/bridges/FeedReducerBridge.php
+++ b/bridges/FeedReducerBridge.php
@@ -23,8 +23,9 @@ class FeedReducerBridge extends FeedExpander
 
     public function collectData()
     {
-        if (preg_match('#^http(s?)://#i', $this->getInput('url'))) {
-            $this->collectExpandableDatas($this->getInput('url'));
+        $url = $this->getInput('url');
+        if (preg_match('#^http(s?)://#i', $url)) {
+            $this->collectExpandableDatas($url);
         } else {
             throw new Exception('URI must begin with http(s)://');
         }
@@ -35,7 +36,7 @@ class FeedReducerBridge extends FeedExpander
         $filteredItems = [];
         $intPercentage = (int)preg_replace('/[^0-9]/', '', $this->getInput('percentage'));
 
-        foreach ($this->items as $thisItem) {
+        foreach ($this->items as $item) {
             // The URL is included in the hash:
             //  - so you can change the output by adding a local-part to the URL
             //  - so items with the same URI in different feeds won't be correlated
@@ -43,13 +44,13 @@ class FeedReducerBridge extends FeedExpander
             // $pseudoRandomInteger will be a 16 bit unsigned int mod 100.
             // This won't be uniformly distributed 1-100, but should be close enough.
 
-            $pseudoRandomInteger = unpack(
-                'S', // unsigned 16-bit int
-                hash('sha256', $thisItem['uri'] . '::' . $this->getInput('url'), true)
-            )[1] % 100;
+            $data = $item['uri'] . '::' . $this->getInput('url');
+            $hash = hash('sha256', $data, true);
+            // S = unsigned 16-bit int
+            $pseudoRandomInteger = unpack('S', $hash)[1] % 100;
 
             if ($pseudoRandomInteger < $intPercentage) {
-                $filteredItems[] = $thisItem;
+                $filteredItems[] = $item;
             }
         }
 
diff --git a/bridges/FourchanBridge.php b/bridges/FourchanBridge.php
index 179ae91f..f67d6026 100644
--- a/bridges/FourchanBridge.php
+++ b/bridges/FourchanBridge.php
@@ -45,7 +45,8 @@ class FourchanBridge extends BridgeAbstract
             $file = $element->find('.file', 0);
 
             if (!empty($file)) {
-                $item['image'] = $element->find('.file a', 0)->href;
+                $var = $element->find('.file a', 0);
+                $item['image'] = $var->href ?? '';
                 $item['imageThumb'] = $element->find('.file img', 0)->src;
                 if (!isset($item['imageThumb']) and strpos($item['image'], '.swf') !== false) {
                     $item['imageThumb'] = 'http://i.imgur.com/eO0cxf9.jpg';
diff --git a/bridges/GettrBridge.php b/bridges/GettrBridge.php
index 2b019523..74804043 100644
--- a/bridges/GettrBridge.php
+++ b/bridges/GettrBridge.php
@@ -27,9 +27,10 @@ class GettrBridge extends BridgeAbstract
 
     public function collectData()
     {
+        $user = $this->getInput('user');
         $api = sprintf(
             'https://api.gettr.com/u/user/%s/posts?offset=0&max=%s&dir=fwd&incl=posts&fp=f_uo',
-            $this->getInput('user'),
+            $user,
             min($this->getInput('limit'), 20)
         );
         $data = json_decode(getContents($api), false);
diff --git a/bridges/TelegramBridge.php b/bridges/TelegramBridge.php
index 14359009..9d73e06e 100644
--- a/bridges/TelegramBridge.php
+++ b/bridges/TelegramBridge.php
@@ -169,11 +169,19 @@ EOD;
             $stickerDiv->find('picture', 0)->style = '';
 
             return $stickerDiv;
-        } elseif (preg_match(self::BACKGROUND_IMAGE_REGEX, $stickerDiv->find('i', 0)->style, $sticker)) {
-            return <<<EOD
+        }
+
+        $var = $stickerDiv->find('i', 0);
+        if ($var) {
+            $style = $var->style;
+            if (preg_match(self::BACKGROUND_IMAGE_REGEX, $style, $sticker)) {
+                return <<<EOD
 				<a href="{$stickerDiv->children(0)->herf}"><img src="{$sticker[1]}"></a>
 EOD;
+            }
         }
+
+        return '';
     }
 
     private function processPoll($messageDiv)
diff --git a/bridges/TikTokBridge.php b/bridges/TikTokBridge.php
index 556e5ffc..769bc625 100644
--- a/bridges/TikTokBridge.php
+++ b/bridges/TikTokBridge.php
@@ -34,6 +34,9 @@ class TikTokBridge extends BridgeAbstract
         $this->feedName = htmlspecialchars_decode($title);
 
         $var = $html->find('script[id=SIGI_STATE]', 0);
+        if (!$var) {
+            throw new \Exception('Unable to find tiktok user data for ' . $this->processUsername());
+        }
         $SIGI_STATE_RAW = $var->innertext;
         $SIGI_STATE = Json::decode($SIGI_STATE_RAW, false);
 
diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index eb9d5a3c..61eafb57 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -144,6 +144,10 @@ abstract class BridgeAbstract implements BridgeInterface
         }
 
         foreach ($contexts as $context) {
+            if (!isset(static::PARAMETERS[$context])) {
+                // unknown context provided by client, throw exception here? or continue?
+            }
+
             foreach (static::PARAMETERS[$context] as $name => $properties) {
                 if (isset($this->inputs[$context][$name]['value'])) {
                     continue;

From 8e2353ad3e683c94d9727c5cd9efa53df76ea4c7 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 1 Aug 2023 06:19:42 +0200
Subject: [PATCH 051/716] fix: write to cache only if data is was not cached,
 fix #3586 (#3588)

---
 lib/contents.php | 2 --
 1 file changed, 2 deletions(-)

diff --git a/lib/contents.php b/lib/contents.php
index 5587a98e..c842ccbc 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -432,8 +432,6 @@ function getSimpleHTMLDOMCached(
     $content = $cache->loadData($timeout);
     if (!$content || Debug::isEnabled()) {
         $content = getContents($url, $header ?? [], $opts ?? []);
-    }
-    if ($content) {
         $cache->setScope('pages');
         $cache->setKey([$url]);
         $cache->saveData($content);

From 10f7b6f4f6652039361bccbb9392a5e3f13d7ff2 Mon Sep 17 00:00:00 2001
From: mruac <ant8672@gmail.com>
Date: Wed, 2 Aug 2023 03:05:06 +0930
Subject: [PATCH 052/716] Fix php8.2 deprecated warning when using bridge
 specific configurations (#3587)

* Fix php8.2 deprecated warning

Fix php8.2 warning: `Deprecated: Creation of dynamic property is deprecated`

* fix

* refactor: remove unused method

---------

Co-authored-by: Dag <me@dvikan.no>
---
 lib/BridgeAbstract.php  | 13 +++++--------
 lib/BridgeInterface.php |  5 -----
 2 files changed, 5 insertions(+), 13 deletions(-)

diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index 61eafb57..e58ddb91 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -58,8 +58,6 @@ abstract class BridgeAbstract implements BridgeInterface
 
     /**
      * Configuration for the bridge
-     *
-     * Use {@see BridgeAbstract::getConfiguration()} to read this parameter
      */
     const CONFIGURATION = [];
 
@@ -113,6 +111,11 @@ abstract class BridgeAbstract implements BridgeInterface
      */
     protected $queriedContext = '';
 
+    /**
+     * Holds the list of bridge-specific configurations from config.ini.php, used by the bridge.
+     */
+    private array $configuration = [];
+
     /** {@inheritdoc} */
     public function getItems()
     {
@@ -365,12 +368,6 @@ abstract class BridgeAbstract implements BridgeInterface
         return static::URI . '/favicon.ico';
     }
 
-    /** {@inheritdoc} */
-    public function getConfiguration()
-    {
-        return static::CONFIGURATION;
-    }
-
     /** {@inheritdoc} */
     public function getParameters()
     {
diff --git a/lib/BridgeInterface.php b/lib/BridgeInterface.php
index b461ed12..977ad7f6 100644
--- a/lib/BridgeInterface.php
+++ b/lib/BridgeInterface.php
@@ -60,11 +60,6 @@ interface BridgeInterface
      */
     public function collectData();
 
-    /**
-    * Get the user's supplied configuration for the bridge
-    */
-    public function getConfiguration();
-
     /**
      * Returns the value for the selected configuration
      *

From ed97ce8646f869450cf94fa75828d15d5bacf53e Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 1 Aug 2023 19:35:15 +0200
Subject: [PATCH 053/716] fix: dont fail for non-existing enabled bridge
 (#3589)

* fix: dont fail for non-existing enabled bridge

* yup
---
 actions/ConnectivityAction.php   | 10 ++++++----
 actions/DisplayAction.php        |  9 +++++++--
 actions/SetBridgeCacheAction.php |  6 +++++-
 lib/BridgeFactory.php            | 12 +++++++-----
 4 files changed, 25 insertions(+), 12 deletions(-)

diff --git a/actions/ConnectivityAction.php b/actions/ConnectivityAction.php
index c11e6595..604b7806 100644
--- a/actions/ConnectivityAction.php
+++ b/actions/ConnectivityAction.php
@@ -37,12 +37,14 @@ class ConnectivityAction implements ActionInterface
             throw new \Exception('This action is only available in debug mode!');
         }
 
-        if (!isset($request['bridge'])) {
+        $bridgeName = $request['bridge'] ?? null;
+        if (!$bridgeName) {
             return render_template('connectivity.html.php');
         }
-
-        $bridgeClassName = $this->bridgeFactory->createBridgeClassName($request['bridge']);
-
+        $bridgeClassName = $this->bridgeFactory->createBridgeClassName($bridgeName);
+        if (!$bridgeClassName) {
+            throw new \Exception(sprintf('Bridge not found: %s', $bridgeName));
+        }
         return $this->reportBridgeConnectivity($bridgeClassName);
     }
 
diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 129d4587..7b2efec1 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -33,9 +33,15 @@ class DisplayAction implements ActionInterface
     private function createResponse(array $request)
     {
         $bridgeFactory = new BridgeFactory();
-        $bridgeClassName = $bridgeFactory->createBridgeClassName($request['bridge'] ?? '');
+        $formatFactory = new FormatFactory();
 
+        $bridgeName = $request['bridge'] ?? null;
         $format = $request['format'] ?? null;
+
+        $bridgeClassName = $bridgeFactory->createBridgeClassName($bridgeName);
+        if (!$bridgeClassName) {
+            throw new \Exception(sprintf('Bridge not found: %s', $bridgeName));
+        }
         if (!$format) {
             throw new \Exception('You must specify a format!');
         }
@@ -43,7 +49,6 @@ class DisplayAction implements ActionInterface
             throw new \Exception('This bridge is not whitelisted');
         }
 
-        $formatFactory = new FormatFactory();
         $format = $formatFactory->create($format);
 
         $bridge = $bridgeFactory->create($bridgeClassName);
diff --git a/actions/SetBridgeCacheAction.php b/actions/SetBridgeCacheAction.php
index a9a598bd..416f2378 100644
--- a/actions/SetBridgeCacheAction.php
+++ b/actions/SetBridgeCacheAction.php
@@ -23,7 +23,11 @@ class SetBridgeCacheAction implements ActionInterface
 
         $bridgeFactory = new BridgeFactory();
 
-        $bridgeClassName = $bridgeFactory->createBridgeClassName($request['bridge'] ?? '');
+        $bridgeName = $request['bridge'] ?? null;
+        $bridgeClassName = $bridgeFactory->createBridgeClassName($bridgeName);
+        if (!$bridgeClassName) {
+            throw new \Exception(sprintf('Bridge not found: %s', $bridgeName));
+        }
 
         // whitelist control
         if (!$bridgeFactory->isEnabled($bridgeClassName)) {
diff --git a/lib/BridgeFactory.php b/lib/BridgeFactory.php
index db2c394a..63633f4a 100644
--- a/lib/BridgeFactory.php
+++ b/lib/BridgeFactory.php
@@ -23,7 +23,12 @@ final class BridgeFactory
                 $this->enabledBridges = $this->bridgeClassNames;
                 break;
             }
-            $this->enabledBridges[] = $this->createBridgeClassName($enabledBridge);
+            $bridgeClassName = $this->createBridgeClassName($enabledBridge);
+            if ($bridgeClassName) {
+                $this->enabledBridges[] = $bridgeClassName;
+            } else {
+                Logger::info(sprintf('Bridge not found: %s', $enabledBridge));
+            }
         }
     }
 
@@ -42,13 +47,10 @@ final class BridgeFactory
         $name = self::normalizeBridgeName($bridgeName);
         $namesLoweredCase = array_map('strtolower', $this->bridgeClassNames);
         $nameLoweredCase = strtolower($name);
-
         if (! in_array($nameLoweredCase, $namesLoweredCase)) {
-            throw new \Exception(sprintf('Bridge name invalid: %s', $bridgeName));
+            return null;
         }
-
         $index = array_search($nameLoweredCase, $namesLoweredCase);
-
         return $this->bridgeClassNames[$index];
     }
 

From 7661a78a43dbeb9ccba90a83bab4b68203a3c908 Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Thu, 3 Aug 2023 03:10:24 +0200
Subject: [PATCH 054/716] [core] add bridge not found warning message to
 frontpage (#3591)

---
 actions/FrontpageAction.php | 10 +++++++++-
 lib/BridgeFactory.php       |  7 +++++++
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/actions/FrontpageAction.php b/actions/FrontpageAction.php
index 40d25ea4..64281b1e 100644
--- a/actions/FrontpageAction.php
+++ b/actions/FrontpageAction.php
@@ -4,12 +4,20 @@ final class FrontpageAction implements ActionInterface
 {
     public function execute(array $request)
     {
+        $messages = [];
         $showInactive = (bool) ($request['show_inactive'] ?? null);
         $activeBridges = 0;
 
         $bridgeFactory = new BridgeFactory();
         $bridgeClassNames = $bridgeFactory->getBridgeClassNames();
 
+        foreach ($bridgeFactory->getMissingEnabledBridges() as $missingEnabledBridge) {
+            $messages[] = [
+                'body' => sprintf('Warning : Bridge "%s" not found', $missingEnabledBridge),
+                'level' => 'warning'
+            ];
+        }
+
         $formatFactory = new FormatFactory();
         $formats = $formatFactory->getFormatNames();
 
@@ -24,7 +32,7 @@ final class FrontpageAction implements ActionInterface
         }
 
         return render(__DIR__ . '/../templates/frontpage.html.php', [
-            'messages' => [],
+            'messages' => $messages,
             'admin_email' => Configuration::getConfig('admin', 'email'),
             'admin_telegram' => Configuration::getConfig('admin', 'telegram'),
             'bridges' => $body,
diff --git a/lib/BridgeFactory.php b/lib/BridgeFactory.php
index 63633f4a..f302a27a 100644
--- a/lib/BridgeFactory.php
+++ b/lib/BridgeFactory.php
@@ -4,6 +4,7 @@ final class BridgeFactory
 {
     private $bridgeClassNames = [];
     private $enabledBridges = [];
+    private $missingEnabledBridges = [];
 
     public function __construct()
     {
@@ -27,6 +28,7 @@ final class BridgeFactory
             if ($bridgeClassName) {
                 $this->enabledBridges[] = $bridgeClassName;
             } else {
+                $this->missingEnabledBridges[] = $enabledBridge;
                 Logger::info(sprintf('Bridge not found: %s', $enabledBridge));
             }
         }
@@ -69,4 +71,9 @@ final class BridgeFactory
     {
         return $this->bridgeClassNames;
     }
+
+    public function getMissingEnabledBridges(): array
+    {
+        return $this->missingEnabledBridges;
+    }
 }

From d32419ffcf979754a4a73219729af0745a73e5bf Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Thu, 3 Aug 2023 22:43:55 +0200
Subject: [PATCH 055/716] added the option for a sessioncookie in heiseBridge
 (#3596)

* added the option for a sessioncookie

with a valid cookie you can get full heise+ (paywall) articles

* formating

* lint

---------

Co-authored-by: Dag <me@dvikan.no>
---
 bridges/HeiseBridge.php | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/bridges/HeiseBridge.php b/bridges/HeiseBridge.php
index ec8bb96f..08c43dc5 100644
--- a/bridges/HeiseBridge.php
+++ b/bridges/HeiseBridge.php
@@ -103,6 +103,16 @@ class HeiseBridge extends FeedExpander
             'required' => false,
             'title' => 'Specify number of full articles to return',
             'defaultValue' => 5
+        ],
+        'sessioncookie' => [
+            'name' => 'Session Cookie',
+            'required' => false,
+            'title' => <<<'TITLE'
+                If you have a heise+ subscription,
+                you can enter your cookie (ssohls) here to
+                have heise+ articles displayed in full.
+                By default the cookie is 1 year valid.
+                TITLE,
         ]
     ]];
     const LIMIT = 5;
@@ -118,6 +128,7 @@ class HeiseBridge extends FeedExpander
     protected function parseItem($feedItem)
     {
         $item = parent::parseItem($feedItem);
+        $sessioncookie = $this->getInput('sessioncookie');
 
         // strip rss parameter
         $item['uri'] = explode('?', $item['uri'])[0];
@@ -128,13 +139,15 @@ class HeiseBridge extends FeedExpander
         }
 
         // abort on heise+ articles and link to archive.ph for full-text content
-        if (str_starts_with($item['title'], 'heise+ |')) {
+        if ($sessioncookie == '' && str_starts_with($item['title'], 'heise+ |')) {
             $item['uri'] = 'https://archive.ph/?run=1&url=' . urlencode($item['uri']);
             return $item;
         }
 
         $item['uri'] .= '?seite=all';
-        $article = getSimpleHTMLDOMCached($item['uri']);
+        $article = getSimpleHTMLDOM($item['uri'], [
+            'cookie: ssohls=' . $sessioncookie
+        ]);
 
         if ($article) {
             $article = defaultLinkTo($article, $item['uri']);

From 4976cd227ea8c92003bbf252fb8236f3980e3a8a Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Fri, 4 Aug 2023 22:14:08 +0200
Subject: [PATCH 056/716] [FeedExpander] support xhtml content / content with
 child elements (#3598)

* [core] support xhtml content type in FeedExpander

* [FilterBridge] change defaultValue to exampleValue

* [core] support content with child elements in FeedExpander
---
 bridges/FilterBridge.php |  2 +-
 lib/FeedExpander.php     | 11 ++++++++++-
 2 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/bridges/FilterBridge.php b/bridges/FilterBridge.php
index 992fe0c3..ef739de3 100644
--- a/bridges/FilterBridge.php
+++ b/bridges/FilterBridge.php
@@ -12,7 +12,7 @@ class FilterBridge extends FeedExpander
         'url' => [
             'name' => 'Feed URL',
             'type'  => 'text',
-            'defaultValue' => 'https://lorem-rss.herokuapp.com/feed?unit=day',
+            'exampleValue' => 'https://lorem-rss.herokuapp.com/feed?unit=day',
             'required' => true,
         ],
         'filter' => [
diff --git a/lib/FeedExpander.php b/lib/FeedExpander.php
index 1bac6179..c91586d7 100644
--- a/lib/FeedExpander.php
+++ b/lib/FeedExpander.php
@@ -308,7 +308,16 @@ abstract class FeedExpander extends BridgeAbstract
             $item['author'] = (string)$feedItem->author->name;
         }
         if (isset($feedItem->content)) {
-            $item['content'] = (string)$feedItem->content;
+            $contentChildren = $feedItem->content->children();
+            if (count($contentChildren) > 0) {
+                $content = '';
+                foreach ($contentChildren as $contentChild) {
+                    $content .= $contentChild->asXML();
+                }
+                $item['content'] = $content;
+            } else {
+                $item['content'] = (string)$feedItem->content;
+            }
         }
 
         //When "link" field is present, URL is more reliable than "id" field

From 3e3481bd7ae8ec1fde063202748a2e41a468d393 Mon Sep 17 00:00:00 2001
From: Niehztog <Niehztog@users.noreply.github.com>
Date: Mon, 7 Aug 2023 05:33:35 +0200
Subject: [PATCH 057/716] adds Nius bridge (#3599)

* adds Nius bridge

* fix linter errors

* fix linter errors

* fix linter errors

* fix extract author
---
 bridges/NiusBridge.php | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 bridges/NiusBridge.php

diff --git a/bridges/NiusBridge.php b/bridges/NiusBridge.php
new file mode 100644
index 00000000..e5773a7d
--- /dev/null
+++ b/bridges/NiusBridge.php
@@ -0,0 +1,32 @@
+<?php
+
+class NiusBridge extends XPathAbstract
+{
+    const NAME = 'Nius';
+    const URI = 'https://www.nius.de/news';
+    const DESCRIPTION = 'Die Stimme der Mehrheit';
+    const MAINTAINER = 'Niehztog';
+    //const PARAMETERS = array();
+    const CACHE_TIMEOUT = 3600;
+
+    const FEED_SOURCE_URL = 'https://www.nius.de/news';
+    const XPATH_EXPRESSION_ITEM = './/div[contains(@class, "compact-story") or contains(@class, "regular-story")]';
+    const XPATH_EXPRESSION_ITEM_TITLE = './/h2[@class="title"]//node()';
+    const XPATH_EXPRESSION_ITEM_CONTENT = './/h2[@class="title"]//node()';
+    const XPATH_EXPRESSION_ITEM_URI = './/a[1]/@href';
+
+    const XPATH_EXPR_AUTHOR_PART1 = 'normalize-space(.//span[@class="author"]/text()[1])';
+    const XPATH_EXPR_AUTHOR_PART2 = 'normalize-space(.//span[@class="author"]/text()[2])';
+    const XPATH_EXPRESSION_ITEM_AUTHOR = 'substring-after(concat(' . self::XPATH_EXPR_AUTHOR_PART1 . ', " ", ' . self::XPATH_EXPR_AUTHOR_PART2 . '), " ")';
+
+    //const XPATH_EXPRESSION_ITEM_TIMESTAMP = './/td[3]';
+    const XPATH_EXPRESSION_ITEM_ENCLOSURES = './/img[1]/@src';
+    const XPATH_EXPRESSION_ITEM_CATEGORIES = './/div[@class="subtitle"]/text()';
+    const SETTING_FIX_ENCODING = false;
+
+    protected function cleanMediaUrl($mediaUrl)
+    {
+        $result = preg_match('~https:\/\/www\.nius\.de\/_next\/image\?url=(.*)\?~', $mediaUrl, $matches);
+        return $result ? $matches[1] : $mediaUrl;
+    }
+}

From cf6d94dc2ad9e96e8dc2dfdee26c63f936a92963 Mon Sep 17 00:00:00 2001
From: Korytov Pavel <thexcloud@gmail.com>
Date: Tue, 8 Aug 2023 09:58:08 +0500
Subject: [PATCH 058/716] [EconomistBridge] Fix strange image urls (#3600)

---
 bridges/EconomistBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/EconomistBridge.php b/bridges/EconomistBridge.php
index 1b15555d..9a73a852 100644
--- a/bridges/EconomistBridge.php
+++ b/bridges/EconomistBridge.php
@@ -159,7 +159,7 @@ class EconomistBridge extends FeedExpander
             $svelte->parent->removeChild($svelte);
         }
         foreach ($elem->find('img') as $strange_img) {
-            if (!str_contains($strange_img->src, 'https://economist.com')) {
+            if (!str_contains($strange_img->src, 'economist.com')) {
                 $strange_img->src = 'https://economist.com' . $strange_img->src;
             }
         }

From 43ec82179b0c255c5587449d7191307bda9434d4 Mon Sep 17 00:00:00 2001
From: adminvulcano <derwolf8@outlook.de>
Date: Tue, 8 Aug 2023 07:00:07 +0200
Subject: [PATCH 059/716] [TldrTechBridge] Add Cybersecurity section (#3601)

---
 bridges/TldrTechBridge.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/bridges/TldrTechBridge.php b/bridges/TldrTechBridge.php
index 7d8febe1..b89686bb 100644
--- a/bridges/TldrTechBridge.php
+++ b/bridges/TldrTechBridge.php
@@ -25,7 +25,8 @@ class TldrTechBridge extends BridgeAbstract
                     'Crypto' => 'crypto',
                     'AI' => 'ai',
                     'Web Dev' => 'engineering',
-                    'Founders' => 'founders'
+                    'Founders' => 'founders',
+                    'Cybersecurity' => 'cybersecurity'
                 ],
                 'defaultValue' => 'tech'
             ]

From b86ee5778bc34fe032439f540c8a1e2c1e6b3ec9 Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Tue, 8 Aug 2023 15:02:01 +0200
Subject: [PATCH 060/716] [SitemapBridge] Add SitemapBridge (#3602)

* [SitemapBridge] Add SitemapBridge

This bridge is a variant of CssSelectorBridge.
Instead of retrieving article list from home page,
retrieves article list from SEO sitemap.xml.
Requires CssSelectorBridge to be installed.

* [SitemapBridge] Code linting
---
 bridges/SitemapBridge.php | 152 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 152 insertions(+)
 create mode 100644 bridges/SitemapBridge.php

diff --git a/bridges/SitemapBridge.php b/bridges/SitemapBridge.php
new file mode 100644
index 00000000..eec9d658
--- /dev/null
+++ b/bridges/SitemapBridge.php
@@ -0,0 +1,152 @@
+<?php
+
+class SitemapBridge extends CssSelectorBridge
+{
+    const MAINTAINER = 'ORelio';
+    const NAME = 'Sitemap Bridge';
+    const URI = 'https://github.com/RSS-Bridge/rss-bridge/';
+    const DESCRIPTION = 'Convert any site to RSS feed using SEO Sitemap and CSS selectors (Advanced Users)';
+    const PARAMETERS = [
+        [
+            'home_page' => [
+                'name' => 'Site URL: Home page with latest articles',
+                'title' => <<<EOT
+                    The bridge will analyze the site like a search engine does.
+                    The URL specified here determines the feed title and URL.
+                    EOT,
+                'exampleValue' => 'https://example.com/blog/',
+                'required' => true
+            ],
+            'url_pattern' => [
+                'name' => 'Pattern for site URLs to take in feed',
+                'title' => 'Select items by applying a regular expression on their URL',
+                'exampleValue' => 'https://example.com/article/.*',
+                'required' => true
+            ],
+            'content_selector' => [
+                'name' => 'Selector for each article content',
+                'title' => <<<EOT
+                    This bridge works using CSS selectors, e.g. "div.article" will match <div class="article">.
+                    Everything inside that element becomes feed item content.
+                    EOT,
+                'exampleValue' => 'article.content',
+                'required' => true
+            ],
+            'content_cleanup' => [
+                'name' => '[Optional] Content cleanup: List of items to remove',
+                'title' => 'Selector for unnecessary elements to remove inside article contents.',
+                'exampleValue' => 'div.ads, div.comments',
+            ],
+            'title_cleanup' => [
+                'name' => '[Optional] Text to remove from article title',
+                'title' => 'Specify here some text from page title that need to be removed, e.g. " | BlogName".',
+                'exampleValue' => ' | BlogName',
+            ],
+            'site_map' => [
+                'name' => '[Optional] sitemap.xml URL',
+                'title' => <<<EOT
+                    By default, the bridge will analyze robots.txt to find out URL for sitemap.xml.
+                    Alternatively, you can specify here the direct URL for sitemap XML.
+                    The sitemap.xml file must have <loc> and <lastmod> fields for the bridge to work:
+                    Eg. <url><loc>https://article/url</loc><lastmod>2000-12-31T23:59Z</lastmod></url>
+                    <loc> is feed item URL, <lastmod> for selecting the most recent entries.
+                    EOT,
+                'exampleValue' => 'https://example.com/sitemap.xml',
+            ],
+            'limit' => self::LIMIT
+        ]
+    ];
+
+    public function collectData()
+    {
+        $url = $this->getInput('home_page');
+        $url_pattern = $this->getInput('url_pattern');
+        $content_selector = $this->getInput('content_selector');
+        $content_cleanup = $this->getInput('content_cleanup');
+        $title_cleanup = $this->getInput('title_cleanup');
+        $site_map = $this->getInput('site_map');
+        $limit = $this->getInput('limit');
+
+        $this->feedName = $this->getPageTitle($url, $title_cleanup);
+        $sitemap_url = empty($site_map) ? $url : $site_map;
+        $sitemap_xml = $this->getSitemapXml($sitemap_url, !empty($site_map));
+        $links = $this->sitemapXmlToList($sitemap_xml, $url_pattern, empty($limit) ? 10 : $limit);
+
+        if (empty($links) && empty(sitemapXmlToList($sitemap_xml))) {
+            returnClientError('Could not retrieve URLs with Timestamps from Sitemap: ' . $sitemap_url);
+        }
+
+        foreach ($links as $link) {
+            $this->items[] = $this->expandEntryWithSelector($link, $content_selector, $content_cleanup, $title_cleanup);
+        }
+    }
+
+    /**
+     * Retrieve site map from specified URL
+     * @param string $url URL pointing to any page of the site, e.g. "https://example.com/blog" OR directly to the site map e.g. "https://example.com/sitemap.xml"
+     * @param string $is_site_map TRUE if the specified URL points directly to the sitemap XML
+     * @return object Sitemap DOM (from parsed XML)
+     */
+    protected function getSitemapXml(&$url, $is_site_map = false)
+    {
+        if (!$is_site_map) {
+            $robots_txt = getSimpleHTMLDOM(urljoin($url, '/robots.txt'))->outertext;
+            preg_match('/Sitemap: ([^ ]+)/', $robots_txt, $matches);
+            if (empty($matches)) {
+                returnClientError('Failed to determine Sitemap from robots.txt. Try setting it manually.');
+            }
+            $url = $matches[1];
+        }
+        return getSimpleHTMLDOM($url);
+    }
+
+    /**
+     * Retrieve N most recent URLs from Site Map
+     * @param object $sitemap Site map XML DOM
+     * @param string $url_pattern Optional pattern to look for in URLs
+     * @param int $limit Optional maximum amount of URLs to return
+     * @param bool $keep_date TRUE to keep dates (url => date array instead of url array)
+     * @return array Array of URLs
+     */
+    protected function sitemapXmlToList($sitemap, $url_pattern = '', $limit = 0, $keep_date = false)
+    {
+        $links = [];
+
+        foreach ($sitemap->find('sitemap') as $nested_sitemap) {
+            $url = $nested_sitemap->find('loc');
+            if (!empty($url)) {
+                $url = $url[0]->plaintext;
+                if (str_ends_with(strtolower($url), '.xml')) {
+                    $nested_sitemap_xml = $this->getSitemapXml($url, true);
+                    $nested_sitemap_links = $this->sitemapXmlToList($nested_sitemap_xml, $url_pattern, null, true);
+                    $links = array_merge($links, $nested_sitemap_links);
+                }
+            }
+        }
+
+        if (!empty($url_pattern)) {
+            $url_pattern = str_replace('/', '\/', $url_pattern);
+        }
+
+        foreach ($sitemap->find('url') as $item) {
+            $url = $item->find('loc');
+            $lastmod = $item->find('lastmod');
+            if (!empty($url) && !empty($lastmod)) {
+                $url = $url[0]->plaintext;
+                $lastmod = $lastmod[0]->plaintext;
+                $timestamp = strtotime($lastmod);
+                if (empty($url_pattern) || preg_match('/' . $url_pattern . '/', $url) === 1) {
+                    $links[$url] = $timestamp;
+                }
+            }
+        }
+
+        arsort($links);
+
+        if ($limit > 0 && count($links) > $limit) {
+            $links = array_slice($links, 0, $limit);
+        }
+
+        return $keep_date ? $links : array_keys($links);
+    }
+}

From f3896ed543c5e026ee114fa37e243a01c71322a7 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Wed, 9 Aug 2023 17:35:35 +0200
Subject: [PATCH 061/716] [ImgsedBridge] Add detectParameters feature to the
 bridge (#3604)

The bridge can detect the most common profile variation URL of
instagram.com or imgsed.com websites to extract the username.
---
 bridges/ImgsedBridge.php | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/bridges/ImgsedBridge.php b/bridges/ImgsedBridge.php
index 1555c578..5fe3eee8 100644
--- a/bridges/ImgsedBridge.php
+++ b/bridges/ImgsedBridge.php
@@ -256,4 +256,30 @@ HTML,
         }
         return parent::getName();
     }
+
+    public function detectParameters($url)
+    {
+        $params = [
+            'post' => 'on',
+            'story' => 'on',
+            'tagged' => 'on'
+        ];
+        $regex = '/^http(s|):\/\/((www\.|)(instagram.com)\/([a-zA-Z0-9_\.]{1,30})\/(reels\/|tagged\/|)
+|(www\.|)(imgsed.com)\/(stories\/|tagged\/|)([a-zA-Z0-9_\.]{1,30})\/)/';
+        if (preg_match($regex, $url, $matches) > 0) {
+            // Extract detected domain using the regex
+            $domain = $matches[8] ?? $matches[4];
+            if ($domain == 'imgsed.com') {
+                $params['u'] = $matches[10];
+                return $params;
+            } else if ($domain == 'instagram.com') {
+                $params['u'] = $matches[5];
+                return $params;
+            } else {
+                return null;
+            }
+        } else {
+            return null;
+        }
+    }
 }

From 1fcf67f14a8f738f22395d453cb39aeed573af78 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Wed, 9 Aug 2023 17:36:02 +0200
Subject: [PATCH 062/716] [PepperBridgeAbstract] Fix deal origin (#3605)

Origin display has chenged : this commit follow the websites changes.

Fixes #3521
---
 bridges/PepperBridgeAbstract.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index 85178e54..c152d249 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -393,10 +393,10 @@ HEREDOC;
      */
     private function getSource($deal)
     {
-        if ($deal->find('a[class*=text--color-greyShade]', 0) != null) {
-            return '<div>' . $this->i8n('origin') . ' : '
-                . $deal->find('a[class*=text--color-greyShade]', 0)->outertext
-                . '</div>';
+        if (($origin = $deal->find('button[class*=text--color-greyShade]', 0)) != null) {
+            $path = str_replace(' ', '/', trim(Json::decode($origin->{'data-cloak-link'})['path']));
+            $text = $origin->find('span[class*=cept-merchant-name]', 0);
+            return '<div>' . $this->i8n('origin') . ' : <a href="' . static::URI . $path . '">' . $text . '</a></div>';
         } else {
             return '';
         }

From 6cc4cf24dc2a52084b71d22a2759f28fe6d11ebc Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Wed, 9 Aug 2023 20:10:15 +0200
Subject: [PATCH 063/716] [FuturaSciences] Fix content extraction (#3487,
 #3488) (#3606)

---
 bridges/FuturaSciencesBridge.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/FuturaSciencesBridge.php b/bridges/FuturaSciencesBridge.php
index 0aa394fa..3fb8aafa 100644
--- a/bridges/FuturaSciencesBridge.php
+++ b/bridges/FuturaSciencesBridge.php
@@ -90,7 +90,7 @@ class FuturaSciencesBridge extends FeedExpander
         $item = parent::parseItem($newsItem);
         $item['uri'] = str_replace('#xtor%3DRSS-8', '', $item['uri']);
         $article = getSimpleHTMLDOMCached($item['uri']);
-        //$item['content'] = $this->extractArticleContent($article);
+        $item['content'] = $this->extractArticleContent($article);
         $author = $this->extractAuthor($article);
         if (!empty($author)) {
             $item['author'] = $author;
@@ -100,7 +100,7 @@ class FuturaSciencesBridge extends FeedExpander
 
     private function extractArticleContent($article)
     {
-        $contents = $article->find('section.article-text', 1);
+        $contents = $article->find('div.article-text', 0);
 
         foreach ($contents->find('img') as $img) {
             if (!empty($img->getAttribute('data-src'))) {

From 52d3cce59dae1b5b8adb5497450e396473ebf6b2 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Wed, 9 Aug 2023 22:40:24 +0200
Subject: [PATCH 064/716] bridges: add context to detectParameters (#3607)

* bridges: add context to detectParameters

Some bridges did not return the context parameter but they used it in
the parameters

* bridges: add context to detectParameters

Fix test for InstagramBridge
---
 bridges/BadDragonBridge.php       |   2 +
 bridges/BandcampBridge.php        |   3 +
 bridges/FacebookBridge.php        |   3 +
 bridges/FreeTelechargerBridge.php | 151 +++++++++++++++---------------
 bridges/FunkBridge.php            |   1 +
 bridges/FurAffinityBridge.php     |   4 +
 bridges/GithubIssueBridge.php     |   4 +
 bridges/ImgsedBridge.php          |   1 +
 bridges/InstagramBridge.php       |   7 +-
 bridges/RedditBridge.php          |   2 +
 bridges/SkimfeedBridge.php        |   3 +-
 bridges/TrelloBridge.php          |  10 +-
 bridges/TwitterBridge.php         |   4 +
 13 files changed, 115 insertions(+), 80 deletions(-)

diff --git a/bridges/BadDragonBridge.php b/bridges/BadDragonBridge.php
index 2260bbd6..d38e3408 100644
--- a/bridges/BadDragonBridge.php
+++ b/bridges/BadDragonBridge.php
@@ -138,6 +138,7 @@ class BadDragonBridge extends BridgeAbstract
         // Sale
         $regex = '/^(https?:\/\/)?bad-dragon\.com\/sales/';
         if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = 'Sales';
             return $params;
         }
 
@@ -192,6 +193,7 @@ class BadDragonBridge extends BridgeAbstract
             isset($urlParams['noAccessories'])
                 && $urlParams['noAccessories'] === '1'
                 && $params['noAccessories'] = 'on';
+            $params['context'] = 'Clearance';
 
             return $params;
         }
diff --git a/bridges/BandcampBridge.php b/bridges/BandcampBridge.php
index c041b2b3..a9bd2ea1 100644
--- a/bridges/BandcampBridge.php
+++ b/bridges/BandcampBridge.php
@@ -397,6 +397,7 @@ class BandcampBridge extends BridgeAbstract
         // By tag
         $regex = '/^(https?:\/\/)?bandcamp\.com\/tag\/([^\/.&?\n]+)/';
         if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = 'By tag';
             $params['tag'] = urldecode($matches[2]);
             return $params;
         }
@@ -404,6 +405,7 @@ class BandcampBridge extends BridgeAbstract
         // By band
         $regex = '/^(https?:\/\/)?([^\/.&?\n]+?)\.bandcamp\.com/';
         if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = 'By band';
             $params['band'] = urldecode($matches[2]);
             return $params;
         }
@@ -411,6 +413,7 @@ class BandcampBridge extends BridgeAbstract
         // By album
         $regex = '/^(https?:\/\/)?([^\/.&?\n]+?)\.bandcamp\.com\/album\/([^\/.&?\n]+)/';
         if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = 'By album';
             $params['band'] = urldecode($matches[2]);
             $params['album'] = urldecode($matches[3]);
             return $params;
diff --git a/bridges/FacebookBridge.php b/bridges/FacebookBridge.php
index 9ccf6dcd..3e693a38 100644
--- a/bridges/FacebookBridge.php
+++ b/bridges/FacebookBridge.php
@@ -88,6 +88,7 @@ class FacebookBridge extends BridgeAbstract
         // By profile
         $regex = '/^(https?:\/\/)?(www\.)?facebook\.com\/profile\.php\?id\=([^\/?&\n]+)?(.*)/';
         if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = 'User';
             $params['u'] = urldecode($matches[3]);
             return $params;
         }
@@ -95,6 +96,7 @@ class FacebookBridge extends BridgeAbstract
         // By group
         $regex = '/^(https?:\/\/)?(www\.)?facebook\.com\/groups\/([^\/?\n]+)?(.*)/';
         if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = 'Group';
             $params['g'] = urldecode($matches[3]);
             return $params;
         }
@@ -103,6 +105,7 @@ class FacebookBridge extends BridgeAbstract
         $regex = '/^(https?:\/\/)?(www\.)?facebook\.com\/([^\/?\n]+)/';
 
         if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = '';
             $params['u'] = urldecode($matches[3]);
             return $params;
         }
diff --git a/bridges/FreeTelechargerBridge.php b/bridges/FreeTelechargerBridge.php
index b94ff835..8362b4ff 100644
--- a/bridges/FreeTelechargerBridge.php
+++ b/bridges/FreeTelechargerBridge.php
@@ -2,89 +2,90 @@
 
 class FreeTelechargerBridge extends BridgeAbstract
 {
-        const NAME = 'Free-Telecharger';
-        const URI = 'https://www.free-telecharger.live/';
-        const DESCRIPTION = 'Suivi de série sur Free-Telecharger';
-        const MAINTAINER  = 'sysadminstory';
-        const PARAMETERS = [
-                'Suivi de publication de série' => [
-                        'url' => [
-                                'name' => 'URL de la série',
-                                'type' => 'text',
-                                'required' => true,
-                                'title' => 'URL d\'une série sans le https://www.free-telecharger.live/',
-                                'pattern' => 'series.*\.html',
-                                'exampleValue' => 'series-vf-hd/145458-the-last-of-us-saison-1-web-dl-720p.html'
-                        ],
-                ]
-        ];
-        const CACHE_TIMEOUT = 3600;
-        public function collectData()
-        {
-                $html = getSimpleHTMLDOM(self::URI . $this->getInput('url'));
+    const NAME = 'Free-Telecharger';
+    const URI = 'https://www.free-telecharger.live/';
+    const DESCRIPTION = 'Suivi de série sur Free-Telecharger';
+    const MAINTAINER  = 'sysadminstory';
+    const PARAMETERS = [
+            'Suivi de publication de série' => [
+                    'url' => [
+                            'name' => 'URL de la série',
+                            'type' => 'text',
+                            'required' => true,
+                            'title' => 'URL d\'une série sans le https://www.free-telecharger.live/',
+                            'pattern' => 'series.*\.html',
+                            'exampleValue' => 'series-vf-hd/145458-the-last-of-us-saison-1-web-dl-720p.html'
+                    ],
+            ]
+    ];
+    const CACHE_TIMEOUT = 3600;
+    public function collectData()
+    {
+            $html = getSimpleHTMLDOM(self::URI . $this->getInput('url'));
 
-                // Find all block content of the page
-                $blocks = $html->find('div[class=block1]');
+            // Find all block content of the page
+            $blocks = $html->find('div[class=block1]');
 
-                // Global Infos block
-                $infosBlock = $blocks[0];
-                // Links block
-                $linksBlock = $blocks[2];
+            // Global Infos block
+            $infosBlock = $blocks[0];
+            // Links block
+            $linksBlock = $blocks[2];
 
-                // Extract Global Show infos
-                $this->showTitle = trim($infosBlock->find('div[class=titre1]', 0)->find('font', 0)->plaintext);
-                $this->showTechDetails = trim($infosBlock->find('div[align=center]', 0)->find('b', 0)->plaintext);
+            // Extract Global Show infos
+            $this->showTitle = trim($infosBlock->find('div[class=titre1]', 0)->find('font', 0)->plaintext);
+            $this->showTechDetails = trim($infosBlock->find('div[align=center]', 0)->find('b', 0)->plaintext);
 
 
 
-                // Get Episodes names and links
-                $episodes = $linksBlock->find('div[id=link]', 0)->find('font[color=#ff6600]');
-                $links = $linksBlock->find('div[id=link]', 0)->find('a');
+            // Get Episodes names and links
+            $episodes = $linksBlock->find('div[id=link]', 0)->find('font[color=#ff6600]');
+            $links = $linksBlock->find('div[id=link]', 0)->find('a');
 
-            foreach ($episodes as $index => $episode) {
-                        $item = []; // Create an empty item
-                        $item['title'] = $this->showTitle . ' ' . $this->showTechDetails . '  - ' . ltrim(trim($episode->plaintext), '-');
-                        $item['uri'] = $links[$index]->href;
-                        $item['content'] = '<a href="' . $item['uri'] . '">' . $item['title'] . '</a>';
-                        $item['uid'] = hash('md5', $item['uri']);
+        foreach ($episodes as $index => $episode) {
+                    $item = []; // Create an empty item
+                    $item['title'] = $this->showTitle . ' ' . $this->showTechDetails . '  - ' . ltrim(trim($episode->plaintext), '-');
+                    $item['uri'] = $links[$index]->href;
+                    $item['content'] = '<a href="' . $item['uri'] . '">' . $item['title'] . '</a>';
+                    $item['uid'] = hash('md5', $item['uri']);
 
-                        $this->items[] = $item; // Add this item to the list
-            }
+                    $this->items[] = $item; // Add this item to the list
+        }
+    }
+
+    public function getName()
+    {
+        switch ($this->queriedContext) {
+            case 'Suivi de publication de série':
+                return $this->showTitle . ' ' . $this->showTechDetails . ' - ' . self::NAME;
+            break;
+            default:
+                return self::NAME;
+        }
+    }
+
+    public function getURI()
+    {
+        switch ($this->queriedContext) {
+            case 'Suivi de publication de série':
+                return self::URI . $this->getInput('url');
+            break;
+            default:
+                return self::URI;
+        }
+    }
+
+    public function detectParameters($url)
+    {
+        // Example: https://www.free-telecharger.live/series-vf-hd/145458-the-last-of-us-saison-1-web-dl-720p.html
+
+        $params = [];
+        $regex = '/^https:\/\/www.*\.free-telecharger\.live\/(series.*\.html)/';
+        if (preg_match($regex, $url, $matches) > 0) {
+                $params['context'] = 'Suivi de publication de série';
+                $params['url'] = urldecode($matches[1]);
+                return $params;
         }
 
-        public function getName()
-        {
-            switch ($this->queriedContext) {
-                case 'Suivi de publication de série':
-                    return $this->showTitle . ' ' . $this->showTechDetails . ' - ' . self::NAME;
-                break;
-                default:
-                    return self::NAME;
-            }
-        }
-
-        public function getURI()
-        {
-            switch ($this->queriedContext) {
-                case 'Suivi de publication de série':
-                    return self::URI . $this->getInput('url');
-                break;
-                default:
-                    return self::URI;
-            }
-        }
-
-        public function detectParameters($url)
-        {
-                // Example: https://www.free-telecharger.live/series-vf-hd/145458-the-last-of-us-saison-1-web-dl-720p.html
-
-                $params = [];
-                $regex = '/^https:\/\/www.*\.free-telecharger\.live\/(series.*\.html)/';
-            if (preg_match($regex, $url, $matches) > 0) {
-                        $params['url'] = urldecode($matches[1]);
-                        return $params;
-            }
-
-                return null;
-        }
+        return null;
+    }
 }
diff --git a/bridges/FunkBridge.php b/bridges/FunkBridge.php
index 69be4928..df499035 100644
--- a/bridges/FunkBridge.php
+++ b/bridges/FunkBridge.php
@@ -64,6 +64,7 @@ class FunkBridge extends BridgeAbstract
         $regex = '/^https?:\/\/(?:www\.)?funk\.net\/channel\/([^\/]+).*$/';
         if (preg_match($regex, $url, $urlMatches) > 0) {
             return [
+                'context' => 'Channel',
                 'channel' => $urlMatches[1]
             ];
         } else {
diff --git a/bridges/FurAffinityBridge.php b/bridges/FurAffinityBridge.php
index c548ff65..6c2d7b52 100644
--- a/bridges/FurAffinityBridge.php
+++ b/bridges/FurAffinityBridge.php
@@ -603,6 +603,7 @@ class FurAffinityBridge extends BridgeAbstract
         // Single journal
         $regex = '/^(https?:\/\/)?(www\.)?furaffinity.net\/journal\/(\d+)/';
         if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = 'Single Journal';
             $params['journal-id'] = urldecode($matches[3]);
             return $params;
         }
@@ -610,6 +611,7 @@ class FurAffinityBridge extends BridgeAbstract
         // Journals
         $regex = '/^(https?:\/\/)?(www\.)?furaffinity.net\/journals\/([^\/&?\n]+)/';
         if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = 'Journals';
             $params['username-journals'] = urldecode($matches[3]);
             return $params;
         }
@@ -617,6 +619,7 @@ class FurAffinityBridge extends BridgeAbstract
         // Gallery folder
         $regex = '/^(https?:\/\/)?(www\.)?furaffinity.net\/gallery\/([^\/&?\n]+)\/folder\/(\d+)/';
         if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = 'Gallery Folder';
             $params['username-folder'] = urldecode($matches[3]);
             $params['folder-id'] = urldecode($matches[4]);
             $params['full'] = 'on';
@@ -626,6 +629,7 @@ class FurAffinityBridge extends BridgeAbstract
         // Gallery (must be after gallery folder)
         $regex = '/^(https?:\/\/)?(www\.)?furaffinity.net\/(gallery|scraps|favorites)\/([^\/&?\n]+)/';
         if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = 'Gallery';
             $params['username-' . $matches[3]] = urldecode($matches[4]);
             $params['full'] = 'on';
             return $params;
diff --git a/bridges/GithubIssueBridge.php b/bridges/GithubIssueBridge.php
index e4e995e3..7f56abbd 100644
--- a/bridges/GithubIssueBridge.php
+++ b/bridges/GithubIssueBridge.php
@@ -277,6 +277,7 @@ class GithubIssueBridge extends BridgeAbstract
             case 2: // Project issues
                 [$user, $project] = $path_segments;
                 $show_comments = 'off';
+                $context = 'Project Issues';
                 break;
             case 3: // Project issues with issue comments
                 if ($path_segments[2] !== static::URL_PATH) {
@@ -284,15 +285,18 @@ class GithubIssueBridge extends BridgeAbstract
                 }
                 [$user, $project] = $path_segments;
                 $show_comments = 'on';
+                $context = 'Project Issues';
                 break;
             case 4: // Issue comments
                 [$user, $project, /* issues */, $issue] = $path_segments;
+                $context = 'Issue comments';
                 break;
             default:
                 return null;
         }
 
         return [
+            'context' => $context,
             'u' => $user,
             'p' => $project,
             'c' => $show_comments ?? null,
diff --git a/bridges/ImgsedBridge.php b/bridges/ImgsedBridge.php
index 5fe3eee8..cf17acb4 100644
--- a/bridges/ImgsedBridge.php
+++ b/bridges/ImgsedBridge.php
@@ -267,6 +267,7 @@ HTML,
         $regex = '/^http(s|):\/\/((www\.|)(instagram.com)\/([a-zA-Z0-9_\.]{1,30})\/(reels\/|tagged\/|)
 |(www\.|)(imgsed.com)\/(stories\/|tagged\/|)([a-zA-Z0-9_\.]{1,30})\/)/';
         if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = 'Username';
             // Extract detected domain using the regex
             $domain = $matches[8] ?? $matches[4];
             if ($domain == 'imgsed.com') {
diff --git a/bridges/InstagramBridge.php b/bridges/InstagramBridge.php
index 71431906..0f644c4a 100644
--- a/bridges/InstagramBridge.php
+++ b/bridges/InstagramBridge.php
@@ -63,9 +63,9 @@ class InstagramBridge extends BridgeAbstract
     ];
 
     const TEST_DETECT_PARAMETERS = [
-        'https://www.instagram.com/metaverse' => ['u' => 'metaverse'],
-        'https://instagram.com/metaverse' => ['u' => 'metaverse'],
-        'http://www.instagram.com/metaverse' => ['u' => 'metaverse'],
+        'https://www.instagram.com/metaverse' => ['context' => 'Username', 'u' => 'metaverse'],
+        'https://instagram.com/metaverse' => ['context' => 'Username', 'u' => 'metaverse'],
+        'http://www.instagram.com/metaverse' => ['context' => 'Username', 'u' => 'metaverse'],
     ];
 
     const USER_QUERY_HASH = '58b6785bea111c67129decbe6a448951';
@@ -323,6 +323,7 @@ class InstagramBridge extends BridgeAbstract
         $regex = '/^(https?:\/\/)?(www\.)?instagram\.com\/([^\/?\n]+)/';
 
         if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = 'Username';
             $params['u'] = urldecode($matches[3]);
             return $params;
         }
diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index 86d7884b..bd60243f 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -301,10 +301,12 @@ class RedditBridge extends BridgeAbstract
 
         if ($path[1] == 'r') {
             return [
+                'context' => 'single',
                 'r' => $path[2]
             ];
         } elseif ($path[1] == 'user') {
             return [
+                'context' => 'user',
                 'u' => $path[2]
             ];
         } else {
diff --git a/bridges/SkimfeedBridge.php b/bridges/SkimfeedBridge.php
index 19d4c823..a224cdf4 100644
--- a/bridges/SkimfeedBridge.php
+++ b/bridges/SkimfeedBridge.php
@@ -455,11 +455,12 @@ class SkimfeedBridge extends BridgeAbstract
             return null;
         }
 
-        foreach (self::PARAMETERS as $channels) {
+        foreach (self::PARAMETERS as $context => $channels) {
             foreach ($channels as $box_name => $box) {
                 foreach ($box['values'] as $name => $channel_url) {
                     if (static::URI . $channel_url === $url) {
                         return [
+                            'context' => $context,
                             $box_name => $name,
                         ];
                     }
diff --git a/bridges/TrelloBridge.php b/bridges/TrelloBridge.php
index ea7eb71b..a1b5cfb8 100644
--- a/bridges/TrelloBridge.php
+++ b/bridges/TrelloBridge.php
@@ -670,7 +670,15 @@ class TrelloBridge extends BridgeAbstract
     {
         $regex = '/^(https?:\/\/)?trello\.com\/([bc])\/([^\/?\n]+)/';
         if (preg_match($regex, $url, $matches) > 0) {
-            return [$matches[2] => $matches[3]];
+            if ($matches[2] == 'b') {
+                $context = 'Board';
+            } else if ($matches[2] == 'c') {
+                $context = 'Card';
+            }
+            return [
+                'context' => $context,
+                $matches[2] => $matches[3]
+            ];
         } else {
             return null;
         }
diff --git a/bridges/TwitterBridge.php b/bridges/TwitterBridge.php
index 1ba00c66..1f115be8 100644
--- a/bridges/TwitterBridge.php
+++ b/bridges/TwitterBridge.php
@@ -133,6 +133,7 @@ EOD
         // By keyword or hashtag (search)
         $regex = '/^(https?:\/\/)?(www\.)?twitter\.com\/search.*(\?|&)q=([^\/&?\n]+)/';
         if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = 'By keyword or hashtag';
             $params['q'] = urldecode($matches[4]);
             return $params;
         }
@@ -140,6 +141,7 @@ EOD
         // By hashtag
         $regex = '/^(https?:\/\/)?(www\.)?twitter\.com\/hashtag\/([^\/?\n]+)/';
         if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = 'By keyword or hashtag';
             $params['q'] = urldecode($matches[3]);
             return $params;
         }
@@ -147,6 +149,7 @@ EOD
         // By list
         $regex = '/^(https?:\/\/)?(www\.)?twitter\.com\/([^\/?\n]+)\/lists\/([^\/?\n]+)/';
         if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = 'By list';
             $params['user'] = urldecode($matches[3]);
             $params['list'] = urldecode($matches[4]);
             return $params;
@@ -155,6 +158,7 @@ EOD
         // By username
         $regex = '/^(https?:\/\/)?(www\.)?twitter\.com\/([^\/?\n]+)/';
         if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = 'By username';
             $params['u'] = urldecode($matches[3]);
             return $params;
         }

From 11ea6aedfd06e1da1294883d382c063951ae3c2e Mon Sep 17 00:00:00 2001
From: Christian Schabesberger <chris.schabesberger@mailbox.org>
Date: Thu, 10 Aug 2023 23:59:37 +0200
Subject: [PATCH 065/716] hide dpa articles in Nordbayern News (#3608)

---
 bridges/NordbayernBridge.php | 42 ++++++++++++++++++++++++++----------
 1 file changed, 31 insertions(+), 11 deletions(-)

diff --git a/bridges/NordbayernBridge.php b/bridges/NordbayernBridge.php
index b409e1e0..aa32f4ba 100644
--- a/bridges/NordbayernBridge.php
+++ b/bridges/NordbayernBridge.php
@@ -44,6 +44,12 @@ class NordbayernBridge extends BridgeAbstract
             'type' => 'checkbox',
             'exampleValue' => 'unchecked',
             'title' => 'Hide all paywall articles on NN'
+        ],
+        'hideDPA' => [
+        'name' => 'Hide dpa articles',
+        'type' => 'checkbox',
+        'exampleValue' => 'unchecked',
+        'title' => 'Hide external articles from dpa'
         ]
     ]];
 
@@ -103,7 +109,7 @@ class NordbayernBridge extends BridgeAbstract
         return $teaser;
     }
 
-    private function handleArticle($link)
+    private function getArticle($link)
     {
         $item = [];
         $article = getSimpleHTMLDOM($link);
@@ -142,15 +148,9 @@ class NordbayernBridge extends BridgeAbstract
             $item['content'] .= self::getUseFullContent($content);
         }
 
-        // exclude police reports if desired
-        if (
-            $this->getInput('policeReports') ||
-            !str_contains($item['content'], 'Hier geht es zu allen aktuellen Polizeimeldungen.')
-        ) {
-            $this->items[] = $item;
-        }
 
         $article->clear();
+        return $item;
     }
 
     private function handleNewsblock($listSite)
@@ -161,11 +161,31 @@ class NordbayernBridge extends BridgeAbstract
             $url = urljoin(self::URI, $url);
             // exclude nn+ articles if desired
             if (
-                !$this->getInput('hideNNPlus') ||
-                !str_contains($url, 'www.nn.de')
+                $this->getInput('hideNNPlus') &&
+                str_contains($url, 'www.nn.de')
             ) {
-                self::handleArticle($url);
+                continue;
             }
+
+            $item = self::getArticle($url);
+
+            // exclude police reports if desired
+            if (
+                !$this->getInput('policeReports') &&
+                str_contains($item['content'], 'Hier geht es zu allen aktuellen Polizeimeldungen.')
+            ) {
+                continue;
+            }
+
+            // exclude dpa articles
+            if (
+                $this->getInput('hideDPA') &&
+                str_contains($item['author'], 'dpa')
+            ) {
+                continue;
+            }
+
+            $this->items[] = $item;
         }
     }
 

From d55994643d5a5495d185bfef43ff52a59aea9a03 Mon Sep 17 00:00:00 2001
From: George Sokianos <walkero@gmail.com>
Date: Fri, 11 Aug 2023 15:16:53 +0100
Subject: [PATCH 066/716] bridges: Added Ko-Fi.com bridge (#3609)

* Added Ko-Fi.com bridge

* Changed the exampleValue based on KoFiBridge-pr-context1 artifacts

* Fixed "Undefined array key 0" error

* fixed PHPCS issues

---------

Co-authored-by: George Sokianos <George.Sokianos@hostelworld.com>
---
 bridges/KoFiBridge.php | 79 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 79 insertions(+)
 create mode 100644 bridges/KoFiBridge.php

diff --git a/bridges/KoFiBridge.php b/bridges/KoFiBridge.php
new file mode 100644
index 00000000..c1600590
--- /dev/null
+++ b/bridges/KoFiBridge.php
@@ -0,0 +1,79 @@
+<?php
+
+class KoFiBridge extends BridgeAbstract
+{
+    const MAINTAINER = 'walkero';
+    const NAME = 'Ko-Fi Bridge';
+    const URI = 'https://ko-fi.com';
+    const CACHE_TIMEOUT = 3600; // 1h
+    const DESCRIPTION = 'Returns the newest articles.';
+    const FEED_URI = 'https://ko-fi.com/Feed/PersonalFeed?pageIndex=0&pageId=';
+    const PARAMETERS = [[
+        'pageId' => [
+            'name' => 'Page ID',
+            'type' => 'text',
+            'required' => true,
+            'exampleValue' => 'walkero',
+        ]
+    ]];
+
+    public function collectData()
+    {
+        $limit = 0;
+        $html = getSimpleHTMLDOM(self::FEED_URI . $this->getPageId());
+        foreach ($html->find('div.feeditem-unit') as $element) {
+            if ($limit < 10) {
+                $titleWrapper = $element->find('div.content-link-text');
+                if (isset($titleWrapper[0])) {
+                    $item = [];
+                    $item['title'] = $element->find('div.content-link-text div')[0]->plaintext;
+                    // $item['timestamp'] = strtotime($element->find('div.feeditem-time', 0)->plaintext);
+                    $item['uri'] = self::URI . $element->find('div.fi-post-item-large a')[0]->href;
+                    if (isset($element->find('div.fi-post-item-large div.content-link-post img')[0])) {
+                        $item['enclosures'][] = $element->find('div.fi-post-item-large div.content-link-post img')[0]->src;
+                    }
+                    // $item['content'] = $element->find('div.content-link-text div#content-link', 0)->plaintext;
+
+                    $html = getSimpleHTMLDOM($item['uri']);
+                    $feedItemTime = $html->find('div.feeditem-time', 0);
+                    $feedItemTime->find('span', 0)->remove();
+                    $feedItemTime->find('div', 0)->remove();
+                    $item['timestamp'] = strtotime(trim($feedItemTime->plaintext));
+                    $item['content'] = $this->getFullContent($html);
+                    $html->clear();
+
+                    $this->items[] = $item;
+                    $limit++;
+                }
+            }
+        }
+        $html->clear();
+    }
+
+    private function getFullContent($html)
+    {
+        foreach ($html->find('script[type="text/javascript"]') as $script) {
+            if (!empty($script->innertext)) {
+                if (strpos($script->innertext, 'shadowDom.innerHTML += \'') !== false) {
+                    preg_match_all('/d\N+/i', $script->innertext, $aMatches);
+                    foreach ($aMatches[0] as $match) {
+                        if (strpos($match, 'article-body') !== false) {
+                            break;
+                        }
+                    }
+                    $fullPostHtml = str_get_html(mb_substr($match, 21, -3));
+                    // Get the first paragraph
+                    return mb_substr($fullPostHtml->innertext, 0, mb_strpos($fullPostHtml->innertext, '</p>') + 4);
+                }
+            }
+        }
+    }
+
+    private function getPageId()
+    {
+        $html = getSimpleHTMLDOM(self::URI . '/' . $this->getInput('pageId'));
+        $reportUrl = $html->find('div.modal-dialog div.mb a.btn')[1]->href;
+        $html->clear();
+        return substr($reportUrl, strpos($reportUrl, '=') + 1);
+    }
+}

From ce72503df607cf7aa7d53bd10f38da97eb9bf17b Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 11 Aug 2023 19:02:38 +0200
Subject: [PATCH 067/716] fix(codeberg): change dom selectors for timestamp and
 content, fix #3610 (#3611)

---
 bridges/CodebergBridge.php | 20 +++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/bridges/CodebergBridge.php b/bridges/CodebergBridge.php
index df8ef647..83775885 100644
--- a/bridges/CodebergBridge.php
+++ b/bridges/CodebergBridge.php
@@ -209,7 +209,12 @@ class CodebergBridge extends BridgeAbstract
 
             $item['title'] = $li->find('a.title', 0)->plaintext . ' (' . $number . ')';
             $item['uri'] = $li->find('a.title', 0)->href;
-            $item['timestamp'] = $li->find('span.time-since', 0)->title;
+
+            $time = $li->find('relative-time.time-since', 0);
+            if ($time) {
+                $item['timestamp'] = $time->datetime;
+            }
+
             $item['author'] = $li->find('div.desc', 0)->find('a', 1)->plaintext;
 
             // Fetch issue page
@@ -270,14 +275,23 @@ class CodebergBridge extends BridgeAbstract
 
             $item['title'] = $li->find('a.title', 0)->plaintext . ' (' . $number . ')';
             $item['uri'] = $li->find('a.title', 0)->href;
-            $item['timestamp'] = $li->find('span.time-since', 0)->title;
+
+            $time = $li->find('relative-time.time-since', 0);
+            if ($time) {
+                $item['timestamp'] = $time->datetime;
+            }
+
             $item['author'] = $li->find('div.desc', 0)->find('a', 1)->plaintext;
 
             // Fetch pull request page
             $pullRequestPage = getSimpleHTMLDOMCached($item['uri'], 3600);
             $pullRequestPage = defaultLinkTo($pullRequestPage, self::URI);
 
-            $item['content'] = $pullRequestPage->find('ui.timeline', 0)->find('div.render-content.markup', 0);
+            $var = $pullRequestPage->find('ui.timeline', 0);
+            if ($var) {
+                $var1 = $var->find('div.render-content.markup', 0);
+                $item['content'] = $var1;
+            }
 
             foreach ($li->find('a.ui.label') as $label) {
                 $item['categories'][] = $label->plaintext;

From 7a1180c80f790d0c9baf3512aa4da2593e621288 Mon Sep 17 00:00:00 2001
From: mruac <ant8672@gmail.com>
Date: Tue, 15 Aug 2023 23:32:58 +0930
Subject: [PATCH 068/716] bridges: added Itaku.ee Bridge (#3615)

* Fix php8.2 deprecated warning

Fix php8.2 warning: `Deprecated: Creation of dynamic property is deprecated`

* modified tag presentation

* renamed to fit naming convention

* undo commit

* applied phpcbf and phpunit
---
 bridges/ItakuBridge.php | 699 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 699 insertions(+)
 create mode 100644 bridges/ItakuBridge.php

diff --git a/bridges/ItakuBridge.php b/bridges/ItakuBridge.php
new file mode 100644
index 00000000..6b0ebcb2
--- /dev/null
+++ b/bridges/ItakuBridge.php
@@ -0,0 +1,699 @@
+<?php
+
+class ItakuBridge extends BridgeAbstract
+{
+    const NAME = 'Itaku.ee Bridge';
+    const URI = 'https://itaku.ee';
+    const CACHE_TIMEOUT = 900; // 15mn
+    const MAINTAINER = 'mruac';
+    const DESCRIPTION = 'Bridges for Itaku.ee';
+    const PARAMETERS = [
+        'Image Search' => [
+            'text' => [
+                'name' => 'Text to search',
+                'title' => 'Search includes title, description and tags.',
+                'type' => 'text',
+                'exampleValue' => 'Text (incl. tags)'
+            ],
+            'tags' => [
+                'name' => 'Tags to search',
+                'title' => 'Space seperated tags to include in search. Prepend with "-" to exclude, "~" for optional.',
+                'type' => 'text',
+                'exampleValue' => 'tag1 -tag2 ~tag3'
+            ],
+            'order' => [
+                'name' => 'Sort by',
+                'type' => 'list',
+                'values' => [
+                    'Trending' => '-hotness_score',
+                    'Newest' => '-date_added',
+                    'Oldest' => 'date_added',
+                    'Top' => '-num_likes',
+                    'Bottom' => 'num_likes'
+                ],
+                'defaultValue' => '-date_added'
+            ],
+            'range' => [
+                'name' => 'Date range',
+                'type' => 'list',
+                'values' => [
+                    'Today' => 'today',
+                    'Yesterday' => 'yesterday',
+                    'Past 3 days' => '3_days',
+                    'Past week' => 'week',
+                    'Past month' => '30_days',
+                    'Past year' => '365_days',
+                    'All time' => ''
+                ],
+                'defaultValue' => 'All time'
+            ],
+            'video_only' => [
+                'name' => 'Video only?',
+                'type' => 'checkbox'
+            ],
+            'rating_s' => [
+                'name' => 'Include SFW',
+                'type' => 'checkbox'
+            ],
+            'rating_q' => [
+                'name' => 'Include Questionable',
+                'type' => 'checkbox'
+            ],
+            'rating_e' => [
+                'name' => 'Include NSFW',
+                'type' => 'checkbox'
+            ]
+        ],
+        'Post Search' => [
+            'tags' => [
+                'name' => 'Tags to search',
+                'title' => 'Space seperated tags to include in search. Prepend with "-" to exclude, "~" for optional.',
+                'type' => 'text',
+                'exampleValue' => 'tag1 -tag2 ~tag3'
+            ],
+            'order' => [
+                'name' => 'Sort by',
+                'type' => 'list',
+                'values' => [
+                    'Trending' => '-hotness_score',
+                    'Newest' => '-date_added',
+                    'Oldest' => 'date_added',
+                    'Top' => '-num_likes',
+                    'Bottom' => 'num_likes'
+                ],
+                'defaultValue' => '-date_added'
+            ],
+            'range' => [
+                'name' => 'Date range',
+                'type' => 'list',
+                'values' => [
+                    'Today' => 'today',
+                    'Yesterday' => 'yesterday',
+                    'Past 3 days' => '3_days',
+                    'Past week' => 'week',
+                    'Past month' => '30_days',
+                    'Past year' => '365_days',
+                    'All time' => ''
+                ],
+                'defaultValue' => 'All time'
+            ],
+            'text_only' => [
+                'name' => 'Only include posts with text?',
+                'type' => 'checkbox'
+            ],
+            'rating_s' => [
+                'name' => 'Include SFW',
+                'type' => 'checkbox'
+            ],
+            'rating_q' => [
+                'name' => 'Include Questionable',
+                'type' => 'checkbox'
+            ],
+            'rating_e' => [
+                'name' => 'Include NSFW',
+                'type' => 'checkbox'
+            ]
+        ],
+        'User profile' => [
+            'user' => [
+                'name' => 'Username',
+                'type' => 'text',
+                'required' => true
+            ],
+            'user_id' => [
+                'name' => 'User ID',
+                'type' => 'number',
+                'title' => 'User ID, if known.'
+            ],
+            'reshares' => [
+                'name' => 'Include reshares',
+                'type' => 'checkbox'
+            ],
+            'rating_s' => [
+                'name' => 'Include SFW',
+                'type' => 'checkbox'
+            ],
+            'rating_q' => [
+                'name' => 'Include Questionable',
+                'type' => 'checkbox'
+            ],
+            'rating_e' => [
+                'name' => 'Include NSFW',
+                'type' => 'checkbox'
+            ]
+        ],
+        'Home feed' => [
+            'order' => [
+                'name' => 'Sort by',
+                'type' => 'list',
+                'values' => [
+                    'Trending' => '-hotness_score',
+                    'Newest' => '-date_added'
+                ],
+                'defaultValue' => '-date_added'
+            ],
+            'range' => [
+                'name' => 'Date range',
+                'type' => 'list',
+                'values' => [
+                    'Today' => 'today',
+                    'Yesterday' => 'yesterday',
+                    'Past 3 days' => '3_days',
+                    'Past week' => 'week',
+                    'Past month' => '30_days',
+                    'Past year' => '365_days',
+                    'All time' => ''
+                ],
+                'defaultValue' => 'All time'
+            ],
+            'reshares' => [
+                'name' => 'Include reshares',
+                'type' => 'checkbox'
+            ],
+            'rating_s' => [
+                'name' => 'Include SFW',
+                'type' => 'checkbox'
+            ],
+            'rating_q' => [
+                'name' => 'Include Questionable',
+                'type' => 'checkbox'
+            ],
+            'rating_e' => [
+                'name' => 'Include NSFW',
+                'type' => 'checkbox'
+            ]
+        ]
+    ];
+
+    public function collectData()
+    {
+        if ($this->queriedContext === 'Image Search') {
+            $opt = [
+                'text' => $this->getInput('text'),
+                'optional_tags' => [],
+                'negative_tags' => [],
+                'required_tags' => [],
+                'order' => $this->getInput('order'),
+                'range' => $this->getInput('range'),
+                'video_only' => $this->getInput('video_only'),
+                'rating_s' => $this->getInput('rating_s'),
+                'rating_q' => $this->getInput('rating_q'),
+                'rating_e' => $this->getInput('rating_e')
+            ];
+
+            $tag_arr = explode(' ', $this->getInput('tags'));
+            foreach ($tag_arr as $str) {
+                switch ($str[0]) {
+                    case '-':
+                        $opt['negative_tags'][] = substr($str, 1);
+                        break;
+
+                    case '~':
+                        $opt['optional_tags'][] = substr($str, 1);
+                        break;
+
+                    default:
+                        $opt['required_tags'][] = substr($str, 1);
+                        break;
+                }
+            }
+
+            $data = $this->getImagesSearch($opt);
+
+            foreach ($data['results'] as $record) {
+                $item = $this->getImage($record['id']);
+                $this->addItem($item);
+            }
+        }
+
+        if ($this->queriedContext === 'Post Search') {
+            $opt = [
+                'optional_tags' => [],
+                'negative_tags' => [],
+                'required_tags' => [],
+                'order' => $this->getInput('order'),
+                'range' => $this->getInput('range'),
+                'text_only' => $this->getInput('text_only'),
+                'rating_s' => $this->getInput('rating_s'),
+                'rating_q' => $this->getInput('rating_q'),
+                'rating_e' => $this->getInput('rating_e')
+            ];
+
+            $tag_arr = explode(' ', $this->getInput('tags'));
+            foreach ($tag_arr as $str) {
+                switch ($str[0]) {
+                    case '-':
+                        $opt['negative_tags'][] = substr($str, 1);
+                        break;
+
+                    case '~':
+                        $opt['optional_tags'][] = substr($str, 1);
+                        break;
+
+                    default:
+                        $opt['required_tags'][] = substr($str, 1);
+                        break;
+                }
+            }
+
+            $data = $this->getPostsSearch($opt);
+
+            foreach ($data['results'] as $record) {
+                $item = $this->getPost($record['id'], $record);
+                $this->addItem($item);
+            }
+        }
+
+        if (
+            $this->queriedContext === 'User profile'
+            || $this->queriedContext === 'Home feed'
+        ) {
+            $opt = [
+                'reshares' => $this->getInput('reshares'),
+                'rating_s' => $this->getInput('rating_s'),
+                'rating_q' => $this->getInput('rating_q'),
+                'rating_e' => $this->getInput('rating_e')
+            ];
+
+            if ($this->queriedContext === 'User profile') {
+                $opt['order'] = '-date_added';
+                $opt['range'] = '';
+                $user_id = $this->getInput('user_id') ?? $this->getOwnerID($this->getInput('user'));
+
+                $data = $this->getFeed(
+                    $opt,
+                    $user_id
+                );
+            }
+
+            if ($this->queriedContext === 'Home feed') {
+                $opt['order'] = $this->getInput('order');
+                $opt['range'] = $this->getInput('range');
+                $data = $this->getFeed($opt);
+            }
+
+            foreach ($data['results'] as $record) {
+                switch ($record['content_type']) {
+                    case 'reshare':
+                        //get type of reshare and its id
+                        $id = $record['content_object']['content_object']['id'];
+                        switch ($record['content_object']['content_type']) {
+                            case 'galleryimage':
+                                $item = $this->getImage($id);
+                                $item['title'] = "{$record['owner_username']} shared: {$item['title']}";
+                                break;
+
+                            case 'commission':
+                                $item = $this->getCommission($id, $record['content_object']['content_object']);
+                                $item['title'] = "{$record['owner_username']} shared: {$item['title']}";
+                                break;
+
+                            case 'post':
+                                $item = $this->getPost($id, $record['content_object']['content_object']);
+                                $item['title'] = "{$record['owner_username']} shared: {$item['title']}";
+                                break;
+                        };
+                        break;
+                    case 'galleryimage':
+                        $item = $this->getImage($record['content_object']['id']);
+                        break;
+
+                    case 'commission':
+                        $item = $this->getCommission($record['content_object']['id'], $record['content_object']);
+                        break;
+
+                    case 'post':
+                        $item = $this->getPost($record['content_object']['id'], $record['content_object']);
+                        break;
+                }
+
+                $this->addItem($item);
+            }
+        }
+    }
+
+    public function getName()
+    {
+        return self::NAME;
+    }
+
+    public function getURI()
+    {
+        return self::URI;
+    }
+
+    private function getImagesSearch(array $opt)
+    {
+        $url = self::URI . "/api/galleries/images/?by_following=false&date_range={$opt['range']}&ordering={$opt['order']}&is_video={$opt['video_only']}";
+        $url .= "&text={$opt['text']}&visibility=PUBLIC&visibility=PROFILE_ONLY&page=1&page_size=30&format=json";
+
+        if (sizeof($opt['optional_tags']) > 0) {
+            foreach ($opt['optional_tags'] as $tag) {
+                $url .= "&optional_tags=$tag";
+            }
+        }
+        if (sizeof($opt['negative_tags']) > 0) {
+            foreach ($opt['negative_tags'] as $tag) {
+                $url .= "&negative_tags=$tag";
+            }
+        }
+        if (sizeof($opt['required_tags']) > 0) {
+            foreach ($opt['required_tags'] as $tag) {
+                $url .= "&required_tags=$tag";
+            }
+        }
+        if ($opt['rating_s']) {
+            $url .= '&maturity_rating=SFW';
+        }
+        if ($opt['rating_q']) {
+            $url .= '&maturity_rating=Questionable';
+        }
+        if ($opt['rating_e']) {
+            $url .= '&maturity_rating=NSFW';
+        }
+
+        return $this->getData($url, false, true);
+    }
+
+
+    private function getPostsSearch(array $opt)
+    {
+        $url = self::URI . "/api/posts/?by_following=false&date_range={$opt['range']}&ordering={$opt['order']}";
+        $url .= '&visibility=PUBLIC&visibility=PROFILE_ONLY&page=1&page_size=30&format=json';
+
+        if (sizeof($opt['optional_tags']) > 0) {
+            foreach ($opt['optional_tags'] as $tag) {
+                $url .= "&optional_tags=$tag";
+            }
+        }
+        if (sizeof($opt['negative_tags']) > 0) {
+            foreach ($opt['negative_tags'] as $tag) {
+                $url .= "&negative_tags=$tag";
+            }
+        }
+        if (sizeof($opt['required_tags']) > 0) {
+            foreach ($opt['required_tags'] as $tag) {
+                $url .= "&required_tags=$tag";
+            }
+        }
+        if ($opt['rating_s']) {
+            $url .= '&maturity_rating=SFW';
+        }
+        if ($opt['rating_q']) {
+            $url .= '&maturity_rating=Questionable';
+        }
+        if ($opt['rating_e']) {
+            $url .= '&maturity_rating=NSFW';
+        }
+
+        return $this->getData($url, false, true);
+    }
+
+    private function getFeed(array $opt, $ownerID = null)
+    {
+        $url = self::URI . "/api/feed/?date_range={$opt['range']}&ordering={$opt['order']}&page=1&page_size=30&format=json";
+
+        if (is_null($ownerID)) {
+            $url .= '&visibility=PUBLIC&by_following=false';
+        } else {
+            $url .= "&owner={$ownerID}";
+        }
+
+        if (!$opt['reshares']) {
+            $url .= '&hide_reshares=true';
+        }
+        if ($opt['rating_s']) {
+            $url .= '&maturity_rating=SFW';
+        }
+        if ($opt['rating_q']) {
+            $url .= '&maturity_rating=Questionable';
+        }
+        if ($opt['rating_e']) {
+            $url .= '&maturity_rating=NSFW';
+        }
+
+        return $this->getData($url, false, true);
+    }
+
+    private function getOwnerID($username)
+    {
+        $url = self::URI . "/api/user_profiles/{$username}/?format=json";
+        $data = $this->getData($url, true, true)
+            or returnServerError("Could not load $url");
+
+        return $data['owner'];
+    }
+
+    private function getPost($id, array $metadata = null)
+    {
+        $uri = self::URI . '/posts/' . $id;
+        $url = self::URI . '/api/posts/' . $id . '/?format=json';
+        $data = $metadata ?? $this->getData($url, true, true)
+            or returnServerError("Could not load $url");
+
+        $content_str = nl2br($data['content']);
+        $content = "<p>{$content_str}</p><br/>"; //TODO: Add link and itaku user mention detection and convert into links.
+
+        if (array_key_exists('tags', $data) && sizeof($data['tags']) > 0) {
+            $tag_types = [
+                'ARTIST' => '',
+                'COPYRIGHT' => '',
+                'CHARACTER' => '',
+                'SPECIES' => '',
+                'GENERAL' => '',
+                'META' => ''
+            ];
+            foreach ($data['tags'] as $tag) {
+                $url = self::URI . '/tags/' . $tag['id'];
+                $str = "<a href=\"{$url}\">#{$tag['name']}</a> ";
+                $tag_types[$tag['tag_type']] .= $str;
+            }
+
+            foreach ($tag_types as $type => $str) {
+                if (strlen($str) > 0) {
+                    $content .= "🏷 <b>{$type}:</b> {$str}<br/>";
+                }
+            }
+        }
+
+        if (sizeof($data['folders']) > 0) {
+            $content .= '📁 In Folder(s): ';
+            foreach ($data['folders'] as $folder) {
+                $url = self::URI . '/profile/' . $data['owner_username'] . '/posts/' . $folder['id'];
+                $content .= "<a href=\"{$url}\">#{$folder['title']}</a> ";
+            }
+        }
+
+        $content .= '<hr/>';
+        if (sizeof($data['gallery_images']) > 0) {
+            foreach ($data['gallery_images'] as $media) {
+                $title = $media['title'];
+                $url = self::URI . '/images/' . $media['id'];
+                $src = $media['image_xl'];
+                $content .= '<p>';
+                $content .= "<a href=\"{$url}\"><b>{$title}</b></a><br/>";
+                if ($media['is_thumbnail_for_video']) {
+                    $url = self::URI . '/api/galleries/images/' . $media['id'] . '/?format=json';
+                    $media_data = $this->getData($url, true, true)
+                        or returnServerError("Could not load $url");
+                    $content .= "<video controls src=\"{$media_data['video']['video']}\" poster=\"{$media['image_xl']}\"/>";
+                } else {
+                    $content .= "<a href=\"{$url}\"><img src=\"{$src}\"></a>";
+                }
+                $content .= '</p><br/>';
+            }
+        }
+
+        return [
+            'uri' => $uri,
+            'title' => $data['title'],
+            'timestamp' => $data['date_added'],
+            'author' => $data['owner_username'],
+            'content' => $content,
+            'categories' => ['post'],
+            'uid' => $uri
+        ];
+    }
+
+    private function getCommission($id, array $metadata = null)
+    {
+        $url = self::URI . '/api/commissions/' . $id . '/?format=json';
+        $uri = self::URI . '/commissions/' . $id;
+        // Debug::log(var_dump($metadata));
+        $data = $metadata ?? $this->getData($url, true, true)
+            or returnServerError("Could not load $url");
+
+        $content_str = nl2br($data['description']);
+        $content = "<p>{$content_str}</p><br>"; //TODO: Add link and itaku user mention detection and convert into links.
+
+        if (array_key_exists('tags', $data) && sizeof($data['tags']) > 0) {
+            // $content .= "🏷 Tag(s): ";
+            $tag_types = [
+                'ARTIST' => '',
+                'COPYRIGHT' => '',
+                'CHARACTER' => '',
+                'SPECIES' => '',
+                'GENERAL' => '',
+                'META' => ''
+            ];
+            foreach ($data['tags'] as $tag) {
+                $url = self::URI . '/tags/' . $tag['id'];
+                $str = "<a href=\"{$url}\">#{$tag['name']}</a> ";
+                $tag_types[$tag['tag_type']] .= $str;
+            }
+
+            foreach ($tag_types as $type => $str) {
+                if (strlen($str) > 0) {
+                    $content .= "🏷 <b>{$type}:</b> {$str}<br/>";
+                }
+            }
+        }
+
+        if (array_key_exists('reference_gallery_sections', $data) && sizeof($data['reference_gallery_sections']) > 0) {
+            $content .= '📁 Example folder(s): ';
+            foreach ($data['folders'] as $folder) {
+                $url = self::URI . '/profile/' . $data['owner_username'] . '/gallery/' . $folder['id'];
+                $folder_name = $folder['title'];
+                if (!is_null($folder['group'])) {
+                    $folder_name = $folder['group']['title'] . '/' . $folder_name;
+                }
+                $content .= "<a href=\"{$url}\">#{$folder_name}</a> ";
+            }
+        }
+
+        $content .= '<hr/>';
+        if (!is_null($data['thumbnail_detail'])) {
+            $content .= '<p>';
+            $content .= "<a href=\"{$uri}\"><b>{$data['thumbnail_detail']['title']}</b></a><br/>";
+            if ($data['thumbnail_detail']['is_thumbnail_for_video']) {
+                $url = self::URI . '/api/galleries/images/' . $data['thumbnail_detail']['id'] . '/?format=json';
+                $media_data = $this->getData($url, true, true)
+                    or returnServerError("Could not load $url");
+                $content .= "<video controls src=\"{$media_data['video']['video']}\" poster=\"{$data['thumbnail_detail']['image_lg']}\"/>";
+            } else {
+                $content .= "<a href=\"{$uri}\"><img src=\"{$data['thumbnail_detail']['image_lg']}\"></a>";
+            }
+
+            $content .= '</p>';
+        }
+
+        return [
+            'uri' => $uri,
+            'title' => "{$data['comm_type']}: {$data['title']}",
+            'timestamp' => $data['date_added'],
+            'author' => $data['owner_username'],
+            'content' => $content,
+            'categories' => ['commission', $data['comm_type']],
+            'uid' => $uri
+        ];
+    }
+
+    private function getImage($id /* array $metadata = null */) //$metadata disabled due to no essential information available in ./api/feed/ or ./api/galleries/images/ results.
+    {
+        $uri = self::URI . '/images/' . $id;
+        $url = self::URI . '/api/galleries/images/' . $id . '/?format=json';
+        $data = /* $metadata ?? */ $this->getData($url, true, true)
+            or returnServerError("Could not load $url");
+
+        $content_str = nl2br($data['description']);
+        $content = "<p>{$content_str}</p><br/>"; //TODO: Add link and itaku user mention detection and convert into links.
+
+        if (array_key_exists('tags', $data) && sizeof($data['tags']) > 0) {
+            // $content .= "🏷 Tag(s): ";
+            $tag_types = [
+                'ARTIST' => '',
+                'COPYRIGHT' => '',
+                'CHARACTER' => '',
+                'SPECIES' => '',
+                'GENERAL' => '',
+                'META' => ''
+            ];
+            foreach ($data['tags'] as $tag) {
+                $url = self::URI . '/tags/' . $tag['id'];
+                $str = "<a href=\"{$url}\">#{$tag['name']}</a> ";
+                $tag_types[$tag['tag_type']] .= $str;
+            }
+
+            foreach ($tag_types as $type => $str) {
+                if (strlen($str) > 0) {
+                    $content .= "🏷 <b>{$type}:</b> {$str}<br/>";
+                }
+            }
+        }
+
+        if (array_key_exists('sections', $data) && sizeof($data['sections']) > 0) {
+            $content .= '📁 In Folder(s): ';
+            foreach ($data['sections'] as $folder) {
+                $url = self::URI . '/profile/' . $data['owner_username'] . '/gallery/' . $folder['id'];
+                $folder_name = $folder['title'];
+                if (!is_null($folder['group'])) {
+                    $folder_name = $folder['group']['title'] . '/' . $folder_name;
+                }
+                $content .= "<a href=\"{$url}\">#{$folder_name}</a> ";
+            }
+        }
+
+        $content .= '<hr/>';
+
+        if (array_key_exists('is_thumbnail_for_video', $data)) {
+            $url = self::URI . '/api/galleries/images/' . $data['id'] . '/?format=json';
+            $media_data = $this->getData($url, true, true)
+                or returnServerError("Could not load $url");
+            $content .= "<video controls src=\"{$media_data['video']['video']}\" poster=\"{$data['image_xl']}\"/>";
+        } else {
+            if (array_key_exists('video', $data) && is_null($data['video'])) {
+                $content .= "<a href=\"{$uri}\"><img src=\"{$data['image_xl']}\"></a>";
+            } else {
+                $content .= "<video controls src=\"{$data['video']['video']}\" poster=\"{$data['image_xl']}\"/>";
+            }
+        }
+
+        return [
+            'uri' => $uri,
+            'title' => $data['title'],
+            'timestamp' => $data['date_added'],
+            'author' => $data['owner_username'],
+            'content' => $content,
+            'categories' => ['image'],
+            'uid' => $uri
+        ];
+    }
+
+    private function getData(string $url, bool $cache = false, bool $getJSON = false, array $httpHeaders = [], array $curlOptions = [])
+    {
+        // Debug::log($url);
+        if ($getJSON) { //get JSON object
+            if ($cache) {
+                $data = $this->loadCacheValue($url, 86400); // 24 hours
+                if (is_null($data)) {
+                    $data = getContents($url, $httpHeaders, $curlOptions) or returnServerError("Could not load $url");
+                    $this->saveCacheValue($url, $data);
+                }
+            } else {
+                $data = getContents($url, $httpHeaders, $curlOptions) or returnServerError("Could not load $url");
+            }
+            return json_decode($data, true);
+        } else { //get simpleHTMLDOM object
+            if ($cache) {
+                $html = getSimpleHTMLDOMCached($url, 86400); // 24 hours
+            } else {
+                $html = getSimpleHTMLDOM($url);
+            }
+            $html = defaultLinkTo($html, $url);
+            return $html;
+        }
+    }
+
+    private function addItem($item)
+    {
+        if (is_null($item)) {
+            return;
+        }
+
+        if (is_array($item) || is_object($item)) {
+            $this->items[] = $item;
+        } else {
+            returnServerError("Incorrectly parsed item. Check the code!\nType: " . gettype($item) . "\nprint_r(item:)\n" . var_dump($item));
+        }
+    }
+}

From 28077155ca9343c6492fac36fc71078a6633e984 Mon Sep 17 00:00:00 2001
From: mruac <ant8672@gmail.com>
Date: Tue, 15 Aug 2023 23:34:09 +0930
Subject: [PATCH 069/716] [PatreonBridge] Resolve creator name in feed name
 (#3616)

* resolve creators without custom url

* hint how to enter creator with non-custom url

* applied phpcbf
---
 bridges/PatreonBridge.php | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/bridges/PatreonBridge.php b/bridges/PatreonBridge.php
index b64102da..23dbf8ae 100644
--- a/bridges/PatreonBridge.php
+++ b/bridges/PatreonBridge.php
@@ -6,13 +6,13 @@ class PatreonBridge extends BridgeAbstract
     const URI = 'https://www.patreon.com/';
     const CACHE_TIMEOUT = 300; // 5min
     const DESCRIPTION = 'Returns posts by creators on Patreon';
-    const MAINTAINER = 'Roliga';
-    const PARAMETERS = [ [
+    const MAINTAINER = 'Roliga, mruac';
+    const PARAMETERS = [[
         'creator' => [
             'name' => 'Creator',
             'type' => 'text',
             'required' => true,
-            'exampleValue' => 'sanityinc',
+            'exampleValue' => 'user?u=13425451',
             'title' => 'Creator name as seen in their page URL'
         ]
     ]];
@@ -189,7 +189,13 @@ class PatreonBridge extends BridgeAbstract
     public function getName()
     {
         if (!is_null($this->getInput('creator'))) {
-            return $this->getInput('creator') . ' posts';
+            $html = getSimpleHTMLDOMCached($this->getURI());
+            if ($html) {
+                preg_match('#"name": "(.*)"#', $html->save(), $matches);
+                return 'Patreon posts from ' . stripcslashes($matches[1]);
+            } else {
+                return $this->getInput('creator') . 'posts from Patreon';
+            }
         }
 
         return parent::getName();

From a1237d90f10539dcea9d3efdbff5dd5472b1928b Mon Sep 17 00:00:00 2001
From: Corentin Garcia <corenting@gmail.com>
Date: Tue, 15 Aug 2023 16:16:06 +0200
Subject: [PATCH 070/716] [RainbowSixSiegeBridge] fix links, date and img tag
 (#3619)

---
 bridges/RainbowSixSiegeBridge.php | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/bridges/RainbowSixSiegeBridge.php b/bridges/RainbowSixSiegeBridge.php
index 73e2bdc4..77495a3c 100644
--- a/bridges/RainbowSixSiegeBridge.php
+++ b/bridges/RainbowSixSiegeBridge.php
@@ -9,7 +9,7 @@ class RainbowSixSiegeBridge extends BridgeAbstract
     const DESCRIPTION = 'Latest news about Rainbow Six Siege';
 
     // API key to call Ubisoft API, extracted from the React frontend
-    const NIMBUS_API_KEY = '3u0FfSBUaTSew-2NVfAOSYWevVQHWtY9q3VM8Xx9Lto';
+    const NIMBUS_API_KEY = '3b5a8be6dde511ec9d640242ac120002';
 
     public function getIcon()
     {
@@ -32,18 +32,23 @@ class RainbowSixSiegeBridge extends BridgeAbstract
         for ($i = 0; $i < count($json); $i++) {
             $jsonItem = $json[$i];
 
-            $uri = 'https://www.ubisoft.com/en-us/game/rainbow-six/siege';
+            $uri = 'https://www.ubisoft.com/en-us/game/rainbow-six/siege/news-updates';
             $uri = $uri . $jsonItem['button']['buttonUrl'];
 
-            $thumbnail = '<img src="' . $jsonItem['thumbnail']['url'] . '" alt="Thumbnail">';
+            $thumbnail = '<img src="' . $jsonItem['thumbnail']['url'] . '" alt="Thumbnail" />';
             $content = $thumbnail . '<br />' . markdownToHtml($jsonItem['content']);
 
             $item = [];
+
+            // The date string includes (Coordinated Universal Time) at the end
+            // so remove it to use strtotime
+            $date_str = str_replace('(Coordinated Universal Time)', '', $jsonItem['date']);
+            $item['timestamp'] = strtotime($date_str);
+
             $item['uri'] = $uri;
             $item['id'] = $jsonItem['id'];
             $item['title'] = $jsonItem['title'];
             $item['content'] = $content;
-            $item['timestamp'] = strtotime($jsonItem['date']);
 
             $this->items[] = $item;
         }

From 79e3f7f20474c2fda99640ffa69f94fd05d6d991 Mon Sep 17 00:00:00 2001
From: John S Long <john@128.io>
Date: Sat, 19 Aug 2023 21:37:21 -0500
Subject: [PATCH 071/716] [MastodonBridge] Add support for excluding regular
 statuses (non-boosts/replies) (#3624)

* [MastodonBridge]: add support for excluding posts (non-boosts/replies)

* Update name of input

* Fix lint failures
---
 bridges/MastodonBridge.php | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/bridges/MastodonBridge.php b/bridges/MastodonBridge.php
index 372838ca..855aae08 100644
--- a/bridges/MastodonBridge.php
+++ b/bridges/MastodonBridge.php
@@ -35,6 +35,11 @@ class MastodonBridge extends BridgeAbstract
             'exampleValue' => '@sebsauvage@framapiaf.org',
             'required' => true,
         ],
+        'noregular' => [
+            'name' => 'Without regular statuses',
+            'type' => 'checkbox',
+            'title' => 'Hide regular statuses (i.e. non-boosts, replies, etc.)',
+        ],
         'norep' => [
             'name' => 'Without replies',
             'type' => 'checkbox',
@@ -61,6 +66,10 @@ class MastodonBridge extends BridgeAbstract
 
     public function collectData()
     {
+        if ($this->getInput('norep') && $this->getInput('noboost') && $this->getInput('noregular')) {
+            throw new \Exception('replies, boosts, or regular statuses must be allowed');
+        }
+
         $user = $this->fetchAP($this->getURI());
         if (!isset($user['outbox'])) {
             throw new \Exception('Unable to find the outbox');
@@ -115,6 +124,9 @@ class MastodonBridge extends BridgeAbstract
                 if ($this->getInput('norep') && isset($content['inReplyTo'])) {
                     return null;
                 }
+                if ($this->getInput('noregular') && !isset($content['inReplyTo'])) {
+                    return null;
+                }
                 $item['title'] = '';
                 $item['author'] = $this->getInput('canusername');
                 $item = $this->parseObject($content, $item);
@@ -123,6 +135,9 @@ class MastodonBridge extends BridgeAbstract
                 if ($this->getInput('norep') && isset($content['object']['inReplyTo'])) {
                     return null;
                 }
+                if ($this->getInput('noregular') && !isset($content['object']['inReplyTo'])) {
+                    return null;
+                }
                 $item['title'] = '';
                 $item['author'] = $this->getInput('canusername');
                 $item = $this->parseObject($content['object'], $item);
@@ -147,7 +162,7 @@ class MastodonBridge extends BridgeAbstract
 
         if (isset($object['name'])) {
             $item['title'] = $object['name'];
-        } else if (mb_strlen($strippedContent) > 75) {
+        } elseif (mb_strlen($strippedContent) > 75) {
             $contentSubstring = mb_substr($strippedContent, 0, mb_strpos(wordwrap($strippedContent, 75), "\n"));
             $item['title'] .= $contentSubstring . '...';
         } else {

From 959dd937b4b5c6bc9f37c659652900986c123f69 Mon Sep 17 00:00:00 2001
From: Eugene Molotov <eugene.molotov@yandex.ru>
Date: Mon, 21 Aug 2023 07:53:54 +0500
Subject: [PATCH 072/716] [VkBridge] Using more universal regular expression to
 generate item title (#3627)

---
 bridges/VkBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/VkBridge.php b/bridges/VkBridge.php
index 8c18f26a..90b2586e 100644
--- a/bridges/VkBridge.php
+++ b/bridges/VkBridge.php
@@ -453,7 +453,7 @@ class VkBridge extends BridgeAbstract
     {
         $content = explode('<br>', $content)[0];
         $content = strip_tags($content);
-        preg_match('/^[:,"\w\ \p{L}\(\)\?#«»-]+/mu', htmlspecialchars_decode($content), $result);
+        preg_match('/.+?(?=[\.\n])/mu', htmlspecialchars_decode($content), $result);
         if (count($result) == 0) {
             return 'untitled';
         }

From c5cbab123120e243f091a20644b4de16d068667e Mon Sep 17 00:00:00 2001
From: veloute <21003408+veloute@users.noreply.github.com>
Date: Tue, 22 Aug 2023 15:59:06 +0000
Subject: [PATCH 073/716] Update TheGuardianBridge.php (#3629)

---
 bridges/TheGuardianBridge.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/bridges/TheGuardianBridge.php b/bridges/TheGuardianBridge.php
index 2e14de7a..e05bde75 100644
--- a/bridges/TheGuardianBridge.php
+++ b/bridges/TheGuardianBridge.php
@@ -15,6 +15,7 @@ class TheGuardianBridge extends FeedExpander
                 'World News' => 'world/rss',
                 'US News' => '/us-news/rss',
                 'UK News' => '/uk-news/rss',
+                'Australia News' => '/australia-news/rss',
                 'Europe News' => '/world/europe-news/rss',
                 'Asia News' => '/world/asia/rss',
                 'Tech' => '/uk/technology/rss',

From 3ac861a86681b480fd194e102713044c485c57c0 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 22 Aug 2023 19:47:32 +0200
Subject: [PATCH 074/716] fix(twitch): Invalid argument supplied for foreach()
 at bridges/TwitchBridge.php line 115 (#3630)

---
 bridges/TwitchBridge.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/bridges/TwitchBridge.php b/bridges/TwitchBridge.php
index 8976174a..146fed3d 100644
--- a/bridges/TwitchBridge.php
+++ b/bridges/TwitchBridge.php
@@ -112,7 +112,9 @@ EOD;
             if (!is_null($video->game)) {
                 $item['categories'][] = $video->game->displayName;
             }
-            foreach ($video->contentTags as $tag) {
+
+            $contentTags = $video->contentTags ?? [];
+            foreach ($contentTags as $tag) {
                 if (!$tag->isLanguageTag) {
                     $item['categories'][] = $tag->localizedName;
                 }

From 54045be951cf7deab15535fccd93dc89998150d8 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 22 Aug 2023 20:06:16 +0200
Subject: [PATCH 075/716] fix(tpb): add missing cat (#3631)

---
 bridges/ThePirateBayBridge.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/bridges/ThePirateBayBridge.php b/bridges/ThePirateBayBridge.php
index 13095062..5b305c82 100644
--- a/bridges/ThePirateBayBridge.php
+++ b/bridges/ThePirateBayBridge.php
@@ -65,6 +65,7 @@ class ThePirateBayBridge extends BridgeAbstract
         '207' => 'HD Movies',
         '208' => 'HD TV-Shows',
         '209' => '3D',
+        '212' => 'UHD/4k TV-Shows',
         '299' => 'Other',
         '301' => 'Windows',
         '302' => 'Mac/Apple',

From 7591b10219222f818d523f457fa6d01e1891260b Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Tue, 22 Aug 2023 20:44:36 +0200
Subject: [PATCH 076/716] [Core] New feature : User Interface to "Detect" Feed
 from an URL (#3436)

* [Core] New feature : User Interface to "Detect" Feed from an URL

Detect Action has been expanded to support returning a Feed in a JSON
format instead of a Redirect. Existing usage of the Detect action will
keep working as usual.

Frontpage template has now a section to display the Feed detection
result, and a button to start the Feed Detection.

A new JS file contains the necessary JS (Ajax and Event management) to
fill the Feed Detection section.

* Coding policy fixes

* [Core] New feature : User Interface to "Detect" Feed from an URL

- Switch from old school XMLHttpRequest to fetch
- Enhance UX of search results
- Revert to it's original content
- Switch to a new Action : FindfeedAction.php
- Switch to template literals instead of string concatenation
- FindFeed action could retrun multiple feeds
- Results are sent with an absolute URL
- Switch to Json::encode() helper function

* [Core] New feature : User Interface to "Detect" Feed from an URL

- Move specific JS code to rss-bridge.js
- Change HTML tag for the button to have a consistant style with th rest
  of the page

* [Core] New feature : User Interface to "Detect" Feed from an URL

- If no context is sent, assume there is only one unnamed context
- Find parameter name in global and currect context

* fix

* remove typo

---------

Co-authored-by: Dag <me@dvikan.no>
---
 actions/FindfeedAction.php   | 89 ++++++++++++++++++++++++++++++++++++
 static/rss-bridge.js         | 79 ++++++++++++++++++++++++++++++++
 static/style.css             | 35 ++++++++++++++
 templates/frontpage.html.php |  9 ++++
 4 files changed, 212 insertions(+)
 create mode 100644 actions/FindfeedAction.php

diff --git a/actions/FindfeedAction.php b/actions/FindfeedAction.php
new file mode 100644
index 00000000..25fe4714
--- /dev/null
+++ b/actions/FindfeedAction.php
@@ -0,0 +1,89 @@
+<?php
+
+/**
+ * This action is used by the frontpage form search.
+ * It finds a bridge based off of a user input url.
+ * It uses bridges' detectParameters implementation.
+ */
+class FindfeedAction implements ActionInterface
+{
+    public function execute(array $request)
+    {
+        $targetURL = $request['url'] ?? null;
+        $format = $request['format'] ?? null;
+
+        if (!$targetURL) {
+            return new Response('You must specify a url', 400);
+        }
+        if (!$format) {
+            return new Response('You must specify a format', 400);
+        }
+
+        $bridgeFactory = new BridgeFactory();
+
+        $results = [];
+        foreach ($bridgeFactory->getBridgeClassNames() as $bridgeClassName) {
+            if (!$bridgeFactory->isEnabled($bridgeClassName)) {
+                continue;
+            }
+
+            $bridge = $bridgeFactory->create($bridgeClassName);
+
+            $bridgeParams = $bridge->detectParameters($targetURL);
+
+            if ($bridgeParams === null) {
+                continue;
+            }
+
+            // It's allowed to have no 'context' in a bridge (only a default context without any name)
+            // In this case, the reference to the parameters are found in the first element of the PARAMETERS array
+
+            $context = $bridgeParams['context'] ?? 0;
+
+            $bridgeData = [];
+            // Construct the array of parameters
+            foreach ($bridgeParams as $key => $value) {
+                // 'context' is a special case : it's a bridge parameters, there is no "name" for this parameter
+                if ($key == 'context') {
+                    $bridgeData[$key]['name'] = 'Context';
+                    $bridgeData[$key]['value'] = $value;
+                } else {
+                    $bridgeData[$key]['name'] = $this->getParameterName($bridge, $context, $key);
+                    $bridgeData[$key]['value'] = $value;
+                }
+            }
+
+            $bridgeParams['bridge'] = $bridgeClassName;
+            $bridgeParams['format'] = $format;
+            $content = [
+                'url' => get_home_page_url() . '?action=display&' . http_build_query($bridgeParams),
+                'bridgeParams' => $bridgeParams,
+                'bridgeData' => $bridgeData,
+                'bridgeMeta' => [
+                        'name' => $bridge::NAME,
+                        'description' => $bridge::DESCRIPTION,
+                        'parameters' => $bridge::PARAMETERS,
+                        'icon' => $bridge->getIcon(),
+                    ],
+            ];
+            $results[] = $content;
+        }
+        if ($results === []) {
+            return new Response(Json::encode(['message' => 'No bridge found for given url']), 404, ['content-type' => 'application/json']);
+        }
+        return new Response(Json::encode($results), 200, ['content-type' => 'application/json']);
+    }
+
+    // Get parameter name in the actual context, or in the global parameter
+    private function getParameterName($bridge, $context, $key)
+    {
+        if (isset($bridge::PARAMETERS[$context][$key]['name'])) {
+            $name = $bridge::PARAMETERS[$context][$key]['name'];
+        } else if (isset($bridge::PARAMETERS['global'][$key]['name'])) {
+            $name = $bridge::PARAMETERS['global'][$key]['name'];
+        } else {
+            $name = 'Variable "' . $key . '" (No name provided)';
+        }
+        return $name;
+    }
+}
diff --git a/static/rss-bridge.js b/static/rss-bridge.js
index 498acd37..82069d8c 100644
--- a/static/rss-bridge.js
+++ b/static/rss-bridge.js
@@ -47,3 +47,82 @@ function rssbridge_toggle_bridge(){
         bridge.getElementsByClassName('showmore-box')[0].checked = true;
     }
 }
+
+var rssbridge_feed_finder = (function() {
+    /*
+     * Code for "Find feed by URL" feature
+     */
+
+    // Start the Feed search
+    async function rssbridge_feed_search(event) {
+        const input = document.getElementById('searchfield');
+        let content = input.value;
+        if (content) {
+            const findfeedresults = document.getElementById('findfeedresults');
+            findfeedresults.innerHTML = 'Searching for matching feeds ...';
+            let baseurl = window.location.protocol + window.location.pathname;
+            let url = baseurl + '?action=findfeed&format=Html&url=' + content;
+            const response = await fetch(url);
+            if (response.ok) {
+                const data = await response.json();
+                rss_bridge_feed_display_found_feed(data);
+            } else {
+                rss_bridge_feed_display_feed_search_fail();
+            }
+        } else {
+            rss_bridge_feed_display_find_feed_empty();
+        }
+    }
+
+    // Display the found feeds
+    function rss_bridge_feed_display_found_feed(obj) {
+        const findfeedresults = document.getElementById('findfeedresults');
+
+        let content = 'Found Feed(s) :';
+
+        // Let's go throug every Feed found
+        for (const element of obj) {
+            content += `<div class="search-result">
+                        <div class="icon">
+                            <img src="${element.bridgeMeta.icon}" width="60" />
+                        </div>
+                        <div class="content">
+                        <h2><a href="${element.url}">${element.bridgeMeta.name}</a></h2>
+                        <p>
+                        <span class="description"><a href="${element.url}">${element.bridgeMeta.description}</a></span>
+                        </p>
+                        <div>
+                            <ul>`;
+
+            // Now display every Feed parameter
+            for (const param in element.bridgeData) {
+                content += `<li>${element.bridgeData[param].name} : ${element.bridgeData[param].value}</li>`;
+            }
+            content += `</div>
+              </div>
+            </div>`;
+        }
+        content += '<p><div class="alert alert-info" role="alert">This feed may be only one of the possible feeds. You may find more feeds using one of the bridges with different parameters, for example.</div></p>';
+        findfeedresults.innerHTML = content;
+    }
+
+    // Display an error if no feed were found
+    function rss_bridge_feed_display_feed_search_fail() {
+        const findfeedresults = document.getElementById('findfeedresults');
+        findfeedresults.innerHTML = 'No Feed found !<div class="alert alert-info" role="alert">Not every bridge supports feed detection. You can check below within the bridge parameters to create a feed.</div>';
+    }
+
+    // Empty the Found Feed section
+    function rss_bridge_feed_display_find_feed_empty() {
+        const findfeedresults = document.getElementById('findfeedresults');
+        findfeedresults.innerHTML = '';
+    }
+
+    // Add Event to 'Detect Feed" button
+    var rssbridge_feed_finder = function() {
+        const button = document.getElementById('findfeed');
+        button.addEventListener("click", rssbridge_feed_search);
+        button.addEventListener("keyup", rssbridge_feed_search);
+    };
+    return rssbridge_feed_finder;
+}());
diff --git a/static/style.css b/static/style.css
index a83e25e4..a9d5933a 100644
--- a/static/style.css
+++ b/static/style.css
@@ -453,3 +453,38 @@ button {
         color: #d8d3cb;
     }
 }
+
+/* find-feed */
+.search-result {
+  background-color: #f0f0f0;
+  border-radius: 5px;
+  padding: 15px;
+  display: flex;
+  position: relative;
+  text-align: left;
+}
+@media (prefers-color-scheme: dark) {
+    .search-result {
+        background-color: #202325;
+    }
+}
+.search-result h2 {
+  color: #288cfc;
+}
+
+.search-result a {
+  text-decoration: none;
+  color: #248afa;
+}
+.search-result .icon {
+  margin: 0 15px 0 0;
+}
+.search-result span {
+  margin-right: 10px;
+}
+.search-result .description {
+  font-size: 110%;
+  margin-right: 0 !important;
+  margin-top: 5px !important;
+}
+/* end find-feed */
diff --git a/templates/frontpage.html.php b/templates/frontpage.html.php
index 63f4a2ab..99e2ffd9 100644
--- a/templates/frontpage.html.php
+++ b/templates/frontpage.html.php
@@ -2,6 +2,7 @@
 <script>
     document.addEventListener('DOMContentLoaded', rssbridge_toggle_bridge);
     document.addEventListener('DOMContentLoaded', rssbridge_list_search);
+    document.addEventListener('DOMContentLoaded', rssbridge_feed_finder);
 </script>
 
 <section class="searchbar">
@@ -15,6 +16,14 @@
         onkeyup="rssbridge_list_search()"
         value=""
     >
+    <button
+        type="button"
+	    id="findfeed"
+        name="findfeed"
+    />Find Feed from URL</button>
+    <section id="findfeedresults">
+    </section>
+
 </section>
 
 <?= raw($bridges) ?>

From eb4ff7099f07859a2a3078c50a7d5366ca722bb1 Mon Sep 17 00:00:00 2001
From: Lars Stegman <LarsStegman@users.noreply.github.com>
Date: Tue, 22 Aug 2023 21:28:16 +0200
Subject: [PATCH 077/716] CSS Selector Bridge 2 (#3626)

* [CssSelector2Bridge] Implement CSS Selector bridge 2

* [CssSelector2Bridge] Fix author not being loaded

* [CssSelector2Bridge] Remove unneeded time nullcheck

* Fix linting

* Fix failing test

* Implement PR fixes

* Update bridges/CssSelector2Bridge.php

Co-authored-by: ORelio <ORelio@users.noreply.github.com>

* Rename bridge and fix syntax error for php7

---------

Co-authored-by: ORelio <ORelio@users.noreply.github.com>
---
 bridges/CssSelectorComplexBridge.php | 458 +++++++++++++++++++++++++++
 1 file changed, 458 insertions(+)
 create mode 100644 bridges/CssSelectorComplexBridge.php

diff --git a/bridges/CssSelectorComplexBridge.php b/bridges/CssSelectorComplexBridge.php
new file mode 100644
index 00000000..4d44f853
--- /dev/null
+++ b/bridges/CssSelectorComplexBridge.php
@@ -0,0 +1,458 @@
+<?php
+
+class CssSelectorComplexBridge extends BridgeAbstract
+{
+    const MAINTAINER = 'Lars Stegman';
+    const NAME = 'CSS Selector Complex Bridge';
+    const URI = 'https://github.com/RSS-Bridge/rss-bridge/';
+    const DESCRIPTION = <<<EOT
+        Convert any site to RSS feed using CSS selectors (Advanced Users). The bridge first selects 
+        the element describing the article entries. It then extracts the links to the articles from 
+        these elements. It then, depending on the setting "Load article from page", either parses 
+        the selected elements, or downloads the page for each article and parses those. Parsing the 
+        elements or page is done using the provided selectors.
+        EOT;
+    const PARAMETERS = [
+        [
+            'home_page' => [
+                'name' => 'Site URL: Page with latest articles',
+                'exampleValue' => 'https://example.com/blog/',
+                'required' => true
+            ],
+            'cookie' => [
+                'name' => '[Optional] Cookie',
+                'title' => <<<EOT
+                Use when the website does not send the page contents, unless a static cookie is included.
+                EOT,
+                'exampleValue' => 'sessionId=deadb33f'
+            ],
+            'title_cleanup' => [
+                'name' => '[Optional] Text to remove from feed title',
+                'title' => <<<EOT
+                Text to remove from the feed title, which is read from the article list page.
+                EOT,
+                'exampleValue' => ' | BlogName',
+            ],
+            'entry_element_selector' => [
+                'name' => 'Selector for article entry elements',
+                'title' => <<<EOT
+                This bridge works using CSS selectors, e.g. "div.article" will match all 
+                <div class="article">...</div> on home page, each one being treated as a feed item.
+
+                Use the URL selector option to select the `a` element with the
+                `href` to the article link. If this option is not configured, the first encountered 
+                `a` element is used.
+                EOT,
+                'exampleValue' => 'div.article',
+                'required' => true
+            ],
+            'url_selector' => [
+                'name' => '[Optional] Selector for link elements',
+                'title' => <<<EOT
+                    The selector to find `a` elements in the entry element. If empty,
+                    the first encountered `a` element is used. The `href` property
+                    is used to create entries in the feed.
+                    EOT,
+                'exampleValue' => 'a.article',
+                'defaultValue' => 'a'
+            ],
+            'url_pattern' => [
+                'name' => '[Optional] Pattern for site URLs to keep in feed',
+                'title' => 'Optionally filter items by applying a regular expression on their URL',
+                'exampleValue' => '/blog/article/.*',
+            ],
+            'limit' => self::LIMIT,
+            'use_article_pages' => [
+                'name' => 'Load article from page',
+                'title' => <<<EOT
+                If true, the article page is load and parsed to get the article contents using 
+                the css selectors. (Slower!)
+                Otherwise, the element selected by the article entry selector is used.
+                EOT,
+                'type' => 'checkbox'
+            ],
+            'article_page_content_selector' => [
+                'name' => '[Optional] Selector to select article element',
+                'title' => 'Extract the article from its page using the provided selector',
+                'exampleValue' => 'article.content',
+            ],
+            'content_cleanup' => [
+                'name' => '[Optional] Content cleanup: selector for items to remove',
+                'title' => 'Selector for unnecessary elements to remove inside article contents.',
+                'exampleValue' => 'div.ads, div.comments',
+            ],
+            'title_selector' => [
+                'name' => '[Optional] Selector for the article title',
+                'title' => 'Selector to select the article title',
+                'defaultValue' => 'h1'
+            ],
+            'category_selector' => [
+                'name' => '[Optional] Categories',
+                'title' => <<<EOT
+                Selector to extract the catgories the article has
+                EOT,
+                'exampleValue' => 'span.category, #main-category'
+            ],
+            'author_selector' => [
+                'name' => '[Optional] Author',
+                'title' => <<<EOT
+                Selector to extract the author of the article. If multiple elements are selected
+                the first one is used.
+                EOT,
+                'exampleValue' => 'span#author'
+            ],
+            'time_selector' => [
+                'name' => '[Optional] Time selector',
+                'title' => <<<EOT
+                Selector to extract the timestamp of the article. If the element 
+                is an html5 `time` element, the value for the `datetime` attribute is used.
+                EOT,
+            ],
+            'time_format' => [
+                'name' => '[Optional] Format string for parsing time',
+                'title' => <<<EOT
+                The format to use to parse the timestamp. See 
+                https://www.php.net/manual/en/datetimeimmutable.createfromformat.php
+                for the format specification.
+                EOT
+            ],
+            'remove_styling' => [
+                'name' => '[Optional] Remove styling',
+                'title' => 'Remove class and style attributes from the page elements',
+                'type' => 'checkbox'
+            ]
+        ]
+    ];
+
+    private $feedName = '';
+
+    public function getURI()
+    {
+        $url = $this->getInput('home_page');
+        if (empty($url)) {
+            $url = parent::getURI();
+        }
+        return $url;
+    }
+
+    public function getName()
+    {
+        if (!empty($this->feedName)) {
+            return $this->feedName;
+        }
+        return parent::getName();
+    }
+
+    protected function getHeaders()
+    {
+        $headers = [];
+        $cookie = $this->getInput('cookie');
+        if (!empty($cookie)) {
+            $headers[] = 'Cookie: ' . $cookie;
+        }
+
+        return $headers;
+    }
+
+    public function collectData()
+    {
+        $url = $this->getInput('home_page');
+        $headers = $this->getHeaders();
+
+        $entry_element_selector = $this->getInput('entry_element_selector');
+        $url_selector = $this->getInput('url_selector');
+        $url_pattern = $this->getInput('url_pattern');
+        $limit = $this->getInput('limit') ?? 10;
+
+        $use_article_pages = $this->getInput('use_article_pages');
+        $article_page_content_selector = $this->getInput('article_page_content_selector');
+        $content_cleanup = $this->getInput('content_cleanup');
+        $title_selector = $this->getInput('title_selector');
+        $title_cleanup = $this->getInput('title_cleanup');
+        $time_selector = $this->getInput('time_selector');
+        $time_format = $this->getInput('time_format');
+
+        $category_selector = $this->getInput('category_selector');
+        $author_selector = $this->getInput('author_selector');
+        $remove_styling = $this->getInput('remove_styling');
+
+        $html = defaultLinkTo(getSimpleHTMLDOM($url, $headers), $url);
+        $this->feedName = $this->getTitle($html, $title_cleanup);
+        $entry_elements = $this->htmlFindEntryElements($html, $entry_element_selector, $url_selector, $url_pattern, $limit);
+
+        if (empty($entry_elements)) {
+            return;
+        }
+
+        // Fetch the elements from the article pages.
+        if ($use_article_pages) {
+            if (empty($article_page_content_selector)) {
+                returnClientError('`Article selector` is required when `Load article page` is enabled');
+            }
+
+            foreach (array_keys($entry_elements) as $uri) {
+                $entry_elements[$uri] = $this->fetchArticleElementFromPage($uri, $article_page_content_selector);
+            }
+        }
+
+        foreach ($entry_elements as $uri => $element) {
+            $entry = $this->parseEntryElement(
+                $element,
+                $title_selector,
+                $author_selector,
+                $category_selector,
+                $time_selector,
+                $time_format,
+                $content_cleanup,
+                $this->feedName,
+                $remove_styling
+            );
+
+            $entry['uri'] = $uri;
+            $this->items[] = $entry;
+        }
+    }
+
+    /**
+     * Filter a list of URLs using a pattern and limit
+     * @param array $links List of URLs
+     * @param string $url_pattern Pattern to look for in URLs
+     * @param int $limit Optional maximum amount of URLs to return
+     * @return array Array of URLs
+     */
+    protected function filterUrlList($links, $url_pattern, $limit = 0)
+    {
+        if (!empty($url_pattern)) {
+            $url_pattern = '/' . str_replace('/', '\/', $url_pattern) . '/';
+            $links = array_filter($links, function ($url) {
+                return preg_match($url_pattern, $url) === 1;
+            });
+        }
+
+        if ($limit > 0 && count($links) > $limit) {
+            $links = array_slice($links, 0, $limit);
+        }
+
+        return $links;
+    }
+
+    /**
+     * Retrieve title from webpage URL or DOM
+     * @param string|object $page URL or DOM to retrieve title from
+     * @param string $title_cleanup optional string to remove from webpage title, e.g. " | BlogName"
+     * @return string Webpage title
+     */
+    protected function getTitle($page, $title_cleanup)
+    {
+        if (is_string($page)) {
+            $page = getSimpleHTMLDOMCached($page);
+        }
+        $title = html_entity_decode($page->find('title', 0)->plaintext);
+        if (!empty($title)) {
+            $title = trim(str_replace($title_cleanup, '', $title));
+        }
+
+        return $title;
+    }
+
+    /**
+     * Remove all elements from HTML content matching cleanup selector
+     * @param string|object $content HTML content as HTML object or string
+     * @return string|object Cleaned content (same type as input)
+     */
+    protected function cleanArticleContent($content, $cleanup_selector, $remove_styling)
+    {
+        $string_convert = false;
+        if (is_string($content)) {
+            $string_convert = true;
+            $content = str_get_html($content);
+        }
+
+        if (!empty($cleanup_selector)) {
+            foreach ($content->find($cleanup_selector) as $item_to_clean) {
+                $item_to_clean->outertext = '';
+            }
+        }
+
+        if ($remove_styling) {
+            foreach (['class', 'style'] as $attribute_to_remove) {
+                foreach ($content->find('[' . $attribute_to_remove . ']') as $item_to_clean) {
+                    $item_to_clean->removeAttribute($attribute_to_remove);
+                }
+            }
+        }
+
+        if ($string_convert) {
+            $content = $content->outertext;
+        }
+        return $content;
+    }
+
+
+    /**
+     * Retrieve first N link+element from webpage URL or DOM satisfying the specified criteria
+     * @param string|object $page URL or DOM to retrieve feed items from
+     * @param string $entry_selector DOM selector for matching HTML elements that contain article
+     *  entries
+     * @param string $url_selector DOM selector for matching links
+     * @param string $url_pattern Optional filter to keep only links matching the pattern
+     * @param int $limit Optional maximum amount of URLs to return
+     * @return array of items { <uri> => <html-element> }
+     */
+    protected function htmlFindEntryElements($page, $entry_selector, $url_selector, $url_pattern = '', $limit = 0)
+    {
+        if (is_string($page)) {
+            $page = getSimpleHTMLDOM($page);
+        }
+
+        $entryElements = $page->find($entry_selector);
+        if (empty($entryElements)) {
+            returnClientError('No entry elements for entry selector');
+        }
+
+        // Extract URIs with the associated entry element
+        $links_with_elements = [];
+        foreach ($entryElements as $entry) {
+            $url_element = $entry->find($url_selector, 0);
+            if (is_null($url_element)) {
+                // No `a` element found in this entry
+                if ($entry->tag == 'a') {
+                    $url_element = $entry;
+                } else {
+                    continue;
+                }
+            }
+
+            $links_with_elements[$url_element->href] = $entry;
+        }
+
+        if (empty($links_with_elements)) {
+            returnClientError('The provided URL selector matches some elements, but they do not 
+                contain links.');
+        }
+
+        // Filter using the URL pattern
+        $filtered_urls = $this->filterUrlList(array_keys($links_with_elements), $url_pattern, $limit);
+
+        if (empty($filtered_urls)) {
+            returnClientError('No results for URL pattern');
+        }
+
+        $items = [];
+        foreach ($filtered_urls as $link) {
+            $items[$link] = $links_with_elements[$link];
+        }
+
+        return $items;
+    }
+
+
+    /**
+     * Retrieve article element from its URL using content selector and return the DOM element
+     * @param string $entry_url URL to retrieve article from
+     * @param string $content_selector HTML selector for extracting content, e.g. "article.content"
+     * @return article DOM element
+     */
+    protected function fetchArticleElementFromPage($entry_url, $content_selector)
+    {
+        $entry_html = getSimpleHTMLDOMCached($entry_url);
+        $article_content = $entry_html->find($content_selector, 0);
+
+        if (is_null($article_content)) {
+            returnClientError('Could not article content at URL: ' . $entry_url);
+        }
+
+        $article_content = defaultLinkTo($article_content, $entry_url);
+        return $article_content;
+    }
+
+    protected function parseTimeStrAsTimestamp($timeStr, $format)
+    {
+        $date = date_parse_from_format($format, $timeStr);
+        if ($date['error_count'] != 0) {
+            returnClientError('Error while parsing time string');
+        }
+
+        $timestamp = mktime(
+            $date['hour'],
+            $date['minute'],
+            $date['second'],
+            $date['month'],
+            $date['day'],
+            $date['year']
+        );
+
+        if ($timestamp == false) {
+            returnClientError('Error while creating timestamp');
+        }
+
+        return $timestamp;
+    }
+
+    /**
+     * Retrieve article content from its URL using content selector and return a feed item
+     * @param object $entry_html A DOM element containing the article
+     * @param string $title_selector A selector to the article title from the article
+     * @param string $author_selector A selector to find the article author
+     * @param string $time_selector A selector to get the article publication time.
+     * @param string $time_format The format to parse the time_selector.
+     * @param string $content_cleanup Optional selector for removing elements, e.g. "div.ads,
+     *  div.comments"
+     * @param string $title_default Optional title to use when could not extract title reliably
+     * @param bool $remove_styling Whether to remove class and style attributes from the HTML
+     * @return array Entry data: uri, title, content
+     */
+    protected function parseEntryElement(
+        $entry_html,
+        $title_selector = null,
+        $author_selector = null,
+        $category_selector = null,
+        $time_selector = null,
+        $time_format = null,
+        $content_cleanup = null,
+        $title_default = null,
+        $remove_styling = false
+    ) {
+        $article_content = convertLazyLoading($entry_html);
+
+        if (is_null($title_selector)) {
+            $article_title = $title_default;
+        } else {
+            $article_title = trim($entry_html->find($title_selector, 0)->innertext);
+        }
+
+        $author = null;
+        if (!is_null($author_selector) && $author_selector != '') {
+            $author = trim($entry_html->find($author_selector, 0)->innertext);
+        }
+
+        $categories = [];
+        if (!is_null($category_selector && $category_selector != '')) {
+            $category_elements = $entry_html->find($category_selector);
+            foreach ($category_elements as $category_element) {
+                $categories[] = trim($category_element->innertext);
+            }
+        }
+
+        $time = null;
+        if (!is_null($time_selector) && $time_selector != '') {
+            $time_element = $entry_html->find($time_selector, 0);
+            $time = $time_element->getAttribute('datetime');
+            if (is_null($time)) {
+                $time = $time_element->innertext;
+            }
+
+            $this->parseTimeStrAsTimestamp($time, $time_format);
+        }
+
+        $article_content = $this->cleanArticleContent($article_content, $content_cleanup, $remove_styling);
+
+        $item = [];
+        $item['title'] = $article_title;
+        $item['content'] = $article_content;
+        $item['categories'] = $categories;
+        $item['timestamp'] = $time;
+        $item['author'] = $author;
+        return $item;
+    }
+}

From 0325c2414a6b00311abb291d1189c97f120053bd Mon Sep 17 00:00:00 2001
From: t0stiman <18124323+t0stiman@users.noreply.github.com>
Date: Fri, 25 Aug 2023 12:34:35 +0200
Subject: [PATCH 078/716] fix carthrottlebridge (#3633)

---
 bridges/CarThrottleBridge.php | 51 ++++++++++++++++++-----------------
 1 file changed, 26 insertions(+), 25 deletions(-)

diff --git a/bridges/CarThrottleBridge.php b/bridges/CarThrottleBridge.php
index 95641573..5b95dd28 100644
--- a/bridges/CarThrottleBridge.php
+++ b/bridges/CarThrottleBridge.php
@@ -1,44 +1,45 @@
 <?php
 
-class CarThrottleBridge extends FeedExpander
+class CarThrottleBridge extends BridgeAbstract
 {
-    const NAME = 'Car Throttle ';
-    const URI = 'https://www.carthrottle.com';
+    const NAME = 'Car Throttle';
+    const URI = 'https://www.carthrottle.com/';
     const DESCRIPTION = 'Get the latest car-related news from Car Throttle.';
     const MAINTAINER = 't0stiman';
 
     public function collectData()
     {
-        $this->collectExpandableDatas('https://www.carthrottle.com/rss', 10);
-    }
+        $news = getSimpleHTMLDOMCached(self::URI . 'news')
+            or returnServerError('could not retrieve page');
 
-    protected function parseItem($feedItem)
-    {
-        $item = parent::parseItem($feedItem);
+        $this->items[] = [];
 
-        //fetch page
-        $articlePage = getSimpleHTMLDOMCached($feedItem->link)
-            or returnServerError('Could not retrieve ' . $feedItem->link);
+        //for each post
+        foreach ($news->find('div.cmg-card') as $post) {
+            $item = [];
 
-        $subtitle = $articlePage->find('p.standfirst', 0);
-        $article = $articlePage->find('div.content_field', 0);
+            $titleElement = $post->find('div.title a.cmg-link')[0];
+            $item['uri'] = self::URI . $titleElement->getAttribute('href');
+            $item['title'] = $titleElement->innertext;
 
-        $item['content'] = str_get_html($subtitle . $article);
+            $articlePage = getSimpleHTMLDOMCached($item['uri'])
+                or returnServerError('could not retrieve page');
 
-        //convert <iframe>s to <a>s. meant for embedded videos.
-        foreach ($item['content']->find('iframe') as $found) {
-            $iframeUrl = $found->getAttribute('src');
+            $item['author'] = $articlePage->find('div.author div')[1]->innertext;
 
-            if ($iframeUrl) {
-                $found->outertext = '<a href="' . $iframeUrl . '">' . $iframeUrl . '</a>';
+            $dinges = $articlePage->find('div.main-body')[0];
+            //remove ads
+            foreach ($dinges->find('aside') as $ad) {
+                $ad->outertext = '';
+                $dinges->save();
             }
-        }
 
-        //remove scripts from the text
-        foreach ($item['content']->find('script') as $remove) {
-            $remove->outertext = '';
-        }
+            $item['content'] = $articlePage->find('div.summary')[0] .
+                $articlePage->find('figure.main-image')[0] .
+                $dinges;
 
-        return $item;
+            //add the item to the list
+            array_push($this->items, $item);
+        }
     }
 }

From 18a8a5127180d9c4a4318f88cf2ffbc441b0ed60 Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Sun, 27 Aug 2023 12:13:44 +0200
Subject: [PATCH 079/716] [GitlabIssueBridge] Add support for GitLab Epics

---
 bridges/GitlabIssueBridge.php | 24 ++++++++++++++++++++----
 1 file changed, 20 insertions(+), 4 deletions(-)

diff --git a/bridges/GitlabIssueBridge.php b/bridges/GitlabIssueBridge.php
index 59797d8d..27c19467 100644
--- a/bridges/GitlabIssueBridge.php
+++ b/bridges/GitlabIssueBridge.php
@@ -3,10 +3,10 @@
 class GitlabIssueBridge extends BridgeAbstract
 {
     const MAINTAINER = 'Mynacol';
-    const NAME = 'Gitlab Issue/Merge Request';
+    const NAME = 'Gitlab Issue/Merge Request/Epic';
     const URI = 'https://gitlab.com/';
     const CACHE_TIMEOUT = 1800; // 30min
-    const DESCRIPTION = 'Returns  comments of an issue/MR of a gitlab project';
+    const DESCRIPTION = 'Returns  comments of an issue/MR/Epic of a gitlab project';
 
     const PARAMETERS = [
         'global' => [
@@ -43,6 +43,14 @@ class GitlabIssueBridge extends BridgeAbstract
                 'exampleValue' => '2099',
                 'required' => true
             ]
+        ],
+        'Epic comments' => [
+            'i' => [
+                'name' => 'Epic number',
+                'type' => 'number',
+                'exampleValue' => '2099',
+                'required' => true
+            ]
         ]
     ];
 
@@ -56,6 +64,9 @@ class GitlabIssueBridge extends BridgeAbstract
             case 'Merge Request comments':
                 $name .= ' MR !' . $this->getInput('i');
                 break;
+            case 'Epic comments':
+                $name .= ' Epic &' . $this->getInput('i');
+                break;
             default:
                 return parent::getName();
         }
@@ -74,6 +85,9 @@ class GitlabIssueBridge extends BridgeAbstract
             case 'Merge Request comments':
                 $uri .= '-/merge_requests';
                 break;
+            case 'Epic comments':
+                $uri .= '-/epics';
+                break;
             default:
                 return $uri;
         }
@@ -107,8 +121,10 @@ class GitlabIssueBridge extends BridgeAbstract
         foreach ($comments as $value) {
             foreach ($value->notes as $comment) {
                 $item = [];
-                $item['uri'] = $comment->noteable_note_url;
-                $item['uid'] = $item['uri'];
+                if ($comment->noteable_note_url !== null) {
+                    $item['uri'] = $comment->noteable_note_url;
+                    $item['uid'] = $item['uri'];
+                }
 
                 // TODO fix invalid timestamps (fdroid bot)
                 $item['timestamp'] = $comment->created_at ?? $comment->updated_at ?? $comment->last_edited_at;

From c3b5b382ba1d64e7613b0c9249be053168c4e1f7 Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Sun, 27 Aug 2023 12:33:17 +0200
Subject: [PATCH 080/716] [ZeitBridge] Remove broken paywall workaround

Clean up spoofing Google Bot as this workaround doesn't work anymore.
---
 bridges/ZeitBridge.php | 2 --
 1 file changed, 2 deletions(-)

diff --git a/bridges/ZeitBridge.php b/bridges/ZeitBridge.php
index a9e4bcf2..b294e9fb 100644
--- a/bridges/ZeitBridge.php
+++ b/bridges/ZeitBridge.php
@@ -66,8 +66,6 @@ class ZeitBridge extends FeedExpander
         $item['enclosures'] = [];
 
         $headers = [
-            'User-Agent: Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)',
-            'X-Forwarded-For: 66.249.66.1',
             'Cookie: zonconsent=' . date('Y-m-d\TH:i:s.v\Z'),
         ];
 

From 999d5dce405165ce0a025259405943f7a9d8753f Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Sun, 27 Aug 2023 12:54:02 +0200
Subject: [PATCH 081/716] [HeiseBridge] Remove archive link for heise+

archive.ph is also not able to provide the full content of paywalled
heise+ articles.
---
 bridges/HeiseBridge.php | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/bridges/HeiseBridge.php b/bridges/HeiseBridge.php
index 08c43dc5..dfda311c 100644
--- a/bridges/HeiseBridge.php
+++ b/bridges/HeiseBridge.php
@@ -137,10 +137,8 @@ class HeiseBridge extends FeedExpander
         if (strpos($item['uri'], 'https://www.heise.de') !== 0) {
             return $item;
         }
-
-        // abort on heise+ articles and link to archive.ph for full-text content
+        // abort on heise+ articles
         if ($sessioncookie == '' && str_starts_with($item['title'], 'heise+ |')) {
-            $item['uri'] = 'https://archive.ph/?run=1&url=' . urlencode($item['uri']);
             return $item;
         }
 

From 14607c07f682a2766777b909e732af653c400fee Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Sun, 27 Aug 2023 13:14:21 +0200
Subject: [PATCH 082/716] [GitlabIssueBridge] Fix example values for MR

These values are used for testing and PR artifacts, but
https://gitlab.com/fdroid/fdroidclient currently has no MR !2099,
leading to a HTTP 404 error. This just uses issue #1 and MR !1.

To support epics, the specified repository is ignored.
---
 bridges/GitlabIssueBridge.php | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/bridges/GitlabIssueBridge.php b/bridges/GitlabIssueBridge.php
index 27c19467..f900335f 100644
--- a/bridges/GitlabIssueBridge.php
+++ b/bridges/GitlabIssueBridge.php
@@ -18,12 +18,12 @@ class GitlabIssueBridge extends BridgeAbstract
             ],
             'u' => [
                 'name' => 'User/Organization name',
-                'exampleValue' => 'fdroid',
+                'exampleValue' => 'gitlab-org',
                 'required' => true
             ],
             'p' => [
                 'name' => 'Project name',
-                'exampleValue' => 'fdroidclient',
+                'exampleValue' => 'gitlab-foss',
                 'required' => true
             ]
 
@@ -32,7 +32,7 @@ class GitlabIssueBridge extends BridgeAbstract
             'i' => [
                 'name' => 'Issue number',
                 'type' => 'number',
-                'exampleValue' => '2099',
+                'exampleValue' => '1',
                 'required' => true
             ]
         ],
@@ -40,7 +40,7 @@ class GitlabIssueBridge extends BridgeAbstract
             'i' => [
                 'name' => 'Merge Request number',
                 'type' => 'number',
-                'exampleValue' => '2099',
+                'exampleValue' => '1',
                 'required' => true
             ]
         ],
@@ -48,7 +48,7 @@ class GitlabIssueBridge extends BridgeAbstract
             'i' => [
                 'name' => 'Epic number',
                 'type' => 'number',
-                'exampleValue' => '2099',
+                'exampleValue' => '1',
                 'required' => true
             ]
         ]
@@ -86,7 +86,7 @@ class GitlabIssueBridge extends BridgeAbstract
                 $uri .= '-/merge_requests';
                 break;
             case 'Epic comments':
-                $uri .= '-/epics';
+                $uri = 'https://' . $host . '/groups/' . $this->getInput('u') . '/-/epics';
                 break;
             default:
                 return $uri;

From 9e33a15b93de43a1f8ef3fc705748c59d8dbeed7 Mon Sep 17 00:00:00 2001
From: mruac <ant8672@gmail.com>
Date: Wed, 30 Aug 2023 00:34:10 +0930
Subject: [PATCH 083/716] [FurAffinityBridge] Fix if search result contains
 hidden submission (#3637)

* Reverts to preview submission if full is hidden

* Reverts to preview submission if full is hidden

* revert

* added fallback to higher res preview if SWF

* amend
---
 bridges/FurAffinityBridge.php | 87 ++++++++++++++++++-----------------
 1 file changed, 44 insertions(+), 43 deletions(-)

diff --git a/bridges/FurAffinityBridge.php b/bridges/FurAffinityBridge.php
index 6c2d7b52..977fbb6b 100644
--- a/bridges/FurAffinityBridge.php
+++ b/bridges/FurAffinityBridge.php
@@ -892,7 +892,7 @@ class FurAffinityBridge extends BridgeAbstract
             $item = [];
 
             $submissionURL = $figure->find('b u a', 0)->href;
-            $imgURL = 'https:' . $figure->find('b u a img', 0)->src;
+            $imgURL = $figure->find('b u a img', 0)->src;
 
             $item['uri'] = $submissionURL;
             $item['title'] = html_entity_decode(
@@ -900,52 +900,43 @@ class FurAffinityBridge extends BridgeAbstract
             );
             $item['author'] = $figure->find('figcaption p a[href*=/user/]', 0)->title;
 
+            $item['content'] = "<a href=\"$submissionURL\"> <img src=\"{$imgURL}\" referrerpolicy=\"no-referrer\"/></a>";
+
             if ($this->getInput('full') === true) {
                 $submissionHTML = $this->getFASimpleHTMLDOM($submissionURL, $cache);
+                if (!$this->isHiddenSubmission($submissionHTML)) {
+                    $stats = $submissionHTML->find('.stats-container', 0);
+                    $popupDate = $stats->find('.popup_date', 0);
+                    if ($popupDate) {
+                        $item['timestamp'] = strtotime($popupDate->title);
+                    }
 
-                $stats = $submissionHTML->find('.stats-container', 0);
-                $popupDate = $stats->find('.popup_date', 0);
-                if ($popupDate) {
-                    $item['timestamp'] = strtotime($popupDate->title);
+                    $var = $submissionHTML->find('.actions a[href^=https://d.facdn]', 0);
+                    if ($var) {
+                        $item['enclosures'] = [$var->href];
+                    }
+
+                    foreach ($stats->find('#keywords a') as $keyword) {
+                        $item['categories'][] = $keyword->plaintext;
+                    }
+
+                    $previewSrc = $submissionHTML->find('#submissionImg', 0);
+                    if ($previewSrc) {
+                        $imgURL = 'https:' . $previewSrc->{'data-preview-src'};
+                    } else {
+                        $imgURL = $submissionHTML->find('[property="og:image"]', 0)->{'content'};
+                    }
+
+                    $description = $submissionHTML->find('div.submission-description', 0);
+                    if ($description) {
+                        $this->setReferrerPolicy($description);
+                        $description = trim($description->innertext);
+                    } else {
+                        $description = '';
+                    }
+
+                    $item['content'] = "<a href=\"$submissionURL\"> <img src=\"{$imgURL}\" referrerpolicy=\"no-referrer\"/></a><p>{$description}</p>";
                 }
-
-                $var = $submissionHTML->find('.actions a[href^=https://d.facdn]', 0);
-                if ($var) {
-                    $item['enclosures'] = [$var->href];
-                }
-
-                foreach ($stats->find('#keywords a') as $keyword) {
-                    $item['categories'][] = $keyword->plaintext;
-                }
-
-                $previewSrc = $submissionHTML->find('#submissionImg', 0)
-                    ->{'data-preview-src'};
-                if ($previewSrc) {
-                    $imgURL = 'https:' . $previewSrc;
-                }
-
-                $description = $submissionHTML->find('div.submission-description', 0);
-                if ($description) {
-                    $this->setReferrerPolicy($description);
-                    $description = trim($description->innertext);
-                } else {
-                    $description = '';
-                }
-
-                $item['content'] = <<<EOD
-<a href="$submissionURL">
-	<img src="{$imgURL}" referrerpolicy="no-referrer" />
-</a>
-<p>
-{$description}
-</p>
-EOD;
-            } else {
-                $item['content'] = <<<EOD
-<a href="$submissionURL">
-	<img src="$imgURL" referrerpolicy="no-referrer" />
-</a>
-EOD;
             }
 
             $this->items[] = $item;
@@ -964,4 +955,14 @@ EOD;
             $img->referrerpolicy = 'no-referrer';
         }
     }
+
+    private function isHiddenSubmission($html)
+    {
+        //Disabled accounts prevents their userpage, gallery, favorites and journals from being viewed.
+        //Submissions can require maturity limit or logged-in account.
+        $system_message = $html->find('.section-body.alignleft', 0);
+        $system_message = $system_message ? $system_message->plaintext : '';
+
+        return str_contains($system_message, 'System Message');
+    }
 }

From f0ec797f4bceb25b396e75499ea13419ba2b0292 Mon Sep 17 00:00:00 2001
From: mruac <ant8672@gmail.com>
Date: Wed, 30 Aug 2023 00:35:37 +0930
Subject: [PATCH 084/716] [FurAffinityBridge] Option for instance host to add
 custom cookie (#3638)

* added custom cookie config

* appease phpunit
---
 bridges/FurAffinityBridge.php | 45 +++++++++++++++++++++++++++++------
 1 file changed, 38 insertions(+), 7 deletions(-)

diff --git a/bridges/FurAffinityBridge.php b/bridges/FurAffinityBridge.php
index 977fbb6b..087c3ded 100644
--- a/bridges/FurAffinityBridge.php
+++ b/bridges/FurAffinityBridge.php
@@ -6,7 +6,18 @@ class FurAffinityBridge extends BridgeAbstract
     const URI = 'https://www.furaffinity.net';
     const CACHE_TIMEOUT = 300; // 5min
     const DESCRIPTION = 'Returns posts from various sections of FurAffinity';
-    const MAINTAINER = 'Roliga';
+    const MAINTAINER = 'Roliga, mruac';
+    const CONFIGURATION = [
+        'aCookie' => [
+            'required' => false,
+            'defaultValue' => 'ca6e4566-9d81-4263-9444-653b142e35f8'
+
+        ],
+        'bCookie' => [
+            'required' => false,
+            'defaultValue' => '4ce65691-b50f-4742-a990-bf28d6de16ee'
+        ]
+    ];
     const PARAMETERS = [
         'Search' => [
             'q' => [
@@ -594,7 +605,7 @@ class FurAffinityBridge extends BridgeAbstract
      * This was aquired by creating a new user on FA then
      * extracting the cookie from the browsers dev console.
      */
-    const FA_AUTH_COOKIE = 'b=4ce65691-b50f-4742-a990-bf28d6de16ee; a=ca6e4566-9d81-4263-9444-653b142e35f8';
+    private $FA_AUTH_COOKIE;
 
     public function detectParameters($url)
     {
@@ -662,7 +673,14 @@ class FurAffinityBridge extends BridgeAbstract
                 . '\'s Folder '
                 . $this->getInput('folder-id');
             default:
-                return parent::getName();
+                $name = parent::getName();
+                if ($this->getOption('aCookie') !== null) {
+                    $username = $this->loadCacheValue('username');
+                    if ($username !== null) {
+                        $name = $username . '\'s ' . parent::getName();
+                    }
+                }
+                return $name;
         }
     }
 
@@ -741,6 +759,7 @@ class FurAffinityBridge extends BridgeAbstract
 
     public function collectData()
     {
+        $this->FA_AUTH_COOKIE = 'b=' . $this->getOption('bCookie') . '; a=' . $this->getOption('aCookie');
         switch ($this->queriedContext) {
             case 'Search':
                 $data = [
@@ -806,19 +825,19 @@ class FurAffinityBridge extends BridgeAbstract
         $header = [
                 'Host: ' . parse_url(self::URI, PHP_URL_HOST),
                 'Content-Type: application/x-www-form-urlencoded',
-                'Cookie: ' . self::FA_AUTH_COOKIE
+                'Cookie: ' . $this->FA_AUTH_COOKIE
             ];
 
         $html = getSimpleHTMLDOM($this->getURI(), $header, $opts);
         $html = defaultLinkTo($html, $this->getURI());
-
+        $this->saveLoggedInUser($html);
         return $html;
     }
 
     private function getFASimpleHTMLDOM($url, $cache = false)
     {
         $header = [
-                'Cookie: ' . self::FA_AUTH_COOKIE
+                'Cookie: ' . $this->FA_AUTH_COOKIE
             ];
 
         if ($cache) {
@@ -826,12 +845,24 @@ class FurAffinityBridge extends BridgeAbstract
         } else {
             $html = getSimpleHTMLDOM($url, $header);
         }
-
+        $this->saveLoggedInUser($html);
         $html = defaultLinkTo($html, $url);
 
         return $html;
     }
 
+    private function saveLoggedInUser($html)
+    {
+        $current_user = $html->find('#my-username', 0);
+        if ($current_user !== null) {
+            preg_match('/^(?:My FA \( |~)(.*?)(?: \)|)$/', trim($current_user->plaintext), $matches);
+            $current_user = $current_user ? $matches[1] : null;
+            if ($current_user !== null) {
+                $this->saveCacheValue('username', $current_user);
+            }
+        }
+    }
+
     private function itemsFromJournalList($html, $limit)
     {
         foreach ($html->find('table[id^=jid:]') as $journal) {

From 52c59caf2f5ed83745a4a0e62dae868eed44279a Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Tue, 29 Aug 2023 17:08:18 +0200
Subject: [PATCH 085/716] [Core] Find Feed : fix CSS for search results (#3643)

There was no margin at the bottom of the search result : in case of two
ore more results, the two blocks had no space between them.
---
 static/style.css | 1 +
 1 file changed, 1 insertion(+)

diff --git a/static/style.css b/static/style.css
index a9d5933a..b835c98d 100644
--- a/static/style.css
+++ b/static/style.css
@@ -462,6 +462,7 @@ button {
   display: flex;
   position: relative;
   text-align: left;
+  margin-bottom: 15px;
 }
 @media (prefers-color-scheme: dark) {
     .search-result {

From 9707586ee8d92b153fd7b969e94ec883bfc2223b Mon Sep 17 00:00:00 2001
From: mruac <ant8672@gmail.com>
Date: Wed, 30 Aug 2023 00:39:05 +0930
Subject: [PATCH 086/716] [PatreonBridge] Extend the presentation of parsed
 posts (#3617)

* extend post presentation

* applied phpcbf

note: phpcs does not like long null coalescing chains

* resolved phpcs
---
 bridges/PatreonBridge.php | 162 +++++++++++++++++++++++++++++++-------
 1 file changed, 135 insertions(+), 27 deletions(-)

diff --git a/bridges/PatreonBridge.php b/bridges/PatreonBridge.php
index 23dbf8ae..3d19cd81 100644
--- a/bridges/PatreonBridge.php
+++ b/bridges/PatreonBridge.php
@@ -34,13 +34,18 @@ class PatreonBridge extends BridgeAbstract
                 'attachments',
                 'user_defined_tags',
                 //'campaign',
-                //'poll.choices',
+                'poll.choices',
                 //'poll.current_user_responses.user',
                 //'poll.current_user_responses.choice',
                 //'poll.current_user_responses.poll',
                 //'access_rules.tier.null',
-                //'images.null',
-                //'audio.null'
+                'images.null',
+                'audio.null',
+                // 'user.null',
+                'attachments.null',
+                'audio_preview.null',
+                'poll.choices.null'
+                // 'poll.current_user_responses.null'
             ]),
             'fields' => [
                 'post' => implode(',', [
@@ -50,7 +55,7 @@ class PatreonBridge extends BridgeAbstract
                     //'current_user_can_delete',
                     //'current_user_can_view',
                     //'current_user_has_liked',
-                    //'embed',
+                    'embed',
                     'image',
                     //'is_paid',
                     //'like_count',
@@ -58,9 +63,9 @@ class PatreonBridge extends BridgeAbstract
                     //'patreon_url',
                     //'patron_count',
                     //'pledge_url',
-                    //'post_file',
-                    //'post_metadata',
-                    //'post_type',
+                    // 'post_file',
+                    // 'post_metadata',
+                    'post_type',
                     'published_at',
                     'teaser_text',
                     //'thumbnail_url',
@@ -68,11 +73,24 @@ class PatreonBridge extends BridgeAbstract
                     //'upgrade_url',
                     'url',
                     //'was_posted_by_campaign_owner'
+                    // 'content_teaser_text',
+                    // 'current_user_can_report',
+                    'thumbnail',
+                    // 'video_preview'
                 ]),
                 'user' => implode(',', [
                     //'image_url',
                     'full_name',
                     //'url'
+                ]),
+                'media' => implode(',', [
+                    'id',
+                    'image_urls',
+                    'download_url',
+                    'metadata',
+                    'file_name',
+                    'mimetype',
+                    'size_bytes'
                 ])
             ],
             'filter' => [
@@ -97,41 +115,129 @@ class PatreonBridge extends BridgeAbstract
                 $posts,
                 'user',
                 $post->relationships->user->data->id
-            );
+            )->attributes;
             $item['author'] = $user->full_name;
 
-            $image = $post->attributes->image ?? null;
-            if ($image) {
-                $logo = sprintf(
-                    '<p><a href="%s"><img src="%s" /></a></p>',
-                    $post->attributes->url,
-                    $image->thumb_url ?? $image->url ?? $this->getURI()
-                );
-                $item['content'] .= $logo;
+            //image, video, audio, link (featured post content)
+            switch ($post->attributes->post_type) {
+                case 'audio_file':
+                    //check if download_url is null before assigning $audio
+                    $id = $post->relationships->audio->data->id ?? null;
+                    if (isset($id)) {
+                        $audio = $this->findInclude($posts, 'media', $id)->attributes ?? null;
+                    }
+                    if (!isset($audio->download_url)) { //if not unlocked
+                        $id = $post->relationships->audio_preview->data->id ?? null;
+                        if (isset($id)) {
+                            $audio = $this->findInclude($posts, 'media', $id)->attributes ?? null;
+                        }
+                    }
+                    $thumbnail = $post->attributes->thumbnail->large ?? $post->attributes->thumbnail->url;
+                    $thumbnail = $thumbnail ?? $post->attributes->image->thumb_url;
+                    $thumbnail = $thumbnail ?? $post->attributes->image->url;
+                    $audio_filename = $audio->file_name ?? $item['title'];
+                    $download_url = $audio->download_url ?? $item['uri'];
+                    $item['content'] .= "<p><a href\"{$download_url}\"><img src=\"{$thumbnail}\"><br/>🎧 {$audio_filename}</a><br/>";
+                    if ($download_url !== $item['uri']) {
+                        $item['enclosures'][] = $download_url;
+                        $item['content'] .= "<audio controls src=\"{$download_url}\"></audio>";
+                    }
+                    $item['content'] .= '</p>';
+                    break;
+
+                case 'video_embed':
+                    $thumbnail = $post->attributes->thumbnail->large ?? $post->attributes->thumbnail->url;
+                    $thumbnail = $thumbnail ?? $post->attributes->image->thumb_url;
+                    $thumbnail = $thumbnail ?? $post->attributes->image->url;
+                    $item['content'] .= "<p><a href=\"{$item['uri']}\">🎬 {$item['title']}<br><img src=\"{$thumbnail}\"></a></p>";
+                    break;
+
+                case 'video_external_file':
+                    $thumbnail = $post->attributes->thumbnail->large ?? $post->attributes->thumbnail->url;
+                    $thumbnail = $thumbnail ?? $post->attributes->image->thumb_url;
+                    $thumbnail = $thumbnail ?? $post->attributes->image->url;
+                    $item['content'] .= "<p><a href=\"{$item['uri']}\">🎬 {$item['title']}<br><img src=\"{$thumbnail}\"></a></p>";
+                    break;
+
+                case 'image_file':
+                    $item['content'] .= '<p>';
+                    foreach ($post->relationships->images->data as $key => $image) {
+                        $image = $this->findInclude($posts, 'media', $image->id)->attributes;
+                        $image_fullres = $image->download_url ?? $image->image_urls->url ?? $image->image_urls->original;
+                        $filename = $image->file_name ?? '';
+                        $image_url = $image->image_urls->url ?? $image->image_urls->original;
+                        $item['enclosures'][] = $image_fullres;
+                        $item['content'] .= "<a href=\"{$image_fullres}\">{$filename}<br/><img src=\"{$image_url}\"></a><br/><br/>";
+                    }
+                    $item['content'] .= '</p>';
+                    break;
+
+                case 'link':
+                    //make it locked safe
+                    if (isset($post->attributes->embed)) {
+                        $embed = $post->attributes->embed;
+                        $thumbnail = $post->attributes->image->large_url ?? $post->attributes->image->thumb_url ?? $post->attributes->image->url;
+                        $item['content'] .= '<p><table>';
+                        $item['content'] .= "<tr><td><a href=\"{$embed->url}\"><img src=\"{$thumbnail}\"></a></td></tr>";
+                        $item['content'] .= "<tr><td><b>{$embed->subject}</b></td></tr>";
+                        $item['content'] .= "<tr><td>{$embed->description}</td></tr>";
+                        $item['content'] .= '</table></p><hr/>';
+                    }
+                    break;
             }
 
+            //content of the post
             if (isset($post->attributes->content)) {
                 $item['content'] .= $post->attributes->content;
             } elseif (isset($post->attributes->teaser_text)) {
                 $item['content'] .= '<p>'
-                    . $post->attributes->teaser_text
-                    . '</p>';
+                    . $post->attributes->teaser_text;
+                if (strlen($post->attributes->teaser_text) === 140) {
+                    $item['content'] .= '…';
+                }
+                $item['content'] .= '</p>';
             }
 
+            //post tags
             if (isset($post->relationships->user_defined_tags)) {
                 $item['categories'] = [];
                 foreach ($post->relationships->user_defined_tags->data as $tag) {
-                    $attrs = $this->findInclude($posts, 'post_tag', $tag->id);
+                    $attrs = $this->findInclude($posts, 'post_tag', $tag->id)->attributes;
                     $item['categories'][] = $attrs->value;
                 }
             }
 
-            if (isset($post->relationships->attachments)) {
-                $item['enclosures'] = [];
-                foreach ($post->relationships->attachments->data as $attachment) {
-                    $attrs = $this->findInclude($posts, 'attachment', $attachment->id);
-                    $item['enclosures'][] = $attrs->url;
+            //poll
+            if (isset($post->relationships->poll->data)) {
+                $poll = $this->findInclude($posts, 'poll', $post->relationships->poll->data->id);
+                $item['content'] .= "<p><table><tr><th><b>Poll: {$poll->attributes->question_text}</b></th></tr>";
+                foreach ($poll->relationships->choices->data as $key => $poll_option) {
+                    $poll_option = $this->findInclude($posts, 'poll_choice', $poll_option->id);
+                    $poll_option_text = $poll_option->attributes->text_content ?? null;
+                    if (isset($poll_option_text)) {
+                        $item['content'] .= "<tr><td><a href=\"{$item['uri']}\">{$poll_option_text}</a></td></tr>";
+                    }
                 }
+                $item['content'] .= '</table></p>';
+            }
+
+
+            //post attachments
+            if (
+                isset($post->relationships->attachments->data) &&
+                sizeof($post->relationships->attachments->data) > 0
+            ) {
+                $item['enclosures'] = [];
+                $item['content'] .= '<hr><p><b>Attachments:</b><ul>';
+                foreach ($post->relationships->attachments->data as $attachment) {
+                    $attrs = $this->findInclude($posts, 'attachment', $attachment->id)->attributes;
+                    $filename = $attrs->name;
+                    $n = strrpos($filename, '.');
+                    $ext = ($n === false) ? '' : substr($filename, $n);
+                    $item['enclosures'][] = $attrs->url . '#' . $ext;
+                    $item['content'] .= '<li><a href="' . $attrs->url . '">' . $filename . '</a></li>';
+                }
+                $item['content'] .= '</ul></p>';
             }
 
             $this->items[] = $item;
@@ -139,14 +245,16 @@ class PatreonBridge extends BridgeAbstract
     }
 
     /*
-     * Searches the "included" array in an API response and returns attributes
-     * for the first match.
+     * Searches the "included" array in an API response and returns the result for the first match.
+     * A result will include attributes containing further details of the included object
+     * (e.g. an audio object), and an optional relationships object that links to more "included"
+     * objects. (e.g. a poll object with related poll_choice(s))
      */
     private function findInclude($data, $type, $id)
     {
         foreach ($data->included as $include) {
             if ($include->type === $type && $include->id === $id) {
-                return $include->attributes;
+                return $include;
             }
         }
     }

From 4d05d0beff361ab6724b9411ef2271af37beb7f5 Mon Sep 17 00:00:00 2001
From: csisoap <33269526+csisoap@users.noreply.github.com>
Date: Tue, 29 Aug 2023 22:14:34 +0700
Subject: [PATCH 087/716] [TwitterBridge] Add support for OAuth authorization.
 (#3628)

* Update TwitterClient.php

- Add OAuth authorization header.
- Add new endpoint.

* Update TwitterBridge.php

- Make some changes to support new endpoint.

* Update TwitterBridge.php

* clean up, fix warning

* fix warning

* fix warning

* remove oauth token

* fix wrong twitter id when encounter reply post.

* Update TwitterClient.php

* fix wrong twitter id cause by previous commit

* clear warning

* attempt to clear warning

* attempt to clear warning
---
 bridges/TwitterBridge.php |  21 ++++-
 lib/TwitterClient.php     | 184 ++++++++++++++++++++++++++------------
 2 files changed, 146 insertions(+), 59 deletions(-)

diff --git a/bridges/TwitterBridge.php b/bridges/TwitterBridge.php
index 1f115be8..a5d09f8a 100644
--- a/bridges/TwitterBridge.php
+++ b/bridges/TwitterBridge.php
@@ -306,15 +306,22 @@ EOD
             }
         }
 
+        // Array of Tweet IDs
+        $tweetIds = [];
         // Filter out unwanted tweets
         foreach ($data->tweets as $tweet) {
+            if (isset($tweet->rest_id)) {
+                $tweetIds[] = $tweet->rest_id;
+                $tweet = $tweet->legacy;
+            }
+
             if (!$tweet) {
                 continue;
             }
             // Filter out retweets to remove possible duplicates of original tweet
             switch ($this->queriedContext) {
                 case 'By keyword or hashtag':
-                    if (isset($tweet->retweeted_status) && substr($tweet->full_text, 0, 4) === 'RT @') {
+                    if ((isset($tweet->retweeted_status) || isset($tweet->retweeted_status_result)) && substr($tweet->full_text, 0, 4) === 'RT @') {
                         continue 2;
                     }
                     break;
@@ -351,9 +358,13 @@ EOD
             $item = [];
 
             $realtweet = $tweet;
+            $tweetId = (isset($tweetIds[$i]) ? $tweetIds[$i] : $realtweet->conversation_id_str);
             if (isset($tweet->retweeted_status)) {
                 // Tweet is a Retweet, so set author based on original tweet and set realtweet for reference to the right content
                 $realtweet = $tweet->retweeted_status;
+            } elseif (isset($tweet->retweeted_status_result)) {
+                $tweetId = $tweet->retweeted_status_result->result->rest_id;
+                $realtweet = $tweet->retweeted_status_result->result->legacy;
             }
 
             if (isset($realtweet->truncated) && $realtweet->truncated) {
@@ -364,6 +375,10 @@ EOD
                 }
             }
 
+            if (!$realtweet) {
+                $realtweet = $tweet;
+            }
+
             switch ($this->queriedContext) {
                 case 'By username':
                     if ($this->getInput('norep') && isset($tweet->in_reply_to_status_id)) {
@@ -372,7 +387,7 @@ EOD
                     $item['username']  = $data->user_info->legacy->screen_name;
                     $item['fullname']  = $data->user_info->legacy->name;
                     $item['avatar']    = $data->user_info->legacy->profile_image_url_https;
-                    $item['id']        = $realtweet->id_str;
+                    $item['id']        = (isset($realtweet->id_str) ? $realtweet->id_str : $tweetId);
                     break;
                 case 'By list':
                 case 'By list ID':
@@ -391,7 +406,7 @@ EOD
 
             $item['timestamp'] = $realtweet->created_at;
             $item['uri']       = self::URI . $item['username'] . '/status/' . $item['id'];
-            $item['author']    = (isset($tweet->retweeted_status) ? 'RT: ' : '')
+            $item['author']    = ((isset($tweet->retweeted_status) || (isset($tweet->retweeted_status_result))) ? 'RT: ' : '')
                          . $item['fullname']
                          . ' (@'
                          . $item['username'] . ')';
diff --git a/lib/TwitterClient.php b/lib/TwitterClient.php
index 0c6b9535..d2a09fdd 100644
--- a/lib/TwitterClient.php
+++ b/lib/TwitterClient.php
@@ -18,6 +18,66 @@ class TwitterClient
 
         $this->data = $this->cache->loadData() ?? [];
         $this->authorization = 'AAAAAAAAAAAAAAAAAAAAAGHtAgAAAAAA%2Bx7ILXNILCqkSGIzy6faIHZ9s3Q%3DQy97w6SIrzE7lQwPJEYQBsArEE2fC25caFwRBvAGi456G09vGR';
+        $this->tw_consumer_key = '3nVuSoBZnx6U4vzUxf5w';
+        $this->tw_consumer_secret = 'Bcs59EFbbsdF6Sl9Ng71smgStWEGwXXKSjYvPVt7qys';
+        $this->oauth_token = ''; //Fill here
+        $this->oauth_token_secret = ''; //Fill here
+    }
+
+    private function getOauthAuthorization(
+        $oauth_token,
+        $oauth_token_secret,
+        $method = 'GET',
+        $url = '',
+        $body = '',
+        $timestamp = null,
+        $oauth_nonce = null
+    ) {
+        if (!$url) {
+            return '';
+        }
+        $method = strtoupper($method);
+        $parseUrl = parse_url($url);
+        $link = $parseUrl['scheme'] . '://' . $parseUrl['host'] . $parseUrl['path'];
+        parse_str($parseUrl['query'], $query_params);
+        if ($body) {
+            parse_str($body, $body_params);
+            $query_params = array_merge($query_params, $body_params);
+        }
+        $payload = [
+            'oauth_version' => '1.0',
+            'oauth_signature_method' => 'HMAC-SHA1',
+            'oauth_consumer_key' => $this->tw_consumer_key,
+            'oauth_token' => $oauth_token,
+            'oauth_nonce' => $oauth_nonce ? $oauth_nonce : implode('', array_fill(0, 3, strval(time()))),
+            'oauth_timestamp' => $timestamp ? $timestamp : time(),
+        ];
+        $payload = array_merge($payload, $query_params);
+        ksort($payload);
+
+        $url_parts = parse_url($url);
+        $url_parts['query'] = http_build_query($payload, '', '&', PHP_QUERY_RFC3986);
+        $base_url = $url_parts['scheme'] . '://' . $url_parts['host'] . $url_parts['path'];
+        $signature_base_string = strtoupper($method) . '&' . rawurlencode($base_url) . '&' . rawurlencode($url_parts['query']);
+        $hmac_key = $this->tw_consumer_secret . '&' . $oauth_token_secret;
+        $hex_signature = hash_hmac('sha1', $signature_base_string, $hmac_key, true);
+        $signature = base64_encode($hex_signature);
+
+        $header_params = [
+            'oauth_version' => '1.0',
+            'oauth_token' => $oauth_token,
+            'oauth_nonce' => $payload['oauth_nonce'],
+            'oauth_timestamp' => $payload['oauth_timestamp'],
+            'oauth_signature' => $signature,
+            'oauth_consumer_key' => $this->tw_consumer_key,
+            'oauth_signature_method' => 'HMAC-SHA1',
+        ];
+        // ksort($header_params);
+        $header_values = [];
+        foreach ($header_params as $key => $value) {
+            $header_values[] = rawurlencode($key) . '="' . (is_int($value) ? $value : rawurlencode($value)) . '"';
+        }
+        return 'OAuth realm="http://api.twitter.com/", ' . implode(', ', $header_values);
     }
 
     private function extractTweetAndUsersFromGraphQL($timeline)
@@ -25,13 +85,24 @@ class TwitterClient
         if (isset($timeline->data->user)) {
             $result = $timeline->data->user->result;
             $instructions = $result->timeline_v2->timeline->instructions;
-        } else {
-            $result = $timeline->data->list->timeline_response;
+        } elseif (isset($timeline->data->user_result)) {
+            $result = $timeline->data->user_result->result->timeline_response;
             $instructions = $result->timeline->instructions;
         }
+
         if (isset($result->__typename) && $result->__typename === 'UserUnavailable') {
             throw new \Exception('UserUnavailable');
         }
+
+        if (isset($timeline->data->list)) {
+            $result = $timeline->data->list->timeline_response;
+            $instructions = $result->timeline->instructions;
+        }
+
+        if (!isset($result) && !isset($instructions)) {
+            throw new \Exception('Unable to fetch user/list timeline');
+        }
+
         $instructionTypes = [
             'TimelineAddEntries',
             'TimelineClearCache',
@@ -78,14 +149,14 @@ class TwitterClient
                 if (!isset($entry->content->itemContent->tweet_results->result->legacy)) {
                     continue;
                 }
-                $tweets[] = $entry->content->itemContent->tweet_results->result->legacy;
+                $tweets[] = $entry->content->itemContent->tweet_results->result;
 
                 $userIds[] = $entry->content->itemContent->tweet_results->result->core->user_results->result;
             } else {
                 if (!isset($entry->content->content->tweetResult->result->legacy)) {
                     continue;
                 }
-                $tweets[] = $entry->content->content->tweetResult->result->legacy;
+                $tweets[] = $entry->content->content->tweetResult->result;
 
                 $userIds[] = $entry->content->content->tweetResult->result->core->user_result->result;
             }
@@ -117,19 +188,22 @@ class TwitterClient
             }
         }
 
-        try {
-            $timeline = $this->fetchTimelineUsingSearch($screenName);
-        } catch (HttpException $e) {
-            if ($e->getCode() === 403) {
-                $this->data['guest_token'] = null;
-                $this->fetchGuestToken();
-                $timeline = $this->fetchTimelineUsingSearch($screenName);
-            } else {
-                throw $e;
-            }
-        }
+        $timeline = $this->fetchTimeline($userInfo->rest_id);
+        // try {
+        //     // $timeline = $this->fetchTimelineUsingSearch($screenName);
+        // } catch (HttpException $e) {
+        //     if ($e->getCode() === 403) {
+        //         $this->data['guest_token'] = null;
+        //         $this->fetchGuestToken();
+        //         // $timeline = $this->fetchTimelineUsingSearch($screenName);
+        //         $timeline = $this->fetchTimeline($userInfo->rest_id);
+        //     } else {
+        //         throw $e;
+        //     }
+        // }
 
-        $tweets = $this->extractTweetFromSearch($timeline);
+        // $tweets = $this->extractTweetFromSearch($timeline);
+        $tweets = $this->extractTweetAndUsersFromGraphQL($timeline)->tweets;
 
         return (object) [
             'user_info' => $userInfo,
@@ -155,7 +229,7 @@ class TwitterClient
                     throw $e;
                 }
             }
-        } elseif ($operation === 'By list ID') {
+        } else if ($operation == 'By list ID') {
             $id = $query['listId'];
         } else {
             throw new \Exception('Unknown operation to make list tweets');
@@ -223,43 +297,40 @@ class TwitterClient
     private function fetchTimeline($userId)
     {
         $variables = [
-            'userId' => $userId,
+            'autoplay_enabled' => true,
             'count' => 40,
-            'includePromotedContent' => true,
-            'withQuickPromoteEligibilityTweetFields' => true,
-            'withSuperFollowsUserFields' => true,
-            'withDownvotePerspective' => false,
-            'withReactionsMetadata' => false,
-            'withReactionsPerspective' => false,
-            'withSuperFollowsTweetFields' => true,
-            'withVoice' => true,
-            'withV2Timeline' => true,
+            'includeEditControl' => true,
+            'includeEditPerspective' => false,
+            'includeHasBirdwatchNotes' => false,
+            'includeTweetImpression' => true,
+            'includeTweetVisibilityNudge' => true,
+            'rest_id' => $userId
         ];
         $features = [
-            'responsive_web_twitter_blue_verified_badge_is_enabled' => true,
-            'responsive_web_graphql_exclude_directive_enabled' => false,
-            'verified_phone_label_enabled' => false,
-            'responsive_web_graphql_timeline_navigation_enabled' => true,
-            'responsive_web_graphql_skip_user_profile_image_extensions_enabled' => false,
+            'android_graphql_skip_api_media_color_palette' => true,
+            'blue_business_profile_image_shape_enabled' => true,
+            'creator_subscriptions_subscription_count_enabled' => true,
+            'creator_subscriptions_tweet_preview_api_enabled' => true,
+            'freedom_of_speech_not_reach_fetch_enabled' => true,
             'longform_notetweets_consumption_enabled' => true,
+            'longform_notetweets_inline_media_enabled' => true,
+            'longform_notetweets_rich_text_read_enabled' => true,
+            'subscriptions_verification_info_enabled' => true,
+            'super_follow_badge_privacy_enabled' => true,
+            'super_follow_exclusive_tweet_notifications_enabled' => true,
+            'super_follow_tweet_api_enabled' => true,
+            'super_follow_user_api_enabled' => true,
+            'tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled' => true,
             'tweetypie_unmention_optimization_enabled' => true,
-            'vibe_api_enabled' => true,
-            'responsive_web_edit_tweet_api_enabled' => true,
-            'graphql_is_translatable_rweb_tweet_is_translatable_enabled' => true,
-            'view_counts_everywhere_api_enabled' => true,
-            'freedom_of_speech_not_reach_appeal_label_enabled' => false,
-            'standardized_nudges_misinfo' => true,
-            'tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled' => false,
-            'interactive_text_enabled' => true,
-            'responsive_web_text_conversations_enabled' => false,
-            'responsive_web_enhance_cards_enabled' => false,
+            'unified_cards_ad_metadata_container_dynamic_card_content_query_enabled' => true,
         ];
         $url = sprintf(
-            'https://twitter.com/i/api/graphql/WZT7sCTrLvSOaWOXLDsWbQ/UserTweets?variables=%s&features=%s',
+            'https://api.twitter.com/graphql/3JNH4e9dq1BifLxAa3UMWg/UserWithProfileTweetsQueryV2?variables=%s&features=%s',
             urlencode(json_encode($variables)),
             urlencode(json_encode($features))
         );
-        $response = Json::decode(getContents($url, $this->createHttpHeaders()), false);
+        $oauth = $this->getOauthAuthorization($this->oauth_token, $this->oauth_token_secret, 'GET', $url);
+        $response = Json::decode(getContents($url, $this->createHttpHeaders($oauth)), false);
         return $response;
     }
 
@@ -280,7 +351,8 @@ class TwitterClient
              'https://api.twitter.com/1.1/search/tweets.json?%s',
              http_build_query($queryParam)
          );
-        $response = Json::decode(getContents($url, $this->createHttpHeaders()), false);
+        $oauth = $this->getOauthAuthorization($this->oauth_token, $this->oauth_token_secret, 'GET', $url);
+        $response = Json::decode(getContents($url, $this->createHttpHeaders($oauth)), false);
         return $response;
     }
 
@@ -348,11 +420,6 @@ class TwitterClient
             // Grab the first error message
             throw new \Exception(sprintf('From twitter api: "%s"', $response->errors[0]->message));
         }
-        if (!isset($response->data->user_by_screen_name->list)) {
-            throw new \Exception(
-                sprintf('Unable to find list in twitter response for %s, %s', $screenName, $listSlug)
-            );
-        }
         $listInfo = $response->data->user_by_screen_name->list;
         $this->data[$screenName . '-' . $listSlug] = $listInfo;
 
@@ -412,23 +479,28 @@ class TwitterClient
         ];
 
         $url = sprintf(
-            'https://twitter.com/i/api/graphql/BbGLL1ZfMibdFNWlk7a0Pw/ListTimeline?variables=%s&features=%s',
+            'https://api.twitter.com/graphql/BbGLL1ZfMibdFNWlk7a0Pw/ListTimeline?variables=%s&features=%s',
             urlencode(json_encode($variables)),
             urlencode(json_encode($features))
         );
-        $response = Json::decode(getContents($url, $this->createHttpHeaders()), false);
+        $oauth = $this->getOauthAuthorization($this->oauth_token, $this->oauth_token_secret, 'GET', $url);
+        $response = Json::decode(getContents($url, $this->createHttpHeaders($oauth)), false);
         return $response;
     }
 
-    private function createHttpHeaders(): array
+    private function createHttpHeaders($oauth = null): array
     {
         $headers = [
             'authorization' => sprintf('Bearer %s', $this->authorization),
             'x-guest-token' => $this->data['guest_token'] ?? null,
         ];
-        foreach ($headers as $key => $value) {
-            $headers[] = sprintf('%s: %s', $key, $value);
+        if (isset($oauth)) {
+            $headers['authorization'] = $oauth;
+            unset($headers['x-guest-token']);
         }
-        return $headers;
+        foreach ($headers as $key => $value) {
+            $headers2[] = sprintf('%s: %s', $key, $value);
+        }
+        return $headers2;
     }
 }

From 64000a25264a579230b1dfba377bad368090fb57 Mon Sep 17 00:00:00 2001
From: R3dError <50834839+R3dError@users.noreply.github.com>
Date: Wed, 30 Aug 2023 19:01:55 +0200
Subject: [PATCH 088/716] [NACSouthGermanyMediaLibraryBridge] Add new bridge
 (#3636)

* Init nac south bridge

* Rename bridge

* Refactoring

* Refactor

* Fix formatting

* Fix testing errors

* Change constants

* Update logo

* Remove author omission in descriptions

* Fix comment

* Add maintainer

* Rename bridge

* Add technical note to bridge description
---
 bridges/NACSouthGermanyMediaLibraryBridge.php | 123 ++++++++++++++++++
 1 file changed, 123 insertions(+)
 create mode 100644 bridges/NACSouthGermanyMediaLibraryBridge.php

diff --git a/bridges/NACSouthGermanyMediaLibraryBridge.php b/bridges/NACSouthGermanyMediaLibraryBridge.php
new file mode 100644
index 00000000..fff6c554
--- /dev/null
+++ b/bridges/NACSouthGermanyMediaLibraryBridge.php
@@ -0,0 +1,123 @@
+<?php
+
+class NACSouthGermanyMediaLibraryBridge extends BridgeAbstract
+{
+    private const BASE_URI = 'https://www.nak-sued.de';
+
+    const NAME = 'NAK Süd Mediathek';
+    const DESCRIPTION = 'RSS Feed für die Runkfunkbeiträge der NAK Süd auf Bayern 2 und SWR 1.
+         (Technical note: This bridge might not work on certain server instances because of blacklisted IP ranges to the website.)';
+    const URI = self::BASE_URI . '/mediathek';
+    const MAINTAINER = 'R3dError';
+    const CACHE_TIMEOUT = 7200;
+
+    private const BAYERN2_ROOT_URI = self::BASE_URI . '/mediathek/rundfunksendungen-auf-bayern-2/aktuelle-sendungen';
+    private const SWR1_ROOT_URI = self::BASE_URI . '/mediathek/rundfunksendungen-auf-swr1/aktuelle-sendungen';
+
+    private const MONTHS = [
+        'Januar' => 1,
+        'Februar' => 2,
+        'März' => 3,
+        'April' => 4,
+        'Mai' => 5,
+        'Juni' => 6,
+        'Juli' => 7,
+        'August' => 8,
+        'September' => 9,
+        'Oktober' => 10,
+        'November' => 11,
+        'Dezember' => 12,
+    ];
+
+    public function getIcon()
+    {
+        return 'https://www.nak-stuttgart.de/static/themes/nak_sued/images/nak-logo.png';
+    }
+
+    private static function parseTimestamp($title)
+    {
+        if (preg_match('/([0-9]+)\.\s*([^\s]+)\s*([0-9]+)/', $title, $matches)) {
+            $day = $matches[1];
+            $month = self::MONTHS[$matches[2]];
+            $year = $matches[3];
+            return $year . '-' . $month . '-' . $day;
+        } else {
+            return '';
+        }
+    }
+
+    private static function collectDataForSWR1($parent, $item)
+    {
+        # Find link
+        $sourceURI = $parent->find('a', 1)->href;
+        $item['enclosures'] = [self::BASE_URI . $sourceURI];
+
+        # Add time to timestamp
+        $item['timestamp'] .= ' 07:27';
+
+        # Find author
+        if (preg_match('/\((.*?)\)/', html_entity_decode($item['content']), $matches)) {
+            $item['author'] = $matches[1];
+        }
+
+        return $item;
+    }
+
+    private static function collectDataForBayern2($parent, $item)
+    {
+        # Find link
+        $playerDom = getSimpleHTMLDOMCached(self::BASE_URI . $parent->find('a', 0)->href);
+        $sourceURI = $playerDom->find('source', 0)->src;
+        $item['enclosures'] = [self::BASE_URI . $sourceURI];
+
+        # Add time to timestamp
+        $item['timestamp'] .= ' 06:45';
+
+        return $item;
+    }
+
+    private function collectDataInList($pageURI, $customizeItemCall)
+    {
+        $page = getSimpleHTMLDOM(self::BASE_URI . $pageURI);
+
+        foreach ($page->find('div.grids') as $parent) {
+            # Find title
+            $title = $parent->find('h2', 0)->plaintext;
+
+            # Find content
+            $contentBlock = $parent->find('ul.contentlist', 0);
+            $content = '';
+            foreach ($contentBlock->find('li') as $li) {
+                $content .= '<p>' . $li->plaintext . '</p>';
+            }
+
+            $item = [
+                'title' => $title,
+                'content' => $content,
+                'timestamp' => self::parseTimestamp($title),
+            ];
+            $this->items[] = $customizeItemCall($parent, $item);
+        }
+    }
+
+    private function collectDataFromAllPages($rootURI, $customizeItemCall)
+    {
+        $rootPage = getSimpleHTMLDOM($rootURI);
+        $pages = $rootPage->find('div#tabmenu', 0);
+        foreach ($pages->find('a') as $page) {
+            self::collectDataInList($page->href, [$this, $customizeItemCall]);
+        }
+    }
+
+    public function collectData()
+    {
+        # Collect items
+        self::collectDataFromAllPages(self::BAYERN2_ROOT_URI, 'collectDataForBayern2');
+        self::collectDataFromAllPages(self::SWR1_ROOT_URI, 'collectDataForSWR1');
+
+        # Sort items by decreasing timestamp
+        usort($this->items, function ($a, $b) {
+            return strtotime($b['timestamp']) <=> strtotime($a['timestamp']);
+        });
+    }
+}

From 92b2bc5e119fa6a405017da9381b00500f65acbe Mon Sep 17 00:00:00 2001
From: Niehztog <Niehztog@users.noreply.github.com>
Date: Sun, 3 Sep 2023 00:22:48 +0200
Subject: [PATCH 089/716] fixes extracting article images, article date/time
 and article author and item id (#3645)

---
 bridges/NiusBridge.php | 24 ++++++++++++++++++------
 1 file changed, 18 insertions(+), 6 deletions(-)

diff --git a/bridges/NiusBridge.php b/bridges/NiusBridge.php
index e5773a7d..05d0dacc 100644
--- a/bridges/NiusBridge.php
+++ b/bridges/NiusBridge.php
@@ -6,7 +6,7 @@ class NiusBridge extends XPathAbstract
     const URI = 'https://www.nius.de/news';
     const DESCRIPTION = 'Die Stimme der Mehrheit';
     const MAINTAINER = 'Niehztog';
-    //const PARAMETERS = array();
+
     const CACHE_TIMEOUT = 3600;
 
     const FEED_SOURCE_URL = 'https://www.nius.de/news';
@@ -15,18 +15,30 @@ class NiusBridge extends XPathAbstract
     const XPATH_EXPRESSION_ITEM_CONTENT = './/h2[@class="title"]//node()';
     const XPATH_EXPRESSION_ITEM_URI = './/a[1]/@href';
 
-    const XPATH_EXPR_AUTHOR_PART1 = 'normalize-space(.//span[@class="author"]/text()[1])';
-    const XPATH_EXPR_AUTHOR_PART2 = 'normalize-space(.//span[@class="author"]/text()[2])';
-    const XPATH_EXPRESSION_ITEM_AUTHOR = 'substring-after(concat(' . self::XPATH_EXPR_AUTHOR_PART1 . ', " ", ' . self::XPATH_EXPR_AUTHOR_PART2 . '), " ")';
+    const XPATH_EXPRESSION_ITEM_AUTHOR = 'normalize-space(.//span[@class="author"]/text()[3])';
 
-    //const XPATH_EXPRESSION_ITEM_TIMESTAMP = './/td[3]';
-    const XPATH_EXPRESSION_ITEM_ENCLOSURES = './/img[1]/@src';
+    const XPATH_EXPRESSION_ITEM_TIMESTAMP = 'normalize-space(.//span[@class="author"]/text()[1])';
+    const XPATH_EXPRESSION_ITEM_ENCLOSURES = './/img[@sizes]/@src';
     const XPATH_EXPRESSION_ITEM_CATEGORIES = './/div[@class="subtitle"]/text()';
     const SETTING_FIX_ENCODING = false;
 
+    protected function formatItemTimestamp($value)
+    {
+        return DateTimeImmutable::createFromFormat(
+            false !== strpos($value, ' Uhr') ? 'H:i \U\h\r' : 'd.m.y',
+            $value,
+            new DateTimeZone('Europe/Berlin')
+        )->format('U');
+    }
+
     protected function cleanMediaUrl($mediaUrl)
     {
         $result = preg_match('~https:\/\/www\.nius\.de\/_next\/image\?url=(.*)\?~', $mediaUrl, $matches);
         return $result ? $matches[1] : $mediaUrl;
     }
+
+    protected function generateItemId(FeedItem $item)
+    {
+        return substr($item->getURI(), strrpos($item->getURI(), '/') + 1);
+    }
 }

From b9fdd20f8f13514ad35102a6f49e382538563bd5 Mon Sep 17 00:00:00 2001
From: mruac <ant8672@gmail.com>
Date: Sun, 3 Sep 2023 07:53:36 +0930
Subject: [PATCH 090/716] [FurAffinityBridge] added doc for #3638 (#3646)

* added custom cookie config

* appease phpunit

* added docs
---
 docs/10_Bridge_Specific/FurAffinityBridge.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 docs/10_Bridge_Specific/FurAffinityBridge.md

diff --git a/docs/10_Bridge_Specific/FurAffinityBridge.md b/docs/10_Bridge_Specific/FurAffinityBridge.md
new file mode 100644
index 00000000..369f41cd
--- /dev/null
+++ b/docs/10_Bridge_Specific/FurAffinityBridge.md
@@ -0,0 +1,13 @@
+FurAffinityBridge
+===============
+By default this bridge will only return submissions that are rated "General" and are public.
+
+To unlock the ability to load submissions that require an account to view or are rated "Mature" and higher, you must set the following in `config.ini.php` with cookies from an existing FurAffinity account with the desired maturity ratings enabled in [Account Settings](https://www.furaffinity.net/controls/settings/).
+
+```
+[FurAffinityBridge]
+aCookie = "your-a-cookie-value-here" ; from cookie "a"
+bCookie = "your-b-cookie-value-here" ; from cookie "b"
+```
+
+To confirm the bridge is authenticated, the name of the authenticating account will be shown in the bridge's name once the bridge has been used at least once. (Example: `user's FurAffinity Bridge`)

From 99b86c0e1c8972a6529cd470967e2258702238a8 Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Mon, 4 Sep 2023 03:00:08 +0200
Subject: [PATCH 091/716] [GithubSearchBridge] repair bridge / handle new
 search ui (#3647)

---
 bridges/GithubSearchBridge.php | 90 ++++++++++++++++++++--------------
 1 file changed, 52 insertions(+), 38 deletions(-)

diff --git a/bridges/GithubSearchBridge.php b/bridges/GithubSearchBridge.php
index f477710f..0402a7c7 100644
--- a/bridges/GithubSearchBridge.php
+++ b/bridges/GithubSearchBridge.php
@@ -2,9 +2,10 @@
 
 class GithubSearchBridge extends BridgeAbstract
 {
-    const MAINTAINER = 'corenting';
+    const MAINTAINER = 'corenting, User123698745';
     const NAME = 'Github Repositories Search';
-    const URI = 'https://github.com/';
+    const BASE_URI = 'https://github.com';
+    const URI = self::BASE_URI . '/search';
     const CACHE_TIMEOUT = 600; // 10min
     const DESCRIPTION = 'Returns a specified repositories search (sorted by recently updated)';
     const PARAMETERS = [ [
@@ -18,60 +19,73 @@ class GithubSearchBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $params = ['utf8' => '✓',
-                                        'q' => urlencode($this->getInput('s')),
-                                        's' => 'updated',
-                                        'o' => 'desc',
-                                        'type' => 'Repositories'];
-        $url = self::URI . 'search?' . http_build_query($params);
+        $html = getSimpleHTMLDOM(self::getURI());
 
-        $html = getSimpleHTMLDOM($url);
+        $resultElement = $html->find('[data-testid="results-list"]', 0);
+
+        foreach ($resultElement->children as $element) {
+            $titleElement = $element->find('.search-title', 0);
+            $descriptionElement = $element->find('div > .search-match', 0);
+            $topicElements = $element->find('a[href^="/topic"]');
+            $languageElement = $element->find('li [aria-label$="language"]', 0);
+            $dateElement = $element->find('li [title*=" "]', 0);
 
-        foreach ($html->find('li.repo-list-item') as $element) {
             $item = [];
+            $item['uri'] = self::BASE_URI . $titleElement->find('a', 0)->href;
+            $item['title'] = trim($titleElement->plaintext);
+            $item['timestamp'] = strtotime($dateElement->attr['title']);
 
-            $uri = $element->find('.f4 a', 0)->href;
-            $uri = substr(self::URI, 0, -1) . $uri;
-            $item['uri'] = $uri;
-
-            $title = $element->find('.f4', 0)->plaintext;
-            $item['title'] = $title;
+            $categories = [];
 
             // Description
-            if (count($element->find('p.mb-1')) != 0) {
-                $content = $element->find('p.mb-1', 0)->innertext;
+            $content = '<p>';
+            if (isset($descriptionElement)) {
+                $content .= trim($descriptionElement->plaintext);
             } else {
-                $content = 'No description';
+                $content .= 'No description';
             }
+            $content .= '</p>';
 
-            // Tags
-            $content = $content . '<br />';
-            $tags = $element->find('a.topic-tag');
-            $tags_array = [];
-            if (count($tags) != 0) {
-                $content = $content . 'Tags: ';
-                foreach ($tags as $tag_element) {
-                    $tag_link = 'https://github.com' . $tag_element->href;
-                    $tag_name = trim($tag_element->innertext);
-                    $content = $content . '<a href="' . $tag_link . '">' . $tag_name . '</a> ';
-                    array_push($tags_array, $tag_element->innertext);
+            // Topics
+            if (count($topicElements) > 0) {
+                $content .= '<p>';
+                $content .= 'Topics: ';
+                foreach ($topicElements as $topicElement) {
+                    $topicLink = self::BASE_URI . $topicElement->href;
+                    $topicTitle = trim($topicElement->plaintext);
+                    $content .= '<a href="' . $topicLink . '">' . $topicTitle . '</a> ';
+                    $categories[] = $topicTitle;
                 }
+                $content .= '</p>';
             }
 
             // Programming language
-            if (count($element->find('span[itemprop=programmingLanguage]')) != 0) {
-                $language = $element->find('span[itemprop=programmingLanguage]', 0)->innertext;
-
-                $content = $content . '<br />';
-                $content = $content . 'Language: ' . $language;
+            if (isset($languageElement)) {
+                $content .= '<p>';
+                $content .= 'Language: ';
+                $content .= trim($languageElement->plaintext);
+                $content .= '</p>';
             }
 
-            $item['categories'] = $tags_array;
             $item['content'] = $content;
-            $date = $element->find('relative-time', 0)->datetime;
-            $item['timestamp'] = strtotime($date);
+            $item['categories'] = $categories;
 
             $this->items[] = $item;
         }
     }
+
+    public function getURI()
+    {
+        $searchValue = $this->getInput('s');
+        if (isset($searchValue)) {
+            $params = [
+                'q' => $searchValue,
+                'type' => 'repositories',
+                's' => 'updated',
+                'o' => 'desc',
+            ];
+            return self::URI . '?' . http_build_query($params);
+        }
+        return self::URI;
+    }
 }

From 752098e0fa0988ab7f608832161c0f986bd80eb8 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Tue, 5 Sep 2023 02:12:20 +0200
Subject: [PATCH 092/716] [Core] Fix Find Feed URL encoding (#3650)

The URL entered by the user was not URL encoded for the find feed
feature : this had lead to wrong content sent back to he server
---
 static/rss-bridge.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/static/rss-bridge.js b/static/rss-bridge.js
index 82069d8c..9b6cce5d 100644
--- a/static/rss-bridge.js
+++ b/static/rss-bridge.js
@@ -56,7 +56,7 @@ var rssbridge_feed_finder = (function() {
     // Start the Feed search
     async function rssbridge_feed_search(event) {
         const input = document.getElementById('searchfield');
-        let content = input.value;
+        let content = encodeURI(input.value);
         if (content) {
             const findfeedresults = document.getElementById('findfeedresults');
             findfeedresults.innerHTML = 'Searching for matching feeds ...';

From 38b957398aec532f640550cddc9dd748133c3f27 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Tue, 5 Sep 2023 02:12:47 +0200
Subject: [PATCH 093/716] [AutoJMBridge] Fix content extraction (#3649)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* [AutoJMBridge] Fix content extraction

- Website changed, bridge was updated accordingly
- Added the function detectParameters
- Added the test array for the detectParameters function

* [AutoJMBridge] Fix test

Fix content of the TEST_DETECT_PARAMETERS array

* [AutoJMBridge] Update exaù^me value parameter

Example value was not valid anymore, so it was updated
---
 bridges/AutoJMBridge.php | 41 ++++++++++++++++++++++++++++++++++++----
 1 file changed, 37 insertions(+), 4 deletions(-)

diff --git a/bridges/AutoJMBridge.php b/bridges/AutoJMBridge.php
index c9aaa660..98a86fcc 100644
--- a/bridges/AutoJMBridge.php
+++ b/bridges/AutoJMBridge.php
@@ -13,12 +13,20 @@ class AutoJMBridge extends BridgeAbstract
                 'type' => 'text',
                 'required' => true,
                 'title' => 'URL d\'une recherche avec filtre de véhicules sans le http://www.autojm.fr/',
-                'exampleValue' => 'recherche?brands[]=peugeot&ranges[]=peugeot-nouvelle-308-2021-5p'
+                'exampleValue' => 'recherche?brands[]=PEUGEOT&ranges[]=PEUGEOT 308'
             ],
         ]
     ];
+
     const CACHE_TIMEOUT = 3600;
 
+    const TEST_DETECT_PARAMETERS = [
+        'https://www.autojm.fr/recherche?brands%5B%5D=PEUGEOT&ranges%5B%5D=PEUGEOT%20308'
+            => ['url' => 'recherche?brands%5B%5D=PEUGEOT&ranges%5B%5D=PEUGEOT%20308',
+                'context' => 'Afficher les offres de véhicules disponible sur la recheche AutoJM'
+            ]
+    ];
+
     public function getIcon()
     {
         return self::URI . 'favicon.ico';
@@ -35,6 +43,17 @@ class AutoJMBridge extends BridgeAbstract
         }
     }
 
+    public function getURI()
+    {
+        switch ($this->queriedContext) {
+            case 'Afficher les offres de véhicules disponible sur la recheche AutoJM':
+                return self::URI . $this->getInput('url');
+            break;
+            default:
+                return self::URI;
+        }
+    }
+
     public function collectData()
     {
         // Get the number of result for this search
@@ -52,7 +71,7 @@ class AutoJMBridge extends BridgeAbstract
         $data = json_decode($json);
 
         $nb_results = $data->nbResults;
-        $total_pages = ceil($nb_results / 15);
+        $total_pages = ceil($nb_results / 14);
 
         // Limit the number of page to analyse to 10
         for ($page = 1; $page <= $total_pages && $page <= 10; $page++) {
@@ -66,8 +85,8 @@ class AutoJMBridge extends BridgeAbstract
                 $image = $car->find('div[class=card-car__header__img]', 0)->find('img', 0)->src;
                 // Decode HTML attribute JSON data
                 $car_data = json_decode(html_entity_decode($car->{'data-layer'}));
-                $car_model = $car->{'data-title'} . ' ' . $car->{'data-suptitle'};
-                $availability = $car->find('div[class=card-car__modalites]', 0)->find('div[class=col]', 0)->plaintext;
+                $car_model = $car_data->title;
+                $availability = $car->find('div[class*=card-car__modalites]', 0)->find('div[class=col]', 0)->plaintext;
                 $warranty = $car->find('div[data-type=WarrantyCard]', 0)->plaintext;
                 $discount_html = $car->find('div[class=subtext vehicle_reference_element]', 0);
                 // Check if there is any discount info displayed
@@ -132,4 +151,18 @@ class AutoJMBridge extends BridgeAbstract
 
         return $html;
     }
+
+    public function detectParameters($url)
+    {
+        $params = [];
+        $regex = '/^(https?:\/\/)?(www\.|)autojm.fr\/(recherche\?.*|recherche\/[0-9]{1,10}\?.*)$/m';
+        if (preg_match($regex, $url, $matches) > 0) {
+            $url = preg_replace('#(recherche|recherche/[0-9]{1,10})#', 'recherche', $matches[3]);
+
+            $params['url'] = $url;
+            $params['context'] = 'Afficher les offres de véhicules disponible sur la recheche AutoJM';
+
+            return $params;
+        }
+    }
 }

From 52b90e0873e56e55b39c4379748f54d55e46248e Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Wed, 6 Sep 2023 03:46:47 +0200
Subject: [PATCH 094/716] [Core] Fix Find Feed URL encoding (Really this time)
 (#3651)

- the URL was only partially encoded because encodeURI() was used
  instead of encodeURIComponent()
Now the whole URL is urlencoded, and the whole URL is passed as is in
the GET parameter 'url'
---
 static/rss-bridge.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/static/rss-bridge.js b/static/rss-bridge.js
index 9b6cce5d..2c45294c 100644
--- a/static/rss-bridge.js
+++ b/static/rss-bridge.js
@@ -56,7 +56,7 @@ var rssbridge_feed_finder = (function() {
     // Start the Feed search
     async function rssbridge_feed_search(event) {
         const input = document.getElementById('searchfield');
-        let content = encodeURI(input.value);
+        let content = encodeURIComponent(input.value);
         if (content) {
             const findfeedresults = document.getElementById('findfeedresults');
             findfeedresults.innerHTML = 'Searching for matching feeds ...';

From dbe37cc302bec84f622fbd65aa88690b0d946521 Mon Sep 17 00:00:00 2001
From: csisoap <33269526+csisoap@users.noreply.github.com>
Date: Wed, 6 Sep 2023 21:14:11 +0700
Subject: [PATCH 095/716] [TwitterBridge] Filter out any promoted tweet (#3652)

* Filter out any advertise tweet

* Make some filter work, fix bug that may happen with tweet id list.

* clear phpcs warning, ignore line length warning
---
 bridges/TwitterBridge.php | 84 ++++++++++++++++++++++-----------------
 lib/TwitterClient.php     | 13 +++++-
 2 files changed, 60 insertions(+), 37 deletions(-)

diff --git a/bridges/TwitterBridge.php b/bridges/TwitterBridge.php
index a5d09f8a..8470dcf7 100644
--- a/bridges/TwitterBridge.php
+++ b/bridges/TwitterBridge.php
@@ -217,7 +217,7 @@ EOD
     private function getFullText($id)
     {
         $url = sprintf(
-            'https://cdn.syndication.twimg.com/tweet-result?id=%s&lang=en',
+            'https://cdn.syndication.twimg.com/tweet-result?id=%s&lang=en&token=449yf2pc4g',
             $id
         );
 
@@ -306,55 +306,67 @@ EOD
             }
         }
 
-        // Array of Tweet IDs
-        $tweetIds = [];
-        // Filter out unwanted tweets
-        foreach ($data->tweets as $tweet) {
-            if (isset($tweet->rest_id)) {
-                $tweetIds[] = $tweet->rest_id;
-                $tweet = $tweet->legacy;
-            }
-
-            if (!$tweet) {
-                continue;
-            }
-            // Filter out retweets to remove possible duplicates of original tweet
-            switch ($this->queriedContext) {
-                case 'By keyword or hashtag':
-                    if ((isset($tweet->retweeted_status) || isset($tweet->retweeted_status_result)) && substr($tweet->full_text, 0, 4) === 'RT @') {
-                        continue 2;
-                    }
-                    break;
-            }
-            $tweets[] = $tweet;
-        }
-
         $hidePictures = $this->getInput('nopic');
 
         $hidePinned = $this->getInput('nopinned');
         if ($hidePinned) {
             $pinnedTweetId = null;
-            if ($user && $user->pinned_tweet_ids_str) {
-                $pinnedTweetId = $user->pinned_tweet_ids_str;
+            if ($data->user_info && $data->user_info->legacy->pinned_tweet_ids_str) {
+                $pinnedTweetId = $data->user_info->legacy->pinned_tweet_ids_str[0];
             }
         }
 
+        // Array of Tweet IDs
+        $tweetIds = [];
+        // Filter out unwanted tweets
+        foreach ($data->tweets as $tweet) {
+            if (!$tweet) {
+                continue;
+            }
+
+            if (isset($tweet->legacy)) {
+                $legacy_info = $tweet->legacy;
+            } else {
+                $legacy_info = $tweet;
+            }
+
+            // Filter out retweets to remove possible duplicates of original tweet
+            switch ($this->queriedContext) {
+                case 'By keyword or hashtag':
+		    // phpcs:ignore
+                    if ((isset($legacy_info->retweeted_status) || isset($legacy_info->retweeted_status_result)) && substr($legacy_info->full_text, 0, 4) === 'RT @') {
+                        continue 2;
+                    }
+                    break;
+            }
+
+            // Skip own Retweets...
+            if (isset($legacy_info->retweeted_status) && $legacy_info->retweeted_status->user->id_str === $tweet->user->id_str) {
+                continue;
+            // phpcs:ignore
+            } elseif (isset($legacy_info->retweeted_status_result) && $tweet->retweeted_status_result->result->legacy->user_id_str === $legacy_info->user_id_str) {
+                continue;
+            }
+
+            $tweetId = (isset($legacy_info->id_str) ? $legacy_info->id_str : $tweet->rest_id);
+            // Skip pinned tweet
+            if ($hidePinned && ($tweetId === $pinnedTweetId)) {
+                continue;
+            }
+
+            if (isset($tweet->rest_id)) {
+                $tweetIds[] = $tweetId;
+            }
+            $rtweet = $legacy_info;
+            $tweets[] = $rtweet;
+        }
+
         if ($this->queriedContext === 'By username') {
             $this->feedIconUrl = $data->user_info->legacy->profile_image_url_https ?? null;
         }
 
         $i = 0;
         foreach ($tweets as $tweet) {
-            // Skip own Retweets...
-            if (isset($tweet->retweeted_status) && $tweet->retweeted_status->user->id_str === $tweet->user->id_str) {
-                continue;
-            }
-
-            // Skip pinned tweet
-            if ($hidePinned && $tweet->id_str === $pinnedTweetId) {
-                continue;
-            }
-
             $item = [];
 
             $realtweet = $tweet;
diff --git a/lib/TwitterClient.php b/lib/TwitterClient.php
index d2a09fdd..20f21482 100644
--- a/lib/TwitterClient.php
+++ b/lib/TwitterClient.php
@@ -146,9 +146,14 @@ class TwitterClient
             }
 
             if (isset($timeline->data->user)) {
-                if (!isset($entry->content->itemContent->tweet_results->result->legacy)) {
+                if (!isset($entry->content->itemContent->tweet_results->result)) {
                     continue;
                 }
+
+                if (isset($entry->content->itemContent->promotedMetadata)) {
+                    continue;
+                }
+
                 $tweets[] = $entry->content->itemContent->tweet_results->result;
 
                 $userIds[] = $entry->content->itemContent->tweet_results->result->core->user_results->result;
@@ -156,6 +161,12 @@ class TwitterClient
                 if (!isset($entry->content->content->tweetResult->result->legacy)) {
                     continue;
                 }
+
+                // Filter out any advertise tweet
+                if (isset($entry->content->content->tweetPromotedMetadata)) {
+                    continue;
+                }
+
                 $tweets[] = $entry->content->content->tweetResult->result;
 
                 $userIds[] = $entry->content->content->tweetResult->result->core->user_result->result;

From b3a784244808041a264c3bd548d2bdca9a143275 Mon Sep 17 00:00:00 2001
From: mruac <ant8672@gmail.com>
Date: Wed, 6 Sep 2023 23:46:25 +0930
Subject: [PATCH 096/716] [PixivBridge] Add cookie auth and options (#3653)

* added cookie mgmt and support for issue
https://github.com/RSS-Bridge/rss-bridge/issues/2759

* added image proxy option

* + mature and ai options, + cookie doc

* mention doc

* check cookie is auth'd
---
 bridges/PixivBridge.php                | 201 ++++++++++++++++++++++---
 docs/10_Bridge_Specific/PixivBridge.md |  23 +++
 2 files changed, 205 insertions(+), 19 deletions(-)
 create mode 100644 docs/10_Bridge_Specific/PixivBridge.md

diff --git a/bridges/PixivBridge.php b/bridges/PixivBridge.php
index cf509855..5549c609 100644
--- a/bridges/PixivBridge.php
+++ b/bridges/PixivBridge.php
@@ -7,6 +7,17 @@ class PixivBridge extends BridgeAbstract
     const NAME = 'Pixiv Bridge';
     const URI = 'https://www.pixiv.net/';
     const DESCRIPTION = 'Returns the tag search from pixiv.net';
+    const MAINTAINER = 'mruac';
+    const CONFIGURATION = [
+        'cookie' => [
+            'required' => false,
+            'defaultValue' => null
+        ],
+        'proxy_url' => [
+            'required' => false,
+            'defaultValue' => null
+        ]
+    ];
 
 
     const PARAMETERS = [
@@ -23,11 +34,21 @@ class PixivBridge extends BridgeAbstract
             'mode' => [
                 'name' => 'Post Type',
                 'type' => 'list',
-                'values' => ['All Works' => 'all',
-                                  'Illustrations' => 'illustrations/',
-                                  'Manga' => 'manga/',
-                                  'Novels' => 'novels/']
+                'values' => [
+                    'All Works' => 'all',
+                    'Illustrations' => 'illustrations/',
+                    'Manga' => 'manga/',
+                    'Novels' => 'novels/'
+                ]
             ],
+            'mature' => [
+                'name' => 'Include R-18 works',
+                'type' => 'checkbox'
+            ],
+            'ai' => [
+                'name' => 'Include AI-Generated works',
+                'type' => 'checkbox'
+            ]
         ],
         'Tag' => [
             'tag' => [
@@ -76,7 +97,7 @@ class PixivBridge extends BridgeAbstract
             default:
                 return parent::getName();
         }
-        return 'Pixiv ' . $this->getKey('mode') . " from ${context} ${query}";
+        return 'Pixiv ' . $this->getKey('mode') . " from {$context} {$query}";
     }
 
     public function getURI()
@@ -106,7 +127,7 @@ class PixivBridge extends BridgeAbstract
                 break;
             case 'User':
                 $uri = static::URI . 'ajax/user/' . $this->getInput('userid')
-                 . '/profile/top';
+                    . '/profile/top';
                 break;
             default:
                 returnClientError('Invalid Context');
@@ -116,18 +137,47 @@ class PixivBridge extends BridgeAbstract
 
     private function getDataFromJSON($json, $json_key)
     {
-        $json = $json['body'][$json_key];
+        $key = $json_key;
+        if (
+            $this->queriedContext === 'Tag' &&
+            $this->getOption('cookie') !== null
+        ) {
+            switch ($json_key) {
+                case 'illust':
+                case 'manga':
+                    $key = 'illustManga';
+                    break;
+            }
+        }
+        $json = $json['body'][$key];
         // Tags context contains subkey
-        if ($this->queriedContext == 'Tag') {
+        if ($this->queriedContext === 'Tag') {
             $json = $json['data'];
+            if ($this->getOption('cookie') !== null) {
+                switch ($json_key) {
+                    case 'illust':
+                        $json = array_reduce($json, function ($acc, $i) {
+                            if ($i['illustType'] === 0) {
+                                $acc[] = $i;
+                            }return $acc;
+                        }, []);
+                        break;
+                    case 'manga':
+                        $json = array_reduce($json, function ($acc, $i) {
+                            if ($i['illustType'] === 1) {
+                                $acc[] = $i;
+                            }return $acc;
+                        }, []);
+                        break;
+                }
+            }
         }
         return $json;
     }
 
     private function collectWorksArray()
     {
-        $content = getContents($this->getSearchURI($this->getInput('mode')));
-        $content = json_decode($content, true);
+        $content = $this->getData($this->getSearchURI($this->getInput('mode')), true, true);
         if ($this->getInput('mode') == 'all') {
             $total = [];
             foreach (self::JSON_KEY_MAP[$this->queriedContext] as $mode => $json_key) {
@@ -144,14 +194,36 @@ class PixivBridge extends BridgeAbstract
 
     public function collectData()
     {
+        $this->checkOptions();
+        $proxy_url = $this->getOption('proxy_url');
+        $proxy_url = $proxy_url ? rtrim($proxy_url, '/') : null;
+
         $content = $this->collectWorksArray();
         $content = array_filter($content, function ($v, $k) {
             return !array_key_exists('isAdContainer', $v);
         }, ARRAY_FILTER_USE_BOTH);
+
         // Sort by updateDate to get newest works
         usort($content, function ($a, $b) {
             return $b['updateDate'] <=> $a['updateDate'];
         });
+
+        //exclude AI generated works if unchecked.
+        if ($this->getInput('ai') !== true) {
+            $content = array_filter($content, function ($v) {
+                $isAI = $v['aiType'] === 2;
+                return !$isAI;
+            });
+        }
+
+        //exclude R-18 works if unchecked.
+        if ($this->getInput('mature') !== true) {
+            $content = array_filter($content, function ($v) {
+                $isMature = $v['xRestrict'] > 0;
+                return !$isMature;
+            });
+        }
+
         $content = array_slice($content, 0, $this->getInput('posts'));
 
         foreach ($content as $result) {
@@ -168,12 +240,25 @@ class PixivBridge extends BridgeAbstract
             $item['author'] = $result['userName'];
             $item['timestamp'] = $result['updateDate'];
             $item['categories'] = $result['tags'];
-            $cached_image = $this->cacheImage(
-                $result['url'],
-                $result['id'],
-                array_key_exists('illustType', $result)
-            );
-            $item['content'] = "<img src='" . $cached_image . "' />";
+
+            if ($proxy_url) {
+                //use proxy image host if set.
+                if ($this->getInput('fullsize')) {
+                    $ajax_uri = static::URI . 'ajax/illust/' . $result['id'];
+                    $imagejson = $this->getData($ajax_uri, true, true);
+                    $img_url = preg_replace('/https:\/\/i\.pximg\.net/', $proxy_url, $imagejson['body']['urls']['original']);
+                } else {
+                    $img_url = preg_replace('/https:\/\/i\.pximg\.net/', $proxy_url, $result['url']);
+                }
+            } else {
+                //else cache and use image.
+                $img_url = $this->cacheImage(
+                    $result['url'],
+                    $result['id'],
+                    array_key_exists('illustType', $result)
+                );
+            }
+            $item['content'] = "<img src='" . $img_url . "' />";
 
             // Additional content items
             if (array_key_exists('pageCount', $result)) {
@@ -188,6 +273,7 @@ class PixivBridge extends BridgeAbstract
 
     /**
      * todo: remove manual file cache
+     * See bridge specific documentation for alternative option.
      */
     private function cacheImage($url, $illustId, $isImage)
     {
@@ -209,19 +295,96 @@ class PixivBridge extends BridgeAbstract
             // Get fullsize URL
             if ($isImage && $this->getInput('fullsize')) {
                 $ajax_uri = static::URI . 'ajax/illust/' . $illustId;
-                $imagejson = json_decode(getContents($ajax_uri), true);
+                $imagejson = $this->getData($ajax_uri, true, true);
                 $url = $imagejson['body']['urls']['original'];
             }
 
             $headers = ['Referer: ' . static::URI];
             try {
-                $illust = getContents($url, $headers);
+                $illust = $this->getData($url, true, false, $headers);
             } catch (Exception $e) {
-                $illust = getContents($thumbnailurl, $headers); // Original thumbnail
+                $illust = $this->getData($thumbnailurl, true, false, $headers); // Original thumbnail
             }
             file_put_contents($path, $illust);
         }
 
         return get_home_page_url() . 'cache/pixiv_img/' . preg_replace('/.*\//', '', $path);
     }
+
+    private function checkOptions()
+    {
+        $proxy = $this->getOption('proxy_url');
+        if ($proxy) {
+            if (
+                !(strlen($proxy) > 0 && preg_match('/https?:\/\/.*/', $proxy))
+            ) {
+                return returnServerError('Invalid proxy_url value set. The proxy must include the HTTP/S at the beginning of the url.');
+            }
+        }
+
+        $cookie = $this->getCookie();
+        if ($cookie) {
+            $isAuth = $this->loadCacheValue('is_authenticated');
+            if (!$isAuth) {
+                $res = $this->getData('https://www.pixiv.net/ajax/webpush', true, true)
+                    or returnServerError('Invalid PHPSESSID cookie provided. Please check the 🍪 and try again.');
+                if ($res['error'] === false) {
+                    $this->saveCacheValue('is_authenticated', true);
+                }
+            }
+        }
+    }
+
+    private function checkCookie(array $headers)
+    {
+        if (array_key_exists('set-cookie', $headers)) {
+            foreach ($headers['set-cookie'] as $value) {
+                if (str_starts_with($value, 'PHPSESSID=')) {
+                    parse_str(strtr($value, ['&' => '%26', '+' => '%2B', ';' => '&']), $cookie);
+                    if ($cookie['PHPSESSID'] != $this->getCookie()) {
+                        $this->saveCacheValue('cookie', $cookie['PHPSESSID']);
+                    }
+                    break;
+                }
+            }
+        }
+    }
+
+    private function getCookie()
+    {
+        // checks if cookie is set, if not initialise it with the cookie from the config
+        $value = $this->loadCacheValue('cookie', 2678400 /* 30 days + 1 day to let cookie chance to renew */);
+        if (!isset($value)) {
+            $value = $this->getOption('cookie');
+            $this->saveCacheValue('cookie', $this->getOption('cookie'));
+        }
+        return $value;
+    }
+
+    //Cache getContents by default
+    private function getData(string $url, bool $cache = true, bool $getJSON = false, array $httpHeaders = [], array $curlOptions = [])
+    {
+        $cookie_str = $this->getCookie();
+        if ($cookie_str) {
+            $curlOptions[CURLOPT_COOKIE] = 'PHPSESSID=' . $cookie_str;
+        }
+
+        if ($cache) {
+            $data = $this->loadCacheValue($url, 86400); // 24 hours
+            if (!$data) {
+                $data = getContents($url, $httpHeaders, $curlOptions, true) or returnServerError("Could not load $url");
+                $this->saveCacheValue($url, $data);
+            }
+        } else {
+            $data = getContents($url, $httpHeaders, $curlOptions, true) or returnServerError("Could not load $url");
+        }
+
+        $this->checkCookie($data['headers']);
+
+        if ($getJSON) {
+            return json_decode($data['content'], true);
+        } else {
+            return $data['content'];
+        }
+    }
 }
diff --git a/docs/10_Bridge_Specific/PixivBridge.md b/docs/10_Bridge_Specific/PixivBridge.md
new file mode 100644
index 00000000..b782a445
--- /dev/null
+++ b/docs/10_Bridge_Specific/PixivBridge.md
@@ -0,0 +1,23 @@
+PixivBridge
+===============
+
+# Image proxy
+As Pixiv requires images to be loaded with the `Referer "https://www.pixiv.net/"` header set, caching or image proxy is required to use this bridge.
+
+To turn off image caching, set the `proxy_url` value in this bridge's configuration section of `config.ini.php` to the url of the proxy. The bridge will then use the proxy in this format (essentially replacing `https://i.pximg.net` with the proxy): 
+
+Before: `https://i.pximg.net/img-original/img/0000/00/00/00/00/00/12345678_p0.png`
+
+After: `https://proxy.example.com/img-original/img/0000/00/00/00/00/00/12345678_p0.png`
+
+```
+proxy_url = "https://proxy.example.com"
+```
+
+# Authentication
+Authentication is required to view and search R-18+ and non-public images. To enable this, set the following in this bridge's configuration in `config.ini.php`.
+
+```
+; from cookie "PHPSESSID". Recommend to get in incognito browser. 
+cookie = "00000000_hashedsessionidhere"
+```
\ No newline at end of file

From 586d707ae48b74b150eb101f2e9986d0bd18d89f Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Sat, 9 Sep 2023 03:19:09 -0400
Subject: [PATCH 097/716] [ArsTechnicaBridge] Add new bridge (#3657)

---
 bridges/ArsTechnicaBridge.php | 71 +++++++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)
 create mode 100644 bridges/ArsTechnicaBridge.php

diff --git a/bridges/ArsTechnicaBridge.php b/bridges/ArsTechnicaBridge.php
new file mode 100644
index 00000000..1e3e6379
--- /dev/null
+++ b/bridges/ArsTechnicaBridge.php
@@ -0,0 +1,71 @@
+<?php
+
+class ArsTechnicaBridge extends FeedExpander
+{
+    const MAINTAINER = 'phantop';
+    const NAME = 'Ars Technica';
+    const URI = 'https://arstechnica.com/';
+    const DESCRIPTION = 'Returns the latest articles from Ars Technica';
+    const PARAMETERS = [[
+            'section' => [
+                'name' => 'Site section',
+                'type' => 'list',
+                'defaultValue' => 'index',
+                'values' => [
+                    'All' => 'index',
+                    'Apple' => 'apple',
+                    'Board Games' => 'cardboard',
+                    'Cars' => 'cars',
+                    'Features' => 'features',
+                    'Gaming' => 'gaming',
+                    'Information Technology' => 'technology-lab',
+                    'Science' => 'science',
+                    'Staff Blogs' => 'staff-blogs',
+                    'Tech Policy' => 'tech-policy',
+                    'Tech' => 'gadgets',
+                    ]
+            ]
+    ]];
+
+    public function collectData()
+    {
+        $url = 'https://feeds.arstechnica.com/arstechnica/' . $this->getInput('section');
+        $this->collectExpandableDatas($url);
+    }
+
+    protected function parseItem($newItem)
+    {
+        $item = parent::parseItem($newItem);
+
+        $item_html = getSimpleHTMLDOMCached($item['uri'] . '&amp');
+        $item_html = defaultLinkTo($item_html, self::URI);
+        $item['content'] = $item_html->find('.amp-wp-article-content', 0);
+
+        // remove various ars advertising
+        $item['content']->find('#social-left', 0)->remove();
+        foreach ($item['content']->find('.ars-component-buy-box') as $ad) {
+            $ad->remove();
+        }
+        foreach ($item['content']->find('i-amphtml-sizer') as $ad) {
+            $ad->remove();
+        }
+        foreach ($item['content']->find('.sidebar') as $ad) {
+            $ad->remove();
+        }
+
+        foreach ($item['content']->find('a') as $link) { //remove amp redirect links
+            $url = $link->getAttribute('href');
+            if (str_contains($url, 'go.redirectingat.com')) {
+                $url = extractFromDelimiters($url, 'url=', '&amp');
+                $url = urldecode($url);
+                $link->setAttribute('href', $url);
+            }
+        }
+
+        $item['content'] = backgroundToImg(str_replace('data-amp-original-style="background-image', 'style="background-image', $item['content']));
+
+        $item['uid'] = explode('=', $item['uri'])[1];
+
+        return $item;
+    }
+}

From 078091752ad2dbd6d4ca261d4b8e3ce333739e3a Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Sun, 10 Sep 2023 04:03:38 +0200
Subject: [PATCH 098/716] doc : Add documentation for the Findfeed action 
 (#3659)

* doc: Add documentation for the Findfeed action

Added the documentation to the Findfeed action

* doc: Add documentation for the Findfeed action

- Complete documentation
- fix typos
---
 docs/04_For_Developers/04_Actions.md | 94 +++++++++++++++++++++++++++-
 1 file changed, 91 insertions(+), 3 deletions(-)

diff --git a/docs/04_For_Developers/04_Actions.md b/docs/04_For_Developers/04_Actions.md
index c346731a..74c8cbfb 100644
--- a/docs/04_For_Developers/04_Actions.md
+++ b/docs/04_For_Developers/04_Actions.md
@@ -1,8 +1,9 @@
-RSS-Bridge currently supports three 'actions' which it can operate:
+RSS-Bridge currently supports four 'actions' which it can operate:
 
 1) [Display](#display) (`?action=display`)
 2) [Detect](#detect) (`?action=detect`)
 3) [List](#list) (`?action=list`)
+3) [FindFeed](#findfeed) (`?action=findfeed`)
 
 ## Display
 
@@ -19,7 +20,7 @@ The `detect` action attempts to redirect the user to an appropriate `display` ac
 
 If an appropriate bridge is found, a `301 Moved Permanently` HTTP status code is returned with a relative location for a `display` action. If no appropriate bridge is found or a required parameter is missing, a `400 Bad Request` status code is returned.
 
-The parameters for this action are listed bellow:
+The parameters for this action are listed below:
 
 Parameter | Required | Description
 ----------|----------|------------
@@ -75,4 +76,91 @@ Parameter     | Optional | Description
 
 ### `total`
 
-This parameter represents the total number of bridges available to the current instance of RSS-Bridge.
\ No newline at end of file
+This parameter represents the total number of bridges available to the current instance of RSS-Bridge.
+
+## FindFeed
+
+The `findfeed` action attempts to list all available feeds based on a supplied URL for the active bridges of this instance. As bridges have to individually implement `detectParameters`, this it may not work for every bridge.
+
+If one or more bridges return a feed, a JSON data array structure is returned. If no feeds were found, a `404 Not Found` status code is returned. If a required parameter is missing, a `400 Bad Request` status code is returned.
+
+For each feed, the whole feed URL is sent in the `url` member, the feed specific bridge parameters metadata in the `bridgeData` member and the Bridge metadata in the `bridgeMeta` member.
+
+This example shows JSON data for the NASA Instagram account URL (`https://www.instagram.com/nasa/`) using the `Html` format :
+
+```JSON
+[
+    {
+        "url": "https://rssbridge.host/?action=display&context=Username&u=nasa&bridge=InstagramBridge&format=Html",
+        "bridgeParams": {
+            "context": "Username",
+            "u": "nasa",
+            "bridge": "InstagramBridge",
+            "format": "Html"
+        },
+        "bridgeData": {
+            "context": {
+                "name": "Context",
+                "value": "Username"
+            },
+            "u": {
+                "name": "username",
+                "value": "nasa"
+            }
+        },
+        "bridgeMeta": {
+            "name": "Instagram Bridge",
+            "description": "Returns the newest images",
+            "parameters": {
+                "Username": {
+                    "u": {
+                        "name": "username",
+                        "exampleValue": "aesoprockwins",
+                        "required": true
+                    }
+                },
+                "Hashtag": {
+                    "h": {
+                        "name": "hashtag",
+                        "exampleValue": "beautifulday",
+                        "required": true
+                    }
+                },
+                "Location": {
+                    "l": {
+                        "name": "location",
+                        "exampleValue": "london",
+                        "required": true
+                    }
+                },
+                "global": {
+                    "media_type": {
+                        "name": "Media type",
+                        "type": "list",
+                        "required": false,
+                        "values": {
+                            "All": "all",
+                            "Video": "video",
+                            "Picture": "picture",
+                            "Multiple": "multiple"
+                        },
+                        "defaultValue": "all"
+                    },
+                    "direct_links": {
+                        "name": "Use direct media links",
+                        "type": "checkbox"
+                    }
+                }
+            },
+            "icon": "https://www.instagram.com//favicon.ico"
+        }
+    }
+]
+```
+
+The parameters for this action are listed below:
+
+Parameter | Required | Description
+----------|----------|------------
+`url`     | yes      | Specifies the URL to attempt to find a feed from. The value of this should be URL encoded.
+`format`  | yes      | Specifies the name of the format to use for the URL of the feeds. This is passed to the detected `display` action. Possible values are determined from the formats available to the current instance of RSS-Bridge.

From a786bbd4e0d45a98446ed0384ed57705a17b89d3 Mon Sep 17 00:00:00 2001
From: mruac <ant8672@gmail.com>
Date: Sun, 10 Sep 2023 11:45:05 +0930
Subject: [PATCH 099/716] DisplayAction: defaultchecked fix (#3654)

* .

* attempt to fix #2943
https://github.com/RSS-Bridge/rss-bridge/issues/2943

* Revert "."

This reverts commit c0b6ccfea6ce873e9c9ce7c3600b3a96d9911468.

* lint

* Revert "attempt to fix #2943"

This reverts commit 9f1a66e48d636a543e2171df212acf9731744bd0.

* moved fix to BridgeAbstract
---
 lib/BridgeAbstract.php | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index e58ddb91..2a6cd8ab 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -160,11 +160,7 @@ abstract class BridgeAbstract implements BridgeInterface
 
                 switch ($type) {
                     case 'checkbox':
-                        if (!isset($properties['defaultValue'])) {
-                            $this->inputs[$context][$name]['value'] = false;
-                        } else {
-                            $this->inputs[$context][$name]['value'] = $properties['defaultValue'];
-                        }
+                        $this->inputs[$context][$name]['value'] = $inputs[$context][$name]['value'] ?? false;
                         break;
                     case 'list':
                         if (!isset($properties['defaultValue'])) {
@@ -191,10 +187,14 @@ abstract class BridgeAbstract implements BridgeInterface
             foreach (static::PARAMETERS['global'] as $name => $properties) {
                 if (isset($inputs[$name])) {
                     $value = $inputs[$name];
-                } elseif (isset($properties['defaultValue'])) {
-                    $value = $properties['defaultValue'];
                 } else {
-                    continue;
+                    if ($properties['type'] === 'checkbox') {
+                        $value = false;
+                    } elseif (isset($properties['defaultValue'])) {
+                        $value = $properties['defaultValue'];
+                    } else {
+                        continue;
+                    }
                 }
                 $this->inputs[$queriedContext][$name]['value'] = $value;
             }

From 4b9f6f7e53e0b2e9aae59df2bbffc0bdd6805aea Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 10 Sep 2023 21:50:15 +0200
Subject: [PATCH 100/716] fix: rewrite and improve caching (#3594)

---
 README.md                                     |  13 +-
 actions/ConnectivityAction.php                |  32 +-
 actions/DetectAction.php                      |   2 +-
 actions/DisplayAction.php                     | 264 +++++++----------
 actions/ListAction.php                        |   2 +-
 actions/SetBridgeCacheAction.php              |  16 +-
 bridges/AO3Bridge.php                         |   6 +-
 bridges/BugzillaBridge.php                    |   2 +-
 bridges/ElloBridge.php                        |  17 +-
 bridges/InstagramBridge.php                   |  15 +-
 bridges/MastodonBridge.php                    |   2 +-
 bridges/RedditBridge.php                      |  22 ++
 bridges/SoundcloudBridge.php                  |  15 +-
 bridges/SpotifyBridge.php                     |  12 +-
 bridges/TwitterBridge.php                     | 152 ----------
 bridges/WordPressMadaraBridge.php             |   2 +-
 bridges/YoutubeBridge.php                     | 243 ++++++++-------
 caches/ArrayCache.php                         |  52 ++++
 caches/FileCache.php                          | 161 ++++------
 caches/MemcachedCache.php                     |  98 ++-----
 caches/NullCache.php                          |  22 +-
 caches/SQLiteCache.php                        |  98 +++----
 config.default.ini.php                        |   2 +-
 .../prepare_release/fetch_contributors.php    |   9 +-
 docs/06_Helper_functions/index.md             |  43 +--
 docs/07_Cache_API/02_CacheInterface.md        |  14 +-
 docs/index.md                                 |   6 +-
 index.php                                     |   4 +
 lib/BridgeAbstract.php                        |  19 +-
 lib/BridgeInterface.php                       |   2 +
 lib/CacheFactory.php                          |  24 +-
 lib/CacheInterface.php                        |  12 +-
 lib/Configuration.php                         |   7 +-
 lib/FeedExpander.php                          |   6 +-
 lib/FormatInterface.php                       |  10 +-
 lib/Logger.php                                |  17 +-
 lib/RssBridge.php                             |  98 ++++---
 lib/TwitterClient.php                         |  18 +-
 lib/bootstrap.php                             |   2 +-
 lib/contents.php                              | 276 +++---------------
 lib/error.php                                 |  47 ---
 lib/http.php                                  | 252 ++++++++++++++++
 lib/utils.php                                 |  29 +-
 tests/Actions/ListActionTest.php              |   3 +-
 tests/CacheTest.php                           |  14 +-
 45 files changed, 993 insertions(+), 1169 deletions(-)
 create mode 100644 caches/ArrayCache.php
 delete mode 100644 lib/error.php
 create mode 100644 lib/http.php

diff --git a/README.md b/README.md
index e0487e6b..dee69b85 100644
--- a/README.md
+++ b/README.md
@@ -55,6 +55,10 @@ Alternatively find another
 
 Requires minimum PHP 7.4.
 
+```shell
+apt install nginx php-fpm php-mbstring php-simplexml php-curl
+```
+
 ```shell
 cd /var/www
 composer create-project -v --no-dev rss-bridge/rss-bridge
@@ -334,10 +338,11 @@ This is the feed item structure that bridges are expected to produce.
 
 ### Cache backends
 
-* `file`
-* `sqlite`
-* `memcached`
-* `null`
+* `File`
+* `SQLite`
+* `Memcached`
+* `Array`
+* `Null`
 
 ### Licenses
 
diff --git a/actions/ConnectivityAction.php b/actions/ConnectivityAction.php
index 604b7806..3bc82a9d 100644
--- a/actions/ConnectivityAction.php
+++ b/actions/ConnectivityAction.php
@@ -34,7 +34,7 @@ class ConnectivityAction implements ActionInterface
     public function execute(array $request)
     {
         if (!Debug::isEnabled()) {
-            throw new \Exception('This action is only available in debug mode!');
+            return new Response('This action is only available in debug mode!');
         }
 
         $bridgeName = $request['bridge'] ?? null;
@@ -43,7 +43,7 @@ class ConnectivityAction implements ActionInterface
         }
         $bridgeClassName = $this->bridgeFactory->createBridgeClassName($bridgeName);
         if (!$bridgeClassName) {
-            throw new \Exception(sprintf('Bridge not found: %s', $bridgeName));
+            return new Response('Bridge not found', 404);
         }
         return $this->reportBridgeConnectivity($bridgeClassName);
     }
@@ -54,29 +54,25 @@ class ConnectivityAction implements ActionInterface
             throw new \Exception('Bridge is not whitelisted!');
         }
 
-        $retVal = [
-            'bridge' => $bridgeClassName,
-            'successful' => false,
-            'http_code' => 200,
-        ];
-
         $bridge = $this->bridgeFactory->create($bridgeClassName);
         $curl_opts = [
-            CURLOPT_CONNECTTIMEOUT => 5
+            CURLOPT_CONNECTTIMEOUT => 5,
+            CURLOPT_FOLLOWLOCATION => true,
+        ];
+        $result = [
+            'bridge'        => $bridgeClassName,
+            'successful'    => false,
+            'http_code'     => null,
         ];
         try {
-            $reply = getContents($bridge::URI, [], $curl_opts, true);
-
-            if ($reply['code'] === 200) {
-                $retVal['successful'] = true;
-                if (strpos(implode('', $reply['status_lines']), '301 Moved Permanently')) {
-                    $retVal['http_code'] = 301;
-                }
+            $response = getContents($bridge::URI, [], $curl_opts, true);
+            $result['http_code'] = $response['code'];
+            if (in_array($response['code'], [200])) {
+                $result['successful'] = true;
             }
         } catch (\Exception $e) {
-            $retVal['successful'] = false;
         }
 
-        return new Response(Json::encode($retVal), 200, ['Content-Type' => 'text/json']);
+        return new Response(Json::encode($result), 200, ['content-type' => 'text/json']);
     }
 }
diff --git a/actions/DetectAction.php b/actions/DetectAction.php
index 6c9fa22d..49b7ced7 100644
--- a/actions/DetectAction.php
+++ b/actions/DetectAction.php
@@ -45,7 +45,7 @@ class DetectAction implements ActionInterface
             $bridgeParams['format'] = $format;
 
             $url = '?action=display&' . http_build_query($bridgeParams);
-            return new Response('', 301, ['Location' => $url]);
+            return new Response('', 301, ['location' => $url]);
         }
 
         throw new \Exception('No bridge found for given URL: ' . $targetURL);
diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 7b2efec1..7c59b3d5 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -10,50 +10,41 @@ class DisplayAction implements ActionInterface
             return new Response('503 Service Unavailable', 503);
         }
         $this->cache = RssBridge::getCache();
-        $this->cache->setScope('http');
-        $this->cache->setKey($request);
-        // avg timeout of 20m
-        $timeout = 60 * 15 + rand(1, 60 * 10);
+        $cacheKey = 'http_' . json_encode($request);
         /** @var Response $cachedResponse */
-        $cachedResponse = $this->cache->loadData($timeout);
-        if ($cachedResponse && !Debug::isEnabled()) {
-            //Logger::info(sprintf('Returning cached (http) response: %s', $cachedResponse->getBody()));
+        $cachedResponse = $this->cache->get($cacheKey);
+        if ($cachedResponse) {
+            $ifModifiedSince = $_SERVER['HTTP_IF_MODIFIED_SINCE'] ?? null;
+            $lastModified = $cachedResponse->getHeader('last-modified');
+            if ($ifModifiedSince && $lastModified) {
+                $lastModified = new \DateTimeImmutable($lastModified);
+                $lastModifiedTimestamp = $lastModified->getTimestamp();
+                $modifiedSince = strtotime($ifModifiedSince);
+                if ($lastModifiedTimestamp <= $modifiedSince) {
+                    $modificationTimeGMT = gmdate('D, d M Y H:i:s ', $lastModifiedTimestamp);
+                    return new Response('', 304, ['last-modified' => $modificationTimeGMT . 'GMT']);
+                }
+            }
             return $cachedResponse;
         }
-        $response = $this->createResponse($request);
-        if (in_array($response->getCode(), [429, 503])) {
-            //Logger::info(sprintf('Storing cached (http) response: %s', $response->getBody()));
-            $this->cache->setScope('http');
-            $this->cache->setKey($request);
-            $this->cache->saveData($response);
-        }
-        return $response;
-    }
-
-    private function createResponse(array $request)
-    {
-        $bridgeFactory = new BridgeFactory();
-        $formatFactory = new FormatFactory();
 
         $bridgeName = $request['bridge'] ?? null;
-        $format = $request['format'] ?? null;
-
+        if (!$bridgeName) {
+            return new Response('Missing bridge param', 400);
+        }
+        $bridgeFactory = new BridgeFactory();
         $bridgeClassName = $bridgeFactory->createBridgeClassName($bridgeName);
         if (!$bridgeClassName) {
-            throw new \Exception(sprintf('Bridge not found: %s', $bridgeName));
+            return new Response('Bridge not found', 404);
         }
+        $format = $request['format'] ?? null;
         if (!$format) {
-            throw new \Exception('You must specify a format!');
+            return new Response('You must specify a format!', 400);
         }
         if (!$bridgeFactory->isEnabled($bridgeClassName)) {
-            throw new \Exception('This bridge is not whitelisted');
+            return new Response('This bridge is not whitelisted', 400);
         }
 
-        $format = $formatFactory->create($format);
-
-        $bridge = $bridgeFactory->create($bridgeClassName);
-        $bridge->loadConfiguration();
-
         $noproxy = $request['_noproxy'] ?? null;
         if (
             Configuration::getConfig('proxy', 'url')
@@ -64,147 +55,100 @@ class DisplayAction implements ActionInterface
             define('NOPROXY', true);
         }
 
-        $cacheTimeout = $request['_cache_timeout'] ?? null;
-        if (Configuration::getConfig('cache', 'custom_timeout') && $cacheTimeout) {
-            $cacheTimeout = (int) $cacheTimeout;
-        } else {
-            // At this point the query argument might still be in the url but it won't be used
-            $cacheTimeout = $bridge->getCacheTimeout();
+        $bridge = $bridgeFactory->create($bridgeClassName);
+        $formatFactory = new FormatFactory();
+        $format = $formatFactory->create($format);
+
+        $response = $this->createResponse($request, $bridge, $format);
+
+        if ($response->getCode() === 200) {
+            $ttl = $request['_cache_timeout'] ?? null;
+            if (Configuration::getConfig('cache', 'custom_timeout') && $ttl) {
+                $ttl = (int) $ttl;
+            } else {
+                $ttl = $bridge->getCacheTimeout();
+            }
+            $this->cache->set($cacheKey, $response, $ttl);
         }
 
-        // Remove parameters that don't concern bridges
-        $bridge_params = array_diff_key(
-            $request,
-            array_fill_keys(
-                [
-                    'action',
-                    'bridge',
-                    'format',
-                    '_noproxy',
-                    '_cache_timeout',
-                    '_error_time'
-                ],
-                ''
-            )
-        );
+        if (in_array($response->getCode(), [429, 503])) {
+            $this->cache->set($cacheKey, $response, 60 * 15 + rand(1, 60 * 10)); // average 20m
+        }
 
-        // Remove parameters that don't concern caches
-        $cache_params = array_diff_key(
-            $request,
-            array_fill_keys(
-                [
-                    'action',
-                    'format',
-                    '_noproxy',
-                    '_cache_timeout',
-                    '_error_time'
-                ],
-                ''
-            )
-        );
-
-        $this->cache->setScope('');
-        $this->cache->setKey($cache_params);
+        if ($response->getCode() === 500) {
+            $this->cache->set($cacheKey, $response, 60 * 15);
+        }
+        if (rand(1, 100) === 2) {
+            $this->cache->prune();
+        }
+        return $response;
+    }
 
+    private function createResponse(array $request, BridgeInterface $bridge, FormatInterface $format)
+    {
         $items = [];
         $infos = [];
 
-        $feed = $this->cache->loadData($cacheTimeout);
-
-        if ($feed && !Debug::isEnabled()) {
-            if (isset($_SERVER['HTTP_IF_MODIFIED_SINCE'])) {
-                $modificationTime = $this->cache->getTime();
-                // The client wants to know if the feed has changed since its last check
-                $modifiedSince = strtotime($_SERVER['HTTP_IF_MODIFIED_SINCE']);
-                if ($modificationTime <= $modifiedSince) {
-                    $modificationTimeGMT = gmdate('D, d M Y H:i:s ', $modificationTime);
-                    return new Response('', 304, ['Last-Modified' => $modificationTimeGMT . 'GMT']);
+        try {
+            $bridge->loadConfiguration();
+            // Remove parameters that don't concern bridges
+            $bridgeData = array_diff_key($request, array_fill_keys(['action', 'bridge', 'format', '_noproxy', '_cache_timeout', '_error_time'], ''));
+            $bridge->setDatas($bridgeData);
+            $bridge->collectData();
+            $items = $bridge->getItems();
+            if (isset($items[0]) && is_array($items[0])) {
+                $feedItems = [];
+                foreach ($items as $item) {
+                    $feedItems[] = new FeedItem($item);
+                }
+                $items = $feedItems;
+            }
+            $infos = [
+                'name' => $bridge->getName(),
+                'uri'  => $bridge->getURI(),
+                'donationUri'  => $bridge->getDonationURI(),
+                'icon' => $bridge->getIcon()
+            ];
+        } catch (\Exception $e) {
+            $errorOutput = Configuration::getConfig('error', 'output');
+            $reportLimit = Configuration::getConfig('error', 'report_limit');
+            if ($e instanceof HttpException) {
+                // Reproduce (and log) these responses regardless of error output and report limit
+                if ($e->getCode() === 429) {
+                    Logger::info(sprintf('Exception in DisplayAction(%s): %s', $bridge->getShortName(), create_sane_exception_message($e)));
+                    return new Response('429 Too Many Requests', 429);
+                }
+                if ($e->getCode() === 503) {
+                    Logger::info(sprintf('Exception in DisplayAction(%s): %s', $bridge->getShortName(), create_sane_exception_message($e)));
+                    return new Response('503 Service Unavailable', 503);
                 }
             }
-
-            if (isset($feed['items']) && isset($feed['extraInfos'])) {
-                foreach ($feed['items'] as $item) {
-                    $items[] = new FeedItem($item);
-                }
-                $infos = $feed['extraInfos'];
+            Logger::error(sprintf('Exception in DisplayAction(%s)', $bridge->getShortName()), ['e' => $e]);
+            $errorCount = 1;
+            if ($reportLimit > 1) {
+                $errorCount = $this->logBridgeError($bridge->getName(), $e->getCode());
             }
-        } else {
-            try {
-                $bridge->setDatas($bridge_params);
-                $bridge->collectData();
-                $items = $bridge->getItems();
-                if (isset($items[0]) && is_array($items[0])) {
-                    $feedItems = [];
-                    foreach ($items as $item) {
-                        $feedItems[] = new FeedItem($item);
-                    }
-                    $items = $feedItems;
-                }
-                $infos = [
-                    'name' => $bridge->getName(),
-                    'uri'  => $bridge->getURI(),
-                    'donationUri'  => $bridge->getDonationURI(),
-                    'icon' => $bridge->getIcon()
-                ];
-            } catch (\Exception $e) {
-                $errorOutput = Configuration::getConfig('error', 'output');
-                $reportLimit = Configuration::getConfig('error', 'report_limit');
-                if ($e instanceof HttpException) {
-                    // Reproduce (and log) these responses regardless of error output and report limit
-                    if ($e->getCode() === 429) {
-                        Logger::info(sprintf('Exception in DisplayAction(%s): %s', $bridgeClassName, create_sane_exception_message($e)));
-                        return new Response('429 Too Many Requests', 429);
-                    }
-                    if ($e->getCode() === 503) {
-                        Logger::info(sprintf('Exception in DisplayAction(%s): %s', $bridgeClassName, create_sane_exception_message($e)));
-                        return new Response('503 Service Unavailable', 503);
-                    }
-                    // Might want to cache other codes such as 504 Gateway Timeout
-                }
-                if (in_array($errorOutput, ['feed', 'none'])) {
-                    Logger::error(sprintf('Exception in DisplayAction(%s): %s', $bridgeClassName, create_sane_exception_message($e)), ['e' => $e]);
-                }
-                $errorCount = 1;
-                if ($reportLimit > 1) {
-                    $errorCount = $this->logBridgeError($bridge->getName(), $e->getCode());
-                }
-                // Let clients know about the error if we are passed the report limit
-                if ($errorCount >= $reportLimit) {
-                    if ($errorOutput === 'feed') {
-                        // Render the exception as a feed item
-                        $items[] = $this->createFeedItemFromException($e, $bridge);
-                    } elseif ($errorOutput === 'http') {
-                        // Rethrow so that the main exception handler in RssBridge.php produces an HTTP 500
-                        throw $e;
-                    } elseif ($errorOutput === 'none') {
-                        // Do nothing (produces an empty feed)
-                    } else {
-                        // Do nothing, unknown error output? Maybe throw exception or validate in Configuration.php
-                    }
+            // Let clients know about the error if we are passed the report limit
+            if ($errorCount >= $reportLimit) {
+                if ($errorOutput === 'feed') {
+                    // Render the exception as a feed item
+                    $items[] = $this->createFeedItemFromException($e, $bridge);
+                } elseif ($errorOutput === 'http') {
+                    return new Response(render(__DIR__ . '/../templates/error.html.php', ['e' => $e]), 500);
+                } elseif ($errorOutput === 'none') {
+                    // Do nothing (produces an empty feed)
                 }
             }
-
-            // Unfortunately need to set scope and key again because they might be modified
-            $this->cache->setScope('');
-            $this->cache->setKey($cache_params);
-            $this->cache->saveData([
-                'items' => array_map(function (FeedItem $item) {
-                    return $item->toArray();
-                }, $items),
-                'extraInfos' => $infos
-            ]);
-            $this->cache->purgeCache();
         }
 
         $format->setItems($items);
         $format->setExtraInfos($infos);
-        $newModificationTime = $this->cache->getTime();
-        $format->setLastModified($newModificationTime);
-        $headers = [];
-        if ($newModificationTime) {
-            $headers['Last-Modified'] = gmdate('D, d M Y H:i:s ', $newModificationTime) . 'GMT';
-        }
-        $headers['Content-Type'] = $format->getMimeType() . '; charset=' . $format->getCharset();
+        $now = time();
+        $format->setLastModified($now);
+        $headers = [
+            'last-modified' => gmdate('D, d M Y H:i:s ', $now) . 'GMT',
+            'content-type'  => $format->getMimeType() . '; charset=' . $format->getCharset(),
+        ];
         return new Response($format->stringify(), 200, $headers);
     }
 
@@ -234,9 +178,8 @@ class DisplayAction implements ActionInterface
 
     private function logBridgeError($bridgeName, $code)
     {
-        $this->cache->setScope('error_reporting');
-        $this->cache->setkey([$bridgeName . '_' . $code]);
-        $report = $this->cache->loadData();
+        $cacheKey = 'error_reporting_' . $bridgeName . '_' . $code;
+        $report = $this->cache->get($cacheKey);
         if ($report) {
             $report = Json::decode($report);
             $report['time'] = time();
@@ -248,7 +191,8 @@ class DisplayAction implements ActionInterface
                 'count' => 1,
             ];
         }
-        $this->cache->saveData(Json::encode($report));
+        $ttl = 86400 * 5;
+        $this->cache->set($cacheKey, Json::encode($report), $ttl);
         return $report['count'];
     }
 
diff --git a/actions/ListAction.php b/actions/ListAction.php
index 6ce7e33e..9025bf6e 100644
--- a/actions/ListAction.php
+++ b/actions/ListAction.php
@@ -37,6 +37,6 @@ class ListAction implements ActionInterface
             ];
         }
         $list->total = count($list->bridges);
-        return new Response(Json::encode($list), 200, ['Content-Type' => 'application/json']);
+        return new Response(Json::encode($list), 200, ['content-type' => 'application/json']);
     }
 }
diff --git a/actions/SetBridgeCacheAction.php b/actions/SetBridgeCacheAction.php
index 416f2378..a8e712d4 100644
--- a/actions/SetBridgeCacheAction.php
+++ b/actions/SetBridgeCacheAction.php
@@ -19,7 +19,10 @@ class SetBridgeCacheAction implements ActionInterface
         $authenticationMiddleware = new ApiAuthenticationMiddleware();
         $authenticationMiddleware($request);
 
-        $key = $request['key'] or returnClientError('You must specify key!');
+        $key = $request['key'] ?? null;
+        if (!$key) {
+            returnClientError('You must specify key!');
+        }
 
         $bridgeFactory = new BridgeFactory();
 
@@ -40,13 +43,10 @@ class SetBridgeCacheAction implements ActionInterface
         $value = $request['value'];
 
         $cache = RssBridge::getCache();
-        $cache->setScope(get_class($bridge));
-        if (!is_array($key)) {
-            // not sure if $key is an array when it comes in from request
-            $key = [$key];
-        }
-        $cache->setKey($key);
-        $cache->saveData($value);
+
+        $cacheKey = get_class($bridge) . '_' . $key;
+        $ttl = 86400 * 3;
+        $cache->set($cacheKey, $value, $ttl);
 
         header('Content-Type: text/plain');
         echo 'done';
diff --git a/bridges/AO3Bridge.php b/bridges/AO3Bridge.php
index 57e12fbd..e30c6b70 100644
--- a/bridges/AO3Bridge.php
+++ b/bridges/AO3Bridge.php
@@ -33,6 +33,7 @@ class AO3Bridge extends BridgeAbstract
             ],
         ]
     ];
+    private $title;
 
     public function collectData()
     {
@@ -94,11 +95,12 @@ class AO3Bridge extends BridgeAbstract
         $url = self::URI . "/works/$id/navigate";
         $httpClient = RssBridge::getHttpClient();
 
+        $version = 'v0.0.1';
         $response = $httpClient->request($url, [
-            'useragent' => 'rss-bridge bot (https://github.com/RSS-Bridge/rss-bridge)',
+            'useragent' => "rss-bridge $version (https://github.com/RSS-Bridge/rss-bridge)",
         ]);
 
-        $html = \str_get_html($response['body']);
+        $html = \str_get_html($response->getBody());
         $html = defaultLinkTo($html, self::URI);
 
         $this->title = $html->find('h2 a', 0)->plaintext;
diff --git a/bridges/BugzillaBridge.php b/bridges/BugzillaBridge.php
index 9b4d1adc..c2dc8d40 100644
--- a/bridges/BugzillaBridge.php
+++ b/bridges/BugzillaBridge.php
@@ -159,7 +159,7 @@ class BugzillaBridge extends BridgeAbstract
     protected function getUser($user)
     {
         // Check if the user endpoint is available
-        if ($this->loadCacheValue($this->instance . 'userEndpointClosed', 86400)) {
+        if ($this->loadCacheValue($this->instance . 'userEndpointClosed')) {
             return $user;
         }
 
diff --git a/bridges/ElloBridge.php b/bridges/ElloBridge.php
index 4cc1858b..9017bc11 100644
--- a/bridges/ElloBridge.php
+++ b/bridges/ElloBridge.php
@@ -114,18 +114,17 @@ class ElloBridge extends BridgeAbstract
     private function getAPIKey()
     {
         $cache = RssBridge::getCache();
-        $cache->setScope('ElloBridge');
-        $cache->setKey(['key']);
-        $key = $cache->loadData();
+        $cacheKey = 'ElloBridge_key';
+        $apiKey = $cache->get($cacheKey);
 
-        if ($key == null) {
-            $keyInfo = getContents(self::URI . 'api/webapp-token') or
-                returnServerError('Unable to get token.');
-            $key = json_decode($keyInfo)->token->access_token;
-            $cache->saveData($key);
+        if (!$apiKey) {
+            $keyInfo = getContents(self::URI . 'api/webapp-token') or returnServerError('Unable to get token.');
+            $apiKey = json_decode($keyInfo)->token->access_token;
+            $ttl = 60 * 60 * 20;
+            $cache->set($cacheKey, $apiKey, $ttl);
         }
 
-        return $key;
+        return $apiKey;
     }
 
     public function getName()
diff --git a/bridges/InstagramBridge.php b/bridges/InstagramBridge.php
index 0f644c4a..9a846fb1 100644
--- a/bridges/InstagramBridge.php
+++ b/bridges/InstagramBridge.php
@@ -99,23 +99,22 @@ class InstagramBridge extends BridgeAbstract
         }
 
         $cache = RssBridge::getCache();
-        $cache->setScope('InstagramBridge');
-        $cache->setKey([$username]);
-        $key = $cache->loadData();
+        $cacheKey = 'InstagramBridge_' . $username;
+        $pk = $cache->get($cacheKey);
 
-        if ($key == null) {
+        if (!$pk) {
             $data = $this->getContents(self::URI . 'web/search/topsearch/?query=' . $username);
             foreach (json_decode($data)->users as $user) {
                 if (strtolower($user->user->username) === strtolower($username)) {
-                    $key = $user->user->pk;
+                    $pk = $user->user->pk;
                 }
             }
-            if ($key == null) {
+            if (!$pk) {
                 returnServerError('Unable to find username in search result.');
             }
-            $cache->saveData($key);
+            $cache->set($cacheKey, $pk);
         }
-        return $key;
+        return $pk;
     }
 
     public function collectData()
diff --git a/bridges/MastodonBridge.php b/bridges/MastodonBridge.php
index 855aae08..81401be9 100644
--- a/bridges/MastodonBridge.php
+++ b/bridges/MastodonBridge.php
@@ -100,7 +100,7 @@ class MastodonBridge extends BridgeAbstract
                 // We fetch the boosted content.
                 try {
                     $rtContent = $this->fetchAP($content['object']);
-                    $rtUser = $this->loadCacheValue($rtContent['attributedTo'], 86400);
+                    $rtUser = $this->loadCacheValue($rtContent['attributedTo']);
                     if (!isset($rtUser)) {
                         // We fetch the author, since we cannot always assume the format of the URL.
                         $user = $this->fetchAP($rtContent['attributedTo']);
diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index bd60243f..196f7d20 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -72,8 +72,30 @@ class RedditBridge extends BridgeAbstract
             ]
         ]
     ];
+    private CacheInterface $cache;
+
+    public function __construct()
+    {
+        $this->cache = RssBridge::getCache();
+    }
 
     public function collectData()
+    {
+        $cacheKey = 'reddit_rate_limit';
+        if ($this->cache->get($cacheKey)) {
+            throw new HttpException('429 Too Many Requests', 429);
+        }
+        try {
+            $this->collectDataInternal();
+        } catch (HttpException $e) {
+            if ($e->getCode() === 429) {
+                $this->cache->set($cacheKey, true, 60 * 16);
+                throw $e;
+            }
+        }
+    }
+
+    private function collectDataInternal(): void
     {
         $user = false;
         $comments = false;
diff --git a/bridges/SoundcloudBridge.php b/bridges/SoundcloudBridge.php
index 0bd9a2b0..5664761b 100644
--- a/bridges/SoundcloudBridge.php
+++ b/bridges/SoundcloudBridge.php
@@ -36,7 +36,7 @@ class SoundCloudBridge extends BridgeAbstract
 
     private $feedTitle = null;
     private $feedIcon = null;
-    private $cache = null;
+    private CacheInterface $cache;
 
     private $clientIdRegex = '/client_id.*?"(.+?)"/';
     private $widgetRegex = '/widget-.+?\.js/';
@@ -44,8 +44,6 @@ class SoundCloudBridge extends BridgeAbstract
     public function collectData()
     {
         $this->cache = RssBridge::getCache();
-        $this->cache->setScope('SoundCloudBridge');
-        $this->cache->setKey(['client_id']);
 
         $res = $this->getUser($this->getInput('u'));
 
@@ -121,11 +119,9 @@ HTML;
 
     private function getClientID()
     {
-        $this->cache->setScope('SoundCloudBridge');
-        $this->cache->setKey(['client_id']);
-        $clientID = $this->cache->loadData();
+        $clientID = $this->cache->get('SoundCloudBridge_client_id');
 
-        if ($clientID == null) {
+        if (!$clientID) {
             return $this->refreshClientID();
         } else {
             return $clientID;
@@ -151,10 +147,7 @@ HTML;
 
             if (preg_match($this->clientIdRegex, $widgetJS, $matches)) {
                 $clientID = $matches[1];
-                $this->cache->setScope('SoundCloudBridge');
-                $this->cache->setKey(['client_id']);
-                $this->cache->saveData($clientID);
-
+                $this->cache->set('SoundCloudBridge_client_id', $clientID);
                 return $clientID;
             }
         }
diff --git a/bridges/SpotifyBridge.php b/bridges/SpotifyBridge.php
index 7b7e2b1d..eb847f3d 100644
--- a/bridges/SpotifyBridge.php
+++ b/bridges/SpotifyBridge.php
@@ -279,10 +279,9 @@ class SpotifyBridge extends BridgeAbstract
     private function fetchAccessToken()
     {
         $cache = RssBridge::getCache();
-        $cacheKey = sprintf('%s:%s', $this->getInput('clientid'), $this->getInput('clientsecret'));
-        $cache->setScope('SpotifyBridge');
-        $cache->setKey([$cacheKey]);
-        $token = $cache->loadData(3600);
+        $cacheKey = sprintf('SpotifyBridge:%s:%s', $this->getInput('clientid'), $this->getInput('clientsecret'));
+
+        $token = $cache->get($cacheKey);
         if ($token) {
             $this->token = $token;
         } else {
@@ -294,9 +293,8 @@ class SpotifyBridge extends BridgeAbstract
             ]);
             $data = Json::decode($json);
             $this->token = $data['access_token'];
-            $cache->setScope('SpotifyBridge');
-            $cache->setKey([$cacheKey]);
-            $cache->saveData($this->token);
+
+            $cache->set($cacheKey, $this->token, 3600);
         }
     }
 
diff --git a/bridges/TwitterBridge.php b/bridges/TwitterBridge.php
index 8470dcf7..b9586150 100644
--- a/bridges/TwitterBridge.php
+++ b/bridges/TwitterBridge.php
@@ -594,156 +594,4 @@ EOD;
     {
         return (intval($tweet1['id']) < intval($tweet2['id']) ? 1 : -1);
     }
-
-    //The aim of this function is to get an API key and a guest token
-    //This function takes 2 requests, and therefore is cached
-    private function getApiKey($forceNew = 0)
-    {
-        $r_cache = RssBridge::getCache();
-        $scope = 'TwitterBridge';
-        $r_cache->setScope($scope);
-        $r_cache->setKey(['refresh']);
-        $data = $r_cache->loadData();
-
-        $refresh = null;
-        if ($data === null) {
-            $refresh = time();
-            $r_cache->saveData($refresh);
-        } else {
-            $refresh = $data;
-        }
-
-        $cacheFactory = new CacheFactory();
-
-        $cache = RssBridge::getCache();
-        $cache->setScope($scope);
-        $cache->setKey(['api_key']);
-        $data = $cache->loadData();
-
-        $apiKey = null;
-        if ($forceNew || $data === null || (time() - $refresh) > self::GUEST_TOKEN_EXPIRY) {
-            $twitterPage = getContents('https://twitter.com');
-
-            $jsLink = false;
-            $jsMainRegexArray = [
-                '/(https:\/\/abs\.twimg\.com\/responsive-web\/web\/main\.[^\.]+\.js)/m',
-                '/(https:\/\/abs\.twimg\.com\/responsive-web\/web_legacy\/main\.[^\.]+\.js)/m',
-                '/(https:\/\/abs\.twimg\.com\/responsive-web\/client-web\/main\.[^\.]+\.js)/m',
-                '/(https:\/\/abs\.twimg\.com\/responsive-web\/client-web-legacy\/main\.[^\.]+\.js)/m',
-            ];
-            foreach ($jsMainRegexArray as $jsMainRegex) {
-                if (preg_match_all($jsMainRegex, $twitterPage, $jsMainMatches, PREG_SET_ORDER, 0)) {
-                    $jsLink = $jsMainMatches[0][0];
-                    break;
-                }
-            }
-            if (!$jsLink) {
-                returnServerError('Could not locate main.js link');
-            }
-
-            $jsContent = getContents($jsLink);
-            $apiKeyRegex = '/([a-zA-Z0-9]{59}%[a-zA-Z0-9]{44})/m';
-            preg_match_all($apiKeyRegex, $jsContent, $apiKeyMatches, PREG_SET_ORDER, 0);
-            $apiKey = $apiKeyMatches[0][0];
-            $cache->saveData($apiKey);
-        } else {
-            $apiKey = $data;
-        }
-
-        $gt_cache = RssBridge::getCache();
-        $gt_cache->setScope($scope);
-        $gt_cache->setKey(['guest_token']);
-        $guestTokenUses = $gt_cache->loadData();
-
-        $guestToken = null;
-        if (
-            $forceNew || $guestTokenUses === null || !is_array($guestTokenUses) || count($guestTokenUses) != 2
-            || $guestTokenUses[0] <= 0 || (time() - $refresh) > self::GUEST_TOKEN_EXPIRY
-        ) {
-            $guestToken = $this->getGuestToken($apiKey);
-            if ($guestToken === null) {
-                if ($guestTokenUses === null) {
-                    returnServerError('Could not parse guest token');
-                } else {
-                    $guestToken = $guestTokenUses[1];
-                }
-            } else {
-                $gt_cache->saveData([self::GUEST_TOKEN_USES, $guestToken]);
-                $r_cache->saveData(time());
-            }
-        } else {
-            $guestTokenUses[0] -= 1;
-            $gt_cache->saveData($guestTokenUses);
-            $guestToken = $guestTokenUses[1];
-        }
-
-        $this->apiKey      = $apiKey;
-        $this->guestToken  = $guestToken;
-        $this->authHeaders = [
-            'authorization: Bearer ' . $apiKey,
-            'x-guest-token: ' . $guestToken,
-        ];
-
-        return [$apiKey, $guestToken];
-    }
-
-    // Get a guest token. This is different to an API key,
-    // and it seems to change more regularly than the API key.
-    private function getGuestToken($apiKey)
-    {
-        $headers = [
-            'authorization: Bearer ' . $apiKey,
-        ];
-        $opts = [
-            CURLOPT_POST => 1,
-        ];
-
-        try {
-            $pageContent = getContents('https://api.twitter.com/1.1/guest/activate.json', $headers, $opts, true);
-            $guestToken = json_decode($pageContent['content'])->guest_token;
-        } catch (Exception $e) {
-            $guestToken = null;
-        }
-        return $guestToken;
-    }
-
-    /**
-     * Tries to make an API call to twitter.
-     * @param $api string API entry point
-     * @param $params array additional URI parmaeters
-     * @return object json data
-     */
-    private function makeApiCall($api, $params)
-    {
-        $uri = self::API_URI . $api . '?' . http_build_query($params);
-
-        $retries = 1;
-        $retry = 0;
-        do {
-            $retry = 0;
-
-            try {
-                $result = getContents($uri, $this->authHeaders, [], true);
-            } catch (HttpException $e) {
-                switch ($e->getCode()) {
-                    case 401:
-                        // fall-through
-                    case 403:
-                        if ($retries) {
-                            $retries--;
-                            $retry = 1;
-                            $this->getApiKey(1);
-                            continue 2;
-                        }
-                        // fall-through
-                    default:
-                        throw $e;
-                }
-            }
-        } while ($retry);
-
-        $data = json_decode($result['content']);
-
-        return $data;
-    }
 }
diff --git a/bridges/WordPressMadaraBridge.php b/bridges/WordPressMadaraBridge.php
index c5ff54b5..4325075c 100644
--- a/bridges/WordPressMadaraBridge.php
+++ b/bridges/WordPressMadaraBridge.php
@@ -117,7 +117,7 @@ The default URI shows the Madara demo page.';
     protected function getMangaInfo($url)
     {
         $url_cache = 'TitleInfo_' . preg_replace('/[^\w]/', '.', rtrim($url, '/'));
-        $cache = $this->loadCacheValue($url_cache, 86400);
+        $cache = $this->loadCacheValue($url_cache);
         if (isset($cache)) {
             return $cache;
         }
diff --git a/bridges/YoutubeBridge.php b/bridges/YoutubeBridge.php
index 54a38d98..8e3ac540 100644
--- a/bridges/YoutubeBridge.php
+++ b/bridges/YoutubeBridge.php
@@ -77,6 +77,138 @@ class YoutubeBridge extends BridgeAbstract
     private $channel_name = '';
     // This took from repo BetterVideoRss of VerifiedJoseph.
     const URI_REGEX = '/(https?:\/\/(?:www\.)?(?:[a-zA-Z0-9-.]{2,256}\.[a-z]{2,20})(\:[0-9]{2    ,4})?(?:\/[a-zA-Z0-9@:%_\+.,~#"\'!?&\/\/=\-*]+|\/)?)/ims'; //phpcs:ignore
+    private CacheInterface $cache;
+
+    public function __construct()
+    {
+        $this->cache = RssBridge::getCache();
+    }
+
+    private function collectDataInternal()
+    {
+        $xml = '';
+        $html = '';
+        $url_feed = '';
+        $url_listing = '';
+
+        if ($this->getInput('u')) {
+            /* User and Channel modes */
+            $this->request = $this->getInput('u');
+            $url_feed = self::URI . 'feeds/videos.xml?user=' . urlencode($this->request);
+            $url_listing = self::URI . 'user/' . urlencode($this->request) . '/videos';
+        } elseif ($this->getInput('c')) {
+            $this->request = $this->getInput('c');
+            $url_feed = self::URI . 'feeds/videos.xml?channel_id=' . urlencode($this->request);
+            $url_listing = self::URI . 'channel/' . urlencode($this->request) . '/videos';
+        } elseif ($this->getInput('custom')) {
+            $this->request = $this->getInput('custom');
+            $url_listing = self::URI . urlencode($this->request) . '/videos';
+        }
+
+        if (!empty($url_feed) || !empty($url_listing)) {
+            $this->feeduri = $url_listing;
+            if (!empty($this->getInput('custom'))) {
+                $html = $this->ytGetSimpleHTMLDOM($url_listing);
+                $jsonData = $this->getJSONData($html);
+                $url_feed = $jsonData->metadata->channelMetadataRenderer->rssUrl;
+                $this->iconURL = $jsonData->metadata->channelMetadataRenderer->avatar->thumbnails[0]->url;
+            }
+            if (!$this->skipFeeds()) {
+                $html = $this->ytGetSimpleHTMLDOM($url_feed);
+                $this->ytBridgeParseXmlFeed($html);
+            } else {
+                if (empty($this->getInput('custom'))) {
+                    $html = $this->ytGetSimpleHTMLDOM($url_listing);
+                    $jsonData = $this->getJSONData($html);
+                }
+                $channel_id = '';
+                if (isset($jsonData->contents)) {
+                    $channel_id = $jsonData->metadata->channelMetadataRenderer->externalId;
+                    $jsonData = $jsonData->contents->twoColumnBrowseResultsRenderer->tabs[1];
+                    $jsonData = $jsonData->tabRenderer->content->richGridRenderer->contents;
+                    // $jsonData = $jsonData->itemSectionRenderer->contents[0]->gridRenderer->items;
+                    $this->parseJSONListing($jsonData);
+                } else {
+                    returnServerError('Unable to get data from YouTube. Username/Channel: ' . $this->request);
+                }
+            }
+            $this->feedName = str_replace(' - YouTube', '', $html->find('title', 0)->plaintext);
+        } elseif ($this->getInput('p')) {
+            /* playlist mode */
+            // TODO: this mode makes a lot of excess video query requests.
+            // To make less requests, we need to cache following dictionary "videoId -> datePublished, duration"
+            // This cache will be used to find out, which videos to fetch
+            // to make feed of 15 items or more, if there a lot of videos published on that date.
+            $this->request = $this->getInput('p');
+            $url_feed = self::URI . 'feeds/videos.xml?playlist_id=' . urlencode($this->request);
+            $url_listing = self::URI . 'playlist?list=' . urlencode($this->request);
+            $html = $this->ytGetSimpleHTMLDOM($url_listing);
+            $jsonData = $this->getJSONData($html);
+            // TODO: this method returns only first 100 video items
+            // if it has more videos, playlistVideoListRenderer will have continuationItemRenderer as last element
+            $jsonData = $jsonData->contents->twoColumnBrowseResultsRenderer->tabs[0];
+            $jsonData = $jsonData->tabRenderer->content->sectionListRenderer->contents[0]->itemSectionRenderer;
+            $jsonData = $jsonData->contents[0]->playlistVideoListRenderer->contents;
+            $item_count = count($jsonData);
+
+            if ($item_count <= 15 && !$this->skipFeeds() && ($xml = $this->ytGetSimpleHTMLDOM($url_feed))) {
+                $this->ytBridgeParseXmlFeed($xml);
+            } else {
+                $this->parseJSONListing($jsonData);
+            }
+            $this->feedName = 'Playlist: ' . str_replace(' - YouTube', '', $html->find('title', 0)->plaintext);
+            usort($this->items, function ($item1, $item2) {
+                if (!is_int($item1['timestamp']) && !is_int($item2['timestamp'])) {
+                    $item1['timestamp'] = strtotime($item1['timestamp']);
+                    $item2['timestamp'] = strtotime($item2['timestamp']);
+                }
+                return $item2['timestamp'] - $item1['timestamp'];
+            });
+        } elseif ($this->getInput('s')) {
+            /* search mode */
+            $this->request = $this->getInput('s');
+            $url_listing = self::URI
+                . 'results?search_query='
+                . urlencode($this->request)
+                . '&sp=CAI%253D';
+
+            $html = $this->ytGetSimpleHTMLDOM($url_listing);
+
+            $jsonData = $this->getJSONData($html);
+            $jsonData = $jsonData->contents->twoColumnSearchResultsRenderer->primaryContents;
+            $jsonData = $jsonData->sectionListRenderer->contents;
+            foreach ($jsonData as $data) {
+                // Search result includes some ads, have to filter them
+                if (isset($data->itemSectionRenderer->contents[0]->videoRenderer)) {
+                    $jsonData = $data->itemSectionRenderer->contents;
+                    break;
+                }
+            }
+            $this->parseJSONListing($jsonData);
+            $this->feeduri = $url_listing;
+            $this->feedName = 'Search: ' . $this->request;
+        } else {
+            /* no valid mode */
+            returnClientError("You must either specify either:\n - YouTube
+ username (?u=...)\n - Channel id (?c=...)\n - Playlist id (?p=...)\n - Search (?s=...)");
+        }
+    }
+
+    public function collectData()
+    {
+        $cacheKey = 'youtube_rate_limit';
+        if ($this->cache->get($cacheKey)) {
+            throw new HttpException('429 Too Many Requests', 429);
+        }
+        try {
+            $this->collectDataInternal();
+        } catch (HttpException $e) {
+            if ($e->getCode() === 429) {
+                $this->cache->set($cacheKey, true, 60 * 16);
+                throw $e;
+            }
+        }
+    }
 
     private function ytBridgeQueryVideoInfo($vid, &$author, &$desc, &$time)
     {
@@ -153,7 +285,8 @@ class YoutubeBridge extends BridgeAbstract
         $item['timestamp'] = $time;
         $item['uri'] = self::URI . 'watch?v=' . $vid;
         if (!$thumbnail) {
-            $thumbnail = '0';   // Fallback to default thumbnail if there aren't any provided.
+            // Fallback to default thumbnail if there aren't any provided.
+            $thumbnail = '0';
         }
         $thumbnailUri = str_replace('/www.', '/img.', self::URI) . 'vi/' . $vid . '/' . $thumbnail . '.jpg';
         $item['content'] = '<a href="' . $item['uri'] . '"><img src="' . $thumbnailUri . '" /></a><br />' . $desc;
@@ -315,111 +448,6 @@ class YoutubeBridge extends BridgeAbstract
         }
     }
 
-    public function collectData()
-    {
-        $xml = '';
-        $html = '';
-        $url_feed = '';
-        $url_listing = '';
-
-        if ($this->getInput('u')) { /* User and Channel modes */
-            $this->request = $this->getInput('u');
-            $url_feed = self::URI . 'feeds/videos.xml?user=' . urlencode($this->request);
-            $url_listing = self::URI . 'user/' . urlencode($this->request) . '/videos';
-        } elseif ($this->getInput('c')) {
-            $this->request = $this->getInput('c');
-            $url_feed = self::URI . 'feeds/videos.xml?channel_id=' . urlencode($this->request);
-            $url_listing = self::URI . 'channel/' . urlencode($this->request) . '/videos';
-        } elseif ($this->getInput('custom')) {
-            $this->request = $this->getInput('custom');
-            $url_listing = self::URI . urlencode($this->request) . '/videos';
-        }
-
-        if (!empty($url_feed) || !empty($url_listing)) {
-            $this->feeduri = $url_listing;
-            if (!empty($this->getInput('custom'))) {
-                $html = $this->ytGetSimpleHTMLDOM($url_listing);
-                $jsonData = $this->getJSONData($html);
-                $url_feed = $jsonData->metadata->channelMetadataRenderer->rssUrl;
-                $this->iconURL = $jsonData->metadata->channelMetadataRenderer->avatar->thumbnails[0]->url;
-            }
-            if (!$this->skipFeeds()) {
-                $html = $this->ytGetSimpleHTMLDOM($url_feed);
-                $this->ytBridgeParseXmlFeed($html);
-            } else {
-                if (empty($this->getInput('custom'))) {
-                    $html = $this->ytGetSimpleHTMLDOM($url_listing);
-                    $jsonData = $this->getJSONData($html);
-                }
-                $channel_id = '';
-                if (isset($jsonData->contents)) {
-                    $channel_id = $jsonData->metadata->channelMetadataRenderer->externalId;
-                    $jsonData = $jsonData->contents->twoColumnBrowseResultsRenderer->tabs[1];
-                    $jsonData = $jsonData->tabRenderer->content->richGridRenderer->contents;
-                    // $jsonData = $jsonData->itemSectionRenderer->contents[0]->gridRenderer->items;
-                    $this->parseJSONListing($jsonData);
-                } else {
-                    returnServerError('Unable to get data from YouTube. Username/Channel: ' . $this->request);
-                }
-            }
-            $this->feedName = str_replace(' - YouTube', '', $html->find('title', 0)->plaintext);
-        } elseif ($this->getInput('p')) { /* playlist mode */
-            // TODO: this mode makes a lot of excess video query requests.
-            // To make less requests, we need to cache following dictionary "videoId -> datePublished, duration"
-            // This cache will be used to find out, which videos to fetch
-            // to make feed of 15 items or more, if there a lot of videos published on that date.
-            $this->request = $this->getInput('p');
-            $url_feed = self::URI . 'feeds/videos.xml?playlist_id=' . urlencode($this->request);
-            $url_listing = self::URI . 'playlist?list=' . urlencode($this->request);
-            $html = $this->ytGetSimpleHTMLDOM($url_listing);
-            $jsonData = $this->getJSONData($html);
-            // TODO: this method returns only first 100 video items
-            // if it has more videos, playlistVideoListRenderer will have continuationItemRenderer as last element
-            $jsonData = $jsonData->contents->twoColumnBrowseResultsRenderer->tabs[0];
-            $jsonData = $jsonData->tabRenderer->content->sectionListRenderer->contents[0]->itemSectionRenderer;
-            $jsonData = $jsonData->contents[0]->playlistVideoListRenderer->contents;
-            $item_count = count($jsonData);
-
-            if ($item_count <= 15 && !$this->skipFeeds() && ($xml = $this->ytGetSimpleHTMLDOM($url_feed))) {
-                $this->ytBridgeParseXmlFeed($xml);
-            } else {
-                $this->parseJSONListing($jsonData);
-            }
-            $this->feedName = 'Playlist: ' . str_replace(' - YouTube', '', $html->find('title', 0)->plaintext); // feedName will be used by getName()
-            usort($this->items, function ($item1, $item2) {
-                if (!is_int($item1['timestamp']) && !is_int($item2['timestamp'])) {
-                    $item1['timestamp'] = strtotime($item1['timestamp']);
-                    $item2['timestamp'] = strtotime($item2['timestamp']);
-                }
-                return $item2['timestamp'] - $item1['timestamp'];
-            });
-        } elseif ($this->getInput('s')) { /* search mode */
-            $this->request = $this->getInput('s');
-            $url_listing = self::URI
-            . 'results?search_query='
-            . urlencode($this->request)
-            . '&sp=CAI%253D';
-
-            $html = $this->ytGetSimpleHTMLDOM($url_listing);
-
-            $jsonData = $this->getJSONData($html);
-            $jsonData = $jsonData->contents->twoColumnSearchResultsRenderer->primaryContents;
-            $jsonData = $jsonData->sectionListRenderer->contents;
-            foreach ($jsonData as $data) {   // Search result includes some ads, have to filter them
-                if (isset($data->itemSectionRenderer->contents[0]->videoRenderer)) {
-                    $jsonData = $data->itemSectionRenderer->contents;
-                    break;
-                }
-            }
-            $this->parseJSONListing($jsonData);
-            $this->feeduri = $url_listing;
-            $this->feedName = 'Search: ' . $this->request; // feedName will be used by getName()
-        } else { /* no valid mode */
-            returnClientError("You must either specify either:\n - YouTube
- username (?u=...)\n - Channel id (?c=...)\n - Playlist id (?p=...)\n - Search (?s=...)");
-        }
-    }
-
     private function skipFeeds()
     {
         return ($this->getInput('duration_min') || $this->getInput('duration_max'));
@@ -438,14 +466,13 @@ class YoutubeBridge extends BridgeAbstract
 
     public function getName()
     {
-        // Name depends on queriedContext:
         switch ($this->queriedContext) {
             case 'By username':
             case 'By channel id':
             case 'By custom name':
             case 'By playlist Id':
             case 'Search result':
-                return htmlspecialchars_decode($this->feedName) . ' - YouTube'; // We already know it's a bridge, right?
+                return htmlspecialchars_decode($this->feedName) . ' - YouTube';
             default:
                 return parent::getName();
         }
diff --git a/caches/ArrayCache.php b/caches/ArrayCache.php
new file mode 100644
index 00000000..efce4f35
--- /dev/null
+++ b/caches/ArrayCache.php
@@ -0,0 +1,52 @@
+<?php
+
+declare(strict_types=1);
+
+class ArrayCache implements CacheInterface
+{
+    private array $data = [];
+
+    public function get(string $key, $default = null)
+    {
+        $item = $this->data[$key] ?? null;
+        if (!$item) {
+            return $default;
+        }
+        $expiration = $item['expiration'];
+        if ($expiration === 0 || $expiration > time()) {
+            return $item['value'];
+        }
+        $this->delete($key);
+        return $default;
+    }
+
+    public function set(string $key, $value, int $ttl = null): void
+    {
+        $this->data[$key] = [
+            'key'           => $key,
+            'value'         => $value,
+            'expiration'    => $ttl === null ? 0 : time() + $ttl,
+        ];
+    }
+
+    public function delete(string $key): void
+    {
+        unset($this->data[$key]);
+    }
+
+    public function clear(): void
+    {
+        $this->data = [];
+    }
+
+    public function prune(): void
+    {
+        foreach ($this->data as $key => $item) {
+            $expiration = $item['expiration'];
+            if ($expiration === 0 || $expiration > time()) {
+                continue;
+            }
+            $this->delete($key);
+        }
+    }
+}
diff --git a/caches/FileCache.php b/caches/FileCache.php
index 6e150cb4..1495971a 100644
--- a/caches/FileCache.php
+++ b/caches/FileCache.php
@@ -1,13 +1,10 @@
 <?php
 
-/**
- * @link https://www.php.net/manual/en/function.clearstatcache.php
- */
+declare(strict_types=1);
+
 class FileCache implements CacheInterface
 {
     private array $config;
-    protected string $scope;
-    protected string $key;
 
     public function __construct(array $config = [])
     {
@@ -23,125 +20,89 @@ class FileCache implements CacheInterface
         $this->config['path'] = rtrim($this->config['path'], '/') . '/';
     }
 
-    public function getConfig()
+    public function get(string $key, $default = null)
     {
-        return $this->config;
+        $cacheFile = $this->createCacheFile($key);
+        if (!file_exists($cacheFile)) {
+            return $default;
+        }
+        $item = unserialize(file_get_contents($cacheFile));
+        if ($item === false) {
+            Logger::warning(sprintf('Failed to unserialize: %s', $cacheFile));
+            $this->delete($key);
+            return $default;
+        }
+        $expiration = $item['expiration'];
+        if ($expiration === 0 || $expiration > time()) {
+            return $item['value'];
+        }
+        $this->delete($key);
+        return $default;
     }
 
-    public function loadData(int $timeout = 86400)
+    public function set($key, $value, int $ttl = null): void
     {
-        clearstatcache();
-        if (!file_exists($this->getCacheFile())) {
-            return null;
-        }
-        $modificationTime = filemtime($this->getCacheFile());
-        if (time() - $timeout < $modificationTime) {
-            $data = unserialize(file_get_contents($this->getCacheFile()));
-            if ($data === false) {
-                Logger::warning(sprintf('Failed to unserialize: %s', $this->getCacheFile()));
-                // Intentionally not throwing an exception
-                return null;
-            }
-            return $data;
-        }
-        // It's a good idea to delete the expired item here, but commented out atm
-        // unlink($this->getCacheFile());
-        return null;
-    }
-
-    public function saveData($data): void
-    {
-        $bytes = file_put_contents($this->getCacheFile(), serialize($data), LOCK_EX);
+        $item = [
+            'key'           => $key,
+            'value'         => $value,
+            'expiration'    => $ttl === null ? 0 : time() + $ttl,
+        ];
+        $cacheFile = $this->createCacheFile($key);
+        $bytes = file_put_contents($cacheFile, serialize($item), LOCK_EX);
         if ($bytes === false) {
-            throw new \Exception(sprintf('Failed to write to: %s', $this->getCacheFile()));
+            // Consider just logging the error here
+            throw new \Exception(sprintf('Failed to write to: %s', $cacheFile));
         }
     }
 
-    public function getTime(): ?int
+    public function delete(string $key): void
     {
-        clearstatcache();
-        $cacheFile = $this->getCacheFile();
-        if (file_exists($cacheFile)) {
-            $time = filemtime($cacheFile);
-            if ($time !== false) {
-                return $time;
-            }
-            return null;
-        }
-
-        return null;
+        unlink($this->createCacheFile($key));
     }
 
-    public function purgeCache(int $timeout = 86400): void
+    public function clear(): void
+    {
+        foreach (scandir($this->config['path']) as $filename) {
+            $cacheFile = $this->config['path'] . $filename;
+            $excluded = ['.' => true, '..' => true, '.gitkeep' => true];
+            if (isset($excluded[$filename]) || !is_file($cacheFile)) {
+                continue;
+            }
+            unlink($cacheFile);
+        }
+    }
+
+    public function prune(): void
     {
         if (! $this->config['enable_purge']) {
             return;
         }
-
-        $cachePath = $this->getScope();
-        if (!file_exists($cachePath)) {
-            return;
-        }
-        $cacheIterator = new \RecursiveIteratorIterator(
-            new \RecursiveDirectoryIterator($cachePath),
-            \RecursiveIteratorIterator::CHILD_FIRST
-        );
-
-        foreach ($cacheIterator as $cacheFile) {
-            $basename = $cacheFile->getBasename();
-            $excluded = [
-                '.'         => true,
-                '..'        => true,
-                '.gitkeep'  => true,
-            ];
-            if (isset($excluded[$basename])) {
+        foreach (scandir($this->config['path']) as $filename) {
+            $cacheFile = $this->config['path'] . $filename;
+            $excluded = ['.' => true, '..' => true, '.gitkeep' => true];
+            if (isset($excluded[$filename]) || !is_file($cacheFile)) {
                 continue;
-            } elseif ($cacheFile->isFile()) {
-                $filepath = $cacheFile->getPathname();
-                if (filemtime($filepath) < time() - $timeout) {
-                    // todo: sometimes this file doesn't exists
-                    unlink($filepath);
-                }
             }
-        }
-    }
-
-    public function setScope(string $scope): void
-    {
-        $this->scope = $this->config['path'] . trim($scope, " \t\n\r\0\x0B\\\/") . '/';
-    }
-
-    public function setKey(array $key): void
-    {
-        $this->key = json_encode($key);
-    }
-
-    private function getScope()
-    {
-        if (is_null($this->scope)) {
-            throw new \Exception('Call "setScope" first!');
-        }
-
-        if (!is_dir($this->scope)) {
-            if (mkdir($this->scope, 0755, true) !== true) {
-                throw new \Exception('mkdir: Unable to create file cache folder');
+            $item = unserialize(file_get_contents($cacheFile));
+            if ($item === false) {
+                unlink($cacheFile);
+                continue;
             }
+            $expiration = $item['expiration'];
+            if ($expiration === 0 || $expiration > time()) {
+                continue;
+            }
+            unlink($cacheFile);
         }
-
-        return $this->scope;
     }
 
-    private function getCacheFile()
+    private function createCacheFile(string $key): string
     {
-        return $this->getScope() . $this->getCacheName();
+        return $this->config['path'] . hash('md5', $key) . '.cache';
     }
 
-    private function getCacheName()
+    public function getConfig()
     {
-        if (is_null($this->key)) {
-            throw new \Exception('Call "setKey" first!');
-        }
-
-        return hash('md5', $this->key) . '.cache';
+        return $this->config;
     }
 }
diff --git a/caches/MemcachedCache.php b/caches/MemcachedCache.php
index dcb572c7..78035435 100644
--- a/caches/MemcachedCache.php
+++ b/caches/MemcachedCache.php
@@ -1,70 +1,36 @@
 <?php
 
+declare(strict_types=1);
+
 class MemcachedCache implements CacheInterface
 {
-    private string $scope;
-    private string $key;
-    private $conn;
-    private $expiration = 0;
+    private \Memcached $conn;
 
-    public function __construct()
+    public function __construct(string $host, int $port)
     {
-        if (!extension_loaded('memcached')) {
-            throw new \Exception('"memcached" extension not loaded. Please check "php.ini"');
+        $this->conn = new \Memcached();
+        // This call does not actually connect to server yet
+        if (!$this->conn->addServer($host, $port)) {
+            throw new \Exception('Unable to add memcached server');
         }
-
-        $section = 'MemcachedCache';
-        $host = Configuration::getConfig($section, 'host');
-        $port = Configuration::getConfig($section, 'port');
-
-        if (empty($host) && empty($port)) {
-            throw new \Exception('Configuration for ' . $section . ' missing.');
-        }
-        if (empty($host)) {
-            throw new \Exception('"host" param is not set for ' . $section);
-        }
-        if (empty($port)) {
-            throw new \Exception('"port" param is not set for ' . $section);
-        }
-        if (!ctype_digit($port)) {
-            throw new \Exception('"port" param is invalid for ' . $section);
-        }
-
-        $port = intval($port);
-
-        if ($port < 1 || $port > 65535) {
-            throw new \Exception('"port" param is invalid for ' . $section);
-        }
-
-        $conn = new \Memcached();
-        $conn->addServer($host, $port) or returnServerError('Could not connect to memcached server');
-        $this->conn = $conn;
     }
 
-    public function loadData(int $timeout = 86400)
+    public function get(string $key, $default = null)
     {
-        $value = $this->conn->get($this->getCacheKey());
+        $value = $this->conn->get($key);
         if ($value === false) {
-            return null;
+            return $default;
         }
-        if (time() - $timeout < $value['time']) {
-            return $value['data'];
-        }
-        return null;
+        return $value;
     }
 
-    public function saveData($data): void
+    public function set(string $key, $value, $ttl = null): void
     {
-        $value = [
-            'data' => $data,
-            'time' => time(),
-        ];
-        $result = $this->conn->set($this->getCacheKey(), $value, $this->expiration);
+        $expiration = $ttl === null ? 0 : time() + $ttl;
+        $result = $this->conn->set($key, $value, $expiration);
         if ($result === false) {
             Logger::warning('Failed to store an item in memcached', [
-                'scope'         => $this->scope,
-                'key'           => $this->key,
-                'expiration'    => $this->expiration,
+                'key'           => $key,
                 'code'          => $this->conn->getLastErrorCode(),
                 'message'       => $this->conn->getLastErrorMessage(),
                 'number'        => $this->conn->getLastErrorErrno(),
@@ -73,38 +39,18 @@ class MemcachedCache implements CacheInterface
         }
     }
 
-    public function getTime(): ?int
+    public function delete(string $key): void
     {
-        $value = $this->conn->get($this->getCacheKey());
-        if ($value === false) {
-            return null;
-        }
-        return $value['time'];
+        $this->conn->delete($key);
     }
 
-    public function purgeCache(int $timeout = 86400): void
+    public function clear(): void
     {
-        // Note: does not purges cache right now
-        // Just sets cache expiration and leave cache purging for memcached itself
-        $this->expiration = $timeout;
+        $this->conn->flush();
     }
 
-    public function setScope(string $scope): void
+    public function prune(): void
     {
-        $this->scope = $scope;
-    }
-
-    public function setKey(array $key): void
-    {
-        $this->key = json_encode($key);
-    }
-
-    private function getCacheKey()
-    {
-        if (is_null($this->key)) {
-            throw new \Exception('Call "setKey" first!');
-        }
-
-        return 'rss_bridge_cache_' . hash('md5', $this->scope . $this->key . 'A');
+        // memcached manages pruning on its own
     }
 }
diff --git a/caches/NullCache.php b/caches/NullCache.php
index fe43fe06..2549b117 100644
--- a/caches/NullCache.php
+++ b/caches/NullCache.php
@@ -4,28 +4,24 @@ declare(strict_types=1);
 
 class NullCache implements CacheInterface
 {
-    public function setScope(string $scope): void
+    public function get(string $key, $default = null)
+    {
+        return $default;
+    }
+
+    public function set(string $key, $value, int $ttl = null): void
     {
     }
 
-    public function setKey(array $key): void
+    public function delete(string $key): void
     {
     }
 
-    public function loadData(int $timeout = 86400)
+    public function clear(): void
     {
     }
 
-    public function saveData($data): void
-    {
-    }
-
-    public function getTime(): ?int
-    {
-        return null;
-    }
-
-    public function purgeCache(int $timeout = 86400): void
+    public function prune(): void
     {
     }
 }
diff --git a/caches/SQLiteCache.php b/caches/SQLiteCache.php
index 92235862..beb33e88 100644
--- a/caches/SQLiteCache.php
+++ b/caches/SQLiteCache.php
@@ -1,10 +1,10 @@
 <?php
 
+declare(strict_types=1);
+
 class SQLiteCache implements CacheInterface
 {
     private \SQLite3 $db;
-    private string $scope;
-    private string $key;
     private array $config;
 
     public function __construct(array $config)
@@ -31,85 +31,77 @@ class SQLiteCache implements CacheInterface
             $this->db->exec("CREATE TABLE storage ('key' BLOB PRIMARY KEY, 'value' BLOB, 'updated' INTEGER)");
         }
         $this->db->busyTimeout($config['timeout']);
+        // https://www.sqlite.org/pragma.html#pragma_journal_mode
+        $this->db->exec('PRAGMA journal_mode = wal');
+        // https://www.sqlite.org/pragma.html#pragma_synchronous
+        $this->db->exec('PRAGMA synchronous = NORMAL');
     }
 
-    public function loadData(int $timeout = 86400)
+    public function get(string $key, $default = null)
     {
+        $cacheKey = $this->createCacheKey($key);
         $stmt = $this->db->prepare('SELECT value, updated FROM storage WHERE key = :key');
-        $stmt->bindValue(':key', $this->getCacheKey());
+        $stmt->bindValue(':key', $cacheKey);
         $result = $stmt->execute();
         if (!$result) {
-            return null;
+            return $default;
         }
         $row = $result->fetchArray(\SQLITE3_ASSOC);
         if ($row === false) {
-            return null;
+            return $default;
         }
-        $value = $row['value'];
-        $modificationTime = $row['updated'];
-        if (time() - $timeout < $modificationTime) {
-            $data = unserialize($value);
-            if ($data === false) {
-                Logger::error(sprintf("Failed to unserialize: '%s'", mb_substr($value, 0, 100)));
-                return null;
+        $expiration = $row['updated'];
+        if ($expiration === 0 || $expiration > time()) {
+            $blob = $row['value'];
+            $value = unserialize($blob);
+            if ($value === false) {
+                Logger::error(sprintf("Failed to unserialize: '%s'", mb_substr($blob, 0, 100)));
+                // delete?
+                return $default;
             }
-            return $data;
+            return $value;
         }
-        // It's a good idea to delete expired cache items.
-        // However I'm seeing lots of  SQLITE_BUSY errors so commented out for now
-        // $stmt = $this->db->prepare('DELETE FROM storage WHERE key = :key');
-        // $stmt->bindValue(':key', $this->getCacheKey());
-        // $stmt->execute();
-        return null;
+        // delete?
+        return $default;
     }
-
-    public function saveData($data): void
+    public function set(string $key, $value, int $ttl = null): void
     {
-        $blob = serialize($data);
-
+        $cacheKey = $this->createCacheKey($key);
+        $blob = serialize($value);
+        $expiration = $ttl === null ? 0 : time() + $ttl;
         $stmt = $this->db->prepare('INSERT OR REPLACE INTO storage (key, value, updated) VALUES (:key, :value, :updated)');
-        $stmt->bindValue(':key', $this->getCacheKey());
+        $stmt->bindValue(':key', $cacheKey);
         $stmt->bindValue(':value', $blob, \SQLITE3_BLOB);
-        $stmt->bindValue(':updated', time());
-        $stmt->execute();
-    }
-
-    public function getTime(): ?int
-    {
-        $stmt = $this->db->prepare('SELECT updated FROM storage WHERE key = :key');
-        $stmt->bindValue(':key', $this->getCacheKey());
+        $stmt->bindValue(':updated', $expiration);
         $result = $stmt->execute();
-        if ($result) {
-            $row = $result->fetchArray(\SQLITE3_ASSOC);
-            if ($row !== false) {
-                return $row['updated'];
-            }
-        }
-        return null;
+        // Unclear whether we should $result->finalize(); here?
     }
 
-    public function purgeCache(int $timeout = 86400): void
+    public function delete(string $key): void
+    {
+        $key = $this->createCacheKey($key);
+        $stmt = $this->db->prepare('DELETE FROM storage WHERE key = :key');
+        $stmt->bindValue(':key', $key);
+        $result = $stmt->execute();
+    }
+
+    public function prune(): void
     {
         if (!$this->config['enable_purge']) {
             return;
         }
-        $stmt = $this->db->prepare('DELETE FROM storage WHERE updated < :expired');
-        $stmt->bindValue(':expired', time() - $timeout);
-        $stmt->execute();
+        $stmt = $this->db->prepare('DELETE FROM storage WHERE updated <= :now');
+        $stmt->bindValue(':now', time());
+        $result = $stmt->execute();
     }
 
-    public function setScope(string $scope): void
+    public function clear(): void
     {
-        $this->scope = $scope;
+        $this->db->query('DELETE FROM storage');
     }
 
-    public function setKey(array $key): void
+    private function createCacheKey($key)
     {
-        $this->key = json_encode($key);
-    }
-
-    private function getCacheKey()
-    {
-        return hash('sha1', $this->scope . $this->key, true);
+        return hash('sha1', $key, true);
     }
 }
diff --git a/config.default.ini.php b/config.default.ini.php
index d0c508f4..52786aef 100644
--- a/config.default.ini.php
+++ b/config.default.ini.php
@@ -55,7 +55,7 @@ max_filesize = 20
 
 [cache]
 
-; Cache type: file, sqlite, memcached, null
+; Cache type: file, sqlite, memcached, array, null
 type = "file"
 
 ; Allow users to specify custom timeout for specific requests.
diff --git a/contrib/prepare_release/fetch_contributors.php b/contrib/prepare_release/fetch_contributors.php
index cfe2c5b2..dd99229f 100644
--- a/contrib/prepare_release/fetch_contributors.php
+++ b/contrib/prepare_release/fetch_contributors.php
@@ -15,14 +15,17 @@ while ($next) { /* Collect all contributors */
         'User-Agent' => 'RSS-Bridge',
     ];
     $httpClient = new CurlHttpClient();
-    $result = $httpClient->request($url, ['headers' => $headers]);
+    $response = $httpClient->request($url, ['headers' => $headers]);
 
-    foreach (json_decode($result['body']) as $contributor) {
+    $json = $response->getBody();
+    $json_decode = Json::decode($json, false);
+    foreach ($json_decode as $contributor) {
         $contributors[] = $contributor;
     }
 
     // Extract links to "next", "last", etc...
-    $links = explode(',', $result['headers']['link'][0]);
+    $link1 = $response->getHeader('link');
+    $links = explode(',', $link1);
     $next = false;
 
     // Check if there is a link with 'rel="next"'
diff --git a/docs/06_Helper_functions/index.md b/docs/06_Helper_functions/index.md
index 2f0c513c..31a13953 100644
--- a/docs/06_Helper_functions/index.md
+++ b/docs/06_Helper_functions/index.md
@@ -5,10 +5,12 @@ The `getInput` function is used to receive a value for a parameter, specified in
 $this->getInput('your input name here');
 ```
 
-`getInput` will either return the value for your parameter or `null` if the parameter is unknown or not specified.
+`getInput` will either return the value for your parameter
+or `null` if the parameter is unknown or not specified.
 
 # getKey
-The `getKey` function is used to receive the key name to a selected list value given the name of the list, specified in `const PARAMETERS`
+The `getKey` function is used to receive the key name to a selected list
+value given the name of the list, specified in `const PARAMETERS`
 Is able to work with multidimensional list arrays.
 
 ```PHP
@@ -34,7 +36,8 @@ $this->getKey('country');
 // if the selected value was "ve", this function will return "Venezuela"
 ```
 
-`getKey` will either return the key name for your parameter or `null` if the parameter is unknown or not specified.
+`getKey` will either return the key name for your parameter or `null` if the parameter
+is unknown or not specified.
 
 # getContents
 The `getContents` function uses [cURL](https://secure.php.net/manual/en/book.curl.php) to acquire data from the specified URI while respecting the various settings defined at a global level by RSS-Bridge (i.e., proxy host, user agent, etc.). This function accepts a few parameters:
@@ -53,33 +56,29 @@ $html = getContents($url, $header, $opts);
 ```
 
 # getSimpleHTMLDOM
-The `getSimpleHTMLDOM` function is a wrapper for the [simple_html_dom](https://simplehtmldom.sourceforge.io/) [file_get_html](https://simplehtmldom.sourceforge.io/docs/1.9/api/file_get_html/) function in order to provide context by design.
+The `getSimpleHTMLDOM` function is a wrapper for the 
+[simple_html_dom](https://simplehtmldom.sourceforge.io/) [file_get_html](https://simplehtmldom.sourceforge.io/docs/1.9/api/file_get_html/) function in order to provide context by design.
 
 ```PHP
 $html = getSimpleHTMLDOM('your URI');
 ```
 # getSimpleHTMLDOMCached
-The `getSimpleHTMLDOMCached` function does the same as the [`getSimpleHTMLDOM`](#getsimplehtmldom) function, except that the content received for the given URI is stored in a cache and loaded from cache on the next request if the specified cache duration was not reached. Use this function for data that is very unlikely to change between consecutive requests to **RSS-Bridge**. This function allows to specify the cache duration with the second parameter (default is 24 hours / 86400 seconds).
+The `getSimpleHTMLDOMCached` function does the same as the 
+[`getSimpleHTMLDOM`](#getsimplehtmldom) function,
+except that the content received for the given URI is stored in a cache
+and loaded from cache on the next request if the specified cache duration
+was not reached.
+
+Use this function for data that is very unlikely to change between consecutive requests to **RSS-Bridge**.
+This function allows to specify the cache duration with the second parameter.
 
 ```PHP
 $html = getSimpleHTMLDOMCached('your URI', 86400); // Duration 24h
 ```
 
-**Notice:** Due to the current implementation a value greater than 86400 seconds (24 hours) will not work as the cache is purged every 24 hours automatically.
-
-# returnError
-**Notice:** Whenever possible make use of [`returnClientError`](#returnclienterror) or [`returnServerError`](#returnservererror)
-
-The `returnError` function aborts execution of the current bridge and returns the given error message with the provided error number:
-
-```PHP
-returnError('Your error message', 404);
-```
-
-Check the [list of error codes](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes) for applicable error numbers.
-
 # returnClientError
-The `returnClientError` function aborts execution of the current bridge and returns the given error message with error code **400**:
+The `returnClientError` function aborts execution of the current bridge
+and returns the given error message with error code **400**:
 
 ```PHP
 returnClientError('Your error message')
@@ -94,10 +93,12 @@ The `returnServerError` function aborts execution of the current bridge and retu
 returnServerError('Your error message')
 ```
 
-Use this function when a problem occurs that has nothing to do with the parameters provided by the user. (like: Host service gone missing, empty data received, etc...)
+Use this function when a problem occurs that has nothing to do with the parameters provided by the user.
+(like: Host service gone missing, empty data received, etc...)
 
 # defaultLinkTo
-Automatically replaces any relative URL in a given string or DOM object (i.e. the one returned by [getSimpleHTMLDOM](#getsimplehtmldom)) with an absolute URL.
+Automatically replaces any relative URL in a given string or DOM object
+(i.e. the one returned by [getSimpleHTMLDOM](#getsimplehtmldom)) with an absolute URL.
 
 ```php
 defaultLinkTo ( mixed $content, string $server ) : object
diff --git a/docs/07_Cache_API/02_CacheInterface.md b/docs/07_Cache_API/02_CacheInterface.md
index 61127a0d..3e71237d 100644
--- a/docs/07_Cache_API/02_CacheInterface.md
+++ b/docs/07_Cache_API/02_CacheInterface.md
@@ -3,16 +3,14 @@ See `CacheInterface`.
 ```php
 interface CacheInterface
 {
-    public function setScope(string $scope): void;
+    public function get(string $key, $default = null);
 
-    public function setKey(array $key): void;
+    public function set(string $key, $value, int $ttl = null): void;
 
-    public function loadData();
+    public function delete(string $key): void;
 
-    public function saveData($data): void;
+    public function clear(): void;
 
-    public function getTime(): ?int;
-
-    public function purgeCache(int $seconds): void;
+    public function prune(): void;
 }
-```
\ No newline at end of file
+```
diff --git a/docs/index.md b/docs/index.md
index 71fa9f37..c370cb1b 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,4 +1,8 @@
-**RSS-Bridge** is free and open source software for generating Atom or RSS feeds from websites which don't have one. It is written in PHP and intended to run on a Web server. See the [Screenshots](01_General/04_Screenshots.md) for a quick introduction to **RSS-Bridge**
+RSS-Bridge is a web application.
+
+It generates web feeds for websites that don't have one.
+
+Officially hosted instance: https://rss-bridge.org/bridge01/
 
   - You want to know more about **RSS-Bridge**?  
 Check out our **[project goals](01_General/01_Project-goals.md)**.
diff --git a/index.php b/index.php
index 538f1c6e..9181c0b0 100644
--- a/index.php
+++ b/index.php
@@ -1,5 +1,9 @@
 <?php
 
+if (version_compare(\PHP_VERSION, '7.4.0') === -1) {
+    exit('RSS-Bridge requires minimum PHP version 7.4.0!');
+}
+
 require_once __DIR__ . '/lib/bootstrap.php';
 
 $rssBridge = new RssBridge();
diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index 2a6cd8ab..36a77669 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -116,6 +116,10 @@ abstract class BridgeAbstract implements BridgeInterface
      */
     private array $configuration = [];
 
+    public function __construct()
+    {
+    }
+
     /** {@inheritdoc} */
     public function getItems()
     {
@@ -410,15 +414,13 @@ abstract class BridgeAbstract implements BridgeInterface
     /**
      * Loads a cached value for the specified key
      *
-     * @param int $timeout Cache duration (optional)
      * @return mixed Cached value or null if the key doesn't exist or has expired
      */
-    protected function loadCacheValue(string $key, int $timeout = 86400)
+    protected function loadCacheValue(string $key)
     {
         $cache = RssBridge::getCache();
-        $cache->setScope($this->getShortName());
-        $cache->setKey([$key]);
-        return $cache->loadData($timeout);
+        $cacheKey = $this->getShortName() . '_' . $key;
+        return $cache->get($cacheKey);
     }
 
     /**
@@ -426,12 +428,11 @@ abstract class BridgeAbstract implements BridgeInterface
      *
      * @param mixed $value Value to cache
      */
-    protected function saveCacheValue(string $key, $value)
+    protected function saveCacheValue(string $key, $value, $ttl = 86400)
     {
         $cache = RssBridge::getCache();
-        $cache->setScope($this->getShortName());
-        $cache->setKey([$key]);
-        $cache->saveData($value);
+        $cacheKey = $this->getShortName() . '_' . $key;
+        $cache->set($cacheKey, $value, $ttl);
     }
 
     public function getShortName(): string
diff --git a/lib/BridgeInterface.php b/lib/BridgeInterface.php
index 977ad7f6..63bc7b70 100644
--- a/lib/BridgeInterface.php
+++ b/lib/BridgeInterface.php
@@ -57,6 +57,8 @@ interface BridgeInterface
 {
     /**
      * Collects data from the site
+     *
+     * @return void
      */
     public function collectData();
 
diff --git a/lib/CacheFactory.php b/lib/CacheFactory.php
index 78a0e83e..3f076d83 100644
--- a/lib/CacheFactory.php
+++ b/lib/CacheFactory.php
@@ -72,7 +72,29 @@ class CacheFactory
                     'enable_purge'  => Configuration::getConfig('SQLiteCache', 'enable_purge'),
                 ]);
             case MemcachedCache::class:
-                return new MemcachedCache();
+                if (!extension_loaded('memcached')) {
+                    throw new \Exception('"memcached" extension not loaded. Please check "php.ini"');
+                }
+                $section = 'MemcachedCache';
+                $host = Configuration::getConfig($section, 'host');
+                $port = Configuration::getConfig($section, 'port');
+                if (empty($host) && empty($port)) {
+                    throw new \Exception('Configuration for ' . $section . ' missing.');
+                }
+                if (empty($host)) {
+                    throw new \Exception('"host" param is not set for ' . $section);
+                }
+                if (empty($port)) {
+                    throw new \Exception('"port" param is not set for ' . $section);
+                }
+                if (!ctype_digit($port)) {
+                    throw new \Exception('"port" param is invalid for ' . $section);
+                }
+                $port = intval($port);
+                if ($port < 1 || $port > 65535) {
+                    throw new \Exception('"port" param is invalid for ' . $section);
+                }
+                return new MemcachedCache($host, $port);
             default:
                 if (!file_exists(PATH_LIB_CACHES . $className . '.php')) {
                     throw new \Exception('Unable to find the cache file');
diff --git a/lib/CacheInterface.php b/lib/CacheInterface.php
index 85aa830f..0009a55c 100644
--- a/lib/CacheInterface.php
+++ b/lib/CacheInterface.php
@@ -2,15 +2,13 @@
 
 interface CacheInterface
 {
-    public function setScope(string $scope): void;
+    public function get(string $key, $default = null);
 
-    public function setKey(array $key): void;
+    public function set(string $key, $value, int $ttl = null): void;
 
-    public function loadData(int $timeout = 86400);
+    public function delete(string $key): void;
 
-    public function saveData($data): void;
+    public function clear(): void;
 
-    public function getTime(): ?int;
-
-    public function purgeCache(int $timeout = 86400): void;
+    public function prune(): void;
 }
diff --git a/lib/Configuration.php b/lib/Configuration.php
index f5615009..7ef97fa7 100644
--- a/lib/Configuration.php
+++ b/lib/Configuration.php
@@ -37,10 +37,6 @@ final class Configuration
      */
     public static function verifyInstallation()
     {
-        if (version_compare(\PHP_VERSION, '7.4.0') === -1) {
-            throw new \Exception('RSS-Bridge requires at least PHP version 7.4.0!');
-        }
-
         $errors = [];
 
         // OpenSSL: https://www.php.net/manual/en/book.openssl.php
@@ -211,6 +207,9 @@ final class Configuration
         if (!is_string(self::getConfig('error', 'output'))) {
             self::throwConfigError('error', 'output', 'Is not a valid String');
         }
+        if (!in_array(self::getConfig('error', 'output'), ['feed', 'http', 'none'])) {
+            self::throwConfigError('error', 'output', 'Invalid output');
+        }
 
         if (
             !is_numeric(self::getConfig('error', 'report_limit'))
diff --git a/lib/FeedExpander.php b/lib/FeedExpander.php
index c91586d7..be467336 100644
--- a/lib/FeedExpander.php
+++ b/lib/FeedExpander.php
@@ -100,8 +100,8 @@ abstract class FeedExpander extends BridgeAbstract
             '*/*',
         ];
         $httpHeaders = ['Accept: ' . implode(', ', $mimeTypes)];
-        $content = getContents($url, $httpHeaders);
-        if ($content === '') {
+        $xml = getContents($url, $httpHeaders);
+        if ($xml === '') {
             throw new \Exception(sprintf('Unable to parse xml from `%s` because we got the empty string', $url), 10);
         }
         // Maybe move this call earlier up the stack frames
@@ -109,7 +109,7 @@ abstract class FeedExpander extends BridgeAbstract
         libxml_use_internal_errors(true);
         // Consider replacing libxml with https://www.php.net/domdocument
         // Intentionally not using the silencing operator (@) because it has no effect here
-        $rssContent = simplexml_load_string(trim($content));
+        $rssContent = simplexml_load_string(trim($xml));
         if ($rssContent === false) {
             $xmlErrors = libxml_get_errors();
             foreach ($xmlErrors as $xmlError) {
diff --git a/lib/FormatInterface.php b/lib/FormatInterface.php
index c0355804..49e36933 100644
--- a/lib/FormatInterface.php
+++ b/lib/FormatInterface.php
@@ -28,15 +28,7 @@ interface FormatInterface
      */
     public function stringify();
 
-    /**
-     * Set items
-     *
-     * @param array $bridges The items
-     * @return self The format object
-     *
-     * @todo Rename parameter `$bridges` to `$items`
-     */
-    public function setItems(array $bridges);
+    public function setItems(array $items);
 
     /**
      * Return items
diff --git a/lib/Logger.php b/lib/Logger.php
index 5423f62c..073fedee 100644
--- a/lib/Logger.php
+++ b/lib/Logger.php
@@ -66,13 +66,24 @@ final class Logger
                 }
             }
         }
-        // Intentionally not sanitizing $message
+
+        if ($context) {
+            try {
+                $context = Json::encode($context);
+            } catch (\JsonException $e) {
+                $context['message'] = null;
+                $context = Json::encode($context);
+            }
+        } else {
+            $context = '';
+        }
         $text = sprintf(
             "[%s] rssbridge.%s %s %s\n",
             now()->format('Y-m-d H:i:s'),
             $level,
+            // Intentionally not sanitizing $message
             $message,
-            $context ? Json::encode($context) : ''
+            $context
         );
 
         // Log to stderr/stdout whatever that is
@@ -81,6 +92,6 @@ final class Logger
 
         // Log to file
         // todo: extract to log handler
-        // file_put_contents('/tmp/rss-bridge.log', $text, FILE_APPEND | LOCK_EX);
+        //$bytes = file_put_contents('/tmp/rss-bridge.log', $text, FILE_APPEND | LOCK_EX);
     }
 }
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index 8969dc54..1c6ce464 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -5,25 +5,7 @@ final class RssBridge
     private static HttpClient $httpClient;
     private static CacheInterface $cache;
 
-    public function main(array $argv = [])
-    {
-        if ($argv) {
-            parse_str(implode('&', array_slice($argv, 1)), $cliArgs);
-            $request = $cliArgs;
-        } else {
-            $request = array_merge($_GET, $_POST);
-        }
-
-        try {
-            $this->run($request);
-        } catch (\Throwable $e) {
-            Logger::error(sprintf('Exception in RssBridge::main(): %s', create_sane_exception_message($e)), ['e' => $e]);
-            http_response_code(500);
-            print render(__DIR__ . '/../templates/error.html.php', ['e' => $e]);
-        }
-    }
-
-    private function run($request): void
+    public function __construct()
     {
         Configuration::verifyInstallation();
 
@@ -33,6 +15,13 @@ final class RssBridge
         }
         Configuration::loadConfiguration($customConfig, getenv());
 
+        set_exception_handler(function (\Throwable $e) {
+            Logger::error('Uncaught Exception', ['e' => $e]);
+            http_response_code(500);
+            print render(__DIR__ . '/../templates/error.html.php', ['e' => $e]);
+            exit(1);
+        });
+
         set_error_handler(function ($code, $message, $file, $line) {
             if ((error_reporting() & $code) === 0) {
                 return false;
@@ -45,7 +34,6 @@ final class RssBridge
             );
             Logger::warning($text);
             if (Debug::isEnabled()) {
-                // todo: extract to log handler
                 print sprintf("<pre>%s</pre>\n", e($text));
             }
         });
@@ -72,38 +60,58 @@ final class RssBridge
         // Consider: ini_set('error_reporting', E_ALL & ~E_DEPRECATED);
         date_default_timezone_set(Configuration::getConfig('system', 'timezone'));
 
-        $cacheFactory = new CacheFactory();
-
         self::$httpClient = new CurlHttpClient();
-        self::$cache = $cacheFactory->create();
+
+        $cacheFactory = new CacheFactory();
+        if (Debug::isEnabled()) {
+            self::$cache = $cacheFactory->create('array');
+        } else {
+            self::$cache = $cacheFactory->create();
+        }
 
         if (Configuration::getConfig('authentication', 'enable')) {
             $authenticationMiddleware = new AuthenticationMiddleware();
             $authenticationMiddleware();
         }
+    }
 
-        foreach ($request as $key => $value) {
-            if (!is_string($value)) {
-                throw new \Exception("Query parameter \"$key\" is not a string.");
+    public function main(array $argv = []): void
+    {
+        if ($argv) {
+            parse_str(implode('&', array_slice($argv, 1)), $cliArgs);
+            $request = $cliArgs;
+        } else {
+            $request = array_merge($_GET, $_POST);
+        }
+
+        try {
+            foreach ($request as $key => $value) {
+                if (!is_string($value)) {
+                    throw new \Exception("Query parameter \"$key\" is not a string.");
+                }
             }
-        }
 
-        $actionName = $request['action'] ?? 'Frontpage';
-        $actionName = strtolower($actionName) . 'Action';
-        $actionName = implode(array_map('ucfirst', explode('-', $actionName)));
+            $actionName = $request['action'] ?? 'Frontpage';
+            $actionName = strtolower($actionName) . 'Action';
+            $actionName = implode(array_map('ucfirst', explode('-', $actionName)));
 
-        $filePath = __DIR__ . '/../actions/' . $actionName . '.php';
-        if (!file_exists($filePath)) {
-            throw new \Exception(sprintf('Invalid action: %s', $actionName));
-        }
-        $className = '\\' . $actionName;
-        $action = new $className();
+            $filePath = __DIR__ . '/../actions/' . $actionName . '.php';
+            if (!file_exists($filePath)) {
+                throw new \Exception('Invalid action', 400);
+            }
+            $className = '\\' . $actionName;
+            $action = new $className();
 
-        $response = $action->execute($request);
-        if (is_string($response)) {
-            print $response;
-        } elseif ($response instanceof Response) {
-            $response->send();
+            $response = $action->execute($request);
+            if (is_string($response)) {
+                print $response;
+            } elseif ($response instanceof Response) {
+                $response->send();
+            }
+        } catch (\Throwable $e) {
+            Logger::error('Exception in RssBridge::main()', ['e' => $e]);
+            http_response_code(500);
+            print render(__DIR__ . '/../templates/error.html.php', ['e' => $e]);
         }
     }
 
@@ -114,6 +122,12 @@ final class RssBridge
 
     public static function getCache(): CacheInterface
     {
-        return self::$cache;
+        return self::$cache ?? new NullCache();
+    }
+
+    public function clearCache()
+    {
+        $cache = self::getCache();
+        $cache->clear();
     }
 }
diff --git a/lib/TwitterClient.php b/lib/TwitterClient.php
index 20f21482..f71e842c 100644
--- a/lib/TwitterClient.php
+++ b/lib/TwitterClient.php
@@ -12,11 +12,9 @@ class TwitterClient
     {
         $this->cache = $cache;
 
-        $cache->setScope('twitter');
-        $cache->setKey(['cache']);
-        $cache->purgeCache(60 * 60 * 3);
+        $data = $this->cache->get('twitter') ?? [];
+        $this->data = $data;
 
-        $this->data = $this->cache->loadData() ?? [];
         $this->authorization = 'AAAAAAAAAAAAAAAAAAAAAGHtAgAAAAAA%2Bx7ILXNILCqkSGIzy6faIHZ9s3Q%3DQy97w6SIrzE7lQwPJEYQBsArEE2fC25caFwRBvAGi456G09vGR';
         $this->tw_consumer_key = '3nVuSoBZnx6U4vzUxf5w';
         $this->tw_consumer_secret = 'Bcs59EFbbsdF6Sl9Ng71smgStWEGwXXKSjYvPVt7qys';
@@ -273,9 +271,7 @@ class TwitterClient
         $guest_token = json_decode($response)->guest_token;
         $this->data['guest_token'] = $guest_token;
 
-        $this->cache->setScope('twitter');
-        $this->cache->setKey(['cache']);
-        $this->cache->saveData($this->data);
+        $this->cache->set('twitter', $this->data);
     }
 
     private function fetchUserInfoByScreenName(string $screenName)
@@ -299,9 +295,7 @@ class TwitterClient
         $userInfo = $response->data->user;
         $this->data[$screenName] = $userInfo;
 
-        $this->cache->setScope('twitter');
-        $this->cache->setKey(['cache']);
-        $this->cache->saveData($this->data);
+        $this->cache->set('twitter', $this->data);
         return $userInfo;
     }
 
@@ -434,9 +428,7 @@ class TwitterClient
         $listInfo = $response->data->user_by_screen_name->list;
         $this->data[$screenName . '-' . $listSlug] = $listInfo;
 
-        $this->cache->setScope('twitter');
-        $this->cache->setKey(['cache']);
-        $this->cache->saveData($this->data);
+        $this->cache->set('twitter', $this->data);
         return $listInfo;
     }
 
diff --git a/lib/bootstrap.php b/lib/bootstrap.php
index e05dd94a..ca6cecdb 100644
--- a/lib/bootstrap.php
+++ b/lib/bootstrap.php
@@ -39,10 +39,10 @@ const MAX_FILE_SIZE = 10000000;
 // Files
 $files = [
     __DIR__ . '/../lib/html.php',
-    __DIR__ . '/../lib/error.php',
     __DIR__ . '/../lib/contents.php',
     __DIR__ . '/../lib/php8backports.php',
     __DIR__ . '/../lib/utils.php',
+    __DIR__ . '/../lib/http.php',
     // Vendor
     __DIR__ . '/../vendor/parsedown/Parsedown.php',
     __DIR__ . '/../vendor/php-urljoin/src/urljoin.php',
diff --git a/lib/contents.php b/lib/contents.php
index c842ccbc..c1847758 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -1,101 +1,11 @@
 <?php
 
-final class Response
-{
-    public const STATUS_CODES = [
-        '100' => 'Continue',
-        '101' => 'Switching Protocols',
-        '200' => 'OK',
-        '201' => 'Created',
-        '202' => 'Accepted',
-        '203' => 'Non-Authoritative Information',
-        '204' => 'No Content',
-        '205' => 'Reset Content',
-        '206' => 'Partial Content',
-        '300' => 'Multiple Choices',
-        '301' => 'Moved Permanently',
-        '302' => 'Found',
-        '303' => 'See Other',
-        '304' => 'Not Modified',
-        '305' => 'Use Proxy',
-        '400' => 'Bad Request',
-        '401' => 'Unauthorized',
-        '402' => 'Payment Required',
-        '403' => 'Forbidden',
-        '404' => 'Not Found',
-        '405' => 'Method Not Allowed',
-        '406' => 'Not Acceptable',
-        '407' => 'Proxy Authentication Required',
-        '408' => 'Request Timeout',
-        '409' => 'Conflict',
-        '410' => 'Gone',
-        '411' => 'Length Required',
-        '412' => 'Precondition Failed',
-        '413' => 'Request Entity Too Large',
-        '414' => 'Request-URI Too Long',
-        '415' => 'Unsupported Media Type',
-        '416' => 'Requested Range Not Satisfiable',
-        '417' => 'Expectation Failed',
-        '429' => 'Too Many Requests',
-        '500' => 'Internal Server Error',
-        '501' => 'Not Implemented',
-        '502' => 'Bad Gateway',
-        '503' => 'Service Unavailable',
-        '504' => 'Gateway Timeout',
-        '505' => 'HTTP Version Not Supported'
-    ];
-    private string $body;
-    private int $code;
-    private array $headers;
-
-    public function __construct(
-        string $body = '',
-        int $code = 200,
-        array $headers = []
-    ) {
-        $this->body = $body;
-        $this->code = $code;
-        $this->headers = $headers;
-    }
-
-    public function getBody()
-    {
-        return $this->body;
-    }
-
-    public function getCode()
-    {
-        return $this->code;
-    }
-
-    public function getHeaders()
-    {
-        return $this->headers;
-    }
-
-    public function send(): void
-    {
-        http_response_code($this->code);
-        foreach ($this->headers as $name => $value) {
-            header(sprintf('%s: %s', $name, $value));
-        }
-        print $this->body;
-    }
-}
-
 /**
  * Fetch data from an http url
  *
  * @param array $httpHeaders E.g. ['Content-type: text/plain']
  * @param array $curlOptions Associative array e.g. [CURLOPT_MAXREDIRS => 3]
- * @param bool $returnFull Whether to return an array:
- *                         [
- *                              'code' => int,
- *                              'header' => array,
- *                              'content' => string,
- *                              'status_lines' => array,
- *                         ]
-
+ * @param bool $returnFull Whether to return an array: ['code' => int, 'headers' => array, 'content' => string]
  * @return string|array
  */
 function getContents(
@@ -142,30 +52,35 @@ function getContents(
     }
 
     $cache = RssBridge::getCache();
-    $cache->setScope('server');
-    $cache->setKey([$url]);
+    $cacheKey = 'server_' . $url;
 
-    if (!Debug::isEnabled() && $cache->getTime() && $cache->loadData(86400 * 7)) {
-        $config['if_not_modified_since'] = $cache->getTime();
+    /** @var Response $cachedResponse */
+    $cachedResponse = $cache->get($cacheKey);
+    if ($cachedResponse) {
+        // considering popping
+        $cachedLastModified = $cachedResponse->getHeader('last-modified');
+        if ($cachedLastModified) {
+            $cachedLastModified = new \DateTimeImmutable($cachedLastModified);
+            $config['if_not_modified_since'] = $cachedLastModified->getTimestamp();
+        }
     }
 
     $response = $httpClient->request($url, $config);
 
-    switch ($response['code']) {
+    switch ($response->getCode()) {
         case 200:
         case 201:
         case 202:
-            if (isset($response['headers']['cache-control'])) {
-                $cachecontrol = $response['headers']['cache-control'];
-                $lastValue = array_pop($cachecontrol);
-                $directives = explode(',', $lastValue);
+            $cacheControl = $response->getHeader('cache-control');
+            if ($cacheControl) {
+                $directives = explode(',', $cacheControl);
                 $directives = array_map('trim', $directives);
                 if (in_array('no-cache', $directives) || in_array('no-store', $directives)) {
                     // Don't cache as instructed by the server
                     break;
                 }
             }
-            $cache->saveData($response['body']);
+            $cache->set($cacheKey, $response, 86400 * 10);
             break;
         case 301:
         case 302:
@@ -174,16 +89,16 @@ function getContents(
             break;
         case 304:
             // Not Modified
-            $response['body'] = $cache->loadData(86400 * 7);
+            $response = $response->withBody($cachedResponse->getBody());
             break;
         default:
             $exceptionMessage = sprintf(
                 '%s resulted in %s %s %s',
                 $url,
-                $response['code'],
-                Response::STATUS_CODES[$response['code']] ?? '',
+                $response->getCode(),
+                $response->getStatusLine(),
                 // If debug, include a part of the response body in the exception message
-                Debug::isEnabled() ? mb_substr($response['body'], 0, 500) : '',
+                Debug::isEnabled() ? mb_substr($response->getBody(), 0, 500) : '',
             );
 
             // The following code must be extracted if it grows too much
@@ -194,141 +109,21 @@ function getContents(
                 '<title>Security | Glassdoor',
             ];
             foreach ($cloudflareTitles as $cloudflareTitle) {
-                if (str_contains($response['body'], $cloudflareTitle)) {
-                    throw new CloudFlareException($exceptionMessage, $response['code']);
+                if (str_contains($response->getBody(), $cloudflareTitle)) {
+                    throw new CloudFlareException($exceptionMessage, $response->getCode());
                 }
             }
-            throw new HttpException(trim($exceptionMessage), $response['code']);
+            throw new HttpException(trim($exceptionMessage), $response->getCode());
     }
     if ($returnFull === true) {
-        // For legacy reasons, use content instead of body
-        $response['content'] = $response['body'];
-        unset($response['body']);
-        return $response;
-    }
-    return $response['body'];
-}
-
-interface HttpClient
-{
-    public function request(string $url, array $config = []): array;
-}
-
-final class CurlHttpClient implements HttpClient
-{
-    public function request(string $url, array $config = []): array
-    {
-        $defaults = [
-            'useragent' => null,
-            'timeout' => 5,
-            'headers' => [],
-            'proxy' => null,
-            'curl_options' => [],
-            'if_not_modified_since' => null,
-            'retries' => 3,
-            'max_filesize' => null,
-            'max_redirections' => 5,
-        ];
-        $config = array_merge($defaults, $config);
-
-        $ch = curl_init($url);
-        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
-        curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
-        curl_setopt($ch, CURLOPT_MAXREDIRS, $config['max_redirections']);
-        curl_setopt($ch, CURLOPT_HEADER, false);
-        $httpHeaders = [];
-        foreach ($config['headers'] as $name => $value) {
-            $httpHeaders[] = sprintf('%s: %s', $name, $value);
-        }
-        curl_setopt($ch, CURLOPT_HTTPHEADER, $httpHeaders);
-        if ($config['useragent']) {
-            curl_setopt($ch, CURLOPT_USERAGENT, $config['useragent']);
-        }
-        curl_setopt($ch, CURLOPT_TIMEOUT, $config['timeout']);
-        curl_setopt($ch, CURLOPT_ENCODING, '');
-        curl_setopt($ch, CURLOPT_PROTOCOLS, CURLPROTO_HTTP | CURLPROTO_HTTPS);
-
-        if ($config['max_filesize']) {
-            // This option inspects the Content-Length header
-            curl_setopt($ch, CURLOPT_MAXFILESIZE, $config['max_filesize']);
-            curl_setopt($ch, CURLOPT_NOPROGRESS, false);
-            // This progress function will monitor responses who omit the Content-Length header
-            curl_setopt($ch, CURLOPT_PROGRESSFUNCTION, function ($ch, $downloadSize, $downloaded, $uploadSize, $uploaded) use ($config) {
-                if ($downloaded > $config['max_filesize']) {
-                    // Return a non-zero value to abort the transfer
-                    return -1;
-                }
-                return 0;
-            });
-        }
-
-        if ($config['proxy']) {
-            curl_setopt($ch, CURLOPT_PROXY, $config['proxy']);
-        }
-        if (curl_setopt_array($ch, $config['curl_options']) === false) {
-            throw new \Exception('Tried to set an illegal curl option');
-        }
-
-        if ($config['if_not_modified_since']) {
-            curl_setopt($ch, CURLOPT_TIMEVALUE, $config['if_not_modified_since']);
-            curl_setopt($ch, CURLOPT_TIMECONDITION, CURL_TIMECOND_IFMODSINCE);
-        }
-
-        $responseStatusLines = [];
-        $responseHeaders = [];
-        curl_setopt($ch, CURLOPT_HEADERFUNCTION, function ($ch, $rawHeader) use (&$responseHeaders, &$responseStatusLines) {
-            $len = strlen($rawHeader);
-            if ($rawHeader === "\r\n") {
-                return $len;
-            }
-            if (preg_match('#^HTTP/(2|1.1|1.0)#', $rawHeader)) {
-                $responseStatusLines[] = $rawHeader;
-                return $len;
-            }
-            $header = explode(':', $rawHeader);
-            if (count($header) === 1) {
-                return $len;
-            }
-            $name = mb_strtolower(trim($header[0]));
-            $value = trim(implode(':', array_slice($header, 1)));
-            if (!isset($responseHeaders[$name])) {
-                $responseHeaders[$name] = [];
-            }
-            $responseHeaders[$name][] = $value;
-            return $len;
-        });
-
-        $attempts = 0;
-        while (true) {
-            $attempts++;
-            $data = curl_exec($ch);
-            if ($data !== false) {
-                // The network call was successful, so break out of the loop
-                break;
-            }
-            if ($attempts > $config['retries']) {
-                // Finally give up
-                $curl_error = curl_error($ch);
-                $curl_errno = curl_errno($ch);
-                throw new HttpException(sprintf(
-                    'cURL error %s: %s (%s) for %s',
-                    $curl_error,
-                    $curl_errno,
-                    'https://curl.haxx.se/libcurl/c/libcurl-errors.html',
-                    $url
-                ));
-            }
-        }
-
-        $statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
-        curl_close($ch);
         return [
-            'code' => $statusCode,
-            'status_lines' => $responseStatusLines,
-            'headers' => $responseHeaders,
-            'body' => $data,
+            'code'      => $response->getCode(),
+            'headers'   => $response->getHeaders(),
+            // For legacy reasons, use 'content' instead of 'body'
+            'content'   => $response->getBody(),
         ];
     }
+    return $response->getBody();
 }
 
 /**
@@ -391,7 +186,7 @@ function getSimpleHTMLDOM(
  * _Notice_: Cached contents are forcefully removed after 24 hours (86400 seconds).
  *
  * @param string $url The URL.
- * @param int $timeout Cache duration in seconds.
+ * @param int $ttl Cache duration in seconds.
  * @param array $header (optional) A list of cURL header.
  * For more information follow the links below.
  * * https://php.net/manual/en/function.curl-setopt.php
@@ -416,7 +211,7 @@ function getSimpleHTMLDOM(
  */
 function getSimpleHTMLDOMCached(
     $url,
-    $timeout = 86400,
+    $ttl = 86400,
     $header = [],
     $opts = [],
     $lowercase = true,
@@ -427,14 +222,11 @@ function getSimpleHTMLDOMCached(
     $defaultSpanText = DEFAULT_SPAN_TEXT
 ) {
     $cache = RssBridge::getCache();
-    $cache->setScope('pages');
-    $cache->setKey([$url]);
-    $content = $cache->loadData($timeout);
-    if (!$content || Debug::isEnabled()) {
+    $cacheKey = 'pages_' . $url;
+    $content = $cache->get($cacheKey);
+    if (!$content) {
         $content = getContents($url, $header ?? [], $opts ?? []);
-        $cache->setScope('pages');
-        $cache->setKey([$url]);
-        $cache->saveData($content);
+        $cache->set($cacheKey, $content, $ttl);
     }
     return str_get_html(
         $content,
diff --git a/lib/error.php b/lib/error.php
deleted file mode 100644
index 4439fb38..00000000
--- a/lib/error.php
+++ /dev/null
@@ -1,47 +0,0 @@
-<?php
-
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
-/**
- * Throws an exception when called.
- *
- * @throws \Exception when called
- * @param string $message The error message
- * @param int $code The HTTP error code
- * @link https://en.wikipedia.org/wiki/List_of_HTTP_status_codes List of HTTP
- * status codes
- */
-function returnError($message, $code)
-{
-    throw new \Exception($message, $code);
-}
-
-/**
- * Returns HTTP Error 400 (Bad Request) when called.
- *
- * @param string $message The error message
- */
-function returnClientError($message)
-{
-    returnError($message, 400);
-}
-
-/**
- * Returns HTTP Error 500 (Internal Server Error) when called.
- *
- * @param string $message The error message
- */
-function returnServerError($message)
-{
-    returnError($message, 500);
-}
diff --git a/lib/http.php b/lib/http.php
new file mode 100644
index 00000000..c5e65e77
--- /dev/null
+++ b/lib/http.php
@@ -0,0 +1,252 @@
+<?php
+
+class HttpException extends \Exception
+{
+}
+
+final class CloudFlareException extends HttpException
+{
+}
+
+interface HttpClient
+{
+    public function request(string $url, array $config = []): Response;
+}
+
+final class CurlHttpClient implements HttpClient
+{
+    public function request(string $url, array $config = []): Response
+    {
+        $defaults = [
+            'useragent' => null,
+            'timeout' => 5,
+            'headers' => [],
+            'proxy' => null,
+            'curl_options' => [],
+            'if_not_modified_since' => null,
+            'retries' => 3,
+            'max_filesize' => null,
+            'max_redirections' => 5,
+        ];
+        $config = array_merge($defaults, $config);
+
+        $ch = curl_init($url);
+        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+        curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
+        curl_setopt($ch, CURLOPT_MAXREDIRS, $config['max_redirections']);
+        curl_setopt($ch, CURLOPT_HEADER, false);
+        $httpHeaders = [];
+        foreach ($config['headers'] as $name => $value) {
+            $httpHeaders[] = sprintf('%s: %s', $name, $value);
+        }
+        curl_setopt($ch, CURLOPT_HTTPHEADER, $httpHeaders);
+        if ($config['useragent']) {
+            curl_setopt($ch, CURLOPT_USERAGENT, $config['useragent']);
+        }
+        curl_setopt($ch, CURLOPT_TIMEOUT, $config['timeout']);
+        curl_setopt($ch, CURLOPT_ENCODING, '');
+        curl_setopt($ch, CURLOPT_PROTOCOLS, CURLPROTO_HTTP | CURLPROTO_HTTPS);
+
+        if ($config['max_filesize']) {
+            // This option inspects the Content-Length header
+            curl_setopt($ch, CURLOPT_MAXFILESIZE, $config['max_filesize']);
+            curl_setopt($ch, CURLOPT_NOPROGRESS, false);
+            // This progress function will monitor responses who omit the Content-Length header
+            curl_setopt($ch, CURLOPT_PROGRESSFUNCTION, function ($ch, $downloadSize, $downloaded, $uploadSize, $uploaded) use ($config) {
+                if ($downloaded > $config['max_filesize']) {
+                    // Return a non-zero value to abort the transfer
+                    return -1;
+                }
+                return 0;
+            });
+        }
+
+        if ($config['proxy']) {
+            curl_setopt($ch, CURLOPT_PROXY, $config['proxy']);
+        }
+        if (curl_setopt_array($ch, $config['curl_options']) === false) {
+            throw new \Exception('Tried to set an illegal curl option');
+        }
+
+        if ($config['if_not_modified_since']) {
+            curl_setopt($ch, CURLOPT_TIMEVALUE, $config['if_not_modified_since']);
+            curl_setopt($ch, CURLOPT_TIMECONDITION, CURL_TIMECOND_IFMODSINCE);
+        }
+
+        $responseStatusLines = [];
+        $responseHeaders = [];
+        curl_setopt($ch, CURLOPT_HEADERFUNCTION, function ($ch, $rawHeader) use (&$responseHeaders, &$responseStatusLines) {
+            $len = strlen($rawHeader);
+            if ($rawHeader === "\r\n") {
+                return $len;
+            }
+            if (preg_match('#^HTTP/(2|1.1|1.0)#', $rawHeader)) {
+                $responseStatusLines[] = trim($rawHeader);
+                return $len;
+            }
+            $header = explode(':', $rawHeader);
+            if (count($header) === 1) {
+                return $len;
+            }
+            $name = mb_strtolower(trim($header[0]));
+            $value = trim(implode(':', array_slice($header, 1)));
+            if (!isset($responseHeaders[$name])) {
+                $responseHeaders[$name] = [];
+            }
+            $responseHeaders[$name][] = $value;
+            return $len;
+        });
+
+        $attempts = 0;
+        while (true) {
+            $attempts++;
+            $data = curl_exec($ch);
+            if ($data !== false) {
+                // The network call was successful, so break out of the loop
+                break;
+            }
+            if ($attempts > $config['retries']) {
+                // Finally give up
+                $curl_error = curl_error($ch);
+                $curl_errno = curl_errno($ch);
+                throw new HttpException(sprintf(
+                    'cURL error %s: %s (%s) for %s',
+                    $curl_error,
+                    $curl_errno,
+                    'https://curl.haxx.se/libcurl/c/libcurl-errors.html',
+                    $url
+                ));
+            }
+        }
+
+        $statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
+        curl_close($ch);
+        return new Response($data, $statusCode, $responseHeaders);
+    }
+}
+
+final class Response
+{
+    public const STATUS_CODES = [
+        '100' => 'Continue',
+        '101' => 'Switching Protocols',
+        '200' => 'OK',
+        '201' => 'Created',
+        '202' => 'Accepted',
+        '203' => 'Non-Authoritative Information',
+        '204' => 'No Content',
+        '205' => 'Reset Content',
+        '206' => 'Partial Content',
+        '300' => 'Multiple Choices',
+        '301' => 'Moved Permanently',
+        '302' => 'Found',
+        '303' => 'See Other',
+        '304' => 'Not Modified',
+        '305' => 'Use Proxy',
+        '400' => 'Bad Request',
+        '401' => 'Unauthorized',
+        '402' => 'Payment Required',
+        '403' => 'Forbidden',
+        '404' => 'Not Found',
+        '405' => 'Method Not Allowed',
+        '406' => 'Not Acceptable',
+        '407' => 'Proxy Authentication Required',
+        '408' => 'Request Timeout',
+        '409' => 'Conflict',
+        '410' => 'Gone',
+        '411' => 'Length Required',
+        '412' => 'Precondition Failed',
+        '413' => 'Request Entity Too Large',
+        '414' => 'Request-URI Too Long',
+        '415' => 'Unsupported Media Type',
+        '416' => 'Requested Range Not Satisfiable',
+        '417' => 'Expectation Failed',
+        '429' => 'Too Many Requests',
+        '500' => 'Internal Server Error',
+        '501' => 'Not Implemented',
+        '502' => 'Bad Gateway',
+        '503' => 'Service Unavailable',
+        '504' => 'Gateway Timeout',
+        '505' => 'HTTP Version Not Supported'
+    ];
+    private string $body;
+    private int $code;
+    private array $headers;
+
+    public function __construct(
+        string $body = '',
+        int $code = 200,
+        array $headers = []
+    ) {
+        $this->body = $body;
+        $this->code = $code;
+        $this->headers = [];
+
+        foreach ($headers as $name => $value) {
+            $name = mb_strtolower($name);
+            if (!isset($this->headers[$name])) {
+                $this->headers[$name] = [];
+            }
+            if (is_string($value)) {
+                $this->headers[$name][] = $value;
+            }
+            if (is_array($value)) {
+                $this->headers[$name] = $value;
+            }
+        }
+    }
+
+    public function getBody()
+    {
+        return $this->body;
+    }
+
+    public function getCode()
+    {
+        return $this->code;
+    }
+
+    public function getStatusLine(): string
+    {
+        return self::STATUS_CODES[$this->code] ?? '';
+    }
+
+    public function getHeaders()
+    {
+        return $this->headers;
+    }
+
+    /**
+     * @return string[]|string|null
+     */
+    public function getHeader(string $name, bool $all = false)
+    {
+        $name = mb_strtolower($name);
+        $header = $this->headers[$name] ?? null;
+        if (!$header) {
+            return null;
+        }
+        if ($all) {
+            return $header;
+        }
+        return array_pop($header);
+    }
+
+    public function withBody(string $body): Response
+    {
+        $clone = clone $this;
+        $clone->body = $body;
+        return $clone;
+    }
+
+    public function send(): void
+    {
+        http_response_code($this->code);
+        foreach ($this->headers as $name => $values) {
+            foreach ($values as $value) {
+                header(sprintf('%s: %s', $name, $value));
+            }
+        }
+        print $this->body;
+    }
+}
diff --git a/lib/utils.php b/lib/utils.php
index 94f928cd..4c58d258 100644
--- a/lib/utils.php
+++ b/lib/utils.php
@@ -1,18 +1,17 @@
 <?php
 
-class HttpException extends \Exception
-{
-}
-
-final class CloudFlareException extends HttpException
-{
-}
-
+// https://github.com/nette/utils/blob/master/src/Utils/Json.php
 final class Json
 {
-    public static function encode($value): string
+    public static function encode($value, $pretty = true, bool $asciiSafe = false): string
     {
-        $flags = JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE;
+        $flags = JSON_THROW_ON_ERROR | JSON_UNESCAPED_SLASHES;
+        if (!$asciiSafe) {
+            $flags = $flags | JSON_UNESCAPED_UNICODE;
+        }
+        if ($pretty) {
+            $flags = $flags | JSON_PRETTY_PRINT;
+        }
         return \json_encode($value, $flags);
     }
 
@@ -237,3 +236,13 @@ function create_random_string(int $bytes = 16): string
 {
     return bin2hex(openssl_random_pseudo_bytes($bytes));
 }
+
+function returnClientError($message)
+{
+    throw new \Exception($message, 400);
+}
+
+function returnServerError($message)
+{
+    throw new \Exception($message, 500);
+}
diff --git a/tests/Actions/ListActionTest.php b/tests/Actions/ListActionTest.php
index e0625fb3..74a90254 100644
--- a/tests/Actions/ListActionTest.php
+++ b/tests/Actions/ListActionTest.php
@@ -17,7 +17,8 @@ class ListActionTest extends TestCase
         $action = new \ListAction();
         $response = $action->execute([]);
         $headers = $response->getHeaders();
-        $this->assertSame($headers['Content-Type'], 'application/json');
+        $contentType = $response->getHeader('content-type');
+        $this->assertSame($contentType, 'application/json');
     }
 
     public function testOutput()
diff --git a/tests/CacheTest.php b/tests/CacheTest.php
index 9a8ada14..15d03ec1 100644
--- a/tests/CacheTest.php
+++ b/tests/CacheTest.php
@@ -27,17 +27,13 @@ class CacheTest extends TestCase
             'path' => $temporaryFolder,
             'enable_purge' => true,
         ]);
-        $sut->setScope('scope');
-        $sut->purgeCache(-1);
-        $sut->setKey(['key']);
+        $sut->clear();
 
-        $this->assertNull($sut->getTime());
-        $this->assertNull($sut->loadData());
+        $this->assertNull($sut->get('key'));
 
-        $sut->saveData('data');
-        $this->assertSame('data', $sut->loadData());
-        $this->assertIsNumeric($sut->getTime());
-        $sut->purgeCache(-1);
+        $sut->set('key', 'data', 5);
+        $this->assertSame('data', $sut->get('key'));
+        $sut->clear();
 
         // Intentionally not deleting the temp folder
     }

From 3178deb5a8ce979baf186b69e5a427bb14adef4f Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 10 Sep 2023 23:35:40 +0200
Subject: [PATCH 101/716] fix: mastodon, cache tweaks, docs (#3661)

* cache tweaks

* docs

* fix(mastodon): type bug
---
 bridges/ItakuBridge.php    |  2 +-
 bridges/MastodonBridge.php | 10 +++++++++-
 bridges/PixivBridge.php    |  8 +++++---
 caches/SQLiteCache.php     |  4 ++++
 4 files changed, 19 insertions(+), 5 deletions(-)

diff --git a/bridges/ItakuBridge.php b/bridges/ItakuBridge.php
index 6b0ebcb2..62a130ff 100644
--- a/bridges/ItakuBridge.php
+++ b/bridges/ItakuBridge.php
@@ -664,7 +664,7 @@ class ItakuBridge extends BridgeAbstract
         // Debug::log($url);
         if ($getJSON) { //get JSON object
             if ($cache) {
-                $data = $this->loadCacheValue($url, 86400); // 24 hours
+                $data = $this->loadCacheValue($url);
                 if (is_null($data)) {
                     $data = getContents($url, $httpHeaders, $curlOptions) or returnServerError("Could not load $url");
                     $this->saveCacheValue($url, $data);
diff --git a/bridges/MastodonBridge.php b/bridges/MastodonBridge.php
index 81401be9..54ac55bd 100644
--- a/bridges/MastodonBridge.php
+++ b/bridges/MastodonBridge.php
@@ -100,6 +100,10 @@ class MastodonBridge extends BridgeAbstract
                 // We fetch the boosted content.
                 try {
                     $rtContent = $this->fetchAP($content['object']);
+                    if (!$rtContent) {
+                        // Sometimes fetchAP returns null. Someone should figure out why. json_decode failure?
+                        break;
+                    }
                     $rtUser = $this->loadCacheValue($rtContent['attributedTo']);
                     if (!isset($rtUser)) {
                         // We fetch the author, since we cannot always assume the format of the URL.
@@ -277,6 +281,10 @@ class MastodonBridge extends BridgeAbstract
                 array_push($headers, $sig);
             }
         }
-        return json_decode(getContents($url, $headers), true);
+        try {
+            return Json::decode(getContents($url, $headers));
+        } catch (\JsonException $e) {
+            return null;
+        }
     }
 }
diff --git a/bridges/PixivBridge.php b/bridges/PixivBridge.php
index 5549c609..c4f5277f 100644
--- a/bridges/PixivBridge.php
+++ b/bridges/PixivBridge.php
@@ -353,10 +353,12 @@ class PixivBridge extends BridgeAbstract
     private function getCookie()
     {
         // checks if cookie is set, if not initialise it with the cookie from the config
-        $value = $this->loadCacheValue('cookie', 2678400 /* 30 days + 1 day to let cookie chance to renew */);
+        $value = $this->loadCacheValue('cookie');
         if (!isset($value)) {
             $value = $this->getOption('cookie');
-            $this->saveCacheValue('cookie', $this->getOption('cookie'));
+
+            // 30 days + 1 day to let cookie chance to renew
+            $this->saveCacheValue('cookie', $this->getOption('cookie'), 2678400);
         }
         return $value;
     }
@@ -370,7 +372,7 @@ class PixivBridge extends BridgeAbstract
         }
 
         if ($cache) {
-            $data = $this->loadCacheValue($url, 86400); // 24 hours
+            $data = $this->loadCacheValue($url);
             if (!$data) {
                 $data = getContents($url, $httpHeaders, $curlOptions, true) or returnServerError("Could not load $url");
                 $this->saveCacheValue($url, $data);
diff --git a/caches/SQLiteCache.php b/caches/SQLiteCache.php
index beb33e88..09689566 100644
--- a/caches/SQLiteCache.php
+++ b/caches/SQLiteCache.php
@@ -2,6 +2,10 @@
 
 declare(strict_types=1);
 
+/**
+ * The storage table has a column `updated` which is incorrectly named.
+ * It should have been named `expiration` and the code treats it as an expiration date (in unix timestamp)
+ */
 class SQLiteCache implements CacheInterface
 {
     private \SQLite3 $db;

From a9cf1512e787d3dabb875fe033a0c08a4c274c65 Mon Sep 17 00:00:00 2001
From: ImportTaste <53661808+ImportTaste@users.noreply.github.com>
Date: Sun, 10 Sep 2023 20:35:09 -0500
Subject: [PATCH 102/716] [SteamAppNewsBridge] Add tags filter (#3662)

Undocumented tags filter discovered through /ISteamWebAPIUtil/GetSupportedAPIList/v1/
e.g. /ISteamNews/GetNewsForApp/v2/?appid=1091500&tags=patchnotes
---
 bridges/SteamAppNewsBridge.php | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/bridges/SteamAppNewsBridge.php b/bridges/SteamAppNewsBridge.php
index 3eedc4ab..085e6978 100644
--- a/bridges/SteamAppNewsBridge.php
+++ b/bridges/SteamAppNewsBridge.php
@@ -27,18 +27,26 @@ class SteamAppNewsBridge extends BridgeAbstract
             'title' => '# of posts to retrieve (default 20)',
             'type' => 'number',
             'defaultValue' => 20
+        ],
+        'tags' => [
+            'name' => 'Tag Filter',
+            'title' => 'Comma-separated list of tags to filter by',
+            'type' => 'text',
+            'exampleValue' => 'patchnotes'
         ]
     ]];
 
     public function collectData()
     {
-        $api = 'https://api.steampowered.com/ISteamNews/GetNewsForApp/v2/';
+        $apiTarget = 'https://api.steampowered.com/ISteamNews/GetNewsForApp/v2/';
         // Example with params: https://api.steampowered.com/ISteamNews/GetNewsForApp/v2/?appid=730&maxlength=0&count=20
         // More info at dev docs https://partner.steamgames.com/doc/webapi/ISteamNews
-        $url = $api . '?appid='
-        . $this->getInput('appid') . '&maxlength='
-        . $this->getInput('maxlength') . '&count='
-        . $this->getInput('count');
+        $url =
+            $apiTarget
+            . '?appid=' . $this->getInput('appid')
+            . '&maxlength=' . $this->getInput('maxlength')
+            . '&count=' . $this->getInput('count')
+            . '&tags=' . $this->getInput('tags');
 
         // Get the JSON content
         $json = getContents($url);

From 3e1e96e477a26cf81582c16e9ef1edf399702b31 Mon Sep 17 00:00:00 2001
From: mruac <ant8672@gmail.com>
Date: Mon, 11 Sep 2023 20:45:14 +0930
Subject: [PATCH 103/716] [PatreonBridge] resolve null coalescing issue (#3664)

* extend post presentation

* applied phpcbf

note: phpcs does not like long null coalescing chains

* resolved phpcs

* resolved github comment https://github.com/RSS-Bridge/rss-bridge/pull/3617/#issuecomment-1699568400

* .

* lint SteamAppNewsBridge
---
 bridges/PatreonBridge.php      | 15 +++++++++------
 bridges/SteamAppNewsBridge.php |  3 +--
 2 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/bridges/PatreonBridge.php b/bridges/PatreonBridge.php
index 3d19cd81..d72bde20 100644
--- a/bridges/PatreonBridge.php
+++ b/bridges/PatreonBridge.php
@@ -132,8 +132,9 @@ class PatreonBridge extends BridgeAbstract
                             $audio = $this->findInclude($posts, 'media', $id)->attributes ?? null;
                         }
                     }
-                    $thumbnail = $post->attributes->thumbnail->large ?? $post->attributes->thumbnail->url;
-                    $thumbnail = $thumbnail ?? $post->attributes->image->thumb_url;
+                    $thumbnail = $post->attributes->thumbnail->large ?? null;
+                    $thumbnail = $thumbnail ?? $post->attributes->thumbnail->url ?? null;
+                    $thumbnail = $thumbnail ?? $post->attributes->image->thumb_url ?? null;
                     $thumbnail = $thumbnail ?? $post->attributes->image->url;
                     $audio_filename = $audio->file_name ?? $item['title'];
                     $download_url = $audio->download_url ?? $item['uri'];
@@ -146,15 +147,17 @@ class PatreonBridge extends BridgeAbstract
                     break;
 
                 case 'video_embed':
-                    $thumbnail = $post->attributes->thumbnail->large ?? $post->attributes->thumbnail->url;
-                    $thumbnail = $thumbnail ?? $post->attributes->image->thumb_url;
+                    $thumbnail = $post->attributes->thumbnail->large ?? null;
+                    $thumbnail = $thumbnail ?? $post->attributes->thumbnail->url ?? null;
+                    $thumbnail = $thumbnail ?? $post->attributes->image->thumb_url ?? null;
                     $thumbnail = $thumbnail ?? $post->attributes->image->url;
                     $item['content'] .= "<p><a href=\"{$item['uri']}\">🎬 {$item['title']}<br><img src=\"{$thumbnail}\"></a></p>";
                     break;
 
                 case 'video_external_file':
-                    $thumbnail = $post->attributes->thumbnail->large ?? $post->attributes->thumbnail->url;
-                    $thumbnail = $thumbnail ?? $post->attributes->image->thumb_url;
+                    $thumbnail = $post->attributes->thumbnail->large ?? null;
+                    $thumbnail = $thumbnail ?? $post->attributes->thumbnail->url ?? null;
+                    $thumbnail = $thumbnail ?? $post->attributes->image->thumb_url ?? null;
                     $thumbnail = $thumbnail ?? $post->attributes->image->url;
                     $item['content'] .= "<p><a href=\"{$item['uri']}\">🎬 {$item['title']}<br><img src=\"{$thumbnail}\"></a></p>";
                     break;
diff --git a/bridges/SteamAppNewsBridge.php b/bridges/SteamAppNewsBridge.php
index 085e6978..81045800 100644
--- a/bridges/SteamAppNewsBridge.php
+++ b/bridges/SteamAppNewsBridge.php
@@ -41,8 +41,7 @@ class SteamAppNewsBridge extends BridgeAbstract
         $apiTarget = 'https://api.steampowered.com/ISteamNews/GetNewsForApp/v2/';
         // Example with params: https://api.steampowered.com/ISteamNews/GetNewsForApp/v2/?appid=730&maxlength=0&count=20
         // More info at dev docs https://partner.steamgames.com/doc/webapi/ISteamNews
-        $url =
-            $apiTarget
+        $url = $apiTarget
             . '?appid=' . $this->getInput('appid')
             . '&maxlength=' . $this->getInput('maxlength')
             . '&count=' . $this->getInput('count')

From 4f5a492dde31377e2fa168430f26c09dae1425e4 Mon Sep 17 00:00:00 2001
From: mruac <ant8672@gmail.com>
Date: Mon, 11 Sep 2023 20:48:00 +0930
Subject: [PATCH 104/716] [BridgeAbstract] fix undefined index issue (#3665)

* .

* attempt to fix #2943
https://github.com/RSS-Bridge/rss-bridge/issues/2943

* Revert "."

This reverts commit c0b6ccfea6ce873e9c9ce7c3600b3a96d9911468.

* lint

* Revert "attempt to fix #2943"

This reverts commit 9f1a66e48d636a543e2171df212acf9731744bd0.

* moved fix to BridgeAbstract

* fix undefined index

* lint
---
 lib/BridgeAbstract.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index 36a77669..a69552fc 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -192,7 +192,7 @@ abstract class BridgeAbstract implements BridgeInterface
                 if (isset($inputs[$name])) {
                     $value = $inputs[$name];
                 } else {
-                    if ($properties['type'] === 'checkbox') {
+                    if ($properties['type'] ?? null === 'checkbox') {
                         $value = false;
                     } elseif (isset($properties['defaultValue'])) {
                         $value = $properties['defaultValue'];

From 4323a11667806e0f8f3316f426d3834d97ad545d Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Wed, 13 Sep 2023 00:16:11 +0200
Subject: [PATCH 105/716] doc : clarification detectParameters function and
 test (#3666)

* doc : clarification detectParameters function

- clarification about the return value of the detectParameters function
- add info about the constant TEST_DETECT_PARAMETERS to allow automatest
  test of the function detectParameters

* doc : clarification detectParameters function

Add reference to the findFeed action to encourage the implenentation of
the detectParameters function

* doc : clarification detectParameters function

Add commas to improve reading

* doc : clarification detectParameters function

- fix link
---
 docs/05_Bridge_API/02_BridgeAbstract.md | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/docs/05_Bridge_API/02_BridgeAbstract.md b/docs/05_Bridge_API/02_BridgeAbstract.md
index 120361be..12d24bdc 100644
--- a/docs/05_Bridge_API/02_BridgeAbstract.md
+++ b/docs/05_Bridge_API/02_BridgeAbstract.md
@@ -437,9 +437,9 @@ If no icon is specified by the bridge, RSS-Bridge will use a default location: `
 # detectParameters
 The `detectParameters` function takes a URL and attempts to extract a valid set of parameters for the current bridge.
 
-If the passed URL is valid for this bridge the function should return an array of parameter -> value pairs that can be used by this bridge, or an empty array if the bridge requires no parameters. If the URL is not relevant for this bridge the function should return `null`.
+If the passed URL is valid for this bridge, the function should return an array of parameter -> value pairs that can be used by this bridge, including context if available, or an empty array if the bridge requires no parameters. If the URL is not relevant for this bridge, the function should return `null`.
 
-**Notice:** Implementing this function is optional. By default **RSS-Bridge** tries to match the supplied URL to the `URI` constant defined in the bridge which may be enough for bridges without any parameters defined.
+**Notice:** Implementing this function is optional. By default, **RSS-Bridge** tries to match the supplied URL to the `URI` constant defined in the bridge, which may be enough for bridges without any parameters defined.
 
 ```PHP
 public function detectParameters($url){
@@ -455,6 +455,23 @@ public function detectParameters($url){
 }
 ```
 
+**Notice:** This function is also used by the [findFeed](../04_For_Developers/04_Actions.md#findfeed) action. This action allows an user to get a list of all feeds corresponding to an URL.
+
+You can implement automated tests for the `detectParameters` function by adding the `TEST_DETECT_PARAMETERS` constant to your bridge class constant.
+
+`TEST_DETECT_PARAMETERS` is an array, with as key the URL passed to the `detectParameters`function and as value, the array of parameters returned by `detectParameters` 
+
+```PHP
+    const TEST_DETECT_PARAMETERS = [
+        'https://www.instagram.com/metaverse' => ['context' => 'Username', 'u' => 'metaverse'],
+        'https://instagram.com/metaverse' => ['context' => 'Username', 'u' => 'metaverse'],
+        'http://www.instagram.com/metaverse' => ['context' => 'Username', 'u' => 'metaverse'],
+    ];
+```
+
+**Notice:** Adding this constant is optional. If the constant is not present, no automated test will be executed.
+
+
 ***
 
 # Helper Methods

From 0175e13712eaecf87686193c951c87e41e4a058c Mon Sep 17 00:00:00 2001
From: Alexandre Alapetite <alexandre@alapetite.fr>
Date: Wed, 13 Sep 2023 18:08:22 +0200
Subject: [PATCH 106/716] Docker from Debian base image (#3500)

* Docker from Debian base image
* Fix expose https://github.com/RSS-Bridge/rss-bridge/discussions/3234
* Re-fix better logs https://github.com/RSS-Bridge/rss-bridge/pull/3333
* Update to Debian 12 Bookworm instead of Debian 10 Buster
* Use Debian packaging instead of having to keep track of and manually install -dev libraries, and with LTS support
* Update to PHP 8.2 instead of PHP 8.0

* Fix php.ini location

* Minor order changes
To optimise caching
---
 .devcontainer/nginx.conf |  4 ++--
 .gitignore               |  3 +++
 Dockerfile               | 43 +++++++++++++++++++++++++---------------
 config/nginx.conf        |  6 +++---
 config/php-fpm.conf      | 18 +++++++++++++++++
 config/php.ini           |  4 ++++
 docker-entrypoint.sh     |  4 ++--
 7 files changed, 59 insertions(+), 23 deletions(-)
 create mode 100644 config/php-fpm.conf
 create mode 100644 config/php.ini

diff --git a/.devcontainer/nginx.conf b/.devcontainer/nginx.conf
index 46502cb4..0e5db6dc 100644
--- a/.devcontainer/nginx.conf
+++ b/.devcontainer/nginx.conf
@@ -12,6 +12,6 @@ server {
 
     location ~ \.php$ {
         include snippets/fastcgi-php.conf;
-        fastcgi_pass 127.0.0.1:9000;
+        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
     }
-}
\ No newline at end of file
+}
diff --git a/.gitignore b/.gitignore
index f574992d..9725342d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -230,6 +230,9 @@ pip-log.txt
 DEBUG
 config.ini.php
 config/*
+!config/nginx.conf
+!config/php-fpm.conf
+!config/php.ini
 
 ######################
 ## VisualStudioCode ##
diff --git a/Dockerfile b/Dockerfile
index 8157dc12..f504b51f 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,36 +1,47 @@
 FROM lwthiker/curl-impersonate:0.5-ff-slim-buster AS curlimpersonate
 
-FROM php:8.0.27-fpm-buster AS rssbridge
+FROM debian:12-slim AS rssbridge
 
 LABEL description="RSS-Bridge is a PHP project capable of generating RSS and Atom feeds for websites that don't have one."
 LABEL repository="https://github.com/RSS-Bridge/rss-bridge"
 LABEL website="https://github.com/RSS-Bridge/rss-bridge"
 
+ARG DEBIAN_FRONTEND=noninteractive
 RUN apt-get update && \
     apt-get install --yes --no-install-recommends \
+      ca-certificates \
       nginx \
-      zlib1g-dev \
-      libzip-dev \
-      libmemcached-dev \
       nss-plugin-pem \
-      libicu-dev && \
-    docker-php-ext-install zip && \
-    docker-php-ext-install intl && \
-    pecl install memcached && \
-    docker-php-ext-enable memcached && \
-    docker-php-ext-enable opcache && \
-    mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
+      php-curl \
+      php-fpm \
+      php-intl \
+      # php-json is enabled by default with PHP 8.2 in Debian 12
+      php-mbstring \
+      php-memcached \
+      # php-opcache is enabled by default with PHP 8.2 in Debian 12
+      # php-openssl is enabled by default with PHP 8.2 in Debian 12
+      php-sqlite3 \
+      php-xml \
+      php-zip \
+      # php-zlib is enabled by default with PHP 8.2 in Debian 12
+      && \
+    rm -rf /var/lib/apt/lists/*
 
-COPY ./config/nginx.conf /etc/nginx/sites-enabled/default
-
-COPY --chown=www-data:www-data ./ /app/
+# logs should go to stdout / stderr
+RUN ln -sfT /dev/stderr /var/log/nginx/error.log; \
+	ln -sfT /dev/stdout /var/log/nginx/access.log; \
+	chown -R --no-dereference www-data:adm /var/log/nginx/
 
 COPY --from=curlimpersonate /usr/local/lib/libcurl-impersonate-ff.so /usr/local/lib/curl-impersonate/
-
 ENV LD_PRELOAD /usr/local/lib/curl-impersonate/libcurl-impersonate-ff.so
-
 ENV CURL_IMPERSONATE ff91esr
 
+COPY ./config/nginx.conf /etc/nginx/sites-available/default
+COPY ./config/php-fpm.conf /etc/php/8.2/fpm/pool.d/rss-bridge.conf
+COPY ./config/php.ini /etc/php/8.2/fpm/conf.d/90-rss-bridge.conf
+
+COPY --chown=www-data:www-data ./ /app/
+
 EXPOSE 80
 
 ENTRYPOINT ["/app/docker-entrypoint.sh"]
diff --git a/config/nginx.conf b/config/nginx.conf
index bb7b1dcb..f0f189e7 100644
--- a/config/nginx.conf
+++ b/config/nginx.conf
@@ -2,8 +2,8 @@ server {
     listen 80 default_server;
     listen [::]:80 default_server;
     root /app;
-    access_log /dev/stdout;
-    error_log /dev/stderr;
+    access_log /var/log/nginx/access.log;
+    error_log /var/log/nginx/error.log;
     index index.php;
 
     location ~ /(\.|vendor|tests) {
@@ -13,6 +13,6 @@ server {
 
     location ~ \.php$ {
         include snippets/fastcgi-php.conf;
-        fastcgi_pass 127.0.0.1:9000;
+        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
     }
 }
diff --git a/config/php-fpm.conf b/config/php-fpm.conf
new file mode 100644
index 00000000..a508a0f6
--- /dev/null
+++ b/config/php-fpm.conf
@@ -0,0 +1,18 @@
+; Inspired by https://github.com/docker-library/php/blob/master/8.2/bookworm/fpm/Dockerfile
+
+[global]
+error_log = /proc/self/fd/2
+
+; https://github.com/docker-library/php/pull/725#issuecomment-443540114
+log_limit = 8192
+
+[www]
+; php-fpm closes STDOUT on startup, so sending logs to /proc/self/fd/1 does not work.
+; https://bugs.php.net/bug.php?id=73886
+access.log = /proc/self/fd/2
+
+clear_env = no
+
+; Ensure worker stdout and stderr are sent to the main error log.
+catch_workers_output = yes
+decorate_workers_output = no
diff --git a/config/php.ini b/config/php.ini
new file mode 100644
index 00000000..115f1c89
--- /dev/null
+++ b/config/php.ini
@@ -0,0 +1,4 @@
+; Inspired by https://github.com/docker-library/php/blob/master/8.2/bookworm/fpm/Dockerfile
+
+; https://github.com/docker-library/php/issues/878#issuecomment-938595965'
+fastcgi.logging = Off
diff --git a/docker-entrypoint.sh b/docker-entrypoint.sh
index aa95fa87..8dde842c 100755
--- a/docker-entrypoint.sh
+++ b/docker-entrypoint.sh
@@ -41,5 +41,5 @@ fi
 # nginx will daemonize
 nginx
 
-# php-fpm will not
-php-fpm
+# php-fpm should not daemonize
+php-fpm8.2 --nodaemonize

From bb7f329e81deb7661ad88b40858a866da05c3e03 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 13 Sep 2023 22:48:37 +0200
Subject: [PATCH 107/716] fix(instructables): migrate from dom to json api
 (#3667)

---
 bridges/InstructablesBridge.php | 151 +++++++-------------------------
 1 file changed, 30 insertions(+), 121 deletions(-)

diff --git a/bridges/InstructablesBridge.php b/bridges/InstructablesBridge.php
index e1d2ef0b..16e76e8a 100644
--- a/bridges/InstructablesBridge.php
+++ b/bridges/InstructablesBridge.php
@@ -237,132 +237,41 @@ class InstructablesBridge extends BridgeAbstract
 
     public function collectData()
     {
-        // Enable the following line to get the category list (dev mode)
-        // $this->listCategories();
+        $category = $this->getInput('category');
+        $filter = $this->getInput('filter');
 
-        $html = getSimpleHTMLDOM($this->getURI());
-        $html = defaultLinkTo($html, $this->getURI());
+        $api = 'https://www.instructables.com/api_proxy/search/collections/projects/documents/search';
+        //$sortBy = 'views:desc';
+        $sortBy = 'publishDate:desc';
+        //$filterBy = 'featureFlag:=true && category:=Circuits && channel: [Apple,Linux]';
+        $filterBy = 'featureFlag:=true && category:=Circuits';
+        //$filterBy = 'featureFlag:=true && teachers:=Teachers';
+        //$filterBy = 'featureFlag:=true && category:=Craft';
+        $params = [
+            'q'                 => '*',
+            'query_by'          => 'title,stepBody,screenName',
+            'page'              => '1',
+            'sort_by'           => $sortBy,
+            'include_fields'    => 'title,urlString,coverImageUrl,screenName,favorites,views,primaryClassification,featureFlag,prizeLevel,IMadeItCount',
+            'filter_by'         => $filterBy,
+            'per_page'          => '50',
+        ];
 
-        $covers = $html->find('
-			.category-projects-list > div,
-			.category-landing-projects-list > div,
-		');
+        $url = $api . '?' . http_build_query($params);
+        /* phpcs:ignore */
+        $key = 'TUIxY0xkNjdHV09KaFV1dEVxYVRHNGs1QW1sbzlNVVZBaVZKV2VrODc0VT02ZWFYeyJleGNsdWRlX2ZpZWxkcyI6WyJvdXRfb2YiLCJzZWFyY2hfdGltZV9tcyIsInN0ZXBCb2R5Il0sInBlcl9wYWdlIjo2MH0=';
+        $json = getContents($url, ["x-typesense-api-key: $key"]);
+        $data = Json::decode($json, false);
 
-        foreach ($covers as $cover) {
+        foreach ($data->hits as $hit) {
+            $document = $hit->document;
             $item = [];
-
-            $item['uri'] = $cover->find('a.ible-title', 0)->href;
-            $item['title'] = $cover->find('a.ible-title', 0)->innertext;
-            $item['author'] = $this->getCategoryAuthor($cover);
-            $item['content'] = '<a href='
-            . $item['uri']
-            . '><img src='
-            . $cover->find('img', 0)->getAttribute('data-src')
-            . '></a>';
-
-            $item['enclosures'][] = str_replace(
-                '.RECTANGLE1',
-                '.LARGE',
-                $cover->find('img', 0)->getAttribute('data-src')
-            );
-
+            $item['uri'] = 'https://www.instructables.com/' . $document->urlString;
+            $item['author'] = $document->screenName;
+            $item['title'] = $document->title;
+            $item['content'] = '<pre>' . Json::encode($document) . '</pre>';
+            $item['enclosures'] = [$document->coverImageUrl];
             $this->items[] = $item;
         }
     }
-
-    public function getName()
-    {
-        switch ($this->queriedContext) {
-            case 'Category':
-                foreach (self::PARAMETERS[$this->queriedContext]['category']['values'] as $key => $value) {
-                    $subcategory = array_search($this->getInput('category'), $value);
-
-                    if ($subcategory !== false) {
-                        break;
-                    }
-                }
-
-                $filter = array_search(
-                    $this->getInput('filter'),
-                    self::PARAMETERS[$this->queriedContext]['filter']['values']
-                );
-
-                return $subcategory . ' (' . $filter . ') - ' . static::NAME;
-        }
-
-        return parent::getName();
-    }
-
-    public function getURI()
-    {
-        switch ($this->queriedContext) {
-            case 'Category':
-                return self::URI
-                . $this->getInput('category')
-                . $this->getInput('filter');
-        }
-
-        return parent::getURI();
-    }
-
-    /**
-     * Returns a list of categories for development purposes (used to build the
-     * parameters list)
-     */
-    private function listCategories()
-    {
-        // Use home page to acquire main categories
-        $html = getSimpleHTMLDOM(self::URI);
-        $html = defaultLinkTo($html, self::URI);
-
-        foreach ($html->find('.home-content-explore-link') as $category) {
-            // Use arbitrary category to receive full list
-            $html = getSimpleHTMLDOM($category->href);
-
-            foreach ($html->find('.channel-thumbnail a') as $channel) {
-                $name = html_entity_decode(trim($channel->title));
-
-                // Remove unwanted entities
-                $name = str_replace("'", '', $name);
-                $name = str_replace('&#39;', '', $name);
-
-                $uri = $channel->href;
-
-                $category_name = explode('/', $uri)[1];
-
-                if (
-                    !isset($categories)
-                    || !array_key_exists($category_name, $categories)
-                    || !in_array($uri, $categories[$category_name])
-                ) {
-                    $categories[$category_name][$name] = $uri;
-                }
-            }
-        }
-
-        // Build PHP array manually
-        foreach ($categories as $key => $value) {
-            $name = ucfirst($key);
-            echo "'{$name}' => array(\n";
-            echo "\t'All' => '/{$key}/',\n";
-            foreach ($value as $name => $uri) {
-                echo "\t'{$name}' => '{$uri}',\n";
-            }
-            echo "),\n";
-        }
-
-        die;
-    }
-
-    /**
-     * Returns the author as anchor for a given cover.
-     */
-    private function getCategoryAuthor($cover)
-    {
-        return '<a href='
-        . $cover->find('.ible-author a', 0)->href
-        . '>'
-        . $cover->find('.ible-author a', 0)->innertext
-        . '</a>';
-    }
 }

From 409236e48e4cf8bc2e2ce6e6f73942feee6a8469 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 14 Sep 2023 03:26:01 +0200
Subject: [PATCH 108/716] fix: logic bug in 429 caching logic (#3669)

---
 bridges/RedditBridge.php  | 2 +-
 bridges/YoutubeBridge.php | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index 196f7d20..5f6070e3 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -90,8 +90,8 @@ class RedditBridge extends BridgeAbstract
         } catch (HttpException $e) {
             if ($e->getCode() === 429) {
                 $this->cache->set($cacheKey, true, 60 * 16);
-                throw $e;
             }
+            throw $e;
         }
     }
 
diff --git a/bridges/YoutubeBridge.php b/bridges/YoutubeBridge.php
index 8e3ac540..bff62a90 100644
--- a/bridges/YoutubeBridge.php
+++ b/bridges/YoutubeBridge.php
@@ -205,8 +205,8 @@ class YoutubeBridge extends BridgeAbstract
         } catch (HttpException $e) {
             if ($e->getCode() === 429) {
                 $this->cache->set($cacheKey, true, 60 * 16);
-                throw $e;
             }
+            throw $e;
         }
     }
 

From 3b91b1d260f8fc9fd725b9797a3a149e85d408d0 Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Fri, 15 Sep 2023 01:58:06 +0200
Subject: [PATCH 109/716] [XPathBridge] add option to skip htmlspecialchars
 (#3672)

---
 bridges/XPathBridge.php                | 24 ++++++++++++++++++--
 docs/05_Bridge_API/04_XPathAbstract.md |  3 +++
 lib/XPathAbstract.php                  | 31 +++++++++++++++++++++-----
 3 files changed, 51 insertions(+), 7 deletions(-)

diff --git a/bridges/XPathBridge.php b/bridges/XPathBridge.php
index 52346aac..35ec6ad1 100644
--- a/bridges/XPathBridge.php
+++ b/bridges/XPathBridge.php
@@ -59,6 +59,17 @@ EOL, 'type' => 'text',
                 'required' => false
             ],
 
+            'raw_content' => [
+                'name' => 'Use raw item description',
+                'title' => <<<"EOL"
+                Whether to use the raw item description or to replace certain characters with
+                special significance in HTML by HTML entities (using the PHP function htmlspecialchars).
+                EOL,
+                'type' => 'checkbox',
+                'defaultValue' => false,
+                'required' => false
+            ],
+
             'uri' => [
                 'name' => 'Item URL selector',
                 'title' => <<<"EOL"
@@ -178,6 +189,15 @@ EOL, 'type' => 'checkbox',
         return urldecode($this->getInput('content'));
     }
 
+    /**
+     * Use raw item content
+     * @return bool
+     */
+    protected function getSettingUseRawItemContent(): bool
+    {
+        return $this->getInput('raw_content');
+    }
+
     /**
      * XPath expression for extracting an item link from the item context
      * @return string
@@ -226,9 +246,9 @@ EOL, 'type' => 'checkbox',
 
     /**
      * Fix encoding
-     * @return string
+     * @return bool
      */
-    protected function getSettingFixEncoding()
+    protected function getSettingFixEncoding(): bool
     {
         return $this->getInput('fix_encoding');
     }
diff --git a/docs/05_Bridge_API/04_XPathAbstract.md b/docs/05_Bridge_API/04_XPathAbstract.md
index cf091edc..fd697995 100644
--- a/docs/05_Bridge_API/04_XPathAbstract.md
+++ b/docs/05_Bridge_API/04_XPathAbstract.md
@@ -68,6 +68,9 @@ Should return the XPath expression for extracting an item title from the item co
 ### Method `getExpressionItemContent()`
 Should return the XPath expression for extracting an item's content from the item context.
 
+### Method `getSettingUseRawItemContent()`
+Should return the 'Use raw item content' setting value (bool true or false).
+
 ### Method `getExpressionItemUri()`
 Should return the XPath expression for extracting an item link from the item context.
 
diff --git a/lib/XPathAbstract.php b/lib/XPathAbstract.php
index 05929322..bac3bfd7 100644
--- a/lib/XPathAbstract.php
+++ b/lib/XPathAbstract.php
@@ -76,6 +76,15 @@ abstract class XPathAbstract extends BridgeAbstract
      */
     const XPATH_EXPRESSION_ITEM_CONTENT = '';
 
+    /**
+     * Use raw item content
+     * Whether to use the raw item content or to replace certain characters with
+     * special significance in HTML by HTML entities (using the PHP function htmlspecialchars).
+     *
+     * Use {@see XPathAbstract::getSettingUseRawItemContent()} to read this parameter
+     */
+    const SETTING_USE_RAW_ITEM_CONTENT = false;
+
     /**
      * XPath expression for extracting an item link from the item context
      * This expression should match a node's attribute containing the article URL
@@ -236,6 +245,15 @@ abstract class XPathAbstract extends BridgeAbstract
         return static::XPATH_EXPRESSION_ITEM_CONTENT;
     }
 
+    /**
+     * Use raw item content
+     * @return bool
+     */
+    protected function getSettingUseRawItemContent(): bool
+    {
+        return static::SETTING_USE_RAW_ITEM_CONTENT;
+    }
+
     /**
      * XPath expression for extracting an item link from the item context
      * @return string
@@ -284,9 +302,9 @@ abstract class XPathAbstract extends BridgeAbstract
 
     /**
      * Fix encoding
-     * @return string
+     * @return bool
      */
-    protected function getSettingFixEncoding()
+    protected function getSettingFixEncoding(): bool
     {
         return static::SETTING_FIX_ENCODING;
     }
@@ -313,6 +331,8 @@ abstract class XPathAbstract extends BridgeAbstract
                 return $this->getExpressionItemTitle();
             case 'content':
                 return $this->getExpressionItemContent();
+            case 'raw_content':
+                return $this->getSettingUseRawItemContent();
             case 'uri':
                 return $this->getExpressionItemUri();
             case 'author':
@@ -417,7 +437,8 @@ abstract class XPathAbstract extends BridgeAbstract
                     continue;
                 }
 
-                $value = $this->getItemValueOrNodeValue($typedResult, $param === 'content');
+                $isContent = $param === 'content';
+                $value = $this->getItemValueOrNodeValue($typedResult, $isContent, $isContent && !$this->getSettingUseRawItemContent());
                 $item->__set($param, $this->formatParamValue($param, $value));
             }
 
@@ -573,7 +594,7 @@ abstract class XPathAbstract extends BridgeAbstract
      * @param $typedResult
      * @return string
      */
-    protected function getItemValueOrNodeValue($typedResult, $returnXML = false)
+    protected function getItemValueOrNodeValue($typedResult, $returnXML = false, $escapeHtml = false)
     {
         if ($typedResult instanceof \DOMNodeList) {
             $item = $typedResult->item(0);
@@ -596,7 +617,7 @@ abstract class XPathAbstract extends BridgeAbstract
 
         $text = trim($text);
 
-        if ($returnXML) {
+        if ($escapeHtml) {
             return htmlspecialchars($text);
         }
         return $text;

From cf7e3eea5612f3466f297883395723e5b325fd1e Mon Sep 17 00:00:00 2001
From: Scott Colby <scolby33@users.noreply.github.com>
Date: Fri, 15 Sep 2023 17:41:08 -0400
Subject: [PATCH 110/716] Add DeutscheWelle FeedExpander bridge. (#3673)

* [DeutscheWelle] Add DeutscheWelle FeedExpander bridge.

* [DeutscheWelle] Fix linting errors.
---
 bridges/DeutscheWelleBridge.php | 143 ++++++++++++++++++++++++++++++++
 1 file changed, 143 insertions(+)
 create mode 100644 bridges/DeutscheWelleBridge.php

diff --git a/bridges/DeutscheWelleBridge.php b/bridges/DeutscheWelleBridge.php
new file mode 100644
index 00000000..2e10d670
--- /dev/null
+++ b/bridges/DeutscheWelleBridge.php
@@ -0,0 +1,143 @@
+<?php
+
+class DeutscheWelleBridge extends FeedExpander
+{
+    const MAINTAINER = 'No maintainer';
+    const NAME = 'Deutsche Welle Bridge';
+    const URI = 'https://www.dw.com';
+    const DESCRIPTION = 'Returns the full articles instead of only the intro';
+    const CACHE_TIMEOUT = 3600;
+    const PARAMETERS = [[
+        'feed' => [
+            'name' => 'feed',
+            'type' => 'list',
+            'values' => [
+                'All Top Stories and News Updates'
+                => 'http://rss.dw.com/atom/rss-en-all',
+                'Top Stories'
+                => 'http://rss.dw.com/atom/rss-en-top',
+                'Germany'
+                => 'http://rss.dw.com/atom/rss-en-ger',
+                'World'
+                => 'http://rss.dw.com/atom/rss-en-world',
+                'Europe'
+                => 'http://rss.dw.com/atom/rss-en-eu',
+                'Business'
+                => 'http://rss.dw.com/atom/rss-en-bus',
+                'Science'
+                => 'http://rss.dw.com/atom/rss_en_science',
+                'Environment'
+                => 'http://rss.dw.com/atom/rss_en_environment',
+                'Culture & Lifestyle'
+                => 'http://rss.dw.com/atom/rss-en-cul',
+                'Sports'
+                => 'http://rss.dw.de/atom/rss-en-sports',
+                'Visit Germany'
+                => 'http://rss.dw.com/atom/rss-en-visitgermany',
+                'Asia'
+                => 'http://rss.dw.com/atom/rss-en-asia',
+                'Deutsche Welle Gesamt'
+                => 'http://rss.dw.com/atom/rss-de-all',
+                'Themen des Tages'
+                => 'http://rss.dw.com/atom/rss-de-top',
+                'Nachrichten'
+                => 'http://rss.dw.com/atom/rss-de-news',
+                'Wissenschaft'
+                => 'http://rss.dw.com/atom/rss-de-wissenschaft',
+                'Sport'
+                => 'http://rss.dw.com/atom/rss-de-sport',
+                'Deutschland entdecken'
+                => 'http://rss.dw.com/atom/rss-de-deutschlandentdecken',
+                'Presse'
+                => 'http://rss.dw.com/atom/presse',
+                'Politik'
+                => 'http://rss.dw.com/atom/rss_de_politik',
+                'Wirtschaft'
+                => 'http://rss.dw.com/atom/rss-de-eco',
+                'Kultur & Leben'
+                => 'http://rss.dw.com/atom/rss-de-cul',
+                'Kultur & Leben: Buch'
+                => 'http://rss.dw.com/atom/rss-de-cul-buch',
+                'Kultur & Leben: Film'
+                => 'http://rss.dw.com/atom/rss-de-cul-film',
+                'Kultur & Leben: Musik'
+                => 'http://rss.dw.com/atom/rss-de-cul-musik',
+            ]
+        ]
+    ]];
+
+    public function collectData()
+    {
+        $this->collectExpandableDatas($this->getInput('feed'));
+    }
+
+    protected function parseItem($item)
+    {
+        $item = parent::parseItem($item);
+
+        $parsedUrl = parse_url($item['uri']);
+        unset($parsedUrl['query']);
+        $url = $this->unparseUrl($parsedUrl);
+
+        $page = getSimpleHTMLDOM($url);
+        $page = defaultLinkTo($page, $url);
+
+        $article = $page->find('article', 0);
+
+        // author
+        $author = $article->find('.author-link > span', 0);
+        if ($author) {
+            $item['author'] = $author->text();
+        }
+
+        $teaser = $article->find('.teaser-text', 0);
+        if (!is_null($teaser)) {
+            $item['content'] = $teaser->outertext();
+        } else {
+            $item['content'] = '';
+        }
+
+        // remove unneeded elements
+        foreach (
+            $article->find(
+                'header, .advertisement, [data-tracking-name="sharing-icons-inline"], a.external-link > svg, picture > source, .vjs-wrapper, .dw-widget, footer'
+            ) as $bad
+        ) {
+            $bad->remove();
+        }
+        // reload html as remove() is buggy
+        $article = str_get_html($article->outertext());
+
+        // remove width and height values from img tags
+        foreach ($article->find('img') as $img) {
+            $img->width = null;
+            $img->height = null;
+        }
+
+        // replace lazy-loaded images
+        foreach ($article->find('figure.placeholder-image') as $figure) {
+            $img = $figure->find('img', 0);
+            $img->src = str_replace('${formatId}', '906', $img->getAttribute('data-url'));
+            $img->style = null;
+        }
+
+        $item['content'] .= $article->save();
+
+        return $item;
+    }
+
+    // https://www.php.net/manual/en/function.parse-url.php#106731
+    private function unparseUrl($parsed_url)
+    {
+        $scheme = isset($parsed_url['scheme']) ? $parsed_url['scheme'] . '://' : '';
+        $host = isset($parsed_url['host']) ? $parsed_url['host'] : '';
+        $port = isset($parsed_url['port']) ? ':' . $parsed_url['port'] : '';
+        $user = isset($parsed_url['user']) ? $parsed_url['user'] : '';
+        $pass = isset($parsed_url['pass']) ? $parsed_url['pass'] : '';
+        $pass = ($user || $pass) ? "$pass@" : '';
+        $path = isset($parsed_url['path']) ? $parsed_url['path'] : '';
+        $query = isset($parsed_url['query']) ? '?' . $parsed_url['query'] : '';
+        $fragment = isset($parsed_url['fragment']) ? '#' . $parsed_url['fragment'] : '';
+        return "$scheme$user$pass$host$port$path$query$fragment";
+    }
+}

From e6aef73a02f7220f2a2ce8acc9d4f6c627ceb88a Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 20 Sep 2023 02:45:48 +0200
Subject: [PATCH 111/716] refactor (#3668)

---
 actions/DisplayAction.php                  |   8 +-
 docs/05_Bridge_API/02_BridgeAbstract.md    |  49 ++---
 docs/05_Bridge_API/03_FeedExpander.md      |   5 +-
 docs/05_Bridge_API/index.md                |   6 +-
 docs/07_Cache_API/index.md                 |   8 +-
 docs/09_Technical_recommendations/index.md |   2 +-
 lib/BridgeAbstract.php                     | 213 +++++----------------
 lib/BridgeCard.php                         |   6 +-
 lib/BridgeFactory.php                      |   2 +-
 lib/BridgeInterface.php                    | 145 --------------
 lib/FeedExpander.php                       |   2 +-
 lib/RssBridge.php                          |  21 +-
 lib/contents.php                           |  31 ++-
 lib/http.php                               |  17 +-
 tests/Bridges/BridgeImplementationTest.php |   3 +-
 15 files changed, 134 insertions(+), 384 deletions(-)
 delete mode 100644 lib/BridgeInterface.php

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 7c59b3d5..efa4d3b5 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -84,7 +84,7 @@ class DisplayAction implements ActionInterface
         return $response;
     }
 
-    private function createResponse(array $request, BridgeInterface $bridge, FormatInterface $format)
+    private function createResponse(array $request, BridgeAbstract $bridge, FormatInterface $format)
     {
         $items = [];
         $infos = [];
@@ -110,8 +110,6 @@ class DisplayAction implements ActionInterface
                 'icon' => $bridge->getIcon()
             ];
         } catch (\Exception $e) {
-            $errorOutput = Configuration::getConfig('error', 'output');
-            $reportLimit = Configuration::getConfig('error', 'report_limit');
             if ($e instanceof HttpException) {
                 // Reproduce (and log) these responses regardless of error output and report limit
                 if ($e->getCode() === 429) {
@@ -124,6 +122,8 @@ class DisplayAction implements ActionInterface
                 }
             }
             Logger::error(sprintf('Exception in DisplayAction(%s)', $bridge->getShortName()), ['e' => $e]);
+            $errorOutput = Configuration::getConfig('error', 'output');
+            $reportLimit = Configuration::getConfig('error', 'report_limit');
             $errorCount = 1;
             if ($reportLimit > 1) {
                 $errorCount = $this->logBridgeError($bridge->getName(), $e->getCode());
@@ -152,7 +152,7 @@ class DisplayAction implements ActionInterface
         return new Response($format->stringify(), 200, $headers);
     }
 
-    private function createFeedItemFromException($e, BridgeInterface $bridge): FeedItem
+    private function createFeedItemFromException($e, BridgeAbstract $bridge): FeedItem
     {
         $item = new FeedItem();
 
diff --git a/docs/05_Bridge_API/02_BridgeAbstract.md b/docs/05_Bridge_API/02_BridgeAbstract.md
index 12d24bdc..a8e9db42 100644
--- a/docs/05_Bridge_API/02_BridgeAbstract.md
+++ b/docs/05_Bridge_API/02_BridgeAbstract.md
@@ -94,7 +94,7 @@ class MyBridge extends BridgeAbstract {
 	const MAINTAINER  = 'ghost';
 
 	public function collectData() {
-		$item = array(); // Create an empty item
+		$item = []; // Create an empty item
 
 		$item['title'] = 'Hello World!';
 
@@ -121,11 +121,11 @@ class MyBridge extends BridgeAbstract {
 	const URI = '';
 	const DESCRIPTION = 'No description provided';
 	const MAINTAINER = 'No maintainer';
-	const PARAMETERS = array(); // Can be omitted!
+	const PARAMETERS = []; // Can be omitted!
 	const CACHE_TIMEOUT = 3600; // Can be omitted!
 
 	public function collectData() {
-		$item = array(); // Create an empty item
+		$item = []; // Create an empty item
 
 		$item['title'] = 'Hello World!';
 
@@ -145,7 +145,7 @@ For information on how to read parameter values during execution, please refer t
 
 ## Adding parameters to a bridge
 
-Parameters are specified as part of the bridge class. An empty list of parameters is defined as `const PARAMETERS = array();`
+Parameters are specified as part of the bridge class. An empty list of parameters is defined as `const PARAMETERS = [];`
 
 <details><summary>Show example</summary><div>
 
@@ -153,7 +153,7 @@ Parameters are specified as part of the bridge class. An empty list of parameter
 <?PHP
 class MyBridge extends BridgeAbstract {
 	/* ... */
-	const PARAMETERS = array(); // Empty list of parameters (can be omitted)
+	const PARAMETERS = []; // Empty list of parameters (can be omitted)
 	/* ... */
 }
 ```
@@ -172,10 +172,10 @@ A context is defined as a associative array of parameters. The name of a context
 <details><summary>Show example</summary><div>
 
 ```PHP
-const PARAMETERS = array(
-	'My Context 1' => array(),
-	'My Context 2' => array()
-);
+const PARAMETERS = [
+	'My Context 1' => [],
+	'My Context 2' => [],
+];
 ```
 
 **Output**
@@ -189,9 +189,9 @@ _Notice_: The name of a context can be left empty if only one context is needed!
 <details><summary>Show example</summary><div>
 
 ```PHP
-const PARAMETERS = array(
-	array()
-);
+const PARAMETERS = [
+	[]
+];
 ```
 
 </div></details><br>
@@ -201,25 +201,28 @@ You can also define a set of parameters that will be applied to every possible c
 <details><summary>Show example</summary><div>
 
 ```PHP
-const PARAMETERS = array(
-	'global' => array() // Applies to all contexts!
-);
+const PARAMETERS = [
+	'global' => [] // Applies to all contexts!
+];
 ```
 
 </div></details>
 
 ## Level 2 - Parameter
 
-Parameters are placed inside a context. They are defined as associative array of parameter specifications. Each parameter is defined by it's internal input name, a definition in the form `'n' => array();`, where `n` is the name with which the bridge can access the parameter during execution.
+Parameters are placed inside a context.
+They are defined as associative array of parameter specifications.
+Each parameter is defined by it's internal input name, a definition in the form `'n' => [];`, 
+where `n` is the name with which the bridge can access the parameter during execution.
 
 <details><summary>Show example</summary><div>
 
 ```PHP
-const PARAMETERS = array(
-	'My Context' => array(
-		'n' => array()
-	)
-);
+const PARAMETERS = [
+	'My Context' => [
+		'n' => []
+	]
+];
 ```
 
 </div></details><br>
@@ -351,7 +354,7 @@ Elements collected by this function must be stored in `$this->items`. The `items
 
 ```PHP
 
-$item = array(); // Create a new item
+$item = []; // Create a new item
 
 $item['title'] = 'Hello World!';
 
@@ -448,7 +451,7 @@ public function detectParameters($url){
 	&& preg_match($regex, $url, $urlMatches) > 0
 	&& preg_match($regex, static::URI, $bridgeUriMatches) > 0
 	&& $urlMatches[3] === $bridgeUriMatches[3]) {
-		return array();
+		return [];
 	} else {
 		return null;
 	}
diff --git a/docs/05_Bridge_API/03_FeedExpander.md b/docs/05_Bridge_API/03_FeedExpander.md
index 7e72670a..910d1abb 100644
--- a/docs/05_Bridge_API/03_FeedExpander.md
+++ b/docs/05_Bridge_API/03_FeedExpander.md
@@ -93,10 +93,11 @@ class MySiteBridge extends FeedExpander {
 	const NAME = 'Unnamed bridge';
 	const URI = '';
 	const DESCRIPTION = 'No description provided';
-	const PARAMETERS = array();
+	const PARAMETERS = [];
 	const CACHE_TIMEOUT = 3600;
 
-    public function collectData(){
+    public function collectData()
+    {
         $this->collectExpandableDatas('your feed URI');
     }
 }
diff --git a/docs/05_Bridge_API/index.md b/docs/05_Bridge_API/index.md
index 6115fa01..e49e47be 100644
--- a/docs/05_Bridge_API/index.md
+++ b/docs/05_Bridge_API/index.md
@@ -1,4 +1,8 @@
-A _Bridge_ is an class that allows **RSS-Bridge** to create an RSS-feed from a website. A _Bridge_ represents one element on the [Welcome screen](../01_General/04_Screenshots.md) and covers one or more sites to return feeds for. It is developed in a PHP file located in the `bridges/` folder (see [Folder structure](../04_For_Developers/03_Folder_structure.md)) and extends one of the base classes of **RSS-Bridge**:
+A _Bridge_ is a class that allows **RSS-Bridge** to create an RSS-feed from a website.
+A _Bridge_ represents one element on the [Welcome screen](../01_General/04_Screenshots.md)
+and covers one or more sites to return feeds for.
+It is developed in a PHP file located in the `bridges/` folder (see [Folder structure](../04_For_Developers/03_Folder_structure.md))
+and extends one of the base classes of **RSS-Bridge**:
 
 Base class | Description
 -----------|------------
diff --git a/docs/07_Cache_API/index.md b/docs/07_Cache_API/index.md
index 57692847..17afbacc 100644
--- a/docs/07_Cache_API/index.md
+++ b/docs/07_Cache_API/index.md
@@ -1,4 +1,6 @@
-A _Cache_ is a class that allows **RSS-Bridge** to store fetched data in a local storage area on the server. Cache imlementations are placed in the `caches/` folder (see [Folder structure](../04_For_Developers/03_Folder_structure.md)). A cache must implement the [`CacheInterface`](../07_Cache_API/02_CacheInterface.md) interface.
-
-For more information about how to create a new `Cache`, read [How to create a new cache?](../07_Cache_API/01_How_to_create_a_new_cache.md)
+A _Cache_ is a class that allows **RSS-Bridge** to store fetched data in a local storage area on the server.
+Cache imlementations are placed in the `caches/` folder (see [Folder structure](../04_For_Developers/03_Folder_structure.md)).
+A cache must implement the [`CacheInterface`](../07_Cache_API/02_CacheInterface.md) interface.
 
+For more information about how to create a new `Cache`, read
+[How to create a new cache?](../07_Cache_API/01_How_to_create_a_new_cache.md)
diff --git a/docs/09_Technical_recommendations/index.md b/docs/09_Technical_recommendations/index.md
index f2b15476..a57f0bbd 100644
--- a/docs/09_Technical_recommendations/index.md
+++ b/docs/09_Technical_recommendations/index.md
@@ -15,7 +15,7 @@ class TestBridge extends BridgeAbstract {
 	const URI = '';
 	const DESCRIPTION = 'No description provided';
 	const MAINTAINER = 'No maintainer';
-	const PARAMETERS = array();
+	const PARAMETERS = [];
 	const CACHE_TIMEOUT = 3600;
 
 	public function collectData(){
diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index a69552fc..f51fe893 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -1,76 +1,15 @@
 <?php
 
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
-abstract class BridgeAbstract implements BridgeInterface
+abstract class BridgeAbstract
 {
-    /**
-     * Name of the bridge
-     *
-     * Use {@see BridgeAbstract::getName()} to read this parameter
-     */
     const NAME = 'Unnamed bridge';
-
-    /**
-     * URI to the site the bridge is intended to be used for.
-     *
-     * Use {@see BridgeAbstract::getURI()} to read this parameter
-     */
     const URI = '';
-
-    /**
-     * Donation URI to the site the bridge is intended to be used for.
-     *
-     * Use {@see BridgeAbstract::getDonationURI()} to read this parameter
-     */
     const DONATION_URI = '';
-
-    /**
-     * A brief description of what the bridge can do
-     *
-     * Use {@see BridgeAbstract::getDescription()} to read this parameter
-     */
     const DESCRIPTION = 'No description provided';
-
-    /**
-     * The name of the maintainer. Multiple maintainers can be separated by comma
-     *
-     * Use {@see BridgeAbstract::getMaintainer()} to read this parameter
-     */
     const MAINTAINER = 'No maintainer';
-
-    /**
-     * The default cache timeout for the bridge
-     *
-     * Use {@see BridgeAbstract::getCacheTimeout()} to read this parameter
-     */
     const CACHE_TIMEOUT = 3600;
-
-    /**
-     * Configuration for the bridge
-     */
     const CONFIGURATION = [];
-
-    /**
-     * Parameters for the bridge
-     *
-     * Use {@see BridgeAbstract::getParameters()} to read this parameter
-     */
     const PARAMETERS = [];
-
-    /**
-     * Test cases for detectParameters for the bridge
-     */
     const TEST_DETECT_PARAMETERS = [];
 
     /**
@@ -83,49 +22,67 @@ abstract class BridgeAbstract implements BridgeInterface
         'title'         => 'Maximum number of items to return',
     ];
 
-    /**
-     * Holds the list of items collected by the bridge
-     *
-     * Items must be collected by {@see BridgeInterface::collectData()}
-     *
-     * Use {@see BridgeAbstract::getItems()} to access items.
-     *
-     * @var array
-     */
     protected array $items = [];
-
-    /**
-     * Holds the list of input parameters used by the bridge
-     *
-     * Do not access this parameter directly!
-     * Use {@see BridgeAbstract::setInputs()} and {@see BridgeAbstract::getInput()} instead!
-     *
-     * @var array
-     */
     protected array $inputs = [];
-
-    /**
-     * Holds the name of the queried context
-     *
-     * @var string
-     */
-    protected $queriedContext = '';
-
-    /**
-     * Holds the list of bridge-specific configurations from config.ini.php, used by the bridge.
-     */
+    protected string $queriedContext = '';
     private array $configuration = [];
 
     public function __construct()
     {
     }
 
-    /** {@inheritdoc} */
+    abstract public function collectData();
+
     public function getItems()
     {
         return $this->items;
     }
 
+    public function getOption(string $name)
+    {
+        return $this->configuration[$name] ?? null;
+    }
+
+    public function getDescription()
+    {
+        return static::DESCRIPTION;
+    }
+
+    public function getMaintainer(): string
+    {
+        return static::MAINTAINER;
+    }
+
+    public function getName()
+    {
+        return static::NAME;
+    }
+
+    public function getIcon()
+    {
+        return static::URI . '/favicon.ico';
+    }
+
+    public function getParameters(): array
+    {
+        return static::PARAMETERS;
+    }
+
+    public function getURI()
+    {
+        return static::URI;
+    }
+
+    public function getDonationURI(): string
+    {
+        return static::DONATION_URI;
+    }
+
+    public function getCacheTimeout()
+    {
+        return static::CACHE_TIMEOUT;
+    }
+
     /**
      * Sets the input values for a given context.
      *
@@ -299,10 +256,7 @@ abstract class BridgeAbstract implements BridgeInterface
      */
     protected function getInput($input)
     {
-        if (!isset($this->inputs[$this->queriedContext][$input]['value'])) {
-            return null;
-        }
-        return $this->inputs[$this->queriedContext][$input]['value'];
+        return $this->inputs[$this->queriedContext][$input]['value'] ?? null;
     }
 
     /**
@@ -340,63 +294,6 @@ abstract class BridgeAbstract implements BridgeInterface
         }
     }
 
-    /**
-     * Get bridge configuration value
-     */
-    public function getOption($name)
-    {
-        return $this->configuration[$name] ?? null;
-    }
-
-    /** {@inheritdoc} */
-    public function getDescription()
-    {
-        return static::DESCRIPTION;
-    }
-
-    /** {@inheritdoc} */
-    public function getMaintainer()
-    {
-        return static::MAINTAINER;
-    }
-
-    /** {@inheritdoc} */
-    public function getName()
-    {
-        return static::NAME;
-    }
-
-    /** {@inheritdoc} */
-    public function getIcon()
-    {
-        return static::URI . '/favicon.ico';
-    }
-
-    /** {@inheritdoc} */
-    public function getParameters()
-    {
-        return static::PARAMETERS;
-    }
-
-    /** {@inheritdoc} */
-    public function getURI()
-    {
-        return static::URI;
-    }
-
-    /** {@inheritdoc} */
-    public function getDonationURI()
-    {
-        return static::DONATION_URI;
-    }
-
-    /** {@inheritdoc} */
-    public function getCacheTimeout()
-    {
-        return static::CACHE_TIMEOUT;
-    }
-
-    /** {@inheritdoc} */
     public function detectParameters($url)
     {
         $regex = '/^(https?:\/\/)?(www\.)?(.+?)(\/)?$/';
@@ -411,11 +308,6 @@ abstract class BridgeAbstract implements BridgeInterface
         return null;
     }
 
-    /**
-     * Loads a cached value for the specified key
-     *
-     * @return mixed Cached value or null if the key doesn't exist or has expired
-     */
     protected function loadCacheValue(string $key)
     {
         $cache = RssBridge::getCache();
@@ -423,11 +315,6 @@ abstract class BridgeAbstract implements BridgeInterface
         return $cache->get($cacheKey);
     }
 
-    /**
-     * Stores a value to cache with the specified key
-     *
-     * @param mixed $value Value to cache
-     */
     protected function saveCacheValue(string $key, $value, $ttl = 86400)
     {
         $cache = RssBridge::getCache();
diff --git a/lib/BridgeCard.php b/lib/BridgeCard.php
index 6eef3879..99c44fff 100644
--- a/lib/BridgeCard.php
+++ b/lib/BridgeCard.php
@@ -25,7 +25,7 @@ final class BridgeCard
     /**
      * Gets a single bridge card
      *
-     * @param class-string<BridgeInterface> $bridgeClassName The bridge name
+     * @param class-string<BridgeAbstract> $bridgeClassName The bridge name
      * @param array $formats A list of formats
      * @param bool $isActive Indicates if the bridge is active or not
      * @return string The bridge card
@@ -116,7 +116,7 @@ CARD;
     /**
      * Get the form header for a bridge card
      *
-     * @param class-string<BridgeInterface> $bridgeClassName The bridge name
+     * @param class-string<BridgeAbstract> $bridgeClassName The bridge name
      * @param bool $isHttps If disabled, adds a warning to the form
      * @return string The form header
      */
@@ -143,7 +143,7 @@ This bridge is not fetching its content through a secure connection</div>';
     /**
      * Get the form body for a bridge
      *
-     * @param class-string<BridgeInterface> $bridgeClassName The bridge name
+     * @param class-string<BridgeAbstract> $bridgeClassName The bridge name
      * @param array $formats A list of supported formats
      * @param bool $isActive Indicates if a bridge is enabled or not
      * @param bool $isHttps Indicates if a bridge uses HTTPS or not
diff --git a/lib/BridgeFactory.php b/lib/BridgeFactory.php
index f302a27a..12565d92 100644
--- a/lib/BridgeFactory.php
+++ b/lib/BridgeFactory.php
@@ -34,7 +34,7 @@ final class BridgeFactory
         }
     }
 
-    public function create(string $name): BridgeInterface
+    public function create(string $name): BridgeAbstract
     {
         return new $name();
     }
diff --git a/lib/BridgeInterface.php b/lib/BridgeInterface.php
deleted file mode 100644
index 63bc7b70..00000000
--- a/lib/BridgeInterface.php
+++ /dev/null
@@ -1,145 +0,0 @@
-<?php
-
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
-/**
- * The bridge interface
- *
- * A bridge is a class that is responsible for collecting and transforming data
- * from one hosting provider into an internal representation of feed data, that
- * can later be transformed into different feed formats (see {@see FormatInterface}).
- *
- * For this purpose, all bridges need to perform three common operations:
- *
- * 1. Collect data from a remote site.
- * 2. Extract the required contents.
- * 3. Add the contents to the internal data structure.
- *
- * Bridges can optionally specify parameters to customize bridge behavior based
- * on user input. For example, a user could specify how many items to return in
- * the feed and where to get them.
- *
- * In order to present a bridge on the home page, and for the purpose of bridge
- * specific behaviour, additional information must be provided by the bridge:
- *
- * * **Name**
- * The name of the bridge that can be displayed to users.
- *
- * * **Description**
- * A brief description for the bridge that can be displayed to users.
- *
- * * **URI**
- * A link to the hosting provider.
- *
- * * **Maintainer**
- * The GitHub username of the bridge maintainer
- *
- * * **Parameters**
- * A list of parameters for customization
- *
- * * **Icon**
- * A link to the favicon of the hosting provider
- *
- * * **Cache timeout**
- * The default cache timeout for the bridge.
- */
-interface BridgeInterface
-{
-    /**
-     * Collects data from the site
-     *
-     * @return void
-     */
-    public function collectData();
-
-    /**
-     * Returns the value for the selected configuration
-     *
-     * @param string $input The option name
-     * @return mixed|null The option value or null if the input is not defined
-     */
-    public function getOption($name);
-
-    /**
-     * Returns the description
-     *
-     * @return string Description
-     */
-    public function getDescription();
-
-    /**
-     * Returns an array of collected items
-     *
-     * @return array Associative array of items
-     */
-    public function getItems();
-
-    /**
-     * Returns the bridge maintainer
-     *
-     * @return string Bridge maintainer
-     */
-    public function getMaintainer();
-
-    /**
-     * Returns the bridge name
-     *
-     * @return string Bridge name
-     */
-    public function getName();
-
-    /**
-     * Returns the bridge icon
-     *
-     * @return string Bridge icon
-     */
-    public function getIcon();
-
-    /**
-     * Returns the bridge parameters
-     *
-     * @return array Bridge parameters
-     */
-    public function getParameters();
-
-    /**
-     * Returns the bridge URI
-     *
-     * @return string Bridge URI
-     */
-    public function getURI();
-
-    /**
-     * Returns the bridge Donation URI
-     *
-     * @return string Bridge Donation URI
-     */
-    public function getDonationURI();
-
-    /**
-     * Returns the cache timeout
-     *
-     * @return int Cache timeout
-     */
-    public function getCacheTimeout();
-
-    /**
-     * Returns parameters from given URL or null if URL is not applicable
-     *
-     * @param string $url URL to extract parameters from
-     * @return array|null List of bridge parameters or null if detection failed.
-     */
-    public function detectParameters($url);
-
-    public function getShortName(): string;
-}
diff --git a/lib/FeedExpander.php b/lib/FeedExpander.php
index be467336..af06cc16 100644
--- a/lib/FeedExpander.php
+++ b/lib/FeedExpander.php
@@ -74,7 +74,7 @@ abstract class FeedExpander extends BridgeAbstract
     /**
      * Collects data from an existing feed.
      *
-     * Children should call this function in {@see BridgeInterface::collectData()}
+     * Children should call this function in {@see BridgeAbstract::collectData()}
      * to extract a feed.
      *
      * @param string $url URL to the feed.
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index 1c6ce464..32dad269 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -15,6 +15,9 @@ final class RssBridge
         }
         Configuration::loadConfiguration($customConfig, getenv());
 
+        // Consider: ini_set('error_reporting', E_ALL & ~E_DEPRECATED);
+        date_default_timezone_set(Configuration::getConfig('system', 'timezone'));
+
         set_exception_handler(function (\Throwable $e) {
             Logger::error('Uncaught Exception', ['e' => $e]);
             http_response_code(500);
@@ -57,9 +60,6 @@ final class RssBridge
             }
         });
 
-        // Consider: ini_set('error_reporting', E_ALL & ~E_DEPRECATED);
-        date_default_timezone_set(Configuration::getConfig('system', 'timezone'));
-
         self::$httpClient = new CurlHttpClient();
 
         $cacheFactory = new CacheFactory();
@@ -68,11 +68,6 @@ final class RssBridge
         } else {
             self::$cache = $cacheFactory->create();
         }
-
-        if (Configuration::getConfig('authentication', 'enable')) {
-            $authenticationMiddleware = new AuthenticationMiddleware();
-            $authenticationMiddleware();
-        }
     }
 
     public function main(array $argv = []): void
@@ -81,6 +76,10 @@ final class RssBridge
             parse_str(implode('&', array_slice($argv, 1)), $cliArgs);
             $request = $cliArgs;
         } else {
+            if (Configuration::getConfig('authentication', 'enable')) {
+                $authenticationMiddleware = new AuthenticationMiddleware();
+                $authenticationMiddleware();
+            }
             $request = array_merge($_GET, $_POST);
         }
 
@@ -124,10 +123,4 @@ final class RssBridge
     {
         return self::$cache ?? new NullCache();
     }
-
-    public function clearCache()
-    {
-        $cache = self::getCache();
-        $cache->clear();
-    }
 }
diff --git a/lib/contents.php b/lib/contents.php
index c1847758..e173b542 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -16,6 +16,13 @@ function getContents(
 ) {
     $httpClient = RssBridge::getHttpClient();
 
+    $httpHeadersNormalized = [];
+    foreach ($httpHeaders as $httpHeader) {
+        $parts = explode(':', $httpHeader);
+        $headerName = trim($parts[0]);
+        $headerValue = trim(implode(':', array_slice($parts, 1)));
+        $httpHeadersNormalized[$headerName] = $headerValue;
+    }
     // Snagged from https://github.com/lwthiker/curl-impersonate/blob/main/firefox/curl_ff102
     $defaultHttpHeaders = [
         'Accept' => 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8',
@@ -27,13 +34,6 @@ function getContents(
         'Sec-Fetch-User' => '?1',
         'TE' => 'trailers',
     ];
-    $httpHeadersNormalized = [];
-    foreach ($httpHeaders as $httpHeader) {
-        $parts = explode(':', $httpHeader);
-        $headerName = trim($parts[0]);
-        $headerValue = trim(implode(':', array_slice($parts, 1)));
-        $httpHeadersNormalized[$headerName] = $headerValue;
-    }
     $config = [
         'useragent' => Configuration::getConfig('http', 'useragent'),
         'timeout' => Configuration::getConfig('http', 'timeout'),
@@ -43,7 +43,7 @@ function getContents(
 
     $maxFileSize = Configuration::getConfig('http', 'max_filesize');
     if ($maxFileSize) {
-        // Multiply with 2^20 (1M) to the value in bytes
+        // Convert from MB to B by multiplying with 2^20 (1M)
         $config['max_filesize'] = $maxFileSize * 2 ** 20;
     }
 
@@ -57,7 +57,6 @@ function getContents(
     /** @var Response $cachedResponse */
     $cachedResponse = $cache->get($cacheKey);
     if ($cachedResponse) {
-        // considering popping
         $cachedLastModified = $cachedResponse->getHeader('last-modified');
         if ($cachedLastModified) {
             $cachedLastModified = new \DateTimeImmutable($cachedLastModified);
@@ -101,21 +100,13 @@ function getContents(
                 Debug::isEnabled() ? mb_substr($response->getBody(), 0, 500) : '',
             );
 
-            // The following code must be extracted if it grows too much
-            $cloudflareTitles = [
-                '<title>Just a moment...',
-                '<title>Please Wait...',
-                '<title>Attention Required!',
-                '<title>Security | Glassdoor',
-            ];
-            foreach ($cloudflareTitles as $cloudflareTitle) {
-                if (str_contains($response->getBody(), $cloudflareTitle)) {
-                    throw new CloudFlareException($exceptionMessage, $response->getCode());
-                }
+            if (CloudFlareException::isCloudFlareResponse($response)) {
+                throw new CloudFlareException($exceptionMessage, $response->getCode());
             }
             throw new HttpException(trim($exceptionMessage), $response->getCode());
     }
     if ($returnFull === true) {
+        // todo: return the actual response object
         return [
             'code'      => $response->getCode(),
             'headers'   => $response->getHeaders(),
diff --git a/lib/http.php b/lib/http.php
index c5e65e77..cc1d0e22 100644
--- a/lib/http.php
+++ b/lib/http.php
@@ -6,6 +6,21 @@ class HttpException extends \Exception
 
 final class CloudFlareException extends HttpException
 {
+    public static function isCloudFlareResponse(Response $response): bool
+    {
+        $cloudflareTitles = [
+            '<title>Just a moment...',
+            '<title>Please Wait...',
+            '<title>Attention Required!',
+            '<title>Security | Glassdoor',
+        ];
+        foreach ($cloudflareTitles as $cloudflareTitle) {
+            if (str_contains($response->getBody(), $cloudflareTitle)) {
+                return true;
+            }
+        }
+        return false;
+    }
 }
 
 interface HttpClient
@@ -119,7 +134,7 @@ final class CurlHttpClient implements HttpClient
             }
         }
 
-        $statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
+        $statusCode = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
         curl_close($ch);
         return new Response($data, $statusCode, $responseHeaders);
     }
diff --git a/tests/Bridges/BridgeImplementationTest.php b/tests/Bridges/BridgeImplementationTest.php
index cf03f356..807649fc 100644
--- a/tests/Bridges/BridgeImplementationTest.php
+++ b/tests/Bridges/BridgeImplementationTest.php
@@ -3,7 +3,6 @@
 namespace RssBridge\Tests\Bridges;
 
 use BridgeAbstract;
-use BridgeInterface;
 use FeedExpander;
 use PHPUnit\Framework\TestCase;
 
@@ -29,7 +28,7 @@ class BridgeImplementationTest extends TestCase
     public function testClassType($path)
     {
         $this->setBridge($path);
-        $this->assertInstanceOf(BridgeInterface::class, $this->obj);
+        $this->assertInstanceOf(BridgeAbstract::class, $this->obj);
     }
 
     /**

From 0bf38e5c56a795301d540f4b0ce6e9bd9935b058 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 20 Sep 2023 03:15:15 +0200
Subject: [PATCH 112/716] fix: small notice errors (#3677)

* fix notice

* fix notice

* tweak

* tweaks
---
 bridges/CodebergBridge.php     |  7 +++++-
 bridges/TelegramBridge.php     |  7 ++++--
 bridges/ThePirateBayBridge.php |  1 +
 bridges/TwitchBridge.php       | 41 ++++++++++++++--------------------
 4 files changed, 29 insertions(+), 27 deletions(-)

diff --git a/bridges/CodebergBridge.php b/bridges/CodebergBridge.php
index 83775885..c13ff004 100644
--- a/bridges/CodebergBridge.php
+++ b/bridges/CodebergBridge.php
@@ -181,7 +181,12 @@ class CodebergBridge extends BridgeAbstract
             $item['title'] = $message->find('span.message-wrapper', 0)->plaintext;
             $item['uri'] = $tr->find('td.sha', 0)->find('a', 0)->href;
             $item['author'] = $tr->find('td.author', 0)->plaintext;
-            $item['timestamp'] = $tr->find('td', 3)->find('span', 0)->title;
+
+            $var = $tr->find('td', 3);
+            $var1 = $var->find('span', 0);
+            if ($var1) {
+                $item['timestamp'] = $var1->title;
+            }
 
             if ($message->find('pre.commit-body', 0)) {
                 $message->find('pre.commit-body', 0)->style = '';
diff --git a/bridges/TelegramBridge.php b/bridges/TelegramBridge.php
index 9d73e06e..a3c910e8 100644
--- a/bridges/TelegramBridge.php
+++ b/bridges/TelegramBridge.php
@@ -55,8 +55,11 @@ class TelegramBridge extends BridgeAbstract
             $item['title'] = $this->itemTitle;
             $item['timestamp'] = $messageDiv->find('span.tgme_widget_message_meta', 0)->find('time', 0)->datetime;
             $item['enclosures'] = $this->enclosures;
-            $author = trim($messageDiv->find('a.tgme_widget_message_owner_name', 0)->plaintext);
-            $item['author'] = html_entity_decode($author, ENT_QUOTES);
+
+            $messageOwner = $messageDiv->find('a.tgme_widget_message_owner_name', 0);
+            if ($messageOwner) {
+                $item['author'] = html_entity_decode(trim($messageOwner->plaintext), ENT_QUOTES);
+            }
 
             $this->items[] = $item;
         }
diff --git a/bridges/ThePirateBayBridge.php b/bridges/ThePirateBayBridge.php
index 5b305c82..27732db5 100644
--- a/bridges/ThePirateBayBridge.php
+++ b/bridges/ThePirateBayBridge.php
@@ -65,6 +65,7 @@ class ThePirateBayBridge extends BridgeAbstract
         '207' => 'HD Movies',
         '208' => 'HD TV-Shows',
         '209' => '3D',
+        '211' => 'UHD/4k Movies',
         '212' => 'UHD/4k TV-Shows',
         '299' => 'Other',
         '301' => 'Windows',
diff --git a/bridges/TwitchBridge.php b/bridges/TwitchBridge.php
index 146fed3d..e4abaa60 100644
--- a/bridges/TwitchBridge.php
+++ b/bridges/TwitchBridge.php
@@ -90,7 +90,8 @@ EOD;
             'channel' => $channel,
             'types' => self::BROADCAST_TYPES[$type]
         ];
-        $data = $this->apiRequest($query, $variables);
+        $response = $this->apiRequest($query, $variables);
+        $data = $response->data;
         if ($data->user === null) {
             throw new \Exception(sprintf('Unable to find channel `%s`', $channel));
         }
@@ -205,37 +206,29 @@ EOD;
         );
     }
 
-    // GraphQL: https://graphql.org/
-    // Tool for developing/testing queries: https://github.com/skevy/graphiql-app
+    /**
+     * GraphQL: https://graphql.org/
+     * Tool for developing/testing queries: https://github.com/skevy/graphiql-app
+     *
+     * Official instructions for obtaining your own client ID can be found here:
+     * https://dev.twitch.tv/docs/v5/#getting-a-client-id
+     */
     private function apiRequest($query, $variables)
     {
         $request = [
-            'query' => $query,
-            'variables' => $variables
+            'query'     => $query,
+            'variables' => $variables,
         ];
-        /**
-         * Official instructions for obtaining your own client ID can be found here:
-         * https://dev.twitch.tv/docs/v5/#getting-a-client-id
-         */
-        $header = [
-            'Client-ID: kimne78kx3ncx6brgo4mv6wki5h1ko'
+        $headers = [
+            'Client-ID: kimne78kx3ncx6brgo4mv6wki5h1ko',
         ];
         $opts = [
             CURLOPT_CUSTOMREQUEST => 'POST',
-            CURLOPT_POSTFIELDS => json_encode($request)
+            CURLOPT_POSTFIELDS => json_encode($request),
         ];
-
-        Logger::debug("Sending GraphQL query:\n" . $query);
-        Logger::debug("Sending GraphQL variables:\n" . json_encode($variables, JSON_PRETTY_PRINT));
-        $response = json_decode(getContents('https://gql.twitch.tv/gql', $header, $opts));
-        Logger::debug("Got GraphQL response:\n" . json_encode($response, JSON_PRETTY_PRINT));
-
-        if (isset($response->errors)) {
-            $messages = array_column($response->errors, 'message');
-            throw new \Exception(sprintf('twitch api: `%s`', implode("\n", $messages)));
-        }
-
-        return $response->data;
+        $json = getContents('https://gql.twitch.tv/gql', $headers, $opts);
+        $result = Json::decode($json, false);
+        return $result;
     }
 
     public function getName()

From 360f953be82b7340bd153991bdc87f699db598a4 Mon Sep 17 00:00:00 2001
From: Julien Papasian <papjul@users.noreply.github.com>
Date: Thu, 21 Sep 2023 18:55:53 +0200
Subject: [PATCH 113/716] Fix #3674 - [Nautiljon] Remove requirement of cURL
 NSS (#3679)

Looks like it works with OpenSSL now.
---
 bridges/NautiljonBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/NautiljonBridge.php b/bridges/NautiljonBridge.php
index 611ffc2f..a689e5f5 100644
--- a/bridges/NautiljonBridge.php
+++ b/bridges/NautiljonBridge.php
@@ -4,7 +4,7 @@ class NautiljonBridge extends BridgeAbstract
 {
     const NAME = 'Nautiljon Bridge';
     const URI = 'https://www.nautiljon.com';
-    const DESCRIPTION = 'Actualités et Brèves de Nautiljon. Nécessite une version NSS de cURL pour fonctionner.';
+    const DESCRIPTION = 'Actualités et Brèves de Nautiljon.';
     const MAINTAINER = 'papjul';
 
     const PARAMETERS = [

From 7329b83cc0fe1a5f707f864b1f3d62efd4be2172 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 21 Sep 2023 22:05:55 +0200
Subject: [PATCH 114/716] refactor: logger (#3678)

---
 actions/DisplayAction.php                  |  14 +-
 actions/SetBridgeCacheAction.php           |  12 +-
 bridges/EZTVBridge.php                     |   1 -
 bridges/ElloBridge.php                     |   5 +-
 bridges/FeedMergeBridge.php                |   4 +-
 bridges/ImgsedBridge.php                   |   2 +-
 bridges/InstagramBridge.php                |   5 +-
 bridges/RedditBridge.php                   |   6 -
 bridges/SoundcloudBridge.php               |   3 -
 bridges/SpotifyBridge.php                  |   5 +-
 bridges/TwitterBridge.php                  |   3 +-
 bridges/YoutubeBridge.php                  |   8 +-
 bridges/ZDNetBridge.php                    |   4 +-
 caches/FileCache.php                       |  10 +-
 caches/MemcachedCache.php                  |  11 +-
 caches/SQLiteCache.php                     |  13 +-
 lib/BridgeAbstract.php                     |  17 +-
 lib/BridgeFactory.php                      |   9 +-
 lib/CacheFactory.php                       |  14 +-
 lib/Debug.php                              |   4 +-
 lib/FeedExpander.php                       |   2 +-
 lib/Logger.php                             |  97 ------------
 lib/RssBridge.php                          |  36 +++--
 lib/bootstrap.php                          |   1 +
 lib/logger.php                             | 172 +++++++++++++++++++++
 tests/Actions/ActionImplementationTest.php |  69 ---------
 tests/Actions/ListActionTest.php           |  76 ---------
 tests/BridgeFactoryTest.php                |  19 +--
 tests/Bridges/BridgeImplementationTest.php |   5 +-
 tests/CacheTest.php                        |   8 +-
 30 files changed, 297 insertions(+), 338 deletions(-)
 delete mode 100644 lib/Logger.php
 create mode 100644 lib/logger.php
 delete mode 100644 tests/Actions/ActionImplementationTest.php
 delete mode 100644 tests/Actions/ListActionTest.php

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index efa4d3b5..87b040c2 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -3,13 +3,19 @@
 class DisplayAction implements ActionInterface
 {
     private CacheInterface $cache;
+    private Logger $logger;
+
+    public function __construct()
+    {
+        $this->cache = RssBridge::getCache();
+        $this->logger = RssBridge::getLogger();
+    }
 
     public function execute(array $request)
     {
         if (Configuration::getConfig('system', 'enable_maintenance_mode')) {
             return new Response('503 Service Unavailable', 503);
         }
-        $this->cache = RssBridge::getCache();
         $cacheKey = 'http_' . json_encode($request);
         /** @var Response $cachedResponse */
         $cachedResponse = $this->cache->get($cacheKey);
@@ -113,15 +119,15 @@ class DisplayAction implements ActionInterface
             if ($e instanceof HttpException) {
                 // Reproduce (and log) these responses regardless of error output and report limit
                 if ($e->getCode() === 429) {
-                    Logger::info(sprintf('Exception in DisplayAction(%s): %s', $bridge->getShortName(), create_sane_exception_message($e)));
+                    $this->logger->info(sprintf('Exception in DisplayAction(%s): %s', $bridge->getShortName(), create_sane_exception_message($e)));
                     return new Response('429 Too Many Requests', 429);
                 }
                 if ($e->getCode() === 503) {
-                    Logger::info(sprintf('Exception in DisplayAction(%s): %s', $bridge->getShortName(), create_sane_exception_message($e)));
+                    $this->logger->info(sprintf('Exception in DisplayAction(%s): %s', $bridge->getShortName(), create_sane_exception_message($e)));
                     return new Response('503 Service Unavailable', 503);
                 }
             }
-            Logger::error(sprintf('Exception in DisplayAction(%s)', $bridge->getShortName()), ['e' => $e]);
+            $this->logger->error(sprintf('Exception in DisplayAction(%s)', $bridge->getShortName()), ['e' => $e]);
             $errorOutput = Configuration::getConfig('error', 'output');
             $reportLimit = Configuration::getConfig('error', 'report_limit');
             $errorCount = 1;
diff --git a/actions/SetBridgeCacheAction.php b/actions/SetBridgeCacheAction.php
index a8e712d4..c9264a27 100644
--- a/actions/SetBridgeCacheAction.php
+++ b/actions/SetBridgeCacheAction.php
@@ -14,6 +14,13 @@
 
 class SetBridgeCacheAction implements ActionInterface
 {
+    private CacheInterface $cache;
+
+    public function __construct()
+    {
+        $this->cache = RssBridge::getCache();
+    }
+
     public function execute(array $request)
     {
         $authenticationMiddleware = new ApiAuthenticationMiddleware();
@@ -35,18 +42,15 @@ class SetBridgeCacheAction implements ActionInterface
         // whitelist control
         if (!$bridgeFactory->isEnabled($bridgeClassName)) {
             throw new \Exception('This bridge is not whitelisted', 401);
-            die;
         }
 
         $bridge = $bridgeFactory->create($bridgeClassName);
         $bridge->loadConfiguration();
         $value = $request['value'];
 
-        $cache = RssBridge::getCache();
-
         $cacheKey = get_class($bridge) . '_' . $key;
         $ttl = 86400 * 3;
-        $cache->set($cacheKey, $value, $ttl);
+        $this->cache->set($cacheKey, $value, $ttl);
 
         header('Content-Type: text/plain');
         echo 'done';
diff --git a/bridges/EZTVBridge.php b/bridges/EZTVBridge.php
index a2db3ead..73318f0c 100644
--- a/bridges/EZTVBridge.php
+++ b/bridges/EZTVBridge.php
@@ -48,7 +48,6 @@ class EZTVBridge extends BridgeAbstract
     public function collectData()
     {
         $eztv_uri = $this->getEztvUri();
-        Logger::debug($eztv_uri);
         $ids = explode(',', trim($this->getInput('ids')));
         foreach ($ids as $id) {
             $data = json_decode(getContents(sprintf('%s/api/get-torrents?imdb_id=%s', $eztv_uri, $id)));
diff --git a/bridges/ElloBridge.php b/bridges/ElloBridge.php
index 9017bc11..42c88a06 100644
--- a/bridges/ElloBridge.php
+++ b/bridges/ElloBridge.php
@@ -113,15 +113,14 @@ class ElloBridge extends BridgeAbstract
 
     private function getAPIKey()
     {
-        $cache = RssBridge::getCache();
         $cacheKey = 'ElloBridge_key';
-        $apiKey = $cache->get($cacheKey);
+        $apiKey = $this->cache->get($cacheKey);
 
         if (!$apiKey) {
             $keyInfo = getContents(self::URI . 'api/webapp-token') or returnServerError('Unable to get token.');
             $apiKey = json_decode($keyInfo)->token->access_token;
             $ttl = 60 * 60 * 20;
-            $cache->set($cacheKey, $apiKey, $ttl);
+            $this->cache->set($cacheKey, $apiKey, $ttl);
         }
 
         return $apiKey;
diff --git a/bridges/FeedMergeBridge.php b/bridges/FeedMergeBridge.php
index cf1b10a2..f2c1d9d5 100644
--- a/bridges/FeedMergeBridge.php
+++ b/bridges/FeedMergeBridge.php
@@ -63,7 +63,7 @@ TEXT;
                 try {
                     $this->collectExpandableDatas($feed);
                 } catch (HttpException $e) {
-                    Logger::warning(sprintf('Exception in FeedMergeBridge: %s', create_sane_exception_message($e)));
+                    $this->logger->warning(sprintf('Exception in FeedMergeBridge: %s', create_sane_exception_message($e)));
                     $this->items[] = [
                         'title' => 'RSS-Bridge: ' . $e->getMessage(),
                         // Give current time so it sorts to the top
@@ -73,7 +73,7 @@ TEXT;
                 } catch (\Exception $e) {
                     if (str_starts_with($e->getMessage(), 'Unable to parse xml')) {
                         // Allow this particular exception from FeedExpander
-                        Logger::warning(sprintf('Exception in FeedMergeBridge: %s', create_sane_exception_message($e)));
+                        $this->logger->warning(sprintf('Exception in FeedMergeBridge: %s', create_sane_exception_message($e)));
                         continue;
                     }
                     throw $e;
diff --git a/bridges/ImgsedBridge.php b/bridges/ImgsedBridge.php
index cf17acb4..70b79866 100644
--- a/bridges/ImgsedBridge.php
+++ b/bridges/ImgsedBridge.php
@@ -217,7 +217,7 @@ HTML,
         if ($relativeDate) {
             date_sub($date, $relativeDate);
         } else {
-            Logger::info(sprintf('Unable to parse date string: %s', $dateString));
+            $this->logger->info(sprintf('Unable to parse date string: %s', $dateString));
         }
         return date_format($date, 'r');
     }
diff --git a/bridges/InstagramBridge.php b/bridges/InstagramBridge.php
index 9a846fb1..1714a691 100644
--- a/bridges/InstagramBridge.php
+++ b/bridges/InstagramBridge.php
@@ -98,9 +98,8 @@ class InstagramBridge extends BridgeAbstract
             return $username;
         }
 
-        $cache = RssBridge::getCache();
         $cacheKey = 'InstagramBridge_' . $username;
-        $pk = $cache->get($cacheKey);
+        $pk = $this->cache->get($cacheKey);
 
         if (!$pk) {
             $data = $this->getContents(self::URI . 'web/search/topsearch/?query=' . $username);
@@ -112,7 +111,7 @@ class InstagramBridge extends BridgeAbstract
             if (!$pk) {
                 returnServerError('Unable to find username in search result.');
             }
-            $cache->set($cacheKey, $pk);
+            $this->cache->set($cacheKey, $pk);
         }
         return $pk;
     }
diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index 5f6070e3..8d46f7bd 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -72,12 +72,6 @@ class RedditBridge extends BridgeAbstract
             ]
         ]
     ];
-    private CacheInterface $cache;
-
-    public function __construct()
-    {
-        $this->cache = RssBridge::getCache();
-    }
 
     public function collectData()
     {
diff --git a/bridges/SoundcloudBridge.php b/bridges/SoundcloudBridge.php
index 5664761b..e389c965 100644
--- a/bridges/SoundcloudBridge.php
+++ b/bridges/SoundcloudBridge.php
@@ -36,15 +36,12 @@ class SoundCloudBridge extends BridgeAbstract
 
     private $feedTitle = null;
     private $feedIcon = null;
-    private CacheInterface $cache;
 
     private $clientIdRegex = '/client_id.*?"(.+?)"/';
     private $widgetRegex = '/widget-.+?\.js/';
 
     public function collectData()
     {
-        $this->cache = RssBridge::getCache();
-
         $res = $this->getUser($this->getInput('u'));
 
         $this->feedTitle = $res->username;
diff --git a/bridges/SpotifyBridge.php b/bridges/SpotifyBridge.php
index eb847f3d..c02acd25 100644
--- a/bridges/SpotifyBridge.php
+++ b/bridges/SpotifyBridge.php
@@ -278,10 +278,9 @@ class SpotifyBridge extends BridgeAbstract
 
     private function fetchAccessToken()
     {
-        $cache = RssBridge::getCache();
         $cacheKey = sprintf('SpotifyBridge:%s:%s', $this->getInput('clientid'), $this->getInput('clientsecret'));
 
-        $token = $cache->get($cacheKey);
+        $token = $this->cache->get($cacheKey);
         if ($token) {
             $this->token = $token;
         } else {
@@ -294,7 +293,7 @@ class SpotifyBridge extends BridgeAbstract
             $data = Json::decode($json);
             $this->token = $data['access_token'];
 
-            $cache->set($cacheKey, $this->token, 3600);
+            $this->cache->set($cacheKey, $this->token, 3600);
         }
     }
 
diff --git a/bridges/TwitterBridge.php b/bridges/TwitterBridge.php
index b9586150..93301038 100644
--- a/bridges/TwitterBridge.php
+++ b/bridges/TwitterBridge.php
@@ -234,8 +234,7 @@ EOD
         $tweets = [];
 
         // Get authentication information
-        $cache = RssBridge::getCache();
-        $api = new TwitterClient($cache);
+        $api = new TwitterClient($this->cache);
         // Try to get all tweets
         switch ($this->queriedContext) {
             case 'By username':
diff --git a/bridges/YoutubeBridge.php b/bridges/YoutubeBridge.php
index bff62a90..b544f762 100644
--- a/bridges/YoutubeBridge.php
+++ b/bridges/YoutubeBridge.php
@@ -77,12 +77,6 @@ class YoutubeBridge extends BridgeAbstract
     private $channel_name = '';
     // This took from repo BetterVideoRss of VerifiedJoseph.
     const URI_REGEX = '/(https?:\/\/(?:www\.)?(?:[a-zA-Z0-9-.]{2,256}\.[a-z]{2,20})(\:[0-9]{2    ,4})?(?:\/[a-zA-Z0-9@:%_\+.,~#"\'!?&\/\/=\-*]+|\/)?)/ims'; //phpcs:ignore
-    private CacheInterface $cache;
-
-    public function __construct()
-    {
-        $this->cache = RssBridge::getCache();
-    }
 
     private function collectDataInternal()
     {
@@ -368,7 +362,7 @@ class YoutubeBridge extends BridgeAbstract
         $scriptRegex = '/var ytInitialData = (.*?);<\/script>/';
         $result = preg_match($scriptRegex, $html, $matches);
         if (! $result) {
-            Logger::debug('Could not find ytInitialData');
+            $this->logger->debug('Could not find ytInitialData');
             return null;
         }
         return json_decode($matches[1]);
diff --git a/bridges/ZDNetBridge.php b/bridges/ZDNetBridge.php
index 693f542c..00b272ce 100644
--- a/bridges/ZDNetBridge.php
+++ b/bridges/ZDNetBridge.php
@@ -180,13 +180,13 @@ class ZDNetBridge extends FeedExpander
 
         $article = getSimpleHTMLDOMCached($item['uri']);
         if (!$article) {
-            Logger::info('Unable to parse the dom from ' . $item['uri']);
+            $this->logger->info('Unable to parse the dom from ' . $item['uri']);
             return $item;
         }
 
         $articleTag = $article->find('article', 0) ?? $article->find('.c-articleContent', 0);
         if (!$articleTag) {
-            Logger::info('Unable to parse <article> tag in ' . $item['uri']);
+            $this->logger->info('Unable to parse <article> tag in ' . $item['uri']);
             return $item;
         }
         $contents = $articleTag->innertext;
diff --git a/caches/FileCache.php b/caches/FileCache.php
index 1495971a..703fb6db 100644
--- a/caches/FileCache.php
+++ b/caches/FileCache.php
@@ -4,10 +4,14 @@ declare(strict_types=1);
 
 class FileCache implements CacheInterface
 {
+    private Logger $logger;
     private array $config;
 
-    public function __construct(array $config = [])
-    {
+    public function __construct(
+        Logger $logger,
+        array $config = []
+    ) {
+        $this->logger = $logger;
         $default = [
             'path'          => null,
             'enable_purge'  => true,
@@ -28,7 +32,7 @@ class FileCache implements CacheInterface
         }
         $item = unserialize(file_get_contents($cacheFile));
         if ($item === false) {
-            Logger::warning(sprintf('Failed to unserialize: %s', $cacheFile));
+            $this->logger->warning(sprintf('Failed to unserialize: %s', $cacheFile));
             $this->delete($key);
             return $default;
         }
diff --git a/caches/MemcachedCache.php b/caches/MemcachedCache.php
index 78035435..f994c1ae 100644
--- a/caches/MemcachedCache.php
+++ b/caches/MemcachedCache.php
@@ -4,10 +4,15 @@ declare(strict_types=1);
 
 class MemcachedCache implements CacheInterface
 {
+    private Logger $logger;
     private \Memcached $conn;
 
-    public function __construct(string $host, int $port)
-    {
+    public function __construct(
+        Logger $logger,
+        string $host,
+        int $port
+    ) {
+        $this->logger = $logger;
         $this->conn = new \Memcached();
         // This call does not actually connect to server yet
         if (!$this->conn->addServer($host, $port)) {
@@ -29,7 +34,7 @@ class MemcachedCache implements CacheInterface
         $expiration = $ttl === null ? 0 : time() + $ttl;
         $result = $this->conn->set($key, $value, $expiration);
         if ($result === false) {
-            Logger::warning('Failed to store an item in memcached', [
+            $this->logger->warning('Failed to store an item in memcached', [
                 'key'           => $key,
                 'code'          => $this->conn->getLastErrorCode(),
                 'message'       => $this->conn->getLastErrorMessage(),
diff --git a/caches/SQLiteCache.php b/caches/SQLiteCache.php
index 09689566..94f6e289 100644
--- a/caches/SQLiteCache.php
+++ b/caches/SQLiteCache.php
@@ -8,11 +8,15 @@ declare(strict_types=1);
  */
 class SQLiteCache implements CacheInterface
 {
-    private \SQLite3 $db;
+    private Logger $logger;
     private array $config;
+    private \SQLite3 $db;
 
-    public function __construct(array $config)
-    {
+    public function __construct(
+        Logger $logger,
+        array $config
+    ) {
+        $this->logger = $logger;
         $default = [
             'file'          => null,
             'timeout'       => 5000,
@@ -59,7 +63,7 @@ class SQLiteCache implements CacheInterface
             $blob = $row['value'];
             $value = unserialize($blob);
             if ($value === false) {
-                Logger::error(sprintf("Failed to unserialize: '%s'", mb_substr($blob, 0, 100)));
+                $this->logger->error(sprintf("Failed to unserialize: '%s'", mb_substr($blob, 0, 100)));
                 // delete?
                 return $default;
             }
@@ -68,6 +72,7 @@ class SQLiteCache implements CacheInterface
         // delete?
         return $default;
     }
+
     public function set(string $key, $value, int $ttl = null): void
     {
         $cacheKey = $this->createCacheKey($key);
diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index f51fe893..a3d84188 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -27,8 +27,15 @@ abstract class BridgeAbstract
     protected string $queriedContext = '';
     private array $configuration = [];
 
-    public function __construct()
-    {
+    protected CacheInterface $cache;
+    protected Logger $logger;
+
+    public function __construct(
+        CacheInterface $cache,
+        Logger $logger
+    ) {
+        $this->cache = $cache;
+        $this->logger = $logger;
     }
 
     abstract public function collectData();
@@ -310,16 +317,14 @@ abstract class BridgeAbstract
 
     protected function loadCacheValue(string $key)
     {
-        $cache = RssBridge::getCache();
         $cacheKey = $this->getShortName() . '_' . $key;
-        return $cache->get($cacheKey);
+        return $this->cache->get($cacheKey);
     }
 
     protected function saveCacheValue(string $key, $value, $ttl = 86400)
     {
-        $cache = RssBridge::getCache();
         $cacheKey = $this->getShortName() . '_' . $key;
-        $cache->set($cacheKey, $value, $ttl);
+        $this->cache->set($cacheKey, $value, $ttl);
     }
 
     public function getShortName(): string
diff --git a/lib/BridgeFactory.php b/lib/BridgeFactory.php
index 12565d92..c3da4bfe 100644
--- a/lib/BridgeFactory.php
+++ b/lib/BridgeFactory.php
@@ -2,12 +2,17 @@
 
 final class BridgeFactory
 {
+    private CacheInterface $cache;
+    private Logger $logger;
     private $bridgeClassNames = [];
     private $enabledBridges = [];
     private $missingEnabledBridges = [];
 
     public function __construct()
     {
+        $this->cache = RssBridge::getCache();
+        $this->logger = RssBridge::getLogger();
+
         // Create all possible bridge class names from fs
         foreach (scandir(__DIR__ . '/../bridges/') as $file) {
             if (preg_match('/^([^.]+Bridge)\.php$/U', $file, $m)) {
@@ -29,14 +34,14 @@ final class BridgeFactory
                 $this->enabledBridges[] = $bridgeClassName;
             } else {
                 $this->missingEnabledBridges[] = $enabledBridge;
-                Logger::info(sprintf('Bridge not found: %s', $enabledBridge));
+                $this->logger->info(sprintf('Bridge not found: %s', $enabledBridge));
             }
         }
     }
 
     public function create(string $name): BridgeAbstract
     {
-        return new $name();
+        return new $name($this->cache, $this->logger);
     }
 
     public function isEnabled(string $bridgeName): bool
diff --git a/lib/CacheFactory.php b/lib/CacheFactory.php
index 3f076d83..df78d9cb 100644
--- a/lib/CacheFactory.php
+++ b/lib/CacheFactory.php
@@ -4,6 +4,14 @@ declare(strict_types=1);
 
 class CacheFactory
 {
+    private Logger $logger;
+
+    public function __construct(
+        Logger $logger
+    ) {
+        $this->logger = $logger;
+    }
+
     public function create(string $name = null): CacheInterface
     {
         $name ??= Configuration::getConfig('cache', 'type');
@@ -49,7 +57,7 @@ class CacheFactory
                 if (!is_writable($fileCacheConfig['path'])) {
                     throw new \Exception(sprintf('The FileCache path is not writable: %s', $fileCacheConfig['path']));
                 }
-                return new FileCache($fileCacheConfig);
+                return new FileCache($this->logger, $fileCacheConfig);
             case SQLiteCache::class:
                 if (!extension_loaded('sqlite3')) {
                     throw new \Exception('"sqlite3" extension not loaded. Please check "php.ini"');
@@ -66,7 +74,7 @@ class CacheFactory
                 } elseif (!is_dir(dirname($file))) {
                     throw new \Exception(sprintf('Invalid configuration for %s', 'SQLiteCache'));
                 }
-                return new SQLiteCache([
+                return new SQLiteCache($this->logger, [
                     'file'          => $file,
                     'timeout'       => Configuration::getConfig('SQLiteCache', 'timeout'),
                     'enable_purge'  => Configuration::getConfig('SQLiteCache', 'enable_purge'),
@@ -94,7 +102,7 @@ class CacheFactory
                 if ($port < 1 || $port > 65535) {
                     throw new \Exception('"port" param is invalid for ' . $section);
                 }
-                return new MemcachedCache($host, $port);
+                return new MemcachedCache($this->logger, $host, $port);
             default:
                 if (!file_exists(PATH_LIB_CACHES . $className . '.php')) {
                     throw new \Exception('Unable to find the cache file');
diff --git a/lib/Debug.php b/lib/Debug.php
index 48dbb31a..4333b3a5 100644
--- a/lib/Debug.php
+++ b/lib/Debug.php
@@ -24,6 +24,8 @@ class Debug
         array_pop($trace);
         $lastFrame = $trace[array_key_last($trace)];
         $text = sprintf('%s(%s): %s', $lastFrame['file'], $lastFrame['line'], $message);
-        Logger::debug($text);
+
+        $logger = RssBridge::getLogger();
+        $logger->debug($text);
     }
 }
diff --git a/lib/FeedExpander.php b/lib/FeedExpander.php
index af06cc16..14c931e6 100644
--- a/lib/FeedExpander.php
+++ b/lib/FeedExpander.php
@@ -113,7 +113,7 @@ abstract class FeedExpander extends BridgeAbstract
         if ($rssContent === false) {
             $xmlErrors = libxml_get_errors();
             foreach ($xmlErrors as $xmlError) {
-                Logger::debug(trim($xmlError->message));
+                Debug::log(trim($xmlError->message));
             }
             if ($xmlErrors) {
                 // Render only the first error into exception message
diff --git a/lib/Logger.php b/lib/Logger.php
deleted file mode 100644
index 073fedee..00000000
--- a/lib/Logger.php
+++ /dev/null
@@ -1,97 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-final class Logger
-{
-    public static function debug(string $message, array $context = [])
-    {
-        self::log('DEBUG', $message, $context);
-    }
-
-    public static function info(string $message, array $context = []): void
-    {
-        self::log('INFO', $message, $context);
-    }
-
-    public static function warning(string $message, array $context = []): void
-    {
-        self::log('WARNING', $message, $context);
-    }
-
-    public static function error(string $message, array $context = []): void
-    {
-        self::log('ERROR', $message, $context);
-    }
-
-    private static function log(string $level, string $message, array $context = []): void
-    {
-        if (!Debug::isEnabled() && $level === 'DEBUG') {
-            // Don't log this debug log record because debug mode is disabled
-            return;
-        }
-
-        if (isset($context['e'])) {
-            /** @var \Throwable $e */
-            $e = $context['e'];
-            unset($context['e']);
-            $context['type'] = get_class($e);
-            $context['code'] = $e->getCode();
-            $context['message'] = sanitize_root($e->getMessage());
-            $context['file'] = sanitize_root($e->getFile());
-            $context['line'] = $e->getLine();
-            $context['url'] = get_current_url();
-            $context['trace'] = trace_to_call_points(trace_from_exception($e));
-            // Don't log these exceptions
-            // todo: this logic belongs in log handler
-            $ignoredExceptions = [
-                'You must specify a format',
-                'Format name invalid',
-                'Unknown format given',
-                'Bridge name invalid',
-                'Invalid action',
-                'twitter: No results for this query',
-                // telegram
-                'Unable to find channel. The channel is non-existing or non-public',
-                // fb
-                'This group is not public! RSS-Bridge only supports public groups!',
-                'You must be logged in to view this page',
-                'Unable to get the page id. You should consider getting the ID by hand',
-                // tiktok 404
-                'https://www.tiktok.com/@',
-            ];
-            foreach ($ignoredExceptions as $ignoredException) {
-                if (str_starts_with($e->getMessage(), $ignoredException)) {
-                    return;
-                }
-            }
-        }
-
-        if ($context) {
-            try {
-                $context = Json::encode($context);
-            } catch (\JsonException $e) {
-                $context['message'] = null;
-                $context = Json::encode($context);
-            }
-        } else {
-            $context = '';
-        }
-        $text = sprintf(
-            "[%s] rssbridge.%s %s %s\n",
-            now()->format('Y-m-d H:i:s'),
-            $level,
-            // Intentionally not sanitizing $message
-            $message,
-            $context
-        );
-
-        // Log to stderr/stdout whatever that is
-        // todo: extract to log handler
-        error_log($text);
-
-        // Log to file
-        // todo: extract to log handler
-        //$bytes = file_put_contents('/tmp/rss-bridge.log', $text, FILE_APPEND | LOCK_EX);
-    }
-}
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index 32dad269..0ec7174d 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -2,8 +2,9 @@
 
 final class RssBridge
 {
-    private static HttpClient $httpClient;
     private static CacheInterface $cache;
+    private static Logger $logger;
+    private static HttpClient $httpClient;
 
     public function __construct()
     {
@@ -19,7 +20,7 @@ final class RssBridge
         date_default_timezone_set(Configuration::getConfig('system', 'timezone'));
 
         set_exception_handler(function (\Throwable $e) {
-            Logger::error('Uncaught Exception', ['e' => $e]);
+            self::$logger->error('Uncaught Exception', ['e' => $e]);
             http_response_code(500);
             print render(__DIR__ . '/../templates/error.html.php', ['e' => $e]);
             exit(1);
@@ -35,7 +36,7 @@ final class RssBridge
                 sanitize_root($file),
                 $line
             );
-            Logger::warning($text);
+            self::$logger->warning($text);
             if (Debug::isEnabled()) {
                 print sprintf("<pre>%s</pre>\n", e($text));
             }
@@ -52,17 +53,23 @@ final class RssBridge
                     sanitize_root($error['file']),
                     $error['line']
                 );
-                Logger::error($message);
+                self::$logger->error($message);
                 if (Debug::isEnabled()) {
-                    // todo: extract to log handler
                     print sprintf("<pre>%s</pre>\n", e($message));
                 }
             }
         });
 
+        self::$logger = new SimpleLogger('rssbridge');
+        if (Debug::isEnabled()) {
+            self::$logger->addHandler(new StreamHandler(Logger::DEBUG));
+        } else {
+            self::$logger->addHandler(new StreamHandler(Logger::INFO));
+        }
+
         self::$httpClient = new CurlHttpClient();
 
-        $cacheFactory = new CacheFactory();
+        $cacheFactory = new CacheFactory(self::$logger);
         if (Debug::isEnabled()) {
             self::$cache = $cacheFactory->create('array');
         } else {
@@ -108,19 +115,24 @@ final class RssBridge
                 $response->send();
             }
         } catch (\Throwable $e) {
-            Logger::error('Exception in RssBridge::main()', ['e' => $e]);
+            self::$logger->error('Exception in RssBridge::main()', ['e' => $e]);
             http_response_code(500);
             print render(__DIR__ . '/../templates/error.html.php', ['e' => $e]);
         }
     }
 
+    public static function getCache(): CacheInterface
+    {
+        return self::$cache;
+    }
+
+    public static function getLogger(): Logger
+    {
+        return self::$logger;
+    }
+
     public static function getHttpClient(): HttpClient
     {
         return self::$httpClient;
     }
-
-    public static function getCache(): CacheInterface
-    {
-        return self::$cache ?? new NullCache();
-    }
 }
diff --git a/lib/bootstrap.php b/lib/bootstrap.php
index ca6cecdb..c8cf4e99 100644
--- a/lib/bootstrap.php
+++ b/lib/bootstrap.php
@@ -43,6 +43,7 @@ $files = [
     __DIR__ . '/../lib/php8backports.php',
     __DIR__ . '/../lib/utils.php',
     __DIR__ . '/../lib/http.php',
+    __DIR__ . '/../lib/logger.php',
     // Vendor
     __DIR__ . '/../vendor/parsedown/Parsedown.php',
     __DIR__ . '/../vendor/php-urljoin/src/urljoin.php',
diff --git a/lib/logger.php b/lib/logger.php
new file mode 100644
index 00000000..ed1f1179
--- /dev/null
+++ b/lib/logger.php
@@ -0,0 +1,172 @@
+<?php
+
+declare(strict_types=1);
+
+interface Logger
+{
+    public const DEBUG      = 10;
+    public const INFO       = 20;
+    public const WARNING    = 30;
+    public const ERROR      = 40;
+
+    public const LEVEL_NAMES = [
+        self::DEBUG     => 'DEBUG',
+        self::INFO      => 'INFO',
+        self::WARNING   => 'WARNING',
+        self::ERROR     => 'ERROR',
+    ];
+
+    public function debug(string $message, array $context = []);
+
+    public function info(string $message, array $context = []): void;
+
+    public function warning(string $message, array $context = []): void;
+
+    public function error(string $message, array $context = []): void;
+}
+
+final class SimpleLogger implements Logger
+{
+    private string $name;
+    private array $handlers;
+
+    /**
+     * @param callable[] $handlers
+     */
+    public function __construct(
+        string $name,
+        array $handlers = []
+    ) {
+        $this->name = $name;
+        $this->handlers = $handlers;
+    }
+
+    public function addHandler(callable $fn)
+    {
+        $this->handlers[] = $fn;
+    }
+
+    public function debug(string $message, array $context = [])
+    {
+        $this->log(self::DEBUG, $message, $context);
+    }
+
+    public function info(string $message, array $context = []): void
+    {
+        $this->log(self::INFO, $message, $context);
+    }
+
+    public function warning(string $message, array $context = []): void
+    {
+        $this->log(self::WARNING, $message, $context);
+    }
+
+    public function error(string $message, array $context = []): void
+    {
+        $this->log(self::ERROR, $message, $context);
+    }
+
+    private function log(int $level, string $message, array $context = []): void
+    {
+        foreach ($this->handlers as $handler) {
+            $handler([
+                'name'          => $this->name,
+                'created_at'    => now(),
+                'level'         => $level,
+                'level_name'    => self::LEVEL_NAMES[$level],
+                'message'       => $message,
+                'context'       => $context,
+            ]);
+        }
+    }
+}
+
+final class StreamHandler
+{
+    private int $level;
+
+    public function __construct(int $level = Logger::DEBUG)
+    {
+        $this->level = $level;
+    }
+
+    public function __invoke(array $record)
+    {
+        if ($record['level'] < $this->level) {
+            return;
+        }
+        if (isset($record['context']['e'])) {
+            /** @var \Throwable $e */
+            $e = $record['context']['e'];
+            unset($record['context']['e']);
+            $record['context']['type'] = get_class($e);
+            $record['context']['code'] = $e->getCode();
+            $record['context']['message'] = sanitize_root($e->getMessage());
+            $record['context']['file'] = sanitize_root($e->getFile());
+            $record['context']['line'] = $e->getLine();
+            $record['context']['url'] = get_current_url();
+            $record['context']['trace'] = trace_to_call_points(trace_from_exception($e));
+
+            $ignoredExceptions = [
+                'You must specify a format',
+                'Format name invalid',
+                'Unknown format given',
+                'Bridge name invalid',
+                'Invalid action',
+                'twitter: No results for this query',
+                // telegram
+                'Unable to find channel. The channel is non-existing or non-public',
+                // fb
+                'This group is not public! RSS-Bridge only supports public groups!',
+                'You must be logged in to view this page',
+                'Unable to get the page id. You should consider getting the ID by hand',
+                // tiktok 404
+                'https://www.tiktok.com/@',
+            ];
+            foreach ($ignoredExceptions as $ignoredException) {
+                if (str_starts_with($e->getMessage(), $ignoredException)) {
+                    return;
+                }
+            }
+        }
+        $context = '';
+        if ($record['context']) {
+            try {
+                $context = Json::encode($record['context']);
+            } catch (\JsonException $e) {
+                $record['context']['message'] = null;
+                $context = Json::encode($record['context']);
+            }
+        }
+        $text = sprintf(
+            "[%s] %s.%s %s %s\n",
+            $record['created_at']->format('Y-m-d H:i:s'),
+            $record['name'],
+            $record['level_name'],
+            // Should probably sanitize message for output context
+            $record['message'],
+            $context
+        );
+        error_log($text);
+        //$bytes = file_put_contents('/tmp/rss-bridge.log', $text, FILE_APPEND | LOCK_EX);
+    }
+}
+
+final class NullLogger implements Logger
+{
+    public function debug(string $message, array $context = [])
+    {
+    }
+
+    public function info(string $message, array $context = []): void
+    {
+    }
+
+    public function warning(string $message, array $context = []): void
+    {
+    }
+
+    public function error(string $message, array $context = []): void
+    {
+    }
+}
diff --git a/tests/Actions/ActionImplementationTest.php b/tests/Actions/ActionImplementationTest.php
deleted file mode 100644
index e70dd7e2..00000000
--- a/tests/Actions/ActionImplementationTest.php
+++ /dev/null
@@ -1,69 +0,0 @@
-<?php
-
-namespace RssBridge\Tests\Actions;
-
-use ActionInterface;
-use PHPUnit\Framework\TestCase;
-
-class ActionImplementationTest extends TestCase
-{
-    private $class;
-    private $obj;
-
-    public function setUp(): void
-    {
-        \Configuration::loadConfiguration();
-    }
-
-    /**
-     * @dataProvider dataActionsProvider
-     */
-    public function testClassName($path)
-    {
-        $this->setAction($path);
-        $this->assertTrue($this->class === ucfirst($this->class), 'class name must start with uppercase character');
-        $this->assertEquals(0, substr_count($this->class, ' '), 'class name must not contain spaces');
-        $this->assertStringEndsWith('Action', $this->class, 'class name must end with "Action"');
-    }
-
-    /**
-     * @dataProvider dataActionsProvider
-     */
-    public function testClassType($path)
-    {
-        $this->setAction($path);
-        $this->assertInstanceOf(ActionInterface::class, $this->obj);
-    }
-
-    /**
-     * @dataProvider dataActionsProvider
-     */
-    public function testVisibleMethods($path)
-    {
-        $allowedMethods = get_class_methods(ActionInterface::class);
-        sort($allowedMethods);
-
-        $this->setAction($path);
-
-        $methods = array_diff(get_class_methods($this->obj), ['__construct']);
-        sort($methods);
-
-        $this->assertEquals($allowedMethods, $methods);
-    }
-
-    public function dataActionsProvider()
-    {
-        $actions = [];
-        foreach (glob(PATH_LIB_ACTIONS . '*.php') as $path) {
-            $actions[basename($path, '.php')] = [$path];
-        }
-        return $actions;
-    }
-
-    private function setAction($path)
-    {
-        $this->class = '\\' . basename($path, '.php');
-        $this->assertTrue(class_exists($this->class), 'class ' . $this->class . ' doesn\'t exist');
-        $this->obj = new $this->class();
-    }
-}
diff --git a/tests/Actions/ListActionTest.php b/tests/Actions/ListActionTest.php
deleted file mode 100644
index 74a90254..00000000
--- a/tests/Actions/ListActionTest.php
+++ /dev/null
@@ -1,76 +0,0 @@
-<?php
-
-namespace RssBridge\Tests\Actions;
-
-use BridgeFactory;
-use PHPUnit\Framework\TestCase;
-
-class ListActionTest extends TestCase
-{
-    public function setUp(): void
-    {
-        \Configuration::loadConfiguration();
-    }
-
-    public function testHeaders()
-    {
-        $action = new \ListAction();
-        $response = $action->execute([]);
-        $headers = $response->getHeaders();
-        $contentType = $response->getHeader('content-type');
-        $this->assertSame($contentType, 'application/json');
-    }
-
-    public function testOutput()
-    {
-        $action = new \ListAction();
-        $response = $action->execute([]);
-        $data = $response->getBody();
-
-        $items = json_decode($data, true);
-
-        $this->assertNotNull($items, 'invalid JSON output: ' . json_last_error_msg());
-
-        $this->assertArrayHasKey('total', $items, 'Missing "total" parameter');
-        $this->assertIsInt($items['total'], 'Invalid type');
-
-        $this->assertArrayHasKey('bridges', $items, 'Missing "bridges" array');
-
-        $this->assertEquals(
-            $items['total'],
-            count($items['bridges']),
-            'Item count doesn\'t match'
-        );
-
-        $bridgeFactory = new BridgeFactory();
-
-        $this->assertEquals(
-            count($bridgeFactory->getBridgeClassNames()),
-            count($items['bridges']),
-            'Number of bridges doesn\'t match'
-        );
-
-        $expectedKeys = [
-            'status',
-            'uri',
-            'name',
-            'icon',
-            'parameters',
-            'maintainer',
-            'description'
-        ];
-
-        $allowedStatus = [
-            'active',
-            'inactive'
-        ];
-
-        foreach ($items['bridges'] as $bridge) {
-            foreach ($expectedKeys as $key) {
-                $this->assertArrayHasKey($key, $bridge, 'Missing key "' . $key . '"');
-            }
-
-            $this->assertContains($bridge['status'], $allowedStatus, 'Invalid status value');
-        }
-    }
-}
diff --git a/tests/BridgeFactoryTest.php b/tests/BridgeFactoryTest.php
index a97711ef..a12faf48 100644
--- a/tests/BridgeFactoryTest.php
+++ b/tests/BridgeFactoryTest.php
@@ -6,25 +6,14 @@ use PHPUnit\Framework\TestCase;
 
 class BridgeFactoryTest extends TestCase
 {
-    public function setUp(): void
-    {
-        \Configuration::loadConfiguration();
-    }
-
     public function testNormalizeBridgeName()
     {
         $this->assertSame('TwitterBridge', \BridgeFactory::normalizeBridgeName('TwitterBridge'));
         $this->assertSame('TwitterBridge', \BridgeFactory::normalizeBridgeName('TwitterBridge.php'));
         $this->assertSame('TwitterBridge', \BridgeFactory::normalizeBridgeName('Twitter'));
-    }
-
-    public function testSanitizeBridgeName()
-    {
-        $sut = new \BridgeFactory();
-
-        $this->assertSame('TwitterBridge', $sut->createBridgeClassName('twitterbridge'));
-        $this->assertSame('TwitterBridge', $sut->createBridgeClassName('twitter'));
-        $this->assertSame('TwitterBridge', $sut->createBridgeClassName('tWitTer'));
-        $this->assertSame('TwitterBridge', $sut->createBridgeClassName('TWITTERBRIDGE'));
+//        $this->assertSame('TwitterBridge', $sut->createBridgeClassName('twitterbridge'));
+//        $this->assertSame('TwitterBridge', $sut->createBridgeClassName('twitter'));
+//        $this->assertSame('TwitterBridge', $sut->createBridgeClassName('tWitTer'));
+//        $this->assertSame('TwitterBridge', $sut->createBridgeClassName('TWITTERBRIDGE'));
     }
 }
diff --git a/tests/Bridges/BridgeImplementationTest.php b/tests/Bridges/BridgeImplementationTest.php
index 807649fc..af9d7db1 100644
--- a/tests/Bridges/BridgeImplementationTest.php
+++ b/tests/Bridges/BridgeImplementationTest.php
@@ -231,7 +231,10 @@ class BridgeImplementationTest extends TestCase
     {
         $this->class = '\\' . basename($path, '.php');
         $this->assertTrue(class_exists($this->class), 'class ' . $this->class . ' doesn\'t exist');
-        $this->obj = new $this->class();
+        $this->obj = new $this->class(
+            new \NullCache(),
+            new \NullLogger()
+        );
     }
 
     private function checkUrl($url)
diff --git a/tests/CacheTest.php b/tests/CacheTest.php
index 15d03ec1..491db75a 100644
--- a/tests/CacheTest.php
+++ b/tests/CacheTest.php
@@ -8,13 +8,13 @@ class CacheTest extends TestCase
 {
     public function testConfig()
     {
-        $sut = new \FileCache(['path' => '/tmp/']);
+        $sut = new \FileCache(new \NullLogger(), ['path' => '/tmp/']);
         $this->assertSame(['path' => '/tmp/', 'enable_purge' => true], $sut->getConfig());
 
-        $sut = new \FileCache(['path' => '/', 'enable_purge' => false]);
+        $sut = new \FileCache(new \NullLogger(), ['path' => '/', 'enable_purge' => false]);
         $this->assertSame(['path' => '/', 'enable_purge' => false], $sut->getConfig());
 
-        $sut = new \FileCache(['path' => '/tmp', 'enable_purge' => true]);
+        $sut = new \FileCache(new \NullLogger(), ['path' => '/tmp', 'enable_purge' => true]);
         $this->assertSame(['path' => '/tmp/', 'enable_purge' => true], $sut->getConfig());
     }
 
@@ -23,7 +23,7 @@ class CacheTest extends TestCase
         $temporaryFolder = sprintf('%s/rss_bridge_%s/', sys_get_temp_dir(), create_random_string());
         mkdir($temporaryFolder);
 
-        $sut = new \FileCache([
+        $sut = new \FileCache(new \NullLogger(), [
             'path' => $temporaryFolder,
             'enable_purge' => true,
         ]);

From 7a9bfa1087106d8f759f3fbcd8b1856caa8a6f74 Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Fri, 22 Sep 2023 05:40:13 +0200
Subject: [PATCH 115/716] [YoutubeBridge] handle new youtube description system
 / fix missing description (#3682)

* [YoutubeBridge] handle new youtube description system

* [YoutubeBridge] fix unrelated warnings

* [YoutubeBridge] discard everything when one link can not be matched & add more boundary chars

* [YoutubeBridge] rebase on master & minor fixes
---
 bridges/YoutubeBridge.php | 224 ++++++++++++++++++++++++++++----------
 1 file changed, 167 insertions(+), 57 deletions(-)

diff --git a/bridges/YoutubeBridge.php b/bridges/YoutubeBridge.php
index b544f762..66b7614f 100644
--- a/bridges/YoutubeBridge.php
+++ b/bridges/YoutubeBridge.php
@@ -10,7 +10,7 @@
 class YoutubeBridge extends BridgeAbstract
 {
     const NAME = 'YouTube Bridge';
-    const URI = 'https://www.youtube.com/';
+    const URI = 'https://www.youtube.com';
     const CACHE_TIMEOUT = 10800; // 3h
     const DESCRIPTION = 'Returns the 10 newest videos by username/channel/playlist or search';
 
@@ -74,7 +74,7 @@ class YoutubeBridge extends BridgeAbstract
 
     private $feedName = '';
     private $feeduri = '';
-    private $channel_name = '';
+    private $feedIconUrl = '';
     // This took from repo BetterVideoRss of VerifiedJoseph.
     const URI_REGEX = '/(https?:\/\/(?:www\.)?(?:[a-zA-Z0-9-.]{2,256}\.[a-z]{2,20})(\:[0-9]{2    ,4})?(?:\/[a-zA-Z0-9@:%_\+.,~#"\'!?&\/\/=\-*]+|\/)?)/ims'; //phpcs:ignore
 
@@ -87,16 +87,16 @@ class YoutubeBridge extends BridgeAbstract
 
         if ($this->getInput('u')) {
             /* User and Channel modes */
-            $this->request = $this->getInput('u');
-            $url_feed = self::URI . 'feeds/videos.xml?user=' . urlencode($this->request);
-            $url_listing = self::URI . 'user/' . urlencode($this->request) . '/videos';
+            $request = $this->getInput('u');
+            $url_feed = self::URI . '/feeds/videos.xml?user=' . urlencode($request);
+            $url_listing = self::URI . '/user/' . urlencode($request) . '/videos';
         } elseif ($this->getInput('c')) {
-            $this->request = $this->getInput('c');
-            $url_feed = self::URI . 'feeds/videos.xml?channel_id=' . urlencode($this->request);
-            $url_listing = self::URI . 'channel/' . urlencode($this->request) . '/videos';
+            $request = $this->getInput('c');
+            $url_feed = self::URI . '/feeds/videos.xml?channel_id=' . urlencode($request);
+            $url_listing = self::URI . '/channel/' . urlencode($request) . '/videos';
         } elseif ($this->getInput('custom')) {
-            $this->request = $this->getInput('custom');
-            $url_listing = self::URI . urlencode($this->request) . '/videos';
+            $request = $this->getInput('custom');
+            $url_listing = self::URI . '/' . urlencode($request) . '/videos';
         }
 
         if (!empty($url_feed) || !empty($url_listing)) {
@@ -105,7 +105,7 @@ class YoutubeBridge extends BridgeAbstract
                 $html = $this->ytGetSimpleHTMLDOM($url_listing);
                 $jsonData = $this->getJSONData($html);
                 $url_feed = $jsonData->metadata->channelMetadataRenderer->rssUrl;
-                $this->iconURL = $jsonData->metadata->channelMetadataRenderer->avatar->thumbnails[0]->url;
+                $this->feedIconUrl = $jsonData->metadata->channelMetadataRenderer->avatar->thumbnails[0]->url;
             }
             if (!$this->skipFeeds()) {
                 $html = $this->ytGetSimpleHTMLDOM($url_feed);
@@ -123,7 +123,7 @@ class YoutubeBridge extends BridgeAbstract
                     // $jsonData = $jsonData->itemSectionRenderer->contents[0]->gridRenderer->items;
                     $this->parseJSONListing($jsonData);
                 } else {
-                    returnServerError('Unable to get data from YouTube. Username/Channel: ' . $this->request);
+                    returnServerError('Unable to get data from YouTube. Username/Channel: ' . $request);
                 }
             }
             $this->feedName = str_replace(' - YouTube', '', $html->find('title', 0)->plaintext);
@@ -133,9 +133,9 @@ class YoutubeBridge extends BridgeAbstract
             // To make less requests, we need to cache following dictionary "videoId -> datePublished, duration"
             // This cache will be used to find out, which videos to fetch
             // to make feed of 15 items or more, if there a lot of videos published on that date.
-            $this->request = $this->getInput('p');
-            $url_feed = self::URI . 'feeds/videos.xml?playlist_id=' . urlencode($this->request);
-            $url_listing = self::URI . 'playlist?list=' . urlencode($this->request);
+            $request = $this->getInput('p');
+            $url_feed = self::URI . '/feeds/videos.xml?playlist_id=' . urlencode($request);
+            $url_listing = self::URI . '/playlist?list=' . urlencode($request);
             $html = $this->ytGetSimpleHTMLDOM($url_listing);
             $jsonData = $this->getJSONData($html);
             // TODO: this method returns only first 100 video items
@@ -160,10 +160,10 @@ class YoutubeBridge extends BridgeAbstract
             });
         } elseif ($this->getInput('s')) {
             /* search mode */
-            $this->request = $this->getInput('s');
+            $request = $this->getInput('s');
             $url_listing = self::URI
-                . 'results?search_query='
-                . urlencode($this->request)
+                . '/results?search_query='
+                . urlencode($request)
                 . '&sp=CAI%253D';
 
             $html = $this->ytGetSimpleHTMLDOM($url_listing);
@@ -180,7 +180,7 @@ class YoutubeBridge extends BridgeAbstract
             }
             $this->parseJSONListing($jsonData);
             $this->feeduri = $url_listing;
-            $this->feedName = 'Search: ' . $this->request;
+            $this->feedName = 'Search: ' . $request;
         } else {
             /* no valid mode */
             returnClientError("You must either specify either:\n - YouTube
@@ -206,7 +206,7 @@ class YoutubeBridge extends BridgeAbstract
 
     private function ytBridgeQueryVideoInfo($vid, &$author, &$desc, &$time)
     {
-        $html = $this->ytGetSimpleHTMLDOM(self::URI . "watch?v=$vid", true);
+        $html = $this->ytGetSimpleHTMLDOM(self::URI . "/watch?v=$vid", true);
 
         // Skip unavailable videos
         if (strpos($html->innertext, 'IS_UNAVAILABLE_PAGE') !== false) {
@@ -224,7 +224,7 @@ class YoutubeBridge extends BridgeAbstract
         }
 
         $jsonData = $this->getJSONData($html);
-        if (! isset($jsonData->contents)) {
+        if (!isset($jsonData->contents)) {
             return;
         }
 
@@ -240,34 +240,149 @@ class YoutubeBridge extends BridgeAbstract
             returnServerError('Could not find videoSecondaryInfoRenderer. Error at: ' . $vid);
         }
 
-        if (isset($videoSecondaryInfo->description)) {
-            foreach ($videoSecondaryInfo->description->runs as $description) {
-                if (isset($description->navigationEndpoint)) {
-                    $metadata = $description->navigationEndpoint->commandMetadata->webCommandMetadata;
-                    $web_type = $metadata->webPageType;
-                    $url = $metadata->url;
-                    $text = '';
-                    switch ($web_type) {
-                        case 'WEB_PAGE_TYPE_UNKNOWN':
-                            $url_components = parse_url($url);
-                            if (isset($url_components['query']) && strpos($url_components['query'], '&q=') !== false) {
-                                parse_str($url_components['query'], $params);
-                                $url = urldecode($params['q']);
-                            }
-                            $text = $url;
-                            break;
-                        case 'WEB_PAGE_TYPE_WATCH':
-                        case 'WEB_PAGE_TYPE_BROWSE':
-                            $url = 'https://www.youtube.com' . $url;
-                            $text = $description->text;
-                            break;
-                    }
-                    $desc .= "<a href=\"$url\" target=\"_blank\">$text</a>";
-                } else {
-                    $desc .= nl2br($description->text);
-                }
+        $desc = $videoSecondaryInfo->attributedDescription->content ?? '';
+
+        // Default whitespace chars used by trim + non-breaking spaces (https://en.wikipedia.org/wiki/Non-breaking_space)
+        $whitespaceChars = " \t\n\r\0\x0B\u{A0}\u{2060}\u{202F}\u{2007}";
+        $descEnhancements = $this->ytBridgeGetVideoDescriptionEnhancements($videoSecondaryInfo, $desc, self::URI, $whitespaceChars);
+        foreach ($descEnhancements as $descEnhancement) {
+            if (isset($descEnhancement['url'])) {
+                $descBefore = mb_substr($desc, 0, $descEnhancement['pos']);
+                $descValue = mb_substr($desc, $descEnhancement['pos'], $descEnhancement['len']);
+                $descAfter = mb_substr($desc, $descEnhancement['pos'] + $descEnhancement['len'], null);
+
+                // Extended trim for the display value of internal links, e.g.:
+                // FAVICON • Video Name
+                // FAVICON / @ChannelName
+                $descValue = trim($descValue, $whitespaceChars . '•/');
+
+                $desc = sprintf('%s<a href="%s" target="_blank">%s</a>%s', $descBefore, $descEnhancement['url'], $descValue, $descAfter);
             }
         }
+
+        $desc = nl2br($desc);
+    }
+
+    private function ytBridgeGetVideoDescriptionEnhancements(
+        object $videoSecondaryInfo,
+        string $descriptionContent,
+        string $baseUrl,
+        string $whitespaceChars
+    ): array {
+        $commandRuns = $videoSecondaryInfo->attributedDescription->commandRuns ?? [];
+        if (count($commandRuns) <= 0) {
+            return [];
+        }
+
+        $enhancements = [];
+
+        $boundaryWhitespaceChars = mb_str_split($whitespaceChars);
+        $boundaryStartChars = array_merge($boundaryWhitespaceChars, [':', '-', '(']);
+        $boundaryEndChars = array_merge($boundaryWhitespaceChars, [',', '.', "'", ')']);
+        $hashtagBoundaryEndChars = array_merge($boundaryEndChars, ['#', '-']);
+
+        $descriptionContentLength = mb_strlen($descriptionContent);
+
+        $minPositionOffset = 0;
+
+        $prevStartPosition = 0;
+        $totalLength = 0;
+        $maxPositionByStartIndex = [];
+        foreach (array_reverse($commandRuns) as $commandRun) {
+            $endPosition = $commandRun->startIndex + $commandRun->length;
+            if ($endPosition < $prevStartPosition) {
+                $totalLength += 1;
+            }
+            $totalLength += $commandRun->length;
+            $maxPositionByStartIndex[$commandRun->startIndex] = $totalLength;
+            $prevStartPosition = $commandRun->startIndex;
+        }
+
+        foreach ($commandRuns as $commandRun) {
+            $commandMetadata = $commandRun->onTap->innertubeCommand->commandMetadata->webCommandMetadata ?? null;
+            if (!isset($commandMetadata)) {
+                continue;
+            }
+
+            $enhancement = null;
+
+            /*
+            $commandRun->startIndex can be offset by few positions in the positive direction
+            when some multibyte characters (e.g. emojis, but maybe also others) are used in the plain text video description.
+            (probably some difference between php and javascript in handling multibyte characters)
+            This loop should correct the position in most cases. It searches for the next word (determined by a set of boundary chars) with the expected length.
+            Several safeguards ensure that the correct word is chosen. When a link can not be matched,
+            everything will be discarded to prevent corrupting the description.
+            Hashtags require a different set of boundary chars.
+            */
+            $isHashtag = $commandMetadata->webPageType === 'WEB_PAGE_TYPE_BROWSE';
+            $prevEnhancement = end($enhancements);
+            $minPosition = $prevEnhancement === false ? 0 : $prevEnhancement['pos'] + $prevEnhancement['len'];
+            $maxPosition = $descriptionContentLength - $maxPositionByStartIndex[$commandRun->startIndex];
+            $position = min($commandRun->startIndex - $minPositionOffset, $maxPosition);
+            while ($position >= $minPosition) {
+                // The link display value can only ever include a new line at the end (which will be removed further below), never in between.
+                $newLinePosition = mb_strpos($descriptionContent, "\n", $position);
+                if ($newLinePosition !== false && $newLinePosition < $position + ($commandRun->length - 1)) {
+                    $position = $newLinePosition - ($commandRun->length - 1);
+                    continue;
+                }
+
+                $firstChar = mb_substr($descriptionContent, $position, 1);
+                $boundaryStart = mb_substr($descriptionContent, $position - 1, 1);
+                $boundaryEndIndex = $position + $commandRun->length;
+                $boundaryEnd = mb_substr($descriptionContent, $boundaryEndIndex, 1);
+
+                $boundaryStartIsValid = $position === 0 ||
+                    in_array($boundaryStart, $boundaryStartChars) ||
+                    ($isHashtag && $firstChar === '#');
+                $boundaryEndIsValid = $boundaryEndIndex === $descriptionContentLength ||
+                    in_array($boundaryEnd, $isHashtag ? $hashtagBoundaryEndChars : $boundaryEndChars);
+
+                if ($boundaryStartIsValid && $boundaryEndIsValid) {
+                    $minPositionOffset = $commandRun->startIndex - $position;
+                    $enhancement = [
+                        'pos' => $position,
+                        'len' => $commandRun->length,
+                    ];
+                    break;
+                }
+
+                $position--;
+            }
+
+            if (!isset($enhancement)) {
+                $this->logger->debug(sprintf('Position %d cannot be corrected in "%s"', $commandRun->startIndex, substr($descriptionContent, 0, 50) . '...'));
+                // Skip to prevent the description from becoming corrupted
+                continue;
+            }
+
+            // $commandRun->length sometimes incorrectly includes the newline as last char
+            $lastChar = mb_substr($descriptionContent, $enhancement['pos'] + $enhancement['len'] - 1, 1);
+            if ($lastChar === "\n") {
+                $enhancement['len'] -= 1;
+            }
+
+            $commandUrl = parse_url($commandMetadata->url);
+            if ($commandUrl['path'] === '/redirect') {
+                parse_str($commandUrl['query'], $commandUrlQuery);
+                $enhancement['url'] = urldecode($commandUrlQuery['q']);
+            } else if (isset($commandUrl['host'])) {
+                $enhancement['url'] = $commandMetadata->url;
+            } else {
+                $enhancement['url'] = $baseUrl . $commandMetadata->url;
+            }
+
+            $enhancements[] = $enhancement;
+        }
+
+        if (count($enhancements) !== count($commandRuns)) {
+            // At least one link can not be matched. Discard everything to prevent corrupting the description.
+            return [];
+        }
+
+        // Sort by position in descending order to be able to safely replace values
+        return array_reverse($enhancements);
     }
 
     private function ytBridgeAddItem($vid, $title, $author, $desc, $time, $thumbnail = '')
@@ -277,12 +392,12 @@ class YoutubeBridge extends BridgeAbstract
         $item['title'] = $title;
         $item['author'] = $author;
         $item['timestamp'] = $time;
-        $item['uri'] = self::URI . 'watch?v=' . $vid;
+        $item['uri'] = self::URI . '/watch?v=' . $vid;
         if (!$thumbnail) {
             // Fallback to default thumbnail if there aren't any provided.
             $thumbnail = '0';
         }
-        $thumbnailUri = str_replace('/www.', '/img.', self::URI) . 'vi/' . $vid . '/' . $thumbnail . '.jpg';
+        $thumbnailUri = str_replace('/www.', '/img.', self::URI) . '/vi/' . $vid . '/' . $thumbnail . '.jpg';
         $item['content'] = '<a href="' . $item['uri'] . '"><img src="' . $thumbnailUri . '" /></a><br />' . $desc;
         $this->items[] = $item;
     }
@@ -398,11 +513,6 @@ class YoutubeBridge extends BridgeAbstract
 
             $vid = $wrapper->videoId;
             $title = $wrapper->title->runs[0]->text;
-            if (isset($wrapper->ownerText)) {
-                $this->channel_name = $wrapper->ownerText->runs[0]->text;
-            } elseif (isset($wrapper->shortBylineText)) {
-                $this->channel_name = $wrapper->shortBylineText->runs[0]->text;
-            }
 
             $author = '';
             $desc = '';
@@ -450,7 +560,7 @@ class YoutubeBridge extends BridgeAbstract
     public function getURI()
     {
         if (!is_null($this->getInput('p'))) {
-            return static::URI . 'playlist?list=' . $this->getInput('p');
+            return static::URI . '/playlist?list=' . $this->getInput('p');
         } elseif ($this->feeduri) {
             return $this->feeduri;
         }
@@ -474,10 +584,10 @@ class YoutubeBridge extends BridgeAbstract
 
     public function getIcon()
     {
-        if (empty($this->iconURL)) {
+        if (empty($this->feedIconUrl)) {
             return parent::getIcon();
         } else {
-            return $this->iconURL;
+            return $this->feedIconUrl;
         }
     }
 }

From a3c29f3a52faddca776706759ef7ee33b68c32d5 Mon Sep 17 00:00:00 2001
From: mruac <ant8672@gmail.com>
Date: Fri, 22 Sep 2023 17:08:05 +0930
Subject: [PATCH 116/716] resolve comment (#3683)

https://github.com/RSS-Bridge/rss-bridge/pull/3617#issuecomment-1730244049
---
 bridges/PatreonBridge.php | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/bridges/PatreonBridge.php b/bridges/PatreonBridge.php
index d72bde20..a2162425 100644
--- a/bridges/PatreonBridge.php
+++ b/bridges/PatreonBridge.php
@@ -135,7 +135,7 @@ class PatreonBridge extends BridgeAbstract
                     $thumbnail = $post->attributes->thumbnail->large ?? null;
                     $thumbnail = $thumbnail ?? $post->attributes->thumbnail->url ?? null;
                     $thumbnail = $thumbnail ?? $post->attributes->image->thumb_url ?? null;
-                    $thumbnail = $thumbnail ?? $post->attributes->image->url;
+                    $thumbnail = $thumbnail ?? $post->attributes->image->url ?? null;
                     $audio_filename = $audio->file_name ?? $item['title'];
                     $download_url = $audio->download_url ?? $item['uri'];
                     $item['content'] .= "<p><a href\"{$download_url}\"><img src=\"{$thumbnail}\"><br/>🎧 {$audio_filename}</a><br/>";
@@ -150,7 +150,7 @@ class PatreonBridge extends BridgeAbstract
                     $thumbnail = $post->attributes->thumbnail->large ?? null;
                     $thumbnail = $thumbnail ?? $post->attributes->thumbnail->url ?? null;
                     $thumbnail = $thumbnail ?? $post->attributes->image->thumb_url ?? null;
-                    $thumbnail = $thumbnail ?? $post->attributes->image->url;
+                    $thumbnail = $thumbnail ?? $post->attributes->image->url ?? null;
                     $item['content'] .= "<p><a href=\"{$item['uri']}\">🎬 {$item['title']}<br><img src=\"{$thumbnail}\"></a></p>";
                     break;
 
@@ -158,7 +158,7 @@ class PatreonBridge extends BridgeAbstract
                     $thumbnail = $post->attributes->thumbnail->large ?? null;
                     $thumbnail = $thumbnail ?? $post->attributes->thumbnail->url ?? null;
                     $thumbnail = $thumbnail ?? $post->attributes->image->thumb_url ?? null;
-                    $thumbnail = $thumbnail ?? $post->attributes->image->url;
+                    $thumbnail = $thumbnail ?? $post->attributes->image->url ?? null;
                     $item['content'] .= "<p><a href=\"{$item['uri']}\">🎬 {$item['title']}<br><img src=\"{$thumbnail}\"></a></p>";
                     break;
 
@@ -166,9 +166,9 @@ class PatreonBridge extends BridgeAbstract
                     $item['content'] .= '<p>';
                     foreach ($post->relationships->images->data as $key => $image) {
                         $image = $this->findInclude($posts, 'media', $image->id)->attributes;
-                        $image_fullres = $image->download_url ?? $image->image_urls->url ?? $image->image_urls->original;
+                        $image_fullres = $image->download_url ?? $image->image_urls->url ?? $image->image_urls->original ?? null;
                         $filename = $image->file_name ?? '';
-                        $image_url = $image->image_urls->url ?? $image->image_urls->original;
+                        $image_url = $image->image_urls->url ?? $image->image_urls->original ?? null;
                         $item['enclosures'][] = $image_fullres;
                         $item['content'] .= "<a href=\"{$image_fullres}\">{$filename}<br/><img src=\"{$image_url}\"></a><br/><br/>";
                     }

From 39d671079863e3ba18534094146b32eaebd617a8 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 22 Sep 2023 20:41:39 +0200
Subject: [PATCH 117/716] fix(twitch) (#3685)

---
 bridges/TwitchBridge.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/bridges/TwitchBridge.php b/bridges/TwitchBridge.php
index e4abaa60..4cc0375d 100644
--- a/bridges/TwitchBridge.php
+++ b/bridges/TwitchBridge.php
@@ -96,6 +96,9 @@ EOD;
             throw new \Exception(sprintf('Unable to find channel `%s`', $channel));
         }
         $user = $data->user;
+        if ($user->videos === null) {
+            throw new HttpException('Service Unavailable', 503);
+        }
         foreach ($user->videos->edges as $edge) {
             $video = $edge->node;
 

From a6a1d553d9a5e17cd45f11f1e1c8d597e7184c77 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 22 Sep 2023 20:59:45 +0200
Subject: [PATCH 118/716] tweaks (#3686)

---
 bridges/BundesbankBridge.php | 4 +++-
 bridges/ReutersBridge.php    | 4 ++++
 bridges/TwitchBridge.php     | 8 +++++---
 3 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/bridges/BundesbankBridge.php b/bridges/BundesbankBridge.php
index 4335cb69..0c6b943f 100644
--- a/bridges/BundesbankBridge.php
+++ b/bridges/BundesbankBridge.php
@@ -71,7 +71,9 @@ class BundesbankBridge extends BridgeAbstract
                 $item['content'] .= '<strong>' . $study->find('.teasable__subtitle', 0)->plaintext . '</strong>';
             }
 
-            $item['content'] .= '<p>' . $study->find('.teasable__text', 0)->plaintext . '</p>';
+            $teasable = $study->find('.teasable__text', 0);
+            $teasableText = $teasable->plaintext ?? '';
+            $item['content'] .= '<p>' . $teasableText . '</p>';
 
             $item['timestamp'] = strtotime($study->find('.teasable__date', 0)->plaintext);
 
diff --git a/bridges/ReutersBridge.php b/bridges/ReutersBridge.php
index 2acadfc3..fdf4e2a9 100644
--- a/bridges/ReutersBridge.php
+++ b/bridges/ReutersBridge.php
@@ -466,6 +466,10 @@ EOD;
                     }
                     $rows = $content['rows'];
                     foreach ($rows as $row) {
+                        if (!is_array($row)) {
+                            // some rows are null
+                            continue;
+                        }
                         $tr = '<tr>';
                         foreach ($row as $data) {
                             $tr .= '<td>' . $data . '</td>';
diff --git a/bridges/TwitchBridge.php b/bridges/TwitchBridge.php
index 4cc0375d..f408f885 100644
--- a/bridges/TwitchBridge.php
+++ b/bridges/TwitchBridge.php
@@ -157,9 +157,11 @@ EOD;
 
             // Add played games list to content
             $item['content'] .= '<p><b>Played games:</b><ul>';
-            if (count($video->moments->edges) > 0) {
-                foreach ($video->moments->edges as $edge) {
-                    $moment = $edge->node;
+
+            $momentEdges = $video->moments->edges ?? [];
+            if (count($momentEdges) > 0) {
+                foreach ($momentEdges as $momentEdge) {
+                    $moment = $momentEdge->node;
 
                     $item['categories'][] = $moment->description;
                     $item['content'] .= '<li><a href="'

From 07f49225d98b43f34132ebd616716ea447f7c3f4 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 23 Sep 2023 16:52:39 +0200
Subject: [PATCH 119/716] fix: bug in refactor (#3688)

---
 lib/BridgeAbstract.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index a3d84188..e074ce74 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -24,7 +24,7 @@ abstract class BridgeAbstract
 
     protected array $items = [];
     protected array $inputs = [];
-    protected string $queriedContext = '';
+    protected ?string $queriedContext = '';
     private array $configuration = [];
 
     protected CacheInterface $cache;

From cb6c931b1f62b80634b73af63ace9693bc3cbe76 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 23 Sep 2023 17:50:41 +0200
Subject: [PATCH 120/716] fix(duckduckgo): order by date (#3689)

---
 bridges/AwwwardsBridge.php   | 38 ++++++++++++++++++------------------
 bridges/DuckDuckGoBridge.php | 15 +++++++++++---
 bridges/EngadgetBridge.php   | 11 ++++++++---
 bridges/JustWatchBridge.php  | 13 ++++++------
 bridges/YandexZenBridge.php  | 10 ++++++----
 bridges/YoutubeBridge.php    |  5 ++++-
 6 files changed, 55 insertions(+), 37 deletions(-)

diff --git a/bridges/AwwwardsBridge.php b/bridges/AwwwardsBridge.php
index a1adfede..849d04d5 100644
--- a/bridges/AwwwardsBridge.php
+++ b/bridges/AwwwardsBridge.php
@@ -14,29 +14,10 @@ class AwwwardsBridge extends BridgeAbstract
 
     private $sites = [];
 
-    public function getIcon()
-    {
-        return 'https://www.awwwards.com/favicon.ico';
-    }
-
-    private function fetchSites()
-    {
-        Debug::log('Fetching all sites');
-        $sites = getSimpleHTMLDOM(self::SITESURI);
-
-        Debug::log('Parsing all JSON data');
-        foreach ($sites->find('.grid-sites li') as $site) {
-            $decode = html_entity_decode($site->attr['data-collectable-model-value'], ENT_QUOTES, 'utf-8');
-            $decode = json_decode($decode, true);
-            $this->sites[] = $decode;
-        }
-    }
-
     public function collectData()
     {
         $this->fetchSites();
 
-        Debug::log('Building RSS feed');
         foreach ($this->sites as $site) {
             $item = [];
             $item['title'] = $site['title'];
@@ -56,4 +37,23 @@ class AwwwardsBridge extends BridgeAbstract
             }
         }
     }
+
+    public function getIcon()
+    {
+        return 'https://www.awwwards.com/favicon.ico';
+    }
+
+    private function fetchSites()
+    {
+        $sites = getSimpleHTMLDOM(self::SITESURI);
+        foreach ($sites->find('.grid-sites li') as $li) {
+            $encodedJson = $li->attr['data-collectable-model-value'] ?? null;
+            if (!$encodedJson) {
+                continue;
+            }
+            $json = html_entity_decode($encodedJson, ENT_QUOTES, 'utf-8');
+            $site = Json::decode($json);
+            $this->sites[] = $site;
+        }
+    }
 }
diff --git a/bridges/DuckDuckGoBridge.php b/bridges/DuckDuckGoBridge.php
index 5edf248b..6f9069fa 100644
--- a/bridges/DuckDuckGoBridge.php
+++ b/bridges/DuckDuckGoBridge.php
@@ -8,7 +8,7 @@ class DuckDuckGoBridge extends BridgeAbstract
     const CACHE_TIMEOUT = 21600; // 6h
     const DESCRIPTION = 'Returns results from DuckDuckGo.';
 
-    const SORT_DATE = '+sort:date';
+    const SORT_DATE = ' sort:date';
     const SORT_RELEVANCE = '';
 
     const PARAMETERS = [ [
@@ -31,13 +31,22 @@ class DuckDuckGoBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $html = getSimpleHTMLDOM(self::URI . 'html/?kd=-1&q=' . $this->getInput('u') . $this->getInput('sort'));
+        $query = [
+            'kd' => '-1',
+            'q'  => $this->getInput('u') . $this->getInput('sort'),
+        ];
+        $url = 'https://duckduckgo.com/html/?' . http_build_query($query);
+        $html = getSimpleHTMLDOM($url);
 
         foreach ($html->find('div.result') as $element) {
             $item = [];
             $item['uri'] = $element->find('a.result__a', 0)->href;
             $item['title'] = $element->find('h2.result__title', 0)->plaintext;
-            $item['content'] = $element->find('a.result__snippet', 0)->plaintext;
+
+            $snippet = $element->find('a.result__snippet', 0);
+            if ($snippet) {
+                $item['content'] = $snippet->plaintext;
+            }
             $this->items[] = $item;
         }
     }
diff --git a/bridges/EngadgetBridge.php b/bridges/EngadgetBridge.php
index 2bed4a4a..c219c0ff 100644
--- a/bridges/EngadgetBridge.php
+++ b/bridges/EngadgetBridge.php
@@ -10,14 +10,19 @@ class EngadgetBridge extends FeedExpander
 
     public function collectData()
     {
-        $this->collectExpandableDatas(static::URI . 'rss.xml', 15);
+        $max = 10;
+        $this->collectExpandableDatas(static::URI . 'rss.xml', $max);
     }
 
     protected function parseItem($newsItem)
     {
         $item = parent::parseItem($newsItem);
-        // $articlePage gets the entire page's contents
-        $articlePage = getSimpleHTMLDOM($newsItem->link);
+        $url = (string) $newsItem->link;
+        if (!$url) {
+            return $item;
+        }
+        // todo: remove querystring tracking
+        $articlePage = getSimpleHTMLDOM($url);
         // figure contain's the main article image
         $article = $articlePage->find('figure', 0);
         // .article-text has the actual article
diff --git a/bridges/JustWatchBridge.php b/bridges/JustWatchBridge.php
index 66b61aff..98dcd338 100644
--- a/bridges/JustWatchBridge.php
+++ b/bridges/JustWatchBridge.php
@@ -170,22 +170,21 @@ class JustWatchBridge extends BridgeAbstract
                 $item = [];
                 $item['uri'] = $title->find('a', 0)->href;
 
+                $posterImage = $title->find('.title-poster__image > img', 0);
                 $itemTitle = sprintf(
                     '%s - %s',
                     $provider->find('picture > img', 0)->alt ?? '',
-                    $title->find('.title-poster__image > img', 0)->alt ?? ''
+                    $posterImage->alt ?? ''
                 );
                 $item['title'] = $itemTitle;
 
-                $imageUrl = $title->find('.title-poster__image > img', 0)->attr['src'] ?? '';
+                $imageUrl = $posterImage->attr['src'] ?? '';
                 if (str_starts_with($imageUrl, 'data')) {
-                    $imageUrl = $title->find('.title-poster__image > img', 0)->attr['data-src'];
+                    $imageUrl = $posterImage->attr['data-src'];
                 }
 
-                $content  = '<b>Provider:</b> '
-                    . $provider->find('picture > img', 0)->alt . '<br>';
-                $content .= '<b>Media:</b> '
-                    . $title->find('.title-poster__image > img', 0)->alt . '<br>';
+                $content  = '<b>Provider:</b> ' . $provider->find('picture > img', 0)->alt . '<br>';
+                $content .= '<b>Media:</b> ' . ($posterImage->alt ?? '') . '<br>';
 
                 if (isset($title->find('.title-poster__badge', 0)->plaintext)) {
                     $content .= '<b>Type:</b> Series<br>';
diff --git a/bridges/YandexZenBridge.php b/bridges/YandexZenBridge.php
index ee1ff506..8a3db48b 100644
--- a/bridges/YandexZenBridge.php
+++ b/bridges/YandexZenBridge.php
@@ -45,10 +45,12 @@ class YandexZenBridge extends BridgeAbstract
                 $item['timestamp'] = date(DateTimeInterface::ATOM, $publicationDateUnixTimestamp);
             }
 
-            $item['content'] = $post->text . "<br /><img src='$post->image' />";
-            $item['enclosures'] = [
-                $post->image,
-            ];
+            $postImage = $post->image ?? null;
+            $item['content'] = $post->text;
+            if ($postImage) {
+                $item['content'] .= "<br /><img src='$postImage' />";
+                $item['enclosures'] = [$postImage];
+            }
 
             $this->items[] = $item;
         }
diff --git a/bridges/YoutubeBridge.php b/bridges/YoutubeBridge.php
index 66b7614f..418e715e 100644
--- a/bridges/YoutubeBridge.php
+++ b/bridges/YoutubeBridge.php
@@ -228,7 +228,10 @@ class YoutubeBridge extends BridgeAbstract
             return;
         }
 
-        $jsonData = $jsonData->contents->twoColumnWatchNextResults->results->results->contents;
+        $jsonData = $jsonData->contents->twoColumnWatchNextResults->results->results->contents ?? null;
+        if (!$jsonData) {
+            throw new \Exception('Unable to find json data');
+        }
         $videoSecondaryInfo = null;
         foreach ($jsonData as $item) {
             if (isset($item->videoSecondaryInfoRenderer)) {

From b3b0736761127faf9d009a450c5a2193dfc72519 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 23 Sep 2023 18:54:14 +0200
Subject: [PATCH 121/716] feat: improve error/exception ui (#3690)

---
 actions/ConnectivityAction.php                |  2 +-
 actions/DisplayAction.php                     | 21 +++++++++++--------
 lib/AuthenticationMiddleware.php              |  4 +++-
 lib/RssBridge.php                             |  4 ++--
 lib/html.php                                  |  5 +++--
 lib/http.php                                  |  6 +++---
 templates/access-denied.html.php              |  4 ----
 templates/error.php                           | 15 +++++++++++++
 .../{error.html.php => exception.html.php}    | 17 +++++++++++++--
 9 files changed, 54 insertions(+), 24 deletions(-)
 delete mode 100644 templates/access-denied.html.php
 create mode 100644 templates/error.php
 rename templates/{error.html.php => exception.html.php} (86%)

diff --git a/actions/ConnectivityAction.php b/actions/ConnectivityAction.php
index 3bc82a9d..cfffd195 100644
--- a/actions/ConnectivityAction.php
+++ b/actions/ConnectivityAction.php
@@ -34,7 +34,7 @@ class ConnectivityAction implements ActionInterface
     public function execute(array $request)
     {
         if (!Debug::isEnabled()) {
-            return new Response('This action is only available in debug mode!');
+            return new Response('This action is only available in debug mode!', 403);
         }
 
         $bridgeName = $request['bridge'] ?? null;
diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 87b040c2..138319fe 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -14,7 +14,10 @@ class DisplayAction implements ActionInterface
     public function execute(array $request)
     {
         if (Configuration::getConfig('system', 'enable_maintenance_mode')) {
-            return new Response('503 Service Unavailable', 503);
+            return new Response(render(__DIR__ . '/../templates/error.html.php', [
+                'title'     => '503 Service Unavailable',
+                'message'   => 'RSS-Bridge is down for maintenance.',
+            ]), 503);
         }
         $cacheKey = 'http_' . json_encode($request);
         /** @var Response $cachedResponse */
@@ -36,19 +39,19 @@ class DisplayAction implements ActionInterface
 
         $bridgeName = $request['bridge'] ?? null;
         if (!$bridgeName) {
-            return new Response('Missing bridge param', 400);
+            return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'Missing bridge parameter']), 400);
         }
         $bridgeFactory = new BridgeFactory();
         $bridgeClassName = $bridgeFactory->createBridgeClassName($bridgeName);
         if (!$bridgeClassName) {
-            return new Response('Bridge not found', 404);
+            return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'Bridge not found']), 404);
         }
         $format = $request['format'] ?? null;
         if (!$format) {
-            return new Response('You must specify a format!', 400);
+            return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'You must specify a format']), 400);
         }
         if (!$bridgeFactory->isEnabled($bridgeClassName)) {
-            return new Response('This bridge is not whitelisted', 400);
+            return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'This bridge is not whitelisted']), 400);
         }
 
         $noproxy = $request['_noproxy'] ?? null;
@@ -120,11 +123,11 @@ class DisplayAction implements ActionInterface
                 // Reproduce (and log) these responses regardless of error output and report limit
                 if ($e->getCode() === 429) {
                     $this->logger->info(sprintf('Exception in DisplayAction(%s): %s', $bridge->getShortName(), create_sane_exception_message($e)));
-                    return new Response('429 Too Many Requests', 429);
+                    return new Response(render(__DIR__ . '/../templates/exception.html.php', ['e' => $e]), 429);
                 }
                 if ($e->getCode() === 503) {
                     $this->logger->info(sprintf('Exception in DisplayAction(%s): %s', $bridge->getShortName(), create_sane_exception_message($e)));
-                    return new Response('503 Service Unavailable', 503);
+                    return new Response(render(__DIR__ . '/../templates/exception.html.php', ['e' => $e]), 503);
                 }
             }
             $this->logger->error(sprintf('Exception in DisplayAction(%s)', $bridge->getShortName()), ['e' => $e]);
@@ -140,7 +143,7 @@ class DisplayAction implements ActionInterface
                     // Render the exception as a feed item
                     $items[] = $this->createFeedItemFromException($e, $bridge);
                 } elseif ($errorOutput === 'http') {
-                    return new Response(render(__DIR__ . '/../templates/error.html.php', ['e' => $e]), 500);
+                    return new Response(render(__DIR__ . '/../templates/exception.html.php', ['e' => $e]), 500);
                 } elseif ($errorOutput === 'none') {
                     // Do nothing (produces an empty feed)
                 }
@@ -173,7 +176,7 @@ class DisplayAction implements ActionInterface
         $item->setUid($bridge->getName() . '_' . $uniqueIdentifier);
 
         $content = render_template(__DIR__ . '/../templates/bridge-error.html.php', [
-            'error' => render_template(__DIR__ . '/../templates/error.html.php', ['e' => $e]),
+            'error' => render_template(__DIR__ . '/../templates/exception.html.php', ['e' => $e]),
             'searchUrl' => self::createGithubSearchUrl($bridge),
             'issueUrl' => self::createGithubIssueUrl($bridge, $e, create_sane_exception_message($e)),
             'maintainer' => $bridge->getMaintainer(),
diff --git a/lib/AuthenticationMiddleware.php b/lib/AuthenticationMiddleware.php
index c77e1b91..8c2f6b29 100644
--- a/lib/AuthenticationMiddleware.php
+++ b/lib/AuthenticationMiddleware.php
@@ -44,6 +44,8 @@ final class AuthenticationMiddleware
     {
         http_response_code(401);
         header('WWW-Authenticate: Basic realm="RSS-Bridge"');
-        return render('access-denied.html.php');
+        return render(__DIR__ . '/../templates/error.html.php', [
+            'message' => 'Please authenticate in order to access this instance!',
+        ]);
     }
 }
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index 0ec7174d..da093cab 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -22,7 +22,7 @@ final class RssBridge
         set_exception_handler(function (\Throwable $e) {
             self::$logger->error('Uncaught Exception', ['e' => $e]);
             http_response_code(500);
-            print render(__DIR__ . '/../templates/error.html.php', ['e' => $e]);
+            print render(__DIR__ . '/../templates/exception.html.php', ['e' => $e]);
             exit(1);
         });
 
@@ -117,7 +117,7 @@ final class RssBridge
         } catch (\Throwable $e) {
             self::$logger->error('Exception in RssBridge::main()', ['e' => $e]);
             http_response_code(500);
-            print render(__DIR__ . '/../templates/error.html.php', ['e' => $e]);
+            print render(__DIR__ . '/../templates/exception.html.php', ['e' => $e]);
         }
     }
 
diff --git a/lib/html.php b/lib/html.php
index 489fb5b4..505221fc 100644
--- a/lib/html.php
+++ b/lib/html.php
@@ -34,8 +34,9 @@ function render(string $template, array $context = []): string
 }
 
 /**
- * Render template as absolute path or relative to templates folder.
- * Do not pass user input in $template
+ * Render php template with context
+ *
+ * DO NOT PASS USER INPUT IN $template or $context
  */
 function render_template(string $template, array $context = []): string
 {
diff --git a/lib/http.php b/lib/http.php
index cc1d0e22..10ce86c9 100644
--- a/lib/http.php
+++ b/lib/http.php
@@ -115,8 +115,8 @@ final class CurlHttpClient implements HttpClient
         $attempts = 0;
         while (true) {
             $attempts++;
-            $data = curl_exec($ch);
-            if ($data !== false) {
+            $body = curl_exec($ch);
+            if ($body !== false) {
                 // The network call was successful, so break out of the loop
                 break;
             }
@@ -136,7 +136,7 @@ final class CurlHttpClient implements HttpClient
 
         $statusCode = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
         curl_close($ch);
-        return new Response($data, $statusCode, $responseHeaders);
+        return new Response($body, $statusCode, $responseHeaders);
     }
 }
 
diff --git a/templates/access-denied.html.php b/templates/access-denied.html.php
deleted file mode 100644
index 64968680..00000000
--- a/templates/access-denied.html.php
+++ /dev/null
@@ -1,4 +0,0 @@
-
-<h1>
-    Please authenticate in order to access this instance
-</h1>
diff --git a/templates/error.php b/templates/error.php
new file mode 100644
index 00000000..16ab20b0
--- /dev/null
+++ b/templates/error.php
@@ -0,0 +1,15 @@
+<?php
+/**
+ * This template is for rendering error messages (not exceptions)
+ */
+?>
+
+<?php if (isset($title)): ?>
+    <h1>
+        <?= e($title) ?>
+    </h1>
+<?php endif; ?>
+
+<p>
+    <?= e($message) ?>
+</p>
diff --git a/templates/error.html.php b/templates/exception.html.php
similarity index 86%
rename from templates/error.html.php
rename to templates/exception.html.php
index 5220ba7c..3fe523f8 100644
--- a/templates/error.html.php
+++ b/templates/exception.html.php
@@ -1,3 +1,8 @@
+<?php
+/**
+ * This template is used for rendering exceptions
+ */
+?>
 <div class="error">
 
     <?php if ($e instanceof HttpException): ?>
@@ -12,7 +17,7 @@
         <?php endif; ?>
 
         <?php if ($e->getCode() === 404): ?>
-            <h2>The website was not found</h2>
+            <h2>404 Page Not Found</h2>
             <p>
                 RSS-Bridge tried to fetch a page on a website.
                 But it doesn't exists.
@@ -20,13 +25,21 @@
         <?php endif; ?>
 
         <?php if ($e->getCode() === 429): ?>
-            <h2>Try again later</h2>
+            <h2>429 Try again later</h2>
             <p>
                 RSS-Bridge tried to fetch a website.
                 They told us to try again later.
             </p>
         <?php endif; ?>
 
+        <?php if ($e->getCode() === 503): ?>
+            <h2>503 Service Unavailable</h2>
+            <p>
+                Common causes are a server that is down for maintenance
+                or that is overloaded.
+            </p>
+        <?php endif; ?>
+
     <?php else: ?>
         <?php if ($e->getCode() === 10): ?>
             <h2>The rss feed is completely empty</h2>

From f943f8d0020c347a053b6e123afff8951c80f78a Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 23 Sep 2023 19:28:52 +0200
Subject: [PATCH 122/716] fix: typo in prior commit (#3693)

---
 templates/{error.php => error.html.php} | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename templates/{error.php => error.html.php} (100%)

diff --git a/templates/error.php b/templates/error.html.php
similarity index 100%
rename from templates/error.php
rename to templates/error.html.php

From bab02bf19020775091c003b1aa040ccf2adb9a1a Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 23 Sep 2023 19:29:04 +0200
Subject: [PATCH 123/716] fix(flickr) (#3692)

---
 bridges/FlickrBridge.php | 24 ++++++++++++++----------
 1 file changed, 14 insertions(+), 10 deletions(-)

diff --git a/bridges/FlickrBridge.php b/bridges/FlickrBridge.php
index 48df9757..522c7284 100644
--- a/bridges/FlickrBridge.php
+++ b/bridges/FlickrBridge.php
@@ -145,7 +145,6 @@ class FlickrBridge extends BridgeAbstract
             . '</p>';
 
             $item['enclosures'] = $this->extractEnclosures($model);
-
             $this->items[] = $item;
         }
     }
@@ -255,17 +254,22 @@ class FlickrBridge extends BridgeAbstract
     {
         $areas = [];
         $limit = 320 * 240;
-
-        foreach ($model['sizes']['data'] as $size) {
-            $size = $size['data'];
-            $image_area = $size['width'] * $size['height'];
-
-            if ($image_area >= $limit) {
-                $areas[$image_area] = $size['url'];
+        $sizes = $model['sizes']['data'];
+        foreach ($sizes as $sizeData) {
+            $sizeData = $sizeData['data'];
+            $area = $sizeData['width'] * $sizeData['height'];
+            if ($area >= $limit) {
+                $areas[$area] = $sizeData['url'];
             }
         }
-
-        return $this->fixURL(min($areas));
+        if ($areas) {
+            $minKey = min(array_keys($areas));
+            $url = $areas[$minKey];
+        } else {
+            $array_key_first = array_key_first($sizes);
+            $url = $sizes[$array_key_first]['data']['url'];
+        }
+        return $this->fixURL($url);
     }
 
     private function fixURL($url)

From 0c69148cff1995839dd37eae228d4f2a6434f562 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 23 Sep 2023 20:39:02 +0200
Subject: [PATCH 124/716] fix(vice): news rss changed (#3694)

* fix: typo in prior commit

* fix(vice): news rss changed
---
 bridges/ViceBridge.php       | 6 +++++-
 lib/XPathAbstract.php        | 3 ++-
 templates/exception.html.php | 2 +-
 3 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/bridges/ViceBridge.php b/bridges/ViceBridge.php
index 1c44d246..35414020 100644
--- a/bridges/ViceBridge.php
+++ b/bridges/ViceBridge.php
@@ -5,7 +5,7 @@ class ViceBridge extends FeedExpander
     const MAINTAINER = 'IceWreck';
     const NAME = 'Vice Bridge';
     const URI = 'https://www.vice.com/';
-    const CACHE_TIMEOUT = 3600; // This is a news site, so don't cache for more than 10 mins
+    const CACHE_TIMEOUT = 3600;
     const DESCRIPTION = 'RSS feed for vice publications like Vice News, Munchies, Motherboard, etc.';
     const PARAMETERS = [ [
         'feed' => [
@@ -24,6 +24,10 @@ class ViceBridge extends FeedExpander
     public function collectData()
     {
         $feed = $this->getInput('feed');
+        if ($feed === 'rss') {
+            // They changed url in Sep 2023
+            $feed = 'en/rss';
+        }
         $feedURL = 'https://www.vice.com/' . $feed;
         $this->collectExpandableDatas($feedURL, 10);
     }
diff --git a/lib/XPathAbstract.php b/lib/XPathAbstract.php
index bac3bfd7..e30bb5eb 100644
--- a/lib/XPathAbstract.php
+++ b/lib/XPathAbstract.php
@@ -390,7 +390,7 @@ abstract class XPathAbstract extends BridgeAbstract
      * Should provide the feed's items.
      *
      * @param \DOMXPath $xpath
-     * @return \DOMNodeList
+     * @return \DOMNodeList|false
      */
     protected function provideFeedItems(\DOMXPath $xpath)
     {
@@ -417,6 +417,7 @@ abstract class XPathAbstract extends BridgeAbstract
 
         $entries = $this->provideFeedItems($xpath);
         if ($entries === false) {
+            // malformed
             return;
         }
 
diff --git a/templates/exception.html.php b/templates/exception.html.php
index 3fe523f8..6ea747f2 100644
--- a/templates/exception.html.php
+++ b/templates/exception.html.php
@@ -25,7 +25,7 @@
         <?php endif; ?>
 
         <?php if ($e->getCode() === 429): ?>
-            <h2>429 Try again later</h2>
+            <h2>429 Too Many Requests</h2>
             <p>
                 RSS-Bridge tried to fetch a website.
                 They told us to try again later.

From d33808ea9eddfb5fd7371e2ad0ba5c8d232a9b1f Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 23 Sep 2023 23:49:01 +0200
Subject: [PATCH 125/716] fix: image (#3698)

---
 bridges/PornhubBridge.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/bridges/PornhubBridge.php b/bridges/PornhubBridge.php
index 104463a8..b8f1dec8 100644
--- a/bridges/PornhubBridge.php
+++ b/bridges/PornhubBridge.php
@@ -88,7 +88,8 @@ class PornhubBridge extends BridgeAbstract
             $item['uri'] = 'https://www.pornhub.com' . $url;
 
             // Content
-            $image = $element->find('img', 0)->getAttribute('data-src');
+            $videoImage = $element->find('img', 0);
+            $image = $videoImage->getAttribute('data-src') ?: $videoImage->getAttribute('src');
             if ($show_images === true) {
                 $item['content'] = '<a href="' . $item['uri'] . '"><img src="' . $image . '"></a>';
             }

From 0dc6c66840a0dfd13b4ccb7408196c810b02ce46 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 24 Sep 2023 00:03:21 +0200
Subject: [PATCH 126/716] fix: add duration (#3699)

---
 bridges/PornhubBridge.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/bridges/PornhubBridge.php b/bridges/PornhubBridge.php
index b8f1dec8..788ef58a 100644
--- a/bridges/PornhubBridge.php
+++ b/bridges/PornhubBridge.php
@@ -87,11 +87,15 @@ class PornhubBridge extends BridgeAbstract
             $url = $element->find('a', 0)->href;
             $item['uri'] = 'https://www.pornhub.com' . $url;
 
+            // Duration
+            $marker = $element->find('div.marker-overlays var', 0);
+            $duration = $marker->innertext ?? '';
+
             // Content
             $videoImage = $element->find('img', 0);
             $image = $videoImage->getAttribute('data-src') ?: $videoImage->getAttribute('src');
             if ($show_images === true) {
-                $item['content'] = '<a href="' . $item['uri'] . '"><img src="' . $image . '"></a>';
+                $item['content'] = sprintf('<a href="%s"><img src="%s"></a><br>%s', $item['uri'], $image, $duration);
             }
 
             $uploaded = explode('/', $image);

From ce353c1e4f1ea7f2b1170fa3564dcdca85350c8c Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Sun, 24 Sep 2023 16:12:30 +0200
Subject: [PATCH 127/716] [CssSelectorBridge] Fix URL filtering (#3676) (#3701)

Co-authored-by: tougaj <tougaj@users.noreply.github.com>
---
 bridges/CssSelectorBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/CssSelectorBridge.php b/bridges/CssSelectorBridge.php
index ce158758..8408633b 100644
--- a/bridges/CssSelectorBridge.php
+++ b/bridges/CssSelectorBridge.php
@@ -114,7 +114,7 @@ class CssSelectorBridge extends BridgeAbstract
     {
         if (!empty($url_pattern)) {
             $url_pattern = '/' . str_replace('/', '\/', $url_pattern) . '/';
-            $links = array_filter($links, function ($url) {
+            $links = array_filter($links, function ($url) use ($url_pattern) {
                 return preg_match($url_pattern, $url) === 1;
             });
         }

From 437afd67e0bc339bf328488f4c7411d71a872647 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 24 Sep 2023 18:15:14 +0200
Subject: [PATCH 128/716] fix: various fixes (#3702)

* fix: symfonycasts

* various fixes
---
 bridges/AtmoNouvelleAquitaineBridge.php |  3 +
 bridges/BrutBridge.php                  | 77 +++++--------------------
 bridges/SitemapBridge.php               |  2 +-
 bridges/SymfonyCastsBridge.php          | 21 ++++---
 composer.json                           |  4 +-
 5 files changed, 32 insertions(+), 75 deletions(-)

diff --git a/bridges/AtmoNouvelleAquitaineBridge.php b/bridges/AtmoNouvelleAquitaineBridge.php
index d4244fa9..d2621b9a 100644
--- a/bridges/AtmoNouvelleAquitaineBridge.php
+++ b/bridges/AtmoNouvelleAquitaineBridge.php
@@ -30,6 +30,9 @@ class AtmoNouvelleAquitaineBridge extends BridgeAbstract
 
     public function collectData()
     {
+        // this bridge is broken and unmaintained
+        return;
+
         $uri = self::URI . '/monair/commune/' . $this->getInput('cities');
 
         $html = getSimpleHTMLDOM($uri);
diff --git a/bridges/BrutBridge.php b/bridges/BrutBridge.php
index aa2a1b4d..0db0851a 100644
--- a/bridges/BrutBridge.php
+++ b/bridges/BrutBridge.php
@@ -38,50 +38,20 @@ class BrutBridge extends BridgeAbstract
         ]
     ];
 
-    const CACHE_TIMEOUT = 1800; // 30 mins
-
-    private $jsonRegex = '/window\.__PRELOADED_STATE__ = ((?:.*)});/';
-
     public function collectData()
     {
-        $html = getSimpleHTMLDOM($this->getURI());
-
-        $results = $html->find('div.results', 0);
-
-        foreach ($results->find('li.col-6.col-sm-4.col-md-3.col-lg-2.px-2.pb-4') as $li) {
-            $item = [];
-
-            $videoPath = self::URI . $li->children(0)->href;
-            $videoPageHtml = getSimpleHTMLDOMCached($videoPath, 3600);
-
-            $json = $this->extractJson($videoPageHtml);
-            $id = array_keys((array) $json->media->index)[0];
-
-            $item['uri'] = $videoPath;
-            $item['title'] = $json->media->index->$id->title;
-            $item['timestamp'] = $json->media->index->$id->published_at;
-            $item['enclosures'][] = $json->media->index->$id->media->thumbnail;
-
-            $description = $json->media->index->$id->description;
-            $article = '';
-
-            if (is_null($json->media->index->$id->media->seo_article) === false) {
-                $article = markdownToHtml($json->media->index->$id->media->seo_article);
-            }
-
-            $item['content'] = <<<EOD
-			<video controls poster="{$json->media->index->$id->media->thumbnail}" preload="none">
-				<source src="{$json->media->index->$id->media->mp4_url}" type="video/mp4">
-			</video>
-			<p>{$description}</p>
-			{$article}
-EOD;
-
-            $this->items[] = $item;
-
-            if (count($this->items) >= 10) {
-                break;
-            }
+        $url = $this->getURI();
+        $html = getSimpleHTMLDOM($url);
+        $regex = '/window.__PRELOADED_STATE__ = (.*);/';
+        preg_match($regex, $html, $parts);
+        $data = Json::decode($parts[1], false);
+        foreach ($data->medias->index as $uid => $media) {
+            $this->items[] = [
+                'uid'       => $uid,
+                'title'     => $media->metadata->slug,
+                'uri'       => $media->share_url,
+                'timestamp' => $media->published_at,
+            ];
         }
     }
 
@@ -90,35 +60,14 @@ EOD;
         if (!is_null($this->getInput('edition')) && !is_null($this->getInput('category'))) {
             return self::URI . '/' . $this->getInput('edition') . '/' . $this->getInput('category');
         }
-
         return parent::getURI();
     }
 
     public function getName()
     {
         if (!is_null($this->getInput('edition')) && !is_null($this->getInput('category'))) {
-            return $this->getKey('category') . ' - ' .
-                $this->getKey('edition') . ' - Brut.';
+            return $this->getKey('category') . ' - ' . $this->getKey('edition') . ' - Brut.';
         }
-
         return parent::getName();
     }
-
-    /**
-     * Extract JSON from page
-     */
-    private function extractJson($html)
-    {
-        if (!preg_match($this->jsonRegex, $html, $parts)) {
-            returnServerError('Failed to extract data from page');
-        }
-
-        $data = json_decode($parts[1]);
-
-        if ($data === false) {
-            returnServerError('Failed to decode extracted data');
-        }
-
-        return $data;
-    }
 }
diff --git a/bridges/SitemapBridge.php b/bridges/SitemapBridge.php
index eec9d658..660504ba 100644
--- a/bridges/SitemapBridge.php
+++ b/bridges/SitemapBridge.php
@@ -72,7 +72,7 @@ class SitemapBridge extends CssSelectorBridge
         $sitemap_xml = $this->getSitemapXml($sitemap_url, !empty($site_map));
         $links = $this->sitemapXmlToList($sitemap_xml, $url_pattern, empty($limit) ? 10 : $limit);
 
-        if (empty($links) && empty(sitemapXmlToList($sitemap_xml))) {
+        if (empty($links) && empty($this->sitemapXmlToList($sitemap_xml))) {
             returnClientError('Could not retrieve URLs with Timestamps from Sitemap: ' . $sitemap_url);
         }
 
diff --git a/bridges/SymfonyCastsBridge.php b/bridges/SymfonyCastsBridge.php
index 29ba87cd..e3261d98 100644
--- a/bridges/SymfonyCastsBridge.php
+++ b/bridges/SymfonyCastsBridge.php
@@ -10,22 +10,27 @@ class SymfonyCastsBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $html = getSimpleHTMLDOM('https://symfonycasts.com/updates/find');
-        $dives = $html->find('div');
+        $url = 'https://symfonycasts.com/updates/find';
+        $html = getSimpleHTMLDOM($url);
+
+        /** @var simple_html_dom_node[] $dives */
+        $dives = $html->find('div.user-notification-not-viewed');
 
-        /* @var simple_html_dom $div */
         foreach ($dives as $div) {
-            $id = $div->getAttribute('data-mark-update-id-value');
             $type = $div->find('h5', 0);
-            $title = $div->find('span', 0);
+            $title = $div->find('a', 0);
             $dateString = $div->find('h5.font-gray', 0);
             $href = $div->find('a', 0);
-            $url = 'https://symfonycasts.com' . $href->getAttribute('href');
+            $hrefAttribute = $href->getAttribute('href');
+            $url = 'https://symfonycasts.com' . $hrefAttribute;
 
-            $item = []; // Create an empty item
-            $item['uid'] = $id;
+            $item = [];
+            $item['uid'] = $div->getAttribute('data-mark-update-update-url-value');
             $item['title'] = $title->innertext;
+
+            // this natural language date string does not work
             $item['timestamp'] = $dateString->innertext;
+
             $item['content'] = $type->plaintext . '<a href="' . $url . '">' . $title . '</a>';
             $item['uri'] = $url;
             $this->items[] = $item; // Add item to the list
diff --git a/composer.json b/composer.json
index a08c9666..31e31d74 100644
--- a/composer.json
+++ b/composer.json
@@ -28,8 +28,7 @@
         "ext-openssl": "*",
         "ext-libxml": "*",
         "ext-simplexml": "*",
-        "ext-json": "*",
-        "ext-intl": "*"
+        "ext-json": "*"
     },
     "require-dev": {
         "phpunit/phpunit": "^9",
@@ -39,6 +38,7 @@
         "ext-memcached": "Allows to use memcached as cache type",
         "ext-sqlite3": "Allows to use an SQLite database for caching",
         "ext-zip": "Required for FDroidRepoBridge",
+        "ext-intl": "Required for OLXBridge",
         "ext-dom": "Allows to use some bridges based on XPath expressions"
     },
     "autoload-dev": {

From f321f000c170c45aadd750bddd25d5074b4e281f Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 24 Sep 2023 18:34:09 +0200
Subject: [PATCH 129/716] feat: add url component (#3684)

* feat: add url library

* fix
---
 bridges/RedditBridge.php |  25 ++++---
 lib/bootstrap.php        |   1 +
 lib/url.php              | 145 +++++++++++++++++++++++++++++++++++++++
 tests/UrlTest.php        |  47 +++++++++++++
 4 files changed, 208 insertions(+), 10 deletions(-)
 create mode 100644 lib/url.php
 create mode 100644 tests/UrlTest.php

diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index 8d46f7bd..f761afaa 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -305,25 +305,30 @@ class RedditBridge extends BridgeAbstract
 
     public function detectParameters($url)
     {
-        $parsed_url = parse_url($url);
-
-        $host = $parsed_url['host'] ?? null;
-
-        if ($host != 'www.reddit.com' && $host != 'old.reddit.com') {
+        try {
+            $urlObject = Url::fromString($url);
+        } catch (UrlException $e) {
             return null;
         }
 
-        $path = explode('/', $parsed_url['path']);
+        $host = $urlObject->getHost();
+        $path = $urlObject->getPath();
 
-        if ($path[1] == 'r') {
+        $pathSegments = explode('/', $path);
+
+        if ($host !== 'www.reddit.com' && $host !== 'old.reddit.com') {
+            return null;
+        }
+
+        if ($pathSegments[1] == 'r') {
             return [
                 'context' => 'single',
-                'r' => $path[2]
+                'r' => $pathSegments[2],
             ];
-        } elseif ($path[1] == 'user') {
+        } elseif ($pathSegments[1] == 'user') {
             return [
                 'context' => 'user',
-                'u' => $path[2]
+                'u' => $pathSegments[2],
             ];
         } else {
             return null;
diff --git a/lib/bootstrap.php b/lib/bootstrap.php
index c8cf4e99..dc1c0f04 100644
--- a/lib/bootstrap.php
+++ b/lib/bootstrap.php
@@ -44,6 +44,7 @@ $files = [
     __DIR__ . '/../lib/utils.php',
     __DIR__ . '/../lib/http.php',
     __DIR__ . '/../lib/logger.php',
+    __DIR__ . '/../lib/url.php',
     // Vendor
     __DIR__ . '/../vendor/parsedown/Parsedown.php',
     __DIR__ . '/../vendor/php-urljoin/src/urljoin.php',
diff --git a/lib/url.php b/lib/url.php
new file mode 100644
index 00000000..2dcbbba5
--- /dev/null
+++ b/lib/url.php
@@ -0,0 +1,145 @@
+<?php
+
+declare(strict_types=1);
+
+final class UrlException extends \Exception
+{
+}
+
+/**
+ * Intentionally restrictive url parser
+ */
+final class Url
+{
+    private string $scheme;
+    private string $host;
+    private int $port;
+    private string $path;
+    private ?string $queryString;
+
+    private function __construct()
+    {
+    }
+
+    public static function fromString(string $url): self
+    {
+        if (!self::validate($url)) {
+            throw new UrlException(sprintf('Illegal url: "%s"', $url));
+        }
+
+        $parts = parse_url($url);
+        if ($parts === false) {
+            throw new UrlException(sprintf('Invalid url %s', $url));
+        }
+
+        return (new self())
+            ->withScheme($parts['scheme'] ?? '')
+            ->withHost($parts['host'])
+            ->withPort($parts['port'] ?? 80)
+            ->withPath($parts['path'] ?? '/')
+            ->withQueryString($parts['query'] ?? null);
+    }
+
+    public static function validate(string $url): bool
+    {
+        if (strlen($url) > 1500) {
+            return false;
+        }
+        $pattern = '#^https?://'   // scheme
+            . '([a-z0-9-]+\.?)+'   // one or more domain names
+            . '(\.[a-z]{1,24})?'   // optional global tld
+            . '(:\d+)?'            // optional port
+            . '($|/|\?)#i';        // end of string or slash or question mark
+
+        return preg_match($pattern, $url) === 1;
+    }
+
+    public function getScheme(): string
+    {
+        return $this->scheme;
+    }
+
+    public function getHost(): string
+    {
+        return $this->host;
+    }
+
+    public function getPort(): int
+    {
+        return $this->port;
+    }
+
+    public function getPath(): string
+    {
+        return $this->path;
+    }
+
+    public function getQueryString(): string
+    {
+        return $this->queryString;
+    }
+
+    public function withScheme(string $scheme): self
+    {
+        if (!in_array($scheme, ['http', 'https'])) {
+            throw new UrlException(sprintf('Invalid scheme %s', $scheme));
+        }
+        $clone = clone $this;
+        $clone->scheme = $scheme;
+        return $clone;
+    }
+
+    public function withHost(string $host): self
+    {
+        $clone = clone $this;
+        $clone->host = $host;
+        return $clone;
+    }
+
+    public function withPort(int $port)
+    {
+        $clone = clone $this;
+        $clone->port = $port;
+        return $clone;
+    }
+
+    public function withPath(string $path): self
+    {
+        if (!str_starts_with($path, '/')) {
+            throw new UrlException(sprintf('Path must start with forward slash: %s', $path));
+        }
+        $clone = clone $this;
+        $clone->path = $path;
+        return $clone;
+    }
+
+    public function withQueryString(?string $queryString): self
+    {
+        $clone = clone $this;
+        $clone->queryString = $queryString;
+        return $clone;
+    }
+
+    public function __toString()
+    {
+        if ($this->port === 80) {
+            $port = '';
+        } else {
+            $port = ':' . $this->port;
+        }
+        if ($this->queryString) {
+            $queryString = '?' . $this->queryString;
+        } else {
+            $queryString = '';
+        }
+
+        return sprintf(
+            '%s://%s%s%s%s',
+            $this->scheme,
+            $this->host,
+            $port,
+            $this->path,
+            $queryString
+        );
+    }
+}
diff --git a/tests/UrlTest.php b/tests/UrlTest.php
new file mode 100644
index 00000000..d45f319b
--- /dev/null
+++ b/tests/UrlTest.php
@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace RssBridge\Tests;
+
+use PHPUnit\Framework\TestCase;
+use Url;
+
+class UrlTest extends TestCase
+{
+    public function testBasicUsages()
+    {
+        $urls = [
+            'http://example.com/',
+            'http://example.com:9000/',
+            'https://example.com/',
+            'https://example.com/?foo',
+            'https://example.com/?foo=bar',
+        ];
+        foreach ($urls as $url) {
+            $this->assertSame($url, Url::fromString($url)->__toString());
+        }
+    }
+
+    public function testNormalization()
+    {
+        $urls = [
+            'http://example.com' => 'http://example.com/',
+            'https://example.com/?' => 'https://example.com/',
+            'https://example.com/foo?' => 'https://example.com/foo',
+            'http://example.com:80/' => 'http://example.com/',
+        ];
+        foreach ($urls as $from => $to) {
+            $this->assertSame($to, Url::fromString($from)->__toString());
+        }
+    }
+
+    public function testMutation()
+    {
+        $this->assertSame('http://example.com/foo', (Url::fromString('http://example.com/'))->withPath('/foo')->__toString());
+        $this->assertSame('http://example.com/foo?a=b', (Url::fromString('http://example.com/?a=b'))->withPath('/foo')->__toString());
+        $this->assertSame('http://example.com/', (Url::fromString('http://example.com/'))->withPath('/')->__toString());
+        $this->assertSame('http://example.com/qqq?foo=bar', (Url::fromString('http://example.com/qqq'))->withQueryString('foo=bar')->__toString());
+        $this->assertSame('http://example.net/qqq?foo=bar', (Url::fromString('http://example.com/qqq?foo=bar'))->withHost('example.net')->__toString());
+    }
+}

From 857e908929ef26da41646c04804cbd4aa106ec52 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 24 Sep 2023 20:53:07 +0200
Subject: [PATCH 130/716] chore: prepare 2023-09-24 release (#3703)

---
 caches/FileCache.php                          |   4 +-
 caches/SQLiteCache.php                        |   4 +
 .../prepare_release/fetch_contributors.php    |  53 ------
 .../prepare_release/rssbridge-log-helper.el   | 151 ------------------
 contrib/prepare_release/template.md           |  23 ---
 lib/Configuration.php                         |   2 +-
 lib/RssBridge.php                             |   2 +
 templates/frontpage.html.php                  |  12 +-
 8 files changed, 19 insertions(+), 232 deletions(-)
 delete mode 100644 contrib/prepare_release/fetch_contributors.php
 delete mode 100644 contrib/prepare_release/rssbridge-log-helper.el
 delete mode 100644 contrib/prepare_release/template.md

diff --git a/caches/FileCache.php b/caches/FileCache.php
index 703fb6db..1ae88704 100644
--- a/caches/FileCache.php
+++ b/caches/FileCache.php
@@ -36,7 +36,7 @@ class FileCache implements CacheInterface
             $this->delete($key);
             return $default;
         }
-        $expiration = $item['expiration'];
+        $expiration = $item['expiration'] ?? time();
         if ($expiration === 0 || $expiration > time()) {
             return $item['value'];
         }
@@ -92,7 +92,7 @@ class FileCache implements CacheInterface
                 unlink($cacheFile);
                 continue;
             }
-            $expiration = $item['expiration'];
+            $expiration = $item['expiration'] ?? time();
             if ($expiration === 0 || $expiration > time()) {
                 continue;
             }
diff --git a/caches/SQLiteCache.php b/caches/SQLiteCache.php
index 94f6e289..becedde4 100644
--- a/caches/SQLiteCache.php
+++ b/caches/SQLiteCache.php
@@ -37,10 +37,14 @@ class SQLiteCache implements CacheInterface
             $this->db = new \SQLite3($config['file']);
             $this->db->enableExceptions(true);
             $this->db->exec("CREATE TABLE storage ('key' BLOB PRIMARY KEY, 'value' BLOB, 'updated' INTEGER)");
+            // Consider uncommenting this to add an index on expiration
+            //$this->db->exec('CREATE INDEX idx_storage_updated ON storage (updated)');
         }
         $this->db->busyTimeout($config['timeout']);
+
         // https://www.sqlite.org/pragma.html#pragma_journal_mode
         $this->db->exec('PRAGMA journal_mode = wal');
+
         // https://www.sqlite.org/pragma.html#pragma_synchronous
         $this->db->exec('PRAGMA synchronous = NORMAL');
     }
diff --git a/contrib/prepare_release/fetch_contributors.php b/contrib/prepare_release/fetch_contributors.php
deleted file mode 100644
index dd99229f..00000000
--- a/contrib/prepare_release/fetch_contributors.php
+++ /dev/null
@@ -1,53 +0,0 @@
-<?php
-
-/* Generate the "Contributors" list for README.md automatically utilizing the GitHub API */
-
-require __DIR__ . '/../../lib/bootstrap.php';
-
-$url = 'https://api.github.com/repos/rss-bridge/rss-bridge/contributors';
-$contributors = [];
-$next = true;
-
-while ($next) { /* Collect all contributors */
-    $headers = [
-        'Accept' => 'application/json',
-        'Content-Type' => 'application/json',
-        'User-Agent' => 'RSS-Bridge',
-    ];
-    $httpClient = new CurlHttpClient();
-    $response = $httpClient->request($url, ['headers' => $headers]);
-
-    $json = $response->getBody();
-    $json_decode = Json::decode($json, false);
-    foreach ($json_decode as $contributor) {
-        $contributors[] = $contributor;
-    }
-
-    // Extract links to "next", "last", etc...
-    $link1 = $response->getHeader('link');
-    $links = explode(',', $link1);
-    $next = false;
-
-    // Check if there is a link with 'rel="next"'
-    foreach ($links as $link) {
-        [$url, $type] = explode(';', $link, 2);
-
-        if (trim($type) === 'rel="next"') {
-            $url = trim(preg_replace('/([<>])/', '', $url));
-            $next = true;
-            break;
-        }
-    }
-}
-
-/* Example JSON data: https://api.github.com/repos/rss-bridge/rss-bridge/contributors */
-
-// We want contributors sorted by name
-usort($contributors, function ($a, $b) {
-    return strcasecmp($a->login, $b->login);
-});
-
-// Export as Markdown list
-foreach ($contributors as $contributor) {
-    echo "  * [{$contributor->login}]({$contributor->html_url})\n";
-}
diff --git a/contrib/prepare_release/rssbridge-log-helper.el b/contrib/prepare_release/rssbridge-log-helper.el
deleted file mode 100644
index a4b28226..00000000
--- a/contrib/prepare_release/rssbridge-log-helper.el
+++ /dev/null
@@ -1,151 +0,0 @@
-;;; rssbridge-log-helper.el --- A helper for preparing RSS-Bridge releases  -*- lexical-binding:t; coding:utf-8 -*-
-
-;;; Commentary:
-
-;; Keyboard abbreviations used below:
-;; C-x == Ctrl + x
-;; M-x == Alt + x
-
-;; How to use this helper?
-;; 1. Run "git log --reverse 2021-04-25..master > tmp.md" (2021-04-25 is an example tag of a previous version)
-;; 2. Copy the contents of template.md to the start of tmp.md
-;; 3. Open Emacs. Type M-x load-file <ENTER>
-;; 4. Enter in the path to rssbridge-log-helper.el then <ENTER>
-;; 5. Type M-x find-file <ENTER>
-;; 6. Enter the path to tmp.md then <ENTER>
-;; 7. Type M-x rssbridge-log-transient-state <ENTER>
-;; 8. You can now use the following shortcuts to organize the commits:
-;;      x: Delete commit
-;;      g: Copy as general change
-;;      n: Copy as new bridge
-;;      m: Copy as modified bridge
-;;      r: Copy as removed bridge
-;;      <any key>: Quit
-;; 9. Once you are done with all the commits, type C-x then C-s
-;; 10. Exit Emacs with C-x then C-c
-
-;;; Code:
-
-(defun rssbridge-log--get-commit-block ()
-  "Select a commit block that begins before the cursor."
-  (re-search-backward "^commit ") ;;  (move-beginning-of-line nil)
-  (set-mark-command nil)
-  (right-char)
-  (re-search-forward "^commit ")
-  (move-end-of-line 1))
-
-(defun rssbridge-log--goto-first-commit ()
-  "Find the first commit in the file."
-  (goto-char (point-min))
-  (re-search-forward "^commit "))
-
-(defun rssbridge-log--remove-until-prev-commit-block ()
-  "Remove from start of current line to previous commit block."
-  (move-beginning-of-line nil)
-  (set-mark-command nil)
-  (re-search-backward "^commit ")
-  (delete-region (region-beginning) (region-end)))
-
-(defun rssbridge-log--remove-until-next-commit-block ()
-  "Remove from start of current line to next commit block."
-  (move-beginning-of-line nil)
-  (set-mark-command nil)
-  (re-search-forward "^commit ")
-  (move-beginning-of-line nil)
-  (delete-region (region-beginning) (region-end)))
-
-(defun rssbridge-log--cut-paste (arg)
-  "Copy current line to header that matches ARG."
-  (kill-whole-line 0)
-  (rssbridge-log--remove-until-next-commit-block)
-  (goto-char (point-min))
-  (re-search-forward arg)
-  (move-end-of-line 1)
-  (newline)
-  (yank)
-  (set-mark-command 1)
-  (re-search-forward "^commit ")
-  (recenter))
-
-(defun rssbridge-log-remove ()
-  "Remove the current commit block.
-
-You can bind this function or use `rssbridge-log-transient-state'
-to access the function."
-  (interactive)
-  (rssbridge-log--get-commit-block)
-  (rssbridge-log--remove-until-prev-commit-block)
-  (set-mark-command 1)
-  (re-search-forward "^commit "))
-
-(defun rssbridge-log-copy-as-new ()
-  "Copy the current commit block as a new bridge.
-
-You can bind this function or use `rssbridge-log-transient-state'
-to access the function."
-  (interactive)
-  (rssbridge-log--get-commit-block)
-  (re-search-backward "^.*\\[\\(.*\\)\\].*\\((.*)\\)" (region-beginning))
-  (replace-match "* \\1 () \\2")
-  (rssbridge-log--remove-until-prev-commit-block)
-  (rssbridge-log--cut-paste "## New bridges"))
-
-(defun rssbridge-log-copy-as-mod ()
-  "Copy the current commit block as a modified bridge.
-
-You can bind this function or use `rssbridge-log-transient-state'
-to access the function."
-  (interactive)
-  (rssbridge-log--get-commit-block)
-  (re-search-backward "^.*\\[\\(.*\\)\\]" (region-beginning))
-  (replace-match "* \\1:")
-  (rssbridge-log--remove-until-prev-commit-block)
-  (rssbridge-log--cut-paste "## Modified bridges"))
-
-(defun rssbridge-log-copy-as-gen ()
-  "Copy the current commit block as a general change.
-
-You can bind this function or use `rssbridge-log-transient-state'
-to access the function."
-  (interactive)
-  (rssbridge-log--get-commit-block)
-  (re-search-backward "^.*\\[\\(.*\\)\\]" (region-beginning))
-  (replace-match "* \\1:")
-  (rssbridge-log--remove-until-prev-commit-block)
-  (rssbridge-log--cut-paste "## General changes"))
-
-(defun rssbridge-log-copy-as-rem ()
-  "Copy the current commit block as a removed bridge.
-
-You can bind this function or use `rssbridge-log-transient-state'
-to access the function."
-  (interactive)
-  (rssbridge-log--get-commit-block)
-  (re-search-backward "^.*\\[\\(.*\\)\\]" (region-beginning))
-  (replace-match "* \\1:")
-  (rssbridge-log--remove-until-prev-commit-block)
-  (rssbridge-log--cut-paste "## Removed bridges"))
-
-
-(defun rssbridge-log-transient-state ()
-  "Create a transient map for convienience.
-x: Delete commit
-g: Copy as general change
-n: Copy as new bridge
-m: Copy as modified bridge
-r: Copy as removed bridge
-<any key>: Quit"
-  (interactive)
-  (rssbridge-log--goto-first-commit)
-  (set-transient-map
-   (let ((map (make-sparse-keymap)))
-     (define-key map "x" 'rssbridge-log-remove)
-     (define-key map "g" 'rssbridge-log-copy-as-gen)
-     (define-key map "n" 'rssbridge-log-copy-as-new)
-     (define-key map "m" 'rssbridge-log-copy-as-mod)
-     (define-key map "r" 'rssbridge-log-copy-as-rem)
-     map)
-   t))
-
-(provide 'rssbridge-log-helper)
-;;; rssbridge-log-helper.el ends here
diff --git a/contrib/prepare_release/template.md b/contrib/prepare_release/template.md
deleted file mode 100644
index 7314113d..00000000
--- a/contrib/prepare_release/template.md
+++ /dev/null
@@ -1,23 +0,0 @@
-<!-- Checklist (hidden in release)
-
-- [ ] List all changes
-- [ ] Update list of contributors (see README.md)
-- [ ] Update release date in Configuration.php
-- [ ] Set tag version to current date (YYYY-mm-dd)
-- [ ] Change release title to current date (RSS-Bridge YYYY-mm-dd)
-
--->
-
-## General changes
-
-
-## New bridges
-
-
-## Modified bridges
-
-
-## Removed bridges
-
-
-<!-- Template: No bridges were removed in this release! -->
diff --git a/lib/Configuration.php b/lib/Configuration.php
index 7ef97fa7..c38d7cc9 100644
--- a/lib/Configuration.php
+++ b/lib/Configuration.php
@@ -19,7 +19,7 @@
  */
 final class Configuration
 {
-    private const VERSION = 'dev.2023-07-11';
+    private const VERSION = '2023-09-24';
 
     private static $config = [];
 
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index da093cab..6ba952eb 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -30,6 +30,8 @@ final class RssBridge
             if ((error_reporting() & $code) === 0) {
                 return false;
             }
+            // In the future, uncomment this:
+            //throw new \ErrorException($message, 0, $code, $file, $line);
             $text = sprintf(
                 '%s at %s line %s',
                 sanitize_root($message),
diff --git a/templates/frontpage.html.php b/templates/frontpage.html.php
index 99e2ffd9..a0d274da 100644
--- a/templates/frontpage.html.php
+++ b/templates/frontpage.html.php
@@ -29,8 +29,16 @@
 <?= raw($bridges) ?>
 
 <section class="footer">
-    <a href="https://github.com/rss-bridge/rss-bridge">RSS-Bridge ~ Public Domain</a><br>
-    <p class="version"><?= e(Configuration::getVersion()) ?></p>
+    <a href="https://github.com/RSS-Bridge/rss-bridge">
+        https://github.com/RSS-Bridge/rss-bridge
+    </a>
+
+    <br>
+    <br>
+
+    <p class="version">
+        <?= e(Configuration::getVersion()) ?>
+    </p>
 
     <?= $active_bridges ?>/<?= $total_bridges ?> active bridges.<br>
 

From 09f3c1532adc20c5850e3f0751c24d2b402386d0 Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Sun, 24 Sep 2023 21:13:01 +0200
Subject: [PATCH 131/716] [core] improve pull request artifacts comment (#3705)

---
 .github/prtester.py | 240 ++++++++++++++++++++++++++------------------
 1 file changed, 143 insertions(+), 97 deletions(-)

diff --git a/.github/prtester.py b/.github/prtester.py
index df6cc1ff..a2a7ab84 100644
--- a/.github/prtester.py
+++ b/.github/prtester.py
@@ -1,113 +1,159 @@
+import argparse
 import requests
-import itertools
 from bs4 import BeautifulSoup
 from datetime import datetime
+from typing import Iterable
 import os.path
 
 # This script is specifically written to be used in automation for https://github.com/RSS-Bridge/rss-bridge
 #
 # This will scrape the whitelisted bridges in the current state (port 3000) and the PR state (port 3001) of
 # RSS-Bridge, generate a feed for each of the bridges and save the output as html files.
-# It also replaces the default static CSS link with a hardcoded link to @em92's public instance, so viewing
+# It also add a <base> tag with the url of em's public instance, so viewing
 # the HTML file locally will actually work as designed.
 
-def testBridges(bridges,status):
-    for bridge in bridges:
-        if bridge.get('data-ref'): # Some div entries are empty, this ignores those
-            bridgeid = bridge.get('id')
-            bridgeid = bridgeid.split('-')[1] # this extracts a readable bridge name from the bridge metadata
-            print(bridgeid + "\n")
-            bridgestring = '/?action=display&bridge=' + bridgeid + '&format=Html'
-            forms = bridge.find_all("form")
-            formid = 1
-            for form in forms:
-                # a bridge can have multiple contexts, named 'forms' in html
-                # this code will produce a fully working formstring that should create a working feed when called
-                # this will create an example feed for every single context, to test them all
-                formstring = ''
-                errormessages = []
-                parameters = form.find_all("input")
-                lists = form.find_all("select")
-                # this for/if mess cycles through all available input parameters, checks if it required, then pulls
-                # the default or examplevalue and then combines it all together into the formstring
-                # if an example or default value is missing for a required attribute, it will throw an error
-                # any non-required fields are not tested!!!
-                for parameter in parameters:
-                    if parameter.get('type') == 'hidden' and parameter.get('name') == 'context':
-                        cleanvalue = parameter.get('value').replace(" ","+")
-                        formstring = formstring + '&' + parameter.get('name') + '=' + cleanvalue
-                    if parameter.get('type') == 'number' or parameter.get('type') == 'text':
-                        if parameter.has_attr('required'):
-                            if parameter.get('placeholder') == '':
-                                if parameter.get('value') == '':
-                                    errormessages.append(parameter.get('name'))
-                                else:
-                                    formstring = formstring + '&' + parameter.get('name') + '=' + parameter.get('value')
+class Instance:
+    name = ''
+    url = ''
+
+def main(instances: Iterable[Instance], with_upload: bool, comment_title: str):
+    start_date = datetime.now()
+    table_rows = []
+    for instance in instances:
+        page = requests.get(instance.url) # Use python requests to grab the rss-bridge main page
+        soup = BeautifulSoup(page.content, "html.parser") # use bs4 to turn the page into soup
+        bridge_cards = soup.select('.bridge-card') # get a soup-formatted list of all bridges on the rss-bridge page
+        table_rows += testBridges(instance, bridge_cards, with_upload) # run the main scraping code with the list of bridges and the info if this is for the current version or the pr version
+    with open(file=os.getcwd() + '/comment.txt', mode='w+', encoding='utf-8') as file:
+        table_rows_value = '\n'.join(sorted(table_rows))
+        file.write(f'''
+## {comment_title}
+| Bridge | Context | Status |
+| - | - | - |
+{table_rows_value}
+
+*last change: {start_date.strftime("%A %Y-%m-%d %H:%M:%S")}*
+        '''.strip())
+
+def testBridges(instance: Instance, bridge_cards: Iterable, with_upload: bool) -> Iterable:
+    instance_suffix = ''
+    if instance.name:
+        instance_suffix = f' ({instance.name})'
+    table_rows = []
+    for bridge_card in bridge_cards:
+        bridgeid = bridge_card.get('id')
+        bridgeid = bridgeid.split('-')[1] # this extracts a readable bridge name from the bridge metadata
+        print(f'{bridgeid}{instance_suffix}\n')
+        bridgestring = '/?action=display&bridge=' + bridgeid + '&format=Html'
+        bridge_name = bridgeid.replace('Bridge', '')
+        context_forms = bridge_card.find_all("form")
+        form_number = 1
+        for context_form in context_forms:
+            # a bridge can have multiple contexts, named 'forms' in html
+            # this code will produce a fully working formstring that should create a working feed when called
+            # this will create an example feed for every single context, to test them all
+            formstring = ''
+            error_messages = []
+            context_name = '*untitled*'
+            context_name_element = context_form.find_previous_sibling('h5')
+            if context_name_element and context_name_element.text.strip() != '':
+                context_name = context_name_element.text
+            parameters = context_form.find_all("input")
+            lists = context_form.find_all("select")
+            # this for/if mess cycles through all available input parameters, checks if it required, then pulls
+            # the default or examplevalue and then combines it all together into the formstring
+            # if an example or default value is missing for a required attribute, it will throw an error
+            # any non-required fields are not tested!!!
+            for parameter in parameters:
+                if parameter.get('type') == 'hidden' and parameter.get('name') == 'context':
+                    cleanvalue = parameter.get('value').replace(" ","+")
+                    formstring = formstring + '&' + parameter.get('name') + '=' + cleanvalue
+                if parameter.get('type') == 'number' or parameter.get('type') == 'text':
+                    if parameter.has_attr('required'):
+                        if parameter.get('placeholder') == '':
+                            if parameter.get('value') == '':
+                                name_value = parameter.get('name')
+                                error_messages.append(f'Missing example or default value for parameter "{name_value}"')
                             else:
-                                formstring = formstring + '&' + parameter.get('name') + '=' + parameter.get('placeholder')
-                    # same thing, just for checkboxes. If a checkbox is checked per default, it gets added to the formstring
-                    if parameter.get('type') == 'checkbox':
-                        if parameter.has_attr('checked'):
-                            formstring = formstring + '&' + parameter.get('name') + '=on'
-                for listing in lists:
-                    selectionvalue = ''
-                    listname = listing.get('name')
-                    cleanlist = []
-                    for option in listing.contents:
-                        if 'optgroup' in option.name:
-                            cleanlist.extend(option)
+                                formstring = formstring + '&' + parameter.get('name') + '=' + parameter.get('value')
                         else:
-                            cleanlist.append(option)
-                    firstselectionentry = 1
-                    for selectionentry in cleanlist:
-                        if firstselectionentry:
+                            formstring = formstring + '&' + parameter.get('name') + '=' + parameter.get('placeholder')
+                # same thing, just for checkboxes. If a checkbox is checked per default, it gets added to the formstring
+                if parameter.get('type') == 'checkbox':
+                    if parameter.has_attr('checked'):
+                        formstring = formstring + '&' + parameter.get('name') + '=on'
+            for listing in lists:
+                selectionvalue = ''
+                listname = listing.get('name')
+                cleanlist = []
+                for option in listing.contents:
+                    if 'optgroup' in option.name:
+                        cleanlist.extend(option)
+                    else:
+                        cleanlist.append(option)
+                firstselectionentry = 1
+                for selectionentry in cleanlist:
+                    if firstselectionentry:
+                        selectionvalue = selectionentry.get('value')
+                        firstselectionentry = 0
+                    else:
+                        if 'selected' in selectionentry.attrs:
                             selectionvalue = selectionentry.get('value')
-                            firstselectionentry = 0
-                        else:
-                            if 'selected' in selectionentry.attrs:
-                                selectionvalue = selectionentry.get('value')
-                                break
-                    formstring = formstring + '&' + listname + '=' + selectionvalue
-                if not errormessages:
-                    # if all example/default values are present, form the full request string, run the request, replace the static css
-                    # file with the url of em's public instance and then upload it to termpad.com, a pastebin-like-site.
-                    r = requests.get(URL + bridgestring + formstring)
-                    pagetext = r.text.replace('static/style.css','https://rss-bridge.org/bridge01/static/style.css')
-                    pagetext = pagetext.encode("utf_8")
-                    termpad = requests.post(url="https://termpad.com/", data=pagetext)
-                    termpadurl = termpad.text
-                    termpadurl = termpadurl.replace('termpad.com/','termpad.com/raw/')
-                    termpadurl = termpadurl.replace('\n','')
-                    with open(os.getcwd() + '/comment.txt', 'a+') as file:
-                        file.write("\n")
-                        file.write("| [`" + bridgeid + '-' + status + '-context' + str(formid) + "`](" + termpadurl + ") | " + date_time + " |")
+                            break
+                formstring = formstring + '&' + listname + '=' + selectionvalue
+            termpad_url = 'about:blank'
+            if error_messages:
+                status = '<br>'.join(map(lambda m: f'❌ `{m}`', error_messages))
+            else:
+                # if all example/default values are present, form the full request string, run the request, add a <base> tag with
+                # the url of em's public instance to the response text (so that relative paths work, e.g. to the static css file) and
+                # then upload it to termpad.com, a pastebin-like-site.
+                response = requests.get(instance.url + bridgestring + formstring)
+                page_text = response.text.replace('<head>','<head><base href="https://rss-bridge.org/bridge01/" target="_blank">')
+                page_text = page_text.encode("utf_8")
+                soup = BeautifulSoup(page_text, "html.parser")
+                status_messages = list(map(lambda e: f'⚠️ `{e.text.strip().splitlines()[0]}`', soup.find_all('pre')))
+                if response.status_code != 200:
+                    status_messages = [f'❌ `HTTP status {response.status_code} {response.reason}`'] + status_messages
                 else:
-                    # if there are errors (which means that a required value has no example or default value), log out which error appeared
-                    termpad = requests.post(url="https://termpad.com/", data=str(errormessages))
-                    termpadurl = termpad.text
-                    termpadurl = termpadurl.replace('termpad.com/','termpad.com/raw/')
-                    termpadurl = termpadurl.replace('\n','')
-                    with open(os.getcwd() + '/comment.txt', 'a+') as file:
-                        file.write("\n")
-                        file.write("| [`" + bridgeid + '-' + status + '-context' + str(formid) + "`](" + termpadurl + ") | " + date_time + " |")
-                formid += 1
+                    feed_items = soup.select('.feeditem')
+                    feed_items_length = len(feed_items)
+                    if feed_items_length <= 0:
+                        status_messages += [f'⚠️ `The feed has no items`']
+                    elif feed_items_length == 1 and len(soup.select('.error')) > 0:
+                        status_messages = [f'❌ `{feed_items[0].text.strip().splitlines()[0]}`'] + status_messages
+                status = '<br>'.join(status_messages)
+                if status.strip() == '':
+                    status = '✔️'
+                if with_upload:
+                    termpad = requests.post(url="https://termpad.com/", data=page_text)
+                    termpad_url = termpad.text.strip()
+                    termpad_url = termpad_url.replace('termpad.com/','termpad.com/raw/')
+            table_rows.append(f'| {bridge_name} | [{form_number} {context_name}{instance_suffix}]({termpad_url}) | {status} |')
+            form_number += 1
+    return table_rows
 
-gitstatus = ["current", "pr"]
-now = datetime.now()
-date_time = now.strftime("%Y-%m-%d, %H:%M:%S")
-
-with open(os.getcwd() + '/comment.txt', 'w+') as file:
-    file.write(''' ## Pull request artifacts
-| file | last change |
-| ---- | ------ |''')
-
-for status in gitstatus: # run this twice, once for the current version, once for the PR version
-    if status == "current":
-        port = "3000" # both ports are defined in the corresponding workflow .yml file
-    elif status == "pr":
-        port = "3001"
-    URL = "http://localhost:" + port
-    page = requests.get(URL) # Use python requests to grab the rss-bridge main page
-    soup = BeautifulSoup(page.content, "html.parser") # use bs4 to turn the page into soup
-    bridges = soup.find_all("section") # get a soup-formatted list of all bridges on the rss-bridge page
-    testBridges(bridges,status) # run the main scraping code with the list of bridges and the info if this is for the current version or the pr version
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser()
+    parser.add_argument('-i', '--instances', nargs='+')
+    parser.add_argument('-nu', '--no-upload', action='store_true')
+    parser.add_argument('-t', '--comment-title', default='Pull request artifacts')
+    args = parser.parse_args()
+    instances = []
+    if args.instances:
+        for instance_arg in args.instances:
+            instance_arg_parts = instance_arg.split('::')
+            instance = Instance()
+            instance.name = instance_arg_parts[1] if len(instance_arg_parts) >= 2 else ''
+            instance.url = instance_arg_parts[0]
+            instances.append(instance)
+    else:
+        instance = Instance()
+        instance.name = 'current'
+        instance.url = 'http://localhost:3000'
+        instances.append(instance)
+        instance = Instance()
+        instance.name = 'pr'
+        instance.url = 'http://localhost:3001'
+        instances.append(instance)
+    main(instances=instances, with_upload=not args.no_upload, comment_title=args.comment_title);
\ No newline at end of file

From e1b911fc1f3416d49c5ad5cc68587f64ab8890eb Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Sun, 24 Sep 2023 23:07:43 +0200
Subject: [PATCH 132/716] [CssSelectorBridge] Retrieve metadata for social
 media embeds (#3602, #3687) (#3706)

* [CssSelectorBridge] Metadata from social embed (#3602, #3687)

Implement the following metadata sources:
 - Facebook Open Graph
 - Twitter <meta> tags
 - Standard <meta> tags
 - JSON linked data (ld+json)

The following metadata is supported:
 - Canonical URL (may help removing garbage from URLs)
 - Article title
 - Truncated summary
 - Published/Updated timestamp
 - Enclosure/Thumbnail image
 - Author Name or Twitter handle

SitemapBridge will also automatically benefit from this commit.

* [php8backports] Add array_is_list()

Needed this function for ld+json implementation in CssSelectorBridge.

* [SitemapBridge] Add option to discard thumbnail

* [CssSelectorBridge] Fix linting issues
---
 bridges/CssSelectorBridge.php | 283 ++++++++++++++++++++++++++++++++--
 bridges/SitemapBridge.php     |  12 +-
 lib/php8backports.php         |  10 ++
 3 files changed, 290 insertions(+), 15 deletions(-)

diff --git a/bridges/CssSelectorBridge.php b/bridges/CssSelectorBridge.php
index 8408633b..c5a09822 100644
--- a/bridges/CssSelectorBridge.php
+++ b/bridges/CssSelectorBridge.php
@@ -51,6 +51,11 @@ class CssSelectorBridge extends BridgeAbstract
                     EOT,
                 'exampleValue' => ' | BlogName',
             ],
+            'discard_thumbnail' => [
+                'name' => '[Optional] Discard thumbnail set by site author',
+                'title' => 'Some sites set their logo as thumbnail for every article. Use this option to discard it.',
+                'type' => 'checkbox',
+            ],
             'limit' => self::LIMIT
         ]
     ];
@@ -82,6 +87,7 @@ class CssSelectorBridge extends BridgeAbstract
         $content_selector = $this->getInput('content_selector');
         $content_cleanup = $this->getInput('content_cleanup');
         $title_cleanup = $this->getInput('title_cleanup');
+        $discard_thumbnail = $this->getInput('discard_thumbnail');
         $limit = $this->getInput('limit') ?? 10;
 
         $html = defaultLinkTo(getSimpleHTMLDOM($url), $url);
@@ -92,13 +98,17 @@ class CssSelectorBridge extends BridgeAbstract
             $this->items = $items;
         } else {
             foreach ($items as $item) {
-                $this->items[] = $this->expandEntryWithSelector(
+                $item = $this->expandEntryWithSelector(
                     $item['uri'],
                     $content_selector,
                     $content_cleanup,
                     $title_cleanup,
                     $item['title']
                 );
+                if ($discard_thumbnail && isset($item['enclosures'])) {
+                    unset($item['enclosures']);
+                }
+                $this->items[] = $item;
             }
         }
     }
@@ -246,27 +256,272 @@ class CssSelectorBridge extends BridgeAbstract
         }
 
         $entry_html = getSimpleHTMLDOMCached($entry_url);
+        $item = $this->entryHtmlRetrieveMetadata($entry_html);
+
+        if (empty($item['uri'])) {
+            $item['uri'] = $entry_url;
+        }
+
+        if (empty($item['title'])) {
+            $article_title = $this->getPageTitle($entry_html, $title_cleanup);
+            if (!empty($title_default) && (empty($article_title) || $article_title === $this->feedName)) {
+                $article_title = $title_default;
+            }
+            $item['title'] = $article_title;
+        }
+
         $article_content = $entry_html->find($content_selector);
 
         if (!empty($article_content)) {
             $article_content = $article_content[0];
-        } else {
-            returnClientError('Could not find content selector at URL: ' . $entry_url);
+            $article_content = convertLazyLoading($article_content);
+            $article_content = defaultLinkTo($article_content, $entry_url);
+            $article_content = $this->cleanArticleContent($article_content, $content_cleanup);
+            $item['content'] = $article_content;
+        } else if (!empty($item['content'])) {
+            $item['content'] .= '<br /><p><em>Could not extract full content, selector may need to be updated.</em></p>';
         }
 
-        $article_content = convertLazyLoading($article_content);
-        $article_content = defaultLinkTo($article_content, $entry_url);
-        $article_content = $this->cleanArticleContent($article_content, $content_cleanup);
-
-        $article_title = $this->getPageTitle($entry_html, $title_cleanup);
-        if (!empty($title_default) && (empty($article_title) || $article_title === $this->feedName)) {
-            $article_title = $title_default;
-        }
+        return $item;
+    }
 
+    /**
+     * Retrieve metadata from entry HTML: title, author, date published, etc. from metadata intended for social media embeds and SEO
+     * @param obj $entry_html DOM object representing the webpage HTML
+     * @return array Entry data collected from Metadata
+     */
+    protected function entryHtmlRetrieveMetadata($entry_html)
+    {
         $item = [];
-        $item['uri'] = $entry_url;
-        $item['title'] = $article_title;
-        $item['content'] = $article_content;
+
+        // == First source of metadata: Meta tags ==
+        // Facebook Open Graph (og:KEY) - https://developers.facebook.com/docs/sharing/webmasters
+        // Twitter (twitter:KEY) - https://developer.twitter.com/en/docs/twitter-for-websites/cards/guides/getting-started
+        // Standard meta tags - https://www.w3schools.com/tags/tag_meta.asp
+
+        // Each Entry field mapping defines a list of possible <meta> tags names that contains the expected value
+        static $meta_mappings = [
+            // <meta property="article:KEY" content="VALUE" />
+            // <meta property="og:KEY" content="VALUE" />
+            // <meta property="KEY" content="VALUE" />
+            // <meta name="twitter:KEY" content="VALUE" />
+            // <meta name="KEY" content="VALUE">
+            // <link rel="canonical" href="URL" />
+            'uri' => [
+                'og:url',
+                'twitter:url',
+                'canonical'
+            ],
+            'title' => [
+                'og:title',
+                'twitter:title'
+            ],
+            'content' => [
+                'og:description',
+                'twitter:description',
+                'description'
+            ],
+            'timestamp' => [
+                'article:published_time',
+                'releaseDate',
+                'releasedate',
+                'article:modified_time',
+                'lastModified',
+                'lastmodified'
+            ],
+            'enclosures' => [
+                'og:image:secure_url',
+                'og:image:url',
+                'og:image',
+                'twitter:image',
+                'thumbnailImg',
+                'thumbnailimg'
+            ],
+            'author' => [
+                'author',
+                'article:author',
+                'article:author:username',
+                'profile:first_name',
+                'profile:last_name',
+                'article:author:first_name',
+                'article:author:last_name',
+                'twitter:creator',
+            ],
+        ];
+
+        $author_first_name = null;
+        $author_last_name = null;
+
+        // For each Entry property, look for corresponding HTML tags using a list of candidates
+        foreach ($meta_mappings as $property => $field_list) {
+            foreach ($field_list as $field) {
+                // Look for HTML meta tag
+                $element = null;
+                if ($field === 'canonical') {
+                    $element = $entry_html->find('link[rel=canonical]');
+                } else {
+                    $element = $entry_html->find("meta[property=$field], meta[name=$field]");
+                }
+                // Found something? Extract the value and populate Entry field
+                if (!empty($element)) {
+                    $element = $element[0];
+                    $field_value = '';
+                    if ($field === 'canonical') {
+                        $field_value = $element->href;
+                    } else {
+                        $field_value = $element->content;
+                    }
+                    if (!empty($field_value)) {
+                        if ($field === 'article:author:first_name' || $field === 'profile:first_name') {
+                            $author_first_name = $field_value;
+                        } else if ($field === 'article:author:last_name' || $field === 'profile:last_name') {
+                            $author_last_name = $field_value;
+                        } else {
+                            $item[$property] = $field_value;
+                            break; // Stop on first match, e.g. og:url has priority over canonical url.
+                        }
+                    }
+                }
+            }
+        }
+
+        // Populate author from first name and last name if all we have is nothing or Twitter @username
+        if ((!isset($item['author']) || $item['author'][0] === '@') && (is_string($author_first_name) || is_string($author_last_name))) {
+            $author = '';
+            if (is_string($author_first_name)) {
+                $author = $author_first_name;
+            }
+            if (is_string($author_last_name)) {
+                $author = $author . ' ' . $author_last_name;
+            }
+            $item['author'] = trim($author);
+        }
+
+        // == Second source of metadata: Embedded JSON ==
+        // JSON linked data - https://www.w3.org/TR/2014/REC-json-ld-20140116/
+        // JSON linked data is COMPLEX and MAY BE LESS RELIABLE than <meta> tags. Used for fields not found as <meta> tags.
+        // The implementation below will load all ld+json we can understand and attempt to extract relevant information.
+
+        // ld+json object types that hold article metadata
+        // Each mapping define item fields and a list of possible JSON field for this field
+        // Each candiate JSON field is either a string (field name) or a list (path to nested field)
+        static $ldjson_article_types = ['webpage', 'article', 'newsarticle', 'blogposting'];
+        static $ldjson_article_mappings = [
+            'uri' => ['url', 'mainEntityOfPage'],
+            'title' => ['headline'],
+            'content' => ['description'],
+            'timestamp' => ['dateModified', 'datePublished'],
+            'enclosures' => ['image'],
+            'author' => [['author', 'name'], ['author', '@id'], 'author'],
+        ];
+
+        // ld+json object types that hold author metadata
+        $ldjson_author_types = ['person', 'organization'];
+        $ldjson_author_mappings = []; // ID => Name
+        $ldjson_author_id = null;
+
+        // Utility function for checking if JSON array matches one of the desired ld+json object types
+        // A JSON object may have a single ld+json @type as a string OR several types at once as a list
+        $ldjson_is_of_type = function ($json, $allowed_types) {
+            if (isset($json['@type'])) {
+                $json_types = $json['@type'];
+                if (!is_array($json_types)) {
+                    $json_types = [ $json_types ];
+                }
+                foreach ($json_types as $item_type) {
+                    if (in_array(strtolower($item_type), $allowed_types)) {
+                        return true;
+                    }
+                }
+            }
+            return false;
+        };
+
+        // Process ld+json objects embedded in the HTML DOM
+        foreach ($entry_html->find('script[type=application/ld+json]') as $html_ldjson_node) {
+            $json_raw = json_decode($html_ldjson_node->innertext, true);
+            if (is_array($json_raw)) {
+                // The JSON we just loaded may contain directly a single ld+json object AND/OR several ones under the '@graph' key
+                $json_items = [ $json_raw ];
+                if (isset($json_raw['@graph'])) {
+                    foreach ($json_raw['@graph'] as $json_raw_sub_item) {
+                        $json_items[] = $json_raw_sub_item;
+                    }
+                }
+                // Now that we have a list of distinct JSON items, we can process them individually
+                foreach ($json_items as $json) {
+                    // JSON item that holds an ld+json Article object (or a variant)
+                    if ($ldjson_is_of_type($json, $ldjson_article_types)) {
+                        // For each item property, look for corresponding JSON fields and populate the item
+                        foreach ($ldjson_article_mappings as $property => $field_list) {
+                            // Skip fields already found as <meta> tags, except Twitter @username (because we might find a better name)
+                            if (!isset($item[$property]) || ($property === 'author' && $item['author'][0] === '@')) {
+                                foreach ($field_list as $field) {
+                                    $json_root = $json;
+                                    // If necessary, navigate inside the JSON object to access a nested field
+                                    if (is_array($field)) {
+                                        // At this point, $field = ['author', 'name'] and $json_root = {"author": {"name": "John Doe"}}
+                                        $json_navigate_ok = true;
+                                        while (count($field) > 1) {
+                                            $sub_field = array_shift($field);
+                                            if (array_key_exists($sub_field, $json_root)) {
+                                                $json_root = $json_root[$sub_field];
+                                                if (array_is_list($json_root) && count($json_root) === 1) {
+                                                    $json_root = $json_root[0]; // Unwrap list of single item e.g. {"author":[{"name":"John Doe"}]}
+                                                }
+                                            } else {
+                                                // Desired path not found in JSON, stop navigating
+                                                $json_navigate_ok = false;
+                                                break;
+                                            }
+                                        }
+                                        if (!$json_navigate_ok) {
+                                            continue; //Desired path not found in JSON, skip this field
+                                        }
+                                        $field = $field[0];
+                                        // At this point, $field = "name" and $json_root = {"name": "John Doe"}
+                                    }
+                                    // Now we can check for desired field in JSON and populate $item accordingly
+                                    if (isset($json_root[$field])) {
+                                        $field_value = $json_root[$field];
+                                        if (is_array($field_value)) {
+                                            $field_value = $field_value[0]; // Different versions of the same enclosure? Take the first one
+                                        }
+                                        if (is_string($field_value) && !empty($field_value)) {
+                                            if ($property === 'author' && $field === '@id') {
+                                                $ldjson_author_id = $field_value; // Author is referred to by its ID: We'll see later if we can resolve it
+                                            } else {
+                                                $item[$property] = $field_value;
+                                                break; // Stop on first match, e.g. {"author":{"name":"John Doe"}} has priority over {"author":"John Doe"}
+                                            }
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    // JSON item that holds an ld+json Author object (or a variant)
+                    } else if ($ldjson_is_of_type($json, $ldjson_author_types)) {
+                        if (isset($json['@id']) && isset($json['name'])) {
+                            $ldjson_author_mappings[$json['@id']] = $json['name'];
+                        }
+                    }
+                }
+            }
+        }
+
+        // Attempt to resolve ld+json author if all we have is nothing or Twitter @username
+        if ((!isset($item['author']) || $item['author'][0] === '@') && !is_null($ldjson_author_id) && isset($ldjson_author_mappings[$ldjson_author_id])) {
+            $item['author'] = $ldjson_author_mappings[$ldjson_author_id];
+        }
+
+        // Adjust item field types
+        if (isset($item['enclosures'])) {
+            $item['enclosures'] = [ $item['enclosures'] ];
+        }
+        if (isset($item['timestamp'])) {
+            $item['timestamp'] = strtotime($item['timestamp']);
+        }
+
         return $item;
     }
 }
diff --git a/bridges/SitemapBridge.php b/bridges/SitemapBridge.php
index 660504ba..482cbb66 100644
--- a/bridges/SitemapBridge.php
+++ b/bridges/SitemapBridge.php
@@ -53,6 +53,11 @@ class SitemapBridge extends CssSelectorBridge
                     EOT,
                 'exampleValue' => 'https://example.com/sitemap.xml',
             ],
+            'discard_thumbnail' => [
+                'name' => '[Optional] Discard thumbnail set by site author',
+                'title' => 'Some sites set their logo as thumbnail for every article. Use this option to discard it.',
+                'type' => 'checkbox',
+            ],
             'limit' => self::LIMIT
         ]
     ];
@@ -65,6 +70,7 @@ class SitemapBridge extends CssSelectorBridge
         $content_cleanup = $this->getInput('content_cleanup');
         $title_cleanup = $this->getInput('title_cleanup');
         $site_map = $this->getInput('site_map');
+        $discard_thumbnail = $this->getInput('discard_thumbnail');
         $limit = $this->getInput('limit');
 
         $this->feedName = $this->getPageTitle($url, $title_cleanup);
@@ -77,7 +83,11 @@ class SitemapBridge extends CssSelectorBridge
         }
 
         foreach ($links as $link) {
-            $this->items[] = $this->expandEntryWithSelector($link, $content_selector, $content_cleanup, $title_cleanup);
+            $item = $this->expandEntryWithSelector($link, $content_selector, $content_cleanup, $title_cleanup);
+            if ($discard_thumbnail && isset($item['enclosures'])) {
+                unset($item['enclosures']);
+            }
+            $this->items[] = $item;
         }
     }
 
diff --git a/lib/php8backports.php b/lib/php8backports.php
index 30dfdbd9..5b103e3d 100644
--- a/lib/php8backports.php
+++ b/lib/php8backports.php
@@ -54,3 +54,13 @@ if (!function_exists('str_contains')) {
         return $needle !== '' && mb_strpos($haystack, $needle) !== false;
     }
 }
+
+if (!function_exists('array_is_list')) {
+    function array_is_list(array $arr)
+    {
+        if ($arr === []) {
+            return true;
+        }
+        return array_keys($arr) === range(0, count($arr) - 1);
+    }
+}

From cd30c25b08dc5ecd048e54c8abbbecd72309ab5e Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Mon, 25 Sep 2023 21:18:48 +0200
Subject: [PATCH 133/716] refactor (#3708)

---
 README.md                                     |   2 +-
 actions/DisplayAction.php                     |  16 +-
 .../01_How_to_create_a_new_format.md          |  24 -
 docs/08_Format_API/02_FormatInterface.md      | 132 ----
 docs/08_Format_API/index.md                   |   9 -
 lib/ActionInterface.php                       |  21 +-
 lib/FeedItem.php                              | 742 ++++++------------
 lib/FormatAbstract.php                        | 126 +--
 lib/FormatFactory.php                         |   2 +-
 lib/FormatInterface.php                       |  77 --
 lib/bootstrap.php                             |   8 -
 lib/logger.php                                |   3 +
 tests/Formats/BaseFormatTest.php              |   2 +-
 tests/Formats/FormatImplementationTest.php    |   2 +-
 14 files changed, 282 insertions(+), 884 deletions(-)
 delete mode 100644 docs/08_Format_API/01_How_to_create_a_new_format.md
 delete mode 100644 docs/08_Format_API/02_FormatInterface.md
 delete mode 100644 docs/08_Format_API/index.md
 delete mode 100644 lib/FormatInterface.php

diff --git a/README.md b/README.md
index dee69b85..a1e5fdc7 100644
--- a/README.md
+++ b/README.md
@@ -266,7 +266,7 @@ https://alice:cat@rss-bridge.org/bridge01/?action=display&bridge=FabriceBellardB
 
 ### How to create a new output format
 
-[Create a new format](https://rss-bridge.github.io/rss-bridge/Format_API/index.html).
+See `formats/PlaintextFormat.php` for an example.
 
 ### How to run unit tests and linter
 
diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 138319fe..8c9dd057 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -93,7 +93,7 @@ class DisplayAction implements ActionInterface
         return $response;
     }
 
-    private function createResponse(array $request, BridgeAbstract $bridge, FormatInterface $format)
+    private function createResponse(array $request, BridgeAbstract $bridge, FormatAbstract $format)
     {
         $items = [];
         $infos = [];
@@ -108,15 +108,15 @@ class DisplayAction implements ActionInterface
             if (isset($items[0]) && is_array($items[0])) {
                 $feedItems = [];
                 foreach ($items as $item) {
-                    $feedItems[] = new FeedItem($item);
+                    $feedItems[] = FeedItem::fromArray($item);
                 }
                 $items = $feedItems;
             }
             $infos = [
-                'name' => $bridge->getName(),
-                'uri'  => $bridge->getURI(),
-                'donationUri'  => $bridge->getDonationURI(),
-                'icon' => $bridge->getIcon()
+                'name'          => $bridge->getName(),
+                'uri'           => $bridge->getURI(),
+                'donationUri'   => $bridge->getDonationURI(),
+                'icon'          => $bridge->getIcon()
             ];
         } catch (\Exception $e) {
             if ($e instanceof HttpException) {
@@ -167,8 +167,8 @@ class DisplayAction implements ActionInterface
 
         // Create a unique identifier every 24 hours
         $uniqueIdentifier = urlencode((int)(time() / 86400));
-        $itemTitle = sprintf('Bridge returned error %s! (%s)', $e->getCode(), $uniqueIdentifier);
-        $item->setTitle($itemTitle);
+        $title = sprintf('Bridge returned error %s! (%s)', $e->getCode(), $uniqueIdentifier);
+        $item->setTitle($title);
         $item->setURI(get_current_url());
         $item->setTimestamp(time());
 
diff --git a/docs/08_Format_API/01_How_to_create_a_new_format.md b/docs/08_Format_API/01_How_to_create_a_new_format.md
deleted file mode 100644
index f031e65b..00000000
--- a/docs/08_Format_API/01_How_to_create_a_new_format.md
+++ /dev/null
@@ -1,24 +0,0 @@
-Create a new file in the `formats/` folder (see [Folder structure](../04_For_Developers/03_Folder_structure.md)).
-
-The file must be named according to following specification:
-
-* It starts with the type
-* The file name must end with 'Format'
-* The file type must be PHP, written in small letters (seriously!) ".php"
-
-**Examples:**
-
-Type | Filename
------|---------
-Atom | AtomFormat.php
-Html | HtmlFormat.php
-
-The file must start with the PHP tags and end with an empty line. The closing tag `?>` is [omitted](http://php.net/basic-syntax.instruction-separation).
-
-Example:
-
-```PHP
-<?PHP
-    // PHP code here
-// This line is empty (just imagine it!)
-```
\ No newline at end of file
diff --git a/docs/08_Format_API/02_FormatInterface.md b/docs/08_Format_API/02_FormatInterface.md
deleted file mode 100644
index 461990a7..00000000
--- a/docs/08_Format_API/02_FormatInterface.md
+++ /dev/null
@@ -1,132 +0,0 @@
-The `FormatInterface` interface defines functions that need to be implemented by all formats:
-
-* [display](#the-display-function)
-* [stringify](#the-stringify-function)
-* [setItems](#the-setitems-function)
-* [getItems](#the-getitems-function)
-* [setCharset](#the-setcharset-function)
-* [getCharset](#the-getcharset-function)
-* [setExtraInfos](#the-setextrainfos-function)
-* [getExtraInfos](#the-getextrainfos-function)
-* [getMimeType](#the-getmimetype-function)
-
-Find a [template](#template) at the end of this file
-
-# Functions
-
-## The `stringify` function
-
-The `stringify` function returns the items received by [`setItems`](#the-setitem-function) as string.
-
-```PHP
-stringify(): string
-```
-
-## The `setItems` function
-
-The `setItems` function receives an array of items generated by the bridge and must return the object instance. Each item represents an entry in the feed. For more information refer to the [collectData](../05_Bridge_API/02_BridgeAbstract.md#collectdata) function.
-
-```PHP
-setItems(array $items): self
-```
-
-## The `getItems` function
-
-The `getItems` function returns the items previously set by the [`setItems`](#the-setitems-function) function. If no items where set previously this function returns an error.
-
-```PHP
-getItems(): array
-```
-
-## The `setCharset` function
-
-The `setCharset` function receives the character set value as string and returns the object instance.
-
-```PHP
-setCharset(string): self
-```
-
-## The `getCharset` function
-
-The `getCharset` function returns the character set value.
-
-```PHP
-getCharset(): string
-```
-
-## The `setExtraInfos` function
-
-The `setExtraInfos` function receives an array of elements with additional information to generate format outputs and must return the object instance.
-
-```PHP
-setExtraInfos(array $infos): self
-```
-
-Currently supported information are:
-
-Name | Description
------|------------
-`name` | Defines the name as generated by the bridge
-`uri` | Defines the URI of the feed as generated by the bridge
-
-## The `getExtraInfos` function
-
-The `getExtraInfos` function returns the information previously set via the [`setExtraInfos`](#the-setextrainfos-function) function.
-
-```PHP
-getExtraInfos(): array
-```
-
-## The `getMimeType` function
-
-The `getMimeType` function returns the expected [MIME type](https://en.wikipedia.org/wiki/Media_type#Common_examples) of the format's output.
-
-```PHP
-parse_mime_type(): string
-```
-
-# Template
-
-This is a bare minimum template for a format:
-
-```PHP
-<?php
-class MyTypeFormat implements FormatInterface {
-    private $items;
-    private $charset;
-    private $extraInfos;
-
-    public function stringify(){
-        // Implement your code here
-        return ''; // Return items as string
-    }
-
-    public function setItems(array $items){
-        $this->items = $items;
-        return $this;
-    }
-
-    public function getItems(){
-        return $this->items;
-    }
-
-    public function setCharset($charset){
-        $this->charset = $charset;
-        return $this;
-    }
-
-    public function getCharset(){
-        return $this->charset;
-    }
-
-    public function setExtraInfos(array $infos){
-        $this->extraInfos = $infos;
-        return $this;
-    }
-
-    public function getExtraInfos(){
-        return $this->extraInfos;
-    }
-}
-// Imaginary empty line!
-```
diff --git a/docs/08_Format_API/index.md b/docs/08_Format_API/index.md
deleted file mode 100644
index c5b9e6af..00000000
--- a/docs/08_Format_API/index.md
+++ /dev/null
@@ -1,9 +0,0 @@
-A Format is a class that allows RSS-Bridge to turn items from a bridge into an RSS-feed format.
-It is developed in a PHP file located in the `formats/` folder
-[Folder structure](../04_For_Developers/03_Folder_structure.md)
-and either implements the
-[FormatInterface](../08_Format_API/02_FormatInterface.md)
-interface or extends the FormatAbstract class.
-
-For more information about how to create a new _Format_, read
-[How to create a new Format?](./01_How_to_create_a_new_format.md)
\ No newline at end of file
diff --git a/lib/ActionInterface.php b/lib/ActionInterface.php
index 4eb9cc65..220dfa50 100644
--- a/lib/ActionInterface.php
+++ b/lib/ActionInterface.php
@@ -1,28 +1,9 @@
 <?php
 
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
-/**
- * Interface for action objects.
- */
 interface ActionInterface
 {
     /**
-     * Execute the action.
-     *
-     * Note: This function directly outputs data to the user.
-     *
-     * @return ?string
+     * @return string|Response
      */
     public function execute(array $request);
 }
diff --git a/lib/FeedItem.php b/lib/FeedItem.php
index 3d1b4509..4915c1b9 100644
--- a/lib/FeedItem.php
+++ b/lib/FeedItem.php
@@ -1,511 +1,30 @@
 <?php
 
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
-/**
- * Represents a simple feed item for transformation into various feed formats.
- *
- * This class represents a feed item. A feed item is an entity that can be
- * transformed into various feed formats. It holds a set of pre-defined
- * properties:
- *
- * - **URI**: URI to the full article (i.e. "https://...")
- * - **Title**: The title
- * - **Timestamp**: A timestamp of when the item was first released
- * - **Author**: Name of the author
- * - **Content**: Body of the feed, as text or HTML
- * - **Enclosures**: A list of links to media objects (images, videos, etc...)
- * - **Categories**: A list of category names or tags to categorize the item
- *
- * _Note_: A feed item can have any number of additional parameters, all of which
- * may or may not be transformed to the selected output format.
- *
- * _Remarks_: This class supports legacy items via {@see FeedItem::__construct()}
- * (i.e. `$feedItem = \FeedItem($item);`). Support for legacy items may be removed
- * in future versions of RSS-Bridge.
- */
 class FeedItem
 {
-    /** @var string|null URI to the full article */
-    protected $uri = null;
+    protected ?string $uri = null;
+    protected ?string $title = null;
+    protected ?int $timestamp = null;
+    protected ?string $author = null;
+    protected ?string $content = null;
+    protected array $enclosures = [];
+    protected array $categories = [];
+    protected ?string $uid = null;
+    protected array $misc = [];
 
-    /** @var string|null Title of the item */
-    protected $title = null;
-
-    /** @var int|null Timestamp of when the item was first released */
-    protected $timestamp = null;
-
-    /** @var string|null Name of the author */
-    protected $author = null;
-
-    /** @var string|null Body of the feed */
-    protected $content = null;
-
-    /** @var array List of links to media objects */
-    protected $enclosures = [];
-
-    /** @var array List of category names or tags */
-    protected $categories = [];
-
-    /** @var string Unique ID for the current item */
-    protected $uid = null;
-
-    /** @var array Associative list of additional parameters */
-    protected $misc = []; // Custom parameters
-
-    /**
-     * Create object from legacy item.
-     *
-     * The provided array must be an associative array of key-value-pairs, where
-     * keys may correspond to any of the properties of this class.
-     *
-     * Example use:
-     *
-     * ```PHP
-     * <?php
-     * $item = array();
-     *
-     * $item['uri'] = 'https://www.github.com/rss-bridge/rss-bridge/';
-     * $item['title'] = 'Title';
-     * $item['timestamp'] = strtotime('now');
-     * $item['author'] = 'Unknown author';
-     * $item['content'] = 'Hello World!';
-     * $item['enclosures'] = array('https://github.com/favicon.ico');
-     * $item['categories'] = array('php', 'rss-bridge', 'awesome');
-     *
-     * $feedItem = new \FeedItem($item);
-     *
-     * ```
-     *
-     * The result of the code above is the same as the code below:
-     *
-     * ```PHP
-     * <?php
-     * $feedItem = \FeedItem();
-     *
-     * $feedItem->uri = 'https://www.github.com/rss-bridge/rss-bridge/';
-     * $feedItem->title = 'Title';
-     * $feedItem->timestamp = strtotime('now');
-     * $feedItem->autor = 'Unknown author';
-     * $feedItem->content = 'Hello World!';
-     * $feedItem->enclosures = array('https://github.com/favicon.ico');
-     * $feedItem->categories = array('php', 'rss-bridge', 'awesome');
-     * ```
-     *
-     * @param array $item (optional) A legacy item (empty: no legacy support).
-     * @return object A new object of this class
-     */
-    public function __construct($item = [])
+    public function __construct()
     {
-        if (!is_array($item)) {
-            Debug::log('Item must be an array!');
-        }
-
-        foreach ($item as $key => $value) {
-            $this->__set($key, $value);
+    }
+
+    public static function fromArray(array $itemArray): self
+    {
+        $item = new self();
+        foreach ($itemArray as $key => $value) {
+            $item->__set($key, $value);
         }
+        return $item;
     }
 
-    /**
-     * Get current URI.
-     *
-     * Use {@see FeedItem::setURI()} to set the URI.
-     *
-     * @return string|null The URI or null if it hasn't been set.
-     */
-    public function getURI()
-    {
-        return $this->uri;
-    }
-
-    /**
-     * Set URI to the full article.
-     *
-     * Use {@see FeedItem::getURI()} to get the URI.
-     *
-     * _Note_: Removes whitespace from the beginning and end of the URI.
-     *
-     * _Remarks_: Uses the attribute "href" or "src" if the provided URI is an
-     * object of simple_html_dom_node.
-     *
-     * @param object|string $uri URI to the full article.
-     * @return self
-     */
-    public function setURI($uri)
-    {
-        $this->uri = null; // Clear previous data
-
-        if ($uri instanceof simple_html_dom_node) {
-            if ($uri->hasAttribute('href')) { // Anchor
-                $uri = $uri->href;
-            } elseif ($uri->hasAttribute('src')) { // Image
-                $uri = $uri->src;
-            } else {
-                Debug::log('The item provided as URI is unknown!');
-            }
-        }
-        if (!is_string($uri)) {
-            Debug::log(sprintf('Expected $uri to be string but got %s', gettype($uri)));
-            return $this;
-        }
-        $uri = trim($uri);
-        // Intentionally doing a weak url validation here because FILTER_VALIDATE_URL is too strict
-        if (!preg_match('#^https?://#i', $uri)) {
-            Debug::log(sprintf('Not a valid url: "%s"', $uri));
-            return $this;
-        }
-        $this->uri = $uri;
-        return $this;
-    }
-
-    /**
-     * Get current title.
-     *
-     * Use {@see FeedItem::setTitle()} to set the title.
-     *
-     * @return string|null The current title or null if it hasn't been set.
-     */
-    public function getTitle()
-    {
-        return $this->title;
-    }
-
-    /**
-     * Set title.
-     *
-     * Use {@see FeedItem::getTitle()} to get the title.
-     *
-     * _Note_: Removes whitespace from beginning and end of the title.
-     *
-     * @param string $title The title
-     * @return self
-     */
-    public function setTitle($title)
-    {
-        $this->title = null; // Clear previous data
-
-        if (!is_string($title)) {
-            Debug::log('Title must be a string!');
-        } else {
-            $this->title = truncate(trim($title));
-        }
-
-        return $this;
-    }
-
-    /**
-     * Get current timestamp.
-     *
-     * Use {@see FeedItem::setTimestamp()} to set the timestamp.
-     *
-     * @return int|null The current timestamp or null if it hasn't been set.
-     */
-    public function getTimestamp()
-    {
-        return $this->timestamp;
-    }
-
-    /**
-     * Set timestamp of first release.
-     *
-     * _Note_: The timestamp should represent the number of seconds since
-     * January 1 1970 00:00:00 GMT (Unix time).
-     *
-     * _Remarks_: If the provided timestamp is a string (not numeric), this
-     * function automatically attempts to parse the string using
-     * [strtotime](http://php.net/manual/en/function.strtotime.php)
-     *
-     * @link http://php.net/manual/en/function.strtotime.php strtotime (PHP)
-     * @link https://en.wikipedia.org/wiki/Unix_time Unix time (Wikipedia)
-     *
-     * @param string|int $timestamp A timestamp of when the item was first released
-     * @return self
-     */
-    public function setTimestamp($timestamp)
-    {
-        $this->timestamp = null; // Clear previous data
-
-        if (
-            !is_numeric($timestamp)
-            && !$timestamp = strtotime($timestamp)
-        ) {
-            Debug::log('Unable to parse timestamp!');
-        }
-
-        if ($timestamp <= 0) {
-            Debug::log('Timestamp must be greater than zero!');
-        } else {
-            $this->timestamp = $timestamp;
-        }
-
-        return $this;
-    }
-
-    /**
-     * Get the current author name.
-     *
-     * Use {@see FeedItem::setAuthor()} to set the author.
-     *
-     * @return string|null The author or null if it hasn't been set.
-     */
-    public function getAuthor()
-    {
-        return $this->author;
-    }
-
-    /**
-     * Set the author name.
-     *
-     * Use {@see FeedItem::getAuthor()} to get the author.
-     *
-     * @param string $author The author name.
-     * @return self
-     */
-    public function setAuthor($author)
-    {
-        $this->author = null; // Clear previous data
-
-        if (!is_string($author)) {
-            Debug::log('Author must be a string!');
-        } else {
-            $this->author = $author;
-        }
-
-        return $this;
-    }
-
-    /**
-     * Get item content.
-     *
-     * Use {@see FeedItem::setContent()} to set the item content.
-     *
-     * @return string|null The item content or null if it hasn't been set.
-     */
-    public function getContent()
-    {
-        return $this->content;
-    }
-
-    /**
-     * Set item content.
-     *
-     * Note: This function casts objects of type simple_html_dom and
-     * simple_html_dom_node to string.
-     *
-     * Use {@see FeedItem::getContent()} to get the current item content.
-     *
-     * @param string|object $content The item content as text or simple_html_dom object.
-     * @return self
-     */
-    public function setContent($content)
-    {
-        $this->content = null; // Clear previous data
-
-        if (
-            $content instanceof simple_html_dom
-            || $content instanceof simple_html_dom_node
-        ) {
-            $content = (string)$content;
-        }
-
-        if (is_string($content)) {
-            $this->content = $content;
-        } else {
-            Debug::log(sprintf('Feed content must be a string but got %s', gettype($content)));
-        }
-
-        return $this;
-    }
-
-    /**
-     * Get item enclosures.
-     *
-     * Use {@see FeedItem::setEnclosures()} to set feed enclosures.
-     *
-     * @return array Enclosures as array of enclosure URIs.
-     */
-    public function getEnclosures()
-    {
-        return $this->enclosures;
-    }
-
-    /**
-     * Set item enclosures.
-     *
-     * Use {@see FeedItem::getEnclosures()} to get the current item enclosures.
-     *
-     * @param array $enclosures Array of enclosures, where each element links to
-     * one enclosure.
-     * @return self
-     */
-    public function setEnclosures($enclosures)
-    {
-        $this->enclosures = [];
-
-        if (is_array($enclosures)) {
-            foreach ($enclosures as $enclosure) {
-                if (
-                    !filter_var(
-                        $enclosure,
-                        FILTER_VALIDATE_URL,
-                        FILTER_FLAG_PATH_REQUIRED
-                    )
-                ) {
-                    Debug::log('Each enclosure must contain a scheme, host and path!');
-                } elseif (!in_array($enclosure, $this->enclosures)) {
-                    $this->enclosures[] = $enclosure;
-                }
-            }
-        } else {
-            Debug::log('Enclosures must be an array!');
-        }
-
-        return $this;
-    }
-
-    /**
-     * Get item categories.
-     *
-     * Use {@see FeedItem::setCategories()} to set item categories.
-     *
-     * @param array The item categories.
-     */
-    public function getCategories()
-    {
-        return $this->categories;
-    }
-
-    /**
-     * Set item categories.
-     *
-     * Use {@see FeedItem::getCategories()} to get the current item categories.
-     *
-     * @param array $categories Array of categories, where each element defines
-     * a single category name.
-     * @return self
-     */
-    public function setCategories($categories)
-    {
-        $this->categories = [];
-
-        if (is_array($categories)) {
-            foreach ($categories as $category) {
-                if (!is_string($category)) {
-                    Debug::log('Category must be a string!');
-                } else {
-                    $this->categories[] = $category;
-                }
-            }
-        } else {
-            Debug::log('Categories must be an array!');
-        }
-
-        return $this;
-    }
-
-    /**
-     * Get unique id
-     *
-     * Use {@see FeedItem::setUid()} to set the unique id.
-     *
-     * @param string The unique id.
-     */
-    public function getUid()
-    {
-        return $this->uid;
-    }
-
-    /**
-     * Set unique id.
-     *
-     * Use {@see FeedItem::getUid()} to get the unique id.
-     *
-     * @param string $uid A string that uniquely identifies the current item
-     * @return self
-     */
-    public function setUid($uid)
-    {
-        $this->uid = null; // Clear previous data
-
-        if (!is_string($uid)) {
-            Debug::log('Unique id must be a string!');
-        } elseif (preg_match('/^[a-f0-9]{40}$/', $uid)) {
-            // keep id if it already is a SHA-1 hash
-            $this->uid = $uid;
-        } else {
-            $this->uid = sha1($uid);
-        }
-
-        return $this;
-    }
-
-    /**
-     * Add miscellaneous elements to the item.
-     *
-     * @param string $key Name of the element.
-     * @param mixed $value Value of the element.
-     * @return self
-     */
-    public function addMisc($key, $value)
-    {
-        if (!is_string($key)) {
-            Debug::log('Key must be a string!');
-        } elseif (in_array($key, get_object_vars($this))) {
-            Debug::log('Key must be unique!');
-        } else {
-            $this->misc[$key] = $value;
-        }
-
-        return $this;
-    }
-
-    /**
-     * Transform current object to array
-     *
-     * @return array
-     */
-    public function toArray()
-    {
-        return array_merge(
-            [
-                'uri' => $this->uri,
-                'title' => $this->title,
-                'timestamp' => $this->timestamp,
-                'author' => $this->author,
-                'content' => $this->content,
-                'enclosures' => $this->enclosures,
-                'categories' => $this->categories,
-                'uid' => $this->uid,
-            ],
-            $this->misc
-        );
-    }
-
-    /**
-     * Set item property
-     *
-     * Allows simple assignment to parameters. This method is slower, but easier
-     * to implement in some cases:
-     *
-     * ```PHP
-     * $item = new \FeedItem();
-     * $item->content = 'Hello World!';
-     * $item->my_id = 42;
-     * ```
-     *
-     * @param string $name Property name
-     * @param mixed $value Property value
-     */
     public function __set($name, $value)
     {
         switch ($name) {
@@ -538,15 +57,6 @@ class FeedItem
         }
     }
 
-    /**
-     * Get item property
-     *
-     * Allows simple assignment to parameters. This method is slower, but easier
-     * to implement in some cases.
-     *
-     * @param string $name Property name
-     * @return mixed Property value
-     */
     public function __get($name)
     {
         switch ($name) {
@@ -573,4 +83,220 @@ class FeedItem
                 return null;
         }
     }
+
+    public function getURI(): ?string
+    {
+        return $this->uri;
+    }
+
+    /**
+     * Set URI to the full article.
+     *
+     * Use {@see FeedItem::getURI()} to get the URI.
+     *
+     * _Note_: Removes whitespace from the beginning and end of the URI.
+     *
+     * _Remarks_: Uses the attribute "href" or "src" if the provided URI is an
+     * object of simple_html_dom_node.
+     *
+     * @param simple_html_dom_node|object|string $uri URI to the full article.
+     */
+    public function setURI($uri)
+    {
+        $this->uri = null; // Clear previous data
+
+        if ($uri instanceof simple_html_dom_node) {
+            if ($uri->hasAttribute('href')) { // Anchor
+                $uri = $uri->href;
+            } elseif ($uri->hasAttribute('src')) { // Image
+                $uri = $uri->src;
+            } else {
+                Debug::log('The item provided as URI is unknown!');
+            }
+        }
+        if (!is_string($uri)) {
+            Debug::log(sprintf('Expected $uri to be string but got %s', gettype($uri)));
+            return;
+        }
+        $uri = trim($uri);
+        // Intentionally doing a weak url validation here because FILTER_VALIDATE_URL is too strict
+        if (!preg_match('#^https?://#i', $uri)) {
+            Debug::log(sprintf('Not a valid url: "%s"', $uri));
+            return;
+        }
+        $this->uri = $uri;
+    }
+
+    public function getTitle(): ?string
+    {
+        return $this->title;
+    }
+
+    public function setTitle($title)
+    {
+        $this->title = null;
+        if (!is_string($title)) {
+            Debug::log('Title must be a string!');
+        } else {
+            $this->title = truncate(trim($title));
+        }
+    }
+
+    public function getTimestamp(): ?int
+    {
+        return $this->timestamp;
+    }
+
+    public function setTimestamp($timestamp)
+    {
+        $this->timestamp = null;
+        if (
+            !is_numeric($timestamp)
+            && !$timestamp = strtotime($timestamp)
+        ) {
+            Debug::log('Unable to parse timestamp!');
+        }
+        if ($timestamp <= 0) {
+            Debug::log('Timestamp must be greater than zero!');
+        } else {
+            $this->timestamp = $timestamp;
+        }
+    }
+
+    public function getAuthor(): ?string
+    {
+        return $this->author;
+    }
+
+    public function setAuthor($author)
+    {
+        $this->author = null;
+        if (!is_string($author)) {
+            Debug::log('Author must be a string!');
+        } else {
+            $this->author = $author;
+        }
+        return $this;
+    }
+
+    public function getContent(): ?string
+    {
+        return $this->content;
+    }
+
+    /**
+     * @param string|object $content The item content as text or simple_html_dom object.
+     */
+    public function setContent($content)
+    {
+        $this->content = null;
+        if (
+            $content instanceof simple_html_dom
+            || $content instanceof simple_html_dom_node
+        ) {
+            $content = (string) $content;
+        }
+        if (is_string($content)) {
+            $this->content = $content;
+        } else {
+            Debug::log(sprintf('Feed content must be a string but got %s', gettype($content)));
+        }
+    }
+
+    public function getEnclosures(): array
+    {
+        return $this->enclosures;
+    }
+
+    public function setEnclosures($enclosures)
+    {
+        $this->enclosures = [];
+
+        if (!is_array($enclosures)) {
+            Debug::log('Enclosures must be an array!');
+            return;
+        }
+        foreach ($enclosures as $enclosure) {
+            if (
+                !filter_var(
+                    $enclosure,
+                    FILTER_VALIDATE_URL,
+                    FILTER_FLAG_PATH_REQUIRED
+                )
+            ) {
+                Debug::log('Each enclosure must contain a scheme, host and path!');
+            } elseif (!in_array($enclosure, $this->enclosures)) {
+                $this->enclosures[] = $enclosure;
+            }
+        }
+    }
+
+    public function getCategories(): array
+    {
+        return $this->categories;
+    }
+
+    public function setCategories($categories)
+    {
+        $this->categories = [];
+
+        if (!is_array($categories)) {
+            Debug::log('Categories must be an array!');
+            return;
+        }
+        foreach ($categories as $category) {
+            if (is_string($category)) {
+                $this->categories[] = $category;
+            } else {
+                Debug::log('Category must be a string!');
+            }
+        }
+    }
+
+    public function getUid(): ?string
+    {
+        return $this->uid;
+    }
+
+    public function setUid($uid)
+    {
+        $this->uid = null;
+        if (!is_string($uid)) {
+            Debug::log('Unique id must be a string!');
+        } elseif (preg_match('/^[a-f0-9]{40}$/', $uid)) {
+            // keep id if it already is SHA-1 hash
+            $this->uid = $uid;
+        } else {
+            $this->uid = sha1($uid);
+        }
+    }
+
+    public function addMisc($name, $value)
+    {
+        if (!is_string($name)) {
+            Debug::log('Key must be a string!');
+        } elseif (in_array($name, get_object_vars($this))) {
+            Debug::log('Key must be unique!');
+        } else {
+            $this->misc[$name] = $value;
+        }
+        return $this;
+    }
+
+    public function toArray(): array
+    {
+        return array_merge(
+            [
+                'uri' => $this->uri,
+                'title' => $this->title,
+                'timestamp' => $this->timestamp,
+                'author' => $this->author,
+                'content' => $this->content,
+                'enclosures' => $this->enclosures,
+                'categories' => $this->categories,
+                'uid' => $this->uid,
+            ],
+            $this->misc
+        );
+    }
 }
diff --git a/lib/FormatAbstract.php b/lib/FormatAbstract.php
index 3289d651..0304f627 100644
--- a/lib/FormatAbstract.php
+++ b/lib/FormatAbstract.php
@@ -1,132 +1,70 @@
 <?php
 
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license https://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
-/**
- * An abstract class for format implementations
- *
- * This class implements {@see FormatInterface}
- */
-abstract class FormatAbstract implements FormatInterface
+abstract class FormatAbstract
 {
-    /** The default charset (UTF-8) */
-    const DEFAULT_CHARSET = 'UTF-8';
-
-    /** MIME type of format output */
     const MIME_TYPE = 'text/plain';
 
-    /** @var string $charset The charset */
-    protected $charset;
+    protected string $charset = 'UTF-8';
+    protected array $items = [];
+    protected int $lastModified;
+    protected array $extraInfos = [];
 
-    /** @var array $items The items */
-    protected $items;
+    abstract public function stringify();
 
-    /**
-     * @var int $lastModified A timestamp to indicate the last modified time of
-     * the output data.
-     */
-    protected $lastModified;
-
-    /** @var array $extraInfos The extra infos */
-    protected $extraInfos;
-
-    /** {@inheritdoc} */
-    public function getMimeType()
+    public function getMimeType(): string
     {
         return static::MIME_TYPE;
     }
 
-    /**
-     * {@inheritdoc}
-     *
-     * @param string $charset {@inheritdoc}
-     */
-    public function setCharset($charset)
+    public function setCharset(string $charset)
     {
         $this->charset = $charset;
-
-        return $this;
     }
 
-    /** {@inheritdoc} */
-    public function getCharset()
+    public function getCharset(): string
     {
-        $charset = $this->charset;
-
-        if (is_null($charset)) {
-            return static::DEFAULT_CHARSET;
-        }
-        return $charset;
+        return $this->charset;
     }
 
-    /**
-     * Set the last modified time
-     *
-     * @param int $lastModified The last modified time
-     * @return void
-     */
-    public function setLastModified($lastModified)
+    public function setLastModified(int $lastModified)
     {
         $this->lastModified = $lastModified;
     }
 
-    /**
-     * {@inheritdoc}
-     *
-     * @param array $items {@inheritdoc}
-     */
     public function setItems(array $items)
     {
         $this->items = $items;
-
-        return $this;
-    }
-
-    /** {@inheritdoc} */
-    public function getItems()
-    {
-        if (!is_array($this->items)) {
-            throw new \LogicException(sprintf('Feed the %s with "setItems" method before !', get_class($this)));
-        }
-
-        return $this->items;
     }
 
     /**
-     * {@inheritdoc}
-     *
-     * @param array $extraInfos {@inheritdoc}
+     * @return FeedItem[] The items
      */
-    public function setExtraInfos(array $extraInfos = [])
+    public function getItems(): array
     {
-        foreach (['name', 'uri', 'icon', 'donationUri'] as $infoName) {
-            if (!isset($extraInfos[$infoName])) {
-                $extraInfos[$infoName] = '';
-            }
-        }
-
-        $this->extraInfos = $extraInfos;
-
-        return $this;
+        return $this->items;
     }
 
-    /** {@inheritdoc} */
-    public function getExtraInfos()
+    public function setExtraInfos(array $infos = [])
     {
-        if (is_null($this->extraInfos)) { // No extra info ?
-            $this->setExtraInfos(); // Define with default value
+        $extras = [
+            'name',
+            'uri',
+            'icon',
+            'donationUri',
+        ];
+        foreach ($extras as $extra) {
+            if (!isset($infos[$extra])) {
+                $infos[$extra] = '';
+            }
         }
+        $this->extraInfos = $infos;
+    }
 
+    public function getExtraInfos(): array
+    {
+        if (!$this->extraInfos) {
+            $this->setExtraInfos();
+        }
         return $this->extraInfos;
     }
 }
diff --git a/lib/FormatFactory.php b/lib/FormatFactory.php
index d27d7d6a..9cded40f 100644
--- a/lib/FormatFactory.php
+++ b/lib/FormatFactory.php
@@ -33,7 +33,7 @@ class FormatFactory
      * @throws \InvalidArgumentException
      * @param string $name The name of the format e.g. "Atom", "Mrss" or "Json"
      */
-    public function create(string $name): FormatInterface
+    public function create(string $name): FormatAbstract
     {
         if (! preg_match('/^[a-zA-Z0-9-]*$/', $name)) {
             throw new \InvalidArgumentException('Format name invalid!');
diff --git a/lib/FormatInterface.php b/lib/FormatInterface.php
deleted file mode 100644
index 49e36933..00000000
--- a/lib/FormatInterface.php
+++ /dev/null
@@ -1,77 +0,0 @@
-<?php
-
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
-/**
- * The format interface
- *
- * @todo Add missing function to the interface
- * @todo Explain parameters and return values in more detail
- * @todo Return self more often (to allow call chaining)
- */
-interface FormatInterface
-{
-    /**
-     * Generate a string representation of the current data
-     *
-     * @return string The string representation
-     */
-    public function stringify();
-
-    public function setItems(array $items);
-
-    /**
-     * Return items
-     *
-     * @throws \LogicException if the items are not set
-     * @return FeedItem[] The items
-     */
-    public function getItems();
-
-    /**
-     * Set extra information
-     *
-     * @param array $infos Extra information
-     * @return self The format object
-     */
-    public function setExtraInfos(array $infos);
-
-    /**
-     * Return extra information
-     *
-     * @return array Extra information
-     */
-    public function getExtraInfos();
-
-    /**
-     * Return MIME type
-     *
-     * @return string The MIME type
-     */
-    public function getMimeType();
-
-    /**
-     * Set charset
-     *
-     * @param string $charset The charset
-     * @return self The format object
-     */
-    public function setCharset($charset);
-
-    /**
-     * Return current charset
-     *
-     * @return string The charset
-     */
-    public function getCharset();
-}
diff --git a/lib/bootstrap.php b/lib/bootstrap.php
index dc1c0f04..bc584541 100644
--- a/lib/bootstrap.php
+++ b/lib/bootstrap.php
@@ -12,20 +12,12 @@
  * @link    https://github.com/rss-bridge/rss-bridge
  */
 
-/** Path to the root folder of RSS-Bridge (where index.php is located) */
-const PATH_ROOT = __DIR__ . '/../';
-
-/** Path to the bridges library */
-
 /** Path to the formats library */
 const PATH_LIB_FORMATS = __DIR__ . '/../formats/';
 
 /** Path to the caches library */
 const PATH_LIB_CACHES = __DIR__ . '/../caches/';
 
-/** Path to the actions library */
-const PATH_LIB_ACTIONS = __DIR__ . '/../actions/';
-
 /** Path to the cache folder */
 const PATH_CACHE = __DIR__ . '/../cache/';
 
diff --git a/lib/logger.php b/lib/logger.php
index ed1f1179..5d95e673 100644
--- a/lib/logger.php
+++ b/lib/logger.php
@@ -148,6 +148,9 @@ final class StreamHandler
             $context
         );
         error_log($text);
+        if (Debug::isEnabled()) {
+            print sprintf("<pre>%s</pre>\n", e($text));
+        }
         //$bytes = file_put_contents('/tmp/rss-bridge.log', $text, FILE_APPEND | LOCK_EX);
     }
 }
diff --git a/tests/Formats/BaseFormatTest.php b/tests/Formats/BaseFormatTest.php
index 30ce1063..71e196f0 100644
--- a/tests/Formats/BaseFormatTest.php
+++ b/tests/Formats/BaseFormatTest.php
@@ -39,7 +39,7 @@ abstract class BaseFormatTest extends TestCase
 
             $items = [];
             foreach ($data['items'] as $item) {
-                $items[] = new \FeedItem($item);
+                $items[] = \FeedItem::fromArray($item);
             }
 
             return (object)[
diff --git a/tests/Formats/FormatImplementationTest.php b/tests/Formats/FormatImplementationTest.php
index 55c6335f..03ac6d51 100644
--- a/tests/Formats/FormatImplementationTest.php
+++ b/tests/Formats/FormatImplementationTest.php
@@ -24,7 +24,7 @@ class FormatImplementationTest extends TestCase
     public function testClassType($path)
     {
         $this->setFormat($path);
-        $this->assertInstanceOf(FormatInterface::class, $this->obj);
+        $this->assertInstanceOf(FormatAbstract::class, $this->obj);
     }
 
     public function dataFormatsProvider()

From f421c45b21c6c98c0cf5893d8776bbc34b684240 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Mon, 25 Sep 2023 22:32:15 +0200
Subject: [PATCH 134/716] test: add feed item test (#3709)

* test: add feed item test

also some refactor

* yup

* yup
---
 bridges/FilterBridge.php    | 18 +++++-----
 formats/AtomFormat.php      | 12 +++----
 formats/HtmlFormat.php      |  7 ++--
 formats/JsonFormat.php      |  9 ++---
 formats/MrssFormat.php      | 20 +++++------
 formats/PlaintextFormat.php | 12 +++----
 formats/SfeedFormat.php     | 67 ++++++++++++++++++-------------------
 lib/contents.php            |  2 +-
 lib/logger.php              |  2 +-
 tests/FeedItemTest.php      | 30 +++++++++++++++++
 10 files changed, 98 insertions(+), 81 deletions(-)
 create mode 100644 tests/FeedItemTest.php

diff --git a/bridges/FilterBridge.php b/bridges/FilterBridge.php
index ef739de3..1d920f90 100644
--- a/bridges/FilterBridge.php
+++ b/bridges/FilterBridge.php
@@ -73,6 +73,15 @@ class FilterBridge extends FeedExpander
         ],
     ]];
 
+    public function collectData()
+    {
+        $url = $this->getInput('url');
+        if (!Url::validate($url)) {
+            returnClientError('The url parameter must either refer to http or https protocol.');
+        }
+        $this->collectExpandableDatas($this->getURI());
+    }
+
     protected function parseItem($newItem)
     {
         $item = parent::parseItem($newItem);
@@ -158,13 +167,4 @@ class FilterBridge extends FeedExpander
 
         return $url;
     }
-
-    public function collectData()
-    {
-        if ($this->getInput('url') && substr($this->getInput('url'), 0, 4) !== 'http') {
-            // just in case someone finds a way to access local files by playing with the url
-            returnClientError('The url parameter must either refer to http or https protocol.');
-        }
-        $this->collectExpandableDatas($this->getURI());
-    }
 }
diff --git a/formats/AtomFormat.php b/formats/AtomFormat.php
index 1b9053fa..9886e4b7 100644
--- a/formats/AtomFormat.php
+++ b/formats/AtomFormat.php
@@ -14,8 +14,6 @@ class AtomFormat extends FormatAbstract
     protected const ATOM_NS = 'http://www.w3.org/2005/Atom';
     protected const MRSS_NS = 'http://search.yahoo.com/mrss/';
 
-    const LIMIT_TITLE = 140;
-
     public function stringify()
     {
         $feedUrl = get_current_url();
@@ -109,8 +107,8 @@ class AtomFormat extends FormatAbstract
 
             if (empty($entryTitle)) {
                 $entryTitle = str_replace("\n", ' ', strip_tags($entryContent));
-                if (strlen($entryTitle) > self::LIMIT_TITLE) {
-                    $wrapPos = strpos(wordwrap($entryTitle, self::LIMIT_TITLE), "\n");
+                if (strlen($entryTitle) > 140) {
+                    $wrapPos = strpos(wordwrap($entryTitle, 140), "\n");
                     $entryTitle = substr($entryTitle, 0, $wrapPos) . '...';
                 }
             }
@@ -182,11 +180,11 @@ class AtomFormat extends FormatAbstract
             }
         }
 
-        $toReturn = $document->saveXML();
+        $xml = $document->saveXML();
 
         // Remove invalid characters
         ini_set('mbstring.substitute_character', 'none');
-        $toReturn = mb_convert_encoding($toReturn, $this->getCharset(), 'UTF-8');
-        return $toReturn;
+        $xml = mb_convert_encoding($xml, $this->getCharset(), 'UTF-8');
+        return $xml;
     }
 }
diff --git a/formats/HtmlFormat.php b/formats/HtmlFormat.php
index 9ee4aeea..4933af8d 100644
--- a/formats/HtmlFormat.php
+++ b/formats/HtmlFormat.php
@@ -6,6 +6,8 @@ class HtmlFormat extends FormatAbstract
 
     public function stringify()
     {
+        $queryString = $_SERVER['QUERY_STRING'];
+
         $extraInfos = $this->getExtraInfos();
         $formatFactory = new FormatFactory();
         $buttons = [];
@@ -15,7 +17,7 @@ class HtmlFormat extends FormatAbstract
             if ($format === 'Html') {
                 continue;
             }
-            $formatUrl = '?' . str_ireplace('format=Html', 'format=' . $format, htmlentities($_SERVER['QUERY_STRING']));
+            $formatUrl = '?' . str_ireplace('format=Html', 'format=' . $format, htmlentities($queryString));
             $buttons[] = [
                 'href' => $formatUrl,
                 'value' => $format,
@@ -57,6 +59,7 @@ class HtmlFormat extends FormatAbstract
         ]);
         // Remove invalid characters
         ini_set('mbstring.substitute_character', 'none');
-        return mb_convert_encoding($html, $this->getCharset(), 'UTF-8');
+        $html = mb_convert_encoding($html, $this->getCharset(), 'UTF-8');
+        return $html;
     }
 }
diff --git a/formats/JsonFormat.php b/formats/JsonFormat.php
index 5bb1a525..dd61da41 100644
--- a/formats/JsonFormat.php
+++ b/formats/JsonFormat.php
@@ -110,13 +110,8 @@ class JsonFormat extends FormatAbstract
         }
         $data['items'] = $items;
 
-        /**
-         * The intention here is to discard non-utf8 byte sequences.
-         * But the JSON_PARTIAL_OUTPUT_ON_ERROR also discards lots of other errors.
-         * So consider this a hack.
-         * Switch to JSON_INVALID_UTF8_IGNORE when PHP 7.2 is the latest platform requirement.
-         */
-        $json = json_encode($data, \JSON_PRETTY_PRINT | \JSON_PARTIAL_OUTPUT_ON_ERROR);
+        // Ignoring invalid json
+        $json = json_encode($data, \JSON_PRETTY_PRINT | \JSON_INVALID_UTF8_IGNORE);
 
         return $json;
     }
diff --git a/formats/MrssFormat.php b/formats/MrssFormat.php
index 3c3dce5a..984611c7 100644
--- a/formats/MrssFormat.php
+++ b/formats/MrssFormat.php
@@ -32,12 +32,6 @@ class MrssFormat extends FormatAbstract
     protected const ATOM_NS = 'http://www.w3.org/2005/Atom';
     protected const MRSS_NS = 'http://search.yahoo.com/mrss/';
 
-    const ALLOWED_IMAGE_EXT = [
-        '.gif',
-        '.jpg',
-        '.png',
-    ];
-
     public function stringify()
     {
         $feedUrl = get_current_url();
@@ -72,8 +66,13 @@ class MrssFormat extends FormatAbstract
         $channel->appendChild($description);
         $description->appendChild($document->createTextNode($extraInfos['name']));
 
+        $allowedIconExtensions = [
+            '.gif',
+            '.jpg',
+            '.png',
+        ];
         $icon = $extraInfos['icon'];
-        if (!empty($icon) && in_array(substr($icon, -4), self::ALLOWED_IMAGE_EXT)) {
+        if (!empty($icon) && in_array(substr($icon, -4), $allowedIconExtensions)) {
             $feedImage = $document->createElement('image');
             $channel->appendChild($feedImage);
             $iconUrl = $document->createElement('url');
@@ -164,11 +163,10 @@ class MrssFormat extends FormatAbstract
             }
         }
 
-        $toReturn = $document->saveXML();
-
+        $xml = $document->saveXML();
         // Remove invalid non-UTF8 characters
         ini_set('mbstring.substitute_character', 'none');
-        $toReturn = mb_convert_encoding($toReturn, $this->getCharset(), 'UTF-8');
-        return $toReturn;
+        $xml = mb_convert_encoding($xml, $this->getCharset(), 'UTF-8');
+        return $xml;
     }
 }
diff --git a/formats/PlaintextFormat.php b/formats/PlaintextFormat.php
index c8c4e9d6..0a9237d0 100644
--- a/formats/PlaintextFormat.php
+++ b/formats/PlaintextFormat.php
@@ -6,18 +6,14 @@ class PlaintextFormat extends FormatAbstract
 
     public function stringify()
     {
-        $items = $this->getItems();
         $data = [];
-
-        foreach ($items as $item) {
+        foreach ($this->getItems() as $item) {
             $data[] = $item->toArray();
         }
-
-        $toReturn = print_r($data, true);
-
+        $text = print_r($data, true);
         // Remove invalid non-UTF8 characters
         ini_set('mbstring.substitute_character', 'none');
-        $toReturn = mb_convert_encoding($toReturn, $this->getCharset(), 'UTF-8');
-        return $toReturn;
+        $text = mb_convert_encoding($text, $this->getCharset(), 'UTF-8');
+        return $text;
     }
 }
diff --git a/formats/SfeedFormat.php b/formats/SfeedFormat.php
index 85d5f608..33740aaa 100644
--- a/formats/SfeedFormat.php
+++ b/formats/SfeedFormat.php
@@ -4,6 +4,38 @@ class SfeedFormat extends FormatAbstract
 {
     const MIME_TYPE = 'text/plain';
 
+    public function stringify()
+    {
+        $text = '';
+        foreach ($this->getItems() as $item) {
+            $text .= sprintf(
+                "%s\t%s\t%s\t%s\thtml\t\t%s\t%s\t%s\n",
+                $item->toArray()['timestamp'],
+                preg_replace('/\s/', ' ', $item->toArray()['title']),
+                $item->toArray()['uri'],
+                $this->escape($item->toArray()['content']),
+                $item->toArray()['author'],
+                $this->getFirstEnclosure(
+                    $item->toArray()['enclosures']
+                ),
+                $this->escape(
+                    $this->getCategories(
+                        $item->toArray()['categories']
+                    )
+                )
+            );
+        }
+
+        // Remove invalid non-UTF8 characters
+        ini_set('mbstring.substitute_character', 'none');
+        $text = mb_convert_encoding(
+            $text,
+            $this->getCharset(),
+            'UTF-8'
+        );
+        return $text;
+    }
+
     private function escape(string $str)
     {
         $str = str_replace('\\', '\\\\', $str);
@@ -31,39 +63,4 @@ class SfeedFormat extends FormatAbstract
         }
         return $toReturn;
     }
-
-    public function stringify()
-    {
-        $items = $this->getItems();
-
-        $toReturn = '';
-        foreach ($items as $item) {
-            $toReturn .= sprintf(
-                "%s\t%s\t%s\t%s\thtml\t\t%s\t%s\t%s\n",
-                $item->toArray()['timestamp'],
-                preg_replace('/\s/', ' ', $item->toArray()['title']),
-                $item->toArray()['uri'],
-                $this->escape($item->toArray()['content']),
-                $item->toArray()['author'],
-                $this->getFirstEnclosure(
-                    $item->toArray()['enclosures']
-                ),
-                $this->escape(
-                    $this->getCategories(
-                        $item->toArray()['categories']
-                    )
-                )
-            );
-        }
-
-        // Remove invalid non-UTF8 characters
-        ini_set('mbstring.substitute_character', 'none');
-        $toReturn = mb_convert_encoding(
-            $toReturn,
-            $this->getCharset(),
-            'UTF-8'
-        );
-        return $toReturn;
-    }
 }
-// vi: expandtab
diff --git a/lib/contents.php b/lib/contents.php
index e173b542..432d9139 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -15,6 +15,7 @@ function getContents(
     bool $returnFull = false
 ) {
     $httpClient = RssBridge::getHttpClient();
+    $cache = RssBridge::getCache();
 
     $httpHeadersNormalized = [];
     foreach ($httpHeaders as $httpHeader) {
@@ -51,7 +52,6 @@ function getContents(
         $config['proxy'] = Configuration::getConfig('proxy', 'url');
     }
 
-    $cache = RssBridge::getCache();
     $cacheKey = 'server_' . $url;
 
     /** @var Response $cachedResponse */
diff --git a/lib/logger.php b/lib/logger.php
index 5d95e673..e41de34b 100644
--- a/lib/logger.php
+++ b/lib/logger.php
@@ -148,7 +148,7 @@ final class StreamHandler
             $context
         );
         error_log($text);
-        if (Debug::isEnabled()) {
+        if ($record['level'] < Logger::ERROR && Debug::isEnabled()) {
             print sprintf("<pre>%s</pre>\n", e($text));
         }
         //$bytes = file_put_contents('/tmp/rss-bridge.log', $text, FILE_APPEND | LOCK_EX);
diff --git a/tests/FeedItemTest.php b/tests/FeedItemTest.php
new file mode 100644
index 00000000..92833753
--- /dev/null
+++ b/tests/FeedItemTest.php
@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace RssBridge\Tests;
+
+use FeedItem;
+use PHPUnit\Framework\TestCase;
+
+class FeedItemTest extends TestCase
+{
+    public function test()
+    {
+        $item = new FeedItem();
+        $item->setTitle('hello');
+        $this->assertSame('hello', $item->getTitle());
+
+        $item = FeedItem::fromArray(['title' => 'hello2']);
+        $this->assertSame('hello2', $item->getTitle());
+
+        $item = new FeedItem();
+        $item->setAuthor('123');
+        $this->assertSame('123', $item->getAuthor());
+
+        $item = new FeedItem();
+        $item->title = 'aa';
+        $this->assertSame('aa', $item->getTitle());
+        $this->assertSame('aa', $item->title);
+    }
+}

From ae53adefadea4b05a419afff1f2ae447bf555132 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 26 Sep 2023 00:27:45 +0200
Subject: [PATCH 135/716] refactor: FeedItem::setTimestamp() (#3711)

---
 bridges/CNETFranceBridge.php    |  3 ++-
 bridges/MastodonBridge.php      |  9 +++++----
 docs/04_For_Developers/index.md |  8 +++++---
 lib/FeedItem.php                | 14 ++++++++------
 tests/FeedItemTest.php          | 19 ++++++++++++++++++-
 5 files changed, 38 insertions(+), 15 deletions(-)

diff --git a/bridges/CNETFranceBridge.php b/bridges/CNETFranceBridge.php
index 724564fa..da808596 100644
--- a/bridges/CNETFranceBridge.php
+++ b/bridges/CNETFranceBridge.php
@@ -54,7 +54,8 @@ class CNETFranceBridge extends FeedExpander
         }
 
         foreach ($this->bannedURL as $term) {
-            if (preg_match('/' . $term . '/mi', $item['uri']) === 1) {
+            $preg_match = preg_match('#' . $term . '#mi', $item['uri']);
+            if ($preg_match === 1) {
                 return null;
             }
         }
diff --git a/bridges/MastodonBridge.php b/bridges/MastodonBridge.php
index 54ac55bd..cae556b8 100644
--- a/bridges/MastodonBridge.php
+++ b/bridges/MastodonBridge.php
@@ -161,8 +161,8 @@ class MastodonBridge extends BridgeAbstract
             $object = $this->fetchAP($object);
         }
 
-        $item['content'] = $object['content'];
-        $strippedContent = strip_tags(str_replace('<br>', ' ', $object['content']));
+        $item['content'] = $object['content'] ?? '';
+        $strippedContent = strip_tags(str_replace('<br>', ' ', $item['content']));
 
         if (isset($object['name'])) {
             $item['title'] = $object['name'];
@@ -186,9 +186,10 @@ class MastodonBridge extends BridgeAbstract
 
         foreach ($object['attachment'] as $attachment) {
             // Only process REMOTE pictures (prevent xss)
+            $mediaType = $attachment['mediaType'] ?? null;
             if (
-                $attachment['mediaType']
-                && preg_match('/^image\//', $attachment['mediaType'], $match)
+                $mediaType
+                && preg_match('/^image\//', $mediaType, $match)
                 && preg_match('/^http(s|):\/\//', $attachment['url'], $match)
             ) {
                 $item['content'] = $item['content'] . '<br /><img ';
diff --git a/docs/04_For_Developers/index.md b/docs/04_For_Developers/index.md
index fcce11e3..97bbb854 100644
--- a/docs/04_For_Developers/index.md
+++ b/docs/04_For_Developers/index.md
@@ -1,10 +1,12 @@
-This area is intended for developers who decide to contribute to **RSS-Bridge** which is primarily written in [`PHP`](http://www.php.net/) with some aspects of [`HTML`](https://en.wikipedia.org/wiki/HTML) and [`CSS`](https://en.wikipedia.org/wiki/Cascading_Style_Sheets).
+This area is intended for developers who decide to contribute to **RSS-Bridge**.
+
+It is written in PHP.
 
 If you are new to **RSS-Bridge** you should make yourself familiar with some general aspects:
+
   - [Coding style policy](./01_Coding_style_policy.md)
   - [Folder structure](./03_Folder_structure.md)
   - [Debug mode](./05_Debug_mode.md)
   - [Bridge API](../05_Bridge_API/index.md)
   - [Cache API](../07_Cache_API/index.md)
-  - [Format API](../08_Format_API/index.md)
-  - [Technical recommendations](../09_Technical_recommendations/index.md)
\ No newline at end of file
+  - [Technical recommendations](../09_Technical_recommendations/index.md)
diff --git a/lib/FeedItem.php b/lib/FeedItem.php
index 4915c1b9..0bc22ee2 100644
--- a/lib/FeedItem.php
+++ b/lib/FeedItem.php
@@ -147,14 +147,16 @@ class FeedItem
         return $this->timestamp;
     }
 
-    public function setTimestamp($timestamp)
+    public function setTimestamp($datetime)
     {
         $this->timestamp = null;
-        if (
-            !is_numeric($timestamp)
-            && !$timestamp = strtotime($timestamp)
-        ) {
-            Debug::log('Unable to parse timestamp!');
+        if (is_numeric($datetime)) {
+            $timestamp = $datetime;
+        } else {
+            $timestamp = strtotime($datetime);
+            if ($timestamp === false) {
+                Debug::log('Unable to parse timestamp!');
+            }
         }
         if ($timestamp <= 0) {
             Debug::log('Timestamp must be greater than zero!');
diff --git a/tests/FeedItemTest.php b/tests/FeedItemTest.php
index 92833753..0e7af222 100644
--- a/tests/FeedItemTest.php
+++ b/tests/FeedItemTest.php
@@ -24,7 +24,24 @@ class FeedItemTest extends TestCase
 
         $item = new FeedItem();
         $item->title = 'aa';
-        $this->assertSame('aa', $item->getTitle());
         $this->assertSame('aa', $item->title);
+        $this->assertSame('aa', $item->getTitle());
+    }
+
+    public function testTimestamp()
+    {
+        $item = new FeedItem();
+        $item->setTimestamp(5);
+        $this->assertSame(5, $item->getTimestamp());
+
+        $item->setTimestamp('5');
+        $this->assertSame(5, $item->getTimestamp());
+
+        $item->setTimestamp('1970-01-01 18:00:00');
+        $this->assertSame(64800, $item->getTimestamp());
+
+        $item->setTimestamp('1st jan last year');
+        // This will fail at 2024-01-01 hehe
+        $this->assertSame(1640995200, $item->getTimestamp());
     }
 }

From c04c0a56142de6e2c0dfabd635bd5f1817cafea0 Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Wed, 27 Sep 2023 00:07:46 +0200
Subject: [PATCH 136/716] [core] prevent "*" in prtester whitelist, causing the
 script to generate a preview for every single bridge (#3713)

---
 .github/workflows/prhtmlgenerator.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/prhtmlgenerator.yml b/.github/workflows/prhtmlgenerator.yml
index ce82aef1..cfedca13 100644
--- a/.github/workflows/prhtmlgenerator.yml
+++ b/.github/workflows/prhtmlgenerator.yml
@@ -22,7 +22,7 @@ jobs:
           wget https://raw.githubusercontent.com/$GITHUB_REPOSITORY/${{ github.event.pull_request.base.ref }}/.github/prtester.py;
           wget https://patch-diff.githubusercontent.com/raw/$GITHUB_REPOSITORY/pull/$PR.patch;
           touch DEBUG;
-          cat $PR.patch | grep "\bbridges/.*Bridge\.php\b" | sed "s=.*\bbridges/\(.*\)Bridge\.php\b.*=\1=g" | sort | uniq > whitelist.txt
+          cat $PR.patch | grep "\bbridges/[A-Za-z0-9]*Bridge\.php\b" | sed "s=.*\bbridges/\([A-Za-z0-9]*\)Bridge\.php\b.*=\1=g" | sort | uniq > whitelist.txt
       - name: Start Docker - Current
         run: |
           docker run -d -v $GITHUB_WORKSPACE/whitelist.txt:/app/whitelist.txt -v $GITHUB_WORKSPACE/DEBUG:/app/DEBUG -p 3000:80 ghcr.io/rss-bridge/rss-bridge:latest

From f9ec88fb45151712677107c51fc734f5a3c69038 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 27 Sep 2023 23:29:08 +0200
Subject: [PATCH 137/716] ci: incease max line length to 180 (#3714)

---
 docs/04_For_Developers/01_Coding_style_policy.md | 13 +++++++++----
 phpcs.xml                                        |  4 ++--
 2 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/docs/04_For_Developers/01_Coding_style_policy.md b/docs/04_For_Developers/01_Coding_style_policy.md
index 4e796c32..9fb0eb10 100644
--- a/docs/04_For_Developers/01_Coding_style_policy.md
+++ b/docs/04_For_Developers/01_Coding_style_policy.md
@@ -1,8 +1,13 @@
-This section explains the coding style policy for RSS-Bridge with examples and references to external resources. Please make sure your code is compliant before opening a pull request.
+This section explains the coding style policy for RSS-Bridge with examples and references to external resources.
+Please make sure your code is compliant before opening a pull request.
 
-You will automatically be notified if issues were found in your pull request. You must fix those issues before the pull request will be merged. Refer to [phpcs.xml](https://github.com/RSS-Bridge/rss-bridge/blob/master/phpcs.xml) for a complete list of policies enforced by Travis-CI.
+You will automatically be notified if issues were found in your pull request.
+You must fix those issues before the pull request will be merged.
+Refer to [phpcs.xml](https://github.com/RSS-Bridge/rss-bridge/blob/master/phpcs.xml) for a complete list of policies enforced by Travis-CI.
 
-If you want to run the checks locally, make sure you have [`phpcs`](https://github.com/squizlabs/PHP_CodeSniffer) and [`phpunit`](https://phpunit.de/) installed on your machine and run following commands in the root directory of RSS-Bridge (tested on Debian):
+If you want to run the checks locally, make sure you have
+[`phpcs`](https://github.com/squizlabs/PHP_CodeSniffer) and
+[`phpunit`](https://phpunit.de/) installed on your machine and run following commands in the root directory of RSS-Bridge (tested on Debian):
 
 ```console
 ./vendor/bin/phpcs --standard=phpcs.xml --warning-severity=0 --extensions=php -p ./
@@ -73,7 +78,7 @@ _Reference_: [`Squiz.WhiteSpace.SuperfluousWhitespace`](https://github.com/squiz
 
 # Maximum Line Length
 
-There is no maximum line length.
+180
 
 # Strings
 
diff --git a/phpcs.xml b/phpcs.xml
index 2db0553a..5e50470a 100644
--- a/phpcs.xml
+++ b/phpcs.xml
@@ -20,8 +20,8 @@
 
   <rule ref="Generic.Files.LineLength">
     <properties>
-      <property name="lineLimit" value="160"/>
-      <property name="absoluteLineLimit" value="160"/>
+      <property name="lineLimit" value="180"/>
+      <property name="absoluteLineLimit" value="180"/>
       <property name="ignoreComments" value="true"/>
     </properties>
   </rule>

From 0de5180ded1734a8e141390f6ae4b7db123bff8c Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 28 Sep 2023 22:21:56 +0200
Subject: [PATCH 138/716] feat: improve sqlite cache robustness (#3715)

---
 caches/SQLiteCache.php | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/caches/SQLiteCache.php b/caches/SQLiteCache.php
index becedde4..d7cba554 100644
--- a/caches/SQLiteCache.php
+++ b/caches/SQLiteCache.php
@@ -86,8 +86,13 @@ class SQLiteCache implements CacheInterface
         $stmt->bindValue(':key', $cacheKey);
         $stmt->bindValue(':value', $blob, \SQLITE3_BLOB);
         $stmt->bindValue(':updated', $expiration);
-        $result = $stmt->execute();
-        // Unclear whether we should $result->finalize(); here?
+        try {
+            $result = $stmt->execute();
+            // Should $result->finalize() be called here?
+        } catch (\Exception $e) {
+            $this->logger->warning(create_sane_exception_message($e));
+            // Intentionally not rethrowing exception
+        }
     }
 
     public function delete(string $key): void

From b9ec6a0eb4ebafa3cfef0b76a628e8566468324a Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 29 Sep 2023 00:39:24 +0200
Subject: [PATCH 139/716] feat: add manyvids bridge (#3716)

---
 bridges/ManyVidsBridge.php | 48 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 bridges/ManyVidsBridge.php

diff --git a/bridges/ManyVidsBridge.php b/bridges/ManyVidsBridge.php
new file mode 100644
index 00000000..df4996e6
--- /dev/null
+++ b/bridges/ManyVidsBridge.php
@@ -0,0 +1,48 @@
+<?php
+
+class ManyVidsBridge extends BridgeAbstract
+{
+    const NAME = 'MANYVIDS';
+    const URI = 'https://www.manyvids.com';
+    const DESCRIPTION = 'Fetches the latest posts from a profile';
+    const MAINTAINER = 'dvikan';
+    const CACHE_TIMEOUT = 60 * 60;
+    const PARAMETERS = [
+        [
+            'profile' => [
+                'name' => 'Profile',
+                'type' => 'text',
+                'required' => true,
+                'exampleValue' => '678459/Aziani-Studios',
+                'title' => 'id/profile or url',
+            ],
+        ]
+    ];
+
+    public function collectData()
+    {
+        $profile = $this->getInput('profile');
+        if (preg_match('#^(\d+/.*)$#', $profile, $m)) {
+            $profile = $m[1];
+        } elseif (preg_match('#https://www.manyvids.com/Profile/(\d+/\w+)#', $profile, $m)) {
+            $profile = $m[1];
+        } else {
+            throw new \Exception('nope');
+        }
+
+        $url = sprintf('https://www.manyvids.com/Profile/%s/Store/Videos/', $profile);
+        $dom = getSimpleHTMLDOM($url);
+        $el = $dom->find('section[id="app-store-videos"]', 0);
+        $json = $el->getAttribute('data-store-videos');
+        $json = html_entity_decode($json);
+        $data = Json::decode($json, false);
+        foreach ($data->content->items as $item) {
+            $this->items[] = [
+                'title' => $item->title,
+                'uri' => 'https://www.manyvids.com' . $item->preview->path,
+                'uid' => 'manyvids/' . $item->id,
+                'content' => sprintf('<img src="%s">', $item->videoThumb),
+            ];
+        }
+    }
+}

From 2172df9fa2de2752396a55260f49594606466ec1 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 29 Sep 2023 19:17:03 +0200
Subject: [PATCH 140/716] fix: various notice fixes (#3718)

---
 bridges/CodebergBridge.php           |  6 +++++-
 bridges/CssSelectorComplexBridge.php |  6 +++++-
 bridges/ImgsedBridge.php             |  2 +-
 bridges/PepperBridgeAbstract.php     |  2 +-
 bridges/ThePirateBayBridge.php       |  1 +
 tests/UtilsTest.php                  | 10 ++++++++++
 vendor/php-urljoin/src/urljoin.php   |  5 ++++-
 7 files changed, 27 insertions(+), 5 deletions(-)

diff --git a/bridges/CodebergBridge.php b/bridges/CodebergBridge.php
index c13ff004..9515d514 100644
--- a/bridges/CodebergBridge.php
+++ b/bridges/CodebergBridge.php
@@ -260,7 +260,11 @@ class CodebergBridge extends BridgeAbstract
             }
 
             $item['author'] = $div->find('a.author', 0)->innertext;
-            $item['timestamp'] = $div->find('span.time-since', 0)->title;
+
+            $timeSince = $div->find('span.time-since', 0);
+            if ($timeSince) {
+                $item['timestamp'] = $timeSince->title;
+            }
 
             $this->items[] = $item;
         }
diff --git a/bridges/CssSelectorComplexBridge.php b/bridges/CssSelectorComplexBridge.php
index 4d44f853..c09db74a 100644
--- a/bridges/CssSelectorComplexBridge.php
+++ b/bridges/CssSelectorComplexBridge.php
@@ -415,10 +415,14 @@ class CssSelectorComplexBridge extends BridgeAbstract
     ) {
         $article_content = convertLazyLoading($entry_html);
 
+        $article_title = '';
         if (is_null($title_selector)) {
             $article_title = $title_default;
         } else {
-            $article_title = trim($entry_html->find($title_selector, 0)->innertext);
+            $titleElement = $entry_html->find($title_selector, 0);
+            if ($titleElement) {
+                $article_title = trim($titleElement->innertext);
+            }
         }
 
         $author = null;
diff --git a/bridges/ImgsedBridge.php b/bridges/ImgsedBridge.php
index 70b79866..1fa5b827 100644
--- a/bridges/ImgsedBridge.php
+++ b/bridges/ImgsedBridge.php
@@ -244,7 +244,7 @@ HTML,
             if ($this->getInput('tagged')) {
                 $types[] = 'Tags';
             }
-            $typesText = $types[0];
+            $typesText = $types[0] ?? '';
             if (count($types) > 1) {
                 for ($i = 1; $i < count($types) - 1; $i++) {
                     $typesText .= ', ' . $types[$i];
diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index c152d249..280b185d 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -463,7 +463,7 @@ HEREDOC;
                 )
             )->{'src'};
         } else {
-            return $deal->find('img[class*=' . $selectorPlain . ']', 0)->src;
+            return $deal->find('img[class*=' . $selectorPlain . ']', 0)->src ?? '';
         }
     }
 
diff --git a/bridges/ThePirateBayBridge.php b/bridges/ThePirateBayBridge.php
index 27732db5..4b130800 100644
--- a/bridges/ThePirateBayBridge.php
+++ b/bridges/ThePirateBayBridge.php
@@ -65,6 +65,7 @@ class ThePirateBayBridge extends BridgeAbstract
         '207' => 'HD Movies',
         '208' => 'HD TV-Shows',
         '209' => '3D',
+        '210' => 'CAM/TS',
         '211' => 'UHD/4k Movies',
         '212' => 'UHD/4k TV-Shows',
         '299' => 'Other',
diff --git a/tests/UtilsTest.php b/tests/UtilsTest.php
index a7b41795..f851f32b 100644
--- a/tests/UtilsTest.php
+++ b/tests/UtilsTest.php
@@ -46,4 +46,14 @@ final class UtilsTest extends TestCase
         $this->assertSame(4, strlen(create_random_string(2)));
         $this->assertSame(6, strlen(create_random_string(3)));
     }
+
+    public function testUrljoin()
+    {
+        $base = '/';
+        $rel = 'https://example.com/foo';
+
+        $url = urljoin($base, $rel);
+
+        $this->assertSame($rel, $url);
+    }
 }
diff --git a/vendor/php-urljoin/src/urljoin.php b/vendor/php-urljoin/src/urljoin.php
index ef84fbcd..026b767e 100644
--- a/vendor/php-urljoin/src/urljoin.php
+++ b/vendor/php-urljoin/src/urljoin.php
@@ -40,7 +40,10 @@ function urljoin($base, $rel) {
 	}
 
 	if (isset($prel['scheme'])) {
-		if ($prel['scheme'] != $pbase['scheme'] || in_array($prel['scheme'], $uses_relative) == false) {
+		if (
+			$prel['scheme'] != ($pbase['scheme'] ?? null)
+			|| in_array($prel['scheme'], $uses_relative) == false
+		) {
 			return $rel;
 		}
 	}

From 3557e5ffd4c2024c36d6a448c520cb9afd5cc2aa Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Sat, 30 Sep 2023 15:03:52 +0200
Subject: [PATCH 141/716] [CssSelector/Sitemap] Minor fixes (#3719)

- Apply title_cleanup to title from metadata (#3717)
- Metadata: Fix ld+json object/array confusion
- Sitemap: Also try /sitemap.xml well known url
---
 bridges/CssSelectorBridge.php | 24 ++++++++++++++++++------
 bridges/SitemapBridge.php     | 10 ++++++++--
 2 files changed, 26 insertions(+), 8 deletions(-)

diff --git a/bridges/CssSelectorBridge.php b/bridges/CssSelectorBridge.php
index c5a09822..dd8fe228 100644
--- a/bridges/CssSelectorBridge.php
+++ b/bridges/CssSelectorBridge.php
@@ -91,7 +91,7 @@ class CssSelectorBridge extends BridgeAbstract
         $limit = $this->getInput('limit') ?? 10;
 
         $html = defaultLinkTo(getSimpleHTMLDOM($url), $url);
-        $this->feedName = $this->getPageTitle($html, $title_cleanup);
+        $this->feedName = $this->titleCleanup($this->getPageTitle($html), $title_cleanup);
         $items = $this->htmlFindEntries($html, $url_selector, $url_pattern, $limit, $content_cleanup);
 
         if (empty($content_selector)) {
@@ -139,17 +139,27 @@ class CssSelectorBridge extends BridgeAbstract
     /**
      * Retrieve title from webpage URL or DOM
      * @param string|object $page URL or DOM to retrieve title from
-     * @param string $title_cleanup optional string to remove from webpage title, e.g. " | BlogName"
      * @return string Webpage title
      */
-    protected function getPageTitle($page, $title_cleanup = null)
+    protected function getPageTitle($page)
     {
         if (is_string($page)) {
             $page = getSimpleHTMLDOMCached($page);
         }
         $title = html_entity_decode($page->find('title', 0)->plaintext);
-        if (!empty($title)) {
-            $title = trim(str_replace($title_cleanup, '', $title));
+        return $title;
+    }
+
+    /**
+     * Clean Article title. Remove constant part that appears in every title such as blog name.
+     * @param string $title Title to clean, e.g. "Article Name | BlogName"
+     * @param string $title_cleanup string to remove from webpage title, e.g. " | BlogName"
+     * @return string Cleaned Title
+     */
+    protected function titleCleanup($title, $title_cleanup)
+    {
+        if (!empty($title) && !empty($title_cleanup)) {
+            return trim(str_replace($title_cleanup, '', $title));
         }
         return $title;
     }
@@ -270,6 +280,8 @@ class CssSelectorBridge extends BridgeAbstract
             $item['title'] = $article_title;
         }
 
+        $item['title'] = $this->titleCleanup($item['title'], $title_cleanup);
+
         $article_content = $entry_html->find($content_selector);
 
         if (!empty($article_content)) {
@@ -484,7 +496,7 @@ class CssSelectorBridge extends BridgeAbstract
                                     // Now we can check for desired field in JSON and populate $item accordingly
                                     if (isset($json_root[$field])) {
                                         $field_value = $json_root[$field];
-                                        if (is_array($field_value)) {
+                                        if (is_array($field_value) && isset($field_value[0])) {
                                             $field_value = $field_value[0]; // Different versions of the same enclosure? Take the first one
                                         }
                                         if (is_string($field_value) && !empty($field_value)) {
diff --git a/bridges/SitemapBridge.php b/bridges/SitemapBridge.php
index 482cbb66..78526e6e 100644
--- a/bridges/SitemapBridge.php
+++ b/bridges/SitemapBridge.php
@@ -73,7 +73,7 @@ class SitemapBridge extends CssSelectorBridge
         $discard_thumbnail = $this->getInput('discard_thumbnail');
         $limit = $this->getInput('limit');
 
-        $this->feedName = $this->getPageTitle($url, $title_cleanup);
+        $this->feedName = $this->titleCleanup($this->getPageTitle($url), $title_cleanup);
         $sitemap_url = empty($site_map) ? $url : $site_map;
         $sitemap_xml = $this->getSitemapXml($sitemap_url, !empty($site_map));
         $links = $this->sitemapXmlToList($sitemap_xml, $url_pattern, empty($limit) ? 10 : $limit);
@@ -103,7 +103,13 @@ class SitemapBridge extends CssSelectorBridge
             $robots_txt = getSimpleHTMLDOM(urljoin($url, '/robots.txt'))->outertext;
             preg_match('/Sitemap: ([^ ]+)/', $robots_txt, $matches);
             if (empty($matches)) {
-                returnClientError('Failed to determine Sitemap from robots.txt. Try setting it manually.');
+                $sitemap = getSimpleHTMLDOM(urljoin($url, '/sitemap.xml'));
+                if (!empty($sitemap->find('urlset, sitemap'))) {
+                    $url = urljoin($url, '/sitemap.xml');
+                    return $sitemap;
+                } else {
+                    returnClientError('Failed to locate Sitemap from /robots.txt or /sitemap.xml. Try setting it manually.');
+                }
             }
             $url = $matches[1];
         }

From 6cf9dfb7c905cac989aa17c5a694ac2fd4e35cd5 Mon Sep 17 00:00:00 2001
From: vdbhb59 <60728004+vdbhb59@users.noreply.github.com>
Date: Sat, 30 Sep 2023 13:06:48 +0000
Subject: [PATCH 142/716] Updated public hosts page & updated welcome screen
 image to the latest (#3707)

* Updated inactive hosts & rearranged alphabetically (country) wise

1. Moved rb.vern.cc as the whole domain itself is down for sometime now.
2. Sorted all instances in country wise alphabetical order for better alignment.

* Uploaded latest welcome page snap

Uploaded a current version of welcome page, which also shows "find feed from URL" functionality.

* Added a public instance I stumbled upon, home-hosted in France

Added https://rss-bridge.cheredeprince.net/ which I found to be self-hosted at home somewhere in France.

* Reverted the sorting as requested in my PR #3707

Reverted the sorting as requested in my PR #3707
---
 docs/01_General/06_Public_Hosts.md            |   7 ++++---
 docs/images/screenshot_rss-bridge_welcome.png | Bin 73267 -> 48723 bytes
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/01_General/06_Public_Hosts.md b/docs/01_General/06_Public_Hosts.md
index 531e5383..9aa292a5 100644
--- a/docs/01_General/06_Public_Hosts.md
+++ b/docs/01_General/06_Public_Hosts.md
@@ -3,6 +3,8 @@
 | Country | Address | Status |  Contact | Comment |
 |:-------:|---------|--------|----------|---------|
 | ![](https://iplookup.flagfox.net/images/h16/GB.png) | https://rss-bridge.org/bridge01 | ![](https://img.shields.io/website/https/rss-bridge.org/bridge01.svg) | [@dvikan](https://github.com/dvikan) | London, Digital Ocean|
+| ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://rssbridge.flossboxin.org.in/ | ![](https://img.shields.io/badge/website-up-brightgreen) | [@vdbhb59](https://github.com/vdbhb59) | Hosted with OVH SAS (Maintained in India) |
+| ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://rss-bridge.cheredeprince.net/ | ![](https://img.shields.io/website/https/rss-bridge.cheredeprince.net) | [@La_Bécasse](https://cheredeprince.net/contact) | Self-Hosted at home in France |
 | ![](https://iplookup.flagfox.net/images/h16/GB.png) | https://rss-bridge.lewd.tech | ![](https://img.shields.io/website/https/rss-bridge.lewd.tech.svg) | [@Erisa](https://github.com/Erisa) | Hosted in London, protected by Cloudflare Rate Limiting |
 | ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://bridge.easter.fr | ![](https://img.shields.io/website/https/bridge.easter.fr.svg) | [@chatainsim](https://github.com/chatainsim) | Hosted in Isère, France |
 | ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://wtf.roflcopter.fr/rss-bridge/ | ![](https://img.shields.io/website/https/wtf.roflcopter.fr/rss-bridge.svg) | [roflcopter.fr](https://wtf.roflcopter.fr/) | Hosted in France |
@@ -17,12 +19,11 @@
 | ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://bridge.suumitsu.eu | ![](https://img.shields.io/website/https/bridge.suumitsu.eu.svg) | [@mitsukarenai](https://github.com/mitsukarenai) | Hosted in Paris, France |
 | ![](https://iplookup.flagfox.net/images/h16/NL.png) | https://feed.eugenemolotov.ru | ![](https://img.shields.io/website/https/feed.eugenemolotov.ru.svg) | [@em92](https://github.com/em92) | Hosted in Amsterdam, Netherlands |
 | ![](https://iplookup.flagfox.net/images/h16/DE.png) | https://rss-bridge.mediani.de | ![](https://img.shields.io/website/https/rss-bridge.mediani.de.svg) | [@sokai](https://github.com/sokai) | Hosted with Netcup, Germany |
-| ![](https://iplookup.flagfox.net/images/h16/US.png) | http://rb.vern.cc/ | ![](https://img.shields.io/website/https/rb.vern.cc.svg) | [@vern.cc](https://vern.cc/en/admin) | Hosted with Hetzner, US |
-| ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://rssbridge.flossboxin.org.in/ | ![](https://img.shields.io/badge/website-up-brightgreen) | [@vdbhb59](https://github.com/vdbhb59) | Hosted with OVH SAS (Maintained in India)
-| ![](https://iplookup.flagfox.net/images/h16/PL.png) | https://rss.foxhaven.cyou| ![](https://img.shields.io/badge/website-up-brightgreen) | [@Aysilu](https://foxhaven.cyou) | Hosted with Timeweb (Maintained in Poland)
+| ![](https://iplookup.flagfox.net/images/h16/PL.png) | https://rss.foxhaven.cyou| ![](https://img.shields.io/badge/website-up-brightgreen) | [@Aysilu](https://foxhaven.cyou) | Hosted with Timeweb (Maintained in Poland) |
 
 ## Inactive instances
 
 | Country | Address | Status |  Contact | Comment |
 |:-------:|---------|--------|----------|---------|
 | ![](https://iplookup.flagfox.net/images/h16/FI.png) | https://rss-bridge.snopyta.org | ![](https://img.shields.io/website/https/rss-bridge.snopyta.org.svg) | [@Perflyst](https://github.com/Perflyst) | Hosted in Helsinki, Finland |
+| ![](https://iplookup.flagfox.net/images/h16/US.png) | http://rb.vern.cc/ | ![](https://img.shields.io/website/https/rb.vern.cc.svg) | [@vern.cc](https://vern.cc/en/admin) | Hosted with Hetzner, US |
diff --git a/docs/images/screenshot_rss-bridge_welcome.png b/docs/images/screenshot_rss-bridge_welcome.png
index 3ceb432ee2b4048be7da4643723ae5e90affcc87..9a0dcfc58dfb8d648ed58cd514ca51bdd62b310c 100644
GIT binary patch
literal 48723
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
Yy3;%?3>|)e1_A#F`eyh?IOoX!14y0yQ2+n{

literal 73267
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


From d822d666c7a770bf44dd13ef32df98a275b66c23 Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Sat, 30 Sep 2023 22:09:59 +0200
Subject: [PATCH 143/716] [prtester] improvements and fixes for prtester
 (#3721)

---
 .github/.gitignore                    |  6 +++
 .github/prtester.py                   | 54 +++++++++++++++++++--------
 .github/workflows/prhtmlgenerator.yml |  2 +
 templates/exception.html.php          |  4 +-
 4 files changed, 49 insertions(+), 17 deletions(-)
 create mode 100644 .github/.gitignore

diff --git a/.github/.gitignore b/.github/.gitignore
new file mode 100644
index 00000000..6310b3dd
--- /dev/null
+++ b/.github/.gitignore
@@ -0,0 +1,6 @@
+# Visual Studio Code
+.vscode/*
+
+# Generated files
+comment*.md
+comment*.txt
diff --git a/.github/prtester.py b/.github/prtester.py
index a2a7ab84..103ecbe6 100644
--- a/.github/prtester.py
+++ b/.github/prtester.py
@@ -1,5 +1,6 @@
 import argparse
 import requests
+import re
 from bs4 import BeautifulSoup
 from datetime import datetime
 from typing import Iterable
@@ -16,18 +17,18 @@ class Instance:
     name = ''
     url = ''
 
-def main(instances: Iterable[Instance], with_upload: bool, comment_title: str):
+def main(instances: Iterable[Instance], with_upload: bool, with_reduced_upload: bool, title: str, output_file: str):
     start_date = datetime.now()
     table_rows = []
     for instance in instances:
         page = requests.get(instance.url) # Use python requests to grab the rss-bridge main page
         soup = BeautifulSoup(page.content, "html.parser") # use bs4 to turn the page into soup
         bridge_cards = soup.select('.bridge-card') # get a soup-formatted list of all bridges on the rss-bridge page
-        table_rows += testBridges(instance, bridge_cards, with_upload) # run the main scraping code with the list of bridges and the info if this is for the current version or the pr version
-    with open(file=os.getcwd() + '/comment.txt', mode='w+', encoding='utf-8') as file:
+        table_rows += testBridges(instance, bridge_cards, with_upload, with_reduced_upload) # run the main scraping code with the list of bridges
+    with open(file=output_file, mode='w+', encoding='utf-8') as file:
         table_rows_value = '\n'.join(sorted(table_rows))
         file.write(f'''
-## {comment_title}
+## {title}
 | Bridge | Context | Status |
 | - | - | - |
 {table_rows_value}
@@ -35,7 +36,7 @@ def main(instances: Iterable[Instance], with_upload: bool, comment_title: str):
 *last change: {start_date.strftime("%A %Y-%m-%d %H:%M:%S")}*
         '''.strip())
 
-def testBridges(instance: Instance, bridge_cards: Iterable, with_upload: bool) -> Iterable:
+def testBridges(instance: Instance, bridge_cards: Iterable, with_upload: bool, with_reduced_upload: bool) -> Iterable:
     instance_suffix = ''
     if instance.name:
         instance_suffix = f' ({instance.name})'
@@ -43,7 +44,7 @@ def testBridges(instance: Instance, bridge_cards: Iterable, with_upload: bool) -
     for bridge_card in bridge_cards:
         bridgeid = bridge_card.get('id')
         bridgeid = bridgeid.split('-')[1] # this extracts a readable bridge name from the bridge metadata
-        print(f'{bridgeid}{instance_suffix}\n')
+        print(f'{bridgeid}{instance_suffix}')
         bridgestring = '/?action=display&bridge=' + bridgeid + '&format=Html'
         bridge_name = bridgeid.replace('Bridge', '')
         context_forms = bridge_card.find_all("form")
@@ -112,20 +113,26 @@ def testBridges(instance: Instance, bridge_cards: Iterable, with_upload: bool) -
                 page_text = response.text.replace('<head>','<head><base href="https://rss-bridge.org/bridge01/" target="_blank">')
                 page_text = page_text.encode("utf_8")
                 soup = BeautifulSoup(page_text, "html.parser")
-                status_messages = list(map(lambda e: f'⚠️ `{e.text.strip().splitlines()[0]}`', soup.find_all('pre')))
+                status_messages = []
                 if response.status_code != 200:
-                    status_messages = [f'❌ `HTTP status {response.status_code} {response.reason}`'] + status_messages
+                    status_messages += [f'❌ `HTTP status {response.status_code} {response.reason}`']
                 else:
                     feed_items = soup.select('.feeditem')
                     feed_items_length = len(feed_items)
                     if feed_items_length <= 0:
                         status_messages += [f'⚠️ `The feed has no items`']
                     elif feed_items_length == 1 and len(soup.select('.error')) > 0:
-                        status_messages = [f'❌ `{feed_items[0].text.strip().splitlines()[0]}`'] + status_messages
+                        status_messages += [f'❌ `{getFirstLine(feed_items[0].text)}`']
+                status_messages += map(lambda e: f'❌ `{getFirstLine(e.text)}`', soup.select('.error .error-type') + soup.select('.error .error-message'))
+                for item_element in soup.select('.feeditem'): # remove all feed items to not accidentally selected <pre> tags from item content
+                    item_element.decompose()
+                status_messages += map(lambda e: f'⚠️ `{getFirstLine(e.text)}`', soup.find_all('pre'))
+                status_messages = list(dict.fromkeys(status_messages)) # remove duplicates
                 status = '<br>'.join(status_messages)
-                if status.strip() == '':
+                status_is_ok = status == '';
+                if status_is_ok:
                     status = '✔️'
-                if with_upload:
+                if with_upload and (not with_reduced_upload or not status_is_ok):
                     termpad = requests.post(url="https://termpad.com/", data=page_text)
                     termpad_url = termpad.text.strip()
                     termpad_url = termpad_url.replace('termpad.com/','termpad.com/raw/')
@@ -133,11 +140,22 @@ def testBridges(instance: Instance, bridge_cards: Iterable, with_upload: bool) -
             form_number += 1
     return table_rows
 
+def getFirstLine(value: str) -> str:
+     # trim whitespace and remove text that can break the table or is simply unnecessary
+    clean_value = re.sub('^\[[^\]]+\]\s*rssbridge\.|[\|`]', '', value.strip())
+    first_line = next(iter(clean_value.splitlines()), '')
+    max_length = 250
+    if (len(first_line) > max_length):
+        first_line = first_line[:max_length] + '...'
+    return first_line
+
 if __name__ == '__main__':
     parser = argparse.ArgumentParser()
-    parser.add_argument('-i', '--instances', nargs='+')
-    parser.add_argument('-nu', '--no-upload', action='store_true')
-    parser.add_argument('-t', '--comment-title', default='Pull request artifacts')
+    parser.add_argument('--instances', nargs='+')
+    parser.add_argument('--no-upload', action='store_true')
+    parser.add_argument('--reduced-upload', action='store_true')
+    parser.add_argument('--title', default='Pull request artifacts')
+    parser.add_argument('--output-file', default=os.getcwd() + '/comment.txt')
     args = parser.parse_args()
     instances = []
     if args.instances:
@@ -156,4 +174,10 @@ if __name__ == '__main__':
         instance.name = 'pr'
         instance.url = 'http://localhost:3001'
         instances.append(instance)
-    main(instances=instances, with_upload=not args.no_upload, comment_title=args.comment_title);
\ No newline at end of file
+    main(
+        instances=instances,
+        with_upload=not args.no_upload,
+        with_reduced_upload=args.reduced_upload and not args.no_upload,
+        title=args.title,
+        output_file=args.output_file
+    );
\ No newline at end of file
diff --git a/.github/workflows/prhtmlgenerator.yml b/.github/workflows/prhtmlgenerator.yml
index cfedca13..7985250a 100644
--- a/.github/workflows/prhtmlgenerator.yml
+++ b/.github/workflows/prhtmlgenerator.yml
@@ -8,6 +8,8 @@ jobs:
   test-pr:
     name: Generate HTML
     runs-on: ubuntu-latest
+    env:
+      PYTHONUNBUFFERED: 1
     # Needs additional permissions https://github.com/actions/first-interaction/issues/10#issuecomment-1041402989
     steps:
       - name: Check out self
diff --git a/templates/exception.html.php b/templates/exception.html.php
index 6ea747f2..dac0ad26 100644
--- a/templates/exception.html.php
+++ b/templates/exception.html.php
@@ -60,7 +60,7 @@
     <h2>Details</h2>
 
     <div style="margin-bottom: 15px">
-        <div>
+        <div class="error-type">
             <strong>Type:</strong> <?= e(get_class($e)) ?>
         </div>
 
@@ -68,7 +68,7 @@
             <strong>Code:</strong> <?= e($e->getCode()) ?>
         </div>
 
-        <div>
+        <div class="error-message">
             <strong>Message:</strong> <?= e(sanitize_root($e->getMessage())) ?>
         </div>
 

From 7273a05f02a1be053c5c5ecfc10cbea0da06cf18 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 1 Oct 2023 18:53:50 +0200
Subject: [PATCH 144/716] fix: google play and tiktok (#3722)

* fix(googleplay)

* fix(tiktok)
---
 bridges/GooglePlayStoreBridge.php | 32 ++++++++++++-------------------
 bridges/TikTokBridge.php          |  4 ++++
 lib/RssBridge.php                 |  3 ---
 3 files changed, 16 insertions(+), 23 deletions(-)

diff --git a/bridges/GooglePlayStoreBridge.php b/bridges/GooglePlayStoreBridge.php
index d61be2c8..86343520 100644
--- a/bridges/GooglePlayStoreBridge.php
+++ b/bridges/GooglePlayStoreBridge.php
@@ -21,30 +21,22 @@ class GooglePlayStoreBridge extends BridgeAbstract
         ]
     ]];
 
-    const INFORMATION_MAP = [
-        'Updated' => 'timestamp',
-        'Current Version' => 'title',
-        'Offered By' => 'author'
-    ];
-
     public function collectData()
     {
-        $appuri = static::URI . '/details?id=' . $this->getInput('id');
-        $html = getSimpleHTMLDOM($appuri);
+        $id = $this->getInput('id');
+        $url = 'https://play.google.com/store/apps/details?id=' . $id;
+        $html = getSimpleHTMLDOM($url);
+
+        $updatedAtElement = $html->find('div.TKjAsc div', 2);
+        // Updated onSep 27, 2023
+        $updatedAt = $updatedAtElement->plaintext;
+        $description = $html->find('div.bARER', 0);
 
         $item = [];
-        $item['uri'] = $appuri;
-        $item['content'] = $html->find('div[itemprop=description]', 1)->innertext;
-
-        // Find other fields from Additional Information section
-        foreach ($html->find('.hAyfc') as $info) {
-            $index = self::INFORMATION_MAP[$info->first_child()->plaintext] ?? null;
-            if (is_null($index)) {
-                continue;
-            }
-            $item[$index] = $info->children(1)->plaintext;
-        }
-
+        $item['uri'] = $url;
+        $item['title'] = $id . ' ' . $updatedAt;
+        $item['content'] = $description->innertext ?? '';
+        $item['uid'] = 'GooglePlayStoreBridge/' . $updatedAt;
         $this->items[] = $item;
     }
 
diff --git a/bridges/TikTokBridge.php b/bridges/TikTokBridge.php
index 769bc625..73a18b04 100644
--- a/bridges/TikTokBridge.php
+++ b/bridges/TikTokBridge.php
@@ -40,6 +40,10 @@ class TikTokBridge extends BridgeAbstract
         $SIGI_STATE_RAW = $var->innertext;
         $SIGI_STATE = Json::decode($SIGI_STATE_RAW, false);
 
+        if (!isset($SIGI_STATE->ItemModule)) {
+            return;
+        }
+
         foreach ($SIGI_STATE->ItemModule as $key => $value) {
             $item = [];
 
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index 6ba952eb..2fb21323 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -39,9 +39,6 @@ final class RssBridge
                 $line
             );
             self::$logger->warning($text);
-            if (Debug::isEnabled()) {
-                print sprintf("<pre>%s</pre>\n", e($text));
-            }
         });
 
         // There might be some fatal errors which are not caught by set_error_handler() or \Throwable.

From 0c92cf32d471cc0722727b7cd40779882f7b923a Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Sun, 1 Oct 2023 19:00:13 +0200
Subject: [PATCH 145/716] [ImgsedBridge] Fix and improvements (#3710)

* [ImgsedBridge] Fix and improvements

- Display an error if the user doesn't select at least an content type
  to display
- Unsplit the regular expression to make the URL of imgsed.com work too
- Remove the "hour part" of the publication date : the website shows
  only the number of days if the content is older than one day

* [ImgsedBridge] Fix and improvements

Fix syntax

* [ImgsedBridge] Fix and improvements

- Fix TEST_DETECT_PARAMETERS
- change detectParameters regular expression to match more instagram.com
  URLs

* [ImgsedBridge] Fix and improvements

- Fix date parsing for interval 'a day'

* lint

---------

Co-authored-by: Dag <me@dvikan.no>
---
 bridges/ImgsedBridge.php | 26 ++++++++++++++++++++++----
 1 file changed, 22 insertions(+), 4 deletions(-)

diff --git a/bridges/ImgsedBridge.php b/bridges/ImgsedBridge.php
index 1fa5b827..b6385361 100644
--- a/bridges/ImgsedBridge.php
+++ b/bridges/ImgsedBridge.php
@@ -36,6 +36,12 @@ class ImgsedBridge extends BridgeAbstract
             ],
         ]
     ];
+    const TEST_DETECT_PARAMETERS = [
+        'https://www.instagram.com/instagram/' => ['context' => 'Username', 'u' => 'instagram', 'post' => 'on', 'story' => 'on', 'tagged' => 'on'],
+        'https://instagram.com/instagram/' => ['context' => 'Username', 'u' => 'instagram', 'post' => 'on', 'story' => 'on', 'tagged' => 'on'],
+        'https://imgsed.com/instagram/' => ['context' => 'Username', 'u' => 'instagram', 'post' => 'on', 'story' => 'on', 'tagged' => 'on'],
+        'https://www.imgsed.com/instagram/' => ['context' => 'Username', 'u' => 'instagram', 'post' => 'on', 'story' => 'on', 'tagged' => 'on'],
+    ];
 
     public function getURI()
     {
@@ -213,9 +219,16 @@ HTML,
     {
         $date = date_create();
         $dateString = str_replace(' ago', '', $content);
+        // Special case : 'a day' is not a valid interval in PHP, so replace it with it's PHP equivalenbt : '1 day'
+        if ($dateString == 'a day') {
+            $dateString = '1 day';
+        }
+
         $relativeDate = date_interval_create_from_date_string($dateString);
         if ($relativeDate) {
             date_sub($date, $relativeDate);
+            // As the relative interval has the precision of a day for date older than 24 hours, we can remove the hour of the date, as it is not relevant
+            date_time_set($date, 0, 0, 0, 0);
         } else {
             $this->logger->info(sprintf('Unable to parse date string: %s', $dateString));
         }
@@ -244,7 +257,13 @@ HTML,
             if ($this->getInput('tagged')) {
                 $types[] = 'Tags';
             }
+
+            // If no content type is selected, this bridge does nothing, so we return an error
+            if (count($types) == 0) {
+                returnClientError('You must select at least one of the content type : Post, Stories or Tags !');
+            }
             $typesText = $types[0] ?? '';
+
             if (count($types) > 1) {
                 for ($i = 1; $i < count($types) - 1; $i++) {
                     $typesText .= ', ' . $types[$i];
@@ -262,10 +281,9 @@ HTML,
         $params = [
             'post' => 'on',
             'story' => 'on',
-            'tagged' => 'on'
+            'tagged' => 'on',
         ];
-        $regex = '/^http(s|):\/\/((www\.|)(instagram.com)\/([a-zA-Z0-9_\.]{1,30})\/(reels\/|tagged\/|)
-|(www\.|)(imgsed.com)\/(stories\/|tagged\/|)([a-zA-Z0-9_\.]{1,30})\/)/';
+        $regex = '/^http(s|):\/\/((www\.|)(instagram.com)\/([a-zA-Z0-9_\.]{1,30})(\/reels\/|\/tagged\/|\/|)|(www\.|)(imgsed.com)\/(stories\/|tagged\/|)([a-zA-Z0-9_\.]{1,30})\/)/';
         if (preg_match($regex, $url, $matches) > 0) {
             $params['context'] = 'Username';
             // Extract detected domain using the regex
@@ -273,7 +291,7 @@ HTML,
             if ($domain == 'imgsed.com') {
                 $params['u'] = $matches[10];
                 return $params;
-            } else if ($domain == 'instagram.com') {
+            } elseif ($domain == 'instagram.com') {
                 $params['u'] = $matches[5];
                 return $params;
             } else {

From 41df17bc464832118a767ceff6c9217071699783 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 1 Oct 2023 19:23:30 +0200
Subject: [PATCH 146/716] refactor (#3712)

* test: refactor test suite

* docs

* refactor

* yup

* docs
---
 README.md                                     |   2 +
 actions/ConnectivityAction.php                |  12 -
 actions/DetectAction.php                      |  12 -
 actions/DisplayAction.php                     |   4 +-
 actions/ListAction.php                        |  28 +-
 actions/SetBridgeCacheAction.php              |  12 -
 bridges/DemoBridge.php                        |   2 +-
 lib/ApiAuthenticationMiddleware.php           |  12 -
 lib/AuthenticationMiddleware.php              |  12 -
 lib/BridgeAbstract.php                        | 162 +++++------
 lib/BridgeCard.php                            |  20 --
 lib/BridgeFactory.php                         |   8 +-
 lib/Configuration.php                         |  12 -
 lib/FeedExpander.php                          |  12 -
 lib/FormatFactory.php                         |  12 -
 lib/ParameterValidator.php                    | 272 +++++++-----------
 lib/bootstrap.php                             |  14 +-
 lib/http.php                                  |   6 +-
 lib/php8backports.php                         |  34 ---
 .../BridgeImplementationTest.php              | 103 ++++---
 tests/CacheImplementationTest.php             |  36 +++
 tests/Caches/CacheImplementationTest.php      |  48 ----
 tests/ParameterValidatorTest.php              |  40 +++
 23 files changed, 309 insertions(+), 566 deletions(-)
 rename tests/{Bridges => }/BridgeImplementationTest.php (65%)
 create mode 100644 tests/CacheImplementationTest.php
 delete mode 100644 tests/Caches/CacheImplementationTest.php
 create mode 100644 tests/ParameterValidatorTest.php

diff --git a/README.md b/README.md
index a1e5fdc7..7037095e 100644
--- a/README.md
+++ b/README.md
@@ -248,6 +248,8 @@ Modify `report_limit` so that an error must occur 3 times before it is reported.
     ; Defines how often an error must occur before it is reported to the user
     report_limit = 3
 
+The report count is reset to 0 each day.
+
 ### How to password-protect the instance
 
 HTTP basic access authentication:
diff --git a/actions/ConnectivityAction.php b/actions/ConnectivityAction.php
index cfffd195..1568333a 100644
--- a/actions/ConnectivityAction.php
+++ b/actions/ConnectivityAction.php
@@ -1,17 +1,5 @@
 <?php
 
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
 /**
  * Checks if the website for a given bridge is reachable.
  *
diff --git a/actions/DetectAction.php b/actions/DetectAction.php
index 49b7ced7..bbacde38 100644
--- a/actions/DetectAction.php
+++ b/actions/DetectAction.php
@@ -1,17 +1,5 @@
 <?php
 
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
 class DetectAction implements ActionInterface
 {
     public function execute(array $request)
diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 8c9dd057..e3b25fef 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -101,8 +101,8 @@ class DisplayAction implements ActionInterface
         try {
             $bridge->loadConfiguration();
             // Remove parameters that don't concern bridges
-            $bridgeData = array_diff_key($request, array_fill_keys(['action', 'bridge', 'format', '_noproxy', '_cache_timeout', '_error_time'], ''));
-            $bridge->setDatas($bridgeData);
+            $input = array_diff_key($request, array_fill_keys(['action', 'bridge', 'format', '_noproxy', '_cache_timeout', '_error_time'], ''));
+            $bridge->setInput($input);
             $bridge->collectData();
             $items = $bridge->getItems();
             if (isset($items[0]) && is_array($items[0])) {
diff --git a/actions/ListAction.php b/actions/ListAction.php
index 9025bf6e..19bb4d37 100644
--- a/actions/ListAction.php
+++ b/actions/ListAction.php
@@ -1,17 +1,5 @@
 <?php
 
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
 class ListAction implements ActionInterface
 {
     public function execute(array $request)
@@ -26,14 +14,14 @@ class ListAction implements ActionInterface
             $bridge = $bridgeFactory->create($bridgeClassName);
 
             $list->bridges[$bridgeClassName] = [
-                'status' => $bridgeFactory->isEnabled($bridgeClassName) ? 'active' : 'inactive',
-                'uri' => $bridge->getURI(),
-                'donationUri' => $bridge->getDonationURI(),
-                'name' => $bridge->getName(),
-                'icon' => $bridge->getIcon(),
-                'parameters' => $bridge->getParameters(),
-                'maintainer' => $bridge->getMaintainer(),
-                'description' => $bridge->getDescription()
+                'status'        => $bridgeFactory->isEnabled($bridgeClassName) ? 'active' : 'inactive',
+                'uri'           => $bridge->getURI(),
+                'donationUri'   => $bridge->getDonationURI(),
+                'name'          => $bridge->getName(),
+                'icon'          => $bridge->getIcon(),
+                'parameters'    => $bridge->getParameters(),
+                'maintainer'    => $bridge->getMaintainer(),
+                'description'   => $bridge->getDescription()
             ];
         }
         $list->total = count($list->bridges);
diff --git a/actions/SetBridgeCacheAction.php b/actions/SetBridgeCacheAction.php
index c9264a27..2e9d7147 100644
--- a/actions/SetBridgeCacheAction.php
+++ b/actions/SetBridgeCacheAction.php
@@ -1,17 +1,5 @@
 <?php
 
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
 class SetBridgeCacheAction implements ActionInterface
 {
     private CacheInterface $cache;
diff --git a/bridges/DemoBridge.php b/bridges/DemoBridge.php
index 15ab7377..18582aa6 100644
--- a/bridges/DemoBridge.php
+++ b/bridges/DemoBridge.php
@@ -4,7 +4,7 @@ class DemoBridge extends BridgeAbstract
 {
     const MAINTAINER = 'teromene';
     const NAME = 'DemoBridge';
-    const URI = 'http://github.com/rss-bridge/rss-bridge';
+    const URI = 'https://github.com/rss-bridge/rss-bridge';
     const DESCRIPTION = 'Bridge used for demos';
     const CACHE_TIMEOUT = 15;
 
diff --git a/lib/ApiAuthenticationMiddleware.php b/lib/ApiAuthenticationMiddleware.php
index 6a59e760..62886314 100644
--- a/lib/ApiAuthenticationMiddleware.php
+++ b/lib/ApiAuthenticationMiddleware.php
@@ -1,17 +1,5 @@
 <?php
 
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
 final class ApiAuthenticationMiddleware
 {
     public function __invoke($request): void
diff --git a/lib/AuthenticationMiddleware.php b/lib/AuthenticationMiddleware.php
index 8c2f6b29..a91420f8 100644
--- a/lib/AuthenticationMiddleware.php
+++ b/lib/AuthenticationMiddleware.php
@@ -1,17 +1,5 @@
 <?php
 
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
 final class AuthenticationMiddleware
 {
     public function __construct()
diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index e074ce74..a7b811a8 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -90,17 +90,70 @@ abstract class BridgeAbstract
         return static::CACHE_TIMEOUT;
     }
 
-    /**
-     * Sets the input values for a given context.
-     *
-     * @param array $inputs Associative array of inputs
-     * @param string $queriedContext The context name
-     * @return void
-     */
-    protected function setInputs(array $inputs, $queriedContext)
+    public function loadConfiguration()
+    {
+        foreach (static::CONFIGURATION as $optionName => $optionValue) {
+            $section = $this->getShortName();
+            $configurationOption = Configuration::getConfig($section, $optionName);
+
+            if ($configurationOption !== null) {
+                $this->configuration[$optionName] = $configurationOption;
+                continue;
+            }
+
+            if (isset($optionValue['required']) && $optionValue['required'] === true) {
+                throw new \Exception(sprintf('Missing configuration option: %s', $optionName));
+            } elseif (isset($optionValue['defaultValue'])) {
+                $this->configuration[$optionName] = $optionValue['defaultValue'];
+            }
+        }
+    }
+
+    public function setInput(array $input)
+    {
+        $context = $input['context'] ?? null;
+        if ($context) {
+            // Context hinting (optional)
+            $this->queriedContext = $context;
+            unset($input['context']);
+        }
+
+        $parameters = $this->getParameters();
+
+        if (!$parameters) {
+            if ($input) {
+                throw new \Exception('Invalid parameters value(s)');
+            }
+            return;
+        }
+
+        $validator = new ParameterValidator();
+
+        // $input is passed by reference!
+        if (!$validator->validateInput($input, $parameters)) {
+            $invalidParameterKeys = array_column($validator->getInvalidParameters(), 'name');
+            throw new \Exception(sprintf('Invalid parameters value(s): %s', implode(', ', $invalidParameterKeys)));
+        }
+
+        // Guess the context from input data
+        if (empty($this->queriedContext)) {
+            $queriedContext = $validator->getQueriedContext($input, $parameters);
+            $this->queriedContext = $queriedContext;
+        }
+
+        if (is_null($this->queriedContext)) {
+            throw new \Exception('Required parameter(s) missing');
+        } elseif ($this->queriedContext === false) {
+            throw new \Exception('Mixed context parameters');
+        }
+
+        $this->setInputWithContext($input, $this->queriedContext);
+    }
+
+    private function setInputWithContext(array $input, $queriedContext)
     {
         // Import and assign all inputs to their context
-        foreach ($inputs as $name => $value) {
+        foreach ($input as $name => $value) {
             foreach (static::PARAMETERS as $context => $set) {
                 if (array_key_exists($name, static::PARAMETERS[$context])) {
                     $this->inputs[$context][$name]['value'] = $value;
@@ -128,7 +181,7 @@ abstract class BridgeAbstract
 
                 switch ($type) {
                     case 'checkbox':
-                        $this->inputs[$context][$name]['value'] = $inputs[$context][$name]['value'] ?? false;
+                        $this->inputs[$context][$name]['value'] = $input[$context][$name]['value'] ?? false;
                         break;
                     case 'list':
                         if (!isset($properties['defaultValue'])) {
@@ -153,8 +206,8 @@ abstract class BridgeAbstract
         // Copy global parameter values to the guessed context
         if (array_key_exists('global', static::PARAMETERS)) {
             foreach (static::PARAMETERS['global'] as $name => $properties) {
-                if (isset($inputs[$name])) {
-                    $value = $inputs[$name];
+                if (isset($input[$name])) {
+                    $value = $input[$name];
                 } else {
                     if ($properties['type'] ?? null === 'checkbox') {
                         $value = false;
@@ -176,91 +229,6 @@ abstract class BridgeAbstract
         }
     }
 
-    /**
-     * Set inputs for the bridge
-     *
-     * Returns errors and aborts execution if the provided input parameters are
-     * invalid.
-     *
-     * @param array List of input parameters. Each element in this list must
-     * relate to an item in {@see BridgeAbstract::PARAMETERS}
-     * @return void
-     */
-    public function setDatas(array $inputs)
-    {
-        if (isset($inputs['context'])) { // Context hinting (optional)
-            $this->queriedContext = $inputs['context'];
-            unset($inputs['context']);
-        }
-
-        if (empty(static::PARAMETERS)) {
-            if (!empty($inputs)) {
-                throw new \Exception('Invalid parameters value(s)');
-            }
-
-            return;
-        }
-
-        $validator = new ParameterValidator();
-
-        if (!$validator->validateData($inputs, static::PARAMETERS)) {
-            $parameters = array_map(
-                function ($i) {
-                    return $i['name'];
-                }, // Just display parameter names
-                $validator->getInvalidParameters()
-            );
-
-            throw new \Exception(sprintf('Invalid parameters value(s): %s', implode(', ', $parameters)));
-        }
-
-        // Guess the context from input data
-        if (empty($this->queriedContext)) {
-            $this->queriedContext = $validator->getQueriedContext($inputs, static::PARAMETERS);
-        }
-
-        if (is_null($this->queriedContext)) {
-            throw new \Exception('Required parameter(s) missing');
-        } elseif ($this->queriedContext === false) {
-            throw new \Exception('Mixed context parameters');
-        }
-
-        $this->setInputs($inputs, $this->queriedContext);
-    }
-
-    /**
-     * Loads configuration for the bridge
-     *
-     * Returns errors and aborts execution if the provided configuration is
-     * invalid.
-     *
-     * @return void
-     */
-    public function loadConfiguration()
-    {
-        foreach (static::CONFIGURATION as $optionName => $optionValue) {
-            $section = $this->getShortName();
-            $configurationOption = Configuration::getConfig($section, $optionName);
-
-            if ($configurationOption !== null) {
-                $this->configuration[$optionName] = $configurationOption;
-                continue;
-            }
-
-            if (isset($optionValue['required']) && $optionValue['required'] === true) {
-                throw new \Exception(sprintf('Missing configuration option: %s', $optionName));
-            } elseif (isset($optionValue['defaultValue'])) {
-                $this->configuration[$optionName] = $optionValue['defaultValue'];
-            }
-        }
-    }
-
-    /**
-     * Returns the value for the provided input
-     *
-     * @param string $input The input name
-     * @return mixed|null The input value or null if the input is not defined
-     */
     protected function getInput($input)
     {
         return $this->inputs[$this->queriedContext][$input]['value'] ?? null;
diff --git a/lib/BridgeCard.php b/lib/BridgeCard.php
index 99c44fff..b2fda192 100644
--- a/lib/BridgeCard.php
+++ b/lib/BridgeCard.php
@@ -1,25 +1,5 @@
 <?php
 
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
-/**
- * A generator class for a single bridge card on the home page of RSS-Bridge.
- *
- * This class generates the HTML content for a single bridge card for the home
- * page of RSS-Bridge.
- *
- * @todo Return error if a caller creates an object of this class.
- */
 final class BridgeCard
 {
     /**
diff --git a/lib/BridgeFactory.php b/lib/BridgeFactory.php
index c3da4bfe..ad433287 100644
--- a/lib/BridgeFactory.php
+++ b/lib/BridgeFactory.php
@@ -4,9 +4,9 @@ final class BridgeFactory
 {
     private CacheInterface $cache;
     private Logger $logger;
-    private $bridgeClassNames = [];
-    private $enabledBridges = [];
-    private $missingEnabledBridges = [];
+    private array $bridgeClassNames = [];
+    private array $enabledBridges = [];
+    private array $missingEnabledBridges = [];
 
     public function __construct()
     {
@@ -22,7 +22,7 @@ final class BridgeFactory
 
         $enabledBridges = Configuration::getConfig('system', 'enabled_bridges');
         if ($enabledBridges === null) {
-            throw new \Exception('No bridges are enabled... wtf?');
+            throw new \Exception('No bridges are enabled...');
         }
         foreach ($enabledBridges as $enabledBridge) {
             if ($enabledBridge === '*') {
diff --git a/lib/Configuration.php b/lib/Configuration.php
index c38d7cc9..d699178f 100644
--- a/lib/Configuration.php
+++ b/lib/Configuration.php
@@ -1,17 +1,5 @@
 <?php
 
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
 /**
  * Configuration module for RSS-Bridge.
  *
diff --git a/lib/FeedExpander.php b/lib/FeedExpander.php
index 14c931e6..76f570b6 100644
--- a/lib/FeedExpander.php
+++ b/lib/FeedExpander.php
@@ -1,17 +1,5 @@
 <?php
 
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
 /**
  * An abstract class for bridges that need to transform existing RSS or Atom
  * feeds.
diff --git a/lib/FormatFactory.php b/lib/FormatFactory.php
index 9cded40f..042dcf31 100644
--- a/lib/FormatFactory.php
+++ b/lib/FormatFactory.php
@@ -1,17 +1,5 @@
 <?php
 
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
 class FormatFactory
 {
     private $folder;
diff --git a/lib/ParameterValidator.php b/lib/ParameterValidator.php
index 31934432..e8de754c 100644
--- a/lib/ParameterValidator.php
+++ b/lib/ParameterValidator.php
@@ -1,154 +1,21 @@
 <?php
 
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
-/**
- * Validator for bridge parameters
- */
 class ParameterValidator
 {
-    /**
-     * Holds the list of invalid parameters
-     *
-     * @var array
-     */
-    private $invalid = [];
+    private array $invalid = [];
 
     /**
-     * Add item to list of invalid parameters
+     * Check that inputs are actually present in the bridge parameters.
      *
-     * @param string $name The name of the parameter
-     * @param string $reason The reason for that parameter being invalid
-     * @return void
+     * Also check whether input values are allowed.
      */
-    private function addInvalidParameter($name, $reason)
+    public function validateInput(&$input, $parameters): bool
     {
-        $this->invalid[] = [
-            'name' => $name,
-            'reason' => $reason,
-        ];
-    }
-
-    /**
-     * Return list of invalid parameters.
-     *
-     * Each element is an array of 'name' and 'reason'.
-     *
-     * @return array List of invalid parameters
-     */
-    public function getInvalidParameters()
-    {
-        return $this->invalid;
-    }
-
-    /**
-     * Validate value for a text input
-     *
-     * @param string $value The value of a text input
-     * @param string|null $pattern (optional) A regex pattern
-     * @return string|null The filtered value or null if the value is invalid
-     */
-    private function validateTextValue($value, $pattern = null)
-    {
-        if (!is_null($pattern)) {
-            $filteredValue = filter_var(
-                $value,
-                FILTER_VALIDATE_REGEXP,
-                ['options' => [
-                    'regexp' => '/^' . $pattern . '$/'
-                ]
-                ]
-            );
-        } else {
-            $filteredValue = filter_var($value);
-        }
-
-        if ($filteredValue === false) {
-            return null;
-        }
-
-        return $filteredValue;
-    }
-
-    /**
-     * Validate value for a number input
-     *
-     * @param int $value The value of a number input
-     * @return int|null The filtered value or null if the value is invalid
-     */
-    private function validateNumberValue($value)
-    {
-        $filteredValue = filter_var($value, FILTER_VALIDATE_INT);
-
-        if ($filteredValue === false) {
-            return null;
-        }
-
-        return $filteredValue;
-    }
-
-    /**
-     * Validate value for a checkbox
-     *
-     * @param bool $value The value of a checkbox
-     * @return bool The filtered value
-     */
-    private function validateCheckboxValue($value)
-    {
-        return filter_var($value, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE);
-    }
-
-    /**
-     * Validate value for a list
-     *
-     * @param string $value The value of a list
-     * @param array $expectedValues A list of expected values
-     * @return string|null The filtered value or null if the value is invalid
-     */
-    private function validateListValue($value, $expectedValues)
-    {
-        $filteredValue = filter_var($value);
-
-        if ($filteredValue === false) {
-            return null;
-        }
-
-        if (!in_array($filteredValue, $expectedValues)) { // Check sub-values?
-            foreach ($expectedValues as $subName => $subValue) {
-                if (is_array($subValue) && in_array($filteredValue, $subValue)) {
-                    return $filteredValue;
-                }
-            }
-            return null;
-        }
-
-        return $filteredValue;
-    }
-
-    /**
-     * Check if all required parameters are satisfied
-     *
-     * @param array $data (ref) A list of input values
-     * @param array $parameters The bridge parameters
-     * @return bool True if all parameters are satisfied
-     */
-    public function validateData(&$data, $parameters)
-    {
-        if (!is_array($data)) {
+        if (!is_array($input)) {
             return false;
         }
 
-        foreach ($data as $name => $value) {
+        foreach ($input as $name => $value) {
             // Some RSS readers add a cache-busting parameter (_=<timestamp>) to feed URLs, detect and ignore them.
             if ($name === '_') {
                 continue;
@@ -156,54 +23,60 @@ class ParameterValidator
 
             $registered = false;
             foreach ($parameters as $context => $set) {
-                if (array_key_exists($name, $set)) {
-                    $registered = true;
-                    if (!isset($set[$name]['type'])) {
-                        $set[$name]['type'] = 'text';
-                    }
+                if (!array_key_exists($name, $set)) {
+                    continue;
+                }
+                $registered = true;
+                if (!isset($set[$name]['type'])) {
+                    // Default type is text
+                    $set[$name]['type'] = 'text';
+                }
 
-                    switch ($set[$name]['type']) {
-                        case 'number':
-                            $data[$name] = $this->validateNumberValue($value);
-                            break;
-                        case 'checkbox':
-                            $data[$name] = $this->validateCheckboxValue($value);
-                            break;
-                        case 'list':
-                            $data[$name] = $this->validateListValue($value, $set[$name]['values']);
-                            break;
-                        default:
-                        case 'text':
-                            if (isset($set[$name]['pattern'])) {
-                                $data[$name] = $this->validateTextValue($value, $set[$name]['pattern']);
-                            } else {
-                                $data[$name] = $this->validateTextValue($value);
-                            }
-                            break;
-                    }
+                switch ($set[$name]['type']) {
+                    case 'number':
+                        $input[$name] = $this->validateNumberValue($value);
+                        break;
+                    case 'checkbox':
+                        $input[$name] = $this->validateCheckboxValue($value);
+                        break;
+                    case 'list':
+                        $input[$name] = $this->validateListValue($value, $set[$name]['values']);
+                        break;
+                    default:
+                    case 'text':
+                        if (isset($set[$name]['pattern'])) {
+                            $input[$name] = $this->validateTextValue($value, $set[$name]['pattern']);
+                        } else {
+                            $input[$name] = $this->validateTextValue($value);
+                        }
+                        break;
+                }
 
-                    if (is_null($data[$name]) && isset($set[$name]['required']) && $set[$name]['required']) {
-                        $this->addInvalidParameter($name, 'Parameter is invalid!');
-                    }
+                if (
+                    is_null($input[$name])
+                    && isset($set[$name]['required'])
+                    && $set[$name]['required']
+                ) {
+                    $this->invalid[] = ['name' => $name, 'reason' => 'Parameter is invalid!'];
                 }
             }
 
             if (!$registered) {
-                $this->addInvalidParameter($name, 'Parameter is not registered!');
+                $this->invalid[] = ['name' => $name, 'reason' => 'Parameter is not registered!'];
             }
         }
 
-        return empty($this->invalid);
+        return $this->invalid === [];
     }
 
     /**
      * Get the name of the context matching the provided inputs
      *
-     * @param array $data Associative array of user data
+     * @param array $input Associative array of user data
      * @param array $parameters Array of bridge parameters
      * @return string|null Returns the context name or null if no match was found
      */
-    public function getQueriedContext($data, $parameters)
+    public function getQueriedContext($input, $parameters)
     {
         $queriedContexts = [];
 
@@ -212,7 +85,7 @@ class ParameterValidator
             $queriedContexts[$context] = null;
 
             // Ensure all user data exist in the current context
-            $notInContext = array_diff_key($data, $set);
+            $notInContext = array_diff_key($input, $set);
             if (array_key_exists('global', $parameters)) {
                 $notInContext = array_diff_key($notInContext, $parameters['global']);
             }
@@ -222,7 +95,7 @@ class ParameterValidator
 
             // Check if all parameters of the context are satisfied
             foreach ($set as $id => $properties) {
-                if (isset($data[$id]) && !empty($data[$id])) {
+                if (isset($input[$id]) && !empty($input[$id])) {
                     $queriedContexts[$context] = true;
                 } elseif (
                     isset($properties['type'])
@@ -248,8 +121,8 @@ class ParameterValidator
         switch (array_sum($queriedContexts)) {
             case 0:
                 // Found no match, is there a context without parameters?
-                if (isset($data['context'])) {
-                    return $data['context'];
+                if (isset($input['context'])) {
+                    return $input['context'];
                 }
                 foreach ($queriedContexts as $context => $queried) {
                     if (is_null($queried)) {
@@ -264,4 +137,55 @@ class ParameterValidator
                 return false;
         }
     }
+
+    public function getInvalidParameters(): array
+    {
+        return $this->invalid;
+    }
+
+    private function validateTextValue($value, $pattern = null)
+    {
+        if (is_null($pattern)) {
+            // No filtering taking place
+            $filteredValue = filter_var($value);
+        } else {
+            $filteredValue = filter_var($value, FILTER_VALIDATE_REGEXP, ['options' => ['regexp' => '/^' . $pattern . '$/']]);
+        }
+        if ($filteredValue === false) {
+            return null;
+        }
+        return $filteredValue;
+    }
+
+    private function validateNumberValue($value)
+    {
+        $filteredValue = filter_var($value, FILTER_VALIDATE_INT);
+        if ($filteredValue === false) {
+            return null;
+        }
+        return $filteredValue;
+    }
+
+    private function validateCheckboxValue($value)
+    {
+        return filter_var($value, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE);
+    }
+
+    private function validateListValue($value, $expectedValues)
+    {
+        $filteredValue = filter_var($value);
+        if ($filteredValue === false) {
+            return null;
+        }
+        if (!in_array($filteredValue, $expectedValues)) {
+            // Check sub-values?
+            foreach ($expectedValues as $subName => $subValue) {
+                if (is_array($subValue) && in_array($filteredValue, $subValue)) {
+                    return $filteredValue;
+                }
+            }
+            return null;
+        }
+        return $filteredValue;
+    }
 }
diff --git a/lib/bootstrap.php b/lib/bootstrap.php
index bc584541..a95de9dd 100644
--- a/lib/bootstrap.php
+++ b/lib/bootstrap.php
@@ -1,18 +1,6 @@
 <?php
 
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
-/** Path to the formats library */
+// Path to the formats library
 const PATH_LIB_FORMATS = __DIR__ . '/../formats/';
 
 /** Path to the caches library */
diff --git a/lib/http.php b/lib/http.php
index 10ce86c9..3d65b2d1 100644
--- a/lib/http.php
+++ b/lib/http.php
@@ -211,12 +211,12 @@ final class Response
         }
     }
 
-    public function getBody()
+    public function getBody(): string
     {
         return $this->body;
     }
 
-    public function getCode()
+    public function getCode(): int
     {
         return $this->code;
     }
@@ -226,7 +226,7 @@ final class Response
         return self::STATUS_CODES[$this->code] ?? '';
     }
 
-    public function getHeaders()
+    public function getHeaders(): array
     {
         return $this->headers;
     }
diff --git a/lib/php8backports.php b/lib/php8backports.php
index 5b103e3d..ccef6016 100644
--- a/lib/php8backports.php
+++ b/lib/php8backports.php
@@ -1,39 +1,5 @@
 <?php
 
-/**
- * This file is part of RSS-Bridge, a PHP project capable of generating RSS and
- * Atom feeds for websites that don't have one.
- *
- * For the full license information, please view the UNLICENSE file distributed
- * with this source code.
- *
- * @package Core
- * @license http://unlicense.org/ UNLICENSE
- * @link    https://github.com/rss-bridge/rss-bridge
- */
-
-// based on https://github.com/laravel/framework/blob/8.x/src/Illuminate/Support/Str.php
-//
-// Copyright (c) Taylor Otwell
-//
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is furnished
-// to do so, subject to the following conditions:
-//
-// The above copyright notice and this permission notice shall be included in all
-// copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
-
 if (!function_exists('str_starts_with')) {
     function str_starts_with($haystack, $needle)
     {
diff --git a/tests/Bridges/BridgeImplementationTest.php b/tests/BridgeImplementationTest.php
similarity index 65%
rename from tests/Bridges/BridgeImplementationTest.php
rename to tests/BridgeImplementationTest.php
index af9d7db1..d2f74931 100644
--- a/tests/Bridges/BridgeImplementationTest.php
+++ b/tests/BridgeImplementationTest.php
@@ -1,6 +1,6 @@
 <?php
 
-namespace RssBridge\Tests\Bridges;
+namespace RssBridge\Tests;
 
 use BridgeAbstract;
 use FeedExpander;
@@ -8,8 +8,8 @@ use PHPUnit\Framework\TestCase;
 
 class BridgeImplementationTest extends TestCase
 {
-    private $class;
-    private $obj;
+    private string $className;
+    private BridgeAbstract $bridge;
 
     /**
      * @dataProvider dataBridgesProvider
@@ -17,9 +17,9 @@ class BridgeImplementationTest extends TestCase
     public function testClassName($path)
     {
         $this->setBridge($path);
-        $this->assertTrue($this->class === ucfirst($this->class), 'class name must start with uppercase character');
-        $this->assertEquals(0, substr_count($this->class, ' '), 'class name must not contain spaces');
-        $this->assertStringEndsWith('Bridge', $this->class, 'class name must end with "Bridge"');
+        $this->assertTrue($this->className === ucfirst($this->className), 'class name must start with uppercase character');
+        $this->assertEquals(0, substr_count($this->className, ' '), 'class name must not contain spaces');
+        $this->assertStringEndsWith('Bridge', $this->className, 'class name must end with "Bridge"');
     }
 
     /**
@@ -28,7 +28,7 @@ class BridgeImplementationTest extends TestCase
     public function testClassType($path)
     {
         $this->setBridge($path);
-        $this->assertInstanceOf(BridgeAbstract::class, $this->obj);
+        $this->assertInstanceOf(BridgeAbstract::class, $this->bridge);
     }
 
     /**
@@ -38,18 +38,18 @@ class BridgeImplementationTest extends TestCase
     {
         $this->setBridge($path);
 
-        $this->assertIsString($this->obj::NAME, 'class::NAME');
-        $this->assertNotEmpty($this->obj::NAME, 'class::NAME');
-        $this->assertIsString($this->obj::URI, 'class::URI');
-        $this->assertNotEmpty($this->obj::URI, 'class::URI');
-        $this->assertIsString($this->obj::DESCRIPTION, 'class::DESCRIPTION');
-        $this->assertNotEmpty($this->obj::DESCRIPTION, 'class::DESCRIPTION');
-        $this->assertIsString($this->obj::MAINTAINER, 'class::MAINTAINER');
-        $this->assertNotEmpty($this->obj::MAINTAINER, 'class::MAINTAINER');
+        $this->assertIsString($this->bridge::NAME, 'class::NAME');
+        $this->assertNotEmpty($this->bridge::NAME, 'class::NAME');
+        $this->assertIsString($this->bridge::URI, 'class::URI');
+        $this->assertNotEmpty($this->bridge::URI, 'class::URI');
+        $this->assertIsString($this->bridge::DESCRIPTION, 'class::DESCRIPTION');
+        $this->assertNotEmpty($this->bridge::DESCRIPTION, 'class::DESCRIPTION');
+        $this->assertIsString($this->bridge::MAINTAINER, 'class::MAINTAINER');
+        $this->assertNotEmpty($this->bridge::MAINTAINER, 'class::MAINTAINER');
 
-        $this->assertIsArray($this->obj::PARAMETERS, 'class::PARAMETERS');
-        $this->assertIsInt($this->obj::CACHE_TIMEOUT, 'class::CACHE_TIMEOUT');
-        $this->assertGreaterThanOrEqual(0, $this->obj::CACHE_TIMEOUT, 'class::CACHE_TIMEOUT');
+        $this->assertIsArray($this->bridge::PARAMETERS, 'class::PARAMETERS');
+        $this->assertIsInt($this->bridge::CACHE_TIMEOUT, 'class::CACHE_TIMEOUT');
+        $this->assertGreaterThanOrEqual(0, $this->bridge::CACHE_TIMEOUT, 'class::CACHE_TIMEOUT');
     }
 
     /**
@@ -60,23 +60,22 @@ class BridgeImplementationTest extends TestCase
         $this->setBridge($path);
 
         $multiMinimum = 2;
-        if (isset($this->obj::PARAMETERS['global'])) {
+        if (isset($this->bridge::PARAMETERS['global'])) {
             ++$multiMinimum;
         }
-        $multiContexts = (count($this->obj::PARAMETERS) >= $multiMinimum);
+        $multiContexts = (count($this->bridge::PARAMETERS) >= $multiMinimum);
         $paramsSeen = [];
 
         $allowedTypes = [
             'text',
             'number',
             'list',
-            'checkbox'
+            'checkbox',
         ];
 
-        foreach ($this->obj::PARAMETERS as $context => $params) {
+        foreach ($this->bridge::PARAMETERS as $context => $params) {
             if ($multiContexts) {
                 $this->assertIsString($context, 'invalid context name');
-
                 $this->assertNotEmpty($context, 'The context name cannot be empty');
             }
 
@@ -152,11 +151,10 @@ class BridgeImplementationTest extends TestCase
             }
         }
 
-        foreach ($this->obj::TEST_DETECT_PARAMETERS as $url => $params) {
-            $this->assertEquals($this->obj->detectParameters($url), $params);
+        foreach ($this->bridge::TEST_DETECT_PARAMETERS as $url => $params) {
+            $detectedParameters = $this->bridge->detectParameters($url);
+            $this->assertEquals($detectedParameters, $params);
         }
-
-        $this->assertTrue(true);
     }
 
     /**
@@ -164,19 +162,21 @@ class BridgeImplementationTest extends TestCase
      */
     public function testVisibleMethods($path)
     {
-        $allowedBridgeAbstract = get_class_methods(BridgeAbstract::class);
-        sort($allowedBridgeAbstract);
-        $allowedFeedExpander = get_class_methods(FeedExpander::class);
-        sort($allowedFeedExpander);
+        $bridgeAbstractMethods = get_class_methods(BridgeAbstract::class);
+        sort($bridgeAbstractMethods);
+        $feedExpanderMethods = get_class_methods(FeedExpander::class);
+        sort($feedExpanderMethods);
 
         $this->setBridge($path);
 
-        $methods = get_class_methods($this->obj);
-        sort($methods);
-        if ($this->obj instanceof FeedExpander) {
-            $this->assertEquals($allowedFeedExpander, $methods);
-        } else {
-            $this->assertEquals($allowedBridgeAbstract, $methods);
+        $publicMethods = get_class_methods($this->bridge);
+        sort($publicMethods);
+        foreach ($publicMethods as $publicMethod) {
+            if ($this->bridge instanceof FeedExpander) {
+                $this->assertContains($publicMethod, $feedExpanderMethods);
+            } else {
+                $this->assertContains($publicMethod, $bridgeAbstractMethods);
+            }
         }
     }
 
@@ -187,23 +187,23 @@ class BridgeImplementationTest extends TestCase
     {
         $this->setBridge($path);
 
-        $value = $this->obj->getDescription();
+        $value = $this->bridge->getDescription();
         $this->assertIsString($value, '$class->getDescription()');
         $this->assertNotEmpty($value, '$class->getDescription()');
 
-        $value = $this->obj->getMaintainer();
+        $value = $this->bridge->getMaintainer();
         $this->assertIsString($value, '$class->getMaintainer()');
         $this->assertNotEmpty($value, '$class->getMaintainer()');
 
-        $value = $this->obj->getName();
+        $value = $this->bridge->getName();
         $this->assertIsString($value, '$class->getName()');
         $this->assertNotEmpty($value, '$class->getName()');
 
-        $value = $this->obj->getURI();
+        $value = $this->bridge->getURI();
         $this->assertIsString($value, '$class->getURI()');
         $this->assertNotEmpty($value, '$class->getURI()');
 
-        $value = $this->obj->getIcon();
+        $value = $this->bridge->getIcon();
         $this->assertIsString($value, '$class->getIcon()');
     }
 
@@ -214,14 +214,14 @@ class BridgeImplementationTest extends TestCase
     {
         $this->setBridge($path);
 
-        $this->checkUrl($this->obj::URI);
-        $this->checkUrl($this->obj->getURI());
+        $this->assertNotFalse(filter_var($this->bridge::URI, FILTER_VALIDATE_URL));
+        $this->assertNotFalse(filter_var($this->bridge->getURI(), FILTER_VALIDATE_URL));
     }
 
     public function dataBridgesProvider()
     {
         $bridges = [];
-        foreach (glob(__DIR__ . '/../../bridges/*Bridge.php') as $path) {
+        foreach (glob(__DIR__ . '/../bridges/*Bridge.php') as $path) {
             $bridges[basename($path, '.php')] = [$path];
         }
         return $bridges;
@@ -229,16 +229,11 @@ class BridgeImplementationTest extends TestCase
 
     private function setBridge($path)
     {
-        $this->class = '\\' . basename($path, '.php');
-        $this->assertTrue(class_exists($this->class), 'class ' . $this->class . ' doesn\'t exist');
-        $this->obj = new $this->class(
+        $this->className = '\\' . basename($path, '.php');
+        $this->assertTrue(class_exists($this->className), 'class ' . $this->className . ' doesn\'t exist');
+        $this->bridge = new $this->className(
             new \NullCache(),
-            new \NullLogger()
+            new \NullLogger(),
         );
     }
-
-    private function checkUrl($url)
-    {
-        $this->assertNotFalse(filter_var($url, FILTER_VALIDATE_URL), 'no valid URL: ' . $url);
-    }
 }
diff --git a/tests/CacheImplementationTest.php b/tests/CacheImplementationTest.php
new file mode 100644
index 00000000..e6ed352b
--- /dev/null
+++ b/tests/CacheImplementationTest.php
@@ -0,0 +1,36 @@
+<?php
+
+namespace RssBridge\Tests;
+
+use CacheInterface;
+use PHPUnit\Framework\TestCase;
+
+class CacheImplementationTest extends TestCase
+{
+    public function getCacheClassNames()
+    {
+        $caches = [];
+        foreach (glob(PATH_LIB_CACHES . '*.php') as $path) {
+            $caches[] = [basename($path, '.php')];
+        }
+        return $caches;
+    }
+
+    /**
+     * @dataProvider getCacheClassNames
+     */
+    public function testClassName($path)
+    {
+        $this->assertTrue($path === ucfirst($path), 'class name must start with uppercase character');
+        $this->assertEquals(0, substr_count($path, ' '), 'class name must not contain spaces');
+        $this->assertStringEndsWith('Cache', $path, 'class name must end with "Cache"');
+    }
+
+    /**
+     * @dataProvider getCacheClassNames
+     */
+    public function testClassType($path)
+    {
+        $this->assertTrue(is_subclass_of($path, CacheInterface::class), 'class must be subclass of CacheInterface');
+    }
+}
diff --git a/tests/Caches/CacheImplementationTest.php b/tests/Caches/CacheImplementationTest.php
deleted file mode 100644
index a3ad5f79..00000000
--- a/tests/Caches/CacheImplementationTest.php
+++ /dev/null
@@ -1,48 +0,0 @@
-<?php
-
-namespace RssBridge\Tests\Caches;
-
-use CacheInterface;
-use PHPUnit\Framework\TestCase;
-
-class CacheImplementationTest extends TestCase
-{
-    private $class;
-
-    /**
-     * @dataProvider dataCachesProvider
-     */
-    public function testClassName($path)
-    {
-        $this->setCache($path);
-        $this->assertTrue($this->class === ucfirst($this->class), 'class name must start with uppercase character');
-        $this->assertEquals(0, substr_count($this->class, ' '), 'class name must not contain spaces');
-        $this->assertStringEndsWith('Cache', $this->class, 'class name must end with "Cache"');
-    }
-
-    /**
-     * @dataProvider dataCachesProvider
-     */
-    public function testClassType($path)
-    {
-        $this->setCache($path);
-        $this->assertTrue(is_subclass_of($this->class, CacheInterface::class), 'class must be subclass of CacheInterface');
-    }
-
-    ////////////////////////////////////////////////////////////////////////////
-
-    public function dataCachesProvider()
-    {
-        $caches = [];
-        foreach (glob(PATH_LIB_CACHES . '*.php') as $path) {
-            $caches[basename($path, '.php')] = [$path];
-        }
-        return $caches;
-    }
-
-    private function setCache($path)
-    {
-        $this->class = '\\' . basename($path, '.php');
-        $this->assertTrue(class_exists($this->class), 'class ' . $this->class . ' doesn\'t exist');
-    }
-}
diff --git a/tests/ParameterValidatorTest.php b/tests/ParameterValidatorTest.php
new file mode 100644
index 00000000..1b241c2c
--- /dev/null
+++ b/tests/ParameterValidatorTest.php
@@ -0,0 +1,40 @@
+<?php
+
+declare(strict_types=1);
+
+namespace RssBridge\Tests;
+
+use PHPUnit\Framework\TestCase;
+
+class ParameterValidatorTest extends TestCase
+{
+    public function test1()
+    {
+        $sut = new \ParameterValidator();
+        $input = ['user' => 'joe'];
+        $parameters = [
+            [
+                'user' => [
+                    'name' => 'User',
+                    'type' => 'text',
+                ],
+            ]
+        ];
+        $this->assertTrue($sut->validateInput($input, $parameters));
+    }
+
+    public function test2()
+    {
+        $sut = new \ParameterValidator();
+        $input = ['username' => 'joe'];
+        $parameters = [
+            [
+                'user' => [
+                    'name' => 'User',
+                    'type' => 'text',
+                ],
+            ]
+        ];
+        $this->assertFalse($sut->validateInput($input, $parameters));
+    }
+}

From 69da0dd5830e1e8a48e4b22066ae645e790a5a9e Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Sun, 1 Oct 2023 20:46:51 +0200
Subject: [PATCH 147/716] [refactoring] replace direct use of curl with
 getContents (#3723)

+ some fixed warnings
---
 bridges/DealabsBridge.php        |  1 +
 bridges/FDroidBridge.php         | 28 +++++------------------
 bridges/HotUKDealsBridge.php     |  1 +
 bridges/MydealsBridge.php        |  1 +
 bridges/PepperBridgeAbstract.php | 39 ++++++++------------------------
 lib/contents.php                 |  6 ++++-
 6 files changed, 24 insertions(+), 52 deletions(-)

diff --git a/bridges/DealabsBridge.php b/bridges/DealabsBridge.php
index 6e5ba9e3..a904c3ff 100644
--- a/bridges/DealabsBridge.php
+++ b/bridges/DealabsBridge.php
@@ -1909,6 +1909,7 @@ class DealabsBridge extends PepperBridgeAbstract
         'context-group' => 'Deals par groupe',
         'context-talk' => 'Surveillance Discussion',
         'uri-group' => 'groupe/',
+        'uri-deal' => 'bons-plans/',
         'request-error' => 'Impossible de joindre Dealabs',
         'thread-error' => 'Impossible de déterminer l\'ID de la discussion. Vérifiez l\'URL que vous avez entré',
         'no-results' => 'Il n&#039;y a rien à afficher pour le moment :(',
diff --git a/bridges/FDroidBridge.php b/bridges/FDroidBridge.php
index 099a4121..8d3b7808 100644
--- a/bridges/FDroidBridge.php
+++ b/bridges/FDroidBridge.php
@@ -21,34 +21,18 @@ class FDroidBridge extends BridgeAbstract
 
     public function getIcon()
     {
-        return self::URI . 'assets/favicon.ico?v=8j6PKzW9Mk';
+        return self::URI . 'assets/favicon.ico';
     }
 
     private function getTimestamp($url)
     {
         $curlOptions = [
-            CURLOPT_RETURNTRANSFER => true,
-            CURLOPT_HEADER         => true,
-            CURLOPT_NOBODY         => true,
-            CURLOPT_CONNECTTIMEOUT => 19,
-            CURLOPT_TIMEOUT        => 19,
+            CURLOPT_CUSTOMREQUEST => 'HEAD',
+            CURLOPT_NOBODY => true,
         ];
-        $ch = curl_init($url);
-        curl_setopt_array($ch, $curlOptions);
-        $curlHeaders = curl_exec($ch);
-        $curlError = curl_error($ch);
-        curl_close($ch);
-        if (!empty($curlError)) {
-            return false;
-        }
-        $curlHeaders = explode("\n", $curlHeaders);
-        $timestamp = false;
-        foreach ($curlHeaders as $header) {
-            if (strpos($header, 'Last-Modified') !== false) {
-                $timestamp = str_replace('Last-Modified: ', '', $header);
-                $timestamp = strtotime($timestamp);
-            }
-        }
+        $reponse = getContents($url, [], $curlOptions, true);
+        $lastModified = $reponse['headers']['last-modified'][0] ?? null;
+        $timestamp = strtotime($lastModified ?? 'today');
         return $timestamp;
     }
 
diff --git a/bridges/HotUKDealsBridge.php b/bridges/HotUKDealsBridge.php
index 7328ca04..fe4ef507 100644
--- a/bridges/HotUKDealsBridge.php
+++ b/bridges/HotUKDealsBridge.php
@@ -3273,6 +3273,7 @@ class HotUKDealsBridge extends PepperBridgeAbstract
         'context-group' => 'Deals per group',
         'context-talk' => 'Discussion Monitoring',
         'uri-group' => 'tag/',
+        'uri-deal' => 'deals/',
         'request-error' => 'Could not request HotUKDeals',
         'thread-error' => 'Unable to determine the thread ID. Check the URL you entered',
         'no-results' => 'Ooops, looks like we could',
diff --git a/bridges/MydealsBridge.php b/bridges/MydealsBridge.php
index 257ef561..0ef9c201 100644
--- a/bridges/MydealsBridge.php
+++ b/bridges/MydealsBridge.php
@@ -2020,6 +2020,7 @@ class MydealsBridge extends PepperBridgeAbstract
         'context-group' => 'Deals pro Gruppen',
         'context-talk' => 'Überwachung Diskussion',
         'uri-group' => 'gruppe/',
+        'uri-deal' => 'deals/',
         'request-error' => 'Could not request mydeals',
         'thread-error' => 'Die ID der Diskussion kann nicht ermittelt werden. Überprüfen Sie die eingegebene URL',
         'no-results' => 'Ups, wir konnten keine Deals zu',
diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index 280b185d..4e520acc 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -165,7 +165,7 @@ class PepperBridgeAbstract extends BridgeAbstract
         $url = $this->i8n('bridge-uri') . 'graphql';
 
         // Get Cookies header to do the query
-        $cookies = $this->getCookies($url);
+        $cookiesHeaderValue = $this->getCookiesHeaderValue($url);
 
         // GraphQL String
         // This was extracted from https://www.dealabs.com/assets/js/modern/common_211b99.js
@@ -209,7 +209,7 @@ HEREDOC;
             'X-Pepper-Txn: threads.show',
             'X-Request-Type: application/vnd.pepper.v1+json',
             'X-Requested-With: XMLHttpRequest',
-            $cookies,
+            "Cookie: $cookiesHeaderValue",
         ];
         // CURL Options
         $opts = [
@@ -245,26 +245,12 @@ HEREDOC;
      * Extract the cookies obtained from the URL
      * @return array the array containing the cookies set by the URL
      */
-    private function getCookies($url)
+    private function getCookiesHeaderValue($url)
     {
-        $ch = curl_init($url);
-        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
-        // get headers too with this line
-        curl_setopt($ch, CURLOPT_HEADER, 1);
-        $result = curl_exec($ch);
-        // get cookie
-        // multi-cookie variant contributed by @Combuster in comments
-        preg_match_all('/^Set-Cookie:\s*([^;]*)/mi', $result, $matches);
-        $cookies = [];
-        foreach ($matches[1] as $item) {
-            parse_str($item, $cookie);
-            $cookies = array_merge($cookies, $cookie);
-        }
-        $header = 'Cookie: ';
-        foreach ($cookies as $name => $content) {
-            $header .= $name . '=' . $content . '; ';
-        }
-        return $header;
+        $response = getContents($url, [], [], true);
+        $setCookieHeaders = $response['headers']['set-cookie'] ?? [];
+        $cookies = array_map(fn($c): string => explode(';', $c)[0], $setCookieHeaders);
+        return implode('; ', $cookies);
     }
 
     /**
@@ -330,7 +316,7 @@ HEREDOC;
     private function getTalkTitle()
     {
         $html = getSimpleHTMLDOMCached($this->getInput('url'));
-        $title = $html->find('h1[class=thread-title]', 0)->plaintext;
+        $title = $html->find('.thread-title', 0)->plaintext;
         return $title;
     }
 
@@ -356,13 +342,8 @@ HEREDOC;
      */
     private function getDealURI($deal)
     {
-        $uriA = $deal->find('div[class*=threadGrid-title]', 0)->find('a[class*=thread-link]', 0);
-        if ($uriA === null) {
-            $uri = '';
-        } else {
-            $uri = $uriA->href;
-        }
-
+        $dealId = $deal->attr['id'];
+        $uri = $this->i8n('bridge-uri') . $this->i8n('uri-deal') . str_replace('_', '-', $dealId);
         return $uri;
     }
 
diff --git a/lib/contents.php b/lib/contents.php
index 432d9139..27f0af31 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -52,7 +52,11 @@ function getContents(
         $config['proxy'] = Configuration::getConfig('proxy', 'url');
     }
 
-    $cacheKey = 'server_' . $url;
+    $requestBodyHash = null;
+    if (isset($curlOptions[CURLOPT_POSTFIELDS])) {
+        $requestBodyHash = md5(json_encode($curlOptions[CURLOPT_POSTFIELDS]));
+    }
+    $cacheKey = implode('_', ['server',  $url, $requestBodyHash]);
 
     /** @var Response $cachedResponse */
     $cachedResponse = $cache->get($cacheKey);

From 547af0d0d2fe70ae4a54ab238b970750c1463301 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 1 Oct 2023 20:54:28 +0200
Subject: [PATCH 148/716] refactor: use Json::encode instead of json_encode
 (#3724)

---
 lib/contents.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/contents.php b/lib/contents.php
index 27f0af31..cfb9f36a 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -54,7 +54,7 @@ function getContents(
 
     $requestBodyHash = null;
     if (isset($curlOptions[CURLOPT_POSTFIELDS])) {
-        $requestBodyHash = md5(json_encode($curlOptions[CURLOPT_POSTFIELDS]));
+        $requestBodyHash = md5(Json::encode($curlOptions[CURLOPT_POSTFIELDS], false));
     }
     $cacheKey = implode('_', ['server',  $url, $requestBodyHash]);
 

From 64582a64f13ba4d7ba160ad6f57199d7ea010f42 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 1 Oct 2023 21:19:27 +0200
Subject: [PATCH 149/716] fix(tpb): add category (#3725)

---
 bridges/ThePirateBayBridge.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/bridges/ThePirateBayBridge.php b/bridges/ThePirateBayBridge.php
index 4b130800..fd4a31ac 100644
--- a/bridges/ThePirateBayBridge.php
+++ b/bridges/ThePirateBayBridge.php
@@ -91,6 +91,7 @@ class ThePirateBayBridge extends BridgeAbstract
         '504' => 'Games',
         '505' => 'HD-Movies',
         '506' => 'Movie Clips',
+        '507' => 'UHD/4k Movies',
         '599' => 'Other',
         '601' => 'E-books',
         '602' => 'Comics',

From 59dd49671d4b301f64cc1299c3156f6a31d5fd00 Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Mon, 2 Oct 2023 03:02:57 +0200
Subject: [PATCH 150/716] [BridgeCard] add example value to info hint and allow
 using it by right click (#3726)

---
 lib/BridgeCard.php   | 13 +++++++++++--
 static/rss-bridge.js |  6 ++++++
 2 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/lib/BridgeCard.php b/lib/BridgeCard.php
index b2fda192..4781ebc1 100644
--- a/lib/BridgeCard.php
+++ b/lib/BridgeCard.php
@@ -177,9 +177,18 @@ This bridge is not fetching its content through a secure connection</div>';
                     $form .= self::getCheckboxInput($inputEntry, $idArg, $id);
                 }
 
+                $infoText = [];
+                $infoTextScript = '';
                 if (isset($inputEntry['title'])) {
-                    $title_filtered = filter_var($inputEntry['title'], FILTER_SANITIZE_FULL_SPECIAL_CHARS);
-                    $form .= '<i class="info" title="' . $title_filtered . '">i</i>';
+                    $infoText[] = filter_var($inputEntry['title'], FILTER_SANITIZE_FULL_SPECIAL_CHARS);
+                }
+                if ($inputEntry['exampleValue'] !== '') {
+                    $infoText[] = "Example (right click to use):\n" . filter_var($inputEntry['exampleValue'], FILTER_SANITIZE_FULL_SPECIAL_CHARS);
+                    $infoTextScript = 'rssbridge_use_placeholder_value(this);';
+                }
+
+                if (count($infoText) > 0) {
+                    $form .= '<i class="info" data-for="' . $idArg . '" title="' . implode("\n\n", $infoText) . '" oncontextmenu="' . $infoTextScript . 'return false">i</i>';
                 } else {
                     $form .= '<i class="no-info"></i>';
                 }
diff --git a/static/rss-bridge.js b/static/rss-bridge.js
index 2c45294c..b9b466d6 100644
--- a/static/rss-bridge.js
+++ b/static/rss-bridge.js
@@ -48,6 +48,12 @@ function rssbridge_toggle_bridge(){
     }
 }
 
+function rssbridge_use_placeholder_value(sender) {
+    let inputId = sender.getAttribute('data-for');
+    let inputElement = document.getElementById(inputId);
+    inputElement.value = inputElement.getAttribute("placeholder");
+}
+
 var rssbridge_feed_finder = (function() {
     /*
      * Code for "Find feed by URL" feature

From 1cbe1a6f98ec536be7f894ebcc255d7417c0060b Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Tue, 3 Oct 2023 23:15:10 +0200
Subject: [PATCH 151/716] [PepperBridge] Fix date parsing (#3727)

Website changed the date display.
This fix adapt the date parsing to the new website date display
---
 bridges/HotUKDealsBridge.php     | 1 +
 bridges/PepperBridgeAbstract.php | 6 +++---
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/bridges/HotUKDealsBridge.php b/bridges/HotUKDealsBridge.php
index fe4ef507..69301c42 100644
--- a/bridges/HotUKDealsBridge.php
+++ b/bridges/HotUKDealsBridge.php
@@ -3316,6 +3316,7 @@ class HotUKDealsBridge extends PepperBridgeAbstract
             'and '
         ],
         'date-prefixes' => [
+            'Posted ',
             'Found ',
             'Refreshed ',
             'Made hot '
diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index 4e520acc..5d2e552b 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -128,9 +128,9 @@ class PepperBridgeAbstract extends BridgeAbstract
                     $clock = end($clocks);
 
                     // Find the text corresponding to the clock
-                    $spanDateDiv = $clock->parent()->find('span[class=hide--toW3]', 0);
-                    $itemDate = $spanDateDiv->plaintext ?? '';
-                    // In case of a Local deal, there is no date, but we can use
+                    $spanDateDiv = $clock->next_sibling();
+                    $itemDate = $spanDateDiv->plaintext;
+                    // In some case of a Local deal, there is no date, but we can use
                     // this case for other reason (like date not in the last field)
                     if ($this->contains($itemDate, $this->i8n('localdeal'))) {
                         $item['timestamp'] = time();

From e376805249dcc16fe3730371e9c3858967681ecf Mon Sep 17 00:00:00 2001
From: Niehztog <Niehztog@users.noreply.github.com>
Date: Thu, 5 Oct 2023 02:31:04 +0200
Subject: [PATCH 152/716] [NiusBridge] fix parse error, fix image content-type
 (#3728)

---
 bridges/NiusBridge.php | 24 +++++++++++++-----------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/bridges/NiusBridge.php b/bridges/NiusBridge.php
index 05d0dacc..c76b29f0 100644
--- a/bridges/NiusBridge.php
+++ b/bridges/NiusBridge.php
@@ -12,29 +12,31 @@ class NiusBridge extends XPathAbstract
     const FEED_SOURCE_URL = 'https://www.nius.de/news';
     const XPATH_EXPRESSION_ITEM = './/div[contains(@class, "compact-story") or contains(@class, "regular-story")]';
     const XPATH_EXPRESSION_ITEM_TITLE = './/h2[@class="title"]//node()';
-    const XPATH_EXPRESSION_ITEM_CONTENT = './/h2[@class="title"]//node()';
+    const XPATH_EXPRESSION_ITEM_CONTENT = self::XPATH_EXPRESSION_ITEM_TITLE;
     const XPATH_EXPRESSION_ITEM_URI = './/a[1]/@href';
 
-    const XPATH_EXPRESSION_ITEM_AUTHOR = 'normalize-space(.//span[@class="author"]/text()[3])';
+    const XPATH_EXPR_AUTHOR_PART1 = 'normalize-space(.//span[@class="author"]/text()[1])';
+    const XPATH_EXPR_AUTHOR_PART2 = 'normalize-space(.//span[@class="author"]/text()[2])';
+    const XPATH_EXPRESSION_ITEM_AUTHOR = 'substring-after(concat(' . self::XPATH_EXPR_AUTHOR_PART1 . ', " ", ' . self::XPATH_EXPR_AUTHOR_PART2 . '), " ")';
 
-    const XPATH_EXPRESSION_ITEM_TIMESTAMP = 'normalize-space(.//span[@class="author"]/text()[1])';
-    const XPATH_EXPRESSION_ITEM_ENCLOSURES = './/img[@sizes]/@src';
+    const XPATH_EXPRESSION_ITEM_ENCLOSURES = './/img[@sizes and @alt="Article background picture"]/@src';
     const XPATH_EXPRESSION_ITEM_CATEGORIES = './/div[@class="subtitle"]/text()';
     const SETTING_FIX_ENCODING = false;
 
-    protected function formatItemTimestamp($value)
+    protected function formatItemTitle($value)
     {
-        return DateTimeImmutable::createFromFormat(
-            false !== strpos($value, ' Uhr') ? 'H:i \U\h\r' : 'd.m.y',
-            $value,
-            new DateTimeZone('Europe/Berlin')
-        )->format('U');
+        return strip_tags($value);
+    }
+
+    protected function formatItemContent($value)
+    {
+        return strip_tags($value);
     }
 
     protected function cleanMediaUrl($mediaUrl)
     {
         $result = preg_match('~https:\/\/www\.nius\.de\/_next\/image\?url=(.*)\?~', $mediaUrl, $matches);
-        return $result ? $matches[1] : $mediaUrl;
+        return $result ? $matches[1] . '#.jpg' : $mediaUrl;
     }
 
     protected function generateItemId(FeedItem $item)

From 5f777d4126fe79c2095a0716a2ba070e51173be0 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 5 Oct 2023 15:36:35 +0200
Subject: [PATCH 153/716] fix(codeberg): add temp fix (#3730)

they changed html for tag and commit
---
 bridges/CodebergBridge.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/bridges/CodebergBridge.php b/bridges/CodebergBridge.php
index 9515d514..2a450477 100644
--- a/bridges/CodebergBridge.php
+++ b/bridges/CodebergBridge.php
@@ -403,6 +403,9 @@ EOD;
      */
     private function stripSvg($html)
     {
+        if ($html === null) {
+            return null;
+        }
         if ($html->find('svg', 0)) {
             $html->find('svg', 0)->outertext = '';
         }

From f97a3fa4d9f0bbd5ce1b4541518664c21761b368 Mon Sep 17 00:00:00 2001
From: Park0 <Park0@users.noreply.github.com>
Date: Mon, 9 Oct 2023 08:46:24 +0200
Subject: [PATCH 154/716] Fia.com document bridge (#3733)

* Create FiaBridge.php

F1 documents from fia.com

* Update FiaBridge.php

Fixed concat
---
 bridges/FiaBridge.php | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 bridges/FiaBridge.php

diff --git a/bridges/FiaBridge.php b/bridges/FiaBridge.php
new file mode 100644
index 00000000..37d26267
--- /dev/null
+++ b/bridges/FiaBridge.php
@@ -0,0 +1,43 @@
+<?php
+
+class FiaBridge extends BridgeAbstract
+{
+    const NAME = 'Federation Internationale de l\'Automobile site feed';
+    const URI = 'https://fia.com';
+    const DESCRIPTION = 'Get the latest F1 documents from the fia site';
+    const PARAMETERS = [];
+    const CACHE_TIMEOUT = 900;
+
+    public function collectData()
+    {
+        $url = 'https://www.fia.com/documents/championships/fia-formula-one-world-championship-14/';
+        $html = getSimpleHTMLDOM($url);
+        $items = $html->find('li.document-row');
+        foreach ($items as $item) {
+            /** @var simple_html_dom $item */
+            // Do something with each list item
+            $title = trim($item->find('div.title', 0)->plaintext);
+            $href = $item->find('a', 0)->href;
+            $url = 'https://www.fia.com' . $href;
+
+            $date = $item->find('span.date-display-single', 0)->plaintext;
+
+            $item = [];
+            $item['uri'] = $url;
+            $item['title'] = $title;
+            $item['timestamp'] = (string) DateTime::createFromFormat('d.m.y H:i', $date)->getTimestamp();
+            ;
+            $item['author'] = 'Fia';
+            $item['content'] = "Document on date $date: $title <br /><a href='$url'>$url</a>";
+            $item['categories'] = 'Document';
+            $item['uid'] = $title . $date;
+
+            $count = count($this->items);
+            if ($count > 20) {
+                break;
+            } else {
+                $this->items[] = $item;
+            }
+        }
+    }
+}

From 47f52b5912f442389e9b5a867044efc6f4680b7b Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Mon, 9 Oct 2023 08:48:21 +0200
Subject: [PATCH 155/716] Add CSS Selector Feed Expander (#3732)

* Add CSS Selector Feed Expander

This bridge combines CssSelectorBridge with FeedExpander
Allows expanding a feed using CSS selectors

* Fix code linting

---------

Co-authored-by: ORelio <ORelio>
---
 bridges/CssSelectorBridge.php             |  9 ++-
 bridges/CssSelectorFeedExpanderBridge.php | 98 +++++++++++++++++++++++
 bridges/SitemapBridge.php                 |  6 +-
 3 files changed, 106 insertions(+), 7 deletions(-)
 create mode 100644 bridges/CssSelectorFeedExpanderBridge.php

diff --git a/bridges/CssSelectorBridge.php b/bridges/CssSelectorBridge.php
index dd8fe228..f6ab8d15 100644
--- a/bridges/CssSelectorBridge.php
+++ b/bridges/CssSelectorBridge.php
@@ -60,11 +60,12 @@ class CssSelectorBridge extends BridgeAbstract
         ]
     ];
 
-    private $feedName = '';
+    protected $feedName = '';
+    protected $homepageUrl = '';
 
     public function getURI()
     {
-        $url = $this->getInput('home_page');
+        $url = $this->homepageUrl;
         if (empty($url)) {
             $url = parent::getURI();
         }
@@ -81,7 +82,7 @@ class CssSelectorBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $url = $this->getInput('home_page');
+        $this->homepageUrl = $this->getInput('home_page');
         $url_selector = $this->getInput('url_selector');
         $url_pattern = $this->getInput('url_pattern');
         $content_selector = $this->getInput('content_selector');
@@ -90,7 +91,7 @@ class CssSelectorBridge extends BridgeAbstract
         $discard_thumbnail = $this->getInput('discard_thumbnail');
         $limit = $this->getInput('limit') ?? 10;
 
-        $html = defaultLinkTo(getSimpleHTMLDOM($url), $url);
+        $html = defaultLinkTo(getSimpleHTMLDOM($this->homepageUrl), $this->homepageUrl);
         $this->feedName = $this->titleCleanup($this->getPageTitle($html), $title_cleanup);
         $items = $this->htmlFindEntries($html, $url_selector, $url_pattern, $limit, $content_cleanup);
 
diff --git a/bridges/CssSelectorFeedExpanderBridge.php b/bridges/CssSelectorFeedExpanderBridge.php
new file mode 100644
index 00000000..7e1f630f
--- /dev/null
+++ b/bridges/CssSelectorFeedExpanderBridge.php
@@ -0,0 +1,98 @@
+<?php
+
+if (!class_exists('CssSelectorFeedExpanderBridgeInternal')) {
+    // Utility class used internally by CssSelectorFeedExpanderBridge
+    class CssSelectorFeedExpanderBridgeInternal extends FeedExpander
+    {
+        public function collectData()
+        {
+            // Unused. Call collectExpandableDatas($url) inherited from FeedExpander instead
+        }
+    }
+}
+
+class CssSelectorFeedExpanderBridge extends CssSelectorBridge
+{
+    const MAINTAINER = 'ORelio';
+    const NAME = 'CSS Selector Feed Expander';
+    const URI = 'https://github.com/RSS-Bridge/rss-bridge/';
+    const DESCRIPTION = 'Expand any site RSS feed using CSS selectors (Advanced Users)';
+    const PARAMETERS = [
+        [
+            'feed' => [
+                'name' => 'Feed: URL of truncated RSS feed',
+                'exampleValue' => 'https://example.com/feed.xml',
+                'required' => true
+            ],
+            'content_selector' => [
+                'name' => 'Selector for each article content',
+                'title' => <<<EOT
+                    This bridge works using CSS selectors, e.g. "div.article" will match <div class="article">.
+                    Everything inside that element becomes feed item content.
+                    EOT,
+                'exampleValue' => 'article.content',
+                'required' => true
+            ],
+            'content_cleanup' => [
+                'name' => '[Optional] Content cleanup: List of items to remove',
+                'title' => 'Selector for unnecessary elements to remove inside article contents.',
+                'exampleValue' => 'div.ads, div.comments',
+            ],
+            'dont_expand_metadata' => [
+                'name' => '[Optional] Don\'t expand metadata',
+                'title' => "This bridge will attempt to fill missing fields using metadata from the webpage.\nCheck to disable.",
+                'type' => 'checkbox',
+            ],
+            'discard_thumbnail' => [
+                'name' => '[Optional] Discard thumbnail set by site author',
+                'title' => 'Some sites set their logo as thumbnail for every article. Use this option to discard it.',
+                'type' => 'checkbox',
+            ],
+            'limit' => self::LIMIT
+        ]
+    ];
+
+    public function collectData()
+    {
+        $url = $this->getInput('feed');
+        $content_selector = $this->getInput('content_selector');
+        $content_cleanup = $this->getInput('content_cleanup');
+        $dont_expand_metadata = $this->getInput('dont_expand_metadata');
+        $discard_thumbnail = $this->getInput('discard_thumbnail');
+        $limit = $this->getInput('limit');
+
+        $feed_expander = new CssSelectorFeedExpanderBridgeInternal();
+        $items = $feed_expander->collectExpandableDatas($url)->getItems();
+
+        $this->homepageUrl = urljoin($url, '/');
+        $this->feedName = $feed_expander->getName();
+
+        foreach ($items as $item_from_feed) {
+            $item_expanded = $this->expandEntryWithSelector(
+                $item_from_feed['uri'],
+                $content_selector,
+                $content_cleanup
+            );
+
+            if ($dont_expand_metadata) {
+                // Take feed item, only replace content from expanded data
+                $content = $item_expanded['content'];
+                $item_expanded = $item_from_feed;
+                $item_expanded['content'] = $content;
+            } else {
+                // Take expanded item, but give priority to metadata already in source item
+                foreach ($item_from_feed as $field => $val) {
+                    if ($field !== 'content') {
+                        $item_expanded[$field] = $val;
+                    }
+                }
+            }
+
+            if ($discard_thumbnail && isset($item_expanded['enclosures'])) {
+                unset($item_expanded['enclosures']);
+            }
+
+            $this->items[] = $item_expanded;
+        }
+    }
+}
diff --git a/bridges/SitemapBridge.php b/bridges/SitemapBridge.php
index 78526e6e..bdf662ee 100644
--- a/bridges/SitemapBridge.php
+++ b/bridges/SitemapBridge.php
@@ -64,7 +64,7 @@ class SitemapBridge extends CssSelectorBridge
 
     public function collectData()
     {
-        $url = $this->getInput('home_page');
+        $this->homepageUrl = $this->getInput('home_page');
         $url_pattern = $this->getInput('url_pattern');
         $content_selector = $this->getInput('content_selector');
         $content_cleanup = $this->getInput('content_cleanup');
@@ -73,8 +73,8 @@ class SitemapBridge extends CssSelectorBridge
         $discard_thumbnail = $this->getInput('discard_thumbnail');
         $limit = $this->getInput('limit');
 
-        $this->feedName = $this->titleCleanup($this->getPageTitle($url), $title_cleanup);
-        $sitemap_url = empty($site_map) ? $url : $site_map;
+        $this->feedName = $this->titleCleanup($this->getPageTitle($this->homepageUrl), $title_cleanup);
+        $sitemap_url = empty($site_map) ? $this->homepageUrl : $site_map;
         $sitemap_xml = $this->getSitemapXml($sitemap_url, !empty($site_map));
         $links = $this->sitemapXmlToList($sitemap_xml, $url_pattern, empty($limit) ? 10 : $limit);
 

From 143f90da604929e642184a6f830574266b8ac0e7 Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Tue, 10 Oct 2023 19:34:16 +0200
Subject: [PATCH 156/716] [WeLiveSecurity] Fix content extraction (#3734)

---
 bridges/WeLiveSecurityBridge.php | 35 ++++++++++++++++++++++++--------
 1 file changed, 26 insertions(+), 9 deletions(-)

diff --git a/bridges/WeLiveSecurityBridge.php b/bridges/WeLiveSecurityBridge.php
index 6434a13a..f54f6b29 100644
--- a/bridges/WeLiveSecurityBridge.php
+++ b/bridges/WeLiveSecurityBridge.php
@@ -16,19 +16,36 @@ class WeLiveSecurityBridge extends FeedExpander
     {
         $item = parent::parseItem($item);
 
-        $article_html = getSimpleHTMLDOMCached($item['uri']);
-        if (!$article_html) {
-            $item['content'] .= '<p><em>Could not request ' . $this->getName() . ': ' . $item['uri'] . '</em></p>';
+        $html = getSimpleHTMLDOMCached($item['uri']);
+        if (!$html) {
+            $item['content'] .= '<br /><p><em>Could not request ' . $this->getName() . ': ' . $item['uri'] . '</em></p>';
             return $item;
         }
 
-        $article_content = $article_html->find('div.formatted', 0)->innertext;
-        $article_content = stripWithDelimiters($article_content, '<script', '</script>');
-        $article_content = stripRecursiveHTMLSection($article_content, 'div', '<div class="comments');
-        $article_content = stripRecursiveHTMLSection($article_content, 'div', '<div class="similar-articles');
-        $article_content = stripRecursiveHTMLSection($article_content, 'span', '<span class="meta');
-        $item['content'] = trim($article_content);
+        $html = $html->find('.article-page', 0);
+        $content_html = $html->find('.article-body', 0);
 
+        // Remove social media footer
+        foreach ($content_html->find('blockquote') as $blockquote) {
+            if (str_starts_with(trim($blockquote->plaintext), 'Connect with us on')) {
+                $blockquote->outertext = '';
+            }
+        }
+
+        // Headline subtitle
+        $content = $content_html->innertext;
+        $subtitle = $html->find('.sub-title', 0);
+        if ($subtitle) {
+            $content = '<p><b>' . $subtitle->plaintext . '</b></p>' . $content;
+        }
+
+        // Author
+        $author = $html->find('.article-author', 0);
+        if ($author && !isset($item['author'])) {
+            $item['author'] = trim($author->plaintext);
+        }
+
+        $item['content'] = trim($content);
         return $item;
     }
 

From b6a9baff9494d4f7820b640848afa02492a6f865 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 10 Oct 2023 21:41:57 +0200
Subject: [PATCH 157/716] fix(cvedetails,tldrtech) (#3735)

---
 bridges/CVEDetailsBridge.php | 131 ++++++++++++++++-------------------
 bridges/TldrTechBridge.php   |  20 ++++--
 lib/http.php                 |   1 +
 lib/utils.php                |   2 +-
 4 files changed, 75 insertions(+), 79 deletions(-)

diff --git a/bridges/CVEDetailsBridge.php b/bridges/CVEDetailsBridge.php
index 5334c170..27b4008c 100644
--- a/bridges/CVEDetailsBridge.php
+++ b/bridges/CVEDetailsBridge.php
@@ -36,12 +36,65 @@ class CVEDetailsBridge extends BridgeAbstract
     private $vendor = '';
     private $product = '';
 
-    // Return the URL to query.
-    // Because of the optional product ID, we need to attach it if it is
-    // set. The search result page has the exact same structure (with and
-    // without the product ID).
-    private function buildUrl()
+    public function collectData()
     {
+        if ($this->html == null) {
+            $this->fetchContent();
+        }
+
+        foreach ($this->html->find('#searchresults > .row') as $i => $tr) {
+            // There are some optional vulnerability types, which will be
+            // added to the categories as well as the CWE number -- which is
+            // always given.
+            $categories = [$this->vendor];
+            $enclosures = [];
+
+            $detailLink = $tr->find('h3 > a', 0);
+            $detailHtml = getSimpleHTMLDOM($detailLink->href);
+
+            // The CVE number itself
+            $title = $tr->find('h3 > a', 0)->innertext;
+            $content = $tr->find('.cvesummarylong', 0)->innertext;
+            $cweList = $detailHtml->find('h2', 2)->next_sibling();
+            foreach ($cweList->find('li') as $li) {
+                $cweWithDescription = $li->find('a', 0)->innertext;
+
+                if (preg_match('/CWE-(\d+)/', $cweWithDescription, $cwe)) {
+                    $categories[] = 'CWE-' . $cwe[1];
+                    $enclosures[] = 'https://cwe.mitre.org/data/definitions/' . $cwe[1] . '.html';
+                }
+            }
+
+            if ($this->product != '') {
+                $categories[] = $this->product;
+            }
+
+            $this->items[] = [
+                'uri'           => 'https://cvedetails.com/' . $detailHtml->find('h1 > a', 0)->href,
+                'title'         => $title,
+                'timestamp'     => $tr->find('[data-tsvfield="publishDate"]', 0)->innertext,
+                'content'       => $content,
+                'categories'    => $categories,
+                'enclosures'    => $enclosures,
+                'uid'           => $title,
+            ];
+
+            // We only want to fetch the latest 10 CVEs
+            if (count($this->items) >= 10) {
+                break;
+            }
+        }
+    }
+
+    // Make the actual request to cvedetails.com and stores the response
+    // (HTML) for later use and extract vendor and product from it.
+    private function fetchContent()
+    {
+        // build url
+        // Return the URL to query.
+        // Because of the optional product ID, we need to attach it if it is
+        // set. The search result page has the exact same structure (with and
+        // without the product ID).
         $url = self::URI . '/vulnerability-list/vendor_id-' . $this->getInput('vendor_id');
         if ($this->getInput('product_id') !== '') {
             $url .= '/product_id-' . $this->getInput('product_id');
@@ -51,22 +104,12 @@ class CVEDetailsBridge extends BridgeAbstract
         // number, which should be mostly accurate.
         $url .= '?order=1'; // Order by CVE number DESC
 
-        return $url;
-    }
-
-    // Make the actual request to cvedetails.com and stores the response
-    // (HTML) for later use and extract vendor and product from it.
-    private function fetchContent()
-    {
-        $html = getSimpleHTMLDOM($this->buildUrl());
+        $html = getSimpleHTMLDOM($url);
         $this->html = defaultLinkTo($html, self::URI);
 
         $vendor = $html->find('#contentdiv h1 > a', 0);
         if ($vendor == null) {
-            returnServerError('Invalid Vendor ID ' .
-                $this->getInput('vendor_id') .
-                ' or Product ID ' .
-                $this->getInput('product_id'));
+            returnServerError('Invalid Vendor ID ' . $this->getInput('vendor_id') . ' or Product ID ' . $this->getInput('product_id'));
         }
         $this->vendor = $vendor->innertext;
 
@@ -76,7 +119,6 @@ class CVEDetailsBridge extends BridgeAbstract
         }
     }
 
-    // Build the name of the feed.
     public function getName()
     {
         if ($this->getInput('vendor_id') == '') {
@@ -94,57 +136,4 @@ class CVEDetailsBridge extends BridgeAbstract
 
         return $name;
     }
-
-    // Pull the data from the HTML response and fill the items..
-    public function collectData()
-    {
-        if ($this->html == null) {
-            $this->fetchContent();
-        }
-
-        foreach ($this->html->find('#searchresults > .row') as $i => $tr) {
-            // There are some optional vulnerability types, which will be
-            // added to the categories as well as the CWE number -- which is
-            // always given.
-            $categories = [$this->vendor];
-            $enclosures = [];
-
-            $detailLink = $tr->find('.cveheader > h3 > a', 0);
-            $detailHtml = getSimpleHTMLDOM($detailLink->href);
-
-            $div = $detailHtml->find('.cvedetailssummary', 0);
-
-            // The CVE number itself
-            $title = $div->find('h1 > a', 0)->innertext;
-            $content = $div->find('.ssc-paragraph', 0)->innertext;
-            $cweList = $detailHtml->find('h2', 2)->next_sibling();
-            foreach ($cweList->find('li') as $li) {
-                $cweWithDescription = $li->find('a', 0)->innertext;
-                preg_match('/CWE-(\d+)/', $cweWithDescription, $cwe);
-                if (count($cwe) > 1) {
-                    $categories[] = 'CWE-' . $cwe[1];
-                    $enclosures[] = 'https://cwe.mitre.org/data/definitions/' . $cwe[1] . '.html';
-                }
-            }
-
-            if ($this->product != '') {
-                $categories[] = $this->product;
-            }
-
-            $this->items[] = [
-                'uri' => 'https://cvedetails.com/' . $detailHtml->find('h1 > a', 0)->href,
-                'title' => $title,
-                'timestamp' => $tr->find('td', 5)->innertext,
-                'content' => $content,
-                'categories' => $categories,
-                'enclosures' => $enclosures,
-                'uid' => $title,
-            ];
-
-            // We only want to fetch the latest 10 CVEs
-            if (count($this->items) >= 10) {
-                break;
-            }
-        }
-    }
 }
diff --git a/bridges/TldrTechBridge.php b/bridges/TldrTechBridge.php
index b89686bb..984117b2 100644
--- a/bridges/TldrTechBridge.php
+++ b/bridges/TldrTechBridge.php
@@ -35,7 +35,10 @@ class TldrTechBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $html = getSimpleHTMLDOM(self::URI . $this->getInput('topic') . '/archives');
+        $topic = $this->getInput('topic');
+        $limit = $this->getInput('limit');
+        $url = self::URI . $topic . '/archives';
+        $html = getSimpleHTMLDOM($url);
         $entries_root = $html->find('div.content-center.mt-5', 0);
         $added = 0;
         foreach ($entries_root->children() as $child) {
@@ -46,22 +49,25 @@ class TldrTechBridge extends BridgeAbstract
             $date_items = explode('/', $child->href);
             $date = strtotime(end($date_items));
             $this->items[] = [
-                'uri' => self::URI . $child->href,
-                'title' => $child->plaintext,
+                'uri'       => self::URI . $child->href,
+                'title'     => $child->plaintext,
                 'timestamp' => $date,
-                'content' => $this->parseEntry(self::URI . $child->href)
+                'content'   => $this->extractContent(self::URI . $child->href),
             ];
             $added++;
-            if ($added >= $this->getInput('limit')) {
+            if ($added >= $limit) {
                 break;
             }
         }
     }
 
-    private function parseEntry($uri)
+    private function extractContent($url)
     {
-        $html = getSimpleHTMLDOM($uri);
+        $html = getSimpleHTMLDOM($url);
         $content = $html->find('div.content-center.mt-5', 0);
+        if (!$content) {
+            return '';
+        }
         $subscribe_form = $content->find('div.mt-5 > div > form', 0);
         if ($subscribe_form) {
             $content->removeChild($subscribe_form->parent->parent);
diff --git a/lib/http.php b/lib/http.php
index 3d65b2d1..c5c57d05 100644
--- a/lib/http.php
+++ b/lib/http.php
@@ -13,6 +13,7 @@ final class CloudFlareException extends HttpException
             '<title>Please Wait...',
             '<title>Attention Required!',
             '<title>Security | Glassdoor',
+            '<title>Access denied</title>', // cf as seen on patreon.com
         ];
         foreach ($cloudflareTitles as $cloudflareTitle) {
             if (str_contains($response->getBody(), $cloudflareTitle)) {
diff --git a/lib/utils.php b/lib/utils.php
index 4c58d258..e8f00f54 100644
--- a/lib/utils.php
+++ b/lib/utils.php
@@ -140,7 +140,7 @@ function _sanitize_path_name(string $s, string $pathName): string
 }
 
 /**
- * This is buggy because strip tags removes a lot that isn't html
+ * This is buggy because strip_tags() removes a lot that isn't html
  */
 function is_html(string $text): bool
 {

From 145bd10f4c00f3aef9d178266cb3282920dc6f41 Mon Sep 17 00:00:00 2001
From: Eugene Molotov <eugene.molotov@yandex.ru>
Date: Wed, 11 Oct 2023 21:16:57 +0500
Subject: [PATCH 158/716] [VkBridge] Revert more universal regex for title
 generation (#3736)

In practice it lead to feed items to have "untitled".
Using previous regex with more covered cases.

Credits to https://t.me/votkot as author of regex
---
 bridges/VkBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/VkBridge.php b/bridges/VkBridge.php
index 90b2586e..a21ee665 100644
--- a/bridges/VkBridge.php
+++ b/bridges/VkBridge.php
@@ -453,7 +453,7 @@ class VkBridge extends BridgeAbstract
     {
         $content = explode('<br>', $content)[0];
         $content = strip_tags($content);
-        preg_match('/.+?(?=[\.\n])/mu', htmlspecialchars_decode($content), $result);
+        preg_match('/^[:\,"\w\ \p{L}\(\)\?#«»\-\–\—||&\.%\\₽\/+\;\!]+/mu', htmlspecialchars_decode($content), $result);
         if (count($result) == 0) {
             return 'untitled';
         }

From 7e183915a956a24b235e6c30914b2d8f1018a65a Mon Sep 17 00:00:00 2001
From: Eugene Molotov <eugene.molotov@yandex.ru>
Date: Wed, 11 Oct 2023 21:28:54 +0500
Subject: [PATCH 159/716] [VkBridge] Fix missing feed title (#3737)

---
 bridges/VkBridge.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bridges/VkBridge.php b/bridges/VkBridge.php
index a21ee665..d86b9cf9 100644
--- a/bridges/VkBridge.php
+++ b/bridges/VkBridge.php
@@ -76,10 +76,10 @@ class VkBridge extends BridgeAbstract
                 break;
             }
         }
-        $pageName = $html->find('.page_name', 0);
+        $pageName = $html->find('meta[property="og:title"]', 0);
         if (is_object($pageName)) {
-            $pageName = $pageName->plaintext;
-            $this->pageName = htmlspecialchars_decode($pageName);
+            $pageName = $pageName->getAttribute('content');
+            $this->pageName = $pageName;
         }
         foreach ($html->find('div.replies') as $comment_block) {
             $comment_block->outertext = '';

From d21f8cebf617aa1f8154b1ec03d5af1b420d489d Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 11 Oct 2023 18:37:01 +0200
Subject: [PATCH 160/716] fix(imgsed): parsing of datetime string (#3738)

* refactor

* fix(imgsed): parsing of date

date_interval_create_from_date_string(): Unknown or bad format (an hour) at position 0 (a)
---
 bridges/ImgsedBridge.php | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/bridges/ImgsedBridge.php b/bridges/ImgsedBridge.php
index b6385361..e605cf4f 100644
--- a/bridges/ImgsedBridge.php
+++ b/bridges/ImgsedBridge.php
@@ -43,15 +43,6 @@ class ImgsedBridge extends BridgeAbstract
         'https://www.imgsed.com/instagram/' => ['context' => 'Username', 'u' => 'instagram', 'post' => 'on', 'story' => 'on', 'tagged' => 'on'],
     ];
 
-    public function getURI()
-    {
-        if (!is_null($this->getInput('u'))) {
-            return urljoin(self::URI, '/' . $this->getInput('u') . '/');
-        }
-
-        return parent::getURI();
-    }
-
     public function collectData()
     {
         $username = $this->getInput('u');
@@ -100,9 +91,6 @@ class ImgsedBridge extends BridgeAbstract
             $isMoreContent = (bool) $post->find('svg', 0);
             $moreContentNote = $isMoreContent ? '<p><i>(multiple images and/or videos)</i></p>' : '';
 
-
-
-
             $this->items[] = [
                 'uri'        => $url,
                 'author'     => $author,
@@ -214,15 +202,18 @@ HTML,
         }
     }
 
-    // Parse date, and transform the date into a timetamp, even in a case of a relative date
     private function parseDate($content)
     {
+        // Parse date, and transform the date into a timetamp, even in a case of a relative date
         $date = date_create();
         $dateString = str_replace(' ago', '', $content);
         // Special case : 'a day' is not a valid interval in PHP, so replace it with it's PHP equivalenbt : '1 day'
         if ($dateString == 'a day') {
             $dateString = '1 day';
         }
+        if ($dateString === 'an hour') {
+            $dateString = '1 hour';
+        }
 
         $relativeDate = date_interval_create_from_date_string($dateString);
         if ($relativeDate) {
@@ -235,6 +226,15 @@ HTML,
         return date_format($date, 'r');
     }
 
+    public function getURI()
+    {
+        if (!is_null($this->getInput('u'))) {
+            return urljoin(self::URI, '/' . $this->getInput('u') . '/');
+        }
+
+        return parent::getURI();
+    }
+
     private function convertURLToInstagram($url)
     {
         return str_replace(self::URI, self::INSTAGRAMURI, $url);

From 6a72c56cdd9230fedddc3d5eb23ebe94bfdc3310 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 12 Oct 2023 19:49:04 +0200
Subject: [PATCH 161/716] fix: various fixes (#3741)

---
 bridges/CarThrottleBridge.php | 30 +++++++++++++++++++-----------
 bridges/GatesNotesBridge.php  |  6 ++++--
 lib/contents.php              | 11 +++++------
 3 files changed, 28 insertions(+), 19 deletions(-)

diff --git a/bridges/CarThrottleBridge.php b/bridges/CarThrottleBridge.php
index 5b95dd28..913b686c 100644
--- a/bridges/CarThrottleBridge.php
+++ b/bridges/CarThrottleBridge.php
@@ -25,20 +25,28 @@ class CarThrottleBridge extends BridgeAbstract
             $articlePage = getSimpleHTMLDOMCached($item['uri'])
                 or returnServerError('could not retrieve page');
 
-            $item['author'] = $articlePage->find('div.author div')[1]->innertext;
-
-            $dinges = $articlePage->find('div.main-body')[0];
-            //remove ads
-            foreach ($dinges->find('aside') as $ad) {
-                $ad->outertext = '';
-                $dinges->save();
+            $authorDiv = $articlePage->find('div.author div');
+            if ($authorDiv) {
+                $item['author'] = $authorDiv[1]->innertext;
             }
 
-            $item['content'] = $articlePage->find('div.summary')[0] .
-                $articlePage->find('figure.main-image')[0] .
-                $dinges;
+            $dinges = $articlePage->find('div.main-body')[0] ?? null;
+            //remove ads
+            if ($dinges) {
+                foreach ($dinges->find('aside') as $ad) {
+                    $ad->outertext = '';
+                    $dinges->save();
+                }
+            }
+
+            $var = $articlePage->find('div.summary')[0] ?? '';
+            $var1 = $articlePage->find('figure.main-image')[0] ?? '';
+            $dinges1 = $dinges ?? '';
+
+            $item['content'] = $var .
+                $var1 .
+                $dinges1;
 
-            //add the item to the list
             array_push($this->items, $item);
         }
     }
diff --git a/bridges/GatesNotesBridge.php b/bridges/GatesNotesBridge.php
index 61dccb1a..24ba9b2e 100644
--- a/bridges/GatesNotesBridge.php
+++ b/bridges/GatesNotesBridge.php
@@ -23,9 +23,11 @@ class GatesNotesBridge extends BridgeAbstract
         $cleanedContent = str_replace([
             '<string xmlns="http://schemas.microsoft.com/2003/10/Serialization/">',
             '</string>',
+            '\r\n',
         ], '', $rawContent);
+        $cleanedContent = str_replace('\"', '"', $cleanedContent);
+        $cleanedContent = trim($cleanedContent, '"');
 
-        // The content is actually a json between quotes with \r\n inserted
         $json = Json::decode($cleanedContent, false);
 
         foreach ($json as $article) {
@@ -98,7 +100,7 @@ class GatesNotesBridge extends BridgeAbstract
         }
         $article_body = sanitize($article_body->innertext);
 
-        $content = $top_description . $hero_image . $article_body;
+        $content = $top_description . ($hero_image ?? '') . $article_body;
 
         return $content;
     }
diff --git a/lib/contents.php b/lib/contents.php
index cfb9f36a..a3830ca7 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -158,13 +158,12 @@ function getSimpleHTMLDOM(
     $defaultBRText = DEFAULT_BR_TEXT,
     $defaultSpanText = DEFAULT_SPAN_TEXT
 ) {
-    $content = getContents(
-        $url,
-        $header ?? [],
-        $opts ?? []
-    );
+    $html = getContents($url, $header ?? [], $opts ?? []);
+    if ($html === '') {
+        throw new \Exception('Unable to parse dom because the http response was the empty string');
+    }
     return str_get_html(
-        $content,
+        $html,
         $lowercase,
         $forceTagsClosed,
         $target_charset,

From e55a88fb8ea6133bdc23076f1af80726b48c245a Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 12 Oct 2023 20:32:17 +0200
Subject: [PATCH 162/716] refactor(nyaa) (#3742)

---
 bridges/NyaaTorrentsBridge.php | 76 +++++++++++-----------------------
 1 file changed, 25 insertions(+), 51 deletions(-)

diff --git a/bridges/NyaaTorrentsBridge.php b/bridges/NyaaTorrentsBridge.php
index da3c34f5..3129bfc4 100644
--- a/bridges/NyaaTorrentsBridge.php
+++ b/bridges/NyaaTorrentsBridge.php
@@ -6,20 +6,6 @@ class NyaaTorrentsBridge extends FeedExpander
     const NAME = 'NyaaTorrents';
     const URI = 'https://nyaa.si/';
     const DESCRIPTION = 'Returns the newest torrents, with optional search criteria.';
-    const MAX_ITEMS = 20;
-    const CUSTOM_FIELD_PREFIX = 'nyaa:';
-    const CUSTOM_FIELDS = [
-        self::CUSTOM_FIELD_PREFIX . 'seeders' => 'seeders',
-        self::CUSTOM_FIELD_PREFIX . 'leechers' => 'leechers',
-        self::CUSTOM_FIELD_PREFIX . 'downloads' => 'downloads',
-        self::CUSTOM_FIELD_PREFIX . 'infoHash' => 'infoHash',
-        self::CUSTOM_FIELD_PREFIX . 'categoryId' => 'categoryId',
-        self::CUSTOM_FIELD_PREFIX . 'category' => 'category',
-        self::CUSTOM_FIELD_PREFIX . 'size' => 'size',
-        self::CUSTOM_FIELD_PREFIX . 'comments' => 'comments',
-        self::CUSTOM_FIELD_PREFIX . 'trusted' => 'trusted',
-        self::CUSTOM_FIELD_PREFIX . 'remake' => 'remake'
-    ];
     const PARAMETERS = [
         [
             'f' => [
@@ -74,58 +60,31 @@ class NyaaTorrentsBridge extends FeedExpander
         ]
     ];
 
-    public function getIcon()
-    {
-        return self::URI . 'static/favicon.png';
-    }
-
-    public function getURI()
-    {
-        return self::URI . '?page=rss&s=id&o=desc&'
-            . http_build_query([
-                'f' => $this->getInput('f'),
-                'c' => $this->getInput('c'),
-                'q' => $this->getInput('q'),
-                'u' => $this->getInput('u')
-            ]);
-    }
-
     public function collectData()
     {
-        $content = getContents($this->getURI());
-        $content = $this->fixCustomFields($content);
-        $rssContent = simplexml_load_string(trim($content));
-        $this->collectRss2($rssContent, self::MAX_ITEMS);
-    }
-
-    private function fixCustomFields($content)
-    {
-        $broken = array_keys(self::CUSTOM_FIELDS);
-        $fixed = array_values(self::CUSTOM_FIELDS);
-        return str_replace($broken, $fixed, $content);
+        $this->collectExpandableDatas($this->getURI());
     }
 
     protected function parseItem($newItem)
     {
         $item = parent::parseRss2Item($newItem);
-
-        // Add nyaa custom fields
         $item['id'] = str_replace(['https://nyaa.si/download/', '.torrent'], '', $item['uri']);
-        foreach (array_values(self::CUSTOM_FIELDS) as $value) {
-            $item[$value] = (string) $newItem->$value;
-        }
 
-        //Convert URI from torrent file to web page
+        $nyaaFields = (array)($newItem->children('nyaa', true));
+        $item = array_merge($item, $nyaaFields);
+
+        // Convert URI from torrent file to web page
         $item['uri'] = str_replace('/download/', '/view/', $item['uri']);
         $item['uri'] = str_replace('.torrent', '', $item['uri']);
 
-        if ($item_html = getSimpleHTMLDOMCached($item['uri'])) {
-            //Retrieve full description from page contents
+        $item_html = getSimpleHTMLDOMCached($item['uri']);
+        if ($item_html) {
+            // Retrieve full description from page contents
             $item_desc = str_get_html(
                 markdownToHtml(html_entity_decode($item_html->find('#torrent-description', 0)->innertext))
             );
 
-            //Retrieve image for thumbnail or generic logo fallback
+            // Retrieve image for thumbnail or generic logo fallback
             $item_image = $this->getURI() . 'static/img/avatar/default.png';
             foreach ($item_desc->find('img') as $img) {
                 if (strpos($img->src, 'prez') === false) {
@@ -134,11 +93,26 @@ class NyaaTorrentsBridge extends FeedExpander
                 }
             }
 
-            //Add expanded fields to the current item
             $item['enclosures'] = [$item_image];
             $item['content'] = $item_desc;
         }
 
         return $item;
     }
+
+    public function getIcon()
+    {
+        return self::URI . 'static/favicon.png';
+    }
+
+    public function getURI()
+    {
+        $params = [
+            'f' => $this->getInput('f'),
+            'c' => $this->getInput('c'),
+            'q' => $this->getInput('q'),
+            'u' => $this->getInput('u'),
+        ];
+        return self::URI . '?page=rss&s=id&o=desc&' . http_build_query($params);
+    }
 }

From 6634291c67194428241f84d48f236a3037492bee Mon Sep 17 00:00:00 2001
From: Jisagi <Jisagi@users.noreply.github.com>
Date: Thu, 12 Oct 2023 21:24:08 +0200
Subject: [PATCH 163/716] NyaaTorrentsBridge - add max items again (#3743)

---
 bridges/NyaaTorrentsBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/NyaaTorrentsBridge.php b/bridges/NyaaTorrentsBridge.php
index 3129bfc4..22225be8 100644
--- a/bridges/NyaaTorrentsBridge.php
+++ b/bridges/NyaaTorrentsBridge.php
@@ -62,7 +62,7 @@ class NyaaTorrentsBridge extends FeedExpander
 
     public function collectData()
     {
-        $this->collectExpandableDatas($this->getURI());
+        $this->collectExpandableDatas($this->getURI(), 20);
     }
 
     protected function parseItem($newItem)

From 9bda9e246a21a44daeeb08dd1f41665e5a9f16e3 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 12 Oct 2023 22:14:04 +0200
Subject: [PATCH 164/716] refactor: FeedExpander (#3740)

* refactor: FeedExpander
---
 bridges/CssSelectorFeedExpanderBridge.php |   4 +
 bridges/FeedExpanderExampleBridge.php     |  17 +-
 bridges/MastodonBridge.php                |   4 +-
 bridges/NyaaTorrentsBridge.php            |   2 +-
 bridges/RaceDepartmentBridge.php          |   2 +-
 index.php                                 |  50 +++
 lib/FeedExpander.php                      | 482 +++-------------------
 lib/FeedParser.php                        | 205 +++++++++
 lib/RssBridge.php                         |  53 ---
 9 files changed, 315 insertions(+), 504 deletions(-)
 create mode 100644 lib/FeedParser.php

diff --git a/bridges/CssSelectorFeedExpanderBridge.php b/bridges/CssSelectorFeedExpanderBridge.php
index 7e1f630f..008921b1 100644
--- a/bridges/CssSelectorFeedExpanderBridge.php
+++ b/bridges/CssSelectorFeedExpanderBridge.php
@@ -61,6 +61,10 @@ class CssSelectorFeedExpanderBridge extends CssSelectorBridge
         $discard_thumbnail = $this->getInput('discard_thumbnail');
         $limit = $this->getInput('limit');
 
+        //$xmlString = getContents($url);
+        //$feed = (new FeedParser())->parseFeed($xmlString);
+        //$items = $feed['items'];
+
         $feed_expander = new CssSelectorFeedExpanderBridgeInternal();
         $items = $feed_expander->collectExpandableDatas($url)->getItems();
 
diff --git a/bridges/FeedExpanderExampleBridge.php b/bridges/FeedExpanderExampleBridge.php
index a6b37f65..0e9ae386 100644
--- a/bridges/FeedExpanderExampleBridge.php
+++ b/bridges/FeedExpanderExampleBridge.php
@@ -46,21 +46,6 @@ class FeedExpanderExampleBridge extends FeedExpander
 
     protected function parseItem($newsItem)
     {
-        switch ($this->getInput('version')) {
-            case 'rss_0_9_1':
-                return $this->parseRss091Item($newsItem);
-                break;
-            case 'rss_1_0':
-                return $this->parseRss1Item($newsItem);
-                break;
-            case 'rss_2_0':
-                return $this->parseRss2Item($newsItem);
-                break;
-            case 'atom_1_0':
-                return $this->parseATOMItem($newsItem);
-                break;
-            default:
-                returnClientError('Unknown version ' . $this->getInput('version') . '!');
-        }
+        return (array) $newsItem;
     }
 }
diff --git a/bridges/MastodonBridge.php b/bridges/MastodonBridge.php
index cae556b8..01d425b4 100644
--- a/bridges/MastodonBridge.php
+++ b/bridges/MastodonBridge.php
@@ -82,14 +82,14 @@ class MastodonBridge extends BridgeAbstract
         }
         $items = $content['orderedItems'] ?? $content['items'];
         foreach ($items as $status) {
-            $item = $this->parseItem($status);
+            $item = $this->parseStatus($status);
             if ($item) {
                 $this->items[] = $item;
             }
         }
     }
 
-    protected function parseItem($content)
+    protected function parseStatus($content)
     {
         $item = [];
         switch ($content['type']) {
diff --git a/bridges/NyaaTorrentsBridge.php b/bridges/NyaaTorrentsBridge.php
index 22225be8..217db377 100644
--- a/bridges/NyaaTorrentsBridge.php
+++ b/bridges/NyaaTorrentsBridge.php
@@ -67,7 +67,7 @@ class NyaaTorrentsBridge extends FeedExpander
 
     protected function parseItem($newItem)
     {
-        $item = parent::parseRss2Item($newItem);
+        $item = parent::parseItem($newItem);
         $item['id'] = str_replace(['https://nyaa.si/download/', '.torrent'], '', $item['uri']);
 
         $nyaaFields = (array)($newItem->children('nyaa', true));
diff --git a/bridges/RaceDepartmentBridge.php b/bridges/RaceDepartmentBridge.php
index c33ee67a..7fe92b4a 100644
--- a/bridges/RaceDepartmentBridge.php
+++ b/bridges/RaceDepartmentBridge.php
@@ -14,7 +14,7 @@ class RaceDepartmentBridge extends FeedExpander
 
     protected function parseItem($feedItem)
     {
-        $item = parent::parseRss2Item($feedItem);
+        $item = parent::parseItem($feedItem);
 
         //fetch page
         $articlePage = getSimpleHTMLDOMCached($feedItem->link);
diff --git a/index.php b/index.php
index 9181c0b0..123f6ecd 100644
--- a/index.php
+++ b/index.php
@@ -6,6 +6,56 @@ if (version_compare(\PHP_VERSION, '7.4.0') === -1) {
 
 require_once __DIR__ . '/lib/bootstrap.php';
 
+Configuration::verifyInstallation();
+$customConfig = [];
+if (file_exists(__DIR__ . '/config.ini.php')) {
+    $customConfig = parse_ini_file(__DIR__ . '/config.ini.php', true, INI_SCANNER_TYPED);
+}
+Configuration::loadConfiguration($customConfig, getenv());
+
+// Consider: ini_set('error_reporting', E_ALL & ~E_DEPRECATED);
+date_default_timezone_set(Configuration::getConfig('system', 'timezone'));
+
 $rssBridge = new RssBridge();
 
+set_exception_handler(function (\Throwable $e) {
+    http_response_code(500);
+    print render(__DIR__ . '/templates/exception.html.php', ['e' => $e]);
+    RssBridge::getLogger()->error('Uncaught Exception', ['e' => $e]);
+    exit(1);
+});
+
+set_error_handler(function ($code, $message, $file, $line) {
+    if ((error_reporting() & $code) === 0) {
+        return false;
+    }
+    // In the future, uncomment this:
+    //throw new \ErrorException($message, 0, $code, $file, $line);
+    $text = sprintf(
+        '%s at %s line %s',
+        sanitize_root($message),
+        sanitize_root($file),
+        $line
+    );
+    RssBridge::getLogger()->warning($text);
+});
+
+// There might be some fatal errors which are not caught by set_error_handler() or \Throwable.
+register_shutdown_function(function () {
+    $error = error_get_last();
+    if ($error) {
+        $message = sprintf(
+            '(shutdown) %s: %s in %s line %s',
+            $error['type'],
+            sanitize_root($error['message']),
+            sanitize_root($error['file']),
+            $error['line']
+        );
+        RssBridge::getLogger()->error($message);
+        if (Debug::isEnabled()) {
+            print sprintf("<pre>%s</pre>\n", e($message));
+        }
+    }
+});
+
 $rssBridge->main($argv ?? []);
diff --git a/lib/FeedExpander.php b/lib/FeedExpander.php
index 76f570b6..70c4560d 100644
--- a/lib/FeedExpander.php
+++ b/lib/FeedExpander.php
@@ -1,95 +1,37 @@
 <?php
 
 /**
- * An abstract class for bridges that need to transform existing RSS or Atom
- * feeds.
- *
- * This class extends {@see BridgeAbstract} with functions to extract contents
- * from existing RSS or Atom feeds. Bridges that need to transform existing feeds
- * should inherit from this class instead of {@see BridgeAbstract}.
- *
- * Bridges that extend this class don't need to concern themselves with getting
- * contents from existing feeds, but can focus on adding additional contents
- * (i.e. by downloading additional data), filtering or just transforming a feed
- * into another format.
- *
- * @link http://www.rssboard.org/rss-0-9-1 RSS 0.91 Specification
- * @link http://web.resource.org/rss/1.0/spec RDF Site Summary (RSS) 1.0
- * @link http://www.rssboard.org/rss-specification RSS 2.0 Specification
- * @link https://tools.ietf.org/html/rfc4287 The Atom Syndication Format
- *
- * @todo The parsing functions should all be private. This class is complicated
- * enough without having to consider children overriding functions.
+ * Expands an existing feed
  */
 abstract class FeedExpander extends BridgeAbstract
 {
-    /** Indicates an RSS 1.0 feed */
     const FEED_TYPE_RSS_1_0 = 'RSS_1_0';
-
-    /** Indicates an RSS 2.0 feed */
     const FEED_TYPE_RSS_2_0 = 'RSS_2_0';
-
-    /** Indicates an Atom 1.0 feed */
     const FEED_TYPE_ATOM_1_0 = 'ATOM_1_0';
 
-    /**
-     * Holds the title of the current feed
-     *
-     * @var string
-     */
-    private $title;
+    private string $feedType;
+    private FeedParser $feedParser;
+    private array $parsedFeed;
 
-    /**
-     * Holds the URI of the feed
-     *
-     * @var string
-     */
-    private $uri;
-
-    /**
-     * Holds the icon of the feed
-     *
-     */
-    private $icon;
-
-    /**
-     * Holds the feed type during internal operations.
-     *
-     * @var string
-     */
-    private $feedType;
-
-    /**
-     * Collects data from an existing feed.
-     *
-     * Children should call this function in {@see BridgeAbstract::collectData()}
-     * to extract a feed.
-     *
-     * @param string $url URL to the feed.
-     * @param int $maxItems Maximum number of items to collect from the feed
-     * (`-1`: no limit).
-     * @return self
-     */
-    public function collectExpandableDatas($url, $maxItems = -1)
+    public function __construct(CacheInterface $cache, Logger $logger)
     {
-        if (empty($url)) {
+        parent::__construct($cache, $logger);
+        $this->feedParser = new FeedParser();
+    }
+
+    public function collectExpandableDatas(string $url, $maxItems = -1)
+    {
+        if (!$url) {
             throw new \Exception('There is no $url for this RSS expander');
         }
-
-        Debug::log(sprintf('Loading from %s', $url));
-
-        /* Notice we do not use cache here on purpose:
-         * we want a fresh view of the RSS stream each time
-         */
-
-        $mimeTypes = [
-            MrssFormat::MIME_TYPE,
-            AtomFormat::MIME_TYPE,
-            '*/*',
-        ];
-        $httpHeaders = ['Accept: ' . implode(', ', $mimeTypes)];
-        $xml = getContents($url, $httpHeaders);
-        if ($xml === '') {
+        if ($maxItems === -1) {
+            $maxItems = 999;
+        }
+        $accept = [MrssFormat::MIME_TYPE, AtomFormat::MIME_TYPE, '*/*'];
+        $httpHeaders = ['Accept: ' . implode(', ', $accept)];
+        // Notice we do not use cache here on purpose. We want a fresh view of the RSS stream each time
+        $xmlString = getContents($url, $httpHeaders);
+        if ($xmlString === '') {
             throw new \Exception(sprintf('Unable to parse xml from `%s` because we got the empty string', $url), 10);
         }
         // Maybe move this call earlier up the stack frames
@@ -97,8 +39,8 @@ abstract class FeedExpander extends BridgeAbstract
         libxml_use_internal_errors(true);
         // Consider replacing libxml with https://www.php.net/domdocument
         // Intentionally not using the silencing operator (@) because it has no effect here
-        $rssContent = simplexml_load_string(trim($xml));
-        if ($rssContent === false) {
+        $xml = simplexml_load_string(trim($xmlString));
+        if ($xml === false) {
             $xmlErrors = libxml_get_errors();
             foreach ($xmlErrors as $xmlError) {
                 Debug::log(trim($xmlError->message));
@@ -112,384 +54,62 @@ abstract class FeedExpander extends BridgeAbstract
         // Restore previous behaviour in case other code relies on it being off
         libxml_use_internal_errors(false);
 
-        // Commented out because it's spammy
-        // Debug::log(sprintf("RSS content is ===========\n%s===========", var_export($rssContent, true)));
+        // Currently only feed metadata (not items) are plucked out
+        $this->parsedFeed = $this->feedParser->parseFeed($xmlString);
 
-        switch (true) {
-            case isset($rssContent->item[0]):
-                Debug::log('Detected RSS 1.0 format');
-                $this->feedType = self::FEED_TYPE_RSS_1_0;
-                $this->collectRss1($rssContent, $maxItems);
-                break;
-            case isset($rssContent->channel[0]):
-                Debug::log('Detected RSS 0.9x or 2.0 format');
-                $this->feedType = self::FEED_TYPE_RSS_2_0;
-                $this->collectRss2($rssContent, $maxItems);
-                break;
-            case isset($rssContent->entry[0]):
-                Debug::log('Detected ATOM format');
-                $this->feedType = self::FEED_TYPE_ATOM_1_0;
-                $this->collectAtom1($rssContent, $maxItems);
-                break;
-            default:
-                Debug::log(sprintf('Unable to detect feed format from `%s`', $url));
-                throw new \Exception(sprintf('Unable to detect feed format from `%s`', $url));
+        if (isset($xml->item[0])) {
+            $this->feedType = self::FEED_TYPE_RSS_1_0;
+            $items = $xml->item;
+        } elseif (isset($xml->channel[0])) {
+            $this->feedType = self::FEED_TYPE_RSS_2_0;
+            $items = $xml->channel[0]->item;
+        } elseif (isset($xml->entry[0])) {
+            $this->feedType = self::FEED_TYPE_ATOM_1_0;
+            $items = $xml->entry;
+        } else {
+            throw new \Exception(sprintf('Unable to detect feed format from `%s`', $url));
+        }
+        foreach ($items as $item) {
+            $parsedItem = $this->parseItem($item);
+            if ($parsedItem) {
+                $this->items[] = $parsedItem;
+            }
+            if (count($this->items) >= $maxItems) {
+                break;
+            }
         }
-
         return $this;
     }
 
     /**
-     * Collect data from an RSS 1.0 compatible feed
-     *
-     * @link http://web.resource.org/rss/1.0/spec RDF Site Summary (RSS) 1.0
-     *
-     * @param string $rssContent The RSS content
-     * @param int $maxItems Maximum number of items to collect from the feed
-     * (`-1`: no limit).
-     * @return void
-     *
-     * @todo Instead of passing $maxItems to all functions, just add all items
-     * and remove excessive items later.
-     */
-    protected function collectRss1($rssContent, $maxItems)
-    {
-        $this->loadRss2Data($rssContent->channel[0]);
-        foreach ($rssContent->item as $item) {
-            $tmp_item = $this->parseItem($item);
-            if (!empty($tmp_item)) {
-                $this->items[] = $tmp_item;
-            }
-            if ($maxItems !== -1 && count($this->items) >= $maxItems) {
-                break;
-            }
-        }
-    }
-
-    /**
-     * Collect data from a RSS 2.0 compatible feed
-     *
-     * @link http://www.rssboard.org/rss-specification RSS 2.0 Specification
-     *
-     * @param int $maxItems Maximum number of items to collect from the feed (`-1`: no limit).
-     * @return void
-     *
-     * @todo Instead of passing $maxItems to all functions, just add all items and remove excessive items later.
-     */
-    protected function collectRss2(\SimpleXMLElement $rssContent, $maxItems)
-    {
-        $rssContent = $rssContent->channel[0];
-        $this->loadRss2Data($rssContent);
-        foreach ($rssContent->item as $item) {
-            $tmp_item = $this->parseItem($item);
-            if (!empty($tmp_item)) {
-                $this->items[] = $tmp_item;
-            }
-            if ($maxItems !== -1 && count($this->items) >= $maxItems) {
-                break;
-            }
-        }
-    }
-
-    /**
-     * Collect data from a Atom 1.0 compatible feed
-     *
-     * @link https://tools.ietf.org/html/rfc4287  The Atom Syndication Format
-     *
-     * @param object $content The Atom content
-     * @param int $maxItems Maximum number of items to collect from the feed
-     * (`-1`: no limit).
-     * @return void
-     *
-     * @todo Instead of passing $maxItems to all functions, just add all items
-     * and remove excessive items later.
-     */
-    protected function collectAtom1($content, $maxItems)
-    {
-        $this->loadAtomData($content);
-        foreach ($content->entry as $item) {
-            $tmp_item = $this->parseItem($item);
-            if (!empty($tmp_item)) {
-                $this->items[] = $tmp_item;
-            }
-            if ($maxItems !== -1 && count($this->items) >= $maxItems) {
-                break;
-            }
-        }
-    }
-
-    /**
-     * Load RSS 2.0 feed data into RSS-Bridge
-     *
-     * @param object $rssContent The RSS content
-     * @return void
-     *
-     * @todo set title, link, description, language, and so on
-     */
-    protected function loadRss2Data($rssContent)
-    {
-        $this->title = trim((string)$rssContent->title);
-        $this->uri = trim((string)$rssContent->link);
-
-        if (!empty($rssContent->image)) {
-            $this->icon = trim((string)$rssContent->image->url);
-        }
-    }
-
-    /**
-     * Load Atom feed data into RSS-Bridge
-     *
-     * @param object $content The Atom content
-     * @return void
-     */
-    protected function loadAtomData($content)
-    {
-        $this->title = (string)$content->title;
-
-        // Find best link (only one, or first of 'alternate')
-        if (!isset($content->link)) {
-            $this->uri = '';
-        } elseif (count($content->link) === 1) {
-            $this->uri = (string)$content->link[0]['href'];
-        } else {
-            $this->uri = '';
-            foreach ($content->link as $link) {
-                if (strtolower($link['rel']) === 'alternate') {
-                    $this->uri = (string)$link['href'];
-                    break;
-                }
-            }
-        }
-
-        if (!empty($content->icon)) {
-            $this->icon = (string)$content->icon;
-        } elseif (!empty($content->logo)) {
-            $this->icon = (string)$content->logo;
-        }
-    }
-
-    /**
-     * Parse the contents of a single Atom feed item into a RSS-Bridge item for
-     * further transformation.
-     *
-     * @param object $feedItem A single feed item
-     * @return object The RSS-Bridge item
-     *
-     * @todo To reduce confusion, the RSS-Bridge item should maybe have a class
-     * of its own?
-     */
-    protected function parseATOMItem($feedItem)
-    {
-        // Some ATOM entries also contain RSS 2.0 fields
-        $item = $this->parseRss2Item($feedItem);
-
-        if (isset($feedItem->id)) {
-            $item['uri'] = (string)$feedItem->id;
-        }
-        if (isset($feedItem->title)) {
-            $item['title'] = html_entity_decode((string)$feedItem->title);
-        }
-        if (isset($feedItem->updated)) {
-            $item['timestamp'] = strtotime((string)$feedItem->updated);
-        }
-        if (isset($feedItem->author)) {
-            $item['author'] = (string)$feedItem->author->name;
-        }
-        if (isset($feedItem->content)) {
-            $contentChildren = $feedItem->content->children();
-            if (count($contentChildren) > 0) {
-                $content = '';
-                foreach ($contentChildren as $contentChild) {
-                    $content .= $contentChild->asXML();
-                }
-                $item['content'] = $content;
-            } else {
-                $item['content'] = (string)$feedItem->content;
-            }
-        }
-
-        //When "link" field is present, URL is more reliable than "id" field
-        if (count($feedItem->link) === 1) {
-            $item['uri'] = (string)$feedItem->link[0]['href'];
-        } else {
-            foreach ($feedItem->link as $link) {
-                if (strtolower($link['rel']) === 'alternate') {
-                    $item['uri'] = (string)$link['href'];
-                }
-                if (strtolower($link['rel']) === 'enclosure') {
-                    $item['enclosures'][] = (string)$link['href'];
-                }
-            }
-        }
-
-        return $item;
-    }
-
-    /**
-     * Parse the contents of a single RSS 0.91 feed item into a RSS-Bridge item
-     * for further transformation.
-     *
-     * @param object $feedItem A single feed item
-     * @return object The RSS-Bridge item
-     *
-     * @todo To reduce confusion, the RSS-Bridge item should maybe have a class
-     * of its own?
-     */
-    protected function parseRss091Item($feedItem)
-    {
-        $item = [];
-        if (isset($feedItem->link)) {
-            $item['uri'] = (string)$feedItem->link;
-        }
-        if (isset($feedItem->title)) {
-            $item['title'] = html_entity_decode((string)$feedItem->title);
-        }
-        // rss 0.91 doesn't support timestamps
-        // rss 0.91 doesn't support authors
-        // rss 0.91 doesn't support enclosures
-        if (isset($feedItem->description)) {
-            $item['content'] = (string)$feedItem->description;
-        }
-        return $item;
-    }
-
-    /**
-     * Parse the contents of a single RSS 1.0 feed item into a RSS-Bridge item
-     * for further transformation.
-     *
-     * @param object $feedItem A single feed item
-     * @return object The RSS-Bridge item
-     *
-     * @todo To reduce confusion, the RSS-Bridge item should maybe have a class
-     * of its own?
-     */
-    protected function parseRss1Item($feedItem)
-    {
-        // 1.0 adds optional elements around the 0.91 standard
-        $item = $this->parseRss091Item($feedItem);
-
-        $namespaces = $feedItem->getNamespaces(true);
-        if (isset($namespaces['dc'])) {
-            $dc = $feedItem->children($namespaces['dc']);
-            if (isset($dc->date)) {
-                $item['timestamp'] = strtotime((string)$dc->date);
-            }
-            if (isset($dc->creator)) {
-                $item['author'] = (string)$dc->creator;
-            }
-        }
-
-        return $item;
-    }
-
-    /**
-     * Parse the contents of a single RSS 2.0 feed item into a RSS-Bridge item
-     * for further transformation.
-     *
-     * @param object $feedItem A single feed item
-     * @return object The RSS-Bridge item
-     *
-     * @todo To reduce confusion, the RSS-Bridge item should maybe have a class
-     * of its own?
-     */
-    protected function parseRss2Item($feedItem)
-    {
-        // Primary data is compatible to 0.91 with some additional data
-        $item = $this->parseRss091Item($feedItem);
-
-        $namespaces = $feedItem->getNamespaces(true);
-        if (isset($namespaces['dc'])) {
-            $dc = $feedItem->children($namespaces['dc']);
-        }
-        if (isset($namespaces['media'])) {
-            $media = $feedItem->children($namespaces['media']);
-        }
-
-        if (isset($feedItem->guid)) {
-            foreach ($feedItem->guid->attributes() as $attribute => $value) {
-                if (
-                    $attribute === 'isPermaLink'
-                    && (
-                        $value === 'true' || (
-                            filter_var($feedItem->guid, FILTER_VALIDATE_URL)
-                            && (empty($item['uri']) || !filter_var($item['uri'], FILTER_VALIDATE_URL))
-                        )
-                    )
-                ) {
-                    $item['uri'] = (string)$feedItem->guid;
-                    break;
-                }
-            }
-        }
-
-        if (isset($feedItem->pubDate)) {
-            $item['timestamp'] = strtotime((string)$feedItem->pubDate);
-        } elseif (isset($dc->date)) {
-            $item['timestamp'] = strtotime((string)$dc->date);
-        }
-
-        if (isset($feedItem->author)) {
-            $item['author'] = (string)$feedItem->author;
-        } elseif (isset($feedItem->creator)) {
-            $item['author'] = (string)$feedItem->creator;
-        } elseif (isset($dc->creator)) {
-            $item['author'] = (string)$dc->creator;
-        } elseif (isset($media->credit)) {
-            $item['author'] = (string)$media->credit;
-        }
-
-        if (isset($feedItem->enclosure) && !empty($feedItem->enclosure['url'])) {
-            $item['enclosures'] = [(string)$feedItem->enclosure['url']];
-        }
-
-        return $item;
-    }
-
-    /**
-     * Parse the contents of a single feed item, depending on the current feed
-     * type, into a RSS-Bridge item.
-     *
-     * @param object $item The current feed item
-     * @return object A RSS-Bridge item, with (hopefully) the whole content
+     * @param \SimpleXMLElement $item The feed item to be parsed
      */
     protected function parseItem($item)
     {
         switch ($this->feedType) {
             case self::FEED_TYPE_RSS_1_0:
-                return $this->parseRss1Item($item);
+                return $this->feedParser->parseRss1Item($item);
             case self::FEED_TYPE_RSS_2_0:
-                return $this->parseRss2Item($item);
+                return $this->feedParser->parseRss2Item($item);
             case self::FEED_TYPE_ATOM_1_0:
-                return $this->parseATOMItem($item);
+                return $this->feedParser->parseAtomItem($item);
             default:
                 throw new \Exception(sprintf('Unknown version %s!', $this->getInput('version')));
         }
     }
 
-    /** {@inheritdoc} */
     public function getURI()
     {
-        if (!empty($this->uri)) {
-            return $this->uri;
-        }
-        return parent::getURI();
+        return $this->parsedFeed['uri'] ?? parent::getURI();
     }
 
-    /** {@inheritdoc} */
     public function getName()
     {
-        if (!empty($this->title)) {
-            return $this->title;
-        }
-        return parent::getName();
+        return $this->parsedFeed['title'] ?? parent::getName();
     }
 
-    /** {@inheritdoc} */
     public function getIcon()
     {
-        if (!empty($this->icon)) {
-            return $this->icon;
-        }
-        return parent::getIcon();
+        return $this->parsedFeed['icon'] ?? parent::getIcon();
     }
 }
diff --git a/lib/FeedParser.php b/lib/FeedParser.php
new file mode 100644
index 00000000..90df548d
--- /dev/null
+++ b/lib/FeedParser.php
@@ -0,0 +1,205 @@
+<?php
+
+declare(strict_types=1);
+
+final class FeedParser
+{
+    public function parseFeed(string $xmlString): array
+    {
+        $xml = simplexml_load_string(trim($xmlString));
+        if ($xml === false) {
+            throw new \Exception('Unable to parse xml');
+        }
+        $feed = [
+            'title' => null,
+            'url'   => null,
+            'icon'  => null,
+            'items' => [],
+        ];
+        if (isset($xml->item[0])) {
+            // rss 1.0
+            $channel = $xml->channel[0];
+            $feed['title'] = trim((string)$channel->title);
+            $feed['uri'] = trim((string)$channel->link);
+            if (!empty($channel->image)) {
+                $feed['icon'] = trim((string)$channel->image->url);
+            }
+            foreach ($xml->item as $item) {
+                $feed['items'][] = $this->parseRss1Item($item);
+            }
+        } elseif (isset($xml->channel[0])) {
+            // rss 2.0
+            $channel = $xml->channel[0];
+            $feed['title'] = trim((string)$channel->title);
+            $feed['uri'] = trim((string)$channel->link);
+            if (!empty($channel->image)) {
+                $feed['icon'] = trim((string)$channel->image->url);
+            }
+            foreach ($channel->item as $item) {
+                $feed['items'][] = $this->parseRss2Item($item);
+            }
+        } elseif (isset($xml->entry[0])) {
+            // atom 1.0
+            $feed['title'] = (string)$xml->title;
+            // Find best link (only one, or first of 'alternate')
+            if (!isset($xml->link)) {
+                $feed['uri'] = '';
+            } elseif (count($xml->link) === 1) {
+                $feed['uri'] = (string)$xml->link[0]['href'];
+            } else {
+                $feed['uri'] = '';
+                foreach ($xml->link as $link) {
+                    if (strtolower((string) $link['rel']) === 'alternate') {
+                        $feed['uri'] = (string)$link['href'];
+                        break;
+                    }
+                }
+            }
+            if (!empty($xml->icon)) {
+                $feed['icon'] = (string)$xml->icon;
+            } elseif (!empty($xml->logo)) {
+                $feed['icon'] = (string)$xml->logo;
+            }
+            foreach ($xml->entry as $item) {
+                $feed['items'][] = $this->parseAtomItem($item);
+            }
+        } else {
+            throw new \Exception(sprintf('Unable to detect feed format from `%s`', $url));
+        }
+
+        return $feed;
+    }
+
+    public function parseAtomItem(\SimpleXMLElement $feedItem): array
+    {
+        // Some ATOM entries also contain RSS 2.0 fields
+        $item = $this->parseRss2Item($feedItem);
+
+        if (isset($feedItem->id)) {
+            $item['uri'] = (string)$feedItem->id;
+        }
+        if (isset($feedItem->title)) {
+            $item['title'] = html_entity_decode((string)$feedItem->title);
+        }
+        if (isset($feedItem->updated)) {
+            $item['timestamp'] = strtotime((string)$feedItem->updated);
+        }
+        if (isset($feedItem->author)) {
+            $item['author'] = (string)$feedItem->author->name;
+        }
+        if (isset($feedItem->content)) {
+            $contentChildren = $feedItem->content->children();
+            if (count($contentChildren) > 0) {
+                $content = '';
+                foreach ($contentChildren as $contentChild) {
+                    $content .= $contentChild->asXML();
+                }
+                $item['content'] = $content;
+            } else {
+                $item['content'] = (string)$feedItem->content;
+            }
+        }
+
+        // When "link" field is present, URL is more reliable than "id" field
+        if (count($feedItem->link) === 1) {
+            $item['uri'] = (string)$feedItem->link[0]['href'];
+        } else {
+            foreach ($feedItem->link as $link) {
+                if (strtolower((string) $link['rel']) === 'alternate') {
+                    $item['uri'] = (string)$link['href'];
+                }
+                if (strtolower((string) $link['rel']) === 'enclosure') {
+                    $item['enclosures'][] = (string)$link['href'];
+                }
+            }
+        }
+        return $item;
+    }
+
+    public function parseRss2Item(\SimpleXMLElement $feedItem): array
+    {
+        // Primary data is compatible to 0.91 with some additional data
+        $item = $this->parseRss091Item($feedItem);
+
+        $namespaces = $feedItem->getNamespaces(true);
+        if (isset($namespaces['dc'])) {
+            $dc = $feedItem->children($namespaces['dc']);
+        }
+        if (isset($namespaces['media'])) {
+            $media = $feedItem->children($namespaces['media']);
+        }
+
+        if (isset($feedItem->guid)) {
+            foreach ($feedItem->guid->attributes() as $attribute => $value) {
+                if (
+                    $attribute === 'isPermaLink'
+                    && (
+                        $value === 'true' || (
+                            filter_var($feedItem->guid, FILTER_VALIDATE_URL)
+                            && (empty($item['uri']) || !filter_var($item['uri'], FILTER_VALIDATE_URL))
+                        )
+                    )
+                ) {
+                    $item['uri'] = (string)$feedItem->guid;
+                    break;
+                }
+            }
+        }
+
+        if (isset($feedItem->pubDate)) {
+            $item['timestamp'] = strtotime((string)$feedItem->pubDate);
+        } elseif (isset($dc->date)) {
+            $item['timestamp'] = strtotime((string)$dc->date);
+        }
+
+        if (isset($feedItem->author)) {
+            $item['author'] = (string)$feedItem->author;
+        } elseif (isset($feedItem->creator)) {
+            $item['author'] = (string)$feedItem->creator;
+        } elseif (isset($dc->creator)) {
+            $item['author'] = (string)$dc->creator;
+        } elseif (isset($media->credit)) {
+            $item['author'] = (string)$media->credit;
+        }
+
+        if (isset($feedItem->enclosure) && !empty($feedItem->enclosure['url'])) {
+            $item['enclosures'] = [(string)$feedItem->enclosure['url']];
+        }
+        return $item;
+    }
+
+    public function parseRss1Item(\SimpleXMLElement $feedItem): array
+    {
+        // 1.0 adds optional elements around the 0.91 standard
+        $item = $this->parseRss091Item($feedItem);
+        $namespaces = $feedItem->getNamespaces(true);
+        if (isset($namespaces['dc'])) {
+            $dc = $feedItem->children($namespaces['dc']);
+            if (isset($dc->date)) {
+                $item['timestamp'] = strtotime((string)$dc->date);
+            }
+            if (isset($dc->creator)) {
+                $item['author'] = (string)$dc->creator;
+            }
+        }
+        return $item;
+    }
+
+    public function parseRss091Item(\SimpleXMLElement $feedItem): array
+    {
+        $item = [];
+        if (isset($feedItem->link)) {
+            $item['uri'] = (string)$feedItem->link;
+        }
+        if (isset($feedItem->title)) {
+            $item['title'] = html_entity_decode((string)$feedItem->title);
+        }
+        // rss 0.91 doesn't support timestamps
+        // rss 0.91 doesn't support authors
+        // rss 0.91 doesn't support enclosures
+        if (isset($feedItem->description)) {
+            $item['content'] = (string)$feedItem->description;
+        }
+        return $item;
+    }
+}
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index 2fb21323..d56c59b8 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -8,66 +8,13 @@ final class RssBridge
 
     public function __construct()
     {
-        Configuration::verifyInstallation();
-
-        $customConfig = [];
-        if (file_exists(__DIR__ . '/../config.ini.php')) {
-            $customConfig = parse_ini_file(__DIR__ . '/../config.ini.php', true, INI_SCANNER_TYPED);
-        }
-        Configuration::loadConfiguration($customConfig, getenv());
-
-        // Consider: ini_set('error_reporting', E_ALL & ~E_DEPRECATED);
-        date_default_timezone_set(Configuration::getConfig('system', 'timezone'));
-
-        set_exception_handler(function (\Throwable $e) {
-            self::$logger->error('Uncaught Exception', ['e' => $e]);
-            http_response_code(500);
-            print render(__DIR__ . '/../templates/exception.html.php', ['e' => $e]);
-            exit(1);
-        });
-
-        set_error_handler(function ($code, $message, $file, $line) {
-            if ((error_reporting() & $code) === 0) {
-                return false;
-            }
-            // In the future, uncomment this:
-            //throw new \ErrorException($message, 0, $code, $file, $line);
-            $text = sprintf(
-                '%s at %s line %s',
-                sanitize_root($message),
-                sanitize_root($file),
-                $line
-            );
-            self::$logger->warning($text);
-        });
-
-        // There might be some fatal errors which are not caught by set_error_handler() or \Throwable.
-        register_shutdown_function(function () {
-            $error = error_get_last();
-            if ($error) {
-                $message = sprintf(
-                    '(shutdown) %s: %s in %s line %s',
-                    $error['type'],
-                    sanitize_root($error['message']),
-                    sanitize_root($error['file']),
-                    $error['line']
-                );
-                self::$logger->error($message);
-                if (Debug::isEnabled()) {
-                    print sprintf("<pre>%s</pre>\n", e($message));
-                }
-            }
-        });
-
         self::$logger = new SimpleLogger('rssbridge');
         if (Debug::isEnabled()) {
             self::$logger->addHandler(new StreamHandler(Logger::DEBUG));
         } else {
             self::$logger->addHandler(new StreamHandler(Logger::INFO));
         }
-
         self::$httpClient = new CurlHttpClient();
-
         $cacheFactory = new CacheFactory(self::$logger);
         if (Debug::isEnabled()) {
             self::$cache = $cacheFactory->create('array');

From 382648fc22c232bc8c66111fc4d3ab6570946437 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 13 Oct 2023 00:25:34 +0200
Subject: [PATCH 165/716] refactor: FeedExpander::parseItem() descendants
 (#3744)

---
 bridges/AcrimedBridge.php               | 13 +++--
 bridges/ArsTechnicaBridge.php           |  4 +-
 bridges/BleepingComputerBridge.php      | 12 ++---
 bridges/CNETFranceBridge.php            |  7 ++-
 bridges/CaschyBridge.php                |  4 +-
 bridges/CommonDreamsBridge.php          |  4 +-
 bridges/CourrierInternationalBridge.php |  6 +--
 bridges/DarkReadingBridge.php           |  5 +-
 bridges/DauphineLibereBridge.php        |  4 +-
 bridges/DeveloppezDotComBridge.php      | 36 +++++++------
 bridges/EconomistBridge.php             | 15 +++---
 bridges/EngadgetBridge.php              | 20 +++----
 bridges/EsquerdaNetBridge.php           | 38 +++++++------
 bridges/FeedExpanderExampleBridge.php   |  5 --
 bridges/FeedExpanderTestBridge.php      | 23 ++++++++
 bridges/FilterBridge.php                |  4 +-
 bridges/ForGifsBridge.php               | 10 ++--
 bridges/FreeCodeCampBridge.php          | 14 ++---
 bridges/FuturaSciencesBridge.php        | 11 ++--
 bridges/HardwareInfoBridge.php          | 10 ++--
 bridges/HeiseBridge.php                 |  5 +-
 bridges/IGNBridge.php                   | 11 ++--
 bridges/LeMondeInformatiqueBridge.php   |  5 +-
 bridges/ListverseBridge.php             |  9 ++--
 bridges/MediapartBridge.php             | 14 +++--
 bridges/MsnMondeBridge.php              | 12 +++--
 bridges/NYTBridge.php                   | 11 ++--
 bridges/NextInpactBridge.php            |  5 +-
 bridges/NextgovBridge.php               |  3 +-
 bridges/NiceMatinBridge.php             |  5 +-
 bridges/NyaaTorrentsBridge.php          |  8 +--
 bridges/OnVaSortirBridge.php            | 16 +++---
 bridges/PhoronixBridge.php              | 17 +++---
 bridges/QwantzBridge.php                | 15 +++---
 bridges/RaceDepartmentBridge.php        |  7 ++-
 bridges/ScribbleHubBridge.php           | 18 +++----
 bridges/SplCenterBridge.php             | 11 ++--
 bridges/TapasBridge.php                 | 30 +++++------
 bridges/TheGuardianBridge.php           | 13 ++---
 bridges/TwitterEngineeringBridge.php    | 24 ++++-----
 bridges/VarietyBridge.php               |  6 +--
 bridges/ViceBridge.php                  | 10 ++--
 bridges/WiredBridge.php                 |  9 ++--
 bridges/WordPressBridge.php             | 72 ++++++++++++-------------
 bridges/WorldOfTanksBridge.php          |  4 +-
 bridges/ZeitBridge.php                  | 10 ++--
 46 files changed, 314 insertions(+), 281 deletions(-)
 create mode 100644 bridges/FeedExpanderTestBridge.php

diff --git a/bridges/AcrimedBridge.php b/bridges/AcrimedBridge.php
index d37f3ce4..93890f35 100644
--- a/bridges/AcrimedBridge.php
+++ b/bridges/AcrimedBridge.php
@@ -20,17 +20,16 @@ class AcrimedBridge extends FeedExpander
 
     public function collectData()
     {
-        $this->collectExpandableDatas(
-            static::URI . 'spip.php?page=backend',
-            $this->getInput('limit')
-        );
+        $url = 'https://www.acrimed.org/spip.php?page=backend';
+        $limit = $this->getInput('limit');
+        $this->collectExpandableDatas($url, $limit);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
+        $item = parent::parseItem($item);
 
-        $articlePage = getSimpleHTMLDOM($newsItem->link);
+        $articlePage = getSimpleHTMLDOM($item['uri']);
         $article = sanitize($articlePage->find('article.article1', 0)->innertext);
         $article = defaultLinkTo($article, static::URI);
         $item['content'] = $article;
diff --git a/bridges/ArsTechnicaBridge.php b/bridges/ArsTechnicaBridge.php
index 1e3e6379..98e5566b 100644
--- a/bridges/ArsTechnicaBridge.php
+++ b/bridges/ArsTechnicaBridge.php
@@ -33,9 +33,9 @@ class ArsTechnicaBridge extends FeedExpander
         $this->collectExpandableDatas($url);
     }
 
-    protected function parseItem($newItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newItem);
+        $item = parent::parseItem($item);
 
         $item_html = getSimpleHTMLDOMCached($item['uri'] . '&amp');
         $item_html = defaultLinkTo($item_html, self::URI);
diff --git a/bridges/BleepingComputerBridge.php b/bridges/BleepingComputerBridge.php
index c1d3d568..bad78561 100644
--- a/bridges/BleepingComputerBridge.php
+++ b/bridges/BleepingComputerBridge.php
@@ -7,6 +7,12 @@ class BleepingComputerBridge extends FeedExpander
     const URI = 'https://www.bleepingcomputer.com/';
     const DESCRIPTION = 'Returns the newest articles.';
 
+    public function collectData()
+    {
+        $feed = static::URI . 'feed/';
+        $this->collectExpandableDatas($feed);
+    }
+
     protected function parseItem($item)
     {
         $item = parent::parseItem($item);
@@ -23,10 +29,4 @@ class BleepingComputerBridge extends FeedExpander
 
         return $item;
     }
-
-    public function collectData()
-    {
-        $feed = static::URI . 'feed/';
-        $this->collectExpandableDatas($feed);
-    }
 }
diff --git a/bridges/CNETFranceBridge.php b/bridges/CNETFranceBridge.php
index da808596..d6a766de 100644
--- a/bridges/CNETFranceBridge.php
+++ b/bridges/CNETFranceBridge.php
@@ -43,9 +43,9 @@ class CNETFranceBridge extends FeedExpander
         $this->collectExpandableDatas('https://www.cnetfrance.fr/feeds/rss/news/');
     }
 
-    protected function parseItem($feedItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($feedItem);
+        $item = parent::parseItem($item);
 
         foreach ($this->bannedTitle as $term) {
             if (preg_match('/' . $term . '/mi', $item['title']) === 1) {
@@ -54,8 +54,7 @@ class CNETFranceBridge extends FeedExpander
         }
 
         foreach ($this->bannedURL as $term) {
-            $preg_match = preg_match('#' . $term . '#mi', $item['uri']);
-            if ($preg_match === 1) {
+            if (preg_match('#' . $term . '#mi', $item['uri'])) {
                 return null;
             }
         }
diff --git a/bridges/CaschyBridge.php b/bridges/CaschyBridge.php
index 5f463852..7d632bf6 100644
--- a/bridges/CaschyBridge.php
+++ b/bridges/CaschyBridge.php
@@ -34,9 +34,9 @@ class CaschyBridge extends FeedExpander
         );
     }
 
-    protected function parseItem($feedItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($feedItem);
+        $item = parent::parseItem($item);
 
         if (strpos($item['uri'], 'https://stadt-bremerhaven.de/') !== 0) {
             return $item;
diff --git a/bridges/CommonDreamsBridge.php b/bridges/CommonDreamsBridge.php
index 99580499..e1a185de 100644
--- a/bridges/CommonDreamsBridge.php
+++ b/bridges/CommonDreamsBridge.php
@@ -12,9 +12,9 @@ class CommonDreamsBridge extends FeedExpander
         $this->collectExpandableDatas('http://www.commondreams.org/rss.xml', 10);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
+        $item = parent::parseItem($item);
         $item['content'] = $this->extractContent($item['uri']);
         return $item;
     }
diff --git a/bridges/CourrierInternationalBridge.php b/bridges/CourrierInternationalBridge.php
index fdbe2ea6..9e30fd51 100644
--- a/bridges/CourrierInternationalBridge.php
+++ b/bridges/CourrierInternationalBridge.php
@@ -13,11 +13,11 @@ class CourrierInternationalBridge extends FeedExpander
         $this->collectExpandableDatas(static::URI . 'feed/all/rss.xml', 20);
     }
 
-    protected function parseItem($feedItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($feedItem);
+        $item = parent::parseItem($item);
 
-        $articlePage = getSimpleHTMLDOMCached($feedItem->link);
+        $articlePage = getSimpleHTMLDOMCached($item['uri']);
         $content = $articlePage->find('.article-text, depeche-text', 0);
         if (!$content) {
             return $item;
diff --git a/bridges/DarkReadingBridge.php b/bridges/DarkReadingBridge.php
index 58087506..aca30490 100644
--- a/bridges/DarkReadingBridge.php
+++ b/bridges/DarkReadingBridge.php
@@ -56,9 +56,10 @@ class DarkReadingBridge extends FeedExpander
         $this->collectExpandableDatas($feed_url, $limit);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
+        $item = parent::parseItem($item);
+
         $article = getSimpleHTMLDOMCached($item['uri']);
         $item['content'] = $this->extractArticleContent($article);
         $item['enclosures'] = []; //remove author profile picture
diff --git a/bridges/DauphineLibereBridge.php b/bridges/DauphineLibereBridge.php
index 82323036..0ab808cd 100644
--- a/bridges/DauphineLibereBridge.php
+++ b/bridges/DauphineLibereBridge.php
@@ -43,9 +43,9 @@ class DauphineLibereBridge extends FeedExpander
         $this->collectExpandableDatas($url, 10);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
+        $item = parent::parseItem($item);
         $item['content'] = $this->extractContent($item['uri']);
         return $item;
     }
diff --git a/bridges/DeveloppezDotComBridge.php b/bridges/DeveloppezDotComBridge.php
index d0d54d0a..9dcbc31a 100644
--- a/bridges/DeveloppezDotComBridge.php
+++ b/bridges/DeveloppezDotComBridge.php
@@ -163,19 +163,6 @@ class DeveloppezDotComBridge extends FeedExpander
         ]
     ];
 
-    /**
-     * Return the RSS url for selected domain
-     */
-    private function getRssUrl()
-    {
-        $domain = $this->getInput('domain');
-        if (!empty($domain)) {
-            return 'https://' . $domain . self::DOMAIN . self::RSS_URL;
-        }
-
-        return self::URI . self::RSS_URL;
-    }
-
     /**
      * Grabs the RSS item from Developpez.com
      */
@@ -189,15 +176,14 @@ class DeveloppezDotComBridge extends FeedExpander
      * Parse the content of every RSS item. And will try to get the full article
      * pointed by the item URL intead of the default abstract.
      */
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
+        $item = parent::parseItem($item);
+
         if (count($this->items) >= $this->getInput('limit')) {
             return null;
         }
 
-        // This function parse each entry in the RSS with the default parse
-        $item = parent::parseItem($newsItem);
-
         // There is a bug in Developpez RSS, coma are writtent as '~?' in the
         // title, so I have to fix it manually
         $item['title'] = $this->fixComaInTitle($item['title']);
@@ -229,6 +215,19 @@ class DeveloppezDotComBridge extends FeedExpander
         return $item;
     }
 
+    /**
+     * Return the RSS url for selected domain
+     */
+    private function getRssUrl()
+    {
+        $domain = $this->getInput('domain');
+        if (!empty($domain)) {
+            return 'https://' . $domain . self::DOMAIN . self::RSS_URL;
+        }
+
+        return self::URI . self::RSS_URL;
+    }
+
     /**
      * Replace '~?' by a proper coma ','
      */
@@ -334,6 +333,9 @@ class DeveloppezDotComBridge extends FeedExpander
      */
     private function isHtmlTagNotTxt($txt)
     {
+        if ($txt === '') {
+            return false;
+        }
         $html = str_get_html($txt);
         return $html && $html->root && count($html->root->children) > 0;
     }
diff --git a/bridges/EconomistBridge.php b/bridges/EconomistBridge.php
index 9a73a852..0572ab8f 100644
--- a/bridges/EconomistBridge.php
+++ b/bridges/EconomistBridge.php
@@ -93,21 +93,22 @@ class EconomistBridge extends FeedExpander
             $limit = 30;
         }
 
-        $this->collectExpandableDatas('https://www.economist.com/' . $category . '/rss.xml', $limit);
+        $url = 'https://www.economist.com/' . $category . '/rss.xml';
+        $this->collectExpandableDatas($url, $limit);
     }
 
-    protected function parseItem($feedItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($feedItem);
-        $html = getSimpleHTMLDOM($item['uri']);
+        $item = parent::parseItem($item);
+        $dom = getSimpleHTMLDOM($item['uri']);
 
-        $article = $html->find('#new-article-template', 0);
+        $article = $dom->find('#new-article-template', 0);
         if ($article == null) {
-            $article = $html->find('main', 0);
+            $article = $dom->find('main', 0);
         }
         if ($article) {
             $elem = $article->find('div', 0);
-            list($content, $audio_url) = $this->processContent($html, $elem);
+            list($content, $audio_url) = $this->processContent($dom, $elem);
             $item['content'] = $content;
             if ($audio_url != null) {
                 $item['enclosures'] = [$audio_url];
diff --git a/bridges/EngadgetBridge.php b/bridges/EngadgetBridge.php
index c219c0ff..3253cc2e 100644
--- a/bridges/EngadgetBridge.php
+++ b/bridges/EngadgetBridge.php
@@ -10,26 +10,28 @@ class EngadgetBridge extends FeedExpander
 
     public function collectData()
     {
+        $url = 'https://www.engadget.com/rss.xml';
         $max = 10;
-        $this->collectExpandableDatas(static::URI . 'rss.xml', $max);
+        $this->collectExpandableDatas($url, $max);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
-        $url = (string) $newsItem->link;
-        if (!$url) {
+        $item = parent::parseItem($item);
+
+        $itemUrl = trim($item['uri']);
+        if (!$itemUrl) {
             return $item;
         }
         // todo: remove querystring tracking
-        $articlePage = getSimpleHTMLDOM($url);
+        $dom = getSimpleHTMLDOM($itemUrl);
         // figure contain's the main article image
-        $article = $articlePage->find('figure', 0);
+        $article = $dom->find('figure', 0);
         // .article-text has the actual article
-        foreach ($articlePage->find('.article-text') as $element) {
+        foreach ($dom->find('.article-text') as $element) {
             $article = $article . $element;
         }
-        $item['content'] = $article;
+        $item['content'] = $article ?? '';
         return $item;
     }
 }
diff --git a/bridges/EsquerdaNetBridge.php b/bridges/EsquerdaNetBridge.php
index ffb4fd4e..64a6949f 100644
--- a/bridges/EsquerdaNetBridge.php
+++ b/bridges/EsquerdaNetBridge.php
@@ -1,5 +1,8 @@
 <?php
 
+/**
+ * Appears to be protected by cloudflare now
+ */
 class EsquerdaNetBridge extends FeedExpander
 {
     const MAINTAINER = 'somini';
@@ -23,32 +26,16 @@ class EsquerdaNetBridge extends FeedExpander
         ]
     ];
 
-    public function getURI()
-    {
-        $type = $this->getInput('feed');
-        return self::URI . '/rss/' . $type;
-    }
-
-    public function getIcon()
-    {
-        return 'https://www.esquerda.net/sites/default/files/favicon_0.ico';
-    }
-
     public function collectData()
     {
         parent::collectExpandableDatas($this->getURI());
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        # Fix Publish date
-        $badDate = $newsItem->pubDate;
-        preg_match('|(?P<day>\d\d)/(?P<month>\d\d)/(?P<year>\d\d\d\d) - (?P<hour>\d\d):(?P<minute>\d\d)|', $badDate, $d);
-        $newsItem->pubDate = sprintf('%s-%s-%sT%s:%s', $d['year'], $d['month'], $d['day'], $d['hour'], $d['minute']);
-        $item = parent::parseItem($newsItem);
-        # Include all the content
-        $uri = $item['uri'];
-        $html = getSimpleHTMLDOMCached($uri);
+        $item = parent::parseItem($item);
+
+        $html = getSimpleHTMLDOMCached($item['uri']);
         $content = $html->find('div#content div.content', 0);
         ## Fix author
         $authorHTML = $html->find('.field-name-field-op-author a', 0);
@@ -72,4 +59,15 @@ class EsquerdaNetBridge extends FeedExpander
         $item['content'] = $content;
         return $item;
     }
+
+    public function getURI()
+    {
+        $type = $this->getInput('feed');
+        return self::URI . '/rss/' . $type;
+    }
+
+    public function getIcon()
+    {
+        return 'https://www.esquerda.net/sites/default/files/favicon_0.ico';
+    }
 }
diff --git a/bridges/FeedExpanderExampleBridge.php b/bridges/FeedExpanderExampleBridge.php
index 0e9ae386..f0af64f4 100644
--- a/bridges/FeedExpanderExampleBridge.php
+++ b/bridges/FeedExpanderExampleBridge.php
@@ -43,9 +43,4 @@ class FeedExpanderExampleBridge extends FeedExpander
                 returnClientError('Unknown version ' . $this->getInput('version') . '!');
         }
     }
-
-    protected function parseItem($newsItem)
-    {
-        return (array) $newsItem;
-    }
 }
diff --git a/bridges/FeedExpanderTestBridge.php b/bridges/FeedExpanderTestBridge.php
new file mode 100644
index 00000000..9a6e7bb7
--- /dev/null
+++ b/bridges/FeedExpanderTestBridge.php
@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+class FeedExpanderTestBridge extends FeedExpander
+{
+    const MAINTAINER = 'No maintainer';
+    const NAME = 'Unnamed bridge';
+    const URI = 'https://esdf.com/';
+    const DESCRIPTION = 'No description provided';
+    const PARAMETERS = [];
+    const CACHE_TIMEOUT = 3600;
+
+    public function collectData()
+    {
+        $url = 'http://static.userland.com/gems/backend/sampleRss.xml'; // rss 0.91
+        //$url = 'http://feeds.nature.com/nature/rss/current?format=xml'; // rss 1.0
+        //$url = 'https://dvikan.no/feed.xml'; // rss 2.0
+        //$url = 'https://nedlasting.geonorge.no/geonorge/Tjenestefeed.xml'; // atom
+
+        $this->collectExpandableDatas($url);
+    }
+}
diff --git a/bridges/FilterBridge.php b/bridges/FilterBridge.php
index 1d920f90..3e3e812d 100644
--- a/bridges/FilterBridge.php
+++ b/bridges/FilterBridge.php
@@ -82,9 +82,9 @@ class FilterBridge extends FeedExpander
         $this->collectExpandableDatas($this->getURI());
     }
 
-    protected function parseItem($newItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newItem);
+        $item = parent::parseItem($item);
 
         // Generate title from first 50 characters of content?
         if ($this->getInput('title_from_content') && array_key_exists('content', $item)) {
diff --git a/bridges/ForGifsBridge.php b/bridges/ForGifsBridge.php
index 03848d04..e210124a 100644
--- a/bridges/ForGifsBridge.php
+++ b/bridges/ForGifsBridge.php
@@ -12,12 +12,12 @@ class ForGifsBridge extends FeedExpander
         $this->collectExpandableDatas('https://forgifs.com/gallery/srss/7');
     }
 
-    protected function parseItem($feedItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($feedItem);
+        $item = parent::parseItem($item);
 
-        $content = str_get_html($item['content']);
-        $img = $content->find('img', 0);
+        $dom = str_get_html($item['content']);
+        $img = $dom->find('img', 0);
         $poster = $img->src;
 
         // The actual gif is the same path but its id must be decremented by one.
@@ -34,7 +34,7 @@ class ForGifsBridge extends FeedExpander
         $img->width = 'auto';
         $img->height = 'auto';
 
-        $item['content'] = $content;
+        $item['content'] = (string) $dom;
 
         return $item;
     }
diff --git a/bridges/FreeCodeCampBridge.php b/bridges/FreeCodeCampBridge.php
index 89d8c53a..141746d2 100644
--- a/bridges/FreeCodeCampBridge.php
+++ b/bridges/FreeCodeCampBridge.php
@@ -14,15 +14,17 @@ class FreeCodeCampBridge extends FeedExpander
         $this->collectExpandableDatas('https://www.freecodecamp.org/news/rss/', 15);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
-        // $articlePage gets the entire page's contents
-        $articlePage = getSimpleHTMLDOM($newsItem->link);
+        $item = parent::parseItem($item);
+
+        $dom = getSimpleHTMLDOM($item['uri']);
+
         // figure contain's the main article image
-        $article = $articlePage->find('figure', 0);
+        $article = $dom->find('figure', 0);
+
         // the actual article
-        foreach ($articlePage->find('.post-full-content') as $element) {
+        foreach ($dom->find('.post-full-content') as $element) {
             $article = $article . $element;
         }
         $item['content'] = $article;
diff --git a/bridges/FuturaSciencesBridge.php b/bridges/FuturaSciencesBridge.php
index 3fb8aafa..cfb2d711 100644
--- a/bridges/FuturaSciencesBridge.php
+++ b/bridges/FuturaSciencesBridge.php
@@ -85,13 +85,14 @@ class FuturaSciencesBridge extends FeedExpander
         $this->collectExpandableDatas($url, 10);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
+        $item = parent::parseItem($item);
+
         $item['uri'] = str_replace('#xtor%3DRSS-8', '', $item['uri']);
-        $article = getSimpleHTMLDOMCached($item['uri']);
-        $item['content'] = $this->extractArticleContent($article);
-        $author = $this->extractAuthor($article);
+        $dom = getSimpleHTMLDOMCached($item['uri']);
+        $item['content'] = $this->extractArticleContent($dom);
+        $author = $this->extractAuthor($dom);
         if (!empty($author)) {
             $item['author'] = $author;
         }
diff --git a/bridges/HardwareInfoBridge.php b/bridges/HardwareInfoBridge.php
index e295984c..6a47df66 100644
--- a/bridges/HardwareInfoBridge.php
+++ b/bridges/HardwareInfoBridge.php
@@ -9,15 +9,15 @@ class HardwareInfoBridge extends FeedExpander
 
     public function collectData()
     {
-        $this->collectExpandableDatas('https://nl.hardware.info/updates/all.rss', 20);
+        $this->collectExpandableDatas('https://nl.hardware.info/updates/all.rss', 10);
     }
 
-    protected function parseItem($feedItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($feedItem);
+        $item = parent::parseItem($item);
 
-        //get full article
-        $articlePage = getSimpleHTMLDOMCached($feedItem->link);
+        $itemUrl = $item['uri'];
+        $articlePage = getSimpleHTMLDOMCached($itemUrl);
 
         $article = $articlePage->find('div.article__content', 0);
 
diff --git a/bridges/HeiseBridge.php b/bridges/HeiseBridge.php
index dfda311c..434e7514 100644
--- a/bridges/HeiseBridge.php
+++ b/bridges/HeiseBridge.php
@@ -125,9 +125,10 @@ class HeiseBridge extends FeedExpander
         );
     }
 
-    protected function parseItem($feedItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($feedItem);
+        $item = parent::parseItem($item);
+
         $sessioncookie = $this->getInput('sessioncookie');
 
         // strip rss parameter
diff --git a/bridges/IGNBridge.php b/bridges/IGNBridge.php
index d00b6a18..c0260cbd 100644
--- a/bridges/IGNBridge.php
+++ b/bridges/IGNBridge.php
@@ -10,17 +10,16 @@ class IGNBridge extends FeedExpander
 
     public function collectData()
     {
-        $this->collectExpandableDatas('http://feeds.ign.com/ign/all', 15);
+        $this->collectExpandableDatas('http://feeds.ign.com/ign/all', 2);
     }
 
     // IGNs feed is both hidden and incomplete. This bridge tries to fix this.
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
+        $item = parent::parseItem($item);
 
-        // $articlePage gets the entire page's contents
-        $articlePage = getSimpleHTMLDOM($newsItem->link);
+        $articlePage = getSimpleHTMLDOM($item['uri']);
 
         // List of BS elements
         $uselessElements = [
@@ -33,7 +32,7 @@ class IGNBridge extends FeedExpander
             '.jsx-4213937408',
             '.commerce-container',
             '.widget-container',
-            '.newsletter-signup-button'
+            '.newsletter-signup-button',
         ];
 
         // Remove useless elements
diff --git a/bridges/LeMondeInformatiqueBridge.php b/bridges/LeMondeInformatiqueBridge.php
index 678e405f..c91a0437 100644
--- a/bridges/LeMondeInformatiqueBridge.php
+++ b/bridges/LeMondeInformatiqueBridge.php
@@ -12,9 +12,10 @@ class LeMondeInformatiqueBridge extends FeedExpander
         $this->collectExpandableDatas(self::URI . 'rss/rss.xml', 10);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
+        $item = parent::parseItem($item);
+
         $article_html = getSimpleHTMLDOMCached($item['uri']);
 
         //Deduce thumbnail URL from article image URL
diff --git a/bridges/ListverseBridge.php b/bridges/ListverseBridge.php
index ba6d7397..b7acbdd0 100644
--- a/bridges/ListverseBridge.php
+++ b/bridges/ListverseBridge.php
@@ -13,12 +13,11 @@ class ListverseBridge extends FeedExpander
         $this->collectExpandableDatas('https://listverse.com/feed/', 15);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
-        // $articlePage gets the entire page's contents
-        $articlePage = getSimpleHTMLDOM($newsItem->link);
-        $article = $articlePage->find('#articlecontentonly', 0);
+        $item = parent::parseItem($item);
+        $dom = getSimpleHTMLDOM($item['uri']);
+        $article = $dom->find('#articlecontentonly', 0);
         $item['content'] = $article;
         return $item;
     }
diff --git a/bridges/MediapartBridge.php b/bridges/MediapartBridge.php
index 3c8c8317..c4deda61 100644
--- a/bridges/MediapartBridge.php
+++ b/bridges/MediapartBridge.php
@@ -29,9 +29,11 @@ class MediapartBridge extends FeedExpander
         $this->collectExpandableDatas($url);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
+        $item = parent::parseItem($item);
+
+        $itemUrl = $item['uri'];
 
         // Mediapart provide multiple type of contents.
         // We only process items relative to the newspaper
@@ -49,12 +51,8 @@ class MediapartBridge extends FeedExpander
                 $opt = [];
                 $opt[CURLOPT_COOKIE] = 'MPSESSID=' . $mpsessid;
 
-                // Get the page
-                $articlePage = getSimpleHTMLDOM(
-                    $newsItem->link . '?onglet=full',
-                    [],
-                    $opt
-                );
+                $pageUrl = $itemUrl . '?onglet=full';
+                $articlePage = getSimpleHTMLDOM($pageUrl, [], $opt);
 
                 // Extract the article content
                 $content = $articlePage->find('div.content-article', 0)->innertext;
diff --git a/bridges/MsnMondeBridge.php b/bridges/MsnMondeBridge.php
index 844aa4a2..9b308b99 100644
--- a/bridges/MsnMondeBridge.php
+++ b/bridges/MsnMondeBridge.php
@@ -22,17 +22,19 @@ class MsnMondeBridge extends FeedExpander
 
     public function collectData()
     {
-        $this->collectExpandableDatas(self::FEED_URL, self::LIMIT);
+        $this->collectExpandableDatas(self::FEED_URL, 10);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
+        $item = parent::parseItem($item);
+
         if (!preg_match('#fr-fr/actualite.*/ar-(?<id>[\w]*)\?#', $item['uri'], $matches)) {
-            return;
+            return null;
         }
 
-        $json = json_decode(getContents(self::JSON_URL . $matches['id']), true);
+        $jsonString = getContents(self::JSON_URL . $matches['id']);
+        $json = json_decode($jsonString, true);
         $item['content'] = $json['body'];
         if (!empty($json['authors'])) {
             $item['author'] = reset($json['authors'])['name'];
diff --git a/bridges/NYTBridge.php b/bridges/NYTBridge.php
index 46ede3f8..57c3e2af 100644
--- a/bridges/NYTBridge.php
+++ b/bridges/NYTBridge.php
@@ -10,17 +10,18 @@ class NYTBridge extends FeedExpander
 
     public function collectData()
     {
-        $this->collectExpandableDatas('https://rss.nytimes.com/services/xml/rss/nyt/HomePage.xml', 40);
+        $url = 'https://rss.nytimes.com/services/xml/rss/nyt/HomePage.xml';
+        $this->collectExpandableDatas($url, 40);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
+        $item = parent::parseItem($item);
+
         $article = '';
 
-        // $articlePage gets the entire page's contents
         try {
-            $articlePage = getSimpleHTMLDOM($newsItem->link);
+            $articlePage = getSimpleHTMLDOM($item['uri']);
         } catch (HttpException $e) {
             // 403 Forbidden, This means we got anti-bot response
             if ($e->getCode() === 403) {
diff --git a/bridges/NextInpactBridge.php b/bridges/NextInpactBridge.php
index 408fd783..0260da14 100644
--- a/bridges/NextInpactBridge.php
+++ b/bridges/NextInpactBridge.php
@@ -88,9 +88,10 @@ class NextInpactBridge extends FeedExpander
         $this->collectExpandableDatas($url, $limit);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
+        $item = parent::parseItem($item);
+
         $item['content'] = $this->extractContent($item, $item['uri']);
         if (is_null($item['content'])) {
             return null; //Filtered article
diff --git a/bridges/NextgovBridge.php b/bridges/NextgovBridge.php
index ad17f88e..1e096d6c 100644
--- a/bridges/NextgovBridge.php
+++ b/bridges/NextgovBridge.php
@@ -26,7 +26,8 @@ class NextgovBridge extends FeedExpander
 
     public function collectData()
     {
-        $this->collectExpandableDatas(self::URI . 'rss/' . $this->getInput('category') . '/', 10);
+        $url = self::URI . 'rss/' . $this->getInput('category') . '/';
+        $this->collectExpandableDatas($url, 10);
     }
 
     protected function parseItem($newsItem)
diff --git a/bridges/NiceMatinBridge.php b/bridges/NiceMatinBridge.php
index 6e622b42..bcebbbbb 100644
--- a/bridges/NiceMatinBridge.php
+++ b/bridges/NiceMatinBridge.php
@@ -12,9 +12,10 @@ class NiceMatinBridge extends FeedExpander
         $this->collectExpandableDatas(self::URI . 'derniere-minute/rss', 10);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
+        $item = parent::parseItem($item);
+
         $item['content'] = $this->extractContent($item['uri']);
         return $item;
     }
diff --git a/bridges/NyaaTorrentsBridge.php b/bridges/NyaaTorrentsBridge.php
index 217db377..3b5ad3ad 100644
--- a/bridges/NyaaTorrentsBridge.php
+++ b/bridges/NyaaTorrentsBridge.php
@@ -65,12 +65,14 @@ class NyaaTorrentsBridge extends FeedExpander
         $this->collectExpandableDatas($this->getURI(), 20);
     }
 
-    protected function parseItem($newItem)
+    protected function parseItem($newsItem)
     {
-        $item = parent::parseItem($newItem);
+        $item = parent::parseItem($newsItem);
+
+        $nyaaFields = (array)($newsItem->children('nyaa', true));
+
         $item['id'] = str_replace(['https://nyaa.si/download/', '.torrent'], '', $item['uri']);
 
-        $nyaaFields = (array)($newItem->children('nyaa', true));
         $item = array_merge($item, $nyaaFields);
 
         // Convert URI from torrent file to web page
diff --git a/bridges/OnVaSortirBridge.php b/bridges/OnVaSortirBridge.php
index af80dd31..9f9a750c 100644
--- a/bridges/OnVaSortirBridge.php
+++ b/bridges/OnVaSortirBridge.php
@@ -117,18 +117,18 @@ class OnVaSortirBridge extends FeedExpander
             ]
     ];
 
+    public function collectData()
+    {
+        $url = 'https://' . $this->getInput('city') . '.onvasortir.com/rss.php';
+        $this->collectExpandableDatas($url);
+    }
+
     protected function parseItem($item)
     {
         $item = parent::parseItem($item);
-        $html = getSimpleHTMLDOMCached($item['uri']);
-        $text = $html->find('div.corpsMax', 0)->innertext;
+        $dom = getSimpleHTMLDOMCached($item['uri']);
+        $text = $dom->find('div.corpsMax', 0)->innertext;
         $item['content'] = utf8_encode($text);
         return $item;
     }
-
-    public function collectData()
-    {
-        $this->collectExpandableDatas('https://' .
-            $this->getInput('city') . '.onvasortir.com/rss.php');
-    }
 }
diff --git a/bridges/PhoronixBridge.php b/bridges/PhoronixBridge.php
index 620fda66..fc0d78e5 100644
--- a/bridges/PhoronixBridge.php
+++ b/bridges/PhoronixBridge.php
@@ -29,22 +29,25 @@ but some RSS readers don\'t support this. "img" tag are supported by most browse
         $this->collectExpandableDatas('https://www.phoronix.com/rss.php', $this->getInput('n'));
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
-        // $articlePage gets the entire page's contents
-        $articlePage = getSimpleHTMLDOM($newsItem->link);
+        $item = parent::parseItem($item);
+
+        $itemUrl = $item['uri'];
+
+        $articlePage = getSimpleHTMLDOM($itemUrl);
         $articlePage = defaultLinkTo($articlePage, $this->getURI());
         // Extract final link. From Facebook's like plugin.
-        parse_str(parse_url($articlePage->find('iframe[src^=//www.facebook.com/plugins]', 0), PHP_URL_QUERY), $facebookQuery);
+        $parsedUrlQuery = parse_url($articlePage->find('iframe[src^=//www.facebook.com/plugins]', 0), PHP_URL_QUERY);
+        parse_str($parsedUrlQuery, $facebookQuery);
         if (array_key_exists('href', $facebookQuery)) {
-            $newsItem->link = $facebookQuery['href'];
+            $itemUrl = $facebookQuery['href'];
         }
         $item['content'] = $this->extractContent($articlePage);
 
         $pages = $articlePage->find('.pagination a[!title]');
         foreach ($pages as $page) {
-            $pageURI = urljoin($newsItem->link, html_entity_decode($page->href));
+            $pageURI = urljoin($itemUrl, html_entity_decode($page->href));
             $page = getSimpleHTMLDOM($pageURI);
             $item['content'] .= $this->extractContent($page);
         }
diff --git a/bridges/QwantzBridge.php b/bridges/QwantzBridge.php
index e48e948a..2117c33c 100644
--- a/bridges/QwantzBridge.php
+++ b/bridges/QwantzBridge.php
@@ -6,9 +6,15 @@ class QwantzBridge extends FeedExpander
     const URI            = 'https://qwantz.com/';
     const DESCRIPTION    = 'Latest comic.';
 
-    protected function parseItem($feedItem)
+    public function collectData()
     {
-        $item = parent::parseItem($feedItem);
+        $this->collectExpandableDatas(self::URI . 'rssfeed.php');
+    }
+
+    protected function parseItem($item)
+    {
+        $item = parent::parseItem($item);
+
         $item['author'] = 'Ryan North';
 
         preg_match('/title="(.*?)"/', $item['content'], $matches);
@@ -25,11 +31,6 @@ class QwantzBridge extends FeedExpander
         return $item;
     }
 
-    public function collectData()
-    {
-        $this->collectExpandableDatas(self::URI . 'rssfeed.php');
-    }
-
     public function getIcon()
     {
         return self::URI . 'favicon.ico';
diff --git a/bridges/RaceDepartmentBridge.php b/bridges/RaceDepartmentBridge.php
index 7fe92b4a..3783b53e 100644
--- a/bridges/RaceDepartmentBridge.php
+++ b/bridges/RaceDepartmentBridge.php
@@ -12,12 +12,11 @@ class RaceDepartmentBridge extends FeedExpander
         $this->collectExpandableDatas('https://www.racedepartment.com/ams/index.rss', 10);
     }
 
-    protected function parseItem($feedItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($feedItem);
+        $item = parent::parseItem($item);
 
-        //fetch page
-        $articlePage = getSimpleHTMLDOMCached($feedItem->link);
+        $articlePage = getSimpleHTMLDOMCached($item['uri']);
 
         $coverImage = $articlePage->find('img.js-articleCoverImage', 0);
         #relative url -> absolute url
diff --git a/bridges/ScribbleHubBridge.php b/bridges/ScribbleHubBridge.php
index 4fe43df3..8f52d461 100644
--- a/bridges/ScribbleHubBridge.php
+++ b/bridges/ScribbleHubBridge.php
@@ -42,9 +42,9 @@ class ScribbleHubBridge extends FeedExpander
         $this->collectExpandableDatas($url);
     }
 
-    protected function parseItem($newItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newItem);
+        $item = parent::parseItem($item);
 
         //For series, filter out other series from 'All' feed
         if (
@@ -57,7 +57,7 @@ class ScribbleHubBridge extends FeedExpander
         $item['comments'] = $item['uri'] . '#comments';
 
         try {
-            $item_html = getSimpleHTMLDOMCached($item['uri']);
+            $dom = getSimpleHTMLDOMCached($item['uri']);
         } catch (HttpException $e) {
             // 403 Forbidden, This means we got anti-bot response
             if ($e->getCode() === 403) {
@@ -66,22 +66,22 @@ class ScribbleHubBridge extends FeedExpander
             throw $e;
         }
 
-        $item_html = defaultLinkTo($item_html, self::URI);
+        $dom = defaultLinkTo($dom, self::URI);
 
         //Retrieve full description from page contents
-        $item['content'] = $item_html->find('#chp_raw', 0);
+        $item['content'] = $dom->find('#chp_raw', 0);
 
         //Retrieve image for thumbnail
-        $item_image = $item_html->find('.s_novel_img > img', 0)->src;
+        $item_image = $dom->find('.s_novel_img > img', 0)->src;
         $item['enclosures'] = [$item_image];
 
         //Restore lost categories
-        $item_story = html_entity_decode($item_html->find('.chp_byauthor > a', 0)->innertext);
-        $item_sid   = $item_html->find('#mysid', 0)->value;
+        $item_story = html_entity_decode($dom->find('.chp_byauthor > a', 0)->innertext);
+        $item_sid   = $dom->find('#mysid', 0)->value;
         $item['categories'] = [$item_story, $item_sid];
 
         //Generate UID
-        $item_pid = $item_html->find('#mypostid', 0)->value;
+        $item_pid = $dom->find('#mypostid', 0)->value;
         $item['uid'] = $item_sid . "/$item_pid";
 
         return $item;
diff --git a/bridges/SplCenterBridge.php b/bridges/SplCenterBridge.php
index a590558d..ca764846 100644
--- a/bridges/SplCenterBridge.php
+++ b/bridges/SplCenterBridge.php
@@ -21,6 +21,12 @@ class SplCenterBridge extends FeedExpander
 
     const CACHE_TIMEOUT = 3600; // 1 hour
 
+    public function collectData()
+    {
+        $url = $this->getURI() . '/rss.xml';
+        $this->collectExpandableDatas($url);
+    }
+
     protected function parseItem($item)
     {
         $item = parent::parseItem($item);
@@ -37,11 +43,6 @@ class SplCenterBridge extends FeedExpander
         return $item;
     }
 
-    public function collectData()
-    {
-        $this->collectExpandableDatas($this->getURI() . '/rss.xml');
-    }
-
     public function getURI()
     {
         if (!is_null($this->getInput('content'))) {
diff --git a/bridges/TapasBridge.php b/bridges/TapasBridge.php
index e512ad48..11a9551d 100644
--- a/bridges/TapasBridge.php
+++ b/bridges/TapasBridge.php
@@ -30,14 +30,17 @@ class TapasBridge extends FeedExpander
 
     protected $id;
 
-    public function getURI()
+    public function collectData()
     {
-        if ($this->id) {
-            return self::URI . 'rss/series/' . $this->id;
-        } else {
-            return self::URI . 'series/' . $this->getInput('title') . '/info/';
+        if (preg_match('/^[\d]+$/', $this->getInput('title'))) {
+            $this->id = $this->getInput('title');
         }
-        return self::URI;
+        if ($this->getInput('force_title') or !$this->id) {
+            $html = getSimpleHTMLDOM($this->getURI()) or returnServerError('Could not request ' . $this->getURI());
+            $this->id = $html->find('meta[property$=":url"]', 0)->content;
+            $this->id = str_ireplace(['tapastic://series/', '/info'], '', $this->id);
+        }
+        $this->collectExpandableDatas($this->getURI());
     }
 
     protected function parseItem($feedItem)
@@ -72,16 +75,13 @@ class TapasBridge extends FeedExpander
         return $item;
     }
 
-    public function collectData()
+    public function getURI()
     {
-        if (preg_match('/^[\d]+$/', $this->getInput('title'))) {
-            $this->id = $this->getInput('title');
+        if ($this->id) {
+            return self::URI . 'rss/series/' . $this->id;
+        } else {
+            return self::URI . 'series/' . $this->getInput('title') . '/info/';
         }
-        if ($this->getInput('force_title') or !$this->id) {
-            $html = getSimpleHTMLDOM($this->getURI()) or returnServerError('Could not request ' . $this->getURI());
-            $this->id = $html->find('meta[property$=":url"]', 0)->content;
-            $this->id = str_ireplace(['tapastic://series/', '/info'], '', $this->id);
-        }
-        $this->collectExpandableDatas($this->getURI());
+        return self::URI;
     }
 }
diff --git a/bridges/TheGuardianBridge.php b/bridges/TheGuardianBridge.php
index e05bde75..98e56506 100644
--- a/bridges/TheGuardianBridge.php
+++ b/bridges/TheGuardianBridge.php
@@ -52,18 +52,15 @@ class TheGuardianBridge extends FeedExpander
     public function collectData()
     {
         $feed = $this->getInput('feed');
-        $feedURL = 'https://feeds.theguardian.com/theguardian/' . $feed;
-        $this->collectExpandableDatas($feedURL, 10);
+        $url = 'https://feeds.theguardian.com/theguardian/' . $feed;
+        $this->collectExpandableDatas($url, 10);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
+        $item = parent::parseItem($item);
 
-        // --- Recovering the article ---
-
-        // $articlePage gets the entire page's contents
-        $articlePage = getSimpleHTMLDOM($newsItem->link);
+        $articlePage = getSimpleHTMLDOM($item['uri']);
         // figure contain's the main article image
         $article = $articlePage->find('figure', 0);
         // content__article-body has the actual article
diff --git a/bridges/TwitterEngineeringBridge.php b/bridges/TwitterEngineeringBridge.php
index fa55b4a4..b98cfb87 100644
--- a/bridges/TwitterEngineeringBridge.php
+++ b/bridges/TwitterEngineeringBridge.php
@@ -8,18 +8,24 @@ class TwitterEngineeringBridge extends FeedExpander
     const DESCRIPTION = 'Returns the newest articles.';
     const CACHE_TIMEOUT = 21600; // 6h
 
+    public function collectData()
+    {
+        $url = 'https://blog.twitter.com/engineering/en_us/blog.rss';
+        $this->collectExpandableDatas($url);
+    }
+
     protected function parseItem($item)
     {
         $item = parent::parseItem($item);
 
-        $article_html = getSimpleHTMLDOMCached($item['uri']);
-        if (!$article_html) {
+        $dom = getSimpleHTMLDOMCached($item['uri']);
+        if (!$dom) {
             $item['content'] .= '<p><em>Could not request ' . $this->getName() . ': ' . $item['uri'] . '</em></p>';
             return $item;
         }
-        $article_html = defaultLinkTo($article_html, $this->getURI());
+        $dom = defaultLinkTo($dom, $this->getURI());
 
-        $article_body = $article_html->find('div.column.column-6', 0);
+        $article_body = $dom->find('div.column.column-6', 0);
 
         // Remove elements that are not part of article content
         $unwanted_selector = 'div.bl02-blog-post-text-masthead, div.tweet-error-text, div.bl13-tweet-template';
@@ -33,8 +39,8 @@ class TwitterEngineeringBridge extends FeedExpander
         }
 
         $item['content'] = $article_body;
-        $item['timestamp'] = strtotime($article_html->find('span.b02-blog-post-no-masthead__date', 0)->innertext);
-        $item['categories'] = self::getCategoriesFromTags($article_html);
+        $item['timestamp'] = strtotime($dom->find('span.b02-blog-post-no-masthead__date', 0)->innertext);
+        $item['categories'] = self::getCategoriesFromTags($dom);
 
         return $item;
     }
@@ -53,12 +59,6 @@ class TwitterEngineeringBridge extends FeedExpander
         return $categories;
     }
 
-    public function collectData()
-    {
-        $feed = static::URI . 'en_us/blog.rss';
-        $this->collectExpandableDatas($feed);
-    }
-
     public function getName()
     {
         // Else the original feed returns "English (US)" as the title
diff --git a/bridges/VarietyBridge.php b/bridges/VarietyBridge.php
index 23d1df3f..6625dca2 100644
--- a/bridges/VarietyBridge.php
+++ b/bridges/VarietyBridge.php
@@ -13,11 +13,11 @@ class VarietyBridge extends FeedExpander
         $this->collectExpandableDatas('https://feeds.feedburner.com/variety/headlines', 15);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
+        $item = parent::parseItem($item);
         // $articlePage gets the entire page's contents
-        $articlePage = getSimpleHTMLDOM($newsItem->link);
+        $articlePage = getSimpleHTMLDOM($item['uri']);
 
         // Remove Script tags
         foreach ($articlePage->find('script') as $script_tag) {
diff --git a/bridges/ViceBridge.php b/bridges/ViceBridge.php
index 35414020..c7ecec33 100644
--- a/bridges/ViceBridge.php
+++ b/bridges/ViceBridge.php
@@ -32,14 +32,14 @@ class ViceBridge extends FeedExpander
         $this->collectExpandableDatas($feedURL, 10);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
-        // $articlePage gets the entire page's contents
-        $articlePage = getSimpleHTMLDOM($newsItem->link);
+        $item = parent::parseItem($item);
+
+        $articlePage = getSimpleHTMLDOM($item['uri']);
         // text and embedded content
         $article = $articlePage->find('.article__body', 0);
-        $item['content'] = $article;
+        $item['content'] = $article ?? '';
 
         return $item;
     }
diff --git a/bridges/WiredBridge.php b/bridges/WiredBridge.php
index d4c7cbbb..7f7f6051 100644
--- a/bridges/WiredBridge.php
+++ b/bridges/WiredBridge.php
@@ -50,13 +50,16 @@ class WiredBridge extends FeedExpander
         $this->collectExpandableDatas($feed_url, $limit);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
+        $item = parent::parseItem($item);
+
+        $originalContent = $item['content'];
+
         $article = getSimpleHTMLDOMCached($item['uri']);
         $item['content'] = $this->extractArticleContent($article);
 
-        $headline = strval($newsItem->description);
+        $headline = $originalContent;
         if (!empty($headline)) {
             $item['content'] = '<p><b>' . $headline . '</b></p>' . $item['content'];
         }
diff --git a/bridges/WordPressBridge.php b/bridges/WordPressBridge.php
index 1d46958d..fb27eb31 100644
--- a/bridges/WordPressBridge.php
+++ b/bridges/WordPressBridge.php
@@ -20,50 +20,56 @@ class WordPressBridge extends FeedExpander
         ],
     ]];
 
-    private function cleanContent($content)
+    public function collectData()
     {
-        $content = stripWithDelimiters($content, '<script', '</script>');
-        $content = preg_replace('/<div class="wpa".*/', '', $content);
-        $content = preg_replace('/<form.*\/form>/', '', $content);
-        return $content;
+        $limit = $this->getInput('limit') ?? 10;
+        if ($this->getInput('url') && substr($this->getInput('url'), 0, strlen('http')) !== 'http') {
+            // just in case someone find a way to access local files by playing with the url
+            returnClientError('The url parameter must either refer to http or https protocol.');
+        }
+        try {
+            $this->collectExpandableDatas($this->getURI() . '/feed/atom/', $limit);
+        } catch (Exception $e) {
+            $this->collectExpandableDatas($this->getURI() . '/?feed=atom', $limit);
+        }
     }
 
-    protected function parseItem($newItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newItem);
+        $item = parent::parseItem($item);
 
-        $article_html = getSimpleHTMLDOMCached($item['uri']);
+        $dom = getSimpleHTMLDOMCached($item['uri']);
 
         // Find article body
         $article = null;
         switch (true) {
             case !empty($this->getInput('content-selector')):
                 // custom contect selector (manually specified by user)
-                $article = $article_html->find($this->getInput('content-selector'), 0);
+                $article = $dom->find($this->getInput('content-selector'), 0);
                 break;
-            case !is_null($article_html->find('[itemprop=articleBody]', 0)):
+            case !is_null($dom->find('[itemprop=articleBody]', 0)):
                 // highest priority content div (used for SEO)
-                $article = $article_html->find('[itemprop=articleBody]', 0);
+                $article = $dom->find('[itemprop=articleBody]', 0);
                 break;
-            case !is_null($article_html->find('.article-content', 0)):
+            case !is_null($dom->find('.article-content', 0)):
                 // more precise than article when present
-                $article = $article_html->find('.article-content', 0);
+                $article = $dom->find('.article-content', 0);
                 break;
-            case !is_null($article_html->find('article', 0)):
+            case !is_null($dom->find('article', 0)):
                 // most common content div
-                $article = $article_html->find('article', 0);
+                $article = $dom->find('article', 0);
                 break;
-            case !is_null($article_html->find('.single-content', 0)):
+            case !is_null($dom->find('.single-content', 0)):
                 // another common content div
-                $article = $article_html->find('.single-content', 0);
+                $article = $dom->find('.single-content', 0);
                 break;
-            case !is_null($article_html->find('.post-content', 0)):
+            case !is_null($dom->find('.post-content', 0)):
                 // another common content div
-                $article = $article_html->find('.post-content', 0);
+                $article = $dom->find('.post-content', 0);
                 break;
-            case !is_null($article_html->find('.post', 0)):
+            case !is_null($dom->find('.post', 0)):
                 // for old WordPress themes without HTML5
-                $article = $article_html->find('.post', 0);
+                $article = $dom->find('.post', 0);
                 break;
         }
 
@@ -76,7 +82,7 @@ class WordPressBridge extends FeedExpander
 
         // Find article main image
         $article = convertLazyLoading($article);
-        $article_image = $article_html->find('img.wp-post-image', 0);
+        $article_image = $dom->find('img.wp-post-image', 0);
         if (!empty($item['content']) && (!is_object($article_image) || empty($article_image->src))) {
             $article_image = str_get_html($item['content'])->find('img.wp-post-image', 0);
         }
@@ -106,6 +112,14 @@ class WordPressBridge extends FeedExpander
         return $item;
     }
 
+    private function cleanContent($content)
+    {
+        $content = stripWithDelimiters($content, '<script', '</script>');
+        $content = preg_replace('/<div class="wpa".*/', '', $content);
+        $content = preg_replace('/<form.*\/form>/', '', $content);
+        return $content;
+    }
+
     public function getURI()
     {
         $url = $this->getInput('url');
@@ -114,18 +128,4 @@ class WordPressBridge extends FeedExpander
         }
         return $url;
     }
-
-    public function collectData()
-    {
-        $limit = $this->getInput('limit') ?? 10;
-        if ($this->getInput('url') && substr($this->getInput('url'), 0, strlen('http')) !== 'http') {
-            // just in case someone find a way to access local files by playing with the url
-            returnClientError('The url parameter must either refer to http or https protocol.');
-        }
-        try {
-            $this->collectExpandableDatas($this->getURI() . '/feed/atom/', $limit);
-        } catch (Exception $e) {
-            $this->collectExpandableDatas($this->getURI() . '/?feed=atom', $limit);
-        }
-    }
 }
diff --git a/bridges/WorldOfTanksBridge.php b/bridges/WorldOfTanksBridge.php
index 6e7a594b..52691025 100644
--- a/bridges/WorldOfTanksBridge.php
+++ b/bridges/WorldOfTanksBridge.php
@@ -30,9 +30,9 @@ class WorldOfTanksBridge extends FeedExpander
         $this->collectExpandableDatas(sprintf('https://worldoftanks.eu/%s/rss/news/', $this->getInput('lang')));
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
+        $item = parent::parseItem($item);
         $item['content'] = $this->loadFullArticle($item['uri']);
         return $item;
     }
diff --git a/bridges/ZeitBridge.php b/bridges/ZeitBridge.php
index b294e9fb..7d7e89aa 100644
--- a/bridges/ZeitBridge.php
+++ b/bridges/ZeitBridge.php
@@ -50,19 +50,19 @@ class ZeitBridge extends FeedExpander
             'defaultValue' => 5
         ]
     ]];
-    const LIMIT = 5;
 
     public function collectData()
     {
-        $this->collectExpandableDatas(
-            $this->getInput('category'),
-            $this->getInput('limit') ?: static::LIMIT
-        );
+        $url = $this->getInput('category');
+        $limit = $this->getInput('limit') ?: 5;
+
+        $this->collectExpandableDatas($url, $limit);
     }
 
     protected function parseItem($item)
     {
         $item = parent::parseItem($item);
+
         $item['enclosures'] = [];
 
         $headers = [

From 44fb2c98bcc49d5d83186abc2dc05bf9b6eba60c Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 13 Oct 2023 00:26:11 +0200
Subject: [PATCH 166/716] fix: various fixes (#3745)

---
 bridges/CVEDetailsBridge.php |  2 +-
 bridges/CubariBridge.php     | 18 ++++++++++--------
 lib/FeedParser.php           |  7 +++++--
 3 files changed, 16 insertions(+), 11 deletions(-)

diff --git a/bridges/CVEDetailsBridge.php b/bridges/CVEDetailsBridge.php
index 27b4008c..b52d290e 100644
--- a/bridges/CVEDetailsBridge.php
+++ b/bridges/CVEDetailsBridge.php
@@ -57,7 +57,7 @@ class CVEDetailsBridge extends BridgeAbstract
             $content = $tr->find('.cvesummarylong', 0)->innertext;
             $cweList = $detailHtml->find('h2', 2)->next_sibling();
             foreach ($cweList->find('li') as $li) {
-                $cweWithDescription = $li->find('a', 0)->innertext;
+                $cweWithDescription = $li->find('a', 0)->innertext ?? '';
 
                 if (preg_match('/CWE-(\d+)/', $cweWithDescription, $cwe)) {
                     $categories[] = 'CWE-' . $cwe[1];
diff --git a/bridges/CubariBridge.php b/bridges/CubariBridge.php
index 9a08dbba..a7b6d69d 100644
--- a/bridges/CubariBridge.php
+++ b/bridges/CubariBridge.php
@@ -47,8 +47,8 @@ class CubariBridge extends BridgeAbstract
      */
     public function collectData()
     {
-        $jsonSite = getContents($this->getInput('gist'));
-        $jsonFile = json_decode($jsonSite, true);
+        $json = getContents($this->getInput('gist'));
+        $jsonFile = json_decode($json, true);
 
         $this->mangaTitle = $jsonFile['title'];
 
@@ -66,12 +66,14 @@ class CubariBridge extends BridgeAbstract
     {
         $url = $this->getInput('gist');
 
-        preg_match('/\/([a-z]*)\.githubusercontent.com(.*)/', $url, $matches);
-
-        // raw or gist is first match.
-        $unencoded = $matches[1] . $matches[2];
-
-        return base64_encode($unencoded);
+        if (preg_match('/\/([a-z]*)\.githubusercontent.com(.*)/', $url, $matches)) {
+            // raw or gist is first match.
+            $unencoded = $matches[1] . $matches[2];
+            return base64_encode($unencoded);
+        } else {
+            // todo: fix this
+            return '';
+        }
     }
 
     private function getSanitizedHash($string)
diff --git a/lib/FeedParser.php b/lib/FeedParser.php
index 90df548d..a9aabde0 100644
--- a/lib/FeedParser.php
+++ b/lib/FeedParser.php
@@ -64,7 +64,7 @@ final class FeedParser
                 $feed['items'][] = $this->parseAtomItem($item);
             }
         } else {
-            throw new \Exception(sprintf('Unable to detect feed format from `%s`', $url));
+            throw new \Exception('Unable to detect feed format');
         }
 
         return $feed;
@@ -163,7 +163,9 @@ final class FeedParser
         }
 
         if (isset($feedItem->enclosure) && !empty($feedItem->enclosure['url'])) {
-            $item['enclosures'] = [(string)$feedItem->enclosure['url']];
+            $item['enclosures'] = [
+                (string)$feedItem->enclosure['url'],
+            ];
         }
         return $item;
     }
@@ -189,6 +191,7 @@ final class FeedParser
     {
         $item = [];
         if (isset($feedItem->link)) {
+            // todo: trim uri
             $item['uri'] = (string)$feedItem->link;
         }
         if (isset($feedItem->title)) {

From e379019db27eb7e6c48a9e8c6ae7d3b379dcce16 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 13 Oct 2023 01:02:19 +0200
Subject: [PATCH 167/716] refactor (#3746)

---
 bridges/NextgovBridge.php      | 33 ++++++++--------
 bridges/NyaaTorrentsBridge.php | 71 ++++++++++++++++++++--------------
 bridges/TapasBridge.php        | 22 +++++------
 lib/FeedParser.php             |  3 ++
 4 files changed, 72 insertions(+), 57 deletions(-)

diff --git a/bridges/NextgovBridge.php b/bridges/NextgovBridge.php
index 1e096d6c..bc92d306 100644
--- a/bridges/NextgovBridge.php
+++ b/bridges/NextgovBridge.php
@@ -27,29 +27,30 @@ class NextgovBridge extends FeedExpander
     public function collectData()
     {
         $url = self::URI . 'rss/' . $this->getInput('category') . '/';
-        $this->collectExpandableDatas($url, 10);
+        $limit = 10;
+        $this->collectExpandableDatas($url, $limit);
     }
 
-    protected function parseItem($newsItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($newsItem);
+        $item = parent::parseItem($item);
 
         $article_thumbnail = 'https://cdn.nextgov.com/nextgov/images/logo.png';
         $item['content'] = '<p><b>' . $item['content'] . '</b></p>';
 
-        $namespaces = $newsItem->getNamespaces(true);
-        if (isset($namespaces['media'])) {
-            $media = $newsItem->children($namespaces['media']);
-            if (isset($media->content)) {
-                $attributes = $media->content->attributes();
-                $item['content'] = '<p><img src="' . $attributes['url'] . '"></p>' . $item['content'];
-                $article_thumbnail = str_replace(
-                    'large.jpg',
-                    'small.jpg',
-                    strval($attributes['url'])
-                );
-            }
-        }
+//        $namespaces = $newsItem->getNamespaces(true);
+//        if (isset($namespaces['media'])) {
+//            $media = $newsItem->children($namespaces['media']);
+//            if (isset($media->content)) {
+//                $attributes = $media->content->attributes();
+//                $item['content'] = '<p><img src="' . $attributes['url'] . '"></p>' . $item['content'];
+//                $article_thumbnail = str_replace(
+//                    'large.jpg',
+//                    'small.jpg',
+//                    strval($attributes['url'])
+//                );
+//            }
+//        }
 
         $item['enclosures'] = [$article_thumbnail];
         $item['content'] .= $this->extractContent($item['uri']);
diff --git a/bridges/NyaaTorrentsBridge.php b/bridges/NyaaTorrentsBridge.php
index 3b5ad3ad..f7eea07f 100644
--- a/bridges/NyaaTorrentsBridge.php
+++ b/bridges/NyaaTorrentsBridge.php
@@ -1,6 +1,6 @@
 <?php
 
-class NyaaTorrentsBridge extends FeedExpander
+class NyaaTorrentsBridge extends BridgeAbstract
 {
     const MAINTAINER = 'ORelio & Jisagi';
     const NAME = 'NyaaTorrents';
@@ -62,44 +62,57 @@ class NyaaTorrentsBridge extends FeedExpander
 
     public function collectData()
     {
-        $this->collectExpandableDatas($this->getURI(), 20);
-    }
+        // Manually parsing because we need to acccess the nyaa namespace in the xml
+        $xml = simplexml_load_string(getContents($this->getURI()));
+        $channel = $xml->channel[0];
+        $feed = [];
+        $feed['title'] = trim((string)$channel->title);
+        $feed['uri'] = trim((string)$channel->link);
+        if (!empty($channel->image)) {
+            $feed['icon'] = trim((string)$channel->image->url);
+        }
+        $items = $xml->channel[0]->item;
+        foreach ($items as $feedItem) {
+            $item = [
+                'title' => (string) $feedItem->title,
+                'uri' => (string) $feedItem->link,
+            ];
 
-    protected function parseItem($newsItem)
-    {
-        $item = parent::parseItem($newsItem);
 
-        $nyaaFields = (array)($newsItem->children('nyaa', true));
+            $item['id'] = str_replace(['https://nyaa.si/download/', '.torrent'], '', $item['uri']);
 
-        $item['id'] = str_replace(['https://nyaa.si/download/', '.torrent'], '', $item['uri']);
+            $nyaaNamespace = (array)($feedItem->children('nyaa', true));
+            $item = array_merge($item, $nyaaNamespace);
 
-        $item = array_merge($item, $nyaaFields);
+            // Convert URI from torrent file to web page
+            $item['uri'] = str_replace('/download/', '/view/', $item['uri']);
+            $item['uri'] = str_replace('.torrent', '', $item['uri']);
 
-        // Convert URI from torrent file to web page
-        $item['uri'] = str_replace('/download/', '/view/', $item['uri']);
-        $item['uri'] = str_replace('.torrent', '', $item['uri']);
+            $item_html = getSimpleHTMLDOMCached($item['uri']);
+            if ($item_html) {
+                // Retrieve full description from page contents
+                $item_desc = str_get_html(
+                    markdownToHtml(html_entity_decode($item_html->find('#torrent-description', 0)->innertext))
+                );
 
-        $item_html = getSimpleHTMLDOMCached($item['uri']);
-        if ($item_html) {
-            // Retrieve full description from page contents
-            $item_desc = str_get_html(
-                markdownToHtml(html_entity_decode($item_html->find('#torrent-description', 0)->innertext))
-            );
-
-            // Retrieve image for thumbnail or generic logo fallback
-            $item_image = $this->getURI() . 'static/img/avatar/default.png';
-            foreach ($item_desc->find('img') as $img) {
-                if (strpos($img->src, 'prez') === false) {
-                    $item_image = $img->src;
-                    break;
+                // Retrieve image for thumbnail or generic logo fallback
+                $item_image = $this->getURI() . 'static/img/avatar/default.png';
+                foreach ($item_desc->find('img') as $img) {
+                    if (strpos($img->src, 'prez') === false) {
+                        $item_image = $img->src;
+                        break;
+                    }
                 }
+
+                $item['enclosures'] = [$item_image];
+                $item['content'] = $item_desc;
             }
 
-            $item['enclosures'] = [$item_image];
-            $item['content'] = $item_desc;
+            $this->items[] = $item;
+            if (count($this->items) >= 10) {
+                break;
+            }
         }
-
-        return $item;
     }
 
     public function getIcon()
diff --git a/bridges/TapasBridge.php b/bridges/TapasBridge.php
index 11a9551d..ddfbfb92 100644
--- a/bridges/TapasBridge.php
+++ b/bridges/TapasBridge.php
@@ -43,20 +43,20 @@ class TapasBridge extends FeedExpander
         $this->collectExpandableDatas($this->getURI());
     }
 
-    protected function parseItem($feedItem)
+    protected function parseItem($item)
     {
-        $item = parent::parseItem($feedItem);
+        $item = parent::parseItem($item);
 
-        $namespaces = $feedItem->getNamespaces(true);
-        if (isset($namespaces['content'])) {
-            $description = $feedItem->children($namespaces['content']);
-            if (isset($description->encoded)) {
-                $item['content'] = (string)$description->encoded;
-            }
-        }
+//        $namespaces = $feedItem->getNamespaces(true);
+//        if (isset($namespaces['content'])) {
+//            $description = $feedItem->children($namespaces['content']);
+//            if (isset($description->encoded)) {
+//                $item['content'] = (string)$description->encoded;
+//            }
+//        }
 
         if ($this->getInput('extend_content')) {
-            $html = getSimpleHTMLDOM($item['uri']) or returnServerError('Could not request ' . $this->getURI());
+            $html = getSimpleHTMLDOM($item['uri']);
             if (!$item['content']) {
                 $item['content'] = '';
             }
@@ -79,8 +79,6 @@ class TapasBridge extends FeedExpander
     {
         if ($this->id) {
             return self::URI . 'rss/series/' . $this->id;
-        } else {
-            return self::URI . 'series/' . $this->getInput('title') . '/info/';
         }
         return self::URI;
     }
diff --git a/lib/FeedParser.php b/lib/FeedParser.php
index a9aabde0..04452e7d 100644
--- a/lib/FeedParser.php
+++ b/lib/FeedParser.php
@@ -6,7 +6,10 @@ final class FeedParser
 {
     public function parseFeed(string $xmlString): array
     {
+        libxml_use_internal_errors(true);
         $xml = simplexml_load_string(trim($xmlString));
+        $xmlErrors = libxml_get_errors();
+        libxml_use_internal_errors(false);
         if ($xml === false) {
             throw new \Exception('Unable to parse xml');
         }

From 2880524dfc7685985fde8429c1dcb85387f4ba14 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 13 Oct 2023 01:59:05 +0200
Subject: [PATCH 168/716] refactor: remove parent calls to parseItem (#3747)

---
 bridges/AcrimedBridge.php               |  4 +-
 bridges/ArsTechnicaBridge.php           |  4 +-
 bridges/BleepingComputerBridge.php      |  4 +-
 bridges/CNETFranceBridge.php            |  4 +-
 bridges/CaschyBridge.php                |  4 +-
 bridges/CommonDreamsBridge.php          |  3 +-
 bridges/CourrierInternationalBridge.php |  4 +-
 bridges/DarkReadingBridge.php           |  4 +-
 bridges/DauphineLibereBridge.php        |  3 +-
 bridges/DeutscheWelleBridge.php         |  4 +-
 bridges/DeveloppezDotComBridge.php      |  4 +-
 bridges/EconomistBridge.php             |  3 +-
 bridges/EngadgetBridge.php              |  4 +-
 bridges/EsquerdaNetBridge.php           |  4 +-
 bridges/FeedExpanderTestBridge.php      |  6 +-
 bridges/FilterBridge.php                |  4 +-
 bridges/FolhaDeSaoPauloBridge.php       |  4 +-
 bridges/ForGifsBridge.php               |  4 +-
 bridges/FreeCodeCampBridge.php          |  4 +-
 bridges/FuturaSciencesBridge.php        |  4 +-
 bridges/GizmodoBridge.php               |  4 +-
 bridges/GolemBridge.php                 |  3 +-
 bridges/HardwareInfoBridge.php          |  4 +-
 bridges/HeiseBridge.php                 |  4 +-
 bridges/IGNBridge.php                   |  4 +-
 bridges/KoreusBridge.php                |  4 +-
 bridges/LeMondeInformatiqueBridge.php   |  4 +-
 bridges/ListverseBridge.php             |  3 +-
 bridges/MediapartBridge.php             |  4 +-
 bridges/MsnMondeBridge.php              |  4 +-
 bridges/NYTBridge.php                   |  4 +-
 bridges/NextInpactBridge.php            |  4 +-
 bridges/NextgovBridge.php               |  4 +-
 bridges/NiceMatinBridge.php             |  4 +-
 bridges/OnVaSortirBridge.php            |  3 +-
 bridges/PhoronixBridge.php              |  4 +-
 bridges/QwantzBridge.php                |  6 +-
 bridges/RaceDepartmentBridge.php        |  4 +-
 bridges/ScribbleHubBridge.php           |  4 +-
 bridges/SplCenterBridge.php             |  4 +-
 bridges/TapasBridge.php                 |  4 +-
 bridges/TheGuardianBridge.php           |  4 +-
 bridges/TwitterEngineeringBridge.php    |  4 +-
 bridges/VarietyBridge.php               |  4 +-
 bridges/ViceBridge.php                  |  4 +-
 bridges/WeLiveSecurityBridge.php        |  4 +-
 bridges/WiredBridge.php                 |  4 +-
 bridges/WordPressBridge.php             |  4 +-
 bridges/WorldOfTanksBridge.php          |  3 +-
 bridges/ZDNetBridge.php                 |  4 +-
 bridges/ZeitBridge.php                  |  4 +-
 docs/05_Bridge_API/03_FeedExpander.md   | 90 ++++++-------------------
 docs/05_Bridge_API/index.md             |  2 +-
 lib/FeedExpander.php                    | 88 +++++-------------------
 lib/FeedParser.php                      |  8 +--
 55 files changed, 96 insertions(+), 293 deletions(-)

diff --git a/bridges/AcrimedBridge.php b/bridges/AcrimedBridge.php
index 93890f35..f7bbd58e 100644
--- a/bridges/AcrimedBridge.php
+++ b/bridges/AcrimedBridge.php
@@ -25,10 +25,8 @@ class AcrimedBridge extends FeedExpander
         $this->collectExpandableDatas($url, $limit);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $articlePage = getSimpleHTMLDOM($item['uri']);
         $article = sanitize($articlePage->find('article.article1', 0)->innertext);
         $article = defaultLinkTo($article, static::URI);
diff --git a/bridges/ArsTechnicaBridge.php b/bridges/ArsTechnicaBridge.php
index 98e5566b..d15cfb4f 100644
--- a/bridges/ArsTechnicaBridge.php
+++ b/bridges/ArsTechnicaBridge.php
@@ -33,10 +33,8 @@ class ArsTechnicaBridge extends FeedExpander
         $this->collectExpandableDatas($url);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $item_html = getSimpleHTMLDOMCached($item['uri'] . '&amp');
         $item_html = defaultLinkTo($item_html, self::URI);
         $item['content'] = $item_html->find('.amp-wp-article-content', 0);
diff --git a/bridges/BleepingComputerBridge.php b/bridges/BleepingComputerBridge.php
index bad78561..79d84176 100644
--- a/bridges/BleepingComputerBridge.php
+++ b/bridges/BleepingComputerBridge.php
@@ -13,10 +13,8 @@ class BleepingComputerBridge extends FeedExpander
         $this->collectExpandableDatas($feed);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $article_html = getSimpleHTMLDOMCached($item['uri']);
         if (!$article_html) {
             $item['content'] .= '<p><em>Could not request ' . $this->getName() . ': ' . $item['uri'] . '</em></p>';
diff --git a/bridges/CNETFranceBridge.php b/bridges/CNETFranceBridge.php
index d6a766de..35e92daf 100644
--- a/bridges/CNETFranceBridge.php
+++ b/bridges/CNETFranceBridge.php
@@ -43,10 +43,8 @@ class CNETFranceBridge extends FeedExpander
         $this->collectExpandableDatas('https://www.cnetfrance.fr/feeds/rss/news/');
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         foreach ($this->bannedTitle as $term) {
             if (preg_match('/' . $term . '/mi', $item['title']) === 1) {
                 return null;
diff --git a/bridges/CaschyBridge.php b/bridges/CaschyBridge.php
index 7d632bf6..0e3a07bc 100644
--- a/bridges/CaschyBridge.php
+++ b/bridges/CaschyBridge.php
@@ -34,10 +34,8 @@ class CaschyBridge extends FeedExpander
         );
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         if (strpos($item['uri'], 'https://stadt-bremerhaven.de/') !== 0) {
             return $item;
         }
diff --git a/bridges/CommonDreamsBridge.php b/bridges/CommonDreamsBridge.php
index e1a185de..34532284 100644
--- a/bridges/CommonDreamsBridge.php
+++ b/bridges/CommonDreamsBridge.php
@@ -12,9 +12,8 @@ class CommonDreamsBridge extends FeedExpander
         $this->collectExpandableDatas('http://www.commondreams.org/rss.xml', 10);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
         $item['content'] = $this->extractContent($item['uri']);
         return $item;
     }
diff --git a/bridges/CourrierInternationalBridge.php b/bridges/CourrierInternationalBridge.php
index 9e30fd51..3d9889b0 100644
--- a/bridges/CourrierInternationalBridge.php
+++ b/bridges/CourrierInternationalBridge.php
@@ -13,10 +13,8 @@ class CourrierInternationalBridge extends FeedExpander
         $this->collectExpandableDatas(static::URI . 'feed/all/rss.xml', 20);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $articlePage = getSimpleHTMLDOMCached($item['uri']);
         $content = $articlePage->find('.article-text, depeche-text', 0);
         if (!$content) {
diff --git a/bridges/DarkReadingBridge.php b/bridges/DarkReadingBridge.php
index aca30490..4f1622e3 100644
--- a/bridges/DarkReadingBridge.php
+++ b/bridges/DarkReadingBridge.php
@@ -56,10 +56,8 @@ class DarkReadingBridge extends FeedExpander
         $this->collectExpandableDatas($feed_url, $limit);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $article = getSimpleHTMLDOMCached($item['uri']);
         $item['content'] = $this->extractArticleContent($article);
         $item['enclosures'] = []; //remove author profile picture
diff --git a/bridges/DauphineLibereBridge.php b/bridges/DauphineLibereBridge.php
index 0ab808cd..05748a5d 100644
--- a/bridges/DauphineLibereBridge.php
+++ b/bridges/DauphineLibereBridge.php
@@ -43,9 +43,8 @@ class DauphineLibereBridge extends FeedExpander
         $this->collectExpandableDatas($url, 10);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
         $item['content'] = $this->extractContent($item['uri']);
         return $item;
     }
diff --git a/bridges/DeutscheWelleBridge.php b/bridges/DeutscheWelleBridge.php
index 2e10d670..29b478b9 100644
--- a/bridges/DeutscheWelleBridge.php
+++ b/bridges/DeutscheWelleBridge.php
@@ -71,10 +71,8 @@ class DeutscheWelleBridge extends FeedExpander
         $this->collectExpandableDatas($this->getInput('feed'));
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $parsedUrl = parse_url($item['uri']);
         unset($parsedUrl['query']);
         $url = $this->unparseUrl($parsedUrl);
diff --git a/bridges/DeveloppezDotComBridge.php b/bridges/DeveloppezDotComBridge.php
index 9dcbc31a..d9583fed 100644
--- a/bridges/DeveloppezDotComBridge.php
+++ b/bridges/DeveloppezDotComBridge.php
@@ -176,10 +176,8 @@ class DeveloppezDotComBridge extends FeedExpander
      * Parse the content of every RSS item. And will try to get the full article
      * pointed by the item URL intead of the default abstract.
      */
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         if (count($this->items) >= $this->getInput('limit')) {
             return null;
         }
diff --git a/bridges/EconomistBridge.php b/bridges/EconomistBridge.php
index 0572ab8f..aad72275 100644
--- a/bridges/EconomistBridge.php
+++ b/bridges/EconomistBridge.php
@@ -97,9 +97,8 @@ class EconomistBridge extends FeedExpander
         $this->collectExpandableDatas($url, $limit);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
         $dom = getSimpleHTMLDOM($item['uri']);
 
         $article = $dom->find('#new-article-template', 0);
diff --git a/bridges/EngadgetBridge.php b/bridges/EngadgetBridge.php
index 3253cc2e..b9861b40 100644
--- a/bridges/EngadgetBridge.php
+++ b/bridges/EngadgetBridge.php
@@ -15,10 +15,8 @@ class EngadgetBridge extends FeedExpander
         $this->collectExpandableDatas($url, $max);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $itemUrl = trim($item['uri']);
         if (!$itemUrl) {
             return $item;
diff --git a/bridges/EsquerdaNetBridge.php b/bridges/EsquerdaNetBridge.php
index 64a6949f..aa92aa38 100644
--- a/bridges/EsquerdaNetBridge.php
+++ b/bridges/EsquerdaNetBridge.php
@@ -31,10 +31,8 @@ class EsquerdaNetBridge extends FeedExpander
         parent::collectExpandableDatas($this->getURI());
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $html = getSimpleHTMLDOMCached($item['uri']);
         $content = $html->find('div#content div.content', 0);
         ## Fix author
diff --git a/bridges/FeedExpanderTestBridge.php b/bridges/FeedExpanderTestBridge.php
index 9a6e7bb7..65b3db89 100644
--- a/bridges/FeedExpanderTestBridge.php
+++ b/bridges/FeedExpanderTestBridge.php
@@ -14,9 +14,9 @@ class FeedExpanderTestBridge extends FeedExpander
     public function collectData()
     {
         $url = 'http://static.userland.com/gems/backend/sampleRss.xml'; // rss 0.91
-        //$url = 'http://feeds.nature.com/nature/rss/current?format=xml'; // rss 1.0
-        //$url = 'https://dvikan.no/feed.xml'; // rss 2.0
-        //$url = 'https://nedlasting.geonorge.no/geonorge/Tjenestefeed.xml'; // atom
+        $url = 'http://feeds.nature.com/nature/rss/current?format=xml'; // rss 1.0
+        $url = 'https://dvikan.no/feed.xml'; // rss 2.0
+        $url = 'https://nedlasting.geonorge.no/geonorge/Tjenestefeed.xml'; // atom
 
         $this->collectExpandableDatas($url);
     }
diff --git a/bridges/FilterBridge.php b/bridges/FilterBridge.php
index 3e3e812d..1add47f4 100644
--- a/bridges/FilterBridge.php
+++ b/bridges/FilterBridge.php
@@ -82,10 +82,8 @@ class FilterBridge extends FeedExpander
         $this->collectExpandableDatas($this->getURI());
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         // Generate title from first 50 characters of content?
         if ($this->getInput('title_from_content') && array_key_exists('content', $item)) {
             $content = str_get_html($item['content']);
diff --git a/bridges/FolhaDeSaoPauloBridge.php b/bridges/FolhaDeSaoPauloBridge.php
index d8d93c4f..dba86c52 100644
--- a/bridges/FolhaDeSaoPauloBridge.php
+++ b/bridges/FolhaDeSaoPauloBridge.php
@@ -29,10 +29,8 @@ class FolhaDeSaoPauloBridge extends FeedExpander
         ]
     ];
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         if ($this->getInput('deep_crawl')) {
             $articleHTMLContent = getSimpleHTMLDOMCached($item['uri']);
             if ($articleHTMLContent) {
diff --git a/bridges/ForGifsBridge.php b/bridges/ForGifsBridge.php
index e210124a..0a054930 100644
--- a/bridges/ForGifsBridge.php
+++ b/bridges/ForGifsBridge.php
@@ -12,10 +12,8 @@ class ForGifsBridge extends FeedExpander
         $this->collectExpandableDatas('https://forgifs.com/gallery/srss/7');
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $dom = str_get_html($item['content']);
         $img = $dom->find('img', 0);
         $poster = $img->src;
diff --git a/bridges/FreeCodeCampBridge.php b/bridges/FreeCodeCampBridge.php
index 141746d2..aaeaf7bd 100644
--- a/bridges/FreeCodeCampBridge.php
+++ b/bridges/FreeCodeCampBridge.php
@@ -14,10 +14,8 @@ class FreeCodeCampBridge extends FeedExpander
         $this->collectExpandableDatas('https://www.freecodecamp.org/news/rss/', 15);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $dom = getSimpleHTMLDOM($item['uri']);
 
         // figure contain's the main article image
diff --git a/bridges/FuturaSciencesBridge.php b/bridges/FuturaSciencesBridge.php
index cfb2d711..6420f319 100644
--- a/bridges/FuturaSciencesBridge.php
+++ b/bridges/FuturaSciencesBridge.php
@@ -85,10 +85,8 @@ class FuturaSciencesBridge extends FeedExpander
         $this->collectExpandableDatas($url, 10);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $item['uri'] = str_replace('#xtor%3DRSS-8', '', $item['uri']);
         $dom = getSimpleHTMLDOMCached($item['uri']);
         $item['content'] = $this->extractArticleContent($dom);
diff --git a/bridges/GizmodoBridge.php b/bridges/GizmodoBridge.php
index 8ed30704..52812d33 100644
--- a/bridges/GizmodoBridge.php
+++ b/bridges/GizmodoBridge.php
@@ -8,10 +8,8 @@ class GizmodoBridge extends FeedExpander
     const CACHE_TIMEOUT = 1800; // 30min
     const DESCRIPTION = 'Returns the newest posts from Gizmodo.';
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $html = getSimpleHTMLDOMCached($item['uri']);
 
         $html = defaultLinkTo($html, $this->getURI());
diff --git a/bridges/GolemBridge.php b/bridges/GolemBridge.php
index 96fa4506..6699e433 100644
--- a/bridges/GolemBridge.php
+++ b/bridges/GolemBridge.php
@@ -63,9 +63,8 @@ class GolemBridge extends FeedExpander
         );
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
         $item['content'] ??= '';
         $uri = $item['uri'];
 
diff --git a/bridges/HardwareInfoBridge.php b/bridges/HardwareInfoBridge.php
index 6a47df66..5970ecd0 100644
--- a/bridges/HardwareInfoBridge.php
+++ b/bridges/HardwareInfoBridge.php
@@ -12,10 +12,8 @@ class HardwareInfoBridge extends FeedExpander
         $this->collectExpandableDatas('https://nl.hardware.info/updates/all.rss', 10);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $itemUrl = $item['uri'];
         $articlePage = getSimpleHTMLDOMCached($itemUrl);
 
diff --git a/bridges/HeiseBridge.php b/bridges/HeiseBridge.php
index 434e7514..f89594ee 100644
--- a/bridges/HeiseBridge.php
+++ b/bridges/HeiseBridge.php
@@ -125,10 +125,8 @@ class HeiseBridge extends FeedExpander
         );
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $sessioncookie = $this->getInput('sessioncookie');
 
         // strip rss parameter
diff --git a/bridges/IGNBridge.php b/bridges/IGNBridge.php
index c0260cbd..e063dbbb 100644
--- a/bridges/IGNBridge.php
+++ b/bridges/IGNBridge.php
@@ -15,10 +15,8 @@ class IGNBridge extends FeedExpander
 
     // IGNs feed is both hidden and incomplete. This bridge tries to fix this.
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $articlePage = getSimpleHTMLDOM($item['uri']);
 
         // List of BS elements
diff --git a/bridges/KoreusBridge.php b/bridges/KoreusBridge.php
index 874c2c92..5ef5e11f 100644
--- a/bridges/KoreusBridge.php
+++ b/bridges/KoreusBridge.php
@@ -7,10 +7,8 @@ class KoreusBridge extends FeedExpander
     const URI = 'https://www.koreus.com/';
     const DESCRIPTION = 'Returns the newest posts from Koreus (full text)';
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $html = getSimpleHTMLDOMCached($item['uri']);
         $text = $html->find('p.itemText', 0)->innertext;
         $item['content'] = utf8_encode($text);
diff --git a/bridges/LeMondeInformatiqueBridge.php b/bridges/LeMondeInformatiqueBridge.php
index c91a0437..860c0887 100644
--- a/bridges/LeMondeInformatiqueBridge.php
+++ b/bridges/LeMondeInformatiqueBridge.php
@@ -12,10 +12,8 @@ class LeMondeInformatiqueBridge extends FeedExpander
         $this->collectExpandableDatas(self::URI . 'rss/rss.xml', 10);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $article_html = getSimpleHTMLDOMCached($item['uri']);
 
         //Deduce thumbnail URL from article image URL
diff --git a/bridges/ListverseBridge.php b/bridges/ListverseBridge.php
index b7acbdd0..bffa4cda 100644
--- a/bridges/ListverseBridge.php
+++ b/bridges/ListverseBridge.php
@@ -13,9 +13,8 @@ class ListverseBridge extends FeedExpander
         $this->collectExpandableDatas('https://listverse.com/feed/', 15);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
         $dom = getSimpleHTMLDOM($item['uri']);
         $article = $dom->find('#articlecontentonly', 0);
         $item['content'] = $article;
diff --git a/bridges/MediapartBridge.php b/bridges/MediapartBridge.php
index c4deda61..aa10e159 100644
--- a/bridges/MediapartBridge.php
+++ b/bridges/MediapartBridge.php
@@ -29,10 +29,8 @@ class MediapartBridge extends FeedExpander
         $this->collectExpandableDatas($url);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $itemUrl = $item['uri'];
 
         // Mediapart provide multiple type of contents.
diff --git a/bridges/MsnMondeBridge.php b/bridges/MsnMondeBridge.php
index 9b308b99..a2592702 100644
--- a/bridges/MsnMondeBridge.php
+++ b/bridges/MsnMondeBridge.php
@@ -25,10 +25,8 @@ class MsnMondeBridge extends FeedExpander
         $this->collectExpandableDatas(self::FEED_URL, 10);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         if (!preg_match('#fr-fr/actualite.*/ar-(?<id>[\w]*)\?#', $item['uri'], $matches)) {
             return null;
         }
diff --git a/bridges/NYTBridge.php b/bridges/NYTBridge.php
index 57c3e2af..a9942e2d 100644
--- a/bridges/NYTBridge.php
+++ b/bridges/NYTBridge.php
@@ -14,10 +14,8 @@ class NYTBridge extends FeedExpander
         $this->collectExpandableDatas($url, 40);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $article = '';
 
         try {
diff --git a/bridges/NextInpactBridge.php b/bridges/NextInpactBridge.php
index 0260da14..6982c104 100644
--- a/bridges/NextInpactBridge.php
+++ b/bridges/NextInpactBridge.php
@@ -88,10 +88,8 @@ class NextInpactBridge extends FeedExpander
         $this->collectExpandableDatas($url, $limit);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $item['content'] = $this->extractContent($item, $item['uri']);
         if (is_null($item['content'])) {
             return null; //Filtered article
diff --git a/bridges/NextgovBridge.php b/bridges/NextgovBridge.php
index bc92d306..7fe7130a 100644
--- a/bridges/NextgovBridge.php
+++ b/bridges/NextgovBridge.php
@@ -31,10 +31,8 @@ class NextgovBridge extends FeedExpander
         $this->collectExpandableDatas($url, $limit);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $article_thumbnail = 'https://cdn.nextgov.com/nextgov/images/logo.png';
         $item['content'] = '<p><b>' . $item['content'] . '</b></p>';
 
diff --git a/bridges/NiceMatinBridge.php b/bridges/NiceMatinBridge.php
index bcebbbbb..dd90dbfe 100644
--- a/bridges/NiceMatinBridge.php
+++ b/bridges/NiceMatinBridge.php
@@ -12,10 +12,8 @@ class NiceMatinBridge extends FeedExpander
         $this->collectExpandableDatas(self::URI . 'derniere-minute/rss', 10);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $item['content'] = $this->extractContent($item['uri']);
         return $item;
     }
diff --git a/bridges/OnVaSortirBridge.php b/bridges/OnVaSortirBridge.php
index 9f9a750c..f8c395c1 100644
--- a/bridges/OnVaSortirBridge.php
+++ b/bridges/OnVaSortirBridge.php
@@ -123,9 +123,8 @@ class OnVaSortirBridge extends FeedExpander
         $this->collectExpandableDatas($url);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
         $dom = getSimpleHTMLDOMCached($item['uri']);
         $text = $dom->find('div.corpsMax', 0)->innertext;
         $item['content'] = utf8_encode($text);
diff --git a/bridges/PhoronixBridge.php b/bridges/PhoronixBridge.php
index fc0d78e5..227685e0 100644
--- a/bridges/PhoronixBridge.php
+++ b/bridges/PhoronixBridge.php
@@ -29,10 +29,8 @@ but some RSS readers don\'t support this. "img" tag are supported by most browse
         $this->collectExpandableDatas('https://www.phoronix.com/rss.php', $this->getInput('n'));
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $itemUrl = $item['uri'];
 
         $articlePage = getSimpleHTMLDOM($itemUrl);
diff --git a/bridges/QwantzBridge.php b/bridges/QwantzBridge.php
index 2117c33c..b975bd43 100644
--- a/bridges/QwantzBridge.php
+++ b/bridges/QwantzBridge.php
@@ -11,14 +11,12 @@ class QwantzBridge extends FeedExpander
         $this->collectExpandableDatas(self::URI . 'rssfeed.php');
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $item['author'] = 'Ryan North';
 
         preg_match('/title="(.*?)"/', $item['content'], $matches);
-        $title = $matches[1];
+        $title = $matches[1] ?? '';
 
         $content = str_get_html(html_entity_decode($item['content']));
         $comicURL = $content->find('img')[0]->{'src'};
diff --git a/bridges/RaceDepartmentBridge.php b/bridges/RaceDepartmentBridge.php
index 3783b53e..7390761f 100644
--- a/bridges/RaceDepartmentBridge.php
+++ b/bridges/RaceDepartmentBridge.php
@@ -12,10 +12,8 @@ class RaceDepartmentBridge extends FeedExpander
         $this->collectExpandableDatas('https://www.racedepartment.com/ams/index.rss', 10);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $articlePage = getSimpleHTMLDOMCached($item['uri']);
 
         $coverImage = $articlePage->find('img.js-articleCoverImage', 0);
diff --git a/bridges/ScribbleHubBridge.php b/bridges/ScribbleHubBridge.php
index 8f52d461..e7cdf337 100644
--- a/bridges/ScribbleHubBridge.php
+++ b/bridges/ScribbleHubBridge.php
@@ -42,10 +42,8 @@ class ScribbleHubBridge extends FeedExpander
         $this->collectExpandableDatas($url);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         //For series, filter out other series from 'All' feed
         if (
             $this->queriedContext === 'Series'
diff --git a/bridges/SplCenterBridge.php b/bridges/SplCenterBridge.php
index ca764846..af25ec48 100644
--- a/bridges/SplCenterBridge.php
+++ b/bridges/SplCenterBridge.php
@@ -27,10 +27,8 @@ class SplCenterBridge extends FeedExpander
         $this->collectExpandableDatas($url);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $articleHtml = getSimpleHTMLDOMCached($item['uri']);
 
         foreach ($articleHtml->find('.file') as $index => $media) {
diff --git a/bridges/TapasBridge.php b/bridges/TapasBridge.php
index ddfbfb92..19995a23 100644
--- a/bridges/TapasBridge.php
+++ b/bridges/TapasBridge.php
@@ -43,10 +43,8 @@ class TapasBridge extends FeedExpander
         $this->collectExpandableDatas($this->getURI());
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
 //        $namespaces = $feedItem->getNamespaces(true);
 //        if (isset($namespaces['content'])) {
 //            $description = $feedItem->children($namespaces['content']);
diff --git a/bridges/TheGuardianBridge.php b/bridges/TheGuardianBridge.php
index 98e56506..ac8a9661 100644
--- a/bridges/TheGuardianBridge.php
+++ b/bridges/TheGuardianBridge.php
@@ -56,10 +56,8 @@ class TheGuardianBridge extends FeedExpander
         $this->collectExpandableDatas($url, 10);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $articlePage = getSimpleHTMLDOM($item['uri']);
         // figure contain's the main article image
         $article = $articlePage->find('figure', 0);
diff --git a/bridges/TwitterEngineeringBridge.php b/bridges/TwitterEngineeringBridge.php
index b98cfb87..96319c97 100644
--- a/bridges/TwitterEngineeringBridge.php
+++ b/bridges/TwitterEngineeringBridge.php
@@ -14,10 +14,8 @@ class TwitterEngineeringBridge extends FeedExpander
         $this->collectExpandableDatas($url);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $dom = getSimpleHTMLDOMCached($item['uri']);
         if (!$dom) {
             $item['content'] .= '<p><em>Could not request ' . $this->getName() . ': ' . $item['uri'] . '</em></p>';
diff --git a/bridges/VarietyBridge.php b/bridges/VarietyBridge.php
index 6625dca2..a49ea353 100644
--- a/bridges/VarietyBridge.php
+++ b/bridges/VarietyBridge.php
@@ -13,10 +13,8 @@ class VarietyBridge extends FeedExpander
         $this->collectExpandableDatas('https://feeds.feedburner.com/variety/headlines', 15);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-        // $articlePage gets the entire page's contents
         $articlePage = getSimpleHTMLDOM($item['uri']);
 
         // Remove Script tags
diff --git a/bridges/ViceBridge.php b/bridges/ViceBridge.php
index c7ecec33..dd81c559 100644
--- a/bridges/ViceBridge.php
+++ b/bridges/ViceBridge.php
@@ -32,10 +32,8 @@ class ViceBridge extends FeedExpander
         $this->collectExpandableDatas($feedURL, 10);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $articlePage = getSimpleHTMLDOM($item['uri']);
         // text and embedded content
         $article = $articlePage->find('.article__body', 0);
diff --git a/bridges/WeLiveSecurityBridge.php b/bridges/WeLiveSecurityBridge.php
index f54f6b29..151484c4 100644
--- a/bridges/WeLiveSecurityBridge.php
+++ b/bridges/WeLiveSecurityBridge.php
@@ -12,10 +12,8 @@ class WeLiveSecurityBridge extends FeedExpander
         ],
     ];
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $html = getSimpleHTMLDOMCached($item['uri']);
         if (!$html) {
             $item['content'] .= '<br /><p><em>Could not request ' . $this->getName() . ': ' . $item['uri'] . '</em></p>';
diff --git a/bridges/WiredBridge.php b/bridges/WiredBridge.php
index 7f7f6051..f7da288c 100644
--- a/bridges/WiredBridge.php
+++ b/bridges/WiredBridge.php
@@ -50,10 +50,8 @@ class WiredBridge extends FeedExpander
         $this->collectExpandableDatas($feed_url, $limit);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $originalContent = $item['content'];
 
         $article = getSimpleHTMLDOMCached($item['uri']);
diff --git a/bridges/WordPressBridge.php b/bridges/WordPressBridge.php
index fb27eb31..84a6b8ab 100644
--- a/bridges/WordPressBridge.php
+++ b/bridges/WordPressBridge.php
@@ -34,10 +34,8 @@ class WordPressBridge extends FeedExpander
         }
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $dom = getSimpleHTMLDOMCached($item['uri']);
 
         // Find article body
diff --git a/bridges/WorldOfTanksBridge.php b/bridges/WorldOfTanksBridge.php
index 52691025..7bf20015 100644
--- a/bridges/WorldOfTanksBridge.php
+++ b/bridges/WorldOfTanksBridge.php
@@ -30,9 +30,8 @@ class WorldOfTanksBridge extends FeedExpander
         $this->collectExpandableDatas(sprintf('https://worldoftanks.eu/%s/rss/news/', $this->getInput('lang')));
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
         $item['content'] = $this->loadFullArticle($item['uri']);
         return $item;
     }
diff --git a/bridges/ZDNetBridge.php b/bridges/ZDNetBridge.php
index 00b272ce..e3b659a8 100644
--- a/bridges/ZDNetBridge.php
+++ b/bridges/ZDNetBridge.php
@@ -174,10 +174,8 @@ class ZDNetBridge extends FeedExpander
         $this->collectExpandableDatas($url, $limit);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $article = getSimpleHTMLDOMCached($item['uri']);
         if (!$article) {
             $this->logger->info('Unable to parse the dom from ' . $item['uri']);
diff --git a/bridges/ZeitBridge.php b/bridges/ZeitBridge.php
index 7d7e89aa..0ed9276b 100644
--- a/bridges/ZeitBridge.php
+++ b/bridges/ZeitBridge.php
@@ -59,10 +59,8 @@ class ZeitBridge extends FeedExpander
         $this->collectExpandableDatas($url, $limit);
     }
 
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        $item = parent::parseItem($item);
-
         $item['enclosures'] = [];
 
         $headers = [
diff --git a/docs/05_Bridge_API/03_FeedExpander.md b/docs/05_Bridge_API/03_FeedExpander.md
index 910d1abb..62356fc9 100644
--- a/docs/05_Bridge_API/03_FeedExpander.md
+++ b/docs/05_Bridge_API/03_FeedExpander.md
@@ -1,85 +1,35 @@
-`FeedExpander` extends [`BridgeAbstract`](./02_BridgeAbstract.md) and adds functions to collect data from existing feeds.
-
 **Usage example**: _You have discovered a site that provides feeds which are hidden and inaccessible by normal means. You want your bridge to directly read the feeds and provide them via **RSS-Bridge**_
 
-To create a new Bridge extending `FeedExpander` you must implement all required functions of [`BridgeAbstract`](./02_BridgeAbstract.md). `FeedExpander` additionally provides following functions:
-
-* [`parseItem`](#the-parseitem-function)
-* [`getName`](#the-getname-function)
-* [`getURI`](#the-geturi-function)
-* [`getDescription`](#the-getdescription-function)
-
 Find a [template](#template) at the end of this file.
 
 **Notice:** For a standard feed only `collectData` need to be implemented. `collectData` should call `$this->collectExpandableDatas('your URI here');` to automatically load feed items and header data (will subsequently call `parseItem` for each item in the feed). You can limit the number of items to fetch by specifying an additional parameter for: `$this->collectExpandableDatas('your URI here', 10)` (limited to 10 items).
 
-## The `parseItem` function
+## The `parseItem` method
 
-This function receives one item from the current feed and should return one **RSS-Bridge** item.
+This method receives one item from the current feed and should return one **RSS-Bridge** item.
 The default function does all the work to get the item data from the feed, whether it is RSS 1.0,
-RSS 2.0 or Atom 1.0. If you have to redefine this function in your **RSS-Bridge** for whatever reason,
-you should first call the parent function to initialize the item, then apply the changes that you require.
+RSS 2.0 or Atom 1.0.
 
 **Notice:** The following code sample is just an example. Implementation depends on your requirements!
 
 ```PHP
-protected function parseItem($feedItem){
-    $item = parent::parseItem($feedItem);
-    $item['content'] = str_replace('rssbridge','RSS-Bridge',$feedItem->content);
-
+protected function parseItem(array $item)
+{
+    $item['content'] = str_replace('rssbridge','RSS-Bridge',$item['content']);
     return $item;
 }
 ```
 
-### Helper functions
+### Feed parsing
 
-The `FeedExpander` already provides a set of functions to parse RSS or Atom items based on the specifications. Where possible make use of these functions:
-
-Function | Description
----------|------------
-`parseATOMItem` | Parses an Atom 1.0 feed item
-`parseRSS_0_9_1_Item` | Parses an RSS 0.91 feed item
-`parseRSS_1_0_Item` | Parses an RSS 1.0 feed item
-`parseRSS_2_0_Item` | Parses an RSS 2.0 feed item
-
-In the following list you'll find the feed tags assigned to the the **RSS-Bridge** item keys:
+How rss-bridge processes xml feeds:
 
 Function | uri | title | timestamp | author | content
 ---------|-----|-------|-----------|--------|--------
-`parseATOMItem` | id | title | updated | author | content
-`parseRSS_0_9_1_Item` | link | title | | | description
-`parseRSS_1_0_Item` | link | title | dc:date | dc:creator | description
-`parseRSS_2_0_Item` | link, guid | title | pubDate, dc:date | author, dc:creator | description
-
-## The `getName` function
-
-Returns the name of the current feed.
-
-```PHP
-return $this->name;
-```
-
-**Notice:** Only implement this function if you require different behavior!
-
-## The `getURI` function
-
-Return the uri for the current feed.
-
-```PHP
-return $this->uri;
-```
-
-**Notice:** Only implement this function if you require different behavior!
-
-## The `getDescription` function
-
-Returns the description for the current bridge.
-
-```PHP
-return $this->description;
-```
-
-**Notice:** Only implement this function if you require different behavior!
+`atom` | id | title | updated | author | content
+`rss 0.91` | link | title | | | description
+`rss 1.0` | link | title | dc:date | dc:creator | description
+`rss 2.0` | link, guid | title | pubDate, dc:date | author, dc:creator | description
 
 # Template
 
@@ -87,19 +37,19 @@ This is the template for a new bridge:
 
 ```PHP
 <?php
-class MySiteBridge extends FeedExpander {
+class MySiteBridge extends FeedExpander
+{
 
-	const MAINTAINER = 'No maintainer';
-	const NAME = 'Unnamed bridge';
-	const URI = '';
-	const DESCRIPTION = 'No description provided';
-	const PARAMETERS = [];
-	const CACHE_TIMEOUT = 3600;
+    const MAINTAINER = 'No maintainer';
+    const NAME = 'Unnamed bridge';
+    const URI = '';
+    const DESCRIPTION = 'No description provided';
+    const PARAMETERS = [];
+    const CACHE_TIMEOUT = 3600;
 
     public function collectData()
     {
         $this->collectExpandableDatas('your feed URI');
     }
 }
-// Imaginary empty line!
 ```
\ No newline at end of file
diff --git a/docs/05_Bridge_API/index.md b/docs/05_Bridge_API/index.md
index e49e47be..06445246 100644
--- a/docs/05_Bridge_API/index.md
+++ b/docs/05_Bridge_API/index.md
@@ -7,7 +7,7 @@ and extends one of the base classes of **RSS-Bridge**:
 Base class | Description
 -----------|------------
 [`BridgeAbstract`](./02_BridgeAbstract.md) | This class is intended for standard _Bridges_ that need to filter HTML pages for content.
-[`FeedExpander`](./03_FeedExpander.md) | This class is an extension of `HttpCachingBridgeAbstract`, designed to load existing feeds into **RSS-Bridge**
+[`FeedExpander`](./03_FeedExpander.md) | Expand/modify existing feed urls
 [`XPathAbstract`](./04_XPathAbstract.md) | This class is meant as an alternative base class for bridge implementations. It offers preliminary functionality for generating feeds based on _XPath expressions_.
 
 For more information about how to create a new _Bridge_, read [How to create a new Bridge?](./01_How_to_create_a_new_bridge.md)
\ No newline at end of file
diff --git a/lib/FeedExpander.php b/lib/FeedExpander.php
index 70c4560d..f9cff900 100644
--- a/lib/FeedExpander.php
+++ b/lib/FeedExpander.php
@@ -5,111 +5,57 @@
  */
 abstract class FeedExpander extends BridgeAbstract
 {
-    const FEED_TYPE_RSS_1_0 = 'RSS_1_0';
-    const FEED_TYPE_RSS_2_0 = 'RSS_2_0';
-    const FEED_TYPE_ATOM_1_0 = 'ATOM_1_0';
-
-    private string $feedType;
-    private FeedParser $feedParser;
-    private array $parsedFeed;
-
-    public function __construct(CacheInterface $cache, Logger $logger)
-    {
-        parent::__construct($cache, $logger);
-        $this->feedParser = new FeedParser();
-    }
+    private array $feed;
 
     public function collectExpandableDatas(string $url, $maxItems = -1)
     {
         if (!$url) {
             throw new \Exception('There is no $url for this RSS expander');
         }
+        $maxItems = (int) $maxItems;
         if ($maxItems === -1) {
             $maxItems = 999;
         }
         $accept = [MrssFormat::MIME_TYPE, AtomFormat::MIME_TYPE, '*/*'];
         $httpHeaders = ['Accept: ' . implode(', ', $accept)];
-        // Notice we do not use cache here on purpose. We want a fresh view of the RSS stream each time
         $xmlString = getContents($url, $httpHeaders);
         if ($xmlString === '') {
             throw new \Exception(sprintf('Unable to parse xml from `%s` because we got the empty string', $url), 10);
         }
-        // Maybe move this call earlier up the stack frames
-        // Disable triggering of the php error-handler and handle errors manually instead
-        libxml_use_internal_errors(true);
-        // Consider replacing libxml with https://www.php.net/domdocument
-        // Intentionally not using the silencing operator (@) because it has no effect here
-        $xml = simplexml_load_string(trim($xmlString));
-        if ($xml === false) {
-            $xmlErrors = libxml_get_errors();
-            foreach ($xmlErrors as $xmlError) {
-                Debug::log(trim($xmlError->message));
-            }
-            if ($xmlErrors) {
-                // Render only the first error into exception message
-                $firstXmlErrorMessage = $xmlErrors[0]->message;
-            }
-            throw new \Exception(sprintf('Unable to parse xml from `%s` %s', $url, $firstXmlErrorMessage ?? ''), 11);
-        }
-        // Restore previous behaviour in case other code relies on it being off
-        libxml_use_internal_errors(false);
-
-        // Currently only feed metadata (not items) are plucked out
-        $this->parsedFeed = $this->feedParser->parseFeed($xmlString);
-
-        if (isset($xml->item[0])) {
-            $this->feedType = self::FEED_TYPE_RSS_1_0;
-            $items = $xml->item;
-        } elseif (isset($xml->channel[0])) {
-            $this->feedType = self::FEED_TYPE_RSS_2_0;
-            $items = $xml->channel[0]->item;
-        } elseif (isset($xml->entry[0])) {
-            $this->feedType = self::FEED_TYPE_ATOM_1_0;
-            $items = $xml->entry;
-        } else {
-            throw new \Exception(sprintf('Unable to detect feed format from `%s`', $url));
-        }
+        $feedParser = new FeedParser();
+        $this->feed = $feedParser->parseFeed($xmlString);
+        $items = array_slice($this->feed['items'], 0, $maxItems);
         foreach ($items as $item) {
-            $parsedItem = $this->parseItem($item);
-            if ($parsedItem) {
-                $this->items[] = $parsedItem;
-            }
-            if (count($this->items) >= $maxItems) {
-                break;
+            // Give bridges a chance to modify the item
+            $item = $this->parseItem($item);
+            if ($item) {
+                $this->items[] = $item;
             }
         }
-        return $this;
     }
 
     /**
-     * @param \SimpleXMLElement $item The feed item to be parsed
+     * This method is overidden by bridges
+     *
+     * @return array
      */
-    protected function parseItem($item)
+    protected function parseItem(array $item)
     {
-        switch ($this->feedType) {
-            case self::FEED_TYPE_RSS_1_0:
-                return $this->feedParser->parseRss1Item($item);
-            case self::FEED_TYPE_RSS_2_0:
-                return $this->feedParser->parseRss2Item($item);
-            case self::FEED_TYPE_ATOM_1_0:
-                return $this->feedParser->parseAtomItem($item);
-            default:
-                throw new \Exception(sprintf('Unknown version %s!', $this->getInput('version')));
-        }
+        return $item;
     }
 
     public function getURI()
     {
-        return $this->parsedFeed['uri'] ?? parent::getURI();
+        return $this->feed['uri'] ?? parent::getURI();
     }
 
     public function getName()
     {
-        return $this->parsedFeed['title'] ?? parent::getName();
+        return $this->feed['title'] ?? parent::getName();
     }
 
     public function getIcon()
     {
-        return $this->parsedFeed['icon'] ?? parent::getIcon();
+        return $this->feed['icon'] ?? parent::getIcon();
     }
 }
diff --git a/lib/FeedParser.php b/lib/FeedParser.php
index 04452e7d..0a5b4679 100644
--- a/lib/FeedParser.php
+++ b/lib/FeedParser.php
@@ -14,10 +14,10 @@ final class FeedParser
             throw new \Exception('Unable to parse xml');
         }
         $feed = [
-            'title' => null,
-            'url'   => null,
-            'icon'  => null,
-            'items' => [],
+            'title'     => null,
+            'uri'       => null,
+            'icon'      => null,
+            'items'     => [],
         ];
         if (isset($xml->item[0])) {
             // rss 1.0

From 49d9dafaecdb1e63ba1fe966f0e73c7f228fa5c3 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 13 Oct 2023 02:31:09 +0200
Subject: [PATCH 169/716] refactor: more feed parsing tweaks (#3748)

---
 bridges/TapasBridge.php |  7 +++----
 lib/FeedExpander.php    |  5 +++++
 lib/FeedParser.php      | 15 ++++++++++++---
 3 files changed, 20 insertions(+), 7 deletions(-)

diff --git a/bridges/TapasBridge.php b/bridges/TapasBridge.php
index 19995a23..ea6a7ff6 100644
--- a/bridges/TapasBridge.php
+++ b/bridges/TapasBridge.php
@@ -40,7 +40,7 @@ class TapasBridge extends FeedExpander
             $this->id = $html->find('meta[property$=":url"]', 0)->content;
             $this->id = str_ireplace(['tapastic://series/', '/info'], '', $this->id);
         }
-        $this->collectExpandableDatas($this->getURI());
+        $this->collectExpandableDatas($this->getURI(), 10);
     }
 
     protected function parseItem(array $item)
@@ -55,9 +55,8 @@ class TapasBridge extends FeedExpander
 
         if ($this->getInput('extend_content')) {
             $html = getSimpleHTMLDOM($item['uri']);
-            if (!$item['content']) {
-                $item['content'] = '';
-            }
+            $item['content'] = $item['content'] ?? '';
+
             if ($html->find('article.main__body', 0)) {
                 foreach ($html->find('article', 0)->find('img') as $line) {
                     $item['content'] .= '<img src="' . $line->{'data-src'} . '">';
diff --git a/lib/FeedExpander.php b/lib/FeedExpander.php
index f9cff900..361df4d9 100644
--- a/lib/FeedExpander.php
+++ b/lib/FeedExpander.php
@@ -22,6 +22,11 @@ abstract class FeedExpander extends BridgeAbstract
         if ($xmlString === '') {
             throw new \Exception(sprintf('Unable to parse xml from `%s` because we got the empty string', $url), 10);
         }
+        // prepare/massage the xml to make it more acceptable
+        $badStrings = [
+            '&raquo;',
+        ];
+        $xmlString = str_replace($badStrings, '', $xmlString);
         $feedParser = new FeedParser();
         $this->feed = $feedParser->parseFeed($xmlString);
         $items = array_slice($this->feed['items'], 0, $maxItems);
diff --git a/lib/FeedParser.php b/lib/FeedParser.php
index 0a5b4679..7c8a5232 100644
--- a/lib/FeedParser.php
+++ b/lib/FeedParser.php
@@ -11,7 +11,10 @@ final class FeedParser
         $xmlErrors = libxml_get_errors();
         libxml_use_internal_errors(false);
         if ($xml === false) {
-            throw new \Exception('Unable to parse xml');
+            if ($xmlErrors) {
+                $firstXmlErrorMessage = $xmlErrors[0]->message;
+            }
+            throw new \Exception(sprintf('Unable to parse xml: %s', $firstXmlErrorMessage ?? ''));
         }
         $feed = [
             'title'     => null,
@@ -123,7 +126,6 @@ final class FeedParser
     {
         // Primary data is compatible to 0.91 with some additional data
         $item = $this->parseRss091Item($feedItem);
-
         $namespaces = $feedItem->getNamespaces(true);
         if (isset($namespaces['dc'])) {
             $dc = $feedItem->children($namespaces['dc']);
@@ -192,7 +194,14 @@ final class FeedParser
 
     public function parseRss091Item(\SimpleXMLElement $feedItem): array
     {
-        $item = [];
+        $item = [
+            'uri'           => null,
+            'title'         => null,
+            'content'       => null,
+            'timestamp'     => null,
+            'author'        => null,
+            'enclosures'    => [],
+        ];
         if (isset($feedItem->link)) {
             // todo: trim uri
             $item['uri'] = (string)$feedItem->link;

From 920d00480dcfa669229ad6a420525e2e670a38bf Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 13 Oct 2023 11:24:22 +0200
Subject: [PATCH 170/716] fix(senscritique) (#3750)

---
 bridges/SensCritiqueBridge.php | 38 +++++++---------------------------
 bridges/VkBridge.php           |  4 ++--
 lib/FeedParser.php             |  9 ++++++++
 lib/FormatAbstract.php         |  5 ++++-
 lib/url.php                    |  7 +++++--
 5 files changed, 28 insertions(+), 35 deletions(-)

diff --git a/bridges/SensCritiqueBridge.php b/bridges/SensCritiqueBridge.php
index 9e42d6a6..b823b55c 100644
--- a/bridges/SensCritiqueBridge.php
+++ b/bridges/SensCritiqueBridge.php
@@ -56,7 +56,8 @@ class SensCritiqueBridge extends BridgeAbstract
                         break;
                 }
                 $html = getSimpleHTMLDOM($uri);
-                $list = $html->find('ul.elpr-list', 0);
+                // This selector name looks like it's automatically generated
+                $list = $html->find('div.Universes__WrapperProducts-sc-1qa2w66-0.eVdcAv', 0);
 
                 $this->extractDataFromList($list);
             }
@@ -68,36 +69,13 @@ class SensCritiqueBridge extends BridgeAbstract
         if ($list === null) {
             returnClientError('Cannot extract data from list');
         }
-
-        foreach ($list->find('li') as $movie) {
+        foreach ($list->find('div[data-testid="product-list-item"]') as $movie) {
             $item = [];
-            $item['author'] = htmlspecialchars_decode($movie->find('.elco-title a', 0)->plaintext, ENT_QUOTES)
-            . ' '
-            . $movie->find('.elco-date', 0)->plaintext;
-
-            $item['title'] = $movie->find('.elco-title a', 0)->plaintext
-            . ' '
-            . $movie->find('.elco-date', 0)->plaintext;
-
-            $item['content'] = '';
-            $originalTitle = $movie->find('.elco-original-title', 0);
-            $description = $movie->find('.elco-description', 0);
-
-            if ($originalTitle) {
-                $item['content'] = '<em>' . $originalTitle->plaintext . '</em><br><br>';
-            }
-
-            $item['content'] .= $movie->find('.elco-baseline', 0)->plaintext
-            . '<br>'
-            . $movie->find('.elco-baseline', 1)->plaintext
-            . '<br><br>'
-            . ($description ? $description->plaintext : '')
-            . '<br><br>'
-            . trim($movie->find('.erra-ratings .erra-global', 0)->plaintext)
-            . ' / 10';
-
-            $item['id'] = $this->getURI() . ltrim($movie->find('.elco-title a', 0)->href, '/');
-            $item['uri'] = $this->getURI() . ltrim($movie->find('.elco-title a', 0)->href, '/');
+            $item['title'] = $movie->find('h2 a', 0)->plaintext;
+            // todo: fix image
+            $item['content'] = $movie->innertext;
+            $item['id'] = $this->getURI() . ltrim($movie->find('a', 0)->href, '/');
+            $item['uri'] = $this->getURI() . ltrim($movie->find('a', 0)->href, '/');
             $this->items[] = $item;
         }
     }
diff --git a/bridges/VkBridge.php b/bridges/VkBridge.php
index d86b9cf9..0d47692d 100644
--- a/bridges/VkBridge.php
+++ b/bridges/VkBridge.php
@@ -158,8 +158,8 @@ class VkBridge extends BridgeAbstract
                     $article_author_selector = 'div.article_snippet__author';
                     $article_thumb_selector = 'div.article_snippet__image';
                 }
-                $article_title = $article->find($article_title_selector, 0)->innertext;
-                $article_author = $article->find($article_author_selector, 0)->innertext;
+                $article_title = $article->find($article_title_selector, 0)->innertext ?? '';
+                $article_author = $article->find($article_author_selector, 0)->innertext ?? '';
                 $article_link = $article->getAttribute('href');
                 $article_img_element_style = $article->find($article_thumb_selector, 0)->getAttribute('style');
                 preg_match('/background-image: url\((.*)\)/', $article_img_element_style, $matches);
diff --git a/lib/FeedParser.php b/lib/FeedParser.php
index 7c8a5232..64a3587d 100644
--- a/lib/FeedParser.php
+++ b/lib/FeedParser.php
@@ -2,6 +2,13 @@
 
 declare(strict_types=1);
 
+/**
+ * Very basic and naive feed parser that srapes out rss 0.91, 1.0, 2.0 and atom 1.0.
+ *
+ * Emit arrays meant to be used inside rss-bridge.
+ *
+ * The feed item structure is identical to that of FeedItem
+ */
 final class FeedParser
 {
     public function parseFeed(string $xmlString): array
@@ -200,6 +207,8 @@ final class FeedParser
             'content'       => null,
             'timestamp'     => null,
             'author'        => null,
+            'uid'           => null,
+            'categories'    => [],
             'enclosures'    => [],
         ];
         if (isset($feedItem->link)) {
diff --git a/lib/FormatAbstract.php b/lib/FormatAbstract.php
index 0304f627..b05a5764 100644
--- a/lib/FormatAbstract.php
+++ b/lib/FormatAbstract.php
@@ -31,7 +31,10 @@ abstract class FormatAbstract
         $this->lastModified = $lastModified;
     }
 
-    public function setItems(array $items)
+    /**
+     * @param FeedItem[] $items
+     */
+    public function setItems(array $items): void
     {
         $this->items = $items;
     }
diff --git a/lib/url.php b/lib/url.php
index 2dcbbba5..993fef96 100644
--- a/lib/url.php
+++ b/lib/url.php
@@ -7,7 +7,9 @@ final class UrlException extends \Exception
 }
 
 /**
- * Intentionally restrictive url parser
+ * Intentionally restrictive url parser.
+ *
+ * Only absolute http/https urls.
  */
 final class Url
 {
@@ -29,7 +31,7 @@ final class Url
 
         $parts = parse_url($url);
         if ($parts === false) {
-            throw new UrlException(sprintf('Invalid url %s', $url));
+            throw new UrlException(sprintf('Failed to parse_url(): %s', $url));
         }
 
         return (new self())
@@ -38,6 +40,7 @@ final class Url
             ->withPort($parts['port'] ?? 80)
             ->withPath($parts['path'] ?? '/')
             ->withQueryString($parts['query'] ?? null);
+            // todo: add fragment
     }
 
     public static function validate(string $url): bool

From fd52b9b9a487cd6693455ed6df36d6b805adb1f7 Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Fri, 13 Oct 2023 19:27:33 +0200
Subject: [PATCH 171/716] [CssSelectorFeedExpander] Fix ArgumentCountError
 (#3739) (#3751)

* [CssSelectorFeedExpander] Fix ArgumentCountError (#3739)

Fix ArgumentCountError (#3739) using new FeedParser class (#3740)
Implement default value for feed name / url if missing

* [CssSelectorFeedExpander] Skip empty fields in source feed

Fix empty feed properties being passed down from source feed
 rssbridge.DEBUG lib/FeedItem.php(177): Author must be a string!
 rssbridge.DEBUG lib/FeedItem.php(267): Unique id must be a string!

If "don't expand metadata" is checked, then source feed is passed
down verbatim (only content is expanded) so the debug messages
will persist, but the issue is in source feed, not in the bridge.
---
 bridges/CssSelectorFeedExpanderBridge.php | 40 ++++++++++++-----------
 1 file changed, 21 insertions(+), 19 deletions(-)

diff --git a/bridges/CssSelectorFeedExpanderBridge.php b/bridges/CssSelectorFeedExpanderBridge.php
index 008921b1..9f332fb9 100644
--- a/bridges/CssSelectorFeedExpanderBridge.php
+++ b/bridges/CssSelectorFeedExpanderBridge.php
@@ -1,16 +1,5 @@
 <?php
 
-if (!class_exists('CssSelectorFeedExpanderBridgeInternal')) {
-    // Utility class used internally by CssSelectorFeedExpanderBridge
-    class CssSelectorFeedExpanderBridgeInternal extends FeedExpander
-    {
-        public function collectData()
-        {
-            // Unused. Call collectExpandableDatas($url) inherited from FeedExpander instead
-        }
-    }
-}
-
 class CssSelectorFeedExpanderBridge extends CssSelectorBridge
 {
     const MAINTAINER = 'ORelio';
@@ -61,16 +50,29 @@ class CssSelectorFeedExpanderBridge extends CssSelectorBridge
         $discard_thumbnail = $this->getInput('discard_thumbnail');
         $limit = $this->getInput('limit');
 
-        //$xmlString = getContents($url);
-        //$feed = (new FeedParser())->parseFeed($xmlString);
-        //$items = $feed['items'];
+        $source_feed = (new FeedParser())->parseFeed(getContents($url));
+        $items = $source_feed['items'];
 
-        $feed_expander = new CssSelectorFeedExpanderBridgeInternal();
-        $items = $feed_expander->collectExpandableDatas($url)->getItems();
+        // Map Homepage URL (Default: Root page)
+        if (isset($source_feed['uri'])) {
+            $this->homepageUrl = $source_feed['uri'];
+        } else {
+            $this->homepageUrl = urljoin($url, '/');
+        }
 
-        $this->homepageUrl = urljoin($url, '/');
-        $this->feedName = $feed_expander->getName();
+        // Map Feed Name (Default: Domain name)
+        if (isset($source_feed['title'])) {
+            $this->feedName = $source_feed['title'];
+        } else {
+            $this->feedName = explode('/', urljoin($url, '/'))[2];
+        }
 
+        // Apply item limit (Default: Global limit)
+        if ($limit > 0) {
+            $items = array_slice($items, 0, $limit);
+        }
+
+        // Expand feed items (CssSelectorBridge)
         foreach ($items as $item_from_feed) {
             $item_expanded = $this->expandEntryWithSelector(
                 $item_from_feed['uri'],
@@ -86,7 +88,7 @@ class CssSelectorFeedExpanderBridge extends CssSelectorBridge
             } else {
                 // Take expanded item, but give priority to metadata already in source item
                 foreach ($item_from_feed as $field => $val) {
-                    if ($field !== 'content') {
+                    if ($field !== 'content' && !empty($val)) {
                         $item_expanded[$field] = $val;
                     }
                 }

From 5f37c72be0a994257b01a8c43c4e488611f092f2 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 13 Oct 2023 20:48:08 +0200
Subject: [PATCH 172/716] fix(binance): plus some other tweaks (#3753)

---
 bridges/BinanceBridge.php            | 59 +++++++++-------------------
 bridges/CssSelectorComplexBridge.php |  4 +-
 bridges/FallGuysBridge.php           |  2 +-
 bridges/InstagramBridge.php          | 11 ++++--
 bridges/MastodonBridge.php           |  2 +-
 bridges/PokemonTVBridge.php          |  9 ++++-
 lib/FeedExpander.php                 |  1 +
 lib/FeedItem.php                     | 10 +++--
 lib/logger.php                       |  1 +
 9 files changed, 46 insertions(+), 53 deletions(-)

diff --git a/bridges/BinanceBridge.php b/bridges/BinanceBridge.php
index 03449fb1..5aec0604 100644
--- a/bridges/BinanceBridge.php
+++ b/bridges/BinanceBridge.php
@@ -8,48 +8,27 @@ class BinanceBridge extends BridgeAbstract
     const MAINTAINER = 'thefranke';
     const CACHE_TIMEOUT = 3600; // 1h
 
+    public function collectData()
+    {
+        $url = 'https://www.binance.com/bapi/composite/v1/public/content/blog/list?category=&tag=&page=1&size=12';
+        $json = getContents($url);
+        $data = Json::decode($json, false);
+        foreach ($data->data->blogList as $post) {
+            $item = [];
+            $item['title'] = $post->title;
+            // Url slug not in json
+            //$item['uri'] = $uri;
+            $item['timestamp'] = $post->postTimeUTC / 1000;
+            $item['author'] = 'Binance';
+            $item['content'] = $post->brief;
+            //$item['categories'] = $category;
+            $item['uid'] = $post->idStr;
+            $this->items[] = $item;
+        }
+    }
+
     public function getIcon()
     {
         return 'https://bin.bnbstatic.com/static/images/common/favicon.ico';
     }
-
-    public function collectData()
-    {
-        $html = getSimpleHTMLDOM(self::URI)
-            or returnServerError('Could not fetch Binance blog data.');
-
-        $appData = $html->find('script[id="__APP_DATA"]');
-        $appDataJson = json_decode($appData[0]->innertext);
-        $allposts = $appDataJson->routeProps->f3ac->blogListRes->list;
-
-        foreach ($allposts as $element) {
-            $date = $element->releasedTime;
-            $title = $element->title;
-            $category = $element->category->name;
-
-            $suburl = strtolower($category);
-            $suburl = str_replace(' ', '_', $suburl);
-
-            $uri = self::URI . '/' . $suburl . '/' . $element->idStr;
-
-            $contentHTML = getSimpleHTMLDOMCached($uri);
-            $contentAppData = $contentHTML->find('script[id="__APP_DATA"]');
-            $contentAppDataJson = json_decode($contentAppData[0]->innertext);
-            $content = $contentAppDataJson->routeProps->a106->blogDetail->content;
-
-            $item = [];
-            $item['title'] = $title;
-            $item['uri'] = $uri;
-            $item['timestamp'] = substr($date, 0, -3);
-            $item['author'] = 'Binance';
-            $item['content'] = $content;
-            $item['categories'] = $category;
-
-            $this->items[] = $item;
-
-            if (count($this->items) >= 10) {
-                break;
-            }
-        }
-    }
 }
diff --git a/bridges/CssSelectorComplexBridge.php b/bridges/CssSelectorComplexBridge.php
index c09db74a..e661fe18 100644
--- a/bridges/CssSelectorComplexBridge.php
+++ b/bridges/CssSelectorComplexBridge.php
@@ -224,7 +224,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
     {
         if (!empty($url_pattern)) {
             $url_pattern = '/' . str_replace('/', '\/', $url_pattern) . '/';
-            $links = array_filter($links, function ($url) {
+            $links = array_filter($links, function ($url) use ($url_pattern) {
                 return preg_match($url_pattern, $url) === 1;
             });
         }
@@ -359,7 +359,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
         $article_content = $entry_html->find($content_selector, 0);
 
         if (is_null($article_content)) {
-            returnClientError('Could not article content at URL: ' . $entry_url);
+            returnClientError('Could not get article content at URL: ' . $entry_url);
         }
 
         $article_content = defaultLinkTo($article_content, $entry_url);
diff --git a/bridges/FallGuysBridge.php b/bridges/FallGuysBridge.php
index dbb34792..1e527484 100644
--- a/bridges/FallGuysBridge.php
+++ b/bridges/FallGuysBridge.php
@@ -85,7 +85,7 @@ class FallGuysBridge extends BridgeAbstract
                         for ($i = 0; $i < count($mediaOptions); $i++) {
                             if (property_exists($mediaOptions[$i], 'youtubeVideo')) {
                                 $videoUrl = 'https://youtu.be/' . $mediaOptions[$i]->youtubeVideo->contentId;
-                                $image = $mainContentOptions[$i]->image->src;
+                                $image = $mainContentOptions[$i]->image->src ?? '';
 
                                 $content .= '<p>';
 
diff --git a/bridges/InstagramBridge.php b/bridges/InstagramBridge.php
index 1714a691..633d6080 100644
--- a/bridges/InstagramBridge.php
+++ b/bridges/InstagramBridge.php
@@ -121,6 +121,9 @@ class InstagramBridge extends BridgeAbstract
         $directLink = !is_null($this->getInput('direct_links')) && $this->getInput('direct_links');
 
         $data = $this->getInstagramJSON($this->getURI());
+        if (!$data) {
+            return;
+        }
 
         if (!is_null($this->getInput('u'))) {
             $userMedia = $data->data->user->edge_owner_to_timeline_media->edges;
@@ -286,9 +289,11 @@ class InstagramBridge extends BridgeAbstract
             $html = getContents($uri);
             $scriptRegex = '/window\._sharedData = (.*);<\/script>/';
 
-            preg_match($scriptRegex, $html, $matches, PREG_OFFSET_CAPTURE, 0);
-
-            return json_decode($matches[1][0]);
+            $ret = preg_match($scriptRegex, $html, $matches, PREG_OFFSET_CAPTURE);
+            if ($ret) {
+                return json_decode($matches[1][0]);
+            }
+            return null;
         }
     }
 
diff --git a/bridges/MastodonBridge.php b/bridges/MastodonBridge.php
index 01d425b4..e673bf14 100644
--- a/bridges/MastodonBridge.php
+++ b/bridges/MastodonBridge.php
@@ -193,7 +193,7 @@ class MastodonBridge extends BridgeAbstract
                 && preg_match('/^http(s|):\/\//', $attachment['url'], $match)
             ) {
                 $item['content'] = $item['content'] . '<br /><img ';
-                if ($attachment['name']) {
+                if (isset($attachment['name'])) {
                     $item['content'] .= sprintf('alt="%s" ', $attachment['name']);
                 }
                 $item['content'] .= sprintf('src="%s" />', $attachment['url']);
diff --git a/bridges/PokemonTVBridge.php b/bridges/PokemonTVBridge.php
index 2c6b8bdc..a4c0a4be 100644
--- a/bridges/PokemonTVBridge.php
+++ b/bridges/PokemonTVBridge.php
@@ -64,15 +64,20 @@ class PokemonTVBridge extends BridgeAbstract
                         continue;
                     }
                 }
-                switch ($element->{'media_type'}) {
+                switch ($element->media_type) {
                     case 'movie':
-                        $itemtitle = $element->{'channel_name'};
+                    case 'junior':
+                    case 'original':
+                    case 'non-animation':
+                        $itemtitle = $element->channel_name;
                         break;
                     case 'episode':
                         $season = str_pad($mediaelement->{'season'}, 2, '0', STR_PAD_LEFT);
                         $episode = str_pad($mediaelement->{'episode'}, 2, '0', STR_PAD_LEFT);
                         $itemtitle = $element->{'channel_name'} . ' - S' . $season . 'E' . $episode;
                         break;
+                    default:
+                        $itemtitle = '';
                 }
                 $streamurl = 'https://watch.pokemon.com/' . $this->getCountryCode() . '/#/player?id=' . $mediaelement->{'id'};
                 $item = [];
diff --git a/lib/FeedExpander.php b/lib/FeedExpander.php
index 361df4d9..056578e9 100644
--- a/lib/FeedExpander.php
+++ b/lib/FeedExpander.php
@@ -24,6 +24,7 @@ abstract class FeedExpander extends BridgeAbstract
         }
         // prepare/massage the xml to make it more acceptable
         $badStrings = [
+            '&nbsp;',
             '&raquo;',
         ];
         $xmlString = str_replace($badStrings, '', $xmlString);
diff --git a/lib/FeedItem.php b/lib/FeedItem.php
index 0bc22ee2..bd37f119 100644
--- a/lib/FeedItem.php
+++ b/lib/FeedItem.php
@@ -260,13 +260,15 @@ class FeedItem
         return $this->uid;
     }
 
-    public function setUid($uid)
+    public function setUid($uid): void
     {
         $this->uid = null;
         if (!is_string($uid)) {
-            Debug::log('Unique id must be a string!');
-        } elseif (preg_match('/^[a-f0-9]{40}$/', $uid)) {
-            // keep id if it already is SHA-1 hash
+            Debug::log(sprintf('uid must be string: %s (%s)', (string) $uid, var_export($uid, true)));
+            return;
+        }
+        if (preg_match('/^[a-f0-9]{40}$/', $uid)) {
+            // Preserve sha1 hash
             $this->uid = $uid;
         } else {
             $this->uid = sha1($uid);
diff --git a/lib/logger.php b/lib/logger.php
index e41de34b..7a902b5b 100644
--- a/lib/logger.php
+++ b/lib/logger.php
@@ -149,6 +149,7 @@ final class StreamHandler
         );
         error_log($text);
         if ($record['level'] < Logger::ERROR && Debug::isEnabled()) {
+            // Not a good idea to print here because http headers might not have been sent
             print sprintf("<pre>%s</pre>\n", e($text));
         }
         //$bytes = file_put_contents('/tmp/rss-bridge.log', $text, FILE_APPEND | LOCK_EX);

From daef240cd2fac0473113da456e11172d7d24c7a4 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 13 Oct 2023 23:14:08 +0200
Subject: [PATCH 173/716] test: add test for FeedParser (#3754)

---
 bridges/ArsTechnicaBridge.php |   2 +-
 bridges/UrlebirdBridge.php    |  62 ++++++++++------
 lib/FeedParser.php            |   7 +-
 tests/FeedParserTest.php      | 128 ++++++++++++++++++++++++++++++++++
 4 files changed, 174 insertions(+), 25 deletions(-)
 create mode 100644 tests/FeedParserTest.php

diff --git a/bridges/ArsTechnicaBridge.php b/bridges/ArsTechnicaBridge.php
index d15cfb4f..5b3283b5 100644
--- a/bridges/ArsTechnicaBridge.php
+++ b/bridges/ArsTechnicaBridge.php
@@ -30,7 +30,7 @@ class ArsTechnicaBridge extends FeedExpander
     public function collectData()
     {
         $url = 'https://feeds.arstechnica.com/arstechnica/' . $this->getInput('section');
-        $this->collectExpandableDatas($url);
+        $this->collectExpandableDatas($url, 10);
     }
 
     protected function parseItem(array $item)
diff --git a/bridges/UrlebirdBridge.php b/bridges/UrlebirdBridge.php
index 429e93f5..38f73249 100644
--- a/bridges/UrlebirdBridge.php
+++ b/bridges/UrlebirdBridge.php
@@ -6,7 +6,7 @@ class UrlebirdBridge extends BridgeAbstract
     const NAME = 'urlebird.com';
     const URI = 'https://urlebird.com/';
     const DESCRIPTION = 'Bridge for urlebird.com';
-    const CACHE_TIMEOUT = 10;
+    const CACHE_TIMEOUT = 60 * 5;
     const PARAMETERS = [
         [
             'query' => [
@@ -21,50 +21,70 @@ class UrlebirdBridge extends BridgeAbstract
 
     private $title;
 
-    private function fixURI($uri)
-    {
-        $path = parse_url($uri, PHP_URL_PATH);
-        $encoded_path = array_map('urlencode', explode('/', $path));
-        return str_replace($path, implode('/', $encoded_path), $uri);
-    }
-
     public function collectData()
     {
         switch ($this->getInput('query')[0]) {
-            default:
-                returnServerError('Please, enter valid username or hashtag!');
-                break;
             case '@':
                 $url = 'https://urlebird.com/user/' . substr($this->getInput('query'), 1) . '/';
                 break;
             case '#':
                 $url = 'https://urlebird.com/hash/' . substr($this->getInput('query'), 1) . '/';
                 break;
+            default:
+                returnServerError('Please, enter valid username or hashtag!');
+                break;
         }
 
         $html = getSimpleHTMLDOM($url);
+        $limit = 10;
+
         $this->title = $html->find('title', 0)->innertext;
         $articles = $html->find('div.thumb');
+        $articles = array_slice($articles, 0, $limit);
         foreach ($articles as $article) {
             $item = [];
-            $item['uri'] = $this->fixURI($article->find('a', 2)->href);
-            $article_content = getSimpleHTMLDOM($item['uri']);
-            $item['author'] = $article->find('img', 0)->alt . ' (' .
-                $article_content->find('a.user-video', 1)->innertext . ')';
-            $item['title'] = $article_content->find('title', 0)->innertext;
-            $item['enclosures'][] = $article_content->find('video', 0)->poster;
-            $video = $article_content->find('video', 0);
+            $itemUrl = $article->find('a', 2)->href;
+            $item['uri'] = $this->encodePathSegments($itemUrl);
+
+            $dom = getSimpleHTMLDOM($item['uri']);
+            $videoDiv = $dom->find('div.video', 0);
+
+            // timestamp
+            $timestampH6 = $videoDiv->find('h6', 0);
+            $datetimeString = str_replace('Posted ', '', $timestampH6->plaintext);
+            $item['timestamp'] = $datetimeString;
+
+            $innertext = $dom->find('a.user-video', 1)->innertext;
+            $alt = $article->find('img', 0)->alt;
+            $item['author'] = $alt . ' (' . $innertext . ')';
+
+            $item['title'] = $dom->find('title', 0)->innertext;
+            $item['enclosures'][] = $dom->find('video', 0)->poster;
+
+            $video = $dom->find('video', 0);
             $video->autoplay = null;
+
             $item['content'] = $video->outertext . '<br>' .
-                $article_content->find('div.music', 0) . '<br>' .
-                $article_content->find('div.info2', 0)->innertext .
-                '<br><br><a href="' . $article_content->find('video', 0)->src .
+                $dom->find('div.music', 0) . '<br>' .
+                $dom->find('div.info2', 0)->innertext .
+                '<br><br><a href="' . $dom->find('video', 0)->src .
                 '">Direct video link</a><br><br><a href="' . $item['uri'] .
                 '">Post link</a><br><br>';
+
             $this->items[] = $item;
         }
     }
 
+    private function encodePathSegments($url)
+    {
+        $path = parse_url($url, PHP_URL_PATH);
+        $pathSegments = explode('/', $path);
+        $encodedPathSegments = array_map('urlencode', $pathSegments);
+        $encodedPath = implode('/', $encodedPathSegments);
+        $result = str_replace($path, $encodedPath, $url);
+        return $result;
+    }
+
     public function getName()
     {
         return $this->title ?: parent::getName();
diff --git a/lib/FeedParser.php b/lib/FeedParser.php
index 64a3587d..1393f5f5 100644
--- a/lib/FeedParser.php
+++ b/lib/FeedParser.php
@@ -142,6 +142,7 @@ final class FeedParser
         }
 
         if (isset($feedItem->guid)) {
+            // Pluck out a url from guid
             foreach ($feedItem->guid->attributes() as $attribute => $value) {
                 if (
                     $attribute === 'isPermaLink'
@@ -207,9 +208,9 @@ final class FeedParser
             'content'       => null,
             'timestamp'     => null,
             'author'        => null,
-            'uid'           => null,
-            'categories'    => [],
-            'enclosures'    => [],
+            //'uid'           => null,
+            //'categories'    => [],
+            //'enclosures'    => [],
         ];
         if (isset($feedItem->link)) {
             // todo: trim uri
diff --git a/tests/FeedParserTest.php b/tests/FeedParserTest.php
new file mode 100644
index 00000000..acd93e52
--- /dev/null
+++ b/tests/FeedParserTest.php
@@ -0,0 +1,128 @@
+<?php
+
+declare(strict_types=1);
+
+namespace RssBridge\Tests;
+
+use PHPUnit\Framework\TestCase;
+
+class FeedParserTest extends TestCase
+{
+    public function testRss1()
+    {
+        $xml = <<<XML
+        <?xml version="1.0" encoding="utf-8"?> 
+        <rdf:RDF 
+          xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" 
+          xmlns:cc="http://creativecommons.org/ns#"
+          xmlns="http://purl.org/rss/1.0/"
+        > 
+        <channel rdf:about="http://meerkat.oreillynet.com/?_fl=rss1.0">
+            <title>hello feed</title>
+            <link>http://meerkat.oreillynet.com</link>
+            <description>Meerkat: An Open Wire Service</description>
+            
+            <items>
+                <rdf:Seq>
+                    <rdf:li resource="http://c.moreover.com/click/here.pl?r123" />
+                </rdf:Seq>
+            </items>
+        </channel>
+
+        <item rdf:about="http://c.moreover.com/click/here.pl?r123">
+            <title>XML: A Disruptive Technology</title> 
+            <link>http://c.moreover.com/click/here.pl?r123</link>
+            <description>desc</description>
+        </item> 
+        </rdf:RDF>
+        XML;
+
+        $sut = new \FeedParser();
+        $feed = $sut->parseFeed($xml);
+
+        $this->assertSame('hello feed', $feed['title']);
+        $this->assertSame('http://meerkat.oreillynet.com', $feed['uri']);
+        $this->assertSame(null, $feed['icon']);
+
+        $item = $feed['items'][0];
+        $this->assertSame('XML: A Disruptive Technology', $item['title']);
+        $this->assertSame('http://c.moreover.com/click/here.pl?r123', $item['uri']);
+        $this->assertSame('desc', $item['content']);
+    }
+
+    public function testRss2()
+    {
+        $xml = <<<XML
+        <?xml version="1.0"?>
+        <rss version="2.0">
+            <channel>
+                <title>hello feed</title>
+                <link>https://example.com/</link>
+                <image>
+                    <url>https://example.com/2.ico</url>
+                </image>
+
+                <item>
+                    <title>hello world</title>
+                    <link>https://example.com/1</link>
+                    <description>desc2</description>
+                    <pubDate>Tue, 26 Apr 2022 00:00:00 +0200</pubDate>
+                    <author>root</author>
+                    <enclosure url="https://example.com/1.png"></enclosure>
+                </item>
+            </channel>
+        </rss>
+        XML;
+
+        $sut = new \FeedParser();
+        $feed = $sut->parseFeed($xml);
+
+        $this->assertSame('hello feed', $feed['title']);
+        $this->assertSame('https://example.com/', $feed['uri']);
+        $this->assertSame('https://example.com/2.ico', $feed['icon']);
+
+        $item = $feed['items'][0];
+        $this->assertSame('hello world', $item['title']);
+        $this->assertSame('https://example.com/1', $item['uri']);
+        $this->assertSame(1650924000, $item['timestamp']);
+        $this->assertSame('root', $item['author']);
+        $this->assertSame('desc2', $item['content']);
+        $this->assertSame(['https://example.com/1.png'], $item['enclosures']);
+    }
+
+    public function testAtom()
+    {
+        $xml = <<<XML
+        <?xml version="1.0" encoding="UTF-8"?>
+        <feed xmlns="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/">
+            <title>hello feed</title>
+            <link href="https://example.com/1"></link>
+            <icon>https://example.com/2.ico</icon>
+
+            <entry>
+                <title>hello world</title>
+                <link href="https://example.com/1"></link>
+                <author>
+                    <name>root</name>
+                </author>
+                <content type="html">html</content>
+                <updated>2015-11-05T14:38:49+01:00</updated>
+            </entry>
+        </feed>
+        XML;
+
+        $sut = new \FeedParser();
+        $feed = $sut->parseFeed($xml);
+
+        $this->assertSame('hello feed', $feed['title']);
+        $this->assertSame('https://example.com/1', $feed['uri']);
+        $this->assertSame('https://example.com/2.ico', $feed['icon']);
+
+        $item = $feed['items'][0];
+        $this->assertSame('hello world', $item['title']);
+        $this->assertSame('https://example.com/1', $item['uri']);
+        $this->assertSame(1446730729, $item['timestamp']);
+        $this->assertSame('root', $item['author']);
+        $this->assertSame('html', $item['content']);
+    }
+}

From cf9558648efc86dce7a10136c53bd93688198755 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 15 Oct 2023 00:08:18 +0200
Subject: [PATCH 174/716] refactor: YoutubeBridge (#3755)

---
 bridges/YoutubeBridge.php | 378 ++++++++++++++++++--------------------
 caches/FileCache.php      |   6 +-
 2 files changed, 180 insertions(+), 204 deletions(-)

diff --git a/bridges/YoutubeBridge.php b/bridges/YoutubeBridge.php
index 418e715e..40a8f6a9 100644
--- a/bridges/YoutubeBridge.php
+++ b/bridges/YoutubeBridge.php
@@ -11,7 +11,7 @@ class YoutubeBridge extends BridgeAbstract
 {
     const NAME = 'YouTube Bridge';
     const URI = 'https://www.youtube.com';
-    const CACHE_TIMEOUT = 10800; // 3h
+    const CACHE_TIMEOUT = 60 * 60 * 3;
     const DESCRIPTION = 'Returns the 10 newest videos by username/channel/playlist or search';
 
     const PARAMETERS = [
@@ -78,116 +78,6 @@ class YoutubeBridge extends BridgeAbstract
     // This took from repo BetterVideoRss of VerifiedJoseph.
     const URI_REGEX = '/(https?:\/\/(?:www\.)?(?:[a-zA-Z0-9-.]{2,256}\.[a-z]{2,20})(\:[0-9]{2    ,4})?(?:\/[a-zA-Z0-9@:%_\+.,~#"\'!?&\/\/=\-*]+|\/)?)/ims'; //phpcs:ignore
 
-    private function collectDataInternal()
-    {
-        $xml = '';
-        $html = '';
-        $url_feed = '';
-        $url_listing = '';
-
-        if ($this->getInput('u')) {
-            /* User and Channel modes */
-            $request = $this->getInput('u');
-            $url_feed = self::URI . '/feeds/videos.xml?user=' . urlencode($request);
-            $url_listing = self::URI . '/user/' . urlencode($request) . '/videos';
-        } elseif ($this->getInput('c')) {
-            $request = $this->getInput('c');
-            $url_feed = self::URI . '/feeds/videos.xml?channel_id=' . urlencode($request);
-            $url_listing = self::URI . '/channel/' . urlencode($request) . '/videos';
-        } elseif ($this->getInput('custom')) {
-            $request = $this->getInput('custom');
-            $url_listing = self::URI . '/' . urlencode($request) . '/videos';
-        }
-
-        if (!empty($url_feed) || !empty($url_listing)) {
-            $this->feeduri = $url_listing;
-            if (!empty($this->getInput('custom'))) {
-                $html = $this->ytGetSimpleHTMLDOM($url_listing);
-                $jsonData = $this->getJSONData($html);
-                $url_feed = $jsonData->metadata->channelMetadataRenderer->rssUrl;
-                $this->feedIconUrl = $jsonData->metadata->channelMetadataRenderer->avatar->thumbnails[0]->url;
-            }
-            if (!$this->skipFeeds()) {
-                $html = $this->ytGetSimpleHTMLDOM($url_feed);
-                $this->ytBridgeParseXmlFeed($html);
-            } else {
-                if (empty($this->getInput('custom'))) {
-                    $html = $this->ytGetSimpleHTMLDOM($url_listing);
-                    $jsonData = $this->getJSONData($html);
-                }
-                $channel_id = '';
-                if (isset($jsonData->contents)) {
-                    $channel_id = $jsonData->metadata->channelMetadataRenderer->externalId;
-                    $jsonData = $jsonData->contents->twoColumnBrowseResultsRenderer->tabs[1];
-                    $jsonData = $jsonData->tabRenderer->content->richGridRenderer->contents;
-                    // $jsonData = $jsonData->itemSectionRenderer->contents[0]->gridRenderer->items;
-                    $this->parseJSONListing($jsonData);
-                } else {
-                    returnServerError('Unable to get data from YouTube. Username/Channel: ' . $request);
-                }
-            }
-            $this->feedName = str_replace(' - YouTube', '', $html->find('title', 0)->plaintext);
-        } elseif ($this->getInput('p')) {
-            /* playlist mode */
-            // TODO: this mode makes a lot of excess video query requests.
-            // To make less requests, we need to cache following dictionary "videoId -> datePublished, duration"
-            // This cache will be used to find out, which videos to fetch
-            // to make feed of 15 items or more, if there a lot of videos published on that date.
-            $request = $this->getInput('p');
-            $url_feed = self::URI . '/feeds/videos.xml?playlist_id=' . urlencode($request);
-            $url_listing = self::URI . '/playlist?list=' . urlencode($request);
-            $html = $this->ytGetSimpleHTMLDOM($url_listing);
-            $jsonData = $this->getJSONData($html);
-            // TODO: this method returns only first 100 video items
-            // if it has more videos, playlistVideoListRenderer will have continuationItemRenderer as last element
-            $jsonData = $jsonData->contents->twoColumnBrowseResultsRenderer->tabs[0];
-            $jsonData = $jsonData->tabRenderer->content->sectionListRenderer->contents[0]->itemSectionRenderer;
-            $jsonData = $jsonData->contents[0]->playlistVideoListRenderer->contents;
-            $item_count = count($jsonData);
-
-            if ($item_count <= 15 && !$this->skipFeeds() && ($xml = $this->ytGetSimpleHTMLDOM($url_feed))) {
-                $this->ytBridgeParseXmlFeed($xml);
-            } else {
-                $this->parseJSONListing($jsonData);
-            }
-            $this->feedName = 'Playlist: ' . str_replace(' - YouTube', '', $html->find('title', 0)->plaintext);
-            usort($this->items, function ($item1, $item2) {
-                if (!is_int($item1['timestamp']) && !is_int($item2['timestamp'])) {
-                    $item1['timestamp'] = strtotime($item1['timestamp']);
-                    $item2['timestamp'] = strtotime($item2['timestamp']);
-                }
-                return $item2['timestamp'] - $item1['timestamp'];
-            });
-        } elseif ($this->getInput('s')) {
-            /* search mode */
-            $request = $this->getInput('s');
-            $url_listing = self::URI
-                . '/results?search_query='
-                . urlencode($request)
-                . '&sp=CAI%253D';
-
-            $html = $this->ytGetSimpleHTMLDOM($url_listing);
-
-            $jsonData = $this->getJSONData($html);
-            $jsonData = $jsonData->contents->twoColumnSearchResultsRenderer->primaryContents;
-            $jsonData = $jsonData->sectionListRenderer->contents;
-            foreach ($jsonData as $data) {
-                // Search result includes some ads, have to filter them
-                if (isset($data->itemSectionRenderer->contents[0]->videoRenderer)) {
-                    $jsonData = $data->itemSectionRenderer->contents;
-                    break;
-                }
-            }
-            $this->parseJSONListing($jsonData);
-            $this->feeduri = $url_listing;
-            $this->feedName = 'Search: ' . $request;
-        } else {
-            /* no valid mode */
-            returnClientError("You must either specify either:\n - YouTube
- username (?u=...)\n - Channel id (?c=...)\n - Playlist id (?p=...)\n - Search (?s=...)");
-        }
-    }
-
     public function collectData()
     {
         $cacheKey = 'youtube_rate_limit';
@@ -204,9 +94,133 @@ class YoutubeBridge extends BridgeAbstract
         }
     }
 
-    private function ytBridgeQueryVideoInfo($vid, &$author, &$desc, &$time)
+    private function collectDataInternal()
     {
-        $html = $this->ytGetSimpleHTMLDOM(self::URI . "/watch?v=$vid", true);
+        $xml = '';
+        $html = '';
+        $url_feed = '';
+        $url_listing = '';
+
+        $username = $this->getInput('u');
+        $channel = $this->getInput('c');
+        $custom = $this->getInput('custom');
+
+        if ($username) {
+            // user and channel
+            $request = $username;
+            $url_feed = self::URI . '/feeds/videos.xml?user=' . urlencode($request);
+            $url_listing = self::URI . '/user/' . urlencode($request) . '/videos';
+        } elseif ($channel) {
+            $request = $channel;
+            $url_feed = self::URI . '/feeds/videos.xml?channel_id=' . urlencode($request);
+            $url_listing = self::URI . '/channel/' . urlencode($request) . '/videos';
+        } elseif ($custom) {
+            $request = $custom;
+            $url_listing = self::URI . '/' . urlencode($request) . '/videos';
+        }
+
+        $playlist = $this->getInput('p');
+        $search = $this->getInput('s');
+
+        $durationMin = $this->getInput('duration_min');
+        $durationMax = $this->getInput('duration_max');
+
+        // Whether to discriminate videos by duration
+        $filterByDuration = $durationMin || $durationMax;
+
+        if ($url_feed || $url_listing) {
+            // user, channel or custom
+            $this->feeduri = $url_listing;
+            if ($custom) {
+                // Extract the feed url for the custom name
+                $html = $this->fetch($url_listing);
+                $jsonData = $this->extractJsonFromHtml($html);
+                // Pluck out the rss feed url
+                $url_feed = $jsonData->metadata->channelMetadataRenderer->rssUrl;
+                $this->feedIconUrl = $jsonData->metadata->channelMetadataRenderer->avatar->thumbnails[0]->url;
+            }
+            if ($filterByDuration) {
+                if (!$custom) {
+                    // Fetch the html page
+                    $html = $this->fetch($url_listing);
+                    $jsonData = $this->extractJsonFromHtml($html);
+                }
+                $channel_id = '';
+                if (isset($jsonData->contents)) {
+                    $channel_id = $jsonData->metadata->channelMetadataRenderer->externalId;
+                    $jsonData = $jsonData->contents->twoColumnBrowseResultsRenderer->tabs[1];
+                    $jsonData = $jsonData->tabRenderer->content->richGridRenderer->contents;
+                    // $jsonData = $jsonData->itemSectionRenderer->contents[0]->gridRenderer->items;
+                    $this->fetchItemsFromFromJsonData($jsonData);
+                } else {
+                    returnServerError('Unable to get data from YouTube. Username/Channel: ' . $request);
+                }
+            } else {
+                // Fetch the xml feed
+                $html = $this->fetch($url_feed);
+                $this->extractItemsFromXmlFeed($html);
+            }
+            $this->feedName = str_replace(' - YouTube', '', $html->find('title', 0)->plaintext);
+        } elseif ($playlist) {
+            // playlist
+            // TODO: this mode makes a lot of excess video query requests.
+            // To make less requests, we need to cache following dictionary "videoId -> datePublished, duration"
+            // This cache will be used to find out, which videos to fetch
+            // to make feed of 15 items or more, if there a lot of videos published on that date.
+            $request = $playlist;
+            $url_feed = self::URI . '/feeds/videos.xml?playlist_id=' . urlencode($request);
+            $url_listing = self::URI . '/playlist?list=' . urlencode($request);
+            $html = $this->fetch($url_listing);
+            $jsonData = $this->extractJsonFromHtml($html);
+            // TODO: this method returns only first 100 video items
+            // if it has more videos, playlistVideoListRenderer will have continuationItemRenderer as last element
+            $jsonData = $jsonData->contents->twoColumnBrowseResultsRenderer->tabs[0];
+            $jsonData = $jsonData->tabRenderer->content->sectionListRenderer->contents[0]->itemSectionRenderer;
+            $jsonData = $jsonData->contents[0]->playlistVideoListRenderer->contents;
+            $item_count = count($jsonData);
+
+            if ($item_count > 15 || $filterByDuration) {
+                $this->fetchItemsFromFromJsonData($jsonData);
+            } else {
+                $xml = $this->fetch($url_feed);
+                $this->extractItemsFromXmlFeed($xml);
+            }
+            $this->feedName = 'Playlist: ' . str_replace(' - YouTube', '', $html->find('title', 0)->plaintext);
+            usort($this->items, function ($item1, $item2) {
+                if (!is_int($item1['timestamp']) && !is_int($item2['timestamp'])) {
+                    $item1['timestamp'] = strtotime($item1['timestamp']);
+                    $item2['timestamp'] = strtotime($item2['timestamp']);
+                }
+                return $item2['timestamp'] - $item1['timestamp'];
+            });
+        } elseif ($search) {
+            // search
+            $request = $search;
+            $url_listing = self::URI . '/results?search_query=' . urlencode($request) . '&sp=CAI%253D';
+            $html = $this->fetch($url_listing);
+            $jsonData = $this->extractJsonFromHtml($html);
+            $jsonData = $jsonData->contents->twoColumnSearchResultsRenderer->primaryContents;
+            $jsonData = $jsonData->sectionListRenderer->contents;
+            foreach ($jsonData as $data) {
+                // Search result includes some ads, have to filter them
+                if (isset($data->itemSectionRenderer->contents[0]->videoRenderer)) {
+                    $jsonData = $data->itemSectionRenderer->contents;
+                    break;
+                }
+            }
+            $this->fetchItemsFromFromJsonData($jsonData);
+            $this->feeduri = $url_listing;
+            $this->feedName = 'Search: ' . $request;
+        } else {
+            returnClientError("You must either specify either:\n - YouTube
+ username (?u=...)\n - Channel id (?c=...)\n - Playlist id (?p=...)\n - Search (?s=...)");
+        }
+    }
+
+    private function fetchVideoDetails($vid, &$author, &$desc, &$time)
+    {
+        $url = self::URI . "/watch?v=$vid";
+        $html = $this->fetch($url, true);
 
         // Skip unavailable videos
         if (strpos($html->innertext, 'IS_UNAVAILABLE_PAGE') !== false) {
@@ -223,7 +237,7 @@ class YoutubeBridge extends BridgeAbstract
             $time = strtotime($elDatePublished->getAttribute('content'));
         }
 
-        $jsonData = $this->getJSONData($html);
+        $jsonData = $this->extractJsonFromHtml($html);
         if (!isset($jsonData->contents)) {
             return;
         }
@@ -370,7 +384,7 @@ class YoutubeBridge extends BridgeAbstract
             if ($commandUrl['path'] === '/redirect') {
                 parse_str($commandUrl['query'], $commandUrlQuery);
                 $enhancement['url'] = urldecode($commandUrlQuery['q']);
-            } else if (isset($commandUrl['host'])) {
+            } elseif (isset($commandUrl['host'])) {
                 $enhancement['url'] = $commandMetadata->url;
             } else {
                 $enhancement['url'] = $baseUrl . $commandMetadata->url;
@@ -388,94 +402,37 @@ class YoutubeBridge extends BridgeAbstract
         return array_reverse($enhancements);
     }
 
-    private function ytBridgeAddItem($vid, $title, $author, $desc, $time, $thumbnail = '')
+    private function extractItemsFromXmlFeed($xml)
     {
-        $item = [];
-        $item['id'] = $vid;
-        $item['title'] = $title;
-        $item['author'] = $author;
-        $item['timestamp'] = $time;
-        $item['uri'] = self::URI . '/watch?v=' . $vid;
-        if (!$thumbnail) {
-            // Fallback to default thumbnail if there aren't any provided.
-            $thumbnail = '0';
-        }
-        $thumbnailUri = str_replace('/www.', '/img.', self::URI) . '/vi/' . $vid . '/' . $thumbnail . '.jpg';
-        $item['content'] = '<a href="' . $item['uri'] . '"><img src="' . $thumbnailUri . '" /></a><br />' . $desc;
-        $this->items[] = $item;
-    }
+        $this->feedName = $this->decodeTitle($xml->find('feed > title', 0)->plaintext);
 
-    private function ytBridgeParseXmlFeed($xml)
-    {
         foreach ($xml->find('entry') as $element) {
-            $title = $this->ytBridgeFixTitle($element->find('title', 0)->plaintext);
+            $videoId = str_replace('yt:video:', '', $element->find('id', 0)->plaintext);
+            if (strpos($videoId, 'googleads') !== false) {
+                continue;
+            }
+            $title = $this->decodeTitle($element->find('title', 0)->plaintext);
             $author = $element->find('name', 0)->plaintext;
             $desc = $element->find('media:description', 0)->innertext;
-
-            // Make sure the description is easy on the eye :)
             $desc = htmlspecialchars($desc);
             $desc = nl2br($desc);
-            $desc = preg_replace(
-                self::URI_REGEX,
-                '<a href="$1" target="_blank">$1</a> ',
-                $desc
-            );
-
-            $vid = str_replace('yt:video:', '', $element->find('id', 0)->plaintext);
+            $desc = preg_replace(self::URI_REGEX, '<a href="$1" target="_blank">$1</a> ', $desc);
             $time = strtotime($element->find('published', 0)->plaintext);
-            if (strpos($vid, 'googleads') === false) {
-                $this->ytBridgeAddItem($vid, $title, $author, $desc, $time);
-            }
+            $this->addItem($videoId, $title, $author, $desc, $time);
         }
-        $this->feedName = $this->ytBridgeFixTitle($xml->find('feed > title', 0)->plaintext);  // feedName will be used by getName()
     }
 
-    private function ytBridgeFixTitle($title)
+    private function fetch($url, bool $cache = false)
     {
-        // convert both &#1234; and &quot; to UTF-8
-        return html_entity_decode($title, ENT_QUOTES, 'UTF-8');
-    }
-
-    private function ytGetSimpleHTMLDOM($url, $cached = false)
-    {
-        $header = [
-            'Accept-Language: en-US'
-        ];
-        $opts = [];
-        $lowercase = true;
-        $forceTagsClosed = true;
-        $target_charset = DEFAULT_TARGET_CHARSET;
-        $stripRN = false;
-        $defaultBRText = DEFAULT_BR_TEXT;
-        $defaultSpanText = DEFAULT_SPAN_TEXT;
-        if ($cached) {
-            return getSimpleHTMLDOMCached(
-                $url,
-                86400,
-                $header,
-                $opts,
-                $lowercase,
-                $forceTagsClosed,
-                $target_charset,
-                $stripRN,
-                $defaultBRText,
-                $defaultSpanText
-            );
+        $header = ['Accept-Language: en-US'];
+        if ($cache) {
+            $ttl = 86400;
+            return getSimpleHTMLDOMCached($url, $ttl, $header);
         }
-        return getSimpleHTMLDOM(
-            $url,
-            $header,
-            $opts,
-            $lowercase,
-            $forceTagsClosed,
-            $target_charset,
-            $stripRN,
-            $defaultBRText,
-            $defaultSpanText
-        );
+        return getSimpleHTMLDOM($url, $header);
     }
 
-    private function getJSONData($html)
+    private function extractJsonFromHtml($html)
     {
         $scriptRegex = '/var ytInitialData = (.*?);<\/script>/';
         $result = preg_match($scriptRegex, $html, $matches);
@@ -483,10 +440,11 @@ class YoutubeBridge extends BridgeAbstract
             $this->logger->debug('Could not find ytInitialData');
             return null;
         }
-        return json_decode($matches[1]);
+        $data = json_decode($matches[1]);
+        return $data;
     }
 
-    private function parseJSONListing($jsonData)
+    private function fetchItemsFromFromJsonData($jsonData)
     {
         $duration_min = $this->getInput('duration_min') ?: -1;
         $duration_min = $duration_min * 60;
@@ -497,9 +455,6 @@ class YoutubeBridge extends BridgeAbstract
         if ($duration_max < $duration_min) {
             returnClientError('Max duration must be greater than min duration!');
         }
-
-        // $vid_list = '';
-
         foreach ($jsonData as $item) {
             $wrapper = null;
             if (isset($item->gridVideoRenderer)) {
@@ -513,10 +468,8 @@ class YoutubeBridge extends BridgeAbstract
             } else {
                 continue;
             }
-
-            $vid = $wrapper->videoId;
+            $videoId = $wrapper->videoId;
             $title = $wrapper->title->runs[0]->text;
-
             $author = '';
             $desc = '';
             $time = '';
@@ -535,7 +488,6 @@ class YoutubeBridge extends BridgeAbstract
                     }
                 }
             }
-
             if (is_string($durationText)) {
                 if (preg_match('/([\d]{1,2})\:([\d]{1,2})\:([\d]{2})/', $durationText)) {
                     $durationText = preg_replace('/([\d]{1,2})\:([\d]{1,2})\:([\d]{2})/', '$1:$2:$3', $durationText);
@@ -549,15 +501,37 @@ class YoutubeBridge extends BridgeAbstract
                 }
             }
 
-            // $vid_list .= $vid . ',';
-            $this->ytBridgeQueryVideoInfo($vid, $author, $desc, $time);
-            $this->ytBridgeAddItem($vid, $title, $author, $desc, $time);
+            //$durationSeconds = (int) $wrapper->lengthSeconds;
+            if ($duration < $duration_min || $duration > $duration_max) {
+                continue;
+            }
+            $this->fetchVideoDetails($videoId, $author, $desc, $time);
+            $this->addItem($videoId, $title, $author, $desc, $time);
         }
     }
 
-    private function skipFeeds()
+    private function addItem($videoId, $title, $author, $desc, $time, $thumbnail = '')
     {
-        return ($this->getInput('duration_min') || $this->getInput('duration_max'));
+        $item = [];
+        // This should probably be uid?
+        $item['id'] = $videoId;
+        $item['title'] = $title;
+        $item['author'] = $author;
+        $item['timestamp'] = $time;
+        $item['uri'] = self::URI . '/watch?v=' . $videoId;
+        if (!$thumbnail) {
+            // Fallback to default thumbnail if there aren't any provided.
+            $thumbnail = '0';
+        }
+        $thumbnailUri = str_replace('/www.', '/img.', self::URI) . '/vi/' . $videoId . '/' . $thumbnail . '.jpg';
+        $item['content'] = sprintf('<a href="%s"><img src="%s" /></a><br />%s', $item['uri'], $thumbnailUri, $desc);
+        $this->items[] = $item;
+    }
+
+    private function decodeTitle($title)
+    {
+        // convert both &#1234; and &quot; to UTF-8
+        return html_entity_decode($title, ENT_QUOTES, 'UTF-8');
     }
 
     public function getURI()
diff --git a/caches/FileCache.php b/caches/FileCache.php
index 1ae88704..2f4b3ad5 100644
--- a/caches/FileCache.php
+++ b/caches/FileCache.php
@@ -30,7 +30,8 @@ class FileCache implements CacheInterface
         if (!file_exists($cacheFile)) {
             return $default;
         }
-        $item = unserialize(file_get_contents($cacheFile));
+        $data = file_get_contents($cacheFile);
+        $item = unserialize($data);
         if ($item === false) {
             $this->logger->warning(sprintf('Failed to unserialize: %s', $cacheFile));
             $this->delete($key);
@@ -87,7 +88,8 @@ class FileCache implements CacheInterface
             if (isset($excluded[$filename]) || !is_file($cacheFile)) {
                 continue;
             }
-            $item = unserialize(file_get_contents($cacheFile));
+            $data = file_get_contents($cacheFile);
+            $item = unserialize($data);
             if ($item === false) {
                 unlink($cacheFile);
                 continue;

From 2aa52aa99ae8866aa7cd320a88aa1b9a1ca49c5b Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 15 Oct 2023 01:13:17 +0200
Subject: [PATCH 175/716] fix(youtube): bug in prior refactor (#3756)

---
 bridges/YoutubeBridge.php | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/bridges/YoutubeBridge.php b/bridges/YoutubeBridge.php
index 40a8f6a9..5bcdc00f 100644
--- a/bridges/YoutubeBridge.php
+++ b/bridges/YoutubeBridge.php
@@ -425,11 +425,12 @@ class YoutubeBridge extends BridgeAbstract
     private function fetch($url, bool $cache = false)
     {
         $header = ['Accept-Language: en-US'];
+        $ttl = 86400;
+        $stripNewlines = false;
         if ($cache) {
-            $ttl = 86400;
-            return getSimpleHTMLDOMCached($url, $ttl, $header);
+            return getSimpleHTMLDOMCached($url, $ttl, $header, [], true, true, DEFAULT_TARGET_CHARSET, $stripNewlines);
         }
-        return getSimpleHTMLDOM($url, $header);
+        return getSimpleHTMLDOM($url, $header, [], true, true, DEFAULT_TARGET_CHARSET, $stripNewlines);
     }
 
     private function extractJsonFromHtml($html)

From 611fabe46c6118339e8e6f5a119b2dc5850266a7 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 15 Oct 2023 03:15:47 +0200
Subject: [PATCH 176/716] fix(youtube): reduce excessive network calls (#3757)

---
 bridges/YoutubeBridge.php | 110 ++++++++++++++++++++------------------
 1 file changed, 59 insertions(+), 51 deletions(-)

diff --git a/bridges/YoutubeBridge.php b/bridges/YoutubeBridge.php
index 5bcdc00f..9b5dd44e 100644
--- a/bridges/YoutubeBridge.php
+++ b/bridges/YoutubeBridge.php
@@ -104,6 +104,14 @@ class YoutubeBridge extends BridgeAbstract
         $username = $this->getInput('u');
         $channel = $this->getInput('c');
         $custom = $this->getInput('custom');
+        $playlist = $this->getInput('p');
+        $search = $this->getInput('s');
+
+        $durationMin = $this->getInput('duration_min');
+        $durationMax = $this->getInput('duration_max');
+
+        // Whether to discriminate videos by duration
+        $filterByDuration = $durationMin || $durationMax;
 
         if ($username) {
             // user and channel
@@ -119,15 +127,6 @@ class YoutubeBridge extends BridgeAbstract
             $url_listing = self::URI . '/' . urlencode($request) . '/videos';
         }
 
-        $playlist = $this->getInput('p');
-        $search = $this->getInput('s');
-
-        $durationMin = $this->getInput('duration_min');
-        $durationMax = $this->getInput('duration_max');
-
-        // Whether to discriminate videos by duration
-        $filterByDuration = $durationMin || $durationMax;
-
         if ($url_feed || $url_listing) {
             // user, channel or custom
             $this->feeduri = $url_listing;
@@ -217,9 +216,9 @@ class YoutubeBridge extends BridgeAbstract
         }
     }
 
-    private function fetchVideoDetails($vid, &$author, &$desc, &$time)
+    private function fetchVideoDetails($videoId, &$author, &$description, &$timestamp)
     {
-        $url = self::URI . "/watch?v=$vid";
+        $url = self::URI . "/watch?v=$videoId";
         $html = $this->fetch($url, true);
 
         // Skip unavailable videos
@@ -234,7 +233,7 @@ class YoutubeBridge extends BridgeAbstract
 
         $elDatePublished = $html->find('meta[itemprop=datePublished]', 0);
         if (!is_null($elDatePublished)) {
-            $time = strtotime($elDatePublished->getAttribute('content'));
+            $timestamp = strtotime($elDatePublished->getAttribute('content'));
         }
 
         $jsonData = $this->extractJsonFromHtml($html);
@@ -254,30 +253,28 @@ class YoutubeBridge extends BridgeAbstract
             }
         }
         if (!$videoSecondaryInfo) {
-            returnServerError('Could not find videoSecondaryInfoRenderer. Error at: ' . $vid);
+            returnServerError('Could not find videoSecondaryInfoRenderer. Error at: ' . $videoId);
         }
 
-        $desc = $videoSecondaryInfo->attributedDescription->content ?? '';
+        $description = $videoSecondaryInfo->attributedDescription->content ?? '';
 
         // Default whitespace chars used by trim + non-breaking spaces (https://en.wikipedia.org/wiki/Non-breaking_space)
         $whitespaceChars = " \t\n\r\0\x0B\u{A0}\u{2060}\u{202F}\u{2007}";
-        $descEnhancements = $this->ytBridgeGetVideoDescriptionEnhancements($videoSecondaryInfo, $desc, self::URI, $whitespaceChars);
+        $descEnhancements = $this->ytBridgeGetVideoDescriptionEnhancements($videoSecondaryInfo, $description, self::URI, $whitespaceChars);
         foreach ($descEnhancements as $descEnhancement) {
             if (isset($descEnhancement['url'])) {
-                $descBefore = mb_substr($desc, 0, $descEnhancement['pos']);
-                $descValue = mb_substr($desc, $descEnhancement['pos'], $descEnhancement['len']);
-                $descAfter = mb_substr($desc, $descEnhancement['pos'] + $descEnhancement['len'], null);
+                $descBefore = mb_substr($description, 0, $descEnhancement['pos']);
+                $descValue = mb_substr($description, $descEnhancement['pos'], $descEnhancement['len']);
+                $descAfter = mb_substr($description, $descEnhancement['pos'] + $descEnhancement['len'], null);
 
                 // Extended trim for the display value of internal links, e.g.:
                 // FAVICON • Video Name
                 // FAVICON / @ChannelName
                 $descValue = trim($descValue, $whitespaceChars . '•/');
 
-                $desc = sprintf('%s<a href="%s" target="_blank">%s</a>%s', $descBefore, $descEnhancement['url'], $descValue, $descAfter);
+                $description = sprintf('%s<a href="%s" target="_blank">%s</a>%s', $descBefore, $descEnhancement['url'], $descValue, $descAfter);
             }
         }
-
-        $desc = nl2br($desc);
     }
 
     private function ytBridgeGetVideoDescriptionEnhancements(
@@ -425,7 +422,7 @@ class YoutubeBridge extends BridgeAbstract
     private function fetch($url, bool $cache = false)
     {
         $header = ['Accept-Language: en-US'];
-        $ttl = 86400;
+        $ttl = 86400 * 3; // 3d
         $stripNewlines = false;
         if ($cache) {
             return getSimpleHTMLDOMCached($url, $ttl, $header, [], true, true, DEFAULT_TARGET_CHARSET, $stripNewlines);
@@ -447,15 +444,9 @@ class YoutubeBridge extends BridgeAbstract
 
     private function fetchItemsFromFromJsonData($jsonData)
     {
-        $duration_min = $this->getInput('duration_min') ?: -1;
-        $duration_min = $duration_min * 60;
+        $minimumDurationSeconds = ($this->getInput('duration_min') ?: -1) * 60;
+        $maximumDurationSeconds = ($this->getInput('duration_max') ?: INF) * 60;
 
-        $duration_max = $this->getInput('duration_max') ?: INF;
-        $duration_max = $duration_max * 60;
-
-        if ($duration_max < $duration_min) {
-            returnClientError('Max duration must be greater than min duration!');
-        }
         foreach ($jsonData as $item) {
             $wrapper = null;
             if (isset($item->gridVideoRenderer)) {
@@ -469,18 +460,33 @@ class YoutubeBridge extends BridgeAbstract
             } else {
                 continue;
             }
-            $videoId = $wrapper->videoId;
-            $title = $wrapper->title->runs[0]->text;
-            $author = '';
-            $desc = '';
-            $time = '';
 
-            // The duration comes in one of the formats:
-            // hh:mm:ss / mm:ss / m:ss
-            // 01:03:30 / 15:06 / 1:24
+            // 01:03:30 | 15:06 | 1:24
+            $lengthText = $wrapper->lengthText->simpleText ?? null;
+            // 6,875 views
+            $viewCount = $wrapper->viewCountText->simpleText ?? null;
+            // Dc645M8Het8
+            $videoId = $wrapper->videoId;
+            // Jumbo frames - transfer more data faster!
+            $title = $wrapper->title->runs[0]->text ?? $wrapper->title->accessibility->accessibilityData->label ?? null;
+            $author = null;
+            $description = $wrapper->descriptionSnippet->runs[0]->text ?? null;
+            // 5 days ago | 1 month ago
+            $publishedTimeText = $wrapper->publishedTimeText->simpleText ?? $wrapper->videoInfo->runs[2]->text ?? null;
+            $timestamp = null;
+            if ($publishedTimeText) {
+                try {
+                    $publicationDate = new \DateTimeImmutable($publishedTimeText);
+                    // Hard-code hour, minute and second
+                    $publicationDate = $publicationDate->setTime(0, 0, 0);
+                    $timestamp = $publicationDate->getTimestamp();
+                } catch (\Exception $e) {
+                }
+            }
+
             $durationText = 0;
-            if (isset($wrapper->lengthText)) {
-                $durationText = $wrapper->lengthText->simpleText;
+            if ($lengthText) {
+                $durationText = $lengthText;
             } else {
                 foreach ($wrapper->thumbnailOverlays as $overlay) {
                     if (isset($overlay->thumbnailOverlayTimeStatusRenderer)) {
@@ -497,35 +503,37 @@ class YoutubeBridge extends BridgeAbstract
                 }
                 sscanf($durationText, '%d:%d:%d', $hours, $minutes, $seconds);
                 $duration = $hours * 3600 + $minutes * 60 + $seconds;
-                if ($duration < $duration_min || $duration > $duration_max) {
+                if ($duration < $minimumDurationSeconds || $duration > $maximumDurationSeconds) {
                     continue;
                 }
             }
-
-            //$durationSeconds = (int) $wrapper->lengthSeconds;
-            if ($duration < $duration_min || $duration > $duration_max) {
-                continue;
+            if (!$description || !$timestamp) {
+                $this->fetchVideoDetails($videoId, $author, $description, $timestamp);
+            }
+            $this->addItem($videoId, $title, $author, $description, $timestamp);
+            if (count($this->items) >= 99) {
+                break;
             }
-            $this->fetchVideoDetails($videoId, $author, $desc, $time);
-            $this->addItem($videoId, $title, $author, $desc, $time);
         }
     }
 
-    private function addItem($videoId, $title, $author, $desc, $time, $thumbnail = '')
+    private function addItem($videoId, $title, $author, $description, $timestamp, $thumbnail = '')
     {
+        $description = nl2br($description);
+
         $item = [];
         // This should probably be uid?
         $item['id'] = $videoId;
         $item['title'] = $title;
-        $item['author'] = $author;
-        $item['timestamp'] = $time;
+        $item['author'] = $author ?? '';
+        $item['timestamp'] = $timestamp;
         $item['uri'] = self::URI . '/watch?v=' . $videoId;
         if (!$thumbnail) {
             // Fallback to default thumbnail if there aren't any provided.
             $thumbnail = '0';
         }
         $thumbnailUri = str_replace('/www.', '/img.', self::URI) . '/vi/' . $videoId . '/' . $thumbnail . '.jpg';
-        $item['content'] = sprintf('<a href="%s"><img src="%s" /></a><br />%s', $item['uri'], $thumbnailUri, $desc);
+        $item['content'] = sprintf('<a href="%s"><img src="%s" /></a><br />%s', $item['uri'], $thumbnailUri, $description);
         $this->items[] = $item;
     }
 

From f7f3ca0126ed42ded38c9d299a12cb6c8dfccba0 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 15 Oct 2023 03:37:50 +0200
Subject: [PATCH 177/716] fix(tapas): bug in prior refactor (#3758)

---
 bridges/TapasBridge.php | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/bridges/TapasBridge.php b/bridges/TapasBridge.php
index ea6a7ff6..8009e64d 100644
--- a/bridges/TapasBridge.php
+++ b/bridges/TapasBridge.php
@@ -35,7 +35,7 @@ class TapasBridge extends FeedExpander
         if (preg_match('/^[\d]+$/', $this->getInput('title'))) {
             $this->id = $this->getInput('title');
         }
-        if ($this->getInput('force_title') or !$this->id) {
+        if ($this->getInput('force_title') || !$this->id) {
             $html = getSimpleHTMLDOM($this->getURI()) or returnServerError('Could not request ' . $this->getURI());
             $this->id = $html->find('meta[property$=":url"]', 0)->content;
             $this->id = str_ireplace(['tapastic://series/', '/info'], '', $this->id);
@@ -53,6 +53,7 @@ class TapasBridge extends FeedExpander
 //            }
 //        }
 
+        $item['content'] ??= '';
         if ($this->getInput('extend_content')) {
             $html = getSimpleHTMLDOM($item['uri']);
             $item['content'] = $item['content'] ?? '';
@@ -77,6 +78,6 @@ class TapasBridge extends FeedExpander
         if ($this->id) {
             return self::URI . 'rss/series/' . $this->id;
         }
-        return self::URI;
+        return self::URI . 'series/' . $this->getInput('title') . '/info/';
     }
 }

From 408c2e5e918dd94716281dfce4bb5b6882cc829e Mon Sep 17 00:00:00 2001
From: Ololbu <bukachyov.oleg@gmail.com>
Date: Sun, 15 Oct 2023 18:24:07 +0500
Subject: [PATCH 178/716] [FicbookBridge] Fix timestamp (#3760)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Delete a year word after date digits: `DD m YYYY г., HH:MM` to `DD m YYYY, HH:MM`
---
 bridges/FicbookBridge.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/bridges/FicbookBridge.php b/bridges/FicbookBridge.php
index 98288514..d11015ad 100644
--- a/bridges/FicbookBridge.php
+++ b/bridges/FicbookBridge.php
@@ -184,6 +184,7 @@ class FicbookBridge extends BridgeAbstract
         ];
 
         $fixed_date = str_replace($ru_month, $en_month, $date);
+        $fixed_date = str_replace(' г.', '', $fixed_date);
 
         if ($fixed_date === $date) {
             Debug::log('Unable to fix date: ' . $date);

From ef5bd83bd0d8645b1d7ae4201e7a167f82e3eaee Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Mon, 16 Oct 2023 02:58:03 +0200
Subject: [PATCH 179/716] feat: preserve and reproduce podcast feeds (itunes
 rss module) (#3759)

---
 bridges/CssSelectorFeedExpanderBridge.php |   4 +-
 bridges/NyaaTorrentsBridge.php            |  43 ++-------
 composer.json                             |   4 +-
 formats/AtomFormat.php                    |  18 +++-
 formats/MrssFormat.php                    |  30 ++++--
 lib/FeedParser.php                        | 110 ++++++++++++++--------
 lib/FormatAbstract.php                    |   2 +
 7 files changed, 126 insertions(+), 85 deletions(-)

diff --git a/bridges/CssSelectorFeedExpanderBridge.php b/bridges/CssSelectorFeedExpanderBridge.php
index 9f332fb9..49bbd473 100644
--- a/bridges/CssSelectorFeedExpanderBridge.php
+++ b/bridges/CssSelectorFeedExpanderBridge.php
@@ -50,7 +50,9 @@ class CssSelectorFeedExpanderBridge extends CssSelectorBridge
         $discard_thumbnail = $this->getInput('discard_thumbnail');
         $limit = $this->getInput('limit');
 
-        $source_feed = (new FeedParser())->parseFeed(getContents($url));
+        $feedParser = new FeedParser();
+        $xml = getContents($url);
+        $source_feed = $feedParser->parseFeed($xml);
         $items = $source_feed['items'];
 
         // Map Homepage URL (Default: Root page)
diff --git a/bridges/NyaaTorrentsBridge.php b/bridges/NyaaTorrentsBridge.php
index f7eea07f..fcf2b197 100644
--- a/bridges/NyaaTorrentsBridge.php
+++ b/bridges/NyaaTorrentsBridge.php
@@ -62,52 +62,27 @@ class NyaaTorrentsBridge extends BridgeAbstract
 
     public function collectData()
     {
-        // Manually parsing because we need to acccess the nyaa namespace in the xml
-        $xml = simplexml_load_string(getContents($this->getURI()));
-        $channel = $xml->channel[0];
-        $feed = [];
-        $feed['title'] = trim((string)$channel->title);
-        $feed['uri'] = trim((string)$channel->link);
-        if (!empty($channel->image)) {
-            $feed['icon'] = trim((string)$channel->image->url);
-        }
-        $items = $xml->channel[0]->item;
-        foreach ($items as $feedItem) {
-            $item = [
-                'title' => (string) $feedItem->title,
-                'uri' => (string) $feedItem->link,
-            ];
-
+        $feedParser = new FeedParser();
+        $feed = $feedParser->parseFeed(getContents($this->getURI()));
 
+        foreach ($feed['items'] as $item) {
             $item['id'] = str_replace(['https://nyaa.si/download/', '.torrent'], '', $item['uri']);
-
-            $nyaaNamespace = (array)($feedItem->children('nyaa', true));
-            $item = array_merge($item, $nyaaNamespace);
-
-            // Convert URI from torrent file to web page
             $item['uri'] = str_replace('/download/', '/view/', $item['uri']);
             $item['uri'] = str_replace('.torrent', '', $item['uri']);
-
-            $item_html = getSimpleHTMLDOMCached($item['uri']);
-            if ($item_html) {
-                // Retrieve full description from page contents
-                $item_desc = str_get_html(
-                    markdownToHtml(html_entity_decode($item_html->find('#torrent-description', 0)->innertext))
-                );
-
-                // Retrieve image for thumbnail or generic logo fallback
+            $dom = getSimpleHTMLDOMCached($item['uri']);
+            if ($dom) {
+                $description = $dom->find('#torrent-description', 0)->innertext ?? '';
+                $itemDom = str_get_html(markdownToHtml(html_entity_decode($description)));
                 $item_image = $this->getURI() . 'static/img/avatar/default.png';
-                foreach ($item_desc->find('img') as $img) {
+                foreach ($itemDom->find('img') as $img) {
                     if (strpos($img->src, 'prez') === false) {
                         $item_image = $img->src;
                         break;
                     }
                 }
-
                 $item['enclosures'] = [$item_image];
-                $item['content'] = $item_desc;
+                $item['content'] = (string) $itemDom;
             }
-
             $this->items[] = $item;
             if (count($this->items) >= 10) {
                 break;
diff --git a/composer.json b/composer.json
index 31e31d74..0e7abb84 100644
--- a/composer.json
+++ b/composer.json
@@ -28,6 +28,7 @@
         "ext-openssl": "*",
         "ext-libxml": "*",
         "ext-simplexml": "*",
+        "ext-dom": "*",
         "ext-json": "*"
     },
     "require-dev": {
@@ -38,8 +39,7 @@
         "ext-memcached": "Allows to use memcached as cache type",
         "ext-sqlite3": "Allows to use an SQLite database for caching",
         "ext-zip": "Required for FDroidRepoBridge",
-        "ext-intl": "Required for OLXBridge",
-        "ext-dom": "Allows to use some bridges based on XPath expressions"
+        "ext-intl": "Required for OLXBridge"
     },
     "autoload-dev": {
         "psr-4": {
diff --git a/formats/AtomFormat.php b/formats/AtomFormat.php
index 9886e4b7..d59e42fe 100644
--- a/formats/AtomFormat.php
+++ b/formats/AtomFormat.php
@@ -16,6 +16,8 @@ class AtomFormat extends FormatAbstract
 
     public function stringify()
     {
+        $document = new \DomDocument('1.0', $this->getCharset());
+
         $feedUrl = get_current_url();
 
         $extraInfos = $this->getExtraInfos();
@@ -25,7 +27,6 @@ class AtomFormat extends FormatAbstract
             $uri = $extraInfos['uri'];
         }
 
-        $document = new \DomDocument('1.0', $this->getCharset());
         $document->formatOutput = true;
         $feed = $document->createElementNS(self::ATOM_NS, 'feed');
         $document->appendChild($feed);
@@ -81,6 +82,7 @@ class AtomFormat extends FormatAbstract
         $linkSelf->setAttribute('href', $feedUrl);
 
         foreach ($this->getItems() as $item) {
+            $itemArray = $item->toArray();
             $entryTimestamp = $item->getTimestamp();
             $entryTitle = $item->getTitle();
             $entryContent = $item->getContent();
@@ -138,7 +140,19 @@ class AtomFormat extends FormatAbstract
             $entry->appendChild($id);
             $id->appendChild($document->createTextNode($entryID));
 
-            if (!empty($entryUri)) {
+            if (isset($itemArray['itunes'])) {
+                $feed->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:itunes', self::ITUNES_NS);
+                foreach ($itemArray['itunes'] as $itunesKey => $itunesValue) {
+                    $itunesProperty = $document->createElementNS(self::ITUNES_NS, $itunesKey);
+                    $entry->appendChild($itunesProperty);
+                    $itunesProperty->appendChild($document->createTextNode($itunesValue));
+                }
+                $itunesEnclosure = $document->createElement('enclosure');
+                $entry->appendChild($itunesEnclosure);
+                $itunesEnclosure->setAttribute('url', $itemArray['enclosure']['url']);
+                $itunesEnclosure->setAttribute('length', $itemArray['enclosure']['length']);
+                $itunesEnclosure->setAttribute('type', $itemArray['enclosure']['type']);
+            } elseif (!empty($entryUri)) {
                 $entryLinkAlternate = $document->createElement('link');
                 $entry->appendChild($entryLinkAlternate);
                 $entryLinkAlternate->setAttribute('rel', 'alternate');
diff --git a/formats/MrssFormat.php b/formats/MrssFormat.php
index 984611c7..4fd06439 100644
--- a/formats/MrssFormat.php
+++ b/formats/MrssFormat.php
@@ -34,6 +34,8 @@ class MrssFormat extends FormatAbstract
 
     public function stringify()
     {
+        $document = new \DomDocument('1.0', $this->getCharset());
+
         $feedUrl = get_current_url();
         $extraInfos = $this->getExtraInfos();
         if (empty($extraInfos['uri'])) {
@@ -42,7 +44,6 @@ class MrssFormat extends FormatAbstract
             $uri = $extraInfos['uri'];
         }
 
-        $document = new \DomDocument('1.0', $this->getCharset());
         $document->formatOutput = true;
         $feed = $document->createElement('rss');
         $document->appendChild($feed);
@@ -99,22 +100,23 @@ class MrssFormat extends FormatAbstract
         $linkSelf->setAttribute('href', $feedUrl);
 
         foreach ($this->getItems() as $item) {
+            $itemArray = $item->toArray();
             $itemTimestamp = $item->getTimestamp();
             $itemTitle = $item->getTitle();
             $itemUri = $item->getURI();
             $itemContent = $item->getContent() ? break_annoying_html_tags($item->getContent()) : '';
-            $entryID = $item->getUid();
+            $itemUid = $item->getUid();
             $isPermaLink = 'false';
 
-            if (empty($entryID) && !empty($itemUri)) {
+            if (empty($itemUid) && !empty($itemUri)) {
                 // Fallback to provided URI
-                $entryID = $itemUri;
+                $itemUid = $itemUri;
                 $isPermaLink = 'true';
             }
 
-            if (empty($entryID)) {
+            if (empty($itemUid)) {
                 // Fallback to title and content
-                $entryID = hash('sha1', $itemTitle . $itemContent);
+                $itemUid = hash('sha1', $itemTitle . $itemContent);
             }
 
             $entry = $document->createElement('item');
@@ -126,7 +128,19 @@ class MrssFormat extends FormatAbstract
                 $entryTitle->appendChild($document->createTextNode($itemTitle));
             }
 
-            if (!empty($itemUri)) {
+            if (isset($itemArray['itunes'])) {
+                $feed->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:itunes', self::ITUNES_NS);
+                foreach ($itemArray['itunes'] as $itunesKey => $itunesValue) {
+                    $itunesProperty = $document->createElementNS(self::ITUNES_NS, $itunesKey);
+                    $entry->appendChild($itunesProperty);
+                    $itunesProperty->appendChild($document->createTextNode($itunesValue));
+                }
+                $itunesEnclosure = $document->createElement('enclosure');
+                $entry->appendChild($itunesEnclosure);
+                $itunesEnclosure->setAttribute('url', $itemArray['enclosure']['url']);
+                $itunesEnclosure->setAttribute('length', $itemArray['enclosure']['length']);
+                $itunesEnclosure->setAttribute('type', $itemArray['enclosure']['type']);
+            } if (!empty($itemUri)) {
                 $entryLink = $document->createElement('link');
                 $entry->appendChild($entryLink);
                 $entryLink->appendChild($document->createTextNode($itemUri));
@@ -135,7 +149,7 @@ class MrssFormat extends FormatAbstract
             $entryGuid = $document->createElement('guid');
             $entryGuid->setAttribute('isPermaLink', $isPermaLink);
             $entry->appendChild($entryGuid);
-            $entryGuid->appendChild($document->createTextNode($entryID));
+            $entryGuid->appendChild($document->createTextNode($itemUid));
 
             if (!empty($itemTimestamp)) {
                 $entryPublished = $document->createElement('pubDate');
diff --git a/lib/FeedParser.php b/lib/FeedParser.php
index 1393f5f5..2d982de1 100644
--- a/lib/FeedParser.php
+++ b/lib/FeedParser.php
@@ -3,11 +3,13 @@
 declare(strict_types=1);
 
 /**
- * Very basic and naive feed parser that srapes out rss 0.91, 1.0, 2.0 and atom 1.0.
+ * Very basic and naive feed parser.
  *
- * Emit arrays meant to be used inside rss-bridge.
+ * Scrapes out rss 0.91, 1.0, 2.0 and atom 1.0.
  *
- * The feed item structure is identical to that of FeedItem
+ * Produce arrays meant to be used inside rss-bridge.
+ *
+ * The item structure is tweaked so that works with FeedItem
  */
 final class FeedParser
 {
@@ -85,9 +87,7 @@ final class FeedParser
 
     public function parseAtomItem(\SimpleXMLElement $feedItem): array
     {
-        // Some ATOM entries also contain RSS 2.0 fields
         $item = $this->parseRss2Item($feedItem);
-
         if (isset($feedItem->id)) {
             $item['uri'] = (string)$feedItem->id;
         }
@@ -131,8 +131,35 @@ final class FeedParser
 
     public function parseRss2Item(\SimpleXMLElement $feedItem): array
     {
-        // Primary data is compatible to 0.91 with some additional data
-        $item = $this->parseRss091Item($feedItem);
+        $item = [
+            'uri'           => '',
+            'title'         => '',
+            'content'       => '',
+            'timestamp'     => '',
+            'author'        => '',
+            //'uid'           => null,
+            //'categories'    => [],
+            //'enclosures'    => [],
+        ];
+
+        foreach ($feedItem as $k => $v) {
+            $hasChildren = count($v) !== 0;
+            if (!$hasChildren) {
+                $item[$k] = (string) $v;
+            }
+        }
+
+        if (isset($feedItem->link)) {
+            // todo: trim uri
+            $item['uri'] = (string)$feedItem->link;
+        }
+        if (isset($feedItem->title)) {
+            $item['title'] = html_entity_decode((string)$feedItem->title);
+        }
+        if (isset($feedItem->description)) {
+            $item['content'] = (string)$feedItem->description;
+        }
+
         $namespaces = $feedItem->getNamespaces(true);
         if (isset($namespaces['dc'])) {
             $dc = $feedItem->children($namespaces['dc']);
@@ -140,7 +167,24 @@ final class FeedParser
         if (isset($namespaces['media'])) {
             $media = $feedItem->children($namespaces['media']);
         }
-
+        foreach ($namespaces as $namespaceName => $namespaceUrl) {
+            if (in_array($namespaceName, ['', 'content', 'media'])) {
+                continue;
+            }
+            $module = $feedItem->children($namespaceUrl);
+            $item[$namespaceName] = [];
+            foreach ($module as $moduleKey => $moduleValue) {
+                $item[$namespaceName][$moduleKey] = (string) $moduleValue;
+            }
+        }
+        if (isset($namespaces['itunes'])) {
+            $enclosure = $feedItem->enclosure;
+            $item['enclosure'] = [
+                'url'       => (string) $enclosure['url'],
+                'length'    => (string) $enclosure['length'],
+                'type'      => (string) $enclosure['type'],
+            ];
+        }
         if (isset($feedItem->guid)) {
             // Pluck out a url from guid
             foreach ($feedItem->guid->attributes() as $attribute => $value) {
@@ -185,8 +229,26 @@ final class FeedParser
 
     public function parseRss1Item(\SimpleXMLElement $feedItem): array
     {
-        // 1.0 adds optional elements around the 0.91 standard
-        $item = $this->parseRss091Item($feedItem);
+        $item = [
+            'uri'           => '',
+            'title'         => '',
+            'content'       => '',
+            'timestamp'     => '',
+            'author'        => '',
+            //'uid'           => null,
+            //'categories'    => [],
+            //'enclosures'    => [],
+        ];
+        if (isset($feedItem->link)) {
+            // todo: trim uri
+            $item['uri'] = (string)$feedItem->link;
+        }
+        if (isset($feedItem->title)) {
+            $item['title'] = html_entity_decode((string)$feedItem->title);
+        }
+        if (isset($feedItem->description)) {
+            $item['content'] = (string)$feedItem->description;
+        }
         $namespaces = $feedItem->getNamespaces(true);
         if (isset($namespaces['dc'])) {
             $dc = $feedItem->children($namespaces['dc']);
@@ -199,32 +261,4 @@ final class FeedParser
         }
         return $item;
     }
-
-    public function parseRss091Item(\SimpleXMLElement $feedItem): array
-    {
-        $item = [
-            'uri'           => null,
-            'title'         => null,
-            'content'       => null,
-            'timestamp'     => null,
-            'author'        => null,
-            //'uid'           => null,
-            //'categories'    => [],
-            //'enclosures'    => [],
-        ];
-        if (isset($feedItem->link)) {
-            // todo: trim uri
-            $item['uri'] = (string)$feedItem->link;
-        }
-        if (isset($feedItem->title)) {
-            $item['title'] = html_entity_decode((string)$feedItem->title);
-        }
-        // rss 0.91 doesn't support timestamps
-        // rss 0.91 doesn't support authors
-        // rss 0.91 doesn't support enclosures
-        if (isset($feedItem->description)) {
-            $item['content'] = (string)$feedItem->description;
-        }
-        return $item;
-    }
 }
diff --git a/lib/FormatAbstract.php b/lib/FormatAbstract.php
index b05a5764..c76d1e42 100644
--- a/lib/FormatAbstract.php
+++ b/lib/FormatAbstract.php
@@ -2,6 +2,8 @@
 
 abstract class FormatAbstract
 {
+    public const ITUNES_NS = 'http://www.itunes.com/dtds/podcast-1.0.dtd';
+
     const MIME_TYPE = 'text/plain';
 
     protected string $charset = 'UTF-8';

From 563c2a345b632a0245f888a925151e4d23b1a776 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Mon, 16 Oct 2023 03:43:18 +0200
Subject: [PATCH 180/716] refactor (#3763)

---
 bridges/ARDAudiothekBridge.php |  7 ++++++-
 bridges/YoutubeBridge.php      | 33 +++++++++++----------------------
 2 files changed, 17 insertions(+), 23 deletions(-)

diff --git a/bridges/ARDAudiothekBridge.php b/bridges/ARDAudiothekBridge.php
index 07a3cc68..2c1958f3 100644
--- a/bridges/ARDAudiothekBridge.php
+++ b/bridges/ARDAudiothekBridge.php
@@ -113,7 +113,12 @@ class ARDAudiothekBridge extends BridgeAbstract
                 $item['timestamp'] = $audio->publicationStartDateAndTime;
                 $item['uid'] = $audio->id;
                 $item['author'] = $audio->programSet->publicationService->title;
-                $item['categories'] = [ $audio->programSet->editorialCategories->title ];
+
+                $category = $audio->programSet->editorialCategories->title ?? null;
+                if ($category) {
+                    $item['categories'] = [$category];
+                }
+
                 $this->items[] = $item;
             }
         }
diff --git a/bridges/YoutubeBridge.php b/bridges/YoutubeBridge.php
index 9b5dd44e..993f8c90 100644
--- a/bridges/YoutubeBridge.php
+++ b/bridges/YoutubeBridge.php
@@ -96,7 +96,6 @@ class YoutubeBridge extends BridgeAbstract
 
     private function collectDataInternal()
     {
-        $xml = '';
         $html = '';
         $url_feed = '';
         $url_listing = '';
@@ -115,16 +114,13 @@ class YoutubeBridge extends BridgeAbstract
 
         if ($username) {
             // user and channel
-            $request = $username;
-            $url_feed = self::URI . '/feeds/videos.xml?user=' . urlencode($request);
-            $url_listing = self::URI . '/user/' . urlencode($request) . '/videos';
+            $url_feed = self::URI . '/feeds/videos.xml?user=' . urlencode($username);
+            $url_listing = self::URI . '/user/' . urlencode($username) . '/videos';
         } elseif ($channel) {
-            $request = $channel;
-            $url_feed = self::URI . '/feeds/videos.xml?channel_id=' . urlencode($request);
-            $url_listing = self::URI . '/channel/' . urlencode($request) . '/videos';
+            $url_feed = self::URI . '/feeds/videos.xml?channel_id=' . urlencode($channel);
+            $url_listing = self::URI . '/channel/' . urlencode($channel) . '/videos';
         } elseif ($custom) {
-            $request = $custom;
-            $url_listing = self::URI . '/' . urlencode($request) . '/videos';
+            $url_listing = self::URI . '/' . urlencode($custom) . '/videos';
         }
 
         if ($url_feed || $url_listing) {
@@ -152,7 +148,7 @@ class YoutubeBridge extends BridgeAbstract
                     // $jsonData = $jsonData->itemSectionRenderer->contents[0]->gridRenderer->items;
                     $this->fetchItemsFromFromJsonData($jsonData);
                 } else {
-                    returnServerError('Unable to get data from YouTube. Username/Channel: ' . $request);
+                    returnServerError('Unable to get data from YouTube');
                 }
             } else {
                 // Fetch the xml feed
@@ -162,13 +158,8 @@ class YoutubeBridge extends BridgeAbstract
             $this->feedName = str_replace(' - YouTube', '', $html->find('title', 0)->plaintext);
         } elseif ($playlist) {
             // playlist
-            // TODO: this mode makes a lot of excess video query requests.
-            // To make less requests, we need to cache following dictionary "videoId -> datePublished, duration"
-            // This cache will be used to find out, which videos to fetch
-            // to make feed of 15 items or more, if there a lot of videos published on that date.
-            $request = $playlist;
-            $url_feed = self::URI . '/feeds/videos.xml?playlist_id=' . urlencode($request);
-            $url_listing = self::URI . '/playlist?list=' . urlencode($request);
+            $url_feed = self::URI . '/feeds/videos.xml?playlist_id=' . urlencode($playlist);
+            $url_listing = self::URI . '/playlist?list=' . urlencode($playlist);
             $html = $this->fetch($url_listing);
             $jsonData = $this->extractJsonFromHtml($html);
             // TODO: this method returns only first 100 video items
@@ -194,8 +185,7 @@ class YoutubeBridge extends BridgeAbstract
             });
         } elseif ($search) {
             // search
-            $request = $search;
-            $url_listing = self::URI . '/results?search_query=' . urlencode($request) . '&sp=CAI%253D';
+            $url_listing = self::URI . '/results?search_query=' . urlencode($search) . '&sp=CAI%253D';
             $html = $this->fetch($url_listing);
             $jsonData = $this->extractJsonFromHtml($html);
             $jsonData = $jsonData->contents->twoColumnSearchResultsRenderer->primaryContents;
@@ -209,10 +199,9 @@ class YoutubeBridge extends BridgeAbstract
             }
             $this->fetchItemsFromFromJsonData($jsonData);
             $this->feeduri = $url_listing;
-            $this->feedName = 'Search: ' . $request;
+            $this->feedName = 'Search: ' . $search;
         } else {
-            returnClientError("You must either specify either:\n - YouTube
- username (?u=...)\n - Channel id (?c=...)\n - Playlist id (?p=...)\n - Search (?s=...)");
+            returnClientError("You must either specify either:\n - YouTube username (?u=...)\n - Channel id (?c=...)\n - Playlist id (?p=...)\n - Search (?s=...)");
         }
     }
 

From 8203196145c30587aa83e0d22c9d1c915356e0c9 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Wed, 18 Oct 2023 02:33:29 +0200
Subject: [PATCH 181/716] [ImgsedBridge] More robust data parsing (#3766)

Date Interval with the article "an" or "a" are now handled in a generic
way : every "article" is replaced by the number "1" instead of a
handling of multiple special case
---
 bridges/ImgsedBridge.php | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/bridges/ImgsedBridge.php b/bridges/ImgsedBridge.php
index e605cf4f..12466c6b 100644
--- a/bridges/ImgsedBridge.php
+++ b/bridges/ImgsedBridge.php
@@ -206,14 +206,12 @@ HTML,
     {
         // Parse date, and transform the date into a timetamp, even in a case of a relative date
         $date = date_create();
-        $dateString = str_replace(' ago', '', $content);
-        // Special case : 'a day' is not a valid interval in PHP, so replace it with it's PHP equivalenbt : '1 day'
-        if ($dateString == 'a day') {
-            $dateString = '1 day';
-        }
-        if ($dateString === 'an hour') {
-            $dateString = '1 hour';
-        }
+
+        // Content trimmed to be sure that the "article" is at the beginning of the string and remove "ago" to make it a valid PHP date interval
+        $dateString = trim(str_replace(' ago', '', $content));
+
+        // Replace the article "an" or "a" by the number "1" to be a valid PHP date interval
+        $dateString = preg_replace('/^((an|a) )/m', '1 ', $dateString);
 
         $relativeDate = date_interval_create_from_date_string($dateString);
         if ($relativeDate) {

From a41bb088f816454d9fbd07011e1365d0845fde3d Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Wed, 18 Oct 2023 19:10:52 +0200
Subject: [PATCH 182/716] [CssSelectorBridge] Add more metadata tags (#3768)

Add og: variants for published/updated time and author
---
 bridges/CssSelectorBridge.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/bridges/CssSelectorBridge.php b/bridges/CssSelectorBridge.php
index f6ab8d15..8fba5285 100644
--- a/bridges/CssSelectorBridge.php
+++ b/bridges/CssSelectorBridge.php
@@ -336,9 +336,11 @@ class CssSelectorBridge extends BridgeAbstract
             ],
             'timestamp' => [
                 'article:published_time',
+                'og:article:published_time',
                 'releaseDate',
                 'releasedate',
                 'article:modified_time',
+                'og:article:modified_time',
                 'lastModified',
                 'lastmodified'
             ],
@@ -351,8 +353,9 @@ class CssSelectorBridge extends BridgeAbstract
                 'thumbnailimg'
             ],
             'author' => [
-                'author',
                 'article:author',
+                'og:article:author',
+                'author',
                 'article:author:username',
                 'profile:first_name',
                 'profile:last_name',

From 7533ef12e3348779b1be2a1aa1704f972d3176a3 Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Wed, 18 Oct 2023 19:12:19 +0200
Subject: [PATCH 183/716] [html] improve srcset attribute parsing (#3769)

Fix commas not being used for splitting, resulting in broken src URL in some cases:
srcset="url1.jpg, url2.jpg 2x" would give src="url1.jpg,"
---
 lib/html.php | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/lib/html.php b/lib/html.php
index 505221fc..ba8067a6 100644
--- a/lib/html.php
+++ b/lib/html.php
@@ -244,16 +244,26 @@ function convertLazyLoading($dom)
         $dom = str_get_html($dom);
     }
 
+    // Retrieve image URL from srcset attribute
+    // https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/srcset
+    // Example: convert "header640.png 640w, header960.png 960w, header1024.png 1024w" to "header1024.png"
+    $srcset_to_src = function ($srcset) {
+        $sources = explode(',', $srcset);
+        $last_entry = trim(end($sources));
+        $url = explode(' ', $last_entry)[0];
+        return $url;
+    };
+
     // Process standalone images, embeds and picture sources
     foreach ($dom->find('img, iframe, source') as $img) {
         if (!empty($img->getAttribute('data-src'))) {
             $img->src = $img->getAttribute('data-src');
         } elseif (!empty($img->getAttribute('data-srcset'))) {
-            $img->src = explode(' ', $img->getAttribute('data-srcset'))[0];
+            $img->src = $srcset_to_src($img->getAttribute('data-srcset'));
         } elseif (!empty($img->getAttribute('data-lazy-src'))) {
             $img->src = $img->getAttribute('data-lazy-src');
         } elseif (!empty($img->getAttribute('srcset'))) {
-            $img->src = explode(' ', $img->getAttribute('srcset'))[0];
+            $img->src = $srcset_to_src($img->getAttribute('srcset'));
         } else {
             continue; // Proceed to next element without removing attributes
         }

From 9056106c2d52991931ba7fc1c41494697396d477 Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Wed, 18 Oct 2023 19:13:33 +0200
Subject: [PATCH 184/716] [CNet] Rewrite bridge (#3764) (#3770)

Bridge was broken.
Full bridge rewrite using Sitemap as source.
---
 bridges/CNETBridge.php    | 168 +++++++++++++++++++-------------------
 bridges/SitemapBridge.php |   6 +-
 2 files changed, 87 insertions(+), 87 deletions(-)

diff --git a/bridges/CNETBridge.php b/bridges/CNETBridge.php
index 34442abd..4a63c847 100644
--- a/bridges/CNETBridge.php
+++ b/bridges/CNETBridge.php
@@ -1,6 +1,6 @@
 <?php
 
-class CNETBridge extends BridgeAbstract
+class CNETBridge extends SitemapBridge
 {
     const MAINTAINER = 'ORelio';
     const NAME = 'CNET News';
@@ -14,101 +14,101 @@ class CNETBridge extends BridgeAbstract
                 'type' => 'list',
                 'values' => [
                     'All articles' => '',
-                    'Apple' => 'apple',
-                    'Google' => 'google',
-                    'Microsoft' => 'tags-microsoft',
-                    'Computers' => 'topics-computers',
-                    'Mobile' => 'topics-mobile',
-                    'Sci-Tech' => 'topics-sci-tech',
-                    'Security' => 'topics-security',
-                    'Internet' => 'topics-internet',
-                    'Tech Industry' => 'topics-tech-industry'
+                    'Tech' => 'tech',
+                    'Money' => 'personal-finance',
+                    'Home' => 'home',
+                    'Wellness' => 'health',
+                    'Energy' => 'home/energy-and-utilities',
+                    'Deals' => 'deals',
+                    'Computing' => 'tech/computing',
+                    'Mobile' => 'tech/mobile',
+                    'Science' => 'science',
+                    'Services' => 'tech/services-and-software'
                 ]
-            ]
+            ],
+            'limit' => self::LIMIT
         ]
     ];
 
-    private function cleanArticle($article_html)
-    {
-        $offset_p = strpos($article_html, '<p>');
-        $offset_figure = strpos($article_html, '<figure');
-        $offset = ($offset_figure < $offset_p ? $offset_figure : $offset_p);
-        $article_html = substr($article_html, $offset);
-        $article_html = str_replace('href="/', 'href="' . self::URI, $article_html);
-        $article_html = str_replace(' height="0"', '', $article_html);
-        $article_html = str_replace('<noscript>', '', $article_html);
-        $article_html = str_replace('</noscript>', '', $article_html);
-        $article_html = StripWithDelimiters($article_html, '<a class="clickToEnlarge', '</a>');
-        $article_html = stripWithDelimiters($article_html, '<span class="nowPlaying', '</span>');
-        $article_html = stripWithDelimiters($article_html, '<span class="duration', '</span>');
-        $article_html = stripWithDelimiters($article_html, '<script', '</script>');
-        $article_html = stripWithDelimiters($article_html, '<svg', '</svg>');
-        return $article_html;
-    }
-
     public function collectData()
     {
-        // Retrieve and check user input
-        $topic = str_replace('-', '/', $this->getInput('topic'));
-        if (!empty($topic) && (substr_count($topic, '/') > 1 || !ctype_alpha(str_replace('/', '', $topic)))) {
-            returnClientError('Invalid topic: ' . $topic);
+        $topic = $this->getInput('topic');
+        $limit = $this->getInput('limit');
+        $limit = empty($limit) ? 10 : $limit;
+
+        $url_pattern = empty($topic) ? '' : self::URI . $topic;
+        $sitemap_latest = self::URI . 'sitemaps/article/' . date('Y/m') . '.xml';
+        $sitemap_previous = self::URI . 'sitemaps/article/' . date('Y/m', strtotime('last day of previous month')) . '.xml';
+
+        $links = array_merge(
+            $this->sitemapXmlToList($this->getSitemapXml($sitemap_latest, true), $url_pattern, $limit),
+            $this->sitemapXmlToList($this->getSitemapXml($sitemap_previous, true), $url_pattern, $limit)
+        );
+
+        if ($limit > 0 && count($links) > $limit) {
+            $links = array_slice($links, 0, $limit);
         }
 
-        // Retrieve webpage
-        $pageUrl = self::URI . (empty($topic) ? 'news/' : $topic . '/');
-        $html = getSimpleHTMLDOM($pageUrl);
+        if (empty($links)) {
+            returnClientError('Failed to retrieve article list');
+        }
 
-        // Process articles
-        foreach ($html->find('div.assetBody, div.riverPost') as $element) {
-            if (count($this->items) >= 10) {
-                break;
-            }
+        foreach ($links as $article_uri) {
+            $article_dom = convertLazyLoading(getSimpleHTMLDOMCached($article_uri));
+            $title = trim($article_dom->find('h1', 0)->plaintext);
+            $author = $article_dom->find('span.c-assetAuthor_name', 0)->plaintext;
+            $headline = $article_dom->find('p.c-contentHeader_description', 0);
+            $content = $article_dom->find('div.c-pageArticle_content, div.single-article__content, div.article-main-body', 0);
+            $date = null;
+            $enclosure = null;
 
-            $article_title = trim($element->find('h2, h3', 0)->plaintext);
-            $article_uri = self::URI . substr($element->find('a', 0)->href, 1);
-            $article_thumbnail = $element->parent()->find('img[src]', 0)->src;
-            $article_timestamp = strtotime($element->find('time.assetTime, div.timeAgo', 0)->plaintext);
-            $article_author = trim($element->find('a[rel=author], a.name', 0)->plaintext);
-            $article_content = '<p><b>' . trim($element->find('p.dek', 0)->plaintext) . '</b></p>';
-
-            if (is_null($article_thumbnail)) {
-                $article_thumbnail = extractFromDelimiters($element->innertext, '<img src="', '"');
-            }
-
-            if (!empty($article_title) && !empty($article_uri) && strpos($article_uri, self::URI . 'news/') !== false) {
-                $article_html = getSimpleHTMLDOMCached($article_uri) or $article_html = null;
-
-                if (!is_null($article_html)) {
-                    if (empty($article_thumbnail)) {
-                        $article_thumbnail = $article_html->find('div.originalImage', 0);
-                    }
-                    if (empty($article_thumbnail)) {
-                        $article_thumbnail = $article_html->find('span.imageContainer', 0);
-                    }
-                    if (is_object($article_thumbnail)) {
-                        $article_thumbnail = $article_thumbnail->find('img', 0)->src;
-                    }
-
-                    $article_content .= trim(
-                        $this->cleanArticle(
-                            extractFromDelimiters(
-                                $article_html,
-                                '<article',
-                                '<footer'
-                            )
-                        )
-                    );
+            foreach ($article_dom->find('script[type=application/ld+json]') as $ldjson) {
+                $datePublished = extractFromDelimiters($ldjson->innertext, '"datePublished":"', '"');
+                if ($datePublished !== false) {
+                    $date = strtotime($datePublished);
+                }
+                $imageObject = extractFromDelimiters($ldjson->innertext, 'ImageObject","url":"', '"');
+                if ($imageObject !== false) {
+                    $enclosure = $imageObject;
                 }
-
-                $item = [];
-                $item['uri'] = $article_uri;
-                $item['title'] = $article_title;
-                $item['author'] = $article_author;
-                $item['timestamp'] = $article_timestamp;
-                $item['enclosures'] = [$article_thumbnail];
-                $item['content'] = $article_content;
-                $this->items[] = $item;
             }
+
+            foreach ($content->find('div.c-shortcodeGallery') as $cleanup) {
+                $cleanup->outertext = '';
+            }
+
+            foreach ($content->find('figure') as $figure) {
+                $img = $figure->find('img', 0);
+                if ($img) {
+                    $figure->outertext = $img->outertext;
+                }
+            }
+
+            $content = $content->innertext;
+
+            if ($enclosure) {
+                $content = "<div><img src=\"$enclosure\" /></div>" . $content;
+            }
+
+            if ($headline) {
+                $content = '<p><b>' . $headline->plaintext . '</b></p><br />' . $content;
+            }
+
+            $item = [];
+            $item['uri'] = $article_uri;
+            $item['title'] = $title;
+            $item['author'] = $author;
+            $item['content'] = $content;
+
+            if (!is_null($date)) {
+                $item['timestamp'] = $date;
+            }
+
+            if (!is_null($enclosure)) {
+                $item['enclosures'] = [$enclosure];
+            }
+
+            $this->items[] = $item;
         }
     }
 }
diff --git a/bridges/SitemapBridge.php b/bridges/SitemapBridge.php
index bdf662ee..bbbb3e16 100644
--- a/bridges/SitemapBridge.php
+++ b/bridges/SitemapBridge.php
@@ -131,7 +131,7 @@ class SitemapBridge extends CssSelectorBridge
         foreach ($sitemap->find('sitemap') as $nested_sitemap) {
             $url = $nested_sitemap->find('loc');
             if (!empty($url)) {
-                $url = $url[0]->plaintext;
+                $url = trim($url[0]->plaintext);
                 if (str_ends_with(strtolower($url), '.xml')) {
                     $nested_sitemap_xml = $this->getSitemapXml($url, true);
                     $nested_sitemap_links = $this->sitemapXmlToList($nested_sitemap_xml, $url_pattern, null, true);
@@ -148,8 +148,8 @@ class SitemapBridge extends CssSelectorBridge
             $url = $item->find('loc');
             $lastmod = $item->find('lastmod');
             if (!empty($url) && !empty($lastmod)) {
-                $url = $url[0]->plaintext;
-                $lastmod = $lastmod[0]->plaintext;
+                $url = trim($url[0]->plaintext);
+                $lastmod = trim($lastmod[0]->plaintext);
                 $timestamp = strtotime($lastmod);
                 if (empty($url_pattern) || preg_match('/' . $url_pattern . '/', $url) === 1) {
                     $links[$url] = $timestamp;

From 658391263ebdbd8614cefeb63eb43e3ea521e5b6 Mon Sep 17 00:00:00 2001
From: Teemu Ikonen <tpikonen@gmail.com>
Date: Thu, 19 Oct 2023 18:02:53 +0300
Subject: [PATCH 185/716] Add 'itunes:duration' tag for items with duration
 (#3774)

* [{Atom,Mrss}Format] Allow itunes tags on items without enclosure

* [Arte7Bridge] Add $item['itunes']['duration'] value
---
 bridges/Arte7Bridge.php |  4 ++++
 formats/AtomFormat.php  | 12 +++++++-----
 formats/MrssFormat.php  | 12 +++++++-----
 3 files changed, 18 insertions(+), 10 deletions(-)

diff --git a/bridges/Arte7Bridge.php b/bridges/Arte7Bridge.php
index 239fc6ad..5898e881 100644
--- a/bridges/Arte7Bridge.php
+++ b/bridges/Arte7Bridge.php
@@ -156,6 +156,10 @@ class Arte7Bridge extends BridgeAbstract
             . $element['mainImage']['url']
             . '" /></a>';
 
+            $item['itunes'] = [
+                'duration' => $durationSeconds,
+            ];
+
             $this->items[] = $item;
         }
     }
diff --git a/formats/AtomFormat.php b/formats/AtomFormat.php
index d59e42fe..07ca7272 100644
--- a/formats/AtomFormat.php
+++ b/formats/AtomFormat.php
@@ -147,11 +147,13 @@ class AtomFormat extends FormatAbstract
                     $entry->appendChild($itunesProperty);
                     $itunesProperty->appendChild($document->createTextNode($itunesValue));
                 }
-                $itunesEnclosure = $document->createElement('enclosure');
-                $entry->appendChild($itunesEnclosure);
-                $itunesEnclosure->setAttribute('url', $itemArray['enclosure']['url']);
-                $itunesEnclosure->setAttribute('length', $itemArray['enclosure']['length']);
-                $itunesEnclosure->setAttribute('type', $itemArray['enclosure']['type']);
+                if (isset($itemArray['enclosure'])) {
+                    $itunesEnclosure = $document->createElement('enclosure');
+                    $entry->appendChild($itunesEnclosure);
+                    $itunesEnclosure->setAttribute('url', $itemArray['enclosure']['url']);
+                    $itunesEnclosure->setAttribute('length', $itemArray['enclosure']['length']);
+                    $itunesEnclosure->setAttribute('type', $itemArray['enclosure']['type']);
+                }
             } elseif (!empty($entryUri)) {
                 $entryLinkAlternate = $document->createElement('link');
                 $entry->appendChild($entryLinkAlternate);
diff --git a/formats/MrssFormat.php b/formats/MrssFormat.php
index 4fd06439..5b96a6a7 100644
--- a/formats/MrssFormat.php
+++ b/formats/MrssFormat.php
@@ -135,11 +135,13 @@ class MrssFormat extends FormatAbstract
                     $entry->appendChild($itunesProperty);
                     $itunesProperty->appendChild($document->createTextNode($itunesValue));
                 }
-                $itunesEnclosure = $document->createElement('enclosure');
-                $entry->appendChild($itunesEnclosure);
-                $itunesEnclosure->setAttribute('url', $itemArray['enclosure']['url']);
-                $itunesEnclosure->setAttribute('length', $itemArray['enclosure']['length']);
-                $itunesEnclosure->setAttribute('type', $itemArray['enclosure']['type']);
+                if (isset($itemArray['enclosure'])) {
+                    $itunesEnclosure = $document->createElement('enclosure');
+                    $entry->appendChild($itunesEnclosure);
+                    $itunesEnclosure->setAttribute('url', $itemArray['enclosure']['url']);
+                    $itunesEnclosure->setAttribute('length', $itemArray['enclosure']['length']);
+                    $itunesEnclosure->setAttribute('type', $itemArray['enclosure']['type']);
+                }
             } if (!empty($itemUri)) {
                 $entryLink = $document->createElement('link');
                 $entry->appendChild($entryLink);

From 8ff39f64f7554de110cb4296e199789d9fa7f5a8 Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Fri, 20 Oct 2023 13:31:52 +0200
Subject: [PATCH 186/716] [html] add data-orig-file tag (#3777)

Add support for data-orig-file tag in convertLazyLoading()
Remplace end() with array_key_last() as discussed in #3769
Fix typo in comment
---
 lib/html.php | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/lib/html.php b/lib/html.php
index ba8067a6..1de581d9 100644
--- a/lib/html.php
+++ b/lib/html.php
@@ -249,7 +249,7 @@ function convertLazyLoading($dom)
     // Example: convert "header640.png 640w, header960.png 960w, header1024.png 1024w" to "header1024.png"
     $srcset_to_src = function ($srcset) {
         $sources = explode(',', $srcset);
-        $last_entry = trim(end($sources));
+        $last_entry = trim($sources[array_key_last($sources)]);
         $url = explode(' ', $last_entry)[0];
         return $url;
     };
@@ -262,12 +262,15 @@ function convertLazyLoading($dom)
             $img->src = $srcset_to_src($img->getAttribute('data-srcset'));
         } elseif (!empty($img->getAttribute('data-lazy-src'))) {
             $img->src = $img->getAttribute('data-lazy-src');
+        } elseif (!empty($img->getAttribute('data-orig-file'))) {
+            $img->src = $img->getAttribute('data-orig-file');
         } elseif (!empty($img->getAttribute('srcset'))) {
             $img->src = $srcset_to_src($img->getAttribute('srcset'));
         } else {
             continue; // Proceed to next element without removing attributes
         }
-        foreach (['loading', 'decoding', 'srcset', 'data-src', 'data-srcset'] as $attr) {
+        // Remove attributes that may be processed by the client (data-* are not)
+        foreach (['loading', 'decoding', 'srcset'] as $attr) {
             if ($img->hasAttribute($attr)) {
                 $img->removeAttribute($attr);
             }
@@ -284,7 +287,7 @@ function convertLazyLoading($dom)
                 $img->tag = 'img';
             }
             // Adding/removing node would change its position inside the parent element,
-            // So instead we rewrite the node in-place though the outertext attribute
+            // So instead we rewrite the node in-place through the outertext attribute
             $picture->outertext = $img->outertext;
         }
     }

From 4f7451895bf888e465a9879c466d4067a8c4a17f Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Fri, 20 Oct 2023 13:33:07 +0200
Subject: [PATCH 187/716] Fix: content.php: last-modified/if-unmodified-since
 (#3771) (#3772)

* Fix: content.php: last-modified/if-unmodified-since (#3771)

Fix exception if server sent invalid Last-Modified header
Add support for Unix time instead of standard date string
Send back standard RFC7231 date string instead of Unix time

* Fix: content.php: if-unmodified-since: cURL API

Use getTimestamp() as cURL expects that and will format the If-Modified-Since header appropriately.
---
 lib/contents.php | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/lib/contents.php b/lib/contents.php
index a3830ca7..055d6bf3 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -63,8 +63,13 @@ function getContents(
     if ($cachedResponse) {
         $cachedLastModified = $cachedResponse->getHeader('last-modified');
         if ($cachedLastModified) {
-            $cachedLastModified = new \DateTimeImmutable($cachedLastModified);
-            $config['if_not_modified_since'] = $cachedLastModified->getTimestamp();
+            try {
+                // Some servers send Unix timestamp instead of RFC7231 date. Prepend it with @ to allow parsing as DateTime
+                $cachedLastModified = new \DateTimeImmutable((is_numeric($cachedLastModified) ? '@' : '') . $cachedLastModified);
+                $config['if_not_modified_since'] = $cachedLastModified->getTimestamp();
+            } catch (Exception $dateTimeParseFailue) {
+                // Ignore invalid 'Last-Modified' HTTP header value
+            }
         }
     }
 

From 4722201281f3e62c3f8067d2721e4b771a6ba5e0 Mon Sep 17 00:00:00 2001
From: Manu <3916435+m3nu@users.noreply.github.com>
Date: Fri, 20 Oct 2023 19:29:28 +0100
Subject: [PATCH 188/716] Add one-click install to PikaPods (#3778)

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index 7037095e..570fb87d 100644
--- a/README.md
+++ b/README.md
@@ -154,6 +154,7 @@ Browse http://localhost:3000/
 [![Deploy on Scalingo](https://cdn.scalingo.com/deploy/button.svg)](https://my.scalingo.com/deploy?source=https://github.com/sebsauvage/rss-bridge)
 [![Deploy to Heroku](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)
 [![Deploy to Cloudron](https://cloudron.io/img/button.svg)](https://www.cloudron.io/store/com.rssbridgeapp.cloudronapp.html)
+[![Run on PikaPods](https://www.pikapods.com/static/run-button.svg)](https://www.pikapods.com/pods?run=rssbridge)
 
 The Heroku quick deploy currently does not work. It might possibly work if you fork this repo and
 modify the `repository` in `scalingo.json`. See https://github.com/RSS-Bridge/rss-bridge/issues/2688

From a6a450220991a42f34b3dfa3219b0cafbaba11eb Mon Sep 17 00:00:00 2001
From: mruac <ant8672@gmail.com>
Date: Sat, 21 Oct 2023 20:24:50 +1030
Subject: [PATCH 189/716] [Itaku] extend the number of images shown in a post
 (#3780)

* minor fixes

- extended itaku post if post does not have all images

* phpcbf

* .

* resolve deprecated explode param

yay null coalesces
---
 bridges/ItakuBridge.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/bridges/ItakuBridge.php b/bridges/ItakuBridge.php
index 62a130ff..149757f5 100644
--- a/bridges/ItakuBridge.php
+++ b/bridges/ItakuBridge.php
@@ -201,7 +201,7 @@ class ItakuBridge extends BridgeAbstract
                 'rating_e' => $this->getInput('rating_e')
             ];
 
-            $tag_arr = explode(' ', $this->getInput('tags'));
+            $tag_arr = explode(' ', $this->getInput('tags') ?? '');
             foreach ($tag_arr as $str) {
                 switch ($str[0]) {
                     case '-':
@@ -446,6 +446,9 @@ class ItakuBridge extends BridgeAbstract
 
     private function getPost($id, array $metadata = null)
     {
+        if (isset($metadata) && sizeof($metadata['gallery_images']) < $metadata['num_images']) {
+            $metadata = null; //force re-fetch of metadata
+        }
         $uri = self::URI . '/posts/' . $id;
         $url = self::URI . '/api/posts/' . $id . '/?format=json';
         $data = $metadata ?? $this->getData($url, true, true)

From f134808a268065e5000ef694149f62bb0f263b16 Mon Sep 17 00:00:00 2001
From: Park0 <Park0@users.noreply.github.com>
Date: Sun, 22 Oct 2023 17:36:36 +0200
Subject: [PATCH 190/716] Marktplaats categories added (#3761)

* Update MarktplaatsBridge.php

* Update MarktplaatsBridge.php only main categories

As the whole list is too big only main categories are used for now.

* Renamed parameter 2 to sc

Renamed unused method to better reflect it usage

* Update MarktplaatsBridge.php Several fixed

Categories completed
Added a default empty one
Check if the input is not empty before using
Added helper methods to generate the categorylist

* Update MarktplaatsBridge.php

Set the methods to private for the CI
---
 bridges/MarktplaatsBridge.php | 143 +++++++++++++++++++++++++++++++++-
 1 file changed, 139 insertions(+), 4 deletions(-)

diff --git a/bridges/MarktplaatsBridge.php b/bridges/MarktplaatsBridge.php
index 70a369d9..6ba993e7 100644
--- a/bridges/MarktplaatsBridge.php
+++ b/bridges/MarktplaatsBridge.php
@@ -14,6 +14,51 @@ class MarktplaatsBridge extends BridgeAbstract
                 'required' => true,
                 'title' => 'The search string for marktplaats',
             ],
+            'c' => [
+                'name' => 'Category',
+                'type' => 'list',
+                'values' => [
+                    'Select a category' => '',
+                    'Antiek en Kunst' => '1',
+                    'Audio, Tv en Foto' => '31',
+                    'Auto&#x27;s' => '91',
+                    'Auto-onderdelen' => '2600',
+                    'Auto diversen' => '48',
+                    'Boeken' => '201',
+                    'Caravans en Kamperen' => '289',
+                    'Cd&#x27;s en Dvd&#x27;s' => '1744',
+                    'Computers en Software' => '322',
+                    'Contacten en Berichten' => '378',
+                    'Diensten en Vakmensen' => '1098',
+                    'Dieren en Toebehoren' => '395',
+                    'Doe-het-zelf en Verbouw' => '239',
+                    'Fietsen en Brommers' => '445',
+                    'Hobby en Vrije tijd' => '1099',
+                    'Huis en Inrichting' => '504',
+                    'Huizen en Kamers' => '1032',
+                    'Kinderen en Baby&#x27;s' => '565',
+                    'Kleding | Dames' => '621',
+                    'Kleding | Heren' => '1776',
+                    'Motoren' => '678',
+                    'Muziek en Instrumenten' => '728',
+                    'Postzegels en Munten' => '1784',
+                    'Sieraden, Tassen en Uiterlijk' => '1826',
+                    'Spelcomputers en Games' => '356',
+                    'Sport en Fitness' => '784',
+                    'Telecommunicatie' => '820',
+                    'Tickets en Kaartjes' => '1984',
+                    'Tuin en Terras' => '1847',
+                    'Vacatures' => '167',
+                    'Vakantie' => '856',
+                    'Verzamelen' => '895',
+                    'Watersport en Boten' => '976',
+                    'Witgoed en Apparatuur' => '537',
+                    'Zakelijke goederen' => '1085',
+                    'Diversen' => '428',
+                ],
+                'required' => false,
+                'title' => 'The category to search in',
+            ],
             'z' => [
                 'name' => 'zipcode',
                 'type' => 'text',
@@ -57,7 +102,15 @@ class MarktplaatsBridge extends BridgeAbstract
                 'type' => 'checkbox',
                 'required' => false,
                 'title' => 'Include the raw data behind the content',
-            ]
+            ],
+            'sc' => [
+                'name' => 'Sub category',
+                'type' => 'number',
+                'required' => false,
+                'exampleValue' => '12345',
+                'title' => 'Sub category has to be given by id as the list is too big to show here. 
+                            Only use subcategories that belong to the main category. Both have to be correct',
+            ],
         ]
     ];
     const CACHE_TIMEOUT = 900;
@@ -80,6 +133,12 @@ class MarktplaatsBridge extends BridgeAbstract
                 $excludeGlobal = true;
             }
         }
+        if (!empty($this->getInput('c'))) {
+            $query .= '&l1CategoryId=' . $this->getInput('c');
+        }
+        if (!is_null($this->getInput('sc'))) {
+            $query .= '&l2CategoryId=' . $this->getInput('sc');
+        }
         $url = 'https://www.marktplaats.nl/lrp/api/search?query=' . urlencode($this->getInput('q')) . $query;
         $jsonString = getSimpleHTMLDOM($url);
         $jsonObj = json_decode($jsonString);
@@ -97,15 +156,15 @@ class MarktplaatsBridge extends BridgeAbstract
                     $item['enclosures'] = $listing->imageUrls;
                     if (is_array($listing->imageUrls)) {
                         foreach ($listing->imageUrls as $imgurl) {
-                            $item['content'] .= "<br />\n<img src='https:" . $imgurl . "' />";
+                            $item['content'] .= "<br />\n<img alt='' src='https:" . $imgurl . "' />";
                         }
                     } else {
-                        $item['content'] .= "<br>\n<img src='https:" . $listing->imageUrls . "' />";
+                        $item['content'] .= "<br>\n<img alt='' src='https:" . $listing->imageUrls . "' />";
                     }
                 }
                 if (!is_null($this->getInput('r'))) {
                     if ($this->getInput('r')) {
-                        $item['content'] .= "<br />\n<br />\n<br />\n" . json_encode($listing);
+                        $item['content'] .= "<br />\n<br />\n<br />\n" . json_encode($listing) . "<br />$url";
                     }
                 }
                 $item['content'] .= "<br>\n<br>\nPrice: " . $listing->priceInfo->priceCents / 100;
@@ -130,4 +189,80 @@ class MarktplaatsBridge extends BridgeAbstract
         }
         return parent::getName();
     }
+
+    /**
+     * Method can be used to scrape the subcategories from marktplaats
+     */
+    private static function scrapeSubCategories()
+    {
+        $main = [];
+        $main['Select a category'] = '';
+        $marktplaatsHTML = file_get_html('https://www.marktplaats.nl');
+        foreach ($marktplaatsHTML->find('select[id=categoryId] option') as $opt) {
+            if (!str_contains($opt->innertext, 'categorie')) {
+                $main[$opt->innertext] = $opt->value;
+                $ids[] = $opt->value;
+            }
+        }
+
+        $result = [];
+        foreach ($ids as $id) {
+            $url = 'https://www.marktplaats.nl/lrp/api/search?l1CategoryId=' . $id;
+            $jsonstring = getContents($url);
+            $jsondata = json_decode((string)$jsonstring);
+            if (isset($jsondata->searchCategoryOptions)) {
+                $categories = $jsondata->searchCategoryOptions;
+                if (isset($jsondata->categoriesById->$id)) {
+                    $maincategory = $jsondata->categoriesById->$id;
+                    $array = [];
+                    foreach ($categories as $categorie) {
+                        $array[$categorie->fullName] = $categorie->id;
+                    }
+                    $result[$maincategory->fullName] = $array;
+                }
+            } else {
+                print($jsonstring);
+            }
+        }
+        $combinedResult = [
+            'main' => $main,
+            'sub' => $result
+        ];
+        return $combinedResult;
+    }
+
+    /**
+     * Helper method to construct the array that could be used for categories
+     *
+     * @param $array
+     * @param $indent
+     * @return void
+     */
+    private static function printArrayAsCode($array, $indent = 0)
+    {
+        foreach ($array as $key => $value) {
+            if (is_array($value)) {
+                echo str_repeat('    ', $indent) . "'$key' => [" . PHP_EOL;
+                self::printArrayAsCode($value, $indent + 1);
+                echo str_repeat('    ', $indent) . '],' . PHP_EOL;
+            } else {
+                $value = str_replace('\'', '\\\'', $value);
+                $key = str_replace('\'', '\\\'', $key);
+                echo str_repeat('    ', $indent) . "'$key' => '$value'," . PHP_EOL;
+            }
+        }
+    }
+
+    private static function printScrapeArray()
+    {
+        $array = (MarktplaatsBridge::scrapeSubCategories());
+
+        echo '$myArray = [' . PHP_EOL;
+        self::printArrayAsCode($array['main'], 1);
+        echo '];' . PHP_EOL;
+
+        echo '$myArray = [' . PHP_EOL;
+        self::printArrayAsCode($array['sub'], 1);
+        echo '];' . PHP_EOL;
+    }
 }

From d4e4c3e89ac148d4943c8c1669322649e1d0ae7b Mon Sep 17 00:00:00 2001
From: Ryan Stafford <ryan@nanorex.net>
Date: Mon, 23 Oct 2023 17:12:05 -0400
Subject: [PATCH 191/716] [FarsideNitterBridge] New twitter bridge (#3781)

* [FarsideNitterBridge] New twitter bridge

* example value

* lint fix
---
 bridges/FarsideNitterBridge.php | 103 ++++++++++++++++++++++++++++++++
 1 file changed, 103 insertions(+)
 create mode 100644 bridges/FarsideNitterBridge.php

diff --git a/bridges/FarsideNitterBridge.php b/bridges/FarsideNitterBridge.php
new file mode 100644
index 00000000..b167347a
--- /dev/null
+++ b/bridges/FarsideNitterBridge.php
@@ -0,0 +1,103 @@
+<?php
+
+class FarsideNitterBridge extends FeedExpander
+{
+    const NAME = 'Farside Nitter Bridge';
+    const DESCRIPTION = "Returns an user's recent tweets";
+    const URI = 'https://farside.link/nitter/';
+    const HOST = 'https://twitter.com/';
+    const MAX_RETRIES = 3;
+    const PARAMETERS = [
+        [
+            'username' => [
+                'name' => 'username',
+                'required' => true,
+                'exampleValue' => 'NASA'
+            ],
+            'noreply' => [
+                'name' => 'Without replies',
+                'type' => 'checkbox',
+                'title' => 'Only return initial tweets'
+            ],
+            'noretweet' => [
+                'name' => 'Without retweets',
+                'required' => false,
+                'type' => 'checkbox',
+                'title' => 'Hide retweets'
+            ],
+            'linkbacktotwitter' => [
+                'name' => 'Link back to twitter',
+                'required' => false,
+                'type' => 'checkbox',
+                'title' => 'Rewrite links back to twitter.com'
+            ]
+        ],
+    ];
+
+    public function detectParameters($url)
+    {
+        if (preg_match('/^(https?:\/\/)?(www\.)?(nitter\.net|twitter\.com)\/([^\/?\n]+)/', $url, $matches) > 0) {
+            return [
+                'username' => $matches[4],
+                'noreply' => true,
+                'noretweet' => true,
+                'linkbacktotwitter' => true
+            ];
+        }
+        return null;
+    }
+
+    public function collectData()
+    {
+        $this->getRSS();
+    }
+
+    private function getRSS($attempt = 0)
+    {
+        try {
+            $this->collectExpandableDatas(self::URI . $this->getInput('username') . '/rss');
+        } catch (\Exception $e) {
+            if ($attempt >= self::MAX_RETRIES) {
+                throw $e;
+            } else {
+                $this->getRSS($attempt++);
+            }
+        }
+    }
+
+    protected function parseItem(array $item)
+    {
+        if ($this->getInput('noreply') && substr($item['title'], 0, 5) == 'R to ') {
+            return;
+        }
+        if ($this->getInput('noretweet') && substr($item['title'], 0, 6) == 'RT by ') {
+            return;
+        }
+        $item['title'] = truncate($item['title']);
+        if (preg_match('/(\/status\/.+)/', $item['uri'], $matches) > 0) {
+            if ($this->getInput('linkbacktotwitter')) {
+                $item['uri'] = self::HOST . $this->getInput('username') . $matches[1];
+            } else {
+                $item['uri'] = self::URI . $this->getInput('username') . $matches[1];
+            }
+        }
+        return $item;
+    }
+
+    public function getName()
+    {
+        if (preg_match('/(.+) \//', parent::getName(), $matches) > 0) {
+            return $matches[1];
+        }
+        return parent::getName();
+    }
+
+    public function getURI()
+    {
+        if ($this->getInput('linkbacktotwitter')) {
+            return self::HOST . $this->getInput('username');
+        } else {
+            return self::URI . $this->getInput('username');
+        }
+    }
+}

From cee25d862d71a1f2484135f31b0bbbd5017fcd8d Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Tue, 24 Oct 2023 19:57:25 +0200
Subject: [PATCH 192/716] [html] clean data attributes (#3782)

Some feed readers had difficulties with attributes containing html tags
---
 lib/html.php | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/lib/html.php b/lib/html.php
index 1de581d9..d65d1b20 100644
--- a/lib/html.php
+++ b/lib/html.php
@@ -269,7 +269,15 @@ function convertLazyLoading($dom)
         } else {
             continue; // Proceed to next element without removing attributes
         }
-        // Remove attributes that may be processed by the client (data-* are not)
+
+        // Remove data attributes, no longer necessary
+        foreach ($img->getAllAttributes() as $attr => $val) {
+            if (str_starts_with($attr, 'data-')) {
+                $img->removeAttribute($attr);
+            }
+        }
+
+        // Remove other attributes that may be processed by the client
         foreach (['loading', 'decoding', 'srcset'] as $attr) {
             if ($img->hasAttribute($attr)) {
                 $img->removeAttribute($attr);

From 1dabd10e25ca6ac1ab7cd19742707380104d2642 Mon Sep 17 00:00:00 2001
From: Niehztog <Niehztog@users.noreply.github.com>
Date: Mon, 30 Oct 2023 11:47:25 +0100
Subject: [PATCH 193/716] [NintendoBridge] Add new bridge (#3784)

* Adds new NintendoBridge

* fix item uids, fix feed title

* fix feed icon, adds item categories

* fix feed source uri

* make currentCatgory property nullable

* fix linter errors

* fix linter errors

* attempt to fix unit tests by assigning default category
---
 bridges/NintendoBridge.php | 466 +++++++++++++++++++++++++++++++++++++
 1 file changed, 466 insertions(+)
 create mode 100644 bridges/NintendoBridge.php

diff --git a/bridges/NintendoBridge.php b/bridges/NintendoBridge.php
new file mode 100644
index 00000000..34550737
--- /dev/null
+++ b/bridges/NintendoBridge.php
@@ -0,0 +1,466 @@
+<?php
+
+class NintendoBridge extends XPathAbstract
+{
+    const NAME = 'Nintendo Software Updates';
+    const URI = 'https://www.nintendo.co.uk/Support/Welcome-to-Nintendo-Support-11593.html';
+    const DONATION_URI = '';
+    const DESCRIPTION = self::NAME;
+    const MAINTAINER = 'Niehztog';
+    const PARAMETERS = [
+        '' => [
+            'category' => [
+                'name' => 'Category',
+                'type' => 'list',
+                'values' => [
+                    'All' => 'all',
+                    'Mario Kart 8 Deluxe' => 'mk8d',
+                    'Splatoon 2' => 's2',
+                    'Super Mario 3D All-Stars' => 'sm3as',
+                    'Super Mario 3D World + Bowser’s Fury' => 'sm3wbf',
+                    'Super Mario Maker 2' => 'smm2',
+                    'Super Mario Odyssey' => 'smo',
+                    'Super Smash Bros. Ultimate' => 'ssbu',
+                    'Switch Firmware' => 'sf',
+                    'The Legend of Zelda: Link’s Awakening' => 'tlozla',
+                    'The Legend of Zelda: Skyward Sword HD' => 'tlozss',
+                    'The Legend of Zelda: Tears of the Kingdom' => 'tloztotk',
+                    'Xenoblade Chronicles 2' => 'xc2',
+                ],
+                'defaultValue' => 'mk8d',
+                'title' => 'Select category'
+            ],
+            'country' => [
+                'name' => 'Country',
+                'type' => 'list',
+                'values' => [
+                    'België' => 'be/nl',
+                    'Belgique' => 'be/fr',
+                    'Deutschland' => 'de',
+                    'España' => 'es',
+                    'France' => 'fr',
+                    'Italia' => 'it',
+                    'Nederland' => 'nl',
+                    'Österreich' => 'at',
+                    'Portugal' => 'pt',
+                    'Schweiz' => 'ch/de',
+                    'Suisse' => 'ch/fr',
+                    'Svizzera' => 'ch/it',
+                    'UK & Ireland' => 'co.uk',
+                    'South Africa' => 'co.za'
+                ],
+                'defaultValue' => 'co.uk',
+                'title' => 'Select your country'
+            ]
+        ]
+    ];
+
+    const CACHE_TIMEOUT = 3600;
+
+    const FEED_SOURCE_URL = [
+        'mk8d' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/Game-Updates/How-to-Update-Mario-Kart-8-Deluxe-1482895.html',
+        's2' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/Game-Updates/How-to-Update-Splatoon-2-1482897.html',
+        'sm3as' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/Game-Updates/How-to-Update-Super-Mario-3D-All-Stars-1844226.html',
+        'sm3wbf' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/Game-Updates/How-to-Update-Super-Mario-3D-World-Bowser-s-Fury-1920668.html',
+        'smm2' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/Game-Updates/How-to-Update-Super-Mario-Maker-2-1586745.html',
+        'smo' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/Game-Updates/How-to-Update-Super-Mario-Odyssey-1482901.html',
+        'ssbu' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/Game-Updates/How-to-Update-Super-Smash-Bros-Ultimate-1484130.html',
+        'sf' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/System-Updates/Nintendo-Switch-System-Updates-and-Change-History-1445507.html',
+        'tlozla' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/Game-Updates/How-to-Update-The-Legend-of-Zelda-Link-s-Awakening-1666739.html',
+        'tlozss' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/Game-Updates/How-to-Update-The-Legend-of-Zelda-Skyward-Sword-HD-2022801.html',
+        'tloztotk' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/Game-Updates/How-to-Update-The-Legend-of-Zelda-Tears-of-the-Kingdom-2388231.html',
+        'xc2' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/Game-Updates/Xenoblade-Chronicles-2-Update-History-1482911.html',
+    ];
+    const XPATH_EXPRESSION_ITEM = '//div[@class="col-xs-12 content"]/div[starts-with(@id,"v") and @class="collapse"]';
+    const XPATH_EXPRESSION_ITEM_FIRMWARE = '//div[@id="latest" and @class="collapse" and @rel="1"]';
+    const XPATH_EXPRESSION_ITEM_TITLE = './/h2[1]/node()';
+    const XPATH_EXPRESSION_ITEM_CONTENT = '.';
+    const XPATH_EXPRESSION_ITEM_URI = '//link[@rel="canonical"]/@href';
+
+    //const XPATH_EXPRESSION_ITEM_AUTHOR = '';
+    const XPATH_EXPRESSION_ITEM_TIMESTAMP_PART = 'substring-after(//a[@class="collapse_link collapsed" and @data-target="#{{id_here}}"]/text(), "{{label_here}}")';
+    const XPATH_EXPRESSION_ITEM_TIMESTAMP = 'substring(' . self::XPATH_EXPRESSION_ITEM_TIMESTAMP_PART . ', 1, string-length('
+        . self::XPATH_EXPRESSION_ITEM_TIMESTAMP_PART . ') - 1)';
+
+    //const XPATH_EXPRESSION_ITEM_ENCLOSURES = '';
+    //const XPATH_EXPRESSION_ITEM_CATEGORIES = '';
+    const SETTING_FIX_ENCODING = false;
+    const SETTING_USE_RAW_ITEM_CONTENT = true;
+
+    private const GAME_COUNTRY_DATE_SUBSTRING_PART = [
+        'mk8d' => [
+            'de' => 'eröffentlicht am ',
+            'es' => 'isponible desde el ',
+            'fr' => 'atée du ',
+            'it' => 'ubblicata il ',
+            'nl' => 'itgebracht op ',
+            'pt' => 'ançada no dia ',
+            'en' => 'eleased ',
+        ],
+        's2' => [
+            'de' => 'eröffentlicht am ',
+            'es' => 'isponible desde el ',
+            'fr' => 'atée du ',
+            'it' => 'ubblicata il ',
+            'nl' => 'itgebracht op ',
+            'pt' => 'ançada a ',
+            'en' => 'eleased ',
+        ],
+        'sm3as' => [
+            'de' => 'eröffentlicht am ',
+            'es' => 'isponible desde el ',
+            'fr' => 'ubliée le ',
+            'it' => 'istribuita il ',
+            'nl' => 'itgebracht op ',
+            'pt' => 'ançada a ',
+            'en' => 'eleased ',
+        ],
+        'sm3wbf' => [
+            'de' => 'eröffentlicht am ',
+            'es' => 'isponible desde el ',
+            'fr' => 'atée du ',
+            'it' => 'istribuita il ',
+            'nl' => 'itgebracht op ',
+            'pt' => 'ançada no dia ',
+            'en' => 'eleased ',
+        ],
+        'smm2' => [
+            'de' => 'eröffentlicht am ',
+            'es' => 'isponible desde el ',
+            'fr' => 'ubliée le ',
+            'it' => 'istribuita il ',
+            'nl' => 'itgebracht op ',
+            'pt' => 'ançada no dia ',
+            'en' => 'eleased ',
+        ],
+        'smo' => [
+            'de' => 'eröffentlicht am ',
+            'es' => 'isponible desde el ',
+            'fr' => 'atée du ',
+            'it' => 'istribuita il ',
+            'nl' => 'itgebracht op ',
+            'pt' => 'ançada no dia ',
+            'en' => 'eleased ',
+        ],
+        'ssbu' => [
+            'de' => 'eröffentlicht am ',
+            'es' => 'isponible desde el ',
+            'fr' => 'atée du ',
+            'it' => 'istribuita il ',
+            'nl' => 'itgebracht op ',
+            'pt' => 'ançada no dia ',
+            'en' => 'eleased ',
+        ],
+        'sf' => [
+            'de' => 'eröffentlicht am ',
+            'es' => 'isponible desde el ',
+            'fr' => 'ise en ligne le ',
+            'it' => 'ubblicata il ',
+            'nl' => 'itgebracht op ',
+            'pt' => 'ançada no dia ',
+            'en' => 'istributed ',
+        ],
+        'tlozla' => [
+            'de' => 'eröffentlicht ',
+            'es' => 'ublicada el ',
+            'fr' => 'atée du ',
+            'it' => 'istribuita il ',
+            'nl' => 'itgegeven op ',
+            'pt' => 'ançada a ',
+            'en' => 'eleased ',
+        ],
+        'tlozss' => [
+            'de' => 'eröffentlicht am ',
+            'es' => 'isponible desde el ',
+            'fr' => 'atée du ',
+            'it' => 'ubblicata l\'',
+            'nl' => 'itgebracht op ',
+            'pt' => 'ançada a ',
+            'en' => 'eleased ',
+        ],
+        'tloztotk' => [
+            'de' => 'eröffentlicht am ',
+            'es' => 'isponible desde el ',
+            'fr' => 'ubliée le ',
+            'it' => 'ubblicata il ',
+            'nl' => 'erschenen op ',
+            'pt' => 'ançada a ',
+            'en' => 'eleased ',
+        ],
+        'xc2' => [
+            'de' => 'eröffentlicht am ',
+            'es' => 'isponible desde el ',
+            'fr' => 'atée du ',
+            'it' => 'istribuita il ',
+            'nl' => 'itgebracht op ',
+            'pt' => 'ançada a ',
+            'en' => 'eleased ',
+        ],
+    ];
+
+    private const GAME_COUNTRY_DATE_FORMAT = [
+        'mk8d' => [
+            'de' => 'd.m.y',
+            'es' => 'd-m-y',
+            'fr' => 'd/m/Y',
+            'it' => 'd/m/y',
+            'nl' => 'd m Y',
+            'pt' => 'd/m/y',
+            'en' => 'd/m/y',
+        ],
+        's2' => [
+            'de' => 'd.m.Y',
+            'es' => 'd-m-Y',
+            'fr' => 'd/m/y',
+            'it' => 'd/m/y',
+            'nl' => 'd/m/y',
+            'pt' => 'd/m/y',
+            'en' => 'd F Y',
+        ],
+        'sm3as' => [
+            'de' => 'j. m Y',
+            'es' => 'j \d\e m \d\e Y',
+            'fr' => 'j m Y',
+            'it' => 'j m Y',
+            'nl' => 'j m Y',
+            'pt' => 'j \d\e m \d\e Y',
+            'en' => 'j F Y',
+        ],
+        'sm3wbf' => [
+            'de' => 'd.m.y',
+            'es' => 'd-m-y',
+            'fr' => 'd/m/y',
+            'it' => 'd/m/y',
+            'nl' => 'd m Y',
+            'pt' => 'd/m/y',
+            'en' => 'F j, Y',
+        ],
+        'smm2' => [
+            'de' => 'd.m.Y',
+            'es' => 'd-m-Y',
+            'fr' => 'd/m/Y',
+            'it' => 'd/m/Y',
+            'nl' => 'd m Y',
+            'pt' => 'd/m/y',
+            'en' => 'd/m/y',
+        ],
+        'smo' => [
+            'de' => 'd.m.Y',
+            'es' => 'd-m-Y',
+            'fr' => 'd/m/Y',
+            'it' => 'd/m/y',
+            'nl' => 'd m Y',
+            'pt' => 'd/m/y',
+            'en' => 'd/m/y',
+        ],
+        'ssbu' => [
+            'de' => 'd. m Y',
+            'es' => 'j \d\e m \d\e Y',
+            'fr' => 'j m Y',
+            'it' => 'j m Y',
+            'nl' => 'd m Y',
+            'pt' => 'd/m/Y',
+            'en' => 'j F Y',
+        ],
+        'sf' => [
+            'de' => 'd.m.Y',
+            'es' => 'd-m-y',
+            'fr' => 'd/m/Y',
+            'it' => 'd/m/Y',
+            'nl' => 'd m Y',
+            'pt' => 'd/m/Y',
+            'en' => 'd/m/Y',
+        ],
+        'tlozla' => [
+            'de' => 'd. m Y',
+            'es' => 'j m \d\e Y',
+            'fr' => 'd/m/y',
+            'it' => 'j m Y',
+            'nl' => 'd m Y',
+            'pt' => 'j \d\e m \d\e Y',
+            'en' => 'j F y',
+        ],
+        'tlozss' => [
+            'de' => 'd. m Y',
+            'es' => 'j \d\e m \d\e Y',
+            'fr' => 'd/m/y',
+            'it' => 'j m Y',
+            'nl' => 'd m Y',
+            'pt' => 'j \d\e m \d\e Y',
+            'en' => 'j F Y',
+        ],
+        'tloztotk' => [
+            'de' => 'd. m Y',
+            'es' => 'j \d\e m \d\e Y',
+            'fr' => 'j m Y',
+            'it' => 'j m Y',
+            'nl' => 'd m Y',
+            'pt' => 'j \d\e m \d\e Y',
+            'en' => 'j F Y',
+        ],
+        'xc2' => [
+            'de' => 'd.m.y',
+            'es' => 'd-m-y',
+            'fr' => 'd/m/Y',
+            'it' => 'd/m/y',
+            'nl' => 'd m Y',
+            'pt' => 'd/m/y',
+            'en' => 'd/m/y',
+        ],
+    ];
+
+    private const FOREIGN_MONTH_NAMES = [
+        'nl' => ['01' => 'januari', '02' => 'februari', '03' => 'maart', '04' => 'april', '05' => 'mei', '06' => 'juni', '07' => 'juli', '08' => 'augustus',
+            '09' => 'september', '10' => 'oktober', '11' => 'november', '12' => 'december'],
+        'fr' => ['01' => 'janvier', '02' => 'février', '03' => 'mars', '04' => 'avril', '05' => 'mai', '06' => 'juin', '07' => 'juillet', '08' => 'août',
+            '09' => 'septembre', '10' => 'octobre', '11' => 'novembre', '12' => 'décembre'],
+        'de' => ['01' => 'Januar', '02' => 'Februar', '03' => 'März', '04' => 'April', '05' => 'Mai', '06' => 'Juni', '07' => 'Juli', '08' => 'August',
+            '09' => 'September', '10' => 'Oktober', '11' => 'November', '12' => 'Dezember'],
+        'es' => ['01' => 'enero', '02' => 'febrero', '03' => 'marzo', '04' => 'abril', '05' => 'mayo', '06' => 'junio', '07' => 'julio', '08' => 'agosto',
+            '09' => 'septiembre', '10' => 'octubre', '11' => 'noviembre', '12' => 'diciembre'],
+        'it' => ['01' => 'gennaio', '02' => 'febbraio', '03' => 'marzo', '04' => 'aprile', '05' => 'maggio', '06' => 'giugno', '07' => 'luglio', '08' => 'agosto',
+            '09' => 'settembre', '10' => 'ottobre', '11' => 'novembre', '12' => 'dicembre'],
+        'pt' => ['01' => 'janeiro', '02' => 'fevereiro', '03' => 'março', '04' => 'abril', '05' => 'maio', '06' => 'junho', '07' => 'julho', '08' => 'agosto',
+            '09' => 'setembro', '10' => 'outubro', '11' => 'novembro', '12' => 'dezembro'],
+    ];
+    const LANGUAGE_REWRITE = ['co.uk' => 'en', 'co.za' => 'en', 'at' => 'de'];
+
+    private string $lastId = '';
+    private ?string $currentCategory = '';
+
+    private function getCurrentCategory()
+    {
+        if (empty($this->currentCategory)) {
+            $category = $this->getInput('category');
+            $this->currentCategory = empty($category) ? self::PARAMETERS['']['category']['defaultValue'] : $category;
+        }
+        return $this->currentCategory;
+    }
+
+    public function getIcon()
+    {
+        return 'https://www.nintendo.co.uk/favicon.ico';
+    }
+
+    public function getURI()
+    {
+        $category = $this->getInput('category');
+        return 'all' === $category ? self::URI : $this->getSourceUrl();
+    }
+
+    protected function provideFeedTitle(\DOMXPath $xpath)
+    {
+        $category = $this->getInput('category');
+        $categoryName = array_search($category, self::PARAMETERS['']['category']['values']);
+        return 'all' === $category ? self::NAME : $categoryName . ' Software-Updates';
+    }
+
+    protected function getSourceUrl()
+    {
+        $country = $this->getInput('country');
+        $category = $this->getCurrentCategory();
+        return str_replace(self::PARAMETERS['']['country']['defaultValue'], $country, self::FEED_SOURCE_URL[$category]);
+    }
+
+    protected function getExpressionItem()
+    {
+        $category = $this->getCurrentCategory();
+        return 'sf' === $category ? self::XPATH_EXPRESSION_ITEM_FIRMWARE : self::XPATH_EXPRESSION_ITEM;
+    }
+
+    protected function getExpressionItemTimestamp()
+    {
+        if (empty($this->lastId)) {
+            return null;
+        }
+        $country = $this->getInput('country');
+        $category = $this->getCurrentCategory();
+        $language = $this->getLanguageFromCountry($country);
+        return str_replace(
+            ['{{id_here}}', '{{label_here}}'],
+            [$this->lastId, static::GAME_COUNTRY_DATE_SUBSTRING_PART[$category][$language]],
+            static::XPATH_EXPRESSION_ITEM_TIMESTAMP
+        );
+    }
+
+    protected function getExpressionItemCategories()
+    {
+        $category = $this->getCurrentCategory();
+        $categoryName = array_search($category, self::PARAMETERS['']['category']['values']);
+        return 'string("' . $categoryName . '")';
+    }
+
+    public function collectData()
+    {
+        $category = $this->getCurrentCategory();
+        if ('all' === $category) {
+            $allItems = [];
+            foreach (self::PARAMETERS['']['category']['values'] as $catKey) {
+                if ('all' === $catKey) {
+                    continue;
+                }
+                $this->currentCategory = $catKey;
+                $this->items = [];
+                parent::collectData();
+                $allItems = [...$allItems, ...$this->items];
+            }
+            $this->currentCategory = 'all';
+            $this->items = $allItems;
+        } else {
+            parent::collectData();
+        }
+    }
+
+    protected function formatItemTitle($value)
+    {
+        if (false !== strpos($value, ' (')) {
+            $value = substr($value, 0, strpos($value, ' ('));
+        }
+        if ('all' === $this->getInput('category')) {
+            $category = $this->getCurrentCategory();
+            $categoryName = array_search($category, self::PARAMETERS['']['category']['values']);
+            return $categoryName . ' ' . $value;
+        }
+        return $value;
+    }
+
+    protected function formatItemContent($value)
+    {
+        $result = preg_match('~<div class="collapse" id="([a-z0-9]+)" rel="1">(.*)</div>~', $value, $matches);
+        if (1 === $result) {
+            $this->lastId = $matches[1];
+            return trim($matches[2]);
+        }
+        return $value;
+    }
+
+    protected function formatItemTimestamp($value)
+    {
+        $country = $this->getInput('country');
+        $category = $this->getCurrentCategory();
+        $language = $this->getLanguageFromCountry($country);
+
+        $aMonthNames = self::FOREIGN_MONTH_NAMES[$language] ?? null;
+        if (null !== $aMonthNames) {
+            $value = str_replace(array_values($aMonthNames), array_keys($aMonthNames), $value);
+        }
+        $value = str_replace('­', '-', $value);
+        $value = str_replace('--', '-', $value);
+
+        $date = \DateTime::createFromFormat(self::GAME_COUNTRY_DATE_FORMAT[$category][$language], $value);
+        if (false === $date) {
+            $date = new \DateTime('now');
+        }
+        return $date->getTimestamp();
+    }
+
+    protected function generateItemId(FeedItem $item)
+    {
+        return $this->getCurrentCategory() . '-' . $this->lastId;
+    }
+
+    private function getLanguageFromCountry($country)
+    {
+        return (strpos($country, '/') !== false) ? substr($country, strpos($country, '/') + 1) : (self::LANGUAGE_REWRITE[$country] ?? $country);
+    }
+}

From 8d0ddb579fd4e15ec02ea17a11d4337b19fc2424 Mon Sep 17 00:00:00 2001
From: Evgeny <76707795+itsLameni@users.noreply.github.com>
Date: Fri, 3 Nov 2023 16:42:34 +0000
Subject: [PATCH 194/716] Adding rss.m3wz.su instance to list of public hosts
 (#3789)

---
 docs/01_General/06_Public_Hosts.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/01_General/06_Public_Hosts.md b/docs/01_General/06_Public_Hosts.md
index 9aa292a5..de538cf1 100644
--- a/docs/01_General/06_Public_Hosts.md
+++ b/docs/01_General/06_Public_Hosts.md
@@ -20,6 +20,8 @@
 | ![](https://iplookup.flagfox.net/images/h16/NL.png) | https://feed.eugenemolotov.ru | ![](https://img.shields.io/website/https/feed.eugenemolotov.ru.svg) | [@em92](https://github.com/em92) | Hosted in Amsterdam, Netherlands |
 | ![](https://iplookup.flagfox.net/images/h16/DE.png) | https://rss-bridge.mediani.de | ![](https://img.shields.io/website/https/rss-bridge.mediani.de.svg) | [@sokai](https://github.com/sokai) | Hosted with Netcup, Germany |
 | ![](https://iplookup.flagfox.net/images/h16/PL.png) | https://rss.foxhaven.cyou| ![](https://img.shields.io/badge/website-up-brightgreen) | [@Aysilu](https://foxhaven.cyou) | Hosted with Timeweb (Maintained in Poland) |
+| ![](https://iplookup.flagfox.net/images/h16/PL.png) | https://rss.m3wz.su| ![](https://img.shields.io/badge/website-up-brightgreen) | [@m3oweezed](https://m3wz.su/en/about) | Poland, Hosted with Timeweb Cloud
+
 
 ## Inactive instances
 

From 84b5ffcc7c6ee42d323bb897f61e523127eb7595 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Tue, 7 Nov 2023 05:02:34 +0100
Subject: [PATCH 195/716] [PepperBridgeAbstract] Fix Deal Origin and Shipping
 cost (#3790)

- Deal Origin was changed by the website : fixed the CSS class to get it
- Shipping cost had an extra SVG image in the content : removed the
  whole HTML tags from the content
---
 bridges/PepperBridgeAbstract.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index 5d2e552b..875ed8f6 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -356,11 +356,11 @@ HEREDOC;
         if ($deal->find('span[class*=space--ml-2 size--all-s overflow--wrap-off]', 0) != null) {
             if ($deal->find('span[class*=space--ml-2 size--all-s overflow--wrap-off]', 0)->children(1) != null) {
                 return '<div>' . $this->i8n('shipping') . ' : '
-                    . $deal->find('span[class*=space--ml-2 size--all-s overflow--wrap-off]', 0)->children(1)->innertext
+                    . strip_tags($deal->find('span[class*=space--ml-2 size--all-s overflow--wrap-off]', 0)->children(1)->innertext)
                     . '</div>';
             } else {
                 return '<div>' . $this->i8n('shipping') . ' : '
-                    . $deal->find('span[class*=text--color-greyShade flex--inline]', 0)->innertext
+                    . strip_tags($deal->find('span[class*=text--color-greyShade flex--inline]', 0)->innertext)
                     . '</div>';
             }
         } else {
@@ -376,7 +376,7 @@ HEREDOC;
     {
         if (($origin = $deal->find('button[class*=text--color-greyShade]', 0)) != null) {
             $path = str_replace(' ', '/', trim(Json::decode($origin->{'data-cloak-link'})['path']));
-            $text = $origin->find('span[class*=cept-merchant-name]', 0);
+            $text = $origin->find('span[class*=link]', 0);
             return '<div>' . $this->i8n('origin') . ' : <a href="' . static::URI . $path . '">' . $text . '</a></div>';
         } else {
             return '';

From a6310cff1ab77ebb9be4b9aadbf3f6a007f2b09c Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Tue, 7 Nov 2023 21:32:46 +0100
Subject: [PATCH 196/716] [GreatFonBridge] Add new Instagram Viewer Bridge
 (#3791)

Add a new Instagram Bridge not using Cloudflare DDoS Protection
---
 bridges/GreatFonBridge.php | 140 +++++++++++++++++++++++++++++++++++++
 1 file changed, 140 insertions(+)
 create mode 100644 bridges/GreatFonBridge.php

diff --git a/bridges/GreatFonBridge.php b/bridges/GreatFonBridge.php
new file mode 100644
index 00000000..2951634c
--- /dev/null
+++ b/bridges/GreatFonBridge.php
@@ -0,0 +1,140 @@
+<?php
+
+class GreatFonBridge extends BridgeAbstract
+{
+    const MAINTAINER = 'sysadminstory';
+    const NAME = 'GreatFon Bridge';
+    const URI = 'https://greatfon.com/';
+    const INSTAGRAMURI = 'https://www.instagram.com/';
+    const CACHE_TIMEOUT = 3600; // 1h
+    const DESCRIPTION = 'Returns GreatFon (Instagram viewer) content by user';
+
+    const PARAMETERS = [
+        'Username' => [
+            'u' => [
+                'name' => 'username',
+                'type' => 'text',
+                'title' => 'Instagram username you want to follow',
+                'exampleValue' => 'aesoprockwins',
+                'required' => true,
+            ],
+        ]
+    ];
+    const TEST_DETECT_PARAMETERS = [
+        'https://www.instagram.com/instagram/' => ['context' => 'Username', 'u' => 'instagram'],
+        'https://instagram.com/instagram/' => ['context' => 'Username', 'u' => 'instagram'],
+        'https://greatfon.com/v/instagram' => ['context' => 'Username', 'u' => 'instagram'],
+        'https://www.greatfon.com/v/instagram' => ['context' => 'Username', 'u' => 'instagram'],
+    ];
+
+    public function collectData()
+    {
+        $username = $this->getInput('u');
+        $html = getSimpleHTMLDOMCached(self::URI . '/v/' . $username);
+        $html = defaultLinkTo($html, self::URI);
+
+        foreach ($html->find('div[class*=content__item]') as $post) {
+            // Skip the ads
+            if (!str_contains($post->class, 'ads')) {
+                $url = $post->find('a[href^=https://greatfon.com/c/]', 0)->href;
+                $date = $this->parseDate($post->find('div[class=content__time-text]', 0)->plaintext);
+                $description = $post->find('img', 0)->alt;
+                $imageUrl = $post->find('img', 0)->src;
+                $author = $username;
+                $uid = $url;
+                $title = 'Post - ' . $username . ' - ' . $this->descriptionToTitle($description);
+
+                // Checking post type
+                $isVideo = (bool) $post->find('div[class=content__camera]', 0);
+                $videoNote = $isVideo ? '<p><i>(video)</i></p>' : '';
+
+                $this->items[] = [
+                    'uri'        => $url,
+                    'author'     => $author,
+                    'timestamp'  => $date,
+                    'title'      => $title,
+                    'thumbnail'  => $imageUrl,
+                    'enclosures' => [$imageUrl],
+                    'content'    => <<<HTML
+<a href="{$url}">
+        <img loading="lazy" src="{$imageUrl}" alt="{$description}"/>
+</a>
+{$videoNote}
+<p>{$description}<p>
+HTML,
+                    'uid' => $uid
+                ];
+            }
+        }
+    }
+
+    private function parseDate($content)
+    {
+        // Parse date, and transform the date into a timetamp, even in a case of a relative date
+        $date = date_create();
+
+        // Content trimmed to be sure that the "article" is at the beginning of the string and remove "ago" to make it a valid PHP date interval
+        $dateString = trim(str_replace(' ago', '', $content));
+
+        // Replace the article "an" or "a" by the number "1" to be a valid PHP date interval
+        $dateString = preg_replace('/^((an|a) )/m', '1 ', $dateString);
+
+        $relativeDate = date_interval_create_from_date_string($dateString);
+        if ($relativeDate) {
+            date_sub($date, $relativeDate);
+            // As the relative interval has the precision of a day for date older than 24 hours, we can remove the hour of the date, as it is not relevant
+            date_time_set($date, 0, 0, 0, 0);
+        } else {
+            $this->logger->info(sprintf('Unable to parse date string: %s', $dateString));
+        }
+        return date_format($date, 'r');
+    }
+
+    public function getURI()
+    {
+        if (!is_null($this->getInput('u'))) {
+            return urljoin(self::URI, '/v/' . $this->getInput('u'));
+        }
+
+        return parent::getURI();
+    }
+
+    public function getIcon()
+    {
+        return static::URI . '/images/favicon-hub-3ede543aa6d1225e8dc016ccff6879c8.ico?vsn=d';
+    }
+
+    private function descriptionToTitle($description)
+    {
+        return strlen($description) > 60 ? mb_substr($description, 0, 57) . '...' : $description;
+    }
+
+    public function getName()
+    {
+        if (!is_null($this->getInput('u'))) {
+            return 'Username ' . $this->getInput('u') . ' - GreatFon Bridge';
+        }
+        return parent::getName();
+    }
+
+    public function detectParameters($url)
+    {
+        $regex = '/^http(s|):\/\/((www\.|)(instagram.com)\/([a-zA-Z0-9_\.]{1,30})(\/reels\/|\/tagged\/|\/|)|(www\.|)(greatfon.com)\/v\/([a-zA-Z0-9_\.]{1,30}))/';
+        if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = 'Username';
+            // Extract detected domain using the regex
+            $domain = $matches[8] ?? $matches[4];
+            if ($domain == 'greatfon.com') {
+                $params['u'] = $matches[9];
+                return $params;
+            } elseif ($domain == 'instagram.com') {
+                $params['u'] = $matches[5];
+                return $params;
+            } else {
+                return null;
+            }
+        } else {
+            return null;
+        }
+    }
+}

From 7a7fa876d2a07526f0c57610b3d83c261b99e0ed Mon Sep 17 00:00:00 2001
From: wpdevelopment11 <85058595+wpdevelopment11@users.noreply.github.com>
Date: Wed, 8 Nov 2023 18:40:24 +0300
Subject: [PATCH 197/716] [VkBridge] Fix regex that extracts page name (#3793)

Dot should be allowed in page names.
Precise rules for page names are available here:
https://vk.com/faq19715 (in Russian)
---
 bridges/VkBridge.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/bridges/VkBridge.php b/bridges/VkBridge.php
index 0d47692d..60e4315b 100644
--- a/bridges/VkBridge.php
+++ b/bridges/VkBridge.php
@@ -29,11 +29,12 @@ class VkBridge extends BridgeAbstract
         'https://vk.com/groupname/anythingelse' => ['u' => 'groupname'],
         'https://vk.com/groupname?w=somethingelse' => ['u' => 'groupname'],
         'https://vk.com/with_underscore' => ['u' => 'with_underscore'],
+        'https://vk.com/vk.cats' => ['u' => 'vk.cats'],
     ];
 
     protected $pageName;
     protected $tz = 0;
-    private $urlRegex = '/vk\.com\/([\w]+)/';
+    private $urlRegex = '/vk\.com\/([\w.]+)/';
 
     public function getURI()
     {

From 57b61c8787b7946c674a06e76699baff94931f7e Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Thu, 9 Nov 2023 10:16:34 +0100
Subject: [PATCH 198/716] [MydealsBridge] Fix keyword seatch (#3794)

When no result were found using the keyword search, some random deals
were displayed because the "not found" text has been modified : the
text is now up to date.

Some type in the textual name of the Bridge and texte about the website
name was fixed
---
 bridges/MydealsBridge.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bridges/MydealsBridge.php b/bridges/MydealsBridge.php
index 0ef9c201..de702583 100644
--- a/bridges/MydealsBridge.php
+++ b/bridges/MydealsBridge.php
@@ -2,9 +2,9 @@
 
 class MydealsBridge extends PepperBridgeAbstract
 {
-    const NAME = 'Mydeals bridge';
+    const NAME = 'Mydealz bridge';
     const URI = 'https://www.mydealz.de/';
-    const DESCRIPTION = 'Zeigt die Deals von mydeals.de';
+    const DESCRIPTION = 'Zeigt die Deals von mydealz.de';
     const MAINTAINER = 'sysadminstory';
     const PARAMETERS = [
         'Suche nach Stichworten' => [
@@ -2023,7 +2023,7 @@ class MydealsBridge extends PepperBridgeAbstract
         'uri-deal' => 'deals/',
         'request-error' => 'Could not request mydeals',
         'thread-error' => 'Die ID der Diskussion kann nicht ermittelt werden. Überprüfen Sie die eingegebene URL',
-        'no-results' => 'Ups, wir konnten keine Deals zu',
+        'no-results' => 'Ups, wir konnten nichts',
         'relative-date-indicator' => [
             'vor',
             'seit'

From e76b0601b3312d957b6bf6e46ddeb3df6cd70a01 Mon Sep 17 00:00:00 2001
From: SebLaus <97241865+SebLaus@users.noreply.github.com>
Date: Fri, 10 Nov 2023 12:55:56 +0100
Subject: [PATCH 199/716] [IdealoBridge] New Bridge to track prices on
 idealo.de (#3786)

* [IdealoBridge] Created

Checks the price of a given item on idealo.de. Can create an Alarm Message if a the price is lower than set or an Priceupdate if the price has changed.

* Changed Exec and syntax

* last fixes for remaining warning
---
 bridges/IdealoBridge.php | 180 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 180 insertions(+)
 create mode 100644 bridges/IdealoBridge.php

diff --git a/bridges/IdealoBridge.php b/bridges/IdealoBridge.php
new file mode 100644
index 00000000..89c5f87d
--- /dev/null
+++ b/bridges/IdealoBridge.php
@@ -0,0 +1,180 @@
+<?php
+
+class IdealoBridge extends BridgeAbstract
+{
+    const NAME = 'Idealo.de Bridge';
+    const URI = 'https://www.idealo.de';
+    const DESCRIPTION = 'Tracks the price for a product on idealo.de. Pricealarm if specific price is set';
+    const MAINTAINER = 'SebLaus';
+    const CACHE_TIMEOUT = 60 * 30; // 30 min
+    const PARAMETERS = [
+        [
+            'Link' => [
+                'name'          => 'Idealo.de Link to productpage',
+                'required'      => true,
+                'exampleValue'  => 'https://www.idealo.de/preisvergleich/OffersOfProduct/202007367_-s7-pro-ultra-roborock.html'
+            ],
+            'ExcludeNew' => [
+                'name' => 'Priceupdate: Do not track new items',
+                'type' => 'checkbox',
+                'value' => 'c'
+            ],
+            'ExcludeUsed' => [
+                'name' => 'Priceupdate: Do not track used items',
+                'type' => 'checkbox',
+                'value' => 'uc'
+            ],
+            'MaxPriceNew' => [
+                'name'          => 'Pricealarm: Maximum price for new Product',
+                'type'          => 'number'
+            ],
+            'MaxPriceUsed' => [
+                'name'          => 'Pricealarm: Maximum price for used Product',
+                'type'          => 'number'
+            ],
+        ]
+    ];
+
+    public function getIcon()
+    {
+        return 'https://cdn.idealo.com/storage/ids-assets/ico/favicon.ico';
+    }
+
+    public function collectData()
+    {
+        $link = $this->getInput('Link');
+        $html = getSimpleHTMLDOM($link);
+
+        // Get Productname
+        $titleobj = $html->find('.oopStage-title', 0);
+        $Productname = $titleobj->find('span', 0)->plaintext;
+
+        // Create product specific Cache Keys with the link
+        $KeyNEW = $link;
+        $KeyNEW .= 'NEW';
+
+        $KeyUSED = $link;
+        $KeyUSED .= 'USED';
+
+        // Load previous Price
+        $OldPriceNew = $this->loadCacheValue($KeyNEW);
+        $OldPriceUsed = $this->loadCacheValue($KeyUSED);
+
+        // First button is new. Found at oopStage-conditionButton-wrapper-text class (.)
+        $FirstButton = $html->find('.oopStage-conditionButton-wrapper-text', 0);
+        if ($FirstButton) {
+            $PriceNew = $FirstButton->find('strong', 0)->plaintext;
+        }
+
+        // Second Button is used
+        $SecondButton = $html->find('.oopStage-conditionButton-wrapper-text', 1);
+        if ($SecondButton) {
+            $PriceUsed = $SecondButton->find('strong', 0)->plaintext;
+        }
+
+        // Only continue if a price has changed
+        if ($PriceNew != $OldPriceNew || $PriceUsed != $OldPriceUsed) {
+            // Get Product Image
+            $image = $html->find('.datasheet-cover-image', 0)->src;
+
+            // Generate Content
+            if ($PriceNew > 1) {
+                $content = "<p><b>Price New:</b><br>$PriceNew</p>";
+                $content .= "<p><b>Price Newbefore:</b><br>$OldPriceNew</p>";
+            }
+
+            if ($this->getInput('MaxPriceNew') != '') {
+                $content .= sprintf('<p><b>Max Price Used:</b><br>%s,00 €</p>', $this->getInput('MaxPriceNew'));
+            }
+
+            if ($PriceUsed > 1) {
+                $content .= "<p><b>Price Used:</b><br>$PriceUsed</p>";
+                $content .= "<p><b>Price Used before:</b><br>$OldPriceUsed</p>";
+            }
+
+            if ($this->getInput('MaxPriceUsed') != '') {
+                $content .= sprintf('<p><b>Max Price Used:</b><br>%s,00 €</p>', $this->getInput('MaxPriceUsed'));
+            }
+
+            $content .= "<img src=$image>";
+
+
+            $now = date('d.m.j H:m');
+
+            $Pricealarm = 'Pricealarm %s: %s %s %s';
+
+            // Currently under Max new price
+            if ($this->getInput('MaxPriceNew') != '') {
+                if ($PriceNew < $this->getInput('MaxPriceNew')) {
+                    $title = sprintf($Pricealarm, 'Used', $PriceNew, $Productname, $now);
+                    $item = [
+                        'title'     => $title,
+                        'uri'       => $link,
+                        'content'   => $content,
+                        'uid'       => md5($title)
+                    ];
+                    $this->items[] = $item;
+                }
+            }
+
+            // Currently under Max used price
+            if ($this->getInput('MaxPriceUsed') != '') {
+                if ($PriceUsed < $this->getInput('MaxPriceUsed')) {
+                    $title = sprintf($Pricealarm, 'Used', $PriceUsed, $Productname, $now);
+                    $item = [
+                        'title'     => $title,
+                        'uri'       => $link,
+                        'content'   => $content,
+                        'uid'       => md5($title)
+                    ];
+                    $this->items[] = $item;
+                }
+            }
+
+            // General Priceupdate
+            if ($this->getInput('MaxPriceUsed') == '' && $this->getInput('MaxPriceNew') == '') {
+                // check if a relevant pricechange happened
+                if (
+                    (!$this->getInput('ExcludeNew') && $PriceNew != $OldPriceNew ) ||
+                    (!$this->getInput('ExcludeUsed') && $PriceUsed != $OldPriceUsed )
+                ) {
+                    $title .= 'Priceupdate! ';
+
+                    if (!$this->getInput('ExcludeNew')) {
+                        if ($PriceNew < $OldPriceNew) {
+                            $title .= 'NEW:&#11015 '; // Arrow Down Emoji
+                        }
+                        if ($PriceNew > $OldPriceNew) {
+                            $title .= 'NEW:&#11014 '; // Arrow Up Emoji
+                        }
+                    }
+
+
+                    if (!$this->getInput('ExcludeUsed')) {
+                        if ($PriceUsed < $OldPriceUsed) {
+                            $title .= 'USED:&#11015 '; // Arrow Down Emoji
+                        }
+                        if ($PriceUsed > $OldPriceUsed) {
+                            $title .= 'USED:&#11014 '; // Arrow Up Emoji
+                        }
+                    }
+                    $title .= $Productname;
+                    $title .= ' ';
+                    $title .= $now;
+
+                    $item = [
+                        'title'     => $title,
+                        'uri'       => $link,
+                        'content'   => $content,
+                        'uid'       => md5($title)
+                    ];
+                    $this->items[] = $item;
+                }
+            }
+        }
+
+        // Save current price
+        $this->saveCacheValue($KeyNEW, $PriceNew);
+        $this->saveCacheValue($KeyUSED, $PriceUsed);
+    }
+}

From b347a9268a7d6bc34442509e2cf7dcd793c39853 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 10 Nov 2023 12:56:11 +0100
Subject: [PATCH 200/716] feat: new bridge MangaReader (#3795)

---
 bridges/MangaReaderBridge.php | 44 +++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 bridges/MangaReaderBridge.php

diff --git a/bridges/MangaReaderBridge.php b/bridges/MangaReaderBridge.php
new file mode 100644
index 00000000..1fa0c62d
--- /dev/null
+++ b/bridges/MangaReaderBridge.php
@@ -0,0 +1,44 @@
+<?php
+
+class MangaReaderBridge extends BridgeAbstract
+{
+    const NAME = 'MangaReader Bridge';
+    const URI = 'https://mangareader.to';
+    const DESCRIPTION = 'Fetches the latest chapters from MangaReader.to.';
+    const MAINTAINER = 'cubethethird';
+    const PARAMETERS = [
+        [
+            'url' => [
+                'name' => 'Manga URL',
+                'type' => 'text',
+                'required' => true,
+                'title' => 'The URL of the manga on MangaReader',
+                'pattern' => '^https:\/\/mangareader\.to\/[^\/]+$',
+                'exampleValue' => 'https://mangareader.to/bleach-1623',
+            ],
+            'lang' => [
+                'name' => 'Chapter Language',
+                'title' => 'two-letter language code (example "en", "jp", "fr")',
+                'exampleValue' => 'en',
+                'required' => true,
+                'pattern' => '^[a-z][a-z]$',
+            ]
+        ]
+    ];
+
+    public function collectData()
+    {
+        $url = $this->getInput('url');
+        $lang = $this->getInput('lang');
+        $dom = getSimpleHTMLDOM($url);
+        $chapters = $dom->getElementById($lang . '-chapters');
+
+        foreach ($chapters->getElementsByTagName('li') as $chapter) {
+            $a = $chapter->getElementsByTagName('a')[0];
+            $item = [];
+            $item['title'] = $a->getAttribute('title');
+            $item['uri'] = self::URI . $a->getAttribute('href');
+            $this->items[] = $item;
+        }
+    }
+}

From 4919c53c108a36a7969b027bc6e6653415096353 Mon Sep 17 00:00:00 2001
From: knrdl <35548889+knrdl@users.noreply.github.com>
Date: Mon, 13 Nov 2023 00:11:19 +0100
Subject: [PATCH 201/716] [DemosBerlinBridge] add bridge (#3800)

---
 bridges/DemosBerlinBridge.php | 62 +++++++++++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)
 create mode 100644 bridges/DemosBerlinBridge.php

diff --git a/bridges/DemosBerlinBridge.php b/bridges/DemosBerlinBridge.php
new file mode 100644
index 00000000..05fd2335
--- /dev/null
+++ b/bridges/DemosBerlinBridge.php
@@ -0,0 +1,62 @@
+<?php
+
+class DemosBerlinBridge extends BridgeAbstract
+{
+    const NAME = 'Demos Berlin';
+    const URI = 'https://www.berlin.de/polizei/service/versammlungsbehoerde/versammlungen-aufzuege/';
+    const CACHE_TIMEOUT = 3 * 60 * 60;
+    const DESCRIPTION = 'Angezeigte Versammlungen und Aufzüge in Berlin';
+    const MAINTAINER = 'knrdl';
+    const PARAMETERS = [[
+        'days' => [
+            'name' => 'Tage',
+            'type' => 'number',
+            'title' => 'Einträge für die nächsten Tage zurückgeben',
+            'required' => true,
+            'defaultValue' => 7,
+        ]
+    ]];
+
+    public function getIcon()
+    {
+        return 'https://www.berlin.de/i9f/r1/images/favicon/favicon.ico';
+    }
+
+    public function collectData()
+    {
+        $json = getContents('https://www.berlin.de/polizei/service/versammlungsbehoerde/versammlungen-aufzuege/index.php/index/all.json');
+        $jsonFile = json_decode($json, true);
+
+        $daysInterval = DateInterval::createFromDateString($this->getInput('days') . ' day');
+        $maxTargetDate = date_add(new DateTime('now'), $daysInterval);
+
+        foreach ($jsonFile['index'] as $entry) {
+            $entryDay = implode('-', array_reverse(explode('.', $entry['datum']))); // dd.mm.yyyy to yyyy-mm-dd
+            $ts = (new DateTime())->setTimestamp(strtotime($entryDay));
+            if ($ts <= $maxTargetDate) {
+                $item = [];
+                $item['uri'] = 'https://www.berlin.de/polizei/service/versammlungsbehoerde/versammlungen-aufzuege/index.php/detail/' . $entry['id'];
+                $item['timestamp'] = $entryDay . ' ' . $entry['von'];
+                $item['title'] = $entry['thema'];
+                $location = $entry['strasse_nr'] . ' ' . $entry['plz'];
+                $locationQuery = http_build_query(['query' => $location]);
+                $item['content'] = <<<HTML
+                <h1>{$entry['thema']}</h1>
+                <p>📅 <time datetime="{$item['timestamp']}">{$entry['datum']} {$entry['von']} - {$entry['bis']}</time></p>
+                <a href="https://www.openstreetmap.org/search?$locationQuery">
+                📍 {$location}
+                </a>
+                <p>{$entry['aufzugsstrecke']}</p>
+                HTML;
+                $item['uid'] = $this->getSanitizedHash($entry['datum'] . '-' . $entry['von'] . '-' . $entry['bis'] . '-' . $entry['thema']);
+
+                $this->items[] = $item;
+            }
+        }
+    }
+
+    private function getSanitizedHash($string)
+    {
+        return hash('sha1', preg_replace('/[^a-zA-Z0-9]/', '', strtolower($string)));
+    }
+}

From ef711cb30b026b581573c5dc5f4de88b47f105b9 Mon Sep 17 00:00:00 2001
From: knrdl <35548889+knrdl@users.noreply.github.com>
Date: Mon, 13 Nov 2023 00:12:39 +0100
Subject: [PATCH 202/716] [KleinanzeigenBridge] add new bridge (#3798)

* [KleinanzeigenBridge] add new bridge

* [KleinanzeigenBridge] fix missing timestamp

* [KleinanzeigenBridge] linting

* [KleinanzeigenBridge] fix end of list detection
---
 bridges/KleinanzeigenBridge.php | 150 ++++++++++++++++++++++++++++++++
 1 file changed, 150 insertions(+)
 create mode 100644 bridges/KleinanzeigenBridge.php

diff --git a/bridges/KleinanzeigenBridge.php b/bridges/KleinanzeigenBridge.php
new file mode 100644
index 00000000..e0535b59
--- /dev/null
+++ b/bridges/KleinanzeigenBridge.php
@@ -0,0 +1,150 @@
+<?php
+
+class KleinanzeigenBridge extends BridgeAbstract
+{
+    const MAINTAINER = 'knrdl';
+    const NAME = 'Kleinanzeigen Bridge';
+    const URI = 'https://www.kleinanzeigen.de';
+    const CACHE_TIMEOUT = 3600; // 1h
+    const DESCRIPTION = 'ebay Kleinanzeigen';
+
+    const PARAMETERS = [
+        'By search' => [
+            'query' => [
+                'name' => 'query',
+                'required' => false,
+                'title' => 'query term',
+            ],
+            'location' => [
+                'name' => 'location',
+                'required' => false,
+                'title' => 'e.g. Berlin',
+            ],
+            'radius' => [
+                'name' => 'radius',
+                'required' => false,
+                'type' => 'number',
+                'title' => 'search radius in kilometers',
+                'defaultValue' => 10,
+            ],
+            'pages' => [
+                'name' => 'pages',
+                'required' => true,
+                'type' => 'number',
+                'title' => 'how many pages to fetch',
+                'defaultValue' => 2,
+            ]
+        ],
+        'By profile' => [
+            'userid' => [
+                'name' => 'user id',
+                'required' => true,
+                'type' => 'number',
+                'exampleValue' => 12345678
+            ],
+            'pages' => [
+                'name' => 'pages',
+                'required' => true,
+                'type' => 'number',
+                'title' => 'how many pages to fetch',
+                'defaultValue' => 2,
+            ]
+        ],
+    ];
+
+    public function getIcon()
+    {
+        return 'https://www.kleinanzeigen.de/favicon.ico';
+    }
+
+    public function getName()
+    {
+        switch ($this->queriedContext) {
+            case 'By profile':
+                return 'Kleinanzeigen Profil';
+            case 'By search':
+                return 'Kleinanzeigen ' . $this->getInput('query') . ' / ' . $this->getInput('location');
+            default:
+                return parent::getName();
+        }
+    }
+
+    public function collectData()
+    {
+        if ($this->queriedContext === 'By profile') {
+            for ($i = 1; $i <= $this->getInput('pages'); $i++) {
+                $html = getSimpleHTMLDOM(self::URI . '/s-bestandsliste.html?userId=' . $this->getInput('userid') . '&pageNum=' . $i . '&sortingField=SORTING_DATE');
+
+                $foundItem = false;
+                foreach ($html->find('article.aditem') as $element) {
+                    $this->addItem($element);
+                    $foundItem = true;
+                }
+                if (!$foundItem) {
+                    break;
+                }
+            }
+        }
+
+        if ($this->queriedContext === 'By search') {
+            $locationID = '';
+            if ($this->getInput('location')) {
+                $json = getContents(self::URI . '/s-ort-empfehlungen.json?' . http_build_query(['query' => $this->getInput('location')]));
+                $jsonFile = json_decode($json, true);
+                $locationID = str_replace('_', '', array_key_first($jsonFile));
+            }
+            for ($i = 1; $i <= $this->getInput('pages'); $i++) {
+                $searchUrl = self::URI . '/s-walled-garden/';
+                if ($i != 1) {
+                    $searchUrl .= 'seite:' . $i . '/';
+                }
+                if ($this->getInput('query')) {
+                    $searchUrl .= urlencode($this->getInput('query')) . '/k0';
+                }
+                if ($locationID) {
+                    $searchUrl .= 'l' . $locationID;
+                }
+                if ($this->getInput('radius')) {
+                    $searchUrl .= 'r' . $this->getInput('radius');
+                }
+
+                $html = getSimpleHTMLDOM($searchUrl);
+
+                // end of list if returned page is not the expected one
+                if ($html->find('.pagination-current', 0)->plaintext != $i) {
+                    break;
+                }
+
+                foreach ($html->find('ul#srchrslt-adtable article.aditem') as $element) {
+                    $this->addItem($element);
+                }
+            }
+        }
+    }
+
+    private function addItem($element)
+    {
+        $item = [];
+
+        $item['uid'] = $element->getAttribute('data-adid');
+        $item['uri'] = self::URI . $element->getAttribute('data-href');
+
+        $item['title'] = $element->find('h2', 0)->plaintext;
+        $item['timestamp'] = $element->find('div.aditem-main--top--right', 0)->plaintext;
+        $imgUrl = str_replace(
+            'rule=$_2.JPG',
+            'rule=$_57.JPG',
+            str_replace(
+                'rule=$_35.JPG',
+                'rule=$_57.JPG',
+                $element->find('img', 0) ? $element->find('img', 0)->getAttribute('src') : ''
+            )
+        ); //enhance img quality
+        $textContainer = $element->find('div.aditem-main', 0);
+        $textContainer->find('a', 0)->href = self::URI . $textContainer->find('a', 0)->href; // add domain to url
+        $item['content'] = '<img src="' . $imgUrl . '"/>' .
+        $textContainer->outertext;
+
+        $this->items[] = $item;
+    }
+}

From 2b741b1c1bf3ef352cea0903bd1561bc00ff45b0 Mon Sep 17 00:00:00 2001
From: joaomqc <joaomqc@hotmail.com>
Date: Wed, 15 Nov 2023 15:26:25 +0000
Subject: [PATCH 203/716] [SongkickBridge] add new bridge (#3803)

* [SongkickBridge] add new bridge

* [SongkickBridge] fix var reference and outdoor category

* [SongkickBridge] remove unnecessary string concat

* [SongkickBridge] fix if clause formatting

* [SongkickBridge] fix formatting and event title
---
 bridges/SongkickBridge.php | 92 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 92 insertions(+)
 create mode 100644 bridges/SongkickBridge.php

diff --git a/bridges/SongkickBridge.php b/bridges/SongkickBridge.php
new file mode 100644
index 00000000..bfe29865
--- /dev/null
+++ b/bridges/SongkickBridge.php
@@ -0,0 +1,92 @@
+<?php
+
+class SongkickBridge extends BridgeAbstract
+{
+    const NAME = 'Songkick';
+    const URI = 'https://songkick.com/';
+    const DESCRIPTION = 'Fetches the concerts of an artist';
+    const MAINTAINER = 'joaomqc';
+    const CACHE_TIMEOUT = 3600;
+    const PARAMETERS = [ [
+        'artistid' => [
+            'name' => 'Artist ID',
+            'type' => 'text',
+            'required' => true,
+            'exampleValue' => '2506696-imagine-dragons',
+        ]
+    ] ];
+
+    const ARTIST_URI = 'https://www.songkick.com/artists/%s/';
+    const CALENDAR_URI = self::ARTIST_URI . 'calendar';
+
+    private $name = '';
+
+    public function getURI()
+    {
+        return sprintf(self::ARTIST_URI, $this->getInput('artistid'));
+    }
+
+    public function getName()
+    {
+        if (!empty($this->name)) {
+            return $this->name . ' - ' . parent::getName();
+        }
+        return parent::getName();
+    }
+
+    public function getIcon()
+    {
+        return 'https://assets.sk-static.com/images/nw/furniture/songkick-logo.svg';
+    }
+
+    public function collectData()
+    {
+        $url = sprintf(self::CALENDAR_URI, $this->getInput('artistid'));
+
+        $dom = getSimpleHTMLDOM($url);
+
+        $jsonscript = $dom->find('div.microformat > script', 0);
+
+        if (empty($this->name) && $jsonscript) {
+            $this->name = json_decode($jsonscript->innertext)[0]->name;
+        }
+
+        $dom = $dom->find('div.container > div.row > div.primary', 0);
+
+        if (!$dom) {
+            throw new Exception(sprintf('Unable to find css selector on `%s`', $url));
+        }
+        $dom = defaultLinkTo($dom, $this->getURI());
+
+        foreach ($dom->find('div[@id="calendar-summary"] > ol > li') as $article) {
+            $detailsobj = json_decode($article->find('div.microformat > script', 0)->innertext)[0];
+
+            $a = $article->find('a', 0);
+
+            $details = $a->find('div.event-details', 0);
+            $title = $details->find('.secondary-detail', 0)->plaintext;
+            $city = $details->find('.primary-detail', 0)->plaintext;
+            $event = $detailsobj->location->name;
+
+            $content = 'City: ' . $city . '<br>Event: ' . $event . '<br>Date: ' . $article->title;
+
+            $categories = [];
+            if ($details->hasClass('concert')) {
+                $categories[] = 'concert';
+            }
+            if ($details->hasClass('festival')) {
+                $categories[] = 'festival';
+            }
+            if (!is_null($details->find('.outdoor', 0))) {
+                $categories[] = 'outdoor';
+            }
+
+            $this->items[] = [
+                'title' => $title,
+                'uri' => $a->href,
+                'content' => $content,
+                'categories' => $categories,
+            ];
+        }
+    }
+}

From b037d1b4d1f0b0f422e21125ddef00a58e185ed1 Mon Sep 17 00:00:00 2001
From: Matt DeMoss <demoss.matt@gmail.com>
Date: Tue, 21 Nov 2023 11:00:02 -0500
Subject: [PATCH 204/716] [Threads] add bridge (#3805)

* initial working Threads bridge

* properly specify a default limit

* phpcs formatted
---
 bridges/ThreadsBridge.php | 120 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 120 insertions(+)
 create mode 100644 bridges/ThreadsBridge.php

diff --git a/bridges/ThreadsBridge.php b/bridges/ThreadsBridge.php
new file mode 100644
index 00000000..b7e5cd1a
--- /dev/null
+++ b/bridges/ThreadsBridge.php
@@ -0,0 +1,120 @@
+<?php
+
+class ThreadsBridge extends BridgeAbstract
+{
+    const NAME = 'Threads';
+    const URI = 'https://www.threads.net/';
+    const DESCRIPTION = 'Say more with Threads &#x2014; Instagram&#039;s new text app.';
+    const MAINTAINER = 'mdemoss';
+    const CACHE_TIMEOUT = 3600;
+
+    const PARAMETERS = [
+        'By username' => [
+            'u' => [
+                'name' => 'username',
+                'required' => true,
+                'exampleValue' => 'zuck',
+                'title' => 'Insert a user name'
+            ],
+            'limit' => [
+                'name' => 'Limit',
+                'type' => 'number',
+                'required' => false,
+                'title' => 'Specify number of posts to fetch',
+                'defaultValue' => 5
+            ]
+        ]
+    ];
+
+    protected $feedName = self::NAME;
+    public function getName()
+    {
+        return $this->feedName;
+    }
+
+    public function detectParameters($url)
+    {
+        // By username
+        $regex = '/^(https?:\/\/)?(www\.)?threads\.net\/(@)?([^\/?\n]+)/';
+        if (preg_match($regex, $url, $matches) > 0) {
+            $params['context'] = 'By username';
+            $params['u'] = urldecode($matches[3]);
+            return $params;
+        }
+        return null;
+    }
+
+    public function getURI()
+    {
+        return self::URI . '@' . $this->getInput('u');
+    }
+
+    // https://stackoverflow.com/a/3975706/421140
+    // Found this in FlaschenpostBridge, modified to return an array and take an object.
+    private function recursiveFind($haystack, $needle)
+    {
+        $found = [];
+        $iterator = new \RecursiveArrayIterator($haystack);
+        $recursive = new \RecursiveIteratorIterator(
+            $iterator,
+            \RecursiveIteratorIterator::SELF_FIRST
+        );
+        foreach ($recursive as $key => $value) {
+            if ($key === $needle) {
+                $found[] = $value;
+            }
+        }
+        return $found;
+    }
+
+    public function collectData()
+    {
+        $html = getSimpleHTMLDOMCached($this->getURI(), static::CACHE_TIMEOUT);
+        Debug::log(sprintf('Fetched: %s', $this->getURI()));
+        $jsonBlobs = $html->find('script[type="application/json"]');
+        Debug::log(sprintf('%d JSON blobs found.', count($jsonBlobs)));
+        $gatheredCodes = [];
+        $limit = $this->getInput('limit');
+        foreach ($jsonBlobs as $jsonBlob) {
+            // The structure of the JSON document is likely to change, but we're looking for a "code" inside a "post"
+            foreach ($this->recursiveFind($this->recursiveFind(json_decode($jsonBlob->innertext), 'post'), 'code') as $candidateCode) {
+                // code should be like CzZk4-USq1O or Cy3m1VnRiwP or Cywjyrdv9T6 or CzZk4-USq1O
+                if (grapheme_strlen($candidateCode) == 11 and !in_array($candidateCode, $gatheredCodes)) {
+                    $gatheredCodes[] = $candidateCode;
+                    if (count($gatheredCodes) >= $limit) {
+                        break 2;
+                    }
+                }
+            }
+        }
+        Debug::log(sprintf('Candidate codes found in JSON in script tags: %s', print_r($gatheredCodes, true)));
+
+        $this->feedName = html_entity_decode($html->find('meta[property=og:title]', 0)->content);
+        // todo: meta[property=og:description] could populate the feed description
+
+        foreach ($gatheredCodes as $postCode) {
+            $item = [];
+            // post URL is like: https://www.threads.net/@zuck/post/Czrr520PZfh
+            $item['uri'] = $this->getURI() . '/post/' . $postCode;
+            $articleHtml = getSimpleHTMLDOMCached($item['uri'], 15778800); // cache time: six months
+
+            // Relying on meta tags ought to be more reliable.
+            if ($articleHtml->find('meta[property=og:type]', 0)->content != 'article') {
+                continue;
+            }
+            $item['title'] = $articleHtml->find('meta[property=og:description]', 0)->content;
+            $item['content'] = $articleHtml->find('meta[property=og:description]', 0)->content;
+            $item['author'] = html_entity_decode($articleHtml->find('meta[property=og:title]', 0)->content);
+
+            $imageUrl = $articleHtml->find('meta[property=og:image]', 0);
+            if ($imageUrl) {
+                $item['enclosures'][] = html_entity_decode($imageUrl->content);
+            }
+
+            // todo: parse hashtags out of content for $item['categories']
+            // todo: try to scrape out a timestamp for $item['timestamp'], it's not in the meta tags
+
+            $this->items[] = $item;
+        }
+    }
+}

From 609eed1791598a798e7f94ac694d014605ec11ee Mon Sep 17 00:00:00 2001
From: George Sokianos <walkero@gmail.com>
Date: Tue, 28 Nov 2023 21:54:39 +0000
Subject: [PATCH 205/716] KoFiBridge fix the "Call to a member function find()
 on null" line 39 (#3807)

---
 bridges/KoFiBridge.php | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/bridges/KoFiBridge.php b/bridges/KoFiBridge.php
index c1600590..da8f1e7d 100644
--- a/bridges/KoFiBridge.php
+++ b/bridges/KoFiBridge.php
@@ -27,12 +27,15 @@ class KoFiBridge extends BridgeAbstract
                 if (isset($titleWrapper[0])) {
                     $item = [];
                     $item['title'] = $element->find('div.content-link-text div')[0]->plaintext;
-                    // $item['timestamp'] = strtotime($element->find('div.feeditem-time', 0)->plaintext);
-                    $item['uri'] = self::URI . $element->find('div.fi-post-item-large a')[0]->href;
+                    $uri = $element->find('div.content-link-text div')[2]->find('a')[0]->onclick;
+                    $uri = trim(str_replace('window.location =', '', $uri));
+                    $uri = trim(str_replace('&#39;', '', $uri));
+                    $uri = trim(str_replace(';', '', $uri));
+                    $item['uri'] = self::URI . $uri;
+
                     if (isset($element->find('div.fi-post-item-large div.content-link-post img')[0])) {
                         $item['enclosures'][] = $element->find('div.fi-post-item-large div.content-link-post img')[0]->src;
                     }
-                    // $item['content'] = $element->find('div.content-link-text div#content-link', 0)->plaintext;
 
                     $html = getSimpleHTMLDOM($item['uri']);
                     $feedItemTime = $html->find('div.feeditem-time', 0);

From ccc20849ffe297e09e046a086734c2c90e94420a Mon Sep 17 00:00:00 2001
From: Michael Bemmerl <mail@mx-server.de>
Date: Thu, 30 Nov 2023 16:52:51 +0000
Subject: [PATCH 206/716] [SchweinfurtBuergerinformationenBridge] Don't include
 images with data URIs as enclosures. (#3811)

See also setEnclosures() in FeedItem.php: URIs with a path are required.
---
 bridges/SchweinfurtBuergerinformationenBridge.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/SchweinfurtBuergerinformationenBridge.php b/bridges/SchweinfurtBuergerinformationenBridge.php
index 349a9d8a..d1f5db15 100644
--- a/bridges/SchweinfurtBuergerinformationenBridge.php
+++ b/bridges/SchweinfurtBuergerinformationenBridge.php
@@ -107,9 +107,9 @@ class SchweinfurtBuergerinformationenBridge extends BridgeAbstract
             ];
 
         // Let's see if there are images in the content, and if yes, attach
-        // them as enclosures, but not images which are used for linking to an external site.
+        // them as enclosures, but not images which are used for linking to an external site and data URIs.
         foreach ($images as $image) {
-            if ($image->class != 'imgextlink') {
+            if ($image->class != 'imgextlink' && parse_url($image->src, PHP_URL_SCHEME) != 'data') {
                 $item['enclosures'][] = $image->src;
             }
         }

From 44ff2f2cf8cc4403c7fd2af182607c59c74e14ba Mon Sep 17 00:00:00 2001
From: Niehztog <Niehztog@users.noreply.github.com>
Date: Thu, 30 Nov 2023 17:53:47 +0100
Subject: [PATCH 207/716] adds Super Mario Bros. Wonder to NintendoBridge
 (#3810)

---
 bridges/NintendoBridge.php | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/bridges/NintendoBridge.php b/bridges/NintendoBridge.php
index 34550737..1f463e91 100644
--- a/bridges/NintendoBridge.php
+++ b/bridges/NintendoBridge.php
@@ -18,6 +18,7 @@ class NintendoBridge extends XPathAbstract
                     'Splatoon 2' => 's2',
                     'Super Mario 3D All-Stars' => 'sm3as',
                     'Super Mario 3D World + Bowser’s Fury' => 'sm3wbf',
+                    'Super Mario Bros. Wonder' => 'smbw',
                     'Super Mario Maker 2' => 'smm2',
                     'Super Mario Odyssey' => 'smo',
                     'Super Smash Bros. Ultimate' => 'ssbu',
@@ -62,6 +63,7 @@ class NintendoBridge extends XPathAbstract
         's2' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/Game-Updates/How-to-Update-Splatoon-2-1482897.html',
         'sm3as' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/Game-Updates/How-to-Update-Super-Mario-3D-All-Stars-1844226.html',
         'sm3wbf' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/Game-Updates/How-to-Update-Super-Mario-3D-World-Bowser-s-Fury-1920668.html',
+        'smbw' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/Game-Updates/How-to-Update-Super-Mario-Bros-Wonder-2485410.html',
         'smm2' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/Game-Updates/How-to-Update-Super-Mario-Maker-2-1586745.html',
         'smo' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/Game-Updates/How-to-Update-Super-Mario-Odyssey-1482901.html',
         'ssbu' => 'https://www.nintendo.co.uk/Support/Nintendo-Switch/Game-Updates/How-to-Update-Super-Smash-Bros-Ultimate-1484130.html',
@@ -73,7 +75,7 @@ class NintendoBridge extends XPathAbstract
     ];
     const XPATH_EXPRESSION_ITEM = '//div[@class="col-xs-12 content"]/div[starts-with(@id,"v") and @class="collapse"]';
     const XPATH_EXPRESSION_ITEM_FIRMWARE = '//div[@id="latest" and @class="collapse" and @rel="1"]';
-    const XPATH_EXPRESSION_ITEM_TITLE = './/h2[1]/node()';
+    const XPATH_EXPRESSION_ITEM_TITLE = '(.//h2[1] | .//strong[1])[1]/node()';
     const XPATH_EXPRESSION_ITEM_CONTENT = '.';
     const XPATH_EXPRESSION_ITEM_URI = '//link[@rel="canonical"]/@href';
 
@@ -124,6 +126,15 @@ class NintendoBridge extends XPathAbstract
             'pt' => 'ançada no dia ',
             'en' => 'eleased ',
         ],
+        'smbw' => [
+            'de' => 'eröffentlicht am ',
+            'es' => 'isponible desde el ',
+            'fr' => 'atée du ',
+            'it' => 'istribuita il ',
+            'nl' => 'itgebracht op ',
+            'pt' => 'ançada a ',
+            'en' => 'eleased ',
+        ],
         'smm2' => [
             'de' => 'eröffentlicht am ',
             'es' => 'isponible desde el ',
@@ -235,6 +246,15 @@ class NintendoBridge extends XPathAbstract
             'pt' => 'd/m/y',
             'en' => 'F j, Y',
         ],
+        'smbw' => [
+            'de' => 'd. m Y',
+            'es' => 'j \d\e m \d\e Y',
+            'fr' => 'd/m/Y',
+            'it' => 'j m Y',
+            'nl' => 'd m Y',
+            'pt' => 'j \d\e m \d\e Y',
+            'en' => 'j F Y',
+        ],
         'smm2' => [
             'de' => 'd.m.Y',
             'es' => 'd-m-Y',

From 206edaedf5397aee35848002b3274417007a86c1 Mon Sep 17 00:00:00 2001
From: Nick McCarthy <nicholas.mccarthy@gmail.com>
Date: Fri, 1 Dec 2023 21:36:26 +0000
Subject: [PATCH 208/716] [GoogleScholarBridge] Minor patch  (#3814)

* Do not add RSS entry if Check for updates is found in the article title - avoids repeat entries
---
 bridges/GoogleScholarBridge.php | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/bridges/GoogleScholarBridge.php b/bridges/GoogleScholarBridge.php
index 981355dd..11dc123b 100644
--- a/bridges/GoogleScholarBridge.php
+++ b/bridges/GoogleScholarBridge.php
@@ -2,7 +2,7 @@
 
 class GoogleScholarBridge extends BridgeAbstract
 {
-    const NAME = 'Google Scholar v2';
+    const NAME = 'Google Scholar';
     const URI = 'https://scholar.google.com/';
     const DESCRIPTION = 'Search for publications or follow authors on Google Scholar.';
     const MAINTAINER = 'nicholasmccarthy';
@@ -193,6 +193,11 @@ class GoogleScholarBridge extends BridgeAbstract
                     $articleUrl = $articleTitleElement->find('a', 0)->href;
                     $articleTitle = $articleTitleElement->plaintext;
 
+                    // Break the loop if 'Check for Updates' is found in the article title
+                    if (strpos($articleTitle, 'Check for updates') !== false) {
+                        break;
+                    }
+
                     $articleDateElement = $publication->find('div[class="gs_a"]', 0);
                     $articleDate = $articleDateElement ? $articleDateElement->plaintext : '';
 

From f3df283c4d93a90f81bda7c466e8b9937f178acf Mon Sep 17 00:00:00 2001
From: Eugene Molotov <eugene.molotov@yandex.ru>
Date: Sun, 3 Dec 2023 22:54:23 +0500
Subject: [PATCH 209/716] [VkBridge] Fix single photo duplication (#3816)

---
 bridges/VkBridge.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/bridges/VkBridge.php b/bridges/VkBridge.php
index 60e4315b..503bc4d0 100644
--- a/bridges/VkBridge.php
+++ b/bridges/VkBridge.php
@@ -315,6 +315,13 @@ class VkBridge extends BridgeAbstract
                 $copy_quote->outertext = "<br>Reposted ($copy_quote_author): <br>$copy_quote_content";
             }
 
+            foreach ($post->find('.PrimaryAttachment .PhotoPrimaryAttachment') as $pa) {
+                $img = $pa->find('.PhotoPrimaryAttachment__imageElement', 0);
+                if (is_object($img)) {
+                    $pa->outertext = $img->outertext;
+                }
+            }
+
             foreach ($post->find('.SecondaryAttachment') as $sa) {
                 $sa_href = $sa->getAttribute('href');
                 if (!$sa_href) {

From deb9a7269e166c74dfd9140da3da74923bb67608 Mon Sep 17 00:00:00 2001
From: knrdl <35548889+knrdl@users.noreply.github.com>
Date: Wed, 6 Dec 2023 17:07:22 +0100
Subject: [PATCH 210/716] [MotatosBridge] add bridge (#3799)

* [MotatosBridge] add bridge

* [MotatosBridge] fix uid as string

* [MotatosBridge] add support for all regions

* [MotatosBridge] fix: region: "required" attribute not supported for list
---
 bridges/MotatosBridge.php | 102 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 102 insertions(+)
 create mode 100644 bridges/MotatosBridge.php

diff --git a/bridges/MotatosBridge.php b/bridges/MotatosBridge.php
new file mode 100644
index 00000000..6833521a
--- /dev/null
+++ b/bridges/MotatosBridge.php
@@ -0,0 +1,102 @@
+<?php
+
+class MotatosBridge extends BridgeAbstract
+{
+    const NAME = 'Motatos / Matsmart';
+    const URI = 'https://www.motatos.de/neu-im-shop';
+    const CACHE_TIMEOUT = 3600; // 1h
+    const DESCRIPTION = 'New articles in the Motatos / Matsmart online shop';
+    const MAINTAINER = 'knrdl';
+    const PARAMETERS = [[
+        'region' => [
+            'name' => 'Region',
+            'type' => 'list',
+            'title' => 'Choose country',
+            'values' => [
+                'Austria' => 'at',
+                'Denmark' => 'dk',
+                'Finland' => 'fi',
+                'Germany' => 'de',
+                'Sweden' => 'se',
+            ],
+        ],
+    ]];
+
+    public function getName()
+    {
+        switch ($this->getInput('region')) {
+            case 'at':
+                return 'Motatos';
+            case 'dk':
+                return 'Motatos';
+            case 'de':
+                return 'Motatos';
+            case 'fi':
+                return 'Matsmart';
+            case 'se':
+                return 'Matsmart';
+            default:
+                return self::NAME;
+        }
+    }
+
+    public function getURI()
+    {
+        switch ($this->getInput('region')) {
+            case 'at':
+                return 'https://www.motatos.at/neu-im-shop';
+            case 'dk':
+                return 'https://www.motatos.dk/nye-varer';
+            case 'de':
+                return 'https://www.motatos.de/neu-im-shop';
+            case 'fi':
+                return 'https://www.matsmart.fi/uusimmat';
+            case 'se':
+                return 'https://www.matsmart.se/nyinkommet';
+            default:
+                return self::URI;
+        }
+    }
+
+    public function getIcon()
+    {
+        return 'https://www.motatos.de/favicon.ico';
+    }
+
+    private function getApiUrl()
+    {
+        switch ($this->getInput('region')) {
+            case 'at':
+                return 'https://api.findify.io/v4/4359f7b3-17e0-4f74-9fdb-e6606dfed25c/smart-collection/new-arrivals';
+            case 'dk':
+                return 'https://api.findify.io/v4/3709426e-621a-49df-bd61-ac8543452022/smart-collection/new-arrivals';
+            case 'de':
+                return 'https://api.findify.io/v4/2a044754-6cda-4541-b159-39133b75386c/smart-collection/new-arrivals';
+            case 'fi':
+                return 'https://api.findify.io/v4/63946f89-2a82-4839-a412-883b79144f7b/smart-collection/new-arrivals';
+            case 'se':
+                return 'https://api.findify.io/v4/3ae86b36-a1bd-4442-a3d9-2af6845908e6/smart-collection/new-arrivals';
+        }
+    }
+
+    public function collectData()
+    {
+        // motatos uses this api to dynamically load more items on page scroll
+        $json = getContents($this->getApiUrl() . '?t_client=0&user={%22uid%22:%220%22,%22sid%22:%220%22}');
+        $jsonFile = json_decode($json, true);
+
+        foreach ($jsonFile['items'] as $entry) {
+            $item = [];
+            $item['uid'] = $entry['custom_fields']['uuid'][0];
+            $item['uri'] = $entry['product_url'];
+            $item['timestamp'] = $entry['created_at'] / 1000;
+            $item['title'] = $entry['title'];
+            $item['content'] = <<<HTML
+            <h1>{$entry['title']}</h1>
+            <img src="{$entry['image_url']}" />
+            <p>{$entry['price'][0]}€</p>
+            HTML;
+            $this->items[] = $item;
+        }
+    }
+}

From c3d93835239fe6b5d70033340d450cd9d88c477f Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Fri, 8 Dec 2023 06:24:43 +0100
Subject: [PATCH 211/716] [FindfeedAction.php] Use relative URL in Feed Link
 (#3820)

The FindFeed action used absolute URL. This breaks the usage of RSS
Bridge behind a reverse proxy in a container.

Fixes #3801 for the Find Feed action
---
 actions/FindfeedAction.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/actions/FindfeedAction.php b/actions/FindfeedAction.php
index 25fe4714..fe5ceef9 100644
--- a/actions/FindfeedAction.php
+++ b/actions/FindfeedAction.php
@@ -56,7 +56,7 @@ class FindfeedAction implements ActionInterface
             $bridgeParams['bridge'] = $bridgeClassName;
             $bridgeParams['format'] = $format;
             $content = [
-                'url' => get_home_page_url() . '?action=display&' . http_build_query($bridgeParams),
+                'url' => './?action=display&' . http_build_query($bridgeParams),
                 'bridgeParams' => $bridgeParams,
                 'bridgeData' => $bridgeData,
                 'bridgeMeta' => [

From 3ef0226a087fadfa565b70b0868fc988f927cfac Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Fri, 8 Dec 2023 06:25:39 +0100
Subject: [PATCH 212/716] [PepperBridgeAbstract] Fix Detection of "no deals
 found" and more (#3821)

- CSS styles showing there were no deals found has changed : CSS class
  was updated
- Relative Date handling : the minimum granularity of a relative date is
  the minute on the site. Seconds are therefore meaningless, and are now deleted.

MydealsBridge was missing one relateve date prefix : now every date is
parsed (I hope so !)
---
 bridges/MydealsBridge.php        | 4 +++-
 bridges/PepperBridgeAbstract.php | 8 +++++++-
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/bridges/MydealsBridge.php b/bridges/MydealsBridge.php
index de702583..22b46413 100644
--- a/bridges/MydealsBridge.php
+++ b/bridges/MydealsBridge.php
@@ -2068,7 +2068,9 @@ class MydealsBridge extends PepperBridgeAbstract
         'relative-date-alt-prefixes' => [
             'aktualisiert vor ',
             'kommentiert vor ',
-            'heiß seit '
+            'eingestellt vor ',
+            'heiß seit ',
+            'vor '
         ],
         'relative-date-ignore-suffix' => [
             '/von.*$/'
diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index 875ed8f6..8e8a2e8d 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -94,7 +94,7 @@ class PepperBridgeAbstract extends BridgeAbstract
         );
 
         // If there is no results, we don't parse the content because it display some random deals
-        $noresult = $html->find('h3[class=size--all-l]', 0);
+        $noresult = $html->find('h3[class*=text--b]', 0);
         if ($noresult != null && strpos($noresult->plaintext, $this->i8n('no-results')) !== false) {
             $this->items = [];
         } else {
@@ -542,6 +542,10 @@ HEREDOC;
     {
         $date = new DateTime();
 
+        // The minimal amount of time substracted is a minute : the seconds in the resulting date would be related to the execution time of the script.
+        // This make no sense, so we set the seconds manually to "00".
+        $date->setTime($date->format('H'), $date->format('i'), 0);
+
         // In case of update date, replace it by the regular relative date first word
         $str = str_replace($this->i8n('relative-date-alt-prefixes'), $this->i8n('local-time-relative')[0], $str);
 
@@ -559,6 +563,8 @@ HEREDOC;
             ''
         ];
         $date->modify(str_replace($search, $replace, $str));
+
+
         return $date->getTimestamp();
     }
 

From 4a398a5b14d6f5c2bb12bf0156348798f4e4fa37 Mon Sep 17 00:00:00 2001
From: Raymond Berger <RayBB@users.noreply.github.com>
Date: Sat, 9 Dec 2023 11:52:57 +0100
Subject: [PATCH 213/716] Update FacebookBridge.md - not working (#3823)

---
 docs/10_Bridge_Specific/FacebookBridge.md | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/docs/10_Bridge_Specific/FacebookBridge.md b/docs/10_Bridge_Specific/FacebookBridge.md
index c2a1fd0e..f24f8aa8 100644
--- a/docs/10_Bridge_Specific/FacebookBridge.md
+++ b/docs/10_Bridge_Specific/FacebookBridge.md
@@ -1,18 +1,18 @@
 FacebookBridge
 ===============
-Resume of the actual state of this bridge:
+State of this bridge:
+- Facebook Groups (and probably other sections too) do not work at all
 - No maintainer
-- Need Cookies consent
-- New design architecture deployed
+- Needs cookie consent support for public pages
+- Needs login support (see [this example]([url](https://github.com/RSS-Bridge/rss-bridge/issues/1891)) for Instagram) for private groups
 
-Due [facebook-redesing](https://engineering.fb.com/2020/05/08/web/facebook-redesign/)
+Due to the 2020 [Facebook redesign](https://engineering.fb.com/2020/05/08/web/facebook-redesign/)
 and the requirement to [accept cookies](https://www.facebook.com/business/help/348535683460989)
-users start getting [Problems with Facebook on public RSS-Bridge instances](https://github.com/RSS-Bridge/rss-bridge/issues/2047 )
+users are getting [problems with Facebook on public RSS-Bridge instances](https://github.com/RSS-Bridge/rss-bridge/issues/2047).
 
+Relevant Info
+--------------
 
-[Facebook Cookies](https://www.facebook.com/policy/cookies/)
-
-"Datr" is a unique identifier for your browser and it has a lifespan of two years.
-
-"c_user" and "xs" cookies to verify the account and have a lifespan of 365 days
-
+- [Facebook Cookies](https://www.facebook.com/policy/cookies/)
+- "Datr" is a unique identifier for your browser and it has a lifespan of two years.
+- "c_user" and "xs" cookies to verify the account and have a lifespan of 365 days

From a3b064f4eef00ca5559cd23f2c7a47ded8083f21 Mon Sep 17 00:00:00 2001
From: Guillaume Lacasa <glacasa@users.noreply.github.com>
Date: Mon, 11 Dec 2023 17:38:39 +0100
Subject: [PATCH 214/716] Find PanneauPocket city id from page URL (#3825)

Co-authored-by: Guillaume Lacasa <git@adhess.net>
---
 bridges/PanneauPocketBridge.php | 28 ++++++++++++++++++++++++++--
 1 file changed, 26 insertions(+), 2 deletions(-)

diff --git a/bridges/PanneauPocketBridge.php b/bridges/PanneauPocketBridge.php
index 8547a500..464d56c5 100644
--- a/bridges/PanneauPocketBridge.php
+++ b/bridges/PanneauPocketBridge.php
@@ -12,6 +12,12 @@ class PanneauPocketBridge extends BridgeAbstract
                 'name' => 'Choisir une ville',
                 'type' => 'list',
                 'values' => self::CITIES,
+            ],
+            'cityName' => [
+                'name' => 'Ville',
+            ],
+            'cityId' => [
+                'name' => 'Identifiant',
             ]
         ]
     ];
@@ -113,8 +119,14 @@ class PanneauPocketBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $matchedCity = array_search($this->getInput('cities'), self::CITIES);
-        $city = strtolower($this->getInput('cities') . '-' . $matchedCity);
+        $cityId = $this->getInput('cityId');
+        if ($cityId != null) {
+            $cityName = $this->getInput('cityName');
+            $city = strtolower($cityId . '-' . $cityName);
+        } else {
+            $matchedCity = array_search($this->getInput('cities'), self::CITIES);
+            $city = strtolower($this->getInput('cities') . '-' . $matchedCity);
+        }
         $url = sprintf('https://app.panneaupocket.com/ville/%s', urlencode($city));
 
         $html = getSimpleHTMLDOM($url);
@@ -136,6 +148,18 @@ class PanneauPocketBridge extends BridgeAbstract
         }
     }
 
+    public function detectParameters($url)
+    {
+        $params = [];
+        $regex = '/\/ville\/(\d+)-([a-z0-9-]+)/';
+        if (preg_match($regex, $url, $matches)) {
+            $params['cityId'] = $matches[1];
+            $params['cityName'] = $matches[2];
+            return $params;
+        }
+        return null;
+    }
+
     /**
      * Produce self::CITIES array
      */

From 0b67544f86e887d0bf4544b452fef816ec262928 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Wed, 13 Dec 2023 21:09:48 +0100
Subject: [PATCH 215/716] [PepperBridgeAbstract] Fix temperature handling
 (#3828)

Website has changed how the temperature is renderd : the bridge does
follow the new website structure
---
 bridges/PepperBridgeAbstract.php | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index 8e8a2e8d..6cb0f302 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -117,8 +117,7 @@ class PepperBridgeAbstract extends BridgeAbstract
                     . $this->getSource($deal)
                     . $deal->find('div[class*=' . $selectorDescription . ']', 0)->innertext
                     . '</td><td>'
-                    . $deal->find('div[class*=' . $selectorHot . ']', 0)
-                        ->find('span', 0)->outertext
+                    . $this->getTemperature($deal)
                     . '</td></table>';
 
                 // Check if a clock icon is displayed on the deal
@@ -368,6 +367,16 @@ HEREDOC;
         }
     }
 
+    /**
+     * Get the temperature from a Deal if it exists
+     * @return string String of the deal temperature
+     */
+    private function getTemperature($deal)
+    {
+        $data = Json::decode($deal->find('div[class=js-vue2]', 0)->getAttribute('data-vue2'));
+        return $data['props']['thread']['temperature'] . '°';
+    }
+
     /**
      * Get the source of a Deal if it exists
      * @return string String of the deal source

From f01729c86f29b61d4a50ea8f76c639cd1fc19f5a Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 13 Dec 2023 21:40:13 +0100
Subject: [PATCH 216/716] fix(arstechnica): plus a few unrelated tweaks (#3829)

---
 actions/FrontpageAction.php   |  1 +
 bridges/ArsTechnicaBridge.php |  9 ++++++++-
 bridges/VkBridge.php          |  2 +-
 caches/FileCache.php          |  2 +-
 index.php                     |  6 +++++-
 lib/Configuration.php         | 15 ++-------------
 6 files changed, 18 insertions(+), 17 deletions(-)

diff --git a/actions/FrontpageAction.php b/actions/FrontpageAction.php
index 64281b1e..ad48927d 100644
--- a/actions/FrontpageAction.php
+++ b/actions/FrontpageAction.php
@@ -31,6 +31,7 @@ final class FrontpageAction implements ActionInterface
             }
         }
 
+        // todo: cache this renderered template
         return render(__DIR__ . '/../templates/frontpage.html.php', [
             'messages' => $messages,
             'admin_email' => Configuration::getConfig('admin', 'email'),
diff --git a/bridges/ArsTechnicaBridge.php b/bridges/ArsTechnicaBridge.php
index 5b3283b5..613c1c58 100644
--- a/bridges/ArsTechnicaBridge.php
+++ b/bridges/ArsTechnicaBridge.php
@@ -37,7 +37,14 @@ class ArsTechnicaBridge extends FeedExpander
     {
         $item_html = getSimpleHTMLDOMCached($item['uri'] . '&amp');
         $item_html = defaultLinkTo($item_html, self::URI);
-        $item['content'] = $item_html->find('.amp-wp-article-content', 0);
+
+        $item_content = $item_html->find('.article-content.post-page', 0);
+        if (!$item_content) {
+            // The dom selector probably broke. Let's just return the item as-is
+            return $item;
+        }
+
+        $item['content'] = $item_content;
 
         // remove various ars advertising
         $item['content']->find('#social-left', 0)->remove();
diff --git a/bridges/VkBridge.php b/bridges/VkBridge.php
index 503bc4d0..980b4154 100644
--- a/bridges/VkBridge.php
+++ b/bridges/VkBridge.php
@@ -523,7 +523,7 @@ class VkBridge extends BridgeAbstract
             }
 
             if (!preg_match('#^https?://vk.com/#', $uri)) {
-                returnServerError('Unexpected redirect location');
+                returnServerError('Unexpected redirect location: ' . $uri);
             }
 
             $redirects++;
diff --git a/caches/FileCache.php b/caches/FileCache.php
index 2f4b3ad5..09d12791 100644
--- a/caches/FileCache.php
+++ b/caches/FileCache.php
@@ -49,8 +49,8 @@ class FileCache implements CacheInterface
     {
         $item = [
             'key'           => $key,
-            'value'         => $value,
             'expiration'    => $ttl === null ? 0 : time() + $ttl,
+            'value'         => $value,
         ];
         $cacheFile = $this->createCacheFile($key);
         $bytes = file_put_contents($cacheFile, serialize($item), LOCK_EX);
diff --git a/index.php b/index.php
index 123f6ecd..14713e06 100644
--- a/index.php
+++ b/index.php
@@ -6,7 +6,11 @@ if (version_compare(\PHP_VERSION, '7.4.0') === -1) {
 
 require_once __DIR__ . '/lib/bootstrap.php';
 
-Configuration::verifyInstallation();
+$errors = Configuration::checkInstallation();
+if ($errors) {
+    die('<pre>' . implode("\n", $errors) . '</pre>');
+}
+
 $customConfig = [];
 if (file_exists(__DIR__ . '/config.ini.php')) {
     $customConfig = parse_ini_file(__DIR__ . '/config.ini.php', true, INI_SCANNER_TYPED);
diff --git a/lib/Configuration.php b/lib/Configuration.php
index d699178f..ac7d29bf 100644
--- a/lib/Configuration.php
+++ b/lib/Configuration.php
@@ -15,15 +15,7 @@ final class Configuration
     {
     }
 
-    /**
-     * Verifies the current installation of RSS-Bridge and PHP.
-     *
-     * Returns an error message and aborts execution if the installation does
-     * not satisfy the requirements of RSS-Bridge.
-     *
-     * @return void
-     */
-    public static function verifyInstallation()
+    public static function checkInstallation(): array
     {
         $errors = [];
 
@@ -57,10 +49,7 @@ final class Configuration
         if (!extension_loaded('json')) {
             $errors[] = 'json extension not loaded';
         }
-
-        if ($errors) {
-            throw new \Exception(sprintf('Configuration error: %s', implode(', ', $errors)));
-        }
+        return $errors;
     }
 
     public static function loadConfiguration(array $customConfig = [], array $env = [])

From d157816e07e47dfdc8583d5fcee1925031aa6496 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 13 Dec 2023 21:56:14 +0100
Subject: [PATCH 217/716] fix(reddit): cache tweak for 403 forbidden (#3830)

---
 actions/DisplayAction.php | 9 +++++++--
 bridges/RedditBridge.php  | 5 +++++
 lib/contents.php          | 1 +
 lib/http.php              | 1 +
 4 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index e3b25fef..43563996 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -19,6 +19,7 @@ class DisplayAction implements ActionInterface
                 'message'   => 'RSS-Bridge is down for maintenance.',
             ]), 503);
         }
+
         $cacheKey = 'http_' . json_encode($request);
         /** @var Response $cachedResponse */
         $cachedResponse = $this->cache->get($cacheKey);
@@ -80,16 +81,19 @@ class DisplayAction implements ActionInterface
             $this->cache->set($cacheKey, $response, $ttl);
         }
 
-        if (in_array($response->getCode(), [429, 503])) {
-            $this->cache->set($cacheKey, $response, 60 * 15 + rand(1, 60 * 10)); // average 20m
+        if (in_array($response->getCode(), [403, 429, 503])) {
+            // Cache these responses for about ~20 mins on average
+            $this->cache->set($cacheKey, $response, 60 * 15 + rand(1, 60 * 10));
         }
 
         if ($response->getCode() === 500) {
             $this->cache->set($cacheKey, $response, 60 * 15);
         }
+
         if (rand(1, 100) === 2) {
             $this->cache->prune();
         }
+
         return $response;
     }
 
@@ -187,6 +191,7 @@ class DisplayAction implements ActionInterface
 
     private function logBridgeError($bridgeName, $code)
     {
+        // todo: it's not really necessary to json encode $report
         $cacheKey = 'error_reporting_' . $bridgeName . '_' . $code;
         $report = $this->cache->get($cacheKey);
         if ($report) {
diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index f761afaa..c393c146 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -85,6 +85,11 @@ class RedditBridge extends BridgeAbstract
             if ($e->getCode() === 429) {
                 $this->cache->set($cacheKey, true, 60 * 16);
             }
+            if ($e->getCode() === 403) {
+                // 403 Forbidden
+                // This can possibly mean that reddit has permanently blocked this server's ip address
+                $this->cache->set($cacheKey, true, 60 * 61);
+            }
             throw $e;
         }
     }
diff --git a/lib/contents.php b/lib/contents.php
index 055d6bf3..a4def21a 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -71,6 +71,7 @@ function getContents(
                 // Ignore invalid 'Last-Modified' HTTP header value
             }
         }
+        // todo: to be nice nice citizen we should also check for Etag
     }
 
     $response = $httpClient->request($url, $config);
diff --git a/lib/http.php b/lib/http.php
index c5c57d05..eb70705f 100644
--- a/lib/http.php
+++ b/lib/http.php
@@ -2,6 +2,7 @@
 
 class HttpException extends \Exception
 {
+    // todo: should include the failing http response (if present)
 }
 
 final class CloudFlareException extends HttpException

From 0c4b498d4f41d8402bbc33cbf2864e13c0d76ba2 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 13 Dec 2023 22:06:47 +0100
Subject: [PATCH 218/716] fix(reddit): tweak internal cache logic (#3831)

---
 bridges/RedditBridge.php | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index c393c146..2b7fe84f 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -75,20 +75,26 @@ class RedditBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $cacheKey = 'reddit_rate_limit';
-        if ($this->cache->get($cacheKey)) {
+        $forbiddenKey = 'reddit_forbidden';
+        if ($this->cache->get($forbiddenKey)) {
+            throw new HttpException('403 Forbidden', 403);
+        }
+
+        $rateLimitKey = 'reddit_rate_limit';
+        if ($this->cache->get($rateLimitKey)) {
             throw new HttpException('429 Too Many Requests', 429);
         }
+
         try {
             $this->collectDataInternal();
         } catch (HttpException $e) {
-            if ($e->getCode() === 429) {
-                $this->cache->set($cacheKey, true, 60 * 16);
-            }
             if ($e->getCode() === 403) {
                 // 403 Forbidden
                 // This can possibly mean that reddit has permanently blocked this server's ip address
-                $this->cache->set($cacheKey, true, 60 * 61);
+                $this->cache->set($forbiddenKey, true, 60 * 61);
+            }
+            if ($e->getCode() === 429) {
+                $this->cache->set($rateLimitKey, true, 60 * 16);
             }
             throw $e;
         }

From 38e9c396cfe6b933f1752942385dcf5ee05730d6 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 13 Dec 2023 22:20:21 +0100
Subject: [PATCH 219/716] fix(codeberg): css selector tweak (#3832)

* fix(codeberg): css selector tweak

* yup
---
 bridges/CodebergBridge.php | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/bridges/CodebergBridge.php b/bridges/CodebergBridge.php
index 2a450477..79dd706c 100644
--- a/bridges/CodebergBridge.php
+++ b/bridges/CodebergBridge.php
@@ -79,9 +79,9 @@ class CodebergBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $html = getSimpleHTMLDOM($this->getURI());
-
-        $html = defaultLinkTo($html, $this->getURI());
+        $url = $this->getURI();
+        $html = getSimpleHTMLDOM($url);
+        $html = defaultLinkTo($html, $url);
 
         switch ($this->queriedContext) {
             case 'Commits':
@@ -205,22 +205,22 @@ class CodebergBridge extends BridgeAbstract
      */
     private function extractIssues($html)
     {
-        $div = $html->find('div.issue.list', 0);
+        $issueList = $html->find('div#issue-list', 0);
 
-        foreach ($div->find('li.item') as $li) {
+        foreach ($issueList->find('div.flex-item') as $div) {
             $item = [];
 
-            $number = trim($li->find('a.index,ml-0.mr-2', 0)->plaintext);
+            $number = trim($div->find('a.index,ml-0.mr-2', 0)->plaintext);
 
-            $item['title'] = $li->find('a.title', 0)->plaintext . ' (' . $number . ')';
-            $item['uri'] = $li->find('a.title', 0)->href;
+            $item['title'] = $div->find('a.issue-title', 0)->plaintext . ' (' . $number . ')';
+            $item['uri'] = $div->find('a.issue-title', 0)->href;
 
-            $time = $li->find('relative-time.time-since', 0);
+            $time = $div->find('relative-time.time-since', 0);
             if ($time) {
                 $item['timestamp'] = $time->datetime;
             }
 
-            $item['author'] = $li->find('div.desc', 0)->find('a', 1)->plaintext;
+            //$item['author'] = $li->find('div.desc', 0)->find('a', 1)->plaintext;
 
             // Fetch issue page
             $issuePage = getSimpleHTMLDOMCached($item['uri'], 3600);
@@ -228,7 +228,7 @@ class CodebergBridge extends BridgeAbstract
 
             $item['content'] = $issuePage->find('div.timeline-item.comment.first', 0)->find('div.render-content.markup', 0);
 
-            foreach ($li->find('a.ui.label') as $label) {
+            foreach ($div->find('a.ui.label') as $label) {
                 $item['categories'][] = $label->plaintext;
             }
 

From d127bf6e009318914f9b35222fcd97ff137dad57 Mon Sep 17 00:00:00 2001
From: Arnav Jain <ajain-93@users.noreply.github.com>
Date: Fri, 15 Dec 2023 23:36:50 +0100
Subject: [PATCH 220/716] [DagensNyheterDirektBridge] New bridge (#3834)

* [DagensNyheterDirektBridge] New bridge

* [DagensNyheterDirektBridge] Lint: Replace all tabs with space

* [DagensNyheterDirektBridge] Lint: Lines

Add empty lines and move start brace to new line

* [DagensNyheterDirektBridge] Lint: short- array syntax

* [DagensNyheterDirektBridge] Lint: short array syntax

Fix incorrect line ending

* [DagensNyheterDirektBridge] Lint: further lint fixes

* [DagensNyheterDirektBridge] Lint: final fixes
---
 bridges/DagensNyheterDirektBridge.php | 62 +++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)
 create mode 100644 bridges/DagensNyheterDirektBridge.php

diff --git a/bridges/DagensNyheterDirektBridge.php b/bridges/DagensNyheterDirektBridge.php
new file mode 100644
index 00000000..4d1629fb
--- /dev/null
+++ b/bridges/DagensNyheterDirektBridge.php
@@ -0,0 +1,62 @@
+<?PHP
+
+class DagensNyheterDirektBridge extends BridgeAbstract
+{
+    const NAME          = 'Dagens Nyheter Direkt';
+    const URI           = 'https://www.dn.se/direkt/';
+    const BASEURL       = 'https://www.dn.se';
+    const DESCRIPTION   = 'Latest news summarised by Dagens Nyheter';
+    const MAINTAINER    = 'ajain-93';
+    const LIMIT         = 20;
+
+    public function getIcon()
+    {
+        return 'https://cdn.dn-static.se/images/favicon__c2dd3284b46ffdf4d520536e526065fa8.svg';
+    }
+
+    public function collectData()
+    {
+        $NEWSURL = self::BASEURL . '/ajax/direkt/';
+
+        $html = getSimpleHTMLDOM($NEWSURL) or
+            returnServerError('Could not request: ' . $NEWSURL);
+
+        foreach ($html->find('article') as $element) {
+            $link = $element->find('button', 0)->getAttribute('data-link');
+            $datetime = $element->getAttribute('data-publication-time');
+            $url = self::BASEURL . $link;
+            $title = $element->find('h2', 0)->plaintext;
+            $author = $element->find('div.ds-byline__titles', 0)->plaintext;
+            // Debug::log($link);
+            // Debug::log($datetime);
+            // Debug::log($title);
+            // Debug::log($url);
+            // Debug::log($author);
+
+            $article_content = $element->find('div.direkt-post__content', 0);
+            $article_html = '';
+
+            $figure = $element->find('figure', 0);
+
+            if ($figure) {
+                $article_html = $figure->find('img', 0) . '<p><i>' . $figure->find('figcaption', 0) . '</i></p>';
+            }
+
+            foreach ($article_content->find('p') as $p) {
+                $article_html = $article_html . $p;
+            }
+
+            $this->items[] = [
+                'uri' => $url,
+                'title' => $title,
+                'author' => trim($author),
+                'timestamp' => $datetime,
+                'content' => trim($article_html),
+            ];
+
+            if (count($this->items) > self::LIMIT) {
+                break;
+            }
+        }
+    }
+}

From 4e1fa946b4915164c0ec2f09090999597b9d69ad Mon Sep 17 00:00:00 2001
From: ash <153942603+xz47sv@users.noreply.github.com>
Date: Fri, 15 Dec 2023 23:39:04 +0100
Subject: [PATCH 221/716] add rb.ash.fail to list of public hosts (#3835)

---
 docs/01_General/06_Public_Hosts.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/01_General/06_Public_Hosts.md b/docs/01_General/06_Public_Hosts.md
index de538cf1..c9572824 100644
--- a/docs/01_General/06_Public_Hosts.md
+++ b/docs/01_General/06_Public_Hosts.md
@@ -20,7 +20,8 @@
 | ![](https://iplookup.flagfox.net/images/h16/NL.png) | https://feed.eugenemolotov.ru | ![](https://img.shields.io/website/https/feed.eugenemolotov.ru.svg) | [@em92](https://github.com/em92) | Hosted in Amsterdam, Netherlands |
 | ![](https://iplookup.flagfox.net/images/h16/DE.png) | https://rss-bridge.mediani.de | ![](https://img.shields.io/website/https/rss-bridge.mediani.de.svg) | [@sokai](https://github.com/sokai) | Hosted with Netcup, Germany |
 | ![](https://iplookup.flagfox.net/images/h16/PL.png) | https://rss.foxhaven.cyou| ![](https://img.shields.io/badge/website-up-brightgreen) | [@Aysilu](https://foxhaven.cyou) | Hosted with Timeweb (Maintained in Poland) |
-| ![](https://iplookup.flagfox.net/images/h16/PL.png) | https://rss.m3wz.su| ![](https://img.shields.io/badge/website-up-brightgreen) | [@m3oweezed](https://m3wz.su/en/about) | Poland, Hosted with Timeweb Cloud
+| ![](https://iplookup.flagfox.net/images/h16/PL.png) | https://rss.m3wz.su| ![](https://img.shields.io/badge/website-up-brightgreen) | [@m3oweezed](https://m3wz.su/en/about) | Poland, Hosted with Timeweb Cloud |
+| ![](https://iplookup.flagfox.net/images/h16/DE.png) | https://rb.ash.fail | ![](https://img.shields.io/website/https/rb.ash.fail.svg) | [@ash](https://ash.fail/contact.html) | Hosted with Hostaris, Germany
 
 
 ## Inactive instances

From d4ae55733b6f7684de0b878d91e53c8a5f917d41 Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Fri, 15 Dec 2023 23:39:27 +0100
Subject: [PATCH 222/716] Update GolemBridge.php (#3836)

deleted the code which adds the author to the feed, because the author is already in the original feed, so it is not needed.
---
 bridges/GolemBridge.php | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/bridges/GolemBridge.php b/bridges/GolemBridge.php
index 6699e433..debf5b29 100644
--- a/bridges/GolemBridge.php
+++ b/bridges/GolemBridge.php
@@ -82,11 +82,6 @@ class GolemBridge extends FeedExpander
             // URI without RSS feed reference
             $item['uri'] = $articlePage->find('head meta[name="twitter:url"]', 0)->content;
 
-            $author = $articlePage->find('article header .authors .authors__name', 0);
-            if ($author) {
-                $item['author'] = $author->plaintext;
-            }
-
             $categories = $articlePage->find('ul.tags__list li');
             foreach ($categories as $category) {
                 $trimmedcategories[] = trim(html_entity_decode($category->plaintext));

From 0116dde27549fcdaf5600bc255173047e1fce4f9 Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Sat, 16 Dec 2023 10:43:27 +0100
Subject: [PATCH 223/716] [GolemBridge] Add h2 elements from article content

Else some headers are just missing.
Example article with previously missing movie names:
https://www.golem.de/news/science-fiction-die-zehn-besten-filme-aus-den-spannenden-70ern-2312-179557.html
---
 bridges/GolemBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/GolemBridge.php b/bridges/GolemBridge.php
index debf5b29..c1b03433 100644
--- a/bridges/GolemBridge.php
+++ b/bridges/GolemBridge.php
@@ -132,7 +132,7 @@ class GolemBridge extends FeedExpander
             $img->src = $img->getAttribute('data-src-full');
         }
 
-        foreach ($content->find('p, h1, h3, img[src*="."]') as $element) {
+        foreach ($content->find('p, h1, h2, h3, img[src*="."]') as $element) {
             $item .= $element;
         }
 

From c5f586497f3d23be61a6e8a5fe0f948f98a5b2f6 Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Sat, 16 Dec 2023 11:21:19 +0100
Subject: [PATCH 224/716] [GolemBridge] Remove multi-page page headers

On multi-page articles like [1], all the pages after the first one have
a page header that we add in the article content. When we tack the
pages together again, we don't need those extra page headers.

[1] https://www.golem.de/news/science-fiction-die-zehn-besten-filme-aus-den-spannenden-70ern-2312-179557.html
---
 bridges/GolemBridge.php | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/bridges/GolemBridge.php b/bridges/GolemBridge.php
index c1b03433..599d713a 100644
--- a/bridges/GolemBridge.php
+++ b/bridges/GolemBridge.php
@@ -116,9 +116,6 @@ class GolemBridge extends FeedExpander
         // reload html, as remove() is buggy
         $article = str_get_html($article->outertext);
 
-        if ($pageHeader = $article->find('header.paged-cluster-header h1', 0)) {
-            $item .= $pageHeader;
-        }
 
         $header = $article->find('header', 0);
         foreach ($header->find('p, figure') as $element) {

From b34fa2d278eb14172cbeac4ddf34dca90716b5cb Mon Sep 17 00:00:00 2001
From: Brendan Kidwell <snarf@glump.net>
Date: Sun, 17 Dec 2023 11:08:40 -0500
Subject: [PATCH 225/716] RumbleBridge - new selector needed on user/channel
 page (#3843)

---
 bridges/RumbleBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/RumbleBridge.php b/bridges/RumbleBridge.php
index 08b416bf..d5b82136 100644
--- a/bridges/RumbleBridge.php
+++ b/bridges/RumbleBridge.php
@@ -39,7 +39,7 @@ class RumbleBridge extends BridgeAbstract
         }
 
         $dom = getSimpleHTMLDOM($url);
-        foreach ($dom->find('li.video-listing-entry') as $video) {
+        foreach ($dom->find('ol.thumbnail__grid div.thumbnail__grid--item') as $video) {
             $datetime = $video->find('time', 0)->getAttribute('datetime');
 
             $this->items[] = [

From 3944ae68cbe8b8dd4fd653a288cffdb42cd3802e Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 19 Dec 2023 07:53:25 +0100
Subject: [PATCH 226/716] fix(reddit): use old.reddit.com instead of
 www.reddit.com (#3848)

---
 bridges/RedditBridge.php | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index 2b7fe84f..bb3e7afc 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -1,10 +1,15 @@
 <?php
 
+/**
+ * This bridge does NOT use reddit's official rss feeds.
+ *
+ * This bridge uses reddit's json api: https://old.reddit.com/search.json?q=
+ */
 class RedditBridge extends BridgeAbstract
 {
     const MAINTAINER = 'dawidsowa';
     const NAME = 'Reddit Bridge';
-    const URI = 'https://www.reddit.com';
+    const URI = 'https://old.reddit.com';
     const DESCRIPTION = 'Return hot submissions from Reddit';
 
     const PARAMETERS = [

From 0c6ffbf5a44ccbd3948b969063916f518e76c5d8 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 19 Dec 2023 08:46:37 +0100
Subject: [PATCH 227/716] fix(gatesnotes): the unfucked their json (#3849)

---
 bridges/GatesNotesBridge.php | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/bridges/GatesNotesBridge.php b/bridges/GatesNotesBridge.php
index 24ba9b2e..0d919968 100644
--- a/bridges/GatesNotesBridge.php
+++ b/bridges/GatesNotesBridge.php
@@ -23,12 +23,14 @@ class GatesNotesBridge extends BridgeAbstract
         $cleanedContent = str_replace([
             '<string xmlns="http://schemas.microsoft.com/2003/10/Serialization/">',
             '</string>',
-            '\r\n',
         ], '', $rawContent);
-        $cleanedContent = str_replace('\"', '"', $cleanedContent);
-        $cleanedContent = trim($cleanedContent, '"');
+        // $cleanedContent = str_replace('\"', '"', $cleanedContent);
+        // $cleanedContent = trim($cleanedContent, '"');
 
         $json = Json::decode($cleanedContent, false);
+        if (is_string($json)) {
+            throw new \Exception('wtf? ' . $json);
+        }
 
         foreach ($json as $article) {
             $item = [];

From 98a94855dc6b909b75629c6630c3795c68e7d560 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 20 Dec 2023 03:16:25 +0100
Subject: [PATCH 228/716] feat: embed response in http exception (#3847)

---
 bridges/GettrBridge.php      | 10 +++++++++-
 config.default.ini.php       |  3 ++-
 lib/contents.php             | 15 ++-------------
 lib/http.php                 | 24 +++++++++++++++++++++++-
 templates/exception.html.php | 23 +++++++++++++++++++++++
 5 files changed, 59 insertions(+), 16 deletions(-)

diff --git a/bridges/GettrBridge.php b/bridges/GettrBridge.php
index 74804043..d3b9b899 100644
--- a/bridges/GettrBridge.php
+++ b/bridges/GettrBridge.php
@@ -33,7 +33,15 @@ class GettrBridge extends BridgeAbstract
             $user,
             min($this->getInput('limit'), 20)
         );
-        $data = json_decode(getContents($api), false);
+        try {
+            $json = getContents($api);
+        } catch (HttpException $e) {
+            if ($e->getCode() === 400 && str_contains($e->response->getBody(), 'E_USER_NOTFOUND')) {
+                throw new \Exception('User not found: ' . $user);
+            }
+            throw $e;
+        }
+        $data = json_decode($json, false);
 
         foreach ($data->result->aux->post as $post) {
             $this->items[] = [
diff --git a/config.default.ini.php b/config.default.ini.php
index 52786aef..201b1414 100644
--- a/config.default.ini.php
+++ b/config.default.ini.php
@@ -47,7 +47,8 @@ enable_debug_mode = false
 enable_maintenance_mode = false
 
 [http]
-timeout = 60
+; Operation timeout in seconds
+timeout = 30
 useragent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Firefox/102.0"
 
 ; Max http response size in MB
diff --git a/lib/contents.php b/lib/contents.php
index a4def21a..8676a2a8 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -101,19 +101,8 @@ function getContents(
             $response = $response->withBody($cachedResponse->getBody());
             break;
         default:
-            $exceptionMessage = sprintf(
-                '%s resulted in %s %s %s',
-                $url,
-                $response->getCode(),
-                $response->getStatusLine(),
-                // If debug, include a part of the response body in the exception message
-                Debug::isEnabled() ? mb_substr($response->getBody(), 0, 500) : '',
-            );
-
-            if (CloudFlareException::isCloudFlareResponse($response)) {
-                throw new CloudFlareException($exceptionMessage, $response->getCode());
-            }
-            throw new HttpException(trim($exceptionMessage), $response->getCode());
+            $e = HttpException::fromResponse($response, $url);
+            throw $e;
     }
     if ($returnFull === true) {
         // todo: return the actual response object
diff --git a/lib/http.php b/lib/http.php
index eb70705f..bfa6b6bf 100644
--- a/lib/http.php
+++ b/lib/http.php
@@ -2,7 +2,29 @@
 
 class HttpException extends \Exception
 {
-    // todo: should include the failing http response (if present)
+    public ?Response $response;
+
+    public function __construct(string $message = '', int $statusCode = 0, ?Response $response = null)
+    {
+        parent::__construct($message, $statusCode);
+        $this->response = $response ?? new Response('', 0);
+    }
+
+    public static function fromResponse(Response $response, string $url): HttpException
+    {
+        $message = sprintf(
+            '%s resulted in %s %s %s',
+            $url,
+            $response->getCode(),
+            $response->getStatusLine(),
+            // If debug, include a part of the response body in the exception message
+            Debug::isEnabled() ? mb_substr($response->getBody(), 0, 500) : '',
+        );
+        if (CloudFlareException::isCloudFlareResponse($response)) {
+            return new CloudFlareException($message, $response->getCode(), $response);
+        }
+        return new HttpException(trim($message), $response->getCode(), $response);
+    }
 }
 
 final class CloudFlareException extends HttpException
diff --git a/templates/exception.html.php b/templates/exception.html.php
index dac0ad26..e1dd97c1 100644
--- a/templates/exception.html.php
+++ b/templates/exception.html.php
@@ -16,6 +16,13 @@
             </p>
         <?php endif; ?>
 
+        <?php if ($e->getCode() === 400): ?>
+            <h2>400 Bad Request</h2>
+            <p>
+                This is usually caused by an incorrectly constructed http request.
+            </p>
+        <?php endif; ?>
+
         <?php if ($e->getCode() === 404): ?>
             <h2>404 Page Not Found</h2>
             <p>
@@ -40,6 +47,22 @@
             </p>
         <?php endif; ?>
 
+        <?php if ($e->getCode() === 0): ?>
+            <p>
+                See
+                <a href="https://curl.haxx.se/libcurl/c/libcurl-errors.html">
+                    https://curl.haxx.se/libcurl/c/libcurl-errors.html
+                </a>
+                for description of the curl error code.
+            </p>
+        <?php else: ?>
+            <p>
+                <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/<?= raw($e->getCode()) ?>">
+                    https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/<?= raw($e->getCode()) ?>
+                </a>
+            </p>
+        <?php endif; ?>
+
     <?php else: ?>
         <?php if ($e->getCode() === 10): ?>
             <h2>The rss feed is completely empty</h2>

From 4e40e032b0fcac52bc74ba5994cefe1d00debf45 Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Wed, 20 Dec 2023 22:18:10 +0100
Subject: [PATCH 229/716] Remove matrix reference

The main communications platform is still Libera.chat, matrix was only
provided by the hosted IRC-Matrix bridge. The bridge was turned off
already and won't come back.
---
 README.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/README.md b/README.md
index 570fb87d..2a762d45 100644
--- a/README.md
+++ b/README.md
@@ -11,7 +11,6 @@ Officially hosted instance: https://rss-bridge.org/bridge01/
 [![LICENSE](https://img.shields.io/badge/license-UNLICENSE-blue.svg)](UNLICENSE)
 [![GitHub release](https://img.shields.io/github/release/rss-bridge/rss-bridge.svg?logo=github)](https://github.com/rss-bridge/rss-bridge/releases/latest)
 [![irc.libera.chat](https://img.shields.io/badge/irc.libera.chat-%23rssbridge-blue.svg)](https://web.libera.chat/#rssbridge)
-[![Chat on Matrix](https://matrix.to/img/matrix-badge.svg)](https://matrix.to/#/#rssbridge:libera.chat)
 [![Actions Status](https://img.shields.io/github/actions/workflow/status/RSS-Bridge/rss-bridge/tests.yml?branch=master&label=GitHub%20Actions&logo=github)](https://github.com/RSS-Bridge/rss-bridge/actions)
 
 |||

From 4c5cf89725e7ebd975eb6ec5136b5e3927df07fe Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 21 Dec 2023 09:18:21 +0100
Subject: [PATCH 230/716] fix(rumble): not all videos have a datetime (#3852)

---
 bridges/RumbleBridge.php | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/bridges/RumbleBridge.php b/bridges/RumbleBridge.php
index d5b82136..f6bfca7d 100644
--- a/bridges/RumbleBridge.php
+++ b/bridges/RumbleBridge.php
@@ -40,15 +40,18 @@ class RumbleBridge extends BridgeAbstract
 
         $dom = getSimpleHTMLDOM($url);
         foreach ($dom->find('ol.thumbnail__grid div.thumbnail__grid--item') as $video) {
-            $datetime = $video->find('time', 0)->getAttribute('datetime');
-
-            $this->items[] = [
+            $item = [
                 'title'     => $video->find('h3', 0)->plaintext,
                 'uri'       => self::URI . $video->find('a', 0)->href,
-                'timestamp' => (new \DateTimeImmutable($datetime))->getTimestamp(),
                 'author'    => $account . '@rumble.com',
                 'content'   => defaultLinkTo($video, self::URI)->innertext,
             ];
+            $time = $video->find('time', 0);
+            if ($time) {
+                $publishedAt = new \DateTimeImmutable($time->getAttribute('datetime'));
+                $item['timestamp'] = $publishedAt->getTimestamp();
+            }
+            $this->items[] = $item;
         }
     }
 

From f40f99740588b09033917fd38132a99875495540 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 21 Dec 2023 09:24:22 +0100
Subject: [PATCH 231/716] fix: various small fixes (#3853)

---
 bridges/ARDAudiothekBridge.php | 20 +++++++++++++-------
 bridges/CarThrottleBridge.php  |  6 ++----
 bridges/EZTVBridge.php         |  2 +-
 bridges/TrelloBridge.php       |  2 +-
 bridges/YoutubeBridge.php      |  6 +++++-
 5 files changed, 22 insertions(+), 14 deletions(-)

diff --git a/bridges/ARDAudiothekBridge.php b/bridges/ARDAudiothekBridge.php
index 2c1958f3..619c0911 100644
--- a/bridges/ARDAudiothekBridge.php
+++ b/bridges/ARDAudiothekBridge.php
@@ -63,11 +63,13 @@ class ARDAudiothekBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $oldTz = date_default_timezone_get();
+        $path = $this->getInput('path');
+        $limit = $this->getInput('limit');
 
+        $oldTz = date_default_timezone_get();
         date_default_timezone_set('Europe/Berlin');
 
-        $pathComponents = explode('/', $this->getInput('path'));
+        $pathComponents = explode('/', $path);
         if (empty($pathComponents)) {
             returnClientError('Path may not be empty');
         }
@@ -82,17 +84,21 @@ class ARDAudiothekBridge extends BridgeAbstract
         }
 
         $url = self::APIENDPOINT . 'programsets/' . $showID . '/';
-        $rawJSON = getContents($url);
-        $processedJSON = json_decode($rawJSON)->data->programSet;
+        $json1 = getContents($url);
+        $data1 = Json::decode($json1, false);
+        $processedJSON = $data1->data->programSet;
+        if (!$processedJSON) {
+            throw new \Exception('Unable to find show id: ' . $showID);
+        }
 
-        $limit = $this->getInput('limit');
         $answerLength = 1;
         $offset = 0;
         $numberOfElements = 1;
 
         while ($answerLength != 0 && $offset < $numberOfElements && (is_null($limit) || $offset < $limit)) {
-            $rawJSON = getContents($url . '?offset=' . $offset);
-            $processedJSON = json_decode($rawJSON)->data->programSet;
+            $json2 = getContents($url . '?offset=' . $offset);
+            $data2 = Json::decode($json2, false);
+            $processedJSON = $data2->data->programSet;
 
             $answerLength = count($processedJSON->items->nodes);
             $offset = $offset + $answerLength;
diff --git a/bridges/CarThrottleBridge.php b/bridges/CarThrottleBridge.php
index 913b686c..70d7b54e 100644
--- a/bridges/CarThrottleBridge.php
+++ b/bridges/CarThrottleBridge.php
@@ -9,8 +9,7 @@ class CarThrottleBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $news = getSimpleHTMLDOMCached(self::URI . 'news')
-            or returnServerError('could not retrieve page');
+        $news = getSimpleHTMLDOMCached(self::URI . 'news');
 
         $this->items[] = [];
 
@@ -22,8 +21,7 @@ class CarThrottleBridge extends BridgeAbstract
             $item['uri'] = self::URI . $titleElement->getAttribute('href');
             $item['title'] = $titleElement->innertext;
 
-            $articlePage = getSimpleHTMLDOMCached($item['uri'])
-                or returnServerError('could not retrieve page');
+            $articlePage = getSimpleHTMLDOMCached($item['uri']);
 
             $authorDiv = $articlePage->find('div.author div');
             if ($authorDiv) {
diff --git a/bridges/EZTVBridge.php b/bridges/EZTVBridge.php
index 73318f0c..25a88124 100644
--- a/bridges/EZTVBridge.php
+++ b/bridges/EZTVBridge.php
@@ -96,7 +96,7 @@ class EZTVBridge extends BridgeAbstract
     protected function getItemFromTorrent($torrent)
     {
         $item = [];
-        $item['uri'] = $torrent->episode_url;
+        $item['uri'] = $torrent->episode_url ?? $torrent->torrent_url;
         $item['author'] = $torrent->imdb_id;
         $item['timestamp'] = $torrent->date_released_unix;
         $item['title'] = $torrent->title;
diff --git a/bridges/TrelloBridge.php b/bridges/TrelloBridge.php
index a1b5cfb8..cab2bde2 100644
--- a/bridges/TrelloBridge.php
+++ b/bridges/TrelloBridge.php
@@ -648,7 +648,7 @@ class TrelloBridge extends BridgeAbstract
                 $action->type
             ];
             if (isset($action->data->card)) {
-                $item['categories'][] = $action->data->card->name;
+                $item['categories'][] = $action->data->card->name ?? $action->data->card->id;
                 $item['uri'] = 'https://trello.com/c/'
                     . $action->data->card->shortLink
                     . '#action-'
diff --git a/bridges/YoutubeBridge.php b/bridges/YoutubeBridge.php
index 993f8c90..6a29e387 100644
--- a/bridges/YoutubeBridge.php
+++ b/bridges/YoutubeBridge.php
@@ -164,7 +164,11 @@ class YoutubeBridge extends BridgeAbstract
             $jsonData = $this->extractJsonFromHtml($html);
             // TODO: this method returns only first 100 video items
             // if it has more videos, playlistVideoListRenderer will have continuationItemRenderer as last element
-            $jsonData = $jsonData->contents->twoColumnBrowseResultsRenderer->tabs[0];
+            $jsonData = $jsonData->contents->twoColumnBrowseResultsRenderer->tabs[0] ?? null;
+            if (!$jsonData) {
+                // playlist probably doesnt exists
+                throw new \Exception('Unable to find playlist: ' . $url_listing);
+            }
             $jsonData = $jsonData->tabRenderer->content->sectionListRenderer->contents[0]->itemSectionRenderer;
             $jsonData = $jsonData->contents[0]->playlistVideoListRenderer->contents;
             $item_count = count($jsonData);

From ea2b4d7506f0feded2899cb0aab351fa7dca3194 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Sat, 23 Dec 2023 03:42:37 -0500
Subject: [PATCH 232/716] [ArsTechnicaBridge] Properly handle paged content
 (#3855)

* [ArsTechnicaBridge] Properly handle paged content

* [ArsTechnicaBridge] Remove normal site ad wrapper
---
 bridges/ArsTechnicaBridge.php | 31 +++++++++++++------------------
 1 file changed, 13 insertions(+), 18 deletions(-)

diff --git a/bridges/ArsTechnicaBridge.php b/bridges/ArsTechnicaBridge.php
index 613c1c58..2c631871 100644
--- a/bridges/ArsTechnicaBridge.php
+++ b/bridges/ArsTechnicaBridge.php
@@ -35,39 +35,34 @@ class ArsTechnicaBridge extends FeedExpander
 
     protected function parseItem(array $item)
     {
-        $item_html = getSimpleHTMLDOMCached($item['uri'] . '&amp');
+        $item_html = getSimpleHTMLDOMCached($item['uri']);
         $item_html = defaultLinkTo($item_html, self::URI);
+        $item['content'] = $item_html->find('.article-content', 0);
 
-        $item_content = $item_html->find('.article-content.post-page', 0);
-        if (!$item_content) {
-            // The dom selector probably broke. Let's just return the item as-is
-            return $item;
+        $pages = $item_html->find('nav.page-numbers > .numbers > a', -2);
+        if (null !== $pages) {
+            for ($i = 2; $i <= $pages->innertext; $i++) {
+                $page_url = $item['uri'] . '&page=' . $i;
+                $page_html = getSimpleHTMLDOMCached($page_url);
+                $page_html = defaultLinkTo($page_html, self::URI);
+                $item['content'] .= $page_html->find('.article-content', 0);
+            }
+            $item['content'] = str_get_html($item['content']);
         }
 
-        $item['content'] = $item_content;
-
         // remove various ars advertising
         $item['content']->find('#social-left', 0)->remove();
         foreach ($item['content']->find('.ars-component-buy-box') as $ad) {
             $ad->remove();
         }
-        foreach ($item['content']->find('i-amphtml-sizer') as $ad) {
+        foreach ($item['content']->find('.ad_wrapper') as $ad) {
             $ad->remove();
         }
         foreach ($item['content']->find('.sidebar') as $ad) {
             $ad->remove();
         }
 
-        foreach ($item['content']->find('a') as $link) { //remove amp redirect links
-            $url = $link->getAttribute('href');
-            if (str_contains($url, 'go.redirectingat.com')) {
-                $url = extractFromDelimiters($url, 'url=', '&amp');
-                $url = urldecode($url);
-                $link->setAttribute('href', $url);
-            }
-        }
-
-        $item['content'] = backgroundToImg(str_replace('data-amp-original-style="background-image', 'style="background-image', $item['content']));
+        $item['content'] = backgroundToImg($item['content']);
 
         $item['uid'] = explode('=', $item['uri'])[1];
 

From 98dafb61ae5519b7c6c4be2d7dd4d66b6bd6a4eb Mon Sep 17 00:00:00 2001
From: xduugu <xduugu@gmx.com>
Date: Sat, 23 Dec 2023 08:43:01 +0000
Subject: [PATCH 233/716] [ARDAudiothekBridge] add duration to feed items
 (#3854)

---
 bridges/ARDAudiothekBridge.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/bridges/ARDAudiothekBridge.php b/bridges/ARDAudiothekBridge.php
index 619c0911..02b6b007 100644
--- a/bridges/ARDAudiothekBridge.php
+++ b/bridges/ARDAudiothekBridge.php
@@ -125,6 +125,10 @@ class ARDAudiothekBridge extends BridgeAbstract
                     $item['categories'] = [$category];
                 }
 
+                $item['itunes'] = [
+                    'duration' => $audio->duration,
+                ];
+
                 $this->items[] = $item;
             }
         }

From 9f163ab7c651f44c1d6266ca817aca2c0f208f51 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Mon, 25 Dec 2023 14:51:51 +0100
Subject: [PATCH 234/716] [FreeTelechargerBridge] Update to the new URL (#3856)

* [FreeTelechargerBridge] Update to the new URL

Website has changed URL and some design : this bridge is now adapted to
thoses changes

* [FreeTelechargerBridge] Fix example value

Example valuse seems to use an "old" template, switch to a newer example
that use the new template

* [FreeTelechargerBridge] Fix notice

Fix notice
---
 bridges/FreeTelechargerBridge.php | 61 ++++++++++++++++---------------
 1 file changed, 32 insertions(+), 29 deletions(-)

diff --git a/bridges/FreeTelechargerBridge.php b/bridges/FreeTelechargerBridge.php
index 8362b4ff..f0e5d35a 100644
--- a/bridges/FreeTelechargerBridge.php
+++ b/bridges/FreeTelechargerBridge.php
@@ -3,7 +3,7 @@
 class FreeTelechargerBridge extends BridgeAbstract
 {
     const NAME = 'Free-Telecharger';
-    const URI = 'https://www.free-telecharger.live/';
+    const URI = 'https://www.free-telecharger.art/';
     const DESCRIPTION = 'Suivi de série sur Free-Telecharger';
     const MAINTAINER  = 'sysadminstory';
     const PARAMETERS = [
@@ -12,43 +12,46 @@ class FreeTelechargerBridge extends BridgeAbstract
                             'name' => 'URL de la série',
                             'type' => 'text',
                             'required' => true,
-                            'title' => 'URL d\'une série sans le https://www.free-telecharger.live/',
+                            'title' => 'URL d\'une série sans le https://www.free-telecharger.art/',
                             'pattern' => 'series.*\.html',
-                            'exampleValue' => 'series-vf-hd/145458-the-last-of-us-saison-1-web-dl-720p.html'
+                            'exampleValue' => 'series-vf-hd/151432-wolf-saison-1-complete-web-dl-720p.html'
                     ],
             ]
     ];
     const CACHE_TIMEOUT = 3600;
+    private string $showTitle;
+    private string $showTechDetails;
+
     public function collectData()
     {
-            $html = getSimpleHTMLDOM(self::URI . $this->getInput('url'));
+        $html = getSimpleHTMLDOM(self::URI . $this->getInput('url'));
 
-            // Find all block content of the page
-            $blocks = $html->find('div[class=block1]');
+        // Find all block content of the page
+        $blocks = $html->find('div[class=block1]');
 
-            // Global Infos block
-            $infosBlock = $blocks[0];
-            // Links block
-            $linksBlock = $blocks[2];
+        // Global Infos block
+        $infosBlock = $blocks[0];
+        // Links block
+        $linksBlock = $blocks[2];
 
-            // Extract Global Show infos
-            $this->showTitle = trim($infosBlock->find('div[class=titre1]', 0)->find('font', 0)->plaintext);
-            $this->showTechDetails = trim($infosBlock->find('div[align=center]', 0)->find('b', 0)->plaintext);
+        // Extract Global Show infos
+        $this->showTitle = trim($infosBlock->find('div[class=titre1]', 0)->find('font', 0)->plaintext);
+        $this->showTechDetails = trim($infosBlock->find('div[align=center]', 0)->find('b', 0)->plaintext);
 
 
 
-            // Get Episodes names and links
-            $episodes = $linksBlock->find('div[id=link]', 0)->find('font[color=#ff6600]');
-            $links = $linksBlock->find('div[id=link]', 0)->find('a');
+        // Get Episodes names and links
+        $episodes = $linksBlock->find('div[id=link]', 0)->find('font[color=#e93100]');
+        $links = $linksBlock->find('div[id=link]', 0)->find('a');
 
         foreach ($episodes as $index => $episode) {
-                    $item = []; // Create an empty item
-                    $item['title'] = $this->showTitle . ' ' . $this->showTechDetails . '  - ' . ltrim(trim($episode->plaintext), '-');
-                    $item['uri'] = $links[$index]->href;
-                    $item['content'] = '<a href="' . $item['uri'] . '">' . $item['title'] . '</a>';
-                    $item['uid'] = hash('md5', $item['uri']);
+            $item = []; // Create an empty item
+            $item['title'] = $this->showTitle . ' ' . $this->showTechDetails . '  - ' . ltrim(trim($episode->plaintext), '-');
+            $item['uri'] = $links[$index]->href;
+            $item['content'] = '<a href="' . $item['uri'] . '">' . $item['title'] . '</a>';
+            $item['uid'] = hash('md5', $item['uri']);
 
-                    $this->items[] = $item; // Add this item to the list
+            $this->items[] = $item; // Add this item to the list
         }
     }
 
@@ -57,7 +60,7 @@ class FreeTelechargerBridge extends BridgeAbstract
         switch ($this->queriedContext) {
             case 'Suivi de publication de série':
                 return $this->showTitle . ' ' . $this->showTechDetails . ' - ' . self::NAME;
-            break;
+                break;
             default:
                 return self::NAME;
         }
@@ -68,7 +71,7 @@ class FreeTelechargerBridge extends BridgeAbstract
         switch ($this->queriedContext) {
             case 'Suivi de publication de série':
                 return self::URI . $this->getInput('url');
-            break;
+                break;
             default:
                 return self::URI;
         }
@@ -76,14 +79,14 @@ class FreeTelechargerBridge extends BridgeAbstract
 
     public function detectParameters($url)
     {
-        // Example: https://www.free-telecharger.live/series-vf-hd/145458-the-last-of-us-saison-1-web-dl-720p.html
+        // Example: https://www.free-telecharger.art/series-vf-hd/151432-wolf-saison-1-complete-web-dl-720p.html
 
         $params = [];
-        $regex = '/^https:\/\/www.*\.free-telecharger\.live\/(series.*\.html)/';
+        $regex = '/^https:\/\/www.*\.free-telecharger\.art\/(series.*\.html)/';
         if (preg_match($regex, $url, $matches) > 0) {
-                $params['context'] = 'Suivi de publication de série';
-                $params['url'] = urldecode($matches[1]);
-                return $params;
+            $params['context'] = 'Suivi de publication de série';
+            $params['url'] = urldecode($matches[1]);
+            return $params;
         }
 
         return null;

From c9074facfed51371a59dd189648c5a80751feb4e Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Tue, 26 Dec 2023 12:18:42 +0100
Subject: [PATCH 235/716] [GreatFonBridge] Remove bridge (#3857)

Website is unreliable, it's not useful to keep this bridge.
---
 bridges/GreatFonBridge.php | 140 -------------------------------------
 1 file changed, 140 deletions(-)
 delete mode 100644 bridges/GreatFonBridge.php

diff --git a/bridges/GreatFonBridge.php b/bridges/GreatFonBridge.php
deleted file mode 100644
index 2951634c..00000000
--- a/bridges/GreatFonBridge.php
+++ /dev/null
@@ -1,140 +0,0 @@
-<?php
-
-class GreatFonBridge extends BridgeAbstract
-{
-    const MAINTAINER = 'sysadminstory';
-    const NAME = 'GreatFon Bridge';
-    const URI = 'https://greatfon.com/';
-    const INSTAGRAMURI = 'https://www.instagram.com/';
-    const CACHE_TIMEOUT = 3600; // 1h
-    const DESCRIPTION = 'Returns GreatFon (Instagram viewer) content by user';
-
-    const PARAMETERS = [
-        'Username' => [
-            'u' => [
-                'name' => 'username',
-                'type' => 'text',
-                'title' => 'Instagram username you want to follow',
-                'exampleValue' => 'aesoprockwins',
-                'required' => true,
-            ],
-        ]
-    ];
-    const TEST_DETECT_PARAMETERS = [
-        'https://www.instagram.com/instagram/' => ['context' => 'Username', 'u' => 'instagram'],
-        'https://instagram.com/instagram/' => ['context' => 'Username', 'u' => 'instagram'],
-        'https://greatfon.com/v/instagram' => ['context' => 'Username', 'u' => 'instagram'],
-        'https://www.greatfon.com/v/instagram' => ['context' => 'Username', 'u' => 'instagram'],
-    ];
-
-    public function collectData()
-    {
-        $username = $this->getInput('u');
-        $html = getSimpleHTMLDOMCached(self::URI . '/v/' . $username);
-        $html = defaultLinkTo($html, self::URI);
-
-        foreach ($html->find('div[class*=content__item]') as $post) {
-            // Skip the ads
-            if (!str_contains($post->class, 'ads')) {
-                $url = $post->find('a[href^=https://greatfon.com/c/]', 0)->href;
-                $date = $this->parseDate($post->find('div[class=content__time-text]', 0)->plaintext);
-                $description = $post->find('img', 0)->alt;
-                $imageUrl = $post->find('img', 0)->src;
-                $author = $username;
-                $uid = $url;
-                $title = 'Post - ' . $username . ' - ' . $this->descriptionToTitle($description);
-
-                // Checking post type
-                $isVideo = (bool) $post->find('div[class=content__camera]', 0);
-                $videoNote = $isVideo ? '<p><i>(video)</i></p>' : '';
-
-                $this->items[] = [
-                    'uri'        => $url,
-                    'author'     => $author,
-                    'timestamp'  => $date,
-                    'title'      => $title,
-                    'thumbnail'  => $imageUrl,
-                    'enclosures' => [$imageUrl],
-                    'content'    => <<<HTML
-<a href="{$url}">
-        <img loading="lazy" src="{$imageUrl}" alt="{$description}"/>
-</a>
-{$videoNote}
-<p>{$description}<p>
-HTML,
-                    'uid' => $uid
-                ];
-            }
-        }
-    }
-
-    private function parseDate($content)
-    {
-        // Parse date, and transform the date into a timetamp, even in a case of a relative date
-        $date = date_create();
-
-        // Content trimmed to be sure that the "article" is at the beginning of the string and remove "ago" to make it a valid PHP date interval
-        $dateString = trim(str_replace(' ago', '', $content));
-
-        // Replace the article "an" or "a" by the number "1" to be a valid PHP date interval
-        $dateString = preg_replace('/^((an|a) )/m', '1 ', $dateString);
-
-        $relativeDate = date_interval_create_from_date_string($dateString);
-        if ($relativeDate) {
-            date_sub($date, $relativeDate);
-            // As the relative interval has the precision of a day for date older than 24 hours, we can remove the hour of the date, as it is not relevant
-            date_time_set($date, 0, 0, 0, 0);
-        } else {
-            $this->logger->info(sprintf('Unable to parse date string: %s', $dateString));
-        }
-        return date_format($date, 'r');
-    }
-
-    public function getURI()
-    {
-        if (!is_null($this->getInput('u'))) {
-            return urljoin(self::URI, '/v/' . $this->getInput('u'));
-        }
-
-        return parent::getURI();
-    }
-
-    public function getIcon()
-    {
-        return static::URI . '/images/favicon-hub-3ede543aa6d1225e8dc016ccff6879c8.ico?vsn=d';
-    }
-
-    private function descriptionToTitle($description)
-    {
-        return strlen($description) > 60 ? mb_substr($description, 0, 57) . '...' : $description;
-    }
-
-    public function getName()
-    {
-        if (!is_null($this->getInput('u'))) {
-            return 'Username ' . $this->getInput('u') . ' - GreatFon Bridge';
-        }
-        return parent::getName();
-    }
-
-    public function detectParameters($url)
-    {
-        $regex = '/^http(s|):\/\/((www\.|)(instagram.com)\/([a-zA-Z0-9_\.]{1,30})(\/reels\/|\/tagged\/|\/|)|(www\.|)(greatfon.com)\/v\/([a-zA-Z0-9_\.]{1,30}))/';
-        if (preg_match($regex, $url, $matches) > 0) {
-            $params['context'] = 'Username';
-            // Extract detected domain using the regex
-            $domain = $matches[8] ?? $matches[4];
-            if ($domain == 'greatfon.com') {
-                $params['u'] = $matches[9];
-                return $params;
-            } elseif ($domain == 'instagram.com') {
-                $params['u'] = $matches[5];
-                return $params;
-            } else {
-                return null;
-            }
-        } else {
-            return null;
-        }
-    }
-}

From 19384463857c35b1d3ef0a7dbbbcc40d2f0cba0c Mon Sep 17 00:00:00 2001
From: Florent V <floviolleau@users.noreply.github.com>
Date: Tue, 26 Dec 2023 12:19:08 +0100
Subject: [PATCH 236/716] [EdfPricesBridge] add new bridge (#3846)

* [EdfPricesBridge] add new brige

* [EdfPricesBridge] bad refactor

* [EdfPricesBridge] support php 7.4

---------

Co-authored-by: Florent VIOLLEAU <florent.violleau@samsic.fr>
---
 bridges/EdfPricesBridge.php | 106 ++++++++++++++++++++++++++++++++++++
 1 file changed, 106 insertions(+)
 create mode 100644 bridges/EdfPricesBridge.php

diff --git a/bridges/EdfPricesBridge.php b/bridges/EdfPricesBridge.php
new file mode 100644
index 00000000..f67ed30b
--- /dev/null
+++ b/bridges/EdfPricesBridge.php
@@ -0,0 +1,106 @@
+<?php
+
+class EdfPricesBridge extends BridgeAbstract
+{
+    const NAME = 'EDF tarifs';
+    // pull info from this site for now because EDF do not provide correct opendata
+    const URI = 'https://www.jechange.fr';
+    const DESCRIPTION = 'Fetches the latest infos of EDF prices';
+    const MAINTAINER = 'floviolleau';
+    const PARAMETERS = [
+        [
+            'contract' => [
+                'name' => 'Choisir un contrat',
+                'type' => 'list',
+                // we can add later HCHP, EJP, base
+                'values' => ['Tempo' => '/energie/edf/tarifs/tempo'],
+            ]
+        ]
+    ];
+    const CACHE_TIMEOUT = 7200; // 2h
+
+    /**
+     * @param simple_html_dom $html
+     * @param string $contractUri
+     * @return void
+     */
+    private function tempo(simple_html_dom $html, string $contractUri): void
+    {
+        // current color and next
+        $daysDom = $html->find('#calendrier', 0)->nextSibling()->find('.card--ejp');
+        if ($daysDom && count($daysDom) === 2) {
+            foreach ($daysDom as $dayDom) {
+                $day = trim($dayDom->find('.card__title', 0)->innertext) . '/' . (new \DateTime('now'))->format(('Y'));
+                $dayColor = $dayDom->find('.card-ejp__icon span', 0)->innertext;
+
+                $text = $day . ' - ' . $dayColor;
+                $item['uri'] = self::URI . $contractUri;
+                $item['title'] = $text;
+                $item['author'] = self::MAINTAINER;
+                $item['content'] = $text;
+                $item['uid'] = hash('sha256', $item['title']);
+
+                $this->items[] = $item;
+            }
+        }
+
+        // colors
+        $ulDom = $html->find('#tarif-de-l-offre-edf-tempo-current-date-html-year', 0)->nextSibling()->nextSibling()->nextSibling();
+        $elementsDom = $ulDom->find('li');
+        if ($elementsDom && count($elementsDom) === 3) {
+            foreach ($elementsDom as $elementDom) {
+                $item = [];
+
+                $matches = [];
+                preg_match_all('/Jour (.*) : Heures (.*) : (.*) € \/ Heures (.*) : (.*) €/um', $elementDom->innertext, $matches, PREG_SET_ORDER, 0);
+
+                if ($matches && count($matches[0]) === 6) {
+                    for ($i = 0; $i < 2; $i++) {
+                        $text = 'Jour ' . $matches[0][1] . ' - Heures ' . $matches[0][2 + 2 * $i] . ' : ' . $matches[0][3 + 2 * $i] . '€';
+                        $item['uri'] = self::URI . $contractUri;
+                        $item['title'] = $text;
+                        $item['author'] = self::MAINTAINER;
+                        $item['content'] = $text;
+                        $item['uid'] = hash('sha256', $item['title']);
+
+                        $this->items[] = $item;
+                    }
+                }
+            }
+        }
+
+        // powers
+        $ulPowerContract = $ulDom->nextSibling()->nextSibling();
+        $elementsPowerContractDom = $ulPowerContract->find('li');
+        if ($elementsPowerContractDom && count($elementsPowerContractDom) === 4) {
+            foreach ($elementsPowerContractDom as $elementPowerContractDom) {
+                $item = [];
+
+                $matches = [];
+                preg_match_all('/(.*) kVA : (.*) €/um', $elementPowerContractDom->innertext, $matches, PREG_SET_ORDER, 0);
+
+                if ($matches && count($matches[0]) === 3) {
+                    $text = $matches[0][1] . ' kVA : ' . $matches[0][2] . '€';
+                    $item['uri'] = self::URI . $contractUri;
+                    $item['title'] = $text;
+                    $item['author'] = self::MAINTAINER;
+                    $item['content'] = $text;
+                    $item['uid'] = hash('sha256', $item['title']);
+
+                    $this->items[] = $item;
+                }
+            }
+        }
+    }
+
+    public function collectData()
+    {
+        $contract = $this->getKey('contract');
+        $contractUri = $this->getInput('contract');
+        $html = getSimpleHTMLDOM(self::URI . $contractUri);
+
+        if ($contract === 'Tempo') {
+            $this->tempo($html, $contractUri);
+        }
+    }
+}

From ad2d4c7b1b538868070e0264f3692542883cac50 Mon Sep 17 00:00:00 2001
From: Florent V <floviolleau@users.noreply.github.com>
Date: Tue, 26 Dec 2023 12:20:49 +0100
Subject: [PATCH 237/716] [BridgeAbstract] use getParameters instead of static
 to allow overriding it from bridges (#3858)

---
 lib/BridgeAbstract.php | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index a7b811a8..0f86f454 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -154,8 +154,8 @@ abstract class BridgeAbstract
     {
         // Import and assign all inputs to their context
         foreach ($input as $name => $value) {
-            foreach (static::PARAMETERS as $context => $set) {
-                if (array_key_exists($name, static::PARAMETERS[$context])) {
+            foreach ($this->getParameters() as $context => $set) {
+                if (array_key_exists($name, $this->getParameters()[$context])) {
                     $this->inputs[$context][$name]['value'] = $value;
                 }
             }
@@ -163,16 +163,16 @@ abstract class BridgeAbstract
 
         // Apply default values to missing data
         $contexts = [$queriedContext];
-        if (array_key_exists('global', static::PARAMETERS)) {
+        if (array_key_exists('global', $this->getParameters())) {
             $contexts[] = 'global';
         }
 
         foreach ($contexts as $context) {
-            if (!isset(static::PARAMETERS[$context])) {
+            if (!isset($this->getParameters()[$context])) {
                 // unknown context provided by client, throw exception here? or continue?
             }
 
-            foreach (static::PARAMETERS[$context] as $name => $properties) {
+            foreach ($this->getParameters()[$context] as $name => $properties) {
                 if (isset($this->inputs[$context][$name]['value'])) {
                     continue;
                 }
@@ -204,8 +204,8 @@ abstract class BridgeAbstract
         }
 
         // Copy global parameter values to the guessed context
-        if (array_key_exists('global', static::PARAMETERS)) {
-            foreach (static::PARAMETERS['global'] as $name => $properties) {
+        if (array_key_exists('global', $this->getParameters())) {
+            foreach ($this->getParameters()['global'] as $name => $properties) {
                 if (isset($input[$name])) {
                     $value = $input[$name];
                 } else {
@@ -246,8 +246,8 @@ abstract class BridgeAbstract
         if (!isset($this->inputs[$this->queriedContext][$input]['value'])) {
             return null;
         }
-        if (array_key_exists('global', static::PARAMETERS)) {
-            if (array_key_exists($input, static::PARAMETERS['global'])) {
+        if (array_key_exists('global', $this->getParameters())) {
+            if (array_key_exists($input, $this->getParameters()['global'])) {
                 $context = 'global';
             }
         }
@@ -256,7 +256,7 @@ abstract class BridgeAbstract
         }
 
         $needle = $this->inputs[$this->queriedContext][$input]['value'];
-        foreach (static::PARAMETERS[$context][$input]['values'] as $first_level_key => $first_level_value) {
+        foreach ($this->getParameters()[$context][$input]['values'] as $first_level_key => $first_level_value) {
             if (!is_array($first_level_value) && $needle === (string)$first_level_value) {
                 return $first_level_key;
             } elseif (is_array($first_level_value)) {
@@ -273,7 +273,7 @@ abstract class BridgeAbstract
     {
         $regex = '/^(https?:\/\/)?(www\.)?(.+?)(\/)?$/';
         if (
-            empty(static::PARAMETERS)
+            empty($this->getParameters())
             && preg_match($regex, $url, $urlMatches) > 0
             && preg_match($regex, static::URI, $bridgeUriMatches) > 0
             && $urlMatches[3] === $bridgeUriMatches[3]

From c8178e1fc409635af1a40167c4f511feb8d3df7f Mon Sep 17 00:00:00 2001
From: Damien Calesse <2787828+kranack@users.noreply.github.com>
Date: Wed, 27 Dec 2023 13:17:49 +0100
Subject: [PATCH 238/716] [SensCritique] Fix bridge (#3860)

---
 bridges/SensCritiqueBridge.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/bridges/SensCritiqueBridge.php b/bridges/SensCritiqueBridge.php
index b823b55c..005704e1 100644
--- a/bridges/SensCritiqueBridge.php
+++ b/bridges/SensCritiqueBridge.php
@@ -57,7 +57,7 @@ class SensCritiqueBridge extends BridgeAbstract
                 }
                 $html = getSimpleHTMLDOM($uri);
                 // This selector name looks like it's automatically generated
-                $list = $html->find('div.Universes__WrapperProducts-sc-1qa2w66-0.eVdcAv', 0);
+                $list = $html->find('div[data-testid="row"]', 0);
 
                 $this->extractDataFromList($list);
             }
@@ -69,6 +69,7 @@ class SensCritiqueBridge extends BridgeAbstract
         if ($list === null) {
             returnClientError('Cannot extract data from list');
         }
+
         foreach ($list->find('div[data-testid="product-list-item"]') as $movie) {
             $item = [];
             $item['title'] = $movie->find('h2 a', 0)->plaintext;

From 5ab1924c4f96937885e12bcbd16b7bfb83a3c15b Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Thu, 28 Dec 2023 18:20:34 +0530
Subject: [PATCH 239/716] Add WorldbankBridge and OglafBridge (#3862)

* Add WorldbankBridge and OglafBridge

* Update OglafBridge.php

Remove redundant parent call to parseItem and rename formal argument to improve code clarity.

* Update WorldbankBridge.php

fix lint
---
 bridges/OglafBridge.php     | 35 +++++++++++++++++++++++++
 bridges/WorldbankBridge.php | 52 +++++++++++++++++++++++++++++++++++++
 2 files changed, 87 insertions(+)
 create mode 100644 bridges/OglafBridge.php
 create mode 100644 bridges/WorldbankBridge.php

diff --git a/bridges/OglafBridge.php b/bridges/OglafBridge.php
new file mode 100644
index 00000000..1f4bc1af
--- /dev/null
+++ b/bridges/OglafBridge.php
@@ -0,0 +1,35 @@
+<?php
+
+class OglafBridge extends FeedExpander
+{
+    const NAME = 'Oglaf';
+    const URI = 'https://www.oglaf.com/';
+    const DESCRIPTION = 'Fetch the entire comic image';
+    const MAINTAINER = 'tillcash';
+    const PARAMETERS = [
+        [
+            'limit' => [
+                'name' => 'limit (max 20)',
+                'type' => 'number',
+                'defaultValue' => 10,
+                'required' => true,
+            ]
+        ]
+    ];
+
+    public function collectData()
+    {
+        $url = self::URI . 'feeds/rss/';
+        $limit = min(20, $this->getInput('limit'));
+        $this->collectExpandableDatas($url, $limit);
+    }
+
+    protected function parseItem($item)
+    {
+        $html = getSimpleHTMLDOMCached($item['uri']);
+        $comicImage = $html->find('img[id="strip"]', 0);
+        $item['content'] = $comicImage;
+
+        return $item;
+    }
+}
diff --git a/bridges/WorldbankBridge.php b/bridges/WorldbankBridge.php
new file mode 100644
index 00000000..9b40e86e
--- /dev/null
+++ b/bridges/WorldbankBridge.php
@@ -0,0 +1,52 @@
+<?php
+
+class WorldbankBridge extends BridgeAbstract
+{
+    const NAME = 'World Bank Group';
+    const URI = 'https://www.worldbank.org/en/news/all';
+    const DESCRIPTION = 'Return articles from The World Bank Group All News';
+    const MAINTAINER = 'tillcash';
+    const PARAMETERS = [
+        [
+            'lang' => [
+                'name' => 'Language',
+                'type' => 'list',
+                'defaultValue' => 'English',
+                'values' => [
+                    'English' => 'English',
+                    'French' => 'French',
+                ]
+            ],
+            'limit' => [
+                'name' => 'limit (max 100)',
+                'type' => 'number',
+                'defaultValue' => 5,
+                'required' => true,
+            ]
+        ]
+    ];
+
+    public function collectData()
+    {
+        $apiUrl = 'https://search.worldbank.org/api/v2/news?format=json&rows='
+            . min(100, $this->getInput('limit'))
+            . '&lang_exact=' . $this->getInput('lang');
+
+        $jsonData = json_decode(getContents($apiUrl));
+
+        // Remove unnecessary data from the original object
+        if (isset($jsonData->documents->facets)) {
+            unset($jsonData->documents->facets);
+        }
+
+        foreach ($jsonData->documents as $element) {
+            $this->items[] = [
+                'uid' => $element->id,
+                'timestamp' => $element->lnchdt,
+                'title' => $element->title->{'cdata!'},
+                'uri' => $element->url,
+                'content' => $element->descr->{'cdata!'},
+            ];
+        }
+    }
+}

From f67d2eb88adc597cc57fbfc402c28725b671e5a3 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Thu, 28 Dec 2023 13:53:06 +0100
Subject: [PATCH 240/716] [TikTokBridge] Use embed iframe to bypass scraping
 protection (#3864)

The Tiktok Website was totally changed using some "scraping" protection
(passing as parameter value generated somewhere in the bunch of
javascript to the "API URL" that was before). The iframe embed does not
have such protection. It has less information (no date, ...) but it's
better than nothing !
---
 bridges/TikTokBridge.php | 66 ++++++++++++++--------------------------
 1 file changed, 23 insertions(+), 43 deletions(-)

diff --git a/bridges/TikTokBridge.php b/bridges/TikTokBridge.php
index 73a18b04..6590df66 100644
--- a/bridges/TikTokBridge.php
+++ b/bridges/TikTokBridge.php
@@ -8,12 +8,12 @@ class TikTokBridge extends BridgeAbstract
     const MAINTAINER = 'VerifiedJoseph';
     const PARAMETERS = [
         'By user' => [
-        'username' => [
-            'name' => 'Username',
-            'type' => 'text',
-            'required' => true,
-            'exampleValue' => '@tiktok',
-        ]
+            'username' => [
+                'name' => 'Username',
+                'type' => 'text',
+                'required' => true,
+                'exampleValue' => '@tiktok',
+            ]
         ]];
 
     const TEST_DETECT_PARAMETERS = [
@@ -24,53 +24,33 @@ class TikTokBridge extends BridgeAbstract
 
     const CACHE_TIMEOUT = 900; // 15 minutes
 
-    private $feedName = '';
-
     public function collectData()
     {
-        $html = getSimpleHTMLDOM($this->getURI());
+        $html = getSimpleHTMLDOMCached('https://www.tiktok.com/embed/' . $this->processUsername());
 
-        $title = $html->find('h1', 0)->plaintext ?? self::NAME;
-        $this->feedName = htmlspecialchars_decode($title);
+        $author = $html->find('span[data-e2e=creator-profile-userInfo-TUXText]', 0)->plaintext ?? self::NAME;
 
-        $var = $html->find('script[id=SIGI_STATE]', 0);
-        if (!$var) {
-            throw new \Exception('Unable to find tiktok user data for ' . $this->processUsername());
-        }
-        $SIGI_STATE_RAW = $var->innertext;
-        $SIGI_STATE = Json::decode($SIGI_STATE_RAW, false);
+        $videos = $html->find('div[data-e2e=common-videoList-VideoContainer]');
 
-        if (!isset($SIGI_STATE->ItemModule)) {
-            return;
-        }
-
-        foreach ($SIGI_STATE->ItemModule as $key => $value) {
+        foreach ($videos as $video) {
             $item = [];
 
-            $link = 'https://www.tiktok.com/@' . $value->author . '/video/' . $value->id;
-            $image = $value->video->dynamicCover;
-            if (empty($image)) {
-                $image = $value->video->cover;
-            }
-            $views = $value->stats->playCount;
-            $hastags = [];
-            foreach ($value->textExtra as $tag) {
-                $hastags[] = $tag->hashtagName;
-            }
-            $hastags_str = '';
-            foreach ($hastags as $tag) {
-                $hastags_str .= '<a href="https://www.tiktok.com/tag/' . $tag . '">#' . $tag . '</a> ';
-            }
+            // Handle link "untracking"
+            $linkParts = parse_url($video->find('a', 0)->href);
+            $link = $linkParts['scheme'] . '://' . $linkParts['host'] . '/' . $linkParts['path'];
+
+            $image = $video->find('video', 0)->poster;
+            $views = $video->find('div[data-e2e=common-Video-Count]', 0)->plaintext;
+
+            $enclosures = [$image];
 
             $item['uri'] = $link;
-            $item['title'] = $value->desc;
-            $item['timestamp'] = $value->createTime;
-            $item['author'] = '@' . $value->author;
-            $item['enclosures'][] = $image;
-            $item['categories'] = $hastags;
+            $item['title'] = 'Video';
+            $item['author'] = '@' . $author;
+            $item['enclosures'] = $enclosures;
             $item['content'] = <<<EOD
 <a href="{$link}"><img src="{$image}"/></a>
-<p>{$views} views<p><br/>Hashtags: {$hastags_str}
+<p>{$views} views<p><br/>
 EOD;
 
             $this->items[] = $item;
@@ -91,7 +71,7 @@ EOD;
     {
         switch ($this->queriedContext) {
             case 'By user':
-                return $this->feedName . ' (' . $this->processUsername() . ') - TikTok';
+                return  $this->processUsername() . ' - TikTok';
             default:
                 return parent::getName();
         }

From 2032ed18c49a82fc2e634dfa6f2b91e652228876 Mon Sep 17 00:00:00 2001
From: Damien Calesse <2787828+kranack@users.noreply.github.com>
Date: Thu, 28 Dec 2023 19:51:15 +0100
Subject: [PATCH 241/716] [SensCritique] Update the content to add the image
 (#3865)

---
 bridges/SensCritiqueBridge.php | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/bridges/SensCritiqueBridge.php b/bridges/SensCritiqueBridge.php
index 005704e1..f6a2ea16 100644
--- a/bridges/SensCritiqueBridge.php
+++ b/bridges/SensCritiqueBridge.php
@@ -71,10 +71,17 @@ class SensCritiqueBridge extends BridgeAbstract
         }
 
         foreach ($list->find('div[data-testid="product-list-item"]') as $movie) {
+            $synopsis = $movie->find('p[data-testid="synopsis"]', 0);
+
             $item = [];
             $item['title'] = $movie->find('h2 a', 0)->plaintext;
-            // todo: fix image
-            $item['content'] = $movie->innertext;
+            $item['content'] = sprintf(
+                '<img src="%s"/><p>%s</p><p>%s</p>%s',
+                $movie->find('span[data-testid="poster-img-wrapper"]', 0)->{'data-srcname'},
+                $movie->find('p[data-testid="other-infos"]', 0)->innertext,
+                $movie->find('p[data-testid="creators"]', 0)->innertext,
+                $synopsis ? sprintf('<p>%s</p>', $synopsis->innertext) : ''
+            );
             $item['id'] = $this->getURI() . ltrim($movie->find('a', 0)->href, '/');
             $item['uri'] = $this->getURI() . ltrim($movie->find('a', 0)->href, '/');
             $this->items[] = $item;

From 7dbe10658213e165c07faac01a8c79771b4917c8 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 28 Dec 2023 23:26:14 +0100
Subject: [PATCH 242/716] docs(nginx, phpfpm): improve install and config
 instructions (#3866)

---
 README.md            | 186 ++++++++++++++++++++++++++++++++++---------
 caches/FileCache.php |   1 +
 index.php            |   3 +-
 3 files changed, 152 insertions(+), 38 deletions(-)

diff --git a/README.md b/README.md
index 2a762d45..34efc8de 100644
--- a/README.md
+++ b/README.md
@@ -2,12 +2,15 @@
 
 ![RSS-Bridge](static/logo_600px.png)
 
-RSS-Bridge is a web application.
+RSS-Bridge is a PHP web application.
 
 It generates web feeds for websites that don't have one.
 
 Officially hosted instance: https://rss-bridge.org/bridge01/
 
+IRC channel #rssbridge at https://libera.chat/
+
+
 [![LICENSE](https://img.shields.io/badge/license-UNLICENSE-blue.svg)](UNLICENSE)
 [![GitHub release](https://img.shields.io/github/release/rss-bridge/rss-bridge.svg?logo=github)](https://github.com/rss-bridge/rss-bridge/releases/latest)
 [![irc.libera.chat](https://img.shields.io/badge/irc.libera.chat-%23rssbridge-blue.svg)](https://web.libera.chat/#rssbridge)
@@ -48,53 +51,146 @@ Check out RSS-Bridge right now on https://rss-bridge.org/bridge01/
 Alternatively find another
 [public instance](https://rss-bridge.github.io/rss-bridge/General/Public_Hosts.html).
 
-## Tutorial
-
-### Install with composer or git
-
 Requires minimum PHP 7.4.
 
+## Tutorial
+
+### How to install on traditional shared web hosting
+
+RSS-Bridge can basically be unzipped in a web folder. Should be working instantly.
+
+Latest zip as of Sep 2023: https://github.com/RSS-Bridge/rss-bridge/archive/refs/tags/2023-09-24.zip
+
+### How to install on Debian 12 (nginx + php-fpm)
+
+These instructions have been tested on a fresh Debian 12 VM from Digital Ocean (1vcpu-512mb-10gb, 5 USD/month).
+
 ```shell
-apt install nginx php-fpm php-mbstring php-simplexml php-curl
+timedatectl set-timezone Europe/Oslo
+
+apt install git nginx php8.2-fpm php-mbstring php-simplexml php-curl
+
+# Create a new user account
+useradd --shell /bin/bash --create-home rss-bridge
+
+cd /var/www
+
+# Create folder and change ownership
+mkdir rss-bridge && chown rss-bridge:rss-bridge rss-bridge/
+
+# Become user
+su rss-bridge
+
+# Fetch latest master
+git clone https://github.com/RSS-Bridge/rss-bridge.git rss-bridge/
+cd rss-bridge
+
+# Copy over the default config
+cp -v config.default.ini.php config.ini.php
+
+# Give full permissions only to owner (rss-bridge)
+chmod 700 -R ./
+
+# Give read and execute to others (nginx and php-fpm)
+chmod o+rx ./ ./static
+
+# Give read to others (nginx)
+chmod o+r -R ./static
 ```
 
+Nginx config:
+
+```nginx
+# /etc/nginx/sites-enabled/rss-bridge.conf
+
+server {
+    listen 80;
+    server_name example.com;
+    access_log /var/log/nginx/rss-bridge.access.log;
+    error_log /var/log/nginx/rss-bridge.error.log;
+
+    # Intentionally not setting a root folder here
+        
+    # autoindex is off by default but feels good to explicitly turn off
+    autoindex off;
+
+    # Static content only served here 
+    location /static/ {
+        alias /var/www/rss-bridge/static/;
+    }
+
+    # Pass off to php-fpm only when location is exactly /
+    location = / {
+        root /var/www/rss-bridge/;
+        include snippets/fastcgi-php.conf;
+        fastcgi_pass unix:/run/php/rss-bridge.sock;
+    }
+
+    # Reduce spam
+    location = /favicon.ico {
+        access_log off;
+        log_not_found off;
+    }
+
+    # Reduce spam
+    location = /robots.txt {
+        access_log off;
+        log_not_found off;
+    }
+}
+```
+
+PHP FPM pool config:
+```ini
+; /etc/php/8.2/fpm/pool.d/rss-bridge.conf
+
+[rss-bridge]
+
+user = rss-bridge
+group = rss-bridge
+
+listen = /run/php/rss-bridge.sock
+
+listen.owner = www-data
+listen.group = www-data
+
+pm = static
+pm.max_children = 10
+pm.max_requests = 500
+```
+
+PHP ini config:
+```ini
+; /etc/php/8.2/fpm/conf.d/30-rss-bridge.ini
+
+max_execution_time = 20
+memory_limit = 64M
+```
+
+Restart fpm and nginx:
+
+```shell
+# Lint and restart php-fpm
+php-fpm8.2 -t
+systemctl restart php8.2-fpm
+
+# Lint and restart nginx
+nginx -t
+systemctl restart nginx
+```
+
+### How to install from Composer
+
+Install the latest release.
+
 ```shell
 cd /var/www
 composer create-project -v --no-dev rss-bridge/rss-bridge
 ```
 
-```shell
-cd /var/www
-git clone https://github.com/RSS-Bridge/rss-bridge.git
-```
+### How to install with Caddy
 
-Config:
-
-```shell
-# Give the http user write permission to the cache folder
-chown www-data:www-data /var/www/rss-bridge/cache
-
-# Optionally copy over the default config file
-cp config.default.ini.php config.ini.php
-```
-
-Example config for nginx:
-
-```nginx
-# /etc/nginx/sites-enabled/rssbridge
-server {
-    listen 80;
-    server_name example.com;
-    root /var/www/rss-bridge;
-    index index.php;
-
-    location ~ \.php$ {
-        include snippets/fastcgi-php.conf;
-        fastcgi_read_timeout 60s;
-        fastcgi_pass unix:/run/php/php-fpm.sock;
-    }
-}
-```
+TODO. See https://github.com/RSS-Bridge/rss-bridge/issues/3785
 
 ### Install from Docker Hub:
 
@@ -163,6 +259,22 @@ Learn more in
 
 ## How-to
 
+### How to fix "PHP Fatal error:  Uncaught Exception: The FileCache path is not writable"
+
+```shell
+# Give rssbridge ownership
+chown rssbridge:rssbridge -R /var/www/rss-bridge/cache
+
+# Or, give www-data ownership
+chown www-data:www-data -R /var/www/rss-bridge/cache
+
+# Or, give everyone write permission
+chmod 777 -R /var/www/rss-bridge/cache
+
+# Or last ditch effort (CAREFUL)
+rm -rf /var/www/rss-bridge/cache/ && mkdir /var/www/rss-bridge/cache/
+```
+
 ### How to create a new bridge from scratch
 
 Create the new bridge in e.g. `bridges/BearBlogBridge.php`:
diff --git a/caches/FileCache.php b/caches/FileCache.php
index 09d12791..7a0eb81d 100644
--- a/caches/FileCache.php
+++ b/caches/FileCache.php
@@ -54,6 +54,7 @@ class FileCache implements CacheInterface
         ];
         $cacheFile = $this->createCacheFile($key);
         $bytes = file_put_contents($cacheFile, serialize($item), LOCK_EX);
+        // todo: Consider tightening the permissions of the created file. It usually allow others to read, depending on umask
         if ($bytes === false) {
             // Consider just logging the error here
             throw new \Exception(sprintf('Failed to write to: %s', $cacheFile));
diff --git a/index.php b/index.php
index 14713e06..c2c546a1 100644
--- a/index.php
+++ b/index.php
@@ -8,7 +8,8 @@ require_once __DIR__ . '/lib/bootstrap.php';
 
 $errors = Configuration::checkInstallation();
 if ($errors) {
-    die('<pre>' . implode("\n", $errors) . '</pre>');
+    print '<pre>' . implode("\n", $errors) . '</pre>';
+    exit(1);
 }
 
 $customConfig = [];

From fac1f5cd88f04855a891aeb7341f783e57ce5b3c Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 30 Dec 2023 01:33:31 +0100
Subject: [PATCH 243/716] refactor(reddit) (#3869)

* refactor

* yup

* fix also reporterre
---
 bridges/RedditBridge.php     | 66 +++++++++++-------------------------
 bridges/ReporterreBridge.php | 44 +++++++++++++-----------
 2 files changed, 44 insertions(+), 66 deletions(-)

diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index bb3e7afc..618463a6 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -173,7 +173,7 @@ class RedditBridge extends BridgeAbstract
                 $item['author'] = $data->author;
                 $item['uid'] = $data->id;
                 $item['timestamp'] = $data->created_utc;
-                $item['uri'] = $this->encodePermalink($data->permalink);
+                $item['uri'] = $this->urlEncodePathParts($data->permalink);
 
                 $item['categories'] = [];
 
@@ -193,13 +193,11 @@ class RedditBridge extends BridgeAbstract
                 if ($post->kind == 't1') {
                     // Comment
 
-                    $item['content']
-                        = htmlspecialchars_decode($data->body_html);
+                    $item['content'] = htmlspecialchars_decode($data->body_html);
                 } elseif ($data->is_self) {
                     // Text post
 
-                    $item['content']
-                        = htmlspecialchars_decode($data->selftext_html);
+                    $item['content'] = htmlspecialchars_decode($data->selftext_html);
                 } elseif (isset($data->post_hint) && $data->post_hint == 'link') {
                     // Link with preview
 
@@ -215,18 +213,11 @@ class RedditBridge extends BridgeAbstract
                         $embed = '';
                     }
 
-                    $item['content'] = $this->template(
-                        $data->url,
-                        $data->thumbnail,
-                        $data->domain
-                    ) . $embed;
-                } elseif (isset($data->post_hint) ? $data->post_hint == 'image' : false) {
+                    $item['content'] = $this->createFigureLink($data->url, $data->thumbnail, $data->domain) . $embed;
+                } elseif (isset($data->post_hint) && $data->post_hint == 'image') {
                     // Single image
 
-                    $item['content'] = $this->link(
-                        $this->encodePermalink($data->permalink),
-                        '<img src="' . $data->url . '" />'
-                    );
+                    $item['content'] = $this->createLink($this->urlEncodePathParts($data->permalink), '<img src="' . $data->url . '" />');
                 } elseif ($data->is_gallery ?? false) {
                     // Multiple images
 
@@ -246,32 +237,18 @@ class RedditBridge extends BridgeAbstract
                     end($data->preview->images[0]->resolutions);
                     $index = key($data->preview->images[0]->resolutions);
 
-                    $item['content'] = $this->template(
-                        $data->url,
-                        $data->preview->images[0]->resolutions[$index]->url,
-                        'Video'
-                    );
-                } elseif (isset($data->media) ? $data->media->type == 'youtube.com' : false) {
+                    $item['content'] = $this->createFigureLink($data->url, $data->preview->images[0]->resolutions[$index]->url, 'Video');
+                } elseif (isset($data->media) && $data->media->type == 'youtube.com') {
                     // Youtube link
-
-                    $item['content'] = $this->template(
-                        $data->url,
-                        $data->media->oembed->thumbnail_url,
-                        'YouTube'
-                    );
+                    $item['content'] = $this->createFigureLink($data->url, $data->media->oembed->thumbnail_url, 'YouTube');
+                    //$item['content'] = htmlspecialchars_decode($data->media->oembed->html);
                 } elseif (explode('.', $data->domain)[0] == 'self') {
                     // Crossposted text post
                     // TODO (optionally?) Fetch content of the original post.
-
-                    $item['content'] = $this->link(
-                        $this->encodePermalink($data->permalink),
-                        'Crossposted from r/'
-                        . explode('.', $data->domain)[1]
-                    );
+                    $item['content'] = $this->createLink($this->urlEncodePathParts($data->permalink), 'Crossposted from r/' . explode('.', $data->domain)[1]);
                 } else {
                     // Link WITHOUT preview
-
-                    $item['content'] = $this->link($data->url, $data->domain);
+                    $item['content'] = $this->createLink($data->url, $data->domain);
                 }
 
                 $this->items[] = $item;
@@ -279,7 +256,7 @@ class RedditBridge extends BridgeAbstract
         }
         // Sort the order to put the latest posts first, even for mixed subreddits
         usort($this->items, function ($a, $b) {
-            return $a['timestamp'] < $b['timestamp'];
+            return $b['timestamp'] <=> $a['timestamp'];
         });
     }
 
@@ -299,24 +276,19 @@ class RedditBridge extends BridgeAbstract
         }
     }
 
-    private function encodePermalink($link)
+    private function urlEncodePathParts($link)
     {
-        return self::URI . implode(
-            '/',
-            array_map('urlencode', explode('/', $link))
-        );
+        return self::URI . implode('/', array_map('urlencode', explode('/', $link)));
     }
 
-    private function template($href, $src, $caption)
+    private function createFigureLink($href, $src, $caption)
     {
-        return '<a href="' . $href . '"><figure><figcaption>'
-            . $caption . '</figcaption><img src="'
-            . $src . '"/></figure></a>';
+        return sprintf('<a href="%s"><figure><figcaption>%s</figcaption><img src="%s"/></figure></a>', $href, $caption, $src);
     }
 
-    private function link($href, $text)
+    private function createLink($href, $text)
     {
-        return '<a href="' . $href . '">' . $text . '</a>';
+        return sprintf('<a href="%s">%s</a>', $href, $text);
     }
 
     public function detectParameters($url)
diff --git a/bridges/ReporterreBridge.php b/bridges/ReporterreBridge.php
index 18378d24..78c60d5f 100644
--- a/bridges/ReporterreBridge.php
+++ b/bridges/ReporterreBridge.php
@@ -1,11 +1,35 @@
 <?php
 
+/**
+ * See https://reporterre.net/spip.php?page=backend-simple
+ */
 class ReporterreBridge extends BridgeAbstract
 {
     const MAINTAINER = 'nyutag';
     const NAME = 'Reporterre Bridge';
     const URI = 'https://www.reporterre.net/';
-    const DESCRIPTION = 'Returns the newest articles.';
+    const DESCRIPTION = 'Returns the newest articles. See also their official feed https://reporterre.net/spip.php?page=backend-simple';
+
+    public function collectData()
+    {
+        //$url = self::URI . 'spip.php?page=backend';
+        $url = self::URI . 'spip.php?page=backend-simple';
+        $html = getSimpleHTMLDOM($url);
+        $limit = 0;
+
+        foreach ($html->find('item') as $element) {
+            if ($limit < 5) {
+                $item = [];
+                $item['title'] = html_entity_decode($element->find('title', 0)->plaintext);
+                $item['timestamp'] = strtotime($element->find('dc:date', 0)->plaintext);
+                $item['uri'] = $element->find('guid', 0)->innertext;
+                //$item['content'] = html_entity_decode($this->extractContent($item['uri']));
+                $item['content'] = htmlspecialchars_decode($element->find('description', 0)->plaintext);
+                $this->items[] = $item;
+                $limit++;
+            }
+        }
+    }
 
     private function extractContent($url)
     {
@@ -22,22 +46,4 @@ class ReporterreBridge extends BridgeAbstract
         $text = strip_tags($text, '<p><br><a><img>');
         return $text;
     }
-
-    public function collectData()
-    {
-        $html = getSimpleHTMLDOM(self::URI . 'spip.php?page=backend');
-        $limit = 0;
-
-        foreach ($html->find('item') as $element) {
-            if ($limit < 5) {
-                $item = [];
-                $item['title'] = html_entity_decode($element->find('title', 0)->plaintext);
-                $item['timestamp'] = strtotime($element->find('dc:date', 0)->plaintext);
-                $item['uri'] = $element->find('guid', 0)->innertext;
-                $item['content'] = html_entity_decode($this->extractContent($item['uri']));
-                $this->items[] = $item;
-                $limit++;
-            }
-        }
-    }
 }

From ef378663aaa98ef54c7145781e8ab1e35fe50e7d Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 2 Jan 2024 16:21:52 +0100
Subject: [PATCH 244/716] test: happy new year (#3873)

* test: happy new year

* yup
---
 tests/FeedItemTest.php | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/tests/FeedItemTest.php b/tests/FeedItemTest.php
index 0e7af222..3390e7b3 100644
--- a/tests/FeedItemTest.php
+++ b/tests/FeedItemTest.php
@@ -41,7 +41,8 @@ class FeedItemTest extends TestCase
         $this->assertSame(64800, $item->getTimestamp());
 
         $item->setTimestamp('1st jan last year');
-        // This will fail at 2024-01-01 hehe
-        $this->assertSame(1640995200, $item->getTimestamp());
+
+        // This will fail at 2025-01-01 hehe
+        $this->assertSame(1672531200, $item->getTimestamp());
     }
 }

From e904de2dc987d6578f9fd5f527aa736801c2185c Mon Sep 17 00:00:00 2001
From: Damien Calesse <2787828+kranack@users.noreply.github.com>
Date: Tue, 2 Jan 2024 16:22:39 +0100
Subject: [PATCH 245/716] [YGGTorrent] Update URI (#3871)

---
 bridges/YGGTorrentBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/YGGTorrentBridge.php b/bridges/YGGTorrentBridge.php
index f0c31f11..018bcfc4 100644
--- a/bridges/YGGTorrentBridge.php
+++ b/bridges/YGGTorrentBridge.php
@@ -7,7 +7,7 @@ class YGGTorrentBridge extends BridgeAbstract
 {
     const MAINTAINER = 'teromene';
     const NAME = 'Yggtorrent Bridge';
-    const URI = 'https://www5.yggtorrent.fi';
+    const URI = 'https://www3.yggtorrent.qa';
     const DESCRIPTION = 'Returns torrent search from Yggtorrent';
 
     const PARAMETERS = [

From 0f6fa8034b04e1e007158ef0c5cc784bf8d7ef45 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Petr=20Kol=C3=A1=C5=99?= <kolarcz@gmail.com>
Date: Tue, 2 Jan 2024 16:23:13 +0100
Subject: [PATCH 246/716] Fixed selector in CeskaTelevizeBridge (#3872)

* Fixed selector in CeskaTelevizeBridge

* Fixed also description selector
---
 bridges/CeskaTelevizeBridge.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/CeskaTelevizeBridge.php b/bridges/CeskaTelevizeBridge.php
index 003cd4c7..be00d664 100644
--- a/bridges/CeskaTelevizeBridge.php
+++ b/bridges/CeskaTelevizeBridge.php
@@ -57,9 +57,9 @@ class CeskaTelevizeBridge extends BridgeAbstract
             $this->feedName .= " ({$category})";
         }
 
-        foreach ($html->find('#episodeListSection a[data-testid=next-link]') as $element) {
+        foreach ($html->find('#episodeListSection a[data-testid=card]') as $element) {
             $itemTitle = $element->find('h3', 0);
-            $itemContent = $element->find('div[class^=content-]', 0);
+            $itemContent = $element->find('p[class^=content-]', 0);
             $itemDate = $element->find('div[class^=playTime-] span', 0);
             $itemThumbnail = $element->find('img', 0);
             $itemUri = self::URI . $element->getAttribute('href');

From 12395fcf2d87939a8a95d8bbc95e188e171bfbca Mon Sep 17 00:00:00 2001
From: Alexandre Alapetite <alexandre.alapetite@alexandra.dk>
Date: Fri, 5 Jan 2024 07:22:16 +0100
Subject: [PATCH 247/716] Docker fix default fastcgi.logging (#3875)

Mistake from https://github.com/RSS-Bridge/rss-bridge/pull/3500
Wrong file extension: should have been `.ini` and not `.conf` otherwise it has no effect.
See https://github.com/docker-library/php/pull/1360 and https://github.com/docker-library/php/issues/878#issuecomment-938595965
---
 Dockerfile     | 2 +-
 config/php.ini | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Dockerfile b/Dockerfile
index f504b51f..2f1f4f3d 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -38,7 +38,7 @@ ENV CURL_IMPERSONATE ff91esr
 
 COPY ./config/nginx.conf /etc/nginx/sites-available/default
 COPY ./config/php-fpm.conf /etc/php/8.2/fpm/pool.d/rss-bridge.conf
-COPY ./config/php.ini /etc/php/8.2/fpm/conf.d/90-rss-bridge.conf
+COPY ./config/php.ini /etc/php/8.2/fpm/conf.d/90-rss-bridge.ini
 
 COPY --chown=www-data:www-data ./ /app/
 
diff --git a/config/php.ini b/config/php.ini
index 115f1c89..383afffb 100644
--- a/config/php.ini
+++ b/config/php.ini
@@ -1,4 +1,4 @@
 ; Inspired by https://github.com/docker-library/php/blob/master/8.2/bookworm/fpm/Dockerfile
 
-; https://github.com/docker-library/php/issues/878#issuecomment-938595965'
+; https://github.com/docker-library/php/issues/878#issuecomment-938595965
 fastcgi.logging = Off

From 55ffac5bae8d84ff1b42339d1114117cf32a6854 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Fri, 5 Jan 2024 07:23:40 +0100
Subject: [PATCH 248/716] [PepperBridgeAbstract, DealabsBridge,
 HotUKDealsBridge, MydealsBridge] (#3876)

Fix the Deal source link

The HTML does not contain the link to the "Deal source anymore", now only an
attribute does contain the information about the Deal Source.

The JSON data is now extraced for each Deal, and used to get the
Temperature and Deal Source.
---
 bridges/DealabsBridge.php        |  1 +
 bridges/HotUKDealsBridge.php     |  1 +
 bridges/MydealsBridge.php        |  1 +
 bridges/PepperBridgeAbstract.php | 29 +++++++++++++++++++++--------
 4 files changed, 24 insertions(+), 8 deletions(-)

diff --git a/bridges/DealabsBridge.php b/bridges/DealabsBridge.php
index a904c3ff..4d39502c 100644
--- a/bridges/DealabsBridge.php
+++ b/bridges/DealabsBridge.php
@@ -1910,6 +1910,7 @@ class DealabsBridge extends PepperBridgeAbstract
         'context-talk' => 'Surveillance Discussion',
         'uri-group' => 'groupe/',
         'uri-deal' => 'bons-plans/',
+        'uri-merchant' => 'search/bons-plans?merchant-id=',
         'request-error' => 'Impossible de joindre Dealabs',
         'thread-error' => 'Impossible de déterminer l\'ID de la discussion. Vérifiez l\'URL que vous avez entré',
         'no-results' => 'Il n&#039;y a rien à afficher pour le moment :(',
diff --git a/bridges/HotUKDealsBridge.php b/bridges/HotUKDealsBridge.php
index 69301c42..a7e62250 100644
--- a/bridges/HotUKDealsBridge.php
+++ b/bridges/HotUKDealsBridge.php
@@ -3274,6 +3274,7 @@ class HotUKDealsBridge extends PepperBridgeAbstract
         'context-talk' => 'Discussion Monitoring',
         'uri-group' => 'tag/',
         'uri-deal' => 'deals/',
+        'uri-merchant' => 'search/deals?merchant-id=',
         'request-error' => 'Could not request HotUKDeals',
         'thread-error' => 'Unable to determine the thread ID. Check the URL you entered',
         'no-results' => 'Ooops, looks like we could',
diff --git a/bridges/MydealsBridge.php b/bridges/MydealsBridge.php
index 22b46413..d7e074a9 100644
--- a/bridges/MydealsBridge.php
+++ b/bridges/MydealsBridge.php
@@ -2021,6 +2021,7 @@ class MydealsBridge extends PepperBridgeAbstract
         'context-talk' => 'Überwachung Diskussion',
         'uri-group' => 'gruppe/',
         'uri-deal' => 'deals/',
+        'uri-merchant' => 'search/gutscheine?merchant-id=',
         'request-error' => 'Could not request mydeals',
         'thread-error' => 'Die ID der Diskussion kann nicht ermittelt werden. Überprüfen Sie die eingegebene URL',
         'no-results' => 'Ups, wir konnten nichts',
diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index 6cb0f302..73bd194d 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -104,6 +104,9 @@ class PepperBridgeAbstract extends BridgeAbstract
                 $item['title'] = $this->getTitle($deal);
                 $item['author'] = $deal->find('span.thread-username', 0)->plaintext;
 
+                // Get the JSON Data stored as vue
+                $jsonDealData = $this->getDealJsonData($deal);
+
                 $item['content'] = '<table><tr><td><a href="'
                     . $item['uri']
                     . '"><img src="'
@@ -114,10 +117,10 @@ class PepperBridgeAbstract extends BridgeAbstract
                     . $this->getDiscount($deal)
                     . $this->getShipsFrom($deal)
                     . $this->getShippingCost($deal)
-                    . $this->getSource($deal)
+                    . $this->getSource($jsonDealData)
                     . $deal->find('div[class*=' . $selectorDescription . ']', 0)->innertext
                     . '</td><td>'
-                    . $this->getTemperature($deal)
+                    . $this->getTemperature($jsonDealData)
                     . '</td></table>';
 
                 // Check if a clock icon is displayed on the deal
@@ -371,21 +374,31 @@ HEREDOC;
      * Get the temperature from a Deal if it exists
      * @return string String of the deal temperature
      */
-    private function getTemperature($deal)
+    private function getTemperature($data)
+    {
+        return $data['props']['thread']['temperature'] . '°';
+    }
+
+
+    /**
+     * Get the Deal data from the "data-vue2" JSON attribute
+     * @return array Array containg the deal properties contained in the "data-vue2" attribute
+     */
+    private function getDealJsonData($deal)
     {
         $data = Json::decode($deal->find('div[class=js-vue2]', 0)->getAttribute('data-vue2'));
-        return $data['props']['thread']['temperature'] . '°';
+        return $data;
     }
 
     /**
      * Get the source of a Deal if it exists
      * @return string String of the deal source
      */
-    private function getSource($deal)
+    private function getSource($jsonData)
     {
-        if (($origin = $deal->find('button[class*=text--color-greyShade]', 0)) != null) {
-            $path = str_replace(' ', '/', trim(Json::decode($origin->{'data-cloak-link'})['path']));
-            $text = $origin->find('span[class*=link]', 0);
+        if ($jsonData['props']['thread']['merchant'] != null) {
+            $path = $this->i8n('uri-merchant') . $jsonData['props']['thread']['merchant']['merchantId'];
+            $text = $jsonData['props']['thread']['merchant']['merchantName'];
             return '<div>' . $this->i8n('origin') . ' : <a href="' . static::URI . $path . '">' . $text . '</a></div>';
         } else {
             return '';

From ea58c8d2bcd17b09e7d9dea64297ea44885a3933 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=BD=D0=B5=D0=B7=D0=B4=D0=B0=D0=BB=D0=B8=D1=81=D1=8C?=
 =?UTF-8?q?=D0=BA=D0=BE?= <105280814+uandreew@users.noreply.github.com>
Date: Sat, 6 Jan 2024 19:13:50 +0200
Subject: [PATCH 249/716] Update 06_Public_Hosts.md (#3877)

---
 docs/01_General/06_Public_Hosts.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/01_General/06_Public_Hosts.md b/docs/01_General/06_Public_Hosts.md
index c9572824..4aa905da 100644
--- a/docs/01_General/06_Public_Hosts.md
+++ b/docs/01_General/06_Public_Hosts.md
@@ -22,6 +22,7 @@
 | ![](https://iplookup.flagfox.net/images/h16/PL.png) | https://rss.foxhaven.cyou| ![](https://img.shields.io/badge/website-up-brightgreen) | [@Aysilu](https://foxhaven.cyou) | Hosted with Timeweb (Maintained in Poland) |
 | ![](https://iplookup.flagfox.net/images/h16/PL.png) | https://rss.m3wz.su| ![](https://img.shields.io/badge/website-up-brightgreen) | [@m3oweezed](https://m3wz.su/en/about) | Poland, Hosted with Timeweb Cloud |
 | ![](https://iplookup.flagfox.net/images/h16/DE.png) | https://rb.ash.fail | ![](https://img.shields.io/website/https/rb.ash.fail.svg) | [@ash](https://ash.fail/contact.html) | Hosted with Hostaris, Germany
+| ![](https://iplookup.flagfox.net/images/h16/UA.png) | https://rss.noleron.com | ![](https://img.shields.io/website/https/rss.noleron.com) | [@ihor](https://noleron.com/about) | Hosted with Hosting Ukraine, Ukraine
 
 
 ## Inactive instances

From 3ce94409ab650e042993480d638482a89901776d Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 9 Jan 2024 20:18:33 +0100
Subject: [PATCH 250/716] feat: support itunes namespace in top channel feed
 (#3776)

Also preserves other properties.
---
 actions/DisplayAction.php                     |  11 +-
 bridges/ItakuBridge.php                       |   6 +-
 formats/AtomFormat.php                        |  79 ++++++------
 formats/HtmlFormat.php                        |  12 +-
 formats/JsonFormat.php                        |  18 +--
 formats/MrssFormat.php                        | 118 ++++++++++--------
 formats/PlaintextFormat.php                   |   6 +-
 lib/BridgeAbstract.php                        |  55 +++++---
 lib/FormatAbstract.php                        |  75 +++++------
 lib/bootstrap.php                             |   3 -
 tests/FormatTest.php                          |  72 +++++++++++
 tests/Formats/BaseFormatTest.php              |   2 +-
 .../expectedAtomFormat/feed.common.xml        |   6 +-
 .../samples/expectedAtomFormat/feed.empty.xml |   6 +-
 .../expectedAtomFormat/feed.emptyItems.xml    |   6 +-
 .../expectedAtomFormat/feed.microblog.xml     |   6 +-
 .../expectedMrssFormat/feed.common.xml        |   6 +-
 .../samples/expectedMrssFormat/feed.empty.xml |   2 +-
 .../expectedMrssFormat/feed.emptyItems.xml    |   2 +-
 .../expectedMrssFormat/feed.microblog.xml     |   6 +-
 tests/Formats/samples/feed.empty.json         |   2 +-
 tests/Formats/samples/feed.emptyItems.json    |   2 +-
 22 files changed, 298 insertions(+), 203 deletions(-)
 create mode 100644 tests/FormatTest.php

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 43563996..080da52e 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -100,7 +100,7 @@ class DisplayAction implements ActionInterface
     private function createResponse(array $request, BridgeAbstract $bridge, FormatAbstract $format)
     {
         $items = [];
-        $infos = [];
+        $feed = [];
 
         try {
             $bridge->loadConfiguration();
@@ -116,12 +116,7 @@ class DisplayAction implements ActionInterface
                 }
                 $items = $feedItems;
             }
-            $infos = [
-                'name'          => $bridge->getName(),
-                'uri'           => $bridge->getURI(),
-                'donationUri'   => $bridge->getDonationURI(),
-                'icon'          => $bridge->getIcon()
-            ];
+            $feed = $bridge->getFeed();
         } catch (\Exception $e) {
             if ($e instanceof HttpException) {
                 // Reproduce (and log) these responses regardless of error output and report limit
@@ -155,7 +150,7 @@ class DisplayAction implements ActionInterface
         }
 
         $format->setItems($items);
-        $format->setExtraInfos($infos);
+        $format->setFeed($feed);
         $now = time();
         $format->setLastModified($now);
         $headers = [
diff --git a/bridges/ItakuBridge.php b/bridges/ItakuBridge.php
index 149757f5..0577752c 100644
--- a/bridges/ItakuBridge.php
+++ b/bridges/ItakuBridge.php
@@ -280,7 +280,7 @@ class ItakuBridge extends BridgeAbstract
                 $opt['range'] = '';
                 $user_id = $this->getInput('user_id') ?? $this->getOwnerID($this->getInput('user'));
 
-                $data = $this->getFeed(
+                $data = $this->getFeedData(
                     $opt,
                     $user_id
                 );
@@ -289,7 +289,7 @@ class ItakuBridge extends BridgeAbstract
             if ($this->queriedContext === 'Home feed') {
                 $opt['order'] = $this->getInput('order');
                 $opt['range'] = $this->getInput('range');
-                $data = $this->getFeed($opt);
+                $data = $this->getFeedData($opt);
             }
 
             foreach ($data['results'] as $record) {
@@ -409,7 +409,7 @@ class ItakuBridge extends BridgeAbstract
         return $this->getData($url, false, true);
     }
 
-    private function getFeed(array $opt, $ownerID = null)
+    private function getFeedData(array $opt, $ownerID = null)
     {
         $url = self::URI . "/api/feed/?date_range={$opt['range']}&ordering={$opt['order']}&page=1&page_size=30&format=json";
 
diff --git a/formats/AtomFormat.php b/formats/AtomFormat.php
index 07ca7272..1fabef2e 100644
--- a/formats/AtomFormat.php
+++ b/formats/AtomFormat.php
@@ -17,44 +17,61 @@ class AtomFormat extends FormatAbstract
     public function stringify()
     {
         $document = new \DomDocument('1.0', $this->getCharset());
+        $document->formatOutput = true;
 
         $feedUrl = get_current_url();
 
-        $extraInfos = $this->getExtraInfos();
-        if (empty($extraInfos['uri'])) {
-            $uri = REPOSITORY;
-        } else {
-            $uri = $extraInfos['uri'];
-        }
-
-        $document->formatOutput = true;
         $feed = $document->createElementNS(self::ATOM_NS, 'feed');
         $document->appendChild($feed);
         $feed->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:media', self::MRSS_NS);
 
-        $title = $document->createElement('title');
-        $feed->appendChild($title);
-        $title->setAttribute('type', 'text');
-        $title->appendChild($document->createTextNode($extraInfos['name']));
+        $feedArray = $this->getFeed();
+        foreach ($feedArray as $feedKey => $feedValue) {
+            if (in_array($feedKey, ['donationUri'])) {
+                continue;
+            }
+            if ($feedKey === 'name') {
+                $title = $document->createElement('title');
+                $feed->appendChild($title);
+                $title->setAttribute('type', 'text');
+                $title->appendChild($document->createTextNode($feedValue));
+            } elseif ($feedKey === 'icon') {
+                if ($feedValue) {
+                    $icon = $document->createElement('icon');
+                    $feed->appendChild($icon);
+                    $icon->appendChild($document->createTextNode($feedValue));
+
+                    $logo = $document->createElement('logo');
+                    $feed->appendChild($logo);
+                    $logo->appendChild($document->createTextNode($feedValue));
+                }
+            } elseif ($feedKey === 'uri') {
+                if ($feedValue) {
+                    $linkAlternate = $document->createElement('link');
+                    $feed->appendChild($linkAlternate);
+                    $linkAlternate->setAttribute('rel', 'alternate');
+                    $linkAlternate->setAttribute('type', 'text/html');
+                    $linkAlternate->setAttribute('href', $feedValue);
+
+                    $linkSelf = $document->createElement('link');
+                    $feed->appendChild($linkSelf);
+                    $linkSelf->setAttribute('rel', 'self');
+                    $linkSelf->setAttribute('type', 'application/atom+xml');
+                    $linkSelf->setAttribute('href', $feedUrl);
+                }
+            } elseif ($feedKey === 'itunes') {
+                // todo: skip?
+            } else {
+                $element = $document->createElement($feedKey);
+                $feed->appendChild($element);
+                $element->appendChild($document->createTextNode($feedValue));
+            }
+        }
 
         $id = $document->createElement('id');
         $feed->appendChild($id);
         $id->appendChild($document->createTextNode($feedUrl));
 
-        $uriparts = parse_url($uri);
-        if (empty($extraInfos['icon'])) {
-            $iconUrl = $uriparts['scheme'] . '://' . $uriparts['host'] . '/favicon.ico';
-        } else {
-            $iconUrl = $extraInfos['icon'];
-        }
-        $icon = $document->createElement('icon');
-        $feed->appendChild($icon);
-        $icon->appendChild($document->createTextNode($iconUrl));
-
-        $logo = $document->createElement('logo');
-        $feed->appendChild($logo);
-        $logo->appendChild($document->createTextNode($iconUrl));
-
         $feedTimestamp = gmdate(DATE_ATOM, $this->lastModified);
         $updated = $document->createElement('updated');
         $feed->appendChild($updated);
@@ -69,17 +86,7 @@ class AtomFormat extends FormatAbstract
         $author->appendChild($authorName);
         $authorName->appendChild($document->createTextNode($feedAuthor));
 
-        $linkAlternate = $document->createElement('link');
-        $feed->appendChild($linkAlternate);
-        $linkAlternate->setAttribute('rel', 'alternate');
-        $linkAlternate->setAttribute('type', 'text/html');
-        $linkAlternate->setAttribute('href', $uri);
 
-        $linkSelf = $document->createElement('link');
-        $feed->appendChild($linkSelf);
-        $linkSelf->setAttribute('rel', 'self');
-        $linkSelf->setAttribute('type', 'application/atom+xml');
-        $linkSelf->setAttribute('href', $feedUrl);
 
         foreach ($this->getItems() as $item) {
             $itemArray = $item->toArray();
diff --git a/formats/HtmlFormat.php b/formats/HtmlFormat.php
index 4933af8d..ef66f493 100644
--- a/formats/HtmlFormat.php
+++ b/formats/HtmlFormat.php
@@ -8,7 +8,7 @@ class HtmlFormat extends FormatAbstract
     {
         $queryString = $_SERVER['QUERY_STRING'];
 
-        $extraInfos = $this->getExtraInfos();
+        $feedArray = $this->getFeed();
         $formatFactory = new FormatFactory();
         $buttons = [];
         $linkTags = [];
@@ -29,9 +29,9 @@ class HtmlFormat extends FormatAbstract
             ];
         }
 
-        if (Configuration::getConfig('admin', 'donations') && $extraInfos['donationUri'] !== '') {
+        if (Configuration::getConfig('admin', 'donations') && $feedArray['donationUri']) {
             $buttons[] = [
-                'href' => e($extraInfos['donationUri']),
+                'href' => e($feedArray['donationUri']),
                 'value' => 'Donate to maintainer',
             ];
         }
@@ -39,7 +39,7 @@ class HtmlFormat extends FormatAbstract
         $items = [];
         foreach ($this->getItems() as $item) {
             $items[] = [
-                'url'           => $item->getURI() ?: $extraInfos['uri'],
+                'url'           => $item->getURI() ?: $feedArray['uri'],
                 'title'         => $item->getTitle() ?? '(no title)',
                 'timestamp'     => $item->getTimestamp(),
                 'author'        => $item->getAuthor(),
@@ -51,9 +51,9 @@ class HtmlFormat extends FormatAbstract
 
         $html = render_template(__DIR__ . '/../templates/html-format.html.php', [
             'charset'   => $this->getCharset(),
-            'title'     => $extraInfos['name'],
+            'title'     => $feedArray['name'],
             'linkTags'  => $linkTags,
-            'uri'       => $extraInfos['uri'],
+            'uri'       => $feedArray['uri'],
             'buttons'   => $buttons,
             'items'     => $items,
         ]);
diff --git a/formats/JsonFormat.php b/formats/JsonFormat.php
index dd61da41..016e75e1 100644
--- a/formats/JsonFormat.php
+++ b/formats/JsonFormat.php
@@ -25,18 +25,18 @@ class JsonFormat extends FormatAbstract
 
     public function stringify()
     {
-        $host = $_SERVER['HTTP_HOST'] ?? '';
-        $extraInfos = $this->getExtraInfos();
+        $feedArray = $this->getFeed();
+
         $data = [
-            'version' => 'https://jsonfeed.org/version/1',
-            'title' => empty($extraInfos['name']) ? $host : $extraInfos['name'],
-            'home_page_url' => empty($extraInfos['uri']) ? REPOSITORY : $extraInfos['uri'],
-            'feed_url' => get_current_url(),
+            'version'       => 'https://jsonfeed.org/version/1',
+            'title'         => $feedArray['name'],
+            'home_page_url' => $feedArray['uri'],
+            'feed_url'      => get_current_url(),
         ];
 
-        if (!empty($extraInfos['icon'])) {
-            $data['icon'] = $extraInfos['icon'];
-            $data['favicon'] = $extraInfos['icon'];
+        if ($feedArray['icon']) {
+            $data['icon'] = $feedArray['icon'];
+            $data['favicon'] = $feedArray['icon'];
         }
 
         $items = [];
diff --git a/formats/MrssFormat.php b/formats/MrssFormat.php
index 5b96a6a7..e93a8289 100644
--- a/formats/MrssFormat.php
+++ b/formats/MrssFormat.php
@@ -35,16 +35,8 @@ class MrssFormat extends FormatAbstract
     public function stringify()
     {
         $document = new \DomDocument('1.0', $this->getCharset());
-
-        $feedUrl = get_current_url();
-        $extraInfos = $this->getExtraInfos();
-        if (empty($extraInfos['uri'])) {
-            $uri = REPOSITORY;
-        } else {
-            $uri = $extraInfos['uri'];
-        }
-
         $document->formatOutput = true;
+
         $feed = $document->createElement('rss');
         $document->appendChild($feed);
         $feed->setAttribute('version', '2.0');
@@ -54,51 +46,74 @@ class MrssFormat extends FormatAbstract
         $channel = $document->createElement('channel');
         $feed->appendChild($channel);
 
-        $title = $extraInfos['name'];
-        $channelTitle = $document->createElement('title');
-        $channel->appendChild($channelTitle);
-        $channelTitle->appendChild($document->createTextNode($title));
+        $feedArray = $this->getFeed();
+        $uri = $feedArray['uri'];
+        $title = $feedArray['name'];
 
-        $link = $document->createElement('link');
-        $channel->appendChild($link);
-        $link->appendChild($document->createTextNode($uri));
+        foreach ($feedArray as $feedKey => $feedValue) {
+            if (in_array($feedKey, ['atom', 'donationUri'])) {
+                continue;
+            }
+            if ($feedKey === 'name') {
+                $channelTitle = $document->createElement('title');
+                $channel->appendChild($channelTitle);
+                $channelTitle->appendChild($document->createTextNode($title));
 
-        $description = $document->createElement('description');
-        $channel->appendChild($description);
-        $description->appendChild($document->createTextNode($extraInfos['name']));
+                $description = $document->createElement('description');
+                $channel->appendChild($description);
+                $description->appendChild($document->createTextNode($title));
+            } elseif ($feedKey === 'uri') {
+                $link = $document->createElement('link');
+                $channel->appendChild($link);
+                $link->appendChild($document->createTextNode($uri));
 
-        $allowedIconExtensions = [
-            '.gif',
-            '.jpg',
-            '.png',
-        ];
-        $icon = $extraInfos['icon'];
-        if (!empty($icon) && in_array(substr($icon, -4), $allowedIconExtensions)) {
-            $feedImage = $document->createElement('image');
-            $channel->appendChild($feedImage);
-            $iconUrl = $document->createElement('url');
-            $iconUrl->appendChild($document->createTextNode($icon));
-            $feedImage->appendChild($iconUrl);
-            $iconTitle = $document->createElement('title');
-            $iconTitle->appendChild($document->createTextNode($title));
-            $feedImage->appendChild($iconTitle);
-            $iconLink = $document->createElement('link');
-            $iconLink->appendChild($document->createTextNode($uri));
-            $feedImage->appendChild($iconLink);
+                $linkAlternate = $document->createElementNS(self::ATOM_NS, 'link');
+                $channel->appendChild($linkAlternate);
+                $linkAlternate->setAttribute('rel', 'alternate');
+                $linkAlternate->setAttribute('type', 'text/html');
+                $linkAlternate->setAttribute('href', $uri);
+
+                $linkSelf = $document->createElementNS(self::ATOM_NS, 'link');
+                $channel->appendChild($linkSelf);
+                $linkSelf->setAttribute('rel', 'self');
+                $linkSelf->setAttribute('type', 'application/atom+xml');
+                $feedUrl = get_current_url();
+                $linkSelf->setAttribute('href', $feedUrl);
+            } elseif ($feedKey === 'icon') {
+                $allowedIconExtensions = [
+                    '.gif',
+                    '.jpg',
+                    '.png',
+                    '.ico',
+                ];
+                $icon = $feedValue;
+                if ($icon && in_array(substr($icon, -4), $allowedIconExtensions)) {
+                    $feedImage = $document->createElement('image');
+                    $channel->appendChild($feedImage);
+                    $iconUrl = $document->createElement('url');
+                    $iconUrl->appendChild($document->createTextNode($icon));
+                    $feedImage->appendChild($iconUrl);
+                    $iconTitle = $document->createElement('title');
+                    $iconTitle->appendChild($document->createTextNode($title));
+                    $feedImage->appendChild($iconTitle);
+                    $iconLink = $document->createElement('link');
+                    $iconLink->appendChild($document->createTextNode($uri));
+                    $feedImage->appendChild($iconLink);
+                }
+            } elseif ($feedKey === 'itunes') {
+                $feed->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:itunes', self::ITUNES_NS);
+                foreach ($feedValue as $itunesKey => $itunesValue) {
+                    $itunesProperty = $document->createElementNS(self::ITUNES_NS, $itunesKey);
+                    $channel->appendChild($itunesProperty);
+                    $itunesProperty->appendChild($document->createTextNode($itunesValue));
+                }
+            } else {
+                $element = $document->createElement($feedKey);
+                $channel->appendChild($element);
+                $element->appendChild($document->createTextNode($feedValue));
+            }
         }
 
-        $linkAlternate = $document->createElementNS(self::ATOM_NS, 'link');
-        $channel->appendChild($linkAlternate);
-        $linkAlternate->setAttribute('rel', 'alternate');
-        $linkAlternate->setAttribute('type', 'text/html');
-        $linkAlternate->setAttribute('href', $uri);
-
-        $linkSelf = $document->createElementNS(self::ATOM_NS, 'link');
-        $channel->appendChild($linkSelf);
-        $linkSelf->setAttribute('rel', 'self');
-        $linkSelf->setAttribute('type', 'application/atom+xml');
-        $linkSelf->setAttribute('href', $feedUrl);
-
         foreach ($this->getItems() as $item) {
             $itemArray = $item->toArray();
             $itemTimestamp = $item->getTimestamp();
@@ -135,6 +150,7 @@ class MrssFormat extends FormatAbstract
                     $entry->appendChild($itunesProperty);
                     $itunesProperty->appendChild($document->createTextNode($itunesValue));
                 }
+
                 if (isset($itemArray['enclosure'])) {
                     $itunesEnclosure = $document->createElement('enclosure');
                     $entry->appendChild($itunesEnclosure);
@@ -142,7 +158,9 @@ class MrssFormat extends FormatAbstract
                     $itunesEnclosure->setAttribute('length', $itemArray['enclosure']['length']);
                     $itunesEnclosure->setAttribute('type', $itemArray['enclosure']['type']);
                 }
-            } if (!empty($itemUri)) {
+            }
+
+            if (!empty($itemUri)) {
                 $entryLink = $document->createElement('link');
                 $entry->appendChild($entryLink);
                 $entryLink->appendChild($document->createTextNode($itemUri));
diff --git a/formats/PlaintextFormat.php b/formats/PlaintextFormat.php
index 0a9237d0..4e18caa6 100644
--- a/formats/PlaintextFormat.php
+++ b/formats/PlaintextFormat.php
@@ -6,11 +6,11 @@ class PlaintextFormat extends FormatAbstract
 
     public function stringify()
     {
-        $data = [];
+        $feed = $this->getFeed();
         foreach ($this->getItems() as $item) {
-            $data[] = $item->toArray();
+            $feed['items'][] = $item->toArray();
         }
-        $text = print_r($data, true);
+        $text = print_r($feed, true);
         // Remove invalid non-UTF8 characters
         ini_set('mbstring.substitute_character', 'none');
         $text = mb_convert_encoding($text, $this->getCharset(), 'UTF-8');
diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index 0f86f454..8001ba4f 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -40,9 +40,38 @@ abstract class BridgeAbstract
 
     abstract public function collectData();
 
-    public function getItems()
+    public function getFeed(): array
     {
-        return $this->items;
+        return [
+            'name'          => $this->getName(),
+            'uri'           => $this->getURI(),
+            'donationUri'   => $this->getDonationURI(),
+            'icon'          => $this->getIcon(),
+        ];
+    }
+
+    public function getName()
+    {
+        return static::NAME;
+    }
+
+    public function getURI()
+    {
+        return static::URI ?? 'https://github.com/RSS-Bridge/rss-bridge/';
+    }
+
+    public function getDonationURI(): string
+    {
+        return static::DONATION_URI;
+    }
+
+    public function getIcon()
+    {
+        if (static::URI) {
+            // This favicon may or may not exist
+            return rtrim(static::URI, '/') . '/favicon.ico';
+        }
+        return '';
     }
 
     public function getOption(string $name)
@@ -50,6 +79,9 @@ abstract class BridgeAbstract
         return $this->configuration[$name] ?? null;
     }
 
+    /**
+     * The description is currently not used in feed production
+     */
     public function getDescription()
     {
         return static::DESCRIPTION;
@@ -60,29 +92,14 @@ abstract class BridgeAbstract
         return static::MAINTAINER;
     }
 
-    public function getName()
-    {
-        return static::NAME;
-    }
-
-    public function getIcon()
-    {
-        return static::URI . '/favicon.ico';
-    }
-
     public function getParameters(): array
     {
         return static::PARAMETERS;
     }
 
-    public function getURI()
+    public function getItems()
     {
-        return static::URI;
-    }
-
-    public function getDonationURI(): string
-    {
-        return static::DONATION_URI;
+        return $this->items;
     }
 
     public function getCacheTimeout()
diff --git a/lib/FormatAbstract.php b/lib/FormatAbstract.php
index c76d1e42..28eb4bbf 100644
--- a/lib/FormatAbstract.php
+++ b/lib/FormatAbstract.php
@@ -9,10 +9,43 @@ abstract class FormatAbstract
     protected string $charset = 'UTF-8';
     protected array $items = [];
     protected int $lastModified;
-    protected array $extraInfos = [];
+
+    protected array $feed = [];
 
     abstract public function stringify();
 
+    public function setFeed(array $feed)
+    {
+        $default = [
+            'name'          => '',
+            'uri'           => '',
+            'icon'          => '',
+            'donationUri'   => '',
+        ];
+        $this->feed = array_merge($default, $feed);
+    }
+
+    public function getFeed(): array
+    {
+        return $this->feed;
+    }
+
+    /**
+     * @param FeedItem[] $items
+     */
+    public function setItems(array $items): void
+    {
+        $this->items = $items;
+    }
+
+    /**
+     * @return FeedItem[] The items
+     */
+    public function getItems(): array
+    {
+        return $this->items;
+    }
+
     public function getMimeType(): string
     {
         return static::MIME_TYPE;
@@ -32,44 +65,4 @@ abstract class FormatAbstract
     {
         $this->lastModified = $lastModified;
     }
-
-    /**
-     * @param FeedItem[] $items
-     */
-    public function setItems(array $items): void
-    {
-        $this->items = $items;
-    }
-
-    /**
-     * @return FeedItem[] The items
-     */
-    public function getItems(): array
-    {
-        return $this->items;
-    }
-
-    public function setExtraInfos(array $infos = [])
-    {
-        $extras = [
-            'name',
-            'uri',
-            'icon',
-            'donationUri',
-        ];
-        foreach ($extras as $extra) {
-            if (!isset($infos[$extra])) {
-                $infos[$extra] = '';
-            }
-        }
-        $this->extraInfos = $infos;
-    }
-
-    public function getExtraInfos(): array
-    {
-        if (!$this->extraInfos) {
-            $this->setExtraInfos();
-        }
-        return $this->extraInfos;
-    }
 }
diff --git a/lib/bootstrap.php b/lib/bootstrap.php
index a95de9dd..85d823e9 100644
--- a/lib/bootstrap.php
+++ b/lib/bootstrap.php
@@ -9,9 +9,6 @@ const PATH_LIB_CACHES = __DIR__ . '/../caches/';
 /** Path to the cache folder */
 const PATH_CACHE = __DIR__ . '/../cache/';
 
-/** URL to the RSS-Bridge repository */
-const REPOSITORY = 'https://github.com/RSS-Bridge/rss-bridge/';
-
 // Allow larger files for simple_html_dom
 // todo: extract to config (if possible)
 const MAX_FILE_SIZE = 10000000;
diff --git a/tests/FormatTest.php b/tests/FormatTest.php
new file mode 100644
index 00000000..b5df395c
--- /dev/null
+++ b/tests/FormatTest.php
@@ -0,0 +1,72 @@
+<?php
+
+declare(strict_types=1);
+
+namespace RssBridge\Tests;
+
+use PHPUnit\Framework\TestCase;
+
+class FormatTest extends TestCase
+{
+    public function testBridge()
+    {
+        $sut = new \MrssFormat();
+
+        $expected = [
+            'name'          => '',
+            'uri'           => '',
+            'icon'          => '',
+            'donationUri'   => '',
+        ];
+        $this->assertEquals([], $sut->getFeed());
+
+        $sut->setFeed([
+            'name'          => '0',
+            'uri'           => '1',
+            'icon'          => '2',
+            'donationUri'   => '3',
+        ]);
+        $expected = [
+            'name'          => '0',
+            'uri'           => '1',
+            'icon'          => '2',
+            'donationUri'   => '3',
+        ];
+        $this->assertEquals($expected, $sut->getFeed());
+
+        $sut->setFeed([]);
+        $expected = [
+            'name'          => '',
+            'uri'           => '',
+            'icon'          => '',
+            'donationUri'   => '',
+        ];
+        $this->assertEquals($expected, $sut->getFeed());
+
+        $sut->setFeed(['foo' => 'bar', 'foo2' => 'bar2']);
+        $expected = [
+            'name'          => '',
+            'uri'           => '',
+            'icon'          => '',
+            'donationUri'   => '',
+            'foo'           => 'bar',
+            'foo2'          => 'bar2',
+        ];
+        $this->assertEquals($expected, $sut->getFeed());
+    }
+}
+
+class TestFormat extends \FormatAbstract
+{
+    public function stringify()
+    {
+    }
+}
+
+class TestBridge extends \BridgeAbstract
+{
+    public function collectData()
+    {
+        $this->items[] = ['title' => 'kek'];
+    }
+}
diff --git a/tests/Formats/BaseFormatTest.php b/tests/Formats/BaseFormatTest.php
index 71e196f0..8999e772 100644
--- a/tests/Formats/BaseFormatTest.php
+++ b/tests/Formats/BaseFormatTest.php
@@ -61,7 +61,7 @@ abstract class BaseFormatTest extends TestCase
         $formatFactory = new FormatFactory();
         $format = $formatFactory->create($formatName);
         $format->setItems($sample->items);
-        $format->setExtraInfos($sample->meta);
+        $format->setFeed($sample->meta);
         $format->setLastModified(strtotime('2000-01-01 12:00:00 UTC'));
 
         return $format->stringify();
diff --git a/tests/Formats/samples/expectedAtomFormat/feed.common.xml b/tests/Formats/samples/expectedAtomFormat/feed.common.xml
index aa6d0687..455e5440 100644
--- a/tests/Formats/samples/expectedAtomFormat/feed.common.xml
+++ b/tests/Formats/samples/expectedAtomFormat/feed.common.xml
@@ -2,15 +2,15 @@
 <feed xmlns="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/">
 
 	<title type="text">Sample feed with common data</title>
-	<id>https://example.com/feed?type=common&amp;items=4</id>
+	<link href="https://example.com/blog/" rel="alternate" type="text/html"/>
+	<link href="https://example.com/feed?type=common&amp;items=4" rel="self" type="application/atom+xml"/>
 	<icon>https://example.com/logo.png</icon>
 	<logo>https://example.com/logo.png</logo>
+	<id>https://example.com/feed?type=common&amp;items=4</id>
 	<updated>2000-01-01T12:00:00+00:00</updated>
 	<author>
 		<name>RSS-Bridge</name>
 	</author>
-	<link href="https://example.com/blog/" rel="alternate" type="text/html"/>
-	<link href="https://example.com/feed?type=common&amp;items=4" rel="self" type="application/atom+xml"/>
 
 	<entry>
 		<title type="html">Test Entry</title>
diff --git a/tests/Formats/samples/expectedAtomFormat/feed.empty.xml b/tests/Formats/samples/expectedAtomFormat/feed.empty.xml
index fc04304d..083f230f 100644
--- a/tests/Formats/samples/expectedAtomFormat/feed.empty.xml
+++ b/tests/Formats/samples/expectedAtomFormat/feed.empty.xml
@@ -2,14 +2,12 @@
 <feed xmlns="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/">
 
 	<title type="text">Sample feed with minimum data</title>
+	<link href="https://github.com/RSS-Bridge/rss-bridge/" rel="alternate" type="text/html"/>
+	<link href="https://example.com/feed" rel="self" type="application/atom+xml"/>
 	<id>https://example.com/feed</id>
-	<icon>https://github.com/favicon.ico</icon>
-	<logo>https://github.com/favicon.ico</logo>
 	<updated>2000-01-01T12:00:00+00:00</updated>
 	<author>
 		<name>RSS-Bridge</name>
 	</author>
-	<link href="https://github.com/RSS-Bridge/rss-bridge/" rel="alternate" type="text/html"/>
-	<link href="https://example.com/feed" rel="self" type="application/atom+xml"/>
 
 </feed>
diff --git a/tests/Formats/samples/expectedAtomFormat/feed.emptyItems.xml b/tests/Formats/samples/expectedAtomFormat/feed.emptyItems.xml
index 18572fac..d7cb461a 100644
--- a/tests/Formats/samples/expectedAtomFormat/feed.emptyItems.xml
+++ b/tests/Formats/samples/expectedAtomFormat/feed.emptyItems.xml
@@ -2,15 +2,13 @@
 <feed xmlns="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/">
 
 	<title type="text">Sample feed with minimum data</title>
+	<link href="https://github.com/RSS-Bridge/rss-bridge/" rel="alternate" type="text/html"/>
+	<link href="https://example.com/feed" rel="self" type="application/atom+xml"/>
 	<id>https://example.com/feed</id>
-	<icon>https://github.com/favicon.ico</icon>
-	<logo>https://github.com/favicon.ico</logo>
 	<updated>2000-01-01T12:00:00+00:00</updated>
 	<author>
 		<name>RSS-Bridge</name>
 	</author>
-	<link href="https://github.com/RSS-Bridge/rss-bridge/" rel="alternate" type="text/html"/>
-	<link href="https://example.com/feed" rel="self" type="application/atom+xml"/>
 
 	<entry>
 		<title type="html">Sample Item #1</title>
diff --git a/tests/Formats/samples/expectedAtomFormat/feed.microblog.xml b/tests/Formats/samples/expectedAtomFormat/feed.microblog.xml
index 32bc0273..8eb0133c 100644
--- a/tests/Formats/samples/expectedAtomFormat/feed.microblog.xml
+++ b/tests/Formats/samples/expectedAtomFormat/feed.microblog.xml
@@ -2,15 +2,15 @@
 <feed xmlns="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/">
 
 	<title type="text">Sample microblog feed</title>
-	<id>https://example.com/feed</id>
+	<link href="https://example.com/blog/" rel="alternate" type="text/html"/>
+	<link href="https://example.com/feed" rel="self" type="application/atom+xml"/>
 	<icon>https://example.com/logo.png</icon>
 	<logo>https://example.com/logo.png</logo>
+	<id>https://example.com/feed</id>
 	<updated>2000-01-01T12:00:00+00:00</updated>
 	<author>
 		<name>RSS-Bridge</name>
 	</author>
-	<link href="https://example.com/blog/" rel="alternate" type="text/html"/>
-	<link href="https://example.com/feed" rel="self" type="application/atom+xml"/>
 
 	<entry>
 		<title type="html">Oh 😲 I found three monkeys 🙈🙉🙊</title>
diff --git a/tests/Formats/samples/expectedMrssFormat/feed.common.xml b/tests/Formats/samples/expectedMrssFormat/feed.common.xml
index 38a16f88..92838ae8 100644
--- a/tests/Formats/samples/expectedMrssFormat/feed.common.xml
+++ b/tests/Formats/samples/expectedMrssFormat/feed.common.xml
@@ -2,15 +2,15 @@
 <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/">
 	<channel>
 		<title>Sample feed with common data</title>
-		<link>https://example.com/blog/</link>
 		<description>Sample feed with common data</description>
+		<link>https://example.com/blog/</link>
+		<atom:link href="https://example.com/blog/" rel="alternate" type="text/html"/>
+		<atom:link href="https://example.com/feed?type=common&amp;items=4" rel="self" type="application/atom+xml"/>
 		<image>
 			<url>https://example.com/logo.png</url>
 			<title>Sample feed with common data</title>
 			<link>https://example.com/blog/</link>
 		</image>
-		<atom:link href="https://example.com/blog/" rel="alternate" type="text/html"/>
-		<atom:link href="https://example.com/feed?type=common&amp;items=4" rel="self" type="application/atom+xml"/>
 
 		<item>
 			<title>Test Entry</title>
diff --git a/tests/Formats/samples/expectedMrssFormat/feed.empty.xml b/tests/Formats/samples/expectedMrssFormat/feed.empty.xml
index 888c42b6..40eecfc6 100644
--- a/tests/Formats/samples/expectedMrssFormat/feed.empty.xml
+++ b/tests/Formats/samples/expectedMrssFormat/feed.empty.xml
@@ -2,8 +2,8 @@
 <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/">
 	<channel>
 		<title>Sample feed with minimum data</title>
-		<link>https://github.com/RSS-Bridge/rss-bridge/</link>
 		<description>Sample feed with minimum data</description>
+		<link>https://github.com/RSS-Bridge/rss-bridge/</link>
 		<atom:link href="https://github.com/RSS-Bridge/rss-bridge/" rel="alternate" type="text/html"/>
 		<atom:link href="https://example.com/feed" rel="self" type="application/atom+xml"/>
 	</channel>
diff --git a/tests/Formats/samples/expectedMrssFormat/feed.emptyItems.xml b/tests/Formats/samples/expectedMrssFormat/feed.emptyItems.xml
index 9e712ddd..8839f5a5 100644
--- a/tests/Formats/samples/expectedMrssFormat/feed.emptyItems.xml
+++ b/tests/Formats/samples/expectedMrssFormat/feed.emptyItems.xml
@@ -2,8 +2,8 @@
 <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/">
 	<channel>
 		<title>Sample feed with minimum data</title>
-		<link>https://github.com/RSS-Bridge/rss-bridge/</link>
 		<description>Sample feed with minimum data</description>
+		<link>https://github.com/RSS-Bridge/rss-bridge/</link>
 		<atom:link href="https://github.com/RSS-Bridge/rss-bridge/" rel="alternate" type="text/html"/>
 		<atom:link href="https://example.com/feed" rel="self" type="application/atom+xml"/>
 
diff --git a/tests/Formats/samples/expectedMrssFormat/feed.microblog.xml b/tests/Formats/samples/expectedMrssFormat/feed.microblog.xml
index 81dac87a..63c04c0f 100644
--- a/tests/Formats/samples/expectedMrssFormat/feed.microblog.xml
+++ b/tests/Formats/samples/expectedMrssFormat/feed.microblog.xml
@@ -2,15 +2,15 @@
 <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/">
 	<channel>
 		<title>Sample microblog feed</title>
-		<link>https://example.com/blog/</link>
 		<description>Sample microblog feed</description>
+		<link>https://example.com/blog/</link>
+		<atom:link href="https://example.com/blog/" rel="alternate" type="text/html"/>
+		<atom:link href="https://example.com/feed" rel="self" type="application/atom+xml"/>
 		<image>
 			<url>https://example.com/logo.png</url>
 			<title>Sample microblog feed</title>
 			<link>https://example.com/blog/</link>
 		</image>
-		<atom:link href="https://example.com/blog/" rel="alternate" type="text/html"/>
-		<atom:link href="https://example.com/feed" rel="self" type="application/atom+xml"/>
 
 		<item>
 			<guid isPermaLink="false">1918f084648b82057c1dd3faa3d091da82a6fac2</guid>
diff --git a/tests/Formats/samples/feed.empty.json b/tests/Formats/samples/feed.empty.json
index aac09f64..7b1a2eae 100644
--- a/tests/Formats/samples/feed.empty.json
+++ b/tests/Formats/samples/feed.empty.json
@@ -6,7 +6,7 @@
 	},
 	"meta": {
 		"name": "Sample feed with minimum data",
-		"uri": "",
+		"uri": "https://github.com/RSS-Bridge/rss-bridge/",
 		"icon": ""
 	},
 	"items": []
diff --git a/tests/Formats/samples/feed.emptyItems.json b/tests/Formats/samples/feed.emptyItems.json
index 0287d428..4d077487 100644
--- a/tests/Formats/samples/feed.emptyItems.json
+++ b/tests/Formats/samples/feed.emptyItems.json
@@ -6,7 +6,7 @@
 	},
 	"meta": {
 		"name": "Sample feed with minimum data",
-		"uri": "",
+		"uri": "https://github.com/RSS-Bridge/rss-bridge/",
 		"icon": ""
 	},
 	"items": [

From 0bf5dbbc0ba46cc27fe40b554b0c3c0ba705ef8b Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 9 Jan 2024 20:33:35 +0100
Subject: [PATCH 251/716] chore: add tools for manually administrating the
 configured cache (#3867)

---
 README.md                              | 36 +++++++++++++++++++++++---
 bridges/PixivBridge.php                | 29 ++++++++++-----------
 docs/10_Bridge_Specific/PixivBridge.md | 15 ++++++++---
 index.php                              | 25 +++---------------
 lib/CacheFactory.php                   |  1 +
 lib/Configuration.php                  |  2 +-
 lib/bootstrap.php                      | 15 +++++++++++
 lib/logger.php                         |  1 +
 phpcs.xml                              |  8 +++++-
 templates/exception.html.php           |  8 ++++++
 10 files changed, 95 insertions(+), 45 deletions(-)

diff --git a/README.md b/README.md
index 34efc8de..46bb5a69 100644
--- a/README.md
+++ b/README.md
@@ -251,7 +251,7 @@ Browse http://localhost:3000/
 [![Deploy to Cloudron](https://cloudron.io/img/button.svg)](https://www.cloudron.io/store/com.rssbridgeapp.cloudronapp.html)
 [![Run on PikaPods](https://www.pikapods.com/static/run-button.svg)](https://www.pikapods.com/pods?run=rssbridge)
 
-The Heroku quick deploy currently does not work. It might possibly work if you fork this repo and
+The Heroku quick deploy currently does not work. It might work if you fork this repo and
 modify the `repository` in `scalingo.json`. See https://github.com/RSS-Bridge/rss-bridge/issues/2688
 
 Learn more in
@@ -259,11 +259,29 @@ Learn more in
 
 ## How-to
 
+### How to remove all cache items
+
+As current user:
+
+    bin/cache-clear
+
+As user rss-bridge:
+
+    sudo -u rss-bridge bin/cache-clear
+
+As root:
+
+    sudo bin/cache-clear
+
+### How to remove all expired cache items
+
+    bin/cache-clear
+
 ### How to fix "PHP Fatal error:  Uncaught Exception: The FileCache path is not writable"
 
 ```shell
-# Give rssbridge ownership
-chown rssbridge:rssbridge -R /var/www/rss-bridge/cache
+# Give rss-bridge ownership
+chown rss-bridge:rss-bridge -R /var/www/rss-bridge/cache
 
 # Or, give www-data ownership
 chown www-data:www-data -R /var/www/rss-bridge/cache
@@ -275,6 +293,16 @@ chmod 777 -R /var/www/rss-bridge/cache
 rm -rf /var/www/rss-bridge/cache/ && mkdir /var/www/rss-bridge/cache/
 ```
 
+### How to fix "attempt to write a readonly database"
+
+The sqlite files (db, wal and shm) are not writeable.
+
+    chown -v rss-bridge:rss-bridge cache/*
+
+### How to fix "Unable to prepare statement: 1, no such table: storage"
+
+    rm cache/*
+
 ### How to create a new bridge from scratch
 
 Create the new bridge in e.g. `bridges/BearBlogBridge.php`:
@@ -389,6 +417,8 @@ These commands require that you have installed the dev dependencies in `composer
     ./vendor/bin/phpunit
     ./vendor/bin/phpcs --standard=phpcs.xml --warning-severity=0 --extensions=php -p ./
 
+https://github.com/squizlabs/PHP_CodeSniffer/wiki
+
 ### How to spawn a minimal development environment
 
     php -S 127.0.0.1:9001
diff --git a/bridges/PixivBridge.php b/bridges/PixivBridge.php
index c4f5277f..fc4443ed 100644
--- a/bridges/PixivBridge.php
+++ b/bridges/PixivBridge.php
@@ -1,9 +1,11 @@
 <?php
 
+/**
+ * Good resource on API return values (Ex: illustType):
+ * https://hackage.haskell.org/package/pixiv-0.1.0/docs/Web-Pixiv-Types.html
+ */
 class PixivBridge extends BridgeAbstract
 {
-    // Good resource on API return values (Ex: illustType):
-    // https://hackage.haskell.org/package/pixiv-0.1.0/docs/Web-Pixiv-Types.html
     const NAME = 'Pixiv Bridge';
     const URI = 'https://www.pixiv.net/';
     const DESCRIPTION = 'Returns the tag search from pixiv.net';
@@ -19,7 +21,6 @@ class PixivBridge extends BridgeAbstract
         ]
     ];
 
-
     const PARAMETERS = [
         'global' => [
             'posts' => [
@@ -251,14 +252,13 @@ class PixivBridge extends BridgeAbstract
                     $img_url = preg_replace('/https:\/\/i\.pximg\.net/', $proxy_url, $result['url']);
                 }
             } else {
-                //else cache and use image.
-                $img_url = $this->cacheImage(
-                    $result['url'],
-                    $result['id'],
-                    array_key_exists('illustType', $result)
-                );
+                $img_url = $result['url'];
+                // Temporarily disabling caching of the image
+                //$img_url = $this->cacheImage($result['url'], $result['id'], array_key_exists('illustType', $result));
             }
-            $item['content'] = "<img src='" . $img_url . "' />";
+
+            // Currently, this might result in broken image due to their strict referrer check
+            $item['content'] = sprintf('<a href="%s"><img src="%s"/></a>', $img_url, $img_url);
 
             // Additional content items
             if (array_key_exists('pageCount', $result)) {
@@ -318,7 +318,7 @@ class PixivBridge extends BridgeAbstract
             if (
                 !(strlen($proxy) > 0 && preg_match('/https?:\/\/.*/', $proxy))
             ) {
-                return returnServerError('Invalid proxy_url value set. The proxy must include the HTTP/S at the beginning of the url.');
+                returnServerError('Invalid proxy_url value set. The proxy must include the HTTP/S at the beginning of the url.');
             }
         }
 
@@ -326,8 +326,7 @@ class PixivBridge extends BridgeAbstract
         if ($cookie) {
             $isAuth = $this->loadCacheValue('is_authenticated');
             if (!$isAuth) {
-                $res = $this->getData('https://www.pixiv.net/ajax/webpush', true, true)
-                    or returnServerError('Invalid PHPSESSID cookie provided. Please check the 🍪 and try again.');
+                $res = $this->getData('https://www.pixiv.net/ajax/webpush', true, true);
                 if ($res['error'] === false) {
                     $this->saveCacheValue('is_authenticated', true);
                 }
@@ -374,11 +373,11 @@ class PixivBridge extends BridgeAbstract
         if ($cache) {
             $data = $this->loadCacheValue($url);
             if (!$data) {
-                $data = getContents($url, $httpHeaders, $curlOptions, true) or returnServerError("Could not load $url");
+                $data = getContents($url, $httpHeaders, $curlOptions, true);
                 $this->saveCacheValue($url, $data);
             }
         } else {
-            $data = getContents($url, $httpHeaders, $curlOptions, true) or returnServerError("Could not load $url");
+            $data = getContents($url, $httpHeaders, $curlOptions, true);
         }
 
         $this->checkCookie($data['headers']);
diff --git a/docs/10_Bridge_Specific/PixivBridge.md b/docs/10_Bridge_Specific/PixivBridge.md
index b782a445..ba8da2d8 100644
--- a/docs/10_Bridge_Specific/PixivBridge.md
+++ b/docs/10_Bridge_Specific/PixivBridge.md
@@ -2,9 +2,14 @@ PixivBridge
 ===============
 
 # Image proxy
-As Pixiv requires images to be loaded with the `Referer "https://www.pixiv.net/"` header set, caching or image proxy is required to use this bridge.
 
-To turn off image caching, set the `proxy_url` value in this bridge's configuration section of `config.ini.php` to the url of the proxy. The bridge will then use the proxy in this format (essentially replacing `https://i.pximg.net` with the proxy): 
+As Pixiv requires images to be loaded with the `Referer "https://www.pixiv.net/"` header set,
+caching or image proxy is required to use this bridge.
+
+To turn off image caching, set the `proxy_url` value in this bridge's configuration section of `config.ini.php`
+to the url of the proxy.
+
+The bridge will then use the proxy in this format (essentially replacing `https://i.pximg.net` with the proxy):
 
 Before: `https://i.pximg.net/img-original/img/0000/00/00/00/00/00/12345678_p0.png`
 
@@ -15,9 +20,11 @@ proxy_url = "https://proxy.example.com"
 ```
 
 # Authentication
-Authentication is required to view and search R-18+ and non-public images. To enable this, set the following in this bridge's configuration in `config.ini.php`.
 
-```
+Authentication is required to view and search R-18+ and non-public images.
+To enable this, set the following in this bridge's configuration in `config.ini.php`.
+
+```ini
 ; from cookie "PHPSESSID". Recommend to get in incognito browser. 
 cookie = "00000000_hashedsessionidhere"
 ```
\ No newline at end of file
diff --git a/index.php b/index.php
index c2c546a1..126200da 100644
--- a/index.php
+++ b/index.php
@@ -1,33 +1,14 @@
 <?php
 
-if (version_compare(\PHP_VERSION, '7.4.0') === -1) {
-    exit('RSS-Bridge requires minimum PHP version 7.4.0!');
-}
-
 require_once __DIR__ . '/lib/bootstrap.php';
 
-$errors = Configuration::checkInstallation();
-if ($errors) {
-    print '<pre>' . implode("\n", $errors) . '</pre>';
-    exit(1);
-}
-
-$customConfig = [];
-if (file_exists(__DIR__ . '/config.ini.php')) {
-    $customConfig = parse_ini_file(__DIR__ . '/config.ini.php', true, INI_SCANNER_TYPED);
-}
-Configuration::loadConfiguration($customConfig, getenv());
-
 // Consider: ini_set('error_reporting', E_ALL & ~E_DEPRECATED);
 date_default_timezone_set(Configuration::getConfig('system', 'timezone'));
 
-$rssBridge = new RssBridge();
-
 set_exception_handler(function (\Throwable $e) {
-    http_response_code(500);
-    print render(__DIR__ . '/templates/exception.html.php', ['e' => $e]);
     RssBridge::getLogger()->error('Uncaught Exception', ['e' => $e]);
-    exit(1);
+    http_response_code(500);
+    exit(render(__DIR__ . '/templates/exception.html.php', ['e' => $e]));
 });
 
 set_error_handler(function ($code, $message, $file, $line) {
@@ -63,4 +44,6 @@ register_shutdown_function(function () {
     }
 });
 
+$rssBridge = new RssBridge();
+
 $rssBridge->main($argv ?? []);
diff --git a/lib/CacheFactory.php b/lib/CacheFactory.php
index df78d9cb..90aa21ba 100644
--- a/lib/CacheFactory.php
+++ b/lib/CacheFactory.php
@@ -37,6 +37,7 @@ class CacheFactory
         if ($index === false) {
             throw new \InvalidArgumentException(sprintf('Invalid cache name: "%s"', $name));
         }
+
         $className = $cacheNames[$index] . 'Cache';
         if (!preg_match('/^[A-Z][a-zA-Z0-9-]*$/', $className)) {
             throw new \InvalidArgumentException(sprintf('Invalid cache classname: "%s"', $className));
diff --git a/lib/Configuration.php b/lib/Configuration.php
index ac7d29bf..ab1c9cdf 100644
--- a/lib/Configuration.php
+++ b/lib/Configuration.php
@@ -59,7 +59,7 @@ final class Configuration
         }
         $config = parse_ini_file(__DIR__ . '/../config.default.ini.php', true, INI_SCANNER_TYPED);
         if (!$config) {
-            throw new \Exception('Error parsing config');
+            throw new \Exception('Error parsing ini config');
         }
         foreach ($config as $header => $section) {
             foreach ($section as $key => $value) {
diff --git a/lib/bootstrap.php b/lib/bootstrap.php
index 85d823e9..fe2069d3 100644
--- a/lib/bootstrap.php
+++ b/lib/bootstrap.php
@@ -1,5 +1,9 @@
 <?php
 
+if (version_compare(\PHP_VERSION, '7.4.0') === -1) {
+    exit('RSS-Bridge requires minimum PHP version 7.4.0!');
+}
+
 // Path to the formats library
 const PATH_LIB_FORMATS = __DIR__ . '/../formats/';
 
@@ -46,3 +50,14 @@ spl_autoload_register(function ($className) {
         }
     }
 });
+
+$errors = Configuration::checkInstallation();
+if ($errors) {
+    exit('<pre>' . implode("\n", $errors) . '</pre>');
+}
+
+$customConfig = [];
+if (file_exists(__DIR__ . '/../config.ini.php')) {
+    $customConfig = parse_ini_file(__DIR__ . '/../config.ini.php', true, INI_SCANNER_TYPED);
+}
+Configuration::loadConfiguration($customConfig, getenv());
diff --git a/lib/logger.php b/lib/logger.php
index 7a902b5b..e579915d 100644
--- a/lib/logger.php
+++ b/lib/logger.php
@@ -149,6 +149,7 @@ final class StreamHandler
         );
         error_log($text);
         if ($record['level'] < Logger::ERROR && Debug::isEnabled()) {
+            // The record level is INFO or WARNING here
             // Not a good idea to print here because http headers might not have been sent
             print sprintf("<pre>%s</pre>\n", e($text));
         }
diff --git a/phpcs.xml b/phpcs.xml
index 5e50470a..21e1f50a 100644
--- a/phpcs.xml
+++ b/phpcs.xml
@@ -1,6 +1,11 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <ruleset name="RSS-Bridge Ruleset">
-  <description>Created with the PHP Coding Standard Generator. http://edorian.github.com/php-coding-standard-generator/</description>
+  <description>
+    Originally created with the PHP Coding Standard Generator.
+    But later manually tweaked.
+    http://edorian.github.com/php-coding-standard-generator/
+  </description>
+
   <exclude-pattern>./static</exclude-pattern>
   <exclude-pattern>./vendor</exclude-pattern>
   <exclude-pattern>./templates</exclude-pattern>
@@ -11,6 +16,7 @@
     <exclude name="PSR1.Classes.ClassDeclaration.MissingNamespace"/>
     <exclude name="PSR1.Classes.ClassDeclaration.MultipleClasses"/>
     <exclude name="PSR1.Files.SideEffects.FoundWithSymbols"/>
+    <exclude name="PSR2.Files.EndFileNewline"/>
     <exclude name="PSR12.Properties.ConstantVisibility.NotFound"/>
   </rule>
 
diff --git a/templates/exception.html.php b/templates/exception.html.php
index e1dd97c1..62ac90b4 100644
--- a/templates/exception.html.php
+++ b/templates/exception.html.php
@@ -23,6 +23,14 @@
             </p>
         <?php endif; ?>
 
+        <?php if ($e->getCode() === 403): ?>
+            <h2>403 Forbidden</h2>
+            <p>
+                The HTTP 403 Forbidden response status code indicates that the
+                server understands the request but refuses to authorize it.
+            </p>
+        <?php endif; ?>
+
         <?php if ($e->getCode() === 404): ?>
             <h2>404 Page Not Found</h2>
             <p>

From 0c08f791efbfc6dd92f89d922984a6a41583de44 Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Tue, 9 Jan 2024 20:34:56 +0100
Subject: [PATCH 252/716] CssSelectorComplexBridge: Use cookies everywhere
 (#3827) (#3870)

---
 bridges/CssSelectorComplexBridge.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bridges/CssSelectorComplexBridge.php b/bridges/CssSelectorComplexBridge.php
index e661fe18..67ad4c92 100644
--- a/bridges/CssSelectorComplexBridge.php
+++ b/bridges/CssSelectorComplexBridge.php
@@ -245,7 +245,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
     protected function getTitle($page, $title_cleanup)
     {
         if (is_string($page)) {
-            $page = getSimpleHTMLDOMCached($page);
+            $page = getSimpleHTMLDOMCached($page, $this->getHeaders());
         }
         $title = html_entity_decode($page->find('title', 0)->plaintext);
         if (!empty($title)) {
@@ -302,7 +302,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
     protected function htmlFindEntryElements($page, $entry_selector, $url_selector, $url_pattern = '', $limit = 0)
     {
         if (is_string($page)) {
-            $page = getSimpleHTMLDOM($page);
+            $page = getSimpleHTMLDOM($page, $this->getHeaders());
         }
 
         $entryElements = $page->find($entry_selector);
@@ -355,7 +355,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
      */
     protected function fetchArticleElementFromPage($entry_url, $content_selector)
     {
-        $entry_html = getSimpleHTMLDOMCached($entry_url);
+        $entry_html = getSimpleHTMLDOMCached($entry_url, $this->getHeaders());
         $article_content = $entry_html->find($content_selector, 0);
 
         if (is_null($article_content)) {

From 1fecc4cfc13072856d68b7a33233a4e5e54a72db Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 9 Jan 2024 21:28:43 +0100
Subject: [PATCH 253/716] Revert "CssSelectorComplexBridge: Use cookies
 everywhere (#3827) (#3870)" (#3881)

This reverts commit 0c08f791efbfc6dd92f89d922984a6a41583de44.
---
 bridges/CssSelectorComplexBridge.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bridges/CssSelectorComplexBridge.php b/bridges/CssSelectorComplexBridge.php
index 67ad4c92..e661fe18 100644
--- a/bridges/CssSelectorComplexBridge.php
+++ b/bridges/CssSelectorComplexBridge.php
@@ -245,7 +245,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
     protected function getTitle($page, $title_cleanup)
     {
         if (is_string($page)) {
-            $page = getSimpleHTMLDOMCached($page, $this->getHeaders());
+            $page = getSimpleHTMLDOMCached($page);
         }
         $title = html_entity_decode($page->find('title', 0)->plaintext);
         if (!empty($title)) {
@@ -302,7 +302,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
     protected function htmlFindEntryElements($page, $entry_selector, $url_selector, $url_pattern = '', $limit = 0)
     {
         if (is_string($page)) {
-            $page = getSimpleHTMLDOM($page, $this->getHeaders());
+            $page = getSimpleHTMLDOM($page);
         }
 
         $entryElements = $page->find($entry_selector);
@@ -355,7 +355,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
      */
     protected function fetchArticleElementFromPage($entry_url, $content_selector)
     {
-        $entry_html = getSimpleHTMLDOMCached($entry_url, $this->getHeaders());
+        $entry_html = getSimpleHTMLDOMCached($entry_url);
         $article_content = $entry_html->find($content_selector, 0);
 
         if (is_null($article_content)) {

From 2e5d2a88f39afccefab58b4fb40d22da7794a4b8 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 9 Jan 2024 21:36:42 +0100
Subject: [PATCH 254/716] fix: only escape iframe,script and link for html
 output (#3882)

---
 formats/AtomFormat.php | 2 +-
 formats/JsonFormat.php | 2 +-
 formats/MrssFormat.php | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/formats/AtomFormat.php b/formats/AtomFormat.php
index 1fabef2e..5c9f2b6a 100644
--- a/formats/AtomFormat.php
+++ b/formats/AtomFormat.php
@@ -179,7 +179,7 @@ class AtomFormat extends FormatAbstract
 
             $content = $document->createElement('content');
             $content->setAttribute('type', 'html');
-            $content->appendChild($document->createTextNode(break_annoying_html_tags($entryContent)));
+            $content->appendChild($document->createTextNode($entryContent));
             $entry->appendChild($content);
 
             foreach ($item->getEnclosures() as $enclosure) {
diff --git a/formats/JsonFormat.php b/formats/JsonFormat.php
index 016e75e1..586aae0a 100644
--- a/formats/JsonFormat.php
+++ b/formats/JsonFormat.php
@@ -47,7 +47,7 @@ class JsonFormat extends FormatAbstract
             $entryTitle = $item->getTitle();
             $entryUri = $item->getURI();
             $entryTimestamp = $item->getTimestamp();
-            $entryContent = $item->getContent() ? break_annoying_html_tags($item->getContent()) : '';
+            $entryContent = $item->getContent() ?? '';
             $entryEnclosures = $item->getEnclosures();
             $entryCategories = $item->getCategories();
 
diff --git a/formats/MrssFormat.php b/formats/MrssFormat.php
index e93a8289..aaa1d0cd 100644
--- a/formats/MrssFormat.php
+++ b/formats/MrssFormat.php
@@ -119,7 +119,7 @@ class MrssFormat extends FormatAbstract
             $itemTimestamp = $item->getTimestamp();
             $itemTitle = $item->getTitle();
             $itemUri = $item->getURI();
-            $itemContent = $item->getContent() ? break_annoying_html_tags($item->getContent()) : '';
+            $itemContent = $item->getContent() ?? '';
             $itemUid = $item->getUid();
             $isPermaLink = 'false';
 

From 491cb50219d8f799d85bfb4e6027adf501e9afa4 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 10 Jan 2024 00:25:36 +0100
Subject: [PATCH 255/716] docs: typo (#3883)

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 46bb5a69..e027d912 100644
--- a/README.md
+++ b/README.md
@@ -275,7 +275,7 @@ As root:
 
 ### How to remove all expired cache items
 
-    bin/cache-clear
+    bin/cache-prune
 
 ### How to fix "PHP Fatal error:  Uncaught Exception: The FileCache path is not writable"
 

From 0eb4f6b2678ab17255ee87bde2f919a7e6883799 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 10 Jan 2024 20:39:15 +0100
Subject: [PATCH 256/716] fix(tiktok): remove duplicate leading slash in url
 path, fix #3884 (#3885)

---
 bridges/TikTokBridge.php | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/bridges/TikTokBridge.php b/bridges/TikTokBridge.php
index 6590df66..22fdfcef 100644
--- a/bridges/TikTokBridge.php
+++ b/bridges/TikTokBridge.php
@@ -35,21 +35,23 @@ class TikTokBridge extends BridgeAbstract
         foreach ($videos as $video) {
             $item = [];
 
-            // Handle link "untracking"
-            $linkParts = parse_url($video->find('a', 0)->href);
-            $link = $linkParts['scheme'] . '://' . $linkParts['host'] . '/' . $linkParts['path'];
+            // Omit query string (remove tracking parameters)
+            $a = $video->find('a', 0);
+            $href = $a->href;
+            $parsedUrl = parse_url($href);
+            $url = $parsedUrl['scheme'] . '://' . $parsedUrl['host'] . '/' . ltrim($parsedUrl['path'], '/');
 
             $image = $video->find('video', 0)->poster;
             $views = $video->find('div[data-e2e=common-Video-Count]', 0)->plaintext;
 
             $enclosures = [$image];
 
-            $item['uri'] = $link;
+            $item['uri'] = $url;
             $item['title'] = 'Video';
             $item['author'] = '@' . $author;
             $item['enclosures'] = $enclosures;
             $item['content'] = <<<EOD
-<a href="{$link}"><img src="{$image}"/></a>
+<a href="{$url}"><img src="{$image}"/></a>
 <p>{$views} views<p><br/>
 EOD;
 

From c7e8ddf4865516a4bddc884cf80c058cb5aad770 Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Wed, 10 Jan 2024 21:47:34 +0100
Subject: [PATCH 257/716]  CssSelectorComplexBridge: Use cookies everywhere
 (RSS-Bridge#3827) (#3886)

v2 after feedback from #3870
---
 bridges/CssSelectorComplexBridge.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bridges/CssSelectorComplexBridge.php b/bridges/CssSelectorComplexBridge.php
index e661fe18..632e6b6a 100644
--- a/bridges/CssSelectorComplexBridge.php
+++ b/bridges/CssSelectorComplexBridge.php
@@ -245,7 +245,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
     protected function getTitle($page, $title_cleanup)
     {
         if (is_string($page)) {
-            $page = getSimpleHTMLDOMCached($page);
+            $page = getSimpleHTMLDOMCached($page, 86400, $this->getHeaders());
         }
         $title = html_entity_decode($page->find('title', 0)->plaintext);
         if (!empty($title)) {
@@ -302,7 +302,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
     protected function htmlFindEntryElements($page, $entry_selector, $url_selector, $url_pattern = '', $limit = 0)
     {
         if (is_string($page)) {
-            $page = getSimpleHTMLDOM($page);
+            $page = getSimpleHTMLDOM($page, $this->getHeaders());
         }
 
         $entryElements = $page->find($entry_selector);
@@ -355,7 +355,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
      */
     protected function fetchArticleElementFromPage($entry_url, $content_selector)
     {
-        $entry_html = getSimpleHTMLDOMCached($entry_url);
+        $entry_html = getSimpleHTMLDOMCached($entry_url, 86400, $this->getHeaders());
         $article_content = $entry_html->find($content_selector, 0);
 
         if (is_null($article_content)) {

From 080e29365a24c5ad0898f2f8bf99e7068c41856b Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 10 Jan 2024 21:48:12 +0100
Subject: [PATCH 258/716] feat(http-client): add http retry count to config
 (#3887)

---
 config.default.ini.php |  5 +++++
 lib/contents.php       |  3 ++-
 lib/http.php           | 30 ++++++++++++++++--------------
 3 files changed, 23 insertions(+), 15 deletions(-)

diff --git a/config.default.ini.php b/config.default.ini.php
index 201b1414..21727c5e 100644
--- a/config.default.ini.php
+++ b/config.default.ini.php
@@ -49,6 +49,11 @@ enable_maintenance_mode = false
 [http]
 ; Operation timeout in seconds
 timeout = 30
+
+; Operation retry count in case of curl error
+retries = 2
+
+; User agent
 useragent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Firefox/102.0"
 
 ; Max http response size in MB
diff --git a/lib/contents.php b/lib/contents.php
index 8676a2a8..9998a3f1 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -38,6 +38,7 @@ function getContents(
     $config = [
         'useragent' => Configuration::getConfig('http', 'useragent'),
         'timeout' => Configuration::getConfig('http', 'timeout'),
+        'retries' => Configuration::getConfig('http', 'retries'),
         'headers' => array_merge($defaultHttpHeaders, $httpHeadersNormalized),
         'curl_options' => $curlOptions,
     ];
@@ -71,7 +72,7 @@ function getContents(
                 // Ignore invalid 'Last-Modified' HTTP header value
             }
         }
-        // todo: to be nice nice citizen we should also check for Etag
+        // todo: We should also check for Etag
     }
 
     $response = $httpClient->request($url, $config);
diff --git a/lib/http.php b/lib/http.php
index bfa6b6bf..405b01c6 100644
--- a/lib/http.php
+++ b/lib/http.php
@@ -63,7 +63,7 @@ final class CurlHttpClient implements HttpClient
             'proxy' => null,
             'curl_options' => [],
             'if_not_modified_since' => null,
-            'retries' => 3,
+            'retries' => 2,
             'max_filesize' => null,
             'max_redirections' => 5,
         ];
@@ -136,26 +136,28 @@ final class CurlHttpClient implements HttpClient
             return $len;
         });
 
-        $attempts = 0;
+        // This retry logic is a bit hard to understand, but it works
+        $tries = 0;
         while (true) {
-            $attempts++;
+            $tries++;
             $body = curl_exec($ch);
             if ($body !== false) {
                 // The network call was successful, so break out of the loop
                 break;
             }
-            if ($attempts > $config['retries']) {
-                // Finally give up
-                $curl_error = curl_error($ch);
-                $curl_errno = curl_errno($ch);
-                throw new HttpException(sprintf(
-                    'cURL error %s: %s (%s) for %s',
-                    $curl_error,
-                    $curl_errno,
-                    'https://curl.haxx.se/libcurl/c/libcurl-errors.html',
-                    $url
-                ));
+            if ($tries <= $config['retries']) {
+                continue;
             }
+            // Max retries reached, give up
+            $curl_error = curl_error($ch);
+            $curl_errno = curl_errno($ch);
+            throw new HttpException(sprintf(
+                'cURL error %s: %s (%s) for %s',
+                $curl_error,
+                $curl_errno,
+                'https://curl.haxx.se/libcurl/c/libcurl-errors.html',
+                $url
+            ));
         }
 
         $statusCode = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);

From d9ac0195506040e68cebfc81c5753e416ab7b22f Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Wed, 10 Jan 2024 18:42:57 -0500
Subject: [PATCH 259/716] [AnnasArchiveBridge] Add new bridge (#3888)

* [AnnasArchiveBridge] Add new bridge

* [AnnasArchiveBridge] Add missing exampleValue

* [AnnasArchiveBridge] Remove vestigial debug print
---
 bridges/AnnasArchiveBridge.php | 175 +++++++++++++++++++++++++++++++++
 1 file changed, 175 insertions(+)
 create mode 100644 bridges/AnnasArchiveBridge.php

diff --git a/bridges/AnnasArchiveBridge.php b/bridges/AnnasArchiveBridge.php
new file mode 100644
index 00000000..e8a1e8c4
--- /dev/null
+++ b/bridges/AnnasArchiveBridge.php
@@ -0,0 +1,175 @@
+<?php
+
+class AnnasArchiveBridge extends BridgeAbstract
+{
+    const NAME = 'Anna\'s Archive';
+    const MAINTAINER = 'phantop';
+    const URI = 'https://annas-archive.org/';
+    const DESCRIPTION = 'Returns books from Anna\'s Archive';
+    const PARAMETERS = [
+        [
+            'q' => [
+                'name' => 'Query',
+                'exampleValue' => 'apothecary diaries',
+                'required' => true,
+            ],
+            'ext' => [
+                'name' => 'Extension',
+                'type' => 'list',
+                'values' => [
+                    'Any' => null,
+                    'azw3' => 'azw3',
+                    'cbr' => 'cbr',
+                    'cbz' => 'cbz',
+                    'djvu' => 'djvu',
+                    'epub' => 'epub',
+                    'fb2' => 'fb2',
+                    'fb2.zip' => 'fb2.zip',
+                    'mobi' => 'mobi',
+                    'pdf' => 'pdf',
+                ]
+            ],
+            'lang' => [
+                'name' => 'Language',
+                'type' => 'list',
+                'values' => [
+                    'Any' => null,
+                    'Afrikaans [af]' => 'af',
+                    'Arabic [ar]' => 'ar',
+                    'Bangla [bn]' => 'bn',
+                    'Belarusian [be]' => 'be',
+                    'Bulgarian [bg]' => 'bg',
+                    'Catalan [ca]' => 'ca',
+                    'Chinese [zh]' => 'zh',
+                    'Church Slavic [cu]' => 'cu',
+                    'Croatian [hr]' => 'hr',
+                    'Czech [cs]' => 'cs',
+                    'Danish [da]' => 'da',
+                    'Dongxiang [sce]' => 'sce',
+                    'Dutch [nl]' => 'nl',
+                    'English [en]' => 'en',
+                    'French [fr]' => 'fr',
+                    'German [de]' => 'de',
+                    'Greek [el]' => 'el',
+                    'Hebrew [he]' => 'he',
+                    'Hindi [hi]' => 'hi',
+                    'Hungarian [hu]' => 'hu',
+                    'Indonesian [id]' => 'id',
+                    'Irish [ga]' => 'ga',
+                    'Italian [it]' => 'it',
+                    'Japanese [ja]' => 'ja',
+                    'Kazakh [kk]' => 'kk',
+                    'Korean [ko]' => 'ko',
+                    'Latin [la]' => 'la',
+                    'Latvian [lv]' => 'lv',
+                    'Lithuanian [lt]' => 'lt',
+                    'Luxembourgish [lb]' => 'lb',
+                    'Ndolo [ndl]' => 'ndl',
+                    'Norwegian [no]' => 'no',
+                    'Persian [fa]' => 'fa',
+                    'Polish [pl]' => 'pl',
+                    'Portuguese [pt]' => 'pt',
+                    'Romanian [ro]' => 'ro',
+                    'Russian [ru]' => 'ru',
+                    'Serbian [sr]' => 'sr',
+                    'Spanish [es]' => 'es',
+                    'Swedish [sv]' => 'sv',
+                    'Tamil [ta]' => 'ta',
+                    'Traditional Chinese [zh‑Hant]' => 'zh‑Hant',
+                    'Turkish [tr]' => 'tr',
+                    'Ukrainian [uk]' => 'uk',
+                    'Unknown language' => '_empty',
+                    'Unknown language [und]' => 'und',
+                    'Unknown language [urdu]' => 'urdu',
+                    'Urdu [ur]' => 'ur',
+                    'Vietnamese [vi]' => 'vi',
+                    'Welsh [cy]' => 'cy',
+                ]
+            ],
+            'content' => [
+                'name' => 'Type',
+                'type' => 'list',
+                'values' => [
+                    'Any' => null,
+                    'Book (fiction)' => 'book_fiction',
+                    'Book (non‑fiction)' => 'book_nonfiction',
+                    'Book (unknown)' => 'book_unknown',
+                    'Comic book' => 'book_comic',
+                    'Journal article' => 'journal_article',
+                    'Magazine' => 'magazine',
+                    'Standards document' => 'standards_document',
+                ]
+            ],
+            'src' => [
+                'name' => 'Source',
+                'type' => 'list',
+                'values' => [
+                    'Any' => null,
+                    'Internet Archive' => 'ia',
+                    'Libgen.li' => 'lgli',
+                    'Libgen.rs' => 'lgrs',
+                    'Sci‑Hub' => 'scihub',
+                    'Z‑Library' => 'zlib',
+                ]
+            ],
+        ]
+    ];
+
+    public function collectData()
+    {
+        $url = $this->getURI();
+        $list = getSimpleHTMLDOMCached($url);
+        $list = defaultLinkTo($list, self::URI);
+
+        // Don't attempt to do anything if not found message is given
+        if ($list->find('.js-not-found-additional')) {
+            return;
+        }
+
+        foreach ($list->find('.w-full > .mb-4 > div > a') as $element) {
+            $item = [];
+            $item['title'] = $element->find('h3', 0)->plaintext;
+            $item['author'] = $element->find('div.italic', 0)->plaintext;
+            $item['uri'] = $element->href;
+            $item['content'] = $element->plaintext;
+            $item['uid'] = $item['uri'];
+
+            if ($item_html = getSimpleHTMLDOMCached($item['uri'])) {
+                $item_html = defaultLinkTo($item_html, self::URI);
+                $item['content'] .= $item_html->find('main img', 0);
+                $item['content'] .= $item_html->find('main .mt-4', 0); // Summary
+                if ($links = $item_html->find('main ul.mb-4', -1)) {
+                    foreach ($links->find('li > a.js-download-link') as $file) {
+                        $item['enclosures'][] = $file->href;
+                    }
+                    // Remove bulk torrents from enclosures list
+                    $item['enclosures'] = array_diff($item['enclosures'], [self::URI . 'datasets']);
+                }
+            }
+
+            $this->items[] = $item;
+        }
+    }
+
+    public function getName()
+    {
+        $name = parent::getName();
+        if ($this->getInput('q') != null) {
+            $name .= ' - ' . $this->getInput('q');
+        }
+        return $name;
+    }
+
+    public function getURI()
+    {
+        $params = array_filter([ // Filter to remove non-provided parameters
+            'q' => $this->getInput('q'),
+            'ext' => $this->getInput('ext'),
+            'lang' => $this->getInput('lang'),
+            'src' => $this->getInput('src'),
+            'content' => $this->getInput('content'),
+        ]);
+        $url = parent::getURI() . 'search?sort=newest&' . http_build_query($params);
+        return $url;
+    }
+}

From d5175aebcc6f74430189caab1525e6511722a6ed Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Thu, 11 Jan 2024 14:09:45 -0500
Subject: [PATCH 260/716] [ScribbleHubBridge] Get author feed title regardless
 of CloudFlare (#3892)

---
 bridges/ScribbleHubBridge.php | 23 +++++++++--------------
 1 file changed, 9 insertions(+), 14 deletions(-)

diff --git a/bridges/ScribbleHubBridge.php b/bridges/ScribbleHubBridge.php
index e7cdf337..0f7c7a6c 100644
--- a/bridges/ScribbleHubBridge.php
+++ b/bridges/ScribbleHubBridge.php
@@ -12,16 +12,16 @@ class ScribbleHubBridge extends FeedExpander
             'uid' => [
                 'name' => 'uid',
                 'required' => true,
-                // Example: Alyson Greaves's stories
-                'exampleValue' => '76208',
+                // Example: miriamrobern's stories
+                'exampleValue' => '149271',
             ],
         ],
         'Series' => [
             'sid' => [
                 'name' => 'sid',
                 'required' => true,
-                // Example: latest chapters from The Sisters of Dorley by Alyson Greaves
-                'exampleValue' => '421879',
+                // Example: latest chapters from Uskweirs
+                'exampleValue' => '965299',
             ],
         ]
     ];
@@ -52,6 +52,10 @@ class ScribbleHubBridge extends FeedExpander
             return [];
         }
 
+        if ($this->queriedContext === 'Author') {
+            $this->author = $item['author'];
+        }
+
         $item['comments'] = $item['uri'] . '#comments';
 
         try {
@@ -90,16 +94,7 @@ class ScribbleHubBridge extends FeedExpander
         $name = parent::getName() . " $this->queriedContext";
         switch ($this->queriedContext) {
             case 'Author':
-                try {
-                    $page = getSimpleHTMLDOMCached(self::URI . 'profile/' . $this->getInput('uid'));
-                } catch (HttpException $e) {
-                    // 403 Forbidden, This means we got anti-bot response
-                    if ($e->getCode() === 403) {
-                        return $name;
-                    }
-                    throw $e;
-                }
-                $title = html_entity_decode($page->find('.p_m_username.fp_authorname', 0)->plaintext);
+                $title = $this->author;
                 break;
             case 'Series':
                 try {

From 191e5b0493f3fc1bf2a3fc4169333c03480be23f Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 12 Jan 2024 01:31:01 +0100
Subject: [PATCH 261/716] feat: add etag support to getContents (#3893)

---
 README.md              |  2 +-
 config.default.ini.php |  2 +-
 lib/BridgeCard.php     |  5 ++---
 lib/FeedExpander.php   |  2 +-
 lib/FeedParser.php     |  4 ++--
 lib/XPathAbstract.php  |  5 ++++-
 lib/contents.php       | 49 +++++++++++++++++++++++-------------------
 lib/http.php           |  4 ++++
 8 files changed, 42 insertions(+), 31 deletions(-)

diff --git a/README.md b/README.md
index e027d912..d6d1046c 100644
--- a/README.md
+++ b/README.md
@@ -163,7 +163,7 @@ PHP ini config:
 ```ini
 ; /etc/php/8.2/fpm/conf.d/30-rss-bridge.ini
 
-max_execution_time = 20
+max_execution_time = 15
 memory_limit = 64M
 ```
 
diff --git a/config.default.ini.php b/config.default.ini.php
index 21727c5e..ee1e54c9 100644
--- a/config.default.ini.php
+++ b/config.default.ini.php
@@ -48,7 +48,7 @@ enable_maintenance_mode = false
 
 [http]
 ; Operation timeout in seconds
-timeout = 30
+timeout = 15
 
 ; Operation retry count in case of curl error
 retries = 2
diff --git a/lib/BridgeCard.php b/lib/BridgeCard.php
index 4781ebc1..a82f8e5a 100644
--- a/lib/BridgeCard.php
+++ b/lib/BridgeCard.php
@@ -16,7 +16,7 @@ final class BridgeCard
 
         $bridge = $bridgeFactory->create($bridgeClassName);
 
-        $isHttps = strpos($bridge->getURI(), 'https') === 0;
+        $isHttps = str_starts_with($bridge->getURI(), 'https');
 
         $uri = $bridge->getURI();
         $name = $bridge->getName();
@@ -113,8 +113,7 @@ EOD;
         }
 
         if (!$isHttps) {
-            $form .= '<div class="secure-warning">Warning :
-This bridge is not fetching its content through a secure connection</div>';
+            $form .= '<div class="secure-warning">Warning: This bridge is not fetching its content through a secure connection</div>';
         }
 
         return $form;
diff --git a/lib/FeedExpander.php b/lib/FeedExpander.php
index 056578e9..c0d7e878 100644
--- a/lib/FeedExpander.php
+++ b/lib/FeedExpander.php
@@ -41,7 +41,7 @@ abstract class FeedExpander extends BridgeAbstract
     }
 
     /**
-     * This method is overidden by bridges
+     * This method is overridden by bridges
      *
      * @return array
      */
diff --git a/lib/FeedParser.php b/lib/FeedParser.php
index 2d982de1..510bcb32 100644
--- a/lib/FeedParser.php
+++ b/lib/FeedParser.php
@@ -7,9 +7,9 @@ declare(strict_types=1);
  *
  * Scrapes out rss 0.91, 1.0, 2.0 and atom 1.0.
  *
- * Produce arrays meant to be used inside rss-bridge.
+ * Produces array meant to be used inside rss-bridge.
  *
- * The item structure is tweaked so that works with FeedItem
+ * The item structure is tweaked so that it works with FeedItem
  */
 final class FeedParser
 {
diff --git a/lib/XPathAbstract.php b/lib/XPathAbstract.php
index e30bb5eb..2206f79a 100644
--- a/lib/XPathAbstract.php
+++ b/lib/XPathAbstract.php
@@ -518,7 +518,10 @@ abstract class XPathAbstract extends BridgeAbstract
         if (strlen($value) === 0) {
             return '';
         }
-        if (strpos($value, 'http://') === 0 || strpos($value, 'https://') === 0) {
+        if (
+            strpos($value, 'http://') === 0
+            || strpos($value, 'https://') === 0
+        ) {
             return $value;
         }
 
diff --git a/lib/contents.php b/lib/contents.php
index 9998a3f1..43db8c03 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -24,6 +24,32 @@ function getContents(
         $headerValue = trim(implode(':', array_slice($parts, 1)));
         $httpHeadersNormalized[$headerName] = $headerValue;
     }
+
+    $requestBodyHash = null;
+    if (isset($curlOptions[CURLOPT_POSTFIELDS])) {
+        $requestBodyHash = md5(Json::encode($curlOptions[CURLOPT_POSTFIELDS], false));
+    }
+    $cacheKey = implode('_', ['server',  $url, $requestBodyHash]);
+
+    /** @var Response $cachedResponse */
+    $cachedResponse = $cache->get($cacheKey);
+    if ($cachedResponse) {
+        $lastModified = $cachedResponse->getHeader('last-modified');
+        if ($lastModified) {
+            try {
+                // Some servers send Unix timestamp instead of RFC7231 date. Prepend it with @ to allow parsing as DateTime
+                $lastModified = new \DateTimeImmutable((is_numeric($lastModified) ? '@' : '') . $lastModified);
+                $config['if_not_modified_since'] = $lastModified->getTimestamp();
+            } catch (Exception $e) {
+                // Failed to parse last-modified
+            }
+        }
+        $etag = $cachedResponse->getHeader('etag');
+        if ($etag) {
+            $httpHeadersNormalized['if-none-match'] = $etag;
+        }
+    }
+
     // Snagged from https://github.com/lwthiker/curl-impersonate/blob/main/firefox/curl_ff102
     $defaultHttpHeaders = [
         'Accept' => 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8',
@@ -35,6 +61,7 @@ function getContents(
         'Sec-Fetch-User' => '?1',
         'TE' => 'trailers',
     ];
+
     $config = [
         'useragent' => Configuration::getConfig('http', 'useragent'),
         'timeout' => Configuration::getConfig('http', 'timeout'),
@@ -53,28 +80,6 @@ function getContents(
         $config['proxy'] = Configuration::getConfig('proxy', 'url');
     }
 
-    $requestBodyHash = null;
-    if (isset($curlOptions[CURLOPT_POSTFIELDS])) {
-        $requestBodyHash = md5(Json::encode($curlOptions[CURLOPT_POSTFIELDS], false));
-    }
-    $cacheKey = implode('_', ['server',  $url, $requestBodyHash]);
-
-    /** @var Response $cachedResponse */
-    $cachedResponse = $cache->get($cacheKey);
-    if ($cachedResponse) {
-        $cachedLastModified = $cachedResponse->getHeader('last-modified');
-        if ($cachedLastModified) {
-            try {
-                // Some servers send Unix timestamp instead of RFC7231 date. Prepend it with @ to allow parsing as DateTime
-                $cachedLastModified = new \DateTimeImmutable((is_numeric($cachedLastModified) ? '@' : '') . $cachedLastModified);
-                $config['if_not_modified_since'] = $cachedLastModified->getTimestamp();
-            } catch (Exception $dateTimeParseFailue) {
-                // Ignore invalid 'Last-Modified' HTTP header value
-            }
-        }
-        // todo: We should also check for Etag
-    }
-
     $response = $httpClient->request($url, $config);
 
     switch ($response->getCode()) {
diff --git a/lib/http.php b/lib/http.php
index 405b01c6..90b65a6e 100644
--- a/lib/http.php
+++ b/lib/http.php
@@ -258,6 +258,10 @@ final class Response
     }
 
     /**
+     * HTTP response may have multiple headers with the same name.
+     *
+     * This method by default, returns only the last header.
+     *
      * @return string[]|string|null
      */
     public function getHeader(string $name, bool $all = false)

From 6eaf0eaa565361d0a18f23cdcd8df894116ad73a Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 17 Jan 2024 20:10:32 +0100
Subject: [PATCH 262/716] fix: add cache clearing tools (#3896)

Forgot to add these in #3867
---
 .gitignore      |  1 -
 bin/cache-clear | 14 ++++++++++++++
 bin/cache-prune | 14 ++++++++++++++
 3 files changed, 28 insertions(+), 1 deletion(-)
 create mode 100755 bin/cache-clear
 create mode 100755 bin/cache-prune

diff --git a/.gitignore b/.gitignore
index 9725342d..6ed95489 100644
--- a/.gitignore
+++ b/.gitignore
@@ -6,7 +6,6 @@ data/
 *.pydevproject
 .project
 .metadata
-bin/
 tmp/
 *.tmp
 *.bak
diff --git a/bin/cache-clear b/bin/cache-clear
new file mode 100755
index 00000000..3563abad
--- /dev/null
+++ b/bin/cache-clear
@@ -0,0 +1,14 @@
+#!/usr/bin/env php
+<?php
+
+/**
+ * Remove all items from the cache
+ */
+
+require __DIR__ . '/../lib/bootstrap.php';
+
+$rssBridge = new RssBridge();
+
+$cache = RssBridge::getCache();
+
+$cache->clear();
diff --git a/bin/cache-prune b/bin/cache-prune
new file mode 100755
index 00000000..7b7a6031
--- /dev/null
+++ b/bin/cache-prune
@@ -0,0 +1,14 @@
+#!/usr/bin/env php
+<?php
+
+/**
+ * Remove all expired items from the cache
+ */
+
+require __DIR__ . '/../lib/bootstrap.php';
+
+$rssBridge = new RssBridge();
+
+$cache = RssBridge::getCache();
+
+$cache->prune();

From 6408123330a28041344cccf3133981196e62a9a6 Mon Sep 17 00:00:00 2001
From: SebLaus <97241865+SebLaus@users.noreply.github.com>
Date: Fri, 19 Jan 2024 03:59:47 +0100
Subject: [PATCH 263/716] [IdealoBridge] added Header with user-agent and fixed
 typo (#3897)

* Added header with useragent

* copy paste error from local test environment

* Fixed missing space in New before

* fixed missing space after comma in argument list
---
 bridges/IdealoBridge.php | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/bridges/IdealoBridge.php b/bridges/IdealoBridge.php
index 89c5f87d..cef2b812 100644
--- a/bridges/IdealoBridge.php
+++ b/bridges/IdealoBridge.php
@@ -42,8 +42,13 @@ class IdealoBridge extends BridgeAbstract
 
     public function collectData()
     {
+        // Needs header with user-agent to function properly.
+        $header = [
+            'user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.2.1 Safari/605.1.15'
+        ];
+
         $link = $this->getInput('Link');
-        $html = getSimpleHTMLDOM($link);
+        $html = getSimpleHTMLDOM($link, $header);
 
         // Get Productname
         $titleobj = $html->find('.oopStage-title', 0);
@@ -80,7 +85,7 @@ class IdealoBridge extends BridgeAbstract
             // Generate Content
             if ($PriceNew > 1) {
                 $content = "<p><b>Price New:</b><br>$PriceNew</p>";
-                $content .= "<p><b>Price Newbefore:</b><br>$OldPriceNew</p>";
+                $content .= "<p><b>Price New before:</b><br>$OldPriceNew</p>";
             }
 
             if ($this->getInput('MaxPriceNew') != '') {

From 12a90e20749471c1f2c794792f6b1fabcb74d13e Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Fri, 19 Jan 2024 21:30:06 +0100
Subject: [PATCH 264/716] Utils: Add Webp MIME type (#3900)

---
 lib/utils.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/utils.php b/lib/utils.php
index e8f00f54..07806e7c 100644
--- a/lib/utils.php
+++ b/lib/utils.php
@@ -171,6 +171,7 @@ function parse_mime_type($url)
             'jpg' => 'image/jpeg',
             'gif' => 'image/gif',
             'png' => 'image/png',
+            'webp' => 'image/webp',
             'image' => 'image/*',
             'mp3' => 'audio/mpeg',
         ];

From bb36eb9eb831eb6bce8641323b7e5ce90798575b Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Fri, 19 Jan 2024 21:30:53 +0100
Subject: [PATCH 265/716] [CssSelectorBridge] Time/Thumbnail improvements
 (#3879) (#3901)

* Implement <time> metadata tag as timestamp source
* Add setting to include thumbnail as article header
---
 bridges/CssSelectorBridge.php             | 25 ++++++++++++++++++-----
 bridges/CssSelectorFeedExpanderBridge.php | 13 ++++++++++++
 bridges/SitemapBridge.php                 |  9 ++++++++
 3 files changed, 42 insertions(+), 5 deletions(-)

diff --git a/bridges/CssSelectorBridge.php b/bridges/CssSelectorBridge.php
index 8fba5285..5b2625a9 100644
--- a/bridges/CssSelectorBridge.php
+++ b/bridges/CssSelectorBridge.php
@@ -56,6 +56,11 @@ class CssSelectorBridge extends BridgeAbstract
                 'title' => 'Some sites set their logo as thumbnail for every article. Use this option to discard it.',
                 'type' => 'checkbox',
             ],
+            'thumbnail_as_header' => [
+                'name' => '[Optional] Insert thumbnail as article header',
+                'title' => 'Insert article main image on top of article contents.',
+                'type' => 'checkbox',
+            ],
             'limit' => self::LIMIT
         ]
     ];
@@ -89,6 +94,7 @@ class CssSelectorBridge extends BridgeAbstract
         $content_cleanup = $this->getInput('content_cleanup');
         $title_cleanup = $this->getInput('title_cleanup');
         $discard_thumbnail = $this->getInput('discard_thumbnail');
+        $thumbnail_as_header = $this->getInput('thumbnail_as_header');
         $limit = $this->getInput('limit') ?? 10;
 
         $html = defaultLinkTo(getSimpleHTMLDOM($this->homepageUrl), $this->homepageUrl);
@@ -109,6 +115,9 @@ class CssSelectorBridge extends BridgeAbstract
                 if ($discard_thumbnail && isset($item['enclosures'])) {
                     unset($item['enclosures']);
                 }
+                if ($thumbnail_as_header && isset($item['enclosures'][0])) {
+                    $item['content'] = '<p><img src="' . $item['enclosures'][0] . '" /></p>' . $item['content'];
+                }
                 $this->items[] = $item;
             }
         }
@@ -311,6 +320,7 @@ class CssSelectorBridge extends BridgeAbstract
         // Facebook Open Graph (og:KEY) - https://developers.facebook.com/docs/sharing/webmasters
         // Twitter (twitter:KEY) - https://developer.twitter.com/en/docs/twitter-for-websites/cards/guides/getting-started
         // Standard meta tags - https://www.w3schools.com/tags/tag_meta.asp
+        // Standard time tag - https://developer.mozilla.org/en-US/docs/Web/HTML/Element/time
 
         // Each Entry field mapping defines a list of possible <meta> tags names that contains the expected value
         static $meta_mappings = [
@@ -323,16 +333,16 @@ class CssSelectorBridge extends BridgeAbstract
             'uri' => [
                 'og:url',
                 'twitter:url',
-                'canonical'
+                'canonical',
             ],
             'title' => [
                 'og:title',
-                'twitter:title'
+                'twitter:title',
             ],
             'content' => [
                 'og:description',
                 'twitter:description',
-                'description'
+                'description',
             ],
             'timestamp' => [
                 'article:published_time',
@@ -342,7 +352,8 @@ class CssSelectorBridge extends BridgeAbstract
                 'article:modified_time',
                 'og:article:modified_time',
                 'lastModified',
-                'lastmodified'
+                'lastmodified',
+                'time',
             ],
             'enclosures' => [
                 'og:image:secure_url',
@@ -350,7 +361,7 @@ class CssSelectorBridge extends BridgeAbstract
                 'og:image',
                 'twitter:image',
                 'thumbnailImg',
-                'thumbnailimg'
+                'thumbnailimg',
             ],
             'author' => [
                 'article:author',
@@ -375,6 +386,8 @@ class CssSelectorBridge extends BridgeAbstract
                 $element = null;
                 if ($field === 'canonical') {
                     $element = $entry_html->find('link[rel=canonical]');
+                } else if ($field === 'time') {
+                    $element = $entry_html->find('time[datetime]');
                 } else {
                     $element = $entry_html->find("meta[property=$field], meta[name=$field]");
                 }
@@ -384,6 +397,8 @@ class CssSelectorBridge extends BridgeAbstract
                     $field_value = '';
                     if ($field === 'canonical') {
                         $field_value = $element->href;
+                    } else if ($field === 'time') {
+                        $field_value = $element->datetime;
                     } else {
                         $field_value = $element->content;
                     }
diff --git a/bridges/CssSelectorFeedExpanderBridge.php b/bridges/CssSelectorFeedExpanderBridge.php
index 49bbd473..c4763a86 100644
--- a/bridges/CssSelectorFeedExpanderBridge.php
+++ b/bridges/CssSelectorFeedExpanderBridge.php
@@ -37,6 +37,11 @@ class CssSelectorFeedExpanderBridge extends CssSelectorBridge
                 'title' => 'Some sites set their logo as thumbnail for every article. Use this option to discard it.',
                 'type' => 'checkbox',
             ],
+            'thumbnail_as_header' => [
+                'name' => '[Optional] Insert thumbnail as article header',
+                'title' => 'Insert article main image on top of article contents.',
+                'type' => 'checkbox',
+            ],
             'limit' => self::LIMIT
         ]
     ];
@@ -48,6 +53,7 @@ class CssSelectorFeedExpanderBridge extends CssSelectorBridge
         $content_cleanup = $this->getInput('content_cleanup');
         $dont_expand_metadata = $this->getInput('dont_expand_metadata');
         $discard_thumbnail = $this->getInput('discard_thumbnail');
+        $thumbnail_as_header = $this->getInput('thumbnail_as_header');
         $limit = $this->getInput('limit');
 
         $feedParser = new FeedParser();
@@ -100,6 +106,13 @@ class CssSelectorFeedExpanderBridge extends CssSelectorBridge
                 unset($item_expanded['enclosures']);
             }
 
+            if ($thumbnail_as_header && isset($item_expanded['enclosures'][0])) {
+                $item_expanded['content'] = '<p><img src="'
+                    . $item_expanded['enclosures'][0]
+                    . '" /></p>'
+                    . $item_expanded['content'];
+            }
+
             $this->items[] = $item_expanded;
         }
     }
diff --git a/bridges/SitemapBridge.php b/bridges/SitemapBridge.php
index bbbb3e16..071cb0ef 100644
--- a/bridges/SitemapBridge.php
+++ b/bridges/SitemapBridge.php
@@ -58,6 +58,11 @@ class SitemapBridge extends CssSelectorBridge
                 'title' => 'Some sites set their logo as thumbnail for every article. Use this option to discard it.',
                 'type' => 'checkbox',
             ],
+            'thumbnail_as_header' => [
+                'name' => '[Optional] Insert thumbnail as article header',
+                'title' => 'Insert article main image on top of article contents.',
+                'type' => 'checkbox',
+            ],
             'limit' => self::LIMIT
         ]
     ];
@@ -71,6 +76,7 @@ class SitemapBridge extends CssSelectorBridge
         $title_cleanup = $this->getInput('title_cleanup');
         $site_map = $this->getInput('site_map');
         $discard_thumbnail = $this->getInput('discard_thumbnail');
+        $thumbnail_as_header = $this->getInput('thumbnail_as_header');
         $limit = $this->getInput('limit');
 
         $this->feedName = $this->titleCleanup($this->getPageTitle($this->homepageUrl), $title_cleanup);
@@ -87,6 +93,9 @@ class SitemapBridge extends CssSelectorBridge
             if ($discard_thumbnail && isset($item['enclosures'])) {
                 unset($item['enclosures']);
             }
+            if ($thumbnail_as_header && isset($item['enclosures'])) {
+                $item['content'] = '<p><img src="' . $item['enclosures'][0] . '" /></p>' . $item['content'];
+            }
             $this->items[] = $item;
         }
     }

From d960e0049d1746b64d8f31a57cc157b81dbde119 Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Sat, 20 Jan 2024 10:31:32 +0100
Subject: [PATCH 266/716] [NextINpact Bridge] Rename into NextInkBridge

Site migrated from https://www.nextinpact.com/ to https://next.ink/
---
 bridges/{NextInpactBridge.php => NextInkBridge.php} | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename bridges/{NextInpactBridge.php => NextInkBridge.php} (100%)

diff --git a/bridges/NextInpactBridge.php b/bridges/NextInkBridge.php
similarity index 100%
rename from bridges/NextInpactBridge.php
rename to bridges/NextInkBridge.php

From a865b1073a198b4ac74fcf77c9550ff354f3f10a Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Sat, 20 Jan 2024 10:32:30 +0100
Subject: [PATCH 267/716] [Next.Ink] Rewrite bridge (#3863)

Adjust to changed feeds and html template.
Not backward compatible with existing feeds.
---
 bridges/NextInkBridge.php | 230 +++++++++++++++++++-------------------
 1 file changed, 113 insertions(+), 117 deletions(-)

diff --git a/bridges/NextInkBridge.php b/bridges/NextInkBridge.php
index 6982c104..d9410d51 100644
--- a/bridges/NextInkBridge.php
+++ b/bridges/NextInkBridge.php
@@ -1,11 +1,10 @@
 <?php
 
-class NextInpactBridge extends FeedExpander
+class NextInkBridge extends FeedExpander
 {
-    const MAINTAINER = 'qwertygc and ORelio';
-    const NAME = 'NextInpact Bridge';
-    const URI = 'https://www.nextinpact.com/';
-    const URI_HARDWARE = 'https://www.inpact-hardware.com/';
+    const MAINTAINER = 'ORelio';
+    const NAME = 'Next.Ink Bridge';
+    const URI = 'https://www.next.ink/';
     const DESCRIPTION = 'Returns the newest articles.';
 
     const PARAMETERS = [ [
@@ -13,31 +12,31 @@ class NextInpactBridge extends FeedExpander
             'name' => 'Feed',
             'type' => 'list',
             'values' => [
-                'Nos actualités' => [
+                'Publications' => [
                     'Toutes nos publications' => 'news',
-                    'Toutes nos publications sauf #LeBrief' => 'nobrief',
-                    'Toutes nos publications sauf INpact Hardware' => 'noih',
-                    'Seulement les publications INpact Hardware' => 'hardware:news',
-                    'Seulement les publications Next INpact' => 'nobrief-noih',
-                    'Seulement les publications #LeBrief' => 'lebrief',
+                    'Droit' => 'news:3',
+                    'Économie' => 'news:4',
+                    'Flock' => 'news:13',
+                    'Hardware' => 'news:9',
+                    'IA et algorithmes' => 'news:6',
+                    'Internet' => 'news:7',
+                    'Logiciel' => 'news:8',
+                    'Next' => 'news:14',
+                    'Réseaux sociaux' => 'news:5',
+                    'Sciences et escpace' => 'news:10',
+                    'Sécurité' => 'news:12',
+                    'Société numérique' => 'news:11',
                 ],
-                'Flux spécifiques' => [
-                    'Le blog' => 'blog',
-                    'Les bons plans' => 'bonsplans',
-                    'Publications INpact Hardware en accès libre' => 'hardware:acces-libre',
-                    'Publications Next INpact en accès libre' => 'acces-libre',
+                'Flux Gratuit' => [
+                    'Publications en accès libre' => 'free',
                 ],
-                'Flux thématiques' => [
-                    'Tech' => 'category:1',
-                    'Logiciel' => 'category:2',
-                    'Internet' => 'category:3',
-                    'Mobilité' => 'category:4',
-                    'Droit' => 'category:5',
-                    'Économie' => 'category:6',
-                    'Culture numérique' => 'category:7',
-                    'Next INpact' => 'category:8',
-                ]
-            ]
+            ],
+            'title' => <<<EOT
+                To obtain individual #LeBrief articles in your feed reader, generate two feeds:
+                1. "Publications" with "Hide brief": Everything except #LeBrief
+                2. "Flux Gratuit" with "Only Brief": Individual #LeBrief articles
+                There may be a lot of #LeBrief entries at once, increase limit of "Flux Gratuit" to 20.
+                EOT,
         ],
         'filter_premium' => [
             'name' => 'Premium',
@@ -46,7 +45,8 @@ class NextInpactBridge extends FeedExpander
                 'No filter' => '0',
                 'Hide Premium' => '1',
                 'Only Premium' => '2'
-            ]
+            ],
+            'title' => 'Note: "Flux Gratuit" already excludes Premium articles.',
         ],
         'filter_brief' => [
             'name' => 'Brief',
@@ -55,61 +55,79 @@ class NextInpactBridge extends FeedExpander
                 'No filter' => '0',
                 'Hide Brief' => '1',
                 'Only Brief' => '2'
-            ]
+            ],
+            'title' => 'Note: "Publications" has only one #LeBrief entry each day.',
         ],
         'limit' => self::LIMIT,
     ]];
 
     public function collectData()
     {
-        $feed = $this->getInput('feed');
-        $base_uri = self::URI;
-        $args = '';
-
-        if (empty($feed)) {
-            // Default to All articles
-            $feed = 'news';
-        }
-
-        if (strpos($feed, 'hardware:') === 0) {
-            // Feed hosted on Hardware domain
-            $base_uri = self::URI_HARDWARE;
-            $feed = str_replace('hardware:', '', $feed);
-        }
-
-        if (strpos($feed, 'category:') === 0) {
-            // Feed with specific category parameter
-            $args = '?CategoryIds=' . str_replace('category:', '', $feed);
-            $feed = 'params';
-        }
-
-        $url = sprintf('%srss/%s.xml%s', $base_uri, $feed, $args);
         $limit = $this->getInput('limit') ?? 10;
-        $this->collectExpandableDatas($url, $limit);
+
+        $feed = explode(':', $this->getInput('feed'));
+        $category = '';
+        if (count($feed) > 1) {
+            $category = $feed[1];
+        }
+        $feed = $feed[0];
+
+        if ($feed === 'news') {
+            // Scrap HTML listing to build list of articles
+            $url = self::URI;
+            if ($category !== '') {
+                $url = $url . '?category=' . $category;
+            }
+            $this->collectArticlesFromHtmlListing($url, $limit);
+        } else if ($feed === 'free') {
+            // Expand Free RSS feed
+            $url = self::URI . 'feed/free';
+            $this->collectExpandableDatas($url, $limit);
+        }
+    }
+
+    protected function collectArticlesFromHtmlListing($url, $limit)
+    {
+        $html = getSimpleHTMLDOM($url);
+        $html = convertLazyLoading($html);
+        foreach ($html->find('.block-article') as $article) {
+            $author = $article->find('.author', 0);
+            $subtitle = $article->find('h3', 0);
+            $item = [
+                'uri' => trim($article->find('a', 0)->href),
+                'title' => trim($article->find('h2', 0)->plaintext),
+                'author' => is_object($author) ? trim($author->plaintext) : '',
+                'enclosures' => [ $article->find('img', 0)->src ],
+                'content' => is_object($subtitle) ? trim($subtitle->plaintext) : '',
+            ];
+            $item = $this->parseItem($item);
+            if ($item !== null) {
+                $this->items[] = $item;
+                if (--$limit == 0) {
+                    break;
+                }
+            }
+        }
     }
 
     protected function parseItem(array $item)
     {
-        $item['content'] = $this->extractContent($item, $item['uri']);
-        if (is_null($item['content'])) {
-            return null; //Filtered article
-        }
-        return $item;
-    }
+        $html = getSimpleHTMLDOMCached($item['uri']);
+        $html = convertLazyLoading($html);
 
-    private function extractContent($item, $url)
-    {
-        $html = getSimpleHTMLDOMCached($url);
         if (!is_object($html)) {
-            return 'Failed to request NextInpact: ' . $url;
+            $item['content'] = $item['content']
+                . '<p><em>Failed to request Next.ink: ' . $item['uri'] . '</em></p>';
+            return $item;
         }
 
         // Filter premium and brief articles?
-        $brief_selector = 'div.brief-container';
+        $paywall_selector = 'div#paywall';
+        $brief_selector = 'div.brief-article';
         foreach (
             [
-            'filter_premium' => 'p.red-msg',
-            'filter_brief' => $brief_selector
+            'filter_premium' => $paywall_selector,
+            'filter_brief' => $brief_selector,
             ] as $param_name => $selector
         ) {
             $param_val = intval($this->getInput($param_name));
@@ -122,71 +140,49 @@ class NextInpactBridge extends FeedExpander
             }
         }
 
-        $article_content = $html->find('div.article-content', 0);
-        if (!is_object($article_content)) {
-            $article_content = $html->find('div.content', 0);
-        }
+        $article_content = $html->find('div.article-contenu, ' . $brief_selector, 0);
         if (is_object($article_content)) {
-            // Subtitle
-            $subtitle = $html->find('small.subtitle', 0);
-            if (!is_object($subtitle) && !is_object($html->find($brief_selector, 0))) {
-                $subtitle = $html->find('small', 0);
-            }
-            if (!is_object($subtitle)) {
-                $content_wrapper = $html->find('div.content-wrapper', 0);
-                if (is_object($content_wrapper)) {
-                    $subtitle = $content_wrapper->find('h2.title', 0);
+            // Clean article content
+            foreach (
+                [
+                    'h1',
+                    'div.author',
+                    'p.brief-categories',
+                    'div.thumbnail-mobile',
+                    'div#share-bottom',
+                    'div.author-info',
+                    'div.other-article',
+                    'script',
+                ] as $item_to_remove
+            ) {
+                foreach ($article_content->find($item_to_remove) as $dom_node) {
+                    $dom_node->outertext = '';
                 }
             }
-            if (is_object($subtitle) && (!isset($item['title']) || $subtitle->plaintext != $item['title'])) {
-                $subtitle = '<p><em>' . trim($subtitle->plaintext) . '</em></p>';
-            } else {
-                $subtitle = '';
-            }
-
             // Image
-            $postimg = $html->find('div.article-image, div.image-container', 0);
-            if (is_object($postimg)) {
+            $postimg = $article_content->find('div.thumbnail', 0);
+            if (empty($item['enclosures']) && is_object($postimg)) {
                 $postimg = $postimg->find('img', 0);
                 if (!empty($postimg->src)) {
-                    $postimg = $postimg->src;
-                } else {
-                    $postimg = $postimg->srcset; //"url 355w, url 1003w, url 748w"
-                    $postimg = explode(', ', $postimg); //split by ', ' to get each url separately
-                    $postimg = end($postimg); //Get last item: "url 748w" which is of largest size
-                    $postimg = explode(' ', $postimg); //split by ' ' to separate url from res
-                    $postimg = array_reverse($postimg); //reverse array content to have url last
-                    $postimg = end($postimg); //Get last item of array: "url"
+                    $item['enclosures'] = [ $postimg->src ];
                 }
-                $postimg = '<p><img src="' . $postimg . '" alt="-" /></p>';
-            } else {
-                $postimg = '';
             }
-
+            // Timestamp
+            $published_time = $html->find('meta[property=article:published_time]', 0);
+            if (!isset($item['timestamp']) && is_object($published_time)) {
+                $item['timestamp'] = strtotime($published_time->content);
+            }
             // Paywall
-            $paywall = $html->find('div.paywall-restriction', 0);
-            if (is_object($paywall) && is_object($paywall->find('p.red-msg', 0))) {
-                $paywall = '<p><em>' . $paywall->find('span.head-mention', 0)->innertext . '</em></p>';
-            } else {
-                $paywall = '';
+            $paywall = $article_content->find($paywall_selector, 0);
+            if (is_object($paywall) && is_object($paywall->find('h3', 0))) {
+                $paywall->outertext = '<p><em>' . $paywall->find('h3', 0)->innertext . '</em></p>';
             }
-
             // Content
-            $article_content = $article_content->outertext;
-            $article_content = str_replace('>Signaler une erreur</span>', '></span>', $article_content);
-
-            // Result
-            $text = $subtitle
-                . $postimg
-                . $article_content
-                . $paywall;
+            $item['content'] = $article_content->outertext;
         } else {
-            $text = '<p><em>Failed to retrieve full article content</em></p>';
-            if (isset($item['content'])) {
-                $text = $item['content'] . $text;
-            }
+            $item['content'] = $item['content'] . '<p><em>Failed to retrieve full article content</em></p>';
         }
 
-        return $text;
+        return $item;
     }
 }

From fffe4663cbbc802263aa127428d3551998fbc0b4 Mon Sep 17 00:00:00 2001
From: knrdl <35548889+knrdl@users.noreply.github.com>
Date: Sat, 20 Jan 2024 17:17:04 +0100
Subject: [PATCH 268/716] [KleinanzeigenBridge] Add filter options

---
 bridges/KleinanzeigenBridge.php | 75 ++++++++++++++++++++++-----------
 1 file changed, 51 insertions(+), 24 deletions(-)

diff --git a/bridges/KleinanzeigenBridge.php b/bridges/KleinanzeigenBridge.php
index e0535b59..42d1e79c 100644
--- a/bridges/KleinanzeigenBridge.php
+++ b/bridges/KleinanzeigenBridge.php
@@ -6,7 +6,7 @@ class KleinanzeigenBridge extends BridgeAbstract
     const NAME = 'Kleinanzeigen Bridge';
     const URI = 'https://www.kleinanzeigen.de';
     const CACHE_TIMEOUT = 3600; // 1h
-    const DESCRIPTION = 'ebay Kleinanzeigen';
+    const DESCRIPTION = '(ebay) Kleinanzeigen';
 
     const PARAMETERS = [
         'By search' => [
@@ -15,6 +15,11 @@ class KleinanzeigenBridge extends BridgeAbstract
                 'required' => false,
                 'title' => 'query term',
             ],
+            'category' => [
+                'name' => 'category',
+                'required' => false,
+                'title' => 'search category, e.g. "Damenschuhe" or "Notebooks"'
+            ],
             'location' => [
                 'name' => 'location',
                 'required' => false,
@@ -24,9 +29,23 @@ class KleinanzeigenBridge extends BridgeAbstract
                 'name' => 'radius',
                 'required' => false,
                 'type' => 'number',
-                'title' => 'search radius in kilometers',
+                'title' => 'location radius in kilometers',
                 'defaultValue' => 10,
             ],
+            'minprice' => [
+                'name' => 'minimum price',
+                'required' => false,
+                'type' => 'number',
+                'title' => 'in euros',
+                'defaultValue' => '',
+            ],
+            'maxprice' => [
+                'name' => 'maximum price',
+                'required' => false,
+                'type' => 'number',
+                'title' => 'in euros',
+                'defaultValue' => '',
+            ],
             'pages' => [
                 'name' => 'pages',
                 'required' => true,
@@ -63,7 +82,7 @@ class KleinanzeigenBridge extends BridgeAbstract
             case 'By profile':
                 return 'Kleinanzeigen Profil';
             case 'By search':
-                return 'Kleinanzeigen ' . $this->getInput('query') . ' / ' . $this->getInput('location');
+                return 'Kleinanzeigen ' . $this->getInput('query') . ' ' . $this->getInput('category') . ' ' . $this->getInput('location');
             default:
                 return parent::getName();
         }
@@ -87,31 +106,24 @@ class KleinanzeigenBridge extends BridgeAbstract
         }
 
         if ($this->queriedContext === 'By search') {
-            $locationID = '';
-            if ($this->getInput('location')) {
-                $json = getContents(self::URI . '/s-ort-empfehlungen.json?' . http_build_query(['query' => $this->getInput('location')]));
-                $jsonFile = json_decode($json, true);
-                $locationID = str_replace('_', '', array_key_first($jsonFile));
-            }
-            for ($i = 1; $i <= $this->getInput('pages'); $i++) {
-                $searchUrl = self::URI . '/s-walled-garden/';
-                if ($i != 1) {
-                    $searchUrl .= 'seite:' . $i . '/';
-                }
-                if ($this->getInput('query')) {
-                    $searchUrl .= urlencode($this->getInput('query')) . '/k0';
-                }
-                if ($locationID) {
-                    $searchUrl .= 'l' . $locationID;
-                }
-                if ($this->getInput('radius')) {
-                    $searchUrl .= 'r' . $this->getInput('radius');
-                }
+            $categoryId = $this->findCategoryId();
+            for ($page = 1; $page <= $this->getInput('pages'); $page++) {
+                $searchUrl = self::URI . '/s-suchanfrage.html?' . http_build_query([
+                    'keywords' => $this->getInput('query'),
+                    'locationStr' => $this->getInput('location'),
+                    'locationId' => '',
+                    'radius' => $this->getInput('radius') || '0',
+                    'sortingField' => 'SORTING_DATE',
+                    'categoryId' => $categoryId,
+                    'pageNum' => $page,
+                    'maxPrice' => $this->getInput('maxprice'),
+                    'minPrice' => $this->getInput('minprice')
+                ]);
 
                 $html = getSimpleHTMLDOM($searchUrl);
 
                 // end of list if returned page is not the expected one
-                if ($html->find('.pagination-current', 0)->plaintext != $i) {
+                if ($html->find('.pagination-current', 0)->plaintext != $page) {
                     break;
                 }
 
@@ -147,4 +159,19 @@ class KleinanzeigenBridge extends BridgeAbstract
 
         $this->items[] = $item;
     }
+
+    private function findCategoryId()
+    {
+        if ($this->getInput('category')) {
+            $html = getSimpleHTMLDOM(self::URI . '/s-kategorie-baum.html');
+            foreach ($html->find('a[data-val]') as $element) {
+                $catId = (int)$element->getAttribute('data-val');
+                $catName = $element->plaintext;
+                if (str_contains(strtolower($catName), strtolower($this->getInput('category')))) {
+                    return $catId;
+                }
+            }
+        }
+        return 0;
+    }
 }

From 72eea1bd3df302c341b00cb6aca471b8139d19c9 Mon Sep 17 00:00:00 2001
From: knrdl <35548889+knrdl@users.noreply.github.com>
Date: Sat, 20 Jan 2024 17:58:21 +0100
Subject: [PATCH 269/716] [KleinanzeigenBridge] remove unnecessary params

---
 bridges/KleinanzeigenBridge.php | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/bridges/KleinanzeigenBridge.php b/bridges/KleinanzeigenBridge.php
index 42d1e79c..d4993a07 100644
--- a/bridges/KleinanzeigenBridge.php
+++ b/bridges/KleinanzeigenBridge.php
@@ -36,15 +36,13 @@ class KleinanzeigenBridge extends BridgeAbstract
                 'name' => 'minimum price',
                 'required' => false,
                 'type' => 'number',
-                'title' => 'in euros',
-                'defaultValue' => '',
+                'title' => 'in euros'
             ],
             'maxprice' => [
                 'name' => 'maximum price',
                 'required' => false,
                 'type' => 'number',
-                'title' => 'in euros',
-                'defaultValue' => '',
+                'title' => 'in euros'
             ],
             'pages' => [
                 'name' => 'pages',

From 6ac976b92ea3f4c913288afe40e36d69c818d1f1 Mon Sep 17 00:00:00 2001
From: Clemens Neubauer <cn-tools@gmx.at>
Date: Sun, 21 Jan 2024 16:26:25 +0100
Subject: [PATCH 270/716] create bridge to BMDSystemhaus Blog (#3907)

* create bridge to BMDSystemhaus Blog

* Update BMDSystemhausBlogBridge.php

* Update BMDSystemhausBlogBridge.php
---
 bridges/BMDSystemhausBlogBridge.php | 167 ++++++++++++++++++++++++++++
 1 file changed, 167 insertions(+)
 create mode 100644 bridges/BMDSystemhausBlogBridge.php

diff --git a/bridges/BMDSystemhausBlogBridge.php b/bridges/BMDSystemhausBlogBridge.php
new file mode 100644
index 00000000..327f165d
--- /dev/null
+++ b/bridges/BMDSystemhausBlogBridge.php
@@ -0,0 +1,167 @@
+<?php
+
+class BMDSystemhausBlogBridge extends BridgeAbstract
+{
+    const MAINTAINER = 'cn-tools';
+    const NAME = 'BMD SYSTEMHAUS GesmbH';
+    const CACHE_TIMEOUT = 21600; //6h
+    const URI = 'https://www.bmd.com';
+    const DESCRIPTION = 'BMD Systemhaus - Blog';
+
+    const PARAMETERS = [
+        'Blog' => [
+            'country' => [
+                'name' => 'Country',
+                'type' => 'list',
+                'values' => [
+                    'Österreich' => 'at',
+                    'Deutschland' => 'de',
+                    'Schweiz' => 'ch',
+                    'Slovensko' => 'sk',
+                    'Cesko' => 'cz',
+                    'Hungary' => 'hu'
+                ]
+            ]
+        ]
+    ];
+
+    //-----------------------------------------------------
+    public function collectData()
+    {
+/*
+        $item['uri']        // URI to reach the subject ("https://...")
+        $item['title']      // Title of the item
+        $item['timestamp']  // Timestamp of the item in numeric or text format (compatible for strtotime())
+        $item['author']     // Name of the author for this item
+        $item['content']    // Content in HTML format
+        $item['enclosures'] // Array of URIs to an attachments (pictures, files, etc...)
+        $item['categories'] // Array of categories / tags / topics
+        $item['uid']        // A unique ID to identify the current item
+*/
+
+        $html = getSimpleHTMLDOM($this->getURI());
+
+        foreach ($html->find('div#bmdNewsList div#bmdNewsList-Item') as $element) {
+            $itemScope = $element->find('div[itemscope=itemscope]', 0);
+
+            $item = [];
+            $item['title'] = $this->getMetaItemPropContent($itemScope, 'headline');
+            $item['content'] = $this->getMetaItemPropContent($itemScope, 'description');
+            $item['timestamp'] = strtotime($this->getMetaItemPropContent($itemScope, 'datePublished'));
+
+            $item['author'] = $this->getMetaItemPropContent($itemScope->find('div[itemprop=author]', 0), 'name');
+            $item['enclosures'] = [self::URI . $element->find('div.mediaelement.mediaelement-image img', 0)->src];
+
+            $link = $element->find('div#bmdNewsList-Text div#bmdNewsList-Title a', 0);
+            if (!is_null($link)) {
+                $item['uri'] = self::URI . $link->href;
+            }
+
+            $categories = [];
+            $tmpOne = [];
+            $tmpTwo = [];
+
+            // search first categorie span
+            $catElem = $element->find('div#bmdNewsList-Text div#bmdNewsList-Category span.news-list-category', 0);
+            $txt = trim($catElem->innertext);
+            $tmpOne = explode('/', $txt);
+
+            // split by 2 spaces
+            foreach ($tmpOne as $tmpElem) {
+                $tmpElem = trim($tmpElem);
+                $tmpData = preg_split('/  /', $tmpElem);
+                $tmpTwo = array_merge($tmpTwo, $tmpData);
+            }
+
+            // split by tabulator
+            foreach ($tmpTwo as $tmpElem) {
+                $tmpElem = trim($tmpElem);
+                $tmpData = preg_split('/\t+/', $tmpElem);
+                $categories = array_merge($categories, $tmpData);
+            }
+
+            // trim all entries
+            $categories = array_map('trim', $categories);
+
+            // remove empty entries
+            $categories = array_filter($categories, function ($value) {
+                return !is_null($value) && $value !== '';
+            });
+
+            // set categories
+            if (count($categories) > 0) {
+                $item['categories'] = $categories;
+            }
+
+            if (($item['title'] != '') and ($item['content'] != '') and ($item['uri'] != '')) {
+                $this->items[] = $item;
+            }
+        }
+    }
+
+    //-----------------------------------------------------
+    public function detectParameters($url)
+    {
+        $parsed_url = parse_url($url);
+        if ($parsed_url['host'] != 'www.bmd.com') {
+            return null;
+        }
+
+        $path = explode('/', $parsed_url['path']);
+
+        if ($this->getURIbyCountry($path[1]) == '') {
+            return null;
+        }
+
+        $params = [];
+        $params['country'] = $path[1];
+        return $params;
+    }
+
+    //-----------------------------------------------------
+    public function getURI()
+    {
+        $lURI = $this->getURIbyCountry($this->getInput('country'));
+        return $lURI != '' ? $lURI : parent::getURI();
+    }
+
+    //-----------------------------------------------------
+    public function getIcon()
+    {
+        return 'https://www.bmd.com/favicon.ico';
+    }
+
+    //-----------------------------------------------------
+    private function getMetaItemPropContent($elem, $key)
+    {
+        if (($key != '') and (!is_null($elem))) {
+            $metaElem = $elem->find('meta[itemprop=' . $key . ']', 0);
+            if (!is_null($metaElem)) {
+                return $metaElem->getAttribute('content');
+            }
+        }
+
+        return '';
+    }
+
+    //-----------------------------------------------------
+    private function getURIbyCountry($country)
+    {
+        switch ($country) {
+            case 'at':
+                return 'https://www.bmd.com/at/ueber-bmd/blog-ohne-filter.html';
+            case 'de':
+                return 'https://www.bmd.com/de/das-ist-bmd/blog.html';
+            case 'ch':
+                return 'https://www.bmd.com/ch/das-ist-bmd/blog.html';
+            case 'sk':
+                return 'https://www.bmd.com/sk/firma/blog.html';
+            case 'cz':
+                return 'https://www.bmd.com/cz/firma/news-blog.html';
+            case 'hu':
+                return 'https://www.bmd.com/hu/rolunk/hirek.html';
+            default:
+                return '';
+        }
+    }
+}

From b6909942c857fdbb289511949550d7bfdb3440e3 Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Mon, 22 Jan 2024 13:44:28 +0100
Subject: [PATCH 271/716] [Releases3DS/Switch] Update URL (#3910)

Adjust domain name due to "www." variant having invalid TLS certificate.
---
 bridges/Releases3DSBridge.php    | 2 +-
 bridges/ReleasesSwitchBridge.php | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/Releases3DSBridge.php b/bridges/Releases3DSBridge.php
index 4fd25b00..69b259de 100644
--- a/bridges/Releases3DSBridge.php
+++ b/bridges/Releases3DSBridge.php
@@ -4,7 +4,7 @@ class Releases3DSBridge extends BridgeAbstract
 {
     const MAINTAINER = 'ORelio';
     const NAME = '3DS Scene Releases';
-    const URI = 'http://www.3dsdb.com/';
+    const URI = 'http://3dsdb.com/';
     const CACHE_TIMEOUT = 10800; // 3h
     const DESCRIPTION = 'Returns the newest scene releases for Nintendo 3DS.';
 
diff --git a/bridges/ReleasesSwitchBridge.php b/bridges/ReleasesSwitchBridge.php
index 7544278f..24d49eb5 100644
--- a/bridges/ReleasesSwitchBridge.php
+++ b/bridges/ReleasesSwitchBridge.php
@@ -8,7 +8,7 @@ if (!class_exists('Releases3DSBridge')) {
 class ReleasesSwitchBridge extends Releases3DSBridge
 {
     const NAME = 'Switch Scene Releases';
-    const URI = 'http://www.nswdb.com/';
+    const URI = 'http://nswdb.com/';
     const DESCRIPTION = 'Returns the newest scene releases for Nintendo Switch.';
 
     public function collectData()

From feb2a686d7b963e14c83dd2358e6f695ed67085b Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Tue, 23 Jan 2024 15:58:30 +0100
Subject: [PATCH 272/716] [CssSelectorBridge] Move metadata retrieval to lib
 (#3913)

May become handy for making other bridges
---
 bridges/CssSelectorBridge.php | 251 +--------------------------------
 lib/bootstrap.php             |   1 +
 lib/seotags.php               | 256 ++++++++++++++++++++++++++++++++++
 3 files changed, 258 insertions(+), 250 deletions(-)
 create mode 100644 lib/seotags.php

diff --git a/bridges/CssSelectorBridge.php b/bridges/CssSelectorBridge.php
index 5b2625a9..ac3261bf 100644
--- a/bridges/CssSelectorBridge.php
+++ b/bridges/CssSelectorBridge.php
@@ -276,7 +276,7 @@ class CssSelectorBridge extends BridgeAbstract
         }
 
         $entry_html = getSimpleHTMLDOMCached($entry_url);
-        $item = $this->entryHtmlRetrieveMetadata($entry_html);
+        $item = html_find_seo_metadata($entry_html);
 
         if (empty($item['uri'])) {
             $item['uri'] = $entry_url;
@@ -306,253 +306,4 @@ class CssSelectorBridge extends BridgeAbstract
 
         return $item;
     }
-
-    /**
-     * Retrieve metadata from entry HTML: title, author, date published, etc. from metadata intended for social media embeds and SEO
-     * @param obj $entry_html DOM object representing the webpage HTML
-     * @return array Entry data collected from Metadata
-     */
-    protected function entryHtmlRetrieveMetadata($entry_html)
-    {
-        $item = [];
-
-        // == First source of metadata: Meta tags ==
-        // Facebook Open Graph (og:KEY) - https://developers.facebook.com/docs/sharing/webmasters
-        // Twitter (twitter:KEY) - https://developer.twitter.com/en/docs/twitter-for-websites/cards/guides/getting-started
-        // Standard meta tags - https://www.w3schools.com/tags/tag_meta.asp
-        // Standard time tag - https://developer.mozilla.org/en-US/docs/Web/HTML/Element/time
-
-        // Each Entry field mapping defines a list of possible <meta> tags names that contains the expected value
-        static $meta_mappings = [
-            // <meta property="article:KEY" content="VALUE" />
-            // <meta property="og:KEY" content="VALUE" />
-            // <meta property="KEY" content="VALUE" />
-            // <meta name="twitter:KEY" content="VALUE" />
-            // <meta name="KEY" content="VALUE">
-            // <link rel="canonical" href="URL" />
-            'uri' => [
-                'og:url',
-                'twitter:url',
-                'canonical',
-            ],
-            'title' => [
-                'og:title',
-                'twitter:title',
-            ],
-            'content' => [
-                'og:description',
-                'twitter:description',
-                'description',
-            ],
-            'timestamp' => [
-                'article:published_time',
-                'og:article:published_time',
-                'releaseDate',
-                'releasedate',
-                'article:modified_time',
-                'og:article:modified_time',
-                'lastModified',
-                'lastmodified',
-                'time',
-            ],
-            'enclosures' => [
-                'og:image:secure_url',
-                'og:image:url',
-                'og:image',
-                'twitter:image',
-                'thumbnailImg',
-                'thumbnailimg',
-            ],
-            'author' => [
-                'article:author',
-                'og:article:author',
-                'author',
-                'article:author:username',
-                'profile:first_name',
-                'profile:last_name',
-                'article:author:first_name',
-                'article:author:last_name',
-                'twitter:creator',
-            ],
-        ];
-
-        $author_first_name = null;
-        $author_last_name = null;
-
-        // For each Entry property, look for corresponding HTML tags using a list of candidates
-        foreach ($meta_mappings as $property => $field_list) {
-            foreach ($field_list as $field) {
-                // Look for HTML meta tag
-                $element = null;
-                if ($field === 'canonical') {
-                    $element = $entry_html->find('link[rel=canonical]');
-                } else if ($field === 'time') {
-                    $element = $entry_html->find('time[datetime]');
-                } else {
-                    $element = $entry_html->find("meta[property=$field], meta[name=$field]");
-                }
-                // Found something? Extract the value and populate Entry field
-                if (!empty($element)) {
-                    $element = $element[0];
-                    $field_value = '';
-                    if ($field === 'canonical') {
-                        $field_value = $element->href;
-                    } else if ($field === 'time') {
-                        $field_value = $element->datetime;
-                    } else {
-                        $field_value = $element->content;
-                    }
-                    if (!empty($field_value)) {
-                        if ($field === 'article:author:first_name' || $field === 'profile:first_name') {
-                            $author_first_name = $field_value;
-                        } else if ($field === 'article:author:last_name' || $field === 'profile:last_name') {
-                            $author_last_name = $field_value;
-                        } else {
-                            $item[$property] = $field_value;
-                            break; // Stop on first match, e.g. og:url has priority over canonical url.
-                        }
-                    }
-                }
-            }
-        }
-
-        // Populate author from first name and last name if all we have is nothing or Twitter @username
-        if ((!isset($item['author']) || $item['author'][0] === '@') && (is_string($author_first_name) || is_string($author_last_name))) {
-            $author = '';
-            if (is_string($author_first_name)) {
-                $author = $author_first_name;
-            }
-            if (is_string($author_last_name)) {
-                $author = $author . ' ' . $author_last_name;
-            }
-            $item['author'] = trim($author);
-        }
-
-        // == Second source of metadata: Embedded JSON ==
-        // JSON linked data - https://www.w3.org/TR/2014/REC-json-ld-20140116/
-        // JSON linked data is COMPLEX and MAY BE LESS RELIABLE than <meta> tags. Used for fields not found as <meta> tags.
-        // The implementation below will load all ld+json we can understand and attempt to extract relevant information.
-
-        // ld+json object types that hold article metadata
-        // Each mapping define item fields and a list of possible JSON field for this field
-        // Each candiate JSON field is either a string (field name) or a list (path to nested field)
-        static $ldjson_article_types = ['webpage', 'article', 'newsarticle', 'blogposting'];
-        static $ldjson_article_mappings = [
-            'uri' => ['url', 'mainEntityOfPage'],
-            'title' => ['headline'],
-            'content' => ['description'],
-            'timestamp' => ['dateModified', 'datePublished'],
-            'enclosures' => ['image'],
-            'author' => [['author', 'name'], ['author', '@id'], 'author'],
-        ];
-
-        // ld+json object types that hold author metadata
-        $ldjson_author_types = ['person', 'organization'];
-        $ldjson_author_mappings = []; // ID => Name
-        $ldjson_author_id = null;
-
-        // Utility function for checking if JSON array matches one of the desired ld+json object types
-        // A JSON object may have a single ld+json @type as a string OR several types at once as a list
-        $ldjson_is_of_type = function ($json, $allowed_types) {
-            if (isset($json['@type'])) {
-                $json_types = $json['@type'];
-                if (!is_array($json_types)) {
-                    $json_types = [ $json_types ];
-                }
-                foreach ($json_types as $item_type) {
-                    if (in_array(strtolower($item_type), $allowed_types)) {
-                        return true;
-                    }
-                }
-            }
-            return false;
-        };
-
-        // Process ld+json objects embedded in the HTML DOM
-        foreach ($entry_html->find('script[type=application/ld+json]') as $html_ldjson_node) {
-            $json_raw = json_decode($html_ldjson_node->innertext, true);
-            if (is_array($json_raw)) {
-                // The JSON we just loaded may contain directly a single ld+json object AND/OR several ones under the '@graph' key
-                $json_items = [ $json_raw ];
-                if (isset($json_raw['@graph'])) {
-                    foreach ($json_raw['@graph'] as $json_raw_sub_item) {
-                        $json_items[] = $json_raw_sub_item;
-                    }
-                }
-                // Now that we have a list of distinct JSON items, we can process them individually
-                foreach ($json_items as $json) {
-                    // JSON item that holds an ld+json Article object (or a variant)
-                    if ($ldjson_is_of_type($json, $ldjson_article_types)) {
-                        // For each item property, look for corresponding JSON fields and populate the item
-                        foreach ($ldjson_article_mappings as $property => $field_list) {
-                            // Skip fields already found as <meta> tags, except Twitter @username (because we might find a better name)
-                            if (!isset($item[$property]) || ($property === 'author' && $item['author'][0] === '@')) {
-                                foreach ($field_list as $field) {
-                                    $json_root = $json;
-                                    // If necessary, navigate inside the JSON object to access a nested field
-                                    if (is_array($field)) {
-                                        // At this point, $field = ['author', 'name'] and $json_root = {"author": {"name": "John Doe"}}
-                                        $json_navigate_ok = true;
-                                        while (count($field) > 1) {
-                                            $sub_field = array_shift($field);
-                                            if (array_key_exists($sub_field, $json_root)) {
-                                                $json_root = $json_root[$sub_field];
-                                                if (array_is_list($json_root) && count($json_root) === 1) {
-                                                    $json_root = $json_root[0]; // Unwrap list of single item e.g. {"author":[{"name":"John Doe"}]}
-                                                }
-                                            } else {
-                                                // Desired path not found in JSON, stop navigating
-                                                $json_navigate_ok = false;
-                                                break;
-                                            }
-                                        }
-                                        if (!$json_navigate_ok) {
-                                            continue; //Desired path not found in JSON, skip this field
-                                        }
-                                        $field = $field[0];
-                                        // At this point, $field = "name" and $json_root = {"name": "John Doe"}
-                                    }
-                                    // Now we can check for desired field in JSON and populate $item accordingly
-                                    if (isset($json_root[$field])) {
-                                        $field_value = $json_root[$field];
-                                        if (is_array($field_value) && isset($field_value[0])) {
-                                            $field_value = $field_value[0]; // Different versions of the same enclosure? Take the first one
-                                        }
-                                        if (is_string($field_value) && !empty($field_value)) {
-                                            if ($property === 'author' && $field === '@id') {
-                                                $ldjson_author_id = $field_value; // Author is referred to by its ID: We'll see later if we can resolve it
-                                            } else {
-                                                $item[$property] = $field_value;
-                                                break; // Stop on first match, e.g. {"author":{"name":"John Doe"}} has priority over {"author":"John Doe"}
-                                            }
-                                        }
-                                    }
-                                }
-                            }
-                        }
-                    // JSON item that holds an ld+json Author object (or a variant)
-                    } else if ($ldjson_is_of_type($json, $ldjson_author_types)) {
-                        if (isset($json['@id']) && isset($json['name'])) {
-                            $ldjson_author_mappings[$json['@id']] = $json['name'];
-                        }
-                    }
-                }
-            }
-        }
-
-        // Attempt to resolve ld+json author if all we have is nothing or Twitter @username
-        if ((!isset($item['author']) || $item['author'][0] === '@') && !is_null($ldjson_author_id) && isset($ldjson_author_mappings[$ldjson_author_id])) {
-            $item['author'] = $ldjson_author_mappings[$ldjson_author_id];
-        }
-
-        // Adjust item field types
-        if (isset($item['enclosures'])) {
-            $item['enclosures'] = [ $item['enclosures'] ];
-        }
-        if (isset($item['timestamp'])) {
-            $item['timestamp'] = strtotime($item['timestamp']);
-        }
-
-        return $item;
-    }
 }
diff --git a/lib/bootstrap.php b/lib/bootstrap.php
index fe2069d3..9a69d756 100644
--- a/lib/bootstrap.php
+++ b/lib/bootstrap.php
@@ -26,6 +26,7 @@ $files = [
     __DIR__ . '/../lib/http.php',
     __DIR__ . '/../lib/logger.php',
     __DIR__ . '/../lib/url.php',
+    __DIR__ . '/../lib/seotags.php',
     // Vendor
     __DIR__ . '/../vendor/parsedown/Parsedown.php',
     __DIR__ . '/../vendor/php-urljoin/src/urljoin.php',
diff --git a/lib/seotags.php b/lib/seotags.php
new file mode 100644
index 00000000..52657ff9
--- /dev/null
+++ b/lib/seotags.php
@@ -0,0 +1,256 @@
+<?php
+
+/**
+ * Process HTML DOM to retrieve standard metadata intended for social media embeds and SEO.
+ * @param string|object $html Webpage HTML. Supports HTML objects or string objects.
+ * @return array Entry generated from Metadata: 'title', 'author', 'timestamp', etc.
+ */
+function html_find_seo_metadata($html)
+{
+    if (is_string($html)) {
+        $html = getSimpleHTMLDOM($html);
+    }
+
+    $item = [];
+
+    // == First source of metadata: Meta tags ==
+    // Facebook Open Graph (og:KEY) - https://developers.facebook.com/docs/sharing/webmasters
+    // Twitter (twitter:KEY) - https://developer.twitter.com/en/docs/twitter-for-websites/cards/guides/getting-started
+    // Standard meta tags - https://www.w3schools.com/tags/tag_meta.asp
+    // Standard time tag - https://developer.mozilla.org/en-US/docs/Web/HTML/Element/time
+
+    // Each Entry field mapping defines a list of possible <meta> tags names that contains the expected value
+    // There are various source candidates per type of data, listed from most reliable to least reliable
+    static $meta_mappings = [
+        // <meta property="article:KEY" content="VALUE" />
+        // <meta property="og:KEY" content="VALUE" />
+        // <meta property="KEY" content="VALUE" />
+        // <meta name="twitter:KEY" content="VALUE" />
+        // <meta name="KEY" content="VALUE">
+        // <link rel="canonical" href="URL" />
+        // <time datetime="VALUE">text</time>
+        'uri' => [
+            'og:url',
+            'twitter:url',
+            'canonical',
+        ],
+        'title' => [
+            'og:title',
+            'twitter:title',
+        ],
+        'content' => [
+            'og:description',
+            'twitter:description',
+            'description',
+        ],
+        'timestamp' => [
+            'article:published_time',
+            'og:article:published_time',
+            'releaseDate',
+            'releasedate',
+            'article:modified_time',
+            'og:article:modified_time',
+            'lastModified',
+            'lastmodified',
+            'time',
+        ],
+        'enclosures' => [
+            'og:image:secure_url',
+            'og:image:url',
+            'og:image',
+            'twitter:image',
+            'thumbnailImg',
+            'thumbnailimg',
+        ],
+        'author' => [
+            'article:author',
+            'og:article:author',
+            'author',
+            'article:author:username',
+            'profile:first_name',
+            'profile:last_name',
+            'article:author:first_name',
+            'article:author:last_name',
+            'twitter:creator',
+        ],
+    ];
+
+    $author_first_name = null;
+    $author_last_name = null;
+
+    // For each Entry property, look for corresponding HTML tags using a list of candidates
+    foreach ($meta_mappings as $property => $field_list) {
+        foreach ($field_list as $field) {
+            // Look for HTML meta tag
+            $element = null;
+            if ($field === 'canonical') {
+                $element = $html->find('link[rel=canonical]');
+            } else if ($field === 'time') {
+                $element = $html->find('time[datetime]');
+            } else {
+                $element = $html->find("meta[property=$field], meta[name=$field]");
+            }
+            // Found something? Extract the value and populate Entry field
+            if (!empty($element)) {
+                $element = $element[0];
+                $field_value = '';
+                if ($field === 'canonical') {
+                    $field_value = $element->href;
+                } else if ($field === 'time') {
+                    $field_value = $element->datetime;
+                } else {
+                    $field_value = $element->content;
+                }
+                if (!empty($field_value)) {
+                    if ($field === 'article:author:first_name' || $field === 'profile:first_name') {
+                        $author_first_name = $field_value;
+                    } else if ($field === 'article:author:last_name' || $field === 'profile:last_name') {
+                        $author_last_name = $field_value;
+                    } else {
+                        $item[$property] = $field_value;
+                        break; // Stop on first match, e.g. og:url has priority over canonical url.
+                    }
+                }
+            }
+        }
+    }
+
+    // Populate author from first name and last name if all we have is nothing or Twitter @username
+    if ((!isset($item['author']) || $item['author'][0] === '@') && (is_string($author_first_name) || is_string($author_last_name))) {
+        $author = '';
+        if (is_string($author_first_name)) {
+            $author = $author_first_name;
+        }
+        if (is_string($author_last_name)) {
+            $author = $author . ' ' . $author_last_name;
+        }
+        $item['author'] = trim($author);
+    }
+
+    // == Second source of metadata: Embedded JSON ==
+    // JSON linked data - https://www.w3.org/TR/2014/REC-json-ld-20140116/
+    // JSON linked data is COMPLEX and MAY BE LESS RELIABLE than <meta> tags. Used for fields not found as <meta> tags.
+    // The implementation below will load all ld+json we can understand and attempt to extract relevant information.
+
+    // ld+json object types that hold article metadata
+    // Each mapping define item fields and a list of possible JSON field for this field
+    // Each candiate JSON field is either a string (field name) or a list (path to nested field)
+    static $ldjson_article_types = ['webpage', 'article', 'newsarticle', 'blogposting'];
+    static $ldjson_article_mappings = [
+        'uri' => ['url', 'mainEntityOfPage'],
+        'title' => ['headline'],
+        'content' => ['description'],
+        'timestamp' => ['dateModified', 'datePublished'],
+        'enclosures' => ['image'],
+        'author' => [['author', 'name'], ['author', '@id'], 'author'],
+    ];
+
+    // ld+json object types that hold author metadata
+    $ldjson_author_types = ['person', 'organization'];
+    $ldjson_author_mappings = []; // ID => Name
+    $ldjson_author_id = null;
+
+    // Utility function for checking if JSON array matches one of the desired ld+json object types
+    // A JSON object may have a single ld+json @type as a string OR several types at once as a list
+    $ldjson_is_of_type = function ($json, $allowed_types) {
+        if (isset($json['@type'])) {
+            $json_types = $json['@type'];
+            if (!is_array($json_types)) {
+                $json_types = [ $json_types ];
+            }
+            foreach ($json_types as $item_type) {
+                if (in_array(strtolower($item_type), $allowed_types)) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    };
+
+    // Process ld+json objects embedded in the HTML DOM
+    foreach ($html->find('script[type=application/ld+json]') as $html_ldjson_node) {
+        $json_raw = json_decode($html_ldjson_node->innertext, true);
+        if (is_array($json_raw)) {
+            // The JSON we just loaded may contain directly a single ld+json object AND/OR several ones under the '@graph' key
+            $json_items = [ $json_raw ];
+            if (isset($json_raw['@graph'])) {
+                foreach ($json_raw['@graph'] as $json_raw_sub_item) {
+                    $json_items[] = $json_raw_sub_item;
+                }
+            }
+            // Now that we have a list of distinct JSON items, we can process them individually
+            foreach ($json_items as $json) {
+                // JSON item that holds an ld+json Article object (or a variant)
+                if ($ldjson_is_of_type($json, $ldjson_article_types)) {
+                    // For each item property, look for corresponding JSON fields and populate the item
+                    foreach ($ldjson_article_mappings as $property => $field_list) {
+                        // Skip fields already found as <meta> tags, except Twitter @username (because we might find a better name)
+                        if (!isset($item[$property]) || ($property === 'author' && $item['author'][0] === '@')) {
+                            foreach ($field_list as $field) {
+                                $json_root = $json;
+                                // If necessary, navigate inside the JSON object to access a nested field
+                                if (is_array($field)) {
+                                    // At this point, $field = ['author', 'name'] and $json_root = {"author": {"name": "John Doe"}}
+                                    $json_navigate_ok = true;
+                                    while (count($field) > 1) {
+                                        $sub_field = array_shift($field);
+                                        if (array_key_exists($sub_field, $json_root)) {
+                                            $json_root = $json_root[$sub_field];
+                                            if (array_is_list($json_root) && count($json_root) === 1) {
+                                                $json_root = $json_root[0]; // Unwrap list of single item e.g. {"author":[{"name":"John Doe"}]}
+                                            }
+                                        } else {
+                                            // Desired path not found in JSON, stop navigating
+                                            $json_navigate_ok = false;
+                                            break;
+                                        }
+                                    }
+                                    if (!$json_navigate_ok) {
+                                        continue; //Desired path not found in JSON, skip this field
+                                    }
+                                    $field = $field[0];
+                                    // At this point, $field = "name" and $json_root = {"name": "John Doe"}
+                                }
+                                // Now we can check for desired field in JSON and populate $item accordingly
+                                if (isset($json_root[$field])) {
+                                    $field_value = $json_root[$field];
+                                    if (is_array($field_value) && isset($field_value[0])) {
+                                        $field_value = $field_value[0]; // Different versions of the same enclosure? Take the first one
+                                    }
+                                    if (is_string($field_value) && !empty($field_value)) {
+                                        if ($property === 'author' && $field === '@id') {
+                                            $ldjson_author_id = $field_value; // Author is referred to by its ID: We'll see later if we can resolve it
+                                        } else {
+                                            $item[$property] = $field_value;
+                                            break; // Stop on first match, e.g. {"author":{"name":"John Doe"}} has priority over {"author":"John Doe"}
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    }
+                // JSON item that holds an ld+json Author object (or a variant)
+                } else if ($ldjson_is_of_type($json, $ldjson_author_types)) {
+                    if (isset($json['@id']) && isset($json['name'])) {
+                        $ldjson_author_mappings[$json['@id']] = $json['name'];
+                    }
+                }
+            }
+        }
+    }
+
+    // Attempt to resolve ld+json author if all we have is nothing or Twitter @username
+    if ((!isset($item['author']) || $item['author'][0] === '@') && !is_null($ldjson_author_id) && isset($ldjson_author_mappings[$ldjson_author_id])) {
+        $item['author'] = $ldjson_author_mappings[$ldjson_author_id];
+    }
+
+    // Adjust item field types
+    if (isset($item['enclosures'])) {
+        $item['enclosures'] = [ $item['enclosures'] ];
+    }
+    if (isset($item['timestamp'])) {
+        $item['timestamp'] = strtotime($item['timestamp']);
+    }
+
+    return $item;
+}

From 4973aaadf6716550d36606b3b31f3c3f587e5cf9 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 23 Jan 2024 21:45:22 +0100
Subject: [PATCH 273/716] fix(spotify): deprecation notice (#3914)

8192: explode(): Passing null to parameter #2 ($string) of type string is deprecated in bridges/SpotifyBridge.php line 322
---
 bridges/SpotifyBridge.php | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/bridges/SpotifyBridge.php b/bridges/SpotifyBridge.php
index c02acd25..25948011 100644
--- a/bridges/SpotifyBridge.php
+++ b/bridges/SpotifyBridge.php
@@ -317,8 +317,10 @@ class SpotifyBridge extends BridgeAbstract
 
     private function getFirstEntry()
     {
-        $uris = explode(',', $this->getInput('spotifyuri'));
-        if (!is_null($this->getInput('spotifyuri')) && strpos($this->getInput('spotifyuri'), ',') === false) {
+        $spotifyUri = $this->getInput('spotifyuri');
+
+        if (!is_null($spotifyUri) && strpos($spotifyUri, ',') === false) {
+            $uris = explode(',', $spotifyUri);
             $firstUri = $uris[0];
             $type = explode(':', $firstUri)[1];
             $spotifyId = explode(':', $firstUri)[2];

From bd58266b80d9ae26aac64312c41ef5b892ed06e6 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 23 Jan 2024 22:05:03 +0100
Subject: [PATCH 274/716] fix(OLX): deprecation notice (#3915)

---
 bridges/OLXBridge.php | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/bridges/OLXBridge.php b/bridges/OLXBridge.php
index 2fc19641..1a8be901 100644
--- a/bridges/OLXBridge.php
+++ b/bridges/OLXBridge.php
@@ -56,7 +56,13 @@ EOF;
 
     public function getName()
     {
-        $paths = explode('/', parse_url($this->getInput('url'), PHP_URL_PATH));
+        $url = $this->getInput('url');
+        if (!$url) {
+            return parent::getName();
+        }
+
+        $parsedUrl = Url::fromString($url);
+        $paths = explode('/', $parsedUrl->getPath());
 
         $query = array_reduce($paths, function ($q, $p) {
             if (preg_match('/^q-(.+)$/i', $p, $matches)) {

From 4986119f1fd8bab05f05abbcf90615d623dc8d4b Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 23 Jan 2024 22:25:43 +0100
Subject: [PATCH 275/716] fix(codeberg): semi-fix parsing of pull requests
 (#3916)

---
 bridges/CodebergBridge.php | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/bridges/CodebergBridge.php b/bridges/CodebergBridge.php
index 79dd706c..8bccd250 100644
--- a/bridges/CodebergBridge.php
+++ b/bridges/CodebergBridge.php
@@ -275,22 +275,26 @@ class CodebergBridge extends BridgeAbstract
      */
     private function extractPulls($html)
     {
-        $div = $html->find('div.issue.list', 0);
+        $div = $html->find('div#issue-list', 0);
 
-        foreach ($div->find('li.item') as $li) {
+        $var2 = $div->find('div.flex-item');
+        foreach ($var2 as $li) {
             $item = [];
 
             $number = trim($li->find('a.index,ml-0.mr-2', 0)->plaintext);
 
-            $item['title'] = $li->find('a.title', 0)->plaintext . ' (' . $number . ')';
-            $item['uri'] = $li->find('a.title', 0)->href;
+            $a = $li->find('a.issue-title', 0);
+            $item['title'] = $a->plaintext . ' (' . $number . ')';
+            $item['uri'] = $a->href;
 
             $time = $li->find('relative-time.time-since', 0);
             if ($time) {
                 $item['timestamp'] = $time->datetime;
             }
 
-            $item['author'] = $li->find('div.desc', 0)->find('a', 1)->plaintext;
+            // Extracting the author is a bit awkward after they changed their html
+            //$desc = $li->find('div.desc', 0);
+            //$item['author'] = $desc->find('a', 1)->plaintext;
 
             // Fetch pull request page
             $pullRequestPage = getSimpleHTMLDOMCached($item['uri'], 3600);

From 487c692e68bdc75adddb23d342fd77d9418688d2 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 23 Jan 2024 23:02:06 +0100
Subject: [PATCH 276/716] fix: a few deprecation notices on php 8.2 (#3917)

* fix: a few deprecation notices on php 8.2

* tweak
---
 bridges/AllegroBridge.php  | 19 ++++++++++++++++---
 bridges/EBayBridge.php     |  6 +++++-
 bridges/ErowallBridge.php  |  2 +-
 bridges/NintendoBridge.php |  8 ++++++--
 4 files changed, 28 insertions(+), 7 deletions(-)

diff --git a/bridges/AllegroBridge.php b/bridges/AllegroBridge.php
index be240857..7cad11f1 100644
--- a/bridges/AllegroBridge.php
+++ b/bridges/AllegroBridge.php
@@ -35,10 +35,23 @@ class AllegroBridge extends BridgeAbstract
 
     public function getName()
     {
-        parse_str(parse_url($this->getInput('url'), PHP_URL_QUERY), $fields);
+        $url = $this->getInput('url');
+        if (!$url) {
+            return parent::getName();
+        }
+        $parsedUrl = parse_url($url, PHP_URL_QUERY);
+        if (!$parsedUrl) {
+            return parent::getName();
+        }
+        parse_str($parsedUrl, $fields);
 
-        if ($query = array_key_exists('string', $fields) ? urldecode($fields['string']) : false) {
-            return $query;
+        if (array_key_exists('string', $fields)) {
+            $f = urldecode($fields['string']);
+        } else {
+            $f = false;
+        }
+        if ($f) {
+            return $f;
         }
 
         return parent::getName();
diff --git a/bridges/EBayBridge.php b/bridges/EBayBridge.php
index 66fad10c..507930ea 100644
--- a/bridges/EBayBridge.php
+++ b/bridges/EBayBridge.php
@@ -31,7 +31,11 @@ class EBayBridge extends BridgeAbstract
 
     public function getName()
     {
-        $urlQueries = explode('&', parse_url($this->getInput('url'), PHP_URL_QUERY));
+        $url = $this->getInput('url');
+        if (!$url) {
+            return parent::getName();
+        }
+        $urlQueries = explode('&', parse_url($url, PHP_URL_QUERY));
 
         $searchQuery = array_reduce($urlQueries, function ($q, $p) {
             if (preg_match('/^_nkw=(.+)$/i', $p, $matches)) {
diff --git a/bridges/ErowallBridge.php b/bridges/ErowallBridge.php
index bf206df9..5b3197e2 100644
--- a/bridges/ErowallBridge.php
+++ b/bridges/ErowallBridge.php
@@ -98,7 +98,7 @@ class ErowallBridge extends BridgeAbstract
                 $ret .= 'dat/';
                 break;
             default:
-                $tag = $this->getInput('tag');
+                $tag = $this->getInput('tag') ?? '';
                 $ret .= 'teg/' . str_replace(' ', '+', $tag);
         }
 
diff --git a/bridges/NintendoBridge.php b/bridges/NintendoBridge.php
index 1f463e91..1c2ef71a 100644
--- a/bridges/NintendoBridge.php
+++ b/bridges/NintendoBridge.php
@@ -365,7 +365,11 @@ class NintendoBridge extends XPathAbstract
     public function getURI()
     {
         $category = $this->getInput('category');
-        return 'all' === $category ? self::URI : $this->getSourceUrl();
+        if ('all' === $category) {
+            return self::URI;
+        } else {
+            return $this->getSourceUrl();
+        }
     }
 
     protected function provideFeedTitle(\DOMXPath $xpath)
@@ -377,7 +381,7 @@ class NintendoBridge extends XPathAbstract
 
     protected function getSourceUrl()
     {
-        $country = $this->getInput('country');
+        $country = $this->getInput('country') ?? '';
         $category = $this->getCurrentCategory();
         return str_replace(self::PARAMETERS['']['country']['defaultValue'], $country, self::FEED_SOURCE_URL[$category]);
     }

From 1262cc982ce4242b7bfcf14865d312381ddfe0bb Mon Sep 17 00:00:00 2001
From: hleskien <34342248+hleskien@users.noreply.github.com>
Date: Wed, 24 Jan 2024 19:12:38 +0100
Subject: [PATCH 277/716] added new bridges (#3920)

* added new bridges

* lint

---------

Co-authored-by: Dag <me@dvikan.no>
---
 .../BundesverbandFuerFreieKammernBridge.php   | 28 ++++++
 bridges/DeutscherAeroClubBridge.php           | 28 ++++++
 bridges/EDDHPiRepsBridge.php                  | 85 +++++++++++++++++++
 bridges/EDDHPresseschauBridge.php             | 42 +++++++++
 bridges/FliegermagazinBridge.php              | 22 +++++
 bridges/LogicMastersBridge.php                | 26 ++++++
 bridges/LuftfahrtBundesAmtBridge.php          | 41 +++++++++
 bridges/LuftsportSHBridge.php                 | 26 ++++++
 8 files changed, 298 insertions(+)
 create mode 100644 bridges/BundesverbandFuerFreieKammernBridge.php
 create mode 100644 bridges/DeutscherAeroClubBridge.php
 create mode 100644 bridges/EDDHPiRepsBridge.php
 create mode 100644 bridges/EDDHPresseschauBridge.php
 create mode 100644 bridges/FliegermagazinBridge.php
 create mode 100644 bridges/LogicMastersBridge.php
 create mode 100644 bridges/LuftfahrtBundesAmtBridge.php
 create mode 100644 bridges/LuftsportSHBridge.php

diff --git a/bridges/BundesverbandFuerFreieKammernBridge.php b/bridges/BundesverbandFuerFreieKammernBridge.php
new file mode 100644
index 00000000..147f2d47
--- /dev/null
+++ b/bridges/BundesverbandFuerFreieKammernBridge.php
@@ -0,0 +1,28 @@
+<?php
+
+class BundesverbandFuerFreieKammernBridge extends XPathAbstract
+{
+    const NAME = 'Bundesverband für freie Kammern e.V.';
+    const URI = 'https://www.bffk.de/aktuelles/aktuelle-nachrichten.html';
+    const DESCRIPTION = 'Aktuelle Nachrichten';
+    const MAINTAINER = 'hleskien';
+
+    const FEED_SOURCE_URL = 'https://www.bffk.de/aktuelles/aktuelle-nachrichten.html';
+    //const XPATH_EXPRESSION_FEED_ICON = './/link[@rel="icon"]/@href';
+    const XPATH_EXPRESSION_ITEM = '//ul[@class="article-list"]/li';
+    const XPATH_EXPRESSION_ITEM_TITLE = './/a/text()';
+    const XPATH_EXPRESSION_ITEM_CONTENT = './/a/text()';
+    const XPATH_EXPRESSION_ITEM_URI = './/a/@href';
+    //const XPATH_EXPRESSION_ITEM_AUTHOR = './/';
+    const XPATH_EXPRESSION_ITEM_TIMESTAMP = './/span/i';
+    //const XPATH_EXPRESSION_ITEM_ENCLOSURES = './';
+    //const XPATH_EXPRESSION_ITEM_CATEGORIES = './/';
+
+    protected function formatItemTimestamp($value)
+    {
+        $value = trim($value, '()');
+        $dti = DateTimeImmutable::createFromFormat('d.m.Y', $value);
+        $dti = $dti->setTime(0, 0, 0);
+        return $dti->getTimestamp();
+    }
+}
diff --git a/bridges/DeutscherAeroClubBridge.php b/bridges/DeutscherAeroClubBridge.php
new file mode 100644
index 00000000..de98798d
--- /dev/null
+++ b/bridges/DeutscherAeroClubBridge.php
@@ -0,0 +1,28 @@
+<?php
+
+class DeutscherAeroClubBridge extends XPathAbstract
+{
+    const NAME = 'Deutscher Aero Club';
+    const URI = 'https://www.daec.de/news/';
+    const DESCRIPTION = 'News aus Luftsport und Dachverband';
+    const MAINTAINER = 'hleskien';
+
+    const FEED_SOURCE_URL = 'https://www.daec.de/news/';
+    const XPATH_EXPRESSION_FEED_ICON = './/link[@rel="icon"][1]/@href';
+    const XPATH_EXPRESSION_ITEM = '//div[contains(@class, "news-list-view")]/div[contains(@class, "article")]';
+    const XPATH_EXPRESSION_ITEM_TITLE = './/span[@itemprop="headline"]';
+    const XPATH_EXPRESSION_ITEM_CONTENT = './/div[@itemprop="description"]/p';
+    const XPATH_EXPRESSION_ITEM_URI = './/div[@class="news-header"]//a/@href';
+    //const XPATH_EXPRESSION_ITEM_AUTHOR = './/';
+    const XPATH_EXPRESSION_ITEM_TIMESTAMP = './/time/@datetime';
+    const XPATH_EXPRESSION_ITEM_ENCLOSURES = './/img/@src';
+    //const XPATH_EXPRESSION_ITEM_CATEGORIES = './/';
+
+    protected function formatItemTimestamp($value)
+    {
+        $dti = DateTimeImmutable::createFromFormat('Y-m-d', $value);
+        $dti = $dti->setTime(0, 0, 0);
+        return $dti->getTimestamp();
+    }
+}
+
diff --git a/bridges/EDDHPiRepsBridge.php b/bridges/EDDHPiRepsBridge.php
new file mode 100644
index 00000000..7d5e6a0b
--- /dev/null
+++ b/bridges/EDDHPiRepsBridge.php
@@ -0,0 +1,85 @@
+<?php
+
+class EDDHPiRepsBridge extends BridgeAbstract
+{
+    const NAME = 'EDDH.de PIREPs';
+    const URI = 'https://eddh.de/info/pireps_08days.php';
+    const DESCRIPTION = 'Erfahrungen und Tipps von Piloten für Piloten: Die Einträge der letzten 8 Tage';
+    const MAINTAINER = 'hleskien';
+    //const PARAMETERS = [];
+    //const CACHE_TIMEOUT = 3600;
+
+    public function collectData()
+    {
+        $dom = getSimpleHTMLDOM(self::URI);
+        foreach ($dom->find('table table table td') as $itemnode) {
+            $texts = $this->extractTexts($itemnode->find('text, br'));
+            $timestamp = $itemnode->find('.su_dat', 0)->innertext();
+            $uri = $itemnode->find('.pir_hd a', 0)->href;
+            $this->items[] = [
+                'timestamp' => $this->formatItemTimestamp($timestamp),
+                'title' => $this->formatItemTitle($texts),
+                'uri' => $this->formatItemUri($uri),
+                'author' => $this->formatItemAuthor($texts),
+                'content' => $this->formatItemContent($texts)
+            ];
+        }
+    }
+
+    public function getIcon()
+    {
+        return 'https://eddh.de/favicon.ico';
+    }
+
+    private function extractTexts($nodes)
+    {
+        $texts = [];
+        $i = 0;
+        foreach ($nodes as $node) {
+            $text = trim($node->outertext());
+            if ($node->tag == 'br') {
+                $texts[$i++] = "\n";
+            } elseif (($node->tag == 'text') && ($text != '')) {
+                $text = iconv('Windows-1252', 'UTF-8', $text);
+                $text = str_replace('&nbsp;', '', $text);
+                $texts[$i++] = $text;
+            }
+        }
+        return $texts;
+    }
+
+    protected function formatItemAuthor($texts)
+    {
+        $pos = array_search('Name:', $texts);
+        return $texts[$pos + 1];
+    }
+
+    protected function formatItemContent($texts)
+    {
+        $pos1 = array_search('Bemerkungen:', $texts);
+        $pos2 = array_search('Bewertung:', $texts);
+        $content = '';
+        for ($i = $pos1 + 1; $i < $pos2; $i++) {
+            $content .= $texts[$i];
+        }
+        return trim($content);
+    }
+
+    protected function formatItemTitle($texts)
+    {
+        $texts[5] = ltrim($texts[5], '(');
+        return implode(' ', [$texts[1], $texts[2], $texts[3], $texts[5]]);
+    }
+
+    protected function formatItemTimestamp($value)
+    {
+        $value = str_replace('Eintrag vom', '', $value);
+        $value = trim($value);
+        return strtotime($value);
+    }
+
+    protected function formatItemUri($value)
+    {
+        return 'https://eddh.de/info/' . $value;
+    }
+}
diff --git a/bridges/EDDHPresseschauBridge.php b/bridges/EDDHPresseschauBridge.php
new file mode 100644
index 00000000..93585684
--- /dev/null
+++ b/bridges/EDDHPresseschauBridge.php
@@ -0,0 +1,42 @@
+<?php
+
+class EDDHPresseschauBridge extends XPathAbstract
+{
+    const NAME = 'EDDH.de Presseschau';
+    const URI = 'https://eddh.de/presse/presseschau.php';
+    const DESCRIPTION = 'Luftfahrt-Presseschau: Presse-Artikel aus der Luftfahrt';
+    const MAINTAINER = 'hleskien';
+
+    const FEED_SOURCE_URL = 'https://eddh.de/presse/presseschau.php';
+    //const XPATH_EXPRESSION_FEED_ICON = './/link[@rel="icon"]/@href';
+    const XPATH_EXPRESSION_ITEM = '//table//table[.//p[@class="pressnews"]]//td';
+    const XPATH_EXPRESSION_ITEM_TITLE = './h4';
+    const XPATH_EXPRESSION_ITEM_CONTENT = './p[@class="pressnews"]';
+    const XPATH_EXPRESSION_ITEM_URI = './p[@class="pressnews"]/a/@href';
+    const XPATH_EXPRESSION_ITEM_AUTHOR = './p[@class="quelle"]';
+    const XPATH_EXPRESSION_ITEM_TIMESTAMP = './p[@class="quelle"]';
+    //const XPATH_EXPRESSION_ITEM_ENCLOSURES = './';
+    //const XPATH_EXPRESSION_ITEM_CATEGORIES = './/';
+
+    public function getIcon()
+    {
+        return 'https://eddh.de/favicon.ico';
+    }
+
+    protected function formatItemAuthor($value)
+    {
+        $parts = explode('(', $value);
+        $author = trim($parts[0]);
+        return $author;
+    }
+
+    protected function formatItemTimestamp($value)
+    {
+        $parts = explode('(', $value);
+        $ws = ["\n", "\t", ' ', ')'];
+        $value = str_replace($ws, '', $parts[1]);
+        $dti = DateTimeImmutable::createFromFormat('d.m.Y', $value);
+        $dti = $dti->setTime(0, 0, 0);
+        return $dti->getTimestamp();
+    }
+}
diff --git a/bridges/FliegermagazinBridge.php b/bridges/FliegermagazinBridge.php
new file mode 100644
index 00000000..84804e99
--- /dev/null
+++ b/bridges/FliegermagazinBridge.php
@@ -0,0 +1,22 @@
+<?php
+
+class FliegermagazinBridge extends XPathAbstract
+{
+    const NAME = 'fliegermagazin';
+    const URI = 'https://www.fliegermagazin.de/news-fuer-piloten/';
+    const DESCRIPTION = 'News für Piloten';
+    const MAINTAINER = 'hleskien';
+
+    const FEED_SOURCE_URL = 'https://www.fliegermagazin.de/news-fuer-piloten/';
+    const XPATH_EXPRESSION_FEED_ICON = './/link[@rel="shortcut icon"]/@href';
+    const XPATH_EXPRESSION_ITEM = '//article[@data-type="post"]';
+    const XPATH_EXPRESSION_ITEM_TITLE = './/h3/a/text()';
+    const XPATH_EXPRESSION_ITEM_CONTENT = './/h3/a/text()';
+    const XPATH_EXPRESSION_ITEM_URI = './/h3/a/@href';
+    const XPATH_EXPRESSION_ITEM_AUTHOR = './/p[@class="author-field"]';
+    // Timestamp kann nur durch Laden des Artikels herausgefunden werden
+    //const XPATH_EXPRESSION_ITEM_TIMESTAMP = './/span/i';
+    const XPATH_EXPRESSION_ITEM_ENCLOSURES = './/img/@src';
+    //const XPATH_EXPRESSION_ITEM_CATEGORIES = './/';
+}
+
diff --git a/bridges/LogicMastersBridge.php b/bridges/LogicMastersBridge.php
new file mode 100644
index 00000000..86b5bd6d
--- /dev/null
+++ b/bridges/LogicMastersBridge.php
@@ -0,0 +1,26 @@
+<?php
+
+class LogicMastersBridge extends XPathAbstract
+{
+    const NAME = 'Logic Masters Deutschland e.V.';
+    const URI = 'https://logic-masters.de/';
+    const DESCRIPTION = 'Aktuelles';
+    const MAINTAINER = 'hleskien';
+
+    const FEED_SOURCE_URL = 'https://logic-masters.de/';
+    //const XPATH_EXPRESSION_FEED_ICON = './/link[@rel="SHORTCUT ICON"]/@href';
+    const XPATH_EXPRESSION_ITEM = '//div[@class="aktuelles_eintrag"]';
+    const XPATH_EXPRESSION_ITEM_TITLE = './div[@class="aktuelles_titel"]';
+    const XPATH_EXPRESSION_ITEM_CONTENT = './p';
+    //const XPATH_EXPRESSION_ITEM_URI = './a/@href';
+    //const XPATH_EXPRESSION_ITEM_AUTHOR = './/';
+    const XPATH_EXPRESSION_ITEM_TIMESTAMP = './div[@class="aktuelles_datum"]';
+    //const XPATH_EXPRESSION_ITEM_ENCLOSURES = './';
+    //const XPATH_EXPRESSION_ITEM_CATEGORIES = './/';
+
+    protected function formatItemTimestamp($value)
+    {
+        $formatter = new IntlDateFormatter('de', IntlDateFormatter::LONG, IntlDateFormatter::NONE);
+        return $formatter->parse($value);
+    }
+}
\ No newline at end of file
diff --git a/bridges/LuftfahrtBundesAmtBridge.php b/bridges/LuftfahrtBundesAmtBridge.php
new file mode 100644
index 00000000..2b0384a2
--- /dev/null
+++ b/bridges/LuftfahrtBundesAmtBridge.php
@@ -0,0 +1,41 @@
+<?php
+
+class LuftfahrtBundesAmtBridge extends XPathAbstract
+{
+    const NAME = 'Luftfahrt-Bundesamt';
+    const URI = 'https://www.lba.de/DE/Home/Nachrichten/nachrichten_node.html';
+    const DESCRIPTION = 'alle Nachrichten: Liste aller Meldungen';
+    const MAINTAINER = 'hleskien';
+
+    const FEED_SOURCE_URL = 'https://www.lba.de/DE/Home/Nachrichten/nachrichten_node.html';
+    const XPATH_EXPRESSION_FEED_ICON = './/link[@rel="shortcut icon"]/@href';
+    const XPATH_EXPRESSION_ITEM = '//table/tbody/tr';
+    const XPATH_EXPRESSION_ITEM_TITLE = './td[2]/a/text()';
+    const XPATH_EXPRESSION_ITEM_CONTENT = './td[2]/a/text()';
+    const XPATH_EXPRESSION_ITEM_URI = './td[2]/a/@href';
+    //const XPATH_EXPRESSION_ITEM_AUTHOR = './/';
+    const XPATH_EXPRESSION_ITEM_TIMESTAMP = './td[1]';
+    //const XPATH_EXPRESSION_ITEM_ENCLOSURES = './';
+    //const XPATH_EXPRESSION_ITEM_CATEGORIES = './/';
+
+    protected function provideFeedIcon(\DOMXPath $xpath)
+    {
+        return parent::provideFeedIcon($xpath) . '?__blob=normal&v=3';
+    }
+
+    protected function formatItemTimestamp($value)
+    {
+        $value = trim($value);
+        $dti = DateTimeImmutable::createFromFormat('d.m.Y', $value);
+        $dti = $dti->setTime(0, 0, 0);
+        return $dti->getTimestamp();
+    }
+
+    // remove jsession part
+    protected function formatItemUri($value)
+    {
+        $parts = explode(';', $value);
+        return $parts[0];
+    }
+}
+
diff --git a/bridges/LuftsportSHBridge.php b/bridges/LuftsportSHBridge.php
new file mode 100644
index 00000000..66914c61
--- /dev/null
+++ b/bridges/LuftsportSHBridge.php
@@ -0,0 +1,26 @@
+<?php
+
+class LuftsportSHBridge extends XPathAbstract
+{
+    const NAME = 'Luftsportverband Schleswig-Holstein';
+    const URI = 'https://www.luftsport-sh.de/start.html';
+    const DESCRIPTION = 'Aktuelles vom Luftsportverband Schleswig-Holstein e.V.';
+    const MAINTAINER = 'hleskien';
+
+    const FEED_SOURCE_URL = 'https://www.luftsport-sh.de/start.html';
+    const XPATH_EXPRESSION_FEED_ICON = './/link[@rel="icon" and @sizes="16x16"]/@href';
+    const XPATH_EXPRESSION_ITEM = '//div[contains(@class, "mod_newslist")]/div';
+    const XPATH_EXPRESSION_ITEM_TITLE = './/*[@itemprop="name"]/a/text()';
+    const XPATH_EXPRESSION_ITEM_CONTENT = './/div[@itemprop="description"]/p/text()';
+    const XPATH_EXPRESSION_ITEM_URI = './h3/a/@href';
+    //const XPATH_EXPRESSION_ITEM_AUTHOR = './/';
+    const XPATH_EXPRESSION_ITEM_TIMESTAMP = './/time/@datetime';
+    const XPATH_EXPRESSION_ITEM_ENCLOSURES = './/img/@src';
+    //const XPATH_EXPRESSION_ITEM_CATEGORIES = './/';
+
+    protected function formatItemTimestamp($value)
+    {
+        $dti = DateTimeImmutable::createFromFormat(DateTimeInterface::ATOM, $value);
+        return $dti->getTimestamp();
+    }
+}

From 06b299e62733ef06f98204266cd151949deaf149 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 24 Jan 2024 23:06:23 +0100
Subject: [PATCH 278/716] refactor: prepare for introduction of token based
 authentication (#3921)

---
 actions/DisplayAction.php           |   8 +-
 actions/SetBridgeCacheAction.php    |  25 +++-
 index.php                           |  44 +++++-
 lib/ApiAuthenticationMiddleware.php |  40 ------
 lib/AuthenticationMiddleware.php    |  39 -----
 lib/BridgeCard.php                  | 212 +++++++++-------------------
 lib/RssBridge.php                   |  89 +++++++-----
 lib/bootstrap.php                   |  15 --
 lib/html.php                        |   2 +-
 tests/BridgeCardTest.php            |  57 ++++++++
 10 files changed, 240 insertions(+), 291 deletions(-)
 delete mode 100644 lib/ApiAuthenticationMiddleware.php
 delete mode 100644 lib/AuthenticationMiddleware.php
 create mode 100644 tests/BridgeCardTest.php

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 080da52e..3ad8495f 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -13,13 +13,6 @@ class DisplayAction implements ActionInterface
 
     public function execute(array $request)
     {
-        if (Configuration::getConfig('system', 'enable_maintenance_mode')) {
-            return new Response(render(__DIR__ . '/../templates/error.html.php', [
-                'title'     => '503 Service Unavailable',
-                'message'   => 'RSS-Bridge is down for maintenance.',
-            ]), 503);
-        }
-
         $cacheKey = 'http_' . json_encode($request);
         /** @var Response $cachedResponse */
         $cachedResponse = $this->cache->get($cacheKey);
@@ -118,6 +111,7 @@ class DisplayAction implements ActionInterface
             }
             $feed = $bridge->getFeed();
         } catch (\Exception $e) {
+            // Probably an exception inside a bridge
             if ($e instanceof HttpException) {
                 // Reproduce (and log) these responses regardless of error output and report limit
                 if ($e->getCode() === 429) {
diff --git a/actions/SetBridgeCacheAction.php b/actions/SetBridgeCacheAction.php
index 2e9d7147..e4d245df 100644
--- a/actions/SetBridgeCacheAction.php
+++ b/actions/SetBridgeCacheAction.php
@@ -11,9 +11,30 @@ class SetBridgeCacheAction implements ActionInterface
 
     public function execute(array $request)
     {
-        $authenticationMiddleware = new ApiAuthenticationMiddleware();
-        $authenticationMiddleware($request);
+        // Authentication
+        $accessTokenInConfig = Configuration::getConfig('authentication', 'access_token');
+        if (!$accessTokenInConfig) {
+            return new Response('Access token is not set in this instance', 403, ['content-type' => 'text/plain']);
+        }
+        if (isset($request['access_token'])) {
+            $accessTokenGiven = $request['access_token'];
+        } else {
+            $header = trim($_SERVER['HTTP_AUTHORIZATION'] ?? '');
+            $position = strrpos($header, 'Bearer ');
+            if ($position !== false) {
+                $accessTokenGiven = substr($header, $position + 7);
+            } else {
+                $accessTokenGiven = '';
+            }
+        }
+        if (!$accessTokenGiven) {
+            return new Response('No access token given', 403, ['content-type' => 'text/plain']);
+        }
+        if (! hash_equals($accessTokenInConfig, $accessTokenGiven)) {
+            return new Response('Incorrect access token', 403, ['content-type' => 'text/plain']);
+        }
 
+        // Begin actual work
         $key = $request['key'] ?? null;
         if (!$key) {
             returnClientError('You must specify key!');
diff --git a/index.php b/index.php
index 126200da..029b673c 100644
--- a/index.php
+++ b/index.php
@@ -1,18 +1,22 @@
 <?php
 
+if (version_compare(\PHP_VERSION, '7.4.0') === -1) {
+    http_response_code(500);
+    print 'RSS-Bridge requires minimum PHP version 7.4';
+    exit;
+}
+
 require_once __DIR__ . '/lib/bootstrap.php';
 
-// Consider: ini_set('error_reporting', E_ALL & ~E_DEPRECATED);
-date_default_timezone_set(Configuration::getConfig('system', 'timezone'));
-
 set_exception_handler(function (\Throwable $e) {
+    $response = new Response(render(__DIR__ . '/templates/exception.html.php', ['e' => $e]), 500);
+    $response->send();
     RssBridge::getLogger()->error('Uncaught Exception', ['e' => $e]);
-    http_response_code(500);
-    exit(render(__DIR__ . '/templates/exception.html.php', ['e' => $e]));
 });
 
 set_error_handler(function ($code, $message, $file, $line) {
     if ((error_reporting() & $code) === 0) {
+        // Deprecation messages and other masked errors are typically ignored here
         return false;
     }
     // In the future, uncomment this:
@@ -39,11 +43,37 @@ register_shutdown_function(function () {
         );
         RssBridge::getLogger()->error($message);
         if (Debug::isEnabled()) {
+            // This output can interfere with json output etc
+            // This output is written at the bottom
             print sprintf("<pre>%s</pre>\n", e($message));
         }
     }
 });
 
-$rssBridge = new RssBridge();
+$errors = Configuration::checkInstallation();
+if ($errors) {
+    http_response_code(500);
+    print '<pre>' . implode("\n", $errors) . '</pre>';
+    exit;
+}
 
-$rssBridge->main($argv ?? []);
+$customConfig = [];
+if (file_exists(__DIR__ . '/config.ini.php')) {
+    $customConfig = parse_ini_file(__DIR__ . '/config.ini.php', true, INI_SCANNER_TYPED);
+}
+Configuration::loadConfiguration($customConfig, getenv());
+
+// Consider: ini_set('error_reporting', E_ALL & ~E_DEPRECATED);
+
+date_default_timezone_set(Configuration::getConfig('system', 'timezone'));
+
+try {
+    $rssBridge = new RssBridge();
+    $response = $rssBridge->main($argv ?? []);
+    $response->send();
+} catch (\Throwable $e) {
+    // Probably an exception inside an action
+    RssBridge::getLogger()->error('Exception in RssBridge::main()', ['e' => $e]);
+    http_response_code(500);
+    print render(__DIR__ . '/templates/exception.html.php', ['e' => $e]);
+}
diff --git a/lib/ApiAuthenticationMiddleware.php b/lib/ApiAuthenticationMiddleware.php
deleted file mode 100644
index 62886314..00000000
--- a/lib/ApiAuthenticationMiddleware.php
+++ /dev/null
@@ -1,40 +0,0 @@
-<?php
-
-final class ApiAuthenticationMiddleware
-{
-    public function __invoke($request): void
-    {
-        $accessTokenInConfig = Configuration::getConfig('authentication', 'access_token');
-        if (!$accessTokenInConfig) {
-            $this->exit('Access token is not set in this instance', 403);
-        }
-
-        if (isset($request['access_token'])) {
-            $accessTokenGiven = $request['access_token'];
-        } else {
-            $header = trim($_SERVER['HTTP_AUTHORIZATION'] ?? '');
-            $position = strrpos($header, 'Bearer ');
-
-            if ($position !== false) {
-                $accessTokenGiven = substr($header, $position + 7);
-            } else {
-                $accessTokenGiven = '';
-            }
-        }
-
-        if (!$accessTokenGiven) {
-            $this->exit('No access token given', 403);
-        }
-
-        if ($accessTokenGiven != $accessTokenInConfig) {
-            $this->exit('Incorrect access token', 403);
-        }
-    }
-
-    private function exit($message, $code)
-    {
-        http_response_code($code);
-        header('content-type: text/plain');
-        die($message);
-    }
-}
diff --git a/lib/AuthenticationMiddleware.php b/lib/AuthenticationMiddleware.php
deleted file mode 100644
index a91420f8..00000000
--- a/lib/AuthenticationMiddleware.php
+++ /dev/null
@@ -1,39 +0,0 @@
-<?php
-
-final class AuthenticationMiddleware
-{
-    public function __construct()
-    {
-        if (Configuration::getConfig('authentication', 'password') === '') {
-            throw new \Exception('The authentication password cannot be the empty string');
-        }
-    }
-
-    public function __invoke(): void
-    {
-        $user = $_SERVER['PHP_AUTH_USER'] ?? null;
-        $password = $_SERVER['PHP_AUTH_PW'] ?? null;
-
-        if ($user === null || $password === null) {
-            print $this->renderAuthenticationDialog();
-            exit;
-        }
-        if (
-            Configuration::getConfig('authentication', 'username') === $user
-            && Configuration::getConfig('authentication', 'password') === $password
-        ) {
-            return;
-        }
-        print $this->renderAuthenticationDialog();
-        exit;
-    }
-
-    private function renderAuthenticationDialog(): string
-    {
-        http_response_code(401);
-        header('WWW-Authenticate: Basic realm="RSS-Bridge"');
-        return render(__DIR__ . '/../templates/error.html.php', [
-            'message' => 'Please authenticate in order to access this instance!',
-        ]);
-    }
-}
diff --git a/lib/BridgeCard.php b/lib/BridgeCard.php
index a82f8e5a..8dc2472a 100644
--- a/lib/BridgeCard.php
+++ b/lib/BridgeCard.php
@@ -23,6 +23,7 @@ final class BridgeCard
         $icon = $bridge->getIcon();
         $description = $bridge->getDescription();
         $parameters = $bridge->getParameters();
+
         if (Configuration::getConfig('proxy', 'url') && Configuration::getConfig('proxy', 'by_bridge')) {
             $parameters['global']['_noproxy'] = [
                 'name' => 'Disable proxy (' . (Configuration::getConfig('proxy', 'name') ?: Configuration::getConfig('proxy', 'url')) . ')',
@@ -93,32 +94,6 @@ CARD;
         return $card;
     }
 
-    /**
-     * Get the form header for a bridge card
-     *
-     * @param class-string<BridgeAbstract> $bridgeClassName The bridge name
-     * @param bool $isHttps If disabled, adds a warning to the form
-     * @return string The form header
-     */
-    private static function getFormHeader($bridgeClassName, $isHttps = false, $parameterName = '')
-    {
-        $form = <<<EOD
-            <form method="GET" action="?">
-                <input type="hidden" name="action" value="display" />
-                <input type="hidden" name="bridge" value="{$bridgeClassName}" />
-EOD;
-
-        if (!empty($parameterName)) {
-            $form .= sprintf('<input type="hidden" name="context" value="%s" />', $parameterName);
-        }
-
-        if (!$isHttps) {
-            $form .= '<div class="secure-warning">Warning: This bridge is not fetching its content through a secure connection</div>';
-        }
-
-        return $form;
-    }
-
     /**
      * Get the form body for a bridge
      *
@@ -152,19 +127,10 @@ EOD;
                     $inputEntry['defaultValue'] = '';
                 }
 
-                $idArg = 'arg-'
-                    . urlencode($bridgeClassName)
-                    . '-'
-                    . urlencode($parameterName)
-                    . '-'
-                    . urlencode($id);
+                $idArg = 'arg-' . urlencode($bridgeClassName) . '-' . urlencode($parameterName) . '-' . urlencode($id);
 
-                $form .= '<label for="'
-                    . $idArg
-                    . '">'
-                    . filter_var($inputEntry['name'], FILTER_SANITIZE_FULL_SPECIAL_CHARS)
-                    . '</label>'
-                    . PHP_EOL;
+                $inputName = filter_var($inputEntry['name'], FILTER_SANITIZE_FULL_SPECIAL_CHARS);
+                $form .= '<label for="' . $idArg . '">' . $inputName . '</label>' . PHP_EOL;
 
                 if (!isset($inputEntry['type']) || $inputEntry['type'] === 'text') {
                     $form .= self::getTextInput($inputEntry, $idArg, $id);
@@ -206,96 +172,59 @@ EOD;
     }
 
     /**
-     * Get input field attributes
+     * Get the form header for a bridge card
      *
-     * @param array $entry The current entry
-     * @return string The input field attributes
+     * @param class-string<BridgeAbstract> $bridgeClassName The bridge name
+     * @param bool $isHttps If disabled, adds a warning to the form
+     * @return string The form header
      */
-    private static function getInputAttributes($entry)
+    private static function getFormHeader($bridgeClassName, $isHttps = false, $parameterName = '')
     {
-        $retVal = '';
+        $form = <<<EOD
+            <form method="GET" action="?">
+                <input type="hidden" name="action" value="display" />
+                <input type="hidden" name="bridge" value="{$bridgeClassName}" />
+EOD;
 
-        if (isset($entry['required']) && $entry['required'] === true) {
-            $retVal .= ' required';
+        if (!empty($parameterName)) {
+            $form .= sprintf('<input type="hidden" name="context" value="%s" />', $parameterName);
         }
 
-        if (isset($entry['pattern'])) {
-            $retVal .= ' pattern="' . $entry['pattern'] . '"';
+        if (!$isHttps) {
+            $form .= '<div class="secure-warning">Warning: This bridge is not fetching its content through a secure connection</div>';
         }
 
-        return $retVal;
+        return $form;
     }
 
-    /**
-     * Get text input
-     *
-     * @param array $entry The current entry
-     * @param string $id The field ID
-     * @param string $name The field name
-     * @return string The text input field
-     */
-    private static function getTextInput($entry, $id, $name)
+    public static function getTextInput(array $entry, string $id, string $name): string
     {
-        return '<input '
-        . self::getInputAttributes($entry)
-        . ' id="'
-        . $id
-        . '" type="text" value="'
-        . filter_var($entry['defaultValue'], FILTER_SANITIZE_FULL_SPECIAL_CHARS)
-        . '" placeholder="'
-        . filter_var($entry['exampleValue'], FILTER_SANITIZE_FULL_SPECIAL_CHARS)
-        . '" name="'
-        . $name
-        . '" />'
-        . PHP_EOL;
+        $defaultValue = filter_var($entry['defaultValue'], FILTER_SANITIZE_FULL_SPECIAL_CHARS);
+        $exampleValue = filter_var($entry['exampleValue'], FILTER_SANITIZE_FULL_SPECIAL_CHARS);
+        $attributes = self::getInputAttributes($entry);
+
+        return sprintf('<input %s id="%s" type="text" value="%s" placeholder="%s" name="%s" />' . "\n", $attributes, $id, $defaultValue, $exampleValue, $name);
     }
 
-    /**
-     * Get number input
-     *
-     * @param array $entry The current entry
-     * @param string $id The field ID
-     * @param string $name The field name
-     * @return string The number input field
-     */
-    private static function getNumberInput($entry, $id, $name)
+    public static function getNumberInput(array $entry, string $id, string $name): string
     {
-        return '<input '
-        . self::getInputAttributes($entry)
-        . ' id="'
-        . $id
-        . '" type="number" value="'
-        . filter_var($entry['defaultValue'], FILTER_SANITIZE_NUMBER_INT)
-        . '" placeholder="'
-        . filter_var($entry['exampleValue'], FILTER_SANITIZE_NUMBER_INT)
-        . '" name="'
-        . $name
-        . '" />'
-        . PHP_EOL;
+        $defaultValue = filter_var($entry['defaultValue'], FILTER_SANITIZE_NUMBER_INT);
+        $exampleValue = filter_var($entry['exampleValue'], FILTER_SANITIZE_NUMBER_INT);
+        $attributes = self::getInputAttributes($entry);
+
+        return sprintf('<input %s id="%s" type="number" value="%s" placeholder="%s" name="%s" />' . "\n", $attributes, $id, $defaultValue, $exampleValue, $name);
     }
 
-    /**
-     * Get list input
-     *
-     * @param array $entry The current entry
-     * @param string $id The field ID
-     * @param string $name The field name
-     * @return string The list input field
-     */
-    private static function getListInput($entry, $id, $name)
+    public static function getListInput(array $entry, string $id, string $name): string
     {
-        if (isset($entry['required']) && $entry['required'] === true) {
+        $required = $entry['required'] ?? null;
+        if ($required) {
             Debug::log('The "required" attribute is not supported for lists.');
             unset($entry['required']);
         }
 
-        $list = '<select '
-        . self::getInputAttributes($entry)
-        . ' id="'
-        . $id
-        . '" name="'
-        . $name
-        . '" >';
+        $attributes = self::getInputAttributes($entry);
+        $list = sprintf('<select %s id="%s" name="%s" >', $attributes, $id, $name);
 
         foreach ($entry['values'] as $name => $value) {
             if (is_array($value)) {
@@ -305,17 +234,9 @@ EOD;
                         $entry['defaultValue'] === $subname
                         || $entry['defaultValue'] === $subvalue
                     ) {
-                        $list .= '<option value="'
-                            . $subvalue
-                            . '" selected>'
-                            . $subname
-                            . '</option>';
+                        $list .= '<option value="' . $subvalue . '" selected>' . $subname . '</option>';
                     } else {
-                        $list .= '<option value="'
-                            . $subvalue
-                            . '">'
-                            . $subname
-                            . '</option>';
+                        $list .= '<option value="' . $subvalue . '">' . $subname . '</option>';
                     }
                 }
                 $list .= '</optgroup>';
@@ -324,17 +245,9 @@ EOD;
                     $entry['defaultValue'] === $name
                     || $entry['defaultValue'] === $value
                 ) {
-                    $list .= '<option value="'
-                        . $value
-                        . '" selected>'
-                        . $name
-                        . '</option>';
+                    $list .= '<option value="' . $value . '" selected>' . $name . '</option>';
                 } else {
-                    $list .= '<option value="'
-                        . $value
-                        . '">'
-                        . $name
-                        . '</option>';
+                    $list .= '<option value="' . $value . '">' . $name . '</option>';
                 }
             }
         }
@@ -344,30 +257,35 @@ EOD;
         return $list;
     }
 
-    /**
-     * Get checkbox input
-     *
-     * @param array $entry The current entry
-     * @param string $id The field ID
-     * @param string $name The field name
-     * @return string The checkbox input field
-     */
-    private static function getCheckboxInput($entry, $id, $name)
+
+    public static function getCheckboxInput(array $entry, string $id, string $name): string
     {
-        if (isset($entry['required']) && $entry['required'] === true) {
+        $required = $entry['required'] ?? null;
+        if ($required) {
             Debug::log('The "required" attribute is not supported for checkboxes.');
             unset($entry['required']);
         }
 
-        return '<input '
-        . self::getInputAttributes($entry)
-        . ' id="'
-        . $id
-        . '" type="checkbox" name="'
-        . $name
-        . '" '
-        . ($entry['defaultValue'] === 'checked' ? 'checked' : '')
-        . ' />'
-        . PHP_EOL;
+        $checked = $entry['defaultValue'] === 'checked' ? 'checked' : '';
+        $attributes = self::getInputAttributes($entry);
+
+        return sprintf('<input %s id="%s" type="checkbox" name="%s" %s />' . "\n", $attributes, $id, $name, $checked);
+    }
+
+    public static function getInputAttributes(array $entry): string
+    {
+        $result = '';
+
+        $required = $entry['required'] ?? null;
+        if ($required) {
+            $result .= ' required';
+        }
+
+        $pattern = $entry['pattern'] ?? null;
+        if ($pattern) {
+            $result .= ' pattern="' . $pattern . '"';
+        }
+
+        return $result;
     }
 }
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index d56c59b8..5938f824 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -23,48 +23,71 @@ final class RssBridge
         }
     }
 
-    public function main(array $argv = []): void
+    public function main(array $argv = []): Response
     {
         if ($argv) {
             parse_str(implode('&', array_slice($argv, 1)), $cliArgs);
             $request = $cliArgs;
         } else {
-            if (Configuration::getConfig('authentication', 'enable')) {
-                $authenticationMiddleware = new AuthenticationMiddleware();
-                $authenticationMiddleware();
-            }
             $request = array_merge($_GET, $_POST);
         }
 
-        try {
-            foreach ($request as $key => $value) {
-                if (!is_string($value)) {
-                    throw new \Exception("Query parameter \"$key\" is not a string.");
-                }
-            }
-
-            $actionName = $request['action'] ?? 'Frontpage';
-            $actionName = strtolower($actionName) . 'Action';
-            $actionName = implode(array_map('ucfirst', explode('-', $actionName)));
-
-            $filePath = __DIR__ . '/../actions/' . $actionName . '.php';
-            if (!file_exists($filePath)) {
-                throw new \Exception('Invalid action', 400);
-            }
-            $className = '\\' . $actionName;
-            $action = new $className();
-
-            $response = $action->execute($request);
-            if (is_string($response)) {
-                print $response;
-            } elseif ($response instanceof Response) {
-                $response->send();
-            }
-        } catch (\Throwable $e) {
-            self::$logger->error('Exception in RssBridge::main()', ['e' => $e]);
-            http_response_code(500);
-            print render(__DIR__ . '/../templates/exception.html.php', ['e' => $e]);
+        if (Configuration::getConfig('system', 'enable_maintenance_mode')) {
+            return new Response(render(__DIR__ . '/../templates/error.html.php', [
+                'title'     => '503 Service Unavailable',
+                'message'   => 'RSS-Bridge is down for maintenance.',
+            ]), 503);
         }
+
+        if (Configuration::getConfig('authentication', 'enable')) {
+            if (Configuration::getConfig('authentication', 'password') === '') {
+                return new Response('The authentication password cannot be the empty string', 500);
+            }
+            $user = $_SERVER['PHP_AUTH_USER'] ?? null;
+            $password = $_SERVER['PHP_AUTH_PW'] ?? null;
+            if ($user === null || $password === null) {
+                $html = render(__DIR__ . '/../templates/error.html.php', [
+                    'message' => 'Please authenticate in order to access this instance!',
+                ]);
+                return new Response($html, 401, ['WWW-Authenticate' => 'Basic realm="RSS-Bridge"']);
+            }
+            if (
+                (Configuration::getConfig('authentication', 'username') !== $user)
+                || (! hash_equals(Configuration::getConfig('authentication', 'password'), $password))
+            ) {
+                $html = render(__DIR__ . '/../templates/error.html.php', [
+                    'message' => 'Please authenticate in order to access this instance!',
+                ]);
+                return new Response($html, 401, ['WWW-Authenticate' => 'Basic realm="RSS-Bridge"']);
+            }
+            // At this point the username and password was correct
+        }
+
+        foreach ($request as $key => $value) {
+            if (!is_string($value)) {
+                return new Response(render(__DIR__ . '/../templates/error.html.php', [
+                    'message' => "Query parameter \"$key\" is not a string.",
+                ]), 400);
+            }
+        }
+
+        $actionName = $request['action'] ?? 'Frontpage';
+        $actionName = strtolower($actionName) . 'Action';
+        $actionName = implode(array_map('ucfirst', explode('-', $actionName)));
+        $filePath = __DIR__ . '/../actions/' . $actionName . '.php';
+        if (!file_exists($filePath)) {
+            return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'Invalid action']), 400);
+        }
+
+        $className = '\\' . $actionName;
+        $action = new $className();
+
+        $response = $action->execute($request);
+
+        if (is_string($response)) {
+            $response = new Response($response);
+        }
+        return $response;
     }
 
     public static function getCache(): CacheInterface
diff --git a/lib/bootstrap.php b/lib/bootstrap.php
index 9a69d756..01828f67 100644
--- a/lib/bootstrap.php
+++ b/lib/bootstrap.php
@@ -1,9 +1,5 @@
 <?php
 
-if (version_compare(\PHP_VERSION, '7.4.0') === -1) {
-    exit('RSS-Bridge requires minimum PHP version 7.4.0!');
-}
-
 // Path to the formats library
 const PATH_LIB_FORMATS = __DIR__ . '/../formats/';
 
@@ -51,14 +47,3 @@ spl_autoload_register(function ($className) {
         }
     }
 });
-
-$errors = Configuration::checkInstallation();
-if ($errors) {
-    exit('<pre>' . implode("\n", $errors) . '</pre>');
-}
-
-$customConfig = [];
-if (file_exists(__DIR__ . '/../config.ini.php')) {
-    $customConfig = parse_ini_file(__DIR__ . '/../config.ini.php', true, INI_SCANNER_TYPED);
-}
-Configuration::loadConfiguration($customConfig, getenv());
diff --git a/lib/html.php b/lib/html.php
index d65d1b20..eeaf2b32 100644
--- a/lib/html.php
+++ b/lib/html.php
@@ -36,7 +36,7 @@ function render(string $template, array $context = []): string
 /**
  * Render php template with context
  *
- * DO NOT PASS USER INPUT IN $template or $context
+ * DO NOT PASS USER INPUT IN $template OR $context (keys!)
  */
 function render_template(string $template, array $context = []): string
 {
diff --git a/tests/BridgeCardTest.php b/tests/BridgeCardTest.php
new file mode 100644
index 00000000..7a8f084d
--- /dev/null
+++ b/tests/BridgeCardTest.php
@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+namespace RssBridge\Tests;
+
+use BridgeCard;
+use PHPUnit\Framework\TestCase;
+
+class BridgeCardTest extends TestCase
+{
+    public function test()
+    {
+        $sut = new BridgeCard();
+        $this->assertSame('', BridgeCard::getInputAttributes([]));
+        $this->assertSame(' required pattern="\d+"', BridgeCard::getInputAttributes(['required' => true, 'pattern' => '\d+']));
+
+        $entry = [
+            'defaultValue' => 'checked',
+        ];
+        $this->assertSame('<input  id="id" type="checkbox" name="name" checked />' . "\n", BridgeCard::getCheckboxInput($entry, 'id', 'name'));
+
+        $entry = [
+            'defaultValue' => 42,
+            'exampleValue' => 43,
+        ];
+        $this->assertSame('<input  id="id" type="number" value="42" placeholder="43" name="name" />' . "\n", BridgeCard::getNumberInput($entry, 'id', 'name'));
+
+        $entry = [
+            'defaultValue' => 'yo1',
+            'exampleValue' => 'yo2',
+        ];
+        $this->assertSame('<input  id="id" type="text" value="yo1" placeholder="yo2" name="name" />' . "\n", BridgeCard::getTextInput($entry, 'id', 'name'));
+
+        $entry = [
+            'values' => [],
+        ];
+        $this->assertSame('<select  id="id" name="name" ></select>', BridgeCard::getListInput($entry, 'id', 'name'));
+
+        $entry = [
+            'defaultValue' => 2,
+            'values' => [
+                'foo' => 'bar',
+            ],
+        ];
+        $this->assertSame('<select  id="id" name="name" ><option value="bar">foo</option></select>', BridgeCard::getListInput($entry, 'id', 'name'));
+
+        // optgroup
+        $entry = [
+            'defaultValue' => 2,
+            'values' => ['kek' => [
+                'f' => 'b',
+            ]],
+        ];
+        $this->assertSame('<select  id="id" name="name" ><optgroup label="kek"><option value="b">f</option></optgroup></select>', BridgeCard::getListInput($entry, 'id', 'name'));
+    }
+}
\ No newline at end of file

From 9574c17ddc4c55ab191878164627c4501a565221 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 25 Jan 2024 13:03:00 +0100
Subject: [PATCH 279/716] refactor/fix (#3924)

---
 actions/DisplayAction.php        |  11 ++-
 actions/FrontpageAction.php      |   6 +-
 bridges/PresidenciaPTBridge.php  |   4 +-
 lib/BridgeAbstract.php           |  53 ++++++-----
 lib/BridgeCard.php               | 149 +++++++++++++------------------
 lib/ParameterValidator.php       |  76 +++++++---------
 static/style.css                 |  15 ----
 tests/BridgeCardTest.php         |  13 +--
 tests/ParameterValidatorTest.php |   4 +-
 9 files changed, 153 insertions(+), 178 deletions(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 3ad8495f..834f8bc4 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -98,7 +98,16 @@ class DisplayAction implements ActionInterface
         try {
             $bridge->loadConfiguration();
             // Remove parameters that don't concern bridges
-            $input = array_diff_key($request, array_fill_keys(['action', 'bridge', 'format', '_noproxy', '_cache_timeout', '_error_time'], ''));
+            $remove = [
+                'action',
+                'bridge',
+                'format',
+                '_noproxy',
+                '_cache_timeout',
+                '_error_time',
+                '_', // Some RSS readers add a cache-busting parameter (_=<timestamp>) to feed URLs, detect and ignore them.
+            ];
+            $input = array_diff_key($request, array_fill_keys($remove, ''));
             $bridge->setInput($input);
             $bridge->collectData();
             $items = $bridge->getItems();
diff --git a/actions/FrontpageAction.php b/actions/FrontpageAction.php
index ad48927d..7606018d 100644
--- a/actions/FrontpageAction.php
+++ b/actions/FrontpageAction.php
@@ -24,14 +24,14 @@ final class FrontpageAction implements ActionInterface
         $body = '';
         foreach ($bridgeClassNames as $bridgeClassName) {
             if ($bridgeFactory->isEnabled($bridgeClassName)) {
-                $body .= BridgeCard::displayBridgeCard($bridgeClassName, $formats);
+                $body .= BridgeCard::displayBridgeCard($bridgeClassName);
                 $activeBridges++;
             } elseif ($showInactive) {
-                $body .= BridgeCard::displayBridgeCard($bridgeClassName, $formats, false) . PHP_EOL;
+                $body .= BridgeCard::displayBridgeCard($bridgeClassName, false) . "\n";
             }
         }
 
-        // todo: cache this renderered template
+        // todo: cache this renderered template?
         return render(__DIR__ . '/../templates/frontpage.html.php', [
             'messages' => $messages,
             'admin_email' => Configuration::getConfig('admin', 'email'),
diff --git a/bridges/PresidenciaPTBridge.php b/bridges/PresidenciaPTBridge.php
index 8b02a481..052b2751 100644
--- a/bridges/PresidenciaPTBridge.php
+++ b/bridges/PresidenciaPTBridge.php
@@ -52,7 +52,9 @@ class PresidenciaPTBridge extends BridgeAbstract
 
     public function collectData()
     {
-        foreach (array_keys($this->getParameters()['Section']) as $k) {
+        $contexts = $this->getParameters();
+
+        foreach (array_keys($contexts['Section']) as $k) {
             Debug::log('Key: ' . var_export($k, true));
             if ($this->getInput($k)) {
                 $html = getSimpleHTMLDOMCached($this->getURI() . $k);
diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index 8001ba4f..5dc425f9 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -92,6 +92,9 @@ abstract class BridgeAbstract
         return static::MAINTAINER;
     }
 
+    /**
+     * A more correct method name would have been "getContexts"
+     */
     public function getParameters(): array
     {
         return static::PARAMETERS;
@@ -128,16 +131,17 @@ abstract class BridgeAbstract
 
     public function setInput(array $input)
     {
-        $context = $input['context'] ?? null;
-        if ($context) {
+        // This is the submitted context
+        $contextName = $input['context'] ?? null;
+        if ($contextName) {
             // Context hinting (optional)
-            $this->queriedContext = $context;
+            $this->queriedContext = $contextName;
             unset($input['context']);
         }
 
-        $parameters = $this->getParameters();
+        $contexts = $this->getParameters();
 
-        if (!$parameters) {
+        if (!$contexts) {
             if ($input) {
                 throw new \Exception('Invalid parameters value(s)');
             }
@@ -146,15 +150,16 @@ abstract class BridgeAbstract
 
         $validator = new ParameterValidator();
 
-        // $input is passed by reference!
-        if (!$validator->validateInput($input, $parameters)) {
-            $invalidParameterKeys = array_column($validator->getInvalidParameters(), 'name');
+        // $input IS PASSED BY REFERENCE!
+        $errors = $validator->validateInput($input, $contexts);
+        if ($errors !== []) {
+            $invalidParameterKeys = array_column($errors, 'name');
             throw new \Exception(sprintf('Invalid parameters value(s): %s', implode(', ', $invalidParameterKeys)));
         }
 
         // Guess the context from input data
         if (empty($this->queriedContext)) {
-            $queriedContext = $validator->getQueriedContext($input, $parameters);
+            $queriedContext = $validator->getQueriedContext($input, $contexts);
             $this->queriedContext = $queriedContext;
         }
 
@@ -179,12 +184,12 @@ abstract class BridgeAbstract
         }
 
         // Apply default values to missing data
-        $contexts = [$queriedContext];
+        $contextNames = [$queriedContext];
         if (array_key_exists('global', $this->getParameters())) {
-            $contexts[] = 'global';
+            $contextNames[] = 'global';
         }
 
-        foreach ($contexts as $context) {
+        foreach ($contextNames as $context) {
             if (!isset($this->getParameters()[$context])) {
                 // unknown context provided by client, throw exception here? or continue?
             }
@@ -240,7 +245,9 @@ abstract class BridgeAbstract
 
         // Only keep guessed context parameters values
         if (isset($this->inputs[$queriedContext])) {
-            $this->inputs = [$queriedContext => $this->inputs[$queriedContext]];
+            $this->inputs = [
+                $queriedContext => $this->inputs[$queriedContext],
+            ];
         } else {
             $this->inputs = [];
         }
@@ -263,17 +270,20 @@ abstract class BridgeAbstract
         if (!isset($this->inputs[$this->queriedContext][$input]['value'])) {
             return null;
         }
-        if (array_key_exists('global', $this->getParameters())) {
-            if (array_key_exists($input, $this->getParameters()['global'])) {
-                $context = 'global';
+
+        $contexts = $this->getParameters();
+
+        if (array_key_exists('global', $contexts)) {
+            if (array_key_exists($input, $contexts['global'])) {
+                $contextName = 'global';
             }
         }
-        if (!isset($context)) {
-            $context = $this->queriedContext;
+        if (!isset($contextName)) {
+            $contextName = $this->queriedContext;
         }
 
         $needle = $this->inputs[$this->queriedContext][$input]['value'];
-        foreach ($this->getParameters()[$context][$input]['values'] as $first_level_key => $first_level_value) {
+        foreach ($contexts[$contextName][$input]['values'] as $first_level_key => $first_level_value) {
             if (!is_array($first_level_value) && $needle === (string)$first_level_value) {
                 return $first_level_key;
             } elseif (is_array($first_level_value)) {
@@ -289,8 +299,11 @@ abstract class BridgeAbstract
     public function detectParameters($url)
     {
         $regex = '/^(https?:\/\/)?(www\.)?(.+?)(\/)?$/';
+
+        $contexts = $this->getParameters();
+
         if (
-            empty($this->getParameters())
+            empty($contexts)
             && preg_match($regex, $url, $urlMatches) > 0
             && preg_match($regex, static::URI, $bridgeUriMatches) > 0
             && $urlMatches[3] === $bridgeUriMatches[3]
diff --git a/lib/BridgeCard.php b/lib/BridgeCard.php
index 8dc2472a..6b835c15 100644
--- a/lib/BridgeCard.php
+++ b/lib/BridgeCard.php
@@ -6,33 +6,30 @@ final class BridgeCard
      * Gets a single bridge card
      *
      * @param class-string<BridgeAbstract> $bridgeClassName The bridge name
-     * @param array $formats A list of formats
      * @param bool $isActive Indicates if the bridge is active or not
      * @return string The bridge card
      */
-    public static function displayBridgeCard($bridgeClassName, $formats, $isActive = true)
+    public static function displayBridgeCard($bridgeClassName, $isActive = true)
     {
         $bridgeFactory = new BridgeFactory();
 
         $bridge = $bridgeFactory->create($bridgeClassName);
 
-        $isHttps = str_starts_with($bridge->getURI(), 'https');
-
         $uri = $bridge->getURI();
         $name = $bridge->getName();
         $icon = $bridge->getIcon();
         $description = $bridge->getDescription();
-        $parameters = $bridge->getParameters();
+        $contexts = $bridge->getParameters();
 
         if (Configuration::getConfig('proxy', 'url') && Configuration::getConfig('proxy', 'by_bridge')) {
-            $parameters['global']['_noproxy'] = [
+            $contexts['global']['_noproxy'] = [
                 'name' => 'Disable proxy (' . (Configuration::getConfig('proxy', 'name') ?: Configuration::getConfig('proxy', 'url')) . ')',
                 'type' => 'checkbox'
             ];
         }
 
         if (Configuration::getConfig('cache', 'custom_timeout')) {
-            $parameters['global']['_cache_timeout'] = [
+            $contexts['global']['_cache_timeout'] = [
                 'name' => 'Cache timeout in seconds',
                 'type' => 'number',
                 'defaultValue' => $bridge->getCacheTimeout()
@@ -41,45 +38,51 @@ final class BridgeCard
 
         $shortName = $bridge->getShortName();
         $card = <<<CARD
-                <section
-                    class="bridge-card"
-                    id="bridge-{$bridgeClassName}"
-                    data-ref="{$name}"
-                    data-short-name="$shortName"
-                >
+            <section
+                class="bridge-card"
+                id="bridge-{$bridgeClassName}"
+                data-ref="{$name}"
+                data-short-name="$shortName"
+            >
 
-                <h2><a href="{$uri}">{$name}</a></h2>
-                <p class="description">{$description}</p>
-                <input type="checkbox" class="showmore-box" id="showmore-{$bridgeClassName}" />
-                <label class="showmore" for="showmore-{$bridgeClassName}">Show more</label>
-CARD;
+            <h2><a href="{$uri}">{$name}</a></h2>
+            <p class="description">{$description}</p>
+            <input type="checkbox" class="showmore-box" id="showmore-{$bridgeClassName}" />
+            <label class="showmore" for="showmore-{$bridgeClassName}">Show more</label>
+
+
+        CARD;
 
         // If we don't have any parameter for the bridge, we print a generic form to load it.
-        if (count($parameters) === 0) {
-            $card .= self::getForm($bridgeClassName, $formats, $isActive, $isHttps);
-
-            // Display form with cache timeout and/or noproxy options (if enabled) when bridge has no parameters
-        } elseif (count($parameters) === 1 && array_key_exists('global', $parameters)) {
-            $card .= self::getForm($bridgeClassName, $formats, $isActive, $isHttps, '', $parameters['global']);
+        if (count($contexts) === 0) {
+            // The bridge has zero parameters
+            $card .= self::getForm($bridgeClassName, $isActive);
+        } elseif (count($contexts) === 1 && array_key_exists('global', $contexts)) {
+            // The bridge has a single context with key 'global'
+            $card .= self::getForm($bridgeClassName, $isActive, '', $contexts['global']);
         } else {
-            foreach ($parameters as $parameterName => $parameter) {
-                if (!is_numeric($parameterName) && $parameterName === 'global') {
+            // The bridge has one or more contexts (named or unnamed)
+            foreach ($contexts as $contextName => $contextParameters) {
+                if ($contextName === 'global') {
                     continue;
                 }
 
-                if (array_key_exists('global', $parameters)) {
-                    $parameter = array_merge($parameter, $parameters['global']);
+                if (array_key_exists('global', $contexts)) {
+                    // Merge the global parameters into current context
+                    $contextParameters = array_merge($contextParameters, $contexts['global']);
                 }
 
-                if (!is_numeric($parameterName)) {
-                    $card .= '<h5>' . $parameterName . '</h5>' . PHP_EOL;
+                if (!is_numeric($contextName)) {
+                    // This is a named context
+                    $card .= '<h5>' . $contextName . '</h5>' . PHP_EOL;
                 }
 
-                $card .= self::getForm($bridgeClassName, $formats, $isActive, $isHttps, $parameterName, $parameter);
+                $card .= self::getForm($bridgeClassName, $isActive, $contextName, $contextParameters);
             }
         }
 
         $card .= sprintf('<label class="showless" for="showmore-%s">Show less</label>', $bridgeClassName);
+
         if ($bridge->getDonationURI() !== '' && Configuration::getConfig('admin', 'donations')) {
             $card .= sprintf(
                 '<p class="maintainer">%s ~ <a href="%s">Donate</a></p>',
@@ -94,31 +97,27 @@ CARD;
         return $card;
     }
 
-    /**
-     * Get the form body for a bridge
-     *
-     * @param class-string<BridgeAbstract> $bridgeClassName The bridge name
-     * @param array $formats A list of supported formats
-     * @param bool $isActive Indicates if a bridge is enabled or not
-     * @param bool $isHttps Indicates if a bridge uses HTTPS or not
-     * @param string $parameterName Sets the bridge context for the current form
-     * @param array $parameters The bridge parameters
-     * @return string The form body
-     */
     private static function getForm(
-        $bridgeClassName,
-        $formats,
-        $isActive = false,
-        $isHttps = false,
-        $parameterName = '',
-        $parameters = []
+        string $bridgeClassName,
+        bool $isActive = false,
+        string $contextName = '',
+        array $contextParameters = []
     ) {
-        $form = self::getFormHeader($bridgeClassName, $isHttps, $parameterName);
+        $form = <<<EOD
+        <form method="GET" action="?">
+            <input type="hidden" name="action" value="display" />
+            <input type="hidden" name="bridge" value="{$bridgeClassName}" />
 
-        if (count($parameters) > 0) {
+        EOD;
+
+        if (!empty($contextName)) {
+            $form .= sprintf('<input type="hidden" name="context" value="%s" />', $contextName);
+        }
+
+        if (count($contextParameters) > 0) {
             $form .= '<div class="parameters">';
 
-            foreach ($parameters as $id => $inputEntry) {
+            foreach ($contextParameters as $id => $inputEntry) {
                 if (!isset($inputEntry['exampleValue'])) {
                     $inputEntry['exampleValue'] = '';
                 }
@@ -127,19 +126,25 @@ CARD;
                     $inputEntry['defaultValue'] = '';
                 }
 
-                $idArg = 'arg-' . urlencode($bridgeClassName) . '-' . urlencode($parameterName) . '-' . urlencode($id);
+                $idArg = 'arg-' . urlencode($bridgeClassName) . '-' . urlencode($contextName) . '-' . urlencode($id);
 
                 $inputName = filter_var($inputEntry['name'], FILTER_SANITIZE_FULL_SPECIAL_CHARS);
                 $form .= '<label for="' . $idArg . '">' . $inputName . '</label>' . PHP_EOL;
 
-                if (!isset($inputEntry['type']) || $inputEntry['type'] === 'text') {
-                    $form .= self::getTextInput($inputEntry, $idArg, $id);
+                if (
+                    !isset($inputEntry['type'])
+                    || $inputEntry['type'] === 'text'
+                ) {
+                    $form .= self::getTextInput($inputEntry, $idArg, $id) . "\n";
                 } elseif ($inputEntry['type'] === 'number') {
                     $form .= self::getNumberInput($inputEntry, $idArg, $id);
                 } elseif ($inputEntry['type'] === 'list') {
-                    $form .= self::getListInput($inputEntry, $idArg, $id);
+                    $form .= self::getListInput($inputEntry, $idArg, $id) . "\n";
                 } elseif ($inputEntry['type'] === 'checkbox') {
                     $form .= self::getCheckboxInput($inputEntry, $idArg, $id);
+                } else {
+                    $foo = 2;
+                    // oops?
                 }
 
                 $infoText = [];
@@ -171,39 +176,13 @@ CARD;
         return $form . '</form>' . PHP_EOL;
     }
 
-    /**
-     * Get the form header for a bridge card
-     *
-     * @param class-string<BridgeAbstract> $bridgeClassName The bridge name
-     * @param bool $isHttps If disabled, adds a warning to the form
-     * @return string The form header
-     */
-    private static function getFormHeader($bridgeClassName, $isHttps = false, $parameterName = '')
-    {
-        $form = <<<EOD
-            <form method="GET" action="?">
-                <input type="hidden" name="action" value="display" />
-                <input type="hidden" name="bridge" value="{$bridgeClassName}" />
-EOD;
-
-        if (!empty($parameterName)) {
-            $form .= sprintf('<input type="hidden" name="context" value="%s" />', $parameterName);
-        }
-
-        if (!$isHttps) {
-            $form .= '<div class="secure-warning">Warning: This bridge is not fetching its content through a secure connection</div>';
-        }
-
-        return $form;
-    }
-
     public static function getTextInput(array $entry, string $id, string $name): string
     {
         $defaultValue = filter_var($entry['defaultValue'], FILTER_SANITIZE_FULL_SPECIAL_CHARS);
         $exampleValue = filter_var($entry['exampleValue'], FILTER_SANITIZE_FULL_SPECIAL_CHARS);
         $attributes = self::getInputAttributes($entry);
 
-        return sprintf('<input %s id="%s" type="text" value="%s" placeholder="%s" name="%s" />' . "\n", $attributes, $id, $defaultValue, $exampleValue, $name);
+        return sprintf('<input %s id="%s" type="text" value="%s" placeholder="%s" name="%s" />', $attributes, $id, $defaultValue, $exampleValue, $name);
     }
 
     public static function getNumberInput(array $entry, string $id, string $name): string
@@ -224,7 +203,7 @@ EOD;
         }
 
         $attributes = self::getInputAttributes($entry);
-        $list = sprintf('<select %s id="%s" name="%s" >', $attributes, $id, $name);
+        $list = sprintf('<select %s id="%s" name="%s" >' . "\n", $attributes, $id, $name);
 
         foreach ($entry['values'] as $name => $value) {
             if (is_array($value)) {
@@ -245,9 +224,9 @@ EOD;
                     $entry['defaultValue'] === $name
                     || $entry['defaultValue'] === $value
                 ) {
-                    $list .= '<option value="' . $value . '" selected>' . $name . '</option>';
+                    $list .= '<option value="' . $value . '" selected>' . $name . '</option>' . "\n";
                 } else {
-                    $list .= '<option value="' . $value . '">' . $name . '</option>';
+                    $list .= '<option value="' . $value . '">' . $name . '</option>' . "\n";
                 }
             }
         }
diff --git a/lib/ParameterValidator.php b/lib/ParameterValidator.php
index e8de754c..e2783586 100644
--- a/lib/ParameterValidator.php
+++ b/lib/ParameterValidator.php
@@ -2,37 +2,26 @@
 
 class ParameterValidator
 {
-    private array $invalid = [];
-
     /**
-     * Check that inputs are actually present in the bridge parameters.
-     *
-     * Also check whether input values are allowed.
+     * Validate and sanitize user inputs against configured bridge parameters (contexts)
      */
-    public function validateInput(&$input, $parameters): bool
+    public function validateInput(array &$input, $contexts): array
     {
-        if (!is_array($input)) {
-            return false;
-        }
+        $errors = [];
 
         foreach ($input as $name => $value) {
-            // Some RSS readers add a cache-busting parameter (_=<timestamp>) to feed URLs, detect and ignore them.
-            if ($name === '_') {
-                continue;
-            }
-
             $registered = false;
-            foreach ($parameters as $context => $set) {
-                if (!array_key_exists($name, $set)) {
+            foreach ($contexts as $contextName => $contextParameters) {
+                if (!array_key_exists($name, $contextParameters)) {
                     continue;
                 }
                 $registered = true;
-                if (!isset($set[$name]['type'])) {
+                if (!isset($contextParameters[$name]['type'])) {
                     // Default type is text
-                    $set[$name]['type'] = 'text';
+                    $contextParameters[$name]['type'] = 'text';
                 }
 
-                switch ($set[$name]['type']) {
+                switch ($contextParameters[$name]['type']) {
                     case 'number':
                         $input[$name] = $this->validateNumberValue($value);
                         break;
@@ -40,12 +29,12 @@ class ParameterValidator
                         $input[$name] = $this->validateCheckboxValue($value);
                         break;
                     case 'list':
-                        $input[$name] = $this->validateListValue($value, $set[$name]['values']);
+                        $input[$name] = $this->validateListValue($value, $contextParameters[$name]['values']);
                         break;
                     default:
                     case 'text':
-                        if (isset($set[$name]['pattern'])) {
-                            $input[$name] = $this->validateTextValue($value, $set[$name]['pattern']);
+                        if (isset($contextParameters[$name]['pattern'])) {
+                            $input[$name] = $this->validateTextValue($value, $contextParameters[$name]['pattern']);
                         } else {
                             $input[$name] = $this->validateTextValue($value);
                         }
@@ -54,56 +43,56 @@ class ParameterValidator
 
                 if (
                     is_null($input[$name])
-                    && isset($set[$name]['required'])
-                    && $set[$name]['required']
+                    && isset($contextParameters[$name]['required'])
+                    && $contextParameters[$name]['required']
                 ) {
-                    $this->invalid[] = ['name' => $name, 'reason' => 'Parameter is invalid!'];
+                    $errors[] = ['name' => $name, 'reason' => 'Parameter is invalid!'];
                 }
             }
 
             if (!$registered) {
-                $this->invalid[] = ['name' => $name, 'reason' => 'Parameter is not registered!'];
+                $errors[] = ['name' => $name, 'reason' => 'Parameter is not registered!'];
             }
         }
 
-        return $this->invalid === [];
+        return $errors;
     }
 
     /**
      * Get the name of the context matching the provided inputs
      *
      * @param array $input Associative array of user data
-     * @param array $parameters Array of bridge parameters
+     * @param array $contexts Array of bridge parameters
      * @return string|null Returns the context name or null if no match was found
      */
-    public function getQueriedContext($input, $parameters)
+    public function getQueriedContext(array $input, array $contexts)
     {
         $queriedContexts = [];
 
         // Detect matching context
-        foreach ($parameters as $context => $set) {
-            $queriedContexts[$context] = null;
+        foreach ($contexts as $contextName => $contextParameters) {
+            $queriedContexts[$contextName] = null;
 
             // Ensure all user data exist in the current context
-            $notInContext = array_diff_key($input, $set);
-            if (array_key_exists('global', $parameters)) {
-                $notInContext = array_diff_key($notInContext, $parameters['global']);
+            $notInContext = array_diff_key($input, $contextParameters);
+            if (array_key_exists('global', $contexts)) {
+                $notInContext = array_diff_key($notInContext, $contexts['global']);
             }
             if (count($notInContext) > 0) {
                 continue;
             }
 
             // Check if all parameters of the context are satisfied
-            foreach ($set as $id => $properties) {
-                if (isset($input[$id]) && !empty($input[$id])) {
-                    $queriedContexts[$context] = true;
+            foreach ($contextParameters as $id => $properties) {
+                if (!empty($input[$id])) {
+                    $queriedContexts[$contextName] = true;
                 } elseif (
                     isset($properties['type'])
                     && ($properties['type'] === 'checkbox' || $properties['type'] === 'list')
                 ) {
                     continue;
                 } elseif (isset($properties['required']) && $properties['required'] === true) {
-                    $queriedContexts[$context] = false;
+                    $queriedContexts[$contextName] = false;
                     break;
                 }
             }
@@ -111,7 +100,7 @@ class ParameterValidator
 
         // Abort if one of the globally required parameters is not satisfied
         if (
-            array_key_exists('global', $parameters)
+            array_key_exists('global', $contexts)
             && $queriedContexts['global'] === false
         ) {
             return null;
@@ -124,9 +113,9 @@ class ParameterValidator
                 if (isset($input['context'])) {
                     return $input['context'];
                 }
-                foreach ($queriedContexts as $context => $queried) {
+                foreach ($queriedContexts as $context2 => $queried) {
                     if (is_null($queried)) {
-                        return $context;
+                        return $context2;
                     }
                 }
                 return null;
@@ -138,11 +127,6 @@ class ParameterValidator
         }
     }
 
-    public function getInvalidParameters(): array
-    {
-        return $this->invalid;
-    }
-
     private function validateTextValue($value, $pattern = null)
     {
         if (is_null($pattern)) {
diff --git a/static/style.css b/static/style.css
index b835c98d..cfaf66a1 100644
--- a/static/style.css
+++ b/static/style.css
@@ -281,16 +281,6 @@ p.maintainer {
     text-align: right;
 }
 
-.secure-warning {
-    background-color: #ffc600;
-    color: #5f5f5f;
-    box-shadow: 0px 1px 2px rgba(0, 0, 0, 0.3);
-    border-radius: 2px;
-    border: 1px solid transparent;
-    width: 80%;
-    margin: auto auto 6px;
-}
-
 .error strong {
     display: inline-block;
     width: 100px;
@@ -395,11 +385,6 @@ button {
         }
 
     } /* @supports (display: grid) */
-
-    .secure-warning {
-        width: 100%;
-    }
-
 }
 
 /* Dark theme */
diff --git a/tests/BridgeCardTest.php b/tests/BridgeCardTest.php
index 7a8f084d..519ac7f1 100644
--- a/tests/BridgeCardTest.php
+++ b/tests/BridgeCardTest.php
@@ -30,12 +30,12 @@ class BridgeCardTest extends TestCase
             'defaultValue' => 'yo1',
             'exampleValue' => 'yo2',
         ];
-        $this->assertSame('<input  id="id" type="text" value="yo1" placeholder="yo2" name="name" />' . "\n", BridgeCard::getTextInput($entry, 'id', 'name'));
+        $this->assertSame('<input  id="id" type="text" value="yo1" placeholder="yo2" name="name" />', BridgeCard::getTextInput($entry, 'id', 'name'));
 
         $entry = [
             'values' => [],
         ];
-        $this->assertSame('<select  id="id" name="name" ></select>', BridgeCard::getListInput($entry, 'id', 'name'));
+        $this->assertSame('<select  id="id" name="name" >' . "\n" . '</select>', BridgeCard::getListInput($entry, 'id', 'name'));
 
         $entry = [
             'defaultValue' => 2,
@@ -43,7 +43,7 @@ class BridgeCardTest extends TestCase
                 'foo' => 'bar',
             ],
         ];
-        $this->assertSame('<select  id="id" name="name" ><option value="bar">foo</option></select>', BridgeCard::getListInput($entry, 'id', 'name'));
+        $this->assertSame('<select  id="id" name="name" >' . "\n" . '<option value="bar">foo</option>' . "\n" . '</select>', BridgeCard::getListInput($entry, 'id', 'name'));
 
         // optgroup
         $entry = [
@@ -52,6 +52,9 @@ class BridgeCardTest extends TestCase
                 'f' => 'b',
             ]],
         ];
-        $this->assertSame('<select  id="id" name="name" ><optgroup label="kek"><option value="b">f</option></optgroup></select>', BridgeCard::getListInput($entry, 'id', 'name'));
+        $this->assertSame(
+            '<select  id="id" name="name" >' . "\n" . '<optgroup label="kek"><option value="b">f</option></optgroup></select>',
+            BridgeCard::getListInput($entry, 'id', 'name')
+        );
     }
-}
\ No newline at end of file
+}
diff --git a/tests/ParameterValidatorTest.php b/tests/ParameterValidatorTest.php
index 1b241c2c..59d7b2b9 100644
--- a/tests/ParameterValidatorTest.php
+++ b/tests/ParameterValidatorTest.php
@@ -20,7 +20,7 @@ class ParameterValidatorTest extends TestCase
                 ],
             ]
         ];
-        $this->assertTrue($sut->validateInput($input, $parameters));
+        $this->assertSame([], $sut->validateInput($input, $parameters));
     }
 
     public function test2()
@@ -35,6 +35,6 @@ class ParameterValidatorTest extends TestCase
                 ],
             ]
         ];
-        $this->assertFalse($sut->validateInput($input, $parameters));
+        $this->assertNotEmpty($sut->validateInput($input, $parameters));
     }
 }

From d08d13f2c87b24fadb92e31c50dedc6e56c3c088 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 25 Jan 2024 16:06:24 +0100
Subject: [PATCH 280/716] refactor: introduce http Request object (#3926)

---
 actions/ConnectivityAction.php             |  4 +--
 actions/DetectAction.php                   |  6 ++--
 actions/DisplayAction.php                  | 20 ++++++-----
 actions/FindfeedAction.php                 |  6 ++--
 actions/FrontpageAction.php                | 12 +++----
 actions/HealthAction.php                   |  2 +-
 actions/ListAction.php                     |  2 +-
 actions/SetBridgeCacheAction.php           | 23 +++++++------
 bridges/StreamCzBridge.php                 |  2 +-
 formats/HtmlFormat.php                     | 13 +++----
 lib/ActionInterface.php                    |  2 +-
 lib/BridgeCard.php                         | 12 +++----
 lib/FeedExpander.php                       |  1 +
 lib/FormatFactory.php                      | 26 +++++---------
 lib/RssBridge.php                          | 32 ++++++++---------
 lib/bootstrap.php                          |  6 ----
 lib/http.php                               | 40 ++++++++++++++++++++++
 static/connectivity.js                     |  8 ++---
 tests/Formats/FormatImplementationTest.php |  2 +-
 19 files changed, 125 insertions(+), 94 deletions(-)

diff --git a/actions/ConnectivityAction.php b/actions/ConnectivityAction.php
index 1568333a..09d9c6c6 100644
--- a/actions/ConnectivityAction.php
+++ b/actions/ConnectivityAction.php
@@ -19,13 +19,13 @@ class ConnectivityAction implements ActionInterface
         $this->bridgeFactory = new BridgeFactory();
     }
 
-    public function execute(array $request)
+    public function execute(Request $request)
     {
         if (!Debug::isEnabled()) {
             return new Response('This action is only available in debug mode!', 403);
         }
 
-        $bridgeName = $request['bridge'] ?? null;
+        $bridgeName = $request->get('bridge');
         if (!$bridgeName) {
             return render_template('connectivity.html.php');
         }
diff --git a/actions/DetectAction.php b/actions/DetectAction.php
index bbacde38..99d299bb 100644
--- a/actions/DetectAction.php
+++ b/actions/DetectAction.php
@@ -2,10 +2,10 @@
 
 class DetectAction implements ActionInterface
 {
-    public function execute(array $request)
+    public function execute(Request $request)
     {
-        $targetURL = $request['url'] ?? null;
-        $format = $request['format'] ?? null;
+        $targetURL = $request->get('url');
+        $format = $request->get('format');
 
         if (!$targetURL) {
             throw new \Exception('You must specify a url!');
diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 834f8bc4..915eace5 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -11,9 +11,13 @@ class DisplayAction implements ActionInterface
         $this->logger = RssBridge::getLogger();
     }
 
-    public function execute(array $request)
+    public function execute(Request $request)
     {
-        $cacheKey = 'http_' . json_encode($request);
+        $bridgeName = $request->get('bridge');
+        $format = $request->get('format');
+        $noproxy = $request->get('_noproxy');
+
+        $cacheKey = 'http_' . json_encode($request->toArray());
         /** @var Response $cachedResponse */
         $cachedResponse = $this->cache->get($cacheKey);
         if ($cachedResponse) {
@@ -31,7 +35,6 @@ class DisplayAction implements ActionInterface
             return $cachedResponse;
         }
 
-        $bridgeName = $request['bridge'] ?? null;
         if (!$bridgeName) {
             return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'Missing bridge parameter']), 400);
         }
@@ -40,7 +43,7 @@ class DisplayAction implements ActionInterface
         if (!$bridgeClassName) {
             return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'Bridge not found']), 404);
         }
-        $format = $request['format'] ?? null;
+
         if (!$format) {
             return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'You must specify a format']), 400);
         }
@@ -48,7 +51,7 @@ class DisplayAction implements ActionInterface
             return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'This bridge is not whitelisted']), 400);
         }
 
-        $noproxy = $request['_noproxy'] ?? null;
+
         if (
             Configuration::getConfig('proxy', 'url')
             && Configuration::getConfig('proxy', 'by_bridge')
@@ -65,7 +68,7 @@ class DisplayAction implements ActionInterface
         $response = $this->createResponse($request, $bridge, $format);
 
         if ($response->getCode() === 200) {
-            $ttl = $request['_cache_timeout'] ?? null;
+            $ttl = $request->get('_cache_timeout');
             if (Configuration::getConfig('cache', 'custom_timeout') && $ttl) {
                 $ttl = (int) $ttl;
             } else {
@@ -90,7 +93,7 @@ class DisplayAction implements ActionInterface
         return $response;
     }
 
-    private function createResponse(array $request, BridgeAbstract $bridge, FormatAbstract $format)
+    private function createResponse(Request $request, BridgeAbstract $bridge, FormatAbstract $format)
     {
         $items = [];
         $feed = [];
@@ -107,7 +110,8 @@ class DisplayAction implements ActionInterface
                 '_error_time',
                 '_', // Some RSS readers add a cache-busting parameter (_=<timestamp>) to feed URLs, detect and ignore them.
             ];
-            $input = array_diff_key($request, array_fill_keys($remove, ''));
+            $requestArray = $request->toArray();
+            $input = array_diff_key($requestArray, array_fill_keys($remove, ''));
             $bridge->setInput($input);
             $bridge->collectData();
             $items = $bridge->getItems();
diff --git a/actions/FindfeedAction.php b/actions/FindfeedAction.php
index fe5ceef9..cd0a0c74 100644
--- a/actions/FindfeedAction.php
+++ b/actions/FindfeedAction.php
@@ -7,10 +7,10 @@
  */
 class FindfeedAction implements ActionInterface
 {
-    public function execute(array $request)
+    public function execute(Request $request)
     {
-        $targetURL = $request['url'] ?? null;
-        $format = $request['format'] ?? null;
+        $targetURL = $request->get('url');
+        $format = $request->get('format');
 
         if (!$targetURL) {
             return new Response('You must specify a url', 400);
diff --git a/actions/FrontpageAction.php b/actions/FrontpageAction.php
index 7606018d..c0f819d0 100644
--- a/actions/FrontpageAction.php
+++ b/actions/FrontpageAction.php
@@ -2,10 +2,11 @@
 
 final class FrontpageAction implements ActionInterface
 {
-    public function execute(array $request)
+    public function execute(Request $request)
     {
+        $showInactive = (bool) $request->get('show_inactive');
+
         $messages = [];
-        $showInactive = (bool) ($request['show_inactive'] ?? null);
         $activeBridges = 0;
 
         $bridgeFactory = new BridgeFactory();
@@ -18,16 +19,13 @@ final class FrontpageAction implements ActionInterface
             ];
         }
 
-        $formatFactory = new FormatFactory();
-        $formats = $formatFactory->getFormatNames();
-
         $body = '';
         foreach ($bridgeClassNames as $bridgeClassName) {
             if ($bridgeFactory->isEnabled($bridgeClassName)) {
-                $body .= BridgeCard::displayBridgeCard($bridgeClassName);
+                $body .= BridgeCard::render($bridgeClassName);
                 $activeBridges++;
             } elseif ($showInactive) {
-                $body .= BridgeCard::displayBridgeCard($bridgeClassName, false) . "\n";
+                $body .= BridgeCard::render($bridgeClassName, false) . "\n";
             }
         }
 
diff --git a/actions/HealthAction.php b/actions/HealthAction.php
index 8ae5df1b..a38879c2 100644
--- a/actions/HealthAction.php
+++ b/actions/HealthAction.php
@@ -4,7 +4,7 @@ declare(strict_types=1);
 
 class HealthAction implements ActionInterface
 {
-    public function execute(array $request)
+    public function execute(Request $request)
     {
         $response = [
             'code' => 200,
diff --git a/actions/ListAction.php b/actions/ListAction.php
index 19bb4d37..3d9cdd73 100644
--- a/actions/ListAction.php
+++ b/actions/ListAction.php
@@ -2,7 +2,7 @@
 
 class ListAction implements ActionInterface
 {
-    public function execute(array $request)
+    public function execute(Request $request)
     {
         $list = new \stdClass();
         $list->bridges = [];
diff --git a/actions/SetBridgeCacheAction.php b/actions/SetBridgeCacheAction.php
index e4d245df..5b1c6f53 100644
--- a/actions/SetBridgeCacheAction.php
+++ b/actions/SetBridgeCacheAction.php
@@ -9,15 +9,17 @@ class SetBridgeCacheAction implements ActionInterface
         $this->cache = RssBridge::getCache();
     }
 
-    public function execute(array $request)
+    public function execute(Request $request)
     {
+        $requestArray = $request->toArray();
+
         // Authentication
         $accessTokenInConfig = Configuration::getConfig('authentication', 'access_token');
         if (!$accessTokenInConfig) {
             return new Response('Access token is not set in this instance', 403, ['content-type' => 'text/plain']);
         }
-        if (isset($request['access_token'])) {
-            $accessTokenGiven = $request['access_token'];
+        if (isset($requestArray['access_token'])) {
+            $accessTokenGiven = $requestArray['access_token'];
         } else {
             $header = trim($_SERVER['HTTP_AUTHORIZATION'] ?? '');
             $position = strrpos($header, 'Bearer ');
@@ -35,33 +37,32 @@ class SetBridgeCacheAction implements ActionInterface
         }
 
         // Begin actual work
-        $key = $request['key'] ?? null;
+        $key = $requestArray['key'] ?? null;
         if (!$key) {
-            returnClientError('You must specify key!');
+            return new Response('You must specify key', 400, ['content-type' => 'text/plain']);
         }
 
         $bridgeFactory = new BridgeFactory();
 
-        $bridgeName = $request['bridge'] ?? null;
+        $bridgeName = $requestArray['bridge'] ?? null;
         $bridgeClassName = $bridgeFactory->createBridgeClassName($bridgeName);
         if (!$bridgeClassName) {
-            throw new \Exception(sprintf('Bridge not found: %s', $bridgeName));
+            return new Response(sprintf('Bridge not found: %s', $bridgeName), 400, ['content-type' => 'text/plain']);
         }
 
         // whitelist control
         if (!$bridgeFactory->isEnabled($bridgeClassName)) {
-            throw new \Exception('This bridge is not whitelisted', 401);
+            return new Response('This bridge is not whitelisted', 401, ['content-type' => 'text/plain']);
         }
 
         $bridge = $bridgeFactory->create($bridgeClassName);
         $bridge->loadConfiguration();
-        $value = $request['value'];
+        $value = $requestArray['value'];
 
         $cacheKey = get_class($bridge) . '_' . $key;
         $ttl = 86400 * 3;
         $this->cache->set($cacheKey, $value, $ttl);
 
-        header('Content-Type: text/plain');
-        echo 'done';
+        return new Response('done', 200, ['Content-Type' => 'text/plain']);
     }
 }
diff --git a/bridges/StreamCzBridge.php b/bridges/StreamCzBridge.php
index f3375613..42b1e1f1 100644
--- a/bridges/StreamCzBridge.php
+++ b/bridges/StreamCzBridge.php
@@ -63,7 +63,7 @@ class StreamCzBridge extends BridgeAbstract
             $imageUrlNode = reset($episode['node']['images']);
             $item = [
                 'title' => $episode['node']['name'],
-                'uri' => "${fixedUrl}/${episodeUrl}",
+                'uri' => $fixedUrl . '/' . $episodeUrl,
                 'content' => $imageUrlNode ? '<img src="' . $imageUrlNode['url'] . '" />' : '',
                 'timestamp' => $episode['node']['publishTime']['timestamp']
             ];
diff --git a/formats/HtmlFormat.php b/formats/HtmlFormat.php
index ef66f493..93c824b3 100644
--- a/formats/HtmlFormat.php
+++ b/formats/HtmlFormat.php
@@ -12,20 +12,21 @@ class HtmlFormat extends FormatAbstract
         $formatFactory = new FormatFactory();
         $buttons = [];
         $linkTags = [];
-        foreach ($formatFactory->getFormatNames() as $format) {
+        foreach ($formatFactory->getFormatNames() as $formatName) {
             // Dynamically build buttons for all formats (except HTML)
-            if ($format === 'Html') {
+            if ($formatName === 'Html') {
                 continue;
             }
-            $formatUrl = '?' . str_ireplace('format=Html', 'format=' . $format, htmlentities($queryString));
+            $formatUrl = '?' . str_ireplace('format=Html', 'format=' . $formatName, htmlentities($queryString));
             $buttons[] = [
                 'href' => $formatUrl,
-                'value' => $format,
+                'value' => $formatName,
             ];
+            $format = $formatFactory->create($formatName);
             $linkTags[] = [
                 'href' => $formatUrl,
-                'title' => $format,
-                'type' => $formatFactory->create($format)->getMimeType(),
+                'title' => $formatName,
+                'type' => $format->getMimeType(),
             ];
         }
 
diff --git a/lib/ActionInterface.php b/lib/ActionInterface.php
index 220dfa50..c0ddcf9f 100644
--- a/lib/ActionInterface.php
+++ b/lib/ActionInterface.php
@@ -5,5 +5,5 @@ interface ActionInterface
     /**
      * @return string|Response
      */
-    public function execute(array $request);
+    public function execute(Request $request);
 }
diff --git a/lib/BridgeCard.php b/lib/BridgeCard.php
index 6b835c15..6b812740 100644
--- a/lib/BridgeCard.php
+++ b/lib/BridgeCard.php
@@ -3,13 +3,13 @@
 final class BridgeCard
 {
     /**
-     * Gets a single bridge card
+     * Render bridge card
      *
      * @param class-string<BridgeAbstract> $bridgeClassName The bridge name
      * @param bool $isActive Indicates if the bridge is active or not
      * @return string The bridge card
      */
-    public static function displayBridgeCard($bridgeClassName, $isActive = true)
+    public static function render($bridgeClassName, $isActive = true)
     {
         $bridgeFactory = new BridgeFactory();
 
@@ -56,10 +56,10 @@ final class BridgeCard
         // If we don't have any parameter for the bridge, we print a generic form to load it.
         if (count($contexts) === 0) {
             // The bridge has zero parameters
-            $card .= self::getForm($bridgeClassName, $isActive);
+            $card .= self::renderForm($bridgeClassName, $isActive);
         } elseif (count($contexts) === 1 && array_key_exists('global', $contexts)) {
             // The bridge has a single context with key 'global'
-            $card .= self::getForm($bridgeClassName, $isActive, '', $contexts['global']);
+            $card .= self::renderForm($bridgeClassName, $isActive, '', $contexts['global']);
         } else {
             // The bridge has one or more contexts (named or unnamed)
             foreach ($contexts as $contextName => $contextParameters) {
@@ -77,7 +77,7 @@ final class BridgeCard
                     $card .= '<h5>' . $contextName . '</h5>' . PHP_EOL;
                 }
 
-                $card .= self::getForm($bridgeClassName, $isActive, $contextName, $contextParameters);
+                $card .= self::renderForm($bridgeClassName, $isActive, $contextName, $contextParameters);
             }
         }
 
@@ -97,7 +97,7 @@ final class BridgeCard
         return $card;
     }
 
-    private static function getForm(
+    private static function renderForm(
         string $bridgeClassName,
         bool $isActive = false,
         string $contextName = '',
diff --git a/lib/FeedExpander.php b/lib/FeedExpander.php
index c0d7e878..35b75249 100644
--- a/lib/FeedExpander.php
+++ b/lib/FeedExpander.php
@@ -26,6 +26,7 @@ abstract class FeedExpander extends BridgeAbstract
         $badStrings = [
             '&nbsp;',
             '&raquo;',
+            '&rsquo;',
         ];
         $xmlString = str_replace($badStrings, '', $xmlString);
         $feedParser = new FeedParser();
diff --git a/lib/FormatFactory.php b/lib/FormatFactory.php
index 042dcf31..e9cbe597 100644
--- a/lib/FormatFactory.php
+++ b/lib/FormatFactory.php
@@ -2,32 +2,26 @@
 
 class FormatFactory
 {
-    private $folder;
-    private $formatNames;
+    private array $formatNames = [];
 
-    public function __construct(string $folder = PATH_LIB_FORMATS)
+    public function __construct()
     {
-        $this->folder = $folder;
-
-        // create format names
-        foreach (scandir($this->folder) as $file) {
-            if (preg_match('/^([^.]+)Format\.php$/U', $file, $m)) {
+        $iterator = new \FilesystemIterator(__DIR__ . '/../formats');
+        foreach ($iterator as $file) {
+            if (preg_match('/^([^.]+)Format\.php$/U', $file->getFilename(), $m)) {
                 $this->formatNames[] = $m[1];
             }
         }
+        sort($this->formatNames);
     }
 
-    /**
-     * @throws \InvalidArgumentException
-     * @param string $name The name of the format e.g. "Atom", "Mrss" or "Json"
-     */
     public function create(string $name): FormatAbstract
     {
         if (! preg_match('/^[a-zA-Z0-9-]*$/', $name)) {
             throw new \InvalidArgumentException('Format name invalid!');
         }
-        $sanitizedName = $this->sanitizeFormatName($name);
-        if ($sanitizedName === null) {
+        $sanitizedName = $this->sanitizeName($name);
+        if (!$sanitizedName) {
             throw new \InvalidArgumentException(sprintf('Unknown format given `%s`', $name));
         }
         $className = '\\' . $sanitizedName . 'Format';
@@ -39,15 +33,13 @@ class FormatFactory
         return $this->formatNames;
     }
 
-    protected function sanitizeFormatName(string $name)
+    protected function sanitizeName(string $name): ?string
     {
         $name = ucfirst(strtolower($name));
-
         // Trim trailing '.php' if exists
         if (preg_match('/(.+)(?:\.php)/', $name, $matches)) {
             $name = $matches[1];
         }
-
         // Trim trailing 'Format' if exists
         if (preg_match('/(.+)(?:Format)/i', $name, $matches)) {
             $name = $matches[1];
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index 5938f824..c8d11596 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -27,9 +27,17 @@ final class RssBridge
     {
         if ($argv) {
             parse_str(implode('&', array_slice($argv, 1)), $cliArgs);
-            $request = $cliArgs;
+            $request = Request::fromCli($cliArgs);
         } else {
-            $request = array_merge($_GET, $_POST);
+            $request = Request::fromGlobals();
+        }
+
+        foreach ($request->toArray() as $key => $value) {
+            if (!is_string($value)) {
+                return new Response(render(__DIR__ . '/../templates/error.html.php', [
+                    'message' => "Query parameter \"$key\" is not a string.",
+                ]), 400);
+            }
         }
 
         if (Configuration::getConfig('system', 'enable_maintenance_mode')) {
@@ -43,8 +51,8 @@ final class RssBridge
             if (Configuration::getConfig('authentication', 'password') === '') {
                 return new Response('The authentication password cannot be the empty string', 500);
             }
-            $user = $_SERVER['PHP_AUTH_USER'] ?? null;
-            $password = $_SERVER['PHP_AUTH_PW'] ?? null;
+            $user = $request->server('PHP_AUTH_USER');
+            $password = $request->server('PHP_AUTH_PW');
             if ($user === null || $password === null) {
                 $html = render(__DIR__ . '/../templates/error.html.php', [
                     'message' => 'Please authenticate in order to access this instance!',
@@ -63,16 +71,8 @@ final class RssBridge
             // At this point the username and password was correct
         }
 
-        foreach ($request as $key => $value) {
-            if (!is_string($value)) {
-                return new Response(render(__DIR__ . '/../templates/error.html.php', [
-                    'message' => "Query parameter \"$key\" is not a string.",
-                ]), 400);
-            }
-        }
-
-        $actionName = $request['action'] ?? 'Frontpage';
-        $actionName = strtolower($actionName) . 'Action';
+        $action = $request->get('action', 'Frontpage');
+        $actionName = strtolower($action) . 'Action';
         $actionName = implode(array_map('ucfirst', explode('-', $actionName)));
         $filePath = __DIR__ . '/../actions/' . $actionName . '.php';
         if (!file_exists($filePath)) {
@@ -80,9 +80,9 @@ final class RssBridge
         }
 
         $className = '\\' . $actionName;
-        $action = new $className();
+        $actionObject = new $className();
 
-        $response = $action->execute($request);
+        $response = $actionObject->execute($request);
 
         if (is_string($response)) {
             $response = new Response($response);
diff --git a/lib/bootstrap.php b/lib/bootstrap.php
index 01828f67..48db871c 100644
--- a/lib/bootstrap.php
+++ b/lib/bootstrap.php
@@ -1,12 +1,6 @@
 <?php
 
-// Path to the formats library
-const PATH_LIB_FORMATS = __DIR__ . '/../formats/';
-
-/** Path to the caches library */
 const PATH_LIB_CACHES = __DIR__ . '/../caches/';
-
-/** Path to the cache folder */
 const PATH_CACHE = __DIR__ . '/../cache/';
 
 // Allow larger files for simple_html_dom
diff --git a/lib/http.php b/lib/http.php
index 90b65a6e..d53909b4 100644
--- a/lib/http.php
+++ b/lib/http.php
@@ -166,6 +166,46 @@ final class CurlHttpClient implements HttpClient
     }
 }
 
+final class Request
+{
+    private array $get;
+    private array $server;
+
+    private function __construct()
+    {
+    }
+
+    public static function fromGlobals(): self
+    {
+        $self = new self();
+        $self->get = $_GET;
+        $self->server = $_SERVER;
+        return $self;
+    }
+
+    public static function fromCli(array $cliArgs): self
+    {
+        $self = new self();
+        $self->get = $cliArgs;
+        return $self;
+    }
+
+    public function get(string $key, $default = null): ?string
+    {
+        return $this->get[$key] ?? $default;
+    }
+
+    public function server(string $key, string $default = null): ?string
+    {
+        return $this->server[$key] ?? $default;
+    }
+
+    public function toArray(): array
+    {
+        return $this->get;
+    }
+}
+
 final class Response
 {
     public const STATUS_CODES = [
diff --git a/static/connectivity.js b/static/connectivity.js
index 89f01f01..55ee9434 100644
--- a/static/connectivity.js
+++ b/static/connectivity.js
@@ -4,7 +4,7 @@ var abort = false;
 
 window.onload = function() {
 
-	fetch(remote + '/index.php?action=list').then(function(response) {
+	fetch(remote + '/?action=list').then(function(response) {
 		return response.text()
 	}).then(function(data){
 		processBridgeList(data);
@@ -46,9 +46,9 @@ function buildTable(bridgeList) {
 		var td_bridge = document.createElement('td');
 		td_bridge.innerText = bridgeList.bridges[bridge].name;
 
-		// Link to the actual bridge on index.php
+		// Link to the actual bridge on frontpage
 		var a = document.createElement('a');
-		a.href = remote + "/index.php?show_inactive=1#bridge-" + bridge;
+		a.href = remote + "/?show_inactive=1#bridge-" + bridge;
 		a.target = '_blank';
 		a.innerText = '[Show]';
 		a.style.marginLeft = '5px';
@@ -104,7 +104,7 @@ function checkNextBridgeAsync() {
 
 			msg.getElementsByTagName('span')[0].textContent = 'Processing ' + bridge + '...';
 
-			fetch(remote + '/index.php?action=Connectivity&bridge=' + bridge)
+			fetch(remote + '/?action=Connectivity&bridge=' + bridge)
 			.then(function(response) { return response.text() })
 			.then(JSON.parse)
 			.then(processBridgeResultAsync)
diff --git a/tests/Formats/FormatImplementationTest.php b/tests/Formats/FormatImplementationTest.php
index 03ac6d51..16bbb89e 100644
--- a/tests/Formats/FormatImplementationTest.php
+++ b/tests/Formats/FormatImplementationTest.php
@@ -30,7 +30,7 @@ class FormatImplementationTest extends TestCase
     public function dataFormatsProvider()
     {
         $formats = [];
-        foreach (glob(PATH_LIB_FORMATS . '*.php') as $path) {
+        foreach (glob(__DIR__ . '/../formats/*.php') as $path) {
             $formats[basename($path, '.php')] = [$path];
         }
         return $formats;

From e58c867a82f4c884eaeda93519ed8464d052837c Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 25 Jan 2024 18:20:02 +0100
Subject: [PATCH 281/716] feat: token authentication (#3927)

---
 README.md                        | 30 +++++++-------
 actions/DisplayAction.php        |  1 +
 actions/FrontpageAction.php      |  7 +---
 actions/SetBridgeCacheAction.php | 68 --------------------------------
 config.default.ini.php           | 14 ++-----
 lib/BridgeCard.php               | 39 ++++++++----------
 lib/RssBridge.php                | 18 +++++++++
 lib/http.php                     | 14 +++++++
 static/connectivity.js           |  2 +-
 static/style.css                 |  2 +-
 templates/base.html.php          |  2 +
 templates/frontpage.html.php     | 16 +-------
 templates/token.html.php         | 20 ++++++++++
 13 files changed, 95 insertions(+), 138 deletions(-)
 delete mode 100644 actions/SetBridgeCacheAction.php
 create mode 100644 templates/token.html.php

diff --git a/README.md b/README.md
index d6d1046c..8e8ae117 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,13 @@ Officially hosted instance: https://rss-bridge.org/bridge01/
 
 IRC channel #rssbridge at https://libera.chat/
 
+[Full documentation](https://rss-bridge.github.io/rss-bridge/index.html)
+
+Alternatively find another
+[public instance](https://rss-bridge.github.io/rss-bridge/General/Public_Hosts.html).
+
+Requires minimum PHP 7.4.
+
 
 [![LICENSE](https://img.shields.io/badge/license-UNLICENSE-blue.svg)](UNLICENSE)
 [![GitHub release](https://img.shields.io/github/release/rss-bridge/rss-bridge.svg?logo=github)](https://github.com/rss-bridge/rss-bridge/releases/latest)
@@ -44,15 +51,6 @@ IRC channel #rssbridge at https://libera.chat/
 * `YoutubeBridge`: [Fetches videos by username/channel/playlist/search](https://rss-bridge.org/bridge01/#bridge-YoutubeBridge)
 * `YouTubeCommunityTabBridge`: [Fetches posts from a channel's community tab](https://rss-bridge.org/bridge01/#bridge-YouTubeCommunityTabBridge)
 
-[Full documentation](https://rss-bridge.github.io/rss-bridge/index.html)
-
-Check out RSS-Bridge right now on https://rss-bridge.org/bridge01/
-
-Alternatively find another
-[public instance](https://rss-bridge.github.io/rss-bridge/General/Public_Hosts.html).
-
-Requires minimum PHP 7.4.
-
 ## Tutorial
 
 ### How to install on traditional shared web hosting
@@ -259,6 +257,14 @@ Learn more in
 
 ## How-to
 
+### How to password-protect the instance (token)
+
+Modify `config.ini.php`:
+
+    [authentication]
+
+    token = "hunter2"
+
 ### How to remove all cache items
 
 As current user:
@@ -332,8 +338,6 @@ Learn more in [bridge api](https://rss-bridge.github.io/rss-bridge/Bridge_API/in
 
 ### How to enable all bridges
 
-Modify `config.ini.php`:
-
     enabled_bridges[] = *
 
 ### How to enable some bridges
@@ -390,9 +394,7 @@ Modify `report_limit` so that an error must occur 3 times before it is reported.
 
 The report count is reset to 0 each day.
 
-### How to password-protect the instance
-
-HTTP basic access authentication:
+### How to password-protect the instance (HTTP Basic Auth)
 
     [authentication]
 
diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 915eace5..ed063825 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -102,6 +102,7 @@ class DisplayAction implements ActionInterface
             $bridge->loadConfiguration();
             // Remove parameters that don't concern bridges
             $remove = [
+                'token',
                 'action',
                 'bridge',
                 'format',
diff --git a/actions/FrontpageAction.php b/actions/FrontpageAction.php
index c0f819d0..32795c45 100644
--- a/actions/FrontpageAction.php
+++ b/actions/FrontpageAction.php
@@ -4,8 +4,6 @@ final class FrontpageAction implements ActionInterface
 {
     public function execute(Request $request)
     {
-        $showInactive = (bool) $request->get('show_inactive');
-
         $messages = [];
         $activeBridges = 0;
 
@@ -22,10 +20,8 @@ final class FrontpageAction implements ActionInterface
         $body = '';
         foreach ($bridgeClassNames as $bridgeClassName) {
             if ($bridgeFactory->isEnabled($bridgeClassName)) {
-                $body .= BridgeCard::render($bridgeClassName);
+                $body .= BridgeCard::render($bridgeClassName, $request);
                 $activeBridges++;
-            } elseif ($showInactive) {
-                $body .= BridgeCard::render($bridgeClassName, false) . "\n";
             }
         }
 
@@ -37,7 +33,6 @@ final class FrontpageAction implements ActionInterface
             'bridges' => $body,
             'active_bridges' => $activeBridges,
             'total_bridges' => count($bridgeClassNames),
-            'show_inactive' => $showInactive,
         ]);
     }
 }
diff --git a/actions/SetBridgeCacheAction.php b/actions/SetBridgeCacheAction.php
deleted file mode 100644
index 5b1c6f53..00000000
--- a/actions/SetBridgeCacheAction.php
+++ /dev/null
@@ -1,68 +0,0 @@
-<?php
-
-class SetBridgeCacheAction implements ActionInterface
-{
-    private CacheInterface $cache;
-
-    public function __construct()
-    {
-        $this->cache = RssBridge::getCache();
-    }
-
-    public function execute(Request $request)
-    {
-        $requestArray = $request->toArray();
-
-        // Authentication
-        $accessTokenInConfig = Configuration::getConfig('authentication', 'access_token');
-        if (!$accessTokenInConfig) {
-            return new Response('Access token is not set in this instance', 403, ['content-type' => 'text/plain']);
-        }
-        if (isset($requestArray['access_token'])) {
-            $accessTokenGiven = $requestArray['access_token'];
-        } else {
-            $header = trim($_SERVER['HTTP_AUTHORIZATION'] ?? '');
-            $position = strrpos($header, 'Bearer ');
-            if ($position !== false) {
-                $accessTokenGiven = substr($header, $position + 7);
-            } else {
-                $accessTokenGiven = '';
-            }
-        }
-        if (!$accessTokenGiven) {
-            return new Response('No access token given', 403, ['content-type' => 'text/plain']);
-        }
-        if (! hash_equals($accessTokenInConfig, $accessTokenGiven)) {
-            return new Response('Incorrect access token', 403, ['content-type' => 'text/plain']);
-        }
-
-        // Begin actual work
-        $key = $requestArray['key'] ?? null;
-        if (!$key) {
-            return new Response('You must specify key', 400, ['content-type' => 'text/plain']);
-        }
-
-        $bridgeFactory = new BridgeFactory();
-
-        $bridgeName = $requestArray['bridge'] ?? null;
-        $bridgeClassName = $bridgeFactory->createBridgeClassName($bridgeName);
-        if (!$bridgeClassName) {
-            return new Response(sprintf('Bridge not found: %s', $bridgeName), 400, ['content-type' => 'text/plain']);
-        }
-
-        // whitelist control
-        if (!$bridgeFactory->isEnabled($bridgeClassName)) {
-            return new Response('This bridge is not whitelisted', 401, ['content-type' => 'text/plain']);
-        }
-
-        $bridge = $bridgeFactory->create($bridgeClassName);
-        $bridge->loadConfiguration();
-        $value = $requestArray['value'];
-
-        $cacheKey = get_class($bridge) . '_' . $key;
-        $ttl = 86400 * 3;
-        $this->cache->set($cacheKey, $value, $ttl);
-
-        return new Response('done', 200, ['Content-Type' => 'text/plain']);
-    }
-}
diff --git a/config.default.ini.php b/config.default.ini.php
index ee1e54c9..91a4c4fe 100644
--- a/config.default.ini.php
+++ b/config.default.ini.php
@@ -102,21 +102,13 @@ by_bridge = false
 
 [authentication]
 
-; Enables basic authentication for all requests to this RSS-Bridge instance.
-;
-; Warning: You'll have to upgrade existing feeds after enabling this option!
-;
-; true  = enabled
-; false = disabled (default)
+; HTTP basic authentication
 enable = false
-
 username = "admin"
-
-; The password cannot be the empty string if authentication is enabled.
 password = ""
 
-; This will be used only for actions that require privileged access
-access_token = ""
+; Token authentication (URL)
+token = ""
 
 [error]
 
diff --git a/lib/BridgeCard.php b/lib/BridgeCard.php
index 6b812740..e5456f33 100644
--- a/lib/BridgeCard.php
+++ b/lib/BridgeCard.php
@@ -2,14 +2,7 @@
 
 final class BridgeCard
 {
-    /**
-     * Render bridge card
-     *
-     * @param class-string<BridgeAbstract> $bridgeClassName The bridge name
-     * @param bool $isActive Indicates if the bridge is active or not
-     * @return string The bridge card
-     */
-    public static function render($bridgeClassName, $isActive = true)
+    public static function render(string $bridgeClassName, Request $request): string
     {
         $bridgeFactory = new BridgeFactory();
 
@@ -47,19 +40,21 @@ final class BridgeCard
 
             <h2><a href="{$uri}">{$name}</a></h2>
             <p class="description">{$description}</p>
+
             <input type="checkbox" class="showmore-box" id="showmore-{$bridgeClassName}" />
             <label class="showmore" for="showmore-{$bridgeClassName}">Show more</label>
 
 
         CARD;
 
-        // If we don't have any parameter for the bridge, we print a generic form to load it.
+        $token = $request->attribute('token');
+
         if (count($contexts) === 0) {
             // The bridge has zero parameters
-            $card .= self::renderForm($bridgeClassName, $isActive);
+            $card .= self::renderForm($bridgeClassName, '', [], $token);
         } elseif (count($contexts) === 1 && array_key_exists('global', $contexts)) {
             // The bridge has a single context with key 'global'
-            $card .= self::renderForm($bridgeClassName, $isActive, '', $contexts['global']);
+            $card .= self::renderForm($bridgeClassName, '', $contexts['global'], $token);
         } else {
             // The bridge has one or more contexts (named or unnamed)
             foreach ($contexts as $contextName => $contextParameters) {
@@ -77,7 +72,7 @@ final class BridgeCard
                     $card .= '<h5>' . $contextName . '</h5>' . PHP_EOL;
                 }
 
-                $card .= self::renderForm($bridgeClassName, $isActive, $contextName, $contextParameters);
+                $card .= self::renderForm($bridgeClassName, $contextName, $contextParameters, $token);
             }
         }
 
@@ -99,17 +94,21 @@ final class BridgeCard
 
     private static function renderForm(
         string $bridgeClassName,
-        bool $isActive = false,
-        string $contextName = '',
-        array $contextParameters = []
+        string $contextName,
+        array $contextParameters,
+        ?string $token
     ) {
         $form = <<<EOD
-        <form method="GET" action="?">
+        <form method="GET" action="?" class="bridge-form">
             <input type="hidden" name="action" value="display" />
             <input type="hidden" name="bridge" value="{$bridgeClassName}" />
-
         EOD;
 
+        if ($token) {
+            // todo: maybe escape the token?
+            $form .= sprintf('<input type="hidden" name="token" value="%s" />', $token);
+        }
+
         if (!empty($contextName)) {
             $form .= sprintf('<input type="hidden" name="context" value="%s" />', $contextName);
         }
@@ -167,11 +166,7 @@ final class BridgeCard
             $form .= '</div>';
         }
 
-        if ($isActive) {
-            $form .= '<button type="submit" name="format" formtarget="_blank" value="Html">Generate feed</button>';
-        } else {
-            $form .= '<span style="font-weight: bold;">Inactive</span>';
-        }
+        $form .= '<button type="submit" name="format" formtarget="_blank" value="Html">Generate feed</button>';
 
         return $form . '</form>' . PHP_EOL;
     }
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index c8d11596..1bb5f5ea 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -47,6 +47,7 @@ final class RssBridge
             ]), 503);
         }
 
+        // HTTP Basic auth check
         if (Configuration::getConfig('authentication', 'enable')) {
             if (Configuration::getConfig('authentication', 'password') === '') {
                 return new Response('The authentication password cannot be the empty string', 500);
@@ -71,6 +72,23 @@ final class RssBridge
             // At this point the username and password was correct
         }
 
+        // Add token as attribute to request
+        $request = $request->withAttribute('token', $request->get('token'));
+
+        // Token authentication check
+        if (Configuration::getConfig('authentication', 'token')) {
+            if (! $request->attribute('token')) {
+                return new Response(render(__DIR__ . '/../templates/token.html.php', [
+                    'message' => '',
+                ]), 401);
+            }
+            if (! hash_equals(Configuration::getConfig('authentication', 'token'), $request->attribute('token'))) {
+                return new Response(render(__DIR__ . '/../templates/token.html.php', [
+                    'message' => 'Invalid token',
+                ]), 401);
+            }
+        }
+
         $action = $request->get('action', 'Frontpage');
         $actionName = strtolower($action) . 'Action';
         $actionName = implode(array_map('ucfirst', explode('-', $actionName)));
diff --git a/lib/http.php b/lib/http.php
index d53909b4..e4f9bf48 100644
--- a/lib/http.php
+++ b/lib/http.php
@@ -170,6 +170,7 @@ final class Request
 {
     private array $get;
     private array $server;
+    private array $attributes;
 
     private function __construct()
     {
@@ -180,6 +181,7 @@ final class Request
         $self = new self();
         $self->get = $_GET;
         $self->server = $_SERVER;
+        $self->attributes = [];
         return $self;
     }
 
@@ -200,6 +202,18 @@ final class Request
         return $this->server[$key] ?? $default;
     }
 
+    public function withAttribute(string $name, $value = true): self
+    {
+        $clone = clone $this;
+        $clone->attributes[$name] = $value;
+        return $clone;
+    }
+
+    public function attribute(string $key, $default = null)
+    {
+        return $this->attributes[$key] ?? $default;
+    }
+
     public function toArray(): array
     {
         return $this->get;
diff --git a/static/connectivity.js b/static/connectivity.js
index 55ee9434..2f39ce6b 100644
--- a/static/connectivity.js
+++ b/static/connectivity.js
@@ -48,7 +48,7 @@ function buildTable(bridgeList) {
 
 		// Link to the actual bridge on frontpage
 		var a = document.createElement('a');
-		a.href = remote + "/?show_inactive=1#bridge-" + bridge;
+		a.href = remote + "/?#bridge-" + bridge;
 		a.target = '_blank';
 		a.innerText = '[Show]';
 		a.style.marginLeft = '5px';
diff --git a/static/style.css b/static/style.css
index cfaf66a1..4e6b1b2d 100644
--- a/static/style.css
+++ b/static/style.css
@@ -287,7 +287,7 @@ p.maintainer {
 }
 
 /* Hide all forms on the frontpage by default */
-form {
+form.bridge-form {
     display: none;
 }
 
diff --git a/templates/base.html.php b/templates/base.html.php
index ca31823d..d2557599 100644
--- a/templates/base.html.php
+++ b/templates/base.html.php
@@ -7,6 +7,8 @@
     <title><?= e($_title ?? 'RSS-Bridge') ?></title>
     <link href="static/style.css?2023-03-24" rel="stylesheet">
     <link rel="icon" type="image/png" href="static/favicon.png">
+
+    <script src="static/rss-bridge.js"></script>
 </head>
 
 <body>
diff --git a/templates/frontpage.html.php b/templates/frontpage.html.php
index a0d274da..c1182673 100644
--- a/templates/frontpage.html.php
+++ b/templates/frontpage.html.php
@@ -1,4 +1,4 @@
-<script src="static/rss-bridge.js"></script>
+
 <script>
     document.addEventListener('DOMContentLoaded', rssbridge_toggle_bridge);
     document.addEventListener('DOMContentLoaded', rssbridge_list_search);
@@ -42,20 +42,6 @@
 
     <?= $active_bridges ?>/<?= $total_bridges ?> active bridges.<br>
 
-    <?php if ($active_bridges !== $total_bridges): ?>
-        <?php if ($show_inactive): ?>
-            <a href="?show_inactive=0">
-                <button class="small">Hide inactive bridges</button>
-            </a>
-            <br>
-        <?php else: ?>
-            <a href="?show_inactive=1">
-                <button class="small">Show inactive bridges</button>
-            </a>
-            <br>
-        <?php endif; ?>
-    <?php endif; ?>
-
     <br>
 
     <?php if ($admin_email): ?>
diff --git a/templates/token.html.php b/templates/token.html.php
new file mode 100644
index 00000000..1a036dbb
--- /dev/null
+++ b/templates/token.html.php
@@ -0,0 +1,20 @@
+<?php
+/**
+ * This template renders a form for user to enter a auth token if it's enabled
+ */
+
+?>
+
+<h1>
+    Authentication with token required
+</h1>
+
+<p>
+    <?= e($message) ?>
+</p>
+
+<form action="" method="get">
+    <label for="token">Token:</label>
+    <input type="password" name="token" id="token" placeholder="token">
+    <input type="submit" value="OK">
+</form>

From 0e3a79fd78c205a48c1ef16a8ff6f175e59d1059 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 26 Jan 2024 21:44:34 +0100
Subject: [PATCH 282/716] fix: bug in cache-prune (#3933)

fixes Uncaught Exception: No cache type configured
---
 index.php         | 6 ------
 lib/bootstrap.php | 6 ++++++
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/index.php b/index.php
index 029b673c..56a94ac6 100644
--- a/index.php
+++ b/index.php
@@ -57,12 +57,6 @@ if ($errors) {
     exit;
 }
 
-$customConfig = [];
-if (file_exists(__DIR__ . '/config.ini.php')) {
-    $customConfig = parse_ini_file(__DIR__ . '/config.ini.php', true, INI_SCANNER_TYPED);
-}
-Configuration::loadConfiguration($customConfig, getenv());
-
 // Consider: ini_set('error_reporting', E_ALL & ~E_DEPRECATED);
 
 date_default_timezone_set(Configuration::getConfig('system', 'timezone'));
diff --git a/lib/bootstrap.php b/lib/bootstrap.php
index 48db871c..f1d82c4c 100644
--- a/lib/bootstrap.php
+++ b/lib/bootstrap.php
@@ -41,3 +41,9 @@ spl_autoload_register(function ($className) {
         }
     }
 });
+
+$customConfig = [];
+if (file_exists(__DIR__ . '/config.ini.php')) {
+    $customConfig = parse_ini_file(__DIR__ . '/config.ini.php', true, INI_SCANNER_TYPED);
+}
+Configuration::loadConfiguration($customConfig, getenv());

From 6938f061257033be082b0250c76fa34452183d8f Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Fri, 26 Jan 2024 21:45:46 +0100
Subject: [PATCH 283/716] [prtester.py] Fix: Only select actual "option"
 elements of "select" elements to prevent "TypeError: argument of type
 'NoneType' is not iterable" (#3932)

---
 .github/prtester.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/prtester.py b/.github/prtester.py
index 103ecbe6..30a9f43b 100644
--- a/.github/prtester.py
+++ b/.github/prtester.py
@@ -87,7 +87,8 @@ def testBridges(instance: Instance, bridge_cards: Iterable, with_upload: bool, w
                 selectionvalue = ''
                 listname = listing.get('name')
                 cleanlist = []
-                for option in listing.contents:
+                options = listing.find_all('option')
+                for option in options:
                     if 'optgroup' in option.name:
                         cleanlist.extend(option)
                     else:

From c3a968193ef7948ca0908f3350a58c01e47ae274 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 26 Jan 2024 21:58:24 +0100
Subject: [PATCH 284/716] fix: typo in previous commit (#3934)

---
 lib/bootstrap.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/bootstrap.php b/lib/bootstrap.php
index f1d82c4c..6465f5f9 100644
--- a/lib/bootstrap.php
+++ b/lib/bootstrap.php
@@ -43,7 +43,7 @@ spl_autoload_register(function ($className) {
 });
 
 $customConfig = [];
-if (file_exists(__DIR__ . '/config.ini.php')) {
-    $customConfig = parse_ini_file(__DIR__ . '/config.ini.php', true, INI_SCANNER_TYPED);
+if (file_exists(__DIR__ . '/../config.ini.php')) {
+    $customConfig = parse_ini_file(__DIR__ . '/../config.ini.php', true, INI_SCANNER_TYPED);
 }
 Configuration::loadConfiguration($customConfig, getenv());

From a15e5781585bf7bdfac72c569900a975e1495c53 Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Sat, 27 Jan 2024 18:14:58 +0530
Subject: [PATCH 285/716] [FirefoxReleaseNotesBridge] Add New Bridge (#3930)

* [FirefoxReleaseNotesBridge] Add New Bridge

I'm uncertain about the reasons for the failed checks.

* Update FirefoxReleaseNotesBridge.php
---
 bridges/FirefoxReleaseNotesBridge.php | 47 +++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 bridges/FirefoxReleaseNotesBridge.php

diff --git a/bridges/FirefoxReleaseNotesBridge.php b/bridges/FirefoxReleaseNotesBridge.php
new file mode 100644
index 00000000..c74c9d51
--- /dev/null
+++ b/bridges/FirefoxReleaseNotesBridge.php
@@ -0,0 +1,47 @@
+<?php
+
+class FirefoxReleaseNotesBridge extends BridgeAbstract
+{
+    const NAME = 'Firefox Release Notes';
+    const URI = 'https://www.mozilla.org/en-US/firefox/';
+    const DESCRIPTION = 'Retrieve the latest Firefox release notes.';
+    const MAINTAINER = 'tillcash';
+    const PARAMETERS = [
+        [
+            'platform' => [
+                'name' => 'Platform',
+                'type' => 'list',
+                'values' => [
+                    'Desktop' => '',
+                    'Beta' => 'beta',
+                    'Nightly' => 'nightly',
+                    'Android' => 'android',
+                    'iOS' => 'ios',
+                ]
+            ]
+        ]
+    ];
+
+    public function getName()
+    {
+        $platform = $this->getKey('platform');
+        return sprintf('Firefox %s Release Notes', $platform ?? '');
+    }
+
+    public function collectData()
+    {
+        $platform = $this->getKey('platform');
+        $url = self::URI . $this->getInput('platform') . '/notes/';
+        $dom = getSimpleHTMLDOM($url);
+
+        $version = $dom->find('.c-release-version', 0)->innertext;
+
+        $this->items[] = [
+            'content' => $dom->find('.c-release-notes', 0)->innertext,
+            'timestamp' => $dom->find('.c-release-date', 0)->innertext,
+            'title' => sprintf('Firefox %s %s Release Note', $platform, $version),
+            'uri' => $url,
+            'uid' => $platform . $version,
+        ];
+    }
+}

From cfe3dcfe6d277980737cfde6ac3494caf37e6195 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 28 Jan 2024 01:51:14 +0100
Subject: [PATCH 286/716] fix: remove twitter from readme (#3935)

---
 README.md                 |   6 ++----
 static/twitter-form.png   | Bin 53726 -> 0 bytes
 static/twitter-rasmus.png | Bin 691146 -> 0 bytes
 3 files changed, 2 insertions(+), 4 deletions(-)
 delete mode 100644 static/twitter-form.png
 delete mode 100644 static/twitter-rasmus.png

diff --git a/README.md b/README.md
index 8e8ae117..138962f2 100644
--- a/README.md
+++ b/README.md
@@ -28,9 +28,8 @@ Requires minimum PHP 7.4.
 |![Screenshot #1](/static/screenshot-1.png?raw=true)|![Screenshot #2](/static/screenshot-2.png?raw=true)|
 |![Screenshot #3](/static/screenshot-3.png?raw=true)|![Screenshot #4](/static/screenshot-4.png?raw=true)|
 |![Screenshot #5](/static/screenshot-5.png?raw=true)|![Screenshot #6](/static/screenshot-6.png?raw=true)|
-|![Screenshot #7](/static/twitter-form.png?raw=true)|![Screenshot #8](/static/twitter-rasmus.png?raw=true)|
 
-## A subset of bridges (17/412)
+## A subset of bridges (16/447)
 
 * `CssSelectorBridge`: [Scrape out a feed using CSS selectors](https://rss-bridge.org/bridge01/#bridge-CssSelectorBridge)
 * `FeedMergeBridge`: [Combine multiple feeds into one](https://rss-bridge.org/bridge01/#bridge-FeedMergeBridge)
@@ -45,7 +44,6 @@ Requires minimum PHP 7.4.
 * `ThePirateBayBridge:` [Fetches torrents by search/user/category](https://rss-bridge.org/bridge01/#bridge-ThePirateBayBridge)
 * `TikTokBridge`: [Fetches posts by username](https://rss-bridge.org/bridge01/#bridge-TikTokBridge)
 * `TwitchBridge`: [Fetches videos from channel](https://rss-bridge.org/bridge01/#bridge-TwitchBridge)
-* `TwitterBridge`: [Fetches tweets](https://rss-bridge.org/bridge01/#bridge-TwitterBridge)
 * `VkBridge`: [Fetches posts from user/group](https://rss-bridge.org/bridge01/#bridge-VkBridge)
 * `XPathBridge`: [Scrape out a feed using XPath expressions](https://rss-bridge.org/bridge01/#bridge-XPathBridge)
 * `YoutubeBridge`: [Fetches videos by username/channel/playlist/search](https://rss-bridge.org/bridge01/#bridge-YoutubeBridge)
@@ -444,7 +442,7 @@ Cached files are deleted automatically after 24 hours.
 RSS-Bridge allows you to take full control over which bridges are displayed to the user.
 That way you can host your own RSS-Bridge service with your favorite collection of bridges!
 
-Current maintainers (as of 2023): @dvikan and @Mynacol #2519
+Current maintainers (as of 2024): @dvikan and @Mynacol #2519
 
 ## Reference
 
diff --git a/static/twitter-form.png b/static/twitter-form.png
deleted file mode 100644
index 2f1a988ca641bef8431f83eea5d13018d7f09631..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 53726
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

diff --git a/static/twitter-rasmus.png b/static/twitter-rasmus.png
deleted file mode 100644
index 916927867fd2ff5a51741a91ca7bed55e2b19861..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 691146
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%0DCpfUby?t<a
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
BGARH6


From c4fceab7b3de0b842145fa26acbe6f8785474cfd Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Mon, 29 Jan 2024 21:51:06 +0100
Subject: [PATCH 287/716] refactor(FeedParser):  (#3928)

---
 lib/BridgeAbstract.php   |  2 +-
 lib/FeedExpander.php     |  1 +
 lib/FeedParser.php       | 71 ++++++++++++++++++----------------------
 tests/FeedParserTest.php | 55 +++++++++++++++++++++++++++++++
 4 files changed, 88 insertions(+), 41 deletions(-)

diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index 5dc425f9..1456e1c3 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -80,7 +80,7 @@ abstract class BridgeAbstract
     }
 
     /**
-     * The description is currently not used in feed production
+     * The description is only used in bridge card rendering on frontpage
      */
     public function getDescription()
     {
diff --git a/lib/FeedExpander.php b/lib/FeedExpander.php
index 35b75249..be3a8ca4 100644
--- a/lib/FeedExpander.php
+++ b/lib/FeedExpander.php
@@ -32,6 +32,7 @@ abstract class FeedExpander extends BridgeAbstract
         $feedParser = new FeedParser();
         $this->feed = $feedParser->parseFeed($xmlString);
         $items = array_slice($this->feed['items'], 0, $maxItems);
+        // todo: extract parse logic out from FeedParser
         foreach ($items as $item) {
             // Give bridges a chance to modify the item
             $item = $this->parseItem($item);
diff --git a/lib/FeedParser.php b/lib/FeedParser.php
index 510bcb32..37d3005b 100644
--- a/lib/FeedParser.php
+++ b/lib/FeedParser.php
@@ -36,7 +36,7 @@ final class FeedParser
             $channel = $xml->channel[0];
             $feed['title'] = trim((string)$channel->title);
             $feed['uri'] = trim((string)$channel->link);
-            if (!empty($channel->image)) {
+            if (isset($channel->image->url)) {
                 $feed['icon'] = trim((string)$channel->image->url);
             }
             foreach ($xml->item as $item) {
@@ -47,7 +47,7 @@ final class FeedParser
             $channel = $xml->channel[0];
             $feed['title'] = trim((string)$channel->title);
             $feed['uri'] = trim((string)$channel->link);
-            if (!empty($channel->image)) {
+            if (isset($channel->image->url)) {
                 $feed['icon'] = trim((string)$channel->image->url);
             }
             foreach ($channel->item as $item) {
@@ -70,10 +70,10 @@ final class FeedParser
                     }
                 }
             }
-            if (!empty($xml->icon)) {
-                $feed['icon'] = (string)$xml->icon;
-            } elseif (!empty($xml->logo)) {
-                $feed['icon'] = (string)$xml->logo;
+            if (isset($xml->icon)) {
+                $feed['icon'] = (string) $xml->icon;
+            } elseif (isset($xml->logo)) {
+                $feed['icon'] = (string) $xml->logo;
             }
             foreach ($xml->entry as $item) {
                 $feed['items'][] = $this->parseAtomItem($item);
@@ -171,11 +171,7 @@ final class FeedParser
             if (in_array($namespaceName, ['', 'content', 'media'])) {
                 continue;
             }
-            $module = $feedItem->children($namespaceUrl);
-            $item[$namespaceName] = [];
-            foreach ($module as $moduleKey => $moduleValue) {
-                $item[$namespaceName][$moduleKey] = (string) $moduleValue;
-            }
+            $item[$namespaceName] = $this->parseModule($feedItem, $namespaceName, $namespaceUrl);
         }
         if (isset($namespaces['itunes'])) {
             $enclosure = $feedItem->enclosure;
@@ -185,43 +181,27 @@ final class FeedParser
                 'type'      => (string) $enclosure['type'],
             ];
         }
-        if (isset($feedItem->guid)) {
-            // Pluck out a url from guid
-            foreach ($feedItem->guid->attributes() as $attribute => $value) {
-                if (
-                    $attribute === 'isPermaLink'
-                    && (
-                        $value === 'true' || (
-                            filter_var($feedItem->guid, FILTER_VALIDATE_URL)
-                            && (empty($item['uri']) || !filter_var($item['uri'], FILTER_VALIDATE_URL))
-                        )
-                    )
-                ) {
-                    $item['uri'] = (string)$feedItem->guid;
-                    break;
+        if (!$item['uri']) {
+            // Let's use guid as uri if it's a permalink
+            if (isset($feedItem->guid)) {
+                foreach ($feedItem->guid->attributes() as $attribute => $value) {
+                    if ($attribute === 'isPermaLink' && ($value === 'true' || (filter_var($feedItem->guid, FILTER_VALIDATE_URL)))) {
+                        $item['uri'] = (string) $feedItem->guid;
+                        break;
+                    }
                 }
             }
         }
 
-        if (isset($feedItem->pubDate)) {
-            $item['timestamp'] = strtotime((string)$feedItem->pubDate);
-        } elseif (isset($dc->date)) {
-            $item['timestamp'] = strtotime((string)$dc->date);
-        }
+        $item['timestamp'] = $feedItem->pubDate ?? $dc->date ?? '';
+        $item['timestamp'] = strtotime((string) $item['timestamp']);
 
-        if (isset($feedItem->author)) {
-            $item['author'] = (string)$feedItem->author;
-        } elseif (isset($feedItem->creator)) {
-            $item['author'] = (string)$feedItem->creator;
-        } elseif (isset($dc->creator)) {
-            $item['author'] = (string)$dc->creator;
-        } elseif (isset($media->credit)) {
-            $item['author'] = (string)$media->credit;
-        }
+        $item['author'] = $feedItem->author ?? $feedItem->creator ?? $dc->creator ?? $media->credit ?? '';
+        $item['author'] = (string) $item['author'];
 
         if (isset($feedItem->enclosure) && !empty($feedItem->enclosure['url'])) {
             $item['enclosures'] = [
-                (string)$feedItem->enclosure['url'],
+                (string) $feedItem->enclosure['url'],
             ];
         }
         return $item;
@@ -261,4 +241,15 @@ final class FeedParser
         }
         return $item;
     }
+
+    private function parseModule(\SimpleXMLElement $element, string $namespaceName, string $namespaceUrl): array
+    {
+        $result = [];
+        $module = $element->children($namespaceUrl);
+        foreach ($module as $name => $value) {
+            // todo: add custom parsing if it's something other than a string
+            $result[$name] = (string) $value;
+        }
+        return $result;
+    }
 }
diff --git a/tests/FeedParserTest.php b/tests/FeedParserTest.php
index acd93e52..05d5ef69 100644
--- a/tests/FeedParserTest.php
+++ b/tests/FeedParserTest.php
@@ -125,4 +125,59 @@ class FeedParserTest extends TestCase
         $this->assertSame('root', $item['author']);
         $this->assertSame('html', $item['content']);
     }
+
+    public function testAppleItunesModule()
+    {
+        $xml = <<<XML
+        <?xml version="1.0" encoding="UTF-8"?>
+        <rss
+            version="2.0"
+            xmlns:atom="http://www.w3.org/2005/Atom"
+            xmlns:cc="http://web.resource.org/cc/"
+            xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd"
+            xmlns:media="http://search.yahoo.com/mrss/"
+            xmlns:content="http://purl.org/rss/1.0/modules/content/"
+            xmlns:podcast="https://podcastindex.org/namespace/1.0"
+            xmlns:googleplay="http://www.google.com/schemas/play-podcasts/1.0"
+            xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+        >
+            <channel>
+
+                <item>
+                    <itunes:duration>30:05</itunes:duration>
+                    <enclosure length="48123248" type="audio/mpeg" url="https://example.com/1.mp3" />
+                </item>
+            </channel>
+        </rss>
+        XML;
+
+        $sut = new \FeedParser();
+        $feed = $sut->parseFeed($xml);
+        $expected = [
+            'title' => '',
+            'uri' => '',
+            'icon' => '',
+            'items' => [
+                [
+                    'uri' => '',
+                    'title' => '',
+                    'content' => '',
+                    'timestamp' => '',
+                    'author' => '',
+                    'itunes' => [
+                        'duration' => '30:05',
+                    ],
+                    'enclosure' => [
+                        'url' => 'https://example.com/1.mp3',
+                        'length' => '48123248',
+                        'type' => 'audio/mpeg',
+                    ],
+                    'enclosures' => [
+                        'https://example.com/1.mp3',
+                    ],
+                ]
+            ],
+        ];
+        $this->assertEquals($expected, $feed);
+    }
 }

From b2c8475b2c789de8c70aab5ea7b5b0ae56a2a507 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Mon, 29 Jan 2024 21:51:23 +0100
Subject: [PATCH 288/716] fix(gates): json decoding (#3937)

---
 bridges/GatesNotesBridge.php | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/bridges/GatesNotesBridge.php b/bridges/GatesNotesBridge.php
index 0d919968..3381e096 100644
--- a/bridges/GatesNotesBridge.php
+++ b/bridges/GatesNotesBridge.php
@@ -20,12 +20,9 @@ class GatesNotesBridge extends BridgeAbstract
         $apiUrl = self::URI . $api_endpoint . http_build_query($params);
 
         $rawContent = getContents($apiUrl);
-        $cleanedContent = str_replace([
-            '<string xmlns="http://schemas.microsoft.com/2003/10/Serialization/">',
-            '</string>',
-        ], '', $rawContent);
-        // $cleanedContent = str_replace('\"', '"', $cleanedContent);
-        // $cleanedContent = trim($cleanedContent, '"');
+        $cleanedContent = trim($rawContent, '"');
+        $cleanedContent = str_replace('\r\n', "\n", $cleanedContent);
+        $cleanedContent = stripslashes($cleanedContent);
 
         $json = Json::decode($cleanedContent, false);
         if (is_string($json)) {

From d01c462ad514c327a82e92f269c139028de0a4f7 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Mon, 29 Jan 2024 21:51:34 +0100
Subject: [PATCH 289/716] fix(FeedExpander): if parse fails, include offending
 url in exception message (#3938)

Also some refactors
---
 actions/DetectAction.php            | 28 +++++++++++---------
 actions/FindfeedAction.php          |  6 ++---
 bridges/BMDSystemhausBlogBridge.php | 11 +++++---
 bridges/FirefoxAddonsBridge.php     | 40 ++++++++++++++---------------
 lib/FeedExpander.php                | 12 ++++++---
 5 files changed, 56 insertions(+), 41 deletions(-)

diff --git a/actions/DetectAction.php b/actions/DetectAction.php
index 99d299bb..0c61f1b6 100644
--- a/actions/DetectAction.php
+++ b/actions/DetectAction.php
@@ -4,14 +4,14 @@ class DetectAction implements ActionInterface
 {
     public function execute(Request $request)
     {
-        $targetURL = $request->get('url');
+        $url = $request->get('url');
         $format = $request->get('format');
 
-        if (!$targetURL) {
-            throw new \Exception('You must specify a url!');
+        if (!$url) {
+            return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'You must specify a url']));
         }
         if (!$format) {
-            throw new \Exception('You must specify a format!');
+            return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'You must specify a format']));
         }
 
         $bridgeFactory = new BridgeFactory();
@@ -23,19 +23,23 @@ class DetectAction implements ActionInterface
 
             $bridge = $bridgeFactory->create($bridgeClassName);
 
-            $bridgeParams = $bridge->detectParameters($targetURL);
+            $bridgeParams = $bridge->detectParameters($url);
 
-            if (is_null($bridgeParams)) {
+            if (!$bridgeParams) {
                 continue;
             }
 
-            $bridgeParams['bridge'] = $bridgeClassName;
-            $bridgeParams['format'] = $format;
-
-            $url = '?action=display&' . http_build_query($bridgeParams);
-            return new Response('', 301, ['location' => $url]);
+            $query = [
+                'action' => 'display',
+                'bridge' => $bridgeClassName,
+                'format' => $format,
+            ];
+            $query = array_merge($query, $bridgeParams);
+            return new Response('', 301, ['location' => '?' . http_build_query($query)]);
         }
 
-        throw new \Exception('No bridge found for given URL: ' . $targetURL);
+        return new Response(render(__DIR__ . '/../templates/error.html.php', [
+            'message' => 'No bridge found for given URL: ' . $url,
+        ]));
     }
 }
diff --git a/actions/FindfeedAction.php b/actions/FindfeedAction.php
index cd0a0c74..94dc6b72 100644
--- a/actions/FindfeedAction.php
+++ b/actions/FindfeedAction.php
@@ -9,10 +9,10 @@ class FindfeedAction implements ActionInterface
 {
     public function execute(Request $request)
     {
-        $targetURL = $request->get('url');
+        $url = $request->get('url');
         $format = $request->get('format');
 
-        if (!$targetURL) {
+        if (!$url) {
             return new Response('You must specify a url', 400);
         }
         if (!$format) {
@@ -29,7 +29,7 @@ class FindfeedAction implements ActionInterface
 
             $bridge = $bridgeFactory->create($bridgeClassName);
 
-            $bridgeParams = $bridge->detectParameters($targetURL);
+            $bridgeParams = $bridge->detectParameters($url);
 
             if ($bridgeParams === null) {
                 continue;
diff --git a/bridges/BMDSystemhausBlogBridge.php b/bridges/BMDSystemhausBlogBridge.php
index 327f165d..50ed4639 100644
--- a/bridges/BMDSystemhausBlogBridge.php
+++ b/bridges/BMDSystemhausBlogBridge.php
@@ -102,12 +102,17 @@ class BMDSystemhausBlogBridge extends BridgeAbstract
     //-----------------------------------------------------
     public function detectParameters($url)
     {
-        $parsed_url = parse_url($url);
-        if ($parsed_url['host'] != 'www.bmd.com') {
+        try {
+            $parsedUrl = Url::fromString($url);
+        } catch (UrlException $e) {
             return null;
         }
 
-        $path = explode('/', $parsed_url['path']);
+        if ($parsedUrl->getHost() != 'www.bmd.com') {
+            return null;
+        }
+
+        $path = explode('/', $parsedUrl->getPath());
 
         if ($this->getURIbyCountry($path[1]) == '') {
             return null;
diff --git a/bridges/FirefoxAddonsBridge.php b/bridges/FirefoxAddonsBridge.php
index c8fb10f8..fcf2ca02 100644
--- a/bridges/FirefoxAddonsBridge.php
+++ b/bridges/FirefoxAddonsBridge.php
@@ -19,23 +19,6 @@ class FirefoxAddonsBridge extends BridgeAbstract
     const CACHE_TIMEOUT = 3600;
 
     private $feedName = '';
-    private $releaseDateRegex = '/Released ([\w, ]+) - ([\w. ]+)/';
-    private $xpiFileRegex = '/([A-Za-z0-9_.-]+)\.xpi$/';
-    private $outgoingRegex = '/https:\/\/prod.outgoing\.prod\.webservices\.mozgcp\.net\/v1\/(?:[A-z0-9]+)\//';
-
-    private $urlRegex = '/addons\.mozilla\.org\/(?:[\w-]+\/)?firefox\/addon\/([\w-]+)/';
-
-    public function detectParameters($url)
-    {
-        $params = [];
-
-        if (preg_match($this->urlRegex, $url, $matches)) {
-            $params['id'] = $matches[1];
-            return $params;
-        }
-
-        return null;
-    }
 
     public function collectData()
     {
@@ -52,7 +35,8 @@ class FirefoxAddonsBridge extends BridgeAbstract
             $item['uri'] = $this->getURI();
             $item['author'] = $author;
 
-            if (preg_match($this->releaseDateRegex, $li->find('div.AddonVersionCard-fileInfo', 0)->plaintext, $match)) {
+            $releaseDateRegex = '/Released ([\w, ]+) - ([\w. ]+)/';
+            if (preg_match($releaseDateRegex, $li->find('div.AddonVersionCard-fileInfo', 0)->plaintext, $match)) {
                 $item['timestamp'] = $match[1];
                 $size = $match[2];
             }
@@ -68,7 +52,8 @@ class FirefoxAddonsBridge extends BridgeAbstract
 
             $releaseNotes = $this->removeLinkRedirects($li->find('div.AddonVersionCard-releaseNotes', 0));
 
-            if (preg_match($this->xpiFileRegex, $downloadlink, $match)) {
+            $xpiFileRegex = '/([A-Za-z0-9_.-]+)\.xpi$/';
+            if (preg_match($xpiFileRegex, $downloadlink, $match)) {
                 $xpiFilename = $match[0];
             }
 
@@ -110,10 +95,25 @@ EOD;
      */
     private function removeLinkRedirects($html)
     {
+        $outgoingRegex = '/https:\/\/prod.outgoing\.prod\.webservices\.mozgcp\.net\/v1\/(?:[A-z0-9]+)\//';
         foreach ($html->find('a') as $a) {
-            $a->href = urldecode(preg_replace($this->outgoingRegex, '', $a->href));
+            $a->href = urldecode(preg_replace($outgoingRegex, '', $a->href));
         }
 
         return $html->innertext;
     }
+
+    public function detectParameters($url)
+    {
+        $params = [];
+
+        // Example: https://addons.mozilla.org/en-US/firefox/addon/ublock-origin
+        $pattern = '/addons\.mozilla\.org\/(?:[\w-]+\/)?firefox\/addon\/([\w-]+)/';
+        if (preg_match($pattern, $url, $matches)) {
+            $params['id'] = $matches[1];
+            return $params;
+        }
+
+        return null;
+    }
 }
diff --git a/lib/FeedExpander.php b/lib/FeedExpander.php
index be3a8ca4..abe964e1 100644
--- a/lib/FeedExpander.php
+++ b/lib/FeedExpander.php
@@ -23,14 +23,20 @@ abstract class FeedExpander extends BridgeAbstract
             throw new \Exception(sprintf('Unable to parse xml from `%s` because we got the empty string', $url), 10);
         }
         // prepare/massage the xml to make it more acceptable
-        $badStrings = [
+        $problematicStrings = [
             '&nbsp;',
             '&raquo;',
             '&rsquo;',
         ];
-        $xmlString = str_replace($badStrings, '', $xmlString);
+        $xmlString = str_replace($problematicStrings, '', $xmlString);
+
         $feedParser = new FeedParser();
-        $this->feed = $feedParser->parseFeed($xmlString);
+        try {
+            $this->feed = $feedParser->parseFeed($xmlString);
+        } catch (\Exception $e) {
+            throw new \Exception(sprintf('Failed to parse xml from %s: %s', $url, create_sane_exception_message($e)));
+        }
+
         $items = array_slice($this->feed['items'], 0, $maxItems);
         // todo: extract parse logic out from FeedParser
         foreach ($items as $item) {

From 8423c5260658b007f394d075087412057d0bd8ef Mon Sep 17 00:00:00 2001
From: Alexandre Alapetite <alexandre.alapetite@alexandra.dk>
Date: Thu, 1 Feb 2024 16:57:14 +0100
Subject: [PATCH 290/716] Fix Docker exec (#3941)

fix https://github.com/RSS-Bridge/rss-bridge/issues/3940
---
 docker-entrypoint.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docker-entrypoint.sh b/docker-entrypoint.sh
index 8dde842c..f92d8b21 100755
--- a/docker-entrypoint.sh
+++ b/docker-entrypoint.sh
@@ -42,4 +42,4 @@ fi
 nginx
 
 # php-fpm should not daemonize
-php-fpm8.2 --nodaemonize
+exec php-fpm8.2 --nodaemonize

From 81be72ea04c60b27a2a078a8802a88d9d1b6ee3a Mon Sep 17 00:00:00 2001
From: Clemens Neubauer <cn-tools@gmx.at>
Date: Fri, 2 Feb 2024 15:33:59 +0100
Subject: [PATCH 291/716] Update BMDSystemhausBlogBridge.php (#3943)

---
 bridges/BMDSystemhausBlogBridge.php | 82 +++++++++++++++++++++--------
 1 file changed, 61 insertions(+), 21 deletions(-)

diff --git a/bridges/BMDSystemhausBlogBridge.php b/bridges/BMDSystemhausBlogBridge.php
index 50ed4639..c80f3ff3 100644
--- a/bridges/BMDSystemhausBlogBridge.php
+++ b/bridges/BMDSystemhausBlogBridge.php
@@ -6,7 +6,17 @@ class BMDSystemhausBlogBridge extends BridgeAbstract
     const NAME = 'BMD SYSTEMHAUS GesmbH';
     const CACHE_TIMEOUT = 21600; //6h
     const URI = 'https://www.bmd.com';
-    const DESCRIPTION = 'BMD Systemhaus - Blog';
+    const DONATION_URI = 'https://paypal.me/cntools';
+    const DESCRIPTION = 'BMD Systemhaus - We make business easy';
+
+    const ITEMSTYLE = [
+        'ilcr' => '<table width="100%"><tr><td style="vertical-align: top;">{data_img}</td><td style="vertical-align: top;">{data_content}</td></tr></table>',
+        'clir' => '<table width="100%"><tr><td style="vertical-align: top;">{data_content}</td><td style="vertical-align: top;">{data_img}</td></tr></table>',
+        'itcb' => '<div>{data_img}<br />{data_content}</div>',
+        'ctib' => '<div>{data_content}<br />{data_img}</div>',
+        'co' => '{data_content}',
+        'io' => '{data_img}'
+    ];
 
     const PARAMETERS = [
         'Blog' => [
@@ -19,8 +29,22 @@ class BMDSystemhausBlogBridge extends BridgeAbstract
                     'Schweiz' => 'ch',
                     'Slovensko' => 'sk',
                     'Cesko' => 'cz',
-                    'Hungary' => 'hu'
-                ]
+                    'Hungary' => 'hu',
+                ],
+                'defaultValue' => 'at',
+            ],
+            'style' => [
+                'name' => 'Style',
+                'type' => 'list',
+                'values' => [
+                    'Image left, content right' => 'ilcr',
+                    'Content left, image right' => 'clir',
+                    'Image top, content bottom' => 'itcb',
+                    'Content top, image bottom' => 'ctib',
+                    'Content only' => 'co',
+                    'Image only' => 'io',
+                ],
+                'defaultValue' => 'ilcr',
             ]
         ]
     ];
@@ -28,35 +52,50 @@ class BMDSystemhausBlogBridge extends BridgeAbstract
     //-----------------------------------------------------
     public function collectData()
     {
-/*
-        $item['uri']        // URI to reach the subject ("https://...")
-        $item['title']      // Title of the item
-        $item['timestamp']  // Timestamp of the item in numeric or text format (compatible for strtotime())
-        $item['author']     // Name of the author for this item
-        $item['content']    // Content in HTML format
-        $item['enclosures'] // Array of URIs to an attachments (pictures, files, etc...)
-        $item['categories'] // Array of categories / tags / topics
-        $item['uid']        // A unique ID to identify the current item
-*/
+        // get website content
+        $html = getSimpleHTMLDOM($this->getURI()) or returnServerError('No contents received!');
 
-        $html = getSimpleHTMLDOM($this->getURI());
+        // Convert relative links in HTML into absolute links
+        $html = defaultLinkTo($html, self::URI);
+
+        // Convert lazy-loading images and frames (video embeds) into static elements
+        $html = convertLazyLoading($html);
 
         foreach ($html->find('div#bmdNewsList div#bmdNewsList-Item') as $element) {
             $itemScope = $element->find('div[itemscope=itemscope]', 0);
 
             $item = [];
+
+            // set base article data
             $item['title'] = $this->getMetaItemPropContent($itemScope, 'headline');
-            $item['content'] = $this->getMetaItemPropContent($itemScope, 'description');
             $item['timestamp'] = strtotime($this->getMetaItemPropContent($itemScope, 'datePublished'));
-
             $item['author'] = $this->getMetaItemPropContent($itemScope->find('div[itemprop=author]', 0), 'name');
-            $item['enclosures'] = [self::URI . $element->find('div.mediaelement.mediaelement-image img', 0)->src];
 
-            $link = $element->find('div#bmdNewsList-Text div#bmdNewsList-Title a', 0);
-            if (!is_null($link)) {
-                $item['uri'] = self::URI . $link->href;
+            // find article image
+            $imageTag = '';
+            $image = $element->find('div.mediaelement.mediaelement-image img', 0);
+            if ((!is_null($image)) and ($image->src != '')) {
+                $item['enclosures'] = [$image->src];
+                $imageTag = '<img src="' . $image->src . '"/>';
             }
 
+            // begin with right style
+            $content = self::ITEMSTYLE[$this->getInput('style')];
+
+            // render placeholder
+            $content = str_replace('{data_content}', $this->getMetaItemPropContent($itemScope, 'description'), $content);
+            $content = str_replace('{data_img}', $imageTag, $content);
+
+            // set finished content
+            $item['content'] = $content;
+
+            // get link to article
+            $link = $element->find('div#bmdNewsList-Text div#bmdNewsList-Title a', 0);
+            if (!is_null($link)) {
+                $item['uri'] = $link->href;
+            }
+
+            // init categories
             $categories = [];
             $tmpOne = [];
             $tmpTwo = [];
@@ -80,7 +119,7 @@ class BMDSystemhausBlogBridge extends BridgeAbstract
                 $categories = array_merge($categories, $tmpData);
             }
 
-            // trim all entries
+            // trim each categorie entries
             $categories = array_map('trim', $categories);
 
             // remove empty entries
@@ -93,6 +132,7 @@ class BMDSystemhausBlogBridge extends BridgeAbstract
                 $item['categories'] = $categories;
             }
 
+            // add item
             if (($item['title'] != '') and ($item['content'] != '') and ($item['uri'] != '')) {
                 $this->items[] = $item;
             }

From b964dcd93677d4e32df0ec7dd688791d3e6b3a75 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 2 Feb 2024 18:06:08 +0100
Subject: [PATCH 292/716] fix: early warning if file permission problem (#3944)

---
 README.md | 6 ++++++
 index.php | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/README.md b/README.md
index 138962f2..6fa39b95 100644
--- a/README.md
+++ b/README.md
@@ -255,6 +255,12 @@ Learn more in
 
 ## How-to
 
+### How to fix "Access denied."
+
+Output is from php-fpm. It is unable to read index.php.
+
+    chown rss-bridge:rss-bridge /var/www/rss-bridge/index.php
+
 ### How to password-protect the instance (token)
 
 Modify `config.ini.php`:
diff --git a/index.php b/index.php
index 56a94ac6..7144ae27 100644
--- a/index.php
+++ b/index.php
@@ -6,6 +6,12 @@ if (version_compare(\PHP_VERSION, '7.4.0') === -1) {
     exit;
 }
 
+if (! is_readable(__DIR__ . '/lib/bootstrap.php')) {
+    http_response_code(500);
+    print 'Unable to read lib/bootstrap.php. Check file permissions.';
+    exit;
+}
+
 require_once __DIR__ . '/lib/bootstrap.php';
 
 set_exception_handler(function (\Throwable $e) {

From ca87562cab076e230e80a1007f0e9229e1469cc2 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 2 Feb 2024 18:22:10 +0100
Subject: [PATCH 293/716] fix: prepare release (#3945)

---
 README.md              | 4 ++--
 config.default.ini.php | 1 -
 lib/Configuration.php  | 2 +-
 3 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 6fa39b95..cadba3b9 100644
--- a/README.md
+++ b/README.md
@@ -106,11 +106,11 @@ server {
     error_log /var/log/nginx/rss-bridge.error.log;
 
     # Intentionally not setting a root folder here
-        
+
     # autoindex is off by default but feels good to explicitly turn off
     autoindex off;
 
-    # Static content only served here 
+    # Static content only served here
     location /static/ {
         alias /var/www/rss-bridge/static/;
     }
diff --git a/config.default.ini.php b/config.default.ini.php
index 91a4c4fe..7729afcb 100644
--- a/config.default.ini.php
+++ b/config.default.ini.php
@@ -21,7 +21,6 @@ enabled_bridges[] = Telegram
 enabled_bridges[] = ThePirateBay
 enabled_bridges[] = TikTokBridge
 enabled_bridges[] = Twitch
-enabled_bridges[] = Twitter
 enabled_bridges[] = Vk
 enabled_bridges[] = XPathBridge
 enabled_bridges[] = Youtube
diff --git a/lib/Configuration.php b/lib/Configuration.php
index ab1c9cdf..63f67a3c 100644
--- a/lib/Configuration.php
+++ b/lib/Configuration.php
@@ -7,7 +7,7 @@
  */
 final class Configuration
 {
-    private const VERSION = '2023-09-24';
+    private const VERSION = '2024-02-02';
 
     private static $config = [];
 

From a14508d79b45f8d589051d845f016c7d63540238 Mon Sep 17 00:00:00 2001
From: "ljf (zamentur)" <zamentur@users.noreply.github.com>
Date: Sat, 3 Feb 2024 12:58:36 +0100
Subject: [PATCH 294/716] Add sans-nuage instance (#3947)

---
 docs/01_General/06_Public_Hosts.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/01_General/06_Public_Hosts.md b/docs/01_General/06_Public_Hosts.md
index 4aa905da..1d59d918 100644
--- a/docs/01_General/06_Public_Hosts.md
+++ b/docs/01_General/06_Public_Hosts.md
@@ -5,6 +5,7 @@
 | ![](https://iplookup.flagfox.net/images/h16/GB.png) | https://rss-bridge.org/bridge01 | ![](https://img.shields.io/website/https/rss-bridge.org/bridge01.svg) | [@dvikan](https://github.com/dvikan) | London, Digital Ocean|
 | ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://rssbridge.flossboxin.org.in/ | ![](https://img.shields.io/badge/website-up-brightgreen) | [@vdbhb59](https://github.com/vdbhb59) | Hosted with OVH SAS (Maintained in India) |
 | ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://rss-bridge.cheredeprince.net/ | ![](https://img.shields.io/website/https/rss-bridge.cheredeprince.net) | [@La_Bécasse](https://cheredeprince.net/contact) | Self-Hosted at home in France |
+| ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://rss-bridge.sans-nuage.fr | ![](https://img.shields.io/website/https/rss-bridge.sans-nuage.fr) | [@Alsace Réseau Neutre](https://arn-fai.net/contact) | Hosted in Alsace, France |
 | ![](https://iplookup.flagfox.net/images/h16/GB.png) | https://rss-bridge.lewd.tech | ![](https://img.shields.io/website/https/rss-bridge.lewd.tech.svg) | [@Erisa](https://github.com/Erisa) | Hosted in London, protected by Cloudflare Rate Limiting |
 | ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://bridge.easter.fr | ![](https://img.shields.io/website/https/bridge.easter.fr.svg) | [@chatainsim](https://github.com/chatainsim) | Hosted in Isère, France |
 | ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://wtf.roflcopter.fr/rss-bridge/ | ![](https://img.shields.io/website/https/wtf.roflcopter.fr/rss-bridge.svg) | [roflcopter.fr](https://wtf.roflcopter.fr/) | Hosted in France |

From 7c89712837fd35f6ec12d4652201d54b443ce73c Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 3 Feb 2024 13:56:56 +0100
Subject: [PATCH 295/716] ci: fix broken docs build (#3948)

---
 docs/10_Bridge_Specific/FacebookBridge.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/10_Bridge_Specific/FacebookBridge.md b/docs/10_Bridge_Specific/FacebookBridge.md
index f24f8aa8..665b802f 100644
--- a/docs/10_Bridge_Specific/FacebookBridge.md
+++ b/docs/10_Bridge_Specific/FacebookBridge.md
@@ -4,7 +4,7 @@ State of this bridge:
 - Facebook Groups (and probably other sections too) do not work at all
 - No maintainer
 - Needs cookie consent support for public pages
-- Needs login support (see [this example]([url](https://github.com/RSS-Bridge/rss-bridge/issues/1891)) for Instagram) for private groups
+- Needs login support see [this example](https://github.com/RSS-Bridge/rss-bridge/issues/1891) for Instagram) for private groups
 
 Due to the 2020 [Facebook redesign](https://engineering.fb.com/2020/05/08/web/facebook-redesign/)
 and the requirement to [accept cookies](https://www.facebook.com/business/help/348535683460989)

From d175bab58e3afd63140791446b01dd36837fe2d8 Mon Sep 17 00:00:00 2001
From: Tostiman <18124323+t0stiman@users.noreply.github.com>
Date: Sun, 4 Feb 2024 18:28:12 +0100
Subject: [PATCH 296/716] Fix car throttle bridge (#3925)

---
 bridges/CarThrottleBridge.php    | 118 +++++++++++++++++++++++++------
 bridges/HardwareInfoBridge.php   |   1 +
 bridges/RaceDepartmentBridge.php |   1 +
 3 files changed, 99 insertions(+), 21 deletions(-)

diff --git a/bridges/CarThrottleBridge.php b/bridges/CarThrottleBridge.php
index 70d7b54e..0a05ee60 100644
--- a/bridges/CarThrottleBridge.php
+++ b/bridges/CarThrottleBridge.php
@@ -6,46 +6,122 @@ class CarThrottleBridge extends BridgeAbstract
     const URI = 'https://www.carthrottle.com/';
     const DESCRIPTION = 'Get the latest car-related news from Car Throttle.';
     const MAINTAINER = 't0stiman';
+    const DONATION_URI = 'https://ko-fi.com/tostiman';
+
+    const PARAMETERS = [
+        'Show articles from these categories:' => [
+            'news' => [
+                'name' => 'news',
+                'type' => 'checkbox'
+            ],
+            'reviews' => [
+                'name' => 'reviews',
+                'type' => 'checkbox'
+            ],
+            'features' => [
+                'name' => 'features',
+                'type' => 'checkbox'
+            ],
+            'videos' => [
+                'name' => 'videos',
+                'type' => 'checkbox'
+            ],
+            'gaming' => [
+                'name' => 'gaming',
+                'type' => 'checkbox'
+            ]
+        ]
+    ];
 
     public function collectData()
     {
-        $news = getSimpleHTMLDOMCached(self::URI . 'news');
+        $this->items = [];
 
-        $this->items[] = [];
+        $this->handleCategory('news');
+        $this->handleCategory('reviews');
+        $this->handleCategory('features');
+        $this->handleCategory2('videos', 'video');
+        $this->handleCategory('gaming');
+    }
+
+    private function handleCategory($category)
+    {
+        if ($this->getInput($category)) {
+            $this->getArticles($category);
+        }
+    }
+
+    private function handleCategory2($categoryParameter, $categoryURLname)
+    {
+        if ($this->getInput($categoryParameter)) {
+            $this->getArticles($categoryURLname);
+        }
+    }
+
+    private function getArticles($category)
+    {
+        $categoryPage = getSimpleHTMLDOMCached(self::URI . $category);
 
         //for each post
-        foreach ($news->find('div.cmg-card') as $post) {
+        foreach ($categoryPage->find('div.cmg-card') as $post) {
             $item = [];
 
-            $titleElement = $post->find('div.title a.cmg-link')[0];
-            $item['uri'] = self::URI . $titleElement->getAttribute('href');
+            $titleElement = $post->find('div.title a')[0];
+            $post_uri = self::URI . $titleElement->getAttribute('href');
+
+            if (!isset($post_uri) || $post_uri == '') {
+                continue;
+            }
+
+            $item['uri'] = $post_uri;
             $item['title'] = $titleElement->innertext;
 
             $articlePage = getSimpleHTMLDOMCached($item['uri']);
 
-            $authorDiv = $articlePage->find('div.author div');
-            if ($authorDiv) {
-                $item['author'] = $authorDiv[1]->innertext;
-            }
+            $item['author'] = $this->parseAuthor($articlePage);
+
+            $articleElement = $articlePage->find('article')[0];
 
-            $dinges = $articlePage->find('div.main-body')[0] ?? null;
             //remove ads
-            if ($dinges) {
-                foreach ($dinges->find('aside') as $ad) {
-                    $ad->outertext = '';
-                    $dinges->save();
-                }
+            foreach ($articleElement->find('aside') as $ad) {
+                $ad->outertext = '';
             }
 
-            $var = $articlePage->find('div.summary')[0] ?? '';
-            $var1 = $articlePage->find('figure.main-image')[0] ?? '';
-            $dinges1 = $dinges ?? '';
+            $summary = $articleElement->find('div.summary')[0];
 
-            $item['content'] = $var .
-                $var1 .
-                $dinges1;
+            //remove header so we are left with the article content
+            foreach ($articleElement->find('header') as $found) {
+                $found->outertext = '';
+            }
+
+            //remove comments (registering on carthrottle.com is impossible so the comment sections are empty anyway)
+            foreach ($articleElement->find('#lbs-comments') as $found) {
+                $found->outertext = '';
+            }
+
+            //these are supposed to be hidden
+            foreach ($articleElement->find('.visually-hidden') as $found) {
+                $found->outertext = '';
+            }
+
+            $item['content'] = $summary . $articleElement;
 
             array_push($this->items, $item);
         }
     }
+
+    private function parseAuthor($articlePage)
+    {
+        $authorDivs = $articlePage->find('div address');
+        if (!$authorDivs) {
+            return '';
+        }
+
+        $a = $authorDivs[0]->find('a');
+        if ($a) {
+            return $a->innertext;
+        }
+
+        return $authorDivs[0]->innertext;
+    }
 }
diff --git a/bridges/HardwareInfoBridge.php b/bridges/HardwareInfoBridge.php
index 5970ecd0..dc32c33a 100644
--- a/bridges/HardwareInfoBridge.php
+++ b/bridges/HardwareInfoBridge.php
@@ -6,6 +6,7 @@ class HardwareInfoBridge extends FeedExpander
     const URI = 'https://nl.hardware.info/';
     const DESCRIPTION = 'Tech news from hardware.info (Dutch)';
     const MAINTAINER = 't0stiman';
+    const DONATION_URI = 'https://ko-fi.com/tostiman';
 
     public function collectData()
     {
diff --git a/bridges/RaceDepartmentBridge.php b/bridges/RaceDepartmentBridge.php
index 7390761f..a601b4d6 100644
--- a/bridges/RaceDepartmentBridge.php
+++ b/bridges/RaceDepartmentBridge.php
@@ -6,6 +6,7 @@ class RaceDepartmentBridge extends FeedExpander
     const URI = 'https://racedepartment.com/';
     const DESCRIPTION = 'Get the latest (sim)racing news from RaceDepartment.';
     const MAINTAINER = 't0stiman';
+    const DONATION_URI = 'https://ko-fi.com/tostiman';
 
     public function collectData()
     {

From 7931f37a835b3fd39093fd7de15f1b2a0263747d Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Mon, 5 Feb 2024 23:30:18 +0100
Subject: [PATCH 297/716] [PepperBridgeAbstract] Fix deal image scraping
 (#3953)

Deal Image was moved to a vuejs element, the deal image scraping was
fixed.
---
 bridges/PepperBridgeAbstract.php | 34 +++-----------------------------
 1 file changed, 3 insertions(+), 31 deletions(-)

diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index 73bd194d..45bfe209 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -437,37 +437,9 @@ HEREDOC;
      */
     private function getImage($deal)
     {
-        $selectorLazy = implode(
-            ' ', /* Notice this is a space! */
-            [
-                'thread-image',
-                'width--all-auto',
-                'height--all-auto',
-                'imgFrame-img',
-                'img--dummy',
-                'js-lazy-img'
-            ]
-        );
-
-        $selectorPlain = implode(
-            ' ', /* Notice this is a space! */
-            [
-                'thread-image',
-                'width--all-auto',
-                'height--all-auto',
-                'imgFrame-img',
-            ]
-        );
-        if ($deal->find('img[class=' . $selectorLazy . ']', 0) != null) {
-            return json_decode(
-                html_entity_decode(
-                    $deal->find('img[class=' . $selectorLazy . ']', 0)
-                        ->getAttribute('data-lazy-img')
-                )
-            )->{'src'};
-        } else {
-            return $deal->find('img[class*=' . $selectorPlain . ']', 0)->src ?? '';
-        }
+        // Get thread Image JSON content
+        $content = Json::decode($deal->find('div[class*=threadGrid-image]', 0)->find('div[class=js-vue2]', 0)->getAttribute('data-vue2'));
+        return $content['props']['threadImageUrl'];
     }
 
     /**

From 66a6847fd09c90e1cecccce38cdeb61f3e48675a Mon Sep 17 00:00:00 2001
From: Scott Colby <scolby33@users.noreply.github.com>
Date: Mon, 5 Feb 2024 20:21:30 -0500
Subject: [PATCH 298/716] Two fixes to DeutscheWelle (#3954)

* [DeutscheWelleBridge] Small URL fix.

Reset the $item's uri value after removing the tracking query string.

* [DeutscheWelleBridge] Fix "hero" images.

The main "hero" image for each article has src="" and relies on the
srcset attribute for the browser to pick the best image based on the
actual displayed size.

The call to `defaultLinkTo()` replaces the empty src with the article's
link, which, not being an image, breaks the image.

This change resets the src's of any such images back to "".
---
 bridges/DeutscheWelleBridge.php | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/bridges/DeutscheWelleBridge.php b/bridges/DeutscheWelleBridge.php
index 29b478b9..51214320 100644
--- a/bridges/DeutscheWelleBridge.php
+++ b/bridges/DeutscheWelleBridge.php
@@ -73,12 +73,12 @@ class DeutscheWelleBridge extends FeedExpander
 
     protected function parseItem(array $item)
     {
-        $parsedUrl = parse_url($item['uri']);
-        unset($parsedUrl['query']);
-        $url = $this->unparseUrl($parsedUrl);
+        $parsedUri = parse_url($item['uri']);
+        unset($parsedUri['query']);
+        $item['uri'] = $this->unparseUrl($parsedUri);
 
-        $page = getSimpleHTMLDOM($url);
-        $page = defaultLinkTo($page, $url);
+        $page = getSimpleHTMLDOM($item['uri']);
+        $page = defaultLinkTo($page, $item['uri']);
 
         $article = $page->find('article', 0);
 
@@ -112,6 +112,13 @@ class DeutscheWelleBridge extends FeedExpander
             $img->height = null;
         }
 
+        // remove bad img src's added by defaultLinkTo() above
+        // these images should have src="" and will then use
+        // the srcset attribute to load the best image for the displayed size
+        foreach ($article->find('figure > picture > img') as $img) {
+            $img->src = '';
+        }
+
         // replace lazy-loaded images
         foreach ($article->find('figure.placeholder-image') as $figure) {
             $img = $figure->find('img', 0);

From 64f95b4990c5b890eb526af1990205cbef5ac77a Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Tue, 6 Feb 2024 02:23:12 +0100
Subject: [PATCH 299/716] 
 [PepperBridgeAbstract,DealabsBridge,HotUKDealsBridge,MydealsBridge] Fix
 missing price, discount and ships from information (#3956)

- DealabsBridge
- HotUKDealsBridge
- MydealsBridge
Add the currency in the i8n data of the bridges

- PepperBridgeAbstract
The Price, discount data ans Ships from information are in the HTML
content anymore, so switched to the js-vue2 attributes
---
 bridges/DealabsBridge.php        |  1 +
 bridges/HotUKDealsBridge.php     |  1 +
 bridges/MydealsBridge.php        |  1 +
 bridges/PepperBridgeAbstract.php | 69 ++++++++++++++------------------
 4 files changed, 32 insertions(+), 40 deletions(-)

diff --git a/bridges/DealabsBridge.php b/bridges/DealabsBridge.php
index 4d39502c..a5a3771b 100644
--- a/bridges/DealabsBridge.php
+++ b/bridges/DealabsBridge.php
@@ -1914,6 +1914,7 @@ class DealabsBridge extends PepperBridgeAbstract
         'request-error' => 'Impossible de joindre Dealabs',
         'thread-error' => 'Impossible de déterminer l\'ID de la discussion. Vérifiez l\'URL que vous avez entré',
         'no-results' => 'Il n&#039;y a rien à afficher pour le moment :(',
+        'currency' => '€',
         'relative-date-indicator' => [
             'il y a',
         ],
diff --git a/bridges/HotUKDealsBridge.php b/bridges/HotUKDealsBridge.php
index a7e62250..44da417a 100644
--- a/bridges/HotUKDealsBridge.php
+++ b/bridges/HotUKDealsBridge.php
@@ -3278,6 +3278,7 @@ class HotUKDealsBridge extends PepperBridgeAbstract
         'request-error' => 'Could not request HotUKDeals',
         'thread-error' => 'Unable to determine the thread ID. Check the URL you entered',
         'no-results' => 'Ooops, looks like we could',
+        'currency' => '£',
         'relative-date-indicator' => [
             'ago',
         ],
diff --git a/bridges/MydealsBridge.php b/bridges/MydealsBridge.php
index d7e074a9..dda3d2a9 100644
--- a/bridges/MydealsBridge.php
+++ b/bridges/MydealsBridge.php
@@ -2025,6 +2025,7 @@ class MydealsBridge extends PepperBridgeAbstract
         'request-error' => 'Could not request mydeals',
         'thread-error' => 'Die ID der Diskussion kann nicht ermittelt werden. Überprüfen Sie die eingegebene URL',
         'no-results' => 'Ups, wir konnten nichts',
+        'currency' => '€',
         'relative-date-indicator' => [
             'vor',
             'seit'
diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index 45bfe209..2516fc1e 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -113,8 +113,8 @@ class PepperBridgeAbstract extends BridgeAbstract
                     . $this->getImage($deal)
                     . '"/></td><td>'
                     . $this->getHTMLTitle($item)
-                    . $this->getPrice($deal)
-                    . $this->getDiscount($deal)
+                    . $this->getPrice($jsonDealData)
+                    . $this->getDiscount($jsonDealData)
                     . $this->getShipsFrom($deal)
                     . $this->getShippingCost($deal)
                     . $this->getSource($jsonDealData)
@@ -273,20 +273,12 @@ HEREDOC;
      * Get the Price from a Deal if it exists
      * @return string String of the deal price
      */
-    private function getPrice($deal)
+    private function getPrice($jsonDealData)
     {
-        if (
-            $deal->find(
-                'span[class*=thread-price]',
-                0
-            ) != null
-        ) {
-            return '<div>' . $this->i8n('price') . ' : '
-                . $deal->find(
-                    'span[class*=thread-price]',
-                    0
-                )->plaintext
-                . '</div>';
+        if ($jsonDealData['props']['thread']['discountType'] == null) {
+            $price = $jsonDealData['props']['thread']['price'];
+                return '<div>' . $this->i8n('price') . ' : '
+                . $price . ' ' . $this->i8n('currency') . '</div>';
         } else {
             return '';
         }
@@ -409,23 +401,22 @@ HEREDOC;
      * Get the original Price and discout from a Deal if it exists
      * @return string String of the deal original price and discount
      */
-    private function getDiscount($deal)
+    private function getDiscount($jsonDealData)
     {
-        if ($deal->find('span[class*=mute--text text--lineThrough]', 0) != null) {
-            $discountHtml = $deal->find('span[class=space--ml-1 size--all-l size--fromW3-xl]', 0);
-            if ($discountHtml != null) {
-                $discount = $discountHtml->plaintext;
-            } else {
-                $discount = '';
+        $oldPrice = $jsonDealData['props']['thread']['nextBestPrice'];
+        $newPrice = $jsonDealData['props']['thread']['price'];
+        $percentage = $jsonDealData['props']['thread']['percentage'];
+
+        if ($oldPrice != 0) {
+            // If there is no percentage calculated, then calculate it manually
+            if ($percentage == 0) {
+                $percentage = round(100 - ($newPrice * 100 / $oldPrice), 2);
             }
             return '<div>' . $this->i8n('discount') . ' : <span style="text-decoration: line-through;">'
-                . $deal->find(
-                    'span[class*=mute--text text--lineThrough]',
-                    0
-                )->plaintext
-                . '</span>&nbsp;'
-                . $discount
-                . '</div>';
+                . $oldPrice . ' ' . $this->i8n('currency')
+                . '</span>&nbsp; -'
+                . $percentage
+                . ' %</div>';
         } else {
             return '';
         }
@@ -448,19 +439,17 @@ HEREDOC;
      */
     private function getShipsFrom($deal)
     {
-        $selector = implode(
-            ' ', /* Notice this is a space! */
-            [
-                'hide--toW2',
-                'metaRibbon',
-            ]
-        );
-        if ($deal->find('span[class*=' . $selector . ']', 0) != null) {
-            $children = $deal->find('span[class*=' . $selector . ']', 0)->children(2);
-            if ($children) {
-                return '<div>' . $children->plaintext . '</div>';
+        $dealMeta = Json::decode($deal->find('div[class=threadGrid-headerMeta]', 0)->find('div[class=js-vue2]', 1)->getAttribute('data-vue2'));
+        $metas = $dealMeta['props']['metaRibbons'];
+        $shipsFrom = null;
+        foreach ($metas as $meta) {
+            if ($meta['type'] == 'dispatched-from') {
+                $shipsFrom = $meta['text'];
             }
         }
+        if ($shipsFrom != null) {
+            return '<div>' . $shipsFrom . '</div>';
+        }
         return '';
     }
 

From 6878eb26aa97413ad6f04e8d15f831c65f964c32 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 6 Feb 2024 19:32:05 +0100
Subject: [PATCH 300/716] fix: changed dom (#3958)

---
 bridges/ManyVidsBridge.php | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/bridges/ManyVidsBridge.php b/bridges/ManyVidsBridge.php
index df4996e6..21ad950f 100644
--- a/bridges/ManyVidsBridge.php
+++ b/bridges/ManyVidsBridge.php
@@ -29,19 +29,20 @@ class ManyVidsBridge extends BridgeAbstract
         } else {
             throw new \Exception('nope');
         }
-
         $url = sprintf('https://www.manyvids.com/Profile/%s/Store/Videos/', $profile);
         $dom = getSimpleHTMLDOM($url);
-        $el = $dom->find('section[id="app-store-videos"]', 0);
-        $json = $el->getAttribute('data-store-videos');
-        $json = html_entity_decode($json);
-        $data = Json::decode($json, false);
-        foreach ($data->content->items as $item) {
+        $videos = $dom->find('div[class^="ProfileTabGrid_card"]');
+        foreach ($videos as $item) {
+            $a = $item->find('a', 1);
+            $uri = 'https://www.manyvids.com' . $a->href;
+            if (preg_match('#Video/(\d+)/#', $uri, $m)) {
+                $uid = 'manyvids/' . $m[1];
+            }
             $this->items[] = [
-                'title' => $item->title,
-                'uri' => 'https://www.manyvids.com' . $item->preview->path,
-                'uid' => 'manyvids/' . $item->id,
-                'content' => sprintf('<img src="%s">', $item->videoThumb),
+                'title'     => $a->plaintext,
+                'uri'       => $uri,
+                'uid'       => $uid ?? $uri,
+                'content'   => $item->innertext,
             ];
         }
     }

From 6bb04d48ed80a328174e071f064c6336f1b01fe1 Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Thu, 8 Feb 2024 00:03:25 +0530
Subject: [PATCH 301/716] [KilledbyMicrosoftBridge] New Bridge (#3961)

---
 bridges/KilledbyMicrosoftBridge.php | 61 +++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 bridges/KilledbyMicrosoftBridge.php

diff --git a/bridges/KilledbyMicrosoftBridge.php b/bridges/KilledbyMicrosoftBridge.php
new file mode 100644
index 00000000..8779f0ae
--- /dev/null
+++ b/bridges/KilledbyMicrosoftBridge.php
@@ -0,0 +1,61 @@
+<?php
+
+class KilledbyMicrosoftBridge extends BridgeAbstract
+{
+    const NAME = 'Killed by Microsoft Bridge';
+    const URI = 'https://killedbymicrosoft.info';
+    const DESCRIPTION = 'Lists recently discontinued Microsoft products';
+    const MAINTAINER = 'tillcash';
+
+    public function collectData()
+    {
+        // Fetch JSON data
+        $json = getContents('https://killedbymicrosoft.info/graveyard.json');
+
+        // Decode JSON data
+        $discontinuedServices = json_decode($json, true);
+
+        // Sort the array based on dateClose in descending order
+        usort($discontinuedServices, function ($a, $b) {
+            return strtotime($b['dateClose']) - strtotime($a['dateClose']);
+        });
+
+        // Slice the array to limit the number of items processed
+        $discontinuedServices = array_slice($discontinuedServices, 0, 15);
+
+        // Process each item
+        foreach ($discontinuedServices as $service) {
+            // Construct the title
+            $title = $this->formatTitle(
+                $service['name'],
+                $service['dateOpen'],
+                $service['dateClose']
+            );
+
+            // Construct the content
+            $content = sprintf(
+                '<p>%s</p><p>Scheduled Closure: %s</p>',
+                $service['description'],
+                $service['dateClose']
+            );
+
+            // Add the item to the feed
+            $this->items[] = [
+                'title' => $title,
+                'uid' => $service['slug'],
+                'uri' => $service['link'],
+                'content' => $content
+            ];
+        }
+    }
+
+    private function formatTitle($name, $dateOpen, $dateClose)
+    {
+        // Extract years from dateOpen and dateClose
+        $yearOpen = date('Y', strtotime($dateOpen));
+        $yearClose = date('Y', strtotime($dateClose));
+
+        // Format the title
+        return "{$name} ({$yearOpen} - {$yearClose})";
+    }
+}

From 75a0a779c0587dee5c4a60d12c1bfab65d7f7ec1 Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Thu, 8 Feb 2024 15:35:24 +0100
Subject: [PATCH 302/716] Update HeiseBridge.php (#3963)

fix for broken article categories
---
 bridges/HeiseBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/HeiseBridge.php b/bridges/HeiseBridge.php
index f89594ee..504bcfb5 100644
--- a/bridges/HeiseBridge.php
+++ b/bridges/HeiseBridge.php
@@ -179,7 +179,7 @@ class HeiseBridge extends FeedExpander
             }
         }
 
-        $categories = $article->find('.article-footer__topics ul.topics li.topics__item');
+        $categories = $article->find('.article-footer__topics ul.topics li.topics__item a-topic a');
         foreach ($categories as $category) {
             $item['categories'][] = trim($category->plaintext);
         }

From cfef482366e296f2ab1526a97408114b4c1ef9a3 Mon Sep 17 00:00:00 2001
From: Korytov Pavel <thexcloud@gmail.com>
Date: Thu, 8 Feb 2024 17:36:03 +0300
Subject: [PATCH 303/716] [EconomistBridge] Handle 404s in feed gracefully
 (#3965)

---
 bridges/EconomistBridge.php | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/bridges/EconomistBridge.php b/bridges/EconomistBridge.php
index aad72275..70117cb0 100644
--- a/bridges/EconomistBridge.php
+++ b/bridges/EconomistBridge.php
@@ -99,7 +99,12 @@ class EconomistBridge extends FeedExpander
 
     protected function parseItem(array $item)
     {
-        $dom = getSimpleHTMLDOM($item['uri']);
+        try {
+            $dom = getSimpleHTMLDOM($item['uri']);
+        } catch (Exception $e) {
+            $item['content'] = $e->getMessage();
+            return $item;
+        }
 
         $article = $dom->find('#new-article-template', 0);
         if ($article == null) {

From ae2eb2f1d1af63a3068e18e9d85f92f360b60a34 Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Thu, 8 Feb 2024 20:05:24 +0100
Subject: [PATCH 304/716] feat(Reddit): add parameter for web UI frontend

---
 bridges/RedditBridge.php | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index 618463a6..9c72f996 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -38,6 +38,16 @@ class RedditBridge extends BridgeAbstract
                 'required' => false,
                 'exampleValue' => 'cats, dogs',
                 'title' => 'Keyword search, separated by commas'
+            ],
+            'frontend' => [
+                'type' => 'list',
+                'name' => 'frontend',
+                'title' => 'choose frontend for  reddit',
+                'values' => [
+                    'old.reddit.com' => 'https://old.reddit.com',
+                    'reddit.com' => 'https://reddit.com',
+                    'libreddit.kavin.rocks' => 'https://libreddit.kavin.rocks',
+                ]
             ]
         ],
         'single' => [
@@ -109,6 +119,10 @@ class RedditBridge extends BridgeAbstract
     {
         $user = false;
         $comments = false;
+        $frontend = $this->getInput('frontend');
+        if ($frontend == '') {
+                $frontend = 'https://old.reddit.com';
+        }
         $section = $this->getInput('d');
 
         switch ($this->queriedContext) {
@@ -175,6 +189,10 @@ class RedditBridge extends BridgeAbstract
                 $item['timestamp'] = $data->created_utc;
                 $item['uri'] = $this->urlEncodePathParts($data->permalink);
 
+                if ($frontend != 'https://old.reddit.com') {
+                    $item['uri'] = preg_replace('#^https://old\.reddit\.com#', $frontend, $item['uri']);
+                }
+
                 $item['categories'] = [];
 
                 if ($post->kind == 't1') {

From 8a6798a2276026ec8fe06b0056607a6e461cf330 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 9 Feb 2024 07:27:16 +0100
Subject: [PATCH 305/716] fix: escape token for html context (#3966)

---
 README.md                      |  6 +++---
 bridges/AnnasArchiveBridge.php |  6 ++++--
 bridges/BookMyShowBridge.php   | 28 +++++++++++++++-------------
 config/nginx.conf              |  1 +
 lib/BridgeCard.php             |  5 ++---
 5 files changed, 25 insertions(+), 21 deletions(-)

diff --git a/README.md b/README.md
index cadba3b9..f8d08058 100644
--- a/README.md
+++ b/README.md
@@ -104,6 +104,7 @@ server {
     server_name example.com;
     access_log /var/log/nginx/rss-bridge.access.log;
     error_log /var/log/nginx/rss-bridge.error.log;
+    log_not_found off;
 
     # Intentionally not setting a root folder here
 
@@ -115,23 +116,22 @@ server {
         alias /var/www/rss-bridge/static/;
     }
 
-    # Pass off to php-fpm only when location is exactly /
+    # Pass off to php-fpm when location is exactly /
     location = / {
         root /var/www/rss-bridge/;
         include snippets/fastcgi-php.conf;
+        fastcgi_read_timeout 45s;
         fastcgi_pass unix:/run/php/rss-bridge.sock;
     }
 
     # Reduce spam
     location = /favicon.ico {
         access_log off;
-        log_not_found off;
     }
 
     # Reduce spam
     location = /robots.txt {
         access_log off;
-        log_not_found off;
     }
 }
 ```
diff --git a/bridges/AnnasArchiveBridge.php b/bridges/AnnasArchiveBridge.php
index e8a1e8c4..acb943b4 100644
--- a/bridges/AnnasArchiveBridge.php
+++ b/bridges/AnnasArchiveBridge.php
@@ -126,7 +126,8 @@ class AnnasArchiveBridge extends BridgeAbstract
             return;
         }
 
-        foreach ($list->find('.w-full > .mb-4 > div > a') as $element) {
+        $elements = $list->find('.w-full > .mb-4 > div > a');
+        foreach ($elements as $element) {
             $item = [];
             $item['title'] = $element->find('h3', 0)->plaintext;
             $item['author'] = $element->find('div.italic', 0)->plaintext;
@@ -134,7 +135,8 @@ class AnnasArchiveBridge extends BridgeAbstract
             $item['content'] = $element->plaintext;
             $item['uid'] = $item['uri'];
 
-            if ($item_html = getSimpleHTMLDOMCached($item['uri'])) {
+            $item_html = getSimpleHTMLDOMCached($item['uri'], 86400 * 20);
+            if ($item_html) {
                 $item_html = defaultLinkTo($item_html, self::URI);
                 $item['content'] .= $item_html->find('main img', 0);
                 $item['content'] .= $item_html->find('main .mt-4', 0); // Summary
diff --git a/bridges/BookMyShowBridge.php b/bridges/BookMyShowBridge.php
index 7064df91..6ad02fe2 100644
--- a/bridges/BookMyShowBridge.php
+++ b/bridges/BookMyShowBridge.php
@@ -1218,14 +1218,15 @@ EOT;
         $table = $this->generateEventDetailsTable($event);
 
         $imgsrc = $event['BannerURL'];
+        $FShareURL = $event['FShareURL'];
 
         return <<<EOT
-		<img title="Event Banner URL" src="$imgsrc"></img>
-		<br>
-		$table
-		<br>
-		More Details are available on the <a href="${event['FShareURL']}">BookMyShow website</a>.
-EOT;
+        <img title="Event Banner URL" src="$imgsrc">
+        <br>
+        $table
+        <br>
+        More Details are available on the <a href="$FShareURL">BookMyShow website</a>.
+        EOT;
     }
 
     /**
@@ -1292,14 +1293,15 @@ EOT;
 
         $synopsis = preg_replace(self::SYNOPSIS_REGEX, '', $data['EventSynopsis']);
 
+        $eventTrailerURL = $data['EventTrailerURL'];
         return <<<EOT
-		<img title="Movie Poster" src="$imgsrc"></img>
-		<div>$table</div>
-		<p>$innerHtml</p>
-		<p>${synopsis}</p>
-		More Details are available on the <a href="$url">BookMyShow website</a> and a trailer is available
-		<a href="${data['EventTrailerURL']}" title="Trailer URL">here</a>
-EOT;
+        <img title="Movie Poster" src="$imgsrc"></img>
+        <div>$table</div>
+        <p>$innerHtml</p>
+        <p>$synopsis</p>
+        More Details are available on the <a href="$url">BookMyShow website</a> and a trailer is available
+        <a href="$eventTrailerURL" title="Trailer URL">here</a>
+        EOT;
     }
 
     /**
diff --git a/config/nginx.conf b/config/nginx.conf
index f0f189e7..c65f8e00 100644
--- a/config/nginx.conf
+++ b/config/nginx.conf
@@ -13,6 +13,7 @@ server {
 
     location ~ \.php$ {
         include snippets/fastcgi-php.conf;
+        fastcgi_read_timeout 45s;
         fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
     }
 }
diff --git a/lib/BridgeCard.php b/lib/BridgeCard.php
index e5456f33..c4677b9d 100644
--- a/lib/BridgeCard.php
+++ b/lib/BridgeCard.php
@@ -104,9 +104,8 @@ final class BridgeCard
             <input type="hidden" name="bridge" value="{$bridgeClassName}" />
         EOD;
 
-        if ($token) {
-            // todo: maybe escape the token?
-            $form .= sprintf('<input type="hidden" name="token" value="%s" />', $token);
+        if (Configuration::getConfig('authentication', 'token') && $token) {
+            $form .= sprintf('<input type="hidden" name="token" value="%s" />', e($token));
         }
 
         if (!empty($contextName)) {

From 6f731b20a9a0a6f7913b77dc9c92dd59a21279fc Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 9 Feb 2024 08:03:04 +0100
Subject: [PATCH 306/716] fix(DarkReading): official rss endpoint changed
 (#3967)

---
 bridges/DarkReadingBridge.php | 16 +++-------------
 1 file changed, 3 insertions(+), 13 deletions(-)

diff --git a/bridges/DarkReadingBridge.php b/bridges/DarkReadingBridge.php
index 4f1622e3..d8b88cb6 100644
--- a/bridges/DarkReadingBridge.php
+++ b/bridges/DarkReadingBridge.php
@@ -9,7 +9,7 @@ class DarkReadingBridge extends FeedExpander
 
     const PARAMETERS = [ [
         'feed' => [
-            'name' => 'Feed',
+            'name' => 'Feed (NOT IN USE)',
             'type' => 'list',
             'values' => [
                 'All Dark Reading Stories' => '000_AllArticles',
@@ -41,17 +41,7 @@ class DarkReadingBridge extends FeedExpander
 
     public function collectData()
     {
-        $feed = $this->getInput('feed');
-        $feed_splitted = explode('_', $feed);
-        $feed_id = $feed_splitted[0];
-        $feed_name = $feed_splitted[1];
-        if (empty($feed) || !ctype_digit($feed_id) || !preg_match('/[A-Za-z%20\/]/', $feed_name)) {
-            returnClientError('Invalid feed, please check the "feed" parameter.');
-        }
-        $feed_url = $this->getURI() . 'rss_simple.asp';
-        if ($feed_id != '000') {
-            $feed_url .= '?f_n=' . $feed_id . '&f_ln=' . $feed_name;
-        }
+        $feed_url = 'https://www.darkreading.com/rss.xml';
         $limit = $this->getInput('limit') ?? 10;
         $this->collectExpandableDatas($feed_url, $limit);
     }
@@ -71,7 +61,7 @@ class DarkReadingBridge extends FeedExpander
 
     private function extractArticleContent($article)
     {
-        $content = $article->find('div.article-content', 0)->innertext;
+        $content = $article->find('div.ContentModule-Wrapper', 0)->innertext;
 
         foreach (
             [

From 46ac77590e275bf3724e23f191cdfcd011bb72f9 Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Fri, 9 Feb 2024 14:09:03 +0530
Subject: [PATCH 307/716] [KilledbyMicrosoftBridge] Update: Adjusted content
 format for consistency (#3968)

---
 bridges/KilledbyMicrosoftBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/KilledbyMicrosoftBridge.php b/bridges/KilledbyMicrosoftBridge.php
index 8779f0ae..918c1aaa 100644
--- a/bridges/KilledbyMicrosoftBridge.php
+++ b/bridges/KilledbyMicrosoftBridge.php
@@ -34,7 +34,7 @@ class KilledbyMicrosoftBridge extends BridgeAbstract
 
             // Construct the content
             $content = sprintf(
-                '<p>%s</p><p>Scheduled Closure: %s</p>',
+                '<p>%s</p><p>Scheduled closure on %s.</p>',
                 $service['description'],
                 $service['dateClose']
             );

From 7b2ac362648d755874171300d1f5b2d9aea0ff46 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 9 Feb 2024 22:27:35 +0100
Subject: [PATCH 308/716] chore: move committed third-party deps to lib (#3973)

---
 lib/bootstrap.php                                 | 6 +++---
 {vendor => lib}/parsedown/LICENSE.txt             | 0
 {vendor => lib}/parsedown/Parsedown.php           | 0
 {vendor => lib}/php-urljoin/LICENSE               | 0
 {vendor => lib}/php-urljoin/src/urljoin.php       | 0
 {vendor => lib}/simplehtmldom/LICENSE             | 0
 {vendor => lib}/simplehtmldom/simple_html_dom.php | 0
 phpcs.xml                                         | 3 +++
 8 files changed, 6 insertions(+), 3 deletions(-)
 rename {vendor => lib}/parsedown/LICENSE.txt (100%)
 rename {vendor => lib}/parsedown/Parsedown.php (100%)
 rename {vendor => lib}/php-urljoin/LICENSE (100%)
 rename {vendor => lib}/php-urljoin/src/urljoin.php (100%)
 rename {vendor => lib}/simplehtmldom/LICENSE (100%)
 rename {vendor => lib}/simplehtmldom/simple_html_dom.php (100%)

diff --git a/lib/bootstrap.php b/lib/bootstrap.php
index 6465f5f9..29c8b97d 100644
--- a/lib/bootstrap.php
+++ b/lib/bootstrap.php
@@ -18,9 +18,9 @@ $files = [
     __DIR__ . '/../lib/url.php',
     __DIR__ . '/../lib/seotags.php',
     // Vendor
-    __DIR__ . '/../vendor/parsedown/Parsedown.php',
-    __DIR__ . '/../vendor/php-urljoin/src/urljoin.php',
-    __DIR__ . '/../vendor/simplehtmldom/simple_html_dom.php',
+    __DIR__ . '/../lib/parsedown/Parsedown.php',
+    __DIR__ . '/../lib/php-urljoin/src/urljoin.php',
+    __DIR__ . '/../lib/simplehtmldom/simple_html_dom.php',
 ];
 foreach ($files as $file) {
     require_once $file;
diff --git a/vendor/parsedown/LICENSE.txt b/lib/parsedown/LICENSE.txt
similarity index 100%
rename from vendor/parsedown/LICENSE.txt
rename to lib/parsedown/LICENSE.txt
diff --git a/vendor/parsedown/Parsedown.php b/lib/parsedown/Parsedown.php
similarity index 100%
rename from vendor/parsedown/Parsedown.php
rename to lib/parsedown/Parsedown.php
diff --git a/vendor/php-urljoin/LICENSE b/lib/php-urljoin/LICENSE
similarity index 100%
rename from vendor/php-urljoin/LICENSE
rename to lib/php-urljoin/LICENSE
diff --git a/vendor/php-urljoin/src/urljoin.php b/lib/php-urljoin/src/urljoin.php
similarity index 100%
rename from vendor/php-urljoin/src/urljoin.php
rename to lib/php-urljoin/src/urljoin.php
diff --git a/vendor/simplehtmldom/LICENSE b/lib/simplehtmldom/LICENSE
similarity index 100%
rename from vendor/simplehtmldom/LICENSE
rename to lib/simplehtmldom/LICENSE
diff --git a/vendor/simplehtmldom/simple_html_dom.php b/lib/simplehtmldom/simple_html_dom.php
similarity index 100%
rename from vendor/simplehtmldom/simple_html_dom.php
rename to lib/simplehtmldom/simple_html_dom.php
diff --git a/phpcs.xml b/phpcs.xml
index 21e1f50a..bd1aca28 100644
--- a/phpcs.xml
+++ b/phpcs.xml
@@ -8,6 +8,9 @@
 
   <exclude-pattern>./static</exclude-pattern>
   <exclude-pattern>./vendor</exclude-pattern>
+  <exclude-pattern>./lib/parsedown</exclude-pattern>
+  <exclude-pattern>./lib/php-urljoin</exclude-pattern>
+  <exclude-pattern>./lib/simplehtmldom</exclude-pattern>
   <exclude-pattern>./templates</exclude-pattern>
   <exclude-pattern>./config.default.ini.php</exclude-pattern>
   <exclude-pattern>./config.ini.php</exclude-pattern>

From df7b91a2a32762d015478bb8862e22367d18b898 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 9 Feb 2024 22:39:45 +0100
Subject: [PATCH 309/716] chore: upgrade composer root deps (#3974)

composer update --root-reqs
Loading composer repositories with package information
Updating dependencies
Lock file operations: 0 installs, 2 updates, 0 removals
  - Upgrading phpunit/phpunit (9.6.9 => 9.6.11)
  - Upgrading squizlabs/php_codesniffer (3.7.2 => 3.8.1)
Writing lock file
Installing dependencies from lock file (including require-dev)
Package operations: 0 installs, 2 updates, 0 removals
  - Upgrading phpunit/phpunit (9.6.9 => 9.6.11): Extracting archive
  - Upgrading squizlabs/php_codesniffer (3.7.2 => 3.8.1): Extracting archive
Generating autoload files
26 packages you are using are looking for funding.
Use the `composer fund` command to find out more!
No security vulnerability advisories found.
---
 composer.lock | 71 ++++++++++++++++++++++++++++++++++-----------------
 1 file changed, 47 insertions(+), 24 deletions(-)

diff --git a/composer.lock b/composer.lock
index 39e9cfc4..94a71227 100644
--- a/composer.lock
+++ b/composer.lock
@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "24083060ddb8be9a95e75f6596e3bb83",
+    "content-hash": "6103a05bc4ac2c33281ef349fd8ff968",
     "packages": [],
     "packages-dev": [
         {
@@ -623,16 +623,16 @@
         },
         {
             "name": "phpunit/phpunit",
-            "version": "9.6.9",
+            "version": "9.6.11",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/phpunit.git",
-                "reference": "a9aceaf20a682aeacf28d582654a1670d8826778"
+                "reference": "810500e92855eba8a7a5319ae913be2da6f957b0"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/phpunit/zipball/a9aceaf20a682aeacf28d582654a1670d8826778",
-                "reference": "a9aceaf20a682aeacf28d582654a1670d8826778",
+                "url": "https://api.github.com/repos/sebastianbergmann/phpunit/zipball/810500e92855eba8a7a5319ae913be2da6f957b0",
+                "reference": "810500e92855eba8a7a5319ae913be2da6f957b0",
                 "shasum": ""
             },
             "require": {
@@ -706,7 +706,7 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/phpunit/issues",
                 "security": "https://github.com/sebastianbergmann/phpunit/security/policy",
-                "source": "https://github.com/sebastianbergmann/phpunit/tree/9.6.9"
+                "source": "https://github.com/sebastianbergmann/phpunit/tree/9.6.11"
             },
             "funding": [
                 {
@@ -722,7 +722,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-06-11T06:13:56+00:00"
+            "time": "2023-08-19T07:10:56+00:00"
         },
         {
             "name": "sebastian/cli-parser",
@@ -1690,16 +1690,16 @@
         },
         {
             "name": "squizlabs/php_codesniffer",
-            "version": "3.7.2",
+            "version": "3.8.1",
             "source": {
                 "type": "git",
-                "url": "https://github.com/squizlabs/PHP_CodeSniffer.git",
-                "reference": "ed8e00df0a83aa96acf703f8c2979ff33341f879"
+                "url": "https://github.com/PHPCSStandards/PHP_CodeSniffer.git",
+                "reference": "14f5fff1e64118595db5408e946f3a22c75807f7"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/squizlabs/PHP_CodeSniffer/zipball/ed8e00df0a83aa96acf703f8c2979ff33341f879",
-                "reference": "ed8e00df0a83aa96acf703f8c2979ff33341f879",
+                "url": "https://api.github.com/repos/PHPCSStandards/PHP_CodeSniffer/zipball/14f5fff1e64118595db5408e946f3a22c75807f7",
+                "reference": "14f5fff1e64118595db5408e946f3a22c75807f7",
                 "shasum": ""
             },
             "require": {
@@ -1709,11 +1709,11 @@
                 "php": ">=5.4.0"
             },
             "require-dev": {
-                "phpunit/phpunit": "^4.0 || ^5.0 || ^6.0 || ^7.0"
+                "phpunit/phpunit": "^4.0 || ^5.0 || ^6.0 || ^7.0 || ^8.0 || ^9.3.4"
             },
             "bin": [
-                "bin/phpcs",
-                "bin/phpcbf"
+                "bin/phpcbf",
+                "bin/phpcs"
             ],
             "type": "library",
             "extra": {
@@ -1728,22 +1728,45 @@
             "authors": [
                 {
                     "name": "Greg Sherwood",
-                    "role": "lead"
+                    "role": "Former lead"
+                },
+                {
+                    "name": "Juliette Reinders Folmer",
+                    "role": "Current lead"
+                },
+                {
+                    "name": "Contributors",
+                    "homepage": "https://github.com/PHPCSStandards/PHP_CodeSniffer/graphs/contributors"
                 }
             ],
             "description": "PHP_CodeSniffer tokenizes PHP, JavaScript and CSS files and detects violations of a defined set of coding standards.",
-            "homepage": "https://github.com/squizlabs/PHP_CodeSniffer",
+            "homepage": "https://github.com/PHPCSStandards/PHP_CodeSniffer",
             "keywords": [
                 "phpcs",
                 "standards",
                 "static analysis"
             ],
             "support": {
-                "issues": "https://github.com/squizlabs/PHP_CodeSniffer/issues",
-                "source": "https://github.com/squizlabs/PHP_CodeSniffer",
-                "wiki": "https://github.com/squizlabs/PHP_CodeSniffer/wiki"
+                "issues": "https://github.com/PHPCSStandards/PHP_CodeSniffer/issues",
+                "security": "https://github.com/PHPCSStandards/PHP_CodeSniffer/security/policy",
+                "source": "https://github.com/PHPCSStandards/PHP_CodeSniffer",
+                "wiki": "https://github.com/PHPCSStandards/PHP_CodeSniffer/wiki"
             },
-            "time": "2023-02-22T23:07:41+00:00"
+            "funding": [
+                {
+                    "url": "https://github.com/PHPCSStandards",
+                    "type": "github"
+                },
+                {
+                    "url": "https://github.com/jrfnl",
+                    "type": "github"
+                },
+                {
+                    "url": "https://opencollective.com/php_codesniffer",
+                    "type": "open_collective"
+                }
+            ],
+            "time": "2024-01-11T20:47:48+00:00"
         },
         {
             "name": "theseer/tokenizer",
@@ -1808,9 +1831,9 @@
         "ext-openssl": "*",
         "ext-libxml": "*",
         "ext-simplexml": "*",
-        "ext-json": "*",
-        "ext-intl": "*"
+        "ext-dom": "*",
+        "ext-json": "*"
     },
     "platform-dev": [],
-    "plugin-api-version": "2.0.0"
+    "plugin-api-version": "2.6.0"
 }

From ff7840d60f212dd5f395378103bc22f0c273641d Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 9 Feb 2024 22:51:10 +0100
Subject: [PATCH 310/716] chore: prepare for introduction of
 php-webdriver/webdriver (Selenium) (#3975)

---
 composer.json     | 1 +
 lib/bootstrap.php | 4 ++++
 2 files changed, 5 insertions(+)

diff --git a/composer.json b/composer.json
index 0e7abb84..34f1a80f 100644
--- a/composer.json
+++ b/composer.json
@@ -36,6 +36,7 @@
         "squizlabs/php_codesniffer": "^3.6"
     },
     "suggest": {
+        "php-webdriver/webdriver": "Required for Selenium usage",
         "ext-memcached": "Allows to use memcached as cache type",
         "ext-sqlite3": "Allows to use an SQLite database for caching",
         "ext-zip": "Required for FDroidRepoBridge",
diff --git a/lib/bootstrap.php b/lib/bootstrap.php
index 29c8b97d..bfc7be39 100644
--- a/lib/bootstrap.php
+++ b/lib/bootstrap.php
@@ -1,5 +1,9 @@
 <?php
 
+if (is_file(__DIR__ . '/../vendor/autoload.php')) {
+    require __DIR__ . '/../vendor/autoload.php';
+}
+
 const PATH_LIB_CACHES = __DIR__ . '/../caches/';
 const PATH_CACHE = __DIR__ . '/../cache/';
 

From 8e8028b7860ebb09eae92dcd43b4b6916d26d4d6 Mon Sep 17 00:00:00 2001
From: hleskien <34342248+hleskien@users.noreply.github.com>
Date: Sat, 10 Feb 2024 04:42:22 +0100
Subject: [PATCH 311/716] Adopt WebDriverAbstract as a solution for active
 (JavaScript) websites (#3971)

* first working version

---------

Co-authored-by: Dag <me@dvikan.no>
---
 bridges/GULPProjekteBridge.php                | 164 ++++++++++++++++++
 bridges/ScalableCapitalBlogBridge.php         |  73 ++++++++
 config.default.ini.php                        |  10 ++
 docs/05_Bridge_API/04_WebDriverAbstract.md    |  83 +++++++++
 ...4_XPathAbstract.md => 05_XPathAbstract.md} |   0
 docs/05_Bridge_API/index.md                   |   3 +-
 lib/WebDriverAbstract.php                     | 141 +++++++++++++++
 7 files changed, 473 insertions(+), 1 deletion(-)
 create mode 100644 bridges/GULPProjekteBridge.php
 create mode 100644 bridges/ScalableCapitalBlogBridge.php
 create mode 100644 docs/05_Bridge_API/04_WebDriverAbstract.md
 rename docs/05_Bridge_API/{04_XPathAbstract.md => 05_XPathAbstract.md} (100%)
 create mode 100644 lib/WebDriverAbstract.php

diff --git a/bridges/GULPProjekteBridge.php b/bridges/GULPProjekteBridge.php
new file mode 100644
index 00000000..e0bb8cbe
--- /dev/null
+++ b/bridges/GULPProjekteBridge.php
@@ -0,0 +1,164 @@
+<?php
+
+use Facebook\WebDriver\Exception\NoSuchElementException;
+use Facebook\WebDriver\Remote\RemoteWebElement;
+use Facebook\WebDriver\WebDriverBy;
+use Facebook\WebDriver\WebDriverExpectedCondition;
+
+class GULPProjekteBridge extends WebDriverAbstract
+{
+    const NAME = 'GULP Projekte';
+    const URI = 'https://www.gulp.de/gulp2/g/projekte';
+    const DESCRIPTION = 'Projektsuche';
+    const MAINTAINER = 'hleskien';
+
+    const MAXITEMS = 60;
+
+    /**
+     * Adds accept language german to the Chrome Options.
+     *
+     * @return Facebook\WebDriver\Chrome\ChromeOptions
+     */
+    protected function getBrowserOptions()
+    {
+        $chromeOptions = parent::getBrowserOptions();
+        $chromeOptions->addArguments(['--accept-lang=de']);
+        return $chromeOptions;
+    }
+
+    /**
+     * @throws Facebook\WebDriver\Exception\NoSuchElementException
+     * @throws Facebook\WebDriver\Exception\TimeoutException
+     */
+    protected function clickAwayCookieBanner()
+    {
+        $this->getDriver()->wait()->until(WebDriverExpectedCondition::visibilityOfElementLocated(WebDriverBy::id('onetrust-reject-all-handler')));
+        $buttonRejectCookies = $this->getDriver()->findElement(WebDriverBy::id('onetrust-reject-all-handler'));
+        $buttonRejectCookies->click();
+        $this->getDriver()->wait()->until(WebDriverExpectedCondition::invisibilityOfElementLocated(WebDriverBy::id('onetrust-reject-all-handler')));
+    }
+
+    /**
+     * @throws Facebook\WebDriver\Exception\NoSuchElementException
+     * @throws Facebook\WebDriver\Exception\TimeoutException
+     */
+    protected function clickNextPage()
+    {
+        $nextPage = $this->getDriver()->findElement(WebDriverBy::xpath('//app-linkable-paginator//li[@id="next-page"]/a'));
+        $href = $nextPage->getAttribute('href');
+        $nextPage->click();
+        $this->getDriver()->wait()->until(WebDriverExpectedCondition::not(
+            WebDriverExpectedCondition::presenceOfElementLocated(
+                WebDriverBy::xpath('//app-linkable-paginator//li[@id="next-page"]/a[@href="' . $href . '"]')
+            )
+        ));
+    }
+
+    /**
+     * Returns the uri of the 'Projektanbieter' logo or false if there is
+     * no logo present in the item.
+     *
+     * @return string | false
+     */
+    protected function getLogo(RemoteWebElement $item)
+    {
+        try {
+            $logo = $item->findElement(WebDriverBy::tagName('img'))->getAttribute('src');
+            if (str_starts_with($logo, 'http')) {
+                // different domain
+                return $logo;
+            } else {
+                // relative path
+                $remove = substr(self::URI, strrpos(self::URI, '/') + 1);
+                return substr(self::URI, 0, -strlen($remove)) . $logo;
+            }
+        } catch (NoSuchElementException $e) {
+            return false;
+        }
+    }
+
+    /**
+     * Converts a string like "vor einigen Minuten" into a reasonable timestamp.
+     * Long and complicated, but we don't want to be more specific than
+     * the information we have available.
+     *
+     * @throws Exception If the DateInterval can't be parsed.
+     */
+    protected function getTimestamp(string $timeAgo): int
+    {
+        $dateTime = new DateTime();
+        $dateArray = explode(' ', $dateTime->format('Y m d H i s'));
+        $quantityStr = explode(' ', $timeAgo)[1];
+        // convert possible word into a number
+        if (in_array($quantityStr, ['einem', 'einer', 'einigen'])) {
+            $quantity = 1;
+        } else {
+            $quantity = intval($quantityStr);
+        }
+        // subtract time ago + inferior units for lower precision
+        if (str_contains($timeAgo, 'Sekunde')) {
+            $interval = new DateInterval('PT' . $quantity . 'S');
+        } elseif (str_contains($timeAgo, 'Minute')) {
+            $interval = new DateInterval('PT' . $quantity . 'M' . $dateArray[5] . 'S');
+        } elseif (str_contains($timeAgo, 'Stunde')) {
+            $interval = new DateInterval('PT' . $quantity . 'H' . $dateArray[4] . 'M' . $dateArray[5] . 'S');
+        } elseif (str_contains($timeAgo, 'Tag')) {
+            $interval = new DateInterval('P' . $quantity . 'DT' . $dateArray[3] . 'H' . $dateArray[4] . 'M' . $dateArray[5] . 'S');
+        } else {
+            throw new UnexpectedValueException($timeAgo);
+        }
+        $dateTime = $dateTime->sub($interval);
+        return $dateTime->getTimestamp();
+    }
+
+    /**
+     * The main loop which clicks through search result pages and puts
+     * the content into the $items array.
+     *
+     * @throws Facebook\WebDriver\Exception\NoSuchElementException
+     * @throws Facebook\WebDriver\Exception\TimeoutException
+     */
+    public function collectData()
+    {
+        parent::collectData();
+
+        try {
+            $this->clickAwayCookieBanner();
+            $this->setIcon($this->getDriver()->findElement(WebDriverBy::xpath('//link[@rel="shortcut icon"]'))->getAttribute('href'));
+
+            while (true) {
+                $items = $this->getDriver()->findElements(WebDriverBy::tagName('app-project-view'));
+                foreach ($items as $item) {
+                    $feedItem = new FeedItem();
+
+                    $heading = $item->findElement(WebDriverBy::xpath('.//app-heading-tag/h1/a'));
+                    $feedItem->setTitle($heading->getText());
+                    $feedItem->setURI('https://www.gulp.de' . $heading->getAttribute('href'));
+                    $info = $item->findElement(WebDriverBy::tagName('app-icon-info-list'));
+                    if ($logo = $this->getLogo($item)) {
+                        $feedItem->setEnclosures([$logo]);
+                    }
+                    if (str_contains($info->getText(), 'Projektanbieter:')) {
+                        $feedItem->setAuthor($info->findElement(WebDriverBy::xpath('.//li/span[2]/span'))->getText());
+                    } else {
+                        // mostly "Direkt vom Auftraggeber" or "GULP Agentur"
+                        $feedItem->setAuthor($item->findElement(WebDriverBy::tagName('b'))->getText());
+                    }
+                    $feedItem->setContent($item->findElement(WebDriverBy::xpath('.//p[@class="description"]'))->getText());
+                    $timeAgo = $item->findElement(WebDriverBy::xpath('.//small[contains(@class, "time-ago")]'))->getText();
+                    $feedItem->setTimestamp($this->getTimestamp($timeAgo));
+
+                    $this->items[] = $feedItem;
+                }
+
+                if (count($this->items) < self::MAXITEMS) {
+                    $this->clickNextPage();
+                } else {
+                    break;
+                }
+            }
+        } finally {
+            $this->cleanUp();
+        }
+    }
+}
diff --git a/bridges/ScalableCapitalBlogBridge.php b/bridges/ScalableCapitalBlogBridge.php
new file mode 100644
index 00000000..6f95efb3
--- /dev/null
+++ b/bridges/ScalableCapitalBlogBridge.php
@@ -0,0 +1,73 @@
+<?php
+
+use Facebook\WebDriver\WebDriverBy;
+use Facebook\WebDriver\WebDriverExpectedCondition;
+
+class ScalableCapitalBlogBridge extends WebDriverAbstract
+{
+    const NAME = 'Scalable Capital Blog';
+    const URI = 'https://de.scalable.capital/blog';
+    const DESCRIPTION = 'Alle Artikel';
+    const MAINTAINER = 'hleskien';
+
+    /**
+     * Adds accept language german to the Chrome Options.
+     *
+     * @return Facebook\WebDriver\Chrome\ChromeOptions
+     */
+    protected function getBrowserOptions()
+    {
+        $chromeOptions = parent::getBrowserOptions();
+        $chromeOptions->addArguments(['--accept-lang=de']);
+        return $chromeOptions;
+    }
+
+    /**
+     * Puts the content of the first page into the $items array.
+     *
+     * @throws Facebook\WebDriver\Exception\NoSuchElementException
+     * @throws Facebook\WebDriver\Exception\TimeoutException
+     */
+    public function collectData()
+    {
+        parent::collectData();
+
+        try {
+            // wait until last item is loaded
+            $this->getDriver()->wait()->until(WebDriverExpectedCondition::visibilityOfElementLocated(
+                WebDriverBy::xpath('//div[contains(@class, "articles")]//div[@class="items"]//div[contains(@class, "item")][15]')
+            ));
+            $this->setIcon($this->getDriver()->findElement(WebDriverBy::xpath('//link[@rel="shortcut icon"]'))->getAttribute('href'));
+
+            $items = $this->getDriver()->findElements(WebDriverBy::xpath('//div[contains(@class, "articles")]//div[@class="items"]//div[contains(@class, "item")]'));
+            foreach ($items as $item) {
+                $feedItem = new FeedItem();
+
+                $feedItem->setEnclosures(['https://de.scalable.capital' . $item->findElement(WebDriverBy::tagName('img'))->getAttribute('src')]);
+                $heading = $item->findElement(WebDriverBy::tagName('a'));
+                $feedItem->setTitle($heading->getText());
+                $feedItem->setURI('https://de.scalable.capital' . $heading->getAttribute('href'));
+                $feedItem->setContent($item->findElement(WebDriverBy::xpath('.//div[@class="summary"]'))->getText());
+                $date = $item->findElement(WebDriverBy::xpath('.//div[@class="published-date"]'))->getText();
+                $feedItem->setTimestamp($this->formatItemTimestamp($date));
+                $feedItem->setAuthor($item->findElement(WebDriverBy::xpath('.//div[@class="author"]'))->getText());
+
+                $this->items[] = $feedItem;
+            }
+        } finally {
+            $this->cleanUp();
+        }
+    }
+
+    /**
+     * Converts the given date (dd.mm.yyyy) into a timestamp.
+     *
+     * @param $value string
+     * @return int
+     */
+    protected function formatItemTimestamp($value)
+    {
+        $formatter = new IntlDateFormatter('de', IntlDateFormatter::LONG, IntlDateFormatter::NONE);
+        return $formatter->parse($value);
+    }
+}
\ No newline at end of file
diff --git a/config.default.ini.php b/config.default.ini.php
index 7729afcb..8f7de832 100644
--- a/config.default.ini.php
+++ b/config.default.ini.php
@@ -99,6 +99,16 @@ name = "Hidden proxy name"
 ; false = disabled (default)
 by_bridge = false
 
+[webdriver]
+
+; Sets the url of the webdriver or selenium server
+selenium_server_url = "http://localhost:4444"
+
+; Sets whether the browser should run in headless mode (no visible ui)
+; true = enabled
+; false = disabled (default)
+headless = false
+
 [authentication]
 
 ; HTTP basic authentication
diff --git a/docs/05_Bridge_API/04_WebDriverAbstract.md b/docs/05_Bridge_API/04_WebDriverAbstract.md
new file mode 100644
index 00000000..60b5e99d
--- /dev/null
+++ b/docs/05_Bridge_API/04_WebDriverAbstract.md
@@ -0,0 +1,83 @@
+`WebDriverAbstract` extends [`BridgeAbstract`](./02_BridgeAbstract.md) and adds functionality for generating feeds
+from active websites that use XMLHttpRequest (XHR) to load content and / or JavaScript to
+modify content.
+It highly depends on the php-webdriver library which offers Selenium WebDriver bindings for PHP.
+
+- https://github.com/php-webdriver/php-webdriver (Project Repository)
+- https://php-webdriver.github.io/php-webdriver/latest/ (API)
+
+Please note that this class is intended as a solution for websites _that cannot be covered
+by the other classes_. The WebDriver starts a browser and is therefore very resource-intensive.
+
+# Configuration
+
+You need a running WebDriver to use bridges that depend on `WebDriverAbstract`.
+The easiest way is to start the Selenium server from the project of the same name:
+```
+docker run -d -p 4444:4444 --shm-size="2g" docker.io/selenium/standalone-chrome:latest
+```
+
+- https://github.com/SeleniumHQ/docker-selenium
+
+With these parameters only one browser window can be started at a time.
+On a multi-user site, Selenium Grid should be used
+and the number of sessions should be adjusted to the number of processor cores.
+
+Finally, the `config.ini.php` file must be adjusted so that the WebDriver
+can find the Selenium server:
+```
+[webdriver]
+
+selenium_server_url = "http://localhost:4444"
+```
+
+# Development
+
+While you are programming a new bridge, it is easier to start a local WebDriver because then you can see what is happening and where the errors are. I've also had good experience recording the process with a screen video to find any timing problems.
+
+```
+chromedriver --port=4444
+```
+
+- https://chromedriver.chromium.org/
+
+If you start rss-bridge from a container, then Chrome driver is only accessible
+if you call it with the `--allowed-ips` option so that it binds to all network interfaces.
+
+```
+chromedriver --port=4444 --allowed-ips=192.168.1.42
+```
+
+The **most important rule** is that after an event such as loading the web page
+or pressing a button, you often have to explicitly wait for the desired elements to appear.
+
+A simple example is the bridge `ScalableCapitalBlogBridge.php`.
+A more complex and relatively complete example is the bridge `GULPProjekteBridge.php`.
+
+# Template
+
+Use this template to create your own bridge.
+
+```PHP
+<?php
+
+class MyBridge extends WebDriverAbstract
+{
+    const NAME = 'My Bridge';
+    const URI = 'https://www.example.org';
+    const DESCRIPTION = 'Further description';
+    const MAINTAINER = 'your name';
+
+    public function collectData()
+    {
+        parent::collectData();
+
+        try {
+            // TODO
+        } finally {
+            $this->cleanUp();
+        }
+    }
+}
+
+```
\ No newline at end of file
diff --git a/docs/05_Bridge_API/04_XPathAbstract.md b/docs/05_Bridge_API/05_XPathAbstract.md
similarity index 100%
rename from docs/05_Bridge_API/04_XPathAbstract.md
rename to docs/05_Bridge_API/05_XPathAbstract.md
diff --git a/docs/05_Bridge_API/index.md b/docs/05_Bridge_API/index.md
index 06445246..ea6fd315 100644
--- a/docs/05_Bridge_API/index.md
+++ b/docs/05_Bridge_API/index.md
@@ -8,6 +8,7 @@ Base class | Description
 -----------|------------
 [`BridgeAbstract`](./02_BridgeAbstract.md) | This class is intended for standard _Bridges_ that need to filter HTML pages for content.
 [`FeedExpander`](./03_FeedExpander.md) | Expand/modify existing feed urls
-[`XPathAbstract`](./04_XPathAbstract.md) | This class is meant as an alternative base class for bridge implementations. It offers preliminary functionality for generating feeds based on _XPath expressions_.
+[`WebDriverAbstract`](./04_WebDriverAbstract) |
+[`XPathAbstract`](./05_XPathAbstract) | This class is meant as an alternative base class for bridge implementations. It offers preliminary functionality for generating feeds based on _XPath expressions_.
 
 For more information about how to create a new _Bridge_, read [How to create a new Bridge?](./01_How_to_create_a_new_bridge.md)
\ No newline at end of file
diff --git a/lib/WebDriverAbstract.php b/lib/WebDriverAbstract.php
new file mode 100644
index 00000000..db2fb7b1
--- /dev/null
+++ b/lib/WebDriverAbstract.php
@@ -0,0 +1,141 @@
+<?php
+
+use Facebook\WebDriver\Chrome\ChromeOptions;
+use Facebook\WebDriver\Remote\DesiredCapabilities;
+use Facebook\WebDriver\Remote\RemoteWebDriver;
+use Facebook\WebDriver\WebDriverCapabilities;
+
+/**
+ * An alternative abstract class for bridges depending on webdriver
+ *
+ * This class is meant a solution for active websites that use
+ * XMLHttpRequest (XHR) to load content and/or use JavaScript to
+ * change content. This class depends on a working webdriver setup.
+ */
+abstract class WebDriverAbstract extends BridgeAbstract
+{
+    /**
+     * Holds the remote webdriver object, including configuration and
+     * connection.
+     *
+     * @var RemoteWebDriver
+     */
+    protected RemoteWebDriver $driver;
+
+    /**
+     * Holds the uri of the feed's icon.
+     *
+     * @var string | null
+     */
+    private $feedIcon;
+
+    /**
+     * Returns the webdriver object.
+     *
+     * @return RemoteWebDriver
+     */
+    protected function getDriver(): RemoteWebDriver
+    {
+        return $this->driver;
+    }
+
+    /**
+     * Returns the uri of the feed's icon.
+     *
+     * @return string
+     */
+    public function getIcon()
+    {
+        return $this->feedIcon ?: parent::getIcon();
+    }
+
+    /**
+     * Sets the uri of the feed's icon.
+     *
+     * @param $iconurl string
+     */
+    protected function setIcon($iconurl)
+    {
+        $this->feedIcon = $iconurl;
+    }
+
+    /**
+     * Returns the ChromeOptions object.
+     *
+     * If the configuration parameter 'headless' is set to true, the
+     * argument '--headless' is added. Override this to change or add
+     * more options.
+     *
+     * @return ChromeOptions
+     */
+    protected function getBrowserOptions()
+    {
+        $chromeOptions = new ChromeOptions();
+        if (Configuration::getConfig('webdriver', 'headless')) {
+            $chromeOptions->addArguments(['--headless']);   // --window-size=1024,1024
+        }
+        return $chromeOptions;
+    }
+
+    /**
+     * Returns the DesiredCapabilities object for the Chrome browser.
+     *
+     * The Chrome options are added. Override this to change or add
+     * more capabilities.
+     *
+     * @return WebDriverCapabilities
+     */
+    protected function getDesiredCapabilities(): WebDriverCapabilities
+    {
+        $desiredCapabilities = DesiredCapabilities::chrome();
+        $desiredCapabilities->setCapability(ChromeOptions::CAPABILITY, $this->getBrowserOptions());
+        return $desiredCapabilities;
+    }
+
+    /**
+     * Constructs the remote webdriver with the url of the remote (Selenium)
+     * webdriver server and the desired capabilities.
+     *
+     * This should be called in collectData() first.
+     */
+    protected function prepareWebDriver()
+    {
+        $server = Configuration::getConfig('webdriver', 'selenium_server_url');
+        $this->driver = RemoteWebDriver::create($server, $this->getDesiredCapabilities());
+    }
+
+    /**
+     * Maximizes the remote browser window (often important for reactive sites
+     * which change their appearance depending on the window size) and opens
+     * the uri set in the constant URI.
+     */
+    protected function prepareWindow()
+    {
+        $this->getDriver()->manage()->window()->maximize();
+        $this->getDriver()->get($this->getURI());
+    }
+
+    /**
+     * Closes the remote browser window and shuts down the remote webdriver
+     * connection.
+     *
+     * This must be called at the end of scraping, for example within a
+     * 'finally' block.
+     */
+    protected function cleanUp()
+    {
+        $this->getDriver()->quit();
+    }
+
+    /**
+     * Do your web scraping here and fill the $items array.
+     *
+     * Override this but call parent() first.
+     * Don't forget to call cleanUp() at the end.
+     */
+    public function collectData()
+    {
+        $this->prepareWebDriver();
+        $this->prepareWindow();
+    }
+}
\ No newline at end of file

From 257799be8ea3e1fe81a58320c9381c9191a1ff51 Mon Sep 17 00:00:00 2001
From: Eugene Molotov <eugene.molotov@yandex.ru>
Date: Sat, 10 Feb 2024 19:59:39 +0500
Subject: [PATCH 312/716] [Vk2Bridge] Alternative bridge for VK (#3878)

---
 bridges/Vk2Bridge.php          | 323 +++++++++++++++++++++++++++++++++
 docs/10_Bridge_Specific/Vk2.md |  41 +++++
 2 files changed, 364 insertions(+)
 create mode 100644 bridges/Vk2Bridge.php
 create mode 100644 docs/10_Bridge_Specific/Vk2.md

diff --git a/bridges/Vk2Bridge.php b/bridges/Vk2Bridge.php
new file mode 100644
index 00000000..0bc0879f
--- /dev/null
+++ b/bridges/Vk2Bridge.php
@@ -0,0 +1,323 @@
+<?php
+
+class Vk2Bridge extends BridgeAbstract
+{
+    const MAINTAINER = 'em92';
+    const NAME = 'ВКонтакте';
+    const URI = 'https://vk.com';
+    const DESCRIPTION = 'Выводит записи на стене';
+    const CACHE_TIMEOUT = 300; // 5 minutes
+    const PARAMETERS = [
+        [
+            'u' => [
+                'name' => 'Короткое имя группы или профиля (из ссылки)',
+                'exampleValue' => 'goblin_oper_ru',
+                'required' => true
+            ],
+            'hide_reposts' => [
+                'name' => 'Скрыть репосты',
+                'type' => 'checkbox',
+            ]
+        ]
+    ];
+
+    const CONFIGURATION = [
+        'access_token' => [
+            'required' => true,
+        ],
+    ];
+
+    const TEST_DETECT_PARAMETERS = [
+        'https://vk.com/id1' => ['u' => 'id1'],
+        'https://vk.com/groupname' => ['u' => 'groupname'],
+        'https://m.vk.com/groupname' => ['u' => 'groupname'],
+        'https://vk.com/groupname/anythingelse' => ['u' => 'groupname'],
+        'https://vk.com/groupname?w=somethingelse' => ['u' => 'groupname'],
+        'https://vk.com/with_underscore' => ['u' => 'with_underscore'],
+        'https://vk.com/vk.cats' => ['u' => 'vk.cats'],
+    ];
+
+    protected $ownerNames = [];
+    protected $pageName;
+    private $urlRegex = '/vk\.com\/([\w.]+)/';
+    private $rateLimitCacheKey = 'vk2_rate_limit';
+
+    public function getURI()
+    {
+        if (!is_null($this->getInput('u'))) {
+            return urljoin(static::URI, urlencode($this->getInput('u')));
+        }
+
+        return parent::getURI();
+    }
+
+    public function getName()
+    {
+        if ($this->pageName) {
+            return $this->pageName;
+        }
+
+        return parent::getName();
+    }
+
+    public function detectParameters($url)
+    {
+        if (preg_match($this->urlRegex, $url, $matches)) {
+            return ['u' => $matches[1]];
+        }
+
+        return null;
+    }
+
+    protected function getPostURI($post)
+    {
+        $r = 'https://vk.com/wall' . $post['owner_id'] . '_';
+        if (isset($post['reply_post_id'])) {
+            $r .= $post['reply_post_id'] . '?reply=' . $post['id'] . '&thread=' . $post['parents_stack'][0];
+        } else {
+            $r .= $post['id'];
+        }
+        return $r;
+    }
+
+    // This function is based on SlackCoyote's vkfeed2rss
+    // https://github.com/em92/vkfeed2rss
+    protected function generateContentFromPost($post)
+    {
+        // it's what we will return
+        $ret = $post['text'];
+
+        // html special characters convertion
+        $ret = htmlentities($ret, ENT_QUOTES | ENT_HTML401);
+        // change all linebreak to HTML compatible <br />
+        $ret = nl2br($ret);
+
+        $ret = "<p>$ret</p>";
+
+        // find URLs
+        $ret = preg_replace(
+            '/((https?|ftp|gopher)\:\/\/[a-zA-Z0-9\-\.]+(:[a-zA-Z0-9]*)?\/?([@\w\-\+\.\?\,\'\/&amp;%\$#\=~\x5C])*)/',
+            "<a href='$1'>$1</a>",
+            $ret
+        );
+
+        // find [id1|Pawel Durow] form links
+        $ret = preg_replace('/\[(\w+)\|([^\]]+)\]/', "<a href='https://vk.com/$1'>$2</a>", $ret);
+
+
+        // attachments
+        if (isset($post['attachments'])) {
+            // level 1
+            foreach ($post['attachments'] as $attachment) {
+                if ($attachment['type'] == 'video') {
+                    // VK videos
+                    $title = e($attachment['video']['title']);
+                    $photo = e($this->getImageURLWithLargestWidth($attachment['video']['image']));
+                    $href = "https://vk.com/video{$attachment['video']['owner_id']}_{$attachment['video']['id']}";
+                    $ret .= "<p><a href='{$href}'><img src='{$photo}' alt='Video: {$title}'><br/>Video: {$title}</a></p>";
+                } elseif ($attachment['type'] == 'audio') {
+                    // VK audio
+                    $artist = e($attachment['audio']['artist']);
+                    $title = e($attachment['audio']['title']);
+                    $ret .= "<p>Audio: {$artist} - {$title}</p>";
+                } elseif ($attachment['type'] == 'doc' and $attachment['doc']['ext'] != 'gif') {
+                    // any doc apart of gif
+                    $doc_url = e($attachment['doc']['url']);
+                    $title = e($attachment['doc']['title']);
+                    $ret .= "<p><a href='{$doc_url}'>Документ: {$title}</a></p>";
+                }
+            }
+            // level 2
+            foreach ($post['attachments'] as $attachment) {
+                if ($attachment['type'] == 'photo') {
+                    // JPEG, PNG photos
+                    // GIF in vk is a document, so, not handled as photo
+                    $photo = e($this->getImageURLWithLargestWidth($attachment['photo']['sizes']));
+                    $text = e($attachment['photo']['text']);
+                    $ret .= "<p><img src='{$photo}' alt='{$text}'></p>";
+                } elseif ($attachment['type'] == 'doc' and $attachment['doc']['ext'] == 'gif') {
+                    // GIF docs
+                    $url = e($attachment['doc']['url']);
+                    $ret .= "<p><img src='{$url}'></p>";
+                } elseif ($attachment['type'] == 'link') {
+                    // links
+                    $url = e($attachment['link']['url']);
+                    $url = str_replace('https://m.vk.com', 'https://vk.com', $url);
+                    $title = e($attachment['link']['title']);
+                    if (isset($attachment['link']['photo'])) {
+                        $photo = $this->getImageURLWithLargestWidth($attachment['link']['photo']['sizes']);
+                        $ret .= "<p><a href='{$url}'><img src='{$photo}' alt='{$title}'><br>{$title}</a></p>";
+                    } else {
+                        $ret .= "<p><a href='{$url}'>{$title}</a></p>";
+                    }
+                } elseif ($attachment['type'] == 'note') {
+                    // notes
+                    $title = e($attachment['note']['title']);
+                    $url = e($attachment['note']['view_url']);
+                    $ret .= "<p><a href='{$url}'>{$title}</a></p>";
+                } elseif ($attachment['type'] == 'poll') {
+                    // polls
+                    $question = e($attachment['poll']['question']);
+                    $vote_count = $attachment['poll']['votes'];
+                    $answers = $attachment['poll']['answers'];
+                    $ret .= "<p>Poll: {$question} ({$vote_count} votes)<br />";
+                    foreach ($answers as $answer) {
+                        $text = e($answer['text']);
+                        $votes = $answer['votes'];
+                        $rate = $answer['rate'];
+                        $ret .= "* {$text}: {$votes} ({$rate}%)<br />";
+                    }
+                    $ret .= '</p>';
+                } elseif (!in_array($attachment['type'], ['video', 'audio', 'doc'])) {
+                    $ret .= "<p>Unknown attachment type: {$attachment['type']}</p>";
+                }
+            }
+        }
+
+        return $ret;
+    }
+
+    protected function getImageURLWithLargestWidth($items)
+    {
+        usort($items, function ($a, $b) {
+            return $b['width'] - $a['width'];
+        });
+        return $items[0]['url'];
+    }
+
+    public function collectData()
+    {
+        if ($this->cache->get($this->rateLimitCacheKey)) {
+            throw new HttpException('429 Too Many Requests', 429);
+        }
+
+        $u = $this->getInput('u');
+        $ownerId = null;
+
+        // getting ownerId from url
+        $r = preg_match('/^(club|public)(\d+)$/', $u, $matches);
+        if ($r) {
+            $ownerId = -intval($matches[2]);
+        } else {
+            $r = preg_match('/^(id)(\d+)$/', $u, $matches);
+            if ($r) {
+                $ownerId = intval($matches[2]);
+            }
+        }
+
+        // getting owner id from API
+        if (is_null($ownerId)) {
+            $r = $this->api('groups.getById', [
+                'group_ids' => $u,
+            ], [100]);
+            if (isset($r['response'][0])) {
+                $ownerId = -$r['response'][0]['id'];
+            } else {
+                $r = $this->api('users.get', [
+                    'user_ids' => $u,
+                ]);
+                if (count($r['response']) > 0) {
+                    $ownerId = $r['response'][0]['id'];
+                }
+            }
+        }
+
+        if (is_null($ownerId)) {
+            returnServerError('Could not detect owner id');
+        }
+
+        $r = $this->api('wall.get', [
+            'owner_id' => $ownerId,
+            'extended' => '1',
+        ]);
+
+        // preparing ownerNames dictionary
+        foreach ($r['response']['profiles'] as $profile) {
+            $this->ownerNames[$profile['id']] = $profile['first_name'] . ' ' . $profile['last_name'];
+        }
+        foreach ($r['response']['groups'] as $group) {
+            $this->ownerNames[-$group['id']] = $group['name'];
+        }
+        $this->generateFeed($r);
+    }
+
+    protected function generateFeed($r)
+    {
+        $ownerId = 0;
+
+        foreach ($r['response']['items'] as $post) {
+            if (!$ownerId) {
+                $ownerId = $post['owner_id'];
+            }
+            $item = new FeedItem();
+            $content = $this->generateContentFromPost($post);
+            if (isset($post['copy_history'])) {
+                if ($this->getInput('hide_reposts')) {
+                    continue;
+                }
+                $originalPost = $post['copy_history'][0];
+                if ($originalPost['from_id'] < 0) {
+                    $originalPostAuthorScreenName = 'club' . (-$originalPost['owner_id']);
+                } else {
+                    $originalPostAuthorScreenName = 'id' . $originalPost['owner_id'];
+                }
+                $originalPostAuthorURI = 'https://vk.com/' . $originalPostAuthorScreenName;
+                $originalPostAuthorName = $this->ownerNames[$originalPost['from_id']];
+                $originalPostAuthor = "<a href='$originalPostAuthorURI'>$originalPostAuthorName</a>";
+                $content .= '<p>Репост (<a href="';
+                $content .= $this->getPostURI($originalPost);
+                $content .= '">Пост</a> от ';
+                $content .= $originalPostAuthor;
+                $content .= '):</p>';
+                $content .= $this->generateContentFromPost($originalPost);
+            }
+            $item->setContent($content);
+            $item->setTimestamp($post['date']);
+            $item->setAuthor($this->ownerNames[$post['from_id']]);
+            $item->setTitle($this->getTitle(strip_tags($content)));
+            $item->setURI($this->getPostURI($post));
+
+            $this->items[] = $item;
+        }
+
+        $this->pageName = $this->ownerNames[$ownerId];
+    }
+
+    protected function getTitle($content)
+    {
+        $content = explode('<br>', $content)[0];
+        $content = strip_tags($content);
+        preg_match('/^[:\,"\w\ \p{L}\(\)\?#«»\-\–\—||&\.%\\₽\/+\;\!]+/mu', htmlspecialchars_decode($content), $result);
+        if (count($result) == 0) {
+            return 'untitled';
+        }
+        return $result[0];
+    }
+
+    protected function api($method, array $params, $expected_error_codes = [])
+    {
+        $access_token = $this->getOption('access_token');
+        if (!$access_token) {
+            returnServerError('You cannot run VK API methods without access_token');
+        }
+        $params['v'] = '5.131';
+        $r = json_decode(
+            getContents(
+                'https://api.vk.com/method/' . $method . '?' . http_build_query($params),
+                ['Authorization: Bearer ' . $access_token]
+            ),
+            true
+        );
+        if (isset($r['error']) && !in_array($r['error']['error_code'], $expected_error_codes)) {
+            if ($r['error']['error_code'] == 6) {
+                $this->cache->set($this->rateLimitCacheKey, true, 5);
+            } else if ($r['error']['error_code'] == 29) {
+                // wall.get has limit of 5000 requests per day
+                // if that limit is hit, VK returns error 29
+                $this->cache->set($this->rateLimitCacheKey, true, 60 * 30);
+            }
+            returnServerError('API returned error: ' . $r['error']['error_msg'] . ' (' . $r['error']['error_code'] . ')');
+        }
+        return $r;
+    }
+}
diff --git a/docs/10_Bridge_Specific/Vk2.md b/docs/10_Bridge_Specific/Vk2.md
new file mode 100644
index 00000000..7c48ad0a
--- /dev/null
+++ b/docs/10_Bridge_Specific/Vk2.md
@@ -0,0 +1,41 @@
+Vk2Bridge
+=========
+
+Работа этого скрипта основана [VK API](https://dev.vk.com/reference).
+По сравнению с VkBridge у этого скрипта есть свои приемущества и недостатки.
+
+Приемущества
+------------
+
+- Стабильность.
+  Скрипт не зависит от HTML-структуры страницы VK групп или пользователей, которые могут поменяться в любой момент.
+
+Недостатки
+----------
+
+- Требуется наличие зарегистированного в ВК пользователя.
+  Данный пользователь должен получить `access_token`, который используется для этого скрипта.
+  Подробнее в разделе "Настройка"
+
+- Количество запросов при выключенном кэше ограничено - [5000 запросов в сутки](https://dev.vk.com/ru/reference/roadmap#%D0%9E%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%87%D0%B5%D0%BD%D0%B8%D1%8F%20API%20%D0%B4%D0%BB%D1%8F%20%D0%BF%D0%BE%D0%B8%D1%81%D0%BA%D0%B0)
+
+Настройка
+---------
+
+1. Перейдите по [ссылке](https://oauth.vk.com/oauth/authorize?client_id=5149410&scope=offline&redirect_uri=https://oauth.vk.com/blank.html&display=page&response_type=token)
+
+2. Авторизуйтесь в приложение `my_personal_app`
+
+3. Получите ссылку вида `https://oauth.vk.com/blank.html#access_token=MNOGO_BUKAV&expires_in=0&user_id=123456`.
+   Из этой ссылки скопируйте `MNOGO_BUKAV`.
+
+4. В `config.ini.php` в раздел Vk2Bridge вставьте `access_token`
+
+```
+[Vk2Bridge]
+access_token = "MNOGO_BUKAV"
+```
+
+Примечание: в данной инструкции используется приложение, администратор которого является [@em92](https://github.com/em92).
+Допускается вместо упомянутого приложения использование своего standalone-приложения.
+Для этого надо в ссылке из п.1. заменить значение `client_id` на свой.

From 598ee5b51eaba62dc672f9e9f6f96ac628e56263 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 14 Feb 2024 16:02:54 +0100
Subject: [PATCH 313/716] fix(pinterest): set enclosure so it emits mrss
 media:content prop (#3980)

---
 bridges/PinterestBridge.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/bridges/PinterestBridge.php b/bridges/PinterestBridge.php
index fc5b1c19..8338fb25 100644
--- a/bridges/PinterestBridge.php
+++ b/bridges/PinterestBridge.php
@@ -39,6 +39,9 @@ class PinterestBridge extends FeedExpander
         $pattern = '/https\:\/\/i\.pinimg\.com\/[a-zA-Z0-9]*x\//';
         foreach ($this->items as $item) {
             $item['content'] = preg_replace($pattern, 'https://i.pinimg.com/originals/', $item['content']);
+            $item['enclosures'] = [
+                $item['uri'],
+            ];
             $newitems[] = $item;
         }
         $this->items = $newitems;

From 4d15ffd2cf44807210cb5d2783ce3bc5c8476275 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Fri, 16 Feb 2024 03:58:15 +0100
Subject: [PATCH 314/716] 
 [PepperBridgeAbstract,DealabsBridge,HotUKDealsBridge,MydealsBridge] (#3982)

Exclude thread results

Some categories showed some thread in the middle of the deals : now only
the deals are handled

Updated the "no results" text to follow the sites changes
---
 bridges/DealabsBridge.php        | 2 +-
 bridges/HotUKDealsBridge.php     | 2 +-
 bridges/MydealsBridge.php        | 2 +-
 bridges/PepperBridgeAbstract.php | 8 ++++----
 4 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/bridges/DealabsBridge.php b/bridges/DealabsBridge.php
index a5a3771b..c65f0c75 100644
--- a/bridges/DealabsBridge.php
+++ b/bridges/DealabsBridge.php
@@ -1913,7 +1913,7 @@ class DealabsBridge extends PepperBridgeAbstract
         'uri-merchant' => 'search/bons-plans?merchant-id=',
         'request-error' => 'Impossible de joindre Dealabs',
         'thread-error' => 'Impossible de déterminer l\'ID de la discussion. Vérifiez l\'URL que vous avez entré',
-        'no-results' => 'Il n&#039;y a rien à afficher pour le moment :(',
+        'no-results' => 'Aucun résultat',
         'currency' => '€',
         'relative-date-indicator' => [
             'il y a',
diff --git a/bridges/HotUKDealsBridge.php b/bridges/HotUKDealsBridge.php
index 44da417a..1f059123 100644
--- a/bridges/HotUKDealsBridge.php
+++ b/bridges/HotUKDealsBridge.php
@@ -3277,7 +3277,7 @@ class HotUKDealsBridge extends PepperBridgeAbstract
         'uri-merchant' => 'search/deals?merchant-id=',
         'request-error' => 'Could not request HotUKDeals',
         'thread-error' => 'Unable to determine the thread ID. Check the URL you entered',
-        'no-results' => 'Ooops, looks like we could',
+        'no-results' => 'no results',
         'currency' => '£',
         'relative-date-indicator' => [
             'ago',
diff --git a/bridges/MydealsBridge.php b/bridges/MydealsBridge.php
index dda3d2a9..08e32a0c 100644
--- a/bridges/MydealsBridge.php
+++ b/bridges/MydealsBridge.php
@@ -2024,7 +2024,7 @@ class MydealsBridge extends PepperBridgeAbstract
         'uri-merchant' => 'search/gutscheine?merchant-id=',
         'request-error' => 'Could not request mydeals',
         'thread-error' => 'Die ID der Diskussion kann nicht ermittelt werden. Überprüfen Sie die eingegebene URL',
-        'no-results' => 'Ups, wir konnten nichts',
+        'no-results' => 'keine Ergebnisse',
         'currency' => '€',
         'relative-date-indicator' => [
             'vor',
diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index 2516fc1e..d0e15238 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -44,7 +44,7 @@ class PepperBridgeAbstract extends BridgeAbstract
     protected function collectDeals($url)
     {
         $html = getSimpleHTMLDOM($url);
-        $list = $html->find('article[id]');
+        $list = $html->find('article[id][class*=thread--deal]]');
 
         // Deal Image Link CSS Selector
         $selectorImageLink = implode(
@@ -109,9 +109,9 @@ class PepperBridgeAbstract extends BridgeAbstract
 
                 $item['content'] = '<table><tr><td><a href="'
                     . $item['uri']
-                    . '"><img src="'
+                    . '">'
                     . $this->getImage($deal)
-                    . '"/></td><td>'
+                    . '</td><td>'
                     . $this->getHTMLTitle($item)
                     . $this->getPrice($jsonDealData)
                     . $this->getDiscount($jsonDealData)
@@ -430,7 +430,7 @@ HEREDOC;
     {
         // Get thread Image JSON content
         $content = Json::decode($deal->find('div[class*=threadGrid-image]', 0)->find('div[class=js-vue2]', 0)->getAttribute('data-vue2'));
-        return $content['props']['threadImageUrl'];
+        return '<img src="' . $content['props']['threadImageUrl'] . '"/>';
     }
 
     /**

From 7813f4564e9c4f6054c827cead26fe6a6b2605c5 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Thu, 15 Feb 2024 22:14:17 -0500
Subject: [PATCH 315/716] AO3Bridge: add options to fetch chapter contents and
 list titles (#3981)

* AO3Bridge: add options to fetch chapter contents and titles for list feeds

and add downloads for each fic to enclosures

* AO3Bridge: fix list default value

* AO3Bridge: fix erroneous dynamic property usage

* AO3Bridge: fix unit test failure for getURI
---
 bridges/AO3Bridge.php | 110 ++++++++++++++++++++++++++++++++++--------
 1 file changed, 91 insertions(+), 19 deletions(-)

diff --git a/bridges/AO3Bridge.php b/bridges/AO3Bridge.php
index e30c6b70..32bbb0a2 100644
--- a/bridges/AO3Bridge.php
+++ b/bridges/AO3Bridge.php
@@ -12,8 +12,20 @@ class AO3Bridge extends BridgeAbstract
             'url' => [
                 'name' => 'url',
                 'required' => true,
-                // Example: F/F tag, complete works only
-                'exampleValue' => 'https://archiveofourown.org/works?work_search[complete]=T&tag_id=F*s*F',
+                // Example: F/F tag
+                'exampleValue' => 'https://archiveofourown.org/tags/F*s*F/works',
+            ],
+            'range' => [
+                'name' => 'Chapter Content',
+                'title' => 'Chapter(s) to include in each work\'s feed entry',
+                'defaultValue' => null,
+                'type' => 'list',
+                'values' => [
+                    'None' => null,
+                    'First' => 'first',
+                    'Latest' => 'last',
+                    'Entire work' => 'all',
+                ],
             ],
         ],
         'Bookmarks' => [
@@ -39,18 +51,13 @@ class AO3Bridge extends BridgeAbstract
     {
         switch ($this->queriedContext) {
             case 'Bookmarks':
-                $user = $this->getInput('user');
-                $this->title = $user;
-                $url = self::URI
-                    . '/users/' . $user
-                    . '/bookmarks?bookmark_search[sort_column]=bookmarkable_date';
-                $this->collectList($url);
+                $this->collectList($this->getURI());
                 break;
             case 'List':
-                $this->collectList($this->getInput('url'));
+                $this->collectList($this->getURI());
                 break;
             case 'Work':
-                $this->collectWork($this->getInput('id'));
+                $this->collectWork($this->getURI());
                 break;
         }
     }
@@ -61,9 +68,21 @@ class AO3Bridge extends BridgeAbstract
      */
     private function collectList($url)
     {
-        $html = getSimpleHTMLDOM($url);
+        $httpClient = RssBridge::getHttpClient();
+        $version = 'v0.0.1';
+        $agent = ['useragent' => "rss-bridge $version (https://github.com/RSS-Bridge/rss-bridge)"];
+
+        $response = $httpClient->request($url, $agent);
+        $html = \str_get_html($response->getBody());
         $html = defaultLinkTo($html, self::URI);
 
+        // Get list title. Will include page range + count in some cases
+        $heading = ($html->find('#main > h2', 0));
+        if ($heading->find('a.tag')) {
+            $heading = $heading->find('a.tag', 0);
+        }
+        $this->title = $heading->plaintext;
+
         foreach ($html->find('.index.group > li') as $element) {
             $item = [];
 
@@ -83,6 +102,36 @@ class AO3Bridge extends BridgeAbstract
             $chapters = (isset($chapters) ? $chapters->plaintext : 0);
             $item['uid'] = $item['uri'] . "/$strdate/$chapters";
 
+            // Fetch workskin of desired chapter(s) in list
+            if ($this->getInput('range')) {
+                $url = $item['uri'];
+                switch ($this->getInput('range')) {
+                    case ('all'):
+                        $url .= '?view_full_work=true';
+                        break;
+                    case ('first'):
+                        break;
+                    case ('last'):
+                        // only way to get this is using the navigate page unfortunately
+                        $url .= '/navigate';
+                        $response = $httpClient->request($url, $agent);
+                        $html = \str_get_html($response->getBody());
+                        $html = defaultLinkTo($html, self::URI);
+                        $url = $html->find('ol.index.group > li > a', -1)->href;
+                        break;
+                }
+                $response = $httpClient->request($url, $agent);
+                $html = \str_get_html($response->getBody());
+                $html = defaultLinkTo($html, self::URI);
+                $item['content'] .= $html->find('#workskin', 0);
+            }
+
+            // Use predictability of download links to generate enclosures
+            $wid = explode('/', $item['uri'])[4];
+            foreach (['azw3', 'epub', 'mobi', 'pdf', 'html'] as $ext) {
+                $item['enclosures'][] = 'https://archiveofourown.org/downloads/' . $wid . '/work.' . $ext;
+            }
+
             $this->items[] = $item;
         }
     }
@@ -90,26 +139,29 @@ class AO3Bridge extends BridgeAbstract
     /**
      * Feed for recent chapters of a specific work.
      */
-    private function collectWork($id)
+    private function collectWork($url)
     {
-        $url = self::URI . "/works/$id/navigate";
         $httpClient = RssBridge::getHttpClient();
-
         $version = 'v0.0.1';
-        $response = $httpClient->request($url, [
-            'useragent' => "rss-bridge $version (https://github.com/RSS-Bridge/rss-bridge)",
-        ]);
+        $agent = ['useragent' => "rss-bridge $version (https://github.com/RSS-Bridge/rss-bridge)"];
 
+        $response = $httpClient->request($url . '/navigate', $agent);
         $html = \str_get_html($response->getBody());
         $html = defaultLinkTo($html, self::URI);
 
+        $response = $httpClient->request($url . '?view_full_work=true', $agent);
+        $workhtml = \str_get_html($response->getBody());
+        $workhtml = defaultLinkTo($workhtml, self::URI);
+
         $this->title = $html->find('h2 a', 0)->plaintext;
 
-        foreach ($html->find('ol.index.group > li') as $element) {
+        $nav = $html->find('ol.index.group > li');
+        for ($i = 0; $i < count($nav); $i++) {
             $item = [];
 
+            $element = $nav[$i];
             $item['title'] = $element->find('a', 0)->plaintext;
-            $item['content'] = $element;
+            $item['content'] = $workhtml->find('#chapter-' . ($i + 1), 0);
             $item['uri'] = $element->find('a', 0)->href;
 
             $strdate = $element->find('span.datetime', 0)->plaintext;
@@ -138,4 +190,24 @@ class AO3Bridge extends BridgeAbstract
     {
         return self::URI . '/favicon.ico';
     }
+
+    public function getURI()
+    {
+        $url = parent::getURI();
+        switch ($this->queriedContext) {
+            case 'Bookmarks':
+                $user = $this->getInput('user');
+                $url = self::URI
+                    . '/users/' . $user
+                    . '/bookmarks?bookmark_search[sort_column]=bookmarkable_date';
+                break;
+            case 'List':
+                $url = $this->getInput('url');
+                break;
+            case 'Work':
+                $url = self::URI . '/works/' . $this->getInput('id');
+                break;
+        }
+        return $url;
+    }
 }

From e65155f440b9d66771fd6096f4c13b77323a6217 Mon Sep 17 00:00:00 2001
From: Korytov Pavel <thexcloud@gmail.com>
Date: Sat, 17 Feb 2024 00:24:13 +0300
Subject: [PATCH 316/716] [OpenCVEBridge] Add bridge (#3978)

* [OpenCVEBridge] Add bridge

* [OpenCVEBridge] Fix tests

* [OpenCVEBridge] Fix description of the filter parameter
---
 bridges/OpenCVEBridge.php | 427 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 427 insertions(+)
 create mode 100644 bridges/OpenCVEBridge.php

diff --git a/bridges/OpenCVEBridge.php b/bridges/OpenCVEBridge.php
new file mode 100644
index 00000000..594bb9ec
--- /dev/null
+++ b/bridges/OpenCVEBridge.php
@@ -0,0 +1,427 @@
+<?php
+
+class OpenCVEBridge extends BridgeAbstract
+{
+    const MAINTAINER = 'sqrtminusone';
+    const NAME = 'OpenCVE Bridge';
+    const URI = 'https://opencve.io';
+
+    const CACHE_TIMEOUT = 3600; // 1 hour
+    const DESCRIPTION = 'A feed for search results from OpenCVE';
+
+    const PARAMETERS = [
+        '' => [
+            'instance' => [
+                'name' => 'OpenCVE Instance',
+                'required' => true,
+                'defaultValue' => 'https://www.opencve.io',
+                'exampleValue' => 'https://www.opencve.io'
+            ],
+            'login' => [
+                'name' => 'Login',
+                'type' => 'text',
+                'required' => true
+            ],
+            'password' => [
+                'name' => 'Password',
+                'type' => 'text',
+                'required' => true
+            ],
+            'pages' => [
+                'name' => 'Number of pages',
+                'type' => 'number',
+                'required' => false,
+                'exampleValue' => 1,
+                'defaultValue' => 1
+            ],
+            'filter' => [
+                'name' => 'Filter',
+                'type' => 'text',
+                'required' => false,
+                'exampleValue' => 'search:jenkins;product:gitlab,cvss:critical',
+                'title' => 'Syntax: param1:value1,param2:value2;param1query2:param2query2. See https://docs.opencve.io/api/cve/ for parameters'
+            ],
+            'upd_timestamp' => [
+                'name' => 'Use updated_at instead of created_at as timestamp',
+                'type' => 'checkbox'
+            ],
+            'trunc_summary' => [
+                'name' => 'Truncate summary for header',
+                'type' => 'number',
+                'defaultValue' => 100
+            ],
+            'fetch_contents' => [
+                'name' => 'Fetch detailed contents for CVEs',
+                'defaultValue' => 'checked',
+                'type' => 'checkbox'
+            ]
+        ]
+    ];
+
+    const CSS = '
+      <style>
+        .cvss-na-color {
+          background-color: #d2d6de;
+          color: #000;
+        }
+        .cvss-low-color {
+          background-color: #0073b7;
+          color: #fff;
+        }
+        .cvss-medium-color {
+          background-color: #f39c12;
+          color: #fff;
+        }
+        .cvss-high-color {
+          background-color: #dd4b39;
+          color: #fff;
+        }
+        .cvss-crit-color {
+          background-color: #972b1e;
+          color: #fff;
+        }
+        .label {
+          padding: .2em .6em .3em;
+          font-size: 75%;
+          font-weight: 700;
+          line-height: 1;
+          text-align: center;
+          white-space: nowrap;
+          border-radius: .25em;
+        }
+        .labels-row {
+           display: flex;
+           flex-direction: row;
+           align-items: center;
+           white-space: nowrap;
+           overflow: hidden;
+           margin-bottom: 6px;
+        }
+        .labels-row div {
+           margin-right: 6px;
+        }
+        .cvss-table table {
+           border-collapse: collapse;
+           width: 100%;
+           margin-bottom: 12px;
+        }
+        .cvss-table td, th {
+           border: 1px solid #dddddd;
+           text-align: left;
+           padding: 8px;
+        }
+    </style>';
+
+    public function collectData()
+    {
+        $creds = $this->getInput('login') . ':' . $this->getInput('password');
+        $authHeader = 'Authorization: Basic ' . base64_encode($creds);
+        $instance = $this->getInput('instance');
+
+        $queries = [];
+        $filter = $this->getInput('filter');
+        $filterValues = [];
+        if ($filter && mb_strlen($filter) > 0) {
+            $filterValues = explode(';', $filter);
+        } else {
+            $queries[''] = [];
+        }
+        foreach ($filterValues as $filterValue) {
+            $params = explode(',', $filterValue);
+            $queryName = $filterValue;
+            $query = [];
+            foreach ($params as $param) {
+                [$key, $value] = explode(':', $param);
+                if ($key == 'title') {
+                    $queryName = $value;
+                } else {
+                    $query[$key] = $value;
+                }
+            }
+            $queries[$queryName] = $query;
+        }
+
+        $fetchedIds = [];
+
+        foreach ($queries as $queryName => $query) {
+            for ($i = 1; $i <= $this->getInput('pages'); $i++) {
+                $queryPaginated = array_merge($query, ['page' => $i]);
+                $url = $instance . '/api/cve?' . http_build_query($queryPaginated);
+                $response = getContents(
+                    $url,
+                    [$authHeader]
+                );
+                $titlePrefix = '';
+                if (count($queries) > 1) {
+                    $titlePrefix = '[' . $queryName . '] ';
+                }
+
+                foreach (json_decode($response) as $cveItem) {
+                    if (array_key_exists($cveItem->id, $fetchedIds)) {
+                        continue;
+                    }
+                    $fetchedIds[$cveItem->id] = true;
+                    $item = [
+                        'uri' => $instance . '/cve/' . $cveItem->id,
+                        'uid' => $cveItem->id,
+                    ];
+                    if ($this->getInput('upd_timestamp') == 1) {
+                        $item['timestamp'] = strtotime($cveItem->updated_at);
+                    } else {
+                        $item['timestamp'] = strtotime($cveItem->created_at);
+                    }
+                    if ($this->getInput('fetch_contents')) {
+                        [$content, $title] = $this->fetchContents(
+                            $cveItem,
+                            $titlePrefix,
+                            $instance,
+                            $authHeader
+                        );
+                        $item['content'] = $content;
+                        $item['title'] = $title;
+                    } else {
+                        $item['content'] = $cveItem->summary . $this->getLinks($cveItem->id);
+                        $item['title'] = $this->getTitle($titlePrefix, $cveItem);
+                    }
+                    $this->items[] = $item;
+                }
+            }
+        }
+        usort($this->items, function ($a, $b) {
+            return $b['timestamp'] - $a['timestamp'];
+        });
+    }
+
+    private function getTitle($titlePrefix, $cveItem)
+    {
+        $summary = $cveItem->summary;
+        $limit = $this->getInput('limit');
+        if ($limit && mb_strlen($summary) > 100) {
+            $summary = mb_substr($summary, 0, $limit) + '...';
+        }
+        return $titlePrefix . $cveItem->id . '. ' . $summary;
+    }
+
+    private function fetchContents($cveItem, $titlePrefix, $instance, $authHeader)
+    {
+        $url = $instance . '/api/cve/' . $cveItem->id;
+        $response = getContents(
+            $url,
+            [$authHeader]
+        );
+        $datum = json_decode($response);
+
+        $title = $this->getTitleFromDatum($datum, $titlePrefix);
+
+        $result = self::CSS;
+        $result .= '<h1>' . $cveItem->id . '</h1>';
+        $result .= $this->getCVSSLabels($datum);
+        $result .= '<p>' . $datum->summary . '</p>';
+        $result .= <<<EOD
+            <h3>Information:</h3>
+            <p>
+              <ul>
+                <li><b>Publication date</b>: {$datum->raw_nvd_data->published}
+                <li><b>Last modified</b>: {$datum->raw_nvd_data->lastModified}
+                <li><b>Last modified</b>: {$datum->raw_nvd_data->lastModified}
+              </ul>
+            </p>
+            EOD;
+
+        $result .= $this->getV3Table($datum);
+        $result .= $this->getV2Table($datum);
+
+        $result .= $this->getLinks($datum->id);
+        $result .= $this->getReferences($datum);
+
+        $result .= $this->getVendors($datum);
+
+        return [$result, $title];
+    }
+
+    private function getTitleFromDatum($datum, $titlePrefix)
+    {
+        $title = $titlePrefix;
+        if ($datum->cvss->v3) {
+            $title .= "[v3: {$datum->cvss->v3}] ";
+        }
+        if ($datum->cvss->v2) {
+            $title .= "[v2: {$datum->cvss->v2}] ";
+        }
+        $title .= $datum->id . '. ';
+        $titlePostfix = $datum->summary;
+        $limit = $this->getInput('limit');
+        if ($limit && mb_strlen($titlePostfix) > 100) {
+            $titlePostfix = mb_substr($titlePostfix, 0, $limit) + '...';
+        }
+        $title .= $titlePostfix;
+        return $title;
+    }
+
+    private function getCVSSLabels($datum)
+    {
+        $CVSSv2Text = 'n/a';
+        $CVSSv2Class = 'cvss-na-color';
+        if ($datum->cvss->v2) {
+            $importance = '';
+            if ($datum->cvss->v2 >= 7) {
+                $importance = 'HIGH';
+                $CVSSv2Class = 'cvss-high-color';
+            } else if ($datum->cvss->v2 >= 4) {
+                $importance = 'MEDIUM';
+                $CVSSv2Class = 'cvss-medium-color';
+            } else {
+                $importance = 'LOW';
+                $CVSSv2Class = 'cvss-low-color';
+            }
+            $CVSSv2Text = sprintf('[%s] %.1f', $importance, $datum->cvss->v2);
+        }
+        $CVSSv2Item = "<div>CVSS v2: </div><div class=\"label {$CVSSv2Class}\">{$CVSSv2Text}</div>";
+
+        $CVSSv3Text = 'n/a';
+        $CVSSv3Class = 'cvss-na-color';
+        if ($datum->cvss->v3) {
+            $importance = '';
+            if ($datum->cvss->v3 >= 9) {
+                $importance = 'CRITICAL';
+                $CVSSv3Class = 'cvss-crit-color';
+            } else if ($datum->cvss->v3 >= 7) {
+                $importance = 'HIGH';
+                $CVSSv3Class = 'cvss-high-color';
+            } else if ($datum->cvss->v3 >= 4) {
+                $importance = 'MEDIUM';
+                $CVSSv3Class = 'cvss-medium-color';
+            } else {
+                $importance = 'LOW';
+                $CVSSv3Class = 'cvss-low-color';
+            }
+            $CVSSv3Text = sprintf('[%s] %.1f', $importance, $datum->cvss->v3);
+        }
+        $CVSSv3Item = "<div>CVSS v3: </div><div class=\"label {$CVSSv3Class}\">{$CVSSv3Text}</div>";
+        return '<div class="labels-row">' . $CVSSv3Item . $CVSSv2Item . '</div>';
+    }
+
+    private function getReferences($datum)
+    {
+        if (count($datum->raw_nvd_data->references) == 0) {
+            return '';
+        }
+        $res = '<h3>References:</h3> <p><ul>';
+        foreach ($datum->raw_nvd_data->references as $ref) {
+            $item = '<li>';
+            if (isset($ref->tags) && count($ref->tags) > 0) {
+                $item .= '[' . implode(', ', $ref->tags) . '] ';
+            }
+            $item .= "<a href=\"{$ref->url}\">{$ref->url}</a>";
+            $item .= '<li>';
+            $res .= $item;
+        }
+        $res .= '</p></ul>';
+        return $res;
+    }
+
+    private function getLinks($id)
+    {
+        return <<<EOD
+            <h3>Links</h3>
+            <p>
+              <ul>
+                <li>NVD Link: <a href="https://nvd.nist.gov/vuln/detail/{$id}">{$id}</a>
+                <li>MITRE Link: <a href="https://cve.mitre.org/cgi-bin/cvename.cgi?name={$id}">{$id}</a>
+                <li>CVE.ORG Link: <a href="https://www.cve.org/CVERecord?id={$id}">{$id}</a>
+              </ul>
+            </p>
+            EOD;
+    }
+
+    private function getV3Table($datum)
+    {
+        $metrics = $datum->raw_nvd_data->metrics;
+        if (!isset($metrics->cvssMetricV31) || count($metrics->cvssMetricV31) == 0) {
+            return '';
+        }
+        $v3 = $metrics->cvssMetricV31[0];
+        $data = $v3->cvssData;
+        return <<<EOD
+            <div class="cvss-table">
+              <h3>CVSS v3 details</h3>
+              <table>
+                <tr>
+                  <td>Impact score</td><td>{$v3->impactScore}</td>
+                  <td>Exploitability score</td><td>{$v3->exploitabilityScore}</td>
+                </tr>
+                <tr>
+                  <td>Attack vector</td><td>{$data->attackVector}</td>
+                  <td>Confidentiality Impact</td><td>{$data->confidentialityImpact}</td>
+                </tr>
+                <tr>
+                  <td>Attack complexity</td><td>{$data->attackComplexity}</td>
+                  <td>Integrity Impact</td><td>{$data->integrityImpact}</td>
+                </tr>
+                <tr>
+                  <td>Privileges Required</td><td>{$data->privilegesRequired}</td>
+                  <td>Availability Impact</td><td>{$data->availabilityImpact}</td>
+                </tr>
+                <tr>
+                  <td>User Interaction</td><td>{$data->userInteraction}</td>
+                  <td>Scope</td><td>{$data->scope}</td>
+                </tr>
+              </table>
+            </div>
+        EOD;
+    }
+
+    private function getV2Table($datum)
+    {
+        $metrics = $datum->raw_nvd_data->metrics;
+        if (!isset($metrics->cvssMetricV2) || count($metrics->cvssMetricV2) == 0) {
+            return '';
+        }
+        $v2 = $metrics->cvssMetricV2[0];
+        $data = $v2->cvssData;
+        return <<<EOD
+            <div class="cvss-table">
+              <h3>CVSS v2 details</h3>
+              <table>
+                <tr>
+                  <td>Impact score</td><td>{$v2->impactScore}</td>
+                  <td>Exploitability score</td><td>{$v2->exploitabilityScore}</td>
+                </tr>
+                <tr>
+                  <td>Access Vector</td><td>{$data->accessVector}</td>
+                  <td>Confidentiality Impact</td><td>{$data->confidentialityImpact}</td>
+                </tr>
+                <tr>
+                  <td>Access Complexity</td><td>{$data->accessComplexity}</td>
+                  <td>Integrity Impact</td><td>{$data->integrityImpact}</td>
+                </tr>
+                <tr>
+                  <td>Authentication</td><td>{$data->authentication}</td>
+                  <td>Availability Impact</td><td>{$data->availabilityImpact}</td>
+                </tr>
+                <tr>
+              </table>
+            </div>
+        EOD;
+    }
+
+    private function getVendors($datum)
+    {
+        if (count((array)$datum->vendors) == 0) {
+            return '';
+        }
+        $res = '<h3>Affected products</h3><p><ul>';
+        foreach ($datum->vendors as $vendor => $products) {
+            $res .= "<li>{$vendor}";
+            if (count($products) > 0) {
+                $res .= '<ul>';
+                foreach ($products as $product) {
+                    $res .= '<li>' . $product . '</li>';
+                }
+                $res .= '</ul>';
+            }
+            $res .= '</li>';
+        }
+        $res .= '</ul></p>';
+    }
+}

From 932f20d4341344807d6ae25d53ba811ba1e4280e Mon Sep 17 00:00:00 2001
From: hleskien <34342248+hleskien@users.noreply.github.com>
Date: Sun, 18 Feb 2024 19:19:33 +0100
Subject: [PATCH 317/716] fixed date with time in LuftfahrtBundesAmtBridge
 (#3987)

---
 bridges/LuftfahrtBundesAmtBridge.php | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/bridges/LuftfahrtBundesAmtBridge.php b/bridges/LuftfahrtBundesAmtBridge.php
index 2b0384a2..406d2476 100644
--- a/bridges/LuftfahrtBundesAmtBridge.php
+++ b/bridges/LuftfahrtBundesAmtBridge.php
@@ -26,8 +26,13 @@ class LuftfahrtBundesAmtBridge extends XPathAbstract
     protected function formatItemTimestamp($value)
     {
         $value = trim($value);
-        $dti = DateTimeImmutable::createFromFormat('d.m.Y', $value);
-        $dti = $dti->setTime(0, 0, 0);
+        if (strpos($value, 'Uhr') !== false) {
+            $value = str_replace(' Uhr', '', $value);
+            $dti = DateTimeImmutable::createFromFormat('d.m.Y G:i', $value);
+        } else {
+            $dti = DateTimeImmutable::createFromFormat('d.m.Y', $value);
+            $dti = $dti->setTime(0, 0);
+        }
         return $dti->getTimestamp();
     }
 

From 35f6e62e458c88f47bc857a3a186cf24edcae502 Mon Sep 17 00:00:00 2001
From: xduugu <cedric@gmx.ca>
Date: Tue, 20 Feb 2024 07:03:04 +0000
Subject: [PATCH 318/716] docker: Use pre-built curl-impersonate library from
 github releases (#3984)

The docker image is only available for `amd64` architecture and therefore
cannot be used for arm images.

Fixes #3983
---
 Dockerfile | 39 ++++++++++++++++++++++++++++++++-------
 1 file changed, 32 insertions(+), 7 deletions(-)

diff --git a/Dockerfile b/Dockerfile
index 2f1f4f3d..1326dba0 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,5 +1,3 @@
-FROM lwthiker/curl-impersonate:0.5-ff-slim-buster AS curlimpersonate
-
 FROM debian:12-slim AS rssbridge
 
 LABEL description="RSS-Bridge is a PHP project capable of generating RSS and Atom feeds for websites that don't have one."
@@ -7,7 +5,8 @@ LABEL repository="https://github.com/RSS-Bridge/rss-bridge"
 LABEL website="https://github.com/RSS-Bridge/rss-bridge"
 
 ARG DEBIAN_FRONTEND=noninteractive
-RUN apt-get update && \
+RUN set -xe && \
+    apt-get update && \
     apt-get install --yes --no-install-recommends \
       ca-certificates \
       nginx \
@@ -24,18 +23,44 @@ RUN apt-get update && \
       php-xml \
       php-zip \
       # php-zlib is enabled by default with PHP 8.2 in Debian 12
+      # for downloading libcurl-impersonate
+      curl \
       && \
+    # install curl-impersonate library
+    curlimpersonate_version=0.6.0 && \
+    { \
+        { \
+            [ $(arch) = 'aarch64' ] && \
+            archive="libcurl-impersonate-v${curlimpersonate_version}.aarch64-linux-gnu.tar.gz" && \
+            sha512sum="d04b1eabe71f3af06aa1ce99b39a49c5e1d33b636acedcd9fad163bc58156af5c3eb3f75aa706f335515791f7b9c7a6c40ffdfa47430796483ecef929abd905d" \
+        ; } \
+        || { \
+            [ $(arch) = 'armv7l' ] && \
+            archive="libcurl-impersonate-v${curlimpersonate_version}.arm-linux-gnueabihf.tar.gz" && \
+            sha512sum="05906b4efa1a6ed8f3b716fd83d476b6eea6bfc68e3dbc5212d65a2962dcaa7bd1f938c9096a7535252b11d1d08fb93adccc633585ff8cb8cec5e58bfe969bc9" \
+        ; } \
+        || { \
+            [ $(arch) = 'x86_64' ] && \
+            archive="libcurl-impersonate-v${curlimpersonate_version}.x86_64-linux-gnu.tar.gz" && \
+            sha512sum="480bbe9452cd9aff2c0daaaf91f1057b3a96385f79011628a9237223757a9b0d090c59cb5982dc54ea0d07191657299ea91ca170a25ced3d7d410fcdff130ace" \
+        ; } \
+    } && \
+    curl -LO "https://github.com/lwthiker/curl-impersonate/releases/download/v${curlimpersonate_version}/${archive}" && \
+    echo "$sha512sum  $archive" | sha512sum -c - && \
+    mkdir -p /usr/local/lib/curl-impersonate && \
+    tar xaf "$archive" -C /usr/local/lib/curl-impersonate --wildcards 'libcurl-impersonate-ff.so*' && \
+    rm "$archive" && \
+    apt-get purge --assume-yes curl && \
     rm -rf /var/lib/apt/lists/*
 
+ENV LD_PRELOAD /usr/local/lib/curl-impersonate/libcurl-impersonate-ff.so
+ENV CURL_IMPERSONATE ff91esr
+
 # logs should go to stdout / stderr
 RUN ln -sfT /dev/stderr /var/log/nginx/error.log; \
 	ln -sfT /dev/stdout /var/log/nginx/access.log; \
 	chown -R --no-dereference www-data:adm /var/log/nginx/
 
-COPY --from=curlimpersonate /usr/local/lib/libcurl-impersonate-ff.so /usr/local/lib/curl-impersonate/
-ENV LD_PRELOAD /usr/local/lib/curl-impersonate/libcurl-impersonate-ff.so
-ENV CURL_IMPERSONATE ff91esr
-
 COPY ./config/nginx.conf /etc/nginx/sites-available/default
 COPY ./config/php-fpm.conf /etc/php/8.2/fpm/pool.d/rss-bridge.conf
 COPY ./config/php.ini /etc/php/8.2/fpm/conf.d/90-rss-bridge.ini

From 4c355ba3083ded7a2d621baa42c1233a46cd51dd Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 20 Feb 2024 19:32:31 +0100
Subject: [PATCH 319/716] fix(FilterBridge): trim title so that regex filter
 works as expected (#3989)

The fix is in FeedParser, so this fixes all usages
of FeedParser where title is now trimmed.

fix #3985
---
 lib/FeedParser.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/FeedParser.php b/lib/FeedParser.php
index 37d3005b..b774cc14 100644
--- a/lib/FeedParser.php
+++ b/lib/FeedParser.php
@@ -92,7 +92,7 @@ final class FeedParser
             $item['uri'] = (string)$feedItem->id;
         }
         if (isset($feedItem->title)) {
-            $item['title'] = html_entity_decode((string)$feedItem->title);
+            $item['title'] = trim(html_entity_decode((string)$feedItem->title));
         }
         if (isset($feedItem->updated)) {
             $item['timestamp'] = strtotime((string)$feedItem->updated);
@@ -154,7 +154,7 @@ final class FeedParser
             $item['uri'] = (string)$feedItem->link;
         }
         if (isset($feedItem->title)) {
-            $item['title'] = html_entity_decode((string)$feedItem->title);
+            $item['title'] = trim(html_entity_decode((string)$feedItem->title));
         }
         if (isset($feedItem->description)) {
             $item['content'] = (string)$feedItem->description;

From 683c968d646dbaf9719a1ef7b59797240fec7617 Mon Sep 17 00:00:00 2001
From: D5k H3h <85834680+dhuschde@users.noreply.github.com>
Date: Fri, 1 Mar 2024 20:24:14 +0100
Subject: [PATCH 320/716] [Rooster Teeth] Add Camp Camp channel (#3992)

---
 bridges/RoosterTeethBridge.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/bridges/RoosterTeethBridge.php b/bridges/RoosterTeethBridge.php
index 21bac4fe..464c83a8 100644
--- a/bridges/RoosterTeethBridge.php
+++ b/bridges/RoosterTeethBridge.php
@@ -17,6 +17,7 @@ class RoosterTeethBridge extends BridgeAbstract
                 'values' => [
                     'All channels' => 'all',
                     'Achievement Hunter' => 'achievement-hunter',
+                    'Camp Camp' => 'camp-camp',
                     'Cow Chop' => 'cow-chop',
                     'Death Battle' => 'death-battle',
                     'Friends of RT' => 'friends-of-rt',

From 7a7f8d5050177dfc4eac763feb257745ce39c238 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Tue, 5 Mar 2024 19:28:24 -0500
Subject: [PATCH 321/716] AnnasArchiveBridge: correctly handling partial
 matches and file links (#3997)

---
 bridges/AnnasArchiveBridge.php | 40 +++++++++++++++++++---------------
 1 file changed, 23 insertions(+), 17 deletions(-)

diff --git a/bridges/AnnasArchiveBridge.php b/bridges/AnnasArchiveBridge.php
index acb943b4..b857fadf 100644
--- a/bridges/AnnasArchiveBridge.php
+++ b/bridges/AnnasArchiveBridge.php
@@ -126,30 +126,36 @@ class AnnasArchiveBridge extends BridgeAbstract
             return;
         }
 
-        $elements = $list->find('.w-full > .mb-4 > div > a');
+        $elements = $list->find('.w-full > .mb-4 > div');
         foreach ($elements as $element) {
-            $item = [];
-            $item['title'] = $element->find('h3', 0)->plaintext;
-            $item['author'] = $element->find('div.italic', 0)->plaintext;
-            $item['uri'] = $element->href;
-            $item['content'] = $element->plaintext;
-            $item['uid'] = $item['uri'];
+            // stop added entries once partial match list starts
+            if (str_contains($element->innertext, 'partial match')) {
+                break;
+            }
+            if ($element = $element->find('a', 0)) {
+                $item = [];
+                $item['title'] = $element->find('h3', 0)->plaintext;
+                $item['author'] = $element->find('div.italic', 0)->plaintext;
+                $item['uri'] = $element->href;
+                $item['content'] = $element->plaintext;
+                $item['uid'] = $item['uri'];
 
-            $item_html = getSimpleHTMLDOMCached($item['uri'], 86400 * 20);
-            if ($item_html) {
-                $item_html = defaultLinkTo($item_html, self::URI);
-                $item['content'] .= $item_html->find('main img', 0);
-                $item['content'] .= $item_html->find('main .mt-4', 0); // Summary
-                if ($links = $item_html->find('main ul.mb-4', -1)) {
-                    foreach ($links->find('li > a.js-download-link') as $file) {
-                        $item['enclosures'][] = $file->href;
+                $item_html = getSimpleHTMLDOMCached($item['uri'], 86400 * 20);
+                if ($item_html) {
+                    $item_html = defaultLinkTo($item_html, self::URI);
+                    $item['content'] .= $item_html->find('main img', 0);
+                    $item['content'] .= $item_html->find('main .mt-4', 0); // Summary
+                    foreach ($item_html->find('main ul.mb-4 > li > a.js-download-link') as $file) {
+                        if (!str_contains($file->href, 'fast_download')) {
+                            $item['enclosures'][] = $file->href;
+                        }
                     }
                     // Remove bulk torrents from enclosures list
                     $item['enclosures'] = array_diff($item['enclosures'], [self::URI . 'datasets']);
                 }
-            }
 
-            $this->items[] = $item;
+                $this->items[] = $item;
+            }
         }
     }
 

From f7c1b7193961b957dfa0fe192b4a95d09ad9b1c6 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Wed, 6 Mar 2024 13:40:59 -0500
Subject: [PATCH 322/716] NyaaTorrentsBridge: add torrent to enclosures and
 generate better feed name (#3996)

* NyaaTorrentsBridge: add torrent to enclosures and generate better feed name

* NyaaTorrentsBridge: fix accidental () in bridge name
---
 bridges/NyaaTorrentsBridge.php | 31 +++++++++++++++++++------------
 1 file changed, 19 insertions(+), 12 deletions(-)

diff --git a/bridges/NyaaTorrentsBridge.php b/bridges/NyaaTorrentsBridge.php
index fcf2b197..36708411 100644
--- a/bridges/NyaaTorrentsBridge.php
+++ b/bridges/NyaaTorrentsBridge.php
@@ -66,22 +66,20 @@ class NyaaTorrentsBridge extends BridgeAbstract
         $feed = $feedParser->parseFeed(getContents($this->getURI()));
 
         foreach ($feed['items'] as $item) {
-            $item['id'] = str_replace(['https://nyaa.si/download/', '.torrent'], '', $item['uri']);
-            $item['uri'] = str_replace('/download/', '/view/', $item['uri']);
+            $item['enclosures'] = [$item['uri']];
             $item['uri'] = str_replace('.torrent', '', $item['uri']);
+            $item['uri'] = str_replace('/download/', '/view/', $item['uri']);
+            $item['id'] = str_replace('https://nyaa.si/view/', '', $item['uri']);
             $dom = getSimpleHTMLDOMCached($item['uri']);
             if ($dom) {
                 $description = $dom->find('#torrent-description', 0)->innertext ?? '';
-                $itemDom = str_get_html(markdownToHtml(html_entity_decode($description)));
-                $item_image = $this->getURI() . 'static/img/avatar/default.png';
-                foreach ($itemDom->find('img') as $img) {
-                    if (strpos($img->src, 'prez') === false) {
-                        $item_image = $img->src;
-                        break;
-                    }
-                }
-                $item['enclosures'] = [$item_image];
-                $item['content'] = (string) $itemDom;
+                $item['content'] = markdownToHtml(html_entity_decode($description));
+
+                $magnet = $dom->find('div.panel-footer.clearfix > a', 1)->href;
+                // can't put raw magnet link in enclosure, this gives information on
+                // magnet contents and works a way to sent magnet value
+                $magnet = 'https://torrent.parts/#' . html_entity_decode($magnet);
+                array_push($item['enclosures'], $magnet);
             }
             $this->items[] = $item;
             if (count($this->items) >= 10) {
@@ -90,6 +88,15 @@ class NyaaTorrentsBridge extends BridgeAbstract
         }
     }
 
+    public function getName()
+    {
+        $name = parent::getName();
+        $name .= $this->getInput('u') ? ' - ' . $this->getInput('u') : '';
+        $name .= $this->getInput('q') ? ' - ' . $this->getInput('q') : '';
+        $name .= $this->getInput('c') ? ' (' . $this->getKey('c') . ')' : '';
+        return $name;
+    }
+
     public function getIcon()
     {
         return self::URI . 'static/favicon.png';

From 79699131e87e831fc5fa4fb785c210f5396e2bbd Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Fri, 8 Mar 2024 17:16:32 +0530
Subject: [PATCH 323/716] [MaalaimalarBridge] New Bridge (#4001)

---
 bridges/MaalaimalarBridge.php | 117 ++++++++++++++++++++++++++++++++++
 1 file changed, 117 insertions(+)
 create mode 100644 bridges/MaalaimalarBridge.php

diff --git a/bridges/MaalaimalarBridge.php b/bridges/MaalaimalarBridge.php
new file mode 100644
index 00000000..87f85694
--- /dev/null
+++ b/bridges/MaalaimalarBridge.php
@@ -0,0 +1,117 @@
+<?php
+
+class MaalaimalarBridge extends BridgeAbstract
+{
+    const NAME = 'Maalaimalar';
+    const URI = 'https://www.maalaimalar.com/';
+    const DESCRIPTION = 'Retrieve news from maalaimalar.com';
+    const MAINTAINER = 'tillcash';
+    const PARAMETERS = [
+        [
+            'topic' => [
+                'name' => 'topic',
+                'type' => 'list',
+                'values' => [
+                    'news' => [
+                        'tamilnadu' => 'news/state',
+                        'puducherry' => 'puducherry',
+                        'india' => 'news/national',
+                        'world' => 'news/world',
+                    ],
+                    'district' => [
+                        'chennai' => 'chennai',
+                        'ariyalur' => 'ariyalur',
+                        'chengalpattu' => 'chengalpattu',
+                        'coimbatore' => 'coimbatore',
+                        'cuddalore' => 'cuddalore',
+                        'dharmapuri' => 'dharmapuri',
+                        'dindugal' => 'dindugal',
+                        'erode' => 'erode',
+                        'kaanchepuram' => 'kaanchepuram',
+                        'kallakurichi' => 'kallakurichi',
+                        'kanyakumari' => 'kanyakumari',
+                        'karur' => 'karur',
+                        'krishnagiri' => 'krishnagiri',
+                        'madurai' => 'madurai',
+                        'mayiladuthurai' => 'mayiladuthurai',
+                        'nagapattinam' => 'nagapattinam',
+                        'namakal' => 'namakal',
+                        'nilgiris' => 'nilgiris',
+                        'perambalur' => 'perambalur',
+                        'pudukottai' => 'pudukottai',
+                        'ramanathapuram' => 'ramanathapuram',
+                        'ranipettai' => 'ranipettai',
+                        'salem' => 'salem',
+                        'sivagangai' => 'sivagangai',
+                        'tanjore' => 'tanjore',
+                        'theni' => 'theni',
+                        'thenkasi' => 'thenkasi',
+                        'thiruchirapalli' => 'thiruchirapalli',
+                        'thirunelveli' => 'thirunelveli',
+                        'thirupathur' => 'thirupathur',
+                        'thiruvarur' => 'thiruvarur',
+                        'thoothukudi' => 'thoothukudi',
+                        'tirupur' => 'tirupur',
+                        'tiruvallur' => 'tiruvallur',
+                        'tiruvannamalai' => 'tiruvannamalai',
+                        'vellore' => 'vellore',
+                        'villupuram' => 'villupuram',
+                        'virudhunagar' => 'virudhunagar',
+                    ],
+                    'cinema' => [
+                        'news' => 'cinema/cinemanews',
+                        'gossip' => 'cinema/gossip',
+                    ],
+                ],
+            ],
+        ],
+    ];
+
+    public function getName()
+    {
+        $topic = $this->getKey('topic');
+        return self::NAME . ($topic ? ' - ' . ucfirst($topic) : '');
+    }
+
+    public function collectData()
+    {
+        $dom = getSimpleHTMLDOM(self::URI . $this->getInput('topic'));
+        $articles = $dom->find('div.mb-20.infinite-card-wrapper.white-section');
+
+        foreach ($articles as $article) {
+            $titleElement = $article->find('h2.title a', 0);
+            if (!$titleElement) {
+                continue;
+            }
+
+            $dateElement = $article->find('time.h-date span', 0);
+            $date = $dateElement ? $dateElement->{'data-datestring'} . 'UTC' : '';
+
+            $content = $this->constructContent($article);
+
+            $this->items[] = [
+                'content'   => $content,
+                'timestamp' => $date,
+                'title'     => $titleElement->plaintext,
+                'uid'       => $titleElement->href,
+                'uri'       => self::URI . $titleElement->href,
+            ];
+        }
+    }
+
+    private function constructContent($article)
+    {
+        $content = '';
+        $imageElement = $article->find('div.ignore-autoplay img', 0);
+        if ($imageElement) {
+            $content .= '<p><img src="' . $imageElement->{'data-src'} . '"></p>';
+        }
+
+        $storyElement = $article->find('div.story-content', 0);
+        if ($storyElement) {
+            $content .= $storyElement->innertext;
+        }
+
+        return $content;
+    }
+}

From 84b93e0f8f67dd69a242e3ecb1cfd743b5e167e4 Mon Sep 17 00:00:00 2001
From: Jonathan Kay <git@jonathankay.com>
Date: Sun, 10 Mar 2024 10:18:50 -0400
Subject: [PATCH 324/716] [ComicsKingdomBridge] Fix/Rewrite of ComicsKingdom
 Bridge (#4003)

* Rewrite ComicsKingdom Bridge

Rewrite of bridge as the existing one no longer works:
- Now uses REST API
- Added optional limit to get desired number of comics
- Author now reflects the comic creators name
- Feed name and comic titles now pulled from site
- Added myself as the maintainer as I've been the one maintaining, and the existing code no longer is used

* Change API to URI to pass test

* Remove whitespace, add curly braces and switch to single quotes
---
 bridges/ComicsKingdomBridge.php | 66 ++++++++++++++++++---------------
 1 file changed, 36 insertions(+), 30 deletions(-)

diff --git a/bridges/ComicsKingdomBridge.php b/bridges/ComicsKingdomBridge.php
index 8baf7511..227426c4 100644
--- a/bridges/ComicsKingdomBridge.php
+++ b/bridges/ComicsKingdomBridge.php
@@ -2,59 +2,65 @@
 
 class ComicsKingdomBridge extends BridgeAbstract
 {
-    const MAINTAINER = 'stjohnjohnson';
+    const MAINTAINER = 'TReKiE';
+    // const MAINTAINER = 'stjohnjohnson';
     const NAME = 'Comics Kingdom Unofficial RSS';
-    const URI = 'https://comicskingdom.com/';
+    const URI = 'https://wp.comicskingdom.com/wp-json/wp/v2/ck_comic';
     const CACHE_TIMEOUT = 21600; // 6h
     const DESCRIPTION = 'Comics Kingdom Unofficial RSS';
     const PARAMETERS = [ [
         'comicname' => [
-            'name' => 'comicname',
+            'name' => 'Name of comic',
             'type' => 'text',
             'exampleValue' => 'mutts',
             'title' => 'The name of the comic in the URL after https://comicskingdom.com/',
             'required' => true
+        ],
+        'limit' => [
+            'name' => 'Limit',
+            'type' => 'number',
+            'title' => 'The number of recent comics to get',
+            'defaultValue' => 10
         ]
     ]];
 
+    protected $comicName;
+
     public function collectData()
     {
-        $html = getSimpleHTMLDOM($this->getURI(), [], [], true, false);
+        $json = getContents($this->getURI());
+        $data = json_decode($json, false);
 
-        // Get author from first page
-        $author = $html->find('div.author p', 0);
-        ;
+        if (isset($data[0]->_embedded->{'wp:term'}[0][0])) {
+            $this->comicName = $data[0]->_embedded->{'wp:term'}[0][0]->name;
+        }
 
-        // Get current date/link
-        $link = $html->find('meta[property=og:url]', -1)->content;
-        for ($i = 0; $i < 3; $i++) {
+        foreach ($data as $comicitem) {
             $item = [];
 
-            $page = getSimpleHTMLDOM($link);
-
-            $imagelink = $page->find('meta[property=og:image]', 0)->content;
-
-            $date = explode('/', $link);
-
-            $item['id'] = $imagelink;
-            $item['uri'] = $link;
-            $item['author'] = $author;
-            $item['title'] = 'Comics Kingdom ' . $this->getInput('comicname');
-            $item['timestamp'] = DateTime::createFromFormat('Y-m-d', $date[count($date) - 1])->getTimestamp();
-            $item['content'] = '<img src="' . $imagelink . '" />';
-
+            $item['id'] = $comicitem->id;
+            $item['uri'] = $comicitem->yoast_head_json->og_url;
+            $item['author'] = str_ireplace('By ', '', $comicitem->ck_comic_byline);
+            $item['title'] = $comicitem->yoast_head_json->title;
+            $item['timestamp'] = $comicitem->date;
+            $item['content'] = '<img src="' . $comicitem->yoast_head_json->og_image[0]->url . '" />';
             $this->items[] = $item;
-            $link = $page->find('div.comic-viewer-inline a', 0)->href;
-            if (empty($link)) {
-                break; // allow bridge to continue if there's less than 3 comics
-            }
         }
     }
 
     public function getURI()
     {
         if (!is_null($this->getInput('comicname'))) {
-            return self::URI . urlencode($this->getInput('comicname'));
+            $params = [
+                'ck_feature'        => $this->getInput('comicname'),
+                'per_page'          => $this->getInput('limit'),
+                'date_inclusive'    => 'true',
+                'order'             => 'desc',
+                'page'              => '1',
+                '_embed'            => 'true'
+            ];
+
+            return self::URI . '?' . http_build_query($params);
         }
 
         return parent::getURI();
@@ -62,8 +68,8 @@ class ComicsKingdomBridge extends BridgeAbstract
 
     public function getName()
     {
-        if (!is_null($this->getInput('comicname'))) {
-            return $this->getInput('comicname') . ' - Comics Kingdom';
+        if ($this->comicName) {
+            return $this->comicName . ' - Comics Kingdom';
         }
 
         return parent::getName();

From 254efc281255a5d3308d33007e09ffd3bc2df49e Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Sun, 10 Mar 2024 22:21:10 +0100
Subject: [PATCH 325/716] [ZeitBridge] Remove doubled text
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The first two paragraphs were repeated at the end of articles. The first
CSS selector filters those out (example 1).
The second CSS selector removes a "Zum Anschauen benötigen wir Ihre Zustimmung"
line from a poll widget. We can't load the widget successfully,
therefore we should remove all embeds that seem to use javascript
(example 2).

1: https://www.zeit.de/campus/2024-03/bundesregierung-wissenschaft-arbeitsvertrag-regeln
2: https://www.zeit.de/campus/2024-03/ausbildung-abgebrochen-gruende-azubi-aufruf
---
 bridges/ZeitBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/ZeitBridge.php b/bridges/ZeitBridge.php
index 0ed9276b..b9806e5a 100644
--- a/bridges/ZeitBridge.php
+++ b/bridges/ZeitBridge.php
@@ -87,7 +87,7 @@ class ZeitBridge extends FeedExpander
         // remove known bad elements
         foreach (
             $article->find(
-                'aside, .visually-hidden, .carousel-container, #tickaroo-liveblog, .zplus-badge, .article-heading__container--podcast'
+                'aside, .visually-hidden, .carousel-container, #tickaroo-liveblog, .zplus-badge, .article-heading__container--podcast, div[data-paywall], .js-embed-consent'
             ) as $bad
         ) {
             $bad->remove();

From ecf61f6fa777fcaeb6ce0bdf1c82cdcbc89e74a1 Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Tue, 12 Mar 2024 00:44:10 +0530
Subject: [PATCH 326/716] [DailythanthiBridge] New Bridge (#4006)

---
 bridges/DailythanthiBridge.php | 96 ++++++++++++++++++++++++++++++++++
 1 file changed, 96 insertions(+)
 create mode 100644 bridges/DailythanthiBridge.php

diff --git a/bridges/DailythanthiBridge.php b/bridges/DailythanthiBridge.php
new file mode 100644
index 00000000..114f42d8
--- /dev/null
+++ b/bridges/DailythanthiBridge.php
@@ -0,0 +1,96 @@
+<?php
+
+class DailythanthiBridge extends BridgeAbstract
+{
+    const NAME = 'Dailythanthi';
+    const URI = 'https://www.dailythanthi.com/';
+    const DESCRIPTION = 'Retrieve news from dailythanthi.com';
+    const MAINTAINER = 'tillcash';
+    const PARAMETERS = [
+        [
+            'topic' => [
+                'name' => 'topic',
+                'type' => 'list',
+                'values' => [
+                    'news' => [
+                        'tamilnadu' => 'news/state',
+                        'india' => 'news/india',
+                        'world' => 'news/world',
+                        'sirappu-katturaigal' => 'news/sirappukatturaigal',
+                    ],
+                    'cinema' => [
+                        'news' => 'cinema/cinemanews',
+                    ],
+                    'sports' => [
+                        'sports' => 'sports',
+                        'cricket' => 'sports/cricket',
+                        'football' => 'sports/football',
+                        'tennis' => 'sports/tennis',
+                        'hockey' => 'sports/hockey',
+                        'other-sports' => 'sports/othersports',
+                    ],
+                    'devotional' => [
+                        'devotional' => 'others/devotional',
+                        'aalaya-varalaru' => 'aalaya-varalaru',
+                    ],
+                ],
+            ],
+        ],
+    ];
+
+    public function getName()
+    {
+        $topic = $this->getKey('topic');
+        return self::NAME . ($topic ? ' - ' . ucfirst($topic) : '');
+    }
+
+    public function collectData()
+    {
+        $dom = getSimpleHTMLDOM(self::URI . $this->getInput('topic'));
+
+        foreach ($dom->find('div.ListingNewsWithMEDImage') as $element) {
+            $slug = $element->find('a', 1);
+            $title = $element->find('h3', 0);
+            if (!$slug || !$title) {
+                continue;
+            }
+
+            $url = self::URI . $slug->href;
+            $date = $element->find('span', 1);
+            $date = $date ? $date->{'data-datestring'} : '';
+
+            $this->items[] = [
+                'content'   => $this->constructContent($url),
+                'timestamp' => $date ? $date . 'UTC' : '',
+                'title'     => $title->plaintext,
+                'uid'       => $slug->href,
+                'uri'       => $url,
+            ];
+        }
+    }
+
+    private function constructContent($url)
+    {
+        $dom = getSimpleHTMLDOMCached($url);
+
+        $article = $dom->find('div.details-content-story', 0);
+        if (!$article) {
+            return 'Content Not Found';
+        }
+
+        // Remove ads
+        foreach ($article->find('div[id*="_ad"]') as $remove) {
+            $remove->outertext = '';
+        }
+
+        // Correct image tag in $article
+        foreach ($article->find('h-img') as $img) {
+            $img->parent->outertext = sprintf('<p><img src="%s"></p>', $img->src);
+        }
+
+        $image = $dom->find('div.main-image-caption-container img', 0);
+        $image = $image ? '<p>' . $image->outertext . '</p>' : '';
+
+        return $image . $article;
+    }
+}

From 5b80af978fdd0a7ea566d9a69d669e0b22b0378a Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 12 Mar 2024 19:46:21 +0100
Subject: [PATCH 327/716] docs: improve README (#4009)

---
 README.md | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index f8d08058..6124a4ea 100644
--- a/README.md
+++ b/README.md
@@ -64,7 +64,7 @@ These instructions have been tested on a fresh Debian 12 VM from Digital Ocean (
 ```shell
 timedatectl set-timezone Europe/Oslo
 
-apt install git nginx php8.2-fpm php-mbstring php-simplexml php-curl
+apt install git nginx php8.2-fpm php-mbstring php-simplexml php-curl php-intl
 
 # Create a new user account
 useradd --shell /bin/bash --create-home rss-bridge
@@ -167,12 +167,10 @@ Restart fpm and nginx:
 
 ```shell
 # Lint and restart php-fpm
-php-fpm8.2 -t
-systemctl restart php8.2-fpm
+php-fpm8.2 -t && systemctl restart php8.2-fpm
 
 # Lint and restart nginx
-nginx -t
-systemctl restart nginx
+nginx -t && systemctl restart nginx
 ```
 
 ### How to install from Composer

From 4bad1c140a25d8ef8577d0fa7b0a60e27a5d7649 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 12 Mar 2024 23:59:10 +0100
Subject: [PATCH 328/716] fix(reddit): url encoding (#4010)

---
 bridges/RedditBridge.php           | 55 ++++++++++++++++--------------
 tests/BridgeImplementationTest.php | 23 -------------
 tests/RedditBridgeTest.php         | 33 ++++++++++++++++++
 3 files changed, 62 insertions(+), 49 deletions(-)
 create mode 100644 tests/RedditBridgeTest.php

diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index 9c72f996..e2f79b11 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -139,36 +139,13 @@ class RedditBridge extends BridgeAbstract
                 break;
         }
 
-        if (!($this->getInput('search') === '')) {
-            $keywords = $this->getInput('search');
-            $keywords = str_replace([',', ' '], '%20', $keywords);
-            $keywords = $keywords . '%20';
-        } else {
-            $keywords = '';
-        }
-
-        if (!empty($this->getInput('f')) && $this->queriedContext == 'single') {
-            $flair = $this->getInput('f');
-            $flair = str_replace(' ', '%20', $flair);
-            $flair = 'flair%3A%22' . $flair . '%22%20';
-        } else {
-            $flair = '';
-        }
+        $search = $this->getInput('search');
+        $flareInput = $this->getInput('f');
 
         foreach ($subreddits as $subreddit) {
-            $name = trim($subreddit);
-            $url = self::URI
-                . '/search.json?q='
-                . $keywords
-                . $flair
-                . ($user ? 'author%3A' : 'subreddit%3A')
-                . $name
-                . '&sort='
-                . $this->getInput('d')
-                . '&include_over_18=on';
-
             $version = 'v0.0.1';
             $useragent = "rss-bridge $version (https://github.com/RSS-Bridge/rss-bridge)";
+            $url = self::createUrl($search, $flareInput, $subreddit, $user, $section, $this->queriedContext);
             $json = getContents($url, ['User-Agent: ' . $useragent]);
             $parsedJson = Json::decode($json, false);
 
@@ -278,6 +255,32 @@ class RedditBridge extends BridgeAbstract
         });
     }
 
+    public static function createUrl($search, $flareInput, $subreddit, bool $user, $section, $queriedContext): string
+    {
+        if ($search === '') {
+            $keywords = '';
+        } else {
+            $keywords = $search;
+            $keywords = str_replace([',', ' '], ' ', $keywords);
+            $keywords = $keywords . ' ';
+        }
+
+        if ($flareInput && $queriedContext == 'single') {
+            $flair = $flareInput;
+            $flair = str_replace([',', ' '], ' ', $flair);
+            $flair = 'flair:"' . $flair . '" ';
+        } else {
+            $flair = '';
+        }
+        $name = trim($subreddit);
+        $query = [
+            'q' => $keywords . $flair . ($user ? 'author:' : 'subreddit:') . $name,
+            'sort' => $section,
+            'include_over_18' => 'on',
+        ];
+        return 'https://old.reddit.com/search.json?' . http_build_query($query);
+    }
+
     public function getIcon()
     {
         return 'https://www.redditstatic.com/desktop2x/img/favicon/favicon-96x96.png';
diff --git a/tests/BridgeImplementationTest.php b/tests/BridgeImplementationTest.php
index d2f74931..dd68934e 100644
--- a/tests/BridgeImplementationTest.php
+++ b/tests/BridgeImplementationTest.php
@@ -157,29 +157,6 @@ class BridgeImplementationTest extends TestCase
         }
     }
 
-    /**
-     * @dataProvider dataBridgesProvider
-     */
-    public function testVisibleMethods($path)
-    {
-        $bridgeAbstractMethods = get_class_methods(BridgeAbstract::class);
-        sort($bridgeAbstractMethods);
-        $feedExpanderMethods = get_class_methods(FeedExpander::class);
-        sort($feedExpanderMethods);
-
-        $this->setBridge($path);
-
-        $publicMethods = get_class_methods($this->bridge);
-        sort($publicMethods);
-        foreach ($publicMethods as $publicMethod) {
-            if ($this->bridge instanceof FeedExpander) {
-                $this->assertContains($publicMethod, $feedExpanderMethods);
-            } else {
-                $this->assertContains($publicMethod, $bridgeAbstractMethods);
-            }
-        }
-    }
-
     /**
      * @dataProvider dataBridgesProvider
      */
diff --git a/tests/RedditBridgeTest.php b/tests/RedditBridgeTest.php
new file mode 100644
index 00000000..17a62e68
--- /dev/null
+++ b/tests/RedditBridgeTest.php
@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+use PHPUnit\Framework\TestCase;
+
+class RedditBridgeTest extends TestCase
+{
+    public function test()
+    {
+        $sut = new RedditBridge(new NullCache(), new NullLogger());
+
+        // https://old.reddit.com/search.json?q=cats dogs hen subreddit:php&sort=hot&include_over_18=on
+        $expected = 'https://old.reddit.com/search.json?q=cats+dogs+hen+subreddit%3Aphp&sort=hot&include_over_18=on';
+        $actual = RedditBridge::createUrl('cats,dogs hen', '', 'php', false, 'hot', 'single');
+        $this->assertSame($expected, $actual);
+
+        // https://old.reddit.com/search.json?q=author:RavenousRandy&sort=hot&include_over_18=on
+        $expected = 'https://old.reddit.com/search.json?q=author%3ARavenousRandy&sort=hot&include_over_18=on';
+        $actual = RedditBridge::createUrl('', '', 'RavenousRandy', true, 'hot', 'user');
+        $this->assertSame($expected, $actual);
+
+        // https://old.reddit.com/search.json?q=cats dogs hen flair:"Proxy" subreddit:php&sort=hot&include_over_18=on
+        $expected = 'https://old.reddit.com/search.json?q=cats+dogs+hen+flair%3A%22Proxy%22+subreddit%3Aphp&sort=hot&include_over_18=on';
+        $actual = RedditBridge::createUrl('cats,dogs hen', 'Proxy', 'php', false, 'hot', 'single');
+        $this->assertSame($expected, $actual);
+
+        // https://old.reddit.com/search.json?q=cats dogs hen flair:"Proxy Linux Server" subreddit:php&sort=hot&include_over_18=on
+        $expected = 'https://old.reddit.com/search.json?q=cats+dogs+hen+flair%3A%22Proxy+Linux+Server%22+subreddit%3Aphp&sort=hot&include_over_18=on';
+        $actual = RedditBridge::createUrl('cats,dogs hen', 'Proxy,Linux Server', 'php', false, 'hot', 'single');
+        $this->assertSame($expected, $actual);
+    }
+}

From e6cb5fdc89f2ad4137657cccea79fbdc23bb37cb Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Wed, 13 Mar 2024 23:47:46 +0100
Subject: [PATCH 329/716] [IdealoBridge] Fix Feed items & Feed title
 customisation (#4013)

- Feed items with new price tracking had "Max Price Used" instead of
  "Max Price New"
- Feed Title is now customised with the product name and the Price
  limits
- Fixed logic for saving prices in cache
- remove undefined variable notices
---
 bridges/IdealoBridge.php | 83 +++++++++++++++++++++++++++++++++-------
 1 file changed, 69 insertions(+), 14 deletions(-)

diff --git a/bridges/IdealoBridge.php b/bridges/IdealoBridge.php
index cef2b812..fe13e13d 100644
--- a/bridges/IdealoBridge.php
+++ b/bridges/IdealoBridge.php
@@ -40,6 +40,47 @@ class IdealoBridge extends BridgeAbstract
         return 'https://cdn.idealo.com/storage/ids-assets/ico/favicon.ico';
     }
 
+    /**
+     * Returns the RSS Feed title when a RSS feed is rendered
+     * @return string the RSS feed Title
+     */
+    private function getFeedTitle()
+    {
+        $cacheDuration = 604800;
+        $link = $this->getInput('Link');
+        $keyTITLE = $link . 'TITLE';
+        $product = $this->loadCacheValue($keyTITLE, $cacheDuration);
+
+        // The cache does not contain the title of the bridge, we must get it and save it in the cache
+        if ($product === null) {
+            $header = [
+                'user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.2.1 Safari/605.1.15'
+            ];
+            $html = getSimpleHTMLDOM($link, $header);
+            $product = $html->find('.oopStage-title', 0)->find('span', 0)->plaintext;
+            $this->saveCacheValue($keyTITLE, $product);
+        }
+
+        $MaxPriceUsed = $this->getInput('MaxPriceUsed');
+        $MaxPriceNew = $this->getInput('MaxPriceNew');
+        $titleParts = [];
+
+        $titleParts[] = $product;
+
+        // Add Max Prices to the title
+        if ($MaxPriceUsed !== null) {
+            $titleParts[] = 'Max Price Used : ' . $MaxPriceUsed . '€';
+        }
+        if ($MaxPriceNew !== null) {
+            $titleParts[] = 'Max Price New : ' . $MaxPriceNew . '€';
+        }
+
+        $title = implode(' ', $titleParts);
+
+
+        return $title . ' - ' . $this::NAME;
+    }
+
     public function collectData()
     {
         // Needs header with user-agent to function properly.
@@ -69,12 +110,16 @@ class IdealoBridge extends BridgeAbstract
         $FirstButton = $html->find('.oopStage-conditionButton-wrapper-text', 0);
         if ($FirstButton) {
             $PriceNew = $FirstButton->find('strong', 0)->plaintext;
+            // Save current price
+            $this->saveCacheValue($KeyNEW, $PriceNew);
         }
 
         // Second Button is used
         $SecondButton = $html->find('.oopStage-conditionButton-wrapper-text', 1);
         if ($SecondButton) {
             $PriceUsed = $SecondButton->find('strong', 0)->plaintext;
+            // Save current price
+            $this->saveCacheValue($KeyUSED, $PriceUsed);
         }
 
         // Only continue if a price has changed
@@ -83,16 +128,16 @@ class IdealoBridge extends BridgeAbstract
             $image = $html->find('.datasheet-cover-image', 0)->src;
 
             // Generate Content
-            if ($PriceNew > 1) {
+            if (isset($PriceNew) && $PriceNew > 1) {
                 $content = "<p><b>Price New:</b><br>$PriceNew</p>";
                 $content .= "<p><b>Price New before:</b><br>$OldPriceNew</p>";
             }
 
             if ($this->getInput('MaxPriceNew') != '') {
-                $content .= sprintf('<p><b>Max Price Used:</b><br>%s,00 €</p>', $this->getInput('MaxPriceNew'));
+                $content .= sprintf('<p><b>Max Price New:</b><br>%s,00 €</p>', $this->getInput('MaxPriceNew'));
             }
 
-            if ($PriceUsed > 1) {
+            if (isset($PriceUsed) && $PriceUsed > 1) {
                 $content .= "<p><b>Price Used:</b><br>$PriceUsed</p>";
                 $content .= "<p><b>Price Used before:</b><br>$OldPriceUsed</p>";
             }
@@ -110,8 +155,8 @@ class IdealoBridge extends BridgeAbstract
 
             // Currently under Max new price
             if ($this->getInput('MaxPriceNew') != '') {
-                if ($PriceNew < $this->getInput('MaxPriceNew')) {
-                    $title = sprintf($Pricealarm, 'Used', $PriceNew, $Productname, $now);
+                if (isset($PriceNew) && $PriceNew < $this->getInput('MaxPriceNew')) {
+                    $title = sprintf($Pricealarm, 'New', $PriceNew, $Productname, $now);
                     $item = [
                         'title'     => $title,
                         'uri'       => $link,
@@ -124,7 +169,7 @@ class IdealoBridge extends BridgeAbstract
 
             // Currently under Max used price
             if ($this->getInput('MaxPriceUsed') != '') {
-                if ($PriceUsed < $this->getInput('MaxPriceUsed')) {
+                if (isset($PriceUsed) && $PriceUsed < $this->getInput('MaxPriceUsed')) {
                     $title = sprintf($Pricealarm, 'Used', $PriceUsed, $Productname, $now);
                     $item = [
                         'title'     => $title,
@@ -143,23 +188,23 @@ class IdealoBridge extends BridgeAbstract
                     (!$this->getInput('ExcludeNew') && $PriceNew != $OldPriceNew ) ||
                     (!$this->getInput('ExcludeUsed') && $PriceUsed != $OldPriceUsed )
                 ) {
-                    $title .= 'Priceupdate! ';
+                    $title = 'Priceupdate! ';
 
                     if (!$this->getInput('ExcludeNew')) {
-                        if ($PriceNew < $OldPriceNew) {
+                        if (isset($PriceNew) &&  $PriceNew < $OldPriceNew) {
                             $title .= 'NEW:&#11015 '; // Arrow Down Emoji
                         }
-                        if ($PriceNew > $OldPriceNew) {
+                        if (isset($PriceNew) && $PriceNew > $OldPriceNew) {
                             $title .= 'NEW:&#11014 '; // Arrow Up Emoji
                         }
                     }
 
 
                     if (!$this->getInput('ExcludeUsed')) {
-                        if ($PriceUsed < $OldPriceUsed) {
+                        if (isset($PriceUsed) && $PriceUsed < $OldPriceUsed) {
                             $title .= 'USED:&#11015 '; // Arrow Down Emoji
                         }
-                        if ($PriceUsed > $OldPriceUsed) {
+                        if (isset($PriceUsed) && $PriceUsed > $OldPriceUsed) {
                             $title .= 'USED:&#11014 '; // Arrow Up Emoji
                         }
                     }
@@ -177,9 +222,19 @@ class IdealoBridge extends BridgeAbstract
                 }
             }
         }
+    }
 
-        // Save current price
-        $this->saveCacheValue($KeyNEW, $PriceNew);
-        $this->saveCacheValue($KeyUSED, $PriceUsed);
+    /**
+     * Returns the RSS Feed title according to the parameters
+     * @return string the RSS feed Tile
+     */
+    public function getName()
+    {
+        switch ($this->queriedContext) {
+            case '0':
+                return $this->getFeedTitle();
+            default:
+                return parent::getName();
+        }
     }
 }

From 36147a082d33faeef6e42fa103a3283cc5cf5dc3 Mon Sep 17 00:00:00 2001
From: Tim-Florian Feulner <50834839+R3dError@users.noreply.github.com>
Date: Fri, 15 Mar 2024 19:20:04 +0100
Subject: [PATCH 330/716] Fix NACSouthGermanyMediaLibraryBridge for new website
 layout (#4014)

---
 bridges/NACSouthGermanyMediaLibraryBridge.php | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/bridges/NACSouthGermanyMediaLibraryBridge.php b/bridges/NACSouthGermanyMediaLibraryBridge.php
index fff6c554..030ded8f 100644
--- a/bridges/NACSouthGermanyMediaLibraryBridge.php
+++ b/bridges/NACSouthGermanyMediaLibraryBridge.php
@@ -31,7 +31,7 @@ class NACSouthGermanyMediaLibraryBridge extends BridgeAbstract
 
     public function getIcon()
     {
-        return 'https://www.nak-stuttgart.de/static/themes/nak_sued/images/nak-logo.png';
+        return 'https://nak-sued.de/static/themes/sued/images/logo.png';
     }
 
     private static function parseTimestamp($title)
@@ -66,9 +66,12 @@ class NACSouthGermanyMediaLibraryBridge extends BridgeAbstract
     private static function collectDataForBayern2($parent, $item)
     {
         # Find link
-        $playerDom = getSimpleHTMLDOMCached(self::BASE_URI . $parent->find('a', 0)->href);
-        $sourceURI = $playerDom->find('source', 0)->src;
-        $item['enclosures'] = [self::BASE_URI . $sourceURI];
+        $relativeURICode = $parent->find('a', 0)->onclick;
+        if (preg_match('/window\.open\(\'([^\']*)\'/', $relativeURICode, $matches)) {
+            $playerDom = getSimpleHTMLDOMCached(self::BASE_URI . $matches[1]);
+            $sourceURI = $playerDom->find('source', 0)->src;
+            $item['enclosures'] = [self::BASE_URI . $sourceURI];
+        }
 
         # Add time to timestamp
         $item['timestamp'] .= ' 06:45';
@@ -78,14 +81,14 @@ class NACSouthGermanyMediaLibraryBridge extends BridgeAbstract
 
     private function collectDataInList($pageURI, $customizeItemCall)
     {
-        $page = getSimpleHTMLDOM(self::BASE_URI . $pageURI);
+        $page = getSimpleHTMLDOM($pageURI);
 
-        foreach ($page->find('div.grids') as $parent) {
+        foreach ($page->find('div.flex-columns.entry') as $parent) {
             # Find title
             $title = $parent->find('h2', 0)->plaintext;
 
             # Find content
-            $contentBlock = $parent->find('ul.contentlist', 0);
+            $contentBlock = $parent->find('ul', 0);
             $content = '';
             foreach ($contentBlock->find('li') as $li) {
                 $content .= '<p>' . $li->plaintext . '</p>';
@@ -103,7 +106,7 @@ class NACSouthGermanyMediaLibraryBridge extends BridgeAbstract
     private function collectDataFromAllPages($rootURI, $customizeItemCall)
     {
         $rootPage = getSimpleHTMLDOM($rootURI);
-        $pages = $rootPage->find('div#tabmenu', 0);
+        $pages = $rootPage->find('div.flex-columns.inner_filter', 0);
         foreach ($pages->find('a') as $page) {
             self::collectDataInList($page->href, [$this, $customizeItemCall]);
         }

From a61524bf776fb29aaf30451c972f1ddb90920fdf Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Sun, 17 Mar 2024 19:02:51 +0100
Subject: [PATCH 331/716] Update RedditBridge.php (#4019)

prevent error htmlspecialchars_decode(): Passing null to parameter #1
---
 bridges/RedditBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index e2f79b11..fbc6f678 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -189,7 +189,7 @@ class RedditBridge extends BridgeAbstract
                     // Comment
 
                     $item['content'] = htmlspecialchars_decode($data->body_html);
-                } elseif ($data->is_self) {
+                } elseif ($data->is_self && isset($data->selftext_html)) {
                     // Text post
 
                     $item['content'] = htmlspecialchars_decode($data->selftext_html);

From 58e2b56d40e0cae1cd3689f8c946650e5caba4cf Mon Sep 17 00:00:00 2001
From: Patrick <jummo4@yahoo.de>
Date: Sun, 17 Mar 2024 19:03:09 +0100
Subject: [PATCH 332/716] Adjustment to new website layout (#4020)

---
 bridges/JohannesBlickBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/JohannesBlickBridge.php b/bridges/JohannesBlickBridge.php
index 6c00feca..72583a53 100644
--- a/bridges/JohannesBlickBridge.php
+++ b/bridges/JohannesBlickBridge.php
@@ -13,7 +13,7 @@ class JohannesBlickBridge extends BridgeAbstract
             or returnServerError('Could not request: ' . self::URI);
 
         $html = defaultLinkTo($html, self::URI);
-        foreach ($html->find('td > a') as $index => $a) {
+        foreach ($html->find('ul[class=easyfolderlisting] > li > a') as $index => $a) {
             $item = []; // Create an empty item
             $articlePath = $a->href;
             $item['title'] = $a->innertext;

From 3ed193eee2e873496ca3635561c61e0e8ba49edd Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Fri, 22 Mar 2024 09:44:42 +0100
Subject: [PATCH 333/716] [IdealoBridge] Update Bridge Meta data & (#4022)

The bridge meta data has been updated to reflect that the bridge works
for other international version of Idealo.

The Price trend is displayed on every price in the the Feed element
content. The same function is now used to show the price trend in the
Feed element title, to remove some duplicate code..
---
 bridges/IdealoBridge.php | 46 ++++++++++++++++++++++++----------------
 1 file changed, 28 insertions(+), 18 deletions(-)

diff --git a/bridges/IdealoBridge.php b/bridges/IdealoBridge.php
index fe13e13d..4eb66dcb 100644
--- a/bridges/IdealoBridge.php
+++ b/bridges/IdealoBridge.php
@@ -2,15 +2,15 @@
 
 class IdealoBridge extends BridgeAbstract
 {
-    const NAME = 'Idealo.de Bridge';
+    const NAME = 'idealo.de / idealo.fr / idealo.es Bridge';
     const URI = 'https://www.idealo.de';
-    const DESCRIPTION = 'Tracks the price for a product on idealo.de. Pricealarm if specific price is set';
+    const DESCRIPTION = 'Tracks the price for a product on idealo.de / idealo.fr / idealo.es. Pricealarm if specific price is set';
     const MAINTAINER = 'SebLaus';
     const CACHE_TIMEOUT = 60 * 30; // 30 min
     const PARAMETERS = [
         [
             'Link' => [
-                'name'          => 'Idealo.de Link to productpage',
+                'name'          => 'idealo.de / idealo.fr / idealo.es Link to productpage',
                 'required'      => true,
                 'exampleValue'  => 'https://www.idealo.de/preisvergleich/OffersOfProduct/202007367_-s7-pro-ultra-roborock.html'
             ],
@@ -81,6 +81,25 @@ class IdealoBridge extends BridgeAbstract
         return $title . ' - ' . $this::NAME;
     }
 
+
+    /**
+     * Returns the Price Trend emoji
+     * @return string the Price Trend Emoji
+     */
+    private function getPriceTrend($NewPrice, $OldPrice)
+    {
+        // In case there is no old PRice, then show no trend
+        if ($OldPrice === null) {
+            $trend = '';
+        } else if ($NewPrice > $OldPrice) {
+            $trend = '&#x2197;';
+        } else if ($NewPrice == $OldPrice) {
+            $trend = '&#x27A1;';
+        } else if ($NewPrice < $OldPrice) {
+            $trend = '&#x2198;';
+        }
+        return $trend;
+    }
     public function collectData()
     {
         // Needs header with user-agent to function properly.
@@ -127,9 +146,11 @@ class IdealoBridge extends BridgeAbstract
             // Get Product Image
             $image = $html->find('.datasheet-cover-image', 0)->src;
 
+            $content = '';
+
             // Generate Content
             if (isset($PriceNew) && $PriceNew > 1) {
-                $content = "<p><b>Price New:</b><br>$PriceNew</p>";
+                $content .= sprintf('<p><b>Price New:</b><br>%s %s</p>', $PriceNew, $this->getPriceTrend($PriceNew, $OldPriceNew));
                 $content .= "<p><b>Price New before:</b><br>$OldPriceNew</p>";
             }
 
@@ -138,7 +159,7 @@ class IdealoBridge extends BridgeAbstract
             }
 
             if (isset($PriceUsed) && $PriceUsed > 1) {
-                $content .= "<p><b>Price Used:</b><br>$PriceUsed</p>";
+                $content .= sprintf('<p><b>Price Used:</b><br>%s %s</p>', $PriceUsed, $this->getPriceTrend($PriceUsed, $OldPriceUsed));
                 $content .= "<p><b>Price Used before:</b><br>$OldPriceUsed</p>";
             }
 
@@ -191,22 +212,11 @@ class IdealoBridge extends BridgeAbstract
                     $title = 'Priceupdate! ';
 
                     if (!$this->getInput('ExcludeNew')) {
-                        if (isset($PriceNew) &&  $PriceNew < $OldPriceNew) {
-                            $title .= 'NEW:&#11015 '; // Arrow Down Emoji
-                        }
-                        if (isset($PriceNew) && $PriceNew > $OldPriceNew) {
-                            $title .= 'NEW:&#11014 '; // Arrow Up Emoji
-                        }
+                        $title .= 'NEW' . $this->getPriceTrend($PriceNew, $OldPriceNew) . ' ';
                     }
 
-
                     if (!$this->getInput('ExcludeUsed')) {
-                        if (isset($PriceUsed) && $PriceUsed < $OldPriceUsed) {
-                            $title .= 'USED:&#11015 '; // Arrow Down Emoji
-                        }
-                        if (isset($PriceUsed) && $PriceUsed > $OldPriceUsed) {
-                            $title .= 'USED:&#11014 '; // Arrow Up Emoji
-                        }
+                        $title .= 'USED' . $this->getPriceTrend($PriceUsed, $OldPriceUsed) . ' ';
                     }
                     $title .= $Productname;
                     $title .= ' ';

From 2aace6c898c2d0f473b0a2071bf3e2d7e1f8e4d4 Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Fri, 22 Mar 2024 21:01:16 +0100
Subject: [PATCH 334/716] Added Bridge for Anisearch.de (#4023)

* Create AnisearchBridge.php

* Update AnisearchBridge.php

* Update AnisearchBridge.php
---
 bridges/AnisearchBridge.php | 54 +++++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 bridges/AnisearchBridge.php

diff --git a/bridges/AnisearchBridge.php b/bridges/AnisearchBridge.php
new file mode 100644
index 00000000..639d143f
--- /dev/null
+++ b/bridges/AnisearchBridge.php
@@ -0,0 +1,54 @@
+<?php
+
+class AnisearchBridge extends BridgeAbstract
+{
+    const MAINTAINER = 'Tone866';
+    const NAME = 'Anisearch';
+    const URI = 'https://www.anisearch.de';
+    const CACHE_TIMEOUT = 1800; // 30min
+    const DESCRIPTION = 'Feed for Anisearch';
+    const PARAMETERS = [[
+        'category' => [
+            'name' => 'Dub',
+            'type' => 'list',
+            'values' => [
+                'DE'
+                => 'https://www.anisearch.de/anime/index/page-1?char=all&synchro=de&sort=date&order=desc&view=4',
+                'EN'
+                => 'https://www.anisearch.de/anime/index/page-1?char=all&synchro=en&sort=date&order=desc&view=4',
+                'JP'
+                => 'https://www.anisearch.de/anime/index/page-1?char=all&synchro=ja&sort=date&order=desc&view=4'
+            ]
+        ]
+    ]];
+
+    public function collectData()
+    {
+        $baseurl = 'https://www.anisearch.de/';
+        $limit = 10;
+        $dom = getSimpleHTMLDOM($this->getInput('category'));
+        foreach ($dom->find('li.btype0') as $key => $li) {
+            if ($key > $limit) {
+                break;
+            }
+
+            $a = $li->find('a', 0);
+            $title = $a->find('span.title', 0);
+            $url = $baseurl . $a->href;
+
+            //get article
+            $domarticle = getSimpleHTMLDOM($url);
+            $content = $domarticle->find('div.details-text', 0);
+
+            //get header-image and set absolute src
+            $headerimage = $domarticle->find('img#details-cover', 0);
+            $src = $headerimage->src;
+
+            $this->items[] = [
+                'title' => $title->plaintext,
+                'uri' => $url,
+                'content' => $headerimage . '<br />' . $content
+            ];
+        }
+    }
+}

From fee5e269d0763aade289677d6685ebd8bd45c542 Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Sun, 24 Mar 2024 16:38:51 +0100
Subject: [PATCH 335/716] Update CaschyBridge.php (#4027)

without removing the video-container-div the embedded youtube videos work again
---
 bridges/CaschyBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/CaschyBridge.php b/bridges/CaschyBridge.php
index 0e3a07bc..c25cdb08 100644
--- a/bridges/CaschyBridge.php
+++ b/bridges/CaschyBridge.php
@@ -54,7 +54,7 @@ class CaschyBridge extends FeedExpander
     {
         // remove unwanted stuff
         foreach (
-            $article->find('div.video-container, div.aawp, p.aawp-disclaimer, iframe.wp-embedded-content, 
+            $article->find('div.aawp, p.aawp-disclaimer, iframe.wp-embedded-content, 
             div.wp-embed, p.wp-caption-text, script') as $element
         ) {
             $element->remove();

From 0c2099a8529faad54d848dd73cfc6bd839abb5ba Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Thu, 28 Mar 2024 19:41:56 +0100
Subject: [PATCH 336/716] [GolemBridge] fixed embedded youtube videos (#4033)

* [GolemBridge] fixed embedded youtube videos

embedded youtube-videos can be played directly from feed now

* Update GolemBridge.php

* Update GolemBridge.php

* Update GolemBridge.php

* Update GolemBridge.php
---
 bridges/GolemBridge.php | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/bridges/GolemBridge.php b/bridges/GolemBridge.php
index 599d713a..216e913f 100644
--- a/bridges/GolemBridge.php
+++ b/bridges/GolemBridge.php
@@ -106,10 +106,23 @@ class GolemBridge extends FeedExpander
 
         $article = $page->find('article', 0);
 
+        //built youtube iframes
+        foreach ($article->find('.embedcontent') as &$embedcontent) {
+            $ytscript = $embedcontent->find('script', 0);
+            if (preg_match('/www.youtube.com.*?\"/', $ytscript->innertext, $link)) {
+                $link = 'https://' . str_replace('\\', '', $link[0]);
+                $embedcontent->innertext .= <<<EOT
+                    <iframe width="560" height="315" src=$link title="YouTube video player" frameborder="0"
+                    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
+                    referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>';
+                EOT;
+            }
+        }
+
         // delete known bad elements
         foreach (
             $article->find('div[id*="adtile"], #job-market, #seminars, iframe,
-			div.gbox_affiliate, div.toc, .embedcontent, script') as $bad
+			div.gbox_affiliate, div.toc') as $bad
         ) {
             $bad->remove();
         }
@@ -129,7 +142,7 @@ class GolemBridge extends FeedExpander
             $img->src = $img->getAttribute('data-src-full');
         }
 
-        foreach ($content->find('p, h1, h2, h3, img[src*="."]') as $element) {
+        foreach ($content->find('p, h1, h2, h3, img[src*="."], iframe') as $element) {
             $item .= $element;
         }
 

From e251e358ff757023f0e0863d47d1781c5196964c Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Thu, 28 Mar 2024 19:42:41 +0100
Subject: [PATCH 337/716] [HeiseBridge] fix for embedded youtube-videos (#4034)

* [HeiseBridge] fix for embbedded youtube-videos

with this the embedded youtube videos will work in the feed

* Update HeiseBridge.php

* Update HeiseBridge.php
---
 bridges/HeiseBridge.php | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/bridges/HeiseBridge.php b/bridges/HeiseBridge.php
index 504bcfb5..ab40e6d9 100644
--- a/bridges/HeiseBridge.php
+++ b/bridges/HeiseBridge.php
@@ -160,7 +160,7 @@ class HeiseBridge extends FeedExpander
         $article = defaultLinkTo($article, $item['uri']);
 
         // remove unwanted stuff
-        foreach ($article->find('figure.branding, a-ad, div.ho-text, a-img, .opt-in__content-container, .a-toc__list, a-collapse') as $element) {
+        foreach ($article->find('figure.branding, a-ad, div.ho-text, a-img, .a-toc__list, a-collapse, .opt-in__description, .opt-in__footnote') as $element) {
             $element->remove();
         }
         // reload html, as remove() is buggy
@@ -179,6 +179,30 @@ class HeiseBridge extends FeedExpander
             }
         }
 
+        //fix for embbedded youtube-videos
+        $oldlink = '';
+        foreach ($article->find('div.video__yt-container') as &$ytvideo) {
+            if (preg_match('/www.youtube.*?\"/', $ytvideo->innertext, $link) && $link[0] != $oldlink) {
+                //save link to prevent duplicates
+                $oldlink = $link[0];
+                $ytiframe = <<<EOT
+                    <iframe width="560" height="315" src="https://$link[0] title="YouTube video player" frameborder="0"
+                    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
+                    referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+                EOT;
+                //check if video is in header or article for correct possitioning
+                if (strpos($header->innertext, $link[0])) {
+                    $item['content'] .= $ytiframe;
+                } else {
+                    $ytvideo->innertext .= $ytiframe;
+                    $reloadneeded = 1;
+                }
+            }
+        }
+        if (isset($reloadneeded)) {
+            $article = str_get_html($article->outertext);
+        }
+
         $categories = $article->find('.article-footer__topics ul.topics li.topics__item a-topic a');
         foreach ($categories as $category) {
             $item['categories'][] = trim($category->plaintext);

From db984d8a8b98a985fe9a272794fa20081908ad13 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Thu, 28 Mar 2024 14:43:17 -0400
Subject: [PATCH 338/716] AO3Bridge: move tags to categories and remove
 duplicate fic summary (#4031)

* AO3Bridge: move tags to categories and remove duplicate fic summary

* [AO3Bridge] Fix tag html entity encoding
---
 bridges/AO3Bridge.php | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/bridges/AO3Bridge.php b/bridges/AO3Bridge.php
index 32bbb0a2..85f0f9f8 100644
--- a/bridges/AO3Bridge.php
+++ b/bridges/AO3Bridge.php
@@ -91,12 +91,26 @@ class AO3Bridge extends BridgeAbstract
                 continue; // discard deleted works
             }
             $item['title'] = $title->plaintext;
-            $item['content'] = $element;
             $item['uri'] = $title->href;
 
             $strdate = $element->find('div p.datetime', 0)->plaintext;
             $item['timestamp'] = strtotime($strdate);
 
+            // detach from rest of page because remove() is buggy
+            $element = str_get_html($element->outertext());
+            $tags = $element->find('ul.required-tags', 0);
+            foreach ($tags->childNodes() as $tag) {
+                $item['categories'][] = html_entity_decode($tag->plaintext);
+            }
+            $tags->remove();
+            $tags = $element->find('ul.tags', 0);
+            foreach ($tags->childNodes() as $tag) {
+                $item['categories'][] = html_entity_decode($tag->plaintext);
+            }
+            $tags->remove();
+
+            $item['content'] = implode('', $element->childNodes());
+
             $chapters = $element->find('dl dd.chapters', 0);
             // bookmarked series and external works do not have a chapters count
             $chapters = (isset($chapters) ? $chapters->plaintext : 0);
@@ -123,6 +137,10 @@ class AO3Bridge extends BridgeAbstract
                 $response = $httpClient->request($url, $agent);
                 $html = \str_get_html($response->getBody());
                 $html = defaultLinkTo($html, self::URI);
+                // remove duplicate fic summary
+                if ($ficsum = $html->find('#workskin > .preface > .summary', 0)) {
+                    $ficsum->remove();
+                }
                 $item['content'] .= $html->find('#workskin', 0);
             }
 

From be445759b631ea1ec954d70e8e1f30cfb9271f2b Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Thu, 28 Mar 2024 19:44:27 +0100
Subject: [PATCH 339/716] 
 [PepperBridgeAbstract,DealabsBridge,HotUKDealsBridge,MydealsBridge] Move as
 much as possible to JSON (#4032)

As the website use more and more JSON, and JSON is a machine readable
format, I migrated as much as possible to the JSON.

This simplifies the Abstract class a lot, and the Bridge classes need
less language specifi strings.
---
 bridges/DealabsBridge.php        |  42 +----
 bridges/HotUKDealsBridge.php     |  51 +-----
 bridges/MydealsBridge.php        |  50 +-----
 bridges/PepperBridgeAbstract.php | 259 ++++++++-----------------------
 4 files changed, 69 insertions(+), 333 deletions(-)

diff --git a/bridges/DealabsBridge.php b/bridges/DealabsBridge.php
index c65f0c75..62d854f6 100644
--- a/bridges/DealabsBridge.php
+++ b/bridges/DealabsBridge.php
@@ -1915,9 +1915,6 @@ class DealabsBridge extends PepperBridgeAbstract
         'thread-error' => 'Impossible de déterminer l\'ID de la discussion. Vérifiez l\'URL que vous avez entré',
         'no-results' => 'Aucun résultat',
         'currency' => '€',
-        'relative-date-indicator' => [
-            'il y a',
-        ],
         'price' => 'Prix',
         'shipping' => 'Livraison',
         'origin' => 'Origine',
@@ -1925,42 +1922,7 @@ class DealabsBridge extends PepperBridgeAbstract
         'title-keyword' => 'Recherche',
         'title-group' => 'Groupe',
         'title-talk' => 'Surveillance Discussion',
-        'local-months' => [
-            'janvier',
-            'février',
-            'mars',
-            'avril',
-            'mai',
-            'juin',
-            'juillet',
-            'août',
-            'septembre',
-            'octobre',
-            'novembre',
-            'décembre'
-        ],
-        'local-time-relative' => [
-            'il y a ',
-            'min',
-            'h',
-            'jour',
-            'jours',
-            'mois',
-            'ans',
-            'et '
-        ],
-        'date-prefixes' => [
-            'Actualisé ',
-        ],
-        'relative-date-alt-prefixes' => [
-            'Actualisé ',
-        ],
-        'relative-date-ignore-suffix' => [
-        ],
-
-        'localdeal' => [
-            'Local',
-            'Pays d\'expédition'
-        ],
+        'deal-type' => 'Type de deal',
+        'localdeal' => 'Deal Local',
     ];
 }
diff --git a/bridges/HotUKDealsBridge.php b/bridges/HotUKDealsBridge.php
index 1f059123..b631db73 100644
--- a/bridges/HotUKDealsBridge.php
+++ b/bridges/HotUKDealsBridge.php
@@ -3279,9 +3279,6 @@ class HotUKDealsBridge extends PepperBridgeAbstract
         'thread-error' => 'Unable to determine the thread ID. Check the URL you entered',
         'no-results' => 'no results',
         'currency' => '£',
-        'relative-date-indicator' => [
-            'ago',
-        ],
         'price' => 'Price',
         'shipping' => 'Shipping',
         'origin' => 'Origin',
@@ -3289,51 +3286,7 @@ class HotUKDealsBridge extends PepperBridgeAbstract
         'title-keyword' => 'Search',
         'title-group' => 'Group',
         'title-talk' => 'Discussion Monitoring',
-        'local-months' => [
-            'Jan',
-            'Feb',
-            'Mar',
-            'Apr',
-            'May',
-            'Jun',
-            'Jul',
-            'Aug',
-            'Sep',
-            'Occ',
-            'Nov',
-            'Dec',
-            'st',
-            'nd',
-            'rd',
-            'th'
-        ],
-        'local-time-relative' => [
-            'Posted ',
-            'm',
-            'h,',
-            'day',
-            'days',
-            'month',
-            'year',
-            'and '
-        ],
-        'date-prefixes' => [
-            'Posted ',
-            'Found ',
-            'Refreshed ',
-            'Made hot '
-        ],
-        'relative-date-alt-prefixes' => [
-            'Made hot ',
-            'Refreshed ',
-            'Last updated '
-        ],
-        'relative-date-ignore-suffix' => [
-            '/by.*$/'
-        ],
-        'localdeal' => [
-            'Local',
-            'Expires'
-        ]
+        'deal-type' => 'Deal Type',
+        'localdeal' => 'Local deal',
     ];
 }
diff --git a/bridges/MydealsBridge.php b/bridges/MydealsBridge.php
index 08e32a0c..41bae46c 100644
--- a/bridges/MydealsBridge.php
+++ b/bridges/MydealsBridge.php
@@ -2026,10 +2026,6 @@ class MydealsBridge extends PepperBridgeAbstract
         'thread-error' => 'Die ID der Diskussion kann nicht ermittelt werden. Überprüfen Sie die eingegebene URL',
         'no-results' => 'keine Ergebnisse',
         'currency' => '€',
-        'relative-date-indicator' => [
-            'vor',
-            'seit'
-        ],
         'price' => 'Preis',
         'shipping' => 'Versand',
         'origin' => 'Ursprung',
@@ -2037,49 +2033,7 @@ class MydealsBridge extends PepperBridgeAbstract
         'title-keyword' => 'Suche',
         'title-group' => 'Gruppe',
         'title-talk' => 'Überwachung Diskussion',
-        'local-months' => [
-            'Jan',
-            'Feb',
-            'Mär',
-            'Apr',
-            'Mai',
-            'Jun',
-            'Jul',
-            'Aug',
-            'Sep',
-            'Okt',
-            'Nov',
-            'Dez',
-            '.'
-        ],
-        'local-time-relative' => [
-            'eingestellt vor ',
-            'm',
-            'h,',
-            'day',
-            'days',
-            'month',
-            'year',
-            'and '
-        ],
-        'date-prefixes' => [
-            'eingestellt am ',
-            'lokal ',
-            'aktualisiert ',
-        ],
-        'relative-date-alt-prefixes' => [
-            'aktualisiert vor ',
-            'kommentiert vor ',
-            'eingestellt vor ',
-            'heiß seit ',
-            'vor '
-        ],
-        'relative-date-ignore-suffix' => [
-            '/von.*$/'
-        ],
-        'localdeal' => [
-            'Lokal ',
-            'Läuft bis '
-        ]
+        'deal-type' => 'Angebotsart',
+        'localdeal' => 'Lokales Angebot',
     ];
 }
diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index d0e15238..7b40ea1c 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -46,35 +46,6 @@ class PepperBridgeAbstract extends BridgeAbstract
         $html = getSimpleHTMLDOM($url);
         $list = $html->find('article[id][class*=thread--deal]]');
 
-        // Deal Image Link CSS Selector
-        $selectorImageLink = implode(
-            ' ', /* Notice this is a space! */
-            [
-                'cept-thread-image-link',
-                'imgFrame',
-                'imgFrame--noBorder',
-                'thread-listImgCell',
-            ]
-        );
-
-        // Deal Link CSS Selector
-        $selectorLink = implode(
-            ' ', /* Notice this is a space! */
-            [
-                'cept-tt',
-                'thread-link',
-                'linkPlain',
-            ]
-        );
-
-        // Deal Hotness CSS Selector
-        $selectorHot = implode(
-            ' ', /* Notice this is a space! */
-            [
-                'vote-box'
-            ]
-        );
-
         // Deal Description CSS Selector
         $selectorDescription = implode(
             ' ', /* Notice this is a space! */
@@ -83,65 +54,39 @@ class PepperBridgeAbstract extends BridgeAbstract
             ]
         );
 
-        // Deal Date CSS Selector
-        $selectorDate = implode(
-            ' ', /* Notice this is a space! */
-            [
-                'size--all-s',
-                'flex',
-                'boxAlign-jc--all-fe'
-            ]
-        );
-
         // If there is no results, we don't parse the content because it display some random deals
         $noresult = $html->find('h3[class*=text--b]', 0);
         if ($noresult != null && strpos($noresult->plaintext, $this->i8n('no-results')) !== false) {
             $this->items = [];
         } else {
             foreach ($list as $deal) {
-                $item = [];
-                $item['uri'] = $this->getDealURI($deal);
-                $item['title'] = $this->getTitle($deal);
-                $item['author'] = $deal->find('span.thread-username', 0)->plaintext;
-
                 // Get the JSON Data stored as vue
                 $jsonDealData = $this->getDealJsonData($deal);
+                $dealMeta = Json::decode($deal->find('div[class=threadGrid-headerMeta]', 0)->find('div[class=js-vue2]', 1)->getAttribute('data-vue2'));
+
+                $item = [];
+                $item['uri'] = $this->getDealURI($jsonDealData);
+                $item['title'] = $this->getTitle($jsonDealData);
+                $item['author'] = $this->getDealAuthor($jsonDealData);
 
                 $item['content'] = '<table><tr><td><a href="'
                     . $item['uri']
                     . '">'
                     . $this->getImage($deal)
                     . '</td><td>'
-                    . $this->getHTMLTitle($item)
+                    . $this->getHTMLTitle($jsonDealData)
                     . $this->getPrice($jsonDealData)
                     . $this->getDiscount($jsonDealData)
-                    . $this->getShipsFrom($deal)
-                    . $this->getShippingCost($deal)
+                    . $this->getShipsFrom($dealMeta)
+                    . $this->getShippingCost($jsonDealData)
                     . $this->getSource($jsonDealData)
+                    . $this->getDealLocation($dealMeta)
                     . $deal->find('div[class*=' . $selectorDescription . ']', 0)->innertext
                     . '</td><td>'
                     . $this->getTemperature($jsonDealData)
                     . '</td></table>';
 
-                // Check if a clock icon is displayed on the deal
-                $clocks = $deal->find('svg[class*=icon--clock]');
-                if ($clocks !== null && count($clocks) > 0) {
-                    // Get the last clock, corresponding to the deal posting date
-                    $clock = end($clocks);
-
-                    // Find the text corresponding to the clock
-                    $spanDateDiv = $clock->next_sibling();
-                    $itemDate = $spanDateDiv->plaintext;
-                    // In some case of a Local deal, there is no date, but we can use
-                    // this case for other reason (like date not in the last field)
-                    if ($this->contains($itemDate, $this->i8n('localdeal'))) {
-                        $item['timestamp'] = time();
-                    } elseif ($this->contains($itemDate, $this->i8n('relative-date-indicator'))) {
-                        $item['timestamp'] = $this->relativeDateToTimestamp($itemDate);
-                    } else {
-                        $item['timestamp'] = $this->parseDate($itemDate);
-                    }
-                }
+                $item['timestamp'] = $this->getPublishedDate($jsonDealData);
                 $this->items[] = $item;
             }
         }
@@ -284,22 +229,31 @@ HEREDOC;
         }
     }
 
+    /**
+     * Get the Publish Date from a Deal if it exists
+     * @return integer Timestamp of the published date of the deal
+     */
+    private function getPublishedDate($jsonDealData)
+    {
+        return $jsonDealData['props']['thread']['publishedAt'];
+    }
+
+    /**
+     * Get the Deal Author from a Deal if it exists
+     * @return String Author of the deal
+     */
+    private function getDealAuthor($jsonDealData)
+    {
+        return $jsonDealData['props']['thread']['user']['username'];
+    }
+
     /**
      * Get the Title from a Deal if it exists
      * @return string String of the deal title
      */
-    private function getTitle($deal)
+    private function getTitle($jsonDealData)
     {
-        $titleRoot = $deal->find('div[class*=threadGrid-title]', 0);
-        $titleA = $titleRoot->find('a[class*=thread-link]', 0);
-        $titleFirstChild = $titleRoot->first_child();
-        if ($titleA !== null) {
-            $title = $titleA->plaintext;
-        } else {
-            // In some case, expired deals have a different format
-            $title = $titleRoot->find('span', 0)->plaintext;
-        }
-
+        $title = $jsonDealData['props']['thread']['title'];
         return $title;
     }
 
@@ -318,14 +272,10 @@ HEREDOC;
      * Get the HTML Title code from an item
      * @return string String of the deal title
      */
-    private function getHTMLTitle($item)
+    private function getHTMLTitle($jsonDealData)
     {
-        if ($item['uri'] == '') {
-            $html = '<h2>' . $item['title'] . '</h2>';
-        } else {
-            $html = '<h2><a href="' . $item['uri'] . '">'
-                . $item['title'] . '</a></h2>';
-        }
+        $html = '<h2><a href="' . $this->getDealURI($jsonDealData) . '">'
+                . $this->getTitle($jsonDealData) . '</a></h2>';
 
         return $html;
     }
@@ -334,10 +284,11 @@ HEREDOC;
      * Get the URI from a Deal if it exists
      * @return string String of the deal URI
      */
-    private function getDealURI($deal)
+    private function getDealURI($jsonDealData)
     {
-        $dealId = $deal->attr['id'];
-        $uri = $this->i8n('bridge-uri') . $this->i8n('uri-deal') . str_replace('_', '-', $dealId);
+        $dealSlug = $jsonDealData['props']['thread']['titleSlug'];
+        $dealId = $jsonDealData['props']['thread']['threadId'];
+        $uri = $this->i8n('bridge-uri') . $this->i8n('uri-deal') . $dealSlug . '-' . $dealId;
         return $uri;
     }
 
@@ -345,18 +296,14 @@ HEREDOC;
      * Get the Shipping costs from a Deal if it exists
      * @return string String of the deal shipping Cost
      */
-    private function getShippingCost($deal)
+    private function getShippingCost($jsonDealData)
     {
-        if ($deal->find('span[class*=space--ml-2 size--all-s overflow--wrap-off]', 0) != null) {
-            if ($deal->find('span[class*=space--ml-2 size--all-s overflow--wrap-off]', 0)->children(1) != null) {
+        $isFree = $jsonDealData['props']['thread']['shipping']['isFree'];
+        $price = $jsonDealData['props']['thread']['shipping']['price'];
+        if ($isFree !== null) {
                 return '<div>' . $this->i8n('shipping') . ' : '
-                    . strip_tags($deal->find('span[class*=space--ml-2 size--all-s overflow--wrap-off]', 0)->children(1)->innertext)
+                    . $price . ' ' . $this->i8n('currency')
                     . '</div>';
-            } else {
-                return '<div>' . $this->i8n('shipping') . ' : '
-                    . strip_tags($deal->find('span[class*=text--color-greyShade flex--inline]', 0)->innertext)
-                    . '</div>';
-            }
         } else {
             return '';
         }
@@ -422,6 +369,25 @@ HEREDOC;
         }
     }
 
+    /**
+     * Get the Deal location if it exists
+     * @return string String of the deal location
+     */
+    private function getDealLocation($dealMeta)
+    {
+        $ribbons = $dealMeta['props']['metaRibbons'];
+        $isLocal = false;
+        foreach ($ribbons as $ribbon) {
+            $isLocal |= ($ribbon['type'] == 'local');
+        }
+        if ($isLocal) {
+            $content = '<div>' . $this->i8n('deal-type') . ' : ' . $this->i8n('localdeal') . '</div>';
+        } else {
+            $content = '';
+        }
+        return $content;
+    }
+
     /**
      * Get the Picture URL from a Deal if it exists
      * @return string String of the deal Picture URL
@@ -437,9 +403,8 @@ HEREDOC;
      * Get the originating country from a Deal if it exists
      * @return string String of the deal originating country
      */
-    private function getShipsFrom($deal)
+    private function getShipsFrom($dealMeta)
     {
-        $dealMeta = Json::decode($deal->find('div[class=threadGrid-headerMeta]', 0)->find('div[class=js-vue2]', 1)->getAttribute('data-vue2'));
         $metas = $dealMeta['props']['metaRibbons'];
         $shipsFrom = null;
         foreach ($metas as $meta) {
@@ -453,104 +418,6 @@ HEREDOC;
         return '';
     }
 
-    /**
-     * Transforms a local date into a timestamp
-     * @return int timestamp of the input date
-     */
-    private function parseDate($string)
-    {
-        $month_local = $this->i8n('local-months');
-        $month_en = [
-            'January',
-            'February',
-            'March',
-            'April',
-            'May',
-            'June',
-            'July',
-            'August',
-            'September',
-            'October',
-            'November',
-            'December'
-        ];
-
-        // A date can be prfixed with some words, we remove theme
-        $string = $this->removeDatePrefixes($string);
-        // We translate the local months name in the english one
-        $date_str = trim(str_replace($month_local, $month_en, $string));
-
-        // If the date does not contain any year, we add the current year
-        if (!preg_match('/[0-9]{4}/', $string)) {
-            $date_str .= ' ' . date('Y');
-        }
-
-        // Add the Hour and minutes
-        $date_str .= ' 00:00';
-        $date = DateTime::createFromFormat('j F Y H:i', $date_str);
-        // In some case, the date is not recognized : as a workaround the actual date is taken
-        if ($date === false) {
-            $date = new DateTime();
-        }
-        return $date->getTimestamp();
-    }
-
-    /**
-     * Remove the prefix of a date if it has one
-     * @return the date without prefiux
-     */
-    private function removeDatePrefixes($string)
-    {
-        $string = str_replace($this->i8n('date-prefixes'), [], $string);
-        return $string;
-    }
-
-    /**
-     * Remove the suffix of a relative date if it has one
-     * @return the relative date without suffixes
-     */
-    private function removeRelativeDateSuffixes($string)
-    {
-        if (count($this->i8n('relative-date-ignore-suffix')) > 0) {
-            $string = preg_replace($this->i8n('relative-date-ignore-suffix'), '', $string);
-        }
-        return $string;
-    }
-
-    /**
-     * Transforms a relative local date into a timestamp
-     * @return int timestamp of the input date
-     */
-    private function relativeDateToTimestamp($str)
-    {
-        $date = new DateTime();
-
-        // The minimal amount of time substracted is a minute : the seconds in the resulting date would be related to the execution time of the script.
-        // This make no sense, so we set the seconds manually to "00".
-        $date->setTime($date->format('H'), $date->format('i'), 0);
-
-        // In case of update date, replace it by the regular relative date first word
-        $str = str_replace($this->i8n('relative-date-alt-prefixes'), $this->i8n('local-time-relative')[0], $str);
-
-        $str = $this->removeRelativeDateSuffixes($str);
-
-        $search = $this->i8n('local-time-relative');
-
-        $replace = [
-            '-',
-            'minute',
-            'hour',
-            'day',
-            'month',
-            'year',
-            ''
-        ];
-        $date->modify(str_replace($search, $replace, $str));
-
-
-        return $date->getTimestamp();
-    }
-
     /**
      * Returns the RSS Feed title according to the parameters
      * @return string the RSS feed Tiyle

From e0be3662589fbc86b944906713cd6ebfaaf43ccc Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Fri, 29 Mar 2024 15:37:43 +0100
Subject: [PATCH 340/716] Update AnisearchBridge.php (#4025)

* Update AnisearchBridge.php

added youtube trailer

* made trailers optional and reduced scraping to 5 articles if selected

* Update AnisearchBridge.php
---
 bridges/AnisearchBridge.php | 36 ++++++++++++++++++++++++++++++++++--
 1 file changed, 34 insertions(+), 2 deletions(-)

diff --git a/bridges/AnisearchBridge.php b/bridges/AnisearchBridge.php
index 639d143f..d5aad1c9 100644
--- a/bridges/AnisearchBridge.php
+++ b/bridges/AnisearchBridge.php
@@ -19,16 +19,29 @@ class AnisearchBridge extends BridgeAbstract
                 'JP'
                 => 'https://www.anisearch.de/anime/index/page-1?char=all&synchro=ja&sort=date&order=desc&view=4'
             ]
+        ],
+        'trailers' => [
+            'name' => 'Trailers',
+            'type' => 'checkbox',
+            'title' => 'Will include trailes',
+            'defaultValue' => false
         ]
     ]];
 
     public function collectData()
     {
         $baseurl = 'https://www.anisearch.de/';
+        $trailers = false;
+        $trailers = $this->getInput('trailers');
         $limit = 10;
+        if ($trailers) {
+            $limit = 5;
+        }
+
         $dom = getSimpleHTMLDOM($this->getInput('category'));
+
         foreach ($dom->find('li.btype0') as $key => $li) {
-            if ($key > $limit) {
+            if ($key >= $limit) {
                 break;
             }
 
@@ -44,10 +57,29 @@ class AnisearchBridge extends BridgeAbstract
             $headerimage = $domarticle->find('img#details-cover', 0);
             $src = $headerimage->src;
 
+            foreach ($content->find('.hidden') as $element) {
+                $element->remove();
+            }
+
+            //get trailer
+            $ytlink = '';
+            if ($trailers) {
+                $trailerlink = $domarticle->find('section#trailers > div > div.swiper > ul.swiper-wrapper > li.swiper-slide > a', 0);
+                if (isset($trailerlink)) {
+                    $trailersite = getSimpleHTMLDOM($baseurl . $trailerlink->href);
+                    $trailer = $trailersite->find('div#player > iframe', 0);
+                    $ytlink = <<<EOT
+                        <br /><iframe width="560" height="315" src="' . $trailer->{'data-xsrc'} . '" title="YouTube video player"
+                        frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
+                        referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>';
+                    EOT;
+                }
+            }
+
             $this->items[] = [
                 'title' => $title->plaintext,
                 'uri' => $url,
-                'content' => $headerimage . '<br />' . $content
+                'content' => $headerimage . '<br />' . $content . $ytlink
             ];
         }
     }

From 24e429969f87574d5808098a27248f0e212ce86e Mon Sep 17 00:00:00 2001
From: Quentin de Longraye <quentin@dldl.fr>
Date: Sat, 30 Mar 2024 16:11:57 +0100
Subject: [PATCH 341/716] specify system section for enabling bridges (#4036)

---
 docs/03_For_Hosts/05_Whitelisting.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/docs/03_For_Hosts/05_Whitelisting.md b/docs/03_For_Hosts/05_Whitelisting.md
index 113c4e3d..156174f0 100644
--- a/docs/03_For_Hosts/05_Whitelisting.md
+++ b/docs/03_For_Hosts/05_Whitelisting.md
@@ -1,14 +1,18 @@
-Modify `config.ini.php` to limit available bridges.
+Modify `config.ini.php` to limit available bridges. Those changes should be applied in the `[system]` section.
 
 ## Enable all bridges
 
 ```
+[system]
+
 enabled_bridges[] = *
 ```
 
 ## Enable some bridges
 
 ```
+[system]
+
 enabled_bridges[] = TwitchBridge
 enabled_bridges[] = GettrBridge
 ```

From 545dc969d35bc8c94a8c15875562690ee2fd6605 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 31 Mar 2024 03:38:42 +0200
Subject: [PATCH 342/716] refactor (#4037)

---
 actions/DisplayAction.php      |  8 +++---
 bridges/NintendoBridge.php     |  1 -
 formats/HtmlFormat.php         | 51 ++++++++++++++++------------------
 lib/BridgeCard.php             |  2 +-
 templates/html-format.html.php | 25 ++++++++++++-----
 5 files changed, 47 insertions(+), 40 deletions(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index ed063825..24bdefe1 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -51,7 +51,6 @@ class DisplayAction implements ActionInterface
             return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'This bridge is not whitelisted']), 400);
         }
 
-
         if (
             Configuration::getConfig('proxy', 'url')
             && Configuration::getConfig('proxy', 'by_bridge')
@@ -62,8 +61,6 @@ class DisplayAction implements ActionInterface
         }
 
         $bridge = $bridgeFactory->create($bridgeClassName);
-        $formatFactory = new FormatFactory();
-        $format = $formatFactory->create($format);
 
         $response = $this->createResponse($request, $bridge, $format);
 
@@ -93,7 +90,7 @@ class DisplayAction implements ActionInterface
         return $response;
     }
 
-    private function createResponse(Request $request, BridgeAbstract $bridge, FormatAbstract $format)
+    private function createResponse(Request $request, BridgeAbstract $bridge, string $format)
     {
         $items = [];
         $feed = [];
@@ -157,6 +154,9 @@ class DisplayAction implements ActionInterface
             }
         }
 
+        $formatFactory = new FormatFactory();
+        $format = $formatFactory->create($format);
+
         $format->setItems($items);
         $format->setFeed($feed);
         $now = time();
diff --git a/bridges/NintendoBridge.php b/bridges/NintendoBridge.php
index 1c2ef71a..1c4ecf2b 100644
--- a/bridges/NintendoBridge.php
+++ b/bridges/NintendoBridge.php
@@ -4,7 +4,6 @@ class NintendoBridge extends XPathAbstract
 {
     const NAME = 'Nintendo Software Updates';
     const URI = 'https://www.nintendo.co.uk/Support/Welcome-to-Nintendo-Support-11593.html';
-    const DONATION_URI = '';
     const DESCRIPTION = self::NAME;
     const MAINTAINER = 'Niehztog';
     const PARAMETERS = [
diff --git a/formats/HtmlFormat.php b/formats/HtmlFormat.php
index 93c824b3..1e2f60e6 100644
--- a/formats/HtmlFormat.php
+++ b/formats/HtmlFormat.php
@@ -6,34 +6,26 @@ class HtmlFormat extends FormatAbstract
 
     public function stringify()
     {
+        // This query string comes in already url decoded
         $queryString = $_SERVER['QUERY_STRING'];
 
         $feedArray = $this->getFeed();
         $formatFactory = new FormatFactory();
-        $buttons = [];
-        $linkTags = [];
-        foreach ($formatFactory->getFormatNames() as $formatName) {
-            // Dynamically build buttons for all formats (except HTML)
+        $formats = [];
+
+        // Create all formats (except HTML)
+        $formatNames = $formatFactory->getFormatNames();
+        foreach ($formatNames as $formatName) {
             if ($formatName === 'Html') {
                 continue;
             }
-            $formatUrl = '?' . str_ireplace('format=Html', 'format=' . $formatName, htmlentities($queryString));
-            $buttons[] = [
-                'href' => $formatUrl,
-                'value' => $formatName,
-            ];
-            $format = $formatFactory->create($formatName);
-            $linkTags[] = [
-                'href' => $formatUrl,
-                'title' => $formatName,
-                'type' => $format->getMimeType(),
-            ];
-        }
-
-        if (Configuration::getConfig('admin', 'donations') && $feedArray['donationUri']) {
-            $buttons[] = [
-                'href' => e($feedArray['donationUri']),
-                'value' => 'Donate to maintainer',
+            // The format url is relative, but should be absolute in order to help feed readers.
+            $formatUrl = '?' . str_ireplace('format=Html', 'format=' . $formatName, $queryString);
+            $formatObject = $formatFactory->create($formatName);
+            $formats[] = [
+                'url'       => $formatUrl,
+                'name'      => $formatName,
+                'type'      => $formatObject->getMimeType(),
             ];
         }
 
@@ -50,13 +42,18 @@ class HtmlFormat extends FormatAbstract
             ];
         }
 
+        $donationUri = null;
+        if (Configuration::getConfig('admin', 'donations') && $feedArray['donationUri']) {
+            $donationUri = $feedArray['donationUri'];
+        }
+
         $html = render_template(__DIR__ . '/../templates/html-format.html.php', [
-            'charset'   => $this->getCharset(),
-            'title'     => $feedArray['name'],
-            'linkTags'  => $linkTags,
-            'uri'       => $feedArray['uri'],
-            'buttons'   => $buttons,
-            'items'     => $items,
+            'charset'       => $this->getCharset(),
+            'title'         => $feedArray['name'],
+            'formats'       => $formats,
+            'uri'           => $feedArray['uri'],
+            'items'         => $items,
+            'donation_uri'  => $donationUri,
         ]);
         // Remove invalid characters
         ini_set('mbstring.substitute_character', 'none');
diff --git a/lib/BridgeCard.php b/lib/BridgeCard.php
index c4677b9d..d15ac865 100644
--- a/lib/BridgeCard.php
+++ b/lib/BridgeCard.php
@@ -78,7 +78,7 @@ final class BridgeCard
 
         $card .= sprintf('<label class="showless" for="showmore-%s">Show less</label>', $bridgeClassName);
 
-        if ($bridge->getDonationURI() !== '' && Configuration::getConfig('admin', 'donations')) {
+        if (Configuration::getConfig('admin', 'donations') && $bridge->getDonationURI()) {
             $card .= sprintf(
                 '<p class="maintainer">%s ~ <a href="%s">Donate</a></p>',
                 $bridge->getMaintainer(),
diff --git a/templates/html-format.html.php b/templates/html-format.html.php
index 3b0fe6fe..bc95c5d0 100644
--- a/templates/html-format.html.php
+++ b/templates/html-format.html.php
@@ -8,12 +8,13 @@
     <link href="static/style.css?2023-03-24" rel="stylesheet">
     <link rel="icon" type="image/png" href="static/favicon.png">
 
-	<?php foreach ($linkTags as $link): ?>
+    <?php foreach ($formats as $format): ?>
+
         <link
-            href="<?= $link['href'] ?>"
-            title="<?= $link['title'] ?>"
+            href="<?= e($format['url']) ?>"
+            title="<?= e($format['name']) ?>"
             rel="alternate"
-            type="<?= $link['type'] ?>"
+            type="<?= e($format['type']) ?>"
         >
 	<?php endforeach; ?>
 
@@ -33,11 +34,21 @@
                 <button class="backbutton">← back to rss-bridge</button>
             </a>
 
-            <?php foreach ($buttons as $button): ?>
-                <a href="<?= $button['href'] ?>">
-                    <button class="rss-feed"><?= $button['value'] ?></button>
+            <?php foreach ($formats as $format): ?>
+                <a href="<?= e($format['url']) ?>">
+                    <button class="rss-feed">
+                        <?= e($format['name']) ?>
+                    </button>
                 </a>
             <?php endforeach; ?>
+
+            <?php if ($donation_uri): ?>
+                <a href="<?= e($donation_uri) ?>">
+                    <button class="rss-feed">
+                        Donate to maintainer
+                    </button>
+                </a>
+            <?php endif; ?>
         </div>
 
         <?php foreach ($items as $item): ?>

From b58d8b099b33ff030ac9004656a048b751ac2691 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Sun, 31 Mar 2024 03:44:10 +0200
Subject: [PATCH 343/716] docs: Complete helper function documentation (#3911)

* docs: Complete helper function documentation

Complete documentation of the Helper functions

* docs: remove parameters and add a link to source

- Parameters removed
- Link to the file defining the function

* docs: fix links

Fix links to source files
---
 docs/06_Helper_functions/index.md | 81 +++++++++++++++++++++++++++++++
 1 file changed, 81 insertions(+)

diff --git a/docs/06_Helper_functions/index.md b/docs/06_Helper_functions/index.md
index 31a13953..3aaeed89 100644
--- a/docs/06_Helper_functions/index.md
+++ b/docs/06_Helper_functions/index.md
@@ -233,3 +233,84 @@ $html = markdownToHtml($input);
 // <li>Translation improvements</li>
 // </ul>
 ```
+
+
+# e
+The `e` function is used to convert special characters to HTML entities
+
+```PHP
+e('0 < 1 and 2 > 1');
+```
+
+`e` will return the content of the string escape that can be rendered as is in HTML
+
+[Defined in lib/html.php](/lib/html.php)
+
+# truncate
+The `truncate` function is used to shorten a string if exceeds a certain length, and add a string indicating that the string has been shortened.
+
+```PHP
+truncate('Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed a neque nunc. Nam nibh sem.', 20 , '...');
+```
+
+[Defined in lib/html.php](/lib/html.php)
+
+# sanitize
+The `sanitize` function is used to remove some tags from a given HTML text.
+
+```PHP
+$html = '<head><title>Sample Page</title></head>
+<body><p>Lorem ipsum dolor sit amet, consectetur adipiscing elit...</p>
+<iframe src="https://www.example.com" width="600" height="400" frameborder="0" allowfullscreen></iframe>
+</body>
+</html>';
+$tags_to_remove = ['script', 'iframe', 'input', 'form'];
+$attributes_to_keep = ['title', 'href', 'src'];
+$text_to_keep = [];
+sanitize($html, $tags_to_remove, $attributes_to_keep, $text_to_keep);
+```
+
+This function returns a simplehtmldom object of the remaining contents.
+
+[Defined in lib/html.php](/lib/html.php)
+
+# convertLazyLoading
+The `convertLazyLoading` function is used to convert onvert lazy-loading images and frames (video embeds) into static elements. It accepts the HTML content as HTML objects or string objects. It returns the HTML content with fixed image/frame URLs (same type as input).
+
+```PHP
+$html = '<html>
+<body style="background-image: url('bgimage.jpg');">
+<h1>Hello world!</h1>
+</body>
+</html>
+backgroundToImg($html);
+```
+
+[Defined in lib/html.php](/lib/html.php)
+
+
+# Json::encode
+The `Json::encode` function is used to encode a value as à JSON string.
+
+```PHP
+$array = [
+    "foo" => "bar",
+    "bar" => "foo",
+];
+Json::encode($array, true, true);
+```
+
+[Defined in lib/utils.php](/lib/utils.php)
+
+# Json::decode
+The `Json::decode` function is used to decode a JSON string into à PHP variable.
+
+```PHP
+$json = '{
+    "foo": "bar",
+    "bar": "foo"
+}';
+Json::decode($json);
+```
+
+[Defined in lib/utils.php](/lib/utils.php)

From d23fd2522ce71877bcfc942c13250ff3ec9d71ca Mon Sep 17 00:00:00 2001
From: Miika Launiainen <miika@miicat.eu>
Date: Sun, 31 Mar 2024 04:46:23 +0300
Subject: [PATCH 344/716] [GenshinImpactBridge] Fix bridge to use new API
 (#4011)

* [GenshinImpactBridge] Fix bridge to use new API

* Add category parameters back to not break existing feeds

* Fix lint error

* Remove whitespace
---
 bridges/GenshinImpactBridge.php | 55 +++++++++++++--------------------
 1 file changed, 22 insertions(+), 33 deletions(-)

diff --git a/bridges/GenshinImpactBridge.php b/bridges/GenshinImpactBridge.php
index 24bc39d8..0dc08a28 100644
--- a/bridges/GenshinImpactBridge.php
+++ b/bridges/GenshinImpactBridge.php
@@ -2,11 +2,11 @@
 
 class GenshinImpactBridge extends BridgeAbstract
 {
-    const MAINTAINER = 'corenting';
     const NAME = 'Genshin Impact';
-    const URI = 'https://genshin.mihoyo.com/en/news';
-    const CACHE_TIMEOUT = 7200; // 2h
-    const DESCRIPTION = 'News from the Genshin Impact website';
+    const URI = 'https://genshin.hoyoverse.com/en/news';
+    const CACHE_TIMEOUT = 18000; // 5h
+    const DESCRIPTION = 'Latest news from the Genshin Impact website';
+    const MAINTAINER = 'Miicat_47';
     const PARAMETERS = [
         [
             'category' => [
@@ -25,37 +25,31 @@ class GenshinImpactBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $category = $this->getInput('category');
-
-        $url = 'https://genshin.mihoyo.com/content/yuanshen/getContentList';
-        $url = $url . '?pageSize=5&pageNum=1&channelId=' . $category;
+        $url = 'https://api-os-takumi-static.hoyoverse.com/content_v2_user/app/a1b1f9d3315447cc/getContentList?iAppId=32&iChanId=395&iPageSize=5&iPage=1&sLangKey=en-us';
         $api_response = getContents($url);
         $json_list = json_decode($api_response, true);
 
         foreach ($json_list['data']['list'] as $json_item) {
-            $article_url = 'https://genshin.mihoyo.com/content/yuanshen/getContent';
-            $article_url = $article_url . '?contentId=' . $json_item['contentId'];
-            $article_res = getContents($article_url);
-            $article_json = json_decode($article_res, true);
-            $article_time = $article_json['data']['start_time'];
-            $timezone = 'Asia/Shanghai';
-            $article_timestamp = new DateTime($article_time, new DateTimeZone($timezone));
+            $article_html = str_get_html($json_item['sContent']);
 
+            // Check if article contains a embed YouTube video
+            $exp_youtube = '/https:\/\/[w\.]+youtube\.com\/embed\/([\w]+)/m';
+            if (preg_match($exp_youtube, $article_html, $matches)) {
+                // Replace the YouTube embed with a YouTube link
+                $yt_embed = $article_html->find('div[class="ttr-video-frame"]', 0);
+                $yt_link = sprintf('<a href="https://youtube.com/watch?v=%1$s">https://youtube.com/watch?v=%1$s</a>', $matches[1]);
+                $article_html = str_replace($yt_embed, $yt_link, $article_html);
+            }
             $item = [];
-
-            $item['title'] = $article_json['data']['title'];
-            $item['timestamp'] = $article_timestamp->format('U');
-            $item['content'] = $article_json['data']['content'];
-            $item['uri'] = $this->getArticleUri($json_item);
-            $item['id'] = $json_item['contentId'];
+            $item['title'] = $json_item['sTitle'];
+            $item['timestamp'] = $json_item['dtStartTime'];
+            $item['content'] = $article_html;
+            $item['uri'] = 'https://genshin.hoyoverse.com/en/news/detail/' . $json_item['iInfoId'];
+            $item['id'] = $json_item['iInfoId'];
 
             // Picture
-            foreach ($article_json['data']['ext'] as $ext) {
-                if ($ext['arrtName'] == 'banner' && count($ext['value']) == 1) {
-                    $item['enclosures'] = [$ext['value'][0]['url']];
-                    break;
-                }
-            }
+            $json_ext = json_decode($json_item['sExt'], true);
+            $item['enclosures'] = $json_ext['banner'][0]['url'];
 
             $this->items[] = $item;
         }
@@ -63,11 +57,6 @@ class GenshinImpactBridge extends BridgeAbstract
 
     public function getIcon()
     {
-        return 'https://genshin.mihoyo.com/favicon.ico';
-    }
-
-    private function getArticleUri($json_item)
-    {
-        return 'https://genshin.mihoyo.com/en/news/detail/' . $json_item['contentId'];
+        return 'https://genshin.hoyoverse.com/favicon.ico';
     }
 }

From 1c3c85d8ff5a6d071f688ef09ca93f275b4995af Mon Sep 17 00:00:00 2001
From: Niehztog <Niehztog@users.noreply.github.com>
Date: Sun, 31 Mar 2024 18:46:07 +0200
Subject: [PATCH 345/716] [XPathBridge] Allow multiple categories (#4038)

* [XPathAbstract] allow multiple categories

* fix feed icons in two bridges

* fix warning

* fix linter errors
---
 bridges/BlizzardNewsBridge.php |  7 ++++
 bridges/NiusBridge.php         |  5 +++
 lib/XPathAbstract.php          | 74 +++++++++++++++++++++++++---------
 3 files changed, 67 insertions(+), 19 deletions(-)

diff --git a/bridges/BlizzardNewsBridge.php b/bridges/BlizzardNewsBridge.php
index 3930e0a4..19c38152 100644
--- a/bridges/BlizzardNewsBridge.php
+++ b/bridges/BlizzardNewsBridge.php
@@ -57,4 +57,11 @@ class BlizzardNewsBridge extends XPathAbstract
         }
         return 'https://news.blizzard.com/' . $locale;
     }
+
+    public function getIcon()
+    {
+        return <<<icon
+https://blznews.akamaized.net/images/favicon-cb34a003c6f2f637ee8f4f7b406f3b9b120b918c04cabec7f03a760e708977ea9689a1c638f4396def8dce7b202cd007eae91946cc3c4a578aa8b5694226cfc6.ico
+icon;
+    }
 }
diff --git a/bridges/NiusBridge.php b/bridges/NiusBridge.php
index c76b29f0..0be6e89c 100644
--- a/bridges/NiusBridge.php
+++ b/bridges/NiusBridge.php
@@ -23,6 +23,11 @@ class NiusBridge extends XPathAbstract
     const XPATH_EXPRESSION_ITEM_CATEGORIES = './/div[@class="subtitle"]/text()';
     const SETTING_FIX_ENCODING = false;
 
+    public function getIcon()
+    {
+        return 'https://www.nius.de/favicon.ico';
+    }
+
     protected function formatItemTitle($value)
     {
         return strip_tags($value);
diff --git a/lib/XPathAbstract.php b/lib/XPathAbstract.php
index 2206f79a..224d8e87 100644
--- a/lib/XPathAbstract.php
+++ b/lib/XPathAbstract.php
@@ -439,7 +439,8 @@ abstract class XPathAbstract extends BridgeAbstract
                 }
 
                 $isContent = $param === 'content';
-                $value = $this->getItemValueOrNodeValue($typedResult, $isContent, $isContent && !$this->getSettingUseRawItemContent());
+                $isCategories = 'categories' === $param;
+                $value = $this->getItemValueOrNodeValue($typedResult, $isContent, $isContent && !$this->getSettingUseRawItemContent(), $isCategories);
                 $item->__set($param, $this->formatParamValue($param, $value));
             }
 
@@ -459,7 +460,7 @@ abstract class XPathAbstract extends BridgeAbstract
      */
     protected function formatParamValue($param, $value)
     {
-        $value = $this->fixEncoding($value);
+        $value = is_array($value) ? array_map([$this, 'fixEncoding'], $value) : $this->fixEncoding($value);
         switch ($param) {
             case 'title':
                 return $this->formatItemTitle($value);
@@ -572,12 +573,12 @@ abstract class XPathAbstract extends BridgeAbstract
      * formatted as array.
      * Can be easily overwritten for in case the values need to be transformed into something
      * else.
-     * @param string $value
+     * @param string|array $value
      * @return array
      */
     protected function formatItemCategories($value)
     {
-        return [$value];
+        return is_array($value) ? $value : [$value];
     }
 
     /**
@@ -596,22 +597,21 @@ abstract class XPathAbstract extends BridgeAbstract
 
     /**
      * @param $typedResult
-     * @return string
+     * @param bool $returnXML
+     * @param bool $escapeHtml
+     * @param bool $allowMultiple
+     * @return string|array
+     * @throws Exception
      */
-    protected function getItemValueOrNodeValue($typedResult, $returnXML = false, $escapeHtml = false)
+    protected function getItemValueOrNodeValue($typedResult, $returnXML = false, $escapeHtml = false, $allowMultiple = false)
     {
-        if ($typedResult instanceof \DOMNodeList) {
+        if ($typedResult instanceof \DOMNodeList && !$allowMultiple) {
             $item = $typedResult->item(0);
-            if ($item instanceof \DOMElement) {
-                // Don't escape XML
-                if ($returnXML) {
-                    return ($item->ownerDocument ?? $item)->saveXML($item);
-                }
-                $text = $item->nodeValue;
-            } elseif ($item instanceof \DOMAttr) {
-                $text = $item->value;
-            } elseif ($item instanceof \DOMText) {
-                $text = $item->wholeText;
+            $text = $this->extractNodeListContent($item, $returnXML);
+        } elseif ($typedResult instanceof \DOMNodeList && $allowMultiple) {
+            $text = [];
+            foreach ($typedResult as $item) {
+                $text[] = $this->extractNodeListContent($item, $returnXML);
             }
         } elseif (is_string($typedResult) && strlen($typedResult) > 0) {
             $text = $typedResult;
@@ -619,10 +619,46 @@ abstract class XPathAbstract extends BridgeAbstract
             throw new \Exception('Unknown type of XPath expression result.');
         }
 
+        if (is_array($text)) {
+            foreach ($text as &$element) {
+                $element = $this->cleanExtractedText($element, $escapeHtml, $returnXML);
+            }
+        } else {
+            $text = $this->cleanExtractedText($text, $escapeHtml, $returnXML);
+        }
+        return $text;
+    }
+
+    /**
+     * @param $item
+     * @param $returnXML
+     * @return false|string
+     * @throws Exception
+     */
+    protected function extractNodeListContent($item, $returnXML)
+    {
+        if ($item instanceof \DOMElement) {
+            return $returnXML ? ($item->ownerDocument ?? $item)->saveXML($item) : $item->nodeValue;
+        } elseif ($item instanceof \DOMAttr) {
+            return $item->value;
+        } elseif ($item instanceof \DOMText) {
+            return $item->wholeText;
+        }
+        throw new \Exception('Unknown type of XPath expression result.');
+    }
+
+    /**
+     * @param $text
+     * @param $escapeHtml
+     * @param $returnXML
+     * @return string
+     */
+    protected function cleanExtractedText($text, $escapeHtml, $returnXML)
+    {
         $text = trim($text);
 
-        if ($escapeHtml) {
-            return htmlspecialchars($text);
+        if ($escapeHtml && !$returnXML) {
+            $text = htmlspecialchars($text);
         }
         return $text;
     }

From 8ca1b908400d2965c3ca6aa76b821b7bca7c50e0 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 31 Mar 2024 20:07:14 +0200
Subject: [PATCH 346/716] fix(NationalGeographicBridge) (#4039)

---
 bridges/NationalGeographicBridge.php | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/bridges/NationalGeographicBridge.php b/bridges/NationalGeographicBridge.php
index f7572240..7f8f4fa2 100644
--- a/bridges/NationalGeographicBridge.php
+++ b/bridges/NationalGeographicBridge.php
@@ -168,7 +168,7 @@ class NationalGeographicBridge extends BridgeAbstract
         }
 
         $image = $story['img'];
-        $item['enclosures'][] = $image['src'];
+        $item['enclosures'][] = str_replace(' ', '%20', $image['src']);
 
         foreach ($story['tags'] as $tag) {
             $item['categories'][] = $tag['name'] ?? $tag;
@@ -218,7 +218,10 @@ class NationalGeographicBridge extends BridgeAbstract
         switch ($image_type) {
             case 'image':
             case 'imagegroup':
-                $image = $image_module['image'];
+                $image = $image_module['image'] ?? null;
+                if (!$image) {
+                    return '';
+                }
                 $image_src = $image['src'];
                 if (isset($image_module['alt'])) {
                     $image_alt = $image_module['alt'];
@@ -266,7 +269,11 @@ EOD;
 
         $json = json_decode($matches[1][0], true);
 
-        $unfiltered_data = $json['page']['content']['article']['frms'];
+        if (isset($json['page']['content']['article']['frms'])) {
+            $unfiltered_data = $json['page']['content']['article']['frms'];
+        } else {
+            $unfiltered_data = $json['page']['content']['prismarticle']['frms'];
+        }
         $filtered_data = $this->filterArticleData($unfiltered_data);
 
         $article = $filtered_data['edgs'][0];
@@ -288,7 +295,7 @@ EOD;
             }
         }
 
-        $published_date = $article['pbDt'];
+        $published_date = $article['pbDt'] ?? $article['dt'];
         $article_body = $article['bdy'];
         $content = '';
 

From 73289324bd39a31e225bd8f8048a1081bb771c67 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 31 Mar 2024 21:02:55 +0200
Subject: [PATCH 347/716] feat: add vendor http header to cached responses
 (#4040)

---
 actions/DisplayAction.php        | 2 +-
 bridges/MediapartBlogsBridge.php | 7 ++++++-
 lib/FeedItem.php                 | 2 --
 lib/http.php                     | 9 ++++++++-
 4 files changed, 15 insertions(+), 5 deletions(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 24bdefe1..93813004 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -32,7 +32,7 @@ class DisplayAction implements ActionInterface
                     return new Response('', 304, ['last-modified' => $modificationTimeGMT . 'GMT']);
                 }
             }
-            return $cachedResponse;
+            return $cachedResponse->withHeader('rss-bridge', 'This is a cached response');
         }
 
         if (!$bridgeName) {
diff --git a/bridges/MediapartBlogsBridge.php b/bridges/MediapartBlogsBridge.php
index fa8c3d5f..d1e1c3c9 100644
--- a/bridges/MediapartBlogsBridge.php
+++ b/bridges/MediapartBlogsBridge.php
@@ -35,7 +35,12 @@ class MediapartBlogsBridge extends BridgeAbstract
 
             $item['title'] = $item_title->innertext;
             $item['uri'] = self::BASE_URI . trim($item_title->href);
-            $item['author'] = $element->find('.author .subscriber', 0)->innertext;
+
+            $author = $element->find('.author .subscriber', 0);
+            if ($author) {
+                $item['author'] = $author->innertext;
+            }
+
             $item['content'] = $item_divs[count($item_divs) - 2] . $item_divs[count($item_divs) - 1];
             $item['timestamp'] = strtotime($element->find('.author time', 0)->datetime);
 
diff --git a/lib/FeedItem.php b/lib/FeedItem.php
index bd37f119..fc4549a7 100644
--- a/lib/FeedItem.php
+++ b/lib/FeedItem.php
@@ -178,7 +178,6 @@ class FeedItem
         } else {
             $this->author = $author;
         }
-        return $this;
     }
 
     public function getContent(): ?string
@@ -284,7 +283,6 @@ class FeedItem
         } else {
             $this->misc[$name] = $value;
         }
-        return $this;
     }
 
     public function toArray(): array
diff --git a/lib/http.php b/lib/http.php
index e4f9bf48..39f0c727 100644
--- a/lib/http.php
+++ b/lib/http.php
@@ -331,7 +331,14 @@ final class Response
         return array_pop($header);
     }
 
-    public function withBody(string $body): Response
+    public function withHeader(string $name, string $value): self
+    {
+        $clone = clone $this;
+        $clone->headers[$name] = [$value];
+        return $clone;
+    }
+
+    public function withBody(string $body): self
     {
         $clone = clone $this;
         $clone->body = $body;

From 17a3b4c9d871208896e6c50a64b539d8689be128 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 31 Mar 2024 21:32:27 +0200
Subject: [PATCH 348/716] Fix 198 (#4041)

* fix(twitch): log instead of exception

* typo
---
 bridges/RedditBridge.php | 2 +-
 bridges/TwitchBridge.php | 6 +++++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index fbc6f678..7ece0e15 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -121,7 +121,7 @@ class RedditBridge extends BridgeAbstract
         $comments = false;
         $frontend = $this->getInput('frontend');
         if ($frontend == '') {
-                $frontend = 'https://old.reddit.com';
+            $frontend = 'https://old.reddit.com';
         }
         $section = $this->getInput('d');
 
diff --git a/bridges/TwitchBridge.php b/bridges/TwitchBridge.php
index f408f885..9e70944e 100644
--- a/bridges/TwitchBridge.php
+++ b/bridges/TwitchBridge.php
@@ -95,10 +95,14 @@ EOD;
         if ($data->user === null) {
             throw new \Exception(sprintf('Unable to find channel `%s`', $channel));
         }
+
         $user = $data->user;
         if ($user->videos === null) {
-            throw new HttpException('Service Unavailable', 503);
+            // twitch regularly does this for unknown reasons
+            $this->logger->info('Twitch returned empty set of videos', ['data' => $data]);
+            return;
         }
+
         foreach ($user->videos->edges as $edge) {
             $video = $edge->node;
 

From 9682f74fc569214186a504c03cf52dc78ed73d5f Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 31 Mar 2024 21:37:51 +0200
Subject: [PATCH 349/716] fix(cnet): author typo (#4042)

---
 bridges/CNETBridge.php | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/bridges/CNETBridge.php b/bridges/CNETBridge.php
index 4a63c847..17c05e9b 100644
--- a/bridges/CNETBridge.php
+++ b/bridges/CNETBridge.php
@@ -56,7 +56,7 @@ class CNETBridge extends SitemapBridge
         foreach ($links as $article_uri) {
             $article_dom = convertLazyLoading(getSimpleHTMLDOMCached($article_uri));
             $title = trim($article_dom->find('h1', 0)->plaintext);
-            $author = $article_dom->find('span.c-assetAuthor_name', 0)->plaintext;
+            $author = $article_dom->find('span.c-assetAuthor_name', 0);
             $headline = $article_dom->find('p.c-contentHeader_description', 0);
             $content = $article_dom->find('div.c-pageArticle_content, div.single-article__content, div.article-main-body', 0);
             $date = null;
@@ -97,7 +97,11 @@ class CNETBridge extends SitemapBridge
             $item = [];
             $item['uri'] = $article_uri;
             $item['title'] = $title;
-            $item['author'] = $author;
+
+            if ($author) {
+                $item['author'] = $author->plaintext;
+            }
+
             $item['content'] = $content;
 
             if (!is_null($date)) {

From 182567e4341db19eb91df107216e6667c5d6e5de Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 31 Mar 2024 21:52:53 +0200
Subject: [PATCH 350/716] fix(bridges/DavesTrailerPageBridge): remove (#4043)

---
 bridges/DavesTrailerPageBridge.php | 40 ------------------------------
 1 file changed, 40 deletions(-)
 delete mode 100644 bridges/DavesTrailerPageBridge.php

diff --git a/bridges/DavesTrailerPageBridge.php b/bridges/DavesTrailerPageBridge.php
deleted file mode 100644
index 965f7e59..00000000
--- a/bridges/DavesTrailerPageBridge.php
+++ /dev/null
@@ -1,40 +0,0 @@
-<?php
-
-class DavesTrailerPageBridge extends BridgeAbstract
-{
-    const MAINTAINER = 'johnnygroovy';
-    const NAME = 'Daves Trailer Page Bridge';
-    const URI = 'https://www.davestrailerpage.co.uk/';
-    const DESCRIPTION = 'Last trailers in HD thanks to Dave.';
-
-    public function collectData()
-    {
-        $html = getSimpleHTMLDOM(static::URI)
-        or returnClientError('No results for this query.');
-
-        $curr_date = null;
-        foreach ($html->find('tr') as $tr) {
-            // If it's a date row, update the current date
-            if ($tr->align == 'center') {
-                $curr_date = $tr->plaintext;
-                continue;
-            }
-
-            $item = [];
-
-            // title
-            $item['title'] = $tr->find('td', 0)->find('b', 0)->plaintext;
-
-            // content
-            $item['content'] = $tr->find('ul', 1);
-
-            // uri
-            $item['uri'] = $tr->find('a', 3)->getAttribute('href');
-
-            // date: parsed by FeedItem using strtotime
-            $item['timestamp'] = $curr_date;
-
-            $this->items[] = $item;
-        }
-    }
-}

From d5d470cbc2195472fc1387ab55befd09d9ce21fc Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 31 Mar 2024 22:10:59 +0200
Subject: [PATCH 351/716] fix(dribble) (#4044)

---
 bridges/DribbbleBridge.php | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/bridges/DribbbleBridge.php b/bridges/DribbbleBridge.php
index 3957c9de..539127b3 100644
--- a/bridges/DribbbleBridge.php
+++ b/bridges/DribbbleBridge.php
@@ -18,12 +18,12 @@ favicon-63b2904a073c89b52b19aa08cebc16a154bcf83fee8ecc6439968b1e6db569c7.ico';
     {
         $html = getSimpleHTMLDOM(self::URI);
 
-        $json = $this->loadEmbeddedJsonData($html);
+        $data = $this->fetchData($html);
 
         foreach ($html->find('li[id^="screenshot-"]') as $shot) {
             $item = [];
 
-            $additional_data = $this->findJsonForShot($shot, $json);
+            $additional_data = $this->findJsonForShot($shot, $data);
             if ($additional_data === null) {
                 $item['uri'] = self::URI . $shot->find('a', 0)->href;
                 $item['title'] = $shot->find('.shot-title', 0)->plaintext;
@@ -46,9 +46,8 @@ favicon-63b2904a073c89b52b19aa08cebc16a154bcf83fee8ecc6439968b1e6db569c7.ico';
         }
     }
 
-    private function loadEmbeddedJsonData($html)
+    private function fetchData($html)
     {
-        $json = [];
         $scripts = $html->find('script');
 
         foreach ($scripts as $script) {
@@ -69,12 +68,17 @@ favicon-63b2904a073c89b52b19aa08cebc16a154bcf83fee8ecc6439968b1e6db569c7.ico';
                 $end = strpos($script->innertext, '];') + 1;
 
                 // convert JSON to PHP array
-                $json = json_decode(substr($script->innertext, $start, $end - $start), true);
-                break;
+                $json = substr($script->innertext, $start, $end - $start);
+
+                try {
+                    // TODO: fix broken json
+                    return Json::decode($json);
+                } catch (\JsonException $e) {
+                    return [];
+                }
             }
         }
-
-        return $json;
+        return [];
     }
 
     private function findJsonForShot($shot, $json)

From 7001fbaf49a801226e819919cff913909242e7ac Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Sun, 31 Mar 2024 16:41:58 -0400
Subject: [PATCH 352/716] [AO3Bridge] Fix bad heading selector (#4045)

---
 bridges/AO3Bridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/AO3Bridge.php b/bridges/AO3Bridge.php
index 85f0f9f8..4c09c28c 100644
--- a/bridges/AO3Bridge.php
+++ b/bridges/AO3Bridge.php
@@ -77,7 +77,7 @@ class AO3Bridge extends BridgeAbstract
         $html = defaultLinkTo($html, self::URI);
 
         // Get list title. Will include page range + count in some cases
-        $heading = ($html->find('#main > h2', 0));
+        $heading = ($html->find('#main h2', 0));
         if ($heading->find('a.tag')) {
             $heading = $heading->find('a.tag', 0);
         }

From b4659786cb682096a46c0b6ca8a54505aa0ba49d Mon Sep 17 00:00:00 2001
From: Miika Launiainen <miika@miicat.eu>
Date: Mon, 1 Apr 2024 22:16:32 +0300
Subject: [PATCH 353/716] [GenshinImpactBridge] Small fixes (#4046)

* Switch json_decode to Json::decode

* Change regex delimeter from / to #

* Save item enclosures as list
---
 bridges/GenshinImpactBridge.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/bridges/GenshinImpactBridge.php b/bridges/GenshinImpactBridge.php
index 0dc08a28..924155d9 100644
--- a/bridges/GenshinImpactBridge.php
+++ b/bridges/GenshinImpactBridge.php
@@ -27,13 +27,13 @@ class GenshinImpactBridge extends BridgeAbstract
     {
         $url = 'https://api-os-takumi-static.hoyoverse.com/content_v2_user/app/a1b1f9d3315447cc/getContentList?iAppId=32&iChanId=395&iPageSize=5&iPage=1&sLangKey=en-us';
         $api_response = getContents($url);
-        $json_list = json_decode($api_response, true);
+        $json_list = Json::decode($api_response);
 
         foreach ($json_list['data']['list'] as $json_item) {
             $article_html = str_get_html($json_item['sContent']);
 
             // Check if article contains a embed YouTube video
-            $exp_youtube = '/https:\/\/[w\.]+youtube\.com\/embed\/([\w]+)/m';
+            $exp_youtube = '#https://[w\.]+youtube\.com/embed/([\w]+)#m';
             if (preg_match($exp_youtube, $article_html, $matches)) {
                 // Replace the YouTube embed with a YouTube link
                 $yt_embed = $article_html->find('div[class="ttr-video-frame"]', 0);
@@ -48,8 +48,8 @@ class GenshinImpactBridge extends BridgeAbstract
             $item['id'] = $json_item['iInfoId'];
 
             // Picture
-            $json_ext = json_decode($json_item['sExt'], true);
-            $item['enclosures'] = $json_ext['banner'][0]['url'];
+            $json_ext = Json::decode($json_item['sExt']);
+            $item['enclosures'] = [$json_ext['banner'][0]['url']];
 
             $this->items[] = $item;
         }

From a12bab9eedcf149778ad47e2ee84346e7b0d2016 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Dawid=20Wr=C3=B3bel?= <me@dawidwrobel.com>
Date: Mon, 1 Apr 2024 23:44:45 +0200
Subject: [PATCH 354/716] [AllegroBridge] ask for a complete cookie string,
 mere wcdx works no more (#4048)

---
 bridges/AllegroBridge.php | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)

diff --git a/bridges/AllegroBridge.php b/bridges/AllegroBridge.php
index 7cad11f1..04121257 100644
--- a/bridges/AllegroBridge.php
+++ b/bridges/AllegroBridge.php
@@ -13,12 +13,9 @@ class AllegroBridge extends BridgeAbstract
             'exampleValue' => 'https://allegro.pl/kategoria/swieze-warzywa-cebula-318660',
             'required' => true,
         ],
-        'sessioncookie' => [
-            'name' => 'The \'wdctx\' session cookie',
-            'title' => 'Paste the value of the \'wdctx\' cookie from your browser if you want to prevent Allegro imposing rate limits',
-            'pattern' => '^.{70,};?$',
-            // phpcs:ignore
-            'exampleValue' => 'v4.1-oCrmXTMqv2ppC21GTUCKLmUwRPP1ssQVALKuqwsZ1VXjcKgL2vO5TTRM5xMxS9GiyqxF1gAeyc-63dl0coUoBKXCXi_nAmr95yyqGpq2RAFoneZ4L399E8n6iYyemcuGARjAoSfjvLHJCEwvvHHynSgaxlFBu7hUnKfuy39zo9sSQdyTUjotJg3CAZ53q9v2raAnPCyGOAR4ytRILd9p24EJnxp7_oR0XbVPIo1hDa4WmjXFOxph8rHaO5tWd',
+        'cookie' => [
+            'name' => 'The complete cookie value',
+            'title' => 'Paste the value of the cookie value from your browser if you want to prevent Allegro imposing rate limits',
             'required' => false,
         ],
         'includeSponsoredOffers' => [
@@ -70,9 +67,9 @@ class AllegroBridge extends BridgeAbstract
 
         $opts = [];
 
-        // If a session cookie is provided
-        if ($sessioncookie = $this->getInput('sessioncookie')) {
-            $opts[CURLOPT_COOKIE] = 'wdctx=' . $sessioncookie;
+        // If a cookie is provided
+        if ($cookie = $this->getInput('cookie')) {
+            $opts[CURLOPT_COOKIE] = $cookie;
         }
 
         $html = getSimpleHTMLDOM($url, [], $opts);

From bb979e9e0865991806f0d2cf1c55044168bcf586 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Dawid=20Wr=C3=B3bel?= <me@dawidwrobel.com>
Date: Tue, 2 Apr 2024 00:06:15 +0200
Subject: [PATCH 355/716] [AllegroBridge] fix logical condition on parameters
 (#4049)

---
 bridges/AllegroBridge.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/AllegroBridge.php b/bridges/AllegroBridge.php
index 04121257..55e9f116 100644
--- a/bridges/AllegroBridge.php
+++ b/bridges/AllegroBridge.php
@@ -81,11 +81,11 @@ class AllegroBridge extends BridgeAbstract
 
         $results = $html->find('article[data-analytics-view-custom-context="REGULAR"]');
 
-        if (!$this->getInput('includeSponsoredOffers')) {
+        if ($this->getInput('includeSponsoredOffers')) {
             $results = array_merge($results, $html->find('article[data-analytics-view-custom-context="SPONSORED"]'));
         }
 
-        if (!$this->getInput('includePromotedOffers')) {
+        if ($this->getInput('includePromotedOffers')) {
             $results = array_merge($results, $html->find('article[data-analytics-view-custom-context="PROMOTED"]'));
         }
 

From 8f962383c269aa181c3fc7025c478ae712cd38a3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Dawid=20Wr=C3=B3bel?= <me@dawidwrobel.com>
Date: Tue, 2 Apr 2024 01:01:23 +0200
Subject: [PATCH 356/716] [eBayBridge] fix Belgian eBay URL handling (#4050)

Fixes #3918
---
 bridges/EBayBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/EBayBridge.php b/bridges/EBayBridge.php
index 507930ea..87958164 100644
--- a/bridges/EBayBridge.php
+++ b/bridges/EBayBridge.php
@@ -10,7 +10,7 @@ class EBayBridge extends BridgeAbstract
         'url' => [
             'name' => 'Search URL',
             'title' => 'Copy the URL from your browser\'s address bar after searching for your items and paste it here',
-            'pattern' => '^(https:\/\/)?(www.)?ebay\.(com|com\.au|at|be|ca|ch|cn|es|fr|de|com\.hk|ie|it|com\.my|nl|ph|pl|com\.sg|co\.uk).*$',
+            'pattern' => '^(https:\/\/)?(www\.)?(befr\.|benl\.)?ebay\.(com|com\.au|at|be|ca|ch|cn|es|fr|de|com\.hk|ie|it|com\.my|nl|ph|pl|com\.sg|co\.uk).*$',
             'exampleValue' => 'https://www.ebay.com/sch/i.html?_nkw=atom+rss',
             'required' => true,
         ]

From fb66775ecee9db86c6be55c28eeae1c8f50e4cee Mon Sep 17 00:00:00 2001
From: Niehztog <Niehztog@users.noreply.github.com>
Date: Tue, 2 Apr 2024 23:14:25 +0200
Subject: [PATCH 357/716] [XPathAbstract] Refactor xpath abstract (#4047)

* refactor XPathAbstract, keep all functionality intact

* fix linter errors

* further simplify code

* set default value for raw item content to true, avoiding escaping of html tags in feed item contents by default
---
 bridges/BlizzardNewsBridge.php |   2 +-
 lib/XPathAbstract.php          | 131 ++++++++++++---------------------
 2 files changed, 50 insertions(+), 83 deletions(-)

diff --git a/bridges/BlizzardNewsBridge.php b/bridges/BlizzardNewsBridge.php
index 19c38152..993492d4 100644
--- a/bridges/BlizzardNewsBridge.php
+++ b/bridges/BlizzardNewsBridge.php
@@ -37,7 +37,7 @@ class BlizzardNewsBridge extends XPathAbstract
 
     const XPATH_EXPRESSION_ITEM = '/html/body/div/div[4]/div[2]/div[2]/div/div/section/ol/li/article';
     const XPATH_EXPRESSION_ITEM_TITLE = './/div/div[2]/h2';
-    const XPATH_EXPRESSION_ITEM_CONTENT = './/div[@class="ArticleListItem-description"]/div[@class="h6"]';
+    const XPATH_EXPRESSION_ITEM_CONTENT = './/div[@class="ArticleListItem-description"]/div[@class="h6"]/text()';
     const XPATH_EXPRESSION_ITEM_URI = './/a[@class="ArticleLink ArticleLink"]/@href';
     const XPATH_EXPRESSION_ITEM_AUTHOR = '';
     const XPATH_EXPRESSION_ITEM_TIMESTAMP = './/time[@class="ArticleListItem-footerTimestamp"]/@timestamp';
diff --git a/lib/XPathAbstract.php b/lib/XPathAbstract.php
index 224d8e87..6163ca13 100644
--- a/lib/XPathAbstract.php
+++ b/lib/XPathAbstract.php
@@ -76,15 +76,6 @@ abstract class XPathAbstract extends BridgeAbstract
      */
     const XPATH_EXPRESSION_ITEM_CONTENT = '';
 
-    /**
-     * Use raw item content
-     * Whether to use the raw item content or to replace certain characters with
-     * special significance in HTML by HTML entities (using the PHP function htmlspecialchars).
-     *
-     * Use {@see XPathAbstract::getSettingUseRawItemContent()} to read this parameter
-     */
-    const SETTING_USE_RAW_ITEM_CONTENT = false;
-
     /**
      * XPath expression for extracting an item link from the item context
      * This expression should match a node's attribute containing the article URL
@@ -158,6 +149,15 @@ abstract class XPathAbstract extends BridgeAbstract
      */
     const SETTING_FIX_ENCODING = false;
 
+    /**
+     * Use raw item content
+     * Whether to use the raw item content or to replace certain characters with
+     * special significance in HTML by HTML entities (using the PHP function htmlspecialchars).
+     *
+     * Use {@see XPathAbstract::getSettingUseRawItemContent()} to read this parameter
+     */
+    const SETTING_USE_RAW_ITEM_CONTENT = true;
+
     /**
      * Internal storage for resulting feed name, automatically detected
      * @var string
@@ -245,15 +245,6 @@ abstract class XPathAbstract extends BridgeAbstract
         return static::XPATH_EXPRESSION_ITEM_CONTENT;
     }
 
-    /**
-     * Use raw item content
-     * @return bool
-     */
-    protected function getSettingUseRawItemContent(): bool
-    {
-        return static::SETTING_USE_RAW_ITEM_CONTENT;
-    }
-
     /**
      * XPath expression for extracting an item link from the item context
      * @return string
@@ -309,6 +300,15 @@ abstract class XPathAbstract extends BridgeAbstract
         return static::SETTING_FIX_ENCODING;
     }
 
+    /**
+     * Use raw item content
+     * @return bool
+     */
+    protected function getSettingUseRawItemContent(): bool
+    {
+        return static::SETTING_USE_RAW_ITEM_CONTENT;
+    }
+
     /**
      * Internal helper method for quickly accessing all the user defined constants
      * in derived classes
@@ -331,8 +331,6 @@ abstract class XPathAbstract extends BridgeAbstract
                 return $this->getExpressionItemTitle();
             case 'content':
                 return $this->getExpressionItemContent();
-            case 'raw_content':
-                return $this->getSettingUseRawItemContent();
             case 'uri':
                 return $this->getExpressionItemUri();
             case 'author':
@@ -345,6 +343,8 @@ abstract class XPathAbstract extends BridgeAbstract
                 return $this->getExpressionItemCategories();
             case 'fix_encoding':
                 return $this->getSettingFixEncoding();
+            case 'raw_content':
+                return $this->getSettingUseRawItemContent();
         }
     }
 
@@ -438,9 +438,15 @@ abstract class XPathAbstract extends BridgeAbstract
                     continue;
                 }
 
-                $isContent = $param === 'content';
-                $isCategories = 'categories' === $param;
-                $value = $this->getItemValueOrNodeValue($typedResult, $isContent, $isContent && !$this->getSettingUseRawItemContent(), $isCategories);
+                if ('categories' === $param && $typedResult instanceof \DOMNodeList) {
+                    $value = [];
+                    foreach ($typedResult as $domNode) {
+                        $value[] = $this->getItemValueOrNodeValue($domNode, false);
+                    }
+                } else {
+                    $value = $this->getItemValueOrNodeValue($typedResult, 'content' === $param);
+                }
+
                 $item->__set($param, $this->formatParamValue($param, $value));
             }
 
@@ -460,6 +466,7 @@ abstract class XPathAbstract extends BridgeAbstract
      */
     protected function formatParamValue($param, $value)
     {
+        $value = is_array($value) ? array_map('trim', $value) : trim($value);
         $value = is_array($value) ? array_map([$this, 'fixEncoding'], $value) : $this->fixEncoding($value);
         switch ($param) {
             case 'title':
@@ -503,7 +510,7 @@ abstract class XPathAbstract extends BridgeAbstract
      */
     protected function formatItemContent($value)
     {
-        return $value;
+        return $this->getParam('raw_content') ? $value : htmlspecialchars($value);
     }
 
     /**
@@ -599,68 +606,28 @@ abstract class XPathAbstract extends BridgeAbstract
      * @param $typedResult
      * @param bool $returnXML
      * @param bool $escapeHtml
-     * @param bool $allowMultiple
-     * @return string|array
-     * @throws Exception
-     */
-    protected function getItemValueOrNodeValue($typedResult, $returnXML = false, $escapeHtml = false, $allowMultiple = false)
-    {
-        if ($typedResult instanceof \DOMNodeList && !$allowMultiple) {
-            $item = $typedResult->item(0);
-            $text = $this->extractNodeListContent($item, $returnXML);
-        } elseif ($typedResult instanceof \DOMNodeList && $allowMultiple) {
-            $text = [];
-            foreach ($typedResult as $item) {
-                $text[] = $this->extractNodeListContent($item, $returnXML);
-            }
-        } elseif (is_string($typedResult) && strlen($typedResult) > 0) {
-            $text = $typedResult;
-        } else {
-            throw new \Exception('Unknown type of XPath expression result.');
-        }
-
-        if (is_array($text)) {
-            foreach ($text as &$element) {
-                $element = $this->cleanExtractedText($element, $escapeHtml, $returnXML);
-            }
-        } else {
-            $text = $this->cleanExtractedText($text, $escapeHtml, $returnXML);
-        }
-        return $text;
-    }
-
-    /**
-     * @param $item
-     * @param $returnXML
-     * @return false|string
-     * @throws Exception
-     */
-    protected function extractNodeListContent($item, $returnXML)
-    {
-        if ($item instanceof \DOMElement) {
-            return $returnXML ? ($item->ownerDocument ?? $item)->saveXML($item) : $item->nodeValue;
-        } elseif ($item instanceof \DOMAttr) {
-            return $item->value;
-        } elseif ($item instanceof \DOMText) {
-            return $item->wholeText;
-        }
-        throw new \Exception('Unknown type of XPath expression result.');
-    }
-
-    /**
-     * @param $text
-     * @param $escapeHtml
-     * @param $returnXML
      * @return string
+     * @throws Exception
      */
-    protected function cleanExtractedText($text, $escapeHtml, $returnXML)
+    protected function getItemValueOrNodeValue($typedResult, $returnXML = false)
     {
-        $text = trim($text);
-
-        if ($escapeHtml && !$returnXML) {
-            $text = htmlspecialchars($text);
+        if ($typedResult instanceof \DOMNodeList) {
+            $typedResult = $typedResult->item(0);
         }
-        return $text;
+
+        if ($typedResult instanceof \DOMElement) {
+            return $returnXML ? ($typedResult->ownerDocument ?? $typedResult)->saveXML($typedResult) : $typedResult->nodeValue;
+        } elseif ($typedResult instanceof \DOMAttr) {
+            return $typedResult->value;
+        } elseif ($typedResult instanceof \DOMText) {
+            return $typedResult->wholeText;
+        } elseif (is_string($typedResult)) {
+            return $typedResult;
+        } elseif (null === $typedResult) {
+            return '';
+        }
+
+        throw new \Exception('Unknown type of XPath expression result: ' . gettype($typedResult));
     }
 
     /**

From f736da6faebecf9215c11674c4dce12497136281 Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Wed, 3 Apr 2024 16:23:52 +0200
Subject: [PATCH 358/716] [GolemBridge] fix for internal videos (#4051)

* [GolemBridge] fix for internal videos

with this internal golem-videos can be played directly from feed

* Update GolemBridge.php
---
 bridges/GolemBridge.php | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/bridges/GolemBridge.php b/bridges/GolemBridge.php
index 216e913f..b52d3c2f 100644
--- a/bridges/GolemBridge.php
+++ b/bridges/GolemBridge.php
@@ -119,6 +119,16 @@ class GolemBridge extends FeedExpander
             }
         }
 
+        //built golem videos
+        foreach ($article->find('.gvideofig') as &$embedcontent) {
+            if (preg_match('/gvideo_(.*)/', $embedcontent->id, $videoid)) {
+                $embedcontent->innertext .= <<<EOT
+                    <video class="rmp-object-fit-contain rmp-video" x-webkit-airplay="allow" controlslist="nodownload" tabindex="-1"
+                    preload="metadata" src="https://video.golem.de/download/$videoid[1]"></video>                                                                      
+                EOT;
+            }
+        }
+
         // delete known bad elements
         foreach (
             $article->find('div[id*="adtile"], #job-market, #seminars, iframe,
@@ -142,7 +152,7 @@ class GolemBridge extends FeedExpander
             $img->src = $img->getAttribute('data-src-full');
         }
 
-        foreach ($content->find('p, h1, h2, h3, img[src*="."], iframe') as $element) {
+        foreach ($content->find('p, h1, h2, h3, img[src*="."], iframe, video') as $element) {
             $item .= $element;
         }
 

From 94292af51b1dd662cc9513df0f2bfacfa70dad35 Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Thu, 4 Apr 2024 04:07:16 +0200
Subject: [PATCH 359/716] [prtester.py] fix url parameter encoding (#4052)

this will (at least) fix the pr preview of:
bridges/AnisearchBridge.php
bridges/BakaUpdatesMangaReleasesBridge.php
bridges/DesoutterBridge.php
bridges/IndiegogoBridge.php
---
 .github/prtester.py | 46 +++++++++++++++++++++++++--------------------
 1 file changed, 26 insertions(+), 20 deletions(-)

diff --git a/.github/prtester.py b/.github/prtester.py
index 30a9f43b..3d7dae99 100644
--- a/.github/prtester.py
+++ b/.github/prtester.py
@@ -5,6 +5,7 @@ from bs4 import BeautifulSoup
 from datetime import datetime
 from typing import Iterable
 import os.path
+import urllib
 
 # This script is specifically written to be used in automation for https://github.com/RSS-Bridge/rss-bridge
 #
@@ -45,15 +46,14 @@ def testBridges(instance: Instance, bridge_cards: Iterable, with_upload: bool, w
         bridgeid = bridge_card.get('id')
         bridgeid = bridgeid.split('-')[1] # this extracts a readable bridge name from the bridge metadata
         print(f'{bridgeid}{instance_suffix}')
-        bridgestring = '/?action=display&bridge=' + bridgeid + '&format=Html'
         bridge_name = bridgeid.replace('Bridge', '')
         context_forms = bridge_card.find_all("form")
         form_number = 1
         for context_form in context_forms:
             # a bridge can have multiple contexts, named 'forms' in html
-            # this code will produce a fully working formstring that should create a working feed when called
+            # this code will produce a fully working url that should create a working feed when called
             # this will create an example feed for every single context, to test them all
-            formstring = ''
+            context_parameters = {}
             error_messages = []
             context_name = '*untitled*'
             context_name_element = context_form.find_previous_sibling('h5')
@@ -62,27 +62,27 @@ def testBridges(instance: Instance, bridge_cards: Iterable, with_upload: bool, w
             parameters = context_form.find_all("input")
             lists = context_form.find_all("select")
             # this for/if mess cycles through all available input parameters, checks if it required, then pulls
-            # the default or examplevalue and then combines it all together into the formstring
+            # the default or examplevalue and then combines it all together into the url parameters
             # if an example or default value is missing for a required attribute, it will throw an error
             # any non-required fields are not tested!!!
             for parameter in parameters:
-                if parameter.get('type') == 'hidden' and parameter.get('name') == 'context':
-                    cleanvalue = parameter.get('value').replace(" ","+")
-                    formstring = formstring + '&' + parameter.get('name') + '=' + cleanvalue
-                if parameter.get('type') == 'number' or parameter.get('type') == 'text':
+                parameter_type = parameter.get('type')
+                parameter_name = parameter.get('name')
+                if parameter_type == 'hidden':
+                    context_parameters[parameter_name] = parameter.get('value')
+                if parameter_type == 'number' or parameter_type == 'text':
                     if parameter.has_attr('required'):
                         if parameter.get('placeholder') == '':
                             if parameter.get('value') == '':
-                                name_value = parameter.get('name')
-                                error_messages.append(f'Missing example or default value for parameter "{name_value}"')
+                                error_messages.append(f'Missing example or default value for parameter "{parameter_name}"')
                             else:
-                                formstring = formstring + '&' + parameter.get('name') + '=' + parameter.get('value')
+                                context_parameters[parameter_name] = parameter.get('value')
                         else:
-                            formstring = formstring + '&' + parameter.get('name') + '=' + parameter.get('placeholder')
-                # same thing, just for checkboxes. If a checkbox is checked per default, it gets added to the formstring
-                if parameter.get('type') == 'checkbox':
+                            context_parameters[parameter_name] = parameter.get('placeholder')
+                # same thing, just for checkboxes. If a checkbox is checked per default, it gets added to the url parameters
+                if parameter_type == 'checkbox':
                     if parameter.has_attr('checked'):
-                        formstring = formstring + '&' + parameter.get('name') + '=on'
+                        context_parameters[parameter_name] = 'on'
             for listing in lists:
                 selectionvalue = ''
                 listname = listing.get('name')
@@ -102,15 +102,21 @@ def testBridges(instance: Instance, bridge_cards: Iterable, with_upload: bool, w
                         if 'selected' in selectionentry.attrs:
                             selectionvalue = selectionentry.get('value')
                             break
-                formstring = formstring + '&' + listname + '=' + selectionvalue
+                context_parameters[listname] = selectionvalue
             termpad_url = 'about:blank'
             if error_messages:
                 status = '<br>'.join(map(lambda m: f'❌ `{m}`', error_messages))
             else:
-                # if all example/default values are present, form the full request string, run the request, add a <base> tag with
+                # if all example/default values are present, form the full request url, run the request, add a <base> tag with
                 # the url of em's public instance to the response text (so that relative paths work, e.g. to the static css file) and
                 # then upload it to termpad.com, a pastebin-like-site.
-                response = requests.get(instance.url + bridgestring + formstring)
+                context_parameters.update({
+                    'action': 'display',
+                    'bridge': bridgeid,
+                    'format': 'Html',
+                })
+                request_url = f'{instance.url}/?{urllib.parse.urlencode(context_parameters)}'
+                response = requests.get(request_url)
                 page_text = response.text.replace('<head>','<head><base href="https://rss-bridge.org/bridge01/" target="_blank">')
                 page_text = page_text.encode("utf_8")
                 soup = BeautifulSoup(page_text, "html.parser")
@@ -163,8 +169,8 @@ if __name__ == '__main__':
         for instance_arg in args.instances:
             instance_arg_parts = instance_arg.split('::')
             instance = Instance()
-            instance.name = instance_arg_parts[1] if len(instance_arg_parts) >= 2 else ''
-            instance.url = instance_arg_parts[0]
+            instance.name = instance_arg_parts[1].strip() if len(instance_arg_parts) >= 2 else ''
+            instance.url = instance_arg_parts[0].strip().rstrip("/")
             instances.append(instance)
     else:
         instance = Instance()

From 82606a479a75cd4eff4740ba49715b3135c89c49 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Thu, 4 Apr 2024 04:08:29 +0200
Subject: [PATCH 360/716] 
 [PepperBridgeAbstract,DealabsBridge,HotUKDealsBridge,MydealsBridge] Fix
 search URL, No results handling fixed, Thread title and Message URL handling
 (#4053)

* [PepperBridgeAbstract,DealabsBridge,HotUKDealsBridge,MydealsBridge] Fix search URL, No results handling fixed, Thread title and Message URL handling

Search URL has been updated according to the website.

If a search doesn't return any results, the HTML won't contain any
specific text now : the HTML structure is slightly different, so the
bridge has been updated.

The unnneded 'no-results' text is now removed from the specific bridges.

The board thread title has been removed from the content, so now we use
the page <title> element.

In case a board message is empty, there was an exception during the
filtering of message without URL.

* [PepperBridgeAbstract,DealabsBridge,HotUKDealsBridge,MydealsBridge] Fix search URL, No results handling fixed, Thread title and Message URL handling

Coding policy fixes
---
 bridges/DealabsBridge.php        |  1 -
 bridges/HotUKDealsBridge.php     |  1 -
 bridges/MydealsBridge.php        |  1 -
 bridges/PepperBridgeAbstract.php | 25 ++++++++++++++-----------
 4 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/bridges/DealabsBridge.php b/bridges/DealabsBridge.php
index 62d854f6..3ee1c6f5 100644
--- a/bridges/DealabsBridge.php
+++ b/bridges/DealabsBridge.php
@@ -1913,7 +1913,6 @@ class DealabsBridge extends PepperBridgeAbstract
         'uri-merchant' => 'search/bons-plans?merchant-id=',
         'request-error' => 'Impossible de joindre Dealabs',
         'thread-error' => 'Impossible de déterminer l\'ID de la discussion. Vérifiez l\'URL que vous avez entré',
-        'no-results' => 'Aucun résultat',
         'currency' => '€',
         'price' => 'Prix',
         'shipping' => 'Livraison',
diff --git a/bridges/HotUKDealsBridge.php b/bridges/HotUKDealsBridge.php
index b631db73..6958220e 100644
--- a/bridges/HotUKDealsBridge.php
+++ b/bridges/HotUKDealsBridge.php
@@ -3277,7 +3277,6 @@ class HotUKDealsBridge extends PepperBridgeAbstract
         'uri-merchant' => 'search/deals?merchant-id=',
         'request-error' => 'Could not request HotUKDeals',
         'thread-error' => 'Unable to determine the thread ID. Check the URL you entered',
-        'no-results' => 'no results',
         'currency' => '£',
         'price' => 'Price',
         'shipping' => 'Shipping',
diff --git a/bridges/MydealsBridge.php b/bridges/MydealsBridge.php
index 41bae46c..7b23f263 100644
--- a/bridges/MydealsBridge.php
+++ b/bridges/MydealsBridge.php
@@ -2024,7 +2024,6 @@ class MydealsBridge extends PepperBridgeAbstract
         'uri-merchant' => 'search/gutscheine?merchant-id=',
         'request-error' => 'Could not request mydeals',
         'thread-error' => 'Die ID der Diskussion kann nicht ermittelt werden. Überprüfen Sie die eingegebene URL',
-        'no-results' => 'keine Ergebnisse',
         'currency' => '€',
         'price' => 'Preis',
         'shipping' => 'Versand',
diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index 7b40ea1c..33d427bc 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -55,8 +55,8 @@ class PepperBridgeAbstract extends BridgeAbstract
         );
 
         // If there is no results, we don't parse the content because it display some random deals
-        $noresult = $html->find('h3[class*=text--b]', 0);
-        if ($noresult != null && strpos($noresult->plaintext, $this->i8n('no-results')) !== false) {
+        $noresult = $html->find('section[class=subNav]', 0)->find('div[class*=page-center listLayout aGrid]', 0);
+        if ($noresult === null) {
             $this->items = [];
         } else {
             foreach ($list as $deal) {
@@ -174,13 +174,16 @@ HEREDOC;
             $item['uid'] = $comment->commentId;
             // Timestamp handling needs a new parsing function
             if ($onlyWithUrl == true) {
-                // Count Links and Quote Links
-                $content = str_get_html($item['content']);
-                $countLinks = count($content->find('a[href]'));
-                $countQuoteLinks = count($content->find('a[href][class=userHtml-quote-source]'));
-                // Only add element if there are Links ans more links tant Quote links
-                if ($countLinks > 0 && $countLinks > $countQuoteLinks) {
-                    $this->items[] = $item;
+                // Only parse the comment if it is not empry
+                if ($item['content'] != '') {
+                    // Count Links and Quote Links
+                    $content = str_get_html($item['content']);
+                    $countLinks = count($content->find('a[href]'));
+                    $countQuoteLinks = count($content->find('a[href][class=userHtml-quote-source]'));
+                    // Only add element if there are Links and more links tant Quote links
+                    if ($countLinks > 0 && $countLinks > $countQuoteLinks) {
+                        $this->items[] = $item;
+                    }
                 }
             } else {
                 $this->items[] = $item;
@@ -264,7 +267,7 @@ HEREDOC;
     private function getTalkTitle()
     {
         $html = getSimpleHTMLDOMCached($this->getInput('url'));
-        $title = $html->find('.thread-title', 0)->plaintext;
+        $title = $html->find('title', 0)->plaintext;
         return $title;
     }
 
@@ -472,7 +475,7 @@ HEREDOC;
         $priceFrom = $this->getInput('priceFrom');
         $priceTo = $this->getInput('priceTo');
         $url = $this->i8n('bridge-uri')
-            . 'search/advanced?q='
+            . 'search?q='
             . urlencode($q)
             . '&hide_expired=' . $hide_expired
             . '&hide_local=' . $hide_local

From 3cba984d22d6b1e045781f208211c4fb336c2bf0 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 4 Apr 2024 17:43:07 +0200
Subject: [PATCH 361/716] fix(FDroidRepoBridge): unlink when json file is
 absent from archive (#4056)

---
 bridges/FDroidRepoBridge.php | 110 +++++++++++++++++++----------------
 1 file changed, 59 insertions(+), 51 deletions(-)

diff --git a/bridges/FDroidRepoBridge.php b/bridges/FDroidRepoBridge.php
index 7ce41baf..286ada1b 100644
--- a/bridges/FDroidRepoBridge.php
+++ b/bridges/FDroidRepoBridge.php
@@ -49,7 +49,7 @@ class FDroidRepoBridge extends BridgeAbstract
             throw new \Exception('FDroidRepoBridge requires the php-zip extension');
         }
 
-        $this->repo = $this->getRepo();
+        $this->repo = $this->fetchData();
         switch ($this->queriedContext) {
             case 'Latest Updates':
                 $this->getAllUpdates();
@@ -58,63 +58,40 @@ class FDroidRepoBridge extends BridgeAbstract
                 $this->getPackage($this->getInput('package'));
                 break;
             default:
-                returnServerError('Unimplemented Context (collectData)');
+                throw new \Exception('Unimplemented Context (collectData)');
         }
     }
 
-    public function getURI()
-    {
-        if (empty($this->queriedContext)) {
-            return parent::getURI();
-        }
-
-        $url = rtrim($this->GetInput('url'), '/');
-        return strstr($url, '?', true) ?: $url;
-    }
-
-    public function getName()
-    {
-        if (empty($this->queriedContext)) {
-            return parent::getName();
-        }
-
-        $name = $this->repo['repo']['name'];
-        switch ($this->queriedContext) {
-            case 'Latest Updates':
-                return $name;
-            case 'Follow Package':
-                return $this->getInput('package') . ' - ' . $name;
-            default:
-                returnServerError('Unimplemented Context (getName)');
-        }
-    }
-
-    private function getRepo()
+    /**
+     * This method fetches data from arbitrary url and writes to os temp file.
+     * I don't think there's any security problem here but might be DOS problems.
+     */
+    private function fetchData()
     {
         $url = $this->getURI();
 
-        // Get repo information (only available as JAR)
-        $jar = getContents($url . '/index-v1.jar');
-        $jar_loc = tempnam(sys_get_temp_dir(), '');
-        file_put_contents($jar_loc, $jar);
+        $zipFile = getContents($url . '/index-v1.jar');
+        // On linux this creates a temp file in /tmp/
+        $temporaryFile = tempnam(sys_get_temp_dir(), 'rssbridge_');
+        file_put_contents($temporaryFile, $zipFile);
 
-        // JAR files are specially formatted ZIP files
-        $jar = new \ZipArchive();
-        if ($jar->open($jar_loc) !== true) {
-            unlink($jar_loc);
+        $archive = new \ZipArchive();
+        if ($archive->open($temporaryFile) !== true) {
+            unlink($temporaryFile);
             throw new \Exception('Failed to extract archive');
         }
 
-        // Get file pointer to the relevant JSON inside
-        $fp = $jar->getStream('index-v1.json');
+        $fp = $archive->getStream('index-v1.json');
         if (!$fp) {
-            returnServerError('Failed to get file pointer');
+            unlink($temporaryFile);
+            throw new \Exception('Failed to get file pointer');
         }
 
-        $data = json_decode(stream_get_contents($fp), true);
+        $json = stream_get_contents($fp);
         fclose($fp);
-        $jar->close();
-        unlink($jar_loc);
+        $data = Json::decode($json);
+        $archive->close();
+        unlink($temporaryFile);
         return $data;
     }
 
@@ -158,9 +135,9 @@ class FDroidRepoBridge extends BridgeAbstract
             $summary = $lang['summary'] ?? $app['summary'] ?? '';
             $description = markdownToHtml(trim($lang['description'] ?? $app['description'] ?? 'None'));
             $whatsNew = markdownToHtml(trim($lang['whatsNew'] ?? 'None'));
-            $website = $this->link($lang['webSite'] ?? $app['webSite'] ?? $app['authorWebSite'] ?? null);
-            $source = $this->link($app['sourceCode'] ?? null);
-            $issueTracker = $this->link($app['issueTracker'] ?? null);
+            $website = $this->createAnchor($lang['webSite'] ?? $app['webSite'] ?? $app['authorWebSite'] ?? null);
+            $source = $this->createAnchor($app['sourceCode'] ?? null);
+            $issueTracker = $this->createAnchor($app['issueTracker'] ?? null);
             $license = $app['license'] ?? 'None';
             $item['content'] = <<<EOD
 {$icon}
@@ -182,7 +159,7 @@ EOD;
     private function getPackage($package)
     {
         if (!isset($this->repo['packages'][$package])) {
-            returnClientError('Invalid Package Name');
+            throw new \Exception('Invalid Package Name');
         }
         $package = $this->repo['packages'][$package];
 
@@ -192,7 +169,7 @@ EOD;
             $item['uri'] = $this->getURI() . '/' . $version['apkName'];
             $item['title'] = $version['versionName'];
             $item['timestamp'] = date(DateTime::ISO8601, (int) ($version['added'] / 1000));
-            $item['uid'] = $version['versionCode'];
+            $item['uid'] = (string) $version['versionCode'];
             $size = round($version['size'] / 1048576, 1); // Bytes -> MB
             $sdk_link = 'https://developer.android.com/studio/releases/platforms';
             $item['content'] = <<<EOD
@@ -208,11 +185,42 @@ EOD;
         }
     }
 
-    private function link($url)
+    public function getURI()
+    {
+        if (empty($this->queriedContext)) {
+            return parent::getURI();
+        }
+
+        $url = rtrim($this->getInput('url'), '/');
+        if (strstr($url, '?', true)) {
+            return strstr($url, '?', true);
+        } else {
+            return $url;
+        }
+    }
+
+    public function getName()
+    {
+        if (empty($this->queriedContext)) {
+            return parent::getName();
+        }
+
+        $name = $this->repo['repo']['name'];
+        switch ($this->queriedContext) {
+            case 'Latest Updates':
+                return $name;
+            case 'Follow Package':
+                return $this->getInput('package') . ' - ' . $name;
+            default:
+                throw new \Exception('Unimplemented Context (getName)');
+        }
+    }
+
+    private function createAnchor($url)
     {
         if (empty($url)) {
             return null;
         }
-        return '<a href="' . $url . '">' . $url . '</a>';
+        return sprintf('<a href="%s">%s</a>', $url, $url);
     }
 }

From 001dd47439339672b6e84979fd0e1a0118bc27b6 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 4 Apr 2024 19:12:04 +0200
Subject: [PATCH 362/716] fix: small tweaks (#4057)

---
 bridges/FeedMergeBridge.php  |  5 +++-
 bridges/GatesNotesBridge.php |  4 +++
 bridges/PixivBridge.php      | 47 +++---------------------------------
 lib/FeedExpander.php         |  1 +
 4 files changed, 13 insertions(+), 44 deletions(-)

diff --git a/bridges/FeedMergeBridge.php b/bridges/FeedMergeBridge.php
index f2c1d9d5..37b574b6 100644
--- a/bridges/FeedMergeBridge.php
+++ b/bridges/FeedMergeBridge.php
@@ -64,6 +64,7 @@ TEXT;
                     $this->collectExpandableDatas($feed);
                 } catch (HttpException $e) {
                     $this->logger->warning(sprintf('Exception in FeedMergeBridge: %s', create_sane_exception_message($e)));
+                    // This feed item might be spammy. Considering dropping it.
                     $this->items[] = [
                         'title' => 'RSS-Bridge: ' . $e->getMessage(),
                         // Give current time so it sorts to the top
@@ -71,7 +72,7 @@ TEXT;
                     ];
                     continue;
                 } catch (\Exception $e) {
-                    if (str_starts_with($e->getMessage(), 'Unable to parse xml')) {
+                    if (str_starts_with($e->getMessage(), 'Failed to parse xml')) {
                         // Allow this particular exception from FeedExpander
                         $this->logger->warning(sprintf('Exception in FeedMergeBridge: %s', create_sane_exception_message($e)));
                         continue;
@@ -83,6 +84,8 @@ TEXT;
             }
         }
 
+        // If $this->items is empty we should consider throw exception here
+
         // Sort by timestamp descending
         usort($this->items, function ($a, $b) {
             $t1 = $a['timestamp'] ?? $a['uri'] ?? $a['title'];
diff --git a/bridges/GatesNotesBridge.php b/bridges/GatesNotesBridge.php
index 3381e096..b46b3ce6 100644
--- a/bridges/GatesNotesBridge.php
+++ b/bridges/GatesNotesBridge.php
@@ -21,6 +21,10 @@ class GatesNotesBridge extends BridgeAbstract
 
         $rawContent = getContents($apiUrl);
         $cleanedContent = trim($rawContent, '"');
+        $cleanedContent = str_replace([
+            '<string xmlns="http://schemas.microsoft.com/2003/10/Serialization/">',
+            '</string>'
+        ], '', $cleanedContent);
         $cleanedContent = str_replace('\r\n', "\n", $cleanedContent);
         $cleanedContent = stripslashes($cleanedContent);
 
diff --git a/bridges/PixivBridge.php b/bridges/PixivBridge.php
index fc4443ed..604b5d4b 100644
--- a/bridges/PixivBridge.php
+++ b/bridges/PixivBridge.php
@@ -160,7 +160,8 @@ class PixivBridge extends BridgeAbstract
                         $json = array_reduce($json, function ($acc, $i) {
                             if ($i['illustType'] === 0) {
                                 $acc[] = $i;
-                            }return $acc;
+                            }
+                            return $acc;
                         }, []);
                         break;
                     case 'manga':
@@ -235,8 +236,10 @@ class PixivBridge extends BridgeAbstract
 
             $item = [];
             $item['uid'] = $result['id'];
+
             $subpath = array_key_exists('illustType', $result) ? 'artworks/' : 'novel/show.php?id=';
             $item['uri'] = static::URI . $subpath . $result['id'];
+
             $item['title'] = $result['title'];
             $item['author'] = $result['userName'];
             $item['timestamp'] = $result['updateDate'];
@@ -253,8 +256,6 @@ class PixivBridge extends BridgeAbstract
                 }
             } else {
                 $img_url = $result['url'];
-                // Temporarily disabling caching of the image
-                //$img_url = $this->cacheImage($result['url'], $result['id'], array_key_exists('illustType', $result));
             }
 
             // Currently, this might result in broken image due to their strict referrer check
@@ -271,46 +272,6 @@ class PixivBridge extends BridgeAbstract
         }
     }
 
-    /**
-     * todo: remove manual file cache
-     * See bridge specific documentation for alternative option.
-     */
-    private function cacheImage($url, $illustId, $isImage)
-    {
-        $illustId = preg_replace('/[^0-9]/', '', $illustId);
-        $thumbnailurl = $url;
-
-        $path = PATH_CACHE . 'pixiv_img/';
-        if (!is_dir($path)) {
-            mkdir($path, 0755, true);
-        }
-
-        $path .= $illustId;
-        if ($this->getInput('fullsize')) {
-            $path .= '_fullsize';
-        }
-        $path .= '.jpg';
-
-        if (!is_file($path)) {
-            // Get fullsize URL
-            if ($isImage && $this->getInput('fullsize')) {
-                $ajax_uri = static::URI . 'ajax/illust/' . $illustId;
-                $imagejson = $this->getData($ajax_uri, true, true);
-                $url = $imagejson['body']['urls']['original'];
-            }
-
-            $headers = ['Referer: ' . static::URI];
-            try {
-                $illust = $this->getData($url, true, false, $headers);
-            } catch (Exception $e) {
-                $illust = $this->getData($thumbnailurl, true, false, $headers); // Original thumbnail
-            }
-            file_put_contents($path, $illust);
-        }
-
-        return get_home_page_url() . 'cache/pixiv_img/' . preg_replace('/.*\//', '', $path);
-    }
-
     private function checkOptions()
     {
         $proxy = $this->getOption('proxy_url');
diff --git a/lib/FeedExpander.php b/lib/FeedExpander.php
index abe964e1..fe809bc2 100644
--- a/lib/FeedExpander.php
+++ b/lib/FeedExpander.php
@@ -34,6 +34,7 @@ abstract class FeedExpander extends BridgeAbstract
         try {
             $this->feed = $feedParser->parseFeed($xmlString);
         } catch (\Exception $e) {
+            // FeedMergeBridge relies on this string
             throw new \Exception(sprintf('Failed to parse xml from %s: %s', $url, create_sane_exception_message($e)));
         }
 

From 3ff2ef94e00d2edd52afb6795e9060538e63e4d5 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Thu, 4 Apr 2024 19:28:56 +0200
Subject: [PATCH 363/716] Fix docs : Replace relative links to files with full
 URL (#4059)

---
 docs/06_Helper_functions/index.md | 39 +++++++++++++++++++++++++------
 1 file changed, 32 insertions(+), 7 deletions(-)

diff --git a/docs/06_Helper_functions/index.md b/docs/06_Helper_functions/index.md
index 3aaeed89..2b675ca3 100644
--- a/docs/06_Helper_functions/index.md
+++ b/docs/06_Helper_functions/index.md
@@ -8,6 +8,8 @@ $this->getInput('your input name here');
 `getInput` will either return the value for your parameter
 or `null` if the parameter is unknown or not specified.
 
+[Defined in lib/BridgeAbstract.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/BridgeAbstract.php)
+
 # getKey
 The `getKey` function is used to receive the key name to a selected list
 value given the name of the list, specified in `const PARAMETERS`
@@ -39,6 +41,8 @@ $this->getKey('country');
 `getKey` will either return the key name for your parameter or `null` if the parameter
 is unknown or not specified.
 
+[Defined in lib/BridgeAbstract.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/BridgeAbstract.php)
+
 # getContents
 The `getContents` function uses [cURL](https://secure.php.net/manual/en/book.curl.php) to acquire data from the specified URI while respecting the various settings defined at a global level by RSS-Bridge (i.e., proxy host, user agent, etc.). This function accepts a few parameters:
 
@@ -55,6 +59,8 @@ $opts = array(CURLOPT_POST => 1);
 $html = getContents($url, $header, $opts);
 ```
 
+[Defined in lib/contents.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/contents.php)
+
 # getSimpleHTMLDOM
 The `getSimpleHTMLDOM` function is a wrapper for the 
 [simple_html_dom](https://simplehtmldom.sourceforge.io/) [file_get_html](https://simplehtmldom.sourceforge.io/docs/1.9/api/file_get_html/) function in order to provide context by design.
@@ -62,6 +68,9 @@ The `getSimpleHTMLDOM` function is a wrapper for the
 ```PHP
 $html = getSimpleHTMLDOM('your URI');
 ```
+
+[Defined in lib/contents.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/contents.php)
+
 # getSimpleHTMLDOMCached
 The `getSimpleHTMLDOMCached` function does the same as the 
 [`getSimpleHTMLDOM`](#getsimplehtmldom) function,
@@ -76,6 +85,8 @@ This function allows to specify the cache duration with the second parameter.
 $html = getSimpleHTMLDOMCached('your URI', 86400); // Duration 24h
 ```
 
+[Defined in lib/contents.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/contents.php)
+
 # returnClientError
 The `returnClientError` function aborts execution of the current bridge
 and returns the given error message with error code **400**:
@@ -86,6 +97,8 @@ returnClientError('Your error message')
 
 Use this function when the user provided invalid parameter or a required parameter is missing.
 
+[Defined in lib/utils.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/utils.php)
+
 # returnServerError
 The `returnServerError` function aborts execution of the current bridge and returns the given error message with error code **500**:
 
@@ -96,6 +109,8 @@ returnServerError('Your error message')
 Use this function when a problem occurs that has nothing to do with the parameters provided by the user.
 (like: Host service gone missing, empty data received, etc...)
 
+[Defined in lib/utils.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/utils.php)
+
 # defaultLinkTo
 Automatically replaces any relative URL in a given string or DOM object
 (i.e. the one returned by [getSimpleHTMLDOM](#getsimplehtmldom)) with an absolute URL.
@@ -122,6 +137,8 @@ $html = defaultLinkTo($html, $this->getURI()); // Using bridge URL
 // <img src="https://www.github.com/rss-bridge/rss-bridge/blob/master/README.md">
 ```
 
+[Defined in lib/html.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/html.php)
+
 # backgroundToImg
 Replaces tags with styles of `backgroud-image` by `<img />` tags.
 
@@ -131,6 +148,8 @@ backgroundToImg(mixed $htmlContent) : object
 
 Returns a DOM object (even if provided a string).
 
+[Defined in lib/html.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/html.php)
+
 # extractFromDelimiters
 Extract the first part of a string matching the specified start and end delimiters.
 ```php
@@ -151,6 +170,8 @@ $extracted = extractFromDelimiters($string, $start, $end);
 // 'John Doe'
 ```
 
+[Defined in lib/html.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/html.php)
+
 # stripWithDelimiters
 Remove one or more part(s) of a string using a start and end delimiter.
 It is the inverse of `extractFromDelimiters`.
@@ -173,6 +194,8 @@ $cleaned = stripWithDelimiters($string, $start, $end);
 // 'foobar'
 ```
 
+[Defined in lib/html.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/html.php)
+
 # stripRecursiveHTMLSection
 Remove HTML sections containing one or more sections using the same HTML tag.
 
@@ -192,6 +215,8 @@ $cleaned = stripRecursiveHTMLSection($string, $tag_name, $tag_start);
 // 'foobar'
 ```
 
+[Defined in lib/html.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/html.php)
+
 # markdownToHtml
 Converts markdown input to HTML using [Parsedown](https://parsedown.org/).
 
@@ -234,6 +259,7 @@ $html = markdownToHtml($input);
 // </ul>
 ```
 
+[Defined in lib/html.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/html.php)
 
 # e
 The `e` function is used to convert special characters to HTML entities
@@ -244,7 +270,7 @@ e('0 < 1 and 2 > 1');
 
 `e` will return the content of the string escape that can be rendered as is in HTML
 
-[Defined in lib/html.php](/lib/html.php)
+[Defined in lib/html.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/html.php)
 
 # truncate
 The `truncate` function is used to shorten a string if exceeds a certain length, and add a string indicating that the string has been shortened.
@@ -253,7 +279,7 @@ The `truncate` function is used to shorten a string if exceeds a certain length,
 truncate('Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed a neque nunc. Nam nibh sem.', 20 , '...');
 ```
 
-[Defined in lib/html.php](/lib/html.php)
+[Defined in lib/html.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/html.php)
 
 # sanitize
 The `sanitize` function is used to remove some tags from a given HTML text.
@@ -272,7 +298,7 @@ sanitize($html, $tags_to_remove, $attributes_to_keep, $text_to_keep);
 
 This function returns a simplehtmldom object of the remaining contents.
 
-[Defined in lib/html.php](/lib/html.php)
+[Defined in lib/html.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/html.php)
 
 # convertLazyLoading
 The `convertLazyLoading` function is used to convert onvert lazy-loading images and frames (video embeds) into static elements. It accepts the HTML content as HTML objects or string objects. It returns the HTML content with fixed image/frame URLs (same type as input).
@@ -286,8 +312,7 @@ $html = '<html>
 backgroundToImg($html);
 ```
 
-[Defined in lib/html.php](/lib/html.php)
-
+[Defined in lib/html.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/html.php)
 
 # Json::encode
 The `Json::encode` function is used to encode a value as à JSON string.
@@ -300,7 +325,7 @@ $array = [
 Json::encode($array, true, true);
 ```
 
-[Defined in lib/utils.php](/lib/utils.php)
+[Defined in lib/utils.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/utils.php)
 
 # Json::decode
 The `Json::decode` function is used to decode a JSON string into à PHP variable.
@@ -313,4 +338,4 @@ $json = '{
 Json::decode($json);
 ```
 
-[Defined in lib/utils.php](/lib/utils.php)
+[Defined in lib/utils.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/utils.php)

From d5aa3aef699b400d5b40d61ee45c4476f0fcb38e Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Fri, 5 Apr 2024 11:31:30 +0200
Subject: [PATCH 364/716] [FDroidRepoBridge] Fix example repo

The ttrss example/placeholder repo is offline, which fails CI jobs.
Replace it with a healthy repo and package to get working CI tests and comparisons.
---
 bridges/FDroidRepoBridge.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/FDroidRepoBridge.php b/bridges/FDroidRepoBridge.php
index 286ada1b..b3fd146e 100644
--- a/bridges/FDroidRepoBridge.php
+++ b/bridges/FDroidRepoBridge.php
@@ -14,7 +14,7 @@ class FDroidRepoBridge extends BridgeAbstract
                 'name' => 'Repository URL',
                 'title' => 'Usually ends with /repo/',
                 'required' => true,
-                'exampleValue' => 'https://srv.tt-rss.org/fdroid/repo'
+                'exampleValue' => 'https://molly.im/fdroid/foss/fdroid/repo'
             ]
         ],
         'Latest Updates' => [
@@ -35,7 +35,7 @@ class FDroidRepoBridge extends BridgeAbstract
             'package' => [
                 'name' => 'Package Identifier',
                 'required' => true,
-                'exampleValue' => 'org.fox.ttrss'
+                'exampleValue' => 'im.molly.app'
             ]
         ]
     ];

From b3ac1d176ce9f4778986190702216f0f25918a70 Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Fri, 5 Apr 2024 17:39:38 +0200
Subject: [PATCH 365/716] [FDroidRepoBridge] Simplify json retrieval (#4063)

* [FDroidRepoBridge] Simplify json retrieval

I looked into avoiding the writing-to-file and then reading-from-file altogether. Using a special file path that leaves the data in memory probably wouldn't work. But I'm unsure why we use the `index-v1.jar` file altogether.
The main F-Droid repo [lists](https://f-droid.org/en/docs/All_our_APIs/#the-repo-index) not only `index-v1.jar` (which only makes sense if we were to use the contained signature, which we don't), but also `index-v1.json` and `index-v2.json`. These json files can be fetched with `getContents`, optionally cached, and directly fed into `Json::decode` without using a temporary file. The HTTP transfer encoding can compress the file to a similar degree the jar (=zip) can. That's exactly what this commit uses.

Now the question is whether all the F-Droid repositories out there have this file. I went through the whole [list of known repositories](https://forum.f-droid.org/t/known-repositories/721) and only one repo misses the `index-v1.json` file: [Bromite](https://fdroid.bromite.org/fdroid/repo/index-v1.json). Under these circumstances we can depend on the availability of the `index-v1.json` file.

Closes #4062

* [FDroidRepoBridge] Cleanup not requiring Zip

With the last commit 1152386678151aeafd984061d34248023378bf64, the zip
extension is not required anymore. Don't fail if it's not available.
---
 bridges/FDroidRepoBridge.php | 31 +------------------------------
 1 file changed, 1 insertion(+), 30 deletions(-)

diff --git a/bridges/FDroidRepoBridge.php b/bridges/FDroidRepoBridge.php
index b3fd146e..844f6abb 100644
--- a/bridges/FDroidRepoBridge.php
+++ b/bridges/FDroidRepoBridge.php
@@ -45,10 +45,6 @@ class FDroidRepoBridge extends BridgeAbstract
 
     public function collectData()
     {
-        if (!extension_loaded('zip')) {
-            throw new \Exception('FDroidRepoBridge requires the php-zip extension');
-        }
-
         $this->repo = $this->fetchData();
         switch ($this->queriedContext) {
             case 'Latest Updates':
@@ -62,36 +58,11 @@ class FDroidRepoBridge extends BridgeAbstract
         }
     }
 
-    /**
-     * This method fetches data from arbitrary url and writes to os temp file.
-     * I don't think there's any security problem here but might be DOS problems.
-     */
     private function fetchData()
     {
         $url = $this->getURI();
-
-        $zipFile = getContents($url . '/index-v1.jar');
-        // On linux this creates a temp file in /tmp/
-        $temporaryFile = tempnam(sys_get_temp_dir(), 'rssbridge_');
-        file_put_contents($temporaryFile, $zipFile);
-
-        $archive = new \ZipArchive();
-        if ($archive->open($temporaryFile) !== true) {
-            unlink($temporaryFile);
-            throw new \Exception('Failed to extract archive');
-        }
-
-        $fp = $archive->getStream('index-v1.json');
-        if (!$fp) {
-            unlink($temporaryFile);
-            throw new \Exception('Failed to get file pointer');
-        }
-
-        $json = stream_get_contents($fp);
-        fclose($fp);
+        $json = getContents($url . '/index-v1.json');
         $data = Json::decode($json);
-        $archive->close();
-        unlink($temporaryFile);
         return $data;
     }
 

From 4602f4f475d938202de6c65214b321d41d0a93e8 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 6 Apr 2024 18:07:45 +0200
Subject: [PATCH 366/716] tweaks (#4065)

---
 bridges/FilterBridge.php |  2 +-
 bridges/TrelloBridge.php | 34 ++++++++++------------------------
 bridges/TwitchBridge.php |  2 +-
 formats/HtmlFormat.php   |  2 +-
 lib/BridgeAbstract.php   |  9 +++++++++
 lib/contents.php         |  2 ++
 6 files changed, 24 insertions(+), 27 deletions(-)

diff --git a/bridges/FilterBridge.php b/bridges/FilterBridge.php
index 1add47f4..3448a8c7 100644
--- a/bridges/FilterBridge.php
+++ b/bridges/FilterBridge.php
@@ -77,7 +77,7 @@ class FilterBridge extends FeedExpander
     {
         $url = $this->getInput('url');
         if (!Url::validate($url)) {
-            returnClientError('The url parameter must either refer to http or https protocol.');
+            throw new \Exception('The url parameter must either refer to http or https protocol.');
         }
         $this->collectExpandableDatas($this->getURI());
     }
diff --git a/bridges/TrelloBridge.php b/bridges/TrelloBridge.php
index cab2bde2..42651fd1 100644
--- a/bridges/TrelloBridge.php
+++ b/bridges/TrelloBridge.php
@@ -553,10 +553,8 @@ class TrelloBridge extends BridgeAbstract
 
     private function queryAPI($path, $params = [])
     {
-        $data = json_decode(getContents('https://trello.com/1/'
-            . $path
-            . '?'
-            . http_build_query($params)));
+        $url = 'https://trello.com/1/' . $path . '?' . http_build_query($params);
+        $data = json_decode(getContents($url));
         return $data;
     }
 
@@ -576,33 +574,21 @@ class TrelloBridge extends BridgeAbstract
                 && !$textOnly
                 && isset($entity->originalUrl)
             ) {
-                $string = '<p><a href="'
-                    . $entity->originalUrl
-                    . '"><img src="'
-                    . $entity->previewUrl
-                    . '"></a></p>';
+                $string = sprintf(
+                    '<p><a href="%s"><img src="%s"></a></p>',
+                    $entity->originalUrl,
+                    $entity->previewUrl ?? ''
+                );
             } elseif ($type === 'card' && !$textOnly) {
-                $string = '<a href="https://trello.com/c/'
-                    . $entity->shortLink
-                    . '">'
-                    . $entity->text
-                    . '</a>';
+                $string = sprintf('<a href="https://trello.com/c/%s">%s</a>', $entity->shortLink, $entity->text);
             } elseif ($type === 'member' && !$textOnly) {
-                $string = '<a href="https://trello.com/'
-                    . $entity->username
-                    . '">'
-                    . $entity->text
-                    . '</a>';
+                $string = sprintf('<a href="https://trello.com/%s">%s</a>', $entity->username, $entity->text);
             } elseif ($type === 'date') {
                 $string = gmdate('M j, Y \a\t g:i A T', strtotime($entity->date));
             } elseif ($type === 'translatable') {
                 $string = self::ACTION_TEXTS[$entity->translationKey];
             } else {
-                if (isset($entity->text)) {
-                    $string = $entity->text;
-                } else {
-                    $string = '';
-                }
+                $string = $entity->text ?? '';
             }
             $strings['{' . $entity_name . '}'] = $string;
         }
diff --git a/bridges/TwitchBridge.php b/bridges/TwitchBridge.php
index 9e70944e..424cd6e3 100644
--- a/bridges/TwitchBridge.php
+++ b/bridges/TwitchBridge.php
@@ -99,7 +99,7 @@ EOD;
         $user = $data->user;
         if ($user->videos === null) {
             // twitch regularly does this for unknown reasons
-            $this->logger->info('Twitch returned empty set of videos', ['data' => $data]);
+            //$this->logger->info('Twitch returned empty set of videos', ['data' => $data]);
             return;
         }
 
diff --git a/formats/HtmlFormat.php b/formats/HtmlFormat.php
index 1e2f60e6..37ef3a93 100644
--- a/formats/HtmlFormat.php
+++ b/formats/HtmlFormat.php
@@ -6,7 +6,7 @@ class HtmlFormat extends FormatAbstract
 
     public function stringify()
     {
-        // This query string comes in already url decoded
+        // This query string is url encoded
         $queryString = $_SERVER['QUERY_STRING'];
 
         $feedArray = $this->getFeed();
diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index 1456e1c3..2467dec6 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -6,8 +6,17 @@ abstract class BridgeAbstract
     const URI = '';
     const DONATION_URI = '';
     const DESCRIPTION = 'No description provided';
+
+    /**
+     * Preferably a github username
+     */
     const MAINTAINER = 'No maintainer';
+
+    /**
+     * Cache TTL in seconds
+     */
     const CACHE_TIMEOUT = 3600;
+
     const CONFIGURATION = [];
     const PARAMETERS = [];
     const TEST_DETECT_PARAMETERS = [];
diff --git a/lib/contents.php b/lib/contents.php
index 43db8c03..ba6dd531 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -17,6 +17,8 @@ function getContents(
     $httpClient = RssBridge::getHttpClient();
     $cache = RssBridge::getCache();
 
+    // TODO: consider url validation at this point
+
     $httpHeadersNormalized = [];
     foreach ($httpHeaders as $httpHeader) {
         $parts = explode(':', $httpHeader);

From 7d6881732dababa6a3188128e40227421cd8c972 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Sun, 7 Apr 2024 17:02:36 -0400
Subject: [PATCH 367/716] [ScribbleHubBridge] Add list page feed creation
 (#4012)

* [ScribbleHubBridge] Add list page feed creation

* [ScribbleHubBridge] Add list title handling

* [ScribbleHubBridge] Don't include timestamp in List GUIDs

* [ScribbleHubBridge] Fix usage of dynamic property
---
 bridges/ScribbleHubBridge.php | 60 ++++++++++++++++++++++++++++++++++-
 1 file changed, 59 insertions(+), 1 deletion(-)

diff --git a/bridges/ScribbleHubBridge.php b/bridges/ScribbleHubBridge.php
index 0f7c7a6c..60add802 100644
--- a/bridges/ScribbleHubBridge.php
+++ b/bridges/ScribbleHubBridge.php
@@ -23,6 +23,14 @@ class ScribbleHubBridge extends FeedExpander
                 // Example: latest chapters from Uskweirs
                 'exampleValue' => '965299',
             ],
+        ],
+        'List' => [
+            'url' => [
+                'name' => 'url',
+                'required' => true,
+                // Example: latest stories with the 'Transgender' tag
+                'exampleValue' => 'https://www.scribblehub.com/series-finder/?sf=1&gi=6&tgi=1088&sort=dateadded',
+            ],
         ]
     ];
 
@@ -34,6 +42,10 @@ class ScribbleHubBridge extends FeedExpander
     public function collectData()
     {
         $url = 'https://rssscribblehub.com/rssfeed.php?type=';
+        if ($this->queriedContext === 'List') {
+            $this->collectList($this->getURI());
+            return;
+        }
         if ($this->queriedContext === 'Author') {
             $url = $url . 'author&uid=' . $this->getInput('uid');
         } else { //All and Series use the same source feed
@@ -42,6 +54,44 @@ class ScribbleHubBridge extends FeedExpander
         $this->collectExpandableDatas($url);
     }
 
+    protected $author = '';
+
+    private function collectList($url)
+    {
+        $html = getSimpleHTMLDOMCached($url);
+        foreach ($html->find('.search_main_box') as $element) {
+            $item = [];
+
+            $title = $element->find('.search_title a', 0);
+            $item['title'] = $title->plaintext;
+            $item['uri'] = $title->href;
+
+            $strdate = $element->find('[title="Last Updated"]', 0)->plaintext;
+            $item['timestamp'] = strtotime($strdate);
+            $item['uid'] = $item['uri'];
+
+            $details = getSimpleHTMLDOMCached($item['uri']);
+            $item['enclosures'][] = $details->find('.fic_image img', 0)->src;
+            $item['content'] = $details->find('.wi_fic_desc', 0);
+
+            foreach ($details->find('.fic_genre') as $tag) {
+                $item['categories'][] = $tag->plaintext;
+            }
+            foreach ($details->find('.stag') as $tag) {
+                $item['categories'][] = $tag->plaintext;
+            }
+
+            $read_url = $details->find('.read_buttons a', 0)->href;
+            $read_html = getSimpleHTMLDOMCached($read_url);
+            $item['content'] .= '<hr><h3>';
+            $item['content'] .= $read_html->find('.chapter-title', 0);
+            $item['content'] .= '</h3>';
+            $item['content'] .= $read_html->find('#chp_raw', 0);
+
+            $this->items[] = $item;
+        }
+    }
+
     protected function parseItem(array $item)
     {
         //For series, filter out other series from 'All' feed
@@ -102,12 +152,17 @@ class ScribbleHubBridge extends FeedExpander
                 } catch (HttpException $e) {
                     // 403 Forbidden, This means we got anti-bot response
                     if ($e->getCode() === 403) {
-                        return $item;
+                        return $name;
                     }
                     throw $e;
                 }
                 $title = html_entity_decode($page->find('.fic_title', 0)->plaintext);
                 break;
+            case 'List':
+                $page = getSimpleHTMLDOMCached($this->getURI());
+                $title = $page->find('head > title', 0)->plaintext;
+                $title = explode(' |', $title)[0];
+                break;
         }
         if (isset($title)) {
             $name .= " - $title";
@@ -125,6 +180,9 @@ class ScribbleHubBridge extends FeedExpander
             case 'Series':
                 $uri = self::URI . 'series/' . $this->getInput('sid') . '/a';
                 break;
+            case 'List':
+                $uri = $this->getInput('url');
+                break;
         }
         return $uri;
     }

From 815dc180ccd9298015a2e6c55aaf05a189259e6c Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Wed, 10 Apr 2024 17:30:56 +0200
Subject: [PATCH 368/716] [PicukiBridge] Fix image URL (#4068)

Image URL does not need to be faked anymore, as the content/type is now valid.
---
 bridges/PicukiBridge.php | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/bridges/PicukiBridge.php b/bridges/PicukiBridge.php
index f1d45e2a..5f1096b8 100644
--- a/bridges/PicukiBridge.php
+++ b/bridges/PicukiBridge.php
@@ -89,9 +89,6 @@ class PicukiBridge extends BridgeAbstract
             $imageUrlParts[count($imageUrlParts) - 1] = urlencode($imageUrlParts[count($imageUrlParts) - 1]);
             $imageUrl = implode('/', $imageUrlParts);
 
-            // add fake file extension for it to be recognized as image/jpeg instead of application/octet-stream
-            $imageUrl = $imageUrl . '#.jpg';
-
             $this->items[] = [
                 'uri'        => $url,
                 'author'     => $author,

From a73b66f4d63766e42e6c772fe5d096e11de2a753 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 10 Apr 2024 18:32:48 +0200
Subject: [PATCH 369/716] fix(ScientificAmericanBridge) (#4070)

---
 bridges/ScientificAmericanBridge.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/bridges/ScientificAmericanBridge.php b/bridges/ScientificAmericanBridge.php
index d575bf94..da52e0ad 100644
--- a/bridges/ScientificAmericanBridge.php
+++ b/bridges/ScientificAmericanBridge.php
@@ -66,7 +66,7 @@ class ScientificAmericanBridge extends FeedExpander
     private function collectIssues()
     {
         $html = getSimpleHTMLDOMCached(self::ISSUES);
-        $content = $html->getElementById('content')->children(3);
+        $content = $html->getElementById('app')->children(3);
         $issues = $content->children();
         $issues_count = min(
             (int)$this->getInput('parseIssues'),
@@ -125,6 +125,7 @@ class ScientificAmericanBridge extends FeedExpander
 
     private function updateItem($item)
     {
+        return $item;
         $html = getSimpleHTMLDOMCached($item['uri']);
         $article = $html->find('#sa_body', 0)->find('article', 0);
 

From 58c254ad3bd3f0c9a3e01dc8b4011996dffbaf75 Mon Sep 17 00:00:00 2001
From: Miika Launiainen <miika@miicat.eu>
Date: Thu, 11 Apr 2024 18:18:37 +0300
Subject: [PATCH 370/716] [YorushikaBridge] Add language selection parameter
 (#4073)

* Add language selection parameter

* Fix typo

* Fix lint errors
---
 bridges/YorushikaBridge.php | 50 ++++++++++++++++++++++++++++++++++---
 1 file changed, 46 insertions(+), 4 deletions(-)

diff --git a/bridges/YorushikaBridge.php b/bridges/YorushikaBridge.php
index 12d02f1f..d528999a 100644
--- a/bridges/YorushikaBridge.php
+++ b/bridges/YorushikaBridge.php
@@ -7,6 +7,20 @@ class YorushikaBridge extends BridgeAbstract
     const DESCRIPTION = 'Return news from Yorushika\'s offical website';
     const MAINTAINER = 'Miicat_47';
     const PARAMETERS = [
+        'global' => [
+            'lang' => [
+                'name' => 'Language',
+                'defaultValue' => 'jp',
+                'type' => 'list',
+                'values' => [
+                    '日本語' => 'jp',
+                    'English' => 'en',
+                    '한국어' => 'ko',
+                    '中文(繁體字)' => 'zh-tw',
+                    '中文(簡体字)' => 'zh-cn',
+                ]
+            ],
+        ],
         'All categories' => [
         ],
         'Only selected categories' => [
@@ -27,6 +41,28 @@ class YorushikaBridge extends BridgeAbstract
 
     public function collectData()
     {
+        $url = 'https://yorushika.com/news/5/';
+        switch ($this->getInput('lang')) {
+            case 'jp':
+                $url = 'https://yorushika.com/news/5/';
+                break;
+            case 'en':
+                $url = 'https://yorushika.com/news/5/?lang=en';
+                break;
+            case 'ko':
+                $url = 'https://yorushika.com/news/5/?lang=ko';
+                break;
+            case 'zh-tw':
+                $url = 'https://yorushika.com/news/5/?lang=zh-tw';
+                break;
+            case 'zh-cn':
+                $url = 'https://yorushika.com/news/5/?lang=zh-cn';
+                break;
+            default:
+                $url = 'https://yorushika.com/news/5/';
+                break;
+        }
+
         $categories = [];
         if ($this->queriedContext == 'All categories') {
             array_push($categories, 'all');
@@ -42,7 +78,7 @@ class YorushikaBridge extends BridgeAbstract
             }
         }
 
-        $html = getSimpleHTMLDOM('https://yorushika.com/news/5/')->find('.list--news', 0);
+        $html = getSimpleHTMLDOM($url)->find('.list--news', 0);
         $html = defaultLinkTo($html, $this->getURI());
 
         foreach ($html->find('.inview') as $art) {
@@ -62,10 +98,16 @@ class YorushikaBridge extends BridgeAbstract
             $url = $art->find('a.clearfix', 0)->href;
 
             // Get article date
-            $exp_date = '/\d+\.\d+\.\d+/';
             $date = $art->find('.date', 0)->plaintext;
-            preg_match($exp_date, $date, $matches);
-            $date = date_create_from_format('Y.m.d', $matches[0]);
+            if (preg_match('/(\d)年(\d)月(\d)/', $date, $matches)) {
+                // Some dates will contain Chinese characters, remove those from the string
+                $formattedDate = sprintf('%d.%02d.%02d', $matches[1], $matches[2], $matches[3]);
+            } else {
+                // Assume the date is already in 'Y.m.d' format
+                preg_match('/\d+\.\d+\.\d+/', $date, $matches);
+                $formattedDate = $matches[0];
+            }
+            $date = date_create_from_format('Y.m.d', $formattedDate);
             $date = date_format($date, 'd.m.Y');
 
             // Get article info

From 428c6c3c66b0f2730a8eb899d7a5768cdd279777 Mon Sep 17 00:00:00 2001
From: Korytov Pavel <thexcloud@gmail.com>
Date: Fri, 12 Apr 2024 02:57:55 +0300
Subject: [PATCH 371/716] [ScientificAmericanBridge] Update bridge (#4074)

* [ScientificAmericanBridge] Update bridge

* [ScientificAmericanBridge] Fix lint
---
 bridges/ScientificAmericanBridge.php | 131 ++++++++++++---------------
 1 file changed, 60 insertions(+), 71 deletions(-)

diff --git a/bridges/ScientificAmericanBridge.php b/bridges/ScientificAmericanBridge.php
index da52e0ad..51cdc0d9 100644
--- a/bridges/ScientificAmericanBridge.php
+++ b/bridges/ScientificAmericanBridge.php
@@ -25,7 +25,7 @@ class ScientificAmericanBridge extends FeedExpander
     ];
 
     const FEED = 'http://rss.sciam.com/ScientificAmerican-Global';
-    const ISSUES = 'https://www.scientificamerican.com/archive/issues/2020s/';
+    const ISSUES = 'https://www.scientificamerican.com/archive/issues/';
 
     public function collectData()
     {
@@ -50,7 +50,7 @@ class ScientificAmericanBridge extends FeedExpander
 
         if ($this->getInput('addContents') == 1) {
             usort($this->items, function ($item1, $item2) {
-                return $item1['timestamp'] - $item2['timestamp'];
+                return $item2['timestamp'] - $item1['timestamp'];
             });
         }
     }
@@ -66,8 +66,12 @@ class ScientificAmericanBridge extends FeedExpander
     private function collectIssues()
     {
         $html = getSimpleHTMLDOMCached(self::ISSUES);
-        $content = $html->getElementById('app')->children(3);
-        $issues = $content->children();
+        $content = $html->getElementById('app');
+        $issues_list = $content->find('div[class^="issue__list"]', 0);
+        if ($issues_list == null) {
+            return [];
+        }
+        $issues = $issues_list->find('div[class^="list__item"]');
         $issues_count = min(
             (int)$this->getInput('parseIssues'),
             count($issues)
@@ -87,36 +91,19 @@ class ScientificAmericanBridge extends FeedExpander
         $items = [];
         $html = getSimpleHTMLDOMCached($issue_link);
 
-        $features = $html->find('[class^=Detail_issue__article__previews__featured]', 0);
-        if ($features != null) {
-            $articles = $features->find('div', 0)->children();
+        $blocks = $html->find('[class^="issueArchiveArticleListCompact"]');
+        foreach ($blocks as $block) {
+            $articles = $block->find('article[class*="article"]');
             foreach ($articles as $article) {
-                $h4 = $article->find('h4', 0);
-                $a = $h4->find('a', 0);
+                $a = $article->find('a[class^="articleLink"]', 0);
                 $link = 'https://scientificamerican.com' . $a->getAttribute('href');
-                $title = $a->plaintext;
-                $items[] = [
+                $title = $a->find('h2[class^="articleTitle"]', 0);
+                array_push($items, [
                     'uri' => $link,
-                    'title' => $title,
+                    'title' => $title->plaintext,
                     'uid' => $link,
                     'content' => ''
-                ];
-            }
-        }
-
-        $departments = $html->find('[class^=Detail_issue__article__previews__departments]', 0);
-        if ($departments != null) {
-            $headers = $departments->find('[class*=Listing_article__listing__title]');
-            foreach ($headers as $header) {
-                $a = $header->find('a', 0);
-                $link = 'https://scientificamerican.com' . $a->getAttribute('href');
-                $title = $a->plaintext;
-                $items[] = [
-                    'uri' => $link,
-                    'title' => $title,
-                    'uid' => $link,
-                    'content' => ''
-                ];
+                ]);
             }
         }
 
@@ -125,65 +112,67 @@ class ScientificAmericanBridge extends FeedExpander
 
     private function updateItem($item)
     {
-        return $item;
         $html = getSimpleHTMLDOMCached($item['uri']);
-        $article = $html->find('#sa_body', 0)->find('article', 0);
+        $article = $html->find('#app', 0)->find('article', 0);
 
-        $time = $article->find('time[itemprop="datePublished"]', 0);
-        if ($time == null) {
-            $time = $html->find('span[itemprop="datePublished"]', 0);
-        }
+        $time = $article->find('p[class^="article_pub_date"]', 0);
         if ($time) {
             $datetime = DateTime::createFromFormat('F j, Y', $time->plaintext);
+            $datetime->setTime(0, 0, 0, 0);
             $item['timestamp'] = $datetime->format('U');
         }
-        $main = $article->find('section.article-grid__main', 0);
 
-        if ($main == null) {
-            $main = $article->find('div.article-text', 0);
+        $authors = $article->find('a[class^="article_authors__link"]');
+        if ($authors) {
+            $author = implode('; ', array_map(fn($a) => $a->plaintext, $authors));
+            $item['author'] = $author;
         }
 
-        if ($main == null) {
-            return $item;
+        $res = '';
+        $desc = $article->find('div[class^="article_dek"]', 0);
+        if ($desc) {
+            $res .= $desc->innertext;
         }
 
-        foreach ($main->find('img') as $img) {
-            $img->removeAttribute('width');
-            $img->removeAttribute('height');
-            $img->setAttribute('style', 'height: auto; width: auto; max-height: 768px');
+        $lead_figure = $article->find('figure[class^="lead_image"]', 0);
+        if ($lead_figure) {
+            $res .= $lead_figure->outertext;
         }
 
-        $rights_link = $main->find('div.article-rightslink', 0);
-        if ($rights_link != null) {
-            $rights_link->parent->removeChild($rights_link);
-        }
-        $reprints_link = $main->find('div.article-reprintsLink', 0);
-        if ($reprints_link != null) {
-            $reprints_link->parent->removeChild($reprints_link);
-        }
-        $about_section = $main->find('section.article-author-container', 0);
-        if ($about_section != null) {
-            $about_section->parent->removeChild($about_section);
-        }
-        $read_next = $main->find('#read-next', 0);
-        if ($read_next != null) {
-            $read_next->parent->removeChild($read_next);
+        $content = $article->find('div[class^="article__content"]', 0);
+        if ($content) {
+            foreach ($content->children() as $block) {
+                if (str_contains($block->innertext, 'On supporting science journalism')) {
+                    continue;
+                }
+                if (
+                    ($block->tag == 'p' && $block->getAttribute('data-block') == 'sciam/paragraph')
+                    || ($block->tag == 'figure' && str_starts_with($block->class, 'article__image'))
+                ) {
+                    $iframe = $block->find('iframe', 0);
+                    if ($iframe) {
+                        $res .= "<a href=\"{$iframe->src}\">{$iframe->src}</a>";
+                    } else {
+                        $res .= $block->outertext;
+                    }
+                } else if ($block->tag == 'h2') {
+                    $res .= '<h3>' . $block->innertext . '</h3>';
+                } else if ($block->tag == 'blockquote') {
+                    $res .= $block->outertext;
+                } else if ($block->tag == 'hr' && $block->getAttribute('data-block') == 'sciam/raw_html') {
+                    $res .= '<hr />';
+                }
+            }
         }
 
-        foreach ($main->find('iframe') as $iframe) {
-            $a = $html->createElement('a');
-            $a->href = $iframe->src;
-            $a->innertext = $iframe->src;
-            $iframe->parent->appendChild($a);
-            $iframe->parent->removeChild($iframe);
+        $footer = $article->find('footer[class*="footer"]', 0);
+        if ($footer) {
+            $bios = $footer->find('div[class^=bio]');
+            $bio = implode('', array_map(fn($b) => $b->innertext, $bios));
+            $res .= $bio;
         }
 
-        $authors = $main->find('span[itemprop="author"]', 0);
-        if ($authors != null) {
-            $item['author'] = $authors->plaintext;
-        }
-
-        $item['content'] = $main->innertext;
+        $item['content'] = $res;
         return $item;
     }
 }

From 89013faf7dc019db5ef42efb7021c7a517858bfd Mon Sep 17 00:00:00 2001
From: Arya K <arya@projectsegfau.lt>
Date: Sat, 13 Apr 2024 19:29:25 +0530
Subject: [PATCH 372/716] Add Project Segfault Instance (#4076)

---
 docs/01_General/06_Public_Hosts.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/01_General/06_Public_Hosts.md b/docs/01_General/06_Public_Hosts.md
index 1d59d918..1bc8fc20 100644
--- a/docs/01_General/06_Public_Hosts.md
+++ b/docs/01_General/06_Public_Hosts.md
@@ -24,6 +24,7 @@
 | ![](https://iplookup.flagfox.net/images/h16/PL.png) | https://rss.m3wz.su| ![](https://img.shields.io/badge/website-up-brightgreen) | [@m3oweezed](https://m3wz.su/en/about) | Poland, Hosted with Timeweb Cloud |
 | ![](https://iplookup.flagfox.net/images/h16/DE.png) | https://rb.ash.fail | ![](https://img.shields.io/website/https/rb.ash.fail.svg) | [@ash](https://ash.fail/contact.html) | Hosted with Hostaris, Germany
 | ![](https://iplookup.flagfox.net/images/h16/UA.png) | https://rss.noleron.com | ![](https://img.shields.io/website/https/rss.noleron.com) | [@ihor](https://noleron.com/about) | Hosted with Hosting Ukraine, Ukraine
+| ![](https://iplookup.flagfox.net/images/h16/IN.png) | https://rssbridge.projectsegfau.lt | ![](https://img.shields.io/website/https/rssbridge.projectsegfau.lt) | [@gi-yt](https://aryak.me) | Self-Hosted at Mumbai, India with Airtel (ISP) |
 
 
 ## Inactive instances

From b4d397ff7064298f4ffb9afe74fa27b34d26d3c8 Mon Sep 17 00:00:00 2001
From: Miika Launiainen <miika@miicat.eu>
Date: Sun, 14 Apr 2024 20:13:31 +0300
Subject: [PATCH 373/716] [YorushikaBridge] Fix getting date (#4077)

* Remove unnecessary variable

* Fix getting date
---
 bridges/YorushikaBridge.php | 11 ++---------
 1 file changed, 2 insertions(+), 9 deletions(-)

diff --git a/bridges/YorushikaBridge.php b/bridges/YorushikaBridge.php
index d528999a..d75b97d7 100644
--- a/bridges/YorushikaBridge.php
+++ b/bridges/YorushikaBridge.php
@@ -41,7 +41,6 @@ class YorushikaBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $url = 'https://yorushika.com/news/5/';
         switch ($this->getInput('lang')) {
             case 'jp':
                 $url = 'https://yorushika.com/news/5/';
@@ -99,14 +98,8 @@ class YorushikaBridge extends BridgeAbstract
 
             // Get article date
             $date = $art->find('.date', 0)->plaintext;
-            if (preg_match('/(\d)年(\d)月(\d)/', $date, $matches)) {
-                // Some dates will contain Chinese characters, remove those from the string
-                $formattedDate = sprintf('%d.%02d.%02d', $matches[1], $matches[2], $matches[3]);
-            } else {
-                // Assume the date is already in 'Y.m.d' format
-                preg_match('/\d+\.\d+\.\d+/', $date, $matches);
-                $formattedDate = $matches[0];
-            }
+            preg_match('/(\d+)[\.年](\d+)[\.月](\d+)/u', $date, $matches);
+            $formattedDate = sprintf('%d.%02d.%02d', $matches[1], $matches[2], $matches[3]);
             $date = date_create_from_format('Y.m.d', $formattedDate);
             $date = date_format($date, 'd.m.Y');
 

From 957a820931dc45e9aadd996751cfb7321f4ba47e Mon Sep 17 00:00:00 2001
From: llamasblade <69692580+llamasblade@users.noreply.github.com>
Date: Sun, 14 Apr 2024 17:14:52 +0000
Subject: [PATCH 374/716] [YandexZenBridge] Fix broken bridge for some channels
 (#4078)

Fixes #4071.

Major changes:
- the bridge's URI changed from zen.yandex.com to dzen.ru, as the former
  redirects to the latter (perhaps the bridge's name should be changed
  as well);
- the channel's URL is now required instead of the channel's username;
- two kinds of URLs are supported, one for channels with usernames and
  one for channels with IDs in their URL;
- the channel's real name, as shown in the webpage, is now used as the
  feed title.
---
 bridges/YandexZenBridge.php | 59 ++++++++++++++++++++++++++-----------
 1 file changed, 42 insertions(+), 17 deletions(-)

diff --git a/bridges/YandexZenBridge.php b/bridges/YandexZenBridge.php
index 8a3db48b..57242328 100644
--- a/bridges/YandexZenBridge.php
+++ b/bridges/YandexZenBridge.php
@@ -3,17 +3,17 @@
 class YandexZenBridge extends BridgeAbstract
 {
     const NAME = 'YandexZen Bridge';
-    const URI = 'https://zen.yandex.com';
-    const DESCRIPTION = 'Latest posts from the specified profile.';
+    const URI = 'https://dzen.ru';
+    const DESCRIPTION = 'Latest posts from the specified channel.';
     const MAINTAINER = 'llamasblade';
     const PARAMETERS = [
         [
-            'username' => [
-                'name' => 'Username',
+            'channelURL' => [
+                'name' => 'Channel URL',
                 'type' => 'text',
                 'required' => true,
-                'title' => 'The account\'s username, found in its URL',
-                'exampleValue' => 'dream_faity_diy',
+                'title' => 'The channel\'s URL',
+                'exampleValue' => 'https://dzen.ru/dream_faity_diy',
             ],
             'limit' => [
                 'name' => 'Limit',
@@ -27,14 +27,41 @@ class YandexZenBridge extends BridgeAbstract
     ];
 
     # credit: https://github.com/teromene see #1032
-    const _API_URL = 'https://zen.yandex.ru/api/v3/launcher/more?channel_name=';
+    const _BASE_API_URL_WITH_CHANNEL_NAME = 'https://dzen.ru/api/v3/launcher/more?channel_name=';
+    const _BASE_API_URL_WITH_CHANNEL_ID = 'https://dzen.ru/api/v3/launcher/more?channel_id=';
+
+    const _ACCOUNT_URL_WITH_CHANNEL_ID_REGEX = '#^https?://dzen\.ru/id/(?<channelID>[a-z0-9]{24})#';
+    const _ACCOUNT_URL_WITH_CHANNEL_NAME_REGEX = '#^https?://dzen\.ru/(?<channelName>[\w\.]+)#';
+
+    private $channelRealName = null;  # as shown in the webpage, not in the URL
+
 
     public function collectData()
     {
-        $profile_json = json_decode(getContents($this->getAPIUrl()));
+        $channelURL = $this->getInput('channelURL');
+
+        if (preg_match(self::_ACCOUNT_URL_WITH_CHANNEL_ID_REGEX, $channelURL, $matches)) {
+            $channelID = $matches['channelID'];
+            $channelAPIURL = self::_BASE_API_URL_WITH_CHANNEL_ID . $channelID;
+        } elseif (preg_match(self::_ACCOUNT_URL_WITH_CHANNEL_NAME_REGEX, $channelURL, $matches)) {
+            $channelName = $matches['channelName'];
+            $channelAPIURL = self::_BASE_API_URL_WITH_CHANNEL_NAME . $channelName;
+        } else {
+            returnClientError(<<<EOT
+Invalid channel URL provided.
+The channel\'s URL must be in one of these two forms:
+- https://dzen.ru/dream_faity_diy
+- https://dzen.ru/id/5ad7777f1aa80ce576015250
+EOT);
+        }
+
+        $APIResponse = json_decode(getContents($channelAPIURL));
+
+        $this->channelRealName = $APIResponse->header->title;
+
         $limit = $this->getInput('limit');
 
-        foreach (array_slice($profile_json->items, 0, $limit) as $post) {
+        foreach (array_slice($APIResponse->items, 0, $limit) as $post) {
             $item = [];
 
             $item['uri'] = $post->share_link;
@@ -56,21 +83,19 @@ class YandexZenBridge extends BridgeAbstract
         }
     }
 
-    private function getAPIUrl()
-    {
-        return self::_API_URL . $this->getInput('username');
-    }
-
     public function getURI()
     {
-        return self::URI . '/' . $this->getInput('username');
+        if (is_null($this->getInput('channelURL'))) {
+            return parent::getURI();
+        }
+        return $this->getInput('channelURL');
     }
 
     public function getName()
     {
-        if (is_null($this->getInput('username'))) {
+        if (is_null($this->channelRealName)) {
             return parent::getName();
         }
-        return $this->getInput('username') . '\'s latest zen.yandex posts';
+        return $this->channelRealName . '\'s latest zen.yandex posts';
     }
 }

From 97f5dafbc5e2ff9dadbe8a76cb7e07818da566e8 Mon Sep 17 00:00:00 2001
From: llamasblade <69692580+llamasblade@users.noreply.github.com>
Date: Tue, 16 Apr 2024 15:58:05 +0000
Subject: [PATCH 375/716] [HytaleBridge] Fix bridge not pulling all blog posts
 (#4079)

---
 bridges/HytaleBridge.php | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/bridges/HytaleBridge.php b/bridges/HytaleBridge.php
index 7ca11af6..01fc0f38 100644
--- a/bridges/HytaleBridge.php
+++ b/bridges/HytaleBridge.php
@@ -18,26 +18,27 @@ class HytaleBridge extends BridgeAbstract
         $blogPosts = json_decode(getContents(self::_API_URL_PUBLISHED));
         $length = count($blogPosts);
 
-        for ($i = 1; $i < $length; $i += 3) {
+        for ($i = 0; $i < $length; $i += 3) {
             $slug = $blogPosts[$i]->slug;
 
             $blogPost = json_decode(getContents(self::_API_URL_BLOG_POST . $slug));
 
-            if (property_exists($blogPost, 'previous')) {
-                $this->addBlogPost($blogPost->previous);
+            if (property_exists($blogPost, 'next')) {
+                $this->addBlogPost($blogPost->next);
             }
 
             $this->addBlogPost($blogPost);
 
-            if (property_exists($blogPost, 'next')) {
-                $this->addBlogPost($blogPost->next);
+            if (property_exists($blogPost, 'previous')) {
+                $this->addBlogPost($blogPost->previous);
             }
         }
 
-        if ($length % 3 == 1) {
-            $slug = $blogPosts[count($blogPosts) - 1]->slug;
+        if (($length >= 3) && ($length % 3 == 0)) {
+            $slug = $blogPosts[$length - 1]->slug;
 
             $blogPost = json_decode(getContents(self::_API_URL_BLOG_POST . $slug));
+
             $this->addBlogPost($blogPost);
         }
     }

From 8c3e973b9f508f3ea928a720a616d4d95d71d22b Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Thu, 18 Apr 2024 01:43:53 +0200
Subject: [PATCH 376/716] [PepperBridgeAbstract] Fix the "no result" detection
 (#4082)

The "no result" test did not work, it is fixed now.
---
 bridges/PepperBridgeAbstract.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index 33d427bc..6e41cf20 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -55,8 +55,8 @@ class PepperBridgeAbstract extends BridgeAbstract
         );
 
         // If there is no results, we don't parse the content because it display some random deals
-        $noresult = $html->find('section[class=subNav]', 0)->find('div[class*=page-center listLayout aGrid]', 0);
-        if ($noresult === null) {
+        $noresult = $html->find('div[id=content-list]', 0)->find('h2', 0);
+        if ($noresult !== null) {
             $this->items = [];
         } else {
             foreach ($list as $deal) {

From 1f71d76ac1e93ef403098eec3c7a864fe8748ee6 Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Thu, 18 Apr 2024 13:18:45 +0200
Subject: [PATCH 377/716] [HeiseBridge] Remove additional ad banners

For example
https://www.heise.de/meinung/Kommentar-Microsofts-Sicherheitspraxis-wird-zur-Gefahr-und-das-BSI-schweigt-9686629.html
has two inline banners for a heise offering, not directly related to the
article. Removing all "inline" figures, which seems to catch all inline
unwanted elements, while avoiding removing useful figures/images.
---
 bridges/HeiseBridge.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/bridges/HeiseBridge.php b/bridges/HeiseBridge.php
index ab40e6d9..a78b4609 100644
--- a/bridges/HeiseBridge.php
+++ b/bridges/HeiseBridge.php
@@ -160,7 +160,10 @@ class HeiseBridge extends FeedExpander
         $article = defaultLinkTo($article, $item['uri']);
 
         // remove unwanted stuff
-        foreach ($article->find('figure.branding, a-ad, div.ho-text, a-img, .a-toc__list, a-collapse, .opt-in__description, .opt-in__footnote') as $element) {
+        foreach (
+            $article->find('figure.branding, figure.a-inline-image, a-ad, div.ho-text, a-img,
+            .a-toc__list, a-collapse, .opt-in__description, .opt-in__footnote') as $element
+        ) {
             $element->remove();
         }
         // reload html, as remove() is buggy

From 154b8b9cdb6ad7f125753c5e0964871c1730e8f8 Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Fri, 19 Apr 2024 19:08:58 +0200
Subject: [PATCH 378/716] Create TarnkappeBridge.php (#4085)

* Create TarnkappeBridge.php

* Update TarnkappeBridge.php
---
 bridges/TarnkappeBridge.php | 79 +++++++++++++++++++++++++++++++++++++
 1 file changed, 79 insertions(+)
 create mode 100644 bridges/TarnkappeBridge.php

diff --git a/bridges/TarnkappeBridge.php b/bridges/TarnkappeBridge.php
new file mode 100644
index 00000000..c04c9546
--- /dev/null
+++ b/bridges/TarnkappeBridge.php
@@ -0,0 +1,79 @@
+<?php
+
+class TarnkappeBridge extends FeedExpander
+{
+    const MAINTAINER = 'Tone866';
+    const NAME = 'tarnkappe Bridge';
+    const URI = 'https://tarnkappe.info/';
+    const CACHE_TIMEOUT = 1800; // 30min
+    const DESCRIPTION = 'Returns the full articles instead of only the intro';
+    const PARAMETERS = [[
+        'category' => [
+            'name' => 'Category',
+            'required' => false,
+            'title' => <<<'TITLE'
+                If you only want to subscribe to a specific category
+                you can enter it here.
+                If not, leave it blank to subscribe to everything.
+                TITLE,
+        ],
+        'limit' => [
+            'name' => 'Limit',
+            'type' => 'number',
+            'required' => false,
+            'title' => 'Specify number of full articles to return',
+            'defaultValue' => 10
+        ]
+    ]];
+    const LIMIT = 10;
+
+    public function collectData()
+    {
+        if (empty($this->getInput('category'))) {
+            $category = 'https://tarnkappe.info/feed';
+        } else {
+            $category = 'https://tarnkappe.info/artikel/' . $this->getInput('category') . '/feed';
+        }
+
+        $this->collectExpandableDatas(
+            $category,
+            $this->getInput('limit') ?: static::LIMIT
+        );
+    }
+
+    protected function parseItem(array $item)
+    {
+        if (strpos($item['uri'], 'https://tarnkappe.info/') !== 0) {
+            return $item;
+        }
+
+        $article = getSimpleHTMLDOMCached($item['uri']);
+
+        if ($article) {
+            $article = defaultLinkTo($article, $item['uri']);
+            $item = $this->addArticleToItem($item, $article);
+        }
+
+        return $item;
+    }
+
+    private function addArticleToItem($item, $article)
+    {
+        $item['content'] = $article->find('a.image-header', 0);
+
+        $article = $article->find('main#article article div.card-content div.content.entry-content', 0);
+
+        // remove unwanted stuff
+        foreach (
+            $article->find('em, section, div.menu') as $element
+        ) {
+            $element->remove();
+        }
+        // reload html, as remove() is buggy
+        $article = str_get_html($article->outertext);
+
+        $item['content'] .= $article;
+
+        return $item;
+    }
+}

From d31f20758cb9c3a0841c4cf1c2c283b4cfc29077 Mon Sep 17 00:00:00 2001
From: Thomas <mightymt@users.noreply.github.com>
Date: Fri, 26 Apr 2024 18:47:06 +0200
Subject: [PATCH 379/716] [YouTubeCommunityTabBridge] Improve building of
 content & title (#4089)

* [YouTubeCommunityTabBridge] Improve building of content & title

Fixes truncated link hrefs in content and adds some general
improvements regarding the building of item content and item title

* [YouTubeCommunityTabBridge] Fix PHP deprecation warnings

Fixes the following deprecation warnings:

substr(): Passing null to parameter #1 ($string) of type string is
deprecated
---
 bridges/YouTubeCommunityTabBridge.php | 37 ++++++++++++++++++++++-----
 1 file changed, 30 insertions(+), 7 deletions(-)

diff --git a/bridges/YouTubeCommunityTabBridge.php b/bridges/YouTubeCommunityTabBridge.php
index 20822828..74200b17 100644
--- a/bridges/YouTubeCommunityTabBridge.php
+++ b/bridges/YouTubeCommunityTabBridge.php
@@ -204,7 +204,15 @@ class YouTubeCommunityTabBridge extends BridgeAbstract
         $text = '';
 
         foreach ($runs as $part) {
-            $text .= $this->formatUrls($part->text);
+            if (isset($part->navigationEndpoint->browseEndpoint->canonicalBaseUrl)) {
+                $text .= $this->formatUrls($part->text, $part->navigationEndpoint->browseEndpoint->canonicalBaseUrl);
+            } elseif (isset($part->navigationEndpoint->urlEndpoint->url)) {
+                $text .= $this->formatUrls($part->text, $part->navigationEndpoint->urlEndpoint->url);
+            } elseif (isset($part->navigationEndpoint->commandMetadata->webCommandMetadata->url)) {
+                $text .= $this->formatUrls($part->text, $part->navigationEndpoint->commandMetadata->webCommandMetadata->url);
+            } else {
+                $text .= $this->formatUrls($part->text, null);
+            }
         }
 
         return nl2br($text);
@@ -275,6 +283,7 @@ EOD;
     {
         $length = 100;
 
+        $text = strip_tags($text);
         if (strlen($text) > $length) {
             $text = explode('<br>', wordwrap($text, $length, '<br>'));
             return $text[0] . '...';
@@ -283,12 +292,26 @@ EOD;
         return $text;
     }
 
-    private function formatUrls($content)
+    private function formatUrls($content, $url)
     {
-        return preg_replace(
-            '/(http[s]{0,1}\:\/\/[a-zA-Z0-9.\/\?\&=\-_]{4,})/ims',
-            '<a target="_blank" href="$1" target="_blank">$1</a> ',
-            $content
-        );
+        if (substr(strval($url), 0, 1) == '/') {
+            // fix relative URL
+            $url = 'https://www.youtube.com' . $url;
+        } elseif (substr(strval($url), 0, 33) == 'https://www.youtube.com/redirect?') {
+            // extract actual URL from YouTube redirect
+            parse_str(substr($url, 33), $params);
+            if (strpos(($params['q'] ?? ''), rtrim($content, '.')) === 0) {
+                $url = $params['q'];
+            }
+        }
+
+        // ensure all URLs are made clickable
+        $url = $url ?? $content;
+
+        if (filter_var($url, FILTER_VALIDATE_URL)) {
+            return '<a href="' . $url . '" target="_blank">' . $content . '</a>';
+        }
+
+        return $content;
     }
 }

From f3ca567159386f32ef26c424b14d9b6e2acf126a Mon Sep 17 00:00:00 2001
From: Korytov Pavel <thexcloud@gmail.com>
Date: Sat, 27 Apr 2024 11:35:59 +0300
Subject: [PATCH 380/716] [TldrTechBridge] Fix and improve bridge (#4090)

---
 bridges/TldrTechBridge.php | 29 +++++++++++++++++++----------
 1 file changed, 19 insertions(+), 10 deletions(-)

diff --git a/bridges/TldrTechBridge.php b/bridges/TldrTechBridge.php
index 984117b2..d2955347 100644
--- a/bridges/TldrTechBridge.php
+++ b/bridges/TldrTechBridge.php
@@ -22,11 +22,15 @@ class TldrTechBridge extends BridgeAbstract
                 'type' => 'list',
                 'values' => [
                     'Tech' => 'tech',
-                    'Crypto' => 'crypto',
+                    'Web Dev' => 'webdev',
                     'AI' => 'ai',
-                    'Web Dev' => 'engineering',
+                    'Information Security' => 'infosec',
+                    'Product Management' => 'product',
+                    'DevOps' => 'devops',
+                    'Crypto' => 'crypto',
+                    'Design' => 'design',
+                    'Marketing' => 'marketing',
                     'Founders' => 'founders',
-                    'Cybersecurity' => 'cybersecurity'
                 ],
                 'defaultValue' => 'tech'
             ]
@@ -48,12 +52,17 @@ class TldrTechBridge extends BridgeAbstract
             // Convert /<topic>/2023-01-01 to unix timestamp
             $date_items = explode('/', $child->href);
             $date = strtotime(end($date_items));
-            $this->items[] = [
-                'uri'       => self::URI . $child->href,
-                'title'     => $child->plaintext,
-                'timestamp' => $date,
-                'content'   => $this->extractContent(self::URI . $child->href),
-            ];
+            $item_url = self::URI . ltrim($child->href, '/');
+            try {
+                $this->items[] = [
+                    'uri'       => self::URI . $child->href,
+                    'title'     => $child->plaintext,
+                    'timestamp' => $date,
+                    'content'   => $this->extractContent($item_url),
+                ];
+            } catch (HttpException $e) {
+                continue;
+            }
             $added++;
             if ($added >= $limit) {
                 break;
@@ -66,7 +75,7 @@ class TldrTechBridge extends BridgeAbstract
         $html = getSimpleHTMLDOM($url);
         $content = $html->find('div.content-center.mt-5', 0);
         if (!$content) {
-            return '';
+            throw new HttpException('Could not find content', 500);
         }
         $subscribe_form = $content->find('div.mt-5 > div > form', 0);
         if ($subscribe_form) {

From d15960f955be91c8fa236d96186fcb0524572859 Mon Sep 17 00:00:00 2001
From: Thomas <mightymt@users.noreply.github.com>
Date: Thu, 2 May 2024 19:45:04 +0200
Subject: [PATCH 381/716] [YouTubeCommunityTabBridge] Multi-image attachment
 support (#4091)

Adds support for multi-image attachments.
Also changes individual if-statments in "getAttachments" to if/elseif
as each post can apparently only have one attachment anyway.
---
 bridges/YouTubeCommunityTabBridge.php | 31 +++++++++++++++++++--------
 1 file changed, 22 insertions(+), 9 deletions(-)

diff --git a/bridges/YouTubeCommunityTabBridge.php b/bridges/YouTubeCommunityTabBridge.php
index 74200b17..0c145c02 100644
--- a/bridges/YouTubeCommunityTabBridge.php
+++ b/bridges/YouTubeCommunityTabBridge.php
@@ -228,8 +228,8 @@ class YouTubeCommunityTabBridge extends BridgeAbstract
         if (isset($details->backstageAttachment)) {
             $attachments = $details->backstageAttachment;
 
-            // Video
             if (isset($attachments->videoRenderer) && isset($attachments->videoRenderer->videoId)) {
+                // Video
                 if (empty($this->itemTitle)) {
                     $this->itemTitle = $this->feedName . ' posted a video';
                 }
@@ -238,10 +238,8 @@ class YouTubeCommunityTabBridge extends BridgeAbstract
 <iframe width="100%" height="410" src="https://www.youtube.com/embed/{$attachments->videoRenderer->videoId}" 
 frameborder="0" allow="encrypted-media;" allowfullscreen></iframe>
 EOD;
-            }
-
-            // Image
-            if (isset($attachments->backstageImageRenderer)) {
+            } elseif (isset($attachments->backstageImageRenderer)) {
+                // Image
                 if (empty($this->itemTitle)) {
                     $this->itemTitle = $this->feedName . ' posted an image';
                 }
@@ -251,10 +249,8 @@ EOD;
                 $content = <<<EOD
 <p><img src="{$lastThumb->url}"></p>
 EOD;
-            }
-
-            // Poll
-            if (isset($attachments->pollRenderer)) {
+            } elseif (isset($attachments->pollRenderer)) {
+                // Poll
                 if (empty($this->itemTitle)) {
                     $this->itemTitle = $this->feedName . ' posted a poll';
                 }
@@ -270,6 +266,23 @@ EOD;
                 $content = <<<EOD
 <hr><p>Poll ({$attachments->pollRenderer->totalVotes->simpleText})<br><ul>{$pollChoices}</ul><p>
 EOD;
+            } elseif (isset($attachments->postMultiImageRenderer->images)) {
+                // Multiple images
+                $images = $attachments->postMultiImageRenderer->images;
+
+                if (is_array($images)) {
+                    if (empty($this->itemTitle)) {
+                        $this->itemTitle = $this->feedName . ' posted ' . count($images) . ' images';
+                    }
+
+                    foreach ($images as $image) {
+                        $lastThumb = end($image->backstageImageRenderer->image->thumbnails);
+
+                        $content .= <<<EOD
+<p><img src="{$lastThumb->url}"></p>
+EOD;
+                    }
+                }
             }
         }
 

From f48020982530ff08636a5233021014c16fc67c36 Mon Sep 17 00:00:00 2001
From: Eugene Molotov <eugene.molotov@yandex.ru>
Date: Mon, 6 May 2024 02:30:23 +0500
Subject: [PATCH 382/716] [YoutubeBridge] Fix empty result in search feed
 (#4098)

---
 bridges/YoutubeBridge.php | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/bridges/YoutubeBridge.php b/bridges/YoutubeBridge.php
index 6a29e387..af14c856 100644
--- a/bridges/YoutubeBridge.php
+++ b/bridges/YoutubeBridge.php
@@ -193,14 +193,7 @@ class YoutubeBridge extends BridgeAbstract
             $html = $this->fetch($url_listing);
             $jsonData = $this->extractJsonFromHtml($html);
             $jsonData = $jsonData->contents->twoColumnSearchResultsRenderer->primaryContents;
-            $jsonData = $jsonData->sectionListRenderer->contents;
-            foreach ($jsonData as $data) {
-                // Search result includes some ads, have to filter them
-                if (isset($data->itemSectionRenderer->contents[0]->videoRenderer)) {
-                    $jsonData = $data->itemSectionRenderer->contents;
-                    break;
-                }
-            }
+            $jsonData = $jsonData->sectionListRenderer->contents[0]->itemSectionRenderer->contents;
             $this->fetchItemsFromFromJsonData($jsonData);
             $this->feeduri = $url_listing;
             $this->feedName = 'Search: ' . $search;

From d11b7f77540760bf115b724dd06033ca6886485e Mon Sep 17 00:00:00 2001
From: Patrick <jummo4@yahoo.de>
Date: Sun, 5 May 2024 23:30:38 +0200
Subject: [PATCH 383/716] Change URI for St. Johannes Blick (#4099)

Co-authored-by: Patrick <jummo@mailbox.org>
---
 bridges/JohannesBlickBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/JohannesBlickBridge.php b/bridges/JohannesBlickBridge.php
index 72583a53..80ca9a71 100644
--- a/bridges/JohannesBlickBridge.php
+++ b/bridges/JohannesBlickBridge.php
@@ -3,7 +3,7 @@
 class JohannesBlickBridge extends BridgeAbstract
 {
     const NAME        = 'Johannes Blick';
-    const URI         = 'https://www.st-johannes-baptist.de/index.php/unsere-medien/johannesblick-archiv';
+    const URI         = 'https://www.st-johannes-baptist.de/index.php/medien-und-downloads/archiv-johannesblick';
     const DESCRIPTION = 'RSS feed for Johannes Blick';
     const MAINTAINER  = 'jummo4@yahoo.de';
 

From 1c3024fca7b8330b75e93fde673af09b1d797fa5 Mon Sep 17 00:00:00 2001
From: Facundo Tuesca <facu@tuesca.com>
Date: Wed, 8 May 2024 00:25:45 +0200
Subject: [PATCH 384/716] [MangaReaderBridge] Change feed title to manga name
 (#4092)

---
 bridges/MangaReaderBridge.php | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/bridges/MangaReaderBridge.php b/bridges/MangaReaderBridge.php
index 1fa0c62d..1b8e765b 100644
--- a/bridges/MangaReaderBridge.php
+++ b/bridges/MangaReaderBridge.php
@@ -26,11 +26,26 @@ class MangaReaderBridge extends BridgeAbstract
         ]
     ];
 
+    protected $feedName = '';
+
+
+    public function getName()
+    {
+        if (empty($this->feedName)) {
+            return parent::getName();
+        } else {
+            return $this->feedName;
+        }
+    }
+
     public function collectData()
     {
         $url = $this->getInput('url');
         $lang = $this->getInput('lang');
         $dom = getSimpleHTMLDOM($url);
+        $aniDetail = $dom->getElementById('ani_detail');
+        $this->feedName = html_entity_decode($aniDetail->find('h2', 0)->plaintext);
+
         $chapters = $dom->getElementById($lang . '-chapters');
 
         foreach ($chapters->getElementsByTagName('li') as $chapter) {

From 776ee233bdc22833815ece7d87140a4c64aa540c Mon Sep 17 00:00:00 2001
From: Alex Balgavy <8124851+thezeroalpha@users.noreply.github.com>
Date: Sun, 12 May 2024 20:30:23 +0200
Subject: [PATCH 385/716] [NOSBridge] fix bridge (#4102)

CSS selectors were no longer valid.
---
 bridges/NOSBridge.php | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/bridges/NOSBridge.php b/bridges/NOSBridge.php
index 33cad40b..60a560aa 100644
--- a/bridges/NOSBridge.php
+++ b/bridges/NOSBridge.php
@@ -14,7 +14,7 @@ class NOSBridge extends BridgeAbstract
                 'name' => 'Onderwerp',
                 'title' => 'Kies onderwerp',
                 'values' => [
-                    'Laatste nieuws' => 'nieuws',
+                    'Laatste nieuws' => 'nieuws/laatste',
                     'Binnenland' => 'nieuws/binnenland',
                     'Buitenland' => 'nieuws/buitenland',
                     'Regionaal nieuws' => 'nieuws/regio',
@@ -38,17 +38,16 @@ class NOSBridge extends BridgeAbstract
     {
         $url = sprintf('https://www.nos.nl/%s', $this->getInput('topic'));
         $dom = getSimpleHTMLDOM($url);
-        $dom = $dom->find('ul.list-items', 0);
+        $dom = $dom->find('main#content > div > section > ul', 0);
         if (!$dom) {
             throw new \Exception(sprintf('Unable to find css selector on `%s`', $url));
         }
         $dom = defaultLinkTo($dom, $this->getURI());
-        foreach ($dom->find('li.list-items__item') as $article) {
-            $a = $article->find('a', 0);
+        foreach ($dom->find('li') as $article) {
             $this->items[] = [
-                'title' => $article->find('h3.list-items__title', 0)->plaintext,
-                'uri' => $article->find('a.list-items__link', 0)->href,
-                'content' => $article->find('p.list-items__description', 0)->plaintext,
+                'title' => $article->find('h2', 0)->plaintext,
+                'uri' => $article->find('a', 0)->href,
+                'content' => $article->find('p', 0)->plaintext,
                 'timestamp' => strtotime($article->find('time', 0)->datetime),
             ];
         }

From 494990086335bfa498f0ba7497765c09f3ff7570 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Sun, 12 May 2024 15:45:14 -0400
Subject: [PATCH 386/716] [ScribbleHubBridge] Handle 429 errors and use
 consistent GUID (#4104)

---
 bridges/ScribbleHubBridge.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/ScribbleHubBridge.php b/bridges/ScribbleHubBridge.php
index 60add802..b4f7beaa 100644
--- a/bridges/ScribbleHubBridge.php
+++ b/bridges/ScribbleHubBridge.php
@@ -107,12 +107,13 @@ class ScribbleHubBridge extends FeedExpander
         }
 
         $item['comments'] = $item['uri'] . '#comments';
+        $item['uid'] = $item['uri'];
 
         try {
             $dom = getSimpleHTMLDOMCached($item['uri']);
         } catch (HttpException $e) {
             // 403 Forbidden, This means we got anti-bot response
-            if ($e->getCode() === 403) {
+            if ($e->getCode() === 403 || $e->getCode() === 429) {
                 return $item;
             }
             throw $e;
@@ -134,7 +135,6 @@ class ScribbleHubBridge extends FeedExpander
 
         //Generate UID
         $item_pid = $dom->find('#mypostid', 0)->value;
-        $item['uid'] = $item_sid . "/$item_pid";
 
         return $item;
     }

From 6e2aeda61d4aefb1106be2cef63cc775ee4f300d Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Sun, 12 May 2024 15:46:07 -0400
Subject: [PATCH 387/716] [GameBananaBridge] Include update contents in feed
 (#4103)

* [GameBananaBridge] Include update contents in feed

* [GameBananaBridge] Fix dynamic title property
---
 bridges/GameBananaBridge.php | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/bridges/GameBananaBridge.php b/bridges/GameBananaBridge.php
index 591ac0e9..9a0a0686 100644
--- a/bridges/GameBananaBridge.php
+++ b/bridges/GameBananaBridge.php
@@ -28,6 +28,8 @@ class GameBananaBridge extends BridgeAbstract
         return 'https://images.gamebanana.com/static/img/favicon/favicon.ico';
     }
 
+    private $title;
+
     public function collectData()
     {
         $url = 'https://api.gamebanana.com/Core/List/New?itemtype=Mod&page=1&gameid=' . $this->getInput('gid');
@@ -38,7 +40,7 @@ class GameBananaBridge extends BridgeAbstract
         $json_list = json_decode($api_response, true); // Get first page mod list
 
         $url = 'https://api.gamebanana.com/Core/Item/Data?itemtype[]=Game&fields[]=name&itemid[]=' . $this->getInput('gid');
-        $fields = 'name,Owner().name,text,screenshots,Files().aFiles(),date,Url().sProfileUrl(),udate';
+        $fields = 'name,Owner().name,text,screenshots,Files().aFiles(),date,Url().sProfileUrl(),udate,Updates().aLatestUpdates()';
         foreach ($json_list as $element) { // Build api request to minimize API calls
             $mid = $element[1];
             $url .= '&itemtype[]=Mod&fields[]=' . $fields . '&itemid[]=' . $mid;
@@ -72,6 +74,10 @@ class GameBananaBridge extends BridgeAbstract
             foreach ($img_list as $img_element) {
                 $item['content'] .= '<img src="https://images.gamebanana.com/img/ss/mods/' . $img_element['_sFile'] . '"/>';
             }
+            if ($this->getInput('updates') && sizeof($element[8]) > 0) {
+                $item['content'] .= '<br><strong>Update: ' . $element[8][0]['_sTitle'];
+                $item['content'] .= '</strong><br>' . $element[8][0]['_sText'] . '<hr>';
+            }
             $item['content'] .= '<br>' . $element[2];
 
             $item['uid'] = $item['uri'] . $item['title'] . $item['timestamp'];

From b785a4b64ee7fb295b845a59bd9d573a3e775e3e Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Fri, 17 May 2024 15:29:17 -0400
Subject: [PATCH 388/716] ArsTechnicaBridge: restore categories lost by
 FeedExpander (#4030)

---
 bridges/ArsTechnicaBridge.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/bridges/ArsTechnicaBridge.php b/bridges/ArsTechnicaBridge.php
index 2c631871..fcb1bd4f 100644
--- a/bridges/ArsTechnicaBridge.php
+++ b/bridges/ArsTechnicaBridge.php
@@ -39,6 +39,10 @@ class ArsTechnicaBridge extends FeedExpander
         $item_html = defaultLinkTo($item_html, self::URI);
         $item['content'] = $item_html->find('.article-content', 0);
 
+        $parsely = $item_html->find('[name="parsely-page"]', 0);
+        $parsely_json = json_decode(html_entity_decode($parsely->content), true);
+        $item['categories'] = $parsely_json['tags'];
+
         $pages = $item_html->find('nav.page-numbers > .numbers > a', -2);
         if (null !== $pages) {
             for ($i = 2; $i <= $pages->innertext; $i++) {

From a7ed3d56f9b8ea3194f78925e3d339f933aa726e Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Sat, 18 May 2024 15:46:53 +0200
Subject: [PATCH 389/716] [ZeitBridge] Prettify author field

By removing HTML tags (plaintext) and trimming it.
---
 bridges/ZeitBridge.php | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/bridges/ZeitBridge.php b/bridges/ZeitBridge.php
index b9806e5a..07b8e70c 100644
--- a/bridges/ZeitBridge.php
+++ b/bridges/ZeitBridge.php
@@ -108,12 +108,9 @@ class ZeitBridge extends FeedExpander
         }
 
         // authors
-        $authors = $article->find('*[itemtype*="schema.org/Person"]');
-        if (!$authors) {
-            $authors = $article->find('.metadata__source');
-        }
+        $authors = $article->find('*[itemtype*="schema.org/Person"]') ?? $article->find('.metadata__source');
         if ($authors) {
-            $item['author'] = implode(', ', $authors);
+            $item['author'] = implode(', ', array_map(function ($e) { return trim($e->plaintext); }, $authors));
         }
 
         // header image

From 4d12aa2a9ee03b32b270a4a0930d7e9cef0515ca Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Sat, 18 May 2024 16:11:26 +0200
Subject: [PATCH 390/716] [ZeitBridge] Remove annoyances, add content

Remove navigational elements, podcast images.
Add many more header images, article content in <ul> (and for ggod
measure in <ol>) and quotes with their content and not only their
author.

Extreme example:
https://www.zeit.de/campus/2024-05/protest-palaestina-universitaet-europa-uebersicht
---
 bridges/ZeitBridge.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bridges/ZeitBridge.php b/bridges/ZeitBridge.php
index 07b8e70c..d79f7e7c 100644
--- a/bridges/ZeitBridge.php
+++ b/bridges/ZeitBridge.php
@@ -87,7 +87,7 @@ class ZeitBridge extends FeedExpander
         // remove known bad elements
         foreach (
             $article->find(
-                'aside, .visually-hidden, .carousel-container, #tickaroo-liveblog, .zplus-badge, .article-heading__container--podcast, div[data-paywall], .js-embed-consent'
+                'aside, .visually-hidden, .carousel-container, #tickaroo-liveblog, .zplus-badge, .article-heading__container--podcast, .podcast-player__image, div[data-paywall], .js-embed-consent, script, nav, .article-flexible-toc__subheading-link, .faq-link'
             ) as $bad
         ) {
             $bad->remove();
@@ -114,7 +114,7 @@ class ZeitBridge extends FeedExpander
         }
 
         // header image
-        $headerimg = $article->find('*[data-ct-row="headerimage"]', 0) ?? $article->find('header', 0);
+        $headerimg = $article->find('*[data-ct-row="headerimage"]', 0) ?? $article->find('.article-header', 0) ?? $article->find('header', 0);
         if ($headerimg) {
             $item['content'] .= implode('', $headerimg->find('img[src], figcaption'));
         }
@@ -124,7 +124,7 @@ class ZeitBridge extends FeedExpander
 
         if ($pages) {
             foreach ($pages as $page) {
-                $elements = $page->find('p, h2, figcaption, img[src]');
+                $elements = $page->find('p, ul, ol, h2, figure.article__media img[src], figure.article__media figcaption, figure.quote');
                 $item['content'] .= implode('', $elements);
             }
         }

From 7bde7a56f95a50f0394a1efb45cbbd80af643f9f Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Sat, 18 May 2024 16:18:23 +0200
Subject: [PATCH 391/716] [ZeitBridge] Fix linting

---
 bridges/ZeitBridge.php | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/bridges/ZeitBridge.php b/bridges/ZeitBridge.php
index d79f7e7c..ae8a1a66 100644
--- a/bridges/ZeitBridge.php
+++ b/bridges/ZeitBridge.php
@@ -87,7 +87,9 @@ class ZeitBridge extends FeedExpander
         // remove known bad elements
         foreach (
             $article->find(
-                'aside, .visually-hidden, .carousel-container, #tickaroo-liveblog, .zplus-badge, .article-heading__container--podcast, .podcast-player__image, div[data-paywall], .js-embed-consent, script, nav, .article-flexible-toc__subheading-link, .faq-link'
+                'aside, .visually-hidden, .carousel-container, #tickaroo-liveblog, .zplus-badge,
+                .article-heading__container--podcast, .podcast-player__image, div[data-paywall],
+                .js-embed-consent, script, nav, .article-flexible-toc__subheading-link, .faq-link'
             ) as $bad
         ) {
             $bad->remove();
@@ -110,7 +112,9 @@ class ZeitBridge extends FeedExpander
         // authors
         $authors = $article->find('*[itemtype*="schema.org/Person"]') ?? $article->find('.metadata__source');
         if ($authors) {
-            $item['author'] = implode(', ', array_map(function ($e) { return trim($e->plaintext); }, $authors));
+            $item['author'] = implode(', ', array_map(function ($e) {
+                return trim($e->plaintext);
+            }, $authors));
         }
 
         // header image

From 75f35391fa3399f230d425a33a6836ccf07340ff Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Sat, 18 May 2024 16:51:00 +0200
Subject: [PATCH 392/716] [HeiseBridge] Add missing <ol> elements (#4110)

The following article has <ol> elements that were missing.
Adding them to have the full content.

https://heise.de/-9714438
---
 bridges/HeiseBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/HeiseBridge.php b/bridges/HeiseBridge.php
index a78b4609..9aa7209d 100644
--- a/bridges/HeiseBridge.php
+++ b/bridges/HeiseBridge.php
@@ -214,7 +214,7 @@ class HeiseBridge extends FeedExpander
         $content = $article->find('.article-content', 0);
         if ($content) {
             $contentElements = $content->find(
-                'p, h3, ul, table, pre, noscript img, a-bilderstrecke h2, a-bilderstrecke figure, a-bilderstrecke figcaption'
+                'p, h3, ul, ol, table, pre, noscript img, a-bilderstrecke h2, a-bilderstrecke figure, a-bilderstrecke figcaption'
             );
             $item['content'] .= implode('', $contentElements);
         }

From dc199ebf5c134960c59bceb233afff0379062a77 Mon Sep 17 00:00:00 2001
From: Albert Kiskorov <me@albi.io>
Date: Sun, 19 May 2024 19:37:59 +0700
Subject: [PATCH 393/716] Fix: Ensure `$time` is set from `innertext` when
 `datetime` attribute is not found (#4111)

This commit addresses a bug where the $time variable is not set from the innertext of the $time_element when the datetime attribute is not found. The previous implementation only checked if $time was null or an empty string, which did not cover all cases where the datetime attribute might be missing. By using the empty() function, we ensure that $time is correctly set from the innertext when the datetime attribute is not present.
---
 bridges/CssSelectorComplexBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/CssSelectorComplexBridge.php b/bridges/CssSelectorComplexBridge.php
index 632e6b6a..a2e001b2 100644
--- a/bridges/CssSelectorComplexBridge.php
+++ b/bridges/CssSelectorComplexBridge.php
@@ -442,7 +442,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
         if (!is_null($time_selector) && $time_selector != '') {
             $time_element = $entry_html->find($time_selector, 0);
             $time = $time_element->getAttribute('datetime');
-            if (is_null($time)) {
+            if (empty($time)) {
                 $time = $time_element->innertext;
             }
 

From 5a68ee0c87bc2392886efd411511e094ae4fe5ac Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Sun, 26 May 2024 20:51:14 +0530
Subject: [PATCH 394/716] [HinduTamilBridge] New (#4115)

---
 bridges/HinduTamilBridge.php | 91 ++++++++++++++++++++++++++++++++++++
 1 file changed, 91 insertions(+)
 create mode 100644 bridges/HinduTamilBridge.php

diff --git a/bridges/HinduTamilBridge.php b/bridges/HinduTamilBridge.php
new file mode 100644
index 00000000..cdbdfe35
--- /dev/null
+++ b/bridges/HinduTamilBridge.php
@@ -0,0 +1,91 @@
+<?php
+
+class HinduTamilBridge extends FeedExpander
+{
+    const NAME = 'HinduTamil';
+    const URI = 'https://www.hindutamil.in';
+    const DESCRIPTION = 'Retrieve full articles from hindutamil.in feeds';
+    const MAINTAINER = 'tillcash';
+    const PARAMETERS = [
+        [
+            'topic' => [
+                'name' => 'topic',
+                'type' => 'list',
+                'defaultValue' => 'crime',
+                'values' => [
+                    'Astrology' => 'astrology',
+                    'Blogs' => 'blogs',
+                    'Business' => 'business',
+                    'Cartoon' => 'cartoon',
+                    'Cinema' => 'cinema',
+                    'Crime' => 'crime',
+                    'Discussion' => 'discussion',
+                    'Education' => 'education',
+                    'Environment' => 'environment',
+                    'India' => 'india',
+                    'Lifestyle' => 'life-style',
+                    'Literature' => 'literature',
+                    'Opinion' => 'opinion',
+                    'Reporters' => 'reporters-page',
+                    'Socialmedia' => 'social-media',
+                    'Spirituals' => 'spirituals',
+                    'Sports' => 'sports',
+                    'Supplements' => 'supplements',
+                    'Tamilnadu' => 'tamilnadu',
+                    'Technology' => 'technology',
+                    'Tourism' => 'tourism',
+                    'World' => 'world',
+                ],
+            ],
+            'limit' => [
+                'name' => 'limit (max 100)',
+                'type' => 'number',
+                'defaultValue' => 10,
+            ],
+        ],
+    ];
+
+    const FEED_BASE_URL = 'https://feeds.feedburner.com/Hindu_Tamil_';
+
+    public function getName()
+    {
+        $topic = $this->getKey('topic');
+        return self::NAME . ($topic ? ' - ' . $topic : '');
+    }
+
+    public function collectData()
+    {
+        $limit = min(100, $this->getInput('limit'));
+        $url = self::FEED_BASE_URL . $this->getInput('topic');
+        $this->collectExpandableDatas($url, $limit);
+    }
+
+    protected function parseItem($item)
+    {
+        $dom = getSimpleHTMLDOMCached($item['uri']);
+
+        $date = $dom->find('p span.date', 1);
+        if ($date) {
+            $item['timestamp'] = $date->innertext;
+        }
+
+        $content = $dom->find('#pgContentPrint', 0);
+        if (!$content) {
+            return $item;
+        }
+
+        $image = $dom->find('#LoadArticle figure', 0);
+        $item['content'] = $image . $this->cleanContent($content);
+
+        return $item;
+    }
+
+    private function cleanContent($content)
+    {
+        foreach ($content->find('div[align="center"], script') as $remove) {
+            $remove->outertext = '';
+        }
+
+        return $content;
+    }
+}

From bd90109c70fd3d4b302ed38e7b768e6df7d323d9 Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Thu, 30 May 2024 00:46:10 +0530
Subject: [PATCH 395/716] [HarvardHealthBlogBridge] New (#4116)

---
 bridges/HarvardHealthBlogBridge.php | 56 +++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 bridges/HarvardHealthBlogBridge.php

diff --git a/bridges/HarvardHealthBlogBridge.php b/bridges/HarvardHealthBlogBridge.php
new file mode 100644
index 00000000..75e7e2cf
--- /dev/null
+++ b/bridges/HarvardHealthBlogBridge.php
@@ -0,0 +1,56 @@
+<?php
+
+class HarvardHealthBlogBridge extends BridgeAbstract
+{
+    const NAME = 'Harvard Health Blog';
+    const URI = 'https://www.health.harvard.edu/blog';
+    const DESCRIPTION = 'Retrieve articles from health.harvard.edu';
+    const MAINTAINER = 'tillcash';
+    const MAX_ARTICLES = 10;
+
+    public function collectData()
+    {
+        $dom = getSimpleHTMLDOM(self::URI);
+        $count = 0;
+
+        foreach ($dom->find('div[class="mb-16 md:flex"]') as $element) {
+            if ($count >= self::MAX_ARTICLES) {
+                break;
+            }
+
+            $data = $element->find('a[class="hover:text-red transition-colors duration-200"]', 0);
+            if (!$data) {
+                continue;
+            }
+
+            $url = $data->href;
+
+            $this->items[] = [
+                'content'   => $this->constructContent($url),
+                'timestamp' => $element->find('time', 0)->datetime,
+                'title'     => $data->plaintext,
+                'uid'       => $url,
+                'uri'       => $url,
+            ];
+
+            $count++;
+        }
+    }
+
+    private function constructContent($url)
+    {
+        $dom = getSimpleHTMLDOMCached($url);
+
+        $article = $dom->find('div[class*="content-repository-content"]', 0);
+        if (!$article) {
+            return 'Content Not Found';
+        }
+
+        // Remove ads
+        foreach ($article->find('.inline-ad') as $remove) {
+            $remove->outertext = '';
+        }
+
+        return $article->innertext;
+    }
+}

From cfd406861eeb6f90b61df56981cc0337ab504a06 Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Thu, 30 May 2024 19:38:08 +0530
Subject: [PATCH 396/716] [HarvardHealthBlogBridge] Update (#4117)

Make article image optional as all images are representative
---
 bridges/HarvardHealthBlogBridge.php | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/bridges/HarvardHealthBlogBridge.php b/bridges/HarvardHealthBlogBridge.php
index 75e7e2cf..bb6a5ede 100644
--- a/bridges/HarvardHealthBlogBridge.php
+++ b/bridges/HarvardHealthBlogBridge.php
@@ -7,6 +7,15 @@ class HarvardHealthBlogBridge extends BridgeAbstract
     const DESCRIPTION = 'Retrieve articles from health.harvard.edu';
     const MAINTAINER = 'tillcash';
     const MAX_ARTICLES = 10;
+    const PARAMETERS = [
+        [
+            'image' => [
+                'name' => 'Article Image',
+                'type' => 'checkbox',
+                'defaultValue' => 'checked',
+            ],
+        ],
+    ];
 
     public function collectData()
     {
@@ -46,9 +55,15 @@ class HarvardHealthBlogBridge extends BridgeAbstract
             return 'Content Not Found';
         }
 
-        // Remove ads
-        foreach ($article->find('.inline-ad') as $remove) {
-            $remove->outertext = '';
+        // remove article image
+        if (!$this->getInput('image')) {
+            $image = $article->find('p', 0);
+            $image->remove();
+        }
+
+        // remove ads
+        foreach ($article->find('.inline-ad') as $ad) {
+            $ad->outertext = '';
         }
 
         return $article->innertext;

From 36706a3dec464f1ab59b21356bc838ab77c657b4 Mon Sep 17 00:00:00 2001
From: Tim-Florian Feulner <50834839+R3dError@users.noreply.github.com>
Date: Mon, 3 Jun 2024 00:55:39 +0200
Subject: [PATCH 397/716] Fix NACSouthGermanyMediaLibraryBridge due to website
 changes (#4121)

---
 bridges/NACSouthGermanyMediaLibraryBridge.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bridges/NACSouthGermanyMediaLibraryBridge.php b/bridges/NACSouthGermanyMediaLibraryBridge.php
index 030ded8f..70129b37 100644
--- a/bridges/NACSouthGermanyMediaLibraryBridge.php
+++ b/bridges/NACSouthGermanyMediaLibraryBridge.php
@@ -85,12 +85,12 @@ class NACSouthGermanyMediaLibraryBridge extends BridgeAbstract
 
         foreach ($page->find('div.flex-columns.entry') as $parent) {
             # Find title
-            $title = $parent->find('h2', 0)->plaintext;
+            $title = trim($parent->find('h2')[0]->innertext);
 
             # Find content
-            $contentBlock = $parent->find('ul', 0);
+            $contentBlock = $parent->find('div')[2];
             $content = '';
-            foreach ($contentBlock->find('li') as $li) {
+            foreach ($contentBlock->find('li,p') as $li) {
                 $content .= '<p>' . $li->plaintext . '</p>';
             }
 

From 87fa6ea71e8ae8c6e0cddd47e28fd65664a6cb05 Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Mon, 10 Jun 2024 19:40:07 +0200
Subject: [PATCH 398/716] [HeiseBridge.php] Prevent Youtube videos from being
 filtered out (#4125)

---
 bridges/HeiseBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/HeiseBridge.php b/bridges/HeiseBridge.php
index 9aa7209d..e26a4607 100644
--- a/bridges/HeiseBridge.php
+++ b/bridges/HeiseBridge.php
@@ -214,7 +214,7 @@ class HeiseBridge extends FeedExpander
         $content = $article->find('.article-content', 0);
         if ($content) {
             $contentElements = $content->find(
-                'p, h3, ul, ol, table, pre, noscript img, a-bilderstrecke h2, a-bilderstrecke figure, a-bilderstrecke figcaption'
+                'p, h3, ul, ol, table, pre, noscript img, a-bilderstrecke h2, a-bilderstrecke figure, a-bilderstrecke figcaption, noscript iframe'
             );
             $item['content'] .= implode('', $contentElements);
         }

From d3d33c72bda0cb6f222b415da075b32f2a60a61d Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Tue, 11 Jun 2024 19:10:49 +0530
Subject: [PATCH 399/716] [HinduTamilBridge] fix timestamp (#4127)

---
 bridges/HinduTamilBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/HinduTamilBridge.php b/bridges/HinduTamilBridge.php
index cdbdfe35..cab04171 100644
--- a/bridges/HinduTamilBridge.php
+++ b/bridges/HinduTamilBridge.php
@@ -66,7 +66,7 @@ class HinduTamilBridge extends FeedExpander
 
         $date = $dom->find('p span.date', 1);
         if ($date) {
-            $item['timestamp'] = $date->innertext;
+            $item['timestamp'] = $date->innertext . ' IST';
         }
 
         $content = $dom->find('#pgContentPrint', 0);

From e1b74aeb1bd120ac0c337fae9f55943cf7d00a0d Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Wed, 12 Jun 2024 23:02:17 -0400
Subject: [PATCH 400/716] [GameBananaBridge] Add categories and more detailed
 updates (#4129)

* [GameBananaBridge] Add mod categorie(s)

* [GameBananaBridge] Include full update changelog details
---
 bridges/GameBananaBridge.php | 25 ++++++++++++++++++++++---
 1 file changed, 22 insertions(+), 3 deletions(-)

diff --git a/bridges/GameBananaBridge.php b/bridges/GameBananaBridge.php
index 9a0a0686..88b19ef0 100644
--- a/bridges/GameBananaBridge.php
+++ b/bridges/GameBananaBridge.php
@@ -40,7 +40,7 @@ class GameBananaBridge extends BridgeAbstract
         $json_list = json_decode($api_response, true); // Get first page mod list
 
         $url = 'https://api.gamebanana.com/Core/Item/Data?itemtype[]=Game&fields[]=name&itemid[]=' . $this->getInput('gid');
-        $fields = 'name,Owner().name,text,screenshots,Files().aFiles(),date,Url().sProfileUrl(),udate,Updates().aLatestUpdates()';
+        $fields = 'name,Owner().name,text,screenshots,Files().aFiles(),date,Url().sProfileUrl(),udate,Updates().aLatestUpdates(),Category().name,RootCategory().name';
         foreach ($json_list as $element) { // Build api request to minimize API calls
             $mid = $element[1];
             $url .= '&itemtype[]=Mod&fields[]=' . $fields . '&itemid[]=' . $mid;
@@ -52,11 +52,18 @@ class GameBananaBridge extends BridgeAbstract
         array_shift($json_list); // Take title from API request and remove from json
 
         foreach ($json_list as $element) {
+            // Trashed mod IDs are still picked up and return null; skip
+            if ($element[0] == null) {
+                continue;
+            }
+
             $item = [];
             $item['uri'] = $element[6];
             $item['comments'] = $item['uri'] . '#PostsListModule';
             $item['title'] = $element[0];
             $item['author'] = $element[1];
+            $item['categories'][] = $element[9];
+            $item['categories'][] = $element[10];
 
             $item['timestamp'] = $element[5];
             if ($this->getInput('updates')) {
@@ -74,9 +81,21 @@ class GameBananaBridge extends BridgeAbstract
             foreach ($img_list as $img_element) {
                 $item['content'] .= '<img src="https://images.gamebanana.com/img/ss/mods/' . $img_element['_sFile'] . '"/>';
             }
+
+            // Get updates from element[8], if applicable
             if ($this->getInput('updates') && sizeof($element[8]) > 0) {
-                $item['content'] .= '<br><strong>Update: ' . $element[8][0]['_sTitle'];
-                $item['content'] .= '</strong><br>' . $element[8][0]['_sText'] . '<hr>';
+                $update = $element[8][0];
+                $item['content'] .= '<br><strong>Update:</strong> ' . $update['_sTitle'];
+                if ($update['_sText'] != '') {
+                    $item['content'] .= '<br>' . $update['_sText'];
+                }
+                foreach ($update['_aChangeLog'] as $change) {
+                    if ($change['cat'] == '') {
+                        $change['cat'] = 'Change';
+                    }
+                    $item['content'] .= '<br><em>' . $change['cat'] . '</em>: ' . $change['text'];
+                }
+                $item['content'] .= '<br><hr>';
             }
             $item['content'] .= '<br>' . $element[2];
 

From bb1e308057b7e8740d67d0fb0fa9c6298e9b9730 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Thu, 13 Jun 2024 05:03:20 +0200
Subject: [PATCH 401/716] [IdealoBridge] Fix price comparison and some PHP
 Notice (#4130)

* [IdealoBridge] Fix price comparison and some PHP Notice

- The prices were compared as String and the comparison was wrong in
  some case : now the price are converted to float before the
 comparison, so the logic works really.

- Don't show a new or used product price if it does not exist : this
  prevents a PHP Notice to be thrown

* [IdealoBridge] Fix price conversion in case the price is null

The conversion as float of the text price won't work if the price is
null : we retunr null in this case now.
---
 bridges/IdealoBridge.php | 43 ++++++++++++++++++++++++++++++----------
 1 file changed, 32 insertions(+), 11 deletions(-)

diff --git a/bridges/IdealoBridge.php b/bridges/IdealoBridge.php
index 4eb66dcb..f426a45c 100644
--- a/bridges/IdealoBridge.php
+++ b/bridges/IdealoBridge.php
@@ -81,6 +81,25 @@ class IdealoBridge extends BridgeAbstract
         return $title . ' - ' . $this::NAME;
     }
 
+    /**
+     * Returns the Price as float
+     * @return float rhe price converted in float
+     */
+    private function convertPriceToFloat($price)
+    {
+        // Every price is stored / displayed as "xxx,xx €", but PHP can't convert it as float
+
+        if ($price !== null) {
+            // Convert comma as dot
+            $price = str_replace(',', '.', $price);
+            // Remove the '€' char
+            $price = str_replace('€', '', $price);
+            // Convert to float
+            return floatval($price);
+        } else {
+            return $price;
+        }
+    }
 
     /**
      * Returns the Price Trend emoji
@@ -88,8 +107,10 @@ class IdealoBridge extends BridgeAbstract
      */
     private function getPriceTrend($NewPrice, $OldPrice)
     {
-        // In case there is no old PRice, then show no trend
-        if ($OldPrice === null) {
+        $NewPrice = $this->convertPriceToFloat($NewPrice);
+        $OldPrice = $this->convertPriceToFloat($OldPrice);
+        // In case there is no old Price, then show no trend
+        if ($OldPrice === null || $OldPrice == 0) {
             $trend = '';
         } else if ($NewPrice > $OldPrice) {
             $trend = '&#x2197;';
@@ -125,7 +146,7 @@ class IdealoBridge extends BridgeAbstract
         $OldPriceNew = $this->loadCacheValue($KeyNEW);
         $OldPriceUsed = $this->loadCacheValue($KeyUSED);
 
-        // First button is new. Found at oopStage-conditionButton-wrapper-text class (.)
+        // First button contains the new price. Found at oopStage-conditionButton-wrapper-text class (.)
         $FirstButton = $html->find('.oopStage-conditionButton-wrapper-text', 0);
         if ($FirstButton) {
             $PriceNew = $FirstButton->find('strong', 0)->plaintext;
@@ -133,7 +154,7 @@ class IdealoBridge extends BridgeAbstract
             $this->saveCacheValue($KeyNEW, $PriceNew);
         }
 
-        // Second Button is used
+        // Second Button contains the used product price
         $SecondButton = $html->find('.oopStage-conditionButton-wrapper-text', 1);
         if ($SecondButton) {
             $PriceUsed = $SecondButton->find('strong', 0)->plaintext;
@@ -149,7 +170,7 @@ class IdealoBridge extends BridgeAbstract
             $content = '';
 
             // Generate Content
-            if (isset($PriceNew) && $PriceNew > 1) {
+            if (isset($PriceNew) && $this->convertPriceToFloat($PriceNew) > 0) {
                 $content .= sprintf('<p><b>Price New:</b><br>%s %s</p>', $PriceNew, $this->getPriceTrend($PriceNew, $OldPriceNew));
                 $content .= "<p><b>Price New before:</b><br>$OldPriceNew</p>";
             }
@@ -158,7 +179,7 @@ class IdealoBridge extends BridgeAbstract
                 $content .= sprintf('<p><b>Max Price New:</b><br>%s,00 €</p>', $this->getInput('MaxPriceNew'));
             }
 
-            if (isset($PriceUsed) && $PriceUsed > 1) {
+            if (isset($PriceUsed) && $this->convertPriceToFloat($PriceUsed) > 0) {
                 $content .= sprintf('<p><b>Price Used:</b><br>%s %s</p>', $PriceUsed, $this->getPriceTrend($PriceUsed, $OldPriceUsed));
                 $content .= "<p><b>Price Used before:</b><br>$OldPriceUsed</p>";
             }
@@ -176,7 +197,7 @@ class IdealoBridge extends BridgeAbstract
 
             // Currently under Max new price
             if ($this->getInput('MaxPriceNew') != '') {
-                if (isset($PriceNew) && $PriceNew < $this->getInput('MaxPriceNew')) {
+                if (isset($PriceNew) && $this->convertPriceToFloat($PriceNew) < $this->getInput('MaxPriceNew')) {
                     $title = sprintf($Pricealarm, 'New', $PriceNew, $Productname, $now);
                     $item = [
                         'title'     => $title,
@@ -190,7 +211,7 @@ class IdealoBridge extends BridgeAbstract
 
             // Currently under Max used price
             if ($this->getInput('MaxPriceUsed') != '') {
-                if (isset($PriceUsed) && $PriceUsed < $this->getInput('MaxPriceUsed')) {
+                if (isset($PriceUsed) && $this->convertPriceToFloat($PriceUsed) < $this->getInput('MaxPriceUsed')) {
                     $title = sprintf($Pricealarm, 'Used', $PriceUsed, $Productname, $now);
                     $item = [
                         'title'     => $title,
@@ -202,7 +223,7 @@ class IdealoBridge extends BridgeAbstract
                 }
             }
 
-            // General Priceupdate
+            // General Priceupdate Without any Max Price for new and Used product
             if ($this->getInput('MaxPriceUsed') == '' && $this->getInput('MaxPriceNew') == '') {
                 // check if a relevant pricechange happened
                 if (
@@ -211,11 +232,11 @@ class IdealoBridge extends BridgeAbstract
                 ) {
                     $title = 'Priceupdate! ';
 
-                    if (!$this->getInput('ExcludeNew')) {
+                    if (!$this->getInput('ExcludeNew') && isset($PriceNew)) {
                         $title .= 'NEW' . $this->getPriceTrend($PriceNew, $OldPriceNew) . ' ';
                     }
 
-                    if (!$this->getInput('ExcludeUsed')) {
+                    if (!$this->getInput('ExcludeUsed') && isset($PriceUsed)) {
                         $title .= 'USED' . $this->getPriceTrend($PriceUsed, $OldPriceUsed) . ' ';
                     }
                     $title .= $Productname;

From 649dfa72929c8aabdbbf4c693b35c484ffa135e9 Mon Sep 17 00:00:00 2001
From: Ftonans <77411099+Ftonans@users.noreply.github.com>
Date: Thu, 13 Jun 2024 18:11:02 +0000
Subject: [PATCH 402/716] Update instance list (#4131)

vern's instance seems to be working, I changed the url to https since they have automatic redirect.

I removed trailing slashes from the urls so they look the same.

I removed [rss.m3wz.su](https://rss.m3wz.su] since I didn't see the website online and the owner last posted on Fediverse two months ago. I'm not sure maybe it should be in "Inactive" category, I can try to contact m3wz for information about his instance.

I removed rss.foxhaven.cyou because of [this](https://shitpost.poridge.club/notes/9lumb2gll8) (TL;DR the owner lost access to the domain)

bus-hit is offline but the main website is working. I guess the rss-bridge just crashed and the owner will restart it.
---
 docs/01_General/06_Public_Hosts.md | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/docs/01_General/06_Public_Hosts.md b/docs/01_General/06_Public_Hosts.md
index 1bc8fc20..fa8d5fdd 100644
--- a/docs/01_General/06_Public_Hosts.md
+++ b/docs/01_General/06_Public_Hosts.md
@@ -3,12 +3,12 @@
 | Country | Address | Status |  Contact | Comment |
 |:-------:|---------|--------|----------|---------|
 | ![](https://iplookup.flagfox.net/images/h16/GB.png) | https://rss-bridge.org/bridge01 | ![](https://img.shields.io/website/https/rss-bridge.org/bridge01.svg) | [@dvikan](https://github.com/dvikan) | London, Digital Ocean|
-| ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://rssbridge.flossboxin.org.in/ | ![](https://img.shields.io/badge/website-up-brightgreen) | [@vdbhb59](https://github.com/vdbhb59) | Hosted with OVH SAS (Maintained in India) |
-| ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://rss-bridge.cheredeprince.net/ | ![](https://img.shields.io/website/https/rss-bridge.cheredeprince.net) | [@La_Bécasse](https://cheredeprince.net/contact) | Self-Hosted at home in France |
+| ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://rssbridge.flossboxin.org.in | ![](https://img.shields.io/badge/website-up-brightgreen) | [@vdbhb59](https://github.com/vdbhb59) | Hosted with OVH SAS (Maintained in India) |
+| ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://rss-bridge.cheredeprince.net | ![](https://img.shields.io/website/https/rss-bridge.cheredeprince.net) | [@La_Bécasse](https://cheredeprince.net/contact) | Self-Hosted at home in France |
 | ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://rss-bridge.sans-nuage.fr | ![](https://img.shields.io/website/https/rss-bridge.sans-nuage.fr) | [@Alsace Réseau Neutre](https://arn-fai.net/contact) | Hosted in Alsace, France |
 | ![](https://iplookup.flagfox.net/images/h16/GB.png) | https://rss-bridge.lewd.tech | ![](https://img.shields.io/website/https/rss-bridge.lewd.tech.svg) | [@Erisa](https://github.com/Erisa) | Hosted in London, protected by Cloudflare Rate Limiting |
 | ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://bridge.easter.fr | ![](https://img.shields.io/website/https/bridge.easter.fr.svg) | [@chatainsim](https://github.com/chatainsim) | Hosted in Isère, France |
-| ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://wtf.roflcopter.fr/rss-bridge/ | ![](https://img.shields.io/website/https/wtf.roflcopter.fr/rss-bridge.svg) | [roflcopter.fr](https://wtf.roflcopter.fr/) | Hosted in France |
+| ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://wtf.roflcopter.fr/rss-bridge | ![](https://img.shields.io/website/https/wtf.roflcopter.fr/rss-bridge.svg) | [roflcopter.fr](https://wtf.roflcopter.fr/) | Hosted in France |
 | ![](https://iplookup.flagfox.net/images/h16/DE.png) | https://rss.nixnet.services | ![](https://img.shields.io/website/https/rss.nixnet.services.svg) | [@amolith](https://nixnet.services/contact) | Hosted in Wunstorf, Germany |
 | ![](https://iplookup.flagfox.net/images/h16/AT.png) | https://rss-bridge.ggc-project.de | ![](https://img.shields.io/website/https/rss-bridge.ggc-project.de) | [@ggc-project.de](https://social.dev-wiki.de/@ggc_project) | Hosted in Steyr, Austria |
 | ![](https://iplookup.flagfox.net/images/h16/CA.png) | https://rssbridge.bus-hit.me | ![](https://img.shields.io/website/https/rssbridge.bus-hit.me.svg)| [@austinhuang0131](https://austinhuang.me/) | Hosted with Oracle in Québec, Canada |
@@ -16,15 +16,15 @@
 | ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://rssbridge.boldair.dev | ![](https://img.shields.io/website?down_color=red&down_message=down&up_color=lime&up_message=up&url=https%3A%2F%2Frssbridge.boldair.dev) | [@Boldairdev](https://github.com/Boldairdev) | Latest Github release, Hosted on PHP 8.0 in Roubaix, France |
 | ![](https://iplookup.flagfox.net/images/h16/IN.png) | https://rss-bridge.bb8.fun | ![](https://img.shields.io/website/https/rss-bridge.bb8.fun.svg) | [@captn3m0](https://github.com/captn3m0) | Hosted in Bengaluru, India |
 | ![](https://iplookup.flagfox.net/images/h16/RU.png) | https://ololbu.ru/rss-bridge | ![](https://img.shields.io/website/https/ololbu.ru) | [@Ololbu](https://github.com/Ololbu) | Hosted in Moscow, Russia |
-| ![](https://iplookup.flagfox.net/images/h16/DE.png) | https://tools.bheil.net/rss-bridge/ | ![](https://img.shields.io/website/https/tools.bheil.net.svg) | [@bheil](https://www.bheil.net) | Hosted in Germany |
+| ![](https://iplookup.flagfox.net/images/h16/DE.png) | https://tools.bheil.net/rss-bridge | ![](https://img.shields.io/website/https/tools.bheil.net.svg) | [@bheil](https://www.bheil.net) | Hosted in Germany |
 | ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://bridge.suumitsu.eu | ![](https://img.shields.io/website/https/bridge.suumitsu.eu.svg) | [@mitsukarenai](https://github.com/mitsukarenai) | Hosted in Paris, France |
 | ![](https://iplookup.flagfox.net/images/h16/NL.png) | https://feed.eugenemolotov.ru | ![](https://img.shields.io/website/https/feed.eugenemolotov.ru.svg) | [@em92](https://github.com/em92) | Hosted in Amsterdam, Netherlands |
 | ![](https://iplookup.flagfox.net/images/h16/DE.png) | https://rss-bridge.mediani.de | ![](https://img.shields.io/website/https/rss-bridge.mediani.de.svg) | [@sokai](https://github.com/sokai) | Hosted with Netcup, Germany |
-| ![](https://iplookup.flagfox.net/images/h16/PL.png) | https://rss.foxhaven.cyou| ![](https://img.shields.io/badge/website-up-brightgreen) | [@Aysilu](https://foxhaven.cyou) | Hosted with Timeweb (Maintained in Poland) |
-| ![](https://iplookup.flagfox.net/images/h16/PL.png) | https://rss.m3wz.su| ![](https://img.shields.io/badge/website-up-brightgreen) | [@m3oweezed](https://m3wz.su/en/about) | Poland, Hosted with Timeweb Cloud |
 | ![](https://iplookup.flagfox.net/images/h16/DE.png) | https://rb.ash.fail | ![](https://img.shields.io/website/https/rb.ash.fail.svg) | [@ash](https://ash.fail/contact.html) | Hosted with Hostaris, Germany
 | ![](https://iplookup.flagfox.net/images/h16/UA.png) | https://rss.noleron.com | ![](https://img.shields.io/website/https/rss.noleron.com) | [@ihor](https://noleron.com/about) | Hosted with Hosting Ukraine, Ukraine
 | ![](https://iplookup.flagfox.net/images/h16/IN.png) | https://rssbridge.projectsegfau.lt | ![](https://img.shields.io/website/https/rssbridge.projectsegfau.lt) | [@gi-yt](https://aryak.me) | Self-Hosted at Mumbai, India with Airtel (ISP) |
+| ![](https://iplookup.flagfox.net/images/h16/US.png) | https://rb.vern.cc | ![](https://img.shields.io/website/https/rb.vern.cc.svg) | [@vern.cc](https://vern.cc/en/admin) | Hosted with Hetzner, US |
+| ![](https://iplookup.flagfox.net/images/h16/RO.png) | https://rss.bloat.cat | ![](https://img.shields.io/website/https/rss.bloat.cat) | [@vlnst](https://bloat.cat/contact) | Hosted with Kyun, Romania |
 
 
 ## Inactive instances
@@ -32,4 +32,3 @@
 | Country | Address | Status |  Contact | Comment |
 |:-------:|---------|--------|----------|---------|
 | ![](https://iplookup.flagfox.net/images/h16/FI.png) | https://rss-bridge.snopyta.org | ![](https://img.shields.io/website/https/rss-bridge.snopyta.org.svg) | [@Perflyst](https://github.com/Perflyst) | Hosted in Helsinki, Finland |
-| ![](https://iplookup.flagfox.net/images/h16/US.png) | http://rb.vern.cc/ | ![](https://img.shields.io/website/https/rb.vern.cc.svg) | [@vern.cc](https://vern.cc/en/admin) | Hosted with Hetzner, US |

From 0eac7a078479eac48be6c841a79f77ff04f429a8 Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Sun, 16 Jun 2024 13:16:42 +0200
Subject: [PATCH 403/716] [HeiseBridge] Remove lost+found icon

Remove the icon visible in l+f articles, e.g.
https://www.heise.de/news/l-f-DISGOMOJI-die-Linux-Malware-die-auf-Emojis-steht-9765024.html

Using a css selector in the form img[alt*="l+f"] was tried, but is not
supported by the used library.
---
 bridges/HeiseBridge.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/bridges/HeiseBridge.php b/bridges/HeiseBridge.php
index e26a4607..82c1f1aa 100644
--- a/bridges/HeiseBridge.php
+++ b/bridges/HeiseBridge.php
@@ -166,6 +166,11 @@ class HeiseBridge extends FeedExpander
         ) {
             $element->remove();
         }
+        foreach ($article->find('img') as $element) {
+            if (str_contains($element->alt, 'l+f')) {
+                $element->remove();
+            }
+        }
         // reload html, as remove() is buggy
         $article = str_get_html($article->outertext);
 

From 206bebc7bdf90b00b2457a5693fe07079b3df40a Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 18 Jun 2024 20:22:46 +0200
Subject: [PATCH 404/716] ci: disallow the sizeof function in linter (#4134)

---
 bridges/DiarioDoAlentejoBridge.php |  2 +-
 bridges/GameBananaBridge.php       |  2 +-
 bridges/ItakuBridge.php            | 28 ++++++++++++++--------------
 bridges/MagellantvBridge.php       |  2 +-
 bridges/PatreonBridge.php          |  2 +-
 bridges/PresidenciaPTBridge.php    |  2 +-
 bridges/VieDeMerdeBridge.php       |  2 +-
 phpcs.xml                          |  8 ++++++++
 8 files changed, 28 insertions(+), 20 deletions(-)

diff --git a/bridges/DiarioDoAlentejoBridge.php b/bridges/DiarioDoAlentejoBridge.php
index 9b82b49f..0bd0f1d4 100644
--- a/bridges/DiarioDoAlentejoBridge.php
+++ b/bridges/DiarioDoAlentejoBridge.php
@@ -47,7 +47,7 @@ class DiarioDoAlentejoBridge extends BridgeAbstract
                 }, self::PT_MONTH_NAMES),
                 array_map(function ($num) {
                     return sprintf('-%02d-', $num);
-                }, range(1, sizeof(self::PT_MONTH_NAMES))),
+                }, range(1, count(self::PT_MONTH_NAMES))),
                 $element->find('span.date', 0)->innertext
             );
 
diff --git a/bridges/GameBananaBridge.php b/bridges/GameBananaBridge.php
index 88b19ef0..0f04f56b 100644
--- a/bridges/GameBananaBridge.php
+++ b/bridges/GameBananaBridge.php
@@ -83,7 +83,7 @@ class GameBananaBridge extends BridgeAbstract
             }
 
             // Get updates from element[8], if applicable
-            if ($this->getInput('updates') && sizeof($element[8]) > 0) {
+            if ($this->getInput('updates') && count($element[8]) > 0) {
                 $update = $element[8][0];
                 $item['content'] .= '<br><strong>Update:</strong> ' . $update['_sTitle'];
                 if ($update['_sText'] != '') {
diff --git a/bridges/ItakuBridge.php b/bridges/ItakuBridge.php
index 0577752c..4f414574 100644
--- a/bridges/ItakuBridge.php
+++ b/bridges/ItakuBridge.php
@@ -347,17 +347,17 @@ class ItakuBridge extends BridgeAbstract
         $url = self::URI . "/api/galleries/images/?by_following=false&date_range={$opt['range']}&ordering={$opt['order']}&is_video={$opt['video_only']}";
         $url .= "&text={$opt['text']}&visibility=PUBLIC&visibility=PROFILE_ONLY&page=1&page_size=30&format=json";
 
-        if (sizeof($opt['optional_tags']) > 0) {
+        if (count($opt['optional_tags']) > 0) {
             foreach ($opt['optional_tags'] as $tag) {
                 $url .= "&optional_tags=$tag";
             }
         }
-        if (sizeof($opt['negative_tags']) > 0) {
+        if (count($opt['negative_tags']) > 0) {
             foreach ($opt['negative_tags'] as $tag) {
                 $url .= "&negative_tags=$tag";
             }
         }
-        if (sizeof($opt['required_tags']) > 0) {
+        if (count($opt['required_tags']) > 0) {
             foreach ($opt['required_tags'] as $tag) {
                 $url .= "&required_tags=$tag";
             }
@@ -381,17 +381,17 @@ class ItakuBridge extends BridgeAbstract
         $url = self::URI . "/api/posts/?by_following=false&date_range={$opt['range']}&ordering={$opt['order']}";
         $url .= '&visibility=PUBLIC&visibility=PROFILE_ONLY&page=1&page_size=30&format=json';
 
-        if (sizeof($opt['optional_tags']) > 0) {
+        if (count($opt['optional_tags']) > 0) {
             foreach ($opt['optional_tags'] as $tag) {
                 $url .= "&optional_tags=$tag";
             }
         }
-        if (sizeof($opt['negative_tags']) > 0) {
+        if (count($opt['negative_tags']) > 0) {
             foreach ($opt['negative_tags'] as $tag) {
                 $url .= "&negative_tags=$tag";
             }
         }
-        if (sizeof($opt['required_tags']) > 0) {
+        if (count($opt['required_tags']) > 0) {
             foreach ($opt['required_tags'] as $tag) {
                 $url .= "&required_tags=$tag";
             }
@@ -446,7 +446,7 @@ class ItakuBridge extends BridgeAbstract
 
     private function getPost($id, array $metadata = null)
     {
-        if (isset($metadata) && sizeof($metadata['gallery_images']) < $metadata['num_images']) {
+        if (isset($metadata) && count($metadata['gallery_images']) < $metadata['num_images']) {
             $metadata = null; //force re-fetch of metadata
         }
         $uri = self::URI . '/posts/' . $id;
@@ -457,7 +457,7 @@ class ItakuBridge extends BridgeAbstract
         $content_str = nl2br($data['content']);
         $content = "<p>{$content_str}</p><br/>"; //TODO: Add link and itaku user mention detection and convert into links.
 
-        if (array_key_exists('tags', $data) && sizeof($data['tags']) > 0) {
+        if (array_key_exists('tags', $data) && count($data['tags']) > 0) {
             $tag_types = [
                 'ARTIST' => '',
                 'COPYRIGHT' => '',
@@ -479,7 +479,7 @@ class ItakuBridge extends BridgeAbstract
             }
         }
 
-        if (sizeof($data['folders']) > 0) {
+        if (count($data['folders']) > 0) {
             $content .= '📁 In Folder(s): ';
             foreach ($data['folders'] as $folder) {
                 $url = self::URI . '/profile/' . $data['owner_username'] . '/posts/' . $folder['id'];
@@ -488,7 +488,7 @@ class ItakuBridge extends BridgeAbstract
         }
 
         $content .= '<hr/>';
-        if (sizeof($data['gallery_images']) > 0) {
+        if (count($data['gallery_images']) > 0) {
             foreach ($data['gallery_images'] as $media) {
                 $title = $media['title'];
                 $url = self::URI . '/images/' . $media['id'];
@@ -529,7 +529,7 @@ class ItakuBridge extends BridgeAbstract
         $content_str = nl2br($data['description']);
         $content = "<p>{$content_str}</p><br>"; //TODO: Add link and itaku user mention detection and convert into links.
 
-        if (array_key_exists('tags', $data) && sizeof($data['tags']) > 0) {
+        if (array_key_exists('tags', $data) && count($data['tags']) > 0) {
             // $content .= "🏷 Tag(s): ";
             $tag_types = [
                 'ARTIST' => '',
@@ -552,7 +552,7 @@ class ItakuBridge extends BridgeAbstract
             }
         }
 
-        if (array_key_exists('reference_gallery_sections', $data) && sizeof($data['reference_gallery_sections']) > 0) {
+        if (array_key_exists('reference_gallery_sections', $data) && count($data['reference_gallery_sections']) > 0) {
             $content .= '📁 Example folder(s): ';
             foreach ($data['folders'] as $folder) {
                 $url = self::URI . '/profile/' . $data['owner_username'] . '/gallery/' . $folder['id'];
@@ -601,7 +601,7 @@ class ItakuBridge extends BridgeAbstract
         $content_str = nl2br($data['description']);
         $content = "<p>{$content_str}</p><br/>"; //TODO: Add link and itaku user mention detection and convert into links.
 
-        if (array_key_exists('tags', $data) && sizeof($data['tags']) > 0) {
+        if (array_key_exists('tags', $data) && count($data['tags']) > 0) {
             // $content .= "🏷 Tag(s): ";
             $tag_types = [
                 'ARTIST' => '',
@@ -624,7 +624,7 @@ class ItakuBridge extends BridgeAbstract
             }
         }
 
-        if (array_key_exists('sections', $data) && sizeof($data['sections']) > 0) {
+        if (array_key_exists('sections', $data) && count($data['sections']) > 0) {
             $content .= '📁 In Folder(s): ';
             foreach ($data['sections'] as $folder) {
                 $url = self::URI . '/profile/' . $data['owner_username'] . '/gallery/' . $folder['id'];
diff --git a/bridges/MagellantvBridge.php b/bridges/MagellantvBridge.php
index b1f0403e..0a225160 100644
--- a/bridges/MagellantvBridge.php
+++ b/bridges/MagellantvBridge.php
@@ -63,7 +63,7 @@ class MagellantvBridge extends BridgeAbstract
 
         // Check whether items exists
         $article_list = $dom->find('div.articlePreview_preview-card__mLMOm');
-        if (sizeof($article_list) == 0) {
+        if (count($article_list) == 0) {
             throw new Exception(sprintf('Unable to find css selector on `%s`', $url));
         }
 
diff --git a/bridges/PatreonBridge.php b/bridges/PatreonBridge.php
index a2162425..895a9306 100644
--- a/bridges/PatreonBridge.php
+++ b/bridges/PatreonBridge.php
@@ -228,7 +228,7 @@ class PatreonBridge extends BridgeAbstract
             //post attachments
             if (
                 isset($post->relationships->attachments->data) &&
-                sizeof($post->relationships->attachments->data) > 0
+                count($post->relationships->attachments->data) > 0
             ) {
                 $item['enclosures'] = [];
                 $item['content'] .= '<hr><p><b>Attachments:</b><ul>';
diff --git a/bridges/PresidenciaPTBridge.php b/bridges/PresidenciaPTBridge.php
index 052b2751..247e8fce 100644
--- a/bridges/PresidenciaPTBridge.php
+++ b/bridges/PresidenciaPTBridge.php
@@ -76,7 +76,7 @@ class PresidenciaPTBridge extends BridgeAbstract
                         }, self::PT_MONTH_NAMES),
                         array_map(function ($num) {
                             return sprintf('-%02d-', $num);
-                        }, range(1, sizeof(self::PT_MONTH_NAMES))),
+                        }, range(1, count(self::PT_MONTH_NAMES))),
                         $edt
                     );
 
diff --git a/bridges/VieDeMerdeBridge.php b/bridges/VieDeMerdeBridge.php
index 9e6166fb..be384157 100644
--- a/bridges/VieDeMerdeBridge.php
+++ b/bridges/VieDeMerdeBridge.php
@@ -26,7 +26,7 @@ class VieDeMerdeBridge extends BridgeAbstract
 
         $html = getSimpleHTMLDOM(self::URI, []);
         $quotes = $html->find('article.bg-white');
-        if (sizeof($quotes) === 0) {
+        if (count($quotes) === 0) {
             return;
         }
 
diff --git a/phpcs.xml b/phpcs.xml
index bd1aca28..9e393a13 100644
--- a/phpcs.xml
+++ b/phpcs.xml
@@ -35,6 +35,14 @@
     </properties>
   </rule>
 
+  <rule ref="Generic.PHP.ForbiddenFunctions">
+    <properties>
+      <property name="forbiddenFunctions" type="array">
+        <element key="sizeof" value="count"/>
+      </property>
+    </properties>
+  </rule>
+
   <!-- Duplicate class names are not allowed -->
   <rule ref="Generic.Classes.DuplicateClassName"/>
 

From 00074b9bfc4c1ed3174b83d2f33015a1dc240464 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 18 Jun 2024 20:55:05 +0200
Subject: [PATCH 405/716] fix: dont remove www from anchors in DOM, fix #4114
 (#4135)

---
 static/rss-bridge.js | 20 +++++---------------
 1 file changed, 5 insertions(+), 15 deletions(-)

diff --git a/static/rss-bridge.js b/static/rss-bridge.js
index b9b466d6..9cd004cb 100644
--- a/static/rss-bridge.js
+++ b/static/rss-bridge.js
@@ -1,21 +1,14 @@
 function rssbridge_list_search() {
-    function remove_www_from_url(url) {
-        if (url.hostname.indexOf('www.') === 0) {
-            url.hostname = url.hostname.substr(4);
-        }
-    }
-
     var search = document.getElementById('searchfield').value;
-    var searchAsUrl = document.createElement('a');
-    searchAsUrl.href = search;
-    remove_www_from_url(searchAsUrl);
+
     var bridgeCards = document.querySelectorAll('section.bridge-card');
     for (var i = 0; i < bridgeCards.length; i++) {
         var bridgeName = bridgeCards[i].getAttribute('data-ref');
         var bridgeShortName = bridgeCards[i].getAttribute('data-short-name');
         var bridgeDescription = bridgeCards[i].querySelector('.description');
-        var bridgeUrl = bridgeCards[i].getElementsByTagName('a')[0];
-        remove_www_from_url(bridgeUrl);
+        var bridgeUrlElement = bridgeCards[i].getElementsByTagName('a')[0];
+        var bridgeUrl = bridgeUrlElement.toString();
+
         bridgeCards[i].style.display = 'none';
         if (!bridgeName || !bridgeUrl) {
             continue;
@@ -30,10 +23,7 @@ function rssbridge_list_search() {
         if (bridgeDescription.textContent.match(searchRegex)) {
             bridgeCards[i].style.display = 'block';
         }
-        if (bridgeUrl.toString().match(searchRegex)) {
-            bridgeCards[i].style.display = 'block';
-        }
-        if (bridgeUrl.hostname === searchAsUrl.hostname) {
+        if (bridgeUrl.match(searchRegex)) {
             bridgeCards[i].style.display = 'block';
         }
     }

From d60f0b0e74278db9d30b50e40533d92d92c079ec Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 18 Jun 2024 21:12:29 +0200
Subject: [PATCH 406/716] feat(FilterBridge): custom feed name parameter
 (#4136)

fix #4100
---
 bridges/FilterBridge.php | 21 +++++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/bridges/FilterBridge.php b/bridges/FilterBridge.php
index 3448a8c7..a1066fb5 100644
--- a/bridges/FilterBridge.php
+++ b/bridges/FilterBridge.php
@@ -15,6 +15,12 @@ class FilterBridge extends FeedExpander
             'exampleValue' => 'https://lorem-rss.herokuapp.com/feed?unit=day',
             'required' => true,
         ],
+        'name' => [
+            'name'          => 'Feed name (optional)',
+            'type'          => 'text',
+            'exampleValue'  => 'My feed',
+            'required'      => false,
+        ],
         'filter' => [
             'name' => 'Filter (regular expression!!!)',
             'required' => false,
@@ -158,11 +164,18 @@ class FilterBridge extends FeedExpander
     public function getURI()
     {
         $url = $this->getInput('url');
-
-        if (empty($url)) {
-            $url = parent::getURI();
+        if ($url) {
+            return $url;
         }
+        return parent::getURI();
+    }
 
-        return $url;
+    public function getName()
+    {
+        $name = $this->getInput('name');
+        if ($name) {
+            return $name;
+        }
+        return parent::getName();
     }
 }

From 2a84350cb2bf4d62111c0294e71d56302714ee63 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Fri, 21 Jun 2024 09:47:34 -0400
Subject: [PATCH 407/716] [HumbleBundleBridge] Create new bridge (#4139)

* [HumbleBundleBridge] Create new bridge

* [HumbleBundleBridge] Use less redundant bundle type handling
---
 bridges/HumbleBundleBridge.php | 68 ++++++++++++++++++++++++++++++++++
 1 file changed, 68 insertions(+)
 create mode 100644 bridges/HumbleBundleBridge.php

diff --git a/bridges/HumbleBundleBridge.php b/bridges/HumbleBundleBridge.php
new file mode 100644
index 00000000..42e025a5
--- /dev/null
+++ b/bridges/HumbleBundleBridge.php
@@ -0,0 +1,68 @@
+<?php
+
+class HumbleBundleBridge extends BridgeAbstract
+{
+    const NAME = 'Humble Bundle';
+    const MAINTAINER = 'phantop';
+    const URI = 'https://humblebundle.com/';
+    const DESCRIPTION = 'Returns bundles from Humble Bundle.';
+    const PARAMETERS = [[
+        'type' => [
+            'name' => 'Bundle type',
+            'type' => 'list',
+            'defaultValue' => 'bundles',
+            'values' => [
+                'All' => 'bundles',
+                'Books' => 'books',
+                'Games' => 'games',
+                'Software' => 'software',
+                ]
+            ]
+    ]];
+
+    public function collectData()
+    {
+        $page = getSimpleHTMLDOMCached($this->getURI());
+        $json_text = $page->find('#landingPage-json-data', 0)->innertext;
+        $json = json_decode(html_entity_decode($json_text), true)['data'];
+
+        $products = [];
+        $types = ['books', 'games', 'software'];
+        $types = $this->getInput('type') === 'bundles' ? $types : [$this->getInput('type')];
+        foreach ($types as $type) {
+            $products = array_merge($products, $json[$type]['mosaic'][0]['products']);
+        }
+
+        foreach ($products as $element) {
+            $item = [];
+            $item['author'] = $element['author'];
+            $item['timestamp'] = $element['start_date|datetime'];
+            $item['title'] = $element['tile_short_name'];
+            $item['uid'] = $element['machine_name'];
+            $item['uri'] = parent::getURI() . $element['product_url'];
+
+            $item['content'] = $element['marketing_blurb'];
+            $item['content'] .= '<br>' . $element['detailed_marketing_blurb'];
+
+            $item['categories'] = $element['hover_highlights'];
+            array_unshift($item['categories'], explode(':', $element['tile_name'])[0]);
+            array_unshift($item['categories'], $element['tile_stamp']);
+
+            $item['enclosures'] = [$element['tile_logo'], $element['high_res_tile_image']];
+            $this->items[] = $item;
+        }
+    }
+
+    public function getName()
+    {
+        $name = parent::getName();
+        $name .= $this->getInput('type') ? ' - ' . $this->getInput('type') : '';
+        return $name;
+    }
+
+    public function getURI()
+    {
+        $uri = parent::getURI() . $this->getInput('type');
+        return $uri;
+    }
+}

From adad9d6405efb1b19987bf6933ea8309b5f3c28e Mon Sep 17 00:00:00 2001
From: Thomas <mightymt@users.noreply.github.com>
Date: Mon, 24 Jun 2024 22:32:03 +0200
Subject: [PATCH 408/716] [YouTubeCommunityTabBridge] Improve JSON extraction
 (#4140)

Small change that should make the extraction of JSON from HTML work more
reliably
---
 bridges/YouTubeCommunityTabBridge.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/YouTubeCommunityTabBridge.php b/bridges/YouTubeCommunityTabBridge.php
index 0c145c02..284b81f9 100644
--- a/bridges/YouTubeCommunityTabBridge.php
+++ b/bridges/YouTubeCommunityTabBridge.php
@@ -32,7 +32,7 @@ class YouTubeCommunityTabBridge extends BridgeAbstract
     private $itemTitle = '';
 
     private $urlRegex = '/youtube\.com\/(channel|user|c)\/([\w]+)\/community/';
-    private $jsonRegex = '/var ytInitialData = (.*);<\/script>/';
+    private $jsonRegex = '/var ytInitialData = ([^<]*);<\/script>/';
 
     public function detectParameters($url)
     {
@@ -70,7 +70,7 @@ class YouTubeCommunityTabBridge extends BridgeAbstract
             $html = getSimpleHTMLDOM($this->feedUrl);
         }
 
-        $json = $this->extractJson($html->find('body', 0)->innertext);
+        $json = $this->extractJson($html->find('html', 0)->innertext);
 
         $this->feedName = $json->header->c4TabbedHeaderRenderer->title;
 

From d0c35146dd9b8b0625eacefb59402a16519b5c5f Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Sat, 29 Jun 2024 00:21:59 +0530
Subject: [PATCH 409/716] [HinduTamilBridge] Fix timestamp again (#4142)

---
 bridges/HinduTamilBridge.php | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/bridges/HinduTamilBridge.php b/bridges/HinduTamilBridge.php
index cab04171..1b556ed8 100644
--- a/bridges/HinduTamilBridge.php
+++ b/bridges/HinduTamilBridge.php
@@ -66,7 +66,7 @@ class HinduTamilBridge extends FeedExpander
 
         $date = $dom->find('p span.date', 1);
         if ($date) {
-            $item['timestamp'] = $date->innertext . ' IST';
+            $item['timestamp'] = $this->convertToRFC3339($date->plaintext);
         }
 
         $content = $dom->find('#pgContentPrint', 0);
@@ -88,4 +88,16 @@ class HinduTamilBridge extends FeedExpander
 
         return $content;
     }
+
+    private function convertToRFC3339($DateString)
+    {
+        $timestamp = strtotime(trim($DateString));
+
+        if ($timestamp !== false) {
+            $rfc3339DateTime = date('Y-m-d\TH:i:s', $timestamp) . '+05:30';
+            return $rfc3339DateTime;
+        } else {
+            return null;
+        }
+    }
 }

From 8bf153705463582d9949e21aaf167cb742b5c197 Mon Sep 17 00:00:00 2001
From: Niehztog <Niehztog@users.noreply.github.com>
Date: Thu, 4 Jul 2024 20:53:16 +0200
Subject: [PATCH 410/716] delete obsolete bridge (#4143)

---
 bridges/NiusBridge.php | 51 ------------------------------------------
 1 file changed, 51 deletions(-)
 delete mode 100644 bridges/NiusBridge.php

diff --git a/bridges/NiusBridge.php b/bridges/NiusBridge.php
deleted file mode 100644
index 0be6e89c..00000000
--- a/bridges/NiusBridge.php
+++ /dev/null
@@ -1,51 +0,0 @@
-<?php
-
-class NiusBridge extends XPathAbstract
-{
-    const NAME = 'Nius';
-    const URI = 'https://www.nius.de/news';
-    const DESCRIPTION = 'Die Stimme der Mehrheit';
-    const MAINTAINER = 'Niehztog';
-
-    const CACHE_TIMEOUT = 3600;
-
-    const FEED_SOURCE_URL = 'https://www.nius.de/news';
-    const XPATH_EXPRESSION_ITEM = './/div[contains(@class, "compact-story") or contains(@class, "regular-story")]';
-    const XPATH_EXPRESSION_ITEM_TITLE = './/h2[@class="title"]//node()';
-    const XPATH_EXPRESSION_ITEM_CONTENT = self::XPATH_EXPRESSION_ITEM_TITLE;
-    const XPATH_EXPRESSION_ITEM_URI = './/a[1]/@href';
-
-    const XPATH_EXPR_AUTHOR_PART1 = 'normalize-space(.//span[@class="author"]/text()[1])';
-    const XPATH_EXPR_AUTHOR_PART2 = 'normalize-space(.//span[@class="author"]/text()[2])';
-    const XPATH_EXPRESSION_ITEM_AUTHOR = 'substring-after(concat(' . self::XPATH_EXPR_AUTHOR_PART1 . ', " ", ' . self::XPATH_EXPR_AUTHOR_PART2 . '), " ")';
-
-    const XPATH_EXPRESSION_ITEM_ENCLOSURES = './/img[@sizes and @alt="Article background picture"]/@src';
-    const XPATH_EXPRESSION_ITEM_CATEGORIES = './/div[@class="subtitle"]/text()';
-    const SETTING_FIX_ENCODING = false;
-
-    public function getIcon()
-    {
-        return 'https://www.nius.de/favicon.ico';
-    }
-
-    protected function formatItemTitle($value)
-    {
-        return strip_tags($value);
-    }
-
-    protected function formatItemContent($value)
-    {
-        return strip_tags($value);
-    }
-
-    protected function cleanMediaUrl($mediaUrl)
-    {
-        $result = preg_match('~https:\/\/www\.nius\.de\/_next\/image\?url=(.*)\?~', $mediaUrl, $matches);
-        return $result ? $matches[1] . '#.jpg' : $mediaUrl;
-    }
-
-    protected function generateItemId(FeedItem $item)
-    {
-        return substr($item->getURI(), strrpos($item->getURI(), '/') + 1);
-    }
-}

From 4539eb69aa5f2bea3dde61687c08164062cba767 Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Thu, 4 Jul 2024 20:53:49 +0200
Subject: [PATCH 411/716] [GolemBridge] fix youtube links (#4144)

---
 bridges/GolemBridge.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bridges/GolemBridge.php b/bridges/GolemBridge.php
index b52d3c2f..7f59ee90 100644
--- a/bridges/GolemBridge.php
+++ b/bridges/GolemBridge.php
@@ -109,10 +109,10 @@ class GolemBridge extends FeedExpander
         //built youtube iframes
         foreach ($article->find('.embedcontent') as &$embedcontent) {
             $ytscript = $embedcontent->find('script', 0);
-            if (preg_match('/www.youtube.com.*?\"/', $ytscript->innertext, $link)) {
-                $link = 'https://' . str_replace('\\', '', $link[0]);
+            if (preg_match('/(www.youtube.com.*?)\"/', $ytscript->innertext, $link)) {
+                $link = 'https://' . str_replace('\\', '', $link[1]);
                 $embedcontent->innertext .= <<<EOT
-                    <iframe width="560" height="315" src=$link title="YouTube video player" frameborder="0"
+                    <iframe width="560" height="315" src="$link" title="YouTube video player" frameborder="0"
                     allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
                     referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>';
                 EOT;

From da8cfdf1798e4fee09288b65bfc015775627875d Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Sat, 6 Jul 2024 02:09:47 +0530
Subject: [PATCH 412/716] [HinduTamilBridge] refactor (#4146)

* [HinduTamilBridge] refactor

* [HinduTamilBridge] fixed lint

* [HinduTamilBridge] fixed lint 2

* Update HinduTamilBridge.php
---
 bridges/HinduTamilBridge.php | 27 +++++++++++++--------------
 1 file changed, 13 insertions(+), 14 deletions(-)

diff --git a/bridges/HinduTamilBridge.php b/bridges/HinduTamilBridge.php
index 1b556ed8..d12f5131 100644
--- a/bridges/HinduTamilBridge.php
+++ b/bridges/HinduTamilBridge.php
@@ -63,18 +63,18 @@ class HinduTamilBridge extends FeedExpander
     protected function parseItem($item)
     {
         $dom = getSimpleHTMLDOMCached($item['uri']);
-
-        $date = $dom->find('p span.date', 1);
-        if ($date) {
-            $item['timestamp'] = $this->convertToRFC3339($date->plaintext);
-        }
-
         $content = $dom->find('#pgContentPrint', 0);
-        if (!$content) {
+
+        if ($content === null) {
             return $item;
         }
 
-        $image = $dom->find('#LoadArticle figure', 0);
+        $date = $dom->find('p span.date', 1);
+        if ($date) {
+            $item['timestamp'] = $this->toRFC3339($date->plaintext);
+        }
+
+        $image = $dom->find('#LoadArticle figure', 0) ?? '';
         $item['content'] = $image . $this->cleanContent($content);
 
         return $item;
@@ -89,15 +89,14 @@ class HinduTamilBridge extends FeedExpander
         return $content;
     }
 
-    private function convertToRFC3339($DateString)
+    private function toRFC3339($dateString)
     {
-        $timestamp = strtotime(trim($DateString));
+        $timestamp = strtotime(trim($dateString));
 
-        if ($timestamp !== false) {
-            $rfc3339DateTime = date('Y-m-d\TH:i:s', $timestamp) . '+05:30';
-            return $rfc3339DateTime;
-        } else {
+        if ($timestamp === false) {
             return null;
         }
+
+        return date('Y-m-d\TH:i:s', $timestamp) . '+05:30';
     }
 }

From f7ddbcd7335e3879c13035e98b1a40c32ff5a710 Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Sun, 28 Jul 2024 21:58:08 +0200
Subject: [PATCH 413/716] [GBAtemp] Fix title extraction (#4151)

Fix title extraction for news and reviews
---
 bridges/GBAtempBridge.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/GBAtempBridge.php b/bridges/GBAtempBridge.php
index 4aa04799..361e3f1d 100644
--- a/bridges/GBAtempBridge.php
+++ b/bridges/GBAtempBridge.php
@@ -31,7 +31,7 @@ class GBAtempBridge extends BridgeAbstract
                     $img = $this->findItemImage($newsItem, 'a.news_image');
                     $time = $this->findItemDate($newsItem);
                     $author = $newsItem->find('a.username', 0)->plaintext;
-                    $title = $this->decodeHtmlEntities($newsItem->find('h3.news_title', 0)->plaintext);
+                    $title = $this->decodeHtmlEntities($newsItem->find('h2.news_title', 0)->plaintext);
                     $content = $this->fetchPostContent($url, self::URI);
                     $this->items[] = $this->buildItem($url, $title, $author, $time, $img, $content);
                     unset($newsItem); // Some items are heavy, freeing the item proactively helps saving memory
@@ -41,7 +41,7 @@ class GBAtempBridge extends BridgeAbstract
                 foreach ($html->find('li.portal_review') as $reviewItem) {
                     $url = urljoin(self::URI, $reviewItem->find('a.review_boxart', 0)->href);
                     $img = $this->findItemImage($reviewItem, 'a.review_boxart');
-                    $title = $this->decodeHtmlEntities($reviewItem->find('h2.review_title', 0)->plaintext);
+                    $title = $this->decodeHtmlEntities($reviewItem->find('div.review_title', 0)->find('h2', 0)->plaintext);
                     $content = getSimpleHTMLDOMCached($url);
                     $author = $content->find('span.author--name', 0)->plaintext;
                     $time = $this->findItemDate($content);

From 00d524287141179ca591065ad7b8b23db4ffcaab Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Mon, 29 Jul 2024 01:30:36 +0530
Subject: [PATCH 414/716] [GithubTrendingBridge] Add support for spoken
 languages (#4149)

* [GithubTrendingBridge] Add support for spoken languages

* Update GithubTrendingBridge.php
---
 bridges/GithubTrendingBridge.php | 38 ++++++++++++++++++++++++++++----
 1 file changed, 34 insertions(+), 4 deletions(-)

diff --git a/bridges/GithubTrendingBridge.php b/bridges/GithubTrendingBridge.php
index 0f8e5e96..2ce47270 100644
--- a/bridges/GithubTrendingBridge.php
+++ b/bridges/GithubTrendingBridge.php
@@ -586,16 +586,18 @@ class GithubTrendingBridge extends BridgeAbstract
                     'Monthly' => 'monthly',
                 ],
                 'defaultValue' => 'today'
+            ],
+            'spokenLanguage' => [
+                'name' => 'Spoken Language Code',
+                'type' => 'text',
+                'exampleValue' => 'en',
             ]
         ]
-
     ];
 
     public function collectData()
     {
-        $params = ['since' => urlencode($this->getInput('date_range'))];
-        $url = self::URI . '/' . $this->getInput('language') . '?' . http_build_query($params);
-
+        $url = $this->constructUrl();
         $html = getSimpleHTMLDOM($url);
 
         $this->items = [];
@@ -630,4 +632,32 @@ class GithubTrendingBridge extends BridgeAbstract
 
         return parent::getName();
     }
+
+    private function constructUrl()
+    {
+        $url = self::URI;
+        $language = $this->getInput('language');
+        $dateRange = $this->getInput('date_range');
+        $spokenLanguage = $this->getInput('spokenLanguage');
+
+        if (!empty($language)) {
+            $url .= '/' . $language;
+        }
+
+        $queryParams = [];
+
+        if (!empty($dateRange)) {
+            $queryParams['since'] = $dateRange;
+        }
+
+        if (!empty($spokenLanguage)) {
+            $queryParams['spoken_language_code'] = trim($spokenLanguage);
+        }
+
+        if (!empty($queryParams)) {
+            $url .= '?' . http_build_query($queryParams);
+        }
+
+        return $url;
+    }
 }

From 376e711f0350698107a88d268c5f825ada593b41 Mon Sep 17 00:00:00 2001
From: "Dmitry R." <me@mazy.wtf>
Date: Sun, 28 Jul 2024 22:02:47 +0200
Subject: [PATCH 415/716] [NovayaGazetaEuropeBridge]: fix warnings (#4154)

---
 bridges/NovayaGazetaEuropeBridge.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/bridges/NovayaGazetaEuropeBridge.php b/bridges/NovayaGazetaEuropeBridge.php
index ec288f2b..89d31a94 100644
--- a/bridges/NovayaGazetaEuropeBridge.php
+++ b/bridges/NovayaGazetaEuropeBridge.php
@@ -41,6 +41,9 @@ class NovayaGazetaEuropeBridge extends BridgeAbstract
         $data = json_decode($json);
 
         foreach ($data->records as $record) {
+            if (!isset($record->blocks)) {
+                continue;
+            }
             foreach ($record->blocks as $block) {
                 if (!property_exists($block, 'date')) {
                     continue;

From 049af3cef77721fe2d999c7ecefe899116779f82 Mon Sep 17 00:00:00 2001
From: Tostiman <18124323+t0stiman@users.noreply.github.com>
Date: Sun, 28 Jul 2024 22:03:35 +0200
Subject: [PATCH 416/716] [HardwareInfoBridge] delete bridge for discontinued
 website (#4124)

---
 bridges/HardwareInfoBridge.php | 66 ----------------------------------
 1 file changed, 66 deletions(-)
 delete mode 100644 bridges/HardwareInfoBridge.php

diff --git a/bridges/HardwareInfoBridge.php b/bridges/HardwareInfoBridge.php
deleted file mode 100644
index dc32c33a..00000000
--- a/bridges/HardwareInfoBridge.php
+++ /dev/null
@@ -1,66 +0,0 @@
-<?php
-
-class HardwareInfoBridge extends FeedExpander
-{
-    const NAME = 'Hardware Info Bridge';
-    const URI = 'https://nl.hardware.info/';
-    const DESCRIPTION = 'Tech news from hardware.info (Dutch)';
-    const MAINTAINER = 't0stiman';
-    const DONATION_URI = 'https://ko-fi.com/tostiman';
-
-    public function collectData()
-    {
-        $this->collectExpandableDatas('https://nl.hardware.info/updates/all.rss', 10);
-    }
-
-    protected function parseItem(array $item)
-    {
-        $itemUrl = $item['uri'];
-        $articlePage = getSimpleHTMLDOMCached($itemUrl);
-
-        $article = $articlePage->find('div.article__content', 0);
-
-        //everything under the social bar is not part of the article, remove it
-        $reachedEndOfArticle = false;
-
-        foreach ($article->find('*') as $child) {
-            if (
-                !$reachedEndOfArticle && isset($child->attr['class'])
-                && $child->attr['class'] == 'article__content__social-bar'
-            ) {
-                $reachedEndOfArticle = true;
-            }
-
-            if ($reachedEndOfArticle) {
-                $child->outertext = '';
-            }
-        }
-
-        //get rid of some more elements we don't need
-        $to_remove_selectors = [
-        'script',
-        'div.incontent',
-        'div.article__content__social-bar',
-        'div#revealNewsTip',
-        'div.article__previous_next'
-        ];
-
-        foreach ($to_remove_selectors as $selector) {
-            foreach ($article->find($selector) as $found) {
-                $found->outertext = '';
-            }
-        }
-
-        // convert iframes to links. meant for embedded YouTube videos.
-        foreach ($article->find('iframe') as $found) {
-            $iframeUrl = $found->getAttribute('src');
-
-            if ($iframeUrl) {
-                $found->outertext = '<a href="' . $iframeUrl . '">' . $iframeUrl . '</a>';
-            }
-        }
-
-        $item['content'] = $article;
-        return $item;
-    }
-}

From 2fcba49433886ef2e1237f1bd256aadcea494309 Mon Sep 17 00:00:00 2001
From: enwuenwu <108224417+enwuenwu@users.noreply.github.com>
Date: Sun, 28 Jul 2024 20:11:48 +0000
Subject: [PATCH 417/716] [Mailman2Bridge] fix message separation and improve
 "From_ lines" disambiguation   (#4156)

* [Mailman2Bridge.php] enable PCRE_MULTILINE pattern modifier

Enable PCRE_MULTILINE pattern modifier on mbox content parsing. Without it parsing monthly archives results in only a single message each.

* [Mailman2Bridge.php] extend mbox "From_ lines" pattern

Extend PCRE pattern matching individual "From_ lines" used to split single messages in mbox content.

In addition to the matching line having to start with 'From ' it now also has to end with time and date (hh:mm:ss yyyy).

This makes the pattern slightly more robust against accidental matches when a line within the actual message body starts with 'From ' which Mailman 2 (Pipermail) may not be configured to disambiguate.

* [Mailman2Bridge.php] remove trailing slash from URI constant

---------

Co-authored-by: enwu <108224417+8279279374@users.noreply.github.com>
---
 bridges/Mailman2Bridge.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/Mailman2Bridge.php b/bridges/Mailman2Bridge.php
index ad0d8110..6b620c03 100644
--- a/bridges/Mailman2Bridge.php
+++ b/bridges/Mailman2Bridge.php
@@ -3,7 +3,7 @@
 class Mailman2Bridge extends BridgeAbstract
 {
     const NAME = 'Mailman2Bridge';
-    const URI = 'https://list.org/';
+    const URI = 'https://list.org';
     const MAINTAINER = 'imagoiq';
     const CACHE_TIMEOUT = 60 * 30; // 30m
     const DESCRIPTION = 'Fetch latest messages from Mailman 2 archive (Pipermail)';
@@ -68,7 +68,7 @@ class Mailman2Bridge extends BridgeAbstract
                     throw new \Exception('Failed to gzdecode');
                 }
             }
-            $mboxParts = preg_split('/^From /', $data);
+            $mboxParts = preg_split('/^From\s.+\d{2}:\d{2}:\d{2}\s\d{4}$/m', $data);
             // Drop the first element which is always an empty string
             array_shift($mboxParts);
             $mboxMails = array_reverse($mboxParts);

From a1b3e596fc24845d5c74a80c061bf3eee94618c0 Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Sun, 28 Jul 2024 22:21:14 +0200
Subject: [PATCH 418/716] [AnisearchBridge.php] fixed youtube link (#4159)

$trailer->{'data-xsrc'} wasn't read correctly in EOT context
---
 bridges/AnisearchBridge.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/bridges/AnisearchBridge.php b/bridges/AnisearchBridge.php
index d5aad1c9..869b3049 100644
--- a/bridges/AnisearchBridge.php
+++ b/bridges/AnisearchBridge.php
@@ -68,8 +68,9 @@ class AnisearchBridge extends BridgeAbstract
                 if (isset($trailerlink)) {
                     $trailersite = getSimpleHTMLDOM($baseurl . $trailerlink->href);
                     $trailer = $trailersite->find('div#player > iframe', 0);
+                    $trailer = $trailer->{'data-xsrc'};
                     $ytlink = <<<EOT
-                        <br /><iframe width="560" height="315" src="' . $trailer->{'data-xsrc'} . '" title="YouTube video player"
+                        <br /><iframe width="560" height="315" src="$trailer" title="YouTube video player"
                         frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
                         referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>';
                     EOT;

From bba225dfe85e8db237df114991657708ec4210c0 Mon Sep 17 00:00:00 2001
From: Eugene Molotov <eugene.molotov@yandex.ru>
Date: Mon, 29 Jul 2024 01:33:48 +0500
Subject: [PATCH 419/716] [RutubeBridge] New option to fetch video from search
 results (#4162)

---
 bridges/RutubeBridge.php | 31 ++++++++++++++++++++++++++++++-
 1 file changed, 30 insertions(+), 1 deletion(-)

diff --git a/bridges/RutubeBridge.php b/bridges/RutubeBridge.php
index 452dbde4..6ec830aa 100644
--- a/bridges/RutubeBridge.php
+++ b/bridges/RutubeBridge.php
@@ -24,6 +24,13 @@ class RutubeBridge extends BridgeAbstract
                 'required' => true
             ],
         ],
+        'По результатам поиска' => [
+            's' => [
+                'name' => 'Запрос',
+                'exampleValue' => 'SUREN',
+                'required' => true,
+            ]
+        ]
     ];
 
     protected $title;
@@ -34,6 +41,8 @@ class RutubeBridge extends BridgeAbstract
             return self::URI . '/channel/' . strval($this->getInput('c')) . '/videos/';
         } elseif ($this->getInput('p')) {
             return self::URI . '/plst/' . strval($this->getInput('p')) . '/';
+        } elseif ($this->getInput('s')) {
+            return self::URI . '/search/?suggest=1&query=' . strval($this->getInput('s'));
         } else {
             return parent::getURI();
         }
@@ -60,7 +69,7 @@ class RutubeBridge extends BridgeAbstract
         return json_decode(str_replace('\x', '\\\x', $matches[1]));
     }
 
-    public function collectData()
+    private function getVideosFromReduxState()
     {
         $link = $this->getURI();
 
@@ -73,6 +82,26 @@ class RutubeBridge extends BridgeAbstract
         } elseif ($this->getInput('p')) {
             $videos = $reduxState->playlist->data->results;
             $this->title = $reduxState->playlist->title;
+        } elseif ($this->getInput('s')) {
+            $this->title = 'Поиск ' . $this->getInput('s');
+        }
+
+        return $videos;
+    }
+
+    private function getVideosFromSearchAPI()
+    {
+        $contents = getContents(self::URI . '/api/search/video/?suggest=1&client=wdp&query=' . $this->getInput('s'));
+        $json = json_decode($contents);
+        return $json->results;
+    }
+
+    public function collectData()
+    {
+        if ($this->getInput('c') || $this->getInput('p')) {
+            $videos = $this->getVideosFromReduxState();
+        } else {
+            $videos = $this->getVideosFromSearchAPI();
         }
 
         foreach ($videos as $video) {

From d28a0fd94b0f863cf630e327ed5ad646a05909b9 Mon Sep 17 00:00:00 2001
From: Eugene Molotov <eugene.molotov@yandex.ru>
Date: Mon, 29 Jul 2024 01:34:12 +0500
Subject: [PATCH 420/716] [Vk2Bridge] Handling albums (#4163)

---
 bridges/Vk2Bridge.php | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/bridges/Vk2Bridge.php b/bridges/Vk2Bridge.php
index 0bc0879f..6fecba84 100644
--- a/bridges/Vk2Bridge.php
+++ b/bridges/Vk2Bridge.php
@@ -168,6 +168,12 @@ class Vk2Bridge extends BridgeAbstract
                         $ret .= "* {$text}: {$votes} ({$rate}%)<br />";
                     }
                     $ret .= '</p>';
+                } elseif ($attachment['type'] == 'album') {
+                    $album = $attachment['album'];
+                    $url = "https://vk.com/album{$album['owner_id']}_{$album['id']}";
+                    $title = 'Альбом: ' . $album['title'];
+                    $photo = $this->getImageURLWithLargestWidth($album['thumb']['sizes']);
+                    $ret .= "<p><a href='{$url}'><img src='{$photo}' alt='{$title}'><br>{$title}</a></p>";
                 } elseif (!in_array($attachment['type'], ['video', 'audio', 'doc'])) {
                     $ret .= "<p>Unknown attachment type: {$attachment['type']}</p>";
                 }

From f773878459c3c12ee01b09ef2a805c57760656ea Mon Sep 17 00:00:00 2001
From: Pavel Korytov <thexcloud@gmail.com>
Date: Sun, 28 Jul 2024 23:41:08 +0300
Subject: [PATCH 421/716] [EconomistWorldInBriefBridge] Add cookie to options
 (#4165)

* [EconomistWorldInBriefBridge] Add cookie

* [EconomistWorldInBriefBridge] Add docs

* [EconomistWorldInBriefBridge] Best-effort to work without cookie
---
 bridges/EconomistWorldInBriefBridge.php | 24 ++++++++++++++++++++++--
 docs/10_Bridge_Specific/Economist.md    | 18 ++++++++++++++++++
 2 files changed, 40 insertions(+), 2 deletions(-)
 create mode 100644 docs/10_Bridge_Specific/Economist.md

diff --git a/bridges/EconomistWorldInBriefBridge.php b/bridges/EconomistWorldInBriefBridge.php
index 47782a51..4e65b15f 100644
--- a/bridges/EconomistWorldInBriefBridge.php
+++ b/bridges/EconomistWorldInBriefBridge.php
@@ -9,6 +9,12 @@ class EconomistWorldInBriefBridge extends BridgeAbstract
     const CACHE_TIMEOUT = 3600; // 1 hour
     const DESCRIPTION = 'Returns stories from the World in Brief section';
 
+    const CONFIGURATION = [
+        'cookie' => [
+            'required' => false,
+        ]
+    ];
+
     const PARAMETERS = [
         '' => [
             'splitGobbets' => [
@@ -41,7 +47,19 @@ class EconomistWorldInBriefBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $html = getSimpleHTMLDOM(self::URI);
+        $headers = [];
+        if ($this->getOption('cookie')) {
+            $headers = [
+                'Authority: www.economist.com',
+                'Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7',
+                'Accept-language: en-US,en;q=0.9',
+                'Cache-control: max-age=0',
+                'Cookie: ' . $this->getOption('cookie'),
+                'Upgrade-insecure-requests: 1',
+                'User-agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36'
+            ];
+        }
+        $html = getSimpleHTMLDOM(self::URI, $headers);
         $gobbets = $html->find('._gobbets', 0);
         if ($this->getInput('splitGobbets') == 1) {
             $this->splitGobbets($gobbets);
@@ -50,7 +68,9 @@ class EconomistWorldInBriefBridge extends BridgeAbstract
         };
         if ($this->getInput('agenda') == 1) {
             $articles = $html->find('._articles', 0);
-            $this->collectArticles($articles);
+            if ($articles != null) {
+                $this->collectArticles($articles);
+            }
         }
         if ($this->getInput('quote') == 1) {
             $quote = $html->find('._quote-container', 0);
diff --git a/docs/10_Bridge_Specific/Economist.md b/docs/10_Bridge_Specific/Economist.md
new file mode 100644
index 00000000..1a792eb8
--- /dev/null
+++ b/docs/10_Bridge_Specific/Economist.md
@@ -0,0 +1,18 @@
+# EconomistWorldInBriefBridge
+
+In May 2024, The Economist finally fixed its paywall, and it started requiring authorization. Which means you can't use this bridge unless you have an active subscription.
+
+If you do, the way to use the bridge is to snitch a cookie:
+1. Log in to The Economist
+2. Open DevTools (Chrome DevTools or Firefox Developer Tools)
+2. Go to https://www.economist.com/the-world-in-brief
+3. In DevTools, go to the "Network" tab, there select the first request (`the-world-in-brief`) and copy the value of the `Cookie:` header from "Request Headers".
+
+The cookie lives three months.
+
+Once you've done this, add the cookie to your `config.ini.php`:
+
+```
+[EconomistWorldInBriefBridge]
+cookie = "<value>"
+```

From 8dd56bca051c69462fd1464d23336c8b07c2aee4 Mon Sep 17 00:00:00 2001
From: Christian Schabesberger <chris.schabesberger@mailbox.org>
Date: Sun, 28 Jul 2024 22:42:18 +0200
Subject: [PATCH 422/716] fix bulletpoints for nordbayern (#4166)

---
 bridges/NordbayernBridge.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/bridges/NordbayernBridge.php b/bridges/NordbayernBridge.php
index aa32f4ba..a5f34817 100644
--- a/bridges/NordbayernBridge.php
+++ b/bridges/NordbayernBridge.php
@@ -92,6 +92,8 @@ class NordbayernBridge extends BridgeAbstract
                 $content .= self::getUseFullContent($element);
             } elseif ($element->tag === 'picture') {
                 $content .= self::getValidImage($element);
+            } elseif ($element->tag === 'ul') {
+                $content .= $element;
             }
         }
         return $content;

From 955fb6f315ca86693b1b3185b47ef313168c6bd2 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Mon, 29 Jul 2024 00:18:28 +0200
Subject: [PATCH 423/716] fix(reddit): increase default cache ttl (#4168)

---
 bridges/RedditBridge.php | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index 7ece0e15..434ae74a 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -10,6 +10,7 @@ class RedditBridge extends BridgeAbstract
     const MAINTAINER = 'dawidsowa';
     const NAME = 'Reddit Bridge';
     const URI = 'https://old.reddit.com';
+    const CACHE_TIMEOUT = 60 * 60 * 2; // 2h
     const DESCRIPTION = 'Return hot submissions from Reddit';
 
     const PARAMETERS = [
@@ -107,9 +108,8 @@ class RedditBridge extends BridgeAbstract
                 // 403 Forbidden
                 // This can possibly mean that reddit has permanently blocked this server's ip address
                 $this->cache->set($forbiddenKey, true, 60 * 61);
-            }
-            if ($e->getCode() === 429) {
-                $this->cache->set($rateLimitKey, true, 60 * 16);
+            } elseif ($e->getCode() === 429) {
+                $this->cache->set($rateLimitKey, true, 60 * 61);
             }
             throw $e;
         }
@@ -143,10 +143,14 @@ class RedditBridge extends BridgeAbstract
         $flareInput = $this->getInput('f');
 
         foreach ($subreddits as $subreddit) {
-            $version = 'v0.0.1';
+            $version = 'v0.0.2';
             $useragent = "rss-bridge $version (https://github.com/RSS-Bridge/rss-bridge)";
             $url = self::createUrl($search, $flareInput, $subreddit, $user, $section, $this->queriedContext);
-            $json = getContents($url, ['User-Agent: ' . $useragent]);
+
+            $response = getContents($url, ['User-Agent: ' . $useragent], [], true);
+
+            $json = $response['content'];
+
             $parsedJson = Json::decode($json, false);
 
             foreach ($parsedJson->data->children as $post) {

From 6d81d6d3068a56e121c2c448f84f93874172c25c Mon Sep 17 00:00:00 2001
From: Zack Puhl <31320277+NotsoanoNimus@users.noreply.github.com>
Date: Mon, 29 Jul 2024 11:53:14 -0400
Subject: [PATCH 424/716] [RumbleBridge] Facelift, Validation, & Livestreams
 (#4160)

* [RumbleBridge] Facelift+media types (livestreams)

* [RumbleBridge] Remove 'required' from list input.

* [RumbleBridge] lint
---
 bridges/RumbleBridge.php | 49 +++++++++++++++++++++++++++++-----------
 1 file changed, 36 insertions(+), 13 deletions(-)

diff --git a/bridges/RumbleBridge.php b/bridges/RumbleBridge.php
index f6bfca7d..a8841e00 100644
--- a/bridges/RumbleBridge.php
+++ b/bridges/RumbleBridge.php
@@ -2,10 +2,10 @@
 
 class RumbleBridge extends BridgeAbstract
 {
-    const NAME = 'rumble.com bridge';
-    const URI = 'https://rumble.com';
-    const DESCRIPTION = 'Fetches the latest channel/user videos';
-    const MAINTAINER = 'dvikan';
+    const NAME = 'Rumble.com Bridge';
+    const URI = 'https://rumble.com/';
+    const DESCRIPTION = 'Fetches the latest channel/user videos and livestreams.';
+    const MAINTAINER = 'dvikan, NotsoanoNimus';
     const CACHE_TIMEOUT = 60 * 60; // 1h
     const PARAMETERS = [
         [
@@ -13,15 +13,19 @@ class RumbleBridge extends BridgeAbstract
                 'name' => 'Account',
                 'type' => 'text',
                 'required' => true,
+                'title' => 'Name of the target account to create into a feed.',
                 'defaultValue' => 'bjornandreasbullhansen',
             ],
             'type' => [
+                'name' => 'Account Type',
                 'type' => 'list',
-                'name' => 'Type',
+                'title' => 'The type of profile to create a feed from.',
                 'values' => [
-                    'Channel' => 'channel',
-                    'User' => 'user',
-                ]
+                    'Channel (All)' => 'channel',
+                    'Channel Videos' => 'channel-videos',
+                    'Channel Livestreams' => 'channel-livestream',
+                    'User (All)' => 'user',
+                ],
             ],
         ]
     ];
@@ -30,12 +34,28 @@ class RumbleBridge extends BridgeAbstract
     {
         $account = $this->getInput('account');
         $type = $this->getInput('type');
+        $url = self::getURI();
 
-        if ($type === 'channel') {
-            $url = "https://rumble.com/c/$account";
+        if (!preg_match('#^[\w\-_.@]+$#', $account) || strlen($account) > 64) {
+            throw new \Exception('Invalid target account.');
         }
-        if ($type === 'user') {
-            $url = "https://rumble.com/user/$account";
+
+        switch ($type) {
+            case 'user':
+                $url .= "user/$account";
+                break;
+            case 'channel':
+                $url .= "c/$account";
+                break;
+            case 'channel-videos':
+                $url .= "c/$account/videos";
+                break;
+            case 'channel-livestream':
+                $url .= "c/$account/livestreams";
+                break;
+            default:
+                // Shouldn't ever happen.
+                throw new \Exception('Invalid media type.');
         }
 
         $dom = getSimpleHTMLDOM($url);
@@ -57,6 +77,9 @@ class RumbleBridge extends BridgeAbstract
 
     public function getName()
     {
-        return 'Rumble.com ' . $this->getInput('account');
+        if ($this->getInput('account')) {
+            return 'Rumble.com - ' . $this->getInput('account');
+        }
+        return self::NAME;
     }
 }

From 22b39e3fcd75705db99f53b74eb03aa1e16d0fab Mon Sep 17 00:00:00 2001
From: Zack Puhl <31320277+NotsoanoNimus@users.noreply.github.com>
Date: Mon, 29 Jul 2024 11:53:39 -0400
Subject: [PATCH 425/716] [EBayBridge] Repair & Augment the eBay Feed (#4157)

* [EBayBridge]: discount details; fix DOM parsing

* [EBayBridge] Ending slash. No "www.ebay.commyhijack.net", for example.

* [EBayBridge] Trim discountLine details when set.

* [EBayBridge] Refactor and update content

* shameless self-addition to CONTRIBUTORS.md

* [EBayBridge] Toggle original search links w/ checkbox

* [EBayBridge] oops: fix introduced XSS vuln

* [EBayBridge] Fix linting error: use array_column

* [EBayBridge] fix compat with <php8
---
 CONTRIBUTORS.md        |   1 +
 bridges/EBayBridge.php | 118 +++++++++++++++++++++++++++++++----------
 2 files changed, 92 insertions(+), 27 deletions(-)

diff --git a/CONTRIBUTORS.md b/CONTRIBUTORS.md
index f1080743..922d9453 100644
--- a/CONTRIBUTORS.md
+++ b/CONTRIBUTORS.md
@@ -144,6 +144,7 @@
 * [Niehztog](https://github.com/Niehztog)
 * [NikNikYkt](https://github.com/NikNikYkt)
 * [Nono-m0le](https://github.com/Nono-m0le)
+* [NotsoanoNimus](https://github.com/NotsoanoNimus)
 * [obsiwitch](https://github.com/obsiwitch)
 * [Ololbu](https://github.com/Ololbu)
 * [ORelio](https://github.com/ORelio)
diff --git a/bridges/EBayBridge.php b/bridges/EBayBridge.php
index 87958164..11b90bf8 100644
--- a/bridges/EBayBridge.php
+++ b/bridges/EBayBridge.php
@@ -5,15 +5,21 @@ class EBayBridge extends BridgeAbstract
     const NAME = 'eBay';
     const DESCRIPTION = 'Returns the search results from the eBay auctioning platforms';
     const URI = 'https://www.eBay.com';
-    const MAINTAINER = 'wrobelda';
+    const MAINTAINER = 'NotsoanoNimus, wrobelda';
     const PARAMETERS = [[
         'url' => [
             'name' => 'Search URL',
             'title' => 'Copy the URL from your browser\'s address bar after searching for your items and paste it here',
-            'pattern' => '^(https:\/\/)?(www\.)?(befr\.|benl\.)?ebay\.(com|com\.au|at|be|ca|ch|cn|es|fr|de|com\.hk|ie|it|com\.my|nl|ph|pl|com\.sg|co\.uk).*$',
+            'pattern' => '^(https:\/\/)?(www\.)?(befr\.|benl\.)?ebay\.(com|com\.au|at|be|ca|ch|cn|es|fr|de|com\.hk|ie|it|com\.my|nl|ph|pl|com\.sg|co\.uk)\/.*$',
             'exampleValue' => 'https://www.ebay.com/sch/i.html?_nkw=atom+rss',
             'required' => true,
-        ]
+        ],
+        'includesSearchLink' => [
+            'name' => 'Include Original Search Link',
+            'title' => 'Whether or not each feed item should include the original search query link to eBay which was used to find the given listing.',
+            'type' => 'checkbox',
+            'defaultValue' => false,
+        ],
     ]];
 
     public function getURI()
@@ -23,6 +29,10 @@ class EBayBridge extends BridgeAbstract
             $uri = trim(preg_replace('/([?&])_sop=[^&]+(&|$)/', '$1', $this->getInput('url')), '?&/');
             $uri .= (parse_url($uri, PHP_URL_QUERY) ? '&' : '?') . '_sop=10';
 
+            // Ensure the List View is used instead of the Gallery View.
+            $uri = trim(preg_replace('/[?&]_dmd=[^&]+(&|$)/i', '$1', $uri), '?&/');
+            $uri .= '&_dmd=1';
+
             return $uri;
         } else {
             return parent::getURI();
@@ -46,7 +56,7 @@ class EBayBridge extends BridgeAbstract
         });
 
         if ($searchQuery) {
-            return $searchQuery[0];
+            return 'eBay - ' . $searchQuery[0];
         }
 
         return parent::getName();
@@ -61,44 +71,88 @@ class EBayBridge extends BridgeAbstract
             $inexactMatches->remove();
         }
 
+        // Remove "NEW LISTING" labels: we sort by the newest, so this is redundant.
+        foreach ($html->find('.LIGHT_HIGHLIGHT') as $new_listing_label) {
+            $new_listing_label->remove();
+        }
+
         $results = $html->find('ul.srp-results > li.s-item');
         foreach ($results as $listing) {
             $item = [];
 
-            // Remove "NEW LISTING" label, we sort by the newest, so this is redundant
-            foreach ($listing->find('.LIGHT_HIGHLIGHT') as $new_listing_label) {
-                $new_listing_label->remove();
+            // Define a closure to shorten the ugliness of querying the current listing.
+            $find = function ($query, $altText = '') use ($listing) {
+                return $listing->find($query, 0)->plaintext ?? $altText;
+            };
+
+            $item['title'] = $find('.s-item__title');
+            if (!$item['title']) {
+                // Skip entries where the title cannot be found (for w/e reason).
+                continue;
             }
 
-            $listingTitle = $listing->find('.s-item__title', 0);
-            if ($listingTitle) {
-                $item['title'] = $listingTitle->plaintext;
-            }
-
-            $subtitle = implode('', $listing->find('.s-item__subtitle'));
-
-            $listingUrl = $listing->find('.s-item__link', 0);
-            if ($listingUrl) {
-                $item['uri'] = $listingUrl->href;
+            // It appears there may be more than a single 'subtitle' subclass in the listing. Collate them.
+            $subtitles = $listing->find('.s-item__subtitle');
+            if (is_array($subtitles)) {
+                $subtitle = trim(implode(' ', array_column($subtitles, 'plaintext')));
             } else {
-                $item['uri'] = null;
+                $subtitle = trim($subtitles->plaintext ?? '');
             }
 
+            // Get the listing's link and uid.
+            $itemUri = $listing->find('.s-item__link', 0);
+            if ($itemUri) {
+                $item['uri'] = $itemUri->href;
+            }
             if (preg_match('/.*\/itm\/(\d+).*/i', $item['uri'], $matches)) {
                 $item['uid'] = $matches[1];
             }
 
-            $priceDom = $listing->find('.s-item__details > .s-item__detail > .s-item__price', 0);
-            $price = $priceDom->plaintext ?? 'N/A';
+            // Price should be fetched on its own so we can provide the alt text without complication.
+            $price = $find('.s-item__price', '[NO PRICE]');
 
-            $shippingFree = $listing->find('.s-item__details > .s-item__detail > .s-item__freeXDays', 0)->plaintext ?? '';
-            $localDelivery = $listing->find('.s-item__details > .s-item__detail > .s-item__localDelivery', 0)->plaintext ?? '';
-            $logisticsCost = $listing->find('.s-item__details > .s-item__detail > .s-item__logisticsCost', 0)->plaintext ?? '';
+            // Map a list of dynamic variable names to their subclasses within the listing.
+            //   This is just a bit of sugar to make this cleaner and more maintainable.
+            $propertyMappings = [
+                'additionalPrice'   => '.s-item__additional-price',
+                'discount'          => '.s-item__discount',
+                'shippingFree'      => '.s-item__freeXDays',
+                'localDelivery'     => '.s-item__localDelivery',
+                'logisticsCost'     => '.s-item__logisticsCost',
+                'location'          => '.s-item__location',
+                'obo'               => '.s-item__formatBestOfferEnabled',
+                'sellerInfo'        => '.s-item__seller-info-text',
+                'bids'              => '.s-item__bidCount',
+                'timeLeft'          => '.s-item__time-left',
+                'timeEnd'           => '.s-item__time-end',
+            ];
 
-            $location = $listing->find('.s-item__details > .s-item__detail > .s-item__location', 0)->plaintext ?? '';
+            foreach ($propertyMappings as $k => $v) {
+                $$k = $find($v);
+            }
 
-            $sellerInfo = $listing->find('.s-item__seller-info-text', 0)->plaintext ?? '';
+            // When an additional price detail or discount is defined, create the 'discountLine'.
+            if ($additionalPrice || $discount) {
+                $discountLine = '<br /><em>('
+                    . trim($additionalPrice ?? '')
+                    . '; ' . trim($discount ?? '')
+                    . ')</em>';
+            }
 
+            // Prepend the time-left info with a comma if the right details were found.
+            $timeInfo = trim($timeLeft . ' ' . $timeEnd);
+            if ($timeInfo) {
+                $timeInfo = ', ' . $timeInfo;
+            }
+
+            // Set the listing type.
+            if ($bids) {
+                $listingTypeDetails = "Auction: {$bids}{$timeInfo}";
+            } else {
+                $listingTypeDetails = 'Buy It Now';
+            }
+
+            // Acquire the listing's primary image and atach it.
             $image = $listing->find('.s-item__image-wrapper > img', 0);
             if ($image) {
                 // Not quite sure why append fragment here
@@ -106,11 +160,21 @@ class EBayBridge extends BridgeAbstract
                 $item['enclosures'] = [$imageUrl];
             }
 
+            // Include the original search link, if specified.
+            if ($this->getInput('includesSearchLink')) {
+                $searchLink = '<p><small><a target="_blank" href="' . e($this->getURI()) . '">View Search</a></small></p>';
+            }
+
+            // Build the final item's content to display and add the item onto the list.
             $item['content'] = <<<CONTENT
 <p>$sellerInfo $location</p>
-<p><span style="font-weight:bold">$price</span> $shippingFree $localDelivery $logisticsCost<span></span></p>
-<p>$subtitle</p>
+<p><strong>$price</strong> $obo ($listingTypeDetails)
+    $discountLine
+    <br /><small>$shippingFree $localDelivery $logisticsCost</small></p>
+<p>{$subtitle}</p>
+$searchLink
 CONTENT;
+
             $this->items[] = $item;
         }
     }

From cb91afbd71d545013b6c59f6841fbc4f64311a58 Mon Sep 17 00:00:00 2001
From: MarKoeh <75181140+Mar-Koeh@users.noreply.github.com>
Date: Tue, 30 Jul 2024 22:08:18 +0200
Subject: [PATCH 426/716] [ARDMediathekBridge] fixing API URL, start using show
 title (#4170) (#4172)

The bridge stopped working after the API server stopped accepting a trailing slash after the ID in the URL. This is being fixed. Also, the show title in the JSON was ignored. This is being fixed as well
---
 bridges/ARDMediathekBridge.php | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/bridges/ARDMediathekBridge.php b/bridges/ARDMediathekBridge.php
index 6de8dad7..da11dd64 100644
--- a/bridges/ARDMediathekBridge.php
+++ b/bridges/ARDMediathekBridge.php
@@ -40,6 +40,11 @@ class ARDMediathekBridge extends BridgeAbstract
      * @const IMAGEWIDTHPLACEHOLDER
      */
     const IMAGEWIDTHPLACEHOLDER = '{width}';
+    /**
+     * Title of the current show
+     * @var string
+     */
+    private $title;
 
     const PARAMETERS = [
         [
@@ -72,7 +77,7 @@ class ARDMediathekBridge extends BridgeAbstract
             }
         }
 
-        $url = self::APIENDPOINT . $showID . '/?pageSize=' . self::PAGESIZE;
+        $url = self::APIENDPOINT . $showID . '?pageSize=' . self::PAGESIZE;
         $rawJSON = getContents($url);
         $processedJSON = json_decode($rawJSON);
 
@@ -93,6 +98,17 @@ class ARDMediathekBridge extends BridgeAbstract
             $this->items[] = $item;
         }
 
+        $this->title = $processedJSON->title;
+
         date_default_timezone_set($oldTz);
     }
+
+    /** {@inheritdoc} */
+    public function getName()
+    {
+        if (!empty($this->title)) {
+            return $this->title;
+        }
+        return parent::getName();
+    }
 }

From aa3989873cbcd20919725e847e4d299ee5724740 Mon Sep 17 00:00:00 2001
From: Pavel Korytov <thexcloud@gmail.com>
Date: Tue, 30 Jul 2024 23:10:57 +0300
Subject: [PATCH 427/716] [EconomistBridge] Add cookie (#4173)

* [EconomistBridge] Add cookie

* [EconomistBridge] Fix lint
---
 bridges/EconomistBridge.php          | 29 +++++++++++++++++++++++++++-
 docs/10_Bridge_Specific/Economist.md |  5 ++++-
 2 files changed, 32 insertions(+), 2 deletions(-)

diff --git a/bridges/EconomistBridge.php b/bridges/EconomistBridge.php
index 70117cb0..eaa50ba1 100644
--- a/bridges/EconomistBridge.php
+++ b/bridges/EconomistBridge.php
@@ -8,6 +8,12 @@ class EconomistBridge extends FeedExpander
     const CACHE_TIMEOUT = 3600; //1hour
     const DESCRIPTION = 'Returns the latest articles for the selected category';
 
+    const CONFIGURATION = [
+        'cookie' => [
+            'required' => false,
+        ]
+    ];
+
     const PARAMETERS = [
         'global' => [
             'limit' => [
@@ -99,8 +105,20 @@ class EconomistBridge extends FeedExpander
 
     protected function parseItem(array $item)
     {
+        $headers = [];
+        if ($this->getOption('cookie')) {
+            $headers = [
+                'Authority: www.economist.com',
+                'Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7',
+                'Accept-language: en-US,en;q=0.9',
+                'Cache-control: max-age=0',
+                'Cookie: ' . $this->getOption('cookie'),
+                'Upgrade-insecure-requests: 1',
+                'User-agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36'
+            ];
+        }
         try {
-            $dom = getSimpleHTMLDOM($item['uri']);
+            $dom = getSimpleHTMLDOM($item['uri'], $headers);
         } catch (Exception $e) {
             $item['content'] = $e->getMessage();
             return $item;
@@ -209,6 +227,15 @@ class EconomistBridge extends FeedExpander
         foreach ($elem->find('a.ds-link-with-arrow-icon') as $a) {
             $a->parent->removeChild($a);
         }
+        // Sections like "Leaders on day X"
+        foreach ($elem->find('div[data-tracking-id=content-well-chapter-list]') as $div) {
+            $div->parent->removeChild($div);
+        }
+        // "Explore more" section
+        foreach ($elem->find('h3[id=article-tags]') as $h3) {
+            $div = $h3->parent;
+            $div->parent->removeChild($div);
+        }
 
         // The Economist puts infographics into iframes, which doesn't
         // work in any of my readers. So this replaces iframes with
diff --git a/docs/10_Bridge_Specific/Economist.md b/docs/10_Bridge_Specific/Economist.md
index 1a792eb8..d11ad43c 100644
--- a/docs/10_Bridge_Specific/Economist.md
+++ b/docs/10_Bridge_Specific/Economist.md
@@ -1,4 +1,4 @@
-# EconomistWorldInBriefBridge
+# EconomistWorldInBriefBridge and EconomistBridge
 
 In May 2024, The Economist finally fixed its paywall, and it started requiring authorization. Which means you can't use this bridge unless you have an active subscription.
 
@@ -15,4 +15,7 @@ Once you've done this, add the cookie to your `config.ini.php`:
 ```
 [EconomistWorldInBriefBridge]
 cookie = "<value>"
+
+[EconomistBridge]
+cookie = "<value>"
 ```

From 891c8979a3ea7678b61d62fbe7f69250d32d1c78 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 31 Jul 2024 17:30:06 +0200
Subject: [PATCH 428/716] refactor: return proper response object (#4169)

---
 actions/ConnectivityAction.php                  |  4 ++--
 bridges/BadDragonBridge.php                     |  3 +--
 bridges/BandcampBridge.php                      | 11 ++++++-----
 bridges/CubariBridge.php                        |  4 +++-
 bridges/DemosBerlinBridge.php                   |  3 ++-
 bridges/DerpibooruBridge.php                    | 10 +++-------
 bridges/EZTVBridge.php                          |  4 +++-
 bridges/ElloBridge.php                          |  8 +++-----
 bridges/FDroidBridge.php                        |  2 +-
 bridges/FunkBridge.php                          |  2 +-
 bridges/GlowficBridge.php                       |  6 +++---
 ...tionalInstituteForStrategicStudiesBridge.php |  2 +-
 bridges/ItakuBridge.php                         |  4 ++--
 bridges/KilledbyGoogleBridge.php                |  3 +--
 bridges/LegoIdeasBridge.php                     |  3 +--
 bridges/OpenCVEBridge.php                       | 13 +++++--------
 bridges/PepperBridgeAbstract.php                |  7 ++-----
 bridges/PixivBridge.php                         | 17 ++++++++---------
 bridges/RainbowSixSiegeBridge.php               |  2 +-
 bridges/RedditBridge.php                        |  2 +-
 bridges/ReutersBridge.php                       |  4 +++-
 bridges/RoadAndTrackBridge.php                  |  5 -----
 bridges/SpotifyBridge.php                       |  4 ++--
 bridges/SummitsOnTheAirBridge.php               |  8 ++++++--
 bridges/TwitterV2Bridge.php                     |  2 +-
 bridges/UnogsBridge.php                         |  2 +-
 bridges/VkBridge.php                            |  6 +++---
 lib/contents.php                                | 12 +++---------
 28 files changed, 69 insertions(+), 84 deletions(-)

diff --git a/actions/ConnectivityAction.php b/actions/ConnectivityAction.php
index 09d9c6c6..eb9edeb1 100644
--- a/actions/ConnectivityAction.php
+++ b/actions/ConnectivityAction.php
@@ -54,8 +54,8 @@ class ConnectivityAction implements ActionInterface
         ];
         try {
             $response = getContents($bridge::URI, [], $curl_opts, true);
-            $result['http_code'] = $response['code'];
-            if (in_array($response['code'], [200])) {
+            $result['http_code'] = $response->getCode();
+            if (in_array($result['http_code'], [200])) {
                 $result['successful'] = true;
             }
         } catch (\Exception $e) {
diff --git a/bridges/BadDragonBridge.php b/bridges/BadDragonBridge.php
index d38e3408..2249d6f7 100644
--- a/bridges/BadDragonBridge.php
+++ b/bridges/BadDragonBridge.php
@@ -284,8 +284,7 @@ class BadDragonBridge extends BridgeAbstract
             case 'Clearance':
                 $toyData = json_decode(getContents($this->inputToURL(true)));
 
-                $productList = json_decode(getContents(self::URI
-                . 'api/inventory-toy/product-list'));
+                $productList = json_decode(getContents(self::URI . 'api/inventory-toy/product-list'));
 
                 foreach ($toyData->toys as $toy) {
                     $item = [];
diff --git a/bridges/BandcampBridge.php b/bridges/BandcampBridge.php
index a9bd2ea1..80bb7fd0 100644
--- a/bridges/BandcampBridge.php
+++ b/bridges/BandcampBridge.php
@@ -111,12 +111,12 @@ class BandcampBridge extends BridgeAbstract
                 $url = self::URI . 'api/hub/1/dig_deeper';
                 $data = $this->buildRequestJson();
                 $header = [
-                'Content-Type: application/json',
-                'Content-Length: ' . strlen($data)
+                    'Content-Type: application/json',
+                    'Content-Length: ' . strlen($data),
                 ];
                 $opts = [
-                CURLOPT_CUSTOMREQUEST => 'POST',
-                CURLOPT_POSTFIELDS => $data
+                    CURLOPT_CUSTOMREQUEST => 'POST',
+                    CURLOPT_POSTFIELDS => $data,
                 ];
                 $content = getContents($url, $header, $opts);
 
@@ -314,7 +314,8 @@ class BandcampBridge extends BridgeAbstract
     {
         $url = self::URI . 'api/' . $endpoint . '?' . http_build_query($query_data);
         // todo: 429 Too Many Requests happens a lot
-        $data = json_decode(getContents($url));
+        $response = getContents($url);
+        $data = json_decode($response);
         return $data;
     }
 
diff --git a/bridges/CubariBridge.php b/bridges/CubariBridge.php
index a7b6d69d..72fadf6e 100644
--- a/bridges/CubariBridge.php
+++ b/bridges/CubariBridge.php
@@ -47,8 +47,10 @@ class CubariBridge extends BridgeAbstract
      */
     public function collectData()
     {
+        // TODO: fix trivial SSRF
         $json = getContents($this->getInput('gist'));
-        $jsonFile = json_decode($json, true);
+
+        $jsonFile = Json::decode($json);
 
         $this->mangaTitle = $jsonFile['title'];
 
diff --git a/bridges/DemosBerlinBridge.php b/bridges/DemosBerlinBridge.php
index 05fd2335..cc44a7cf 100644
--- a/bridges/DemosBerlinBridge.php
+++ b/bridges/DemosBerlinBridge.php
@@ -24,7 +24,8 @@ class DemosBerlinBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $json = getContents('https://www.berlin.de/polizei/service/versammlungsbehoerde/versammlungen-aufzuege/index.php/index/all.json');
+        $url = 'https://www.berlin.de/polizei/service/versammlungsbehoerde/versammlungen-aufzuege/index.php/index/all.json';
+        $json = getContents($url);
         $jsonFile = json_decode($json, true);
 
         $daysInterval = DateInterval::createFromDateString($this->getInput('days') . ' day');
diff --git a/bridges/DerpibooruBridge.php b/bridges/DerpibooruBridge.php
index e06e0eff..2d650d57 100644
--- a/bridges/DerpibooruBridge.php
+++ b/bridges/DerpibooruBridge.php
@@ -78,13 +78,9 @@ class DerpibooruBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $queryJson = json_decode(getContents(
-            self::URI
-            . 'api/v1/json/search/images?filter_id='
-            . urlencode($this->getInput('f'))
-            . '&q='
-            . urlencode($this->getInput('q'))
-        ));
+        $url = self::URI . 'api/v1/json/search/images?filter_id=' . urlencode($this->getInput('f')) . '&q=' . urlencode($this->getInput('q'));
+
+        $queryJson = json_decode(getContents($url));
 
         foreach ($queryJson->images as $post) {
             $item = [];
diff --git a/bridges/EZTVBridge.php b/bridges/EZTVBridge.php
index 25a88124..556bd39e 100644
--- a/bridges/EZTVBridge.php
+++ b/bridges/EZTVBridge.php
@@ -50,7 +50,9 @@ class EZTVBridge extends BridgeAbstract
         $eztv_uri = $this->getEztvUri();
         $ids = explode(',', trim($this->getInput('ids')));
         foreach ($ids as $id) {
-            $data = json_decode(getContents(sprintf('%s/api/get-torrents?imdb_id=%s', $eztv_uri, $id)));
+            $url = sprintf('%s/api/get-torrents?imdb_id=%s', $eztv_uri, $id);
+            $json = getContents($url);
+            $data = json_decode($json);
             if (!isset($data->torrents)) {
                 // No results
                 continue;
diff --git a/bridges/ElloBridge.php b/bridges/ElloBridge.php
index 42c88a06..a9e69cfe 100644
--- a/bridges/ElloBridge.php
+++ b/bridges/ElloBridge.php
@@ -34,11 +34,9 @@ class ElloBridge extends BridgeAbstract
         ];
 
         if (!empty($this->getInput('u'))) {
-            $postData = getContents(self::URI . 'api/v2/users/~' . urlencode($this->getInput('u')) . '/posts', $header) or
-                returnServerError('Unable to query Ello API.');
+            $postData = getContents(self::URI . 'api/v2/users/~' . urlencode($this->getInput('u')) . '/posts', $header);
         } else {
-            $postData = getContents(self::URI . 'api/v2/posts?terms=' . urlencode($this->getInput('s')), $header) or
-                returnServerError('Unable to query Ello API.');
+            $postData = getContents(self::URI . 'api/v2/posts?terms=' . urlencode($this->getInput('s')), $header);
         }
 
         $postData = json_decode($postData);
@@ -117,7 +115,7 @@ class ElloBridge extends BridgeAbstract
         $apiKey = $this->cache->get($cacheKey);
 
         if (!$apiKey) {
-            $keyInfo = getContents(self::URI . 'api/webapp-token') or returnServerError('Unable to get token.');
+            $keyInfo = getContents(self::URI . 'api/webapp-token');
             $apiKey = json_decode($keyInfo)->token->access_token;
             $ttl = 60 * 60 * 20;
             $this->cache->set($cacheKey, $apiKey, $ttl);
diff --git a/bridges/FDroidBridge.php b/bridges/FDroidBridge.php
index 8d3b7808..fdf0262f 100644
--- a/bridges/FDroidBridge.php
+++ b/bridges/FDroidBridge.php
@@ -31,7 +31,7 @@ class FDroidBridge extends BridgeAbstract
             CURLOPT_NOBODY => true,
         ];
         $reponse = getContents($url, [], $curlOptions, true);
-        $lastModified = $reponse['headers']['last-modified'][0] ?? null;
+        $lastModified = $reponse->getHeader('last-modified');
         $timestamp = strtotime($lastModified ?? 'today');
         return $timestamp;
     }
diff --git a/bridges/FunkBridge.php b/bridges/FunkBridge.php
index df499035..e4935ffb 100644
--- a/bridges/FunkBridge.php
+++ b/bridges/FunkBridge.php
@@ -32,7 +32,7 @@ class FunkBridge extends BridgeAbstract
                     $url .= '?size=' . $this->getInput('max');
                 }
 
-                $jsonString = getContents($url) or returnServerError('No contents received!');
+                $jsonString = getContents($url);
                 $json = json_decode($jsonString, true);
 
                 foreach ($json['list'] as $element) {
diff --git a/bridges/GlowficBridge.php b/bridges/GlowficBridge.php
index b51ead8d..0e4b8d93 100644
--- a/bridges/GlowficBridge.php
+++ b/bridges/GlowficBridge.php
@@ -41,8 +41,7 @@ class GlowficBridge extends BridgeAbstract
             $first_page = 1;
         }
         for ($page_offset = $first_page; $page_offset <= $metadata['Last-Page']; $page_offset++) {
-            $jsonContents = getContents($url . '/replies?page=' . $page_offset) or
-                returnClientError('Could not retrieve replies for page ' . $page_offset . '.');
+            $jsonContents = getContents($url . '/replies?page=' . $page_offset);
             $replies = json_decode($jsonContents);
             foreach ($replies as $reply) {
                 $item = [];
@@ -75,8 +74,9 @@ class GlowficBridge extends BridgeAbstract
     private function getPost()
     {
         $url = $this->getAPIURI();
-        $jsonPost = getContents($url) or returnClientError('Could not retrieve post metadata.');
+        $jsonPost = getContents($url);
         $post = json_decode($jsonPost);
+
         return $post;
     }
 
diff --git a/bridges/InternationalInstituteForStrategicStudiesBridge.php b/bridges/InternationalInstituteForStrategicStudiesBridge.php
index b5b589ab..9b82dbd5 100644
--- a/bridges/InternationalInstituteForStrategicStudiesBridge.php
+++ b/bridges/InternationalInstituteForStrategicStudiesBridge.php
@@ -30,7 +30,7 @@ class InternationalInstituteForStrategicStudiesBridge extends BridgeAbstract
         ];
         $headers = [
             'Accept: application/json, text/plain, */*',
-            'Content-Type: application/json;charset=UTF-8'
+            'Content-Type: application/json;charset=UTF-8',
         ];
         $json = getContents($url, $headers, $opts);
         $data = json_decode($json);
diff --git a/bridges/ItakuBridge.php b/bridges/ItakuBridge.php
index 4f414574..506805f7 100644
--- a/bridges/ItakuBridge.php
+++ b/bridges/ItakuBridge.php
@@ -669,11 +669,11 @@ class ItakuBridge extends BridgeAbstract
             if ($cache) {
                 $data = $this->loadCacheValue($url);
                 if (is_null($data)) {
-                    $data = getContents($url, $httpHeaders, $curlOptions) or returnServerError("Could not load $url");
+                    $data = getContents($url, $httpHeaders, $curlOptions);
                     $this->saveCacheValue($url, $data);
                 }
             } else {
-                $data = getContents($url, $httpHeaders, $curlOptions) or returnServerError("Could not load $url");
+                $data = getContents($url, $httpHeaders, $curlOptions);
             }
             return json_decode($data, true);
         } else { //get simpleHTMLDOM object
diff --git a/bridges/KilledbyGoogleBridge.php b/bridges/KilledbyGoogleBridge.php
index 54c5b59f..7b8f7f6e 100644
--- a/bridges/KilledbyGoogleBridge.php
+++ b/bridges/KilledbyGoogleBridge.php
@@ -12,8 +12,7 @@ class KilledbyGoogleBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $json = getContents(self::URI . '/graveyard.json')
-            or returnServerError('Could not request: ' . self::URI . '/graveyard.json');
+        $json = getContents(self::URI . '/graveyard.json');
 
         $this->handleJson($json);
         $this->orderItems();
diff --git a/bridges/LegoIdeasBridge.php b/bridges/LegoIdeasBridge.php
index c4361f1f..e983e56d 100644
--- a/bridges/LegoIdeasBridge.php
+++ b/bridges/LegoIdeasBridge.php
@@ -52,8 +52,7 @@ Once a project reaches 10,000 supporters, it gets reviewed by the lego experts.'
             CURLOPT_POST => 1,
             CURLOPT_POSTFIELDS => $this->getHttpPostData()
         ];
-        $responseData = getContents($this->getHttpPostURI(), $header, $opts) or
-                returnServerError('Unable to query Lego Ideas API.');
+        $responseData = getContents($this->getHttpPostURI(), $header, $opts);
 
         foreach (json_decode($responseData)->results as $project) {
             preg_match('/datetime=\"(\S+)\"/', $project->entity->published_at, $date_matches);
diff --git a/bridges/OpenCVEBridge.php b/bridges/OpenCVEBridge.php
index 594bb9ec..b5fc852b 100644
--- a/bridges/OpenCVEBridge.php
+++ b/bridges/OpenCVEBridge.php
@@ -147,10 +147,9 @@ class OpenCVEBridge extends BridgeAbstract
             for ($i = 1; $i <= $this->getInput('pages'); $i++) {
                 $queryPaginated = array_merge($query, ['page' => $i]);
                 $url = $instance . '/api/cve?' . http_build_query($queryPaginated);
-                $response = getContents(
-                    $url,
-                    [$authHeader]
-                );
+
+                $response = getContents($url, [$authHeader]);
+
                 $titlePrefix = '';
                 if (count($queries) > 1) {
                     $titlePrefix = '[' . $queryName . '] ';
@@ -205,10 +204,8 @@ class OpenCVEBridge extends BridgeAbstract
     private function fetchContents($cveItem, $titlePrefix, $instance, $authHeader)
     {
         $url = $instance . '/api/cve/' . $cveItem->id;
-        $response = getContents(
-            $url,
-            [$authHeader]
-        );
+
+        $response = getContents($url, [$authHeader]);
         $datum = json_decode($response);
 
         $title = $this->getTitleFromDatum($datum, $titlePrefix);
diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index 6e41cf20..4e9ab0b5 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -191,15 +191,12 @@ HEREDOC;
         }
     }
 
-    /**
-     * Extract the cookies obtained from the URL
-     * @return array the array containing the cookies set by the URL
-     */
     private function getCookiesHeaderValue($url)
     {
         $response = getContents($url, [], [], true);
-        $setCookieHeaders = $response['headers']['set-cookie'] ?? [];
+        $setCookieHeaders = $response->getHeader('set-cookie', true);
         $cookies = array_map(fn($c): string => explode(';', $c)[0], $setCookieHeaders);
+
         return implode('; ', $cookies);
     }
 
diff --git a/bridges/PixivBridge.php b/bridges/PixivBridge.php
index 604b5d4b..820b3a7c 100644
--- a/bridges/PixivBridge.php
+++ b/bridges/PixivBridge.php
@@ -332,21 +332,20 @@ class PixivBridge extends BridgeAbstract
         }
 
         if ($cache) {
-            $data = $this->loadCacheValue($url);
-            if (!$data) {
-                $data = getContents($url, $httpHeaders, $curlOptions, true);
-                $this->saveCacheValue($url, $data);
+            $response = $this->loadCacheValue($url);
+            if (!$response || is_array($response)) {
+                $response = getContents($url, $httpHeaders, $curlOptions, true);
+                $this->saveCacheValue($url, $response);
             }
         } else {
-            $data = getContents($url, $httpHeaders, $curlOptions, true);
+            $response = getContents($url, $httpHeaders, $curlOptions, true);
         }
 
-        $this->checkCookie($data['headers']);
+        $this->checkCookie($response->getHeaders());
 
         if ($getJSON) {
-            return json_decode($data['content'], true);
-        } else {
-            return $data['content'];
+            return json_decode($response->getBody(), true);
         }
+        return $response->getBody();
     }
 }
diff --git a/bridges/RainbowSixSiegeBridge.php b/bridges/RainbowSixSiegeBridge.php
index 77495a3c..d725e3e9 100644
--- a/bridges/RainbowSixSiegeBridge.php
+++ b/bridges/RainbowSixSiegeBridge.php
@@ -22,7 +22,7 @@ class RainbowSixSiegeBridge extends BridgeAbstract
         $dlUrl = $dlUrl . '&limit=6&mediaFilter=all&skip=0&startIndex=0&tags=BR-rainbow-six%20GA-siege';
         $dlUrl = $dlUrl . '&locale=en-us&fallbackLocale=en-us&environment=master';
         $jsonString = getContents($dlUrl, [
-            'Authorization: ' . self::NIMBUS_API_KEY
+            'Authorization: ' . self::NIMBUS_API_KEY,
         ]);
 
         $json = json_decode($jsonString, true);
diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index 434ae74a..ef74fdcd 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -149,7 +149,7 @@ class RedditBridge extends BridgeAbstract
 
             $response = getContents($url, ['User-Agent: ' . $useragent], [], true);
 
-            $json = $response['content'];
+            $json = $response->getBody();
 
             $parsedJson = Json::decode($json, false);
 
diff --git a/bridges/ReutersBridge.php b/bridges/ReutersBridge.php
index fdf4e2a9..07b3061c 100644
--- a/bridges/ReutersBridge.php
+++ b/bridges/ReutersBridge.php
@@ -417,9 +417,11 @@ class ReutersBridge extends BridgeAbstract
                                 $get_embed_url = 'https://publish.twitter.com/oembed?url='
                                                                  . urlencode($tweet_url) .
                                                                 '&partner=&hide_thread=false';
+
                                 $oembed_json = json_decode(getContents($get_embed_url), true);
                                 $embed .= $oembed_json['html'];
-                            } catch (Exception $e) { // In case not found any tweet.
+                            } catch (\Exception $e) {
+                                // In case not found any tweet.
                                 $embed .= '';
                             }
                             break;
diff --git a/bridges/RoadAndTrackBridge.php b/bridges/RoadAndTrackBridge.php
index c236036c..eb2dcc53 100644
--- a/bridges/RoadAndTrackBridge.php
+++ b/bridges/RoadAndTrackBridge.php
@@ -68,9 +68,4 @@ class RoadAndTrackBridge extends BridgeAbstract
         $item['content'] = $content;
         return $item;
     }
-
-    private function getArticleContent($article)
-    {
-        return getContents($article->contentUrl);
-    }
 }
diff --git a/bridges/SpotifyBridge.php b/bridges/SpotifyBridge.php
index 25948011..e03d43a1 100644
--- a/bridges/SpotifyBridge.php
+++ b/bridges/SpotifyBridge.php
@@ -286,9 +286,9 @@ class SpotifyBridge extends BridgeAbstract
         } else {
             $basicAuth = base64_encode(sprintf('%s:%s', $this->getInput('clientid'), $this->getInput('clientsecret')));
             $json = getContents('https://accounts.spotify.com/api/token', [
-                "Authorization: Basic $basicAuth"
+                "Authorization: Basic $basicAuth",
             ], [
-                CURLOPT_POSTFIELDS => 'grant_type=client_credentials'
+                CURLOPT_POSTFIELDS => 'grant_type=client_credentials',
             ]);
             $data = Json::decode($json);
             $this->token = $data['access_token'];
diff --git a/bridges/SummitsOnTheAirBridge.php b/bridges/SummitsOnTheAirBridge.php
index 53bba7ab..17431214 100644
--- a/bridges/SummitsOnTheAirBridge.php
+++ b/bridges/SummitsOnTheAirBridge.php
@@ -20,8 +20,12 @@ class SummitsOnTheAirBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $header = ['Content-type:application/json'];
-        $opts = [CURLOPT_HTTPGET => 1];
+        $header = [
+            'Content-type:application/json',
+        ];
+        $opts = [
+            CURLOPT_HTTPGET => 1,
+        ];
         $json = getContents($this->getURI() . $this->getInput('c'), $header, $opts);
 
         $spots = json_decode($json, true);
diff --git a/bridges/TwitterV2Bridge.php b/bridges/TwitterV2Bridge.php
index 83bfae29..07af8301 100644
--- a/bridges/TwitterV2Bridge.php
+++ b/bridges/TwitterV2Bridge.php
@@ -598,7 +598,7 @@ EXTERNAL;
     private function makeApiCall($api, $authHeaders, $params)
     {
         $uri = self::API_URI . $api . '?' . http_build_query($params);
-        $result = getContents($uri, $authHeaders, [], false);
+        $result = getContents($uri, $authHeaders);
         $data = json_decode($result);
         return $data;
     }
diff --git a/bridges/UnogsBridge.php b/bridges/UnogsBridge.php
index 486bac3d..7aff10c6 100644
--- a/bridges/UnogsBridge.php
+++ b/bridges/UnogsBridge.php
@@ -92,7 +92,7 @@ class UnogsBridge extends BridgeAbstract
     {
         $header = [
             'Referer: https://unogs.com/',
-            'referrer: http://unogs.com'
+            'referrer: http://unogs.com',
         ];
 
         $raw = getContents($url, $header);
diff --git a/bridges/VkBridge.php b/bridges/VkBridge.php
index 980b4154..22957f26 100644
--- a/bridges/VkBridge.php
+++ b/bridges/VkBridge.php
@@ -511,11 +511,11 @@ class VkBridge extends BridgeAbstract
         while ($redirects < 2) {
             $response = getContents($uri, $httpHeaders, [CURLOPT_FOLLOWLOCATION => false], true);
 
-            if (in_array($response['code'], [200, 304])) {
-                return $response['content'];
+            if (in_array($response->getCode(), [200, 304])) {
+                return $response->getBody();
             }
 
-            $headers = $response['headers'];
+            $headers = $response->getHeaders();
             $uri = urljoin(self::URI, $headers['location'][0]);
 
             if (str_contains($uri, '/429.html')) {
diff --git a/lib/contents.php b/lib/contents.php
index ba6dd531..893a3512 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -5,8 +5,8 @@
  *
  * @param array $httpHeaders E.g. ['Content-type: text/plain']
  * @param array $curlOptions Associative array e.g. [CURLOPT_MAXREDIRS => 3]
- * @param bool $returnFull Whether to return an array: ['code' => int, 'headers' => array, 'content' => string]
- * @return string|array
+ * @param bool $returnFull Whether to return Response object
+ * @return string|Response
  */
 function getContents(
     string $url,
@@ -113,13 +113,7 @@ function getContents(
             throw $e;
     }
     if ($returnFull === true) {
-        // todo: return the actual response object
-        return [
-            'code'      => $response->getCode(),
-            'headers'   => $response->getHeaders(),
-            // For legacy reasons, use 'content' instead of 'body'
-            'content'   => $response->getBody(),
-        ];
+        return $response;
     }
     return $response->getBody();
 }

From 1a8d0fb8ab9fe32350c1395bd5a9d1b3166980fa Mon Sep 17 00:00:00 2001
From: Zack Puhl <31320277+NotsoanoNimus@users.noreply.github.com>
Date: Wed, 31 Jul 2024 11:51:05 -0400
Subject: [PATCH 429/716] [EBayBridge] fix undefined vars errors (#4175)

---
 bridges/EBayBridge.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/bridges/EBayBridge.php b/bridges/EBayBridge.php
index 11b90bf8..463f73d6 100644
--- a/bridges/EBayBridge.php
+++ b/bridges/EBayBridge.php
@@ -137,6 +137,8 @@ class EBayBridge extends BridgeAbstract
                     . trim($additionalPrice ?? '')
                     . '; ' . trim($discount ?? '')
                     . ')</em>';
+            } else {
+                $discountLine = '';
             }
 
             // Prepend the time-left info with a comma if the right details were found.
@@ -163,6 +165,8 @@ class EBayBridge extends BridgeAbstract
             // Include the original search link, if specified.
             if ($this->getInput('includesSearchLink')) {
                 $searchLink = '<p><small><a target="_blank" href="' . e($this->getURI()) . '">View Search</a></small></p>';
+            } else {
+                $searchLink = '';
             }
 
             // Build the final item's content to display and add the item onto the list.

From 9982bfce1f0ae2f9aa5a755787912089da145da8 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 31 Jul 2024 17:51:44 +0200
Subject: [PATCH 430/716] fix: convert php errors to exceptions when in debug
 mode (#4176)

---
 index.php | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/index.php b/index.php
index 7144ae27..f23d8441 100644
--- a/index.php
+++ b/index.php
@@ -25,8 +25,10 @@ set_error_handler(function ($code, $message, $file, $line) {
         // Deprecation messages and other masked errors are typically ignored here
         return false;
     }
-    // In the future, uncomment this:
-    //throw new \ErrorException($message, 0, $code, $file, $line);
+    if (Debug::isEnabled()) {
+        // This might be annoying, but it's for the greater good
+        throw new \ErrorException($message, 0, $code, $file, $line);
+    }
     $text = sprintf(
         '%s at %s line %s',
         sanitize_root($message),

From e55e9b8facacee38671cf7d9c3dc2ca3d3be28b5 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 31 Jul 2024 17:53:10 +0200
Subject: [PATCH 431/716] feat: enable all bridges by default (#4177)

---
 config.default.ini.php | 35 ++++++++++++++++++-----------------
 1 file changed, 18 insertions(+), 17 deletions(-)

diff --git a/config.default.ini.php b/config.default.ini.php
index 8f7de832..c6b0779d 100644
--- a/config.default.ini.php
+++ b/config.default.ini.php
@@ -8,23 +8,24 @@
 
 ; Only these bridges are available for feed production
 ; How to enable all bridges: enabled_bridges[] = *
-enabled_bridges[] = CssSelectorBridge
-enabled_bridges[] = FeedMerge
-enabled_bridges[] = FeedReducerBridge
-enabled_bridges[] = Filter
-enabled_bridges[] = GettrBridge
-enabled_bridges[] = MastodonBridge
-enabled_bridges[] = Reddit
-enabled_bridges[] = RumbleBridge
-enabled_bridges[] = SoundcloudBridge
-enabled_bridges[] = Telegram
-enabled_bridges[] = ThePirateBay
-enabled_bridges[] = TikTokBridge
-enabled_bridges[] = Twitch
-enabled_bridges[] = Vk
-enabled_bridges[] = XPathBridge
-enabled_bridges[] = Youtube
-enabled_bridges[] = YouTubeCommunityTabBridge
+;enabled_bridges[] = CssSelectorBridge
+;enabled_bridges[] = FeedMerge
+;enabled_bridges[] = FeedReducerBridge
+;enabled_bridges[] = Filter
+;enabled_bridges[] = GettrBridge
+;enabled_bridges[] = MastodonBridge
+;enabled_bridges[] = Reddit
+;enabled_bridges[] = RumbleBridge
+;enabled_bridges[] = SoundcloudBridge
+;enabled_bridges[] = Telegram
+;enabled_bridges[] = ThePirateBay
+;enabled_bridges[] = TikTokBridge
+;enabled_bridges[] = Twitch
+;enabled_bridges[] = Vk
+;enabled_bridges[] = XPathBridge
+;enabled_bridges[] = Youtube
+;enabled_bridges[] = YouTubeCommunityTabBridge
+enabled_bridges[] = *
 
 ; Defines the timezone used by RSS-Bridge
 ; Find a list of supported timezones at

From b8a9f34527c15f99cd8566b72d9a9a5c2b9f95a5 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 31 Jul 2024 19:04:07 +0200
Subject: [PATCH 432/716] fix(FeedParser): scrape out content from rss
 content:encoded (#4178)

* fix(FeedParser): parse content module from rss2

* refactor
---
 README.md                 |  9 +++++++++
 actions/DisplayAction.php | 19 ++++++++++---------
 lib/FeedItem.php          |  9 +++++++--
 lib/FeedParser.php        |  3 ++-
 tests/FeedParserTest.php  | 19 +++++++++++--------
 5 files changed, 39 insertions(+), 20 deletions(-)

diff --git a/README.md b/README.md
index 6124a4ea..982cd63b 100644
--- a/README.md
+++ b/README.md
@@ -418,7 +418,16 @@ See `formats/PlaintextFormat.php` for an example.
 
 These commands require that you have installed the dev dependencies in `composer.json`.
 
+Run all tests:
+
     ./vendor/bin/phpunit
+
+Run a single test class:
+
+    ./vendor/bin/phpunit --filter UrlTest
+
+Run linter:
+
     ./vendor/bin/phpcs --standard=phpcs.xml --warning-severity=0 --extensions=php -p ./
 
 https://github.com/squizlabs/PHP_CodeSniffer/wiki
diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 93813004..54782edc 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -112,15 +112,6 @@ class DisplayAction implements ActionInterface
             $input = array_diff_key($requestArray, array_fill_keys($remove, ''));
             $bridge->setInput($input);
             $bridge->collectData();
-            $items = $bridge->getItems();
-            if (isset($items[0]) && is_array($items[0])) {
-                $feedItems = [];
-                foreach ($items as $item) {
-                    $feedItems[] = FeedItem::fromArray($item);
-                }
-                $items = $feedItems;
-            }
-            $feed = $bridge->getFeed();
         } catch (\Exception $e) {
             // Probably an exception inside a bridge
             if ($e instanceof HttpException) {
@@ -154,6 +145,16 @@ class DisplayAction implements ActionInterface
             }
         }
 
+        $items = $bridge->getItems();
+        if (isset($items[0]) && is_array($items[0])) {
+            $feedItems = [];
+            foreach ($items as $item) {
+                $feedItems[] = FeedItem::fromArray($item);
+            }
+            $items = $feedItems;
+        }
+        $feed = $bridge->getFeed();
+
         $formatFactory = new FormatFactory();
         $format = $formatFactory->create($format);
 
diff --git a/lib/FeedItem.php b/lib/FeedItem.php
index fc4549a7..dfb954a0 100644
--- a/lib/FeedItem.php
+++ b/lib/FeedItem.php
@@ -186,21 +186,26 @@ class FeedItem
     }
 
     /**
-     * @param string|object $content The item content as text or simple_html_dom object.
+     * @param string|array|\simple_html_dom|\simple_html_dom_node $content The item content
      */
     public function setContent($content)
     {
         $this->content = null;
+
         if (
             $content instanceof simple_html_dom
             || $content instanceof simple_html_dom_node
         ) {
             $content = (string) $content;
+        } elseif (is_array($content)) {
+            // Assuming this is the rss2.0 content module
+            $content = $content['encoded'] ?? '';
         }
+
         if (is_string($content)) {
             $this->content = $content;
         } else {
-            Debug::log(sprintf('Feed content must be a string but got %s', gettype($content)));
+            Debug::log(sprintf('Unable to convert feed content to string: %s', gettype($content)));
         }
     }
 
diff --git a/lib/FeedParser.php b/lib/FeedParser.php
index b774cc14..3a2f15d4 100644
--- a/lib/FeedParser.php
+++ b/lib/FeedParser.php
@@ -167,8 +167,9 @@ final class FeedParser
         if (isset($namespaces['media'])) {
             $media = $feedItem->children($namespaces['media']);
         }
+
         foreach ($namespaces as $namespaceName => $namespaceUrl) {
-            if (in_array($namespaceName, ['', 'content', 'media'])) {
+            if (in_array($namespaceName, ['', 'media'])) {
                 continue;
             }
             $item[$namespaceName] = $this->parseModule($feedItem, $namespaceName, $namespaceUrl);
diff --git a/tests/FeedParserTest.php b/tests/FeedParserTest.php
index 05d5ef69..45dc1234 100644
--- a/tests/FeedParserTest.php
+++ b/tests/FeedParserTest.php
@@ -8,6 +8,13 @@ use PHPUnit\Framework\TestCase;
 
 class FeedParserTest extends TestCase
 {
+    private \FeedParser $sut;
+
+    public function setUp(): void
+    {
+        $this->sut = new \FeedParser();
+    }
+
     public function testRss1()
     {
         $xml = <<<XML
@@ -37,8 +44,7 @@ class FeedParserTest extends TestCase
         </rdf:RDF>
         XML;
 
-        $sut = new \FeedParser();
-        $feed = $sut->parseFeed($xml);
+        $feed = $this->sut->parseFeed($xml);
 
         $this->assertSame('hello feed', $feed['title']);
         $this->assertSame('http://meerkat.oreillynet.com', $feed['uri']);
@@ -74,8 +80,7 @@ class FeedParserTest extends TestCase
         </rss>
         XML;
 
-        $sut = new \FeedParser();
-        $feed = $sut->parseFeed($xml);
+        $feed = $this->sut->parseFeed($xml);
 
         $this->assertSame('hello feed', $feed['title']);
         $this->assertSame('https://example.com/', $feed['uri']);
@@ -111,8 +116,7 @@ class FeedParserTest extends TestCase
         </feed>
         XML;
 
-        $sut = new \FeedParser();
-        $feed = $sut->parseFeed($xml);
+        $feed = $this->sut->parseFeed($xml);
 
         $this->assertSame('hello feed', $feed['title']);
         $this->assertSame('https://example.com/1', $feed['uri']);
@@ -151,8 +155,7 @@ class FeedParserTest extends TestCase
         </rss>
         XML;
 
-        $sut = new \FeedParser();
-        $feed = $sut->parseFeed($xml);
+        $feed = $this->sut->parseFeed($xml);
         $expected = [
             'title' => '',
             'uri' => '',

From 8a1f2604aa9358c6f70e078e704e5c674683eaab Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 31 Jul 2024 19:25:51 +0200
Subject: [PATCH 433/716] fix: bug in prior refactor (#4179)

* fix: bug in prior refactor

* fix deprecation notice
---
 actions/DisplayAction.php  | 19 +++++++++----------
 bridges/GelbooruBridge.php | 18 ++++++++----------
 2 files changed, 17 insertions(+), 20 deletions(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 54782edc..93813004 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -112,6 +112,15 @@ class DisplayAction implements ActionInterface
             $input = array_diff_key($requestArray, array_fill_keys($remove, ''));
             $bridge->setInput($input);
             $bridge->collectData();
+            $items = $bridge->getItems();
+            if (isset($items[0]) && is_array($items[0])) {
+                $feedItems = [];
+                foreach ($items as $item) {
+                    $feedItems[] = FeedItem::fromArray($item);
+                }
+                $items = $feedItems;
+            }
+            $feed = $bridge->getFeed();
         } catch (\Exception $e) {
             // Probably an exception inside a bridge
             if ($e instanceof HttpException) {
@@ -145,16 +154,6 @@ class DisplayAction implements ActionInterface
             }
         }
 
-        $items = $bridge->getItems();
-        if (isset($items[0]) && is_array($items[0])) {
-            $feedItems = [];
-            foreach ($items as $item) {
-                $feedItems[] = FeedItem::fromArray($item);
-            }
-            $items = $feedItems;
-        }
-        $feed = $bridge->getFeed();
-
         $formatFactory = new FormatFactory();
         $format = $formatFactory->create($format);
 
diff --git a/bridges/GelbooruBridge.php b/bridges/GelbooruBridge.php
index 5fc6b33c..96d16bf9 100644
--- a/bridges/GelbooruBridge.php
+++ b/bridges/GelbooruBridge.php
@@ -33,7 +33,7 @@ class GelbooruBridge extends BridgeAbstract
         return $this->getURI()
         . 'index.php?&page=dapi&s=post&q=index&json=1&pid=' . $this->getInput('p')
         . '&limit=' . $this->getInput('l')
-        . '&tags=' . urlencode($this->getInput('t'));
+        . '&tags=' . urlencode($this->getInput('t') ?? '');
     }
 
     /*
@@ -76,18 +76,16 @@ class GelbooruBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $content = getContents($this->getFullURI());
-        // $content is empty string
+        $url = $this->getFullURI();
+        $content = getContents($url);
 
-        // Most other Gelbooru-based boorus put their content in the root of
-        // the JSON. This check is here for Bridges that inherit from this one
-        $posts = json_decode($content);
-        if (isset($posts->post)) {
-            $posts = $posts->post;
+        if ($content === '') {
+            return;
         }
 
-        if (is_null($posts)) {
-            returnServerError('No posts found.');
+        $posts = Json::decode($content, false);
+        if (isset($posts->post)) {
+            $posts = $posts->post;
         }
 
         foreach ($posts as $post) {

From 615c5335878be434a9051278126f7286e1549e14 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 31 Jul 2024 20:34:33 +0200
Subject: [PATCH 434/716] fix(FeedParser): dont emit content module (#4180)

---
 lib/FeedItem.php   | 3 ---
 lib/FeedParser.php | 7 ++++++-
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/lib/FeedItem.php b/lib/FeedItem.php
index dfb954a0..09aab129 100644
--- a/lib/FeedItem.php
+++ b/lib/FeedItem.php
@@ -197,9 +197,6 @@ class FeedItem
             || $content instanceof simple_html_dom_node
         ) {
             $content = (string) $content;
-        } elseif (is_array($content)) {
-            // Assuming this is the rss2.0 content module
-            $content = $content['encoded'] ?? '';
         }
 
         if (is_string($content)) {
diff --git a/lib/FeedParser.php b/lib/FeedParser.php
index 3a2f15d4..0ad90965 100644
--- a/lib/FeedParser.php
+++ b/lib/FeedParser.php
@@ -168,8 +168,13 @@ final class FeedParser
             $media = $feedItem->children($namespaces['media']);
         }
 
+        if (isset($namespaces['content'])) {
+            $content = $feedItem->children($namespaces['content']);
+            $item['content'] = (string) $content;
+        }
+
         foreach ($namespaces as $namespaceName => $namespaceUrl) {
-            if (in_array($namespaceName, ['', 'media'])) {
+            if (in_array($namespaceName, ['', 'content', 'media'])) {
                 continue;
             }
             $item[$namespaceName] = $this->parseModule($feedItem, $namespaceName, $namespaceUrl);

From b505667168225a74c30e7b58ab6a54bc00c3b89e Mon Sep 17 00:00:00 2001
From: Pavel Korytov <thexcloud@gmail.com>
Date: Wed, 31 Jul 2024 22:57:20 +0300
Subject: [PATCH 435/716] [SubstackBridge] Add Substack bridge (#4174)

* [SubstackBridge] Add Substack

* [SubstackBridge] Add docs

* [SubstackBridge] Fix lint

* [SubstackBridge] Update description

* [SubstackBridge] Update description (x2)
---
 bridges/SubstackBridge.php          | 50 +++++++++++++++++++++++++++++
 docs/10_Bridge_Specific/Substack.md | 18 +++++++++++
 lib/FeedExpander.php                |  4 +--
 3 files changed, 70 insertions(+), 2 deletions(-)
 create mode 100644 bridges/SubstackBridge.php
 create mode 100644 docs/10_Bridge_Specific/Substack.md

diff --git a/bridges/SubstackBridge.php b/bridges/SubstackBridge.php
new file mode 100644
index 00000000..13eea02e
--- /dev/null
+++ b/bridges/SubstackBridge.php
@@ -0,0 +1,50 @@
+<?php
+
+class SubstackBridge extends FeedExpander
+{
+    const MAINTAINER = 'sqrtminusone';
+    const NAME = 'Substack Bridge';
+    const URI = 'https://substack.com/';
+    const CACHE_TIMEOUT = 3600; //1hour
+    const DESCRIPTION = 'Access Substack. Add full content for paywalled posts if you have a session cookie with an active subscription.';
+
+    const CONFIGURATION = [
+        'sid' => [
+            'required' => false,
+        ]
+    ];
+
+    const PARAMETERS = [
+        '' => [
+            'url' => [
+                'name' => 'Substack RSS URL',
+                'required' => true,
+                'type' => 'text',
+                'defaultValue' => 'https://newsletter.pragmaticengineer.com/feed',
+                'title' => 'Usually https://<blog-url>/feed'
+            ]
+        ]
+    ];
+
+    public function collectData()
+    {
+        $headers = [];
+        if ($this->getOption('sid')) {
+            $url_parsed = parse_url($this->getInput('url'));
+            $authority = $url_parsed['host'];
+            $cookies = [
+                'ab_experiment_sampled=%22false%22',
+                'substack.sid=' . $this->getOption('sid'),
+                'substack.lli=1',
+                'intro_popup_last_hidden_at=' . (new DateTime())->format('Y-m-d\TH:i:s.v\Z')
+            ];
+            $headers = [
+                'Authority: ' . $authority,
+                'Cache-Control: max-age=0',
+                'User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36',
+                'Cookie: ' . implode('; ', $cookies)
+            ];
+        }
+        $this->collectExpandableDatas($this->getInput('url'), -1, $headers);
+    }
+}
diff --git a/docs/10_Bridge_Specific/Substack.md b/docs/10_Bridge_Specific/Substack.md
new file mode 100644
index 00000000..7595bbef
--- /dev/null
+++ b/docs/10_Bridge_Specific/Substack.md
@@ -0,0 +1,18 @@
+# SubstackBridge
+
+[Substack](https://substack.com) provides RSS feeds at `/feed` path, e.g., https://newsletter.pragmaticengineer.com/feed/. However, these feeds have two problems, addressed by this bridge:
+- They use RSS 2.0 with the draft [content extension](https://web.resource.org/rss/1.0/modules/content/), which isn't supported by some readers;
+- They don't have the full content for paywalled posts.
+
+Retrieving the full content is only possible _with an active subscription to the blog_. If you have one, Substack will return the full feed if it's fetched with the right set of cookies. Figuring out whether it's the intended behaviour is left as an exercise for the reader.
+
+To obtain the session cookie, authorize at https://substack.com/, open DevTools, go to Application -> Cookies -> https://substack.com, copy the value of `substack.sid` and paste it to the RSS bridge config:
+
+```
+[SubstackBridge]
+sid = "<your-sid>"
+```
+
+Authorization sometimes requires CAPTCHA, hence this operation is manual. The cookie lives for three months.
+
+After you've done this, the bridge should return full feeds for your subscriptions.
diff --git a/lib/FeedExpander.php b/lib/FeedExpander.php
index fe809bc2..ef001af1 100644
--- a/lib/FeedExpander.php
+++ b/lib/FeedExpander.php
@@ -7,7 +7,7 @@ abstract class FeedExpander extends BridgeAbstract
 {
     private array $feed;
 
-    public function collectExpandableDatas(string $url, $maxItems = -1)
+    public function collectExpandableDatas(string $url, $maxItems = -1, $headers = [])
     {
         if (!$url) {
             throw new \Exception('There is no $url for this RSS expander');
@@ -17,7 +17,7 @@ abstract class FeedExpander extends BridgeAbstract
             $maxItems = 999;
         }
         $accept = [MrssFormat::MIME_TYPE, AtomFormat::MIME_TYPE, '*/*'];
-        $httpHeaders = ['Accept: ' . implode(', ', $accept)];
+        $httpHeaders = array_merge(['Accept: ' . implode(', ', $accept)], $headers);
         $xmlString = getContents($url, $httpHeaders);
         if ($xmlString === '') {
             throw new \Exception(sprintf('Unable to parse xml from `%s` because we got the empty string', $url), 10);

From 8ae716e75cefba6fc2676e70b3dfb975593d83dd Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 31 Jul 2024 21:57:33 +0200
Subject: [PATCH 436/716] fix: improve github issue template (#4181)

---
 actions/DisplayAction.php | 25 ++++++++++++++++++-------
 1 file changed, 18 insertions(+), 7 deletions(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 93813004..d39d1812 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -213,22 +213,33 @@ class DisplayAction implements ActionInterface
         return $report['count'];
     }
 
-    private static function createGithubIssueUrl($bridge, $e, string $message): string
+    private static function createGithubIssueUrl(BridgeAbstract $bridge, \Exception $e, string $message): string
     {
-        return sprintf('https://github.com/RSS-Bridge/rss-bridge/issues/new?%s', http_build_query([
-            'title' => sprintf('%s failed with error %s', $bridge->getName(), $e->getCode()),
+        $maintainer = $bridge->getMaintainer();
+        if (str_contains($maintainer, ',')) {
+            $maintainers = explode(',', $maintainer);
+        } else {
+            $maintainers = [$maintainer];
+        }
+        $maintainers = array_map('trim', $maintainers);
+
+        $query = [
+            'title' => $bridge->getName() . ' failed with: ' . $e->getMessage(),
             'body' => sprintf(
-                "```\n%s\n\n%s\n\nQuery string: %s\nVersion: %s\nOs: %s\nPHP version: %s\n```",
+                "```\n%s\n\n%s\n\nQuery string: %s\nVersion: %s\nOs: %s\nPHP version: %s\n```\nMaintainer: @%s",
                 $message,
                 implode("\n", trace_to_call_points(trace_from_exception($e))),
                 $_SERVER['QUERY_STRING'] ?? '',
                 Configuration::getVersion(),
                 PHP_OS_FAMILY,
-                phpversion() ?: 'Unknown'
+                phpversion() ?: 'Unknown',
+                implode(', @', $maintainers),
             ),
             'labels' => 'Bridge-Broken',
-            'assignee' => $bridge->getMaintainer(),
-        ]));
+            'assignee' => $maintainer[0],
+        ];
+
+        return 'https://github.com/RSS-Bridge/rss-bridge/issues/new?' . http_build_query($query);
     }
 
     private static function createGithubSearchUrl($bridge): string

From d050fe9a9b6476efde29891eb59e87505e3200bf Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Thu, 1 Aug 2024 12:36:26 +0200
Subject: [PATCH 437/716] [AnisearchBridge] fixed typo (#4182)

don't know why it was there
---
 bridges/AnisearchBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/AnisearchBridge.php b/bridges/AnisearchBridge.php
index 869b3049..c805cfcb 100644
--- a/bridges/AnisearchBridge.php
+++ b/bridges/AnisearchBridge.php
@@ -72,7 +72,7 @@ class AnisearchBridge extends BridgeAbstract
                     $ytlink = <<<EOT
                         <br /><iframe width="560" height="315" src="$trailer" title="YouTube video player"
                         frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
-                        referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>';
+                        referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
                     EOT;
                 }
             }

From 0051e0fcddfe008b34e990dce6e7e3c61bae3eea Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 1 Aug 2024 23:36:14 +0200
Subject: [PATCH 438/716] docs: improve docker docs (#4183)

* docs: improve docker docs

* fix: cleanup and remove duplicate docker instructions
---
 README.md                                     | 54 ++++++++++++-------
 docker-compose.yml                            |  9 ++++
 docs/01_General/03_Requirements.md            | 10 ----
 docs/03_For_Hosts/01_Installation.md          |  4 +-
 docs/03_For_Hosts/02_Updating.md              |  4 --
 docs/03_For_Hosts/03_Docker_Installation.md   | 49 -----------------
 docs/03_For_Hosts/index.md                    | 13 +++--
 .../07_Development_Environment_Setup.md       | 36 +------------
 8 files changed, 53 insertions(+), 126 deletions(-)
 create mode 100644 docker-compose.yml
 delete mode 100644 docs/03_For_Hosts/03_Docker_Installation.md

diff --git a/README.md b/README.md
index 982cd63b..b3b12f0e 100644
--- a/README.md
+++ b/README.md
@@ -53,9 +53,10 @@ Requires minimum PHP 7.4.
 
 ### How to install on traditional shared web hosting
 
-RSS-Bridge can basically be unzipped in a web folder. Should be working instantly.
+RSS-Bridge can basically be unzipped into a web folder. Should be working instantly.
 
-Latest zip as of Sep 2023: https://github.com/RSS-Bridge/rss-bridge/archive/refs/tags/2023-09-24.zip
+Latest zip:
+https://github.com/RSS-Bridge/rss-bridge/archive/refs/heads/master.zip (2MB)
 
 ### How to install on Debian 12 (nginx + php-fpm)
 
@@ -66,7 +67,7 @@ timedatectl set-timezone Europe/Oslo
 
 apt install git nginx php8.2-fpm php-mbstring php-simplexml php-curl php-intl
 
-# Create a new user account
+# Create a user account
 useradd --shell /bin/bash --create-home rss-bridge
 
 cd /var/www
@@ -101,7 +102,10 @@ Nginx config:
 
 server {
     listen 80;
+
+    # TODO: change to your own server name
     server_name example.com;
+
     access_log /var/log/nginx/rss-bridge.access.log;
     error_log /var/log/nginx/rss-bridge.error.log;
     log_not_found off;
@@ -150,8 +154,11 @@ listen = /run/php/rss-bridge.sock
 listen.owner = www-data
 listen.group = www-data
 
+# Create 10 workers standing by to serve requests
 pm = static
 pm.max_children = 10
+
+# Respawn worker after 500 requests (workaround for memory leaks etc.) 
 pm.max_requests = 500
 ```
 
@@ -179,7 +186,7 @@ Install the latest release.
 
 ```shell
 cd /var/www
-composer create-project -v --no-dev rss-bridge/rss-bridge
+composer create-project -v --no-dev --no-scripts rss-bridge/rss-bridge
 ```
 
 ### How to install with Caddy
@@ -192,8 +199,16 @@ Install by downloading the docker image from Docker Hub:
 
 ```bash
 # Create container
-docker create --name=rss-bridge --publish 3000:80 rssbridge/rss-bridge
+docker create --name=rss-bridge --publish 3000:80 --volume $(pwd)/config:/config rssbridge/rss-bridge
+```
 
+You can put custom `config.ini.php` and bridges into `./config`.
+
+**You must restart container for custom changes to take effect.**
+
+See `docker-entrypoint.sh` for details.
+
+```bash
 # Start container
 docker start rss-bridge
 ```
@@ -207,30 +222,29 @@ Browse http://localhost:3000/
 docker build -t rss-bridge .
 
 # Create container
-docker create --name rss-bridge --publish 3000:80 rss-bridge
+docker create --name rss-bridge --publish 3000:80 --volume $(pwd)/config:/config rss-bridge
+```
 
+You can put custom `config.ini.php` and bridges into `./config`.
+
+**You must restart container for custom changes to take effect.**
+
+See `docker-entrypoint.sh` for details.
+
+```bash
 # Start container
 docker start rss-bridge
 ```
 
 Browse http://localhost:3000/
 
-### Install with docker-compose
+### Install with docker-compose (using Docker Hub)
 
-Create a `docker-compose.yml` file locally with with the following content:
-```yml
-version: '2'
-services:
-  rss-bridge:
-    image: rssbridge/rss-bridge:latest
-    volumes:
-      - </local/custom/path>:/config
-    ports:
-      - 3000:80
-    restart: unless-stopped
-```
+You can put custom `config.ini.php` and bridges into `./config`.
 
-Then launch with `docker-compose`:
+**You must restart container for custom changes to take effect.**
+
+See `docker-entrypoint.sh` for details.
 
 ```bash
 docker-compose up
diff --git a/docker-compose.yml b/docker-compose.yml
new file mode 100644
index 00000000..9f178049
--- /dev/null
+++ b/docker-compose.yml
@@ -0,0 +1,9 @@
+version: '2'
+services:
+  rss-bridge:
+    image: rssbridge/rss-bridge:latest
+    volumes:
+      - ./config:/config
+    ports:
+      - 3000:80
+    restart: unless-stopped
diff --git a/docs/01_General/03_Requirements.md b/docs/01_General/03_Requirements.md
index 1ae5aa26..617cfadc 100644
--- a/docs/01_General/03_Requirements.md
+++ b/docs/01_General/03_Requirements.md
@@ -1,6 +1,4 @@
-**RSS-Bridge** requires either of the following:
 
-## A Web server* with:
 
   - PHP 7.4 (or higher)
   - [`openssl`](https://secure.php.net/manual/en/book.openssl.php) extension
@@ -14,11 +12,3 @@
   - [`sqlite3`](http://php.net/manual/en/book.sqlite3.php) extension (only when using SQLiteCache)
 
 Enable extensions by un-commenting the corresponding line in your PHP configuration (`php.ini`).
-
-
-## A Linux server with:
-
- - Docker server configured (Any recent version should do)
- - 100MB of disk space
-
-To setup RSS Bridge using Docker, see the [Docker Guide](../03_For_Hosts/03_Docker_Installation.md) on installing RSS Bridge.
\ No newline at end of file
diff --git a/docs/03_For_Hosts/01_Installation.md b/docs/03_For_Hosts/01_Installation.md
index 39df7918..729e6abb 100644
--- a/docs/03_For_Hosts/01_Installation.md
+++ b/docs/03_For_Hosts/01_Installation.md
@@ -7,6 +7,4 @@ In order to install RSS-Bridge on your own web server* do as follows:
 For linux hosts:
 * Grant read-write-access for `www-data` to the `./cache` directory (`chown -R www-data ./cache`)
 
-You have successfully installed RSS-Bridge.
-
-Instructions for Docker setups are at [Docker Installation](../03_For_Hosts/03_Docker_Installation.md)
\ No newline at end of file
+You have successfully installed RSS-Bridge.
\ No newline at end of file
diff --git a/docs/03_For_Hosts/02_Updating.md b/docs/03_For_Hosts/02_Updating.md
index 3ec98049..3484c6dc 100644
--- a/docs/03_For_Hosts/02_Updating.md
+++ b/docs/03_For_Hosts/02_Updating.md
@@ -8,10 +8,6 @@ Updating an existing installation is very simple, depending on your type of inst
 
 This will update all core files to the latest version. Your custom configuration and bridges are left untouched. Keep in mind that changes to any core file of RSS-Bridge will be replaced.
 
-## Docker
-
-Simply get the latest Docker build via `:latest` or specific builds via `:<tag-name>`.
-
 ## Heroku
 
 ### If you didn't fork the repo before
diff --git a/docs/03_For_Hosts/03_Docker_Installation.md b/docs/03_For_Hosts/03_Docker_Installation.md
deleted file mode 100644
index d895e748..00000000
--- a/docs/03_For_Hosts/03_Docker_Installation.md
+++ /dev/null
@@ -1,49 +0,0 @@
-This guide is for people who want to run RSS Bridge using Docker. If you want to run it a simple PHP Webhost environment, see [Installation](../03_For_Hosts/01_Installation.md) instead.
-
-## Setup
-
-### Create the container
-
-```bash
-docker create \
---name=rss-bridge \
---volume </local/custom/path>:/config \
---publish 3000:80 \
-rssbridge/rss-bridge:latest
-```
-### Run it
-```bash
-docker start rss-bridge
-```
-
-Access it using `http://IP_Address:3000`. If you'd like to run a specific version, you can run it by changing the ':latest' on the image to a tag listed [here](https://hub.docker.com/r/rssbridge/rss-bridge/tags/)
-
-The server runs on port 80 internally, map any port of your choice (in this example 3000).
-
-You can run it using a `docker-compose.yml` as well:
-
-```yml
-version: '2'
-services:
-  rss-bridge:
-    image: rssbridge/rss-bridge:latest
-    volumes:
-      - </local/custom/path>:/config
-    ports:
-      - 3000:80
-    restart: unless-stopped
-```
-
-# Container access and information
-
-|Function|Command|
-|----|----|
-|Shell access (live container)|`docker exec -it rss-bridge /bin/sh`|
-|Realtime container logs|`docker logs -f rss-bridge`|
-
-# Adding custom bridges and configurations
-If you want to add a bridge that is not part of [`/bridges`](https://github.com/RSS-Bridge/rss-bridge/tree/master/bridges), you can map a folder to the `/config` folder of the `rss-bridge` container.
-
-1. Create a folder in the location of your docker-compose.yml or your general docker working area (in this example it will be `/home/docker/rssbridge/config` ). 
-2. Copy your [custom bridges](../05_Bridge_API/01_How_to_create_a_new_bridge.md) to the `/home/docker/rssbridge/config` folder. Applies also to [config.ini.php](../03_For_Hosts/08_Custom_Configuration.md).
-3. Map the folder to `/config` inside the container. To do that, replace the `</local/custom/path>` from the previous examples with `/home/docker/rssbridge/config`
\ No newline at end of file
diff --git a/docs/03_For_Hosts/index.md b/docs/03_For_Hosts/index.md
index 1529cb37..b89f321a 100644
--- a/docs/03_For_Hosts/index.md
+++ b/docs/03_For_Hosts/index.md
@@ -1,11 +1,14 @@
 This section is directed at **hosts** and **server administrators**.
 
-To install RSS-Bridge, please follow the [installation instructions](../03_For_Hosts/01_Installation.md). You must have access to a web server with a working PHP environment!
+To install RSS-Bridge, please follow the [installation instructions](../03_For_Hosts/01_Installation.md).
+You must have access to a web server with a working PHP environment!
 
-RSS-Bridge comes with a large amount of bridges. Only few bridges are enabled by default. Unlock more bridges by adding them to the [whitelist](../03_For_Hosts/05_Whitelisting.md).
+RSS-Bridge comes with a large amount of bridges.
 
-Some bridges could be implemented more efficiently by actually using proprietary APIs, but there are reasons against it:
+Some bridges could be implemented more efficiently by actually using proprietary APIs,
+but there are reasons against it:
 
-- RSS-Bridge exists in the first place to NOT use APIs. See [the rant](https://github.com/RSS-Bridge/rss-bridge/blob/master/README.md#Rant)
+- RSS-Bridge exists in the first place to NOT use APIs.
+- See [the rant](https://github.com/RSS-Bridge/rss-bridge/blob/master/README.md#Rant)
 
-- APIs require private keys that could be stored on servers running RSS-Bridge, which is a security concern, involves complex authorizations for inexperienced users and could cause harm (when using paid services for example). In a closed environment (a server only you use for yourself) however you might be interested in using them anyway. So, check [this](https://github.com/RSS-Bridge/rss-bridge/pull/478/files) possible implementation of an anti-captcha solution.
\ No newline at end of file
+- APIs require private keys that could be stored on servers running RSS-Bridge,which is a security concern, involves complex authorizations for inexperienced users and could cause harm (when using paid services for example). In a closed environment (a server only you use for yourself) however you might be interested in using them anyway. So, check [this](https://github.com/RSS-Bridge/rss-bridge/pull/478/files) possible implementation of an anti-captcha solution.
\ No newline at end of file
diff --git a/docs/04_For_Developers/07_Development_Environment_Setup.md b/docs/04_For_Developers/07_Development_Environment_Setup.md
index 23a4b101..d3a5ee8d 100644
--- a/docs/04_For_Developers/07_Development_Environment_Setup.md
+++ b/docs/04_For_Developers/07_Development_Environment_Setup.md
@@ -1,39 +1,5 @@
-These are examples of how to setup a local development environment to add bridges, improve the docs, etc.
 
-## Docker
-
-The following can serve as an example for using docker:
-
-```
-# create a new directory
-mkdir rss-bridge-contribution
-cd rss-bridge-contribution
-
-# clone the project into a subfolder
-git clone https://github.com/RSS-Bridge/rss-bridge
-```
-
-Then add a `docker-compose.yml` file:
-
-```yml
-version: '3'
-
-services:
-  rss-bridge:
-    build:
-      context: ./rss-bridge
-    ports:
-      - 3000:80
-    volumes:
-      - ./config:/config
-      - ./rss-bridge/bridges:/app/bridges
-```
-
-You can then access RSS-Bridge at `localhost:3000` and [add your bridge](../05_Bridge_API/How_to_create_a_new_bridge) to the `rss-bridge/bridges` folder.
-
-If you need to edit any other files, like from the `lib` folder add this to the `volumes` section: `./rss-bridge/lib:/app/lib`.
-
-### Docs with Docker
+## Docs with Docker
 
 If you want to edit the docs add this to your docker-compose.yml:
 

From 401cc187b71661cad81a27381763059c047c69e4 Mon Sep 17 00:00:00 2001
From: Eugene Molotov <eugene.molotov@yandex.ru>
Date: Fri, 2 Aug 2024 20:44:46 +0500
Subject: [PATCH 439/716] [RutubeBridge] Fix playlist mode returning empty
 result (#4184)

---
 bridges/RutubeBridge.php | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/bridges/RutubeBridge.php b/bridges/RutubeBridge.php
index 6ec830aa..39577575 100644
--- a/bridges/RutubeBridge.php
+++ b/bridges/RutubeBridge.php
@@ -80,8 +80,10 @@ class RutubeBridge extends BridgeAbstract
             $videos = $reduxState->userChannel->videos->results;
             $this->title = $reduxState->userChannel->info->name;
         } elseif ($this->getInput('p')) {
-            $videos = $reduxState->playlist->data->results;
-            $this->title = $reduxState->playlist->title;
+            $playListVideosMethod = 'getPlaylistVideos(' . $this->getInput('p') . ')';
+            $videos = $reduxState->api->queries->$playListVideosMethod->data->results;
+            $playListMethod = 'getPlaylist(' . $this->getInput('p') . ')';
+            $this->title = $reduxState->api->queries->$playListMethod->data->title;
         } elseif ($this->getInput('s')) {
             $this->title = 'Поиск ' . $this->getInput('s');
         }

From 6ec91935462b2c24daf89b68283e1c413887f2bd Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 7 Aug 2024 00:21:06 +0200
Subject: [PATCH 440/716] yuop (#4193)

---
 actions/ConnectivityAction.php | 4 ++--
 actions/DetectAction.php       | 2 +-
 actions/DisplayAction.php      | 2 +-
 actions/FindfeedAction.php     | 2 +-
 actions/FrontpageAction.php    | 6 +++---
 actions/HealthAction.php       | 2 +-
 actions/ListAction.php         | 2 +-
 lib/ActionInterface.php        | 5 +----
 lib/RssBridge.php              | 5 +----
 9 files changed, 12 insertions(+), 18 deletions(-)

diff --git a/actions/ConnectivityAction.php b/actions/ConnectivityAction.php
index eb9edeb1..9732d0aa 100644
--- a/actions/ConnectivityAction.php
+++ b/actions/ConnectivityAction.php
@@ -19,7 +19,7 @@ class ConnectivityAction implements ActionInterface
         $this->bridgeFactory = new BridgeFactory();
     }
 
-    public function execute(Request $request)
+    public function __invoke(Request $request): Response
     {
         if (!Debug::isEnabled()) {
             return new Response('This action is only available in debug mode!', 403);
@@ -27,7 +27,7 @@ class ConnectivityAction implements ActionInterface
 
         $bridgeName = $request->get('bridge');
         if (!$bridgeName) {
-            return render_template('connectivity.html.php');
+            return new Response(render_template('connectivity.html.php'));
         }
         $bridgeClassName = $this->bridgeFactory->createBridgeClassName($bridgeName);
         if (!$bridgeClassName) {
diff --git a/actions/DetectAction.php b/actions/DetectAction.php
index 0c61f1b6..cebbc307 100644
--- a/actions/DetectAction.php
+++ b/actions/DetectAction.php
@@ -2,7 +2,7 @@
 
 class DetectAction implements ActionInterface
 {
-    public function execute(Request $request)
+    public function __invoke(Request $request): Response
     {
         $url = $request->get('url');
         $format = $request->get('format');
diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index d39d1812..aee47483 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -11,7 +11,7 @@ class DisplayAction implements ActionInterface
         $this->logger = RssBridge::getLogger();
     }
 
-    public function execute(Request $request)
+    public function __invoke(Request $request): Response
     {
         $bridgeName = $request->get('bridge');
         $format = $request->get('format');
diff --git a/actions/FindfeedAction.php b/actions/FindfeedAction.php
index 94dc6b72..6654ca6d 100644
--- a/actions/FindfeedAction.php
+++ b/actions/FindfeedAction.php
@@ -7,7 +7,7 @@
  */
 class FindfeedAction implements ActionInterface
 {
-    public function execute(Request $request)
+    public function __invoke(Request $request): Response
     {
         $url = $request->get('url');
         $format = $request->get('format');
diff --git a/actions/FrontpageAction.php b/actions/FrontpageAction.php
index 32795c45..c72dfd57 100644
--- a/actions/FrontpageAction.php
+++ b/actions/FrontpageAction.php
@@ -2,7 +2,7 @@
 
 final class FrontpageAction implements ActionInterface
 {
-    public function execute(Request $request)
+    public function __invoke(Request $request): Response
     {
         $messages = [];
         $activeBridges = 0;
@@ -26,13 +26,13 @@ final class FrontpageAction implements ActionInterface
         }
 
         // todo: cache this renderered template?
-        return render(__DIR__ . '/../templates/frontpage.html.php', [
+        return new Response(render(__DIR__ . '/../templates/frontpage.html.php', [
             'messages' => $messages,
             'admin_email' => Configuration::getConfig('admin', 'email'),
             'admin_telegram' => Configuration::getConfig('admin', 'telegram'),
             'bridges' => $body,
             'active_bridges' => $activeBridges,
             'total_bridges' => count($bridgeClassNames),
-        ]);
+        ]));
     }
 }
diff --git a/actions/HealthAction.php b/actions/HealthAction.php
index a38879c2..13365a3c 100644
--- a/actions/HealthAction.php
+++ b/actions/HealthAction.php
@@ -4,7 +4,7 @@ declare(strict_types=1);
 
 class HealthAction implements ActionInterface
 {
-    public function execute(Request $request)
+    public function __invoke(Request $request): Response
     {
         $response = [
             'code' => 200,
diff --git a/actions/ListAction.php b/actions/ListAction.php
index 3d9cdd73..3dd8f441 100644
--- a/actions/ListAction.php
+++ b/actions/ListAction.php
@@ -2,7 +2,7 @@
 
 class ListAction implements ActionInterface
 {
-    public function execute(Request $request)
+    public function __invoke(Request $request): Response
     {
         $list = new \stdClass();
         $list->bridges = [];
diff --git a/lib/ActionInterface.php b/lib/ActionInterface.php
index c0ddcf9f..d2e1c709 100644
--- a/lib/ActionInterface.php
+++ b/lib/ActionInterface.php
@@ -2,8 +2,5 @@
 
 interface ActionInterface
 {
-    /**
-     * @return string|Response
-     */
-    public function execute(Request $request);
+    public function __invoke(Request $request): Response;
 }
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index 1bb5f5ea..87b11f52 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -100,11 +100,8 @@ final class RssBridge
         $className = '\\' . $actionName;
         $actionObject = new $className();
 
-        $response = $actionObject->execute($request);
+        $response = $actionObject($request);
 
-        if (is_string($response)) {
-            $response = new Response($response);
-        }
         return $response;
     }
 

From 4faaa7910174d419152993bc268fb214dda5242e Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 7 Aug 2024 03:15:43 +0200
Subject: [PATCH 441/716] refactor: change the way dependencies are wired
 (#4194)

* refactor: change the way dependencies are setup

* lint
---
 bin/cache-clear                         | 17 ++++++-
 bin/cache-prune                         | 17 ++++++-
 caches/ArrayCache.php                   |  3 ++
 docs/04_For_Developers/05_Debug_mode.md | 14 +-----
 index.php                               | 63 +++++++++++++------------
 lib/Configuration.php                   |  3 ++
 lib/Debug.php                           |  3 ++
 lib/RssBridge.php                       | 35 ++++++--------
 lib/bootstrap.php                       |  6 ---
 lib/logger.php                          | 13 ++---
 10 files changed, 93 insertions(+), 81 deletions(-)

diff --git a/bin/cache-clear b/bin/cache-clear
index 3563abad..635f41d5 100755
--- a/bin/cache-clear
+++ b/bin/cache-clear
@@ -7,8 +7,21 @@
 
 require __DIR__ . '/../lib/bootstrap.php';
 
-$rssBridge = new RssBridge();
+$config = [];
+if (file_exists(__DIR__ . '/../config.ini.php')) {
+    $config = parse_ini_file(__DIR__ . '/../config.ini.php', true, INI_SCANNER_TYPED);
+    if (!$config) {
+        http_response_code(500);
+        exit("Error parsing config.ini.php\n");
+    }
+}
+Configuration::loadConfiguration($config, getenv());
 
-$cache = RssBridge::getCache();
+$logger = new SimpleLogger('rssbridge');
+
+$logger->addHandler(new StreamHandler('php://stderr', Logger::INFO));
+
+$cacheFactory = new CacheFactory($logger);
+$cache = $cacheFactory->create();
 
 $cache->clear();
diff --git a/bin/cache-prune b/bin/cache-prune
index 7b7a6031..281c019d 100755
--- a/bin/cache-prune
+++ b/bin/cache-prune
@@ -7,8 +7,21 @@
 
 require __DIR__ . '/../lib/bootstrap.php';
 
-$rssBridge = new RssBridge();
+$config = [];
+if (file_exists(__DIR__ . '/../config.ini.php')) {
+    $config = parse_ini_file(__DIR__ . '/../config.ini.php', true, INI_SCANNER_TYPED);
+    if (!$config) {
+        http_response_code(500);
+        exit("Error parsing config.ini.php\n");
+    }
+}
+Configuration::loadConfiguration($config, getenv());
 
-$cache = RssBridge::getCache();
+$logger = new SimpleLogger('rssbridge');
+
+$logger->addHandler(new StreamHandler('php://stderr', Logger::INFO));
+
+$cacheFactory = new CacheFactory($logger);
+$cache = $cacheFactory->create();
 
 $cache->prune();
diff --git a/caches/ArrayCache.php b/caches/ArrayCache.php
index efce4f35..55b18519 100644
--- a/caches/ArrayCache.php
+++ b/caches/ArrayCache.php
@@ -2,6 +2,9 @@
 
 declare(strict_types=1);
 
+/**
+ * Also known as an in-memory/runtime cache
+ */
 class ArrayCache implements CacheInterface
 {
     private array $data = [];
diff --git a/docs/04_For_Developers/05_Debug_mode.md b/docs/04_For_Developers/05_Debug_mode.md
index 6bdb1d48..7d503acd 100644
--- a/docs/04_For_Developers/05_Debug_mode.md
+++ b/docs/04_For_Developers/05_Debug_mode.md
@@ -1,6 +1,7 @@
 <h1 align="center">Warning!</h1>
 
-Enabling debug mode on a public server may result in malicious clients retrieving sensitive data about your server and possibly gaining access to it. Do not enable debug mode on a public server, unless you understand the implications of your doing!
+Enabling debug mode on a public server may result in malicious clients retrieving sensitive data about your server and possibly gaining access to it.
+Do not enable debug mode on a public server, unless you understand the implications of your doing!
 
 ***
 
@@ -20,14 +21,3 @@ _Notice_:
 * The bridge whitelist still applies! (debug mode does **not** enable all bridges)
 
 RSS-Bridge will give you a visual feedback when debug mode is enabled.
-
-While debug mode is active, RSS-Bridge will write additional data to your servers `error.log`.
-
-Debug mode is controlled by the static class `Debug`. It provides three core functions:
-
-* `Debug::isEnabled()`: Returns `true` if debug mode is enabled.
-* `Debug::log($message)`: Adds a message to `error.log`. It takes one parameter, which can be anything.
-
-Example: `Debug::log('Hello World!');`
-
-**Notice**: `Debug::log($message)` calls `Debug::isEnabled()` internally. You don't have to do that manually.
\ No newline at end of file
diff --git a/index.php b/index.php
index f23d8441..ccb2316f 100644
--- a/index.php
+++ b/index.php
@@ -2,25 +2,31 @@
 
 if (version_compare(\PHP_VERSION, '7.4.0') === -1) {
     http_response_code(500);
-    print 'RSS-Bridge requires minimum PHP version 7.4';
-    exit;
-}
-
-if (! is_readable(__DIR__ . '/lib/bootstrap.php')) {
-    http_response_code(500);
-    print 'Unable to read lib/bootstrap.php. Check file permissions.';
-    exit;
+    exit("RSS-Bridge requires minimum PHP version 7.4\n");
 }
 
 require_once __DIR__ . '/lib/bootstrap.php';
 
-set_exception_handler(function (\Throwable $e) {
+$config = [];
+if (file_exists(__DIR__ . '/config.ini.php')) {
+    $config = parse_ini_file(__DIR__ . '/config.ini.php', true, INI_SCANNER_TYPED);
+    if (!$config) {
+        http_response_code(500);
+        exit("Error parsing config.ini.php\n");
+    }
+}
+Configuration::loadConfiguration($config, getenv());
+
+$logger = new SimpleLogger('rssbridge');
+
+set_exception_handler(function (\Throwable $e) use ($logger) {
     $response = new Response(render(__DIR__ . '/templates/exception.html.php', ['e' => $e]), 500);
     $response->send();
-    RssBridge::getLogger()->error('Uncaught Exception', ['e' => $e]);
+    $logger->error('Uncaught Exception', ['e' => $e]);
 });
 
-set_error_handler(function ($code, $message, $file, $line) {
+set_error_handler(function ($code, $message, $file, $line) use ($logger) {
+    // Consider: ini_set('error_reporting', E_ALL & ~E_DEPRECATED);
     if ((error_reporting() & $code) === 0) {
         // Deprecation messages and other masked errors are typically ignored here
         return false;
@@ -35,11 +41,12 @@ set_error_handler(function ($code, $message, $file, $line) {
         sanitize_root($file),
         $line
     );
-    RssBridge::getLogger()->warning($text);
+    $logger->warning($text);
+    // todo: return false to prevent default error handler from running?
 });
 
 // There might be some fatal errors which are not caught by set_error_handler() or \Throwable.
-register_shutdown_function(function () {
+register_shutdown_function(function () use ($logger) {
     $error = error_get_last();
     if ($error) {
         $message = sprintf(
@@ -49,33 +56,29 @@ register_shutdown_function(function () {
             sanitize_root($error['file']),
             $error['line']
         );
-        RssBridge::getLogger()->error($message);
-        if (Debug::isEnabled()) {
-            // This output can interfere with json output etc
-            // This output is written at the bottom
-            print sprintf("<pre>%s</pre>\n", e($message));
-        }
+        $logger->error($message);
     }
 });
 
-$errors = Configuration::checkInstallation();
-if ($errors) {
-    http_response_code(500);
-    print '<pre>' . implode("\n", $errors) . '</pre>';
-    exit;
+$cacheFactory = new CacheFactory($logger);
+if (Debug::isEnabled()) {
+    $logger->addHandler(new StreamHandler('php://stderr', Logger::DEBUG));
+    $cache = $cacheFactory->create('array');
+} else {
+    $logger->addHandler(new StreamHandler('php://stderr', Logger::INFO));
+    $cache = $cacheFactory->create();
 }
-
-// Consider: ini_set('error_reporting', E_ALL & ~E_DEPRECATED);
+$httpClient = new CurlHttpClient();
 
 date_default_timezone_set(Configuration::getConfig('system', 'timezone'));
 
 try {
-    $rssBridge = new RssBridge();
+    $rssBridge = new RssBridge($logger, $cache, $httpClient);
     $response = $rssBridge->main($argv ?? []);
     $response->send();
 } catch (\Throwable $e) {
     // Probably an exception inside an action
-    RssBridge::getLogger()->error('Exception in RssBridge::main()', ['e' => $e]);
-    http_response_code(500);
-    print render(__DIR__ . '/templates/exception.html.php', ['e' => $e]);
+    $logger->error('Exception in RssBridge::main()', ['e' => $e]);
+    $response = new Response(render(__DIR__ . '/templates/exception.html.php', ['e' => $e]), 500);
+    $response->send();
 }
diff --git a/lib/Configuration.php b/lib/Configuration.php
index 63f67a3c..b104a251 100644
--- a/lib/Configuration.php
+++ b/lib/Configuration.php
@@ -198,6 +198,9 @@ final class Configuration
 
     public static function getConfig(string $section, string $key, $default = null)
     {
+        if (self::$config === []) {
+            throw new \Exception('Config has not been loaded');
+        }
         return self::$config[strtolower($section)][strtolower($key)] ?? $default;
     }
 
diff --git a/lib/Debug.php b/lib/Debug.php
index 4333b3a5..ba9e787e 100644
--- a/lib/Debug.php
+++ b/lib/Debug.php
@@ -16,6 +16,9 @@ class Debug
         return false;
     }
 
+    /**
+     * @deprecated Use $this->logger->debug()
+     */
     public static function log($message)
     {
         $e = new \Exception();
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index 87b11f52..e80e6f0a 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -2,25 +2,18 @@
 
 final class RssBridge
 {
-    private static CacheInterface $cache;
     private static Logger $logger;
+    private static CacheInterface $cache;
     private static HttpClient $httpClient;
 
-    public function __construct()
-    {
-        self::$logger = new SimpleLogger('rssbridge');
-        if (Debug::isEnabled()) {
-            self::$logger->addHandler(new StreamHandler(Logger::DEBUG));
-        } else {
-            self::$logger->addHandler(new StreamHandler(Logger::INFO));
-        }
-        self::$httpClient = new CurlHttpClient();
-        $cacheFactory = new CacheFactory(self::$logger);
-        if (Debug::isEnabled()) {
-            self::$cache = $cacheFactory->create('array');
-        } else {
-            self::$cache = $cacheFactory->create();
-        }
+    public function __construct(
+        Logger $logger,
+        CacheInterface $cache,
+        HttpClient $httpClient
+    ) {
+        self::$logger = $logger;
+        self::$cache = $cache;
+        self::$httpClient = $httpClient;
     }
 
     public function main(array $argv = []): Response
@@ -105,16 +98,16 @@ final class RssBridge
         return $response;
     }
 
-    public static function getCache(): CacheInterface
-    {
-        return self::$cache;
-    }
-
     public static function getLogger(): Logger
     {
         return self::$logger;
     }
 
+    public static function getCache(): CacheInterface
+    {
+        return self::$cache;
+    }
+
     public static function getHttpClient(): HttpClient
     {
         return self::$httpClient;
diff --git a/lib/bootstrap.php b/lib/bootstrap.php
index bfc7be39..1d866067 100644
--- a/lib/bootstrap.php
+++ b/lib/bootstrap.php
@@ -45,9 +45,3 @@ spl_autoload_register(function ($className) {
         }
     }
 });
-
-$customConfig = [];
-if (file_exists(__DIR__ . '/../config.ini.php')) {
-    $customConfig = parse_ini_file(__DIR__ . '/../config.ini.php', true, INI_SCANNER_TYPED);
-}
-Configuration::loadConfiguration($customConfig, getenv());
diff --git a/lib/logger.php b/lib/logger.php
index e579915d..916e65ed 100644
--- a/lib/logger.php
+++ b/lib/logger.php
@@ -83,10 +83,12 @@ final class SimpleLogger implements Logger
 
 final class StreamHandler
 {
+    private $stream;
     private int $level;
 
-    public function __construct(int $level = Logger::DEBUG)
+    public function __construct(string $stream, int $level = Logger::DEBUG)
     {
+        $this->stream = $stream;
         $this->level = $level;
     }
 
@@ -147,13 +149,8 @@ final class StreamHandler
             $record['message'],
             $context
         );
-        error_log($text);
-        if ($record['level'] < Logger::ERROR && Debug::isEnabled()) {
-            // The record level is INFO or WARNING here
-            // Not a good idea to print here because http headers might not have been sent
-            print sprintf("<pre>%s</pre>\n", e($text));
-        }
-        //$bytes = file_put_contents('/tmp/rss-bridge.log', $text, FILE_APPEND | LOCK_EX);
+
+        $bytes = file_put_contents($this->stream, $text, FILE_APPEND | LOCK_EX);
     }
 }
 

From 313be4c5125158f1413afc1269135d939d976cc0 Mon Sep 17 00:00:00 2001
From: Christian Schabesberger <chris.schabesberger@mailbox.org>
Date: Wed, 7 Aug 2024 15:51:44 +0200
Subject: [PATCH 442/716] replace self:: with -> for methodcalls in Nordbayern
 bridge (#4195)

---
 bridges/NordbayernBridge.php | 41 ++++++++++++++++++------------------
 1 file changed, 21 insertions(+), 20 deletions(-)

diff --git a/bridges/NordbayernBridge.php b/bridges/NordbayernBridge.php
index a5f34817..48157921 100644
--- a/bridges/NordbayernBridge.php
+++ b/bridges/NordbayernBridge.php
@@ -53,6 +53,19 @@ class NordbayernBridge extends BridgeAbstract
         ]
     ]];
 
+    public function collectData()
+    {
+        $region = $this->getInput('region');
+        if ($region === 'rothenburg-o-d-t') {
+            $region = 'rothenburg-ob-der-tauber';
+        }
+        $url = self::URI . '/region/' . $region;
+        $listSite = getSimpleHTMLDOM($url);
+
+        $this->handleNewsblock($listSite);
+    }
+
+
     private function getValidImage($picture)
     {
         $img = $picture->find('img', 0);
@@ -75,23 +88,23 @@ class NordbayernBridge extends BridgeAbstract
             ) {
                 $content .= $element;
             } elseif ($element->tag === 'main') {
-                $content .= self::getUseFullContent($element->find('article', 0));
+                $content .= $this->getUseFullContent($element->find('article', 0));
             } elseif ($element->tag === 'header') {
-                $content .= self::getUseFullContent($element);
+                $content .= $this->getUseFullContent($element);
             } elseif (
                 $element->tag === 'div' &&
                 !str_contains($element->class, 'article__infobox') &&
                 !str_contains($element->class, 'authorinfo')
             ) {
-                $content .= self::getUseFullContent($element);
+                $content .= $this->getUseFullContent($element);
             } elseif (
                 $element->tag === 'section' &&
                 (str_contains($element->class, 'article__richtext') ||
                     str_contains($element->class, 'article__context'))
             ) {
-                $content .= self::getUseFullContent($element);
+                $content .= $this->getUseFullContent($element);
             } elseif ($element->tag === 'picture') {
-                $content .= self::getValidImage($element);
+                $content .= $this->getValidImage($element);
             } elseif ($element->tag === 'ul') {
                 $content .= $element;
             }
@@ -146,8 +159,8 @@ class NordbayernBridge extends BridgeAbstract
             // of the title image. If we didn't do this some rss programs
             // would show the subtitle of the title image as teaser instead
             // of the actuall article teaser.
-            $item['content'] .= self::getTeaser($content);
-            $item['content'] .= self::getUseFullContent($content);
+            $item['content'] .= $this->getTeaser($content);
+            $item['content'] .= $this->getUseFullContent($content);
         }
 
 
@@ -169,7 +182,7 @@ class NordbayernBridge extends BridgeAbstract
                 continue;
             }
 
-            $item = self::getArticle($url);
+            $item = $this->getArticle($url);
 
             // exclude police reports if desired
             if (
@@ -190,16 +203,4 @@ class NordbayernBridge extends BridgeAbstract
             $this->items[] = $item;
         }
     }
-
-    public function collectData()
-    {
-        $region = $this->getInput('region');
-        if ($region === 'rothenburg-o-d-t') {
-            $region = 'rothenburg-ob-der-tauber';
-        }
-        $url = self::URI . '/region/' . $region;
-        $listSite = getSimpleHTMLDOM($url);
-
-        self::handleNewsblock($listSite);
-    }
 }

From c11bc184caec2537f80161ca4d792fa238ddeceb Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 7 Aug 2024 18:09:44 +0200
Subject: [PATCH 443/716] fix: restore php error_log writing (#4196)

---
 index.php      |  5 +--
 lib/logger.php | 83 +++++++++++++++++++++++++++++++++++---------------
 2 files changed, 61 insertions(+), 27 deletions(-)

diff --git a/index.php b/index.php
index ccb2316f..d29900f7 100644
--- a/index.php
+++ b/index.php
@@ -61,11 +61,12 @@ register_shutdown_function(function () use ($logger) {
 });
 
 $cacheFactory = new CacheFactory($logger);
+
 if (Debug::isEnabled()) {
-    $logger->addHandler(new StreamHandler('php://stderr', Logger::DEBUG));
+    $logger->addHandler(new ErrorLogHandler(Logger::DEBUG));
     $cache = $cacheFactory->create('array');
 } else {
-    $logger->addHandler(new StreamHandler('php://stderr', Logger::INFO));
+    $logger->addHandler(new ErrorLogHandler(Logger::INFO));
     $cache = $cacheFactory->create();
 }
 $httpClient = new CurlHttpClient();
diff --git a/lib/logger.php b/lib/logger.php
index 916e65ed..3ebe3b0a 100644
--- a/lib/logger.php
+++ b/lib/logger.php
@@ -68,6 +68,16 @@ final class SimpleLogger implements Logger
 
     private function log(int $level, string $message, array $context = []): void
     {
+        $ignoredMessages = [
+            'Format name invalid',
+            'Unknown format given',
+            'Unable to find channel',
+        ];
+        foreach ($ignoredMessages as $ignoredMessage) {
+            if (str_starts_with($message, $ignoredMessage)) {
+                return;
+            }
+        }
         foreach ($this->handlers as $handler) {
             $handler([
                 'name'          => $this->name,
@@ -83,7 +93,7 @@ final class SimpleLogger implements Logger
 
 final class StreamHandler
 {
-    private $stream;
+    private string $stream;
     private int $level;
 
     public function __construct(string $stream, int $level = Logger::DEBUG)
@@ -108,28 +118,6 @@ final class StreamHandler
             $record['context']['line'] = $e->getLine();
             $record['context']['url'] = get_current_url();
             $record['context']['trace'] = trace_to_call_points(trace_from_exception($e));
-
-            $ignoredExceptions = [
-                'You must specify a format',
-                'Format name invalid',
-                'Unknown format given',
-                'Bridge name invalid',
-                'Invalid action',
-                'twitter: No results for this query',
-                // telegram
-                'Unable to find channel. The channel is non-existing or non-public',
-                // fb
-                'This group is not public! RSS-Bridge only supports public groups!',
-                'You must be logged in to view this page',
-                'Unable to get the page id. You should consider getting the ID by hand',
-                // tiktok 404
-                'https://www.tiktok.com/@',
-            ];
-            foreach ($ignoredExceptions as $ignoredException) {
-                if (str_starts_with($e->getMessage(), $ignoredException)) {
-                    return;
-                }
-            }
         }
         $context = '';
         if ($record['context']) {
@@ -145,15 +133,60 @@ final class StreamHandler
             $record['created_at']->format('Y-m-d H:i:s'),
             $record['name'],
             $record['level_name'],
-            // Should probably sanitize message for output context
             $record['message'],
             $context
         );
-
         $bytes = file_put_contents($this->stream, $text, FILE_APPEND | LOCK_EX);
     }
 }
 
+final class ErrorLogHandler
+{
+    private int $level;
+
+    public function __construct(int $level = Logger::DEBUG)
+    {
+        $this->level = $level;
+    }
+
+    public function __invoke(array $record)
+    {
+        if ($record['level'] < $this->level) {
+            return;
+        }
+        if (isset($record['context']['e'])) {
+            /** @var \Throwable $e */
+            $e = $record['context']['e'];
+            unset($record['context']['e']);
+            $record['context']['type'] = get_class($e);
+            $record['context']['code'] = $e->getCode();
+            $record['context']['message'] = sanitize_root($e->getMessage());
+            $record['context']['file'] = sanitize_root($e->getFile());
+            $record['context']['line'] = $e->getLine();
+            $record['context']['url'] = get_current_url();
+            $record['context']['trace'] = trace_to_call_points(trace_from_exception($e));
+        }
+        $context = '';
+        if ($record['context']) {
+            try {
+                $context = Json::encode($record['context']);
+            } catch (\JsonException $e) {
+                $record['context']['message'] = null;
+                $context = Json::encode($record['context']);
+            }
+        }
+        $text = sprintf(
+            "[%s] %s.%s %s %s\n",
+            $record['created_at']->format('Y-m-d H:i:s'),
+            $record['name'],
+            $record['level_name'],
+            $record['message'],
+            $context
+        );
+        error_log($text);
+    }
+}
+
 final class NullLogger implements Logger
 {
     public function debug(string $message, array $context = [])

From 9215b95779ff2f0bd8a74d7213f3bfa09e452088 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 7 Aug 2024 18:56:27 +0200
Subject: [PATCH 444/716] fix: bug in prior refactor (#4197)

---
 actions/DisplayAction.php | 2 +-
 lib/FeedItem.php          | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index aee47483..c51bb7cd 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -145,7 +145,7 @@ class DisplayAction implements ActionInterface
             if ($errorCount >= $reportLimit) {
                 if ($errorOutput === 'feed') {
                     // Render the exception as a feed item
-                    $items[] = $this->createFeedItemFromException($e, $bridge);
+                    $items = [$this->createFeedItemFromException($e, $bridge)];
                 } elseif ($errorOutput === 'http') {
                     return new Response(render(__DIR__ . '/../templates/exception.html.php', ['e' => $e]), 500);
                 } elseif ($errorOutput === 'none') {
diff --git a/lib/FeedItem.php b/lib/FeedItem.php
index 09aab129..8a092a27 100644
--- a/lib/FeedItem.php
+++ b/lib/FeedItem.php
@@ -136,7 +136,7 @@ class FeedItem
     {
         $this->title = null;
         if (!is_string($title)) {
-            Debug::log('Title must be a string!');
+            trigger_error('Title must be a string: ' . print_r($title, true));
         } else {
             $this->title = truncate(trim($title));
         }

From ee54cf457623afd48538b844d1fbb8b714be7674 Mon Sep 17 00:00:00 2001
From: Christian Schabesberger <chris.schabesberger@mailbox.org>
Date: Thu, 8 Aug 2024 00:00:26 +0200
Subject: [PATCH 445/716] add NurembergerNachrichten bridge (#4185)

* add NurembergerNachrichten bridge

apply suggested changes and fix regions

put collectData on top

replace self:: with -> for methodcalls

* refactor: remove unused var

* refactor: order methods

* fix

---------

Co-authored-by: Dag <me@dvikan.no>
---
 bridges/NurembergerNachrichtenBridge.php | 178 +++++++++++++++++++++++
 1 file changed, 178 insertions(+)
 create mode 100644 bridges/NurembergerNachrichtenBridge.php

diff --git a/bridges/NurembergerNachrichtenBridge.php b/bridges/NurembergerNachrichtenBridge.php
new file mode 100644
index 00000000..10644212
--- /dev/null
+++ b/bridges/NurembergerNachrichtenBridge.php
@@ -0,0 +1,178 @@
+<?php
+
+class NurembergerNachrichtenBridge extends BridgeAbstract
+{
+    const MAINTAINER = 'schabi.org';
+    const NAME = 'Nürnberger Nachrichten';
+    const CACHE_TIMEOUT = 3600;
+    const URI = 'https://www.nn.de';
+    const DESCRIPTION = 'Bridge for Bavarian regional news site nordbayern.de';
+    const PARAMETERS = [ [
+        'region' => [
+            'name' => 'region',
+            'type' => 'list',
+            'exampleValue' => 'Nürnberg',
+            'title' => 'Select a region',
+            'values' => [
+                'Ansbach' => 'ansbach',
+                'Erlangen' => 'erlangen',
+                'Erlangen-Höchstadt' => 'erlangen-hoechstadt',
+                'Forchheim' => 'forchheim',
+                'Fürth' => 'fuerth',
+                'Gunzenhausen' => 'gunzenhausen',
+                'Neumarkt' => 'neumarkt',
+                'Neustadt/Aisch-Bad Windsheim' => 'neustadt-aisch-bad-windsheim',
+                'Nürnberg' => 'nuernberg',
+                'Nürnberger Land' => 'nuernberger-land',
+                'Pegnitz' => 'pegnitz',
+                'Roth' => 'roth',
+                'Schwabach' => 'schwabach',
+                'Weißenburg' => 'weissenburg'
+            ]
+        ],
+        'hideNNPlus' => [
+            'name' => 'Hide NN+ articles',
+            'type' => 'checkbox',
+            'exampleValue' => 'unchecked',
+            'title' => 'Hide all paywall articles on NN'
+        ],
+    ]];
+
+    public function collectData()
+    {
+        $region = $this->getInput('region');
+        if (
+            $region === 'neustadt-aisch-bad-windsheim' ||
+            $region === 'erlangen-hoechstadt' ||
+            $region === ''
+        ) {
+            $region = 'region/' . $region;
+        }
+        $url = self::URI . '/' . $region;
+        $listSite = getSimpleHTMLDOM($url);
+
+        $this->handleNewsblock($listSite);
+    }
+
+    private function handleNewsblock($listSite)
+    {
+        $main = $listSite->find('main', 0);
+        foreach ($main->find('article') as $article) {
+            $url = $article->find('a', 0)->href;
+            $url = urljoin(self::URI, $url);
+
+            $articleContent = getSimpleHTMLDOMCached($url, 86400 * 7);
+
+            // exclude nn+ articles if desired
+            if (
+                $this->getInput('hideNNPlus') &&
+                str_contains($articleContent->find('article[id=article]', 0)->find('header', 0), 'icon-nnplus')
+            ) {
+                continue;
+            }
+
+            $item = $this->parseArticle($articleContent, $url);
+            $articleContent->clear();
+
+            $this->items[] = $item;
+        }
+    }
+
+    private function parseArticle($article, $link)
+    {
+        $item = [];
+        defaultLinkTo($article, self::URI);
+
+        $item['uri'] = $link;
+
+        $author = $article->find('.article__author', 1);
+        if ($author !== null) {
+            $item['author'] = trim($author->plaintext);
+        }
+
+        $createdAt = $article->find('[class=article__release]', 0);
+        if ($createdAt) {
+            $item['timestamp'] = strtotime(str_replace('Uhr', '', $createdAt->plaintext));
+        }
+
+        if ($article->find('h2', 0) === null) {
+            $item['title'] = $article->find('h3', 0)->innertext;
+        } else {
+            $item['title'] = $article->find('h2', 0)->innertext;
+        }
+        $item['content'] = '';
+
+        if ($article->find('section[class*=article__richtext]', 0) === null) {
+            $content = $article->find('div[class*=modul__teaser]', 0)->find('p', 0);
+            $item['content'] .= $content;
+        } else {
+            $content = $article->find('article', 0);
+            // change order of article teaser in order to show it on top
+            // of the title image. If we didn't do this some rss programs
+            // would show the subtitle of the title image as teaser instead
+            // of the actuall article teaser.
+            $item['content'] .= $this->getTeaser($content);
+            $item['content'] .= $this->getUseFullContent($content);
+        }
+
+        return $item;
+    }
+
+    private function getTeaser($content)
+    {
+        $teaser = $content->find('p[class=article__teaser]', 0);
+        if ($teaser === null) {
+            return '';
+        }
+        $teaser = $teaser->plaintext;
+        $teaser = preg_replace('/[ ]{2,}/', ' ', $teaser);
+        $teaser = '<p class="article__teaser">' . $teaser . '</p>';
+        return $teaser;
+    }
+
+    private function getUseFullContent($rawContent)
+    {
+        $content = '';
+        foreach ($rawContent->children as $element) {
+            if (
+                ($element->tag === 'p' || $element->tag === 'h3') &&
+                $element->class !== 'article__teaser'
+            ) {
+                $content .= $element;
+            } elseif ($element->tag === 'main') {
+                $content .= $this->getUseFullContent($element->find('article', 0));
+            } elseif ($element->tag === 'header') {
+                $content .= $this->getUseFullContent($element);
+            } elseif (
+                $element->tag === 'div' &&
+                !str_contains($element->class, 'article__infobox') &&
+                !str_contains($element->class, 'authorinfo')
+            ) {
+                $content .= $this->getUseFullContent($element);
+            } elseif (
+                $element->tag === 'section' &&
+                (str_contains($element->class, 'article__richtext') ||
+                    str_contains($element->class, 'article__context'))
+            ) {
+                $content .= $this->getUseFullContent($element);
+            } elseif ($element->tag === 'picture') {
+                $content .= $this->getValidImage($element);
+            } elseif ($element->tag === 'ul') {
+                $content .= $element;
+            }
+        }
+        return $content;
+    }
+
+    private function getValidImage($picture)
+    {
+        $img = $picture->find('img', 0);
+        if ($img) {
+            $imgUrl = $img->src;
+            if (!preg_match('#/logo-.*\.png#', $imgUrl)) {
+                return '<br><img src="' . $imgUrl . '">';
+            }
+        }
+        return '';
+    }
+}

From b25a779d98e4ed674496e6184b424e0a594f2364 Mon Sep 17 00:00:00 2001
From: Pavel Korytov <thexcloud@gmail.com>
Date: Thu, 8 Aug 2024 01:27:33 +0300
Subject: [PATCH 446/716] [TldrTechBridge] Fix bridge (#4187)

* [TldrTechBridge] Fix bridge

* yup

---------

Co-authored-by: Dag <me@dvikan.no>
---
 bridges/TldrTechBridge.php | 64 ++++++++++++++++++++++----------------
 1 file changed, 38 insertions(+), 26 deletions(-)

diff --git a/bridges/TldrTechBridge.php b/bridges/TldrTechBridge.php
index d2955347..6c96dff7 100644
--- a/bridges/TldrTechBridge.php
+++ b/bridges/TldrTechBridge.php
@@ -1,12 +1,12 @@
 <?php
 
+declare(strict_types=1);
+
 class TldrTechBridge extends BridgeAbstract
 {
     const MAINTAINER = 'sqrtminusone';
     const NAME = 'TLDR Tech Newsletter Bridge';
     const URI = 'https://tldr.tech/';
-
-    const CACHE_TIMEOUT = 3600; // 1 hour
     const DESCRIPTION = 'Return newsletter articles from TLDR Tech';
 
     const PARAMETERS = [
@@ -41,41 +41,53 @@ class TldrTechBridge extends BridgeAbstract
     {
         $topic = $this->getInput('topic');
         $limit = $this->getInput('limit');
-        $url = self::URI . $topic . '/archives';
-        $html = getSimpleHTMLDOM($url);
-        $entries_root = $html->find('div.content-center.mt-5', 0);
-        $added = 0;
+
+        $url = self::URI . 'api/latest/' . $topic;
+        $response = getContents($url, [], [], true);
+        $location = $response->getHeader('Location');
+        $locationUrl = Url::fromString($location);
+
+        $this->extractItem($locationUrl);
+
+        $archives_url = self::URI . $topic . '/archives';
+        $archives_html = getSimpleHTMLDOM($archives_url);
+        $entries_root = $archives_html->find('div.content-center.mt-5', 0);
         foreach ($entries_root->children() as $child) {
             if ($child->tag != 'a') {
                 continue;
             }
-            // Convert /<topic>/2023-01-01 to unix timestamp
-            $date_items = explode('/', $child->href);
-            $date = strtotime(end($date_items));
-            $item_url = self::URI . ltrim($child->href, '/');
-            try {
-                $this->items[] = [
-                    'uri'       => self::URI . $child->href,
-                    'title'     => $child->plaintext,
-                    'timestamp' => $date,
-                    'content'   => $this->extractContent($item_url),
-                ];
-            } catch (HttpException $e) {
-                continue;
-            }
-            $added++;
-            if ($added >= $limit) {
+            $this->extractItem(Url::fromString(self::URI . $child->href));
+            if (count($this->items) >= $limit) {
                 break;
             }
         }
     }
 
+    private function extractItem(Url $url)
+    {
+        $pathParts = explode('/', $url->getPath());
+        $date = strtotime(end($pathParts));
+        try {
+            [$content, $title] = $this->extractContent($url);
+
+            $this->items[] = [
+                'uri'       => (string) $url,
+                'title'     => $title,
+                'timestamp' => $date,
+                'content'   => $content,
+            ];
+        } catch (HttpException $e) {
+            // archive occasionally returns broken URLs
+            return;
+        }
+    }
+
     private function extractContent($url)
     {
-        $html = getSimpleHTMLDOM($url);
+        $html = getSimpleHTMLDOMCached($url);
         $content = $html->find('div.content-center.mt-5', 0);
         if (!$content) {
-            throw new HttpException('Could not find content', 500);
+            throw new \Exception('Could not find content');
         }
         $subscribe_form = $content->find('div.mt-5 > div > form', 0);
         if ($subscribe_form) {
@@ -112,7 +124,7 @@ class TldrTechBridge extends BridgeAbstract
                 }
             }
         }
-
-        return $content->innertext;
+        $title = $content->find('h2', 0);
+        return [$content->innertext, $title->plaintext];
     }
 }

From 829d570f8e4f6b38f04b2fac4a3da387e64bf403 Mon Sep 17 00:00:00 2001
From: "Quentin B." <quent1-fr@users.noreply.github.com>
Date: Thu, 8 Aug 2024 00:57:40 +0200
Subject: [PATCH 447/716] [CentreFranceBridge] Add bridge (#4189)

* [CentreFranceBridge] Add bridge

* [CentreFranceBridge] Fix bridge

* [CentreFranceBridge] Fix bridge

* [CentreFranceBridge] Improved icon choice

* [CentreFranceBridge] Fetch additional data from articles

* [CentreFranceBridge] New parameter to allow client to control how many articles to fetch

* [CentreFranceBridge] Improve bridge name based on existing parameters

* [CentreFranceBridge] Fixed some edge cases

* refactor: reorder

* fix

---------

Co-authored-by: Dag <me@dvikan.no>
---
 bridges/CentreFranceBridge.php        | 279 ++++++++++++++++++++++++++
 lib/contents.php                      |   4 +-
 lib/simplehtmldom/simple_html_dom.php |   5 -
 3 files changed, 281 insertions(+), 7 deletions(-)
 create mode 100644 bridges/CentreFranceBridge.php

diff --git a/bridges/CentreFranceBridge.php b/bridges/CentreFranceBridge.php
new file mode 100644
index 00000000..a6dea227
--- /dev/null
+++ b/bridges/CentreFranceBridge.php
@@ -0,0 +1,279 @@
+<?php
+
+class CentreFranceBridge extends BridgeAbstract
+{
+    const NAME = 'Centre France Newspapers';
+    const URI = 'https://www.centrefrance.com/';
+    const DESCRIPTION = 'Common bridge for all Centre France group newspapers.';
+    const CACHE_TIMEOUT = 7200; // 2h
+    const MAINTAINER = 'quent1';
+    const PARAMETERS = [
+        'global' => [
+            'newspaper' => [
+                'name' => 'Newspaper',
+                'type' => 'list',
+                'values' => [
+                    'La Montagne' => 'lamontagne.fr',
+                    'Le Populaire du Centre' => 'lepopulaire.fr',
+                    'La République du Centre' => 'larep.fr',
+                    'Le Berry Républicain' => 'leberry.fr',
+                    'L\'Yonne Républicaine' => 'lyonne.fr',
+                    'L\'Écho Républicain' => 'lechorepublicain.fr',
+                    'Le Journal du Centre' => 'lejdc.fr',
+                    'L\'Éveil de la Haute-Loire' => 'leveil.fr',
+                    'Le Pays' => 'le-pays.fr'
+                ]
+            ],
+            'remove-reserved-for-subscribers-articles' => [
+                'name' => 'Remove reserved for subscribers articles',
+                'type' => 'checkbox',
+                'title' => 'Filter out articles that are only available to subscribers'
+            ],
+            'limit' => [
+                'name' => 'Limit',
+                'type' => 'number',
+                'title' => 'How many articles to fetch. 0 to disable.',
+                'required' => true,
+                'defaultValue' => 15
+            ]
+        ],
+        'Local news' => [
+            'locality-slug' => [
+                'name' => 'Locality slug',
+                'type' => 'text',
+                'required' => false,
+                'title' => 'Fetch articles for a specific locality. If not set, headlines from the front page will be used instead.',
+                'exampleValue' => 'moulins-03000'
+            ],
+        ]
+    ];
+
+    public function collectData()
+    {
+        $value = $this->getInput('limit');
+        if (is_numeric($value) && (int)$value >= 0) {
+            $limit = $value;
+        } else {
+            $limit = static::PARAMETERS['global']['limit']['defaultValue'];
+        }
+
+        if (empty($this->getInput('newspaper'))) {
+            return;
+        }
+
+        $localitySlug = $this->getInput('locality-slug') ?? '';
+        $alreadyFoundArticlesURIs = [];
+
+        $newspaperUrl = 'https://www.' . $this->getInput('newspaper') . '/' . $localitySlug . '/';
+        $html = getSimpleHTMLDOM($newspaperUrl);
+
+        // Articles are detected through their titles
+        foreach ($html->find('.c-titre') as $articleTitleDOMElement) {
+            $articleLinkDOMElement = $articleTitleDOMElement->find('a', 0);
+
+            // Ignore articles in the « Les + partagés » block
+            if (strpos($articleLinkDOMElement->id, 'les_plus_partages') !== false) {
+                continue;
+            }
+
+            $articleURI = $articleLinkDOMElement->href;
+
+            // If the URI has already been processed, ignore it
+            if (in_array($articleURI, $alreadyFoundArticlesURIs, true)) {
+                continue;
+            }
+
+            // If news are filtered for a specific locality, filter out article for other localities
+            if ($localitySlug !== '' && !str_contains($articleURI, $localitySlug)) {
+                continue;
+            }
+
+            $articleTitle = '';
+
+            // If article is reserved for subscribers
+            if ($articleLinkDOMElement->find('span.premium-picto', 0)) {
+                if ($this->getInput('remove-reserved-for-subscribers-articles') === true) {
+                    continue;
+                }
+
+                $articleTitle .= '🔒 ';
+            }
+
+            $articleTitleDOMElement = $articleLinkDOMElement->find('span[data-tb-title]', 0);
+            if ($articleTitleDOMElement === null) {
+                continue;
+            }
+
+            if ($limit > 0 && count($this->items) === $limit) {
+                break;
+            }
+
+            $articleTitle .= $articleLinkDOMElement->find('span[data-tb-title]', 0)->innertext;
+            $articleFullURI = urljoin('https://www.' . $this->getInput('newspaper') . '/', $articleURI);
+
+            $item = [
+                'title' => $articleTitle,
+                'uri' => $articleFullURI,
+                ...$this->collectArticleData($articleFullURI)
+            ];
+            $this->items[] = $item;
+
+            $alreadyFoundArticlesURIs[] = $articleURI;
+        }
+    }
+
+    private function collectArticleData($uri): array
+    {
+        $html = getSimpleHTMLDOMCached($uri, 86400 * 90); // 90d
+
+        $item = [
+            'enclosures' => [],
+        ];
+
+        $articleInformations = $html->find('.c-article-informations p');
+        if (is_array($articleInformations) && $articleInformations !== []) {
+            $authorPosition = 1;
+
+            // Article publication date
+            if (preg_match('/(\d{2})\/(\d{2})\/(\d{4})( à (\d{2})h(\d{2}))?/', $articleInformations[0]->innertext, $articleDateParts) > 0) {
+                $articleDate = new \DateTime('midnight');
+                $articleDate->setDate($articleDateParts[3], $articleDateParts[2], $articleDateParts[1]);
+
+                if (count($articleDateParts) === 7) {
+                    $articleDate->setTime($articleDateParts[5], $articleDateParts[6]);
+                }
+
+                $item['timestamp'] = $articleDate->getTimestamp();
+            }
+
+            // Article update date
+            if (count($articleInformations) >= 2 && preg_match('/(\d{2})\/(\d{2})\/(\d{4})( à (\d{2})h(\d{2}))?/', $articleInformations[1]->innertext, $articleDateParts) > 0) {
+                $authorPosition = 2;
+
+                $articleDate = new \DateTime('midnight');
+                $articleDate->setDate($articleDateParts[3], $articleDateParts[2], $articleDateParts[1]);
+
+                if (count($articleDateParts) === 7) {
+                    $articleDate->setTime($articleDateParts[5], $articleDateParts[6]);
+                }
+
+                $item['timestamp'] = $articleDate->getTimestamp();
+            }
+
+            if (count($articleInformations) === ($authorPosition + 1)) {
+                $item['author'] = $articleInformations[$authorPosition]->innertext;
+            }
+        }
+
+        $articleContent = $html->find('.b-article .contenu > *');
+        if (is_array($articleContent)) {
+            $item['content'] = '';
+
+            foreach ($articleContent as $contentPart) {
+                if (in_array($contentPart->getAttribute('id'), ['cf-audio-player', 'poool-widget'], true)) {
+                    continue;
+                }
+
+                $articleHiddenParts = $contentPart->find('.bloc, .p402_hide');
+                if (is_array($articleHiddenParts)) {
+                    foreach ($articleHiddenParts as $articleHiddenPart) {
+                        $contentPart->removeChild($articleHiddenPart);
+                    }
+                }
+
+                $item['content'] .= $contentPart->innertext;
+            }
+        }
+
+        $articleIllustration  = $html->find('.photo-wrapper .photo-box img');
+        if (is_array($articleIllustration) && count($articleIllustration) === 1) {
+            $item['enclosures'][] = $articleIllustration[0]->getAttribute('src');
+        }
+
+        $articleAudio = $html->find('#cf-audio-player-container audio');
+        if (is_array($articleAudio) && count($articleAudio) === 1) {
+            $item['enclosures'][] = $articleAudio[0]->getAttribute('src');
+        }
+
+        $articleTags = $html->find('.b-article > ul.c-tags > li > a.t-simple');
+        if (is_array($articleTags)) {
+            $item['categories'] = array_map(static fn ($articleTag) => $articleTag->innertext, $articleTags);
+        }
+
+        $explode = explode('_', $uri);
+        $array_reverse = array_reverse($explode);
+        $string = $array_reverse[0];
+        $uid = rtrim($string, '/');
+        if (is_numeric($uid)) {
+            $item['uid'] = $uid;
+        }
+
+        // If the article is a "grand format", we use another parsing strategy
+        if ($item['content'] === '' && $html->find('article') !== []) {
+            $articleContent = $html->find('article > section');
+            foreach ($articleContent as $contentPart) {
+                if ($contentPart->find('#journo') !== []) {
+                    $item['author'] = $contentPart->find('#journo')->innertext;
+                    continue;
+                }
+
+                $item['content'] .= $contentPart->innertext;
+            }
+        }
+
+        $item['content'] = str_replace('<span class="p-premium">premium</span>', '🔒', $item['content']);
+        $item['content'] = trim($item['content']);
+
+        return $item;
+    }
+
+    public function getName()
+    {
+        if (empty($this->getInput('newspaper'))) {
+            return static::NAME;
+        }
+
+        $newspaperNameByDomain = array_flip(self::PARAMETERS['global']['newspaper']['values']);
+        if (!isset($newspaperNameByDomain[$this->getInput('newspaper')])) {
+            return static::NAME;
+        }
+
+        $completeTitle = $newspaperNameByDomain[$this->getInput('newspaper')];
+
+        if (!empty($this->getInput('locality-slug'))) {
+            $localityName = explode('-', $this->getInput('locality-slug'));
+            array_pop($localityName);
+            $completeTitle .= ' ' . ucfirst(implode('-', $localityName));
+        }
+
+        return $completeTitle;
+    }
+
+    public function getIcon()
+    {
+        if (empty($this->getInput('newspaper'))) {
+            return static::URI . '/favicon.ico';
+        }
+
+        return 'https://www.' . $this->getInput('newspaper') . '/favicon.ico';
+    }
+
+    public function detectParameters($url)
+    {
+        $regex = '/^(https?:\/\/)?(www\.)?([a-z-]+\.fr)(\/)?([a-z-]+-[0-9]{5})?(\/)?$/';
+        $url = strtolower($url);
+
+        if (preg_match($regex, $url, $urlMatches) === 0) {
+            return null;
+        }
+
+        if (!in_array($urlMatches[3], self::PARAMETERS['global']['newspaper']['values'], true)) {
+            return null;
+        }
+
+        return [
+            'newspaper' => $urlMatches[3],
+            'locality-slug' => empty($urlMatches[5]) ? null : $urlMatches[5]
+        ];
+    }
+}
diff --git a/lib/contents.php b/lib/contents.php
index 893a3512..cc9542a9 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -142,7 +142,6 @@ function getContents(
  * when returning plaintext.
  * @param string $defaultSpanText Specifies the replacement text for `<span />`
  * tags when returning plaintext.
- * @return false|simple_html_dom Contents as simplehtmldom object.
  */
 function getSimpleHTMLDOM(
     $url,
@@ -154,11 +153,12 @@ function getSimpleHTMLDOM(
     $stripRN = true,
     $defaultBRText = DEFAULT_BR_TEXT,
     $defaultSpanText = DEFAULT_SPAN_TEXT
-) {
+): \simple_html_dom {
     $html = getContents($url, $header ?? [], $opts ?? []);
     if ($html === '') {
         throw new \Exception('Unable to parse dom because the http response was the empty string');
     }
+
     return str_get_html(
         $html,
         $lowercase,
diff --git a/lib/simplehtmldom/simple_html_dom.php b/lib/simplehtmldom/simple_html_dom.php
index 3fc95760..170f6fb0 100644
--- a/lib/simplehtmldom/simple_html_dom.php
+++ b/lib/simplehtmldom/simple_html_dom.php
@@ -118,11 +118,6 @@ function str_get_html(
         throw new \Exception('Refusing to parse too big input');
     }
 
-	if (empty($str) || strlen($str) > MAX_FILE_SIZE) {
-		$dom->clear();
-		return false;
-	}
-
 	return $dom->load($str, $lowercase, $stripRN);
 }
 

From 8c4385e61d2a8c0f23c120e082a6b832415f22fa Mon Sep 17 00:00:00 2001
From: "Quentin B." <quent1-fr@users.noreply.github.com>
Date: Thu, 8 Aug 2024 01:09:13 +0200
Subject: [PATCH 448/716] [BodaccBridge] Add bridge (#4190)

* [BodaccBridge] Add bridge

* [BodaccBridge] Fix bridge

* [BodaccBridge] Fix API url

* fix

---------

Co-authored-by: Dag <me@dvikan.no>
---
 bridges/BodaccBridge.php | 218 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 218 insertions(+)
 create mode 100644 bridges/BodaccBridge.php

diff --git a/bridges/BodaccBridge.php b/bridges/BodaccBridge.php
new file mode 100644
index 00000000..38e5856a
--- /dev/null
+++ b/bridges/BodaccBridge.php
@@ -0,0 +1,218 @@
+<?php
+
+class BodaccBridge extends BridgeAbstract
+{
+    const NAME = 'BODACC';
+    const URI = 'https://bodacc-datadila.opendatasoft.com/';
+    const DESCRIPTION = 'Fetches announces from the French Government "Bulletin Officiel Des Annonces Civiles et Commerciales".';
+    const CACHE_TIMEOUT = 86400;
+    const MAINTAINER = 'quent1';
+    const PARAMETERS = [
+        'Annonces commerciales' => [
+            'departement' => [
+                'name' => 'Département',
+                'type' => 'list',
+                'values' => [
+                    'Tous' => null,
+                    'Ain' => '01',
+                    'Aisne' => '02',
+                    'Allier' => '03',
+                    'Alpes-de-Haute-Provence' => '04',
+                    'Hautes-Alpes' => '05',
+                    'Alpes-Maritimes' => '06',
+                    'Ardèche' => '07',
+                    'Ardennes' => '08',
+                    'Ariège' => '09',
+                    'Aube' => '10',
+                    'Aude' => '11',
+                    'Aveyron' => '12',
+                    'Bouches-du-Rhône' => '13',
+                    'Calvados' => '14',
+                    'Cantal' => '15',
+                    'Charente' => '16',
+                    'Charente-Maritime' => '17',
+                    'Cher' => '18',
+                    'Corrèze' => '19',
+                    'Corse-du-Sud' => '2A',
+                    'Haute-Corse' => '2B',
+                    'Côte-d\'Or' => '21',
+                    'Côtes-d\'Armor' => '22',
+                    'Creuse' => '23',
+                    'Dordogne' => '24',
+                    'Doubs' => '25',
+                    'Drôme' => '26',
+                    'Eure' => '27',
+                    'Eure-et-Loir' => '28',
+                    'Finistère' => '29',
+                    'Gard' => '30',
+                    'Haute-Garonne' => '31',
+                    'Gers' => '32',
+                    'Gironde' => '33',
+                    'Hérault' => '34',
+                    'Ille-et-Vilaine' => '35',
+                    'Indre' => '36',
+                    'Indre-et-Loire' => '37',
+                    'Isère' => '38',
+                    'Jura' => '39',
+                    'Landes' => '40',
+                    'Loir-et-Cher' => '41',
+                    'Loire' => '42',
+                    'Haute-Loire' => '43',
+                    'Loire-Atlantique' => '44',
+                    'Loiret' => '45',
+                    'Lot' => '46',
+                    'Lot-et-Garonne' => '47',
+                    'Lozère' => '48',
+                    'Maine-et-Loire' => '49',
+                    'Manche' => '50',
+                    'Marne' => '51',
+                    'Haute-Marne' => '52',
+                    'Mayenne' => '53',
+                    'Meurthe-et-Moselle' => '54',
+                    'Meuse' => '55',
+                    'Morbihan' => '56',
+                    'Moselle' => '57',
+                    'Nièvre' => '58',
+                    'Nord' => '59',
+                    'Oise' => '60',
+                    'Orne' => '61',
+                    'Pas-de-Calais' => '62',
+                    'Puy-de-Dôme' => '63',
+                    'Pyrénées-Atlantiques' => '64',
+                    'Hautes-Pyrénées' => '65',
+                    'Pyrénées-Orientales' => '66',
+                    'Bas-Rhin' => '67',
+                    'Haut-Rhin' => '68',
+                    'Rhône' => '69',
+                    'Haute-Saône' => '70',
+                    'Saône-et-Loire' => '71',
+                    'Sarthe' => '72',
+                    'Savoie' => '73',
+                    'Haute-Savoie' => '74',
+                    'Paris' => '75',
+                    'Seine-Maritime' => '76',
+                    'Seine-et-Marne' => '77',
+                    'Yvelines' => '78',
+                    'Deux-Sèvres' => '79',
+                    'Somme' => '80',
+                    'Tarn' => '81',
+                    'Tarn-et-Garonne' => '82',
+                    'Var' => '83',
+                    'Vaucluse' => '84',
+                    'Vendée' => '85',
+                    'Vienne' => '86',
+                    'Haute-Vienne' => '87',
+                    'Vosges' => '88',
+                    'Yonne' => '89',
+                    'Territoire de Belfort' => '90',
+                    'Essonne' => '91',
+                    'Hauts-de-Seine' => '92',
+                    'Seine-Saint-Denis' => '93',
+                    'Val-de-Marne' => '94',
+                    'Val-d\'Oise' => '95',
+                    'Guadeloupe' => '971',
+                    'Martinique' => '972',
+                    'Guyane' => '973',
+                    'La Réunion' => '974',
+                    'Saint-Pierre-et-Miquelon' => '975',
+                    'Mayotte' => '976',
+                    'Saint-Barthélemy' => '977',
+                    'Saint-Martin' => '978',
+                    'Terres australes et antarctiques françaises' => '984',
+                    'Wallis-et-Futuna' => '986',
+                    'Polynésie française' => '987',
+                    'Nouvelle-Calédonie' => '988',
+                    'Île de Clipperton' => '989'
+                ]
+            ],
+            'famille' => [
+                'name' => 'Famille',
+                'type' => 'list',
+                'values' => [
+                    'Toutes' => null,
+                    'Annonces diverses' => 'divers',
+                    'Créations' => 'creation',
+                    'Dépôts des comptes' => 'dpc',
+                    'Immatriculations' => 'immatriculation',
+                    'Modifications diverses' => 'modification',
+                    'Procédures collectives' => 'collective',
+                    'Procédures de conciliation' => 'conciliation',
+                    'Procédures de rétablissement professionnel' => 'retablissement_professionnel',
+                    'Radiations' => 'radiation',
+                    'Ventes et cessions' => 'vente'
+                ]
+            ],
+            'type' => [
+                'name' => 'Type',
+                'type' => 'list',
+                'values' => [
+                    'Tous' => null,
+                    'Avis initial' => 'annonce',
+                    'Avis d\'annulation' => 'annulation',
+                    'Avis rectificatif' => 'rectificatif'
+                ]
+            ]
+        ]
+    ];
+
+    public function collectData()
+    {
+        $parameters = [
+            'select'    => 'id,dateparution,typeavis_lib,familleavis_lib,commercant,ville,cp',
+            'order_by'  => 'id desc',
+            'limit'     => 50,
+        ];
+
+        $where = [];
+        if (!empty($this->getInput('departement'))) {
+            $where[] = 'numerodepartement="' . $this->getInput('departement') . '"';
+        }
+
+        if (!empty($this->getInput('famille'))) {
+            $where[] = 'familleavis="' . $this->getInput('famille') . '"';
+        }
+
+        if (!empty($this->getInput('type'))) {
+            $where[] = 'typeavis="' . $this->getInput('type') . '"';
+        }
+
+        if ($where !== []) {
+            $parameters['where'] = implode(' and ', $where);
+        }
+
+        $url = urljoin(self::URI, '/api/explore/v2.1/catalog/datasets/annonces-commerciales/records?' . http_build_query($parameters));
+
+        $data = Json::decode(getContents($url), false);
+
+        foreach ($data->results as $result) {
+            if (
+                !isset(
+                    $result->id,
+                    $result->dateparution,
+                    $result->typeavis_lib,
+                    $result->familleavis_lib,
+                    $result->commercant,
+                    $result->ville,
+                    $result->cp
+                )
+            ) {
+                continue;
+            }
+
+            $title = sprintf(
+                '[%s] %s - %s à %s (%s)',
+                $result->typeavis_lib,
+                $result->familleavis_lib,
+                $result->commercant,
+                $result->ville,
+                $result->cp
+            );
+
+            $this->items[] = [
+                'uid'       => $result->id,
+                'timestamp' => strtotime($result->dateparution),
+                'title'     => $title,
+            ];
+        }
+    }
+}

From db85015daa62b26cf1ea2aab4d94e992b40a040f Mon Sep 17 00:00:00 2001
From: "Quentin B." <quent1-fr@users.noreply.github.com>
Date: Thu, 8 Aug 2024 01:20:42 +0200
Subject: [PATCH 449/716] [AnfrBridge] Add bridge (#4191)

* [AnfrBridge] Add bridge

* yup

---------

Co-authored-by: Dag <me@dvikan.no>
---
 bridges/AnfrBridge.php | 278 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 278 insertions(+)
 create mode 100644 bridges/AnfrBridge.php

diff --git a/bridges/AnfrBridge.php b/bridges/AnfrBridge.php
new file mode 100644
index 00000000..391fde77
--- /dev/null
+++ b/bridges/AnfrBridge.php
@@ -0,0 +1,278 @@
+<?php
+
+class AnfrBridge extends BridgeAbstract
+{
+    const NAME = 'ANFR';
+    const URI = 'https://data.anfr.fr/';
+    const DESCRIPTION = 'Fetches data from the French administration "Agence Nationale des Fréquences".';
+    const CACHE_TIMEOUT = 604800; // 7d
+    const MAINTAINER = 'quent1';
+    const PARAMETERS = [
+        'Données sur les réseaux mobiles' => [
+            'departement' => [
+                'name' => 'Département',
+                'type' => 'list',
+                'values' => [
+                    'Tous' => null,
+                    'Ain' => '001',
+                    'Aisne' => '002',
+                    'Allier' => '003',
+                    'Alpes-de-Haute-Provence' => '004',
+                    'Hautes-Alpes' => '005',
+                    'Alpes-Maritimes' => '006',
+                    'Ardèche' => '007',
+                    'Ardennes' => '008',
+                    'Ariège' => '009',
+                    'Aube' => '010',
+                    'Aude' => '011',
+                    'Aveyron' => '012',
+                    'Bouches-du-Rhône' => '013',
+                    'Calvados' => '014',
+                    'Cantal' => '015',
+                    'Charente' => '016',
+                    'Charente-Maritime' => '017',
+                    'Cher' => '018',
+                    'Corrèze' => '019',
+                    'Corse-du-Sud' => '02A',
+                    'Haute-Corse' => '02B',
+                    'Côte-d\'Or' => '021',
+                    'Côtes-d\'Armor' => '022',
+                    'Creuse' => '023',
+                    'Dordogne' => '024',
+                    'Doubs' => '025',
+                    'Drôme' => '026',
+                    'Eure' => '027',
+                    'Eure-et-Loir' => '028',
+                    'Finistère' => '029',
+                    'Gard' => '030',
+                    'Haute-Garonne' => '031',
+                    'Gers' => '032',
+                    'Gironde' => '033',
+                    'Hérault' => '034',
+                    'Ille-et-Vilaine' => '035',
+                    'Indre' => '036',
+                    'Indre-et-Loire' => '037',
+                    'Isère' => '038',
+                    'Jura' => '039',
+                    'Landes' => '040',
+                    'Loir-et-Cher' => '041',
+                    'Loire' => '042',
+                    'Haute-Loire' => '043',
+                    'Loire-Atlantique' => '044',
+                    'Loiret' => '045',
+                    'Lot' => '046',
+                    'Lot-et-Garonne' => '047',
+                    'Lozère' => '048',
+                    'Maine-et-Loire' => '049',
+                    'Manche' => '050',
+                    'Marne' => '051',
+                    'Haute-Marne' => '052',
+                    'Mayenne' => '053',
+                    'Meurthe-et-Moselle' => '054',
+                    'Meuse' => '055',
+                    'Morbihan' => '056',
+                    'Moselle' => '057',
+                    'Nièvre' => '058',
+                    'Nord' => '059',
+                    'Oise' => '060',
+                    'Orne' => '061',
+                    'Pas-de-Calais' => '062',
+                    'Puy-de-Dôme' => '063',
+                    'Pyrénées-Atlantiques' => '064',
+                    'Hautes-Pyrénées' => '065',
+                    'Pyrénées-Orientales' => '066',
+                    'Bas-Rhin' => '067',
+                    'Haut-Rhin' => '068',
+                    'Rhône' => '069',
+                    'Haute-Saône' => '070',
+                    'Saône-et-Loire' => '071',
+                    'Sarthe' => '072',
+                    'Savoie' => '073',
+                    'Haute-Savoie' => '074',
+                    'Paris' => '075',
+                    'Seine-Maritime' => '076',
+                    'Seine-et-Marne' => '077',
+                    'Yvelines' => '078',
+                    'Deux-Sèvres' => '079',
+                    'Somme' => '080',
+                    'Tarn' => '081',
+                    'Tarn-et-Garonne' => '082',
+                    'Var' => '083',
+                    'Vaucluse' => '084',
+                    'Vendée' => '085',
+                    'Vienne' => '086',
+                    'Haute-Vienne' => '087',
+                    'Vosges' => '088',
+                    'Yonne' => '089',
+                    'Territoire de Belfort' => '090',
+                    'Essonne' => '091',
+                    'Hauts-de-Seine' => '092',
+                    'Seine-Saint-Denis' => '093',
+                    'Val-de-Marne' => '094',
+                    'Val-d\'Oise' => '095',
+                    'Guadeloupe' => '971',
+                    'Martinique' => '972',
+                    'Guyane' => '973',
+                    'La Réunion' => '974',
+                    'Saint-Pierre-et-Miquelon' => '975',
+                    'Mayotte' => '976',
+                    'Saint-Barthélemy' => '977',
+                    'Saint-Martin' => '978',
+                    'Terres australes et antarctiques françaises' => '984',
+                    'Wallis-et-Futuna' => '986',
+                    'Polynésie française' => '987',
+                    'Nouvelle-Calédonie' => '988',
+                    'Île de Clipperton' => '989'
+                ]
+            ],
+            'generation' => [
+                'name' => 'Génération',
+                'type' => 'list',
+                'values' => [
+                    'Tous' => null,
+                    '2G' => '2G',
+                    '3G' => '3G',
+                    '4G' => '4G',
+                    '5G' => '5G',
+                ]
+            ],
+            'operateur' => [
+                'name' => 'Opérateur',
+                'type' => 'list',
+                'values' => [
+                    'Tous' => null,
+                    'Bouygues Télécom' => 'BOUYGUES TELECOM',
+                    'Dauphin Télécom' => 'DAUPHIN TELECOM',
+                    'Digiciel' => 'DIGICEL',
+                    'Free Caraïbes' => 'FREE CARAIBES',
+                    'Free Mobile' => 'FREE MOBILE',
+                    'GLOBALTEL' => 'GLOBALTEL',
+                    'Office des postes et télécommunications de Nouvelle Calédonie' => 'Gouv Nelle Calédonie (OPT)',
+                    'Maore Mobile' => 'MAORE MOBILE',
+                    'ONATi' => 'ONATI',
+                    'Orange' => 'ORANGE',
+                    'Outremer Telecom' => 'OUTREMER TELECOM',
+                    'Vodafone polynésie' => 'PMT/VODAPHONE',
+                    'SFR' => 'SFR',
+                    'SPM Télécom' => 'SPM TELECOM',
+                    'Service des Postes et Télécommunications de Polynésie Française' => 'Gouv Nelle Calédonie (OPT)',
+                    'SRR' => 'SRR',
+                    'Station étrangère' => 'Station étrangère',
+                    'Telco OI' => 'TELCO IO',
+                    'United Telecommunication Services Caraïbes' => 'UTS Caraibes',
+                    'Ora Mobile' => 'VITI SAS',
+                    'Zeop' => 'ZEOP'
+                ]
+            ],
+            'statut' => [
+                'name' => 'Statut',
+                'type' => 'list',
+                'values' => [
+                    'Tous' => null,
+                    'En service' => 'En service',
+                    'Projet approuvé' => 'Projet approuvé',
+                    'Techniquement opérationnel' => 'Techniquement opérationnel',
+                ]
+            ]
+        ]
+    ];
+
+    public function collectData()
+    {
+        $urlParts = [
+            'id' => 'observatoire_2g_3g_4g',
+            'resource_id' => '88ef0887-6b0f-4d3f-8545-6d64c8f597da',
+            'fields' => 'id,adm_lb_nom,sta_nm_dpt,emr_lb_systeme,generation,date_maj,sta_nm_anfr,adr_lb_lieu,adr_lb_add1,adr_lb_add2,adr_lb_add3,adr_nm_cp,statut',
+            'rows' => 10000
+        ];
+
+        if (!empty($this->getInput('departement'))) {
+            $urlParts['refine.sta_nm_dpt'] = urlencode($this->getInput('departement'));
+        }
+
+        if (!empty($this->getInput('generation'))) {
+            $urlParts['refine.generation'] = $this->getInput('generation');
+        }
+
+        if (!empty($this->getInput('operateur'))) {
+            // http_build_query() already does urlencoding so this call is redundant
+            $urlParts['refine.adm_lb_nom'] = urlencode($this->getInput('operateur'));
+        }
+
+        if (!empty($this->getInput('statut'))) {
+            $urlParts['refine.statut'] = urlencode($this->getInput('statut'));
+        }
+
+        // API seems to not play well with urlencoded data
+        $url = urljoin(static::URI, '/d4c/api/records/1.0/download/?' . urldecode(http_build_query($urlParts)));
+
+        $json = getContents($url);
+        $data = Json::decode($json, false);
+        $records = $data->records;
+        $frequenciesByStation = [];
+        foreach ($records as $record) {
+            if (!isset($frequenciesByStation[$record->fields->sta_nm_anfr])) {
+                $street = sprintf(
+                    '%s %s %s',
+                    $record->fields->adr_lb_add1 ?? '',
+                    $record->fields->adr_lb_add2 ?? '',
+                    $record->fields->adr_lb_add3 ?? ''
+                );
+                $frequenciesByStation[$record->fields->sta_nm_anfr] = [
+                    'id' => $record->fields->sta_nm_anfr,
+                    'operator' => $record->fields->adm_lb_nom,
+                    'frequencies' => [],
+                    'lastUpdate' => 0,
+                    'address' => [
+                        'street' => trim($street),
+                        'postCode' => $record->fields->adr_nm_cp,
+                        'city' => $record->fields->adr_lb_lieu
+                    ]
+                ];
+            }
+
+            $frequenciesByStation[$record->fields->sta_nm_anfr]['frequencies'][] = [
+                'generation' => $record->fields->generation,
+                'frequency' => $record->fields->emr_lb_systeme,
+                'status' => $record->fields->statut,
+                'updatedAt' => strtotime($record->fields->date_maj),
+            ];
+
+            $frequenciesByStation[$record->fields->sta_nm_anfr]['lastUpdate'] = max(
+                $frequenciesByStation[$record->fields->sta_nm_anfr]['lastUpdate'],
+                strtotime($record->fields->date_maj)
+            );
+        }
+
+        usort($frequenciesByStation, static fn ($a, $b) => $b['lastUpdate'] <=> $a['lastUpdate']);
+
+        foreach ($frequenciesByStation as $station) {
+            $title = sprintf(
+                '[%s] Mise à jour de la station n°%s à %s (%s)',
+                $station['operator'],
+                $station['id'],
+                $station['address']['city'],
+                $station['address']['postCode']
+            );
+
+            $array_reduce = array_reduce($station['frequencies'], static function ($carry, $frequency) {
+                return sprintf('%s<li>%s : %s</li>', $carry, $frequency['frequency'], $frequency['status']);
+            }, '');
+
+            $content = sprintf(
+                '<h1>Adresse complète</h1><p>%s<br>%s<br>%s</p><h1>Fréquences</h1><p><ul>%s</ul></p>',
+                $station['address']['street'],
+                $station['address']['postCode'],
+                $station['address']['city'],
+                $array_reduce
+            );
+
+            $this->items[] = [
+                'uid'       => $station['id'],
+                'timestamp' => $station['lastUpdate'],
+                'title'     => $title,
+                'content'   => $content,
+            ];
+        }
+    }
+}
\ No newline at end of file

From 7073bb2f4674578b396d13b926ce585c9638a305 Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Thu, 8 Aug 2024 05:05:48 +0530
Subject: [PATCH 450/716] [NVIDIADriverBridge] Initial Commit (#4198)

* [NVIDIADriverBridge] Initial Commit

Fetch the latest NVIDIA Linux driver updates

* Update NVIDIADriverBridge.php

* refactor

* rename

---------

Co-authored-by: Dag <me@dvikan.no>
---
 bridges/NvidiaDriverBridge.php | 49 ++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 bridges/NvidiaDriverBridge.php

diff --git a/bridges/NvidiaDriverBridge.php b/bridges/NvidiaDriverBridge.php
new file mode 100644
index 00000000..595411bc
--- /dev/null
+++ b/bridges/NvidiaDriverBridge.php
@@ -0,0 +1,49 @@
+<?php
+
+class NvidiaDriverBridge extends FeedExpander
+{
+    const NAME = 'NVIDIA Linux Driver Releases';
+    const URI = 'https://www.nvidia.com/Download/processFind.aspx';
+    const DESCRIPTION = 'Fetch the latest NVIDIA Linux driver updates';
+    const MAINTAINER = 'tillcash';
+    const PARAMETERS = [
+        [
+            'whql' => [
+                'name' => 'Version',
+                'type' => 'list',
+                'values' => [
+                        'All' => '',
+                        'Beta' => '0',
+                        'New Feature Branch' => '5',
+                        'Recommended/Certified' => '1',
+                ],
+            ],
+        ],
+    ];
+
+    public function collectData()
+    {
+        $whql = $this->getInput('whql');
+
+        $parameters = [
+            'lid'   => 1, // en-us
+            'psid'  => 129, // GeForce
+            'osid'  => 12, // Linux 64-bit
+            'whql'  => $whql,
+        ];
+
+        $url = 'https://www.nvidia.com/Download/processFind.aspx?' . http_build_query($parameters);
+        $dom = getSimpleHTMLDOM($url);
+
+        foreach ($dom->find('tr#driverList') as $element) {
+            $id = str_replace('img_', '', $element->find('img', 0)->id);
+
+            $this->items[] = [
+                'timestamp' => $element->find('td.gridItem', 3)->plaintext,
+                'title'     => sprintf('NVIDIA Linux Driver %s', $element->find('td.gridItem', 2)->plaintext),
+                'uri'       => 'https://www.nvidia.com/Download/driverResults.aspx/' . $id,
+                'content'   => $dom->find('tr#tr_' . $id . ' span', 0)->innertext,
+            ];
+        }
+    }
+}

From 9973f731dfb0b34ae4c1d3d86143eee346ff5641 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 8 Aug 2024 02:13:04 +0200
Subject: [PATCH 451/716] feat: introduce RateLimitException (#4199)

---
 actions/DisplayAction.php |  8 ++++++--
 bridges/RedditBridge.php  |  6 ++++--
 bridges/Vk2Bridge.php     |  2 +-
 bridges/VkBridge.php      |  2 +-
 bridges/YoutubeBridge.php |  3 ++-
 lib/http.php              | 10 ++++++++++
 6 files changed, 24 insertions(+), 7 deletions(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index c51bb7cd..55f0d2fd 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -121,8 +121,12 @@ class DisplayAction implements ActionInterface
                 $items = $feedItems;
             }
             $feed = $bridge->getFeed();
-        } catch (\Exception $e) {
-            // Probably an exception inside a bridge
+        } catch (\Throwable $e) {
+            if ($e instanceof RateLimitException) {
+                // These are internally generated by bridges
+                $this->logger->info(sprintf('RateLimitException in DisplayAction(%s): %s', $bridge->getShortName(), create_sane_exception_message($e)));
+                return new Response(render(__DIR__ . '/../templates/exception.html.php', ['e' => $e]), 429);
+            }
             if ($e instanceof HttpException) {
                 // Reproduce (and log) these responses regardless of error output and report limit
                 if ($e->getCode() === 429) {
diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index ef74fdcd..03f279d8 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -93,12 +93,12 @@ class RedditBridge extends BridgeAbstract
     {
         $forbiddenKey = 'reddit_forbidden';
         if ($this->cache->get($forbiddenKey)) {
-            throw new HttpException('403 Forbidden', 403);
+            throw new RateLimitException();
         }
 
         $rateLimitKey = 'reddit_rate_limit';
         if ($this->cache->get($rateLimitKey)) {
-            throw new HttpException('429 Too Many Requests', 429);
+            throw new RateLimitException();
         }
 
         try {
@@ -108,8 +108,10 @@ class RedditBridge extends BridgeAbstract
                 // 403 Forbidden
                 // This can possibly mean that reddit has permanently blocked this server's ip address
                 $this->cache->set($forbiddenKey, true, 60 * 61);
+                throw new RateLimitException();
             } elseif ($e->getCode() === 429) {
                 $this->cache->set($rateLimitKey, true, 60 * 61);
+                throw new RateLimitException();
             }
             throw $e;
         }
diff --git a/bridges/Vk2Bridge.php b/bridges/Vk2Bridge.php
index 6fecba84..62ba8e05 100644
--- a/bridges/Vk2Bridge.php
+++ b/bridges/Vk2Bridge.php
@@ -194,7 +194,7 @@ class Vk2Bridge extends BridgeAbstract
     public function collectData()
     {
         if ($this->cache->get($this->rateLimitCacheKey)) {
-            throw new HttpException('429 Too Many Requests', 429);
+            throw new RateLimitException();
         }
 
         $u = $this->getInput('u');
diff --git a/bridges/VkBridge.php b/bridges/VkBridge.php
index 22957f26..0d62305b 100644
--- a/bridges/VkBridge.php
+++ b/bridges/VkBridge.php
@@ -519,7 +519,7 @@ class VkBridge extends BridgeAbstract
             $uri = urljoin(self::URI, $headers['location'][0]);
 
             if (str_contains($uri, '/429.html')) {
-                returnServerError('VK responded "Too many requests"');
+                throw new RateLimitException();
             }
 
             if (!preg_match('#^https?://vk.com/#', $uri)) {
diff --git a/bridges/YoutubeBridge.php b/bridges/YoutubeBridge.php
index af14c856..647b1c42 100644
--- a/bridges/YoutubeBridge.php
+++ b/bridges/YoutubeBridge.php
@@ -82,13 +82,14 @@ class YoutubeBridge extends BridgeAbstract
     {
         $cacheKey = 'youtube_rate_limit';
         if ($this->cache->get($cacheKey)) {
-            throw new HttpException('429 Too Many Requests', 429);
+            throw new RateLimitException();
         }
         try {
             $this->collectDataInternal();
         } catch (HttpException $e) {
             if ($e->getCode() === 429) {
                 $this->cache->set($cacheKey, true, 60 * 16);
+                throw new RateLimitException();
             }
             throw $e;
         }
diff --git a/lib/http.php b/lib/http.php
index 39f0c727..0d21b958 100644
--- a/lib/http.php
+++ b/lib/http.php
@@ -1,5 +1,15 @@
 <?php
 
+/**
+ * Thrown by bridges
+ */
+final class RateLimitException extends \Exception
+{
+}
+
+/**
+ * @internal Do not use this class in bridges
+ */
 class HttpException extends \Exception
 {
     public ?Response $response;

From 2a96bf19b5354ceecb417f266070b9659d08e84a Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 8 Aug 2024 02:55:35 +0200
Subject: [PATCH 452/716] fix: bug in prior commit (#4200)

---
 actions/DisplayAction.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 55f0d2fd..2a184598 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -217,7 +217,7 @@ class DisplayAction implements ActionInterface
         return $report['count'];
     }
 
-    private static function createGithubIssueUrl(BridgeAbstract $bridge, \Exception $e, string $message): string
+    private static function createGithubIssueUrl(BridgeAbstract $bridge, \Throwable $e, string $message): string
     {
         $maintainer = $bridge->getMaintainer();
         if (str_contains($maintainer, ',')) {

From 6afd13eb06276f085f245c5075972ef36eb6740a Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 8 Aug 2024 03:43:26 +0200
Subject: [PATCH 453/716] refactor: deprecate FeedItem constructor (#4201)

* fix: bug in prior commit

* refactor: deprecate FeedItem constructor

* test: fix
---
 actions/DisplayAction.php             | 27 +++++++------------
 bridges/GULPProjekteBridge.php        | 16 +++++------
 bridges/NintendoBridge.php            |  2 +-
 bridges/RutubeBridge.php              | 15 ++++++-----
 bridges/ScalableCapitalBlogBridge.php | 18 ++++++++-----
 bridges/Vk2Bridge.php                 | 12 ++++-----
 lib/FeedItem.php                      | 20 +++-----------
 lib/FormatAbstract.php                | 15 +++++------
 lib/XPathAbstract.php                 | 26 +++++++++++-------
 tests/FeedItemTest.php                | 39 ++++-----------------------
 tests/Formats/BaseFormatTest.php      |  2 +-
 11 files changed, 78 insertions(+), 114 deletions(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 2a184598..a5703e5e 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -93,7 +93,6 @@ class DisplayAction implements ActionInterface
     private function createResponse(Request $request, BridgeAbstract $bridge, string $format)
     {
         $items = [];
-        $feed = [];
 
         try {
             $bridge->loadConfiguration();
@@ -113,14 +112,6 @@ class DisplayAction implements ActionInterface
             $bridge->setInput($input);
             $bridge->collectData();
             $items = $bridge->getItems();
-            if (isset($items[0]) && is_array($items[0])) {
-                $feedItems = [];
-                foreach ($items as $item) {
-                    $feedItems[] = FeedItem::fromArray($item);
-                }
-                $items = $feedItems;
-            }
-            $feed = $bridge->getFeed();
         } catch (\Throwable $e) {
             if ($e instanceof RateLimitException) {
                 // These are internally generated by bridges
@@ -162,7 +153,7 @@ class DisplayAction implements ActionInterface
         $format = $formatFactory->create($format);
 
         $format->setItems($items);
-        $format->setFeed($feed);
+        $format->setFeed($bridge->getFeed());
         $now = time();
         $format->setLastModified($now);
         $headers = [
@@ -172,19 +163,20 @@ class DisplayAction implements ActionInterface
         return new Response($format->stringify(), 200, $headers);
     }
 
-    private function createFeedItemFromException($e, BridgeAbstract $bridge): FeedItem
+    private function createFeedItemFromException($e, BridgeAbstract $bridge): array
     {
-        $item = new FeedItem();
+        $item = [];
 
         // Create a unique identifier every 24 hours
         $uniqueIdentifier = urlencode((int)(time() / 86400));
         $title = sprintf('Bridge returned error %s! (%s)', $e->getCode(), $uniqueIdentifier);
-        $item->setTitle($title);
-        $item->setURI(get_current_url());
-        $item->setTimestamp(time());
+
+        $item['title'] = $title;
+        $item['uri'] = get_current_url();
+        $item['timestamp'] = time();
 
         // Create an item identifier for feed readers e.g. "staysafetv twitch videos_19389"
-        $item->setUid($bridge->getName() . '_' . $uniqueIdentifier);
+        $item['uid'] = $bridge->getName() . '_' . $uniqueIdentifier;
 
         $content = render_template(__DIR__ . '/../templates/bridge-error.html.php', [
             'error' => render_template(__DIR__ . '/../templates/exception.html.php', ['e' => $e]),
@@ -192,7 +184,8 @@ class DisplayAction implements ActionInterface
             'issueUrl' => self::createGithubIssueUrl($bridge, $e, create_sane_exception_message($e)),
             'maintainer' => $bridge->getMaintainer(),
         ]);
-        $item->setContent($content);
+        $item['content'] = $content;
+
         return $item;
     }
 
diff --git a/bridges/GULPProjekteBridge.php b/bridges/GULPProjekteBridge.php
index e0bb8cbe..05689bc9 100644
--- a/bridges/GULPProjekteBridge.php
+++ b/bridges/GULPProjekteBridge.php
@@ -129,24 +129,24 @@ class GULPProjekteBridge extends WebDriverAbstract
             while (true) {
                 $items = $this->getDriver()->findElements(WebDriverBy::tagName('app-project-view'));
                 foreach ($items as $item) {
-                    $feedItem = new FeedItem();
+                    $feedItem = [];
 
                     $heading = $item->findElement(WebDriverBy::xpath('.//app-heading-tag/h1/a'));
-                    $feedItem->setTitle($heading->getText());
-                    $feedItem->setURI('https://www.gulp.de' . $heading->getAttribute('href'));
+                    $feedItem['title'] = $heading->getText();
+                    $feedItem['uri'] = 'https://www.gulp.de' . $heading->getAttribute('href');
                     $info = $item->findElement(WebDriverBy::tagName('app-icon-info-list'));
                     if ($logo = $this->getLogo($item)) {
-                        $feedItem->setEnclosures([$logo]);
+                        $feedItem['enclosures'] = [$logo];
                     }
                     if (str_contains($info->getText(), 'Projektanbieter:')) {
-                        $feedItem->setAuthor($info->findElement(WebDriverBy::xpath('.//li/span[2]/span'))->getText());
+                        $feedItem['author'] = $info->findElement(WebDriverBy::xpath('.//li/span[2]/span'))->getText();
                     } else {
                         // mostly "Direkt vom Auftraggeber" or "GULP Agentur"
-                        $feedItem->setAuthor($item->findElement(WebDriverBy::tagName('b'))->getText());
+                        $feedItem['author'] = $item->findElement(WebDriverBy::tagName('b'))->getText();
                     }
-                    $feedItem->setContent($item->findElement(WebDriverBy::xpath('.//p[@class="description"]'))->getText());
+                    $feedItem['content'] = $item->findElement(WebDriverBy::xpath('.//p[@class="description"]'))->getText();
                     $timeAgo = $item->findElement(WebDriverBy::xpath('.//small[contains(@class, "time-ago")]'))->getText();
-                    $feedItem->setTimestamp($this->getTimestamp($timeAgo));
+                    $feedItem['timestamp'] = $this->getTimestamp($timeAgo);
 
                     $this->items[] = $feedItem;
                 }
diff --git a/bridges/NintendoBridge.php b/bridges/NintendoBridge.php
index 1c4ecf2b..2f6113b2 100644
--- a/bridges/NintendoBridge.php
+++ b/bridges/NintendoBridge.php
@@ -477,7 +477,7 @@ class NintendoBridge extends XPathAbstract
         return $date->getTimestamp();
     }
 
-    protected function generateItemId(FeedItem $item)
+    protected function generateItemId(array $item)
     {
         return $this->getCurrentCategory() . '-' . $this->lastId;
     }
diff --git a/bridges/RutubeBridge.php b/bridges/RutubeBridge.php
index 39577575..f8e106c8 100644
--- a/bridges/RutubeBridge.php
+++ b/bridges/RutubeBridge.php
@@ -107,10 +107,10 @@ class RutubeBridge extends BridgeAbstract
         }
 
         foreach ($videos as $video) {
-            $item = new FeedItem();
-            $item->setTitle($video->title);
-            $item->setURI($video->video_url);
-            $content = '<a href="' . $item->getURI() . '">';
+            $item = [];
+            $item['title'] = $video->title;
+            $item['uri'] = $video->video_url;
+            $content = '<a href="' . $video->video_url . '">';
             $content .= '<img src="' . $video->thumbnail_url . '" />';
             $content .= '</a><br/>';
             $content .= nl2br(
@@ -122,9 +122,10 @@ class RutubeBridge extends BridgeAbstract
                     $video->description . ' '
                 )
             );
-            $item->setTimestamp($video->created_ts);
-            $item->setAuthor($video->author->name);
-            $item->setContent($content);
+            $item['timestamp'] = $video->created_ts;
+            $item['author'] = $video->author->name;
+            $item['content'] = $content;
+
             $this->items[] = $item;
         }
     }
diff --git a/bridges/ScalableCapitalBlogBridge.php b/bridges/ScalableCapitalBlogBridge.php
index 6f95efb3..d95431c6 100644
--- a/bridges/ScalableCapitalBlogBridge.php
+++ b/bridges/ScalableCapitalBlogBridge.php
@@ -41,16 +41,20 @@ class ScalableCapitalBlogBridge extends WebDriverAbstract
 
             $items = $this->getDriver()->findElements(WebDriverBy::xpath('//div[contains(@class, "articles")]//div[@class="items"]//div[contains(@class, "item")]'));
             foreach ($items as $item) {
-                $feedItem = new FeedItem();
+                $feedItem = [];
+
+                $feedItem['enclosures'] = ['https://de.scalable.capital' . $item->findElement(WebDriverBy::tagName('img'))->getAttribute('src')];
 
-                $feedItem->setEnclosures(['https://de.scalable.capital' . $item->findElement(WebDriverBy::tagName('img'))->getAttribute('src')]);
                 $heading = $item->findElement(WebDriverBy::tagName('a'));
-                $feedItem->setTitle($heading->getText());
-                $feedItem->setURI('https://de.scalable.capital' . $heading->getAttribute('href'));
-                $feedItem->setContent($item->findElement(WebDriverBy::xpath('.//div[@class="summary"]'))->getText());
+                $feedItem['title'] = $heading->getText();
+
+                $feedItem['uri'] = 'https://de.scalable.capital' . $heading->getAttribute('href');
+                $feedItem['content'] = $item->findElement(WebDriverBy::xpath('.//div[@class="summary"]'))->getText();
+
                 $date = $item->findElement(WebDriverBy::xpath('.//div[@class="published-date"]'))->getText();
-                $feedItem->setTimestamp($this->formatItemTimestamp($date));
-                $feedItem->setAuthor($item->findElement(WebDriverBy::xpath('.//div[@class="author"]'))->getText());
+                $feedItem['timestamp'] = $this->formatItemTimestamp($date);
+
+                $feedItem['author'] = $item->findElement(WebDriverBy::xpath('.//div[@class="author"]'))->getText();
 
                 $this->items[] = $feedItem;
             }
diff --git a/bridges/Vk2Bridge.php b/bridges/Vk2Bridge.php
index 62ba8e05..f52850ce 100644
--- a/bridges/Vk2Bridge.php
+++ b/bridges/Vk2Bridge.php
@@ -255,7 +255,7 @@ class Vk2Bridge extends BridgeAbstract
             if (!$ownerId) {
                 $ownerId = $post['owner_id'];
             }
-            $item = new FeedItem();
+            $item = [];
             $content = $this->generateContentFromPost($post);
             if (isset($post['copy_history'])) {
                 if ($this->getInput('hide_reposts')) {
@@ -277,11 +277,11 @@ class Vk2Bridge extends BridgeAbstract
                 $content .= '):</p>';
                 $content .= $this->generateContentFromPost($originalPost);
             }
-            $item->setContent($content);
-            $item->setTimestamp($post['date']);
-            $item->setAuthor($this->ownerNames[$post['from_id']]);
-            $item->setTitle($this->getTitle(strip_tags($content)));
-            $item->setURI($this->getPostURI($post));
+            $item['content'] = $content;
+            $item['timestamp'] = $post['date'];
+            $item['author'] = $this->ownerNames[$post['from_id']];
+            $item['title'] = $this->getTitle(strip_tags($content));
+            $item['uri'] = $this->getPostURI($post);
 
             $this->items[] = $item;
         }
diff --git a/lib/FeedItem.php b/lib/FeedItem.php
index 8a092a27..bca06c23 100644
--- a/lib/FeedItem.php
+++ b/lib/FeedItem.php
@@ -12,10 +12,6 @@ class FeedItem
     protected ?string $uid = null;
     protected array $misc = [];
 
-    public function __construct()
-    {
-    }
-
     public static function fromArray(array $itemArray): self
     {
         $item = new self();
@@ -25,6 +21,10 @@ class FeedItem
         return $item;
     }
 
+    private function __construct()
+    {
+    }
+
     public function __set($name, $value)
     {
         switch ($name) {
@@ -89,18 +89,6 @@ class FeedItem
         return $this->uri;
     }
 
-    /**
-     * Set URI to the full article.
-     *
-     * Use {@see FeedItem::getURI()} to get the URI.
-     *
-     * _Note_: Removes whitespace from the beginning and end of the URI.
-     *
-     * _Remarks_: Uses the attribute "href" or "src" if the provided URI is an
-     * object of simple_html_dom_node.
-     *
-     * @param simple_html_dom_node|object|string $uri URI to the full article.
-     */
     public function setURI($uri)
     {
         $this->uri = null; // Clear previous data
diff --git a/lib/FormatAbstract.php b/lib/FormatAbstract.php
index 28eb4bbf..9cba0d8c 100644
--- a/lib/FormatAbstract.php
+++ b/lib/FormatAbstract.php
@@ -6,11 +6,11 @@ abstract class FormatAbstract
 
     const MIME_TYPE = 'text/plain';
 
-    protected string $charset = 'UTF-8';
-    protected array $items = [];
-    protected int $lastModified;
-
     protected array $feed = [];
+    protected array $items = [];
+    protected string $charset = 'UTF-8';
+
+    protected int $lastModified;
 
     abstract public function stringify();
 
@@ -30,12 +30,11 @@ abstract class FormatAbstract
         return $this->feed;
     }
 
-    /**
-     * @param FeedItem[] $items
-     */
     public function setItems(array $items): void
     {
-        $this->items = $items;
+        foreach ($items as $item) {
+            $this->items[] = FeedItem::fromArray($item);
+        }
     }
 
     /**
diff --git a/lib/XPathAbstract.php b/lib/XPathAbstract.php
index 6163ca13..44cbab67 100644
--- a/lib/XPathAbstract.php
+++ b/lib/XPathAbstract.php
@@ -422,9 +422,18 @@ abstract class XPathAbstract extends BridgeAbstract
         }
 
         foreach ($entries as $entry) {
-            $item = new FeedItem();
-            foreach (['title', 'content', 'uri', 'author', 'timestamp', 'enclosures', 'categories'] as $param) {
-                $expression = $this->getParam($param);
+            $item = [];
+            $parameters = [
+                'title',
+                'content',
+                'uri',
+                'author',
+                'timestamp',
+                'enclosures',
+                'categories',
+            ];
+            foreach ($parameters as $parameter) {
+                $expression = $this->getParam($parameter);
                 if ('' === $expression) {
                     continue;
                 }
@@ -438,21 +447,21 @@ abstract class XPathAbstract extends BridgeAbstract
                     continue;
                 }
 
-                if ('categories' === $param && $typedResult instanceof \DOMNodeList) {
+                if ('categories' === $parameter && $typedResult instanceof \DOMNodeList) {
                     $value = [];
                     foreach ($typedResult as $domNode) {
                         $value[] = $this->getItemValueOrNodeValue($domNode, false);
                     }
                 } else {
-                    $value = $this->getItemValueOrNodeValue($typedResult, 'content' === $param);
+                    $value = $this->getItemValueOrNodeValue($typedResult, 'content' === $parameter);
                 }
 
-                $item->__set($param, $this->formatParamValue($param, $value));
+                $item[$parameter] = $this->formatParamValue($parameter, $value);
             }
 
             $itemId = $this->generateItemId($item);
             if (null !== $itemId) {
-                $item->setUid($itemId);
+                $item['uid'] = $itemId;
             }
 
             $this->items[] = $item;
@@ -646,10 +655,9 @@ abstract class XPathAbstract extends BridgeAbstract
     /**
      * Allows overriding default mechanism determining items Uid's
      *
-     * @param FeedItem $item
      * @return string|null
      */
-    protected function generateItemId(FeedItem $item)
+    protected function generateItemId(array $item)
     {
         return null;
     }
diff --git a/tests/FeedItemTest.php b/tests/FeedItemTest.php
index 3390e7b3..fbc7a4ea 100644
--- a/tests/FeedItemTest.php
+++ b/tests/FeedItemTest.php
@@ -4,45 +4,16 @@ declare(strict_types=1);
 
 namespace RssBridge\Tests;
 
-use FeedItem;
 use PHPUnit\Framework\TestCase;
 
 class FeedItemTest extends TestCase
 {
     public function test()
     {
-        $item = new FeedItem();
-        $item->setTitle('hello');
-        $this->assertSame('hello', $item->getTitle());
-
-        $item = FeedItem::fromArray(['title' => 'hello2']);
-        $this->assertSame('hello2', $item->getTitle());
-
-        $item = new FeedItem();
-        $item->setAuthor('123');
-        $this->assertSame('123', $item->getAuthor());
-
-        $item = new FeedItem();
-        $item->title = 'aa';
-        $this->assertSame('aa', $item->title);
-        $this->assertSame('aa', $item->getTitle());
-    }
-
-    public function testTimestamp()
-    {
-        $item = new FeedItem();
-        $item->setTimestamp(5);
-        $this->assertSame(5, $item->getTimestamp());
-
-        $item->setTimestamp('5');
-        $this->assertSame(5, $item->getTimestamp());
-
-        $item->setTimestamp('1970-01-01 18:00:00');
-        $this->assertSame(64800, $item->getTimestamp());
-
-        $item->setTimestamp('1st jan last year');
-
-        // This will fail at 2025-01-01 hehe
-        $this->assertSame(1672531200, $item->getTimestamp());
+        $item = [
+            'title' => 'kek',
+        ];
+        $feedItem = \FeedItem::fromArray($item);
+        $this->assertSame('kek', $feedItem->getTitle());
     }
 }
diff --git a/tests/Formats/BaseFormatTest.php b/tests/Formats/BaseFormatTest.php
index 8999e772..0907b72a 100644
--- a/tests/Formats/BaseFormatTest.php
+++ b/tests/Formats/BaseFormatTest.php
@@ -39,7 +39,7 @@ abstract class BaseFormatTest extends TestCase
 
             $items = [];
             foreach ($data['items'] as $item) {
-                $items[] = \FeedItem::fromArray($item);
+                $items[] = ($item);
             }
 
             return (object)[

From 2acd415475e0d1f4b621003a85ece6e47a3790f7 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 8 Aug 2024 04:31:47 +0200
Subject: [PATCH 454/716] refactor: drop usage of Debug::log (#4202)

* refactor: drop usage of Debug::log

* lint
---
 bridges/AsahiShimbunAJWBridge.php             |  1 -
 bridges/DagensNyheterDirektBridge.php         |  5 ---
 bridges/FicbookBridge.php                     |  1 -
 bridges/FolhaDeSaoPauloBridge.php             |  4 ---
 bridges/HackerNewsUserThreadsBridge.php       |  2 --
 bridges/ItakuBridge.php                       |  3 +-
 bridges/JustETFBridge.php                     |  8 -----
 bridges/MastodonBridge.php                    | 12 ++++---
 bridges/PanacheDigitalGamesBridge.php         |  2 +-
 bridges/PresidenciaPTBridge.php               |  1 -
 bridges/SlusheBridge.php                      |  8 +----
 bridges/ThreadsBridge.php                     |  5 ++-
 bridges/TwitterBridge.php                     |  2 +-
 bridges/TwitterV2Bridge.php                   | 28 ++--------------
 bridges/UnraidCommunityApplicationsBridge.php |  2 --
 bridges/XenForoBridge.php                     |  2 --
 lib/BridgeCard.php                            |  4 +--
 lib/Debug.php                                 | 16 ---------
 lib/FeedItem.php                              | 33 ++++++++++---------
 lib/RssBridge.php                             |  3 +-
 20 files changed, 37 insertions(+), 105 deletions(-)

diff --git a/bridges/AsahiShimbunAJWBridge.php b/bridges/AsahiShimbunAJWBridge.php
index 03bee6ba..873eb351 100644
--- a/bridges/AsahiShimbunAJWBridge.php
+++ b/bridges/AsahiShimbunAJWBridge.php
@@ -45,7 +45,6 @@ class AsahiShimbunAJWBridge extends BridgeAbstract
 
         foreach ($html->find('#MainInner li a') as $element) {
             if ($element->parent()->class == 'HeadlineTopImage-S') {
-                Debug::log('Skip Headline, it is repeated below');
                 continue;
             }
             $item = [];
diff --git a/bridges/DagensNyheterDirektBridge.php b/bridges/DagensNyheterDirektBridge.php
index 4d1629fb..f0748b76 100644
--- a/bridges/DagensNyheterDirektBridge.php
+++ b/bridges/DagensNyheterDirektBridge.php
@@ -27,11 +27,6 @@ class DagensNyheterDirektBridge extends BridgeAbstract
             $url = self::BASEURL . $link;
             $title = $element->find('h2', 0)->plaintext;
             $author = $element->find('div.ds-byline__titles', 0)->plaintext;
-            // Debug::log($link);
-            // Debug::log($datetime);
-            // Debug::log($title);
-            // Debug::log($url);
-            // Debug::log($author);
 
             $article_content = $element->find('div.direkt-post__content', 0);
             $article_html = '';
diff --git a/bridges/FicbookBridge.php b/bridges/FicbookBridge.php
index d11015ad..3aa7d998 100644
--- a/bridges/FicbookBridge.php
+++ b/bridges/FicbookBridge.php
@@ -187,7 +187,6 @@ class FicbookBridge extends BridgeAbstract
         $fixed_date = str_replace(' г.', '', $fixed_date);
 
         if ($fixed_date === $date) {
-            Debug::log('Unable to fix date: ' . $date);
             return null;
         }
 
diff --git a/bridges/FolhaDeSaoPauloBridge.php b/bridges/FolhaDeSaoPauloBridge.php
index dba86c52..27713a41 100644
--- a/bridges/FolhaDeSaoPauloBridge.php
+++ b/bridges/FolhaDeSaoPauloBridge.php
@@ -44,8 +44,6 @@ class FolhaDeSaoPauloBridge extends FeedExpander
                     $item['content'] = $text;
                     $item['uri'] = explode('*', $item['uri'])[1];
                 }
-            } else {
-                Debug::log('???: ' . $item['uri']);
             }
         } else {
             $item['uri'] = explode('*', $item['uri'])[1];
@@ -58,13 +56,11 @@ class FolhaDeSaoPauloBridge extends FeedExpander
     {
         $feed_input = $this->getInput('feed');
         if (substr($feed_input, 0, strlen(self::URI)) === self::URI) {
-            Debug::log('Input:: ' . $feed_input);
             $feed_url = $feed_input;
         } else {
             /* TODO: prepend `/` if missing */
             $feed_url = self::URI . '/' . $this->getInput('feed');
         }
-        Debug::log('URL: ' . $feed_url);
         $limit = $this->getInput('amount');
         $this->collectExpandableDatas($feed_url, $limit);
     }
diff --git a/bridges/HackerNewsUserThreadsBridge.php b/bridges/HackerNewsUserThreadsBridge.php
index fee96b61..0ab7445d 100644
--- a/bridges/HackerNewsUserThreadsBridge.php
+++ b/bridges/HackerNewsUserThreadsBridge.php
@@ -21,8 +21,6 @@ class HackerNewsUserThreadsBridge extends BridgeAbstract
     {
         $url = 'https://news.ycombinator.com/threads?id=' . $this->getInput('user');
         $html = getSimpleHTMLDOM($url);
-        Debug::log('queried ' . $url);
-        Debug::log('found ' . $html);
 
         $item = [];
         $articles = $html->find('tr[class*="comtr"]');
diff --git a/bridges/ItakuBridge.php b/bridges/ItakuBridge.php
index 506805f7..e6ecbdc8 100644
--- a/bridges/ItakuBridge.php
+++ b/bridges/ItakuBridge.php
@@ -522,7 +522,7 @@ class ItakuBridge extends BridgeAbstract
     {
         $url = self::URI . '/api/commissions/' . $id . '/?format=json';
         $uri = self::URI . '/commissions/' . $id;
-        // Debug::log(var_dump($metadata));
+
         $data = $metadata ?? $this->getData($url, true, true)
             or returnServerError("Could not load $url");
 
@@ -664,7 +664,6 @@ class ItakuBridge extends BridgeAbstract
 
     private function getData(string $url, bool $cache = false, bool $getJSON = false, array $httpHeaders = [], array $curlOptions = [])
     {
-        // Debug::log($url);
         if ($getJSON) { //get JSON object
             if ($cache) {
                 $data = $this->loadCacheValue($url);
diff --git a/bridges/JustETFBridge.php b/bridges/JustETFBridge.php
index 88920133..bcefe331 100644
--- a/bridges/JustETFBridge.php
+++ b/bridges/JustETFBridge.php
@@ -138,8 +138,6 @@ class JustETFBridge extends BridgeAbstract
 
         date_time_set($df, 0, 0);
 
-        // Debug::log(date_format($df, 'U'));
-
         return date_format($df, 'U');
     }
 
@@ -216,8 +214,6 @@ class JustETFBridge extends BridgeAbstract
         $element = $article->find('div.subheadline', 0)
             or returnServerError('Date not found!');
 
-        // Debug::log($element->plaintext);
-
         $date = trim(explode('|', $element->plaintext)[0]);
 
         return $this->fixDate($date);
@@ -230,8 +226,6 @@ class JustETFBridge extends BridgeAbstract
 
         $element->find('a', 0)->onclick = '';
 
-        // Debug::log($element->innertext);
-
         return $element->innertext;
     }
 
@@ -300,8 +294,6 @@ class JustETFBridge extends BridgeAbstract
         $element = $html->find('div.infobox div.vallabel', 0)
             or returnServerError('Date not found!');
 
-        // Debug::log($element->plaintext);
-
         $date = trim(explode("\r\n", $element->plaintext)[1]);
 
         return $this->fixDate($date);
diff --git a/bridges/MastodonBridge.php b/bridges/MastodonBridge.php
index e673bf14..b98b1135 100644
--- a/bridges/MastodonBridge.php
+++ b/bridges/MastodonBridge.php
@@ -275,11 +275,13 @@ class MastodonBridge extends BridgeAbstract
             $toSign = '(request-target): get ' . $matches[2] . "\nhost: " . $matches[1] . "\ndate: " . $date;
             $result = openssl_sign($toSign, $signature, $pkey, 'RSA-SHA256');
             if ($result) {
-                Debug::log($toSign);
-                $sig = 'Signature: keyId="' . $keyId . '",headers="(request-target) host date",signature="' .
-                        base64_encode($signature) . '"';
-                Debug::log($sig);
-                array_push($headers, $sig);
+                $sig = sprintf(
+                    'Signature: keyId="%s",headers="(request-target) host date",signature="%s"',
+                    $keyId,
+                    base64_encode($signature)
+                );
+
+                $headers[] = $sig;
             }
         }
         try {
diff --git a/bridges/PanacheDigitalGamesBridge.php b/bridges/PanacheDigitalGamesBridge.php
index 6f7d8994..bb0c00b9 100644
--- a/bridges/PanacheDigitalGamesBridge.php
+++ b/bridges/PanacheDigitalGamesBridge.php
@@ -38,7 +38,7 @@ class PanacheDigitalGamesBridge extends BridgeAbstract
             $image_html = $element->find('.news-item-thumbnail-image', 0);
             if ($image_html) {
                 $image_strings = explode('\'', $image_html);
-                /* Debug::log('S: ' . count($image_strings) . '||' . implode('_ _', $image_strings)); */
+
                 if (count($image_strings) == 4) {
                     $item['content'] = '<img src="' . $image_strings[1] . '" />';
                 }
diff --git a/bridges/PresidenciaPTBridge.php b/bridges/PresidenciaPTBridge.php
index 247e8fce..2f55f262 100644
--- a/bridges/PresidenciaPTBridge.php
+++ b/bridges/PresidenciaPTBridge.php
@@ -55,7 +55,6 @@ class PresidenciaPTBridge extends BridgeAbstract
         $contexts = $this->getParameters();
 
         foreach (array_keys($contexts['Section']) as $k) {
-            Debug::log('Key: ' . var_export($k, true));
             if ($this->getInput($k)) {
                 $html = getSimpleHTMLDOMCached($this->getURI() . $k);
 
diff --git a/bridges/SlusheBridge.php b/bridges/SlusheBridge.php
index 12bed13a..05be8d4f 100644
--- a/bridges/SlusheBridge.php
+++ b/bridges/SlusheBridge.php
@@ -118,13 +118,8 @@ class SlusheBridge extends BridgeAbstract
 
         $html = getSimpleHTMLDOM($uri, $headers);
 
-        //Debug::log($html);
-        //Debug::log($html->find('div.blog-item')[0]);
-
         //Loop on each entry
         foreach ($html->find('div.blog-item') as $element) {
-            //Debug::log($element);
-
             $title = $element->find('h3.title', 0)->first_child()->innertext;
             $article_uri = $element->find('h3.title', 0)->first_child()->href;
             $timestamp = $element->find('div.publication-date', 0)->innertext;
@@ -153,7 +148,6 @@ class SlusheBridge extends BridgeAbstract
                 // Add image thumbnail(s)
                 foreach ($media_uris->find('img') as $media_uri) {
                     $media_html .= '<a href="' . $article_uri . '">' . $media_uri . '</a>';
-                    //Debug::log('Adding to enclosures: ' . str_replace(' ', '%20', $media_uri->src));
                     $item['enclosures'][] = str_replace(' ', '%20', $media_uri->src);
                 }
             }
@@ -165,7 +159,7 @@ class SlusheBridge extends BridgeAbstract
                 foreach ($media_uris->find('img') as $media_uri) {
                     $media_html .= '<p>Video:</p><a href="' .
                         $article_uri . '">' . $media_uri . '</a>';
-                    //Debug::log('Adding to enclosures: ' . $media_uri->src);
+
                     $item['enclosures'][] = $media_uri->src;
                 }
             }
diff --git a/bridges/ThreadsBridge.php b/bridges/ThreadsBridge.php
index b7e5cd1a..cfcbba0e 100644
--- a/bridges/ThreadsBridge.php
+++ b/bridges/ThreadsBridge.php
@@ -70,9 +70,9 @@ class ThreadsBridge extends BridgeAbstract
     public function collectData()
     {
         $html = getSimpleHTMLDOMCached($this->getURI(), static::CACHE_TIMEOUT);
-        Debug::log(sprintf('Fetched: %s', $this->getURI()));
+
         $jsonBlobs = $html->find('script[type="application/json"]');
-        Debug::log(sprintf('%d JSON blobs found.', count($jsonBlobs)));
+
         $gatheredCodes = [];
         $limit = $this->getInput('limit');
         foreach ($jsonBlobs as $jsonBlob) {
@@ -87,7 +87,6 @@ class ThreadsBridge extends BridgeAbstract
                 }
             }
         }
-        Debug::log(sprintf('Candidate codes found in JSON in script tags: %s', print_r($gatheredCodes, true)));
 
         $this->feedName = html_entity_decode($html->find('meta[property=og:title]', 0)->content);
         // todo: meta[property=og:description] could populate the feed description
diff --git a/bridges/TwitterBridge.php b/bridges/TwitterBridge.php
index 93301038..800fd63c 100644
--- a/bridges/TwitterBridge.php
+++ b/bridges/TwitterBridge.php
@@ -541,7 +541,7 @@ EOD;
                             }
                             break;
                         default:
-                            Debug::log('Missing support for media type: ' . $media->type);
+                            break;
                     }
                 }
             }
diff --git a/bridges/TwitterV2Bridge.php b/bridges/TwitterV2Bridge.php
index 07af8301..19b27137 100644
--- a/bridges/TwitterV2Bridge.php
+++ b/bridges/TwitterV2Bridge.php
@@ -192,7 +192,6 @@ EOD
                 . $this->getInput('u'), $authHeaders, $params);
 
                 if (isset($user->errors)) {
-                    Debug::log('User JSON: ' . json_encode($user));
                     returnServerError('Requested username can\'t be found.');
                 }
 
@@ -266,7 +265,6 @@ EOD
             (isset($data->errors) && !isset($data->data)) ||
             (isset($data->meta) && $data->meta->result_count === 0)
         ) {
-            Debug::log('Data JSON: ' . json_encode($data));
             switch ($this->queriedContext) {
                 case 'By keyword or hashtag':
                     returnServerError('No results for this query.');
@@ -311,7 +309,6 @@ EOD
             foreach ($includesTweets as $includesTweet) {
                 $includesTweetsIds[] = $includesTweet->id;
             }
-            Debug::log('includesTweetsIds: ' . join(',', $includesTweetsIds));
 
             // Set default params for API query
             $params = [
@@ -336,8 +333,6 @@ EOD
 
         // Create output array with all required elements for each tweet
         foreach ($tweets as $tweet) {
-            //Debug::log('Tweet JSON: ' . json_encode($tweet));
-
             // Skip pinned tweet (if selected)
             if ($hidePinned && $tweet->id === $pinnedTweetId) {
                 continue;
@@ -376,12 +371,10 @@ EOD
             $cleanedQuotedTweet = null;
             $quotedUser = null;
             if ($isQuote) {
-                Debug::log('Tweet is quote');
                 foreach ($includesTweets as $includesTweet) {
                     if ($includesTweet->id === $tweet->referenced_tweets[0]->id) {
                         $quotedTweet = $includesTweet;
                         $cleanedQuotedTweet = nl2br($quotedTweet->text);
-                        //Debug::log('Found quoted tweet');
                         break;
                     }
                 }
@@ -389,7 +382,6 @@ EOD
                 $quotedUser = $this->getTweetUser($quotedTweet, $retweetedUsers, $includesUsers);
             }
             if ($isRetweet || is_null($user)) {
-                Debug::log('Tweet is retweet, or $user is null');
                 // Replace tweet object with original retweeted object
                 if ($isRetweet) {
                     foreach ($includesTweets as $includesTweet) {
@@ -430,7 +422,6 @@ EOD
                          . $this->item['username'] . ')';
 
             $cleanedTweet = nl2br($tweet->text);
-            //Debug::log('cleanedTweet: ' . $cleanedTweet);
 
             // Perform optional keyword filtering (only keep tweet if keyword is found)
             if (! empty($tweetFilter)) {
@@ -452,7 +443,6 @@ EOD
             // Search for and replace URLs in Tweet text
             $cleanedTweet = $this->replaceTweetURLs($tweet, $cleanedTweet);
             if (isset($cleanedQuotedTweet)) {
-                Debug::log('Replacing URLs in Quoted Tweet text');
                 $cleanedQuotedTweet = $this->replaceTweetURLs($quotedTweet, $cleanedQuotedTweet);
             }
 
@@ -478,9 +468,7 @@ EOD
             // Get external link info
             $extURL = null;
             if (isset($tweet->entities->urls) && strpos($tweet->entities->urls[0]->expanded_url, 'twitter.com') === false) {
-                Debug::log('Found an external link!');
                 $extURL = $tweet->entities->urls[0]->expanded_url;
-                Debug::log($extURL);
                 $extDisplayURL = $tweet->entities->urls[0]->display_url;
                 $extTitle = $tweet->entities->urls[0]->title;
                 $extDesc = $tweet->entities->urls[0]->description;
@@ -513,15 +501,12 @@ EOD;
             $ext_media_html = '';
             if (!$hideImages) {
                 if (isset($tweet->attachments->media_keys)) {
-                    Debug::log('Generating HTML for tweet media');
                     $media_html = $this->createTweetMediaHTML($tweet, $includesMedia, $retweetedMedia);
                 }
                 if (isset($quotedTweet->attachments->media_keys)) {
-                    Debug::log('Generating HTML for quoted tweet media');
                     $quoted_media_html = $this->createTweetMediaHTML($quotedTweet, $includesMedia, $retweetedMedia);
                 }
                 if (isset($extURL)) {
-                    Debug::log('Generating HTML for external link media');
                     if ($this->getInput('noimgscaling')) {
                         $extMediaURL = $extMediaOrig;
                     } else {
@@ -562,7 +547,6 @@ QUOTE;
 
             // Add External Link HTML, if relevant
             if (isset($extURL) && !$this->getInput('noexternallink')) {
-                Debug::log('Adding HTML for external link');
                 $ext_html = <<<EXTERNAL
 <div style="display: table; border-style: solid; border-width: 1px; border-radius: 5px; padding: 5px;">
     $ext_media_html<br>
@@ -653,21 +637,18 @@ EXTERNAL;
     {
         $originalUser = new stdClass(); // make the linters stop complaining
         if (isset($retweetedUsers)) {
-            Debug::log('Searching for tweet author_id in $retweetedUsers');
             foreach ($retweetedUsers as $retweetedUser) {
                 if ($retweetedUser->id === $tweetObject->author_id) {
                     $matchedUser = $retweetedUser;
-                    Debug::log('Found author_id match in $retweetedUsers');
                     break;
                 }
             }
         }
         if (!isset($matchedUser->username) && isset($includesUsers)) {
-            Debug::log('Searching for tweet author_id in $includesUsers');
             foreach ($includesUsers as $includesUser) {
                 if ($includesUser->id === $tweetObject->author_id) {
                     $matchedUser = $includesUser;
-                    Debug::log('Found author_id match in $includesUsers');
+
                     break;
                 }
             }
@@ -689,7 +670,6 @@ EXTERNAL;
         $tweetMedia = [];
         // Start by checking the original list of tweet Media includes
         if (isset($includesMedia)) {
-            Debug::log('Searching for media_key in $includesMedia');
             foreach ($includesMedia as $includesMedium) {
                 if (
                     in_array(
@@ -697,14 +677,12 @@ EXTERNAL;
                         $tweetObject->attachments->media_keys
                     )
                 ) {
-                    Debug::log('Found media_key in $includesMedia');
                     $tweetMedia[] = $includesMedium;
                 }
             }
         }
         // If no matches found, check the retweet Media includes
         if (empty($tweetMedia) && isset($retweetedMedia)) {
-            Debug::log('Searching for media_key in $retweetedMedia');
             foreach ($retweetedMedia as $retweetedMedium) {
                 if (
                     in_array(
@@ -712,7 +690,6 @@ EXTERNAL;
                         $tweetObject->attachments->media_keys
                     )
                 ) {
-                    Debug::log('Found media_key in $retweetedMedia');
                     $tweetMedia[] = $retweetedMedium;
                 }
             }
@@ -760,8 +737,7 @@ EOD;
 EOD;
                     break;
                 default:
-                    Debug::log('Missing support for media type: '
-                    . $media->type);
+                    break;
             }
         }
 
diff --git a/bridges/UnraidCommunityApplicationsBridge.php b/bridges/UnraidCommunityApplicationsBridge.php
index 441edb65..1295e827 100644
--- a/bridges/UnraidCommunityApplicationsBridge.php
+++ b/bridges/UnraidCommunityApplicationsBridge.php
@@ -14,14 +14,12 @@ class UnraidCommunityApplicationsBridge extends BridgeAbstract
 
     private function fetchApps()
     {
-        Debug::log('Fetching all applications/plugins');
         $this->apps = getContents(self::APPSURI);
         $this->apps = json_decode($this->apps, true)['applist'];
     }
 
     private function sortApps()
     {
-        Debug::log('Sorting applications/plugins');
         usort($this->apps, function ($app1, $app2) {
             return $app1['FirstSeen'] < $app2['FirstSeen'] ? 1 : -1;
         });
diff --git a/bridges/XenForoBridge.php b/bridges/XenForoBridge.php
index 1ecb1d74..d1ecea74 100644
--- a/bridges/XenForoBridge.php
+++ b/bridges/XenForoBridge.php
@@ -436,8 +436,6 @@ class XenForoBridge extends BridgeAbstract
                 break;
         }
 
-        // Debug::log(date_format($df, 'U'));
-
         return date_format($df, 'U');
     }
 }
diff --git a/lib/BridgeCard.php b/lib/BridgeCard.php
index d15ac865..27285558 100644
--- a/lib/BridgeCard.php
+++ b/lib/BridgeCard.php
@@ -192,7 +192,7 @@ final class BridgeCard
     {
         $required = $entry['required'] ?? null;
         if ($required) {
-            Debug::log('The "required" attribute is not supported for lists.');
+            trigger_error('The required attribute is not supported for lists');
             unset($entry['required']);
         }
 
@@ -235,7 +235,7 @@ final class BridgeCard
     {
         $required = $entry['required'] ?? null;
         if ($required) {
-            Debug::log('The "required" attribute is not supported for checkboxes.');
+            trigger_error('The required attribute is not supported for checkboxes');
             unset($entry['required']);
         }
 
diff --git a/lib/Debug.php b/lib/Debug.php
index ba9e787e..630fd8ec 100644
--- a/lib/Debug.php
+++ b/lib/Debug.php
@@ -15,20 +15,4 @@ class Debug
         }
         return false;
     }
-
-    /**
-     * @deprecated Use $this->logger->debug()
-     */
-    public static function log($message)
-    {
-        $e = new \Exception();
-        $trace = trace_from_exception($e);
-        // Drop the current frame
-        array_pop($trace);
-        $lastFrame = $trace[array_key_last($trace)];
-        $text = sprintf('%s(%s): %s', $lastFrame['file'], $lastFrame['line'], $message);
-
-        $logger = RssBridge::getLogger();
-        $logger->debug($text);
-    }
 }
diff --git a/lib/FeedItem.php b/lib/FeedItem.php
index bca06c23..8c9a60b1 100644
--- a/lib/FeedItem.php
+++ b/lib/FeedItem.php
@@ -12,6 +12,8 @@ class FeedItem
     protected ?string $uid = null;
     protected array $misc = [];
 
+    private Logger $logger;
+
     public static function fromArray(array $itemArray): self
     {
         $item = new self();
@@ -23,6 +25,7 @@ class FeedItem
 
     private function __construct()
     {
+        $this->logger = RssBridge::getLogger();
     }
 
     public function __set($name, $value)
@@ -99,17 +102,17 @@ class FeedItem
             } elseif ($uri->hasAttribute('src')) { // Image
                 $uri = $uri->src;
             } else {
-                Debug::log('The item provided as URI is unknown!');
+                $this->logger->debug('The item provided as URI is unknown!');
             }
         }
         if (!is_string($uri)) {
-            Debug::log(sprintf('Expected $uri to be string but got %s', gettype($uri)));
+            $this->logger->debug(sprintf('Expected $uri to be string but got %s', gettype($uri)));
             return;
         }
         $uri = trim($uri);
         // Intentionally doing a weak url validation here because FILTER_VALIDATE_URL is too strict
         if (!preg_match('#^https?://#i', $uri)) {
-            Debug::log(sprintf('Not a valid url: "%s"', $uri));
+            $this->logger->debug(sprintf('Not a valid url: "%s"', $uri));
             return;
         }
         $this->uri = $uri;
@@ -124,7 +127,7 @@ class FeedItem
     {
         $this->title = null;
         if (!is_string($title)) {
-            trigger_error('Title must be a string: ' . print_r($title, true));
+            $this->logger->debug('Title must be a string: ' . print_r($title, true));
         } else {
             $this->title = truncate(trim($title));
         }
@@ -143,11 +146,11 @@ class FeedItem
         } else {
             $timestamp = strtotime($datetime);
             if ($timestamp === false) {
-                Debug::log('Unable to parse timestamp!');
+                $this->logger->debug('Unable to parse timestamp!');
             }
         }
         if ($timestamp <= 0) {
-            Debug::log('Timestamp must be greater than zero!');
+            $this->logger->debug('Timestamp must be greater than zero!');
         } else {
             $this->timestamp = $timestamp;
         }
@@ -162,7 +165,7 @@ class FeedItem
     {
         $this->author = null;
         if (!is_string($author)) {
-            Debug::log('Author must be a string!');
+            $this->logger->debug('Author must be a string!');
         } else {
             $this->author = $author;
         }
@@ -190,7 +193,7 @@ class FeedItem
         if (is_string($content)) {
             $this->content = $content;
         } else {
-            Debug::log(sprintf('Unable to convert feed content to string: %s', gettype($content)));
+            $this->logger->debug(sprintf('Unable to convert feed content to string: %s', gettype($content)));
         }
     }
 
@@ -204,7 +207,7 @@ class FeedItem
         $this->enclosures = [];
 
         if (!is_array($enclosures)) {
-            Debug::log('Enclosures must be an array!');
+            $this->logger->debug('Enclosures must be an array!');
             return;
         }
         foreach ($enclosures as $enclosure) {
@@ -215,7 +218,7 @@ class FeedItem
                     FILTER_FLAG_PATH_REQUIRED
                 )
             ) {
-                Debug::log('Each enclosure must contain a scheme, host and path!');
+                $this->logger->debug('Each enclosure must contain a scheme, host and path!');
             } elseif (!in_array($enclosure, $this->enclosures)) {
                 $this->enclosures[] = $enclosure;
             }
@@ -232,14 +235,14 @@ class FeedItem
         $this->categories = [];
 
         if (!is_array($categories)) {
-            Debug::log('Categories must be an array!');
+            $this->logger->debug('Categories must be an array!');
             return;
         }
         foreach ($categories as $category) {
             if (is_string($category)) {
                 $this->categories[] = $category;
             } else {
-                Debug::log('Category must be a string!');
+                $this->logger->debug('Category must be a string!');
             }
         }
     }
@@ -253,7 +256,7 @@ class FeedItem
     {
         $this->uid = null;
         if (!is_string($uid)) {
-            Debug::log(sprintf('uid must be string: %s (%s)', (string) $uid, var_export($uid, true)));
+            $this->logger->debug(sprintf('uid must be string: %s (%s)', (string) $uid, var_export($uid, true)));
             return;
         }
         if (preg_match('/^[a-f0-9]{40}$/', $uid)) {
@@ -267,9 +270,9 @@ class FeedItem
     public function addMisc($name, $value)
     {
         if (!is_string($name)) {
-            Debug::log('Key must be a string!');
+            $this->logger->debug('Key must be a string!');
         } elseif (in_array($name, get_object_vars($this))) {
-            Debug::log('Key must be unique!');
+            $this->logger->debug('Key must be unique!');
         } else {
             $this->misc[$name] = $value;
         }
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index e80e6f0a..23f65cf0 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -100,7 +100,8 @@ final class RssBridge
 
     public static function getLogger(): Logger
     {
-        return self::$logger;
+        // null logger is only for the tests not to fail
+        return self::$logger ?? new NullLogger();
     }
 
     public static function getCache(): CacheInterface

From f358f1abec8278c4e5659b311bf8eea5f34802d8 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 8 Aug 2024 17:47:04 +0200
Subject: [PATCH 455/716] refactor: loadCacheValue/saveCacheValue (#4205)

---
 bridges/BugzillaBridge.php              |   2 +-
 bridges/FurAffinityBridge.php           |   2 +-
 bridges/ItakuBridge.php                 |   2 +-
 bridges/MastodonBridge.php              |   2 +-
 bridges/PixivBridge.php                 |   2 +-
 bridges/WordPressMadaraBridge.php       |   2 +-
 docs/05_Bridge_API/02_BridgeAbstract.md | 324 +++++++++++++-----------
 lib/BridgeAbstract.php                  |  10 +-
 8 files changed, 188 insertions(+), 158 deletions(-)

diff --git a/bridges/BugzillaBridge.php b/bridges/BugzillaBridge.php
index c2dc8d40..23e93eb8 100644
--- a/bridges/BugzillaBridge.php
+++ b/bridges/BugzillaBridge.php
@@ -164,7 +164,7 @@ class BugzillaBridge extends BridgeAbstract
         }
 
         $cache = $this->loadCacheValue($this->instance . $user);
-        if (!is_null($cache)) {
+        if ($cache) {
             return $cache;
         }
 
diff --git a/bridges/FurAffinityBridge.php b/bridges/FurAffinityBridge.php
index 087c3ded..f7d830bb 100644
--- a/bridges/FurAffinityBridge.php
+++ b/bridges/FurAffinityBridge.php
@@ -676,7 +676,7 @@ class FurAffinityBridge extends BridgeAbstract
                 $name = parent::getName();
                 if ($this->getOption('aCookie') !== null) {
                     $username = $this->loadCacheValue('username');
-                    if ($username !== null) {
+                    if ($username) {
                         $name = $username . '\'s ' . parent::getName();
                     }
                 }
diff --git a/bridges/ItakuBridge.php b/bridges/ItakuBridge.php
index e6ecbdc8..b231b143 100644
--- a/bridges/ItakuBridge.php
+++ b/bridges/ItakuBridge.php
@@ -667,7 +667,7 @@ class ItakuBridge extends BridgeAbstract
         if ($getJSON) { //get JSON object
             if ($cache) {
                 $data = $this->loadCacheValue($url);
-                if (is_null($data)) {
+                if (!$data) {
                     $data = getContents($url, $httpHeaders, $curlOptions);
                     $this->saveCacheValue($url, $data);
                 }
diff --git a/bridges/MastodonBridge.php b/bridges/MastodonBridge.php
index b98b1135..e180fdb4 100644
--- a/bridges/MastodonBridge.php
+++ b/bridges/MastodonBridge.php
@@ -105,7 +105,7 @@ class MastodonBridge extends BridgeAbstract
                         break;
                     }
                     $rtUser = $this->loadCacheValue($rtContent['attributedTo']);
-                    if (!isset($rtUser)) {
+                    if (!$rtUser) {
                         // We fetch the author, since we cannot always assume the format of the URL.
                         $user = $this->fetchAP($rtContent['attributedTo']);
                         preg_match('/https?:\/\/([a-z0-9-\.]{0,})\//', $rtContent['attributedTo'], $matches);
diff --git a/bridges/PixivBridge.php b/bridges/PixivBridge.php
index 820b3a7c..e464b12d 100644
--- a/bridges/PixivBridge.php
+++ b/bridges/PixivBridge.php
@@ -314,7 +314,7 @@ class PixivBridge extends BridgeAbstract
     {
         // checks if cookie is set, if not initialise it with the cookie from the config
         $value = $this->loadCacheValue('cookie');
-        if (!isset($value)) {
+        if (!$value) {
             $value = $this->getOption('cookie');
 
             // 30 days + 1 day to let cookie chance to renew
diff --git a/bridges/WordPressMadaraBridge.php b/bridges/WordPressMadaraBridge.php
index 4325075c..9af44ef4 100644
--- a/bridges/WordPressMadaraBridge.php
+++ b/bridges/WordPressMadaraBridge.php
@@ -118,7 +118,7 @@ The default URI shows the Madara demo page.';
     {
         $url_cache = 'TitleInfo_' . preg_replace('/[^\w]/', '.', rtrim($url, '/'));
         $cache = $this->loadCacheValue($url_cache);
-        if (isset($cache)) {
+        if ($cache) {
             return $cache;
         }
 
diff --git a/docs/05_Bridge_API/02_BridgeAbstract.md b/docs/05_Bridge_API/02_BridgeAbstract.md
index a8e9db42..b6813a16 100644
--- a/docs/05_Bridge_API/02_BridgeAbstract.md
+++ b/docs/05_Bridge_API/02_BridgeAbstract.md
@@ -1,4 +1,5 @@
-`BridgeAbstract` is a base class for standard bridges. It implements the most common functions to simplify the process of adding new bridges.
+`BridgeAbstract` is a base class for standard bridges.
+It implements the most common functions to simplify the process of adding new bridges.
 
 ***
 
@@ -11,7 +12,9 @@ You need four basic steps in order to create a new bridge:
 [**Step 3**](#step-3---add-general-constants-to-the-class) - Add general constants to the class
 [**Step 4**](#step-4---implement-a-function-to-collect-feed-data) - Implement a function to collect feed data
 
-These steps are described in more detail below. At the end of this document you'll find a complete [template](#template) based on these instructions. The pictures below show an example based on these instructions:
+These steps are described in more detail below.
+At the end of this document you'll find a complete [template](#template) based on these instructions.
+The pictures below show an example based on these instructions:
 
 <details><summary>Show pictures</summary><div>
 
@@ -23,7 +26,12 @@ These steps are described in more detail below. At the end of this document you'
 
 </div></details><br>
 
-Make sure to read these instructions carefully. Please don't hesitate to open an [Issue](https://github.com/RSS-Bridge/rss-bridge/issues) if you have further questions (or suggestions). Once your bridge is finished, please open a [Pull Request](https://github.com/RSS-Bridge/rss-bridge/pulls), in order to get your bridge merge into RSS-Bridge.
+Make sure to read these instructions carefully.
+Please don't hesitate to open an 
+[Issue](https://github.com/RSS-Bridge/rss-bridge/issues)
+if you have further questions (or suggestions).
+Once your bridge is finished, please open a [Pull Request](https://github.com/RSS-Bridge/rss-bridge/pulls),
+in order to get your bridge merge into RSS-Bridge.
 
 ***
 
@@ -33,7 +41,8 @@ Please read [these instructions](./01_How_to_create_a_new_bridge.md) on how to c
 
 ## Step 2 - Add a class, extending `BridgeAbstract`
 
-Your bridge needs to be a class, which extends `BridgeAbstract`. The class name must **exactly** match the name of the file, without the file extension.
+Your bridge needs to be a class, which extends `BridgeAbstract`.
+The class name must **exactly** match the name of the file, without the file extension.
 
 For example: `MyBridge.php` => `MyBridge`
 
@@ -65,43 +74,46 @@ const CACHE_TIMEOUT // (optional) Defines the maximum duration for the cache in
 <details><summary>Show example</summary><div>
 
 ```PHP
-<?PHP
+<?php
+
 class MyBridge extends BridgeAbstract {
 	const NAME        = 'My Bridge';
 	const URI         = 'https://rss-bridge.github.io/rss-bridge/Bridge_API/BridgeAbstract.html';
 	const DESCRIPTION = 'Returns "Hello World!"';
 	const MAINTAINER  = 'ghost';
 }
-// This line is empty (just imagine it!)
 ```
 
 </div></details><br>
 
-**Notice**: `const PARAMETERS` can be used to request information from the user. Refer to [these instructions](#parameters) for more information.
+**Notice**: `const PARAMETERS` can be used to request information from the user.
+Refer to [these instructions](#parameters) for more information.
 
 ## Step 4 - Implement a function to collect feed data
 
-In order for RSS-Bridge to collect data, you must implement the **public** function `collectData`. This function takes no arguments and returns nothing. It generates a list of feed elements, which must be placed into the variable `$this->items`.
+In order for RSS-Bridge to collect data, you must implement the **public** function `collectData`.
+This function takes no arguments and returns nothing.
+It generates a list of feed elements, which must be placed into the variable `$this->items`.
 
 <details><summary>Show example</summary><div>
 
 ```PHP
-<?PHP
-class MyBridge extends BridgeAbstract {
-	const NAME        = 'My Bridge';
-	const URI         = 'https://rss-bridge.github.io/rss-bridge/Bridge_API/BridgeAbstract.html';
-	const DESCRIPTION = 'Returns "Hello World!"';
-	const MAINTAINER  = 'ghost';
+<?php
 
-	public function collectData() {
-		$item = []; // Create an empty item
+class MyBridge extends BridgeAbstract
+{
+    const NAME        = 'My Bridge';
+    const URI         = 'https://rss-bridge.github.io/rss-bridge/Bridge_API/BridgeAbstract.html';
+    const DESCRIPTION = 'Returns "Hello World!"';
+    const MAINTAINER  = 'ghost';
 
-		$item['title'] = 'Hello World!';
-
-		$this->items[] = $item; // Add item to the list
-	}
+    public function collectData()
+    {
+        $item = [];
+        $item['title'] = 'Hello World!';
+        $this->items[] = $item;
+    }
 }
-// This line is empty (just imagine it!)
 ```
 
 </div></details><br>
@@ -112,32 +124,36 @@ For more details on the `collectData` function refer to [these instructions](#co
 
 # Template
 
-Use this template to create your own bridge. Please remove any unnecessary comments and parameters.
+Use this template to create your own bridge.
+Please remove any unnecessary comments and parameters.
 
 ```php
 <?php
-class MyBridge extends BridgeAbstract {
-	const NAME = 'Unnamed bridge';
-	const URI = '';
-	const DESCRIPTION = 'No description provided';
-	const MAINTAINER = 'No maintainer';
-	const PARAMETERS = []; // Can be omitted!
-	const CACHE_TIMEOUT = 3600; // Can be omitted!
 
-	public function collectData() {
-		$item = []; // Create an empty item
-
-		$item['title'] = 'Hello World!';
-
-		$this->items[] = $item; // Add item to the list
-	}
+class MyBridge extends BridgeAbstract
+{
+    const NAME = 'Unnamed bridge';
+    const URI = '';
+    const DESCRIPTION = 'No description provided';
+    const MAINTAINER = 'No maintainer';
+    const PARAMETERS = []; // Can be omitted!
+    const CACHE_TIMEOUT = 3600; // Can be omitted!
+    
+    public function collectData()
+    {
+        $item = []; // Create an empty item
+    
+        $item['title'] = 'Hello World!';
+    
+        $this->items[] = $item; // Add item to the list
+    }
 }
-// This line is empty (just imagine it!)
 ```
 
 # PARAMETERS
 
-You can specify additional parameters in order to customize the bridge (i.e. to specify how many items to return). This document explains how to specify those parameters and which options are available to you.
+You can specify additional parameters in order to customize the bridge (i.e. to specify how many items to return).
+This document explains how to specify those parameters and which options are available to you.
 
 For information on how to read parameter values during execution, please refer to the [getInput](../06_Helper_functions/index.md#getinput) function.
 
@@ -145,12 +161,14 @@ For information on how to read parameter values during execution, please refer t
 
 ## Adding parameters to a bridge
 
-Parameters are specified as part of the bridge class. An empty list of parameters is defined as `const PARAMETERS = [];`
+Parameters are specified as part of the bridge class.
+An empty list of parameters is defined as `const PARAMETERS = [];`
 
 <details><summary>Show example</summary><div>
 
 ```PHP
-<?PHP
+<?php
+
 class MyBridge extends BridgeAbstract {
 	/* ... */
 	const PARAMETERS = []; // Empty list of parameters (can be omitted)
@@ -167,7 +185,8 @@ Parameters are organized in two levels:
 
 ## Level 1 - Context
 
-A context is defined as a associative array of parameters. The name of a context is displayed by RSS-Bridge.
+A context is defined as a associative array of parameters.
+The name of a context is displayed by RSS-Bridge.
 
 <details><summary>Show example</summary><div>
 
@@ -196,7 +215,8 @@ const PARAMETERS = [
 
 </div></details><br>
 
-You can also define a set of parameters that will be applied to every possible context of your bridge. To do this, specify a context named `global`.
+You can also define a set of parameters that will be applied to every possible context of your bridge.
+To do this, specify a context named `global`.
 
 <details><summary>Show example</summary><div>
 
@@ -219,9 +239,9 @@ where `n` is the name with which the bridge can access the parameter during exec
 
 ```PHP
 const PARAMETERS = [
-	'My Context' => [
-		'n' => []
-	]
+    'My Context' => [
+        'n' => [],
+    ]
 ];
 ```
 
@@ -232,17 +252,17 @@ The parameter specification consists of various fields, listed in the table belo
 <details><summary>Show example</summary><div>
 
 ```PHP
-const PARAMETERS = array(
-	'My Context' => array(
-		'n' => array(
+const PARAMETERS = [
+	'My Context' => [
+		'n' => [
 			'name' => 'Limit',
 			'type' => 'number',
 			'required' => false,
 			'title' => 'Maximum number of items to return',
-			'defaultValue' => 10
-		)
-	)
-);
+			'defaultValue' => 10,
+		]
+	]
+];
 ```
 
 **Output**
@@ -271,29 +291,30 @@ List values are defined in an associative array where keys are the string displa
 ```PHP
 ...
     'type' => 'list',
-    'values' => array(
+    'values' => [
         'Item A' => 'itemA'
         'Item B' => 'itemB'
-     )
+     ]
 ...
 ```
 
 If a more complex organization is required to display the values, the above key/value can be used to set a title as a key and another array as a value:
+
 ```PHP
 ...
     'type' => 'list',
-    'values' => array(
+    'values' => [
         'Item A' => 'itemA',
-        'List 1' => array(
+        'List 1' => [
             'Item C' => 'itemC',
             'Item D' => 'itemD'
-        ),
-        'List 2' => array(
+        ],
+        'List 2' => [
             'Item E' => 'itemE',
             'Item F' => 'itemF'
-        ),
+        ],
         'Item B' => 'itemB'
-    )
+    ]
 ...
 ```
 
@@ -316,20 +337,18 @@ It provides a way to identify which context the bridge is called with.
 Example:
 
 ```PHP
-...
-	const PARAMETERS = array(
-		'By user name' => array(
-			'u' => array('name' => 'Username')
-		),
-		'By user ID' => array(
-			'id' => array('name' => 'User ID')
-		)
-	);
-
-...
+const PARAMETERS = [
+    'By user name' => [
+        'u' => ['name' => 'Username']
+    ],
+    'By user ID' => [
+        'id' => ['name' => 'User ID']
+    ]
+];
 ```
 
-In this example `$this->queriedContext` will either return **By user name** or **By user ID**. The queried context might return no value, so the best way to handle it is by using a case-structure:
+In this example `$this->queriedContext` will either return **By user name** or **By user ID**.
+The queried context might return no value, so the best way to handle it is by using a case-structure:
 
 ```PHP
 switch($this->queriedContext){
@@ -342,32 +361,36 @@ switch($this->queriedContext){
 ```
 
 # collectData
-The `collectData` function is responsible for collecting data and adding items to generate feeds from. If you are unsure how to solve a specific problem, please don't hesitate to open an [Issue](https://github.com/RSS-Bridge/rss-bridge/issues) on GitHub. Existing bridges are also a good source to learn implementing your own bridge.
+
+The `collectData` function is responsible for collecting data and adding items to generate feeds from.
+If you are unsure how to solve a specific problem, please don't hesitate to open an [Issue](https://github.com/RSS-Bridge/rss-bridge/issues) on GitHub.
+Existing bridges are also a good source to learn implementing your own bridge.
 
 ## Implementing the `collectData` function
 
-Implementation for the `collectData` function is specific to each bridge. However, there are certain reoccurring elements, described below. RSS-Bridge also provides functions to simplify the process of collecting and parsing HTML data (see "Helper Functions" on the sidebar)
+Implementation for the `collectData` function is specific to each bridge.
+However, there are certain reoccurring elements, described below. RSS-Bridge also provides functions to simplify the process of collecting and parsing HTML data (see "Helper Functions" on the sidebar)
 
-Elements collected by this function must be stored in `$this->items`. The `items` variable is an array of item elements, each of which is an associative array that may contain arbitrary keys. RSS-Bridge specifies common keys which are used to generate most common feed formats.
+Elements collected by this function must be stored in `$this->items`.
+The `items` variable is an array of item elements, each of which is an associative array that may contain arbitrary keys.
+RSS-Bridge specifies common keys which are used to generate most common feed formats.
 
 <details><summary>Show example</summary><div>
 
 ```PHP
-
-$item = []; // Create a new item
-
+$item = [];
 $item['title'] = 'Hello World!';
-
-$this->items[] = $item; // Add item to the list
-
+$this->items[] = $item;
 ```
 
 </div></details><br>
+
 Additional keys may be added for custom APIs (ignored by RSS-Bridge).
 
 ## Item parameters
 
-The item array should provide as much information as possible for RSS-Bridge to generate feature rich feeds. Find below list of keys supported by RSS-Bridge.
+The item array should provide as much information as possible for RSS-Bridge to generate feature rich feeds.
+Find below list of keys supported by RSS-Bridge.
 
 ```PHP
 $item['uri']        // URI to reach the subject ("https://...")
@@ -379,65 +402,81 @@ $item['enclosures'] // Array of URIs to an attachments (pictures, files, etc...)
 $item['categories'] // Array of categories / tags / topics
 $item['uid']        // A unique ID to identify the current item
 ```
+
 All formats support these parameters. The formats `Plaintext` and `JSON` also support custom parameters.
 
 # getDescription
 
 The `getDescription` function returns the description for a bridge.
 
-**Notice:** By default **RSS-Bridge** returns the contents of `const DESCRIPTION`, so you only have to implement this function if you require different behavior!
+**Notice:** By default **RSS-Bridge** returns the contents of `const DESCRIPTION`,
+so you only have to implement this function if you require different behavior!
 
 ```PHP
-	public function getDescription(){
-		return self::DESCRIPTION;
-	}
+public function getDescription()
+{
+    return self::DESCRIPTION;
+}
 ```
 
 # getMaintainer
 
 The `getMaintainer` function returns the name of the maintainer for a bridge.
 
-**Notice:** By default **RSS-Bridge** returns `const MAINTAINER`, so you only have to implement this function if you require different behavior!
+**Notice:** By default **RSS-Bridge** returns `const MAINTAINER`,
+so you only have to implement this function if you require different behavior!
 
 ```PHP
-	public function getMaintainer(){
-		return self::MAINTAINER;
-	}
+public function getMaintainer()
+{
+    return self::MAINTAINER;
+}
 ```
 
 # getName
+
 The `getName` function returns the name of a bridge.
 
-**Notice:** By default **RSS-Bridge** returns `const NAME`, so you only have to implement this function if you require different behavior!
+**Notice:** By default **RSS-Bridge** returns `const NAME`,
+so you only have to implement this function if you require different behavior!
 
 ```PHP
-	public function getName(){
-		return self::NAME;
-	}
+public function getName()
+{
+    return self::NAME;
+}
 ```
 
 # getURI
+
 The `getURI` function returns the base URI for a bridge.
 
-**Notice:** By default **RSS-Bridge** returns `const URI`, so you only have to implement this function if you require different behavior!
+**Notice:** By default **RSS-Bridge** returns `const URI`,
+so you only have to implement this function if you require different behavior!
 
 ```PHP
-	public function getURI(){
-		return self::URI;
-	}
+public function getURI()
+{
+    return self::URI;
+}
 ```
 
 # getIcon
+
 The `getIcon` function returns the URI for an icon, used as favicon in feeds.
 
-If no icon is specified by the bridge, RSS-Bridge will use a default location: `static::URI . '/favicon.ico'` (i.e. "https://github.com/favicon.ico") which may or may not exist.
+If no icon is specified by the bridge,
+RSS-Bridge will use a default location: `static::URI . '/favicon.ico'` (i.e. "https://github.com/favicon.ico") which may or may not exist.
 
 ```PHP
-	public function getIcon(){
-		return static::URI . '/favicon.ico';
-	}
+public function getIcon()
+{
+    return static::URI . '/favicon.ico';
+}
 ```
+
 # detectParameters
+
 The `detectParameters` function takes a URL and attempts to extract a valid set of parameters for the current bridge.
 
 If the passed URL is valid for this bridge, the function should return an array of parameter -> value pairs that can be used by this bridge, including context if available, or an empty array if the bridge requires no parameters. If the URL is not relevant for this bridge, the function should return `null`.
@@ -445,31 +484,34 @@ If the passed URL is valid for this bridge, the function should return an array
 **Notice:** Implementing this function is optional. By default, **RSS-Bridge** tries to match the supplied URL to the `URI` constant defined in the bridge, which may be enough for bridges without any parameters defined.
 
 ```PHP
-public function detectParameters($url){
-	$regex = '/^(https?:\/\/)?(www\.)?(.+?)(\/)?$/';
-	if(empty(static::PARAMETERS)
-	&& preg_match($regex, $url, $urlMatches) > 0
-	&& preg_match($regex, static::URI, $bridgeUriMatches) > 0
-	&& $urlMatches[3] === $bridgeUriMatches[3]) {
-		return [];
-	} else {
-		return null;
-	}
+public function detectParameters($url)
+{
+    $regex = '/^(https?:\/\/)?(www\.)?(.+?)(\/)?$/';
+    if (empty(static::PARAMETERS)
+        && preg_match($regex, $url, $urlMatches) > 0
+        && preg_match($regex, static::URI, $bridgeUriMatches) > 0
+        && $urlMatches[3] === $bridgeUriMatches[3]
+    ) {
+        return [];
+    } else {
+        return null;
+    }
 }
 ```
 
-**Notice:** This function is also used by the [findFeed](../04_For_Developers/04_Actions.md#findfeed) action. This action allows an user to get a list of all feeds corresponding to an URL.
+**Notice:** This function is also used by the [findFeed](../04_For_Developers/04_Actions.md#findfeed) action.
+This action allows an user to get a list of all feeds corresponding to an URL.
 
 You can implement automated tests for the `detectParameters` function by adding the `TEST_DETECT_PARAMETERS` constant to your bridge class constant.
 
 `TEST_DETECT_PARAMETERS` is an array, with as key the URL passed to the `detectParameters`function and as value, the array of parameters returned by `detectParameters` 
 
 ```PHP
-    const TEST_DETECT_PARAMETERS = [
-        'https://www.instagram.com/metaverse' => ['context' => 'Username', 'u' => 'metaverse'],
-        'https://instagram.com/metaverse' => ['context' => 'Username', 'u' => 'metaverse'],
-        'http://www.instagram.com/metaverse' => ['context' => 'Username', 'u' => 'metaverse'],
-    ];
+const TEST_DETECT_PARAMETERS = [
+    'https://www.instagram.com/metaverse' => ['context' => 'Username', 'u' => 'metaverse'],
+    'https://instagram.com/metaverse' => ['context' => 'Username', 'u' => 'metaverse'],
+    'http://www.instagram.com/metaverse' => ['context' => 'Username', 'u' => 'metaverse'],
+];
 ```
 
 **Notice:** Adding this constant is optional. If the constant is not present, no automated test will be executed.
@@ -478,57 +520,47 @@ You can implement automated tests for the `detectParameters` function by adding
 ***
 
 # Helper Methods
-`BridgeAbstract` implements helper methods to make it easier for bridge maintainers to create bridges. Use these methods whenever possible instead of writing your own.
 
-- [saveCacheValue](#savecachevalue)
-- [loadCacheValue](#loadcachevalue)
+`BridgeAbstract` implements helper methods to make it easier for bridge maintainers to create bridges.
+Use these methods whenever possible instead of writing your own.
 
 ## saveCacheValue
-Within the context of the current bridge, stores a value by key in the cache. The value can later be retrieved with [loadCacheValue](#loadcachevalue).
+
+Within the context of the current bridge, stores a value by key in the cache.
+The value can later be retrieved with [loadCacheValue](#loadcachevalue).
 
 ```php
-protected function saveCacheValue($key, $value)
+protected function saveCacheValue($key, $value, $ttl = null)
 ```
 
-- `$key` - the name under which the value is stored in the cache.
-- `$value` - the value to store in the cache.
-
-Usage example:
+Example:
 
 ```php
-const MY_KEY = 'MyKey';
-
 public function collectData()
 {
-    $value = 'my value';
-    $this->saveCacheValue(MY_KEY, $value);
+    $this->saveCacheValue('my_key', 'my_value', 3600); // 1h
 }
 ```
 
 ## loadCacheValue
-Within the context of the current bridge, loads a value by key from cache. Optionally specifies the cache duration for the key. Returns `null` if the key doesn't exist or the value is expired.
+
+Within the context of the current bridge, loads a value by key from cache.
+Optionally specifies the cache duration for the key.
+Returns `null` if the key doesn't exist or the value is expired.
 
 ```php
-protected function loadCacheValue($key, $duration = null)
+protected function loadCacheValue($key, $default = null)
 ```
 
-- `$key` - the name under which the value is stored in the cache.
-- `$duration` - the maximum time in seconds after which the value expires.
-
-Usage example:
+Example:
 
 ```php
-const MY_KEY = 'MyKey';
-
 public function collectData()
 {
-  $value = $this->loadCacheValue(MY_KEY, 1800 /* 30 minutes */);
+    $value = $this->loadCacheValue('my_key');
 
-  if (!isset($value)){
-      // load value
-      $this->saveCacheValue(MY_KEY, $value);
-  }
-
-  // ...
+    if (! $value) {
+        $this->saveCacheValue('my_key', 'foobar');
+    }
 }
 ```
diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index 2467dec6..6444b6aa 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -322,16 +322,14 @@ abstract class BridgeAbstract
         return null;
     }
 
-    protected function loadCacheValue(string $key)
+    protected function loadCacheValue(string $key, $default = null)
     {
-        $cacheKey = $this->getShortName() . '_' . $key;
-        return $this->cache->get($cacheKey);
+        return $this->cache->get($this->getShortName() . '_' . $key, $default);
     }
 
-    protected function saveCacheValue(string $key, $value, $ttl = 86400)
+    protected function saveCacheValue(string $key, $value, int $ttl = null)
     {
-        $cacheKey = $this->getShortName() . '_' . $key;
-        $this->cache->set($cacheKey, $value, $ttl);
+        $this->cache->set($this->getShortName() . '_' . $key, $value, $ttl);
     }
 
     public function getShortName(): string

From adcc8e371d7b369f46945e01ce57b7561f383726 Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Fri, 9 Aug 2024 15:20:10 +0200
Subject: [PATCH 456/716] [TarnkappeBridge] changed "unwanted stuff" (#4206)

* [TarnkappeBridge] changed "unwanted stuff"

em was removed because the annoying affiliate info, but it also deleted the text from blockquotes.

The p-element with the affiliate info has no attributes like class, but it is the only p-element with a style-attribute, so I used this to identify it.

* Update TarnkappeBridge.php

removed whitespace

* Update TarnkappeBridge.php

don't know why I did it twice before
---
 bridges/TarnkappeBridge.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/bridges/TarnkappeBridge.php b/bridges/TarnkappeBridge.php
index c04c9546..374a79b3 100644
--- a/bridges/TarnkappeBridge.php
+++ b/bridges/TarnkappeBridge.php
@@ -65,10 +65,11 @@ class TarnkappeBridge extends FeedExpander
 
         // remove unwanted stuff
         foreach (
-            $article->find('em, section, div.menu') as $element
+            $article->find('section, div.menu, p[style]') as $element
         ) {
             $element->remove();
         }
+
         // reload html, as remove() is buggy
         $article = str_get_html($article->outertext);
 

From 4ef5ca50c6f9080481e34fa305af952187b39d88 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Sat, 10 Aug 2024 11:36:58 -0400
Subject: [PATCH 457/716] [KemonoBridge] Add KemonoBridge (#4192)

* [KemonoBridge] Add KemonoBridge

* refactor

* [KemonoBridge] fix categories in cases where it's a proper json array

---------

Co-authored-by: Dag <me@dvikan.no>
---
 bridges/KemonoBridge.php | 93 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 93 insertions(+)
 create mode 100644 bridges/KemonoBridge.php

diff --git a/bridges/KemonoBridge.php b/bridges/KemonoBridge.php
new file mode 100644
index 00000000..53a820dc
--- /dev/null
+++ b/bridges/KemonoBridge.php
@@ -0,0 +1,93 @@
+<?php
+
+class KemonoBridge extends BridgeAbstract
+{
+    const NAME = 'Kemono';
+    const MAINTAINER = 'phantop';
+    const URI = 'https://kemono.su/';
+    const DESCRIPTION = 'Returns posts from Kemono.';
+    const PARAMETERS = [[
+        'service' => [
+            'name' => 'Content service',
+            'type' => 'list',
+            'defaultValue' => 'patreon',
+            'values' => [
+                'Patreon' => 'patreon',
+                'Pixiv Fanbox' => 'fanbox',
+                'Fantia' => 'fantia',
+                'Boosty' => 'boosty',
+                'Gumroad' => 'gumroad',
+                'SubscribeStar' => 'subscribestar',
+            ]
+        ],
+        'user' => [
+            'name' => 'User ID/Name',
+            'exampleValue' => '9069743', # Thomas Joy
+            'required' => true,
+        ]
+    ]];
+
+    private $title;
+
+    public function collectData()
+    {
+        $api = parent::getURI() . 'api/v1/';
+        $url = $api . $this->getInput('service') . '/user/' . $this->getInput('user');
+        $api_response = getContents($url);
+        $json = Json::decode($api_response);
+
+        $url .= '/profile';
+        $api_response = getContents($url);
+        $profile = Json::decode($api_response);
+        $this->title = ucfirst($profile['name']);
+
+        foreach ($json as $element) {
+            $item = [];
+            $item['author'] = $this->title;
+            $item['content'] = $element['content'];
+            $item['timestamp'] = strtotime($element['published']);
+            $item['title'] = $element['title'];
+            $item['uid'] = $element['id'];
+            $item['uri'] = $this->getURI() . '/post/' . $item['uid'];
+
+            if ($element['tags']) {
+                $tags = $element['tags'];
+                if (is_array($tags)) {
+                    $item['categories'] = $tags;
+                } else {
+                    $tags = preg_replace('/^{"?/', '["', $tags);
+                    $tags = preg_replace('/"?}$/', '"]', $tags);
+                    $item['categories'] = Json::decode($tags);
+                }
+            }
+
+            $item['enclosures'] = [];
+            if (array_key_exists('url', $element['embed'])) {
+                $item['enclosures'][] = $element['embed']['url'];
+            }
+            if (array_key_exists('path', $element['file'])) {
+                $element['attachments'][] = $element['file'];
+            }
+            foreach ($element['attachments'] as $file) {
+                $item['enclosures'][] = parent::getURI() . $file['path'];
+            }
+
+            $this->items[] = $item;
+        }
+    }
+
+    public function getName()
+    {
+        $name = parent::getName();
+        if (isset($this->title)) {
+            $name .= ' - ' . $this->title;
+        }
+        return $name;
+    }
+
+    public function getURI()
+    {
+        $uri = parent::getURI() . $this->getInput('service') . '/user/' . $this->getInput('user');
+        return $uri;
+    }
+}

From 129b8a3a5aee04b15edf5dcdc4c44f2c062fc4a8 Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Sat, 10 Aug 2024 23:10:37 +0200
Subject: [PATCH 458/716] [ModifyBridge] New bridge to modify feeds (#4164)

* [ModifyBridge] New bridge to modify feeds

Create a general bridge that can modify the common fields of feeds
with regular expressions.

* [ModifyBridge] Also modify <enclosure> element

Additionally to the list of <enclosures>.
---
 bridges/ModifyBridge.php | 181 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 181 insertions(+)
 create mode 100644 bridges/ModifyBridge.php

diff --git a/bridges/ModifyBridge.php b/bridges/ModifyBridge.php
new file mode 100644
index 00000000..bf9fa262
--- /dev/null
+++ b/bridges/ModifyBridge.php
@@ -0,0 +1,181 @@
+<?php
+
+class ModifyBridge extends FeedExpander
+{
+    const MAINTAINER = 'Mynacol';
+    const NAME = 'Modify Feed';
+    const CACHE_TIMEOUT = 3600; // 1h
+    const DESCRIPTION = 'Modifies a feed of your choice with regexes';
+    const URI = 'https://github.com/RSS-Bridge/rss-bridge';
+
+    const PARAMETERS = [[
+        'url' => [
+            'name' => 'Feed URL',
+            'type'  => 'text',
+            'exampleValue' => 'https://lorem-rss.herokuapp.com/feed?unit=day',
+            'required' => true,
+        ],
+        'title_pattern' => [
+            'name' => 'Title find pattern (regular expression!)',
+            'type' => 'text',
+            'exampleValue' => 'Unwanted part in title',
+            'required' => false,
+        ],
+        'title_replacement' => [
+            'name' => 'Title replacement for the find pattern',
+            'type' => 'text',
+            'exampleValue' => '${0}',
+            'required' => false,
+        ],
+        'author_pattern' => [
+            'name' => 'Author find pattern (regular expression!)',
+            'type' => 'text',
+            'exampleValue' => '^(author)\s*|\s*publisher$',
+            'required' => false,
+        ],
+        'author_replacement' => [
+            'name' => 'Author replacement for the find pattern',
+            'type' => 'text',
+            'exampleValue' => '${1}',
+            'required' => false,
+        ],
+        'content_pattern' => [
+            'name' => 'Content find pattern (regular expression!)',
+            'type' => 'text',
+            'exampleValue' => '(content)\s+advertisement\s+(content)',
+            'required' => false,
+        ],
+        'content_replacement' => [
+            'name' => 'Content replacement for the find pattern',
+            'type' => 'text',
+            'exampleValue' => '${1} ${2}',
+            'required' => false,
+        ],
+        'uri_pattern' => [
+            'name' => 'URI/URL find pattern (regular expression!)',
+            'type' => 'text',
+            'exampleValue' => '^https?://(.*)/(.*)$',
+            'required' => false,
+        ],
+        'uri_replacement' => [
+            'name' => 'URI/URL replacement for the find pattern',
+            'type' => 'text',
+            'exampleValue' => 'https://${1}/foo/${2}',
+            'required' => false,
+        ],
+        'enclosure_pattern' => [
+            'name' => 'Enclosure URI/URL find pattern (regular expression!)',
+            'type' => 'text',
+            'exampleValue' => '^https?://(.*)/(.*)$',
+            'required' => false,
+        ],
+        'enclosure_replacement' => [
+            'name' => 'Enclosure URI/URL replacement for the find pattern',
+            'type' => 'text',
+            'exampleValue' => 'https://${1}/foo/${2}',
+            'required' => false,
+        ],
+        'case_insensitive' => [
+            'name' => 'Case-insensitive find patterns',
+            'type' => 'checkbox',
+            'required' => false,
+        ],
+    ]];
+
+    public function collectData()
+    {
+        $url = $this->getInput('url');
+        if (!Url::validate($url)) {
+            throw new \Exception('The url parameter must either refer to http or https protocol.');
+        }
+        $this->collectExpandableDatas($this->getURI());
+    }
+
+    protected function parseItem(array $item)
+    {
+        // Title
+        $pattern = $this->buildPattern($this->getInput('title_pattern'));
+        $replacement = $this->getInput('title_replacement');
+        $res = preg_replace($pattern, $replacement, $item['title']);
+        if ($res !== null) {
+            $item['title'] = $res;
+        }
+
+        // Author
+        $pattern = $this->buildPattern($this->getInput('author_pattern'));
+        $replacement = $this->getInput('author_replacement');
+        $res = preg_replace($pattern, $replacement, $item['author']);
+        if ($res !== null) {
+            $item['author'] = $res;
+        }
+
+        // Content
+        $pattern = $this->buildPattern($this->getInput('content_pattern'));
+        $replacement = $this->getInput('content_replacement');
+        $res = preg_replace($pattern, $replacement, $item['content']);
+        if ($res !== null) {
+            $item['content'] = $res;
+        }
+
+        // URI
+        $pattern = $this->buildPattern($this->getInput('uri_pattern'));
+        $replacement = $this->getInput('uri_replacement');
+        $res = preg_replace($pattern, $replacement, $item['uri']);
+        if ($res !== null) {
+            $item['uri'] = $res;
+        }
+
+        // Enclosures
+        if (array_key_exists('enclosures', $item)) {
+            $pattern = $this->buildPattern($this->getInput('enclosure_pattern'));
+            $replacement = $this->getInput('enclosure_replacement');
+            foreach ($item['enclosures'] as $key => $val) {
+                $res = preg_replace($pattern, $replacement, $val);
+                if ($res !== null) {
+                    $item['enclosures'][$key] = $res;
+                }
+            }
+        }
+        if (array_key_exists('enclosure', $item)) {
+            $pattern = $this->buildPattern($this->getInput('enclosure_pattern'));
+            $replacement = $this->getInput('enclosure_replacement');
+            $res = preg_replace($pattern, $replacement, $item['enclosure']['url']);
+            if ($res !== null) {
+                $item['enclosure']['url'] = $res;
+            }
+        }
+
+        return $item;
+    }
+
+    private function buildPattern($pattern)
+    {
+        if (! str_contains($pattern, '#')) {
+            $delimiter = '#';
+        } elseif (! str_contains($pattern, '/')) {
+            $delimiter = '/';
+        } else {
+            throw new \Exception('Cannot use both / and # inside filter');
+        }
+
+        $regex = $delimiter . $pattern . $delimiter;
+        if ($this->getInput('case_insensitive')) {
+            $regex .= 'i';
+        }
+        return $regex;
+    }
+
+    public function getURI()
+    {
+        $url = $this->getInput('url');
+        if ($url) {
+            return $url;
+        }
+        return parent::getURI();
+    }
+
+    public function getName()
+    {
+        return parent::getName();
+    }
+}

From 2e6e2467598c8400cf476cb5914b3a8bd1a3601d Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Sat, 10 Aug 2024 17:11:43 -0400
Subject: [PATCH 459/716] [KemonoBridge] attempt to fix malformed tag responses
 (#4209)

---
 bridges/KemonoBridge.php | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/bridges/KemonoBridge.php b/bridges/KemonoBridge.php
index 53a820dc..e333b574 100644
--- a/bridges/KemonoBridge.php
+++ b/bridges/KemonoBridge.php
@@ -55,9 +55,10 @@ class KemonoBridge extends BridgeAbstract
                 if (is_array($tags)) {
                     $item['categories'] = $tags;
                 } else {
-                    $tags = preg_replace('/^{"?/', '["', $tags);
-                    $tags = preg_replace('/"?}$/', '"]', $tags);
-                    $item['categories'] = Json::decode($tags);
+                    $tags = preg_replace('/^{/', '', $tags);
+                    $tags = preg_replace('/}$/', '', $tags);
+                    $tags = preg_replace('/"/', '', $tags);
+                    $item['categories'] = explode(',', $tags);
                 }
             }
 

From 133dbf87c50c70f8644cfd7916aff3daa8fac520 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 11 Aug 2024 01:23:10 +0200
Subject: [PATCH 460/716] fix(telegram): add note if content is omitted from
 preview page (#4210)

* fix(telegram): add note if content is omitted from preview page

* lint
---
 bridges/TelegramBridge.php | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/bridges/TelegramBridge.php b/bridges/TelegramBridge.php
index a3c910e8..81c5aeb9 100644
--- a/bridges/TelegramBridge.php
+++ b/bridges/TelegramBridge.php
@@ -70,8 +70,14 @@ class TelegramBridge extends BridgeAbstract
     {
         $message = '';
 
+        $notSupported = $messageDiv->find('div.message_media_not_supported_wrap', 0);
+        if ($notSupported) {
+            // For unknown reasons, the telegram preview page omits the content of this post
+            $message = 'RSS-Bridge was unable to find the content of this post.<br><br>' . $notSupported->innertext;
+        }
+
         if ($messageDiv->find('div.tgme_widget_message_forwarded_from', 0)) {
-            $message = $messageDiv->find('div.tgme_widget_message_forwarded_from', 0)->innertext . '<br><br>';
+            $message .= $messageDiv->find('div.tgme_widget_message_forwarded_from', 0)->innertext . '<br><br>';
         }
 
         if ($messageDiv->find('a.tgme_widget_message_reply', 0)) {

From 4424ea54e93da9e9ea125e07037bc3db7e8af590 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 11 Aug 2024 02:31:50 +0200
Subject: [PATCH 461/716] chore: increase linter speed (#4211)

---
 composer.json          | 2 +-
 index.php              | 3 +++
 lib/BridgeAbstract.php | 6 +++---
 3 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/composer.json b/composer.json
index 34f1a80f..cafcd085 100644
--- a/composer.json
+++ b/composer.json
@@ -49,7 +49,7 @@
     },
     "scripts": {
         "test": "./vendor/bin/phpunit",
-        "lint": "./vendor/bin/phpcs --standard=phpcs.xml --warning-severity=0 --extensions=php -p ./",
+        "lint": "./vendor/bin/phpcs --parallel=2 --standard=phpcs.xml --warning-severity=0 --extensions=php -p ./",
         "compat": "./vendor/bin/phpcs --standard=phpcompatibility.xml --warning-severity=0 --extensions=php -p ./"
     }
 }
diff --git a/index.php b/index.php
index d29900f7..1efda44a 100644
--- a/index.php
+++ b/index.php
@@ -62,6 +62,9 @@ register_shutdown_function(function () use ($logger) {
 
 $cacheFactory = new CacheFactory($logger);
 
+// Uncomment this for debug logging
+// $logger->addHandler(new StreamHandler('/tmp/rss-bridge.txt', Logger::DEBUG));
+
 if (Debug::isEnabled()) {
     $logger->addHandler(new ErrorLogHandler(Logger::DEBUG));
     $cache = $cacheFactory->create('array');
diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index 6444b6aa..23e90e13 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -2,8 +2,8 @@
 
 abstract class BridgeAbstract
 {
-    const NAME = 'Unnamed bridge';
-    const URI = '';
+    const NAME = null;
+    const URI = null;
     const DONATION_URI = '';
     const DESCRIPTION = 'No description provided';
 
@@ -61,7 +61,7 @@ abstract class BridgeAbstract
 
     public function getName()
     {
-        return static::NAME;
+        return static::NAME ?? $this->getShortName();
     }
 
     public function getURI()

From 307c22204d643308b8cb22ba024a5b6b95fbcb84 Mon Sep 17 00:00:00 2001
From: Tobias Alexander Franke <thefranke@users.noreply.github.com>
Date: Sun, 11 Aug 2024 23:20:20 +0200
Subject: [PATCH 462/716] [ActivisionResearchBridge] New bridge for the
 Activision Research blog (#4213)

* [ActivisionResearchBridge] New bridge for the Activision Research blog

* [ActivisionResearchBridge] Fix linting issues
---
 bridges/ActivisionResearchBridge.php | 45 ++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 bridges/ActivisionResearchBridge.php

diff --git a/bridges/ActivisionResearchBridge.php b/bridges/ActivisionResearchBridge.php
new file mode 100644
index 00000000..88af4b46
--- /dev/null
+++ b/bridges/ActivisionResearchBridge.php
@@ -0,0 +1,45 @@
+<?php
+
+class ActivisionResearchBridge extends BridgeAbstract
+{
+    const NAME = 'Activision Research Blog';
+    const URI = 'https://research.activision.com';
+    const DESCRIPTION = 'Posts from the Activision Research blog';
+    const MAINTAINER = 'thefranke';
+    const CACHE_TIMEOUT = 86400; // 24h
+
+    public function collectData()
+    {
+        $dom = getSimpleHTMLDOM(static::URI);
+        $dom = $dom->find('div[id="home-blog-feed"]', 0);
+        if (!$dom) {
+            throw new \Exception(sprintf('Unable to find css selector on `%s`', $url));
+        }
+        $dom = defaultLinkTo($dom, $this->getURI());
+        foreach ($dom->find('div[class="blog-entry"]') as $article) {
+            $a = $article->find('a', 0);
+
+            $blogimg = extractFromDelimiters($article->find('div[class="blog-img"]', 0)->style, 'url(', ')');
+
+            $title = htmlspecialchars_decode($article->find('div[class="title"]', 0)->plaintext);
+            $author = htmlspecialchars_decode($article->find('div[class="author]', 0)->plaintext);
+            $date = $article->find('div[class="pubdate"]', 0)->plaintext;
+
+            $entry = getSimpleHTMLDOMCached($a->href, static::CACHE_TIMEOUT * 7 * 4);
+            $entry = defaultLinkTo($entry, $this->getURI());
+
+            $content = $entry->find('div[class="blog-body"]', 0);
+            $tagsremove = ['script', 'iframe', 'input', 'form'];
+            $content = sanitize($content, $tagsremove);
+            $content = '<img src="' . static::URI . $blogimg . '" alt="">' . $content;
+
+            $this->items[] = [
+                'title' => $title,
+                'author' => $author,
+                'uri' => $a->href,
+                'content' => $content,
+                'timestamp' => strtotime($date),
+            ];
+        }
+    }
+}

From e9d3a657bab09c6fbe8e7d4002cdcb5215054bf4 Mon Sep 17 00:00:00 2001
From: Tobias Alexander Franke <thefranke@users.noreply.github.com>
Date: Thu, 15 Aug 2024 00:47:39 +0200
Subject: [PATCH 463/716] [EASeedBridge] New bridge for the EA Seed blog
 (#4216)

* [EASeedBridge] New bridge for the EA Seed blog

* Fix linter issues
---
 bridges/EASeedBridge.php | 42 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 bridges/EASeedBridge.php

diff --git a/bridges/EASeedBridge.php b/bridges/EASeedBridge.php
new file mode 100644
index 00000000..bb5fa41d
--- /dev/null
+++ b/bridges/EASeedBridge.php
@@ -0,0 +1,42 @@
+<?php
+
+class EASeedBridge extends BridgeAbstract
+{
+    const NAME = 'EA Seed Blog';
+    const URI = 'https://www.ea.com/seed';
+    const DESCRIPTION = 'Posts from the EA Seed blog';
+    const MAINTAINER = 'thefranke';
+    const CACHE_TIMEOUT = 86400; // 24h
+
+    public function collectData()
+    {
+        $dom = getSimpleHTMLDOM(static::URI);
+        $dom = $dom->find('ea-grid', 0);
+        if (!$dom) {
+            throw new \Exception(sprintf('Unable to find css selector on `%s`', $url));
+        }
+        $dom = defaultLinkTo($dom, $this->getURI());
+        foreach ($dom->find('ea-tile') as $article) {
+            $a = $article->find('a', 0);
+            $date = $article->find('div', 1)->plaintext;
+            $title = $article->find('h3', 0)->plaintext;
+            $author = $article->find('div', 0)->plaintext;
+
+            $entry = getSimpleHTMLDOMCached($a->href, static::CACHE_TIMEOUT * 7 * 4);
+
+            $content = $entry->find('main', 0);
+
+            // remove header and links to other posts
+            $content->find('ea-header', 0)->outertext = '';
+            $content->find('ea-section', -1)->outertext = '';
+
+            $this->items[] = [
+                'title' => $title,
+                'author' => $author,
+                'uri' => $a->href,
+                'content' => $content,
+                'timestamp' => strtotime($date),
+            ];
+        }
+    }
+}

From c0e37bcf35d4eb040138423de82ce934d53ff093 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 18 Aug 2024 19:11:11 +0200
Subject: [PATCH 464/716] refactor: frontpage and proxy setting (#4214)

---
 actions/DisplayAction.php   |  1 +
 actions/FrontpageAction.php | 22 +++++++++++++---------
 config.default.ini.php      |  4 ++--
 lib/BridgeCard.php          | 15 +++++++++------
 lib/http.php                |  1 +
 5 files changed, 26 insertions(+), 17 deletions(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index a5703e5e..d111e69e 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -51,6 +51,7 @@ class DisplayAction implements ActionInterface
             return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'This bridge is not whitelisted']), 400);
         }
 
+        // Disable proxy (if enabled and per user's request)
         if (
             Configuration::getConfig('proxy', 'url')
             && Configuration::getConfig('proxy', 'by_bridge')
diff --git a/actions/FrontpageAction.php b/actions/FrontpageAction.php
index c72dfd57..6ab18d29 100644
--- a/actions/FrontpageAction.php
+++ b/actions/FrontpageAction.php
@@ -4,6 +4,8 @@ final class FrontpageAction implements ActionInterface
 {
     public function __invoke(Request $request): Response
     {
+        $token = $request->attribute('token');
+
         $messages = [];
         $activeBridges = 0;
 
@@ -20,19 +22,21 @@ final class FrontpageAction implements ActionInterface
         $body = '';
         foreach ($bridgeClassNames as $bridgeClassName) {
             if ($bridgeFactory->isEnabled($bridgeClassName)) {
-                $body .= BridgeCard::render($bridgeClassName, $request);
+                $body .= BridgeCard::render($bridgeClassName, $token);
                 $activeBridges++;
             }
         }
 
-        // todo: cache this renderered template?
-        return new Response(render(__DIR__ . '/../templates/frontpage.html.php', [
-            'messages' => $messages,
-            'admin_email' => Configuration::getConfig('admin', 'email'),
-            'admin_telegram' => Configuration::getConfig('admin', 'telegram'),
-            'bridges' => $body,
-            'active_bridges' => $activeBridges,
-            'total_bridges' => count($bridgeClassNames),
+        $response = new Response(render(__DIR__ . '/../templates/frontpage.html.php', [
+            'messages'          => $messages,
+            'admin_email'       => Configuration::getConfig('admin', 'email'),
+            'admin_telegram'    => Configuration::getConfig('admin', 'telegram'),
+            'bridges'           => $body,
+            'active_bridges'    => $activeBridges,
+            'total_bridges'     => count($bridgeClassNames),
         ]));
+
+        // TODO: The rendered template could be cached, but beware config changes that changes the html
+        return $response;
     }
 }
diff --git a/config.default.ini.php b/config.default.ini.php
index c6b0779d..c23372d9 100644
--- a/config.default.ini.php
+++ b/config.default.ini.php
@@ -86,8 +86,8 @@ telegram = ""
 donations = true
 
 [proxy]
-
-; Sets the proxy url (i.e. "tcp://192.168.0.0:32")
+; The HTTP proxy to tunnel requests through
+; https://curl.se/libcurl/c/CURLOPT_PROXY.html
 ; ""    = Proxy disabled (default)
 url = ""
 
diff --git a/lib/BridgeCard.php b/lib/BridgeCard.php
index 27285558..f270c1a3 100644
--- a/lib/BridgeCard.php
+++ b/lib/BridgeCard.php
@@ -2,7 +2,7 @@
 
 final class BridgeCard
 {
-    public static function render(string $bridgeClassName, Request $request): string
+    public static function render(string $bridgeClassName, ?string $token): string
     {
         $bridgeFactory = new BridgeFactory();
 
@@ -14,10 +14,15 @@ final class BridgeCard
         $description = $bridge->getDescription();
         $contexts = $bridge->getParameters();
 
-        if (Configuration::getConfig('proxy', 'url') && Configuration::getConfig('proxy', 'by_bridge')) {
+        // Checkbox for disabling of proxy (if enabled)
+        if (
+            Configuration::getConfig('proxy', 'url')
+            && Configuration::getConfig('proxy', 'by_bridge')
+        ) {
+            $proxyName = Configuration::getConfig('proxy', 'name') ?: Configuration::getConfig('proxy', 'url');
             $contexts['global']['_noproxy'] = [
-                'name' => 'Disable proxy (' . (Configuration::getConfig('proxy', 'name') ?: Configuration::getConfig('proxy', 'url')) . ')',
-                'type' => 'checkbox'
+                'name' => sprintf('Disable proxy (%s)', $proxyName),
+                'type' => 'checkbox',
             ];
         }
 
@@ -47,8 +52,6 @@ final class BridgeCard
 
         CARD;
 
-        $token = $request->attribute('token');
-
         if (count($contexts) === 0) {
             // The bridge has zero parameters
             $card .= self::renderForm($bridgeClassName, '', [], $token);
diff --git a/lib/http.php b/lib/http.php
index 0d21b958..d1043b33 100644
--- a/lib/http.php
+++ b/lib/http.php
@@ -113,6 +113,7 @@ final class CurlHttpClient implements HttpClient
         if ($config['proxy']) {
             curl_setopt($ch, CURLOPT_PROXY, $config['proxy']);
         }
+
         if (curl_setopt_array($ch, $config['curl_options']) === false) {
             throw new \Exception('Tried to set an illegal curl option');
         }

From 320afc3f324ded84f56169dce70bc7721201ea0a Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Mon, 19 Aug 2024 22:47:42 +0530
Subject: [PATCH 465/716] [MaalaimalarBridge] fix image (#4222)

* [NvidiaDriverBridge] Added Windows support

* Update NvidiaDriverBridge.php

* Update NvidiaDriverBridge.php

* [MaalaimalarBridge] fix image

* [MaalaimalarBridge] fix lint
---
 bridges/MaalaimalarBridge.php  |  8 +++-
 bridges/NvidiaDriverBridge.php | 86 ++++++++++++++++++++++++++++------
 2 files changed, 78 insertions(+), 16 deletions(-)

diff --git a/bridges/MaalaimalarBridge.php b/bridges/MaalaimalarBridge.php
index 87f85694..59c76b01 100644
--- a/bridges/MaalaimalarBridge.php
+++ b/bridges/MaalaimalarBridge.php
@@ -103,8 +103,12 @@ class MaalaimalarBridge extends BridgeAbstract
     {
         $content = '';
         $imageElement = $article->find('div.ignore-autoplay img', 0);
-        if ($imageElement) {
-            $content .= '<p><img src="' . $imageElement->{'data-src'} . '"></p>';
+        if ($imageElement && isset($imageElement->{'data-src'})) {
+            $url = str_replace('500x300_', '', $imageElement->{'data-src'});
+
+            if (filter_var($url, FILTER_VALIDATE_URL)) {
+                $content = sprintf('<p><img src="%s"></p>', htmlspecialchars($url, ENT_QUOTES, 'UTF-8'));
+            }
         }
 
         $storyElement = $article->find('div.story-content', 0);
diff --git a/bridges/NvidiaDriverBridge.php b/bridges/NvidiaDriverBridge.php
index 595411bc..6664fc77 100644
--- a/bridges/NvidiaDriverBridge.php
+++ b/bridges/NvidiaDriverBridge.php
@@ -2,36 +2,83 @@
 
 class NvidiaDriverBridge extends FeedExpander
 {
-    const NAME = 'NVIDIA Linux Driver Releases';
+    const NAME = 'NVIDIA Driver Releases';
     const URI = 'https://www.nvidia.com/Download/processFind.aspx';
-    const DESCRIPTION = 'Fetch the latest NVIDIA Linux driver updates';
+    const DESCRIPTION = 'Fetch the latest NVIDIA driver updates';
     const MAINTAINER = 'tillcash';
+
     const PARAMETERS = [
-        [
-            'whql' => [
-                'name' => 'Version',
+        'Windows' => [
+            'wwhql' => [
+                'name' => 'Driver Type',
                 'type' => 'list',
                 'values' => [
-                        'All' => '',
-                        'Beta' => '0',
-                        'New Feature Branch' => '5',
-                        'Recommended/Certified' => '1',
+                    'All' => '',
+                    'Certified' => '1',
+                    'Studio' => '4',
                 ],
+                'defaultValue' => '1',
+            ],
+        ],
+        'Linux' => [
+            'lwhql' => [
+                'name' => 'Driver Type',
+                'type' => 'list',
+                'values' => [
+                    'All' => '',
+                    'Beta' => '0',
+                    'Branch' => '5',
+                    'Certified' => '1',
+                ],
+                'defaultValue' => '1',
+            ],
+        ],
+        'FreeBSD' => [
+            'fwhql' => [
+                'name' => 'Driver Type',
+                'type' => 'list',
+                'values' => [
+                    'All' => '',
+                    'Beta' => '0',
+                    'Branch' => '5',
+                    'Certified' => '1',
+                ],
+                'defaultValue' => '1',
             ],
         ],
     ];
 
+    private $operatingSystem = '';
+
     public function collectData()
     {
-        $whql = $this->getInput('whql');
-
         $parameters = [
             'lid'   => 1, // en-us
             'psid'  => 129, // GeForce
-            'osid'  => 12, // Linux 64-bit
-            'whql'  => $whql,
         ];
 
+        switch ($this->queriedContext) {
+            case 'Windows':
+                $whql = $this->getInput('wwhql');
+                $parameters['osid'] = 57;
+                $parameters['dtcid'] = 1; // Windows Driver DCH
+                $parameters['whql'] = $whql;
+                $this->operatingSystem = 'Windows';
+                break;
+            case 'Linux':
+                $whql = $this->getInput('lwwhql');
+                $parameters['osid'] = 12;
+                $parameters['whql'] = $whql;
+                $this->operatingSystem = 'Linux';
+                break;
+            case 'FreeBSD':
+                $whql = $this->getInput('fwwhql');
+                $parameters['osid'] = 22;
+                $parameters['whql'] = $whql;
+                $this->operatingSystem = 'FreeBSD';
+                break;
+        }
+
         $url = 'https://www.nvidia.com/Download/processFind.aspx?' . http_build_query($parameters);
         $dom = getSimpleHTMLDOM($url);
 
@@ -40,10 +87,21 @@ class NvidiaDriverBridge extends FeedExpander
 
             $this->items[] = [
                 'timestamp' => $element->find('td.gridItem', 3)->plaintext,
-                'title'     => sprintf('NVIDIA Linux Driver %s', $element->find('td.gridItem', 2)->plaintext),
+                'title'     => sprintf('NVIDIA Driver %s', $element->find('td.gridItem', 2)->plaintext),
                 'uri'       => 'https://www.nvidia.com/Download/driverResults.aspx/' . $id,
                 'content'   => $dom->find('tr#tr_' . $id . ' span', 0)->innertext,
             ];
         }
     }
+
+    public function getIcon()
+    {
+        return 'https://www.nvidia.com/favicon.ico';
+    }
+
+    public function getName()
+    {
+        $version = $this->getKey('whql') ?? '';
+        return sprintf('NVIDIA %s %s Driver Releases', $this->operatingSystem, $version);
+    }
 }

From 2d5d2f5017e9ba75f562683ee84cff392b700d43 Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Tue, 20 Aug 2024 21:02:15 +0530
Subject: [PATCH 466/716] [NvidiaDriverBridge] fix typo (#4224)

---
 bridges/NvidiaDriverBridge.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/NvidiaDriverBridge.php b/bridges/NvidiaDriverBridge.php
index 6664fc77..3c478697 100644
--- a/bridges/NvidiaDriverBridge.php
+++ b/bridges/NvidiaDriverBridge.php
@@ -66,13 +66,13 @@ class NvidiaDriverBridge extends FeedExpander
                 $this->operatingSystem = 'Windows';
                 break;
             case 'Linux':
-                $whql = $this->getInput('lwwhql');
+                $whql = $this->getInput('lwhql');
                 $parameters['osid'] = 12;
                 $parameters['whql'] = $whql;
                 $this->operatingSystem = 'Linux';
                 break;
             case 'FreeBSD':
-                $whql = $this->getInput('fwwhql');
+                $whql = $this->getInput('fwhql');
                 $parameters['osid'] = 22;
                 $parameters['whql'] = $whql;
                 $this->operatingSystem = 'FreeBSD';

From 3a327503ee26bc8efeb1b3dd43ac4e1d58334229 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Wed, 21 Aug 2024 16:10:03 -0400
Subject: [PATCH 467/716] [NPRBridge] add bridge for NPR stories (#4225)

* [NPRBridge] add bridge for NPR stories

* [NPRBridge] Use better selectors for multiple items
---
 bridges/NPRBridge.php | 214 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 214 insertions(+)
 create mode 100644 bridges/NPRBridge.php

diff --git a/bridges/NPRBridge.php b/bridges/NPRBridge.php
new file mode 100644
index 00000000..aca9f653
--- /dev/null
+++ b/bridges/NPRBridge.php
@@ -0,0 +1,214 @@
+<?php
+
+class NPRBridge extends FeedExpander
+{
+    const MAINTAINER = 'phantop';
+    const NAME = 'NPR';
+    const URI = 'https://www.npr.org/';
+    const DESCRIPTION = 'Returns the latest articles from NPR';
+    const PARAMETERS = [[
+        'section' => [
+            'name' => 'Site section',
+            'type' => 'list',
+            'defaultValue' => '1002',
+            // Obtained from https://legacy.npr.org/list?date=2024-05-05&id=
+            // With ids: 3002 (Topics), 3004 (Programs), 3006 (Series)
+            // Feeds cleaned up to exclude all that hadn't updated this year
+            'values' => [
+                'All Things Considered' => '2',
+                'Morning Edition' => '3',
+                'Weekend Edition Saturday' => '7',
+                'Weekend Edition Sunday' => '10',
+                'Fresh Air' => '13',
+                'Wait Wait...Don\'t Tell Me!' => '35',
+                'TED Radio Hour' => '57',
+                'News' => '1001',
+                'Home Page Top Stories' => '1002',
+                'National' => '1003',
+                'World' => '1004',
+                'Business' => '1006',
+                'Science' => '1007',
+                'Culture' => '1008',
+                'Middle East' => '1009',
+                'Education' => '1013',
+                'Politics' => '1014',
+                'Race' => '1015',
+                'Religion' => '1016',
+                'Economy' => '1017',
+                'Your Money' => '1018',
+                'Technology' => '1019',
+                'Media' => '1020',
+                'Research News' => '1024',
+                'Environment' => '1025',
+                'Space' => '1026',
+                'Health Care' => '1027',
+                'On Aging' => '1028',
+                'Mental Health' => '1029',
+                'Children\'s Health' => '1030',
+                'Global Health' => '1031',
+                'Books' => '1032',
+                'Author Interviews' => '1033',
+                'Book Reviews' => '1034',
+                'Music' => '1039',
+                'Movies' => '1045',
+                'Performing Arts' => '1046',
+                'Art & Design' => '1047',
+                'Pop Culture' => '1048',
+                'Humor & Fun' => '1052',
+                'Food' => '1053',
+                'Sports' => '1055',
+                'Opinion' => '1057',
+                'Analysis' => '1059',
+                'Obituaries' => '1062',
+                'Your Health' => '1066',
+                'Law' => '1070',
+                'Studio Sessions' => '1103',
+                'Music Reviews' => '1104',
+                'Music Interviews' => '1105',
+                'Music News' => '1106',
+                'Music Lists' => '1107',
+                'New Music' => '1108',
+                'Concerts' => '1109',
+                'Music Videos' => '1110',
+                'National Security' => '1122',
+                'Europe' => '1124',
+                'Asia' => '1125',
+                'Africa' => '1126',
+                'The Americas' => '1127',
+                'Health' => '1128',
+                'Energy' => '1131',
+                'Animals' => '1132',
+                'On Disabilities' => '1133',
+                'Fitness & Nutrition' => '1134',
+                'Medical Treatments' => '1135',
+                'History' => '1136',
+                'Movie Interviews' => '1137',
+                'Television' => '1138',
+                'Recipes' => '1139',
+                'Fine Art' => '1141',
+                'Architecture' => '1142',
+                'Photography' => '1143',
+                'Theater' => '1144',
+                'Dance' => '1145',
+                'Strange News' => '1146',
+                'Investigations' => '1150',
+                'Music Quizzes' => '1151',
+                'Book News & Features' => '1161',
+                'TV Reviews' => '1163',
+                'Family' => '1164',
+                'Weather' => '1165',
+                'Perspective' => '1166',
+                'Climate' => '1167',
+                'Press Releases and Statements' => '750003',
+                'Movie Reviews' => '4467349',
+                'Sunday Puzzle' => '4473090',
+                'Simon Says' => '4495795',
+                'StoryCorps' => '4516989',
+                '\'Not My Job\'' => '5163715',
+                'Tiny Desk' => '92071316',
+                'Jazz' => '92756586',
+                'Pop Culture Happy Hour' => '93568166',
+                'Planet Money' => '94427042',
+                'The Thistle & Shamrock' => '103063413',
+                'Fresh Air Weekend' => '139029251',
+                'Elections' => '139482413',
+                'Presidential Race' => '139544303',
+                'World Cafe: Sense Of Place' => '142680413',
+                'Jazz Night In America' => '347139849',
+                'Jazz Night In America: The Radio Program' => '347174538',
+                'Planet Money Buys Gold' => '377029766',
+                'Music Features' => '613820055',
+                'Bill Of The Month' => '651784144',
+                'Student Podcast Challenge' => '662609200',
+                'Life Kit' => '676529561',
+                'Picture This' => '787467815',
+                'Gaming' => '820266919',
+                'Games' => '820593993',
+                'Health Reporting in the States' => '914131100',
+                'Untangling Disinformation' => '973275370',
+                'Pride Month' => '1002248299',
+                'Planet Money Summer School' => '1015448333',
+                'What\'s Making Us Happy' => '1019281468',
+                'Native American Heritage Month' => '1047406725',
+                'Podcast Recommendations' => '1068304478',
+                'Tiny Desk Contest' => '1072544367',
+                'Ukraine invasion — explained' => '1082539802',
+                'Reproductive rights in America' => '1096684820',
+                'My Unsung Hero' => '1134955065',
+                'The NPR news quiz' => '1146192567',
+                'Video Game Reviews' => '1175242824',
+                'Gaming Culture' => '1175243560',
+                'Up First Newsletter' => '1180232252',
+                'Up First' => '1182407811',
+                'Body Electric' => '1199526213',
+                'Interview highlights' => '1200383155',
+                'Middle East Crisis — explained' => '1205445976',
+                'The Sunday Story from Up First' => '1213771050',
+                'Life Kit\'s guide to emergency preparedness' => '1217925264',
+                'Code Switch: Perspectives' => '1223739304',
+                'How to Thrive as You Age' => '1225474023',
+                'Time Machine: The Throughline History Quiz' => '1233646427',
+                'We, The Voters' => '1241382501',
+                'The Science of Siblings' => '1241438370',
+                'Throughline: Constitutional Amendments' => '1242285011',
+                'NPR Investigations: Off The Mark' => '1245316423',
+                'Campus protests over the Gaza war' => '1248184956',
+                'UAW Goes South' => '1250012704',
+                'Books We Love' => '1251857292',
+                'NPR\'s Embedded: Supermajority ' => '1254807812',
+                'Throughline: The Middle East Conflict' => '1255058395',
+            ]
+        ]
+    ]];
+
+    public function getIcon()
+    {
+        return 'https://media.npr.org/chrome/favicon/favicon.ico';
+    }
+
+    public function collectData()
+    {
+        $url = 'https://feeds.npr.org/' . $this->getInput('section') . '/rss.xml';
+        $this->collectExpandableDatas($url, 10);
+    }
+
+    protected function parseItem(array $item)
+    {
+        $html = getSimpleHTMLDOMCached($item['uri']);
+        $html = defaultLinkTo($html, self::URI);
+        $text = $html->find('#storytext', 0);
+
+        // a bit of a cheat to offer the text-only alternative url
+        $item['comments'] = preg_replace('/www/', 'text', $item['uri']);
+
+        // clean up related articles, duplicate image credit and enlarged versions
+        $ads = 'aside.ad-wrap, span.credit, .bucket.img';
+        $enlarge = '.enlarge-options, .enlarge_measure, .enlarge_html';
+        foreach ($text->find("$ads, $enlarge") as $ad) {
+            $ad->remove();
+        }
+
+        $item['content'] = preg_replace('/(hide|toggle) caption/', '', $text);
+
+        // get tags, program/series names
+        $item['categories'] = [];
+        $tags = '.tag, .program-block > a, .branding__title';
+        foreach ($html->find($tags) as $tag) {
+            $item['categories'][] = $tag->innertext;
+        }
+        $item['categories'] = array_unique($item['categories']);
+
+        // fetch audios and transcripts
+        $item['enclosures'] = [];
+        foreach ($html->find('.audio-tool > a') as $audio) {
+            $item['enclosures'][] = $audio->href;
+        }
+        foreach ($html->find('[data-audio]') as $audio) {
+            $json_text = $audio->getAttribute('data-audio');
+            $json = Json::decode(html_entity_decode($json_text), true);
+            $item['enclosures'][] = base64_decode($json['audioUrl']);
+        }
+
+        return $item;
+    }
+}

From d379f3e575e9b84f3e65e7571532f11a6d298279 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Wed, 21 Aug 2024 16:57:02 -0400
Subject: [PATCH 468/716] [CubariProxyBridge] add bridge for cubari manga
 proxies (#4220)

* [CubariProxyBridge] add bridge for cubari manga proxies

* [CubariProxyBridge] add limit and use isset
---
 bridges/CubariProxyBridge.php | 124 ++++++++++++++++++++++++++++++++++
 1 file changed, 124 insertions(+)
 create mode 100644 bridges/CubariProxyBridge.php

diff --git a/bridges/CubariProxyBridge.php b/bridges/CubariProxyBridge.php
new file mode 100644
index 00000000..492d5fbb
--- /dev/null
+++ b/bridges/CubariProxyBridge.php
@@ -0,0 +1,124 @@
+<?php
+
+class CubariProxyBridge extends BridgeAbstract
+{
+    const NAME = 'Cubari Proxy';
+    const MAINTAINER = 'phantop';
+    const URI = 'https://cubari.moe';
+    const DESCRIPTION = 'Returns chapters from Cubari.';
+    const PARAMETERS = [[
+        'service' => [
+            'name' => 'Content service',
+            'type' => 'list',
+            'defaultValue' => 'mangadex',
+            'values' => [
+                'MangAventure' => 'mangadventure',
+                'MangaDex' => 'mangadex',
+                'MangaKatana' => 'mangakatana',
+                'MangaSee' => 'mangasee',
+            ]
+        ],
+        'series' => [
+            'name' => 'Series ID/Name',
+            'exampleValue' => '8c1d7d0c-e0b7-4170-941d-29f652c3c19d', # KnH
+            'required' => true,
+        ],
+        'fetch' => [
+            'name' => 'Fetch chapter page images',
+            'type' => 'list',
+            'title' => 'Places chapter images in feed contents. Entries will consume more bandwidth.',
+            'defaultValue' => 'c',
+            'values' => [
+                'None' => 'n',
+                'Content' => 'c',
+                'Enclosure' => 'e'
+            ]
+        ],
+        'limit' => self::LIMIT
+    ]];
+
+    private $title;
+
+    public function collectData()
+    {
+        $limit = $this->getInput('limit') ?? 10;
+
+        $url = parent::getURI() . '/read/api/' . $this->getInput('service') . '/series/' . $this->getInput('series');
+        $json = Json::decode(getContents($url));
+        $this->title = $json['title'];
+
+        $chapters = $json['chapters'];
+        krsort($chapters);
+
+        $count = 0;
+        foreach ($chapters as $number => $element) {
+            $item = [];
+            $item['uri'] = $this->getURI() . '/' . $number;
+
+            if ($element['title']) {
+                $item['title'] = $number . ' - ' . $element['title'];
+            } else {
+                $item['title'] = 'Volume ' . $element['volume'] . ' Chapter ' . $number;
+            }
+
+            $group = '1';
+            if (isset($element['release_date'])) {
+                $dates = $element['release_date'];
+                $date = max($dates);
+                $item['timestamp'] = $date;
+                $group = array_keys($dates, $date)[0];
+            }
+            $page = $element['groups'][$group];
+            $item['author'] = $json['groups'][$group];
+            $api = parent::getURI() . $page;
+            $item['uid'] = $page;
+            $item['comments'] = $api;
+
+            if ($this->getInput('fetch') != 'n') {
+                $pages = [];
+                try {
+                    $jsonp = getContents($api);
+                    $pages = Json::decode($jsonp);
+                } catch (HttpException $e) {
+                    // allow error 500, as it's effectively a 429
+                    if ($e->getCode() != 500) {
+                        throw $e;
+                    }
+                }
+                if ($this->getInput('fetch') == 'e') {
+                    $item['enclosures'] = $pages;
+                }
+                if ($this->getInput('fetch') == 'c') {
+                    $item['content'] = '';
+                    foreach ($pages as $img) {
+                        $item['content'] .= '<img src="' . $img . '"/>';
+                    }
+                }
+            }
+
+            if ($count++ == $limit) {
+                break;
+            }
+
+            $this->items[] = $item;
+        }
+    }
+
+    public function getName()
+    {
+        $name = parent::getName();
+        if (isset($this->title)) {
+            $name .= ' - ' . $this->title;
+        }
+        return $name;
+    }
+
+    public function getURI()
+    {
+        $uri = parent::getURI();
+        if ($this->getInput('service')) {
+            $uri .= '/read/' . $this->getInput('service') . '/' . $this->getInput('series');
+        }
+        return $uri;
+    }
+}

From 06a88960002cd8b8dba10b06bf0af1e71cecf512 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Wed, 21 Aug 2024 16:58:26 -0400
Subject: [PATCH 469/716] [PriviblurBridge] Add Priviblur (Tumblr frontend)
 bridge (#4221)

* [PriviblurBridge] Add Priviblur (Tumblr frontend) bridge

* [PriviblurBridge] prevent error if post has no tags
---
 bridges/PriviblurBridge.php | 69 +++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 bridges/PriviblurBridge.php

diff --git a/bridges/PriviblurBridge.php b/bridges/PriviblurBridge.php
new file mode 100644
index 00000000..198c38bc
--- /dev/null
+++ b/bridges/PriviblurBridge.php
@@ -0,0 +1,69 @@
+<?php
+
+class PriviblurBridge extends BridgeAbstract
+{
+    const NAME = 'Priviblur';
+    const MAINTAINER = 'phantop';
+    const URI = 'https://github.com/syeopite/priviblur';
+    const DESCRIPTION = 'Returns Tumblr posts from a Priviblur link';
+    const PARAMETERS = [
+        [
+            'url' => [
+                'name' => 'URL',
+                'exampleValue' => 'https://priviblur.fly.dev',
+                'required' => true,
+            ]
+        ]
+    ];
+
+    private $title;
+
+    public function collectData()
+    {
+        $url = $this->getURI();
+        $html = getSimpleHTMLDOM($url);
+        $html = defaultLinkTo($html, $url);
+        $this->title = $html->find('head title', 0)->innertext;
+
+        $elements = $html->find('.post');
+        foreach ($elements as $element) {
+            $item = [];
+            $item['author'] = $element->find('.primary-post-author .blog-name', 0)->innertext;
+            $item['comments'] = $element->find('.interaction-buttons > a', 1)->href;
+            $item['content'] = $element->find('.post-body', 0);
+            $item['timestamp'] = $element->find('.primary-post-author time', 0)->innertext;
+            $item['title'] = $item['author'] . ': ' . $item['timestamp'];
+            $item['uid'] = $item['comments']; // tumblr url is canonical
+            $item['uri'] = $element->find('.interaction-buttons > a', 0)->href;
+
+            if ($element->find('.post-tags', 0)) {
+                $tags = html_entity_decode($element->find('.post-tags', 0)->plaintext);
+                $tags = explode('#', $tags);
+                $tags = array_map('trim', $tags);
+                array_shift($tags);
+                $item['categories'] = $tags;
+            }
+
+            $heading = $element->find('h1', 0);
+            if ($heading) {
+                $item['title'] = $heading->innertext;
+            }
+
+            $this->items[] = $item;
+        }
+    }
+
+    public function getName()
+    {
+        $name = parent::getName();
+        if (isset($this->title)) {
+            $name = $this->title;
+        }
+        return $name;
+    }
+
+    public function getURI()
+    {
+        return $this->getInput('url') ? $this->getInput('url') : parent::getURI();
+    }
+}

From 4a3919c1a35083ade3dca0a49dd9c78cd8fc4f28 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Wed, 21 Aug 2024 17:05:29 -0400
Subject: [PATCH 470/716] [NPRBridge] Add missing tag and remove extra HTML
 elements (#4227)

---
 bridges/NPRBridge.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/NPRBridge.php b/bridges/NPRBridge.php
index aca9f653..644ede68 100644
--- a/bridges/NPRBridge.php
+++ b/bridges/NPRBridge.php
@@ -192,9 +192,9 @@ class NPRBridge extends FeedExpander
 
         // get tags, program/series names
         $item['categories'] = [];
-        $tags = '.tag, .program-block > a, .branding__title';
+        $tags = '.tag, .program-block > a, .branding__title, article h3.slug';
         foreach ($html->find($tags) as $tag) {
-            $item['categories'][] = $tag->innertext;
+            $item['categories'][] = $tag->plaintext;
         }
         $item['categories'] = array_unique($item['categories']);
 

From 05e2c350b7de8480a1a36a7b4ec284c7479adfb5 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 22 Aug 2024 00:33:35 +0200
Subject: [PATCH 471/716] refactor: less reliance on super globals (#4228)

---
 actions/DisplayAction.php      | 12 +++++++-----
 formats/HtmlFormat.php         |  4 ++++
 index.php                      | 10 +++++++++-
 lib/RssBridge.php              |  9 +--------
 templates/base.html.php        |  2 +-
 templates/html-format.html.php |  2 +-
 6 files changed, 23 insertions(+), 16 deletions(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index d111e69e..26f1cb40 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -21,12 +21,13 @@ class DisplayAction implements ActionInterface
         /** @var Response $cachedResponse */
         $cachedResponse = $this->cache->get($cacheKey);
         if ($cachedResponse) {
-            $ifModifiedSince = $_SERVER['HTTP_IF_MODIFIED_SINCE'] ?? null;
+            $ifModifiedSince = $request->server('HTTP_IF_MODIFIED_SINCE');
             $lastModified = $cachedResponse->getHeader('last-modified');
             if ($ifModifiedSince && $lastModified) {
                 $lastModified = new \DateTimeImmutable($lastModified);
                 $lastModifiedTimestamp = $lastModified->getTimestamp();
                 $modifiedSince = strtotime($ifModifiedSince);
+                // TODO: \DateTimeImmutable can be compared directly
                 if ($lastModifiedTimestamp <= $modifiedSince) {
                     $modificationTimeGMT = gmdate('D, d M Y H:i:s ', $lastModifiedTimestamp);
                     return new Response('', 304, ['last-modified' => $modificationTimeGMT . 'GMT']);
@@ -182,7 +183,7 @@ class DisplayAction implements ActionInterface
         $content = render_template(__DIR__ . '/../templates/bridge-error.html.php', [
             'error' => render_template(__DIR__ . '/../templates/exception.html.php', ['e' => $e]),
             'searchUrl' => self::createGithubSearchUrl($bridge),
-            'issueUrl' => self::createGithubIssueUrl($bridge, $e, create_sane_exception_message($e)),
+            'issueUrl' => self::createGithubIssueUrl($bridge, $e),
             'maintainer' => $bridge->getMaintainer(),
         ]);
         $item['content'] = $content;
@@ -211,7 +212,7 @@ class DisplayAction implements ActionInterface
         return $report['count'];
     }
 
-    private static function createGithubIssueUrl(BridgeAbstract $bridge, \Throwable $e, string $message): string
+    private static function createGithubIssueUrl(BridgeAbstract $bridge, \Throwable $e): string
     {
         $maintainer = $bridge->getMaintainer();
         if (str_contains($maintainer, ',')) {
@@ -221,13 +222,14 @@ class DisplayAction implements ActionInterface
         }
         $maintainers = array_map('trim', $maintainers);
 
+        $queryString = $_SERVER['QUERY_STRING'] ?? '';
         $query = [
             'title' => $bridge->getName() . ' failed with: ' . $e->getMessage(),
             'body' => sprintf(
                 "```\n%s\n\n%s\n\nQuery string: %s\nVersion: %s\nOs: %s\nPHP version: %s\n```\nMaintainer: @%s",
-                $message,
+                create_sane_exception_message($e),
                 implode("\n", trace_to_call_points(trace_from_exception($e))),
-                $_SERVER['QUERY_STRING'] ?? '',
+                $queryString,
                 Configuration::getVersion(),
                 PHP_OS_FAMILY,
                 phpversion() ?: 'Unknown',
diff --git a/formats/HtmlFormat.php b/formats/HtmlFormat.php
index 37ef3a93..a5bcc451 100644
--- a/formats/HtmlFormat.php
+++ b/formats/HtmlFormat.php
@@ -9,6 +9,9 @@ class HtmlFormat extends FormatAbstract
         // This query string is url encoded
         $queryString = $_SERVER['QUERY_STRING'];
 
+        // TODO: this should be the proper bridge short name and not user provided string
+        $bridgeName = $_GET['bridge'];
+
         $feedArray = $this->getFeed();
         $formatFactory = new FormatFactory();
         $formats = [];
@@ -48,6 +51,7 @@ class HtmlFormat extends FormatAbstract
         }
 
         $html = render_template(__DIR__ . '/../templates/html-format.html.php', [
+            'bridge_name'   => $bridgeName,
             'charset'       => $this->getCharset(),
             'title'         => $feedArray['name'],
             'formats'       => $formats,
diff --git a/index.php b/index.php
index 1efda44a..c4fe104f 100644
--- a/index.php
+++ b/index.php
@@ -76,9 +76,17 @@ $httpClient = new CurlHttpClient();
 
 date_default_timezone_set(Configuration::getConfig('system', 'timezone'));
 
+$argv = $argv ?? null;
+if ($argv) {
+    parse_str(implode('&', array_slice($argv, 1)), $cliArgs);
+    $request = Request::fromCli($cliArgs);
+} else {
+    $request = Request::fromGlobals();
+}
+
 try {
     $rssBridge = new RssBridge($logger, $cache, $httpClient);
-    $response = $rssBridge->main($argv ?? []);
+    $response = $rssBridge->main($request);
     $response->send();
 } catch (\Throwable $e) {
     // Probably an exception inside an action
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index 23f65cf0..35318c5b 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -16,15 +16,8 @@ final class RssBridge
         self::$httpClient = $httpClient;
     }
 
-    public function main(array $argv = []): Response
+    public function main(Request $request): Response
     {
-        if ($argv) {
-            parse_str(implode('&', array_slice($argv, 1)), $cliArgs);
-            $request = Request::fromCli($cliArgs);
-        } else {
-            $request = Request::fromGlobals();
-        }
-
         foreach ($request->toArray() as $key => $value) {
             if (!is_string($value)) {
                 return new Response(render(__DIR__ . '/../templates/error.html.php', [
diff --git a/templates/base.html.php b/templates/base.html.php
index d2557599..a8ff7660 100644
--- a/templates/base.html.php
+++ b/templates/base.html.php
@@ -4,7 +4,7 @@
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="description" content="RSS-Bridge" />
-    <title><?= e($_title ?? 'RSS-Bridge') ?></title>
+    <title>RSS-Bridge</title>
     <link href="static/style.css?2023-03-24" rel="stylesheet">
     <link rel="icon" type="image/png" href="static/favicon.png">
 
diff --git a/templates/html-format.html.php b/templates/html-format.html.php
index bc95c5d0..a05acdde 100644
--- a/templates/html-format.html.php
+++ b/templates/html-format.html.php
@@ -30,7 +30,7 @@
         </h1>
 
         <div class="buttons">
-            <a href="./#bridge-<?= $_GET['bridge'] ?>">
+            <a href="./#bridge-<?= e($bridge_name) ?>">
                 <button class="backbutton">← back to rss-bridge</button>
             </a>
 

From b0674d7b19f2bba901e8aab75760c021d0495e9d Mon Sep 17 00:00:00 2001
From: Clemens Neubauer <cn-tools@gmx.at>
Date: Thu, 22 Aug 2024 11:36:58 +0200
Subject: [PATCH 472/716] [BMDSystemhausBlogBridge] rework detectParameters
 (#4138)

* bridge BMDSystemhausBlog: rework of detectParameters

* fix lint phpcs error

* Update BMDSystemhausBlogBridge.php

* Update BMDSystemhausBlogBridge.php
---
 bridges/BMDSystemhausBlogBridge.php | 55 +++++++++++++++++++++++++----
 1 file changed, 48 insertions(+), 7 deletions(-)

diff --git a/bridges/BMDSystemhausBlogBridge.php b/bridges/BMDSystemhausBlogBridge.php
index c80f3ff3..12f3ca5e 100644
--- a/bridges/BMDSystemhausBlogBridge.php
+++ b/bridges/BMDSystemhausBlogBridge.php
@@ -8,6 +8,7 @@ class BMDSystemhausBlogBridge extends BridgeAbstract
     const URI = 'https://www.bmd.com';
     const DONATION_URI = 'https://paypal.me/cntools';
     const DESCRIPTION = 'BMD Systemhaus - We make business easy';
+    const BMD_FAV_ICON = 'https://www.bmd.com/favicon.ico';
 
     const ITEMSTYLE = [
         'ilcr' => '<table width="100%"><tr><td style="vertical-align: top;">{data_img}</td><td style="vertical-align: top;">{data_content}</td></tr></table>',
@@ -148,18 +149,58 @@ class BMDSystemhausBlogBridge extends BridgeAbstract
             return null;
         }
 
-        if ($parsedUrl->getHost() != 'www.bmd.com') {
+        if (!in_array($parsedUrl->getHost(), ['www.bmd.com', 'bmd.com'])) {
             return null;
         }
 
-        $path = explode('/', $parsedUrl->getPath());
+        $lang = '';
 
-        if ($this->getURIbyCountry($path[1]) == '') {
-            return null;
+        // extract language from url
+        $path = explode('/', $parsedUrl->getPath());
+        if (count($path) > 1) {
+            $lang = $path[1];
+
+            // validate data
+            if ($this->getURIbyCountry($lang) == '') {
+                $lang = '';
+            }
+        }
+
+        // if no country available, find language by browser
+        if ($lang == '') {
+            $srvLanguages = explode(';', $_SERVER['HTTP_ACCEPT_LANGUAGE']);
+            if (count($srvLanguages) > 0) {
+                $languages = explode(',', $srvLanguages[0]);
+                if (count($languages) > 0) {
+                    for ($i = 0; $i < count($languages); $i++) {
+                        $langDetails = explode('-', $languages[$i]);
+                        if (count($langDetails) > 1) {
+                            $lang = $langDetails[1];
+                        } else {
+                            $lang = substr($srvLanguages[0], 0, 2);
+                        }
+
+                        // validate data
+                        if ($this->getURIbyCountry($lang) == '') {
+                            $lang = '';
+                        }
+
+                        if ($lang != '') {
+                            break;
+                        }
+                    }
+                }
+            }
+        }
+
+        // if no URL found by language, use AT as default
+        if ($this->getURIbyCountry($lang) == '') {
+            $lang = 'at';
         }
 
         $params = [];
-        $params['country'] = $path[1];
+        $params['country'] = strtolower($lang);
+
         return $params;
     }
 
@@ -173,7 +214,7 @@ class BMDSystemhausBlogBridge extends BridgeAbstract
     //-----------------------------------------------------
     public function getIcon()
     {
-        return 'https://www.bmd.com/favicon.ico';
+        return self::BMD_FAV_ICON;
     }
 
     //-----------------------------------------------------
@@ -192,7 +233,7 @@ class BMDSystemhausBlogBridge extends BridgeAbstract
     //-----------------------------------------------------
     private function getURIbyCountry($country)
     {
-        switch ($country) {
+        switch (strtolower($country)) {
             case 'at':
                 return 'https://www.bmd.com/at/ueber-bmd/blog-ohne-filter.html';
             case 'de':

From c849576c936bf25982fe91f531301d57d787b285 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 23 Aug 2024 17:09:17 +0200
Subject: [PATCH 473/716] fix(rumble): fix guid bug (#4232)

Remove tracking parameter in query to avoid feed readers to interpret these as new items
---
 bridges/RumbleBridge.php | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/bridges/RumbleBridge.php b/bridges/RumbleBridge.php
index a8841e00..8d92db3b 100644
--- a/bridges/RumbleBridge.php
+++ b/bridges/RumbleBridge.php
@@ -60,12 +60,19 @@ class RumbleBridge extends BridgeAbstract
 
         $dom = getSimpleHTMLDOM($url);
         foreach ($dom->find('ol.thumbnail__grid div.thumbnail__grid--item') as $video) {
+            $itemUrlString = self::URI . $video->find('a', 0)->href;
+            $itemUrl = Url::fromString($itemUrlString);
+
             $item = [
                 'title'     => $video->find('h3', 0)->plaintext,
-                'uri'       => self::URI . $video->find('a', 0)->href,
+
+                // Remove tracking parameter in query string
+                'uri'       => $itemUrl->withQueryString(null)->__toString(),
+
                 'author'    => $account . '@rumble.com',
                 'content'   => defaultLinkTo($video, self::URI)->innertext,
             ];
+
             $time = $video->find('time', 0);
             if ($time) {
                 $publishedAt = new \DateTimeImmutable($time->getAttribute('datetime'));

From 6516e31c1bc78867820fead69ad65ba4c1d350ea Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 23 Aug 2024 17:34:06 +0200
Subject: [PATCH 474/716] refactor: format rendering (#4229)

---
 actions/DisplayAction.php        | 10 ++++++++--
 formats/AtomFormat.php           | 10 ++--------
 formats/HtmlFormat.php           |  6 +-----
 formats/JsonFormat.php           |  2 +-
 formats/MrssFormat.php           |  7 ++-----
 formats/PlaintextFormat.php      |  5 +----
 formats/SfeedFormat.php          |  9 +--------
 index.php                        |  7 +++++--
 lib/FormatAbstract.php           | 13 +------------
 templates/html-format.html.php   |  2 +-
 tests/FormatTest.php             |  2 +-
 tests/Formats/BaseFormatTest.php |  2 +-
 12 files changed, 25 insertions(+), 50 deletions(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 26f1cb40..5265abd8 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -160,9 +160,15 @@ class DisplayAction implements ActionInterface
         $format->setLastModified($now);
         $headers = [
             'last-modified' => gmdate('D, d M Y H:i:s ', $now) . 'GMT',
-            'content-type'  => $format->getMimeType() . '; charset=' . $format->getCharset(),
+            'content-type'  => $format->getMimeType() . '; charset=UTF-8',
         ];
-        return new Response($format->stringify(), 200, $headers);
+        $body = $format->render();
+
+        // This is supposed to remove non-utf8 byte sequences, but I'm unsure if it works
+        ini_set('mbstring.substitute_character', 'none');
+        $body = mb_convert_encoding($body, 'UTF-8', 'UTF-8');
+
+        return new Response($body, 200, $headers);
     }
 
     private function createFeedItemFromException($e, BridgeAbstract $bridge): array
diff --git a/formats/AtomFormat.php b/formats/AtomFormat.php
index 5c9f2b6a..7908eb90 100644
--- a/formats/AtomFormat.php
+++ b/formats/AtomFormat.php
@@ -14,9 +14,9 @@ class AtomFormat extends FormatAbstract
     protected const ATOM_NS = 'http://www.w3.org/2005/Atom';
     protected const MRSS_NS = 'http://search.yahoo.com/mrss/';
 
-    public function stringify()
+    public function render(): string
     {
-        $document = new \DomDocument('1.0', $this->getCharset());
+        $document = new \DomDocument('1.0', 'UTF-8');
         $document->formatOutput = true;
 
         $feedUrl = get_current_url();
@@ -86,8 +86,6 @@ class AtomFormat extends FormatAbstract
         $author->appendChild($authorName);
         $authorName->appendChild($document->createTextNode($feedAuthor));
 
-
-
         foreach ($this->getItems() as $item) {
             $itemArray = $item->toArray();
             $entryTimestamp = $item->getTimestamp();
@@ -204,10 +202,6 @@ class AtomFormat extends FormatAbstract
         }
 
         $xml = $document->saveXML();
-
-        // Remove invalid characters
-        ini_set('mbstring.substitute_character', 'none');
-        $xml = mb_convert_encoding($xml, $this->getCharset(), 'UTF-8');
         return $xml;
     }
 }
diff --git a/formats/HtmlFormat.php b/formats/HtmlFormat.php
index a5bcc451..04721ae1 100644
--- a/formats/HtmlFormat.php
+++ b/formats/HtmlFormat.php
@@ -4,7 +4,7 @@ class HtmlFormat extends FormatAbstract
 {
     const MIME_TYPE = 'text/html';
 
-    public function stringify()
+    public function render(): string
     {
         // This query string is url encoded
         $queryString = $_SERVER['QUERY_STRING'];
@@ -52,16 +52,12 @@ class HtmlFormat extends FormatAbstract
 
         $html = render_template(__DIR__ . '/../templates/html-format.html.php', [
             'bridge_name'   => $bridgeName,
-            'charset'       => $this->getCharset(),
             'title'         => $feedArray['name'],
             'formats'       => $formats,
             'uri'           => $feedArray['uri'],
             'items'         => $items,
             'donation_uri'  => $donationUri,
         ]);
-        // Remove invalid characters
-        ini_set('mbstring.substitute_character', 'none');
-        $html = mb_convert_encoding($html, $this->getCharset(), 'UTF-8');
         return $html;
     }
 }
diff --git a/formats/JsonFormat.php b/formats/JsonFormat.php
index 586aae0a..3548ef6e 100644
--- a/formats/JsonFormat.php
+++ b/formats/JsonFormat.php
@@ -23,7 +23,7 @@ class JsonFormat extends FormatAbstract
         'uid',
     ];
 
-    public function stringify()
+    public function render(): string
     {
         $feedArray = $this->getFeed();
 
diff --git a/formats/MrssFormat.php b/formats/MrssFormat.php
index aaa1d0cd..f7b11949 100644
--- a/formats/MrssFormat.php
+++ b/formats/MrssFormat.php
@@ -32,9 +32,9 @@ class MrssFormat extends FormatAbstract
     protected const ATOM_NS = 'http://www.w3.org/2005/Atom';
     protected const MRSS_NS = 'http://search.yahoo.com/mrss/';
 
-    public function stringify()
+    public function render(): string
     {
-        $document = new \DomDocument('1.0', $this->getCharset());
+        $document = new \DomDocument('1.0', 'UTF-8');
         $document->formatOutput = true;
 
         $feed = $document->createElement('rss');
@@ -198,9 +198,6 @@ class MrssFormat extends FormatAbstract
         }
 
         $xml = $document->saveXML();
-        // Remove invalid non-UTF8 characters
-        ini_set('mbstring.substitute_character', 'none');
-        $xml = mb_convert_encoding($xml, $this->getCharset(), 'UTF-8');
         return $xml;
     }
 }
diff --git a/formats/PlaintextFormat.php b/formats/PlaintextFormat.php
index 4e18caa6..e93c94b5 100644
--- a/formats/PlaintextFormat.php
+++ b/formats/PlaintextFormat.php
@@ -4,16 +4,13 @@ class PlaintextFormat extends FormatAbstract
 {
     const MIME_TYPE = 'text/plain';
 
-    public function stringify()
+    public function render(): string
     {
         $feed = $this->getFeed();
         foreach ($this->getItems() as $item) {
             $feed['items'][] = $item->toArray();
         }
         $text = print_r($feed, true);
-        // Remove invalid non-UTF8 characters
-        ini_set('mbstring.substitute_character', 'none');
-        $text = mb_convert_encoding($text, $this->getCharset(), 'UTF-8');
         return $text;
     }
 }
diff --git a/formats/SfeedFormat.php b/formats/SfeedFormat.php
index 33740aaa..063e4543 100644
--- a/formats/SfeedFormat.php
+++ b/formats/SfeedFormat.php
@@ -4,7 +4,7 @@ class SfeedFormat extends FormatAbstract
 {
     const MIME_TYPE = 'text/plain';
 
-    public function stringify()
+    public function render(): string
     {
         $text = '';
         foreach ($this->getItems() as $item) {
@@ -26,13 +26,6 @@ class SfeedFormat extends FormatAbstract
             );
         }
 
-        // Remove invalid non-UTF8 characters
-        ini_set('mbstring.substitute_character', 'none');
-        $text = mb_convert_encoding(
-            $text,
-            $this->getCharset(),
-            'UTF-8'
-        );
         return $text;
     }
 
diff --git a/index.php b/index.php
index c4fe104f..2a613363 100644
--- a/index.php
+++ b/index.php
@@ -62,8 +62,11 @@ register_shutdown_function(function () use ($logger) {
 
 $cacheFactory = new CacheFactory($logger);
 
-// Uncomment this for debug logging
-// $logger->addHandler(new StreamHandler('/tmp/rss-bridge.txt', Logger::DEBUG));
+// Uncomment this for info logging to fs
+// $logger->addHandler(new StreamHandler('/tmp/rss-bridge.txt', Logger::INFO));
+
+// Uncomment this for debug logging to fs
+// $logger->addHandler(new StreamHandler('/tmp/rss-bridge-debug.txt', Logger::DEBUG));
 
 if (Debug::isEnabled()) {
     $logger->addHandler(new ErrorLogHandler(Logger::DEBUG));
diff --git a/lib/FormatAbstract.php b/lib/FormatAbstract.php
index 9cba0d8c..17e733a7 100644
--- a/lib/FormatAbstract.php
+++ b/lib/FormatAbstract.php
@@ -8,11 +8,10 @@ abstract class FormatAbstract
 
     protected array $feed = [];
     protected array $items = [];
-    protected string $charset = 'UTF-8';
 
     protected int $lastModified;
 
-    abstract public function stringify();
+    abstract public function render(): string;
 
     public function setFeed(array $feed)
     {
@@ -50,16 +49,6 @@ abstract class FormatAbstract
         return static::MIME_TYPE;
     }
 
-    public function setCharset(string $charset)
-    {
-        $this->charset = $charset;
-    }
-
-    public function getCharset(): string
-    {
-        return $this->charset;
-    }
-
     public function setLastModified(int $lastModified)
     {
         $this->lastModified = $lastModified;
diff --git a/templates/html-format.html.php b/templates/html-format.html.php
index a05acdde..8e8abfcf 100644
--- a/templates/html-format.html.php
+++ b/templates/html-format.html.php
@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html lang="en">
 <head>
-    <meta charset="<?= $charset ?>">
+    <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0"/ >
     <meta name="description" content="RSS-Bridge" />
     <title><?= e($title) ?></title>
diff --git a/tests/FormatTest.php b/tests/FormatTest.php
index b5df395c..33e02769 100644
--- a/tests/FormatTest.php
+++ b/tests/FormatTest.php
@@ -58,7 +58,7 @@ class FormatTest extends TestCase
 
 class TestFormat extends \FormatAbstract
 {
-    public function stringify()
+    public function render(): string
     {
     }
 }
diff --git a/tests/Formats/BaseFormatTest.php b/tests/Formats/BaseFormatTest.php
index 0907b72a..4b6a549b 100644
--- a/tests/Formats/BaseFormatTest.php
+++ b/tests/Formats/BaseFormatTest.php
@@ -64,6 +64,6 @@ abstract class BaseFormatTest extends TestCase
         $format->setFeed($sample->meta);
         $format->setLastModified(strtotime('2000-01-01 12:00:00 UTC'));
 
-        return $format->stringify();
+        return $format->render();
     }
 }

From d51cc8f1a7e17cc07cecc1979beae9618902997f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Petr=20Kol=C3=A1=C5=99?= <kolarcz@gmail.com>
Date: Wed, 28 Aug 2024 19:43:40 +0200
Subject: [PATCH 475/716] Fixed path in CeskaTelevizeBridge (#4236)

---
 bridges/CeskaTelevizeBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/CeskaTelevizeBridge.php b/bridges/CeskaTelevizeBridge.php
index be00d664..026e8c2a 100644
--- a/bridges/CeskaTelevizeBridge.php
+++ b/bridges/CeskaTelevizeBridge.php
@@ -60,7 +60,7 @@ class CeskaTelevizeBridge extends BridgeAbstract
         foreach ($html->find('#episodeListSection a[data-testid=card]') as $element) {
             $itemTitle = $element->find('h3', 0);
             $itemContent = $element->find('p[class^=content-]', 0);
-            $itemDate = $element->find('div[class^=playTime-] span', 0);
+            $itemDate = $element->find('div[class^=playTime-] span, [data-testid=episode-item-broadcast] span', 0);
             $itemThumbnail = $element->find('img', 0);
             $itemUri = self::URI . $element->getAttribute('href');
 

From e010fd4d52e3273d6ba2d2d6f45e5a58880ba043 Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Wed, 28 Aug 2024 23:15:54 +0530
Subject: [PATCH 476/716] [HinduTamilBridge] fix image (#4237)

---
 bridges/HinduTamilBridge.php | 33 ++++++++++++++-------------------
 1 file changed, 14 insertions(+), 19 deletions(-)

diff --git a/bridges/HinduTamilBridge.php b/bridges/HinduTamilBridge.php
index d12f5131..50b9b8e6 100644
--- a/bridges/HinduTamilBridge.php
+++ b/bridges/HinduTamilBridge.php
@@ -4,6 +4,7 @@ class HinduTamilBridge extends FeedExpander
 {
     const NAME = 'HinduTamil';
     const URI = 'https://www.hindutamil.in';
+    const FEED_BASE_URL = 'https://feeds.feedburner.com/Hindu_Tamil_';
     const DESCRIPTION = 'Retrieve full articles from hindutamil.in feeds';
     const MAINTAINER = 'tillcash';
     const PARAMETERS = [
@@ -45,8 +46,6 @@ class HinduTamilBridge extends FeedExpander
         ],
     ];
 
-    const FEED_BASE_URL = 'https://feeds.feedburner.com/Hindu_Tamil_';
-
     public function getName()
     {
         $topic = $this->getKey('topic');
@@ -69,34 +68,30 @@ class HinduTamilBridge extends FeedExpander
             return $item;
         }
 
-        $date = $dom->find('p span.date', 1);
-        if ($date) {
-            $item['timestamp'] = $this->toRFC3339($date->plaintext);
-        }
-
-        $image = $dom->find('#LoadArticle figure', 0) ?? '';
-        $item['content'] = $image . $this->cleanContent($content);
+        $item['timestamp'] = $this->getTimestamp($dom) ?? $item['timestamp'];
+        $item['content'] = $this->getImage($dom) . $this->cleanContent($content);
 
         return $item;
     }
 
-    private function cleanContent($content)
+    private function cleanContent($content): string
     {
-        foreach ($content->find('div[align="center"], script') as $remove) {
+        foreach ($content->find('div[align="center"], script, .adsplacement') as $remove) {
             $remove->outertext = '';
         }
 
-        return $content;
+        return $content->innertext;
     }
 
-    private function toRFC3339($dateString)
+    private function getTimestamp($dom): ?string
     {
-        $timestamp = strtotime(trim($dateString));
+        $date = $dom->find('meta[property="article:published_time"]', 0);
+        return $date ? $date->getAttribute('content') : null;
+    }
 
-        if ($timestamp === false) {
-            return null;
-        }
-
-        return date('Y-m-d\TH:i:s', $timestamp) . '+05:30';
+    private function getImage($dom): string
+    {
+        $image = $dom->find('meta[property="og:image"]', 0);
+        return $image ? sprintf('<p><img src="%s"></p>', $image->getAttribute('content')) : '';
     }
 }

From 58544cd61a465102bebc315b4467e4e45d587723 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 29 Aug 2024 22:48:59 +0200
Subject: [PATCH 477/716] refactor: introduce DI container (#4238)

* refactor: introduce DI container

* add bin/test
---
 actions/ConnectivityAction.php |  7 +--
 actions/DetectAction.php       | 16 ++++---
 actions/DisplayAction.php      | 20 +++++----
 actions/FindfeedAction.php     | 16 ++++---
 actions/FrontpageAction.php    | 17 +++++---
 actions/ListAction.php         | 16 ++++---
 bin/cache-clear                |  7 +--
 bin/cache-prune                |  7 +--
 bin/test                       | 29 +++++++++++++
 bridges/TwitchBridge.php       |  2 +-
 index.php                      | 23 ++--------
 lib/BridgeCard.php             |  9 ++--
 lib/BridgeFactory.php          | 10 +++--
 lib/CacheFactory.php           |  4 --
 lib/Container.php              | 33 ++++++++++++++
 lib/RssBridge.php              | 23 ++++------
 lib/dependencies.php           | 78 ++++++++++++++++++++++++++++++++++
 lib/logger.php                 |  3 +-
 18 files changed, 231 insertions(+), 89 deletions(-)
 create mode 100755 bin/test
 create mode 100644 lib/Container.php
 create mode 100644 lib/dependencies.php

diff --git a/actions/ConnectivityAction.php b/actions/ConnectivityAction.php
index 9732d0aa..e4e1e7c2 100644
--- a/actions/ConnectivityAction.php
+++ b/actions/ConnectivityAction.php
@@ -14,9 +14,10 @@ class ConnectivityAction implements ActionInterface
 {
     private BridgeFactory $bridgeFactory;
 
-    public function __construct()
-    {
-        $this->bridgeFactory = new BridgeFactory();
+    public function __construct(
+        BridgeFactory $bridgeFactory
+    ) {
+        $this->bridgeFactory = $bridgeFactory;
     }
 
     public function __invoke(Request $request): Response
diff --git a/actions/DetectAction.php b/actions/DetectAction.php
index cebbc307..8d3d6263 100644
--- a/actions/DetectAction.php
+++ b/actions/DetectAction.php
@@ -2,6 +2,14 @@
 
 class DetectAction implements ActionInterface
 {
+    private BridgeFactory $bridgeFactory;
+
+    public function __construct(
+        BridgeFactory $bridgeFactory
+    ) {
+        $this->bridgeFactory = $bridgeFactory;
+    }
+
     public function __invoke(Request $request): Response
     {
         $url = $request->get('url');
@@ -14,14 +22,12 @@ class DetectAction implements ActionInterface
             return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'You must specify a format']));
         }
 
-        $bridgeFactory = new BridgeFactory();
-
-        foreach ($bridgeFactory->getBridgeClassNames() as $bridgeClassName) {
-            if (!$bridgeFactory->isEnabled($bridgeClassName)) {
+        foreach ($this->bridgeFactory->getBridgeClassNames() as $bridgeClassName) {
+            if (!$this->bridgeFactory->isEnabled($bridgeClassName)) {
                 continue;
             }
 
-            $bridge = $bridgeFactory->create($bridgeClassName);
+            $bridge = $this->bridgeFactory->create($bridgeClassName);
 
             $bridgeParams = $bridge->detectParameters($url);
 
diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 5265abd8..c00c0d5e 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -4,11 +4,16 @@ class DisplayAction implements ActionInterface
 {
     private CacheInterface $cache;
     private Logger $logger;
+    private BridgeFactory $bridgeFactory;
 
-    public function __construct()
-    {
-        $this->cache = RssBridge::getCache();
-        $this->logger = RssBridge::getLogger();
+    public function __construct(
+        CacheInterface $cache,
+        Logger $logger,
+        BridgeFactory $bridgeFactory
+    ) {
+        $this->cache = $cache;
+        $this->logger = $logger;
+        $this->bridgeFactory = $bridgeFactory;
     }
 
     public function __invoke(Request $request): Response
@@ -39,8 +44,7 @@ class DisplayAction implements ActionInterface
         if (!$bridgeName) {
             return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'Missing bridge parameter']), 400);
         }
-        $bridgeFactory = new BridgeFactory();
-        $bridgeClassName = $bridgeFactory->createBridgeClassName($bridgeName);
+        $bridgeClassName = $this->bridgeFactory->createBridgeClassName($bridgeName);
         if (!$bridgeClassName) {
             return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'Bridge not found']), 404);
         }
@@ -48,7 +52,7 @@ class DisplayAction implements ActionInterface
         if (!$format) {
             return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'You must specify a format']), 400);
         }
-        if (!$bridgeFactory->isEnabled($bridgeClassName)) {
+        if (!$this->bridgeFactory->isEnabled($bridgeClassName)) {
             return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'This bridge is not whitelisted']), 400);
         }
 
@@ -62,7 +66,7 @@ class DisplayAction implements ActionInterface
             define('NOPROXY', true);
         }
 
-        $bridge = $bridgeFactory->create($bridgeClassName);
+        $bridge = $this->bridgeFactory->create($bridgeClassName);
 
         $response = $this->createResponse($request, $bridge, $format);
 
diff --git a/actions/FindfeedAction.php b/actions/FindfeedAction.php
index 6654ca6d..e18c3e1d 100644
--- a/actions/FindfeedAction.php
+++ b/actions/FindfeedAction.php
@@ -7,6 +7,14 @@
  */
 class FindfeedAction implements ActionInterface
 {
+    private BridgeFactory $bridgeFactory;
+
+    public function __construct(
+        BridgeFactory $bridgeFactory
+    ) {
+        $this->bridgeFactory = $bridgeFactory;
+    }
+
     public function __invoke(Request $request): Response
     {
         $url = $request->get('url');
@@ -19,15 +27,13 @@ class FindfeedAction implements ActionInterface
             return new Response('You must specify a format', 400);
         }
 
-        $bridgeFactory = new BridgeFactory();
-
         $results = [];
-        foreach ($bridgeFactory->getBridgeClassNames() as $bridgeClassName) {
-            if (!$bridgeFactory->isEnabled($bridgeClassName)) {
+        foreach ($this->bridgeFactory->getBridgeClassNames() as $bridgeClassName) {
+            if (!$this->bridgeFactory->isEnabled($bridgeClassName)) {
                 continue;
             }
 
-            $bridge = $bridgeFactory->create($bridgeClassName);
+            $bridge = $this->bridgeFactory->create($bridgeClassName);
 
             $bridgeParams = $bridge->detectParameters($url);
 
diff --git a/actions/FrontpageAction.php b/actions/FrontpageAction.php
index 6ab18d29..824441b2 100644
--- a/actions/FrontpageAction.php
+++ b/actions/FrontpageAction.php
@@ -2,6 +2,14 @@
 
 final class FrontpageAction implements ActionInterface
 {
+    private BridgeFactory $bridgeFactory;
+
+    public function __construct(
+        BridgeFactory $bridgeFactory
+    ) {
+        $this->bridgeFactory = $bridgeFactory;
+    }
+
     public function __invoke(Request $request): Response
     {
         $token = $request->attribute('token');
@@ -9,10 +17,9 @@ final class FrontpageAction implements ActionInterface
         $messages = [];
         $activeBridges = 0;
 
-        $bridgeFactory = new BridgeFactory();
-        $bridgeClassNames = $bridgeFactory->getBridgeClassNames();
+        $bridgeClassNames = $this->bridgeFactory->getBridgeClassNames();
 
-        foreach ($bridgeFactory->getMissingEnabledBridges() as $missingEnabledBridge) {
+        foreach ($this->bridgeFactory->getMissingEnabledBridges() as $missingEnabledBridge) {
             $messages[] = [
                 'body' => sprintf('Warning : Bridge "%s" not found', $missingEnabledBridge),
                 'level' => 'warning'
@@ -21,8 +28,8 @@ final class FrontpageAction implements ActionInterface
 
         $body = '';
         foreach ($bridgeClassNames as $bridgeClassName) {
-            if ($bridgeFactory->isEnabled($bridgeClassName)) {
-                $body .= BridgeCard::render($bridgeClassName, $token);
+            if ($this->bridgeFactory->isEnabled($bridgeClassName)) {
+                $body .= BridgeCard::render($this->bridgeFactory, $bridgeClassName, $token);
                 $activeBridges++;
             }
         }
diff --git a/actions/ListAction.php b/actions/ListAction.php
index 3dd8f441..f6347f9c 100644
--- a/actions/ListAction.php
+++ b/actions/ListAction.php
@@ -2,19 +2,25 @@
 
 class ListAction implements ActionInterface
 {
+    private BridgeFactory $bridgeFactory;
+
+    public function __construct(
+        BridgeFactory $bridgeFactory
+    ) {
+        $this->bridgeFactory = $bridgeFactory;
+    }
+
     public function __invoke(Request $request): Response
     {
         $list = new \stdClass();
         $list->bridges = [];
         $list->total = 0;
 
-        $bridgeFactory = new BridgeFactory();
-
-        foreach ($bridgeFactory->getBridgeClassNames() as $bridgeClassName) {
-            $bridge = $bridgeFactory->create($bridgeClassName);
+        foreach ($this->bridgeFactory->getBridgeClassNames() as $bridgeClassName) {
+            $bridge = $this->bridgeFactory->create($bridgeClassName);
 
             $list->bridges[$bridgeClassName] = [
-                'status'        => $bridgeFactory->isEnabled($bridgeClassName) ? 'active' : 'inactive',
+                'status'        => $this->bridgeFactory->isEnabled($bridgeClassName) ? 'active' : 'inactive',
                 'uri'           => $bridge->getURI(),
                 'donationUri'   => $bridge->getDonationURI(),
                 'name'          => $bridge->getName(),
diff --git a/bin/cache-clear b/bin/cache-clear
index 635f41d5..71466360 100755
--- a/bin/cache-clear
+++ b/bin/cache-clear
@@ -17,11 +17,8 @@ if (file_exists(__DIR__ . '/../config.ini.php')) {
 }
 Configuration::loadConfiguration($config, getenv());
 
-$logger = new SimpleLogger('rssbridge');
+$container = require __DIR__ . '/../lib/dependencies.php';
 
-$logger->addHandler(new StreamHandler('php://stderr', Logger::INFO));
-
-$cacheFactory = new CacheFactory($logger);
-$cache = $cacheFactory->create();
+$cache = $container['cache'];
 
 $cache->clear();
diff --git a/bin/cache-prune b/bin/cache-prune
index 281c019d..37696e14 100755
--- a/bin/cache-prune
+++ b/bin/cache-prune
@@ -17,11 +17,8 @@ if (file_exists(__DIR__ . '/../config.ini.php')) {
 }
 Configuration::loadConfiguration($config, getenv());
 
-$logger = new SimpleLogger('rssbridge');
+$container = require __DIR__ . '/../lib/dependencies.php';
 
-$logger->addHandler(new StreamHandler('php://stderr', Logger::INFO));
-
-$cacheFactory = new CacheFactory($logger);
-$cache = $cacheFactory->create();
+$cache = $container['cache'];
 
 $cache->prune();
diff --git a/bin/test b/bin/test
new file mode 100755
index 00000000..f3556fc1
--- /dev/null
+++ b/bin/test
@@ -0,0 +1,29 @@
+#!/usr/bin/env php
+<?php
+
+/**
+ * Add log records to all three levels (for testing purposes)
+ */
+
+require __DIR__ . '/../lib/bootstrap.php';
+
+$config = [];
+if (file_exists(__DIR__ . '/../config.ini.php')) {
+    $config = parse_ini_file(__DIR__ . '/../config.ini.php', true, INI_SCANNER_TYPED);
+    if (!$config) {
+        http_response_code(500);
+        exit("Error parsing config.ini.php\n");
+    }
+}
+Configuration::loadConfiguration($config, getenv());
+
+$container = require __DIR__ . '/../lib/dependencies.php';
+
+/** @var Logger $logger */
+$logger = $container['logger'];
+
+$logger->debug('This is a test debug message');
+
+$logger->info('This is a test info message');
+
+$logger->error('This is a test error message');
diff --git a/bridges/TwitchBridge.php b/bridges/TwitchBridge.php
index 424cd6e3..c273aaca 100644
--- a/bridges/TwitchBridge.php
+++ b/bridges/TwitchBridge.php
@@ -99,7 +99,7 @@ EOD;
         $user = $data->user;
         if ($user->videos === null) {
             // twitch regularly does this for unknown reasons
-            //$this->logger->info('Twitch returned empty set of videos', ['data' => $data]);
+            $this->debug->info('Twitch returned empty set of videos', ['data' => $data]);
             return;
         }
 
diff --git a/index.php b/index.php
index 2a613363..7b441944 100644
--- a/index.php
+++ b/index.php
@@ -17,7 +17,9 @@ if (file_exists(__DIR__ . '/config.ini.php')) {
 }
 Configuration::loadConfiguration($config, getenv());
 
-$logger = new SimpleLogger('rssbridge');
+$container = require __DIR__ . '/lib/dependencies.php';
+
+$logger = $container['logger'];
 
 set_exception_handler(function (\Throwable $e) use ($logger) {
     $response = new Response(render(__DIR__ . '/templates/exception.html.php', ['e' => $e]), 500);
@@ -60,23 +62,6 @@ register_shutdown_function(function () use ($logger) {
     }
 });
 
-$cacheFactory = new CacheFactory($logger);
-
-// Uncomment this for info logging to fs
-// $logger->addHandler(new StreamHandler('/tmp/rss-bridge.txt', Logger::INFO));
-
-// Uncomment this for debug logging to fs
-// $logger->addHandler(new StreamHandler('/tmp/rss-bridge-debug.txt', Logger::DEBUG));
-
-if (Debug::isEnabled()) {
-    $logger->addHandler(new ErrorLogHandler(Logger::DEBUG));
-    $cache = $cacheFactory->create('array');
-} else {
-    $logger->addHandler(new ErrorLogHandler(Logger::INFO));
-    $cache = $cacheFactory->create();
-}
-$httpClient = new CurlHttpClient();
-
 date_default_timezone_set(Configuration::getConfig('system', 'timezone'));
 
 $argv = $argv ?? null;
@@ -88,7 +73,7 @@ if ($argv) {
 }
 
 try {
-    $rssBridge = new RssBridge($logger, $cache, $httpClient);
+    $rssBridge = new RssBridge($container);
     $response = $rssBridge->main($request);
     $response->send();
 } catch (\Throwable $e) {
diff --git a/lib/BridgeCard.php b/lib/BridgeCard.php
index f270c1a3..855ddb93 100644
--- a/lib/BridgeCard.php
+++ b/lib/BridgeCard.php
@@ -2,10 +2,11 @@
 
 final class BridgeCard
 {
-    public static function render(string $bridgeClassName, ?string $token): string
-    {
-        $bridgeFactory = new BridgeFactory();
-
+    public static function render(
+        BridgeFactory $bridgeFactory,
+        string $bridgeClassName,
+        ?string $token
+    ): string {
         $bridge = $bridgeFactory->create($bridgeClassName);
 
         $uri = $bridge->getURI();
diff --git a/lib/BridgeFactory.php b/lib/BridgeFactory.php
index ad433287..c214e44b 100644
--- a/lib/BridgeFactory.php
+++ b/lib/BridgeFactory.php
@@ -8,10 +8,12 @@ final class BridgeFactory
     private array $enabledBridges = [];
     private array $missingEnabledBridges = [];
 
-    public function __construct()
-    {
-        $this->cache = RssBridge::getCache();
-        $this->logger = RssBridge::getLogger();
+    public function __construct(
+        CacheInterface $cache,
+        Logger $logger
+    ) {
+        $this->cache = $cache;
+        $this->logger = $logger;
 
         // Create all possible bridge class names from fs
         foreach (scandir(__DIR__ . '/../bridges/') as $file) {
diff --git a/lib/CacheFactory.php b/lib/CacheFactory.php
index 90aa21ba..47bbbf72 100644
--- a/lib/CacheFactory.php
+++ b/lib/CacheFactory.php
@@ -14,10 +14,6 @@ class CacheFactory
 
     public function create(string $name = null): CacheInterface
     {
-        $name ??= Configuration::getConfig('cache', 'type');
-        if (!$name) {
-            throw new \Exception('No cache type configured');
-        }
         $cacheNames = [];
         foreach (scandir(PATH_LIB_CACHES) as $file) {
             if (preg_match('/^([^.]+)Cache\.php$/U', $file, $m)) {
diff --git a/lib/Container.php b/lib/Container.php
new file mode 100644
index 00000000..6dd0b6d3
--- /dev/null
+++ b/lib/Container.php
@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+class Container implements \ArrayAccess
+{
+    private array $values = [];
+    private array $resolved = [];
+
+    public function offsetSet($offset, $value): void
+    {
+        $this->values[$offset] = $value;
+    }
+
+    #[ReturnTypeWillChange] public function offsetGet($offset)
+    {
+        if (!isset($this->values[$offset])) {
+            throw new \Exception(sprintf('Unknown container key: "%s"', $offset));
+        }
+        if (!isset($this->resolved[$offset])) {
+            $this->resolved[$offset] = $this->values[$offset]($this);
+        }
+        return $this->resolved[$offset];
+    }
+
+    #[ReturnTypeWillChange] public function offsetExists($offset)
+    {
+    }
+
+    public function offsetUnset($offset): void
+    {
+    }
+}
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index 35318c5b..9c8f5767 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -2,18 +2,12 @@
 
 final class RssBridge
 {
-    private static Logger $logger;
-    private static CacheInterface $cache;
-    private static HttpClient $httpClient;
+    private static Container $container;
 
     public function __construct(
-        Logger $logger,
-        CacheInterface $cache,
-        HttpClient $httpClient
+        Container $container
     ) {
-        self::$logger = $logger;
-        self::$cache = $cache;
-        self::$httpClient = $httpClient;
+        self::$container = $container;
     }
 
     public function main(Request $request): Response
@@ -83,10 +77,9 @@ final class RssBridge
             return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'Invalid action']), 400);
         }
 
-        $className = '\\' . $actionName;
-        $actionObject = new $className();
+        $controller = self::$container[$actionName];
 
-        $response = $actionObject($request);
+        $response = $controller($request);
 
         return $response;
     }
@@ -94,16 +87,16 @@ final class RssBridge
     public static function getLogger(): Logger
     {
         // null logger is only for the tests not to fail
-        return self::$logger ?? new NullLogger();
+        return self::$container['logger'] ?? new NullLogger();
     }
 
     public static function getCache(): CacheInterface
     {
-        return self::$cache;
+        return self::$container['cache'];
     }
 
     public static function getHttpClient(): HttpClient
     {
-        return self::$httpClient;
+        return self::$container['http_client'];
     }
 }
diff --git a/lib/dependencies.php b/lib/dependencies.php
new file mode 100644
index 00000000..227a66f1
--- /dev/null
+++ b/lib/dependencies.php
@@ -0,0 +1,78 @@
+<?php
+
+declare(strict_types=1);
+
+$container = new Container();
+
+$container[ConnectivityAction::class] = function ($c) {
+    return new ConnectivityAction($c['bridge_factory']);
+};
+
+$container[DetectAction::class] = function ($c) {
+    return new DetectAction($c['bridge_factory']);
+};
+
+$container[DisplayAction::class] = function ($c) {
+    return new DisplayAction($c['cache'], $c['logger'], $c['bridge_factory']);
+};
+
+$container[FindfeedAction::class] = function ($c) {
+    return new FindfeedAction($c['bridge_factory']);
+};
+
+$container[FrontpageAction::class] = function ($c) {
+    return new FrontpageAction($c['bridge_factory']);
+};
+
+$container[HealthAction::class] = function () {
+    return new HealthAction();
+};
+
+$container[ListAction::class] = function ($c) {
+    return new ListAction($c['bridge_factory']);
+};
+
+$container['bridge_factory'] = function ($c) {
+    return new BridgeFactory($c['cache'], $c['logger']);
+};
+
+
+$container['http_client'] = function () {
+    return new CurlHttpClient();
+};
+
+$container['cache_factory'] = function ($c) {
+    return new CacheFactory($c['logger']);
+};
+
+$container['logger'] = function () {
+    $logger = new SimpleLogger('rssbridge');
+    if (Debug::isEnabled()) {
+        $logger->addHandler(new ErrorLogHandler(Logger::DEBUG));
+    } else {
+        $logger->addHandler(new ErrorLogHandler(Logger::INFO));
+    }
+    // Uncomment this for info logging to fs
+    // $logger->addHandler(new StreamHandler('/tmp/rss-bridge.txt', Logger::INFO));
+
+    // Uncomment this for debug logging to fs
+    //$logger->addHandler(new StreamHandler('/tmp/rss-bridge-debug.txt', Logger::DEBUG));
+    return $logger;
+};
+
+$container['cache'] = function ($c) {
+    /** @var CacheFactory $cacheFactory */
+    $cacheFactory = $c['cache_factory'];
+    $type = Configuration::getConfig('cache', 'type');
+    if (!$type) {
+        throw new \Exception('No cache type configured');
+    }
+    if (Debug::isEnabled()) {
+        $cache = $cacheFactory->create('array');
+    } else {
+        $cache = $cacheFactory->create($type);
+    }
+    return $cache;
+};
+
+return $container;
diff --git a/lib/logger.php b/lib/logger.php
index 3ebe3b0a..74a0e713 100644
--- a/lib/logger.php
+++ b/lib/logger.php
@@ -175,8 +175,9 @@ final class ErrorLogHandler
                 $context = Json::encode($record['context']);
             }
         }
+        // Intentionally omitting newline
         $text = sprintf(
-            "[%s] %s.%s %s %s\n",
+            '[%s] %s.%s %s %s',
             $record['created_at']->format('Y-m-d H:i:s'),
             $record['name'],
             $record['level_name'],

From e7ae06dcf08f0c977a231bb1ce9cb0b6657b4cfd Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 29 Aug 2024 23:02:01 +0200
Subject: [PATCH 478/716] fix: bug in prior refactor (#4239)

---
 lib/Container.php | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/lib/Container.php b/lib/Container.php
index 6dd0b6d3..086bd1f6 100644
--- a/lib/Container.php
+++ b/lib/Container.php
@@ -12,7 +12,8 @@ class Container implements \ArrayAccess
         $this->values[$offset] = $value;
     }
 
-    #[ReturnTypeWillChange] public function offsetGet($offset)
+    #[\ReturnTypeWillChange]
+    public function offsetGet($offset)
     {
         if (!isset($this->values[$offset])) {
             throw new \Exception(sprintf('Unknown container key: "%s"', $offset));
@@ -23,7 +24,8 @@ class Container implements \ArrayAccess
         return $this->resolved[$offset];
     }
 
-    #[ReturnTypeWillChange] public function offsetExists($offset)
+    #[\ReturnTypeWillChange]
+    public function offsetExists($offset)
     {
     }
 

From 39952c2d95cf4806063abbc2c7508cf9ab4f93e5 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 30 Aug 2024 00:07:58 +0200
Subject: [PATCH 479/716] refactor: implement middleware chain (#4240)

* refactor: implement middleware chain

* refactor
---
 lib/RssBridge.php                             | 75 ++++---------------
 lib/bootstrap.php                             |  1 +
 middlewares/BasicAuthMiddleware.php           | 38 ++++++++++
 middlewares/MaintenanceMiddleware.php         | 17 +++++
 middlewares/Middleware.php                    |  8 ++
 middlewares/SecurityMiddleware.php            | 21 ++++++
 middlewares/TokenAuthenticationMiddleware.php | 29 +++++++
 7 files changed, 128 insertions(+), 61 deletions(-)
 create mode 100644 middlewares/BasicAuthMiddleware.php
 create mode 100644 middlewares/MaintenanceMiddleware.php
 create mode 100644 middlewares/Middleware.php
 create mode 100644 middlewares/SecurityMiddleware.php
 create mode 100644 middlewares/TokenAuthenticationMiddleware.php

diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index 9c8f5767..230488bf 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -12,63 +12,6 @@ final class RssBridge
 
     public function main(Request $request): Response
     {
-        foreach ($request->toArray() as $key => $value) {
-            if (!is_string($value)) {
-                return new Response(render(__DIR__ . '/../templates/error.html.php', [
-                    'message' => "Query parameter \"$key\" is not a string.",
-                ]), 400);
-            }
-        }
-
-        if (Configuration::getConfig('system', 'enable_maintenance_mode')) {
-            return new Response(render(__DIR__ . '/../templates/error.html.php', [
-                'title'     => '503 Service Unavailable',
-                'message'   => 'RSS-Bridge is down for maintenance.',
-            ]), 503);
-        }
-
-        // HTTP Basic auth check
-        if (Configuration::getConfig('authentication', 'enable')) {
-            if (Configuration::getConfig('authentication', 'password') === '') {
-                return new Response('The authentication password cannot be the empty string', 500);
-            }
-            $user = $request->server('PHP_AUTH_USER');
-            $password = $request->server('PHP_AUTH_PW');
-            if ($user === null || $password === null) {
-                $html = render(__DIR__ . '/../templates/error.html.php', [
-                    'message' => 'Please authenticate in order to access this instance!',
-                ]);
-                return new Response($html, 401, ['WWW-Authenticate' => 'Basic realm="RSS-Bridge"']);
-            }
-            if (
-                (Configuration::getConfig('authentication', 'username') !== $user)
-                || (! hash_equals(Configuration::getConfig('authentication', 'password'), $password))
-            ) {
-                $html = render(__DIR__ . '/../templates/error.html.php', [
-                    'message' => 'Please authenticate in order to access this instance!',
-                ]);
-                return new Response($html, 401, ['WWW-Authenticate' => 'Basic realm="RSS-Bridge"']);
-            }
-            // At this point the username and password was correct
-        }
-
-        // Add token as attribute to request
-        $request = $request->withAttribute('token', $request->get('token'));
-
-        // Token authentication check
-        if (Configuration::getConfig('authentication', 'token')) {
-            if (! $request->attribute('token')) {
-                return new Response(render(__DIR__ . '/../templates/token.html.php', [
-                    'message' => '',
-                ]), 401);
-            }
-            if (! hash_equals(Configuration::getConfig('authentication', 'token'), $request->attribute('token'))) {
-                return new Response(render(__DIR__ . '/../templates/token.html.php', [
-                    'message' => 'Invalid token',
-                ]), 401);
-            }
-        }
-
         $action = $request->get('action', 'Frontpage');
         $actionName = strtolower($action) . 'Action';
         $actionName = implode(array_map('ucfirst', explode('-', $actionName)));
@@ -77,11 +20,21 @@ final class RssBridge
             return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'Invalid action']), 400);
         }
 
-        $controller = self::$container[$actionName];
+        $handler = self::$container[$actionName];
 
-        $response = $controller($request);
-
-        return $response;
+        $middlewares = [
+            new SecurityMiddleware(),
+            new MaintenanceMiddleware(),
+            new BasicAuthMiddleware(),
+            new TokenAuthenticationMiddleware(),
+        ];
+        $action = function ($req) use ($handler) {
+            return $handler($req);
+        };
+        foreach (array_reverse($middlewares) as $middleware) {
+            $action = fn ($req) => $middleware($req, $action);
+        }
+        return $action($request);
     }
 
     public static function getLogger(): Logger
diff --git a/lib/bootstrap.php b/lib/bootstrap.php
index 1d866067..36b13e19 100644
--- a/lib/bootstrap.php
+++ b/lib/bootstrap.php
@@ -37,6 +37,7 @@ spl_autoload_register(function ($className) {
         __DIR__ . '/../caches/',
         __DIR__ . '/../formats/',
         __DIR__ . '/../lib/',
+        __DIR__ . '/../middlewares/',
     ];
     foreach ($folders as $folder) {
         $file = $folder . $className . '.php';
diff --git a/middlewares/BasicAuthMiddleware.php b/middlewares/BasicAuthMiddleware.php
new file mode 100644
index 00000000..6b0803e2
--- /dev/null
+++ b/middlewares/BasicAuthMiddleware.php
@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * HTTP Basic auth check
+ */
+class BasicAuthMiddleware implements Middleware
+{
+    public function __invoke(Request $request, $next): Response
+    {
+        if (!Configuration::getConfig('authentication', 'enable')) {
+            return $next($request);
+        }
+
+        if (Configuration::getConfig('authentication', 'password') === '') {
+            return new Response('The authentication password cannot be the empty string', 500);
+        }
+        $user = $request->server('PHP_AUTH_USER');
+        $password = $request->server('PHP_AUTH_PW');
+        if ($user === null || $password === null) {
+            $html = render(__DIR__ . '/../templates/error.html.php', [
+                'message' => 'Please authenticate in order to access this instance!',
+            ]);
+            return new Response($html, 401, ['WWW-Authenticate' => 'Basic realm="RSS-Bridge"']);
+        }
+        if (
+            (Configuration::getConfig('authentication', 'username') !== $user)
+            || (!hash_equals(Configuration::getConfig('authentication', 'password'), $password))
+        ) {
+            $html = render(__DIR__ . '/../templates/error.html.php', [
+                'message' => 'Please authenticate in order to access this instance!',
+            ]);
+            return new Response($html, 401, ['WWW-Authenticate' => 'Basic realm="RSS-Bridge"']);
+        }
+        return $next($request);
+    }
+}
diff --git a/middlewares/MaintenanceMiddleware.php b/middlewares/MaintenanceMiddleware.php
new file mode 100644
index 00000000..de8a1baf
--- /dev/null
+++ b/middlewares/MaintenanceMiddleware.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+class MaintenanceMiddleware implements Middleware
+{
+    public function __invoke(Request $request, $next): Response
+    {
+        if (!Configuration::getConfig('system', 'enable_maintenance_mode')) {
+            return $next($request);
+        }
+        return new Response(render(__DIR__ . '/../templates/error.html.php', [
+            'title' => '503 Service Unavailable',
+            'message' => 'RSS-Bridge is down for maintenance.',
+        ]), 503);
+    }
+}
diff --git a/middlewares/Middleware.php b/middlewares/Middleware.php
new file mode 100644
index 00000000..83d93a3b
--- /dev/null
+++ b/middlewares/Middleware.php
@@ -0,0 +1,8 @@
+<?php
+
+declare(strict_types=1);
+
+interface Middleware
+{
+    public function __invoke(Request $request, $next): Response;
+}
diff --git a/middlewares/SecurityMiddleware.php b/middlewares/SecurityMiddleware.php
new file mode 100644
index 00000000..b07a8144
--- /dev/null
+++ b/middlewares/SecurityMiddleware.php
@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * Make sure that only strings are allowed in GET parameters
+ */
+class SecurityMiddleware implements Middleware
+{
+    public function __invoke(Request $request, $next): Response
+    {
+        foreach ($request->toArray() as $key => $value) {
+            if (!is_string($value)) {
+                return new Response(render(__DIR__ . '/../templates/error.html.php', [
+                    'message' => "Query parameter \"$key\" is not a string.",
+                ]), 400);
+            }
+        }
+        return $next($request);
+    }
+}
diff --git a/middlewares/TokenAuthenticationMiddleware.php b/middlewares/TokenAuthenticationMiddleware.php
new file mode 100644
index 00000000..f8234629
--- /dev/null
+++ b/middlewares/TokenAuthenticationMiddleware.php
@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+class TokenAuthenticationMiddleware implements Middleware
+{
+    public function __invoke(Request $request, $next): Response
+    {
+        if (! Configuration::getConfig('authentication', 'token')) {
+            return $next($request);
+        }
+
+        // Always add token to request attribute
+        $request = $request->withAttribute('token', $request->get('token'));
+
+        if (! $request->attribute('token')) {
+            return new Response(render(__DIR__ . '/../templates/token.html.php', [
+                'message' => 'Missing token',
+            ]), 401);
+        }
+        if (! hash_equals(Configuration::getConfig('authentication', 'token'), $request->attribute('token'))) {
+            return new Response(render(__DIR__ . '/../templates/token.html.php', [
+                'message' => 'Invalid token',
+            ]), 401);
+        }
+
+        return $next($request);
+    }
+}

From 9f48370eb0fd5aba832b9db9eb9b1bc8915f5417 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 30 Aug 2024 00:22:11 +0200
Subject: [PATCH 480/716] fix: tweak caching logic (#4241)

---
 actions/DisplayAction.php | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index c00c0d5e..9749004f 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -125,17 +125,16 @@ class DisplayAction implements ActionInterface
                 return new Response(render(__DIR__ . '/../templates/exception.html.php', ['e' => $e]), 429);
             }
             if ($e instanceof HttpException) {
-                // Reproduce (and log) these responses regardless of error output and report limit
-                if ($e->getCode() === 429) {
-                    $this->logger->info(sprintf('Exception in DisplayAction(%s): %s', $bridge->getShortName(), create_sane_exception_message($e)));
-                    return new Response(render(__DIR__ . '/../templates/exception.html.php', ['e' => $e]), 429);
-                }
-                if ($e->getCode() === 503) {
-                    $this->logger->info(sprintf('Exception in DisplayAction(%s): %s', $bridge->getShortName(), create_sane_exception_message($e)));
-                    return new Response(render(__DIR__ . '/../templates/exception.html.php', ['e' => $e]), 503);
+                if (in_array($e->getCode(), [429, 503])) {
+                    // Log with debug, immediately reproduce and return
+                    $this->logger->debug(sprintf('Exception in DisplayAction(%s): %s', $bridge->getShortName(), create_sane_exception_message($e)));
+                    return new Response(render(__DIR__ . '/../templates/exception.html.php', ['e' => $e]), $e->getCode());
                 }
+                // Some other status code which we let fail normally (but don't log it)
+            } else {
+                // Log error if it's not an HttpException
+                $this->logger->error(sprintf('Exception in DisplayAction(%s)', $bridge->getShortName()), ['e' => $e]);
             }
-            $this->logger->error(sprintf('Exception in DisplayAction(%s)', $bridge->getShortName()), ['e' => $e]);
             $errorOutput = Configuration::getConfig('error', 'output');
             $reportLimit = Configuration::getConfig('error', 'report_limit');
             $errorCount = 1;

From 3e1a8b29d95fe7fc0120e813ab623720ae056b8b Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 30 Aug 2024 02:29:51 +0200
Subject: [PATCH 481/716] fix: extract duplicate config loading (#4242)

Also fix a problem with bin/cache-prune and FileCache and its enable_purge option
---
 actions/DisplayAction.php |  4 +++-
 bin/cache-clear           | 11 +---------
 bin/cache-prune           | 20 +++++++++----------
 bin/test                  | 11 +---------
 caches/FileCache.php      |  2 ++
 index.php                 | 13 ++----------
 lib/Configuration.php     | 42 ++++-----------------------------------
 lib/config.php            | 13 ++++++++++++
 8 files changed, 36 insertions(+), 80 deletions(-)
 create mode 100644 lib/config.php

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 9749004f..bda45558 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -89,7 +89,9 @@ class DisplayAction implements ActionInterface
             $this->cache->set($cacheKey, $response, 60 * 15);
         }
 
-        if (rand(1, 100) === 2) {
+        // For 1% of requests, prune cache
+        if (rand(1, 100) === 1) {
+            // This might be resource intensive!
             $this->cache->prune();
         }
 
diff --git a/bin/cache-clear b/bin/cache-clear
index 71466360..c8f53122 100755
--- a/bin/cache-clear
+++ b/bin/cache-clear
@@ -6,16 +6,7 @@
  */
 
 require __DIR__ . '/../lib/bootstrap.php';
-
-$config = [];
-if (file_exists(__DIR__ . '/../config.ini.php')) {
-    $config = parse_ini_file(__DIR__ . '/../config.ini.php', true, INI_SCANNER_TYPED);
-    if (!$config) {
-        http_response_code(500);
-        exit("Error parsing config.ini.php\n");
-    }
-}
-Configuration::loadConfiguration($config, getenv());
+require __DIR__ . '/../lib/config.php';
 
 $container = require __DIR__ . '/../lib/dependencies.php';
 
diff --git a/bin/cache-prune b/bin/cache-prune
index 37696e14..755ed8d5 100755
--- a/bin/cache-prune
+++ b/bin/cache-prune
@@ -6,19 +6,19 @@
  */
 
 require __DIR__ . '/../lib/bootstrap.php';
-
-$config = [];
-if (file_exists(__DIR__ . '/../config.ini.php')) {
-    $config = parse_ini_file(__DIR__ . '/../config.ini.php', true, INI_SCANNER_TYPED);
-    if (!$config) {
-        http_response_code(500);
-        exit("Error parsing config.ini.php\n");
-    }
-}
-Configuration::loadConfiguration($config, getenv());
+require __DIR__ . '/../lib/config.php';
 
 $container = require __DIR__ . '/../lib/dependencies.php';
 
+/** @var CacheInterface $cache */
 $cache = $container['cache'];
 
+if (
+    Configuration::getConfig('cache', 'type') === 'file'
+    && !Configuration::getConfig('FileCache', 'enable_purge')
+) {
+    // Override enable_purge for this execution
+    Configuration::setConfig('FileCache', 'enable_purge', true);
+}
+
 $cache->prune();
diff --git a/bin/test b/bin/test
index f3556fc1..74692410 100755
--- a/bin/test
+++ b/bin/test
@@ -6,16 +6,7 @@
  */
 
 require __DIR__ . '/../lib/bootstrap.php';
-
-$config = [];
-if (file_exists(__DIR__ . '/../config.ini.php')) {
-    $config = parse_ini_file(__DIR__ . '/../config.ini.php', true, INI_SCANNER_TYPED);
-    if (!$config) {
-        http_response_code(500);
-        exit("Error parsing config.ini.php\n");
-    }
-}
-Configuration::loadConfiguration($config, getenv());
+require __DIR__ . '/../lib/config.php';
 
 $container = require __DIR__ . '/../lib/dependencies.php';
 
diff --git a/caches/FileCache.php b/caches/FileCache.php
index 7a0eb81d..dfd295e8 100644
--- a/caches/FileCache.php
+++ b/caches/FileCache.php
@@ -97,8 +97,10 @@ class FileCache implements CacheInterface
             }
             $expiration = $item['expiration'] ?? time();
             if ($expiration === 0 || $expiration > time()) {
+                // Cached forever, or not expired yet
                 continue;
             }
+            // Expired, so delete file
             unlink($cacheFile);
         }
     }
diff --git a/index.php b/index.php
index 7b441944..e67b0c9f 100644
--- a/index.php
+++ b/index.php
@@ -5,17 +5,8 @@ if (version_compare(\PHP_VERSION, '7.4.0') === -1) {
     exit("RSS-Bridge requires minimum PHP version 7.4\n");
 }
 
-require_once __DIR__ . '/lib/bootstrap.php';
-
-$config = [];
-if (file_exists(__DIR__ . '/config.ini.php')) {
-    $config = parse_ini_file(__DIR__ . '/config.ini.php', true, INI_SCANNER_TYPED);
-    if (!$config) {
-        http_response_code(500);
-        exit("Error parsing config.ini.php\n");
-    }
-}
-Configuration::loadConfiguration($config, getenv());
+require __DIR__ . '/lib/bootstrap.php';
+require __DIR__ . '/lib/config.php';
 
 $container = require __DIR__ . '/lib/dependencies.php';
 
diff --git a/lib/Configuration.php b/lib/Configuration.php
index b104a251..44fd3612 100644
--- a/lib/Configuration.php
+++ b/lib/Configuration.php
@@ -15,43 +15,6 @@ final class Configuration
     {
     }
 
-    public static function checkInstallation(): array
-    {
-        $errors = [];
-
-        // OpenSSL: https://www.php.net/manual/en/book.openssl.php
-        if (!extension_loaded('openssl')) {
-            $errors[] = 'openssl extension not loaded';
-        }
-
-        // libxml: https://www.php.net/manual/en/book.libxml.php
-        if (!extension_loaded('libxml')) {
-            $errors[] = 'libxml extension not loaded';
-        }
-
-        // Multibyte String (mbstring): https://www.php.net/manual/en/book.mbstring.php
-        if (!extension_loaded('mbstring')) {
-            $errors[] = 'mbstring extension not loaded';
-        }
-
-        // SimpleXML: https://www.php.net/manual/en/book.simplexml.php
-        if (!extension_loaded('simplexml')) {
-            $errors[] = 'simplexml extension not loaded';
-        }
-
-        // Client URL Library (curl): https://www.php.net/manual/en/book.curl.php
-        // Allow RSS-Bridge to run without curl module in CLI mode without root certificates
-        if (!extension_loaded('curl') && !(php_sapi_name() === 'cli' && empty(ini_get('curl.cainfo')))) {
-            $errors[] = 'curl extension not loaded';
-        }
-
-        // JavaScript Object Notation (json): https://www.php.net/manual/en/book.json.php
-        if (!extension_loaded('json')) {
-            $errors[] = 'json extension not loaded';
-        }
-        return $errors;
-    }
-
     public static function loadConfiguration(array $customConfig = [], array $env = [])
     {
         if (!file_exists(__DIR__ . '/../config.default.ini.php')) {
@@ -204,7 +167,10 @@ final class Configuration
         return self::$config[strtolower($section)][strtolower($key)] ?? $default;
     }
 
-    private static function setConfig(string $section, string $key, $value): void
+    /**
+     * @internal Please avoid usage
+     */
+    public static function setConfig(string $section, string $key, $value): void
     {
         self::$config[strtolower($section)][strtolower($key)] = $value;
     }
diff --git a/lib/config.php b/lib/config.php
new file mode 100644
index 00000000..4ff72565
--- /dev/null
+++ b/lib/config.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+$config = [];
+if (file_exists(__DIR__ . '/../config.ini.php')) {
+    $config = parse_ini_file(__DIR__ . '/../config.ini.php', true, INI_SCANNER_TYPED);
+    if (!$config) {
+        http_response_code(500);
+        exit("Error parsing config.ini.php\n");
+    }
+}
+Configuration::loadConfiguration($config, getenv());

From bb2f471a03211a2ebe53de67c14bc3ef97803715 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 30 Aug 2024 02:44:50 +0200
Subject: [PATCH 482/716] fix: bug in prior fix (#4243)

Have to tweak the config BEFORE instantiating of course
---
 bin/cache-clear | 1 +
 bin/cache-prune | 8 ++++----
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/bin/cache-clear b/bin/cache-clear
index c8f53122..2ca84ce6 100755
--- a/bin/cache-clear
+++ b/bin/cache-clear
@@ -10,6 +10,7 @@ require __DIR__ . '/../lib/config.php';
 
 $container = require __DIR__ . '/../lib/dependencies.php';
 
+/** @var CacheInterface $cache */
 $cache = $container['cache'];
 
 $cache->clear();
diff --git a/bin/cache-prune b/bin/cache-prune
index 755ed8d5..bb72c4ac 100755
--- a/bin/cache-prune
+++ b/bin/cache-prune
@@ -10,15 +10,15 @@ require __DIR__ . '/../lib/config.php';
 
 $container = require __DIR__ . '/../lib/dependencies.php';
 
-/** @var CacheInterface $cache */
-$cache = $container['cache'];
-
 if (
     Configuration::getConfig('cache', 'type') === 'file'
     && !Configuration::getConfig('FileCache', 'enable_purge')
 ) {
-    // Override enable_purge for this execution
+    // Override enable_purge for this particular execution
     Configuration::setConfig('FileCache', 'enable_purge', true);
 }
 
+/** @var CacheInterface $cache */
+$cache = $container['cache'];
+
 $cache->prune();

From 6a24e53d6ca4fbfb3115a8cb30a51283684f0f20 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 30 Aug 2024 04:21:51 +0200
Subject: [PATCH 483/716] refactor (#4244)

---
 bridges/AO3Bridge.php                      | 32 +++++++++++---------
 bridges/BMDSystemhausBlogBridge.php        |  5 ++--
 bridges/TwitchBridge.php                   | 22 +++++++-------
 docs/09_Technical_recommendations/index.md | 34 ++++++++++++----------
 lib/FeedItem.php                           |  5 +++-
 lib/RssBridge.php                          | 22 ++------------
 lib/contents.php                           | 15 ++++++++--
 7 files changed, 69 insertions(+), 66 deletions(-)

diff --git a/bridges/AO3Bridge.php b/bridges/AO3Bridge.php
index 4c09c28c..970ed414 100644
--- a/bridges/AO3Bridge.php
+++ b/bridges/AO3Bridge.php
@@ -68,12 +68,13 @@ class AO3Bridge extends BridgeAbstract
      */
     private function collectList($url)
     {
-        $httpClient = RssBridge::getHttpClient();
         $version = 'v0.0.1';
-        $agent = ['useragent' => "rss-bridge $version (https://github.com/RSS-Bridge/rss-bridge)"];
+        $headers = [
+            "useragent: rss-bridge $version (https://github.com/RSS-Bridge/rss-bridge)"
+        ];
+        $response = getContents($url, $headers);
 
-        $response = $httpClient->request($url, $agent);
-        $html = \str_get_html($response->getBody());
+        $html = \str_get_html($response);
         $html = defaultLinkTo($html, self::URI);
 
         // Get list title. Will include page range + count in some cases
@@ -128,14 +129,15 @@ class AO3Bridge extends BridgeAbstract
                     case ('last'):
                         // only way to get this is using the navigate page unfortunately
                         $url .= '/navigate';
-                        $response = $httpClient->request($url, $agent);
-                        $html = \str_get_html($response->getBody());
+                        $response = getContents($url, $headers);
+                        $html = \str_get_html($response);
                         $html = defaultLinkTo($html, self::URI);
                         $url = $html->find('ol.index.group > li > a', -1)->href;
                         break;
                 }
-                $response = $httpClient->request($url, $agent);
-                $html = \str_get_html($response->getBody());
+                $response = getContents($url, $headers);
+
+                $html = \str_get_html($response);
                 $html = defaultLinkTo($html, self::URI);
                 // remove duplicate fic summary
                 if ($ficsum = $html->find('#workskin > .preface > .summary', 0)) {
@@ -159,16 +161,18 @@ class AO3Bridge extends BridgeAbstract
      */
     private function collectWork($url)
     {
-        $httpClient = RssBridge::getHttpClient();
         $version = 'v0.0.1';
-        $agent = ['useragent' => "rss-bridge $version (https://github.com/RSS-Bridge/rss-bridge)"];
+        $headers = [
+            "useragent: rss-bridge $version (https://github.com/RSS-Bridge/rss-bridge)"
+        ];
+        $response = getContents($url . '/navigate', $headers);
 
-        $response = $httpClient->request($url . '/navigate', $agent);
-        $html = \str_get_html($response->getBody());
+        $html = \str_get_html($response);
         $html = defaultLinkTo($html, self::URI);
 
-        $response = $httpClient->request($url . '?view_full_work=true', $agent);
-        $workhtml = \str_get_html($response->getBody());
+        $response = getContents($url . '?view_full_work=true', $headers);
+
+        $workhtml = \str_get_html($response);
         $workhtml = defaultLinkTo($workhtml, self::URI);
 
         $this->title = $html->find('h2 a', 0)->plaintext;
diff --git a/bridges/BMDSystemhausBlogBridge.php b/bridges/BMDSystemhausBlogBridge.php
index 12f3ca5e..98fb2d63 100644
--- a/bridges/BMDSystemhausBlogBridge.php
+++ b/bridges/BMDSystemhausBlogBridge.php
@@ -54,7 +54,7 @@ class BMDSystemhausBlogBridge extends BridgeAbstract
     public function collectData()
     {
         // get website content
-        $html = getSimpleHTMLDOM($this->getURI()) or returnServerError('No contents received!');
+        $html = getSimpleHTMLDOM($this->getURI());
 
         // Convert relative links in HTML into absolute links
         $html = defaultLinkTo($html, self::URI);
@@ -207,7 +207,8 @@ class BMDSystemhausBlogBridge extends BridgeAbstract
     //-----------------------------------------------------
     public function getURI()
     {
-        $lURI = $this->getURIbyCountry($this->getInput('country'));
+        $country = $this->getInput('country') ?? '';
+        $lURI = $this->getURIbyCountry($country);
         return $lURI != '' ? $lURI : parent::getURI();
     }
 
diff --git a/bridges/TwitchBridge.php b/bridges/TwitchBridge.php
index c273aaca..6605a973 100644
--- a/bridges/TwitchBridge.php
+++ b/bridges/TwitchBridge.php
@@ -196,23 +196,21 @@ EOD;
     // e.g. 01:53:27
     private function formatTimestampTime($seconds)
     {
-        return sprintf(
-            '%02d:%02d:%02d',
-            floor($seconds / 3600),
-            ($seconds / 60) % 60,
-            $seconds % 60
-        );
+        $floor = floor($seconds / 3600);
+        $i = intval($seconds / 60) % 60;
+        $i1 = $seconds % 60;
+
+        return sprintf('%02d:%02d:%02d', $floor, $i, $i1);
     }
 
     // e.g. 01h53m27s
     private function formatQueryTime($seconds)
     {
-        return sprintf(
-            '%02dh%02dm%02ds',
-            floor($seconds / 3600),
-            ($seconds / 60) % 60,
-            $seconds % 60
-        );
+        $floor = floor($seconds / 3600);
+        $i = intval($seconds / 60) % 60;
+        $i1 = $seconds % 60;
+
+        return sprintf('%02dh%02dm%02ds', $floor, $i, $i1);
     }
 
     /**
diff --git a/docs/09_Technical_recommendations/index.md b/docs/09_Technical_recommendations/index.md
index a57f0bbd..c564418e 100644
--- a/docs/09_Technical_recommendations/index.md
+++ b/docs/09_Technical_recommendations/index.md
@@ -1,28 +1,32 @@
 ## General recommendations
 
-* Use [HTTPS](https://en.wikipedia.org/wiki/HTTPS) (`https://...`) over [HTTP](https://en.wikipedia.org/wiki/HTTPS) (`http://...`) whenever possible
-
 ## Test a site before building a bridge
 
-Some sites make use of anti-bot mechanisms (e.g.: by using JavaScript) in which case they work fine in regular browsers, but not in the PHP environment. To check if a site works with RSS-Bridge, create a new bridge using the [template](../05_Bridge_API/02_BridgeAbstract.md#template) and load a valid URL (not the base URL!).
+Some sites make use of anti-bot mechanisms (e.g.: by using JavaScript) in which case they work fine in regular browsers,
+but not in the PHP environment.
+
+To check if a site works with RSS-Bridge, create a new bridge using the 
+[template](../05_Bridge_API/02_BridgeAbstract.md#template)
+and load a valid URL (not the base URL!).
 
 **Example (using github.com)**
 
 ```PHP
 <?php
-class TestBridge extends BridgeAbstract {
-	const NAME = 'Unnamed bridge';
-	const URI = '';
-	const DESCRIPTION = 'No description provided';
-	const MAINTAINER = 'No maintainer';
-	const PARAMETERS = [];
-	const CACHE_TIMEOUT = 3600;
+class TestBridge extends BridgeAbstract
+{
+    const NAME = 'Unnamed bridge';
+    const URI = '';
+    const DESCRIPTION = 'No description provided';
+    const MAINTAINER = 'No maintainer';
+    const PARAMETERS = [];
+    const CACHE_TIMEOUT = 3600;
 
-	public function collectData(){
-		$html = getSimpleHTMLDOM('https://github.com/rss-bridge/rss-bridge')
-			or returnServerError('No contents received!');
-	}
+    public function collectData()
+    {
+        $html = getSimpleHTMLDOM('https://github.com/rss-bridge/rss-bridge');
+    }
 }
 ```
 
-This bridge should return an empty page (HTML format)
\ No newline at end of file
+This bridge should return an empty page (HTML format)
diff --git a/lib/FeedItem.php b/lib/FeedItem.php
index 8c9a60b1..e94348f7 100644
--- a/lib/FeedItem.php
+++ b/lib/FeedItem.php
@@ -25,7 +25,10 @@ class FeedItem
 
     private function __construct()
     {
-        $this->logger = RssBridge::getLogger();
+        global $container;
+
+        // The default NullLogger is for when running the unit tests
+        $this->logger = $container['logger'] ?? new NullLogger();
     }
 
     public function __set($name, $value)
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index 230488bf..5e90fb13 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -2,12 +2,12 @@
 
 final class RssBridge
 {
-    private static Container $container;
+    private Container $container;
 
     public function __construct(
         Container $container
     ) {
-        self::$container = $container;
+        $this->container = $container;
     }
 
     public function main(Request $request): Response
@@ -20,7 +20,7 @@ final class RssBridge
             return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'Invalid action']), 400);
         }
 
-        $handler = self::$container[$actionName];
+        $handler = $this->container[$actionName];
 
         $middlewares = [
             new SecurityMiddleware(),
@@ -36,20 +36,4 @@ final class RssBridge
         }
         return $action($request);
     }
-
-    public static function getLogger(): Logger
-    {
-        // null logger is only for the tests not to fail
-        return self::$container['logger'] ?? new NullLogger();
-    }
-
-    public static function getCache(): CacheInterface
-    {
-        return self::$container['cache'];
-    }
-
-    public static function getHttpClient(): HttpClient
-    {
-        return self::$container['http_client'];
-    }
 }
diff --git a/lib/contents.php b/lib/contents.php
index cc9542a9..56a3db20 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -14,8 +14,13 @@ function getContents(
     array $curlOptions = [],
     bool $returnFull = false
 ) {
-    $httpClient = RssBridge::getHttpClient();
-    $cache = RssBridge::getCache();
+    global $container;
+
+    /** @var HttpClient $httpClient */
+    $httpClient = $container['http_client'];
+
+    /** @var CacheInterface $cache */
+    $cache = $container['cache'];
 
     // TODO: consider url validation at this point
 
@@ -212,7 +217,11 @@ function getSimpleHTMLDOMCached(
     $defaultBRText = DEFAULT_BR_TEXT,
     $defaultSpanText = DEFAULT_SPAN_TEXT
 ) {
-    $cache = RssBridge::getCache();
+    global $container;
+
+    /** @var CacheInterface $cache */
+    $cache = $container['cache'];
+
     $cacheKey = 'pages_' . $url;
     $content = $cache->get($cacheKey);
     if (!$content) {

From 9cabf60144c843e4de21ec348cb88d8304604f13 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 30 Aug 2024 04:37:40 +0200
Subject: [PATCH 484/716] docs

* refactor

* docs
---
 docs/01_General/03_Requirements.md            |  11 --
 docs/01_General/05_FAQ.md                     |  29 ++---
 docs/02_CLI/index.md                          |  22 ++--
 docs/03_For_Hosts/01_Installation.md          |  11 +-
 docs/03_For_Hosts/02_Updating.md              |  38 -------
 docs/03_For_Hosts/06_Authentication.md        | 105 +-----------------
 docs/03_For_Hosts/07_Customizations.md        |  15 ++-
 docs/03_For_Hosts/08_Custom_Configuration.md  |  13 ++-
 docs/03_For_Hosts/index.md                    |   6 +-
 .../01_How_to_create_a_new_bridge.md          |   3 +-
 docs/05_Bridge_API/02_BridgeAbstract.md       |   7 +-
 11 files changed, 64 insertions(+), 196 deletions(-)

diff --git a/docs/01_General/03_Requirements.md b/docs/01_General/03_Requirements.md
index 617cfadc..c9c91a52 100644
--- a/docs/01_General/03_Requirements.md
+++ b/docs/01_General/03_Requirements.md
@@ -1,14 +1,3 @@
 
 
   - PHP 7.4 (or higher)
-  - [`openssl`](https://secure.php.net/manual/en/book.openssl.php) extension
-  - [`libxml`](https://secure.php.net/manual/en/book.libxml.php) extension (enabled by default, see [PHP Manual](http://php.net/manual/en/libxml.installation.php))
-  - [`mbstring`](https://secure.php.net/manual/en/book.mbstring.php) extension
-  - [`simplexml`](https://secure.php.net/manual/en/book.simplexml.php) extension
-  - [`curl`](https://secure.php.net/manual/en/book.curl.php) extension
-  - [`json`](https://secure.php.net/manual/en/book.json.php) extension
-  - [`filter`](https://secure.php.net/manual/en/book.filter.php) extension
-  - [`zip`](https://secure.php.net/manual/en/book.zip.php) (for some bridges)
-  - [`sqlite3`](http://php.net/manual/en/book.sqlite3.php) extension (only when using SQLiteCache)
-
-Enable extensions by un-commenting the corresponding line in your PHP configuration (`php.ini`).
diff --git a/docs/01_General/05_FAQ.md b/docs/01_General/05_FAQ.md
index ade746d7..19cfae4b 100644
--- a/docs/01_General/05_FAQ.md
+++ b/docs/01_General/05_FAQ.md
@@ -1,30 +1,33 @@
-This page provides a collection of frequently asked questions and their answers. Please check this page before opening a new Issue :revolving_hearts:
-
-* [Why doesn't my bridge show new contents?](#why-doesnt-my-bridge-show-new-contents)
-* [How can I make a bridge update more frequently?](#how-can-i-make-a-bridge-update-more-frequently)
-* [Firefox doesn't show feeds anymore, what can I do?](#firefox-doesnt-show-feeds-anymore-what-can-i-do)
-
 ## Why doesn't my bridge show new contents?
 
-RSS-Bridge creates a cached version of your feed in order to reduce traffic and respond faster. The cached version is created on the first request and served for all subsequent requests. On every request RSS-Bridge checks if the cache timeout has elapsed. If the timeout has elapsed, it loads new contents and updates the cached version.
+RSS-Bridge creates a cached version of your feed in order to reduce traffic and respond faster.
+The cached version is created on the first request and served for all subsequent requests.
+On every request RSS-Bridge checks if the cache timeout has elapsed.
+If the timeout has elapsed, it loads new contents and updates the cached version.
 
-_Notice_: RSS-Bridge only updates feeds if you actively request it, for example by pressing F5 in your browser or using a feed reader.
+_Notice_: RSS-Bridge only updates feeds if you actively request it,
+for example by pressing F5 in your browser or using a feed reader.
 
-The cache duration is bridge specific and can last anywhere between five minutes and 24 hours. You can specify a custom cache timeout for each bridge if [this option](#how-can-i-make-a-bridge-update-more-frequently) has been enabled on the server.
+The cache duration is bridge specific (usually `1h`)
+You can specify a custom cache timeout for each bridge if 
+[this option](#how-can-i-make-a-bridge-update-more-frequently) has been enabled on the server.
 
 ## How can I make a bridge update more frequently?
 
 You can only do that if you are hosting the RSS-Bridge instance:
+- Lower the bridge ttl: `CACHE_TIMEOUT` constant
 - Enable [`custom_timeout`](../03_For_Hosts/08_Custom_Configuration.md#customtimeout)
-- Alternatively, change the default timeout for your bridge by modifying the `CACHE_TIMEOUT` constant in the relevant bridge file (e.g [here](https://github.com/RSS-Bridge/rss-bridge/blob/master/bridges/FilterBridge.php#L7) for the Filter Bridge).
 
 ## Firefox doesn't show feeds anymore, what can I do?
 
-As of version 64, Firefox removed support for viewing Atom and RSS feeds in the browser. This results in the browser downloading the pages instead of showing contents.
+As of version 64, Firefox removed support for viewing Atom and RSS feeds in the browser.
+This results in the browser downloading the pages instead of showing contents.
 
 Further reading:
 - https://support.mozilla.org/en-US/kb/feed-reader-replacements-firefox
 - https://bugzilla.mozilla.org/show_bug.cgi?id=1477667
 
-To restore the original behavior in Firefox 64 or higher you can use following Add-on which attempts to recreate the original behavior (with some sugar on top):
-- https://addons.mozilla.org/en-US/firefox/addon/rsspreview/
\ No newline at end of file
+To restore the original behavior in Firefox 64 or higher you can use following Add-on
+which attempts to recreate the original behavior (with some sugar on top):
+
+- https://addons.mozilla.org/en-US/firefox/addon/rsspreview/
diff --git a/docs/02_CLI/index.md b/docs/02_CLI/index.md
index 9292746a..727e59cb 100644
--- a/docs/02_CLI/index.md
+++ b/docs/02_CLI/index.md
@@ -1,10 +1,12 @@
-RSS-Bridge supports calls via CLI. You can use the same parameters as you would normally use via the URI. Example:
+RSS-Bridge supports calls via CLI.
+You can use the same parameters as you would normally use via the URI. Example:
 
 `php index.php action=display bridge=DansTonChat format=Json`
 
 ## Required parameters
 
-RSS-Bridge requires a few parameters that must be specified on every call. Omitting these parameters will result in error messages:
+RSS-Bridge requires a few parameters that must be specified on every call.
+Omitting these parameters will result in error messages:
 
 ### action
 
@@ -17,20 +19,26 @@ Value | Description
 
 ### bridge
 
-This parameter specifies the name of the bridge RSS-Bridge should return feeds from. The name of the bridge equals the class name of the bridges in the ./bridges/ folder without the 'Bridge' prefix. For example: DansTonChatBridge => DansTonChat.
+This parameter specifies the name of the bridge RSS-Bridge should return feeds from.
+The name of the bridge equals the class name of the bridges in the ./bridges/ folder without the 'Bridge' prefix.
+For example: DansTonChatBridge => DansTonChat.
 
 ### format
 
-This parameter specifies the format in which RSS-Bridge returns the contents. RSS-Bridge currently supports five formats: `Atom`, `Html`, `Json`, `Mrss`and `Plaintext`.
+This parameter specifies the format in which RSS-Bridge returns the contents.
 
 ## Optional parameters
 
-RSS-Bridge supports optional parameters. These parameters are only valid if the options have been enabled in the index.php script.
+RSS-Bridge supports optional parameters.
+These parameters are only valid if the options have been enabled in the index.php script.
 
 ### \_noproxy
 
-This parameter is only available if a proxy server has been specified via `proxy.url` and `proxy.by_bridge` has been enabled. This is a Boolean parameter that can be set to `true` or `false`.
+This parameter is only available if a proxy server has been specified via `proxy.url` and `proxy.by_bridge`
+has been enabled. This is a Boolean parameter that can be set to `true` or `false`.
 
 ## Bridge parameters
 
-Each bridge can specify its own set of parameters. As in the example above, some bridges don't specify any parameters or only optional parameters that can be neglected. For more details read the `PARAMETERS` definition for your bridge.
\ No newline at end of file
+Each bridge can specify its own set of parameters.
+As in the example above, some bridges don't specify any parameters or only optional parameters that can be neglected.
+For more details read the `PARAMETERS` definition for your bridge.
diff --git a/docs/03_For_Hosts/01_Installation.md b/docs/03_For_Hosts/01_Installation.md
index 729e6abb..3312230d 100644
--- a/docs/03_For_Hosts/01_Installation.md
+++ b/docs/03_For_Hosts/01_Installation.md
@@ -1,10 +1 @@
-In order to install RSS-Bridge on your own web server* do as follows:
-
-* Make sure your web server meets all [requirements](../01_General/03_Requirements.md)
-* Download the ZIP file of the [last stable release](https://github.com/RSS-Bridge/rss-bridge/releases)
-* Place all files on your web server
-
-For linux hosts:
-* Grant read-write-access for `www-data` to the `./cache` directory (`chown -R www-data ./cache`)
-
-You have successfully installed RSS-Bridge.
\ No newline at end of file
+https://github.com/RSS-Bridge/rss-bridge/blob/master/README.md
diff --git a/docs/03_For_Hosts/02_Updating.md b/docs/03_For_Hosts/02_Updating.md
index 3484c6dc..e69de29b 100644
--- a/docs/03_For_Hosts/02_Updating.md
+++ b/docs/03_For_Hosts/02_Updating.md
@@ -1,38 +0,0 @@
-Updating an existing installation is very simple, depending on your type of installation.
-
-## Release Build
-
-* Download latest version
-* Extract all files
-* Replace existing files
-
-This will update all core files to the latest version. Your custom configuration and bridges are left untouched. Keep in mind that changes to any core file of RSS-Bridge will be replaced.
-
-## Heroku
-
-### If you didn't fork the repo before
-
-Fork the repo by clicking the `Fork` button at the top right of this page (must be on desktop site). Then on your Heroku account, go to the application. Click on the `Deploy` tab and connect the repo named `yourusername/rss-bridge`. Do a manual deploy of the `master` branch.
-
-### If you forked the repo before
-
-[Click here to create a new pull request to your fork](https://github.com/RSS-Bridge/rss-bridge/pull/new/master). Select `compare across forks`, make the base repository `yourusername/rss-bridge` and ensure the branch is set to master. Put any title you want and create the pull request. On the page that comes after this, merge the pull request.
-
-You then want to go to your application in Heroku, connect your fork via the `Deploy` tab and deploy the `master` branch.
-
-You can turn on auto-deploy for the master branch if you don't want to go through the process of logging into Heroku and deploying the branch every time changes to the repo are made in the future. 
-
-## Git
-
-To get the latest changes from the master branch
-
-```
-git pull
-```
-
-To use a specific tag
-
-```
-git fetch --all
-git checkout tags/<tag-name>
-```
\ No newline at end of file
diff --git a/docs/03_For_Hosts/06_Authentication.md b/docs/03_For_Hosts/06_Authentication.md
index bb9c6656..f505f5a6 100644
--- a/docs/03_For_Hosts/06_Authentication.md
+++ b/docs/03_For_Hosts/06_Authentication.md
@@ -1,101 +1,6 @@
-Depending on your servers abilities you can choose between two types of authentication:
 
-* [.htaccess](#htaccess)
-* [RSS-Bridge Authentication](#rss-bridge-authentication)
-
-**General advice**:
-
-- Make sure to use a strong password, no matter which solution you choose!
-- Enable HTTPS on your server to ensure your connection is encrypted and secure!
-
-## .htaccess
-
-.htaccess files are commonly used to restrict access to files on a web server. One of the features of .htaccess files is the ability to password protect specific (or all) directories. If setup correctly, a password is required to access the files.
-
-The usage of .htaccess files requires three basic steps:
-
-1) [Enable .htaccess](#enable-htaccess)
-2) [Create a .htpasswd file](#create-a-htpasswd-file)
-3) [Create a .htaccess file](#create-a-htaccess-file)
-
-### Enable .htaccess
-
-This process depends on the server you are using. Some providers may require you to change some settings, or place/change some file. Here are some helpful links for your server (please add your own if missing :sparkling_heart:)
-
-- Apache: http://ask.xmodulo.com/enable-htaccess-apache.html
-
-### Create a .htpasswd file
-
-The `.htpasswd` file contains the user name and password used for login to your web server. Please notice that the password is stored in encrypted form, which requires you to encrypt your password before creating the `.htpasswd` file!
-
-Here are three ways of creating your own `.htpasswd` file:
-
-**1) Example file**
-
-Example `.htpasswd` file (user name: "test", password: "test"):
-
-```.htpasswd
-test:$apr1$a52u9ILP$XTNG8qMJiEXSm1zD0lQcR0
-```
-
-Just copy and paste the contents to your `.htpasswd` file.
-
-**2) Online generator (read warning!)**
-
-You can create your own `.htpasswd` file online using a `.htpasswd` generator like this: https://www.htaccesstools.com/htpasswd-generator/
-
-**WARNING!**
-- Never insert real passwords to an online generator!
-
-**3) Generate your own password**
-
-Another way to create your own `.htpasswd` file is to run this script on your server (it'll output the data for you, you just have to paste it int a `.htpasswd` file):
-
-```PHP
-<?php
-// Password to be encrypted for a .htpasswd file
-$clearTextPassword = 'some password';
-
-// Encrypt password
-$password = crypt($clearTextPassword, base64_encode($clearTextPassword));
-
-// Print encrypted password
-echo $password;
-?>
-```
-
->source: https://www.htaccesstools.com/articles/create-password-for-htpasswd-file-using-php/
-
-### Create a .htaccess file
-
-The `.htaccess` file is used to specify which directories are password protected. For that purpose you should place the file in whatever directory you want to restrict access. If you want to restrict access to RSS-Bridge in general, you should place the file in the root directory (where `index.php` is located).
-
-Two parameters must be specified in the `.htaccess` file:
-
-* AuthName
-* AuthUserFile
-
-`AuthName` specifies the name of the authentication (i.e. "RSS-Bridge"). `AuthUserFile` defines the **absolute** path to a `.htpasswd` file.
-
-Here are two ways of creating your own `.htaccess` file:
-
-**1) Example file**
-
-```.htaccess
-AuthType Basic
-AuthName "My Protected Area"
-AuthUserFile /path/to/.htpasswd
-Require valid-user
-```
-
-Notice: You must change the `AuthUserFile` location to fit your own server (i.e. `/var/www/html/rss-bridge/.htpasswd`)
-
-**2) Online generator**
-
-You can use an online generator to create the file for you and copy-paste it to your `.htaccess` file: https://www.htaccesstools.com/htaccess-authentication/
-
-## RSS-Bridge Authentication
-
-RSS-Bridge ships with an authentication module designed for single user environments. You can enable authentication and specify the username & password in the [configuration file](../03_For_Hosts/08_Custom_Configuration.md#authentication).
-
-Please notice that the password is stored in plain text and thus is readable to anyone who can access the file. Make sure to restrict access to the file, so that it cannot be read remotely!
\ No newline at end of file
+* http basic auth
+* token
+* Access control via webserver (see nginx/caddy/apache docs)
+ 
+https://github.com/RSS-Bridge/rss-bridge/blob/master/README.md
diff --git a/docs/03_For_Hosts/07_Customizations.md b/docs/03_For_Hosts/07_Customizations.md
index be4c7f85..380f5f3a 100644
--- a/docs/03_For_Hosts/07_Customizations.md
+++ b/docs/03_For_Hosts/07_Customizations.md
@@ -1,9 +1,14 @@
-RSS-Bridge ships a few options the host may or may not activate. All options are listed in the [config.default.ini.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/config.default.ini.php) file, see [Custom Configuration](08_Custom_Configuration.md) section for more information.
+RSS-Bridge ships a few options the host may or may not activate.
+All options are listed in the [config.default.ini.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/config.default.ini.php) file,
+see [Custom Configuration](08_Custom_Configuration.md) section for more information.
 
 ## Customizable cache timeout
 
-Sometimes it is necessary to specify custom timeouts to update contents more frequently than the bridge maintainer intended. In these cases the client may specify a custom cache timeout to prevent loading contents from cache earlier (or later).
+Sometimes it is necessary to specify custom timeouts to update contents more frequently
+than the bridge maintainer intended.
+In these cases the client may specify a custom cache timeout to prevent loading contents
+from cache earlier (or later).
 
-This option can be activated by setting the [`cache.custom_timeout`](08_Custom_Configuration.md#custom_timeout) option to `true`. When enabled each bridge receives an additional parameter `Cache timeout in seconds` that can be set to any value between 1 and 86400 (24 hours). If the value is not within the limits the default settings apply (as specified by the bridge maintainer).
-
-The cache timeout is send to RSS-Bridge using the `_cache_timeout` parameter. RSS-Bridge will return an error message if the parameter is received and the option is disabled.
+This option can be activated by setting the [`cache.custom_timeout`](08_Custom_Configuration.md#custom_timeout) option to `true`.
+When enabled each bridge receives an additional parameter `Cache timeout in seconds`
+that can be set to any value.
diff --git a/docs/03_For_Hosts/08_Custom_Configuration.md b/docs/03_For_Hosts/08_Custom_Configuration.md
index 9a1f78f2..6e22f7ee 100644
--- a/docs/03_For_Hosts/08_Custom_Configuration.md
+++ b/docs/03_For_Hosts/08_Custom_Configuration.md
@@ -1,16 +1,21 @@
 RSS-Bridge supports custom configurations for common parameters on the server side!
 
-A default configuration file (`config.default.ini.php`) is shipped with RSS-Bridge. Please do not edit this file, as it gets replaced when upgrading RSS-Bridge!
+A default configuration file (`config.default.ini.php`) is shipped with RSS-Bridge.
+Please do not edit this file, as it gets replaced when upgrading RSS-Bridge!
 
-You should, however, use this file as template to create your own configuration (or leave it as is, to keep the default settings). In order to create your own configuration perform following actions:
+You should, however, use this file as template to create your own configuration
+(or leave it as is, to keep the default settings).
+In order to create your own configuration perform following actions:
 
 * Create the file `config.ini.php` in the RSS-Bridge root folder (next to `config.default.ini.php`)
 * Copy the contents from `config.default.ini.php` to your configuration file
 * Change the parameters to satisfy your requirements
 
-RSS-Bridge will automatically detect the `config.ini.php` and use it. If the file doesn't exist it will default to `config.default.ini.php` automatically.
+RSS-Bridge will automatically detect the `config.ini.php` and use it.
+If the file doesn't exist it will default to `config.default.ini.php` automatically.
 
-__Notice__: If a parameter is not specified in your `config.ini.php` RSS-Bridge will automatically use the default settings from `config.default.ini.php`.
+__Notice__: If a parameter is not specified in your `config.ini.php` RSS-Bridge will
+automatically use the default settings from `config.default.ini.php`.
 
 # Available parameters
 
diff --git a/docs/03_For_Hosts/index.md b/docs/03_For_Hosts/index.md
index b89f321a..a4e55d69 100644
--- a/docs/03_For_Hosts/index.md
+++ b/docs/03_For_Hosts/index.md
@@ -1,8 +1,5 @@
 This section is directed at **hosts** and **server administrators**.
 
-To install RSS-Bridge, please follow the [installation instructions](../03_For_Hosts/01_Installation.md).
-You must have access to a web server with a working PHP environment!
-
 RSS-Bridge comes with a large amount of bridges.
 
 Some bridges could be implemented more efficiently by actually using proprietary APIs,
@@ -11,4 +8,5 @@ but there are reasons against it:
 - RSS-Bridge exists in the first place to NOT use APIs.
 - See [the rant](https://github.com/RSS-Bridge/rss-bridge/blob/master/README.md#Rant)
 
-- APIs require private keys that could be stored on servers running RSS-Bridge,which is a security concern, involves complex authorizations for inexperienced users and could cause harm (when using paid services for example). In a closed environment (a server only you use for yourself) however you might be interested in using them anyway. So, check [this](https://github.com/RSS-Bridge/rss-bridge/pull/478/files) possible implementation of an anti-captcha solution.
\ No newline at end of file
+- APIs require private keys that could be stored on servers running RSS-Bridge,
+- which is a security concern, involves complex authorizations for inexperienced users and could cause harm (when using paid services for example). In a closed environment (a server only you use for yourself) however you might be interested in using them anyway. So, check [this](https://github.com/RSS-Bridge/rss-bridge/pull/478/files) possible implementation of an anti-captcha solution.
diff --git a/docs/05_Bridge_API/01_How_to_create_a_new_bridge.md b/docs/05_Bridge_API/01_How_to_create_a_new_bridge.md
index 391d179f..02287962 100644
--- a/docs/05_Bridge_API/01_How_to_create_a_new_bridge.md
+++ b/docs/05_Bridge_API/01_How_to_create_a_new_bridge.md
@@ -27,4 +27,5 @@ The file must start with the PHP tags and end with an empty line. The closing ta
 // This line is empty (just imagine it!)
 ```
 
-The next step is to extend one of the base classes. Refer to one of an base classes listed on the [Bridge API](../05_Bridge_API/index.md) page.
\ No newline at end of file
+The next step is to extend one of the base classes.
+Refer to one of an base classes listed on the [Bridge API](../05_Bridge_API/index.md) page.
diff --git a/docs/05_Bridge_API/02_BridgeAbstract.md b/docs/05_Bridge_API/02_BridgeAbstract.md
index b6813a16..9cb16050 100644
--- a/docs/05_Bridge_API/02_BridgeAbstract.md
+++ b/docs/05_Bridge_API/02_BridgeAbstract.md
@@ -50,10 +50,10 @@ For example: `MyBridge.php` => `MyBridge`
 
 ```PHP
 <?PHP
-class MyBridge extends BridgeAbstract {
+class MyBridge extends BridgeAbstract
+{
 
 }
-// This line is empty (just imagine it!)
 ```
 
 </div></details>
@@ -76,7 +76,8 @@ const CACHE_TIMEOUT // (optional) Defines the maximum duration for the cache in
 ```PHP
 <?php
 
-class MyBridge extends BridgeAbstract {
+class MyBridge extends BridgeAbstract
+{
 	const NAME        = 'My Bridge';
 	const URI         = 'https://rss-bridge.github.io/rss-bridge/Bridge_API/BridgeAbstract.html';
 	const DESCRIPTION = 'Returns "Hello World!"';

From 36fd72c87e5e96923a61bc79aeff8cc97b950423 Mon Sep 17 00:00:00 2001
From: bloominstrong <114744388+bloominstrong@users.noreply.github.com>
Date: Sun, 1 Sep 2024 00:27:45 +1000
Subject: [PATCH 485/716] [ABCNewsBridge] Fix broken due to site redesign
 (#4247)

---
 bridges/ABCNewsBridge.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bridges/ABCNewsBridge.php b/bridges/ABCNewsBridge.php
index c00fed1c..154eb489 100644
--- a/bridges/ABCNewsBridge.php
+++ b/bridges/ABCNewsBridge.php
@@ -31,17 +31,17 @@ class ABCNewsBridge extends BridgeAbstract
     {
         $url = sprintf('https://www.abc.net.au/news/%s', $this->getInput('topic'));
         $dom = getSimpleHTMLDOM($url);
-        $dom = $dom->find('div[data-component="CardList"]', 0);
+        $dom = $dom->find('div[data-component="PaginationList"]', 0);
         if (!$dom) {
             throw new \Exception(sprintf('Unable to find css selector on `%s`', $url));
         }
         $dom = defaultLinkTo($dom, $this->getURI());
-        foreach ($dom->find('div[data-component="GenericCard"]') as $article) {
+        foreach ($dom->find('article[data-component="DetailCard"]') as $article) {
             $a = $article->find('a', 0);
             $this->items[] = [
                 'title' => $a->plaintext,
                 'uri' => $a->href,
-                'content' => $article->find('[data-component="CardDescription"]', 0)->plaintext,
+                'content' => $article->find('p', 0)->plaintext,
                 'timestamp' => strtotime($article->find('time', 0)->datetime),
             ];
         }

From a6bdc322b01de91b7a9e27243b30a65caf2d3c5a Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 1 Sep 2024 21:48:14 +0200
Subject: [PATCH 486/716] refactor: extract exception and cache middleware
 (#4248)

---
 actions/DisplayAction.php           | 36 +-----------------
 index.php                           | 15 +++-----
 lib/Configuration.php               |  4 ++
 lib/RssBridge.php                   |  4 +-
 lib/dependencies.php                | 12 +-----
 middlewares/CacheMiddleware.php     | 59 +++++++++++++++++++++++++++++
 middlewares/ExceptionMiddleware.php | 24 ++++++++++++
 templates/html-format.html.php      |  1 -
 8 files changed, 99 insertions(+), 56 deletions(-)
 create mode 100644 middlewares/CacheMiddleware.php
 create mode 100644 middlewares/ExceptionMiddleware.php

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index bda45558..845bfd84 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -22,25 +22,6 @@ class DisplayAction implements ActionInterface
         $format = $request->get('format');
         $noproxy = $request->get('_noproxy');
 
-        $cacheKey = 'http_' . json_encode($request->toArray());
-        /** @var Response $cachedResponse */
-        $cachedResponse = $this->cache->get($cacheKey);
-        if ($cachedResponse) {
-            $ifModifiedSince = $request->server('HTTP_IF_MODIFIED_SINCE');
-            $lastModified = $cachedResponse->getHeader('last-modified');
-            if ($ifModifiedSince && $lastModified) {
-                $lastModified = new \DateTimeImmutable($lastModified);
-                $lastModifiedTimestamp = $lastModified->getTimestamp();
-                $modifiedSince = strtotime($ifModifiedSince);
-                // TODO: \DateTimeImmutable can be compared directly
-                if ($lastModifiedTimestamp <= $modifiedSince) {
-                    $modificationTimeGMT = gmdate('D, d M Y H:i:s ', $lastModifiedTimestamp);
-                    return new Response('', 304, ['last-modified' => $modificationTimeGMT . 'GMT']);
-                }
-            }
-            return $cachedResponse->withHeader('rss-bridge', 'This is a cached response');
-        }
-
         if (!$bridgeName) {
             return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'Missing bridge parameter']), 400);
         }
@@ -66,6 +47,8 @@ class DisplayAction implements ActionInterface
             define('NOPROXY', true);
         }
 
+        $cacheKey = 'http_' . json_encode($request->toArray());
+
         $bridge = $this->bridgeFactory->create($bridgeClassName);
 
         $response = $this->createResponse($request, $bridge, $format);
@@ -80,21 +63,6 @@ class DisplayAction implements ActionInterface
             $this->cache->set($cacheKey, $response, $ttl);
         }
 
-        if (in_array($response->getCode(), [403, 429, 503])) {
-            // Cache these responses for about ~20 mins on average
-            $this->cache->set($cacheKey, $response, 60 * 15 + rand(1, 60 * 10));
-        }
-
-        if ($response->getCode() === 500) {
-            $this->cache->set($cacheKey, $response, 60 * 15);
-        }
-
-        // For 1% of requests, prune cache
-        if (rand(1, 100) === 1) {
-            // This might be resource intensive!
-            $this->cache->prune();
-        }
-
         return $response;
     }
 
diff --git a/index.php b/index.php
index e67b0c9f..ec7490d6 100644
--- a/index.php
+++ b/index.php
@@ -63,13 +63,8 @@ if ($argv) {
     $request = Request::fromGlobals();
 }
 
-try {
-    $rssBridge = new RssBridge($container);
-    $response = $rssBridge->main($request);
-    $response->send();
-} catch (\Throwable $e) {
-    // Probably an exception inside an action
-    $logger->error('Exception in RssBridge::main()', ['e' => $e]);
-    $response = new Response(render(__DIR__ . '/templates/exception.html.php', ['e' => $e]), 500);
-    $response->send();
-}
+$rssBridge = new RssBridge($container);
+
+$response = $rssBridge->main($request);
+
+$response->send();
\ No newline at end of file
diff --git a/lib/Configuration.php b/lib/Configuration.php
index 44fd3612..187848fb 100644
--- a/lib/Configuration.php
+++ b/lib/Configuration.php
@@ -82,6 +82,10 @@ final class Configuration
             }
         }
 
+        if (Debug::isEnabled()) {
+            self::setConfig('cache', 'type', 'array');
+        }
+
         if (!is_array(self::getConfig('system', 'enabled_bridges'))) {
             self::throwConfigError('system', 'enabled_bridges', 'Is not an array');
         }
diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index 5e90fb13..c7b132d6 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -23,6 +23,8 @@ final class RssBridge
         $handler = $this->container[$actionName];
 
         $middlewares = [
+            new CacheMiddleware($this->container['cache']),
+            new ExceptionMiddleware($this->container['logger']),
             new SecurityMiddleware(),
             new MaintenanceMiddleware(),
             new BasicAuthMiddleware(),
@@ -34,6 +36,6 @@ final class RssBridge
         foreach (array_reverse($middlewares) as $middleware) {
             $action = fn ($req) => $middleware($req, $action);
         }
-        return $action($request);
+        return $action($request->withAttribute('action', $actionName));
     }
 }
diff --git a/lib/dependencies.php b/lib/dependencies.php
index 227a66f1..45ae5d61 100644
--- a/lib/dependencies.php
+++ b/lib/dependencies.php
@@ -56,22 +56,14 @@ $container['logger'] = function () {
     // $logger->addHandler(new StreamHandler('/tmp/rss-bridge.txt', Logger::INFO));
 
     // Uncomment this for debug logging to fs
-    //$logger->addHandler(new StreamHandler('/tmp/rss-bridge-debug.txt', Logger::DEBUG));
+    // $logger->addHandler(new StreamHandler('/tmp/rss-bridge-debug.txt', Logger::DEBUG));
     return $logger;
 };
 
 $container['cache'] = function ($c) {
     /** @var CacheFactory $cacheFactory */
     $cacheFactory = $c['cache_factory'];
-    $type = Configuration::getConfig('cache', 'type');
-    if (!$type) {
-        throw new \Exception('No cache type configured');
-    }
-    if (Debug::isEnabled()) {
-        $cache = $cacheFactory->create('array');
-    } else {
-        $cache = $cacheFactory->create($type);
-    }
+    $cache = $cacheFactory->create(Configuration::getConfig('cache', 'type'));
     return $cache;
 };
 
diff --git a/middlewares/CacheMiddleware.php b/middlewares/CacheMiddleware.php
new file mode 100644
index 00000000..ae0d0d33
--- /dev/null
+++ b/middlewares/CacheMiddleware.php
@@ -0,0 +1,59 @@
+<?php
+
+declare(strict_types=1);
+
+class CacheMiddleware implements Middleware
+{
+    private CacheInterface $cache;
+
+    public function __construct(CacheInterface $cache)
+    {
+        $this->cache = $cache;
+    }
+
+    public function __invoke(Request $request, $next): Response
+    {
+        $action = $request->attribute('action');
+
+        if ($action !== 'DisplayAction') {
+            // We only cache DisplayAction (for now)
+            return $next($request);
+        }
+
+        // TODO: might want to remove som params from query
+        $cacheKey = 'http_' . json_encode($request->toArray());
+        $cachedResponse = $this->cache->get($cacheKey);
+
+        if ($cachedResponse) {
+            $ifModifiedSince = $request->server('HTTP_IF_MODIFIED_SINCE');
+            $lastModified = $cachedResponse->getHeader('last-modified');
+            if ($ifModifiedSince && $lastModified) {
+                $lastModified = new \DateTimeImmutable($lastModified);
+                $lastModifiedTimestamp = $lastModified->getTimestamp();
+                $modifiedSince = strtotime($ifModifiedSince);
+                // TODO: \DateTimeImmutable can be compared directly
+                if ($lastModifiedTimestamp <= $modifiedSince) {
+                    $modificationTimeGMT = gmdate('D, d M Y H:i:s ', $lastModifiedTimestamp);
+                    return new Response('', 304, ['last-modified' => $modificationTimeGMT . 'GMT']);
+                }
+            }
+            return $cachedResponse;
+        }
+
+        /** @var Response $response */
+        $response = $next($request);
+
+        if (in_array($response->getCode(), [403, 429, 500, 503])) {
+            // Cache these responses for about ~20 mins on average
+            $this->cache->set($cacheKey, $response, 60 * 15 + rand(1, 60 * 10));
+        }
+
+        // For 1% of requests, prune cache
+        if (rand(1, 100) === 1) {
+            // This might be resource intensive!
+            $this->cache->prune();
+        }
+
+        return $response;
+    }
+}
\ No newline at end of file
diff --git a/middlewares/ExceptionMiddleware.php b/middlewares/ExceptionMiddleware.php
new file mode 100644
index 00000000..8bb74713
--- /dev/null
+++ b/middlewares/ExceptionMiddleware.php
@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+class ExceptionMiddleware implements Middleware
+{
+    private Logger $logger;
+
+    public function __construct(Logger $logger)
+    {
+        $this->logger = $logger;
+    }
+
+    public function __invoke(Request $request, $next): Response
+    {
+        try {
+            return $next($request);
+        } catch (\Throwable $e) {
+            $this->logger->error('Exception in ExceptionMiddleware', ['e' => $e]);
+
+            return new Response(render(__DIR__ . '/../templates/exception.html.php', ['e' => $e]), 500);
+        }
+    }
+}
\ No newline at end of file
diff --git a/templates/html-format.html.php b/templates/html-format.html.php
index 8e8abfcf..a62bb16a 100644
--- a/templates/html-format.html.php
+++ b/templates/html-format.html.php
@@ -22,7 +22,6 @@
 </head>
 
 <body>
-
     <div class="container">
 
         <h1 class="pagetitle">

From 486191b419d545fcc2feec54378917b634812730 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Mon, 2 Sep 2024 21:43:40 +0200
Subject: [PATCH 487/716] fix(cve_details) (#4251)

---
 bridges/CVEDetailsBridge.php | 42 +++++++++---------------------------
 1 file changed, 10 insertions(+), 32 deletions(-)

diff --git a/bridges/CVEDetailsBridge.php b/bridges/CVEDetailsBridge.php
index b52d290e..5f4f9daa 100644
--- a/bridges/CVEDetailsBridge.php
+++ b/bridges/CVEDetailsBridge.php
@@ -42,45 +42,23 @@ class CVEDetailsBridge extends BridgeAbstract
             $this->fetchContent();
         }
 
-        foreach ($this->html->find('#searchresults > .row') as $i => $tr) {
-            // There are some optional vulnerability types, which will be
-            // added to the categories as well as the CWE number -- which is
-            // always given.
-            $categories = [$this->vendor];
-            $enclosures = [];
-
-            $detailLink = $tr->find('h3 > a', 0);
-            $detailHtml = getSimpleHTMLDOM($detailLink->href);
-
-            // The CVE number itself
+        $var = $this->html->find('#searchresults > div > div.row');
+        foreach ($var as $i => $tr) {
+            $uri = $tr->find('h3 > a', 0)->href ?? null;
             $title = $tr->find('h3 > a', 0)->innertext;
-            $content = $tr->find('.cvesummarylong', 0)->innertext;
-            $cweList = $detailHtml->find('h2', 2)->next_sibling();
-            foreach ($cweList->find('li') as $li) {
-                $cweWithDescription = $li->find('a', 0)->innertext ?? '';
-
-                if (preg_match('/CWE-(\d+)/', $cweWithDescription, $cwe)) {
-                    $categories[] = 'CWE-' . $cwe[1];
-                    $enclosures[] = 'https://cwe.mitre.org/data/definitions/' . $cwe[1] . '.html';
-                }
-            }
-
-            if ($this->product != '') {
-                $categories[] = $this->product;
-            }
+            $content = $tr->find('.cvesummarylong', 0)->innertext ?? '';
+            $timestamp = $tr->find('[data-tsvfield="publishDate"]', 0)->innertext ?? 0;
 
             $this->items[] = [
-                'uri'           => 'https://cvedetails.com/' . $detailHtml->find('h1 > a', 0)->href,
+                'uri'           => $uri,
                 'title'         => $title,
-                'timestamp'     => $tr->find('[data-tsvfield="publishDate"]', 0)->innertext,
+                'timestamp'     => $timestamp,
                 'content'       => $content,
-                'categories'    => $categories,
-                'enclosures'    => $enclosures,
+                'categories'    => [$this->vendor],
+                'enclosures'    => [],
                 'uid'           => $title,
             ];
-
-            // We only want to fetch the latest 10 CVEs
-            if (count($this->items) >= 10) {
+            if (count($this->items) >= 30) {
                 break;
             }
         }

From 3dc8b65a0bb0296bdf0609c83841339014b1a663 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Mon, 2 Sep 2024 15:49:49 -0400
Subject: [PATCH 488/716] [GovTrackBridge] Add feed for GovTrack events and
 blog (#4231)

* [GovTrackBridge] Add feed for GovTrack events and blog

* [GovTrackBridge] add missing default value

* [GovTrackBridge] leaner items array and limit implementation
---
 bridges/GovTrackBridge.php | 125 +++++++++++++++++++++++++++++++++++++
 1 file changed, 125 insertions(+)
 create mode 100644 bridges/GovTrackBridge.php

diff --git a/bridges/GovTrackBridge.php b/bridges/GovTrackBridge.php
new file mode 100644
index 00000000..4674668a
--- /dev/null
+++ b/bridges/GovTrackBridge.php
@@ -0,0 +1,125 @@
+<?php
+
+class GovTrackBridge extends BridgeAbstract
+{
+    const NAME = 'GovTrack';
+    const MAINTAINER = 'phantop';
+    const URI = 'https://www.govtrack.us/';
+    const DESCRIPTION = 'Returns posts and bills from GovTrack.us';
+    const PARAMETERS = [[
+        'feed' => [
+            'name' => 'Feed to track',
+            'type' => 'list',
+            'defaultValue' => 'posts',
+            'values' => [
+                'All Legislative Activity' => 'bill-activity',
+                'Bill Summaries' => 'bill-summaries',
+                'Legislation Coming Up' => 'coming-up',
+                'Major Legislative Activity' => 'major-bill-activity',
+                'New Bills and Resolutions' => 'introduced-bills',
+                'New Laws' => 'enacted-bills',
+                'Posts from Us' => 'posts'
+                ]
+            ],
+            'limit' => self::LIMIT
+    ]];
+
+    public function collectData()
+    {
+        $html = getSimpleHTMLDOMCached($this->getURI());
+        if ($this->getInput('feed') != 'posts') {
+            $this->collectEvent($html);
+            return;
+        }
+
+        $html = defaultLinkTo($html, parent::getURI());
+        $limit = $this->getInput('limit') ?? 10;
+        foreach ($html->find('section') as $element) {
+            if (--$limit == 0) {
+                break;
+            }
+
+            $info = explode(' ', $element->find('p', 0)->innertext);
+            $item = [
+                'categories' => [implode(' ', array_slice($info, 4))],
+                'timestamp' => strtotime(implode(' ', array_slice($info, 0, 3))),
+                'title' => $element->find('a', 0)->innertext,
+                'uri' => $element->find('a', 0)->href,
+            ];
+
+            $html = getSimpleHTMLDOMCached($item['uri']);
+            $html = defaultLinkTo($html, parent::getURI());
+
+            $content = $html->find('#content .col-md', 1);
+            $info = explode(' by ', $content->find('p', 0)->plaintext);
+            $content->removeChild($content->firstChild());
+
+            $item['author'] = implode(' ', array_slice($info, 1));
+            $item['content'] = $content->innertext;
+
+            $this->items[] = $item;
+        }
+    }
+
+    private function collectEvent($html)
+    {
+        $opt = [];
+        preg_match('/"csrfmiddlewaretoken" value="(.*)"/', $html, $opt);
+        $header = [
+            "cookie: csrftoken=$opt[1]",
+            "x-csrftoken: $opt[1]",
+            'referer: ' . parent::getURI(),
+        ];
+        preg_match('/var selected_feed = "(.*)";/', $html, $opt);
+        $post = [
+            'count' => $this->getInput('limit') ?? 20,
+            'feed' => $opt[1]
+        ];
+        $opt = [ CURLOPT_POSTFIELDS => $post ];
+
+        $html = getContents(parent::getURI() . 'events/_load_events', $header, $opt);
+        $html = defaultLinkTo(str_get_html($html), parent::getURI());
+
+        foreach ($html->find('.tracked_event') as $event) {
+            $bill = $event->find('.event_title a, .event_body a', 0);
+            $date = explode(' ', $event->find('.event_date', 0)->plaintext);
+            preg_match('/Sponsor:(.*)\n/', $event->plaintext, $opt);
+
+            $item = [
+                'author' => $opt[1] ?? '',
+                'content' => $event->find('td', 1)->innertext,
+                'enclosures' => [$event->find('img', 0)->src],
+                'timestamp' => strtotime(implode(' ', array_slice($date, 2))),
+                'title' => explode(': ', $bill->innertext)[0],
+                'uri' => $bill->href,
+            ];
+
+            foreach ($event->find('.event_title, .event_type span') as $tag) {
+                if (!$tag->find('a', 0)) {
+                    $item['categories'][] = $tag->plaintext;
+                }
+            }
+
+            $this->items[] = $item;
+        }
+    }
+
+    public function getName()
+    {
+        $name = parent::getName();
+        if ($this->getInput('feed') != null) {
+            $name .= ' - ' . $this->getKey('feed');
+        }
+        return $name;
+    }
+
+    public function getURI()
+    {
+        if ($this->getInput('feed') != 'posts') {
+            $url = parent::getURI() . 'events/' . $this->getInput('feed');
+        } else {
+            $url = parent::getURI() . $this->getInput('feed');
+        }
+        return $url;
+    }
+}

From 293d04f296c33f7c524b84b7a0ae0d2625ca2729 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 3 Sep 2024 07:02:37 +0200
Subject: [PATCH 489/716] fix(spotify): detect rate limiting (#4253)

---
 bridges/SpotifyBridge.php       | 68 ++++++++++++++++++++++-----------
 middlewares/CacheMiddleware.php |  4 +-
 2 files changed, 47 insertions(+), 25 deletions(-)

diff --git a/bridges/SpotifyBridge.php b/bridges/SpotifyBridge.php
index e03d43a1..ab093a61 100644
--- a/bridges/SpotifyBridge.php
+++ b/bridges/SpotifyBridge.php
@@ -37,7 +37,10 @@ class SpotifyBridge extends BridgeAbstract
                 'name' => 'Spotify URIs',
                 'type' => 'text',
                 'required' => true,
-                'exampleValue' => 'spotify:artist:4lianjyuR1tqf6oUX8kjrZ [,spotify:playlist:37i9dQZF1DXcBWIGoYBM5M,spotify:show:6ShFMYxeDNMo15COLObDvC]',
+
+                // spotify:playlist:37i9dQZF1DXcBWIGoYBM5M
+                // spotify:show:6ShFMYxeDNMo15COLObDvC
+                'exampleValue' => 'spotify:artist:4lianjyuR1tqf6oUX8kjrZ',
             ],
             'albumtype' => [
                 'name' => 'Album type',
@@ -93,6 +96,25 @@ class SpotifyBridge extends BridgeAbstract
     private $token = '';
 
     public function collectData()
+    {
+        /**
+         * https://developer.spotify.com/documentation/web-api/concepts/rate-limits
+         */
+        $cacheKey = 'spotify_rate_limit';
+
+        try {
+            $this->collectDataInternal();
+        } catch (HttpException $e) {
+            if ($e->getCode() === 429) {
+                $retryAfter = $e->response->getHeader('Retry-After') ?? (60 * 5);
+                $this->cache->set($cacheKey, true, $retryAfter);
+                throw new RateLimitException(sprintf('Rate limited by spotify, try again in %s seconds', $retryAfter));
+            }
+            throw $e;
+        }
+    }
+
+    private function collectDataInternal()
     {
         $this->fetchAccessToken();
 
@@ -125,6 +147,27 @@ class SpotifyBridge extends BridgeAbstract
         }
     }
 
+    private function fetchAccessToken()
+    {
+        $cacheKey = sprintf('SpotifyBridge:%s:%s', $this->getInput('clientid'), $this->getInput('clientsecret'));
+
+        $token = $this->cache->get($cacheKey);
+        if ($token) {
+            $this->token = $token;
+        } else {
+            $basicAuth = base64_encode(sprintf('%s:%s', $this->getInput('clientid'), $this->getInput('clientsecret')));
+            $json = getContents('https://accounts.spotify.com/api/token', [
+                "Authorization: Basic $basicAuth",
+            ], [
+                CURLOPT_POSTFIELDS => 'grant_type=client_credentials',
+            ]);
+            $data = Json::decode($json);
+            $this->token = $data['access_token'];
+
+            $this->cache->set($cacheKey, $this->token, 3600);
+        }
+    }
+
     private function getEntriesFromQuery()
     {
         $entries = [];
@@ -276,27 +319,6 @@ class SpotifyBridge extends BridgeAbstract
         return DateTime::createFromFormat('Y-m-d', $date)->getTimestamp();
     }
 
-    private function fetchAccessToken()
-    {
-        $cacheKey = sprintf('SpotifyBridge:%s:%s', $this->getInput('clientid'), $this->getInput('clientsecret'));
-
-        $token = $this->cache->get($cacheKey);
-        if ($token) {
-            $this->token = $token;
-        } else {
-            $basicAuth = base64_encode(sprintf('%s:%s', $this->getInput('clientid'), $this->getInput('clientsecret')));
-            $json = getContents('https://accounts.spotify.com/api/token', [
-                "Authorization: Basic $basicAuth",
-            ], [
-                CURLOPT_POSTFIELDS => 'grant_type=client_credentials',
-            ]);
-            $data = Json::decode($json);
-            $this->token = $data['access_token'];
-
-            $this->cache->set($cacheKey, $this->token, 3600);
-        }
-    }
-
     public function getURI()
     {
         if (empty($this->uri)) {
@@ -346,4 +368,4 @@ class SpotifyBridge extends BridgeAbstract
     {
         return 'https://www.scdn.co/i/_global/favicon.png';
     }
-}
+}
\ No newline at end of file
diff --git a/middlewares/CacheMiddleware.php b/middlewares/CacheMiddleware.php
index ae0d0d33..bffde4af 100644
--- a/middlewares/CacheMiddleware.php
+++ b/middlewares/CacheMiddleware.php
@@ -44,8 +44,8 @@ class CacheMiddleware implements Middleware
         $response = $next($request);
 
         if (in_array($response->getCode(), [403, 429, 500, 503])) {
-            // Cache these responses for about ~20 mins on average
-            $this->cache->set($cacheKey, $response, 60 * 15 + rand(1, 60 * 10));
+            // Cache these responses for about ~10 mins on average
+            $this->cache->set($cacheKey, $response, 60 * 5 + rand(1, 60 * 10));
         }
 
         // For 1% of requests, prune cache

From 358bebbb890fce7a9636acfe9f21412dd1790fdb Mon Sep 17 00:00:00 2001
From: Pavel Korytov <thexcloud@gmail.com>
Date: Sat, 7 Sep 2024 08:02:27 +0500
Subject: [PATCH 490/716] [EconomistWorldInBriefBridge] Fix bridge (#4258)

---
 bridges/EconomistWorldInBriefBridge.php | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/bridges/EconomistWorldInBriefBridge.php b/bridges/EconomistWorldInBriefBridge.php
index 4e65b15f..72b66198 100644
--- a/bridges/EconomistWorldInBriefBridge.php
+++ b/bridges/EconomistWorldInBriefBridge.php
@@ -60,20 +60,21 @@ class EconomistWorldInBriefBridge extends BridgeAbstract
             ];
         }
         $html = getSimpleHTMLDOM(self::URI, $headers);
-        $gobbets = $html->find('._gobbets', 0);
+        $gobbets = $html->find('p[data-component="the-world-in-brief-paragraph"]');
         if ($this->getInput('splitGobbets') == 1) {
             $this->splitGobbets($gobbets);
         } else {
             $this->mergeGobbets($gobbets);
         };
         if ($this->getInput('agenda') == 1) {
-            $articles = $html->find('._articles', 0);
+            $articles = $html->find('div[data-test-id="chunks"] > div > div', 0);
+
             if ($articles != null) {
                 $this->collectArticles($articles);
             }
         }
         if ($this->getInput('quote') == 1) {
-            $quote = $html->find('._quote-container', 0);
+            $quote = $html->find('blockquote[data-test-id="inspirational-quote"]', 0);
             $this->addQuote($quote);
         }
     }
@@ -83,7 +84,7 @@ class EconomistWorldInBriefBridge extends BridgeAbstract
         $today = new Datetime();
         $today->setTime(0, 0, 0, 0);
         $limit = $this->getInput('limit');
-        foreach ($gobbets->find('._gobbet') as $gobbet) {
+        foreach ($gobbets as $gobbet) {
             $title = $gobbet->plaintext;
             $match = preg_match('/[\.,]/', $title, $matches, PREG_OFFSET_CAPTURE);
             if ($match > 0) {
@@ -109,7 +110,7 @@ class EconomistWorldInBriefBridge extends BridgeAbstract
         $today = new Datetime();
         $today->setTime(0, 0, 0, 0);
         $contents = '';
-        foreach ($gobbets->find('._gobbet') as $gobbet) {
+        foreach ($gobbets as $gobbet) {
             $contents .= "<p>{$gobbet->innertext}";
         }
         $this->items[] = [
@@ -126,10 +127,14 @@ class EconomistWorldInBriefBridge extends BridgeAbstract
         $i = 0;
         $today = new Datetime();
         $today->setTime(0, 0, 0, 0);
-        foreach ($articles->find('._article') as $article) {
-            $title = $article->find('._headline', 0)->plaintext;
-            $image = $article->find('._main-image', 0);
-            $content = $article->find('._content', 0);
+        foreach ($articles->children() as $element) {
+            if ($element->tag != 'div') {
+                continue;
+            }
+            $image = $element->find('figure', 0);
+            $title = $element->find('h3', 0)->plaintext;
+            $content = $element->find('h3', 0)->parent();
+            $content->find('h3', 0)->outertext = '';
 
             $res_content = '';
             if ($image != null && $this->getInput('agendaPictures') == 1) {

From 40041dd65f9ea81abda0092dff2e160b61a5e682 Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Mon, 9 Sep 2024 22:36:08 +0530
Subject: [PATCH 491/716] [DailythanthiBridge] fix url (#4261)

---
 bridges/DailythanthiBridge.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/DailythanthiBridge.php b/bridges/DailythanthiBridge.php
index 114f42d8..4e891e1c 100644
--- a/bridges/DailythanthiBridge.php
+++ b/bridges/DailythanthiBridge.php
@@ -3,7 +3,7 @@
 class DailythanthiBridge extends BridgeAbstract
 {
     const NAME = 'Dailythanthi';
-    const URI = 'https://www.dailythanthi.com/';
+    const URI = 'https://www.dailythanthi.com';
     const DESCRIPTION = 'Retrieve news from dailythanthi.com';
     const MAINTAINER = 'tillcash';
     const PARAMETERS = [
@@ -46,7 +46,7 @@ class DailythanthiBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $dom = getSimpleHTMLDOM(self::URI . $this->getInput('topic'));
+        $dom = getSimpleHTMLDOM(self::URI . '/' . $this->getInput('topic'));
 
         foreach ($dom->find('div.ListingNewsWithMEDImage') as $element) {
             $slug = $element->find('a', 1);

From d9316cdc606ff09a3623035e0766cd3ef2bc6904 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Wed, 11 Sep 2024 15:14:19 +0200
Subject: [PATCH 492/716] [PicukiBridge] Try to fix the bridge (#4262)

This is a try to fix the bridge HTML parsing
---
 bridges/PicukiBridge.php | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/bridges/PicukiBridge.php b/bridges/PicukiBridge.php
index 5f1096b8..8e818bb0 100644
--- a/bridges/PicukiBridge.php
+++ b/bridges/PicukiBridge.php
@@ -58,26 +58,26 @@ class PicukiBridge extends BridgeAbstract
         }
 
         $count = 0;
-        foreach ($html->find('.box-photos .box-photo') as $element) {
+        foreach ($html->find('div[class=.box-photo][data-s=media]') as $element) {
             // skip ad items
             if (in_array('adv', explode(' ', $element->class))) {
                 continue;
             }
 
-            $url = urljoin(self::URI, $element->find('a', 0)->href);
-            $html = getSimpleHTMLDOMCached($url);
+            $url = $element->find('a', 0)->href;
+            $html_single = getSimpleHTMLDOMCached($url);
             $sourceUrl = null;
-            if (preg_match($re, $html, $matches) > 0) {
+            if (preg_match($re, $html_single, $matches) > 0) {
                 $sourceUrl = 'https://instagram.com/p/' . $matches[1];
             }
 
-            $author = trim($element->find('.user-nickname', 0)->plaintext);
+            //$author = trim($element->find('.single-photo-nickname', 0)->plaintext);
 
             $date = date_create();
             $relativeDate = str_replace(' ago', '', $element->find('.time', 0)->plaintext);
             date_sub($date, date_interval_create_from_date_string($relativeDate));
 
-            $description = trim($element->find('.photo-description', 0)->plaintext);
+            $description = trim($element->find('.photo-action-description', 0)->plaintext);
 
             $isVideo = (bool) $element->find('.video-icon', 0);
             $videoNote = $isVideo ? '<p><i>(video)</i></p>' : '';
@@ -91,7 +91,7 @@ class PicukiBridge extends BridgeAbstract
 
             $this->items[] = [
                 'uri'        => $url,
-                'author'     => $author,
+                /*'author'     => $author,*/
                 'timestamp'  => date_format($date, 'r'),
                 'title'      => strlen($description) > 60 ? mb_substr($description, 0, 57) . '...' : $description,
                 'thumbnail'  => $imageUrl,

From 80c43f10d83dcf4c0b9ff2707c6fe08fff8869ed Mon Sep 17 00:00:00 2001
From: osvfj <osvfj@duck.com>
Date: Thu, 12 Sep 2024 09:07:22 +0000
Subject: [PATCH 493/716] [TCBScansBridge] Add bridge (#4263)

---
 bridges/TCBScansBridge.php | 102 +++++++++++++++++++++++++++++++++++++
 1 file changed, 102 insertions(+)
 create mode 100644 bridges/TCBScansBridge.php

diff --git a/bridges/TCBScansBridge.php b/bridges/TCBScansBridge.php
new file mode 100644
index 00000000..a07c3f5b
--- /dev/null
+++ b/bridges/TCBScansBridge.php
@@ -0,0 +1,102 @@
+<?php
+
+class TCBScansBridge extends BridgeAbstract
+{
+    const NAME = 'TCB Scans Bridge';
+    const URI = 'https://tcbscans.me/';
+    const DESCRIPTION = 'Returns the latest chapter from a TCB Scans project';
+    const MAINTAINER = 'osvfj';
+    const PARAMETERS = [[
+        'manga' => [
+            'name' => 'Manga',
+            'title' => 'Select your prefered manga',
+            'exampleValue' => 'One Piece',
+            'type' => 'list',
+            'values' => [
+                'Ace Novel - Manga Adaptation' => 'mangas/1/ace-novel-manga-adaptation',
+                'Attack on Titan' => 'mangas/8/attack-on-titan',
+                'Black Clover' => 'mangas/3/black-clover',
+                'Black Clover Gaiden: Quartet Knights' => 'mangas/24/black-clover-gaiden-quartet-knights',
+                'Bleach' => 'mangas/2/bleach',
+                'Build King' => 'mangas/9/build-king',
+                'Chainsaw Man' => 'mangas/13/chainsaw-man',
+                'Demon Slayer: Kimetsu no Yaiba ' => 'mangas/19/demon-slayer-kimetsu-no-yaiba',
+                'Haikyuu!! (New Special!)' => 'mangas/11/haikyu-special',
+                'Hunter X Hunter' => 'mangas/15/hunter-x-hunter',
+                'Jujutsu Kaisen' => 'mangas/4/jujutsu-kaisen',
+                'My Hero Academia' => 'mangas/6/my-hero-academia',
+                "My Hero Academia One-Shot: You're Next!!" => 'mangas/25/my-hero-academia-one-shot-you-re-next',
+                'One Piece ' => 'mangas/5/one-piece',
+                'One Piece - Nami vs Kalifa by Boichi' => 'mangas/12/one-piece-nami-vs-kalifa-by-boichi',
+                'One-Punch Man' => 'mangas/10/one-punch-man',
+                'Spy X Family' => 'mangas/23/spy-x-family',
+            ],
+        ],
+        'full_chapter' => [
+            'name' => 'Load images in the item',
+            'type' => 'checkbox',
+            'title' => 'Activate to always load the full chapter',
+            'defaultValue' => 'checked'
+        ],
+        'hide_title' => [
+            'name' => 'Hide title of the chapter',
+            'type' => 'checkbox',
+            'title' => 'Activate to hide the title of the chapter and just show the number'
+        ]
+    ]];
+    const CACHE_TIMEOUT = 60 * 15;
+
+    public function collectData()
+    {
+        $manga = $this->getInput('manga');
+        $html = getSimpleHTMLDOMCached($this->getURI() . $manga);
+        $html = defaultLinkTo($html, $this->getURI());
+        $full_chapter = $this->getInput('full_chapter');
+
+        $chapter = $html->find('a.block.border.border-border.bg-card.mb-3.p-3.rounded', 0);
+
+        $item = [];
+        $item['title'] = $this->getInput('hide_title') ? $chapter->find('div.text-lg.font-bold', 0)->plaintext : $chapter->find('div.text-gray-500', 0)->plaintext;
+        $item['uri'] = $chapter->href;
+        $item['uid'] = $chapter->href;
+
+
+        if ($full_chapter) {
+            $item['content'] = $this->getFullChapter($item['uri']);
+        } else {
+            $item['content'] = <<<EOD
+                <a href="{$item['uri']}" rel="nofollow noreferrer">Read chapter</a>
+            EOD;
+            ;
+        }
+        $this->items[] = $item;
+    }
+
+    private function getFullChapter($uri)
+    {
+        $html = getSimpleHTMLDOMCached($uri);
+        $pictures = $html->find('picture.fixed-ratio');
+        $img_html = '';
+
+        foreach ($pictures as $picture) {
+            $img_html .= <<<EOD
+                <img src="{$picture->find('img.fixed-ratio-content', 0)->src}">
+            EOD;
+        }
+        return $img_html;
+    }
+
+    public function getName()
+    {
+        if (!is_null($this->getKey('manga'))) {
+            return $this->getKey('manga') . ' | ' . self::NAME;
+        }
+
+        return self::NAME;
+    }
+
+    public function getIcon()
+    {
+        return $this->getURI() . '/files/favicon-32x32.png';
+    }
+}
\ No newline at end of file

From af26d845d907cf810bd4028a5ea587fb902a9225 Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Mon, 7 Oct 2024 20:26:48 +0200
Subject: [PATCH 494/716] Include all bridges in tarballs

Currently, two "demo" and "example" bridges are excluded from GitHub's
autogenerated tarballs. As I argued, those files can still be helpful
for integration tests, as they are run in NixOS and don't need internet
access or depend on the availability of external services [1].

Additionally, the official docker image builds from the checkout so it
includes those bridges when users use containers or a git checkout
compared to tarballs. This commit therefore unifies the list of
available bridges between deployment methods.

[1] https://github.com/NixOS/nixpkgs/blob/master/nixos/tests/web-apps/rss-bridge.nix#L20
---
 .gitattributes | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.gitattributes b/.gitattributes
index 5981fb34..28053256 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -47,8 +47,6 @@ phpcs.xml                               export-ignore
 phpcompatibility.xml                    export-ignore
 tests/                                  export-ignore
 cache/.gitkeep                          export-ignore
-bridges/DemoBridge.php                  export-ignore
-bridges/FeedExpanderExampleBridge.php   export-ignore
 
 ## Composer
 #

From 63c16e470daf6ee4fd2123295bd05ae0a15c7c0c Mon Sep 17 00:00:00 2001
From: Bocki <henning@bocklage.com>
Date: Wed, 16 Oct 2024 15:36:57 +0200
Subject: [PATCH 495/716] [prtester] Rework test storage (#4292)

* Update prtester.py

* Update prhtmlgenerator.yml
---
 .github/prtester.py                   | 14 ++++----
 .github/workflows/prhtmlgenerator.yml | 50 ++++++++++++++++++++++++---
 2 files changed, 54 insertions(+), 10 deletions(-)

diff --git a/.github/prtester.py b/.github/prtester.py
index 3d7dae99..53d77725 100644
--- a/.github/prtester.py
+++ b/.github/prtester.py
@@ -4,7 +4,7 @@ import re
 from bs4 import BeautifulSoup
 from datetime import datetime
 from typing import Iterable
-import os.path
+import os
 import urllib
 
 # This script is specifically written to be used in automation for https://github.com/RSS-Bridge/rss-bridge
@@ -39,6 +39,8 @@ def main(instances: Iterable[Instance], with_upload: bool, with_reduced_upload:
 
 def testBridges(instance: Instance, bridge_cards: Iterable, with_upload: bool, with_reduced_upload: bool) -> Iterable:
     instance_suffix = ''
+    prid = os.getenv("PR")
+    tester_url = f'https://rss-bridge.github.io/rss-bridge-tests/prs/{prid}'
     if instance.name:
         instance_suffix = f' ({instance.name})'
     table_rows = []
@@ -140,10 +142,10 @@ def testBridges(instance: Instance, bridge_cards: Iterable, with_upload: bool, w
                 if status_is_ok:
                     status = '✔️'
                 if with_upload and (not with_reduced_upload or not status_is_ok):
-                    termpad = requests.post(url="https://termpad.com/", data=page_text)
-                    termpad_url = termpad.text.strip()
-                    termpad_url = termpad_url.replace('termpad.com/','termpad.com/raw/')
-            table_rows.append(f'| {bridge_name} | [{form_number} {context_name}{instance_suffix}]({termpad_url}) | {status} |')
+                    filename = f'{os.getcwd()}/{instance.name}_{form_number}.html'
+                    with open(file=filename, mode='wb') as file:
+                        file.write(page_text)
+            table_rows.append(f'| {bridge_name} | [{form_number} {context_name}{instance_suffix}]({tester_url}/{instance.name}_{form_number}.html) | {status} |')
             form_number += 1
     return table_rows
 
@@ -187,4 +189,4 @@ if __name__ == '__main__':
         with_reduced_upload=args.reduced_upload and not args.no_upload,
         title=args.title,
         output_file=args.output_file
-    );
\ No newline at end of file
+    );
diff --git a/.github/workflows/prhtmlgenerator.yml b/.github/workflows/prhtmlgenerator.yml
index 7985250a..90343973 100644
--- a/.github/workflows/prhtmlgenerator.yml
+++ b/.github/workflows/prhtmlgenerator.yml
@@ -13,7 +13,7 @@ jobs:
     # Needs additional permissions https://github.com/actions/first-interaction/issues/10#issuecomment-1041402989
     steps:
       - name: Check out self
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           ref: ${{github.event.pull_request.head.ref}}
           repository: ${{github.event.pull_request.head.repo.full_name}}
@@ -33,7 +33,7 @@ jobs:
           docker build -t prbuild .;
           docker run -d -v $GITHUB_WORKSPACE/whitelist.txt:/app/whitelist.txt -v $GITHUB_WORKSPACE/DEBUG:/app/DEBUG -p 3001:80 prbuild
       - name: Setup python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: '3.7'
           cache: 'pip'
@@ -51,9 +51,17 @@ jobs:
           body="${body//$'\n'/'%0A'}";
           body="${body//$'\r'/'%0D'}";
           echo "bodylength=${#body}" >> $GITHUB_OUTPUT
+        env:
+          PR: ${{ github.event.number }}
+      - name: Upload generated tests
+        uses: actions/upload-artifact@v4
+        id: upload-generated-tests
+        with:
+          name: tests
+          path: '*.html'
       - name: Find Comment
         if: ${{ steps.testrun.outputs.bodylength > 130 }}
-        uses: peter-evans/find-comment@v2
+        uses: peter-evans/find-comment@v3
         id: fc
         with:
           issue-number: ${{ github.event.pull_request.number }}
@@ -61,9 +69,43 @@ jobs:
           body-includes: Pull request artifacts
       - name: Create or update comment
         if: ${{ steps.testrun.outputs.bodylength > 130 }}
-        uses: peter-evans/create-or-update-comment@v2
+        uses: peter-evans/create-or-update-comment@v4
         with:
           comment-id: ${{ steps.fc.outputs.comment-id }}
           issue-number: ${{ github.event.pull_request.number }}
           body-file: comment.txt
           edit-mode: replace
+  upload_tests:
+    name: Upload tests
+    runs-on: ubuntu-latest
+    needs: test-pr
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          repository: 'RSS-Bridge/rss-bridge-tests'
+          ref: 'main'
+          token:  ${{ secrets.RSSTESTER_ACTION }}
+  
+      - name: Setup git config
+        run: |
+          git config --global user.name "GitHub Actions"
+          git config --global user.email "<>"
+  
+      - name: Download tests
+        uses: actions/download-artifact@v4
+        with:
+          name: tests
+
+      - name: Move tests
+        run: |
+          cd prs
+          mkdir -p ${{github.event.number}}
+          cd ${{github.event.number}}
+          mv -f $GITHUB_WORKSPACE/*.html .
+          
+      - name: Commit and push generated tests
+        run: |
+          export COMMIT_MESSAGE="Added tests for PR ${{github.event.number}}"
+          git add .
+          git commit -m "$COMMIT_MESSAGE"
+          git push

From 6aba9fdf541c7fecea56bc6fc6496372f1679314 Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Wed, 16 Oct 2024 22:05:06 +0530
Subject: [PATCH 496/716] [MaalaimalarBridge] fix url (#4295)

---
 bridges/MaalaimalarBridge.php | 90 +++++++++++++++++------------------
 1 file changed, 45 insertions(+), 45 deletions(-)

diff --git a/bridges/MaalaimalarBridge.php b/bridges/MaalaimalarBridge.php
index 59c76b01..e83eafe2 100644
--- a/bridges/MaalaimalarBridge.php
+++ b/bridges/MaalaimalarBridge.php
@@ -3,7 +3,7 @@
 class MaalaimalarBridge extends BridgeAbstract
 {
     const NAME = 'Maalaimalar';
-    const URI = 'https://www.maalaimalar.com/';
+    const URI = 'https://www.maalaimalar.com';
     const DESCRIPTION = 'Retrieve news from maalaimalar.com';
     const MAINTAINER = 'tillcash';
     const PARAMETERS = [
@@ -13,54 +13,54 @@ class MaalaimalarBridge extends BridgeAbstract
                 'type' => 'list',
                 'values' => [
                     'news' => [
-                        'tamilnadu' => 'news/state',
-                        'puducherry' => 'puducherry',
-                        'india' => 'news/national',
-                        'world' => 'news/world',
+                        'tamilnadu' => '/news/state',
+                        'puducherry' => '/news/puducherry',
+                        'india' => '/news/national',
+                        'world' => '/news/world',
                     ],
                     'district' => [
-                        'chennai' => 'chennai',
-                        'ariyalur' => 'ariyalur',
-                        'chengalpattu' => 'chengalpattu',
-                        'coimbatore' => 'coimbatore',
-                        'cuddalore' => 'cuddalore',
-                        'dharmapuri' => 'dharmapuri',
-                        'dindugal' => 'dindugal',
-                        'erode' => 'erode',
-                        'kaanchepuram' => 'kaanchepuram',
-                        'kallakurichi' => 'kallakurichi',
-                        'kanyakumari' => 'kanyakumari',
-                        'karur' => 'karur',
-                        'krishnagiri' => 'krishnagiri',
-                        'madurai' => 'madurai',
-                        'mayiladuthurai' => 'mayiladuthurai',
-                        'nagapattinam' => 'nagapattinam',
-                        'namakal' => 'namakal',
-                        'nilgiris' => 'nilgiris',
-                        'perambalur' => 'perambalur',
-                        'pudukottai' => 'pudukottai',
-                        'ramanathapuram' => 'ramanathapuram',
-                        'ranipettai' => 'ranipettai',
-                        'salem' => 'salem',
-                        'sivagangai' => 'sivagangai',
-                        'tanjore' => 'tanjore',
-                        'theni' => 'theni',
-                        'thenkasi' => 'thenkasi',
-                        'thiruchirapalli' => 'thiruchirapalli',
-                        'thirunelveli' => 'thirunelveli',
-                        'thirupathur' => 'thirupathur',
-                        'thiruvarur' => 'thiruvarur',
-                        'thoothukudi' => 'thoothukudi',
-                        'tirupur' => 'tirupur',
-                        'tiruvallur' => 'tiruvallur',
-                        'tiruvannamalai' => 'tiruvannamalai',
-                        'vellore' => 'vellore',
-                        'villupuram' => 'villupuram',
-                        'virudhunagar' => 'virudhunagar',
+                        'chennai' => '/news/district/chennai',
+                        'ariyalur' => '/news/district/ariyalur',
+                        'chengalpattu' => '/news/district/chengalpattu',
+                        'coimbatore' => '/news/district/coimbatore',
+                        'cuddalore' => '/news/district/cuddalore',
+                        'dharmapuri' => '/news/district/dharmapuri',
+                        'dindugal' => '/news/district/dindugal',
+                        'erode' => '/news/district/erode',
+                        'kaanchepuram' => '/news/district/kaanchepuram',
+                        'kallakurichi' => '/news/district/kallakurichi',
+                        'kanyakumari' => '/news/district/kanyakumari',
+                        'karur' => '/news/district/karur',
+                        'krishnagiri' => '/news/district/krishnagiri',
+                        'madurai' => '/news/district/madurai',
+                        'mayiladuthurai' => '/news/district/mayiladuthurai',
+                        'nagapattinam' => '/news/district/nagapattinam',
+                        'namakal' => '/news/district/namakal',
+                        'nilgiris' => '/news/district/nilgiris',
+                        'perambalur' => '/news/district/perambalur',
+                        'pudukottai' => '/news/district/pudukottai',
+                        'ramanathapuram' => '/news/district/ramanathapuram',
+                        'ranipettai' => '/news/district/ranipettai',
+                        'salem' => '/news/district/salem',
+                        'sivagangai' => '/news/district/sivagangai',
+                        'tanjore' => '/news/district/tanjore',
+                        'theni' => '/news/district/theni',
+                        'thenkasi' => '/news/district/thenkasi',
+                        'thiruchirapalli' => '/news/district/thiruchirapalli',
+                        'thirunelveli' => '/news/district/thirunelveli',
+                        'thirupathur' => '/news/district/thirupathur',
+                        'thiruvarur' => '/news/district/thiruvarur',
+                        'thoothukudi' => '/news/district/thoothukudi',
+                        'tirupur' => '/news/district/tirupur',
+                        'tiruvallur' => '/news/district/tiruvallur',
+                        'tiruvannamalai' => '/news/district/tiruvannamalai',
+                        'vellore' => '/news/district/vellore',
+                        'villupuram' => '/news/district/villupuram',
+                        'virudhunagar' => '/news/district/virudhunagar',
                     ],
                     'cinema' => [
-                        'news' => 'cinema/cinemanews',
-                        'gossip' => 'cinema/gossip',
+                        'news' => '/cinema/cinemanews',
+                        'gossip' => '/cinema/gossip',
                     ],
                 ],
             ],

From eb21e97d014decf37bdaef5e7c6254607db12c71 Mon Sep 17 00:00:00 2001
From: Tostiman <18124323+t0stiman@users.noreply.github.com>
Date: Wed, 16 Oct 2024 18:37:30 +0200
Subject: [PATCH 497/716] [OvertakeBridge] Renamed RaceDepartmentBridge to
 OvertakeBridge (#4294)

---
 .../{RaceDepartmentBridge.php => OvertakeBridge.php}   | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)
 rename bridges/{RaceDepartmentBridge.php => OvertakeBridge.php} (78%)

diff --git a/bridges/RaceDepartmentBridge.php b/bridges/OvertakeBridge.php
similarity index 78%
rename from bridges/RaceDepartmentBridge.php
rename to bridges/OvertakeBridge.php
index a601b4d6..6de15276 100644
--- a/bridges/RaceDepartmentBridge.php
+++ b/bridges/OvertakeBridge.php
@@ -1,16 +1,16 @@
 <?php
 
-class RaceDepartmentBridge extends FeedExpander
+class OvertakeBridge extends FeedExpander
 {
-    const NAME = 'RaceDepartment News';
-    const URI = 'https://racedepartment.com/';
-    const DESCRIPTION = 'Get the latest (sim)racing news from RaceDepartment.';
+    const NAME = 'Overtake News';
+    const URI = 'https://www.overtake.gg/';
+    const DESCRIPTION = 'Get the latest (sim)racing news from Overtake.';
     const MAINTAINER = 't0stiman';
     const DONATION_URI = 'https://ko-fi.com/tostiman';
 
     public function collectData()
     {
-        $this->collectExpandableDatas('https://www.racedepartment.com/ams/index.rss', 10);
+        $this->collectExpandableDatas('https://www.overtake.gg/ams/index.rss', 10);
     }
 
     protected function parseItem(array $item)

From 3a5de759fa74252d8ea7c76e84d7a552bd5af8fb Mon Sep 17 00:00:00 2001
From: Tostiman <18124323+t0stiman@users.noreply.github.com>
Date: Wed, 16 Oct 2024 18:57:44 +0200
Subject: [PATCH 498/716] [CarThrottleBridge] update for new layout (#4285)

---
 bridges/CarThrottleBridge.php | 23 +++++++----------------
 1 file changed, 7 insertions(+), 16 deletions(-)

diff --git a/bridges/CarThrottleBridge.php b/bridges/CarThrottleBridge.php
index 0a05ee60..2b8ca2b2 100644
--- a/bridges/CarThrottleBridge.php
+++ b/bridges/CarThrottleBridge.php
@@ -80,31 +80,22 @@ class CarThrottleBridge extends BridgeAbstract
 
             $item['author'] = $this->parseAuthor($articlePage);
 
-            $articleElement = $articlePage->find('article')[0];
+            $articleImage = $articlePage->find('div.block-layout-field-image')[0];
+            $article = $articlePage->find('div.block-layout-body')[1];
 
             //remove ads
-            foreach ($articleElement->find('aside') as $ad) {
+            foreach ($article->find('aside') as $ad) {
                 $ad->outertext = '';
             }
 
-            $summary = $articleElement->find('div.summary')[0];
-
-            //remove header so we are left with the article content
-            foreach ($articleElement->find('header') as $found) {
-                $found->outertext = '';
-            }
-
-            //remove comments (registering on carthrottle.com is impossible so the comment sections are empty anyway)
-            foreach ($articleElement->find('#lbs-comments') as $found) {
-                $found->outertext = '';
-            }
+            $summary = $articlePage->find('div.summary')[0];
 
             //these are supposed to be hidden
-            foreach ($articleElement->find('.visually-hidden') as $found) {
+            foreach ($article->find('.visually-hidden') as $found) {
                 $found->outertext = '';
             }
 
-            $item['content'] = $summary . $articleElement;
+            $item['content'] = $summary . $articleImage . $article;
 
             array_push($this->items, $item);
         }
@@ -117,7 +108,7 @@ class CarThrottleBridge extends BridgeAbstract
             return '';
         }
 
-        $a = $authorDivs[0]->find('a');
+        $a = $authorDivs[0]->find('a')[0];
         if ($a) {
             return $a->innertext;
         }

From cdf21d48e5dbdd09f41528cc9e522507d67adf71 Mon Sep 17 00:00:00 2001
From: Eugene Molotov <eugene.molotov@yandex.ru>
Date: Wed, 16 Oct 2024 21:58:18 +0500
Subject: [PATCH 499/716] [RutubeBridge] Multiple fixes (#4284)

---
 bridges/RutubeBridge.php | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/bridges/RutubeBridge.php b/bridges/RutubeBridge.php
index f8e106c8..6e48c27a 100644
--- a/bridges/RutubeBridge.php
+++ b/bridges/RutubeBridge.php
@@ -66,7 +66,15 @@ class RutubeBridge extends BridgeAbstract
     {
         $jsonDataRegex = '/window.reduxState = (.*);/';
         preg_match($jsonDataRegex, $html, $matches) or returnServerError('Could not find reduxState');
-        return json_decode(str_replace('\x', '\\\x', $matches[1]));
+        $map = [
+            '\x26' => '&',
+            '\x3c' => '<',
+            '\x3d' => '=',
+            '\x3e' => '>',
+            '\x3f' => '?',
+        ];
+        $jsonString = str_replace(array_keys($map), array_values($map), $matches[1]);
+        return json_decode($jsonString, false);
     }
 
     private function getVideosFromReduxState()
@@ -77,8 +85,10 @@ class RutubeBridge extends BridgeAbstract
         $reduxState = $this->getJSONData($html);
         $videos = [];
         if ($this->getInput('c')) {
-            $videos = $reduxState->userChannel->videos->results;
-            $this->title = $reduxState->userChannel->info->name;
+            $videosMethod = 'videos(' . $this->getInput('c') . ')';
+            $channelInfoMethod = 'channelInfo({"userChannelId":' . $this->getInput('c') . '})';
+            $videos = $reduxState->api->queries->$videosMethod->data->results;
+            $this->title = $reduxState->api->queries->$channelInfoMethod->data->name;
         } elseif ($this->getInput('p')) {
             $playListVideosMethod = 'getPlaylistVideos(' . $this->getInput('p') . ')';
             $videos = $reduxState->api->queries->$playListVideosMethod->data->results;

From f89c75b4b8d7bf054fccd2905b7de6eb97f73c91 Mon Sep 17 00:00:00 2001
From: Pavel Korytov <thexcloud@gmail.com>
Date: Wed, 16 Oct 2024 19:59:36 +0300
Subject: [PATCH 500/716] [ArsTechnicaBridge] Fix the bridge after redesign
 (#4282)

---
 bridges/ArsTechnicaBridge.php | 79 +++++++++++++++++++++++++++--------
 1 file changed, 61 insertions(+), 18 deletions(-)

diff --git a/bridges/ArsTechnicaBridge.php b/bridges/ArsTechnicaBridge.php
index fcb1bd4f..ac722dc9 100644
--- a/bridges/ArsTechnicaBridge.php
+++ b/bridges/ArsTechnicaBridge.php
@@ -37,39 +37,82 @@ class ArsTechnicaBridge extends FeedExpander
     {
         $item_html = getSimpleHTMLDOMCached($item['uri']);
         $item_html = defaultLinkTo($item_html, self::URI);
-        $item['content'] = $item_html->find('.article-content', 0);
+
+        $content = '';
+        $header = $item_html->find('article header', 0);
+        $leading = $header->find('p[class*=leading]', 0);
+        if ($leading != null) {
+            $content .= '<p>' . $leading->innertext . '</p>';
+        }
+        $intro_image = $header->find('img.intro-image', 0);
+        if ($intro_image != null) {
+            $content .= '<figure>' . $intro_image;
+
+            $image_caption = $header->find('.caption .caption-content', 0);
+            if ($image_caption != null) {
+                $content .= '<figcaption>' . $image_caption->innertext . '</figcaption>';
+            }
+            $content .= '</figure>';
+        }
+
+        foreach ($item_html->find('.post-content') as $content_tag) {
+            $content .= $content_tag->innertext;
+        }
+
+        $item['content'] = str_get_html($content);
 
         $parsely = $item_html->find('[name="parsely-page"]', 0);
         $parsely_json = json_decode(html_entity_decode($parsely->content), true);
         $item['categories'] = $parsely_json['tags'];
 
-        $pages = $item_html->find('nav.page-numbers > .numbers > a', -2);
-        if (null !== $pages) {
-            for ($i = 2; $i <= $pages->innertext; $i++) {
-                $page_url = $item['uri'] . '&page=' . $i;
-                $page_html = getSimpleHTMLDOMCached($page_url);
-                $page_html = defaultLinkTo($page_html, self::URI);
-                $item['content'] .= $page_html->find('.article-content', 0);
+        // Some lightboxes are nested in figures. I'd guess that's a
+        // bug in the website
+        foreach ($item['content']->find('figure div div.ars-lightbox') as $weird_lightbox) {
+            $weird_lightbox->parent->parent->outertext = $weird_lightbox;
+        }
+
+        // It's easier to reconstruct the whole thing than remove
+        // duplicate reactive tags
+        foreach ($item['content']->find('.ars-lightbox') as $lightbox) {
+            $lightbox_content = '';
+            foreach ($lightbox->find('.ars-lightbox-item') as $lightbox_item) {
+                $img = $lightbox_item->find('img', 0);
+                if ($img != null) {
+                    $lightbox_content .= '<figure>' . $img;
+                    $caption = $lightbox_item->find('div.pswp-caption-content', 0);
+                    if ($caption != null) {
+                        $credit = $lightbox_item->find('div.ars-gallery-caption-credit', 0);
+                        if ($credit != null) {
+                            $credit->innertext = 'Credit: ' . $credit->innertext;
+                        }
+                        $lightbox_content .= '<figcaption>' . $caption->innertext . '</figcaption>';
+                    }
+                    $lightbox_content .= '</figure>';
+                }
             }
-            $item['content'] = str_get_html($item['content']);
+            $lightbox->innertext = $lightbox_content;
         }
 
         // remove various ars advertising
-        $item['content']->find('#social-left', 0)->remove();
-        foreach ($item['content']->find('.ars-component-buy-box') as $ad) {
+        foreach ($item['content']->find('.ars-interlude-container') as $ad) {
             $ad->remove();
         }
-        foreach ($item['content']->find('.ad_wrapper') as $ad) {
-            $ad->remove();
+        foreach ($item['content']->find('.toc-container') as $toc) {
+            $toc->remove();
         }
-        foreach ($item['content']->find('.sidebar') as $ad) {
-            $ad->remove();
+
+        // Mostly YouTube videos
+        $iframes = $item['content']->find('iframe');
+        foreach ($iframes as $iframe) {
+            $iframe->outertext = '<a href="' . $iframe->src . '">' . $iframe->src . '</a>';
+        }
+        // This fixed padding around the former iframes and actual inline videos
+        foreach ($item['content']->find('div[style*=aspect-ratio]') as $styled) {
+            $styled->removeAttribute('style');
         }
 
         $item['content'] = backgroundToImg($item['content']);
-
-        $item['uid'] = explode('=', $item['uri'])[1];
-
+        $item['uid'] = strval($parsely_json['post_id']);
         return $item;
     }
 }

From bd823100cdf1b05a52a11ead7267a05a297095e0 Mon Sep 17 00:00:00 2001
From: vlnst <freebreeze1@protonmail.com>
Date: Wed, 16 Oct 2024 20:04:26 +0300
Subject: [PATCH 501/716] [maint] Update instance location (#4279)

---
 docs/01_General/06_Public_Hosts.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/01_General/06_Public_Hosts.md b/docs/01_General/06_Public_Hosts.md
index fa8d5fdd..7d921d20 100644
--- a/docs/01_General/06_Public_Hosts.md
+++ b/docs/01_General/06_Public_Hosts.md
@@ -24,7 +24,7 @@
 | ![](https://iplookup.flagfox.net/images/h16/UA.png) | https://rss.noleron.com | ![](https://img.shields.io/website/https/rss.noleron.com) | [@ihor](https://noleron.com/about) | Hosted with Hosting Ukraine, Ukraine
 | ![](https://iplookup.flagfox.net/images/h16/IN.png) | https://rssbridge.projectsegfau.lt | ![](https://img.shields.io/website/https/rssbridge.projectsegfau.lt) | [@gi-yt](https://aryak.me) | Self-Hosted at Mumbai, India with Airtel (ISP) |
 | ![](https://iplookup.flagfox.net/images/h16/US.png) | https://rb.vern.cc | ![](https://img.shields.io/website/https/rb.vern.cc.svg) | [@vern.cc](https://vern.cc/en/admin) | Hosted with Hetzner, US |
-| ![](https://iplookup.flagfox.net/images/h16/RO.png) | https://rss.bloat.cat | ![](https://img.shields.io/website/https/rss.bloat.cat) | [@vlnst](https://bloat.cat/contact) | Hosted with Kyun, Romania |
+| ![](https://iplookup.flagfox.net/images/h16/DE.png) | https://rss.bloat.cat | ![](https://img.shields.io/website/https/rss.bloat.cat) | [@vlnst](https://bloat.cat/contact) | Hosted with Datalix, Germany |
 
 
 ## Inactive instances

From 5d8305067306c95297fcb1a9f504e13ac5a45452 Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Wed, 16 Oct 2024 22:43:00 +0530
Subject: [PATCH 502/716] [ForensicArchitectureBridge] Add Bridge (#4280)

---
 bridges/ForensicArchitectureBridge.php | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 bridges/ForensicArchitectureBridge.php

diff --git a/bridges/ForensicArchitectureBridge.php b/bridges/ForensicArchitectureBridge.php
new file mode 100644
index 00000000..5f024f3a
--- /dev/null
+++ b/bridges/ForensicArchitectureBridge.php
@@ -0,0 +1,25 @@
+<?php
+
+class ForensicArchitectureBridge extends BridgeAbstract
+{
+    const NAME = 'Forensic Architecture';
+    const URI = 'https://forensic-architecture.org/';
+    const DESCRIPTION = 'Generates content feeds from forensic-architecture.org';
+    const MAINTAINER = 'tillcash';
+
+    public function collectData()
+    {
+        $url = 'https://forensic-architecture.org/api/fa/v1/investigations';
+        $jsonData = json_decode(getContents($url));
+
+        foreach ($jsonData->investigations as $investigation) {
+            $this->items[] = [
+                'content' => $investigation->abstract,
+                'timestamp' => $investigation->publication_date,
+                'title' => $investigation->title,
+                'uid' => $investigation->id,
+                'uri' => self::URI . 'investigation/' . $investigation->slug,
+            ];
+        }
+    }
+}

From 0c96a47e8cd1c9567e1638b820be95f875d0716b Mon Sep 17 00:00:00 2001
From: somini <somini@users.noreply.github.com>
Date: Wed, 16 Oct 2024 18:14:06 +0100
Subject: [PATCH 503/716] Remove PanacheDigitalGamesBridge (#4277)

The Blog has a feed now:

https://panachedigitalgames.com/en/feed/
---
 bridges/PanacheDigitalGamesBridge.php | 50 ---------------------------
 1 file changed, 50 deletions(-)
 delete mode 100644 bridges/PanacheDigitalGamesBridge.php

diff --git a/bridges/PanacheDigitalGamesBridge.php b/bridges/PanacheDigitalGamesBridge.php
deleted file mode 100644
index bb0c00b9..00000000
--- a/bridges/PanacheDigitalGamesBridge.php
+++ /dev/null
@@ -1,50 +0,0 @@
-<?php
-
-class PanacheDigitalGamesBridge extends BridgeAbstract
-{
-    const NAME = 'Panache Digital Games';
-    const URI = 'https://www.panachedigitalgames.com';
-    const DESCRIPTION = 'Panache Digital Games News Blog';
-    const MAINTAINER = 'somini';
-    const PARAMETERS = [
-    ];
-
-    public function getIcon()
-    {
-        return 'https://www.panachedigitalgames.com/favicon-32x32.png';
-    }
-
-    public function getURI()
-    {
-        return self::URI . '/en/news/';
-    }
-
-    public function collectData()
-    {
-        $articles = $this->getURI();
-        $html = getSimpleHTMLDOMCached($articles);
-
-        foreach ($html->find('.news-item') as $element) {
-            $item = [];
-
-            $title = $element->find('.news-item-texts-title', 0);
-            $link = $element->find('.news-item-texts a', 0);
-            $timestamp = $element->find('.news-item-texts-date', 0);
-
-            $item['title'] = $title->plaintext;
-            $item['uri'] = self::URI . $link->href;
-            $item['timestamp'] = strtotime($timestamp->plaintext);
-
-            $image_html = $element->find('.news-item-thumbnail-image', 0);
-            if ($image_html) {
-                $image_strings = explode('\'', $image_html);
-
-                if (count($image_strings) == 4) {
-                    $item['content'] = '<img src="' . $image_strings[1] . '" />';
-                }
-            }
-
-            $this->items[] = $item;
-        }
-    }
-}

From e7d6f89887f49b4ff86a34f2095017f4d8495569 Mon Sep 17 00:00:00 2001
From: Bocki <henning@bocklage.com>
Date: Wed, 16 Oct 2024 19:21:24 +0200
Subject: [PATCH 504/716] [ForensicArchitecture] Remove for bugfixing (#4297)

---
 bridges/ForensicArchitectureBridge.php | 25 -------------------------
 1 file changed, 25 deletions(-)
 delete mode 100644 bridges/ForensicArchitectureBridge.php

diff --git a/bridges/ForensicArchitectureBridge.php b/bridges/ForensicArchitectureBridge.php
deleted file mode 100644
index 5f024f3a..00000000
--- a/bridges/ForensicArchitectureBridge.php
+++ /dev/null
@@ -1,25 +0,0 @@
-<?php
-
-class ForensicArchitectureBridge extends BridgeAbstract
-{
-    const NAME = 'Forensic Architecture';
-    const URI = 'https://forensic-architecture.org/';
-    const DESCRIPTION = 'Generates content feeds from forensic-architecture.org';
-    const MAINTAINER = 'tillcash';
-
-    public function collectData()
-    {
-        $url = 'https://forensic-architecture.org/api/fa/v1/investigations';
-        $jsonData = json_decode(getContents($url));
-
-        foreach ($jsonData->investigations as $investigation) {
-            $this->items[] = [
-                'content' => $investigation->abstract,
-                'timestamp' => $investigation->publication_date,
-                'title' => $investigation->title,
-                'uid' => $investigation->id,
-                'uri' => self::URI . 'investigation/' . $investigation->slug,
-            ];
-        }
-    }
-}

From e5e2059ed777dde67bb5e8adb8303134d48c6f9e Mon Sep 17 00:00:00 2001
From: Bocki <henning@bocklage.com>
Date: Wed, 16 Oct 2024 19:46:56 +0200
Subject: [PATCH 505/716] [maint] Update all workflow action versions (#4298)

---
 .github/workflows/dockerbuild.yml   | 12 ++++++------
 .github/workflows/documentation.yml |  2 +-
 .github/workflows/lint.yml          |  6 +++---
 .github/workflows/tests.yml         |  2 +-
 4 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/.github/workflows/dockerbuild.yml b/.github/workflows/dockerbuild.yml
index 82d8611a..39645558 100644
--- a/.github/workflows/dockerbuild.yml
+++ b/.github/workflows/dockerbuild.yml
@@ -21,7 +21,7 @@ jobs:
       -  
         name: Docker meta
         id: docker_meta
-        uses: docker/metadata-action@v4
+        uses: docker/metadata-action@v5
         with:
           images: |
             ${{ env.DOCKERHUB_SLUG }}
@@ -33,26 +33,26 @@ jobs:
             type=raw,value=stable,enable=${{ startsWith(github.ref, 'refs/tags/20') }}
       -
         name: Set up QEMU
-        uses: docker/setup-qemu-action@v2
+        uses: docker/setup-qemu-action@v3
       -
         name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v2
+        uses: docker/setup-buildx-action@v3
       -
         name: Login to DockerHub
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           username: ${{ secrets.DOCKER_USERNAME }}
           password: ${{ secrets.DOCKER_PASSWORD }}
       -
         name: Login to GitHub Container Registry
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
       -
         name: Build and push
-        uses: docker/bake-action@v2
+        uses: docker/bake-action@v5
         with:
           files: |
             ./docker-bake.hcl
diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index b00c898a..e0201022 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -9,7 +9,7 @@ jobs:
   documentation:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
       with:
         persist-credentials: false
     - name: Setup PHP
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 83911ab6..206b53de 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -13,7 +13,7 @@ jobs:
       matrix:
         php-versions: ['7.4']
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}
@@ -26,7 +26,7 @@ jobs:
       matrix:
         php-versions: ['7.4']
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}
@@ -38,7 +38,7 @@ jobs:
   executable_php_files_check:
     runs-on: ubuntu-20.04
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - run: |
           if find -name "*.php" -executable -type f -print -exec false {} +
           then
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index e7684e6b..af7dc29c 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -13,7 +13,7 @@ jobs:
       matrix:
         php-versions: ['7.4', '8.0', '8.1']
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}

From 776e27218ad03cd9299319be2100d4065bba566b Mon Sep 17 00:00:00 2001
From: Bocki <henning@bocklage.com>
Date: Thu, 17 Oct 2024 00:00:52 +0200
Subject: [PATCH 506/716] [maint] fix phpunit test (#4300)

---
 .github/workflows/tests.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index af7dc29c..93f07b0f 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -17,5 +17,7 @@ jobs:
       - uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-versions }}
+        env:
+          update: true
       - run: composer install
       - run: composer test

From 70cf917f090bea8b98e62f9e10aa99d946bd9106 Mon Sep 17 00:00:00 2001
From: Bocki <henning@bocklage.com>
Date: Thu, 17 Oct 2024 00:09:35 +0200
Subject: [PATCH 507/716] [ForensicArchitecture] Create
 ForensicArchitectureBridge.php (#4301)

---
 bridges/ForensicArchitectureBridge.php | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 bridges/ForensicArchitectureBridge.php

diff --git a/bridges/ForensicArchitectureBridge.php b/bridges/ForensicArchitectureBridge.php
new file mode 100644
index 00000000..5f024f3a
--- /dev/null
+++ b/bridges/ForensicArchitectureBridge.php
@@ -0,0 +1,25 @@
+<?php
+
+class ForensicArchitectureBridge extends BridgeAbstract
+{
+    const NAME = 'Forensic Architecture';
+    const URI = 'https://forensic-architecture.org/';
+    const DESCRIPTION = 'Generates content feeds from forensic-architecture.org';
+    const MAINTAINER = 'tillcash';
+
+    public function collectData()
+    {
+        $url = 'https://forensic-architecture.org/api/fa/v1/investigations';
+        $jsonData = json_decode(getContents($url));
+
+        foreach ($jsonData->investigations as $investigation) {
+            $this->items[] = [
+                'content' => $investigation->abstract,
+                'timestamp' => $investigation->publication_date,
+                'title' => $investigation->title,
+                'uid' => $investigation->id,
+                'uri' => self::URI . 'investigation/' . $investigation->slug,
+            ];
+        }
+    }
+}

From 664436c5f4c9520b039ffcc7d23cb9c788b1e343 Mon Sep 17 00:00:00 2001
From: Bocki <henning@bocklage.com>
Date: Thu, 17 Oct 2024 01:25:07 +0200
Subject: [PATCH 508/716] [prtester] Optimize tester workflow (#4303)

---
 .github/workflows/prhtmlgenerator.yml | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/.github/workflows/prhtmlgenerator.yml b/.github/workflows/prhtmlgenerator.yml
index 90343973..c0105e29 100644
--- a/.github/workflows/prhtmlgenerator.yml
+++ b/.github/workflows/prhtmlgenerator.yml
@@ -5,9 +5,24 @@ on:
     branches: [ master ]
 
 jobs:
+  check-bridges:
+    name: Check if bridges were changed
+    runs-on: ubuntu-latest
+    outputs:
+      BRIDGES: ${{ steps.check1.outputs.BRIDGES }}
+    steps:
+      - name: Check number of bridges
+        id: check1
+        run: |
+          PR=${{github.event.number}};
+          wget https://patch-diff.githubusercontent.com/raw/$GITHUB_REPOSITORY/pull/$PR.patch;
+          bridgeamount=$(cat $PR.patch | grep "\bbridges/[A-Za-z0-9]*Bridge\.php\b" | sed "s=.*\bbridges/\([A-Za-z0-9]*\)Bridge\.php\b.*=\1=g" | sort | uniq | wc -l);
+          echo "BRIDGES=$bridgeamount" >> "$GITHUB_OUTPUT"
   test-pr:
     name: Generate HTML
     runs-on: ubuntu-latest
+    needs: check-bridges
+    if: needs.check-bridges.outputs.BRIDGES > 0
     env:
       PYTHONUNBUFFERED: 1
     # Needs additional permissions https://github.com/actions/first-interaction/issues/10#issuecomment-1041402989

From 56994b3b5c732089548c7fba49286916550e569a Mon Sep 17 00:00:00 2001
From: Alexander Sulfrian <alexander@sulfrian.net>
Date: Thu, 17 Oct 2024 08:47:44 +0200
Subject: [PATCH 509/716] [ZeitBridge] Remove content from original feed
 (#4260)

The original feed contains a small version of the header image and
the summary or a literal "None". The header image is already added, but
the original content was kept. This removes the original content and
adds the summary if it exists.
---
 bridges/ZeitBridge.php | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/bridges/ZeitBridge.php b/bridges/ZeitBridge.php
index ae8a1a66..d4d66a1c 100644
--- a/bridges/ZeitBridge.php
+++ b/bridges/ZeitBridge.php
@@ -117,6 +117,14 @@ class ZeitBridge extends FeedExpander
             }, $authors));
         }
 
+        $item['content'] = '';
+
+        // summary
+        $summary = $article->find('.summary');
+        if ($summary) {
+            $item['content'] .= implode('', $summary);
+        }
+
         // header image
         $headerimg = $article->find('*[data-ct-row="headerimage"]', 0) ?? $article->find('.article-header', 0) ?? $article->find('header', 0);
         if ($headerimg) {

From bd88bc27d3113717caf28023bbeb39a02f58901f Mon Sep 17 00:00:00 2001
From: Tostiman <18124323+t0stiman@users.noreply.github.com>
Date: Thu, 17 Oct 2024 14:14:51 +0200
Subject: [PATCH 510/716] [TheDrive] New bridge (#4304)

---
 bridges/TheDriveBridge.php | 45 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 bridges/TheDriveBridge.php

diff --git a/bridges/TheDriveBridge.php b/bridges/TheDriveBridge.php
new file mode 100644
index 00000000..f164dccd
--- /dev/null
+++ b/bridges/TheDriveBridge.php
@@ -0,0 +1,45 @@
+<?php
+
+class TheDriveBridge extends FeedExpander
+{
+    const NAME = 'The Drive';
+    const URI = 'https://www.thedrive.com/';
+    const DESCRIPTION = 'Car news from thedrive.com';
+    const MAINTAINER = 't0stiman';
+    const DONATION_URI = 'https://ko-fi.com/tostiman';
+
+    public function collectData()
+    {
+        $this->collectExpandableDatas('https://www.thedrive.com/feed', 20);
+    }
+
+    protected function parseItem($feedItem)
+    {
+        $item = parent::parseItem($feedItem);
+
+        //remove warzone articles
+        if (str_contains($item['uri'], 'the-war-zone')) {
+            return null;
+        }
+
+        //the first image in the article is an attachment for some reason
+        foreach ($item['enclosures'] as $attachment) {
+            $item['content'] = '<img src="' . $attachment . '">' . $item['content'];
+        }
+        $item['enclosures'] = [];
+
+        //make youtube videos clickable
+        $html = str_get_html($item['content']);
+
+        foreach ($html->find('div.lazied-youtube-frame') as $youtubeVideoDiv) {
+            $videoID = $youtubeVideoDiv->getAttribute('data-video-id');
+
+            //place <a> around the <div>
+            $youtubeVideoDiv->outertext = '<a href="https://www.youtube.com/watch?v=' . $videoID . '">' . $youtubeVideoDiv->outertext . '</a>';
+        }
+
+        $item['content'] = $html;
+
+        return $item;
+    }
+}

From 51cdb66f9c65c41fd1c5b0564001ec5724be1575 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tu=C4=9Fhan=20Belbek?= <destructer9@gmail.com>
Date: Thu, 17 Oct 2024 14:17:48 +0200
Subject: [PATCH 511/716] [HarvardBusinessReviewBridge] Add bridge (#4293)

---
 bridges/HarvardBusinessReviewBridge.php | 88 +++++++++++++++++++++++++
 1 file changed, 88 insertions(+)
 create mode 100644 bridges/HarvardBusinessReviewBridge.php

diff --git a/bridges/HarvardBusinessReviewBridge.php b/bridges/HarvardBusinessReviewBridge.php
new file mode 100644
index 00000000..cd99a1ba
--- /dev/null
+++ b/bridges/HarvardBusinessReviewBridge.php
@@ -0,0 +1,88 @@
+<?php
+
+class HarvardBusinessReviewBridge extends BridgeAbstract
+{
+    const NAME = 'Harvard Business Review - The Latest';
+    const MAINTAINER = 'yourname';
+    const URI = 'https://hbr.org';
+    const DESCRIPTION = 'Returns the latest articles from Harvard Business Review';
+    const CACHE_TIMEOUT = 3600; // 60min
+
+    const PARAMETERS = [[
+        'postcount' => [
+            'name' => 'Limit',
+            'type' => 'number',
+            'required' => true,
+            'title' => 'Maximum number of items to return',
+            'defaultValue' => 6, //More requires clicking button "Load more"
+        ],
+    ]];
+
+    public function collectData()
+    {
+        $url = self::URI . '/the-latest';
+        $html = getSimpleHTMLDOM($url);
+
+        foreach ($html->find('li.stream-entry') as $data) {
+            // Skip if $data is null
+            if ($data === null) {
+                continue;
+            }
+
+            try {
+                // Skip entries containing the text 'stream-ad-container'
+                if ($data->innertext !== null && strpos($data->innertext, 'stream-ad-container') !== false) {
+                    continue;
+                }
+
+                // Skip entries with class 'sponsored'
+                if ($data->hasClass('sponsored')) {
+                    continue;
+                }
+
+                $item = [];
+                $linkElement = $data->find('a', 0);
+                $titleElement = $data->find('h3.hed a', 0);
+                $authorElement = $data->find('ul.byline-list li', 0);
+                $timestampElement = $data->find('li.pubdate time', 0);
+                $contentElement = $data->find('div.dek', 0);
+
+                if ($linkElement) {
+                    $item['uri'] = self::URI . $linkElement->getAttribute('href');
+                } else {
+                    continue; // Skip this entry if no link is found
+                }
+                if ($titleElement) {
+                    $item['title'] = trim($titleElement->plaintext);
+                } else {
+                    continue; // Skip this entry if no title is found
+                }
+                if ($authorElement) {
+                    $item['author'] = trim($authorElement->plaintext);
+                } else {
+                    $item['author'] = 'Unknown'; // Default value if author is missing
+                }
+                if ($timestampElement) {
+                    $item['timestamp'] = strtotime($timestampElement->plaintext);
+                } else {
+                    $item['timestamp'] = time(); // Default to current time if timestamp is missing
+                }
+                if ($contentElement) {
+                    $item['content'] = trim($contentElement->plaintext);
+                } else {
+                    $item['content'] = ''; // Default to empty string if content is missing
+                }
+                $item['uid'] = hash('sha256', $item['title']);
+
+                $this->items[] = $item;
+
+                if (count($this->items) >= $this->getInput('postcount')) {
+                    break;
+                }
+            } catch (Exception $e) {
+                // Log the error if necessary
+                continue; // Skip to the next iteration on error
+            }
+        }
+    }
+}
\ No newline at end of file

From f9a51b676896126ea70ee73ff1027cbd43531d8f Mon Sep 17 00:00:00 2001
From: Jonas Taedcke <1809673+jonastaedcke@users.noreply.github.com>
Date: Fri, 18 Oct 2024 08:29:07 +0200
Subject: [PATCH 512/716] [AppleMusicBridge] Further data request to receive
 artist information. (#4271)

---
 bridges/AppleMusicBridge.php | 101 +++++++++++++++++++++++++++--------
 1 file changed, 78 insertions(+), 23 deletions(-)

diff --git a/bridges/AppleMusicBridge.php b/bridges/AppleMusicBridge.php
index 900a7009..fb1164ec 100644
--- a/bridges/AppleMusicBridge.php
+++ b/bridges/AppleMusicBridge.php
@@ -18,9 +18,42 @@ class AppleMusicBridge extends BridgeAbstract
             'required' => true,
         ],
     ]];
-    const CACHE_TIMEOUT = 21600; // 6 hours
+    const CACHE_TIMEOUT = 60 * 60 * 6; // 6 hours
+
+    private $title;
 
     public function collectData()
+    {
+        $items = $this->getJson();
+        $artist = $this->getArtist($items);
+
+        $this->title = $artist->artistName;
+
+        foreach ($items as $item) {
+            if ($item->wrapperType === 'collection') {
+                $copyright = $item->copyright ?? '';
+                $artworkUrl500 = str_replace('/100x100', '/500x500', $item->artworkUrl100);
+                $artworkUrl2000 = str_replace('/100x100', '/2000x2000', $item->artworkUrl100);
+                $escapedCollectionName = htmlspecialchars($item->collectionName);
+
+                $this->items[] = [
+                    'title' => $item->collectionName,
+                    'uri' => $item->collectionViewUrl,
+                    'timestamp' => $item->releaseDate,
+                    'enclosures' => $artworkUrl500,
+                    'author' => $item->artistName,
+                    'content' => "<figure>
+    <img srcset=\"$item->artworkUrl60 60w, $item->artworkUrl100 100w, $artworkUrl500 500w, $artworkUrl2000 2000w\" sizes=\"100%\" src=\"$artworkUrl2000\" alt=\"Cover of $escapedCollectionName\" style=\"display: block; margin: 0 auto;\" />
+    <figcaption>
+        from <a href=\"$artist->artistLinkUrl\">$item->artistName</a><br />$copyright
+    </figcaption>
+</figure>",
+                ];
+            }
+        }
+    }
+
+    private function getJson()
     {
         # Limit the amount of releases to 50
         if ($this->getInput('limit') > 50) {
@@ -29,31 +62,53 @@ class AppleMusicBridge extends BridgeAbstract
             $limit = $this->getInput('limit');
         }
 
-        $url = 'https://itunes.apple.com/lookup?id='
-            . $this->getInput('artist')
-            . '&entity=album&limit='
-            . $limit .
-            '&sort=recent';
+        $url = 'https://itunes.apple.com/lookup?id=' . $this->getInput('artist') . '&entity=album&limit=' . $limit . '&sort=recent';
         $html = getSimpleHTMLDOM($url);
-
         $json = json_decode($html);
+        $result = $json->results;
 
-        foreach ($json->results as $obj) {
-            if ($obj->wrapperType === 'collection') {
-                $copyright = $obj->copyright ?? '';
-
-                $this->items[] = [
-                    'title' => $obj->artistName . ' - ' . $obj->collectionName,
-                    'uri' => $obj->collectionViewUrl,
-                    'timestamp' => $obj->releaseDate,
-                    'enclosures' => $obj->artworkUrl100,
-                    'content' => '<a href=' . $obj->collectionViewUrl
-                    . '><img src="' . $obj->artworkUrl100 . '" /></a><br><br>'
-                    . $obj->artistName . ' - ' . $obj->collectionName
-                    . '<br>'
-                    . $copyright,
-                ];
-            }
+        if (!is_array($result) || count($result) == 0) {
+            returnServerError('There is no artist with id "' . $this->getInput('artist') . '".');
         }
+
+        return $result;
+    }
+
+    private function getArtist($json)
+    {
+        $nameArray = array_filter($json, function ($obj) {
+            return $obj->wrapperType == 'artist';
+        });
+
+        if (count($nameArray) === 1) {
+            return $nameArray[0];
+        }
+
+        return parent::getName();
+    }
+
+    public function getName()
+    {
+        if (isset($this->title)) {
+            return $this->title;
+        }
+
+        return parent::getName();
+    }
+
+    public function getIcon()
+    {
+        if (empty($this->getInput('artist'))) {
+            return parent::getIcon();
+        }
+
+        // it isn't necessary to set the correct artist name into the url
+        $url = 'https://music.apple.com/us/artist/jon-bellion/' . $this->getInput('artist');
+        $html = getSimpleHTMLDOMCached($url);
+        $image = $html->find('meta[property="og:image"]', 0)->content;
+
+        $imageUpdatedSize = preg_replace('/\/\d*x\d*cw/i', '/144x144-999', $image);
+
+        return $imageUpdatedSize;
     }
 }

From b9eb3c887af0a82d71cead3dcdab2a86659260a7 Mon Sep 17 00:00:00 2001
From: somini <somini@users.noreply.github.com>
Date: Fri, 18 Oct 2024 07:31:08 +0100
Subject: [PATCH 513/716] [PCGWNewsBridge] Remove bridge (#4305)

Fix #4291
---
 bridges/PCGWNewsBridge.php | 38 --------------------------------------
 1 file changed, 38 deletions(-)
 delete mode 100644 bridges/PCGWNewsBridge.php

diff --git a/bridges/PCGWNewsBridge.php b/bridges/PCGWNewsBridge.php
deleted file mode 100644
index 4b3a7c76..00000000
--- a/bridges/PCGWNewsBridge.php
+++ /dev/null
@@ -1,38 +0,0 @@
-<?php
-
-class PCGWNewsBridge extends FeedExpander
-{
-    const MAINTAINER = 'somini';
-    const NAME = 'PCGamingWiki News';
-    const BASE_URI = 'https://www.pcgamingwiki.com';
-    const URI = self::BASE_URI . '/wiki/PCGamingWiki:News';
-    const DESCRIPTION = 'PCGW News Feed';
-
-    public function getIcon()
-    {
-        return 'https://static.pcgamingwiki.com/favicons/pcgamingwiki.png';
-    }
-
-    public function collectData()
-    {
-        $html = getSimpleHTMLDOM($this->getURI());
-
-        $now = strtotime('now');
-
-        foreach ($html->find('.mw-parser-output .news_li') as $element) {
-            $item = [];
-
-            $date_string = $element->find('b', 0)->innertext;
-            $date = strtotime($date_string);
-            if ($date > $now) {
-                $date = strtotime($date_string . ' - 1 year');
-            }
-            $item['title'] = self::NAME . ' for ' . date('Y-m-d', $date);
-            $item['content'] = $element;
-            $item['uri'] = $this->getURI();
-            $item['timestamp'] = $date;
-
-            $this->items[] = $item;
-        }
-    }
-}

From 668f3a9d7e244e7969d3dd5fdac3f87c6fc88a66 Mon Sep 17 00:00:00 2001
From: Arnav Jain <ajain-93@users.noreply.github.com>
Date: Sat, 19 Oct 2024 20:19:24 +0200
Subject: [PATCH 514/716] [AppleMusicBridge] fix linting error (#4308)

---
 bridges/AppleMusicBridge.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/bridges/AppleMusicBridge.php b/bridges/AppleMusicBridge.php
index fb1164ec..b633c69f 100644
--- a/bridges/AppleMusicBridge.php
+++ b/bridges/AppleMusicBridge.php
@@ -43,7 +43,10 @@ class AppleMusicBridge extends BridgeAbstract
                     'enclosures' => $artworkUrl500,
                     'author' => $item->artistName,
                     'content' => "<figure>
-    <img srcset=\"$item->artworkUrl60 60w, $item->artworkUrl100 100w, $artworkUrl500 500w, $artworkUrl2000 2000w\" sizes=\"100%\" src=\"$artworkUrl2000\" alt=\"Cover of $escapedCollectionName\" style=\"display: block; margin: 0 auto;\" />
+    <img srcset=\"$item->artworkUrl60 60w, $item->artworkUrl100 100w, $artworkUrl500 500w, $artworkUrl2000 2000w\"
+         sizes=\"100%\" src=\"$artworkUrl2000\"
+         alt=\"Cover of $escapedCollectionName\"
+         style=\"display: block; margin: 0 auto;\" />
     <figcaption>
         from <a href=\"$artist->artistLinkUrl\">$item->artistName</a><br />$copyright
     </figcaption>

From 6c88f2c21e10cdca5ab296d69ba141b263fe9704 Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Sun, 20 Oct 2024 00:18:52 +0200
Subject: [PATCH 515/716] [prtester] fix prtester no longer supporting multiple
 bridges being changed, because the filenames are not unique (#4310)

---
 .github/.gitignore  |  1 +
 .github/prtester.py | 36 ++++++++++++++++++++++++++----------
 2 files changed, 27 insertions(+), 10 deletions(-)

diff --git a/.github/.gitignore b/.github/.gitignore
index 6310b3dd..7ebb4030 100644
--- a/.github/.gitignore
+++ b/.github/.gitignore
@@ -4,3 +4,4 @@
 # Generated files
 comment*.md
 comment*.txt
+*.html
diff --git a/.github/prtester.py b/.github/prtester.py
index 53d77725..c5c5be22 100644
--- a/.github/prtester.py
+++ b/.github/prtester.py
@@ -5,6 +5,7 @@ from bs4 import BeautifulSoup
 from datetime import datetime
 from typing import Iterable
 import os
+import glob
 import urllib
 
 # This script is specifically written to be used in automation for https://github.com/RSS-Bridge/rss-bridge
@@ -14,18 +15,33 @@ import urllib
 # It also add a <base> tag with the url of em's public instance, so viewing
 # the HTML file locally will actually work as designed.
 
+ARTIFACT_FILE_EXTENSION = '.html'
+
 class Instance:
     name = ''
     url = ''
 
 def main(instances: Iterable[Instance], with_upload: bool, with_reduced_upload: bool, title: str, output_file: str):
     start_date = datetime.now()
+
+    prid = os.getenv('PR')
+    artifact_base_url = f'https://rss-bridge.github.io/rss-bridge-tests/prs/{prid}'
+    artifact_directory = os.getcwd()
+    for file in glob.glob(f'*{ARTIFACT_FILE_EXTENSION}', root_dir=artifact_directory):
+        os.remove(file)
+
     table_rows = []
     for instance in instances:
         page = requests.get(instance.url) # Use python requests to grab the rss-bridge main page
         soup = BeautifulSoup(page.content, "html.parser") # use bs4 to turn the page into soup
         bridge_cards = soup.select('.bridge-card') # get a soup-formatted list of all bridges on the rss-bridge page
-        table_rows += testBridges(instance, bridge_cards, with_upload, with_reduced_upload) # run the main scraping code with the list of bridges
+        table_rows += testBridges(
+            instance=instance,
+            bridge_cards=bridge_cards,
+            with_upload=with_upload,
+            with_reduced_upload=with_reduced_upload,
+            artifact_directory=artifact_directory,
+            artifact_base_url=artifact_base_url) # run the main scraping code with the list of bridges
     with open(file=output_file, mode='w+', encoding='utf-8') as file:
         table_rows_value = '\n'.join(sorted(table_rows))
         file.write(f'''
@@ -37,10 +53,8 @@ def main(instances: Iterable[Instance], with_upload: bool, with_reduced_upload:
 *last change: {start_date.strftime("%A %Y-%m-%d %H:%M:%S")}*
         '''.strip())
 
-def testBridges(instance: Instance, bridge_cards: Iterable, with_upload: bool, with_reduced_upload: bool) -> Iterable:
+def testBridges(instance: Instance, bridge_cards: Iterable, with_upload: bool, with_reduced_upload: bool, artifact_directory: str, artifact_base_url: str) -> Iterable:
     instance_suffix = ''
-    prid = os.getenv("PR")
-    tester_url = f'https://rss-bridge.github.io/rss-bridge-tests/prs/{prid}'
     if instance.name:
         instance_suffix = f' ({instance.name})'
     table_rows = []
@@ -105,13 +119,13 @@ def testBridges(instance: Instance, bridge_cards: Iterable, with_upload: bool, w
                             selectionvalue = selectionentry.get('value')
                             break
                 context_parameters[listname] = selectionvalue
-            termpad_url = 'about:blank'
+            artifact_url = 'about:blank'
             if error_messages:
                 status = '<br>'.join(map(lambda m: f'❌ `{m}`', error_messages))
             else:
                 # if all example/default values are present, form the full request url, run the request, add a <base> tag with
                 # the url of em's public instance to the response text (so that relative paths work, e.g. to the static css file) and
-                # then upload it to termpad.com, a pastebin-like-site.
+                # then save it to a html file.
                 context_parameters.update({
                     'action': 'display',
                     'bridge': bridgeid,
@@ -142,16 +156,18 @@ def testBridges(instance: Instance, bridge_cards: Iterable, with_upload: bool, w
                 if status_is_ok:
                     status = '✔️'
                 if with_upload and (not with_reduced_upload or not status_is_ok):
-                    filename = f'{os.getcwd()}/{instance.name}_{form_number}.html'
-                    with open(file=filename, mode='wb') as file:
+                    filename = f'{bridge_name} {form_number}{instance_suffix}{ARTIFACT_FILE_EXTENSION}'
+                    filename = re.sub(r'[^a-z0-9 \_\-\.]', '', filename, flags=re.I).replace(' ', '_')
+                    with open(file=f'{artifact_directory}/{filename}', mode='wb') as file:
                         file.write(page_text)
-            table_rows.append(f'| {bridge_name} | [{form_number} {context_name}{instance_suffix}]({tester_url}/{instance.name}_{form_number}.html) | {status} |')
+                    artifact_url = f'{artifact_base_url}/{filename}'
+            table_rows.append(f'| {bridge_name} | [{form_number} {context_name}{instance_suffix}]({artifact_url}) | {status} |')
             form_number += 1
     return table_rows
 
 def getFirstLine(value: str) -> str:
      # trim whitespace and remove text that can break the table or is simply unnecessary
-    clean_value = re.sub('^\[[^\]]+\]\s*rssbridge\.|[\|`]', '', value.strip())
+    clean_value = re.sub(r'^\[[^\]]+\]\s*rssbridge\.|[\|`]', '', value.strip())
     first_line = next(iter(clean_value.splitlines()), '')
     max_length = 250
     if (len(first_line) > max_length):

From c3dc46a307b73b30dc1ded7301209d8b74d4b6c1 Mon Sep 17 00:00:00 2001
From: Matthieu Rakotojaona <m@rako.space>
Date: Sun, 20 Oct 2024 17:16:29 +0000
Subject: [PATCH 516/716] [prtester] Update python dependency (#4311)

This is necessary for glob.glob() with the root_dir argument
---
 .github/workflows/prhtmlgenerator.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/prhtmlgenerator.yml b/.github/workflows/prhtmlgenerator.yml
index c0105e29..163d51e3 100644
--- a/.github/workflows/prhtmlgenerator.yml
+++ b/.github/workflows/prhtmlgenerator.yml
@@ -50,7 +50,7 @@ jobs:
       - name: Setup python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.7'
+          python-version: '3.13'
           cache: 'pip'
       - name: Install requirements
         run: |

From bc536f392877623ce48140a72a0025415458061d Mon Sep 17 00:00:00 2001
From: Arnav Jain <ajain-93@users.noreply.github.com>
Date: Sun, 3 Nov 2024 18:20:48 +0100
Subject: [PATCH 517/716] =?UTF-8?q?[D=C3=A4cksnackBridge]=20New=20Bridge?=
 =?UTF-8?q?=20(#4309)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* [DäcksnackBridge] new bridge

* [DäcksnackBridge] move preamble before figure
---
 bridges/DacksnackBridge.php | 104 ++++++++++++++++++++++++++++++++++++
 1 file changed, 104 insertions(+)
 create mode 100644 bridges/DacksnackBridge.php

diff --git a/bridges/DacksnackBridge.php b/bridges/DacksnackBridge.php
new file mode 100644
index 00000000..7aab48d1
--- /dev/null
+++ b/bridges/DacksnackBridge.php
@@ -0,0 +1,104 @@
+<?PHP
+
+class DacksnackBridge extends BridgeAbstract
+{
+    const NAME = 'Däcksnack';
+    const URI = 'https://www.tidningendacksnack.se';
+    const DESCRIPTION = 'Latest news by the magazine Däcksnack';
+    const MAINTAINER = 'ajain-93';
+
+    public function getIcon()
+    {
+        return self::URI . '/upload/favicon/2591047722.png';
+    }
+
+    private function parseSwedishDates($dateString)
+    {
+        // Mapping of Swedish month names to English month names
+        $monthNames = [
+            'januari' => '01',
+            'februari' => '02',
+            'mars' => '03',
+            'april' => '04',
+            'maj' => '05',
+            'juni' => '06',
+            'juli' => '07',
+            'augusti' => '08',
+            'september' => '09',
+            'oktober' => '10',
+            'november' => '11',
+            'december' => '12'
+        ];
+
+        // Split the date string into parts
+        list($day, $monthName, $year) = explode(' ', $dateString);
+
+        // Convert month name to month number
+        $month = $monthNames[$monthName];
+
+        // Format to a string recognizable by DateTime
+        $formattedDate = sprintf('%04d-%02d-%02d', $year, $month, $day);
+
+        // Create a DateTime object
+        $dateValue = new DateTime($formattedDate);
+
+        if ($dateValue) {
+            $dateValue->setTime(0, 0); // Set time to 00:00
+            return $dateValue->getTimestamp();
+        }
+
+        return $dateValue ? $dateValue->getTimestamp() : false;
+    }
+
+    public function collectData()
+    {
+        $NEWSURL = self::URI;
+        $html = getSimpleHTMLDOMCached($NEWSURL, 18000) or
+            returnServerError('Could not request: ' . $NEWSURL);
+
+        foreach ($html->find('a.main-news-item') as $element) {
+            // Debug::log($element);
+
+            $title = trim($element->find('h2', 0)->plaintext);
+            $category = trim($element->find('.category-tag', 0)->plaintext);
+            $url = self::URI . $element->getAttribute('href');
+            $published = $this->parseSwedishDates(trim($element->find('.published', 0)->plaintext));
+
+            $article_html = getSimpleHTMLDOMCached($url, 18000) or
+                returnServerError('Could not request: ' . $url);
+            $article_content = $article_html->find('#ctl00_ContentPlaceHolder1_NewsArticleVeiw_pnlArticle', 0);
+
+            $figure = self::URI . $article_content->find('img.news-image', 0)->getAttribute('src');
+            $figure_caption = $article_content->find('.image-description', 0)->plaintext;
+            $author = $article_content->find('span.main-article-author', 0)->plaintext;
+            $preamble = $article_content->find('h4.main-article-ingress', 0)->plaintext;
+
+            $article_text = '';
+            foreach ($article_content->find('div') as $div) {
+                if (!$div->hasAttribute('class')) {
+                    $article_text = $div;
+                }
+            }
+
+            // Use a regular expression to extract the name
+            if (preg_match('/Text:\s*(.*?)\s*Foto:/', $author, $matches)) {
+                $author = $matches[1]; // This will contain 'Jonna Jansson'
+            }
+
+            $content = '<b> [' . $category . '] <i>' . $preamble . '</i></b><br/><br/>';
+            $content .= '<figure>';
+            $content .= '<img src=' . $figure . '>';
+            $content .= '<figcaption>' . $figure_caption . '</figcaption>';
+            $content .= '</figure>';
+            $content .= $article_text;
+
+            $this->items[] = [
+                'uri' => $url,
+                'title' => $title,
+                'author' => $author,
+                'timestamp' => $published,
+                'content' => trim($content),
+            ];
+        }
+    }
+}

From 082542dabcfd0ac1b68923a438c218023353d4f9 Mon Sep 17 00:00:00 2001
From: Arnav Jain <ajain-93@users.noreply.github.com>
Date: Sun, 3 Nov 2024 18:22:44 +0100
Subject: [PATCH 518/716] [TestFaktaBridge] new bridge (#4307)

* [TestFaktaBridge] new bridge

* [TestFaktaBridge] fix linting errors
---
 bridges/TestFaktaBridge.php | 100 ++++++++++++++++++++++++++++++++++++
 1 file changed, 100 insertions(+)
 create mode 100644 bridges/TestFaktaBridge.php

diff --git a/bridges/TestFaktaBridge.php b/bridges/TestFaktaBridge.php
new file mode 100644
index 00000000..b9a65138
--- /dev/null
+++ b/bridges/TestFaktaBridge.php
@@ -0,0 +1,100 @@
+<?PHP
+
+class TestFaktaBridge extends BridgeAbstract
+{
+    const NAME = 'Testfakta';
+    const URI = 'https://www.testfakta.se';
+    const DESCRIPTION = 'Letest independent tests by Testfakta';
+    const MAINTAINER = 'ajain-93';
+
+    public function getIcon()
+    {
+        return self::URI . '/themes/testfakta/favicon.ico';
+    }
+
+    private function parseSwedishDates($dateString)
+    {
+        // Mapping of Swedish month names to English month names
+        $months = [
+            'Jan' => 'Jan',
+            'Feb' => 'Feb',
+            'Mar' => 'Mar',
+            'Apr' => 'Apr',
+            'Maj' => 'May',
+            'Jun' => 'Jun',
+            'Jul' => 'Jul',
+            'Aug' => 'Aug',
+            'Sep' => 'Sep',
+            'Okt' => 'Oct',
+            'Nov' => 'Nov',
+            'Dec' => 'Dec'
+        ];
+
+        // Replace Swedish month names with English
+        $dateString = preg_replace_callback(
+            '/\b(' . implode('|', array_keys($months)) . ')\b/',
+            function ($matches) use ($months) {
+                return $months[$matches[0]];
+            },
+            $dateString
+        );
+
+        // Create DateTime object
+        $dateValue = DateTime::createFromFormat(
+            'd M, Y',
+            trim($dateString),
+            new DateTimeZone('Europe/Stockholm')
+        );
+        if ($dateValue) {
+            $dateValue->setTime(0, 0); // Set time to 00:00
+            return $dateValue->getTimestamp();
+        }
+
+        return $dateValue ? $dateValue->getTimestamp() : false;
+    }
+
+    public function collectData()
+    {
+        $NEWSURL = self::URI . '/sv';
+        $html = getSimpleHTMLDOMCached($NEWSURL, 18000) or
+            returnServerError('Could not request: ' . $NEWSURL);
+
+        foreach ($html->find('.row-container') as $element) {
+            // Debug::log($element);
+
+            $title = $element->find('h2', 0)->plaintext;
+            $category = trim($element->find('.red-label', 0)->plaintext);
+            $url = self::URI . $element->find('a', 0)->getAttribute('href');
+            $figure = $element->find('img', 0);
+            $preamble = trim($element->find('.text', 0)->plaintext);
+
+            $article_html = getSimpleHTMLDOMCached($url, 18000) or
+                returnServerError('Could not request: ' . $url);
+            $article_content = $article_html->find('div.content', 0);
+            $article_text = $article_html->find('article', 0);
+
+            $requestor = $article_html->find('div.uppdrag', 0)->plaintext;
+            $author = trim($article_html->find('span.name', 0)->plaintext);
+            $published = $this->parseSwedishDates(
+                str_replace(
+                    'Publicerad: ',
+                    '',
+                    trim($article_html->find('span.created', 0)->plaintext)
+                )
+            );
+
+            $content = $figure . '<br/>';
+            $content .= '<b>' . strtoupper($category) . '</b>  ' . $requestor . '<br/><br/>';
+            $content .= '<b><i>' . $preamble . '</i></b><br/><br/>';
+            $content .= $article_text;
+
+            $this->items[] = [
+                'uri' => $url,
+                'title' => $title,
+                'author' => $author,
+                'timestamp' => $published,
+                'content' => trim($content),
+            ];
+        }
+    }
+}

From 29d984cbe78bddd31fa97f810f1eebd0a46cbcb7 Mon Sep 17 00:00:00 2001
From: Alexander Sulfrian <alexander@sulfrian.net>
Date: Sun, 3 Nov 2024 18:25:51 +0100
Subject: [PATCH 519/716] [TagesspiegelBridge] Add bridge for tagesspiegel.de
 (#4270)

* [TagesspiegelBridge] Add bridge for tagesspiegel.de

* [TagesspiegelBridge] Raise timtout to 60min
---
 bridges/TagesspiegelBridge.php | 221 +++++++++++++++++++++++++++++++++
 1 file changed, 221 insertions(+)
 create mode 100644 bridges/TagesspiegelBridge.php

diff --git a/bridges/TagesspiegelBridge.php b/bridges/TagesspiegelBridge.php
new file mode 100644
index 00000000..b3a3fc64
--- /dev/null
+++ b/bridges/TagesspiegelBridge.php
@@ -0,0 +1,221 @@
+<?php
+
+class TagesspiegelBridge extends FeedExpander
+{
+    const MAINTAINER = 'AlexanderS';
+    const NAME = 'Tagesspiegel Bridge';
+    const URI = 'https://www.tagesspiegel.de/';
+    const CACHE_TIMEOUT = 3600; // 60min
+    const DESCRIPTION = 'Returns the full articles instead of only the intro';
+    const PARAMETERS = [[
+        'category' => [
+            'name' => 'Category',
+            'type' => 'list',
+            'values' => [
+                'Startseite'
+                => 'https://tagesspiegel.de/contentexport/feed',
+                'Plus'
+                => 'https://tagesspiegel.de/contentexport/feed/plus/',
+                'Politik'
+                => 'https://tagesspiegel.de/contentexport/feed/politik/',
+                'Internationales'
+                => 'https://tagesspiegel.de/contentexport/feed/internationales/',
+                'Berlin'
+                => 'https://tagesspiegel.de/contentexport/feed/berlin/',
+                'Berlin - Bezirke'
+                => 'https://tagesspiegel.de/contentexport/feed/berlin/bezirke/',
+                'Berlin - Berliner Wirtschaft'
+                => 'https://tagesspiegel.de/contentexport/feed/berlin/berliner-wirtschaft/',
+                'Berlin - Berliner Sport'
+                => 'https://tagesspiegel.de/contentexport/feed/berlin/berliner_sport/',
+                'Berlin - Polizei & Justiz'
+                => 'https://tagesspiegel.de/contentexport/feed/berlin/polizei-justiz/',
+                'Berlin - Stadtleben'
+                => 'https://tagesspiegel.de/contentexport/feed/berlin/stadtleben/',
+                'Berlin - Schule'
+                => 'https://tagesspiegel.de/contentexport/feed/berlin/schule/',
+                'Gesellschaft'
+                => 'https://tagesspiegel.de/contentexport/feed/gesellschaft/',
+                'Gesellschaft - Liebe & Partnerschaft'
+                => 'https://tagesspiegel.de/contentexport/feed/gesellschaft/liebe-partnerschaft/',
+                'Gesellschaft - Queer'
+                => 'https://tagesspiegel.de/contentexport/feed/gesellschaft/queerspiegel/',
+                'Gesellschaft - Panorama'
+                => 'https://tagesspiegel.de/contentexport/feed/gesellschaft/panorama/',
+                'Gesellschaft - Medien'
+                => 'https://tagesspiegel.de/contentexport/feed/gesellschaft/medien/',
+                'Gesellschaft - Geschichte'
+                => 'https://tagesspiegel.de/contentexport/feed/gesellschaft/geschichte/',
+                'Gesellschaft - Reise'
+                => 'https://tagesspiegel.de/contentexport/feed/gesellschaft/reise/',
+                'Wirtschaft'
+                => 'https://tagesspiegel.de/contentexport/feed/wirtschaft/',
+                'Wirtschaft - Immobilien'
+                => 'https://tagesspiegel.de/contentexport/feed/wirtschaft/immobilien/',
+                'Wirtschaft - Jobs & Karriere'
+                => 'https://tagesspiegel.de/contentexport/feed/wirtschaft/karriere/',
+                'Wirtschaft - Finanzen'
+                => 'https://tagesspiegel.de/contentexport/feed/wirtschaft/finanzen/',
+                'Wirtschaft - Mobilität'
+                => 'https://tagesspiegel.de/contentexport/feed/wirtschaft/mobilitaet/',
+                'Kultur'
+                => 'https://tagesspiegel.de/contentexport/feed/kultur/',
+                'Kultur - Literatur'
+                => 'https://tagesspiegel.de/contentexport/feed/kultur/literatur/',
+                'Kultur - Comics'
+                => 'https://tagesspiegel.de/contentexport/feed/kultur/comics/',
+                'Kultur - Kino'
+                => 'https://tagesspiegel.de/contentexport/feed/kultur/kino/',
+                'Kultur - Pop'
+                => 'https://tagesspiegel.de/contentexport/feed/kultur/pop/',
+                'Kultur - Ausstellungen'
+                => 'https://tagesspiegel.de/contentexport/feed/kultur/ausstellungen/',
+                'Kultur - Bühne'
+                => 'https://tagesspiegel.de/contentexport/feed/kultur/buehne/',
+                'Wissen'
+                => 'https://tagesspiegel.de/contentexport/feed/wissen/',
+                'Gesundheit'
+                => 'https://tagesspiegel.de/contentexport/feed/gesundheit/',
+                'Sport'
+                => 'https://tagesspiegel.de/contentexport/feed/sport/',
+                'Meinung'
+                => 'https://tagesspiegel.de/contentexport/feed/meinung/',
+                'Meinung - Kolumnen'
+                => 'https://tagesspiegel.de/contentexport/feed/meinung/kolumnen/',
+                'Meinung - Lesermeinung'
+                => 'https://tagesspiegel.de/contentexport/feed/meinung/lesermeinung/',
+                'Potsdam'
+                => 'https://tagesspiegel.de/contentexport/feed/potsdam/',
+                'Potsdam - Landeshauptstadt'
+                => 'https://tagesspiegel.de/contentexport/feed/potsdam/landeshauptstadt/',
+                'Potsdam - Potsdam-Mittelmark'
+                => 'https://tagesspiegel.de/contentexport/feed/potsdam/potsdam-mittelmark/',
+                'Potsdam - Brandenburg'
+                => 'https://tagesspiegel.de/contentexport/feed/potsdam/brandenburg/',
+                'Potsdam - Kultur'
+                => 'https://tagesspiegel.de/contentexport/feed/potsdam/potsdam-kultur/',
+                'Podcasts'
+                => 'https://tagesspiegel.de/contentexport/feed/podcasts/',
+            ]
+        ],
+        'limit' => [
+            'name' => 'Limit',
+            'type' => 'number',
+            'required' => false,
+            'title' => 'Specify number of full articles to return',
+            'defaultValue' => 5
+        ]
+    ]];
+
+    public function collectData()
+    {
+        $url = $this->getInput('category');
+        $limit = $this->getInput('limit') ?: 5;
+
+        $this->collectExpandableDatas($url, $limit);
+    }
+
+    protected function parseItem(array $item)
+    {
+        $item['enclosures'] = [];
+
+        $article = getSimpleHTMLDOM($item['uri']);
+        $item = $this->parseArticle($item, $article);
+
+        return $item;
+    }
+
+    private function parseArticle($item, $article)
+    {
+        $item['categories'] = [];
+
+        // Add tag for articles only available with "Tagesspiegel Plus"
+        $plusicon = $article->find('span[data-ob="plus"]', 0);
+        if ($plusicon) {
+            $item['categories'][] = 'Tagesspiegel Plus';
+        }
+
+        // Add section from breadcrumbs as tags
+        $breadcrumbs = $article->find('ol[property="breadcrumb"]', 0);
+        $names = $breadcrumbs->find('span[property="name"]');
+        $names = array_slice($names, 1, -1);
+        foreach ($names as $name) {
+            $item['categories'][] = trim($name->plaintext);
+        }
+
+        // Get categories from article
+        $home_link = $article->find('a[data-gtm-class="article-home-link"]', 0);
+        if ($home_link) {
+            $tag_container = $home_link->parent->nextSibling();
+            if ($tag_container) {
+                $tags = $tag_container->find('li');
+
+                if ($tags) {
+                    foreach ($tags as $tag) {
+                        $item['categories'][] = trim($tag->plaintext);
+                    }
+                }
+            }
+        }
+
+        $article = $article->find('article', 0);
+
+        // Remove known bad elements
+        foreach (
+            $article->find(
+                'script, aside, nav, dl.debug-piano, .link--external svg, time, a[data-gtm-class="article-home-link"]'
+            ) as $bad
+        ) {
+            $bad->remove();
+        }
+
+        // Remove references to external content (requires javascript for consent)
+        foreach ($article->find('p') as $par) {
+            if ($par->plaintext == 'Empfohlener redaktioneller Inhalt') {
+                $par->parent->parent->parent->parent->remove();
+            }
+        }
+
+        // Reload html, as remove() is buggy
+        $article = str_get_html($article->outertext);
+
+
+        // Clean article content
+        $elements = $article->find('h3, p, figure, blockquote');
+        foreach ($elements as $i => $element) {
+            foreach ($element->find('img, picture source') as $img) {
+                // Add URI to src
+                if ($img->hasAttribute('src')) {
+                    if (str_starts_with($img->attr['src'], '/')) {
+                        $img->attr['src'] = urljoin(self::URI, $img->attr['src']);
+                    }
+                }
+
+                // Add URI to srcset
+                if ($img->hasAttribute('srcset')) {
+                    $srcsets = explode(',', $img->attr['srcset']);
+                    foreach ($srcsets as &$srcset) {
+                        $parts = explode(' ', trim($srcset));
+                        if (count($parts) > 0) {
+                            if (str_starts_with($parts[0], '/')) {
+                                $parts[0] = urljoin(self::URI, $parts[0]);
+                            }
+                        }
+                        $srcset = implode(' ', $parts);
+                    }
+                    $img->attr['srcset'] = implode(', ', $srcsets);
+                }
+            }
+
+            // Remove paragraphs that are already included in other elements
+            if ($element->tag == 'p') {
+                if ($element->parent->tag == 'blockquote' || $element->parent->tag == 'figure') {
+                    unset($elements[$i]);
+                }
+            }
+        }
+        $item['content'] = implode('', $elements);
+
+        return $item;
+    }
+}

From bd0fb1da9901d0c91b1a68a8a50046a434440caf Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Sun, 3 Nov 2024 18:28:32 +0100
Subject: [PATCH 520/716] [IdealoBridge] Fix (#4316)

When a product was available before as used product in the past, and
now it's not available used anymore, a price update article was
generated on every feed loading, because the old used price was still
stored in the cache, and therefore different as "no price".

The issue was also present in the cas of a New product price that
becomes unavailable.

Now, when either there is no New or Used price available, the previous
price is delete from the cache.
---
 bridges/IdealoBridge.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/bridges/IdealoBridge.php b/bridges/IdealoBridge.php
index f426a45c..7432f78a 100644
--- a/bridges/IdealoBridge.php
+++ b/bridges/IdealoBridge.php
@@ -152,14 +152,21 @@ class IdealoBridge extends BridgeAbstract
             $PriceNew = $FirstButton->find('strong', 0)->plaintext;
             // Save current price
             $this->saveCacheValue($KeyNEW, $PriceNew);
+        } else if ($FirstButton === null) {
+            // In case there is no actual New Price delete the previous value in the cache
+             $this->cache->delete($this->getShortName() . '_' . $KeyNEW);
         }
 
+
         // Second Button contains the used product price
         $SecondButton = $html->find('.oopStage-conditionButton-wrapper-text', 1);
         if ($SecondButton) {
             $PriceUsed = $SecondButton->find('strong', 0)->plaintext;
             // Save current price
             $this->saveCacheValue($KeyUSED, $PriceUsed);
+        } else if ($SecondButton === null) {
+            // In case there is no actual Used Price delete the previous value in the cache
+             $this->cache->delete($this->getShortName() . '_' . $KeyUSED);
         }
 
         // Only continue if a price has changed

From 8d6d0fa10c64c2ae6617d72793f45f7865c7c010 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tu=C4=9Fhan=20Belbek?= <destructer9@gmail.com>
Date: Sun, 3 Nov 2024 20:30:28 +0300
Subject: [PATCH 521/716] [DuvarOrgBridge] Add Duvar.org bridge for scraping
 news articles (#4315)

* Add Duvar.org bridge for scraping news articles

* PR Fixes

* Update DuvarOrgBridge.php to set a default value for the URL suffix

---------

Co-authored-by: Tughan Belbek <Tughan.Belbek@t-hive.io>
---
 bridges/DuvarOrgBridge.php | 86 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 86 insertions(+)
 create mode 100644 bridges/DuvarOrgBridge.php

diff --git a/bridges/DuvarOrgBridge.php b/bridges/DuvarOrgBridge.php
new file mode 100644
index 00000000..f5f01063
--- /dev/null
+++ b/bridges/DuvarOrgBridge.php
@@ -0,0 +1,86 @@
+<?php
+
+class DuvarOrgBridge extends BridgeAbstract
+{
+    const NAME = 'Duvar.org - Haberler';
+    const MAINTAINER = 'yourname';
+    const URI = 'https://duvar.org';
+    const DESCRIPTION = 'Returns the latest articles from Duvar.org - News from Turkey and the world';
+    const CACHE_TIMEOUT = 3600; // 60min
+
+    const PARAMETERS = [[
+        'postcount' => [
+            'name' => 'Limit',
+            'type' => 'number',
+            'required' => true,
+            'title' => 'Maximum number of items to return',
+            'defaultValue' => 20,
+        ],
+        'urlsuffix' => [
+            'name' => 'URL Suffix',
+            'type' => 'list',
+            'title' => 'Suffix for the URL to scrape a specific section',
+            'defaultValue' => 'Main',
+            'values' => [
+                'Main' => '',
+                'Balanced' => '/uyumlu',
+                'Protest' => '/muhalif',
+                'Center' => '/merkez',
+                'Alternative' => '/alternatif',
+                'Global' => '/global',
+            ],
+        ],
+    ]];
+
+    public function collectData()
+    {
+        $postCount = $this->getInput('postcount');
+        $urlSuffix = $this->getInput('urlsuffix');
+        $url = self::URI . $urlSuffix;
+        $html = getSimpleHTMLDOM($url);
+
+        foreach ($html->find('article.news-item') as $data) {
+            if ($data === null) {
+                continue;
+            }
+
+            try {
+                $item = [];
+                $linkElement = $data->find('h2.news-title a', 0);
+                $titleElement = $data->find('h2.news-title a', 0);
+                $timestampElement = $data->find('time.meta-tag.date-tag', 0);
+                $contentElement = $data->find('div.news-description', 0);
+
+                if ($linkElement) {
+                    $item['uri'] = $linkElement->getAttribute('href');
+                } else {
+                    continue;
+                }
+                if ($titleElement) {
+                    $item['title'] = trim($titleElement->plaintext);
+                } else {
+                    continue;
+                }
+                if ($timestampElement) {
+                    $item['timestamp'] = strtotime($timestampElement->plaintext);
+                } else {
+                    $item['timestamp'] = time();
+                }
+                if ($contentElement) {
+                    $item['content'] = trim($contentElement->plaintext);
+                } else {
+                    $item['content'] = '';
+                }
+                $item['uid'] = hash('sha256', $item['title']);
+
+                $this->items[] = $item;
+
+                if (count($this->items) >= $postCount) {
+                    break;
+                }
+            } catch (Exception $e) {
+                continue;
+            }
+        }
+    }
+}
\ No newline at end of file

From 1cd5b072f37a6cab9b183f732338e623eeadb612 Mon Sep 17 00:00:00 2001
From: Rose Liverman <paul.liverman.iii@gmail.com>
Date: Sun, 3 Nov 2024 10:33:05 -0700
Subject: [PATCH 522/716] Formatting fix "For Hosts" documentation (#4317)

---
 docs/03_For_Hosts/index.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/03_For_Hosts/index.md b/docs/03_For_Hosts/index.md
index a4e55d69..5ecbd4b7 100644
--- a/docs/03_For_Hosts/index.md
+++ b/docs/03_For_Hosts/index.md
@@ -6,7 +6,7 @@ Some bridges could be implemented more efficiently by actually using proprietary
 but there are reasons against it:
 
 - RSS-Bridge exists in the first place to NOT use APIs.
-- See [the rant](https://github.com/RSS-Bridge/rss-bridge/blob/master/README.md#Rant)
+  See [the rant](https://github.com/RSS-Bridge/rss-bridge/blob/master/README.md#Rant).
 
 - APIs require private keys that could be stored on servers running RSS-Bridge,
-- which is a security concern, involves complex authorizations for inexperienced users and could cause harm (when using paid services for example). In a closed environment (a server only you use for yourself) however you might be interested in using them anyway. So, check [this](https://github.com/RSS-Bridge/rss-bridge/pull/478/files) possible implementation of an anti-captcha solution.
+  which is a security concern, involves complex authorizations for inexperienced users and could cause harm (when using paid services for example). In a closed environment (a server only you use for yourself) however you might be interested in using them anyway. So, check [this](https://github.com/RSS-Bridge/rss-bridge/pull/478/files) possible implementation of an anti-captcha solution.

From dd165ea9d1d2306f96188943fc7441d55f4cc1e4 Mon Sep 17 00:00:00 2001
From: Dennis <Dennis.mellegaard@gmail.com>
Date: Mon, 4 Nov 2024 15:16:58 +0100
Subject: [PATCH 523/716] [HuntShowdownNewsBridge] Fetches the latest articles
 from Hunt Showdown (#4318)

* feat: add Hunt Showdown News Bridge for fetching latest news articles

* chore: clean up formatting and remove unnecessary whitespace in HuntShowdownNewsBridge.php
---
 bridges/HuntShowdownNewsBridge.php | 40 ++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 bridges/HuntShowdownNewsBridge.php

diff --git a/bridges/HuntShowdownNewsBridge.php b/bridges/HuntShowdownNewsBridge.php
new file mode 100644
index 00000000..6aca88f7
--- /dev/null
+++ b/bridges/HuntShowdownNewsBridge.php
@@ -0,0 +1,40 @@
+<?php
+
+class HuntShowdownNewsBridge extends BridgeAbstract
+{
+    const NAME = 'Hunt Showdown News Bridge';
+    const MAINTAINER = 'deffy92';
+    const URI = 'https://www.huntshowdown.com';
+    const DESCRIPTION = 'Returns the latest news from HuntShowdown.com/news';
+    const BASE_URI = 'https://www.huntshowdown.com/';
+
+    public function collectData()
+    {
+        $html = getSimpleHTMLDOM('https://www.huntshowdown.com/news/tagged/news');
+        $articles = defaultLinkTo($html, self::URI)->find('.col');
+
+        // Removing first element because it's a "load more" button
+        array_shift($articles);
+        foreach ($articles as $article) {
+            $item = [];
+
+            $article_title = $article->find('h3', 0)->plaintext;
+            $article_content = $article->find('p', 0)->plaintext;
+            $article_cover = $article->find('img', 0)->src;
+
+            // If there is a cover, add it to the content
+            if (!empty($article_cover)) {
+                $article_cover = '<img src="' . $article_cover . '" alt="' . $article_title . '"> <br/> <br/>';
+                $article_content = $article_cover . $article_content;
+            }
+
+            $item['uri'] = $article->find('a', 0)->href;
+            $item['title'] = $article_title;
+            $item['content'] = $article_content;
+            $item['enclosures'] = [$article_cover];
+            $item['timestamp'] = $article->find('span', 0)->plaintext;
+
+            $this->items[] = $item;
+        }
+    }
+}
\ No newline at end of file

From 6c86e2c1f73897180d56d0a0d10e37e8eb63dbb9 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Fri, 8 Nov 2024 08:11:18 +0100
Subject: [PATCH 524/716] [IdealoBridge] Really fix Logic and enhance Feed
 Content (#4321)

- Fix Feed Title generation (wrong usage of loadCacheValue)
- Use a more reliable way to get New and Used Price
- If no new Price and no Used Price are present in the page, then don't
  delete previous New Price and previous Used Price
- If there is no New Price and no Used Price, then return no Feed
  Item
- Fix the "now" date format
- Make the Feed Item Title more readable
- Use the Product Link as the Feed URL
---
 bridges/IdealoBridge.php | 48 ++++++++++++++++++++++++++--------------
 1 file changed, 32 insertions(+), 16 deletions(-)

diff --git a/bridges/IdealoBridge.php b/bridges/IdealoBridge.php
index 7432f78a..92bb30d0 100644
--- a/bridges/IdealoBridge.php
+++ b/bridges/IdealoBridge.php
@@ -49,7 +49,7 @@ class IdealoBridge extends BridgeAbstract
         $cacheDuration = 604800;
         $link = $this->getInput('Link');
         $keyTITLE = $link . 'TITLE';
-        $product = $this->loadCacheValue($keyTITLE, $cacheDuration);
+        $product = $this->loadCacheValue($keyTITLE);
 
         // The cache does not contain the title of the bridge, we must get it and save it in the cache
         if ($product === null) {
@@ -147,30 +147,32 @@ class IdealoBridge extends BridgeAbstract
         $OldPriceUsed = $this->loadCacheValue($KeyUSED);
 
         // First button contains the new price. Found at oopStage-conditionButton-wrapper-text class (.)
-        $FirstButton = $html->find('.oopStage-conditionButton-wrapper-text', 0);
-        if ($FirstButton) {
-            $PriceNew = $FirstButton->find('strong', 0)->plaintext;
+        $ActualNewPrice = $html->find('div[id=oopStage-conditionButton-new]', 0);
+        // Second Button contains the used product price
+        $ActualUsedPrice = $html->find('div[id=oopStage-conditionButton-used]', 0);
+
+        if ($ActualNewPrice) {
+            $PriceNew = $ActualNewPrice->find('strong', 0)->plaintext;
             // Save current price
             $this->saveCacheValue($KeyNEW, $PriceNew);
-        } else if ($FirstButton === null) {
-            // In case there is no actual New Price delete the previous value in the cache
+        } else if ($ActualNewPrice === null && $ActualUsedPrice !== null) {
+            // In case there is no actual New Price and a Ured Price exists, then delete the previous value in the cache
              $this->cache->delete($this->getShortName() . '_' . $KeyNEW);
         }
 
 
         // Second Button contains the used product price
-        $SecondButton = $html->find('.oopStage-conditionButton-wrapper-text', 1);
-        if ($SecondButton) {
-            $PriceUsed = $SecondButton->find('strong', 0)->plaintext;
+        if ($ActualUsedPrice) {
+            $PriceUsed = $ActualUsedPrice->find('strong', 0)->plaintext;
             // Save current price
             $this->saveCacheValue($KeyUSED, $PriceUsed);
-        } else if ($SecondButton === null) {
-            // In case there is no actual Used Price delete the previous value in the cache
+        } else if ($ActualUsedPrice === null && $ActualNewPrice !== null) {
+            // In case there is no actual Used Price and a New Price exists, then delete the previous value in the cache
              $this->cache->delete($this->getShortName() . '_' . $KeyUSED);
         }
 
-        // Only continue if a price has changed
-        if ($PriceNew != $OldPriceNew || $PriceUsed != $OldPriceUsed) {
+        // Only continue if a price has changed and there exists a New or Used price (sometimes no new Price _and_ Used Price are shown)
+        if (!($ActualNewPrice === null && $ActualUsedPrice === null ) && ($PriceNew != $OldPriceNew || $PriceUsed != $OldPriceUsed)) {
             // Get Product Image
             $image = $html->find('.datasheet-cover-image', 0)->src;
 
@@ -198,9 +200,9 @@ class IdealoBridge extends BridgeAbstract
             $content .= "<img src=$image>";
 
 
-            $now = date('d.m.j H:m');
+            $now = date('d/m/Y H:i');
 
-            $Pricealarm = 'Pricealarm %s: %s %s %s';
+            $Pricealarm = 'Pricealarm %s: %s %s - %s';
 
             // Currently under Max new price
             if ($this->getInput('MaxPriceNew') != '') {
@@ -247,7 +249,7 @@ class IdealoBridge extends BridgeAbstract
                         $title .= 'USED' . $this->getPriceTrend($PriceUsed, $OldPriceUsed) . ' ';
                     }
                     $title .= $Productname;
-                    $title .= ' ';
+                    $title .= ' - ';
                     $title .= $now;
 
                     $item = [
@@ -275,4 +277,18 @@ class IdealoBridge extends BridgeAbstract
                 return parent::getName();
         }
     }
+
+    /**
+     * Returns the RSS Feed URL according to the parameters
+     * @return string the RSS feed URL
+     */
+    public function getURI()
+    {
+        switch ($this->queriedContext) {
+            case '0':
+                return $this->getInput('Link');
+            default:
+                return parent::getURI();
+        }
+    }
 }

From 2294dac3f15c6eca47a47dad5f5c47750dec3647 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Sat, 23 Nov 2024 12:47:08 -0500
Subject: [PATCH 525/716] [AO3Bridge] Add fetch limit to reduce requests
 (#4328)

---
 bridges/AO3Bridge.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/bridges/AO3Bridge.php b/bridges/AO3Bridge.php
index 970ed414..7e18b657 100644
--- a/bridges/AO3Bridge.php
+++ b/bridges/AO3Bridge.php
@@ -27,6 +27,7 @@ class AO3Bridge extends BridgeAbstract
                     'Entire work' => 'all',
                 ],
             ],
+            'limit' => self::LIMIT,
         ],
         'Bookmarks' => [
             'user' => [
@@ -84,6 +85,8 @@ class AO3Bridge extends BridgeAbstract
         }
         $this->title = $heading->plaintext;
 
+        $limit = $this->getInput('limit') ?? 3;
+        $count = 0;
         foreach ($html->find('.index.group > li') as $element) {
             $item = [];
 
@@ -118,7 +121,7 @@ class AO3Bridge extends BridgeAbstract
             $item['uid'] = $item['uri'] . "/$strdate/$chapters";
 
             // Fetch workskin of desired chapter(s) in list
-            if ($this->getInput('range')) {
+            if ($this->getInput('range') && ($limit == 0 || $count++ < $limit)) {
                 $url = $item['uri'];
                 switch ($this->getInput('range')) {
                     case ('all'):

From 9457e075f6a15c702bed94cf84b62ce949815dc9 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Sat, 23 Nov 2024 12:50:40 -0500
Subject: [PATCH 526/716] [PriviblurBridge] Fix invalid favicon, use either
 Tumblr or blog icon (#4327)

---
 bridges/PriviblurBridge.php | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/bridges/PriviblurBridge.php b/bridges/PriviblurBridge.php
index 198c38bc..6b442e75 100644
--- a/bridges/PriviblurBridge.php
+++ b/bridges/PriviblurBridge.php
@@ -17,6 +17,7 @@ class PriviblurBridge extends BridgeAbstract
     ];
 
     private $title;
+    private $favicon = 'https://www.tumblr.com/favicon.ico';
 
     public function collectData()
     {
@@ -25,6 +26,11 @@ class PriviblurBridge extends BridgeAbstract
         $html = defaultLinkTo($html, $url);
         $this->title = $html->find('head title', 0)->innertext;
 
+        if ($html->find('#blog-header img.avatar', 0)) {
+            $icon = $html->find('#blog-header img.avatar', 0)->src;
+            $this->favicon = str_replace('pnj', 'png', $icon);
+        }
+
         $elements = $html->find('.post');
         foreach ($elements as $element) {
             $item = [];
@@ -64,6 +70,11 @@ class PriviblurBridge extends BridgeAbstract
 
     public function getURI()
     {
-        return $this->getInput('url') ? $this->getInput('url') : parent::getURI();
+        return $this->getInput('url') ?? parent::getURI();
+    }
+
+    public function getIcon()
+    {
+        return $this->favicon;
     }
 }

From a6e8760726c468d48ea45a3bb94577b7b94c08a8 Mon Sep 17 00:00:00 2001
From: Sebastian Wolf <117176763+swofl@users.noreply.github.com>
Date: Sat, 23 Nov 2024 18:54:21 +0100
Subject: [PATCH 527/716] [FragDenStaatBridge] add new bridge (#4330)

---
 bridges/FragDenStaatBridge.php | 78 ++++++++++++++++++++++++++++++++++
 1 file changed, 78 insertions(+)
 create mode 100644 bridges/FragDenStaatBridge.php

diff --git a/bridges/FragDenStaatBridge.php b/bridges/FragDenStaatBridge.php
new file mode 100644
index 00000000..aee1885c
--- /dev/null
+++ b/bridges/FragDenStaatBridge.php
@@ -0,0 +1,78 @@
+<?php
+
+class FragDenStaatBridge extends BridgeAbstract
+{
+    const MAINTAINER = 'swofl';
+    const NAME = 'FragDenStaat';
+    const URI = 'https://fragdenstaat.de';
+    const CACHE_TIMEOUT = 2 * 60 * 60; // 2h
+    const DESCRIPTION = 'Get latest blog posts from FragDenStaat Exklusiv';
+    const PARAMETERS = [ [
+        'qLimit' => [
+            'name' => 'Query Limit',
+            'title' => 'Amount of articles to query',
+            'type' => 'number',
+            'defaultValue' => 5,
+        ],
+    ] ];
+
+    protected function parseTeaser($teaser)
+    {
+        $result = [];
+
+        $header = $teaser->find('h3 > a', 0);
+        $result['title'] = $header->plaintext;
+        $result['uri'] = static::URI . $header->href;
+        $result['enclosures'] = [];
+        $result['enclosures'][] = $teaser->find('img', 0)->src;
+        $result['uid'] = hash('sha256', $result['title']);
+        $result['timestamp'] = strtotime($teaser->find('time', 0)->getAttribute('datetime'));
+
+        return $result;
+    }
+
+    public function collectData()
+    {
+        $html = getSimpleHTMLDOM(self::URI . '/artikel/exklusiv/');
+
+        $queryLimit = (int) $this->getInput('qLimit');
+        if ($queryLimit > 12) {
+            $queryLimit = 12;
+        }
+
+        $teasers = [];
+
+        $teaserElements = $html->find('article');
+
+        for ($i = 0; $i < $queryLimit; $i++) {
+            array_push($teasers, $this->parseTeaser($teaserElements[$i]));
+        }
+
+        foreach ($teasers as $article) {
+            $articleHtml = getSimpleHTMLDOMCached($article['uri'], static::CACHE_TIMEOUT * 6);
+            $articleCore = $articleHtml->find('article.blog-article', 0);
+
+            $content = '';
+
+            $lead = $articleCore->find('div.lead > p', 0)->innertext;
+
+            $content .= '<h2>' . $lead . '</h2>';
+
+            foreach ($articleCore->find('div.blog-content > p, div.blog-content > h3') as $paragraph) {
+                $content .= $paragraph->outertext;
+            }
+
+            $article['content'] = '<img src="' . $article['enclosures'][0] . '"/>' . $content;
+
+            $article['author'] = '';
+
+            foreach ($articleCore->find('a[rel="author"]') as $author) {
+                $article['author'] .= $author->innertext . ', ';
+            }
+
+            $article['author'] = rtrim($article['author'], ', ');
+
+            $this->items[] = $article;
+        }
+    }
+}

From 2ee615e5882d5f68c500d863a675cfeb82320366 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Sat, 23 Nov 2024 19:11:36 +0100
Subject: [PATCH 528/716] [PepperBridgeAbstract, DealabsBridge,
 HotUKDealsBridge, MydealsBridge] Streamlining Group Management (#4336)

* [PepperBridgeAbstract, DealabsBridge, HotUKDealsBridge, MydealsBridge] Streamlining Group Management

Since groups can change URLs, be created, or removed at the discretion
of website administrators, maintaining a valid and functional list of
groups is impractical.

Users can now enter the part of the URL that defines the group in a text
field, rather than searching through a lengthy, likely outdated list.

The way the RSS feed title is retrieved had to be adjusted accordingly.

Titles are now cached for 15 days to avoid unnecessary website access
and to prevent potential bot blocking.

Existing feeds will continue to work, as their parameters remain
unchanged; only the method for inputting them has been modified.

* [PepperBridgeAbstract, DealabsBridge, HotUKDealsBridge, MydealsBridge] Streamlining Group Management

Coding policy fixes

* [PepperBridgeAbstract, DealabsBridge, HotUKDealsBridge, MydealsBridge] Streamlining Group Management

Fix wrong comment

* [PepperBridgeAbstract, DealabsBridge, HotUKDealsBridge, MydealsBridge] Streamlining Group Management

Add Example values for Group context
---
 bridges/DealabsBridge.php        | 1841 +----------------
 bridges/HotUKDealsBridge.php     | 3205 +-----------------------------
 bridges/MydealsBridge.php        | 1956 +-----------------
 bridges/PepperBridgeAbstract.php |   44 +-
 4 files changed, 69 insertions(+), 6977 deletions(-)

diff --git a/bridges/DealabsBridge.php b/bridges/DealabsBridge.php
index 3ee1c6f5..a3d1aaa5 100644
--- a/bridges/DealabsBridge.php
+++ b/bridges/DealabsBridge.php
@@ -40,1837 +40,14 @@ class DealabsBridge extends PepperBridgeAbstract
         'Deals par groupe' => [
             'group' => [
                 'name' => 'Groupe',
-                'type' => 'list',
-                'title' => 'Groupe dont il faut afficher les deals',
-                'values' => [
-                    'Abattants WC' => 'abattants-wc',
-                    'Abonnement PlayStation Plus' => 'playstation-plus',
-                    'Abonnements cinéma' => 'abonnements-cinema',
-                    'Abonnements de train' => 'abonnements-de-train',
-                    'Abonnements internet' => 'abonnements-internet',
-                    'Abonnements presse' => 'abonnements-presse',
-                    'Accessoires aquarium' => 'accessoires-aquarium',
-                    'Accessoires auto' => 'auto',
-                    'Accessoires électroniques' => 'accessoires-gadgets',
-                    'Accessoires gamers PC' => 'accessoires-gamers-pc',
-                    'Accessoires gaming' => 'accessoires-gaming',
-                    'Accessoires iPhone' => 'accessoires-iphone',
-                    'Accessoires mode' => 'accessoires-mode',
-                    'Accessoires moto' => 'moto',
-                    'Accessoires Nintendo' => 'accessoires-nintendo',
-                    'Accessoires PC portables' => 'accessoires-pc-portables',
-                    'Accessoires photo' => 'accessoires-photo',
-                    'Accessoires PlayStation' => 'accessoires-playstation',
-                    'Accessoires pour barbecue' => 'accessoires-barbecue',
-                    'Accessoires studio photo' => 'accessoires-studio-photo',
-                    'Accessoires téléphonie' => 'accessoires-telephonie',
-                    'Accessoires TV' => 'accessoires-tv',
-                    'Accessoires vélo' => 'accessoires-velo',
-                    'Accessoires Xbox' => 'accessoires-xbox',
-                    'Acer' => 'acer',
-                    'Acer Predator' => 'acer-predator',
-                    'Achats / Ventes' => 'achats-ventes-echanges-estimations-dons',
-                    'Achats à l&#039;étranger' => 'limport-sites-avis-questions-langues',
-                    'Adaptateurs' => 'adaptateurs',
-                    'Adhérents Fnac' => 'adherents-fnac',
-                    'Adhésions &amp; Souscriptions' => 'adhesions-souscriptions-abonnements',
-                    'adidas' => 'adidas',
-                    'Adidas Gazelle' => 'adidas-gazelle',
-                    'adidas Stan Smith' => 'adidas-stan-smith',
-                    'adidas Superstar' => 'adidas-superstar',
-                    'adidas Ultraboost' => 'adidas-ultraboost',
-                    'adidas Yung-1' => 'adidas-yung-1',
-                    'adidas ZX Flux' => 'adidas-zx-flux',
-                    'Adoucissant' => 'adoucissant',
-                    'Agendas' => 'agendas',
-                    'Age of Empires' => 'age-of-empires',
-                    'Age of Empires: Definitive Edition' => 'age-of-empires-definitive-edition',
-                    'Alarmes' => 'alarmes',
-                    'Albums photo' => 'albums-photo',
-                    'Alcools' => 'alcools',
-                    'Alcools forts' => 'alcools-forts',
-                    'Alimentation' => 'epicerie',
-                    'Alimentation bébés' => 'alimentation-bebes',
-                    'Alimentation PC' => 'alimentation-pc',
-                    'Alimentation sportifs' => 'alimentation-sportifs',
-                    'Amazfit Bip' => 'xiaomi-amazfit-bip',
-                    'Amazon Echo' => 'amazon-echo',
-                    'Amazon Echo Dot' => 'amazon-echo-dot',
-                    'Amazon Echo Plus' => 'amazon-echo-plus',
-                    'Amazon Echo Show' => 'amazon-echo-show',
-                    'Amazon Echo Show 5' => 'amazon-echo-show-5',
-                    'Amazon Echo Spot' => 'amazon-echo-spot',
-                    'Amazon Fire TV' => 'amazon-fire-tv',
-                    'Amazon Kindle' => 'amazon-kindle',
-                    'Amazon Prime' => 'amazon-prime',
-                    'AMD Radeon' => 'amd-radeon',
-                    'AMD Ryzen' => 'amd-ryzen',
-                    'AMD Ryzen 5 5600X' => 'amd-ryzen-5-5600x',
-                    'AMD Ryzen 7 5800X' => 'amd-ryzen-7-5800x',
-                    'AMD Ryzen 9 5900X' => 'amd-ryzen-9-5900x',
-                    'AMD Ryzen 9 5950X' => 'amd-ryzen-9-5950x',
-                    'AMD Vega' => 'amd-vega',
-                    'amiibo' => 'amiibo',
-                    'Amplis (guitare/basse)' => 'amplis-guitare-basse',
-                    'Amplis audio' => 'amplis',
-                    'Ampoules' => 'ampoules',
-                    'Ampoules à LED' => 'ampoules-a-led',
-                    'Angleterre' => 'angleterre',
-                    'Animal Crossing' => 'animal-crossing',
-                    'Animal Crossing: New Horizons' => 'animal-crossing-new-horizons',
-                    'Animaux' => 'animaux',
-                    'Anker' => 'anker',
-                    'Anno 1800' => 'anno-1800',
-                    'Annonces officielles' => 'annonces-officielles',
-                    'Anthem' => 'anthem',
-                    'Anti-nuisibles' => 'anti-nuisibles',
-                    'Anti-puces' => 'anti-puces',
-                    'Antivirus' => 'antivirus',
-                    'Antivols' => 'antivols',
-                    'Apex Legends' => 'apex-legends',
-                    'Appareils à raclette' => 'appareils-raclette',
-                    'Appareils de musculation' => 'appareils-de-musculation',
-                    'Appareils photo' => 'appareils-photo',
-                    'Appareils photo Canon' => 'appareils-photo-canon',
-                    'Appareils photo compacts' => 'appareils-photo-compacts',
-                    'Appareils photo instantanés' => 'appareils-photo-instantanes',
-                    'Appareils photo Nikon' => 'appareils-photo-nikon',
-                    'Appareils photo Olympus' => 'appareils-photo-olympus',
-                    'Appareils photo Panasonic' => 'appareils-photo-panasonic',
-                    'Appareils photo Sony' => 'appareils-photo-sony',
-                    'Apple' => 'apple',
-                    'Apple AirPods' => 'apple-airpods',
-                    'Apple AirPods 2' => 'apple-airpods-2',
-                    'Apple AirPods Max' => 'apple-airpods-max',
-                    'Apple AirPods Pro' => 'apple-airpods-pro',
-                    'Apple HomePod' => 'apple-homepod',
-                    'Apple HomePod Mini' => 'apple-homepod-mini',
-                    'Apple TV' => 'apple-tv',
-                    'Apple TV+' => 'apple-tv-plus',
-                    'Apple Watch' => 'apple-watch',
-                    'Apple Watch 3' => 'apple-watch-3',
-                    'Apple Watch 4' => 'apple-watch-4',
-                    'Apple Watch 5' => 'apple-watch-5',
-                    'Apple Watch 6' => 'apple-watch-6',
-                    'Apple Watch SE' => 'apple-watch-se',
-                    'Applications' => 'applications',
-                    'Applications Android' => 'applications-android',
-                    'Applications iOS' => 'applications-ios',
-                    'Appliques murales' => 'appliques-murales',
-                    'Applis &amp; logiciels' => 'applis-logiciels',
-                    'Après-shampooings' => 'apres-shampooings',
-                    'Aquariums' => 'aquariums',
-                    'Arbres à chat' => 'arbres-a-chat',
-                    'Arduino' => 'arduino',
-                    'Armoires &amp; placards' => 'armoires-et-placards',
-                    'Articles de cuisine et d&#039;entretien' => 'articles-de-cuisine',
-                    'Arts culinaires' => 'arts-culinaires',
-                    'Arts de la table' => 'arts-de-la-table',
-                    'ASICS' => 'asics',
-                    'Asmodée' => 'asmodee',
-                    'Aspirateurs' => 'aspirateurs',
-                    'Aspirateurs balais' => 'aspirateurs-balais',
-                    'Aspirateurs Dreame' => 'aspirateurs-xiaomi',
-                    'Aspirateurs Dyson' => 'aspirateurs-dyson',
-                    'Aspirateurs robot' => 'aspirateurs-robot',
-                    'Aspirateurs Rowenta' => 'apsirateurs-rowenta',
-                    'Aspirateurs sans sac' => 'aspirateurs-sans-sac',
-                    'Assassin&#039;s Creed' => 'assassin-s-creed',
-                    'Assassin&#039;s Creed: Unity' => 'assassins-creed-unity',
-                    'Assassin&#039;s Creed: Valhalla' => 'assassin-s-creed-valhalla',
-                    'Assassin&#039;s Creed Odyssey' => 'assassin-s-creed-odyssey',
-                    'Assassin&#039;s Creed Origins' => 'assassin-s-creed-origins',
-                    'Assurances' => 'assurances',
-                    'Astuces pour économiser' => 'vos-astuces-pour-faire-des-economies',
-                    'Asus' => 'asus',
-                    'Asus ROG' => 'asus-rog',
-                    'Asus ROG Phone' => 'asus-rog-phone',
-                    'Asus ROG Phone 2' => 'asus-rog-phone-2',
-                    'ASUS Transformer' => 'asus-transformer',
-                    'Asus VivoBook' => 'asus-vivobook',
-                    'Asus ZenBook' => 'asus-zenbook',
-                    'Asus ZenFone 2' => 'asus-zenfone-2',
-                    'Asus ZenFone 3' => 'asus-zenfone-3',
-                    'Asus ZenFone 4' => 'asus-zenfone-4',
-                    'Asus ZenFone 6' => 'asus-zenfone-6',
-                    'Asus ZenFone GO' => 'asus-zenfone-go',
-                    'Asus ZenFone Zoom' => 'asus-zenfone-zoom',
-                    'Audio &amp; Hi-fi' => 'audio-et-hi-fi',
-                    'Aukey' => 'aukey',
-                    'Auto-Moto' => 'auto-moto',
-                    'Autoradios' => 'autoradios',
-                    'Azzaro Wanted' => 'azzaro-wanted',
-                    'Baby foot' => 'baby-foot',
-                    'BabyLiss' => 'babyliss',
-                    'Babyphones' => 'babyphones',
-                    'Badminton' => 'badminton',
-                    'Bagagerie' => 'bagagerie',
-                    'Baignoires pour bébé' => 'baignoires-pour-bebe',
-                    'Bains de bouche' => 'bains-de-bouche',
-                    'Balais &amp; serpillères' => 'balais-et-serpilleres',
-                    'Balances connectées' => 'balances-connectees',
-                    'Balançoires' => 'balancoires',
-                    'Ballet &amp; danse' => 'ballet-et-danse',
-                    'Ballons de football' => 'ballons-de-football',
-                    'Bandes dessinées' => 'bandes-dessinees',
-                    'Banques' => 'banques',
-                    'Barbecue' => 'barbecue',
-                    'Barbecue électrique' => 'barbecue-electrique',
-                    'Barbecue Weber' => 'barbecue-weber',
-                    'Barbie' => 'barbie',
-                    'Barres de son' => 'barres-de-son',
-                    'Barres de son Yamaha' => 'barres-de-son-yamaha',
-                    'Batman Arkham' => 'batman-arkham',
-                    'Batteries externes' => 'batteries-externes',
-                    'Batteries voiture' => 'batteries-voiture',
-                    'Batteurs' => 'batteurs-electriques',
-                    'Battlefield' => 'battlefield',
-                    'Battlefield 1' => 'battlefield-1',
-                    'Battlefield V' => 'battlefield-5',
-                    'Béaba' => 'beaba',
-                    'Beats by Dre' => 'beats-by-dre',
-                    'Beats Solo 3' => 'beats-solo-3',
-                    'Beats Studio 3' => 'beats-studio-3',
-                    'Beauté' => 'beaute',
-                    'Bébés' => 'bebes-nouveaux-nes',
-                    'BenQ' => 'benq',
-                    'Be quiet!' => 'be-quiet',
-                    'Beyerdynamic MMX 300' => 'beyerdynamic-mmx-300',
-                    'Biberons' => 'biberons',
-                    'Bien-être &amp; santé' => 'bien-etre-et-massages',
-                    'Bières' => 'bieres',
-                    'Bijoux' => 'bijoux',
-                    'Bikinis' => 'bikinis',
-                    'Bilans de santé &amp; dépistages' => 'bilans-de-sante-et-depistages',
-                    'Billets de bus' => 'billets-de-bus',
-                    'Billets de train' => 'billets-de-train',
-                    'BioShock' => 'bioshock',
-                    'BioShock Infinite' => 'bioshock-infinite',
-                    'Bitdefender' => 'bitdefender',
-                    'Blabla' => 'blabla-parlez-de-tout-et-de-rien',
-                    'Black &amp; Decker' => 'black-decker',
-                    'Blackberry' => 'blackberry',
-                    'Black Desert Online' => 'black-desert-online',
-                    'Blédina' => 'bledina',
-                    'Blenders' => 'blenders',
-                    'Bleu de Chanel' => 'bleu-de-chanel',
-                    'Blousons de moto' => 'blousons-de-moto',
-                    'Blu-Ray' => 'blu-ray',
-                    'Bodys pour bébé' => 'bodys-pour-bebe',
-                    'Boissons' => 'boissons',
-                    'Boîtes à outils' => 'boites-a-outils',
-                    'Boîtiers PC' => 'boitiers-pc',
-                    'Boîtiers TV' => 'boitiers-tv',
-                    'Bonbons' => 'bonbons',
-                    'Bonnets' => 'bonnets',
-                    'Bonnets de bain' => 'bonnets-de-bain',
-                    'Borderlands' => 'borderlands',
-                    'Borderlands 3' => 'borderlands-3',
-                    'Bosch' => 'bosch',
-                    'Bose' => 'bose',
-                    'Bose Headphones 700' => 'bose-headphones-700',
-                    'Bose Home Speaker 500' => 'bose-home-speaker-500',
-                    'Bose QuietComfort' => 'bose-quietcomfort',
-                    'Bose QuietComfort 35 II' => 'bose-quietcomfort-35ii',
-                    'Bose SoundLink' => 'bose-soundlink',
-                    'Bose SoundTouch' => 'bose-soundtouch',
-                    'Bottes' => 'bottes',
-                    'Bottes de moto' => 'bottes-de-moto',
-                    'Bottes de neige' => 'bottes-neige',
-                    'Bottes de pluie' => 'bottes-pluie',
-                    'Bottes femme' => 'bottes-femme',
-                    'Bottes homme' => 'bottes-homme',
-                    'Bougies &amp; bougeoirs' => 'bougies-et-bougeoirs',
-                    'Box beauté' => 'box-beaute',
-                    'Bracelet fitness' => 'bracelet-fitness',
-                    'Brandt' => 'brandt',
-                    'Braun Series 3' => 'braun-series-3',
-                    'Braun Series 5' => 'braun-series-5',
-                    'Braun Series 7' => 'braun-series-7',
-                    'Braun Series 9' => 'braun-series-9',
-                    'Braun Silk Épil' => 'braun-silk-epil',
-                    'Brita' => 'brita',
-                    'Brosses à dents' => 'brosses-a-dents',
-                    'Brosses à dents électriques' => 'brosses-a-dents-electriques',
-                    'Brosses à dents électriques Oral-B' => 'brosses-a-dents-electriques-oral-b',
-                    'Brosses pour animaux' => 'brosses-pour-animaux',
-                    'Cable management' => 'cable-management',
-                    'Câbles' => 'cables',
-                    'Câbles Ethernet' => 'cables-ethernet',
-                    'Câbles HDMI' => 'cables-hdmi',
-                    'Câbles Jack' => 'cables-jack',
-                    'Câbles USB' => 'cables-usb',
-                    'Cadeaux' => 'cadeaux',
-                    'Cadres' => 'cadres',
-                    'Cadres de vélo' => 'cadres-de-velo',
-                    'Café' => 'cafe',
-                    'Café en dosettes' => 'cafe-en-dosettes',
-                    'Café en grain' => 'cafe-en-grain',
-                    'Cafetières' => 'cafetieres',
-                    'Cafetières expresso' => 'cafetieres-expresso',
-                    'Cafetières filtre' => 'cafetieres-filtre',
-                    'Cafetières italiennes' => 'cafetieres-italiennes',
-                    'Cahiers' => 'cahiers',
-                    'Caissons de basses' => 'caissons-de-basses',
-                    'Calendrier de l&#039;Avent Lego' => 'calendriers-avent-lego',
-                    'Calendriers' => 'calendriers',
-                    'Calendriers de l&#039;Avent' => 'calendriers-avent',
-                    'Call of Duty' => 'call-of-duty',
-                    'Call of Duty: Black Ops Cold War' => 'call-of-duty-black-ops-cold-war',
-                    'Call of Duty: Black Ops III' => 'call-of-duty-black-ops-3',
-                    'Call of Duty: Black Ops IIII' => 'call-of-duty-black-ops-4',
-                    'Call of Duty: Infinite Warfare' => 'call-of-duty-infinite-warfare',
-                    'Call of Duty: Modern Warfare' => 'call-of-duty-modern-warfare',
-                    'Call of Duty: WW2' => 'call-of-duty-ww2',
-                    'Calor' => 'calor',
-                    'Caméras' => 'cameras',
-                    'Caméras IP' => 'cameras-ip',
-                    'Caméras sportives' => 'cameras-sportives',
-                    'Camping' => 'camping',
-                    'Canapés' => 'canape',
-                    'Canon' => 'canon',
-                    'Captain Toad: Treasure Tracker' => 'captain-toad-treasure-tracker',
-                    'Caravanes' => 'caravanes',
-                    'Carburant' => 'carburant',
-                    'Cartables' => 'cartables',
-                    'Cartes &amp; programmes de fidélité' => 'cartes-et-programmes-de-fidelite',
-                    'Cartes bancaires' => 'cartes-bancaires',
-                    'Cartes de développement' => 'cartes-developpement',
-                    'Cartes graphiques' => 'cartes-graphiques',
-                    'Cartes mémoire' => 'cartes-memoire',
-                    'Cartes mères' => 'cartes-meres',
-                    'Cartes postales' => 'cartes-postales',
-                    'Cartes prépayées Playstation Store' => 'playstation-store',
-                    'Cartes SD' => 'cartes-sd',
-                    'Cartes son' => 'cartes-son',
-                    'Casio' => 'casio',
-                    'Casque sans fil Xbox' => 'casque-sans-fil-xbox',
-                    'Casques Apple' => 'casques-apple',
-                    'Casques à réduction de bruit' => 'casque-reduction-active-bruit',
-                    'Casques audio' => 'casques-audio',
-                    'Casques Bose' => 'casques-bose',
-                    'Casques de moto' => 'casques-de-moto',
-                    'Casques de vélo' => 'casques-de-velo',
-                    'Casques Jabra' => 'casques-jabra',
-                    'Casques Samsung' => 'casques-samsung',
-                    'Casques sans fil' => 'casques-sans-fil',
-                    'Casques Sennheiser' => 'casques-sennheiser',
-                    'Casques Sony' => 'casques-sony',
-                    'Casques VR' => 'vr',
-                    'Casquettes' => 'casquettes',
-                    'Casseroles' => 'casseroles',
-                    'Catit' => 'catit',
-                    'Caves à vin' => 'caves-a-vin',
-                    'CD &amp; vinyles' => 'cd-vinyles',
-                    'CDAV' => 'cdav',
-                    'Ceintures' => 'ceintures',
-                    'Centrales vapeur' => 'centrales-vapeur',
-                    'Chaînes hi-fi' => 'chaines-hi-fi',
-                    'Chaises' => 'chaises',
-                    'Chaises hautes' => 'chaises-hautes',
-                    'Chambre' => 'chambre',
-                    'Champagne' => 'champagne',
-                    'Chapeaux' => 'chapeaux',
-                    'Chapeaux &amp; casquettes' => 'chapeaux-casquettes',
-                    'Chargeurs' => 'chargeurs',
-                    'Chargeurs allume-cigare' => 'chargeurs-allume-cigare',
-                    'Chargeurs de piles' => 'chargeurs-de-piles',
-                    'Chargeurs sans fil' => 'chargeurs-sans-fil',
-                    'Chasse' => 'chasse',
-                    'Chatières' => 'chatieres',
-                    'Chats' => 'chats',
-                    'Chauffage' => 'chauffage',
-                    'Chaussettes &amp; collants' => 'chaussettes-et-collants',
-                    'Chaussons' => 'chaussons',
-                    'Chaussures' => 'chaussures',
-                    'Chaussures adidas' => 'chaussures-adidas',
-                    'Chaussures de football' => 'chaussures-de-football',
-                    'Chaussures de randonnée' => 'chaussures-de-randonnee',
-                    'Chaussures de ski' => 'chaussures-de-ski',
-                    'Chaussures de ville' => 'chaussures-de-ville',
-                    'Chaussures New Balance' => 'chaussures-new-balance',
-                    'Chaussures Nike' => 'chaussures-nike',
-                    'Chaussures pour enfants' => 'chaussures-enfants',
-                    'Chaussures pour femme' => 'chaussures-femme',
-                    'Chaussures pour homme' => 'chaussures-homme',
-                    'Chaussures Puma' => 'chaussures-puma',
-                    'Chaussures Reebok' => 'chaussures-reebok',
-                    'Chaussures running' => 'chaussures-de-running',
-                    'Chelsea boots' => 'chelsea-boots',
-                    'Chemises' => 'chemises',
-                    'Chiens' => 'chiens',
-                    'Chocolat' => 'chocolat',
-                    'Chuck Taylor' => 'chuck-taylor',
-                    'Cinéma' => 'cinema',
-                    'Cire dépilatoire' => 'cire-depilatoire',
-                    'Cirque &amp; arts de rue' => 'cirque-et-arts-de-rue',
-                    'Citytrips' => 'citytrips',
-                    'Civilization' => 'civilization',
-                    'Civilization VI' => 'civilization-vi',
-                    'CK One' => 'ck-one',
-                    'Clarks' => 'clarks',
-                    'Claviers' => 'claviers',
-                    'Claviers (musique)' => 'claviers-musique',
-                    'Claviers gamer' => 'claviers-gamer',
-                    'Claviers Logitech' => 'claviers-logitech',
-                    'Claviers mécaniques' => 'claviers-mecaniques',
-                    'Claviers sans fil' => 'claviers-sans-fil',
-                    'Clés USB' => 'cles-usb',
-                    'Climatisation' => 'climatisation',
-                    'Climatiseurs' => 'climatiseurs',
-                    'Cocottes' => 'cocottes',
-                    'Coffrets de livres' => 'coffrets-de-livres',
-                    'Coffrets DVD' => 'coffrets-dvd',
-                    'Coffrets maquillage' => 'coffrets-maquillage',
-                    'Colliers &amp; laisses' => 'colliers-et-laisses',
-                    'Compléments alimentaires' => 'complements-alimentaires',
-                    'Composteurs' => 'composteurs',
-                    'Concerts' => 'concerts',
-                    'Concours' => 'concours',
-                    'Congélateurs' => 'congelateurs',
-                    'Connectiques' => 'connectiques',
-                    'Console Google Stadia' => 'google-stadia',
-                    'Console Nintendo Classic Mini' => 'nintendo-classic-mini',
-                    'Console Nintendo Classic Mini: SNES' => 'nintendo-classic-mini-snes',
-                    'Console Nintendo Switch' => 'nintendo-switch',
-                    'Console Nintendo Switch Lite' => 'nintendo-switch-lite',
-                    'Console PS4' => 'playstation-4',
-                    'Console PS4 Pro' => 'playstation-4-pro',
-                    'Console PS5' => 'playstation-5',
-                    'Consoles' => 'consoles',
-                    'Consoles &amp; jeux vidéo' => 'consoles-jeux-video',
-                    'Console Sega Mega Drive Mini' => 'sega-mega-drive-mini',
-                    'Console Xbox One S' => 'xbox-one-s',
-                    'Console Xbox One X' => 'xbox-one-x',
-                    'Console Xbox Series S' => 'xbox-series-s',
-                    'Console Xbox Series X' => 'xbox-series-x',
-                    'Consommables imprimantes' => 'consommables-imprimantes',
-                    'Converse' => 'converse',
-                    'Coques iPhone' => 'coques-iphone',
-                    'Corsair Void PRO' => 'corsair-void-pro',
-                    'Costumes' => 'costumes',
-                    'Costumes &amp; déguisements' => 'costumes-et-deguisements',
-                    'Couches' => 'couches',
-                    'Couettes' => 'couettes',
-                    'Coupes menstruelles' => 'coupes-menstruelles',
-                    'Cours &amp; formations' => 'cours-et-formations',
-                    'Courses hippiques' => 'courses-hippiques',
-                    'Couteaux de cuisine' => 'couteaux-de-cuisine',
-                    'Couture' => 'couture',
-                    'Couverts' => 'couverts',
-                    'Couverts pour bébés' => 'couverts-pour-bebes',
-                    'Covoiturage' => 'covoiturage',
-                    'Crash Team Racing Nitro-Fueled' => 'crash-team-racing-nitro-fueled',
-                    'Cravates' => 'cravates',
-                    'Crédits' => 'credits',
-                    'Crèmes hydratantes' => 'cremes-hydratantes',
-                    'Crèmes solaires' => 'cremes-solaires',
-                    'Croisières' => 'croisieres',
-                    'Croquettes pour chat' => 'croquettes-pour-chat',
-                    'Croquettes pour chien' => 'croquettes-pour-chien',
-                    'Cuiseurs à riz' => 'cuiseur-riz',
-                    'Cuisinières' => 'cuisinieres',
-                    'Culottes menstruelles' => 'culottes-menstruelles',
-                    'Culture &amp; divertissement' => 'culture-divertissement',
-                    'Cyberpunk 2077' => 'cyberpunk-2077',
-                    'Cyclisme' => 'cyclisme',
-                    'Cyclisme &amp; sports urbains' => 'cyclisme-sports-urbains',
-                    'Darksiders' => 'darksiders',
-                    'Dashcams' => 'dashcams',
-                    'DDR3' => 'ddr3',
-                    'DDR4' => 'ddr4',
-                    'Dead Rising' => 'dead-rising',
-                    'Death Stranding' => 'death-stranding',
-                    'Décoration' => 'decoration',
-                    'Décorations de Noël' => 'decoration-noel',
-                    'Deebot' => 'ecovacs-deebot',
-                    'Deezer' => 'deezer',
-                    'Dell' => 'dell',
-                    'Dell XPS' => 'dell-xps',
-                    'Delsey' => 'delsey',
-                    'Demandes de deals' => 'les-demandes-de-deals',
-                    'Denon' => 'denon',
-                    'Dentifrices' => 'dentifrices',
-                    'Déodorants' => 'deodorants',
-                    'Désherbants' => 'desherbants',
-                    'Déshumidificateurs' => 'deshumidificateurs',
-                    'Désinfectant' => 'desinfectants',
-                    'Désodorisants &amp; parfums d&#039;intérieur' => 'desodorisants-et-parfums-d-interieur',
-                    'Destiny' => 'destiny',
-                    'Destiny 2' => 'destiny-2',
-                    'Détecteurs de fumée' => 'detecteurs-de-fumee',
-                    'Detroit: Become Human' => 'detroit-become-human',
-                    'Deus Ex' => 'deus-ex',
-                    'Deus Ex: Mankind Divided' => 'deus-ex-mankind-divided',
-                    'Devil May Cry 5' => 'devil-may-cry-5',
-                    'Dishonored' => 'dishonored',
-                    'Dishonored 2' => 'dishonored-2',
-                    'Disney+' => 'disney-plus',
-                    'Disneyland Paris' => 'disneyland-paris',
-                    'Disques durs (internes)' => 'hdd',
-                    'Disques durs externes' => 'disques-durs-externes',
-                    'Divers' => 'divers',
-                    'DJI' => 'dji',
-                    'DJI Mavic Air 2' => 'dji-mavic-air-2',
-                    'DJI Mavic Mini' => 'dji-mavic-mini',
-                    'Dolce Gusto' => 'dolce-gusto',
-                    'Domotique' => 'smart-home',
-                    'Doom Eternal' => 'doom-eternal',
-                    'Dosettes Dolce Gusto' => 'dosettes-dolce-guste',
-                    'Dosettes Nespresso' => 'dosettes-nespresso',
-                    'Dosettes Senseo' => 'dosettes-senseo',
-                    'Dosettes Tassimo' => 'dosettes-tassimo',
-                    'Dr. Martens' => 'dr-martens',
-                    'Dragon Age' => 'dragon-age',
-                    'Dragon Ball' => 'dragon-ball',
-                    'Dragon Ball FighterZ' => 'dragon-ball-fighterz',
-                    'Dragon Ball Z: Kakarot' => 'dragon-ball-z-kakarot',
-                    'Dragon Quest' => 'dragon-quest',
-                    'Dragon Quest Builders' => 'dragon-quest-builders',
-                    'Dragon Quest Builders 2' => 'dragon-quest-builders-2',
-                    'Draisiennes' => 'draisiennes',
-                    'Draps &amp; housses' => 'draps-et-housses',
-                    'Dreame V10' => 'xiaomi-dreame-v10',
-                    'Dreame V11' => 'xiaomi-dreame-v11',
-                    'Drones' => 'drones',
-                    'Durex' => 'durex',
-                    'DVD' => 'dvd',
-                    'Dying Light' => 'dying-light',
-                    'Dying Light 2' => 'dying-light-2',
-                    'Dyson' => 'dyson',
-                    'Dyson V10' => 'dyson-v10',
-                    'Dyson V11' => 'dyson-v11',
-                    'Eastpak' => 'eastpak',
-                    'Ebooks' => 'ebooks',
-                    'Écharpes &amp; foulards' => 'echarpes-et-foulards',
-                    'Éclairage intelligent' => 'smart-light',
-                    'Écouteurs' => 'ecouteurs',
-                    'Écouteurs sans fil' => 'ecouteurs-sans-fil',
-                    'Écouteurs sport' => 'ecouteurs-sport',
-                    'Ecovacs' => 'ecovacs',
-                    'Ecovacs Deebot 900' => 'ecovacs-deebot-900',
-                    'Ecovacs Deebot OZMO 930' => 'ecovacs-deebot-ozmo-930',
-                    'Écrans' => 'ecrans',
-                    'Écrans 4K / UHD' => 'ecrans-4k-uhd',
-                    'Écrans 21&quot; et moins' => 'ecrans-21-pouces-et-moins',
-                    'Écrans 24&quot;' => 'ecrans-24-pouces',
-                    'Écrans 27&quot;' => 'ecrans-27-pouces',
-                    'Écrans 29&quot; et plus' => 'ecrans-29-pouces-et-plus',
-                    'Écrans Acer' => 'ecrans-acer',
-                    'Écrans Asus' => 'ecrans-asus',
-                    'Écrans BenQ' => 'ecrans-benq',
-                    'Écrans Dell' => 'ecrans-dell',
-                    'Écrans de projection' => 'ecrans-de-projection',
-                    'Écrans FreeSync' => 'ecrans-freesync',
-                    'Écrans gaming' => 'ecrans-gamer',
-                    'Écrans incurvés' => 'ecrans-incurves',
-                    'Écrans Philips' => 'ecrans-philips',
-                    'Écrans Samsung' => 'ecrans-samsung',
-                    'Électricité (matériel)' => 'electricite',
-                    'Electrolux' => 'electrolux',
-                    'Électroménager' => 'electromenager',
-                    'Embauchoirs' => 'embauchoirs',
-                    'Enceintes' => 'enceintes',
-                    'Enceintes Bluetooth' => 'enceintes-bluetooth',
-                    'Enceintes connectées' => 'enceintes-connectees',
-                    'Enceintes portables sans fil' => 'enceintes-portables-sans-fil',
-                    'Énergie' => 'energie',
-                    'Engrais' => 'engrais',
-                    'Épicerie &amp; courses' => 'epicerie-courses-supermarches',
-                    'Épilateurs à lumière pulsée' => 'epilateurs-a-lumiere-pulsee',
-                    'Épilateurs électriques' => 'epilateurs-electriques',
-                    'Épilation' => 'epilation',
-                    'Équipement motard' => 'equipement-motard',
-                    'Équipement running' => 'equipement-running',
-                    'Équipement sportif' => 'equipement-sportif',
-                    'Érotisme' => 'erotisme',
-                    'Escarpins' => 'escarpins',
-                    'Événements sportifs' => 'evenements-sportifs',
-                    'Expositions' => 'expositions',
-                    'Extracteurs de jus' => 'extracteurs-de-jus',
-                    'F1 2017' => 'f1-2017',
-                    'F1 2019' => 'f1-2019',
-                    'Facom' => 'facom',
-                    'Fallout' => 'fallout',
-                    'Fallout 4' => 'fallout-4',
-                    'Fallout 76' => 'fallout-76',
-                    'Famille &amp; enfants' => 'famille-enfants',
-                    'Far Cry' => 'far-cry',
-                    'Far Cry New Dawn' => 'far-cry-new-dawn',
-                    'Fards à paupières' => 'fards-a-paupieres',
-                    'Fast-foods' => 'fast-foods',
-                    'Fauteuils' => 'fauteuils',
-                    'Fauteuils gamer' => 'fauteuils-gaming',
-                    'Fe' => 'fe',
-                    'Fers à lisser / à friser' => 'fers-a-lisser-a-friser',
-                    'Fers à repasser' => 'fers-a-repasser',
-                    'Fers à souder' => 'fers-a-souder',
-                    'Festivals' => 'festivals',
-                    'Feutres' => 'feutres',
-                    'FIFA' => 'fifa',
-                    'FIFA 17' => 'fifa-17',
-                    'FIFA 18' => 'fifa-18',
-                    'FIFA 19' => 'fifa-19',
-                    'FIFA 20' => 'fifa-20',
-                    'FIFA 21' => 'fifa-21',
-                    'Figurines' => 'figurines',
-                    'Films &amp; Séries' => 'films',
-                    'Final Fantasy' => 'final-fantasy',
-                    'Final Fantasy XII' => 'final-fantasy-xii',
-                    'Finances &amp; Assurances' => 'finances-assurances',
-                    'fitbit' => 'fitbit',
-                    'Fitness &amp; yoga' => 'fitness-yoga',
-                    'Flash' => 'flash',
-                    'Fluval' => 'fluval',
-                    'Foires &amp; salons' => 'foires-et-salons',
-                    'Fonds de teint' => 'fonds-de-teint',
-                    'Football' => 'football',
-                    'Forfaits de ski' => 'forfaits-ski',
-                    'Forfaits mobiles' => 'forfaits-mobiles',
-                    'Forfaits mobiles et internet' => 'telecommunications',
-                    'For Honor' => 'for-honor',
-                    'Formations premiers secours' => 'formations-premiers-secours',
-                    'Formule 1' => 'formule-1',
-                    'Fortnite' => 'fortnite',
-                    'Fortnite: Pack Feu Obscur' => 'fortnite-pack-feu-obscur',
-                    'Forza' => 'forza',
-                    'Forza Horizon' => 'forza-horizon',
-                    'Forza Horizon 3' => 'forza-horizon-3',
-                    'Forza Horizon 4' => 'forza-horizon-4',
-                    'Forza Motorsport' => 'forza-motosport',
-                    'Forza Motorsport 7' => 'forza-motorsport-7',
-                    'Fossil' => 'fossil',
-                    'Fournitures scolaires' => 'fournitures-scolaires',
-                    'Fours' => 'fours',
-                    'Fours à poser' => 'fours-a-poser',
-                    'Fours encastrables' => 'fours-encastrables',
-                    'Friandises pour chat' => 'friandises-pour-chat',
-                    'Friandises pour chien' => 'friandises-pour-chien',
-                    'Friskies' => 'friskies',
-                    'Friteuses' => 'friteuses',
-                    'Friteuses sans huile' => 'friteuses-sans-huile',
-                    'Fruits &amp; légumes' => 'fruits-et-legumes',
-                    'Fujifilm' => 'fujifilm',
-                    'Funko Pop' => 'funko-pop',
-                    'FURminator' => 'furminator',
-                    'Futuroscope' => 'futuroscope',
-                    'Gamelles' => 'gamelles',
-                    'Game of Thrones' => 'game-of-thrones',
-                    'Gaming' => 'le-laboratoire-des-gamers',
-                    'Gants' => 'gants',
-                    'Gants moto' => 'gants-moto',
-                    'Garmin' => 'garmin',
-                    'Garmin Fenix' => 'garmin-fenix',
-                    'Garmin Forerunner' => 'garmin-forerunner',
-                    'Garmin Vivoactive' => 'garmin-vivoactive',
-                    'Garmin Vivomove' => 'garmin-vivomove',
-                    'Gâteaux &amp; biscuits' => 'gateaux-et-biscuits',
-                    'Gears 5' => 'gears-5',
-                    'Gel hydroalcoolique' => 'gel-hydroalcoolique',
-                    'Gels douche' => 'gels-douche',
-                    'Geox' => 'geox',
-                    'Ghost of Tsushima' => 'ghost-of-tsushima',
-                    'Gigoteuses' => 'gigoteuses',
-                    'Gillette Fusion' => 'gillette-fusion',
-                    'Gillette Mach3' => 'gillette-mach3',
-                    'Glaces' => 'glaces',
-                    'Glacières' => 'glacieres',
-                    'Glisse urbaine' => 'glisse-urbaine',
-                    'God of War' => 'god-of-war',
-                    'Google Chromecast' => 'google-chromecast',
-                    'Google Home' => 'google-home',
-                    'Google Home Max' => 'google-home-max',
-                    'Google Home Mini' => 'google-home-mini',
-                    'Google Nest Hub' => 'google-nest-hub',
-                    'Google Nest Mini' => 'google-nest-mini',
-                    'Google Pixel' => 'google-pixel',
-                    'Google Pixel 2' => 'google-pixel-2',
-                    'Google Pixel 2 XL' => 'google-pixel-2-xl',
-                    'Google Pixel 3' => 'google-pixel-3',
-                    'Google Pixel 3 XL' => 'google-pixel-3-xl',
-                    'Google Pixel 3a' => 'google-pixel-3a',
-                    'Google Pixel 4' => 'google-pixel-4',
-                    'Google Pixel 4 XL' => 'google-pixel-4xl',
-                    'Google Pixel 4a' => 'google-pixel-4a',
-                    'Google Pixel 5' => 'google-pixel-5',
-                    'Google Pixel XL' => 'google-pixel-xl',
-                    'GoPro' => 'gopro-hero',
-                    'GoPro Hero 9' => 'gopro-hero-9',
-                    'Gran Turismo' => 'gran-turismo',
-                    'Grille-pain' => 'grille-pain',
-                    'Grossesse &amp; maternité' => 'grossesse-maternite',
-                    'GTA' => 'gta',
-                    'GTA V' => 'gta-v',
-                    'GTX 1060' => 'nvidia-geforce-gtx-1060',
-                    'GTX 1070' => 'nvidia-geforce-gtx-1070',
-                    'GTX 1080' => 'nvidia-geforce-gtx-1080',
-                    'GTX 1080 Ti' => 'nvidia-geforce-gtx-1080-ti',
-                    'GTX 1650' => 'gtx-1650',
-                    'GTX 1660' => 'gtx-1660',
-                    'GTX 1660 Ti' => 'gtx-1660-ti',
-                    'Guerlain La Petite Robe Noire' => 'guerlain-petite-robe-noire',
-                    'Guirlandes lumineuses' => 'guirlandes-lumineuses',
-                    'Guitares' => 'guitares',
-                    'Gyropodes' => 'gyropodes',
-                    'Half Life' => 'half-life',
-                    'Half Life 2' => 'half-life-2',
-                    'Half Life Alyx' => 'half-life-alyx',
-                    'Halloween' => 'halloween',
-                    'Haltères &amp; poids' => 'halteres-et-poids',
-                    'Hama' => 'hama',
-                    'Hamacs' => 'hamacs',
-                    'Hand spinners' => 'hand-spinners',
-                    'Harnais pour chien' => 'harnais-pour-chien',
-                    'Harry Potter' => 'harry-potter',
-                    'Havaianas' => 'havaianas',
-                    'High-Tech' => 'high-tech',
-                    'High-tech &amp; informatique' => 'le-laboratoire-high-tech-informatique',
-                    'Hisense' => 'hisense',
-                    'Home Cinéma' => 'home-cinema',
-                    'Honor' => 'honor',
-                    'Honor 6X' => 'honor-6x',
-                    'Honor 8' => 'honor-8',
-                    'Honor 8 Pro' => 'honor-8-pro',
-                    'Honor 8X' => 'honor-8x',
-                    'Honor 8X Max' => 'honor-8x-max',
-                    'Honor 9' => 'honor-9',
-                    'Honor 10' => 'honor-10',
-                    'Honor 20' => 'honor-20',
-                    'Honor 20 Lite' => 'honor-20-lite',
-                    'Honor 20 Pro' => 'honor-20-pro',
-                    'Honor Band 5' => 'honor-band-5',
-                    'Honor MagicBook' => 'honor-magicbook',
-                    'Honor MagicWatch 2' => 'honor-magicwatch-2',
-                    'Honor View 20' => 'honor-view-20',
-                    'Horizon Zero Dawn' => 'horizon-zero-dawn',
-                    'Hôtels &amp; Hébergements' => 'hotels',
-                    'Hoverboards' => 'hoverboards',
-                    'HTC 10' => 'htc-10',
-                    'HTC Desire' => 'htc-desire',
-                    'HTC One M9' => 'htc-one-m9',
-                    'HTC U11' => 'htc-u11',
-                    'HTC U Play' => 'htc-u-play',
-                    'HTC U Ultra' => 'htc-u-ultra',
-                    'HTC Vive' => 'htc-vive',
-                    'Huawei' => 'huawei',
-                    'Huawei FreeBuds 3' => 'huawei-freebuds-3',
-                    'Huawei Mate 9' => 'huawei-mate-9',
-                    'Huawei Mate 10' => 'huawei-mate-10',
-                    'Huawei Mate 10 Pro' => 'huawei-mate-10-pro',
-                    'Huawei Mate 20' => 'huawei-mate-20',
-                    'Huawei Mate 20 Lite' => 'huawei-mate-20-lite',
-                    'Huawei Mate 20 Pro' => 'huawei-mate-20-pro',
-                    'Huawei Mate 20 RS' => 'huawei-mate-20-rs',
-                    'Huawei Mate 30' => 'huawei-mate-30',
-                    'Huawei Mate 30 Lite' => 'huawei-mate-30-lite',
-                    'Huawei Mate 30 Pro' => 'huawei-mate-30-pro',
-                    'Huawei P8 Lite' => 'huawei-p8-lite',
-                    'Huawei P9 Lite' => 'huawei-p9-lite',
-                    'Huawei P10' => 'huawei-p10',
-                    'Huawei P10 Lite' => 'huawei-p10-lite',
-                    'Huawei P10 Plus' => 'huawei-p10-plus',
-                    'Huawei P20' => 'huawei-p20',
-                    'Huawei P20 Lite' => 'huawei-p20-lite',
-                    'Huawei P20 Pro' => 'huawei-p20-pro',
-                    'Huawei P30' => 'huawei-p30',
-                    'Huawei P30 Lite' => 'huawei-p30-lite',
-                    'Huawei P30 Pro' => 'huawei-p30-pro',
-                    'Huawei P40' => 'huawei-p40',
-                    'Huawei P40 Lite' => 'huawei-p40-lite',
-                    'Huawei P40 Pro' => 'huawei-p40-pro',
-                    'Huawei Watch' => 'huawei-watch',
-                    'Huawei Watch 2' => 'huawei-watch-2',
-                    'Hubs' => 'hubs',
-                    'Hugo Boss Bottled' => 'hugo-boss-bottled',
-                    'Huile moteur' => 'huile-moteur',
-                    'Hygiène &amp; soins' => 'hygiene-soins',
-                    'Hygiène de la maison' => 'hygiene-de-la-maison',
-                    'Hygiène des bébés' => 'hygiene-des-bebes',
-                    'Hygiène intime' => 'hygiene-intime',
-                    'iMac' => 'mac-de-bureau',
-                    'iMac 2021' => 'imac-2021',
-                    'Image, son, photo' => 'le-laboratoire-audiovisuel',
-                    'Impressions photo' => 'impressions-photo',
-                    'Imprimantes' => 'imprimantes',
-                    'Imprimantes 3D' => 'imprimantes-3d',
-                    'Imprimantes Brother' => 'imprimantes-brother',
-                    'Imprimantes Canon' => 'imprimantes-canon',
-                    'Imprimantes Epson' => 'imprimantes-epson',
-                    'Imprimantes HP' => 'imprimantes-hp',
-                    'Imprimantes laser' => 'imprimantes-laser',
-                    'Imprimantes multifonctions' => 'imprimantes-multifonctions',
-                    'Informatique' => 'informatique',
-                    'Instax Mini' => 'instax-mini',
-                    'Instruments de musique' => 'instruments-de-musique',
-                    'Intel i5' => 'intel-i5',
-                    'Intel i7' => 'intel-i7',
-                    'Intel i9' => 'intel-i9',
-                    'iPad' => 'apple-ipad',
-                    'iPad 2019' => 'ipad-2019',
-                    'iPad 2020' => 'ipad-2020',
-                    'iPad Air' => 'ipad-air',
-                    'iPad Air 2019' => 'ipad-air-2019',
-                    'iPad Air 2020' => 'ipad-air-2020',
-                    'iPad Mini' => 'apple-ipad-mini',
-                    'iPad Pro' => 'apple-ipad-pro',
-                    'iPad Pro 11' => 'ipad-pro-11',
-                    'iPad Pro 12.9' => 'ipad-pro-12-9',
-                    'iPad Pro 2020' => 'ipad-pro-2020',
-                    'iPhone' => 'apple-iphone',
-                    'iPhone 6' => 'apple-iphone-6',
-                    'iPhone 7' => 'apple-iphone-7',
-                    'iPhone 7 Plus' => 'apple-iphone-7-plus',
-                    'iPhone 8' => 'apple-iphone-8',
-                    'iPhone 8 Plus' => 'apple-iphone-8-plus',
-                    'iPhone 11' => 'iphone-11',
-                    'iPhone 11 Pro' => 'iphone-11-pro',
-                    'iPhone 11 Pro Max' => 'iphone-11-pro-max',
-                    'iPhone 12' => 'iphone-12',
-                    'iPhone 12 Mini' => 'iphone-12-mini',
-                    'iPhone 12 Pro' => 'iphone-12-pro',
-                    'iPhone 12 Pro Max' => 'iphone-12-pro-max',
-                    'iPhone SE' => 'apple-iphone-se',
-                    'iPhone X' => 'apple-iphone-x',
-                    'iPhone XR' => 'apple-iphone-xr',
-                    'iPhone XS' => 'apple-iphone-xs',
-                    'iPhone XS Max' => 'apple-iphone-xs-max',
-                    'iRobot Roomba' => 'irobot-roomba',
-                    'Isolation' => 'isolation',
-                    'Jabra Elite 75t' => 'jabra-elite-75t',
-                    'Jabra Elite 85h' => 'jabra-elite-85h',
-                    'Jabra Elite 85t' => 'jabra-elite-85t',
-                    'Jabra Elite Active 65t' => 'jabra-elite-active-65t',
-                    'Jacuzzis' => 'jacuzzis',
-                    'Jardin' => 'jardin',
-                    'Jardin &amp; bricolage' => 'jardin-bricolage',
-                    'Jardinage' => 'entretien-du-jardin',
-                    'JBL' => 'jbl',
-                    'JBL Charge 4' => 'jbl-charge-4',
-                    'JBL Flip' => 'jbl-flip',
-                    'JBL GO' => 'jbl-go',
-                    'JBL Xtreme 2' => 'jbl-xtreme-2',
-                    'Jeans' => 'jeans',
-                    'Jets dentaires' => 'jets-dentaires',
-                    'Jeux &amp; jouets' => 'jeux-jouets',
-                    'Jeux &amp; sports de café' => 'jeux-sports-cafe-bar',
-                    'Jeux d&#039;adresse' => 'jeux-adresse',
-                    'Jeux d&#039;apprentissage' => 'jeux-d-apprentissage',
-                    'Jeux d&#039;eau' => 'jeux-jouets-eau',
-                    'Jeux d&#039;extérieur' => 'jeux-d-exterieur',
-                    'Jeux d&#039;imitation' => 'jeux-d-imitation',
-                    'Jeux de cartes et de plateau' => 'jeux-cartes-plateau-societe',
-                    'Jeux de construction' => 'jeux-de-construction',
-                    'Jeux de hasard &amp; paris' => 'jeux-et-paris',
-                    'Jeux de société' => 'jeux-de-societe',
-                    'Jeux Nintendo 3DS' => 'jeux-3ds',
-                    'Jeux Nintendo Switch' => 'jeux-nintendo-switch',
-                    'Jeux PC' => 'jeux-pc',
-                    'Jeux PC dématérialisés' => 'jeux-pc-dematerialises',
-                    'Jeux pour bébés' => 'jeux-pour-bebes',
-                    'Jeux PS4' => 'jeux-playstation-4',
-                    'Jeux PS4 dématérialisés' => 'jeux-ps4-dematerialises',
-                    'Jeux PS5' => 'jeux-playstation-5',
-                    'Jeux PS5 dématérialisés' => 'jeux-playstation-5-dematerialises',
-                    'Jeux PS Plus' => 'jeux-ps-plus',
-                    'Jeux vidéo' => 'jeux-video',
-                    'Jeux VR' => 'jeux-vr',
-                    'Jeux Wii U' => 'jeux-wii-u',
-                    'Jeux Xbox One' => 'jeux-xbox-one',
-                    'Jeux Xbox One dématérialisés' => 'jeux-xbox-dematerialises',
-                    'Jeux Xbox Series X' => 'jeux-xbox-series-x',
-                    'Jeux Xbox with Gold' => 'jeux-xbox-with-gold',
-                    'Jouets' => 'jouets',
-                    'Jouets pour chat' => 'jouets-pour-chat',
-                    'Jouets pour chien' => 'jouets-pour-chien',
-                    'Journaux numériques' => 'journaux-numeriques',
-                    'Journaux papier' => 'journaux-papier',
-                    'Joy-Con' => 'manettes-nintendo-switch-joy-con',
-                    'Jungle Speed' => 'jungle-speed',
-                    'Just Cause' => 'just-cause',
-                    'Just Cause 3' => 'just-cause-3',
-                    'Just Cause 4' => 'just-cause-4',
-                    'Kärcher' => 'karcher',
-                    'Kaspersky' => 'kaspersky',
-                    'Kinder' => 'kinder',
-                    'Kindle Oasis' => 'kindle-oasis',
-                    'Kindle Paperwhite' => 'kindle-paperwhite',
-                    'Kindle Voyage' => 'kindle-voyage',
-                    'Kingdom Hearts' => 'kingdom-hearts',
-                    'Kingdom Hearts 3' => 'kingdom-hearts-3',
-                    'Kingston HyperX Cloud II' => 'kingston-hyperx-cloud-2',
-                    'Kits premiers secours' => 'premiers-secours',
-                    'Kobo' => 'kobo',
-                    'Kobo Aura 2' => 'kobo-aura-2',
-                    'Kobo Aura H2o' => 'kobo-aura-h2o',
-                    'Kobo Aura One' => 'kobo-aura-one',
-                    'L&#039;annale du destin' => 'l-annale-du-destin',
-                    'L&#039;ombre de la guerre' => 'l-ombre-de-la-guerre',
-                    'L&#039;ombre du Mordor' => 'l-ombre-du-mordor',
-                    'Lacoste' => 'lacoste',
-                    'Lampadaires' => 'lampadaires',
-                    'Lampes' => 'lampes',
-                    'Lampes de table' => 'lampes-de-table',
-                    'Lampes solaires' => 'lampes-solaires',
-                    'Lancôme La Vie est Belle' => 'lancome-la-vie-est-belle',
-                    'Lapeyre' => 'lapeyre',
-                    'La Terre du Milieu' => 'la-terre-du-milieu',
-                    'Lavage auto' => 'lavage-auto',
-                    'Lavazza' => 'lavazza',
-                    'Lave-linge' => 'lave-linge',
-                    'Lave-linge frontal' => 'lave-linge-frontal',
-                    'Lave-linge séchant' => 'lave-linge-sechant',
-                    'Lave-linge top' => 'lave-linge-top',
-                    'Lave-vaisselle' => 'lave-vaisselle',
-                    'Lay-Z-Spa' => 'lay-z-spa',
-                    'Leasing voiture' => 'leasing-voiture',
-                    'Le bâton de la vérité' => 'le-baton-de-la-verite',
-                    'Lecteurs Blu-Ray' => 'lecteurs-blu-ray',
-                    'Lecteurs CD' => 'lecteurs-cd',
-                    'Lecteurs DVD' => 'lecteurs-dvd',
-                    'Lego' => 'lego',
-                    'Lego Architecture' => 'lego-architecture',
-                    'Lego Batman' => 'lego-batman',
-                    'Lego City' => 'lego-city',
-                    'Lego Creator' => 'lego-creator',
-                    'Lego Dimensions' => 'lego-dimensions',
-                    'Lego Duplo' => 'lego-duplo',
-                    'Lego Friends' => 'lego-friends',
-                    'Lego Harry Potter' => 'lego-harry-potter',
-                    'Lego Ideas' => 'lego-ideas',
-                    'Lego Marvel' => 'lego-marvel',
-                    'Lego Nexo Knights' => 'lego-nexo-knights',
-                    'Lego Ninjago' => 'lego-ninjago',
-                    'Lego Star Wars' => 'lego-star-wars',
-                    'Lego Technic' => 'lego-technic',
-                    'Lenovo' => 'lenovo',
-                    'Lenovo IdeaPad' => 'lenovo-ideapad',
-                    'Lenovo K6 Note' => 'lenovo-k6-note',
-                    'Lenovo P8' => 'lenovo-p8',
-                    'Lenovo Tab 3' => 'lenovo-tab-3',
-                    'Lenovo Tab 4' => 'lenovo-tab-4',
-                    'Lenovo ThinkPad' => 'lenovo-thinkpad',
-                    'Lenovo Yoga' => 'lenovo-yoga',
-                    'Lenovo Yoga Tab 3' => 'lenovo-yoga-tab-3',
-                    'Lentilles de contact' => 'lentilles-de-contact',
-                    'Le Seigneur des anneaux' => 'le-seigneur-des-anneaux',
-                    'Les Sims' => 'les-sims',
-                    'Les Sims 4' => 'les-sims-4',
-                    'Lessive' => 'lessive',
-                    'Levi&#039;s' => 'levi-s',
-                    'LG' => 'lg',
-                    'LG G4' => 'lg-g4',
-                    'LG G5' => 'lg-g5',
-                    'LG G6' => 'lg-g6',
-                    'LG OLED TV' => 'lg-oled-tv',
-                    'LG Q6' => 'lg-q6',
-                    'LG Q8' => 'lg-q8',
-                    'Life is Strange' => 'life-is-strange',
-                    'Linge de maison' => 'linge-de-maison',
-                    'Lingerie' => 'lingerie',
-                    'Lingettes désinfectantes' => 'lingettes-desinfectantes',
-                    'Lingettes pour bébés' => 'lingettes-pour-bebes',
-                    'Liseuses' => 'liseuses',
-                    'Litière pour chat' => 'litiere-pour-chat',
-                    'Lits' => 'lits',
-                    'Lits pour bébé' => 'lits-pour-bebe',
-                    'Lits pour enfants' => 'lits-pour-enfants',
-                    'Little Nightmares' => 'little-nightmares',
-                    'Livraison de repas' => 'service-de-livraison-de-repas',
-                    'Livres &amp; littérature' => 'livres-litterature',
-                    'Livres &amp; Magazines' => 'livres',
-                    'Livres audio' => 'livres-audio',
-                    'Livres photo' => 'livres-photo',
-                    'Location de voiture' => 'location-de-voiture',
-                    'Logiciels' => 'logiciels',
-                    'Logiciels de sécurité' => 'logiciels-de-securite',
-                    'Logiciels Microsoft' => 'logiciels-microsoft',
-                    'Logitech' => 'logitech',
-                    'Logitech G502' => 'logitech-g502',
-                    'Logitech G703' => 'logitech-g703',
-                    'Logitech G Pro X' => 'logitech-g-pro-x',
-                    'Logitech Harmony' => 'logitech-harmony',
-                    'Logitech MX Master' => 'logitech-mx-master',
-                    'Logitech MX Master 2S' => 'logitech-mx-master-2s',
-                    'Loisirs créatifs' => 'loisirs-creatifs',
-                    'Lolita Lempicka' => 'lolita-lempicka-premier-parfum',
-                    'Loup-Garou' => 'loup-garou',
-                    'Lubrifiants' => 'lubrifiants',
-                    'Luges' => 'luges',
-                    'Luigi&#039;s Mansion 3' => 'luigi-mansion-3',
-                    'Luminaires' => 'luminaires',
-                    'Lunettes de natation' => 'lunettes-de-natation',
-                    'Lunettes de soleil' => 'lunettes-de-soleil',
-                    'M&amp;M&#039;s' => 'metm-s',
-                    'MacBook' => 'macbook',
-                    'MacBook Air' => 'apple-macbook-air',
-                    'MacBook Pro' => 'apple-macbook-pro',
-                    'MacBook Pro 13' => 'macbook-pro-13',
-                    'MacBook Pro 15' => 'macbook-pro-15',
-                    'MacBook Pro 16' => 'macbook-pro-16',
-                    'Machines à café à dosettes' => 'machines-a-cafe-a-dosettes',
-                    'Machines à café en grain' => 'machines-a-cafe-en-grain',
-                    'Machines à coudre' => 'machines-a-coudre',
-                    'Machines à pain' => 'machines-a-pain',
-                    'Machines de sport' => 'machines-sport',
-                    'Machines Dolce Gusto' => 'machines-dolce-gusto',
-                    'Machines Nespresso' => 'machines-nespresso',
-                    'Machines Senseo' => 'machines-senseo',
-                    'Machines Tassimo' => 'machines-tassimo',
-                    'Mac mini' => 'mac-mini',
-                    'Madden NFL 20' => 'madden-nfl-20',
-                    'Magasins d&#039;usine' => 'magasins-usine',
-                    'Magazines' => 'magazines',
-                    'Maillots de bain' => 'maillots-de-bain',
-                    'Maillots de football' => 'maillots-de-football',
-                    'Maison &amp; Habitat' => 'maison-habitat',
-                    'Maisons de poupées' => 'maisons-poupees',
-                    'Makita' => 'makita',
-                    'Manettes' => 'manettes-accessoires-consoles',
-                    'Manettes DualSense' => 'manettes-playstation-5',
-                    'Manettes Nintendo Switch' => 'manettes-nintendo-switch',
-                    'Manettes Nintendo Switch Pro' => 'manettes-nintendo-switch-pro',
-                    'Manettes PlayStation 4' => 'manettes-playstation-4',
-                    'Manettes Xbox' => 'manettes-xbox',
-                    'Manettes Xbox One' => 'manettes-xbox-one',
-                    'Manettes Xbox One Elite' => 'manettes-xbox-one-elite',
-                    'Manettes Xbox Series X' => 'manettes-xbox-series-x',
-                    'Manix' => 'manix',
-                    'Manteaux' => 'manteaux',
-                    'Maquillage' => 'maquillage',
-                    'Marchands et leurs offres' => 'vos-avisdemandes-sur-les-marchands-et-leurs-offres',
-                    'Mario &amp; Sonic aux Jeux Olympiques de Tokyo 2020' => 'mario-sonic-jeux-olympiques-tokyo-2020',
-                    'Mario Kart' => 'mario-kart',
-                    'Marques' => 'marques',
-                    'Marteaux &amp; maillets' => 'marteaux-et-maillets',
-                    'Marvel&#039;s Avengers' => 'marvels-avengers',
-                    'Mascara' => 'mascara',
-                    'Masques cheveux' => 'masques-cheveux',
-                    'Masques de protection' => 'masques-de-protection-respiratoire',
-                    'Masques de ski' => 'masques-de-ski',
-                    'Mass Effect' => 'mass-effect',
-                    'Mass Effect: Andromeda' => 'mass-effect-andromeda',
-                    'Matchs de football' => 'matchs-de-football',
-                    'Matelas' => 'matelas',
-                    'Matelas gonflables' => 'matelas-gonflables',
-                    'Matériaux de construction' => 'materiaux-de-construction',
-                    'Matériel de ski' => 'materiel-de-ski',
-                    'Medion' => 'medion',
-                    'Metro' => 'metro',
-                    'Metro 2033' => 'metro-2033',
-                    'Metro Exodus' => 'metro-exodus',
-                    'Meubles pour aquarium' => 'meubles-pour-aquarium',
-                    'Meubles pour chat' => 'meubles-pour-chat',
-                    'Meubles salle de bain' => 'salle-de-bain',
-                    'Micro-casques gaming' => 'micro-casques-gaming',
-                    'Micro-ondes' => 'micro-ondes',
-                    'Microphones' => 'microphones',
-                    'Micro SD' => 'micro-sd',
-                    'Microsoft Flight Simulator' => 'microsoft-flight-simulator',
-                    'Microsoft Office' => 'microsoft-office',
-                    'Microsoft Surface Book' => 'microsoft-surface-book',
-                    'Microsoft Surface Pro 6' => 'microsoft-surface-pro-6',
-                    'Microsoft Surface Pro 7' => 'microsoft-surface-pro-7',
-                    'Miele' => 'miele',
-                    'Minecraft' => 'minecraft',
-                    'Mini PC' => 'mini-pc',
-                    'Mini réfrigérateurs' => 'mini-refrigerateurs',
-                    'Miroirs' => 'miroirs',
-                    'Mixeurs &amp; Blenders' => 'mixeurs-blenders',
-                    'Mixeurs plongeants' => 'mixeur-plongeant',
-                    'Mobilier' => 'mobilier',
-                    'Mobilier de bureau' => 'fournitures-de-bureau',
-                    'Mobilier de jardin' => 'mobilier-jardin',
-                    'Mobilier de salon' => 'mobilier-salon',
-                    'Mobvoi Ticwatch' => 'mobvoi-ticwatch',
-                    'Mode' => 'mode',
-                    'Mode &amp; accessoires' => 'mode-accessoires',
-                    'Mode &amp; beauté' => 'le-laboratoire-de-la-mode-beaute',
-                    'Mode enfants' => 'mode-enfants',
-                    'Mode femme' => 'mode-femme',
-                    'Mode homme' => 'mode-homme',
-                    'Modélisme' => 'modelisme',
-                    'Monopoly' => 'monopoly',
-                    'Montage PC' => 'montage-pc',
-                    'Montre connectée Amazfit' => 'montres-connectees-amazfit',
-                    'Montre connectée Garmin' => 'montres-connectees-garmin',
-                    'Montre connectée Honor' => 'montres-connectees-honor',
-                    'Montre connectée Samsung' => 'smartwatch-samsung',
-                    'Montres' => 'montres',
-                    'Montres connectées' => 'smartwatch',
-                    'Mortal Kombat' => 'mortal-kombat',
-                    'Mortal Kombat 11' => 'mortal-kombat-11',
-                    'Moto C Plus' => 'moto-c-plus',
-                    'Moto E4' => 'moto-e4',
-                    'Moto G5' => 'moto-g5',
-                    'Moto G5 Plus' => 'moto-g5-plus',
-                    'Moto G5S' => 'moto-g5s',
-                    'Moto G5S Plus' => 'moto-g5s-plus',
-                    'Moto G6' => 'moto-g6',
-                    'Moto G6 Play' => 'moto-g6-play',
-                    'Moto G6 Plus' => 'moto-g6-plus',
-                    'Moto G7 Play' => 'moto-g7-play',
-                    'Moto G7 Plus' => 'moto-g7-plus',
-                    'Moto G7 Power' => 'moto-g7-power',
-                    'Moto M' => 'moto-m',
-                    'Motorola' => 'motorola',
-                    'Moto Z2' => 'moto-z2',
-                    'Moto Z2 Force' => 'moto-z2-force',
-                    'Moto Z2 Play' => 'moto-z2-play',
-                    'Moto Z3' => 'moto-z3',
-                    'Moto Z3 Play' => 'moto-z3-play',
-                    'Moulinex' => 'moulinex',
-                    'Mousses à raser' => 'mousses-a-raser',
-                    'MSI' => 'msi',
-                    'Musées' => 'musees',
-                    'Musique' => 'musique',
-                    'NAS' => 'nas',
-                    'Natation' => 'natation',
-                    'Nature &amp; sports d&#039;hiver' => 'nature-sports-hiver',
-                    'Navigation' => 'navigation',
-                    'NBA 2K' => 'nba-2k',
-                    'NBA 2K20' => 'nba-2k20',
-                    'NERF' => 'nerf',
-                    'Nescafé' => 'nescafe',
-                    'Nespresso' => 'nespresso',
-                    'Nest Learning Thermostat' => 'nest-learning-thermostat',
-                    'Nest Protect' => 'nest-protect',
-                    'Netflix' => 'netflix',
-                    'Nettoyeurs haute-pression' => 'nettoyeurs-haute-pression',
-                    'Nettoyeurs haute pression Karcher' => 'nettoyeurs-haute-pression-karcher',
-                    'Nettoyeurs vapeur' => 'nettoyeurs-vapeur',
-                    'New Balance' => 'new-balance',
-                    'New Balance 574' => 'new-balance-574',
-                    'NHL 20' => 'nhl-20',
-                    'Nike' => 'nike',
-                    'Nike Air Force' => 'nike-air-force',
-                    'Nike Air Jordan' => 'nike-air-jordan',
-                    'Nike Air Max' => 'nike-air-max',
-                    'Nike Air Max 90' => 'nike-air-max-90',
-                    'Nike Air Max 200' => 'nike-air-max-200',
-                    'Nike Air Max 270' => 'nike-air-max-270',
-                    'Nike Air Max 720' => 'nike-air-max-720',
-                    'Nike Free' => 'nike-free',
-                    'Nike Huarache' => 'nike-huarache',
-                    'Nike Roshe Run' => 'nike-roshe-run',
-                    'Nikon' => 'nikon',
-                    'Nikon D3500' => 'nikon-d3500',
-                    'Ni no Kuni' => 'ni-no-kuni',
-                    'Ni No Kuni: Wrath of the White Witch' => 'ni-no-kuni-wrath-white-witch',
-                    'Ni No Kuni II: Revenant Kingdom' => 'ni-no-kuni-2-revenant-kingdom',
-                    'Nintendo' => 'nintendo',
-                    'Nioh' => 'nioh',
-                    'Nivea' => 'nivea',
-                    'Nocciolata' => 'nocciolata',
-                    'Nokia' => 'nokia',
-                    'Nokia 5' => 'nokia-5',
-                    'Nokia 6' => 'nokia-6',
-                    'Nokia 8' => 'nokia-8',
-                    'Nokia 9 PureView' => 'nokia-9-pureview',
-                    'Nougats' => 'nougats',
-                    'Nourriture pour chat' => 'nourriture-pour-chat',
-                    'Nourriture pour chien' => 'nourriture-pour-chien',
-                    'Nourriture pour poissons' => 'nourriture-pour-poissons',
-                    'Nutella' => 'nutella',
-                    'Nvidia' => 'nvidia',
-                    'Nvidia GeForce' => 'nvidia-geforce',
-                    'Nvidia Shield' => 'nvidia-shield',
-                    'Objectifs' => 'objectifs',
-                    'Objets connectés' => 'objets-connectes',
-                    'Oculus Go' => 'oculus-go',
-                    'Oculus Rift' => 'oculus-rift',
-                    'Oiseaux' => 'oiseaux',
-                    'One Piece: Pirate Warriors' => 'one-piece-pirate-warriors',
-                    'OnePlus 5' => 'oneplus-5',
-                    'OnePlus 5T' => 'oneplus-5t',
-                    'OnePlus 6' => 'oneplus-6',
-                    'OnePlus 6T' => 'oneplus-6t',
-                    'OnePlus 7' => 'oneplus-7',
-                    'OnePlus 7 Pro' => 'oneplus-7-pro',
-                    'OnePlus 7T' => 'oneplus-7t',
-                    'OnePlus 7T Pro' => 'oneplus-7t-pro',
-                    'OnePlus 8' => 'oneplus-8',
-                    'OnePlus 8 Pro' => 'oneplus-8-pro',
-                    'OnePlus 8T' => 'oneplus-8t',
-                    'OnePlus 9' => 'oneplus-9',
-                    'OnePlus 9 Pro' => 'oneplus-9-pro',
-                    'OnePlus Nord' => 'oneplus-nord',
-                    'Onkyo' => 'onkyo',
-                    'Oppo Find X2 Lite' => 'oppo-find-x2-lite',
-                    'Oppo Find X2 Neo' => 'oppo-find-x2-neo',
-                    'Oppo Find X2 Pro' => 'oppo-find-x2-pro',
-                    'Oppo Reno' => 'oppo-reno',
-                    'Optique' => 'optique',
-                    'Oral-B' => 'oral-b',
-                    'Ordinateurs de bureau' => 'ordinateurs-de-bureau',
-                    'Ordinateurs tout-en-un' => 'pc-de-bureau-complets',
-                    'Oreillers' => 'oreillers',
-                    'Osram Smart+' => 'osram-smart-plus',
-                    'Outillage' => 'outillage',
-                    'Outils à main' => 'outils-main',
-                    'Outils de jardinage' => 'outils-de-jardinage',
-                    'Outils électriques' => 'outils-electriques',
-                    'Overwatch' => 'overwatch',
-                    'Packs clavier-souris' => 'packs-clavier-souris',
-                    'Packs consoles' => 'packs-consoles',
-                    'Paco Rabanne Invictus' => 'paco-rabanne-invictus',
-                    'Paco Rabanne Lady Million' => 'paco-rabanne-lady-million',
-                    'Paco Rabanne One Million' => 'paco-rabanne-one-million',
-                    'Pain &amp; pâtisseries' => 'pain-patisseries',
-                    'Pampers' => 'pampers',
-                    'Panasonic' => 'panasonic',
-                    'Panasonic Lumix' => 'panasonic-lumix',
-                    'Panier Plus' => 'panier-plus',
-                    'Pantalons' => 'pantalons',
-                    'Papeterie' => 'papeterie',
-                    'Papeterie et bureautique' => 'papeterie-bureautique',
-                    'Papier bureautique' => 'papier-bureautique',
-                    'Papier peint' => 'papier-peint',
-                    'Papier toilette' => 'papier-toilette',
-                    'Parapharmacie' => 'parapharmacie',
-                    'Parasols' => 'parasols',
-                    'Parc Astérix' => 'parc-asterix',
-                    'Parcs d&#039;attraction' => 'parcs-d-attraction',
-                    'Parfums' => 'parfums',
-                    'Parfums femme' => 'parfums-femme',
-                    'Parfums homme' => 'parfums-homme',
-                    'Parkas' => 'parkas',
-                    'Parrot' => 'parrot',
-                    'Partitions' => 'partitions',
-                    'Pâtée pour chat' => 'patee-pour-chat',
-                    'Pâtée pour chien' => 'patee-pour-chien',
-                    'Pâtes à tartiner' => 'pates-tartiner',
-                    'Pâtisserie' => 'patisserie',
-                    'PC Barebones' => 'pc-barebones',
-                    'PC gamer fixe' => 'pc-gamer-complets',
-                    'PC gaming' => 'pc-gaming',
-                    'PC hybrides' => 'hybrides',
-                    'PC Microsoft Surface' => 'pc-microsoft-surface',
-                    'PC portables' => 'pc-portables',
-                    'PC portables Acer' => 'pc-portables-acer',
-                    'PC portables ASUS' => 'pc-portables-asus',
-                    'PC portables Dell' => 'pc-portables-dell',
-                    'PC portables gaming' => 'portables-gamer',
-                    'PC portables Honor' => 'pc-portables-honor',
-                    'PC portables HP' => 'pc-portables-hp',
-                    'PC portables Lenovo' => 'pc-portables-lenovo',
-                    'PC portables Lenovo Legion' => 'lenovo-legion',
-                    'PC portables Xiaomi' => 'pc-portables-xiaomi',
-                    'Pêche' => 'peche',
-                    'Peignes &amp; brosses à cheveux' => 'peignes-et-brosses-a-cheveux',
-                    'Peignoirs' => 'peignoirs',
-                    'Peintures' => 'peintures',
-                    'Peluches' => 'peluches',
-                    'Perceuses' => 'perceuses',
-                    'Périphériques PC' => 'peripheriques-pc',
-                    'Persona 5' => 'persona-5',
-                    'Persona 5 Royal' => 'persona-5-royal',
-                    'PES' => 'pro-evolution-soccer',
-                    'Pèse-personnes' => 'pese-personnes',
-                    'Petites voitures' => 'petites-voitures',
-                    'Pharmacie &amp; parapharmacie' => 'pharmacie-parapharmacie',
-                    'Philips' => 'philips',
-                    'Philips Hue' => 'philips-hue',
-                    'Philips Hue E14' => 'philips-hue-e14',
-                    'Philips Hue E27' => 'philips-hue-e27',
-                    'Philips Hue Go' => 'philips-hue-go',
-                    'Philips Hue GU10' => 'philips-hue-gu10',
-                    'Philips Hue LightStrip' => 'philips-hue-lightstrip',
-                    'Philips Hue Play HDMI Sync Box' => 'philips-hue-play-hdmi-sync-box',
-                    'Philips Lumea' => 'philips-lumea',
-                    'Philips OneBlade' => 'philips-one-blade',
-                    'Philips Sonicare' => 'philips-sonicare',
-                    'Photo' => 'photo',
-                    'Pièces auto' => 'pieces-auto',
-                    'Pièces moto' => 'pieces-moto',
-                    'Pièces vélo' => 'pieces-velo',
-                    'Piles' => 'piles',
-                    'Piles rechargeables' => 'piles-rechargeables',
-                    'Pinceaux maquillage' => 'pinceaux-maquillage',
-                    'Pinces' => 'pinces',
-                    'Ping-pong' => 'ping-pong',
-                    'Pioneer' => 'pioneer',
-                    'Piscines' => 'piscines',
-                    'Pizza' => 'pizza',
-                    'Places de cinéma' => 'places-de-cinema',
-                    'Plafonniers' => 'plafonniers',
-                    'Plancha' => 'planchas',
-                    'Plantes &amp; semis' => 'plantes',
-                    'Plaques de cuisson' => 'plaques-de-cuisson',
-                    'Platines vinyle' => 'platines-vinyle',
-                    'Plats &amp; moules' => 'plats-et-moules',
-                    'PlayerUnknown&#039;s Battlegrounds' => 'playerunknown-s-battleground',
-                    'Playmobil' => 'playmobil',
-                    'PlayStation' => 'playstation',
-                    'Pneus' => 'pneus',
-                    'PocketBook' => 'pocketbook',
-                    'PocketBook Touch Lux 3' => 'pocketbook-touch-lux-3',
-                    'POCO F2 Pro' => 'poco-f2-pro',
-                    'POCO F3' => 'poco-f3',
-                    'POCO M3' => 'poco-m3',
-                    'POCO X3' => 'poco-x3',
-                    'POCO X3 Pro' => 'poco-x3-pro',
-                    'Poêles' => 'poeles',
-                    'Pokémon' => 'pokemon',
-                    'Pokémon: Let&#039;s Go' => 'pokemon-letsgo',
-                    'Pokémon Épée et Bouclier' => 'pokemon-epee-bouclier',
-                    'Pokémon Tournament' => 'pokemon-tournament',
-                    'Pokémon Ultra Sun / Moon' => 'pokemon-ultra-sun-moon',
-                    'Polaroid' => 'polaroid',
-                    'Polos' => 'polos',
-                    'Pompes à vélo' => 'pompes-velo',
-                    'Porte-bébé' => 'porte-bebe',
-                    'Portefeuilles' => 'portefeuilles',
-                    'Posters' => 'posters',
-                    'Potager' => 'potager',
-                    'Pots &amp; cache-pots' => 'pots-et-cache-pots',
-                    'Poubelles' => 'poubelles',
-                    'Poulaillers' => 'poulaillers',
-                    'Poupées' => 'poupees',
-                    'Poussettes' => 'poussettes-bebe',
-                    'Présentez-vous !' => 'mieux-se-connaitre-presentez-vous',
-                    'Préservatifs' => 'preservatifs',
-                    'Princesse Tam-Tam' => 'princesse-tam-tam',
-                    'Prises connectées' => 'prises-connectees',
-                    'Processeurs' => 'processeurs',
-                    'Produit pour lentilles' => 'produit-pour-lentilles',
-                    'Produits de massage' => 'produits-de-massage',
-                    'Produits frais' => 'produits-frais',
-                    'Produits reconditionnés' => 'reconditionne',
-                    'Produits vétérinaires' => 'produits-veterinaires',
-                    'Programme d&#039;Entraînement Cérébral du Dr. Kawashima' => 'dr-kawashima-brain-training',
-                    'Project Cars 2' => 'project-cars-2',
-                    'Protection de la maison' => 'protection-de-la-maison',
-                    'Protections intimes' => 'protections-intimes',
-                    'Protection solaire' => 'protection-solaire',
-                    'Puériculture' => 'puericulture',
-                    'Pulls' => 'pulls',
-                    'Puma' => 'puma',
-                    'Purificateurs d&#039;air' => 'purificateurs-d-air',
-                    'Purina' => 'purina',
-                    'Puzzles' => 'puzzles',
-                    'Pyjamas' => 'pyjamas',
-                    'Pyjamas &amp; chemises de nuit' => 'pyjamas-chemises-de-nuit',
-                    'Pyjamas pour bébés' => 'pyjamas-pour-bebes',
-                    'Qobuz' => 'qobuz',
-                    'Quiksilver' => 'quiksilver',
-                    'Radiateurs' => 'radiateurs',
-                    'Ralph Lauren' => 'ralph-lauren',
-                    'RAM' => 'ram',
-                    'Randonnée' => 'randonnee',
-                    'Raquettes de ping-pong' => 'raquettes-de-ping-pong',
-                    'Raquettes de tennis' => 'raquettes-de-tennis',
-                    'Rasage et épilation' => 'rasage-epilation',
-                    'Rasoirs Braun' => 'rasoirs-braun',
-                    'Rasoirs électriques' => 'rasoirs-electriques',
-                    'Rasoirs Gillette' => 'gillette',
-                    'Rasoirs manuels' => 'rasoirs-manuels',
-                    'Rasoirs Philips' => 'rasoirs-philips',
-                    'Rasoirs Wilkinson' => 'rasoirs-wilkinson-sword',
-                    'Raspberry Pi' => 'raspberry-pi',
-                    'Ray-Ban' => 'ray-ban',
-                    'Razer' => 'razer',
-                    'Razer DeathAdder' => 'razer-deathadder',
-                    'Realme 5 Pro' => 'realme-5-pro',
-                    'Realme X2 Pro' => 'realme-x2-pro',
-                    'Red Dead Redemption' => 'red-dead-redemption',
-                    'Red Dead Redemption 2' => 'red-dead-redemption-2',
-                    'Réductions étudiants &amp; jeunes' => 'reductions-etudiants-et-jeunes',
-                    'Reebok' => 'reebok',
-                    'Reebok Club C' => 'reebok-club-c',
-                    'Réfrigérateurs' => 'refrigerateurs',
-                    'Réfrigérateurs américains' => 'refrigerateurs-americains',
-                    'Refroidissement PC' => 'refroidissement-pc',
-                    'Réhausseurs' => 'rehausseurs',
-                    'Remington' => 'remington',
-                    'Repas de fête' => 'repas-fete-reveillon',
-                    'Repassage' => 'repassage',
-                    'Répéteurs' => 'repeteurs',
-                    'Réseau' => 'reseau',
-                    'Resident Evil' => 'resident-evil',
-                    'Resident Evil 3' => 'resident-evil-3',
-                    'Resident Evil 7' => 'resident-evil-7',
-                    'Restaurants' => 'restaurants',
-                    'Revêtements de sols' => 'revetements-de-sols',
-                    'Revêtements muraux' => 'revetements-muraux',
-                    'Rhum' => 'rhum',
-                    'Richelieus' => 'richelieus',
-                    'Ring Fit Adventure' => 'ring-fit-adventure',
-                    'Risk' => 'risk',
-                    'Robes &amp; jupes' => 'robes-et-jupes',
-                    'Roborock' => 'roborock',
-                    'Roborock S5 MAX' => 'roborock-s5-max',
-                    'Roborock S6' => 'roborock-s6',
-                    'Robots cuiseurs' => 'robots-cuiseurs',
-                    'Robots ménagers' => 'robots-menagers',
-                    'Robot tondeuse' => 'robot-tondeuse',
-                    'ROCCAT' => 'roccat',
-                    'Rollers' => 'rollers',
-                    'Rouges à lèvres' => 'rouges-a-levres',
-                    'Routeurs' => 'routeurs',
-                    'Rowenta' => 'rowenta',
-                    'Royal Canin' => 'royal-canin',
-                    'RTX 2060' => 'rtx-2060',
-                    'RTX 2070' => 'rtx-2070',
-                    'RTX 2080' => 'rtx-2080',
-                    'RTX 2080 Ti' => 'rtx-2080-ti',
-                    'RTX 3070' => 'rtx-3070',
-                    'RTX 3080' => 'rtx-3080',
-                    'RTX 3090' => 'rtx-3090',
-                    'RX 480' => 'rx-480',
-                    'RX 580' => 'rx-580',
-                    'RX 590' => 'radeon-rx-590',
-                    'RX Vega 56' => 'rx-vega-56',
-                    'RX Vega 64' => 'rx-vega-64',
-                    'Sacs à déjections' => 'sacs-a-dejections',
-                    'Sacs à dos' => 'sacs-a-dos',
-                    'Sacs à langer' => 'sacs-a-langer',
-                    'Sacs à main' => 'sacs-a-main',
-                    'Sacs bandoulière' => 'sacs-bandouliere',
-                    'Sacs de couchage' => 'sacs-de-couchage',
-                    'Sacs de randonnée' => 'sacs-de-randonnee',
-                    'Sacs de sport' => 'sacs-de-sport',
-                    'Sacs de voyage' => 'sacs-de-voyage',
-                    'Salle à manger' => 'salle-manger',
-                    'Samsonite' => 'samsonite',
-                    'Samsung' => 'samsung',
-                    'Samsung Galaxy A5' => 'samsung-galaxy-a5',
-                    'Samsung Galaxy A50' => 'samsung-galaxy-a50',
-                    'Samsung Galaxy A51' => 'samsung-galaxy-a51',
-                    'Samsung Galaxy A51 5G' => 'samsung-galaxy-a51-5g',
-                    'Samsung Galaxy A70' => 'samsung-galaxy-a70',
-                    'Samsung Galaxy A80' => 'samsung-galaxy-a80',
-                    'Samsung Galaxy Buds' => 'samsung-galaxy-buds',
-                    'Samsung Galaxy Buds+' => 'samsung-galaxy-buds-plus',
-                    'Samsung Galaxy Buds Live' => 'samsung-galaxy-buds-live',
-                    'Samsung Galaxy Buds Pro' => 'samsung-galaxy-buds-pro',
-                    'Samsung Galaxy Fold' => 'samsung-galaxy-fold',
-                    'Samsung Galaxy Note 8' => 'samsung-galaxy-note-8',
-                    'Samsung Galaxy Note 9' => 'samsung-galaxy-note-9',
-                    'Samsung Galaxy Note 10' => 'samsung-galaxy-note-10',
-                    'Samsung Galaxy Note 10 Lite' => 'samsung-galaxy-note-10-lite',
-                    'Samsung Galaxy Note 10 Plus' => 'samsung-galaxy-note-10-plus',
-                    'Samsung Galaxy Note20' => 'samsung-galaxy-note-20',
-                    'Samsung Galaxy Note20 Ultra' => 'samsung-galaxy-note-20-ultra',
-                    'Samsung Galaxy S7' => 'samsung-galaxy-s7',
-                    'Samsung Galaxy S7 Edge' => 'samsung-galaxy-s7-edge',
-                    'Samsung Galaxy S8' => 'samsung-galaxy-s8',
-                    'Samsung Galaxy S8+' => 'samsung-galaxy-s8plus',
-                    'Samsung Galaxy S9' => 'samsung-galaxy-s9',
-                    'Samsung Galaxy S9 Plus' => 'samsung-galaxy-s9-plus',
-                    'Samsung Galaxy S10' => 'samsung-galaxy-s10',
-                    'Samsung Galaxy S10 Lite' => 'samsung-galaxy-s10-lite',
-                    'Samsung Galaxy S10+' => 'samsung-galaxy-s10-plus',
-                    'Samsung Galaxy S10e' => 'samsung-galaxy-s10e',
-                    'Samsung Galaxy S20' => 'samsung-galaxy-s20',
-                    'Samsung Galaxy S20 FE' => 'samsung-galaxy-s20-fe',
-                    'Samsung Galaxy S20 Ultra' => 'samsung-galaxy-s20-ultra',
-                    'Samsung Galaxy S20+' => 'samsung-galaxy-s20-plus',
-                    'Samsung Galaxy S21 5G' => 'samsung-galaxy-s21-5g',
-                    'Samsung Galaxy S21 Ultra 5G' => 'samsung-galaxy-s21-ultra-5g',
-                    'Samsung Galaxy S21+ 5G' => 'samsung-galaxy-s21-plus-5g',
-                    'Samsung Galaxy Tab A' => 'samsung-galaxy-tab-a',
-                    'Samsung Galaxy Tab S2' => 'samsung-galaxy-tab-s2',
-                    'Samsung Galaxy Tab S3' => 'samsung-galaxy-tab-s3',
-                    'Samsung Galaxy Tab S4' => 'samsung-galaxy-tab-s4',
-                    'Samsung Galaxy Tab S5e' => 'samsung-galaxy-tab-s5e',
-                    'Samsung Galaxy Tab S6' => 'samsung-galaxy-tab-s6',
-                    'Samsung Galaxy Tab S7' => 'samsung-galaxy-tab-s7',
-                    'Samsung Galaxy Watch' => 'samsung-galaxy-watch',
-                    'Samsung Galaxy Watch3' => 'samsung-galaxy-watch-3',
-                    'Samsung Galaxy Watch Active 2' => 'samsung-galaxy-watch-active2',
-                    'Samsung Galaxy Z Flip' => 'galaxy-z-flip',
-                    'Samsung Gear' => 'samsung-gear',
-                    'Samsung Gear S3' => 'samsung-gear-s3',
-                    'Samsung Gear VR' => 'samsung-gear-vr',
-                    'Sandales' => 'sandales',
-                    'SanDisk' => 'sandisk',
-                    'Sanitaires et robinetterie' => 'sanitaires-robinetterie',
-                    'Santé &amp; Cosmétiques' => 'sante-et-cosmetiques',
-                    'Sapins de Noël' => 'sapins-noel',
-                    'Savons' => 'savons',
-                    'Scanners' => 'scanners',
-                    'Scanners A3' => 'scanners-a3',
-                    'Scanners A4' => 'scanners-a4',
-                    'Scies' => 'scies',
-                    'Scooters' => 'scooters',
-                    'Seagate' => 'seagate',
-                    'Sécateurs' => 'secateurs',
-                    'Sèche-cheveux' => 'seche-cheveux',
-                    'Sèche-linge' => 'seche-linge',
-                    'Seiko' => 'seiko',
-                    'Séjours' => 'sejours',
-                    'Sekiro: Shadows Die Twice' => 'sekiro',
-                    'Semis &amp; graines' => 'semis-et-graines',
-                    'Sennheiser' => 'sennheiser',
-                    'Senseo' => 'senseo',
-                    'Séries TV' => 'series-tv',
-                    'Service &amp; réparation auto-moto' => 'service-reparation-auto-moto',
-                    'Services' => 'services-divers',
-                    'Services auto' => 'services-auto',
-                    'Services de livraison' => 'services-livraisons',
-                    'Services moto' => 'services-moto',
-                    'Services photo' => 'services-photo',
-                    'Serviettes' => 'serviettes',
-                    'Serviettes hygiéniques' => 'serviettes-hygieniques',
-                    'Sextoys' => 'sextoys',
-                    'Shadow of the Colossus' => 'shadow-of-the-colossus',
-                    'Shadow of the Tomb Raider' => 'shadow-tomb-raider',
-                    'Shalimar' => 'shalimar',
-                    'Shampooings &amp; soins' => 'shampooings-et-soins',
-                    'Shenmue' => 'shenmue',
-                    'Shenmue I &amp; II' => 'shenmue-i-ii',
-                    'Shenmue III' => 'shenmue-iii',
-                    'Shorts' => 'shorts',
-                    'Shorts de bain' => 'shorts-de-bain',
-                    'Sièges auto' => 'sieges-auto',
-                    'Siemens' => 'siemens',
-                    'Skates &amp; longboards' => 'skates-et-longboards',
-                    'Skechers' => 'sketchers',
-                    'Ski' => 'ski',
-                    'Skyrim' => 'skyrim',
-                    'Slips &amp; boxers' => 'slips-et-boxers',
-                    'Smartphones' => 'smartphones',
-                    'Smartphones à moins de 100€' => 'smartphones-moins-de-100',
-                    'Smartphones à moins de 200€' => 'smartphones-moins-de-200',
-                    'Smartphones Android' => 'smartphones-android',
-                    'Smartphones Asus' => 'smartphones-asus',
-                    'Smartphones Google' => 'smartphones-google',
-                    'Smartphones Honor' => 'smartphones-honor',
-                    'Smartphones HTC' => 'smartphones-htc',
-                    'Smartphones Huawei' => 'smartphones-huawei',
-                    'Smartphones Lenovo Motorola' => 'smartphones-lenovo-motorola',
-                    'Smartphones LG' => 'smartphones-lg',
-                    'Smartphones Nokia' => 'smartphones-nokia',
-                    'Smartphones OnePlus' => 'smartphones-oneplus',
-                    'Smartphones Oppo' => 'smartphones-oppo',
-                    'Smartphones Realme' => 'smartphones-realme',
-                    'Smartphones Samsung' => 'smartphones-samsung',
-                    'Smartphones Sony' => 'smartphones-sony',
-                    'Smartphones Xiaomi' => 'smartphones-xiaomi',
-                    'Smartphones ZTE' => 'smartphones-zte',
-                    'Smart TV' => 'smart-tv',
-                    'Sneakers' => 'sneakers',
-                    'SodaStream' => 'sodastream',
-                    'Sofas gonflable' => 'sofas-gonflable',
-                    'Soin barbe et rasage' => 'soin-barbe-rasage',
-                    'Soin de la peau' => 'soin-peau',
-                    'Soin des cheveux' => 'soin-des-cheveux',
-                    'Soin des ongles' => 'soin-ongles',
-                    'Soins dentaires' => 'soins-dentaires',
-                    'Sonos' => 'sonos',
-                    'Sonos Beam' => 'sonos-beam',
-                    'Sonos Move' => 'sonos-move',
-                    'Sonos One' => 'sonos-one',
-                    'Sonos PLAY:1' => 'sonos-play-1',
-                    'Sonos PLAY:3' => 'sonos-play-3',
-                    'Sonos PLAY:5' => 'sonos-play-5',
-                    'Sonos PLAYBAR' => 'sonos-playbar',
-                    'Sony' => 'sony',
-                    'Sony PlayStation VR' => 'sony-playstation-vr',
-                    'Sony Pulse 3D sans fil' => 'casque-audio-sony-pulse-3d',
-                    'Sony WF-1000XM3' => 'sony-wf-1000xm3',
-                    'Sony WH-1000XM3' => 'sony-wh-1000xm3',
-                    'Sony WH-1000XM4' => 'sony-wh-1000xm4',
-                    'Sony Xperia XA1' => 'sony-xperia-xa1',
-                    'Sony Xperia X Compact' => 'sony-xperia-x-compact',
-                    'Sony Xperia XZ1' => 'sony-xperia-xz1',
-                    'Sony Xperia XZ1 Compact' => 'sony-xperia-xz1-compact',
-                    'Sony Xperia XZ Premium' => 'sony-xperia-xz-premium',
-                    'Sony Xperia Z3' => 'sony-xperia-z3',
-                    'Soulcalibur' => 'soulcalibur',
-                    'Souris' => 'souris',
-                    'Souris gamer' => 'souris-gamer',
-                    'Souris Logitech' => 'souris-logitech',
-                    'Souris sans fil' => 'souris-sans-fil',
-                    'Sous-vêtements' => 'sous-vetements',
-                    'Sous-vêtements de sport' => 'sous-vetements-de-sport',
-                    'South Park' => 'south-park',
-                    'Soutiens-gorge' => 'soutiens-gorge',
-                    'Spas' => 'spa',
-                    'Spectacles' => 'spectacles',
-                    'Spectacles &amp; Billetterie' => 'sorties',
-                    'Spectacles comiques' => 'spectacles-comiques',
-                    'Spectacles pour enfants' => 'spectacles-pour-enfants',
-                    'Sports &amp; plein air' => 'sports-plein-air',
-                    'Sports collectifs' => 'sports-collectifs',
-                    'Sports nautiques' => 'sports-nautiques',
-                    'Sportswear' => 'sportswear',
-                    'Spotify' => 'spotify',
-                    'SSD' => 'ssd',
-                    'Star Wars: Jedi Fallen Order' => 'star-wars-jedi-fallen-order',
-                    'Star Wars: Squadrons' => 'star-wars-squadrons',
-                    'Star Wars Battlefront' => 'star-wars-battlefront',
-                    'Stations météo' => 'stations-meteo',
-                    'Stickers muraux' => 'stickers-muraux',
-                    'Stihl' => 'stihl',
-                    'Stockage externe' => 'stockage',
-                    'Streaming' => 'streaming',
-                    'Streaming musical' => 'streaming-musical',
-                    'Streaming vidéo' => 'streaming-video',
-                    'Stylos' => 'stylos',
-                    'Sucettes' => 'sucettes',
-                    'Super Mario' => 'super-mario',
-                    'Super Mario 3D All-Stars' => 'super-mario-3d-all-stars',
-                    'Super Mario Maker 2' => 'super-mario-maker-2',
-                    'Super Mario Party' => 'super-mario-party',
-                    'Super Smash Bros. Ultimate' => 'super-smash-bros-ultimate',
-                    'Support GPS &amp; smartphone' => 'support-gps-et-smartphone',
-                    'Supports TV' => 'supports-tv',
-                    'Surface Pro 4' => 'surface-pro-4',
-                    'Surgelés' => 'surgeles',
-                    'Surveillance' => 'surveillance',
-                    'Suspensions' => 'suspensions',
-                    'Swatch' => 'swatch',
-                    'Switch réseau' => 'switch-reseau',
-                    'Systèmes d&#039;exploitation' => 'systemes-d-exploitation',
-                    'Systèmes multiroom' => 'systemes-multiroom',
-                    'T-shirts' => 't-shirts',
-                    'Tables' => 'tables',
-                    'Tables à langer' => 'tables-a-langer',
-                    'Tables à repasser' => 'tables-a-repasser',
-                    'Tables basses' => 'tables-basses',
-                    'Tables de camping' => 'tables-de-camping',
-                    'Tables de mixage' => 'tables-de-mixage',
-                    'Tables de ping-pong' => 'tables-ping-pong',
-                    'Tablettes' => 'tablettes',
-                    'Tablettes graphiques' => 'tablettes-graphiques',
-                    'Tablettes graphiques Huion' => 'huion',
-                    'Tablettes graphiques Wacom' => 'wacom',
-                    'Tablettes Huawei' => 'tablettes-huawei',
-                    'Tablettes Lenovo' => 'tablettes-lenovo',
-                    'Tablettes Microsoft Surface' => 'tablettes-microsoft-surface',
-                    'Tablettes Samsung' => 'tablettes-samsung',
-                    'Tablettes Xiaomi' => 'tablettes-xiaomi',
-                    'Tampons' => 'tampons',
-                    'Tapis' => 'tapis',
-                    'Tapis de souris' => 'tapis-de-souris',
-                    'Tassimo' => 'tassimo',
-                    'Taxis' => 'taxis',
-                    'Tefal' => 'tefal',
-                    'Tekken' => 'tekken',
-                    'Tekken 7' => 'tekken-7',
-                    'Télécommandes' => 'telecommandes',
-                    'Téléphones fixes' => 'telephones-fixes',
-                    'Téléphonie' => 'telephonie',
-                    'Téléviseurs' => 'televiseurs',
-                    'Tentes' => 'tentes',
-                    'Tentes Quechua' => 'tentes-quechua',
-                    'Têtes de brosse à dents de rechange' => 'tetes-de-brosse-a-dents-de-rechange',
-                    'Théâtre' => 'theatre',
-                    'The Last of Us' => 'the-last-of-us',
-                    'The Last of Us Part II' => 'the-last-of-us-part-2',
-                    'The Legend of Zelda' => 'the-legend-of-zelda',
-                    'The Legend of Zelda: Breath of the Wild' => 'zelda-breath-of-the-wild',
-                    'The Legend of Zelda: Link&#039;s Awakening' => 'legend-of-zelda-link-s-awakening',
-                    'The Legend of Zelda: Skyward Sword HD' => 'the-legend-of-zelda-skyward-sword-hd',
-                    'Thermomètres' => 'thermometres',
-                    'Thermomix' => 'thermomix',
-                    'Thermostats connectés' => 'thermostat-connecte',
-                    'Thés' => 'thes',
-                    'Thés glacés' => 'thes-glaces',
-                    'The Walking dead' => 'the-walking-dead',
-                    'The Witcher' => 'the-witcher',
-                    'The Witcher 3' => 'the-witcher-3',
-                    'Time&#039;s Up!' => 'time-s-up',
-                    'Tokyo Laundry' => 'tokyo-laundry',
-                    'Tomb Raider' => 'tomb-raider',
-                    'Tom Clancy&#039;s' => 'tom-clancy-s',
-                    'Tom Clancy&#039;s Ghost Recon: Wildlands' => 'tom-clancy-s-ghost-recon-wildlands',
-                    'Tom Clancy&#039;s Ghost Recon Breakpoint' => 'tom-clancy-s-ghost-recon-breakpoint',
-                    'Tom Clancy&#039;s The Division' => 'tom-clancy-s-the-division',
-                    'TomTom' => 'tomtom',
-                    'Tondeuses' => 'tondeuses',
-                    'Tondeuses à gazon' => 'tondeuses-a-gazon',
-                    'Toner' => 'toner',
-                    'Tongs' => 'tongs',
-                    'Torchons' => 'torchons',
-                    'Toshiba' => 'toshiba',
-                    'Total War' => 'total-war',
-                    'Total War: Warhammer' => 'total-war-warhammer',
-                    'Total War: Warhammer II' => 'total-war-warhammer-ii',
-                    'Tournevis' => 'tournevis-et-visseuses',
-                    'TP-Link' => 'tp-link',
-                    'Trains &amp; Bus' => 'trains-bus',
-                    'Trampolines' => 'trampolines',
-                    'Transats &amp; cosys' => 'transats-et-cosys',
-                    'Transport bébé' => 'poussettes',
-                    'Transport d&#039;animaux' => 'transport-d-animaux',
-                    'Transports en commun' => 'transports-en-commun',
-                    'Transports urbains' => 'transports-urbains',
-                    'Travaux &amp; matériaux' => 'travaux-materiaux',
-                    'Trépieds' => 'trepieds',
-                    'Trixie' => 'trixie',
-                    'Tronçonneuses' => 'tronconneuses',
-                    'Tropico' => 'tropico',
-                    'Tropico 6' => 'tropico-6',
-                    'Trottinettes' => 'trottinettes',
-                    'Trottinettes électriques' => 'trottinettes-electriques',
-                    'Trottinettes électriques en libre-service' => 'location-trottinettes-electriques',
-                    'Trottinettes Xiaomi' => 'trottinettes-xiaomi',
-                    'TV &amp; Vidéo' => 'tv-video',
-                    'TV 4K' => 'tv-4k',
-                    'TV 40&#039;&#039; à 64&#039;&#039;' => 'tv-40-pouces-a-64-pouces',
-                    'TV 65&#039;&#039; et plus' => 'tv-65-pouces-et-plus',
-                    'TV Hisense' => 'tv-hisense',
-                    'TV LG' => 'tv-lg',
-                    'TV OLED' => 'tv-oled',
-                    'TV Panasonic' => 'tv-panasonic',
-                    'TV Philips' => 'tv-philips',
-                    'TV Samsung' => 'tv-samsung',
-                    'TV Samsung QLED' => 'tv-samsung-qled',
-                    'TV Samsung The Frame' => 'tv-samsung-the-frame',
-                    'TV Sony' => 'tv-sony',
-                    'TV TCL' => 'tv-tcl',
-                    'TV Toshiba' => 'tv-toshiba',
-                    'TV Xiaomi' => 'tv-xiaomi',
-                    'UE Boom 2' => 'ue-boom-2',
-                    'UE Boom 3' => 'ue-boom-3',
-                    'UE Megaboom' => 'ue-megaboom',
-                    'UE Megaboom 3' => 'ue-megaboom-3',
-                    'UE Wonderboom' => 'ue-wonderboom',
-                    'Ultraportables' => 'ultraportables',
-                    'Uncharted' => 'uncharted',
-                    'Uncharted 4' => 'uncharted-4',
-                    'Uncharted: The Lost Legacy' => 'uncharted-the-lost-legacy',
-                    'Under Armour' => 'under-armour',
-                    'Until Dawn' => 'until-dawn',
-                    'Ustensiles de cuisine' => 'ustensiles-de-cuisine',
-                    'Ustensiles de cuisson' => 'ustensiles-de-cuisson',
-                    'Vacances et séjours' => 'vacances-sejours',
-                    'Vaisselle' => 'vaisselle',
-                    'Valises' => 'valises',
-                    'Valises cabine' => 'valises-cabine',
-                    'Valises rigides' => 'valises-rigides',
-                    'Vans Old Skool' => 'vans-old-skool',
-                    'Variétés &amp; revues' => 'varietes-et-revues',
-                    'Vases' => 'vases',
-                    'Veet' => 'veet',
-                    'Veilleuses' => 'veilleuses',
-                    'Vélos' => 'velos',
-                    'Vélos d&#039;appartement' => 'velos-d-appartement',
-                    'Vélos électriques' => 'velos-electriques',
-                    'Ventilateurs' => 'ventilateurs',
-                    'Ventirad' => 'ventirad',
-                    'Vernis à ongles' => 'vernis-a-ongles',
-                    'Verres' => 'verres',
-                    'Vestes' => 'vestes',
-                    'Vestes polaires' => 'vestes-polaires',
-                    'Vêtements d&#039;été' => 'vetements-d-ete',
-                    'Vêtements d&#039;hiver' => 'vetements-d-hiver',
-                    'Vêtements de grossesse' => 'vetements-de-grossesse',
-                    'Vêtements de montagne' => 'vetements-techniques',
-                    'Vêtements de running' => 'vetements-de-running',
-                    'Vêtements de ski' => 'vetements-de-ski',
-                    'Vêtements de sport' => 'vetements-de-sport',
-                    'Vêtements pour bébé' => 'vetements-pour-bebe',
-                    'Vidéoprojecteurs' => 'projecteurs',
-                    'Vidéoprojecteurs 3D' => 'videoprojecteurs-3d',
-                    'Vidéoprojecteurs Acer' => 'videoprojecteurs-acer',
-                    'Vidéoprojecteurs BenQ' => 'videoprojecteurs-benq',
-                    'Vidéoprojecteurs Epson' => 'videoprojecteurs-epson',
-                    'Vidéoprojecteurs HD' => 'videoprojecteurs-hd',
-                    'Vidéoprojecteurs LG' => 'videoprojecteurs-lg',
-                    'Vidéoprojecteurs Optoma' => 'videoprojecteurs-optoma',
-                    'Vins' => 'vins',
-                    'Visites &amp; patrimoine' => 'visites-et-patrimoine',
-                    'Visseuses' => 'visseuses',
-                    'VOD' => 'vod',
-                    'Voitures &amp; motos' => 'voitures-motos',
-                    'Voitures télécommandées' => 'voitures-telecommandees',
-                    'Volants' => 'volants-de-course',
-                    'Vols' => 'billets-d-avion',
-                    'Voyages' => 'voyages',
-                    'Voyages &amp; loisirs' => 'le-laboratoire-des-voyages-loisirs',
-                    'VPN' => 'vpn',
-                    'VTC' => 'vtc',
-                    'VTT' => 'vtt',
-                    'Wacom Cintiq' => 'cintiq',
-                    'Watch Dogs' => 'watch-dogs',
-                    'Watch Dogs 2' => 'watch-dogs-2',
-                    'Watch Dogs: Legion' => 'watch-dogs-legion',
-                    'Watercooling' => 'watercooling',
-                    'WD (Western Digital)' => 'western-digital',
-                    'Wearables' => 'wearables',
-                    'Webcams' => 'webcams',
-                    'Whey' => 'whey',
-                    'Whirlpool' => 'whirlpool',
-                    'Whiskas' => 'whiskas',
-                    'Whisky' => 'whisky',
-                    'Wiko' => 'wiko',
-                    'Wilkinson Sword Hydro 5' => 'wilkinson-sword-hydro-5',
-                    'Windows' => 'windows',
-                    'WindScribe' => 'windscribe',
-                    'Wolfenstein' => 'wolfenstein',
-                    'Wolfenstein II: The New Colossus' => 'wolfenstein-ii-the-new-colossus',
-                    'Xbox' => 'xbox',
-                    'Xbox Game Pass' => 'xbox-game-pass',
-                    'Xbox Live' => 'xbox-live',
-                    'XCOM' => 'xcom',
-                    'XCOM 2' => 'xcom-2',
-                    'Xiaomi' => 'xiaomi',
-                    'Xiaomi AirDots' => 'xiaomi-airdots',
-                    'Xiaomi Black Shark' => 'xiaomi-black-shark',
-                    'Xiaomi Black Shark 2' => 'xiaomi-black-shark-2',
-                    'Xiaomi Mi6' => 'xiaomi-mi6',
-                    'Xiaomi Mi8' => 'xiaomi-mi8',
-                    'Xiaomi Mi8 Lite' => 'xiaomi-mi8-lite',
-                    'Xiaomi Mi8 Pro' => 'xiaomi-mi8-pro',
-                    'Xiaomi Mi8 SE' => 'xoaimi-mi8-se',
-                    'Xiaomi Mi9' => 'xiaomi-mi9',
-                    'Xiaomi Mi 9 Lite' => 'xiaomi-mi-9-lite',
-                    'Xiaomi Mi 9 Pro' => 'xiaomi-mi-9-pro',
-                    'Xiaomi Mi 9 SE' => 'xiaomi-mi-9-se',
-                    'Xiaomi Mi 9T' => 'xiaomi-mi-9t',
-                    'Xiaomi Mi 9T Pro' => 'xiaomi-mi-9t-pro',
-                    'Xiaomi Mi 10' => 'xiaomi-mi-10',
-                    'Xiaomi Mi 10 Lite' => 'xiaomi-mi-10-lite',
-                    'Xiaomi Mi 10 Pro' => 'xiaomi-mi-10-pro',
-                    'Xiaomi Mi 10T' => 'xiaomi-mi-10t',
-                    'Xiaomi Mi 10T Lite' => 'xiaomi-mi-10t-lite',
-                    'Xiaomi Mi 10T Pro' => 'xiaomi-mi-10t-pro',
-                    'Xiaomi Mi 11' => 'xiaomi-mi-11',
-                    'Xiaomi Mi 11 Lite' => 'xiaomi-mi-11-lite',
-                    'Xiaomi Mi A1' => 'xiaomi-mi-a1',
-                    'Xiaomi Mi A2' => 'xiaomi-mi-a2',
-                    'Xiaomi Mi A2 Lite' => 'xiaomi-mi-a2-lite',
-                    'Xiaomi Mi Airdots Pro' => 'xiaomi-mi-airdots-pro',
-                    'Xiaomi Mi Band' => 'xiaomi-mi-band',
-                    'Xiaomi Mi Band 4' => 'xiaomi-mi-band-4',
-                    'Xiaomi Mi Band 5' => 'xiaomi-mi-band-5',
-                    'Xiaomi Mi Band 6' => 'xiaomi-mi-band-6',
-                    'Xiaomi Mi Box' => 'xiaomi-mi-box',
-                    'Xiaomi Mi Electric Scooter M365' => 'xiaomi-mi-electric-scooter-m365',
-                    'Xiaomi Mi Max' => 'xiaomi-mi-max',
-                    'Xiaomi Mi Mix' => 'xiaomi-mi-mix',
-                    'Xiaomi Mi Mix 2' => 'xiaomi-mi-mix-2',
-                    'Xiaomi Mi Note 10' => 'xiaomi-mi-note-10',
-                    'Xiaomi Mi Note 10 Pro' => 'xiaomi-mi-note-10-pro',
-                    'Xiaomi Mi Pad 3' => 'xiaomi-mi-pad-3',
-                    'Xiaomi Mi Watch' => 'xiaomi-mi-watch',
-                    'Xiaomi Pocophone F1' => 'xiaomi-pocophone-f1',
-                    'Xiaomi Redmi 4A' => 'xiaomi-redmi-4a',
-                    'Xiaomi Redmi 4X' => 'xiaomi-redmi-4x',
-                    'Xiaomi Redmi 7' => 'xiaomi-redmi-7',
-                    'Xiaomi Redmi 9' => 'xiaomi-redmi-9',
-                    'Xiaomi Redmi AirDots' => 'xiaomi-redmi-airdots',
-                    'Xiaomi Redmi Note 4' => 'xiaomi-redmi-note-4',
-                    'Xiaomi Redmi Note 5' => 'xiaomi-redmi-note-5',
-                    'Xiaomi Redmi Note 6' => 'xiaomi-redmi-note-6',
-                    'Xiaomi Redmi Note 7' => 'xiaomi-redmi-note-7',
-                    'Xiaomi Redmi Note 8' => 'xiaomi-redmi-note-8',
-                    'Xiaomi Redmi Note 8 Pro' => 'xiaomi-redmi-note-8-pro',
-                    'Xiaomi Redmi Note 9' => 'xiaomi-redmi-note-9',
-                    'Xiaomi Redmi Note 9 Pro' => 'xiaomi-redmi-note-9-pro',
-                    'Xiaomi Redmi Note 9S' => 'xiaomi-redmi-note-9s',
-                    'Xiaomi Redmi Note 10' => 'xiaomi-redmi-note-10',
-                    'Xiaomi Redmi Note 10 Pro' => 'xiaomi-redmi-10-pro',
-                    'Xiaomi Smart Home' => 'xiaomi-smart-home',
-                    'Yamaha' => 'yamaha',
-                    'Yeelight' => 'xiaomi-yeelight',
-                    'Yoshi&#039;s Crafted World' => 'yoshi-crafted-world',
-                    'Zoos' => 'zoos',
-                ]
-            ],
+                'type' => 'text',
+                'exampleValue' => 'abonnements-internet',
+                'title' => 'Nom du groupe dans l\'URL : Il faut entrer le nom du groupe qui est présent après "https://www.dealabs.com/groupe/" et avant tout éventuel "?"
+Exemple : Si l\'URL du groupe affichées dans le navigateur est :
+https://www.dealabs.com/groupe/abonnements-internet?sortBy=lowest_price
+Il faut alors saisir :
+abonnements-internet',
+                ],
             'order' => [
                 'name' => 'Trier par',
                 'type' => 'list',
@@ -1923,5 +100,7 @@ class DealabsBridge extends PepperBridgeAbstract
         'title-talk' => 'Surveillance Discussion',
         'deal-type' => 'Type de deal',
         'localdeal' => 'Deal Local',
+        'context-hot' => '-hot',
+        'context-new' => '-nouveaux',
     ];
 }
diff --git a/bridges/HotUKDealsBridge.php b/bridges/HotUKDealsBridge.php
index 6958220e..9d56fa97 100644
--- a/bridges/HotUKDealsBridge.php
+++ b/bridges/HotUKDealsBridge.php
@@ -40,3202 +40,13 @@ class HotUKDealsBridge extends PepperBridgeAbstract
         'Deals per group' => [
             'group' => [
                 'name' => 'Group',
-                'type' => 'list',
-                'title' => 'Group whose deals must be displayed',
-                'values' => [
-                    '3D Blu-ray' => '3d-bluray',
-                    '3D Printer' => '3d-printer',
-                    '3D TV' => '3d-tv',
-                    '4K Blu-ray' => '4k-bluray',
-                    '4K Monitor' => '4k-monitor',
-                    '4K TV' => '4k-tv',
-                    '5G Phones' => '5g-phones',
-                    '7 Up' => '7up',
-                    '8K TV' => '8k-tv',
-                    '32 inch TV' => '32-inch-tv',
-                    '40 inch TV' => '40-inch-tv',
-                    '55 inch TV' => '55-inch-tv',
-                    '65 inch TV' => '65-inch-tv',
-                    '75 inch TV' => '75-inch-tv',
-                    '144Hz Monitor' => '144hz',
-                    'A4 Paper' => 'a4-paper',
-                    'AAA Battery' => 'aaa',
-                    'AA Battery' => 'aa',
-                    'Abercrombie' => 'abercrombie',
-                    'Aberlour' => 'aberlour',
-                    'Accommodation' => 'accomodation',
-                    'Accurist' => 'accurist',
-                    'Ace Combat 7: Skies Unknown' => 'ace-combat-7',
-                    'Acer' => 'acer',
-                    'Acer Aspire' => 'acer-aspire',
-                    'Acer Laptop' => 'acer-laptop',
-                    'Acer PC Monitor' => 'acer-pc-monitor',
-                    'Acer Predator' => 'acer-predator',
-                    'Action Camera' => 'action-camera',
-                    'Action Figure &amp; Playsets' => 'playsets',
-                    'Activewear' => 'sports-clothes',
-                    'Activia' => 'activia',
-                    'adidas' => 'adidas',
-                    'adidas Continental' => 'continental',
-                    'Adidas Gazelle' => 'gazelle',
-                    'Adidas Originals' => 'adidas-originals',
-                    'Adidas Samba' => 'samba',
-                    'Adidas Stan Smith' => 'stan-smith',
-                    'Adidas Superstar' => 'adidas-superstar',
-                    'Adidas Trainers' => 'adidas-shoes',
-                    'Adidas Ultraboost' => 'adidas-ultraboost',
-                    'Adidas ZX Flux' => 'adidas-zx-flux',
-                    'Adobe' => 'adobe',
-                    'Adobe Lightroom' => 'lightroom',
-                    'Adobe Photoshop' => 'photoshop',
-                    'Adult Products' => 'adult',
-                    'Advent Calendar' => 'advent-calendar',
-                    'Adventure Time' => 'adventure-time',
-                    'AEG' => 'aeg',
-                    'Aftershave' => 'aftershave',
-                    'Age Of Empires' => 'age-of-empires',
-                    'Air Bed' => 'air-bed',
-                    'Air Conditioner' => 'air-con',
-                    'Airer' => 'airer',
-                    'Airfix' => 'airfix',
-                    'Air Fryer' => 'air-fryer',
-                    'Airline' => 'airline',
-                    'Airport' => 'airport',
-                    'Airport Parking' => 'airport-parking',
-                    'Air Purifier' => 'air-purifier',
-                    'AirTag' => 'airtag',
-                    'Air Treatment' => 'air-treatment',
-                    'AKG' => 'akg',
-                    'Alarm Clock' => 'alarm-clock',
-                    'Alarm System' => 'alarm-system',
-                    'Alcatel' => 'alcatel',
-                    'Alcohol' => 'alcohol',
-                    'Alesis' => 'alesis',
-                    'Alien: Isolation' => 'alien-isolation',
-                    'Alienware' => 'alienware',
-                    'All-in-One PC' => 'all-in-one-pc',
-                    'All-in-One Printer' => 'all-in-one-printer',
-                    'Alloy Wheel' => 'alloy-wheels',
-                    'All Saints' => 'all-saints',
-                    'Almonds' => 'almonds',
-                    'Alpro' => 'alpro',
-                    'Alton Towers' => 'alton-towers',
-                    'Amazfit' => 'xiaomi-amazfit',
-                    'Amazfit Bip' => 'xiaomi-amazfit-bip',
-                    'Amazfit GTS' => 'amazfit-gts',
-                    'Amazfit Verge' => 'amazfit-verge',
-                    'Amazfit Verge Lite' => 'amazfit-verge-lite',
-                    'Amazfit Watch' => 'amazfit-watch',
-                    'Amazon Add On Item' => 'add-on-item',
-                    'Amazon Business' => 'amazon-business',
-                    'Amazon Echo' => 'amazon-echo',
-                    'Amazon Echo Dot' => 'amazon-echo-dot',
-                    'Amazon Echo Plus' => 'amazon-echo-plus',
-                    'Amazon Echo Show' => 'amazon-echo-show',
-                    'Amazon Echo Show 5' => 'echo-show-5',
-                    'Amazon Echo Show 8' => 'amazon-echo-show-8',
-                    'Amazon Echo Spot' => 'amazon-echo-spot',
-                    'Amazon Fire 7' => 'amazon-fire-7',
-                    'Amazon Fire HD 8' => 'amazon-fire-hd-7',
-                    'Amazon Fire HD 10 Tablet' => 'amazon-fire-hd-10',
-                    'Amazon Fire Tablet' => 'amazon-tablet',
-                    'Amazon Fire TV Cube' => 'fire-tv-cube',
-                    'Amazon Fire TV Stick' => 'amazon-fire-stick',
-                    'Amazon Pantry' => 'amazon-pantry',
-                    'Amazon Prime' => 'amazon-prime',
-                    'Amazon Prime Video' => 'amazon-video',
-                    'Amazon Warehouse' => 'amazon-warehouse',
-                    'AMD' => 'amd',
-                    'AMD Radeon' => 'radeon',
-                    'AMD Ryzen' => 'amd-ryzen',
-                    'AMD Ryzen 5 5600X' => 'amd-ryzen-5-5600x',
-                    'AMD Ryzen 7 5800X' => 'amd-ryzen-7-5800x',
-                    'AMD Ryzen 9 5900X' => 'amd-ryzen-9-5900x',
-                    'AMD Ryzen 9 5950X' => 'amd-ryzen-9-5950x',
-                    'Amex' => 'amex',
-                    'Amiibo' => 'amiibo',
-                    'Amplifier' => 'amplifier',
-                    'Anchor Butter' => 'anchor-butter',
-                    'Andrex' => 'andrex',
-                    'Android Apps' => 'android-app',
-                    'Android Smartphone' => 'android-smartphone',
-                    'Android Tablet' => 'android-tablet',
-                    'Angelcare' => 'angelcare',
-                    'Angle Grinder' => 'grinder',
-                    'Anglepoise' => 'anglepoise',
-                    'Angry Birds' => 'angry-birds',
-                    'Animal Crossing' => 'animal-crossing',
-                    'Anime' => 'anime',
-                    'Anker' => 'anker',
-                    'Ankle Boots' => 'ankle-boots',
-                    'Anno 1800' => 'anno-1800',
-                    'Anthem' => 'anthem',
-                    'Antibacterial Hand Gel' => 'hand-gel',
-                    'Antibacterial Wipes' => 'cleaning-wipes',
-                    'Antivirus' => 'antivirus',
-                    'Antler' => 'antler',
-                    'AOC' => 'aoc',
-                    'Apex Legends' => 'apex-legends',
-                    'A Plague Tale: Innocence' => 'a-plague-tale-innocence',
-                    'App' => 'app',
-                    'Apple' => 'apple',
-                    'Apple AirPods' => 'apple-airpods',
-                    'Apple Airpods 2' => 'airpods-2',
-                    'Apple Airpods Max' => 'airpods-max',
-                    'Apple Airpods Pro' => 'airpods-pro',
-                    'Apple EarPods' => 'earpods',
-                    'Apple Headphones' => 'apple-headphones',
-                    'Apple HomePod' => 'apple-homepod',
-                    'Apple HomePod mini' => 'apple-homepod-mini',
-                    'Apple Keyboard' => 'apple-keyboard',
-                    'Apple Pencil' => 'apple-pencil',
-                    'Apple TV' => 'apple-tv',
-                    'Apple TV 4K' => 'apple-tv-4k',
-                    'Apple Watch' => 'apple-watch',
-                    'Apple Watch 3' => 'apple-watch-3',
-                    'Apple Watch 4' => 'apple-watch-4',
-                    'Apple Watch 5' => 'apple-watch-5',
-                    'Apple Watch 6' => 'apple-watch-6',
-                    'Apple Watch SE' => 'apple-watch-se',
-                    'Apron' => 'apron',
-                    'Aquadoodle' => 'aquadoodle',
-                    'Aqua Optima' => 'aqua-optima',
-                    'Aquarium' => 'aquarium',
-                    'Aramis' => 'aramis',
-                    'Argan Oil' => 'argan-oil',
-                    'Ariel' => 'ariel',
-                    'Ark' => 'ark',
-                    'Armani' => 'armani',
-                    'Armchair' => 'armchair',
-                    'Armed Forces Discount' => 'armed-forces',
-                    'Arsenal F. C.' => 'arsenal',
-                    'Arts and Crafts' => 'craft',
-                    'Asics' => 'asics',
-                    'Ask' => 'ask',
-                    'ASRock' => 'asrock',
-                    'Assassin&#039;s Creed' => 'assassins-creed',
-                    'Assassin&#039;s Creed: Odyssey' => 'assassins-creed-odyssey',
-                    'Assassin&#039;s Creed: Origins' => 'assassins-creed-origins',
-                    'Assassin&#039;s Creed: Unity' => 'assassins-creed-unity',
-                    'Assassin&#039;s Creed: Valhalla' => 'assasins-creed-valhalla',
-                    'Astral Chain' => 'astral-chain',
-                    'ASTRO Gaming' => 'astro-gaming',
-                    'Astro Gaming A40' => 'astro-gaming-a40',
-                    'Astro Gaming A50' => 'astro-gaming-a50',
-                    'Asus' => 'asus',
-                    'ASUS Laptop' => 'asus-laptop',
-                    'ASUS Monitor' => 'asus-monitor',
-                    'ASUS ROG' => 'asus-rog',
-                    'Asus ROG Phone' => 'asus-rog-phone',
-                    'Asus ROG Phone 2' => 'asus-rog-phone-2',
-                    'ASUS Router' => 'asus-router',
-                    'Asus Smartphone' => 'asus-smartphone',
-                    'ASUS Vivobook' => 'asus-vivobook',
-                    'ASUS Zenbook' => 'zenbook',
-                    'Asus ZenFone 6' => 'asus-zenfone-6',
-                    'Atari' => 'atari',
-                    'Audi' => 'audi',
-                    'Audio &amp; Hi-Fi' => 'audio',
-                    'Audio Accessories' => 'audio-accessories',
-                    'Audiobook' => 'audiobook',
-                    'Audio Technica' => 'audio-technica',
-                    'Aukey' => 'aukey',
-                    'Aussie' => 'aussie',
-                    'Autoglym' => 'autoglym',
-                    'Aveeno' => 'aveeno',
-                    'Avengers' => 'avengers',
-                    'AVG' => 'avg',
-                    'Aviva' => 'aviva',
-                    'Avon' => 'avon',
-                    'AV Receiver' => 'av-receiver',
-                    'Axe' => 'axe',
-                    'Baby Annabell' => 'baby-annabell',
-                    'Baby Bath' => 'baby-bath',
-                    'Baby Born' => 'baby-born',
-                    'Baby Bottle' => 'baby-bottles',
-                    'Baby Bouncer' => 'bouncer',
-                    'Baby Carrier' => 'baby-carrier',
-                    'Baby Clothes' => 'baby-clothes',
-                    'Baby Food' => 'baby-food',
-                    'Baby Gym' => 'baby-gym',
-                    'Baby Jogger' => 'baby-jogger',
-                    'Babyliss' => 'babyliss',
-                    'Baby Monitor' => 'baby-monitor',
-                    'Baby Shoes' => 'baby-shoes',
-                    'Baby Swing' => 'baby-swing',
-                    'Baby Walker' => 'baby-walker',
-                    'Baby Wipes' => 'wipes',
-                    'Bacardi' => 'bacardi',
-                    'Backpack' => 'backpack',
-                    'Back to the Future' => 'back-to-the-future',
-                    'Bacon' => 'bacon',
-                    'Badminton' => 'badminton',
-                    'Bag' => 'bag',
-                    'Bagless Vacuum Cleaner' => 'bagless-vacuum-cleaner',
-                    'Bahco' => 'bahco',
-                    'Baileys' => 'baileys',
-                    'Baked Beans' => 'baked-beans',
-                    'Bakery Products' => 'bakery-products',
-                    'Baking' => 'baking',
-                    'Ball Pit' => 'ball-pit',
-                    'Ballpoint Pen' => 'pen',
-                    'Band of Brothers' => 'band-of-brothers',
-                    'Bang &amp; Olufsen' => 'bang-olufsen',
-                    'Bank' => 'bank',
-                    'Bank Account' => 'bank-account',
-                    'Banks &amp; Credit Cards' => 'bank-credit-card',
-                    'Barbell' => 'barbell',
-                    'Barbie' => 'barbie',
-                    'Barbour' => 'barbour',
-                    'Barclaycard' => 'barclaycard',
-                    'Barclays' => 'barclays',
-                    'Barebones PC' => 'barebones',
-                    'bareMinerals' => 'bareminerals',
-                    'Barry M' => 'barry-m',
-                    'Bar Stools' => 'bar-stools',
-                    'Base Layer' => 'base-layer',
-                    'Basket' => 'basket',
-                    'Basketball' => 'basketball',
-                    'Basmati Rice' => 'basmati-rice',
-                    'Bath Mat' => 'bath-mat',
-                    'Bathroom Accessories' => 'bathroom',
-                    'Bathroom Cabinet' => 'bathroom-cabinet',
-                    'Bathroom Scale' => 'bathroom-scales',
-                    'Bathroom Tap' => 'tap',
-                    'Batman' => 'batman',
-                    'Battery' => 'battery',
-                    'Battleborn' => 'battleborn',
-                    'Battlefield' => 'battlefield',
-                    'Battlefield 1' => 'battlefield-1',
-                    'Battlefield 4' => 'battlefield-4',
-                    'Battlefield 5' => 'battlefield-5',
-                    'Battlestar Galactica' => 'battlestar-galactica',
-                    'Baylis &amp; Harding' => 'baylis-and-harding',
-                    'Bayonetta' => 'bayonetta',
-                    'Bayonetta 2' => 'bayonetta-2',
-                    'Baywatch' => 'baywatch',
-                    'BB-8' => 'bb-8',
-                    'BBC' => 'bbc',
-                    'BBQ Food' => 'bbq',
-                    'BBQs and Grills' => 'grill',
-                    'Bean Bag' => 'bean-bag',
-                    'Beanie Hat' => 'beanie-hat',
-                    'Bean to Cup Machine' => 'bean-to-cup',
-                    'Beard Trimmer' => 'beard-trimmer',
-                    'Beats by Dre' => 'beats-by-dre',
-                    'Beats Solo 3' => 'beats-solo-3',
-                    'Beats Studio 3' => 'beats-studio-3',
-                    'Beauty' => 'beauty-care',
-                    'Beauty and the Beast' => 'beauty-and-the-beast',
-                    'Becks' => 'becks',
-                    'Bed' => 'bed',
-                    'Bedding' => 'bedding',
-                    'Bedding &amp; Linens' => 'bedding-linens',
-                    'Bed Frame' => 'bed-frame',
-                    'Bedroom' => 'bedroom-furniture',
-                    'Beef' => 'beef',
-                    'Beer' => 'beer',
-                    'Beer Advent Calendar' => 'beer-advent-calendar',
-                    'Beko' => 'beko',
-                    'Belkin' => 'belkin',
-                    'Belstaff' => 'belstaff',
-                    'Belt' => 'belt',
-                    'BelVita' => 'belvita',
-                    'Ben &amp; Jerry&#039;s' => 'ben-jerrys',
-                    'Benefit Cosmetics' => 'benefit-cosmetics',
-                    'BenQ' => 'benq',
-                    'BenQ Monitor' => 'benq-monitor',
-                    'Ben Sherman' => 'ben-sherman',
-                    'BeoPlay Headphones' => 'beoplay-headphones',
-                    'Beoplay Speakers' => 'beoplay',
-                    'Berghaus' => 'berghaus',
-                    'Bestway' => 'bestway',
-                    'Betting' => 'betting',
-                    'Beyerdynamic' => 'beyerdynamic',
-                    'Bic' => 'bic',
-                    'Bike' => 'bike',
-                    'Bike Accessories' => 'bike-accessories',
-                    'Bike Brake' => 'brakes',
-                    'Bike Computer' => 'bike-computer',
-                    'Bike Helmet' => 'bicycle-helmet',
-                    'Bike Inner Tube' => 'inner-tube',
-                    'Bike Lights' => 'bike-lights',
-                    'Bike Lock' => 'bike-lock',
-                    'Bike Parts' => 'bike-parts',
-                    'Bike Pump' => 'bike-pump',
-                    'Biker Equipment' => 'biker-equipment',
-                    'Bike Saddle' => 'saddle',
-                    'Biking &amp; Urban Sports' => 'biking-urban-sports',
-                    'Bikini' => 'bikini',
-                    'Billabong' => 'billabong',
-                    'Bin' => 'bin',
-                    'Binatone' => 'binatone',
-                    'Bingo' => 'bingo',
-                    'Binoculars' => 'binoculars',
-                    'Bio Oil' => 'bio-oil',
-                    'Bioshock' => 'bioshock',
-                    'Birds Eye' => 'birds-eye',
-                    'Birkenstock' => 'birkenstock',
-                    'Biscuits' => 'biscuits',
-                    'Bissell' => 'bissell',
-                    'Bistro Set' => 'bistro-set',
-                    'Bitdefender' => 'bitdefender',
-                    'Black &amp; Decker' => 'black-decker',
-                    'Blackberry Smartphone' => 'blackberry',
-                    'Blanket' => 'blanket',
-                    'Blaupunkt' => 'blaupunkt',
-                    'Blazer' => 'blazer',
-                    'Bleach' => 'bleach',
-                    'Blended Malt' => 'malt',
-                    'Blender' => 'blender',
-                    'Blinds' => 'blinds',
-                    'Blink XT2 Smart Security Camera' => 'blink-xt2',
-                    'Blizzard' => 'blizzard',
-                    'Blood &amp; Truth' => 'blood-and-truth',
-                    'Bloodborne' => 'bloodborne',
-                    'Blood Pressure Monitor' => 'blood-pressure',
-                    'Blu-ray' => 'blu-ray',
-                    'Blu-ray Player' => 'blu-ray-player',
-                    'Bluetooth Headphones' => 'bluetooth-headphones',
-                    'Bluetooth Speaker' => 'bluetooth-speaker',
-                    'BMW' => 'bmw',
-                    'BMW Mini Cooper' => 'mini-cooper',
-                    'BMX' => 'bmx',
-                    'Board Game' => 'board-game',
-                    'Boardman' => 'boardman',
-                    'Boat Shoes' => 'boat-shoes',
-                    'Bodum' => 'bodum',
-                    'Bogof' => 'bogof',
-                    'Boiler' => 'boiler',
-                    'Bold' => 'bold',
-                    'Bombay Sapphire' => 'bombay-sapphire',
-                    'Bomber Jacket' => 'bomber-jacket',
-                    'Bonne Maman' => 'bonne-maman',
-                    'Bonsai' => 'bonsai',
-                    'Book' => 'book',
-                    'Bookcase' => 'bookcase',
-                    'Books &amp; Magazines' => 'books-magazines',
-                    'Booster Seat' => 'booster-seat',
-                    'Boots' => 'boots',
-                    'Borderlands' => 'borderlands',
-                    'Borderlands 3' => 'borderlands-3',
-                    'Bosch' => 'bosch',
-                    'Bosch Dishwasher' => 'bosch-dishwasher',
-                    'Bosch Drill' => 'bosch-drill',
-                    'Bosch Fridge' => 'bosch-fridge',
-                    'Bosch Rotak' => 'rotak',
-                    'Bosch Washing Machine' => 'bosch-washing-machine',
-                    'Bose' => 'bose',
-                    'Bose Headphones' => 'bose-headphones',
-                    'Bose Noise Cancelling Headphones 700' => 'bose-headphones-700',
-                    'Bose QuietComfort' => 'bose-quietcomfort',
-                    'Bose QuietComfort 35 II' => 'bose-quietcomfort-35-ii',
-                    'Bose SoundLink' => 'bose-soundlink',
-                    'Bose SoundLink Around-Ear II' => 'bose-soundlink-2',
-                    'Bose SoundTouch' => 'bose-soundtouch',
-                    'BOSS' => 'hugo-boss',
-                    'Boss Bottled' => 'boss-bottled',
-                    'Bouncy Castle' => 'bouncy-castle',
-                    'Bourbon' => 'bourbon',
-                    'Bourjois' => 'bourjois',
-                    'Bowers &amp; Wilkins' => 'bowers-wilkins',
-                    'Bowling' => 'bowling',
-                    'Bowmore' => 'bowmore',
-                    'Boxers' => 'boxers',
-                    'Boxing' => 'boxing',
-                    'Boxing Gloves' => 'boxing-gloves',
-                    'Boy&#039;s Clothes' => 'clothes-for-boys',
-                    'Bra' => 'bra',
-                    'Brabantia' => 'brabantia',
-                    'Bracelet' => 'bracelet',
-                    'Brands' => 'brand',
-                    'Brandy' => 'brandy',
-                    'Branston' => 'branston',
-                    'Branston Beans' => 'branston-beans',
-                    'Braun' => 'braun',
-                    'Braun Series 3' => 'braun-series-3',
-                    'Braun Series 5' => 'braun-series-5',
-                    'Braun Series 7' => 'braun-series-7',
-                    'Braun Series 9' => 'braun-series-9',
-                    'Braun Shaver' => 'braun-shaver',
-                    'Bread' => 'bread',
-                    'Breadmaker' => 'breadmaker',
-                    'Breakdown Cover' => 'breakdown',
-                    'Breaking Bad' => 'breaking-bad',
-                    'Breast Pump' => 'breast-pump',
-                    'Breville' => 'breville',
-                    'Breville Blend Active' => 'blendactive',
-                    'Brewdog' => 'brewdog',
-                    'Bridge Camera' => 'bridge-camera',
-                    'Briefcase' => 'briefcase',
-                    'Brita' => 'brita',
-                    'Britax' => 'britax',
-                    'British Airways' => 'british-airways',
-                    'Broadband' => 'broadband',
-                    'Broadband &amp; Phone Contracts' => 'broadband-phone-service',
-                    'Brogues' => 'brogues',
-                    'Brother' => 'brother',
-                    'Brother Printer' => 'brother-printer',
-                    'Brownie' => 'brownie',
-                    'BT' => 'bt',
-                    'BT Sport' => 'bt-sport',
-                    'Budweiser' => 'budweiser',
-                    'Buffalo' => 'buffalo',
-                    'Bugaboo' => 'bugaboo',
-                    'Buggy' => 'buggy',
-                    'Build-A-Bear' => 'build-a-bear',
-                    'Bulb' => 'bulbs',
-                    'Bulletstorm' => 'bulletstorm',
-                    'Bulmers' => 'bulmers',
-                    'Bulova' => 'bulova',
-                    'Burberry' => 'burberry',
-                    'Burger' => 'burger',
-                    'Burnout Paradise' => 'burnout-paradise',
-                    'Burt&#039;s Bees' => 'burts-bees',
-                    'Bus and Coach Ticket' => 'bus',
-                    'Bush' => 'bush',
-                    'Bushmills' => 'bushmills',
-                    'Butter' => 'butter',
-                    'Buying From Abroad' => 'buying-from-abroad',
-                    'Bvlgari' => 'bvlgari',
-                    'Cabin Case' => 'cabin-case',
-                    'Cabinet' => 'cabinet',
-                    'Cable Reel' => 'cable-reel',
-                    'Cables' => 'cables',
-                    'Cadbury&#039;s' => 'cadbury',
-                    'Café Rouge' => 'cafe-rouge',
-                    'Cafetière' => 'cafetiere',
-                    'Caffè Nero' => 'cafe-nero',
-                    'Cake' => 'cake',
-                    'Calculator' => 'calculator',
-                    'Calendar' => 'calendar',
-                    'Call of Duty' => 'call-of-duty',
-                    'Call of Duty: Black Ops' => 'black-ops',
-                    'Call of Duty: Black Ops 3' => 'black-ops-3',
-                    'Call of Duty: Black Ops 4' => 'black-ops-4',
-                    'Call of Duty: Black Ops Cold War' => 'call-of-duty-black-ops-cold-war',
-                    'Call of Duty: Infinite Warfare' => 'call-of-duty-infinite-warfare',
-                    'Call of Duty: Modern Warfare' => 'modern-warfare',
-                    'Call of Duty: WW2' => 'call-of-duty-ww2',
-                    'Calpol' => 'calpol',
-                    'Calvin Klein' => 'calvin-klein',
-                    'Camcorder' => 'camcorder',
-                    'Camelbak' => 'camelbak',
-                    'Camera' => 'camera',
-                    'Camera Accessories' => 'camera-accessories',
-                    'Camera Bag' => 'camera-bag',
-                    'Camera Lens' => 'lens',
-                    'Camping' => 'camping',
-                    'Campingaz' => 'campingaz',
-                    'Candle' => 'candle',
-                    'Cannondale' => 'cannondale',
-                    'Canon' => 'canon',
-                    'Canon Camera' => 'canon-camera',
-                    'Canon EOS' => 'canon-eos',
-                    'Canon Lens' => 'canon-lens',
-                    'Canon Pixma' => 'canon-pixma',
-                    'Canon PowerShot' => 'canon-powershot',
-                    'Canon PowerShot SX430 IS' => 'canon-powershot-sx430-is',
-                    'Canon Printer' => 'canon-printer',
-                    'Canterbury' => 'canterbury',
-                    'Canton' => 'canton',
-                    'Canvas Print' => 'canvas-print',
-                    'Cap' => 'cap',
-                    'Capsule Machine' => 'capsule-machine',
-                    'Captain America' => 'captain-america',
-                    'Captain Morgan' => 'captain-morgan',
-                    'Captain Toad: Treasure Tracker' => 'captain-toad-treasure-tracker',
-                    'Car' => 'car',
-                    'Car &amp; Motorcycle' => 'car-motorcycle',
-                    'Car Accessories' => 'car-accessories',
-                    'Caravan' => 'caravan',
-                    'Car Battery' => 'car-battery',
-                    'Carbon Monoxide Detector' => 'carbon-monoxide',
-                    'Car Care' => 'car-care',
-                    'Car Charger' => 'car-charger',
-                    'Cardhu' => 'cardhu',
-                    'Cardigan' => 'cardigan',
-                    'Card Reader' => 'card-reader',
-                    'Carex' => 'carex',
-                    'Carhartt' => 'carhartt',
-                    'Car Hire' => 'car-hire',
-                    'Car Insurance' => 'car-insurance',
-                    'Car Leasing' => 'car-lease',
-                    'Carling' => 'carling',
-                    'Car Lock' => 'lock',
-                    'Carlsberg' => 'carlsberg',
-                    'Car Mats' => 'car-mats',
-                    'Carolina Herrera' => 'carolina-herrera',
-                    'Car Parts' => 'car-parts',
-                    'Carpet' => 'carpet',
-                    'Carpet Cleaner' => 'carpet-cleaner',
-                    'CarPlan' => 'carplan',
-                    'Car Polish' => 'car-polish',
-                    'Carrera Bikes' => 'carrera',
-                    'Car Seat' => 'car-seat',
-                    'Car Service' => 'car-service',
-                    'Car Stereo' => 'car-stereo',
-                    'Car Wash' => 'car-wash',
-                    'Car Wax' => 'car-wax',
-                    'Casio' => 'casio',
-                    'Casio Eco-Drive' => 'eco-drive',
-                    'Casio Edifice' => 'edifice',
-                    'Casio G-Shock' => 'g-shock',
-                    'Casserole' => 'casserole',
-                    'Cast Iron Pots and Pans' => 'cast-iron',
-                    'Castrol' => 'castrol',
-                    'Caterpillar' => 'caterpillar',
-                    'Cat Flap' => 'cat-flap',
-                    'Cat Food' => 'cat-food',
-                    'Cath Kidston' => 'cath-kidston',
-                    'Cat Supplies' => 'cat-supplies',
-                    'CCTV' => 'cctv',
-                    'CD' => 'cd',
-                    'CD Player' => 'cd-player',
-                    'Ceiling Light' => 'ceiling-light',
-                    'Celebrations' => 'celebrations',
-                    'Cereal' => 'cereal',
-                    'Cetirizine' => 'cetirizine',
-                    'Chad Valley' => 'chad-valley',
-                    'Chainsaw' => 'chainsaw',
-                    'Champagne' => 'champagne',
-                    'Champneys' => 'champneys',
-                    'Chanel' => 'chanel',
-                    'Chanel Coco Mademoiselle' => 'coco-mademoiselle',
-                    'Changing Bag' => 'changing-bag',
-                    'Channel 4' => 'channel-4',
-                    'Charger' => 'charger',
-                    'Cheese' => 'cheese',
-                    'Chelsea Boots' => 'chelsea-boots',
-                    'Chelsea F. C.' => 'chelsea',
-                    'Chess' => 'chess',
-                    'Chessington' => 'chessington',
-                    'Chest Freezer' => 'chest-freezer',
-                    'Chest of Drawers' => 'chest-of-drawers',
-                    'Chicco' => 'chicco',
-                    'Chicken' => 'chicken',
-                    'Childcare' => 'baby',
-                    'Children&#039;s Books' => 'childrens-books',
-                    'Chino' => 'chino',
-                    'Chisel' => 'chisel',
-                    'Chloe' => 'chloe',
-                    'Chocolate' => 'chocolate',
-                    'Chocolate Advent Calendar' => 'chocolate-advent-calendar',
-                    'Chopper' => 'chopper',
-                    'Chopping Board' => 'chopping-board',
-                    'Christmas Card' => 'christmas-card',
-                    'Christmas Decoration' => 'christmas-decorations',
-                    'Christmas Gift' => 'christmas-gifts',
-                    'Christmas Jumper' => 'christmas-jumper',
-                    'Christmas Lights' => 'christmas-lights',
-                    'Christmas Stocking Fillers' => 'christmas-stocking-fillers',
-                    'Christmas Toys' => 'christmas-toys',
-                    'Christmas Tree' => 'christmas-tree',
-                    'Chromebook' => 'chromebook',
-                    'Chromecast' => 'chromecast',
-                    'Chromecast Ultra' => 'chromecast-ultra',
-                    'Chromecast with Google TV' => 'chromecast-google-tv',
-                    'Chronograph' => 'chronograph',
-                    'Chupa Chups' => 'chupa-chups',
-                    'Chuwi' => 'chuwi',
-                    'Cider' => 'cider',
-                    'Cinema' => 'cinema',
-                    'Cineworld' => 'cineworld',
-                    'Circular Saw' => 'circular-saw',
-                    'Circulon' => 'circulon',
-                    'Ciroc' => 'ciroc',
-                    'Cities Skylines' => 'cities-skylines',
-                    'Citizen' => 'citizen',
-                    'Citroen' => 'citroen',
-                    'City Break' => 'city-breaks',
-                    'Civilization' => 'civilization',
-                    'Clarins' => 'clarins',
-                    'Clarks' => 'clarks',
-                    'Clearance' => 'clearance',
-                    'Climbing' => 'climbing',
-                    'Climbing Frame' => 'climbing-frame',
-                    'Clinique' => 'clinique',
-                    'Clothes' => 'clothes',
-                    'Cloud Service' => 'cloud',
-                    'Clutch Bag' => 'clutch',
-                    'Coat' => 'coat',
-                    'Coca Cola' => 'coke',
-                    'Cocktail' => 'cocktail',
-                    'Coconut Oil' => 'coconut',
-                    'Coffee' => 'coffee',
-                    'Coffee Beans' => 'coffee-beans',
-                    'Coffee Machine' => 'coffee-machine',
-                    'Coffee Pods' => 'coffee-pods',
-                    'Coffee Table' => 'coffee-table',
-                    'Cognac' => 'cognac',
-                    'Cola' => 'cola',
-                    'Coleman' => 'coleman',
-                    'Colgate' => 'colgate',
-                    'Combi Drill' => 'combi',
-                    'Comfort' => 'comfort',
-                    'Comic' => 'comic',
-                    'Command &amp; Conquer' => 'command-and-conquer',
-                    'Compact Camera' => 'compact-camera',
-                    'Compact Flash' => 'compact-flash',
-                    'Competitions' => 'competitions',
-                    'Compost' => 'compost',
-                    'Compressor' => 'compressor',
-                    'Computer Accessories' => 'computer-accessories',
-                    'Computers &amp; Tablets' => 'computers',
-                    'Concert' => 'concert',
-                    'Condé Nast' => 'conde-nast',
-                    'Conditioner' => 'conditioner',
-                    'Condom' => 'condom',
-                    'Connectors' => 'connectors',
-                    'Contact Lenses' => 'contact-lenses',
-                    'Contents Insurance' => 'contents-insurance',
-                    'Controller' => 'controller',
-                    'Converse' => 'converse',
-                    'Converse Chuck Taylor' => 'chuck-taylor',
-                    'Cooker' => 'cooker',
-                    'Cooking Oil' => 'cooking-oil',
-                    'Cookware' => 'cooking',
-                    'Cookware Set' => 'cookware-set',
-                    'Cookworks' => 'cookworks',
-                    'Cool Box' => 'cool-box',
-                    'Coors Light' => 'coors-light',
-                    'Cordless Drill' => 'cordless-drill',
-                    'Cordless Phone' => 'cordless-phone',
-                    'Cornetto' => 'cornetto',
-                    'Corona Beer' => 'corona',
-                    'Corsair' => 'corsair',
-                    'Cosatto' => 'cosatto',
-                    'Costa Coffee' => 'costa-coffee',
-                    'Costume' => 'costume',
-                    'Cot' => 'cot',
-                    'Counter Strike' => 'counter-strike',
-                    'Courses and Training' => 'education',
-                    'Cow &amp; Gate' => 'cow-and-gate',
-                    'Cozy Coupe' => 'cozy-coupe',
-                    'CPU' => 'cpu',
-                    'CPU Cooler' => 'cpu-cooler',
-                    'Craghoppers' => 'craghoppers',
-                    'Crash Bandicoot' => 'crash-bandicoot',
-                    'Crash Team Racing Nitro-Fueled' => 'crash-team-racing-nitro-fueled',
-                    'Crayola' => 'crayola',
-                    'Creatine' => 'creatine',
-                    'Credit Card' => 'credit-card',
-                    'Creme Egg' => 'creme-egg',
-                    'Cricket' => 'cricket',
-                    'Crisps' => 'crisps',
-                    'Crocs' => 'crocs',
-                    'Cross Trainer' => 'cross-trainer',
-                    'Crown Paint' => 'crown',
-                    'Crucial' => 'crucial',
-                    'Cruelty Free Makeup' => 'cruelty-free-makeup',
-                    'Cruises' => 'cruise',
-                    'Cube Bikes' => 'cube',
-                    'Cubot' => 'cubot',
-                    'Cufflinks' => 'cufflinks',
-                    'Culture &amp; Leisure' => 'entertainment',
-                    'Cuphead' => 'cuphead',
-                    'Cuprinol' => 'cuprinol',
-                    'Curling Wand' => 'curling-wand',
-                    'Curtain' => 'curtain',
-                    'Cushelle' => 'cushelle',
-                    'Cushion' => 'cushion',
-                    'Cutlery' => 'cutlery',
-                    'CyberLink' => 'cyberlink',
-                    'Cyberpunk 2077' => 'cyberpunk-2077',
-                    'Cybex' => 'cybex',
-                    'Cycling' => 'cycling',
-                    'Cycling Jacket' => 'cycling-jacket',
-                    'D-Link' => 'd-link',
-                    'DAB Radio' => 'dab-radio',
-                    'Dacia' => 'dacia',
-                    'Daily Mail' => 'daily-mail',
-                    'Dairy Milk' => 'dairy-milk',
-                    'Darksiders' => 'darksiders',
-                    'Dark Souls' => 'dark-souls',
-                    'Dark Souls 3' => 'dark-souls-3',
-                    'Dartboard' => 'dartboard',
-                    'Darts' => 'darts',
-                    'Dash Cam' => 'dash-cam',
-                    'Data Storage' => 'storage',
-                    'Davidoff' => 'davidoff',
-                    'Days Gone' => 'days-gone',
-                    'Days Out' => 'days-out',
-                    'Daz' => 'daz',
-                    'DC Comic' => 'dc',
-                    'DDR3' => 'ddr3',
-                    'DDR4' => 'ddr4',
-                    'Dead Island' => 'dead-island',
-                    'Dead or Alive 6' => 'dead-or-alive-6',
-                    'Deadpool' => 'deadpool',
-                    'Dead Rising' => 'dead-rising',
-                    'Death Stranding' => 'death-stranding',
-                    'Deezer' => 'deezer',
-                    'Dehumidifier' => 'dehumidifier',
-                    'Dell' => 'dell',
-                    'Dell Laptop' => 'dell-laptop',
-                    'Dell Monitor' => 'dell-monitor',
-                    'Dell XPS' => 'xps',
-                    'Delonghi' => 'delonghi',
-                    'Demon&#039;s Souls' => 'demon-souls',
-                    'Denby' => 'denby',
-                    'Denon' => 'denon',
-                    'Deodorant' => 'deodorant',
-                    'Desk' => 'desk',
-                    'Desperados Beer' => 'desperados',
-                    'Despicable Me' => 'despicable-me',
-                    'Destiny' => 'destiny',
-                    'Destiny 2' => 'destiny-2',
-                    'Detergent' => 'detergent',
-                    'Detroit: Become Human' => 'detroit-become-human',
-                    'Dettol' => 'dettol',
-                    'Deus Ex' => 'deus-ex',
-                    'Deus Ex: Mankind Divided' => 'deus-ex-mankind-divided',
-                    'Development Boards' => 'development-boards',
-                    'Devil May Cry 5' => 'devil-may-cry-5',
-                    'DeWalt' => 'dewalt',
-                    'DFDS' => 'dfds',
-                    'Diablo 3' => 'diablo-3',
-                    'Diary' => 'diary',
-                    'Dickies' => 'dickies',
-                    'Diesel' => 'diesel',
-                    'Diet' => 'diet',
-                    'Diggerland' => 'diggerland',
-                    'Digihome' => 'digihome',
-                    'Digimon' => 'digimon',
-                    'Digital Camera' => 'digital-camera',
-                    'Digital Watch' => 'digital-watch',
-                    'Dildo' => 'dildo',
-                    'Dimplex' => 'dimplex',
-                    'Dining Room' => 'dining-room',
-                    'Dining Room Chair' => 'chair',
-                    'Dining Set' => 'dining-set',
-                    'Dining Table' => 'dining-table',
-                    'Dinner Plate' => 'plates',
-                    'Dinner Set' => 'dinner-set',
-                    'Dinosaur' => 'dinosaur',
-                    'Dior' => 'dior',
-                    'Dior Sauvage' => 'dior-sauvage',
-                    'Dirt' => 'dirt',
-                    'Dirt 4' => 'dirt-4',
-                    'DIRT 5' => 'dirt-5',
-                    'Dirt Rally 2.0' => 'dirt-rally-2',
-                    'Disaronno' => 'disaronno',
-                    'Discord Nitro' => 'discord-nitro',
-                    'Disgaea' => 'disgaea',
-                    'Dishonored' => 'dishonored',
-                    'Dishonored 2' => 'dishonored-2',
-                    'Dishwasher' => 'dishwasher',
-                    'Dishwasher Tablets' => 'dishwasher-tablets',
-                    'Disinfectants' => 'disinfectants',
-                    'Disney' => 'disney',
-                    'Disney&#039;s Cars' => 'disney-cars',
-                    'Disney&#039;s Frozen' => 'disney-frozen',
-                    'Disney+' => 'disney-plus',
-                    'Disney Infinity' => 'disney-infinity',
-                    'Disneyland' => 'disneyland',
-                    'Disney Princess' => 'disney-princess',
-                    'Disney Tsum Tsum' => 'tsum-tsum',
-                    'Disney World' => 'disney-world',
-                    'Divan' => 'divan',
-                    'DIY' => 'diy',
-                    'DJ Equipment' => 'dj',
-                    'DJI Phantom' => 'dji-phantom',
-                    'DKNY' => 'dkny',
-                    'Doctor Who' => 'doctor-who',
-                    'Dog Bed' => 'dog-bed',
-                    'Dog Food' => 'dog-food',
-                    'Dog Supplies' => 'dog',
-                    'Dolce &amp; Gabbana' => 'dolce',
-                    'Dolce Gusto' => 'dolce-gusto',
-                    'Dolce Gusto Coffee Machine' => 'dolce-gusto-coffee-machine',
-                    'Doll' => 'doll',
-                    'Dolls House' => 'dolls-house',
-                    'Domain Service' => 'domain',
-                    'Doogee' => 'doogee',
-                    'Doom' => 'doom',
-                    'Door' => 'door',
-                    'Doorbell' => 'doorbell',
-                    'Door Handles' => 'door-handles',
-                    'Doormat' => 'doormat',
-                    'Doritos' => 'doritos',
-                    'Dove' => 'dove',
-                    'Down Jacket' => 'down-jacket',
-                    'Downton Abbey' => 'downton-abbey',
-                    'Dr. Martens' => 'dr-martens',
-                    'Dragon Age' => 'dragon-age',
-                    'Dragon Ball' => 'dragon-ball',
-                    'Dragon Ball: FighterZ' => 'dragon-ball-fighterz',
-                    'Dragon Quest' => 'dragon-quest',
-                    'Dragon Quest Builders' => 'dragon-quest-builders',
-                    'Dragon Quest Builders 2' => 'dragon-quest-builders-2',
-                    'Dragon Quest XI: Echoes of an Elusive Age' => 'dragon-quest-xi',
-                    'Draper' => 'draper',
-                    'Drayton Manor' => 'drayton-manor',
-                    'Dreame T20' => 'dreame-t20',
-                    'Dreame V9' => 'dreame-v9',
-                    'Dreame V9P' => 'dreame-v9p',
-                    'Dreame V10' => 'dreame-v10',
-                    'Dreame V11' => 'dreame-v11',
-                    'Dreame Vacuum Cleaner' => 'xiaomi-vacuum-cleaner',
-                    'Dremel' => 'dremel',
-                    'Dress' => 'dress',
-                    'Dressing Gown' => 'dressing-gown',
-                    'Drill' => 'drill',
-                    'Drill Driver' => 'driver',
-                    'Drinks' => 'drinks',
-                    'Driveclub' => 'driveclub',
-                    'Driving Lessons' => 'driving-lessons',
-                    'Drone' => 'drone',
-                    'Dryer' => 'dryer',
-                    'DSLR Camera' => 'dslr',
-                    'Dual Fuel Cooker' => 'dual-fuel',
-                    'Dualit' => 'dualit',
-                    'Dual Sim' => 'sim',
-                    'Dulux' => 'dulux',
-                    'Duracell' => 'duracell',
-                    'Durex' => 'durex',
-                    'Duvet' => 'duvet',
-                    'DVD' => 'dvd',
-                    'DVD Player' => 'dvd-player',
-                    'Dying Light' => 'dying-light',
-                    'Dymo' => 'dymo',
-                    'Dyson' => 'dyson',
-                    'Dyson Supersonic' => 'dyson-supersonic',
-                    'Dyson V6' => 'dyson-v6',
-                    'Dyson V7' => 'dyson-v7',
-                    'Dyson V8' => 'dyson-v8',
-                    'Dyson V10' => 'dyson-v10',
-                    'Dyson V11' => 'dyson-v11',
-                    'Dyson Vacuum Cleaner' => 'dyson-vacuum-cleaner',
-                    'e-Reader' => 'ereader',
-                    'EA' => 'ea',
-                    'EA Access' => 'ea-access',
-                    'Earphones' => 'earphones',
-                    'Earrings' => 'earrings',
-                    'EA Sports' => 'ea-sports',
-                    'EA Sports UFC' => 'ufc',
-                    'Easter Eggs' => 'egg',
-                    'Eastpak' => 'eastpak',
-                    'eBook' => 'ebook',
-                    'Ecovacs' => 'ecovacs',
-                    'Ecover' => 'ecover',
-                    'Educational Toys' => 'educational-toys',
-                    'EE' => 'ee',
-                    'eFootball PES 2021' => 'pes-2021',
-                    'ELC Happyland' => 'happyland',
-                    'Electrical Accessories' => 'electrical-accessories',
-                    'Electric Bike' => 'electric-bike',
-                    'Electric Blanket' => 'electric-blanket',
-                    'Electric Cooker' => 'electric-cooker',
-                    'Electric Fires' => 'electric-fire',
-                    'Electric Scooter' => 'electric-scooter',
-                    'Electric Shower' => 'electric-shower',
-                    'Electric Toothbrush' => 'electric-toothbrush',
-                    'Electronic Accessories' => 'electronics-accessories',
-                    'Electronics' => 'electronics',
-                    'Elemis' => 'elemis',
-                    'Elephone' => 'elephone',
-                    'Elgato' => 'elgato',
-                    'Elite Dangerous' => 'elite-dangerous',
-                    'Elizabeth Arden' => 'elizabeth-arden',
-                    'Emirates' => 'emirates',
-                    'Endura' => 'endura',
-                    'Eneloop' => 'eneloop',
-                    'Energizer' => 'energizer',
-                    'Energy' => 'energy',
-                    'Energy, Heating &amp; Gas' => 'energy-heating-gas',
-                    'Energy Drinks' => 'energy-drinks',
-                    'Engine Oil' => 'engine-oil',
-                    'Epilator' => 'epilator',
-                    'Epson' => 'epson',
-                    'Epson Printer' => 'epson-printer',
-                    'Espresso' => 'espresso',
-                    'Espresso Machine' => 'espresso-machine',
-                    'Esprit' => 'esprit',
-                    'Estée Lauder' => 'estee-lauder',
-                    'Ethernet' => 'ethernet',
-                    'Etnies' => 'etnies',
-                    'Eurostar Ticket' => 'eurostar',
-                    'Eurotunnel' => 'eurotunnel',
-                    'Everton F. C.' => 'everton',
-                    'EVGA' => 'evga',
-                    'Evian' => 'evian',
-                    'Exercise Equipment' => 'exercise-equipment',
-                    'Exercise Weights' => 'weight',
-                    'Extension Lead' => 'extension-lead',
-                    'External Hard Drive' => 'external-hard-drive',
-                    'F1' => 'formula-one',
-                    'F1 2017' => 'f1-2017',
-                    'F1 2018' => 'f1-2018',
-                    'F1 2019' => 'f1-2019',
-                    'F1 2020' => 'f1-2020',
-                    'Fabric Conditioner' => 'fabric-conditioner',
-                    'Face Cream' => 'face-cream',
-                    'Face Mask' => 'face-mask',
-                    'Fairy' => 'fairy',
-                    'Fairy Light' => 'fairy-light',
-                    'Fallout' => 'fallout',
-                    'Fallout 4' => 'fallout-4',
-                    'Fallout 76' => 'fallout-76',
-                    'Family &amp; Kids' => 'kids',
-                    'Family Break' => 'family-break',
-                    'Family Guy' => 'family-guy',
-                    'Famous Grouse' => 'famous-grouse',
-                    'Fancy Dress' => 'fancy-dress',
-                    'Fans' => 'fan',
-                    'Fanta' => 'fanta',
-                    'Far Cry' => 'far-cry',
-                    'Far Cry 4' => 'far-cry-4',
-                    'Far Cry 5' => 'far-cry-5',
-                    'Far Cry New Dawn' => 'far-cry-new-dawn',
-                    'Far Cry Primal' => 'far-cry-primal',
-                    'Farming Simulator' => 'farming-simulator',
-                    'Fashion &amp; Accessories' => 'fashion',
-                    'Fashion Accessories' => 'fashion-accessories',
-                    'Fashion for Men' => 'mens-clothing',
-                    'Fashion for Women' => 'womens-clothes',
-                    'Fast and Furious' => 'fast-and-furious',
-                    'Father&#039;s Day' => 'fathers-day',
-                    'FatMax' => 'fatmax',
-                    'FC Barcelona' => 'fc-barcelona',
-                    'Felix' => 'felix',
-                    'Fence' => 'fence',
-                    'Fender Guitar' => 'fender',
-                    'Ferrero Rocher' => 'ferrero-rocher',
-                    'Ferry' => 'ferry',
-                    'Festival' => 'festival',
-                    'Fever Thermometer' => 'thermometer',
-                    'Fiat' => 'fiat',
-                    'Fidget Spinner' => 'spinner',
-                    'FIFA' => 'fifa',
-                    'FIFA 17' => 'fifa-17',
-                    'FIFA 18' => 'fifa-18',
-                    'FIFA 19' => 'fifa-19',
-                    'FIFA 20' => 'fifa-20',
-                    'FIFA 21' => 'fifa-21',
-                    'FightStick' => 'fightstick',
-                    'Figures' => 'figures',
-                    'Fila Trainers' => 'fila-trainers',
-                    'Filing Cabinet' => 'filing-cabinet',
-                    'Final Fantasy' => 'final-fantasy',
-                    'Final Fantasy 15' => 'final-fantasy-15',
-                    'Finance &amp; Insurance' => 'personal-finance',
-                    'Finish' => 'finish',
-                    'Finlux' => 'finlux',
-                    'Fiorelli' => 'fiorelli',
-                    'Fire Emblem' => 'fire-emblem',
-                    'Fire Pit' => 'fire-pit',
-                    'Fireplace' => 'fireplace',
-                    'Firewall: Zero Hour' => 'firewall-zero-hour',
-                    'First Aid' => 'first-aid',
-                    'Fish &amp; Seafood' => 'fish-and-seafood',
-                    'Fish and Aquatic Pet Supplies' => 'fish',
-                    'Fisher Price' => 'fisher-price',
-                    'Fisher Price Imaginext' => 'imaginext',
-                    'Fisher Price Jumperoo' => 'jumperoo',
-                    'Fisher Price Little People' => 'little-people',
-                    'Fishing' => 'fishing',
-                    'Fiskars' => 'fiskars',
-                    'Fitbit' => 'fitbit',
-                    'Fitbit Alta' => 'fitbit-alta',
-                    'Fitbit Blaze' => 'fitbit-blaze',
-                    'Fitbit Charge 2' => 'fitbit-charge-2',
-                    'Fitbit Inspire' => 'fitbit-inspire',
-                    'Fitbit Versa' => 'fitbit-versa',
-                    'Fitness &amp; Running' => 'fitness',
-                    'Fitness App' => 'fitness-app',
-                    'Fitness Tracker' => 'fitness-tracker',
-                    'Flamingo Land' => 'flamingo-land',
-                    'Flea Treatment' => 'flea',
-                    'Fleece Clothing' => 'fleece',
-                    'Flights' => 'flight',
-                    'Flip Flops' => 'flip-flops',
-                    'Floodlight' => 'floodlight',
-                    'Flooring' => 'flooring',
-                    'Flowers' => 'flowers',
-                    'Flymo' => 'flymo',
-                    'FM Transmitter' => 'fm-transmitter',
-                    'Food' => 'food',
-                    'Food Containers' => 'food-containers',
-                    'Food Processor' => 'food-processor',
-                    'Food Server' => 'food-server',
-                    'Football' => 'football',
-                    'Football Boots' => 'football-boots',
-                    'Football Manager' => 'football-manager',
-                    'Football Matches' => 'football-matches',
-                    'Football Shirt' => 'football-shirt',
-                    'Foot Pump' => 'foot-pump',
-                    'Ford' => 'ford',
-                    'For Honor' => 'for-honor',
-                    'Fortnite' => 'fortnite',
-                    'Fortnite: Darkfire' => 'fortnite-darkfire',
-                    'Forza' => 'forza',
-                    'Forza 7' => 'forza-7',
-                    'Forza Horizon' => 'forza-horizon',
-                    'Forza Horizon 3' => 'forza-horizon-3',
-                    'Forza Horizon 4' => 'forza-horizon-4',
-                    'Forza Motorsport' => 'forza-motorsport',
-                    'Foscam' => 'foscam',
-                    'Fossil' => 'fossil',
-                    'Foster&#039;s' => 'fosters',
-                    'Foundation' => 'foundation',
-                    'Fountain Pen' => 'fountain-pen',
-                    'Fred Perry' => 'fred-perry',
-                    'Freesat' => 'freesat',
-                    'Freeview' => 'freeview',
-                    'Freezer' => 'freezer',
-                    'Fridge' => 'fridge',
-                    'Fridge Freezer' => 'fridge-freezer',
-                    'Frontline' => 'frontline',
-                    'Frozen Food' => 'frozen',
-                    'Fruit' => 'fruit',
-                    'Fruit and Vegetables' => 'fruit-and-vegetable',
-                    'Fruit of the Loom' => 'fruit-of-the-loom',
-                    'Fryer' => 'fryer',
-                    'Frying Pan' => 'frying-pan',
-                    'Fujifilm' => 'fuji',
-                    'Fujitsu' => 'fujitsu',
-                    'Funko Pop' => 'funko-pop',
-                    'Furby' => 'furby',
-                    'Furniture' => 'furniture',
-                    'G-Star' => 'g-star',
-                    'G-Sync Monitor' => 'g-sync',
-                    'Gaggia' => 'gaggia',
-                    'Gambling' => 'gambling',
-                    'Game App' => 'game-app',
-                    'Game of Thrones' => 'game-of-thrones',
-                    'Games &amp; Board Games' => 'board-games',
-                    'Games Consoles' => 'console',
-                    'Gaming' => 'gaming',
-                    'Gaming Accessories' => 'gaming-accessories',
-                    'Gaming Chair' => 'gaming-chair',
-                    'Gaming Headset' => 'gaming-headset',
-                    'Gaming Keyboard' => 'gaming-keyboard',
-                    'Gaming Laptop' => 'gaming-laptop',
-                    'Gaming Monitor' => 'gaming-monitor',
-                    'Gaming Mouse' => 'gaming-mouse',
-                    'Gaming PC' => 'gaming-pc',
-                    'Gant' => 'gant',
-                    'Garage' => 'garage',
-                    'Garage &amp; Service' => 'garage-service',
-                    'Garden' => 'garden',
-                    'Garden &amp; Do It Yourself' => 'garden-diy',
-                    'Garden Furniture' => 'garden-furniture',
-                    'Gardening' => 'gardening',
-                    'Garden Storage' => 'garden-storage',
-                    'Garden Table' => 'table',
-                    'Garmin' => 'garmin',
-                    'Garmin Fenix' => 'garmin-fenix',
-                    'Garmin Fenix 6' => 'garmin-fenix-6',
-                    'Garmin Fenix 6 Pro' => 'garmin-fenix-6-pro',
-                    'Garmin Forerunner' => 'garmin-forerunner',
-                    'Garmin Vivoactive' => 'garmin-vivoactive',
-                    'Garmin Watch' => 'garmin-watch',
-                    'Garnier' => 'garnier',
-                    'Gas' => 'gas',
-                    'Gas Canister' => 'butane',
-                    'Gas Cooker' => 'gas-cooker',
-                    'Gatwick' => 'gatwick',
-                    'Gazebo' => 'gazebo',
-                    'GBK' => 'gbk',
-                    'Gears 5' => 'gears-5',
-                    'Gears of War' => 'gears-of-war',
-                    'Gears of War 4' => 'gears-of-war-4',
-                    'George Foreman' => 'george-foreman',
-                    'Geox' => 'geox',
-                    'GHD' => 'ghd',
-                    'Ghostbusters' => 'ghostbusters',
-                    'Ghostbusters: The Video Game Remastered' => 'ghostbusters-the-video-game',
-                    'Ghost of Tsushima' => 'ghost-of-tsushima',
-                    'Gibson Guitar' => 'gibson',
-                    'giffgaff' => 'giffgaff',
-                    'Gift Card' => 'gift-card',
-                    'Gift Hamper' => 'hamper',
-                    'Gifts' => 'gifts',
-                    'Gift Set' => 'gift-set',
-                    'GIGABYTE' => 'gigabyte',
-                    'Gigaset' => 'gigaset',
-                    'Gilet' => 'gilet',
-                    'Gillette Fusion' => 'fusion',
-                    'Gillette Mach3' => 'mach-3',
-                    'Gillette Razor' => 'gillette',
-                    'Gimbal' => 'gimbal',
-                    'Gin' => 'gin',
-                    'Girl&#039;s Clothes' => 'girls-clothes',
-                    'Glasses' => 'glasses',
-                    'Glassware' => 'glassware',
-                    'Glenfiddich' => 'glenfiddich',
-                    'Glenlivet' => 'glenlivet',
-                    'Glenmorangie' => 'glenmorangie',
-                    'Gloves' => 'gloves',
-                    'Glue' => 'glue',
-                    'Glue Gun' => 'glue-gun',
-                    'Gluten-Free' => 'gluten-free',
-                    'God of War' => 'god-of-war',
-                    'Go Kart' => 'go-kart',
-                    'Golf' => 'golf',
-                    'Golf Balls' => 'golf-balls',
-                    'Golf Clubs' => 'golf-clubs',
-                    'Goodfellas' => 'goodfellas',
-                    'Goodmans' => 'goodmans',
-                    'Goodyear' => 'goodyear',
-                    'Google' => 'google',
-                    'Google Home' => 'google-home',
-                    'Google Home Max' => 'google-home-max',
-                    'Google Home Mini' => 'google-home-mini',
-                    'Google Nest' => 'nest',
-                    'Google Nest Audio' => 'google-nest-audio',
-                    'Google Nest Hub' => 'google-home-hub',
-                    'Google Nest Mini' => 'nest-mini',
-                    'Google Nest Protect' => 'google-nest-protect',
-                    'Google Nexus' => 'nexus',
-                    'Google Pixel' => 'google-pixel',
-                    'Google Pixel 2' => 'google-pixel-2',
-                    'Google Pixel 2 XL' => 'google-pixel-2-xl',
-                    'Google Pixel 3' => 'google-pixel-3',
-                    'Google Pixel 3 XL' => 'google-pixel-3-xl',
-                    'Google Pixel 3a' => 'google-pixel-3a',
-                    'Google Pixel 3a XL' => 'google-pixel-3a-xl',
-                    'Google Pixel 4' => 'google-pixel-4',
-                    'Google Pixel 4 XL' => 'google-pixel-4-xl',
-                    'Google Pixel 4a' => 'google-pixel-4a',
-                    'Google Pixel 4a 5G' => 'google-pixel-4a-5g',
-                    'Google Pixel 5' => 'google-pixel-5',
-                    'Google Pixelbook' => 'google-pixelbook',
-                    'Google Pixel XL' => 'google-pixel-xl',
-                    'Google Smartphone' => 'google-smartphone',
-                    'Google Stadia' => 'google-stadia',
-                    'GoPro' => 'gopro',
-                    'GoPro HERO 6' => 'gopro-hero-6',
-                    'GoPro HERO 7' => 'gopro-hero-7',
-                    'GoPro HERO 8' => 'gopro-hero-8',
-                    'GoPro HERO 9' => 'gopro-hero-9',
-                    'Gore-Tex Clothing and Shoes' => 'gore-tex',
-                    'Graco' => 'graco',
-                    'Grand National' => 'grand-national',
-                    'Gran Turismo' => 'gran-turismo',
-                    'Gran Turismo Sport' => 'gran-turismo-sport',
-                    'Graphics Card' => 'graphics-card',
-                    'Gravity Rush' => 'gravity-rush',
-                    'Graze' => 'graze',
-                    'GreedFall' => 'greedfall',
-                    'Greenhouse' => 'greenhouse',
-                    'Greeting Cards and Wrapping Paper' => 'wrapping-paper-and-cards',
-                    'Greggs' => 'greggs',
-                    'Grey Goose' => 'grey-goose',
-                    'Griffin Technology' => 'griffin',
-                    'GroBag' => 'grobag',
-                    'Groceries' => 'groceries',
-                    'Gruffalo' => 'gruffalo',
-                    'Grundig' => 'grundig',
-                    'GTA' => 'gta',
-                    'GTA V' => 'gta-v',
-                    'GTX 970' => 'gtx-970',
-                    'GTX 980' => 'gtx-980',
-                    'GTX 1060' => 'gtx-1060',
-                    'GTX 1070' => 'gtx-1070',
-                    'GTX 1080' => 'gtx-1080',
-                    'GTX 1080 Ti' => 'gtx-1080-ti',
-                    'GTX 1660' => 'gtx-1660',
-                    'GTX 1660 Ti' => 'gtx-1660-ti',
-                    'Guardians of the Galaxy' => 'guardians-of-the-galaxy',
-                    'Gucci' => 'gucci',
-                    'Guinness' => 'guinness',
-                    'Guitar' => 'guitar',
-                    'Guitar Amp' => 'guitar-amp',
-                    'Guitar Hero' => 'guitar-hero',
-                    'Gulliver&#039;s' => 'gullivers',
-                    'Gym' => 'gym',
-                    'Gym Membership' => 'gym-membership',
-                    'H1Z1' => 'h1z1',
-                    'Häagen Dazs' => 'haagen-dazs',
-                    'Habitat' => 'habitat',
-                    'Hacksaw' => 'hacksaw',
-                    'Hair Brush' => 'hair-brush',
-                    'Hair Care' => 'hair',
-                    'Hair Clipper' => 'hair-clipper',
-                    'Hair Colour' => 'hair-colour',
-                    'Haircut' => 'haircut',
-                    'Hair Dryer' => 'hair-dryer',
-                    'Hair Dye' => 'hair-dye',
-                    'Hair Removal Devices' => 'hair-removal-devices',
-                    'Halifax' => 'halifax',
-                    'Hall' => 'hall',
-                    'Halloween' => 'halloween',
-                    'Halo' => 'halo',
-                    'Halo 5' => 'halo-5',
-                    'Ham' => 'ham',
-                    'Hammer' => 'hammer',
-                    'Hammer Drill' => 'hammer-drill',
-                    'Hammock' => 'hammock',
-                    'Handbag' => 'handbag',
-                    'Hand Blender' => 'hand-blender',
-                    'Hand Cream' => 'hand-cream',
-                    'Hand Mixer' => 'hand-mixer',
-                    'Hand Tools' => 'hand-tools',
-                    'Handwash' => 'handwash',
-                    'Hard Drive' => 'hard-drive',
-                    'Haribo' => 'haribo',
-                    'Harman Kardon' => 'harman-kardon',
-                    'Harry Potter' => 'harry-potter',
-                    'Hasbro' => 'hasbro',
-                    'Hat' => 'hat',
-                    'Hatchimals' => 'hatchimals',
-                    'Hats &amp; Caps' => 'hats-caps',
-                    'Hauck' => 'hauck',
-                    'Hayfever Remedies' => 'hayfever',
-                    'Headboard' => 'headboard',
-                    'Headphones' => 'headphones',
-                    'Headset' => 'headset',
-                    'Health &amp; Beauty' => 'beauty',
-                    'Healthcare' => 'health-care',
-                    'Heart Rate Monitor' => 'heart-rate-monitor',
-                    'Heater' => 'heater',
-                    'Heating' => 'heating',
-                    'Heating Appliances' => 'heating-appliances',
-                    'Hedge Trimmer' => 'hedge-trimmer',
-                    'Heineken' => 'heineken',
-                    'Heinz' => 'heinz',
-                    'Heinz Beanz' => 'heinz-baked-beans',
-                    'Hello Kitty' => 'hello-kitty',
-                    'Hello Neighbour' => 'hello-neighbour',
-                    'Helly Hansen' => 'helly-hansen',
-                    'Henry Hoover' => 'henry-hoover',
-                    'Hermes' => 'hermes',
-                    'High5' => 'high-5',
-                    'Highchair' => 'highchair',
-                    'Hiking' => 'hiking',
-                    'Hilton' => 'hilton',
-                    'Hisense' => 'hisense',
-                    'Hisense TVs' => 'hisense-tv',
-                    'Hitachi' => 'hitachi',
-                    'Hitman' => 'hitman',
-                    'Hive' => 'hive',
-                    'Hive Active Heating' => 'hive-active-heating',
-                    'Hob' => 'hob',
-                    'Hobbit' => 'hobbit',
-                    'Hockey' => 'hockey',
-                    'Holiday Inn' => 'holiday-inn',
-                    'Holiday Park' => 'holiday-parks',
-                    'Holidays and Trips' => 'holidays-and-trips',
-                    'Hollow Knight' => 'hollow-knight',
-                    'Home &amp; Living' => 'home',
-                    'Home Accessories' => 'home-accessories',
-                    'Home Appliances' => 'home-appliances',
-                    'Home Care' => 'home-care',
-                    'Home Cinema' => 'home-cinema',
-                    'HoMedics' => 'homedics',
-                    'Homefront' => 'homefront',
-                    'Home Networking' => 'network',
-                    'Homeplug' => 'homeplug',
-                    'Home Security' => 'home-security',
-                    'Homeware' => 'homeware',
-                    'Honda' => 'honda',
-                    'Honey' => 'honey',
-                    'Honeywell' => 'honeywell',
-                    'Honor 6X' => 'honor-6x',
-                    'Honor 7' => 'honor-7',
-                    'Honor 8S' => 'honor-8s',
-                    'Honor 8X' => 'honor-8x',
-                    'Honor 8X Max' => 'honor-8x-max',
-                    'Honor 9' => 'honor-9',
-                    'Honor 9X' => 'honor-9x',
-                    'Honor 10' => 'honor-10',
-                    'Honor Band 5' => 'honor-band-5',
-                    'Honor Play' => 'honor-play',
-                    'Honor Smartphone' => 'honor',
-                    'Honor View 20' => 'honor-view-20',
-                    'Hoodie' => 'hoodie',
-                    'Hoover' => 'hoover',
-                    'Hori' => 'hori',
-                    'Horizon: Zero Dawn' => 'horizon-zero-dawn',
-                    'Hornby' => 'hornby',
-                    'Horse Races' => 'horse-races',
-                    'Hose' => 'hose',
-                    'HOTAS' => 'hotas',
-                    'Hotel' => 'hotel',
-                    'Hotpoint' => 'hotpoint',
-                    'Hotspot' => 'hotspot',
-                    'Hot Tub' => 'hot-tub',
-                    'Hot Water Bottle' => 'hot-water-bottle',
-                    'Hot Wheels' => 'hot-wheels',
-                    'Hozelock' => 'hozelock',
-                    'HP' => 'hp',
-                    'HP Envy' => 'hp-envy',
-                    'HP Laptop' => 'hp-laptop',
-                    'HP Omen' => 'hp-omen',
-                    'HP Printer' => 'hp-printer',
-                    'HTC' => 'htc',
-                    'HTC 10' => 'htc-10',
-                    'HTC Desire' => 'htc-desire',
-                    'HTC One' => 'htc-one',
-                    'HTC Smartphone' => 'htc-smartphone',
-                    'HTC U11' => 'htc-u11',
-                    'HTC Vive' => 'htc-vive',
-                    'Huawei' => 'huawei',
-                    'Huawei Freebuds 3' => 'huawei-freebuds-3',
-                    'Huawei Headphones' => 'huawei-headphones',
-                    'Huawei Mate 20' => 'huawei-mate-20',
-                    'Huawei Mate 20 Pro' => 'huawei-mate-20-pro',
-                    'Huawei Mate 30' => 'huawei-mate-30',
-                    'Huawei Mate 30 Lite' => 'huawei-mate-30-lite',
-                    'Huawei Mate 30 Pro' => 'huawei-mate-30-pro',
-                    'Huawei Matebook' => 'huawei-matebook',
-                    'Huawei MediaPad M3' => 'huawei-mediapad-m3',
-                    'Huawei MediaPad M5' => 'huawei-mediapad-m5',
-                    'Huawei MediaPad T3' => 'huawei-mediapad-t3',
-                    'Huawei MediaPad T5' => 'huawei-mediapad-t5',
-                    'Huawei P9' => 'huawei-p9',
-                    'Huawei P10' => 'huawei-p10',
-                    'Huawei P20' => 'huawei-p20',
-                    'Huawei P20 Lite' => 'huawei-p20-lite',
-                    'Huawei P20 Pro' => 'huawei-p20-pro',
-                    'Huawei P30' => 'huawei-p30',
-                    'Huawei P30 Lite' => 'huawei-p30-lite',
-                    'Huawei P30 Pro' => 'huawei-p30-pro',
-                    'Huawei P40' => 'huawei-p40',
-                    'Huawei P40 Lite' => 'huawei-p40-lite',
-                    'Huawei P40 Pro' => 'huawei-p40-pro',
-                    'Huawei P Smart' => 'huawei-p-smart',
-                    'Huawei Smartphone' => 'huawei-smartphone',
-                    'Huawei Smartwatch' => 'huawei-smartwatch',
-                    'Huawei Tablet' => 'huawei-tablet',
-                    'Huawei Watch 2' => 'huawei-watch-2',
-                    'Huawei Watch GT' => 'huawei-watch-gt',
-                    'Huawei Watch GT2' => 'huawei-watch-gt2',
-                    'Huawei Watch GT 2 Pro' => 'huawei-watch-gt-2-pro',
-                    'Huawei Y7' => 'huawei-y7',
-                    'Huggies' => 'huggies',
-                    'Hulk' => 'hulk',
-                    'Humax' => 'humax',
-                    'Humidifier' => 'humidifier',
-                    'Hunter' => 'hunter',
-                    'HyperX' => 'hyperx',
-                    'Hyrule Warriors' => 'hyrule-warriors',
-                    'Hyundai' => 'hyundai',
-                    'IAMS' => 'iams',
-                    'iCandy' => 'icandy',
-                    'Ice-Watch' => 'ice-watch',
-                    'Ice Cream' => 'ice-cream',
-                    'Ice Cream Maker' => 'ice-cream-maker',
-                    'iMac' => 'apple-imac',
-                    'iMac 2021' => 'imac-2021',
-                    'Impact Driver' => 'impact-driver',
-                    'Indesit' => 'indesit',
-                    'Inflatable Boats' => 'boat',
-                    'Inflatable Toys' => 'inflatable',
-                    'Injustice' => 'injustice',
-                    'Injustice 2' => 'injustice-2',
-                    'Ink Cartridge' => 'ink',
-                    'Inkjet Printer' => 'inkjet-printer',
-                    'Innocent' => 'innocent',
-                    'Instant Cameras' => 'instant-cameras',
-                    'Instant Ink' => 'instant-ink',
-                    'Instax Mini 9' => 'instax-mini-9',
-                    'Insulation' => 'insulation',
-                    'Insurance' => 'insurance',
-                    'Intel' => 'intel',
-                    'Intel Atom' => 'atom',
-                    'Intel i3' => 'i3',
-                    'Intel i5' => 'i5',
-                    'Intel i7' => 'i7',
-                    'Intel i9' => 'intel-i9',
-                    'Internet' => 'internet',
-                    'Internet Security' => 'internet-security',
-                    'In the Night Garden' => 'in-the-night-garden',
-                    'Intimate Care' => 'intimate-care',
-                    'Introduce Yourself' => 'introduce-yourself',
-                    'iOS Apps' => 'ios-apps',
-                    'iPad' => 'ipad',
-                    'iPad 2019' => 'ipad-2019',
-                    'iPad 2020' => 'ipad-2020',
-                    'iPad Air' => 'ipad-air',
-                    'iPad Air 2019' => 'ipad-air-2019',
-                    'iPad Air 2020' => 'ipad-air-2020',
-                    'iPad Case' => 'ipad-case',
-                    'iPad mini' => 'ipad-mini',
-                    'iPad Pro' => 'ipad-pro',
-                    'iPad Pro 11' => 'ipad-pro-11',
-                    'iPad Pro 12.9' => 'ipad-pro-12-9',
-                    'iPad Pro 2020' => 'ipad-pro-2020',
-                    'iPad Pro 2021' => 'ipad-pro-2021',
-                    'IP Camera' => 'ip-camera',
-                    'iPhone' => 'iphone',
-                    'iPhone 5s' => 'iphone-5s',
-                    'iPhone 6' => 'iphone-6',
-                    'iPhone 6 Plus' => 'iphone-6-plus',
-                    'iPhone 6s' => 'iphone-6s',
-                    'iPhone 6s Plus' => 'iphone-6s-plus',
-                    'iPhone 7' => 'iphone-7',
-                    'iPhone 7 Plus' => 'iphone-7-plus',
-                    'iPhone 8' => 'iphone-8',
-                    'iPhone 8 Plus' => 'iphone-8-plus',
-                    'iPhone 11' => 'iphone-11',
-                    'iPhone 11 Pro' => 'iphone-11-pro',
-                    'iPhone 11 Pro Max' => 'iphone-11-pro-max',
-                    'iPhone 12' => 'iphone-12',
-                    'iPhone 12 mini' => 'iphone-12-mini',
-                    'iPhone 12 Pro' => 'iphone-12-pro',
-                    'iPhone 12 Pro Max' => 'iphone-12-pro-max',
-                    'iPhone Accessories' => 'iphone-accessories',
-                    'iPhone Case' => 'iphone-case',
-                    'iPhone SE' => 'iphone-se',
-                    'iPhone X' => 'iphone-x',
-                    'iPhone Xr' => 'iphone-xr',
-                    'iPhone Xs' => 'iphone-xs',
-                    'iPhone Xs Max' => 'iphone-xs-max',
-                    'iPod' => 'ipod',
-                    'iPod Nano' => 'ipod-nano',
-                    'iPod Shuffle' => 'ipod-shuffle',
-                    'iPod Touch' => 'ipod-touch',
-                    'Irish Whiskey' => 'irish-whisky',
-                    'Irn Bru' => 'irn-bru',
-                    'iRobot' => 'irobot',
-                    'Iron' => 'iron',
-                    'Ironing' => 'ironing',
-                    'Ironing Board' => 'ironing-board',
-                    'Iron Man' => 'iron-man',
-                    'Issey Miyake' => 'issey-miyake',
-                    'ITV' => 'itv',
-                    'Jabra' => 'jabra',
-                    'Jabra Elite 85h' => 'jabra-elite-85h',
-                    'Jabra Elite Active 65t' => 'jabra-elite-active-65t',
-                    'Jabra Elite Active 75t' => 'jabra-elite-active-75t',
-                    'Jabra Headphones' => 'jabra-headphones',
-                    'Jack &amp; Jones' => 'jack-and-jones',
-                    'Jack Daniel&#039;s' => 'jack-daniels',
-                    'Jacket' => 'jacket',
-                    'Jack Wills' => 'jack-wills',
-                    'Jack Wolfskin' => 'jack-wolfskin',
-                    'Jaffa Cakes' => 'jaffa-cakes',
-                    'Jägermeister' => 'jagermeister',
-                    'Jameson' => 'jameson',
-                    'Jamie Oliver' => 'jamie-oliver',
-                    'Jaybird' => 'jaybird',
-                    'JBL' => 'jbl',
-                    'JBL Flip' => 'jbl-flip',
-                    'JBL GO' => 'jbl-go',
-                    'JBL Headphones' => 'jbl-headphones',
-                    'JBL Link' => 'jbl-link',
-                    'JBL Live' => 'jbl-live',
-                    'JBL Tune' => 'jbl-tune',
-                    'JCB' => 'jcb',
-                    'Jean Paul Gaultier' => 'jean-paul-gautier',
-                    'Jean Paul Gaultier Le Male' => 'le-male',
-                    'Jeans' => 'jeans',
-                    'Jelly Belly' => 'jelly-belly',
-                    'Jewellery' => 'jewellery',
-                    'Jigsaw' => 'jigsaw',
-                    'Jim Beam' => 'jim-beam',
-                    'Jimmy Choo' => 'jimmy-choo',
-                    'JML' => 'jml',
-                    'Jogging Bottoms' => 'jogging-bottoms',
-                    'Johnnie Walker' => 'johnnie-walker',
-                    'Johnson&#039;s' => 'johnsons',
-                    'John West' => 'john-west',
-                    'John Wick' => 'john-wick',
-                    'JoJo Siwa' => 'jojo',
-                    'Joop' => 'joop',
-                    'Joseph Joseph' => 'joseph-joseph',
-                    'Joules' => 'joules',
-                    'Juice' => 'juice',
-                    'Juicer' => 'juicer',
-                    'Jumper' => 'jumper',
-                    'Jurassic World' => 'jurassic-world',
-                    'Jura Whisky' => 'jura',
-                    'Just Cause' => 'just-cause',
-                    'Just Cause 3' => 'just-cause-3',
-                    'Just Cause 4' => 'just-cause-4',
-                    'Just Dance' => 'just-dance',
-                    'JVC' => 'jvc',
-                    'K-Swiss' => 'k-swiss',
-                    'Karcher' => 'karcher',
-                    'Karcher Window Vacuum' => 'karcher-window-cleaner',
-                    'Karen Millen' => 'karen-millen',
-                    'Karrimor' => 'karrimor',
-                    'Kaspersky' => 'kaspersky',
-                    'Kayak' => 'kayak',
-                    'Keg' => 'keg',
-                    'Kellogg&#039;s' => 'kelloggs',
-                    'Kellogg&#039;s Cornflakes' => 'cornflakes',
-                    'Kellogg&#039;s Crunchy Nut' => 'crunchy-nut',
-                    'Kenco' => 'kenco',
-                    'Kenwood' => 'kenwood',
-                    'Kenwood kMix' => 'kmix',
-                    'Kenzo' => 'kenzo',
-                    'Ketchup' => 'ketchup',
-                    'Keter' => 'keter',
-                    'Kettle' => 'kettle',
-                    'Kettlebell' => 'kettlebell',
-                    'Keyboard' => 'keyboard',
-                    'KIA' => 'kia',
-                    'Kickers' => 'kickers',
-                    'Kid&#039;s Bike' => 'kids-bike',
-                    'Kid&#039;s Clothes' => 'kids-clothes',
-                    'Kid&#039;s Room' => 'kids-rooms',
-                    'Kid&#039;s Shoes' => 'kids-shoes',
-                    'Kidizoom' => 'kidizoom',
-                    'Killzone' => 'killzone',
-                    'Kilner' => 'kilner',
-                    'Kinder' => 'kinder',
-                    'Kindle' => 'kindle',
-                    'Kindle Book' => 'kindle-book',
-                    'Kindle Fire' => 'kindle-fire',
-                    'Kindle Oasis' => 'kindle-oasis',
-                    'Kindle Paperwhite' => 'kindle-paperwhite',
-                    'Kingdom Come: Deliverance' => 'kingdom-come-deliverance',
-                    'Kingdom Hearts' => 'kingdom-hearts',
-                    'Kingdom Hearts 3' => 'kingdom-hearts-3',
-                    'Kingdom Hearts: The Story So Far' => 'kingdom-hearts-the-story-so-far',
-                    'King Kong' => 'king-kong',
-                    'King Size Bed' => 'king-size',
-                    'Kingsmill' => 'kingsmill',
-                    'Kingston' => 'kingston',
-                    'Kitchen' => 'kitchen',
-                    'KitchenAid' => 'kitchenaid',
-                    'Kitchen Appliances' => 'kitchen-appliances',
-                    'Kitchen Knife' => 'knife',
-                    'Kitchen Roll' => 'kitchen-roll',
-                    'Kitchen Scale' => 'kitchen-scales',
-                    'Kitchen Tap' => 'kitchen-tap',
-                    'Kitchen Utensils' => 'kitchen-utensils',
-                    'Kite' => 'kite',
-                    'KitSound' => 'kitsound',
-                    'Knickers' => 'knickers',
-                    'Kobo' => 'kobo',
-                    'Kodak' => 'kodak',
-                    'Kodi' => 'kodi',
-                    'Kohinoor' => 'kohinoor',
-                    'Kopparberg' => 'kopparberg',
-                    'Kraken' => 'kraken',
-                    'Krispy Kreme' => 'krispy-kreme',
-                    'Krups' => 'krups',
-                    'KTC' => 'ktc',
-                    'Kurt Geiger' => 'kurt-geiger',
-                    'L&#039;Occitane' => 'loccitane',
-                    'L.O.L. Surprise!' => 'lol-surprise',
-                    'Lacoste' => 'lacoste',
-                    'Ladder' => 'ladder',
-                    'Lamaze' => 'lamaze',
-                    'Lamb' => 'lamb',
-                    'Laminate' => 'laminate',
-                    'Laminator' => 'laminator',
-                    'Lamp' => 'lamp',
-                    'Lancôme' => 'lancome',
-                    'Landmann' => 'landmann',
-                    'Lantern' => 'lantern',
-                    'Laphroaig' => 'laphroaig',
-                    'Laptop' => 'laptop',
-                    'Laptop Accessories' => 'laptop-accessories',
-                    'Laptop Case' => 'laptop-case',
-                    'Laptop Sleeve' => 'laptop-sleeve',
-                    'Laser Printer' => 'laser-printer',
-                    'Last Minute' => 'last-minute',
-                    'Laundry Basket' => 'laundry-basket',
-                    'Laura Ashley' => 'laura-ashley',
-                    'Lavazza' => 'lavazza',
-                    'Lavender' => 'lavender',
-                    'Lawnmower' => 'lawnmower',
-                    'Lay-Z-Spa' => 'lay-z-spa',
-                    'LeapFrog' => 'leapfrog',
-                    'Le Creuset' => 'le-creuset',
-                    'LED Bulb' => 'led-bulbs',
-                    'LED Light' => 'led-light',
-                    'LED Strip Lights' => 'led-strip-lights',
-                    'LED TV' => 'led-tv',
-                    'Lee Stafford' => 'lee-stafford',
-                    'Leffe' => 'leffe',
-                    'Leggings' => 'leggings',
-                    'Lego' => 'lego',
-                    'Lego Advent Calendar' => 'lego-advent-calendar',
-                    'Lego Architecture' => 'lego-architecture',
-                    'Lego Art' => 'lego-art',
-                    'Lego Batman' => 'lego-batman',
-                    'Lego BrickHeadz' => 'lego-brickheadz',
-                    'Lego City' => 'lego-city',
-                    'Lego Classic' => 'lego-classic',
-                    'Lego Creator' => 'lego-creator',
-                    'Lego Dimensions' => 'lego-dimensions',
-                    'Lego Disney' => 'lego-disney',
-                    'Lego Dots' => 'lego-dots',
-                    'Lego Duplo' => 'lego-duplo',
-                    'Lego Friends' => 'lego-friends',
-                    'LEGO Harry Potter' => 'lego-harry-potter',
-                    'Lego Hidden Side' => 'lego-hidden-side',
-                    'Legoland' => 'legoland',
-                    'Lego Marvel' => 'lego-marvel',
-                    'Lego Mindstorms' => 'lego-mindstorms',
-                    'Lego Nexo Knights' => 'lego-nexo-knights',
-                    'Lego Ninjago' => 'lego-ninjago',
-                    'Lego Porsche' => 'lego-porsche',
-                    'Lego Simpsons' => 'lego-simpsons',
-                    'Lego Speed Champions' => 'lego-speed-champions',
-                    'Lego Star Wars' => 'lego-star-wars',
-                    'Lego Star Wars Millennium Falcon' => 'lego-star-wars-millennium-falcon',
-                    'Lego Super Mario' => 'lego-mario',
-                    'Lego Technic' => 'lego-technic',
-                    'Lego VIDIYO' => 'lego-vidiyo',
-                    'Lemonade' => 'lemonade',
-                    'Lenor' => 'lenor',
-                    'Lenovo' => 'lenovo',
-                    'Lenovo IdeaPad' => 'lenovo-ideapad',
-                    'Lenovo Laptop' => 'lenovo-laptop',
-                    'Lenovo Tablet' => 'lenovo-tablet',
-                    'Lenovo Thinkpad' => 'thinkpad',
-                    'Lenovo Yoga Laptop' => 'lenovo-yoga-laptop',
-                    'Lenovo Yoga Tablet' => 'lenovo-yoga',
-                    'Les Paul' => 'les-paul',
-                    'Levi&#039;s' => 'levi',
-                    'Lexar' => 'lexar',
-                    'LG' => 'lg',
-                    'LG G3' => 'lg-g3',
-                    'LG G5' => 'lg-g5',
-                    'LG G6' => 'lg-g6',
-                    'LG G7' => 'lg-g7',
-                    'LG G8S ThinQ' => 'lg-g8s-thinq',
-                    'LG OLED TV' => 'lg-oled-tv',
-                    'LG Smartphone' => 'lg-smartphone',
-                    'LG TV' => 'lg-tv',
-                    'LG V30' => 'lg-v30',
-                    'LG V40 ThinQ' => 'lg-v40-thinq',
-                    'Life Insurance' => 'life-insurance',
-                    'Life is Strange' => 'life-is-strange',
-                    'Light Box' => 'light-box',
-                    'Lighting' => 'lighting',
-                    'Lightning Cable' => 'lightning-cable',
-                    'Lightsaber' => 'lightsaber',
-                    'Lindor' => 'lindor',
-                    'Lindt' => 'lindt',
-                    'Lingerie' => 'lingerie',
-                    'Linksys' => 'linksys',
-                    'Linx' => 'linx',
-                    'Lion King' => 'lion-king',
-                    'Lipstick' => 'lipstick',
-                    'Lipsy' => 'lipsy',
-                    'Little Tikes' => 'little-tikes',
-                    'Liverpool F. C.' => 'liverpool-fc',
-                    'Living Room' => 'living-room',
-                    'Local Traffic' => 'local-traffic',
-                    'Lodge' => 'lodge',
-                    'Loft' => 'loft',
-                    'Logitech' => 'logitech',
-                    'Logitech G430' => 'logitech-g430',
-                    'Logitech G703' => 'logitech-g703',
-                    'Logitech G903' => 'logitech-g903',
-                    'Logitech Harmony' => 'harmony',
-                    'Logitech Keyboard' => 'logitech-keyboard',
-                    'Logitech Mouse' => 'logitech-mouse',
-                    'Logitech MX Master' => 'logitech-mx-master',
-                    'Logitech MX Master 2S' => 'logitech-mx-master-2s',
-                    'London Eye' => 'london-eye',
-                    'London Zoo' => 'london-zoo',
-                    'Longleat' => 'longleat',
-                    'Long Sleeve' => 'long-sleeve',
-                    'Lord of the Rings' => 'lord-of-the-rings',
-                    'Lottery' => 'lottery',
-                    'Lounger' => 'lounger',
-                    'Lowepro' => 'lowepro',
-                    'Lucozade' => 'lucozade',
-                    'Luigi' => 'luigi',
-                    'Luigi&#039;s Mansion' => 'luigis-manison',
-                    'Luigi&#039;s Mansion 3' => 'luigis-mansion-3',
-                    'Lunch Bag' => 'lunch-bag',
-                    'Lunch Box' => 'lunch-box',
-                    'Lurpak' => 'lurpak',
-                    'Luton' => 'luton',
-                    'Lyle &amp; Scott' => 'lyle-and-scott',
-                    'Lynx' => 'lynx',
-                    'M.2 SSD' => 'm2-ssd',
-                    'MacBook' => 'macbook',
-                    'MacBook Air' => 'macbook-air',
-                    'MacBook Pro' => 'macbook-pro',
-                    'MacBook Pro 13' => 'macbook-pro-13',
-                    'MacBook Pro 15' => 'macbook-pro-15',
-                    'MacBook Pro 16' => 'macbook-pro-16',
-                    'Maclaren' => 'maclaren',
-                    'Mac mini' => 'mac-mini',
-                    'Madame Tussauds' => 'madame-tussauds',
-                    'Mad Catz' => 'madcatz',
-                    'Madden NFL' => 'madden',
-                    'Madden NFL 20' => 'madden-nfl-20',
-                    'Mad Max' => 'mad-max',
-                    'Mafia 3' => 'mafia-3',
-                    'Magazine' => 'magazine',
-                    'Magimix' => 'magimix',
-                    'Magners' => 'magners',
-                    'Magnum' => 'magnum',
-                    'Make Up' => 'make-up',
-                    'Makeup Advent Calendar' => 'makeup-advent-calendar',
-                    'Make Up Brush' => 'make-up-brush',
-                    'Makita' => 'makita',
-                    'Makita Drill' => 'makita-drill',
-                    'Malibu' => 'malibu',
-                    'Maltesers' => 'maltesers',
-                    'MAM' => 'mam',
-                    'Mamas &amp; Papas' => 'mamas-and-papas',
-                    'Manchester United' => 'manchester-united',
-                    'Manfrotto' => 'manfrotto',
-                    'Manga' => 'manga',
-                    'Manuka Honey' => 'manuka-honey',
-                    'Marantz' => 'marantz',
-                    'Marc Jacobs' => 'marc-jacobs',
-                    'Marc Jacobs Daisy' => 'daisy',
-                    'Mario &amp; Sonic at the Olympic Games: Tokyo 2020' => 'mario-and-sonic-tokyo-2020',
-                    'Mario + Rabbids Kingdom Battle' => 'mario-rabbids-kingdom-battle',
-                    'Mario Kart' => 'mario-kart',
-                    'Mario Kart 8' => 'mario-kart-8',
-                    'Mario Kart 8 Deluxe' => 'mario-kart-8-deluxe',
-                    'Marmite' => 'marmite',
-                    'Mars' => 'mars',
-                    'Marshall' => 'marshall',
-                    'Marshall Headphones' => 'marshall-headphones',
-                    'Marvel' => 'marvel',
-                    'Marvel&#039;s Spider-Man (PS4)' => 'spider-man-2018',
-                    'Marvel&#039;s Spider-Man: Miles Morales' => 'spiderman-miles-morales',
-                    'Mascara' => 'mascara',
-                    'Massage' => 'massage',
-                    'Mass Effect' => 'mass-effect',
-                    'Mass Effect: Andromeda' => 'mass-effect-andromeda',
-                    'Mastercard' => 'mastercard',
-                    'Masterplug' => 'masterplug',
-                    'Maternity &amp; Pregnancy' => 'maternity',
-                    'Mattress' => 'mattress',
-                    'Mattress Protector' => 'mattress-protector',
-                    'Mattress Topper' => 'mattress-topper',
-                    'Mavic' => 'mavic',
-                    'Max Factor' => 'max-factor',
-                    'Maxi Cosi' => 'maxi-cosi',
-                    'Maximuscle' => 'maximuscle',
-                    'Maxtor' => 'maxtor',
-                    'Maybelline' => 'maybelline',
-                    'Mayo' => 'mayo',
-                    'Mazda' => 'mazda',
-                    'McAfee' => 'mcafee',
-                    'Meat &amp; Sausages' => 'meat',
-                    'Meccano' => 'meccano',
-                    'Mechanical Keyboard' => 'mechanical-keyboard',
-                    'Medal of Honor' => 'medal-of-honor',
-                    'Medela' => 'medela',
-                    'Media Player' => 'media-player',
-                    'Medievil' => 'medievil',
-                    'Medion' => 'medion',
-                    'Mega Bloks' => 'mega-bloks',
-                    'Megathread' => 'megathread',
-                    'Melissa &amp; Doug' => 'melissa',
-                    'Memory Cards' => 'memory-cards',
-                    'Memory Foam Mattress' => 'memory-foam',
-                    'Men&#039;s Boots' => 'mens-boots',
-                    'Men&#039;s Fragrance' => 'mens-fragrance',
-                    'Men&#039;s Shoes' => 'mens-shoes',
-                    'Men&#039;s Suit' => 'suit',
-                    'Mercedes' => 'mercedes',
-                    'Meridian' => 'meridian',
-                    'Merlin' => 'merlin',
-                    'Merrell' => 'merrell',
-                    'Messenger Bag' => 'messenger-bag',
-                    'Metal Gear Solid' => 'metal-gear-solid',
-                    'Metro Exodus' => 'metro-exodus',
-                    'Metroid' => 'metroid',
-                    'Metro Series' => 'metro-series',
-                    'Michael Kors' => 'michael-kors',
-                    'Michelin' => 'michelin',
-                    'Microphone' => 'microphone',
-                    'Micro SD Card' => 'micro-sd',
-                    'Micro SDHC' => 'micro-sdhc',
-                    'Micro SDXC' => 'micro-sdxc',
-                    'Microserver' => 'microserver',
-                    'Microsoft' => 'microsoft',
-                    'Microsoft Flight Simulator' => 'microsoft-flight-simulator',
-                    'Microsoft Office' => 'microsoft-office',
-                    'Microsoft Points' => 'microsoft-points',
-                    'Microsoft Software' => 'microsoft-software',
-                    'Microsoft Surface Book' => 'surface-book',
-                    'Microsoft Surface Laptop' => 'surface',
-                    'Microsoft Surface Pro 6' => 'surface-pro-6',
-                    'Microsoft Surface Pro 7' => 'surface-pro-7',
-                    'Microsoft Surface Tablet' => 'microsoft-surface-tablet',
-                    'Microwave' => 'microwave',
-                    'Middle Earth' => 'middle-earth',
-                    'Middle Earth: Shadow of Mordor' => 'shadow-of-mordor',
-                    'Middle Earth: Shadow of War' => 'middle-earth-shadow-of-war',
-                    'Miele' => 'miele',
-                    'Miele Vacuum Cleaner' => 'miele-vacuum-cleaner',
-                    'Milk' => 'milk',
-                    'Milk Frother' => 'milk-frother',
-                    'Milk Tray' => 'milk-tray',
-                    'Milwaukee' => 'milwaukee',
-                    'Mince' => 'mince',
-                    'Minecraft Game' => 'minecraft',
-                    'Mineral Water' => 'mineral-water',
-                    'Mini Fridge' => 'mini-fridge',
-                    'Minions' => 'minions',
-                    'Mini PC' => 'mini-pc',
-                    'Minky' => 'minky',
-                    'Mira' => 'mira',
-                    'Mirror' => 'mirror',
-                    'Mirror&#039;s Edge' => 'mirrors-edge',
-                    'Misc' => 'misc',
-                    'Misfit' => 'misfit',
-                    'Mitre Saw' => 'mitre-saw',
-                    'Mitsubishi' => 'mitsubishi',
-                    'Mixer &amp; Blender' => 'mixer-and-blender',
-                    'Mobile Contracts' => 'mobile-contract',
-                    'Mobile Phone' => 'mobile-phone',
-                    'Model Building' => 'model-building',
-                    'Moët' => 'moet',
-                    'Molton Brown' => 'molton-brown',
-                    'Money Saving Tips and Tricks' => 'money-saving-tips',
-                    'Monitor' => 'monitor',
-                    'Monopoly' => 'monopoly',
-                    'Monsoon' => 'monsoon',
-                    'Monster Energy' => 'monster-energy',
-                    'Monster High' => 'monster-high',
-                    'Monster Hunter' => 'monster-hunter',
-                    'Monster Hunter World' => 'monster-hunter-world',
-                    'Mont Blanc' => 'mont-blanc',
-                    'Mop' => 'mop',
-                    'Morphy Richards' => 'morphy-richards',
-                    'Mortal Kombat' => 'mortal-kombat',
-                    'Mortal Kombat 11' => 'mortal-kombat-11',
-                    'Mortgage' => 'mortgage',
-                    'Moschino' => 'moschino',
-                    'Moses Basket' => 'moses-basket',
-                    'MOT' => 'mot',
-                    'Motherboard' => 'motherboard',
-                    'Moto 360' => 'moto-360',
-                    'Moto E' => 'moto-e',
-                    'Moto G' => 'moto-g',
-                    'Moto G4' => 'moto-g4',
-                    'Moto G5' => 'moto-g5',
-                    'Moto G6' => 'moto-g6',
-                    'Moto G7' => 'moto-g7',
-                    'Motorcycle' => 'motorcycle',
-                    'Motorcycle Accessories' => 'motorcycle-accessories',
-                    'Motorcycle Helmet' => 'motorcycle-helmet',
-                    'Motorola' => 'motorola',
-                    'Motorola Smartphone' => 'motorola-smartphone',
-                    'Moto X' => 'moto-x',
-                    'Moto Z' => 'moto-z',
-                    'Mountain Bike' => 'mountain-bike',
-                    'Mouse &amp; Keyboard Bundles' => 'mouse-and-keyboard-bundle',
-                    'Mouse Mat' => 'mouse-mat',
-                    'Mouthwash' => 'mouthwash',
-                    'Movie and TV Box Set' => 'box-set',
-                    'Movies &amp; Series' => 'movie',
-                    'MP3 Player' => 'mp3-player',
-                    'Mr Kipling' => 'mr-kipling',
-                    'Mr Men' => 'mr-men',
-                    'MSI' => 'msi',
-                    'MSI Laptop' => 'msi-laptop',
-                    'Muc-Off' => 'muc-off',
-                    'Mug' => 'mug',
-                    'Muller' => 'muller',
-                    'Multi-Room Audio System' => 'multi-room-audio-system',
-                    'Multitool' => 'multitool',
-                    'Museums' => 'museums',
-                    'Music' => 'music',
-                    'Musical Instruments' => 'musical-instrument',
-                    'Music App' => 'music-app',
-                    'Music Streaming' => 'music-streaming',
-                    'My Little Pony' => 'my-little-pony',
-                    'Nail Gun' => 'nail-gun',
-                    'Nail Polish' => 'nail-polish',
-                    'Nails' => 'nails',
-                    'Nails Inc.' => 'nails-inc',
-                    'Nakd' => 'nakd',
-                    'Nando&#039;s' => 'nandos',
-                    'Nappy' => 'nappy',
-                    'NAS' => 'nas',
-                    'National Express Ticket' => 'national-express',
-                    'National Trust' => 'national-trust',
-                    'Nature Observation' => 'nature-observation',
-                    'NatWest' => 'natwest',
-                    'NBA 2K' => 'nba-2k',
-                    'NBA Live' => 'nba',
-                    'Necklace' => 'necklace',
-                    'Need for Speed' => 'need-for-speed',
-                    'Need for Speed: Payback' => 'need-for-speed-payback',
-                    'Need for Speed Heat' => 'need-for-speed-heat',
-                    'Neff' => 'neff',
-                    'Nerf Guns' => 'nerf',
-                    'Nescafé Azera' => 'azera',
-                    'Nescafé Coffee' => 'nescafe',
-                    'Nespresso' => 'nespresso',
-                    'Nespresso Coffee Machine' => 'nespresso-coffee-machine',
-                    'Nest Hello' => 'nest-hello',
-                    'Nestlé' => 'nestle',
-                    'Nest Learning Thermostat' => 'nest-learning-thermostat',
-                    'Nestlé Cheerios' => 'cheerios',
-                    'Nestlé Shreddies' => 'shreddies',
-                    'Netatmo' => 'netatmo',
-                    'Netflix' => 'netflix',
-                    'Netgear' => 'netgear',
-                    'Netgear Arlo' => 'arlo',
-                    'New Balance' => 'new-balance',
-                    'New Balance Trainers' => 'new-balance-trainers',
-                    'New Look' => 'new-look',
-                    'Newspapers' => 'newspapers',
-                    'Nextbase' => 'nextbase',
-                    'NFL' => 'nfl',
-                    'NHL' => 'nhl',
-                    'NHL 20' => 'nhl-20',
-                    'NHS' => 'nhs',
-                    'NieR: Automata' => 'nier',
-                    'Night Light' => 'night-light',
-                    'Nike' => 'nike',
-                    'Nike Air Max' => 'nike-air-max',
-                    'Nike Air Max 200' => 'nike-air-max-200',
-                    'Nike Air Max 270' => 'nike-air-max-270',
-                    'Nike Air Max 720' => 'nike-air-max-720',
-                    'Nike Free' => 'nike-free',
-                    'Nike Huarache' => 'nike-huarache',
-                    'Nike Jordan' => 'jordan',
-                    'Nike Presto' => 'nike-presto',
-                    'Nike Roshe' => 'nike-roshe',
-                    'Nike Trainers' => 'nike-shoes',
-                    'Nikon' => 'nikon',
-                    'Nikon Camera' => 'nikon-camera',
-                    'Nikon Coolpix' => 'nikon-coolpix',
-                    'Nikon D3400' => 'nikon-d3400',
-                    'Nikon Lens' => 'nikon-lens',
-                    'Nilfisk' => 'nilfisk',
-                    'Ni No Kuni' => 'ni-no-kuni',
-                    'Ni No Kuni: Wrath of the White Witch' => 'ni-no-kuni-white-witch',
-                    'Ni No Kuni II: Revenant Kingdom' => 'ni-no-kuni-2',
-                    'Nintendo' => 'nintendo',
-                    'Nintendo 2DS' => '2ds',
-                    'Nintendo 3DS' => '3ds',
-                    'Nintendo 3DS Game' => '3ds-games',
-                    'Nintendo 3DS XL' => 'nintendo-3ds-xl',
-                    'Nintendo Accessories' => 'nintendo-accessories',
-                    'Nintendo Classic Mini' => 'nintendo-classic-mini',
-                    'Nintendo DS Game' => 'ds-games',
-                    'Nintendo Labo' => 'switch-labo',
-                    'Nintendo Switch' => 'nintendo-switch',
-                    'Nintendo Switch Accessories' => 'switch-accessories',
-                    'Nintendo Switch Case' => 'switch-case',
-                    'Nintendo Switch Controller' => 'switch-controller',
-                    'Nintendo Switch Game' => 'switch-game',
-                    'Nintendo Switch Joy-Con' => 'switch-joy-con',
-                    'Nintendo Switch Lite' => 'nintendo-switch-lite',
-                    'Nintendo Switch Pro Controller' => 'switch-pro-controller',
-                    'Nioh' => 'nioh',
-                    'Nissan' => 'nissan',
-                    'Nivea' => 'nivea',
-                    'No7' => 'no7',
-                    'Noise Cancelling Headphones' => 'noise-cancelling-headphones',
-                    'Nokia' => 'nokia',
-                    'Nokia Smartphones' => 'nokia-mobile',
-                    'No Man&#039;s Sky' => 'no-man-s-sky',
-                    'Noodles' => 'noodles',
-                    'Norton' => 'norton',
-                    'Now' => 'now-tv',
-                    'Numatic' => 'numatic',
-                    'Nursery' => 'nursery',
-                    'Nutella' => 'nutella',
-                    'NutriBullet' => 'nutribullet',
-                    'Nutri Ninja' => 'nutri-ninja',
-                    'Nuts' => 'nuts',
-                    'Nvidia' => 'nvidia',
-                    'Nvidia GeForce' => 'geforce',
-                    'Nvidia Shield' => 'nvidia-shield',
-                    'NYX' => 'nyx',
-                    'NZXT' => 'nzxt',
-                    'O2' => 'o2',
-                    'O2 Refresh' => 'o2-refresh',
-                    'Oakley' => 'oakley',
-                    'Octonauts' => 'octonauts',
-                    'Oculus Game' => 'oculus-game',
-                    'Oculus Go' => 'oculus-go',
-                    'Oculus Quest' => 'oculus-quest',
-                    'Oculus Rift' => 'oculus',
-                    'Oculus Rift S' => 'oculus-rift-s',
-                    'Odeon' => 'odeon',
-                    'Office' => 'office',
-                    'Office Chair' => 'office-chair',
-                    'Official Announcements' => 'official-announcements',
-                    'Olay' => 'olay',
-                    'OLED TV' => 'oled',
-                    'Olive Oil' => 'olive-oil',
-                    'Olympus' => 'olympus',
-                    'Omega Seamaster' => 'omega-seamaster',
-                    'Omega Speedmaster' => 'omega-speedmaster',
-                    'Omega Watches' => 'omega-watch',
-                    'OnePlus 3' => 'oneplus-3',
-                    'OnePlus 5' => 'oneplus-5',
-                    'OnePlus 6' => 'oneplus-6',
-                    'OnePlus 6T' => 'oneplus-6t',
-                    'OnePlus 7' => 'oneplus-7',
-                    'OnePlus 7 Pro' => 'oneplus-7-pro',
-                    'OnePlus 7T' => 'oneplus-7t',
-                    'OnePlus 7T Pro' => 'one-plus-7t-pro',
-                    'OnePlus 8' => 'oneplus-8',
-                    'OnePlus 8 Pro' => 'oneplus-8-pro',
-                    'OnePlus 8T' => 'oneplus-8t',
-                    'OnePlus 9' => 'oneplus-9',
-                    'OnePlus 9 Pro' => 'oneplus-9-pro',
-                    'OnePlus Nord' => 'oneplus-nord',
-                    'OnePlus Nord N10 5G' => 'oneplus-n10',
-                    'OnePlus Nord N100' => 'oneplus-n100',
-                    'OnePlus Smartphone' => 'oneplus',
-                    'Onesie' => 'onesie',
-                    'Onkyo' => 'onkyo',
-                    'Online Courses' => 'online-courses',
-                    'Operating System' => 'operating-system',
-                    'Oppo Find X2 Lite' => 'oppo-find-x2-lite',
-                    'Oppo Find X2 Neo' => 'oppo-find-x2-neo',
-                    'Oppo Find X2 Pro' => 'oppo-find-x2-pro',
-                    'Oppo Reno' => 'oppo-reno',
-                    'Oppo Reno4 5G' => 'oppo-reno4',
-                    'Oppo Reno4 Z 5G' => 'oppo-reno4-z',
-                    'Oppo Smartphone' => 'oppo-smartphone',
-                    'Opticians' => 'opticians',
-                    'Optoma' => 'optoma',
-                    'Oral-B' => 'oral-b',
-                    'Oral-B Toothbrush' => 'oral-b-toothbrush',
-                    'Oreo' => 'oreo',
-                    'Origin' => 'origin',
-                    'Original Penguin' => 'penguin',
-                    'Orla Kiely' => 'orla-kiely',
-                    'Osprey' => 'osprey',
-                    'Osram' => 'osram',
-                    'Other' => 'other-deals',
-                    'Ottoman' => 'ottoman',
-                    'Oukitel' => 'oukitel',
-                    'Outdoor Clothing' => 'outdoor-clothing',
-                    'Outdoor Lighting' => 'outdoor-lighting',
-                    'Outdoor Sports &amp; Camping' => 'outdoor',
-                    'Outdoor Toys' => 'outdoor-toys',
-                    'Outlast' => 'outlast',
-                    'Outlet' => 'outlet',
-                    'Outwell' => 'outwell',
-                    'Oven' => 'oven',
-                    'Overcooked' => 'overcooked',
-                    'Overcooked 2' => 'overcooked-2',
-                    'Overwatch' => 'overwatch',
-                    'Oyster Card' => 'oyster',
-                    'Package Holidays' => 'holiday',
-                    'Paco Rabanne' => 'paco-rabanne',
-                    'Paco Rabanne 1 Million' => 'paco-rabanne-1-million',
-                    'Paco Rabanne Lady Million' => 'lady-million',
-                    'Paddling Pool' => 'paddling-pool',
-                    'Padlock' => 'padlock',
-                    'Paint' => 'paint',
-                    'Paint Brush' => 'paint-brush',
-                    'Pampers' => 'pampers',
-                    'Panasonic' => 'panasonic',
-                    'Panasonic Camera' => 'panasonic-camera',
-                    'Panasonic Lumix' => 'lumix',
-                    'Panasonic TV' => 'panasonic-tv',
-                    'Pandora' => 'pandora',
-                    'Panini' => 'panini',
-                    'Panini Stickers' => 'panini-stickers',
-                    'Papa Johns' => 'papa-johns',
-                    'Paper Mario' => 'paper-mario',
-                    'Parasol' => 'parasol',
-                    'Parcel and Delivery Services' => 'parcel',
-                    'Parka' => 'parka',
-                    'Parking' => 'parking',
-                    'Parrot' => 'parrot',
-                    'Paul Smith' => 'paul-smith',
-                    'PAW Patrol' => 'paw-patrol',
-                    'Payday' => 'payday',
-                    'Payday 2' => 'payday-2',
-                    'PAYG' => 'payg',
-                    'Pay Monthly' => 'pay-monthly',
-                    'PC' => 'pc',
-                    'PC Case' => 'pc-case',
-                    'PC Game' => 'pc-game',
-                    'PC Gaming Accessories' => 'pc-gaming-accessories',
-                    'PC Gaming Systems' => 'pc-gaming-systems',
-                    'PC Mouse' => 'mouse',
-                    'PC Parts' => 'pc-parts',
-                    'Peanut Butter' => 'peanut-butter',
-                    'Peanuts' => 'peanuts',
-                    'Pedometer' => 'pedometer',
-                    'Pentax' => 'pentax',
-                    'Peppa Pig' => 'peppa-pig',
-                    'PepperBonus' => 'pepperbonus',
-                    'Pepsi' => 'pepsi',
-                    'Perfume' => 'perfume',
-                    'Persil' => 'persil',
-                    'Persona' => 'persona',
-                    'Persona 5' => 'persona-5',
-                    'Personal Care &amp; Hygiene' => 'personal-care-hygiene',
-                    'Petrol and Diesel' => 'petrol',
-                    'Pet Supplies' => 'pets',
-                    'Peugeot' => 'peugeot',
-                    'PG Tips' => 'pg-tips',
-                    'Philips' => 'philips',
-                    'Philips Alarm Clock' => 'philips-alarm-clock',
-                    'Philips Avent' => 'avent',
-                    'Philips Hue' => 'philips-hue',
-                    'Philips Lumea' => 'lumea',
-                    'Philips OneBlade' => 'philips-one-blade',
-                    'Philips Senseo' => 'philips-senseo',
-                    'Philips Senseo Coffee Machine' => 'philips-senseo-coffee-machine',
-                    'Philips Shaver' => 'philips-shaver',
-                    'Philips Sonicare' => 'sonicare',
-                    'Philips TV' => 'philips-tv',
-                    'Phone Holder' => 'phone-holder',
-                    'Phones &amp; Accessories' => 'phone',
-                    'Photo &amp; Cameras' => 'photo-video',
-                    'Photo &amp; Video App' => 'photo-video-app',
-                    'Photo Editing' => 'photo-editing',
-                    'Photo Frame' => 'photo-frame',
-                    'Photo Paper' => 'photo-paper',
-                    'Piano' => 'piano',
-                    'Picnic &amp; Outdoor Cooking' => 'picnic',
-                    'Pikmin 3 Deluxe' => 'pikmin-3-deluxe',
-                    'Pillow' => 'pillow',
-                    'Pimm&#039;s' => 'pimms',
-                    'Pioneer' => 'pioneer',
-                    'Pirate Toys' => 'pirates',
-                    'PIR Lights' => 'pir',
-                    'Pixel C' => 'pixel-c',
-                    'Piz Buin' => 'piz-buin',
-                    'Pizza' => 'pizza',
-                    'Pizza Stone' => 'pizza-stone',
-                    'Planer' => 'planer',
-                    'Planet Earth' => 'planet-earth',
-                    'Plant' => 'plant',
-                    'Plant Pot' => 'plant-pots',
-                    'Plants vs. Zombies: Battle for Neighborville' => 'battle-for-neighborville',
-                    'Plants vs Zombies' => 'plants-vs-zombies',
-                    'Play-Doh' => 'play-doh',
-                    'PlayerUnknown&#039;s Battlegrounds' => 'playerunknown-s-battlegrounds',
-                    'Playhouse' => 'playhouse',
-                    'Playing Cards' => 'playing-cards',
-                    'Playmat' => 'playmat',
-                    'Playmobil' => 'playmobil',
-                    'Playmobil Advent Calendar' => 'playmobil-advent-calendar',
-                    'PlayStation' => 'playstation',
-                    'PlayStation 5 DualSense Controller' => 'ps5-controller',
-                    'PlayStation Accessories' => 'playstation-accessories',
-                    'PlayStation Classic' => 'playstation-classic',
-                    'PlayStation Move' => 'playstation-move',
-                    'PlayStation Now' => 'playstation-now',
-                    'PlayStation Plus' => 'playstation-plus',
-                    'PlayStation VR' => 'playstation-vr',
-                    'PlayStation VR Aim Controller' => 'aim-controller-ps4',
-                    'Pliers' => 'pliers',
-                    'Plumbing &amp; Fittings' => 'plumbing-and-fitting',
-                    'Plus Size' => 'plus-size',
-                    'PNY' => 'pny',
-                    'POCO F2 Pro' => 'poco-f2-pro',
-                    'POCO F3' => 'poco-f3',
-                    'Poco M3' => 'poco-m3',
-                    'POCO X3' => 'poco-x3',
-                    'POCO X3 Pro' => 'poco-x3-pro',
-                    'Pokémon' => 'pokemon',
-                    'Pokémon: Let&#039;s Go' => 'pokemon-lets-go',
-                    'Pokémon Go' => 'pokemon-go',
-                    'Pokemon Sword and Shield' => 'pokemon-sword-and-shield',
-                    'Pokémon Ultra Sun and Ultra Moon' => 'pokemon-ultra-sun-ultra-moon',
-                    'Poker' => 'poker',
-                    'Pokken Tournament' => 'pokken-tournament',
-                    'Polaroid' => 'polaroid',
-                    'Police Toys' => 'police',
-                    'Polo Shirt' => 'polo-shirt',
-                    'Pool' => 'pool',
-                    'Pool &amp; Snooker' => 'pool-table',
-                    'Popcorn' => 'popcorn',
-                    'Pork' => 'pork',
-                    'Porridge &amp; Oats' => 'porridge-and-oats',
-                    'Portable Wireless Speaker' => 'wireless-speaker',
-                    'Poster' => 'poster',
-                    'Pots and Pans' => 'pan',
-                    'Potty' => 'potty',
-                    'Power Bank' => 'power-bank',
-                    'Powerbeats Pro' => 'powerbeats-pro',
-                    'Power Dental Flosser' => 'floss',
-                    'Powerline' => 'powerline',
-                    'Power Rangers' => 'power-rangers',
-                    'Power Tool' => 'power-tool',
-                    'Prada' => 'prada',
-                    'Pram' => 'pram',
-                    'Pregnancy' => 'pregnancy',
-                    'Prescription Glasses' => 'prescription-glasses',
-                    'Pressure Cooker' => 'pressure-cooker',
-                    'Pressure Washer' => 'pressure-washer',
-                    'Price Glitch' => 'price-glitch',
-                    'Prime Gaming' => 'twitch',
-                    'Pringles' => 'pringles',
-                    'Printer &amp; Printer Supplies' => 'printer',
-                    'Printer Supplies' => 'printer-supplies',
-                    'Productivity App' => 'productivity-app',
-                    'Pro Evolution Soccer' => 'pro-evolution-soccer',
-                    'Pro Evolution Soccer 2018' => 'pro-evolution-soccer-2018',
-                    'Pro Evolution Soccer 2019' => 'pro-evolution-soccer-2019',
-                    'Pro Evolution Soccer 2020' => 'pes-2020',
-                    'Project Cars' => 'project-cars',
-                    'Project Cars 2' => 'project-cars-2',
-                    'Projector' => 'projector',
-                    'Protein' => 'protein',
-                    'Protein Bars' => 'protein-bars',
-                    'Protein Shaker' => 'shaker',
-                    'PS4' => 'ps4-slim',
-                    'PS4 Camera' => 'ps4-camera',
-                    'PS4 Controller' => 'ps4-controller',
-                    'PS4 Games' => 'ps4-games',
-                    'PS4 Headset' => 'ps4-headset',
-                    'PS4 Pro' => 'ps4-pro',
-                    'PS5' => 'ps5',
-                    'PS5 Games' => 'ps5-game',
-                    'PSU' => 'psu',
-                    'Public Transport' => 'public-transport',
-                    'Pukka' => 'pukka',
-                    'Pulse Light Epilator' => 'pulse-light-epilator',
-                    'Puma' => 'puma',
-                    'Puma Trainers' => 'puma-trainers',
-                    'Puppy Supplies' => 'puppy',
-                    'Purse' => 'purse',
-                    'Pushchair' => 'pushchair',
-                    'Pushchairs and Strollers' => 'baby-transport',
-                    'Puzzle' => 'puzzle',
-                    'PVR' => 'pvr',
-                    'Pyjamas' => 'pyjamas',
-                    'Pyrex' => 'pyrex',
-                    'Q Acoustics' => 'q-acoustics',
-                    'QNAP' => 'qnap',
-                    'Qualcast' => 'qualcast',
-                    'Quality Street' => 'quality-street',
-                    'Quantum Break' => 'quantum-break',
-                    'Quechua' => 'quechua',
-                    'Quick Charge' => 'quick-charge',
-                    'Quiksilver' => 'quiksilver',
-                    'Quinny' => 'quinny',
-                    'Quorn' => 'quorn',
-                    'Rab' => 'rab',
-                    'Radeon RX 480' => 'rx-480',
-                    'Radeon RX 5700' => 'radeon-rx-5700',
-                    'Radeon RX 5700 XT' => 'radeon-rx-5700-xt',
-                    'Radeon RX 6800' => 'radeon-rx-6800',
-                    'Radeon RX 6800 XT' => 'radeon-rx-6800-xt',
-                    'Radeon RX 6900 XT' => 'radeon-rx-6900-xt',
-                    'Radiator' => 'radiator',
-                    'Radio' => 'radio',
-                    'Radley' => 'radley',
-                    'Rage 2' => 'rage-2',
-                    'Railcard' => 'railcard',
-                    'Rainbow Six' => 'rainbow-six',
-                    'Rake' => 'rake',
-                    'Ralph Lauren' => 'ralph-lauren',
-                    'RAM' => 'ram',
-                    'Raspberry Pi' => 'raspberry-pi',
-                    'Ratchet' => 'ratchet',
-                    'Ratchet and Clank' => 'ratchet-and-clank',
-                    'Rattan Garden Furniture' => 'rattan',
-                    'RAVPower' => 'ravpower',
-                    'Ray Ban' => 'ray-ban',
-                    'Razer' => 'razer',
-                    'Razor' => 'razor',
-                    'Razor Blade' => 'razor-blade',
-                    'Real Madrid' => 'real-madrid',
-                    'Realme Smartphones' => 'realme-smartphone',
-                    'Real Techniques' => 'real-techniques',
-                    'Recliner' => 'recliner',
-                    'ReCore' => 'recore',
-                    'Recreational Sports' => 'recreational-sports',
-                    'Red Bull' => 'red-bull',
-                    'Red Dead Redemption' => 'red-dead-redemption',
-                    'Red Dead Redemption 2' => 'red-dead-redemption-2',
-                    'Redex' => 'redex',
-                    'Red Kite' => 'red-kite',
-                    'Reebok' => 'reebok',
-                    'Reese&#039;s' => 'reeses',
-                    'Regatta' => 'regatta',
-                    'Regina' => 'regina',
-                    'Remington' => 'remington',
-                    'Remote Control Car' => 'remote-control-car',
-                    'Renault' => 'renault',
-                    'Resident Evil' => 'resident-evil',
-                    'Resident Evil 2' => 'resident-evil-2',
-                    'Resident Evil 7' => 'resident-evil-7',
-                    'Restaurant, Café &amp; Pub' => 'restaurant',
-                    'Retailer Offers and Issues' => 'retailer-offers-and-issues',
-                    'Ribena' => 'ribena',
-                    'Rice' => 'rice',
-                    'Rice Cooker' => 'rice-cooker',
-                    'Rick and Morty' => 'rick-and-morty',
-                    'Ricoh' => 'ricoh',
-                    'Ride On' => 'ride-on',
-                    'Ring' => 'ring',
-                    'Ring Door View Cam' => 'ring-door-view-cam',
-                    'Ring Fit Adventures' => 'ring-fit-adventures',
-                    'Ring Stick Up Cam' => 'ring-stick-up-cam',
-                    'Ring Video Doorbell' => 'ring-video-doorbell',
-                    'Ring Video Doorbell 2' => 'ring-video-doorbell-2',
-                    'Ring Video Doorbell 3' => 'ring-video-doorbell-3',
-                    'Ring Video Doorbell Pro' => 'ring-video-doorbell-pro',
-                    'Road Bike' => 'road-bike',
-                    'Roaming' => 'roaming',
-                    'Robinsons' => 'robinsons',
-                    'Robotic Lawnmower' => 'robotic-lawnmower',
-                    'Robot Vacuum Cleaner' => 'robot-vacuum-cleaner',
-                    'Rock Band' => 'rock-band',
-                    'Rocket League' => 'rocket-league',
-                    'Rocking Horse' => 'rocking-horse',
-                    'Rogue One: A Star Wars Story' => 'rogue-one',
-                    'Roku' => 'roku',
-                    'Rolex' => 'rolex',
-                    'Rollerskates' => 'skate',
-                    'Ronseal' => 'ronseal',
-                    'Roof Box' => 'roof-box',
-                    'Roses' => 'roses',
-                    'Rotary' => 'rotary',
-                    'Router' => 'router',
-                    'Rowenta' => 'rowenta',
-                    'RTX 2060' => 'rtx-2060',
-                    'RTX 2070' => 'rtx-2070',
-                    'RTX 2080' => 'rtx-2080',
-                    'RTX 2080 Ti' => 'rtx-2080-ti',
-                    'RTX 3070' => 'rtx-3070',
-                    'RTX 3080' => 'rtx-3080',
-                    'RTX 3090' => 'rtx-3090',
-                    'Rug' => 'rug',
-                    'Rugby' => 'rugby',
-                    'Rum' => 'rum',
-                    'Running' => 'running',
-                    'Running Shoes' => 'running-shoes',
-                    'Russell Hobbs' => 'russell-hobbs',
-                    'RX 570' => 'rx-570',
-                    'RX 580' => 'rx-580',
-                    'RX 590' => 'rx-590',
-                    'RX Vega 56' => 'rx-vega-56',
-                    'RX Vega 64' => 'rx-vega-64',
-                    'Ryanair' => 'ryanair',
-                    'Ryobi' => 'ryobi',
-                    'Safari' => 'safari',
-                    'Safety Boots' => 'safety-boots',
-                    'Sage by Heston Blumenthal' => 'sage',
-                    'Saints Row' => 'saints-row',
-                    'Saitek' => 'saitek',
-                    'Sale' => 'sale',
-                    'Salmon' => 'salmon',
-                    'Salomon' => 'salomon',
-                    'Salter' => 'salter',
-                    'Samsonite' => 'samsonite',
-                    'Samsung' => 'samsung',
-                    'Samsung Ecobubble' => 'ecobubble',
-                    'Samsung Fridge' => 'samsung-fridge',
-                    'Samsung Galaxy' => 'samsung-galaxy',
-                    'Samsung Galaxy A10' => 'samsung-galaxy-a10',
-                    'Samsung Galaxy A20e' => 'samsung-galaxy-a20e',
-                    'Samsung Galaxy A40' => 'samsung-galaxy-a40',
-                    'Samsung Galaxy A42 5G' => 'samsung-galaxy-a42-5g',
-                    'Samsung Galaxy A50' => 'samsung-galaxy-a50',
-                    'Samsung Galaxy A51' => 'samsung-galaxy-a51',
-                    'Samsung Galaxy A52 5G' => 'samsung-galaxy-a52',
-                    'Samsung Galaxy A60' => 'samsung-galaxy-a60',
-                    'Samsung Galaxy A70' => 'samsung-galaxy-a70',
-                    'Samsung Galaxy A71' => 'samsung-galaxy-a71',
-                    'Samsung Galaxy A72' => 'samsung-galaxy-a72',
-                    'Samsung Galaxy A80' => 'samsung-galaxy-a80',
-                    'Samsung Galaxy A90' => 'samsung-galaxy-a90',
-                    'Samsung Galaxy Buds' => 'samsung-galaxy-buds',
-                    'Samsung Galaxy Buds+' => 'samsung-galaxy-buds-plus',
-                    'Samsung Galaxy Buds Live' => 'samsung-galaxy-buds-live',
-                    'Samsung Galaxy Buds Pro' => 'samsung-galaxy-buds-pro',
-                    'Samsung Galaxy Fold' => 'samsung-galaxy-fold',
-                    'Samsung Galaxy J5' => 'galaxy-j5',
-                    'Samsung Galaxy Note' => 'samsung-galaxy-note',
-                    'Samsung Galaxy Note 8' => 'samsung-galaxy-note-8',
-                    'Samsung Galaxy Note 9' => 'samsung-galaxy-note-9',
-                    'Samsung Galaxy Note 10' => 'samsung-galaxy-note-10',
-                    'Samsung Galaxy Note 10+' => 'samsung-galaxy-note-10-plus',
-                    'Samsung Galaxy Note20' => 'samsung-galaxy-note20',
-                    'Samsung Galaxy Note20 Ultra' => 'samsung-galaxy-note20-ultra',
-                    'Samsung Galaxy S6' => 'samsung-galaxy-s6',
-                    'Samsung Galaxy S7' => 'samsung-galaxy-s7',
-                    'Samsung Galaxy S7 Edge' => 'samsung-galaxy-s7-edge',
-                    'Samsung Galaxy S8' => 'samsung-galaxy-s8',
-                    'Samsung Galaxy S8+' => 'samsung-s8-plus',
-                    'Samsung Galaxy S9' => 'samsung-galaxy-s9',
-                    'Samsung Galaxy S9 Plus' => 'samsung-s9-plus',
-                    'Samsung Galaxy S10' => 'samsung-galaxy-s10',
-                    'Samsung Galaxy S10 Lite' => 'samsung-galaxy-s10-lite',
-                    'Samsung Galaxy S10 Plus' => 'samsung-galaxy-s10-plus',
-                    'Samsung Galaxy S10e' => 'samsung-galaxy-s10e',
-                    'Samsung Galaxy S20' => 'samsung-galaxy-s20',
-                    'Samsung Galaxy S20 FE' => 'samsung-galaxy-s20-fe',
-                    'Samsung Galaxy S20 Ultra' => 'samsung-galaxy-s20-ultra',
-                    'Samsung Galaxy S20+' => 'samsung-galaxy-s20-plus',
-                    'Samsung Galaxy S21 5G' => 'samsung-galaxy-s21-5g',
-                    'Samsung Galaxy S21 Ultra 5G' => 'samsung-galaxy-s21-ultra-5g',
-                    'Samsung Galaxy S21+ 5G' => 'samsung-galaxy-s21-plus-5g',
-                    'Samsung Galaxy Tab' => 'samsung-galaxy-tab',
-                    'Samsung Galaxy Tab A' => 'samsung-galaxy-tab-a',
-                    'Samsung Galaxy Tab A7' => 'samsung-galaxy-tab-a7',
-                    'Samsung Galaxy Tab S' => 'samsung-galaxy-tab-s',
-                    'Samsung Galaxy Tab S4' => 'samsung-galaxy-tab-s4',
-                    'Samsung Galaxy Tab S5e' => 'samsung-galaxy-tab-s5e',
-                    'Samsung Galaxy Tab S6' => 'samsung-galaxy-tab-s6',
-                    'Samsung Galaxy Watch' => 'samsung-galaxy-watch',
-                    'Samsung Galaxy Watch3' => 'samsung-galaxy-watch3',
-                    'Samsung Galaxy Watch Active2' => 'samsung-galaxy-watch-active-2',
-                    'Samsung Gear' => 'samsung-gear',
-                    'Samsung Gear S3' => 'gear-s3',
-                    'Samsung Gear VR' => 'samsung-gear-vr',
-                    'Samsung Headphones' => 'samsung-headphones',
-                    'Samsung Monitor' => 'samsung-monitor',
-                    'Samsung QLED TVs' => 'samsung-qled-tv',
-                    'Samsung Smartphone' => 'samsung-smartphone',
-                    'Samsung SSD' => 'samsung-ssd',
-                    'Samsung The Frame TV' => 'samsung-the-frame',
-                    'Samsung TV' => 'samsung-tv',
-                    'Samsung Washing Machine' => 'samsung-washing-machine',
-                    'Samsung Watch' => 'samsung-watch',
-                    'Sandals' => 'sandals',
-                    'Sander' => 'sander',
-                    'SanDisk' => 'sandisk',
-                    'SanDisk SSD' => 'sandisk-ssd',
-                    'Sand Pit' => 'sand-pit',
-                    'Sandwich Maker' => 'sandwich',
-                    'San Miguel' => 'san-miguel',
-                    'Santander' => 'santander',
-                    'Satchel' => 'satchel',
-                    'Sat Nav' => 'sat-nav',
-                    'Sauce' => 'sauce',
-                    'Saw' => 'saw',
-                    'Scalextric' => 'scalextric',
-                    'Scanner' => 'scanner',
-                    'School Bag' => 'school-bag',
-                    'School Supplies' => 'school',
-                    'School Uniform' => 'school-uniform',
-                    'Schwalbe' => 'schwalbe',
-                    'Scooby Doo' => 'scooby-doo',
-                    'Scooter' => 'scooter',
-                    'Scotch Whisky' => 'scotch',
-                    'Scrabble' => 'scrabble',
-                    'Screen Protector' => 'screen-protector',
-                    'Screenwash' => 'screenwash',
-                    'Screwdriver' => 'screwdriver',
-                    'Screws' => 'screws',
-                    'SD Cards' => 'sd-card',
-                    'SDHC' => 'sdhc',
-                    'SDXC' => 'sdxc',
-                    'Seagate' => 'seagate',
-                    'Sea Life' => 'sea-life',
-                    'Sea of Thieves' => 'sea-of-thieves',
-                    'Season Pass' => 'season-pass',
-                    'Seaworld' => 'seaworld',
-                    'Security Camera' => 'security-camera',
-                    'Seeds &amp; Bulbs' => 'seeds-and-bulbs',
-                    'Sega' => 'sega',
-                    'SEGA Mega Drive Mini' => 'sega-mega-drive-mini',
-                    'Segway' => 'segway',
-                    'Seiko' => 'seiko',
-                    'Sekiro: Shadows Die Twice' => 'sekiro',
-                    'Sekonda' => 'sekonda',
-                    'Selfie Stick' => 'selfie-stick',
-                    'Sennheiser' => 'sennheiser',
-                    'Sennheiser Headphones' => 'sennheiser-headphones',
-                    'Sensodyne' => 'sensodyne',
-                    'Server' => 'server',
-                    'Services &amp; Contracts' => 'services-contracts',
-                    'Services and Subscriptions' => 'service-contract',
-                    'Sewing' => 'sewing',
-                    'Sewing Machine' => 'sewing-machine',
-                    'Sex Toys' => 'sex-toys',
-                    'Shadow of the Tomb Raider' => 'shadow-of-the-tomb-raider',
-                    'Shampoo' => 'shampoo',
-                    'Shark' => 'shark',
-                    'Shark DuoClean' => 'shark-duoclean',
-                    'Shark Vacuum Cleaner' => 'shark-vacuum-cleaner',
-                    'Sharp' => 'sharp',
-                    'Sharpener' => 'sharpener',
-                    'Sharpie' => 'sharpie',
-                    'Shaver' => 'shaver',
-                    'Shaving &amp; Beard Care' => 'shaving',
-                    'Shaving, Trimming, &amp; Hair Removal' => 'hair-removal',
-                    'Shaving Foam' => 'shaving-foam',
-                    'Shears' => 'shears',
-                    'Sheba' => 'sheba',
-                    'Shed' => 'shed',
-                    'Shelter' => 'shelter',
-                    'Shelves' => 'shelves',
-                    'Shenmue I &amp; II' => 'shenmue-one-and-two',
-                    'Shenmue III' => 'shenmue-3',
-                    'Shenmue Series' => 'shenmue-series',
-                    'Shimano' => 'shimano',
-                    'Shirt' => 'shirt',
-                    'Shoe Rack' => 'shoe-rack',
-                    'Shoes' => 'shoe',
-                    'Shopkins' => 'shopkins',
-                    'Shortbread' => 'shortbread',
-                    'Shorts' => 'shorts',
-                    'Short Trip' => 'break',
-                    'Shoulder Bag' => 'shoulder-bag',
-                    'Shovel' => 'shovel',
-                    'Shower Curtain' => 'shower-curtain',
-                    'Shower Enclosure' => 'shower-enclosure',
-                    'Shower Fittings' => 'shower',
-                    'Shower Gel' => 'shower-gel',
-                    'Shower Head' => 'shower-head',
-                    'Shredder' => 'shredder',
-                    'Side-by-Side-Fridge' => 'side-by-side-fridge',
-                    'Sideboard' => 'sideboard',
-                    'Sid Meier&#039;s Civilization VI' => 'civilization-vi',
-                    'Siemens' => 'siemens',
-                    'Siemens Washing Machine' => 'siemens-washing-machine',
-                    'Sigma' => 'sigma',
-                    'Silentnight' => 'silentnight',
-                    'Silvercrest' => 'silvercrest',
-                    'Silver Cross' => 'silver-cross',
-                    'Sim Free' => 'sim-free',
-                    'Sim Only' => 'sim-only',
-                    'Simplehuman' => 'simplehuman',
-                    'Simpsons' => 'simpsons',
-                    'Single Malt' => 'single-malt',
-                    'Sink' => 'sink',
-                    'Sistema' => 'sistema',
-                    'Skateboard' => 'skateboard',
-                    'Skating' => 'skating',
-                    'Skechers' => 'skechers',
-                    'Skiing' => 'ski',
-                    'Skin Care' => 'skincare',
-                    'Skittles' => 'skittles',
-                    'Skoda' => 'skoda',
-                    'Skullcandy' => 'skullcandy',
-                    'Sky' => 'sky',
-                    'Sky Cinema' => 'sky-cinema',
-                    'Skylanders' => 'skylanders',
-                    'Skylanders Battlecast' => 'skylanders-battlecast',
-                    'Skylanders Imaginators' => 'skylanders-imaginators',
-                    'Sleeping Bag' => 'sleeping-bag',
-                    'Sleeping Dogs' => 'sleeping-dogs',
-                    'Sleepwear' => 'sleepwear',
-                    'Slide' => 'slide',
-                    'Slimming World' => 'slimming-world',
-                    'Slippers' => 'slippers',
-                    'Slow Cooker' => 'slow-cooker',
-                    'Smart Clock' => 'clock',
-                    'Smart Doorbells' => 'smart-doorbell',
-                    'Smart Home' => 'smart-home',
-                    'Smart Light' => 'smart-light',
-                    'Smart Lock' => 'smart-lock',
-                    'Smartphone Accessories' => 'smartphone-accessories',
-                    'Smartphone Case' => 'smartphone-case',
-                    'Smartphone under £200' => 'smartphone-under-200-pounds',
-                    'Smartphone under £400' => 'smartphone-under-400-pounds',
-                    'Smart Plugs' => 'smart-plugs',
-                    'Smart Speaker' => 'smart-speaker',
-                    'Smart Tech &amp; Gadgets' => 'smart-tech',
-                    'Smart Thermostat' => 'thermostat',
-                    'SmartThings' => 'smartthings',
-                    'Smart TV' => 'smart-tv',
-                    'Smart Watch' => 'smartwatch',
-                    'Smeg' => 'smeg',
-                    'Smirnoff' => 'smirnoff',
-                    'Smoke Alarm' => 'smoke-alarm',
-                    'Smoothie' => 'smoothie',
-                    'Smoothie Maker' => 'smoothie-maker',
-                    'Snacks' => 'snacks',
-                    'Sneakers' => 'sneakers',
-                    'SNES Nintendo Classic Mini' => 'snes-nintendo-classic',
-                    'Snickers' => 'snickers',
-                    'Sniper Elite' => 'sniper-elite',
-                    'Snowboard' => 'snowboard',
-                    'Snow Boots' => 'snow-boots',
-                    'Soap' => 'soap',
-                    'Soap and Glory' => 'soap-and-glory',
-                    'Socket Set' => 'socket-set',
-                    'Socks' => 'socks',
-                    'SodaStream' => 'soda-stream',
-                    'Sofa' => 'sofa',
-                    'Soft Drinks' => 'soft-drinks',
-                    'Soft Toy' => 'soft-toy',
-                    'Software' => 'software',
-                    'Software &amp; Apps' => 'software-apps',
-                    'Solar Lights' => 'solar-lights',
-                    'Soldering Iron' => 'soldering',
-                    'Sonic' => 'sonic',
-                    'Sonos' => 'sonos',
-                    'Sonos Beam' => 'sonos-beam',
-                    'Sonos Move' => 'sonos-move',
-                    'Sonos One' => 'sonos-one',
-                    'Sonos PLAY:1' => 'sonos-play-1',
-                    'Sonos PLAY:3' => 'sonos-play-3',
-                    'Sonos PLAY:5' => 'sonos-play-5',
-                    'Sonos PLAYBAR' => 'sonos-playbar',
-                    'Sonos PLAYBASE' => 'sonos-playbase',
-                    'Sony' => 'sony',
-                    'Sony Camera' => 'sony-camera',
-                    'Sony Headphones' => 'sony-headphones',
-                    'Sony Pulse 3D Wireless Headset' => 'pulse-3d-wireless-headsets',
-                    'Sony TV' => 'sony-tv',
-                    'Sony WF-1000XM3' => 'sony-wf1000xm3',
-                    'Sony WH-1000XM3' => 'sony-wh-1000xm3',
-                    'Sony WH-1000XM4' => 'sony-wh1000xm4',
-                    'Sony Xperia' => 'xperia',
-                    'Sony Xperia 5' => 'sony-xperia-5',
-                    'Sony Xperia 10' => 'sony-xperia-10',
-                    'Sony Xperia Xa' => 'sony-xperia-xa',
-                    'Sony Xperia Z3' => 'xperia-z3',
-                    'Sony Xperia Z5' => 'xperia-z5',
-                    'Soulcalibur' => 'soulcalibur',
-                    'Soundbar' => 'soundbar',
-                    'Soundbase' => 'soundbase',
-                    'Sound Card' => 'sound-card',
-                    'Soundmagic' => 'soundmagic',
-                    'Soup' => 'soup',
-                    'Soup Maker' => 'soup-maker',
-                    'Sous-Vide' => 'sousvide',
-                    'Southern Comfort' => 'southern-comfort',
-                    'South Park' => 'south-park',
-                    'Spa' => 'spa',
-                    'Spade' => 'spade',
-                    'Spanner' => 'spanner',
-                    'Speaker' => 'speakers',
-                    'Specialized' => 'specialized',
-                    'Speedo' => 'speedo',
-                    'Sphero' => 'sphero',
-                    'Spice Rack' => 'spice-rack',
-                    'Spiderman' => 'spiderman',
-                    'Spiralizer' => 'spiralizer',
-                    'Spirit &amp; Liqueur' => 'spirits',
-                    'Spirit Level' => 'spirit-level',
-                    'Splatoon' => 'splatoon',
-                    'Sports &amp; Outdoors' => 'sports-fitness',
-                    'Sports Events' => 'sports-events',
-                    'Sports Nutrition' => 'nutrition',
-                    'Spreads' => 'spreads',
-                    'Spyro Reignited Trilogy' => 'spyro-reignited-trilogy',
-                    'SSD' => 'ssd',
-                    'SSHD' => 'sshd',
-                    'Staedtler' => 'staedtler',
-                    'Stair Gate' => 'stair-gate',
-                    'Stanley' => 'stanley',
-                    'Stapler' => 'stapler',
-                    'Starbucks' => 'starbucks',
-                    'Starlink: Battle for Atlas' => 'starlink-battle-for-atlas',
-                    'Star Ocean' => 'star-ocean',
-                    'Star Trek' => 'star-trek',
-                    'Star Wars' => 'star-wars',
-                    'Star Wars: Battlefront' => 'star-wars-battlefront',
-                    'Star Wars: Battlefront II' => 'star-wars-battlefront-2',
-                    'Star Wars: Squadrons' => 'star-wars-squadrons',
-                    'Star Wars Jedi: Fallen Order' => 'star-wars-jedi-fallen-order',
-                    'Stationery' => 'stationery',
-                    'Stationery &amp; Office Supplies' => 'stationery-office-supplies',
-                    'Staycation' => 'staycation',
-                    'Steak' => 'steak',
-                    'Steam Cleaner' => 'steam-cleaner',
-                    'Steam Controller' => 'steam-controller',
-                    'Steamer' => 'steamer',
-                    'Steam Gaming' => 'steam',
-                    'Steam Iron' => 'steam-iron',
-                    'Steam Link' => 'steam-link',
-                    'Steam Mop' => 'steam-mop',
-                    'SteelSeries' => 'steelseries',
-                    'Steering Wheel' => 'steering-wheel',
-                    'Stella' => 'stella',
-                    'Stool' => 'stool',
-                    'Storage Box' => 'storage-box',
-                    'Stormtrooper' => 'stormtrooper',
-                    'Straightener' => 'straightener',
-                    'Streaming' => 'streaming',
-                    'Street Fighter' => 'street-fighter',
-                    'Street Fighter V' => 'street-fighter-v',
-                    'Streetwear' => 'streetwear',
-                    'Strimmer' => 'strimmer',
-                    'Strongbow' => 'strongbow',
-                    'Student Discount' => 'student-discount',
-                    'Subwoofer' => 'subwoofer',
-                    'Suitcase' => 'suitcase',
-                    'Suncare' => 'suncare',
-                    'Sun Cream' => 'sun-cream',
-                    'Sunglasses' => 'sunglasses',
-                    'Superdry' => 'superdry',
-                    'Superfast Broadband' => 'superfast-broadband',
-                    'Superking' => 'superking',
-                    'Super Mario' => 'mario',
-                    'Super Mario 3D All-Stars' => 'super-mario-3d-all-stars',
-                    'Super Mario 3D World' => 'super-mario-3d-world',
-                    'Super Mario Maker 2' => 'super-mario-maker-2',
-                    'Super Mario Odyssey' => 'super-mario-odyssey',
-                    'Super Mario Party' => 'mario-party',
-                    'Supermarket' => 'supermarket',
-                    'Super Smash Bros.' => 'super-smash-bros',
-                    'Surf' => 'surf',
-                    'Swarovski' => 'swarovski',
-                    'Sweets' => 'sweets',
-                    'Swimming' => 'swimming',
-                    'Swimming Goggles' => 'goggles',
-                    'Swimwear' => 'swimwear',
-                    'Swing' => 'swing',
-                    'Swingball' => 'swingball',
-                    'Syberia' => 'syberia',
-                    'Sylvanian' => 'sylvanian',
-                    'Synology' => 'synology',
-                    'T-Mobile' => 't-mobile',
-                    'T-Shirt' => 't-shirt',
-                    'Table Lamp' => 'table-lamp',
-                    'Tablet' => 'tablet',
-                    'Tablet Accessories' => 'tablet-accessories',
-                    'Table Tennis' => 'table-tennis',
-                    'Tableware' => 'tableware',
-                    'Tacx' => 'tacx',
-                    'Tado' => 'tado',
-                    'Tag Heuer' => 'tag-heuer',
-                    'Takeaway and Food Delivery' => 'takeaway',
-                    'Tales of Vesperia: Definitive Edition' => 'tales-of-vesperia-definitive-edition',
-                    'Talisker' => 'talisker',
-                    'Talkmobile' => 'talkmobile',
-                    'Tamron' => 'tamron',
-                    'Tangle Teezer' => 'tangle-teezer',
-                    'Tank Top' => 'tank-top',
-                    'Tannoy' => 'tannoy',
-                    'Tanqueray' => 'tanqueray',
-                    'Tape' => 'tape',
-                    'Tassimo' => 'tassimo',
-                    'Tassimo Coffee Machine' => 'tassimo-coffee-machine',
-                    'tastecard' => 'tastecard',
-                    'Taxi' => 'taxi',
-                    'Tea' => 'tea',
-                    'Team Sonic Racing' => 'team-sonic-racing',
-                    'Team Sports' => 'team-sports',
-                    'Teapot' => 'teapot',
-                    'Technika' => 'technika',
-                    'Techwood' => 'techwood',
-                    'Ted Baker' => 'ted-baker',
-                    'Teddy Bear' => 'teddy-bear',
-                    'Teenage Mutant Ninja Turtles' => 'turtle',
-                    'Teeth Care' => 'teeth-care',
-                    'Teeth Whitening' => 'teeth-whitening',
-                    'Tefal' => 'tefal',
-                    'Tefal Actifry' => 'actifry',
-                    'Tefal Pan' => 'tefal-pan',
-                    'Tekken' => 'tekken',
-                    'Tekken 7' => 'tekken-7',
-                    'Telegraph' => 'telegraph',
-                    'Telescope' => 'telescope',
-                    'Telltale' => 'telltale',
-                    'Tennis' => 'tennis',
-                    'Tent' => 'tent',
-                    'Tequila' => 'tequila',
-                    'Tesco Clothing' => 'tesco-clothing',
-                    'Tesla' => 'tesla',
-                    'Tetris' => 'tetris',
-                    'Tetris 99' => 'tetris-99',
-                    'Theatre &amp; Musical' => 'theatre',
-                    'The Beatles' => 'beatles',
-                    'The Big Bang Theory' => 'big-bang-theory',
-                    'The Crew' => 'the-crew',
-                    'The Dark Pictures: Anthology Man of Medan' => 'the-dark-pictures-anthology-man-of-medan',
-                    'The Elder Scrolls' => 'elder-scrolls',
-                    'The Elder Scrolls V: Skyrim' => 'skyrim',
-                    'The Evil Within' => 'the-evil-within',
-                    'The Evil Within 2' => 'the-evil-within-2',
-                    'The Last Guardian' => 'the-last-guardian',
-                    'The Last of Us' => 'the-last-of-us',
-                    'The Last of Us Part II' => 'the-last-of-us-part-2',
-                    'The Legend of Zelda' => 'zelda',
-                    'The Legend of Zelda: Breath of the Wild' => 'zelda-breath-of-the-wild',
-                    'The Legend of Zelda: Link&#039;s Awakening' => 'the-legend-of-zelda-links-awakening',
-                    'The Legend of Zelda: Skyward Sword HD' => 'the-legend-of-zelda-skyward-sword-hd',
-                    'Theme Park' => 'theme-park',
-                    'The North Face' => 'north-face',
-                    'The Outer Worlds' => 'the-outer-worlds',
-                    'Thermos Storage' => 'thermos',
-                    'The Sims' => 'sims',
-                    'The Sims 4' => 'the-sims-4',
-                    'The Sinking City' => 'the-sinking-city',
-                    'The Sun' => 'the-sun',
-                    'The Sunday Times' => 'sunday-times',
-                    'The Walking Dead' => 'walking-dead',
-                    'The Witcher' => 'witcher',
-                    'The Witcher 3' => 'the-witcher-3',
-                    'Thierry Mugler' => 'thierry-mugler',
-                    'Thomas Sabo' => 'thomas-sabo',
-                    'Thomas The Tank Engine' => 'thomas-the-tank',
-                    'Thornton&#039;s' => 'thorntons',
-                    'Thorpe Park' => 'thorpe-park',
-                    'Throw' => 'throw',
-                    'Thrustmaster' => 'thrustmaster',
-                    'Thule' => 'thule',
-                    'Tickets &amp; Shows' => 'tickets-shows',
-                    'Tie' => 'tie',
-                    'Tights' => 'tights',
-                    'TIGI' => 'tigi',
-                    'Tilda' => 'tilda',
-                    'Tile' => 'tile',
-                    'Timberland' => 'timberland',
-                    'Timex' => 'timex',
-                    'Tissot' => 'tissot',
-                    'Tissues' => 'tissues',
-                    'Titanfall' => 'titanfall',
-                    'Titanfall 2' => 'titanfall-2',
-                    'Toaster' => 'toaster',
-                    'Toblerone' => 'toblerone',
-                    'Toddler Bed' => 'toddler-bed',
-                    'Toilet Brush' => 'brush',
-                    'Toilet Cleaner' => 'toilet',
-                    'Toilet Roll' => 'toilet-roll',
-                    'Toilet Seat' => 'toilet-seat',
-                    'Tokyo Laundry' => 'tokyo-laundry',
-                    'Tomb Raider' => 'tomb-raider',
-                    'Tom Clancy&#039;s' => 'tom-clancy',
-                    'Tom Clancy&#039;s: Ghost Recon' => 'ghost-recon',
-                    'Tom Clancy&#039;s Ghost Recon: Wildlands' => 'ghost-recon-wildlands',
-                    'Tom Clancy&#039;s Ghost Recon Breakpoint' => 'tom-clancys-ghost-recon-breakpoint',
-                    'Tom Clancy&#039;s The Division' => 'tom-clancy-the-division',
-                    'Tom Clancy&#039;s The Division 2' => 'tom-clancy-the-division-2',
-                    'Tom Ford' => 'tom-ford',
-                    'Tommee Tippee' => 'tommee-tippee',
-                    'Tommy Hilfiger' => 'tommy-hilfiger',
-                    'Toms' => 'toms',
-                    'TomTom' => 'tomtom',
-                    'Tonic Water' => 'tonic-water',
-                    'Tony Hawk&#039;s Pro Skater 1 + 2' => 'tony-hawks-pro-skater-1-2',
-                    'Tools' => 'tool',
-                    'Toothbrush' => 'toothbrush',
-                    'Toothpaste' => 'toothpaste',
-                    'Torch' => 'torch',
-                    'Torque Wrench' => 'torque-wrench',
-                    'Toshiba' => 'toshiba',
-                    'Toshiba Laptop' => 'toshiba-laptop',
-                    'Toshiba TV' => 'toshiba-tv',
-                    'Total War' => 'total-war',
-                    'Tottenham Hotspur F. C.' => 'tottenham',
-                    'Towel' => 'towel',
-                    'Toy Box' => 'toy-box',
-                    'Toy Cars' => 'toy-cars',
-                    'Toy Castle' => 'castle',
-                    'Toy Digger' => 'digger',
-                    'Toy Helicopter' => 'helicopter',
-                    'Toy Kitchen' => 'toy-kitchen',
-                    'Toy Mask' => 'mask',
-                    'Toyota' => 'toyota',
-                    'Toys' => 'toy',
-                    'Toy Story' => 'toy-story',
-                    'Toy Tractor' => 'tractor',
-                    'Toy Train' => 'train',
-                    'TP-Link' => 'tp-link',
-                    'TP-Link Archer' => 'archer',
-                    'TP-Link Router' => 'tp-link-router',
-                    'Tracksuit' => 'tracksuit',
-                    'Trainers' => 'trainers',
-                    'Trains &amp; Buses' => 'train-and-bus-ticket',
-                    'Train Ticket' => 'train-ticket',
-                    'Trampoline' => 'trampoline',
-                    'Transcend' => 'transcend',
-                    'Transformers' => 'transformers',
-                    'Travel' => 'travel',
-                    'Travel App' => 'travel-app',
-                    'Travel Insurance' => 'travel-insurance',
-                    'Travelodge' => 'travelodge',
-                    'Travel System' => 'travel-system',
-                    'Treadmill' => 'treadmill',
-                    'TRESemmé' => 'tresemme',
-                    'Trespass' => 'trespass',
-                    'Triathlon' => 'triathlon',
-                    'Trike' => 'trike',
-                    'Trine 4' => 'trine-4',
-                    'Tripod' => 'tripod',
-                    'Tripp' => 'tripp',
-                    'Triton Shower' => 'triton',
-                    'Trolley Bag' => 'trolley',
-                    'Tropico 5' => 'tropico-5',
-                    'Tropico 6' => 'tropico-6',
-                    'Tropico Series' => 'tropico-deals',
-                    'Trousers' => 'trousers',
-                    'True Wireless Earbuds' => 'wireless-earphones',
-                    'Trunki' => 'trunki',
-                    'Tumble Dryer' => 'tumble-dryer',
-                    'Tuna' => 'tuna',
-                    'Turbo Trainer' => 'turbo-trainer',
-                    'Turntable' => 'turntable',
-                    'Turtle Beach' => 'turtle-beach',
-                    'TV' => 'tv',
-                    'TV &amp; Video' => 'tv-video',
-                    'TV Accessories' => 'tv-accessories',
-                    'TV Mount' => 'tv-mount',
-                    'TV Series' => 'tv-series',
-                    'TV Stand' => 'tv-stand',
-                    'Twinings' => 'twinings',
-                    'Twin Peaks' => 'twin-peaks',
-                    'Twix' => 'twix',
-                    'Typhoo' => 'typhoo',
-                    'Tyres' => 'tyres',
-                    'Ubisoft' => 'ubisoft',
-                    'UE BOOM' => 'ue-boom',
-                    'UE Boom 2' => 'ue-boom-2',
-                    'UEFA' => 'uefa',
-                    'UE Megablast' => 'ue-megablast',
-                    'UE Megaboom' => 'ue-megaboom',
-                    'UGG' => 'ugg',
-                    'Ulefone' => 'ulefone',
-                    'Ultrabook' => 'ultrabook',
-                    'Ultrawide Monitor' => 'ultrawide',
-                    'Umbrella' => 'umbrella',
-                    'UMI' => 'umidigi',
-                    'Uncharted' => 'uncharted',
-                    'Uncharted 4: A Thief&#039;s End' => 'uncharted-4',
-                    'Uncharted: The Lost Legacy' => 'uncharted-the-lost-legacy',
-                    'Under Armour' => 'under-armour',
-                    'Underwear' => 'underwear',
-                    'Unicorn' => 'unicorn',
-                    'UNiDAYS' => 'unidays',
-                    'Universal Remote' => 'universal-remote',
-                    'Uno' => 'uno',
-                    'Uplay' => 'uplay',
-                    'Urban Decay' => 'urban-decay',
-                    'Urban Sports' => 'urban-sports',
-                    'USB Cable' => 'usb-cable',
-                    'USB Hub' => 'usb-hub',
-                    'USB Memory Stick' => 'flash-drive',
-                    'USB Type C' => 'usb-type-c',
-                    'USN' => 'usn',
-                    'Vacuum Cleaner' => 'vacuum-cleaners',
-                    'Vacuum Flask' => 'flask',
-                    'Valkyria Chronicles' => 'valkyria-chronicles',
-                    'Valkyria Chronicles 4' => 'valkyria-chronicles-4',
-                    'Vango' => 'vango',
-                    'Vanish' => 'vanish',
-                    'Vans' => 'vans',
-                    'Vans Old Skool' => 'vans-old-skool',
-                    'Vans Shoes' => 'vans-shoes',
-                    'Vase' => 'vase',
-                    'Vaseline' => 'vaseline',
-                    'Vauxhall' => 'vauxhall',
-                    'VAX' => 'vax',
-                    'Vax Blade' => 'vax-blade',
-                    'Vax Vacuum Cleaner' => 'vax-vacuum',
-                    'Veet' => 'veet',
-                    'Vega 7' => 'vega-7',
-                    'Vegetables' => 'vegetables',
-                    'Vegetarian' => 'vegetarian',
-                    'Vehicles' => 'vehicles',
-                    'Velvet Comfort' => 'velvet',
-                    'Vera Wang' => 'vera-wang',
-                    'Verbatim' => 'verbatim',
-                    'Versace' => 'versace',
-                    'Vibrator' => 'vibrator',
-                    'Victorinox' => 'victorinox',
-                    'Video Games' => 'videogame',
-                    'Video Streaming' => 'video-streaming',
-                    'Viktor &amp; Rolf Spicebomb' => 'spicebomb',
-                    'Vileda' => 'vileda',
-                    'Villeroy &amp; Boch' => 'villeroy-boch',
-                    'Viners' => 'viners',
-                    'Vinyl' => 'vinyl',
-                    'Virgin' => 'virgin',
-                    'Vitamins &amp; Supplements' => 'vitamins',
-                    'Vitamix' => 'vitamix',
-                    'Vodafone' => 'vodafone',
-                    'Vodka' => 'vodka',
-                    'Volvo' => 'volvo',
-                    'VPN' => 'vpn',
-                    'VR Headset' => 'vr-headset',
-                    'VTech' => 'vtech',
-                    'VTech Toot Toot' => 'toot-toot',
-                    'Vue' => 'vue',
-                    'VW' => 'vw',
-                    'Wacom' => 'wacom',
-                    'Waffle Maker' => 'waffle-maker',
-                    'Wahl' => 'wahl',
-                    'Walkers' => 'walkers',
-                    'Walking Boots' => 'walking-boots',
-                    'Wall Art' => 'wall-art',
-                    'Wallet' => 'wallet',
-                    'Wallpaper' => 'wallpaper',
-                    'Wardrobe' => 'wardrobe',
-                    'Warhammer' => 'warhammer',
-                    'Washbag' => 'washbag',
-                    'Washer Dryer' => 'washer-dryer',
-                    'Washing Machine' => 'washing-machine',
-                    'Washing Powder' => 'washing-powder',
-                    'Watch' => 'watch',
-                    'Watch Dogs' => 'watch-dogs',
-                    'Watch Dogs 2' => 'watch-dogs-2',
-                    'Watch Dogs: Legion' => 'watch-dogs-legion',
-                    'Water Bottle' => 'water-bottle',
-                    'Water Butt' => 'water-butt',
-                    'Water Dispenser' => 'water-dispenser',
-                    'Water Filter' => 'water-filter',
-                    'Water Gun' => 'water-gun',
-                    'Waterproof Camera' => 'waterproof-camera',
-                    'Waterproof Jacket' => 'waterproof-jacket',
-                    'Watersports' => 'watersport',
-                    'Water Toys' => 'water-toys',
-                    'Wayfarer' => 'wayfarer',
-                    'WD40' => 'wd40',
-                    'Wearable' => 'wearable',
-                    'Weather Station' => 'weather-station',
-                    'Webcam' => 'webcam',
-                    'Weber' => 'weber',
-                    'Web Hosting' => 'web-hosting',
-                    'Wedding' => 'wedding',
-                    'Weed Killer' => 'weed',
-                    'Weekend Break' => 'weekend-break',
-                    'Weetabix' => 'weetabix',
-                    'Weightlifting' => 'weightlifting',
-                    'Weight Watchers' => 'weight-watchers',
-                    'Wellies' => 'wellies',
-                    'Wellness and Health' => 'wellness-and-health',
-                    'Wenger' => 'wenger',
-                    'Western Digital' => 'western-digital',
-                    'Wetsuit' => 'wetsuit',
-                    'Wheelbarrow' => 'wheelbarrow',
-                    'Wheelchair' => 'wheelchair',
-                    'Whey' => 'whey',
-                    'Whiskas' => 'whiskas',
-                    'Whisky' => 'whisky',
-                    'Whole Home Mesh Wi-Fi System' => 'whole-home-mesh-wifi-system',
-                    'Wi-Fi Camera' => 'wifi-camera',
-                    'Wi-Fi Dongle' => 'dongle',
-                    'Wi-Fi Extender' => 'wifi-extender',
-                    'Wii' => 'wii',
-                    'Wii Game' => 'wii-games',
-                    'Wii U Game' => 'wii-u-game',
-                    'Wii U Pro Controller' => 'wii-u-pro-controller',
-                    'Wild Turkey' => 'wild-turkey',
-                    'Wileyfox' => 'wileyfox',
-                    'Wilkinson Sword Hydro 5' => 'hydro-5',
-                    'Wilkinson Sword Razor' => 'wilkinson-sword',
-                    'Wimbledon Tennis' => 'wimbledon',
-                    'Window Cleaner' => 'window-cleaner',
-                    'Windows' => 'windows',
-                    'Windows 8' => 'windows-8',
-                    'Windows 10' => 'windows-10',
-                    'Wine' => 'wine',
-                    'Wine Advent Calendar' => 'wine-advent-calendar',
-                    'Wine Glasses' => 'wine-glasses',
-                    'Winter Jacket' => 'winter-jacket',
-                    'Wiper Blades' => 'wiper-blades',
-                    'Wireless Adapter' => 'wireless-adapter',
-                    'Wireless Charger' => 'wireless-charger',
-                    'Wireless Controller' => 'wireless-controller',
-                    'Wireless Headphones' => 'wireless-headphones',
-                    'Wireless Headset' => 'wireless-headset',
-                    'Wireless Keyboard' => 'wireless-keyboard',
-                    'Wireless Mouse' => 'wireless-mouse',
-                    'Wok' => 'wok',
-                    'Wolfenstein' => 'wolfenstein',
-                    'Wolfenstein 2: The New Colossus' => 'wolfenstein-2',
-                    'Women&#039;s Boots' => 'womens-boots',
-                    'Women&#039;s Fragrance' => 'womens-fragrance',
-                    'Women&#039;s Shoes' => 'womens-shoes',
-                    'Workbench' => 'workbench',
-                    'World of Warcraft' => 'world-of-warcraft',
-                    'World War Z' => 'world-war-z',
-                    'WORX' => 'worx',
-                    'Wreckfest' => 'wreckfest',
-                    'Wuaki' => 'wuaki',
-                    'WWE 2K' => 'wwe',
-                    'Xbox' => 'xbox',
-                    'Xbox 360 Game' => 'xbox-360-game',
-                    'Xbox Accessories' => 'xbox-accessories',
-                    'Xbox Controller' => 'xbox-controller',
-                    'Xbox Game Pass' => 'xbox-game-pass',
-                    'Xbox Gift Card' => 'xbox-gift-card',
-                    'Xbox Headset' => 'xbox-headset',
-                    'Xbox Kinect' => 'kinect',
-                    'Xbox Live' => 'xbox-live',
-                    'Xbox One Controller' => 'xbox-one-controller',
-                    'Xbox One Elite Controller' => 'xbox-one-elite-controller',
-                    'Xbox One Games' => 'xbox-one-games',
-                    'Xbox One S' => 'xbox-one-s',
-                    'Xbox One X' => 'xbox-one-x',
-                    'Xbox Series S' => 'xbox-series-s',
-                    'Xbox Series X' => 'xbox-series-x',
-                    'Xbox Series X Controller' => 'xbox-series-x-controller',
-                    'Xbox Series X Games' => 'xbox-series-x-game',
-                    'Xbox Wireless Adapter' => 'xbox-wireless-adapter',
-                    'Xbox Wireless Headset' => 'xbox-wireless-headset',
-                    'XCOM' => 'xcom',
-                    'XCOM 2' => 'xcom-2',
-                    'Xenoblade Chronicles' => 'xenoblade-chronicles',
-                    'XFX' => 'xfx',
-                    'Xiaomi' => 'xiaomi',
-                    'Xiaomi AirDots' => 'xiaomi-airdots',
-                    'Xiaomi Black Shark' => 'xiaomi-black-shark',
-                    'Xiaomi Black Shark 2' => 'xiaomi-black-shark-2',
-                    'Xiaomi Headphones' => 'xiaomi-headphones',
-                    'Xiaomi Laptop' => 'xiaomi-laptop',
-                    'Xiaomi Mi 5' => 'xiaomi-mi-5',
-                    'Xiaomi Mi 6' => 'xiaomi-mi-6',
-                    'Xiaomi Mi 8' => 'xiaomi-mi-8',
-                    'Xiaomi Mi 8 Lite' => 'xiaomi-mi-8-lite',
-                    'Xiaomi Mi 8 Pro' => 'xiaomi-mi-8-pro',
-                    'Xiaomi Mi 9' => 'xiaomi-mi-9',
-                    'Xiaomi Mi 9 Lite' => 'xiaomi-mi-9-lite',
-                    'Xiaomi Mi 9 SE' => 'xiaomi-mi-9-se',
-                    'Xiaomi Mi 9T' => 'xiaomi-mi-9t',
-                    'Xiaomi Mi 9T Pro' => 'xiaomi-mi-9t-pro',
-                    'Xiaomi Mi 10' => 'xiaomi-mi-10',
-                    'Xiaomi Mi 10 Lite' => 'xiaomi-mi-10-lite',
-                    'Xiaomi Mi 10T' => 'xiaomi-mi-10t',
-                    'Xiaomi Mi 10T Lite' => 'xiaomi-mi-10t-lite',
-                    'Xiaomi Mi 10T Pro' => 'xiaomi-mi-10t-pro',
-                    'Xiaomi Mi 11' => 'xiaomi-mi-11',
-                    'Xiaomi Mi 11 Lite 4G' => 'xiaomi-mi-11-lite-4g',
-                    'Xiaomi Mi 11 Lite 5G' => 'xiaomi-mi-11-lite-5g',
-                    'Xiaomi Mi 11 Pro' => 'xiaomi-mi-11-pro',
-                    'Xiaomi Mi 11 Ultra' => 'xiaomi-mi-11-ultra',
-                    'Xiaomi Mi 11i' => 'xiaomi-mi-11i',
-                    'Xiaomi Mi A1' => 'xiaomi-mi-a1',
-                    'Xiaomi Mi A2' => 'mi-a2',
-                    'Xiaomi Mi A3' => 'xiaomi-mi-a3',
-                    'Xiaomi Mi Band' => 'xiaomi-mi-band',
-                    'Xiaomi Mi Band 3' => 'xiaomi-mi-band-3',
-                    'Xiaomi Mi Band 4' => 'xiaomi-mi-band-4',
-                    'Xiaomi Mi Band 5' => 'xiaomi-mi-band-5',
-                    'Xiaomi Mi Box' => 'xiaomi-mi-box',
-                    'Xiaomi Mi Max 3' => 'xiaomi-mi-max3',
-                    'Xiaomi Mi Mix' => 'xiaomi-mi-mix',
-                    'Xiaomi Mi Mix 2' => 'xiaomi-mi-mix-2',
-                    'Xiaomi Mi Mix 2S' => 'xiaomi-mi-mix-2s',
-                    'Xiaomi Mi Mix 3' => 'xiaomi-mi-mix-3',
-                    'Xiaomi Mi Note' => 'xiaomi-mi-note',
-                    'Xiaomi Mi Note 10' => 'mi-note-10',
-                    'Xiaomi Mi Pad 4' => 'xiaomi-mi-pad-4',
-                    'Xiaomi Pocophone F1' => 'pocophone-f1',
-                    'Xiaomi Redmi' => 'redmi',
-                    'Xiaomi Redmi 4' => 'xiaomi-redmi-4',
-                    'Xiaomi Redmi 5' => 'redmi-5',
-                    'Xiaomi Redmi 6' => 'redmi-6',
-                    'Xiaomi Redmi 8' => 'redmi-8',
-                    'Xiaomi Redmi Note 4' => 'note-4',
-                    'Xiaomi Redmi Note 5' => 'redmi-note-5',
-                    'Xiaomi Redmi Note 6' => 'redmi-note-6',
-                    'Xiaomi Redmi Note 6 Pro' => 'xiaomi-redmi-note-6-pro',
-                    'Xiaomi Redmi Note 7' => 'redmi-note-7',
-                    'Xiaomi Redmi Note 8' => 'xiaomi-redmi-note-8',
-                    'Xiaomi Redmi Note 8 Pro' => 'xiaomi-redmi-note-8-pro',
-                    'Xiaomi Redmi Note 8T' => 'redmi-note-8t',
-                    'Xiaomi Redmi Note 9' => 'xiaomi-redmi-note-9',
-                    'Xiaomi Redmi Note 9 Pro' => 'xiaomi-redmi-note-9-pro',
-                    'Xiaomi Redmi Note 9S' => 'xiaomi-redmi-note-9s',
-                    'Xiaomi Roborock' => 'xiaomi-roborock',
-                    'Xiaomi Roborock S5' => 'xiaomi-roborock-s5',
-                    'Xiaomi Scooter' => 'xiaomi-scooter',
-                    'Xiaomi Smartphones' => 'xiaomi-smartphone',
-                    'Xiaomi Tablets' => 'xiaomi-tablet',
-                    'Yakuza' => 'yakuza',
-                    'Yale' => 'yale',
-                    'Yale Smart Lock' => 'yale-smart-lock',
-                    'Yamaha' => 'yamaha',
-                    'Yankee Candle' => 'yankee-candle',
-                    'Yeelight' => 'xiaomi-yeelight',
-                    'Yoga' => 'yoga',
-                    'Yoghurt' => 'yoghurt',
-                    'Yoshi' => 'yoshi',
-                    'Yoshi&#039;s Crafted World' => 'yoshis-crafted-world',
-                    'YouView' => 'youview',
-                    'Yves Saint Laurent' => 'yves-saint-laurent',
-                    'Zanussi' => 'zanussi',
-                    'Zippo' => 'zippo',
-                    'Zizzi' => 'zizzi',
-                    'Zoo' => 'zoo',
-                    'Zoostorm' => 'zoostorm',
-                    'ZOTAC' => 'zotac',
-                    'ZTE' => 'zte',
-                    'ZTE Smartphone' => 'zte-smartphone',
-                    'ZyXEL' => 'zyxel',
-                ]
+                'type' => 'text',
+                'exampleValue' => 'broadband',
+                'title' => 'Group name in the URL : The group name that must be entered is present after "https://www.hotukdeals.com/tag/" and before any "?".
+Example: If the URL of the group displayed in the browser is :
+https://www.hotukdeals.com/tag/broadband?sortBy=temp
+Then enter :
+broadband',
             ],
             'order' => [
                 'name' => 'Order by',
@@ -3287,5 +98,7 @@ class HotUKDealsBridge extends PepperBridgeAbstract
         'title-talk' => 'Discussion Monitoring',
         'deal-type' => 'Deal Type',
         'localdeal' => 'Local deal',
+        'context-hot' => '-hot',
+        'context-new' => '-new',
     ];
 }
diff --git a/bridges/MydealsBridge.php b/bridges/MydealsBridge.php
index 7b23f263..6be2adfb 100644
--- a/bridges/MydealsBridge.php
+++ b/bridges/MydealsBridge.php
@@ -40,1952 +40,14 @@ class MydealsBridge extends PepperBridgeAbstract
         'Deals pro Gruppen' => [
             'group' => [
                 'name' => 'Gruppen',
-                'type' => 'list',
-                'title' => 'Gruppe, deren Deals angezeigt werden müssen',
-                'values' => [
-                    '1Password' => '1password',
-                    '3D Drucker' => '3d-drucker',
-                    '4K Fernseher' => '4k-fernseher',
-                    '4K Monitore' => '4k-monitor',
-                    '4K Ultra HD Blu-ray' => 'ultra-hd-blu-ray',
-                    '8K Fernseher' => '8k-fernseher',
-                    '32 Zoll Fernseher' => '32-zoll-fernseher',
-                    '55 Zoll Fernseher' => '55-zoll-fernseher',
-                    '65 Zoll Fernseher' => '65-zoll-fernseher',
-                    '75 Zoll Fernseher' => '75-zoll-fernseher',
-                    '1151 Mainboard' => '1151-mainboard',
-                    'Abus' => 'abus',
-                    'ABUS Fahrradschlösser' => 'abus-fahrradschloss',
-                    'Accessoires' => 'accessoires',
-                    'Acer' => 'acer',
-                    'Acer Aspire' => 'acer-aspire',
-                    'Acer Laptops' => 'acer-laptop',
-                    'Acer Monitore' => 'acer-monitor',
-                    'Acer Predator' => 'acer-predator',
-                    'Action Cameras' => 'actioncam',
-                    'Actionfiguren' => 'actionfiguren',
-                    'adidas' => 'adidas',
-                    'adidas Essentials' => 'adidas-neo',
-                    'adidas Iniki' => 'adidas-iniki',
-                    'adidas NMD' => 'adidas-nmd',
-                    'adidas Originals' => 'adidas-originals',
-                    'adidas Schuhe' => 'adidas-schuhe',
-                    'adidas Superstar' => 'adidas-superstar',
-                    'adidas Ultraboost' => 'adidas-ultraboost',
-                    'adidas ZX Flux' => 'adidas-zx-flux',
-                    'Adventskalender' => 'adventskalender',
-                    'AEG' => 'aeg',
-                    'AEG Waschmaschinen' => 'aeg-waschmaschine',
-                    'Age of Empires' => 'age-of-empires',
-                    'AiO Wasserkühlung' => 'aio-wasserkuehlung',
-                    'AKG' => 'akg',
-                    'Akkus' => 'akkus',
-                    'Akkuschrauber' => 'akkuschrauber',
-                    'Alfa Romeo' => 'alfa-romeo',
-                    'Alienware' => 'alienware',
-                    'Alkohol' => 'alkohol',
-                    'All Inclusive Reisen' => 'all-inclusive',
-                    'All in One PCs' => 'all-in-one-pcs',
-                    'AM4 Mainboard' => 'am4-mainboard',
-                    'Amazfit' => 'xiaomi-amazfit',
-                    'Amazfit Bip' => 'amazfit-bip',
-                    'Amazfit GTS' => 'amazfit-gts',
-                    'Amazon Echo' => 'amazon-echo',
-                    'Amazon Echo Dot' => 'amazon-echo-dot',
-                    'Amazon Echo Plus' => 'amazon-echo-plus',
-                    'Amazon Echo Show' => 'amazon-echo-show',
-                    'Amazon Echo Show 5' => 'amazon-echo-show-5',
-                    'Amazon Echo Show 8' => 'amazon-echo-show-8',
-                    'Amazon Echo Spot' => 'amazon-echo-spot',
-                    'Amazon Fire TV Cube' => 'fire-tv-cube',
-                    'Amazon Fire TV Stick' => 'fire-tv',
-                    'Amazon Fire TV Stick 4K' => 'fire-tv-stick-4k',
-                    'Amazon Tablets' => 'amazon-tablet',
-                    'Amazon Warehouse Deals' => 'amazon-warehouse-deals',
-                    'AMD' => 'amd',
-                    'AMD Radeon' => 'amd-radeon',
-                    'AMD Radeon VII' => 'vega-7',
-                    'AMD RX Vega' => 'amd-vega',
-                    'AMD Ryzen' => 'amd-ryzen',
-                    'AMD Ryzen 9 5900X' => 'amd-ryzen-9-5900x',
-                    'American Express' => 'american-express',
-                    'amiibo' => 'amiibo',
-                    'Analoguhren' => 'analoguhren',
-                    'Android Apps' => 'android-apps',
-                    'Android Smartphones' => 'android-smartphones',
-                    'Angelzubehör' => 'angelsport',
-                    'Animal Crossing' => 'animal-crossing',
-                    'Animal Crossing: New Horizons' => 'animal-crossing-new-horizons',
-                    'Anime' => 'anime',
-                    'Ankündigungen' => 'ankundigungen',
-                    'Anno 1800' => 'anno-1800',
-                    'Anthem' => 'anthem',
-                    'Anzug' => 'anzug',
-                    'AOC' => 'aoc',
-                    'Apex Legends' => 'apex-legends',
-                    'Apotheke' => 'apotheke',
-                    'Apple' => 'apple',
-                    'Apple AirPods' => 'airpods',
-                    'Apple AirPods 2' => 'airpods-2',
-                    'Apple AirPods Max' => 'airpods-max',
-                    'Apple AirPods Pro' => 'airpods-pro',
-                    'Apple EarPods' => 'apple-earpods',
-                    'Apple HomePod' => 'homepod',
-                    'Apple HomePod mini' => 'apple-homepod-mini',
-                    'Apple Kopfhörer' => 'apple-kopfhoerer',
-                    'Apple Magic Mouse 2' => 'apple-magic-mouse-2',
-                    'Apple Pencil' => 'apple-pencil',
-                    'Apple Pencil 2' => 'apple-pencil-2',
-                    'Apple TV' => 'apple-tv',
-                    'Apple Watch' => 'apple-watch',
-                    'Apple Watch 3' => 'apple-watch-3',
-                    'Apple Watch 4' => 'apple-watch-4',
-                    'Apple Watch 5' => 'apple-watch-5',
-                    'Apple Watch 6' => 'apple-watch-6',
-                    'Apple Watch SE' => 'apple-watch-se',
-                    'Apps' => 'apps',
-                    'Aquaristik' => 'aquaristik',
-                    'Arbeitsspeicher' => 'arbeitsspeicher',
-                    'Arbeitszimmermöbel' => 'arbeitszimmer',
-                    'ASICS' => 'asics',
-                    'Assassin&#039;s Creed' => 'assassins-creed',
-                    'Assassin&#039;s Creed: Valhalla' => 'assassins-creed-valhalla',
-                    'Assassin&#039;s Creed Odyssey' => 'assassins-creed-odyssey',
-                    'Assassin&#039;s Creed Origins' => 'assassins-creed-origins',
-                    'ASTRO Gaming A50' => 'astro-gaming-a50',
-                    'ASUS' => 'asus',
-                    'ASUS Laptops' => 'asus-laptop',
-                    'Asus Mainboard' => 'asus-mainboard',
-                    'Asus Monitore' => 'asus-monitor',
-                    'ASUS ROG' => 'asus-rog',
-                    'ASUS Smartphones' => 'asus-smartphones',
-                    'Asus ZenBook' => 'asus-zenbook',
-                    'ASUS ZenFone 5' => 'asus-zenfone-5',
-                    'ASUS ZenFone 5Z' => 'asus-zenfone-5z',
-                    'Audi' => 'audi',
-                    'Audio &amp; HiFi' => 'audio-hifi',
-                    'Audioverstärker' => 'audioverstaerker',
-                    'Audio Zubehör' => 'audio-zubehoer',
-                    'Aukey' => 'aukey',
-                    'Außenleuchten' => 'aussenleuchten',
-                    'Auto &amp; Motorrad' => 'auto-motorrad',
-                    'Auto Bild' => 'auto-bild',
-                    'Auto Leasing' => 'auto-leasing',
-                    'Auto Leasing Gewerbe' => 'gewerbe-leasing',
-                    'Auto Leasing Privat' => 'privat-leasing',
-                    'Automatikuhren' => 'automatikuhr',
-                    'auto motor und sport' => 'auto-motor-sport',
-                    'Autoradio' => 'autoradio',
-                    'Auto Teile' => 'autoteile',
-                    'Autowäsche' => 'autowaesche',
-                    'Auto Zubehör' => 'auto',
-                    'AVM FRITZ!Box' => 'avm-fritz-box',
-                    'AVM FRITZ!Box 7490' => 'avm-fritz-box-7490',
-                    'AVM FRITZ!Box 7530' => 'avm-fritz-box-7530',
-                    'AVM FRITZ!Box 7580' => 'avm-fritz-box-7580',
-                    'AVM FRITZ!Box 7590' => 'avm-fritz-box-7590',
-                    'AVM FRITZ! DECT 301' => 'avm-fritz-dect-301',
-                    'AV Receiver' => 'av-receiver',
-                    'Baby &amp; Kind' => 'kinder',
-                    'Baby-Erstausstattung' => 'baby-erstausstattung',
-                    'Babybetten' => 'babybetten',
-                    'Baby Born' => 'baby-born',
-                    'Babykleidung' => 'babybekleidung',
-                    'Babynahrung' => 'babynahrung',
-                    'Babyphone' => 'babyphone',
-                    'Backofen &amp; Herd' => 'backofen-herd',
-                    'Backwaren' => 'backwaren',
-                    'Backzubehör' => 'backzubehoer',
-                    'Bademode' => 'bademode',
-                    'Badmöbel' => 'badezimmer',
-                    'Bahn-Tickets' => 'bahntickets',
-                    'Bahncard' => 'bahncard',
-                    'Balkonmöbel' => 'balkonmoebel',
-                    'Ballerinas' => 'ballerinas',
-                    'Bang &amp; Olufsen' => 'bang-olufsen',
-                    'Bank' => 'bank',
-                    'Barbie' => 'barbie',
-                    'Barclaycard' => 'barclaycard',
-                    'Bartschneider' => 'bartschneider',
-                    'Batterien' => 'batterien',
-                    'Battle.net' => 'battle-net',
-                    'Battlefield' => 'battlefield',
-                    'Battlefield 1' => 'battlefield-1',
-                    'Battlefield 5' => 'battlefield-5',
-                    'Bauknecht' => 'bauknecht',
-                    'Bauknecht Waschmaschinen' => 'bauknecht-waschmaschine',
-                    'Baumarkt' => 'baumarkt',
-                    'Bayonetta' => 'bayonetta',
-                    'Bayonetta 2' => 'bayonetta-2',
-                    'Beamer' => 'beamer',
-                    'Beamer Leinwand' => 'beamer-leinwand',
-                    'Beats by Dre' => 'beats-by-dre',
-                    'Beats Solo3' => 'beats-solo3',
-                    'Beats Solo Pro' => 'beats-solo-pro',
-                    'Beats Studio3' => 'beats-studio3',
-                    'Beauty &amp; Gesundheit' => 'beauty',
-                    'Beko' => 'beko',
-                    'Beleuchtung' => 'beleuchtung',
-                    'Belkin' => 'belkin',
-                    'Ben &amp; Jerry&#039;s' => 'ben-jerrys',
-                    'Bench' => 'bench',
-                    'BenQ' => 'benq',
-                    'BenQ Monitore' => 'benq-monitor',
-                    'be quiet!' => 'be-quiet',
-                    'be quiet! Netzteile' => 'be-quiet-netzteil',
-                    'Besteck' => 'besteck',
-                    'Bethesda' => 'bethesda',
-                    'Betten' => 'betten',
-                    'Bettwäsche' => 'bettwaesche',
-                    'beyerdynamic' => 'beyerdynamic',
-                    'Beyerdynamic MMX 300' => 'beyerdynamic-mmx-300',
-                    'BHs' => 'bhs',
-                    'Bier' => 'bier',
-                    'Biking &amp; Urban Sport' => 'biking-urban-sport',
-                    'Bildbearbeitungsprogramme' => 'bildbearbeitungsprogramme',
-                    'Birkenstock' => 'birkenstock',
-                    'Black &amp; Decker' => 'black-and-decker',
-                    'Blackberry Smartphones' => 'blackberry',
-                    'Black Desert Online' => 'black-desert-online',
-                    'Blazer' => 'blazer',
-                    'Blood &amp; Truth' => 'blood-truth',
-                    'Blu-ray' => 'blu-ray',
-                    'Blu-ray Player' => 'blu-ray-player',
-                    'Bluetooth Kopfhörer' => 'bluetooth-kopfhoerer',
-                    'Bluetooth Lautsprecher' => 'bluetooth-lautsprecher',
-                    'Blumen' => 'blumen',
-                    'Blusen' => 'blusen',
-                    'BMW' => 'bmw',
-                    'Bodenbelag' => 'bodenbelag',
-                    'Boho-Chic wohnen' => 'boho-chich-wohnen',
-                    'Bohrer' => 'bohrer',
-                    'Bohrhämmer' => 'bohrhaemmer',
-                    'Bohrmaschinen' => 'bohrmaschinen',
-                    'Bollerwagen' => 'bollerwagen',
-                    'Bombay Gin' => 'bombay',
-                    'Borderlands' => 'borderlands',
-                    'Borderlands 3' => 'borderlands-3',
-                    'Bosch' => 'bosch',
-                    'Bosch Akkuschrauber' => 'bosch-akkuschrauber',
-                    'Bosch Geschirrspüler' => 'bosch-geschirrspueler',
-                    'Bosch Kühlschränke' => 'bosch-kuehlschrank',
-                    'Bosch Waschmaschinen' => 'bosch-waschmaschine',
-                    'Bose' => 'bose',
-                    'Bose Headphones 700' => 'bose-headphones-700',
-                    'Bose Home Speaker 500' => 'bose-home-speaker-500',
-                    'Bose Kopfhörer' => 'bose-kopfhoerer',
-                    'Bose QuietComfort' => 'bose-quietcomfort',
-                    'Bose QuietComfort 35 II' => 'bose-quiet-comfort-35-ii',
-                    'Bose Solo 5' => 'bose-solo-5',
-                    'Bose SoundLink' => 'bose-soundlink',
-                    'Bose SoundTouch' => 'bose-soundtouch',
-                    'BOSS' => 'boss',
-                    'Bourbon' => 'bourbon',
-                    'Bowers &amp; Wilkins' => 'bowers-wilkins',
-                    'Boxershorts' => 'boxershorts',
-                    'Boxspringbetten' => 'boxspringbetten',
-                    'Braun' => 'braun',
-                    'Braun Rasierer' => 'braun-rasierer',
-                    'Braun Series 3' => 'braun-series-3',
-                    'Braun Series 5' => 'braun-series-5',
-                    'Braun Series 7' => 'braun-series-7',
-                    'Braun Series 9' => 'braun-series-9',
-                    'Bridgekameras' => 'bridgekamera',
-                    'Brigitte' => 'brigitte',
-                    'Brillen &amp; Kontaktlinsen' => 'brillen',
-                    'Brita' => 'brita',
-                    'Britax Römer' => 'britax-roemer',
-                    'Brotaufstrich' => 'brotaufstrich',
-                    'Brother Drucker' => 'brother-drucker',
-                    'Bücher' => 'buecher',
-                    'Bücher, Magazine &amp; Zeitschriften' => 'buecher-zeitschriften',
-                    'bugatti' => 'bugatti',
-                    'Bügeleisen' => 'buegeleisen',
-                    'Bügeln' => 'buegeln',
-                    'Buggy' => 'buggy',
-                    'Burger' => 'burger',
-                    'BURNHARD' => 'burnhard',
-                    'Bürobedarf' => 'buerobedarf',
-                    'Bürostühle' => 'buerostuhl',
-                    'Bus &amp; Bahn' => 'bus-bahn',
-                    'Business Mode' => 'business-mode',
-                    'c&#039;t  – Magazin für Computertechnik' => 'ct-magazin-computertechnik',
-                    'Cafissimo' => 'cafissimo',
-                    'Call of Duty' => 'call-of-duty',
-                    'Call of Duty: Black Ops 4' => 'call-of-duty-black-ops-4',
-                    'Call of Duty: Black Ops Cold War' => 'call-of-duty-black-ops-cold-war',
-                    'Call of Duty: Infinite Warfare' => 'call-of-duty-infinite-warfare',
-                    'Call of Duty: Modern Warfare' => 'call-of-duty-modern-warfare',
-                    'Call of Duty: Warzone' => 'call-of-duty-warzone',
-                    'Call of Duty: WW2' => 'call-of-duty-ww2',
-                    'Calvin Klein' => 'calvin-klein',
-                    'Camcorder' => 'camcorder',
-                    'Campen' => 'campen',
-                    'Canon' => 'canon',
-                    'Canon Drucker' => 'canon-drucker',
-                    'Canon EOS' => 'canon-eos',
-                    'Canon Kameras' => 'canon-kameras',
-                    'Canon PowerShot' => 'canon-powershot',
-                    'CANTON' => 'canton',
-                    'Caps' => 'caps',
-                    'Captain Toad: Treasure Tracker' => 'captain-toad-treasure-tracker',
-                    'Capture One' => 'capture-one',
-                    'Carhartt' => 'carhartt',
-                    'Carsharing' => 'carsharing',
-                    'Casio' => 'casio',
-                    'Cheap Monday' => 'cheapmonday',
-                    'Chevrolet' => 'chevrolet',
-                    'China Handys' => 'china-handys',
-                    'Chip (Magazin)' => 'chip-magazin',
-                    'Chips' => 'chips',
-                    'Christbaumschmuck' => 'christbaumschmuck',
-                    'Christbaumständer' => 'christbaumstaender',
-                    'Chromebook' => 'chromebook',
-                    'Chronographen' => 'chronograph',
-                    'Chucks' => 'chucks',
-                    'Citroen' => 'citroen',
-                    'Coca-Cola' => 'coca-cola',
-                    'Comics' => 'comics',
-                    'Computer' => 'computer',
-                    'Computer &amp; Tablets' => 'computer-tablet',
-                    'Computer Bild' => 'computer-bild',
-                    'Controller' => 'controller',
-                    'Converse' => 'converse',
-                    'Convertibles' => 'convertibles',
-                    'Corsair' => 'corsair',
-                    'Corsair VOID PRO' => 'corsair-void-pro',
-                    'Couchtische' => 'couchtische',
-                    'Coupons' => 'coupons',
-                    'CPU-Kühler' => 'cpu-kuehler',
-                    'Craghoppers' => 'craghoppers',
-                    'Crocs' => 'crocs',
-                    'Crucial' => 'crucial',
-                    'Cupra' => 'cupra',
-                    'Cyberpunk 2077' => 'cyberpunk-2077',
-                    'cybex' => 'cybex',
-                    'D-Link' => 'd-link',
-                    'DAB Radios' => 'dab-radios',
-                    'Dacia' => 'dacia',
-                    'Damenbekleidung' => 'fashion-frauen',
-                    'Damenschuhe' => 'damenschuhe',
-                    'Dampfbügelstation' => 'dampfbuegelstation',
-                    'Dampfgarer' => 'dampfgarer',
-                    'Dampfreiniger' => 'dampfreiniger',
-                    'Dark Souls' => 'dark-souls',
-                    'Dashcam' => 'dashcam',
-                    'Datentarif' => 'datentarif',
-                    'Daypack' => 'daypack',
-                    'Days Gone' => 'days-gone',
-                    'DC Shoes' => 'dc-shoes',
-                    'DDR3 RAM' => 'ddr3-ram',
-                    'DDR4 RAM' => 'ddr4-ram',
-                    'De&#039;Longhi' => 'delonghi',
-                    'Death Stranding' => 'death-stranding',
-                    'Deckenlampen' => 'deckenlampen',
-                    'DECT Telefone' => 'telefone',
-                    'Dekoration' => 'dekoration',
-                    'Dell' => 'dell',
-                    'Dell Laptops' => 'dell-laptop',
-                    'Dell Monitore' => 'dell-monitor',
-                    'Dell XPS' => 'dell-xps',
-                    'Denon' => 'denon',
-                    'Deo' => 'deo',
-                    'Depot' => 'depot',
-                    'DER SPIEGEL' => 'der-spiegel',
-                    'Designermöbel' => 'designermoebel',
-                    'Desigual' => 'desigual',
-                    'Desinfektionsmittel' => 'desinfektionsmittel',
-                    'Desktop PCs' => 'desktop-pc',
-                    'Dessous' => 'dessous',
-                    'Destiny' => 'destiny',
-                    'Destiny 2' => 'destiny-2',
-                    'Deus Ex' => 'deus-ex',
-                    'Deus Ex: Mankind' => 'deus-ex-mankind',
-                    'Deuter' => 'deuter',
-                    'DeutschlandCard' => 'deutschlandcard',
-                    'devolo' => 'devolo',
-                    'DeWalt' => 'dewalt',
-                    'Die drei Fragezeichen' => 'die-drei-fragezeichen',
-                    'Die Eiskönigin' => 'die-eiskoenigin',
-                    'Dienstleistungen &amp; Verträge' => 'dienstleistungen-vertraege',
-                    'Dies &amp; Das' => 'dies-das',
-                    'Diesel' => 'diesel',
-                    'Die Sims' => 'die-sims',
-                    'Die Sims 4' => 'die-sims-4',
-                    'Die Zeit' => 'die-zeit',
-                    'Digitalreceiver' => 'digitalreceiver',
-                    'Digitaluhren' => 'digitaluhr',
-                    'Direktflüge' => 'direktfluege',
-                    'Dirt Devil' => 'dirt-devil',
-                    'Dishonored' => 'dishonored',
-                    'Dishonored 2: Das Vermächtnis der Maske' => 'dishonored-2',
-                    'Disney' => 'disney',
-                    'Disney+' => 'disney-plus',
-                    'DJI' => 'dji',
-                    'DJI Osmo Pocket' => 'dji-osmo-pocket',
-                    'Dockers' => 'dockers',
-                    'Dolce Gusto' => 'dolce-gusto',
-                    'DOOM Eternal' => 'doom-eternal',
-                    'Douglas Adventskalender' => 'douglas-adventskalender',
-                    'Dr. Martens' => 'dr-martens',
-                    'Dragon Ball' => 'dragon-ball',
-                    'Dragon Ball FighterZ' => 'dragon-ball-fighterz',
-                    'Dragon Ball Z: Kakarot' => 'dragon-ball-z-kakarot',
-                    'Dragon Quest Builders' => 'dragon-quest-builders',
-                    'Dragon Quest Builders 2' => 'dragon-quest-builders-2',
-                    'Dreame Staubsauger' => 'xiaomi-staubsauger',
-                    'Dreame T20' => 'dreame-t20',
-                    'Dreame V9' => 'xiaomi-dreame-v9',
-                    'Dreame V10' => 'xiaomi-dreame-v10',
-                    'Dreame V11' => 'xiaomi-dreame-v11',
-                    'Drohnen' => 'drohnen',
-                    'Drucker' => 'drucker',
-                    'Druckerpatronen' => 'druckerpatronen',
-                    'Druckerzubehör' => 'druckerzubehoer',
-                    'DSL &amp; Kabel' => 'dsl',
-                    'Dunstabzugshauben' => 'dunstabzugshauben',
-                    'Durex' => 'durex',
-                    'Duscharmaturen' => 'duscharmaturen',
-                    'Duschgel' => 'duschgel',
-                    'Duschköpfe' => 'duschkoepfe',
-                    'DVD' => 'dvd',
-                    'Dyson' => 'dyson',
-                    'Dyson Staubsauger' => 'dyson-staubsauger',
-                    'Dyson V6' => 'dyson-v6',
-                    'Dyson V7' => 'dyson-v7',
-                    'Dyson V8' => 'dyson-v8',
-                    'Dyson V10' => 'dyson-v10',
-                    'Dyson V11' => 'dyson-v11',
-                    'Dyson V11 Absolute' => 'dyson-v11-absolute',
-                    'Dyson V11 Animal' => 'dyson-v11-animal',
-                    'E-Bikes' => 'e-bikes',
-                    'E-Scooter' => 'e-scooter',
-                    'E-Scooter Sharing' => 'e-scooter-sharing',
-                    'E-Zigaretten' => 'e-zigaretten',
-                    'Eastpak' => 'eastpak',
-                    'eBook Reader' => 'ebook-reader',
-                    'eBooks' => 'ebooks',
-                    'Ecovacs' => 'ecovacs',
-                    'Ecovacs Deebot 900' => 'ecovacs-deebot-900',
-                    'Ecovacs Deebot OZMO 930' => 'ecovacs-deebot-ozmo-930',
-                    'Edifier' => 'edifier',
-                    'Edifier R1280DB' => 'edifier-r1280db',
-                    'Edifier R1280T' => 'edifier-r1280t',
-                    'Einhell' => 'einhell',
-                    'Eis' => 'eis',
-                    'Elektrische Zahnbürsten' => 'elektrische-zahnbuersten',
-                    'Elektrogrills' => 'elektrogrill',
-                    'Elektroheizungen' => 'elektroheizungen',
-                    'Elektronik' => 'elektronik',
-                    'Elektronik Zubehör' => 'elektronikzubehoer',
-                    'Elektrorasierer' => 'elektrorasierer',
-                    'Elektroroller' => 'elektroroller',
-                    'Elektrowerkzeuge' => 'elektrowerkzeug',
-                    'Elephone' => 'elephone',
-                    'ELLE' => 'elle',
-                    'Emsa' => 'emsa',
-                    'Energy Drinks' => 'energy-drinks',
-                    'Entsafter' => 'entsafter',
-                    'Epilierer' => 'epilierer',
-                    'Epson' => 'epson',
-                    'Epson Drucker' => 'epson-drucker',
-                    'Erotik' => 'erotik',
-                    'Error Fare' => 'error-fare',
-                    'Espressomaschinen' => 'espressomaschinen',
-                    'Esprit' => 'esprit',
-                    'Esstische' => 'esstisch',
-                    'Esszimmer' => 'esszimmer',
-                    'Eterna' => 'eterna',
-                    'EUROtronic Comet DECT' => 'eurotronic-comet-dect',
-                    'Externe Festplatten' => 'externe-festplatten',
-                    'F1 2017' => 'f1-2017',
-                    'F1 2019' => 'f1-2019',
-                    'F1 2020' => 'f1-2020',
-                    'Fahrräder' => 'fahrraeder',
-                    'Fahrradhelme' => 'fahrradhelme',
-                    'Fahrradrucksäcke' => 'fahrradrucksack',
-                    'Fahrradschlösser' => 'fahrradschloss',
-                    'Fahrradteile' => 'fahrradteile',
-                    'Fahrradträger' => 'fahrradtraeger',
-                    'Fahrradzubehör' => 'fahrradzubehoer',
-                    'Fahrzeuge' => 'fahrzeuge',
-                    'Falke' => 'falke',
-                    'Fallout' => 'fallout',
-                    'Fallout 4' => 'fallout-4',
-                    'Fallout 76' => 'fallout-76',
-                    'Family &amp; Kids' => 'family-kids',
-                    'Far Cry' => 'far-cry',
-                    'Far Cry 5' => 'far-cry-5',
-                    'Far Cry New Dawn' => 'far-cry-new-dawn',
-                    'Fashion &amp; Accessoires' => 'fashion-accessoires',
-                    'Fast Food' => 'fast-food',
-                    'Felgen' => 'felgen',
-                    'Fenstersauger' => 'fenstersauger',
-                    'Fernbus-Tickets' => 'fernbus',
-                    'Fernseher' => 'fernseher',
-                    'Fertiggerichte' => 'fertiggerichte',
-                    'Festplatten' => 'festplatten',
-                    'Festplattengehäuse' => 'festplattengehaeuse',
-                    'FFP2 Masken' => 'ffp2-masken',
-                    'Fiat' => 'fiat',
-                    'FIFA' => 'fifa',
-                    'FIFA 17' => 'fifa-17',
-                    'FIFA 18' => 'fifa-18',
-                    'FIFA 19' => 'fifa-19',
-                    'FIFA 20' => 'fifa-20',
-                    'FIFA 21' => 'fifa-21',
-                    'FILA' => 'fila',
-                    'Filme &amp; Serien' => 'filme-serien',
-                    'Filterkaffeemaschinen' => 'filterkaffeemaschinen',
-                    'Final Fantasy' => 'final-fantasy',
-                    'Final Fantasy 7' => 'final-fantasy-7',
-                    'Finanzen- und Steuersoftware' => 'finanzen-und-steuersoftware',
-                    'Finish' => 'finish',
-                    'Fisch &amp; Meeresfrüchte' => 'fisch-meeresfruechte',
-                    'Fischertechnik' => 'fischertechnik',
-                    'Fisher-Price' => 'fisher-price',
-                    'Fiskars' => 'fiskars',
-                    'Fissler' => 'fissler',
-                    'fitbit' => 'fitbit',
-                    'Fitness &amp; Running' => 'fitness',
-                    'Fitness Apps' => 'fitness-apps',
-                    'Fitnessstudio' => 'fitnessstudio',
-                    'Fitnesstracker' => 'fitnesstracker',
-                    'Fjällräven' => 'fjaellraeven',
-                    'Fleisch &amp; Wurst' => 'fleisch-wurst',
-                    'Fliesenschneider' => 'fliesenschneider',
-                    'Flüge' => 'fluege',
-                    'Flurmöbel' => 'flurmoebel',
-                    'FOCUS' => 'focus',
-                    'Ford' => 'ford',
-                    'For Honor' => 'for-honor',
-                    'Formel 1 Games' => 'formel-1',
-                    'Fortnite' => 'fortnite',
-                    'Forza' => 'forza',
-                    'Forza Horizon' => 'forza-horizon',
-                    'Forza Horizon 4' => 'forza-horizon-4',
-                    'Forza Motorsport' => 'forza-motorsport',
-                    'Forza Motorsport 7' => 'forza-7',
-                    'Fossil' => 'fossil',
-                    'Foto &amp; Kamera' => 'foto-video',
-                    'Foto Apps' => 'foto-apps',
-                    'Fotobücher' => 'fotobuecher',
-                    'Fototapete' => 'fototapete',
-                    'Fragen &amp; Gesuche' => 'gesuche',
-                    'Frankfurter Allgemeine Zeitung (F.A.Z.)' => 'frankfurter-allgemeine-zeitung',
-                    'FreeSync Monitore' => 'freesync-monitor',
-                    'Freizeitpark-Tickets' => 'freizeitpark',
-                    'Freizeitsport' => 'freizeitsport',
-                    'Fritteusen' => 'fritteusen',
-                    'Frontlader' => 'frontlader',
-                    'Frühlingsdeko' => 'fruehlingsdeko',
-                    'Frühstücksflocken' => 'fruehstuecksflocken',
-                    'Fruit of the Loom' => 'fruit-of-the-loom',
-                    'Fujifilm' => 'fujifilm',
-                    'Füller' => 'fueller',
-                    'Full HD-Beamer' => 'full-hd-beamer',
-                    'Fun Factory' => 'fun-factory',
-                    'FurReal Friends' => 'furreal-friends',
-                    'Fußball' => 'fussball',
-                    'Fußball-Trikots' => 'fussball-trikots',
-                    'Fußballschuhe' => 'fussballschuhe',
-                    'G-Star' => 'g-star',
-                    'G-Sync Monitore' => 'g-sync-monitor',
-                    'Game of Thrones' => 'game-of-thrones',
-                    'Gaming' => 'gaming',
-                    'Gaming Headsets' => 'gaming-headset',
-                    'Gaming Laptops' => 'gaming-laptop',
-                    'Gaming Mäuse' => 'gaming-maus',
-                    'Gaming Monitore' => 'gaming-monitor',
-                    'Gaming PCs' => 'gaming-pc',
-                    'Gaming Stühle' => 'gaming-stuhl',
-                    'Gaming Tastaturen' => 'gaming-tastatur',
-                    'Gaming Zubehör' => 'spielekonsolen-zubehoer',
-                    'Ganzjahresreifen' => 'ganzjahresreifen',
-                    'GAP' => 'gap',
-                    'Gardena' => 'gardena',
-                    'Garderobe' => 'garderobe',
-                    'Garmin' => 'garmin',
-                    'Garmin Fenix' => 'garmin-fenix',
-                    'Garten' => 'garten',
-                    'Garten &amp; Baumarkt' => 'garten-baumarkt',
-                    'Gartenarbeit' => 'gartenarbeit',
-                    'Gartenbank' => 'gartenbank',
-                    'Gartenliegen' => 'sonnenliegen',
-                    'Gartenmöbel' => 'gartenmoebel',
-                    'Gartenstühle' => 'gartenstuehle',
-                    'Gartentische' => 'gartentische',
-                    'Gasgrills' => 'gasgrill',
-                    'Gastarif' => 'gastarif',
-                    'Gears 5' => 'gears-5',
-                    'Gears of War' => 'gears-of-war',
-                    'Gefrierschränke' => 'gefrierschrank',
-                    'Geld-zurück-Aktionen' => 'geld-zurueck',
-                    'Geldbörsen' => 'geldboersen',
-                    'Gemüse' => 'gemuese',
-                    'Geox' => 'geox',
-                    'Geschirr' => 'geschirr',
-                    'Geschirrspüler' => 'geschirrspueler',
-                    'Gesellschaftsspiele' => 'gesellschaftsspiele',
-                    'Gesichtspflege' => 'gesichtspflege',
-                    'Gesundheit' => 'gesundheit',
-                    'Getränke' => 'getraenke',
-                    'Gewinnspiele' => 'gewinnspiele',
-                    'GHD' => 'ghd',
-                    'Ghost of Tsushima' => 'ghost-of-tsushima',
-                    'GIGABYTE' => 'gigabyte',
-                    'Gigaset' => 'gigaset',
-                    'Gillette' => 'gillette',
-                    'Gillette Rasierer' => 'gillette-rasierer',
-                    'Gin' => 'gin',
-                    'Girokonto' => 'konto',
-                    'Glamour' => 'glamour',
-                    'Glamourös wohnen' => 'glamouroes-wohnen',
-                    'Gläser' => 'glaeser',
-                    'Glätteisen' => 'glaetteisen',
-                    'Gleitgel' => 'gleitgel',
-                    'Glühwein' => 'gluehwein',
-                    'God of War' => 'god-of-war',
-                    'Google Chromecast' => 'chromecast',
-                    'Google Chromecast mit Google TV' => 'chromecast-mit-google-tv',
-                    'Google Chromecast Ultra' => 'chromecast-ultra',
-                    'Google Home' => 'google-home',
-                    'Google Home Max' => 'google-home-max',
-                    'Google Home Mini' => 'google-home-mini',
-                    'Google Nest Hub' => 'google-nest-hub',
-                    'Google Pixel' => 'google-pixel',
-                    'Google Pixel 2' => 'google-pixel-2',
-                    'Google Pixel 3' => 'google-pixel-3',
-                    'Google Pixel 4' => 'google-pixel-4',
-                    'Google Pixel 4 XL' => 'google-pixel-4xl',
-                    'Google Pixel 4a' => 'google-pixel-4a',
-                    'Google Pixel 4a 5G' => 'google-pixel-4a-5g',
-                    'Google Pixel 5' => 'google-pixel-5',
-                    'Google Smartphones' => 'google-smartphones',
-                    'Google Stadia Konsolen' => 'google-stadia',
-                    'GoPro Action Cameras' => 'gopro',
-                    'GoPro HERO 7' => 'gopro-hero-7',
-                    'GoPro HERO 8' => 'gopro-hero-8',
-                    'GoPro HERO 9' => 'gopro-hero-9',
-                    'Gorenje' => 'gorenje',
-                    'Grafikkarten' => 'grafikkarten',
-                    'Gran Turismo' => 'gran-turismo',
-                    'Gran Turismo Sport' => 'gran-turismo-sport',
-                    'Grazia' => 'grazia',
-                    'Grills' => 'grill',
-                    'Grillzubehör' => 'grillzubehoer',
-                    'Grundig' => 'grundig',
-                    'GTA' => 'gta',
-                    'GTA V' => 'gta-v',
-                    'GTX 1060' => 'gtx-1060',
-                    'GTX 1070' => 'gtx-1070',
-                    'GTX 1080' => 'gtx-1080',
-                    'GTX 1080 Ti' => 'gtx-1080-ti',
-                    'GTX 1660' => 'gtx-1660',
-                    'GTX 1660 Ti' => 'gtx-1660-ti',
-                    'Gucci' => 'gucci',
-                    'Gummistiefel' => 'gummistiefel',
-                    'Gürtel' => 'guertel',
-                    'Gutscheinfehler' => 'gutscheinfehler',
-                    'Haarentfernung' => 'haarentfernung',
-                    'Haargel' => 'haargel',
-                    'Haarpflege' => 'haarpflege',
-                    'Haarschneidemaschinen' => 'haarschneidemaschinen',
-                    'Haarspray' => 'haarspray',
-                    'Haartrockner' => 'haartrockner',
-                    'Haftpflichtversicherung' => 'haftpflichtversicherung',
-                    'Hama' => 'hama',
-                    'Handelsblatt' => 'handelsblatt',
-                    'Handmixer' => 'handmixer',
-                    'Handtaschen' => 'handtaschen',
-                    'Handtücher' => 'handtuecher',
-                    'Handwerkzeuge' => 'handwerkzeug',
-                    'Handy &amp; Smartphone Zubehör' => 'smartphone-zubehoer',
-                    'Handyhalterung' => 'handyhalterung',
-                    'Handyhüllen' => 'handyhuelle',
-                    'Handys mit Vertrag' => 'handys-mit-vertrag',
-                    'Handys ohne Vertrag' => 'handys-ohne-vertrag',
-                    'Handyversicherung' => 'handyversicherung',
-                    'Handyverträge' => 'handyvertraege',
-                    'Handyverträge 3 Monate Kündigungsfrist' => 'handyvertraege-3-monate-kuendigungsfrist',
-                    'Handyverträge monatlich kündbar' => 'handyvertraege-monatlich-kuendbar',
-                    'Hängematten' => 'haengematten',
-                    'Hanteln' => 'hanteln',
-                    'Haribo' => 'haribo',
-                    'Harman Kardon' => 'harman-kardon',
-                    'Harry Potter' => 'harry-potter',
-                    'Hasbro' => 'hasbro',
-                    'Haushaltsartikel' => 'haushaltsartikel',
-                    'Haushaltsgeräte' => 'haushaltsgeraete',
-                    'Haushaltswaren' => 'haushaltswaren',
-                    'Hausratversicherung' => 'hausratsversicherung',
-                    'Hausschuhe' => 'hausschuhe',
-                    'Haustier' => 'haustier',
-                    'Hautpflege' => 'hautpflege',
-                    'Head &amp; Shoulders' => 'head-and-shoulders',
-                    'Heckenscheren' => 'heckenschere',
-                    'Heimkino' => 'heimkino',
-                    'Heimtextilien' => 'heimtextilien',
-                    'Heißluftfritteusen' => 'heissluftfriteuse',
-                    'Heizkörperthermostat' => 'heizkoerperthermostat',
-                    'Heizungen' => 'heizungen',
-                    'Hemden' => 'hemden',
-                    'Hendrick&#039;s Gin' => 'hendricks-gin',
-                    'Herbstdeko' => 'herbstdeko',
-                    'Herrenbekleidung' => 'fashion-maenner',
-                    'Herrenschuhe' => 'herrenschuhe',
-                    'HiPP' => 'hipp',
-                    'Hisense' => 'hisense',
-                    'Hochbetten' => 'hochbetten',
-                    'Hochdruckreiniger' => 'hochdruckreiniger',
-                    'Hochstuhl' => 'hochstuhl',
-                    'Hollywoodschaukel' => 'hollywoodschaukel',
-                    'Home &amp; Living' => 'home-living',
-                    'homee' => 'homee',
-                    'Honda' => 'honda',
-                    'Honor' => 'honor',
-                    'Honor 5' => 'honor-5',
-                    'Honor 6' => 'honor-6',
-                    'Honor 7X' => 'honor-7',
-                    'Honor 8' => 'honor-8',
-                    'Honor 9' => 'honor-9',
-                    'Honor 20' => 'honor-20',
-                    'Honor 20 Lite' => 'honor-20-lite',
-                    'Honor Band 4' => 'honor-band-4',
-                    'Honor Band 5' => 'honor-band-5',
-                    'Honor Play' => 'honor-play',
-                    'Honor Smartphones' => 'honor-smartphones',
-                    'Honor View 10' => 'honor-view-10',
-                    'Honor View 20' => 'honor-view-20',
-                    'Hoodies' => 'hoodies',
-                    'Hörbücher' => 'hoerbuecher',
-                    'Horizon Zero Dawn' => 'horizon-zero-dawn',
-                    'Hörspiele' => 'hoerspiele',
-                    'Hörzu' => 'hoerzu',
-                    'Hosen' => 'hosen',
-                    'Hotels &amp; Unterkünfte' => 'hotel',
-                    'Hot Wheels' => 'hot-wheels',
-                    'Hoverboards' => 'hoverboards',
-                    'HP' => 'hp',
-                    'HP Drucker' => 'hp-drucker',
-                    'HP Laptops' => 'hp-laptop',
-                    'HP OMEN' => 'hp-omen',
-                    'HP Pavilion' => 'hp-pavilion',
-                    'HTC 10' => 'htc-10',
-                    'HTC Desire 12' => 'htc-desire',
-                    'HTC Smartphones' => 'htc-smartphones',
-                    'HTC U11' => 'htc-u11',
-                    'HTC Vive' => 'htc-vive',
-                    'Huawei' => 'huawei',
-                    'Huawei Kopfhörer' => 'huawei-kopfhoerer',
-                    'Huawei Mate 9' => 'huawei-mate-9',
-                    'Huawei Mate 10' => 'huawei-mate-10',
-                    'Huawei Mate 20' => 'huawei-mate-20',
-                    'Huawei Mate 20 Lite' => 'huawei-mate-20-lite',
-                    'Huawei Mate 20 Pro' => 'huawei-mate-20-pro',
-                    'Huawei Mate 30 Pro' => 'huawei-mate-30-pro',
-                    'Huawei MateBook' => 'huawei-matebook',
-                    'Huawei P10' => 'huawei-p10',
-                    'Huawei P20' => 'huawei-p20',
-                    'Huawei P30' => 'huawei-p30',
-                    'Huawei P30 Lite' => 'huawei-p30-lite',
-                    'Huawei P30 Pro' => 'huawei-p30-pro',
-                    'Huawei P40' => 'huawei-p40',
-                    'Huawei P40 Lite' => 'huawei-p40-lite',
-                    'Huawei P40 Pro' => 'huawei-p40-pro',
-                    'Huawei P Smart' => 'huawei-p-smart',
-                    'Huawei Smartphones' => 'huawei-smartphones',
-                    'Huawei Tablets' => 'huawei-mediapad',
-                    'Huawei Watch GT2' => 'huawei-watch-gt2',
-                    'Huawei Y7' => 'huawei-y7',
-                    'Hunde' => 'hunde',
-                    'Hundefutter' => 'hundefutter',
-                    'Hüte &amp; Mützen' => 'huete-muetzen',
-                    'Hyrule Warriors' => 'hyrule-warriors',
-                    'Hyrule Warriors: Zeit der Verheerung' => 'hyrule-warriors-zeit-der-verheerung',
-                    'Hyundai' => 'hyundai',
-                    'iMac' => 'imac',
-                    'Immortals Fenyx Rising' => 'immortals-fenyx-rising',
-                    'In-Ear Kopfhörer' => 'in-ear-kopfhoerer',
-                    'Industrial Style' => 'industrial-style',
-                    'Inline Skates' => 'inline-skates',
-                    'Instax Mini' => 'instax-mini',
-                    'Intel Core i9-9900K' => 'intel-core-i9-9900k',
-                    'Intel i3' => 'intel-i3',
-                    'Intel i5' => 'intel-i5',
-                    'Intel i7' => 'intel-i7',
-                    'Intel i9' => 'intel-i9',
-                    'Intenso' => 'intenso',
-                    'Internet Security' => 'internet-security',
-                    'Intimpflege' => 'intimpflege',
-                    'iOS Apps' => 'ios-apps',
-                    'iPad' => 'ipad',
-                    'iPad 2019' => 'ipad-2019',
-                    'iPad 2020' => 'ipad-2020',
-                    'iPad Air' => 'ipad-air-2',
-                    'iPad Air 2019' => 'ipad-air-2019',
-                    'iPad Air 2020' => 'ipad-air-2020',
-                    'iPad mini' => 'ipad-mini',
-                    'iPad Pro' => 'ipad-pro',
-                    'iPad Pro 11' => 'ipad-pro-11',
-                    'iPad Pro 12.9' => 'ipad-pro-12-9',
-                    'iPad Pro 2020' => 'ipad-pro-2020',
-                    'iPhone' => 'iphone',
-                    'iPhone 6' => 'iphone-6',
-                    'iPhone 6 Plus' => 'iphone-6-plus',
-                    'iPhone 6s' => 'iphone-6s',
-                    'iPhone 6s Plus' => 'iphone-6s-plus',
-                    'iPhone 7' => 'iphone-7',
-                    'iPhone 7 Plus' => 'iphone-7-plus',
-                    'iPhone 8' => 'iphone-8',
-                    'iPhone 8 Plus' => 'iphone-8-plus',
-                    'iPhone 11' => 'iphone-11',
-                    'iPhone 11 Pro' => 'iphone-11-pro',
-                    'iPhone 11 Pro Max' => 'iphone-11-pro-max',
-                    'iPhone 12' => 'iphone-12',
-                    'iPhone 12 mini' => 'iphone-12-mini',
-                    'iPhone 12 Pro' => 'iphone-12-pro',
-                    'iPhone 12 Pro Max' => 'iphone-12-pro-max',
-                    'iPhone SE' => 'iphone-se',
-                    'iPhone X' => 'iphone-x',
-                    'iPhone Xr' => 'iphone-xr',
-                    'iPhone Xs' => 'iphone-xs',
-                    'iPhone Xs Max' => 'iphone-xs-max',
-                    'iPhone Zubehör' => 'iphone-zubehoer',
-                    'Irish Whiskey' => 'irish-whiskey',
-                    'iRobot' => 'irobot',
-                    'iRobot Roomba' => 'irobot-roomba',
-                    'iRobot Roomba 980' => 'irobot-roomba-980',
-                    'iRobot Roomba i7' => 'irobot-roomba-i7',
-                    'Isomatten' => 'isomatten',
-                    'iTunes Guthaben' => 'itunes-guthaben',
-                    'Jabra Elite 75t' => 'jabra-elite-75t',
-                    'Jabra Elite 85h' => 'jabra-elite-85h',
-                    'Jabra Elite 85t' => 'jabra-elite-85t',
-                    'Jabra Elite Active 75t' => 'jabra-elite-active-75t',
-                    'Jabra Kopfhörer' => 'jabra-kopfhoerer',
-                    'JACK &amp; JONES' => 'jack-jones',
-                    'Jacken' => 'jacken',
-                    'JACK WOLFSKIN' => 'jack-wolfskin',
-                    'Jagdzubehör' => 'jagdzubehoer',
-                    'JBL' => 'jbl',
-                    'JBL Charge 4' => 'jbl-charge-4',
-                    'JBL Flip' => 'jbl-flip',
-                    'JBL GO' => 'jbl-go',
-                    'Jeans' => 'jeans',
-                    'Jim Beam' => 'jim-beam',
-                    'Jogginghosen' => 'jogginghosen',
-                    'Joghurt' => 'joghurt',
-                    'Johnnie Walker' => 'johnnie-walker',
-                    'Jura Kaffeemaschinen' => 'jura',
-                    'Just Cause' => 'just-cause',
-                    'Just Cause 4' => 'just-cause-4',
-                    'Kaffee' => 'kaffee',
-                    'Kaffeekapseln' => 'kaffeekapseln',
-                    'Kaffeemaschinen' => 'kaffeemaschinen',
-                    'Kaffeemühlen' => 'kaffeemuehlen',
-                    'Kaffeepadmaschinen' => 'kaffeepadmaschinen',
-                    'Kaffeepads' => 'kaffeepads',
-                    'Kaffeevollautomaten' => 'kaffeevollautomaten',
-                    'Kameras' => 'kamera',
-                    'Kamera Zubehör' => 'kamerazubehoer',
-                    'Kamine' => 'kamine',
-                    'Kapselmaschinen' => 'kapselmaschinen',
-                    'Kärcher' => 'kaercher',
-                    'Kärcher Fenstersauger' => 'kaercher-fenstersauger',
-                    'Kärcher Hochdruckreiniger' => 'kaercher-hochdruckreiniger',
-                    'Kartenspiele' => 'kartenspiel',
-                    'Käse' => 'kaese',
-                    'Katzen' => 'katzen',
-                    'Katzenfutter' => 'katzenfutter',
-                    'Kaufen im Ausland' => 'kaufen-ausland',
-                    'Ketchup' => 'ketchup',
-                    'KFZ Versicherung' => 'kfz-versicherung',
-                    'KIA' => 'kia',
-                    'kiddy' => 'kiddy',
-                    'Kinder Adventskalender' => 'kinder-adventskalender',
-                    'Kinderbekleidung' => 'kinderkleidung',
-                    'Kinderbetten' => 'kinderbett',
-                    'Kinderfahrräder' => 'kinderfahrrad',
-                    'Kinderschuhe' => 'kinderschuhe',
-                    'Kindersitz' => 'kindersitz',
-                    'Kinderwagen' => 'kinderwagen',
-                    'Kinderwagen &amp; Autositze' => 'baby-transport',
-                    'Kinderzimmermöbel' => 'kinderzimmer',
-                    'Kindle' => 'kindle',
-                    'Kindle Oasis' => 'kindle-oasis',
-                    'Kindle Paperwhite' => 'kindle-paperwhite',
-                    'Kingdom Come: Deliverance' => 'kingdom-come-deliverance',
-                    'Kingdom Hearts' => 'kingdom-hearts',
-                    'Kingdom Hearts 3' => 'kingdom-hearts-3',
-                    'Kingston HyperX Cloud Flight' => 'kingston-hyperx-cloud-flight',
-                    'Kingston HyperX Cloud II' => 'hyperx-cloud-ii',
-                    'Kino' => 'kino',
-                    'KitchenAid' => 'kitchenaid',
-                    'Kleider' => 'kleider',
-                    'Kleiderschränke' => 'kleiderschraenke',
-                    'Kleidung' => 'kleidung',
-                    'Klemmbausteine' => 'klemmbausteine',
-                    'Klimaanlagen' => 'klimaanlagen',
-                    'Klimatechnik' => 'klimatechnik',
-                    'Klipsch' => 'klipsch',
-                    'Kochgeräte' => 'kochgeraete',
-                    'Kodak' => 'kodak',
-                    'Koffer' => 'koffer',
-                    'Kohlenmonoxidmelder' => 'kohlenmonoxidmelder',
-                    'Kolonialstil' => 'kolonialstil',
-                    'Kommoden &amp; Sideboards' => 'kommoden-sideboards',
-                    'Kondome' => 'kondome',
-                    'König der Löwen Musical' => 'koenig-der-loewen-musical',
-                    'Kontaktgrills' => 'kontaktgrill',
-                    'Konto &amp; Kreditkarten' => 'konto-kreditkarten',
-                    'Konzert-Tickets' => 'konzerte',
-                    'Kopfhörer' => 'kopfhoerer',
-                    'Körperpflege &amp; Hygiene' => 'koerperpflege',
-                    'Kosmetik' => 'kosmetik',
-                    'Kostüme' => 'kostuem',
-                    'Kraftstoffe &amp; Betriebsstoffe' => 'kraftstoffe-betriebsstoffe',
-                    'Krafttraining' => 'krafttraining',
-                    'Kredit' => 'kredit',
-                    'Kreditkarten' => 'kreditkarten',
-                    'Kreissägen' => 'kreissaegen',
-                    'Kreuzfahrten' => 'kreuzfahrten',
-                    'Krups' => 'krups',
-                    'Küche' => 'kueche',
-                    'Küchengeräte' => 'kuechengeraete',
-                    'Küchenhelfer' => 'kuechenhelfer',
-                    'Küchenmaschinen' => 'kuechenmaschinen',
-                    'Küchenmesser' => 'messer',
-                    'Küchenutensilien' => 'kuechenutensilien',
-                    'Kugelschreiber' => 'kugelschreiber',
-                    'Kühl-Gefrierkombinationen' => 'kuehl-gefrierkombination',
-                    'Kühlboxen' => 'kuehlboxen',
-                    'Kühlschränke' => 'kuehlschrank',
-                    'Kultur &amp; Freizeit' => 'kultur-freizeit',
-                    'Kunst &amp; Hobby' => 'hobby',
-                    'Kurse &amp; Trainings' => 'kurse-trainings',
-                    'Lacoste' => 'lacoste',
-                    'Ladegeräte' => 'ladegeraete',
-                    'Lampen' => 'lampen',
-                    'Landhausstil' => 'landhausstil',
-                    'Landwirtschafts-Simulator' => 'landwirtschafts-simulator',
-                    'Laptops' => 'laptop',
-                    'Laserdrucker' => 'laserdrucker',
-                    'Last Minute Reisen' => 'last-minute',
-                    'Lattenroste' => 'lattenroste',
-                    'Laubsauger' => 'laubsauger',
-                    'Laufräder' => 'laufraeder',
-                    'Laufschuhe' => 'laufschuhe',
-                    'Laufsport' => 'laufsport',
-                    'Lautsprecher' => 'lautsprecher',
-                    'Lavazza' => 'lavazza',
-                    'Lay-Z-Spa Whirlpools' => 'lay-z-spa-whirlpools',
-                    'Lebensmittel' => 'lebensmittel',
-                    'Lebensmittel &amp; Haushalt' => 'food',
-                    'LED Lampen' => 'led-lampen',
-                    'LEGO' => 'lego',
-                    'LEGO Adventskalender' => 'lego-adventskalender',
-                    'LEGO Architecture' => 'lego-architecture',
-                    'LEGO Batman' => 'lego-batman',
-                    'LEGO City' => 'lego-city',
-                    'LEGO Creator' => 'lego-creator',
-                    'LEGO Dimensions' => 'lego-dimensions',
-                    'LEGO DUPLO' => 'lego-duplo',
-                    'LEGO Friends' => 'lego-friends',
-                    'LEGO Harry Potter' => 'lego-harry-potter',
-                    'LEGO Marvel Super Heroes' => 'lego-marvel-super-heroes',
-                    'LEGO Nexo Knights' => 'lego-nexo-knights',
-                    'LEGO NINJAGO' => 'lego-ninjago',
-                    'LEGO Star Wars' => 'lego-star-wars',
-                    'LEGO Star Wars Millennium Falcon' => 'lego-star-wars-millennium-falcon',
-                    'LEGO Super Mario' => 'lego-super-mario',
-                    'LEGO Technic' => 'lego-technic',
-                    'LEGO The Simpsons' => 'lego-simpsons',
-                    'Leifheit' => 'leifheit',
-                    'Lenovo' => 'lenovo',
-                    'Lenovo Laptops' => 'lenovo-laptop',
-                    'Lenovo Tablets' => 'lenovo-tablet',
-                    'Lenovo ThinkPad' => 'lenovo-thinkpad',
-                    'Lenovo Yoga' => 'lenovo-yoga',
-                    'Leonardo' => 'leonardo',
-                    'Leuchtmittel' => 'leuchten',
-                    'Levi&#039;s' => 'levis',
-                    'Lexar' => 'lexar',
-                    'Lexmark' => 'lexmark',
-                    'LG' => 'lg',
-                    'LG Fernseher' => 'lg-fernsher',
-                    'LG G5' => 'lg-g5',
-                    'LG G6' => 'lg-g6',
-                    'LG G7 ThinQ' => 'lg-g7-thinq',
-                    'LG OLED Fernseher' => 'lg-oled-tv',
-                    'LG Smartphones' => 'lg-smartphones',
-                    'LG V30' => 'lg-v30',
-                    'Lichterketten' => 'lichterketten',
-                    'Liebeskind' => 'liebeskind',
-                    'Lieferservice' => 'lieferservice',
-                    'Lindt' => 'lindt',
-                    'Lindt Adventskalender' => 'lindt-adventskalender',
-                    'Logitech' => 'logitech',
-                    'Logitech G413' => 'logitech-g413',
-                    'Logitech G430' => 'logitech-g430',
-                    'Logitech G502 Proteus Spectrum' => 'logitech-g502',
-                    'Logitech G513' => 'logitech-g513',
-                    'Logitech G533' => 'logitech-g533',
-                    'Logitech G633 Artemis Spectrum' => 'logitech-g633',
-                    'Logitech G703' => 'logitech-g703',
-                    'Logitech G903' => 'logitech-g903',
-                    'Logitech G910 Orion Spectrum' => 'logitech-g910',
-                    'Logitech G915' => 'logitech-g915',
-                    'Logitech G933 Artemis Spectrum' => 'logitech-g933',
-                    'Logitech Harmony' => 'logitech-harmony',
-                    'Logitech Mäuse' => 'logitech-maeuse',
-                    'Logitech MX Master' => 'logitech-mx-master',
-                    'Logitech MX Master 2S' => 'logitech-mx-master-2s',
-                    'Logitech Tastaturen' => 'logitech-tastaturen',
-                    'Logitech Z333' => 'logitech-z333',
-                    'Logitech Z337' => 'logitech-z337',
-                    'Logitech Z906' => 'logitech-z906',
-                    'Luftbefeuchter' => 'luftbefeuchter',
-                    'Luftentfeuchter' => 'luftentfeuchter',
-                    'Luftmatratzen' => 'luftmatratzen',
-                    'Luftreiniger' => 'luftreiniger',
-                    'Luigi&#039;s Mansion' => 'luigis-mansion',
-                    'Luigi&#039;s Mansion 3' => 'luigis-mansion-3',
-                    'Lustiges Taschenbuch' => 'lustiges-taschenbuch',
-                    'M.2 SSD' => 'm2-ssd',
-                    'MacBook' => 'macbook',
-                    'MacBook Air' => 'macbook-air',
-                    'MacBook Pro' => 'macbook-pro',
-                    'MacBook Pro 13' => 'macbook-pro-13',
-                    'MacBook Pro 15' => 'macbook-pro-15',
-                    'MacBook Pro 16' => 'macbook-pro-16',
-                    'Mac mini' => 'mac-mini',
-                    'Mac Software' => 'mac-software',
-                    'Madden NFL' => 'madden-nfl',
-                    'Magazine' => 'magazine',
-                    'Magnat' => 'magnat',
-                    'Magnum Eis' => 'magnum-eis',
-                    'Mähroboter' => 'maehroboter',
-                    'Mainboards' => 'mainboards',
-                    'Make Up Adventskalender' => 'make-up-adventskalender',
-                    'Makita' => 'makita',
-                    'Makita Akkuschrauber' => 'makita-akkuschrauber',
-                    'Malerwerkzeuge' => 'malerpinsel',
-                    'Mangas' => 'mangas',
-                    'Marantz' => 'marantz',
-                    'Mario Kart' => 'mario-kart',
-                    'Mario Kart 8 Deluxe' => 'mario-kart-8-deluxe',
-                    'Marken' => 'marken',
-                    'Marvel' => 'marvel',
-                    'Marvel&#039;s Spider-Man: Miles Morales' => 'marvels-spider-man-miles-morales',
-                    'Mass Effect' => 'mass-effect',
-                    'Mass Effect: Andromeda' => 'mass-effect-andromeda',
-                    'Massivholzmöbel' => 'massivholzmoebel',
-                    'Mastercard' => 'mastercard',
-                    'Matratzen' => 'matratzen',
-                    'Maxi Cosi' => 'maxi-cosi',
-                    'Mazda' => 'mazda',
-                    'Medion' => 'medion',
-                    'Mercedes-Benz' => 'mercedes-benz',
-                    'Mesh WLAN Router' => 'mesh-wlan-router',
-                    'Metabo' => 'metabo',
-                    'Metro (Spiel)' => 'metro',
-                    'Metro Exodus' => 'metro-exodus',
-                    'Michael Kors' => 'michael-kors',
-                    'microSD' => 'microsd',
-                    'microSDHC' => 'microsdhc',
-                    'microSDXC' => 'microsdxc',
-                    'Microsoft Flight Simulator' => 'microsoft-flight-simulator',
-                    'Microsoft Software' => 'microsoft-software',
-                    'Microsoft Surface Notebooks' => 'microsoft-surface-notebooks',
-                    'Microsoft Surface Pro 4' => 'surface-pro-4',
-                    'Microsoft Surface Pro 6' => 'surface-pro-6',
-                    'Microsoft Surface Pro 7' => 'microsoft-surface-pro-7',
-                    'Microsoft Surface Tablets' => 'microsoft-surface',
-                    'Miele' => 'miele',
-                    'Miele Geschirrspüler' => 'miele-geschirrspueler',
-                    'Miele Staubsauger' => 'miele-staubsauger',
-                    'Miele Waschmaschinen' => 'miele-waschmaschine',
-                    'Mietwagen' => 'mietwagen',
-                    'Mikrofone' => 'mikrofone',
-                    'Mikrowellen' => 'mikrowelle',
-                    'Milchaufschäumer' => 'milchaufschaeumer',
-                    'Milka' => 'milka',
-                    'Minecraft' => 'minecraft',
-                    'Mineralwasser' => 'mineralwasser',
-                    'Minions' => 'minions',
-                    'Mini PCs' => 'mini-pc',
-                    'Mitsubishi' => 'mitsubishi',
-                    'Mittelerde' => 'middle-earth',
-                    'Mittelerde: Mordors Schatten' => 'mittelerde-mordors-schatten',
-                    'Mittelerde: Schatten des Krieges' => 'mittelerde-schatten-des-krieges',
-                    'Mixer &amp; Rührer' => 'mixer',
-                    'Möbel' => 'moebel-deko',
-                    'Modellbau' => 'modellbau',
-                    'Modern wohnen' => 'modern-wohnen',
-                    'Monitore' => 'monitor',
-                    'Monkey 47' => 'monkey-47',
-                    'Monopoly' => 'monopoly',
-                    'Monster Hunter' => 'monster-hunter',
-                    'Monster Hunter: World' => 'monster-hunter-world',
-                    'Mortal Kombat' => 'mortal-kombat',
-                    'Mortal Kombat 11' => 'mortal-kombat-11',
-                    'Motorola' => 'motorola',
-                    'Motorola Smartphones' => 'motorola-smartphones',
-                    'Motorradbekleidung' => 'motorradbekleidung',
-                    'Motorradhelm' => 'motorradhelm',
-                    'Motorrad Zubehör' => 'motorrad',
-                    'Moto Z' => 'moto-z',
-                    'Mountainbikes' => 'mountainbikes',
-                    'MSI' => 'msi',
-                    'Mülleimer' => 'muelleimer',
-                    'Multifunktionsdrucker' => 'multifunktionsdrucker',
-                    'Multiroom Speaker' => 'multiroom',
-                    'Mund- &amp; Zahnpflege' => 'mund-zahnpflege',
-                    'Mundschutzmasken' => 'mundschutzmasken',
-                    'Museums-Tickets' => 'museum',
-                    'Musical Tickets' => 'musical',
-                    'Musik' => 'musik',
-                    'Musik Apps' => 'musik-apps',
-                    'Musikinstrumente' => 'musikinstrumente',
-                    'Musik Streaming' => 'musik-streaming',
-                    'Müsli' => 'muesli',
-                    'Mustang' => 'mustang',
-                    'Mützen' => 'muetzen',
-                    'Nachtwäsche' => 'nachtwaesche',
-                    'Nähbedarf' => 'naehen',
-                    'Nähmaschinen' => 'naehmaschine',
-                    'Nahrungsergänzungsmittel' => 'nahrungsergaenzungsmittel',
-                    'Nahverkehr' => 'nahverkehr',
-                    'Naketano' => 'naketano',
-                    'NAS' => 'nas',
-                    'Nassrasierer' => 'rasierer',
-                    'Navigationsgeräte' => 'navigationsgeraete',
-                    'Neato' => 'neato',
-                    'Neato Robotics Botvac D7 Connected' => 'neato-botvac-d7',
-                    'Need for Speed' => 'need-for-speed',
-                    'Need for Speed Heat' => 'need-for-speed-heat',
-                    'Need for Speed Payback' => 'need-for-speed-payback',
-                    'Nerf' => 'nerf',
-                    'Nescafé' => 'nescafe',
-                    'Nespresso' => 'nespresso',
-                    'Nespresso Kaffeemaschinen' => 'nespresso-kaffeemaschinen',
-                    'Netflix' => 'netflix',
-                    'NETGEAR' => 'netgear',
-                    'NETGEAR Nighthawk' => 'netgear-nighthawk',
-                    'NETGEAR Orbi' => 'netgear-orbi',
-                    'NETGEAR Router' => 'netgear-router',
-                    'Netzteile' => 'netzteile',
-                    'Netzwerk' => 'netzwerk',
-                    'New Balance' => 'new-balance',
-                    'Nike' => 'nike',
-                    'Nike Air Force 1' => 'nike-air-force',
-                    'Nike Air Max' => 'nike-air-max',
-                    'Nike Air Max 270' => 'nike-air-max-270',
-                    'Nike Air Max 720' => 'nike-air-max-720',
-                    'Nike Air Max Thea' => 'nike-air-max-thea',
-                    'Nike Air Presto' => 'nike-presto',
-                    'Nike Free' => 'nike-free',
-                    'Nike Huarache' => 'nike-huarache',
-                    'Nike Roshe Run' => 'nike-roshe-run',
-                    'Nike Schuhe' => 'nike-schuhe',
-                    'Nikon' => 'nikon',
-                    'Nikon DSLR' => 'nikon-dslr',
-                    'Ni No Kuni' => 'ni-no-kuni',
-                    'Ni No Kuni: Der Fluch der Weißen Königin' => 'ni-no-kuni-der-fluch-der-weissen-koenigin',
-                    'Ni No Kuni II: Revenant Kingdom' => 'ni-no-kuni-ii',
-                    'Nintendo' => 'nintendo',
-                    'Nintendo 2DS Konsolen' => 'nintendo-2ds',
-                    'Nintendo 3DS Konsolen' => 'nintendo-3ds',
-                    'Nintendo 3DS Spiele' => 'nintendo-3ds-spiele',
-                    'Nintendo 3DS Zubehör' => 'nintendo-3ds-zubehoer',
-                    'Nintendo Classic Mini NES Konsolen' => 'nintendo-classic-mini-nes',
-                    'Nintendo Classic Mini SNES Konsolen' => 'nintendo-classic-mini-snes',
-                    'Nintendo eShop Guthaben' => 'nintendo-eshop-guthaben',
-                    'Nintendo Switch Controller' => 'nintendo-switch-controller',
-                    'Nintendo Switch Konsolen' => 'nintendo-switch',
-                    'Nintendo Switch Lite Konsolen' => 'nintendo-switch-lite',
-                    'Nintendo Switch Pro Controller' => 'nintendo-switch-pro-controller',
-                    'Nintendo Switch Spiele' => 'nintendo-switch-spiele',
-                    'Nintendo Switch Zubehör' => 'nintendo-switch-zubehoer',
-                    'Nintendo Zubehör' => 'nintendo-zubehoer',
-                    'Nissan' => 'nissan',
-                    'Nivea' => 'nivea',
-                    'Nokia' => 'nokia',
-                    'Nokia Handys' => 'nokia-handys',
-                    'Nudeln' => 'nudeln',
-                    'Nuki Smart Locks' => 'nuki-smart-lock',
-                    'Nüsse' => 'nuesse',
-                    'Nutella' => 'nutella',
-                    'Nvidia' => 'nvidia',
-                    'Nvidia GeForce' => 'nvidia-geforce',
-                    'Nvidia SHIELD TV' => 'nvidia-shield',
-                    'o2' => 'o2-netz',
-                    'Objektive' => 'objektiv',
-                    'Obst' => 'obst',
-                    'Obst &amp; Gemüse' => 'obst-gemuese',
-                    'Oculus Quest' => 'oculus-quest',
-                    'Oculus Rift' => 'oculus-rift',
-                    'Office Programme' => 'office-programme',
-                    'OLED Fernseher' => 'oled-fernseher',
-                    'Olympus' => 'olympus',
-                    'On-Ear Kopfhörer' => 'on-ear-kopfhoerer',
-                    'OnePlus 3' => 'oneplus-3',
-                    'OnePlus 5' => 'oneplus-5',
-                    'OnePlus 6' => 'oneplus-6',
-                    'OnePlus 7' => 'oneplus-7',
-                    'OnePlus 7 Pro' => 'oneplus-7-pro',
-                    'OnePlus 7T' => 'oneplus-7t',
-                    'OnePlus 7T Pro' => 'oneplus-7t-pro',
-                    'OnePlus 8' => 'oneplus-8',
-                    'OnePlus 8 Pro' => 'one-plus-8-pro',
-                    'OnePlus 8T' => 'oneplus-8t',
-                    'OnePlus Nord' => 'oneplus-nord',
-                    'OnePlus Smartphones' => 'oneplus-smartphones',
-                    'Onkyo' => 'onkyo',
-                    'Opel' => 'opel',
-                    'OPPO Find X2 Lite' => 'oppo-find-x2-lite',
-                    'OPPO Find X2 Neo' => 'oppo-find-x2-neo',
-                    'OPPO Find X2 Pro' => 'oppo-find-x2-pro',
-                    'OPPO Reno2' => 'oppo-reno2',
-                    'OPPO Reno2 Z' => 'oppo-reno2-z',
-                    'OPPO Reno4 5G' => 'oppo-reno4-5g',
-                    'OPPO Reno4 Pro 5G' => 'oppo-reno4-pro-5g',
-                    'OPPO Reno4 Z 5G' => 'oppo-reno4-z-5g',
-                    'OPPO Smartphones' => 'oppo-smartphones',
-                    'Oral-B' => 'oral-b',
-                    'Oral-B Elektrische Zahnbürsten' => 'oral-b-elektrische-zahnbuersten',
-                    'Origin' => 'origin',
-                    'Osram' => 'osram',
-                    'Osram Smart+' => 'osram-smart-plus',
-                    'Osterdeko' => 'osterdeko',
-                    'Outdoor &amp; Camping' => 'outdoor',
-                    'Outdoorbekleidung' => 'outdoorbekleidung',
-                    'Outdoorjacken' => 'outdoorjacken',
-                    'Outdoor Spielzeuge' => 'outdoor-spielzeug',
-                    'Over-Ear Kopfhörer' => 'over-ear-kopfhoerer',
-                    'Pampers' => 'pampers',
-                    'Panama Jack' => 'panama-jack',
-                    'Panasonic' => 'panasonic',
-                    'Panasonic Fernseher' => 'panasonic-fernseher',
-                    'Panasonic Kameras' => 'panasonic-kameras',
-                    'Panasonic Lumix' => 'panasonic-lumix',
-                    'Paper Mario: The Origami King' => 'paper-mario-the-origami-king',
-                    'Papiertapete' => 'papiertapete',
-                    'Parfum' => 'parfum',
-                    'Parfum Damen' => 'parfum-damen',
-                    'Parfum Herren' => 'parfum-herren',
-                    'Pauschalreisen' => 'pauschalreise',
-                    'Pavillons' => 'pavillons',
-                    'Paw Patrol' => 'paw-patrol',
-                    'PAYBACK' => 'payback',
-                    'Payday' => 'payday',
-                    'Payday 2' => 'payday-2',
-                    'paydirekt' => 'paydirekt',
-                    'PC Gaming Systeme' => 'pc-gaming-systeme',
-                    'PC Gaming Zubehör' => 'pc-gaming-zubehoer',
-                    'PC Gehäuse' => 'pc-gehaeuse',
-                    'PC Komponenten' => 'hardware',
-                    'PC Lautsprecher' => 'pc-lautsprecher',
-                    'PC Mäuse' => 'pc-maus',
-                    'PC Spiele' => 'pc-spiele',
-                    'PC Zubehör' => 'pc-zubehoer',
-                    'Pendelleuchten' => 'pendelleuchten',
-                    'Pentax' => 'pentax',
-                    'Pepe Jeans' => 'pepe-jeans',
-                    'Peppa Wutz' => 'peppa-wutz',
-                    'PepperBonus' => 'pepperbonus',
-                    'Pestos' => 'pestos',
-                    'Peugeot' => 'peugeot',
-                    'Pfannen' => 'pfannen',
-                    'Pflanzen' => 'pflanzen',
-                    'Philips' => 'philips',
-                    'Philips Fernseher' => 'philips-fernseher',
-                    'Philips Hue' => 'philips-hue',
-                    'Philips Hue E14' => 'philips-hue-e14',
-                    'Philips Hue E27' => 'philips-hue-e27',
-                    'Philips Hue Go' => 'philips-hue-go',
-                    'Philips Hue GU10' => 'philips-hue-gu10',
-                    'Philips Hue LightStrip' => 'philips-hue-lightstrip',
-                    'Philips Hue Play Gradient LightStrip' => 'philips-hue-play-gradient-lightstrip',
-                    'Philips Hue Play HDMI Sync Box' => 'philips-hue-play-hdmi-sync-box',
-                    'Philips Hue Play Lightbar' => 'philips-hue-play',
-                    'Philips OneBlade' => 'philips-oneblade',
-                    'Philips Rasierer' => 'philips-rasierer',
-                    'Philips Sonicare' => 'philips-sonicare',
-                    'Philips Staubsauger' => 'philips-staubsauger',
-                    'Philips Wecker' => 'philips-wecker',
-                    'Photoshop' => 'photoshop',
-                    'Pioneer' => 'pioneer',
-                    'Pizza' => 'pizza',
-                    'Plattenspieler' => 'plattenspieler',
-                    'Playboy' => 'playboy',
-                    'Playerunknown&#039;s Battlegrounds' => 'playerunknowns-battlegrounds',
-                    'PLAYMOBIL' => 'playmobil',
-                    'PLAYMOBIL Adventskalender' => 'playmobil-adventskalender',
-                    'PlayStation' => 'playstation',
-                    'PlayStation 4 Controller' => 'playstation-4-controller',
-                    'PlayStation 4 Konsolen' => 'playstation-4',
-                    'PlayStation 4 Pro Konsolen' => 'playstation-4-pro',
-                    'PlayStation 4 Spiele' => 'playstation-4-spiele',
-                    'PlayStation 5 Konsolen' => 'playstation-5',
-                    'PlayStation 5 Spiele' => 'playstation-5-spiele',
-                    'PlayStation Classic Konsolen' => 'playstation-classic',
-                    'PlayStation Now' => 'playstation-now',
-                    'PlayStation Plus' => 'playstation-plus',
-                    'PlayStation Zubehör' => 'playstation-zubehoer',
-                    'Plüschtiere' => 'plueschtiere',
-                    'Plus Size Mode' => 'plus-size-mode',
-                    'POCO F2 Pro' => 'poco-f2-pro',
-                    'POCO X3' => 'poco-x3',
-                    'Pokémon' => 'pokemon',
-                    'Pokémon: Let&#039;s Go' => 'pokemon-lets-go',
-                    'Pokémon Schwert und Schild' => 'pokemon-schwert-schild',
-                    'Pokémon Tekken' => 'pokemon-tekken',
-                    'Pokémon Ultrasonne &amp; Ultramond' => 'pokemon-ultrasonne-ultramond',
-                    'Poloshirts' => 'poloshirts',
-                    'Polsterbetten' => 'polsterbetten',
-                    'Polyrattan Möbel' => 'polyrattan',
-                    'Pools' => 'pools',
-                    'Powerbanks' => 'powerbanks',
-                    'Powerbeats Pro' => 'powerbeats',
-                    'Preisfehler' => 'preisfehler',
-                    'Prepaid-Tarife' => 'prepaid-tarife',
-                    'Prime Gaming' => 'twitch-prime',
-                    'Pro Evolution Soccer' => 'pro-evolution-soccer',
-                    'Pro Evolution Soccer 2018' => 'pes-2018',
-                    'Pro Evolution Soccer 2019' => 'pes-2019',
-                    'Pro Evolution Soccer 2020' => 'pes-2020',
-                    'Proteine' => 'whey-proteine',
-                    'Prozessoren' => 'prozessoren',
-                    'PSN Guthaben' => 'psn-guthaben',
-                    'Puky' => 'puky',
-                    'Pullover' => 'pullover',
-                    'PUMA' => 'puma',
-                    'Pumps' => 'pumps',
-                    'Puppen' => 'puppen',
-                    'Puppenhäuser' => 'puppenhaeuser',
-                    'Puzzles' => 'puzzle',
-                    'Qeridoo' => 'qeridoo',
-                    'Qeridoo Fahrradanhänger' => 'qeridoo-fahrradanhaenger',
-                    'Qeridoo KidGoo 2' => 'qeridoo-kidgoo-2',
-                    'Qeridoo Sportrex 2' => 'qeridoo-sportrex-2',
-                    'Quiksilver' => 'quiksilver',
-                    'Raclettes' => 'raclettes',
-                    'Radios' => 'radios',
-                    'Radsport' => 'radsport',
-                    'Rasenmäher' => 'rasenmaeher',
-                    'Rasentrimmer' => 'rasentrimmer',
-                    'Rasierklingen' => 'rasierklingen',
-                    'Raspberry Pi' => 'raspberry-pi',
-                    'Rasur, Enthaarung &amp; Trimmen' => 'rasur-enthaarung',
-                    'Rauchmelder' => 'rauchmelder',
-                    'Ravensburger' => 'ravensburger',
-                    'Ray-Ban' => 'ray-ban',
-                    'Razer DeathAdder' => 'razer-deathadder',
-                    'RC Autos' => 'rc-autos',
-                    'Red Bull' => 'red-bull',
-                    'Red Dead Redemption' => 'red-dead-redemption',
-                    'Red Dead Redemption 2' => 'red-dead-redemption-2',
-                    'Reebok' => 'reebok',
-                    'Regale' => 'regale',
-                    'Reifen' => 'reifen',
-                    'Reinigungsmittel' => 'reinigungsmittel',
-                    'Reise Apps' => 'reise-apps',
-                    'Reisen' => 'reisen',
-                    'Reiskocher' => 'reiskocher',
-                    'Remington' => 'remington',
-                    'Renault' => 'renault',
-                    'Rennräder' => 'rennraeder',
-                    'Repeater' => 'repeater',
-                    'Resident Evil' => 'resident-evil',
-                    'Resident Evil 2' => 'resident-evil-2',
-                    'Resident Evil 7' => 'resident-evil-7',
-                    'Restaurant' => 'restaurant',
-                    'Retro Stil' => 'retro-stil',
-                    'Rimowa' => 'rimowa',
-                    'Ring Fit Adventure' => 'ring-fit-adventure',
-                    'Rituals' => 'rituals',
-                    'Rituals Adventskalender' => 'rituals-adventskalender',
-                    'Roborock' => 'xiaomi-roborock',
-                    'Roborock S5 Max' => 'roborock-s5-max',
-                    'Roborock S6' => 'roborock-s6',
-                    'Roborock S6 MaxV' => 'roborock-s6-maxv',
-                    'ROCCAT' => 'roccat',
-                    'ROCCAT Tyon' => 'roccat-tyon',
-                    'Röcke' => 'roecke',
-                    'Rocket League' => 'rocket-league',
-                    'Roidmi Staubsauger' => 'roidmi-staubsauger',
-                    'Rollei' => 'rollei',
-                    'Rösle' => 'roesle',
-                    'Router' => 'router',
-                    'Roxy' => 'roxy',
-                    'RTX 2060' => 'rtx-2060',
-                    'RTX 2070' => 'rtx-2070',
-                    'RTX 2080' => 'rtx-2080',
-                    'RTX 2080 Ti' => 'rtx-2080-ti',
-                    'RTX 3070' => 'rtx-3070',
-                    'RTX 3080' => 'rtx-3080',
-                    'RTX 3090' => 'rtx-3090',
-                    'Rucksäcke' => 'rucksaecke',
-                    'Russell Hobbs' => 'russell-hobbs',
-                    'RX 480' => 'rx-480',
-                    'RX 570' => 'rx-570',
-                    'RX 580' => 'rx-580',
-                    'RX 590' => 'rx-590',
-                    'RX 5700 XT' => 'rx-5700-xt',
-                    'RX 6800' => 'rx-6800',
-                    'RX 6800 XT' => 'rx-6800-xt',
-                    'RX 6900 XT' => 'rx-6900-xt',
-                    'RX Vega 56' => 'rx-vega-56',
-                    'RX Vega 64' => 'rx-vega-64',
-                    'Sägen' => 'saegen',
-                    'Salomon' => 'salomon',
-                    'Samsonite' => 'samsonite',
-                    'Samsung' => 'samsung',
-                    'Samsung Fernseher' => 'samsung-fernseher',
-                    'Samsung Galaxy A7' => 'samsung-galaxy-a7',
-                    'Samsung Galaxy A8' => 'samsung-galaxy-a8',
-                    'Samsung Galaxy A51' => 'samsung-galaxy-a51',
-                    'Samsung Galaxy A71' => 'samsung-galaxy-a71',
-                    'Samsung Galaxy Buds' => 'samsung-galaxy-buds',
-                    'Samsung Galaxy Buds+' => 'samsung-galaxy-buds-plus',
-                    'Samsung Galaxy Buds Live' => 'samsung-galaxy-buds-live',
-                    'Samsung Galaxy Buds Pro' => 'samsung-galaxy-buds-pro',
-                    'Samsung Galaxy Note9' => 'samsung-galaxy-note-9',
-                    'Samsung Galaxy Note20' => 'samsung-galaxy-note20',
-                    'Samsung Galaxy Note20 Ultra' => 'samsung-galaxy-note20-ultra',
-                    'Samsung Galaxy S7' => 'samsung-galaxy-s7',
-                    'Samsung Galaxy S7 Edge' => 'samsung-galaxy-s7-edge',
-                    'Samsung Galaxy S8' => 'samsung-galaxy-s8',
-                    'Samsung Galaxy S8+' => 'samsung-galaxy-s8-plus',
-                    'Samsung Galaxy S9' => 'samsung-galaxy-s9',
-                    'Samsung Galaxy S9+' => 'samsung-galaxy-s9-plus',
-                    'Samsung Galaxy S10' => 'samsung-galaxy-s10',
-                    'Samsung Galaxy S10+' => 'samsung-galaxy-s10-plus',
-                    'Samsung Galaxy S10e' => 'samsung-galaxy-s10e',
-                    'Samsung Galaxy S20' => 'samsung-galaxy-s20',
-                    'Samsung Galaxy S20 FE' => 'samsung-galaxy-s20-fe',
-                    'Samsung Galaxy S20 Ultra' => 'samsung-galaxy-s20-ultra',
-                    'Samsung Galaxy S20+' => 'samsung-galaxy-s20-plus',
-                    'Samsung Galaxy S21 5G' => 'samsung-galaxy-s21-5g',
-                    'Samsung Galaxy S21 Ultra 5G' => 'samsung-galaxy-s21-ultra-5g',
-                    'Samsung Galaxy S21+ 5G' => 'samsung-galaxy-s21-plus-5g',
-                    'Samsung Galaxy Tab S4' => 'samsung-galaxy-tab-s4',
-                    'Samsung Galaxy Tab S6' => 'samsung-galaxy-tab-s6',
-                    'Samsung Galaxy Watch' => 'samsung-galaxy-watch',
-                    'Samsung Galaxy Watch Active2' => 'samsung-galaxy-watch-active-2',
-                    'Samsung Gear' => 'samsung-gear',
-                    'Samsung Gear S3' => 'samsung-gear-s3',
-                    'Samsung Gear VR' => 'samsung-gear-vr',
-                    'Samsung Kopfhörer' => 'samsung-kopfhoerer',
-                    'Samsung Kühlschränke' => 'samsung-kuehlschrank',
-                    'Samsung Monitore' => 'samsung-monitor',
-                    'Samsung QLED Fernseher' => 'samsung-qled-fernseher',
-                    'Samsung Smartphones' => 'samsung-smartphone',
-                    'Samsung SSD' => 'samsung-ssd',
-                    'Samsung Tablets' => 'samsung-tablet',
-                    'Samsung The Frame Fernseher' => 'samsung-the-frame-fernseher',
-                    'Samsung Waschmaschinen' => 'samsung-waschmaschine',
-                    'Sandalen' => 'sandalen',
-                    'SanDisk' => 'sandisk',
-                    'SanDisk SSD' => 'sandisk-ssd',
-                    'Sanitär &amp; Armaturen' => 'sanitaer-armaturen',
-                    'Saucen' => 'saucen',
-                    'Saugroboter' => 'saugroboter',
-                    'Scanner' => 'scanner',
-                    'Schallplatten' => 'schallplatten',
-                    'Scheppach' => 'scheppach',
-                    'Schlafsäcke' => 'schlafsack',
-                    'Schlafsofas' => 'schlafsofas',
-                    'Schlafzimmer' => 'schlafzimmer',
-                    'Schlagschrauber' => 'schlagschrauber',
-                    'Schlauchboote' => 'schlauchboote',
-                    'Schleich' => 'schleich',
-                    'Schlitten' => 'schlitten',
-                    'Schmuck' => 'schmuck',
-                    'Schneefräsen' => 'schneefraesen',
-                    'Schnellkochtöpfe' => 'schnellkochtoepfe',
-                    'Schnürhalbschuhe' => 'schnuerhalbschuhe',
-                    'Schokolade' => 'schokolade',
-                    'Schraubendreher' => 'schraubendreher',
-                    'Schreibgeräte' => 'schreibgeraete',
-                    'Schreibtische' => 'schreibtisch',
-                    'Schuhe' => 'schuhe',
-                    'Schuhschränke' => 'schuhschraenke',
-                    'Schulbedarf' => 'schulbedarf',
-                    'Schulranzen' => 'schulranzen',
-                    'Schutzfolien' => 'schutzfolien',
-                    'Schwangerschaft' => 'schwangerschaft',
-                    'Schwerlastregale' => 'schwerlastregale',
-                    'Scooter' => 'scooter',
-                    'Scotch Whisky' => 'scotch-whisky',
-                    'SDHC Speicherkarten' => 'sdhc-speicherkarten',
-                    'SD Karten' => 'sd-karten',
-                    'Seagate' => 'seagate',
-                    'Sea of Thieves' => 'sea-of-thieves',
-                    'Seat' => 'seat',
-                    'Sega Mega Drive Mini Konsolen' => 'sega-mega-drive-mini',
-                    'Seidensticker' => 'seidensticker',
-                    'Sekiro: Shadows Die Twice' => 'sekiro',
-                    'Senf' => 'senf',
-                    'Sennheiser' => 'sennheiser',
-                    'Senseo' => 'senseo',
-                    'Service-Verträge' => 'service-vertraege',
-                    'Sessel' => 'sessel',
-                    'Sextoys' => 'sextoys',
-                    'Shadow of the Tomb Raider' => 'shadow-of-the-tomb-raider',
-                    'Shampoo' => 'shampoo',
-                    'Sharkoon' => 'sharkoon',
-                    'Sharp' => 'sharp',
-                    'Shenmue' => 'shenmue',
-                    'Shenmue I &amp; II' => 'shenmue-i-ii',
-                    'Shenmue III' => 'shenmue-iii',
-                    'Shishas' => 'shishas',
-                    'Shishas &amp; Zubehör' => 'shishas-zubehoer',
-                    'Shoop' => 'shoop',
-                    'Shops: Erfahrungen' => 'shops',
-                    'Shorts' => 'shorts',
-                    'Sicherheitstechnik' => 'sicherheitstechnik',
-                    'Side-by-Side-Kühlschränke' => 'side-by-side-kuehlschrank',
-                    'Sid Meier&#039;s Civilization VI' => 'sid-meiers-civilization-vi',
-                    'Sid Meier’s Civilization' => 'sid-meiers-civilization',
-                    'Siemens' => 'siemens',
-                    'Siemens Geschirrspüler' => 'siemens-geschirrspueler',
-                    'Siemens Kühlschränke' => 'siemens-kuehlschrank',
-                    'Siemens Waschmaschinen' => 'siemens-waschmaschine',
-                    'Silit' => 'silit',
-                    'Skandi Stil' => 'skandi-stil',
-                    'Skateboards' => 'skateboard',
-                    'Skaten' => 'skaten',
-                    'Ski &amp; Snowboard' => 'snowboard',
-                    'Skoda' => 'skoda',
-                    'Sky' => 'sky',
-                    'Sky Ticket' => 'sky-ticket',
-                    'Smarte Beleuchtung' => 'smarte-beleuchtung',
-                    'Smarte Wecker' => 'smarte-wecker',
-                    'Smart Home' => 'smart-home',
-                    'Smart Home Steckdosen' => 'smart-home-steckdosen',
-                    'Smart Locks' => 'smart-lock',
-                    'Smartphones' => 'smartphone',
-                    'Smartphones unter 200€' => 'smartphones-unter-200-euro',
-                    'Smart Speaker' => 'smart-speaker',
-                    'Smart Tech &amp; Gadgets' => 'smart-tech',
-                    'Smartwatches' => 'smartwatch',
-                    'Smoothie Maker' => 'smoothie-maker',
-                    'Snacks &amp; Knabberzeug' => 'snacks-knabberzeug',
-                    'Sneakers' => 'sneaker',
-                    'Socken' => 'socken',
-                    'SodaStream' => 'sodastream',
-                    'Sofas' => 'sofa',
-                    'Sofortbildkameras' => 'sofortbildkameras',
-                    'Softdrinks' => 'softdrinks',
-                    'Software' => 'software',
-                    'Software &amp; Apps' => 'apps-software',
-                    'Solarleuchten' => 'solarleuchten',
-                    'Somat' => 'somat',
-                    'Sommerreifen' => 'sommerreifen',
-                    'Sonnenbrillen' => 'sonnenbrillen',
-                    'Sonnencreme' => 'sonnencreme',
-                    'Sonnenpflege' => 'sonnenpflege',
-                    'Sonnenschirme' => 'sonnenschirme',
-                    'Sonoff' => 'sonoff',
-                    'Sonos' => 'sonos',
-                    'Sonos Beam' => 'sonos-beam',
-                    'Sonos Move' => 'sonos-move',
-                    'Sonos One' => 'sonos-one',
-                    'Sonos PLAY:1' => 'sonos-play-1',
-                    'Sonos PLAY:3' => 'sonos-play-3',
-                    'Sonos Play:5 (Five)' => 'sonos-play-5',
-                    'Sonos Playbar' => 'sonos-playbar',
-                    'Sonos Playbase' => 'sonos-playbase',
-                    'Sonstiges' => 'diverses',
-                    'Sony' => 'sony',
-                    'Sony Alpha 7' => 'sony-alpha-7',
-                    'Sony Alpha 7 II' => 'sony-alpha-7-ii',
-                    'Sony Alpha 7 III' => 'sony-alpha-7-iii',
-                    'Sony Alpha 6000' => 'sony-alpha-6000',
-                    'Sony Alpha 6300' => 'sony-alpha-6300',
-                    'Sony Alpha 6400' => 'sony-alpha-6400',
-                    'Sony Alpha 6500' => 'sony-alpha-6500',
-                    'Sony DualSense Wireless-Controller' => 'playstation-5-controller',
-                    'Sony Fernseher' => 'sony-fernseher',
-                    'Sony Kameras' => 'sony-kameras',
-                    'Sony Kopfhörer' => 'sony-kopfhoerer',
-                    'Sony PlayStation VR' => 'sony-playstation-vr',
-                    'Sony PULSE 3D Wireless Headset' => 'sony-pulse-3d-wireless-headset',
-                    'Sony WF-1000XM3' => 'sony-wf-1000xm3',
-                    'Sony WH-1000XM3' => 'sony-wh-1000xm3',
-                    'Sony WH-1000XM4' => 'sony-wh-1000xm4',
-                    'Sony Xperia' => 'sony-xperia',
-                    'Sony Xperia X' => 'sony-xperia-x',
-                    'Sony Xperia XA' => 'sony-xperia-xa',
-                    'Sony Xperia XZ' => 'sony-xperia-xz',
-                    'Soundbar' => 'soundbar',
-                    'Soundbase' => 'soundbase',
-                    'Soundkarten' => 'soundkarten',
-                    'South Park: Die rektakuläre Zerreißprobe' => 'south-park-die-rektakulaere-zerreissprobe',
-                    'Spartipps' => 'spartipps',
-                    'Speicherkarten' => 'speicherkarten',
-                    'Speichermedien' => 'speichermedien',
-                    'Speiseöle' => 'speiseoele',
-                    'Spiegelreflexkameras' => 'spiegelreflexkamera',
-                    'Spiele &amp; Brettspiele' => 'spiele-brettspiele',
-                    'Spiele Apps' => 'spiele-apps',
-                    'Spielekonsolen' => 'spielekonsolen',
-                    'Spielfiguren &amp; Spielsets' => 'spielfiguren-spielsets',
-                    'Spielzeuge' => 'spielzeug',
-                    'Spirituosen' => 'spirituosen',
-                    'Sport &amp; Outdoor' => 'sport',
-                    'Sportbekleidung' => 'sportbekleidung',
-                    'Sport Bild' => 'sport-bild',
-                    'Sportnahrung' => 'sportlernahrung',
-                    'Sporttasche' => 'sporttasche',
-                    'Spotify' => 'spotify',
-                    'Spülmaschinentabs' => 'spuelmaschinentabs',
-                    'Spyro Reignited Trilogy' => 'spyro-reignited-trilogy',
-                    'SSD' => 'ssd',
-                    'Stabmixer' => 'stabmixer',
-                    'Städtereisen' => 'staedtereise',
-                    'Standmixer' => 'standmixer',
-                    'Star Trek' => 'star-trek',
-                    'Star Wars' => 'star-wars',
-                    'Star Wars: Battlefront 2' => 'star-wars-battlefront-2',
-                    'Star Wars: Squadrons' => 'star-wars-squadrons',
-                    'Star Wars Battlefront' => 'star-wars-battlefront',
-                    'Star Wars Jedi: Fallen Order' => 'star-wars-jedi-fallen-order',
-                    'Staubsauger' => 'staubsauger',
-                    'Staubsaugerbeutel' => 'staubsaugerbeutel',
-                    'Staubsauger ohne Beutel' => 'staubsauger-ohne-beutel',
-                    'Steam' => 'steam',
-                    'Steckschlüssel' => 'steckschluessel',
-                    'SteelSeries' => 'steelseries',
-                    'Stehlampen' => 'stehlampen',
-                    'Steiff' => 'steiff',
-                    'Stern (Magazin)' => 'stern-magazin',
-                    'Stichsägen' => 'stichsaegen',
-                    'Stiefel' => 'stiefel',
-                    'Stiefeletten' => 'stiefeletten',
-                    'Stiftung Warentest' => 'stiftung-warentest-magazin',
-                    'Streaming-Dienste' => 'streaming-dienste',
-                    'Streaming Lautsprecher' => 'streaming-lautsprecher',
-                    'Strom &amp; Gas' => 'strom-gas',
-                    'Stromtarif' => 'stromtarif',
-                    'Studentenrabatte' => 'studentenrabatte',
-                    'Stühle' => 'stuehle',
-                    'Subwoofer' => 'subwoofer',
-                    'SUP Boards' => 'sup-boards',
-                    'Superdry' => 'superdry',
-                    'Super Mario' => 'super-mario',
-                    'Super Mario 3D All-Stars' => 'super-mario-3d-all-stars',
-                    'Super Mario Maker 2' => 'super-mario-maker-2',
-                    'Super Mario Odyssey' => 'super-mario-odyssey',
-                    'Super Mario Party' => 'super-mario-party',
-                    'Supermarkt' => 'supermarkt',
-                    'Super Smash Bros. Ultimate' => 'super-smash-bros-ultimate',
-                    'Süßigkeiten' => 'suessigkeiten',
-                    'Synology' => 'synology',
-                    'Syoss' => 'syoss',
-                    'Systemkameras' => 'systemkamera',
-                    'T-Shirts' => 't-shirts',
-                    'Tablets' => 'tablet',
-                    'Tablet Zubehör' => 'tablet-zubehoer',
-                    'tado° Smartes Heizkörper-Thermostat' => 'tado-smartes-thermostat',
-                    'Tamaris' => 'tamaris',
-                    'Tangle Teezer' => 'tangle-teezer',
-                    'Tanqueray' => 'tanqueray',
-                    'Tapeten' => 'tapeten',
-                    'Taschen' => 'taschen',
-                    'Taschenlampen' => 'taschenlampen',
-                    'Taschentücher' => 'taschentuecher',
-                    'Tassimo' => 'tassimo',
-                    'Tassimo Kaffeemaschinen' => 'tassimo-kaffeemaschinen',
-                    'Tastaturen' => 'tastatur',
-                    'TCL Fernseher' => 'tcl-fernseher',
-                    'Team Sonic Racing' => 'team-sonic-racing',
-                    'Teamsport' => 'teamsport',
-                    'Tee' => 'tee',
-                    'Tefal' => 'tefal',
-                    'Tefal OptiGrills' => 'tefal-optigrill',
-                    'Tefal Pfannen' => 'tefal-pfannen',
-                    'Tekken' => 'tekken',
-                    'Tekken 7' => 'tekken-7',
-                    'Telefon- &amp; Internet-Verträge' => 'telefon-internet',
-                    'Telefone &amp; Zubehör' => 'handy-smartphone',
-                    'Telekom' => 'telekom-net',
-                    'Telekom Magenta' => 'telekom-magenta',
-                    'Telekom SmartHome' => 'telekom-smarthome',
-                    'Teppiche' => 'teppiche',
-                    'Tesla' => 'tesla',
-                    'Tetris' => 'tetris',
-                    'Teufel' => 'teufel',
-                    'The Elder Scrolls' => 'the-elder-scrolls',
-                    'The Elder Scrolls V: Skyrim' => 'skyrim',
-                    'The Evil Within' => 'the-evil-within',
-                    'The Evil Within 2' => 'the-evil-within-2',
-                    'The Last of Us' => 'the-last-of-us',
-                    'The Last of Us Part II' => 'the-last-of-us-part-ii',
-                    'The Legend of Zelda' => 'the-legend-of-zelda',
-                    'The Legend of Zelda: Breath of the Wild' => 'zelda-breath-of-the-wild',
-                    'The Legend of Zelda: Link&#039;s Awakening' => 'zelda-links-awakening',
-                    'The Legend of Zelda: Skyward Sword HD' => 'zelda-skyward-sword-hd',
-                    'The North Face' => 'the-north-face',
-                    'The Outer Worlds' => 'the-outer-worlds',
-                    'Thermosflaschen' => 'thermosflaschen',
-                    'Thermoskannen' => 'thermoskanne',
-                    'The Witcher' => 'the-witcher',
-                    'The Witcher 3' => 'the-witcher-3',
-                    'Thule' => 'thule',
-                    'Thule Chariot Fahrradanhänger' => 'thule-chariot-fahrradanhaenger',
-                    'Thule Dachboxen' => 'thule-dachboxen',
-                    'Thule Fahrradträger' => 'thule-fahrradtraeger',
-                    'Tickets &amp; Shows' => 'erlebnisse',
-                    'Tiefkühlkost' => 'tiefkuehkost',
-                    'Timberland' => 'timberland',
-                    'Tintenstrahldrucker' => 'tintenstrahldrucker',
-                    'Tischlampen' => 'tischlampen',
-                    'Tischtennis' => 'tischtennis',
-                    'Tischtennisplatten' => 'tischtennisplatten',
-                    'Tischtennisschläger' => 'tischtennisschlaeger',
-                    'Toaster' => 'toaster',
-                    'Toilettenpapier' => 'toilettenpapier',
-                    'tolino' => 'tolino',
-                    'Tomb Raider' => 'tomb-raider',
-                    'Tom Clancy&#039;s' => 'tom-clancys',
-                    'Tom Clancy&#039;s: Ghost Recon Wildlands' => 'tom-clancys-ghost-recon-wildlands',
-                    'Tom Clancy&#039;s Ghost Recon Breakpoint' => 'tom-clancys-ghost-recon-breakpoint',
-                    'Tom Clancy&#039;s The Division 2' => 'tom-clancy-the-division-2',
-                    'Tommy Hilfiger' => 'tommy-hilfiger',
-                    'TOM TAILOR' => 'tom-tailor',
-                    'Toner' => 'toner',
-                    'Tonic Water' => 'tonic-water',
-                    'Toniebox' => 'toniebox',
-                    'Tonies Figuren' => 'tonie-figuren',
-                    'Töpfe' => 'toepfe',
-                    'Töpfe &amp; Pfannen' => 'kochen',
-                    'Toplader' => 'toplader',
-                    'Toshiba' => 'toshiba',
-                    'Total War' => 'total-war',
-                    'Toyota' => 'toyota',
-                    'TP-Link' => 'tp-link',
-                    'TP-Link Router' => 'tp-link-router',
-                    'Trampoline' => 'trampolin',
-                    'TREKSTOR' => 'trekstor',
-                    'Trockner' => 'trockner',
-                    'Tropical Islands' => 'tropical-island',
-                    'Tropico' => 'tropico',
-                    'Tropico 5' => 'tropico-5',
-                    'Tropico 6' => 'tropico-6',
-                    'TV &amp; Video' => 'tv-video',
-                    'TV Boxen' => 'tv-box',
-                    'TV Spielfilm' => 'tv-spielfilm',
-                    'TV Wandhalterungen' => 'tv-wandhalterung',
-                    'TV Zubehör' => 'tv-zubehoer',
-                    'Übergangsjacken' => 'uebergangsjacken',
-                    'Überwachungskamera' => 'ueberwachungskamera',
-                    'UE BLAST' => 'ue-blast',
-                    'UE BOOM' => 'ue-boom',
-                    'UE BOOM 2' => 'ue-boom-2',
-                    'UE BOOM 3' => 'ue-boom-3',
-                    'UE MEGABLAST' => 'ue-megablast',
-                    'UE MEGABOOM' => 'ue-megaboom',
-                    'UE MEGABOOM 3' => 'ue-megaboom-3',
-                    'UE WONDERBOOM' => 'ue-wonderboom',
-                    'UE WONDERBOOM 2' => 'ue-wonderboom-2',
-                    'UGG' => 'ugg',
-                    'Uhren' => 'uhren',
-                    'Umstandsmode' => 'umstandsmode',
-                    'Uncharted' => 'uncharted',
-                    'Uncharted 4' => 'uncharted-4',
-                    'Uncharted: The Lost Legacy' => 'uncharted-the-lost-legacy',
-                    'Under Armour' => 'under-armour',
-                    'Universalfernbedienungen' => 'universalfernbedienungen',
-                    'Unterwäsche' => 'unterwaesche',
-                    'Uplay' => 'uplay',
-                    'Urban Sport' => 'urban-sport',
-                    'Urlaub' => 'urlaub',
-                    'USB Sticks' => 'usb-stick',
-                    'Vakuumierer' => 'vakuumierer',
-                    'Vans' => 'vans',
-                    'Vans Old Skool' => 'vans-old-skool',
-                    'Vans Schuhe' => 'vans-schuhe',
-                    'Vaude' => 'vaude',
-                    'Ventilatoren' => 'ventilator',
-                    'Verbandskästen' => 'verbandskaesten',
-                    'Versicherung' => 'versicherung',
-                    'Versicherung &amp; Finanzen' => 'vertraege-finanzen',
-                    'Videobearbeitungsprogramme' => 'videobearbeitungsprogramme',
-                    'Video Player' => 'video-player',
-                    'Videospiele' => 'videospiele',
-                    'Video Streaming' => 'video-streaming',
-                    'Vileda' => 'vileda',
-                    'Villeroy &amp; Boch' => 'villeroy-boch',
-                    'Virenschutz' => 'virenschutz',
-                    'VISA' => 'visa',
-                    'Vliestapeten' => 'vliestapete',
-                    'Vodafone' => 'vodafone-netz',
-                    'Vodka' => 'vodka',
-                    'Volvo' => 'volvo',
-                    'Vorratsdosen' => 'vorratsdosen',
-                    'Vorstellungsrunde' => 'vorstellungsrunde',
-                    'VPN' => 'vpn',
-                    'VPS' => 'vps',
-                    'VR Brillen' => 'vr-brille',
-                    'VR Spiele' => 'vr-spiele',
-                    'VTech' => 'vtech',
-                    'VW' => 'vw',
-                    'Waffeleisen' => 'waffeleisen',
-                    'Wandbilder' => 'wandtattoos',
-                    'Wanderrucksäcke' => 'wanderrucksack',
-                    'Wanderschuhe' => 'wanderschuhe',
-                    'Wandersport' => 'hiking',
-                    'Wandfarben' => 'wandfarben',
-                    'Wandlampen' => 'wandlampen',
-                    'Wäscheständer' => 'waeschestaender',
-                    'Waschmaschinen' => 'waschmaschinen',
-                    'Waschmittel' => 'waschmittel',
-                    'Waschtrockner' => 'waschtrockner',
-                    'Wasserfilter' => 'wasserfilter',
-                    'Wasserkocher' => 'wasserkocher',
-                    'Wasserkühlung' => 'wasserkuehlung',
-                    'Wasserspielzeuge' => 'wasserspielzeug',
-                    'Wassersport' => 'wassersport',
-                    'Watch Dogs' => 'watch-dogs',
-                    'Watch Dogs 2' => 'watch-dogs-2',
-                    'Watch Dogs: Legion' => 'watch-dogs-legion',
-                    'WC Sitze' => 'wc-sitze',
-                    'WD-40' => 'wd-40',
-                    'Wearables' => 'wearable',
-                    'Webcams' => 'webcam',
-                    'Weber Gasgrills' => 'weber-gasgrill',
-                    'Weber Grills' => 'weber-grill',
-                    'Weihnachtsbäume' => 'weihnachtsbaum',
-                    'Weihnachtsbeleuchtung' => 'weihnachtsbeleuchtung',
-                    'Weihnachtsdeko' => 'weihnachtsdeko',
-                    'Weihnachtspullover' => 'weihnachtspullover',
-                    'Wein' => 'wein',
-                    'Wellensteyn' => 'wellensteyn',
-                    'Wellness &amp; Gesundheit' => 'wellness-massagen',
-                    'Wera' => 'wera',
-                    'Werkstatt &amp; Service' => 'werkstatt-service',
-                    'Werkstatteinrichtungen' => 'werkstatteinrichtungen',
-                    'Werkzeuge' => 'werkzeug',
-                    'Werkzeugkoffer' => 'werkzeugkoffer',
-                    'Wesco Mülleimer' => 'wesco-muelleimer',
-                    'Western Digital' => 'western-digital',
-                    'Wetterstationen' => 'wetterstationen',
-                    'Whirlpools' => 'whirlpools',
-                    'Whisky' => 'whisky',
-                    'Wiko' => 'wiko',
-                    'Wilkinson Sword Rasierer' => 'wilkinson-sword',
-                    'Windeln' => 'windeln',
-                    'Winkelschleifer' => 'winkelschleifer',
-                    'Winterdeko' => 'winterdeko',
-                    'Winterjacken' => 'winterjacken',
-                    'Winterreifen' => 'winterreifen',
-                    'Winterstiefel' => 'winterstiefel',
-                    'Wireless Charger' => 'wireless-charger',
-                    'Wirtschaftswoche' => 'wirtschaftswoche',
-                    'WMF' => 'wmf',
-                    'WMF Besteck' => 'wmf-besteck',
-                    'WMF Topfset' => 'wmf-topfset',
-                    'Wohnzimmermöbel' => 'wohnzimmer',
-                    'Wolfenstein' => 'wolfenstein',
-                    'Wolfenstein II: The New Colossus' => 'wolfenstein-2-the-new-colossus',
-                    'Womanizer' => 'womanizer',
-                    'World of Warcraft' => 'world-of-warcraft',
-                    'Wrangler' => 'wrangler',
-                    'X570 Mainboard' => 'x570-mainboard',
-                    'Xbox' => 'xbox',
-                    'Xbox Controller' => 'xbox-controller',
-                    'Xbox Elite Wireless Controller' => 'xbox-one-elite-controller',
-                    'Xbox Elite Wireless Controller 2' => 'xbox-one-elite-controller-2',
-                    'Xbox Game Pass' => 'xbox-game-pass',
-                    'Xbox Game Pass Ultimate' => 'xbox-game-pass-ultimate',
-                    'Xbox Guthaben' => 'xbox-guthaben',
-                    'Xbox Live Gold' => 'xbox-live',
-                    'Xbox One Controller' => 'xbox-one-controller',
-                    'Xbox One S Konsolen' => 'xbox-one-s',
-                    'Xbox One Spiele' => 'xbox-one-spiele',
-                    'Xbox One X Konsolen' => 'xbox-one-x',
-                    'Xbox Series S Konsolen' => 'xbox-series-s',
-                    'Xbox Series X Controller' => 'xbox-series-x-controller',
-                    'Xbox Series X Konsolen' => 'xbox-series-x',
-                    'Xbox Series X Spiele' => 'xbox-series-x-spiele',
-                    'Xbox Wireless Headset' => 'xbox-wireless-headset',
-                    'Xbox Zubehör' => 'xbox-zubehoer',
-                    'Xiaomi' => 'xiaomi',
-                    'Xiaomi Air Laptop' => 'xiaomi-air',
-                    'Xiaomi E-Scooter' => 'xiaomi-e-scooter',
-                    'Xiaomi Fernseher' => 'xiaomi-fernseher',
-                    'Xiaomi Kopfhörer' => 'xiaomi-kopfhoerer',
-                    'Xiaomi Mi 5S' => 'xiaomi-mi-5',
-                    'Xiaomi Mi 6' => 'xiaomi-mi-6',
-                    'Xiaomi Mi 8' => 'xiaomi-mi-8',
-                    'Xiaomi Mi 8 Lite' => 'xiaomi-mi-8-lite',
-                    'Xiaomi Mi 8 Pro' => 'xiaomi-mi-8-pro',
-                    'Xiaomi Mi 9' => 'xiaomi-mi-9',
-                    'Xiaomi Mi 9 Lite' => 'xiaomi-mi-9-lite',
-                    'Xiaomi Mi 9 SE' => 'xiaomi-mi-9-se',
-                    'Xiaomi Mi 9T' => 'xiaomi-mi-9t',
-                    'Xiaomi Mi 9T Pro' => 'xiaomi-mi-9t-pro',
-                    'Xiaomi Mi 10' => 'xiaomi-mi-10',
-                    'Xiaomi Mi 10 Lite' => 'xiaomi-mi-10-lite',
-                    'Xiaomi Mi 10 Pro' => 'xiaomi-mi-10-pro',
-                    'Xiaomi Mi 11' => 'xiaomi-mi-11',
-                    'Xiaomi Mi A1' => 'xiaomi-mi-a1',
-                    'Xiaomi Mi A2' => 'xiaomi-mi-a2',
-                    'Xiaomi Mi AirDots' => 'xiaomi-mi-airdots',
-                    'Xiaomi Mi AirDots Pro' => 'xiaomi-airdots-pro',
-                    'Xiaomi Mi Band' => 'xiaomi-mi-band',
-                    'Xiaomi Mi Band 4' => 'xiaomi-mi-band-4',
-                    'Xiaomi Mi Band 5' => 'xiaomi-mi-band-5',
-                    'Xiaomi Mi Electric Scooter 1S' => 'xiaomi-mi-scooter-1s',
-                    'Xiaomi Mi Electric Scooter M365' => 'xiaomi-mi-electric-scooter-m365',
-                    'Xiaomi Mi Electric Scooter Pro 2' => 'xiaomi-mi-electric-scooter-pro-2',
-                    'Xiaomi Mi Mix' => 'xiaomi-mi-mix',
-                    'Xiaomi Mi Mix 3' => 'xiaomi-mi-mix-3',
-                    'Xiaomi Mi Note' => 'xiaomi-mi-note',
-                    'Xiaomi Mi Note 10' => 'xiaomi-mi-note-10',
-                    'Xiaomi Mi Note 10 Lite' => 'xiaomi-mi-note-10-lite',
-                    'Xiaomi Mi Note 10 Pro' => 'xiaomi-mi-note-10-pro',
-                    'Xiaomi Mi TV 4S' => 'xiaomi-mi-smart-tv-4s',
-                    'Xiaomi Mi TV Stick' => 'xiaomi-mi-tv-stick',
-                    'Xiaomi Pocophone F1' => 'xiaomi-pocophone-f1',
-                    'Xiaomi Redmi 9' => 'xiaomi-redmi-9',
-                    'Xiaomi Redmi 9A' => 'xiaomi-redmi-9a',
-                    'Xiaomi Redmi AirDots' => 'xiaomi-redmi-airdots',
-                    'Xiaomi Redmi Note 4' => 'xiaomi-redmi-note-4',
-                    'Xiaomi Redmi Note 5' => 'xiaomi-redmi-note-5',
-                    'Xiaomi Redmi Note 8' => 'xiaomi-redmi-note-8',
-                    'Xiaomi Redmi Note 8 Pro' => 'xiaomi-redmi-note-8-pro',
-                    'Xiaomi Redmi Note 9' => 'xiaomi-redmi-note-9',
-                    'Xiaomi Redmi Note 9 Pro' => 'xiaomi-redmi-note-9-pro',
-                    'Xiaomi Redmi Note 9S' => 'xiaomi-redmi-note-9s',
-                    'Xiaomi Redmi Note 10' => 'xiaomi-redmi-note-10',
-                    'Xiaomi Redmi Note 10 Pro' => 'xiaomi-redmi-note-10-pro',
-                    'Xiaomi Smart Home' => 'xiaomi-smart-home',
-                    'Xiaomi Smartphones' => 'xiaomi-smartphones',
-                    'Xiaomi YouPin' => 'xiaomi-youpin',
-                    'XMG' => 'xmg',
-                    'Yamaha' => 'yamaha',
-                    'Yeelight' => 'xiaomi-yeelight',
-                    'Yoga' => 'yoga',
-                    'Yogamatten' => 'yogamatten',
-                    'Yoshi&#039;s Crafted World' => 'yoshis-crafted-world',
-                    'Zahnbürsten' => 'zahnbuersten',
-                    'Zahnpasta' => 'zahnpasta',
-                    'Zahnzusatzversicherung' => 'zahnzusatzversicherung',
-                    'Zeitschriften' => 'zeitschriften-magazine',
-                    'Zelte' => 'zelte',
-                    'Zirkel' => 'zirkel',
-                    'Zoo-Tickets' => 'zoo',
-                    'Zotac' => 'zotac',
-                    'ZTE Smartphones' => 'zte-smartphones',
-                    'ZWILLING' => 'zwilling',
-                    'ZWILLING Besteck' => 'zwilling-besteck',
-                ]
-            ],
+                'type' => 'text',
+                'exampleValue' => 'dsl',
+                'title' => 'Gruppenname in der URL: Der einzugebende Gruppenname steht nach "https://www.mydealz.de/gruppe/" und vor einem "?".
+Beispiel: Wenn die URL der Gruppe, die im Browser angezeigt wird, :
+https://www.mydealz.de/gruppe/dsl?sortBy=temp
+Dann geben Sie ein:
+dsl',
+                ],
             'order' => [
                 'name' => 'sortieren nach',
                 'type' => 'list',
@@ -2034,5 +96,7 @@ class MydealsBridge extends PepperBridgeAbstract
         'title-talk' => 'Überwachung Diskussion',
         'deal-type' => 'Angebotsart',
         'localdeal' => 'Lokales Angebot',
+        'context-hot' => '-hot',
+        'context-new' => '-new',
     ];
 }
diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index 4e9ab0b5..c64ad2fa 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -263,11 +263,40 @@ HEREDOC;
      */
     private function getTalkTitle()
     {
-        $html = getSimpleHTMLDOMCached($this->getInput('url'));
-        $title = $html->find('title', 0)->plaintext;
+        $cacheKey = $this->getInput('url') . 'TITLE';
+        $title = $this->loadCacheValue($cacheKey);
+        // The cache does not contain the title of the bridge, we must get it and save it in the cache
+        if ($title === null) {
+            $html = getSimpleHTMLDOMCached($this->getInput('url'));
+            $title = $html->find('title', 0)->plaintext;
+            // Save the value in the cache for the next 15 days
+            $this->saveCacheValue($cacheKey, $title, 86400 * 15);
+        }
         return $title;
     }
 
+    /**
+     * Get the Title from a Group if it exists
+     * @return string String of the Talk title
+     */
+    private function getGroupTitle()
+    {
+        $cacheKey = $this->getInput('group') . 'TITLE';
+        $title = $this->loadCacheValue($cacheKey);
+        // The cache does not contain the title of the bridge, we must get it and save it in the cache
+        if ($title == null) {
+            $html = getSimpleHTMLDOMCached($this->getGroupURI());
+            // Search the title in the javascript mess
+            preg_match('/threadGroupName":"([^"]*)","threadGroupUrlName":"' . $this->getInput('group') . '"/m', $html, $matches);
+            $title = $matches[1];
+            // Save the value in the cache for the next 15 days
+            $this->saveCacheValue($cacheKey, $title, 86400 * 15);
+        }
+
+        $order = $this->getKey('order');
+        return $title . ' - ' . $order;
+    }
+
     /**
      * Get the HTML Title code from an item
      * @return string String of the deal title
@@ -429,7 +458,7 @@ HEREDOC;
                 return $this->i8n('bridge-name') . ' - ' . $this->i8n('title-keyword') . ' : ' . $this->getInput('q');
                 break;
             case $this->i8n('context-group'):
-                return $this->i8n('bridge-name') . ' - ' . $this->i8n('title-group') . ' : ' . $this->getKey('group');
+                return $this->i8n('bridge-name') . ' - ' . $this->i8n('title-group') . ' : ' . $this->getGroupTitle();
                 break;
             case $this->i8n('context-talk'):
                 return $this->i8n('bridge-name') . ' - ' . $this->i8n('title-talk') . ' : ' . $this->getTalkTitle();
@@ -496,8 +525,15 @@ HEREDOC;
         $group = $this->getInput('group');
         $order = $this->getInput('order');
 
+        // This permit to keep the existing Feed to work
+        if ($order == $this->i8n('context-hot')) {
+            $sortBy = 'temp';
+        } else if ($order == $this->i8n('context-new')) {
+            $sortBy = 'new';
+        }
+
         $url = $this->i8n('bridge-uri')
-            . $this->i8n('uri-group') . $group . $order;
+            . $this->i8n('uri-group') . $group . '?sortBy=' . $sortBy;
         return $url;
     }
 

From 086ef7f8a7edba3697c976ffc8cef2fcd24578db Mon Sep 17 00:00:00 2001
From: Matt Connell <matt@connell.tech>
Date: Sat, 23 Nov 2024 18:12:36 +0000
Subject: [PATCH 529/716] feat: add WKYT bridge (#4337)

---
 bridges/WKYTNewsBridge.php | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 bridges/WKYTNewsBridge.php

diff --git a/bridges/WKYTNewsBridge.php b/bridges/WKYTNewsBridge.php
new file mode 100644
index 00000000..e3b95f00
--- /dev/null
+++ b/bridges/WKYTNewsBridge.php
@@ -0,0 +1,27 @@
+<?php
+
+class WKYTNewsBridge extends BridgeAbstract
+{
+    const NAME = 'WKYT Lexington News';
+    const URI = 'https://www.wkyt.com/news/';
+    const DESCRIPTION = 'Returns the recent articles published on WKYT News (Lexington KY)';
+    const MAINTAINER = 'mattconnell';
+
+    public function collectData()
+    {
+        $html = getSimpleHTMLDOM(self::URI);
+        $html = defaultLinkTo($html, self::URI);
+
+        $articles = $html->find('.card-body');
+
+        foreach ($articles as $article) {
+            $item = [];
+            $url = $article->find('.headline a', 0);
+            $item['uri'] = $url->href;
+            $item['title'] = trim($url->plaintext);
+            $item['author'] = $article->find('.author', 0)->plaintext;
+            $item['content'] = $article->find('.deck', 0)->plaintext;
+            $this->items[] = $item;
+        }
+    }
+}

From e3260ff529afde368eaf9503d348d29159bb0fbe Mon Sep 17 00:00:00 2001
From: Sebastian Wolf <117176763+swofl@users.noreply.github.com>
Date: Sat, 23 Nov 2024 19:19:20 +0100
Subject: [PATCH 530/716] [NordbayernBridge] fill item categories if available
 (#4338)

---
 bridges/NordbayernBridge.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/bridges/NordbayernBridge.php b/bridges/NordbayernBridge.php
index 48157921..94319e2b 100644
--- a/bridges/NordbayernBridge.php
+++ b/bridges/NordbayernBridge.php
@@ -163,6 +163,13 @@ class NordbayernBridge extends BridgeAbstract
             $item['content'] .= $this->getUseFullContent($content);
         }
 
+        $categories = $article->find('[class=themen]', 0);
+        if ($categories) {
+            $item['categories'] = [];
+            foreach ($categories->find('a') as $category) {
+                $item['categories'][] = $category->innertext;
+            }
+        }
 
         $article->clear();
         return $item;

From 628b30208ab8d268ab2fbaae2de7f19443baac27 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 23 Nov 2024 22:28:50 +0100
Subject: [PATCH 531/716] fix: dont aquire exclusive locks (#4340)

Due to bugs in logging/error-handling there sometimes are deadlocks
---
 caches/FileCache.php | 2 +-
 lib/logger.php       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/caches/FileCache.php b/caches/FileCache.php
index dfd295e8..ff939bea 100644
--- a/caches/FileCache.php
+++ b/caches/FileCache.php
@@ -53,7 +53,7 @@ class FileCache implements CacheInterface
             'value'         => $value,
         ];
         $cacheFile = $this->createCacheFile($key);
-        $bytes = file_put_contents($cacheFile, serialize($item), LOCK_EX);
+        $bytes = file_put_contents($cacheFile, serialize($item));
         // todo: Consider tightening the permissions of the created file. It usually allow others to read, depending on umask
         if ($bytes === false) {
             // Consider just logging the error here
diff --git a/lib/logger.php b/lib/logger.php
index 74a0e713..9e5f6ce9 100644
--- a/lib/logger.php
+++ b/lib/logger.php
@@ -136,7 +136,7 @@ final class StreamHandler
             $record['message'],
             $context
         );
-        $bytes = file_put_contents($this->stream, $text, FILE_APPEND | LOCK_EX);
+        $bytes = file_put_contents($this->stream, $text, FILE_APPEND);
     }
 }
 

From 83bc3fd7620c161996f06480dbec7197ae2d95e6 Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Sun, 24 Nov 2024 03:57:28 +0100
Subject: [PATCH 532/716] [DRKBlutspendeBridge] add new bridge (#4324)

* [DRKBlutspendeBridge] add new bridge

* [DRKBlutspendeBridge] move explode_lines into DRKBlutspendeBridge class
---
 bridges/DRKBlutspendeBridge.php | 107 ++++++++++++++++++++++++++++++++
 1 file changed, 107 insertions(+)
 create mode 100644 bridges/DRKBlutspendeBridge.php

diff --git a/bridges/DRKBlutspendeBridge.php b/bridges/DRKBlutspendeBridge.php
new file mode 100644
index 00000000..15075898
--- /dev/null
+++ b/bridges/DRKBlutspendeBridge.php
@@ -0,0 +1,107 @@
+<?php
+
+class DRKBlutspendeBridge extends FeedExpander
+{
+    const MAINTAINER = 'User123698745';
+    const NAME = 'DRK-Blutspende';
+    const BASE_URI = 'https://www.drk-blutspende.de';
+    const URI = self::BASE_URI;
+    const CACHE_TIMEOUT = 60 * 60 * 1; // 1 hour
+    const DESCRIPTION = 'German Red Cross (Deutsches Rotes Kreuz) blood donation service feed with more details';
+    const CONTEXT_APPOINTMENTS = 'Termine';
+    const PARAMETERS = [
+        self::CONTEXT_APPOINTMENTS => [
+            'term' => [
+                'name' => 'PLZ / Ort',
+                'required' => true,
+                'exampleValue' => '12555',
+            ],
+            'radius' => [
+                'name' => 'Umkreis in km',
+                'type' => 'number',
+                'exampleValue' => 10,
+            ],
+            'limit_days' => [
+                'name' => 'Limit von Tagen',
+                'title' => 'Nur Termine innerhalb der nächsten x Tagen',
+                'type' => 'number',
+                'exampleValue' => 28,
+            ],
+            'limit_items' => [
+                'name' => 'Limit von Terminen',
+                'title' => 'Nicht mehr als x Termine',
+                'type' => 'number',
+                'required' => true,
+                'defaultValue' => 20,
+            ]
+        ]
+    ];
+
+    public function collectData()
+    {
+        $limitItems = intval($this->getInput('limit_items'));
+        $this->collectExpandableDatas(self::buildAppointmentsURI(), $limitItems);
+    }
+
+    protected function parseItem(array $item)
+    {
+        $html = getSimpleHTMLDOM($item['uri']);
+
+        $detailsElement = $html->find('.details', 0);
+
+        $dateElement = $detailsElement->find('.datum', 0);
+        $dateLines = self::explodeLines($dateElement->plaintext);
+
+        $addressElement = $detailsElement->find('.adresse', 0);
+        $addressLines = self::explodeLines($addressElement->plaintext);
+
+        $infoElement = $detailsElement->find('.angebote > h4 + p', 0);
+        $info = $infoElement ? $infoElement->innertext : '';
+
+        $imageElements = $detailsElement->find('.fotos img');
+
+        $item['title'] = $dateLines[0] . ' ' . $dateLines[1] . ' ' . $addressLines[0] . ' - ' . $addressLines[1];
+
+        $item['content'] = <<<HTML
+        <p><b>{$dateLines[0]} {$dateLines[1]}</b></p>
+        <p>{$addressElement->innertext}</p>
+        <p>{$info}</p>
+        HTML;
+
+        foreach ($imageElements as $imageElement) {
+            $src = $imageElement->getAttribute('src');
+            $item['content'] .= <<<HTML
+            <p><img src="{$src}"></p>
+            HTML;
+        }
+
+        $item['description'] = null;
+
+        return $item;
+    }
+
+    public function getURI()
+    {
+        if ($this->queriedContext === self::CONTEXT_APPOINTMENTS) {
+            return str_replace('.rss?', '?', self::buildAppointmentsURI());
+        }
+        return parent::getURI();
+    }
+
+    private function buildAppointmentsURI()
+    {
+        $term = $this->getInput('term') ?? '';
+        $radius = $this->getInput('radius') ?? '';
+        $limitDays = intval($this->getInput('limit_days'));
+        $dateTo = $limitDays > 0 ? date('Y-m-d', time() + (60 * 60 * 24 * $limitDays)) : '';
+        return self::BASE_URI . '/blutspendetermine/termine.rss?date_to=' . $dateTo . '&radius=' . $radius . '&term=' . $term;
+    }
+
+    /**
+     * Returns an array of strings, each of which is a substring of string formed by splitting it on boundaries formed by line breaks.
+     */
+    private function explodeLines(string $text): array
+    {
+        return array_map('trim', preg_split('/(\s*(\r\n|\n|\r)\s*)+/', $text));
+    }
+}

From 74496e23aaa9101ac718a3b12dafa4206921932c Mon Sep 17 00:00:00 2001
From: Sebastian Wolf <117176763+swofl@users.noreply.github.com>
Date: Sun, 24 Nov 2024 18:09:59 +0100
Subject: [PATCH 533/716] [MixologyBridge] add new bridge (#4331)

* [MixologyBridge] add new bridge

* [MixologyBridge] change invalid item property tags to categories

* [MixologyBridge] rewrite into FeedExpander

* [MixologyBridge] fix code formatting
---
 bridges/MixologyBridge.php | 49 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 bridges/MixologyBridge.php

diff --git a/bridges/MixologyBridge.php b/bridges/MixologyBridge.php
new file mode 100644
index 00000000..1246b4db
--- /dev/null
+++ b/bridges/MixologyBridge.php
@@ -0,0 +1,49 @@
+<?php
+
+class MixologyBridge extends FeedExpander
+{
+    const MAINTAINER = 'swofl';
+    const NAME = 'Mixology';
+    const URI = 'https://mixology.eu';
+    const CACHE_TIMEOUT = 6 * 60 * 60; // 6h
+    const DESCRIPTION = 'Get latest blog posts from Mixology';
+    const PARAMETERS = [ [
+        'limit' => self::LIMIT,
+    ] ];
+
+    public function collectData()
+    {
+        $feed_url = self::URI . '/feed';
+        $limit = $this->getInput('limit') ?? 10;
+        $this->collectExpandableDatas($feed_url, $limit);
+    }
+
+    protected function parseItem(array $item)
+    {
+        $article = getSimpleHTMLDOMCached($item['uri']);
+
+        $content = '';
+
+        $headerImage = $article->find('div.edgtf-full-width img.wp-post-image', 0);
+
+        if (is_object($headerImage)) {
+            $item['enclosures'] = [];
+            $item['enclosures'][] = $headerImage->src;
+            $content .= '<img src="' . $headerImage->src . '"/>';
+        }
+
+        foreach ($article->find('article .wpb_content_element > .wpb_wrapper') as $element) {
+            $content .= $element->innertext;
+        }
+
+        $item['content'] = $content;
+
+        $item['categories'] = [];
+
+        foreach ($article->find('.edgtf-tags > a') as $tag) {
+            $item['categories'][] = $tag->plaintext;
+        }
+
+        return $item;
+    }
+}

From ec6f98e3c272cd06ae59fafadaaaca77904a522b Mon Sep 17 00:00:00 2001
From: SebLaus <97241865+SebLaus@users.noreply.github.com>
Date: Sun, 24 Nov 2024 18:11:57 +0100
Subject: [PATCH 534/716] Added Alternate way to get Price if no buttons
 available (#4342)

---
 bridges/IdealoBridge.php | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/bridges/IdealoBridge.php b/bridges/IdealoBridge.php
index 92bb30d0..55cee467 100644
--- a/bridges/IdealoBridge.php
+++ b/bridges/IdealoBridge.php
@@ -150,29 +150,34 @@ class IdealoBridge extends BridgeAbstract
         $ActualNewPrice = $html->find('div[id=oopStage-conditionButton-new]', 0);
         // Second Button contains the used product price
         $ActualUsedPrice = $html->find('div[id=oopStage-conditionButton-used]', 0);
+        // Get the first item of the offers list to have an option if there is no New/Used Button available
+        $altPrice = $html->find('.productOffers-listItemOfferPrice', 0);
 
         if ($ActualNewPrice) {
             $PriceNew = $ActualNewPrice->find('strong', 0)->plaintext;
             // Save current price
             $this->saveCacheValue($KeyNEW, $PriceNew);
-        } else if ($ActualNewPrice === null && $ActualUsedPrice !== null) {
-            // In case there is no actual New Price and a Ured Price exists, then delete the previous value in the cache
-             $this->cache->delete($this->getShortName() . '_' . $KeyNEW);
+        } else if ($altPrice) {
+            // Get price from first List item if no New/used Buttons available
+            $PriceNew = trim($altPrice->plaintext);
+            $this->saveCacheValue($KeyNEW, $PriceNew);
+        } else if (($ActualNewPrice === null || $altPrice === null) && $ActualUsedPrice !== null) {
+            // In case there is no actual New Price and a Used Price exists, then delete the previous value in the cache
+            $this->cache->delete($this->getShortName() . '_' . $KeyNEW);
         }
 
-
         // Second Button contains the used product price
         if ($ActualUsedPrice) {
             $PriceUsed = $ActualUsedPrice->find('strong', 0)->plaintext;
             // Save current price
             $this->saveCacheValue($KeyUSED, $PriceUsed);
-        } else if ($ActualUsedPrice === null && $ActualNewPrice !== null) {
+        } else if ($ActualUsedPrice === null && ($ActualNewPrice !== null || $altPrice !== null)) {
             // In case there is no actual Used Price and a New Price exists, then delete the previous value in the cache
-             $this->cache->delete($this->getShortName() . '_' . $KeyUSED);
+            $this->cache->delete($this->getShortName() . '_' . $KeyUSED);
         }
 
-        // Only continue if a price has changed and there exists a New or Used price (sometimes no new Price _and_ Used Price are shown)
-        if (!($ActualNewPrice === null && $ActualUsedPrice === null ) && ($PriceNew != $OldPriceNew || $PriceUsed != $OldPriceUsed)) {
+        // Only continue if a price has changed and there exists a New, Used or Alternative price (sometimes no new Price _and_ Used Price are shown)
+        if (!($ActualNewPrice === null && $ActualUsedPrice === null && $altPrice === null) && ($PriceNew != $OldPriceNew || $PriceUsed != $OldPriceUsed)) {
             // Get Product Image
             $image = $html->find('.datasheet-cover-image', 0)->src;
 

From b42a993176bc1e291f52b4de4ce3397fa307e84b Mon Sep 17 00:00:00 2001
From: thomas-333 <144368654+thomas-333@users.noreply.github.com>
Date: Mon, 25 Nov 2024 18:01:37 +0000
Subject: [PATCH 535/716] [Bluesky] New bridge (#4341)

* Create BlueskyProfileBridge.php

Bridge for Bluesky

* Update BlueskyProfileBridge.php

Attempt to fix test error

* Rename BlueskyProfileBridge.php to BlueskyBridge.php and add list of select data source

* Update BlueskyBridge.php to pass lint checks
---
 bridges/BlueskyBridge.php | 230 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 230 insertions(+)
 create mode 100644 bridges/BlueskyBridge.php

diff --git a/bridges/BlueskyBridge.php b/bridges/BlueskyBridge.php
new file mode 100644
index 00000000..8dab82f4
--- /dev/null
+++ b/bridges/BlueskyBridge.php
@@ -0,0 +1,230 @@
+<?php
+
+class BlueskyBridge extends BridgeAbstract
+{
+    const NAME = 'Bluesky';
+    const URI = 'https://bsky.app';
+    const DESCRIPTION = 'Fetches posts from Bluesky';
+    const MAINTAINER = 'Code modified from rsshub (TonyRL https://github.com/TonyRL) and expanded';
+    const PARAMETERS = [
+        [
+            'data_source' => [
+                'name' => 'Bluesky Data Source',
+                'type' => 'list',
+                'defaultValue' => 'Profile',
+                'values' => [
+                    'Profile' => 'getAuthorFeed',
+                ],
+                'title' => 'Select the type of data source to fetch from Bluesky.'
+            ],
+            'handle' => [
+                'name' => 'User Handle',
+                'type' => 'text',
+                'required' => true,
+                'exampleValue' => 'jackdodo.bsky.social',
+                'title' => 'Handle found in URL'
+            ],
+            'filter' => [
+                'name' => 'Filter',
+                'type' => 'list',
+                'defaultValue' => 'posts_and_author_threads',
+                'values' => [
+                    'posts_and_author_threads' => 'posts_and_author_threads',
+                    'posts_with_replies' => 'posts_with_replies',
+                    'posts_no_replies' => 'posts_no_replies',
+                    'posts_with_media' => 'posts_with_media',
+                ],
+                'title' => 'Combinations of post/repost types to include in response.'
+            ]
+        ]
+    ];
+
+    private $profile;
+
+    public function getName()
+    {
+        if (isset($this->profile)) {
+            return sprintf('%s (@%s) - Bluesky', $this->profile['displayName'], $this->profile['handle']);
+        }
+        return parent::getName();
+    }
+
+    public function getURI()
+    {
+        if (isset($this->profile)) {
+            return self::URI . '/profile/' . $this->profile['handle'];
+        }
+        return parent::getURI();
+    }
+
+    public function getIcon()
+    {
+        if (isset($this->profile)) {
+            return $this->profile['avatar'];
+        }
+        return parent::getIcon();
+    }
+
+    public function getDescription()
+    {
+        if (isset($this->profile)) {
+            return $this->profile['description'];
+        }
+        return parent::getDescription();
+    }
+
+    private function parseExternal($external, $did)
+    {
+        $description = '';
+        $externalUri = $external['uri'];
+        $externalTitle = htmlspecialchars($external['title'], ENT_QUOTES, 'UTF-8');
+        $externalDescription = htmlspecialchars($external['description'], ENT_QUOTES, 'UTF-8');
+        $thumb = $external['thumb'] ?? null;
+
+        if (preg_match('/youtube\.com\/watch\?v=([^\&\?\/]+)/', $externalUri, $id) || preg_match('/youtu\.be\/([^\&\?\/]+)/', $externalUri, $id)) {
+            $videoId = $id[1];
+            $description .= "<p>External Link: <a href=\"$externalUri\">$externalTitle</a></p>";
+            $description .= "<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/$videoId\" frameborder=\"0\" allowfullscreen></iframe>";
+        } else {
+            $description .= "<p>External Link: <a href=\"$externalUri\">$externalTitle</a></p>";
+            $description .= "<p>$externalDescription</p>";
+
+            if ($thumb) {
+                $thumbUrl = 'https://cdn.bsky.app/img/feed_thumbnail/plain/' . $did . '/' . $thumb['ref']['$link'] . '@jpeg';
+                $description .= "<p><a href=\"$externalUri\"><img src=\"$thumbUrl\" alt=\"External Thumbnail\" /></a></p>";
+            }
+        }
+        return $description;
+    }
+
+    private function textToDescription($text)
+    {
+        $text = nl2br(htmlspecialchars($text, ENT_QUOTES, 'UTF-8'));
+        $text = preg_replace('/(https?:\/\/[^\s]+)/i', '<a href="$1">$1</a>', $text);
+
+        return $text;
+    }
+
+    public function collectData()
+    {
+        $handle = $this->getInput('handle');
+        $filter = $this->getInput('filter') ?: 'posts_and_author_threads';
+
+        $did = $this->resolveHandle($handle);
+        $this->profile = $this->getProfile($did);
+        $authorFeed = $this->getAuthorFeed($did, $filter);
+
+        foreach ($authorFeed['feed'] as $post) {
+            $item = [];
+            $item['uri'] = self::URI . '/profile/' . $post['post']['author']['handle'] . '/post/' . explode('app.bsky.feed.post/', $post['post']['uri'])[1];
+            $item['title'] = strtok($post['post']['record']['text'], "\n");
+            $item['timestamp'] = strtotime($post['post']['record']['createdAt']);
+            $item['author'] = $this->profile['displayName'];
+
+            $description = $this->textToDescription($post['post']['record']['text']);
+
+            // Retrieve DID for constructing image URLs
+            $authorDid = $post['post']['author']['did'];
+
+            if (isset($post['post']['record']['embed']['$type']) && $post['post']['record']['embed']['$type'] === 'app.bsky.embed.external') {
+                $description .= $this->parseExternal($post['post']['record']['embed']['external'], $authorDid);
+            }
+
+            if (isset($post['post']['record']['embed']['$type']) && $post['post']['record']['embed']['$type'] === 'app.bsky.embed.video') {
+                $thumbnail = $post['post']['embed']['thumbnail'] ?? null;
+                if ($thumbnail) {
+                                    $itemUri = self::URI . '/profile/' . $post['post']['author']['handle'] . '/post/' . explode('app.bsky.feed.post/', $post['post']['uri'])[1];
+                    $description .= "<p><a href=\"$itemUri\"><img src=\"$thumbnail\" alt=\"Video Thumbnail\" /></a></p>";
+                }
+            }
+
+            if (isset($post['post']['record']['embed']['$type']) && $post['post']['record']['embed']['$type'] === 'app.bsky.embed.recordWithMedia#view') {
+                $thumbnail = $post['post']['embed']['media']['thumbnail'] ?? null;
+                $playlist = $post['post']['embed']['media']['playlist'] ?? null;
+                if ($thumbnail) {
+                    $description .= "<p><video controls poster=\"$thumbnail\">";
+                    $description .= "<source src=\"$playlist\" type=\"application/x-mpegURL\">";
+                    $description .= 'Video source not supported</video></p>';
+                }
+            }
+
+            if (!empty($post['post']['record']['embed']['images'])) {
+                foreach ($post['post']['record']['embed']['images'] as $image) {
+                    $linkRef = $image['image']['ref']['$link'];
+                    $thumbnailUrl = $this->resolveThumbnailUrl($authorDid, $linkRef);
+                    $fullsizeUrl = $this->resolveFullsizeUrl($authorDid, $linkRef);
+                    $description .= "<br /><br /><a href=\"$fullsizeUrl\"><img src=\"$thumbnailUrl\" alt=\"Image\"></a>";
+                }
+            }
+
+            // Enhanced handling for quote posts with images
+            if (isset($post['post']['record']['embed']) && $post['post']['record']['embed']['$type'] === 'app.bsky.embed.record') {
+                $quotedRecord = $post['post']['record']['embed']['record'];
+                $quotedAuthor = $post['post']['embed']['record']['author']['handle'] ?? null;
+                $quotedDisplayName = $post['post']['embed']['record']['author']['displayName'] ?? null;
+                $quotedText = $post['post']['embed']['record']['value']['text'] ?? null;
+
+                if ($quotedAuthor && isset($quotedRecord['uri'])) {
+                    $parts = explode('/', $quotedRecord['uri']);
+                    $quotedPostId = end($parts);
+                    $quotedPostUri = self::URI . '/profile/' . $quotedAuthor . '/post/' . $quotedPostId;
+                }
+
+                if ($quotedText) {
+                    $description .= '<hr /><strong>Quote from ' . htmlspecialchars($quotedDisplayName) . ' (@ ' . htmlspecialchars($quotedAuthor) . '):</strong><br />';
+                    $description .= $this->textToDescription($quotedText);
+                    if (isset($quotedPostUri)) {
+                        $description .= "<p><a href=\"$quotedPostUri\">View original quote post</a></p>";
+                    }
+                }
+            }
+
+            if (isset($post['post']['embed']['record']['value']['embed']['images'])) {
+                $quotedImages = $post['post']['embed']['record']['value']['embed']['images'];
+                foreach ($quotedImages as $image) {
+                    $linkRef = $image['image']['ref']['$link'] ?? null;
+                    if ($linkRef) {
+                        $quotedAuthorDid = $post['post']['embed']['record']['author']['did'] ?? null;
+                        $thumbnailUrl = $this->resolveThumbnailUrl($quotedAuthorDid, $linkRef);
+                        $fullsizeUrl = $this->resolveFullsizeUrl($quotedAuthorDid, $linkRef);
+                        $description .= "<br /><br /><a href=\"$fullsizeUrl\"><img src=\"$thumbnailUrl\" alt=\"Quoted Image\"></a>";
+                    }
+                }
+            }
+
+            $item['content'] = $description;
+            $this->items[] = $item;
+        }
+    }
+
+    private function resolveHandle($handle)
+    {
+        $uri = 'https://public.api.bsky.app/xrpc/com.atproto.identity.resolveHandle?handle=' . urlencode($handle);
+        $response = json_decode(getContents($uri), true);
+        return $response['did'];
+    }
+
+    private function getProfile($did)
+    {
+        $uri = 'https://public.api.bsky.app/xrpc/app.bsky.actor.getProfile?actor=' . urlencode($did);
+        $response = json_decode(getContents($uri), true);
+        return $response;
+    }
+
+    private function getAuthorFeed($did, $filter)
+    {
+        $uri = 'https://public.api.bsky.app/xrpc/app.bsky.feed.getAuthorFeed?actor=' . urlencode($did) . '&filter=' . urlencode($filter) . '&limit=30';
+        $response = json_decode(getContents($uri), true);
+        return $response;
+    }
+
+    private function resolveThumbnailUrl($authorDid, $linkRef)
+    {
+        return 'https://cdn.bsky.app/img/feed_thumbnail/plain/' . $authorDid . '/' . $linkRef . '@jpeg';
+    }
+
+    private function resolveFullsizeUrl($authorDid, $linkRef)
+    {
+        return 'https://cdn.bsky.app/img/feed_fullsize/plain/' . $authorDid . '/' . $linkRef . '@jpeg';
+    }
+}

From c651e11b0ff3a6ea0b9ff10a6669553b912db434 Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Mon, 25 Nov 2024 23:33:35 +0530
Subject: [PATCH 536/716] [MaalaimalarBridge] fix new url (#4344)

---
 bridges/MaalaimalarBridge.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/bridges/MaalaimalarBridge.php b/bridges/MaalaimalarBridge.php
index e83eafe2..fcdbda48 100644
--- a/bridges/MaalaimalarBridge.php
+++ b/bridges/MaalaimalarBridge.php
@@ -5,6 +5,7 @@ class MaalaimalarBridge extends BridgeAbstract
     const NAME = 'Maalaimalar';
     const URI = 'https://www.maalaimalar.com';
     const DESCRIPTION = 'Retrieve news from maalaimalar.com';
+    const CACHE_TIMEOUT = 60 * 5; // 5 minutes
     const MAINTAINER = 'tillcash';
     const PARAMETERS = [
         [
@@ -13,7 +14,7 @@ class MaalaimalarBridge extends BridgeAbstract
                 'type' => 'list',
                 'values' => [
                     'news' => [
-                        'tamilnadu' => '/news/state',
+                        'tamilnadu' => '/news/tamilnadu',
                         'puducherry' => '/news/puducherry',
                         'india' => '/news/national',
                         'world' => '/news/world',

From c7f9870ba747abb9f92800e615fbe8ff517b8a5f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Dawid=20Wr=C3=B3bel?= <me@dawidwrobel.com>
Date: Tue, 26 Nov 2024 03:04:02 +0100
Subject: [PATCH 537/716] [OLXBridge] fix title and shiping info retrieval
 (#4346)

---
 bridges/OLXBridge.php | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/bridges/OLXBridge.php b/bridges/OLXBridge.php
index 1a8be901..31f05eaa 100644
--- a/bridges/OLXBridge.php
+++ b/bridges/OLXBridge.php
@@ -103,20 +103,15 @@ EOF;
                 continue;
             }
 
-            $shippingOffered = $post->find('.css-1c0ed4l svg', 0)->outertext ?? false;
-            if ($this->getInput('shippingOfferedOnly') && !$shippingOffered) {
-                continue;
-            }
-
             $negotiable = $post->find('p[data-testid="ad-price"] span.css-e2218f', 0)->plaintext ?? false;
             if ($negotiable) {
                 $price = trim(str_replace($negotiable, '', $price));
                 $negotiable = '(' . $negotiable . ')';
             }
 
-            if ($post->find('h6', 0)->plaintext != '') {
+            if ($post->find('h4', 0)->plaintext != '') {
                 $item['uri'] = $post->find('a', 0)->href;
-                $item['title'] = $post->find('h6', 0)->plaintext;
+                $item['title'] = $post->find('h4', 0)->plaintext;
             }
 
             # ignore the date component, as it is too convoluted — use the deep-crawled one; see below
@@ -128,6 +123,12 @@ EOF;
             # Given that, do deep-crawl *all* the results, which allows to aso obtain the ID, the simplified location
             # and date strings, as well as the detailed description.
             $articleHTMLContent = getSimpleHTMLDOMCached($item['uri']);
+            $articleHTMLContent = defaultLinkTo($articleHTMLContent, $this->getHostname());
+
+            $shippingOffered = $articleHTMLContent->find('img[alt="Safety Badge"]', 0)->src ?? false;
+            if ($this->getInput('shippingOfferedOnly') && !$shippingOffered) {
+                continue;
+            }
 
             # Extract a clean ID without resorting to the convoluted CSS class or sibling selectors. Should be always present.
             $refreshLink = $articleHTMLContent->find('a[data-testid=refresh-link]', 0)->href ?? false;
@@ -195,7 +196,7 @@ EOF;
       <tr>
         <td>
           <p>$location</p>
-          <p><span style="font-weight:bold">$price</span> $negotiable <span>$shippingOffered</span></p>
+          <p><span style="font-weight:bold">$price</span> $negotiable <span><img src="$shippingOffered"</img></span></p>
         </td>
       </tr>
       <tr>

From 88ccc6067cc9b8319a6eca85de4f5684c2c62a5a Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Tue, 26 Nov 2024 09:54:30 -0500
Subject: [PATCH 538/716] [CubariProxyBridge] Fix favicon (#4347)

---
 bridges/CubariProxyBridge.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/bridges/CubariProxyBridge.php b/bridges/CubariProxyBridge.php
index 492d5fbb..aab7c09b 100644
--- a/bridges/CubariProxyBridge.php
+++ b/bridges/CubariProxyBridge.php
@@ -121,4 +121,9 @@ class CubariProxyBridge extends BridgeAbstract
         }
         return $uri;
     }
+
+    public function getFavicon()
+    {
+        return parent::getURI() . '/static/favicon.ico';
+    }
 }

From 6a81fc0f519bbf10070b5ae9bffd1adf84f858a6 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 28 Nov 2024 03:50:56 +0100
Subject: [PATCH 539/716] fix(file_cache): if write failure, produce log record
 instead of exception (#4352)

---
 caches/FileCache.php | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/caches/FileCache.php b/caches/FileCache.php
index ff939bea..24a9872f 100644
--- a/caches/FileCache.php
+++ b/caches/FileCache.php
@@ -54,10 +54,13 @@ class FileCache implements CacheInterface
         ];
         $cacheFile = $this->createCacheFile($key);
         $bytes = file_put_contents($cacheFile, serialize($item));
-        // todo: Consider tightening the permissions of the created file. It usually allow others to read, depending on umask
+
+        // TODO: Consider tightening the permissions of the created file.
+        // It usually allow others to read, depending on umask
+
         if ($bytes === false) {
-            // Consider just logging the error here
-            throw new \Exception(sprintf('Failed to write to: %s', $cacheFile));
+            // Typically means no disk space remaining
+            $this->logger->warning(sprintf('Failed to write to: %s', $cacheFile));
         }
     }
 

From d956471d42174a656dc2f4817ede056ee9ea77c3 Mon Sep 17 00:00:00 2001
From: Pavel Korytov <thexcloud@gmail.com>
Date: Mon, 2 Dec 2024 18:46:13 +0300
Subject: [PATCH 540/716] [QwenBlogBridge] Add bridge (#4353)

---
 bridges/QwenBlogBridge.php | 49 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 bridges/QwenBlogBridge.php

diff --git a/bridges/QwenBlogBridge.php b/bridges/QwenBlogBridge.php
new file mode 100644
index 00000000..2af3f401
--- /dev/null
+++ b/bridges/QwenBlogBridge.php
@@ -0,0 +1,49 @@
+<?php
+
+class QwenBlogBridge extends FeedExpander
+{
+    const NAME = 'Qwen Blog';
+    const URI = 'https://qwenlm.github.io/blog/';
+    const DESCRIPTION = 'Fetch the latest items from Qwen';
+    const MAINTAINER = 'sqrtminusone';
+    const CACHE_TIMEOUT = 3600;
+
+    const PARAMETERS = [
+        '' => [
+            'limit' => [
+                'name' => 'Limit',
+                'type' => 'number',
+                'required' => true,
+                'defaultValue' => 10
+            ],
+        ]
+    ];
+
+    public function collectData()
+    {
+        $this->collectExpandableDatas(self::URI . 'index.xml', $this->getInput('limit'));
+    }
+
+    protected function parseItem(array $item)
+    {
+        $dom = getSimpleHTMLDOM($item['uri']);
+        $content = $dom->find('div.post-content', 0);
+        if ($content == null) {
+            return $item;
+        }
+
+        // Fix code blocks
+        foreach ($dom->find('pre.chroma') as $code_block) {
+            // Somehow there are tags in <pre>??
+            $code_block_html = str_get_html($code_block->plaintext);
+            $code = '';
+            foreach ($code_block_html->find('span.line') as $line) {
+                $code .= $line->plaintext . "\n";
+            }
+            $code_block->outertext = '<pre>' . $code . '</pre>';
+        }
+
+        $item['content'] = $content;
+        return $item;
+    }
+}

From 59d77d4576b0db4d09e85cb40de60d62749be554 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pred=C3=A4?= <46051820+PredaaA@users.noreply.github.com>
Date: Wed, 4 Dec 2024 17:34:35 +0100
Subject: [PATCH 541/716] [TikTokBridge] Include author profile picture (#4354)

---
 bridges/TikTokBridge.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/bridges/TikTokBridge.php b/bridges/TikTokBridge.php
index 22fdfcef..43a9cb31 100644
--- a/bridges/TikTokBridge.php
+++ b/bridges/TikTokBridge.php
@@ -29,6 +29,7 @@ class TikTokBridge extends BridgeAbstract
         $html = getSimpleHTMLDOMCached('https://www.tiktok.com/embed/' . $this->processUsername());
 
         $author = $html->find('span[data-e2e=creator-profile-userInfo-TUXText]', 0)->plaintext ?? self::NAME;
+        $authorProfilePicture = $html->find('img[data-e2e=creator-profile-userInfo-Avatar]', 0)->src ?? '';
 
         $videos = $html->find('div[data-e2e=common-videoList-VideoContainer]');
 
@@ -44,7 +45,7 @@ class TikTokBridge extends BridgeAbstract
             $image = $video->find('video', 0)->poster;
             $views = $video->find('div[data-e2e=common-Video-Count]', 0)->plaintext;
 
-            $enclosures = [$image];
+            $enclosures = [$image, $authorProfilePicture];
 
             $item['uri'] = $url;
             $item['title'] = 'Video';

From 17d142c038e6c6ab02aa8c86532aa30e8d779f42 Mon Sep 17 00:00:00 2001
From: okbaydere <okbaydere@gmail.com>
Date: Wed, 4 Dec 2024 20:54:24 +0300
Subject: [PATCH 542/716] Add StorytelBridge for Storytel list fetching (#4355)

* Add StorytelBridge for fetching Storytel lists

* Updated StorytelBridge to include URL validation and cleaned up code
---
 bridges/StorytelBridge.php | 58 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 bridges/StorytelBridge.php

diff --git a/bridges/StorytelBridge.php b/bridges/StorytelBridge.php
new file mode 100644
index 00000000..2316aacd
--- /dev/null
+++ b/bridges/StorytelBridge.php
@@ -0,0 +1,58 @@
+<?php
+
+class StorytelBridge extends BridgeAbstract
+{
+    const NAME = 'Storytel List Bridge';
+    const URI = 'https://www.storytel.com/tr';
+    const DESCRIPTION = 'Fetches books from a Storytel list, including title, author, and cover image.';
+    const MAINTAINER = 'Okbaydere';
+    const PARAMETERS = [
+        'List' => [
+            'url' => [
+                'name' => 'Storytel List URL',
+                'required' => true,
+                'exampleValue' => 'https://www.storytel.com/tr/lists/23d09e0bd8fe4d998d1832ddbfa18166',
+            ],
+        ],
+    ];
+
+    public function collectData()
+    {
+        $url = $this->getInput('url');
+
+        if (!preg_match('/^https:\/\/www\.storytel\.com/', $url)) {
+            returnServerError('Invalid URL: Only Storytel URLs are allowed.');
+        }
+
+        $html = getSimpleHTMLDOM($url);
+        if (!$html) {
+            returnServerError('Unable to fetch Storytel list');
+        }
+
+        foreach ($html->find('li.sc-4615116a-1') as $element) {
+            $item = [];
+
+            $titleElement = $element->find('span.sc-b1963858-0.hoTsmF', 0);
+            $item['title'] = $titleElement ? $titleElement->plaintext : 'No title';
+
+            $authorElement = $element->find('span.sc-b1963858-0.ghYMwH', 0);
+            $item['author'] = $authorElement ? $authorElement->plaintext : 'Unknown author';
+
+            $imgElement = $element->find('img.sc-da400893-5', 0);
+            $coverUrl = $imgElement ? $imgElement->getAttribute('srcset') : '';
+            if ($coverUrl) {
+                $coverUrls = explode(', ', $coverUrl);
+                $bestCoverUrl = trim(end($coverUrls));
+                $item['content'] = '<img src="' . preg_replace('/\?.*/', '', $bestCoverUrl) . '"/>';
+            }
+
+            $linkElement = $element->find('a', 0);
+            $item['uri'] = $linkElement ? 'https://www.storytel.com' . $linkElement->getAttribute('href') : $url;
+
+            $item['content'] .= '<p>Author: ' . $item['author'] . '</p>';
+            $item['content'] .= '<p><a href="' . $item['uri'] . '">More details</a></p>';
+
+            $this->items[] = $item;
+        }
+    }
+}

From bf4a918e604f6c7a60aaae7c6ad25fee568a1bdb Mon Sep 17 00:00:00 2001
From: Pavel Korytov <thexcloud@gmail.com>
Date: Thu, 5 Dec 2024 19:30:21 +0300
Subject: [PATCH 543/716] [MistralAIBridge] Add Mistral (#4356)

---
 bridges/MistralAIBridge.php | 70 +++++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 bridges/MistralAIBridge.php

diff --git a/bridges/MistralAIBridge.php b/bridges/MistralAIBridge.php
new file mode 100644
index 00000000..b1c357fe
--- /dev/null
+++ b/bridges/MistralAIBridge.php
@@ -0,0 +1,70 @@
+<?php
+
+class MistralAIBridge extends BridgeAbstract
+{
+    const MAINTAINER = 'sqrtminusone';
+    const NAME = 'Mistral AI Bridge';
+    const URI = 'https://mistral.ai/';
+
+    const CACHE_TIMEOUT = 3600; // 1 hour
+    const DESCRIPTION = 'Returns blog posts from Mistral AI';
+
+    const PARAMETERS = [
+        '' => [
+            'limit' => [
+                'name' => 'Limit',
+                'type' => 'number',
+                'required' => true,
+                'defaultValue' => 10
+            ],
+        ]
+    ];
+
+    public function collectData()
+    {
+        $html = getSimpleHTMLDOM(self::URI . 'news/');
+        $limit = $this->getInput('limit');
+
+        $posts = $html->find('article.news-card');
+        for ($i = 0; $i < min($limit, count($posts)); $i++) {
+            $post = $posts[$i];
+            $url = self::URI . $post->find('a', 0)->href;
+            $this->parsePage($url);
+        }
+    }
+
+    private function parsePage($url)
+    {
+        $html = getSimpleHTMLDOMCached($url, 7 * 24 * 60 * 60);
+        $title = $html->find('h1.hero-title', 0)->plaintext;
+        $timestamp_tag = $html->find('i.ti-calendar', 0)->parent;
+        $timestamp = DateTime::createFromFormat('F j, Y', $timestamp_tag->plaintext)->format('U');
+
+        $content = '';
+
+        // Subheader
+        $header = $html->find('p.hero-description', 0);
+        if ($header != null) {
+            $content .= $header->outertext;
+        }
+
+        // Main content
+        $main = $html->find('$article > div.content', 0);
+
+        // Mostly YouTube videos
+        $iframes = $main->find('iframe');
+        foreach ($iframes as $iframe) {
+            $iframe->parent->removeAttribute('style');
+            $iframe->outertext = '<a href="' . $iframe->src . '">' . $iframe->src . '</a>';
+        }
+
+        $main = defaultLinkTo($main, self::URI);
+        $content .= $main;
+        $this->items[] = [
+            'title' => $title,
+            'timestamp' => $timestamp,
+            'content' => $content,
+            'uri' => $url,
+        ];
+    }
+}

From 4685bbdffdb46d56716b20b98b194eaba2682e64 Mon Sep 17 00:00:00 2001
From: "Florent V." <floviolleau@users.noreply.github.com>
Date: Sun, 8 Dec 2024 19:48:44 +0100
Subject: [PATCH 544/716] [EdfPricesBridge] fixing bridge (#4360)

* [EdfPricesBridge] add new brige

* [EdfPricesBridge] bad refactor

* [EdfPricesBridge] support php 7.4

* [EdfPrices Bridge] fix errors

---------

Co-authored-by: Florent VIOLLEAU <florent.violleau@samsic.fr>
---
 bridges/EdfPricesBridge.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/EdfPricesBridge.php b/bridges/EdfPricesBridge.php
index f67ed30b..18e6f8e6 100644
--- a/bridges/EdfPricesBridge.php
+++ b/bridges/EdfPricesBridge.php
@@ -45,14 +45,14 @@ class EdfPricesBridge extends BridgeAbstract
         }
 
         // colors
-        $ulDom = $html->find('#tarif-de-l-offre-edf-tempo-current-date-html-year', 0)->nextSibling()->nextSibling()->nextSibling();
+        $ulDom = $html->find('#tarif-de-l-offre-tempo-edf-template-date-now-y', 0)->nextSibling()->nextSibling()->nextSibling();
         $elementsDom = $ulDom->find('li');
         if ($elementsDom && count($elementsDom) === 3) {
             foreach ($elementsDom as $elementDom) {
                 $item = [];
 
                 $matches = [];
-                preg_match_all('/Jour (.*) : Heures (.*) : (.*) € \/ Heures (.*) : (.*) €/um', $elementDom->innertext, $matches, PREG_SET_ORDER, 0);
+                preg_match_all('/Jour (.*) : Heures (.*) : (.*)&nbsp;€ \/ Heures (.*) : (.*)&nbsp;€/um', $elementDom->innertext, $matches, PREG_SET_ORDER, 0);
 
                 if ($matches && count($matches[0]) === 6) {
                     for ($i = 0; $i < 2; $i++) {

From 9126b0f98292beed5894b425deacfcb8f895b8e6 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Wed, 11 Dec 2024 23:41:46 -0500
Subject: [PATCH 545/716] [CubariProxyBridge] Fix favicon properly (#4364)

---
 bridges/CubariProxyBridge.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/CubariProxyBridge.php b/bridges/CubariProxyBridge.php
index aab7c09b..8afd2275 100644
--- a/bridges/CubariProxyBridge.php
+++ b/bridges/CubariProxyBridge.php
@@ -122,8 +122,8 @@ class CubariProxyBridge extends BridgeAbstract
         return $uri;
     }
 
-    public function getFavicon()
+    public function getIcon()
     {
-        return parent::getURI() . '/static/favicon.ico';
+        return parent::getURI() . '/static/favicon.png';
     }
 }

From d2370320e929b2fc207b999335fd70b85db14cfb Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Wed, 11 Dec 2024 23:43:17 -0500
Subject: [PATCH 546/716] [ScribbleHubBridge] Get best-effort information
 during 403s (#4365)

---
 bridges/ScribbleHubBridge.php | 50 +++++++++++++++++++++++++++--------
 1 file changed, 39 insertions(+), 11 deletions(-)

diff --git a/bridges/ScribbleHubBridge.php b/bridges/ScribbleHubBridge.php
index b4f7beaa..3578a77c 100644
--- a/bridges/ScribbleHubBridge.php
+++ b/bridges/ScribbleHubBridge.php
@@ -54,44 +54,72 @@ class ScribbleHubBridge extends FeedExpander
         $this->collectExpandableDatas($url);
     }
 
-    protected $author = '';
-
     private function collectList($url)
     {
         $html = getSimpleHTMLDOMCached($url);
         foreach ($html->find('.search_main_box') as $element) {
             $item = [];
 
+            $item['author'] = $element->find('[title="Author"]', 0)->plaintext;
+            $item['enclosures'] = [$element->find('.search_img img', 0)->src];
             $title = $element->find('.search_title a', 0);
             $item['title'] = $title->plaintext;
             $item['uri'] = $title->href;
+            $item['uid'] = $item['uri'];
 
             $strdate = $element->find('[title="Last Updated"]', 0)->plaintext;
             $item['timestamp'] = strtotime($strdate);
-            $item['uid'] = $item['uri'];
 
-            $details = getSimpleHTMLDOMCached($item['uri']);
-            $item['enclosures'][] = $details->find('.fic_image img', 0)->src;
-            $item['content'] = $details->find('.wi_fic_desc', 0);
-
-            foreach ($details->find('.fic_genre') as $tag) {
+            foreach ($element->find('.fic_genre') as $tag) {
                 $item['categories'][] = $tag->plaintext;
             }
+
+            // Get minimal description in case further requests fail
+            $item['content'] = str_get_html($element->find('.search_body', 0));
+            foreach ($item['content']->firstChild()->children() as $child) {
+                $child->remove();
+            }
+
+            try {
+                $details = getSimpleHTMLDOMCached($item['uri']);
+            } catch (HttpException $e) {
+                // 403 Forbidden, This means we got anti-bot response
+                if ($e->getCode() === 403 || $e->getCode() === 429) {
+                    $this->items[] = $item;
+                    continue;
+                }
+                throw $e;
+            }
+            $item['enclosures'] = [$details->find('.fic_image img', 0)->src];
+            $item['content'] = $details->find('.wi_fic_desc', 0);
+
             foreach ($details->find('.stag') as $tag) {
                 $item['categories'][] = $tag->plaintext;
             }
 
             $read_url = $details->find('.read_buttons a', 0)->href;
-            $read_html = getSimpleHTMLDOMCached($read_url);
-            $item['content'] .= '<hr><h3>';
+            $item['comments'] = $read_url . '#comments';
+            try {
+                $read_html = getSimpleHTMLDOMCached($read_url);
+            } catch (HttpException $e) {
+                // 403 Forbidden, This means we got anti-bot response
+                if ($e->getCode() === 403 || $e->getCode() === 429) {
+                    $this->items[] = $item;
+                    continue;
+                }
+                throw $e;
+            }
+            $item['content'] .= "<hr><h3><a href=\"$read_url\">";
             $item['content'] .= $read_html->find('.chapter-title', 0);
-            $item['content'] .= '</h3>';
+            $item['content'] .= '</a></h3>';
             $item['content'] .= $read_html->find('#chp_raw', 0);
 
             $this->items[] = $item;
         }
     }
 
+    protected $author = '';
+
     protected function parseItem(array $item)
     {
         //For series, filter out other series from 'All' feed

From 8234906127f60ca1d545a5bf48bddbb8ec9b6b15 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Thu, 12 Dec 2024 11:50:43 -0500
Subject: [PATCH 547/716] [EpicGamesFreeBridge] Add new bridge (#4366)

---
 bridges/EpicGamesFreeBridge.php | 74 +++++++++++++++++++++++++++++++++
 1 file changed, 74 insertions(+)
 create mode 100644 bridges/EpicGamesFreeBridge.php

diff --git a/bridges/EpicGamesFreeBridge.php b/bridges/EpicGamesFreeBridge.php
new file mode 100644
index 00000000..087b95be
--- /dev/null
+++ b/bridges/EpicGamesFreeBridge.php
@@ -0,0 +1,74 @@
+<?php
+
+class EpicGamesFreeBridge extends BridgeAbstract
+{
+    const NAME = 'Epic Games Free Games';
+    const MAINTAINER = 'phantop';
+    const URI = 'https://store.epicgames.com/';
+    const DESCRIPTION = 'Returns the latest free games from Epic Games';
+    const PARAMETERS = [ [
+        'locale' => [
+            'name' => 'Language',
+            'type' => 'list',
+            'values' => [
+                'English' => 'en-US',
+                'العربية' => 'ar',
+                'Deutsch' => 'de',
+                'Español (Spain)' => 'es-ES',
+                'Español (LA)' => 'es-MX',
+                'Français' => 'fr',
+                'Italiano' => 'it',
+                '日本語' => 'ja',
+                '한국어' => 'ko',
+                'Polski' => 'pl',
+                'Português (Brasil)' => 'pt-BR',
+                'Русский' => 'ru',
+                'ไทย' => 'th',
+                'Türkçe' => 'tr',
+                '简体中文' => 'zh-CN',
+                '繁體中文' => 'zh-Hant',
+             ],
+            'title' => 'Language for game information',
+            'defaultValue' => 'en-US',
+        ],
+        'country' => [
+            'name' => 'Country',
+            'title' => 'Country store to check for deals',
+            'defaultValue' => 'US',
+        ]
+    ]];
+
+    public function collectData()
+    {
+        $url = 'https://store-site-backend-static.ak.epicgames.com/freeGamesPromotions?';
+        $params = [
+            'locale' => $this->getInput('locale'),
+            'country' => $this->getInput('country'),
+            'allowCountries' => $this->getInput('country'),
+        ];
+        $url .= http_build_query($params);
+        $json = Json::decode(getContents($url));
+
+        $data = $json['data']['Catalog']['searchStore']['elements'];
+        foreach ($data as $element) {
+            if (!isset($element['promotions']['promotionalOffers'][0])) {
+                continue;
+            }
+            $item = [
+                'author' => $element['seller']['name'],
+                'content' => $element['description'],
+                'enclosures' => array_map(fn($item) => $item['url'], $element['keyImages']),
+                'timestamp' => strtotime($element['promotions']['promotionalOffers'][0]['promotionalOffers'][0]['startDate']),
+                'title' => $element['title'],
+                'url' => parent::getURI() . $this->getInput('locale') . '/p/' . $element['urlSlug'],
+            ];
+            $this->items[] = $item;
+        }
+    }
+
+    public function getURI()
+    {
+        $uri = parent::getURI() . $this->getInput('locale') . '/free-games';
+        return $uri;
+    }
+}

From f0db6a22d1a6945314950ccc2997966b29a81944 Mon Sep 17 00:00:00 2001
From: Michael Vincent <377567+Vynce@users.noreply.github.com>
Date: Thu, 12 Dec 2024 10:52:41 -0600
Subject: [PATCH 548/716] [WirecutterDealsBridge] Add bridge (#4359)

---
 bridges/WirecutterDealsBridge.php | 119 ++++++++++++++++++++++++++++++
 1 file changed, 119 insertions(+)
 create mode 100644 bridges/WirecutterDealsBridge.php

diff --git a/bridges/WirecutterDealsBridge.php b/bridges/WirecutterDealsBridge.php
new file mode 100644
index 00000000..15e9449e
--- /dev/null
+++ b/bridges/WirecutterDealsBridge.php
@@ -0,0 +1,119 @@
+<?php
+
+class WirecutterDealsBridge extends BridgeAbstract
+{
+    const NAME = 'Wirecutter Deals';
+    const URI = 'https://www.nytimes.com/wirecutter/deals/';
+    const DESCRIPTION = 'Deals from The Wirecutter';
+    const MAINTAINER = 'Vynce';
+    const CACHE_TIMEOUT = 900; // 15 minutes
+
+    public function collectData()
+    {
+        $html = getSimpleHTMLDOM($this->getURI());
+        $json = $html->getElementById('__NEXT_DATA__');
+        $data = json_decode($json->innertext());
+
+        foreach ($data->props->pageProps->specialEvent->eventDeals as $deal) {
+            $item = [];
+            $item['uri'] = "https://www.nytimes.com/wirecutter/deals/#deal-{$deal->id}";
+            $item['title'] = $deal->title;
+            $item['timestamp'] = $deal->date;
+            $item['content'] = $this->generateContent($deal);
+            $item['categories'] = $deal->categories;
+            $item['uid'] = strval($deal->id);
+
+            $this->items[] = $item;
+        }
+    }
+
+    public function getIcon()
+    {
+        return <<<'EOD'
+        data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAD7klEQ
+        VR4AWIgFoReXcVmdnKRuymg9WoAkiUJon2+8BnhiLP17bNtX+Bs27aN0bdtY8y1bZu9m1evIrZH
+        VTW9HVsVuTNTndH5qirz5VuP7ddL3LZdk9y2AmZdk9z2TvaZP8lj3znFY/95ssdxxWPB4GHaRI1
+        Lgq6T2ct/RyAWmExa+ySP7acZMecJlgPPK7cdOdlj/5i9qFcdTG44Ifb5Lk7Pwq5tXnUA8zbZbd
+        s7O/zf8aaCT/U6zmc7r7ESaFZwAd1fvpmuzVkhel4xzeM8K+POZcHnhBbSQ5Vb6fmmffQAC3J5d
+        IkQxDSfk5YNF9O2kQqazQClPC+fF1x4nPTOZcf+epuPemmA9JQZoXr6oCtMN+StSvL/tT+XP9+k
+        lwnywr5HWCVIOFHwZxv3km5iVlE7rWMBd7CdD7OJtUEaoul+lyAn7G8Kkk6c7cXUQrrFCSAz0gH
+        AOqb4HMcaAFDnwuz12I2XbdXL6f2uEP09kE+e0RoaYjMTgC16uaJE7d8ZDKcimTJqITcLmJrtj1
+        Rto6fq99CSoSLqor604CGqkyYqjG26+U5aeogGelWV1oMVW2j1cAn/fnX2Mp7hP7EkY+XK12YG5
+        vMkvK1oHT3dsIfWDpeiSnB6mfnBb5+jgdszOV4WWUwvt7ipm/pwFXztqqxl9HVfNl97s91n+L7a
+        6jHPHZ7/vtHQWDI5ftITNbL62cZ99MdAXmIOWAbAEn+Dhq6mcsJdJ9b93aUbUkvTAIBjXzRUhBw
+        x2ysiANAldBCU4UfdYazhrtMAICg4AL9zqdFIQLXZGzVVBdxetC4xEGhYCuDdzkDiGq7JzAk04A
+        TyZQ5IvISX4n6lALAOWsbvPwfyTVQB7L+wBiUjcQDxCHYlBQAbuybDrsleriKj9RpklMzhxeYDS
+        YFiVC8HIKiCK2NL6bPemIqMvtSg4WQOd5asT2U4gDIA9NMgjhucIAQAUsJvBYCZGlojmoMkSaiB
+        OpMAgHa/68/G9UAjGL6JAKAJ7IMF3P/G/FXSCviAPjhYw4CAlKF8oWm/sNE4Bwvp3rJNdGlkkQH
+        2utwVnKrrqIP7+Edr1cc/NqBeZXyAF2/Uy5RdD2IFrTe1Fd/HAEp23zZr34KjtcQB9cpMKrPQWv
+        VxzHc6AgqRan9F+I8H1KuCNOi1Vi+1ULcycBN10ZP1u1Wlt423YdGAdIZ6haPqNB6r3cWFye6RS
+        l6ae0eqyDFYCH1gSDCJFfGjVw1IZ6hXZjTBVnSx23WqZmZAOkO9TlRwHLt855IBfoB6NTjCktnb
+        kHD8zq0OqFcISGi4cQRuRJ1Ldm1tYBfQcJBRUDIQEwiEloquhsaCoKBXznAmx/9MoY9pELa5wwA
+        AAABJRU5ErkJggg==
+        EOD;
+    }
+
+    private function jsonToHtml($node)
+    {
+        if ($node['type'] == 'text') {
+            return htmlspecialchars($node['data'], ENT_QUOTES, 'UTF-8');
+        }
+
+        if ($node['type'] == 'tag') {
+            $html = "<{$node['name']}";
+
+            foreach ($node['attribs'] as $key => $value) {
+                $html .= sprintf(
+                    ' %s="%s"',
+                    htmlspecialchars($key, ENT_QUOTES, 'UTF-8'),
+                    htmlspecialchars($value, ENT_QUOTES, 'UTF-8')
+                );
+            }
+
+            $html .= '>';
+
+            foreach ($node['children'] as $child) {
+                $html .= $this->jsonToHtml($child);
+            }
+
+            $html .= "</{$node['name']}>";
+
+            return $html;
+        }
+
+        return '';
+    }
+
+    private function generateContent($deal)
+    {
+        $img_link = $deal->image->source;
+        $content = "<p><img src=\"https://cdn.thewirecutter.com/{$img_link}?width=314&amp;quality=75&amp;crop=3:2&amp;auto=webp\"></p>";
+
+        $content .= "<p><strong>\${$deal->price}</strong> <del>\${$deal->streetPrice}</del></p>";
+
+        foreach ($deal->buyButtons as $buy) {
+            $content .= "<p>Buy from <a href=\"{$buy->url}\">$buy->merchant</a>";
+            if ($buy->promo->effect) {
+                $content .= " {$buy->promo->effect}";
+            }
+            if ($buy->promo->code) {
+                $content .= " (Use promo code {$buy->promo->code})";
+            }
+            $content .= '</p>';
+        }
+
+        $content .= '<p>&nbsp;</p>';
+        $structuredContent = json_decode($deal->structuredContent, true);
+        foreach ($structuredContent as $node) {
+            $content .= $this->jsonToHtml($node);
+        }
+
+        if ($deal->relatedArticle) {
+            $review = $deal->relatedArticle;
+            $content .= '<p>&nbsp;</p>';
+            $content .= "<p>Read the review: <a href=\"https://www.nytimes.com/wirecutter{$review->link}\">{$review->title}</a></p>";
+        }
+
+        return $content;
+    }
+}

From 152e96d3d06b626574ecc79781479d46c7d9867d Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Mon, 30 Dec 2024 00:19:18 +0100
Subject: [PATCH 549/716] fix: broken if_not_modified_since (#4377)

---
 lib/contents.php | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/lib/contents.php b/lib/contents.php
index 56a3db20..752c0ff2 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -24,6 +24,13 @@ function getContents(
 
     // TODO: consider url validation at this point
 
+    $config = [
+        'useragent'     => Configuration::getConfig('http', 'useragent'),
+        'timeout'       => Configuration::getConfig('http', 'timeout'),
+        'retries'       => Configuration::getConfig('http', 'retries'),
+        'curl_options'  => $curlOptions,
+    ];
+
     $httpHeadersNormalized = [];
     foreach ($httpHeaders as $httpHeader) {
         $parts = explode(':', $httpHeader);
@@ -69,13 +76,7 @@ function getContents(
         'TE' => 'trailers',
     ];
 
-    $config = [
-        'useragent' => Configuration::getConfig('http', 'useragent'),
-        'timeout' => Configuration::getConfig('http', 'timeout'),
-        'retries' => Configuration::getConfig('http', 'retries'),
-        'headers' => array_merge($defaultHttpHeaders, $httpHeadersNormalized),
-        'curl_options' => $curlOptions,
-    ];
+    $config['headers'] = array_merge($defaultHttpHeaders, $httpHeadersNormalized);
 
     $maxFileSize = Configuration::getConfig('http', 'max_filesize');
     if ($maxFileSize) {

From 7d544f1fab0e7c2d7518f0a6e3495dbc4f8e7cb3 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 2 Jan 2025 16:33:56 +0100
Subject: [PATCH 550/716] feat(reddit): support video (#4380)

---
 bridges/RedditBridge.php | 23 ++++++++++++++++++-----
 1 file changed, 18 insertions(+), 5 deletions(-)

diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index 03f279d8..2a3824f4 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -234,11 +234,14 @@ class RedditBridge extends BridgeAbstract
                 } elseif ($data->is_video) {
                     // Video
 
-                    // Higher index -> Higher resolution
-                    end($data->preview->images[0]->resolutions);
-                    $index = key($data->preview->images[0]->resolutions);
-
-                    $item['content'] = $this->createFigureLink($data->url, $data->preview->images[0]->resolutions[$index]->url, 'Video');
+                    if ($data->media->reddit_video) {
+                        $item['content'] = $this->createVideoContent($data->media->reddit_video);
+                    } else {
+                        // Higher index -> Higher resolution
+                        end($data->preview->images[0]->resolutions);
+                        $index = key($data->preview->images[0]->resolutions);
+                        $item['content'] = $this->createFigureLink($data->url, $data->preview->images[0]->resolutions[$index]->url, 'Video');
+                    }
                 } elseif (isset($data->media) && $data->media->type == 'youtube.com') {
                     // Youtube link
                     $item['content'] = $this->createFigureLink($data->url, $data->media->oembed->thumbnail_url, 'YouTube');
@@ -318,6 +321,16 @@ class RedditBridge extends BridgeAbstract
         return sprintf('<a href="%s">%s</a>', $href, $text);
     }
 
+    private function createVideoContent(\stdClass $video): string
+    {
+        return <<<HTML
+            <video width="$video->width" height="$video->height" controls>
+                <source src="$video->fallback_url" type="video/mp4">
+                Your browser does not support the video tag.
+            </video>
+        HTML;
+    }
+
     public function detectParameters($url)
     {
         try {

From b4a63e7040946b0772950d71d9e244f24ee2cf2e Mon Sep 17 00:00:00 2001
From: "Florent V." <floviolleau@users.noreply.github.com>
Date: Thu, 2 Jan 2025 16:45:33 +0100
Subject: [PATCH 551/716] [EdfPrices Bridge] add HC/HP, base and EJP (#4369)

* [EdfPrices Bridge] add HC/HP, base and EJP

* [EdfPrices Bridge] lint

* [EdfPrices Bridge] fix missing variable
---
 bridges/EdfPricesBridge.php | 231 ++++++++++++++++++++++++++++++------
 1 file changed, 194 insertions(+), 37 deletions(-)

diff --git a/bridges/EdfPricesBridge.php b/bridges/EdfPricesBridge.php
index 18e6f8e6..06cd30b7 100644
--- a/bridges/EdfPricesBridge.php
+++ b/bridges/EdfPricesBridge.php
@@ -12,8 +12,28 @@ class EdfPricesBridge extends BridgeAbstract
             'contract' => [
                 'name' => 'Choisir un contrat',
                 'type' => 'list',
-                // we can add later HCHP, EJP, base
-                'values' => ['Tempo' => '/energie/edf/tarifs/tempo'],
+                // we can add later more option prices
+                'values' => [
+                    'Base' => '/energie/edf/tarifs/tarif-bleu#base',
+                    'HPHC' => '/energie/edf/tarifs/tarif-bleu#hphc',
+                    'EJP' => '/energie/edf/tarifs/tarif-bleu#ejp',
+                    'Tempo' => '/energie/edf/tarifs/tempo'
+                ],
+            ],
+            'power' => [
+                'name' => 'Choisir une puissance',
+                'type' => 'list',
+                'values' => [
+                    '3 kVA' => 3,
+                    '6 kVA' => 6,
+                    '9 kVA' => 9,
+                    '12 kVA' => 12,
+                    '15 kVA' => 15,
+                    '18 kVA' => 18,
+                    '24 kVA' => 24,
+                    '30 kVA' => 30,
+                    '36 kVA' => 36
+                ]
             ]
         ]
     ];
@@ -24,36 +44,20 @@ class EdfPricesBridge extends BridgeAbstract
      * @param string $contractUri
      * @return void
      */
-    private function tempo(simple_html_dom $html, string $contractUri): void
+    private function tempo(simple_html_dom $html, string $contractUri, int $power): void
     {
-        // current color and next
-        $daysDom = $html->find('#calendrier', 0)->nextSibling()->find('.card--ejp');
-        if ($daysDom && count($daysDom) === 2) {
-            foreach ($daysDom as $dayDom) {
-                $day = trim($dayDom->find('.card__title', 0)->innertext) . '/' . (new \DateTime('now'))->format(('Y'));
-                $dayColor = $dayDom->find('.card-ejp__icon span', 0)->innertext;
-
-                $text = $day . ' - ' . $dayColor;
-                $item['uri'] = self::URI . $contractUri;
-                $item['title'] = $text;
-                $item['author'] = self::MAINTAINER;
-                $item['content'] = $text;
-                $item['uid'] = hash('sha256', $item['title']);
-
-                $this->items[] = $item;
-            }
-        }
-
         // colors
         $ulDom = $html->find('#tarif-de-l-offre-tempo-edf-template-date-now-y', 0)->nextSibling()->nextSibling()->nextSibling();
         $elementsDom = $ulDom->find('li');
         if ($elementsDom && count($elementsDom) === 3) {
+            // price per kWh is same for all powers
             foreach ($elementsDom as $elementDom) {
                 $item = [];
 
                 $matches = [];
                 preg_match_all('/Jour (.*) : Heures (.*) : (.*)&nbsp;€ \/ Heures (.*) : (.*)&nbsp;€/um', $elementDom->innertext, $matches, PREG_SET_ORDER, 0);
 
+                // for tempo contract we have 2x3 colors
                 if ($matches && count($matches[0]) === 6) {
                     for ($i = 0; $i < 2; $i++) {
                         $text = 'Jour ' . $matches[0][1] . ' - Heures ' . $matches[0][2 + 2 * $i] . ' : ' . $matches[0][3 + 2 * $i] . '€';
@@ -69,26 +73,166 @@ class EdfPricesBridge extends BridgeAbstract
             }
         }
 
-        // powers
-        $ulPowerContract = $ulDom->nextSibling()->nextSibling();
-        $elementsPowerContractDom = $ulPowerContract->find('li');
-        if ($elementsPowerContractDom && count($elementsPowerContractDom) === 4) {
-            foreach ($elementsPowerContractDom as $elementPowerContractDom) {
+        // add subscription power info
+        $tablePrices = $ulDom->nextSibling()->nextSibling()->nextSibling()->find('.table--responsive', 0);
+        $this->addSubscriptionPowerInfo($tablePrices, $contractUri, $power, 7);
+    }
+
+    /**
+     * @param simple_html_dom $html
+     * @param string $contractUri
+     * @return void
+     */
+    private function base(simple_html_dom $html, string $contractUri, int $power): void
+    {
+        $tablePrices = $html
+                            ->find('#grille-tarifaire-et-prix-du-kwh-du-tarif-reglemente-edf-en-option-base', 0)
+                            ->nextSibling()
+                            ->nextSibling()
+                            ->nextSibling();
+
+        $prices = $tablePrices->find('.table--stripped tbody tr');
+        // last element is useless because part of another table
+        array_pop($prices);
+
+        // price per kWh is same for all powers
+        if ($prices && count($prices) === 9) {
+            $item = [];
+
+            $text = 'Base : ' . $prices[0]->children(2);
+            $item['uri'] = self::URI . $contractUri;
+            $item['title'] = $text;
+            $item['author'] = self::MAINTAINER;
+            $item['content'] = $text;
+            $item['uid'] = hash('sha256', $item['title']);
+
+            $this->items[] = $item;
+        }
+
+        $this->addSubscriptionPowerInfo($tablePrices, $contractUri, $power, 9);
+    }
+
+    /**
+     * @param simple_html_dom $html
+     * @param string $contractUri
+     * @return void
+     */
+    private function hphc(simple_html_dom $html, string $contractUri, int $power): void
+    {
+        $tablePrices = $html
+                            ->find('#grille-tarifaire-et-prix-du-kwh-du-tarif-reglemente-edf-en-option-heures-pleines-heures-creuses', 0)
+                            ->nextSibling()
+                            ->nextSibling()
+                            ->nextSibling();
+
+        $prices = $tablePrices->find('.table--stripped tbody tr');
+        // last element is useless because part of another table
+        array_pop($prices);
+
+        // price per kWh is same for all powers
+        if ($prices && count($prices) === 8) {
+            $values = ['HC', 'HP'];
+            foreach ($values as $key => $value) {
+                $i++;
                 $item = [];
 
-                $matches = [];
-                preg_match_all('/(.*) kVA : (.*) €/um', $elementPowerContractDom->innertext, $matches, PREG_SET_ORDER, 0);
+                $text = $values[$key] . ' : ' . $prices[0]->children($key + 2);
+                $item['uri'] = self::URI . $contractUri;
+                $item['title'] = $text;
+                $item['author'] = self::MAINTAINER;
+                $item['content'] = $text;
+                $item['uid'] = hash('sha256', $item['title']);
 
-                if ($matches && count($matches[0]) === 3) {
-                    $text = $matches[0][1] . ' kVA : ' . $matches[0][2] . '€';
-                    $item['uri'] = self::URI . $contractUri;
-                    $item['title'] = $text;
-                    $item['author'] = self::MAINTAINER;
-                    $item['content'] = $text;
-                    $item['uid'] = hash('sha256', $item['title']);
+                $this->items[] = $item;
+            }
+        }
 
-                    $this->items[] = $item;
+        $this->addSubscriptionPowerInfo($tablePrices, $contractUri, $power, 8);
+    }
+
+    /**
+     * @param simple_html_dom $html
+     * @param string $contractUri
+     * @return void
+     */
+    private function ejp(simple_html_dom $html, string $contractUri, int $power): void
+    {
+        $tablePrices = $html
+                            ->find('#grille-tarifaire-et-prix-du-kwh-du-tarif-reglemente-edf-en-option-ejp', 0)
+                            ->nextSibling()
+                            ->nextSibling()
+                            ->nextSibling();
+
+        $prices = $tablePrices->find('.table--stripped tbody tr');
+        // last element is useless because part of another table
+        array_pop($prices);
+
+        // price per kWh is same for all powers
+        if ($prices && count($prices) === 5) {
+            $values = ['Non EJP', 'EJP'];
+            foreach ($values as $key => $value) {
+                $i++;
+                $item = [];
+
+                $text = $values[$key] . ' : ' . $prices[0]->children($key + 2);
+                $item['uri'] = self::URI . $contractUri;
+                $item['title'] = $text;
+                $item['author'] = self::MAINTAINER;
+                $item['content'] = $text;
+                $item['uid'] = hash('sha256', $item['title']);
+
+                $this->items[] = $item;
+            }
+        }
+
+        $this->addSubscriptionPowerInfo($tablePrices, $contractUri, $power, 5);
+    }
+
+    private function addSubscriptionPowerInfo(simple_html_dom_node $tablePrices, string $contractUri, int $power, int $numberOfPrices): void
+    {
+        $prices = $tablePrices->find('.table--stripped tbody tr');
+        // last element is useless because part of another table
+        array_pop($prices);
+
+        // 7 contracts for tempo: 6, 9, 12, 15, 18, 30 and 36 kVA
+        // 9 contracts for base: 3, 6, 9, 12, 15, 18, 24, 30 and 36 kVA
+        // 7 contracts for HPHC: 6, 9, 12, 15, 18, 24, 30 and 36 kVA
+        // 5 contracts for EJP: 9, 12, 15, 18 and 36 kVA
+        if ($prices && count($prices) === $numberOfPrices) {
+            $powerFound = false;
+            foreach ($prices as $price) {
+                $powerText = $price->firstChild()->firstChild()->innertext;
+                $powerValue = (int)substr($powerText, 0, strpos($powerText, ' kVA'));
+
+                if ($powerValue !== $power) {
+                    continue;
                 }
+
+                $item = [];
+
+                $text = $powerText . ' : ' . $price->children(1) . '/an';
+                $item['uri'] = self::URI . $contractUri;
+                $item['title'] = $text;
+                $item['author'] = self::MAINTAINER;
+                $item['content'] = $text;
+                $item['uid'] = hash('sha256', $item['title']);
+
+                $this->items[] = $item;
+                $powerFound = true;
+                break;
+            }
+
+            if (!$powerFound) {
+                $item = [];
+
+                $text = 'Pas de tarif abonnement pour cette puissance et ce contrat';
+                $item['uri'] = self::URI . $contractUri;
+                $item['title'] = $text;
+                $item['author'] = self::MAINTAINER;
+                $item['content'] = $text;
+                $item['uid'] = hash('sha256', $item['title']);
+
+                $this->items[] = $item;
             }
         }
     }
@@ -97,10 +241,23 @@ class EdfPricesBridge extends BridgeAbstract
     {
         $contract = $this->getKey('contract');
         $contractUri = $this->getInput('contract');
+        $power = $this->getInput('power');
         $html = getSimpleHTMLDOM(self::URI . $contractUri);
 
         if ($contract === 'Tempo') {
-            $this->tempo($html, $contractUri);
+            $this->tempo($html, $contractUri, $power);
+        }
+
+        if ($contract === 'Base') {
+            $this->base($html, $contractUri, $power);
+        }
+
+        if ($contract === 'HPHC') {
+            $this->hphc($html, $contractUri, $power);
+        }
+
+        if ($contract === 'EJP') {
+            $this->ejp($html, $contractUri, $power);
         }
     }
 }

From 4b4d622333fa810cb271b6f3972234bea0a9db51 Mon Sep 17 00:00:00 2001
From: "Quentin B." <quent1-fr@users.noreply.github.com>
Date: Thu, 2 Jan 2025 17:14:10 +0100
Subject: [PATCH 552/716] [CentreFranceBridge] Update parser to handle latest
 website layout changes (#4372)

---
 bridges/CentreFranceBridge.php | 69 ++++++++++++++--------------------
 1 file changed, 28 insertions(+), 41 deletions(-)

diff --git a/bridges/CentreFranceBridge.php b/bridges/CentreFranceBridge.php
index a6dea227..1abfae98 100644
--- a/bridges/CentreFranceBridge.php
+++ b/bridges/CentreFranceBridge.php
@@ -48,6 +48,11 @@ class CentreFranceBridge extends BridgeAbstract
         ]
     ];
 
+    private static array $monthNumberByFrenchName = [
+        'janvier' => 1, 'février' => 2, 'mars' => 3, 'avril' => 4, 'mai' => 5, 'juin' => 6, 'juillet' => 7,
+        'août' => 8, 'septembre' => 9, 'octobre' => 10, 'novembre' => 11, 'décembre' => 12
+    ];
+
     public function collectData()
     {
         $value = $this->getInput('limit');
@@ -130,14 +135,22 @@ class CentreFranceBridge extends BridgeAbstract
             'enclosures' => [],
         ];
 
-        $articleInformations = $html->find('.c-article-informations p');
+        $articleInformations = $html->find('#content hgroup > div.typo-p3 > *');
         if (is_array($articleInformations) && $articleInformations !== []) {
-            $authorPosition = 1;
+            $publicationDateIndex = 0;
+
+            // Article author
+            $probableAuthorName = strip_tags($articleInformations[0]->innertext);
+            if (str_starts_with($probableAuthorName, 'Par ')) {
+                $publicationDateIndex = 1;
+                $item['author'] = substr($probableAuthorName, 4);
+            }
 
             // Article publication date
-            if (preg_match('/(\d{2})\/(\d{2})\/(\d{4})( à (\d{2})h(\d{2}))?/', $articleInformations[0]->innertext, $articleDateParts) > 0) {
+            preg_match('/Publié le (\d{2}) (.+) (\d{4})( à (\d{2})h(\d{2}))?/', strip_tags($articleInformations[$publicationDateIndex]->innertext), $articleDateParts);
+            if ($articleDateParts !== [] && array_key_exists($articleDateParts[2], self::$monthNumberByFrenchName)) {
                 $articleDate = new \DateTime('midnight');
-                $articleDate->setDate($articleDateParts[3], $articleDateParts[2], $articleDateParts[1]);
+                $articleDate->setDate($articleDateParts[3], self::$monthNumberByFrenchName[$articleDateParts[2]], $articleDateParts[1]);
 
                 if (count($articleDateParts) === 7) {
                     $articleDate->setTime($articleDateParts[5], $articleDateParts[6]);
@@ -145,57 +158,31 @@ class CentreFranceBridge extends BridgeAbstract
 
                 $item['timestamp'] = $articleDate->getTimestamp();
             }
-
-            // Article update date
-            if (count($articleInformations) >= 2 && preg_match('/(\d{2})\/(\d{2})\/(\d{4})( à (\d{2})h(\d{2}))?/', $articleInformations[1]->innertext, $articleDateParts) > 0) {
-                $authorPosition = 2;
-
-                $articleDate = new \DateTime('midnight');
-                $articleDate->setDate($articleDateParts[3], $articleDateParts[2], $articleDateParts[1]);
-
-                if (count($articleDateParts) === 7) {
-                    $articleDate->setTime($articleDateParts[5], $articleDateParts[6]);
-                }
-
-                $item['timestamp'] = $articleDate->getTimestamp();
-            }
-
-            if (count($articleInformations) === ($authorPosition + 1)) {
-                $item['author'] = $articleInformations[$authorPosition]->innertext;
-            }
         }
 
-        $articleContent = $html->find('.b-article .contenu > *');
-        if (is_array($articleContent)) {
-            $item['content'] = '';
-
-            foreach ($articleContent as $contentPart) {
-                if (in_array($contentPart->getAttribute('id'), ['cf-audio-player', 'poool-widget'], true)) {
-                    continue;
+        $articleContent = $html->find('#content>div.flex+div.grid section>.z-10')[0] ?? null;
+        if ($articleContent instanceof \simple_html_dom_node) {
+            $articleHiddenParts = $articleContent->find('.ad-slot, #cf-digiteka-player');
+            if (is_array($articleHiddenParts)) {
+                foreach ($articleHiddenParts as $articleHiddenPart) {
+                    $articleContent->removeChild($articleHiddenPart);
                 }
-
-                $articleHiddenParts = $contentPart->find('.bloc, .p402_hide');
-                if (is_array($articleHiddenParts)) {
-                    foreach ($articleHiddenParts as $articleHiddenPart) {
-                        $contentPart->removeChild($articleHiddenPart);
-                    }
-                }
-
-                $item['content'] .= $contentPart->innertext;
             }
+
+            $item['content'] = $articleContent->innertext;
         }
 
-        $articleIllustration  = $html->find('.photo-wrapper .photo-box img');
+        $articleIllustration  = $html->find('#content>div.flex+div.grid section>figure>img');
         if (is_array($articleIllustration) && count($articleIllustration) === 1) {
             $item['enclosures'][] = $articleIllustration[0]->getAttribute('src');
         }
 
-        $articleAudio = $html->find('#cf-audio-player-container audio');
+        $articleAudio = $html->find('audio[src^="https://api.octopus.saooti.com/"]');
         if (is_array($articleAudio) && count($articleAudio) === 1) {
             $item['enclosures'][] = $articleAudio[0]->getAttribute('src');
         }
 
-        $articleTags = $html->find('.b-article > ul.c-tags > li > a.t-simple');
+        $articleTags = $html->find('#content>div.flex+div.grid section>.bg-gray-light>a.border-gray-dark');
         if (is_array($articleTags)) {
             $item['categories'] = array_map(static fn ($articleTag) => $articleTag->innertext, $articleTags);
         }

From 974f00cd6a3fb4f4ccda08069408edb9c7e1d6f4 Mon Sep 17 00:00:00 2001
From: Sebastian Wolf <117176763+swofl@users.noreply.github.com>
Date: Thu, 2 Jan 2025 17:17:54 +0100
Subject: [PATCH 553/716] [MixologyBridge] adapt to latest site changes (#4368)

* [MixologyBridge] adapt to latest site changes

* [MixologyBridge] fix category selector
---
 bridges/MixologyBridge.php | 66 ++++++++++++++++++++++++++------------
 1 file changed, 45 insertions(+), 21 deletions(-)

diff --git a/bridges/MixologyBridge.php b/bridges/MixologyBridge.php
index 1246b4db..e954d0d6 100644
--- a/bridges/MixologyBridge.php
+++ b/bridges/MixologyBridge.php
@@ -1,49 +1,73 @@
 <?php
 
-class MixologyBridge extends FeedExpander
+class MixologyBridge extends BridgeAbstract
 {
     const MAINTAINER = 'swofl';
     const NAME = 'Mixology';
     const URI = 'https://mixology.eu';
     const CACHE_TIMEOUT = 6 * 60 * 60; // 6h
     const DESCRIPTION = 'Get latest blog posts from Mixology';
-    const PARAMETERS = [ [
-        'limit' => self::LIMIT,
-    ] ];
 
     public function collectData()
     {
-        $feed_url = self::URI . '/feed';
-        $limit = $this->getInput('limit') ?? 10;
-        $this->collectExpandableDatas($feed_url, $limit);
+        $html = getSimpleHTMLDOM(self::URI);
+
+        $teasers = [];
+        $teaserElements = [];
+
+        $teaserElements[] = $html->find('.aufmacher .views-view-responsive-grid__item-inner', 0);
+        foreach ($html->find('.block-views-blockmixology-frontpage-block-2 .views-col') as $teaser) {
+            $teaserElements[] = $teaser;
+        }
+
+        foreach ($teaserElements as $teaser) {
+            $teasers[] = $this->parseTeaser($teaser);
+        }
+
+        foreach ($teasers as $article) {
+            $this->items[] = $this->parseItem($article);
+        }
+    }
+
+    protected function parseTeaser($teaser)
+    {
+        $result = [];
+
+        $title = $teaser->find('.views-field-title a', 0);
+        $result['title'] = $title->plaintext;
+        $result['uri'] = self::URI . $title->href;
+        $result['enclosures'] = [];
+        $result['enclosures'][] = self::URI . $teaser->find('img', 0)->src;
+        $result['uid'] = hash('sha256', $result['title']);
+
+        $categories = $teaser->find('.views-field-field-kategorie', 0);
+        if ($categories) {
+            $result['categories'] = [];
+            foreach ($categories->find('a') as $category) {
+                $result['categories'][] = $category->innertext;
+            }
+        }
+
+        return $result;
     }
 
     protected function parseItem(array $item)
     {
         $article = getSimpleHTMLDOMCached($item['uri']);
 
+        $item['author'] = $article->find('.beitrag-author a', 0)->plaintext;
+        $item['timestamp'] = strtotime($article->find('.beitrag-date time', 0)->datetime);
+
         $content = '';
 
-        $headerImage = $article->find('div.edgtf-full-width img.wp-post-image', 0);
+        $content .= '<img src="' . $item['enclosures'][0] . '"/>';
 
-        if (is_object($headerImage)) {
-            $item['enclosures'] = [];
-            $item['enclosures'][] = $headerImage->src;
-            $content .= '<img src="' . $headerImage->src . '"/>';
-        }
-
-        foreach ($article->find('article .wpb_content_element > .wpb_wrapper') as $element) {
+        foreach ($article->find('article .wpb_content_element>.wpb_wrapper, article .field--type-text-with-summary>.wp-block-columns>.wp-block-column') as $element) {
             $content .= $element->innertext;
         }
 
         $item['content'] = $content;
 
-        $item['categories'] = [];
-
-        foreach ($article->find('.edgtf-tags > a') as $tag) {
-            $item['categories'][] = $tag->plaintext;
-        }
-
         return $item;
     }
 }

From 2a44a006b222c51a421b2f27f0539263d5bf3bcf Mon Sep 17 00:00:00 2001
From: mruac <ant8672@gmail.com>
Date: Fri, 3 Jan 2025 03:09:07 +1030
Subject: [PATCH 554/716] Update BlueskyBridge.php (#4367)

* Update BlueskyBridge.php

* Used human readable terms
* Include quote and reply post
* Added video support
* Replaced Youtube embed with thumbnail preview
* Added link embed preview
* Included visible alt text to images

* appease the lint

* remove unused test code

* fix unset displayName

* appease the lint
---
 bridges/BlueskyBridge.php | 561 +++++++++++++++++++++++++++++++-------
 1 file changed, 459 insertions(+), 102 deletions(-)

diff --git a/bridges/BlueskyBridge.php b/bridges/BlueskyBridge.php
index 8dab82f4..89e5f3bc 100644
--- a/bridges/BlueskyBridge.php
+++ b/bridges/BlueskyBridge.php
@@ -2,10 +2,12 @@
 
 class BlueskyBridge extends BridgeAbstract
 {
-    const NAME = 'Bluesky';
+    //Initial PR by [RSSBridge contributors](https://github.com/RSS-Bridge/rss-bridge/issues/4058).
+    //Modified from [©DIYgod and contributors at RSSHub](https://github.com/DIYgod/RSSHub/tree/master/lib/routes/bsky), MIT License';
+    const NAME = 'Bluesky Bridge';
     const URI = 'https://bsky.app';
     const DESCRIPTION = 'Fetches posts from Bluesky';
-    const MAINTAINER = 'Code modified from rsshub (TonyRL https://github.com/TonyRL) and expanded';
+    const MAINTAINER = 'mruac';
     const PARAMETERS = [
         [
             'data_source' => [
@@ -17,24 +19,39 @@ class BlueskyBridge extends BridgeAbstract
                 ],
                 'title' => 'Select the type of data source to fetch from Bluesky.'
             ],
-            'handle' => [
-                'name' => 'User Handle',
+            'user_id' => [
+                'name' => 'User Handle or DID',
                 'type' => 'text',
                 'required' => true,
-                'exampleValue' => 'jackdodo.bsky.social',
-                'title' => 'Handle found in URL'
+                'exampleValue' => 'did:plc:z72i7hdynmk6r22z27h6tvur',
+                'title' => 'ATProto / Bsky.app handle or DID'
             ],
-            'filter' => [
-                'name' => 'Filter',
+            'feed_filter' => [
+                'name' => 'Feed type',
                 'type' => 'list',
                 'defaultValue' => 'posts_and_author_threads',
                 'values' => [
-                    'posts_and_author_threads' => 'posts_and_author_threads',
-                    'posts_with_replies' => 'posts_with_replies',
-                    'posts_no_replies' => 'posts_no_replies',
-                    'posts_with_media' => 'posts_with_media',
-                ],
-                'title' => 'Combinations of post/repost types to include in response.'
+                    'Posts feed' => 'posts_and_author_threads',
+                    'All posts and replies' => 'posts_with_replies',
+                    'Root posts only' => 'posts_no_replies',
+                    'Media only' => 'posts_with_media',
+                ]
+            ],
+
+            'include_reposts' => [
+                'name' => 'Include Reposts?',
+                'type' => 'checkbox',
+                'defaultValue' => 'checked'
+            ],
+
+            'include_reply_context' => [
+                'name' => 'Include Reply context?',
+                'type' => 'checkbox'
+            ],
+
+            'verbose_title' => [
+                'name' => 'Use verbose feed item titles?',
+                'type' => 'checkbox'
             ]
         ]
     ];
@@ -44,7 +61,11 @@ class BlueskyBridge extends BridgeAbstract
     public function getName()
     {
         if (isset($this->profile)) {
-            return sprintf('%s (@%s) - Bluesky', $this->profile['displayName'], $this->profile['handle']);
+            if ($this->profile['handle'] === 'handle.invalid') {
+                return sprintf('Bluesky - %s', $this->profile['displayName']);
+            } else {
+                return sprintf('Bluesky - %s (@%s)', $this->profile['displayName'], $this->profile['handle']);
+            }
         }
         return parent::getName();
     }
@@ -52,7 +73,11 @@ class BlueskyBridge extends BridgeAbstract
     public function getURI()
     {
         if (isset($this->profile)) {
-            return self::URI . '/profile/' . $this->profile['handle'];
+            if ($this->profile['handle'] === 'handle.invalid') {
+                return self::URI . '/profile/' . $this->profile['did'];
+            } else {
+                return self::URI . '/profile/' . $this->profile['handle'];
+            }
         }
         return parent::getURI();
     }
@@ -77,118 +102,365 @@ class BlueskyBridge extends BridgeAbstract
     {
         $description = '';
         $externalUri = $external['uri'];
-        $externalTitle = htmlspecialchars($external['title'], ENT_QUOTES, 'UTF-8');
-        $externalDescription = htmlspecialchars($external['description'], ENT_QUOTES, 'UTF-8');
+        $externalTitle = e($external['title']);
+        $externalDescription = e($external['description']);
         $thumb = $external['thumb'] ?? null;
 
-        if (preg_match('/youtube\.com\/watch\?v=([^\&\?\/]+)/', $externalUri, $id) || preg_match('/youtu\.be\/([^\&\?\/]+)/', $externalUri, $id)) {
-            $videoId = $id[1];
-            $description .= "<p>External Link: <a href=\"$externalUri\">$externalTitle</a></p>";
-            $description .= "<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/$videoId\" frameborder=\"0\" allowfullscreen></iframe>";
+        if (preg_match('/http(|s):\/\/media\.tenor\.com/', $externalUri)) {
+            //tenor gif embed
+            $tenorInterstitial = str_replace('media.tenor.com', 'media1.tenor.com/m', $externalUri);
+            $description .= "<figure><a href=\"$tenorInterstitial\"><img src=\"$externalUri\"/></a><figcaption>$externalTitle</figcaption></figure>";
         } else {
-            $description .= "<p>External Link: <a href=\"$externalUri\">$externalTitle</a></p>";
-            $description .= "<p>$externalDescription</p>";
-
-            if ($thumb) {
-                $thumbUrl = 'https://cdn.bsky.app/img/feed_thumbnail/plain/' . $did . '/' . $thumb['ref']['$link'] . '@jpeg';
-                $description .= "<p><a href=\"$externalUri\"><img src=\"$thumbUrl\" alt=\"External Thumbnail\" /></a></p>";
-            }
+            //link embed preview
+            $host = parse_url($externalUri)['host'];
+            $thumbDesc = $thumb ? ('<img src="https://cdn.bsky.app/img/feed_thumbnail/plain/' . $did . '/' . $thumb['ref']['$link'] . '@jpeg"/>') : '';
+            $externalDescription = strlen($externalDescription) > 0 ? "<figcaption>($host) $externalDescription</figcaption>" : '';
+            $description .= '<br><blockquote><b><a href="' . $externalUri . '">' . $externalTitle . '</a></b>';
+            $description .= '<figure>' . $thumbDesc . $externalDescription . '</figure></blockquote>';
         }
         return $description;
     }
 
-    private function textToDescription($text)
+    private function textToDescription($record)
     {
-        $text = nl2br(htmlspecialchars($text, ENT_QUOTES, 'UTF-8'));
-        $text = preg_replace('/(https?:\/\/[^\s]+)/i', '<a href="$1">$1</a>', $text);
-
+        if (isset($record['value'])) {
+            $record = $record['value'];
+        }
+        $text = $record['text'];
+        $text_copy = $text;
+        $text = nl2br(e($text));
+        if (isset($record['facets'])) {
+            $facets = $record['facets'];
+            foreach ($facets as $facet) {
+                if ($facet['features'][0]['$type'] === 'app.bsky.richtext.facet#link') {
+                    $substring = substr($text_copy, $facet['index']['byteStart'], $facet['index']['byteEnd'] - $facet['index']['byteStart']);
+                    $text = str_replace($substring, '<a href="' . $facet['features'][0]['uri'] . '">' . $substring . '</a>', $text);
+                }
+            }
+        }
         return $text;
     }
 
     public function collectData()
     {
-        $handle = $this->getInput('handle');
-        $filter = $this->getInput('filter') ?: 'posts_and_author_threads';
+        $user_id = $this->getInput('user_id');
+        $handle_match = preg_match('/(?:[a-zA-Z]*\.)+([a-zA-Z](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)/', $user_id, $handle_res); //gets the TLD in $handle_match[1]
+        $did_match = preg_match('/did:plc:[a-z2-7]{24}/', $user_id); //https://github.com/did-method-plc/did-method-plc#identifier-syntax
+        $exclude = ['alt', 'arpa', 'example', 'internal', 'invalid', 'local', 'localhost', 'onion']; //https://en.wikipedia.org/wiki/Top-level_domain#Reserved_domains
+        if ($handle_match == true && array_search($handle_res[1], $exclude) == false) {
+            //valid bsky handle
+            $did = $this->resolveHandle($user_id);
+        } elseif ($did_match == true) {
+            //valid DID
+            $did = $user_id;
+        } else {
+            returnClientError('Invalid ATproto handle or DID provided.');
+        }
+
+        $filter = $this->getInput('feed_filter') ?: 'posts_and_author_threads';
+        $replyContext = $this->getInput('include_reply_context');
 
-        $did = $this->resolveHandle($handle);
         $this->profile = $this->getProfile($did);
         $authorFeed = $this->getAuthorFeed($did, $filter);
 
         foreach ($authorFeed['feed'] as $post) {
+            $postRecord = $post['post']['record'];
+
             $item = [];
-            $item['uri'] = self::URI . '/profile/' . $post['post']['author']['handle'] . '/post/' . explode('app.bsky.feed.post/', $post['post']['uri'])[1];
-            $item['title'] = strtok($post['post']['record']['text'], "\n");
-            $item['timestamp'] = strtotime($post['post']['record']['createdAt']);
-            $item['author'] = $this->profile['displayName'];
+            $item['uri'] = self::URI . '/profile/' . $this->fallbackAuthor($post['post']['author'], 'url') . '/post/' . explode('app.bsky.feed.post/', $post['post']['uri'])[1];
+            $item['title'] = $this->getInput('verbose_title') ? $this->generateVerboseTitle($post) : strtok($postRecord['text'], "\n");
+            $item['timestamp'] = strtotime($postRecord['createdAt']);
+            $item['author'] = $this->fallbackAuthor($post['post']['author'], 'display');
 
-            $description = $this->textToDescription($post['post']['record']['text']);
+            $postAuthorDID = $post['post']['author']['did'];
+            $postAuthorHandle = $post['post']['author']['handle'] !== 'handle.invalid' ? '<i>@' . $post['post']['author']['handle'] . '</i> ' : '';
+            $postDisplayName = $post['post']['author']['displayName'] ?? '';
+            $postDisplayName = e($postDisplayName);
+            $postUri = $item['uri'];
 
-            // Retrieve DID for constructing image URLs
-            $authorDid = $post['post']['author']['did'];
-
-            if (isset($post['post']['record']['embed']['$type']) && $post['post']['record']['embed']['$type'] === 'app.bsky.embed.external') {
-                $description .= $this->parseExternal($post['post']['record']['embed']['external'], $authorDid);
+            if (Debug::isEnabled()) {
+                $url = explode('/', $post['post']['uri']);
+                error_log('https://bsky.app/profile/' . $url[2] . '/post/' . $url[4]);
             }
 
-            if (isset($post['post']['record']['embed']['$type']) && $post['post']['record']['embed']['$type'] === 'app.bsky.embed.video') {
-                $thumbnail = $post['post']['embed']['thumbnail'] ?? null;
-                if ($thumbnail) {
-                                    $itemUri = self::URI . '/profile/' . $post['post']['author']['handle'] . '/post/' . explode('app.bsky.feed.post/', $post['post']['uri'])[1];
-                    $description .= "<p><a href=\"$itemUri\"><img src=\"$thumbnail\" alt=\"Video Thumbnail\" /></a></p>";
+            $description = '';
+            $description .= '<p>';
+            //post
+            $description .= $this->getPostDescription(
+                $postDisplayName,
+                $postAuthorHandle,
+                $postUri,
+                $postRecord,
+                'post'
+            );
+
+            if (isset($postRecord['embed']['$type'])) {
+                //post link embed
+                if ($postRecord['embed']['$type'] === 'app.bsky.embed.external') {
+                    $description .= $this->parseExternal($postRecord['embed']['external'], $postAuthorDID);
+                } elseif (
+                    $postRecord['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
+                    $postRecord['embed']['media']['$type'] === 'app.bsky.embed.external'
+                ) {
+                    $description .= $this->parseExternal($postRecord['embed']['media']['external'], $postAuthorDID);
+                }
+
+                //post images
+                if (
+                    $postRecord['embed']['$type'] === 'app.bsky.embed.images' ||
+                    (
+                        $postRecord['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
+                        $postRecord['embed']['media']['$type'] === 'app.bsky.embed.images'
+                    )
+                ) {
+                    $images = $post['post']['embed']['images'] ?? $post['post']['embed']['media']['images'];
+                    foreach ($images as $image) {
+                        $description .= $this->getPostImageDescription($image);
+                    }
+                }
+
+                //post video
+                if (
+                    $postRecord['embed']['$type'] === 'app.bsky.embed.video' ||
+                    (
+                        $postRecord['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
+                        $postRecord['embed']['media']['$type'] === 'app.bsky.embed.video'
+                    )
+                ) {
+                    $description .= $this->getPostVideoDescription(
+                        $postRecord['embed']['video'] ?? $postRecord['embed']['media']['video'],
+                        $postAuthorDID
+                    );
                 }
             }
+            $description .= '</p>';
 
-            if (isset($post['post']['record']['embed']['$type']) && $post['post']['record']['embed']['$type'] === 'app.bsky.embed.recordWithMedia#view') {
-                $thumbnail = $post['post']['embed']['media']['thumbnail'] ?? null;
-                $playlist = $post['post']['embed']['media']['playlist'] ?? null;
-                if ($thumbnail) {
-                    $description .= "<p><video controls poster=\"$thumbnail\">";
-                    $description .= "<source src=\"$playlist\" type=\"application/x-mpegURL\">";
-                    $description .= 'Video source not supported</video></p>';
-                }
-            }
+            //quote post
+            if (
+                isset($postRecord['embed']) &&
+                (
+                    $postRecord['embed']['$type'] === 'app.bsky.embed.record' ||
+                    $postRecord['embed']['$type'] === 'app.bsky.embed.recordWithMedia'
+                ) &&
+                isset($post['post']['embed']['record'])
+            ) {
+                $description .= '<p>';
+                $quotedRecord = $post['post']['embed']['record']['record'] ?? $post['post']['embed']['record'];
 
-            if (!empty($post['post']['record']['embed']['images'])) {
-                foreach ($post['post']['record']['embed']['images'] as $image) {
-                    $linkRef = $image['image']['ref']['$link'];
-                    $thumbnailUrl = $this->resolveThumbnailUrl($authorDid, $linkRef);
-                    $fullsizeUrl = $this->resolveFullsizeUrl($authorDid, $linkRef);
-                    $description .= "<br /><br /><a href=\"$fullsizeUrl\"><img src=\"$thumbnailUrl\" alt=\"Image\"></a>";
-                }
-            }
+                if (isset($quotedRecord['notFound']) && $quotedRecord['notFound']) { //deleted post
+                    $description .= 'Quoted post deleted.';
+                } elseif (isset($quotedRecord['detached']) && $quotedRecord['detached']) { //detached quote
+                    $uri_explode = explode('/', $quotedRecord['uri']);
+                    $uri_reconstructed = self::URI . '/profile/' . $uri_explode[2] . '/post/' . $uri_explode[4];
+                    $description .= '<a href="' . $uri_reconstructed . '">Quoted post detached.</a>';
+                } elseif (isset($quotedRecord['blocked']) && $quotedRecord['blocked']) { //blocked by quote author
+                    $description .= 'Author of quoted post has blocked OP.';
+                } else {
+                    $quotedAuthorDid = $quotedRecord['author']['did'];
+                    $quotedDisplayName = $quotedRecord['author']['displayName'] ?? '';
+                    $quotedDisplayName = e($quotedDisplayName);
+                    $quotedAuthorHandle = $quotedRecord['author']['handle'] !== 'handle.invalid' ? '<i>@' . $quotedRecord['author']['handle'] . '</i>' : '';
 
-            // Enhanced handling for quote posts with images
-            if (isset($post['post']['record']['embed']) && $post['post']['record']['embed']['$type'] === 'app.bsky.embed.record') {
-                $quotedRecord = $post['post']['record']['embed']['record'];
-                $quotedAuthor = $post['post']['embed']['record']['author']['handle'] ?? null;
-                $quotedDisplayName = $post['post']['embed']['record']['author']['displayName'] ?? null;
-                $quotedText = $post['post']['embed']['record']['value']['text'] ?? null;
-
-                if ($quotedAuthor && isset($quotedRecord['uri'])) {
                     $parts = explode('/', $quotedRecord['uri']);
                     $quotedPostId = end($parts);
-                    $quotedPostUri = self::URI . '/profile/' . $quotedAuthor . '/post/' . $quotedPostId;
-                }
+                    $quotedPostUri = self::URI . '/profile/' . $this->fallbackAuthor($quotedRecord['author'], 'url') . '/post/' . $quotedPostId;
 
-                if ($quotedText) {
-                    $description .= '<hr /><strong>Quote from ' . htmlspecialchars($quotedDisplayName) . ' (@ ' . htmlspecialchars($quotedAuthor) . '):</strong><br />';
-                    $description .= $this->textToDescription($quotedText);
-                    if (isset($quotedPostUri)) {
-                        $description .= "<p><a href=\"$quotedPostUri\">View original quote post</a></p>";
+                    //quoted post - post
+                    $description .= $this->getPostDescription(
+                        $quotedDisplayName,
+                        $quotedAuthorHandle,
+                        $quotedPostUri,
+                        $quotedRecord,
+                        'quote'
+                    );
+
+                    if (isset($quotedRecord['value']['embed']['$type'])) {
+                        //quoted post - post link embed
+                        if ($quotedRecord['value']['embed']['$type'] === 'app.bsky.embed.external') {
+                            $description .= $this->parseExternal($quotedRecord['value']['embed']['external'], $quotedAuthorDid);
+                        }
+
+                        //quoted post - post video
+                        if (
+                            $quotedRecord['value']['embed']['$type'] === 'app.bsky.embed.video' ||
+                            (
+                                $quotedRecord['value']['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
+                                $quotedRecord['value']['embed']['media']['$type'] === 'app.bsky.embed.video'
+                            )
+                        ) {
+                            $description .= $this->getPostVideoDescription(
+                                $quotedRecord['value']['embed']['video'] ?? $quotedRecord['value']['embed']['media']['video'],
+                                $quotedAuthorDid
+                            );
+                        }
+
+                        //quoted post - post images
+                        if (
+                            $quotedRecord['value']['embed']['$type'] === 'app.bsky.embed.images' ||
+                            (
+                                $quotedRecord['value']['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
+                                $quotedRecord['value']['embed']['media']['$type'] === 'app.bsky.embed.images'
+                            )
+                        ) {
+                            foreach ($quotedRecord['embeds'] as $embed) {
+                                if (
+                                    $embed['$type'] === 'app.bsky.embed.images#view' ||
+                                    ($embed['$type'] === 'app.bsky.embed.recordWithMedia#view' && $embed['media']['$type'] === 'app.bsky.embed.images#view')
+                                ) {
+                                    $images = $embed['images'] ?? $embed['media']['images'];
+                                    foreach ($images as $image) {
+                                        $description .= $this->getPostImageDescription($image);
+                                    }
+                                }
+                            }
+                        }
                     }
                 }
+                $description .= '</p>';
             }
 
-            if (isset($post['post']['embed']['record']['value']['embed']['images'])) {
-                $quotedImages = $post['post']['embed']['record']['value']['embed']['images'];
-                foreach ($quotedImages as $image) {
-                    $linkRef = $image['image']['ref']['$link'] ?? null;
-                    if ($linkRef) {
-                        $quotedAuthorDid = $post['post']['embed']['record']['author']['did'] ?? null;
-                        $thumbnailUrl = $this->resolveThumbnailUrl($quotedAuthorDid, $linkRef);
-                        $fullsizeUrl = $this->resolveFullsizeUrl($quotedAuthorDid, $linkRef);
-                        $description .= "<br /><br /><a href=\"$fullsizeUrl\"><img src=\"$thumbnailUrl\" alt=\"Quoted Image\"></a>";
+            //reply
+            if ($replyContext && isset($post['reply']) && !isset($post['reply']['parent']['notFound'])) {
+                $replyPost = $post['reply']['parent'];
+                $replyPostRecord = $replyPost['record'];
+                $description .= '<hr/>';
+                $description .= '<p>';
+
+                $replyPostAuthorDID = $replyPost['author']['did'];
+                $replyPostAuthorHandle = $replyPost['author']['handle'] !== 'handle.invalid' ? '<i>@' . $replyPost['author']['handle'] . '</i> ' : '';
+                $replyPostDisplayName = $replyPost['author']['displayName'] ?? '';
+                $replyPostDisplayName = e($replyPostDisplayName);
+                $replyPostUri = self::URI . '/profile/' . $this->fallbackAuthor($replyPost['author'], 'url') . '/post/' . explode('app.bsky.feed.post/', $replyPost['uri'])[1];
+
+                // reply post
+                $description .= $this->getPostDescription(
+                    $replyPostDisplayName,
+                    $replyPostAuthorHandle,
+                    $replyPostUri,
+                    $replyPostRecord,
+                    'reply'
+                );
+
+                if (isset($replyPostRecord['embed']['$type'])) {
+                    //post link embed
+                    if ($replyPostRecord['embed']['$type'] === 'app.bsky.embed.external') {
+                        $description .= $this->parseExternal($replyPostRecord['embed']['external'], $replyPostAuthorDID);
+                    } elseif (
+                        $replyPostRecord['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
+                        $replyPostRecord['embed']['media']['$type'] === 'app.bsky.embed.external'
+                    ) {
+                        $description .= $this->parseExternal($replyPostRecord['embed']['media']['external'], $replyPostAuthorDID);
                     }
+
+                    //post images
+                    if (
+                        $replyPostRecord['embed']['$type'] === 'app.bsky.embed.images' ||
+                        (
+                            $replyPostRecord['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
+                            $replyPostRecord['embed']['media']['$type'] === 'app.bsky.embed.images'
+                        )
+                    ) {
+                        $images = $replyPost['embed']['images'] ?? $replyPost['embed']['media']['images'];
+                        foreach ($images as $image) {
+                            $description .= $this->getPostImageDescription($image);
+                        }
+                    }
+
+                    //post video
+                    if (
+                        $replyPostRecord['embed']['$type'] === 'app.bsky.embed.video' ||
+                        (
+                            $replyPostRecord['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
+                            $replyPostRecord['embed']['media']['$type'] === 'app.bsky.embed.video'
+                        )
+                    ) {
+                        $description .= $this->getPostVideoDescription(
+                            $replyPostRecord['embed']['video'] ?? $replyPostRecord['embed']['media']['video'],
+                            $replyPostAuthorDID
+                        );
+                    }
+                }
+                $description .= '</p>';
+
+                //quote post
+                if (
+                    isset($replyPostRecord['embed']) &&
+                    ($replyPostRecord['embed']['$type'] === 'app.bsky.embed.record' || $replyPostRecord['embed']['$type'] === 'app.bsky.embed.recordWithMedia') &&
+                    isset($replyPost['embed']['record'])
+                ) {
+                    $description .= '<p>';
+                    $replyQuotedRecord = $replyPost['embed']['record']['record'] ?? $replyPost['embed']['record'];
+
+                    if (isset($replyQuotedRecord['notFound']) && $replyQuotedRecord['notFound']) { //deleted post
+                        $description .= 'Quoted post deleted.';
+                    } elseif (isset($replyQuotedRecord['detached']) && $replyQuotedRecord['detached']) { //detached quote
+                        $uri_explode = explode('/', $replyQuotedRecord['uri']);
+                        $uri_reconstructed = self::URI . '/profile/' . $uri_explode[2] . '/post/' . $uri_explode[4];
+                        $description .= '<a href="' . $uri_reconstructed . '">Quoted post detached.</a>';
+                    } elseif (isset($replyQuotedRecord['blocked']) && $replyQuotedRecord['blocked']) { //blocked by quote author
+                        $description .= 'Author of quoted post has blocked OP.';
+                    } else {
+                        $quotedAuthorDid = $replyQuotedRecord['author']['did'];
+                        $quotedDisplayName = $replyQuotedRecord['author']['displayName'] ?? '';
+                        $quotedDisplayName = e($quotedDisplayName);
+                        $quotedAuthorHandle = $replyQuotedRecord['author']['handle'] !== 'handle.invalid' ? '<i>@' . $replyQuotedRecord['author']['handle'] . '</i>' : '';
+
+                        $parts = explode('/', $replyQuotedRecord['uri']);
+                        $quotedPostId = end($parts);
+                        $quotedPostUri = self::URI . '/profile/' . $this->fallbackAuthor($replyQuotedRecord['author'], 'url') . '/post/' . $quotedPostId;
+
+                        //quoted post - post
+                        $description .= $this->getPostDescription(
+                            $quotedDisplayName,
+                            $quotedAuthorHandle,
+                            $quotedPostUri,
+                            $replyQuotedRecord,
+                            'quote'
+                        );
+
+                        if (isset($replyQuotedRecord['value']['embed']['$type'])) {
+                            //quoted post - post link embed
+                            if ($replyQuotedRecord['value']['embed']['$type'] === 'app.bsky.embed.external') {
+                                $description .= $this->parseExternal($replyQuotedRecord['value']['embed']['external'], $quotedAuthorDid);
+                            }
+
+                            //quoted post - post video
+                            if (
+                                $replyQuotedRecord['value']['embed']['$type'] === 'app.bsky.embed.video' ||
+                                (
+                                    $replyQuotedRecord['value']['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
+                                    $replyQuotedRecord['value']['embed']['media']['$type'] === 'app.bsky.embed.video'
+                                )
+                            ) {
+                                $description .= $this->getPostVideoDescription(
+                                    $replyQuotedRecord['value']['embed']['video'] ?? $replyQuotedRecord['value']['embed']['media']['video'],
+                                    $quotedAuthorDid
+                                );
+                            }
+
+                            //quoted post - post images
+                            if (
+                                $replyQuotedRecord['value']['embed']['$type'] === 'app.bsky.embed.images' ||
+                                (
+                                    $replyQuotedRecord['value']['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
+                                    $replyQuotedRecord['value']['embed']['media']['$type'] === 'app.bsky.embed.images'
+                                )
+                            ) {
+                                foreach ($replyQuotedRecord['embeds'] as $embed) {
+                                    if (
+                                        $embed['$type'] === 'app.bsky.embed.images#view' ||
+                                        ($embed['$type'] === 'app.bsky.embed.recordWithMedia#view' && $embed['media']['$type'] === 'app.bsky.embed.images#view')
+                                    ) {
+                                        $images = $embed['images'] ?? $embed['media']['images'];
+                                        foreach ($images as $image) {
+                                            $description .= $this->getPostImageDescription($image);
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    }
+                    $description .= '</p>';
                 }
             }
 
@@ -197,6 +469,98 @@ class BlueskyBridge extends BridgeAbstract
         }
     }
 
+    private function getPostVideoDescription(array $video, $authorDID)
+    {
+        //https://video.bsky.app/watch/$did/$cid/thumbnail.jpg
+        $videoCID = $video['ref']['$link'];
+        $videoMime = $video['mimeType'];
+        $thumbnail = "poster=\"https://video.bsky.app/watch/$authorDID/$videoCID/thumbnail.jpg\"" ?? '';
+        $videoURL = "https://bsky.social/xrpc/com.atproto.sync.getBlob?did=$authorDID&cid=$videoCID";
+        return "<figure><video loop $thumbnail controls src=\"$videoURL\" type=\"$videoMime\"/></figure>";
+    }
+
+    private function getPostImageDescription(array $image)
+    {
+        $thumbnailUrl = $image['thumb'];
+        $fullsizeUrl = $image['fullsize'];
+        $alt = strlen($image['alt']) > 0 ? '<figcaption>' . e($image['alt']) . '</figcaption>' : '';
+        return "<figure><a href=\"$fullsizeUrl\"><img src=\"$thumbnailUrl\"></a>$alt</figure>";
+    }
+
+    private function getPostDescription(
+        string $postDisplayName,
+        string $postAuthorHandle,
+        string $postUri,
+        array $postRecord,
+        string $type
+    ) {
+        $description = '';
+        if ($type === 'quote') {
+            // Quoted post/reply from bbb @bbb.com:
+            $postType = isset($postRecord['reply']) ? 'reply' : 'post';
+            $description .= "<a href=\"$postUri\">Quoted $postType</a> from <b>$postDisplayName</b> $postAuthorHandle:<br>";
+        } elseif ($type === 'reply') {
+            // Replying to aaa @aaa.com's post/reply:
+            $postType = isset($postRecord['reply']) ? 'reply' : 'post';
+            $description .= "Replying to <b>$postDisplayName</b> $postAuthorHandle's <a href=\"$postUri\">$postType</a>:<br>";
+        } else {
+            // aaa @aaa.com posted:
+            $description .= "<b>$postDisplayName</b> $postAuthorHandle <a href=\"$postUri\">posted</a>:<br>";
+        }
+        $description .= $this->textToDescription($postRecord);
+        return $description;
+    }
+
+    //used if handle verification fails, fallsback to displayName or DID depending on context.
+    private function fallbackAuthor($author, $reason)
+    {
+        if ($author['handle'] === 'handle.invalid') {
+            switch ($reason) {
+                case 'url':
+                    return $author['did'];
+                case 'display':
+                    $displayName = $author['displayName'] ?? '';
+                    return e($displayName);
+            }
+        }
+        return $author['handle'];
+    }
+
+    private function generateVerboseTitle($post)
+    {
+        //use "Post by A, replying to B, quoting C" instead of post contents
+        $title = '';
+        if (isset($post['reason']) && str_contains($post['reason']['$type'], 'reasonRepost')) {
+            $title .= 'Repost by ' . $this->fallbackAuthor($post['reason']['by'], 'display') . ', post by ' . $this->fallbackAuthor($post['post']['author'], 'display');
+        } else {
+            $title .= 'Post by ' . $this->fallbackAuthor($post['post']['author'], 'display');
+        }
+
+        if (isset($post['reply'])) {
+            if (isset($post['reply']['parent']['blocked'])) {
+                $replyAuthor = 'blocked user';
+            } elseif (isset($post['reply']['parent']['notFound'])) {
+                $replyAuthor = 'deleted post';
+            } else {
+                $replyAuthor = $this->fallbackAuthor($post['reply']['parent']['author'], 'display');
+            }
+            $title .= ', replying to ' . $replyAuthor;
+        }
+        if (isset($post['post']['embed']) && isset($post['post']['embed']['record'])) {
+            if (isset($post['post']['embed']['record']['blocked'])) {
+                $quotedAuthor = 'blocked user';
+            } elseif (isset($post['post']['embed']['record']['notFound'])) {
+                $quotedAuthor = 'deleted post';
+            } elseif (isset($post['post']['embed']['record']['detached'])) {
+                $quotedAuthor = 'detached post';
+            } else {
+                $quotedAuthor = $this->fallbackAuthor($post['post']['embed']['record']['record']['author'] ?? $post['post']['embed']['record']['author'], 'display');
+            }
+            $title .= ', quoting ' . $quotedAuthor;
+        }
+        return $title;
+    }
+
     private function resolveHandle($handle)
     {
         $uri = 'https://public.api.bsky.app/xrpc/com.atproto.identity.resolveHandle?handle=' . urlencode($handle);
@@ -214,17 +578,10 @@ class BlueskyBridge extends BridgeAbstract
     private function getAuthorFeed($did, $filter)
     {
         $uri = 'https://public.api.bsky.app/xrpc/app.bsky.feed.getAuthorFeed?actor=' . urlencode($did) . '&filter=' . urlencode($filter) . '&limit=30';
+        if (Debug::isEnabled()) {
+            error_log($uri);
+        }
         $response = json_decode(getContents($uri), true);
         return $response;
     }
-
-    private function resolveThumbnailUrl($authorDid, $linkRef)
-    {
-        return 'https://cdn.bsky.app/img/feed_thumbnail/plain/' . $authorDid . '/' . $linkRef . '@jpeg';
-    }
-
-    private function resolveFullsizeUrl($authorDid, $linkRef)
-    {
-        return 'https://cdn.bsky.app/img/feed_fullsize/plain/' . $authorDid . '/' . $linkRef . '@jpeg';
-    }
 }

From 97eebfb562f80de0d6e1c665a2eb49b7841fb837 Mon Sep 17 00:00:00 2001
From: Niehztog <Niehztog@users.noreply.github.com>
Date: Thu, 2 Jan 2025 17:44:36 +0100
Subject: [PATCH 555/716] [BlizzardNewsBridge] fix BlizzardNewsBridge (#4379)

* fix BlizzardNewsBridge

* fix linter warnings

* fix linter warnings

* fix linter warnings
---
 bridges/BlizzardNewsBridge.php | 68 +++++++++++++++++++++++++++-------
 1 file changed, 54 insertions(+), 14 deletions(-)

diff --git a/bridges/BlizzardNewsBridge.php b/bridges/BlizzardNewsBridge.php
index 993492d4..4d82b318 100644
--- a/bridges/BlizzardNewsBridge.php
+++ b/bridges/BlizzardNewsBridge.php
@@ -1,6 +1,6 @@
 <?php
 
-class BlizzardNewsBridge extends XPathAbstract
+class BlizzardNewsBridge extends BridgeAbstract
 {
     const NAME = 'Blizzard News';
     const URI = 'https://news.blizzard.com';
@@ -35,33 +35,73 @@ class BlizzardNewsBridge extends XPathAbstract
     ];
     const CACHE_TIMEOUT = 3600;
 
-    const XPATH_EXPRESSION_ITEM = '/html/body/div/div[4]/div[2]/div[2]/div/div/section/ol/li/article';
-    const XPATH_EXPRESSION_ITEM_TITLE = './/div/div[2]/h2';
-    const XPATH_EXPRESSION_ITEM_CONTENT = './/div[@class="ArticleListItem-description"]/div[@class="h6"]/text()';
-    const XPATH_EXPRESSION_ITEM_URI = './/a[@class="ArticleLink ArticleLink"]/@href';
-    const XPATH_EXPRESSION_ITEM_AUTHOR = '';
-    const XPATH_EXPRESSION_ITEM_TIMESTAMP = './/time[@class="ArticleListItem-footerTimestamp"]/@timestamp';
-    const XPATH_EXPRESSION_ITEM_ENCLOSURES = './/div[@class="ArticleListItem-image"]/@style';
-    const XPATH_EXPRESSION_ITEM_CATEGORIES = './/div[@class="ArticleListItem-label"]';
-    const SETTING_FIX_ENCODING = true;
+    private const PRODUCT_IDS = [
+        'blt525c436e4a1b0a97',
+        'blt54fbd3787a705054',
+        'blt2031aef34200656d',
+        'blt795c314400d7ded9',
+        'blt5cfc6affa3ca0638',
+        'blt2e50e1521bb84dc6',
+        'blt376fb94931906b6f',
+        'blt81d46fcb05ab8811',
+        'bltede2389c0a8885aa',
+        'blt24859ba8086fb294',
+        'blte27d02816a8ff3e1',
+        'blt2caca37e42f19839',
+        'blt90855744d00cd378',
+        'bltec70ad0ea4fd6d1d',
+        'blt500c1f8b5470bfdb'
+    ];
+
+    private const API_PATH = '/api/news/blizzard?';
 
     /**
      * Source Web page URL (should provide either HTML or XML content)
      * @return string
      */
-    protected function getSourceUrl()
+    private function getSourceUrl(): string
     {
         $locale = $this->getInput('locale');
         if ('zh-cn' === $locale) {
-            return 'https://cn.news.blizzard.com';
+            $baseUrl = 'https://cn.news.blizzard.com' . self::API_PATH;
+        } else {
+            $baseUrl = 'https://news.blizzard.com/' . $locale . self::API_PATH;
         }
-        return 'https://news.blizzard.com/' . $locale;
+        return $baseUrl .= http_build_query([
+            'feedCxpProductIds' => self::PRODUCT_IDS
+        ]);
+    }
+
+    public function collectData()
+    {
+        $feedContent = json_decode(getContents($this->getSourceUrl()), true);
+
+        foreach ($feedContent['feed']['contentItems'] as $entry) {
+            $properties = $entry['properties'];
+
+            $item = [];
+
+            $item['title'] = $this->filterChars($properties['title']);
+            $item['content'] = $this->filterChars($properties['summary']);
+            $item['uri'] = $properties['newsUrl'];
+            $item['author'] = $this->filterChars($properties['author']);
+            $item['timestamp'] = strtotime($properties['lastUpdated']);
+            $item['enclosures'] = [$properties['staticAsset']['imageUrl']];
+            $item['categories'] = [$this->filterChars($properties['cxpProduct']['title'])];
+
+            $this->items[] = $item;
+        }
+    }
+
+    private function filterChars($content)
+    {
+        return htmlspecialchars($content, ENT_XML1);
     }
 
     public function getIcon()
     {
         return <<<icon
-https://blznews.akamaized.net/images/favicon-cb34a003c6f2f637ee8f4f7b406f3b9b120b918c04cabec7f03a760e708977ea9689a1c638f4396def8dce7b202cd007eae91946cc3c4a578aa8b5694226cfc6.ico
+https://dfbmfbnnydoln.cloudfront.net/production/images/favicons/favicon.ba01bb119359d74970b02902472fd82e96b5aba7.ico
 icon;
     }
 }

From e8252729871cd10f8826b5635da23aafd86b7d0c Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 2 Jan 2025 18:22:47 +0100
Subject: [PATCH 556/716] fix(rumble): exterminate double leading slashes in
 item url (#4381)

Fixed for items with pub date newer than 31. jan 2025
---
 bridges/RumbleBridge.php | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/bridges/RumbleBridge.php b/bridges/RumbleBridge.php
index 8d92db3b..11755b51 100644
--- a/bridges/RumbleBridge.php
+++ b/bridges/RumbleBridge.php
@@ -60,15 +60,10 @@ class RumbleBridge extends BridgeAbstract
 
         $dom = getSimpleHTMLDOM($url);
         foreach ($dom->find('ol.thumbnail__grid div.thumbnail__grid--item') as $video) {
-            $itemUrlString = self::URI . $video->find('a', 0)->href;
-            $itemUrl = Url::fromString($itemUrlString);
+            $href = $video->find('a', 0)->href;
 
             $item = [
                 'title'     => $video->find('h3', 0)->plaintext,
-
-                // Remove tracking parameter in query string
-                'uri'       => $itemUrl->withQueryString(null)->__toString(),
-
                 'author'    => $account . '@rumble.com',
                 'content'   => defaultLinkTo($video, self::URI)->innertext,
             ];
@@ -78,6 +73,14 @@ class RumbleBridge extends BridgeAbstract
                 $publishedAt = new \DateTimeImmutable($time->getAttribute('datetime'));
                 $item['timestamp'] = $publishedAt->getTimestamp();
             }
+
+            if (isset($publishedAt) && $publishedAt > new \DateTimeImmutable('2025-01-31')) {
+                $href = ltrim($href, '/');
+            }
+            $itemUrl = Url::fromString(self::URI . $href);
+            // Remove tracking parameter in query string
+            $item['uri'] = $itemUrl->withQueryString(null)->__toString();
+
             $this->items[] = $item;
         }
     }

From 45ee018a6e43ce444ed4ab8f13b62e886926f779 Mon Sep 17 00:00:00 2001
From: Sebastian Wolf <117176763+swofl@users.noreply.github.com>
Date: Fri, 3 Jan 2025 01:43:39 +0100
Subject: [PATCH 557/716] [MixologyBridge] add null checks for author and
 timestamp elements (#4383)

* [MixologyBridge] add null checks for author and timestamp elements

* [MixologyBridge] fix formatting
---
 bridges/MixologyBridge.php | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/bridges/MixologyBridge.php b/bridges/MixologyBridge.php
index e954d0d6..42192471 100644
--- a/bridges/MixologyBridge.php
+++ b/bridges/MixologyBridge.php
@@ -55,8 +55,15 @@ class MixologyBridge extends BridgeAbstract
     {
         $article = getSimpleHTMLDOMCached($item['uri']);
 
-        $item['author'] = $article->find('.beitrag-author a', 0)->plaintext;
-        $item['timestamp'] = strtotime($article->find('.beitrag-date time', 0)->datetime);
+        $authorLink = $article->find('.beitrag-author a', 0);
+        if (!empty($authorLink)) {
+            $item['author'] = $authorLink->plaintext;
+        }
+
+        $timeElement = $article->find('.beitrag-date time', 0);
+        if (!empty($timeElement)) {
+            $item['timestamp'] = strtotime($timeElement->datetime);
+        }
 
         $content = '';
 

From 7c6d4a932c7ce9678bdf3a5fcedf89a86d82ad44 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 3 Jan 2025 01:58:38 +0100
Subject: [PATCH 558/716] fix: upgrade hardcoded version number, fix #4382
 (#4384)

---
 lib/Configuration.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/Configuration.php b/lib/Configuration.php
index 187848fb..c0cfe0c2 100644
--- a/lib/Configuration.php
+++ b/lib/Configuration.php
@@ -7,7 +7,7 @@
  */
 final class Configuration
 {
-    private const VERSION = '2024-02-02';
+    private const VERSION = '2025-01-02';
 
     private static $config = [];
 

From c44a76ff17833709d9bb336778fdcfd159f620b4 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 3 Jan 2025 05:04:49 +0100
Subject: [PATCH 559/716] refactor: remove dead code (#4385)

---
 bridges/AirBreizhBridge.php                   |  3 +--
 bridges/AmazonPriceTrackerBridge.php          |  2 +-
 bridges/AssociatedPressNewsBridge.php         |  3 +--
 bridges/BAEBridge.php                         |  2 +-
 bridges/BandcampDailyBridge.php               |  6 ++---
 bridges/BundestagParteispendenBridge.php      |  6 ++---
 bridges/CrewbayBridge.php                     |  2 +-
 bridges/DacksnackBridge.php                   |  6 ++---
 bridges/DagensNyheterDirektBridge.php         |  3 +--
 bridges/FindACrewBridge.php                   |  2 +-
 bridges/FurAffinityUserBridge.php             |  3 +--
 bridges/GiteaBridge.php                       |  9 +++----
 bridges/GlowficBridge.php                     |  2 +-
 bridges/GogsBridge.php                        |  3 +--
 bridges/GoogleScholarBridge.php               |  4 ++--
 bridges/ItakuBridge.php                       | 24 +++++++------------
 bridges/JohannesBlickBridge.php               |  3 +--
 bridges/JustETFBridge.php                     |  3 +--
 bridges/KernelBugTrackerBridge.php            |  4 ----
 bridges/LaTeX3ProjectNewslettersBridge.php    |  2 +-
 bridges/MozillaBugTrackerBridge.php           |  4 ----
 bridges/OMonlineBridge.php                    |  6 ++---
 .../SchweinfurtBuergerinformationenBridge.php |  6 ++---
 bridges/SkimfeedBridge.php                    | 12 ++++------
 bridges/StanfordSIRbookreviewBridge.php       |  3 +--
 bridges/StockFilingsBridge.php                |  2 +-
 bridges/StorytelBridge.php                    |  3 ---
 bridges/TapasBridge.php                       |  2 +-
 bridges/TestFaktaBridge.php                   |  6 ++---
 bridges/UsesTechBridge.php                    |  3 +--
 bridges/VproTegenlichtBridge.php              |  3 +--
 bridges/WikipediaBridge.php                   |  4 ----
 bridges/XenForoBridge.php                     | 12 ++++------
 33 files changed, 52 insertions(+), 106 deletions(-)

diff --git a/bridges/AirBreizhBridge.php b/bridges/AirBreizhBridge.php
index a822625f..272c74ee 100644
--- a/bridges/AirBreizhBridge.php
+++ b/bridges/AirBreizhBridge.php
@@ -32,8 +32,7 @@ class AirBreizhBridge extends BridgeAbstract
     public function collectData()
     {
         $html = '';
-        $html = getSimpleHTMLDOM(static::URI . 'publications/?fwp_publications_thematiques=' . $this->getInput('theme'))
-            or returnClientError('No results for this query.');
+        $html = getSimpleHTMLDOM(static::URI . 'publications/?fwp_publications_thematiques=' . $this->getInput('theme'));
 
         foreach ($html->find('article') as $article) {
             $item = [];
diff --git a/bridges/AmazonPriceTrackerBridge.php b/bridges/AmazonPriceTrackerBridge.php
index b07bdb7c..5f93eb49 100644
--- a/bridges/AmazonPriceTrackerBridge.php
+++ b/bridges/AmazonPriceTrackerBridge.php
@@ -146,7 +146,7 @@ EOT;
     {
         $uri = $this->getURI();
 
-        return getSimpleHTMLDOM($uri) ?: returnServerError('Could not request Amazon.');
+        return getSimpleHTMLDOM($uri);
     }
 
     private function scrapePriceFromMetrics($html)
diff --git a/bridges/AssociatedPressNewsBridge.php b/bridges/AssociatedPressNewsBridge.php
index 0f8846eb..db62c826 100644
--- a/bridges/AssociatedPressNewsBridge.php
+++ b/bridges/AssociatedPressNewsBridge.php
@@ -105,8 +105,7 @@ class AssociatedPressNewsBridge extends BridgeAbstract
 
     private function collectCardData()
     {
-        $json = getContents($this->getTagURI())
-            or returnServerError('Could not request: ' . $this->getTagURI());
+        $json = getContents($this->getTagURI());
 
         $tagContents = json_decode($json, true);
 
diff --git a/bridges/BAEBridge.php b/bridges/BAEBridge.php
index 6807d548..a0e4c536 100644
--- a/bridges/BAEBridge.php
+++ b/bridges/BAEBridge.php
@@ -29,7 +29,7 @@ class BAEBridge extends BridgeAbstract
     public function collectData()
     {
         $url = $this->getURI();
-        $html = getSimpleHTMLDOM($url) or returnClientError('No results for this query.');
+        $html = getSimpleHTMLDOM($url);
 
         $annonces = $html->find('main article');
         foreach ($annonces as $annonce) {
diff --git a/bridges/BandcampDailyBridge.php b/bridges/BandcampDailyBridge.php
index 57299a17..1f9a031d 100644
--- a/bridges/BandcampDailyBridge.php
+++ b/bridges/BandcampDailyBridge.php
@@ -93,8 +93,7 @@ class BandcampDailyBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $html = getSimpleHTMLDOM($this->getURI())
-            or returnServerError('Could not request: ' . $this->getURI());
+        $html = getSimpleHTMLDOM($this->getURI());
 
         $html = defaultLinkTo($html, self::URI);
 
@@ -105,8 +104,7 @@ class BandcampDailyBridge extends BridgeAbstract
 
             $articlePath = $article->find('a.title', 0)->href;
 
-            $articlePageHtml = getSimpleHTMLDOMCached($articlePath, 3600)
-                or returnServerError('Could not request: ' . $articlePath);
+            $articlePageHtml = getSimpleHTMLDOMCached($articlePath, 3600);
 
             $item['uri'] = $articlePath;
             $item['title'] = $articlePageHtml->find('article-title', 0)->innertext;
diff --git a/bridges/BundestagParteispendenBridge.php b/bridges/BundestagParteispendenBridge.php
index cdf398e8..30817d96 100644
--- a/bridges/BundestagParteispendenBridge.php
+++ b/bridges/BundestagParteispendenBridge.php
@@ -26,8 +26,7 @@ TMPL;
 https://www.bundestag.de/ajax/filterlist/de/parlament/praesidium/parteienfinanzierung/fundstellen50000/462002-462002
 URI;
         // Get the main page
-        $html = getSimpleHTMLDOMCached($ajaxUri, self::CACHE_TIMEOUT)
-            or returnServerError('Could not request AJAX list.');
+        $html = getSimpleHTMLDOMCached($ajaxUri, self::CACHE_TIMEOUT);
 
         // Build the URL from the first anchor element. The list is sorted by year, descending, so the first element is the current year.
         $firstAnchor = $html->find('a', 0)
@@ -36,8 +35,7 @@ URI;
         $url = 'https://www.bundestag.de' . $firstAnchor->href;
 
         // Get the actual page with the soft money donations
-        $html = getSimpleHTMLDOMCached($url, self::CACHE_TIMEOUT)
-            or returnServerError('Could not request ' . $url);
+        $html = getSimpleHTMLDOMCached($url, self::CACHE_TIMEOUT);
 
         $rows = $html->find('table.table > tbody > tr')
             or returnServerError('Could not find the proper HTML elements.');
diff --git a/bridges/CrewbayBridge.php b/bridges/CrewbayBridge.php
index 0ca017c2..0fb9def6 100644
--- a/bridges/CrewbayBridge.php
+++ b/bridges/CrewbayBridge.php
@@ -109,7 +109,7 @@ class CrewbayBridge extends BridgeAbstract
     public function collectData()
     {
         $url = $this->getURI();
-        $html = getSimpleHTMLDOM($url) or returnClientError('No results for this query.');
+        $html = getSimpleHTMLDOM($url);
 
         $annonces = $html->find('#SearchResults div.result');
         $limit = 0;
diff --git a/bridges/DacksnackBridge.php b/bridges/DacksnackBridge.php
index 7aab48d1..a031706e 100644
--- a/bridges/DacksnackBridge.php
+++ b/bridges/DacksnackBridge.php
@@ -53,8 +53,7 @@ class DacksnackBridge extends BridgeAbstract
     public function collectData()
     {
         $NEWSURL = self::URI;
-        $html = getSimpleHTMLDOMCached($NEWSURL, 18000) or
-            returnServerError('Could not request: ' . $NEWSURL);
+        $html = getSimpleHTMLDOMCached($NEWSURL, 18000);
 
         foreach ($html->find('a.main-news-item') as $element) {
             // Debug::log($element);
@@ -64,8 +63,7 @@ class DacksnackBridge extends BridgeAbstract
             $url = self::URI . $element->getAttribute('href');
             $published = $this->parseSwedishDates(trim($element->find('.published', 0)->plaintext));
 
-            $article_html = getSimpleHTMLDOMCached($url, 18000) or
-                returnServerError('Could not request: ' . $url);
+            $article_html = getSimpleHTMLDOMCached($url, 18000);
             $article_content = $article_html->find('#ctl00_ContentPlaceHolder1_NewsArticleVeiw_pnlArticle', 0);
 
             $figure = self::URI . $article_content->find('img.news-image', 0)->getAttribute('src');
diff --git a/bridges/DagensNyheterDirektBridge.php b/bridges/DagensNyheterDirektBridge.php
index f0748b76..fa219a09 100644
--- a/bridges/DagensNyheterDirektBridge.php
+++ b/bridges/DagensNyheterDirektBridge.php
@@ -18,8 +18,7 @@ class DagensNyheterDirektBridge extends BridgeAbstract
     {
         $NEWSURL = self::BASEURL . '/ajax/direkt/';
 
-        $html = getSimpleHTMLDOM($NEWSURL) or
-            returnServerError('Could not request: ' . $NEWSURL);
+        $html = getSimpleHTMLDOM($NEWSURL);
 
         foreach ($html->find('article') as $element) {
             $link = $element->find('button', 0)->getAttribute('data-link');
diff --git a/bridges/FindACrewBridge.php b/bridges/FindACrewBridge.php
index 9119535b..0bc181f3 100644
--- a/bridges/FindACrewBridge.php
+++ b/bridges/FindACrewBridge.php
@@ -60,7 +60,7 @@ class FindACrewBridge extends BridgeAbstract
             CURLOPT_POSTFIELDS => http_build_query($data) . "\n"
         ];
 
-        $html = getSimpleHTMLDOM($url, $header, $opts) or returnClientError('No results for this query.');
+        $html = getSimpleHTMLDOM($url, $header, $opts);
 
         $annonces = $html->find('.css_SrhRst');
         $limit = $this->getInput('limit') ?? 10;
diff --git a/bridges/FurAffinityUserBridge.php b/bridges/FurAffinityUserBridge.php
index fa10d7ae..1866308d 100644
--- a/bridges/FurAffinityUserBridge.php
+++ b/bridges/FurAffinityUserBridge.php
@@ -34,8 +34,7 @@ class FurAffinityUserBridge extends BridgeAbstract
 
         $url = self::URI . '/gallery/' . $this->getInput('searchUsername');
 
-        $html = getSimpleHTMLDOM($url, [], $opt)
-            or returnServerError('Could not load the user\'s gallery page.');
+        $html = getSimpleHTMLDOM($url, [], $opt);
 
         $submissions = $html->find('section[id=gallery-gallery]', 0)->find('figure');
         foreach ($submissions as $submission) {
diff --git a/bridges/GiteaBridge.php b/bridges/GiteaBridge.php
index f7f426e9..8433b6dd 100644
--- a/bridges/GiteaBridge.php
+++ b/bridges/GiteaBridge.php
@@ -155,8 +155,7 @@ class GiteaBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $html = getSimpleHTMLDOM($this->getURI())
-            or returnServerError('Could not request ' . $this->getURI());
+        $html = getSimpleHTMLDOM($this->getURI());
         $html = defaultLinkTo($html, $this->getURI());
 
         $this->title = $html->find('[property="og:title"]', 0)->content;
@@ -246,8 +245,7 @@ class GiteaBridge extends BridgeAbstract
             ];
 
             if ($this->getInput('include_description')) {
-                $issue_html = getSimpleHTMLDOMCached($uri, 3600)
-                    or returnServerError('Unable to load issue description');
+                $issue_html = getSimpleHTMLDOMCached($uri, 3600);
 
                 $issue_html = defaultLinkTo($issue_html, $uri);
 
@@ -308,8 +306,7 @@ class GiteaBridge extends BridgeAbstract
             ];
 
             if ($this->getInput('include_description')) {
-                $issue_html = getSimpleHTMLDOMCached($uri, 3600)
-                    or returnServerError('Unable to load issue description');
+                $issue_html = getSimpleHTMLDOMCached($uri, 3600);
 
                 $issue_html = defaultLinkTo($issue_html, $uri);
 
diff --git a/bridges/GlowficBridge.php b/bridges/GlowficBridge.php
index 0e4b8d93..7a58a08f 100644
--- a/bridges/GlowficBridge.php
+++ b/bridges/GlowficBridge.php
@@ -28,7 +28,7 @@ class GlowficBridge extends BridgeAbstract
     public function collectData()
     {
         $url = $this->getAPIURI();
-        $metadata = get_headers($url . '/replies', true) or returnClientError('Post did not return reply headers.');
+        $metadata = get_headers($url . '/replies', true);
         $metadata['Last-Page'] = ceil($metadata['Total'] / $metadata['Per-Page']);
         if (
             !is_null($this->getInput('start_page')) &&
diff --git a/bridges/GogsBridge.php b/bridges/GogsBridge.php
index 685e5ba2..d838674f 100644
--- a/bridges/GogsBridge.php
+++ b/bridges/GogsBridge.php
@@ -171,8 +171,7 @@ class GogsBridge extends BridgeAbstract
             ];
 
             if ($this->getInput('include_description')) {
-                $issue_html = getSimpleHTMLDOMCached($uri, 3600)
-                    or returnServerError('Unable to load issue description');
+                $issue_html = getSimpleHTMLDOMCached($uri, 3600);
 
                 $issue_html = defaultLinkTo($issue_html, $uri);
 
diff --git a/bridges/GoogleScholarBridge.php b/bridges/GoogleScholarBridge.php
index 11dc123b..3004180f 100644
--- a/bridges/GoogleScholarBridge.php
+++ b/bridges/GoogleScholarBridge.php
@@ -109,7 +109,7 @@ class GoogleScholarBridge extends BridgeAbstract
             case 'user':
                 $userId = $this->getInput('userId');
                 $uri = self::URI . '/citations?hl=en&view_op=list_works&sortby=pubdate&user=' . $userId;
-                $html = getSimpleHTMLDOM($uri) or returnServerError('Could not fetch Google Scholar data.');
+                $html = getSimpleHTMLDOM($uri);
 
                 $publications = $html->find('tr[class="gsc_a_tr"]');
 
@@ -184,7 +184,7 @@ class GoogleScholarBridge extends BridgeAbstract
                 $uri .= $sortBy ? '&scisbd=1' : '';
                 $uri .= $numResults ? '&num=' . $numResults : '';
 
-                $html = getSimpleHTMLDOM($uri) or returnServerError('Could not fetch Google Scholar data.');
+                $html = getSimpleHTMLDOM($uri);
 
                 $publications = $html->find('div[class="gs_r gs_or gs_scl"]');
 
diff --git a/bridges/ItakuBridge.php b/bridges/ItakuBridge.php
index b231b143..22d7529f 100644
--- a/bridges/ItakuBridge.php
+++ b/bridges/ItakuBridge.php
@@ -438,8 +438,7 @@ class ItakuBridge extends BridgeAbstract
     private function getOwnerID($username)
     {
         $url = self::URI . "/api/user_profiles/{$username}/?format=json";
-        $data = $this->getData($url, true, true)
-            or returnServerError("Could not load $url");
+        $data = $this->getData($url, true, true);
 
         return $data['owner'];
     }
@@ -451,8 +450,7 @@ class ItakuBridge extends BridgeAbstract
         }
         $uri = self::URI . '/posts/' . $id;
         $url = self::URI . '/api/posts/' . $id . '/?format=json';
-        $data = $metadata ?? $this->getData($url, true, true)
-            or returnServerError("Could not load $url");
+        $data = $metadata ?? $this->getData($url, true, true);
 
         $content_str = nl2br($data['content']);
         $content = "<p>{$content_str}</p><br/>"; //TODO: Add link and itaku user mention detection and convert into links.
@@ -497,8 +495,7 @@ class ItakuBridge extends BridgeAbstract
                 $content .= "<a href=\"{$url}\"><b>{$title}</b></a><br/>";
                 if ($media['is_thumbnail_for_video']) {
                     $url = self::URI . '/api/galleries/images/' . $media['id'] . '/?format=json';
-                    $media_data = $this->getData($url, true, true)
-                        or returnServerError("Could not load $url");
+                    $media_data = $this->getData($url, true, true);
                     $content .= "<video controls src=\"{$media_data['video']['video']}\" poster=\"{$media['image_xl']}\"/>";
                 } else {
                     $content .= "<a href=\"{$url}\"><img src=\"{$src}\"></a>";
@@ -523,11 +520,11 @@ class ItakuBridge extends BridgeAbstract
         $url = self::URI . '/api/commissions/' . $id . '/?format=json';
         $uri = self::URI . '/commissions/' . $id;
 
-        $data = $metadata ?? $this->getData($url, true, true)
-            or returnServerError("Could not load $url");
+        $data = $metadata ?? $this->getData($url, true, true);
 
         $content_str = nl2br($data['description']);
-        $content = "<p>{$content_str}</p><br>"; //TODO: Add link and itaku user mention detection and convert into links.
+        $content = "<p>{$content_str}</p><br>";
+        //TODO: Add link and itaku user mention detection and convert into links.
 
         if (array_key_exists('tags', $data) && count($data['tags']) > 0) {
             // $content .= "🏷 Tag(s): ";
@@ -570,8 +567,7 @@ class ItakuBridge extends BridgeAbstract
             $content .= "<a href=\"{$uri}\"><b>{$data['thumbnail_detail']['title']}</b></a><br/>";
             if ($data['thumbnail_detail']['is_thumbnail_for_video']) {
                 $url = self::URI . '/api/galleries/images/' . $data['thumbnail_detail']['id'] . '/?format=json';
-                $media_data = $this->getData($url, true, true)
-                    or returnServerError("Could not load $url");
+                $media_data = $this->getData($url, true, true);
                 $content .= "<video controls src=\"{$media_data['video']['video']}\" poster=\"{$data['thumbnail_detail']['image_lg']}\"/>";
             } else {
                 $content .= "<a href=\"{$uri}\"><img src=\"{$data['thumbnail_detail']['image_lg']}\"></a>";
@@ -595,8 +591,7 @@ class ItakuBridge extends BridgeAbstract
     {
         $uri = self::URI . '/images/' . $id;
         $url = self::URI . '/api/galleries/images/' . $id . '/?format=json';
-        $data = /* $metadata ?? */ $this->getData($url, true, true)
-            or returnServerError("Could not load $url");
+        $data = /* $metadata ?? */ $this->getData($url, true, true);
 
         $content_str = nl2br($data['description']);
         $content = "<p>{$content_str}</p><br/>"; //TODO: Add link and itaku user mention detection and convert into links.
@@ -640,8 +635,7 @@ class ItakuBridge extends BridgeAbstract
 
         if (array_key_exists('is_thumbnail_for_video', $data)) {
             $url = self::URI . '/api/galleries/images/' . $data['id'] . '/?format=json';
-            $media_data = $this->getData($url, true, true)
-                or returnServerError("Could not load $url");
+            $media_data = $this->getData($url, true, true);
             $content .= "<video controls src=\"{$media_data['video']['video']}\" poster=\"{$data['image_xl']}\"/>";
         } else {
             if (array_key_exists('video', $data) && is_null($data['video'])) {
diff --git a/bridges/JohannesBlickBridge.php b/bridges/JohannesBlickBridge.php
index 80ca9a71..90cd4ef4 100644
--- a/bridges/JohannesBlickBridge.php
+++ b/bridges/JohannesBlickBridge.php
@@ -9,8 +9,7 @@ class JohannesBlickBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $html = getSimpleHTMLDOM(self::URI)
-            or returnServerError('Could not request: ' . self::URI);
+        $html = getSimpleHTMLDOM(self::URI);
 
         $html = defaultLinkTo($html, self::URI);
         foreach ($html->find('ul[class=easyfolderlisting] > li > a') as $index => $a) {
diff --git a/bridges/JustETFBridge.php b/bridges/JustETFBridge.php
index bcefe331..b76ef33f 100644
--- a/bridges/JustETFBridge.php
+++ b/bridges/JustETFBridge.php
@@ -181,8 +181,7 @@ class JustETFBridge extends BridgeAbstract
             if ($this->getInput('full')) {
                 $uri = $this->extractNewsUri($article);
 
-                $html = getSimpleHTMLDOMCached($uri)
-                    or returnServerError('Failed loading full article from ' . $uri);
+                $html = getSimpleHTMLDOMCached($uri);
 
                 $fullArticle = $html->find('div.article', 0)
                     or returnServerError('No content found! Layout might have changed!');
diff --git a/bridges/KernelBugTrackerBridge.php b/bridges/KernelBugTrackerBridge.php
index 02d31cff..8078ddde 100644
--- a/bridges/KernelBugTrackerBridge.php
+++ b/bridges/KernelBugTrackerBridge.php
@@ -64,10 +64,6 @@ Returns feeds for bug comments';
             DEFAULT_SPAN_TEXT
         );
 
-        if ($html === false) {
-            returnServerError('Failed to load page!');
-        }
-
         $html = defaultLinkTo($html, self::URI);
 
         // Store header information into private members
diff --git a/bridges/LaTeX3ProjectNewslettersBridge.php b/bridges/LaTeX3ProjectNewslettersBridge.php
index dcf1ba0d..b3dfe98e 100644
--- a/bridges/LaTeX3ProjectNewslettersBridge.php
+++ b/bridges/LaTeX3ProjectNewslettersBridge.php
@@ -11,7 +11,7 @@ class LaTeX3ProjectNewslettersBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $html = getSimpleHTMLDOM(static::URI . '/news/latex3-news/') or returnServerError('No contents received!');
+        $html = getSimpleHTMLDOM(static::URI . '/news/latex3-news/');
         $newsContainer = $html->find('article tbody', 0);
 
         foreach ($newsContainer->find('tr') as $row) {
diff --git a/bridges/MozillaBugTrackerBridge.php b/bridges/MozillaBugTrackerBridge.php
index cf6d7f73..84397e00 100644
--- a/bridges/MozillaBugTrackerBridge.php
+++ b/bridges/MozillaBugTrackerBridge.php
@@ -64,10 +64,6 @@ Returns feeds for bug comments';
             DEFAULT_SPAN_TEXT
         );
 
-        if ($html === false) {
-            returnServerError('Failed to load page!');
-        }
-
         // Fix relative URLs
         defaultLinkTo($html, self::URI);
 
diff --git a/bridges/OMonlineBridge.php b/bridges/OMonlineBridge.php
index a434e44e..50e2726f 100644
--- a/bridges/OMonlineBridge.php
+++ b/bridges/OMonlineBridge.php
@@ -25,8 +25,7 @@ class OMonlineBridge extends BridgeAbstract
             $url = sprintf('%s', self::URI);
         }
 
-        $html = getSimpleHTMLDOM($url)
-            or returnServerError('Could not request: ' . $url);
+        $html = getSimpleHTMLDOM($url);
 
         $html = defaultLinkTo($html, $url);
 
@@ -35,8 +34,7 @@ class OMonlineBridge extends BridgeAbstract
 
             $articlePath = $a->href;
 
-            $articlePageHtml = getSimpleHTMLDOMCached($articlePath, self::CACHE_TIMEOUT)
-                or returnServerError('Could not request: ' . $articlePath);
+            $articlePageHtml = getSimpleHTMLDOMCached($articlePath, self::CACHE_TIMEOUT);
 
             $articlePageHtml = defaultLinkTo($articlePageHtml, self::URI);
 
diff --git a/bridges/SchweinfurtBuergerinformationenBridge.php b/bridges/SchweinfurtBuergerinformationenBridge.php
index d1f5db15..c41f9783 100644
--- a/bridges/SchweinfurtBuergerinformationenBridge.php
+++ b/bridges/SchweinfurtBuergerinformationenBridge.php
@@ -49,8 +49,7 @@ class SchweinfurtBuergerinformationenBridge extends BridgeAbstract
     private function getArticleIDsFromPage($page)
     {
         $url = sprintf(self::URI . '?art_pager=%d', $page);
-        $html = getSimpleHTMLDOMCached($url, self::INDEX_CACHE_TIMEOUT)
-            or returnServerError('Could not retrieve ' . $url);
+        $html = getSimpleHTMLDOMCached($url, self::INDEX_CACHE_TIMEOUT);
 
         $articles = $html->find('div.artikel-uebersicht');
         $articleIDs = [];
@@ -70,8 +69,7 @@ class SchweinfurtBuergerinformationenBridge extends BridgeAbstract
     private function generateItemFromArticle($id)
     {
         $url = sprintf(self::ARTICLE_URI, $id);
-        $html = getSimpleHTMLDOMCached($url, self::ARTICLE_CACHE_TIMEOUT)
-            or returnServerError('Could not retrieve ' . $url);
+        $html = getSimpleHTMLDOMCached($url, self::ARTICLE_CACHE_TIMEOUT);
 
         $div = $html->find('div#artikel-detail', 0);
         $divContent = $div->find('.c-content', 0);
diff --git a/bridges/SkimfeedBridge.php b/bridges/SkimfeedBridge.php
index a224cdf4..bad1af15 100644
--- a/bridges/SkimfeedBridge.php
+++ b/bridges/SkimfeedBridge.php
@@ -633,8 +633,7 @@ class SkimfeedBridge extends BridgeAbstract
             $author = '<a href="' . $anchor->href . '">' . trim($anchor->plaintext) . '</a>';
             $uri    = $anchor->href;
 
-            $box_html = getSimpleHTMLDOM($uri)
-                or returnServerError('Could not load custom feed!');
+            $box_html = getSimpleHTMLDOM($uri);
 
             $this->extractFeed($box_html, $author);
         }
@@ -665,8 +664,7 @@ class SkimfeedBridge extends BridgeAbstract
      */
     private function exportBoxChannels()
     {
-        $html = getSimpleHTMLDOMCached(static::URI)
-            or returnServerError('No contents received from Skimfeed!');
+        $html = getSimpleHTMLDOMCached(static::URI);
 
         if (!$this->isCompatible($html)) {
             returnServerError('Skimfeed version is not compatible!');
@@ -722,8 +720,7 @@ EOD;
      */
     private function exportTechChannels()
     {
-        $html = getSimpleHTMLDOMCached(static::URI)
-            or returnServerError('No contents received from Skimfeed!');
+        $html = getSimpleHTMLDOMCached(static::URI);
 
         if (!$this->isCompatible($html)) {
             returnServerError('Skimfeed version is not compatible!');
@@ -759,8 +756,7 @@ EOD;
 
             $message .= "\t\t'{$title}' => array(\n";
 
-            $channel_html = getSimpleHTMLDOMCached(static::URI . $uri)
-                or returnServerError('Could not load tech channel ' . $channel->plaintext . '!');
+            $channel_html = getSimpleHTMLDOMCached(static::URI . $uri);
 
             $boxes = $channel_html->find('#boxx .boxes')
                 or returnServerError('Could not find boxes!');
diff --git a/bridges/StanfordSIRbookreviewBridge.php b/bridges/StanfordSIRbookreviewBridge.php
index b60f8fc1..f15b6cfb 100644
--- a/bridges/StanfordSIRbookreviewBridge.php
+++ b/bridges/StanfordSIRbookreviewBridge.php
@@ -30,8 +30,7 @@ class StanfordSIRbookreviewBridge extends BridgeAbstract
                 break;
         }
 
-        $html = getSimpleHTMLDOM($url)
-            or returnServerError('Failed loading content!');
+        $html = getSimpleHTMLDOM($url);
         foreach ($html->find('article') as $element) {
             $item = [];
             $item['title'] = $element->find('div > h4 > a', 0)->plaintext;
diff --git a/bridges/StockFilingsBridge.php b/bridges/StockFilingsBridge.php
index 2817dd97..0b6a06a4 100644
--- a/bridges/StockFilingsBridge.php
+++ b/bridges/StockFilingsBridge.php
@@ -65,7 +65,7 @@ class StockFilingsBridge extends FeedExpander
     {
         $uri = $this->getSearchUrl();
 
-        return getSimpleHTMLDOM($uri) ?: returnServerError('Could not request SEC.');
+        return getSimpleHTMLDOM($uri);
     }
 
     /**
diff --git a/bridges/StorytelBridge.php b/bridges/StorytelBridge.php
index 2316aacd..a33b3e4a 100644
--- a/bridges/StorytelBridge.php
+++ b/bridges/StorytelBridge.php
@@ -25,9 +25,6 @@ class StorytelBridge extends BridgeAbstract
         }
 
         $html = getSimpleHTMLDOM($url);
-        if (!$html) {
-            returnServerError('Unable to fetch Storytel list');
-        }
 
         foreach ($html->find('li.sc-4615116a-1') as $element) {
             $item = [];
diff --git a/bridges/TapasBridge.php b/bridges/TapasBridge.php
index 8009e64d..1dd8d009 100644
--- a/bridges/TapasBridge.php
+++ b/bridges/TapasBridge.php
@@ -36,7 +36,7 @@ class TapasBridge extends FeedExpander
             $this->id = $this->getInput('title');
         }
         if ($this->getInput('force_title') || !$this->id) {
-            $html = getSimpleHTMLDOM($this->getURI()) or returnServerError('Could not request ' . $this->getURI());
+            $html = getSimpleHTMLDOM($this->getURI());
             $this->id = $html->find('meta[property$=":url"]', 0)->content;
             $this->id = str_ireplace(['tapastic://series/', '/info'], '', $this->id);
         }
diff --git a/bridges/TestFaktaBridge.php b/bridges/TestFaktaBridge.php
index b9a65138..e9ab263a 100644
--- a/bridges/TestFaktaBridge.php
+++ b/bridges/TestFaktaBridge.php
@@ -56,8 +56,7 @@ class TestFaktaBridge extends BridgeAbstract
     public function collectData()
     {
         $NEWSURL = self::URI . '/sv';
-        $html = getSimpleHTMLDOMCached($NEWSURL, 18000) or
-            returnServerError('Could not request: ' . $NEWSURL);
+        $html = getSimpleHTMLDOMCached($NEWSURL, 18000);
 
         foreach ($html->find('.row-container') as $element) {
             // Debug::log($element);
@@ -68,8 +67,7 @@ class TestFaktaBridge extends BridgeAbstract
             $figure = $element->find('img', 0);
             $preamble = trim($element->find('.text', 0)->plaintext);
 
-            $article_html = getSimpleHTMLDOMCached($url, 18000) or
-                returnServerError('Could not request: ' . $url);
+            $article_html = getSimpleHTMLDOMCached($url, 18000);
             $article_content = $article_html->find('div.content', 0);
             $article_text = $article_html->find('article', 0);
 
diff --git a/bridges/UsesTechBridge.php b/bridges/UsesTechBridge.php
index 653d83dc..28fc9908 100644
--- a/bridges/UsesTechBridge.php
+++ b/bridges/UsesTechBridge.php
@@ -10,8 +10,7 @@ class UsesTechbridge extends BridgeAbstract
 
     public function collectData()
     {
-        $html = getSimpleHTMLDOM(self::URI)
-            or returnServerError('Could not request: ' . self::URI);
+        $html = getSimpleHTMLDOM(self::URI);
 
         foreach ($html->find('div[class=PersonInner]') as $index => $a) {
             $item = []; // Create an empty item
diff --git a/bridges/VproTegenlichtBridge.php b/bridges/VproTegenlichtBridge.php
index 2b5e5d20..44afba64 100644
--- a/bridges/VproTegenlichtBridge.php
+++ b/bridges/VproTegenlichtBridge.php
@@ -16,8 +16,7 @@ class VproTegenlichtBridge extends BridgeAbstract
     public function collectData()
     {
         $url = sprintf('https://www.vpro.nl/programmas/tegenlicht/lees/artikelen.html');
-        $dom = getSimpleHTMLDOM($url)
-               or returnServerError('No contents received!');
+        $dom = getSimpleHTMLDOM($url);
         $dom = $dom->find('ul#browsable-news-overview', 0);
         $dom = defaultLinkTo($dom, $this->getURI());
         foreach ($dom->find('li') as $article) {
diff --git a/bridges/WikipediaBridge.php b/bridges/WikipediaBridge.php
index 28149d0f..0907db76 100644
--- a/bridges/WikipediaBridge.php
+++ b/bridges/WikipediaBridge.php
@@ -105,10 +105,6 @@ class WikipediaBridge extends BridgeAbstract
         // This will automatically send us to the correct main page in any language (try it!)
         $html = getSimpleHTMLDOM($this->getURI() . '/wiki');
 
-        if (!$html) {
-            returnServerError('Could not load site: ' . $this->getURI() . '!');
-        }
-
         /*
         * Now read content depending on the language (make sure to create one function per language!)
         * We build the function name automatically, just make sure you create a private function ending
diff --git a/bridges/XenForoBridge.php b/bridges/XenForoBridge.php
index d1ecea74..52c63948 100644
--- a/bridges/XenForoBridge.php
+++ b/bridges/XenForoBridge.php
@@ -304,11 +304,9 @@ class XenForoBridge extends BridgeAbstract
 
                 // We can optimize performance by caching all but the last page
                 if ($page != $lastpage) {
-                    $html = getSimpleHTMLDOMCached($pageurl)
-                        or returnServerError('Error loading contents from ' . $pageurl . '!');
+                    $html = getSimpleHTMLDOMCached($pageurl);
                 } else {
-                    $html = getSimpleHTMLDOM($pageurl)
-                        or returnServerError('Error loading contents from ' . $pageurl . '!');
+                    $html = getSimpleHTMLDOM($pageurl);
                 }
 
                 $html = defaultLinkTo($html, $hosturl);
@@ -347,11 +345,9 @@ class XenForoBridge extends BridgeAbstract
 
                 // We can optimize performance by caching all but the last page
                 if ($page != $lastpage) {
-                    $html = getSimpleHTMLDOMCached($pageurl)
-                        or returnServerError('Error loading contents from ' . $pageurl . '!');
+                    $html = getSimpleHTMLDOMCached($pageurl);
                 } else {
-                    $html = getSimpleHTMLDOM($pageurl)
-                        or returnServerError('Error loading contents from ' . $pageurl . '!');
+                    $html = getSimpleHTMLDOM($pageurl);
                 }
 
                 $html = defaultLinkTo($html, $hosturl);

From be51ba17df892fde0c371c181425dd636f0f4d37 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 3 Jan 2025 05:40:30 +0100
Subject: [PATCH 560/716] fix(url): disallowed wonky path (#4386)

---
 bridges/RumbleBridge.php | 4 +---
 lib/url.php              | 3 +++
 tests/UrlTest.php        | 6 ++++++
 3 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/bridges/RumbleBridge.php b/bridges/RumbleBridge.php
index 11755b51..c1a565bb 100644
--- a/bridges/RumbleBridge.php
+++ b/bridges/RumbleBridge.php
@@ -74,9 +74,7 @@ class RumbleBridge extends BridgeAbstract
                 $item['timestamp'] = $publishedAt->getTimestamp();
             }
 
-            if (isset($publishedAt) && $publishedAt > new \DateTimeImmutable('2025-01-31')) {
-                $href = ltrim($href, '/');
-            }
+            $href = ltrim($href, '/');
             $itemUrl = Url::fromString(self::URI . $href);
             // Remove tracking parameter in query string
             $item['uri'] = $itemUrl->withQueryString(null)->__toString();
diff --git a/lib/url.php b/lib/url.php
index 993fef96..9a1b59ad 100644
--- a/lib/url.php
+++ b/lib/url.php
@@ -111,6 +111,9 @@ final class Url
         if (!str_starts_with($path, '/')) {
             throw new UrlException(sprintf('Path must start with forward slash: %s', $path));
         }
+        if (str_starts_with($path, '//')) {
+            throw new UrlException(sprintf('Illegal path (too many forward slashes): %s', $path));
+        }
         $clone = clone $this;
         $clone->path = $path;
         return $clone;
diff --git a/tests/UrlTest.php b/tests/UrlTest.php
index d45f319b..72b9ac4c 100644
--- a/tests/UrlTest.php
+++ b/tests/UrlTest.php
@@ -36,6 +36,12 @@ class UrlTest extends TestCase
         }
     }
 
+    public function testIllegalPath()
+    {
+        $this->expectException(\UrlException::class);
+        Url::fromString('https://example.com//foo');
+    }
+
     public function testMutation()
     {
         $this->assertSame('http://example.com/foo', (Url::fromString('http://example.com/'))->withPath('/foo')->__toString());

From 3fc38c15a3afa7e0377e3b6cb4ffec1335a36f63 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 3 Jan 2025 06:19:24 +0100
Subject: [PATCH 561/716] fix: cache 400 and 404, and refactor token auth
 (#4388)

* fix(cache): also cache 400 and 404 responses

* refactor(token_auth)
---
 actions/DisplayAction.php                     |  2 +-
 actions/FrontpageAction.php                   |  2 +-
 lib/http.php                                  |  2 +-
 middlewares/CacheMiddleware.php               |  9 +++++++--
 middlewares/TokenAuthenticationMiddleware.php | 16 ++++++++++------
 templates/token.html.php                      |  4 ++--
 6 files changed, 22 insertions(+), 13 deletions(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 845bfd84..10af8ad7 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -23,7 +23,7 @@ class DisplayAction implements ActionInterface
         $noproxy = $request->get('_noproxy');
 
         if (!$bridgeName) {
-            return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'Missing bridge parameter']), 400);
+            return new Response(render(__DIR__ . '/../templates/error.html.php', ['message' => 'Missing bridge name parameter']), 400);
         }
         $bridgeClassName = $this->bridgeFactory->createBridgeClassName($bridgeName);
         if (!$bridgeClassName) {
diff --git a/actions/FrontpageAction.php b/actions/FrontpageAction.php
index 824441b2..79ffb4f5 100644
--- a/actions/FrontpageAction.php
+++ b/actions/FrontpageAction.php
@@ -12,7 +12,7 @@ final class FrontpageAction implements ActionInterface
 
     public function __invoke(Request $request): Response
     {
-        $token = $request->attribute('token');
+        $token = $request->getAttribute('token');
 
         $messages = [];
         $activeBridges = 0;
diff --git a/lib/http.php b/lib/http.php
index d1043b33..15d6ebec 100644
--- a/lib/http.php
+++ b/lib/http.php
@@ -220,7 +220,7 @@ final class Request
         return $clone;
     }
 
-    public function attribute(string $key, $default = null)
+    public function getAttribute(string $key, $default = null)
     {
         return $this->attributes[$key] ?? $default;
     }
diff --git a/middlewares/CacheMiddleware.php b/middlewares/CacheMiddleware.php
index bffde4af..b8a34754 100644
--- a/middlewares/CacheMiddleware.php
+++ b/middlewares/CacheMiddleware.php
@@ -13,7 +13,7 @@ class CacheMiddleware implements Middleware
 
     public function __invoke(Request $request, $next): Response
     {
-        $action = $request->attribute('action');
+        $action = $request->getAttribute('action');
 
         if ($action !== 'DisplayAction') {
             // We only cache DisplayAction (for now)
@@ -43,9 +43,14 @@ class CacheMiddleware implements Middleware
         /** @var Response $response */
         $response = $next($request);
 
-        if (in_array($response->getCode(), [403, 429, 500, 503])) {
+        if ($response->getCode() === 200) {
+            // Do nothing because DisplayAction has already cached this on $cacheKey
+        } elseif (in_array($response->getCode(), [400, 403, 404, 429, 500, 503])) {
             // Cache these responses for about ~10 mins on average
             $this->cache->set($cacheKey, $response, 60 * 5 + rand(1, 60 * 10));
+        } else {
+            // Should never happen
+            $this->cache->set($cacheKey, $response, 60 * 5);
         }
 
         // For 1% of requests, prune cache
diff --git a/middlewares/TokenAuthenticationMiddleware.php b/middlewares/TokenAuthenticationMiddleware.php
index f8234629..31544ab7 100644
--- a/middlewares/TokenAuthenticationMiddleware.php
+++ b/middlewares/TokenAuthenticationMiddleware.php
@@ -10,20 +10,24 @@ class TokenAuthenticationMiddleware implements Middleware
             return $next($request);
         }
 
-        // Always add token to request attribute
-        $request = $request->withAttribute('token', $request->get('token'));
+        $token = $request->get('token');
 
-        if (! $request->attribute('token')) {
+        if (! $token) {
             return new Response(render(__DIR__ . '/../templates/token.html.php', [
-                'message' => 'Missing token',
+                'message'   => 'Missing token',
+                'token'     => '',
             ]), 401);
         }
-        if (! hash_equals(Configuration::getConfig('authentication', 'token'), $request->attribute('token'))) {
+
+        if (! hash_equals(Configuration::getConfig('authentication', 'token'), $token)) {
             return new Response(render(__DIR__ . '/../templates/token.html.php', [
-                'message' => 'Invalid token',
+                'message'   => 'Invalid token',
+                'token'     => $token,
             ]), 401);
         }
 
+        $request = $request->withAttribute('token', $token);
+
         return $next($request);
     }
 }
diff --git a/templates/token.html.php b/templates/token.html.php
index 1a036dbb..43c60972 100644
--- a/templates/token.html.php
+++ b/templates/token.html.php
@@ -13,8 +13,8 @@
     <?= e($message) ?>
 </p>
 
-<form action="" method="get">
+<form action="" method="get" autocomplete="off">
     <label for="token">Token:</label>
-    <input type="password" name="token" id="token" placeholder="token">
+    <input type="text" name="token" id="token" placeholder="token" value="<?= e($token) ?>">
     <input type="submit" value="OK">
 </form>

From 662e0bfa95ca4bd0bb03cb2554bf974e19ee7db7 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 3 Jan 2025 06:49:10 +0100
Subject: [PATCH 562/716] refactor(donnons) (#4389)

---
 bridges/DonnonsBridge.php | 90 ++++++++++++++++++++-------------------
 1 file changed, 47 insertions(+), 43 deletions(-)

diff --git a/bridges/DonnonsBridge.php b/bridges/DonnonsBridge.php
index a33a1013..1afdc4f2 100644
--- a/bridges/DonnonsBridge.php
+++ b/bridges/DonnonsBridge.php
@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 /**
  * Retourne les dons d'une recherche filtrée sur le site Donnons.org
  * Example: https://donnons.org/Sport/Ile-de-France
@@ -44,58 +46,60 @@ class DonnonsBridge extends BridgeAbstract
     {
         $uri = $this->getPageURI($page);
 
-        $html = getSimpleHTMLDOM($uri);
+        $dom = getSimpleHTMLDOM($uri);
 
-        $searchDiv = $html->find('div[id=search]', 0);
+        $searchDiv = $dom->find('div[id=search]', 0);
 
-        if (!is_null($searchDiv)) {
-            $elements = $searchDiv->find('a.lst-annonce');
-            foreach ($elements as $element) {
-                $item = [];
+        if (! $searchDiv) {
+            return;
+        }
 
-                // Lien vers le don
-                $item['uri'] = self::URI . $element->href;
-                // Id de l'objet
-                $item['uid'] = $element->getAttribute('data-id');
+        $elements = $searchDiv->find('a.lst-annonce');
+        foreach ($elements as $element) {
+            $item = [];
 
-                // Grab info from json
-                $jsonString = $element->find('script', 0)->innertext;
-                $json = json_decode($jsonString, true);
+            // Lien vers le don
+            $item['uri'] = self::URI . $element->href;
+            // Id de l'objet
+            $item['uid'] = $element->getAttribute('data-id');
 
-                $name = $json['name'];
-                $category = $json['category'];
-                $date = $json['availabilityStarts'];
-                $description = $json['description'];
-                $city = $json['availableAtOrFrom']['address']['addressLocality'];
-                $region = $json['availableAtOrFrom']['address']['addressRegion'];
+            // Grab info from json
+            $jsonString = $element->find('script', 0)->innertext;
+            $json = json_decode($jsonString, true);
 
-                // Grab info from HTML
-                $imageSrc = $element->find('img.ima-center', 0)->getAttribute('src');
-                // Use large image instead of small one
-                $imageSrc = str_replace('/xs/', '/lg/', $imageSrc);
-                $image = self::URI . $imageSrc;
-                $author = $element->find('div.avatar-holder', 0)->plaintext;
+            $name = $json['name'];
+            $category = $json['category'];
+            $date = $json['availabilityStarts'];
+            $description = $json['description'];
+            $city = $json['availableAtOrFrom']['address']['addressLocality'];
+            $region = $json['availableAtOrFrom']['address']['addressRegion'];
 
-                $content = '
-					<img style="margin-right:1em;" src="' . $image . '">
-					<div>
-						<h1>' . $name . '</h1>
-						<p>' . $description . '</p>
-						<p>Lieu : <b>' . $city . '</b> - ' . $region . '</p>
-						<p>Par : ' . $author . '</p>
-						<p>Date : ' . $date . '</p>
-					</div>
-				';
+            // Grab info from HTML
+            $imageSrc = $element->find('img.ima-center', 0)->getAttribute('src');
+            // Use large image instead of small one
+            $imageSrc = str_replace('/xs/', '/lg/', $imageSrc);
+            $image = self::URI . $imageSrc;
+            $author = $element->find('div.avatar-holder', 0)->plaintext;
 
-                // Titre du don
-                $item['title'] = '[' . $category . '] ' . $name;
-                $item['timestamp'] = $date;
-                $item['author'] = $author;
-                $item['content'] = $content;
-                $item['enclosures'] = [$image];
+            $content = '
+                <img style="margin-right:1em;" src="' . $image . '">
+                <div>
+                    <h1>' . $name . '</h1>
+                    <p>' . $description . '</p>
+                    <p>Lieu : <b>' . $city . '</b> - ' . $region . '</p>
+                    <p>Par : ' . $author . '</p>
+                    <p>Date : ' . $date . '</p>
+                </div>
+            ';
 
-                $this->items[] = $item;
-            }
+            // Titre du don
+            $item['title'] = '[' . $category . '] ' . $name;
+            $item['timestamp'] = $date;
+            $item['author'] = $author;
+            $item['content'] = $content;
+            $item['enclosures'] = [$image];
+
+            $this->items[] = $item;
         }
     }
 

From d36cd0a3329a261cbe9599d19c80c66638f6c7bf Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 3 Jan 2025 07:11:08 +0100
Subject: [PATCH 563/716] fix(ceska): item image (#4390)

---
 bridges/CeskaTelevizeBridge.php | 51 +++++++++++++++------------------
 1 file changed, 23 insertions(+), 28 deletions(-)

diff --git a/bridges/CeskaTelevizeBridge.php b/bridges/CeskaTelevizeBridge.php
index 026e8c2a..a996bd11 100644
--- a/bridges/CeskaTelevizeBridge.php
+++ b/bridges/CeskaTelevizeBridge.php
@@ -18,25 +18,6 @@ class CeskaTelevizeBridge extends BridgeAbstract
         ]
     ];
 
-    private function fixChars($text)
-    {
-        return html_entity_decode($text, ENT_QUOTES, 'UTF-8');
-    }
-
-    private function getUploadTimeFromString($string)
-    {
-        if (strpos($string, 'dnes') !== false) {
-            return strtotime('today');
-        } elseif (strpos($string, 'včera') !== false) {
-            return strtotime('yesterday');
-        } elseif (!preg_match('/(\d+).\s(\d+).(\s(\d+))?/', $string, $match)) {
-            returnServerError('Could not get date from Česká televize string');
-        }
-
-        $date = sprintf('%04d-%02d-%02d', $match[3] ?? date('Y'), $match[2], $match[1]);
-        return strtotime($date);
-    }
-
     public function collectData()
     {
         $url = $this->getInput('url');
@@ -58,24 +39,38 @@ class CeskaTelevizeBridge extends BridgeAbstract
         }
 
         foreach ($html->find('#episodeListSection a[data-testid=card]') as $element) {
-            $itemTitle = $element->find('h3', 0);
             $itemContent = $element->find('p[class^=content-]', 0);
             $itemDate = $element->find('div[class^=playTime-] span, [data-testid=episode-item-broadcast] span', 0);
-            $itemThumbnail = $element->find('img', 0);
-            $itemUri = self::URI . $element->getAttribute('href');
-
             $item = [
-                'title' => $this->fixChars($itemTitle->plaintext),
-                'uri' => $itemUri,
-                'content' => '<img src="' . $itemThumbnail->getAttribute('src') . '" /><br />'
-                    . $this->fixChars($itemContent->plaintext),
-                'timestamp' => $this->getUploadTimeFromString($itemDate->plaintext)
+                'title'     => $this->fixChars($element->find('h3', 0)->plaintext),
+                'uri'       => self::URI . $element->getAttribute('href'),
+                'content'   => '<img src="' . $element->find('img', 0)->getAttribute('srcset') . '" /><br />' . $this->fixChars($itemContent->plaintext),
+                'timestamp' => $this->getUploadTimeFromString($itemDate->plaintext),
             ];
 
             $this->items[] = $item;
         }
     }
 
+    private function getUploadTimeFromString($string)
+    {
+        if (strpos($string, 'dnes') !== false) {
+            return strtotime('today');
+        } elseif (strpos($string, 'včera') !== false) {
+            return strtotime('yesterday');
+        } elseif (!preg_match('/(\d+).\s(\d+).(\s(\d+))?/', $string, $match)) {
+            returnServerError('Could not get date from Česká televize string');
+        }
+
+        $date = sprintf('%04d-%02d-%02d', $match[3] ?? date('Y'), $match[2], $match[1]);
+        return strtotime($date);
+    }
+
+    private function fixChars($text)
+    {
+        return html_entity_decode($text, ENT_QUOTES, 'UTF-8');
+    }
+
     public function getURI()
     {
         return $this->feedUri ?? parent::getURI();

From db3899f2e6d15f8bc447c4979ed56f0687ebd05d Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 3 Jan 2025 07:23:13 +0100
Subject: [PATCH 564/716] fix(legifrance): emergency repair, still semi-broken
 (#4391)

---
 bridges/DansTonChatBridge.php  |  6 ++--
 bridges/LegifranceJOBridge.php | 64 ++++++++++++++++++----------------
 2 files changed, 38 insertions(+), 32 deletions(-)

diff --git a/bridges/DansTonChatBridge.php b/bridges/DansTonChatBridge.php
index 9712ec9d..a7765f19 100644
--- a/bridges/DansTonChatBridge.php
+++ b/bridges/DansTonChatBridge.php
@@ -10,9 +10,11 @@ class DansTonChatBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $html = getSimpleHTMLDOM(self::URI . 'latest.html');
+        $url = self::URI . 'latest.html';
+        $dom = getSimpleHTMLDOM($url);
 
-        foreach ($html->find('div.item') as $element) {
+        $items = $dom->find('div.item');
+        foreach ($items as $element) {
             $item = [];
             $item['uri'] = $element->find('a', 0)->href;
             $titleContent = $element->find('h3 a', 0);
diff --git a/bridges/LegifranceJOBridge.php b/bridges/LegifranceJOBridge.php
index 2d86c2ce..cf8f9f72 100644
--- a/bridges/LegifranceJOBridge.php
+++ b/bridges/LegifranceJOBridge.php
@@ -14,6 +14,37 @@ class LegifranceJOBridge extends BridgeAbstract
     private $timestamp;
     private $uri;
 
+    public function collectData()
+    {
+        $html = getSimpleHTMLDOM(self::URI);
+
+        $title = $html->find('h2.titleJO', 0);
+
+        //$this->author = trim($title->plaintext);
+        $uri1 = $html->find('h2.titleELI', 0);
+        //$uri = $uri1->plaintext;
+        //$this->uri = trim(substr($uri, strpos($uri, 'https')));
+        $this->timestamp = strtotime(substr($this->uri, strpos($this->uri, 'eli/jo/') + strlen('eli/jo/'), -5));
+
+        foreach ($html->find('h3') as $section) {
+            $subsections = $section->nextSibling()->find('h4');
+            foreach ($subsections as $subsection) {
+                $origins = $subsection->nextSibling()->find('h5');
+                foreach ($origins as $origin) {
+                    $this->items[] = $this->extractItem($section, $subsection, $origin);
+                }
+                if (!empty($origins)) {
+                    continue;
+                }
+                $this->items[] = $this->extractItem($section, $subsection);
+            }
+            if (!empty($subsections)) {
+                continue;
+            }
+            $this->items[] = $this->extractItem($section);
+        }
+    }
+
     private function extractItem($section, $subsection = null, $origin = null)
     {
         $item = [];
@@ -35,7 +66,9 @@ class LegifranceJOBridge extends BridgeAbstract
         $item['content'] = '';
         foreach ($data->nextSibling()->find('a') as $content) {
             $text = $content->plaintext;
-            $href = $content->nextSibling()->getAttribute('resource');
+            $href = '';
+            //$href = $content->nextSibling()->getAttribute('resource');
+
             $item['content'] .= '<p><a href="' . $href . '">' . $text . '</a></p>';
         }
         return $item;
@@ -45,33 +78,4 @@ class LegifranceJOBridge extends BridgeAbstract
     {
         return 'https://www.legifrance.gouv.fr/img/favicon.ico';
     }
-
-    public function collectData()
-    {
-        $html = getSimpleHTMLDOM(self::URI)
-            or $this->returnServer('Unable to download ' . self::URI);
-
-        $this->author = trim($html->find('h2.titleJO', 0)->plaintext);
-        $uri = $html->find('h2.titleELI', 0)->plaintext;
-        $this->uri = trim(substr($uri, strpos($uri, 'https')));
-        $this->timestamp = strtotime(substr($this->uri, strpos($this->uri, 'eli/jo/') + strlen('eli/jo/'), -5));
-
-        foreach ($html->find('h3') as $section) {
-            $subsections = $section->nextSibling()->find('h4');
-            foreach ($subsections as $subsection) {
-                $origins = $subsection->nextSibling()->find('h5');
-                foreach ($origins as $origin) {
-                    $this->items[] = $this->extractItem($section, $subsection, $origin);
-                }
-                if (!empty($origins)) {
-                    continue;
-                }
-                $this->items[] = $this->extractItem($section, $subsection);
-            }
-            if (!empty($subsections)) {
-                continue;
-            }
-            $this->items[] = $this->extractItem($section);
-        }
-    }
 }

From 97f7df0d06b740db246539c854bcc7611f74f3c1 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 3 Jan 2025 08:17:47 +0100
Subject: [PATCH 565/716] feat(feedmerge): remove duplicates based off of title
 too (#4392)

---
 bridges/FeedMergeBridge.php | 45 ++++++++++++++++++++++++++-----------
 1 file changed, 32 insertions(+), 13 deletions(-)

diff --git a/bridges/FeedMergeBridge.php b/bridges/FeedMergeBridge.php
index 37b574b6..4fe42013 100644
--- a/bridges/FeedMergeBridge.php
+++ b/bridges/FeedMergeBridge.php
@@ -6,8 +6,10 @@ class FeedMergeBridge extends FeedExpander
     const NAME = 'FeedMerge';
     const URI = 'https://github.com/RSS-Bridge/rss-bridge';
     const DESCRIPTION = <<<'TEXT'
-This bridge merges two or more feeds into a single feed. Max 10 items are fetched from each feed.
-TEXT;
+        This bridge merges two or more feeds into a single feed. <br>
+        Max 10 latest items are fetched from each individual feed. <br>
+        Items with identical url or title are considered duplicates (and are removed). <br>
+    TEXT;
 
     const PARAMETERS = [
         [
@@ -36,11 +38,11 @@ TEXT;
     ];
 
     /**
-     * todo: Consider a strategy which produces a shorter feed url
+     * TODO: Consider a strategy which produces a shorter feed url
      */
     public function collectData()
     {
-        $limit = (int)($this->getInput('limit') ?: 10);
+        $limit = (int)($this->getInput('limit') ?: 99);
         $feeds = [
             $this->getInput('feed_1'),
             $this->getInput('feed_2'),
@@ -61,7 +63,7 @@ TEXT;
             if (count($feeds) > 1) {
                 // Allow one or more feeds to fail
                 try {
-                    $this->collectExpandableDatas($feed);
+                    $this->collectExpandableDatas($feed, 10);
                 } catch (HttpException $e) {
                     $this->logger->warning(sprintf('Exception in FeedMergeBridge: %s', create_sane_exception_message($e)));
                     // This feed item might be spammy. Considering dropping it.
@@ -80,31 +82,48 @@ TEXT;
                     throw $e;
                 }
             } else {
-                $this->collectExpandableDatas($feed);
+                $this->collectExpandableDatas($feed, 10);
             }
         }
 
         // If $this->items is empty we should consider throw exception here
 
-        // Sort by timestamp descending
+        // Sort by timestamp, uri, title in descending order
         usort($this->items, function ($a, $b) {
             $t1 = $a['timestamp'] ?? $a['uri'] ?? $a['title'];
             $t2 = $b['timestamp'] ?? $b['uri'] ?? $b['title'];
             return $t2 <=> $t1;
         });
 
-        // Remove duplicates by using url as unique key
+        // Remove duplicates by url
         $items = [];
         foreach ($this->items as $item) {
-            $index = $item['uri'] ?? null;
-            if ($index) {
-                // Overwrite duplicates
-                $items[$index] = $item;
+            $uri = $item['uri'] ?? null;
+            if ($uri) {
+                // Insert or override the existing duplicate
+                $items[$uri] = $item;
             } else {
+                // The item doesn't have a uri!
                 $items[] = $item;
             }
         }
-        $this->items = array_slice(array_values($items), 0, $limit);
+        $this->items = array_values($items);
+
+        // Remove duplicates by title
+        $items = [];
+        foreach ($this->items as $item) {
+            $title = $item['title'] ?? null;
+            if ($title) {
+                // Insert or override the existing duplicate
+                $items[$title] = $item;
+            } else {
+                // The item doesn't have a title!
+                $items[] = $item;
+            }
+        }
+        $this->items = array_values($items);
+
+        $this->items = array_slice($this->items, 0, $limit);
     }
 
     public function getIcon()

From f9e9c8101e770126c151d98356de689279f64a9a Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 3 Jan 2025 08:41:55 +0100
Subject: [PATCH 566/716] Fix 257 (#4393)

* fix(tldrtech): trim duplicate leading slashes

* fix
---
 bridges/TldrTechBridge.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/bridges/TldrTechBridge.php b/bridges/TldrTechBridge.php
index 6c96dff7..222cd49e 100644
--- a/bridges/TldrTechBridge.php
+++ b/bridges/TldrTechBridge.php
@@ -56,7 +56,8 @@ class TldrTechBridge extends BridgeAbstract
             if ($child->tag != 'a') {
                 continue;
             }
-            $this->extractItem(Url::fromString(self::URI . $child->href));
+            $itemUrl = Url::fromString(self::URI . ltrim($child->href, '/'));
+            $this->extractItem($itemUrl);
             if (count($this->items) >= $limit) {
                 break;
             }

From 48cb7d71ed982e6b4145a825eb7c5579b9023999 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 4 Jan 2025 19:00:26 +0100
Subject: [PATCH 567/716] feat(telegram): add pagination fetching of messages
 (#4394)

* feat(telegram): add pagination fetching of messages

* docs
---
 bridges/TelegramBridge.php          | 82 +++++++++++++++++++----------
 config.default.ini.php              |  5 ++
 docs/10_Bridge_Specific/Telegram.md | 12 +++++
 3 files changed, 71 insertions(+), 28 deletions(-)
 create mode 100644 docs/10_Bridge_Specific/Telegram.md

diff --git a/bridges/TelegramBridge.php b/bridges/TelegramBridge.php
index 81c5aeb9..1f82c606 100644
--- a/bridges/TelegramBridge.php
+++ b/bridges/TelegramBridge.php
@@ -15,6 +15,14 @@ class TelegramBridge extends BridgeAbstract
             ]
         ]
     ];
+
+    const CONFIGURATION = [
+        'max_pages' => [
+            'required'      => false,
+            'defaultValue'  => 1,
+        ],
+    ];
+
     const TEST_DETECT_PARAMETERS = [
         'https://t.me/s/rssbridge' => ['username' => 'rssbridge'],
         'https://t.me/rssbridge' => ['username' => 'rssbridge'],
@@ -26,7 +34,7 @@ class TelegramBridge extends BridgeAbstract
         'https://rssbridge.t.me/' => ['username' => 'rssbridge'],
     ];
 
-    const CACHE_TIMEOUT = 60 * 15; // 15 mins
+    const CACHE_TIMEOUT = 60 * 60; // 1h
     private $feedName = '';
 
     private $enclosures = [];
@@ -36,33 +44,56 @@ class TelegramBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $html = getSimpleHTMLDOM($this->getURI());
+        $pages = 0;
+        $url = 'https://t.me/s/' . $this->normalizeUsername();
 
-        $channelTitle = $html->find('div.tgme_channel_info_header_title span', 0)->plaintext ?? '';
-        $channelTitle = htmlspecialchars_decode($channelTitle, ENT_QUOTES);
-        $this->feedName = $channelTitle . ' (@' . $this->normalizeUsername() . ')';
-        $posts = $html->find('div.tgme_widget_message_wrap.js-widget_message_wrap');
-        if (!$channelTitle && !$posts) {
-            throw new \Exception('Unable to find channel. The channel is non-existing or non-public.');
-        }
-        foreach ($posts as $messageDiv) {
-            $this->itemTitle = '';
-            $this->enclosures = [];
-            $item = [];
+        $max_pages = $this->getOption('max_pages');
 
-            $item['uri'] = $messageDiv->find('a.tgme_widget_message_date', 0)->href;
-            $item['content'] = $this->processContent($messageDiv);
-            $item['title'] = $this->itemTitle;
-            $item['timestamp'] = $messageDiv->find('span.tgme_widget_message_meta', 0)->find('time', 0)->datetime;
-            $item['enclosures'] = $this->enclosures;
+        // Hard-coded upper bound of 100 loops
+        while ($pages < $max_pages && $pages < 100) {
+            $pages++;
 
-            $messageOwner = $messageDiv->find('a.tgme_widget_message_owner_name', 0);
-            if ($messageOwner) {
-                $item['author'] = html_entity_decode(trim($messageOwner->plaintext), ENT_QUOTES);
+            $dom = getSimpleHTMLDOM($url);
+
+            $channelTitle = $dom->find('div.tgme_channel_info_header_title span', 0)->plaintext ?? '';
+            $channelTitle = htmlspecialchars_decode($channelTitle, ENT_QUOTES);
+            $this->feedName = $channelTitle . ' (@' . $this->normalizeUsername() . ')';
+
+            $messages = $dom->find('div.tgme_widget_message_wrap.js-widget_message_wrap');
+            if (!$channelTitle && !$messages) {
+                throw new \Exception('Unable to find channel. The channel is non-existing or non-public.');
             }
 
-            $this->items[] = $item;
+            foreach (array_reverse($messages) as $message) {
+                $this->itemTitle = '';
+                $this->enclosures = [];
+
+                $item = [];
+
+                $item['uri'] = $message->find('a.tgme_widget_message_date', 0)->href;
+                $item['content'] = $this->processContent($message);
+                $item['title'] = $this->itemTitle;
+                $item['timestamp'] = $message->find('span.tgme_widget_message_meta', 0)->find('time', 0)->datetime;
+                $item['enclosures'] = $this->enclosures;
+
+                $messageOwner = $message->find('a.tgme_widget_message_owner_name', 0);
+                if ($messageOwner) {
+                    $item['author'] = html_entity_decode(trim($messageOwner->plaintext), ENT_QUOTES);
+                }
+
+                array_unshift($this->items, $item);
+            }
+
+            $more = $dom->find('> div.tgme_widget_message_centered.js-messages_more_wrap a', 0);
+            if ($more && str_contains($more->href, 'before')) {
+                $url = 'https://t.me/' . $more->href;
+            } else {
+                break;
+            }
         }
+
+        $this->logger->info(sprintf('Fetched %s messages from %s pages (%s)', count($this->items), $pages, $url));
+
         $this->items = array_reverse($this->items);
     }
 
@@ -369,12 +400,7 @@ EOD;
 
     private function normalizeUsername()
     {
-        // todo: can be replaced with ltrim($username, '@');
-        $username = $this->getInput('username');
-        if (substr($username, 0, 1) === '@') {
-            return substr($username, 1);
-        }
-        return $username;
+        return ltrim($this->getInput('username'), '@');
     }
 
     public function detectParameters($url)
diff --git a/config.default.ini.php b/config.default.ini.php
index c23372d9..1045d6c3 100644
--- a/config.default.ini.php
+++ b/config.default.ini.php
@@ -155,6 +155,11 @@ port = 11211
 
 ; --- Bridge specific configuration ------
 
+[TelegramBridge]
+
+; Max pages to fetch (1 page => 20 messages), min=1 max=100
+max_pages = 1
+
 [DiscogsBridge]
 
 ; Sets the personal access token for interactions with Discogs. When
diff --git a/docs/10_Bridge_Specific/Telegram.md b/docs/10_Bridge_Specific/Telegram.md
new file mode 100644
index 00000000..528de788
--- /dev/null
+++ b/docs/10_Bridge_Specific/Telegram.md
@@ -0,0 +1,12 @@
+# TelegramBridge
+
+By default, it fetches a single page with up to 20 messages.
+
+To increase this limit, tweak the `max_pages` config:
+
+```ini
+[TelegramBridge]
+
+; Fetch a maximum of 3 pages (requires 3 http requests)
+max_pages = 3
+```

From 1d02214e1253b86622262988ad7ecce1f5647006 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 4 Jan 2025 19:43:48 +0100
Subject: [PATCH 568/716] feat: extract simple_html_dom max_file_size to config
 (#4395)

---
 bridges/YoutubeBridge.php             | 7 -------
 config.default.ini.php                | 9 +++++++++
 lib/bootstrap.php                     | 4 ----
 lib/simplehtmldom/simple_html_dom.php | 5 +++--
 4 files changed, 12 insertions(+), 13 deletions(-)

diff --git a/bridges/YoutubeBridge.php b/bridges/YoutubeBridge.php
index 647b1c42..12cdaec4 100644
--- a/bridges/YoutubeBridge.php
+++ b/bridges/YoutubeBridge.php
@@ -1,12 +1,5 @@
 <?php
 
-/**
-* RssBridgeYoutube
-* Returns the newest videos
-* WARNING: to parse big playlists (over ~90 videos), you need to edit simple_html_dom.php:
-* change: define('MAX_FILE_SIZE', 600000);
-* into:   define('MAX_FILE_SIZE', 900000);  (or more)
-*/
 class YoutubeBridge extends BridgeAbstract
 {
     const NAME = 'YouTube Bridge';
diff --git a/config.default.ini.php b/config.default.ini.php
index 1045d6c3..25f35508 100644
--- a/config.default.ini.php
+++ b/config.default.ini.php
@@ -46,7 +46,11 @@ enable_debug_mode = false
 ; Whether to enable maintenance mode. If enabled, feed requests receive 503 Service Unavailable
 enable_maintenance_mode = false
 
+; Max file size for simple_html_dom in bytes (10000000 => 10 MB)
+max_file_size = 10000000
+
 [http]
+
 ; Operation timeout in seconds
 timeout = 15
 
@@ -70,6 +74,7 @@ type = "file"
 custom_timeout = false
 
 [admin]
+
 ; Advertise an email address where people can reach the administrator.
 ; This address is displayed on the main page, visible to everyone!
 ; ""    = Disabled (default)
@@ -86,6 +91,7 @@ telegram = ""
 donations = true
 
 [proxy]
+
 ; The HTTP proxy to tunnel requests through
 ; https://curl.se/libcurl/c/CURLOPT_PROXY.html
 ; ""    = Proxy disabled (default)
@@ -135,6 +141,7 @@ report_limit = 1
 ; --- Cache specific configuration ---------------------------------------------
 
 [FileCache]
+
 ; The root folder to store files in.
 ; "" = Use the cache folder in the repository (default)
 path = ""
@@ -142,6 +149,7 @@ path = ""
 enable_purge = true
 
 [SQLiteCache]
+
 ; Filepath of the sqlite db file
 file = "cache.sqlite"
 ; Whether to actually delete data when purging
@@ -150,6 +158,7 @@ enable_purge = true
 timeout = 5000
 
 [MemcachedCache]
+
 host = "localhost"
 port = 11211
 
diff --git a/lib/bootstrap.php b/lib/bootstrap.php
index 36b13e19..8a7c62a1 100644
--- a/lib/bootstrap.php
+++ b/lib/bootstrap.php
@@ -7,10 +7,6 @@ if (is_file(__DIR__ . '/../vendor/autoload.php')) {
 const PATH_LIB_CACHES = __DIR__ . '/../caches/';
 const PATH_CACHE = __DIR__ . '/../cache/';
 
-// Allow larger files for simple_html_dom
-// todo: extract to config (if possible)
-const MAX_FILE_SIZE = 10000000;
-
 // Files
 $files = [
     __DIR__ . '/../lib/html.php',
diff --git a/lib/simplehtmldom/simple_html_dom.php b/lib/simplehtmldom/simple_html_dom.php
index 170f6fb0..e8b3a727 100644
--- a/lib/simplehtmldom/simple_html_dom.php
+++ b/lib/simplehtmldom/simple_html_dom.php
@@ -114,8 +114,9 @@ function str_get_html(
     if (empty($str)) {
         throw new \Exception('Refusing to parse empty string input');
     }
-    if (strlen($str) > MAX_FILE_SIZE) {
-        throw new \Exception('Refusing to parse too big input');
+
+    if (strlen($str) > Configuration::getConfig('system', 'max_file_size')) {
+        throw new \Exception('simple_html_dom: Refusing to parse too big input: ' . strlen($str));
     }
 
 	return $dom->load($str, $lowercase, $stripRN);

From cb65125dbd1fc5f82d16c036c00bcebc1a10d6de Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 4 Jan 2025 20:34:36 +0100
Subject: [PATCH 569/716] feat: add section link to frontpage bridge card
 (#4396)

---
 lib/BridgeCard.php | 4 ++++
 static/style.css   | 1 +
 2 files changed, 5 insertions(+)

diff --git a/lib/BridgeCard.php b/lib/BridgeCard.php
index 855ddb93..2f171002 100644
--- a/lib/BridgeCard.php
+++ b/lib/BridgeCard.php
@@ -44,6 +44,10 @@ final class BridgeCard
                 data-short-name="$shortName"
             >
 
+            <a style="position: absolute; top: 10px; left: 10px" href="#bridge-{$bridgeClassName}">
+                <h1>#</h1>
+            <a>
+
             <h2><a href="{$uri}">{$name}</a></h2>
             <p class="description">{$description}</p>
 
diff --git a/static/style.css b/static/style.css
index 4e6b1b2d..4c831534 100644
--- a/static/style.css
+++ b/static/style.css
@@ -186,6 +186,7 @@ section li {
     margin-left: 1em;
 }
 .bridge-card {
+    position: relative;
     text-align: center;
 }
 

From e3552763784b141b49ca639c461f046b208c97c3 Mon Sep 17 00:00:00 2001
From: Pavel Korytov <thexcloud@gmail.com>
Date: Mon, 6 Jan 2025 21:08:08 +0300
Subject: [PATCH 570/716] [EconomistWorldInBriefBridge] Update bridge (#4397)

* [EconomistWorldInBriefBridge] Fix and update bridge

* [EconomistWorldInBriefBridge] Fix lint
---
 bridges/EconomistWorldInBriefBridge.php | 45 ++++++++++++++++++++++++-
 1 file changed, 44 insertions(+), 1 deletion(-)

diff --git a/bridges/EconomistWorldInBriefBridge.php b/bridges/EconomistWorldInBriefBridge.php
index 72b66198..3b717d81 100644
--- a/bridges/EconomistWorldInBriefBridge.php
+++ b/bridges/EconomistWorldInBriefBridge.php
@@ -41,6 +41,12 @@ class EconomistWorldInBriefBridge extends BridgeAbstract
             'quote' => [
                 'name' => 'Include the quote of the day',
                 'type' => 'checkbox'
+            ],
+            'mergeEverything' => [
+                'name' => 'Merge everything into one entry',
+                'type' => 'checkbox',
+                'defaultValue' => false,
+                'title' => 'Whether to merge all the stories into one entry'
             ]
         ]
     ];
@@ -61,7 +67,7 @@ class EconomistWorldInBriefBridge extends BridgeAbstract
         }
         $html = getSimpleHTMLDOM(self::URI, $headers);
         $gobbets = $html->find('p[data-component="the-world-in-brief-paragraph"]');
-        if ($this->getInput('splitGobbets') == 1) {
+        if ($this->getInput('splitGobbets') == 1 && !$this->getInput('mergeEverything')) {
             $this->splitGobbets($gobbets);
         } else {
             $this->mergeGobbets($gobbets);
@@ -77,6 +83,9 @@ class EconomistWorldInBriefBridge extends BridgeAbstract
             $quote = $html->find('blockquote[data-test-id="inspirational-quote"]', 0);
             $this->addQuote($quote);
         }
+        if ($this->getInput('mergeEverything') == 1) {
+            $this->mergeEverything();
+        }
     }
 
     private function splitGobbets($gobbets)
@@ -131,6 +140,9 @@ class EconomistWorldInBriefBridge extends BridgeAbstract
             if ($element->tag != 'div') {
                 continue;
             }
+            if ($element->find('._newsletterContentPromo', 0) != null) {
+                continue;
+            }
             $image = $element->find('figure', 0);
             $title = $element->find('h3', 0)->plaintext;
             $content = $element->find('h3', 0)->parent();
@@ -165,4 +177,35 @@ class EconomistWorldInBriefBridge extends BridgeAbstract
             'uid' => 'quote-' . $today->format('U')
         ];
     }
+
+    private function mergeEverything()
+    {
+        $today = new Datetime();
+        $today->setTime(0, 0, 0, 0);
+        $contents = '';
+
+        foreach ($this->items as $item) {
+            $header = null;
+            if (str_contains($item['uid'], 'story-')) {
+                $header = $item['title'];
+            } elseif (str_contains($item['uid'], 'quote-')) {
+                $header = 'Quote of the day';
+            } elseif (str_contains($item['uid'], 'world-in-brief-')) {
+                $header = 'World in brief';
+            }
+            if ($header != null) {
+                $contents .= "<h2>{$header}</h2>";
+            }
+            $contents .= $item['content'];
+        }
+
+        $item = [
+            'uri' => self::URI,
+            'title' => 'The Economist World in Brief ' . $today->format('d.m.Y'),
+            'content' => $contents,
+            'timestamp' => $today->format('U'),
+            'uid' => 'world-in-brief-merged' . $today->format('U')
+        ];
+        $this->items = [$item];
+    }
 }

From 0e2655fc8a136f94e49f8c93058697b185fcd41a Mon Sep 17 00:00:00 2001
From: Pavel Korytov <thexcloud@gmail.com>
Date: Mon, 6 Jan 2025 21:10:12 +0300
Subject: [PATCH 571/716] [AnthropicBridge] Add Anthropic Bridge (#4398)

* [AnthropicBridge] Add Anthropic Bridge

* [AnthropicBridge] Fix lint
---
 bridges/AnthropicBridge.php | 147 ++++++++++++++++++++++++++++++++++++
 1 file changed, 147 insertions(+)
 create mode 100644 bridges/AnthropicBridge.php

diff --git a/bridges/AnthropicBridge.php b/bridges/AnthropicBridge.php
new file mode 100644
index 00000000..1272d35f
--- /dev/null
+++ b/bridges/AnthropicBridge.php
@@ -0,0 +1,147 @@
+<?php
+
+class AnthropicBridge extends BridgeAbstract
+{
+    const MAINTAINER = 'sqrtminusone';
+    const NAME = 'Anthropic Research Bridge';
+    const URI = 'https://www.anthropic.com';
+
+    const CACHE_TIMEOUT = 3600; // 1 hour
+    const DESCRIPTION = 'Returns research publications from Anthropic';
+
+    const PARAMETERS = [
+        '' => [
+            'limit' => [
+                'name' => 'Limit',
+                'type' => 'number',
+                'required' => true,
+                'defaultValue' => 10
+            ],
+        ]
+    ];
+
+    public function collectData()
+    {
+        // Anthropic sometimes returns 500 for no reason. The contents are still there.
+        $html = $this->getHTMLIgnoreError(self::URI . '/research');
+        $limit = $this->getInput('limit');
+
+        $page_data = $this->extractPageData($html);
+        $pages = $this->parsePageData($page_data);
+        for ($i = 0; $i < min(count($pages), $limit); $i++) {
+            $page = $pages[$i];
+            $page['content'] = $this->parsePage($page['uri']);
+            $this->items[] = $page;
+        }
+    }
+
+    private function getHTMLIgnoreError($url, $ttl = null)
+    {
+        if ($ttl != null) {
+            $cacheKey = 'pages_' . $url;
+            $content = $this->cache->get($cacheKey);
+            if ($content) {
+                return str_get_html($content);
+            }
+        }
+
+        try {
+            $content = getContents($url);
+        } catch (HttpException $e) {
+            $content = $e->response->getBody();
+        }
+        if ($ttl != null) {
+            $this->cache->set($cacheKey, $content, $ttl);
+        }
+        return str_get_html($content);
+    }
+
+    private function extractPageData($html)
+    {
+        foreach ($html->find('script') as $script) {
+            $js_code = $script->innertext;
+            if (!str_starts_with($js_code, 'self.__next_f.push(')) {
+                continue;
+            }
+            $push_data = (string)json_decode(mb_substr($js_code, 22, mb_strlen($js_code) - 2 - 22));
+            $square_bracket = mb_strpos($push_data, '[');
+            $push_array = json_decode(mb_substr($push_data, $square_bracket), true);
+            if ($push_array == null || count($push_array) < 4) {
+                continue;
+            }
+            $page_data = $push_array[3];
+            if ($page_data != null && array_key_exists('page', $page_data)) {
+                return $page_data;
+            }
+        }
+    }
+
+    private function parsePageData($page_data)
+    {
+        $result = [];
+        foreach ($page_data['page']['sections'] as $section) {
+            if (
+                !array_key_exists('internalName', $section) ||
+                $section['internalName'] != 'Research Teams'
+            ) {
+                continue;
+            }
+            foreach ($section['tabPages'] as $tabPage) {
+                if ($tabPage['label'] != 'Overview') {
+                    continue;
+                }
+                foreach ($tabPage['sections'] as $section1) {
+                    if (
+                        !array_key_exists('title', $section1)
+                        || $section1['title'] != 'Publications'
+                    ) {
+                        continue;
+                    }
+                    foreach ($section1['posts'] as $post) {
+                        $enc = [];
+                        if ($post['cta'] != null && array_key_exists('url', $post['cta'])) {
+                            $enc = [$post['cta']['url']];
+                        }
+                        $result[] = [
+                            'title' => $post['title'],
+                            'timestamp' => $post['publishedOn'],
+                            'uri' => self::URI . '/research/' . $post['slug']['current'],
+                            'categories' => array_map(
+                                fn($s) => $s['label'],
+                                $post['subjects'],
+                            ),
+                            'enclosures' => $enc,
+                        ];
+                    }
+                    break;
+                }
+                break;
+            }
+            break;
+        }
+        return $result;
+    }
+
+    private function parsePage($url)
+    {
+        // Again, 500 for no reason.
+        $html = $this->getHTMLIgnoreError($url, 7 * 24 * 60 * 60);
+
+        $content = '';
+
+        // Main content
+        $main = $html->find('div[class*="PostDetail_post-detail"] > article', 0);
+
+        // Mostly YouTube videos
+        $iframes = $main->find('iframe');
+        foreach ($iframes as $iframe) {
+            $iframe->parent->removeAttribute('style');
+            $iframe->outertext = '<a href="' . $iframe->src . '">' . $iframe->src . '</a>';
+        }
+
+        $main = convertLazyLoading($main);
+        $main = defaultLinkTo($main, self::URI);
+        $content .= $main;
+        return $content;
+    }
+}

From 39ecd63f72805fda2c9733c771a64f2baef6f57a Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Tue, 7 Jan 2025 23:40:55 +0100
Subject: [PATCH 572/716] [GolemBridge.php] changed cookie (#4399)

the cookie value changed, without the new cookie it's not possible to parse the articles
---
 bridges/GolemBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/GolemBridge.php b/bridges/GolemBridge.php
index 7f59ee90..219233f4 100644
--- a/bridges/GolemBridge.php
+++ b/bridges/GolemBridge.php
@@ -53,7 +53,7 @@ class GolemBridge extends FeedExpander
         ]
     ]];
     const LIMIT = 5;
-    const HEADERS = ['Cookie: golem_consent20=simple|220101;'];
+    const HEADERS = ['Cookie: golem_consent20=simple|250101;'];
 
     public function collectData()
     {

From 776a1f47f3868ea5191b005c0eb7ed4e580c0359 Mon Sep 17 00:00:00 2001
From: vdbhb59 <60728004+vdbhb59@users.noreply.github.com>
Date: Fri, 10 Jan 2025 12:08:35 +0000
Subject: [PATCH 573/716] Update 06_Public_Hosts.md (#4401)

Updated my hosting provider & country to reflect the correct details.
---
 docs/01_General/06_Public_Hosts.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/01_General/06_Public_Hosts.md b/docs/01_General/06_Public_Hosts.md
index 7d921d20..10a9871d 100644
--- a/docs/01_General/06_Public_Hosts.md
+++ b/docs/01_General/06_Public_Hosts.md
@@ -3,7 +3,7 @@
 | Country | Address | Status |  Contact | Comment |
 |:-------:|---------|--------|----------|---------|
 | ![](https://iplookup.flagfox.net/images/h16/GB.png) | https://rss-bridge.org/bridge01 | ![](https://img.shields.io/website/https/rss-bridge.org/bridge01.svg) | [@dvikan](https://github.com/dvikan) | London, Digital Ocean|
-| ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://rssbridge.flossboxin.org.in | ![](https://img.shields.io/badge/website-up-brightgreen) | [@vdbhb59](https://github.com/vdbhb59) | Hosted with OVH SAS (Maintained in India) |
+| ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://rssbridge.flossboxin.org.in | ![](https://img.shields.io/badge/website-up-brightgreen) | [@vdbhb59](https://github.com/vdbhb59) | Hosted with Netcup Germany (Maintained in India) |
 | ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://rss-bridge.cheredeprince.net | ![](https://img.shields.io/website/https/rss-bridge.cheredeprince.net) | [@La_Bécasse](https://cheredeprince.net/contact) | Self-Hosted at home in France |
 | ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://rss-bridge.sans-nuage.fr | ![](https://img.shields.io/website/https/rss-bridge.sans-nuage.fr) | [@Alsace Réseau Neutre](https://arn-fai.net/contact) | Hosted in Alsace, France |
 | ![](https://iplookup.flagfox.net/images/h16/GB.png) | https://rss-bridge.lewd.tech | ![](https://img.shields.io/website/https/rss-bridge.lewd.tech.svg) | [@Erisa](https://github.com/Erisa) | Hosted in London, protected by Cloudflare Rate Limiting |

From 1a2c1f5bba91c747dd0aaae7985c3c558176f5e7 Mon Sep 17 00:00:00 2001
From: Pavel Korytov <thexcloud@gmail.com>
Date: Fri, 10 Jan 2025 22:28:58 +0300
Subject: [PATCH 574/716] [OllamaBridge] Add bridge (#4403)

* [OllamaBridge] Add bridge

* [OllamaBridge] Fix typo
---
 bridges/OllamaBridge.php | 61 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 bridges/OllamaBridge.php

diff --git a/bridges/OllamaBridge.php b/bridges/OllamaBridge.php
new file mode 100644
index 00000000..f93e37ce
--- /dev/null
+++ b/bridges/OllamaBridge.php
@@ -0,0 +1,61 @@
+<?php
+
+class OllamaBridge extends BridgeAbstract
+{
+    const MAINTAINER = 'sqrtminusone';
+    const NAME = 'Ollama Blog Bridge';
+    const URI = 'https://ollama.com';
+
+    const CACHE_TIMEOUT = 3600; // 1 hour
+    const DESCRIPTION = 'Returns latest blog posts from Ollama';
+
+    const PARAMETERS = [
+        '' => [
+            'limit' => [
+                'name' => 'Limit',
+                'type' => 'number',
+                'required' => true,
+                'defaultValue' => 10
+            ],
+        ]
+    ];
+
+    public function collectData()
+    {
+        $html = getSimpleHTMLDOM(self::URI . '/blog/');
+        $limit = $this->getInput('limit');
+
+        $posts = $html->find('main > section > a.group');
+        for ($i = 0; $i < min(count($posts), $limit); $i++) {
+            $post = $posts[$i];
+            $title = $post->find('h2', 0)->plaintext;
+            $date_text = $post->find('h3[datetime]', 0)->getAttribute('datetime');
+            $timestamp = (new DateTime(mb_substr($date_text, 0, 19)))->format('U');
+            $uri = self::URI . $post->getAttribute('href');
+            $this->items[] = [
+                'uri' => $uri,
+                'title' => $title,
+                'timestamp' => $timestamp,
+                'content' => $this->parsePage($uri),
+                'uid' => $uri
+            ];
+        }
+    }
+
+    private function parsePage($uri)
+    {
+        $html = getSimpleHTMLDOMCached(
+            $uri,
+            86400,
+            [],
+            [],
+            true,
+            true,
+            DEFAULT_TARGET_CHARSET,
+            false // Do not strip \n from <code> blocks
+        );
+        $contents = $html->find('main > article > section.prose', 0);
+        $contents = defaultLinkTo($contents, self::URI);
+        return $contents->innertext;
+    }
+}

From eadea242a745e2377534c6ea9f79681b2578be98 Mon Sep 17 00:00:00 2001
From: Sebastian Wolf <117176763+swofl@users.noreply.github.com>
Date: Sun, 12 Jan 2025 17:03:27 +0100
Subject: [PATCH 575/716] [FragDenStaatBridge] remove bridge, site provides
 full feed at fragdenstaat.de/artikel/feed/ (#4405)

---
 bridges/FragDenStaatBridge.php | 78 ----------------------------------
 1 file changed, 78 deletions(-)
 delete mode 100644 bridges/FragDenStaatBridge.php

diff --git a/bridges/FragDenStaatBridge.php b/bridges/FragDenStaatBridge.php
deleted file mode 100644
index aee1885c..00000000
--- a/bridges/FragDenStaatBridge.php
+++ /dev/null
@@ -1,78 +0,0 @@
-<?php
-
-class FragDenStaatBridge extends BridgeAbstract
-{
-    const MAINTAINER = 'swofl';
-    const NAME = 'FragDenStaat';
-    const URI = 'https://fragdenstaat.de';
-    const CACHE_TIMEOUT = 2 * 60 * 60; // 2h
-    const DESCRIPTION = 'Get latest blog posts from FragDenStaat Exklusiv';
-    const PARAMETERS = [ [
-        'qLimit' => [
-            'name' => 'Query Limit',
-            'title' => 'Amount of articles to query',
-            'type' => 'number',
-            'defaultValue' => 5,
-        ],
-    ] ];
-
-    protected function parseTeaser($teaser)
-    {
-        $result = [];
-
-        $header = $teaser->find('h3 > a', 0);
-        $result['title'] = $header->plaintext;
-        $result['uri'] = static::URI . $header->href;
-        $result['enclosures'] = [];
-        $result['enclosures'][] = $teaser->find('img', 0)->src;
-        $result['uid'] = hash('sha256', $result['title']);
-        $result['timestamp'] = strtotime($teaser->find('time', 0)->getAttribute('datetime'));
-
-        return $result;
-    }
-
-    public function collectData()
-    {
-        $html = getSimpleHTMLDOM(self::URI . '/artikel/exklusiv/');
-
-        $queryLimit = (int) $this->getInput('qLimit');
-        if ($queryLimit > 12) {
-            $queryLimit = 12;
-        }
-
-        $teasers = [];
-
-        $teaserElements = $html->find('article');
-
-        for ($i = 0; $i < $queryLimit; $i++) {
-            array_push($teasers, $this->parseTeaser($teaserElements[$i]));
-        }
-
-        foreach ($teasers as $article) {
-            $articleHtml = getSimpleHTMLDOMCached($article['uri'], static::CACHE_TIMEOUT * 6);
-            $articleCore = $articleHtml->find('article.blog-article', 0);
-
-            $content = '';
-
-            $lead = $articleCore->find('div.lead > p', 0)->innertext;
-
-            $content .= '<h2>' . $lead . '</h2>';
-
-            foreach ($articleCore->find('div.blog-content > p, div.blog-content > h3') as $paragraph) {
-                $content .= $paragraph->outertext;
-            }
-
-            $article['content'] = '<img src="' . $article['enclosures'][0] . '"/>' . $content;
-
-            $article['author'] = '';
-
-            foreach ($articleCore->find('a[rel="author"]') as $author) {
-                $article['author'] .= $author->innertext . ', ';
-            }
-
-            $article['author'] = rtrim($article['author'], ', ');
-
-            $this->items[] = $article;
-        }
-    }
-}

From 52145813861e84cabca2da21a79c7959829382c1 Mon Sep 17 00:00:00 2001
From: Simon Alberny <contact@simounet.net>
Date: Wed, 15 Jan 2025 20:50:56 +0100
Subject: [PATCH 576/716] Fix MondeDiplo empty date (#4407)

---
 bridges/MondeDiploBridge.php | 20 +++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/bridges/MondeDiploBridge.php b/bridges/MondeDiploBridge.php
index 7c897f8f..e47bb5ad 100644
--- a/bridges/MondeDiploBridge.php
+++ b/bridges/MondeDiploBridge.php
@@ -19,14 +19,28 @@ class MondeDiploBridge extends BridgeAbstract
 
         foreach ($html->find('div.unarticle') as $article) {
             $element = $article->parent();
-            $title = $element->find('h3', 0)->plaintext;
-            $datesAuteurs = $element->find('div.dates_auteurs', 0)->plaintext;
+            $titleElement = $element->find('h3', 0);
+            if (!$titleElement) {
+                continue;
+            }
+            $title = $titleElement->plaintext;
+            $datesAuteursElement = $element->find('div.dates_auteurs', 0);
+            $datesAuteurs = is_null($datesAuteursElement) ? '' : $element->find('div.dates_auteurs', 0)->plaintext;
             $item = [];
             $item['uri'] = urljoin(self::URI, $element->href);
-            $item['title'] = $this->cleanText($title) . ' - ' . $this->cleanText($datesAuteurs);
+            $item['title'] = $this->getItemTitle($title, $datesAuteurs);
             $item['content'] = $this->cleanText(str_replace([$title, $datesAuteurs], '', $element->plaintext));
 
             $this->items[] = $item;
         }
     }
+
+    private function getItemTitle($title, $datesAuteurs)
+    {
+        $itemTitle = $this->cleanText($title);
+        if (strlen($datesAuteurs) > 0) {
+            $itemTitle .= ' - ' . $this->cleanText($datesAuteurs);
+        }
+        return $itemTitle;
+    }
 }

From 2a58f82bd8aa995c263feb64329a6839afaa3b5c Mon Sep 17 00:00:00 2001
From: axor-mst <1163219+axor-mst@users.noreply.github.com>
Date: Mon, 20 Jan 2025 17:32:41 +0100
Subject: [PATCH 577/716] [Formula1Bridge] API key and URL format update
 (#4412)

* [Formula1Bridge] API key and URL format update

* [WorldCosplayBridge] Bridge removal
---
 CONTRIBUTORS.md                |   2 +-
 bridges/Formula1Bridge.php     |  12 ++-
 bridges/WorldCosplayBridge.php | 149 ---------------------------------
 3 files changed, 9 insertions(+), 154 deletions(-)
 delete mode 100644 bridges/WorldCosplayBridge.php

diff --git a/CONTRIBUTORS.md b/CONTRIBUTORS.md
index 922d9453..ec05a2bd 100644
--- a/CONTRIBUTORS.md
+++ b/CONTRIBUTORS.md
@@ -15,7 +15,7 @@
 * [Astalaseven](https://github.com/Astalaseven)
 * [Astyan-42](https://github.com/Astyan-42)
 * [austinhuang0131](https://github.com/austinhuang0131)
-* [AxorPL](https://github.com/AxorPL)
+* [axor-mst](https://github.com/axor-mst)
 * [ayacoo](https://github.com/ayacoo)
 * [az5he6ch](https://github.com/az5he6ch)
 * [b1nj](https://github.com/b1nj)
diff --git a/bridges/Formula1Bridge.php b/bridges/Formula1Bridge.php
index f84b1ca7..19a84e2e 100644
--- a/bridges/Formula1Bridge.php
+++ b/bridges/Formula1Bridge.php
@@ -5,13 +5,13 @@ class Formula1Bridge extends BridgeAbstract
     const NAME = 'Formula1 Bridge';
     const URI = 'https://formula1.com/';
     const DESCRIPTION = 'Returns latest official Formula 1 news';
-    const MAINTAINER = 'AxorPL';
+    const MAINTAINER = 'axor-mst';
 
-    const API_KEY = 'qPgPPRJyGCIPxFT3el4MF7thXHyJCzAP';
+    const API_KEY = 'xZ7AOODSjiQadLsIYWefQrpCSQVDbHGC';
     const API_URL = 'https://api.formula1.com/v1/editorial/articles?limit=%u';
 
     const ARTICLE_AUTHOR = 'Formula 1';
-    const ARTICLE_URL = 'https://formula1.com/en/latest/article.%s.%s.html';
+    const ARTICLE_URL = 'https://formula1.com/en/latest/article/%s.%s';
 
     const LIMIT_MIN = 1;
     const LIMIT_DEFAULT = 10;
@@ -36,7 +36,11 @@ class Formula1Bridge extends BridgeAbstract
         $limit = min(self::LIMIT_MAX, max(self::LIMIT_MIN, $limit));
         $url = sprintf(self::API_URL, $limit);
 
-        $json = json_decode(getContents($url, ['apikey: ' . self::API_KEY]));
+        $json = json_decode(getContents($url, [
+            'Accept: application/json',
+            'apikey: ' . self::API_KEY,
+            'locale: en'
+        ]));
         if (property_exists($json, 'error')) {
             returnServerError($json->message);
         }
diff --git a/bridges/WorldCosplayBridge.php b/bridges/WorldCosplayBridge.php
deleted file mode 100644
index 721c545f..00000000
--- a/bridges/WorldCosplayBridge.php
+++ /dev/null
@@ -1,149 +0,0 @@
-<?php
-
-class WorldCosplayBridge extends BridgeAbstract
-{
-    const NAME = 'WorldCosplay Bridge';
-    const URI = 'https://worldcosplay.net/';
-    const DESCRIPTION = 'Returns WorldCosplay photos';
-    const MAINTAINER = 'AxorPL';
-
-    const API_CHARACTER = 'api/photo/list.json?character_id=%u&limit=%u';
-    const API_COSPLAYER = 'api/member/photos.json?member_id=%u&limit=%u';
-    const API_SERIES = 'api/photo/list.json?title_id=%u&limit=%u';
-    const API_TAG = 'api/tag/photo_list.json?id=%u&limit=%u';
-
-    const CONTENT_HTML
-        = '<a href="%s" target="_blank"><img src="%s" alt="%s" title="%s"></a>';
-
-    const ERR_CONTEXT = 'No context provided';
-    const ERR_QUERY = 'Unable to query: %s';
-
-    const LIMIT_MIN = 1;
-    const LIMIT_MAX = 24;
-
-    const PARAMETERS = [
-        'Character' => [
-            'cid' => [
-                'name' => 'Character ID',
-                'type' => 'number',
-                'required' => true,
-                'title' => 'WorldCosplay character ID',
-                'exampleValue' => 18204
-            ]
-        ],
-        'Cosplayer' => [
-            'uid' => [
-                'name' => 'Cosplayer ID',
-                'type' => 'number',
-                'required' => true,
-                'title' => 'Cosplayer\'s WorldCosplay profile ID',
-                'exampleValue' => 406782
-            ]
-        ],
-        'Series' => [
-            'sid' => [
-                'name' => 'Series ID',
-                'type' => 'number',
-                'required' => true,
-                'title' => 'WorldCosplay series ID',
-                'exampleValue' => 3139
-            ]
-        ],
-        'Tag' => [
-            'tid' => [
-                'name' => 'Tag ID',
-                'type' => 'number',
-                'required' => true,
-                'title' => 'WorldCosplay tag ID',
-                'exampleValue' => 33643
-            ]
-        ],
-        'global' => [
-            'limit' => [
-                'name' => 'Limit',
-                'type' => 'number',
-                'required' => false,
-                'title' => 'Maximum number of photos to return',
-                'exampleValue' => 5,
-                'defaultValue' => 5
-            ]
-        ]
-    ];
-
-    public function collectData()
-    {
-        $limit = $this->getInput('limit');
-        $limit = min(self::LIMIT_MAX, max(self::LIMIT_MIN, $limit));
-        switch ($this->queriedContext) {
-            case 'Character':
-                $id = $this->getInput('cid');
-                $url = self::API_CHARACTER;
-                break;
-            case 'Cosplayer':
-                $id = $this->getInput('uid');
-                $url = self::API_COSPLAYER;
-                break;
-            case 'Series':
-                $id = $this->getInput('sid');
-                $url = self::API_SERIES;
-                break;
-            case 'Tag':
-                $id = $this->getInput('tid');
-                $url = self::API_TAG;
-                break;
-            default:
-                returnClientError(self::ERR_CONTEXT);
-        }
-        $url = self::URI . sprintf($url, $id, $limit);
-
-        $json = json_decode(getContents($url));
-        if ($json->has_error) {
-            returnServerError($json->message);
-        }
-        $list = $json->list;
-
-        foreach ($list as $img) {
-            $image = $img->photo ?? $img;
-            $item = [
-                'uri' => self::URI . substr($image->url, 1),
-                'title' => $image->subject,
-                'author' => $img->member->global_name,
-                'enclosures' => [$image->large_url],
-                'uid' => $image->id,
-            ];
-            // Context cosplayer don't have created_at
-            if (isset($image->created_at)) {
-                $item['timestamp'] = $image->created_at;
-            }
-            $item['content'] = sprintf(
-                self::CONTENT_HTML,
-                $item['uri'],
-                $item['enclosures'][0],
-                $item['title'],
-                $item['title']
-            );
-            $this->items[] = $item;
-        }
-    }
-
-    public function getName()
-    {
-        switch ($this->queriedContext) {
-            case 'Character':
-                $id = $this->getInput('cid');
-                break;
-            case 'Cosplayer':
-                $id = $this->getInput('uid');
-                break;
-            case 'Series':
-                $id = $this->getInput('sid');
-                break;
-            case 'Tag':
-                $id = $this->getInput('tid');
-                break;
-            default:
-                return parent::getName();
-        }
-        return sprintf('%s %u - ', $this->queriedContext, $id) . self::NAME;
-    }
-}

From 028acd0af1d3b5d9788357ee687c0119395afa20 Mon Sep 17 00:00:00 2001
From: Eugene Molotov <eugene.molotov@yandex.ru>
Date: Sat, 25 Jan 2025 21:27:36 +0500
Subject: [PATCH 578/716] [VkBridge] Unassign maintainer (#4418)

---
 bridges/VkBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/VkBridge.php b/bridges/VkBridge.php
index 0d62305b..11cfca5d 100644
--- a/bridges/VkBridge.php
+++ b/bridges/VkBridge.php
@@ -2,7 +2,7 @@
 
 class VkBridge extends BridgeAbstract
 {
-    const MAINTAINER = 'em92';
+    // const MAINTAINER = 'em92';
     // const MAINTAINER = 'pmaziere';
     // const MAINTAINER = 'ahiles3005';
     const NAME = 'VK.com';

From 58b3cfb158077db359e1ab53758e06357ed9af5f Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 25 Jan 2025 17:43:03 +0100
Subject: [PATCH 579/716] fix: drop extension requirement in feed icon url, fix
 #4416 (#4421)

---
 formats/MrssFormat.php | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/formats/MrssFormat.php b/formats/MrssFormat.php
index f7b11949..4066ec73 100644
--- a/formats/MrssFormat.php
+++ b/formats/MrssFormat.php
@@ -80,14 +80,8 @@ class MrssFormat extends FormatAbstract
                 $feedUrl = get_current_url();
                 $linkSelf->setAttribute('href', $feedUrl);
             } elseif ($feedKey === 'icon') {
-                $allowedIconExtensions = [
-                    '.gif',
-                    '.jpg',
-                    '.png',
-                    '.ico',
-                ];
                 $icon = $feedValue;
-                if ($icon && in_array(substr($icon, -4), $allowedIconExtensions)) {
+                if ($icon) {
                     $feedImage = $document->createElement('image');
                     $channel->appendChild($feedImage);
                     $iconUrl = $document->createElement('url');

From 952a2d99a338026af2a5f539c92cc420912867ea Mon Sep 17 00:00:00 2001
From: SebLaus <97241865+SebLaus@users.noreply.github.com>
Date: Sat, 25 Jan 2025 18:28:36 +0100
Subject: [PATCH 580/716] Beginning of URL not needed anymore:  ErrorMessage:
 cURL error Could not resolve host: www.bundestag.dehttps: 6
 (https://curl.haxx.se/libcurl/c/libcurl-errors.html) for
 https://www.bundestag.dehttps://www.bundestag.de/parlament/praesidium/parteienfinanzierung/fundstellen50000/2025/2025-inhalt-1032412
 (#4420)

---
 bridges/BundestagParteispendenBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/BundestagParteispendenBridge.php b/bridges/BundestagParteispendenBridge.php
index 30817d96..773f9129 100644
--- a/bridges/BundestagParteispendenBridge.php
+++ b/bridges/BundestagParteispendenBridge.php
@@ -32,7 +32,7 @@ URI;
         $firstAnchor = $html->find('a', 0)
             or returnServerError('Could not find the proper HTML element.');
 
-        $url = 'https://www.bundestag.de' . $firstAnchor->href;
+        $url = $firstAnchor->href;
 
         // Get the actual page with the soft money donations
         $html = getSimpleHTMLDOMCached($url, self::CACHE_TIMEOUT);

From dd8bc077edc5b1af664b4fae9d63a16467e02c17 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 25 Jan 2025 18:29:01 +0100
Subject: [PATCH 581/716] feat(FeedParser): recursively parse rss modules
 (#4422)

Also stop excluding the media module

fix #4415
---
 lib/FeedParser.php       | 12 ++++--
 tests/FeedParserTest.php | 79 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 88 insertions(+), 3 deletions(-)

diff --git a/lib/FeedParser.php b/lib/FeedParser.php
index 0ad90965..3b133b85 100644
--- a/lib/FeedParser.php
+++ b/lib/FeedParser.php
@@ -174,7 +174,7 @@ final class FeedParser
         }
 
         foreach ($namespaces as $namespaceName => $namespaceUrl) {
-            if (in_array($namespaceName, ['', 'content', 'media'])) {
+            if (in_array($namespaceName, ['', 'content'])) {
                 continue;
             }
             $item[$namespaceName] = $this->parseModule($feedItem, $namespaceName, $namespaceUrl);
@@ -250,11 +250,17 @@ final class FeedParser
 
     private function parseModule(\SimpleXMLElement $element, string $namespaceName, string $namespaceUrl): array
     {
+        // Unfortunately this parses out only node values as string
+        // TODO: parse attributes too
+
         $result = [];
         $module = $element->children($namespaceUrl);
         foreach ($module as $name => $value) {
-            // todo: add custom parsing if it's something other than a string
-            $result[$name] = (string) $value;
+            if (get_class($value) === 'SimpleXMLElement' && $value->count() !== 0) {
+                $result[$name] = $this->parseModule($value, $namespaceName, $namespaceUrl);
+            } else {
+                $result[$name] = (string) $value;
+            }
         }
         return $result;
     }
diff --git a/tests/FeedParserTest.php b/tests/FeedParserTest.php
index 45dc1234..458bdb53 100644
--- a/tests/FeedParserTest.php
+++ b/tests/FeedParserTest.php
@@ -183,4 +183,83 @@ class FeedParserTest extends TestCase
         ];
         $this->assertEquals($expected, $feed);
     }
+
+    public function testYoutubeMediaModule()
+    {
+        $xml = <<<XML
+        <?xml version="1.0" encoding="UTF-8"?>
+        <feed xmlns:yt="http://www.youtube.com/xml/schemas/2015" xmlns:media="http://search.yahoo.com/mrss/" xmlns="http://www.w3.org/2005/Atom">
+         <link rel="self" href="http://www.youtube.com/feeds/videos.xml?channel_id=UCuCkxoKLYO_EQ2GeFtbM_bw"/>
+         <id>yt:channel:uCkxoKLYO_EQ2GeFtbM_bw</id>
+         <yt:channelId>uCkxoKLYO_EQ2GeFtbM_bw</yt:channelId>
+         <title>Half as Interesting</title>
+         <link rel="alternate" href="https://www.youtube.com/channel/UCuCkxoKLYO_EQ2GeFtbM_bw"/>
+         <author>
+          <name>Half as Interesting</name>
+          <uri>https://www.youtube.com/channel/UCuCkxoKLYO_EQ2GeFtbM_bw</uri>
+         </author>
+         <published>2017-08-26T20:06:05+00:00</published>
+         <entry>
+          <id>yt:video:Upjg7F28DJw</id>
+          <yt:videoId>Upjg7F28DJw</yt:videoId>
+          <yt:channelId>UCuCkxoKLYO_EQ2GeFtbM_bw</yt:channelId>
+          <title>The Nuke-Proof US Military Base in a Mountain</title>
+          <link rel="alternate" href="https://www.youtube.com/watch?v=Upjg7F28DJw"/>
+          <author>
+           <name>Half as Interesting</name>
+           <uri>https://www.youtube.com/channel/UCuCkxoKLYO_EQ2GeFtbM_bw</uri>
+          </author>
+          <published>2025-01-24T15:44:18+00:00</published>
+          <updated>2025-01-25T06:55:19+00:00</updated>
+          <media:group>
+           <media:title>The Nuke-Proof US Military Base in a Mountain</media:title>
+           <media:content url="https://www.youtube.com/v/Upjg7F28DJw?version=3" type="application/x-shockwave-flash" width="640" height="390"/>
+           <media:thumbnail url="https://i2.ytimg.com/vi/Upjg7F28DJw/hqdefault.jpg" width="480" height="360"/>
+           <media:description>Receive 10% off anything on bellroy.com: https://bit.ly/3HdOWu9</media:description>
+           <media:community>
+            <media:starRating count="10157" average="5.00" min="1" max="5"/>
+            <media:statistics views="228462"/>
+           </media:community>
+          </media:group>
+         </entry>
+        </feed>
+        XML;
+
+        $feed = $this->sut->parseFeed($xml);
+        $expected = [
+            'title' => 'Half as Interesting',
+            'uri' => 'https://www.youtube.com/channel/UCuCkxoKLYO_EQ2GeFtbM_bw',
+            'icon' => null,
+            'items' => [
+                [
+                    'uri' => 'https://www.youtube.com/watch?v=Upjg7F28DJw',
+                    'title' => 'The Nuke-Proof US Military Base in a Mountain',
+                    'content' => '',
+                    'timestamp' => 1737788119,
+                    'author' => 'Half as Interesting',
+                    'id' => 'yt:video:Upjg7F28DJw',
+                    'published' => '2025-01-24T15:44:18+00:00',
+                    'updated' => '2025-01-25T06:55:19+00:00',
+                    'link' => '',
+                    'yt' => [
+                        'videoId' => 'Upjg7F28DJw',
+                        'channelId' => 'UCuCkxoKLYO_EQ2GeFtbM_bw',
+                    ],
+                    'media' => [
+                        'group' => [
+                            'title' => 'The Nuke-Proof US Military Base in a Mountain',
+                            'content' => '',
+                            'thumbnail' => '',
+                            'description' => 'Receive 10% off anything on bellroy.com: https://bit.ly/3HdOWu9',
+                            'community' => [
+                                'starRating' => '',
+                                'statistics' => '',
+                            ],
+                        ],
+                    ],
+                ]
+            ],
+        ];
+        $this->assertEquals($expected, $feed);
+    }
 }

From bd7d1734c35e771ab62c89afd6a8e2dfb89bacfa Mon Sep 17 00:00:00 2001
From: Eugene Molotov <eugene.molotov@yandex.ru>
Date: Sat, 25 Jan 2025 22:40:13 +0500
Subject: [PATCH 582/716] [RutubeBridge] Use publication time instead of
 creation time (#4417)

Publication time is shown in video page itself, so it is more essential
---
 bridges/RutubeBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/RutubeBridge.php b/bridges/RutubeBridge.php
index 6e48c27a..ba8ddde4 100644
--- a/bridges/RutubeBridge.php
+++ b/bridges/RutubeBridge.php
@@ -132,7 +132,7 @@ class RutubeBridge extends BridgeAbstract
                     $video->description . ' '
                 )
             );
-            $item['timestamp'] = $video->created_ts;
+            $item['timestamp'] = $video->publication_ts;
             $item['author'] = $video->author->name;
             $item['content'] = $content;
 

From 230edf602e47754b35f4212336c354fdd032359c Mon Sep 17 00:00:00 2001
From: Bartosz Sosna <brtsos@gmail.com>
Date: Sat, 25 Jan 2025 18:43:27 +0100
Subject: [PATCH 583/716] Add lfc.pl bridge (#4419)

* Add lfc.pl bridge

* Adjust bridge

* Add comments section
---
 bridges/LfcPlBridge.php | 110 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 110 insertions(+)
 create mode 100644 bridges/LfcPlBridge.php

diff --git a/bridges/LfcPlBridge.php b/bridges/LfcPlBridge.php
new file mode 100644
index 00000000..9b199a10
--- /dev/null
+++ b/bridges/LfcPlBridge.php
@@ -0,0 +1,110 @@
+<?php
+
+class LfcPlBridge extends BridgeAbstract
+{
+    const NAME = 'LFC (lfc.pl)';
+    const DESCRIPTION = 'LFC.pl - największa polska strona o Liverpool FC';
+    const URI = 'https://lfc.pl';
+    const MAINTAINER = 'brtsos';
+    const PARAMETERS = [
+        [
+            'comments' => [
+                'type' => 'list',
+                'name' => 'Include comments',
+                'title' => 'Include comments in the article content',
+                'values' => [
+                    'No' => 'no',
+                    'Yes' => 'yes',
+                ],
+            ]
+        ]
+    ];
+
+    public function collectData()
+    {
+        $dom = getSimpleHTMLDOM(self::URI . '/Archiwum/' . date('Y') . date('m'));
+
+        $list = $dom->find('#page .list-vertical li');
+        $list = array_reverse($list);
+        $list = array_slice($list, 0, 10);
+
+        foreach ($list as $li) {
+            $link = $li->find('a', 0);
+            $url = self::URI . $link->href;
+
+            $articleDom = getSimpleHTMLDOM($url);
+
+            $description = $this->getContent($articleDom);
+            if (mb_strpos($description, 'Artykuł sponsorowany') !== false) {
+                continue;
+            }
+
+            $image = '<img src="' . $this->getImage($articleDom) . '" alt="' . $link->plaintext . '" />';
+
+            $content = $image . '</br>' . $description;
+
+            $tagsToRemove = ['script', 'iframe', 'input', 'form'];
+            $content = sanitize($content, $tagsToRemove);
+
+            $footerArticle = $articleDom->find('.footer', 0)->find('.item', 0)->find('div', 1);
+            $author = $footerArticle->find('a', 0)->plaintext;
+
+            $dateTime = $footerArticle->find('div', 0)->plaintext;
+            $date = DateTime::createFromFormat('d.m.Y H:i', $dateTime);
+            $timestamp = $date->getTimestamp();
+            $this->items[] = [
+                'title' => $link->plaintext,
+                'uri' => $url,
+                'timestamp' => $timestamp,
+                'content' => $content,
+                'author' => $author,
+            ];
+        }
+    }
+
+    private function getContent($article)
+    {
+        $content = $article->find('.news-body', 0)->innertext;
+        $commentsHtml = $article->find('#comments', 0);
+
+        $comments = '';
+        if ($this->withComment()) {
+            if ($commentsHtml) {
+                $commentsDom = $commentsHtml->find('.comment');
+
+                if (count($commentsDom) > 0) {
+                    $comments = '<h3>Komentarze:</h3>';
+                }
+
+                foreach ($commentsDom as $comment) {
+                    $header = $comment->find('.header', 0)->plaintext;
+                    $content = $comment->find('.content', 0)->plaintext;
+                    $comments .= $header . '<br />' . $content . '<br /><br />';
+                }
+            }
+        }
+
+        return $content . '<br /> <br />' . $comments;
+    }
+
+    private function getImage($article): ?string
+    {
+        $imgElement = $article->find('#news .img', 0);
+        if ($imgElement) {
+            $style = $imgElement->style;
+
+            if (preg_match('/background-image:\s*url\(([^)]+)\)/i', $style, $matches)) {
+                return self::URI . trim($matches[1], "'\"");
+            }
+
+            return null;
+        }
+
+        return null;
+    }
+
+    private function withComment(): bool
+    {
+        return $this->getInput('comments') === 'yes';
+    }
+}
\ No newline at end of file

From 8b1ba003a8e46bda757e3fad8971d182d5dcca79 Mon Sep 17 00:00:00 2001
From: burrow335 <190633847+burrow335@users.noreply.github.com>
Date: Sat, 25 Jan 2025 18:46:12 +0100
Subject: [PATCH 584/716] Add support for custom feeds in posts (#4413)

---
 bridges/BlueskyBridge.php | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/bridges/BlueskyBridge.php b/bridges/BlueskyBridge.php
index 89e5f3bc..67bb5af9 100644
--- a/bridges/BlueskyBridge.php
+++ b/bridges/BlueskyBridge.php
@@ -255,6 +255,10 @@ class BlueskyBridge extends BridgeAbstract
                     $description .= '<a href="' . $uri_reconstructed . '">Quoted post detached.</a>';
                 } elseif (isset($quotedRecord['blocked']) && $quotedRecord['blocked']) { //blocked by quote author
                     $description .= 'Author of quoted post has blocked OP.';
+                } elseif (($quotedRecord['$type'] ?? '') === 'app.bsky.feed.defs#generatorView') {
+                    $description .= '</p>';
+                    $description .= $this->getGeneratorViewDescription($quotedRecord);
+                    $description .= '<p>';
                 } else {
                     $quotedAuthorDid = $quotedRecord['author']['did'];
                     $quotedDisplayName = $quotedRecord['author']['displayName'] ?? '';
@@ -399,6 +403,10 @@ class BlueskyBridge extends BridgeAbstract
                         $description .= '<a href="' . $uri_reconstructed . '">Quoted post detached.</a>';
                     } elseif (isset($replyQuotedRecord['blocked']) && $replyQuotedRecord['blocked']) { //blocked by quote author
                         $description .= 'Author of quoted post has blocked OP.';
+                    } elseif (($replyQuotedRecord['$type'] ?? '') === 'app.bsky.feed.defs#generatorView') {
+                        $description .= '</p>';
+                        $description .= $this->getGeneratorViewDescription($replyQuotedRecord);
+                        $description .= '<p>';
                     } else {
                         $quotedAuthorDid = $replyQuotedRecord['author']['did'];
                         $quotedDisplayName = $replyQuotedRecord['author']['displayName'] ?? '';
@@ -584,4 +592,29 @@ class BlueskyBridge extends BridgeAbstract
         $response = json_decode(getContents($uri), true);
         return $response;
     }
+
+    private function getGeneratorViewDescription(array $record): string
+    {
+        $avatar = e($record['avatar']);
+        $displayName = e($record['displayName']);
+        $displayHandle = e($record['creator']['handle']);
+        $likeCount = e($record['likeCount']);
+        preg_match('/\/([^\/]+)$/', $record['uri'], $matches);
+        $uri = e('https://bsky.app/profile/' . $record['creator']['did'] . '/feed/' . $matches[1]);
+
+        return <<<END
+<a href="{$uri}" style="color: inherit;">
+    <div style="border: 1px solid #333; padding: 10px;">
+        <div style="display: flex; margin-bottom: 10px;">
+            <img src="{$avatar}" height="50" width="50" style="margin-right: 10px;">
+            <div style="display: flex; flex-direction: column; justify-content: center;">
+                <h3>{$displayName}</h3>
+                <span>Feed by @{$displayHandle}</span>
+            </div>
+        </div>
+        <span>Liked by {$likeCount} users</span>
+    </div>
+</a>
+END;
+    }
 }

From 4da61b7922d0b93133a4ef74dd128864da64193f Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 26 Jan 2025 11:16:35 +0100
Subject: [PATCH 585/716] chore: prepare 2025-01-26 release (#4424)

---
 README.md              | 32 ++++++++++++++------------------
 config.default.ini.php | 13 ++++---------
 lib/Configuration.php  |  2 +-
 3 files changed, 19 insertions(+), 28 deletions(-)

diff --git a/README.md b/README.md
index b3b12f0e..b813abf7 100644
--- a/README.md
+++ b/README.md
@@ -29,7 +29,7 @@ Requires minimum PHP 7.4.
 |![Screenshot #3](/static/screenshot-3.png?raw=true)|![Screenshot #4](/static/screenshot-4.png?raw=true)|
 |![Screenshot #5](/static/screenshot-5.png?raw=true)|![Screenshot #6](/static/screenshot-6.png?raw=true)|
 
-## A subset of bridges (16/447)
+## A subset of bridges (15/447)
 
 * `CssSelectorBridge`: [Scrape out a feed using CSS selectors](https://rss-bridge.org/bridge01/#bridge-CssSelectorBridge)
 * `FeedMergeBridge`: [Combine multiple feeds into one](https://rss-bridge.org/bridge01/#bridge-FeedMergeBridge)
@@ -44,7 +44,6 @@ Requires minimum PHP 7.4.
 * `ThePirateBayBridge:` [Fetches torrents by search/user/category](https://rss-bridge.org/bridge01/#bridge-ThePirateBayBridge)
 * `TikTokBridge`: [Fetches posts by username](https://rss-bridge.org/bridge01/#bridge-TikTokBridge)
 * `TwitchBridge`: [Fetches videos from channel](https://rss-bridge.org/bridge01/#bridge-TwitchBridge)
-* `VkBridge`: [Fetches posts from user/group](https://rss-bridge.org/bridge01/#bridge-VkBridge)
 * `XPathBridge`: [Scrape out a feed using XPath expressions](https://rss-bridge.org/bridge01/#bridge-XPathBridge)
 * `YoutubeBridge`: [Fetches videos by username/channel/playlist/search](https://rss-bridge.org/bridge01/#bridge-YoutubeBridge)
 * `YouTubeCommunityTabBridge`: [Fetches posts from a channel's community tab](https://rss-bridge.org/bridge01/#bridge-YouTubeCommunityTabBridge)
@@ -72,27 +71,27 @@ useradd --shell /bin/bash --create-home rss-bridge
 
 cd /var/www
 
-# Create folder and change ownership
+# Create folder and change its ownership to rss-bridge
 mkdir rss-bridge && chown rss-bridge:rss-bridge rss-bridge/
 
-# Become user
+# Become rss-bridge
 su rss-bridge
 
-# Fetch latest master
+# Clone master branch into existing folder
 git clone https://github.com/RSS-Bridge/rss-bridge.git rss-bridge/
 cd rss-bridge
 
-# Copy over the default config
+# Copy over the default config (OPTIONAL)
 cp -v config.default.ini.php config.ini.php
 
-# Give full permissions only to owner (rss-bridge)
-chmod 700 -R ./
+# Recursively give full permissions to user/owner
+chmod 700 --recursive ./
 
-# Give read and execute to others (nginx and php-fpm)
+# Give read and execute to others on folder ./static
 chmod o+rx ./ ./static
 
-# Give read to others (nginx)
-chmod o+r -R ./static
+# Recursively give give read to others on folder ./static
+chmod o+r --recursive ./static
 ```
 
 Nginx config:
@@ -110,17 +109,14 @@ server {
     error_log /var/log/nginx/rss-bridge.error.log;
     log_not_found off;
 
-    # Intentionally not setting a root folder here
-
-    # autoindex is off by default but feels good to explicitly turn off
-    autoindex off;
+    # Intentionally not setting a root folder
 
     # Static content only served here
     location /static/ {
         alias /var/www/rss-bridge/static/;
     }
 
-    # Pass off to php-fpm when location is exactly /
+    # Pass off to php-fpm only when location is EXACTLY == /
     location = / {
         root /var/www/rss-bridge/;
         include snippets/fastcgi-php.conf;
@@ -128,12 +124,12 @@ server {
         fastcgi_pass unix:/run/php/rss-bridge.sock;
     }
 
-    # Reduce spam
+    # Reduce log noise
     location = /favicon.ico {
         access_log off;
     }
 
-    # Reduce spam
+    # Reduce log noise
     location = /robots.txt {
         access_log off;
     }
diff --git a/config.default.ini.php b/config.default.ini.php
index 25f35508..886878a2 100644
--- a/config.default.ini.php
+++ b/config.default.ini.php
@@ -21,20 +21,15 @@
 ;enabled_bridges[] = ThePirateBay
 ;enabled_bridges[] = TikTokBridge
 ;enabled_bridges[] = Twitch
-;enabled_bridges[] = Vk
 ;enabled_bridges[] = XPathBridge
 ;enabled_bridges[] = Youtube
 ;enabled_bridges[] = YouTubeCommunityTabBridge
 enabled_bridges[] = *
 
-; Defines the timezone used by RSS-Bridge
-; Find a list of supported timezones at
-; https://www.php.net/manual/en/timezones.php
-; timezone = "UTC" (default)
 timezone = "UTC"
 
 ; Display a system message to users.
-message = ""
+;message = "Hello world"
 
 ; Whether to enable debug mode.
 enable_debug_mode = false
@@ -52,12 +47,12 @@ max_file_size = 10000000
 [http]
 
 ; Operation timeout in seconds
-timeout = 15
+timeout = 5
 
 ; Operation retry count in case of curl error
-retries = 2
+retries = 1
 
-; User agent
+; Curl user agent
 useragent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Firefox/102.0"
 
 ; Max http response size in MB
diff --git a/lib/Configuration.php b/lib/Configuration.php
index c0cfe0c2..60bf80fb 100644
--- a/lib/Configuration.php
+++ b/lib/Configuration.php
@@ -7,7 +7,7 @@
  */
 final class Configuration
 {
-    private const VERSION = '2025-01-02';
+    private const VERSION = '2025-01-26';
 
     private static $config = [];
 

From ae8394d976623fcda5313274e6257b3161607579 Mon Sep 17 00:00:00 2001
From: Bartosz Sosna <brtsos@gmail.com>
Date: Sun, 26 Jan 2025 18:58:03 +0100
Subject: [PATCH 586/716] Fix lfc.pl bug with page content when comments exist
 (#4425)

* Add lfc.pl bridge

* Adjust bridge

* Add comments section

* Fix a bug with page content when comments exist

* Add brtsos to CONTRIBUTORS.md
---
 CONTRIBUTORS.md         | 1 +
 bridges/LfcPlBridge.php | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/CONTRIBUTORS.md b/CONTRIBUTORS.md
index ec05a2bd..d27421aa 100644
--- a/CONTRIBUTORS.md
+++ b/CONTRIBUTORS.md
@@ -23,6 +23,7 @@
 * [Binnette](https://github.com/Binnette)
 * [BoboTiG](https://github.com/BoboTiG)
 * [Bockiii](https://github.com/Bockiii)
+* [brtsos](https://github.com/brtsos)
 * [captn3m0](https://github.com/captn3m0)
 * [chemel](https://github.com/chemel)
 * [Chouchen](https://github.com/Chouchen)
diff --git a/bridges/LfcPlBridge.php b/bridges/LfcPlBridge.php
index 9b199a10..dd74205d 100644
--- a/bridges/LfcPlBridge.php
+++ b/bridges/LfcPlBridge.php
@@ -78,8 +78,8 @@ class LfcPlBridge extends BridgeAbstract
 
                 foreach ($commentsDom as $comment) {
                     $header = $comment->find('.header', 0)->plaintext;
-                    $content = $comment->find('.content', 0)->plaintext;
-                    $comments .= $header . '<br />' . $content . '<br /><br />';
+                    $commentContent = $comment->find('.content', 0)->plaintext;
+                    $comments .= $header . '<br />' . $commentContent . '<br /><br />';
                 }
             }
         }

From 824ac5e373563ac481a96c2b9d40999747654a48 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sun, 26 Jan 2025 21:24:33 +0100
Subject: [PATCH 587/716] docs (#4427)

* docs

* docs
---
 .github/ISSUE_TEMPLATE/bridge-request.md | 4 ++--
 README.md                                | 5 ++---
 config.default.ini.php                   | 2 +-
 lib/contents.php                         | 4 +---
 templates/frontpage.html.php             | 2 +-
 5 files changed, 7 insertions(+), 10 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bridge-request.md b/.github/ISSUE_TEMPLATE/bridge-request.md
index 174dc095..088cc3d6 100644
--- a/.github/ISSUE_TEMPLATE/bridge-request.md
+++ b/.github/ISSUE_TEMPLATE/bridge-request.md
@@ -49,9 +49,9 @@ Please describe what you expect from the bridge. Whenever possible provide sampl
   - _Default limit_: 5
 - [ ] Load full articles
   - _Cache articles_ (articles are stored in a local cache on first request): yes
-  - _Cache timeout_ (max = 24 hours): 24 hours
+  - _Cache timeout_ : 24 hours
 - [X] Balance requests (RSS-Bridge uses cached versions to reduce bandwith usage)
-  - _Timeout_ (default = 5 minutes, max = 24 hours): 5 minutes
+  - _Timeout_ (default = 5 minutes): 5 minutes
 
 <!--Be aware that some options might not be available for your specific request due to technical limitations!-->
 
diff --git a/README.md b/README.md
index b813abf7..dadf7094 100644
--- a/README.md
+++ b/README.md
@@ -150,11 +150,11 @@ listen = /run/php/rss-bridge.sock
 listen.owner = www-data
 listen.group = www-data
 
-# Create 10 workers standing by to serve requests
+; Create 10 workers standing by to serve requests
 pm = static
 pm.max_children = 10
 
-# Respawn worker after 500 requests (workaround for memory leaks etc.) 
+; Respawn worker after 500 requests (workaround for memory leaks etc.)
 pm.max_requests = 500
 ```
 
@@ -460,7 +460,6 @@ See [CONTRIBUTORS.md](CONTRIBUTORS.md)
 
 RSS-Bridge uses caching to prevent services from banning your server for repeatedly updating feeds.
 The specific cache duration can be different between bridges.
-Cached files are deleted automatically after 24 hours.
 
 RSS-Bridge allows you to take full control over which bridges are displayed to the user.
 That way you can host your own RSS-Bridge service with your favorite collection of bridges!
diff --git a/config.default.ini.php b/config.default.ini.php
index 886878a2..6d646fd5 100644
--- a/config.default.ini.php
+++ b/config.default.ini.php
@@ -75,7 +75,7 @@ custom_timeout = false
 ; ""    = Disabled (default)
 email = ""
 
-; Advertise a contact Telegram url e.g. "https://t.me/elegantobjects"
+; Advertise a contact URL (can be any URL!) e.g. "https://t.me/elegantobjects"
 telegram = ""
 
 ; Show Donation information for bridges if available.
diff --git a/lib/contents.php b/lib/contents.php
index 752c0ff2..b4d70817 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -177,11 +177,9 @@ function getSimpleHTMLDOM(
 }
 
 /**
- * Gets contents from the Internet as simplhtmldom object. Contents are cached
+ * Fetch contents from the Internet as simplhtmldom object. Contents are cached
  * and re-used for subsequent calls until the cache duration elapsed.
  *
- * _Notice_: Cached contents are forcefully removed after 24 hours (86400 seconds).
- *
  * @param string $url The URL.
  * @param int $ttl Cache duration in seconds.
  * @param array $header (optional) A list of cURL header.
diff --git a/templates/frontpage.html.php b/templates/frontpage.html.php
index c1182673..f285e8d6 100644
--- a/templates/frontpage.html.php
+++ b/templates/frontpage.html.php
@@ -52,7 +52,7 @@
 
     <?php if ($admin_telegram): ?>
         <div>
-            Telegram: <a href="<?= e($admin_telegram) ?>"><?= e($admin_telegram) ?></a>
+            Url: <a href="<?= e($admin_telegram) ?>"><?= e($admin_telegram) ?></a>
         </div>
     <?php endif; ?>
 

From bf431a6eaee0c39b51b9fba45cfd44c89834b376 Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Mon, 27 Jan 2025 21:55:34 +0100
Subject: [PATCH 588/716] [AnisearchBridge] changed id of div so trailers work
 again (#4428)

---
 bridges/AnisearchBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/AnisearchBridge.php b/bridges/AnisearchBridge.php
index c805cfcb..c6f3d291 100644
--- a/bridges/AnisearchBridge.php
+++ b/bridges/AnisearchBridge.php
@@ -67,7 +67,7 @@ class AnisearchBridge extends BridgeAbstract
                 $trailerlink = $domarticle->find('section#trailers > div > div.swiper > ul.swiper-wrapper > li.swiper-slide > a', 0);
                 if (isset($trailerlink)) {
                     $trailersite = getSimpleHTMLDOM($baseurl . $trailerlink->href);
-                    $trailer = $trailersite->find('div#player > iframe', 0);
+                    $trailer = $trailersite->find('div#video > iframe', 0);
                     $trailer = $trailer->{'data-xsrc'};
                     $ytlink = <<<EOT
                         <br /><iframe width="560" height="315" src="$trailer" title="YouTube video player"

From 3ae7a102230471765c27eeec808c983f239a64a2 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Wed, 29 Jan 2025 05:11:25 -0500
Subject: [PATCH 589/716] [GovTrackBridge] Rebase on top of official RSS feed
 (#4429)

---
 bridges/GovTrackBridge.php | 92 ++++++++++++++++----------------------
 1 file changed, 39 insertions(+), 53 deletions(-)

diff --git a/bridges/GovTrackBridge.php b/bridges/GovTrackBridge.php
index 4674668a..a2c18d9f 100644
--- a/bridges/GovTrackBridge.php
+++ b/bridges/GovTrackBridge.php
@@ -1,6 +1,6 @@
 <?php
 
-class GovTrackBridge extends BridgeAbstract
+class GovTrackBridge extends FeedExpander
 {
     const NAME = 'GovTrack';
     const MAINTAINER = 'phantop';
@@ -18,64 +18,50 @@ class GovTrackBridge extends BridgeAbstract
                 'Major Legislative Activity' => 'major-bill-activity',
                 'New Bills and Resolutions' => 'introduced-bills',
                 'New Laws' => 'enacted-bills',
-                'Posts from Us' => 'posts'
-                ]
-            ],
-            'limit' => self::LIMIT
+                'News from Us' => 'posts'
+            ]
+        ],
+        'limit' => self::LIMIT
     ]];
 
     public function collectData()
     {
-        $html = getSimpleHTMLDOMCached($this->getURI());
-        if ($this->getInput('feed') != 'posts') {
-            $this->collectEvent($html);
-            return;
-        }
-
-        $html = defaultLinkTo($html, parent::getURI());
-        $limit = $this->getInput('limit') ?? 10;
-        foreach ($html->find('section') as $element) {
-            if (--$limit == 0) {
-                break;
-            }
-
-            $info = explode(' ', $element->find('p', 0)->innertext);
-            $item = [
-                'categories' => [implode(' ', array_slice($info, 4))],
-                'timestamp' => strtotime(implode(' ', array_slice($info, 0, 3))),
-                'title' => $element->find('a', 0)->innertext,
-                'uri' => $element->find('a', 0)->href,
-            ];
-
-            $html = getSimpleHTMLDOMCached($item['uri']);
-            $html = defaultLinkTo($html, parent::getURI());
-
-            $content = $html->find('#content .col-md', 1);
-            $info = explode(' by ', $content->find('p', 0)->plaintext);
-            $content->removeChild($content->firstChild());
-
-            $item['author'] = implode(' ', array_slice($info, 1));
-            $item['content'] = $content->innertext;
-
-            $this->items[] = $item;
+        $limit = $this->getInput('limit') ?? 15;
+        if ($this->getInput('feed') == 'posts') {
+            $this->collectExpandableDatas($this->getURI() . '.rss', $limit);
+        } else {
+            $this->collectEvent($this->getURI(), $limit);
         }
     }
 
-    private function collectEvent($html)
+    protected function parseItem(array $item)
     {
-        $opt = [];
-        preg_match('/"csrfmiddlewaretoken" value="(.*)"/', $html, $opt);
+        $html = getSimpleHTMLDOMCached($item['uri']);
+        $html = defaultLinkTo($html, parent::getURI());
+
+        $item['categories'] = [$html->find('.breadcrumb-item', 1)->plaintext];
+        $content = $html->find('#content .col-md', 1);
+        $item['author'] = explode(' by ', $content->firstChild()->plaintext)[1];
+        $content->removeChild($content->firstChild());
+        $item['content'] = $content->innertext;
+
+        return $item;
+    }
+
+    private function collectEvent($uri, $limit)
+    {
+        $html = getSimpleHTMLDOMCached($uri);
+        preg_match('/"csrfmiddlewaretoken" value="(.*)"/', $html, $preg);
         $header = [
-            "cookie: csrftoken=$opt[1]",
-            "x-csrftoken: $opt[1]",
+            "cookie: csrftoken=$preg[1]",
+            "x-csrftoken: $preg[1]",
             'referer: ' . parent::getURI(),
         ];
-        preg_match('/var selected_feed = "(.*)";/', $html, $opt);
-        $post = [
-            'count' => $this->getInput('limit') ?? 20,
-            'feed' => $opt[1]
-        ];
-        $opt = [ CURLOPT_POSTFIELDS => $post ];
+        preg_match('/var selected_feed = "(.*)";/', $html, $preg);
+        $opt = [ CURLOPT_POSTFIELDS => [
+            'count' => $limit,
+            'feed' => $preg[1]
+        ]];
 
         $html = getContents(parent::getURI() . 'events/_load_events', $header, $opt);
         $html = defaultLinkTo(str_get_html($html), parent::getURI());
@@ -83,10 +69,10 @@ class GovTrackBridge extends BridgeAbstract
         foreach ($html->find('.tracked_event') as $event) {
             $bill = $event->find('.event_title a, .event_body a', 0);
             $date = explode(' ', $event->find('.event_date', 0)->plaintext);
-            preg_match('/Sponsor:(.*)\n/', $event->plaintext, $opt);
+            preg_match('/Sponsor:(.*)\n/', $event->plaintext, $preg);
 
             $item = [
-                'author' => $opt[1] ?? '',
+                'author' => $preg[1] ?? '',
                 'content' => $event->find('td', 1)->innertext,
                 'enclosures' => [$event->find('img', 0)->src],
                 'timestamp' => strtotime(implode(' ', array_slice($date, 2))),
@@ -115,10 +101,10 @@ class GovTrackBridge extends BridgeAbstract
 
     public function getURI()
     {
-        if ($this->getInput('feed') != 'posts') {
-            $url = parent::getURI() . 'events/' . $this->getInput('feed');
-        } else {
+        if ($this->getInput('feed') == 'posts') {
             $url = parent::getURI() . $this->getInput('feed');
+        } else {
+            $url = parent::getURI() . 'events/' . $this->getInput('feed');
         }
         return $url;
     }

From 935075072b7937583818677daff31cad5037362f Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 30 Jan 2025 21:05:17 +0100
Subject: [PATCH 590/716] fix: set default cache ttl of 1d (#4434)

---
 lib/BridgeAbstract.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index 23e90e13..b814097a 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -327,7 +327,7 @@ abstract class BridgeAbstract
         return $this->cache->get($this->getShortName() . '_' . $key, $default);
     }
 
-    protected function saveCacheValue(string $key, $value, int $ttl = null)
+    protected function saveCacheValue(string $key, $value, int $ttl = 86400)
     {
         $this->cache->set($this->getShortName() . '_' . $key, $value, $ttl);
     }

From 920b21b1fd432959371493121db81d5c98ed4fd3 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Mon, 3 Feb 2025 15:35:48 +0100
Subject: [PATCH 591/716] [PepperBridgeAbstract, DealabsBridge,
 HotUKDealsBridge, MydealsBridge] Fixing bridge and add subcategories (#4436)

- Follow site change to get deal data (fix for #4432)
- Add Categories (sub categories in reality) support
---
 bridges/DealabsBridge.php        | 11 +++++++++++
 bridges/HotUKDealsBridge.php     | 11 +++++++++++
 bridges/MydealsBridge.php        | 11 +++++++++++
 bridges/PepperBridgeAbstract.php | 25 ++++++++++++-------------
 4 files changed, 45 insertions(+), 13 deletions(-)

diff --git a/bridges/DealabsBridge.php b/bridges/DealabsBridge.php
index a3d1aaa5..aed32529 100644
--- a/bridges/DealabsBridge.php
+++ b/bridges/DealabsBridge.php
@@ -48,6 +48,16 @@ https://www.dealabs.com/groupe/abonnements-internet?sortBy=lowest_price
 Il faut alors saisir :
 abonnements-internet',
                 ],
+            'subgroup' => [
+                'name' => 'Catégorie',
+                'type' => 'text',
+                'exampleValue' => '1071',
+                'title' => 'Numéro du ou des catégories dans l\'URL : Il faut entrer le ou les numéros de catégories qui sont présent après "groups=" et avant tout éventuel "&"
+Exemple : Si l\'URL du groupe affichées dans le navigateur est :
+https://www.dealabs.com/groupe/telecommunications?groups=1071%2C1070&sortBy=new
+Il faut alors saisir :
+1071%2C1070',
+                ],
             'order' => [
                 'name' => 'Trier par',
                 'type' => 'list',
@@ -88,6 +98,7 @@ abonnements-internet',
         'uri-group' => 'groupe/',
         'uri-deal' => 'bons-plans/',
         'uri-merchant' => 'search/bons-plans?merchant-id=',
+        'image-host' => 'https://static-pepper.dealabs.com/',
         'request-error' => 'Impossible de joindre Dealabs',
         'thread-error' => 'Impossible de déterminer l\'ID de la discussion. Vérifiez l\'URL que vous avez entré',
         'currency' => '€',
diff --git a/bridges/HotUKDealsBridge.php b/bridges/HotUKDealsBridge.php
index 9d56fa97..f4d65c59 100644
--- a/bridges/HotUKDealsBridge.php
+++ b/bridges/HotUKDealsBridge.php
@@ -47,6 +47,16 @@ Example: If the URL of the group displayed in the browser is :
 https://www.hotukdeals.com/tag/broadband?sortBy=temp
 Then enter :
 broadband',
+            ],
+            'subgrousp' => [
+                'name' => 'category',
+                'type' => 'text',
+                'exampleValue' => '343563',
+                'title' => 'Category number in the URL : The category number that must be entered is present after "groups=" and before any "&".
+Example: If the URL of the group displayed in the browser is :
+https://www.hotukdeals.com/tag/broadband?groups=343563&sortBy=new
+Then enter :
+343563',
             ],
             'order' => [
                 'name' => 'Order by',
@@ -86,6 +96,7 @@ broadband',
         'uri-group' => 'tag/',
         'uri-deal' => 'deals/',
         'uri-merchant' => 'search/deals?merchant-id=',
+        'image-host' => 'https://images.hotukdeals.com/',
         'request-error' => 'Could not request HotUKDeals',
         'thread-error' => 'Unable to determine the thread ID. Check the URL you entered',
         'currency' => '£',
diff --git a/bridges/MydealsBridge.php b/bridges/MydealsBridge.php
index 6be2adfb..65d6624c 100644
--- a/bridges/MydealsBridge.php
+++ b/bridges/MydealsBridge.php
@@ -48,6 +48,16 @@ https://www.mydealz.de/gruppe/dsl?sortBy=temp
 Dann geben Sie ein:
 dsl',
                 ],
+            'subgroups' => [
+                'name' => 'Kategorie',
+                'type' => 'text',
+                'exampleValue' => '293',
+                'title' => 'Nummer des Kategorie in der URL: Der einzugebende Kategorienummer steht nach "groups=" und vor einem "&".
+Beispiel: Wenn die URL der Gruppe, die im Browser angezeigt wird, :
+https://www.mydealz.de/gruppe/telefon-internet?groups=153%2C154&sortBy=new&time_frame=0
+Dann geben Sie ein:
+153%2C154',
+                ],
             'order' => [
                 'name' => 'sortieren nach',
                 'type' => 'list',
@@ -84,6 +94,7 @@ dsl',
         'uri-group' => 'gruppe/',
         'uri-deal' => 'deals/',
         'uri-merchant' => 'search/gutscheine?merchant-id=',
+        'image-host' => 'https://static.mydealz.de/',
         'request-error' => 'Could not request mydeals',
         'thread-error' => 'Die ID der Diskussion kann nicht ermittelt werden. Überprüfen Sie die eingegebene URL',
         'currency' => '€',
diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index c64ad2fa..43dbe829 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -62,7 +62,7 @@ class PepperBridgeAbstract extends BridgeAbstract
             foreach ($list as $deal) {
                 // Get the JSON Data stored as vue
                 $jsonDealData = $this->getDealJsonData($deal);
-                $dealMeta = Json::decode($deal->find('div[class=threadGrid-headerMeta]', 0)->find('div[class=js-vue2]', 1)->getAttribute('data-vue2'));
+                $dealMeta = Json::decode($deal->find('div[class=js-vue2]', 1)->getAttribute('data-vue2'));
 
                 $item = [];
                 $item['uri'] = $this->getDealURI($jsonDealData);
@@ -80,7 +80,7 @@ class PepperBridgeAbstract extends BridgeAbstract
                     . $this->getShipsFrom($dealMeta)
                     . $this->getShippingCost($jsonDealData)
                     . $this->getSource($jsonDealData)
-                    . $this->getDealLocation($dealMeta)
+                    . $this->getDealLocation($jsonDealData)
                     . $deal->find('div[class*=' . $selectorDescription . ']', 0)->innertext
                     . '</td><td>'
                     . $this->getTemperature($jsonDealData)
@@ -402,14 +402,9 @@ HEREDOC;
      * Get the Deal location if it exists
      * @return string String of the deal location
      */
-    private function getDealLocation($dealMeta)
+    private function getDealLocation($jsonDealData)
     {
-        $ribbons = $dealMeta['props']['metaRibbons'];
-        $isLocal = false;
-        foreach ($ribbons as $ribbon) {
-            $isLocal |= ($ribbon['type'] == 'local');
-        }
-        if ($isLocal) {
+        if ($jsonDealData['props']['thread']['isLocal']) {
             $content = '<div>' . $this->i8n('deal-type') . ' : ' . $this->i8n('localdeal') . '</div>';
         } else {
             $content = '';
@@ -424,8 +419,11 @@ HEREDOC;
     private function getImage($deal)
     {
         // Get thread Image JSON content
-        $content = Json::decode($deal->find('div[class*=threadGrid-image]', 0)->find('div[class=js-vue2]', 0)->getAttribute('data-vue2'));
-        return '<img src="' . $content['props']['threadImageUrl'] . '"/>';
+        $content = Json::decode($deal->find('div[class=js-vue2]', 0)->getAttribute('data-vue2'));
+        //return '<img src="' . $content['props']['threadImageUrl'] . '"/>';
+        return '<img src="' . $this->i8n('image-host') . $content['props']['thread']['mainImage']['path'] . '/'
+            . $content['props']['thread']['mainImage']['name'] . '/re/202x202/qt/70/'
+            . $content['props']['thread']['mainImage']['uid'] . '"/>';
     }
 
     /**
@@ -434,7 +432,7 @@ HEREDOC;
      */
     private function getShipsFrom($dealMeta)
     {
-        $metas = $dealMeta['props']['metaRibbons'];
+        $metas = $dealMeta['props']['metaRibbons'] ?? [];
         $shipsFrom = null;
         foreach ($metas as $meta) {
             if ($meta['type'] == 'dispatched-from') {
@@ -524,6 +522,7 @@ HEREDOC;
     {
         $group = $this->getInput('group');
         $order = $this->getInput('order');
+        $subgroups = $this->getInput('subgroups');
 
         // This permit to keep the existing Feed to work
         if ($order == $this->i8n('context-hot')) {
@@ -533,7 +532,7 @@ HEREDOC;
         }
 
         $url = $this->i8n('bridge-uri')
-            . $this->i8n('uri-group') . $group . '?sortBy=' . $sortBy;
+            . $this->i8n('uri-group') . $group . '?sortBy=' . $sortBy . '&groups=' . $subgroups;
         return $url;
     }
 

From 94924d8e161635063054bc2ecfb24de5792f46d5 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Mon, 3 Feb 2025 23:24:42 +0100
Subject: [PATCH 592/716] [PepperBridgeAbstract, DealabsBridge,
 HotUKDealsBridge, MydealsBridge] Fix parameters typo (#4439)

Fixed typo in DealabsBridge and HotUKDealsBridge parameters name
---
 bridges/DealabsBridge.php    | 2 +-
 bridges/HotUKDealsBridge.php | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/DealabsBridge.php b/bridges/DealabsBridge.php
index aed32529..7bad79b5 100644
--- a/bridges/DealabsBridge.php
+++ b/bridges/DealabsBridge.php
@@ -48,7 +48,7 @@ https://www.dealabs.com/groupe/abonnements-internet?sortBy=lowest_price
 Il faut alors saisir :
 abonnements-internet',
                 ],
-            'subgroup' => [
+            'subgroups' => [
                 'name' => 'Catégorie',
                 'type' => 'text',
                 'exampleValue' => '1071',
diff --git a/bridges/HotUKDealsBridge.php b/bridges/HotUKDealsBridge.php
index f4d65c59..7450c6f0 100644
--- a/bridges/HotUKDealsBridge.php
+++ b/bridges/HotUKDealsBridge.php
@@ -48,7 +48,7 @@ https://www.hotukdeals.com/tag/broadband?sortBy=temp
 Then enter :
 broadband',
             ],
-            'subgrousp' => [
+            'subgroups' => [
                 'name' => 'category',
                 'type' => 'text',
                 'exampleValue' => '343563',

From 549bed64d2b2ed37e7d6b888d83795ec1ee31603 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Tue, 4 Feb 2025 14:11:43 -0500
Subject: [PATCH 593/716] [YouTubeFeedExpanderBridge] Add bridge (#4430)

---
 bridges/YouTubeFeedExpanderBridge.php | 86 +++++++++++++++++++++++++++
 1 file changed, 86 insertions(+)
 create mode 100644 bridges/YouTubeFeedExpanderBridge.php

diff --git a/bridges/YouTubeFeedExpanderBridge.php b/bridges/YouTubeFeedExpanderBridge.php
new file mode 100644
index 00000000..953674ec
--- /dev/null
+++ b/bridges/YouTubeFeedExpanderBridge.php
@@ -0,0 +1,86 @@
+<?php
+
+class YouTubeFeedExpanderBridge extends FeedExpander
+{
+    const NAME = 'YouTube Feed Expander';
+    const MAINTAINER = 'phantop';
+    const URI = 'https://www.youtube.com/';
+    const DESCRIPTION = 'Returns the latest videos from a YouTube channel';
+    const PARAMETERS = [[
+        'channel' => [
+            'name' => 'Channel ID',
+            'required' => true,
+            // Example: vinesauce
+            'exampleValue' => 'UCzORJV8l3FWY4cFO8ot-F2w',
+        ],
+        'embed' => [
+            'name' => 'Add embed to entry',
+            'type' => 'checkbox',
+            'required' => false,
+            'title' => 'Add embed to entry',
+            'defaultValue' => 'checked',
+        ],
+        'embedurl' => [
+            'name' => 'Use embed page as entry url',
+            'type' => 'checkbox',
+            'required' => false,
+            'title' => 'Use embed page as entry url',
+        ],
+        'nocookie' => [
+            'name' => 'Use nocookie embed page',
+            'type' => 'checkbox',
+            'required' => false,
+            'title' => 'Use nocookie embed page'
+        ],
+    ]];
+
+    public function getIcon()
+    {
+        if ($this->getInput('channel') != null) {
+            $html = getSimpleHTMLDOMCached($this->getURI());
+            $scriptRegex = '/var ytInitialData = (.*?);<\/script>/';
+            $result = preg_match($scriptRegex, $html, $matches);
+            if (isset($matches[1])) {
+                $json = json_decode($matches[1]);
+                return $json->metadata->channelMetadataRenderer->avatar->thumbnails[0]->url;
+            }
+        }
+        return parent::getIcon();
+    }
+
+    public function collectData()
+    {
+        $url = 'https://www.youtube.com/feeds/videos.xml?channel_id=' . $this->getInput('channel');
+        $this->collectExpandableDatas($url);
+    }
+
+    protected function parseItem(array $item)
+    {
+        $id = $item['yt']['videoId'];
+        $item['comments'] = $item['uri'] . '#comments';
+        $item['uid'] = $item['id'];
+
+        $thumbnail = sprintf('https://img.youtube.com/vi/%s/maxresdefault.jpg', $id);
+        $item['enclosures'] = [$thumbnail];
+
+        $item['content'] = $item['media']['group']['description'];
+        $item['content'] = str_replace("\n", '<br>', $item['content']);
+        unset($item['media']);
+
+        $embedURI = self::URI;
+        if ($this->getInput('nocookie')) {
+            $embedURI = 'https://www.youtube-nocookie.com/';
+        }
+        $embed = $embedURI . 'embed/' . $id;
+        if ($this->getInput('embed')) {
+            $iframe_fmt = '<iframe width="448" height="350" src="%s" title="%s" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>'; //phpcs:ignore
+            $iframe = sprintf($iframe_fmt, $embed, $item['title']) . '<br>';
+            $item['content'] = $iframe . $item['content'];
+        }
+        if ($this->getInput('embedurl')) {
+            $item['uri'] = $embed;
+        }
+
+        return $item;
+    }
+}

From 4e678c955fed511667160776b3f27e75178b4eaf Mon Sep 17 00:00:00 2001
From: Tostiman <18124323+t0stiman@users.noreply.github.com>
Date: Wed, 5 Feb 2025 18:41:42 +0100
Subject: [PATCH 594/716] fix CarThrottleBridge (#4442)

---
 bridges/CarThrottleBridge.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bridges/CarThrottleBridge.php b/bridges/CarThrottleBridge.php
index 2b8ca2b2..8475a414 100644
--- a/bridges/CarThrottleBridge.php
+++ b/bridges/CarThrottleBridge.php
@@ -66,7 +66,7 @@ class CarThrottleBridge extends BridgeAbstract
         foreach ($categoryPage->find('div.cmg-card') as $post) {
             $item = [];
 
-            $titleElement = $post->find('div.title a')[0];
+            $titleElement = $post->find('a.title')[0];
             $post_uri = self::URI . $titleElement->getAttribute('href');
 
             if (!isset($post_uri) || $post_uri == '') {
@@ -80,8 +80,8 @@ class CarThrottleBridge extends BridgeAbstract
 
             $item['author'] = $this->parseAuthor($articlePage);
 
-            $articleImage = $articlePage->find('div.block-layout-field-image')[0];
-            $article = $articlePage->find('div.block-layout-body')[1];
+            $articleImage = $articlePage->find('figure')[0];
+            $article = $articlePage->find('div.first-column div.body')[0];
 
             //remove ads
             foreach ($article->find('aside') as $ad) {

From dd4dcfa59c08e5bece71861647f82c05e60c0cfa Mon Sep 17 00:00:00 2001
From: Christian Schabesberger <chris.schabesberger@mailbox.org>
Date: Sat, 8 Feb 2025 01:41:51 +0100
Subject: [PATCH 595/716] fix nn.de description and paywall filter (#4444)

---
 bridges/NurembergerNachrichtenBridge.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/NurembergerNachrichtenBridge.php b/bridges/NurembergerNachrichtenBridge.php
index 10644212..2c303533 100644
--- a/bridges/NurembergerNachrichtenBridge.php
+++ b/bridges/NurembergerNachrichtenBridge.php
@@ -6,7 +6,7 @@ class NurembergerNachrichtenBridge extends BridgeAbstract
     const NAME = 'Nürnberger Nachrichten';
     const CACHE_TIMEOUT = 3600;
     const URI = 'https://www.nn.de';
-    const DESCRIPTION = 'Bridge for Bavarian regional news site nordbayern.de';
+    const DESCRIPTION = 'Bridge for NurembergerNachrichten news site nn.de';
     const PARAMETERS = [ [
         'region' => [
             'name' => 'region',
@@ -66,7 +66,7 @@ class NurembergerNachrichtenBridge extends BridgeAbstract
             // exclude nn+ articles if desired
             if (
                 $this->getInput('hideNNPlus') &&
-                str_contains($articleContent->find('article[id=article]', 0)->find('header', 0), 'icon-nnplus')
+                $articleContent->find('div[class=paywall]')
             ) {
                 continue;
             }

From e4c32bb046011a95ffecf3693db3a754b37dac13 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 14 Feb 2025 02:00:07 +0100
Subject: [PATCH 596/716] fix(vk): semi-disable broken bridge (#4448)

---
 bridges/VkBridge.php | 23 +++++++++++++++--------
 1 file changed, 15 insertions(+), 8 deletions(-)

diff --git a/bridges/VkBridge.php b/bridges/VkBridge.php
index 11cfca5d..54b2897a 100644
--- a/bridges/VkBridge.php
+++ b/bridges/VkBridge.php
@@ -7,8 +7,8 @@ class VkBridge extends BridgeAbstract
     // const MAINTAINER = 'ahiles3005';
     const NAME = 'VK.com';
     const URI = 'https://vk.com/';
-    const CACHE_TIMEOUT = 300; // 5min
-    const DESCRIPTION = 'Working with open pages';
+    const CACHE_TIMEOUT = 3600; // 1h
+    const DESCRIPTION = 'Does not work anymore';
     const PARAMETERS = [
         [
             'u' => [
@@ -65,6 +65,7 @@ class VkBridge extends BridgeAbstract
 
     public function collectData()
     {
+        return;
         $text_html = $this->getContents();
 
         $text_html = iconv('windows-1251', 'utf-8//ignore', $text_html);
@@ -391,10 +392,13 @@ class VkBridge extends BridgeAbstract
             $item['categories'] = $hashtags;
 
             // get post link
-            $post_link = $post->find('a.PostHeaderSubtitle__link', 0)->getAttribute('href');
-            preg_match('/wall-?\d+_(\d+)/', $post_link, $preg_match_result);
-            $item['post_id'] = intval($preg_match_result[1]);
-            $item['uri'] = $post_link;
+            $var = $post->find('a.PostHeaderSubtitle__link', 0);
+            if ($var) {
+                $post_link = $var->getAttribute('href');
+                preg_match('/wall-?\d+_(\d+)/', $post_link, $preg_match_result);
+                $item['post_id'] = intval($preg_match_result[1]);
+                $item['uri'] = $post_link;
+            }
             $item['timestamp'] = $this->getTime($post);
             $item['title'] = $this->getTitle($item['content']);
             $item['author'] = $post_author;
@@ -402,7 +406,7 @@ class VkBridge extends BridgeAbstract
                 // do not append it now
                 $pinned_post_item = $item;
             } else {
-                $last_post_id = $item['post_id'];
+                $last_post_id = $item['post_id'] ?? null;
                 $this->items[] = $item;
             }
         }
@@ -474,7 +478,10 @@ class VkBridge extends BridgeAbstract
         if ($accurateDateElement) {
             return $accurateDateElement->getAttribute('time');
         } else {
-            $strdate = $post->find('time.PostHeaderSubtitle__item', 0)->plaintext;
+            $strdate = $post->find('time.PostHeaderSubtitle__item', 0)->plaintext ?? null;
+            if (!$strdate) {
+                return 0;
+            }
             $strdate = preg_replace('/[\x00-\x1F\x7F-\xFF]/', ' ', $strdate);
 
             $date = date_parse($strdate);

From b52f01505d524039e78e83844225f574ce101145 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 14 Feb 2025 02:42:23 +0100
Subject: [PATCH 597/716] fix(github): semi-repair (#4449)

---
 bridges/GithubIssueBridge.php | 27 +++++++++++++++------------
 1 file changed, 15 insertions(+), 12 deletions(-)

diff --git a/bridges/GithubIssueBridge.php b/bridges/GithubIssueBridge.php
index 7f56abbd..0c3c0471 100644
--- a/bridges/GithubIssueBridge.php
+++ b/bridges/GithubIssueBridge.php
@@ -192,15 +192,18 @@ class GithubIssueBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $html = getSimpleHTMLDOM($this->getURI());
+        $url = $this->getURI();
+        $html = getSimpleHTMLDOM($url);
 
         switch ($this->queriedContext) {
             case static::BRIDGE_OPTIONS[1]: // Issue comments
                 $this->items = $this->extractIssueComments($html);
                 break;
             case static::BRIDGE_OPTIONS[0]: // Project Issues
-                foreach ($html->find('.js-active-navigation-container .js-navigation-item') as $issue) {
-                    $info = $issue->find('.opened-by', 0);
+                $issues = $html->find('.js-active-navigation-container .js-navigation-item');
+                $issues = $html->find('.IssueRow-module__row--XmR1f');
+                foreach ($issues as $issue) {
+                    $info = $issue->find('.issue-item-module__authorCreatedLink--wFZvk', 0);
 
                     preg_match('/\/([0-9]+)$/', $issue->find('a', 0)->href, $match);
                     $issueNbr = $match[1];
@@ -222,24 +225,24 @@ class GithubIssueBridge extends BridgeAbstract
                         $item['content'] = 'Can not extract comments from ' . $uri;
                     }
 
-                    $item['author'] = $info->find('a', 0)->plaintext;
+                    $item['author'] = $issue->find('a', 1)->plaintext;
                     $item['timestamp'] = strtotime(
-                        $info->find('relative-time', 0)->getAttribute('datetime')
+                        $issue->find('relative-time', 0)->getAttribute('datetime')
                     );
                     $item['title'] = html_entity_decode(
-                        $issue->find('.js-navigation-open', 0)->plaintext,
+                        $issue->find('h3', 0)->plaintext,
                         ENT_QUOTES,
                         'UTF-8'
                     );
 
-                    $comment_count = 0;
-                    if ($span = $issue->find('a[aria-label*="comment"] span', 0)) {
-                        $comment_count = $span->plaintext;
-                    }
+                    //$comment_count = 0;
+                    //if ($span = $issue->find('a[aria-label*="comment"] span', 0)) {
+                    //    $comment_count = $span->plaintext;
+                    //}
 
-                    $item['content'] .= "\n" . 'Comments: ' . $comment_count;
+                    //$item['content'] .= "\n" . 'Comments: ' . $comment_count;
                     $item['uri'] = self::URI
-                             . trim($issue->find('.js-navigation-open', 0)->getAttribute('href'), '/');
+                             . trim($issue->find('a', 0)->getAttribute('href'), '/');
                     $this->items[] = $item;
                 }
                 break;

From 92b5e7093ff310f0fa28c17d0ab89b7289282d02 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Andr=C3=A9=20Andersson?= <andre.eric.andersson@gmail.com>
Date: Mon, 24 Feb 2025 17:58:24 +0100
Subject: [PATCH 598/716] Fix data-lot-id not being correctly set so use href
 instead (#4453)

---
 bridges/BukowskisBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/BukowskisBridge.php b/bridges/BukowskisBridge.php
index 14889889..3573c206 100644
--- a/bridges/BukowskisBridge.php
+++ b/bridges/BukowskisBridge.php
@@ -206,7 +206,7 @@ class BukowskisBridge extends BridgeAbstract
             $this->items[] = [
                 'title' => $title,
                 'uri' => $baseUrl . $relative_url,
-                'uid' => $lot->getAttribute('data-lot-id'),
+                'uid' => $relative_url,
                 'content' => count($images) > 0 ? "<img src='$images[0]'/><br/>$title" : $title,
                 'enclosures' => array_slice($images, 1),
             ];

From 00a24e2f694a319a5e6cb070dddfff2dae892378 Mon Sep 17 00:00:00 2001
From: Tobias Alexander Franke <thefranke@users.noreply.github.com>
Date: Wed, 26 Feb 2025 10:20:28 +0100
Subject: [PATCH 599/716] New bridge for the latest Shadertoy submissions
 (#4456)

* New bridge for the latest Shadertoy submissions

* [ShadertoyBridge] Linter fixes

* [ShadertoyBridge] More Linter fixes

* [ShadertoyBridge] Even more Linter fixes
---
 bridges/ShadertoyBridge.php | 100 ++++++++++++++++++++++++++++++++++++
 1 file changed, 100 insertions(+)
 create mode 100644 bridges/ShadertoyBridge.php

diff --git a/bridges/ShadertoyBridge.php b/bridges/ShadertoyBridge.php
new file mode 100644
index 00000000..9240027e
--- /dev/null
+++ b/bridges/ShadertoyBridge.php
@@ -0,0 +1,100 @@
+<?php
+
+class ShadertoyBridge extends BridgeAbstract
+{
+    const NAME = 'Shadertoy';
+    const URI = 'https://www.shadertoy.com';
+    const DESCRIPTION = 'Latest submissions on Shadertoy';
+    const MAINTAINER = 'thefranke';
+    const CACHE_TIMEOUT = 3600; // 1h
+    const PARAMETERS = [
+        [
+            'category' => [
+                'name' => 'category',
+                'type' => 'list',
+                'exampleValue' => 'Popular',
+                'title' => 'Select a category',
+                'values' => [
+                    'Shaders of the Week' => 'sotw',
+                    'Popular' => 'popular',
+                    'Newest' => 'newest',
+                    'Hot' => 'hot',
+                ]
+            ]
+        ]
+    ];
+
+    public function postprocessDescription($content)
+    {
+        // replace [url] tags
+        $pattern = '/\[\/?url.*?\]/';
+        $replace = '';
+        $content = preg_replace($pattern, $replace, $content);
+
+        // find URLs and turn then into hyperlinks
+        $pattern = '/(http|https|ftp|ftps)\:\/\/[a-zA-Z0-9\-\.]+\.[a-zA-Z]{2,3}(\/\S*)?/';
+        $replace = '<a href="$0">$0</a>';
+        $content = preg_replace($pattern, $replace, $content);
+
+        return $content;
+    }
+
+    public function collectData()
+    {
+        $category = $this->getInput('category');
+        $json = null;
+
+        if ($category == 'sotw') {
+            $url = static::URI . '/playlist/week';
+            $contents = getContents($url);
+            $shaderids = extractFromDelimiters($contents, 'var gShaderIDs = ', ';');
+            $shaderids = str_replace('\'', '"', $shaderids);
+
+            $url = static::URI . '/shadertoy';
+            $data = 's=' . rawurlencode('{ "shaders": ' . $shaderids . ' }') . '&nt=0&nl=0&np=0';
+            $header = [
+                'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:135.0) Gecko/20100101 Firefox/135.0',
+                'Content-Type: application/x-www-form-urlencoded',
+                'Accept: */*',
+                'Origin: https://www.shadertoy.com',
+                'Referer: https://www.shadertoy.com/playlist/week',
+            ];
+
+            $opts = [
+                CURLOPT_POST => true,
+                CURLOPT_POSTFIELDS => $data,
+                CURLOPT_RETURNTRANSFER => true
+            ];
+            $json = getContents($url, $header, $opts);
+        } else {
+            $url = static::URI . '/results?sort=' . $category;
+            $contents = getContents($url);
+            $json = extractFromDelimiters($contents, 'var gShaders=', 'var gUseScreenshots');
+            $json = substr(trim($json), 0, -1);
+        }
+
+        $json = Json::decode($json);
+
+        if (!$json) {
+            throw new Exception(sprintf('Unable to find css selector on `%s`', static::URI));
+        }
+
+        foreach ($json as $article) {
+            $id = $article['info']['id'];
+
+            $title = $article['info']['name'];
+            $author = $article['info']['username'];
+            $uri = static::URI . '/view/' . $id;
+            $content = '<p><img src="' . static::URI . '/media/shaders/' . $id . '.jpg"></p><p>' . $this->postprocessDescription($article['info']['description']) . '</p>';
+            $timestamp = $article['info']['date'];
+
+            $this->items[] = [
+                'title' => $title,
+                'author' => $author,
+                'uri' => $uri,
+                'content' => $content,
+                'timestamp' => $timestamp,
+            ];
+        }
+    }
+}

From cd4cdcfd65f0dc7b6f145c6fcbd4f7f20ebd8ed5 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Wed, 5 Mar 2025 19:30:09 +0100
Subject: [PATCH 600/716] [RadioMelodieBridge] Fix media content (#4458)

- Fix the audio source with the absolute URL
- Fix the pictture enclosure URL (those are already absolute URL)
---
 bridges/RadioMelodieBridge.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/RadioMelodieBridge.php b/bridges/RadioMelodieBridge.php
index 917b6ef2..6045ef93 100644
--- a/bridges/RadioMelodieBridge.php
+++ b/bridges/RadioMelodieBridge.php
@@ -40,7 +40,7 @@ class RadioMelodieBridge extends BridgeAbstract
                 $picture = [];
 
                 // Get the Main picture URL
-                $picture[] = self::URI . $article->find('figure[class*=photoviewer]', 0)->find('img', 0)->src;
+                $picture[] = $article->find('figure[class*=photoviewer]', 0)->find('img', 0)->src;
                 $audioHTML = $article->find('audio');
 
                 // Add the audio element to the enclosure
@@ -123,7 +123,7 @@ class RadioMelodieBridge extends BridgeAbstract
             preg_match('/wavesurfer[0-9]+.load\(\'(.*)\'\)/m', $js->innertext, $urls);
 
             // Create the plain HTML <audio> content to play this audio file
-            $content = '<audio style="width: 100%" src="' . $urls[1] . '" controls ></audio>';
+            $content = '<audio style="width: 100%" src="' . self::URI . $urls[1] . '" controls ></audio>';
 
             // Replace the <script> tag by the <audio> tag
             $js->outertext = $content;

From 62fafdc24bab07088bdc08943b574a768dc87c01 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Wed, 5 Mar 2025 19:30:38 +0100
Subject: [PATCH 601/716] [FreeTelechargerBridge] Update URL and some fix
 (#4459)

- Updated the URL to the new URL in the bridge Meta Data
- Use an other URL that seems to permit to bypass CF protection
  (sometimes)
---
 bridges/FreeTelechargerBridge.php | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/bridges/FreeTelechargerBridge.php b/bridges/FreeTelechargerBridge.php
index f0e5d35a..69111d73 100644
--- a/bridges/FreeTelechargerBridge.php
+++ b/bridges/FreeTelechargerBridge.php
@@ -3,7 +3,8 @@
 class FreeTelechargerBridge extends BridgeAbstract
 {
     const NAME = 'Free-Telecharger';
-    const URI = 'https://www.free-telecharger.art/';
+    const URI = 'https://www.free-telecharger.fun/';
+    const ALTERNATEURI = 'https://www.free-telecharger.com/';
     const DESCRIPTION = 'Suivi de série sur Free-Telecharger';
     const MAINTAINER  = 'sysadminstory';
     const PARAMETERS = [
@@ -12,19 +13,19 @@ class FreeTelechargerBridge extends BridgeAbstract
                             'name' => 'URL de la série',
                             'type' => 'text',
                             'required' => true,
-                            'title' => 'URL d\'une série sans le https://www.free-telecharger.art/',
+                            'title' => 'URL d\'une série sans le https://www.free-telecharger.fun/',
                             'pattern' => 'series.*\.html',
                             'exampleValue' => 'series-vf-hd/151432-wolf-saison-1-complete-web-dl-720p.html'
                     ],
             ]
     ];
     const CACHE_TIMEOUT = 3600;
-    private string $showTitle;
-    private string $showTechDetails;
+    private string $showTitle = '';
+    private string $showTechDetails = '';
 
     public function collectData()
     {
-        $html = getSimpleHTMLDOM(self::URI . $this->getInput('url'));
+        $html = getSimpleHTMLDOM(self::ALTERNATEURI . $this->getInput('url'));
 
         // Find all block content of the page
         $blocks = $html->find('div[class=block1]');

From 97f07cf2168bc7b72a67d72e8ac7205de8cbbc30 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Wed, 5 Mar 2025 19:32:03 +0100
Subject: [PATCH 602/716] [InstagramBridge] Add a fallback to the "Username"
 mode (#4461)

- Added some header that could help Instagram to not block RSS Bridge
- Added a fallback function to use the "Embed profile" Instagram feature
  to get the content shared by one Instagram user
---
 bridges/InstagramBridge.php | 45 +++++++++++++++++++++++++++++++++----
 1 file changed, 41 insertions(+), 4 deletions(-)

diff --git a/bridges/InstagramBridge.php b/bridges/InstagramBridge.php
index 633d6080..d16b925c 100644
--- a/bridges/InstagramBridge.php
+++ b/bridges/InstagramBridge.php
@@ -86,6 +86,11 @@ class InstagramBridge extends BridgeAbstract
         $headers = [];
         $sessionId = $this->getOption('session_id');
         $dsUserId = $this->getOption('ds_user_id');
+        $headers[] = 'x-ig-app-id: 936619743392459';
+        $headers[] = 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/62.0.3202.94 Safari/537.36';
+        $headers[] = 'Accept-Language: en-US,en;q=0.9,ru;q=0.8';
+        $headers[] = 'Accept-Encoding: gzip, deflate, br';
+        $headers[] = 'Accept: */*';
         if ($sessionId and $dsUserId) {
             $headers[] = 'cookie: sessionid=' . $sessionId . '; ds_user_id=' . $dsUserId;
         }
@@ -125,8 +130,10 @@ class InstagramBridge extends BridgeAbstract
             return;
         }
 
-        if (!is_null($this->getInput('u'))) {
+        if (!is_null($this->getInput('u')) && !$this->fallbackMode) {
             $userMedia = $data->data->user->edge_owner_to_timeline_media->edges;
+        } elseif (!is_null($this->getInput('u')) && $this->fallbackMode) {
+            $userMedia = $data->context->graphql_media;
         } elseif (!is_null($this->getInput('h'))) {
             $userMedia = $data->data->hashtag->edge_hashtag_to_media->edges;
         } elseif (!is_null($this->getInput('l'))) {
@@ -134,7 +141,12 @@ class InstagramBridge extends BridgeAbstract
         }
 
         foreach ($userMedia as $media) {
-            $media = $media->node;
+            // The media is not in the same element if in fallback mode than not
+            if (!$this->fallbackMode) {
+                $media = $media->node;
+            } else {
+                $media = $media->shortcode_media;
+            }
 
             switch ($this->getInput('media_type')) {
                 case 'all':
@@ -267,14 +279,39 @@ class InstagramBridge extends BridgeAbstract
 
     protected function getInstagramJSON($uri)
     {
+        // Sets fallbackMode to false
+        $this->fallbackMode = false;
         if (!is_null($this->getInput('u'))) {
-            $userId = $this->getInstagramUserId($this->getInput('u'));
-            $data = $this->getContents(self::URI .
+            try {
+                $userId = $this->getInstagramUserId($this->getInput('u'));
+                $data = $this->getContents(self::URI .
                                 'graphql/query/?query_hash=' .
                                  self::USER_QUERY_HASH .
                                  '&variables={"id"%3A"' .
                                 $userId .
                                 '"%2C"first"%3A10}');
+            } catch (HttpException $e) {
+                // If loading the data directly failed, we fall back to the "/embed" data loading
+                // We are in the fallback mode : set a booolean to handle this specific case while collecting the content
+                $this->fallbackMode = true;
+                // Get the HTML code of the profile embed page, and extract the JSON of it
+                $username = $this->getInput('u');
+                // Load the content using the integrated function to use helping headers
+                $htmlString = $this->getContents(self::URI . $username . '/embed/');
+                // Load the String as an SimpleHTMLDom Object
+                $html = new simple_html_dom();
+                $html->load($htmlString);
+                // Find the <script> tag containing the JSON content
+                $jsCode = $html->find('body', 0)->find('script', 3)->innertext;
+
+                // Extract the content needed by our bridge of the whole Javascript content
+                $regex = '#"contextJSON":"(.*)"}\]\],\["NavigationMetrics"#m';
+                preg_match($regex, $jsCode, $matches);
+                $jsVariable = $matches[1];
+                $data = stripcslashes($jsVariable);
+                // stripcslashes remove Javascript unicode escaping : add it back to the string so json_decode can handle it
+                $data = preg_replace('/(?<!\\\\)u[0-9A-Fa-f]{4}/', '\\\\$0', $data);
+            }
             return json_decode($data);
         } elseif (!is_null($this->getInput('h'))) {
             $data = $this->getContents(self::URI .

From 810e17b556a26397f7385edde59a8d8b251ce4dc Mon Sep 17 00:00:00 2001
From: Tomasz Molski <41341072+KappaPrajd@users.noreply.github.com>
Date: Wed, 5 Mar 2025 19:34:35 +0100
Subject: [PATCH 603/716] feat: added LeagueOfLegendsNewsBridge (#4462)

---
 bridges/LeagueOfLegendsNewsBridge.php | 118 ++++++++++++++++++++++++++
 1 file changed, 118 insertions(+)
 create mode 100644 bridges/LeagueOfLegendsNewsBridge.php

diff --git a/bridges/LeagueOfLegendsNewsBridge.php b/bridges/LeagueOfLegendsNewsBridge.php
new file mode 100644
index 00000000..57e4f792
--- /dev/null
+++ b/bridges/LeagueOfLegendsNewsBridge.php
@@ -0,0 +1,118 @@
+<?php
+
+class LeagueOfLegendsNewsBridge extends BridgeAbstract
+{
+    const NAME = 'League of Legends News';
+    const URI = 'https://www.leagueoflegends.com';
+    const DESCRIPTION = 'Official League of Legends news.';
+    const MAINTAINER = 'KappaPrajd';
+    const PARAMETERS = [
+        [
+            'language' => [
+                'name' => 'Language',
+                'type' => 'list',
+                'defaultValue' => 'en-us',
+                'values' => [
+                    'English (NA)' => 'en-us',
+                    'English (EUW)' => 'en-gb',
+                    'Deutsch' => 'de-de',
+                    'Español (EUW)' => 'es-es',
+                    'Français' => 'fr-fr',
+                    'Italiano' => 'it-it',
+                    'Polski' => 'pl-pl',
+                    'Ελληνικά' => 'el-gr',
+                    'Română' => 'ro-ro',
+                    'Magyar' => 'hu-hu',
+                    'Čeština' => 'cs-cz',
+                    'Español (LATAM)' => 'es-mx',
+                    'Português' => 'pt-br',
+                    '日本語' => 'ja-jp',
+                    'Русский' => 'ru-ru',
+                    'Türkçe' => 'tr-tr',
+                    'English (OCE)' => 'en-au',
+                    '한국어' => 'ko-kr',
+                    'English (SG)' => 'en-sg',
+                    'English (PH)' => 'en-ph',
+                    'Tiếng Việt' => 'vi-vn',
+                    'ภาษาไทย' => 'th-th',
+                    '繁體中文' => 'zh-tw',
+                    'العربية' => 'ar-ae'
+                ]
+            ],
+            'category' => [
+                'name' => 'Category',
+                'type' => 'list',
+                'defaultValue' => 'all',
+                'values' => [
+                    'All' => 'all',
+                    'Game updates' => 'game-updates',
+                    'Esports' => 'esports',
+                    'Dev' => 'dev',
+                    'Lore' => 'lore',
+                    'Media' => 'media',
+                    'Merch' => 'merch',
+                    'Community' => 'community',
+                    'Riot Games' => 'riot-games'
+                ]
+            ],
+            'onlyPatchNotes' => [
+                'name' => 'Only patch notes',
+                'type' => 'checkbox',
+                'defaultValue' => false,
+            ],
+        ],
+
+    ];
+
+    public function collectData()
+    {
+        $siteUrl = $this->getSiteUrl();
+        $html = getSimpleHTMLDOM($siteUrl);
+
+        $articles = $html->find('a[data-testid=articlefeaturedcard-component]');
+
+        foreach ($articles as $article) {
+            $title = $article->find('div[data-testid=card-title]', 0)->plaintext;
+            $content = $article->find('div[data-testid=card-description] div div div', 0)->plaintext;
+            $timestamp = $article->find('div[data-testid=card-date] time', 0)->getAttribute('datetime');
+            $href = $article->getAttribute('href');
+
+            $item = [
+                'title' => $title,
+                'content' => $content,
+                'timestamp' => $timestamp,
+                'uri' => $this->getArticleUri($href),
+            ];
+
+            $this->items[] = $item;
+        }
+    }
+
+    private function getSiteUrl()
+    {
+        $lang = $this->getInput('language');
+        $category = $this->getInput('category');
+        $onlyPatchNotes = $this->getInput('onlyPatchNotes');
+
+        $url = self::URI . '/' . $lang . '/news';
+
+        if ($onlyPatchNotes) {
+            return $url . '/tags/patch-notes';
+        } else if ($category === 'all') {
+            return $url;
+        }
+
+        return $url . '/' . $category;
+    }
+
+    private function getArticleUri($href)
+    {
+        $isInternalLink = str_starts_with($href, '/');
+
+        if ($isInternalLink) {
+            return self::URI . $href;
+        }
+
+        return $href;
+    }
+}
\ No newline at end of file

From 83c36a87e29de7ba6038e58145ac3bca885bae9e Mon Sep 17 00:00:00 2001
From: Tomasz Molski <41341072+KappaPrajd@users.noreply.github.com>
Date: Wed, 5 Mar 2025 19:35:12 +0100
Subject: [PATCH 604/716] [ReutersBridge] Adjust Fact Check feed path (#4465)

---
 bridges/ReutersBridge.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/bridges/ReutersBridge.php b/bridges/ReutersBridge.php
index 07b3061c..5b8e08f6 100644
--- a/bridges/ReutersBridge.php
+++ b/bridges/ReutersBridge.php
@@ -35,7 +35,7 @@ class ReutersBridge extends BridgeAbstract
                 'title' => 'Feeds from Reuters U.S/International edition',
                 'values' => [
                     'Top News' => 'home/topnews',
-                    'Fact Check' => 'chan:abtpk0vm',
+                    'Fact Check' => '/fact-check',
                     'Entertainment' => 'chan:8ym8q8dl',
                     'Politics' => 'politics',
                     'Wire' => 'wire',
@@ -137,7 +137,6 @@ class ReutersBridge extends BridgeAbstract
 
     const OLD_WIRE_SECTION = [
         'home/topnews',
-        'chan:abtpk0vm',
         'chan:8ym8q8dl',
         'politics',
         'wire'

From f270cd35e71a2df8858dd6975e1b4653e9732bd9 Mon Sep 17 00:00:00 2001
From: Pavel Korytov <thexcloud@gmail.com>
Date: Wed, 5 Mar 2025 21:36:41 +0300
Subject: [PATCH 605/716] [TldrTechBridge] Fix duplicate entries and empty
 sections (#4466)

---
 bridges/TldrTechBridge.php | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/bridges/TldrTechBridge.php b/bridges/TldrTechBridge.php
index 222cd49e..7813933f 100644
--- a/bridges/TldrTechBridge.php
+++ b/bridges/TldrTechBridge.php
@@ -57,6 +57,9 @@ class TldrTechBridge extends BridgeAbstract
                 continue;
             }
             $itemUrl = Url::fromString(self::URI . ltrim($child->href, '/'));
+            if ($itemUrl == $locationUrl) {
+                continue;
+            }
             $this->extractItem($itemUrl);
             if (count($this->items) >= $limit) {
                 break;
@@ -125,6 +128,11 @@ class TldrTechBridge extends BridgeAbstract
                 }
             }
         }
+        foreach ($content->find('section') as $section) {
+            if (count($section->children()) == 0) {
+                $content->removeChild($section);
+            }
+        }
         $title = $content->find('h2', 0);
         return [$content->innertext, $title->plaintext];
     }

From 744f996224ff4ce7c2d199605f79ffbdc7877acc Mon Sep 17 00:00:00 2001
From: Latz <latz@elektroelch.de>
Date: Wed, 5 Mar 2025 19:39:18 +0100
Subject: [PATCH 606/716] =?UTF-8?q?Added=20bridge=20for=20Toms=20Touch?=
 =?UTF-8?q?=C3=A9=20(https://taz.de/#!tom=3Dtomdestages)=20(#4438)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 bridges/TomsToucheBridge.php | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 bridges/TomsToucheBridge.php

diff --git a/bridges/TomsToucheBridge.php b/bridges/TomsToucheBridge.php
new file mode 100644
index 00000000..3e21fdcb
--- /dev/null
+++ b/bridges/TomsToucheBridge.php
@@ -0,0 +1,28 @@
+<?php
+
+class TomsToucheBridge extends BridgeAbstract
+{
+    const NAME = 'Toms Touché';
+    const URI = 'https://taz.de/#!tom=tomdestages';
+    const DESCRIPTION = 'Your daily dose of Toms Touche.';
+    const MAINTAINER = 'latz';
+    const CACHE_TIMEOUT = 3600; // 1h
+
+    public function collectData()
+    {
+        $url = 'https://taz.de/';
+        $html = getSimpleHTMLDOM($url); // Docs: https://simplehtmldom.sourceforge.io/docs/1.9/index.html
+        $date = $html->find('p[x-ref]');
+        $date = trim($date[0]->innertext);
+        [$day, $month, $year] = explode('.', $date);
+        $image = $html->find('img[alt="tom des tages"]');
+
+        $item = [];
+        $item['title'] = "Toms Touché - $date";
+        $item['uri'] = 'https://taz.de/#!tom=tomdestages';
+        $item['timestamp'] = mktime(0, 0, 0, $month, $day, $year);
+        $item['content'] = $image[0] . '</img>'; // This isn't good HTML style, but at least syntactically correct
+        $item['uid'] = $image[0]->getAttribute('src');
+        $this->items[] = $item;
+    }
+}

From dee734d360c38a811f6788961d8c47320ad128ed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Andr=C3=A9=20Andersson?= <andre.eric.andersson@gmail.com>
Date: Wed, 5 Mar 2025 19:41:24 +0100
Subject: [PATCH 607/716] Add Auctionet bridge (#4452)

---
 bridges/AuctionetBridge.php | 344 ++++++++++++++++++++++++++++++++++++
 1 file changed, 344 insertions(+)
 create mode 100644 bridges/AuctionetBridge.php

diff --git a/bridges/AuctionetBridge.php b/bridges/AuctionetBridge.php
new file mode 100644
index 00000000..fbdee441
--- /dev/null
+++ b/bridges/AuctionetBridge.php
@@ -0,0 +1,344 @@
+<?php
+
+class AuctionetBridge extends BridgeAbstract
+{
+    const NAME = 'Auctionet';
+    const URI = 'https://www.auctionet.com';
+    const DESCRIPTION = 'Fetches info about auction objects from Auctionet (an auction platform for many European auction houses)';
+    const MAINTAINER = 'Qluxzz';
+    const PARAMETERS = [[
+        'category' => [
+            'name' => 'Category',
+            'type' => 'list',
+            'values' => [
+                'All categories' => '',
+                'Art' => [
+                    'All' => '25-art',
+                    'Drawings' => '119-drawings',
+                    'Engravings & Prints' => '27-engravings-prints',
+                    'Other' => '30-other',
+                    'Paintings' => '28-paintings',
+                    'Photography' => '26-photography',
+                    'Sculptures & Bronzes' => '29-sculptures-bronzes',
+                ],
+                'Asiatica' => [
+                    'All' => '117-asiatica',
+                ],
+                'Books, Maps & Manuscripts' => [
+                    'All' => '50-books-maps-manuscripts',
+                    'Autographs & Manuscripts' => '206-autographs-manuscripts',
+                    'Books' => '204-books',
+                    'Maps' => '205-maps',
+                    'Other' => '207-other',
+                ],
+                'Carpets & Textiles' => [
+                    'All' => '35-carpets-textiles',
+                    'Carpets' => '36-carpets',
+                    'Textiles' => '37-textiles',
+                ],
+                'Ceramics & Porcelain' => [
+                    'All' => '9-ceramics-porcelain',
+                    'European' => '10-european',
+                    'Oriental' => '11-oriental',
+                    'Rest of the world' => '12-rest-of-the-world',
+                    'Tableware' => '210-tableware',
+                ],
+                'Clocks & Watches' => [
+                    'All' => '31-clocks-watches',
+                    'Carriage & Miniature Clocks' => '258-carriage-miniature-clocks',
+                    'Longcase clocks' => '32-longcase-clocks',
+                    'Mantel clocks' => '33-mantel-clocks',
+                    'Other clocks' => '34-other-clocks',
+                    'Pocket & Stop Watches' => '110-pocket-stop-watches',
+                    'Wall Clocks' => '127-wall-clocks',
+                    'Wristwatches' => '15-wristwatches',
+                ],
+                'Coins, Medals & Stamps' => [
+                    'All' => '46-coins-medals-stamps',
+                    'Coins' => '128-coins',
+                    'Orders & Medals' => '135-orders-medals',
+                    'Other' => '131-other',
+                    'Stamps' => '136-stamps',
+                ],
+                'Folk art' => [
+                    'All' => '58-folk-art',
+                    'Bowls & Boxes' => '121-bowls-boxes',
+                    'Furniture' => '122-furniture',
+                    'Other' => '123-other',
+                    'Tools & Gears' => '120-tools-gears',
+                ],
+                'Furniture' => [
+                    'All' => '16-furniture',
+                    'Armchairs & Chairs' => '18-armchairs-chairs',
+                    'Chests of drawers' => '24-chests-of-drawers',
+                    'Cupboards, Cabinets & Shelves' => '23-cupboards-cabinets-shelves',
+                    'Dining room furniture' => '22-dining-room-furniture',
+                    'Garden' => '21-garden',
+                    'Other' => '17-other',
+                    'Sofas & seatings' => '20-sofas-seatings',
+                    'Tables' => '19-tables',
+                ],
+                'Glass' => [
+                    'All' => '6-glass',
+                    'Art glass' => '208-art-glass',
+                    'Other' => '8-other',
+                    'Tableware' => '7-tableware',
+                    'Utility glass' => '209-utility-glass',
+                ],
+                'Jewellery & Gemstones' => [
+                    'All' => '13-jewellery-gemstones',
+                    'Alliance rings' => '113-alliance-rings',
+                    'Bracelets' => '106-bracelets',
+                    'Brooches & Pendants' => '107-brooches-pendants',
+                    'Costume Jewellery' => '259-costume-jewellery',
+                    'Cufflinks & Tie Pins' => '111-cufflinks-tie-pins',
+                    'Ear studs' => '116-ear-studs',
+                    'Earrings' => '115-earrings',
+                    'Gemstones' => '48-gemstones',
+                    'Jewellery' => '14-jewellery',
+                    'Jewellery Suites' => '109-jewellery-suites',
+                    'Necklace' => '104-necklace',
+                    'Other' => '118-other',
+                    'Rings' => '112-rings',
+                    'Signet rings' => '105-signet-rings',
+                    'Solitaire rings' => '114-solitaire-rings',
+                ],
+                'Licence weapons' => [
+                    'All' => '59-licence-weapons',
+                    'Combi/Combo' => '63-combi-combo',
+                    'Double express rifles' => '60-double-express-rifles',
+                    'Rifles' => '61-rifles',
+                    'Shotguns' => '62-shotguns',
+                ],
+                'Lighting & Lamps' => [
+                    'All' => '1-lighting-lamps',
+                    'Candlesticks' => '4-candlesticks',
+                    'Ceiling lights' => '3-ceiling-lights',
+                    'Chandeliers' => '203-chandeliers',
+                    'Floor lights' => '2-floor-lights',
+                    'Other lighting' => '5-other-lighting',
+                    'Table Lamps' => '125-table-lamps',
+                    'Wall Lights' => '124-wall-lights',
+                ],
+                'Mirrors' => [
+                    'All' => '42-mirrors',
+                ],
+                'Miscellaneous' => [
+                    'All' => '43-miscellaneous',
+                    'Fishing equipment' => '54-fishing-equipment',
+                    'Miscellaneous' => '47-miscellaneous',
+                    'Modern Tools' => '133-modern-tools',
+                    'Modern consumer electronics' => '52-modern-consumer-electronics',
+                    'Musical instruments' => '51-musical-instruments',
+                    'Technica & Nautica' => '45-technica-nautica',
+                ],
+                'Photo, Cameras & Lenses' => [
+                    'All' => '57-photo-cameras-lenses',
+                    'Cameras & accessories' => '71-cameras-accessories',
+                    'Optics' => '66-optics',
+                    'Other' => '72-other',
+                ],
+                'Silver & Metals' => [
+                    'All' => '38-silver-metals',
+                    'Other metals' => '40-other-metals',
+                    'Pewter, Brass & Copper' => '41-pewter-brass-copper',
+                    'Silver' => '39-silver',
+                    'Silver plated' => '213-silver-plated',
+                ],
+                'Toys' => [
+                    'All' => '44-toys',
+                    'Comics' => '211-comics',
+                    'Toys' => '212-toys',
+                ],
+                'Tribal art' => [
+                    'All' => '134-tribal-art',
+                ],
+                'Vehicles, Boats & Parts' => [
+                    'All' => '249-vehicles-boats-parts',
+                    'Automobilia & Transport' => '255-automobilia-transport',
+                    'Bicycles' => '132-bicycles',
+                    'Boats & Accessories' => '250-boats-accessories',
+                    'Car parts' => '253-car-parts',
+                    'Cars' => '215-cars',
+                    'Moped parts' => '254-moped-parts',
+                    'Mopeds' => '216-mopeds',
+                    'Motorcycle parts' => '252-motorcycle-parts',
+                    'Motorcycles' => '251-motorcycles',
+                    'Other' => '256-other',
+                ],
+                'Vintage & Designer Fashion' => [
+                    'All' => '49-vintage-designer-fashion',
+                ],
+                'Weapons & Militaria' => [
+                    'All' => '137-weapons-militaria',
+                    'Airguns' => '257-airguns',
+                    'Armour & Uniform' => '138-armour-uniform',
+                    'Edged weapons' => '130-edged-weapons',
+                    'Guns & Rifles' => '129-guns-rifles',
+                    'Other' => '214-other',
+                ],
+                'Wine, Port & Spirits' => [
+                    'All' => '170-wine-port-spirits',
+                ],
+            ]
+        ],
+        'sort_order' => [
+            'name' => 'Sort order',
+            'type' => 'list',
+            'values' => [
+                'Most bids' => 'bids_count_desc',
+                'Lowest bid' => 'bid_asc',
+                'Highest bid' => 'bid_desc',
+                'Last bid on' => 'bid_on',
+                'Ending soonest' => 'end_asc_active',
+                'Lowest estimate' => 'estimate_asc',
+                'Highest estimate' => 'estimate_desc',
+                'Recently added' => 'recent'
+            ],
+        ],
+        'country' => [
+            'name' => 'Country',
+            'type' => 'list',
+            'values' => [
+                'All' => '',
+                'Denmark' => 'DK',
+                'Finland' => 'FI',
+                'Germany' => 'DE',
+                'Spain' => 'ES',
+                'Sweden' => 'SE',
+                'United Kingdom' => 'GB'
+            ]
+        ],
+        'language' => [
+            'name' => 'Language',
+            'type' => 'list',
+            'values' => [
+                'English' => 'en',
+                'Español' => 'es',
+                'Deutsch' => 'de',
+                'Svenska' => 'sv',
+                'Dansk' => 'da',
+                'Suomi' => 'fi',
+            ],
+        ],
+    ]];
+
+    const CACHE_TIMEOUT = 3600; // 1 hour
+
+    private $title;
+
+    public function collectData()
+    {
+        // Each page contains 48 auctions
+        // So we fetch 10 pages so we decrease the likelihood
+        // of missing auctions between feed refreshes
+
+        // Fetch first page and use that to get title
+        {
+            $url = $this->getUrl(1);
+            $data = getContents($url);
+
+            $title = $this->getDocumentTitle($data);
+
+            $this->items = array_merge($this->items, $this->parsePageData($data));
+        }
+
+        // Fetch remaining pages
+        for ($page = 2; $page <= 10; $page++) {
+            $url = $this->getUrl($page);
+
+            $data = getContents($url);
+
+            $this->items = array_merge($this->items, $this->parsePageData($data));
+        }
+    }
+
+    public function getName()
+    {
+        return $this->title ?: parent::getName();
+    }
+
+
+    /* HELPERS */
+
+    private function getUrl($page)
+    {
+        $category = $this->getInput('category');
+        $language = $this->getInput('language');
+        $sort_order = $this->getInput('sort_order');
+        $country = $this->getInput('country');
+
+        $url = self::URI . '/' . $language . '/search';
+
+        if ($category) {
+            $url = $url . '/' . $category;
+        }
+
+        $query = [];
+        $query['page'] = $page;
+
+        if ($sort_order) {
+            $query['order'] = $sort_order;
+        }
+
+        if ($country) {
+            $query['country_code'] = $country;
+        }
+
+        if (count($query) > 0) {
+            $url = $url . '?' . http_build_query($query);
+        }
+
+        return $url;
+    }
+
+    private function getDocumentTitle($data)
+    {
+        $title_elem = '<title>';
+        $title_elem_length = strlen($title_elem);
+        $title_start = strpos($data, $title_elem);
+        $title_end = strpos($data, '</title>', $title_start);
+        $title_length = $title_end - $title_start + strlen($title_elem);
+        $title = substr($data, $title_start + strlen($title_elem), $title_length);
+
+        return $title;
+    }
+
+    /**
+     * The auction items data is included in the HTML document
+     * as a HTML entities encoded JSON structure
+     * which is used to hydrate the React component for the list of auctions
+     */
+    private function parsePageData($data)
+    {
+        $key = 'data-react-props="';
+        $keyLength = strlen($key);
+
+        $start = strpos($data, $key);
+        $end = strpos($data, '"', $start + strlen($key));
+        $length = $end - ($start + $keyLength);
+
+        $jsonString = substr($data, $start + $keyLength, $length);
+
+        $jsonData = json_decode(htmlspecialchars_decode($jsonString), false);
+
+        $items = [];
+
+        foreach ($jsonData->{'items'} as $item) {
+            $title = $item->{'longTitle'};
+            $relative_url = $item->{'url'};
+            $images = $item->{'imageUrls'};
+            $id = $item->{'auctionId'};
+
+            $items[] = [
+                'title' => $title,
+                'uri' => self::URI . $relative_url,
+                'uid' => $id,
+                'content' => count($images) > 0 ? "<img src='$images[0]'/><br/>$title" : $title,
+                'enclosures' => array_slice($images, 1),
+            ];
+        }
+
+        return $items;
+    }
+}

From 87ab1e45132aadb4ff00c58d1ccb9f3cda438077 Mon Sep 17 00:00:00 2001
From: Tomasz Molski <41341072+KappaPrajd@users.noreply.github.com>
Date: Sun, 23 Mar 2025 19:50:11 +0100
Subject: [PATCH 608/716] [BruegelBridge] Initial commit (#4470)

---
 bridges/BruegelBridge.php | 63 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 bridges/BruegelBridge.php

diff --git a/bridges/BruegelBridge.php b/bridges/BruegelBridge.php
new file mode 100644
index 00000000..b7813dbc
--- /dev/null
+++ b/bridges/BruegelBridge.php
@@ -0,0 +1,63 @@
+<?php
+
+class BruegelBridge extends BridgeAbstract
+{
+    const NAME = 'Bruegel';
+    const URI = 'https://www.bruegel.org';
+    const DESCRIPTION = 'European think-tank commentary and publications.';
+    const MAINTAINER = 'KappaPrajd';
+    const PARAMETERS = [
+        [
+            'category' => [
+                'name' => 'Category',
+                'type' => 'list',
+                'defaultValue' => '/publications',
+                'values' => [
+                    'Publications' => '/publications',
+                    'Commentary' => '/commentary'
+                ]
+            ]
+        ]
+    ];
+
+    public function getIcon()
+    {
+        return self::URI . '/themes/custom/bruegel/assets/favicon/android-icon-72x72.png';
+    }
+
+    public function collectData()
+    {
+        $url = self::URI . $this->getInput('category');
+        $html = getSimpleHTMLDOM($url);
+
+        $articles = $html->find('.c-listing__content article');
+
+        foreach ($articles as $article) {
+            $title = $article->find('.c-list-item__title a span', 0)->plaintext;
+            $content = trim($article->find('.c-list-item__description', 0)->plaintext);
+            $publishDate = $article->find('.c-list-item__date', 0)->plaintext;
+            $href = $article->find('.c-list-item__title a', 0)->getAttribute('href');
+
+            $item = [
+                'title' => $title,
+                'content' => $content,
+                'timestamp' => strtotime($publishDate),
+                'uri' => self::URI . $href,
+                'author' => $this->getAuthor($article),
+            ];
+
+            $this->items[] = $item;
+        }
+    }
+
+    private function getAuthor($article)
+    {
+        $authorsElements = $article->find('.c-list-item__authors a');
+
+        $authors = array_map(function ($author) {
+            return $author->plaintext;
+        }, $authorsElements);
+
+        return join(', ', $authors);
+    }
+}
\ No newline at end of file

From 7260f28e1007fc35193043ecac263a99a1025794 Mon Sep 17 00:00:00 2001
From: chibicitiberiu <chibicitiberiu@users.noreply.github.com>
Date: Sun, 23 Mar 2025 21:45:35 +0200
Subject: [PATCH 609/716] [RedditBridge] Added time interval and filter for min
 comment count (#4471)

* Reddit Bridge - added filter for min comment count and time interval.

* [RedditBridge] Add sort by comment count

* lint

* consistent commas

---------

Co-authored-by: Dag <me@dvikan.no>
---
 bridges/RedditBridge.php   | 49 +++++++++++++++++++++++++++++++++-----
 tests/RedditBridgeTest.php | 16 ++++++-------
 2 files changed, 51 insertions(+), 14 deletions(-)

diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index 2a3824f4..005ccade 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -20,7 +20,15 @@ class RedditBridge extends BridgeAbstract
                 'required' => false,
                 'type' => 'number',
                 'exampleValue' => 100,
-                'title' => 'Filter out posts with lower score'
+                'title' => 'Filter out posts with lower score. Set to -1 to disable. If both score and comments are set, an OR is applied.',
+            ],
+            'min_comments' => [
+                'name' => 'Minimal number of comments',
+                'required' => false,
+                'type' => 'number',
+                'exampleValue' => 100,
+                'title' => 'Filter out posts with lower number of comments. Set to -1 to disable. If both score and comments are set, an OR is applied.',
+                'defaultValue' => -1
             ],
             'd' => [
                 'name' => 'Sort By',
@@ -30,10 +38,25 @@ class RedditBridge extends BridgeAbstract
                     'Hot' => 'hot',
                     'Relevance' => 'relevance',
                     'New' => 'new',
-                    'Top' => 'top'
+                    'Top' => 'top',
+                    'Comments' => 'comments',
                 ],
                 'defaultValue' => 'Hot'
             ],
+            't' => [
+                'name' => 'Time',
+                'type' => 'list',
+                'title' => 'Sort by new, hot, top or relevancy',
+                'values' => [
+                    'All' => 'all',
+                    'Year' => 'year',
+                    'Month' => 'month',
+                    'Week' => 'week',
+                    'Day' => 'day',
+                    'Hour' => 'hour',
+                ],
+                'defaultValue' => 'week'
+            ],
             'search' => [
                 'name' => 'Keyword search',
                 'required' => false,
@@ -126,6 +149,7 @@ class RedditBridge extends BridgeAbstract
             $frontend = 'https://old.reddit.com';
         }
         $section = $this->getInput('d');
+        $time = $this->getInput('t');
 
         switch ($this->queriedContext) {
             case 'single':
@@ -147,7 +171,7 @@ class RedditBridge extends BridgeAbstract
         foreach ($subreddits as $subreddit) {
             $version = 'v0.0.2';
             $useragent = "rss-bridge $version (https://github.com/RSS-Bridge/rss-bridge)";
-            $url = self::createUrl($search, $flareInput, $subreddit, $user, $section, $this->queriedContext);
+            $url = self::createUrl($search, $flareInput, $subreddit, $user, $section, $time, $this->queriedContext);
 
             $response = getContents($url, ['User-Agent: ' . $useragent], [], true);
 
@@ -162,8 +186,20 @@ class RedditBridge extends BridgeAbstract
 
                 $data = $post->data;
 
-                if ($data->score < $this->getInput('score')) {
-                    continue;
+                $min_score = $this->getInput('score');
+                $min_comments = $this->getInput('min_comments');
+                if ($min_score >= 0 && $min_comments >= 0) {
+                    if ($data->num_comments < $min_comments || $data->score < $min_score) {
+                        continue;
+                    }
+                } elseif ($min_score >= 0) {
+                    if ($data->score < $min_score) {
+                        continue;
+                    }
+                } elseif ($min_comments >= 0) {
+                    if ($data->num_comments < $min_comments) {
+                        continue;
+                    }
                 }
 
                 $item = [];
@@ -264,7 +300,7 @@ class RedditBridge extends BridgeAbstract
         });
     }
 
-    public static function createUrl($search, $flareInput, $subreddit, bool $user, $section, $queriedContext): string
+    public static function createUrl($search, $flareInput, $subreddit, bool $user, $section, $time, $queriedContext): string
     {
         if ($search === '') {
             $keywords = '';
@@ -286,6 +322,7 @@ class RedditBridge extends BridgeAbstract
             'q' => $keywords . $flair . ($user ? 'author:' : 'subreddit:') . $name,
             'sort' => $section,
             'include_over_18' => 'on',
+            't' => $time
         ];
         return 'https://old.reddit.com/search.json?' . http_build_query($query);
     }
diff --git a/tests/RedditBridgeTest.php b/tests/RedditBridgeTest.php
index 17a62e68..5455ca97 100644
--- a/tests/RedditBridgeTest.php
+++ b/tests/RedditBridgeTest.php
@@ -11,23 +11,23 @@ class RedditBridgeTest extends TestCase
         $sut = new RedditBridge(new NullCache(), new NullLogger());
 
         // https://old.reddit.com/search.json?q=cats dogs hen subreddit:php&sort=hot&include_over_18=on
-        $expected = 'https://old.reddit.com/search.json?q=cats+dogs+hen+subreddit%3Aphp&sort=hot&include_over_18=on';
-        $actual = RedditBridge::createUrl('cats,dogs hen', '', 'php', false, 'hot', 'single');
+        $expected = 'https://old.reddit.com/search.json?q=cats+dogs+hen+subreddit%3Aphp&sort=hot&include_over_18=on&t=all';
+        $actual = RedditBridge::createUrl('cats,dogs hen', '', 'php', false, 'hot', 'all', 'single');
         $this->assertSame($expected, $actual);
 
         // https://old.reddit.com/search.json?q=author:RavenousRandy&sort=hot&include_over_18=on
-        $expected = 'https://old.reddit.com/search.json?q=author%3ARavenousRandy&sort=hot&include_over_18=on';
-        $actual = RedditBridge::createUrl('', '', 'RavenousRandy', true, 'hot', 'user');
+        $expected = 'https://old.reddit.com/search.json?q=author%3ARavenousRandy&sort=hot&include_over_18=on&t=week';
+        $actual = RedditBridge::createUrl('', '', 'RavenousRandy', true, 'hot', 'week', 'user');
         $this->assertSame($expected, $actual);
 
         // https://old.reddit.com/search.json?q=cats dogs hen flair:"Proxy" subreddit:php&sort=hot&include_over_18=on
-        $expected = 'https://old.reddit.com/search.json?q=cats+dogs+hen+flair%3A%22Proxy%22+subreddit%3Aphp&sort=hot&include_over_18=on';
-        $actual = RedditBridge::createUrl('cats,dogs hen', 'Proxy', 'php', false, 'hot', 'single');
+        $expected = 'https://old.reddit.com/search.json?q=cats+dogs+hen+flair%3A%22Proxy%22+subreddit%3Aphp&sort=hot&include_over_18=on&t=month';
+        $actual = RedditBridge::createUrl('cats,dogs hen', 'Proxy', 'php', false, 'hot', 'month', 'single');
         $this->assertSame($expected, $actual);
 
         // https://old.reddit.com/search.json?q=cats dogs hen flair:"Proxy Linux Server" subreddit:php&sort=hot&include_over_18=on
-        $expected = 'https://old.reddit.com/search.json?q=cats+dogs+hen+flair%3A%22Proxy+Linux+Server%22+subreddit%3Aphp&sort=hot&include_over_18=on';
-        $actual = RedditBridge::createUrl('cats,dogs hen', 'Proxy,Linux Server', 'php', false, 'hot', 'single');
+        $expected = 'https://old.reddit.com/search.json?q=cats+dogs+hen+flair%3A%22Proxy+Linux+Server%22+subreddit%3Aphp&sort=hot&include_over_18=on&t=day';
+        $actual = RedditBridge::createUrl('cats,dogs hen', 'Proxy,Linux Server', 'php', false, 'hot', 'day', 'single');
         $this->assertSame($expected, $actual);
     }
 }

From 91fe6c1fae1a81afc8cd6d91705f6645023cf884 Mon Sep 17 00:00:00 2001
From: Dan Wainwright <dan.wainwright2@gmail.com>
Date: Sun, 23 Mar 2025 21:57:17 +0200
Subject: [PATCH 610/716] [BazarakiBridge] Add new bridge (#4473)

* [BazarakiBridge] Add new bridge

* fix

---------

Co-authored-by: Dag <me@dvikan.no>
---
 bridges/BazarakiBridge.php | 139 +++++++++++++++++++++++++++++++++++++
 1 file changed, 139 insertions(+)
 create mode 100644 bridges/BazarakiBridge.php

diff --git a/bridges/BazarakiBridge.php b/bridges/BazarakiBridge.php
new file mode 100644
index 00000000..44e4eb84
--- /dev/null
+++ b/bridges/BazarakiBridge.php
@@ -0,0 +1,139 @@
+<?php
+
+class BazarakiBridge extends BridgeAbstract
+{
+    const NAME = 'Bazaraki Bridge';
+    const URI = 'https://bazaraki.com';
+    const DESCRIPTION = 'Fetch adverts from Bazaraki, a Cyprus-based classifieds website.';
+    const MAINTAINER = 'danwain';
+    const PARAMETERS = [
+        [
+            'url' => [
+                'name'         => 'URL',
+                'type'         => 'text',
+                'required'     => true,
+                'title'        => 'Enter the URL of the Bazaraki page to fetch adverts from.',
+                'exampleValue' => 'https://www.bazaraki.com/real-estate-for-sale/houses/?lat=0&lng=0&radius=100000',
+            ],
+            'limit' => [
+                'name'         => 'Limit',
+                'type'         => 'number',
+                'required'     => false,
+                'title'        => 'Enter the number of adverts to fetch. (max 50)',
+                'exampleValue' => '10',
+                'defaultValue' => 10,
+            ]
+        ]
+    ];
+
+    public function collectData()
+    {
+        $url = $this->getInput('url');
+        if (! str_starts_with($url, 'https://www.bazaraki.com/')) {
+            throw new \Exception('Nope');
+        }
+
+        $html = getSimpleHTMLDOM($url);
+
+        $i = 0;
+        foreach ($html->find('div.advert') as $element) {
+            $i++;
+            if ($i > $this->getInput('limit') || $i > 50) {
+                break;
+            }
+
+            $item = [];
+
+            $item['uri'] = 'https://www.bazaraki.com' . $element->find('a.advert__content-title', 0)->href;
+
+            # Get the content
+            $advert = getSimpleHTMLDOM($item['uri']);
+
+            $price = trim($advert->find('div.announcement-price__cost', 0)->plaintext);
+            $name  = trim($element->find('a.advert__content-title', 0)->plaintext);
+
+            $item['title'] = $name . ' - ' . $price;
+
+            $time = trim($advert->find('span.date-meta', 0)->plaintext);
+            $time = str_replace('Posted: ', '', $time);
+
+
+            $item['content'] = $this->processAdvertContent($advert);
+            $item['timestamp'] = $this->convertRelativeTime($time);
+            $item['author'] = trim($advert->find('div.author-name', 0)->plaintext);
+            $item['uid'] = $advert->find('span.number-announcement', 0)->plaintext;
+
+            $this->items[] = $item;
+        }
+    }
+
+    /**
+     * Process the advert content to clean up HTML
+     *
+     * @param simple_html_dom $advert The SimpleHTMLDOM object for the advert page
+     * @return string Processed HTML content
+     */
+    private function processAdvertContent($advert)
+    {
+        // Get the content sections
+        $header = $advert->find('div.announcement-content-header', 0);
+        $characteristics = $advert->find('div.announcement-characteristics', 0);
+        $description = $advert->find('div.js-description', 0);
+        $images = $advert->find('div.announcement__images', 0);
+
+        // Remove all favorites divs
+        foreach ($advert->find('div.announcement-meta__favorites') as $favorites) {
+            $favorites->outertext = '';
+        }
+
+        // Replace all <a> tags with their text content
+        foreach ($advert->find('a') as $a) {
+            $a->outertext = $a->innertext;
+        }
+
+        // Format the content with section headers and dividers
+        $formattedContent = '';
+
+        // Add header section
+        $formattedContent .= $header->innertext;
+        $formattedContent .= '<hr/>';
+
+        // Add characteristics section with header
+        $formattedContent .= '<h3>Details</h3>';
+        $formattedContent .= $characteristics->innertext;
+        $formattedContent .= '<hr/>';
+
+        // Add description section with header
+        $formattedContent .= '<h3>Description</h3>';
+        $formattedContent .= $description->innertext;
+        $formattedContent .= '<hr/>';
+
+        // Add images section with header
+        $formattedContent .= '<h3>Images</h3>';
+        $formattedContent .= $images->innertext;
+
+        return $formattedContent;
+    }
+
+    /**
+     * Convert relative time strings like "Yesterday 12:32" to proper timestamps
+     *
+     * @param string $timeString The relative time string from the website
+     * @return string Timestamp in a format compatible with strtotime()
+     */
+    private function convertRelativeTime($timeString)
+    {
+        if (strpos($timeString, 'Yesterday') !== false) {
+            // Replace "Yesterday" with actual date
+            $time = str_replace('Yesterday', date('Y-m-d', strtotime('-1 day')), $timeString);
+            return date('Y-m-d H:i:s', strtotime($time));
+        } elseif (strpos($timeString, 'Today') !== false) {
+            // Replace "Today" with actual date
+            $time = str_replace('Today', date('Y-m-d'), $timeString);
+            return date('Y-m-d H:i:s', strtotime($time));
+        } else {
+            // For other formats, return as is and let strtotime handle it
+            return $timeString;
+        }
+    }
+}

From 05a9ac0f065006a282deb3607330581390afc162 Mon Sep 17 00:00:00 2001
From: Pavel Korytov <thexcloud@gmail.com>
Date: Sun, 23 Mar 2025 23:01:21 +0300
Subject: [PATCH 611/716] [OpenCVEBridge] Rewrite for API change (#4476)

* [OpenCVEBridge] Rewrite for API change

* [OpenCVEBridge] Fix lint
---
 bridges/OpenCVEBridge.php | 409 +++++++++++++++++++++++++++-----------
 1 file changed, 290 insertions(+), 119 deletions(-)

diff --git a/bridges/OpenCVEBridge.php b/bridges/OpenCVEBridge.php
index b5fc852b..1e528322 100644
--- a/bridges/OpenCVEBridge.php
+++ b/bridges/OpenCVEBridge.php
@@ -14,8 +14,8 @@ class OpenCVEBridge extends BridgeAbstract
             'instance' => [
                 'name' => 'OpenCVE Instance',
                 'required' => true,
-                'defaultValue' => 'https://www.opencve.io',
-                'exampleValue' => 'https://www.opencve.io'
+                'defaultValue' => 'https://app.opencve.io',
+                'exampleValue' => 'https://app.opencve.io'
             ],
             'login' => [
                 'name' => 'Login',
@@ -155,14 +155,14 @@ class OpenCVEBridge extends BridgeAbstract
                     $titlePrefix = '[' . $queryName . '] ';
                 }
 
-                foreach (json_decode($response) as $cveItem) {
-                    if (array_key_exists($cveItem->id, $fetchedIds)) {
+                foreach (json_decode($response)->results as $cveItem) {
+                    if (array_key_exists($cveItem->cve_id, $fetchedIds)) {
                         continue;
                     }
-                    $fetchedIds[$cveItem->id] = true;
+                    $fetchedIds[$cveItem->cve_id] = true;
                     $item = [
-                        'uri' => $instance . '/cve/' . $cveItem->id,
-                        'uid' => $cveItem->id,
+                        'uri' => $instance . '/cve/' . $cveItem->cve_id,
+                        'uid' => $cveItem->cve_id,
                     ];
                     if ($this->getInput('upd_timestamp') == 1) {
                         $item['timestamp'] = strtotime($cveItem->updated_at);
@@ -179,7 +179,7 @@ class OpenCVEBridge extends BridgeAbstract
                         $item['content'] = $content;
                         $item['title'] = $title;
                     } else {
-                        $item['content'] = $cveItem->summary . $this->getLinks($cveItem->id);
+                        $item['content'] = $cveItem->description . $this->getLinks($cveItem->cve_id);
                         $item['title'] = $this->getTitle($titlePrefix, $cveItem);
                     }
                     $this->items[] = $item;
@@ -193,17 +193,17 @@ class OpenCVEBridge extends BridgeAbstract
 
     private function getTitle($titlePrefix, $cveItem)
     {
-        $summary = $cveItem->summary;
+        $summary = $cveItem->description;
         $limit = $this->getInput('limit');
         if ($limit && mb_strlen($summary) > 100) {
             $summary = mb_substr($summary, 0, $limit) + '...';
         }
-        return $titlePrefix . $cveItem->id . '. ' . $summary;
+        return $titlePrefix . $cveItem->cve_id . '. ' . $summary;
     }
 
     private function fetchContents($cveItem, $titlePrefix, $instance, $authHeader)
     {
-        $url = $instance . '/api/cve/' . $cveItem->id;
+        $url = $instance . '/api/cve/' . $cveItem->cve_id;
 
         $response = getContents($url, [$authHeader]);
         $datum = json_decode($response);
@@ -211,26 +211,36 @@ class OpenCVEBridge extends BridgeAbstract
         $title = $this->getTitleFromDatum($datum, $titlePrefix);
 
         $result = self::CSS;
-        $result .= '<h1>' . $cveItem->id . '</h1>';
+        $result .= '<h1>' . $cveItem->cve_id . '</h1>';
         $result .= $this->getCVSSLabels($datum);
-        $result .= '<p>' . $datum->summary . '</p>';
+        $result .= '<p>' . $datum->description . '</p>';
         $result .= <<<EOD
             <h3>Information:</h3>
             <p>
               <ul>
-                <li><b>Publication date</b>: {$datum->raw_nvd_data->published}
-                <li><b>Last modified</b>: {$datum->raw_nvd_data->lastModified}
-                <li><b>Last modified</b>: {$datum->raw_nvd_data->lastModified}
+                <li><b>Created At</b>: {$datum->created_at}
+                <li><b>Updated At</b>: {$datum->updated_at}
               </ul>
             </p>
             EOD;
 
-        $result .= $this->getV3Table($datum);
-        $result .= $this->getV2Table($datum);
+        if (isset($datum->metrics->cvssV4_0->data->vector)) {
+            $result .= $this->cvssV4VectorToTable($datum->metrics->cvssV4_0->data->vector);
+        }
 
-        $result .= $this->getLinks($datum->id);
-        $result .= $this->getReferences($datum);
+        if (isset($datum->metrics->cvssV3_1->data->vector)) {
+            $result .= $this->cvssV3VectorToTable($datum->metrics->cvssV3_1->data->vector);
+        }
 
+        if (isset($datum->metrics->cvssV3_0->data->vector)) {
+            $result .= $this->cvssV3VectorToTable($datum->metrics->cvssV3_0->data->vector);
+        }
+
+        if (isset($datum->metrics->cvssV2_0->data->vector)) {
+            $result .= $this->cvssV2VectorToTable($datum->metrics->cvssV2_0->data->vector);
+        }
+
+        $result .= $this->getLinks($datum->cve_id);
         $result .= $this->getVendors($datum);
 
         return [$result, $title];
@@ -239,14 +249,20 @@ class OpenCVEBridge extends BridgeAbstract
     private function getTitleFromDatum($datum, $titlePrefix)
     {
         $title = $titlePrefix;
-        if ($datum->cvss->v3) {
-            $title .= "[v3: {$datum->cvss->v3}] ";
+        if (isset($datum->metrics->cvssV4_0->data->score)) {
+            $title .= "[v4: {$datum->metrics->cvssV4_0->data->score}] ";
         }
-        if ($datum->cvss->v2) {
-            $title .= "[v2: {$datum->cvss->v2}] ";
+        if (isset($datum->metrics->cvssV3_1->data->score)) {
+            $title .= "[v3.1: {$datum->metrics->cvssV3_1->data->score}] ";
         }
-        $title .= $datum->id . '. ';
-        $titlePostfix = $datum->summary;
+        if (isset($datum->metrics->cvssV3_0->data->score)) {
+            $title .= "[v3: {$datum->metrics->cvssV3_0->data->score}] ";
+        }
+        if (isset($datum->metrics->cvssV2_0->data->score)) {
+            $title .= "[v2: {$datum->metrics->cvssV2_0->data->score}] ";
+        }
+        $title .= $datum->cve_id . '. ';
+        $titlePostfix = $datum->description;
         $limit = $this->getInput('limit');
         if ($limit && mb_strlen($titlePostfix) > 100) {
             $titlePostfix = mb_substr($titlePostfix, 0, $limit) + '...';
@@ -257,64 +273,49 @@ class OpenCVEBridge extends BridgeAbstract
 
     private function getCVSSLabels($datum)
     {
-        $CVSSv2Text = 'n/a';
-        $CVSSv2Class = 'cvss-na-color';
-        if ($datum->cvss->v2) {
-            $importance = '';
-            if ($datum->cvss->v2 >= 7) {
-                $importance = 'HIGH';
-                $CVSSv2Class = 'cvss-high-color';
-            } else if ($datum->cvss->v2 >= 4) {
-                $importance = 'MEDIUM';
-                $CVSSv2Class = 'cvss-medium-color';
-            } else {
-                $importance = 'LOW';
-                $CVSSv2Class = 'cvss-low-color';
-            }
-            $CVSSv2Text = sprintf('[%s] %.1f', $importance, $datum->cvss->v2);
+        $cvss4 = '';
+        $cvss31 = '';
+        $cvss3 = '';
+        $cvss2 = '';
+        if (isset($datum->metrics->cvssV4_0->data->score)) {
+            $cvss4 = $this->formatCVSSLabel($datum->metrics->cvssV4_0->data->score, '4.0', 9, 7, 4);
+        }
+        if (isset($datum->metrics->cvssV3_1->data->score)) {
+            $cvss31 = $this->formatCVSSLabel($datum->metrics->cvssV3_1->data->score, '3.1', 9, 7, 4);
+        }
+        if (isset($datum->metrics->cvssV3_0->data->score)) {
+            $cvss3 = $this->formatCVSSLabel($datum->metrics->cvssV3_0->data->score, '3.0', 9, 7, 4);
+        }
+        if (isset($datum->metrics->cvssV2_0->data->score)) {
+            $cvss2 = $this->formatCVSSLabel($datum->metrics->cvssV2_0->data->score, '2.0', 99, 7, 4);
         }
-        $CVSSv2Item = "<div>CVSS v2: </div><div class=\"label {$CVSSv2Class}\">{$CVSSv2Text}</div>";
 
-        $CVSSv3Text = 'n/a';
-        $CVSSv3Class = 'cvss-na-color';
-        if ($datum->cvss->v3) {
-            $importance = '';
-            if ($datum->cvss->v3 >= 9) {
-                $importance = 'CRITICAL';
-                $CVSSv3Class = 'cvss-crit-color';
-            } else if ($datum->cvss->v3 >= 7) {
-                $importance = 'HIGH';
-                $CVSSv3Class = 'cvss-high-color';
-            } else if ($datum->cvss->v3 >= 4) {
-                $importance = 'MEDIUM';
-                $CVSSv3Class = 'cvss-medium-color';
-            } else {
-                $importance = 'LOW';
-                $CVSSv3Class = 'cvss-low-color';
-            }
-            $CVSSv3Text = sprintf('[%s] %.1f', $importance, $datum->cvss->v3);
-        }
-        $CVSSv3Item = "<div>CVSS v3: </div><div class=\"label {$CVSSv3Class}\">{$CVSSv3Text}</div>";
-        return '<div class="labels-row">' . $CVSSv3Item . $CVSSv2Item . '</div>';
+        return '<div class="labels-row">' . $cvss4 . $cvss31 . $cvss3 . $cvss2 . '</div>';
     }
 
-    private function getReferences($datum)
+    private function formatCVSSLabel($score, $version, $critical_thr, $high_thr, $medium_thr)
     {
-        if (count($datum->raw_nvd_data->references) == 0) {
-            return '';
-        }
-        $res = '<h3>References:</h3> <p><ul>';
-        foreach ($datum->raw_nvd_data->references as $ref) {
-            $item = '<li>';
-            if (isset($ref->tags) && count($ref->tags) > 0) {
-                $item .= '[' . implode(', ', $ref->tags) . '] ';
+        $text = 'n/a';
+        $class = 'cvss-na-color';
+        if ($score) {
+            $importance = '';
+            if ($score >= $critical_thr) {
+                $importance = 'CRITICAL';
+                $class = 'cvss-crit-color';
+            } else if ($score >= $high_thr) {
+                $importance = 'HIGH';
+                $class = 'cvss-high-color';
+            } else if ($score >= $medium_thr) {
+                $importance = 'MEDIUM';
+                $class = 'cvss-medium-color';
+            } else {
+                $importance = 'LOW';
+                $class = 'cvss-low-color';
             }
-            $item .= "<a href=\"{$ref->url}\">{$ref->url}</a>";
-            $item .= '<li>';
-            $res .= $item;
+            $text = sprintf('[%s] %.1f', $importance, $score);
         }
-        $res .= '</p></ul>';
-        return $res;
+        $item = "<div>CVSS {$version}: </div><div class=\"label {$class}\">{$text}</div>";
+        return $item;
     }
 
     private function getLinks($id)
@@ -331,84 +332,253 @@ class OpenCVEBridge extends BridgeAbstract
             EOD;
     }
 
-    private function getV3Table($datum)
+    private function cvssV3VectorToTable($cvssVector)
     {
-        $metrics = $datum->raw_nvd_data->metrics;
-        if (!isset($metrics->cvssMetricV31) || count($metrics->cvssMetricV31) == 0) {
-            return '';
+        $vectorComponents = [];
+        $parts = explode('/', $cvssVector);
+
+        if (!preg_match('/^CVSS:3\.[01]/', $parts[0])) {
+            return 'Error: Not a valid CVSS v3.0 or v3.1 vector';
         }
-        $v3 = $metrics->cvssMetricV31[0];
-        $data = $v3->cvssData;
-        return <<<EOD
-            <div class="cvss-table">
+
+        for ($i = 1; $i < count($parts); $i++) {
+            $component = explode(':', $parts[$i]);
+            if (count($component) == 2) {
+                $vectorComponents[$component[0]] = $component[1];
+            }
+        }
+
+        $readableNames = [
+            'AV' => ['N' => 'Network', 'A' => 'Adjacent', 'L' => 'Local', 'P' => 'Physical'],
+            'AC' => ['L' => 'Low', 'H' => 'High'],
+            'PR' => ['N' => 'None', 'L' => 'Low', 'H' => 'High'],
+            'UI' => ['N' => 'None', 'R' => 'Required'],
+            'S'  => ['U' => 'Unchanged', 'C' => 'Changed'],
+            'C'  => ['N' => 'None', 'L' => 'Low', 'H' => 'High'],
+            'I'  => ['N' => 'None', 'L' => 'Low', 'H' => 'High'],
+            'A'  => ['N' => 'None', 'L' => 'Low', 'H' => 'High']
+        ];
+
+        $data = new stdClass();
+        $data->attackVector = isset($readableNames['AV'][$vectorComponents['AV']]) ? $readableNames['AV'][$vectorComponents['AV']] : 'Unknown';
+        $data->attackComplexity = isset($readableNames['AC'][$vectorComponents['AC']]) ? $readableNames['AC'][$vectorComponents['AC']] : 'Unknown';
+        $data->privilegesRequired = isset($readableNames['PR'][$vectorComponents['PR']]) ? $readableNames['PR'][$vectorComponents['PR']] : 'Unknown';
+        $data->userInteraction = isset($readableNames['UI'][$vectorComponents['UI']]) ? $readableNames['UI'][$vectorComponents['UI']] : 'Unknown';
+        $data->scope = isset($readableNames['S'][$vectorComponents['S']]) ? $readableNames['S'][$vectorComponents['S']] : 'Unknown';
+        $data->confidentialityImpact = isset($readableNames['C'][$vectorComponents['C']]) ? $readableNames['C'][$vectorComponents['C']] : 'Unknown';
+        $data->integrityImpact = isset($readableNames['I'][$vectorComponents['I']]) ? $readableNames['I'][$vectorComponents['I']] : 'Unknown';
+        $data->availabilityImpact = isset($readableNames['A'][$vectorComponents['A']]) ? $readableNames['A'][$vectorComponents['A']] : 'Unknown';
+
+        $html = '<div class="cvss-table">
               <h3>CVSS v3 details</h3>
               <table>
                 <tr>
-                  <td>Impact score</td><td>{$v3->impactScore}</td>
-                  <td>Exploitability score</td><td>{$v3->exploitabilityScore}</td>
+                  <td>Attack vector</td><td>' . $data->attackVector . '</td>
+                  <td>Confidentiality Impact</td><td>' . $data->confidentialityImpact . '</td>
                 </tr>
                 <tr>
-                  <td>Attack vector</td><td>{$data->attackVector}</td>
-                  <td>Confidentiality Impact</td><td>{$data->confidentialityImpact}</td>
+                  <td>Attack complexity</td><td>' . $data->attackComplexity . '</td>
+                  <td>Integrity Impact</td><td>' . $data->integrityImpact . '</td>
                 </tr>
                 <tr>
-                  <td>Attack complexity</td><td>{$data->attackComplexity}</td>
-                  <td>Integrity Impact</td><td>{$data->integrityImpact}</td>
+                  <td>Privileges Required</td><td>' . $data->privilegesRequired . '</td>
+                  <td>Availability Impact</td><td>' . $data->availabilityImpact . '</td>
                 </tr>
                 <tr>
-                  <td>Privileges Required</td><td>{$data->privilegesRequired}</td>
-                  <td>Availability Impact</td><td>{$data->availabilityImpact}</td>
-                </tr>
-                <tr>
-                  <td>User Interaction</td><td>{$data->userInteraction}</td>
-                  <td>Scope</td><td>{$data->scope}</td>
+                  <td>User Interaction</td><td>' . $data->userInteraction . '</td>
+                  <td>Scope</td><td>' . $data->scope . '</td>
                 </tr>
               </table>
-            </div>
-        EOD;
+            </div>';
+
+        return $html;
     }
 
-    private function getV2Table($datum)
+    private function cvssV2VectorToTable($cvssVector)
     {
-        $metrics = $datum->raw_nvd_data->metrics;
-        if (!isset($metrics->cvssMetricV2) || count($metrics->cvssMetricV2) == 0) {
-            return '';
+        $vectorComponents = [];
+        $parts = explode('/', $cvssVector);
+
+        foreach ($parts as $part) {
+            $component = explode(':', $part);
+            if (count($component) == 2) {
+                $vectorComponents[$component[0]] = $component[1];
+            }
         }
-        $v2 = $metrics->cvssMetricV2[0];
-        $data = $v2->cvssData;
-        return <<<EOD
-            <div class="cvss-table">
+
+        $readableNames = [
+            'AV' => ['L' => 'Local', 'A' => 'Adjacent Network', 'N' => 'Network'],
+            'AC' => ['H' => 'High', 'M' => 'Medium', 'L' => 'Low'],
+            'Au' => ['M' => 'Multiple', 'S' => 'Single', 'N' => 'None'],
+            'C'  => ['N' => 'None', 'P' => 'Partial', 'C' => 'Complete'],
+            'I'  => ['N' => 'None', 'P' => 'Partial', 'C' => 'Complete'],
+            'A'  => ['N' => 'None', 'P' => 'Partial', 'C' => 'Complete']
+        ];
+
+        $metricValues = [
+            'AV' => ['L' => 0.395, 'A' => 0.646, 'N' => 1.0],
+            'AC' => ['H' => 0.35, 'M' => 0.61, 'L' => 0.71],
+            'Au' => ['M' => 0.45, 'S' => 0.56, 'N' => 0.704],
+            'C'  => ['N' => 0, 'P' => 0.275, 'C' => 0.660],
+            'I'  => ['N' => 0, 'P' => 0.275, 'C' => 0.660],
+            'A'  => ['N' => 0, 'P' => 0.275, 'C' => 0.660]
+        ];
+
+        $confImpact = isset($metricValues['C'][$vectorComponents['C']]) ? $metricValues['C'][$vectorComponents['C']] : 0;
+        $integImpact = isset($metricValues['I'][$vectorComponents['I']]) ? $metricValues['I'][$vectorComponents['I']] : 0;
+        $availImpact = isset($metricValues['A'][$vectorComponents['A']]) ? $metricValues['A'][$vectorComponents['A']] : 0;
+
+        $impact = 10.41 * (1 - (1 - $confImpact) * (1 - $integImpact) * (1 - $availImpact));
+
+        $av = isset($metricValues['AV'][$vectorComponents['AV']]) ? $metricValues['AV'][$vectorComponents['AV']] : 0;
+        $ac = isset($metricValues['AC'][$vectorComponents['AC']]) ? $metricValues['AC'][$vectorComponents['AC']] : 0;
+        $au = isset($metricValues['Au'][$vectorComponents['Au']]) ? $metricValues['Au'][$vectorComponents['Au']] : 0;
+
+        $exploitability = 20 * $av * $ac * $au;
+
+        $impact = round($impact, 1);
+        $exploitability = round($exploitability, 1);
+
+        $data = new stdClass();
+        $data->accessVector = isset($readableNames['AV'][$vectorComponents['AV']]) ? $readableNames['AV'][$vectorComponents['AV']] : 'Unknown';
+        $data->accessComplexity = isset($readableNames['AC'][$vectorComponents['AC']]) ? $readableNames['AC'][$vectorComponents['AC']] : 'Unknown';
+        $data->authentication = isset($readableNames['Au'][$vectorComponents['Au']]) ? $readableNames['Au'][$vectorComponents['Au']] : 'Unknown';
+        $data->confidentialityImpact = isset($readableNames['C'][$vectorComponents['C']]) ? $readableNames['C'][$vectorComponents['C']] : 'Unknown';
+        $data->integrityImpact = isset($readableNames['I'][$vectorComponents['I']]) ? $readableNames['I'][$vectorComponents['I']] : 'Unknown';
+        $data->availabilityImpact = isset($readableNames['A'][$vectorComponents['A']]) ? $readableNames['A'][$vectorComponents['A']] : 'Unknown';
+
+        $v2 = new stdClass();
+        $v2->impactScore = $impact;
+        $v2->exploitabilityScore = $exploitability;
+
+        $html = '<div class="cvss-table">
               <h3>CVSS v2 details</h3>
               <table>
                 <tr>
-                  <td>Impact score</td><td>{$v2->impactScore}</td>
-                  <td>Exploitability score</td><td>{$v2->exploitabilityScore}</td>
+                  <td>Impact score</td><td>' . $v2->impactScore . '</td>
+                  <td>Exploitability score</td><td>' . $v2->exploitabilityScore . '</td>
                 </tr>
                 <tr>
-                  <td>Access Vector</td><td>{$data->accessVector}</td>
-                  <td>Confidentiality Impact</td><td>{$data->confidentialityImpact}</td>
+                  <td>Access Vector</td><td>' . $data->accessVector . '</td>
+                  <td>Confidentiality Impact</td><td>' . $data->confidentialityImpact . '</td>
                 </tr>
                 <tr>
-                  <td>Access Complexity</td><td>{$data->accessComplexity}</td>
-                  <td>Integrity Impact</td><td>{$data->integrityImpact}</td>
+                  <td>Access Complexity</td><td>' . $data->accessComplexity . '</td>
+                  <td>Integrity Impact</td><td>' . $data->integrityImpact . '</td>
                 </tr>
                 <tr>
-                  <td>Authentication</td><td>{$data->authentication}</td>
-                  <td>Availability Impact</td><td>{$data->availabilityImpact}</td>
+                  <td>Authentication</td><td>' . $data->authentication . '</td>
+                  <td>Availability Impact</td><td>' . $data->availabilityImpact . '</td>
                 </tr>
-                <tr>
               </table>
-            </div>
-        EOD;
+            </div>';
+
+        return $html;
     }
 
+    private function cvssV4VectorToTable($cvssVector)
+    {
+        $vectorComponents = [];
+        $parts = explode('/', $cvssVector);
+
+        if (!preg_match('/^CVSS:4\.0/', $parts[0])) {
+            return 'Error: Not a valid CVSS v4.0 vector';
+        }
+
+        for ($i = 1; $i < count($parts); $i++) {
+            $component = explode(':', $parts[$i]);
+            if (count($component) == 2) {
+                $vectorComponents[$component[0]] = $component[1];
+            }
+        }
+
+        $readableNames = [
+            'AV' => ['N' => 'Network', 'A' => 'Adjacent', 'L' => 'Local', 'P' => 'Physical'],
+            'AC' => ['L' => 'Low', 'H' => 'High'],
+            'AT' => ['N' => 'None', 'P' => 'Present'],
+            'PR' => ['N' => 'None', 'L' => 'Low', 'H' => 'High'],
+            'UI' => ['N' => 'None', 'P' => 'Passive', 'A' => 'Active'],
+            'VC' => ['N' => 'None', 'L' => 'Low', 'H' => 'High'],
+            'VI' => ['N' => 'None', 'L' => 'Low', 'H' => 'High'],
+            'VA' => ['N' => 'None', 'L' => 'Low', 'H' => 'High'],
+            'SC' => ['N' => 'None', 'L' => 'Low', 'H' => 'High'],
+            'SI' => ['N' => 'None', 'L' => 'Low', 'H' => 'High'],
+            'SA' => ['N' => 'None', 'L' => 'Low', 'H' => 'High']
+        ];
+
+        $data = new stdClass();
+        $data->attackVector = isset($readableNames['AV'][$vectorComponents['AV']]) ? $readableNames['AV'][$vectorComponents['AV']] : 'Unknown';
+        $data->attackComplexity = isset($readableNames['AC'][$vectorComponents['AC']]) ? $readableNames['AC'][$vectorComponents['AC']] : 'Unknown';
+        $data->privilegesRequired = isset($readableNames['PR'][$vectorComponents['PR']]) ? $readableNames['PR'][$vectorComponents['PR']] : 'Unknown';
+        $data->attackRequirements = isset($readableNames['AT'][$vectorComponents['AT']]) ? $readableNames['AT'][$vectorComponents['AT']] : 'Unknown';
+        $data->userInteraction = isset($readableNames['UI'][$vectorComponents['UI']]) ? $readableNames['UI'][$vectorComponents['UI']] : 'Unknown';
+        $data->confidentialityImpact = isset($readableNames['VC'][$vectorComponents['VC']]) ? $readableNames['VC'][$vectorComponents['VC']] : 'Unknown';
+        $data->integrityImpact = isset($readableNames['VI'][$vectorComponents['VI']]) ? $readableNames['VI'][$vectorComponents['VI']] : 'Unknown';
+        $data->availabilityImpact = isset($readableNames['VA'][$vectorComponents['VA']]) ? $readableNames['VA'][$vectorComponents['VA']] : 'Unknown';
+        $data->confidentialityImpactS = isset($readableNames['SC'][$vectorComponents['SC']]) ? $readableNames['SC'][$vectorComponents['SC']] : 'Unknown';
+        $data->integrityImpactS = isset($readableNames['SI'][$vectorComponents['SI']]) ? $readableNames['SI'][$vectorComponents['SI']] : 'Unknown';
+        $data->availabilityImpactS = isset($readableNames['SA'][$vectorComponents['SA']]) ? $readableNames['SA'][$vectorComponents['SA']] : 'Unknown';
+
+        $html = '<div class="cvss-table">
+              <h3>CVSS v4.0 details</h3>
+              <table>
+                <tr>
+                  <td>Attack vector</td><td>' . $data->attackVector . '</td>
+                  <td>Vulnerable System Confidentiality Impact</td><td>' . $data->confidentialityImpact . '</td>
+                </tr>
+                <tr>
+                  <td>Attack complexity</td><td>' . $data->attackComplexity . '</td>
+                  <td>Vulnerable System Integrity Impact</td><td>' . $data->integrityImpact . '</td>
+                </tr>
+                <tr>
+                  <td>Privileges Required</td><td>' . $data->privilegesRequired . '</td>
+                  <td>Vulnerable System Availability Impact</td><td>' . $data->availabilityImpact . '</td>
+                </tr>
+                <tr>
+                  <td>Attack Requirements</td><td>' . $data->attackRequirements . '</td>
+                  <td>Subsequent System Confidentiality Impact</td><td>' . $data->confidentialityImpactS . '</td>
+                </tr>
+                <tr>
+                  <td>User Interaction</td><td>' . $data->userInteraction . '</td>
+                  <td>Subsequent System Integrity Impact</td><td>' . $data->integrityImpactS . '</td>
+                </tr>
+                <tr>
+                  <td></td><td></td>
+                  <td>Subsequent System Avaliablity Impact</td><td>' . $data->availabilityImpactS . '</td>
+                </tr>
+              </table>
+            </div>';
+
+        return $html;
+    }
+
+
     private function getVendors($datum)
     {
         if (count((array)$datum->vendors) == 0) {
             return '';
         }
+
+        $vendor_data = [];
+        foreach ($datum->vendors as $vendor_str) {
+            $pieces = explode('$PRODUCT$', $vendor_str);
+            if (count($pieces) == 1) {
+                $vendor = $pieces[0];
+                if (!array_key_exists($vendor, $vendor_data)) {
+                    $vendor_data[$vendor] = [];
+                }
+            } else {
+                $vendor = $pieces[0];
+                $product = $pieces[1];
+                if (!array_key_exists($vendor, $vendor_data)) {
+                    $vendor_data[$vendor] = [];
+                }
+                array_push($vendor_data[$vendor], $product);
+            }
+        }
+
         $res = '<h3>Affected products</h3><p><ul>';
-        foreach ($datum->vendors as $vendor => $products) {
+        foreach ($vendor_data as $vendor => $products) {
             $res .= "<li>{$vendor}";
             if (count($products) > 0) {
                 $res .= '<ul>';
@@ -420,5 +590,6 @@ class OpenCVEBridge extends BridgeAbstract
             $res .= '</li>';
         }
         $res .= '</ul></p>';
+        return $res;
     }
 }

From 23cb9349fccd2c7342a4ddeac600d39ea0e4c787 Mon Sep 17 00:00:00 2001
From: Tomasz Molski <41341072+KappaPrajd@users.noreply.github.com>
Date: Sun, 23 Mar 2025 21:30:45 +0100
Subject: [PATCH 612/716] [CeskaTelevizeBridge] Adjusted getting article
 timestamp (#4486)

* [CeskaTelevizeBridge] Adjusted getting article timestamp

* [CeskaTelevizeBridge] Removed excess whitespace
---
 bridges/CeskaTelevizeBridge.php | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/bridges/CeskaTelevizeBridge.php b/bridges/CeskaTelevizeBridge.php
index a996bd11..f1ed4487 100644
--- a/bridges/CeskaTelevizeBridge.php
+++ b/bridges/CeskaTelevizeBridge.php
@@ -41,11 +41,15 @@ class CeskaTelevizeBridge extends BridgeAbstract
         foreach ($html->find('#episodeListSection a[data-testid=card]') as $element) {
             $itemContent = $element->find('p[class^=content-]', 0);
             $itemDate = $element->find('div[class^=playTime-] span, [data-testid=episode-item-broadcast] span', 0);
+
+            // Remove special characters and whitespace
+            $cleanDate = preg_replace('/[^0-9.]/', '', $itemDate->plaintext);
+
             $item = [
                 'title'     => $this->fixChars($element->find('h3', 0)->plaintext),
                 'uri'       => self::URI . $element->getAttribute('href'),
                 'content'   => '<img src="' . $element->find('img', 0)->getAttribute('srcset') . '" /><br />' . $this->fixChars($itemContent->plaintext),
-                'timestamp' => $this->getUploadTimeFromString($itemDate->plaintext),
+                'timestamp' => $this->getUploadTimeFromString($cleanDate),
             ];
 
             $this->items[] = $item;
@@ -58,7 +62,7 @@ class CeskaTelevizeBridge extends BridgeAbstract
             return strtotime('today');
         } elseif (strpos($string, 'včera') !== false) {
             return strtotime('yesterday');
-        } elseif (!preg_match('/(\d+).\s(\d+).(\s(\d+))?/', $string, $match)) {
+        } elseif (!preg_match('/(\d+).(\d+).((\d+))?/', $string, $match)) {
             returnServerError('Could not get date from Česká televize string');
         }
 

From 38bb5115c972c6f374e39158668cc6c93ae5d31b Mon Sep 17 00:00:00 2001
From: Niehztog <Niehztog@users.noreply.github.com>
Date: Mon, 24 Mar 2025 21:12:26 +0100
Subject: [PATCH 613/716] fix issues reported in
 https://github.com/RSS-Bridge/rss-bridge/issues/4477 (#4488)

---
 docs/05_Bridge_API/05_XPathAbstract.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/05_Bridge_API/05_XPathAbstract.md b/docs/05_Bridge_API/05_XPathAbstract.md
index fd697995..28a20a81 100644
--- a/docs/05_Bridge_API/05_XPathAbstract.md
+++ b/docs/05_Bridge_API/05_XPathAbstract.md
@@ -99,7 +99,7 @@ This method should return the HTML source as a base for the XPath expressions. U
 This method should provide the feed title. Usually the XPath expression defined in `XPATH_EXPRESSION_FEED_TITLE` is used for extracting the title directly from the page source.
 
 ### Method `provideFeedIcon()`
-This method should provide the feed title. Usually the XPath expression defined in `XPATH_EXPRESSION_FEED_ICON` is used for extracting the title directly from the page source.
+This method should provide the URL of the feed's favicon. Usually the XPath expression defined in `XPATH_EXPRESSION_FEED_ICON` is used for extracting the title directly from the page source.
 
 ### Method `provideFeedItems()`
 This method should provide the feed items. Usually the XPath expression defined in `XPATH_EXPRESSION_ITEM` is used for extracting the items from the page source. All other XPath expressions are applied on a per-item basis, item by item, and only on the item's contents.
@@ -122,8 +122,8 @@ Accepts the items author as parameter, processes and returns it. Should return a
 ### Method `formatItemTimestamp()`
 Accepts the items creation timestamp as parameter, processes and returns it. Should return a unix timestamp as integer.
 
-### Method `cleanImageUrl()`
-Method invoked for cleaning feed icon and item image URL's. Extracts the image URL from the passed parameter, stripping any additional content. Furthermore makes sure that relative image URL's get transformed to absolute ones.
+### Method `cleanMediaUrl()`
+Method invoked for cleaning feed icon, item image and media attachment (like .mp3, .webp) URL's. Extracts the media URL from the passed parameter, stripping any additional content. Furthermore, makes sure that relative media URL's get transformed to absolute ones.
 
 ### Method `fixEncoding()`
 Only invoked when class constant `SETTING_FIX_ENCODING` is set to true. It then passes all extracted string values through PHP's `utf8_decode` function.

From 87112497dee03d1f9baf2cb6638387badd6c6257 Mon Sep 17 00:00:00 2001
From: Pavel Korytov <thexcloud@gmail.com>
Date: Tue, 25 Mar 2025 23:52:53 +0300
Subject: [PATCH 614/716] [AnthropicBridge] Delete bridges (#4490)

---
 bridges/AnthropicBridge.php | 147 ------------------------------------
 1 file changed, 147 deletions(-)
 delete mode 100644 bridges/AnthropicBridge.php

diff --git a/bridges/AnthropicBridge.php b/bridges/AnthropicBridge.php
deleted file mode 100644
index 1272d35f..00000000
--- a/bridges/AnthropicBridge.php
+++ /dev/null
@@ -1,147 +0,0 @@
-<?php
-
-class AnthropicBridge extends BridgeAbstract
-{
-    const MAINTAINER = 'sqrtminusone';
-    const NAME = 'Anthropic Research Bridge';
-    const URI = 'https://www.anthropic.com';
-
-    const CACHE_TIMEOUT = 3600; // 1 hour
-    const DESCRIPTION = 'Returns research publications from Anthropic';
-
-    const PARAMETERS = [
-        '' => [
-            'limit' => [
-                'name' => 'Limit',
-                'type' => 'number',
-                'required' => true,
-                'defaultValue' => 10
-            ],
-        ]
-    ];
-
-    public function collectData()
-    {
-        // Anthropic sometimes returns 500 for no reason. The contents are still there.
-        $html = $this->getHTMLIgnoreError(self::URI . '/research');
-        $limit = $this->getInput('limit');
-
-        $page_data = $this->extractPageData($html);
-        $pages = $this->parsePageData($page_data);
-        for ($i = 0; $i < min(count($pages), $limit); $i++) {
-            $page = $pages[$i];
-            $page['content'] = $this->parsePage($page['uri']);
-            $this->items[] = $page;
-        }
-    }
-
-    private function getHTMLIgnoreError($url, $ttl = null)
-    {
-        if ($ttl != null) {
-            $cacheKey = 'pages_' . $url;
-            $content = $this->cache->get($cacheKey);
-            if ($content) {
-                return str_get_html($content);
-            }
-        }
-
-        try {
-            $content = getContents($url);
-        } catch (HttpException $e) {
-            $content = $e->response->getBody();
-        }
-        if ($ttl != null) {
-            $this->cache->set($cacheKey, $content, $ttl);
-        }
-        return str_get_html($content);
-    }
-
-    private function extractPageData($html)
-    {
-        foreach ($html->find('script') as $script) {
-            $js_code = $script->innertext;
-            if (!str_starts_with($js_code, 'self.__next_f.push(')) {
-                continue;
-            }
-            $push_data = (string)json_decode(mb_substr($js_code, 22, mb_strlen($js_code) - 2 - 22));
-            $square_bracket = mb_strpos($push_data, '[');
-            $push_array = json_decode(mb_substr($push_data, $square_bracket), true);
-            if ($push_array == null || count($push_array) < 4) {
-                continue;
-            }
-            $page_data = $push_array[3];
-            if ($page_data != null && array_key_exists('page', $page_data)) {
-                return $page_data;
-            }
-        }
-    }
-
-    private function parsePageData($page_data)
-    {
-        $result = [];
-        foreach ($page_data['page']['sections'] as $section) {
-            if (
-                !array_key_exists('internalName', $section) ||
-                $section['internalName'] != 'Research Teams'
-            ) {
-                continue;
-            }
-            foreach ($section['tabPages'] as $tabPage) {
-                if ($tabPage['label'] != 'Overview') {
-                    continue;
-                }
-                foreach ($tabPage['sections'] as $section1) {
-                    if (
-                        !array_key_exists('title', $section1)
-                        || $section1['title'] != 'Publications'
-                    ) {
-                        continue;
-                    }
-                    foreach ($section1['posts'] as $post) {
-                        $enc = [];
-                        if ($post['cta'] != null && array_key_exists('url', $post['cta'])) {
-                            $enc = [$post['cta']['url']];
-                        }
-                        $result[] = [
-                            'title' => $post['title'],
-                            'timestamp' => $post['publishedOn'],
-                            'uri' => self::URI . '/research/' . $post['slug']['current'],
-                            'categories' => array_map(
-                                fn($s) => $s['label'],
-                                $post['subjects'],
-                            ),
-                            'enclosures' => $enc,
-                        ];
-                    }
-                    break;
-                }
-                break;
-            }
-            break;
-        }
-        return $result;
-    }
-
-    private function parsePage($url)
-    {
-        // Again, 500 for no reason.
-        $html = $this->getHTMLIgnoreError($url, 7 * 24 * 60 * 60);
-
-        $content = '';
-
-        // Main content
-        $main = $html->find('div[class*="PostDetail_post-detail"] > article', 0);
-
-        // Mostly YouTube videos
-        $iframes = $main->find('iframe');
-        foreach ($iframes as $iframe) {
-            $iframe->parent->removeAttribute('style');
-            $iframe->outertext = '<a href="' . $iframe->src . '">' . $iframe->src . '</a>';
-        }
-
-        $main = convertLazyLoading($main);
-        $main = defaultLinkTo($main, self::URI);
-        $content .= $main;
-        return $content;
-    }
-}

From abb1602524656d7543f5f569a7d50eea40b790c8 Mon Sep 17 00:00:00 2001
From: mruac <ant8672@gmail.com>
Date: Wed, 26 Mar 2025 07:24:25 +1030
Subject: [PATCH 615/716] fix #4475 (#4491)

* support embeds for feeds, lists and starter packs

* lint
---
 bridges/BlueskyBridge.php | 110 +++++++++++++++++++++++++++-----------
 1 file changed, 80 insertions(+), 30 deletions(-)

diff --git a/bridges/BlueskyBridge.php b/bridges/BlueskyBridge.php
index 67bb5af9..f0e609d9 100644
--- a/bridges/BlueskyBridge.php
+++ b/bridges/BlueskyBridge.php
@@ -180,7 +180,7 @@ class BlueskyBridge extends BridgeAbstract
 
             if (Debug::isEnabled()) {
                 $url = explode('/', $post['post']['uri']);
-                error_log('https://bsky.app/profile/' . $url[2] . '/post/' . $url[4]);
+                $this->logger->debug('https://bsky.app/profile/' . $url[2] . '/post/' . $url[4]);
             }
 
             $description = '';
@@ -255,10 +255,16 @@ class BlueskyBridge extends BridgeAbstract
                     $description .= '<a href="' . $uri_reconstructed . '">Quoted post detached.</a>';
                 } elseif (isset($quotedRecord['blocked']) && $quotedRecord['blocked']) { //blocked by quote author
                     $description .= 'Author of quoted post has blocked OP.';
-                } elseif (($quotedRecord['$type'] ?? '') === 'app.bsky.feed.defs#generatorView') {
-                    $description .= '</p>';
-                    $description .= $this->getGeneratorViewDescription($quotedRecord);
-                    $description .= '<p>';
+                } elseif (
+                    ($quotedRecord['$type'] ?? '') === 'app.bsky.feed.defs#generatorView' ||
+                    ($quotedRecord['$type'] ?? '') === 'app.bsky.graph.defs#listView'
+                ) {
+                    $description .= $this->getListFeedDescription($quotedRecord);
+                } elseif (
+                    ($quotedRecord['$type'] ?? '') === 'app.bsky.graph.starterpack' ||
+                    ($quotedRecord['$type'] ?? '') === 'app.bsky.graph.defs#starterPackViewBasic'
+                ) {
+                    $description .= $this->getStarterPackDescription($post['post']['embed']['record']);
                 } else {
                     $quotedAuthorDid = $quotedRecord['author']['did'];
                     $quotedDisplayName = $quotedRecord['author']['displayName'] ?? '';
@@ -403,10 +409,16 @@ class BlueskyBridge extends BridgeAbstract
                         $description .= '<a href="' . $uri_reconstructed . '">Quoted post detached.</a>';
                     } elseif (isset($replyQuotedRecord['blocked']) && $replyQuotedRecord['blocked']) { //blocked by quote author
                         $description .= 'Author of quoted post has blocked OP.';
-                    } elseif (($replyQuotedRecord['$type'] ?? '') === 'app.bsky.feed.defs#generatorView') {
-                        $description .= '</p>';
-                        $description .= $this->getGeneratorViewDescription($replyQuotedRecord);
-                        $description .= '<p>';
+                    } elseif (
+                        ($replyQuotedRecord['$type'] ?? '') === 'app.bsky.feed.defs#generatorView' ||
+                        ($replyQuotedRecord['$type'] ?? '') === 'app.bsky.graph.defs#listView'
+                    ) {
+                        $description .= $this->getListFeedDescription($replyQuotedRecord);
+                    } elseif (
+                        ($replyQuotedRecord['$type'] ?? '') === 'app.bsky.graph.starterpack' ||
+                        ($replyQuotedRecord['$type'] ?? '') === 'app.bsky.graph.defs#starterPackViewBasic'
+                    ) {
+                        $description .= $this->getStarterPackDescription($replyPost['embed']['record']);
                     } else {
                         $quotedAuthorDid = $replyQuotedRecord['author']['did'];
                         $quotedDisplayName = $replyQuotedRecord['author']['displayName'] ?? '';
@@ -554,11 +566,19 @@ class BlueskyBridge extends BridgeAbstract
             }
             $title .= ', replying to ' . $replyAuthor;
         }
-        if (isset($post['post']['embed']) && isset($post['post']['embed']['record'])) {
+
+        if (
+            isset($post['post']['embed']) &&
+            isset($post['post']['embed']['record']) &&
+            //if not starter pack, feed or list
+            ($post['post']['embed']['record']['$type'] ?? '') !== 'app.bsky.feed.defs#generatorView' &&
+            ($post['post']['embed']['record']['$type'] ?? '') !== 'app.bsky.graph.defs#listView' &&
+            ($post['post']['embed']['record']['$type'] ?? '') !== 'app.bsky.graph.defs#starterPackViewBasic'
+        ) {
             if (isset($post['post']['embed']['record']['blocked'])) {
                 $quotedAuthor = 'blocked user';
             } elseif (isset($post['post']['embed']['record']['notFound'])) {
-                $quotedAuthor = 'deleted post';
+                $quotedAuthor = 'deleted psost';
             } elseif (isset($post['post']['embed']['record']['detached'])) {
                 $quotedAuthor = 'detached post';
             } else {
@@ -587,34 +607,64 @@ class BlueskyBridge extends BridgeAbstract
     {
         $uri = 'https://public.api.bsky.app/xrpc/app.bsky.feed.getAuthorFeed?actor=' . urlencode($did) . '&filter=' . urlencode($filter) . '&limit=30';
         if (Debug::isEnabled()) {
-            error_log($uri);
+            $this->logger->debug($uri);
         }
         $response = json_decode(getContents($uri), true);
         return $response;
     }
 
-    private function getGeneratorViewDescription(array $record): string
+    //Embed for generated feeds and lists
+    private function getListFeedDescription(array $record): string
     {
-        $avatar = e($record['avatar']);
-        $displayName = e($record['displayName']);
-        $displayHandle = e($record['creator']['handle']);
-        $likeCount = e($record['likeCount']);
+        $feedViewAvatar = isset($record['avatar']) ? '<img src="' . preg_replace('/\/img\/avatar\//', '/img/avatar_thumbnail/', $record['avatar']) . '">' : '';
+        $feedViewName = e($record['displayName'] ?? $record['name']);
+        $feedViewDescription = e($record['description'] ?? '');
+        $authorDisplayName = e($record['creator']['displayName']);
+        $authorHandle = e($record['creator']['handle']);
+        $likeCount = isset($record['likeCount']) ? '<br>Liked by ' . e($record['likeCount']) . ' users' : '';
         preg_match('/\/([^\/]+)$/', $record['uri'], $matches);
-        $uri = e('https://bsky.app/profile/' . $record['creator']['did'] . '/feed/' . $matches[1]);
+        if (($record['purpose'] ?? '') === 'app.bsky.graph.defs#modlist') {
+            $typeURL = '/lists/';
+            $typeDesc = 'moderation list';
+        } elseif (($record['purpose'] ?? '') === 'app.bsky.graph.defs#curatelist') {
+            $typeURL = '/lists/';
+            $typeDesc = 'list';
+        } else {
+            $typeURL = '/feed/';
+            $typeDesc = 'feed';
+        }
+        $uri = e('https://bsky.app/profile/' . $record['creator']['did'] . $typeURL . $matches[1]);
 
         return <<<END
-<a href="{$uri}" style="color: inherit;">
-    <div style="border: 1px solid #333; padding: 10px;">
-        <div style="display: flex; margin-bottom: 10px;">
-            <img src="{$avatar}" height="50" width="50" style="margin-right: 10px;">
-            <div style="display: flex; flex-direction: column; justify-content: center;">
-                <h3>{$displayName}</h3>
-                <span>Feed by @{$displayHandle}</span>
-            </div>
-        </div>
-        <span>Liked by {$likeCount} users</span>
-    </div>
-</a>
+<blockquote>
+<b><a href="{$uri}">{$feedViewName}</a></b><br/>
+Bluesky {$typeDesc} by <b>{$authorDisplayName}</b> <i>@{$authorHandle}</i>
+<figure>
+{$feedViewAvatar}
+<figcaption>{$feedViewDescription}{$likeCount}</figcaption>
+</figure>
+</blockquote>
+END;
+    }
+
+    private function getStarterPackDescription(array $record): string
+    {
+        if (!isset($record['record'])) {
+            return 'Failed to get starter pack information.';
+        }
+        $starterpackRecord = $record['record'];
+        $starterpackName = e($starterpackRecord['name']);
+        $starterpackDescription = e($starterpackRecord['description']);
+        $creatorDisplayName = e($record['creator']['displayName']);
+        $creatorHandle = e($record['creator']['handle']);
+        preg_match('/\/([^\/]+)$/', $starterpackRecord['list'], $matches);
+        $uri = e('https://bsky.app/starter-pack/' . $record['creator']['did'] . '/' . $matches[1]);
+        return <<<END
+<blockquote>
+<b><a href="{$uri}">{$starterpackName}</a></b><br/>
+Bluesky starter pack by <b>{$creatorDisplayName}</b> <i>@{$creatorHandle}</i><br/>
+{$starterpackDescription}
+</blockquote>
 END;
     }
 }

From 68ff39e1645ced9f6d7ef33e87792696689b2230 Mon Sep 17 00:00:00 2001
From: Joseph <VerifiedJoseph@users.noreply.github.com>
Date: Tue, 25 Mar 2025 20:55:09 +0000
Subject: [PATCH 616/716] [TheFarSideBridge] Remove hotlink protection bypass
 (#4492)

---
 bridges/TheFarSideBridge.php | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/bridges/TheFarSideBridge.php b/bridges/TheFarSideBridge.php
index cd3ad9ae..67db2256 100644
--- a/bridges/TheFarSideBridge.php
+++ b/bridges/TheFarSideBridge.php
@@ -26,21 +26,16 @@ class TheFarSideBridge extends BridgeAbstract
             $image = $card->find('img', 0);
             $imageUrl = $image->attr['data-src'];
 
-            // Images are downloaded to bypass the hotlink protection.
-            $image = getContents($imageUrl, ['Referer: ' . self::URI]);
-
-            // Encode image as base64
-            $imageBase64 = base64_encode($image);
-
             $caption = '';
 
             if ($card->find('figcaption', 0)) {
                 $caption = $card->find('figcaption', 0)->innertext;
             }
 
+            $item['enclosures'][] = $imageUrl;
             $item['content'] .= <<<EOD
 <figure>
-	<img title="{$caption}" src="data:image/jpeg;base64,{$imageBase64}"/>
+	<img title="{$caption}" src="{$imageUrl}"/>
 	<figcaption>{$caption}</figcaption>
 </figure>
 <br/>

From 1c45eff50533d0b2c3901424237edc4739142b85 Mon Sep 17 00:00:00 2001
From: subtle4553 <chocolatea795@gmail.com>
Date: Tue, 25 Mar 2025 23:34:19 +0100
Subject: [PATCH 617/716] [ManyVidsBridge] Create proper feed content (#4493)

---
 bridges/ManyVidsBridge.php | 110 +++++++++++++++++++++++++++++++------
 1 file changed, 94 insertions(+), 16 deletions(-)

diff --git a/bridges/ManyVidsBridge.php b/bridges/ManyVidsBridge.php
index 21ad950f..29ebd5f7 100644
--- a/bridges/ManyVidsBridge.php
+++ b/bridges/ManyVidsBridge.php
@@ -2,15 +2,15 @@
 
 class ManyVidsBridge extends BridgeAbstract
 {
-    const NAME = 'MANYVIDS';
+    const NAME = 'ManyVids';
     const URI = 'https://www.manyvids.com';
     const DESCRIPTION = 'Fetches the latest posts from a profile';
-    const MAINTAINER = 'dvikan';
-    const CACHE_TIMEOUT = 60 * 60;
+    const MAINTAINER = 'dvikan, subtle4553';
+    const CACHE_TIMEOUT = 3600;
     const PARAMETERS = [
         [
             'profile' => [
-                'name' => 'Profile',
+                'name' => 'Profil',
                 'type' => 'text',
                 'required' => true,
                 'exampleValue' => '678459/Aziani-Studios',
@@ -19,6 +19,8 @@ class ManyVidsBridge extends BridgeAbstract
         ]
     ];
 
+    private $domCache = null;
+
     public function collectData()
     {
         $profile = $this->getInput('profile');
@@ -29,21 +31,97 @@ class ManyVidsBridge extends BridgeAbstract
         } else {
             throw new \Exception('nope');
         }
-        $url = sprintf('https://www.manyvids.com/Profile/%s/Store/Videos/', $profile);
-        $dom = getSimpleHTMLDOM($url);
-        $videos = $dom->find('div[class^="ProfileTabGrid_card"]');
-        foreach ($videos as $item) {
-            $a = $item->find('a', 1);
-            $uri = 'https://www.manyvids.com' . $a->href;
-            if (preg_match('#Video/(\d+)/#', $uri, $m)) {
-                $uid = 'manyvids/' . $m[1];
+
+        $dom = $this->getHTML($profile);
+        $elements = $dom->find('div[class^="ProfileTabGrid_card__"]');
+
+        foreach ($elements as $element) {
+            $content = '';
+
+            $title = $element->find('span[class^="VideoCardUI_videoTitle__"] > a', 0);
+            if (!$title) {
+                continue;
             }
+
+            $linkElement = $element->find('a[href^="/Video/"]', 0);
+            if ($linkElement) {
+                $itemUri = $this::URI . $linkElement->getAttribute('href');
+            }
+
+            $image = $element->find('img', 0);
+            if ($image) {
+                if (isset($itemUri)) {
+                    $content .= sprintf('<p><a href="%s"><img src="%s"></a></p>', $itemUri, $image->getAttribute('src'));
+                } else {
+                    $content .= sprintf('<p><img src="%s"></p>', $image->getAttribute('src'));
+                }
+            }
+
+            $contentSegments = [];
+
+            $videoLength = $element->find('[class^="CardMedia_videoDuration__"] > span', 0);
+            if ($videoLength) {
+                $contentSegments[] = sprintf('%s', $videoLength->innertext);
+            }
+
+            $price = $element->find('[class^="PriceUI_regularPrice__"], [class^="PriceUI_card_price__"] > p, [class^="PriceUI_card_free_text__"]', 0);
+            $discountedPrice = $element->find('[class^="PriceUI_discountedPrice__"]', 0);
+
+            if ($price && $discountedPrice) {
+                $contentSegments[] = sprintf('<s>%s</s> <strong>%s</strong>', $price->innertext, $discountedPrice->innertext);
+            } elseif ($price && !$discountedPrice) {
+                $contentSegments[] = sprintf('<strong>%s</strong>', $price->innertext);
+            }
+
+            $content .= implode(' • ', $contentSegments);
+
             $this->items[] = [
-                'title'     => $a->plaintext,
-                'uri'       => $uri,
-                'uid'       => $uid ?? $uri,
-                'content'   => $item->innertext,
+                'title' => $title->innertext,
+                'uri' => isset($itemUri) ? $itemUri : null,
+                'content' => $content
             ];
         }
     }
+
+    public function getName()
+    {
+        $profile = $this->getInput('profile');
+
+        if ($profile) {
+            $dom = $this->getHTML($profile);
+            $profileNameElement = $dom->find('[class^="ProfileAboutMeUI_stageName__"]', 0);
+            if (!$profileNameElement) {
+                return parent::getName();
+            }
+
+            $profileNameElementContent = $profileNameElement->innertext;
+            $index = strpos($profileNameElementContent, '<');
+            $profileName = substr($profileNameElementContent, 0, $index);
+
+            return 'ManyVids: ' . $profileName;
+        }
+
+        return parent::getName();
+    }
+
+    public function getUri()
+    {
+        $profile = $this->getInput('profile');
+        if ($profile) {
+            return sprintf('%s/Profile/%s/Store/Videos', $this::URI, $profile);
+        }
+
+        return parent::getUri();
+    }
+
+    private function getHTML($profile)
+    {
+        if (is_null($this->domCache)) {
+            $opt = [CURLOPT_COOKIE => 'sfwtoggle=false'];
+            $url = sprintf('https://manyvids.com/Profile/%s/Store/Videos?sort=newest', $profile);
+            $this->domCache = getSimpleHTMLDOM($url, [], $opt);
+        }
+
+        return $this->domCache;
+    }
 }

From 9d6aa5ee38d5b2bd933e5f8d9504c39ea5f71bec Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 25 Mar 2025 23:52:47 +0100
Subject: [PATCH 618/716] fix: operator precedence bug (#4494)

---
 lib/BridgeAbstract.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/BridgeAbstract.php b/lib/BridgeAbstract.php
index b814097a..f08d201f 100644
--- a/lib/BridgeAbstract.php
+++ b/lib/BridgeAbstract.php
@@ -240,7 +240,7 @@ abstract class BridgeAbstract
                 if (isset($input[$name])) {
                     $value = $input[$name];
                 } else {
-                    if ($properties['type'] ?? null === 'checkbox') {
+                    if (($properties['type'] ?? null) === 'checkbox') {
                         $value = false;
                     } elseif (isset($properties['defaultValue'])) {
                         $value = $properties['defaultValue'];

From 4d8a46d46eda9381e07aecc80e12ba9858781789 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 26 Mar 2025 00:07:33 +0100
Subject: [PATCH 619/716] feat: add sanity check for required curl module
 (#4495)

---
 index.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/index.php b/index.php
index ec7490d6..02ea9a3d 100644
--- a/index.php
+++ b/index.php
@@ -5,6 +5,11 @@ if (version_compare(\PHP_VERSION, '7.4.0') === -1) {
     exit("RSS-Bridge requires minimum PHP version 7.4\n");
 }
 
+if (!extension_loaded('curl')) {
+    http_response_code(500);
+    exit("RSS-Bridge requires curl (apt install php-curl)\n");
+}
+
 require __DIR__ . '/lib/bootstrap.php';
 require __DIR__ . '/lib/config.php';
 

From 7c1e01b45a86a694ed38eb25068f8e60e825c84c Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Thu, 27 Mar 2025 00:16:02 +0530
Subject: [PATCH 620/716] [MinecraftBridge] Add Bridge (#4497)

---
 bridges/MinecraftBridge.php | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 bridges/MinecraftBridge.php

diff --git a/bridges/MinecraftBridge.php b/bridges/MinecraftBridge.php
new file mode 100644
index 00000000..8b6be3db
--- /dev/null
+++ b/bridges/MinecraftBridge.php
@@ -0,0 +1,31 @@
+<?php
+
+class MinecraftBridge extends BridgeAbstract
+{
+    const NAME = 'Minecraft';
+    const URI = 'https://www.minecraft.net';
+    const DESCRIPTION = 'Catch up on the latest Minecraft articles';
+    const MAINTAINER = 'tillcash';
+
+    public function collectData()
+    {
+        $json = getContents(
+            'https://www.minecraft.net/content/minecraftnet/language-masters/en-us/_jcr_content.articles.page-1.json'
+        );
+
+        $articles = json_decode($json);
+
+        if ($articles === null) {
+            returnServerError('Failed to decode JSON content.');
+        }
+
+        foreach ($articles->article_grid as $article) {
+            $this->items[] = [
+                'title' => $article->default_tile->title,
+                'uid' => $article->article_url,
+                'uri' => self::URI . $article->article_url,
+                'content' => $article->default_tile->sub_header,
+            ];
+        }
+    }
+}

From 3055e69c237238d87a8e0df8053eae0d69a7a23b Mon Sep 17 00:00:00 2001
From: subtle4553 <chocolatea795@gmail.com>
Date: Thu, 27 Mar 2025 21:02:12 +0100
Subject: [PATCH 621/716] [ManyVidsBridge] Fix parsing of URL input (#4499)

---
 bridges/ManyVidsBridge.php | 56 +++++++++++++++++---------------------
 1 file changed, 25 insertions(+), 31 deletions(-)

diff --git a/bridges/ManyVidsBridge.php b/bridges/ManyVidsBridge.php
index 29ebd5f7..e2faacb4 100644
--- a/bridges/ManyVidsBridge.php
+++ b/bridges/ManyVidsBridge.php
@@ -10,7 +10,7 @@ class ManyVidsBridge extends BridgeAbstract
     const PARAMETERS = [
         [
             'profile' => [
-                'name' => 'Profil',
+                'name' => 'Profile',
                 'type' => 'text',
                 'required' => true,
                 'exampleValue' => '678459/Aziani-Studios',
@@ -19,21 +19,30 @@ class ManyVidsBridge extends BridgeAbstract
         ]
     ];
 
-    private $domCache = null;
+    private ?simple_html_dom $htmlDom = null;
+    private ?string $parsedProfileInput = null;
 
     public function collectData()
     {
         $profile = $this->getInput('profile');
-        if (preg_match('#^(\d+/.*)$#', $profile, $m)) {
-            $profile = $m[1];
-        } elseif (preg_match('#https://www.manyvids.com/Profile/(\d+/\w+)#', $profile, $m)) {
-            $profile = $m[1];
-        } else {
-            throw new \Exception('nope');
+        if (!$profile) {
+            throw new \Exception('No value for \'profile\' was provided.');
         }
 
-        $dom = $this->getHTML($profile);
-        $elements = $dom->find('div[class^="ProfileTabGrid_card__"]');
+        if (preg_match('#^(\d+/.*)$#', $profile, $m)) {
+            $this->parsedProfileInput = $m[1];
+        } elseif (preg_match('#https://(www.)?manyvids.com/Profile/(\d+/.*?)/#', $profile, $m)) {
+            $this->parsedProfileInput = $m[2];
+        } else {
+            throw new \Exception(sprintf('Profile could not be parsed: %s', $profile));
+        }
+
+        $profileUrl = $this->getUri();
+        $url = sprintf('%s?sort=newest', $profileUrl);
+        $opt = [CURLOPT_COOKIE => 'sfwtoggle=false'];
+        $this->htmlDom = getSimpleHTMLDOM($url, [], $opt);
+
+        $elements = $this->htmlDom->find('div[class^="ProfileTabGrid_card__"]');
 
         foreach ($elements as $element) {
             $content = '';
@@ -45,7 +54,7 @@ class ManyVidsBridge extends BridgeAbstract
 
             $linkElement = $element->find('a[href^="/Video/"]', 0);
             if ($linkElement) {
-                $itemUri = $this::URI . $linkElement->getAttribute('href');
+                $itemUri = self::URI . $linkElement->getAttribute('href');
             }
 
             $image = $element->find('img', 0);
@@ -78,18 +87,15 @@ class ManyVidsBridge extends BridgeAbstract
             $this->items[] = [
                 'title' => $title->innertext,
                 'uri' => isset($itemUri) ? $itemUri : null,
-                'content' => $content
+                'content' => $content,
             ];
         }
     }
 
     public function getName()
     {
-        $profile = $this->getInput('profile');
-
-        if ($profile) {
-            $dom = $this->getHTML($profile);
-            $profileNameElement = $dom->find('[class^="ProfileAboutMeUI_stageName__"]', 0);
+        if (!is_null($this->htmlDom)) {
+            $profileNameElement = $this->htmlDom->find('[class^="ProfileAboutMeUI_stageName__"]', 0);
             if (!$profileNameElement) {
                 return parent::getName();
             }
@@ -106,22 +112,10 @@ class ManyVidsBridge extends BridgeAbstract
 
     public function getUri()
     {
-        $profile = $this->getInput('profile');
-        if ($profile) {
-            return sprintf('%s/Profile/%s/Store/Videos', $this::URI, $profile);
+        if (!is_null($this->parsedProfileInput)) {
+            return sprintf('%s/Profile/%s/Store/Videos', self::URI, $this->parsedProfileInput);
         }
 
         return parent::getUri();
     }
-
-    private function getHTML($profile)
-    {
-        if (is_null($this->domCache)) {
-            $opt = [CURLOPT_COOKIE => 'sfwtoggle=false'];
-            $url = sprintf('https://manyvids.com/Profile/%s/Store/Videos?sort=newest', $profile);
-            $this->domCache = getSimpleHTMLDOM($url, [], $opt);
-        }
-
-        return $this->domCache;
-    }
 }

From 26a4c255d3ac7a2bd236e69dbcc3e0e3c792d6d9 Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Tue, 1 Apr 2025 00:41:33 +0200
Subject: [PATCH 622/716] [html] convertLazyLoading: Add parseSrcset() (#4503)

* [html] convertLazyLoading: Add parseSrcset()

Add srcset parser closer to the specifications

* [html] code linting

* [html] parseSrcset: Add type hints, check preg_match_all
---
 lib/html.php | 71 +++++++++++++++++++++++++++++++++++++++++++---------
 1 file changed, 59 insertions(+), 12 deletions(-)

diff --git a/lib/html.php b/lib/html.php
index eeaf2b32..71a3a29e 100644
--- a/lib/html.php
+++ b/lib/html.php
@@ -226,6 +226,63 @@ function defaultLinkTo($dom, $url)
     return $dom;
 }
 
+/**
+ * Parse a srcset HTML attribute value and return size => URL mappings
+ * Srcset contains a list of image URLs with associated size specified as size (e.g. 1024w) or scale (e.g. 2x)
+ * The web browser should pick the most appropriate image depending on screen size and/or pixel density
+ *
+ * This function takes a srcset string such as the following:
+ * header640.png 640w, header960.png 960w, header1024.png 1024w
+ *
+ * Returns an array such as the following:
+ * [
+ *    '640w' => 'header640.png',
+ *    '960w' => 'header960.png',
+ *    '1024w' => 'header1024.png'
+ * ]
+ *
+ * @param string $srcset Content of srcset html attribute
+ * @param bool $return_largest_url Instead of returning an array, return URL for the largest entry
+ * @return array|string Content of srcset attribute as { size => url } array, or largest entry URL if requested
+ */
+function parseSrcset(string $srcset, bool $return_largest_url = false)
+{
+    // The srcset format is more tricky to parse that it seems:
+    //   URLs may contain commas, and space after comma is not mandatory, so the following is valid:
+    //   image.png?resize=640,640 640w,image.png?resize=960,960 960w,image.png?resize=1024,1024 1024w
+    // Since splitting by space or comma will not work, there is a precise algorithm to parse srcset attribute:
+    //   https://html.spec.whatwg.org/multipage/images.html#parse-a-srcset-attribute
+    //   To summarize, each srcset entry has the following format:
+    //     1. Leading spaces and comma. Zero or more spaces, zero or at most one comma
+    //     2. Any amount of characters up to the next whitespace (space, tab, newline...): This is the URL
+    //     3. A nonnegative number followed by lowercase w, x or h: This is the image size
+    //   We parse the srcset entries using a regex to mimick the above parser/tokenizer behavior.
+    $preg_status = preg_match_all('/[\s]*,?[\s]*([^\s]+)\s+([0-9]+[wxh])/', $srcset, $matches);
+    $entries = [];
+    if ($preg_status !== false && $preg_status > 0) {
+        foreach ($matches[1] as $index => $url) {
+            if (array_key_exists($index, $matches[2])) {
+                $size = $matches[2][$index];
+                $entries[$size] = html_entity_decode($url);
+            }
+        }
+    }
+    if ($return_largest_url) {
+        $largest_image_url = null;
+        $largest_image_size = -1;
+        foreach ($entries as $size => $url) {
+            $size_int = intval(substr($size, 0, strlen($size) - 1));
+            if ($size_int > $largest_image_size) {
+                $largest_image_size = $size_int;
+                $largest_image_url = $url;
+            }
+        }
+        return $largest_image_url;
+    } else {
+        return $entries;
+    }
+}
+
 /**
  * Convert lazy-loading images and frames (video embeds) into static elements
  *
@@ -244,28 +301,18 @@ function convertLazyLoading($dom)
         $dom = str_get_html($dom);
     }
 
-    // Retrieve image URL from srcset attribute
-    // https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/srcset
-    // Example: convert "header640.png 640w, header960.png 960w, header1024.png 1024w" to "header1024.png"
-    $srcset_to_src = function ($srcset) {
-        $sources = explode(',', $srcset);
-        $last_entry = trim($sources[array_key_last($sources)]);
-        $url = explode(' ', $last_entry)[0];
-        return $url;
-    };
-
     // Process standalone images, embeds and picture sources
     foreach ($dom->find('img, iframe, source') as $img) {
         if (!empty($img->getAttribute('data-src'))) {
             $img->src = $img->getAttribute('data-src');
         } elseif (!empty($img->getAttribute('data-srcset'))) {
-            $img->src = $srcset_to_src($img->getAttribute('data-srcset'));
+            $img->src = parseSrcset($img->getAttribute('data-srcset'));
         } elseif (!empty($img->getAttribute('data-lazy-src'))) {
             $img->src = $img->getAttribute('data-lazy-src');
         } elseif (!empty($img->getAttribute('data-orig-file'))) {
             $img->src = $img->getAttribute('data-orig-file');
         } elseif (!empty($img->getAttribute('srcset'))) {
-            $img->src = $srcset_to_src($img->getAttribute('srcset'));
+            $img->src = parseSrcset($img->getAttribute('srcset'));
         } else {
             continue; // Proceed to next element without removing attributes
         }

From db42f2786c6f362b7ce9f152578592ee4c92ae9f Mon Sep 17 00:00:00 2001
From: ORelio <ORelio@users.noreply.github.com>
Date: Tue, 1 Apr 2025 00:42:08 +0200
Subject: [PATCH 623/716] [FeedExpander] Add prepareXml() overridable function
 (#4485)

* FeedExpander: Remove tailing content in XML

- Move preprocessing code into overridable preprocessXml()
- Auto-remove trailing data after root xml node

* FeedExpander: Add PR reference with use case

* FeedExpander: Code linting

* [FeedExpander] Keep content at end of document for now

Will add back later if more sites have the same issue

* [FeedExpander] prepareXml: Add type hints
---
 lib/FeedExpander.php | 26 ++++++++++++++++++--------
 1 file changed, 18 insertions(+), 8 deletions(-)

diff --git a/lib/FeedExpander.php b/lib/FeedExpander.php
index ef001af1..1a47851b 100644
--- a/lib/FeedExpander.php
+++ b/lib/FeedExpander.php
@@ -22,14 +22,7 @@ abstract class FeedExpander extends BridgeAbstract
         if ($xmlString === '') {
             throw new \Exception(sprintf('Unable to parse xml from `%s` because we got the empty string', $url), 10);
         }
-        // prepare/massage the xml to make it more acceptable
-        $problematicStrings = [
-            '&nbsp;',
-            '&raquo;',
-            '&rsquo;',
-        ];
-        $xmlString = str_replace($problematicStrings, '', $xmlString);
-
+        $xmlString = $this->prepareXml($xmlString);
         $feedParser = new FeedParser();
         try {
             $this->feed = $feedParser->parseFeed($xmlString);
@@ -59,6 +52,23 @@ abstract class FeedExpander extends BridgeAbstract
         return $item;
     }
 
+    /**
+    * Prepare XML document to make it more acceptable by the parser
+    * This method can be overriden by bridges to change this behavior
+    *
+    * @return string
+    */
+    protected function prepareXml(string $xmlString): string
+    {
+        // Remove problematic escape sequences
+        $problematicStrings = [
+            '&nbsp;',
+            '&raquo;',
+            '&rsquo;',
+        ];
+        return str_replace($problematicStrings, '', $xmlString);
+    }
+
     public function getURI()
     {
         return $this->feed['uri'] ?? parent::getURI();

From 462c005f2c928234999f48a2d4fe50d8aa26ab52 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 1 Apr 2025 01:15:59 +0200
Subject: [PATCH 624/716] fix: dont read /etc if open_basedir #4502 (#4505)

---
 lib/utils.php | 36 ++++++++++++++++++++----------------
 1 file changed, 20 insertions(+), 16 deletions(-)

diff --git a/lib/utils.php b/lib/utils.php
index 07806e7c..1f6aa799 100644
--- a/lib/utils.php
+++ b/lib/utils.php
@@ -175,24 +175,28 @@ function parse_mime_type($url)
             'image' => 'image/*',
             'mp3' => 'audio/mpeg',
         ];
-        // '@' is used to mute open_basedir warning, see issue #818
-        if (@is_readable('/etc/mime.types')) {
-            $file = fopen('/etc/mime.types', 'r');
-            while (($line = fgets($file)) !== false) {
-                $line = trim(preg_replace('/#.*/', '', $line));
-                if (!$line) {
-                    continue;
-                }
-                $parts = preg_split('/\s+/', $line);
-                if (count($parts) == 1) {
-                    continue;
-                }
-                $type = array_shift($parts);
-                foreach ($parts as $part) {
-                    $mime[$part] = $type;
+        // if-check to avoid excessive php errors about open_basedir restriction (#4502)
+        $open_basedir = ini_get('open_basedir');
+        if (! $open_basedir) {
+            // '@' is used to mute open_basedir warning, see issue #818
+            if (@is_readable('/etc/mime.types')) {
+                $file = fopen('/etc/mime.types', 'r');
+                while (($line = fgets($file)) !== false) {
+                    $line = trim(preg_replace('/#.*/', '', $line));
+                    if (!$line) {
+                        continue;
+                    }
+                    $parts = preg_split('/\s+/', $line);
+                    if (count($parts) == 1) {
+                        continue;
+                    }
+                    $type = array_shift($parts);
+                    foreach ($parts as $part) {
+                        $mime[$part] = $type;
+                    }
                 }
+                fclose($file);
             }
-            fclose($file);
         }
     }
 

From 5365b576382ea146c8759781bc6cbde933673812 Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Wed, 2 Apr 2025 07:27:40 +0530
Subject: [PATCH 625/716] [MinecraftBridge] fix favicon (#4506)

---
 bridges/MinecraftBridge.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/bridges/MinecraftBridge.php b/bridges/MinecraftBridge.php
index 8b6be3db..91550e88 100644
--- a/bridges/MinecraftBridge.php
+++ b/bridges/MinecraftBridge.php
@@ -7,6 +7,11 @@ class MinecraftBridge extends BridgeAbstract
     const DESCRIPTION = 'Catch up on the latest Minecraft articles';
     const MAINTAINER = 'tillcash';
 
+    public function getIcon()
+    {
+        return 'https://www.minecraft.net/etc.clientlibs/minecraftnet/clientlibs/clientlib-site/resources/favicon.ico';
+    }
+
     public function collectData()
     {
         $json = getContents(

From a19b63e8408210fe3d0cb59f830d6ac5173ccafa Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Tue, 1 Apr 2025 22:09:28 -0400
Subject: [PATCH 626/716] [AO3Bridge] Add option to make one entry per fic
 (#4508)

---
 bridges/AO3Bridge.php | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/bridges/AO3Bridge.php b/bridges/AO3Bridge.php
index 7e18b657..2697dbc7 100644
--- a/bridges/AO3Bridge.php
+++ b/bridges/AO3Bridge.php
@@ -27,6 +27,13 @@ class AO3Bridge extends BridgeAbstract
                     'Entire work' => 'all',
                 ],
             ],
+            'unique' => [
+                'name' => 'Make separate entries for new fic chapters',
+                'type' => 'checkbox',
+                'required' => false,
+                'title' => 'Make separate entries for new fic chapters',
+                'defaultValue' => 'checked',
+            ],
             'limit' => self::LIMIT,
         ],
         'Bookmarks' => [
@@ -118,7 +125,12 @@ class AO3Bridge extends BridgeAbstract
             $chapters = $element->find('dl dd.chapters', 0);
             // bookmarked series and external works do not have a chapters count
             $chapters = (isset($chapters) ? $chapters->plaintext : 0);
-            $item['uid'] = $item['uri'] . "/$strdate/$chapters";
+            if ($this->getInput('unique')) {
+                $item['uid'] = $item['uri'] . "/$strdate/$chapters";
+            } else {
+                $item['uid'] = $item['uri'];
+            }
+
 
             // Fetch workskin of desired chapter(s) in list
             if ($this->getInput('range') && ($limit == 0 || $count++ < $limit)) {

From 85962e18d3bfbba5b0a7dce502a82b0487c2affc Mon Sep 17 00:00:00 2001
From: Jonathan Kay <git@jonathankay.com>
Date: Thu, 3 Apr 2025 01:50:16 -0400
Subject: [PATCH 627/716] [GoComicsBridge] New layout fix and added features
 (#4510)

* Updated to use the new layout launched April 1st
* Adds new title date/full name option
* Adds limit option for how many days of comics to get
---
 bridges/GoComicsBridge.php | 44 ++++++++++++++++++++++++++++----------
 1 file changed, 33 insertions(+), 11 deletions(-)

diff --git a/bridges/GoComicsBridge.php b/bridges/GoComicsBridge.php
index 586e2a0d..fe36d851 100644
--- a/bridges/GoComicsBridge.php
+++ b/bridges/GoComicsBridge.php
@@ -2,7 +2,8 @@
 
 class GoComicsBridge extends BridgeAbstract
 {
-    const MAINTAINER = 'sky';
+    const MAINTAINER = 'TReKiE';
+    //const MAINTAINER = 'sky';
     const NAME = 'GoComics Unofficial RSS';
     const URI = 'https://www.gocomics.com/';
     const CACHE_TIMEOUT = 21600; // 6h
@@ -13,32 +14,53 @@ class GoComicsBridge extends BridgeAbstract
             'type' => 'text',
             'exampleValue' => 'heartofthecity',
             'required' => true
+        ],
+        'date-in-title' => [
+            'name' => 'Add date and full name to each day\'s title',
+            'type' => 'checkbox',
+            'title' => 'Adds the date and the full name into the title of each day\'s comic',
+        ],
+        'limit' => [
+            'name' => 'Limit',
+            'type' => 'number',
+            'title' => 'The number of recent comics to get',
+            'defaultValue' => 5
         ]
     ]];
 
     public function collectData()
     {
-        $html = getSimpleHTMLDOM($this->getURI());
+        $link = $this->getURI();
 
-        //Get info from first page
-        $author = preg_replace('/By /', '', $html->find('.media-subheading', 0)->plaintext);
+        for ($i = 0; $i < $this->getInput('limit'); $i++) {
+            $html = getSimpleHTMLDOM($link);
+            // get json data from the first page
+            $json = $html->find('div.ComicViewer_comicViewer__comic__oftX6 script[type="application/ld+json"]', 0)->innertext;
+            $data = json_decode($json, false);
 
-        $link = self::URI . $html->find('.gc-deck--cta-0', 0)->find('a', 0)->href;
-        for ($i = 0; $i < 5; $i++) {
             $item = [];
 
-            $page = getSimpleHTMLDOM($link);
-            $imagelink = $page->find('.comic.container', 0)->getAttribute('data-image');
-            $date = explode('/', $link);
+            $author = $data->author->name;
+            $imagelink = $data->contentUrl;
+            $date = $data->datePublished;
+            $title = $data->name . ' - GoComics';
+
+            // get a permlink for this day's comic if there isn't one specified
+            if ($link === $this->getURI()) {
+                $link = $this->getURI() . '/' . DateTime::createFromFormat('F j, Y', $date)->format('Y/m/d');
+            }
 
             $item['id'] = $imagelink;
             $item['uri'] = $link;
             $item['author'] = $author;
             $item['title'] = 'GoComics ' . $this->getInput('comicname');
-            $item['timestamp'] = DateTime::createFromFormat('Ymd', $date[5] . $date[6] . $date[7])->getTimestamp();
+            if ($this->getInput('date-in-title') === true) {
+                $item['title'] = $title;
+            }
+            $item['timestamp'] = DateTime::createFromFormat('F j, Y', $date)->setTime(0, 0, 0)->getTimestamp();
             $item['content'] = '<img src="' . $imagelink . '" />';
 
-            $link = self::URI . $page->find('.js-previous-comic', 0)->href;
+            $link = rtrim(self::URI, '/') . $html->find('.Controls_controls__button_previous__P4LhX', 0)->href;
             $this->items[] = $item;
         }
     }

From d6a9da1cc8d2d3a522adecbcf85964578170189c Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Thu, 3 Apr 2025 01:51:58 -0400
Subject: [PATCH 628/716] [SubstackProfileBridge] Add new bridge (#4507)

---
 bridges/SubstackProfileBridge.php | 209 ++++++++++++++++++++++++++++++
 1 file changed, 209 insertions(+)
 create mode 100644 bridges/SubstackProfileBridge.php

diff --git a/bridges/SubstackProfileBridge.php b/bridges/SubstackProfileBridge.php
new file mode 100644
index 00000000..d488aff0
--- /dev/null
+++ b/bridges/SubstackProfileBridge.php
@@ -0,0 +1,209 @@
+<?php
+
+class SubstackProfileBridge extends BridgeAbstract
+{
+    const NAME = 'Substack Profile';
+    const MAINTAINER = 'phantop';
+    const URI = 'https://substack.com/';
+    const DESCRIPTION = 'Returns posts from profiles on Substack';
+    const PARAMETERS = [[
+        'profile' => [
+            'name' => 'Profile name to use',
+            'exampleValue' => 'taliabhatt',
+        ],
+    ]];
+
+    private $name;
+    private $icon;
+    public function collectData()
+    {
+        $html = getSimpleHTMLDOMCached($this->getURI());
+        preg_match('/<script>window\._preloads\s*= JSON\.parse\("(.+?)"\)\s*<\/script>/', $html, $preg);
+        $json = stripcslashes($preg[1]);
+        $profile = json_decode($json, true)['profile'];
+
+        $this->name = $profile['name'];
+        $this->icon = $profile['photo_url'];
+
+        $id = $profile['id'];
+        $json = getContents(parent::getURI() . "api/v1/reader/feed/profile/$id");
+        foreach (json_decode($json, true)['items'] as $element) {
+            $this->items[] = $this->processAttachment($element);
+        }
+    }
+
+    private function processAttachment(array $element)
+    {
+        $item = [];
+        switch ($element['type']) {
+            case 'comment':
+                $element = $element['comment'];
+                $item['author'] = $element['name'] ?? $element['user']['name'];
+                $item['content'] = '';
+                if (isset($element['body_json'])) {
+                    $item['content'] = $this->processBodyJson($element['body_json']);
+                }
+                $item['timestamp'] = $element['date'];
+                $item['title'] = 'Comment by ' . $item['author'];
+                $item['uri'] = $this->getURI() . '/note/c-' . $element['id'];
+                break;
+            case 'post':
+                $item['content'] = $element['postSelection']['text'] ?? '';
+                $element = $element['post'];
+                $item['author'] = $element['publishedBylines'][0]['name'];
+                $item['content'] .= $this->fetchPost($element['id']);
+                $item['timestamp'] = $element['post_date'];
+                $item['title'] = $element['title'];
+                $item['uri'] = parent::getURI() . 'home/post/p-' . $element['id'];
+                break;
+            case 'link':
+                $element = $element['linkMetadata'];
+                $item['author'] = $element['host'];
+                $item['content'] = $element['description'];
+                $item['title'] = $element['title'];
+                $item['uri'] = $element['url'];
+                break;
+            case 'image':
+                $item['uri'] = $element['imageUrl'];
+                break;
+            default:
+                throw new Exception('Invalid Substack entry type: ' . $element['type']);
+        }
+
+        $item['enclosures'] = [
+            $element['audio_items'][0]['audio_url'] ?? null,
+            $element['audio_items'][1]['audio_url'] ?? null,
+            $element['cover_image'] ?? null,
+            $element['image'] ?? null,
+            $element['imageUrl'] ?? null,
+        ];
+
+        $item['categories'] = array_map(fn($tag) => $tag['name'], $element['postTags'] ?? []);
+        $item['comments'] = $item['uri'] . '/restacks/notes';
+
+        if (isset($element['attachments'])) {
+            foreach ($element['attachments'] as $attachment) {
+                $attachment = $this->processAttachment($attachment);
+                $item['categories'] = array_merge($item['categories'], $attachment['categories']);
+                $item['enclosures'] = array_merge($item['enclosures'], $attachment['enclosures']);
+                if (isset($attachment['title'])) { // Nothing to quote for images
+                    $item['content'] .= $this->quoteAttachment($attachment);
+                }
+            }
+        }
+
+        return $item;
+    }
+
+    private function fetchPost(string $id)
+    {
+        $json = getContents(parent::getURI() . "api/v1/posts/by-id/$id");
+        $json = json_decode($json, true)['post'];
+        $html = str_get_html($json['body_html']);
+        $body = $html->root;
+        $block = $html->createElement('div');
+        $block->appendChild($html->createElement('hr'));
+        $block->appendChild($html->createElement('h4', 'Full text:'));
+        $block->appendChild($body);
+        return $block->innertext();
+    }
+
+    private function quoteAttachment(array $attachment)
+    {
+        $html = new simple_html_dom();
+        $body = $html->createElement('div');
+        $body->appendChild($html->createElement('hr'));
+        $link = $html->createElement('a');
+        $link->href = $attachment['uri'];
+        $link->appendChild($html->createElement('h3', $attachment['title']));
+        $body->appendChild($link);
+        if ($attachment['content'] != '') {
+            $body->appendChild($html->createElement('h4', 'Qouting ' . $attachment['author'] . ':'));
+            $body->appendChild($html->createElement('blockquote', $attachment['content']));
+        }
+        return $body->innertext();
+    }
+
+    private function processBodyJson(array $json)
+    {
+        $html = new simple_html_dom();
+        $body = $html->createElement('div');
+        foreach ($json['content'] as $block) {
+            if (isset($block['content'])) {
+                $content = $this->processBodyJson($block);
+            }
+            switch ($block['type']) {
+                case 'blockquote':
+                    $content->tag = 'blockquote';
+                    $body->appendChild($content);
+                    break;
+                case 'paragraph':
+                    $content->tag = 'p';
+                    $body->appendChild($content);
+                    break;
+                case 'text':
+                    $text = $html->createTextNode($block['text']);
+                    if (isset($block['marks'])) {
+                        foreach ($block['marks'] as $mark) {
+                            switch ($mark['type']) {
+                                case 'bold':
+                                    $marked = $html->createElement('strong');
+                                    $marked->appendChild($text);
+                                    $text = $marked;
+                                    break;
+                                case 'italic':
+                                    $marked = $html->createElement('em');
+                                    $marked->appendChild($text);
+                                    $text = $marked;
+                                    break;
+                                case 'link':
+                                    $marked = $html->createElement('a');
+                                    $marked->href = $mark['attrs']['href'];
+                                    $marked->appendChild($text);
+                                    $text = $marked;
+                                    break;
+                                default:
+                                    throw new Exception('Invalid text mark type: ' . $mark['type']);
+                            }
+                        }
+                    }
+                    $body->appendChild($text);
+                    break;
+                case 'substack_mention':
+                    $link = $html->createElement('a');
+                    $link->href = parent::getURI() . 'profile/' . $block['attrs']['id'];
+                    $link->appendChild($html->createTextNode($block['attrs']['label']));
+                    $body->appendChild($link);
+                    break;
+                default:
+                    throw new Exception('Invalid body type: ' . $block['type']);
+            }
+        }
+        return $body;
+    }
+
+    public function getName()
+    {
+        $name = parent::getName();
+        if (isset($this->name)) {
+            $name .= " - $this->name";
+        }
+        return $name;
+    }
+
+    public function getIcon()
+    {
+        if (isset($this->icon)) {
+            return $this->icon;
+        }
+        return parent::getIcon();
+    }
+
+    public function getURI()
+    {
+        if ($this->getInput('profile') != null) {
+            return parent::getURI() . '@' . $this->getInput('profile');
+        }
+        return parent::getURI();
+    }
+}

From 95af1ffddf58ba183b7f99c6e56b61d06eaad00e Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 8 Apr 2025 21:12:42 +0200
Subject: [PATCH 629/716] fix(reuters): tweak, try to avoid antibot (#4515)

---
 bridges/ReutersBridge.php | 188 ++++++++++++++++++++------------------
 1 file changed, 101 insertions(+), 87 deletions(-)

diff --git a/bridges/ReutersBridge.php b/bridges/ReutersBridge.php
index 5b8e08f6..44beb37a 100644
--- a/bridges/ReutersBridge.php
+++ b/bridges/ReutersBridge.php
@@ -5,7 +5,7 @@ class ReutersBridge extends BridgeAbstract
     const MAINTAINER = 'hollowleviathan, spraynard, csisoap';
     const NAME = 'Reuters Bridge';
     const URI = 'https://www.reuters.com';
-    const CACHE_TIMEOUT = 1800; // 30min
+    const CACHE_TIMEOUT = 3600; // 1h
     const DESCRIPTION = 'Returns news from Reuters';
 
     private $feedName = self::NAME;
@@ -142,6 +142,98 @@ class ReutersBridge extends BridgeAbstract
         'wire'
     ];
 
+    public function collectData()
+    {
+        $endpoint = $this->getSectionEndpoint();
+        $url = $this->getAPIURL($endpoint, 'section');
+        $json = getContents($url);
+        $data = Json::decode($json);
+
+        $stories = [];
+        $section_name = '';
+        if ($this->useWireAPI) {
+            $reuters_wireitems = $data['wireitems'];
+            $section_name = $data['wire_name'];
+            $processedData = $this->processData($reuters_wireitems);
+
+            // Merge all articles from Editor's Highlight section into existing array of templates.
+            $top_section = reset($processedData);
+            if ($top_section['type'] == 'headlines') {
+                $top_section = array_shift($processedData);
+                $articles = $top_section['headlines'];
+                $processedData = array_merge($articles, $processedData);
+            }
+            $stories = $processedData;
+        } else {
+            $section_name = $data['result']['section']['name'];
+            if (isset($data['arcResult']['articles'])) {
+                $stories = $data['arcResult']['articles'];
+            } else {
+                $stories = $data['result']['articles'];
+            }
+        }
+        $this->feedName = $section_name . ' | Reuters';
+
+        usort($stories, function ($story1, $story2) {
+            return $story2['published_time'] <=> $story1['published_time'];
+        });
+
+        $stories = array_slice($stories, 0, 20);
+
+        foreach ($stories as $story) {
+            $uid = '';
+            $author = '';
+            $category = [];
+            $content = $story['description'];
+            $title = '';
+            $timestamp = $story['published_time'];
+            $url = '';
+            $article_uri = '';
+            $source_type = '';
+            if ($this->useWireAPI) {
+                $uid = $story['story']['usn'];
+                $article_uri = $story['template_action']['api_path'];
+                $title = $story['story']['hed'];
+                $url = $story['template_action']['url'];
+            } else {
+                $uid = $story['id'];
+                $url = self::URI . $story['canonical_url'];
+                $title = $story['title'];
+                $article_uri = $story['canonical_url'];
+                $source_type = $story['source']['name'];
+            }
+
+            // Some article cause unexpected behaviour like redirect to another site not API.
+            // Attempt to check article source type to avoid this.
+            if (!$this->useWireAPI && $source_type != 'Package') { // Only Reuters PF api have this, Wire don't.
+                $author = $this->handleAuthorName($story['authors'] ?? []);
+                $timestamp = $story['published_time'];
+                $image_placeholder = '';
+                if (isset($story['thumbnail'])) {
+                    $image_placeholder = $this->handleImage([$story['thumbnail']]);
+                }
+                $content = $story['description'] . $image_placeholder;
+                if (isset($story['primary_section']['name'])) {
+                    $category = [$story['primary_section']['name']];
+                } else {
+                    $category = [];
+                }
+            } else {
+                $content_detail = $this->getArticle($article_uri);
+                $description = $content_detail['content'];
+                $description = defaultLinkTo($description, $this->getURI());
+
+                $author = $content_detail['author'];
+                $images = $content_detail['images'];
+                $category = $content_detail['category'];
+                //$content = "$description  $images";
+                //$timestamp = $content_detail['published_at'];
+            }
+
+            $this->addStories($title, $content, $timestamp, $author, $url, $category);
+        }
+    }
+
     /**
      * Takes in data from Reuters Wire API and
      * creates structured data in the form of a list
@@ -280,6 +372,14 @@ class ReutersBridge extends BridgeAbstract
 
     private function getArticle($feed_uri, $is_article_uid = false)
     {
+        // Temp fix to try to avoid reuters anti-bot
+        return [
+            'content' => '',
+            'author' => '',
+            'category' => '',
+            'images' => '',
+            'published_at' => ''
+        ];
         // This will make another request to API to get full detail of article and author's name.
         $url = $this->getAPIURL($feed_uri, 'article', $is_article_uid);
 
@@ -493,90 +593,4 @@ EOD;
     {
         return $this->feedName;
     }
-
-    public function collectData()
-    {
-        $endpoint = $this->getSectionEndpoint();
-        $url = $this->getAPIURL($endpoint, 'section');
-        $json = getContents($url);
-        $data = Json::decode($json);
-
-        $stories = [];
-        $section_name = '';
-        if ($this->useWireAPI) {
-            $reuters_wireitems = $data['wireitems'];
-            $section_name = $data['wire_name'];
-            $processedData = $this->processData($reuters_wireitems);
-
-            // Merge all articles from Editor's Highlight section into existing array of templates.
-            $top_section = reset($processedData);
-            if ($top_section['type'] == 'headlines') {
-                $top_section = array_shift($processedData);
-                $articles = $top_section['headlines'];
-                $processedData = array_merge($articles, $processedData);
-            }
-            $stories = $processedData;
-        } else {
-            $section_name = $data['result']['section']['name'];
-            if (isset($data['arcResult']['articles'])) {
-                $stories = $data['arcResult']['articles'];
-            } else {
-                $stories = $data['result']['articles'];
-            }
-        }
-        $this->feedName = $section_name . ' | Reuters';
-
-        foreach ($stories as $story) {
-            $uid = '';
-            $author = '';
-            $category = [];
-            $content = '';
-            $title = '';
-            $timestamp = '';
-            $url = '';
-            $article_uri = '';
-            $source_type = '';
-            if ($this->useWireAPI) {
-                $uid = $story['story']['usn'];
-                $article_uri = $story['template_action']['api_path'];
-                $title = $story['story']['hed'];
-                $url = $story['template_action']['url'];
-            } else {
-                $uid = $story['id'];
-                $url = self::URI . $story['canonical_url'];
-                $title = $story['title'];
-                $article_uri = $story['canonical_url'];
-                $source_type = $story['source']['name'];
-            }
-
-            // Some article cause unexpected behaviour like redirect to another site not API.
-            // Attempt to check article source type to avoid this.
-            if (!$this->useWireAPI && $source_type != 'Package') { // Only Reuters PF api have this, Wire don't.
-                $author = $this->handleAuthorName($story['authors'] ?? []);
-                $timestamp = $story['published_time'];
-                $image_placeholder = '';
-                if (isset($story['thumbnail'])) {
-                    $image_placeholder = $this->handleImage([$story['thumbnail']]);
-                }
-                $content = $story['description'] . $image_placeholder;
-                if (isset($story['primary_section']['name'])) {
-                    $category = [$story['primary_section']['name']];
-                } else {
-                    $category = [];
-                }
-            } else {
-                $content_detail = $this->getArticle($article_uri);
-                $description = $content_detail['content'];
-                $description = defaultLinkTo($description, $this->getURI());
-
-                $author = $content_detail['author'];
-                $images = $content_detail['images'];
-                $category = $content_detail['category'];
-                $content = "$description  $images";
-                $timestamp = $content_detail['published_at'];
-            }
-
-            $this->addStories($title, $content, $timestamp, $author, $url, $category);
-        }
-    }
 }

From a6ee8405331d2aa934491763fdbb465ccb39ada3 Mon Sep 17 00:00:00 2001
From: Petr Prenghy <121161956+pprenghy@users.noreply.github.com>
Date: Mon, 14 Apr 2025 12:55:41 +0200
Subject: [PATCH 630/716] Update 06_Public_Hosts.md (#4519)

new mirror in The Czech Republic
---
 docs/01_General/06_Public_Hosts.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/01_General/06_Public_Hosts.md b/docs/01_General/06_Public_Hosts.md
index 10a9871d..a4eca61d 100644
--- a/docs/01_General/06_Public_Hosts.md
+++ b/docs/01_General/06_Public_Hosts.md
@@ -25,6 +25,7 @@
 | ![](https://iplookup.flagfox.net/images/h16/IN.png) | https://rssbridge.projectsegfau.lt | ![](https://img.shields.io/website/https/rssbridge.projectsegfau.lt) | [@gi-yt](https://aryak.me) | Self-Hosted at Mumbai, India with Airtel (ISP) |
 | ![](https://iplookup.flagfox.net/images/h16/US.png) | https://rb.vern.cc | ![](https://img.shields.io/website/https/rb.vern.cc.svg) | [@vern.cc](https://vern.cc/en/admin) | Hosted with Hetzner, US |
 | ![](https://iplookup.flagfox.net/images/h16/DE.png) | https://rss.bloat.cat | ![](https://img.shields.io/website/https/rss.bloat.cat) | [@vlnst](https://bloat.cat/contact) | Hosted with Datalix, Germany |
+| ![](https://iplookup.flagfox.net/images/h16/CZ.png) | https://rssbridge.prenghy.org | ![](https://img.shields.io/website/https/rssbridge.prenghy.org.svg) | [@pprenghy](https://github.com/pprenghy) | Hosted with vpsFree, The Czech Republic |
 
 
 ## Inactive instances

From 0d20a8c48c59ff4da54e04b3210ea9991825146b Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Wed, 16 Apr 2025 02:47:57 +0200
Subject: [PATCH 631/716] fix(telegram): trim username for convenience #4520
 (#4521)

---
 bridges/TelegramBridge.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/bridges/TelegramBridge.php b/bridges/TelegramBridge.php
index 1f82c606..4ed70107 100644
--- a/bridges/TelegramBridge.php
+++ b/bridges/TelegramBridge.php
@@ -400,7 +400,9 @@ EOD;
 
     private function normalizeUsername()
     {
-        return ltrim($this->getInput('username'), '@');
+        $username = trim($this->getInput('username'));
+
+        return ltrim($username, '@');
     }
 
     public function detectParameters($url)

From e69ceba237812856e3bfd998aff02c848234931e Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Fri, 9 May 2025 01:45:55 +0530
Subject: [PATCH 632/716] [ZonebourseBridge] Add Bridge (#4501)

---
 bridges/ZonebourseBridge.php | 85 ++++++++++++++++++++++++++++++++++++
 1 file changed, 85 insertions(+)
 create mode 100644 bridges/ZonebourseBridge.php

diff --git a/bridges/ZonebourseBridge.php b/bridges/ZonebourseBridge.php
new file mode 100644
index 00000000..e8c91608
--- /dev/null
+++ b/bridges/ZonebourseBridge.php
@@ -0,0 +1,85 @@
+<?php
+
+class ZonebourseBridge extends BridgeAbstract
+{
+    const NAME = 'Zonebourse';
+    const URI = 'https://www.zonebourse.com';
+    const DESCRIPTION = 'Retrieve news from zonebourse.com';
+    const MAINTAINER = 'tillcash';
+    const PARAMETERS = [
+        [
+            'topic' => [
+                'name' => 'topic',
+                'type' => 'list',
+                'values' => [
+                    'toute-l-actualite' => [
+                        'monde' => '/actualite-bourse/',
+                        'france' => '/actualite-bourse/regions/locales/',
+                        'europe' => '/actualite-bourse/regions/europe/',
+                        'amerique-du-nord' => '/actualite-bourse/regions/amerique-du-nord/',
+                        'amerique-du-sud' => '/actualite-bourse/regions/amerique-du-sud/',
+                        'asie' => '/actualite-bourse/regions/asie/',
+                        'afrique' => '/actualite-bourse/regions/afrique/',
+                        'moyen-orient' => '/actualite-bourse/regions/moyenorient/',
+                        'emergents' => '/actualite-bourse/regions/emergents/',
+                    ],
+                    'societes' => [
+                        'toute-l-actualite' => '/actualite-bourse/societes/',
+                        'reco-analystes' => '/actualite-bourse/societes/recommandations/',
+                        'rumeurs' => '/actualite-bourse/societes/rumeur/',
+                        'introductions' => '/actualite-bourse/societes/introductions/',
+                        'operations-capitalistiques' => '/actualite-bourse/societes/operations/',
+                        'nouveaux-contrats' => '/actualite-bourse/societes/nouveaux-contrats/',
+                        'profits-warnings' => '/actualite-bourse/societes/profits-warnings/',
+                        'nominations' => '/actualite-bourse/societes/nominations/',
+                        'communiques' => '/actualite-bourse/societes/communique/',
+                        'operations-sur-titre' => '/actualite-bourse/societes/operations_titre/',
+                        'publications-de-resultats' => '/actualite-bourse/societes/publications/',
+                        'nouveaux-marches' => '/actualite-bourse/societes/nouveaux-marches/',
+                        'nouveaux-produits' => '/actualite-bourse/societes/nouveaux-produits/',
+                        'strategies-societes' => '/actualite-bourse/societes/strategies-societes/',
+                        'risques-juridiques' => '/actualite-bourse/societes/risques-juridiques/',
+                        'rachats-d-actions' => '/actualite-bourse/societes/rachats-actions/',
+                        'fusions-et-acquisitions' => '/actualite-bourse/societes/fusions-acquisitions/',
+                        'call-transcripts' => '/actualite-bourse/societes/call-transcripts/',
+                        'guidance' => '/actualite-bourse/societes/guidance/',
+                    ],
+                ],
+            ],
+        ],
+    ];
+
+    public function getName()
+    {
+        $topic = $this->getKey('topic');
+        return self::NAME . ($topic ? ': ' . $topic : '');
+    }
+
+    public function collectData()
+    {
+        $dom = getSimpleHTMLDOM(self::URI . $this->getInput('topic'));
+        $articles = $dom->find('table#newsScreener tbody tr');
+
+        if (!$articles) {
+            returnServerError('Failed to retrieve news content');
+        }
+
+        foreach ($articles as $article) {
+            $element = $article->find('.grid a', 0);
+
+            if (!$element || empty($element->plaintext) || empty($element->href)) {
+                continue;
+            }
+
+            $date = $article->find('span.js-date-relative.txt-muted.h-100', 0);
+            $timestamp = $date->{'data-utc-date'} ?? '';
+
+            $this->items[] = [
+                'timestamp'  => $timestamp,
+                'title'      => trim($element->plaintext),
+                'uid'        => $element->href,
+                'uri'        => self::URI . $element->href,
+            ];
+        }
+    }
+}

From e364dd1a20e33fcfa2349c3473bcb93b95363bb4 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 8 May 2025 22:37:56 +0200
Subject: [PATCH 633/716] fix(atom): omit item timestamp if absent (#4541)

prev behavior inserted current time, which seems wrong
---
 formats/AtomFormat.php | 24 +++++++++++-------------
 1 file changed, 11 insertions(+), 13 deletions(-)

diff --git a/formats/AtomFormat.php b/formats/AtomFormat.php
index 7908eb90..8df51189 100644
--- a/formats/AtomFormat.php
+++ b/formats/AtomFormat.php
@@ -72,10 +72,9 @@ class AtomFormat extends FormatAbstract
         $feed->appendChild($id);
         $id->appendChild($document->createTextNode($feedUrl));
 
-        $feedTimestamp = gmdate(DATE_ATOM, $this->lastModified);
         $updated = $document->createElement('updated');
         $feed->appendChild($updated);
-        $updated->appendChild($document->createTextNode($feedTimestamp));
+        $updated->appendChild($document->createTextNode(gmdate(DATE_ATOM, $this->lastModified)));
 
         // since we can't guarantee that all items have an author,
         // a global feed author is mandatory
@@ -108,10 +107,6 @@ class AtomFormat extends FormatAbstract
                 $entryID = 'urn:sha1:' . hash('sha1', $entryTitle . $entryContent);
             }
 
-            if (empty($entryTimestamp)) {
-                $entryTimestamp = $this->lastModified;
-            }
-
             if (empty($entryTitle)) {
                 $entryTitle = str_replace("\n", ' ', strip_tags($entryContent));
                 if (strlen($entryTitle) > 140) {
@@ -132,14 +127,17 @@ class AtomFormat extends FormatAbstract
             $title->setAttribute('type', 'html');
             $title->appendChild($document->createTextNode($entryTitle));
 
-            $entryTimestamp = gmdate(\DATE_ATOM, $entryTimestamp);
-            $published = $document->createElement('published');
-            $entry->appendChild($published);
-            $published->appendChild($document->createTextNode($entryTimestamp));
+            if ($entryTimestamp) {
+                $timestamp = gmdate(\DATE_ATOM, $entryTimestamp);
 
-            $updated = $document->createElement('updated');
-            $entry->appendChild($updated);
-            $updated->appendChild($document->createTextNode($entryTimestamp));
+                $published = $document->createElement('published');
+                $entry->appendChild($published);
+                $published->appendChild($document->createTextNode($timestamp));
+
+                $updated = $document->createElement('updated');
+                $entry->appendChild($updated);
+                $updated->appendChild($document->createTextNode($timestamp));
+            }
 
             $id = $document->createElement('id');
             $entry->appendChild($id);

From e6a84052f0ac122ed094a71f2263c1e9f04b7a70 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 8 May 2025 23:04:12 +0200
Subject: [PATCH 634/716] fix(reddit): handle absent search keywords, #4502
 (#4542)

---
 bridges/RedditBridge.php | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index 005ccade..398fcaf1 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -302,11 +302,10 @@ class RedditBridge extends BridgeAbstract
 
     public static function createUrl($search, $flareInput, $subreddit, bool $user, $section, $time, $queriedContext): string
     {
-        if ($search === '') {
-            $keywords = '';
-        } else {
-            $keywords = $search;
-            $keywords = str_replace([',', ' '], ' ', $keywords);
+        $keywords = '';
+
+        if ($search) {
+            $keywords = str_replace([',', ' '], ' ', $search);
             $keywords = $keywords . ' ';
         }
 

From 58e30f8b4b8f5d449fe5d48ff11446511e78fe54 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Thu, 8 May 2025 23:33:18 +0200
Subject: [PATCH 635/716] fix(furaffinity): date and tags, #4513 (#4543)

---
 bridges/FurAffinityBridge.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bridges/FurAffinityBridge.php b/bridges/FurAffinityBridge.php
index f7d830bb..291026a8 100644
--- a/bridges/FurAffinityBridge.php
+++ b/bridges/FurAffinityBridge.php
@@ -936,8 +936,7 @@ class FurAffinityBridge extends BridgeAbstract
             if ($this->getInput('full') === true) {
                 $submissionHTML = $this->getFASimpleHTMLDOM($submissionURL, $cache);
                 if (!$this->isHiddenSubmission($submissionHTML)) {
-                    $stats = $submissionHTML->find('.stats-container', 0);
-                    $popupDate = $stats->find('.popup_date', 0);
+                    $popupDate = $submissionHTML->find('section .popup_date', 0);
                     if ($popupDate) {
                         $item['timestamp'] = strtotime($popupDate->title);
                     }
@@ -947,9 +946,10 @@ class FurAffinityBridge extends BridgeAbstract
                         $item['enclosures'] = [$var->href];
                     }
 
-                    foreach ($stats->find('#keywords a') as $keyword) {
+                    foreach ($submissionHTML->find('.tags-row .tags a') as $keyword) {
                         $item['categories'][] = $keyword->plaintext;
                     }
+                    $item['categories'] = array_filter($item['categories']);
 
                     $previewSrc = $submissionHTML->find('#submissionImg', 0);
                     if ($previewSrc) {

From 9dc673a0382138e7175337405aba930052face02 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 9 May 2025 00:09:28 +0200
Subject: [PATCH 636/716] fix(github): PRs and issues (#4544)

---
 bridges/GithubIssueBridge.php | 36 ++++++++++++++++++++++++-----------
 1 file changed, 25 insertions(+), 11 deletions(-)

diff --git a/bridges/GithubIssueBridge.php b/bridges/GithubIssueBridge.php
index 0c3c0471..345d1148 100644
--- a/bridges/GithubIssueBridge.php
+++ b/bridges/GithubIssueBridge.php
@@ -200,11 +200,14 @@ class GithubIssueBridge extends BridgeAbstract
                 $this->items = $this->extractIssueComments($html);
                 break;
             case static::BRIDGE_OPTIONS[0]: // Project Issues
+                // PRs
                 $issues = $html->find('.js-active-navigation-container .js-navigation-item');
-                $issues = $html->find('.IssueRow-module__row--XmR1f');
-                foreach ($issues as $issue) {
-                    $info = $issue->find('.issue-item-module__authorCreatedLink--wFZvk', 0);
+                if (!$issues) {
+                    // Issues
+                    $issues = $html->find('.IssueRow-module__row--XmR1f');
+                }
 
+                foreach ($issues as $issue) {
                     preg_match('/\/([0-9]+)$/', $issue->find('a', 0)->href, $match);
                     $issueNbr = $match[1];
 
@@ -214,6 +217,7 @@ class GithubIssueBridge extends BridgeAbstract
                     if ($this->getInput('c')) {
                         $uri = static::URI . $this->getInput('u')
                          . '/' . $this->getInput('p') . '/' . static::URL_PATH . '/' . $issueNbr;
+
                         $issue = getSimpleHTMLDOMCached($uri, static::CACHE_TIMEOUT);
                         if ($issue) {
                             $this->items = array_merge(
@@ -226,15 +230,25 @@ class GithubIssueBridge extends BridgeAbstract
                     }
 
                     $item['author'] = $issue->find('a', 1)->plaintext;
-                    $item['timestamp'] = strtotime(
-                        $issue->find('relative-time', 0)->getAttribute('datetime')
-                    );
-                    $item['title'] = html_entity_decode(
-                        $issue->find('h3', 0)->plaintext,
-                        ENT_QUOTES,
-                        'UTF-8'
-                    );
 
+                    $time = $issue->find('relative-time', 0);
+                    $datetime = $time->getAttribute('datetime');
+                    if ($datetime) {
+                        $item['timestamp'] = strtotime($datetime);
+                    }
+
+                    $item['title'] = '';
+
+                    # Works for PRs
+                    $title = $issue->find('a.Link--primary', 0);
+                    if ($title) {
+                        $item['title'] = html_entity_decode($title->plaintext, ENT_QUOTES, 'UTF-8');
+                    }
+
+                    $title2 = $issue->find('h3 a', 0);
+                    if ($title2) {
+                        $item['title'] = html_entity_decode($title2->plaintext, ENT_QUOTES, 'UTF-8');
+                    }
                     //$comment_count = 0;
                     //if ($span = $issue->find('a[aria-label*="comment"] span', 0)) {
                     //    $comment_count = $span->plaintext;

From 67c5198cbb32f57ae40a5ab392a52a15cc0d5508 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 9 May 2025 00:15:48 +0200
Subject: [PATCH 637/716] chore(fdroid): remove dead bridge (#4545)

---
 bridges/FDroidBridge.php | 72 ----------------------------------------
 1 file changed, 72 deletions(-)
 delete mode 100644 bridges/FDroidBridge.php

diff --git a/bridges/FDroidBridge.php b/bridges/FDroidBridge.php
deleted file mode 100644
index fdf0262f..00000000
--- a/bridges/FDroidBridge.php
+++ /dev/null
@@ -1,72 +0,0 @@
-<?php
-
-class FDroidBridge extends BridgeAbstract
-{
-    const MAINTAINER = 'Mitsukarenai';
-    const NAME = 'F-Droid Bridge';
-    const URI = 'https://f-droid.org/';
-    const CACHE_TIMEOUT = 60 * 60 * 4; // 4 hours
-    const DESCRIPTION = 'Returns latest added/updated apps on the open-source Android apps repository F-Droid';
-
-    const PARAMETERS = [ [
-        'u' => [
-            'name' => 'Widget selection',
-            'type' => 'list',
-            'values' => [
-                'Latest added apps' => 'added',
-                'Latest updated apps' => 'updated'
-            ]
-        ]
-    ]];
-
-    public function getIcon()
-    {
-        return self::URI . 'assets/favicon.ico';
-    }
-
-    private function getTimestamp($url)
-    {
-        $curlOptions = [
-            CURLOPT_CUSTOMREQUEST => 'HEAD',
-            CURLOPT_NOBODY => true,
-        ];
-        $reponse = getContents($url, [], $curlOptions, true);
-        $lastModified = $reponse->getHeader('last-modified');
-        $timestamp = strtotime($lastModified ?? 'today');
-        return $timestamp;
-    }
-
-    public function collectData()
-    {
-        $url = self::URI;
-        $html = getSimpleHTMLDOM($url);
-
-        // targetting the corresponding widget based on user selection
-        // "updated" is the 5th widget on the page, "added" is the 6th
-
-        switch ($this->getInput('u')) {
-            case 'updated':
-                $html_widget = $html->find('div.sidebar-widget', 5);
-                break;
-            default:
-                $html_widget = $html->find('div.sidebar-widget', 6);
-                break;
-        }
-
-        // and now extracting app info from the selected widget (and yeah turns out icons are of heterogeneous sizes)
-
-        foreach ($html_widget->find('a') as $element) {
-            $item = [];
-            $item['uri'] = self::URI . $element->href;
-            $item['title'] = $element->find('h4', 0)->plaintext;
-            $item['icon'] = $element->find('img', 0)->src;
-            $item['timestamp'] = $this->getTimestamp($item['icon']);
-            $item['summary'] = $element->find('span.package-summary', 0)->plaintext;
-            $item['content'] = '
-					<a href="' . $item['uri'] . '">
-						<img alt="" style="max-height:128px" src="' . $item['icon'] . '">
-					</a><br>' . $item['summary'];
-            $this->items[] = $item;
-        }
-    }
-}

From 908937383b61f392670c87b03efaf27cb55effd5 Mon Sep 17 00:00:00 2001
From: Petr Prenghy <121161956+pprenghy@users.noreply.github.com>
Date: Fri, 9 May 2025 00:23:21 +0200
Subject: [PATCH 638/716] [ElektroARGOSBridge] add new bridge - News, events
 and promotions on ARGOS electro shop (#4523)

---
 bridges/ElektroARGOSBridge.php | 656 +++++++++++++++++++++++++++++++++
 1 file changed, 656 insertions(+)
 create mode 100644 bridges/ElektroARGOSBridge.php

diff --git a/bridges/ElektroARGOSBridge.php b/bridges/ElektroARGOSBridge.php
new file mode 100644
index 00000000..c4e692aa
--- /dev/null
+++ b/bridges/ElektroARGOSBridge.php
@@ -0,0 +1,656 @@
+<?php
+
+/**
+ *
+ * this code downloads the HTML page with product news from ARGOS website (https://www.i4wifi.cz), parses it, extracts key information
+ *  about each article (title, link, date, description, images), and formats it into a structured form,
+ *  likely for further processing, such as creating an RSS feed.
+ */
+
+class ElektroARGOSBridge extends BridgeAbstract
+{
+    const NAME = 'Elektro ARGOS';
+    const URI = 'https://www.argos.cz/';
+    const DESCRIPTION = 'News, events and promotions on ARGOS electro shop - www.argos.cz - Czech Republic';
+    const MAINTAINER = 'pprenghyorg';
+    const CACHE_TIMEOUT = 86400;
+
+    // Only Weekly offer and Promotional letter are supported
+    const PARAMETERS = [
+        'News and articles' => [],
+        'Events' => [],
+        'Topics and Promos' => []
+    ];
+
+    /**
+     * Fetches and processes data based on the selected context.
+     *
+     * This function retrieves the HTML content for the specified context's URI,
+     * resolves relative links within the content, and then delegates the data
+     * extraction to the appropriate method (currently only `collectNews` for the 'Articles' context).
+     */
+    public function collectData()
+    {
+        $html = getSimpleHTMLDOMCached($this->getURI(), self::CACHE_TIMEOUT);
+
+        defaultLinkTo($html, static::URI);
+
+        // Router
+        switch ($this->queriedContext) {
+            case 'News and articles':
+                $this->collectNews($html);
+                break;
+            case 'Events':
+                $this->collectEvents($html);
+                break;
+            case 'Topics and Promos':
+                $this->collectTopic($html);
+                break;
+        }
+    }
+
+    /**
+     * Returns the icon for the bridge.
+     *
+     * @return string The icon URL.
+     */
+    public function getURI()
+    {
+        $uri = static::URI;
+
+        // URI Router
+        switch ($this->queriedContext) {
+            case 'News and articles':
+                $uri .= 'akce/nabidka/';
+                break;
+            case 'Events':
+                $uri .= 'pobocka-praha-hostivar/akce/udalosti/';
+                break;
+            case 'Topics and Promos':
+                $uri .= 'pobocka-praha-hostivar/akce/temata/';
+                break;
+        }
+
+        return $uri;
+    }
+
+    /**
+     * Returns the keyword URL map for the bridge.
+     *
+     * @return string The Name.
+     */
+    public function getKeywordUrlMap()
+    {
+        // Get the keyword URL map from the class constant
+        $keywordUrlMap = static::KEYWORDURLMAP;
+
+        // returns the keyword URL map
+        return $keywordUrlMap;
+    }
+
+    /**
+     * Returns the name for the bridge.
+     *
+     * @return string The Name.
+     */
+    public function getName()
+    {
+        $name = static::NAME;
+
+        $name .= ($this->queriedContext) ? ' - ' . $this->queriedContext : '';
+
+        switch ($this->queriedContext) {
+            case 'News and articles':
+                break;
+            case 'Events':
+                break;
+            case 'Topics and Promos':
+                break;
+        }
+
+        return $name;
+    }
+
+    /**
+     * Parse most used date formats
+     *
+     * Basically strtotime doesn't convert dates correctly due to formats
+     * being hard to interpret. So we use the DateTime object, manually
+     * fixing dates and times (set to 00:00:00.000).
+     *
+     * We don't know the timezone, so just assume +00:00 (or whatever
+     * DateTime chooses)
+     */
+    private function fixDate($date)
+    {
+        $df = $this->parseDateTimeFromString($date);
+
+        return date_format($df, 'U');
+    }
+
+    /**
+     * Extracts the images from the article.
+     *
+     * @param object $article The article object.
+     * @return array An array of image URLs.
+     */
+    private function extractImages($article)
+    {
+        // Notice: We can have zero or more images (though it should mostly be 1)
+        $elements = $article->find('img');
+
+        $images = [];
+
+        foreach ($elements as $img) {
+            $images[] = $img->src;
+        }
+
+        return $images;
+    }
+
+    // region Weekly offer
+
+    /**
+     * Collects uri, timestamp, title, content and images in the product offers from the HTML and transforms to rss.
+     *
+     * @param object $html The HTML object.
+     * @return void
+     */
+    private function collectNews($html)
+    {
+        // Check if page contains articles and split by class
+        $articles = $html->find('.com-news-feature-prerex') or
+            returnServerError('No articles found! Layout might have changed!');
+
+        // Articles loop
+        foreach ($articles as $article) {
+            $item = [];
+
+            // Add URI
+            $item['uri'] = $this->extractNewsUri($article);
+//            echo $item['uri'] . '<BR>';
+            // Add title
+            $item['title'] = $this->extractNewsTitle($article);
+//            echo $item['title'] . '<BR>';
+            $item['enclosures'] = $this->extractImages($article);
+
+            // Add to rss query
+            $this->items[] = $item;
+        }
+    }
+
+    /**
+     * Collects uri, timestamp, title, content and images in the promotional letter from the HTML and transforms to rss.
+     *
+     * @param object $html The HTML object.
+     * @return void
+     */
+    private function collectEvents($html)
+    {
+        // Check if page contains articles and split by class
+        $articles = $html->find('.com-news-common-prerex') or
+            returnServerError('No articles found! Layout might have changed!');
+
+        // Articles loop
+        foreach ($articles as $article) {
+            $item = [];
+
+            // Add URI
+            $item['uri'] = $this->extractEventUri($article);
+            // Add title
+            $item['title'] = $this->extractEventTitle($article);
+            // Add content
+            $item['content'] = $this->extractEventDescription($article);
+            // Parse time
+            $newsDate = $this->extractDate($article);
+            // Remove prefix
+            $newsDate = str_replace('zveřejněno: ', '', $newsDate);
+            // Fix date
+            $item['timestamp'] = $this->fixDate($newsDate);
+            // Add images
+            $item['enclosures'] = $this->extractImages($article);
+
+            // Add to rss query
+            $this->items[] = $item;
+        }
+    }
+
+    /**
+     * Collects uri, timestamp, title, content and images in the promotional letter from the HTML and transforms to rss.
+     *
+     * @param object $html The HTML object.
+     * @return void
+     */
+    private function collectTopic($html)
+    {
+        // Check if page contains articles and split by class
+        $articles = $html->find('.com-news-common-prerex') or
+            returnServerError('No articles found! Layout might have changed!');
+
+        // Articles loop
+        foreach ($articles as $article) {
+            $item = [];
+
+            // Add URI
+            $item['uri'] = $this->extractEventUri($article);
+            // Add title
+            $item['title'] = $this->extractEventTitle($article);
+            // Add content
+            $item['content'] = $this->extractEventDescription($article);
+            // Parse time
+            $newsDate = $this->extractDate($article);
+            // Remove prefix
+            $newsDate = str_replace('zveřejněno: ', '', $newsDate);
+            // Fix date
+            $item['timestamp'] = $this->fixDate($newsDate);
+            // Add images
+            $item['enclosures'] = $this->extractImages($article);
+
+            // Add to rss query
+            $this->items[] = $item;
+        }
+    }
+
+    /**
+     * Extracts the URI of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The URI of the news article.
+     */
+    private function extractEventUri($article)
+    {
+        return $article->href;
+    }
+
+
+    /**
+     * Extracts the URI of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The URI of the news article.
+     */
+    private function extractNewsUri($article)
+    {
+        // Return URI of the article
+        $element = $article->find('a', 0) or
+            returnServerError('Anchor not found!');
+
+        return $element->href;
+    }
+
+    /**
+     * Extracts the URI of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The URI of the news article.
+     */
+    private function extractLetterUri($article)
+    {
+        // Return URI of the article
+        $element = $article->find('a.ws-btn', 0);
+
+        // Element empty check
+        if ($element == null) {
+            return '';
+        }
+
+        return $element->href;
+    }
+
+    /**
+     * Extracts the date of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The date of the news article.
+     */
+    private function extractDate($article)
+    {
+        // Check if date is set
+        $element = $article->find('div.com-news-common-prerex__date', 0) or
+            returnServerError('Date not found!');
+
+        return $element->plaintext;
+    }
+
+    /**
+     * Extracts the description of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The description of the news article.
+     */
+    private function extractNewsDescription($article)
+    {
+        // Extract description
+        $element = $article->find('ul.ws-product-information__piece-description', 0)->find('li', 0) or
+            returnServerError('Description not found!');
+
+        return $element->innertext;
+    }
+
+    /**
+     * Extracts the description of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The description of the news article.
+     */
+    private function extractNewsDescription1($article)
+    {
+        // Extract description
+        $element = $article->find('div.ws-product-price-validity', 0)->find('div', 0) or
+            returnServerError('Description not found!');
+
+        return $element->innertext;
+    }
+
+    /**
+     * Extracts the description of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The description of the news article.
+     */
+    private function extractNewsDescription2($article)
+    {
+        // Extract description
+        $element = $article->find('div.ws-product-price-validity', 0)->find('div', 1) or
+            returnServerError('Description not found!');
+
+        return $element->innertext;
+    }
+
+    /**
+     * Extracts the description of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The description of the news article.
+     */
+    private function extractNewsDescription3($article)
+    {
+        // Extract description
+        $element = $article->find('div.ws-product-badge-text', 0);
+
+        // Check if element is not null
+        // If it is null, return empty string
+        // If it is not null, return the inner text
+        // This is to avoid errors when the element is not found
+        // and to ensure that the function always returns a string
+        if ($element != null) {
+            return $element->innertext;
+        } else {
+            return '';
+        }
+    }
+
+    /**
+     * Extracts the description of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The description of the news article.
+     */
+    private function extractNewsDescription4($article)
+    {
+        // Extract description
+        $element = $article->find('div.ws-product-price-type__value', 0);
+
+        return $element->innertext;
+    }
+
+    /**
+     * Extracts the description of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The description of the news article.
+     */
+    private function extractNewsDescription5($article)
+    {
+        // Extract description
+        $element = $article->find('div.ws-product-price-type__label', 0);
+
+        return $element->innertext;
+    }
+
+    /**
+     * Extracts the description of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The description of the news article.
+     */
+    private function extractNewsDescription6($article)
+    {
+        // Extract description
+        $element = $article->find('div.ws-product-price', 0)->find('div.ws-product-price-type', 1);
+
+        // Element empty check
+        if ($element == null) {
+            return '';
+        }
+
+        // Not null, so we can safely access the element
+        $element = $element->find('div.ws-product-price-type__value', 0);
+
+        return $element->innertext;
+    }
+
+    /**
+     * Extracts the description of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The description of the news article.
+     */
+    private function extractEventDescription($article)
+    {
+        // Extract description
+        $element = $article->find('.com-news-common-prerex__text', 0);
+
+        return $element->innertext;
+    }
+
+    /**
+     * Extracts the title of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The title of the news article.
+     */
+    private function extractNewsTitle($article)
+    {
+        // Extract title
+        $element = $article->find('img', 0) or
+            returnServerError('Title not found!');
+
+        return $element->alt;
+    }
+
+    /**
+     * Extracts the title of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The title of the news article.
+     */
+    private function extractEventTitle($article)
+    {
+        // Extract title
+        $element = $article->find('div.com-news-common-prerex__right-box', 0)->find('h3', 0)
+            or returnServerError('Title not found!');
+
+        return $element->plaintext;
+    }
+
+    /**
+     * Extracts the description of the letter article.
+     *
+     * @param object $article The article object.
+     * @return string The description of the news article.
+     */
+    private function extractLetterDescription($article)
+    {
+        // Extract description
+        $element = $article->find('a', 0);
+
+        return $element;
+    }
+
+    /**
+     * It attempts to recognize the date/time format in a string and create a DateTime object.
+     *
+     * It goes through the list of defined formats and tries to apply them to the input string.
+     * Returns the first successfully parsed DateTime object that matches the entire string.
+     *
+     * @param string $dateString A string potentially containing a date and/or time.
+     * @return DateTime|null A DateTime object if successfully recognized and parsed, otherwise null.
+     */
+    private function parseDateTimeFromString(string $dateString): ?DateTime
+    {
+        // List of common formats - YOU CAN AND SHOULD EXPAND IT according to expected inputs!
+        // Order may matter if the formats are ambiguous.
+        // It is recommended to give more specific formats (with time, full year) before more general ones.
+        $possibleFormats = [
+            // Czech formats (day.month.year)
+            'd.m.Y H:i:s',  // 10.04.2025 10:57:47
+            'j.n.Y H:i:s',  // 10.4.2025 10:57:47
+            'd. m. Y H:i:s',  // 10. 04. 2025 10:57:47
+            'j. n. Y H:i:s',  // 10. 4. 2025 10:57:47
+            'd.m.Y H:i',  // 10.04.2025 10:57
+            'j.n.Y H:i',  // 10.4.2025 10:57
+            'd. m. Y H:i',  // 10. 04. 2025 10:57
+            'j. n. Y H:i',  // 10. 4. 2025 10:57
+            'd.m.Y',  // 10.04.2025
+            'j.n.Y',  // 10.4.2025
+            'd. m. Y',  // 10. 04. 2025
+            'j. n. Y',  // 10. 4. 2025
+            // ISO 8601 and international formats (year-month-day)
+            'Y-m-d H:i:s',  // 2025-04-10 10:57:47
+            'Y-m-d H:i',  // 2025-04-10 10:57
+            'Y-m-d',  // 2025-04-10
+            'YmdHis',  // 20250410105747
+            'Ymd',  // 20250410
+            // American formats (month/day/year) - beware of ambiguity!
+            'm/d/Y H:i:s',  // 04/10/2025 10:57:47
+            'n/j/Y H:i:s',  // 4/10/2025 10:57:47
+            'm/d/Y H:i',  // 04/10/2025 10:57
+            'n/j/Y H:i',  // 4/10/2025 10:57
+            'm/d/Y',  // 04/10/2025
+            'n/j/Y',  // 4/10/2025
+            // Standard formats (including time zone)
+            DateTime::ATOM,  // example. 2025-04-10T10:57:47+02:00
+            DateTime::RFC3339,  // example. 2025-04-10T10:57:47+02:00
+            DateTime::RFC3339_EXTENDED,  // example. 2025-04-10T10:57:47.123+02:00
+            DateTime::RFC2822,  // example. Thu, 10 Apr 2025 10:57:47 +0200
+            DateTime::ISO8601,  // example. 2025-04-10T105747+0200
+            'Y-m-d\TH:i:sP',  // ISO 8601 s 'T' oddělovačem
+            'Y-m-d\TH:i:s.uP',  // ISO 8601 s mikrosekundami
+            // You can add more formats as needed...
+            // e.g. 'd-M-Y' (10-Apr-2025) - requires English locale
+            // e.g. 'j. F Y' (10. abren 2025) - requires Czech locale
+        ];
+
+        // Set locale for parsing month/day names (if using F, M, l, D)
+        // E.g. setlocale(LC_TIME, 'cs_CZ.UTF-8'); or 'en_US.UTF-8');
+
+        foreach ($possibleFormats as $format) {
+            // We will try to create a DateTime object from the given format
+            $dateTime = DateTime::createFromFormat($format, $dateString);
+
+            // We check that the parsing was successful AND ALSO
+            // that there were no errors or warnings during the parsing.
+            // This is important to ensure that the format matches the ENTIRE string.
+            if ($dateTime !== false) {
+                $errors = DateTime::getLastErrors();
+                if (!($errors)) {
+                    // Success! We found a valid format for the entire string.
+                    return $dateTime;
+                }
+            }
+        }
+
+        // If no format matches or parsing failed
+        return null;
+    }
+
+    /**
+     * Finds values from an associative array whose keys are substrings of a given text.
+     *
+     * The function iterates through the `$map` associative array. For each key,
+     * it checks if that key exists as a substring within the input `$text`.
+     * If found, the corresponding value from the map is added to the result array.
+     * The search is case-sensitive and treats special characters literally.
+     *
+     * @param string $text The input text string to search within.
+     * @param array $map An associative array (key => value). Keys from this array will be searched for in `$text`.
+     * @return array An array of values whose corresponding keys were found as substrings in `$text`. Returns an empty array if no keys are found.
+     */
+    private function findValuesByKeySubstring(string $text, array $map): array
+    {
+        $foundValues = [];  // Initialize array for found values
+
+        // Iterate through each key => value pair in the map
+        foreach ($map as $key => $value) {
+            // Use strpos(), which finds the position of the first occurrence of a substring.
+            // Returns the position (including 0) or `false` if the substring is not found.
+            // We use `!== false` to correctly handle the case where the key starts at position 0.
+            // Cast key to string for robustness (though array keys are usually strings or ints).
+            // `strpos` treats special characters in the key and text literally.
+
+            //          echo "Key: $key, Text: $text<BR>\n";
+            if (strpos($text, $key) !== false) {
+                // If the key was found in the text, add its corresponding value to the result array
+                $foundValues[] = $value;
+            }
+        }
+
+        // Return the array of found values
+        return $foundValues;
+    }
+
+    /**
+     * Removes Czech diacritics from a given string.
+     *
+     * This function replaces Czech characters with their ASCII equivalents.
+     * For example, 'á' becomes 'a', 'č' becomes 'c', etc.
+     *
+     * @param string $text The input string with Czech diacritics.
+     * @return string The string with Czech diacritics removed.
+     */
+    private function removeCzechDiacritics(string $text): string
+    {
+        $czech = [
+            'á', 'č', 'ď', 'é', 'ě', 'í', 'ň', 'ó', 'ř', 'š', 'ť', 'ú', 'ů', 'ý', 'ž',
+            'Á', 'Č', 'Ď', 'É', 'Ě', 'Í', 'Ň', 'Ó', 'Ř', 'Š', 'Ť', 'Ú', 'Ů', 'Ý', 'Ž'
+        ];
+        $ascii = [
+            'a', 'c', 'd', 'e', 'e', 'i', 'n', 'o', 'r', 's', 't', 'u', 'u', 'y', 'z',
+            'A', 'C', 'D', 'E', 'E', 'I', 'N', 'O', 'R', 'S', 'T', 'U', 'U', 'Y', 'Z'
+        ];
+
+        return str_replace($czech, $ascii, $text);
+    }
+
+    // endregion
+
+    /**
+     * Creates title by clean URI by removing unwanted characters and leaves last part of the URI.
+     *
+     * @param string $text The input string with Czech diacritics.
+     * @return string The string with Czech diacritics removed.
+    */
+    private function formatTitleFromURI(string $uri): string
+    {
+        // get last part of the URI
+        $title = basename($uri);
+
+        // Pattern: /[^\p{L}\p{N}]+/u
+        // [^...] - Match any character NOT in the set
+        // \p{L}  - Any Unicode letter (including 'é', 'ü', 'ñ', etc.)
+        // \p{N}  - Any Unicode number (0-9 and other numeric characters)
+        // +      - Match one or more occurrences of the preceding pattern consecutively
+        // /u     - Unicode modifier, essential for \p{} constructs
+        $pattern = '/[^\p{L}\p{N}]+/u';
+        $replacement = ' '; // Replace with a single space
+
+        // lets replace
+        $title = preg_replace($pattern, $replacement, $title);
+
+        // first letter to uppercase
+        $title = ucfirst($title);
+
+        return trim((string)$title);
+    }
+}

From 66f1d449a7d1c268dad533b40ad2ec1a5e397b49 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 9 May 2025 02:15:28 +0200
Subject: [PATCH 639/716] test (#4546)

---
 tests/Formats/samples/expectedAtomFormat/feed.emptyItems.xml | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/tests/Formats/samples/expectedAtomFormat/feed.emptyItems.xml b/tests/Formats/samples/expectedAtomFormat/feed.emptyItems.xml
index d7cb461a..b8373497 100644
--- a/tests/Formats/samples/expectedAtomFormat/feed.emptyItems.xml
+++ b/tests/Formats/samples/expectedAtomFormat/feed.emptyItems.xml
@@ -12,15 +12,11 @@
 
 	<entry>
 		<title type="html">Sample Item #1</title>
-		<published>2000-01-01T12:00:00+00:00</published>
-		<updated>2000-01-01T12:00:00+00:00</updated>
 		<id>urn:sha1:29f59918d266c56a935da13e4122b524298e5a39</id>
 		<content type="html"> </content>
 	</entry>
 	<entry>
 		<title type="html">Sample Item #2</title>
-		<published>2000-01-01T12:00:00+00:00</published>
-		<updated>2000-01-01T12:00:00+00:00</updated>
 		<id>urn:sha1:edf358cad1a7ae255d6bc97640dd9d27738f1b7b</id>
 		<content type="html"> </content>
 	</entry>

From 83edf5a48bd7ded62dff7ddbdbe806e3b40ee915 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 9 May 2025 03:26:10 +0200
Subject: [PATCH 640/716] fix(CssSelector): html entity decode bug, fix #4484
 (#4547)

---
 bridges/CssSelectorBridge.php | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/bridges/CssSelectorBridge.php b/bridges/CssSelectorBridge.php
index ac3261bf..d82dbdf2 100644
--- a/bridges/CssSelectorBridge.php
+++ b/bridges/CssSelectorBridge.php
@@ -232,8 +232,10 @@ class CssSelectorBridge extends BridgeAbstract
                     continue;
                 }
             }
-            $item['uri'] = $link->href;
-            $item['title'] = $link->plaintext;
+
+            $item['uri'] = html_entity_decode($link->href);
+            $item['title'] = html_entity_decode($link->plaintext);
+
             if (isset($item['content'])) {
                 $item['content'] = convertLazyLoading($item['content']);
                 $item['content'] = defaultLinkTo($item['content'], $item['uri']);

From 9fb4a5dd720b94630e683bbbab2517efab37b825 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E2=88=9A=28noham=29=C2=B2?=
 <100566912+NohamR@users.noreply.github.com>
Date: Fri, 9 May 2025 03:33:56 +0200
Subject: [PATCH 641/716] Apple App Store bridge fix (#4516)

* Apple App Store bridge fix

* Fixe AppleAppStore + lint

* fix endpoint
---
 bridges/AppleAppStoreBridge.php | 251 ++++++++++++++++++++------------
 1 file changed, 157 insertions(+), 94 deletions(-)

diff --git a/bridges/AppleAppStoreBridge.php b/bridges/AppleAppStoreBridge.php
index a5fab59b..d6872a11 100644
--- a/bridges/AppleAppStoreBridge.php
+++ b/bridges/AppleAppStoreBridge.php
@@ -52,120 +52,183 @@ class AppleAppStoreBridge extends BridgeAbstract
             ],
             'defaultValue'  => 'US',
         ],
+        'debug' => [
+            'name' => 'Debug Mode',
+            'type' => 'checkbox',
+            'defaultValue' => false
+        ]
     ]];
 
     const PLATFORM_MAPPING = [
-        'iphone'    => 'ios',
-        'ipad'  => 'ios',
+        'iphone' => 'ios',
+        'ipad' => 'ios',
+        'mac' => 'osx'
     ];
 
-    private function makeHtmlUrl($id, $country)
+    private $name;
+
+    private function makeHtmlUrl()
     {
-        return 'https://apps.apple.com/' . $country . '/app/id' . $id;
+        $id = $this->getInput('id');
+        $country = $this->getInput('country');
+        return sprintf('https://apps.apple.com/%s/app/id%s', $country, $id);
     }
 
-    private function makeJsonUrl($id, $platform, $country)
-    {
-        return "https://amp-api.apps.apple.com/v1/catalog/$country/apps/$id?platform=$platform&extend=versionHistory";
-    }
-
-    public function getName()
-    {
-        if (isset($this->name)) {
-            return $this->name . ' - AppStore Updates';
-        }
-
-        return parent::getName();
-    }
-
-    /**
-     * In case of some platforms, the data is present in the initial response
-     */
-    private function getDataFromShoebox($id, $platform, $country)
-    {
-        $uri = $this->makeHtmlUrl($id, $country);
-        $html = getSimpleHTMLDOMCached($uri, 3600);
-        $script = $html->find('script[id="shoebox-ember-data-store"]', 0);
-
-        $json = json_decode($script->innertext, true);
-        return $json['data'];
-    }
-
-    private function getJWTToken($id, $platform, $country)
-    {
-        $uri = $this->makeHtmlUrl($id, $country);
-
-        $html = getSimpleHTMLDOMCached($uri, 3600);
-
-        $meta = $html->find('meta[name="web-experience-app/config/environment"]', 0);
-
-        $json = urldecode($meta->content);
-
-        $json = json_decode($json);
-
-        return $json->MEDIA_API->token;
-    }
-
-    private function getAppData($id, $platform, $country, $token)
-    {
-        $uri = $this->makeJsonUrl($id, $platform, $country);
-
-        $headers = [
-            "Authorization: Bearer $token",
-            'Origin: https://apps.apple.com',
-        ];
-
-        $json = json_decode(getContents($uri, $headers), true);
-
-        return $json['data'][0];
-    }
-
-    /**
-     * Parses the version history from the data received
-     * @return array list of versions with details on each element
-     */
-    private function getVersionHistory($data, $platform)
-    {
-        switch ($platform) {
-            case 'mac':
-                return $data['relationships']['platforms']['data'][0]['attributes']['versionHistory'];
-            default:
-                $os = self::PLATFORM_MAPPING[$platform];
-                return $data['attributes']['platformAttributes'][$os]['versionHistory'];
-        }
-    }
-
-    public function collectData()
+    private function makeJsonUrl()
     {
         $id = $this->getInput('id');
         $country = $this->getInput('country');
         $platform = $this->getInput('p');
 
-        switch ($platform) {
-            case 'mac':
-                $data = $this->getDataFromShoebox($id, $platform, $country);
-                break;
+        $platform_param = ($platform === 'mac') ? 'mac' : $platform;
 
-            default:
-                $token = $this->getJWTToken($id, $platform, $country);
-                $data = $this->getAppData($id, $platform, $country, $token);
+        return sprintf(
+            'https://amp-api-edge.apps.apple.com/v1/catalog/%s/apps/%s?platform=%s&extend=versionHistory',
+            $country,
+            $id,
+            $platform_param
+        );
+    }
+
+    public function getName()
+    {
+        if (isset($this->name)) {
+            return sprintf('%s - AppStore Updates', $this->name);
         }
 
-        $versionHistory = $this->getVersionHistory($data, $platform);
-        $name = $this->name = $data['attributes']['name'];
-        $author = $data['attributes']['artistName'];
+        return parent::getName();
+    }
+
+    private function debugLog($message)
+    {
+        if ($this->getInput('debug')) {
+            $this->logger->info(sprintf('[AppleAppStoreBridge] %s', $message));
+        }
+    }
+
+    private function getHtml()
+    {
+        $url = $this->makeHtmlUrl();
+        $this->debugLog(sprintf('Fetching HTML from: %s', $url));
+
+        return getSimpleHTMLDOM($url);
+    }
+
+    private function getJWTToken()
+    {
+        $html = $this->getHtml();
+        $meta = $html->find('meta[name="web-experience-app/config/environment"]', 0);
+
+        if (!$meta || !isset($meta->content)) {
+            throw new \Exception('JWT token not found in page content');
+        }
+
+        $decoded_content = urldecode($meta->content);
+        $this->debugLog('Found meta tag content');
+
+        try {
+            $decoded_json = Json::decode($decoded_content);
+        } catch (\Exception $e) {
+            throw new \Exception(sprintf('Failed to parse JSON from meta tag: %s', $e->getMessage()));
+        }
+
+        if (!isset($decoded_json['MEDIA_API']['token'])) {
+            throw new \Exception('Token field not found in JSON structure');
+        }
+
+        $token = $decoded_json['MEDIA_API']['token'];
+        $this->debugLog('Successfully extracted JWT token');
+        return $token;
+    }
+
+    private function getAppData()
+    {
+        $token = $this->getJWTToken();
+
+        $url = $this->makeJsonUrl();
+        $this->debugLog(sprintf('Fetching data from API: %s', $url));
+
+        $headers = [
+            'Authorization: Bearer ' . $token,
+            'Origin: https://apps.apple.com',
+            'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+        ];
+
+        $content = getContents($url, $headers);
+
+        try {
+            $json = Json::decode($content);
+        } catch (\Exception $e) {
+            throw new \Exception(sprintf('Failed to parse API response: %s', $e->getMessage()));
+        }
+
+        if (!isset($json['data']) || empty($json['data'])) {
+            throw new \Exception('No app data found in API response');
+        }
+
+        $this->debugLog('Successfully retrieved app data from API');
+        return $json['data'][0];
+    }
+
+    private function extractAppDetails($data)
+    {
+        if (isset($data['attributes'])) {
+            $this->name = $data['attributes']['name'] ?? null;
+            $author = $data['attributes']['artistName'] ?? null;
+            $this->debugLog(sprintf('Found app details in attributes: %s by %s', $this->name, $author));
+            return [$this->name, $author];
+        }
+
+        // Fallback to default values if not found
+        $this->name = sprintf('App %s', $this->getInput('id'));
+        $this->debugLog(sprintf('App details not found, using default: %s', $this->name));
+        return [$this->name, 'Unknown Developer'];
+    }
+
+    private function getVersionHistory($data)
+    {
+        $platform = $this->getInput('p');
+        $this->debugLog(sprintf('Extracting version history for platform: %s', $platform));
+
+        // Get the mapped platform key (ios for iPhone/iPad, osx for Mac)
+        $platform_key = self::PLATFORM_MAPPING[$platform] ?? $platform;
+
+        $version_history = $data['attributes']['platformAttributes'][$platform_key]['versionHistory'] ?? [];
+
+        if (empty($version_history)) {
+            $this->debugLog(sprintf('No version history found for %s', $platform));
+        }
+
+        return $version_history;
+    }
+
+    public function collectData()
+    {
+        $this->debugLog(sprintf('Getting data for %s app', $this->getInput('p')));
+        $data = $this->getAppData();
+
+        // Get app name and author using array destructuring
+        [$name, $author] = $this->extractAppDetails($data);
+
+        // Get version history
+        $version_history = $this->getVersionHistory($data);
+        $this->debugLog(sprintf('Found %d versions for %s', count($version_history), $name));
+
+        foreach ($version_history as $entry) {
+            $version = $entry['versionDisplay'] ?? 'Unknown Version';
+            $release_notes = $entry['releaseNotes'] ?? 'No release notes available';
+            $release_date = $entry['releaseDate'] ?? 'Unknown Date';
 
-        foreach ($versionHistory as $row) {
             $item = [];
-
-            $item['content'] = nl2br($row['releaseNotes']);
-            $item['title'] = $name . ' - ' . $row['versionDisplay'];
-            $item['timestamp'] = $row['releaseDate'];
+            $item['title'] = sprintf('%s - %s', $name, $version);
+            $item['content'] = nl2br($release_notes) ?: 'No release notes available';
+            $item['timestamp'] = $release_date;
             $item['author'] = $author;
-
-            $item['uri'] = $this->makeHtmlUrl($id, $country);
+            $item['uri'] = $this->makeHtmlUrl();
 
             $this->items[] = $item;
         }
+
+        $this->debugLog(sprintf('Successfully collected %d items', count($this->items)));
     }
-}
+}
\ No newline at end of file

From 648fcc38b5d6668cc7156e1880a4f3f725f16a51 Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Fri, 9 May 2025 07:58:31 +0530
Subject: [PATCH 642/716] [LinuxBlogBridge] add bridge (#4528)

* [LinuxBlogBridge] add bridge

* refactor

* Update LinuxBlogBridge.php
---
 bridges/LinuxBlogBridge.php | 64 +++++++++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 bridges/LinuxBlogBridge.php

diff --git a/bridges/LinuxBlogBridge.php b/bridges/LinuxBlogBridge.php
new file mode 100644
index 00000000..129ef31b
--- /dev/null
+++ b/bridges/LinuxBlogBridge.php
@@ -0,0 +1,64 @@
+<?php
+
+class LinuxBlogBridge extends BridgeAbstract
+{
+    const NAME = 'LinuxBlog.in';
+    const URI = 'https://linuxblog.io';
+    const DESCRIPTION = 'Retrieve recent articles';
+    const MAINTAINER = 'tillcash';
+    const CACHE_TIMEOUT = 60 * 60 * 6; // 6 hours
+    const MAX_ARTICLES = 5;
+
+    public function collectData()
+    {
+        $count = 0;
+        $dom = getSimpleHTMLDOM(self::URI);
+        $articles = $dom->find('ul.display-posts-listing li.listing-item');
+
+        if (!$articles) {
+            returnServerError('Failed to retrieve articles');
+        }
+
+        foreach ($articles as $article) {
+            if ($count >= self::MAX_ARTICLES) {
+                break;
+            }
+
+            $element = $article->find('a.title', 0);
+
+            if (!$element || empty($element->plaintext) || empty($element->href)) {
+                continue;
+            }
+
+            $timestamp = null;
+            $url = $element->href;
+            $date = $article->find('span.date', 0);
+
+            if ($date && $date->plaintext) {
+                $timestamp = strtotime($date->plaintext . ' 00:00:00 GMT');
+            }
+
+            $this->items[] = [
+                'content'    => $this->constructContent($url),
+                'timestamp'  => $timestamp,
+                'title'      => trim($element->plaintext),
+                'uid'        => $url,
+                'uri'        => $url,
+            ];
+
+            $count++;
+        }
+    }
+
+    private function constructContent($url)
+    {
+        $dom = getSimpleHTMLDOMCached($url);
+        $article = $dom->find('section.entry.fix', 0);
+
+        if (!$article) {
+            return 'Content Not Found';
+        }
+
+        return $article->innertext;
+    }
+}

From 6342b8387e2e942f7b7b53e8e37056b8df4d73bf Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Fri, 9 May 2025 04:33:18 +0200
Subject: [PATCH 643/716] [InstagramBridge] Use fallback when User ID can not
 be found (#4531)

- In case the userId can not be found, use the Fallback method

- Fallback method move to it's own function
---
 bridges/InstagramBridge.php | 68 ++++++++++++++++++++++---------------
 1 file changed, 40 insertions(+), 28 deletions(-)

diff --git a/bridges/InstagramBridge.php b/bridges/InstagramBridge.php
index d16b925c..58e56c59 100644
--- a/bridges/InstagramBridge.php
+++ b/bridges/InstagramBridge.php
@@ -108,15 +108,13 @@ class InstagramBridge extends BridgeAbstract
 
         if (!$pk) {
             $data = $this->getContents(self::URI . 'web/search/topsearch/?query=' . $username);
-            foreach (json_decode($data)->users as $user) {
-                if (strtolower($user->user->username) === strtolower($username)) {
-                    $pk = $user->user->pk;
+            if (!$data) {
+                foreach (json_decode($data)->users as $user) {
+                    if (strtolower($user->user->username) === strtolower($username)) {
+                        $pk = $user->user->pk;
+                    }
                 }
             }
-            if (!$pk) {
-                returnServerError('Unable to find username in search result.');
-            }
-            $this->cache->set($cacheKey, $pk);
         }
         return $pk;
     }
@@ -284,33 +282,22 @@ class InstagramBridge extends BridgeAbstract
         if (!is_null($this->getInput('u'))) {
             try {
                 $userId = $this->getInstagramUserId($this->getInput('u'));
-                $data = $this->getContents(self::URI .
+
+                // If the Userid is not null, try to load the data from the graphql
+                if (!$userId) {
+                    $data = $this->getContents(self::URI .
                                 'graphql/query/?query_hash=' .
                                  self::USER_QUERY_HASH .
                                  '&variables={"id"%3A"' .
                                 $userId .
                                 '"%2C"first"%3A10}');
+                } else {
+                    // In case we did not get the UserId then we must go back to the fallback mode
+                    $data = $this->getInstagramJSONFallback();
+                }
             } catch (HttpException $e) {
-                // If loading the data directly failed, we fall back to the "/embed" data loading
-                // We are in the fallback mode : set a booolean to handle this specific case while collecting the content
-                $this->fallbackMode = true;
-                // Get the HTML code of the profile embed page, and extract the JSON of it
-                $username = $this->getInput('u');
-                // Load the content using the integrated function to use helping headers
-                $htmlString = $this->getContents(self::URI . $username . '/embed/');
-                // Load the String as an SimpleHTMLDom Object
-                $html = new simple_html_dom();
-                $html->load($htmlString);
-                // Find the <script> tag containing the JSON content
-                $jsCode = $html->find('body', 0)->find('script', 3)->innertext;
-
-                // Extract the content needed by our bridge of the whole Javascript content
-                $regex = '#"contextJSON":"(.*)"}\]\],\["NavigationMetrics"#m';
-                preg_match($regex, $jsCode, $matches);
-                $jsVariable = $matches[1];
-                $data = stripcslashes($jsVariable);
-                // stripcslashes remove Javascript unicode escaping : add it back to the string so json_decode can handle it
-                $data = preg_replace('/(?<!\\\\)u[0-9A-Fa-f]{4}/', '\\\\$0', $data);
+                // Even if the UserId is not nul, the graphql request could go wrong, and then we should try to use the fallback mode
+                $data = $this->getInstagramJSONFallback();
             }
             return json_decode($data);
         } elseif (!is_null($this->getInput('h'))) {
@@ -334,6 +321,31 @@ class InstagramBridge extends BridgeAbstract
         }
     }
 
+    protected function getInstagramJSONFallback()
+    {
+        // If loading the data directly failed, we fall back to the "/embed" data loading
+        // We are in the fallback mode : set a booolean to handle this specific case while collecting the content
+        $this->fallbackMode = true;
+        // Get the HTML code of the profile embed page, and extract the JSON of it
+        $username = $this->getInput('u');
+        // Load the content using the integrated function to use helping headers
+        $htmlString = $this->getContents(self::URI . $username . '/embed/');
+        // Load the String as an SimpleHTMLDom Object
+        $html = new simple_html_dom();
+        $html->load($htmlString);
+        // Find the <script> tag containing the JSON content
+        $jsCode = $html->find('body', 0)->find('script', 3)->innertext;
+
+        // Extract the content needed by our bridge of the whole Javascript content
+        $regex = '#"contextJSON":"(.*)"}\]\],\["NavigationMetrics"#m';
+        preg_match($regex, $jsCode, $matches);
+        $jsVariable = $matches[1];
+        $data = stripcslashes($jsVariable);
+        // stripcslashes remove Javascript unicode escaping : add it back to the string so json_decode can handle it
+        $data = preg_replace('/(?<!\\\\)u[0-9A-Fa-f]{4}/', '\\\\$0', $data);
+        return $data;
+    }
+
     public function getName()
     {
         if (!is_null($this->getInput('u'))) {

From 1cb9e9169798242351d8a5aba874126cee2b62e9 Mon Sep 17 00:00:00 2001
From: Jonathan Kay <git@jonathankay.com>
Date: Thu, 8 May 2025 22:35:59 -0400
Subject: [PATCH 644/716] [GoComicsBridge] Update fix for latest layout changes
 (#4539)

---
 bridges/GoComicsBridge.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bridges/GoComicsBridge.php b/bridges/GoComicsBridge.php
index fe36d851..968c2c4d 100644
--- a/bridges/GoComicsBridge.php
+++ b/bridges/GoComicsBridge.php
@@ -35,7 +35,7 @@ class GoComicsBridge extends BridgeAbstract
         for ($i = 0; $i < $this->getInput('limit'); $i++) {
             $html = getSimpleHTMLDOM($link);
             // get json data from the first page
-            $json = $html->find('div.ComicViewer_comicViewer__comic__oftX6 script[type="application/ld+json"]', 0)->innertext;
+            $json = $html->find('div[class^="ShowComicViewer_showComicViewer__comic__"] script[type="application/ld+json"]', 0)->innertext;
             $data = json_decode($json, false);
 
             $item = [];
@@ -60,7 +60,7 @@ class GoComicsBridge extends BridgeAbstract
             $item['timestamp'] = DateTime::createFromFormat('F j, Y', $date)->setTime(0, 0, 0)->getTimestamp();
             $item['content'] = '<img src="' . $imagelink . '" />';
 
-            $link = rtrim(self::URI, '/') . $html->find('.Controls_controls__button_previous__P4LhX', 0)->href;
+            $link = rtrim(self::URI, '/') . $html->find('a[class*="ComicNavigation_controls__button_previous__"]', 0)->href;
             $this->items[] = $item;
         }
     }

From 083ba1e4f704d2a970a6e5fe979566fcf8d29e98 Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Fri, 9 May 2025 04:36:22 +0200
Subject: [PATCH 645/716] [FinanzflussBridge] fix for images not displayed
 (#4538)

---
 bridges/FinanzflussBridge.php | 12 +-----------
 1 file changed, 1 insertion(+), 11 deletions(-)

diff --git a/bridges/FinanzflussBridge.php b/bridges/FinanzflussBridge.php
index f255fb59..b0f5cc13 100644
--- a/bridges/FinanzflussBridge.php
+++ b/bridges/FinanzflussBridge.php
@@ -22,19 +22,9 @@ class FinanzflussBridge extends BridgeAbstract
             $domarticle = getSimpleHTMLDOM($url);
             $content = $domarticle->find('div.content', 0);
 
-            //get header-image and set absolute src
+            //get header-image
             $headerimage = $domarticle->find('div.article-header-image', 0);
             $headerimageimg = $headerimage->find('img[src]', 0);
-            $src = $headerimageimg->src;
-            $headerimageimg->src = $baseurl . $src;
-            $headerimageimg->srcset = $baseurl . $src;
-
-            //set absolute src for all img
-            foreach ($content->find('img[src]') as $img) {
-                $src = $img->src;
-                $img->src = $baseurl . $src;
-                $img->srcset = $baseurl . $src;
-            }
 
             //remove unwanted stuff
             foreach ($content->find('div.newsletter-signup') as $element) {

From 72e1998e1686772136eb8b4fd5cdf9b676b4a9cd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Dawid=20Wr=C3=B3bel?= <me@dawidwrobel.com>
Date: Fri, 9 May 2025 05:06:23 +0200
Subject: [PATCH 646/716] [AllegroBridge]: fix, use JSON instead of HTML
 (#4536)

Cookie is now obligatory, otherwise 403 is returned
---
 bridges/AllegroBridge.php | 111 +++++++++++++-------------------------
 1 file changed, 37 insertions(+), 74 deletions(-)

diff --git a/bridges/AllegroBridge.php b/bridges/AllegroBridge.php
index 55e9f116..3509afa1 100644
--- a/bridges/AllegroBridge.php
+++ b/bridges/AllegroBridge.php
@@ -15,8 +15,8 @@ class AllegroBridge extends BridgeAbstract
         ],
         'cookie' => [
             'name' => 'The complete cookie value',
-            'title' => 'Paste the value of the cookie value from your browser if you want to prevent Allegro imposing rate limits',
-            'required' => false,
+            'title' => 'Paste the cookie value from your browser, otherwise 403 gets returned',
+            'required' => true,
         ],
         'includeSponsoredOffers' => [
             'type' => 'checkbox',
@@ -65,93 +65,56 @@ class AllegroBridge extends BridgeAbstract
         $url = preg_replace('/([?&])order=[^&]+(&|$)/', '$1', $this->getInput('url'));
         $url .= (parse_url($url, PHP_URL_QUERY) ? '&' : '?') . 'order=n';
 
-        $opts = [];
+        $html = getContents($url, [], [CURLOPT_COOKIE => $this->getInput('cookie')]);
 
-        // If a cookie is provided
-        if ($cookie = $this->getInput('cookie')) {
-            $opts[CURLOPT_COOKIE] = $cookie;
+        $storeData = null;
+        if (preg_match('/<script[^>]*>\s*(\{\s*?"__listing_StoreState".*\})\s*<\/script>/i', $html, $match)) {
+            $data = json_decode($match[1], true);
+            $storeData = $data['__listing_StoreState'] ?? null;
         }
 
-        $html = getSimpleHTMLDOM($url, [], $opts);
+        foreach ($storeData['items']['elements'] as $elements) {
+            if (!array_key_exists('offerId', $elements)) {
+                continue;
+            }
+            if (!$this->getInput('includeSponsoredOffers') && $elements['isSponsored']) {
+                continue;
+            }
+            if (!$this->getInput('includePromotedOffers') && $elements['promoted']) {
+                continue;
+            }
 
-        # if no results found
-        if ($html->find('.mzmg_6m.m9qz_yo._6a66d_-fJr5')) {
-            return;
-        }
-
-        $results = $html->find('article[data-analytics-view-custom-context="REGULAR"]');
-
-        if ($this->getInput('includeSponsoredOffers')) {
-            $results = array_merge($results, $html->find('article[data-analytics-view-custom-context="SPONSORED"]'));
-        }
-
-        if ($this->getInput('includePromotedOffers')) {
-            $results = array_merge($results, $html->find('article[data-analytics-view-custom-context="PROMOTED"]'));
-        }
-
-        foreach ($results as $post) {
             $item = [];
+            $item['uid'] = $elements['offerId'];
+            $item['uri'] = $elements['url'];
+            $item['title'] = $elements['alt'];
 
-            $item['uid'] = $post->{'data-analytics-view-value'};
-
-            $item_link = $post->find('a[href*="' . $item['uid'] . '"], a[href*="allegrolokalnie"]', 0);
-
-            $item['uri'] = $item_link->href;
-
-            $item['title'] = $item_link->find('img', 0)->alt;
-
-            $image = $item_link->find('img', 0)->{'data-src'} ?: $item_link->find('img', 0)->src ?? false;
-
+            $image = $elements['photos'][0]['medium'];
             if ($image) {
                 $item['enclosures'] = [$image . '#.image'];
             }
 
-            $price = $post->{'data-analytics-view-json-custom-price'};
-            if ($price) {
-                $priceDecoded = json_decode(html_entity_decode($price));
-                $price = $priceDecoded->amount . ' ' . $priceDecoded->currency;
+            $price = $elements['price']['mainPrice']['amount'];
+            $currency = $elements['price']['mainPrice']['currency'];
+            $sellerType = $elements['seller']['title'];
+
+            $item['categories'] = [$sellerType];
+
+            $description = '';
+            foreach ($elements['parameters'] as $parameter) {
+                $item['categories'] = array_merge($item['categories'], $parameter['values']);
+                $description .= '<dt>' . $parameter['name'] . ': ' . implode(',', $parameter['values']) . '</dt>';
             }
 
-            $descriptionPatterns = ['/<\s*dt[^>]*>\b/', '/<\/dt>/', '/<\s*dd[^>]*>\b/', '/<\/dd>/'];
-            $descriptionReplacements = ['<span>', ':</span> ', '<strong>', '&emsp;</strong> '];
-            $description = $post->find('.m7er_k4.mpof_5r.mpof_z0_s', 0)->innertext;
-            $descriptionPretty = preg_replace($descriptionPatterns, $descriptionReplacements, $description);
-
-            $pricingExtraInfo = array_filter($post->find('.mqu1_g3.mgn2_12'), function ($node) {
-                return empty($node->find('.mvrt_0'));
-            });
-
-            $pricingExtraInfo = $pricingExtraInfo[0]->plaintext ?? '';
-
-            $offerExtraInfo = array_map(function ($node) {
-                return str_contains($node->plaintext, 'zapłać później') ? '' : $node->outertext;
-            }, $post->find('div.mpof_ki.mwdn_1.mj7a_4.mgn2_12'));
-
-            $isSmart = $post->find('img[alt="Smart!"]', 0) ?? false;
-            if ($isSmart) {
-                $pricingExtraInfo .= $isSmart->outertext;
-            }
-
-            $item['categories'] = [];
-            $parameters = $post->find('dd');
-            foreach ($parameters as $parameter) {
-                if (in_array(strtolower($parameter->innertext), ['brak', 'nie'])) {
-                    continue;
-                }
-
-                $item['categories'][] = $parameter->innertext;
-            }
-
-            $item['content'] = $descriptionPretty
-                . '<div><strong>'
-                . $price
-                . '</strong></div><div>'
-                . implode('</div><div>', $offerExtraInfo)
-                . '</div><dl>'
-                . $pricingExtraInfo
+            $item['content'] = '<div><strong>'
+                . $price . ' ' . $currency
+                . '</strong></div><dl><dt>'
+                . $sellerType . '</dt>'
+                . $description
                 . '</dl><hr>';
 
             $this->items[] = $item;
         }
     }
 }
+

From 5bd767b862bec2e1a26304be6fa8f6dd8c25ec7f Mon Sep 17 00:00:00 2001
From: Apollo Nargang <CoffeeCoder1@outlook.com>
Date: Thu, 8 May 2025 23:10:04 -0400
Subject: [PATCH 647/716] [TikTokBridge] Use oEmbed for video metadata (#4514)

* [TikTokBridge] Use oEmbed for video metadata

Fetches oEmbed-formatted metadata for videos through the TikTok API to
provide post titles, thumbnails, and authors. This hasn't yet been
tested, so it's possible it doesn't work.

* [TikTokBridge] Add back view count parsing

oops

* [TikTokBridge] Prepend www to the oEmbed API endpoint URL

The non-www URL resulted in a 301 redirect to the www URL, so this just
skips that redirect, improving performance a bit and hopefully helping
with the 400 errors.

* [TikTokBridge] Retry failed OEmbed requests

If an OEmbed request fails, retry a few times, waiting a bit in between
each retry. This should fix the problem for the most part, since I think
the problem was related to some sort of rate limit (it isn't mentioned
in the docs, but it seems to only happen when sending large quantities
of sequential requests).
---
 bridges/TikTokBridge.php | 25 ++++++++++++++++++++++---
 1 file changed, 22 insertions(+), 3 deletions(-)

diff --git a/bridges/TikTokBridge.php b/bridges/TikTokBridge.php
index 43a9cb31..ff3bfbc2 100644
--- a/bridges/TikTokBridge.php
+++ b/bridges/TikTokBridge.php
@@ -21,6 +21,8 @@ class TikTokBridge extends BridgeAbstract
             'context' => 'By user', 'username' => '@tiktok'
         ]
     ];
+    const OEMBED_RETRY_COUNT = 20;
+    const OEMBED_RETRY_DELAY = 0.1;
 
     const CACHE_TIMEOUT = 900; // 15 minutes
 
@@ -42,16 +44,33 @@ class TikTokBridge extends BridgeAbstract
             $parsedUrl = parse_url($href);
             $url = $parsedUrl['scheme'] . '://' . $parsedUrl['host'] . '/' . ltrim($parsedUrl['path'], '/');
 
-            $image = $video->find('video', 0)->poster;
+            // Sometimes the API fails to return data for a second, so try a few times
+            $attempts = 0;
+	        do {
+                try {
+                    // Fetch the video embed data from the OEmbed API
+                    $videoEmbedResponse = getContents('https://www.tiktok.com/oembed?url=' . $url);
+                } catch (Exception $e) {
+                    $attempts++;
+                    sleep($OEMBED_RETRY_DELAY);
+                    continue;
+                }
+                break;
+            } while($attempts < $OEMBED_RETRY_COUNT);
+            $videoEmbedData = json_decode($videoEmbedResponse);
+
+            $title = $videoEmbedData->title;
+            $image = $videoEmbedData->thumbnail_url;
             $views = $video->find('div[data-e2e=common-Video-Count]', 0)->plaintext;
 
             $enclosures = [$image, $authorProfilePicture];
 
             $item['uri'] = $url;
-            $item['title'] = 'Video';
-            $item['author'] = '@' . $author;
+            $item['title'] = $title;
+            $item['author'] = '@' . $videoEmbedData->author_unique_id;
             $item['enclosures'] = $enclosures;
             $item['content'] = <<<EOD
+<p>$title</p>
 <a href="{$url}"><img src="{$image}"/></a>
 <p>{$views} views<p><br/>
 EOD;

From 6c4225441aa5ee2c35145f8fe9cfe238bb70a855 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 9 May 2025 05:40:48 +0200
Subject: [PATCH 648/716] fix(tiktok) (#4550)

---
 bridges/TikTokBridge.php | 32 ++++++++++++++++++++------------
 1 file changed, 20 insertions(+), 12 deletions(-)

diff --git a/bridges/TikTokBridge.php b/bridges/TikTokBridge.php
index ff3bfbc2..9645bbb8 100644
--- a/bridges/TikTokBridge.php
+++ b/bridges/TikTokBridge.php
@@ -18,19 +18,16 @@ class TikTokBridge extends BridgeAbstract
 
     const TEST_DETECT_PARAMETERS = [
         'https://www.tiktok.com/@tiktok' => [
-            'context' => 'By user', 'username' => '@tiktok'
+            'context' => 'By user',
+            'username' => '@tiktok',
         ]
     ];
-    const OEMBED_RETRY_COUNT = 20;
-    const OEMBED_RETRY_DELAY = 0.1;
 
-    const CACHE_TIMEOUT = 900; // 15 minutes
+    const CACHE_TIMEOUT = 60 * 60; // 1h
 
     public function collectData()
     {
         $html = getSimpleHTMLDOMCached('https://www.tiktok.com/embed/' . $this->processUsername());
-
-        $author = $html->find('span[data-e2e=creator-profile-userInfo-TUXText]', 0)->plaintext ?? self::NAME;
         $authorProfilePicture = $html->find('img[data-e2e=creator-profile-userInfo-Avatar]', 0)->src ?? '';
 
         $videos = $html->find('div[data-e2e=common-videoList-VideoContainer]');
@@ -44,20 +41,31 @@ class TikTokBridge extends BridgeAbstract
             $parsedUrl = parse_url($href);
             $url = $parsedUrl['scheme'] . '://' . $parsedUrl['host'] . '/' . ltrim($parsedUrl['path'], '/');
 
+            $json = null;
+
             // Sometimes the API fails to return data for a second, so try a few times
             $attempts = 0;
-	        do {
+            do {
                 try {
                     // Fetch the video embed data from the OEmbed API
-                    $videoEmbedResponse = getContents('https://www.tiktok.com/oembed?url=' . $url);
-                } catch (Exception $e) {
+                    $json = getContents('https://www.tiktok.com/oembed?url=' . $url);
+                } catch (HttpException $e) {
                     $attempts++;
-                    sleep($OEMBED_RETRY_DELAY);
+                    // Sleep 0.1s
+                    usleep(100000);
                     continue;
                 }
                 break;
-            } while($attempts < $OEMBED_RETRY_COUNT);
-            $videoEmbedData = json_decode($videoEmbedResponse);
+            } while ($attempts < 3);
+
+            if ($json) {
+                $videoEmbedData = json_decode($json);
+            } else {
+                $videoEmbedData = new \stdClass();
+                $videoEmbedData->title = $url;
+                $videoEmbedData->thumbnail_url = '';
+                $videoEmbedData->author_unique_id = '';
+            }
 
             $title = $videoEmbedData->title;
             $image = $videoEmbedData->thumbnail_url;

From fd267df0e944badbd547a3299fda419149e373ee Mon Sep 17 00:00:00 2001
From: tillcash <tillcash@users.noreply.github.com>
Date: Fri, 9 May 2025 09:11:10 +0530
Subject: [PATCH 649/716] [LinuxBlogBridge] fix typo (#4549)

---
 bridges/LinuxBlogBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/LinuxBlogBridge.php b/bridges/LinuxBlogBridge.php
index 129ef31b..e00cba52 100644
--- a/bridges/LinuxBlogBridge.php
+++ b/bridges/LinuxBlogBridge.php
@@ -2,7 +2,7 @@
 
 class LinuxBlogBridge extends BridgeAbstract
 {
-    const NAME = 'LinuxBlog.in';
+    const NAME = 'LinuxBlog.io';
     const URI = 'https://linuxblog.io';
     const DESCRIPTION = 'Retrieve recent articles';
     const MAINTAINER = 'tillcash';

From b8c0c1f3b82fc29ee0be9a906c65b2689952e5c0 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 9 May 2025 05:58:11 +0200
Subject: [PATCH 650/716] fix: tweak logging rules (#4551)

---
 bridges/TelegramBridge.php | 2 +-
 lib/logger.php             | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/bridges/TelegramBridge.php b/bridges/TelegramBridge.php
index 4ed70107..54a089bc 100644
--- a/bridges/TelegramBridge.php
+++ b/bridges/TelegramBridge.php
@@ -92,7 +92,7 @@ class TelegramBridge extends BridgeAbstract
             }
         }
 
-        $this->logger->info(sprintf('Fetched %s messages from %s pages (%s)', count($this->items), $pages, $url));
+        $this->logger->debug(sprintf('Fetched %s messages from %s pages (%s)', count($this->items), $pages, $url));
 
         $this->items = array_reverse($this->items);
     }
diff --git a/lib/logger.php b/lib/logger.php
index 9e5f6ce9..77174203 100644
--- a/lib/logger.php
+++ b/lib/logger.php
@@ -71,13 +71,14 @@ final class SimpleLogger implements Logger
         $ignoredMessages = [
             'Format name invalid',
             'Unknown format given',
-            'Unable to find channel',
+            'Unable to find',
         ];
         foreach ($ignoredMessages as $ignoredMessage) {
             if (str_starts_with($message, $ignoredMessage)) {
                 return;
             }
         }
+
         foreach ($this->handlers as $handler) {
             $handler([
                 'name'          => $this->name,

From d36b335725d369291a6a919e70858eb151853797 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 9 May 2025 06:14:13 +0200
Subject: [PATCH 651/716] fix: do not log rate limit exceptions (#4552)

---
 lib/logger.php | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/lib/logger.php b/lib/logger.php
index 77174203..04b56b33 100644
--- a/lib/logger.php
+++ b/lib/logger.php
@@ -79,6 +79,15 @@ final class SimpleLogger implements Logger
             }
         }
 
+        if (isset($context['e'])) {
+            /** @var \Throwable $e */
+            $e = $context['e'];
+
+            if ($e instanceof RateLimitException) {
+                return;
+            }
+        }
+
         foreach ($this->handlers as $handler) {
             $handler([
                 'name'          => $this->name,

From 8f21a030a8a898464ca7028b60153ff9bc92bc1f Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 9 May 2025 09:39:35 +0200
Subject: [PATCH 652/716] fix(furaffinity): type error (#4554)

fixes array_filter(): Argument #1 ($array) must be of type array, null given

fix #4553
---
 bridges/FurAffinityBridge.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/bridges/FurAffinityBridge.php b/bridges/FurAffinityBridge.php
index 291026a8..635df01b 100644
--- a/bridges/FurAffinityBridge.php
+++ b/bridges/FurAffinityBridge.php
@@ -920,7 +920,9 @@ class FurAffinityBridge extends BridgeAbstract
                 break;
             }
 
-            $item = [];
+            $item = [
+                'categories' => [],
+            ];
 
             $submissionURL = $figure->find('b u a', 0)->href;
             $imgURL = $figure->find('b u a img', 0)->src;

From 0f77d3ae0a6d2b5babc9573047ba98be8545a7a9 Mon Sep 17 00:00:00 2001
From: Christian Schabesberger <chris.schabesberger@mailbox.org>
Date: Sat, 10 May 2025 21:48:54 +0200
Subject: [PATCH 653/716] fix nnplus article filter (#4555)

---
 bridges/NurembergerNachrichtenBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/NurembergerNachrichtenBridge.php b/bridges/NurembergerNachrichtenBridge.php
index 2c303533..cd6e8438 100644
--- a/bridges/NurembergerNachrichtenBridge.php
+++ b/bridges/NurembergerNachrichtenBridge.php
@@ -66,7 +66,7 @@ class NurembergerNachrichtenBridge extends BridgeAbstract
             // exclude nn+ articles if desired
             if (
                 $this->getInput('hideNNPlus') &&
-                $articleContent->find('div[class=paywall]')
+                $articleContent->find('span[class=icon-nnplus]')
             ) {
                 continue;
             }

From b7c04f8587dc35a3fcf2951a63e96cbbe0ab36cd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Dawid=20Wr=C3=B3bel?= <me@dawidwrobel.com>
Date: Sat, 17 May 2025 20:18:36 +0200
Subject: [PATCH 654/716] Overhaul the usage of libcurl-impersonate (#4535)

libcurl-impersonate was not being used properly, as the code was
overriding the headers set by it to prevent detection.

- update the libcurl-impersonate to an actively managed lexiforest
  fork
- impersonate Chrome 131
- move the defaultHttpHeaders to http.php, where it belongs
- only set defaultHttpHeaders if curl-impersonate is not detected
- make useragent ini setting optional and disabled by default
- add necessary documentation updates
---
 Dockerfile                                   | 21 ++++++++------
 config.default.ini.php                       |  5 +++-
 docs/03_For_Hosts/08_Custom_Configuration.md |  4 ++-
 docs/09_Technical_recommendations/index.md   |  2 +-
 lib/contents.php                             | 14 +---------
 lib/http.php                                 | 29 ++++++++++++++++----
 6 files changed, 45 insertions(+), 30 deletions(-)

diff --git a/Dockerfile b/Dockerfile
index 1326dba0..fb783344 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -25,36 +25,39 @@ RUN set -xe && \
       # php-zlib is enabled by default with PHP 8.2 in Debian 12
       # for downloading libcurl-impersonate
       curl \
+      # for patching libcurl-impersonate
+      patchelf \
       && \
     # install curl-impersonate library
-    curlimpersonate_version=0.6.0 && \
+    curlimpersonate_version=1.0.0rc2 && \
     { \
         { \
             [ $(arch) = 'aarch64' ] && \
             archive="libcurl-impersonate-v${curlimpersonate_version}.aarch64-linux-gnu.tar.gz" && \
-            sha512sum="d04b1eabe71f3af06aa1ce99b39a49c5e1d33b636acedcd9fad163bc58156af5c3eb3f75aa706f335515791f7b9c7a6c40ffdfa47430796483ecef929abd905d" \
+            sha512sum="c8add80e7a0430a074edea1a11f73d03044c48e848e164af2d6f362866623e29bede207a50f18f95b1bc5ab3d33f5c31408be60a6da66b74a0d176eebe299116" \
         ; } \
         || { \
             [ $(arch) = 'armv7l' ] && \
             archive="libcurl-impersonate-v${curlimpersonate_version}.arm-linux-gnueabihf.tar.gz" && \
-            sha512sum="05906b4efa1a6ed8f3b716fd83d476b6eea6bfc68e3dbc5212d65a2962dcaa7bd1f938c9096a7535252b11d1d08fb93adccc633585ff8cb8cec5e58bfe969bc9" \
+            sha512sum="d0403ca4ad55a8d499b120e5675c7b5a0dc4946af49c933e91fc24455ffe5e122aa21ee95554612ff5d1bd6faea1556e1e1b9c821918e2644cc9bcbddc05747a" \
         ; } \
         || { \
             [ $(arch) = 'x86_64' ] && \
             archive="libcurl-impersonate-v${curlimpersonate_version}.x86_64-linux-gnu.tar.gz" && \
-            sha512sum="480bbe9452cd9aff2c0daaaf91f1057b3a96385f79011628a9237223757a9b0d090c59cb5982dc54ea0d07191657299ea91ca170a25ced3d7d410fcdff130ace" \
+            sha512sum="35cafda2b96df3218a6d8545e0947a899837ede51c90f7ef2980bd2d99dbd67199bc620000df28b186727300b8c7046d506807fb48ee0fbc068dc8ae01986339" \
         ; } \
     } && \
-    curl -LO "https://github.com/lwthiker/curl-impersonate/releases/download/v${curlimpersonate_version}/${archive}" && \
+    curl -LO "https://github.com/lexiforest/curl-impersonate/releases/download/v${curlimpersonate_version}/${archive}" && \
     echo "$sha512sum  $archive" | sha512sum -c - && \
     mkdir -p /usr/local/lib/curl-impersonate && \
-    tar xaf "$archive" -C /usr/local/lib/curl-impersonate --wildcards 'libcurl-impersonate-ff.so*' && \
+    tar xaf "$archive" -C /usr/local/lib/curl-impersonate && \
+    patchelf --set-soname libcurl.so.4 /usr/local/lib/curl-impersonate/libcurl-impersonate.so && \
     rm "$archive" && \
-    apt-get purge --assume-yes curl && \
+    apt-get purge --assume-yes curl patchelf && \
     rm -rf /var/lib/apt/lists/*
 
-ENV LD_PRELOAD /usr/local/lib/curl-impersonate/libcurl-impersonate-ff.so
-ENV CURL_IMPERSONATE ff91esr
+ENV LD_PRELOAD /usr/local/lib/curl-impersonate/libcurl-impersonate.so
+ENV CURL_IMPERSONATE chrome131
 
 # logs should go to stdout / stderr
 RUN ln -sfT /dev/stderr /var/log/nginx/error.log; \
diff --git a/config.default.ini.php b/config.default.ini.php
index 6d646fd5..ae8b23b7 100644
--- a/config.default.ini.php
+++ b/config.default.ini.php
@@ -53,7 +53,10 @@ timeout = 5
 retries = 1
 
 ; Curl user agent
-useragent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Firefox/102.0"
+; This is already set by curl-impersonate, which comes included as default 
+; in RSS-Bridge docker container. Use only if you know what you're doing.
+; For reference, see https://github.com/lexiforest/curl-impersonate/tree/main/docs
+;useragent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Firefox/102.0"
 
 ; Max http response size in MB
 max_filesize = 20
diff --git a/docs/03_For_Hosts/08_Custom_Configuration.md b/docs/03_For_Hosts/08_Custom_Configuration.md
index 6e22f7ee..ebb53cb3 100644
--- a/docs/03_For_Hosts/08_Custom_Configuration.md
+++ b/docs/03_For_Hosts/08_Custom_Configuration.md
@@ -119,7 +119,9 @@ Default network timeout.
 
 ### useragent
 
-Default user agent.
+Overrides the user agent value. Note that the default value, together with a set of other detection-preventing options is set
+automatically by the [libcurl-impersonate](https://github.com/lexiforest/curl-impersonate), which is used by the default Docker container distributed together with RSS-Bridge. Use only if you know what you're doing, otherwise you may stop libcurl-impersonate
+from doing its job impersonating real browser.
 
 ## Authentication
 
diff --git a/docs/09_Technical_recommendations/index.md b/docs/09_Technical_recommendations/index.md
index c564418e..92c672ca 100644
--- a/docs/09_Technical_recommendations/index.md
+++ b/docs/09_Technical_recommendations/index.md
@@ -3,7 +3,7 @@
 ## Test a site before building a bridge
 
 Some sites make use of anti-bot mechanisms (e.g.: by using JavaScript) in which case they work fine in regular browsers,
-but not in the PHP environment.
+but not in the PHP environment. RSS-Bridge Docker container by default resorts to using libcurl-impersonate, which helps mitigating anti-bot mechanisms.
 
 To check if a site works with RSS-Bridge, create a new bridge using the 
 [template](../05_Bridge_API/02_BridgeAbstract.md#template)
diff --git a/lib/contents.php b/lib/contents.php
index b4d70817..7c9060a9 100644
--- a/lib/contents.php
+++ b/lib/contents.php
@@ -64,19 +64,7 @@ function getContents(
         }
     }
 
-    // Snagged from https://github.com/lwthiker/curl-impersonate/blob/main/firefox/curl_ff102
-    $defaultHttpHeaders = [
-        'Accept' => 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8',
-        'Accept-Language' => 'en-US,en;q=0.5',
-        'Upgrade-Insecure-Requests' => '1',
-        'Sec-Fetch-Dest' => 'document',
-        'Sec-Fetch-Mode' => 'navigate',
-        'Sec-Fetch-Site' => 'none',
-        'Sec-Fetch-User' => '?1',
-        'TE' => 'trailers',
-    ];
-
-    $config['headers'] = array_merge($defaultHttpHeaders, $httpHeadersNormalized);
+    $config['headers'] = $httpHeadersNormalized;
 
     $maxFileSize = Configuration::getConfig('http', 'max_filesize');
     if ($maxFileSize) {
diff --git a/lib/http.php b/lib/http.php
index 15d6ebec..37a1f12e 100644
--- a/lib/http.php
+++ b/lib/http.php
@@ -66,6 +66,8 @@ final class CurlHttpClient implements HttpClient
 {
     public function request(string $url, array $config = []): Response
     {
+        $ch = curl_init($url);
+
         $defaults = [
             'useragent' => null,
             'timeout' => 5,
@@ -77,13 +79,27 @@ final class CurlHttpClient implements HttpClient
             'max_filesize' => null,
             'max_redirections' => 5,
         ];
+
+        // if curl-impersonate is not detected, use some basic defaults
+        if (curl_version()['ssl_version'] != 'BoringSSL') {
+            // Snagged from https://github.com/lwthiker/curl-impersonate/blob/main/firefox/curl_ff102
+            $defaults['headers'] = [
+                'Accept' => 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8',
+                'Accept-Language' => 'en-US,en;q=0.5',
+                'Upgrade-Insecure-Requests' => '1',
+                'Sec-Fetch-Dest' => 'document',
+                'Sec-Fetch-Mode' => 'navigate',
+                'Sec-Fetch-Site' => 'none',
+                'Sec-Fetch-User' => '?1',
+                'TE' => 'trailers',
+            ];
+            $defaults['useragent'] = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Firefox/102.0';
+
+            curl_setopt($ch, CURLOPT_HEADER, false);
+        }
+
         $config = array_merge($defaults, $config);
 
-        $ch = curl_init($url);
-        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
-        curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
-        curl_setopt($ch, CURLOPT_MAXREDIRS, $config['max_redirections']);
-        curl_setopt($ch, CURLOPT_HEADER, false);
         $httpHeaders = [];
         foreach ($config['headers'] as $name => $value) {
             $httpHeaders[] = sprintf('%s: %s', $name, $value);
@@ -92,6 +108,9 @@ final class CurlHttpClient implements HttpClient
         if ($config['useragent']) {
             curl_setopt($ch, CURLOPT_USERAGENT, $config['useragent']);
         }
+        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+        curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
+        curl_setopt($ch, CURLOPT_MAXREDIRS, $config['max_redirections']);
         curl_setopt($ch, CURLOPT_TIMEOUT, $config['timeout']);
         curl_setopt($ch, CURLOPT_ENCODING, '');
         curl_setopt($ch, CURLOPT_PROTOCOLS, CURLPROTO_HTTP | CURLPROTO_HTTPS);

From 0130adcd6c96e34a1c965d611641fb2e194e1cee Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 23 May 2025 22:55:41 +0200
Subject: [PATCH 655/716] fix: deprecation warning (#4567)

---
 lib/CacheFactory.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/CacheFactory.php b/lib/CacheFactory.php
index 47bbbf72..50d8cef9 100644
--- a/lib/CacheFactory.php
+++ b/lib/CacheFactory.php
@@ -92,6 +92,7 @@ class CacheFactory
                 if (empty($port)) {
                     throw new \Exception('"port" param is not set for ' . $section);
                 }
+                $port = (string) $port;
                 if (!ctype_digit($port)) {
                     throw new \Exception('"port" param is invalid for ' . $section);
                 }

From ec5b32c551e4888eb514857a7a659f2df47955db Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 24 May 2025 19:14:53 +0200
Subject: [PATCH 656/716] ci: fix broken ci (#4568)

* fix: deprecation warning

* ci: fix broken ci
---
 .github/workflows/lint.yml  | 6 +++---
 .github/workflows/tests.yml | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 206b53de..79201edd 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -8,7 +8,7 @@ on:
 
 jobs:
   phpcs:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-22.04
     strategy:
       matrix:
         php-versions: ['7.4']
@@ -21,7 +21,7 @@ jobs:
       - run: phpcs . --standard=phpcs.xml --warning-severity=0 --extensions=php -p
 
   phpcompatibility:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-22.04
     strategy:
       matrix:
         php-versions: ['7.4']
@@ -36,7 +36,7 @@ jobs:
       - run: ~/.composer/vendor/bin/phpcs . --standard=phpcompatibility.xml --warning-severity=0 --extensions=php -p
 
   executable_php_files_check:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-22.04
     steps:
       - uses: actions/checkout@v4
       - run: |
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 93f07b0f..96128fc2 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -8,7 +8,7 @@ on:
 
 jobs:
   phpunit8:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-22.04
     strategy:
       matrix:
         php-versions: ['7.4', '8.0', '8.1']

From daef06c6dd445c12a45f60bcd8d1fa7eadf023a0 Mon Sep 17 00:00:00 2001
From: Thiago Ferreira <thiagocf042@gmail.com>
Date: Sat, 24 May 2025 14:18:52 -0300
Subject: [PATCH 657/716] devcontainer: Fixed Dev Containers setup (#4556)

The current setup for Dev Containers was not working, with multiple
different errors. So, in order to restore its funcionality (and allow
for things like linting and debugging), the following changes were made:

- The Dockerfile was severely alterered. Now, the `docker-php-ext-enable` binary is installed before its usage,
  it points to the correct PHP binary, and we install Composer for for
  loading dev-dependencies later-on.

- Moved the "postCreateCommand" section (defined on the `devcontainer.json` file) into its own script file (for a
  more readable experience)

- On the post-creation script, moved the `xdebug.ini` to the correct
  directory (alongside the PHP-FPM bin), installed PHPUnit,
  PHPCodesniffer (and the 'PHP Compatibility' sniffer) with Composer on
  a global location, and changed owner of the `cache` directory

- Changed VSCode-specific customization setting in order to point to the
  update some binary paths. Also made sure globally-installed composer
  packages binaries are accessible via PATHdocker-php-ext-enable
---
 .devcontainer/Dockerfile             | 25 +++++++++++++++++++------
 .devcontainer/devcontainer.json      | 11 +++++++----
 .devcontainer/launch.json            |  3 ++-
 .devcontainer/post-create-command.sh | 27 +++++++++++++++++++++++++++
 4 files changed, 55 insertions(+), 11 deletions(-)
 create mode 100755 .devcontainer/post-create-command.sh

diff --git a/.devcontainer/Dockerfile b/.devcontainer/Dockerfile
index faec9f09..15297cc3 100644
--- a/.devcontainer/Dockerfile
+++ b/.devcontainer/Dockerfile
@@ -1,8 +1,21 @@
 FROM rssbridge/rss-bridge:latest
 
-RUN  apt-get update && \
-    apt-get install --yes --no-install-recommends \
-      git && \
-    pecl install xdebug && \
-    pear install PHP_CodeSniffer && \
-    docker-php-ext-enable xdebug
\ No newline at end of file
+COPY --chmod=755 post-create-command.sh /usr/local/bin/post-create-command
+
+ADD https://raw.githubusercontent.com/docker-library/php/master/docker-php-ext-enable /usr/local/bin/docker-php-ext-enable
+RUN chmod u+x /usr/local/bin/docker-php-ext-enable
+
+ADD https://getcomposer.org/installer /usr/local/bin/composer-installer.php
+RUN chmod u+x /usr/local/bin/composer-installer.php
+RUN php /usr/local/bin/composer-installer.php --check && \
+    php /usr/local/bin/composer-installer.php --filename=composer --install-dir=/usr/local/bin
+
+RUN apt-get update && \
+    apt-get install -y \
+      git \
+      php-dev \
+      make \
+      unzip
+
+RUN pecl install xdebug && \
+    PHP_INI_DIR=/etc/php/8.2/fpm docker-php-ext-enable xdebug
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
index 6e625b8a..564da38a 100644
--- a/.devcontainer/devcontainer.json
+++ b/.devcontainer/devcontainer.json
@@ -6,9 +6,9 @@
 		"vscode": {
 			// Set *default* container specific settings.json values on container create.
 			"settings": {
-				"php.validate.executablePath": "/usr/local/bin/php",
-				"phpSniffer.executablesFolder": "/usr/local/bin/",
-				"phpcs.executablePath": "/usr/local/bin/phpcs",
+				"php.validate.executablePath": "/usr/bin/php",
+				"phpSniffer.executablesFolder": "/root/.config/composer/vendor/bin",
+				"phpcs.executablePath": "/root/.config/composer/vendor/bin/phpcs",
 				"phpcs.lintOnType": false
 			},
 
@@ -22,6 +22,9 @@
 			]
 		}
 	},
+	"remoteEnv": {
+		"PATH": "${containerEnv:PATH}:/root/.config/composer/vendor/bin",
+	},
 	"forwardPorts": [3100, 9000, 9003],
-	"postCreateCommand": "cp .devcontainer/nginx.conf /etc/nginx/conf.d/default.conf && cp .devcontainer/xdebug.ini /usr/local/etc/php/conf.d/xdebug.ini && mkdir .vscode && cp .devcontainer/launch.json .vscode && echo '*' > whitelist.txt && chmod a+x \"$(pwd)\" && rm -rf /var/www/html && ln -s \"$(pwd)\" /var/www/html && nginx && php-fpm -D"
+	"postCreateCommand": "/usr/local/bin/post-create-command"
 }
\ No newline at end of file
diff --git a/.devcontainer/launch.json b/.devcontainer/launch.json
index e1b473b8..7fe617e9 100644
--- a/.devcontainer/launch.json
+++ b/.devcontainer/launch.json
@@ -9,7 +9,8 @@
             "type": "php",
             "request": "launch",
             "port": 9003,
-            "auto": true
+            "auto": true,
+            "log": true
         },
         {
             "name": "Launch currently open script",
diff --git a/.devcontainer/post-create-command.sh b/.devcontainer/post-create-command.sh
new file mode 100755
index 00000000..aa3819eb
--- /dev/null
+++ b/.devcontainer/post-create-command.sh
@@ -0,0 +1,27 @@
+#/bin/sh
+
+cp .devcontainer/nginx.conf /etc/nginx/conf.d/default.conf
+cp .devcontainer/xdebug.ini /etc/php/8.2/fpm/conf.d/xdebug.ini
+
+#  This should download some dev-dependencies, like phpunit and the PHP code sniffers
+composer global require "phpunit/phpunit:^9"
+composer global require "squizlabs/php_codesniffer:^3.6"
+composer global require "phpcompatibility/php-compatibility:^9.3"
+
+#  We need to this manually for running the PHPCompatibility ruleset
+phpcs --config-set installed_paths /root/.config/composer/vendor/phpcompatibility/php-compatibility
+
+mkdir -p .vscode
+cp .devcontainer/launch.json .vscode
+
+echo '*' > whitelist.txt 
+
+chmod a+x $(pwd)
+rm -rf /var/www/html 
+ln -s $(pwd) /var/www/html 
+
+# Solves possible issue of cache directory not being accessible
+chown www-data:www-data -R $(pwd)/cache 
+
+nginx
+php-fpm8.2 -D
\ No newline at end of file

From 7397cabeee606e6360d1a8b854a9898a8178784e Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Sat, 24 May 2025 19:29:04 +0200
Subject: [PATCH 658/716] fix(telegram): remove meta message (#4569)

---
 bridges/TelegramBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/TelegramBridge.php b/bridges/TelegramBridge.php
index 54a089bc..0a3f1a74 100644
--- a/bridges/TelegramBridge.php
+++ b/bridges/TelegramBridge.php
@@ -104,7 +104,7 @@ class TelegramBridge extends BridgeAbstract
         $notSupported = $messageDiv->find('div.message_media_not_supported_wrap', 0);
         if ($notSupported) {
             // For unknown reasons, the telegram preview page omits the content of this post
-            $message = 'RSS-Bridge was unable to find the content of this post.<br><br>' . $notSupported->innertext;
+            $message = (string) $notSupported->innertext;
         }
 
         if ($messageDiv->find('div.tgme_widget_message_forwarded_from', 0)) {

From 7b55eb3824d6bdad898ec7d8172b6313950343f2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?St=C3=A9phane?= <github@sakana.fr>
Date: Sun, 25 May 2025 20:46:50 +0200
Subject: [PATCH 659/716] Adding a bridge for Paul Graham's essays (#4570)

* Adding a bridge for Paul Graham's essays

* lint

---------

Co-authored-by: Dag <me@dvikan.no>
---
 bridges/PaulGrahamBridge.php | 95 ++++++++++++++++++++++++++++++++++++
 1 file changed, 95 insertions(+)
 create mode 100644 bridges/PaulGrahamBridge.php

diff --git a/bridges/PaulGrahamBridge.php b/bridges/PaulGrahamBridge.php
new file mode 100644
index 00000000..928eea35
--- /dev/null
+++ b/bridges/PaulGrahamBridge.php
@@ -0,0 +1,95 @@
+<?php
+
+class PaulGrahamBridge extends BridgeAbstract
+{
+    const NAME = 'Paul Graham Essays';
+    const URI = 'https://www.paulgraham.com/articles.html';
+    const DESCRIPTION = 'Returns the latest Paul Graham essays in display order';
+    const MAINTAINER = 'Claire (for Stéphane)';
+    const CACHE_TIMEOUT = 3600;
+
+    public function collectData()
+    {
+        $html = getSimpleHTMLDOM(self::URI);
+
+    // Navigate to the right TD
+    // /html/body/table/tbody/tr/td[3]
+        $tables = $html->find('body table');
+        if (!isset($tables[0])) {
+            return;
+        }
+
+        $tds = $tables[0]->find('td');
+        if (!isset($tds[2])) {
+            return;
+        }
+
+        $contentTd = $tds[2];
+
+        // Find all inner tables (each one holds a single essay link)
+        $essayTables = $contentTd->find('table');
+        if (!isset($essayTables[1])) {
+            return;
+        }
+
+        $essayTable = $essayTables[1];
+
+    // /html/body/table/tbody/tr/td[3]/table[2]/tbody/tr[2]/td/font/a
+
+        $links = $essayTable->find('font');
+
+        $essayLinks = [];
+        foreach ($links as $t) {
+            $link = $t->find('a', 0);
+            if (!$link) {
+                continue;
+            }
+
+            $href = trim($link->href);
+            $title = trim($link->plaintext);
+
+            if (empty($href) || strpos($href, 'http') === 0 || !preg_match('/\.html$/', $href)) {
+                continue;
+            }
+
+            $essayLinks[] = [
+                'title' => $title,
+                'url' => 'https://www.paulgraham.com/' . $href,
+            ];
+        }
+
+        // Only fetch the first 10 (in display order)
+        $essayLinks = array_slice($essayLinks, 0, 10);
+
+        foreach ($essayLinks as $essay) {
+            $item = [
+                'uri' => $essay['url'],
+                'title' => $essay['title'],
+                'uid' => $essay['url'],
+                'content' => '',
+            ];
+
+            $essayHtml = getSimpleHTMLDOMCached($essay['url']);
+            if ($essayHtml) {
+                $essayTables = $essayHtml->find('body table');
+                if (isset($essayTables[0])) {
+                    $essayTds = $essayTables[0]->find('td');
+                    if (isset($essayTds[2])) {
+                        $mainContent = $essayTds[2]->innertext;
+                        $mainDom = str_get_html($mainContent);
+
+                        // Strip unwanted layout elements
+                        foreach ($mainDom->find('map, img, script') as $el) {
+                            $el->outertext = '';
+                        }
+
+                        $item['content'] = $mainDom->save();
+                    }
+                }
+            }
+
+            $this->items[] = $item;
+        }
+    }
+}
+

From e5b3ec85d9d07b2bc06b7561e21eb1358f68e805 Mon Sep 17 00:00:00 2001
From: Joseph <VerifiedJoseph@users.noreply.github.com>
Date: Mon, 26 May 2025 21:46:28 +0100
Subject: [PATCH 660/716] Delete CuriousCatBridge.php (#4571)

---
 bridges/CuriousCatBridge.php | 113 -----------------------------------
 1 file changed, 113 deletions(-)
 delete mode 100644 bridges/CuriousCatBridge.php

diff --git a/bridges/CuriousCatBridge.php b/bridges/CuriousCatBridge.php
deleted file mode 100644
index 3d6e87d0..00000000
--- a/bridges/CuriousCatBridge.php
+++ /dev/null
@@ -1,113 +0,0 @@
-<?php
-
-class CuriousCatBridge extends BridgeAbstract
-{
-    const NAME = 'Curious Cat Bridge';
-    const URI = 'https://curiouscat.me';
-    const DESCRIPTION = 'Returns list of newest questions and answers for a user profile';
-    const MAINTAINER = 'VerifiedJoseph';
-    const PARAMETERS = [[
-        'username' => [
-            'name' => 'Username',
-            'type' => 'text',
-            'required' => true,
-            'exampleValue' => 'koethekoethe',
-        ]
-    ]];
-
-    const CACHE_TIMEOUT = 3600;
-
-    public function collectData()
-    {
-        $url = self::URI . '/api/v2/profile?username=' . urlencode($this->getInput('username'));
-
-        $apiJson = getContents($url);
-
-        $apiData = Json::decode($apiJson);
-        if (isset($apiData['error'])) {
-            throw new \Exception($apiData['error_code']);
-        }
-
-        foreach ($apiData['posts'] as $post) {
-            $item = [];
-
-            $item['author'] = 'Anonymous';
-
-            if ($post['senderData']['id'] !== false) {
-                $item['author'] = $post['senderData']['username'];
-            }
-
-            $item['uri'] = $this->getURI() . '/post/' . $post['id'];
-            $item['title'] = $this->ellipsisTitle($post['comment']);
-
-            $item['content'] = $this->processContent($post);
-            $item['timestamp'] = $post['timestamp'];
-
-            $this->items[] = $item;
-        }
-    }
-
-    public function getURI()
-    {
-        if (!is_null($this->getInput('username'))) {
-            return self::URI . '/' . $this->getInput('username');
-        }
-
-        return parent::getURI();
-    }
-
-    public function getName()
-    {
-        if (!is_null($this->getInput('username'))) {
-            return $this->getInput('username') . ' - Curious Cat';
-        }
-
-        return parent::getName();
-    }
-
-    private function processContent($post)
-    {
-        $author = 'Anonymous';
-
-        if ($post['senderData']['id'] !== false) {
-            $authorUrl = self::URI . '/' . $post['senderData']['username'];
-
-            $author = <<<EOD
-<a href="{$authorUrl}">{$post['senderData']['username']}</a>
-EOD;
-        }
-
-        $question = $this->formatUrls($post['comment']);
-        $answer = $this->formatUrls($post['reply']);
-
-        $content = <<<EOD
-<p>{$author} asked:</p>
-<blockquote>{$question}</blockquote><br/>
-<p>{$post['addresseeData']['username']} answered:</p>
-<blockquote>{$answer}</blockquote>
-EOD;
-
-        return $content;
-    }
-
-    private function ellipsisTitle($text)
-    {
-        $length = 150;
-
-        if (strlen($text) > $length) {
-            $text = explode('<br>', wordwrap($text, $length, '<br>'));
-            return $text[0] . '...';
-        }
-
-        return $text;
-    }
-
-    private function formatUrls($content)
-    {
-        return preg_replace(
-            '/(http[s]{0,1}\:\/\/[a-zA-Z0-9.\/\?\&=\-_]{4,})/ims',
-            '<a target="_blank" href="$1" target="_blank">$1</a> ',
-            $content
-        );
-    }
-}

From 419844f01002f18b654c35bed717e3a5e78635ee Mon Sep 17 00:00:00 2001
From: Joseph <VerifiedJoseph@users.noreply.github.com>
Date: Mon, 26 May 2025 21:46:42 +0100
Subject: [PATCH 661/716] Delete OpenlyBridge.php (#4572)

---
 bridges/OpenlyBridge.php | 255 ---------------------------------------
 1 file changed, 255 deletions(-)
 delete mode 100644 bridges/OpenlyBridge.php

diff --git a/bridges/OpenlyBridge.php b/bridges/OpenlyBridge.php
deleted file mode 100644
index 9f54e22a..00000000
--- a/bridges/OpenlyBridge.php
+++ /dev/null
@@ -1,255 +0,0 @@
-<?php
-
-class OpenlyBridge extends BridgeAbstract
-{
-    const NAME = 'Openly Bridge';
-    const URI = 'https://www.openlynews.com/';
-    const DESCRIPTION = 'Returns news articles';
-    const MAINTAINER = 'VerifiedJoseph';
-    const PARAMETERS = [
-        'All News' => [],
-        'All Opinion' => [],
-        'By Region' => [
-            'region' => [
-                'name' => 'Region',
-                'type' => 'list',
-                'values' => [
-                    'Africa' => 'africa',
-                    'Asia Pacific' => 'asia-pacific',
-                    'Europe' => 'europe',
-                    'Latin America' => 'latin-america',
-                    'Middle Easta' => 'middle-east',
-                    'North America' => 'north-america'
-                ]
-            ],
-            'content' => [
-                'name' => 'Content',
-                'type' => 'list',
-                'values' => [
-                    'News' => 'news',
-                    'Opinion' => 'people'
-                ],
-                'defaultValue' => 'news'
-            ]
-        ],
-        'By Tag' => [
-            'tag' => [
-                'name' => 'Tag',
-                'type' => 'text',
-                'required' => true,
-                'exampleValue' => 'lgbt-law',
-            ],
-            'content' => [
-                'name' => 'Content',
-                'type' => 'list',
-                'values' => [
-                    'News' => 'news',
-                    'Opinion' => 'people'
-                ],
-                'defaultValue' => 'news'
-            ]
-        ],
-        'By Author' => [
-            'profileId' => [
-                'name' => 'Profile ID',
-                'type' => 'text',
-                'required' => true,
-                'exampleValue' => '003D000002WZGYRIA5',
-            ]
-        ]
-    ];
-
-    const TEST_DETECT_PARAMETERS = [
-        'https://www.openlynews.com/profile/?id=0033z00002XUTepAAH' => [
-            'context' => 'By Author', 'profileId' => '0033z00002XUTepAAH'
-        ],
-        'https://www.openlynews.com/news/?page=1&theme=lgbt-law' => [
-            'context' => 'By Tag', 'content' => 'news', 'tag' => 'lgbt-law'
-        ],
-        'https://www.openlynews.com/news/?page=1&region=north-america' => [
-            'context' => 'By Region', 'content' => 'news', 'region' => 'north-america'
-        ],
-        'https://www.openlynews.com/news/?theme=lgbt-law' => [
-            'context' => 'By Tag', 'content' => 'news', 'tag' => 'lgbt-law'
-        ],
-        'https://www.openlynews.com/news/?region=north-america' => [
-            'context' => 'By Region', 'content' => 'news', 'region' => 'north-america'
-        ]
-    ];
-
-    const CACHE_TIMEOUT = 900; // 15 mins
-    const ARTICLE_CACHE_TIMEOUT = 3600; // 1 hour
-
-    private $feedTitle = '';
-    private $itemLimit = 10;
-
-    private $profileUrlRegex = '/openlynews\.com\/profile\/\?id=([a-zA-Z0-9]+)/';
-    private $tagUrlRegex = '/openlynews\.com\/([a-z]+)\/\?(?:page=(?:[0-9]+)&)?theme=([\w-]+)/';
-    private $regionUrlRegex = '/openlynews\.com\/([a-z]+)\/\?(?:page=(?:[0-9]+)&)?region=([\w-]+)/';
-
-    public function detectParameters($url)
-    {
-        $params = [];
-
-        if (preg_match($this->profileUrlRegex, $url, $matches) > 0) {
-            $params['context'] = 'By Author';
-            $params['profileId'] = $matches[1];
-            return $params;
-        }
-
-        if (preg_match($this->tagUrlRegex, $url, $matches) > 0) {
-            $params['context'] = 'By Tag';
-            $params['content'] = $matches[1];
-            $params['tag'] = $matches[2];
-            return $params;
-        }
-
-        if (preg_match($this->regionUrlRegex, $url, $matches) > 0) {
-            $params['context'] = 'By Region';
-            $params['content'] = $matches[1];
-            $params['region'] = $matches[2];
-            return $params;
-        }
-
-        return null;
-    }
-
-    public function collectData()
-    {
-        $url = $this->getAjaxURI();
-
-        if ($this->queriedContext === 'By Author') {
-            $url = $this->getURI();
-        }
-
-        $html = getSimpleHTMLDOM($url);
-        $html = defaultLinkTo($html, $this->getURI());
-
-        if ($html->find('h1', 0)) {
-            $this->feedTitle = $html->find('h1', 0)->plaintext;
-        }
-
-        if ($html->find('h2.title-v4', 0)) {
-            $html->find('span.tooltiptext', 0)->innertext = '';
-            $this->feedTitle = $html->find('a.tooltipitem', 0)->plaintext;
-        }
-
-        $items = $html->find('div.item');
-        $limit = 5;
-        foreach (array_slice($items, 0, $limit) as $div) {
-            $this->items[] = $this->getArticle($div->find('a', 0)->href);
-
-            if (count($this->items) >= $this->itemLimit) {
-                break;
-            }
-        }
-    }
-
-    public function getURI()
-    {
-        switch ($this->queriedContext) {
-            case 'All News':
-                return self::URI . 'news';
-                break;
-            case 'All Opinion':
-                return self::URI . 'people';
-                break;
-            case 'By Tag':
-                return self::URI . $this->getInput('content') . '/?theme=' . $this->getInput('tag');
-            case 'By Region':
-                return self::URI . $this->getInput('content') . '/?region=' . $this->getInput('region');
-                break;
-            case 'By Author':
-                return self::URI . 'profile/?id=' . $this->getInput('profileId');
-                break;
-            default:
-                return parent::getURI();
-        }
-    }
-
-    public function getName()
-    {
-        switch ($this->queriedContext) {
-            case 'All News':
-                return 'News - Openly';
-                break;
-            case 'All Opinion':
-                return 'Opinion - Openly';
-                break;
-            case 'By Tag':
-                if (empty($this->feedTitle)) {
-                    $this->feedTitle = $this->getInput('tag');
-                }
-
-                if ($this->getInput('content') === 'people') {
-                    return $this->feedTitle . ' - Opinion - Openly';
-                }
-
-                return $this->feedTitle . ' - Openly';
-                break;
-            case 'By Region':
-                if (empty($this->feedTitle)) {
-                    $this->feedTitle = $this->getInput('region');
-                }
-
-                if ($this->getInput('content') === 'people') {
-                    return $this->feedTitle . ' - Opinion - Openly';
-                }
-
-                return $this->feedTitle . ' - Openly';
-                break;
-            case 'By Author':
-                if (empty($this->feedTitle)) {
-                    $this->feedTitle = $this->getInput('profileId');
-                }
-
-                return $this->feedTitle . ' - Author - Openly';
-                break;
-            default:
-                return parent::getName();
-        }
-    }
-
-    private function getAjaxURI()
-    {
-        $part = '/ajax.html?';
-
-        switch ($this->queriedContext) {
-            case 'All News':
-                return self::URI . 'news' . $part;
-                break;
-            case 'All Opinion':
-                return self::URI . 'people' . $part;
-                break;
-            case 'By Tag':
-                return self::URI . $this->getInput('content') . $part . 'theme=' . $this->getInput('tag');
-                break;
-            case 'By Region':
-                return self::URI . $this->getInput('content') . $part . 'region=' . $this->getInput('region');
-                break;
-        }
-    }
-
-    private function getArticle($url)
-    {
-        $article = getSimpleHTMLDOMCached($url, self::ARTICLE_CACHE_TIMEOUT);
-        $article = defaultLinkTo($article, $this->getURI());
-
-        $item = [];
-        $item['title'] = $article->find('h1', 0)->plaintext;
-        $item['uri'] = $url;
-        $item['content'] = $article->find('div.body-text', 0);
-        $item['enclosures'][] = $article->find('meta[name="twitter:image"]', 0)->content;
-        $item['timestamp'] = $article->find('div.meta.small', 0)->plaintext;
-
-        if ($article->find('div.meta a', 0)) {
-            $item['author'] = $article->find('div.meta a', 0)->plaintext;
-        }
-
-        foreach ($article->find('div.themes li') as $li) {
-            $item['categories'][] = trim(htmlspecialchars($li->plaintext, ENT_QUOTES));
-        }
-
-        return $item;
-    }
-}

From 976217111cd99837116f48aa69a9aff462286e23 Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Wed, 28 May 2025 19:12:00 +0000
Subject: [PATCH 662/716] [GolemBridge] Add code elements

The extractor missed <pre> elements for code snippets.
For example the code line in
https://www.golem.de/news/falsch-deklarierte-hdds-betrug-bei-festplatten-bleibt-ein-problem-2505-196675.html
---
 bridges/GolemBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/GolemBridge.php b/bridges/GolemBridge.php
index 219233f4..fbd154e3 100644
--- a/bridges/GolemBridge.php
+++ b/bridges/GolemBridge.php
@@ -152,7 +152,7 @@ class GolemBridge extends FeedExpander
             $img->src = $img->getAttribute('data-src-full');
         }
 
-        foreach ($content->find('p, h1, h2, h3, img[src*="."], iframe, video') as $element) {
+        foreach ($content->find('p, h1, h2, h3, pre, img[src*="."], iframe, video') as $element) {
             $item .= $element;
         }
 

From b8064d9dfe210cc20fad303222e104460413071d Mon Sep 17 00:00:00 2001
From: Anton Smirnov <github@svc.sandfox.me>
Date: Fri, 30 May 2025 12:05:36 +0300
Subject: [PATCH 663/716] [EpicGamesFree] Fixes: url not set, other promos
 shown (#4575)

* URI was not set because of the typo

* Filter out other promos
---
 bridges/EpicGamesFreeBridge.php | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/bridges/EpicGamesFreeBridge.php b/bridges/EpicGamesFreeBridge.php
index 087b95be..3b16cd5b 100644
--- a/bridges/EpicGamesFreeBridge.php
+++ b/bridges/EpicGamesFreeBridge.php
@@ -27,7 +27,7 @@ class EpicGamesFreeBridge extends BridgeAbstract
                 'Türkçe' => 'tr',
                 '简体中文' => 'zh-CN',
                 '繁體中文' => 'zh-Hant',
-             ],
+            ],
             'title' => 'Language for game information',
             'defaultValue' => 'en-US',
         ],
@@ -51,16 +51,21 @@ class EpicGamesFreeBridge extends BridgeAbstract
 
         $data = $json['data']['Catalog']['searchStore']['elements'];
         foreach ($data as $element) {
-            if (!isset($element['promotions']['promotionalOffers'][0])) {
+            $promo = $element['promotions']['promotionalOffers'][0]['promotionalOffers'][0] ?? false;
+            if (
+                !$promo ||
+                $promo['discountSetting']['discountType'] !== 'PERCENTAGE' ||
+                $promo['discountSetting']['discountPercentage'] !== 0
+            ) {
                 continue;
             }
             $item = [
                 'author' => $element['seller']['name'],
                 'content' => $element['description'],
                 'enclosures' => array_map(fn($item) => $item['url'], $element['keyImages']),
-                'timestamp' => strtotime($element['promotions']['promotionalOffers'][0]['promotionalOffers'][0]['startDate']),
+                'timestamp' => strtotime($promo['startDate']),
                 'title' => $element['title'],
-                'url' => parent::getURI() . $this->getInput('locale') . '/p/' . $element['urlSlug'],
+                'uri' => parent::getURI() . $this->getInput('locale') . '/p/' . $element['productSlug'],
             ];
             $this->items[] = $item;
         }

From 98e03011dbb80ea9cea3ef8c5e29a1778f169cc9 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 3 Jun 2025 21:24:35 +0200
Subject: [PATCH 664/716] chore: prepare for 2025-06-03 release (#4583)

---
 lib/Configuration.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/Configuration.php b/lib/Configuration.php
index 60bf80fb..79f2922c 100644
--- a/lib/Configuration.php
+++ b/lib/Configuration.php
@@ -7,7 +7,7 @@
  */
 final class Configuration
 {
-    private const VERSION = '2025-01-26';
+    private const VERSION = '2025-06-03';
 
     private static $config = [];
 

From 7aa54602cfe0b5ed2ea91c0588fd80057fa6eb59 Mon Sep 17 00:00:00 2001
From: Tobias Alexander Franke <thefranke@users.noreply.github.com>
Date: Wed, 4 Jun 2025 22:15:28 +0200
Subject: [PATCH 665/716] [FabBridge] Pull 100% discounted items via Fab API
 (#4584)

* [FabBridge] Pull 100% discounted items via Fab API

* [FabBridge] Linter fixes
---
 bridges/FabBridge.php | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 bridges/FabBridge.php

diff --git a/bridges/FabBridge.php b/bridges/FabBridge.php
new file mode 100644
index 00000000..6596f869
--- /dev/null
+++ b/bridges/FabBridge.php
@@ -0,0 +1,43 @@
+<?php
+
+class FabBridge extends BridgeAbstract
+{
+    const NAME = 'Epic Games Fab.com';
+    const URI = 'https://www.fab.com';
+    const DESCRIPTION = 'Limited-Time Free Game Engine Assets';
+    const MAINTAINER = 'thefranke';
+    const CACHE_TIMEOUT = 86400;
+
+    public function collectData()
+    {
+        $url = static::URI . '/i/listings/search?is_discounted=1&is_free=1';
+
+        $header = [
+            'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:139.0) Gecko/20100101 Firefox/139.0',
+            'Accept: application/json, text/plain, */*',
+            'Accept-Language: en',
+            'Accept-Encoding: gzip, deflate, br, zstd',
+            'Referer: ' . static::URI
+        ];
+
+        $json = getContents($url, $header);
+        $json = json_decode($json);
+
+        foreach ($json->results as $item) {
+            $thumbnail = $item->thumbnails[0]->mediaUrl;
+            $itemurl = static::URI . '/listings/' . $item->uid;
+
+            $itemapiurl = static::URI . '/i/listings/' . $item->uid;
+            $itemjson = getContents($itemapiurl, $header);
+            $itemjson = json_decode($itemjson);
+
+            $this->items[] = [
+                'title' => $item->title,
+                'author' => $item->user->sellerName,
+                'uri' => $itemurl,
+                'timestamp' => strtotime($item->lastUpdatedAt),
+                'content' => '<a href="' . $itemurl . '"><img src="' . $thumbnail . '"></a>' . $itemjson->description,
+            ];
+        }
+    }
+}

From 514b3edf0b85c37c69ada3980d355bd6a3c3b052 Mon Sep 17 00:00:00 2001
From: Jonathan Kay <git@jonathankay.com>
Date: Thu, 5 Jun 2025 17:41:20 -0400
Subject: [PATCH 666/716] [GoComicsBridge] Fix for JSON being removed (#4585)

- Now redirects to first comic from landing page
- Switched to meta tags
---
 bridges/GoComicsBridge.php | 26 +++++++++++---------------
 1 file changed, 11 insertions(+), 15 deletions(-)

diff --git a/bridges/GoComicsBridge.php b/bridges/GoComicsBridge.php
index 968c2c4d..a5784091 100644
--- a/bridges/GoComicsBridge.php
+++ b/bridges/GoComicsBridge.php
@@ -31,25 +31,21 @@ class GoComicsBridge extends BridgeAbstract
     public function collectData()
     {
         $link = $this->getURI();
+        $landingpage = getSimpleHTMLDOM($link);
+
+        $link = $landingpage->find('div[data-post-url]', 0)->getAttribute('data-post-url');
 
         for ($i = 0; $i < $this->getInput('limit'); $i++) {
             $html = getSimpleHTMLDOM($link);
-            // get json data from the first page
-            $json = $html->find('div[class^="ShowComicViewer_showComicViewer__comic__"] script[type="application/ld+json"]', 0)->innertext;
-            $data = json_decode($json, false);
+
+            $imagelink = $html->find('meta[property="og:image"]', 0)->content;
+            $parts = explode('/', $link);
+            $date = DateTime::createFromFormat('Y/m/d', implode('/', array_slice($parts, -3)));
+            $title = $html->find('meta[property="og:title"]', 0)->content;
+            preg_match('/by (.*?) for/', $title, $authormatches);
+            $author = $authormatches[1] ?? 'GoComics';
 
             $item = [];
-
-            $author = $data->author->name;
-            $imagelink = $data->contentUrl;
-            $date = $data->datePublished;
-            $title = $data->name . ' - GoComics';
-
-            // get a permlink for this day's comic if there isn't one specified
-            if ($link === $this->getURI()) {
-                $link = $this->getURI() . '/' . DateTime::createFromFormat('F j, Y', $date)->format('Y/m/d');
-            }
-
             $item['id'] = $imagelink;
             $item['uri'] = $link;
             $item['author'] = $author;
@@ -57,7 +53,7 @@ class GoComicsBridge extends BridgeAbstract
             if ($this->getInput('date-in-title') === true) {
                 $item['title'] = $title;
             }
-            $item['timestamp'] = DateTime::createFromFormat('F j, Y', $date)->setTime(0, 0, 0)->getTimestamp();
+            $item['timestamp'] = $date->setTime(0, 0, 0)->getTimestamp();
             $item['content'] = '<img src="' . $imagelink . '" />';
 
             $link = rtrim(self::URI, '/') . $html->find('a[class*="ComicNavigation_controls__button_previous__"]', 0)->href;

From 8dada08e6920eacf387f2b8e0086350760556290 Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Sat, 7 Jun 2025 23:31:02 +0200
Subject: [PATCH 667/716] [IdealoBridge] Bypass bot protection (#4588)

Add some headers (User-Agent, Accept, Accept-Language) and activate
compression to bypass the bot protection
---
 bridges/IdealoBridge.php | 22 ++++++++++++----------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/bridges/IdealoBridge.php b/bridges/IdealoBridge.php
index 55cee467..05a2ebb8 100644
--- a/bridges/IdealoBridge.php
+++ b/bridges/IdealoBridge.php
@@ -35,6 +35,16 @@ class IdealoBridge extends BridgeAbstract
         ]
     ];
 
+    private $headers = [
+        'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:139.0) Gecko/20100101 Firefox/139.0',
+        'Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8',
+        'Accept-Language: fr-FR,fr;q=0.8,en-US;q=0.5,en;q=0.3'
+    ];
+    private $options = [
+        CURLOPT_TRANSFER_ENCODING => 1,
+        CURLOPT_ACCEPT_ENCODING => 'gzip, deflate, br'
+    ];
+
     public function getIcon()
     {
         return 'https://cdn.idealo.com/storage/ids-assets/ico/favicon.ico';
@@ -53,10 +63,7 @@ class IdealoBridge extends BridgeAbstract
 
         // The cache does not contain the title of the bridge, we must get it and save it in the cache
         if ($product === null) {
-            $header = [
-                'user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.2.1 Safari/605.1.15'
-            ];
-            $html = getSimpleHTMLDOM($link, $header);
+            $html = getSimpleHTMLDOM($link, $this->headers, $this->options);
             $product = $html->find('.oopStage-title', 0)->find('span', 0)->plaintext;
             $this->saveCacheValue($keyTITLE, $product);
         }
@@ -123,13 +130,8 @@ class IdealoBridge extends BridgeAbstract
     }
     public function collectData()
     {
-        // Needs header with user-agent to function properly.
-        $header = [
-            'user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.2.1 Safari/605.1.15'
-        ];
-
         $link = $this->getInput('Link');
-        $html = getSimpleHTMLDOM($link, $header);
+        $html = getSimpleHTMLDOM($link, $this->headers, $this->options);
 
         // Get Productname
         $titleobj = $html->find('.oopStage-title', 0);

From 354cea09a7e8fa4bc83c9e118083891a678bad1b Mon Sep 17 00:00:00 2001
From: Jonathan Kay <git@jonathankay.com>
Date: Sun, 8 Jun 2025 15:57:41 -0400
Subject: [PATCH 668/716] [GoComicsBridge] Add fallback when link to current
 comic is missing (#4589)

---
 bridges/GoComicsBridge.php | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/bridges/GoComicsBridge.php b/bridges/GoComicsBridge.php
index a5784091..8e78ce5e 100644
--- a/bridges/GoComicsBridge.php
+++ b/bridges/GoComicsBridge.php
@@ -32,8 +32,20 @@ class GoComicsBridge extends BridgeAbstract
     {
         $link = $this->getURI();
         $landingpage = getSimpleHTMLDOM($link);
-
-        $link = $landingpage->find('div[data-post-url]', 0)->getAttribute('data-post-url');
+        $element = $landingpage->find('div[data-post-url]', 0);
+        if ($element) {
+            $link = $element->getAttribute('data-post-url');
+        } else { // fallback for comics without data-post-url (assumes daily comic)
+            $nextcomiclink = $landingpage->find('a[class*="ComicNavigation_controls__button_previous__"]', 0)->href;
+            preg_match('/(\d{4}\/\d{2}\/\d{2})/', $nextcomiclink, $nclmatches);
+            if (!empty($nclmatches[1])) {
+                $nextdate = new DateTime($nclmatches[1]);
+                $nextdate = $nextdate->modify('+1 day')->format('Y/m/d');
+                $link = $link . '/' . $nextdate;
+            } else {
+                throw new \Exception('Could not find the first comic URL. Please create a new GitHub issue.');
+            }
+        }
 
         for ($i = 0; $i < $this->getInput('limit'); $i++) {
             $html = getSimpleHTMLDOM($link);

From bfbe2abdcef37566a40717375dd105e00037848e Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Wed, 16 Jul 2025 11:50:00 +0000
Subject: [PATCH 669/716] [GolemBridge] Add tables to content

For example the following article has such tables that should be
included:
https://www.golem.de/news/immobilien-mieten-oder-kaufen-warum-es-dabei-nicht-nur-ums-geld-geht-2507-197406.html
---
 bridges/GolemBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/GolemBridge.php b/bridges/GolemBridge.php
index fbd154e3..c908d5fe 100644
--- a/bridges/GolemBridge.php
+++ b/bridges/GolemBridge.php
@@ -152,7 +152,7 @@ class GolemBridge extends FeedExpander
             $img->src = $img->getAttribute('data-src-full');
         }
 
-        foreach ($content->find('p, h1, h2, h3, pre, img[src*="."], iframe, video') as $element) {
+        foreach ($content->find('p, h1, h2, h3, pre, img[src*="."], div[class*="golem_tablediv"], iframe, video') as $element) {
             $item .= $element;
         }
 

From 1d5bcba41fb716c983dc96ccf046527bb56e5152 Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Sat, 19 Jul 2025 23:25:00 +0000
Subject: [PATCH 670/716] [ZeitBridge] Hide magazine ads in articles

Test article: https://www.zeit.de/campus/2025/03/kyoto-university-abschlussfeier-kostueme-japan
---
 bridges/ZeitBridge.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/bridges/ZeitBridge.php b/bridges/ZeitBridge.php
index d4d66a1c..fa2e6fa7 100644
--- a/bridges/ZeitBridge.php
+++ b/bridges/ZeitBridge.php
@@ -89,7 +89,8 @@ class ZeitBridge extends FeedExpander
             $article->find(
                 'aside, .visually-hidden, .carousel-container, #tickaroo-liveblog, .zplus-badge,
                 .article-heading__container--podcast, .podcast-player__image, div[data-paywall],
-                .js-embed-consent, script, nav, .article-flexible-toc__subheading-link, .faq-link'
+                .js-embed-consent, script, nav, .article-flexible-toc__subheading-link, .faq-link,
+                .zoner-article-magazinbox'
             ) as $bad
         ) {
             $bad->remove();

From 4c0b97d60569d064fcfb27fe1504b1207680d8dd Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Sat, 19 Jul 2025 23:29:00 +0000
Subject: [PATCH 671/716] [ZeitBridge] Add advertorial marker to article

So users are aware that it's a paid article.

Some might still find them interesting, so we cannot just filter them
away.
---
 bridges/ZeitBridge.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/bridges/ZeitBridge.php b/bridges/ZeitBridge.php
index fa2e6fa7..3f96d8d6 100644
--- a/bridges/ZeitBridge.php
+++ b/bridges/ZeitBridge.php
@@ -119,6 +119,11 @@ class ZeitBridge extends FeedExpander
         }
 
         $item['content'] = '';
+        // advertorial marker
+        $advert = $article->find('.advertorial-marker', 0);
+        if ($advert) {
+            $item['content'] .= $advert;
+        }
 
         // summary
         $summary = $article->find('.summary');

From 4d2fe2f12de64c3578ad2524e7c186691a8bfc1c Mon Sep 17 00:00:00 2001
From: Petr Prenghy <121161956+pprenghy@users.noreply.github.com>
Date: Sun, 3 Aug 2025 23:46:35 +0200
Subject: [PATCH 672/716] [NasestrechaBridge] Add bridge  (#4591)

* Add files via upload

Bridge for NaseStrecha.cz - NaseStrecha.cz is a specialized Czech news and advice portal focusing on roofs, construction, and home improvement, offering reliable expert guidance on roofing materials, insulation, and energy-saving techniques nasestrecha.cz . It is run by the team behind the Strechy-Solar-Remeslo trade fair and includes up-to-date news, practical tips, and industry events

* phpcs fix

* Bridge for i4wifi.cz for product news.
The website i4wifi.cz is a wholesale distributor specializing in wireless, networking, and photovoltaic equipment, offering products from brands like MikroTik, Ubiquiti, and Hikvision. It provides a wide range of network solutions, technical support, and training services for businesses and professional installers in the Czech Republic and beyond.
---
 bridges/I4wifiBridge.php      | 293 ++++++++++++++++++++++++++++++++++
 bridges/NasestrechaBridge.php | 291 +++++++++++++++++++++++++++++++++
 2 files changed, 584 insertions(+)
 create mode 100644 bridges/I4wifiBridge.php
 create mode 100644 bridges/NasestrechaBridge.php

diff --git a/bridges/I4wifiBridge.php b/bridges/I4wifiBridge.php
new file mode 100644
index 00000000..54620046
--- /dev/null
+++ b/bridges/I4wifiBridge.php
@@ -0,0 +1,293 @@
+<?php
+
+/**
+ *
+ * The website i4wifi.cz is a wholesale distributor specializing in wireless, networking, and photovoltaic equipment, offering products from brands like MikroTik, Ubiquiti, and Hikvision. It provides a wide range of network solutions, technical support, and training services for businesses and professional installers in the Czech Republic and beyond.
+ */
+
+class I4wifiBridge extends BridgeAbstract
+{
+    const NAME = 'i4wifi Bridge';
+    const URI = 'https://www.i4wifi.cz';
+    const DESCRIPTION = 'Product news not only from the wireless, network and security technology sector from i4wifi.cz - Czech Republic';
+    const MAINTAINER = 'pprenghyorg';
+
+    // Only Articles are supported
+    const PARAMETERS = [
+        'Product news' => [
+        ],
+    ];
+
+    /**
+     * Fetches and processes data based on the selected context.
+     *
+     * This function retrieves the HTML content for the specified context's URI,
+     * resolves relative links within the content, and then delegates the data
+     * extraction to the appropriate method (currently only `collectNews`).
+     */
+
+    public function collectData()
+    {
+        $html = getSimpleHTMLDOMCached($this->getURI(), 86400);
+
+        defaultLinkTo($html, static::URI);
+
+        // Router
+        switch ($this->queriedContext) {
+            case 'Product news':
+                $this->collectNews($html);
+                break;
+        }
+    }
+
+    /**
+     * Returns the icon for the bridge.
+     *
+     * @return string The icon URL.
+     */
+    public function getURI()
+    {
+        $uri = static::URI;
+
+        // URI Router
+        switch ($this->queriedContext) {
+            case 'Product news':
+                $uri .= '/';
+                break;
+        }
+
+        return $uri;
+    }
+
+    /**
+     * Returns the name for the bridge.
+     *
+     * @return string The Name.
+     */
+    public function getName()
+    {
+        $name = static::NAME;
+
+        $name .= ($this->queriedContext) ? ' - ' . $this->queriedContext : '';
+
+        switch ($this->queriedContext) {
+            case 'Product news':
+                break;
+        }
+
+        return $name;
+    }
+
+    /**
+     * Parse most used date formats
+     *
+     * Basically strtotime doesn't convert dates correctly due to formats
+     * being hard to interpret. So we use the DateTime object, manually
+     * fixing dates and times (set to 00:00:00.000).
+     *
+     * We don't know the timezone, so just assume +00:00 (or whatever
+     * DateTime chooses)
+     */
+    private function fixDate($date)
+    {
+        $df = $this->parseDateTimeFromString($date);
+
+        return date_format($df, 'U');
+    }
+
+    /**
+     * Extracts the images from the article.
+     *
+     * @param object $article The article object.
+     * @return array An array of image URLs.
+     */
+    private function extractImages($article)
+    {
+        // Notice: We can have zero or more images (though it should mostly be 1)
+        $elements = $article->find('img');
+
+        $images = [];
+
+        foreach ($elements as $img) {
+            $images[] = $img->src;
+        }
+
+        return $images;
+    }
+
+    #region Articles
+
+    /**
+     * Collects uri, timestamp, title, content and images in the news articles from the HTML and transforms to rss.
+     *
+     * @param object $html The HTML object.
+     * @return void
+     */
+    private function collectNews($html)
+    {
+        $articles = $html->find('.timeline-item.timeline-item-right')
+            or returnServerError('No articles found! Layout might have changed!');
+
+        foreach ($articles as $article) {
+            $item = [];
+
+            // get uri of product
+            $item['uri'] = $this->extractNewsUri($article);
+            // Add content
+            $item['content'] = $this->extractNewsDescription($article);
+            // Add images
+            $item['title'] = $this->extractNewsTitle($article);
+            // Add images
+            $item['enclosures'] = $this->extractImages($article);
+            // Add timestamp
+            $item['timestamp'] = $this->extractNewsDate($article);
+
+            // collect sources into rss article
+            $this->items[] = $item;
+        }
+    }
+
+    /**
+     * Extracts the URI of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The URI of the news article.
+     */
+    private function extractNewsUri($article)
+    {
+        // Return URI of the article
+        $element = $article->find('a', 0)
+            or returnServerError('Anchor not found!');
+
+        return $element->href;
+    }
+
+    /**
+     * Extracts the date of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The date of the news article.
+     */
+    private function extractNewsDate($article)
+    {
+        // Check if date is set
+        $element = $article->find('.timeline-item-info', 0)
+            or returnServerError('Date not found!');
+
+        // Format date
+        return $this->fixDate($element->plaintext);
+    }
+
+    /**
+     * Extracts the description of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The description of the news article.
+     */
+    private function extractNewsDescription($article)
+    {
+        // Extract description
+        $element = $article->find('p', 0)
+            or returnServerError('Description not found!');
+
+        return $element->innertext;
+    }
+
+    /**
+     * Extracts the title of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The title of the news article.
+     */
+    private function extractNewsTitle($article)
+    {
+        // Extract title
+        $element = $article->find('img', 0)
+            or returnServerError('Title not found!');
+
+        return $element->alt;
+    }
+
+    /**
+     * It attempts to recognize the date/time format in a string and create a DateTime object.
+     *
+     * It goes through the list of defined formats and tries to apply them to the input string.
+     * Returns the first successfully parsed DateTime object that matches the entire string.
+     *
+     * @param string $dateString A string potentially containing a date and/or time.
+     * @return DateTime|null A DateTime object if successfully recognized and parsed, otherwise null.
+     */
+    private function parseDateTimeFromString(string $dateString): ?DateTime
+    {
+        // List of common formats - YOU CAN AND SHOULD EXPAND IT according to expected inputs!
+        // Order may matter if the formats are ambiguous.
+        // It is recommended to give more specific formats (with time, full year) before more general ones.
+        $possibleFormats = [
+            // Czech formats (day.month.year)
+            'd.m.Y H:i:s',  // 10.04.2025 10:57:47
+            'j.n.Y H:i:s',  // 10.4.2025 10:57:47
+            'd. m. Y H:i:s', // 10. 04. 2025 10:57:47
+            'j. n. Y H:i:s', // 10. 4. 2025 10:57:47
+            'd.m.Y H:i',    // 10.04.2025 10:57
+            'j.n.Y H:i',    // 10.4.2025 10:57
+            'd. m. Y H:i',   // 10. 04. 2025 10:57
+            'j. n. Y H:i',   // 10. 4. 2025 10:57
+            'd.m.Y',        // 10.04.2025
+            'j.n.Y',        // 10.4.2025
+            'd. m. Y',       // 10. 04. 2025
+            'j. n. Y',       // 10. 4. 2025
+
+            // ISO 8601 and international formats (year-month-day)
+            'Y-m-d H:i:s',  // 2025-04-10 10:57:47
+            'Y-m-d H:i',    // 2025-04-10 10:57
+            'Y-m-d',        // 2025-04-10
+            'YmdHis',       // 20250410105747
+            'Ymd',          // 20250410
+
+            // American formats (month/day/year) - beware of ambiguity!
+            'm/d/Y H:i:s',  // 04/10/2025 10:57:47
+            'n/j/Y H:i:s',  // 4/10/2025 10:57:47
+            'm/d/Y H:i',    // 04/10/2025 10:57
+            'n/j/Y H:i',    // 4/10/2025 10:57
+            'm/d/Y',        // 04/10/2025
+            'n/j/Y',        // 4/10/2025
+
+            // Standard formats (including time zone)
+            DateTime::ATOM,             // example. 2025-04-10T10:57:47+02:00
+            DateTime::RFC3339,          // example. 2025-04-10T10:57:47+02:00
+            DateTime::RFC3339_EXTENDED, // example. 2025-04-10T10:57:47.123+02:00
+            DateTime::RFC2822,          // example. Thu, 10 Apr 2025 10:57:47 +0200
+            DateTime::ISO8601,          // example. 2025-04-10T105747+0200
+            'Y-m-d\TH:i:sP',            // ISO 8601 s 'T' oddělovačem
+            'Y-m-d\TH:i:s.uP',          // ISO 8601 s mikrosekundami
+
+            // You can add more formats as needed...
+            // e.g. 'd-M-Y' (10-Apr-2025) - requires English locale
+            // e.g. 'j. F Y' (10. abren 2025) - requires Czech locale
+        ];
+
+            // Set locale for parsing month/day names (if using F, M, l, D)
+            // E.g. setlocale(LC_TIME, 'cs_CZ.UTF-8'); or 'en_US.UTF-8');
+
+        foreach ($possibleFormats as $format) {
+            // We will try to create a DateTime object from the given format
+            $dateTime = DateTime::createFromFormat($format, $dateString);
+
+            // We check that the parsing was successful AND ALSO
+            // that there were no errors or warnings during the parsing.
+            // This is important to ensure that the format matches the ENTIRE string.
+            if ($dateTime !== false) {
+                $errors = DateTime::getLastErrors();
+                if (!($errors)) {
+                    // Success! We found a valid format for the entire string.
+                    return $dateTime;
+                }
+            }
+        }
+
+        // If no format matches or parsing failed
+        return null;
+    }
+
+    #endregion
+}
diff --git a/bridges/NasestrechaBridge.php b/bridges/NasestrechaBridge.php
new file mode 100644
index 00000000..d6510109
--- /dev/null
+++ b/bridges/NasestrechaBridge.php
@@ -0,0 +1,291 @@
+<?php
+
+/**
+ *
+ * NaseStrecha.cz is a specialized Czech news and advice portal focusing on roofs, construction, and home improvement, offering reliable expert guidance on roofing materials, insulation, and energy-saving techniques nasestrecha.cz . It is run by the team behind the Strechy-Solar-Remeslo trade fair and includes up-to-date news, practical tips, and industry events..
+ *
+ */
+
+class NasestrechaBridge extends BridgeAbstract
+{
+    const NAME = 'Nasestrecha Bridge';
+    const URI = 'https://www.nasestrecha.cz/';
+    const DESCRIPTION = 'Articles from Nasestrecha.cz news site - Czech Republic / Spolehlivé informace pro Vaší střechu i stavbu';
+    const MAINTAINER = 'pprenghyorg';
+
+    // Only Articles are supported
+    const PARAMETERS = [
+        'Articles, news and reviews from from construction and housing' => [
+        ],
+    ];
+
+    /**
+     * Fetches and processes data based on the selected context.
+     *
+     * This function retrieves the HTML content for the specified context's URI,
+     * resolves relative links within the content, and then delegates the data
+     * extraction to the appropriate method (currently only `collectNews`).
+     */
+    public function collectData()
+    {
+        $html = getSimpleHTMLDOM($this->getURI());
+
+        defaultLinkTo($html, static::URI);
+
+        // Router
+        switch ($this->queriedContext) {
+            case 'Articles, news and reviews from from construction and housing':
+                $this->collectNews($html);
+                break;
+        }
+    }
+
+    /**
+     * Returns the icon for the bridge.
+     *
+     * @return string The icon URL.
+     */
+    public function getURI()
+    {
+        $uri = static::URI;
+
+        // URI Router
+        switch ($this->queriedContext) {
+            case 'Articles, news and reviews from from construction and housing':
+                $uri .= 'clanky/';
+                break;
+        }
+
+        return $uri;
+    }
+
+    /**
+     * Returns the name for the bridge.
+     *
+     * @return string The Name.
+     */
+    public function getName()
+    {
+        $name = static::NAME;
+
+        $name .= ($this->queriedContext) ? ' - ' . $this->queriedContext : '';
+
+        switch ($this->queriedContext) {
+            case 'Articles, news and reviews from from construction and housing':
+                break;
+        }
+
+        return $name;
+    }
+
+    /**
+     * Parse most used date formats
+     *
+     * Basically strtotime doesn't convert dates correctly due to formats
+     * being hard to interpret. So we use the DateTime object, manually
+     * fixing dates and times (set to 00:00:00.000).
+     *
+     * We don't know the timezone, so just assume +00:00 (or whatever
+     * DateTime chooses)
+     */
+    private function fixDate($date)
+    {
+        $df = $this->parseDateTimeFromString($date);
+
+        return date_format($df, 'U');
+    }
+
+    /**
+     * Extracts the images from the article.
+     *
+     * @param object $article The article object.
+     * @return array An array of image URLs.
+     */
+    private function extractImages($article)
+    {
+        // Notice: We can have zero or more images (though it should mostly be 1)
+        $elements = $article->find('img');
+
+        $images = [];
+
+        foreach ($elements as $img) {
+            $images[] = $img->src;
+        }
+
+        return $images;
+    }
+
+    #region Articles
+
+    /**
+     * Collects uri, timestamp, title, content and images in the news articles from the HTML and transforms to rss.
+     *
+     * @param object $html The HTML object.
+     * @return void
+     */
+    private function collectNews($html)
+    {
+        // Check if page contains articles
+        $articles = $html->find('.post')
+            or returnServerError('No articles found! Layout might have changed!');
+
+        foreach ($articles as $article) {
+            $item = [];
+
+            $item['uri'] = $this->extractNewsUri($article);
+            $item['timestamp'] = $this->extractNewsDate($article);
+            $item['title'] = $this->extractNewsTitle($article);
+            $item['content'] = $this->extractNewsDescription($article);
+            $item['enclosures'] = $this->extractImages($article);
+
+            // collect sources into rss article
+            $this->items[] = $item;
+        }
+    }
+
+    /**
+     * Extracts the URI of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The URI of the news article.
+     */
+    private function extractNewsUri($article)
+    {
+        // Return URI of the article
+        $element = $article->find('.thumbnail', 0)
+            or returnServerError('Anchor not found!');
+
+        return $element->href;
+    }
+
+    /**
+     * Extracts the date of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The date of the news article.
+     */
+    private function extractNewsDate($article)
+    {
+        // Check if date is set
+        $element = $article->find('div.post__info', 0)->find('span', 0)
+            or returnServerError('Date not found!');
+
+        $date = trim(explode('|', $element->plaintext)[0]);
+
+        // Format date
+        return $this->fixDate($date);
+    }
+
+    /**
+     * Extracts the description of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The description of the news article.
+     */
+    private function extractNewsDescription($article)
+    {
+        // Extract description
+        $element = $article->find('p.post__text', 0)
+            or returnServerError('Description not found!');
+
+        return $element->innertext;
+    }
+
+    /**
+     * Extracts the title of the news article.
+     *
+     * @param object $article The article object.
+     * @return string The title of the news article.
+     */
+    private function extractNewsTitle($article)
+    {
+        // Extract title
+        $element = $article->find('a.post__title', 0)
+            or returnServerError('Title not found!');
+
+        return $element->plaintext;
+    }
+
+    /**
+     * It attempts to recognize the date/time format in a string and create a DateTime object.
+     *
+     * It goes through the list of defined formats and tries to apply them to the input string.
+     * Returns the first successfully parsed DateTime object that matches the entire string.
+     *
+     * @param string $dateString A string potentially containing a date and/or time.
+     * @return DateTime|null A DateTime object if successfully recognized and parsed, otherwise null.
+     */
+    private function parseDateTimeFromString(string $dateString): ?DateTime
+    {
+        // List of common formats - YOU CAN AND SHOULD EXPAND IT according to expected inputs!
+        // Order may matter if the formats are ambiguous.
+        // It is recommended to give more specific formats (with time, full year) before more general ones.
+        $possibleFormats = [
+            // Czech formats (day.month.year)
+            'd.m.Y H:i:s',  // 10.04.2025 10:57:47
+            'j.n.Y H:i:s',  // 10.4.2025 10:57:47
+            'd. m. Y H:i:s', // 10. 04. 2025 10:57:47
+            'j. n. Y H:i:s', // 10. 4. 2025 10:57:47
+            'd.m.Y H:i',    // 10.04.2025 10:57
+            'j.n.Y H:i',    // 10.4.2025 10:57
+            'd. m. Y H:i',   // 10. 04. 2025 10:57
+            'j. n. Y H:i',   // 10. 4. 2025 10:57
+            'd.m.Y',        // 10.04.2025
+            'j.n.Y',        // 10.4.2025
+            'd. m. Y',       // 10. 04. 2025
+            'j. n. Y',       // 10. 4. 2025
+
+            // ISO 8601 and international formats (year-month-day)
+            'Y-m-d H:i:s',  // 2025-04-10 10:57:47
+            'Y-m-d H:i',    // 2025-04-10 10:57
+            'Y-m-d',        // 2025-04-10
+            'YmdHis',       // 20250410105747
+            'Ymd',          // 20250410
+
+            // American formats (month/day/year) - beware of ambiguity!
+            'm/d/Y H:i:s',  // 04/10/2025 10:57:47
+            'n/j/Y H:i:s',  // 4/10/2025 10:57:47
+            'm/d/Y H:i',    // 04/10/2025 10:57
+            'n/j/Y H:i',    // 4/10/2025 10:57
+            'm/d/Y',        // 04/10/2025
+            'n/j/Y',        // 4/10/2025
+
+            // Standard formats (including time zone)
+            DateTime::ATOM,             // example. 2025-04-10T10:57:47+02:00
+            DateTime::RFC3339,          // example. 2025-04-10T10:57:47+02:00
+            DateTime::RFC3339_EXTENDED, // example. 2025-04-10T10:57:47.123+02:00
+            DateTime::RFC2822,          // example. Thu, 10 Apr 2025 10:57:47 +0200
+            DateTime::ISO8601,          // example. 2025-04-10T105747+0200
+            'Y-m-d\TH:i:sP',            // ISO 8601 s 'T' oddělovačem
+            'Y-m-d\TH:i:s.uP',          // ISO 8601 s mikrosekundami
+
+            // You can add more formats as needed...
+            // e.g. 'd-M-Y' (10-Apr-2025) - requires English locale
+            // e.g. 'j. F Y' (10. abren 2025) - requires Czech locale
+        ];
+
+            // Set locale for parsing month/day names (if using F, M, l, D)
+            // E.g. setlocale(LC_TIME, 'cs_CZ.UTF-8'); or 'en_US.UTF-8');
+
+        foreach ($possibleFormats as $format) {
+            // We will try to create a DateTime object from the given format
+            $dateTime = DateTime::createFromFormat($format, $dateString);
+
+            // We check that the parsing was successful AND ALSO
+            // that there were no errors or warnings during the parsing.
+            // This is important to ensure that the format matches the ENTIRE string.
+            if ($dateTime !== false) {
+                $errors = DateTime::getLastErrors();
+                if (!($errors)) {
+                    // Success! We found a valid format for the entire string.
+                    return $dateTime;
+                }
+            }
+        }
+
+        // If no format matches or parsing failed
+        return null;
+    }
+
+    #endregion
+}
\ No newline at end of file

From 5ab938ada7631cb81a2e498a3ddb9eb7c76d8109 Mon Sep 17 00:00:00 2001
From: "User." <65943476+Scrub000@users.noreply.github.com>
Date: Mon, 4 Aug 2025 07:49:10 +1000
Subject: [PATCH 673/716] [WaggaCouncilBridge] Add bridge (#4593)

Co-authored-by: Scrub000 <scrub@example.com>
---
 bridges/WaggaCouncilBridge.php | 106 +++++++++++++++++++++++++++++++++
 1 file changed, 106 insertions(+)
 create mode 100644 bridges/WaggaCouncilBridge.php

diff --git a/bridges/WaggaCouncilBridge.php b/bridges/WaggaCouncilBridge.php
new file mode 100644
index 00000000..a5b73392
--- /dev/null
+++ b/bridges/WaggaCouncilBridge.php
@@ -0,0 +1,106 @@
+<?php
+
+class WaggaCouncilBridge extends BridgeAbstract {
+    const NAME = 'Wagga Wagga Council';
+    const URI = 'https://news.wagga.nsw.gov.au/';
+    const DESCRIPTION = 'Wagga Wagga Council updates';
+    const MAINTAINER = 'Scrub000';
+    const CACHE_TIMEOUT = 3600;
+    const PARAMETERS = [
+        [
+            'section' => [
+                'name' => 'Section',
+                'type' => 'list',
+                'values' => [
+                    'Council' => 'council',
+                    'Community' => 'community',
+                    'Projects & Works' => 'projects-and-works',
+                    'Arts & Culture' => 'arts-and-culture',
+                    'Environment' => 'environment',
+                    'Events & Tourism' => 'events-and-tourism',
+                    'Parks & Recreation' => 'parks-and-recreation',
+                ],
+                'defaultValue' => 'council',
+            ],
+        ]
+    ];
+
+    public function getURI(): string {
+        $section = $this->getInput('section') ?: 'council';
+        return urljoin(self::URI, $section);
+    }
+
+    public function collectData(): void {
+        $html = getSimpleHTMLDOM($this->getURI());
+
+        foreach ($html->find('div.container') as $container) {
+            $titleElement = $container->find('h5', 0);
+            $linkElement = $container->find('a', 0);
+            $timeElement = $container->find('small.text-muted', 0);
+
+            if (!$titleElement || !$linkElement || !$timeElement) {
+                continue;
+            }
+
+            $title = trim($titleElement->plaintext);
+            $uri = urljoin(self::URI, $linkElement->href);
+            $timestamp = strtotime(str_replace('Published: ', '', $timeElement->plaintext));
+
+            // Load full article
+            $articleHtml = getSimpleHTMLDOM($uri);
+            $articleContent = '';
+
+            if ($articleHtml) {
+                $article = $articleHtml->find('article.article', 0);
+                if ($article) {
+                    // Remove uneeded content
+                    $selectorsToRemove = [
+                        'button',
+                        'nav',
+                        '.visually-hidden',
+                        '.carousel-control-prev',
+                        '.carousel-control-next',
+                        '.article__heading',
+                        '.article__badge',
+                        'p.text-muted',
+                    ];
+                    
+                    foreach ($selectorsToRemove as $sel) {
+                        foreach ($article->find($sel) as $el) {
+                            $el->outertext = '';
+                        }
+                    }
+            
+                    foreach ($article->find('iframe') as $iframe) {
+                        $src = $iframe->getAttribute('src');
+                        $iframe->outertext = '<p><a href="' . htmlspecialchars($src) . '">Embedded content: ' . htmlspecialchars($src) . '</a></p>';
+                    }
+                    
+                    // Enhance list rendering
+                    foreach ($article->find('ul') as $ul) {
+                        $ul->style = 'margin-left: 1em; padding-left: 1em;';
+                    }
+                    foreach ($article->find('li') as $li) {
+                        $li->innertext = '• ' . $li->innertext;
+                    }
+
+                    foreach ($article->children() as $node) {
+                        // Skip <p> that contains <figure> to avoid duplication
+                        if ($node->tag === 'p' && $node->find('figure', 0)) {
+                            continue;
+                        }
+                        $articleContent .= $node->outertext;
+                    }
+                }
+            }
+
+            $this->items[] = [
+                'title' => $title,
+                'uri' => $uri,
+                'author' => 'Wagga Wagga City Council',
+                'timestamp' => $timestamp,
+                'content' => $articleContent,
+            ];
+        }
+    }
+}

From bfa6c4c080bbf3108fcb5a55171bcf2c770087fc Mon Sep 17 00:00:00 2001
From: Tone <66808319+Tone866@users.noreply.github.com>
Date: Sun, 3 Aug 2025 23:50:54 +0200
Subject: [PATCH 674/716] [HeiseBridge] removes language-info-text, add
 archive.is link for people without subscription (#4594)

* [HeiseBridge] removes language-info-text, add archive.is link for people without subscription

* fix annoying phpcs
---
 bridges/HeiseBridge.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/bridges/HeiseBridge.php b/bridges/HeiseBridge.php
index 82c1f1aa..b3bbf76b 100644
--- a/bridges/HeiseBridge.php
+++ b/bridges/HeiseBridge.php
@@ -138,6 +138,7 @@ class HeiseBridge extends FeedExpander
         }
         // abort on heise+ articles
         if ($sessioncookie == '' && str_starts_with($item['title'], 'heise+ |')) {
+            $item['uri'] = 'https://archive.is/' . $item['uri'];
             return $item;
         }
 
@@ -162,7 +163,7 @@ class HeiseBridge extends FeedExpander
         // remove unwanted stuff
         foreach (
             $article->find('figure.branding, figure.a-inline-image, a-ad, div.ho-text, a-img,
-            .a-toc__list, a-collapse, .opt-in__description, .opt-in__footnote') as $element
+            .a-toc__list, a-collapse, .opt-in__description, .opt-in__footnote, .notice-banner__text, .notice-banner__link') as $element
         ) {
             $element->remove();
         }

From 8e880de3d276e024583b285994edae73d675c6d9 Mon Sep 17 00:00:00 2001
From: "Quentin B." <quent1-fr@users.noreply.github.com>
Date: Sun, 3 Aug 2025 23:52:06 +0200
Subject: [PATCH 675/716] [CentreFranceBridge] Fix parser following website
 update (#4596)

* [CentreFranceBridge] Fix parser following website update

* [CentreFranceBridge] Fix empty content

* [CentreFranceBridge] Fix title parsing
---
 bridges/CentreFranceBridge.php | 38 ++++++++++++++++++----------------
 1 file changed, 20 insertions(+), 18 deletions(-)

diff --git a/bridges/CentreFranceBridge.php b/bridges/CentreFranceBridge.php
index 1abfae98..9f30b44a 100644
--- a/bridges/CentreFranceBridge.php
+++ b/bridges/CentreFranceBridge.php
@@ -72,15 +72,9 @@ class CentreFranceBridge extends BridgeAbstract
         $newspaperUrl = 'https://www.' . $this->getInput('newspaper') . '/' . $localitySlug . '/';
         $html = getSimpleHTMLDOM($newspaperUrl);
 
-        // Articles are detected through their titles
-        foreach ($html->find('.c-titre') as $articleTitleDOMElement) {
-            $articleLinkDOMElement = $articleTitleDOMElement->find('a', 0);
-
-            // Ignore articles in the « Les + partagés » block
-            if (strpos($articleLinkDOMElement->id, 'les_plus_partages') !== false) {
-                continue;
-            }
-
+        // Articles are detected through a standard tag
+        foreach ($html->find('article') as $articleDOMElement) {
+            $articleLinkDOMElement = $articleDOMElement->find('a', 0);
             $articleURI = $articleLinkDOMElement->href;
 
             // If the URI has already been processed, ignore it
@@ -96,7 +90,7 @@ class CentreFranceBridge extends BridgeAbstract
             $articleTitle = '';
 
             // If article is reserved for subscribers
-            if ($articleLinkDOMElement->find('span.premium-picto', 0)) {
+            if ($articleLinkDOMElement->find('span.premium-icon', 0)) {
                 if ($this->getInput('remove-reserved-for-subscribers-articles') === true) {
                     continue;
                 }
@@ -104,18 +98,22 @@ class CentreFranceBridge extends BridgeAbstract
                 $articleTitle .= '🔒 ';
             }
 
-            $articleTitleDOMElement = $articleLinkDOMElement->find('span[data-tb-title]', 0);
-            if ($articleTitleDOMElement === null) {
-                continue;
-            }
-
             if ($limit > 0 && count($this->items) === $limit) {
                 break;
             }
 
-            $articleTitle .= $articleLinkDOMElement->find('span[data-tb-title]', 0)->innertext;
-            $articleFullURI = urljoin('https://www.' . $this->getInput('newspaper') . '/', $articleURI);
+            // Loop through each possible title class name
+            for ($i = 1; $i <= 3; $i++) {
+                $articleTitleDOMElement = $articleLinkDOMElement->find('.typo-card-title-' . $i, 0);
+                if (!$articleTitleDOMElement instanceof \simple_html_dom_node) {
+                    continue;
+                }
 
+                $articleTitle .= $articleTitleDOMElement->text();
+                break;
+            }
+
+            $articleFullURI = urljoin('https://www.' . $this->getInput('newspaper') . '/', $articleURI);
             $item = [
                 'title' => $articleTitle,
                 'uri' => $articleFullURI,
@@ -184,7 +182,7 @@ class CentreFranceBridge extends BridgeAbstract
 
         $articleTags = $html->find('#content>div.flex+div.grid section>.bg-gray-light>a.border-gray-dark');
         if (is_array($articleTags)) {
-            $item['categories'] = array_map(static fn ($articleTag) => $articleTag->innertext, $articleTags);
+            $item['categories'] = array_map(static fn ($articleTag) => html_entity_decode($articleTag->innertext), $articleTags);
         }
 
         $explode = explode('_', $uri);
@@ -195,6 +193,10 @@ class CentreFranceBridge extends BridgeAbstract
             $item['uid'] = $uid;
         }
 
+        if (!isset($item['content'])) {
+            $item['content'] = '';
+        }
+
         // If the article is a "grand format", we use another parsing strategy
         if ($item['content'] === '' && $html->find('article') !== []) {
             $articleContent = $html->find('article > section');

From c90b98b965aa14e244c7389dae63f1603b3296df Mon Sep 17 00:00:00 2001
From: Sebastian K <s.kroll@basecom.de>
Date: Sun, 3 Aug 2025 23:58:24 +0200
Subject: [PATCH 676/716] Error handling in ExplosmBridge (#4600)

Skip further processing if element was not found to avoid errors
---
 bridges/ExplosmBridge.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/bridges/ExplosmBridge.php b/bridges/ExplosmBridge.php
index 0312a4c4..ae197e2b 100644
--- a/bridges/ExplosmBridge.php
+++ b/bridges/ExplosmBridge.php
@@ -36,6 +36,9 @@ class ExplosmBridge extends BridgeAbstract
             $html = getSimpleHTMLDOM($url);
 
             $element = $html->find('[class*=ComicImage]', 0);
+            if(!$element) {
+                break; // skip, if element was not found
+            }
             $date    = $element->find('[class^=Author__Right] p', 0)->plaintext;
             $author  = str_replace('by ', '', $element->find('[class^=Author__Right] p', 1)->plaintext);
             $image   = $element->find('img', 0)->src;

From 2ca696c1cfd533d99e914744112f0350757b052e Mon Sep 17 00:00:00 2001
From: Anton Smirnov <sandfox+git@sandfox.me>
Date: Mon, 4 Aug 2025 00:59:42 +0300
Subject: [PATCH 677/716] [EpicGamesFreeBridge] productSlug can be null; also
 add a universal future-proof-ish fallback (#4595)

* productSlug can be null, do more discovery, add fallback

* productSlug can be garbage too, remove it completely
---
 bridges/EpicGamesFreeBridge.php | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/bridges/EpicGamesFreeBridge.php b/bridges/EpicGamesFreeBridge.php
index 3b16cd5b..6944ae2e 100644
--- a/bridges/EpicGamesFreeBridge.php
+++ b/bridges/EpicGamesFreeBridge.php
@@ -59,13 +59,20 @@ class EpicGamesFreeBridge extends BridgeAbstract
             ) {
                 continue;
             }
+            $slug = $element['catalogNs']['mappings'][0]['pageSlug'] ?? null;
+            if ($slug !== null) {
+                $uri = parent::getURI() . $this->getInput('locale') . '/p/' . $slug;
+            } else {
+                // slug not found, show the root promos page
+                $uri = parent::getURI() . $this->getInput('locale') . '/free-games';
+            }
             $item = [
                 'author' => $element['seller']['name'],
                 'content' => $element['description'],
                 'enclosures' => array_map(fn($item) => $item['url'], $element['keyImages']),
                 'timestamp' => strtotime($promo['startDate']),
                 'title' => $element['title'],
-                'uri' => parent::getURI() . $this->getInput('locale') . '/p/' . $element['productSlug'],
+                'uri' => $uri,
             ];
             $this->items[] = $item;
         }

From 71808aaa8119b7455b248f9b34710fbf67a052f8 Mon Sep 17 00:00:00 2001
From: Tobias Alexander Franke <thefranke@users.noreply.github.com>
Date: Mon, 4 Aug 2025 00:10:58 +0200
Subject: [PATCH 678/716] [WarhammerComBridge] Bridge for Warhammer Community
 blog (#4610)

* [WarhammerComBridge] Bridge for Warhammer Community blog

* Fix Linter issues
---
 bridges/WarhammerComBridge.php | 51 ++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 bridges/WarhammerComBridge.php

diff --git a/bridges/WarhammerComBridge.php b/bridges/WarhammerComBridge.php
new file mode 100644
index 00000000..e37635de
--- /dev/null
+++ b/bridges/WarhammerComBridge.php
@@ -0,0 +1,51 @@
+<?php
+
+class WarhammerComBridge extends BridgeAbstract
+{
+    const NAME = 'Warhammer Community Blog';
+    const URI = 'https://www.warhammer-community.com';
+    const DESCRIPTION = 'Warhammer Community Blog';
+    const MAINTAINER = 'thefranke';
+    const CACHE_TIMEOUT = 86400;
+
+    public function collectData()
+    {
+        $url = static::URI . '/api/search/news/';
+
+        $header = [
+            'Content-Type: application/json',
+        ];
+
+        $data = '{"sortBy":"date_desc","category":"","collections":["articles"],"game_systems":[],"index":"news","locale":"en-gb","page":0,"perPage":16,"topics":[]}';
+
+        $opts = [
+            CURLOPT_POST => true,
+            CURLOPT_POSTFIELDS => $data,
+            CURLOPT_RETURNTRANSFER => true
+        ];
+
+        $json = getContents($url, $header, $opts);
+        $json = json_decode($json);
+
+        foreach ($json->news as $article) {
+            $articleurl = static::URI . $article->uri;
+
+            $fullarticle = getSimpleHTMLDOMCached($articleurl);
+            $content = $fullarticle->find('.article-content', 0);
+
+            $categories = [];
+            foreach ($article->topics as $topic) {
+                $categories[] = $topic->title;
+            }
+
+            $this->items[] = [
+                'title' => $article->title,
+                'uri' => static::URI . $article->uri,
+                'timestamp' => strtotime($article->date),
+                'content' => $content,
+                'uid' => $article->uuid,
+                'categories' => $categories
+            ];
+        }
+    }
+}

From c7de5c95bebf8cfad923ac7d4f5c2f74ae8f4a8e Mon Sep 17 00:00:00 2001
From: Nomis <chatainsim@gmail.com>
Date: Mon, 4 Aug 2025 00:12:38 +0200
Subject: [PATCH 679/716] Update 06_Public_Hosts.md (#4614)

Remove bridge.easter.fr
---
 docs/01_General/06_Public_Hosts.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/01_General/06_Public_Hosts.md b/docs/01_General/06_Public_Hosts.md
index a4eca61d..71f6fdd6 100644
--- a/docs/01_General/06_Public_Hosts.md
+++ b/docs/01_General/06_Public_Hosts.md
@@ -7,7 +7,6 @@
 | ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://rss-bridge.cheredeprince.net | ![](https://img.shields.io/website/https/rss-bridge.cheredeprince.net) | [@La_Bécasse](https://cheredeprince.net/contact) | Self-Hosted at home in France |
 | ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://rss-bridge.sans-nuage.fr | ![](https://img.shields.io/website/https/rss-bridge.sans-nuage.fr) | [@Alsace Réseau Neutre](https://arn-fai.net/contact) | Hosted in Alsace, France |
 | ![](https://iplookup.flagfox.net/images/h16/GB.png) | https://rss-bridge.lewd.tech | ![](https://img.shields.io/website/https/rss-bridge.lewd.tech.svg) | [@Erisa](https://github.com/Erisa) | Hosted in London, protected by Cloudflare Rate Limiting |
-| ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://bridge.easter.fr | ![](https://img.shields.io/website/https/bridge.easter.fr.svg) | [@chatainsim](https://github.com/chatainsim) | Hosted in Isère, France |
 | ![](https://iplookup.flagfox.net/images/h16/FR.png) | https://wtf.roflcopter.fr/rss-bridge | ![](https://img.shields.io/website/https/wtf.roflcopter.fr/rss-bridge.svg) | [roflcopter.fr](https://wtf.roflcopter.fr/) | Hosted in France |
 | ![](https://iplookup.flagfox.net/images/h16/DE.png) | https://rss.nixnet.services | ![](https://img.shields.io/website/https/rss.nixnet.services.svg) | [@amolith](https://nixnet.services/contact) | Hosted in Wunstorf, Germany |
 | ![](https://iplookup.flagfox.net/images/h16/AT.png) | https://rss-bridge.ggc-project.de | ![](https://img.shields.io/website/https/rss-bridge.ggc-project.de) | [@ggc-project.de](https://social.dev-wiki.de/@ggc_project) | Hosted in Steyr, Austria |

From 3835f290c1fe2a1318e22039cbd003b2c733ee21 Mon Sep 17 00:00:00 2001
From: jaydeethree <34945248+jaydeethree@users.noreply.github.com>
Date: Sun, 3 Aug 2025 15:14:51 -0700
Subject: [PATCH 680/716] Update GOGBridge to use GOG's REST API. I have tested
 this locally and it seems to work correctly. (#4616)

---
 bridges/GOGBridge.php | 21 ++++++---------------
 1 file changed, 6 insertions(+), 15 deletions(-)

diff --git a/bridges/GOGBridge.php b/bridges/GOGBridge.php
index eacff97f..ff713a96 100644
--- a/bridges/GOGBridge.php
+++ b/bridges/GOGBridge.php
@@ -9,20 +9,19 @@ class GOGBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $values = getContents('https://www.gog.com/games/ajax/filtered?limit=25&sort=new');
+        $values = getContents('https://catalog.gog.com/v1/catalog?limit=48&order=desc%3AstoreReleaseDate');
         $decodedValues = json_decode($values);
 
         $limit = 0;
         foreach ($decodedValues->products as $game) {
             $item = [];
-            $item['author'] = $game->developer . ' / ' . $game->publisher;
+            $item['author'] = implode(', ', $game->developers) . ' / ' . implode(', ', $game->publishers);
             $item['title'] = $game->title;
             $item['id'] = $game->id;
-            $item['uri'] = self::URI . $game->url;
+            $item['uri'] = $game->storeLink;
             $item['content'] = $this->buildGameContentPage($game);
-            $item['timestamp'] = $game->globalReleaseDate;
 
-            foreach ($game->gallery as $image) {
+            foreach ($game->screenshots as $image) {
                 $item['enclosures'][] = $image . '.jpg';
             }
 
@@ -42,18 +41,10 @@ class GOGBridge extends BridgeAbstract
         $gameDescriptionValue = json_decode($gameDescriptionText);
 
         $content = 'Genres: ';
-        $content .= implode(', ', $game->genres);
+        $content .= implode(', ', array_column($game->genres, 'name'));
 
         $content .= '<br />Supported Platforms: ';
-        if ($game->worksOn->Windows) {
-            $content .= 'Windows ';
-        }
-        if ($game->worksOn->Mac) {
-            $content .= 'Mac ';
-        }
-        if ($game->worksOn->Linux) {
-            $content .= 'Linux ';
-        }
+        $content .= implode(', ', $game->operatingSystems);
 
         $content .= '<br />' . $gameDescriptionValue->description->full;
 

From e394be7ca5cdb472209c215a83544ce4897bfac3 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Sun, 3 Aug 2025 18:16:14 -0400
Subject: [PATCH 681/716] [KemonoBridge] Add search query support (#4620)

---
 bridges/KemonoBridge.php | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/bridges/KemonoBridge.php b/bridges/KemonoBridge.php
index e333b574..27c11a25 100644
--- a/bridges/KemonoBridge.php
+++ b/bridges/KemonoBridge.php
@@ -24,6 +24,11 @@ class KemonoBridge extends BridgeAbstract
             'name' => 'User ID/Name',
             'exampleValue' => '9069743', # Thomas Joy
             'required' => true,
+        ],
+        'q' => [
+            'name' => 'Search query',
+            'exampleValue' => 'classic',
+            'required' => false,
         ]
     ]];
 
@@ -33,13 +38,17 @@ class KemonoBridge extends BridgeAbstract
     {
         $api = parent::getURI() . 'api/v1/';
         $url = $api . $this->getInput('service') . '/user/' . $this->getInput('user');
+
+        $api_response = getContents($url . '/profile');
+        $profile = Json::decode($api_response);
+        $this->title = ucfirst($profile['name']);
+
+        if ($this->getInput('q')) {
+            $url .= '?q=' . urlencode($this->getInput('q'));
+        }
         $api_response = getContents($url);
         $json = Json::decode($api_response);
 
-        $url .= '/profile';
-        $api_response = getContents($url);
-        $profile = Json::decode($api_response);
-        $this->title = ucfirst($profile['name']);
 
         foreach ($json as $element) {
             $item = [];

From 696aed22ccde5e2b9a0b02d97854e260e4d6ec69 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Sun, 3 Aug 2025 18:16:30 -0400
Subject: [PATCH 682/716] [CubariProxyBridge] Replace MangaSee with WeebCentral
 (#4618)

---
 bridges/CubariProxyBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/CubariProxyBridge.php b/bridges/CubariProxyBridge.php
index 8afd2275..fbc7e365 100644
--- a/bridges/CubariProxyBridge.php
+++ b/bridges/CubariProxyBridge.php
@@ -15,7 +15,7 @@ class CubariProxyBridge extends BridgeAbstract
                 'MangAventure' => 'mangadventure',
                 'MangaDex' => 'mangadex',
                 'MangaKatana' => 'mangakatana',
-                'MangaSee' => 'mangasee',
+                'WeebCentral' => 'weebcentral',
             ]
         ],
         'series' => [

From 52be29d3eccaa9f857d9c27185c57d79d085cd6c Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Sun, 3 Aug 2025 18:17:01 -0400
Subject: [PATCH 683/716] [AnnasArchiveBridge] Fix book list CSS selector
 (#4619)

---
 bridges/AnnasArchiveBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/AnnasArchiveBridge.php b/bridges/AnnasArchiveBridge.php
index b857fadf..4a1c3e91 100644
--- a/bridges/AnnasArchiveBridge.php
+++ b/bridges/AnnasArchiveBridge.php
@@ -126,7 +126,7 @@ class AnnasArchiveBridge extends BridgeAbstract
             return;
         }
 
-        $elements = $list->find('.w-full > .mb-4 > div');
+        $elements = $list->find('#aarecord-list > div');
         foreach ($elements as $element) {
             // stop added entries once partial match list starts
             if (str_contains($element->innertext, 'partial match')) {

From 3517cda4a5d84ed356462d0131bc1b9a0b325120 Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Sun, 3 Aug 2025 18:17:30 -0400
Subject: [PATCH 684/716] [YouTubeFeedExpanderBridge] More reliable channel
 icons (#4622)

---
 bridges/YouTubeFeedExpanderBridge.php | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/bridges/YouTubeFeedExpanderBridge.php b/bridges/YouTubeFeedExpanderBridge.php
index 953674ec..3811d960 100644
--- a/bridges/YouTubeFeedExpanderBridge.php
+++ b/bridges/YouTubeFeedExpanderBridge.php
@@ -38,12 +38,7 @@ class YouTubeFeedExpanderBridge extends FeedExpander
     {
         if ($this->getInput('channel') != null) {
             $html = getSimpleHTMLDOMCached($this->getURI());
-            $scriptRegex = '/var ytInitialData = (.*?);<\/script>/';
-            $result = preg_match($scriptRegex, $html, $matches);
-            if (isset($matches[1])) {
-                $json = json_decode($matches[1]);
-                return $json->metadata->channelMetadataRenderer->avatar->thumbnails[0]->url;
-            }
+            return $html->find('[itemprop="thumbnailUrl"]', 0)->href;
         }
         return parent::getIcon();
     }

From 9ec6ae39a2091928945d1c8430c7eb8bc3e53ddb Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Sun, 3 Aug 2025 18:19:08 -0400
Subject: [PATCH 685/716] [ComickBridge] Add new bridge (#4625)

Makes new brige for manga from comick.io. Like the CubariProxyBridge,
can provide manga page images in feed entry content or enclosures.
---
 bridges/ComickBridge.php | 186 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 186 insertions(+)
 create mode 100644 bridges/ComickBridge.php

diff --git a/bridges/ComickBridge.php b/bridges/ComickBridge.php
new file mode 100644
index 00000000..8fd26cd1
--- /dev/null
+++ b/bridges/ComickBridge.php
@@ -0,0 +1,186 @@
+<?php
+
+class ComickBridge extends BridgeAbstract
+{
+    const MAINTAINER = 'phantop';
+    const NAME = 'Comick';
+    const URI = 'https://comick.io/';
+    const DESCRIPTION = 'Returns the latest chapters for a manga on comick.io.';
+    const PARAMETERS = [[
+        'slug' => [
+            'name' => 'Manga Slug',
+            'type' => 'text',
+            'required' => true,
+            'title' => 'The part of the URL after /comic/',
+            'exampleValue' => '00-kusuriya-no-hitorigoto-maomao-no-koukyuu-nazotoki-techou'
+        ],
+        'lang' => [
+            'name' => 'Language',
+            'type' => 'list',
+            'title' => 'Language for comic (list is # of comics, descending)',
+            'values' => [
+                'English' => 'en',
+                'Brazilian Portuguese' => 'pt-br',
+                'Spanish Latin American' => 'es-la',
+                'Russian' => 'ru',
+                'Vietnamese' => 'vi',
+                'French' => 'fr',
+                'Polish' => 'pl',
+                'Indonesian' => 'id',
+                'Turkish' => 'tr',
+                'Italian' => 'it',
+                'Spanish; Castilian' => 'es',
+                'Ukrainian' => 'uk',
+                'Arabic' => 'ar',
+                'Hong Kong (Traditional Chinese)' => 'zh-hk',
+                'Hungarian' => 'hu',
+                'Chinese' => 'zh',
+                'German' => 'de',
+                'Korean' => 'ko',
+                'Thai' => 'th',
+                'Catalan; Valencian' => 'ca',
+                'Bulgarian' => 'bg',
+                'Persian' => 'fa',
+                'Romanian, Moldavian, Moldovan' => 'ro',
+                'Czech' => 'cs',
+                'Mongolian' => 'mn',
+                'Portuguese' => 'pt',
+                'Hebrew (modern)' => 'he',
+                'Hindi' => 'hi',
+                'Filipino/Tagalog' => 'tl',
+                'Finnish' => 'fi',
+                'Malay' => 'ms',
+                'Basque' => 'eu',
+                'Kazakh' => 'kk',
+                'Serbian' => 'sr',
+                'Burmese' => 'my',
+                'Japanese' => 'ja',
+                'Greek, Modern' => 'el',
+                'Dutch' => 'nl',
+                'Bengali' => 'bn',
+                'Uzbek' => 'uz',
+                'Esperanto' => 'eo',
+                'Lithuanian' => 'lt',
+                'Georgian' => 'ka',
+                'Danish' => 'da',
+                'Tamil' => 'ta',
+                'Swedish' => 'sv',
+                'Belarusian' => 'be',
+                'Chuvash' => 'cv',
+                'Croatian' => 'hr',
+                'Latin' => 'la',
+                'Nepali' => 'ne',
+                'Urdu' => 'ur',
+                'Galician' => 'gl',
+                'Norwegian' => 'no',
+                'Albanian' => 'sq',
+                'Irish' => 'ga',
+                'Javanese' => 'jv',
+                'Telugu' => 'te',
+                'Slovene' => 'sl',
+                'Estonian' => 'et',
+                'Azerbaijani' => 'az',
+                'Slovak' => 'sk',
+                'Afrikaans' => 'af',
+                'Latvian' => 'lv',
+            ],
+            'defaultValue' => 'en'
+        ],
+        'fetch' => [
+            'name' => 'Fetch chapter page images',
+            'type' => 'list',
+            'title' => 'Places chapter images in feed contents. Entries will consume more bandwidth.',
+            'defaultValue' => 'c',
+            'values' => [
+                'None' => 'n',
+                'Content' => 'c',
+                'Enclosure' => 'e'
+            ]
+        ],
+        'limit' => [
+            'name' => 'Limit',
+            'type' => 'number',
+            'title' => 'Maximum number of chapters to return',
+            'defaultValue' => 10
+        ]
+    ]];
+
+    private $title;
+
+    private function getComick($url)
+    {
+        $API = 'https://api.comick.fun';
+
+        // Need a non-cURL UA, otherwise we get Cloudflare 403'd
+        $opts = [
+            CURLOPT_USERAGENT => 'rss-bridge (https://github.com/RSS-Bridge/rss-bridge)'
+        ];
+        $content = getContents("$API/$url", [], $opts);
+        return json_decode($content, true);
+    }
+
+    public function collectData()
+    {
+        $slug = $this->getInput('slug');
+        $lang = $this->getInput('lang');
+        $limit = $this->getInput('limit');
+
+        $manga = $this->getComick("comic/$slug");
+        $hid = $manga['comic']['hid'];
+        $this->title = $manga['comic']['title'];
+        $manga = $this->getComick("comic/$hid/chapters?lang=$lang&limit=$limit");
+
+        foreach ($manga['chapters'] as $chapter) {
+            $hid = $chapter['hid'];
+            $item['author'] = implode(', ', $chapter['group_name']);
+            $item['timestamp'] = strtotime($chapter['created_at']);
+            $item['uri'] = $this->getURI() . '/' . $hid;
+
+            $item['title'] = '';
+            if ($chapter['vol']) {
+                $item['title'] .= ' Vol. ' . $chapter['vol'];
+            }
+            if ($chapter['chap']) {
+                $item['title'] .= ' Ch. ' . $chapter['chap'];
+            }
+            if ($chapter['title']) {
+                $item['title'] .= ' - ' . $chapter['title'];
+            }
+
+
+            if ($this->getInput('fetch') != 'n') {
+                $chapter = $this->getComick("chapter/$hid");
+                if (isset($chapter['chapter']['md_images'])) {
+                    $item['content'] = '';
+                    foreach ($chapter['chapter']['md_images'] as $image) {
+                        $img = 'https://meo.comick.pictures/' . $image['b2key'];
+                        if ($this->getInput('fetch') == 'c') {
+                            $item['content'] .= '<img src="' . $img . '" />';
+                        }
+                        if ($this->getInput('fetch') == 'e') {
+                            $item['enclosures'][] = $img;
+                        }
+                    }
+                }
+            }
+
+            $this->items[] = $item;
+        }
+    }
+
+    public function getName()
+    {
+        if ($this->title) {
+            return parent::getName() . ' - ' . $this->title;
+        }
+        return parent::getName();
+    }
+
+    public function getURI()
+    {
+        if ($this->getInput('slug')) {
+            return self::URI . 'comic/' . $this->getInput('slug');
+        }
+        return parent::getURI();
+    }
+}

From 8ae2c2e3c35a3dcb57b1861bfbb3d99d664a7cde Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Sun, 3 Aug 2025 18:20:00 -0400
Subject: [PATCH 686/716] [HumbleBundleBridge] Overhaul to include more
 information (#4621)

* [HumbleBundleBridge] Overhaul to include more information

* [HumbleBundleBridge] Remove use of named args in calls

PHP 7.4 lacks named arg support and fails unit tests
---
 bridges/HumbleBundleBridge.php | 89 +++++++++++++++++++++++++++++-----
 1 file changed, 77 insertions(+), 12 deletions(-)

diff --git a/bridges/HumbleBundleBridge.php b/bridges/HumbleBundleBridge.php
index 42e025a5..28be3ad3 100644
--- a/bridges/HumbleBundleBridge.php
+++ b/bridges/HumbleBundleBridge.php
@@ -34,25 +34,90 @@ class HumbleBundleBridge extends BridgeAbstract
         }
 
         foreach ($products as $element) {
-            $item = [];
-            $item['author'] = $element['author'];
-            $item['timestamp'] = $element['start_date|datetime'];
-            $item['title'] = $element['tile_short_name'];
-            $item['uid'] = $element['machine_name'];
-            $item['uri'] = parent::getURI() . $element['product_url'];
+            $dom = new simple_html_dom();
+            $body = $dom->createElement('div');
+            $item = [
+                'author' => $element['author'],
+                'categories' => $element['hover_highlights'],
+                'content' => $body,
+                'timestamp' => $element['start_date|datetime'],
+                'title' => $element['tile_short_name'],
+                'uid' => $element['machine_name'],
+                'uri' => parent::getURI() . $element['product_url'],
+            ];
 
-            $item['content'] = $element['marketing_blurb'];
-            $item['content'] .= '<br>' . $element['detailed_marketing_blurb'];
-
-            $item['categories'] = $element['hover_highlights'];
             array_unshift($item['categories'], explode(':', $element['tile_name'])[0]);
             array_unshift($item['categories'], $element['tile_stamp']);
 
-            $item['enclosures'] = [$element['tile_logo'], $element['high_res_tile_image']];
-            $this->items[] = $item;
+            $this->createChild($dom, $body, 'img', null, ['src' => $element['tile_logo']]);
+            $this->createChild($dom, $body, 'img', null, ['src' => $element['high_res_tile_image']]);
+            $this->createChild($dom, $body, 'h2', $element['short_marketing_blurb']);
+            $this->createChild($dom, $body, 'p', $element['detailed_marketing_blurb']);
+
+            $this->items[] = $this->processBundle($item, $dom, $body);
         }
     }
 
+    private function createChild($dom, $body, $name = null, $val = null, $args = [])
+    {
+        if ($name == null) {
+            $elem = $dom->createTextNode($val);
+        } else {
+            $elem = $dom->createElement($name, $val);
+        }
+        foreach ($args as $arg => $val) {
+            $elem->setAttribute($arg, $val);
+        }
+        $body->appendChild($elem);
+        return $elem;
+    }
+
+    private function processBundle($item, $dom, $body)
+    {
+        $page = getSimpleHTMLDOMCached($item['uri']);
+        $json_text = $page->find('#webpack-bundle-page-data', 0)->innertext;
+        $json = json_decode(html_entity_decode($json_text), true)['bundleData'];
+        $tiers = $json['tier_display_data'];
+        ksort($tiers, SORT_NATURAL);
+        # `initial` element gets sorted to the end as bt# (bundle tiers) precede it alphabetically
+        array_unshift($tiers, array_pop($tiers));
+
+        $seen = [];
+        $toc = $this->createChild($dom, $body, 'ul');
+        foreach ($tiers as $tiername => $tier) {
+            $this->createChild($dom, $body, 'h2', $tier['header'], ['id' => $tiername]);
+            $li = $this->createChild($dom, $toc, 'li');
+            $this->createChild($dom, $li, 'a', $tier['header'], ['href' => "#$tiername"]);
+            $toc_tier = $this->createChild($dom, $toc, 'ul');
+            foreach ($tier['tier_item_machine_names'] as $name) {
+                if (in_array($name, $seen)) {
+                    continue;
+                }
+                array_push($seen, $name);
+
+                $element = $json['tier_item_data'][$name];
+                $head = $this->createChild($dom, $body, 'h3', null, ['id' => $name]);
+                $head_link = $this->createChild($dom, $head, 'a', $element['human_name'], ['id' => $name]);
+                $li = $this->createChild($dom, $toc_tier, 'li');
+                $this->createChild($dom, $li, 'a', $element['human_name'], ['href' => "#$name"]);
+                $this->createChild($dom, $body, 'img', null, ['src' => $element['resolved_paths']['featured_image']]);
+                $this->createChild($dom, $body, 'img', null, ['src' => $element['resolved_paths']['preview_image']]);
+                $this->createChild($dom, $body, 'br');
+                if ($element['description_text']) {
+                    $body->appendChild(str_get_html($element['description_text'])->root);
+                }
+                if ($element['youtube_link']) {
+                    $head_link->href = 'https://youtu.be/' . $element['youtube_link'];
+                }
+                if ($element['book_preview']) {
+                    $head_link->href = $element['book_preview']['preview_file_link'];
+                }
+            }
+        }
+
+        return $item;
+    }
+
     public function getName()
     {
         $name = parent::getName();

From 5b978997348b1d8c52be96c2f817128845de2e0e Mon Sep 17 00:00:00 2001
From: July <phantop@tuta.io>
Date: Sun, 3 Aug 2025 18:21:04 -0400
Subject: [PATCH 687/716] [FanaticalBridge] Create a new bridge (#4624)

Provides a fairly barebones bridge for Fanatical bundles:
- Tags detail bundle tiers and prices
- Contents name and link to each bundle item
- Images for each item are in enclosures
---
 bridges/FanaticalBridge.php | 95 +++++++++++++++++++++++++++++++++++++
 1 file changed, 95 insertions(+)
 create mode 100644 bridges/FanaticalBridge.php

diff --git a/bridges/FanaticalBridge.php b/bridges/FanaticalBridge.php
new file mode 100644
index 00000000..3eeeae1b
--- /dev/null
+++ b/bridges/FanaticalBridge.php
@@ -0,0 +1,95 @@
+<?php
+
+class FanaticalBridge extends BridgeAbstract
+{
+    const NAME = 'Fanatical';
+    const MAINTAINER = 'phantop';
+    const URI = 'https://www.fanatical.com/en/';
+    const DESCRIPTION = 'Returns bundles from Fanatical.';
+    const PARAMETERS = [[
+        'type' => [
+            'name' => 'Bundle type',
+            'type' => 'list',
+            'defaultValue' => 'all',
+            'values' => [
+                'All' => 'all',
+                'Books' => 'book-',
+                'ELearning' => 'elearning-',
+                'Games' => '',
+                'Software' => 'software-',
+            ]
+        ]
+    ]];
+
+
+    const IMGURL = 'https://fanatical.imgix.net/product/original/';
+    public function collectData()
+    {
+        $api = 'https://www.fanatical.com/api/all/en';
+        $json = json_decode(getContents($api), true)['pickandmix'];
+        $type = $this->getInput('type');
+
+        foreach ($json as $element) {
+            if ($type != 'all') {
+                if ($element['type'] != $type . 'bundle') {
+                    continue;
+                }
+            }
+
+            $item = [
+                'categories' => [$element['type']],
+                'content' => '<ul>',
+                'enclosures' => [self::IMGURL . $element['cover_image']],
+                'timestamp' => $element['valid_from'],
+                'title' => $element['name'],
+                'uri' => parent::getURI() . 'pick-and-mix/' . $element['slug'],
+            ];
+
+            $slugs = [];
+            foreach ($element['products'] as $product) {
+                $slug = $product['slug'];
+                if (in_array($slug, $slugs)) {
+                    continue;
+                }
+                $slugs[] = $slug;
+                $uri = parent::getURI() . 'game/' . $slug;
+                $item['content'] .= '<li><a href="' . $uri . '">' . $product['name'] . '</a></li>';
+                $item['enclosures'][] = self::IMGURL . $product['cover'];
+            }
+            foreach ($element['tiers'] as $tier) {
+                $count = $tier['quantity'];
+                $price = round($tier['price']['USD'] / 100, 2);
+                $per = round($price / $count, 2);
+                $item['categories'][] = "$count at $per for $price total";
+            }
+
+            $item['content'] .= '</ul>';
+            $this->items[] = $item;
+        }
+    }
+
+    public function getName()
+    {
+        $name = parent::getName();
+        $name .= $this->getKey('type') ? ' - ' . $this->getKey('type') : '';
+        return $name;
+    }
+
+    public function getURI()
+    {
+        $uri = parent::getURI();
+        $type = $this->getKey('type');
+        if ($type) {
+            $uri .= 'bundle/';
+            if ($type != 'All') {
+                $uri .= strtolower($type);
+            }
+        }
+        return $uri;
+    }
+
+    public function getIcon()
+    {
+        return 'https://cdn.fanatical.com/production/icons/fanatical-icon-android-chrome-192x192.png';
+    }
+}

From 9f8dc411a4d78bbbbe23f18c478a790204b64fb1 Mon Sep 17 00:00:00 2001
From: Pavel Korytov <thexcloud@gmail.com>
Date: Mon, 4 Aug 2025 01:21:57 +0300
Subject: [PATCH 688/716] [InstituteForTheStudyOfWarBridge] Increase caching
 time (#4626)

---
 bridges/InstituteForTheStudyOfWarBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/InstituteForTheStudyOfWarBridge.php b/bridges/InstituteForTheStudyOfWarBridge.php
index 3f54094e..c52d4855 100644
--- a/bridges/InstituteForTheStudyOfWarBridge.php
+++ b/bridges/InstituteForTheStudyOfWarBridge.php
@@ -39,7 +39,7 @@ class InstituteForTheStudyOfWarBridge extends BridgeAbstract
         list($date_string, $user) = explode('-', $date_span->innertext);
         $date = DateTime::createFromFormat('F d, Y', trim($date_string));
 
-        $html = getSimpleHTMLDOMCached(self::URI . $uri);
+        $html = getSimpleHTMLDOMCached(self::URI . $uri, 60 * 60 * 24 * 7);
         $content = $html->find('[property=content:encoded]', 0)->innertext;
 
         $enclosures = [];

From 16bb6156a50d81823b54377ddf476d33a05561bc Mon Sep 17 00:00:00 2001
From: Pavel Korytov <thexcloud@gmail.com>
Date: Mon, 4 Aug 2025 01:22:50 +0300
Subject: [PATCH 689/716] [UniverseTodayBridge] Add bridge (#4627)

---
 bridges/UniverseTodayBridge.php | 52 +++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 bridges/UniverseTodayBridge.php

diff --git a/bridges/UniverseTodayBridge.php b/bridges/UniverseTodayBridge.php
new file mode 100644
index 00000000..cfebcc1e
--- /dev/null
+++ b/bridges/UniverseTodayBridge.php
@@ -0,0 +1,52 @@
+<?php
+
+class UniverseTodayBridge extends FeedExpander
+{
+    const MAINTAINER = 'sqrtminusone';
+    const NAME = 'Universe Today Bridge';
+    const URI = 'https://www.universetoday.com/';
+    const DESCRIPTION = 'Returns the latest articles from Universe Today.';
+
+    const PARAMETERS = [
+        '' => [
+            'limit' => [
+                'name' => 'Feed Item Limit',
+                'required' => true,
+                'type' => 'number',
+                'defaultValue' => 10,
+                'title' => 'Maximum number of returned feed items. Default 10'
+            ],
+        ],
+    ];
+
+    public function collectData()
+    {
+        $this->collectExpandableDatas(self::URI . 'feed', (int)$this->getInput('limit'));
+    }
+
+    protected function parseItem(array $item)
+    {
+        $dom = getSimpleHTMLDOMCached($item['uri'], 7 * 24 * 60 * 60);
+        $article_main = $dom->find('main > article', 0);
+
+        // Mostly YouTube videos
+        $iframes = $article_main->find('iframe');
+        foreach ($iframes as $iframe) {
+            $iframe->outertext = '<a href="' . $iframe->src . '">' . $iframe->src . '</a>';
+        }
+        $article_main = defaultLinkTo($article_main, self::URI);
+
+        $author_bio = $article_main->find('div.author-bio', 0);
+        if ($author_bio) {
+            $author_bio->parent->removeChild($author_bio);
+        }
+        $article_nav = $article_main->find('nav.article-navigation', 0);
+        if ($article_nav) {
+            $article_nav->parent->removeChild($article_nav);
+        }
+
+        $item['content'] = $article_main->innertext;
+
+        return $item;
+    }
+}

From e241f3dcde39e350d30ba22a10c8d5c17a9ea93d Mon Sep 17 00:00:00 2001
From: sysadminstory <sysadminstory@users.noreply.github.com>
Date: Mon, 4 Aug 2025 00:48:27 +0200
Subject: [PATCH 690/716] [PepperBridgeAbstract, DealabsBridge,
 HotUKDealsBridge, MydealsBridge] Adapt RSS bridge to website content update;
 remove country of origin due to missing data (#4634)

Website use now "vue3" and some class and attributes have changed their
names : bridge was updated to use the new class and attribute names

Country of origin has been removed from the deal list : it's for now
disabled, but code is still present in the bridge, in case the website
enable it again.
---
 bridges/PepperBridgeAbstract.php | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index 43dbe829..86a488c4 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -62,7 +62,8 @@ class PepperBridgeAbstract extends BridgeAbstract
             foreach ($list as $deal) {
                 // Get the JSON Data stored as vue
                 $jsonDealData = $this->getDealJsonData($deal);
-                $dealMeta = Json::decode($deal->find('div[class=js-vue2]', 1)->getAttribute('data-vue2'));
+                // DEPRECATED : website does not show this info in the deal list anymore
+                // $dealMeta = Json::decode($deal->find('div[class=js-vue3]', 1)->getAttribute('data-vue3'));
 
                 $item = [];
                 $item['uri'] = $this->getDealURI($jsonDealData);
@@ -77,7 +78,10 @@ class PepperBridgeAbstract extends BridgeAbstract
                     . $this->getHTMLTitle($jsonDealData)
                     . $this->getPrice($jsonDealData)
                     . $this->getDiscount($jsonDealData)
-                    . $this->getShipsFrom($dealMeta)
+                    /*
+                     * DEPRECATED : the list does not show this info anymore
+                     * . $this->getShipsFrom($dealMeta)
+                     */
                     . $this->getShippingCost($jsonDealData)
                     . $this->getSource($jsonDealData)
                     . $this->getDealLocation($jsonDealData)
@@ -354,7 +358,7 @@ HEREDOC;
      */
     private function getDealJsonData($deal)
     {
-        $data = Json::decode($deal->find('div[class=js-vue2]', 0)->getAttribute('data-vue2'));
+        $data = Json::decode($deal->find('div[class=js-vue3]', 0)->getAttribute('data-vue3'));
         return $data;
     }
 
@@ -419,7 +423,7 @@ HEREDOC;
     private function getImage($deal)
     {
         // Get thread Image JSON content
-        $content = Json::decode($deal->find('div[class=js-vue2]', 0)->getAttribute('data-vue2'));
+        $content = Json::decode($deal->find('div[class=js-vue3]', 0)->getAttribute('data-vue3'));
         //return '<img src="' . $content['props']['threadImageUrl'] . '"/>';
         return '<img src="' . $this->i8n('image-host') . $content['props']['thread']['mainImage']['path'] . '/'
             . $content['props']['thread']['mainImage']['name'] . '/re/202x202/qt/70/'
@@ -429,6 +433,7 @@ HEREDOC;
     /**
      * Get the originating country from a Deal if it exists
      * @return string String of the deal originating country
+     * DEPRECATED : the deal on the result list does not contain this info anymore
      */
     private function getShipsFrom($dealMeta)
     {

From c65fbd5543a7267b4f0229b5c1cc1c33e4f65775 Mon Sep 17 00:00:00 2001
From: mruac <ant8672@gmail.com>
Date: Mon, 4 Aug 2025 08:20:12 +0930
Subject: [PATCH 691/716] [BlueskyBridge] Fix cases for missing reply post
 context and QoL fix for video loading (#4635)

* added fix for missing reply post context

* qol fix - no preload on videos
---
 bridges/BlueskyBridge.php | 262 +++++++++++++++++++-------------------
 1 file changed, 134 insertions(+), 128 deletions(-)

diff --git a/bridges/BlueskyBridge.php b/bridges/BlueskyBridge.php
index f0e609d9..72c4f018 100644
--- a/bridges/BlueskyBridge.php
+++ b/bridges/BlueskyBridge.php
@@ -330,157 +330,163 @@ class BlueskyBridge extends BridgeAbstract
             }
 
             //reply
-            if ($replyContext && isset($post['reply']) && !isset($post['reply']['parent']['notFound'])) {
+            if ($replyContext && isset($post['reply']) && isset($post['reply']['parent'])) {
                 $replyPost = $post['reply']['parent'];
-                $replyPostRecord = $replyPost['record'];
                 $description .= '<hr/>';
                 $description .= '<p>';
 
-                $replyPostAuthorDID = $replyPost['author']['did'];
-                $replyPostAuthorHandle = $replyPost['author']['handle'] !== 'handle.invalid' ? '<i>@' . $replyPost['author']['handle'] . '</i> ' : '';
-                $replyPostDisplayName = $replyPost['author']['displayName'] ?? '';
-                $replyPostDisplayName = e($replyPostDisplayName);
-                $replyPostUri = self::URI . '/profile/' . $this->fallbackAuthor($replyPost['author'], 'url') . '/post/' . explode('app.bsky.feed.post/', $replyPost['uri'])[1];
+                if (isset($replyPost['notFound']) && $replyPost['notFound']) { //deleted post
+                    $description .= 'Replied to post was deleted.';
+                } elseif (isset($replyPost['blocked']) && $replyPost['blocked']) { //blocked by quote author
+                    $description .= 'Author of replied to post has blocked OP.';
+                } else {
+                    $replyPostRecord = $replyPost['record'];
+                    $replyPostAuthorDID = $replyPost['author']['did'];
+                    $replyPostAuthorHandle = $replyPost['author']['handle'] !== 'handle.invalid' ? '<i>@' . $replyPost['author']['handle'] . '</i> ' : '';
+                    $replyPostDisplayName = $replyPost['author']['displayName'] ?? '';
+                    $replyPostDisplayName = e($replyPostDisplayName);
+                    $replyPostUri = self::URI . '/profile/' . $this->fallbackAuthor($replyPost['author'], 'url') . '/post/' . explode('app.bsky.feed.post/', $replyPost['uri'])[1];
 
-                // reply post
-                $description .= $this->getPostDescription(
-                    $replyPostDisplayName,
-                    $replyPostAuthorHandle,
-                    $replyPostUri,
-                    $replyPostRecord,
-                    'reply'
-                );
+                    // reply post
+                    $description .= $this->getPostDescription(
+                        $replyPostDisplayName,
+                        $replyPostAuthorHandle,
+                        $replyPostUri,
+                        $replyPostRecord,
+                        'reply'
+                    );
 
-                if (isset($replyPostRecord['embed']['$type'])) {
-                    //post link embed
-                    if ($replyPostRecord['embed']['$type'] === 'app.bsky.embed.external') {
-                        $description .= $this->parseExternal($replyPostRecord['embed']['external'], $replyPostAuthorDID);
-                    } elseif (
-                        $replyPostRecord['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
-                        $replyPostRecord['embed']['media']['$type'] === 'app.bsky.embed.external'
-                    ) {
-                        $description .= $this->parseExternal($replyPostRecord['embed']['media']['external'], $replyPostAuthorDID);
-                    }
-
-                    //post images
-                    if (
-                        $replyPostRecord['embed']['$type'] === 'app.bsky.embed.images' ||
-                        (
+                    if (isset($replyPostRecord['embed']['$type'])) {
+                        //post link embed
+                        if ($replyPostRecord['embed']['$type'] === 'app.bsky.embed.external') {
+                            $description .= $this->parseExternal($replyPostRecord['embed']['external'], $replyPostAuthorDID);
+                        } elseif (
                             $replyPostRecord['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
-                            $replyPostRecord['embed']['media']['$type'] === 'app.bsky.embed.images'
-                        )
-                    ) {
-                        $images = $replyPost['embed']['images'] ?? $replyPost['embed']['media']['images'];
-                        foreach ($images as $image) {
-                            $description .= $this->getPostImageDescription($image);
+                            $replyPostRecord['embed']['media']['$type'] === 'app.bsky.embed.external'
+                        ) {
+                            $description .= $this->parseExternal($replyPostRecord['embed']['media']['external'], $replyPostAuthorDID);
+                        }
+
+                        //post images
+                        if (
+                            $replyPostRecord['embed']['$type'] === 'app.bsky.embed.images' ||
+                            (
+                                $replyPostRecord['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
+                                $replyPostRecord['embed']['media']['$type'] === 'app.bsky.embed.images'
+                            )
+                        ) {
+                            $images = $replyPost['embed']['images'] ?? $replyPost['embed']['media']['images'];
+                            foreach ($images as $image) {
+                                $description .= $this->getPostImageDescription($image);
+                            }
+                        }
+
+                        //post video
+                        if (
+                            $replyPostRecord['embed']['$type'] === 'app.bsky.embed.video' ||
+                            (
+                                $replyPostRecord['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
+                                $replyPostRecord['embed']['media']['$type'] === 'app.bsky.embed.video'
+                            )
+                        ) {
+                            $description .= $this->getPostVideoDescription(
+                                $replyPostRecord['embed']['video'] ?? $replyPostRecord['embed']['media']['video'],
+                                $replyPostAuthorDID
+                            );
                         }
                     }
+                    $description .= '</p>';
 
-                    //post video
+                    //quote post
                     if (
-                        $replyPostRecord['embed']['$type'] === 'app.bsky.embed.video' ||
-                        (
-                            $replyPostRecord['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
-                            $replyPostRecord['embed']['media']['$type'] === 'app.bsky.embed.video'
-                        )
+                        isset($replyPostRecord['embed']) &&
+                        ($replyPostRecord['embed']['$type'] === 'app.bsky.embed.record' || $replyPostRecord['embed']['$type'] === 'app.bsky.embed.recordWithMedia') &&
+                        isset($replyPost['embed']['record'])
                     ) {
-                        $description .= $this->getPostVideoDescription(
-                            $replyPostRecord['embed']['video'] ?? $replyPostRecord['embed']['media']['video'],
-                            $replyPostAuthorDID
-                        );
-                    }
-                }
-                $description .= '</p>';
+                        $description .= '<p>';
+                        $replyQuotedRecord = $replyPost['embed']['record']['record'] ?? $replyPost['embed']['record'];
 
-                //quote post
-                if (
-                    isset($replyPostRecord['embed']) &&
-                    ($replyPostRecord['embed']['$type'] === 'app.bsky.embed.record' || $replyPostRecord['embed']['$type'] === 'app.bsky.embed.recordWithMedia') &&
-                    isset($replyPost['embed']['record'])
-                ) {
-                    $description .= '<p>';
-                    $replyQuotedRecord = $replyPost['embed']['record']['record'] ?? $replyPost['embed']['record'];
+                        if (isset($replyQuotedRecord['notFound']) && $replyQuotedRecord['notFound']) { //deleted post
+                            $description .= 'Quoted post deleted.';
+                        } elseif (isset($replyQuotedRecord['detached']) && $replyQuotedRecord['detached']) { //detached quote
+                            $uri_explode = explode('/', $replyQuotedRecord['uri']);
+                            $uri_reconstructed = self::URI . '/profile/' . $uri_explode[2] . '/post/' . $uri_explode[4];
+                            $description .= '<a href="' . $uri_reconstructed . '">Quoted post detached.</a>';
+                        } elseif (isset($replyQuotedRecord['blocked']) && $replyQuotedRecord['blocked']) { //blocked by quote author
+                            $description .= 'Author of quoted post has blocked OP.';
+                        } elseif (
+                            ($replyQuotedRecord['$type'] ?? '') === 'app.bsky.feed.defs#generatorView' ||
+                            ($replyQuotedRecord['$type'] ?? '') === 'app.bsky.graph.defs#listView'
+                        ) {
+                            $description .= $this->getListFeedDescription($replyQuotedRecord);
+                        } elseif (
+                            ($replyQuotedRecord['$type'] ?? '') === 'app.bsky.graph.starterpack' ||
+                            ($replyQuotedRecord['$type'] ?? '') === 'app.bsky.graph.defs#starterPackViewBasic'
+                        ) {
+                            $description .= $this->getStarterPackDescription($replyPost['embed']['record']);
+                        } else {
+                            $quotedAuthorDid = $replyQuotedRecord['author']['did'];
+                            $quotedDisplayName = $replyQuotedRecord['author']['displayName'] ?? '';
+                            $quotedDisplayName = e($quotedDisplayName);
+                            $quotedAuthorHandle = $replyQuotedRecord['author']['handle'] !== 'handle.invalid' ? '<i>@' . $replyQuotedRecord['author']['handle'] . '</i>' : '';
 
-                    if (isset($replyQuotedRecord['notFound']) && $replyQuotedRecord['notFound']) { //deleted post
-                        $description .= 'Quoted post deleted.';
-                    } elseif (isset($replyQuotedRecord['detached']) && $replyQuotedRecord['detached']) { //detached quote
-                        $uri_explode = explode('/', $replyQuotedRecord['uri']);
-                        $uri_reconstructed = self::URI . '/profile/' . $uri_explode[2] . '/post/' . $uri_explode[4];
-                        $description .= '<a href="' . $uri_reconstructed . '">Quoted post detached.</a>';
-                    } elseif (isset($replyQuotedRecord['blocked']) && $replyQuotedRecord['blocked']) { //blocked by quote author
-                        $description .= 'Author of quoted post has blocked OP.';
-                    } elseif (
-                        ($replyQuotedRecord['$type'] ?? '') === 'app.bsky.feed.defs#generatorView' ||
-                        ($replyQuotedRecord['$type'] ?? '') === 'app.bsky.graph.defs#listView'
-                    ) {
-                        $description .= $this->getListFeedDescription($replyQuotedRecord);
-                    } elseif (
-                        ($replyQuotedRecord['$type'] ?? '') === 'app.bsky.graph.starterpack' ||
-                        ($replyQuotedRecord['$type'] ?? '') === 'app.bsky.graph.defs#starterPackViewBasic'
-                    ) {
-                        $description .= $this->getStarterPackDescription($replyPost['embed']['record']);
-                    } else {
-                        $quotedAuthorDid = $replyQuotedRecord['author']['did'];
-                        $quotedDisplayName = $replyQuotedRecord['author']['displayName'] ?? '';
-                        $quotedDisplayName = e($quotedDisplayName);
-                        $quotedAuthorHandle = $replyQuotedRecord['author']['handle'] !== 'handle.invalid' ? '<i>@' . $replyQuotedRecord['author']['handle'] . '</i>' : '';
+                            $parts = explode('/', $replyQuotedRecord['uri']);
+                            $quotedPostId = end($parts);
+                            $quotedPostUri = self::URI . '/profile/' . $this->fallbackAuthor($replyQuotedRecord['author'], 'url') . '/post/' . $quotedPostId;
 
-                        $parts = explode('/', $replyQuotedRecord['uri']);
-                        $quotedPostId = end($parts);
-                        $quotedPostUri = self::URI . '/profile/' . $this->fallbackAuthor($replyQuotedRecord['author'], 'url') . '/post/' . $quotedPostId;
+                            //quoted post - post
+                            $description .= $this->getPostDescription(
+                                $quotedDisplayName,
+                                $quotedAuthorHandle,
+                                $quotedPostUri,
+                                $replyQuotedRecord,
+                                'quote'
+                            );
 
-                        //quoted post - post
-                        $description .= $this->getPostDescription(
-                            $quotedDisplayName,
-                            $quotedAuthorHandle,
-                            $quotedPostUri,
-                            $replyQuotedRecord,
-                            'quote'
-                        );
+                            if (isset($replyQuotedRecord['value']['embed']['$type'])) {
+                                //quoted post - post link embed
+                                if ($replyQuotedRecord['value']['embed']['$type'] === 'app.bsky.embed.external') {
+                                    $description .= $this->parseExternal($replyQuotedRecord['value']['embed']['external'], $quotedAuthorDid);
+                                }
 
-                        if (isset($replyQuotedRecord['value']['embed']['$type'])) {
-                            //quoted post - post link embed
-                            if ($replyQuotedRecord['value']['embed']['$type'] === 'app.bsky.embed.external') {
-                                $description .= $this->parseExternal($replyQuotedRecord['value']['embed']['external'], $quotedAuthorDid);
-                            }
+                                //quoted post - post video
+                                if (
+                                    $replyQuotedRecord['value']['embed']['$type'] === 'app.bsky.embed.video' ||
+                                    (
+                                        $replyQuotedRecord['value']['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
+                                        $replyQuotedRecord['value']['embed']['media']['$type'] === 'app.bsky.embed.video'
+                                    )
+                                ) {
+                                    $description .= $this->getPostVideoDescription(
+                                        $replyQuotedRecord['value']['embed']['video'] ?? $replyQuotedRecord['value']['embed']['media']['video'],
+                                        $quotedAuthorDid
+                                    );
+                                }
 
-                            //quoted post - post video
-                            if (
-                                $replyQuotedRecord['value']['embed']['$type'] === 'app.bsky.embed.video' ||
-                                (
-                                    $replyQuotedRecord['value']['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
-                                    $replyQuotedRecord['value']['embed']['media']['$type'] === 'app.bsky.embed.video'
-                                )
-                            ) {
-                                $description .= $this->getPostVideoDescription(
-                                    $replyQuotedRecord['value']['embed']['video'] ?? $replyQuotedRecord['value']['embed']['media']['video'],
-                                    $quotedAuthorDid
-                                );
-                            }
-
-                            //quoted post - post images
-                            if (
-                                $replyQuotedRecord['value']['embed']['$type'] === 'app.bsky.embed.images' ||
-                                (
-                                    $replyQuotedRecord['value']['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
-                                    $replyQuotedRecord['value']['embed']['media']['$type'] === 'app.bsky.embed.images'
-                                )
-                            ) {
-                                foreach ($replyQuotedRecord['embeds'] as $embed) {
-                                    if (
-                                        $embed['$type'] === 'app.bsky.embed.images#view' ||
-                                        ($embed['$type'] === 'app.bsky.embed.recordWithMedia#view' && $embed['media']['$type'] === 'app.bsky.embed.images#view')
-                                    ) {
-                                        $images = $embed['images'] ?? $embed['media']['images'];
-                                        foreach ($images as $image) {
-                                            $description .= $this->getPostImageDescription($image);
+                                //quoted post - post images
+                                if (
+                                    $replyQuotedRecord['value']['embed']['$type'] === 'app.bsky.embed.images' ||
+                                    (
+                                        $replyQuotedRecord['value']['embed']['$type'] === 'app.bsky.embed.recordWithMedia' &&
+                                        $replyQuotedRecord['value']['embed']['media']['$type'] === 'app.bsky.embed.images'
+                                    )
+                                ) {
+                                    foreach ($replyQuotedRecord['embeds'] as $embed) {
+                                        if (
+                                            $embed['$type'] === 'app.bsky.embed.images#view' ||
+                                            ($embed['$type'] === 'app.bsky.embed.recordWithMedia#view' && $embed['media']['$type'] === 'app.bsky.embed.images#view')
+                                        ) {
+                                            $images = $embed['images'] ?? $embed['media']['images'];
+                                            foreach ($images as $image) {
+                                                $description .= $this->getPostImageDescription($image);
+                                            }
                                         }
                                     }
                                 }
                             }
                         }
+                        $description .= '</p>';
                     }
-                    $description .= '</p>';
                 }
             }
 
@@ -496,7 +502,7 @@ class BlueskyBridge extends BridgeAbstract
         $videoMime = $video['mimeType'];
         $thumbnail = "poster=\"https://video.bsky.app/watch/$authorDID/$videoCID/thumbnail.jpg\"" ?? '';
         $videoURL = "https://bsky.social/xrpc/com.atproto.sync.getBlob?did=$authorDID&cid=$videoCID";
-        return "<figure><video loop $thumbnail controls src=\"$videoURL\" type=\"$videoMime\"/></figure>";
+        return "<figure><video loop $thumbnail preload=\"none\" controls src=\"$videoURL\" type=\"$videoMime\"/></figure>";
     }
 
     private function getPostImageDescription(array $image)

From a2334838a6ac7dfab491d8b855a25eb1adc9fc13 Mon Sep 17 00:00:00 2001
From: Marcin Morawski <marcin@morawskim.pl>
Date: Mon, 4 Aug 2025 00:55:50 +0200
Subject: [PATCH 692/716] Fix deprecations (#4636)

* Fix PHP 8.4 deprecation

Implicitly marking parameter as nullable is deprecated, the explicit nullable type must be used instead

* [github workflow] Add additional php versions
---
 .github/workflows/tests.yml | 2 +-
 bridges/ItakuBridge.php     | 4 ++--
 caches/ArrayCache.php       | 2 +-
 caches/FileCache.php        | 2 +-
 caches/NullCache.php        | 2 +-
 caches/SQLiteCache.php      | 2 +-
 lib/CacheFactory.php        | 2 +-
 lib/CacheInterface.php      | 2 +-
 lib/http.php                | 2 +-
 lib/parsedown/Parsedown.php | 4 ++--
 10 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 96128fc2..435369fa 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-22.04
     strategy:
       matrix:
-        php-versions: ['7.4', '8.0', '8.1']
+        php-versions: ['7.4', '8.0', '8.1', '8.2', '8.3', '8.4']
     steps:
       - uses: actions/checkout@v4
       - uses: shivammathur/setup-php@v2
diff --git a/bridges/ItakuBridge.php b/bridges/ItakuBridge.php
index 22d7529f..0f60d486 100644
--- a/bridges/ItakuBridge.php
+++ b/bridges/ItakuBridge.php
@@ -443,7 +443,7 @@ class ItakuBridge extends BridgeAbstract
         return $data['owner'];
     }
 
-    private function getPost($id, array $metadata = null)
+    private function getPost($id, ?array $metadata = null)
     {
         if (isset($metadata) && count($metadata['gallery_images']) < $metadata['num_images']) {
             $metadata = null; //force re-fetch of metadata
@@ -515,7 +515,7 @@ class ItakuBridge extends BridgeAbstract
         ];
     }
 
-    private function getCommission($id, array $metadata = null)
+    private function getCommission($id, ?array $metadata = null)
     {
         $url = self::URI . '/api/commissions/' . $id . '/?format=json';
         $uri = self::URI . '/commissions/' . $id;
diff --git a/caches/ArrayCache.php b/caches/ArrayCache.php
index 55b18519..ddbd77d5 100644
--- a/caches/ArrayCache.php
+++ b/caches/ArrayCache.php
@@ -23,7 +23,7 @@ class ArrayCache implements CacheInterface
         return $default;
     }
 
-    public function set(string $key, $value, int $ttl = null): void
+    public function set(string $key, $value, ?int $ttl = null): void
     {
         $this->data[$key] = [
             'key'           => $key,
diff --git a/caches/FileCache.php b/caches/FileCache.php
index 24a9872f..5b2f4b37 100644
--- a/caches/FileCache.php
+++ b/caches/FileCache.php
@@ -45,7 +45,7 @@ class FileCache implements CacheInterface
         return $default;
     }
 
-    public function set($key, $value, int $ttl = null): void
+    public function set($key, $value, ?int $ttl = null): void
     {
         $item = [
             'key'           => $key,
diff --git a/caches/NullCache.php b/caches/NullCache.php
index 2549b117..9756b0aa 100644
--- a/caches/NullCache.php
+++ b/caches/NullCache.php
@@ -9,7 +9,7 @@ class NullCache implements CacheInterface
         return $default;
     }
 
-    public function set(string $key, $value, int $ttl = null): void
+    public function set(string $key, $value, ?int $ttl = null): void
     {
     }
 
diff --git a/caches/SQLiteCache.php b/caches/SQLiteCache.php
index d7cba554..a8d51c74 100644
--- a/caches/SQLiteCache.php
+++ b/caches/SQLiteCache.php
@@ -77,7 +77,7 @@ class SQLiteCache implements CacheInterface
         return $default;
     }
 
-    public function set(string $key, $value, int $ttl = null): void
+    public function set(string $key, $value, ?int $ttl = null): void
     {
         $cacheKey = $this->createCacheKey($key);
         $blob = serialize($value);
diff --git a/lib/CacheFactory.php b/lib/CacheFactory.php
index 50d8cef9..96720458 100644
--- a/lib/CacheFactory.php
+++ b/lib/CacheFactory.php
@@ -12,7 +12,7 @@ class CacheFactory
         $this->logger = $logger;
     }
 
-    public function create(string $name = null): CacheInterface
+    public function create(?string $name = null): CacheInterface
     {
         $cacheNames = [];
         foreach (scandir(PATH_LIB_CACHES) as $file) {
diff --git a/lib/CacheInterface.php b/lib/CacheInterface.php
index 0009a55c..02f522e6 100644
--- a/lib/CacheInterface.php
+++ b/lib/CacheInterface.php
@@ -4,7 +4,7 @@ interface CacheInterface
 {
     public function get(string $key, $default = null);
 
-    public function set(string $key, $value, int $ttl = null): void;
+    public function set(string $key, $value, ?int $ttl = null): void;
 
     public function delete(string $key): void;
 
diff --git a/lib/http.php b/lib/http.php
index 37a1f12e..b89e3c05 100644
--- a/lib/http.php
+++ b/lib/http.php
@@ -227,7 +227,7 @@ final class Request
         return $this->get[$key] ?? $default;
     }
 
-    public function server(string $key, string $default = null): ?string
+    public function server(string $key, ?string $default = null): ?string
     {
         return $this->server[$key] ?? $default;
     }
diff --git a/lib/parsedown/Parsedown.php b/lib/parsedown/Parsedown.php
index 1b9d6d5b..d9b5476a 100644
--- a/lib/parsedown/Parsedown.php
+++ b/lib/parsedown/Parsedown.php
@@ -712,7 +712,7 @@ class Parsedown
     #
     # Setext
 
-    protected function blockSetextHeader($Line, array $Block = null)
+    protected function blockSetextHeader($Line, ?array $Block = null)
     {
         if ( ! isset($Block) or isset($Block['type']) or isset($Block['interrupted']))
         {
@@ -850,7 +850,7 @@ class Parsedown
     #
     # Table
 
-    protected function blockTable($Line, array $Block = null)
+    protected function blockTable($Line, ?array $Block = null)
     {
         if ( ! isset($Block) or isset($Block['type']) or isset($Block['interrupted']))
         {

From 85497238c5f008103d4b0186bd42682f23f9be51 Mon Sep 17 00:00:00 2001
From: Joseph <VerifiedJoseph@users.noreply.github.com>
Date: Sun, 3 Aug 2025 23:58:09 +0100
Subject: [PATCH 693/716] Update HaveIBeenPwnedBridge.php (#4638)

---
 bridges/HaveIBeenPwnedBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/HaveIBeenPwnedBridge.php b/bridges/HaveIBeenPwnedBridge.php
index e8a5e4f9..daf040dd 100644
--- a/bridges/HaveIBeenPwnedBridge.php
+++ b/bridges/HaveIBeenPwnedBridge.php
@@ -48,7 +48,7 @@ class HaveIBeenPwnedBridge extends BridgeAbstract
                            . $pwnCount . ' breached accounts';
             $item['dateAdded'] = $breach['AddedDate'];
             $item['breachDate'] = $breach['BreachDate'];
-            $item['uri'] = self::URI . '/PwnedWebsites#' . $breach['Name'];
+            $item['uri'] = self::URI . '/breach/' . $breach['Name'];
 
             $item['content'] = '<p>' . $breach['Description'] . '</p>';
             $item['content'] .= '<p>' . $this->breachType($breach) . '</p>';

From acb9373c108fa51d3b9a36f19c28d84798f8cb2b Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Mon, 4 Aug 2025 01:07:41 +0200
Subject: [PATCH 694/716] [DRKBlutspendeBridge] add offers to content & add
 caption to images & use cached request (#4641)

---
 bridges/DRKBlutspendeBridge.php | 194 +++++++++++++++++++++++++++++---
 1 file changed, 177 insertions(+), 17 deletions(-)

diff --git a/bridges/DRKBlutspendeBridge.php b/bridges/DRKBlutspendeBridge.php
index 15075898..7c415d5d 100644
--- a/bridges/DRKBlutspendeBridge.php
+++ b/bridges/DRKBlutspendeBridge.php
@@ -37,6 +37,26 @@ class DRKBlutspendeBridge extends FeedExpander
         ]
     ];
 
+    const OFFER_LOW_PRIORITIES = [
+        'Imbiss nach der Blutspende',
+        'Registrierung als Stammzellspender',
+        'Typisierung möglich!',
+        'Allgemeine Informationen',
+        'Krankenkassen belohnen Blutspender',
+        'Wer benötigt eigentlich eine Blutspende?',
+        'Win-Win-Situation für die Gesundheit!',
+        'Terminreservierung',
+        'Du möchtest das erste Mal Blut spenden?',
+        'Spende-Check',
+        'Sie haben Fragen vor Ihrer Blutspende?'
+    ];
+
+    const IMAGE_PRIORITIES = [
+        'DRK',
+        'Imbiss',
+        'Obst',
+    ];
+
     public function collectData()
     {
         $limitItems = intval($this->getInput('limit_items'));
@@ -45,37 +65,116 @@ class DRKBlutspendeBridge extends FeedExpander
 
     protected function parseItem(array $item)
     {
-        $html = getSimpleHTMLDOM($item['uri']);
+        $html = getSimpleHTMLDOMCached($item['uri']);
 
         $detailsElement = $html->find('.details', 0);
 
-        $dateElement = $detailsElement->find('.datum', 0);
-        $dateLines = self::explodeLines($dateElement->plaintext);
-
-        $addressElement = $detailsElement->find('.adresse', 0);
-        $addressLines = self::explodeLines($addressElement->plaintext);
+        $dateLines = self::explodeLines($detailsElement->find('.datum', 0)->plaintext);
+        $addressLines = self::explodeLines($detailsElement->find('.adresse', 0)->plaintext);
 
         $infoElement = $detailsElement->find('.angebote > h4 + p', 0);
-        $info = $infoElement ? $infoElement->innertext : '';
+        $info = $infoElement ? trim($infoElement->plaintext) : '';
 
-        $imageElements = $detailsElement->find('.fotos img');
+        $offers = self::parseOffers($detailsElement->find('.angebote .item'));
 
-        $item['title'] = $dateLines[0] . ' ' . $dateLines[1] . ' ' . $addressLines[0] . ' - ' . $addressLines[1];
+        $images = self::parseImages($detailsElement->find('.fotos', 0));
+        usort($images, function ($imageA, $imageB): int {
+            list($titleA) = $imageA;
+            list($titleB) = $imageB;
+            $prioA = 0;
+            $prioB = 0;
+            foreach (self::IMAGE_PRIORITIES as $prioIndex => $prioTitleNeedle) {
+                if (stripos($titleA, $prioTitleNeedle) !== false) {
+                    $prioA = $prioIndex + 1;
+                }
+                if (stripos($titleB, $prioTitleNeedle) !== false) {
+                    $prioB = $prioIndex + 1;
+                }
+            }
+            return $prioA - $prioB;
+        });
 
-        $item['content'] = <<<HTML
-        <p><b>{$dateLines[0]} {$dateLines[1]}</b></p>
-        <p>{$addressElement->innertext}</p>
-        <p>{$info}</p>
+        $itemContent = <<<HTML
+        <div>
+            <p>
+                <b>{$dateLines[0]} {$dateLines[1]}</b><br>
+                {$addressLines[3]}
+            </p>
+            <p>
+                <b>{$addressLines[0]}</b><br>
+                {$addressLines[1]}<br>
+                {$addressLines[2]}
+            </p>
+        </div>
         HTML;
 
-        foreach ($imageElements as $imageElement) {
-            $src = $imageElement->getAttribute('src');
-            $item['content'] .= <<<HTML
-            <p><img src="{$src}"></p>
+        if ($info) {
+            $itemContent .= <<<HTML
+            <div>
+                <h3>Infos</h3>
+                <p>{$info}</p>
+            </div>
             HTML;
         }
 
+        $majorOffers = array_filter($offers, fn($title): bool => !in_array($title, self::OFFER_LOW_PRIORITIES), ARRAY_FILTER_USE_KEY);
+        foreach ($majorOffers as $offerTitle => list($offerText, $offerImages)) {
+            $itemContent .= <<<HTML
+            <div>
+                <h3>{$offerTitle}</h3>
+                <p>{$offerText}</p>
+            HTML;
+            foreach ($offerImages as list($imageTitle, $imageUrl)) {
+                $itemContent .= <<<HTML
+                <figure>
+                    <img src="{$imageUrl}">
+                    <figcaption>{$imageTitle}</figcaption>
+                </figure>
+                HTML;
+            }
+            $itemContent .= <<<HTML
+            </div>
+            HTML;
+        }
+
+        if (count($images) > 0) {
+            $itemContent .= <<<HTML
+            <div>
+                <h3>Fotos</h3>
+            HTML;
+            foreach ($images as list($imageTitle, $imageUrl)) {
+                $itemContent .= <<<HTML
+                <figure>
+                    <img src="{$imageUrl}">
+                    <figcaption>{$imageTitle}</figcaption>
+                </figure>
+                HTML;
+            }
+            $itemContent .= <<<HTML
+            </div>
+            HTML;
+        }
+
+        $minorOffers = array_filter($offers, fn($title): bool => in_array($title, self::OFFER_LOW_PRIORITIES), ARRAY_FILTER_USE_KEY);
+        foreach ($minorOffers as $offerTitle => list($offerText)) {
+            $itemContent .= <<<HTML
+            <div>
+                <h3>{$offerTitle}</h3>
+                <p>{$offerText}</p>
+            </div>
+            HTML;
+        }
+
+        $item['title'] = $dateLines[0] . ' ' . $dateLines[1] . ' ' . $addressLines[0] . ' - ' . $addressLines[1];
+        $item['content'] = $itemContent;
         $item['description'] = null;
+        $item['enclosures'] = array_map(
+            function ($image): string {
+                list($title, $url) = $image;
+                return $url . '#' . urlencode(str_replace(' ', '_', $title));
+            },
+            $images
+        );
 
         return $item;
     }
@@ -97,6 +196,67 @@ class DRKBlutspendeBridge extends FeedExpander
         return self::BASE_URI . '/blutspendetermine/termine.rss?date_to=' . $dateTo . '&radius=' . $radius . '&term=' . $term;
     }
 
+    private function parseImages($parentElement): array
+    {
+        $images = [];
+
+        if ($parentElement) {
+            $elements = $parentElement->find('a[data-lightbox]');
+            foreach ($elements as $i => $element) {
+                $url = trim($element->getAttribute('href'));
+                if (!$url) {
+                    continue;
+                }
+
+                $title = trim($element->getAttribute('title'));
+                if (!$title) {
+                    $number = $i + 1;
+                    $title = "Foto {$number}";
+                }
+
+                $images[] = [$title, $url];
+            }
+        }
+
+        return $images;
+    }
+
+    private function parseOffers($offerElements): array
+    {
+        $offers = [];
+
+        foreach ($offerElements as $element) {
+            $title = self::getCleanPlainText($element->find(':is(h1,h2,h3,h4,h5,h6)', 0));
+            $text = trim(substr(self::getCleanPlainText($element), strlen($title)));
+            if (!$title || !$text) {
+                continue;
+            }
+
+            $linkElements = $element->find('a');
+            foreach ($linkElements as $linkElement) {
+                $linkText = trim($linkElement->plaintext);
+                $linkUrl = trim($linkElement->getAttribute('href'));
+                if (!$linkText || !$linkUrl) {
+                    continue;
+                }
+
+                $linkHtml = <<<HTML
+                <a href="{$linkUrl}" target="_blank">{$linkText}</a>
+                HTML;
+                $text = str_replace($linkText, $linkHtml, $text);
+            }
+
+            $offers[$title] = [$text, self::parseImages($element)];
+        }
+
+        return $offers;
+    }
+
+    private function getCleanPlainText($htmlElement): string
+    {
+        return $htmlElement ? trim(preg_replace('/\s+/', ' ', html_entity_decode($htmlElement->plaintext))) : '';
+    }
+
     /**
      * Returns an array of strings, each of which is a substring of string formed by splitting it on boundaries formed by line breaks.
      */

From 172e7eb280838ef531444d3271996cabd2e38e0c Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Mon, 4 Aug 2025 01:08:25 +0200
Subject: [PATCH 695/716] [prtester] fix wrong pr check fail when refactoring
 code (the bridge html output has not changed) (#4642)

ignore "nothing to commit, working tree clean"
---
 .github/workflows/prhtmlgenerator.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/prhtmlgenerator.yml b/.github/workflows/prhtmlgenerator.yml
index 163d51e3..bfc89e7a 100644
--- a/.github/workflows/prhtmlgenerator.yml
+++ b/.github/workflows/prhtmlgenerator.yml
@@ -122,5 +122,5 @@ jobs:
         run: |
           export COMMIT_MESSAGE="Added tests for PR ${{github.event.number}}"
           git add .
-          git commit -m "$COMMIT_MESSAGE"
+          git commit -m "$COMMIT_MESSAGE" || exit 0
           git push

From 69eda522c8f673a9960000b85458fd21d628d36a Mon Sep 17 00:00:00 2001
From: Sandro <sandro.jaeckel@gmail.com>
Date: Mon, 4 Aug 2025 01:09:38 +0200
Subject: [PATCH 696/716] Mention php extension filter (#4608)

While trying around to minimize my installation, I noticed that this
extension is nowhere mentioned.
---
 composer.json | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/composer.json b/composer.json
index cafcd085..8d41c51b 100644
--- a/composer.json
+++ b/composer.json
@@ -29,7 +29,8 @@
         "ext-libxml": "*",
         "ext-simplexml": "*",
         "ext-dom": "*",
-        "ext-json": "*"
+        "ext-json": "*",
+        "ext-filter": "*"
     },
     "require-dev": {
         "phpunit/phpunit": "^9",

From 47c9983e16c879eed1fa03576a6c4abc90c1a3ed Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Mon, 4 Aug 2025 01:32:36 +0200
Subject: [PATCH 697/716] fix: dont cache basic auth response (#4644)

---
 lib/RssBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/RssBridge.php b/lib/RssBridge.php
index c7b132d6..d16f1d89 100644
--- a/lib/RssBridge.php
+++ b/lib/RssBridge.php
@@ -23,11 +23,11 @@ final class RssBridge
         $handler = $this->container[$actionName];
 
         $middlewares = [
+            new BasicAuthMiddleware(),
             new CacheMiddleware($this->container['cache']),
             new ExceptionMiddleware($this->container['logger']),
             new SecurityMiddleware(),
             new MaintenanceMiddleware(),
-            new BasicAuthMiddleware(),
             new TokenAuthenticationMiddleware(),
         ];
         $action = function ($req) use ($handler) {

From e5f9fe6251cd63ab181b4551d944aaed42cea94b Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Mon, 4 Aug 2025 01:36:15 +0200
Subject: [PATCH 698/716] lint (#4645)

---
 bridges/ExplosmBridge.php      |  2 +-
 bridges/WaggaCouncilBridge.php | 15 +++++++++------
 2 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/bridges/ExplosmBridge.php b/bridges/ExplosmBridge.php
index ae197e2b..1572fb56 100644
--- a/bridges/ExplosmBridge.php
+++ b/bridges/ExplosmBridge.php
@@ -36,7 +36,7 @@ class ExplosmBridge extends BridgeAbstract
             $html = getSimpleHTMLDOM($url);
 
             $element = $html->find('[class*=ComicImage]', 0);
-            if(!$element) {
+            if (!$element) {
                 break; // skip, if element was not found
             }
             $date    = $element->find('[class^=Author__Right] p', 0)->plaintext;
diff --git a/bridges/WaggaCouncilBridge.php b/bridges/WaggaCouncilBridge.php
index a5b73392..d56277cd 100644
--- a/bridges/WaggaCouncilBridge.php
+++ b/bridges/WaggaCouncilBridge.php
@@ -1,6 +1,7 @@
 <?php
 
-class WaggaCouncilBridge extends BridgeAbstract {
+class WaggaCouncilBridge extends BridgeAbstract
+{
     const NAME = 'Wagga Wagga Council';
     const URI = 'https://news.wagga.nsw.gov.au/';
     const DESCRIPTION = 'Wagga Wagga Council updates';
@@ -25,12 +26,14 @@ class WaggaCouncilBridge extends BridgeAbstract {
         ]
     ];
 
-    public function getURI(): string {
+    public function getURI(): string
+    {
         $section = $this->getInput('section') ?: 'council';
         return urljoin(self::URI, $section);
     }
 
-    public function collectData(): void {
+    public function collectData(): void
+    {
         $html = getSimpleHTMLDOM($this->getURI());
 
         foreach ($html->find('div.container') as $container) {
@@ -64,18 +67,18 @@ class WaggaCouncilBridge extends BridgeAbstract {
                         '.article__badge',
                         'p.text-muted',
                     ];
-                    
+
                     foreach ($selectorsToRemove as $sel) {
                         foreach ($article->find($sel) as $el) {
                             $el->outertext = '';
                         }
                     }
-            
+
                     foreach ($article->find('iframe') as $iframe) {
                         $src = $iframe->getAttribute('src');
                         $iframe->outertext = '<p><a href="' . htmlspecialchars($src) . '">Embedded content: ' . htmlspecialchars($src) . '</a></p>';
                     }
-                    
+
                     // Enhance list rendering
                     foreach ($article->find('ul') as $ul) {
                         $ul->style = 'margin-left: 1em; padding-left: 1em;';

From 6ec4da854f53da186f6427e37e652f8d455d5487 Mon Sep 17 00:00:00 2001
From: User123698745 <User123698745@users.noreply.github.com>
Date: Mon, 4 Aug 2025 01:36:44 +0200
Subject: [PATCH 699/716] [FallGuysBridge] fix: handle new data structure
 (#4640)

* [FallGuysBridge] fix: handle new data structure

* [FallGuysBridge] review feedback: removed mixed
---
 bridges/FallGuysBridge.php | 111 ++++++++++++++++++++++---------------
 1 file changed, 66 insertions(+), 45 deletions(-)

diff --git a/bridges/FallGuysBridge.php b/bridges/FallGuysBridge.php
index 1e527484..46411f33 100644
--- a/bridges/FallGuysBridge.php
+++ b/bridges/FallGuysBridge.php
@@ -37,13 +37,14 @@ class FallGuysBridge extends BridgeAbstract
 
     public function collectData()
     {
-        $html = getSimpleHTMLDOM(self::getURI());
+        $newsData = self::requestJsonData(self::getURI(), false);
 
-        $data = json_decode($html->find('#__NEXT_DATA__', 0)->innertext);
+        foreach ($newsData->props->pageProps->newsList as $newsItem) {
+            $newsItemUrl = self::getURI() . '/' . $newsItem->slug;
+            $newsItemTitle = $newsItem->header->title;
 
-        foreach ($data->props->pageProps->newsList as $newsItem) {
             $headerDescription = property_exists($newsItem->header, 'description') ? $newsItem->header->description : '';
-            $headerImage = $newsItem->header->image->src;
+            $headerImage = $newsItem->newsLandingConfig->options[0]->image->src->url;
 
             $contentImages = [$headerImage];
 
@@ -52,67 +53,79 @@ class FallGuysBridge extends BridgeAbstract
             <p><img src="{$headerImage}"></p>
             HTML;
 
-            foreach ($newsItem->content->items as $contentItem) {
-                if (property_exists($contentItem, 'articleCopy')) {
-                    if (property_exists($contentItem->articleCopy, 'title')) {
-                        $title = $contentItem->articleCopy->title;
+            try {
+                $newsItemData = self::requestJsonData($newsItemUrl, true);
+            } catch (\Exception $e) {
+                $this->logger->error(sprintf('Failed to request data for news item "%s" (%s)', $newsItemTitle, $newsItemUrl), ['e' => $e]);
+                $newsItemData = null;
+            }
+            if (!$newsItemData) {
+                $this->logger->error(sprintf('Failed to parse json data for news item "%s" (%s)', $newsItemTitle, $newsItemUrl));
+            } else {
+                foreach ($newsItemData->props->pageProps->pageData->content->items as $contentItem) {
+                    if (property_exists($contentItem, 'articleCopy')) {
+                        if (property_exists($contentItem->articleCopy, 'title')) {
+                            $title = $contentItem->articleCopy->title;
+
+                            $content .= <<<HTML
+                            <h2>{$title}</h2>
+                            HTML;
+                        }
+
+                        $text = $contentItem->articleCopy->copy;
 
                         $content .= <<<HTML
-                        <h2>{$title}</h2>
+                        <p>{$text}</p>
                         HTML;
-                    }
+                    } elseif (property_exists($contentItem, 'articleImage')) {
+                        $image = $contentItem->articleImage->imageSrc;
 
-                    $text = $contentItem->articleCopy->copy;
+                        if ($image != $headerImage) {
+                            $contentImages[] = $image;
 
-                    $content .= <<<HTML
-                    <p>{$text}</p>
-                    HTML;
-                } elseif (property_exists($contentItem, 'articleImage')) {
-                    $image = $contentItem->articleImage->imageSrc;
+                            $content .= <<<HTML
+                            <p><img src="{$image}"></p>
+                            HTML;
+                        }
+                    } elseif (property_exists($contentItem, 'embeddedVideo')) {
+                        $mediaOptions = $contentItem->embeddedVideo->mediaOptions;
+                        $mainContentOptions = $contentItem->embeddedVideo->mainContentOptions;
 
-                    if ($image != $headerImage) {
-                        $contentImages[] = $image;
+                        if (count($mediaOptions) == count($mainContentOptions)) {
+                            for ($i = 0; $i < count($mediaOptions); $i++) {
+                                if (property_exists($mediaOptions[$i], 'youtubeVideo')) {
+                                    $videoUrl = 'https://youtu.be/' . $mediaOptions[$i]->youtubeVideo->contentId;
+                                    $image = $mainContentOptions[$i]->image->src ?? '';
 
-                        $content .= <<<HTML
-                        <p><img src="{$image}"></p>
-                        HTML;
-                    }
-                } elseif (property_exists($contentItem, 'embeddedVideo')) {
-                    $mediaOptions = $contentItem->embeddedVideo->mediaOptions;
-                    $mainContentOptions = $contentItem->embeddedVideo->mainContentOptions;
+                                    $content .= '<p>';
 
-                    if (count($mediaOptions) == count($mainContentOptions)) {
-                        for ($i = 0; $i < count($mediaOptions); $i++) {
-                            if (property_exists($mediaOptions[$i], 'youtubeVideo')) {
-                                $videoUrl = 'https://youtu.be/' . $mediaOptions[$i]->youtubeVideo->contentId;
-                                $image = $mainContentOptions[$i]->image->src ?? '';
+                                    if ($image != $headerImage) {
+                                        $contentImages[] = $image;
 
-                                $content .= '<p>';
-
-                                if ($image != $headerImage) {
-                                    $contentImages[] = $image;
+                                        $content .= <<<HTML
+                                        <a href="{$videoUrl}"><img src="{$image}"></a><br>
+                                        HTML;
+                                    }
 
                                     $content .= <<<HTML
-                                    <a href="{$videoUrl}"><img src="{$image}"></a><br>
+                                    <i>(Video: <a href="{$videoUrl}">{$videoUrl}</a>)</i>
                                     HTML;
+
+                                    $content .= '</p>';
                                 }
-
-                                $content .= <<<HTML
-                                <i>(Video: <a href="{$videoUrl}">{$videoUrl}</a>)</i>
-                                HTML;
-
-                                $content .= '</p>';
                             }
                         }
+                    } else {
+                        $this->logger->warning(sprintf('Unsupported content item in news item "%s" (%s)', $newsItemTitle, $newsItemUrl));
                     }
                 }
             }
 
             $item = [
-                'uid' => $newsItem->_id,
-                'uri' => self::getURI() . '/' . $newsItem->_slug,
-                'title' => $newsItem->_title,
-                'timestamp' => $newsItem->lastModified,
+                'uid' => $newsItem->id,
+                'uri' => $newsItemUrl,
+                'title' => $newsItemTitle,
+                'timestamp' => $newsItem->activeDate,
                 'content' => $content,
                 'enclosures' => $contentImages,
             ];
@@ -131,4 +144,12 @@ class FallGuysBridge extends BridgeAbstract
     {
         return self::BASE_URI . '/favicon.ico';
     }
+
+    private function requestJsonData(string $url, bool $useCache)
+    {
+        $html = $useCache ? getSimpleHTMLDOMCached($url) : getSimpleHTMLDOM($url);
+        $jsonElement = $html->find('#__NEXT_DATA__', 0);
+        $json = $jsonElement ? $jsonElement->innertext : null;
+        return json_decode($json);
+    }
 }

From 93de253d0108b291a8ce84fe45aaa7994e38d56f Mon Sep 17 00:00:00 2001
From: Arnav Jain <ajain-93@users.noreply.github.com>
Date: Mon, 4 Aug 2025 14:27:19 +0200
Subject: [PATCH 700/716] [GoComicsBridge] cache individual comic page for 24h
 (#4646)

---
 bridges/GoComicsBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/GoComicsBridge.php b/bridges/GoComicsBridge.php
index 8e78ce5e..eff5467d 100644
--- a/bridges/GoComicsBridge.php
+++ b/bridges/GoComicsBridge.php
@@ -48,7 +48,7 @@ class GoComicsBridge extends BridgeAbstract
         }
 
         for ($i = 0; $i < $this->getInput('limit'); $i++) {
-            $html = getSimpleHTMLDOM($link);
+            $html = getSimpleHTMLDOMCached($link, 86400);
 
             $imagelink = $html->find('meta[property="og:image"]', 0)->content;
             $parts = explode('/', $link);

From 640503168e709b0b96a1cb17c9f2917faec1eb9b Mon Sep 17 00:00:00 2001
From: Joseph <VerifiedJoseph@users.noreply.github.com>
Date: Mon, 4 Aug 2025 13:27:40 +0100
Subject: [PATCH 701/716] [FirefoxAddonsBridge] Minor change to item content
 html (#4647)

---
 bridges/FirefoxAddonsBridge.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/bridges/FirefoxAddonsBridge.php b/bridges/FirefoxAddonsBridge.php
index fcf2ca02..7314aa8c 100644
--- a/bridges/FirefoxAddonsBridge.php
+++ b/bridges/FirefoxAddonsBridge.php
@@ -58,13 +58,13 @@ class FirefoxAddonsBridge extends BridgeAbstract
             }
 
             $item['content'] = <<<EOD
-<strong>Release Notes</strong>
+<p><strong>Release Notes</strong></p>
 <p>{$releaseNotes}</p>
-<strong>Compatibility</strong>
+<p><strong>Compatibility</strong></p>
 <p>{$compatibility}</p>
-<strong>License</strong>
+<p><strong>License</strong></p>
 <p>{$license}</p>
-<strong>Download</strong>
+<p><strong>Download</strong></p>
 <p><a href="{$downloadlink}">{$xpiFilename}</a> ($size)</p>
 EOD;
 

From 1211ac63d92589a42ae586803cee9cbbdcb49a70 Mon Sep 17 00:00:00 2001
From: Joseph <VerifiedJoseph@users.noreply.github.com>
Date: Mon, 4 Aug 2025 13:28:16 +0100
Subject: [PATCH 702/716] Update DailymotionBridge.php (#4648)

---
 bridges/DailymotionBridge.php | 101 ++++++++--------------------------
 1 file changed, 22 insertions(+), 79 deletions(-)

diff --git a/bridges/DailymotionBridge.php b/bridges/DailymotionBridge.php
index 5d892954..fcaa4292 100644
--- a/bridges/DailymotionBridge.php
+++ b/bridges/DailymotionBridge.php
@@ -44,68 +44,32 @@ class DailymotionBridge extends BridgeAbstract
 
     public function getIcon()
     {
-        return 'https://static1-ssl.dmcdn.net/images/neon/favicons/android-icon-36x36.png.vf806ca4ed0deed812';
+        return 'https://static1.dmcdn.net/neon-user-ssr/prod/favicons/apple-icon-60x60.831b96ed0a8eca7f6539.png';
     }
 
     public function collectData()
     {
-        if ($this->queriedContext === 'By username' || $this->queriedContext === 'By playlist id') {
-            $apiJson = getContents($this->getApiUrl());
-
-            $apiData = json_decode($apiJson, true);
+        $apiJson = getContents($this->getApiUrl());
+        $apiData = json_decode($apiJson, true);
 
+        if ($this->queriedContext === 'By playlist id') {
             $this->feedName = $this->getPlaylistTitle($this->getInput('p'));
-
-            foreach ($apiData['list'] as $apiItem) {
-                $item = [];
-
-                $item['uri'] = $apiItem['url'];
-                $item['uid'] = $apiItem['id'];
-                $item['title'] = $apiItem['title'];
-                $item['timestamp'] = $apiItem['created_time'];
-                $item['author'] = $apiItem['owner.screenname'];
-                $item['content'] = '<p><a href="' . $apiItem['url'] . '">
-					<img src="' . $apiItem['thumbnail_url'] . '"></a></p><p>' . $apiItem['description'] . '</p>';
-                $item['categories'] = $apiItem['tags'];
-                $item['enclosures'][] = $apiItem['thumbnail_url'];
-
-                $this->items[] = $item;
-            }
         }
 
-        if ($this->queriedContext === 'From search results') {
-            $html = getSimpleHTMLDOM($this->getURI());
+        foreach ($apiData['list'] as $apiItem) {
+            $item = [];
 
-            foreach ($html->find('div.media a.preview_link') as $element) {
-                $item = [];
+            $item['uri'] = $apiItem['url'];
+            $item['uid'] = $apiItem['id'];
+            $item['title'] = $apiItem['title'];
+            $item['timestamp'] = $apiItem['created_time'];
+            $item['author'] = $apiItem['owner.screenname'];
+            $item['content'] = '<p><a href="' . $apiItem['url'] . '">
+				<img src="' . $apiItem['thumbnail_url'] . '"></a></p><p>' . $apiItem['description'] . '</p>';
+            $item['categories'] = $apiItem['tags'];
+            $item['enclosures'][] = $apiItem['thumbnail_url'];
 
-                $item['id'] = str_replace('/video/', '', strtok($element->href, '_'));
-                $metadata = $this->getMetadata($item['id']);
-
-                if (empty($metadata)) {
-                    continue;
-                }
-
-                $item['uri'] = $metadata['uri'];
-                $item['title'] = $metadata['title'];
-                $item['timestamp'] = $metadata['timestamp'];
-
-                $item['content'] = '<a href="'
-                    . $item['uri']
-                    . '"><img src="'
-                    . $metadata['thumbnailUri']
-                    . '" /></a><br><a href="'
-                    . $item['uri']
-                    . '">'
-                    . $item['title']
-                    . '</a>';
-
-                $this->items[] = $item;
-
-                if (count($this->items) >= 5) {
-                    break;
-                }
-            }
+            $this->items[] = $item;
         }
     }
 
@@ -136,6 +100,7 @@ class DailymotionBridge extends BridgeAbstract
     public function getURI()
     {
         $uri = self::URI;
+
         switch ($this->queriedContext) {
             case 'By username':
                 $uri .= 'user/' . urlencode($this->getInput('u'));
@@ -162,35 +127,10 @@ class DailymotionBridge extends BridgeAbstract
         return $uri;
     }
 
-    private function getMetadata($id)
-    {
-        $metadata = [];
-
-        $html = getSimpleHTMLDOM(self::URI . 'video/' . $id);
-
-        if (!$html) {
-            return $metadata;
-        }
-
-        $metadata['title'] = $html->find('meta[property=og:title]', 0)->getAttribute('content');
-        $metadata['timestamp'] = strtotime(
-            $html->find('meta[property=video:release_date]', 0)->getAttribute('content')
-        );
-        $metadata['thumbnailUri'] = $html->find('meta[property=og:image]', 0)->getAttribute('content');
-        $metadata['uri'] = $html->find('meta[property=og:url]', 0)->getAttribute('content');
-        return $metadata;
-    }
-
     private function getPlaylistTitle($id)
     {
-        $title = '';
-
-        $url = self::URI . 'playlist/' . $id;
-
-        $html = getSimpleHTMLDOM($url);
-
-        $title = $html->find('meta[property=og:title]', 0)->getAttribute('content');
-        return $title;
+        $html = getSimpleHTMLDOM(self::URI . 'playlist/' . $id);
+        return $html->find('meta[property=og:title]', 0)->getAttribute('content');
     }
 
     private function getApiUrl()
@@ -204,6 +144,9 @@ class DailymotionBridge extends BridgeAbstract
                 return $this->apiUrl . '/playlist/' . $this->getInput('p')
                     . '/videos?fields=' . urlencode($this->apiFields) . '&limit=5';
                 break;
+            case 'From search results':
+                return $this->apiUrl . '/videos?search=' . $this->getInput('s') . '&fields=' . urlencode($this->apiFields) . '&limit=5';
+                break;
         }
     }
 }

From aba38845d24a42b20434b6dbbc90cb09dfe716ec Mon Sep 17 00:00:00 2001
From: shaun <shaunewilliams@gmail.com>
Date: Mon, 4 Aug 2025 07:30:48 -0500
Subject: [PATCH 703/716] =?UTF-8?q?[YoutubeCommunityTabsBridge]=20Rename?=
 =?UTF-8?q?=20Community=E2=86=92Posts=20to=20fix=20broken=20bridge=20(#460?=
 =?UTF-8?q?6)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* youtube community posts are just called "Posts" now

* finish renaming Community -> Posts

* add feedName fallbacks (thanks @Mar-Koeh)

* rename YouTubePostsTabBridge back to YouTubeCommunityTabBridge

* fix linter error by breaking up long expression

* fix optional-chaining regression by using ‘?? null’
---
 README.md                             |  2 +-
 bridges/YouTubeCommunityTabBridge.php | 44 +++++++++++++++------------
 2 files changed, 25 insertions(+), 21 deletions(-)

diff --git a/README.md b/README.md
index dadf7094..66d9b46e 100644
--- a/README.md
+++ b/README.md
@@ -46,7 +46,7 @@ Requires minimum PHP 7.4.
 * `TwitchBridge`: [Fetches videos from channel](https://rss-bridge.org/bridge01/#bridge-TwitchBridge)
 * `XPathBridge`: [Scrape out a feed using XPath expressions](https://rss-bridge.org/bridge01/#bridge-XPathBridge)
 * `YoutubeBridge`: [Fetches videos by username/channel/playlist/search](https://rss-bridge.org/bridge01/#bridge-YoutubeBridge)
-* `YouTubeCommunityTabBridge`: [Fetches posts from a channel's community tab](https://rss-bridge.org/bridge01/#bridge-YouTubeCommunityTabBridge)
+* `YouTubeCommunityTabBridge`: [Fetches posts from a channel's Posts tab](https://rss-bridge.org/bridge01/#bridge-YouTubeCommunityTabBridge)
 
 ## Tutorial
 
diff --git a/bridges/YouTubeCommunityTabBridge.php b/bridges/YouTubeCommunityTabBridge.php
index 284b81f9..d6a70bd6 100644
--- a/bridges/YouTubeCommunityTabBridge.php
+++ b/bridges/YouTubeCommunityTabBridge.php
@@ -2,9 +2,9 @@
 
 class YouTubeCommunityTabBridge extends BridgeAbstract
 {
-    const NAME = 'YouTube Community Tab Bridge';
+    const NAME = 'YouTube Posts Tab Bridge';
     const URI = 'https://www.youtube.com';
-    const DESCRIPTION = 'Returns posts from a channel\'s community tab';
+    const DESCRIPTION = 'Returns posts from a channel\'s posts tab';
     const MAINTAINER = 'VerifiedJoseph';
     const PARAMETERS = [
         'By channel ID' => [
@@ -31,7 +31,7 @@ class YouTubeCommunityTabBridge extends BridgeAbstract
     private $feedName = '';
     private $itemTitle = '';
 
-    private $urlRegex = '/youtube\.com\/(channel|user|c)\/([\w]+)\/community/';
+    private $urlRegex = '/youtube\.com\/(channel|user|c)\/([\w]+)\/posts/';
     private $jsonRegex = '/var ytInitialData = ([^<]*);<\/script>/';
 
     public function detectParameters($url)
@@ -59,26 +59,30 @@ class YouTubeCommunityTabBridge extends BridgeAbstract
     {
         if (is_null($this->getInput('username')) === false) {
             try {
-                $this->feedUrl = $this->buildCommunityUri($this->getInput('username'), 'c');
+                $this->feedUrl = $this->buildPostsUri($this->getInput('username'), 'c');
                 $html = getSimpleHTMLDOM($this->feedUrl);
             } catch (Exception $e) {
-                $this->feedUrl = $this->buildCommunityUri($this->getInput('username'), 'user');
+                $this->feedUrl = $this->buildPostsUri($this->getInput('username'), 'user');
                 $html = getSimpleHTMLDOM($this->feedUrl);
             }
         } else {
-            $this->feedUrl = $this->buildCommunityUri($this->getInput('channel'), 'channel');
+            $this->feedUrl = $this->buildPostsUri($this->getInput('channel'), 'channel');
             $html = getSimpleHTMLDOM($this->feedUrl);
         }
 
         $json = $this->extractJson($html->find('html', 0)->innertext);
 
-        $this->feedName = $json->header->c4TabbedHeaderRenderer->title;
+        $this->feedName = $json->header->c4TabbedHeaderRenderer->title ?? null;
+        $this->feedName ??= $json->header->pageHeaderRenderer->pageTitle ?? null;
+        $this->feedName ??= $json->metadata->channelMetadataRenderer->title ?? null;
+        $this->feedName ??= $json->microformat->microformatDataRenderer->title ?? null;
+        $this->feedName ??= '';
 
-        if ($this->hasCommunityTab($json) === false) {
-            returnServerError('Channel does not have a community tab');
+        if ($this->hasPostsTab($json) === false) {
+            returnServerError('Channel does not have a posts tab');
         }
 
-        $posts = $this->getCommunityPosts($json);
+        $posts = $this->getPosts($json);
         foreach ($posts as $key => $post) {
             $this->itemTitle = '';
 
@@ -132,18 +136,18 @@ class YouTubeCommunityTabBridge extends BridgeAbstract
     public function getName()
     {
         if (!empty($this->feedName)) {
-            return $this->feedName . ' - YouTube Community Tab';
+            return $this->feedName . ' - YouTube Posts Tab';
         }
 
         return parent::getName();
     }
 
     /**
-     * Build Community URI
+     * Build Posts URI
      */
-    private function buildCommunityUri($value, $type)
+    private function buildPostsUri($value, $type)
     {
-        return self::URI . '/' . $type . '/' . $value . '/community';
+        return self::URI . '/' . $type . '/' . $value . '/posts';
     }
 
     /**
@@ -165,14 +169,14 @@ class YouTubeCommunityTabBridge extends BridgeAbstract
     }
 
     /**
-     * Check if channel has a community tab
+     * Check if channel has a posts tab
      */
-    private function hasCommunityTab($json)
+    private function hasPostsTab($json)
     {
         foreach ($json->contents->twoColumnBrowseResultsRenderer->tabs as $tab) {
             if (
                 isset($tab->tabRenderer)
-                && str_ends_with($tab->tabRenderer->endpoint->commandMetadata->webCommandMetadata->url, 'community')
+                && str_ends_with($tab->tabRenderer->endpoint->commandMetadata->webCommandMetadata->url, 'posts')
             ) {
                 return true;
             }
@@ -182,14 +186,14 @@ class YouTubeCommunityTabBridge extends BridgeAbstract
     }
 
     /**
-     * Get community tab posts
+     * Get posts from posts tab
      */
-    private function getCommunityPosts($json)
+    private function getPosts($json)
     {
         foreach ($json->contents->twoColumnBrowseResultsRenderer->tabs as $tab) {
             if (
                 isset($tab->tabRenderer)
-                && str_ends_with($tab->tabRenderer->endpoint->commandMetadata->webCommandMetadata->url, 'community')
+                && str_ends_with($tab->tabRenderer->endpoint->commandMetadata->webCommandMetadata->url, 'posts')
             ) {
                 return $tab->tabRenderer->content->sectionListRenderer->contents[0]->itemSectionRenderer->contents;
             }

From b5f90f8d472f7cb3d8c1c85775ac56ce5f66c263 Mon Sep 17 00:00:00 2001
From: Simone Dotto <simonedotto@protonmail.com>
Date: Mon, 4 Aug 2025 14:31:43 +0200
Subject: [PATCH 704/716] [AmazonPriceTracker] Fix price not shown, new default
 source (#4631)

Fixes issue #4586

Co-authored-by: Simone Dotto <simonedotto@proton.me>
---
 bridges/AmazonPriceTrackerBridge.php | 46 +++++++++++++++++++---------
 1 file changed, 31 insertions(+), 15 deletions(-)

diff --git a/bridges/AmazonPriceTrackerBridge.php b/bridges/AmazonPriceTrackerBridge.php
index 5f93eb49..45eab097 100644
--- a/bridges/AmazonPriceTrackerBridge.php
+++ b/bridges/AmazonPriceTrackerBridge.php
@@ -2,7 +2,7 @@
 
 class AmazonPriceTrackerBridge extends BridgeAbstract
 {
-    const MAINTAINER = 'captn3m0, sal0max';
+    const MAINTAINER = 'captn3m0, sal0max, bagnacauda';
     const NAME = 'Amazon Price Tracker';
     const URI = 'https://www.amazon.com/';
     const CACHE_TIMEOUT = 3600; // 1h
@@ -13,7 +13,7 @@ class AmazonPriceTrackerBridge extends BridgeAbstract
         'asin' => [
             'name'          => 'ASIN',
             'required'      => true,
-            'exampleValue'  => 'B071GB1VMQ',
+            'exampleValue'  => 'B0923XT6K7',
             // https://stackoverflow.com/a/12827734
             'pattern'       => 'B[\dA-Z]{9}|\d{9}(X|\d)',
         ],
@@ -169,19 +169,23 @@ EOT;
 
     private function scrapePriceTwister($html)
     {
-        $str = $html->find('.twister-plus-buying-options-price-data', 0);
+        $json = $html->find('.twister-plus-buying-options-price-data', 0);
+        if ($json == null) {
+            return null;
+        }
 
-        $data = json_decode($str->innertext, true);
-        if (count($data) === 1) {
-            $data = $data[0];
+        $data = json_decode($json->innertext, true);
+        foreach ($data as $key => $value) {
+            $value = $value[0];
             return [
-                'displayPrice' => $data['displayPrice'],
-                'currency' => $data['currency'],
-                'shipping' => '0',
+                'displayPrice' => $value['displayPrice'],
+                'price' => $value['priceAmount'],
+                'currency' => $value['currencySymbol'],
+                'shipping' => null,
             ];
         }
 
-        return false;
+        return null;
     }
 
     private function scrapePriceGeneric($html)
@@ -206,9 +210,21 @@ EOT;
         }
 
         $priceString = str_replace(str_split(self::WHITESPACE), '', $priceDiv->plaintext);
-        preg_match('/(\d+\.\d{0,2})/', $priceString, $matches);
+        $price = null;
+        $priceFound = false;
+
+    // find longest repeated string
+        for ($offset = 0; $offset < strlen($priceString); $offset++) {
+            for ($length = 1; substr_count($priceString, substr($priceString, $offset, $length + 1)) >= 2; $length++) {
+                $priceFound = true;
+            }
+
+            if ($priceFound) {
+                $price = substr($priceString, $offset, $length);
+                break;
+            }
+        }
 
-        $price = $matches[0] ?? null;
         $currency = str_replace($price, '', $priceString);
 
         if ($price != null && $currency != null) {
@@ -216,7 +232,7 @@ EOT;
                 'price'     => $price,
                 'displayPrice'  => null,
                 'currency'  => $currency,
-                'shipping'  => '0'
+                'shipping'  => null
             ];
         }
         return $default;
@@ -227,7 +243,7 @@ EOT;
         $html = $this->getHtml();
         $this->title = $this->getTitle($html);
         $image = $this->getImage($html);
-        $data = $this->scrapePriceGeneric($html);
+        $data = $this->scrapePriceTwister($html) ?? $this->scrapePriceGeneric($html);
 
         // render
         $content = '';
@@ -236,7 +252,7 @@ EOT;
             $price = sprintf('%s %s', $data['price'], $data['currency']);
         }
         $content .= sprintf('%s<br>Price: %s', $image, $price);
-        if ($data['shipping'] !== '0') {
+        if ($data['shipping'] !== null) {
             $content .= sprintf('<br>Shipping: %s %s</br>', $data['shipping'], $data['currency']);
         }
 

From 20fec74c633cd8ed2bb4cbbe0599604e3cf4f1c5 Mon Sep 17 00:00:00 2001
From: Joseph <VerifiedJoseph@users.noreply.github.com>
Date: Mon, 4 Aug 2025 14:41:04 +0100
Subject: [PATCH 705/716] [DailymotionBridge] Fetch playlist title from API
 (#4649)

---
 bridges/DailymotionBridge.php | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/bridges/DailymotionBridge.php b/bridges/DailymotionBridge.php
index fcaa4292..513cbbe7 100644
--- a/bridges/DailymotionBridge.php
+++ b/bridges/DailymotionBridge.php
@@ -129,8 +129,9 @@ class DailymotionBridge extends BridgeAbstract
 
     private function getPlaylistTitle($id)
     {
-        $html = getSimpleHTMLDOM(self::URI . 'playlist/' . $id);
-        return $html->find('meta[property=og:title]', 0)->getAttribute('content');
+        $apiJson = getContents($this->apiUrl . '/playlist/' . $this->getInput('p'));
+        $apiData = json_decode($apiJson, true);
+        return $apiData['name'];
     }
 
     private function getApiUrl()

From fb153f9a920edeb436ab87bc83e833264b7bfcac Mon Sep 17 00:00:00 2001
From: Joseph <VerifiedJoseph@users.noreply.github.com>
Date: Mon, 4 Aug 2025 16:19:24 +0100
Subject: [PATCH 706/716] [DansTonChatBridge] Remove bridge (#4650)

bridge is broken and website has native feeds.

https://danstonchat.com/category/quote/feed
---
 bridges/DansTonChatBridge.php | 30 ------------------------------
 1 file changed, 30 deletions(-)
 delete mode 100644 bridges/DansTonChatBridge.php

diff --git a/bridges/DansTonChatBridge.php b/bridges/DansTonChatBridge.php
deleted file mode 100644
index a7765f19..00000000
--- a/bridges/DansTonChatBridge.php
+++ /dev/null
@@ -1,30 +0,0 @@
-<?php
-
-class DansTonChatBridge extends BridgeAbstract
-{
-    const MAINTAINER = 'Astalaseven';
-    const NAME = 'DansTonChat Bridge';
-    const URI = 'https://danstonchat.com/';
-    const CACHE_TIMEOUT = 21600; //6h
-    const DESCRIPTION = 'Returns latest quotes from DansTonChat.';
-
-    public function collectData()
-    {
-        $url = self::URI . 'latest.html';
-        $dom = getSimpleHTMLDOM($url);
-
-        $items = $dom->find('div.item');
-        foreach ($items as $element) {
-            $item = [];
-            $item['uri'] = $element->find('a', 0)->href;
-            $titleContent = $element->find('h3 a', 0);
-            if ($titleContent) {
-                $item['title'] = 'DansTonChat ' . html_entity_decode($titleContent->plaintext, ENT_QUOTES);
-            } else {
-                $item['title'] = 'DansTonChat';
-            }
-            $item['content'] = $element->find('div.item-content a', 0)->innertext;
-            $this->items[] = $item;
-        }
-    }
-}

From 9e2975048fd460e8f09e843f6619c916a11d1d73 Mon Sep 17 00:00:00 2001
From: Joseph <VerifiedJoseph@users.noreply.github.com>
Date: Mon, 4 Aug 2025 21:56:27 +0100
Subject: [PATCH 707/716] [AskfmBridge] Remove bridge (#4652)

Website closed in December 2024 https://web.archive.org/web/20241129120541/https://about.ask.fm/closure-notice-the-platform-to-be-deactivated-december-1-2024/
---
 bridges/AskfmBridge.php | 80 -----------------------------------------
 1 file changed, 80 deletions(-)
 delete mode 100644 bridges/AskfmBridge.php

diff --git a/bridges/AskfmBridge.php b/bridges/AskfmBridge.php
deleted file mode 100644
index d0422890..00000000
--- a/bridges/AskfmBridge.php
+++ /dev/null
@@ -1,80 +0,0 @@
-<?php
-
-class AskfmBridge extends BridgeAbstract
-{
-    const MAINTAINER = 'az5he6ch, logmanoriginal';
-    const NAME = 'Ask.fm Answers';
-    const URI = 'https://ask.fm/';
-    const CACHE_TIMEOUT = 300; //5 min
-    const DESCRIPTION = 'Returns answers from an Ask.fm user';
-    const PARAMETERS = [
-        'Ask.fm username' => [
-            'u' => [
-                'name' => 'Username',
-                'required' => true,
-                'exampleValue'  => 'ApprovedAndReal'
-            ]
-        ]
-    ];
-
-    public function collectData()
-    {
-        $html = getSimpleHTMLDOM($this->getURI());
-
-        $html = defaultLinkTo($html, self::URI);
-
-        foreach ($html->find('article.streamItem-answer') as $element) {
-            $item = [];
-            $item['uri'] = $element->find('a.streamItem_meta', 0)->href;
-            $question = trim($element->find('header.streamItem_header', 0)->innertext);
-
-            $item['title'] = trim(
-                htmlspecialchars_decode(
-                    $element->find('header.streamItem_header', 0)->plaintext,
-                    ENT_QUOTES
-                )
-            );
-
-            $item['timestamp'] = strtotime($element->find('time', 0)->datetime);
-
-            $var = $element->find('div.streamItem_content', 0);
-            $answer = trim($var->innertext ?? '');
-
-            // This probably should be cleaned up, especially for YouTube embeds
-            if ($visual = $element->find('div.streamItem_visual', 0)) {
-                $visual = $visual->innertext;
-            }
-
-            // Fix tracking links, also doesn't work
-            foreach ($element->find('a') as $link) {
-                if (strpos($link->href, 'l.ask.fm') !== false) {
-                    $link->href = $link->plaintext;
-                }
-            }
-
-            $item['content'] = '<p>' . $question
-            . '</p><p>' . $answer
-            . '</p><p>' . $visual . '</p>';
-
-            $this->items[] = $item;
-        }
-    }
-
-    public function getName()
-    {
-        if (!is_null($this->getInput('u'))) {
-            return self::NAME . ' : ' . $this->getInput('u');
-        }
-
-        return parent::getName();
-    }
-
-    public function getURI()
-    {
-        if (!is_null($this->getInput('u'))) {
-            return self::URI . urlencode($this->getInput('u'));
-        }
-
-        return parent::getURI();
-    }
-}

From 9c43921a33ccc278b836830c63cbecfbd8f91593 Mon Sep 17 00:00:00 2001
From: Joseph <VerifiedJoseph@users.noreply.github.com>
Date: Mon, 4 Aug 2025 21:57:35 +0100
Subject: [PATCH 708/716] [FirstLookMediaTechBridge] Remove bridge (#4653)

Website no longer exists
---
 bridges/FirstLookMediaTechBridge.php | 52 ----------------------------
 1 file changed, 52 deletions(-)
 delete mode 100644 bridges/FirstLookMediaTechBridge.php

diff --git a/bridges/FirstLookMediaTechBridge.php b/bridges/FirstLookMediaTechBridge.php
deleted file mode 100644
index f9963c6f..00000000
--- a/bridges/FirstLookMediaTechBridge.php
+++ /dev/null
@@ -1,52 +0,0 @@
-<?php
-
-class FirstLookMediaTechBridge extends BridgeAbstract
-{
-    const NAME = 'First Look Media - Technology';
-    const URI = 'https://tech.firstlook.media';
-    const DESCRIPTION = 'First Look Media Technology page';
-    const MAINTAINER = 'somini';
-    const PARAMETERS = [
-        [
-            'projects' => [
-                'type' => 'checkbox',
-                'name' => 'Include Projects?',
-            ]
-        ]
-    ];
-
-    public function collectData()
-    {
-        $html = getSimpleHTMLDOM(self::URI);
-
-        if ($this->getInput('projects')) {
-            $top_projects = $html->find('.PromoList-ul', 0);
-            foreach ($top_projects->find('li.PromoList-item') as $element) {
-                $item = [];
-
-                $item_uri = $element->find('a', 0);
-                $item['uri'] = $item_uri->href;
-                $item['title'] = strip_tags($item_uri->innertext);
-                $item['content'] = $element->find('div > div', 0);
-
-                $this->items[] = $item;
-            }
-        }
-
-        $top_articles = $html->find('.PromoList-ul', 1);
-        foreach ($top_articles->find('li.PromoList-item') as $element) {
-            $item = [];
-
-            $item_left = $element->find('div > div', 0);
-            $item_date = $element->find('.PromoList-date', 0);
-            $item['timestamp'] = strtotime($item_date->innertext);
-            $item_date->outertext = '';  /* Remove */
-            $item['author'] = $item_left->innertext;
-            $item_uri = $element->find('a', 0);
-            $item['uri'] = self::URI . $item_uri->href;
-            $item['title'] = strip_tags($item_uri);
-
-            $this->items[] = $item;
-        }
-    }
-}

From b39964cee3e4b0babe739d47a604c2323fd270f0 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 5 Aug 2025 19:50:27 +0200
Subject: [PATCH 709/716] chore: prepare for aug 2025 release (#4654)

---
 lib/Configuration.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/Configuration.php b/lib/Configuration.php
index 79f2922c..37368894 100644
--- a/lib/Configuration.php
+++ b/lib/Configuration.php
@@ -7,7 +7,7 @@
  */
 final class Configuration
 {
-    private const VERSION = '2025-06-03';
+    private const VERSION = '2025-08-05';
 
     private static $config = [];
 

From f11571ae7890cb204bb67b7c4a73426bceebe31a Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 5 Aug 2025 20:44:40 +0200
Subject: [PATCH 710/716] refactor: rename functions (#4655)

returnClientError => throwClientException
returnServerError => throwServerException

New convenience function: throwRateLimitException

Old functions are kept but deprecated.
---
 bridges/ARDAudiothekBridge.php                |  2 +-
 bridges/ARDMediathekBridge.php                |  2 +-
 bridges/AllocineFRBridge.php                  |  2 +-
 bridges/AnidexBridge.php                      |  2 +-
 bridges/AppleMusicBridge.php                  |  2 +-
 bridges/AssociatedPressNewsBridge.php         |  6 ++--
 bridges/BakaUpdatesMangaReleasesBridge.php    |  2 +-
 bridges/BandcampBridge.php                    |  6 ++--
 bridges/BlueskyBridge.php                     |  2 +-
 bridges/BugzillaBridge.php                    |  4 +--
 bridges/BundestagParteispendenBridge.php      |  4 +--
 bridges/CNETBridge.php                        |  2 +-
 bridges/CVEDetailsBridge.php                  |  2 +-
 bridges/CachetBridge.php                      |  4 +--
 bridges/CastorusBridge.php                    | 12 ++++----
 bridges/CeskaTelevizeBridge.php               |  4 +--
 bridges/CssSelectorBridge.php                 |  8 +++---
 bridges/CssSelectorComplexBridge.php          | 14 +++++-----
 bridges/DevToBridge.php                       |  2 +-
 bridges/Drive2ruBridge.php                    |  4 +--
 bridges/ElektroARGOSBridge.php                | 20 ++++++-------
 bridges/FB2Bridge.php                         |  4 +--
 bridges/FacebookBridge.php                    | 26 ++++++++---------
 bridges/FeedExpanderExampleBridge.php         |  2 +-
 bridges/FlickrBridge.php                      |  2 +-
 bridges/Formula1Bridge.php                    |  2 +-
 bridges/FunkBridge.php                        |  2 +-
 bridges/GitHubGistBridge.php                  | 10 +++----
 bridges/GiteaBridge.php                       | 12 ++++----
 bridges/GlassdoorBridge.php                   |  8 +++---
 bridges/GogsBridge.php                        |  8 +++---
 bridges/GoogleSearchBridge.php                |  2 +-
 bridges/I4wifiBridge.php                      | 10 +++----
 bridges/IPBBridge.php                         | 10 +++----
 bridges/ImgsedBridge.php                      |  2 +-
 bridges/ItakuBridge.php                       |  2 +-
 bridges/ItchioBridge.php                      |  2 +-
 bridges/IvooxBridge.php                       |  2 +-
 bridges/JustETFBridge.php                     | 28 +++++++++----------
 bridges/LaCentraleBridge.php                  |  2 +-
 bridges/LeBonCoinBridge.php                   |  4 +--
 bridges/LinuxBlogBridge.php                   |  2 +-
 bridges/MallTvBridge.php                      |  4 +--
 bridges/MangaDexBridge.php                    | 10 +++----
 bridges/MinecraftBridge.php                   |  2 +-
 bridges/ModelKarteiBridge.php                 |  4 +--
 bridges/MoinMoinBridge.php                    |  2 +-
 bridges/NasestrechaBridge.php                 | 10 +++----
 bridges/NationalGeographicBridge.php          |  2 +-
 bridges/OtrkeyFinderBridge.php                |  2 +-
 bridges/PatreonBridge.php                     |  2 +-
 bridges/PepperBridgeAbstract.php              |  2 +-
 bridges/PixivBridge.php                       |  4 +--
 bridges/RedditBridge.php                      |  8 +++---
 bridges/ReutersBridge.php                     |  2 +-
 bridges/RutubeBridge.php                      |  2 +-
 bridges/SIMARBridge.php                       |  4 +--
 .../SchweinfurtBuergerinformationenBridge.php |  2 +-
 bridges/ScribdBridge.php                      |  2 +-
 bridges/SensCritiqueBridge.php                |  2 +-
 bridges/SeznamZpravyBridge.php                | 16 +++++------
 bridges/ShanaprojectBridge.php                | 12 ++++----
 bridges/SitemapBridge.php                     |  4 +--
 bridges/SkimfeedBridge.php                    | 26 ++++++++---------
 bridges/SoundcloudBridge.php                  |  6 ++--
 bridges/SpotifyBridge.php                     |  2 +-
 bridges/StockFilingsBridge.php                |  2 +-
 bridges/StorytelBridge.php                    |  2 +-
 bridges/StravaBridge.php                      |  2 +-
 bridges/StreamCzBridge.php                    | 12 ++++----
 bridges/ThePirateBayBridge.php                |  2 +-
 bridges/TrelloBridge.php                      |  2 +-
 bridges/TwitterBridge.php                     |  8 +++---
 bridges/TwitterV2Bridge.php                   | 10 +++----
 bridges/UrlebirdBridge.php                    |  2 +-
 bridges/UsenixBridge.php                      |  2 +-
 bridges/VimeoBridge.php                       |  4 +--
 bridges/Vk2Bridge.php                         |  8 +++---
 bridges/VkBridge.php                          |  6 ++--
 bridges/WebfailBridge.php                     |  2 +-
 bridges/WikipediaBridge.php                   |  6 ++--
 bridges/WiredBridge.php                       |  2 +-
 bridges/WordPressBridge.php                   |  2 +-
 bridges/XenForoBridge.php                     | 18 ++++++------
 bridges/YandexZenBridge.php                   |  2 +-
 bridges/YouTubeCommunityTabBridge.php         |  6 ++--
 bridges/YoutubeBridge.php                     | 10 +++----
 bridges/ZonebourseBridge.php                  |  2 +-
 docs/06_Helper_functions/index.md             | 17 ++++++-----
 lib/utils.php                                 | 25 +++++++++++++++--
 90 files changed, 279 insertions(+), 255 deletions(-)

diff --git a/bridges/ARDAudiothekBridge.php b/bridges/ARDAudiothekBridge.php
index 02b6b007..e6b82775 100644
--- a/bridges/ARDAudiothekBridge.php
+++ b/bridges/ARDAudiothekBridge.php
@@ -71,7 +71,7 @@ class ARDAudiothekBridge extends BridgeAbstract
 
         $pathComponents = explode('/', $path);
         if (empty($pathComponents)) {
-            returnClientError('Path may not be empty');
+            throwClientException('Path may not be empty');
         }
         if (count($pathComponents) < 2) {
             $showID = $pathComponents[0];
diff --git a/bridges/ARDMediathekBridge.php b/bridges/ARDMediathekBridge.php
index da11dd64..6f7272dc 100644
--- a/bridges/ARDMediathekBridge.php
+++ b/bridges/ARDMediathekBridge.php
@@ -65,7 +65,7 @@ class ARDMediathekBridge extends BridgeAbstract
 
         $pathComponents = explode('/', $this->getInput('path'));
         if (empty($pathComponents)) {
-            returnClientError('Path may not be empty');
+            throwClientException('Path may not be empty');
         }
         if (count($pathComponents) < 2) {
             $showID = $pathComponents[0];
diff --git a/bridges/AllocineFRBridge.php b/bridges/AllocineFRBridge.php
index e7b2adb2..f5a5b33a 100644
--- a/bridges/AllocineFRBridge.php
+++ b/bridges/AllocineFRBridge.php
@@ -57,7 +57,7 @@ class AllocineFRBridge extends BridgeAbstract
             if (array_key_exists($category, $categories)) {
                 return static::URI . $this->getLastSeasonURI($categories[$category]);
             } else {
-                returnClientError('Emission inconnue');
+                throwClientException('Emission inconnue');
             }
         }
 
diff --git a/bridges/AnidexBridge.php b/bridges/AnidexBridge.php
index 6d41365b..391ee4f8 100644
--- a/bridges/AnidexBridge.php
+++ b/bridges/AnidexBridge.php
@@ -152,7 +152,7 @@ class AnidexBridge extends BridgeAbstract
             }
         }
         if (empty($results) && empty($this->getInput('q'))) {
-            returnServerError('No results from Anidex: ' . $search_url);
+            throwServerException('No results from Anidex: ' . $search_url);
         }
 
         //Process each item individually
diff --git a/bridges/AppleMusicBridge.php b/bridges/AppleMusicBridge.php
index b633c69f..81558b6d 100644
--- a/bridges/AppleMusicBridge.php
+++ b/bridges/AppleMusicBridge.php
@@ -71,7 +71,7 @@ class AppleMusicBridge extends BridgeAbstract
         $result = $json->results;
 
         if (!is_array($result) || count($result) == 0) {
-            returnServerError('There is no artist with id "' . $this->getInput('artist') . '".');
+            throwServerException('There is no artist with id "' . $this->getInput('artist') . '".');
         }
 
         return $result;
diff --git a/bridges/AssociatedPressNewsBridge.php b/bridges/AssociatedPressNewsBridge.php
index db62c826..37dff8b9 100644
--- a/bridges/AssociatedPressNewsBridge.php
+++ b/bridges/AssociatedPressNewsBridge.php
@@ -66,10 +66,10 @@ class AssociatedPressNewsBridge extends BridgeAbstract
     {
         switch ($this->getInput('topic')) {
             case 'Podcasts':
-                returnClientError('Podcasts topic feed is not supported');
+                throwClientException('Podcasts topic feed is not supported');
                 break;
             case 'PressReleases':
-                returnClientError('PressReleases topic feed is not supported');
+                throwClientException('PressReleases topic feed is not supported');
                 break;
             default:
                 $this->collectCardData();
@@ -110,7 +110,7 @@ class AssociatedPressNewsBridge extends BridgeAbstract
         $tagContents = json_decode($json, true);
 
         if (empty($tagContents['tagObjs'])) {
-            returnClientError('Topic not found: ' . $this->getInput('topic'));
+            throwClientException('Topic not found: ' . $this->getInput('topic'));
         }
 
         $this->feedName = $tagContents['tagObjs'][0]['name'];
diff --git a/bridges/BakaUpdatesMangaReleasesBridge.php b/bridges/BakaUpdatesMangaReleasesBridge.php
index 10d59c83..8ba5fe98 100644
--- a/bridges/BakaUpdatesMangaReleasesBridge.php
+++ b/bridges/BakaUpdatesMangaReleasesBridge.php
@@ -94,7 +94,7 @@ class BakaUpdatesMangaReleasesBridge extends BridgeAbstract
         // content is an unstructured pile of divs, ugly to parse
         $cols = $html->find('div#main_content div.row > div.text');
         if (!$cols) {
-            returnServerError('No releases');
+            throwServerException('No releases');
         }
 
         $rows = array_slice(
diff --git a/bridges/BandcampBridge.php b/bridges/BandcampBridge.php
index 80bb7fd0..814317fb 100644
--- a/bridges/BandcampBridge.php
+++ b/bridges/BandcampBridge.php
@@ -123,7 +123,7 @@ class BandcampBridge extends BridgeAbstract
                 $json = json_decode($content);
 
                 if ($json->ok !== true) {
-                    returnServerError('Invalid response');
+                    throwServerException('Invalid response');
                 }
 
                 foreach ($json->items as $entry) {
@@ -165,7 +165,7 @@ class BandcampBridge extends BridgeAbstract
 
                 $regex = '/band_id=(\d+)/';
                 if (preg_match($regex, $html, $matches) == false) {
-                    returnServerError('Unable to find band ID on: ' . $this->getURI());
+                    throwServerException('Unable to find band ID on: ' . $this->getURI());
                 }
                 $band_id = $matches[1];
 
@@ -196,7 +196,7 @@ class BandcampBridge extends BridgeAbstract
                     case 'By album':
                         $regex = '/album=(\d+)/';
                         if (preg_match($regex, $html, $matches) == false) {
-                            returnServerError('Unable to find album ID on: ' . $this->getURI());
+                            throwServerException('Unable to find album ID on: ' . $this->getURI());
                         }
                         $album_id = $matches[1];
 
diff --git a/bridges/BlueskyBridge.php b/bridges/BlueskyBridge.php
index 72c4f018..bf5053be 100644
--- a/bridges/BlueskyBridge.php
+++ b/bridges/BlueskyBridge.php
@@ -154,7 +154,7 @@ class BlueskyBridge extends BridgeAbstract
             //valid DID
             $did = $user_id;
         } else {
-            returnClientError('Invalid ATproto handle or DID provided.');
+            throwClientException('Invalid ATproto handle or DID provided.');
         }
 
         $filter = $this->getInput('feed_filter') ?: 'posts_and_author_threads';
diff --git a/bridges/BugzillaBridge.php b/bridges/BugzillaBridge.php
index 23e93eb8..29112918 100644
--- a/bridges/BugzillaBridge.php
+++ b/bridges/BugzillaBridge.php
@@ -98,7 +98,7 @@ class BugzillaBridge extends BridgeAbstract
 
         // Array of comments is here
         if (!isset($json['bugs'][$this->bugid]['comments'])) {
-            returnClientError('Cannot find REST endpoint');
+            throwClientException('Cannot find REST endpoint');
         }
 
         foreach ($json['bugs'][$this->bugid]['comments'] as $comment) {
@@ -131,7 +131,7 @@ class BugzillaBridge extends BridgeAbstract
 
         // Array of changesets which contain an array of changes
         if (!isset($json['bugs']['0']['history'])) {
-            returnClientError('Cannot find REST endpoint');
+            throwClientException('Cannot find REST endpoint');
         }
 
         foreach ($json['bugs']['0']['history'] as $changeset) {
diff --git a/bridges/BundestagParteispendenBridge.php b/bridges/BundestagParteispendenBridge.php
index 773f9129..198cf534 100644
--- a/bridges/BundestagParteispendenBridge.php
+++ b/bridges/BundestagParteispendenBridge.php
@@ -30,7 +30,7 @@ URI;
 
         // Build the URL from the first anchor element. The list is sorted by year, descending, so the first element is the current year.
         $firstAnchor = $html->find('a', 0)
-            or returnServerError('Could not find the proper HTML element.');
+            or throwServerException('Could not find the proper HTML element.');
 
         $url = $firstAnchor->href;
 
@@ -38,7 +38,7 @@ URI;
         $html = getSimpleHTMLDOMCached($url, self::CACHE_TIMEOUT);
 
         $rows = $html->find('table.table > tbody > tr')
-            or returnServerError('Could not find the proper HTML elements.');
+            or throwServerException('Could not find the proper HTML elements.');
 
         foreach ($rows as $row) {
             $item = $this->generateItemFromRow($row);
diff --git a/bridges/CNETBridge.php b/bridges/CNETBridge.php
index 17c05e9b..77339c7c 100644
--- a/bridges/CNETBridge.php
+++ b/bridges/CNETBridge.php
@@ -50,7 +50,7 @@ class CNETBridge extends SitemapBridge
         }
 
         if (empty($links)) {
-            returnClientError('Failed to retrieve article list');
+            throwClientException('Failed to retrieve article list');
         }
 
         foreach ($links as $article_uri) {
diff --git a/bridges/CVEDetailsBridge.php b/bridges/CVEDetailsBridge.php
index 5f4f9daa..776f675a 100644
--- a/bridges/CVEDetailsBridge.php
+++ b/bridges/CVEDetailsBridge.php
@@ -87,7 +87,7 @@ class CVEDetailsBridge extends BridgeAbstract
 
         $vendor = $html->find('#contentdiv h1 > a', 0);
         if ($vendor == null) {
-            returnServerError('Invalid Vendor ID ' . $this->getInput('vendor_id') . ' or Product ID ' . $this->getInput('product_id'));
+            throwServerException('Invalid Vendor ID ' . $this->getInput('vendor_id') . ' or Product ID ' . $this->getInput('product_id'));
         }
         $this->vendor = $vendor->innertext;
 
diff --git a/bridges/CachetBridge.php b/bridges/CachetBridge.php
index 355e7926..7ee48a5e 100644
--- a/bridges/CachetBridge.php
+++ b/bridges/CachetBridge.php
@@ -72,14 +72,14 @@ class CachetBridge extends BridgeAbstract
     {
         $ping = getContents(urljoin($this->getURI(), '/api/v1/ping'));
         if (!$this->validatePing($ping)) {
-            returnClientError('Provided URI is invalid!');
+            throwClientException('Provided URI is invalid!');
         }
 
         $url = urljoin($this->getURI(), '/api/v1/incidents?sort=id&order=desc');
         $incidents = getContents($url);
         $incidents = json_decode($incidents);
         if ($incidents === null) {
-            returnClientError('/api/v1/incidents returned no valid json');
+            throwClientException('/api/v1/incidents returned no valid json');
         }
 
         usort($incidents->data, function ($a, $b) {
diff --git a/bridges/CastorusBridge.php b/bridges/CastorusBridge.php
index a0a1454e..43ca5c37 100644
--- a/bridges/CastorusBridge.php
+++ b/bridges/CastorusBridge.php
@@ -36,7 +36,7 @@ class CastorusBridge extends BridgeAbstract
         $title = $activity->find('a', 0);
 
         if (!$title) {
-            returnServerError('Cannot find title!');
+            throwServerException('Cannot find title!');
         }
 
         return trim($title->plaintext);
@@ -48,7 +48,7 @@ class CastorusBridge extends BridgeAbstract
         $url = $activity->find('a', 0);
 
         if (!$url) {
-            returnServerError('Cannot find url!');
+            throwServerException('Cannot find url!');
         }
 
         return self::URI . $url->href;
@@ -62,7 +62,7 @@ class CastorusBridge extends BridgeAbstract
         $nodes = $activity->find('*');
 
         if (!$nodes) {
-            returnServerError('Cannot find nodes!');
+            throwServerException('Cannot find nodes!');
         }
 
         foreach ($nodes as $node) {
@@ -78,7 +78,7 @@ class CastorusBridge extends BridgeAbstract
         $price = $activity->find('span', 1);
 
         if (!$price) {
-            returnServerError('Cannot find price!');
+            throwServerException('Cannot find price!');
         }
 
         return $price->innertext;
@@ -92,13 +92,13 @@ class CastorusBridge extends BridgeAbstract
         $html = getSimpleHTMLDOM(self::URI);
 
         if (!$html) {
-            returnServerError('Could not load data from ' . self::URI . '!');
+            throwServerException('Could not load data from ' . self::URI . '!');
         }
 
         $activities = $html->find('div#activite > li');
 
         if (!$activities) {
-            returnServerError('Failed to find activities!');
+            throwServerException('Failed to find activities!');
         }
 
         foreach ($activities as $activity) {
diff --git a/bridges/CeskaTelevizeBridge.php b/bridges/CeskaTelevizeBridge.php
index f1ed4487..ab58eeee 100644
--- a/bridges/CeskaTelevizeBridge.php
+++ b/bridges/CeskaTelevizeBridge.php
@@ -24,7 +24,7 @@ class CeskaTelevizeBridge extends BridgeAbstract
 
         $validUrl = '/^(https:\/\/www\.ceskatelevize\.cz\/porady\/\d+-[a-z0-9-]+\/)(bonus\/)?$/';
         if (!preg_match($validUrl, $url, $match)) {
-            returnServerError('Invalid url');
+            throwServerException('Invalid url');
         }
 
         $category = $match[4] ?? 'nove';
@@ -63,7 +63,7 @@ class CeskaTelevizeBridge extends BridgeAbstract
         } elseif (strpos($string, 'včera') !== false) {
             return strtotime('yesterday');
         } elseif (!preg_match('/(\d+).(\d+).((\d+))?/', $string, $match)) {
-            returnServerError('Could not get date from Česká televize string');
+            throwServerException('Could not get date from Česká televize string');
         }
 
         $date = sprintf('%04d-%02d-%02d', $match[3] ?? date('Y'), $match[2], $match[1]);
diff --git a/bridges/CssSelectorBridge.php b/bridges/CssSelectorBridge.php
index d82dbdf2..c7294aac 100644
--- a/bridges/CssSelectorBridge.php
+++ b/bridges/CssSelectorBridge.php
@@ -217,7 +217,7 @@ class CssSelectorBridge extends BridgeAbstract
         $links = $page->find($url_selector);
 
         if (empty($links)) {
-            returnClientError('No results for URL selector');
+            throwClientException('No results for URL selector');
         }
 
         $link_to_item = [];
@@ -245,13 +245,13 @@ class CssSelectorBridge extends BridgeAbstract
         }
 
         if (empty($link_to_item)) {
-            returnClientError('The provided URL selector matches some elements, but they do not contain links.');
+            throwClientException('The provided URL selector matches some elements, but they do not contain links.');
         }
 
         $links = $this->filterUrlList(array_keys($link_to_item), $url_pattern, $limit);
 
         if (empty($links)) {
-            returnClientError('No results for URL pattern');
+            throwClientException('No results for URL pattern');
         }
 
         $items = [];
@@ -274,7 +274,7 @@ class CssSelectorBridge extends BridgeAbstract
     protected function expandEntryWithSelector($entry_url, $content_selector, $content_cleanup = null, $title_cleanup = null, $title_default = null)
     {
         if (empty($content_selector)) {
-            returnClientError('Please specify a content selector');
+            throwClientException('Please specify a content selector');
         }
 
         $entry_html = getSimpleHTMLDOMCached($entry_url);
diff --git a/bridges/CssSelectorComplexBridge.php b/bridges/CssSelectorComplexBridge.php
index a2e001b2..d5946b09 100644
--- a/bridges/CssSelectorComplexBridge.php
+++ b/bridges/CssSelectorComplexBridge.php
@@ -187,7 +187,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
         // Fetch the elements from the article pages.
         if ($use_article_pages) {
             if (empty($article_page_content_selector)) {
-                returnClientError('`Article selector` is required when `Load article page` is enabled');
+                throwClientException('`Article selector` is required when `Load article page` is enabled');
             }
 
             foreach (array_keys($entry_elements) as $uri) {
@@ -307,7 +307,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
 
         $entryElements = $page->find($entry_selector);
         if (empty($entryElements)) {
-            returnClientError('No entry elements for entry selector');
+            throwClientException('No entry elements for entry selector');
         }
 
         // Extract URIs with the associated entry element
@@ -327,7 +327,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
         }
 
         if (empty($links_with_elements)) {
-            returnClientError('The provided URL selector matches some elements, but they do not 
+            throwClientException('The provided URL selector matches some elements, but they do not 
                 contain links.');
         }
 
@@ -335,7 +335,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
         $filtered_urls = $this->filterUrlList(array_keys($links_with_elements), $url_pattern, $limit);
 
         if (empty($filtered_urls)) {
-            returnClientError('No results for URL pattern');
+            throwClientException('No results for URL pattern');
         }
 
         $items = [];
@@ -359,7 +359,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
         $article_content = $entry_html->find($content_selector, 0);
 
         if (is_null($article_content)) {
-            returnClientError('Could not get article content at URL: ' . $entry_url);
+            throwClientException('Could not get article content at URL: ' . $entry_url);
         }
 
         $article_content = defaultLinkTo($article_content, $entry_url);
@@ -370,7 +370,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
     {
         $date = date_parse_from_format($format, $timeStr);
         if ($date['error_count'] != 0) {
-            returnClientError('Error while parsing time string');
+            throwClientException('Error while parsing time string');
         }
 
         $timestamp = mktime(
@@ -383,7 +383,7 @@ class CssSelectorComplexBridge extends BridgeAbstract
         );
 
         if ($timestamp == false) {
-            returnClientError('Error while creating timestamp');
+            throwClientException('Error while creating timestamp');
         }
 
         return $timestamp;
diff --git a/bridges/DevToBridge.php b/bridges/DevToBridge.php
index d1e27d79..86638f4c 100644
--- a/bridges/DevToBridge.php
+++ b/bridges/DevToBridge.php
@@ -75,7 +75,7 @@ apple-icon-5c6fa9f2bce280428589c6195b7f1924206a53b782b371cfe2d02da932c8c173.png'
         $html = defaultLinkTo($html, static::URI);
 
         $articles = $html->find('div.crayons-story')
-            or returnServerError('Could not find articles!');
+            or throwServerException('Could not find articles!');
 
         foreach ($articles as $article) {
             $item = [];
diff --git a/bridges/Drive2ruBridge.php b/bridges/Drive2ruBridge.php
index b3bd73c3..a8db31d2 100644
--- a/bridges/Drive2ruBridge.php
+++ b/bridges/Drive2ruBridge.php
@@ -204,13 +204,13 @@ class Drive2ruBridge extends BridgeAbstract
                 break;
             case 'Бортжурналы (По модели или марке)':
                 if (!preg_match('/^https:\/\/www.drive2.ru\/experience/', $this->getInput('url'))) {
-                    returnServerError('Invalid url');
+                    throwServerException('Invalid url');
                 }
                 $this->getLogbooksContent($this->getInput('url'));
                 break;
             case 'Личные блоги':
                 if (!preg_match('/^[a-zA-Z0-9-]{3,16}$/', $this->getInput('username'))) {
-                    returnServerError('Invalid username');
+                    throwServerException('Invalid username');
                 }
                 $this->getUserContent('https://www.drive2.ru/users/' . $this->getInput('username'));
                 break;
diff --git a/bridges/ElektroARGOSBridge.php b/bridges/ElektroARGOSBridge.php
index c4e692aa..35a885c6 100644
--- a/bridges/ElektroARGOSBridge.php
+++ b/bridges/ElektroARGOSBridge.php
@@ -160,7 +160,7 @@ class ElektroARGOSBridge extends BridgeAbstract
     {
         // Check if page contains articles and split by class
         $articles = $html->find('.com-news-feature-prerex') or
-            returnServerError('No articles found! Layout might have changed!');
+            throwServerException('No articles found! Layout might have changed!');
 
         // Articles loop
         foreach ($articles as $article) {
@@ -189,7 +189,7 @@ class ElektroARGOSBridge extends BridgeAbstract
     {
         // Check if page contains articles and split by class
         $articles = $html->find('.com-news-common-prerex') or
-            returnServerError('No articles found! Layout might have changed!');
+            throwServerException('No articles found! Layout might have changed!');
 
         // Articles loop
         foreach ($articles as $article) {
@@ -225,7 +225,7 @@ class ElektroARGOSBridge extends BridgeAbstract
     {
         // Check if page contains articles and split by class
         $articles = $html->find('.com-news-common-prerex') or
-            returnServerError('No articles found! Layout might have changed!');
+            throwServerException('No articles found! Layout might have changed!');
 
         // Articles loop
         foreach ($articles as $article) {
@@ -273,7 +273,7 @@ class ElektroARGOSBridge extends BridgeAbstract
     {
         // Return URI of the article
         $element = $article->find('a', 0) or
-            returnServerError('Anchor not found!');
+            throwServerException('Anchor not found!');
 
         return $element->href;
     }
@@ -307,7 +307,7 @@ class ElektroARGOSBridge extends BridgeAbstract
     {
         // Check if date is set
         $element = $article->find('div.com-news-common-prerex__date', 0) or
-            returnServerError('Date not found!');
+            throwServerException('Date not found!');
 
         return $element->plaintext;
     }
@@ -322,7 +322,7 @@ class ElektroARGOSBridge extends BridgeAbstract
     {
         // Extract description
         $element = $article->find('ul.ws-product-information__piece-description', 0)->find('li', 0) or
-            returnServerError('Description not found!');
+            throwServerException('Description not found!');
 
         return $element->innertext;
     }
@@ -337,7 +337,7 @@ class ElektroARGOSBridge extends BridgeAbstract
     {
         // Extract description
         $element = $article->find('div.ws-product-price-validity', 0)->find('div', 0) or
-            returnServerError('Description not found!');
+            throwServerException('Description not found!');
 
         return $element->innertext;
     }
@@ -352,7 +352,7 @@ class ElektroARGOSBridge extends BridgeAbstract
     {
         // Extract description
         $element = $article->find('div.ws-product-price-validity', 0)->find('div', 1) or
-            returnServerError('Description not found!');
+            throwServerException('Description not found!');
 
         return $element->innertext;
     }
@@ -454,7 +454,7 @@ class ElektroARGOSBridge extends BridgeAbstract
     {
         // Extract title
         $element = $article->find('img', 0) or
-            returnServerError('Title not found!');
+            throwServerException('Title not found!');
 
         return $element->alt;
     }
@@ -469,7 +469,7 @@ class ElektroARGOSBridge extends BridgeAbstract
     {
         // Extract title
         $element = $article->find('div.com-news-common-prerex__right-box', 0)->find('h3', 0)
-            or returnServerError('Title not found!');
+            or throwServerException('Title not found!');
 
         return $element->plaintext;
     }
diff --git a/bridges/FB2Bridge.php b/bridges/FB2Bridge.php
index 141ea59b..47ae6b3f 100644
--- a/bridges/FB2Bridge.php
+++ b/bridges/FB2Bridge.php
@@ -85,13 +85,13 @@ class FB2Bridge extends BridgeAbstract
             $pageInfo = $this->getPageInfos($page, $cookies);
 
             if ($pageInfo['userId'] === null) {
-                returnClientError(
+                throwClientException(
                     <<<EOD
 Unable to get the page id. You should consider getting the ID by hand, then importing it into FB2Bridge
 EOD
                 );
             } elseif ($pageInfo['userId'] == -1) {
-                returnClientError(
+                throwClientException(
                     <<<EOD
 This page is not accessible without being logged in.
 EOD
diff --git a/bridges/FacebookBridge.php b/bridges/FacebookBridge.php
index 3e693a38..797752f9 100644
--- a/bridges/FacebookBridge.php
+++ b/bridges/FacebookBridge.php
@@ -155,7 +155,7 @@ class FacebookBridge extends BridgeAbstract
                 break;
 
             default:
-                returnClientError('Unknown context: "' . $this->queriedContext . '"!');
+                throwClientException('Unknown context: "' . $this->queriedContext . '"!');
         }
 
         $limit = $this->getInput('limit') ?: -1;
@@ -184,7 +184,7 @@ class FacebookBridge extends BridgeAbstract
         $html = getSimpleHTMLDOM($touchURI, $header);
 
         if (!$this->isPublicGroup($html)) {
-            returnClientError('This group is not public! RSS-Bridge only supports public groups!');
+            throwClientException('This group is not public! RSS-Bridge only supports public groups!');
         }
 
         defaultLinkTo($html, substr(self::URI, 0, strlen(self::URI) - 1));
@@ -192,7 +192,7 @@ class FacebookBridge extends BridgeAbstract
         $this->groupName = $this->extractGroupName($html);
 
         $posts = $html->find('div.story_body_container')
-            or returnServerError('Failed finding posts!');
+            or throwServerException('Failed finding posts!');
 
         foreach ($posts as $post) {
             $item = [];
@@ -224,7 +224,7 @@ class FacebookBridge extends BridgeAbstract
 
             return explode('/', $urlparts['path'])[2];
         } elseif (strpos($group, '/') !== false) {
-            returnClientError('The group you provided is invalid: ' . $group);
+            throwClientException('The group you provided is invalid: ' . $group);
         } else {
             return $group;
         }
@@ -246,7 +246,7 @@ class FacebookBridge extends BridgeAbstract
             $provided_host !== $facebook_host
             && 'www.' . $provided_host !== $facebook_host
         ) {
-            returnClientError('The host you provided is invalid! Received "'
+            throwClientException('The host you provided is invalid! Received "'
                 . $provided_host
                 . '", expected "'
                 . $facebook_host
@@ -268,7 +268,7 @@ class FacebookBridge extends BridgeAbstract
     private function extractGroupName($html)
     {
         $ogtitle = $html->find('._de1', 0)
-            or returnServerError('Unable to find group title!');
+            or throwServerException('Unable to find group title!');
 
         return html_entity_decode($ogtitle->plaintext, ENT_QUOTES);
     }
@@ -276,7 +276,7 @@ class FacebookBridge extends BridgeAbstract
     private function extractGroupPostURI($post)
     {
         $elements = $post->find('a')
-            or returnServerError('Unable to find URI!');
+            or throwServerException('Unable to find URI!');
 
         foreach ($elements as $anchor) {
             // Find the one that is a permalink
@@ -292,7 +292,7 @@ class FacebookBridge extends BridgeAbstract
     private function extractGroupPostContent($post)
     {
         $content = $post->find('div._5rgt', 0)
-            or returnServerError('Unable to find user content!');
+            or throwServerException('Unable to find user content!');
 
         $context_text = $content->innertext;
         if ($content->next_sibling() !== null) {
@@ -304,7 +304,7 @@ class FacebookBridge extends BridgeAbstract
     private function extractGroupPostAuthor($post)
     {
         $element = $post->find('h3 a', 0)
-            or returnServerError('Unable to find author information!');
+            or throwServerException('Unable to find author information!');
 
         return $element->plaintext;
     }
@@ -334,7 +334,7 @@ class FacebookBridge extends BridgeAbstract
     private function extractGroupPostTitle($post)
     {
         $element = $post->find('h3', 0)
-            or returnServerError('Unable to find title!');
+            or throwServerException('Unable to find title!');
 
         if (strpos($element->plaintext, 'shared') === false) {
             $content = strip_tags($this->extractGroupPostContent($post));
@@ -370,14 +370,14 @@ class FacebookBridge extends BridgeAbstract
                 !array_key_exists('path', $urlparts)
                 || $urlparts['path'] === '/'
             ) {
-                returnClientError('The URL you provided doesn\'t contain the user name!');
+                throwClientException('The URL you provided doesn\'t contain the user name!');
             }
 
             return explode('/', $urlparts['path'])[1];
         } else {
             // First character cannot be a forward slash
             if (strpos($user, '/') === 0) {
-                returnClientError('Remove leading slash "/" from the username!');
+                throwClientException('Remove leading slash "/" from the username!');
             }
 
             return $user;
@@ -572,7 +572,7 @@ EOD;
         $loginForm = $html->find('._585r', 0);
 
         if ($loginForm != null) {
-            returnServerError('You must be logged in to view this page. This is not supported by RSS-Bridge.');
+            throwServerException('You must be logged in to view this page. This is not supported by RSS-Bridge.');
         }
 
         $mainColumn = $html->find('#pagelet_timeline_main_column');
diff --git a/bridges/FeedExpanderExampleBridge.php b/bridges/FeedExpanderExampleBridge.php
index f0af64f4..d4f41473 100644
--- a/bridges/FeedExpanderExampleBridge.php
+++ b/bridges/FeedExpanderExampleBridge.php
@@ -40,7 +40,7 @@ class FeedExpanderExampleBridge extends FeedExpander
                 parent::collectExpandableDatas('http://segfault.linuxmint.com/feed/atom/');
                 break;
             default:
-                returnClientError('Unknown version ' . $this->getInput('version') . '!');
+                throwClientException('Unknown version ' . $this->getInput('version') . '!');
         }
     }
 }
diff --git a/bridges/FlickrBridge.php b/bridges/FlickrBridge.php
index 522c7284..1707bc84 100644
--- a/bridges/FlickrBridge.php
+++ b/bridges/FlickrBridge.php
@@ -112,7 +112,7 @@ class FlickrBridge extends BridgeAbstract
                 break;
 
             default:
-                returnClientError('Invalid context: ' . $this->queriedContext);
+                throwClientException('Invalid context: ' . $this->queriedContext);
         }
 
         $model_json = $this->extractJsonModel($html);
diff --git a/bridges/Formula1Bridge.php b/bridges/Formula1Bridge.php
index 19a84e2e..28b5f6e9 100644
--- a/bridges/Formula1Bridge.php
+++ b/bridges/Formula1Bridge.php
@@ -42,7 +42,7 @@ class Formula1Bridge extends BridgeAbstract
             'locale: en'
         ]));
         if (property_exists($json, 'error')) {
-            returnServerError($json->message);
+            throwServerException($json->message);
         }
         $list = $json->items;
 
diff --git a/bridges/FunkBridge.php b/bridges/FunkBridge.php
index e4935ffb..9aea6335 100644
--- a/bridges/FunkBridge.php
+++ b/bridges/FunkBridge.php
@@ -40,7 +40,7 @@ class FunkBridge extends BridgeAbstract
                 }
                 break;
             default:
-                returnServerError('Unknown context!');
+                throwServerException('Unknown context!');
         }
     }
 
diff --git a/bridges/GitHubGistBridge.php b/bridges/GitHubGistBridge.php
index 969ee3be..4c72ac24 100644
--- a/bridges/GitHubGistBridge.php
+++ b/bridges/GitHubGistBridge.php
@@ -56,7 +56,7 @@ class GitHubGistBridge extends BridgeAbstract
         $html = defaultLinkTo($html, $this->getURI());
 
         $fileinfo = $html->find('[class~="file-info"]', 0)
-            or returnServerError('Could not find file info!');
+            or throwServerException('Could not find file info!');
 
         $this->filename = $fileinfo->plaintext;
 
@@ -68,18 +68,18 @@ class GitHubGistBridge extends BridgeAbstract
 
         foreach ($comments as $comment) {
             $uri = $comment->find('a[href*=#gistcomment]', 0)
-                or returnServerError('Could not find comment anchor!');
+                or throwServerException('Could not find comment anchor!');
 
             $title = $comment->find('h3', 0);
 
             $datetime = $comment->find('[datetime]', 0)
-                or returnServerError('Could not find comment datetime!');
+                or throwServerException('Could not find comment datetime!');
 
             $author = $comment->find('a.author', 0)
-                or returnServerError('Could not find author name!');
+                or throwServerException('Could not find author name!');
 
             $message = $comment->find('[class~="comment-body"]', 0)
-                or returnServerError('Could not find comment body!');
+                or throwServerException('Could not find comment body!');
 
             $item = [];
 
diff --git a/bridges/GiteaBridge.php b/bridges/GiteaBridge.php
index 8433b6dd..901312e2 100644
--- a/bridges/GiteaBridge.php
+++ b/bridges/GiteaBridge.php
@@ -188,7 +188,7 @@ class GiteaBridge extends BridgeAbstract
     protected function collectReleasesData($html)
     {
         $releases = $html->find('#release-list > li')
-            or returnServerError('Unable to find releases');
+            or throwServerException('Unable to find releases');
 
         foreach ($releases as $release) {
             $this->items[] = [
@@ -203,7 +203,7 @@ class GiteaBridge extends BridgeAbstract
     protected function collectTagsData($html)
     {
         $tags = $html->find('table#tags-table > tbody > tr')
-            or returnServerError('Unable to find tags');
+            or throwServerException('Unable to find tags');
 
         foreach ($tags as $tag) {
             $this->items[] = [
@@ -216,7 +216,7 @@ class GiteaBridge extends BridgeAbstract
     protected function collectCommitsData($html)
     {
         $commits = $html->find('#commits-table tbody tr')
-            or returnServerError('Unable to find commits');
+            or throwServerException('Unable to find commits');
 
         foreach ($commits as $commit) {
             $this->items[] = [
@@ -232,7 +232,7 @@ class GiteaBridge extends BridgeAbstract
     protected function collectIssuesData($html)
     {
         $issues = $html->find('.issue.list li')
-            or returnServerError('Unable to find issues');
+            or throwServerException('Unable to find issues');
 
         foreach ($issues as $issue) {
             $uri = $issue->find('a', 0)->href;
@@ -259,7 +259,7 @@ class GiteaBridge extends BridgeAbstract
     protected function collectSingleIssueOrPrData($html)
     {
         $comments = $html->find('.comment')
-            or returnServerError('Unable to find comments');
+            or throwServerException('Unable to find comments');
 
         foreach ($comments as $comment) {
             if (
@@ -293,7 +293,7 @@ class GiteaBridge extends BridgeAbstract
     protected function collectPullRequestsData($html)
     {
         $issues = $html->find('.issue.list li')
-            or returnServerError('Unable to find pull requests');
+            or throwServerException('Unable to find pull requests');
 
         foreach ($issues as $issue) {
             $uri = $issue->find('a', 0)->href;
diff --git a/bridges/GlassdoorBridge.php b/bridges/GlassdoorBridge.php
index 8c53cfa9..19946d43 100644
--- a/bridges/GlassdoorBridge.php
+++ b/bridges/GlassdoorBridge.php
@@ -98,7 +98,7 @@ class GlassdoorBridge extends BridgeAbstract
     private function collectBlogData($html, $limit)
     {
         $posts = $html->find('div.post')
-            or returnServerError('Unable to find blog posts!');
+            or throwServerException('Unable to find blog posts!');
 
         foreach ($posts as $post) {
             $item = [];
@@ -121,7 +121,7 @@ class GlassdoorBridge extends BridgeAbstract
     private function collectReviewData($html, $limit)
     {
         $reviews = $html->find('#ReviewsFeed li[id^="empReview]')
-            or returnServerError('Unable to find reviews!');
+            or throwServerException('Unable to find reviews!');
 
         foreach ($reviews as $review) {
             $item = [];
@@ -163,7 +163,7 @@ class GlassdoorBridge extends BridgeAbstract
                 FILTER_FLAG_PATH_REQUIRED
             )
         ) {
-            returnClientError('The specified URL is invalid!');
+            throwClientException('The specified URL is invalid!');
         }
 
         $uri = filter_var($uri, FILTER_SANITIZE_URL);
@@ -189,7 +189,7 @@ class GlassdoorBridge extends BridgeAbstract
         ];
 
         if (!in_array($parts[1], $allowed_strings)) {
-            returnClientError('Please specify a URL pointing to the companies review page!');
+            throwClientException('Please specify a URL pointing to the companies review page!');
         }
 
         return $uri;
diff --git a/bridges/GogsBridge.php b/bridges/GogsBridge.php
index d838674f..ceb8a502 100644
--- a/bridges/GogsBridge.php
+++ b/bridges/GogsBridge.php
@@ -141,7 +141,7 @@ class GogsBridge extends BridgeAbstract
     protected function collectCommitsData($html)
     {
         $commits = $html->find('#commits-table tbody tr')
-            or returnServerError('Unable to find commits');
+            or throwServerException('Unable to find commits');
 
         foreach ($commits as $commit) {
             $this->items[] = [
@@ -157,7 +157,7 @@ class GogsBridge extends BridgeAbstract
     protected function collectIssuesData($html)
     {
         $issues = $html->find('.issue.list li')
-            or returnServerError('Unable to find issues');
+            or throwServerException('Unable to find issues');
 
         foreach ($issues as $issue) {
             $uri = $issue->find('a', 0)->href;
@@ -185,7 +185,7 @@ class GogsBridge extends BridgeAbstract
     protected function collectSingleIssueData($html)
     {
         $comments = $html->find('.comments .comment')
-            or returnServerError('Unable to find comments');
+            or throwServerException('Unable to find comments');
 
         foreach ($comments as $comment) {
             $this->items[] = [
@@ -203,7 +203,7 @@ class GogsBridge extends BridgeAbstract
     protected function collectReleasesData($html)
     {
         $releases = $html->find('#release-list li')
-            or returnServerError('Unable to find releases');
+            or throwServerException('Unable to find releases');
 
         foreach ($releases as $release) {
             $this->items[] = [
diff --git a/bridges/GoogleSearchBridge.php b/bridges/GoogleSearchBridge.php
index 9b0713ac..08d05964 100644
--- a/bridges/GoogleSearchBridge.php
+++ b/bridges/GoogleSearchBridge.php
@@ -26,7 +26,7 @@ class GoogleSearchBridge extends BridgeAbstract
         // todo: wrap this in try..catch because 429 too many requests happens a lot
         $dom = getSimpleHTMLDOM($this->getURI(), ['Accept-language: en-US']);
         if (!$dom) {
-            returnServerError('No results for this query.');
+            throwServerException('No results for this query.');
         }
         $result = $dom->find('div[id=res]', 0);
 
diff --git a/bridges/I4wifiBridge.php b/bridges/I4wifiBridge.php
index 54620046..643057a4 100644
--- a/bridges/I4wifiBridge.php
+++ b/bridges/I4wifiBridge.php
@@ -126,7 +126,7 @@ class I4wifiBridge extends BridgeAbstract
     private function collectNews($html)
     {
         $articles = $html->find('.timeline-item.timeline-item-right')
-            or returnServerError('No articles found! Layout might have changed!');
+            or throwServerException('No articles found! Layout might have changed!');
 
         foreach ($articles as $article) {
             $item = [];
@@ -157,7 +157,7 @@ class I4wifiBridge extends BridgeAbstract
     {
         // Return URI of the article
         $element = $article->find('a', 0)
-            or returnServerError('Anchor not found!');
+            or throwServerException('Anchor not found!');
 
         return $element->href;
     }
@@ -172,7 +172,7 @@ class I4wifiBridge extends BridgeAbstract
     {
         // Check if date is set
         $element = $article->find('.timeline-item-info', 0)
-            or returnServerError('Date not found!');
+            or throwServerException('Date not found!');
 
         // Format date
         return $this->fixDate($element->plaintext);
@@ -188,7 +188,7 @@ class I4wifiBridge extends BridgeAbstract
     {
         // Extract description
         $element = $article->find('p', 0)
-            or returnServerError('Description not found!');
+            or throwServerException('Description not found!');
 
         return $element->innertext;
     }
@@ -203,7 +203,7 @@ class I4wifiBridge extends BridgeAbstract
     {
         // Extract title
         $element = $article->find('img', 0)
-            or returnServerError('Title not found!');
+            or throwServerException('Title not found!');
 
         return $element->alt;
     }
diff --git a/bridges/IPBBridge.php b/bridges/IPBBridge.php
index d5db0111..32d148fa 100644
--- a/bridges/IPBBridge.php
+++ b/bridges/IPBBridge.php
@@ -44,7 +44,7 @@ class IPBBridge extends FeedExpander
         switch (parse_url($this->getInput('uri'), PHP_URL_PATH)) {
             case null:
             case '/index.php':
-                returnClientError('Provided URI is invalid!');
+                throwClientException('Provided URI is invalid!');
                 break;
             default:
                 break;
@@ -75,7 +75,7 @@ class IPBBridge extends FeedExpander
                 $this->collectForum($html);
                 break;
             default:
-                returnClientError('Unknown type!');
+                throwClientException('Unknown type!');
                 break;
         }
     }
@@ -106,7 +106,7 @@ class IPBBridge extends FeedExpander
                 $this->collectForumTable($html);
                 break;
             default:
-                returnClientError('Unknown forum format!');
+                throwClientException('Unknown forum format!');
                 break;
         }
     }
@@ -159,7 +159,7 @@ class IPBBridge extends FeedExpander
                 $this->collectTopicHistory($html, $limit, 'collectTopicDiv');
                 break;
             default:
-                returnClientError('Unknown topic format!');
+                throwClientException('Unknown topic format!');
                 break;
         }
     }
@@ -168,7 +168,7 @@ class IPBBridge extends FeedExpander
     {
         // Make sure the callback is valid!
         if (!method_exists($this, $callback)) {
-            returnServerError('Unknown function (\'' . $callback . '\')!');
+            throwServerException('Unknown function (\'' . $callback . '\')!');
         }
 
         $next = null; // Holds the URI of the next page
diff --git a/bridges/ImgsedBridge.php b/bridges/ImgsedBridge.php
index 12466c6b..a9273813 100644
--- a/bridges/ImgsedBridge.php
+++ b/bridges/ImgsedBridge.php
@@ -258,7 +258,7 @@ HTML,
 
             // If no content type is selected, this bridge does nothing, so we return an error
             if (count($types) == 0) {
-                returnClientError('You must select at least one of the content type : Post, Stories or Tags !');
+                throwClientException('You must select at least one of the content type : Post, Stories or Tags !');
             }
             $typesText = $types[0] ?? '';
 
diff --git a/bridges/ItakuBridge.php b/bridges/ItakuBridge.php
index 0f60d486..f2eb099b 100644
--- a/bridges/ItakuBridge.php
+++ b/bridges/ItakuBridge.php
@@ -689,7 +689,7 @@ class ItakuBridge extends BridgeAbstract
         if (is_array($item) || is_object($item)) {
             $this->items[] = $item;
         } else {
-            returnServerError("Incorrectly parsed item. Check the code!\nType: " . gettype($item) . "\nprint_r(item:)\n" . var_dump($item));
+            throwServerException("Incorrectly parsed item. Check the code!\nType: " . gettype($item) . "\nprint_r(item:)\n" . var_dump($item));
         }
     }
 }
diff --git a/bridges/ItchioBridge.php b/bridges/ItchioBridge.php
index 48295d9f..b953207e 100644
--- a/bridges/ItchioBridge.php
+++ b/bridges/ItchioBridge.php
@@ -21,7 +21,7 @@ class ItchioBridge extends BridgeAbstract
         $html = getSimpleHTMLDOM($url);
         // if the page is password protected, abort
         if ($html->find('.game_password_page', 0) !== null) {
-            returnClientError('The requested page is password protected.');
+            throwClientException('The requested page is password protected.');
         }
         $title = $html->find('.game_title', 0)->innertext;
 
diff --git a/bridges/IvooxBridge.php b/bridges/IvooxBridge.php
index 0034175d..112ad36b 100644
--- a/bridges/IvooxBridge.php
+++ b/bridges/IvooxBridge.php
@@ -110,7 +110,7 @@ class IvooxBridge extends BridgeAbstract
             $this->request = str_replace(' ', '-', $this->getInput('s'));
             $url_feed = self::URI . urlencode($this->request) . '_sb_f_1.html?o=uploaddate';
         } else {
-            returnClientError('Not valid mode at IvooxBridge');
+            throwClientException('Not valid mode at IvooxBridge');
         }
 
         $dom = getSimpleHTMLDOM($url_feed);
diff --git a/bridges/JustETFBridge.php b/bridges/JustETFBridge.php
index b76ef33f..d1407c89 100644
--- a/bridges/JustETFBridge.php
+++ b/bridges/JustETFBridge.php
@@ -167,7 +167,7 @@ class JustETFBridge extends BridgeAbstract
     private function collectNews($html)
     {
         $articles = $html->find('div.newsTopArticle')
-            or returnServerError('No articles found! Layout might have changed!');
+            or throwServerException('No articles found! Layout might have changed!');
 
         foreach ($articles as $article) {
             $item = [];
@@ -184,7 +184,7 @@ class JustETFBridge extends BridgeAbstract
                 $html = getSimpleHTMLDOMCached($uri);
 
                 $fullArticle = $html->find('div.article', 0)
-                    or returnServerError('No content found! Layout might have changed!');
+                    or throwServerException('No content found! Layout might have changed!');
 
                 defaultLinkTo($fullArticle, static::URI);
 
@@ -203,7 +203,7 @@ class JustETFBridge extends BridgeAbstract
     private function extractNewsUri($article)
     {
         $element = $article->find('a', 0)
-            or returnServerError('Anchor not found!');
+            or throwServerException('Anchor not found!');
 
         return $element->href;
     }
@@ -211,7 +211,7 @@ class JustETFBridge extends BridgeAbstract
     private function extractNewsDate($article)
     {
         $element = $article->find('div.subheadline', 0)
-            or returnServerError('Date not found!');
+            or throwServerException('Date not found!');
 
         $date = trim(explode('|', $element->plaintext)[0]);
 
@@ -221,7 +221,7 @@ class JustETFBridge extends BridgeAbstract
     private function extractNewsDescription($article)
     {
         $element = $article->find('span.newsText', 0)
-            or returnServerError('Description not found!');
+            or throwServerException('Description not found!');
 
         $element->find('a', 0)->onclick = '';
 
@@ -231,7 +231,7 @@ class JustETFBridge extends BridgeAbstract
     private function extractNewsTitle($article)
     {
         $element = $article->find('h3', 0)
-            or returnServerError('Title not found!');
+            or throwServerException('Title not found!');
 
         return $element->plaintext;
     }
@@ -239,7 +239,7 @@ class JustETFBridge extends BridgeAbstract
     private function extractFullArticleContent($article)
     {
         $element = $article->find('div.article_body', 0)
-            or returnServerError('Article body not found!');
+            or throwServerException('Article body not found!');
 
         // Remove teaser image
         $element->find('img.teaser-img', 0)->outertext = '';
@@ -266,7 +266,7 @@ class JustETFBridge extends BridgeAbstract
     private function extractFullArticleAuthor($article)
     {
         $element = $article->find('span[itemprop=name]', 0)
-            or returnServerError('Author not found!');
+            or throwServerException('Author not found!');
 
         return $element->plaintext;
     }
@@ -291,7 +291,7 @@ class JustETFBridge extends BridgeAbstract
     private function extractProfileDate($html)
     {
         $element = $html->find('div.infobox div.vallabel', 0)
-            or returnServerError('Date not found!');
+            or throwServerException('Date not found!');
 
         $date = trim(explode("\r\n", $element->plaintext)[1]);
 
@@ -301,7 +301,7 @@ class JustETFBridge extends BridgeAbstract
     private function extractProfileTitle($html)
     {
         $element = $html->find('span.h1', 0)
-            or returnServerError('Title not found!');
+            or throwServerException('Title not found!');
 
         return $element->plaintext;
     }
@@ -314,12 +314,12 @@ class JustETFBridge extends BridgeAbstract
         // - Quote
 
         $strategy = $html->find('div.tab-container div.col-sm-6 p', 0)
-            or returnServerError('Investment Strategy not found!');
+            or throwServerException('Investment Strategy not found!');
 
         // Description requires a bit of cleanup due to lack of propper identification
 
         $description = $html->find('div.headline', 5)
-            or returnServerError('Description container not found!');
+            or throwServerException('Description container not found!');
 
         $description = $description->parent();
 
@@ -328,7 +328,7 @@ class JustETFBridge extends BridgeAbstract
         }
 
         $quote = $html->find('div.infobox div.val', 0)
-            or returnServerError('Quote not found!');
+            or throwServerException('Quote not found!');
 
         $quote_html = '<strong>Quote</strong><br><p>' . $quote . '</p>';
         $strategy_html = '';
@@ -350,7 +350,7 @@ class JustETFBridge extends BridgeAbstract
         // Use ISIN + WKN as author
         // Notice: "identfier" is not a typo [sic]!
         $element = $html->find('span.identfier', 0)
-            or returnServerError('Author not found!');
+            or throwServerException('Author not found!');
 
         return $element->plaintext;
     }
diff --git a/bridges/LaCentraleBridge.php b/bridges/LaCentraleBridge.php
index cf898a06..85ea3206 100644
--- a/bridges/LaCentraleBridge.php
+++ b/bridges/LaCentraleBridge.php
@@ -420,7 +420,7 @@ class LaCentraleBridge extends BridgeAbstract
             !empty($this->getInput('distance'))
             && is_null($this->getInput('location'))
         ) {
-            returnClientError('You need a place ("CP ou département") to search arround.');
+            throwClientException('You need a place ("CP ou département") to search arround.');
         }
 
         $params = [
diff --git a/bridges/LeBonCoinBridge.php b/bridges/LeBonCoinBridge.php
index 62416b98..85e5b1b5 100644
--- a/bridges/LeBonCoinBridge.php
+++ b/bridges/LeBonCoinBridge.php
@@ -339,14 +339,14 @@ class LeBonCoinBridge extends BridgeAbstract
             && !is_null($range_max)
             && $range_min > $range_max
         ) {
-            returnClientError('Min-' . $field . ' must be lower than max-' . $field . '.');
+            throwClientException('Min-' . $field . ' must be lower than max-' . $field . '.');
         }
 
         if (
             !is_null($range_min)
             && is_null($range_max)
         ) {
-            returnClientError('Max-' . $field . ' is needed when min-' . $field . ' is setted (range).');
+            throwClientException('Max-' . $field . ' is needed when min-' . $field . ' is setted (range).');
         }
 
         return [
diff --git a/bridges/LinuxBlogBridge.php b/bridges/LinuxBlogBridge.php
index e00cba52..698c1a53 100644
--- a/bridges/LinuxBlogBridge.php
+++ b/bridges/LinuxBlogBridge.php
@@ -16,7 +16,7 @@ class LinuxBlogBridge extends BridgeAbstract
         $articles = $dom->find('ul.display-posts-listing li.listing-item');
 
         if (!$articles) {
-            returnServerError('Failed to retrieve articles');
+            throwServerException('Failed to retrieve articles');
         }
 
         foreach ($articles as $article) {
diff --git a/bridges/MallTvBridge.php b/bridges/MallTvBridge.php
index 6f46d6e6..0003296d 100644
--- a/bridges/MallTvBridge.php
+++ b/bridges/MallTvBridge.php
@@ -29,7 +29,7 @@ class MallTvBridge extends BridgeAbstract
 
         $scriptLdJson = $html->find('script[type="application/ld+json"]', 0)->innertext;
         if (!preg_match('/[\'"]uploadDate[\'"]\s*:\s*[\'"](\d{4}-\d{2}-\d{2})[\'"]/', $scriptLdJson, $match)) {
-            returnServerError('Could not get date from MALL.TV detail page');
+            throwServerException('Could not get date from MALL.TV detail page');
         }
 
         return strtotime($match[1]);
@@ -40,7 +40,7 @@ class MallTvBridge extends BridgeAbstract
         $url = $this->getInput('url');
 
         if (!preg_match('/^https:\/\/www\.mall\.tv\/[a-z0-9-]+(\/[a-z0-9-]+)?\/?$/', $url)) {
-            returnServerError('Invalid url');
+            throwServerException('Invalid url');
         }
 
         $html = getSimpleHTMLDOM($url);
diff --git a/bridges/MangaDexBridge.php b/bridges/MangaDexBridge.php
index 009d2532..fa82dc4b 100644
--- a/bridges/MangaDexBridge.php
+++ b/bridges/MangaDexBridge.php
@@ -108,7 +108,7 @@ class MangaDexBridge extends BridgeAbstract
         switch ($this->queriedContext) {
             case 'Title Chapters':
                 preg_match(self::TITLE_REGEX, $this->getInput('url'), $matches)
-                or returnClientError('Invalid URL Parameter');
+                or throwClientException('Invalid URL Parameter');
                 $this->feedURI = self::URI . 'title/' . $matches['uuid'];
                 $params['order[readableAt]'] = 'desc';
                 if (!$this->getInput('external')) {
@@ -129,7 +129,7 @@ class MangaDexBridge extends BridgeAbstract
                 $uri = self::API_ROOT . 'chapter';
                 break;
             default:
-                returnServerError('Unimplemented Context (getAPI)');
+                throwServerException('Unimplemented Context (getAPI)');
         }
 
         // Remove null keys
@@ -180,7 +180,7 @@ class MangaDexBridge extends BridgeAbstract
         if ($content['result'] == 'ok') {
             $content = $content['data'];
         } else {
-            returnServerError('Could not retrieve API results');
+            throwServerException('Could not retrieve API results');
         }
 
         switch ($this->queriedContext) {
@@ -191,7 +191,7 @@ class MangaDexBridge extends BridgeAbstract
                 $this->getChapters($content);
                 break;
             default:
-                returnServerError('Unimplemented Context (collectData)');
+                throwServerException('Unimplemented Context (collectData)');
         }
     }
 
@@ -257,7 +257,7 @@ class MangaDexBridge extends BridgeAbstract
                 $header = [ 'Content-Type: application/json' ];
                 $pages = json_decode(getContents($api_uri, $header), true);
                 if ($pages['result'] != 'ok') {
-                    returnServerError('Could not retrieve API results');
+                    throwServerException('Could not retrieve API results');
                 }
 
                 if ($this->getInput('images') == 'saver') {
diff --git a/bridges/MinecraftBridge.php b/bridges/MinecraftBridge.php
index 91550e88..ca7fc913 100644
--- a/bridges/MinecraftBridge.php
+++ b/bridges/MinecraftBridge.php
@@ -21,7 +21,7 @@ class MinecraftBridge extends BridgeAbstract
         $articles = json_decode($json);
 
         if ($articles === null) {
-            returnServerError('Failed to decode JSON content.');
+            throwServerException('Failed to decode JSON content.');
         }
 
         foreach ($articles->article_grid as $article) {
diff --git a/bridges/ModelKarteiBridge.php b/bridges/ModelKarteiBridge.php
index 04b03fcf..03ccdd5b 100644
--- a/bridges/ModelKarteiBridge.php
+++ b/bridges/ModelKarteiBridge.php
@@ -22,7 +22,7 @@ class ModelKarteiBridge extends BridgeAbstract
     {
         $model_id = preg_replace('/[^0-9]/', '', $this->getInput('model_id'));
         if (empty($model_id)) {
-            returnServerError('Invalid model ID');
+            throwServerException('Invalid model ID');
         }
 
         $html = getSimpleHTMLDOM(self::URI . 'sedcards/model/' . $model_id . '/');
@@ -34,7 +34,7 @@ class ModelKarteiBridge extends BridgeAbstract
 
         $itemlist = $html->find('#photoList .photoPreview');
         if (!$itemlist) {
-            returnServerError('No gallery');
+            throwServerException('No gallery');
         }
 
         foreach ($itemlist as $idx => $element) {
diff --git a/bridges/MoinMoinBridge.php b/bridges/MoinMoinBridge.php
index c8053587..09959b45 100644
--- a/bridges/MoinMoinBridge.php
+++ b/bridges/MoinMoinBridge.php
@@ -166,7 +166,7 @@ class MoinMoinBridge extends BridgeAbstract
     private function splitSections($html)
     {
         $content = $html->find('div#page', 0)->innertext
-            or returnServerError('Unable to find <div id="page"/>!');
+            or throwServerException('Unable to find <div id="page"/>!');
 
         $sections = [];
 
diff --git a/bridges/NasestrechaBridge.php b/bridges/NasestrechaBridge.php
index d6510109..8422b98f 100644
--- a/bridges/NasestrechaBridge.php
+++ b/bridges/NasestrechaBridge.php
@@ -127,7 +127,7 @@ class NasestrechaBridge extends BridgeAbstract
     {
         // Check if page contains articles
         $articles = $html->find('.post')
-            or returnServerError('No articles found! Layout might have changed!');
+            or throwServerException('No articles found! Layout might have changed!');
 
         foreach ($articles as $article) {
             $item = [];
@@ -153,7 +153,7 @@ class NasestrechaBridge extends BridgeAbstract
     {
         // Return URI of the article
         $element = $article->find('.thumbnail', 0)
-            or returnServerError('Anchor not found!');
+            or throwServerException('Anchor not found!');
 
         return $element->href;
     }
@@ -168,7 +168,7 @@ class NasestrechaBridge extends BridgeAbstract
     {
         // Check if date is set
         $element = $article->find('div.post__info', 0)->find('span', 0)
-            or returnServerError('Date not found!');
+            or throwServerException('Date not found!');
 
         $date = trim(explode('|', $element->plaintext)[0]);
 
@@ -186,7 +186,7 @@ class NasestrechaBridge extends BridgeAbstract
     {
         // Extract description
         $element = $article->find('p.post__text', 0)
-            or returnServerError('Description not found!');
+            or throwServerException('Description not found!');
 
         return $element->innertext;
     }
@@ -201,7 +201,7 @@ class NasestrechaBridge extends BridgeAbstract
     {
         // Extract title
         $element = $article->find('a.post__title', 0)
-            or returnServerError('Title not found!');
+            or throwServerException('Title not found!');
 
         return $element->plaintext;
     }
diff --git a/bridges/NationalGeographicBridge.php b/bridges/NationalGeographicBridge.php
index 7f8f4fa2..8c9583a2 100644
--- a/bridges/NationalGeographicBridge.php
+++ b/bridges/NationalGeographicBridge.php
@@ -75,7 +75,7 @@ class NationalGeographicBridge extends BridgeAbstract
             case self::TOPIC_LATEST_STORIES:
                 return $this->collectLatestStories();
             default:
-                returnServerError('Unknown topic: "' . $this->topicName . '"');
+                throwServerException('Unknown topic: "' . $this->topicName . '"');
         }
     }
 
diff --git a/bridges/OtrkeyFinderBridge.php b/bridges/OtrkeyFinderBridge.php
index 7920ff9a..6af365fb 100644
--- a/bridges/OtrkeyFinderBridge.php
+++ b/bridges/OtrkeyFinderBridge.php
@@ -117,7 +117,7 @@ class OtrkeyFinderBridge extends BridgeAbstract
         // Do we need to check the running time?
         if ($minTime != 0 || $maxTime != 0) {
             if ($maxTime > 0 && $maxTime < $minTime) {
-                returnClientError('The minimum running time must be less than the maximum running time.');
+                throwClientException('The minimum running time must be less than the maximum running time.');
             }
 
             preg_match(self::FILENAME_REGEX, $file, $matches);
diff --git a/bridges/PatreonBridge.php b/bridges/PatreonBridge.php
index 895a9306..88bac1d6 100644
--- a/bridges/PatreonBridge.php
+++ b/bridges/PatreonBridge.php
@@ -25,7 +25,7 @@ class PatreonBridge extends BridgeAbstract
         if (preg_match($regex, $html->save(), $matches) > 0) {
             $campaign_id = $matches[1];
         } else {
-            returnServerError('Could not find campaign ID');
+            throwServerException('Could not find campaign ID');
         }
 
         $query = [
diff --git a/bridges/PepperBridgeAbstract.php b/bridges/PepperBridgeAbstract.php
index 86a488c4..027bd15e 100644
--- a/bridges/PepperBridgeAbstract.php
+++ b/bridges/PepperBridgeAbstract.php
@@ -109,7 +109,7 @@ class PepperBridgeAbstract extends BridgeAbstract
 
         // Show an error message if we can't find the thread ID in the URL sent by the user
         if ($threadSearch !== 1) {
-            returnClientError($this->i8n('thread-error'));
+            throwClientException($this->i8n('thread-error'));
         }
         $threadID = $matches[1];
 
diff --git a/bridges/PixivBridge.php b/bridges/PixivBridge.php
index e464b12d..a831fe9d 100644
--- a/bridges/PixivBridge.php
+++ b/bridges/PixivBridge.php
@@ -131,7 +131,7 @@ class PixivBridge extends BridgeAbstract
                     . '/profile/top';
                 break;
             default:
-                returnClientError('Invalid Context');
+                throwClientException('Invalid Context');
         }
         return $uri;
     }
@@ -279,7 +279,7 @@ class PixivBridge extends BridgeAbstract
             if (
                 !(strlen($proxy) > 0 && preg_match('/https?:\/\/.*/', $proxy))
             ) {
-                returnServerError('Invalid proxy_url value set. The proxy must include the HTTP/S at the beginning of the url.');
+                throwServerException('Invalid proxy_url value set. The proxy must include the HTTP/S at the beginning of the url.');
             }
         }
 
diff --git a/bridges/RedditBridge.php b/bridges/RedditBridge.php
index 398fcaf1..c088d6d3 100644
--- a/bridges/RedditBridge.php
+++ b/bridges/RedditBridge.php
@@ -116,12 +116,12 @@ class RedditBridge extends BridgeAbstract
     {
         $forbiddenKey = 'reddit_forbidden';
         if ($this->cache->get($forbiddenKey)) {
-            throw new RateLimitException();
+            throwRateLimitException();
         }
 
         $rateLimitKey = 'reddit_rate_limit';
         if ($this->cache->get($rateLimitKey)) {
-            throw new RateLimitException();
+            throwRateLimitException();
         }
 
         try {
@@ -131,10 +131,10 @@ class RedditBridge extends BridgeAbstract
                 // 403 Forbidden
                 // This can possibly mean that reddit has permanently blocked this server's ip address
                 $this->cache->set($forbiddenKey, true, 60 * 61);
-                throw new RateLimitException();
+                throwRateLimitException();
             } elseif ($e->getCode() === 429) {
                 $this->cache->set($rateLimitKey, true, 60 * 61);
-                throw new RateLimitException();
+                throwRateLimitException();
             }
             throw $e;
         }
diff --git a/bridges/ReutersBridge.php b/bridges/ReutersBridge.php
index 44beb37a..6534ee6e 100644
--- a/bridges/ReutersBridge.php
+++ b/bridges/ReutersBridge.php
@@ -355,7 +355,7 @@ class ReutersBridge extends BridgeAbstract
                 return $base_url . 'articles-by-section-alias-or-id-v1?query=' . $json_query;
                 break;
         }
-        returnServerError('unsupported endpoint');
+        throwServerException('unsupported endpoint');
     }
 
     private function addStories($title, $content, $timestamp, $author, $url, $category)
diff --git a/bridges/RutubeBridge.php b/bridges/RutubeBridge.php
index ba8ddde4..097b6eab 100644
--- a/bridges/RutubeBridge.php
+++ b/bridges/RutubeBridge.php
@@ -65,7 +65,7 @@ class RutubeBridge extends BridgeAbstract
     private function getJSONData($html)
     {
         $jsonDataRegex = '/window.reduxState = (.*);/';
-        preg_match($jsonDataRegex, $html, $matches) or returnServerError('Could not find reduxState');
+        preg_match($jsonDataRegex, $html, $matches) or throwServerException('Could not find reduxState');
         $map = [
             '\x26' => '&',
             '\x3c' => '<',
diff --git a/bridges/SIMARBridge.php b/bridges/SIMARBridge.php
index e54aa6b6..cd94d057 100644
--- a/bridges/SIMARBridge.php
+++ b/bridges/SIMARBridge.php
@@ -20,7 +20,7 @@ class SIMARBridge extends BridgeAbstract
     {
         $html = getSimpleHTMLDOM($this->getURI());
         $e_home = $html->find('#home', 0)
-            or returnServerError('Invalid site structure');
+            or throwServerException('Invalid site structure');
 
         foreach ($e_home->find('span') as $element) {
             $item = [];
@@ -34,7 +34,7 @@ class SIMARBridge extends BridgeAbstract
 
         if ($this->getInput('interventions')) {
             $e_main1 = $html->find('#menu1', 0)
-                or returnServerError('Invalid site structure');
+                or throwServerException('Invalid site structure');
 
             foreach ($e_main1->find('a') as $element) {
                 $item = [];
diff --git a/bridges/SchweinfurtBuergerinformationenBridge.php b/bridges/SchweinfurtBuergerinformationenBridge.php
index c41f9783..98ca1a5f 100644
--- a/bridges/SchweinfurtBuergerinformationenBridge.php
+++ b/bridges/SchweinfurtBuergerinformationenBridge.php
@@ -59,7 +59,7 @@ class SchweinfurtBuergerinformationenBridge extends BridgeAbstract
             if (preg_match('/artikel_id_(\d+)/', $article->id, $match)) {
                 $articleIDs[] = $match[1];
             } else {
-                returnServerError('Couldn\'t determine article ID from index page.');
+                throwServerException('Couldn\'t determine article ID from index page.');
             }
         }
 
diff --git a/bridges/ScribdBridge.php b/bridges/ScribdBridge.php
index 9c93b156..8c5721e0 100644
--- a/bridges/ScribdBridge.php
+++ b/bridges/ScribdBridge.php
@@ -71,7 +71,7 @@ EOD;
     {
         if (!is_null($this->getInput('profile'))) {
             preg_match($this->profileUrlRegex, $this->getInput('profile'), $user)
-                or returnServerError('Could not extract user ID and name from given profile URL.');
+                or throwServerException('Could not extract user ID and name from given profile URL.');
 
             return self::URI . '/' . $user[1] . '/uploads';
         }
diff --git a/bridges/SensCritiqueBridge.php b/bridges/SensCritiqueBridge.php
index f6a2ea16..27a53f00 100644
--- a/bridges/SensCritiqueBridge.php
+++ b/bridges/SensCritiqueBridge.php
@@ -67,7 +67,7 @@ class SensCritiqueBridge extends BridgeAbstract
     private function extractDataFromList($list)
     {
         if ($list === null) {
-            returnClientError('Cannot extract data from list');
+            throwClientException('Cannot extract data from list');
         }
 
         foreach ($list->find('div[data-testid="product-list-item"]') as $movie) {
diff --git a/bridges/SeznamZpravyBridge.php b/bridges/SeznamZpravyBridge.php
index f052ed1c..a7956df3 100644
--- a/bridges/SeznamZpravyBridge.php
+++ b/bridges/SeznamZpravyBridge.php
@@ -48,20 +48,20 @@ class SeznamZpravyBridge extends BridgeAbstract
 
                 $html = getSimpleHTMLDOMCached($url . $this->getInput('author'), $ONE_DAY);
                 $mainBreadcrumbs = $html->find($selectors['breadcrumbs'], 0)
-                or returnServerError('Could not get breadcrumbs for: ' . $this->getURI());
+                or throwServerException('Could not get breadcrumbs for: ' . $this->getURI());
 
                 $author = $mainBreadcrumbs->last_child()->plaintext
-                or returnServerError('Could not get author for: ' . $this->getURI());
+                or throwServerException('Could not get author for: ' . $this->getURI());
 
                 $this->feedName = $author . ' - Seznam Zprávy';
 
                 $articles = $html->find($selectors['articleList'])
-                or returnServerError('Could not find articles for: ' . $this->getURI());
+                or throwServerException('Could not find articles for: ' . $this->getURI());
 
                 foreach ($articles as $article) {
                     // Get article URL
                     $titleLink = $article->find($selectors['articleTitle'], 0)
-                    or returnServerError('Could not find title for: ' . $this->getURI());
+                    or throwServerException('Could not find title for: ' . $this->getURI());
                     $articleURL = $titleLink->href;
 
                     $articleContentHTML = getSimpleHTMLDOMCached($articleURL, $ONE_DAY);
@@ -71,9 +71,9 @@ class SeznamZpravyBridge extends BridgeAbstract
 
                     // Article text content
                     $contentElem = $articleContentHTML->find($selectors['articleContent'], 0)
-                    or returnServerError('Could not get article content for: ' . $articleURL);
+                    or throwServerException('Could not get article content for: ' . $articleURL);
                     $contentParagraphs = $contentElem->find($selectors['articleParagraphs'])
-                    or returnServerError('Could not find paragraphs for: ' . $articleURL);
+                    or throwServerException('Could not find paragraphs for: ' . $articleURL);
 
                     // If the article has an image, put that image at the start
                     $contentInitialValue = isset($articleImageElem) ? $articleImageElem->outertext : '';
@@ -83,7 +83,7 @@ class SeznamZpravyBridge extends BridgeAbstract
 
                     // Article categories
                     $breadcrumbsElem = $articleContentHTML->find($selectors['breadcrumbs'], 0)
-                        or returnServerError('Could not find breadcrumbs for: ' . $articleURL);
+                        or throwServerException('Could not find breadcrumbs for: ' . $articleURL);
                     $breadcrumbs = $breadcrumbsElem->children();
                     $numBreadcrumbs = count($breadcrumbs);
                     $categories = [];
@@ -96,7 +96,7 @@ class SeznamZpravyBridge extends BridgeAbstract
 
                     // Article date & time
                     $articleTimeElem = $article->find($selectors['articleTime'], 0)
-                    or returnServerError('Could not find article time for: ' . $articleURL);
+                    or throwServerException('Could not find article time for: ' . $articleURL);
                     $articleTime = $articleTimeElem->plaintext;
 
                     $articleDMElem = $article->find($selectors['articleDM'], 0);
diff --git a/bridges/ShanaprojectBridge.php b/bridges/ShanaprojectBridge.php
index d4946428..dc458a37 100644
--- a/bridges/ShanaprojectBridge.php
+++ b/bridges/ShanaprojectBridge.php
@@ -41,7 +41,7 @@ class ShanaprojectBridge extends BridgeAbstract
         $html = $this->loadSeasonAnimeList();
 
         $animes = $html->find('div.header_display_box_info')
-            or returnServerError('Could not find anime headers!');
+            or throwServerException('Could not find anime headers!');
 
         $min_episodes = $this->getInput('min_episodes') ?: 0;
         $min_total_episodes = $this->getInput('min_total_episodes') ?: 0;
@@ -89,7 +89,7 @@ class ShanaprojectBridge extends BridgeAbstract
         $html = defaultLinkTo($html, self::URI . '/seasons');
 
         $season = $html->find('div.follows_menu > a', 1)
-            or returnServerError('Could not find \'Season Anime List\'!');
+            or throwServerException('Could not find \'Season Anime List\'!');
 
         $html = getSimpleHTMLDOM($season->href);
 
@@ -104,7 +104,7 @@ class ShanaprojectBridge extends BridgeAbstract
     private function extractAnimeTitle($anime)
     {
         $title = $anime->find('a', 0)
-            or returnServerError('Could not find anime title!');
+            or throwServerException('Could not find anime title!');
         return trim($title->innertext);
     }
 
@@ -112,7 +112,7 @@ class ShanaprojectBridge extends BridgeAbstract
     private function extractAnimeUri($anime)
     {
         $uri = $anime->find('a', 0)
-            or returnServerError('Could not find anime URI!');
+            or throwServerException('Could not find anime URI!');
         return $uri->href;
     }
 
@@ -144,7 +144,7 @@ class ShanaprojectBridge extends BridgeAbstract
     private function extractAnimeEpisodeInformation($anime)
     {
         $episode = $anime->find('div.header_info_episode', 0)
-            or returnServerError('Could not find anime episode information!');
+            or throwServerException('Could not find anime episode information!');
 
         $retVal = preg_replace('/\r|\n/', ' ', $episode->plaintext);
         $retVal = preg_replace('/\s+/', ' ', $retVal);
@@ -162,7 +162,7 @@ class ShanaprojectBridge extends BridgeAbstract
             return $matches[1];
         }
 
-        returnServerError('Could not extract background image!');
+        throwServerException('Could not extract background image!');
     }
 
     // Builds an URI to search for a specific anime (subber is left empty)
diff --git a/bridges/SitemapBridge.php b/bridges/SitemapBridge.php
index 071cb0ef..ca859190 100644
--- a/bridges/SitemapBridge.php
+++ b/bridges/SitemapBridge.php
@@ -85,7 +85,7 @@ class SitemapBridge extends CssSelectorBridge
         $links = $this->sitemapXmlToList($sitemap_xml, $url_pattern, empty($limit) ? 10 : $limit);
 
         if (empty($links) && empty($this->sitemapXmlToList($sitemap_xml))) {
-            returnClientError('Could not retrieve URLs with Timestamps from Sitemap: ' . $sitemap_url);
+            throwClientException('Could not retrieve URLs with Timestamps from Sitemap: ' . $sitemap_url);
         }
 
         foreach ($links as $link) {
@@ -117,7 +117,7 @@ class SitemapBridge extends CssSelectorBridge
                     $url = urljoin($url, '/sitemap.xml');
                     return $sitemap;
                 } else {
-                    returnClientError('Failed to locate Sitemap from /robots.txt or /sitemap.xml. Try setting it manually.');
+                    throwClientException('Failed to locate Sitemap from /robots.txt or /sitemap.xml. Try setting it manually.');
                 }
             }
             $url = $matches[1];
diff --git a/bridges/SkimfeedBridge.php b/bridges/SkimfeedBridge.php
index bad1af15..0bfb9b89 100644
--- a/bridges/SkimfeedBridge.php
+++ b/bridges/SkimfeedBridge.php
@@ -562,7 +562,7 @@ class SkimfeedBridge extends BridgeAbstract
     private function extractFeed($html, $author)
     {
         $articles = $html->find('li')
-            or returnServerError('Could not find articles!');
+            or throwServerException('Could not find articles!');
 
         if (
             count($articles) === 1
@@ -575,7 +575,7 @@ class SkimfeedBridge extends BridgeAbstract
 
         foreach ($articles as $article) {
             $anchor = $article->find('a', 0)
-                or returnServerError('Could not find anchor!');
+                or throwServerException('Could not find anchor!');
 
             $item = [];
 
@@ -600,13 +600,13 @@ class SkimfeedBridge extends BridgeAbstract
     private function extractHotTopics($html)
     {
         $topics = $html->find('#popbox ul li')
-            or returnServerError('Could not find topics!');
+            or throwServerException('Could not find topics!');
 
         $limit = $this->getInput('limit') ?: -1;
 
         foreach ($topics as $topic) {
             $anchor = $topic->find('a', 0)
-                or returnServerError('Could not find anchor!');
+                or throwServerException('Could not find anchor!');
 
             $item = [];
 
@@ -624,11 +624,11 @@ class SkimfeedBridge extends BridgeAbstract
     private function extractCustomFeed($html)
     {
         $boxes = $html->find('#boxx .boxes')
-            or returnServerError('Could not find boxes!');
+            or throwServerException('Could not find boxes!');
 
         foreach ($boxes as $box) {
             $anchor = $box->find('span.boxtitles a', 0)
-                or returnServerError('Could not find box anchor!');
+                or throwServerException('Could not find box anchor!');
 
             $author = '<a href="' . $anchor->href . '">' . trim($anchor->plaintext) . '</a>';
             $uri    = $anchor->href;
@@ -667,11 +667,11 @@ class SkimfeedBridge extends BridgeAbstract
         $html = getSimpleHTMLDOMCached(static::URI);
 
         if (!$this->isCompatible($html)) {
-            returnServerError('Skimfeed version is not compatible!');
+            throwServerException('Skimfeed version is not compatible!');
         }
 
         $boxes = $html->find('#boxx .boxes')
-            or returnServerError('Could not find boxes!');
+            or throwServerException('Could not find boxes!');
 
         // begin of 'channel' list
         $message = <<<EOD
@@ -686,7 +686,7 @@ EOD;
 
         foreach ($boxes as $box) {
             $anchor = $box->find('span.boxtitles a', 0)
-                or returnServerError('Could not find box anchor!');
+                or throwServerException('Could not find box anchor!');
 
             $title  = trim($anchor->plaintext);
             $uri    = $anchor->href;
@@ -723,11 +723,11 @@ EOD;
         $html = getSimpleHTMLDOMCached(static::URI);
 
         if (!$this->isCompatible($html)) {
-            returnServerError('Skimfeed version is not compatible!');
+            throwServerException('Skimfeed version is not compatible!');
         }
 
         $channels = $html->find('#menubar a')
-            or returnServerError('Could not find channels!');
+            or throwServerException('Could not find channels!');
 
         // begin of 'tech_channel' list
         $message = <<<EOD
@@ -759,11 +759,11 @@ EOD;
             $channel_html = getSimpleHTMLDOMCached(static::URI . $uri);
 
             $boxes = $channel_html->find('#boxx .boxes')
-                or returnServerError('Could not find boxes!');
+                or throwServerException('Could not find boxes!');
 
             foreach ($boxes as $box) {
                 $anchor = $box->find('span.boxtitles a', 0)
-                    or returnServerError('Could not find box anchor!');
+                    or throwServerException('Could not find box anchor!');
 
                 $boxtitle   = trim($anchor->plaintext);
                 $boxuri     = $anchor->href;
diff --git a/bridges/SoundcloudBridge.php b/bridges/SoundcloudBridge.php
index e389c965..6718351f 100644
--- a/bridges/SoundcloudBridge.php
+++ b/bridges/SoundcloudBridge.php
@@ -48,7 +48,7 @@ class SoundCloudBridge extends BridgeAbstract
         $this->feedIcon = $res->avatar_url;
 
         $apiItems = $this->getUserItems($res->id, $this->getInput('t'))
-            or returnServerError('No results for ' . $this->getInput('t'));
+            or throwServerException('No results for ' . $this->getInput('t'));
 
         $hasTrackObject = ['all', 'reposts', 'likes'];
 
@@ -131,7 +131,7 @@ HTML;
 
         // Extract widget JS filenames from player page
         if (preg_match_all($this->widgetRegex, $playerHTML, $matches) == false) {
-            returnServerError('Unable to find widget JS URL.');
+            throwServerException('Unable to find widget JS URL.');
         }
 
         $clientID = '';
@@ -150,7 +150,7 @@ HTML;
         }
 
         if (empty($clientID)) {
-            returnServerError('Unable to find client ID.');
+            throwServerException('Unable to find client ID.');
         }
     }
 
diff --git a/bridges/SpotifyBridge.php b/bridges/SpotifyBridge.php
index ab093a61..69449e04 100644
--- a/bridges/SpotifyBridge.php
+++ b/bridges/SpotifyBridge.php
@@ -108,7 +108,7 @@ class SpotifyBridge extends BridgeAbstract
             if ($e->getCode() === 429) {
                 $retryAfter = $e->response->getHeader('Retry-After') ?? (60 * 5);
                 $this->cache->set($cacheKey, true, $retryAfter);
-                throw new RateLimitException(sprintf('Rate limited by spotify, try again in %s seconds', $retryAfter));
+                throwRateLimitException(sprintf('Rate limited by spotify, try again in %s seconds', $retryAfter));
             }
             throw $e;
         }
diff --git a/bridges/StockFilingsBridge.php b/bridges/StockFilingsBridge.php
index 0b6a06a4..06332667 100644
--- a/bridges/StockFilingsBridge.php
+++ b/bridges/StockFilingsBridge.php
@@ -80,7 +80,7 @@ class StockFilingsBridge extends FeedExpander
         if ($rssFeedUrl) {
             parent::collectExpandableDatas($rssFeedUrl);
         } else {
-            returnClientError('Could not find RSS Feed URL. Are you sure you used a valid CIK?');
+            throwClientException('Could not find RSS Feed URL. Are you sure you used a valid CIK?');
         }
     }
 }
diff --git a/bridges/StorytelBridge.php b/bridges/StorytelBridge.php
index a33b3e4a..668bc836 100644
--- a/bridges/StorytelBridge.php
+++ b/bridges/StorytelBridge.php
@@ -21,7 +21,7 @@ class StorytelBridge extends BridgeAbstract
         $url = $this->getInput('url');
 
         if (!preg_match('/^https:\/\/www\.storytel\.com/', $url)) {
-            returnServerError('Invalid URL: Only Storytel URLs are allowed.');
+            throwServerException('Invalid URL: Only Storytel URLs are allowed.');
         }
 
         $html = getSimpleHTMLDOM($url);
diff --git a/bridges/StravaBridge.php b/bridges/StravaBridge.php
index da1739cb..d7a72409 100644
--- a/bridges/StravaBridge.php
+++ b/bridges/StravaBridge.php
@@ -30,7 +30,7 @@ class StravaBridge extends BridgeAbstract
 
         $dom = getSimpleHTMLDOM(self::URI . '/athletes/' . $athleteID);
         $scriptRegex = "/data-react-props='(.*?)'/";
-        preg_match($scriptRegex, $dom, $matches) or returnServerError('Could not find json');
+        preg_match($scriptRegex, $dom, $matches) or throwServerException('Could not find json');
         $jsonData = json_decode(html_entity_decode($matches[1]));
         $this->feedName = $jsonData->athlete->name . "'s Recent Activities";
         $this->iconURL = $jsonData->athlete->avatarUrl;
diff --git a/bridges/StreamCzBridge.php b/bridges/StreamCzBridge.php
index 42b1e1f1..c694f094 100644
--- a/bridges/StreamCzBridge.php
+++ b/bridges/StreamCzBridge.php
@@ -24,7 +24,7 @@ class StreamCzBridge extends BridgeAbstract
 
         $validUrl = '/^(https:\/\/www.stream.cz\/[a-z0-9-]+)(\/[a-z0-9-]+-\d+)?$/';
         if (!preg_match($validUrl, $url, $match)) {
-            returnServerError('Invalid url');
+            throwServerException('Invalid url');
         }
 
         $fixedUrl = $match[1];
@@ -35,25 +35,25 @@ class StreamCzBridge extends BridgeAbstract
 
         $scriptElement = $html->find('body script', -1);
         if (null === $scriptElement) {
-            returnServerError('Could not find metadata element on the page');
+            throwServerException('Could not find metadata element on the page');
         }
         $json = extractFromDelimiters($scriptElement->innertext, 'data : ', 'logs : ');
         if (false === $json) {
-            returnServerError('Could not extract metadata from the page');
+            throwServerException('Could not extract metadata from the page');
         }
         $data = json_decode(trim($json, ",\t\n\r\0\x0B"), true);
         if (false === $data) {
-            returnServerError('Could not parse metadata on the page');
+            throwServerException('Could not parse metadata on the page');
         }
 
         $showData = $data['fetchable']['tag']['show']['data'];
         if (!is_array($showData)) {
-            returnServerError('Show not found in metadata');
+            throwServerException('Show not found in metadata');
         }
         $this->feedName = $showData['name'];
         $episodes = $showData['allEpisodesConnection']['edges'];
         if (!is_array($episodes)) {
-            returnServerError('Episodes not found in metadata');
+            throwServerException('Episodes not found in metadata');
         }
         foreach ($episodes as $episode) {
             if (!$episode['node']) {
diff --git a/bridges/ThePirateBayBridge.php b/bridges/ThePirateBayBridge.php
index fd4a31ac..0426be9b 100644
--- a/bridges/ThePirateBayBridge.php
+++ b/bridges/ThePirateBayBridge.php
@@ -134,7 +134,7 @@ class ThePirateBayBridge extends BridgeAbstract
                 $query = sprintf('/q.php?q=user:%s', rawurlencode($keyword));
                 break;
             default:
-                returnClientError('Impossible');
+                throwClientException('Impossible');
         }
         $api = 'https://apibay.org';
         $json = getContents($api . $query);
diff --git a/bridges/TrelloBridge.php b/bridges/TrelloBridge.php
index 42651fd1..a9e6b544 100644
--- a/bridges/TrelloBridge.php
+++ b/bridges/TrelloBridge.php
@@ -616,7 +616,7 @@ class TrelloBridge extends BridgeAbstract
                 $data = $this->queryAPI('cards/' . $this->getInput('c'), $apiParams);
                 break;
             default:
-                returnClientError('Invalid context');
+                throwClientException('Invalid context');
         }
 
         $this->feedName = $data->name;
diff --git a/bridges/TwitterBridge.php b/bridges/TwitterBridge.php
index 800fd63c..a4a0bac7 100644
--- a/bridges/TwitterBridge.php
+++ b/bridges/TwitterBridge.php
@@ -289,19 +289,19 @@ EOD
                 $data = $api->fetchListTweets($query, $this->queriedContext);
                 break;
             default:
-                returnServerError('Invalid query context !');
+                throwServerException('Invalid query context !');
         }
 
         if (!$data) {
             switch ($this->queriedContext) {
                 case 'By keyword or hashtag':
-                    returnServerError('twitter: No results for this query.');
+                    throwServerException('twitter: No results for this query.');
                     // fall-through
                 case 'By username':
-                    returnServerError('Requested username can\'t be found.');
+                    throwServerException('Requested username can\'t be found.');
                     // fall-through
                 case 'By list':
-                    returnServerError('Requested username or list can\'t be found');
+                    throwServerException('Requested username or list can\'t be found');
             }
         }
 
diff --git a/bridges/TwitterV2Bridge.php b/bridges/TwitterV2Bridge.php
index 19b27137..a57631f0 100644
--- a/bridges/TwitterV2Bridge.php
+++ b/bridges/TwitterV2Bridge.php
@@ -192,7 +192,7 @@ EOD
                 . $this->getInput('u'), $authHeaders, $params);
 
                 if (isset($user->errors)) {
-                    returnServerError('Requested username can\'t be found.');
+                    throwServerException('Requested username can\'t be found.');
                 }
 
                 // Set default params
@@ -258,7 +258,7 @@ EOD
                 break;
 
             default:
-                returnServerError('Invalid query context !');
+                throwServerException('Invalid query context !');
         }
 
         if (
@@ -267,13 +267,13 @@ EOD
         ) {
             switch ($this->queriedContext) {
                 case 'By keyword or hashtag':
-                    returnServerError('No results for this query.');
+                    throwServerException('No results for this query.');
                     // fall-through
                 case 'By username':
-                    returnServerError('Requested username cannnot be found.');
+                    throwServerException('Requested username cannnot be found.');
                     // fall-through
                 case 'By list ID':
-                    returnServerError('Requested list cannnot be found');
+                    throwServerException('Requested list cannnot be found');
                     // fall-through
             }
         }
diff --git a/bridges/UrlebirdBridge.php b/bridges/UrlebirdBridge.php
index 38f73249..63b75fc9 100644
--- a/bridges/UrlebirdBridge.php
+++ b/bridges/UrlebirdBridge.php
@@ -31,7 +31,7 @@ class UrlebirdBridge extends BridgeAbstract
                 $url = 'https://urlebird.com/hash/' . substr($this->getInput('query'), 1) . '/';
                 break;
             default:
-                returnServerError('Please, enter valid username or hashtag!');
+                throwServerException('Please, enter valid username or hashtag!');
                 break;
         }
 
diff --git a/bridges/UsenixBridge.php b/bridges/UsenixBridge.php
index 659f012d..9e7ecdd8 100644
--- a/bridges/UsenixBridge.php
+++ b/bridges/UsenixBridge.php
@@ -19,7 +19,7 @@ final class UsenixBridge extends BridgeAbstract
             $this->collectLoginOnlineItems();
             return;
         }
-        returnClientError('Illegal Context');
+        throwClientException('Illegal Context');
     }
 
     private function collectLoginOnlineItems(): void
diff --git a/bridges/VimeoBridge.php b/bridges/VimeoBridge.php
index 80bfb8ac..262ad81b 100644
--- a/bridges/VimeoBridge.php
+++ b/bridges/VimeoBridge.php
@@ -81,7 +81,7 @@ class VimeoBridge extends BridgeAbstract
         }
 
         if (is_null($json)) {
-            returnClientError('No results for this query!');
+            throwClientException('No results for this query!');
         }
 
         foreach ($json->api->initial_json->data as $element) {
@@ -103,7 +103,7 @@ class VimeoBridge extends BridgeAbstract
                     break;
 
                 default:
-                    returnServerError('Unknown type: ' . $element->type);
+                    throwServerException('Unknown type: ' . $element->type);
             }
         }
     }
diff --git a/bridges/Vk2Bridge.php b/bridges/Vk2Bridge.php
index f52850ce..5f3d4033 100644
--- a/bridges/Vk2Bridge.php
+++ b/bridges/Vk2Bridge.php
@@ -194,7 +194,7 @@ class Vk2Bridge extends BridgeAbstract
     public function collectData()
     {
         if ($this->cache->get($this->rateLimitCacheKey)) {
-            throw new RateLimitException();
+            throwRateLimitException();
         }
 
         $u = $this->getInput('u');
@@ -229,7 +229,7 @@ class Vk2Bridge extends BridgeAbstract
         }
 
         if (is_null($ownerId)) {
-            returnServerError('Could not detect owner id');
+            throwServerException('Could not detect owner id');
         }
 
         $r = $this->api('wall.get', [
@@ -304,7 +304,7 @@ class Vk2Bridge extends BridgeAbstract
     {
         $access_token = $this->getOption('access_token');
         if (!$access_token) {
-            returnServerError('You cannot run VK API methods without access_token');
+            throwServerException('You cannot run VK API methods without access_token');
         }
         $params['v'] = '5.131';
         $r = json_decode(
@@ -322,7 +322,7 @@ class Vk2Bridge extends BridgeAbstract
                 // if that limit is hit, VK returns error 29
                 $this->cache->set($this->rateLimitCacheKey, true, 60 * 30);
             }
-            returnServerError('API returned error: ' . $r['error']['error_msg'] . ' (' . $r['error']['error_code'] . ')');
+            throwServerException('API returned error: ' . $r['error']['error_msg'] . ' (' . $r['error']['error_code'] . ')');
         }
         return $r;
     }
diff --git a/bridges/VkBridge.php b/bridges/VkBridge.php
index 54b2897a..4d75231b 100644
--- a/bridges/VkBridge.php
+++ b/bridges/VkBridge.php
@@ -526,17 +526,17 @@ class VkBridge extends BridgeAbstract
             $uri = urljoin(self::URI, $headers['location'][0]);
 
             if (str_contains($uri, '/429.html')) {
-                throw new RateLimitException();
+                throwRateLimitException();
             }
 
             if (!preg_match('#^https?://vk.com/#', $uri)) {
-                returnServerError('Unexpected redirect location: ' . $uri);
+                throwServerException('Unexpected redirect location: ' . $uri);
             }
 
             $redirects++;
         }
 
-        returnServerError('Too many redirects, while retreving content from VK');
+        throwServerException('Too many redirects, while retreving content from VK');
     }
 
     protected function appendVideo($video_title, $video_link, $previewImg, &$content_suffix)
diff --git a/bridges/WebfailBridge.php b/bridges/WebfailBridge.php
index 09e73c2d..d969ab07 100644
--- a/bridges/WebfailBridge.php
+++ b/bridges/WebfailBridge.php
@@ -61,7 +61,7 @@ class WebfailBridge extends BridgeAbstract
                 $this->extractArticle($html);
                 break;
             default:
-                returnClientError('Unknown type: ' . $type);
+                throwClientException('Unknown type: ' . $type);
         }
     }
 
diff --git a/bridges/WikipediaBridge.php b/bridges/WikipediaBridge.php
index 0907db76..141e3056 100644
--- a/bridges/WikipediaBridge.php
+++ b/bridges/WikipediaBridge.php
@@ -113,7 +113,7 @@ class WikipediaBridge extends BridgeAbstract
         $function = 'getContents' . ucfirst(strtolower($this->getInput('language')));
 
         if (!method_exists($this, $function)) {
-            returnServerError('A function to get the contents for your language is missing (\'' . $function . '\')!');
+            throwServerException('A function to get the contents for your language is missing (\'' . $function . '\')!');
         }
 
         /*
@@ -205,13 +205,13 @@ class WikipediaBridge extends BridgeAbstract
         $content_html = getSimpleHTMLDOMCached($uri);
 
         if (!$content_html) {
-            returnServerError('Could not load site: ' . $uri . '!');
+            throwServerException('Could not load site: ' . $uri . '!');
         }
 
         $content = $content_html->find('#mw-content-text', 0);
 
         if (!$content) {
-            returnServerError('Could not find content in page: ' . $uri . '!');
+            throwServerException('Could not find content in page: ' . $uri . '!');
         }
 
         // Let's remove a couple of things from the article
diff --git a/bridges/WiredBridge.php b/bridges/WiredBridge.php
index f7da288c..b77e3973 100644
--- a/bridges/WiredBridge.php
+++ b/bridges/WiredBridge.php
@@ -32,7 +32,7 @@ class WiredBridge extends FeedExpander
     {
         $feed = $this->getInput('feed');
         if (empty($feed) || !ctype_alpha(str_replace('-', '', $feed))) {
-            returnClientError('Invalid feed, please check the "feed" parameter.');
+            throwClientException('Invalid feed, please check the "feed" parameter.');
         }
 
         $feed_url = $this->getURI() . 'feed/';
diff --git a/bridges/WordPressBridge.php b/bridges/WordPressBridge.php
index 84a6b8ab..723a16c4 100644
--- a/bridges/WordPressBridge.php
+++ b/bridges/WordPressBridge.php
@@ -25,7 +25,7 @@ class WordPressBridge extends FeedExpander
         $limit = $this->getInput('limit') ?? 10;
         if ($this->getInput('url') && substr($this->getInput('url'), 0, strlen('http')) !== 'http') {
             // just in case someone find a way to access local files by playing with the url
-            returnClientError('The url parameter must either refer to http or https protocol.');
+            throwClientException('The url parameter must either refer to http or https protocol.');
         }
         try {
             $this->collectExpandableDatas($this->getURI() . '/feed/atom/', $limit);
diff --git a/bridges/XenForoBridge.php b/bridges/XenForoBridge.php
index 52c63948..bbef2816 100644
--- a/bridges/XenForoBridge.php
+++ b/bridges/XenForoBridge.php
@@ -81,24 +81,24 @@ class XenForoBridge extends BridgeAbstract
         );
 
         if ($this->threadurl === false) {
-            returnClientError('The URL you provided is invalid!');
+            throwClientException('The URL you provided is invalid!');
         }
 
         $urlparts = parse_url($this->threadurl, PHP_URL_SCHEME);
 
         // Scheme must be "http" or "https"
         if (preg_match('/http[s]{0,1}/', parse_url($this->threadurl, PHP_URL_SCHEME)) == false) {
-            returnClientError('The URL you provided doesn\'t specify a valid scheme (http or https)!');
+            throwClientException('The URL you provided doesn\'t specify a valid scheme (http or https)!');
         }
 
         // Path cannot be root (../)
         if (parse_url($this->threadurl, PHP_URL_PATH) === '/') {
-            returnClientError('The URL you provided doesn\'t link to a valid thread (root path)!');
+            throwClientException('The URL you provided doesn\'t link to a valid thread (root path)!');
         }
 
         // XenForo adds a thread ID to the URL, like "...-thread.454934283". It must be present
         if (preg_match('/.+\.\d+[\/]{0,1}/', parse_URL($this->threadurl, PHP_URL_PATH)) == false) {
-            returnClientError('The URL you provided doesn\'t link to a valid thread (ID missing)!');
+            throwClientException('The URL you provided doesn\'t link to a valid thread (ID missing)!');
         }
 
         // We want to start at the first page in the thread. XenForo uses "../page-n" syntax
@@ -121,13 +121,13 @@ class XenForoBridge extends BridgeAbstract
         } elseif ($mainContent = $html->find('div[class~="p-body"]', 0)) {
             $this->version = self::XENFORO_VERSION_2;
         } else {
-            returnServerError('This forum is currently not supported!');
+            throwServerException('This forum is currently not supported!');
         }
 
         switch ($this->version) {
             case self::XENFORO_VERSION_1:
                 $titleBar = $mainContent->find('div.titleBar > h1', 0)
-                    or returnServerError('Error finding title bar!');
+                    or throwServerException('Error finding title bar!');
 
                 $this->title = $titleBar->plaintext;
 
@@ -139,7 +139,7 @@ class XenForoBridge extends BridgeAbstract
 
             case self::XENFORO_VERSION_2:
                 $titleBar = $mainContent->find('div[class~="p-title"] h1', 0)
-                    or returnServerError('Error finding title bar!');
+                    or throwServerException('Error finding title bar!');
 
                 $this->title = $titleBar->plaintext;
                 $this->extractThreadPostsV2($html, $this->threadurl);
@@ -166,7 +166,7 @@ class XenForoBridge extends BridgeAbstract
 
         // Posts are contained in an "ol"
         $messageList = $html->find('#messageList > li')
-            or returnServerError('Error finding message list!');
+            or throwServerException('Error finding message list!');
 
         foreach ($messageList as $post) {
             if (!isset($post->attr['id'])) { // Skip ads
@@ -252,7 +252,7 @@ class XenForoBridge extends BridgeAbstract
         $lang = $html->find('html', 0)->lang;
 
         $messageList = $html->find('div[class~="block-body"] article')
-            or returnServerError('Error finding message list!');
+            or throwServerException('Error finding message list!');
 
         foreach ($messageList as $post) {
             if (!isset($post->attr['id'])) { // Skip ads
diff --git a/bridges/YandexZenBridge.php b/bridges/YandexZenBridge.php
index 57242328..e3ace55e 100644
--- a/bridges/YandexZenBridge.php
+++ b/bridges/YandexZenBridge.php
@@ -47,7 +47,7 @@ class YandexZenBridge extends BridgeAbstract
             $channelName = $matches['channelName'];
             $channelAPIURL = self::_BASE_API_URL_WITH_CHANNEL_NAME . $channelName;
         } else {
-            returnClientError(<<<EOT
+            throwClientException(<<<EOT
 Invalid channel URL provided.
 The channel\'s URL must be in one of these two forms:
 - https://dzen.ru/dream_faity_diy
diff --git a/bridges/YouTubeCommunityTabBridge.php b/bridges/YouTubeCommunityTabBridge.php
index d6a70bd6..b14ec246 100644
--- a/bridges/YouTubeCommunityTabBridge.php
+++ b/bridges/YouTubeCommunityTabBridge.php
@@ -79,7 +79,7 @@ class YouTubeCommunityTabBridge extends BridgeAbstract
         $this->feedName ??= '';
 
         if ($this->hasPostsTab($json) === false) {
-            returnServerError('Channel does not have a posts tab');
+            throwServerException('Channel does not have a posts tab');
         }
 
         $posts = $this->getPosts($json);
@@ -156,13 +156,13 @@ class YouTubeCommunityTabBridge extends BridgeAbstract
     private function extractJson($html)
     {
         if (!preg_match($this->jsonRegex, $html, $parts)) {
-            returnServerError('Failed to extract data from page');
+            throwServerException('Failed to extract data from page');
         }
 
         $data = json_decode($parts[1]);
 
         if ($data === false) {
-            returnServerError('Failed to decode extracted data');
+            throwServerException('Failed to decode extracted data');
         }
 
         return $data;
diff --git a/bridges/YoutubeBridge.php b/bridges/YoutubeBridge.php
index 12cdaec4..0c37be0c 100644
--- a/bridges/YoutubeBridge.php
+++ b/bridges/YoutubeBridge.php
@@ -75,14 +75,14 @@ class YoutubeBridge extends BridgeAbstract
     {
         $cacheKey = 'youtube_rate_limit';
         if ($this->cache->get($cacheKey)) {
-            throw new RateLimitException();
+            throwRateLimitException();
         }
         try {
             $this->collectDataInternal();
         } catch (HttpException $e) {
             if ($e->getCode() === 429) {
                 $this->cache->set($cacheKey, true, 60 * 16);
-                throw new RateLimitException();
+                throwRateLimitException();
             }
             throw $e;
         }
@@ -142,7 +142,7 @@ class YoutubeBridge extends BridgeAbstract
                     // $jsonData = $jsonData->itemSectionRenderer->contents[0]->gridRenderer->items;
                     $this->fetchItemsFromFromJsonData($jsonData);
                 } else {
-                    returnServerError('Unable to get data from YouTube');
+                    throwServerException('Unable to get data from YouTube');
                 }
             } else {
                 // Fetch the xml feed
@@ -192,7 +192,7 @@ class YoutubeBridge extends BridgeAbstract
             $this->feeduri = $url_listing;
             $this->feedName = 'Search: ' . $search;
         } else {
-            returnClientError("You must either specify either:\n - YouTube username (?u=...)\n - Channel id (?c=...)\n - Playlist id (?p=...)\n - Search (?s=...)");
+            throwClientException("You must either specify either:\n - YouTube username (?u=...)\n - Channel id (?c=...)\n - Playlist id (?p=...)\n - Search (?s=...)");
         }
     }
 
@@ -233,7 +233,7 @@ class YoutubeBridge extends BridgeAbstract
             }
         }
         if (!$videoSecondaryInfo) {
-            returnServerError('Could not find videoSecondaryInfoRenderer. Error at: ' . $videoId);
+            throwServerException('Could not find videoSecondaryInfoRenderer. Error at: ' . $videoId);
         }
 
         $description = $videoSecondaryInfo->attributedDescription->content ?? '';
diff --git a/bridges/ZonebourseBridge.php b/bridges/ZonebourseBridge.php
index e8c91608..e351b9dd 100644
--- a/bridges/ZonebourseBridge.php
+++ b/bridges/ZonebourseBridge.php
@@ -61,7 +61,7 @@ class ZonebourseBridge extends BridgeAbstract
         $articles = $dom->find('table#newsScreener tbody tr');
 
         if (!$articles) {
-            returnServerError('Failed to retrieve news content');
+            throwServerException('Failed to retrieve news content');
         }
 
         foreach ($articles as $article) {
diff --git a/docs/06_Helper_functions/index.md b/docs/06_Helper_functions/index.md
index 2b675ca3..4004138e 100644
--- a/docs/06_Helper_functions/index.md
+++ b/docs/06_Helper_functions/index.md
@@ -87,23 +87,22 @@ $html = getSimpleHTMLDOMCached('your URI', 86400); // Duration 24h
 
 [Defined in lib/contents.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/contents.php)
 
-# returnClientError
-The `returnClientError` function aborts execution of the current bridge
-and returns the given error message with error code **400**:
+# throwClientException($message = '')
+The `throwClientException` function aborts execution of the current bridge.
 
 ```PHP
-returnClientError('Your error message')
+throwClientException('Bad user input')
 ```
 
 Use this function when the user provided invalid parameter or a required parameter is missing.
 
 [Defined in lib/utils.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/utils.php)
 
-# returnServerError
-The `returnServerError` function aborts execution of the current bridge and returns the given error message with error code **500**:
+# throwServerException($message = '')
+The `throwServerException` function aborts execution of the current bridge.
 
 ```PHP
-returnServerError('Your error message')
+throwServerException('Received empty reply from thirdparty api')
 ```
 
 Use this function when a problem occurs that has nothing to do with the parameters provided by the user.
@@ -111,6 +110,10 @@ Use this function when a problem occurs that has nothing to do with the paramete
 
 [Defined in lib/utils.php](https://github.com/RSS-Bridge/rss-bridge/blob/master/lib/utils.php)
 
+# throwRateLimitException($message = '')
+
+Throws a `RateLimitException` which produces an HTTP 429 response.
+
 # defaultLinkTo
 Automatically replaces any relative URL in a given string or DOM object
 (i.e. the one returned by [getSimpleHTMLDOM](#getsimplehtmldom)) with an absolute URL.
diff --git a/lib/utils.php b/lib/utils.php
index 1f6aa799..51e4f952 100644
--- a/lib/utils.php
+++ b/lib/utils.php
@@ -242,12 +242,33 @@ function create_random_string(int $bytes = 16): string
     return bin2hex(openssl_random_pseudo_bytes($bytes));
 }
 
-function returnClientError($message)
+function throwClientException(string $message = '')
 {
     throw new \Exception($message, 400);
 }
 
-function returnServerError($message)
+function throwServerException(string $message = '')
 {
     throw new \Exception($message, 500);
 }
+
+function throwRateLimitException(string $message = '')
+{
+    throw new RateLimitException($message);
+}
+
+/**
+ * @deprecated Use throwClientException() instead
+ */
+function returnClientError(string $message = '')
+{
+    throw new \Exception($message);
+}
+
+/**
+ * @deprecated Use throwServerException() instead
+ */
+function returnServerError(string $message = '')
+{
+    throw new \Exception($message);
+}

From 9caa043fe1b5cb0e692269a1d972e1513e3f3ab1 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 5 Aug 2025 20:55:04 +0200
Subject: [PATCH 711/716] lint: add returnClientError and returnServerError to
 forbiddenFcuntions (#4656)

---
 phpcs.xml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/phpcs.xml b/phpcs.xml
index 9e393a13..e4a1cd6e 100644
--- a/phpcs.xml
+++ b/phpcs.xml
@@ -39,6 +39,8 @@
     <properties>
       <property name="forbiddenFunctions" type="array">
         <element key="sizeof" value="count"/>
+        <element key="returnClientError" value="throwClientException"/>
+        <element key="returnServerError" value="throwServerException"/>
       </property>
     </properties>
   </rule>

From a128c05a97b98e6a243060665a1e53fa7a4b79a4 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 5 Aug 2025 21:06:40 +0200
Subject: [PATCH 712/716] docs: emphasize strict types (#4657)

---
 README.md                                     | 12 +++-
 .../01_How_to_create_a_new_bridge.md          | 55 ++++++++++---------
 2 files changed, 41 insertions(+), 26 deletions(-)

diff --git a/README.md b/README.md
index 66d9b46e..7e155db7 100644
--- a/README.md
+++ b/README.md
@@ -321,13 +321,23 @@ The sqlite files (db, wal and shm) are not writeable.
 
     rm cache/*
 
-### How to create a new bridge from scratch
+### How to create a completely new bridge
+
+New code files MUST have `declare(strict_types=1);` at the top of file:
+
+```php
+<?php
+
+declare(strict_types=1);
+```
 
 Create the new bridge in e.g. `bridges/BearBlogBridge.php`:
 
 ```php
 <?php
 
+declare(strict_types=1);
+
 class BearBlogBridge extends BridgeAbstract
 {
     const NAME = 'BearBlog (bearblog.dev)';
diff --git a/docs/05_Bridge_API/01_How_to_create_a_new_bridge.md b/docs/05_Bridge_API/01_How_to_create_a_new_bridge.md
index 02287962..e7d401dd 100644
--- a/docs/05_Bridge_API/01_How_to_create_a_new_bridge.md
+++ b/docs/05_Bridge_API/01_How_to_create_a_new_bridge.md
@@ -1,31 +1,36 @@
-Create a new file in the `bridges/` folder (see [Folder structure](../04_For_Developers/03_Folder_structure.md)).
+# How to create a completely new bridge
 
-The file name must be named according to following specification:
-* It starts with the full name of the site
-* All white-space must be removed
-* The first letter of a word is written in upper-case, unless the site name is specified otherwise (example: Freenews, not FreeNews, because the site is named 'Freenews')
-* The first character must be upper-case
-* The file name must end with 'Bridge'
-* The file type must be PHP, written in **small** letters (seriously!) ".php"
-
-**Examples:**
-
-Site | Filename
------|---------
-Wikipedia | **Wikipedia**Bridge.php
-Facebook | **Facebook**Bridge.php
-GitHub | **GitHub**Bridge.php
-Freenews | **Freenews**Bridge.php
-
-The file must start with the PHP tags and end with an empty line. The closing tag `?>` is [omitted](http://php.net/basic-syntax.instruction-separation). 
-
-**Example:**
+New code files MUST have `declare(strict_types=1);` at the top of file:
 
 ```php
 <?php
-	// PHP code here
-// This line is empty (just imagine it!)
+
+declare(strict_types=1);
 ```
 
-The next step is to extend one of the base classes.
-Refer to one of an base classes listed on the [Bridge API](../05_Bridge_API/index.md) page.
+Create the new bridge in e.g. `bridges/BearBlogBridge.php`:
+
+```php
+<?php
+
+declare(strict_types=1);
+
+class BearBlogBridge extends BridgeAbstract
+{
+    const NAME = 'BearBlog (bearblog.dev)';
+
+    public function collectData()
+    {
+        $dom = getSimpleHTMLDOM('https://herman.bearblog.dev/blog/');
+        foreach ($dom->find('.blog-posts li') as $li) {
+            $a = $li->find('a', 0);
+            $this->items[] = [
+                'title' => $a->plaintext,
+                'uri' => 'https://herman.bearblog.dev' . $a->href,
+            ];
+        }
+    }
+}
+```
+
+Learn more in [bridge api](https://rss-bridge.github.io/rss-bridge/Bridge_API/index.html).

From 81ce9c9483d101f48e3375c0553f286f509788e8 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 8 Aug 2025 01:38:12 +0200
Subject: [PATCH 713/716] fix: introduce system env var, remove debug mode
 (#4658)

* fix: introduce system env var

* docs

* docs
---
 README.md                               |  8 -----
 actions/ConnectivityAction.php          |  4 +--
 bridges/BlueskyBridge.php               | 12 ++++----
 config.default.ini.php                  | 10 ++-----
 docs/04_For_Developers/05_Debug_mode.md | 39 ++++++++++++++-----------
 docs/04_For_Developers/index.md         |  1 -
 index.php                               |  2 +-
 lib/Configuration.php                   | 22 +++++---------
 lib/Debug.php                           | 18 ------------
 lib/dependencies.php                    |  6 ++--
 lib/html.php                            | 22 ++++++--------
 lib/http.php                            |  6 ++--
 12 files changed, 55 insertions(+), 95 deletions(-)
 delete mode 100644 lib/Debug.php

diff --git a/README.md b/README.md
index 7e155db7..05042630 100644
--- a/README.md
+++ b/README.md
@@ -369,14 +369,6 @@ enabled_bridges[] = TwitchBridge
 enabled_bridges[] = GettrBridge
 ```
 
-### How to enable debug mode
-
-The 
-[debug mode](https://rss-bridge.github.io/rss-bridge/For_Developers/Debug_mode.html)
-disables the majority of caching operations.
-
-    enable_debug_mode = true
-
 ### How to switch to memcached as cache backend
 
 ```
diff --git a/actions/ConnectivityAction.php b/actions/ConnectivityAction.php
index e4e1e7c2..458a06af 100644
--- a/actions/ConnectivityAction.php
+++ b/actions/ConnectivityAction.php
@@ -22,8 +22,8 @@ class ConnectivityAction implements ActionInterface
 
     public function __invoke(Request $request): Response
     {
-        if (!Debug::isEnabled()) {
-            return new Response('This action is only available in debug mode!', 403);
+        if (Configuration::getConfig('system', 'env') !== 'dev') {
+            return new Response('This action is only available in dev environment!', 403);
         }
 
         $bridgeName = $request->get('bridge');
diff --git a/bridges/BlueskyBridge.php b/bridges/BlueskyBridge.php
index bf5053be..ada24128 100644
--- a/bridges/BlueskyBridge.php
+++ b/bridges/BlueskyBridge.php
@@ -178,10 +178,8 @@ class BlueskyBridge extends BridgeAbstract
             $postDisplayName = e($postDisplayName);
             $postUri = $item['uri'];
 
-            if (Debug::isEnabled()) {
-                $url = explode('/', $post['post']['uri']);
-                $this->logger->debug('https://bsky.app/profile/' . $url[2] . '/post/' . $url[4]);
-            }
+            $url = explode('/', $post['post']['uri']);
+            $this->logger->debug('https://bsky.app/profile/' . $url[2] . '/post/' . $url[4]);
 
             $description = '';
             $description .= '<p>';
@@ -612,9 +610,9 @@ class BlueskyBridge extends BridgeAbstract
     private function getAuthorFeed($did, $filter)
     {
         $uri = 'https://public.api.bsky.app/xrpc/app.bsky.feed.getAuthorFeed?actor=' . urlencode($did) . '&filter=' . urlencode($filter) . '&limit=30';
-        if (Debug::isEnabled()) {
-            $this->logger->debug($uri);
-        }
+
+        $this->logger->debug($uri);
+
         $response = json_decode(getContents($uri), true);
         return $response;
     }
diff --git a/config.default.ini.php b/config.default.ini.php
index ae8b23b7..39329a2a 100644
--- a/config.default.ini.php
+++ b/config.default.ini.php
@@ -6,6 +6,9 @@
 
 [system]
 
+; System environment: "dev" or "prod"
+env = "prod"
+
 ; Only these bridges are available for feed production
 ; How to enable all bridges: enabled_bridges[] = *
 ;enabled_bridges[] = CssSelectorBridge
@@ -31,13 +34,6 @@ timezone = "UTC"
 ; Display a system message to users.
 ;message = "Hello world"
 
-; Whether to enable debug mode.
-enable_debug_mode = false
-
-; Enable debug mode only for these permitted ip addresses
-; debug_mode_whitelist[] = 127.0.0.1
-; debug_mode_whitelist[] = 192.168.1.10
-
 ; Whether to enable maintenance mode. If enabled, feed requests receive 503 Service Unavailable
 enable_maintenance_mode = false
 
diff --git a/docs/04_For_Developers/05_Debug_mode.md b/docs/04_For_Developers/05_Debug_mode.md
index 7d503acd..cccf2768 100644
--- a/docs/04_For_Developers/05_Debug_mode.md
+++ b/docs/04_For_Developers/05_Debug_mode.md
@@ -1,23 +1,28 @@
-<h1 align="center">Warning!</h1>
+Debug mode has been removed.
 
-Enabling debug mode on a public server may result in malicious clients retrieving sensitive data about your server and possibly gaining access to it.
-Do not enable debug mode on a public server, unless you understand the implications of your doing!
+If you want to disable caching you can set cache type to array (in-memory cache):
 
-***
+```ini
+[cache]
 
-Debug mode enables error reporting and prevents loading data from the cache (data is still written to the cache).
-To enable debug mode, set in `config.ini.php`:
+; Cache type: file, sqlite, memcached, array, null
+type = "array"
+```
 
-    enable_debug_mode = true
+Alternatively, you can comment out the cache middleware in `lib/RssBridge.php`:
 
-Allow only explicit ip addresses:
+```diff
+diff --git a/lib/RssBridge.php b/lib/RssBridge.php
+index d16f1d89..da3df8be 100644
+--- a/lib/RssBridge.php
++++ b/lib/RssBridge.php
+@@ -24,7 +24,7 @@ final class RssBridge
 
-    debug_mode_whitelist[] = 127.0.0.1
-    debug_mode_whitelist[] = 192.168.1.10
-
-_Notice_:
-
-* An empty file enables debug mode for anyone!
-* The bridge whitelist still applies! (debug mode does **not** enable all bridges)
-
-RSS-Bridge will give you a visual feedback when debug mode is enabled.
+         $middlewares = [
+             new BasicAuthMiddleware(),
+-            new CacheMiddleware($this->container['cache']),
++            //new CacheMiddleware($this->container['cache']),
+             new ExceptionMiddleware($this->container['logger']),
+             new SecurityMiddleware(),
+             new MaintenanceMiddleware(),
+```
\ No newline at end of file
diff --git a/docs/04_For_Developers/index.md b/docs/04_For_Developers/index.md
index 97bbb854..31e513a5 100644
--- a/docs/04_For_Developers/index.md
+++ b/docs/04_For_Developers/index.md
@@ -6,7 +6,6 @@ If you are new to **RSS-Bridge** you should make yourself familiar with some gen
 
   - [Coding style policy](./01_Coding_style_policy.md)
   - [Folder structure](./03_Folder_structure.md)
-  - [Debug mode](./05_Debug_mode.md)
   - [Bridge API](../05_Bridge_API/index.md)
   - [Cache API](../07_Cache_API/index.md)
   - [Technical recommendations](../09_Technical_recommendations/index.md)
diff --git a/index.php b/index.php
index 02ea9a3d..79403e11 100644
--- a/index.php
+++ b/index.php
@@ -29,7 +29,7 @@ set_error_handler(function ($code, $message, $file, $line) use ($logger) {
         // Deprecation messages and other masked errors are typically ignored here
         return false;
     }
-    if (Debug::isEnabled()) {
+    if (Configuration::getConfig('system', 'env') === 'dev') {
         // This might be annoying, but it's for the greater good
         throw new \ErrorException($message, 0, $code, $file, $line);
     }
diff --git a/lib/Configuration.php b/lib/Configuration.php
index 37368894..d8f64d21 100644
--- a/lib/Configuration.php
+++ b/lib/Configuration.php
@@ -36,11 +36,10 @@ final class Configuration
         }
 
         if (file_exists(__DIR__ . '/../DEBUG')) {
-            // The debug mode has been moved to config. Preserve existing installs which has this DEBUG file.
-            self::setConfig('system', 'enable_debug_mode', true);
             $debug = trim(file_get_contents(__DIR__ . '/../DEBUG'));
-            if ($debug) {
-                self::setConfig('system', 'debug_mode_whitelist', explode("\n", str_replace("\r", '', $debug)));
+            if ($debug === '') {
+                self::setConfig('system', 'env', 'dev');
+                self::setConfig('cache', 'type', 'array');
             }
         }
 
@@ -82,8 +81,8 @@ final class Configuration
             }
         }
 
-        if (Debug::isEnabled()) {
-            self::setConfig('cache', 'type', 'array');
+        if (!in_array(self::getConfig('system', 'env'), ['dev', 'prod'])) {
+            self::throwConfigError('system', 'env', 'Must be dev or prod');
         }
 
         if (!is_array(self::getConfig('system', 'enabled_bridges'))) {
@@ -97,13 +96,6 @@ final class Configuration
             self::throwConfigError('system', 'timezone');
         }
 
-        if (!is_bool(self::getConfig('system', 'enable_debug_mode'))) {
-            self::throwConfigError('system', 'enable_debug_mode', 'Is not a valid Boolean');
-        }
-        if (!is_array(self::getConfig('system', 'debug_mode_whitelist') ?: [])) {
-            self::throwConfigError('system', 'debug_mode_whitelist', 'Is not a valid array');
-        }
-
         if (!is_string(self::getConfig('proxy', 'url'))) {
             self::throwConfigError('proxy', 'url', 'Is not a valid string');
         }
@@ -199,6 +191,8 @@ final class Configuration
 
     private static function throwConfigError($section, $key, $message = '')
     {
-        throw new \Exception("Config [$section] => [$key] is invalid. $message");
+        http_response_code(500);
+        print ("Config [$section] => [$key] is invalid. $message");
+        exit(1);
     }
 }
diff --git a/lib/Debug.php b/lib/Debug.php
deleted file mode 100644
index 630fd8ec..00000000
--- a/lib/Debug.php
+++ /dev/null
@@ -1,18 +0,0 @@
-<?php
-
-class Debug
-{
-    /**
-     * Convenience function for Configuration::getConfig('system', 'enable_debug_mode')
-     */
-    public static function isEnabled(): bool
-    {
-        $ip = $_SERVER['REMOTE_ADDR'] ?? 'x.y.z.1';
-        $enableDebugMode = Configuration::getConfig('system', 'enable_debug_mode');
-        $debugModeWhitelist = Configuration::getConfig('system', 'debug_mode_whitelist') ?: [];
-        if ($enableDebugMode && ($debugModeWhitelist === [] || in_array($ip, $debugModeWhitelist))) {
-            return true;
-        }
-        return false;
-    }
-}
diff --git a/lib/dependencies.php b/lib/dependencies.php
index 45ae5d61..dfaa828b 100644
--- a/lib/dependencies.php
+++ b/lib/dependencies.php
@@ -47,16 +47,16 @@ $container['cache_factory'] = function ($c) {
 
 $container['logger'] = function () {
     $logger = new SimpleLogger('rssbridge');
-    if (Debug::isEnabled()) {
+    if (Configuration::getConfig('system', 'env') === 'dev') {
         $logger->addHandler(new ErrorLogHandler(Logger::DEBUG));
     } else {
         $logger->addHandler(new ErrorLogHandler(Logger::INFO));
     }
     // Uncomment this for info logging to fs
-    // $logger->addHandler(new StreamHandler('/tmp/rss-bridge.txt', Logger::INFO));
+    // $logger->addHandler(new StreamHandler('/tmp/rss-bridge.log', Logger::INFO));
 
     // Uncomment this for debug logging to fs
-    // $logger->addHandler(new StreamHandler('/tmp/rss-bridge-debug.txt', Logger::DEBUG));
+    // $logger->addHandler(new StreamHandler('/tmp/rss-bridge-debug.log', Logger::DEBUG));
     return $logger;
 };
 
diff --git a/lib/html.php b/lib/html.php
index 71a3a29e..dd756979 100644
--- a/lib/html.php
+++ b/lib/html.php
@@ -15,19 +15,15 @@ function render(string $template, array $context = []): string
             'level' => 'info',
         ];
     }
-    if (Debug::isEnabled()) {
-        $debugModeWhitelist = Configuration::getConfig('system', 'debug_mode_whitelist') ?: [];
-        if ($debugModeWhitelist === []) {
-            $context['messages'][] = [
-                'body' => 'Warning : Debug mode is active from any location, make sure only you can access RSS-Bridge.',
-                'level' => 'error'
-            ];
-        } else {
-            $context['messages'][] = [
-                'body' => 'Warning : Debug mode is active from your IP address, your requests will bypass the cache.',
-                'level' => 'warning'
-            ];
-        }
+    if (Configuration::getConfig('system', 'env') === 'dev') {
+        $context['messages'][] = [
+            'body' => 'System environment: dev',
+            'level' => 'error'
+        ];
+        $context['messages'][] = [
+            'body' => sprintf('Cache type: %s', Configuration::getConfig('cache', 'type')),
+            'level' => 'info'
+        ];
     }
     $context['page'] = render_template($template, $context);
     return render_template('base.html.php', $context);
diff --git a/lib/http.php b/lib/http.php
index b89e3c05..8f0a1638 100644
--- a/lib/http.php
+++ b/lib/http.php
@@ -23,12 +23,10 @@ class HttpException extends \Exception
     public static function fromResponse(Response $response, string $url): HttpException
     {
         $message = sprintf(
-            '%s resulted in %s %s %s',
+            '%s resulted in %s %s',
             $url,
             $response->getCode(),
-            $response->getStatusLine(),
-            // If debug, include a part of the response body in the exception message
-            Debug::isEnabled() ? mb_substr($response->getBody(), 0, 500) : '',
+            $response->getStatusLine()
         );
         if (CloudFlareException::isCloudFlareResponse($response)) {
             return new CloudFlareException($message, $response->getCode(), $response);

From a599f4ba83b03f04a0c183c995deb24ea390e1b7 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 8 Aug 2025 02:16:43 +0200
Subject: [PATCH 714/716] fix: dont log user errors (#4660)

---
 actions/DisplayAction.php | 11 +++++------
 lib/utils.php             |  9 ++++++++-
 2 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/actions/DisplayAction.php b/actions/DisplayAction.php
index 10af8ad7..97f53caa 100644
--- a/actions/DisplayAction.php
+++ b/actions/DisplayAction.php
@@ -89,12 +89,12 @@ class DisplayAction implements ActionInterface
             $bridge->collectData();
             $items = $bridge->getItems();
         } catch (\Throwable $e) {
-            if ($e instanceof RateLimitException) {
-                // These are internally generated by bridges
-                $this->logger->info(sprintf('RateLimitException in DisplayAction(%s): %s', $bridge->getShortName(), create_sane_exception_message($e)));
+            if ($e instanceof ClientException) {
+                $this->logger->debug(sprintf('Exception in DisplayAction(%s): %s', $bridge->getShortName(), create_sane_exception_message($e)));
+            } elseif ($e instanceof RateLimitException) {
+                $this->logger->debug(sprintf('Exception in DisplayAction(%s): %s', $bridge->getShortName(), create_sane_exception_message($e)));
                 return new Response(render(__DIR__ . '/../templates/exception.html.php', ['e' => $e]), 429);
-            }
-            if ($e instanceof HttpException) {
+            } elseif ($e instanceof HttpException) {
                 if (in_array($e->getCode(), [429, 503])) {
                     // Log with debug, immediately reproduce and return
                     $this->logger->debug(sprintf('Exception in DisplayAction(%s): %s', $bridge->getShortName(), create_sane_exception_message($e)));
@@ -102,7 +102,6 @@ class DisplayAction implements ActionInterface
                 }
                 // Some other status code which we let fail normally (but don't log it)
             } else {
-                // Log error if it's not an HttpException
                 $this->logger->error(sprintf('Exception in DisplayAction(%s)', $bridge->getShortName()), ['e' => $e]);
             }
             $errorOutput = Configuration::getConfig('error', 'output');
diff --git a/lib/utils.php b/lib/utils.php
index 51e4f952..dfee437b 100644
--- a/lib/utils.php
+++ b/lib/utils.php
@@ -242,9 +242,16 @@ function create_random_string(int $bytes = 16): string
     return bin2hex(openssl_random_pseudo_bytes($bytes));
 }
 
+/**
+ * Thrown by bridges to indicate user failure. Will not be logged.
+ */
+final class ClientException extends \Exception
+{
+}
+
 function throwClientException(string $message = '')
 {
-    throw new \Exception($message, 400);
+    throw new ClientException($message, 400);
 }
 
 function throwServerException(string $message = '')

From 37174f01e543ffef84a9ab1ed71ea990cabc331a Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Fri, 8 Aug 2025 02:24:13 +0200
Subject: [PATCH 715/716] fix: throw client exception in some bridges (#4661)

---
 bridges/ImgsedBridge.php   | 2 +-
 bridges/TelegramBridge.php | 2 +-
 bridges/TwitchBridge.php   | 2 +-
 lib/TwitterClient.php      | 4 ++--
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/bridges/ImgsedBridge.php b/bridges/ImgsedBridge.php
index a9273813..ed541adb 100644
--- a/bridges/ImgsedBridge.php
+++ b/bridges/ImgsedBridge.php
@@ -59,7 +59,7 @@ class ImgsedBridge extends BridgeAbstract
                 $this->collectTaggeds();
             }
         } catch (HttpException $e) {
-            throw new \Exception(sprintf('Unable to find user `%s`', $username));
+            throwClientException(sprintf('Unable to find user `%s`', $username));
         }
     }
 
diff --git a/bridges/TelegramBridge.php b/bridges/TelegramBridge.php
index 0a3f1a74..9518e3f7 100644
--- a/bridges/TelegramBridge.php
+++ b/bridges/TelegramBridge.php
@@ -61,7 +61,7 @@ class TelegramBridge extends BridgeAbstract
 
             $messages = $dom->find('div.tgme_widget_message_wrap.js-widget_message_wrap');
             if (!$channelTitle && !$messages) {
-                throw new \Exception('Unable to find channel. The channel is non-existing or non-public.');
+                throwClientException('Unable to find channel. The channel is non-existing or non-public.');
             }
 
             foreach (array_reverse($messages) as $message) {
diff --git a/bridges/TwitchBridge.php b/bridges/TwitchBridge.php
index 6605a973..c7df4053 100644
--- a/bridges/TwitchBridge.php
+++ b/bridges/TwitchBridge.php
@@ -93,7 +93,7 @@ EOD;
         $response = $this->apiRequest($query, $variables);
         $data = $response->data;
         if ($data->user === null) {
-            throw new \Exception(sprintf('Unable to find channel `%s`', $channel));
+            throwClientException(sprintf('Unable to find channel `%s`', $channel));
         }
 
         $user = $data->user;
diff --git a/lib/TwitterClient.php b/lib/TwitterClient.php
index f71e842c..c50f8835 100644
--- a/lib/TwitterClient.php
+++ b/lib/TwitterClient.php
@@ -290,7 +290,7 @@ class TwitterClient
         $response = Json::decode(getContents($url, $this->createHttpHeaders()), false);
         if (isset($response->errors)) {
             // Grab the first error message
-            throw new \Exception(sprintf('From twitter api: "%s"', $response->errors[0]->message));
+            throwClientException(sprintf('From twitter api: "%s"', $response->errors[0]->message));
         }
         $userInfo = $response->data->user;
         $this->data[$screenName] = $userInfo;
@@ -423,7 +423,7 @@ class TwitterClient
         $response = Json::decode(getContents($url, $this->createHttpHeaders()), false);
         if (isset($response->errors)) {
             // Grab the first error message
-            throw new \Exception(sprintf('From twitter api: "%s"', $response->errors[0]->message));
+            throwClientException(sprintf('From twitter api: "%s"', $response->errors[0]->message));
         }
         $listInfo = $response->data->user_by_screen_name->list;
         $this->data[$screenName . '-' . $listSlug] = $listInfo;

From b60556ffb41dd5900675bb6ae7e6ccb0a0ed35b0 Mon Sep 17 00:00:00 2001
From: Mynacol <Mynacol@users.noreply.github.com>
Date: Tue, 12 Aug 2025 19:15:00 +0000
Subject: [PATCH 716/716] [HeiseBridge] Remove "Videos by heise" ads

This seems to be a new middle-of-content self-ad.
Seen on https://heise.de/-10519045

The code snippet in that case was:
```html
<div class="ad ad--inread">

  <div class="ad--inread-header">
    <p class="ad--inread-header__text">
      Videos by heise
    </p>

    <div class="ad--inread-header__more">
      <button class="ad--inread-header-menu-toggle" popovertarget="ad--inread-header-menu">
        mehr Videos
        <svg fill="none" height="24" viewbox="0 0 24 24" width="24" xmlns="http://www.w3.org/2000/svg">
          <path d="M8.625 12.0023C8.625 12.2094 8.45711 12.3773 8.25 12.3773C8.04289 12.3773 7.875 12.2094 7.875 12.0023C7.875 11.7952 8.04289 11.6273 8.25 11.6273C8.45711 11.6273 8.625 11.7952 8.625 12.0023ZM8.625 12.0023H8.25M12.375 12.0023C12.375 12.2094 12.2071 12.3773 12 12.3773C11.7929 12.3773 11.625 12.2094 11.625 12.0023C11.625 11.7952 11.7929 11.6273 12 11.6273C12.2071 11.6273 12.375 11.7952 12.375 12.0023ZM12.375 12.0023H12M16.125 12.0023C16.125 12.2094 15.9571 12.3773 15.75 12.3773C15.5429 12.3773 15.375 12.2094 15.375 12.0023C15.375 11.7952 15.5429 11.6273 15.75 11.6273C15.9571 11.6273 16.125 11.7952 16.125 12.0023ZM16.125 12.0023H15.75M21 12.0023C21 16.9729 16.9706 21.0023 12 21.0023C7.02944 21.0023 3 16.9729 3 12.0023C3 7.03176 7.02944 3.00232 12 3.00232C16.9706 3.00232 21 7.03176 21 12.0023Z" stroke="#777" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5"></path>
        </svg>
      </button>

      <div class="ad--inread-header-menu" id="ad--inread-header-menu" popover>
        <ul class="a-u-mb-0">
          <li>
            <a class="ad--inread-header-menu-link" href="https://www.youtube.com/@ct3003" target="_blank">
              c&#39;t 3003
            </a>
          </li>
          <li>
            <a class="ad--inread-header-menu-link" href="https://www.youtube.com/heiseonline" target="_blank">
              heise &amp; ct
            </a>
          </li>
          <li>
            <a class="ad--inread-header-menu-link" href="https://peertube.heise.de/" target="_blank">
              Peertube
            </a>
          </li>
        </ul>
      </div>
    </div>
  </div>

  <figure class="video video--fullwidth">
    <a-video entry-id="25969" height="9" instant is-target-video-playlist style="aspect-ratio: 16 / 9" type="targetvideo" width="16"></a-video>
  </figure>
</div>
```

Hence filtering anything with the class `ad` or `ad--inread` gets rid of
it.
---
 bridges/HeiseBridge.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bridges/HeiseBridge.php b/bridges/HeiseBridge.php
index b3bbf76b..35f18d57 100644
--- a/bridges/HeiseBridge.php
+++ b/bridges/HeiseBridge.php
@@ -163,7 +163,7 @@ class HeiseBridge extends FeedExpander
         // remove unwanted stuff
         foreach (
             $article->find('figure.branding, figure.a-inline-image, a-ad, div.ho-text, a-img,
-            .a-toc__list, a-collapse, .opt-in__description, .opt-in__footnote, .notice-banner__text, .notice-banner__link') as $element
+            .a-toc__list, a-collapse, .opt-in__description, .opt-in__footnote, .notice-banner__text, .notice-banner__link, .ad, .ad--inread') as $element
         ) {
             $element->remove();
         }