app/Config/Tasks.php

+<?php
+
+declare(strict_types=1);
+
+namespace Config;
+
+use CodeIgniter\Config\BaseConfig;
+use CodeIgniter\Tasks\Scheduler;
+
+class Tasks extends BaseConfig
+{
+    /**
+     * --------------------------------------------------------------------------
+     * Should performance metrics be logged
+     * --------------------------------------------------------------------------
+     *
+     * If true, will log the time it takes for each task to run.
+     * Requires the settings table to have been created previously.
+     */
+    public bool $logPerformance = false;
+
+    /**
+     * --------------------------------------------------------------------------
+     * Maximum performance logs
+     * --------------------------------------------------------------------------
+     *
+     * The maximum number of logs that should be saved per Task.
+     * Lower numbers reduced the amount of database required to
+     * store the logs.
+     */
+    public int $maxLogsPerTask = 10;
+
+    /**
+     * Register any tasks within this method for the application.
+     * Called by the TaskRunner.
+     */
+    public function init(Scheduler $schedule): void
+    {
+        $schedule->command('fediverse:broadcast')
+            ->everyMinute()
+            ->named('fediverse-broadcast');
+
+        $schedule->command('websub:publish')
+            ->everyMinute()
+            ->named('websub-publish');
+
+        $schedule->command('video-clips:generate')
+            ->everyMinute()
+            ->named('video-clips-generate');
+
+        $schedule->command('podcast:import')
+            ->everyMinute()
+            ->named('podcast-import');
+
+        $schedule->command('episodes:compute-downloads')
+            ->everyHour()
+            ->named('episodes:compute-downloads');
+    }
+}

app/Config/Toolbar.php

@@ -33,7 +33,7 @@ class Toolbar extends BaseConfig
      * List of toolbar collectors that will be called when Debug Toolbar
      * fires up and collects data from.
      *
-     * @var string[]
+     * @var list<class-string>
      */
     public array $collectors = [
         Timers::class,
@@ -46,6 +46,16 @@ class Toolbar extends BaseConfig
         Events::class,
     ];
 
+    /**
+     * --------------------------------------------------------------------------
+     * Collect Var Data
+     * --------------------------------------------------------------------------
+     *
+     * If set to false var data from the views will not be collected. Useful to
+     * avoid high memory usage when there are lots of data passed to the view.
+     */
+    public bool $collectVarData = true;
+
     /**
      * --------------------------------------------------------------------------
      * Max History
@@ -80,4 +90,31 @@ class Toolbar extends BaseConfig
      * `$maxQueries` defines the maximum amount of queries that will be stored.
      */
     public int $maxQueries = 100;
+
+    /**
+     * --------------------------------------------------------------------------
+     * Watched Directories
+     * --------------------------------------------------------------------------
+     *
+     * Contains an array of directories that will be watched for changes and
+     * used to determine if the hot-reload feature should reload the page or not.
+     * We restrict the values to keep performance as high as possible.
+     *
+     * NOTE: The ROOTPATH will be prepended to all values.
+     *
+     * @var list<string>
+     */
+    public array $watchedDirectories = ['app', 'modules', 'themes'];
+
+    /**
+     * --------------------------------------------------------------------------
+     * Watched File Extensions
+     * --------------------------------------------------------------------------
+     *
+     * Contains an array of file extensions that will be watched for changes and
+     * used to determine if the hot-reload feature should reload the page or not.
+     *
+     * @var list<string>
+     */
+    public array $watchedExtensions = ['php', 'css', 'js', 'html', 'svg', 'json', 'env'];
 }

app/Config/UserAgents.php

@@ -27,47 +27,47 @@ class UserAgents extends BaseConfig
      */
     public array $platforms = [
         'windows nt 10.0' => 'Windows 10',
-        'windows nt 6.3' => 'Windows 8.1',
-        'windows nt 6.2' => 'Windows 8',
-        'windows nt 6.1' => 'Windows 7',
-        'windows nt 6.0' => 'Windows Vista',
-        'windows nt 5.2' => 'Windows 2003',
-        'windows nt 5.1' => 'Windows XP',
-        'windows nt 5.0' => 'Windows 2000',
-        'windows nt 4.0' => 'Windows NT 4.0',
-        'winnt4.0' => 'Windows NT 4.0',
-        'winnt 4.0' => 'Windows NT',
-        'winnt' => 'Windows NT',
-        'windows 98' => 'Windows 98',
-        'win98' => 'Windows 98',
-        'windows 95' => 'Windows 95',
-        'win95' => 'Windows 95',
-        'windows phone' => 'Windows Phone',
-        'windows' => 'Unknown Windows OS',
-        'android' => 'Android',
-        'blackberry' => 'BlackBerry',
-        'iphone' => 'iOS',
-        'ipad' => 'iOS',
-        'ipod' => 'iOS',
-        'os x' => 'Mac OS X',
-        'ppc mac' => 'Power PC Mac',
-        'freebsd' => 'FreeBSD',
-        'ppc' => 'Macintosh',
-        'linux' => 'Linux',
-        'debian' => 'Debian',
-        'sunos' => 'Sun Solaris',
-        'beos' => 'BeOS',
-        'apachebench' => 'ApacheBench',
-        'aix' => 'AIX',
-        'irix' => 'Irix',
-        'osf' => 'DEC OSF',
-        'hp-ux' => 'HP-UX',
-        'netbsd' => 'NetBSD',
-        'bsdi' => 'BSDi',
-        'openbsd' => 'OpenBSD',
-        'gnu' => 'GNU/Linux',
-        'unix' => 'Unknown Unix OS',
-        'symbian' => 'Symbian OS',
+        'windows nt 6.3'  => 'Windows 8.1',
+        'windows nt 6.2'  => 'Windows 8',
+        'windows nt 6.1'  => 'Windows 7',
+        'windows nt 6.0'  => 'Windows Vista',
+        'windows nt 5.2'  => 'Windows 2003',
+        'windows nt 5.1'  => 'Windows XP',
+        'windows nt 5.0'  => 'Windows 2000',
+        'windows nt 4.0'  => 'Windows NT 4.0',
+        'winnt4.0'        => 'Windows NT 4.0',
+        'winnt 4.0'       => 'Windows NT',
+        'winnt'           => 'Windows NT',
+        'windows 98'      => 'Windows 98',
+        'win98'           => 'Windows 98',
+        'windows 95'      => 'Windows 95',
+        'win95'           => 'Windows 95',
+        'windows phone'   => 'Windows Phone',
+        'windows'         => 'Unknown Windows OS',
+        'android'         => 'Android',
+        'blackberry'      => 'BlackBerry',
+        'iphone'          => 'iOS',
+        'ipad'            => 'iOS',
+        'ipod'            => 'iOS',
+        'os x'            => 'Mac OS X',
+        'ppc mac'         => 'Power PC Mac',
+        'freebsd'         => 'FreeBSD',
+        'ppc'             => 'Macintosh',
+        'linux'           => 'Linux',
+        'debian'          => 'Debian',
+        'sunos'           => 'Sun Solaris',
+        'beos'            => 'BeOS',
+        'apachebench'     => 'ApacheBench',
+        'aix'             => 'AIX',
+        'irix'            => 'Irix',
+        'osf'             => 'DEC OSF',
+        'hp-ux'           => 'HP-UX',
+        'netbsd'          => 'NetBSD',
+        'bsdi'            => 'BSDi',
+        'openbsd'         => 'OpenBSD',
+        'gnu'             => 'GNU/Linux',
+        'unix'            => 'Unknown Unix OS',
+        'symbian'         => 'Symbian OS',
     ];
 
     /**
@@ -81,37 +81,37 @@ class UserAgents extends BaseConfig
      * @var array<string, string>
      */
     public array $browsers = [
-        'OPR' => 'Opera',
-        'Flock' => 'Flock',
-        'Edge' => 'Spartan',
-        'Edg' => 'Edge',
+        'OPR'    => 'Opera',
+        'Flock'  => 'Flock',
+        'Edge'   => 'Spartan',
+        'Edg'    => 'Edge',
         'Chrome' => 'Chrome',
         // Opera 10+ always reports Opera/9.80 and appends Version/<real version> to the user agent string
-        'Opera.*?Version' => 'Opera',
-        'Opera' => 'Opera',
-        'MSIE' => 'Internet Explorer',
+        'Opera.*?Version'   => 'Opera',
+        'Opera'             => 'Opera',
+        'MSIE'              => 'Internet Explorer',
         'Internet Explorer' => 'Internet Explorer',
-        'Trident.* rv' => 'Internet Explorer',
-        'Shiira' => 'Shiira',
-        'Firefox' => 'Firefox',
-        'Chimera' => 'Chimera',
-        'Phoenix' => 'Phoenix',
-        'Firebird' => 'Firebird',
-        'Camino' => 'Camino',
-        'Netscape' => 'Netscape',
-        'OmniWeb' => 'OmniWeb',
-        'Safari' => 'Safari',
-        'Mozilla' => 'Mozilla',
-        'Konqueror' => 'Konqueror',
-        'icab' => 'iCab',
-        'Lynx' => 'Lynx',
-        'Links' => 'Links',
-        'hotjava' => 'HotJava',
-        'amaya' => 'Amaya',
-        'IBrowse' => 'IBrowse',
-        'Maxthon' => 'Maxthon',
-        'Ubuntu' => 'Ubuntu Web Browser',
-        'Vivaldi' => 'Vivaldi',
+        'Trident.* rv'      => 'Internet Explorer',
+        'Shiira'            => 'Shiira',
+        'Firefox'           => 'Firefox',
+        'Chimera'           => 'Chimera',
+        'Phoenix'           => 'Phoenix',
+        'Firebird'          => 'Firebird',
+        'Camino'            => 'Camino',
+        'Netscape'          => 'Netscape',
+        'OmniWeb'           => 'OmniWeb',
+        'Safari'            => 'Safari',
+        'Mozilla'           => 'Mozilla',
+        'Konqueror'         => 'Konqueror',
+        'icab'              => 'iCab',
+        'Lynx'              => 'Lynx',
+        'Links'             => 'Links',
+        'hotjava'           => 'HotJava',
+        'amaya'             => 'Amaya',
+        'IBrowse'           => 'IBrowse',
+        'Maxthon'           => 'Maxthon',
+        'Ubuntu'            => 'Ubuntu Web Browser',
+        'Vivaldi'           => 'Vivaldi',
     ];
 
     /**
@@ -139,86 +139,86 @@ class UserAgents extends BaseConfig
         // 'motorola'             => 'Motorola'
 
         // Phones and Manufacturers
-        'motorola' => 'Motorola',
-        'nokia' => 'Nokia',
-        'palm' => 'Palm',
-        'iphone' => 'Apple iPhone',
-        'ipad' => 'iPad',
-        'ipod' => 'Apple iPod Touch',
-        'sony' => 'Sony Ericsson',
-        'ericsson' => 'Sony Ericsson',
-        'blackberry' => 'BlackBerry',
-        'cocoon' => 'O2 Cocoon',
-        'blazer' => 'Treo',
-        'lg' => 'LG',
-        'amoi' => 'Amoi',
-        'xda' => 'XDA',
-        'mda' => 'MDA',
-        'vario' => 'Vario',
-        'htc' => 'HTC',
-        'samsung' => 'Samsung',
-        'sharp' => 'Sharp',
-        'sie-' => 'Siemens',
-        'alcatel' => 'Alcatel',
-        'benq' => 'BenQ',
-        'ipaq' => 'HP iPaq',
-        'mot-' => 'Motorola',
+        'motorola'             => 'Motorola',
+        'nokia'                => 'Nokia',
+        'palm'                 => 'Palm',
+        'iphone'               => 'Apple iPhone',
+        'ipad'                 => 'iPad',
+        'ipod'                 => 'Apple iPod Touch',
+        'sony'                 => 'Sony Ericsson',
+        'ericsson'             => 'Sony Ericsson',
+        'blackberry'           => 'BlackBerry',
+        'cocoon'               => 'O2 Cocoon',
+        'blazer'               => 'Treo',
+        'lg'                   => 'LG',
+        'amoi'                 => 'Amoi',
+        'xda'                  => 'XDA',
+        'mda'                  => 'MDA',
+        'vario'                => 'Vario',
+        'htc'                  => 'HTC',
+        'samsung'              => 'Samsung',
+        'sharp'                => 'Sharp',
+        'sie-'                 => 'Siemens',
+        'alcatel'              => 'Alcatel',
+        'benq'                 => 'BenQ',
+        'ipaq'                 => 'HP iPaq',
+        'mot-'                 => 'Motorola',
         'playstation portable' => 'PlayStation Portable',
-        'playstation 3' => 'PlayStation 3',
-        'playstation vita' => 'PlayStation Vita',
-        'hiptop' => 'Danger Hiptop',
-        'nec-' => 'NEC',
-        'panasonic' => 'Panasonic',
-        'philips' => 'Philips',
-        'sagem' => 'Sagem',
-        'sanyo' => 'Sanyo',
-        'spv' => 'SPV',
-        'zte' => 'ZTE',
-        'sendo' => 'Sendo',
-        'nintendo dsi' => 'Nintendo DSi',
-        'nintendo ds' => 'Nintendo DS',
-        'nintendo 3ds' => 'Nintendo 3DS',
-        'wii' => 'Nintendo Wii',
-        'open web' => 'Open Web',
-        'openweb' => 'OpenWeb',
+        'playstation 3'        => 'PlayStation 3',
+        'playstation vita'     => 'PlayStation Vita',
+        'hiptop'               => 'Danger Hiptop',
+        'nec-'                 => 'NEC',
+        'panasonic'            => 'Panasonic',
+        'philips'              => 'Philips',
+        'sagem'                => 'Sagem',
+        'sanyo'                => 'Sanyo',
+        'spv'                  => 'SPV',
+        'zte'                  => 'ZTE',
+        'sendo'                => 'Sendo',
+        'nintendo dsi'         => 'Nintendo DSi',
+        'nintendo ds'          => 'Nintendo DS',
+        'nintendo 3ds'         => 'Nintendo 3DS',
+        'wii'                  => 'Nintendo Wii',
+        'open web'             => 'Open Web',
+        'openweb'              => 'OpenWeb',
 
         // Operating Systems
-        'android' => 'Android',
-        'symbian' => 'Symbian',
-        'SymbianOS' => 'SymbianOS',
-        'elaine' => 'Palm',
-        'series60' => 'Symbian S60',
+        'android'    => 'Android',
+        'symbian'    => 'Symbian',
+        'SymbianOS'  => 'SymbianOS',
+        'elaine'     => 'Palm',
+        'series60'   => 'Symbian S60',
         'windows ce' => 'Windows CE',
 
         // Browsers
-        'obigo' => 'Obigo',
-        'netfront' => 'Netfront Browser',
-        'openwave' => 'Openwave Browser',
+        'obigo'         => 'Obigo',
+        'netfront'      => 'Netfront Browser',
+        'openwave'      => 'Openwave Browser',
         'mobilexplorer' => 'Mobile Explorer',
-        'operamini' => 'Opera Mini',
-        'opera mini' => 'Opera Mini',
-        'opera mobi' => 'Opera Mobile',
-        'fennec' => 'Firefox Mobile',
+        'operamini'     => 'Opera Mini',
+        'opera mini'    => 'Opera Mini',
+        'opera mobi'    => 'Opera Mobile',
+        'fennec'        => 'Firefox Mobile',
 
         // Other
         'digital paths' => 'Digital Paths',
-        'avantgo' => 'AvantGo',
-        'xiino' => 'Xiino',
-        'novarra' => 'Novarra Transcoder',
-        'vodafone' => 'Vodafone',
-        'docomo' => 'NTT DoCoMo',
-        'o2' => 'O2',
+        'avantgo'       => 'AvantGo',
+        'xiino'         => 'Xiino',
+        'novarra'       => 'Novarra Transcoder',
+        'vodafone'      => 'Vodafone',
+        'docomo'        => 'NTT DoCoMo',
+        'o2'            => 'O2',
 
         // Fallback
-        'mobile' => 'Generic Mobile',
-        'wireless' => 'Generic Mobile',
-        'j2me' => 'Generic Mobile',
-        'midp' => 'Generic Mobile',
-        'cldc' => 'Generic Mobile',
-        'up.link' => 'Generic Mobile',
+        'mobile'     => 'Generic Mobile',
+        'wireless'   => 'Generic Mobile',
+        'j2me'       => 'Generic Mobile',
+        'midp'       => 'Generic Mobile',
+        'cldc'       => 'Generic Mobile',
+        'up.link'    => 'Generic Mobile',
         'up.browser' => 'Generic Mobile',
         'smartphone' => 'Generic Mobile',
-        'cellphone' => 'Generic Mobile',
+        'cellphone'  => 'Generic Mobile',
     ];
 
     /**
@@ -231,24 +231,24 @@ class UserAgents extends BaseConfig
      * @var array<string, string>
      */
     public array $robots = [
-        'googlebot' => 'Googlebot',
-        'msnbot' => 'MSNBot',
-        'baiduspider' => 'Baiduspider',
-        'bingbot' => 'Bing',
-        'slurp' => 'Inktomi Slurp',
-        'yahoo' => 'Yahoo',
-        'ask jeeves' => 'Ask Jeeves',
-        'fastcrawler' => 'FastCrawler',
-        'infoseek' => 'InfoSeek Robot 1.0',
-        'lycos' => 'Lycos',
-        'yandex' => 'YandexBot',
+        'googlebot'            => 'Googlebot',
+        'msnbot'               => 'MSNBot',
+        'baiduspider'          => 'Baiduspider',
+        'bingbot'              => 'Bing',
+        'slurp'                => 'Inktomi Slurp',
+        'yahoo'                => 'Yahoo',
+        'ask jeeves'           => 'Ask Jeeves',
+        'fastcrawler'          => 'FastCrawler',
+        'infoseek'             => 'InfoSeek Robot 1.0',
+        'lycos'                => 'Lycos',
+        'yandex'               => 'YandexBot',
         'mediapartners-google' => 'MediaPartners Google',
-        'CRAZYWEBCRAWLER' => 'Crazy Webcrawler',
-        'adsbot-google' => 'AdsBot Google',
-        'feedfetcher-google' => 'Feedfetcher Google',
-        'curious george' => 'Curious George',
-        'ia_archiver' => 'Alexa Crawler',
-        'MJ12bot' => 'Majestic-12',
-        'Uptimebot' => 'Uptimebot',
+        'CRAZYWEBCRAWLER'      => 'Crazy Webcrawler',
+        'adsbot-google'        => 'AdsBot Google',
+        'feedfetcher-google'   => 'Feedfetcher Google',
+        'curious george'       => 'Curious George',
+        'ia_archiver'          => 'Alexa Crawler',
+        'MJ12bot'              => 'Majestic-12',
+        'Uptimebot'            => 'Uptimebot',
     ];
 }

app/Config/Validation.php

@@ -5,28 +5,27 @@ declare(strict_types=1);
 namespace Config;
 
 use App\Validation\FileRules as AppFileRules;
-use App\Validation\Rules as AppRules;
-use CodeIgniter\Validation\CreditCardRules;
-use CodeIgniter\Validation\FileRules;
-use CodeIgniter\Validation\FormatRules;
-use CodeIgniter\Validation\Rules;
-use Myth\Auth\Authentication\Passwords\ValidationRules as PasswordRules;
+use App\Validation\OtherRules;
+use CodeIgniter\Config\BaseConfig;
+use CodeIgniter\Validation\StrictRules\CreditCardRules;
+use CodeIgniter\Validation\StrictRules\FileRules;
+use CodeIgniter\Validation\StrictRules\FormatRules;
+use CodeIgniter\Validation\StrictRules\Rules;
 
-class Validation
+class Validation extends BaseConfig
 {
     /**
      * Stores the classes that contain the rules that are available.
      *
-     * @var string[]
+     * @var list<string>
      */
     public array $ruleSets = [
         Rules::class,
         FormatRules::class,
         FileRules::class,
         CreditCardRules::class,
-        AppRules::class,
         AppFileRules::class,
-        PasswordRules::class,
+        OtherRules::class,
     ];
 
     /**
@@ -35,7 +34,7 @@ class Validation
      * @var array<string, string>
      */
     public array $templates = [
-        'list' => 'CodeIgniter\Validation\Views\list',
+        'list'   => 'CodeIgniter\Validation\Views\list',
         'single' => 'CodeIgniter\Validation\Views\single',
     ];
 }

app/Config/View.php

@@ -5,7 +5,13 @@ declare(strict_types=1);
 namespace Config;
 
 use CodeIgniter\Config\View as BaseView;
+use CodeIgniter\View\ViewDecoratorInterface;
+use ViewComponents\Decorator;
 
+/**
+ * @phpstan-type parser_callable (callable(mixed): mixed)
+ * @phpstan-type parser_callable_string (callable(mixed): mixed)&string
+ */
 class View extends BaseView
 {
     /**
@@ -25,7 +31,8 @@ class View extends BaseView
      *
      * Examples: { title|esc(js) } { created_on|date(Y-m-d)|esc(attr) }
      *
-     * @var string[]
+     * @var         array<string, string>
+     * @phpstan-var array<string, parser_callable_string>
      */
     public $filters = [];
 
@@ -33,7 +40,18 @@ class View extends BaseView
      * Parser Plugins provide a way to extend the functionality provided by the core Parser by creating aliases that
      * will be replaced with any callable. Can be single or tag pair.
      *
-     * @var string[]
+     * @var         array<string, callable|list<string>|string>
+     * @phpstan-var array<string, list<parser_callable_string>|parser_callable_string|parser_callable>
      */
     public $plugins = [];
+
+    /**
+     * View Decorators are class methods that will be run in sequence to have a chance to alter the generated output
+     * just prior to caching the results.
+     *
+     * All classes must implement CodeIgniter\View\ViewDecoratorInterface
+     *
+     * @var list<class-string<ViewDecoratorInterface>>
+     */
+    public array $decorators = [Decorator::class];
 }

app/Config/ViewComponents.php

+<?php
+
+declare(strict_types=1);
+
+namespace Config;
+
+use ViewComponents\Config\ViewComponents as ViewComponentsConfig;
+
+class ViewComponents extends ViewComponentsConfig
+{
+    /**
+     * @var string[]
+     */
+    public array $lookupPaths = [
+        ROOTPATH . 'themes/cp_app/',
+        ROOTPATH . 'themes/cp_admin/',
+        ROOTPATH . 'themes/cp_auth/',
+        ROOTPATH . 'themes/cp_install/',
+    ];
+}

app/Config/Vite.php

+<?php
+
+// app/Config/Vite.php
+
+declare(strict_types=1);
+
+namespace Config;
+
+use CodeIgniterVite\Config\Vite as ViteConfig;
+
+class Vite extends ViteConfig
+{
+    public function __construct()
+    {
+        parent::__construct();
+
+        $adminGateway = config('Admin')
+            ->gateway;
+        $installGateway = config('Install')
+            ->gateway;
+
+        $this->routesAssets = [
+            [
+                'routes'  => ['*'],
+                'exclude' => [$adminGateway . '*', $installGateway . '*'],
+                'assets'  => ['styles/site.css', 'js/app.ts', 'js/podcast.ts', 'js/audio-player.ts'],
+            ],
+            [
+                'routes' => ['/map'],
+                'assets' => ['js/map.ts'],
+            ],
+            [
+                'routes' => ['/' . $adminGateway . '*'],
+                'assets' => ['styles/admin.css', 'js/admin.ts', 'js/admin-audio-player.ts'],
+            ],
+            [
+                'routes' => [$installGateway . '*'],
+                'assets' => ['styles/install.css'],
+            ],
+        ];
+    }
+}

app/Controllers/Admin/HomeController.php → app/Controllers/ActivityPubController.php

@@ -3,20 +3,15 @@
 declare(strict_types=1);
 
 /**
- * @copyright  2020 Podlibre
+ * @copyright  2021 Ad Aures
  * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
  * @link       https://castopod.org/
  */
 
-namespace App\Controllers\Admin;
+namespace App\Controllers;
 
-use CodeIgniter\HTTP\RedirectResponse;
+use Modules\Fediverse\Controllers\ActivityPubController as FediverseActivityPubController;
 
-class HomeController extends BaseController
+class ActivityPubController extends FediverseActivityPubController
 {
-    public function index(): RedirectResponse
-    {
-        session()->keepFlashdata('message');
-        return redirect()->route('podcast-list');
-    }
 }

app/Controllers/ActorController.php

@@ -3,46 +3,37 @@
 declare(strict_types=1);
 
 /**
- * @copyright  2020 Podlibre
+ * @copyright  2020 Ad Aures
  * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
  * @link       https://castopod.org/
  */
 
 namespace App\Controllers;
 
-use ActivityPub\Controllers\ActorController as ActivityPubActorController;
-use Analytics\AnalyticsTrait;
+use Modules\Analytics\AnalyticsTrait;
+use Modules\Fediverse\Controllers\ActorController as FediverseActorController;
 
-class ActorController extends ActivityPubActorController
+class ActorController extends FediverseActorController
 {
     use AnalyticsTrait;
 
     /**
-     * @var string[]
+     * @var list<string>
      */
-    protected $helpers = ['auth', 'svg', 'components', 'misc'];
+    protected $helpers = ['svg', 'components', 'misc', 'seo'];
 
-    public function follow(): string
+    public function followView(): string
     {
-        // Prevent analytics hit when authenticated
-        if (! can_user_interact()) {
-            // @phpstan-ignore-next-line
-            $this->registerPodcastWebpageHit($this->actor->podcast->id);
-        }
-
-        $cacheName = "page_podcast-{$this->actor->username}_follow";
-        if (! ($cachedView = cache($cacheName))) {
-            helper(['form', 'components', 'svg']);
-            $data = [
-                'actor' => $this->actor,
-            ];
-
-            return view('podcast/follow', $data, [
-                'cache' => DECADE,
-                'cache_name' => $cacheName,
-            ]);
-        }
-
-        return $cachedView;
+        // @phpstan-ignore-next-line
+        $this->registerPodcastWebpageHit($this->actor->podcast->id);
+
+        helper(['form', 'components', 'svg']);
+        // @phpstan-ignore-next-line
+        set_follow_metatags($this->actor);
+        $data = [
+            'actor' => $this->actor,
+        ];
+
+        return view('podcast/follow', $data);
     }
 }

app/Controllers/Admin/EpisodeController.php

-<?php
-
-declare(strict_types=1);
-
-/**
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-namespace App\Controllers\Admin;
-
-use App\Entities\Episode;
-use App\Entities\Image;
-use App\Entities\Location;
-use App\Entities\Note;
-use App\Entities\Podcast;
-use App\Models\EpisodeModel;
-use App\Models\NoteModel;
-use App\Models\PodcastModel;
-use App\Models\SoundbiteModel;
-use CodeIgniter\Exceptions\PageNotFoundException;
-use CodeIgniter\HTTP\RedirectResponse;
-use CodeIgniter\I18n\Time;
-use Config\Database;
-
-class EpisodeController extends BaseController
-{
-    protected Podcast $podcast;
-
-    protected Episode $episode;
-
-    public function _remap(string $method, string ...$params): mixed
-    {
-        if (
-            ($podcast = (new PodcastModel())->getPodcastById((int) $params[0])) === null
-        ) {
-            throw PageNotFoundException::forPageNotFound();
-        }
-
-        $this->podcast = $podcast;
-
-        if (count($params) > 1) {
-            if (
-                ! ($this->episode = (new EpisodeModel())
-                    ->where([
-                        'id' => $params[1],
-                        'podcast_id' => $params[0],
-                    ])
-                    ->first())
-            ) {
-                throw PageNotFoundException::forPageNotFound();
-            }
-
-            unset($params[1]);
-            unset($params[0]);
-        }
-
-        return $this->{$method}(...$params);
-    }
-
-    public function list(): string
-    {
-        $episodes = (new EpisodeModel())
-            ->where('podcast_id', $this->podcast->id)
-            ->orderBy('created_at', 'desc');
-
-        $data = [
-            'podcast' => $this->podcast,
-            'episodes' => $episodes->paginate(10),
-            'pager' => $episodes->pager,
-        ];
-
-        replace_breadcrumb_params([
-            0 => $this->podcast->title,
-        ]);
-        return view('admin/episode/list', $data);
-    }
-
-    public function view(): string
-    {
-        $data = [
-            'podcast' => $this->podcast,
-            'episode' => $this->episode,
-        ];
-
-        replace_breadcrumb_params([
-            0 => $this->podcast->title,
-            1 => $this->episode->title,
-        ]);
-        return view('admin/episode/view', $data);
-    }
-
-    public function create(): string
-    {
-        helper(['form']);
-
-        $data = [
-            'podcast' => $this->podcast,
-        ];
-
-        replace_breadcrumb_params([
-            0 => $this->podcast->title,
-        ]);
-        return view('admin/episode/create', $data);
-    }
-
-    public function attemptCreate(): RedirectResponse
-    {
-        $rules = [
-            'audio_file' => 'uploaded[audio_file]|ext_in[audio_file,mp3,m4a]',
-            'image' =>
-                'is_image[image]|ext_in[image,jpg,png]|min_dims[image,1400,1400]|is_image_squared[image]',
-            'transcript_file' =>
-                'ext_in[transcript,txt,html,srt,json]|permit_empty',
-            'chapters_file' => 'ext_in[chapters,json]|permit_empty',
-        ];
-
-        if (! $this->validate($rules)) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $this->validator->getErrors());
-        }
-
-        $image = null;
-        $imageFile = $this->request->getFile('image');
-        if ($imageFile !== null && $imageFile->isValid()) {
-            $image = new Image($imageFile);
-        }
-
-        $newEpisode = new Episode([
-            'podcast_id' => $this->podcast->id,
-            'title' => $this->request->getPost('title'),
-            'slug' => $this->request->getPost('slug'),
-            'guid' => '',
-            'audio_file' => $this->request->getFile('audio_file'),
-            'description_markdown' => $this->request->getPost('description'),
-            'image' => $image,
-            'location' => new Location($this->request->getPost('location_name')),
-            'transcript' => $this->request->getFile('transcript'),
-            'chapters' => $this->request->getFile('chapters'),
-            'parental_advisory' =>
-                $this->request->getPost('parental_advisory') !== 'undefined'
-                    ? $this->request->getPost('parental_advisory')
-                    : null,
-            'number' => $this->request->getPost('episode_number')
-                ? $this->request->getPost('episode_number')
-                : null,
-            'season_number' => $this->request->getPost('season_number')
-                ? $this->request->getPost('season_number')
-                : null,
-            'type' => $this->request->getPost('type'),
-            'is_blocked' => $this->request->getPost('block') === 'yes',
-            'custom_rss_string' => $this->request->getPost('custom_rss'),
-            'created_by' => user_id(),
-            'updated_by' => user_id(),
-            'published_at' => null,
-        ]);
-
-        $transcriptChoice = $this->request->getPost('transcript-choice');
-        if (
-            $transcriptChoice === 'upload-file' &&
-            ($transcriptFile = $this->request->getFile('transcript_file'))
-        ) {
-            $newEpisode->transcript_file = $transcriptFile;
-        } elseif ($transcriptChoice === 'remote-url') {
-            $newEpisode->transcript_file_remote_url = $this->request->getPost('transcript_file_remote_url');
-        }
-
-        $chaptersChoice = $this->request->getPost('chapters-choice');
-        if (
-            $chaptersChoice === 'upload-file' &&
-            ($chaptersFile = $this->request->getFile('chapters_file'))
-        ) {
-            $newEpisode->chapters_file = $chaptersFile;
-        } elseif ($chaptersChoice === 'remote-url') {
-            $newEpisode->chapters_file_remote_url = $this->request->getPost('chapters_file_remote_url');
-        }
-
-        $episodeModel = new EpisodeModel();
-
-        if (! ($newEpisodeId = $episodeModel->insert($newEpisode, true))) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $episodeModel->errors());
-        }
-
-        // update podcast's episode_description_footer_markdown if changed
-        $podcastModel = new PodcastModel();
-
-        if ($this->podcast->hasChanged('episode_description_footer_markdown')) {
-            $this->podcast->episode_description_footer_markdown = $this->request->getPost('description_footer');
-
-            if (! $podcastModel->update($this->podcast->id, $this->podcast)) {
-                return redirect()
-                    ->back()
-                    ->withInput()
-                    ->with('errors', $podcastModel->errors());
-            }
-        }
-
-        return redirect()->route('episode-view', [$this->podcast->id, $newEpisodeId]);
-    }
-
-    public function edit(): string
-    {
-        helper(['form']);
-
-        $data = [
-            'podcast' => $this->podcast,
-            'episode' => $this->episode,
-        ];
-
-        replace_breadcrumb_params([
-            0 => $this->podcast->title,
-            1 => $this->episode->title,
-        ]);
-        return view('admin/episode/edit', $data);
-    }
-
-    public function attemptEdit(): RedirectResponse
-    {
-        $rules = [
-            'audio_file' =>
-                'uploaded[audio_file]|ext_in[audio_file,mp3,m4a]|permit_empty',
-            'image' =>
-                'is_image[image]|ext_in[image,jpg,png]|min_dims[image,1400,1400]|is_image_squared[image]',
-            'transcript_file' =>
-                'ext_in[transcript_file,txt,html,srt,json]|permit_empty',
-            'chapters_file' => 'ext_in[chapters_file,json]|permit_empty',
-        ];
-
-        if (! $this->validate($rules)) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $this->validator->getErrors());
-        }
-
-        $this->episode->title = $this->request->getPost('title');
-        $this->episode->slug = $this->request->getPost('slug');
-        $this->episode->description_markdown = $this->request->getPost('description');
-        $this->episode->location = new Location($this->request->getPost('location_name'));
-        $this->episode->parental_advisory =
-            $this->request->getPost('parental_advisory') !== 'undefined'
-                ? $this->request->getPost('parental_advisory')
-                : null;
-        $this->episode->number = $this->request->getPost('episode_number')
-            ? $this->request->getPost('episode_number')
-            : null;
-        $this->episode->season_number = $this->request->getPost('season_number')
-            ? $this->request->getPost('season_number')
-            : null;
-        $this->episode->type = $this->request->getPost('type');
-        $this->episode->is_blocked = $this->request->getPost('block') === 'yes';
-        $this->episode->custom_rss_string = $this->request->getPost('custom_rss');
-
-        $this->episode->updated_by = (int) user_id();
-
-        $audioFile = $this->request->getFile('audio_file');
-        if ($audioFile !== null && $audioFile->isValid()) {
-            $this->episode->audio_file = $audioFile;
-        }
-
-        $imageFile = $this->request->getFile('image');
-        if ($imageFile !== null && $imageFile->isValid()) {
-            $this->episode->image = new Image($imageFile);
-        }
-
-        $transcriptChoice = $this->request->getPost('transcript-choice');
-        if ($transcriptChoice === 'upload-file') {
-            $transcriptFile = $this->request->getFile('transcript_file');
-            if ($transcriptFile !== null && $transcriptFile->isValid()) {
-                $this->episode->transcript_file = $transcriptFile;
-                $this->episode->transcript_file_remote_url = null;
-            }
-        } elseif ($transcriptChoice === 'remote-url') {
-            if (
-                ($transcriptFileRemoteUrl = $this->request->getPost('transcript_file_remote_url')) &&
-                (($transcriptFile = $this->episode->transcript_file) &&
-                    $transcriptFile !== null)
-            ) {
-                unlink((string) $transcriptFile);
-                $this->episode->transcript_file_path = null;
-            }
-            $this->episode->transcript_file_remote_url = $transcriptFileRemoteUrl;
-        }
-
-        $chaptersChoice = $this->request->getPost('chapters-choice');
-        if ($chaptersChoice === 'upload-file') {
-            $chaptersFile = $this->request->getFile('chapters_file');
-            if ($chaptersFile !== null && $chaptersFile->isValid()) {
-                $this->episode->chapters_file = $chaptersFile;
-                $this->episode->chapters_file_remote_url = null;
-            }
-        } elseif ($chaptersChoice === 'remote-url') {
-            if (
-                ($chaptersFileRemoteUrl = $this->request->getPost('chapters_file_remote_url')) &&
-                (($chaptersFile = $this->episode->chapters_file) &&
-                    $chaptersFile !== null)
-            ) {
-                unlink((string) $chaptersFile);
-                $this->episode->chapters_file_path = null;
-            }
-            $this->episode->chapters_file_remote_url = $chaptersFileRemoteUrl;
-        }
-
-        $episodeModel = new EpisodeModel();
-
-        if (! $episodeModel->update($this->episode->id, $this->episode)) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $episodeModel->errors());
-        }
-
-        // update podcast's episode_description_footer_markdown if changed
-        $this->podcast->episode_description_footer_markdown = $this->request->getPost('description_footer');
-
-        if ($this->podcast->hasChanged('episode_description_footer_markdown')) {
-            $podcastModel = new PodcastModel();
-            if (! $podcastModel->update($this->podcast->id, $this->podcast)) {
-                return redirect()
-                    ->back()
-                    ->withInput()
-                    ->with('errors', $podcastModel->errors());
-            }
-        }
-
-        return redirect()->route('episode-view', [$this->podcast->id, $this->episode->id]);
-    }
-
-    public function transcriptDelete(): RedirectResponse
-    {
-        unlink((string) $this->episode->transcript_file);
-        $this->episode->transcript_file_path = null;
-
-        $episodeModel = new EpisodeModel();
-
-        if (! $episodeModel->update($this->episode->id, $this->episode)) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $episodeModel->errors());
-        }
-
-        return redirect()->back();
-    }
-
-    public function chaptersDelete(): RedirectResponse
-    {
-        unlink((string) $this->episode->chapters_file);
-        $this->episode->chapters_file_path = null;
-
-        $episodeModel = new EpisodeModel();
-
-        if (! $episodeModel->update($this->episode->id, $this->episode)) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $episodeModel->errors());
-        }
-
-        return redirect()->back();
-    }
-
-    public function publish(): string
-    {
-        if ($this->episode->publication_status === 'not_published') {
-            helper(['form']);
-
-            $data = [
-                'podcast' => $this->podcast,
-                'episode' => $this->episode,
-            ];
-
-            replace_breadcrumb_params([
-                0 => $this->podcast->title,
-                1 => $this->episode->title,
-            ]);
-            return view('admin/episode/publish', $data);
-        }
-
-        throw PageNotFoundException::forPageNotFound();
-    }
-
-    public function attemptPublish(): RedirectResponse
-    {
-        $rules = [
-            'publication_method' => 'required',
-            'scheduled_publication_date' =>
-                'valid_date[Y-m-d H:i]|permit_empty',
-        ];
-
-        if (! $this->validate($rules)) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $this->validator->getErrors());
-        }
-
-        $db = Database::connect();
-        $db->transStart();
-
-        $newNote = new Note([
-            'actor_id' => $this->podcast->actor_id,
-            'episode_id' => $this->episode->id,
-            'message' => $this->request->getPost('message'),
-            'created_by' => user_id(),
-        ]);
-
-        $publishMethod = $this->request->getPost('publication_method');
-        if ($publishMethod === 'schedule') {
-            $scheduledPublicationDate = $this->request->getPost('scheduled_publication_date');
-            if ($scheduledPublicationDate) {
-                $this->episode->published_at = Time::createFromFormat(
-                    'Y-m-d H:i',
-                    $scheduledPublicationDate,
-                    $this->request->getPost('client_timezone'),
-                )->setTimezone('UTC');
-            } else {
-                $db->transRollback();
-                return redirect()
-                    ->back()
-                    ->withInput()
-                    ->with('error', 'Schedule date must be set!');
-            }
-        } else {
-            $this->episode->published_at = Time::now();
-        }
-
-        $newNote->published_at = $this->episode->published_at;
-
-        $noteModel = new NoteModel();
-        if (! $noteModel->addNote($newNote)) {
-            $db->transRollback();
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $noteModel->errors());
-        }
-
-        $episodeModel = new EpisodeModel();
-        if (! $episodeModel->update($this->episode->id, $this->episode)) {
-            $db->transRollback();
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $episodeModel->errors());
-        }
-
-        $db->transComplete();
-
-        return redirect()->route('episode-view', [$this->podcast->id, $this->episode->id]);
-    }
-
-    public function publishEdit(): string
-    {
-        if ($this->episode->publication_status === 'scheduled') {
-            helper(['form']);
-
-            $data = [
-                'podcast' => $this->podcast,
-                'episode' => $this->episode,
-                'note' => (new NoteModel())
-                    ->where([
-                        'actor_id' => $this->podcast->actor_id,
-                        'episode_id' => $this->episode->id,
-                    ])
-                    ->first(),
-            ];
-
-            replace_breadcrumb_params([
-                0 => $this->podcast->title,
-                1 => $this->episode->title,
-            ]);
-            return view('admin/episode/publish_edit', $data);
-        }
-        throw PageNotFoundException::forPageNotFound();
-    }
-
-    public function attemptPublishEdit(): RedirectResponse
-    {
-        $rules = [
-            'note_id' => 'required',
-            'publication_method' => 'required',
-            'scheduled_publication_date' =>
-                'valid_date[Y-m-d H:i]|permit_empty',
-        ];
-
-        if (! $this->validate($rules)) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $this->validator->getErrors());
-        }
-
-        $db = Database::connect();
-        $db->transStart();
-
-        $publishMethod = $this->request->getPost('publication_method');
-        if ($publishMethod === 'schedule') {
-            $scheduledPublicationDate = $this->request->getPost('scheduled_publication_date');
-            if ($scheduledPublicationDate) {
-                $this->episode->published_at = Time::createFromFormat(
-                    'Y-m-d H:i',
-                    $scheduledPublicationDate,
-                    $this->request->getPost('client_timezone'),
-                )->setTimezone('UTC');
-            } else {
-                $db->transRollback();
-                return redirect()
-                    ->back()
-                    ->withInput()
-                    ->with('error', 'Schedule date must be set!');
-            }
-        } else {
-            $this->episode->published_at = Time::now();
-        }
-
-        $note = (new NoteModel())->getNoteById($this->request->getPost('note_id'));
-
-        if ($note !== null) {
-            $note->message = $this->request->getPost('message');
-            $note->published_at = $this->episode->published_at;
-
-            $noteModel = new NoteModel();
-            if (! $noteModel->editNote($note)) {
-                $db->transRollback();
-                return redirect()
-                    ->back()
-                    ->withInput()
-                    ->with('errors', $noteModel->errors());
-            }
-        }
-
-        $episodeModel = new EpisodeModel();
-        if (! $episodeModel->update($this->episode->id, $this->episode)) {
-            $db->transRollback();
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $episodeModel->errors());
-        }
-
-        $db->transComplete();
-
-        return redirect()->route('episode-view', [$this->podcast->id, $this->episode->id]);
-    }
-
-    public function unpublish(): string
-    {
-        if ($this->episode->publication_status === 'published') {
-            helper(['form']);
-
-            $data = [
-                'podcast' => $this->podcast,
-                'episode' => $this->episode,
-            ];
-
-            replace_breadcrumb_params([
-                0 => $this->podcast->title,
-                1 => $this->episode->title,
-            ]);
-            return view('admin/episode/unpublish', $data);
-        }
-
-        throw PageNotFoundException::forPageNotFound();
-    }
-
-    public function attemptUnpublish(): RedirectResponse
-    {
-        $rules = [
-            'understand' => 'required',
-        ];
-
-        if (! $this->validate($rules)) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $this->validator->getErrors());
-        }
-
-        $db = Database::connect();
-
-        $db->transStart();
-
-        $allNotesLinkedToEpisode = (new NoteModel())
-            ->where([
-                'episode_id' => $this->episode->id,
-            ])
-            ->findAll();
-        foreach ($allNotesLinkedToEpisode as $note) {
-            (new NoteModel())->removeNote($note);
-        }
-
-        // set episode published_at to null to unpublish
-        $this->episode->published_at = null;
-
-        $episodeModel = new EpisodeModel();
-        if (! $episodeModel->update($this->episode->id, $this->episode)) {
-            $db->transRollback();
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $episodeModel->errors());
-        }
-
-        $db->transComplete();
-
-        return redirect()->route('episode-view', [$this->podcast->id, $this->episode->id]);
-    }
-
-    public function delete(): RedirectResponse
-    {
-        (new EpisodeModel())->delete($this->episode->id);
-
-        return redirect()->route('episode-list', [$this->podcast->id]);
-    }
-
-    public function soundbitesEdit(): string
-    {
-        helper(['form']);
-
-        $data = [
-            'podcast' => $this->podcast,
-            'episode' => $this->episode,
-        ];
-
-        replace_breadcrumb_params([
-            0 => $this->podcast->title,
-            1 => $this->episode->title,
-        ]);
-        return view('admin/episode/soundbites', $data);
-    }
-
-    public function soundbitesAttemptEdit(): RedirectResponse
-    {
-        $soundbites = $this->request->getPost('soundbites');
-        $rules = [
-            'soundbites.0.start_time' =>
-                'permit_empty|required_with[soundbites.0.duration]|decimal|greater_than_equal_to[0]',
-            'soundbites.0.duration' =>
-                'permit_empty|required_with[soundbites.0.start_time]|decimal|greater_than_equal_to[0]',
-        ];
-        foreach (array_keys($soundbites) as $soundbite_id) {
-            $rules += [
-                "soundbites.{$soundbite_id}.start_time" => 'required|decimal|greater_than_equal_to[0]',
-                "soundbites.{$soundbite_id}.duration" => 'required|decimal|greater_than_equal_to[0]',
-            ];
-        }
-        if (! $this->validate($rules)) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $this->validator->getErrors());
-        }
-
-        foreach ($soundbites as $soundbite_id => $soundbite) {
-            if ((int) $soundbite['start_time'] < (int) $soundbite['duration']) {
-                $data = [
-                    'podcast_id' => $this->podcast->id,
-                    'episode_id' => $this->episode->id,
-                    'start_time' => (float) $soundbite['start_time'],
-                    'duration' => (float) $soundbite['duration'],
-                    'label' => $soundbite['label'],
-                    'updated_by' => user_id(),
-                ];
-                if ($soundbite_id === 0) {
-                    $data += [
-                        'created_by' => user_id(),
-                    ];
-                } else {
-                    $data += [
-                        'id' => $soundbite_id,
-                    ];
-                }
-
-                $soundbiteModel = new SoundbiteModel();
-                if (! $soundbiteModel->save($data)) {
-                    return redirect()
-                        ->back()
-                        ->withInput()
-                        ->with('errors', $soundbiteModel->errors());
-                }
-            }
-        }
-        return redirect()->route('soundbites-edit', [$this->podcast->id, $this->episode->id]);
-    }
-
-    public function soundbiteDelete(string $soundbiteId): RedirectResponse
-    {
-        (new SoundbiteModel())->deleteSoundbite($this->podcast->id, $this->episode->id, (int) $soundbiteId);
-
-        return redirect()->route('soundbites-edit', [$this->podcast->id, $this->episode->id]);
-    }
-
-    public function embeddablePlayer(): string
-    {
-        helper(['form']);
-
-        $data = [
-            'podcast' => $this->podcast,
-            'episode' => $this->episode,
-            'themes' => EpisodeModel::$themes,
-        ];
-
-        replace_breadcrumb_params([
-            0 => $this->podcast->title,
-            1 => $this->episode->title,
-        ]);
-        return view('admin/episode/embeddable_player', $data);
-    }
-}

app/Controllers/Admin/PodcastController.php

-<?php
-
-declare(strict_types=1);
-
-/**
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-namespace App\Controllers\Admin;
-
-use App\Entities\Image;
-use App\Entities\Location;
-use App\Entities\Podcast;
-use App\Models\CategoryModel;
-use App\Models\EpisodeModel;
-use App\Models\LanguageModel;
-use App\Models\PodcastModel;
-use CodeIgniter\Exceptions\PageNotFoundException;
-use CodeIgniter\HTTP\RedirectResponse;
-use Config\Database;
-use Config\Services;
-
-class PodcastController extends BaseController
-{
-    protected Podcast $podcast;
-
-    public function _remap(string $method, string ...$params): mixed
-    {
-        if (count($params) === 0) {
-            return $this->{$method}();
-        }
-
-        if (
-            ($this->podcast = (new PodcastModel())->getPodcastById((int) $params[0])) !== null
-        ) {
-            return $this->{$method}();
-        }
-
-        throw PageNotFoundException::forPageNotFound();
-    }
-
-    public function list(): string
-    {
-        if (! has_permission('podcasts-list')) {
-            $data = [
-                'podcasts' => (new PodcastModel())->getUserPodcasts((int) user_id()),
-            ];
-        } else {
-            $data = [
-                'podcasts' => (new PodcastModel())->findAll(),
-            ];
-        }
-
-        return view('admin/podcast/list', $data);
-    }
-
-    public function view(): string
-    {
-        $data = [
-            'podcast' => $this->podcast,
-        ];
-
-        replace_breadcrumb_params([
-            0 => $this->podcast->title,
-        ]);
-        return view('admin/podcast/view', $data);
-    }
-
-    public function viewAnalytics(): string
-    {
-        $data = [
-            'podcast' => $this->podcast,
-        ];
-
-        replace_breadcrumb_params([
-            0 => $this->podcast->title,
-        ]);
-        return view('admin/podcast/analytics/index', $data);
-    }
-
-    public function viewAnalyticsWebpages(): string
-    {
-        $data = [
-            'podcast' => $this->podcast,
-        ];
-
-        replace_breadcrumb_params([
-            0 => $this->podcast->title,
-        ]);
-        return view('admin/podcast/analytics/webpages', $data);
-    }
-
-    public function viewAnalyticsLocations(): string
-    {
-        $data = [
-            'podcast' => $this->podcast,
-        ];
-
-        replace_breadcrumb_params([
-            0 => $this->podcast->title,
-        ]);
-        return view('admin/podcast/analytics/locations', $data);
-    }
-
-    public function viewAnalyticsUniqueListeners(): string
-    {
-        $data = [
-            'podcast' => $this->podcast,
-        ];
-
-        replace_breadcrumb_params([
-            0 => $this->podcast->title,
-        ]);
-        return view('admin/podcast/analytics/unique_listeners', $data);
-    }
-
-    public function viewAnalyticsListeningTime(): string
-    {
-        $data = [
-            'podcast' => $this->podcast,
-        ];
-
-        replace_breadcrumb_params([
-            0 => $this->podcast->title,
-        ]);
-        return view('admin/podcast/analytics/listening_time', $data);
-    }
-
-    public function viewAnalyticsTimePeriods(): string
-    {
-        $data = [
-            'podcast' => $this->podcast,
-        ];
-
-        replace_breadcrumb_params([
-            0 => $this->podcast->title,
-        ]);
-        return view('admin/podcast/analytics/time_periods', $data);
-    }
-
-    public function viewAnalyticsPlayers(): string
-    {
-        $data = [
-            'podcast' => $this->podcast,
-        ];
-
-        replace_breadcrumb_params([
-            0 => $this->podcast->title,
-        ]);
-        return view('admin/podcast/analytics/players', $data);
-    }
-
-    public function create(): string
-    {
-        helper(['form', 'misc']);
-
-        $languageOptions = (new LanguageModel())->getLanguageOptions();
-        $categoryOptions = (new CategoryModel())->getCategoryOptions();
-
-        $data = [
-            'languageOptions' => $languageOptions,
-            'categoryOptions' => $categoryOptions,
-            'browserLang' => get_browser_language($this->request->getServer('HTTP_ACCEPT_LANGUAGE')),
-        ];
-
-        return view('admin/podcast/create', $data);
-    }
-
-    public function attemptCreate(): RedirectResponse
-    {
-        $rules = [
-            'image' =>
-                'uploaded[image]|is_image[image]|ext_in[image,jpg,png]|min_dims[image,1400,1400]|is_image_squared[image]',
-        ];
-
-        if (! $this->validate($rules)) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $this->validator->getErrors());
-        }
-
-        if (
-            ($partnerId = $this->request->getPost('partner_id')) === '' ||
-            ($partnerLinkUrl = $this->request->getPost('partner_link_url')) === '' ||
-            ($partnerImageUrl = $this->request->getPost('partner_image_url')) === '') {
-            $partnerId = null;
-            $partnerLinkUrl = null;
-            $partnerImageUrl = null;
-        }
-
-        $podcast = new Podcast([
-            'title' => $this->request->getPost('title'),
-            'name' => $this->request->getPost('name'),
-            'description_markdown' => $this->request->getPost('description'),
-            'image' => new Image($this->request->getFile('image')),
-            'language_code' => $this->request->getPost('language'),
-            'category_id' => $this->request->getPost('category'),
-            'parental_advisory' =>
-                $this->request->getPost('parental_advisory') !== 'undefined'
-                    ? $this->request->getPost('parental_advisory')
-                    : null,
-            'owner_name' => $this->request->getPost('owner_name'),
-            'owner_email' => $this->request->getPost('owner_email'),
-            'publisher' => $this->request->getPost('publisher'),
-            'type' => $this->request->getPost('type'),
-            'copyright' => $this->request->getPost('copyright'),
-            'location' => new Location($this->request->getPost('location_name')),
-            'payment_pointer' => $this->request->getPost(
-                'payment_pointer'
-            ) === '' ? null : $this->request->getPost('payment_pointer'),
-            'custom_rss_string' => $this->request->getPost('custom_rss'),
-            'partner_id' => $partnerId,
-            'partner_link_url' => $partnerLinkUrl,
-            'partner_image_url' => $partnerImageUrl,
-            'is_blocked' => $this->request->getPost('block') === 'yes',
-            'is_completed' => $this->request->getPost('complete') === 'yes',
-            'is_locked' => $this->request->getPost('lock') === 'yes',
-            'created_by' => user_id(),
-            'updated_by' => user_id(),
-        ]);
-
-        $podcastModel = new PodcastModel();
-        $db = Database::connect();
-
-        $db->transStart();
-
-        if (! ($newPodcastId = $podcastModel->insert($podcast, true))) {
-            $db->transRollback();
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $podcastModel->errors());
-        }
-
-        $authorize = Services::authorization();
-        $podcastAdminGroup = $authorize->group('podcast_admin');
-
-        $podcastModel->addPodcastContributor(user_id(), $newPodcastId, (int) $podcastAdminGroup->id);
-
-        // set Podcast categories
-        (new CategoryModel())->setPodcastCategories(
-            (int) $newPodcastId,
-            $this->request->getPost('other_categories') ?? [],
-        );
-
-        // set interact as the newly created podcast actor
-        $createdPodcast = (new PodcastModel())->getPodcastById($newPodcastId);
-        set_interact_as_actor($createdPodcast->actor_id);
-
-        $db->transComplete();
-
-        return redirect()->route('podcast-view', [$newPodcastId]);
-    }
-
-    public function edit(): string
-    {
-        helper('form');
-
-        $languageOptions = (new LanguageModel())->getLanguageOptions();
-        $categoryOptions = (new CategoryModel())->getCategoryOptions();
-
-        $data = [
-            'podcast' => $this->podcast,
-            'languageOptions' => $languageOptions,
-            'categoryOptions' => $categoryOptions,
-        ];
-
-        replace_breadcrumb_params([
-            0 => $this->podcast->title,
-        ]);
-        return view('admin/podcast/edit', $data);
-    }
-
-    public function attemptEdit(): RedirectResponse
-    {
-        $rules = [
-            'image' =>
-                'is_image[image]|ext_in[image,jpg,png]|min_dims[image,1400,1400]|is_image_squared[image]',
-        ];
-
-        if (! $this->validate($rules)) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $this->validator->getErrors());
-        }
-
-        if (
-            ($partnerId = $this->request->getPost('partner_id')) === '' ||
-            ($partnerLinkUrl = $this->request->getPost('partner_link_url')) === '' ||
-            ($partnerImageUrl = $this->request->getPost('partner_image_url')) === '') {
-            $partnerId = null;
-            $partnerLinkUrl = null;
-            $partnerImageUrl = null;
-        }
-
-        $this->podcast->title = $this->request->getPost('title');
-        $this->podcast->description_markdown = $this->request->getPost('description');
-
-        $image = $this->request->getFile('image');
-        if ($image !== null && $image->isValid()) {
-            $this->podcast->image = new Image($image);
-        }
-        $this->podcast->language_code = $this->request->getPost('language');
-        $this->podcast->category_id = $this->request->getPost('category');
-        $this->podcast->parental_advisory =
-            $this->request->getPost('parental_advisory') !== 'undefined'
-                ? $this->request->getPost('parental_advisory')
-                : null;
-        $this->podcast->publisher = $this->request->getPost('publisher');
-        $this->podcast->owner_name = $this->request->getPost('owner_name');
-        $this->podcast->owner_email = $this->request->getPost('owner_email');
-        $this->podcast->type = $this->request->getPost('type');
-        $this->podcast->copyright = $this->request->getPost('copyright');
-        $this->podcast->location = new Location($this->request->getPost('location_name'));
-        $this->podcast->payment_pointer = $this->request->getPost(
-            'payment_pointer'
-        ) === '' ? null : $this->request->getPost('payment_pointer');
-        $this->podcast->custom_rss_string = $this->request->getPost('custom_rss');
-        $this->podcast->partner_id = $partnerId;
-        $this->podcast->partner_link_url = $partnerLinkUrl;
-        $this->podcast->partner_image_url = $partnerImageUrl;
-        $this->podcast->is_blocked = $this->request->getPost('block') === 'yes';
-        $this->podcast->is_completed =
-            $this->request->getPost('complete') === 'yes';
-        $this->podcast->is_locked = $this->request->getPost('lock') === 'yes';
-        $this->podcast->updated_by = (int) user_id();
-
-        $db = Database::connect();
-        $db->transStart();
-
-        $podcastModel = new PodcastModel();
-        if (! $podcastModel->update($this->podcast->id, $this->podcast)) {
-            $db->transRollback();
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $podcastModel->errors());
-        }
-
-        // set Podcast categories
-        (new CategoryModel())->setPodcastCategories(
-            $this->podcast->id,
-            $this->request->getPost('other_categories') ?? [],
-        );
-
-        $db->transComplete();
-
-        return redirect()->route('podcast-view', [$this->podcast->id]);
-    }
-
-    public function latestEpisodes(int $limit, int $podcast_id): string
-    {
-        $episodes = (new EpisodeModel())
-            ->where('podcast_id', $podcast_id)
-            ->orderBy('created_at', 'desc')
-            ->findAll($limit);
-
-        return view('admin/podcast/latest_episodes', [
-            'episodes' => $episodes,
-        ]);
-    }
-
-    public function delete(): RedirectResponse
-    {
-        (new PodcastModel())->delete($this->podcast->id);
-
-        return redirect()->route('podcast-list');
-    }
-}

app/Controllers/Admin/PodcastImportController.php

-<?php
-
-declare(strict_types=1);
-
-/**
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-namespace App\Controllers\Admin;
-
-use App\Entities\Episode;
-use App\Entities\Image;
-use App\Entities\Location;
-use App\Entities\Person;
-use App\Entities\Podcast;
-use App\Models\CategoryModel;
-use App\Models\EpisodeModel;
-use App\Models\LanguageModel;
-use App\Models\PersonModel;
-use App\Models\PlatformModel;
-use App\Models\PodcastModel;
-use CodeIgniter\Exceptions\PageNotFoundException;
-use CodeIgniter\HTTP\RedirectResponse;
-use Config\Database;
-use Config\Services;
-use ErrorException;
-use League\HTMLToMarkdown\HtmlConverter;
-use Podlibre\PodcastNamespace\ReversedTaxonomy;
-
-class PodcastImportController extends BaseController
-{
-    protected ?Podcast $podcast;
-
-    public function _remap(string $method, string ...$params): mixed
-    {
-        if (count($params) === 0) {
-            return $this->{$method}();
-        }
-
-        if (($this->podcast = (new PodcastModel())->getPodcastById((int) $params[0])) !== null) {
-            return $this->{$method}();
-        }
-
-        throw PageNotFoundException::forPageNotFound();
-    }
-
-    public function index(): string
-    {
-        helper(['form', 'misc']);
-
-        $languageOptions = (new LanguageModel())->getLanguageOptions();
-        $categoryOptions = (new CategoryModel())->getCategoryOptions();
-
-        $data = [
-            'languageOptions' => $languageOptions,
-            'categoryOptions' => $categoryOptions,
-            'browserLang' => get_browser_language($this->request->getServer('HTTP_ACCEPT_LANGUAGE')),
-        ];
-
-        return view('admin/podcast/import', $data);
-    }
-
-    public function attemptImport(): RedirectResponse
-    {
-        helper(['media', 'misc']);
-
-        $rules = [
-            'imported_feed_url' => 'required|validate_url',
-            'season_number' => 'is_natural_no_zero|permit_empty',
-            'max_episodes' => 'is_natural_no_zero|permit_empty',
-        ];
-
-        if (! $this->validate($rules)) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $this->validator->getErrors());
-        }
-        try {
-            ini_set('user_agent', 'Castopod/' . CP_VERSION);
-            $feed = simplexml_load_file($this->request->getPost('imported_feed_url'));
-        } catch (ErrorException $errorException) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', [
-                    $errorException->getMessage() .
-                        ': <a href="' .
-                        $this->request->getPost('imported_feed_url') .
-                        '" rel="noreferrer noopener" target="_blank">' .
-                        $this->request->getPost('imported_feed_url') .
-                        ' ⎋</a>',
-                ]);
-        }
-        $nsItunes = $feed->channel[0]->children('http://www.itunes.com/dtds/podcast-1.0.dtd');
-        $nsPodcast = $feed->channel[0]->children(
-            'https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md',
-        );
-        $nsContent = $feed->channel[0]->children('http://purl.org/rss/1.0/modules/content/');
-
-        if ((string) $nsPodcast->locked === 'yes') {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', [lang('PodcastImport.lock_import')]);
-        }
-
-        $converter = new HtmlConverter();
-
-        $channelDescriptionHtml = (string) $feed->channel[0]->description;
-
-        try {
-            if (
-                property_exists($nsItunes, 'image') && $nsItunes->image !== null &&
-                $nsItunes->image->attributes()['href'] !== null
-            ) {
-                $imageFile = download_file((string) $nsItunes->image->attributes()['href']);
-            } else {
-                $imageFile = download_file((string) $feed->channel[0]->image->url);
-            }
-
-            $location = null;
-            if (property_exists($nsPodcast, 'location') && $nsPodcast->location !== null) {
-                $location = new Location(
-                    (string) $nsPodcast->location,
-                    (string) $nsPodcast->location->attributes()['geo'],
-                    (string) $nsPodcast->location->attributes()['osm'],
-                );
-            }
-
-            $podcast = new Podcast([
-                'name' => $this->request->getPost('name'),
-                'imported_feed_url' => $this->request->getPost('imported_feed_url'),
-                'new_feed_url' => base_url(route_to('podcast_feed', $this->request->getPost('name'))),
-                'title' => (string) $feed->channel[0]->title,
-                'description_markdown' => $converter->convert($channelDescriptionHtml),
-                'description_html' => $channelDescriptionHtml,
-                'image' => new Image($imageFile),
-                'language_code' => $this->request->getPost('language'),
-                'category_id' => $this->request->getPost('category'),
-                'parental_advisory' =>
-                property_exists($nsItunes, 'explicit') && $nsItunes->explicit !== null
-                    ? (in_array((string) $nsItunes->explicit, ['yes', 'true'], true)
-                        ? 'explicit'
-                        : (in_array((string) $nsItunes->explicit, ['no', 'false'], true)
-                            ? 'clean'
-                            : null))
-                    : null,
-                'owner_name' => (string) $nsItunes->owner->name,
-                'owner_email' => (string) $nsItunes->owner->email,
-                'publisher' => (string) $nsItunes->author,
-                'type' => property_exists(
-                    $nsItunes,
-                    'type'
-                ) && $nsItunes->type !== null ? (string) $nsItunes->type : 'episodic',
-                'copyright' => (string) $feed->channel[0]->copyright,
-                'is_blocked' =>
-                property_exists($nsItunes, 'block') && $nsItunes->block !== null && (string) $nsItunes->block === 'yes',
-                'is_completed' =>
-                property_exists(
-                    $nsItunes,
-                    'complete'
-                ) && $nsItunes->complete !== null && (string) $nsItunes->complete === 'yes',
-                'location' => $location,
-                'created_by' => user_id(),
-                'updated_by' => user_id(),
-            ]);
-        } catch (ErrorException $ex) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', [
-                    $ex->getMessage() .
-                        ': <a href="' .
-                        $this->request->getPost('imported_feed_url') .
-                        '" rel="noreferrer noopener" target="_blank">' .
-                        $this->request->getPost('imported_feed_url') .
-                        ' ⎋</a>',
-                ]);
-        }
-
-        $podcastModel = new PodcastModel();
-        $db = Database::connect();
-
-        $db->transStart();
-
-        if (! ($newPodcastId = $podcastModel->insert($podcast, true))) {
-            $db->transRollback();
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $podcastModel->errors());
-        }
-
-        $authorize = Services::authorization();
-        $podcastAdminGroup = $authorize->group('podcast_admin');
-
-        $podcastModel->addPodcastContributor(user_id(), $newPodcastId, (int) $podcastAdminGroup->id);
-
-        $podcastsPlatformsData = [];
-        $platformTypes = [
-            [
-                'name' => 'podcasting',
-                'elements' => $nsPodcast->id,
-            ],
-            [
-                'name' => 'social',
-                'elements' => $nsPodcast->social,
-            ],
-            [
-                'name' => 'funding',
-                'elements' => $nsPodcast->funding,
-            ],
-        ];
-        $platformModel = new PlatformModel();
-        foreach ($platformTypes as $platformType) {
-            foreach ($platformType['elements'] as $platform) {
-                $platformLabel = $platform->attributes()['platform'];
-                $platformSlug = slugify((string) $platformLabel);
-                if ($platformModel->getPlatform($platformSlug) !== null) {
-                    $podcastsPlatformsData[] = [
-                        'platform_slug' => $platformSlug,
-                        'podcast_id' => $newPodcastId,
-                        'link_url' => $platform->attributes()['url'],
-                        'link_content' => $platform->attributes()['id'],
-                        'is_visible' => false,
-                    ];
-                }
-            }
-        }
-
-        if (count($podcastsPlatformsData) > 1) {
-            $platformModel->createPodcastPlatforms($newPodcastId, $podcastsPlatformsData);
-        }
-
-        foreach ($nsPodcast->person as $podcastPerson) {
-            $fullName = (string) $podcastPerson;
-            $personModel = new PersonModel();
-            $newPersonId = null;
-            if (($newPerson = $personModel->getPerson($fullName)) !== null) {
-                $newPersonId = $newPerson->id;
-            } else {
-                $newPodcastPerson = new Person([
-                    'full_name' => $fullName,
-                    'unique_name' => slugify($fullName),
-                    'information_url' => $podcastPerson->attributes()['href'],
-                    'image' => new Image(download_file((string) $podcastPerson->attributes()['img'])),
-                    'created_by' => user_id(),
-                    'updated_by' => user_id(),
-                ]);
-
-                if (! $newPersonId = $personModel->insert($newPodcastPerson)) {
-                    return redirect()
-                        ->back()
-                        ->withInput()
-                        ->with('errors', $personModel->errors());
-                }
-            }
-
-            // TODO: these checks should be in the taxonomy as default values
-            $podcastPersonGroup = $podcastPerson->attributes()['group'] ?? 'Cast';
-            $podcastPersonRole = $podcastPerson->attributes()['role'] ?? 'Host';
-
-            $personGroup = ReversedTaxonomy::$taxonomy[(string) $podcastPersonGroup];
-
-            $personGroupSlug = $personGroup['slug'];
-            $personRoleSlug = $personGroup['roles'][(string) $podcastPersonRole]['slug'];
-
-            $podcastPersonModel = new PersonModel();
-            if (! $podcastPersonModel->addPodcastPerson(
-                $newPodcastId,
-                $newPersonId,
-                $personGroupSlug,
-                $personRoleSlug
-            )) {
-                return redirect()
-                    ->back()
-                    ->withInput()
-                    ->with('errors', $podcastPersonModel->errors());
-            }
-        }
-
-        $numberItems = $feed->channel[0]->item->count();
-        $lastItem =
-            $this->request->getPost('max_episodes') !== null &&
-            $this->request->getPost('max_episodes') < $numberItems
-            ? $this->request->getPost('max_episodes')
-            : $numberItems;
-
-        $slugs = [];
-        for ($itemNumber = 1; $itemNumber <= $lastItem; ++$itemNumber) {
-            $item = $feed->channel[0]->item[$numberItems - $itemNumber];
-
-            $nsItunes = $item->children('http://www.itunes.com/dtds/podcast-1.0.dtd');
-            $nsPodcast = $item->children(
-                'https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md',
-            );
-            $nsContent = $item->children('http://purl.org/rss/1.0/modules/content/');
-
-            $slug = slugify(
-                $this->request->getPost('slug_field') === 'title'
-                    ? (string) $item->title
-                    : basename($item->link),
-            );
-            if (in_array($slug, $slugs, true)) {
-                $slugNumber = 2;
-                while (in_array($slug . '-' . $slugNumber, $slugs, true)) {
-                    ++$slugNumber;
-                }
-                $slug = $slug . '-' . $slugNumber;
-            }
-            $slugs[] = $slug;
-            $itemDescriptionHtml = match ($this->request->getPost('description_field')) {
-                'content' => $nsContent->encoded,
-                'summary' => $nsItunes->summary,
-                'subtitle_summary' => $nsItunes->subtitle . '<br/>' . $nsItunes->summary,
-                default => $item->description,
-            };
-
-            if (
-                property_exists($nsItunes, 'image') && $nsItunes->image !== null &&
-                $nsItunes->image->attributes()['href'] !== null
-            ) {
-                $episodeImage = new Image(download_file((string) $nsItunes->image->attributes()['href']));
-            } else {
-                $episodeImage = null;
-            }
-
-            $location = null;
-            if (property_exists($nsPodcast, 'location') && $nsPodcast->location !== null) {
-                $location = new Location(
-                    (string) $nsPodcast->location,
-                    (string) $nsPodcast->location->attributes()['geo'],
-                    (string) $nsPodcast->location->attributes()['osm'],
-                );
-            }
-
-            $newEpisode = new Episode([
-                'podcast_id' => $newPodcastId,
-                'guid' => $item->guid ?? null,
-                'title' => $item->title,
-                'slug' => $slug,
-                'audio_file' => download_file((string) $item->enclosure->attributes()['url']),
-                'description_markdown' => $converter->convert($itemDescriptionHtml),
-                'description_html' => $itemDescriptionHtml,
-                'image' => $episodeImage,
-                'parental_advisory' =>
-                property_exists($nsItunes, 'explicit') && $nsItunes->explicit !== null
-                    ? (in_array((string) $nsItunes->explicit, ['yes', 'true'], true)
-                        ? 'explicit'
-                        : (in_array((string) $nsItunes->explicit, ['no', 'false'], true)
-                            ? 'clean'
-                            : null))
-                    : null,
-                'number' =>
-                $this->request->getPost('force_renumber') === 'yes'
-                    ? $itemNumber
-                    : $nsItunes->episode,
-                'season_number' =>
-                $this->request->getPost('season_number') === null
-                    ? $nsItunes->season
-                    : $this->request->getPost('season_number'),
-                'type' => property_exists($nsItunes, 'episodeType') && $nsItunes->episodeType !== null
-                    ? (string) $nsItunes->episodeType
-                    : 'full',
-                'is_blocked' => property_exists(
-                    $nsItunes,
-                    'block'
-                ) && $nsItunes->block !== null && (string) $nsItunes->block === 'yes',
-                'location' => $location,
-                'created_by' => user_id(),
-                'updated_by' => user_id(),
-                'published_at' => strtotime((string) $item->pubDate),
-            ]);
-
-            $episodeModel = new EpisodeModel();
-
-            if (! ($newEpisodeId = $episodeModel->insert($newEpisode, true))) {
-                // FIXME: What shall we do?
-                return redirect()
-                    ->back()
-                    ->withInput()
-                    ->with('errors', $episodeModel->errors());
-            }
-
-            foreach ($nsPodcast->person as $episodePerson) {
-                $fullName = (string) $episodePerson;
-                $personModel = new PersonModel();
-                $newPersonId = null;
-                if (($newPerson = $personModel->getPerson($fullName)) !== null) {
-                    $newPersonId = $newPerson->id;
-                } else {
-                    $newPerson = new Person([
-                        'full_name' => $fullName,
-                        'unique_name' => slugify($fullName),
-                        'information_url' => $episodePerson->attributes()['href'],
-                        'image' => new Image(download_file((string) $episodePerson->attributes()['img'])),
-                        'created_by' => user_id(),
-                        'updated_by' => user_id(),
-                    ]);
-
-                    if (! ($newPersonId = $personModel->insert($newPerson))) {
-                        return redirect()
-                            ->back()
-                            ->withInput()
-                            ->with('errors', $personModel->errors());
-                    }
-                }
-
-                // TODO: these checks should be in the taxonomy as default values
-                $episodePersonGroup = $episodePerson->attributes()['group'] ?? 'Cast';
-                $episodePersonRole = $episodePerson->attributes()['role'] ?? 'Host';
-
-                $personGroup = ReversedTaxonomy::$taxonomy[(string) $episodePersonGroup];
-
-                $personGroupSlug = $personGroup['slug'];
-                $personRoleSlug = $personGroup['roles'][(string) $episodePersonRole]['slug'];
-
-                $episodePersonModel = new PersonModel();
-                if (! $episodePersonModel->addEpisodePerson(
-                    $newPodcastId,
-                    $newEpisodeId,
-                    $newPersonId,
-                    $personGroupSlug,
-                    $personRoleSlug
-                )) {
-                    return redirect()
-                        ->back()
-                        ->withInput()
-                        ->with('errors', $episodePersonModel->errors());
-                }
-            }
-        }
-
-        // set interact as the newly imported podcast actor
-        $importedPodcast = (new PodcastModel())->getPodcastById($newPodcastId);
-        set_interact_as_actor($importedPodcast->actor_id);
-
-        $db->transComplete();
-
-        return redirect()->route('podcast-view', [$newPodcastId]);
-    }
-}

app/Controllers/AuthController.php

-<?php
-
-declare(strict_types=1);
-
-/**
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-namespace App\Controllers;
-
-use App\Entities\User;
-use CodeIgniter\HTTP\RedirectResponse;
-use Myth\Auth\Controllers\AuthController as MythAuthController;
-
-class AuthController extends MythAuthController
-{
-    /**
-     * An array of helpers to be automatically loaded upon class instantiation.
-     *
-     * @var string[]
-     */
-    protected $helpers = ['components'];
-
-    /**
-     * Attempt to register a new user.
-     */
-    public function attemptRegister(): RedirectResponse
-    {
-        // Check if registration is allowed
-        if (! $this->config->allowRegistration) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('error', lang('Auth.registerDisabled'));
-        }
-
-        $users = model('UserModel');
-
-        // Validate here first, since some things,
-        // like the password, can only be validated properly here.
-        $rules = [
-            'username' =>
-                'required|alpha_numeric_space|min_length[3]|is_unique[users.username]',
-            'email' => 'required|valid_email|is_unique[users.email]',
-            'password' => 'required|strong_password',
-        ];
-
-        if (! $this->validate($rules)) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', service('validation')->getErrors());
-        }
-
-        // Save the user
-        $allowedPostFields = array_merge(['password'], $this->config->validFields, $this->config->personalFields);
-        $user = new User($this->request->getPost($allowedPostFields));
-
-        $this->config->requireActivation === null
-            ? $user->activate()
-            : $user->generateActivateHash();
-
-        // Ensure default group gets assigned if set
-        if ($this->config->defaultUserGroup !== null) {
-            $users = $users->withGroup($this->config->defaultUserGroup);
-        }
-
-        if (! $users->save($user)) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $users->errors());
-        }
-
-        if ($this->config->requireActivation !== null) {
-            $activator = service('activator');
-            $sent = $activator->send($user);
-
-            if (! $sent) {
-                return redirect()
-                    ->back()
-                    ->withInput()
-                    ->with('error', $activator->error() ?? lang('Auth.unknownError'));
-            }
-
-            // Success!
-            return redirect()
-                ->route('login')
-                ->with('message', lang('Auth.activationSuccess'));
-        }
-
-        // Success!
-        return redirect()
-            ->route('login')
-            ->with('message', lang('Auth.registerSuccess'));
-    }
-
-    /**
-     * Verifies the code with the email and saves the new password, if they all pass validation.
-     */
-    public function attemptReset(): RedirectResponse
-    {
-        if ($this->config->activeResetter === null) {
-            return redirect()
-                ->route('login')
-                ->with('error', lang('Auth.forgotDisabled'));
-        }
-
-        $users = model('UserModel');
-
-        // First things first - log the reset attempt.
-        $users->logResetAttempt(
-            $this->request->getPost('email'),
-            $this->request->getPost('token'),
-            $this->request->getIPAddress(),
-            (string) $this->request->getUserAgent(),
-        );
-
-        $rules = [
-            'token' => 'required',
-            'email' => 'required|valid_email',
-            'password' => 'required|strong_password',
-        ];
-
-        if (! $this->validate($rules)) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', $users->errors());
-        }
-
-        $user = $users
-            ->where('email', $this->request->getPost('email'))
-            ->where('reset_hash', $this->request->getPost('token'))
-            ->first();
-
-        if ($user === null) {
-            return redirect()
-                ->back()
-                ->with('error', lang('Auth.forgotNoUser'));
-        }
-
-        // Reset token still valid?
-        if (
-            $user->reset_expires !== null &&
-            time() > $user->reset_expires->getTimestamp()
-        ) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('error', lang('Auth.resetTokenExpired'));
-        }
-
-        // Success! Save the new password, and cleanup the reset hash.
-        $user->password = $this->request->getPost('password');
-        $user->reset_hash = null;
-        $user->reset_at = date('Y-m-d H:i:s');
-        $user->reset_expires = null;
-        $user->force_pass_reset = false;
-        $users->save($user);
-
-        return redirect()
-            ->route('login')
-            ->with('message', lang('Auth.resetSuccess'));
-    }
-
-    public function attemptInteractAsActor(): RedirectResponse
-    {
-        $rules = [
-            'actor_id' => 'required|numeric',
-        ];
-
-        if (! $this->validate($rules)) {
-            return redirect()
-                ->back()
-                ->withInput()
-                ->with('errors', service('validation')->getErrors());
-        }
-
-        helper('auth');
-
-        set_interact_as_actor($this->request->getPost('actor_id'));
-
-        return redirect()->back();
-    }
-}

app/Controllers/BaseController.php

@@ -7,35 +7,44 @@ namespace App\Controllers;
 use CodeIgniter\Controller;
 use CodeIgniter\HTTP\RequestInterface;
 use CodeIgniter\HTTP\ResponseInterface;
+use Override;
 use Psr\Log\LoggerInterface;
+use ViewThemes\Theme;
 
 /**
- * Class BaseController
- *
  * BaseController provides a convenient place for loading components and performing functions that are needed by all
  * your controllers. Extend this class in any new controllers: class Home extends BaseController
  *
  * For security be sure to declare any new methods as protected or private.
  */
-class BaseController extends Controller
+abstract class BaseController extends Controller
 {
     /**
-     * An array of helpers to be loaded automatically upon class instantiation. These helpers will be available to all
-     * other controllers that extend BaseController.
+     * An array of helpers to be loaded automatically upon
+     * class instantiation. These helpers will be available
+     * to all other controllers that extend BaseController.
      *
-     * @var string[]
+     * @var list<string>
      */
-    protected $helpers = ['auth', 'svg', 'components', 'misc'];
+    protected $helpers = [];
 
     /**
-     * Constructor.
+     * Be sure to declare properties for any property fetch you initialized.
+     * The creation of dynamic property is deprecated in PHP 8.2.
      */
+    // protected $session;
+
+    #[Override]
     public function initController(
         RequestInterface $request,
         ResponseInterface $response,
-        LoggerInterface $logger
+        LoggerInterface $logger,
     ): void {
+        $this->helpers = [...$this->helpers, 'svg', 'components', 'misc', 'seo', 'premium_podcasts'];
+
         // Do Not Edit This Line
         parent::initController($request, $response, $logger);
+
+        Theme::setTheme('app');
     }
 }

app/Controllers/ColorsController.php

+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright  2020 Ad Aures
+ * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
+ * @link       https://castopod.org/
+ */
+
+namespace App\Controllers;
+
+use CodeIgniter\Controller;
+use CodeIgniter\HTTP\ResponseInterface;
+
+class ColorsController extends Controller
+{
+    public function index(): ResponseInterface
+    {
+        $cacheName = 'colors.css';
+        if (
+            ! ($colorsCssBody = cache($cacheName))
+        ) {
+            $colorThemes = config('Colors')
+                ->themes;
+
+            $colorsCssBody = '';
+            foreach ($colorThemes as $name => $color) {
+                $colorsCssBody .= ".theme-{$name} {";
+                foreach ($color as $variable => $value) {
+                    $colorsCssBody .= "--color-{$variable}: {$value[0]} {$value[1]}% {$value[2]}%;";
+                }
+
+                $colorsCssBody .= '}';
+            }
+
+            cache()
+                ->save($cacheName, $colorsCssBody, DECADE);
+        }
+
+        return $this->response->setHeader('Content-Type', 'text/css')
+            ->setHeader('charset', 'UTF-8')
+            ->setBody($colorsCssBody);
+    }
+}

app/Controllers/CreditsController.php

@@ -3,7 +3,7 @@
 declare(strict_types=1);
 
 /**
- * @copyright  2020 Podlibre
+ * @copyright  2020 Ad Aures
  * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
  * @link       https://castopod.org/
  */
@@ -20,16 +20,20 @@ class CreditsController extends BaseController
     {
         $locale = service('request')
             ->getLocale();
-        $allPodcasts = (new PodcastModel())->findAll();
 
-        $cacheName = "page_credits_{$locale}";
+        $cacheName = implode(
+            '_',
+            array_filter(['page', 'credits', $locale, auth()->loggedIn() ? 'authenticated' : null]),
+        );
+
         if (! ($found = cache($cacheName))) {
             $page = new Page([
-                'title' => lang('Person.credits', [], $locale),
-                'slug' => 'credits',
+                'title'            => lang('Person.credits', [], $locale),
+                'slug'             => 'credits',
                 'content_markdown' => '',
             ]);
 
+            $allPodcasts = (new PodcastModel())->findAll();
             $allCredits = (new CreditModel())->findAll();
 
             // Unlike the carpenter, we make a tree from a table:
@@ -44,27 +48,24 @@ class CreditsController extends BaseController
                     $personRole = $credit->person_role;
                     $credits[$personGroup] = [
                         'group_label' => $credit->group_label,
-                        'persons' => [
+                        'persons'     => [
                             $personId => [
-                                'full_name' => $credit->person->full_name,
-                                'thumbnail_url' =>
-                                    $credit->person->image->thumbnail_url,
-                                'information_url' =>
-                                    $credit->person->information_url,
-                                'roles' => [
+                                'full_name'       => $credit->person->full_name,
+                                'thumbnail_url'   => get_avatar_url($credit->person, 'thumbnail'),
+                                'information_url' => $credit->person->information_url,
+                                'roles'           => [
                                     $personRole => [
                                         'role_label' => $credit->role_label,
-                                        'is_in' => [
+                                        'is_in'      => [
                                             [
                                                 'link' => $credit->episode_id
                                                     ? $credit->episode->link
                                                     : $credit->podcast->link,
                                                 'title' => $credit->episode_id
                                                     ? (count($allPodcasts) > 1
-                                                            ? "{$credit->podcast->title} › "
+                                                            ? esc($credit->podcast->title) . ' › '
                                                             : '') .
-                                                        $credit->episode
-                                                            ->title .
+                                                        esc($credit->episode->title) .
                                                         episode_numbering(
                                                             $credit->episode
                                                                 ->number,
@@ -73,7 +74,7 @@ class CreditsController extends BaseController
                                                             'text-xs ml-2',
                                                             true,
                                                         )
-                                                    : $credit->podcast->title,
+                                                    : esc($credit->podcast->title),
                                             ],
                                         ],
                                     ],
@@ -85,23 +86,22 @@ class CreditsController extends BaseController
                     $personId = $credit->person_id;
                     $personRole = $credit->person_role;
                     $credits[$personGroup]['persons'][$personId] = [
-                        'full_name' => $credit->person->full_name,
-                        'thumbnail_url' =>
-                            $credit->person->image->thumbnail_url,
+                        'full_name'       => $credit->person->full_name,
+                        'thumbnail_url'   => get_avatar_url($credit->person, 'thumbnail'),
                         'information_url' => $credit->person->information_url,
-                        'roles' => [
+                        'roles'           => [
                             $personRole => [
                                 'role_label' => $credit->role_label,
-                                'is_in' => [
+                                'is_in'      => [
                                     [
                                         'link' => $credit->episode_id
                                             ? $credit->episode->link
                                             : $credit->podcast->link,
                                         'title' => $credit->episode_id
                                             ? (count($allPodcasts) > 1
-                                                    ? "{$credit->podcast->title} › "
+                                                    ? esc($credit->podcast->title) . ' › '
                                                     : '') .
-                                                $credit->episode->title .
+                                                    esc($credit->episode->title) .
                                                 episode_numbering(
                                                     $credit->episode->number,
                                                     $credit->episode
@@ -109,7 +109,7 @@ class CreditsController extends BaseController
                                                     'text-xs ml-2',
                                                     true,
                                                 )
-                                            : $credit->podcast->title,
+                                            : esc($credit->podcast->title),
                                     ],
                                 ],
                             ],
@@ -121,23 +121,23 @@ class CreditsController extends BaseController
                         $personRole
                     ] = [
                         'role_label' => $credit->role_label,
-                        'is_in' => [
+                        'is_in'      => [
                             [
                                 'link' => $credit->episode_id
                                     ? $credit->episode->link
                                     : $credit->podcast->link,
                                 'title' => $credit->episode_id
                                     ? (count($allPodcasts) > 1
-                                            ? "{$credit->podcast->title} › "
+                                            ? esc($credit->podcast->title) . ' › '
                                             : '') .
-                                        $credit->episode->title .
+                                            esc($credit->episode->title) .
                                         episode_numbering(
                                             $credit->episode->number,
                                             $credit->episode->season_number,
                                             'text-xs ml-2',
                                             true,
                                         )
-                                    : $credit->podcast->title,
+                                    : esc($credit->podcast->title),
                             ],
                         ],
                     ];
@@ -150,26 +150,27 @@ class CreditsController extends BaseController
                             : $credit->podcast->link,
                         'title' => $credit->episode_id
                             ? (count($allPodcasts) > 1
-                                    ? "{$credit->podcast->title} › "
+                                    ? esc($credit->podcast->title) . ' › '
                                     : '') .
-                                $credit->episode->title .
+                                    esc($credit->episode->title) .
                                 episode_numbering(
                                     $credit->episode->number,
                                     $credit->episode->season_number,
                                     'text-xs ml-2',
                                     true,
                                 )
-                            : $credit->podcast->title,
+                            : esc($credit->podcast->title),
                     ];
                 }
             }
 
+            set_page_metatags($page);
             $data = [
-                'page' => $page,
+                'page'    => $page,
                 'credits' => $credits,
             ];
 
-            $found = view('credits', $data);
+            $found = view('pages/credits', $data);
 
             cache()
                 ->save($cacheName, $found, DECADE);

app/Controllers/EpisodeAudioController.php

+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright  2020 Ad Aures
+ * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
+ * @link       https://castopod.org/
+ */
+
+namespace App\Controllers;
+
+use App\Entities\Episode;
+use App\Entities\Podcast;
+use App\Models\EpisodeModel;
+use App\Models\PodcastModel;
+use CodeIgniter\Controller;
+use CodeIgniter\Exceptions\PageNotFoundException;
+use CodeIgniter\HTTP\RedirectResponse;
+use CodeIgniter\HTTP\RequestInterface;
+use CodeIgniter\HTTP\ResponseInterface;
+use CodeIgniter\HTTP\URI;
+use Modules\Analytics\Config\Analytics;
+use Modules\PremiumPodcasts\Entities\Subscription;
+use Modules\PremiumPodcasts\Models\SubscriptionModel;
+use Override;
+use Psr\Log\LoggerInterface;
+
+class EpisodeAudioController extends Controller
+{
+    /**
+     * An array of helpers to be loaded automatically upon class instantiation. These helpers will be available to all
+     * other controllers that extend Analytics.
+     *
+     * @var list<string>
+     */
+    protected $helpers = ['analytics'];
+
+    protected Podcast $podcast;
+
+    protected Episode $episode;
+
+    protected Analytics $analyticsConfig;
+
+    #[Override]
+    public function initController(
+        RequestInterface $request,
+        ResponseInterface $response,
+        LoggerInterface $logger,
+    ): void {
+        // Do Not Edit This Line
+        parent::initController($request, $response, $logger);
+
+        set_user_session_deny_list_ip();
+        set_user_session_location();
+        set_user_session_player();
+
+        $this->analyticsConfig = config('Analytics');
+    }
+
+    public function _remap(string $method, string ...$params): mixed
+    {
+        if (count($params) < 2) {
+            throw PageNotFoundException::forPageNotFound();
+        }
+
+        if (
+            ! ($podcast = (new PodcastModel())->getPodcastByHandle($params[0])) instanceof Podcast
+        ) {
+            throw PageNotFoundException::forPageNotFound();
+        }
+
+        $this->podcast = $podcast;
+
+        if (
+            ! ($episode = (new EpisodeModel())->getEpisodeBySlug($params[0], $params[1])) instanceof Episode
+        ) {
+            throw PageNotFoundException::forPageNotFound();
+        }
+
+        $this->episode = $episode;
+
+        unset($params[1]);
+        unset($params[0]);
+
+        return $this->{$method}(...$params);
+    }
+
+    public function index(): RedirectResponse | ResponseInterface
+    {
+        // check if episode is premium?
+        $subscription = null;
+
+        // check if podcast is already unlocked before any token validation
+        if ($this->episode->is_premium && ! ($subscription = service('premium_podcasts')->subscription(
+            $this->episode->podcast->handle,
+        )) instanceof Subscription) {
+            // look for token as GET parameter
+            if (($token = $this->request->getGet('token')) === null) {
+                return $this->response->setStatusCode(401)
+                    ->setJSON([
+                        'errors' => [
+                            'status' => 401,
+                            'title'  => 'Unauthorized',
+                            'detail' => 'Episode is premium, you must provide a token to unlock it.',
+                        ],
+                    ]);
+            }
+
+            // check if there's a valid subscription for the provided token
+            if (! ($subscription = (new SubscriptionModel())->validateSubscription(
+                $this->episode->podcast->handle,
+                $token,
+            )) instanceof Subscription) {
+                return $this->response->setStatusCode(401, 'Invalid token!')
+                    ->setJSON([
+                        'errors' => [
+                            'status' => 401,
+                            'title'  => 'Unauthorized',
+                            'detail' => 'Invalid token!',
+                        ],
+                    ]);
+            }
+        }
+
+        $session = service('session');
+
+        $serviceName = '';
+        if ($this->request->getGet('_from')) {
+            $serviceName = $this->request->getGet('_from');
+        } elseif ($session->get('embed_domain') !== null) {
+            $serviceName = $session->get('embed_domain');
+        } elseif ($session->get('referer') !== null && $session->get('referer') !== '- Direct -') {
+            $serviceName = parse_url((string) $session->get('referer'), PHP_URL_HOST);
+        }
+
+        $audioFileSize = $this->episode->audio->file_size;
+        $audioFileHeaderSize = $this->episode->audio->header_size;
+        $audioDuration = $this->episode->audio->duration;
+
+        // bytes_threshold: number of bytes that must be downloaded for an episode to be counted in download analytics
+        // - if audio is less than or equal to 60s, then take the audio file_size
+        // - if audio is more than 60s, then take the audio file_header_size + 60s
+        $bytesThreshold = $audioDuration <= 60
+        ? $audioFileSize
+        : $audioFileHeaderSize +
+        (int) floor((($audioFileSize - $audioFileHeaderSize) / $audioDuration) * 60);
+
+        podcast_hit(
+            $this->episode->podcast_id,
+            $this->episode->id,
+            $bytesThreshold,
+            $audioFileSize,
+            $audioDuration,
+            $this->episode->published_at->getTimestamp(),
+            $serviceName,
+            $subscription instanceof Subscription ? $subscription->id : null,
+        );
+
+        $audioFileURI = new URI(service('file_manager')->getUrl($this->episode->audio->file_key));
+
+        $queryParams = [];
+        foreach ($this->request->getGet() as $key => $value) {
+            // do not include token in query params
+            if ($key !== 'token') {
+                $queryParams[$key] = $value;
+            }
+        }
+
+        $audioFileURI->setQueryArray($queryParams);
+
+        return redirect()->to((string) $audioFileURI);
+    }
+}

app/Controllers/EpisodeCommentController.php

+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright  2020 Ad Aures
+ * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
+ * @link       https://castopod.org/
+ */
+
+namespace App\Controllers;
+
+use App\Entities\Episode;
+use App\Entities\EpisodeComment;
+use App\Entities\Podcast;
+use App\Libraries\CommentObject;
+use App\Models\EpisodeCommentModel;
+use App\Models\EpisodeModel;
+use App\Models\PodcastModel;
+use CodeIgniter\Exceptions\PageNotFoundException;
+use CodeIgniter\HTTP\RedirectResponse;
+use CodeIgniter\HTTP\ResponseInterface;
+use Modules\Analytics\AnalyticsTrait;
+use Modules\Fediverse\Entities\Actor;
+use Modules\Fediverse\Objects\OrderedCollectionObject;
+use Modules\Fediverse\Objects\OrderedCollectionPage;
+
+class EpisodeCommentController extends BaseController
+{
+    use AnalyticsTrait;
+
+    protected Podcast $podcast;
+
+    protected Actor $actor;
+
+    protected Episode $episode;
+
+    protected EpisodeComment $comment;
+
+    public function _remap(string $method, string ...$params): mixed
+    {
+        if (count($params) < 3) {
+            throw PageNotFoundException::forPageNotFound();
+        }
+
+        if (
+            ! ($podcast = (new PodcastModel())->getPodcastByHandle($params[0])) instanceof Podcast
+        ) {
+            throw PageNotFoundException::forPageNotFound();
+        }
+
+        $this->podcast = $podcast;
+        $this->actor = $podcast->actor;
+
+        if (
+            ! ($episode = (new EpisodeModel())->getEpisodeBySlug($params[0], $params[1])) instanceof Episode
+        ) {
+            throw PageNotFoundException::forPageNotFound();
+        }
+
+        $this->episode = $episode;
+
+        if (
+            ! ($comment = (new EpisodeCommentModel())->getCommentById($params[2])) instanceof EpisodeComment
+        ) {
+            throw PageNotFoundException::forPageNotFound();
+        }
+
+        $this->comment = $comment;
+
+        unset($params[2]);
+        unset($params[1]);
+        unset($params[0]);
+
+        return $this->{$method}(...$params);
+    }
+
+    public function view(): string
+    {
+        $this->registerPodcastWebpageHit($this->podcast->id);
+
+        $cacheName = implode(
+            '_',
+            array_filter([
+                'page',
+                "episode#{$this->episode->id}",
+                "comment#{$this->comment->id}",
+                service('request')
+                    ->getLocale(),
+                auth()
+                    ->loggedIn() ? 'authenticated' : null,
+            ]),
+        );
+
+        if (! ($cachedView = cache($cacheName))) {
+            set_episode_comment_metatags($this->comment);
+            $data = [
+                'podcast' => $this->podcast,
+                'actor'   => $this->actor,
+                'episode' => $this->episode,
+                'comment' => $this->comment,
+            ];
+
+            // if user is logged in then send to the authenticated activity view
+            if (auth()->loggedIn()) {
+                helper('form');
+                return view('episode/comment', $data);
+            }
+
+            return view('episode/comment', $data, [
+                'cache'      => DECADE,
+                'cache_name' => $cacheName,
+            ]);
+        }
+
+        return $cachedView;
+    }
+
+    public function commentObject(): ResponseInterface
+    {
+        $commentObject = new CommentObject($this->comment);
+
+        return $this->response
+            ->setContentType('application/json')
+            ->setBody($commentObject->toJSON());
+    }
+
+    public function replies(): ResponseInterface
+    {
+        /**
+         * get comment replies
+         */
+        $commentReplies = model(EpisodeCommentModel::class, false)
+            ->where('in_reply_to_id', service('uuid')->fromString($this->comment->id)->getBytes())
+            ->orderBy('created_at', 'ASC');
+
+        $pageNumber = (int) $this->request->getGet('page');
+
+        if ($pageNumber < 1) {
+            $commentReplies->paginate(12);
+            $pager = $commentReplies->pager;
+            $collection = new OrderedCollectionObject(null, $pager);
+        } else {
+            $paginatedReplies = $commentReplies->paginate(12, 'default', $pageNumber);
+            $pager = $commentReplies->pager;
+
+            $orderedItems = [];
+            if ($paginatedReplies !== null) {
+                foreach ($paginatedReplies as $reply) {
+                    $replyObject = new CommentObject($reply);
+                    $orderedItems[] = $replyObject;
+                }
+            }
+
+            $collection = new OrderedCollectionPage($pager, $orderedItems);
+        }
+
+        return $this->response
+            ->setContentType('application/activity+json')
+            ->setBody($collection->toJSON());
+    }
+
+    public function likeAction(): RedirectResponse
+    {
+        if (! ($interactAsActor = interact_as_actor()) instanceof Actor) {
+            return redirect()->back();
+        }
+
+        model('LikeModel')
+            ->toggleLike($interactAsActor, $this->comment);
+
+        return redirect()->back();
+    }
+
+    public function replyAction(): RedirectResponse
+    {
+        if (! ($interactAsActor = interact_as_actor()) instanceof Actor) {
+            return redirect()->back();
+        }
+
+        model('LikeModel')
+            ->toggleLike($interactAsActor, $this->comment);
+
+        return redirect()->back();
+    }
+}

app/Controllers/EpisodeController.php

@@ -3,21 +3,27 @@
 declare(strict_types=1);
 
 /**
- * @copyright  2020 Podlibre
+ * @copyright  2020 Ad Aures
  * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
  * @link       https://castopod.org/
  */
 
 namespace App\Controllers;
 
-use Analytics\AnalyticsTrait;
 use App\Entities\Episode;
 use App\Entities\Podcast;
+use App\Libraries\NoteObject;
+use App\Libraries\PodcastEpisode;
 use App\Models\EpisodeModel;
 use App\Models\PodcastModel;
+use CodeIgniter\Database\BaseBuilder;
 use CodeIgniter\Exceptions\PageNotFoundException;
 use CodeIgniter\HTTP\ResponseInterface;
-use Config\Services;
+use Config\Embed;
+use Modules\Analytics\AnalyticsTrait;
+use Modules\Fediverse\Objects\OrderedCollectionObject;
+use Modules\Fediverse\Objects\OrderedCollectionPage;
+use Modules\Media\FileManagers\FileManagerInterface;
 use SimpleXMLElement;
 
 class EpisodeController extends BaseController
@@ -35,7 +41,7 @@ class EpisodeController extends BaseController
         }
 
         if (
-            ($podcast = (new PodcastModel())->getPodcastByName($params[0])) === null
+            ! ($podcast = (new PodcastModel())->getPodcastByHandle($params[0])) instanceof Podcast
         ) {
             throw PageNotFoundException::forPageNotFound();
         }
@@ -43,7 +49,7 @@ class EpisodeController extends BaseController
         $this->podcast = $podcast;
 
         if (
-            ($episode = (new EpisodeModel())->getEpisodeBySlug($params[0], $params[1])) === null
+            ! ($episode = (new EpisodeModel())->getEpisodeBySlug($params[0], $params[1])) instanceof Episode
         ) {
             throw PageNotFoundException::forPageNotFound();
         }
@@ -58,18 +64,70 @@ class EpisodeController extends BaseController
 
     public function index(): string
     {
-        // Prevent analytics hit when authenticated
-        if (! can_user_interact()) {
-            $this->registerPodcastWebpageHit($this->episode->podcast_id);
+        $this->registerPodcastWebpageHit($this->episode->podcast_id);
+
+        $cacheName = implode(
+            '_',
+            array_filter([
+                'page',
+                "podcast#{$this->podcast->id}",
+                "episode#{$this->episode->id}",
+                service('request')
+                    ->getLocale(),
+                is_unlocked($this->podcast->handle) ? 'unlocked' : null,
+                auth()
+                    ->loggedIn() ? 'authenticated' : null,
+            ]),
+        );
+
+        if (! ($cachedView = cache($cacheName))) {
+            set_episode_metatags($this->episode);
+            $data = [
+                'podcast' => $this->podcast,
+                'episode' => $this->episode,
+            ];
+
+            $secondsToNextUnpublishedEpisode = (new EpisodeModel())->getSecondsToNextUnpublishedEpisode(
+                $this->podcast->id,
+            );
+
+            if (auth()->loggedIn()) {
+                helper('form');
+
+                return view('episode/comments', $data);
+            }
+
+            // The page cache is set to a decade so it is deleted manually upon podcast update
+            return view('episode/comments', $data, [
+                'cache'      => $secondsToNextUnpublishedEpisode ?: DECADE,
+                'cache_name' => $cacheName,
+            ]);
         }
 
-        $locale = service('request')
-            ->getLocale();
-        $cacheName =
-            "page_podcast#{$this->podcast->id}_episode#{$this->episode->id}_{$locale}" .
-            (can_user_interact() ? '_authenticated' : '');
+        return $cachedView;
+    }
+
+    public function activity(): string
+    {
+        $this->registerPodcastWebpageHit($this->episode->podcast_id);
+
+        $cacheName = implode(
+            '_',
+            array_filter([
+                'page',
+                "podcast#{$this->podcast->id}",
+                "episode#{$this->episode->id}",
+                'activity',
+                service('request')
+                    ->getLocale(),
+                is_unlocked($this->podcast->handle) ? 'unlocked' : null,
+                auth()
+                    ->loggedIn() ? 'authenticated' : null,
+            ]),
+        );
 
         if (! ($cachedView = cache($cacheName))) {
+            set_episode_metatags($this->episode);
             $data = [
                 'podcast' => $this->podcast,
                 'episode' => $this->episode,
@@ -79,15 +137,15 @@ class EpisodeController extends BaseController
                 $this->podcast->id,
             );
 
-            if (can_user_interact()) {
+            if (auth()->loggedIn()) {
                 helper('form');
-                return view('podcast/episode_authenticated', $data);
+
+                return view('episode/activity', $data);
             }
+
             // The page cache is set to a decade so it is deleted manually upon podcast update
-            return view('podcast/episode', $data, [
-                'cache' => $secondsToNextUnpublishedEpisode
-                    ? $secondsToNextUnpublishedEpisode
-                    : DECADE,
+            return view('episode/activity', $data, [
+                'cache'      => $secondsToNextUnpublishedEpisode ?: DECADE,
                 'cache_name' => $cacheName,
             ]);
         }
@@ -95,33 +153,157 @@ class EpisodeController extends BaseController
         return $cachedView;
     }
 
-    public function embeddablePlayer(string $theme = 'light-transparent'): string
+    public function chapters(): string
     {
-        header('Content-Security-Policy: frame-ancestors https://* http://*');
+        $this->registerPodcastWebpageHit($this->episode->podcast_id);
+
+        $cacheName = implode(
+            '_',
+            array_filter([
+                'page',
+                "podcast#{$this->podcast->id}",
+                "episode#{$this->episode->id}",
+                'chapters',
+                service('request')
+                    ->getLocale(),
+                is_unlocked($this->podcast->handle) ? 'unlocked' : null,
+                auth()
+                    ->loggedIn() ? 'authenticated' : null,
+            ]),
+        );
 
-        // Prevent analytics hit when authenticated
-        if (! can_user_interact()) {
-            $this->registerPodcastWebpageHit($this->episode->podcast_id);
-        }
+        if (! ($cachedView = cache($cacheName))) {
+            set_episode_metatags($this->episode);
+            $data = [
+                'podcast' => $this->podcast,
+                'episode' => $this->episode,
+            ];
+
+            // get chapters from json file
+            if (isset($this->episode->chapters->file_key)) {
+                /** @var FileManagerInterface $fileManager */
+                $fileManager = service('file_manager');
+                $episodeChaptersJsonString = (string) $fileManager->getFileContents($this->episode->chapters->file_key);
+
+                $chapters = json_decode($episodeChaptersJsonString, true);
+                $data['chapters'] = $chapters;
+            }
+
+            $secondsToNextUnpublishedEpisode = (new EpisodeModel())->getSecondsToNextUnpublishedEpisode(
+                $this->podcast->id,
+            );
+
+            if (auth()->loggedIn()) {
+                helper('form');
+
+                return view('episode/chapters', $data);
+            }
 
-        $session = Services::session();
-        $session->start();
-        if (isset($_SERVER['HTTP_REFERER'])) {
-            $session->set('embeddable_player_domain', parse_url($_SERVER['HTTP_REFERER'], PHP_URL_HOST));
+            // The page cache is set to a decade so it is deleted manually upon podcast update
+            return view('episode/chapters', $data, [
+                'cache'      => $secondsToNextUnpublishedEpisode ?: DECADE,
+                'cache_name' => $cacheName,
+            ]);
         }
 
-        $locale = service('request')
-            ->getLocale();
+        return $cachedView;
+    }
 
-        $cacheName = "page_podcast#{$this->podcast->id}_episode#{$this->episode->id}_embeddable_player_{$theme}_{$locale}";
+    public function transcript(): string
+    {
+        $this->registerPodcastWebpageHit($this->episode->podcast_id);
+
+        $cacheName = implode(
+            '_',
+            array_filter([
+                'page',
+                "podcast#{$this->podcast->id}",
+                "episode#{$this->episode->id}",
+                'transcript',
+                service('request')
+                    ->getLocale(),
+                is_unlocked($this->podcast->handle) ? 'unlocked' : null,
+                auth()
+                    ->loggedIn() ? 'authenticated' : null,
+            ]),
+        );
 
         if (! ($cachedView = cache($cacheName))) {
-            $theme = EpisodeModel::$themes[$theme];
-
+            set_episode_metatags($this->episode);
             $data = [
                 'podcast' => $this->podcast,
                 'episode' => $this->episode,
-                'theme' => $theme,
+            ];
+
+            // get transcript from json file
+            if ($this->episode->transcript !== null) {
+                $data['transcript'] = $this->episode->transcript;
+
+                if ($this->episode->transcript->json_key !== null) {
+                    /** @var FileManagerInterface $fileManager */
+                    $fileManager = service('file_manager');
+                    $transcriptJsonString = (string) $fileManager->getFileContents(
+                        $this->episode->transcript->json_key,
+                    );
+
+                    $data['captions'] = json_decode($transcriptJsonString, true);
+                }
+            }
+
+            $secondsToNextUnpublishedEpisode = (new EpisodeModel())->getSecondsToNextUnpublishedEpisode(
+                $this->podcast->id,
+            );
+
+            if (auth()->loggedIn()) {
+                helper('form');
+
+                return view('episode/transcript', $data);
+            }
+
+            // The page cache is set to a decade so it is deleted manually upon podcast update
+            return view('episode/transcript', $data, [
+                'cache'      => $secondsToNextUnpublishedEpisode ?: DECADE,
+                'cache_name' => $cacheName,
+            ]);
+        }
+
+        return $cachedView;
+    }
+
+    public function embed(string $theme = 'light-transparent'): string
+    {
+        header('Content-Security-Policy: frame-ancestors http://*:* https://*:*');
+
+        $this->registerPodcastWebpageHit($this->episode->podcast_id);
+
+        $session = service('session');
+
+        if (service('superglobals')->server('HTTP_REFERER') !== null) {
+            $session->set('embed_domain', parse_url(service('superglobals')->server('HTTP_REFERER'), PHP_URL_HOST));
+        }
+
+        $cacheName = implode(
+            '_',
+            array_filter([
+                'page',
+                "podcast#{$this->podcast->id}",
+                "episode#{$this->episode->id}",
+                'embed',
+                $theme,
+                service('request')
+                    ->getLocale(),
+                is_unlocked($this->podcast->handle) ? 'unlocked' : null,
+            ]),
+        );
+
+        if (! ($cachedView = cache($cacheName))) {
+            $themeData = EpisodeModel::$themes[$theme];
+
+            $data = [
+                'podcast'   => $this->podcast,
+                'episode'   => $this->episode,
+                'theme'     => $theme,
+                'themeData' => $themeData,
             ];
 
             $secondsToNextUnpublishedEpisode = (new EpisodeModel())->getSecondsToNextUnpublishedEpisode(
@@ -129,10 +311,8 @@ class EpisodeController extends BaseController
             );
 
             // The page cache is set to a decade so it is deleted manually upon podcast update
-            return view('embeddable_player', $data, [
-                'cache' => $secondsToNextUnpublishedEpisode
-                    ? $secondsToNextUnpublishedEpisode
-                    : DECADE,
+            return view('embed', $data, [
+                'cache'      => $secondsToNextUnpublishedEpisode ?: DECADE,
                 'cache_name' => $cacheName,
             ]);
         }
@@ -143,24 +323,25 @@ class EpisodeController extends BaseController
     public function oembedJSON(): ResponseInterface
     {
         return $this->response->setJSON([
-            'type' => 'rich',
-            'version' => '1.0',
-            'title' => $this->episode->title,
+            'type'          => 'rich',
+            'version'       => '1.0',
+            'title'         => $this->episode->title,
             'provider_name' => $this->podcast->title,
-            'provider_url' => $this->podcast->link,
-            'author_name' => $this->podcast->title,
-            'author_url' => $this->podcast->link,
-            'html' =>
-                '<iframe src="' .
-                $this->episode->embeddable_player_url .
-                '" width="100%" height="200" frameborder="0" scrolling="no"></iframe>',
-            'width' => 600,
-            'height' => 200,
-            'thumbnail_url' => $this->episode->image->large_url,
+            'provider_url'  => $this->podcast->link,
+            'author_name'   => $this->podcast->title,
+            'author_url'    => $this->podcast->link,
+            'html'          => '<iframe src="' .
+                $this->episode->embed_url .
+                '" width="100%" height="' . config('Embed')->height . '" frameborder="0" scrolling="no"></iframe>',
+            'width' => config('Embed')
+                ->width,
+            'height' => config('Embed')
+                ->height,
+            'thumbnail_url'   => $this->episode->cover->og_url,
             'thumbnail_width' => config('Images')
-                ->largeSize,
+                ->podcastCoverSizes['og']['width'],
             'thumbnail_height' => config('Images')
-                ->largeSize,
+                ->podcastCoverSizes['og']['height'],
         ]);
     }
 
@@ -175,20 +356,71 @@ class EpisodeController extends BaseController
         $oembed->addChild('provider_url', $this->podcast->link);
         $oembed->addChild('author_name', $this->podcast->title);
         $oembed->addChild('author_url', $this->podcast->link);
-        $oembed->addChild('thumbnail', $this->episode->image->large_url);
-        $oembed->addChild('thumbnail_width', config('Images')->largeSize);
-        $oembed->addChild('thumbnail_height', config('Images')->largeSize);
+        $oembed->addChild('thumbnail', $this->episode->cover->og_url);
+        $oembed->addChild('thumbnail_width', (string) config('Images')->podcastCoverSizes['og']['width']);
+        $oembed->addChild('thumbnail_height', (string) config('Images')->podcastCoverSizes['og']['height']);
         $oembed->addChild(
             'html',
-            htmlentities(
+            htmlspecialchars(
                 '<iframe src="' .
-                    $this->episode->embeddable_player_url .
-                    '" width="100%" height="200" frameborder="0" scrolling="no"></iframe>',
+                    $this->episode->embed_url .
+                    '" width="100%" height="' . config(
+                        Embed::class,
+                    )->height . '" frameborder="0" scrolling="no"></iframe>',
             ),
         );
-        $oembed->addChild('width', '600');
-        $oembed->addChild('height', '200');
+        $oembed->addChild('width', (string) config('Embed')->width);
+        $oembed->addChild('height', (string) config('Embed')->height);
+
+        // @phpstan-ignore-next-line
+        return $this->response->setXML($oembed);
+    }
+
+    public function episodeObject(): ResponseInterface
+    {
+        $podcastObject = new PodcastEpisode($this->episode);
+
+        return $this->response
+            ->setContentType('application/json')
+            ->setBody($podcastObject->toJSON());
+    }
+
+    public function comments(): ResponseInterface
+    {
+        /**
+         * get comments: aggregated replies from posts referring to the episode
+         */
+        $episodeComments = model('PostModel')
+            ->whereIn('in_reply_to_id', fn (BaseBuilder $builder): BaseBuilder => $builder->select('id')
+                ->from('fediverse_posts')
+                ->where('episode_id', $this->episode->id))
+            ->where('`published_at` <= UTC_TIMESTAMP()', null, false)
+            ->orderBy('published_at', 'ASC');
+
+        $pageNumber = (int) $this->request->getGet('page');
+
+        if ($pageNumber < 1) {
+            $episodeComments->paginate(12);
+            $pager = $episodeComments->pager;
+            $collection = new OrderedCollectionObject(null, $pager);
+        } else {
+            $paginatedComments = $episodeComments->paginate(12, 'default', $pageNumber);
+            $pager = $episodeComments->pager;
+
+            $orderedItems = [];
+            if ($paginatedComments !== null) {
+                foreach ($paginatedComments as $comment) {
+                    $orderedItems[] = (new NoteObject($comment))->toArray();
+                }
+            }
+
+            // @phpstan-ignore-next-line
+            $collection = new OrderedCollectionPage($pager, $orderedItems);
+        }
 
-        return $this->response->setXML((string) $oembed);
+        return $this->response
+            ->setContentType('application/activity+json')
+            ->setHeader('Access-Control-Allow-Origin', '*')
+            ->setBody($collection->toJSON());
     }
 }

app/Controllers/EpisodePreviewController.php

+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright  2023 Ad Aures
+ * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
+ * @link       https://castopod.org/
+ */
+
+namespace App\Controllers;
+
+use App\Entities\Episode;
+use App\Models\EpisodeModel;
+use CodeIgniter\Exceptions\PageNotFoundException;
+use Modules\Media\FileManagers\FileManagerInterface;
+
+class EpisodePreviewController extends BaseController
+{
+    protected Episode $episode;
+
+    public function _remap(string $method, string ...$params): mixed
+    {
+        if (count($params) < 1) {
+            throw PageNotFoundException::forPageNotFound();
+        }
+
+        // find episode by previewUUID
+        $episode = (new EpisodeModel())->getEpisodeByPreviewId($params[0]);
+
+        if (! $episode instanceof Episode) {
+            throw PageNotFoundException::forPageNotFound();
+        }
+
+        $this->episode = $episode;
+
+        if ($episode->publication_status === 'published') {
+            // redirect to episode page
+            return redirect()->route('episode', [$episode->podcast->handle, $episode->slug]);
+        }
+
+        unset($params[0]);
+
+        return $this->{$method}(...$params);
+    }
+
+    public function index(): string
+    {
+        helper('form');
+
+        return view('episode/preview-comments', [
+            'podcast' => $this->episode->podcast,
+            'episode' => $this->episode,
+        ]);
+    }
+
+    public function activity(): string
+    {
+        helper('form');
+
+        return view('episode/preview-activity', [
+            'podcast' => $this->episode->podcast,
+            'episode' => $this->episode,
+        ]);
+    }
+
+    public function chapters(): string
+    {
+        $data = [
+            'podcast' => $this->episode->podcast,
+            'episode' => $this->episode,
+        ];
+
+        if (isset($this->episode->chapters->file_key)) {
+            /** @var FileManagerInterface $fileManager */
+            $fileManager = service('file_manager');
+            $episodeChaptersJsonString = (string) $fileManager->getFileContents($this->episode->chapters->file_key);
+
+            $chapters = json_decode($episodeChaptersJsonString, true);
+            $data['chapters'] = $chapters;
+        }
+
+        helper('form');
+        return view('episode/preview-chapters', $data);
+    }
+
+    public function transcript(): string
+    {
+        // get transcript from json file
+        $data = [
+            'podcast' => $this->episode->podcast,
+            'episode' => $this->episode,
+        ];
+
+        if ($this->episode->transcript !== null) {
+            $data['transcript'] = $this->episode->transcript;
+
+            if ($this->episode->transcript->json_key !== null) {
+                /** @var FileManagerInterface $fileManager */
+                $fileManager = service('file_manager');
+                $transcriptJsonString = (string) $fileManager->getFileContents(
+                    $this->episode->transcript->json_key,
+                );
+
+                $data['captions'] = json_decode($transcriptJsonString, true);
+            }
+        }
+
+        helper('form');
+        return view('episode/preview-transcript', $data);
+    }
+}