app/Controllers/Home.php

-<?php
-
-/**
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-namespace App\Controllers;
-
-use App\Models\PodcastModel;
-
-class Home extends BaseController
-{
-    public function index()
-    {
-        $model = new PodcastModel();
-
-        $allPodcasts = $model->findAll();
-
-        // check if there's only one podcast to redirect user to it
-        if (count($allPodcasts) == 1) {
-            return redirect()->route('podcast', [$allPodcasts[0]->name]);
-        }
-
-        // default behavior: list all podcasts on home page
-        $data = ['podcasts' => $allPodcasts];
-        return view('home', $data);
-    }
-}

app/Controllers/HomeController.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\Models\PodcastModel;
+use CodeIgniter\Database\Exceptions\DatabaseException;
+use CodeIgniter\HTTP\RedirectResponse;
+use CodeIgniter\HTTP\ResponseInterface;
+use Modules\Media\FileManagers\FileManagerInterface;
+
+class HomeController extends BaseController
+{
+    public function index(): RedirectResponse | string
+    {
+        $sortOptions = ['activity', 'created_desc', 'created_asc'];
+        $sortBy = in_array($this->request->getGet('sort'), $sortOptions, true) ? $this->request->getGet(
+            'sort',
+        ) : 'activity';
+
+        $allPodcasts = (new PodcastModel())->getAllPodcasts($sortBy);
+
+        // check if there's only one podcast to redirect user to it
+        if (count($allPodcasts) === 1) {
+            return redirect()->route('podcast-activity', [$allPodcasts[0]->handle]);
+        }
+
+        set_home_metatags();
+        // default behavior: list all podcasts on home page
+        $data = [
+            'podcasts' => $allPodcasts,
+            'sortBy'   => $sortBy,
+        ];
+
+        return view('home', $data);
+    }
+
+    public function health(): ResponseInterface
+    {
+        $errors = [];
+
+        try {
+            db_connect();
+        } catch (DatabaseException) {
+            $errors[] = 'Unable to connect to the database.';
+        }
+
+        // --- Can Castopod connect to the cache handler
+        if (config('Cache')->handler !== 'dummy' && cache()->getCacheInfo() === null) {
+            $errors[] = 'Unable connect to the cache handler.';
+        }
+
+        // --- Can Castopod write to storage?
+
+        /** @var FileManagerInterface $fileManager */
+        $fileManager = service('file_manager', false);
+
+        if (! $fileManager->isHealthy()) {
+            $errors[] = 'Problem with file manager.';
+        }
+
+        if ($errors !== []) {
+            return $this->response->setStatusCode(503)
+                ->setJSON([
+                    'code'   => 503,
+                    'errors' => $errors,
+                ]);
+        }
+
+        return $this->response->setStatusCode(200)
+            ->setJSON([
+                'code'    => 200,
+                'message' => '✨ All good!',
+            ]);
+    }
+}

app/Controllers/MapController.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\Models\EpisodeModel;
+use CodeIgniter\HTTP\ResponseInterface;
+
+class MapController extends BaseController
+{
+    public function index(): string
+    {
+        $cacheName = implode(
+            '_',
+            array_filter([
+                'page',
+                'map',
+                service('request')
+                    ->getLocale(),
+                auth()
+                    ->loggedIn() ? 'authenticated' : null,
+            ]),
+        );
+
+        if (! ($found = cache($cacheName))) {
+            return view('pages/map', [], [
+                'cache'      => DECADE,
+                'cache_name' => $cacheName,
+            ]);
+        }
+
+        return $found;
+    }
+
+    public function getEpisodesMarkers(): ResponseInterface
+    {
+        $cacheName = 'episodes_markers';
+        if (! ($found = cache($cacheName))) {
+            $episodes = (new EpisodeModel())
+                ->where('`published_at` <= UTC_TIMESTAMP()', null, false)
+                ->where('location_geo is not', null)
+                ->findAll();
+            $found = [];
+            foreach ($episodes as $episode) {
+                $found[] = [
+                    'latitude'      => $episode->location->latitude,
+                    'longitude'     => $episode->location->longitude,
+                    'location_name' => esc($episode->location->name),
+                    'location_url'  => $episode->location->url,
+                    'episode_link'  => $episode->link,
+                    'podcast_link'  => $episode->podcast->link,
+                    'cover_url'     => $episode->cover->thumbnail_url,
+                    'podcast_title' => esc($episode->podcast->title),
+                    'episode_title' => esc($episode->title),
+                ];
+            }
+
+            // The page cache is set to a decade so it is deleted manually upon episode update
+            cache()
+                ->save($cacheName, $found, DECADE);
+        }
+
+        return $this->response->setJSON($found);
+    }
+}

app/Controllers/PageController.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\Page;
+use App\Models\PageModel;
+use CodeIgniter\Exceptions\PageNotFoundException;
+
+class PageController extends BaseController
+{
+    protected Page $page;
+
+    public function _remap(string $method, string ...$params): mixed
+    {
+        if ($params === []) {
+            throw PageNotFoundException::forPageNotFound();
+        }
+
+        $page = (new PageModel())->where('slug', $params[0])->first();
+        if (! $page instanceof Page) {
+            throw PageNotFoundException::forPageNotFound();
+        }
+
+        $this->page = $page;
+
+        return $this->{$method}();
+    }
+
+    public function index(): string
+    {
+        $cacheName = implode(
+            '_',
+            array_filter([
+                'page',
+                $this->page->slug,
+                service('request')
+                    ->getLocale(),
+                auth()
+                    ->loggedIn() ? 'authenticated' : null,
+            ]),
+        );
+
+        if (! ($found = cache($cacheName))) {
+            set_page_metatags($this->page);
+            $data = [
+                'page' => $this->page,
+            ];
+
+            $found = view('pages/page', $data);
+
+            // The page cache is set to a decade so it is deleted manually upon page update
+            cache()
+                ->save($cacheName, $found, DECADE);
+        }
+
+        return $found;
+    }
+}

app/Controllers/Platform.php

-<?php
-
-/**
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-namespace App\Controllers;
-
-use CodeIgniter\Controller;
-
-/*
- * Provide public access to all platforms so that they can be exported
- */
-class Platform extends Controller
-{
-    public function index()
-    {
-        $model = new \App\Models\PlatformModel();
-
-        return $this->response->setJSON($model->getPlatforms());
-    }
-}

app/Controllers/Podcast.php

-<?php
-
-/**
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-namespace App\Controllers;
-
-use App\Models\EpisodeModel;
-use App\Models\PodcastModel;
-
-class Podcast extends BaseController
-{
-    /**
-     * @var \App\Entities\Podcast|null
-     */
-    protected $podcast;
-
-    public function _remap($method, ...$params)
-    {
-        if (count($params) > 0) {
-            if (
-                !($this->podcast = (new PodcastModel())->getPodcastByName(
-                    $params[0]
-                ))
-            ) {
-                throw \CodeIgniter\Exceptions\PageNotFoundException::forPageNotFound();
-            }
-        }
-
-        return $this->$method();
-    }
-
-    public function index()
-    {
-        self::triggerWebpageHit($this->podcast->id);
-
-        $yearQuery = $this->request->getGet('year');
-        $seasonQuery = $this->request->getGet('season');
-
-        if (!$yearQuery and !$seasonQuery) {
-            $defaultQuery = (new EpisodeModel())->getDefaultQuery(
-                $this->podcast->id
-            );
-            if ($defaultQuery['type'] == 'season') {
-                $seasonQuery = $defaultQuery['data']['season_number'];
-            } elseif ($defaultQuery['type'] == 'year') {
-                $yearQuery = $defaultQuery['data']['year'];
-            }
-        }
-
-        $cacheName = implode(
-            '_',
-            array_filter([
-                'page',
-                "podcast{$this->podcast->id}",
-                $yearQuery,
-                $seasonQuery ? 'season' . $seasonQuery : null,
-                service('request')->getLocale(),
-            ])
-        );
-
-        if (!($found = cache($cacheName))) {
-            // Build navigation array
-            $episodeModel = new EpisodeModel();
-            $years = $episodeModel->getYears($this->podcast->id);
-            $seasons = $episodeModel->getSeasons($this->podcast->id);
-
-            $episodesNavigation = [];
-            $activeQuery = null;
-            foreach ($years as $year) {
-                $isActive = $yearQuery == $year['year'];
-                if ($isActive) {
-                    $activeQuery = ['type' => 'year', 'value' => $year['year']];
-                }
-
-                array_push($episodesNavigation, [
-                    'label' => $year['year'],
-                    'number_of_episodes' => $year['number_of_episodes'],
-                    'route' =>
-                        route_to('podcast', $this->podcast->name) .
-                        '?year=' .
-                        $year['year'],
-                    'is_active' => $isActive,
-                ]);
-            }
-
-            foreach ($seasons as $season) {
-                $isActive = $seasonQuery == $season['season_number'];
-                if ($isActive) {
-                    $activeQuery = [
-                        'type' => 'season',
-                        'value' => $season['season_number'],
-                    ];
-                }
-
-                array_push($episodesNavigation, [
-                    'label' => lang('Podcast.season', [
-                        'seasonNumber' => $season['season_number'],
-                    ]),
-                    'number_of_episodes' => $season['number_of_episodes'],
-                    'route' =>
-                        route_to('podcast', $this->podcast->name) .
-                        '?season=' .
-                        $season['season_number'],
-                    'is_active' => $isActive,
-                ]);
-            }
-
-            helper(['persons']);
-            $persons = [];
-            constructs_podcast_person_array(
-                $this->podcast->podcast_persons,
-                $persons
-            );
-
-            $data = [
-                'podcast' => $this->podcast,
-                'episodesNav' => $episodesNavigation,
-                'activeQuery' => $activeQuery,
-                'episodes' => $episodeModel->getPodcastEpisodes(
-                    $this->podcast->id,
-                    $this->podcast->type,
-                    $yearQuery,
-                    $seasonQuery
-                ),
-                'personArray' => $persons,
-            ];
-
-            $secondsToNextUnpublishedEpisode = $episodeModel->getSecondsToNextUnpublishedEpisode(
-                $this->podcast->id
-            );
-
-            return view('podcast', $data, [
-                'cache' => $secondsToNextUnpublishedEpisode
-                    ? $secondsToNextUnpublishedEpisode
-                    : DECADE,
-                'cache_name' => $cacheName,
-            ]);
-        }
-
-        return $found;
-    }
-}

app/Controllers/PodcastController.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\Podcast;
+use App\Libraries\PodcastActor;
+use App\Libraries\PodcastEpisode;
+use App\Models\EpisodeModel;
+use App\Models\PodcastModel;
+use App\Models\PostModel;
+use CodeIgniter\Exceptions\PageNotFoundException;
+use CodeIgniter\HTTP\ResponseInterface;
+use Modules\Analytics\AnalyticsTrait;
+use Modules\Fediverse\Objects\OrderedCollectionObject;
+use Modules\Fediverse\Objects\OrderedCollectionPage;
+
+class PodcastController extends BaseController
+{
+    use AnalyticsTrait;
+
+    protected Podcast $podcast;
+
+    public function _remap(string $method, string ...$params): mixed
+    {
+        if ($params === []) {
+            throw PageNotFoundException::forPageNotFound();
+        }
+
+        if (
+            ! ($podcast = (new PodcastModel())->getPodcastByHandle($params[0])) instanceof Podcast
+        ) {
+            throw PageNotFoundException::forPageNotFound();
+        }
+
+        $this->podcast = $podcast;
+
+        unset($params[0]);
+
+        return $this->{$method}(...$params);
+    }
+
+    public function podcastActor(): ResponseInterface
+    {
+        $podcastActor = new PodcastActor($this->podcast);
+
+        return $this->response
+            ->setContentType('application/activity+json')
+            ->setBody($podcastActor->toJSON());
+    }
+
+    public function activity(): string
+    {
+        $this->registerPodcastWebpageHit($this->podcast->id);
+
+        $cacheName = implode(
+            '_',
+            array_filter([
+                'page',
+                "podcast#{$this->podcast->id}",
+                'activity',
+                service('request')
+                    ->getLocale(),
+                is_unlocked($this->podcast->handle) ? 'unlocked' : null,
+                auth()
+                    ->loggedIn() ? 'authenticated' : null,
+            ]),
+        );
+
+        if (! ($cachedView = cache($cacheName))) {
+            set_podcast_metatags($this->podcast, 'activity');
+            $data = [
+                'podcast' => $this->podcast,
+                'posts'   => (new PostModel())->getActorPublishedPosts($this->podcast->actor_id),
+            ];
+
+            // if user is logged in then send to the authenticated activity view
+            if (auth()->loggedIn()) {
+                helper('form');
+
+                return view('podcast/activity', $data);
+            }
+
+            $secondsToNextUnpublishedEpisode = (new EpisodeModel())->getSecondsToNextUnpublishedEpisode(
+                $this->podcast->id,
+            );
+
+            return view('podcast/activity', $data, [
+                'cache'      => $secondsToNextUnpublishedEpisode ?: DECADE,
+                'cache_name' => $cacheName,
+            ]);
+        }
+
+        return $cachedView;
+    }
+
+    public function about(): string
+    {
+        $this->registerPodcastWebpageHit($this->podcast->id);
+
+        $cacheName = implode(
+            '_',
+            array_filter([
+                'page',
+                "podcast#{$this->podcast->id}",
+                'about',
+                service('request')
+                    ->getLocale(),
+                is_unlocked($this->podcast->handle) ? 'unlocked' : null,
+                auth()
+                    ->loggedIn() ? 'authenticated' : null,
+            ]),
+        );
+
+        if (! ($cachedView = cache($cacheName))) {
+            $stats = (new EpisodeModel())->getPodcastStats($this->podcast->id);
+
+            set_podcast_metatags($this->podcast, 'about');
+            $data = [
+                'podcast' => $this->podcast,
+                'stats'   => $stats,
+            ];
+
+            // // if user is logged in then send to the authenticated activity view
+            if (auth()->loggedIn()) {
+                helper('form');
+
+                return view('podcast/about', $data);
+            }
+
+            $secondsToNextUnpublishedEpisode = (new EpisodeModel())->getSecondsToNextUnpublishedEpisode(
+                $this->podcast->id,
+            );
+
+            return view('podcast/about', $data, [
+                'cache'      => $secondsToNextUnpublishedEpisode ?: DECADE,
+                'cache_name' => $cacheName,
+            ]);
+        }
+
+        return $cachedView;
+    }
+
+    public function episodes(): string
+    {
+        $this->registerPodcastWebpageHit($this->podcast->id);
+
+        $yearQuery = $this->request->getGet('year');
+        $seasonQuery = $this->request->getGet('season');
+
+        if (! $yearQuery && ! $seasonQuery) {
+            $defaultQuery = (new PodcastModel())->getDefaultQuery($this->podcast->id);
+            if ($defaultQuery) {
+                if ($defaultQuery['type'] === 'season') {
+                    $seasonQuery = $defaultQuery['data']['season_number'];
+                } elseif ($defaultQuery['type'] === 'year') {
+                    $yearQuery = $defaultQuery['data']['year'];
+                }
+            }
+        }
+
+        $cacheName = implode(
+            '_',
+            array_filter([
+                'page',
+                "podcast#{$this->podcast->id}",
+                'episodes',
+                $yearQuery ? 'year' . $yearQuery : null,
+                $seasonQuery ? 'season' . $seasonQuery : null,
+                service('request')
+                    ->getLocale(),
+                is_unlocked($this->podcast->handle) ? 'unlocked' : null,
+                auth()
+                    ->loggedIn() ? 'authenticated' : null,
+            ]),
+        );
+
+        if (! ($cachedView = cache($cacheName))) {
+            // Build navigation array
+            $podcastModel = new PodcastModel();
+            $years = $podcastModel->getYears($this->podcast->id);
+            $seasons = $podcastModel->getSeasons($this->podcast->id);
+
+            $episodesNavigation = [];
+            $activeQuery = null;
+            foreach ($years as $year) {
+                $isActive = $yearQuery === $year['year'];
+                if ($isActive) {
+                    $activeQuery = [
+                        'type'               => 'year',
+                        'value'              => $year['year'],
+                        'label'              => $year['year'],
+                        'number_of_episodes' => $year['number_of_episodes'],
+                    ];
+                }
+
+                $episodesNavigation[] = [
+                    'label'              => $year['year'],
+                    'number_of_episodes' => $year['number_of_episodes'],
+                    'route'              => route_to('podcast-episodes', $this->podcast->handle) .
+                        '?year=' .
+                        $year['year'],
+                    'is_active' => $isActive,
+                ];
+            }
+
+            foreach ($seasons as $season) {
+                $isActive = $seasonQuery === $season['season_number'];
+                if ($isActive) {
+                    $activeQuery = [
+                        'type'  => 'season',
+                        'value' => $season['season_number'],
+                        'label' => lang('Podcast.season', [
+                            'seasonNumber' => $season['season_number'],
+                        ]),
+                        'number_of_episodes' => $season['number_of_episodes'],
+                    ];
+                }
+
+                $episodesNavigation[] = [
+                    'label' => lang('Podcast.season', [
+                        'seasonNumber' => $season['season_number'],
+                    ]),
+                    'number_of_episodes' => $season['number_of_episodes'],
+                    'route'              => route_to('podcast-episodes', $this->podcast->handle) .
+                        '?season=' .
+                        $season['season_number'],
+                    'is_active' => $isActive,
+                ];
+            }
+
+            set_podcast_metatags($this->podcast, 'episodes');
+            $data = [
+                'podcast'     => $this->podcast,
+                'episodesNav' => $episodesNavigation,
+                'activeQuery' => $activeQuery,
+                'episodes'    => (new EpisodeModel())->getPodcastEpisodes(
+                    $this->podcast->id,
+                    $this->podcast->type,
+                    $yearQuery,
+                    $seasonQuery,
+                ),
+            ];
+
+            if (auth()->loggedIn()) {
+                return view('podcast/episodes', $data);
+            }
+
+            $secondsToNextUnpublishedEpisode = (new EpisodeModel())->getSecondsToNextUnpublishedEpisode(
+                $this->podcast->id,
+            );
+            return view('podcast/episodes', $data, [
+                'cache'      => $secondsToNextUnpublishedEpisode ?: DECADE,
+                'cache_name' => $cacheName,
+            ]);
+        }
+
+        return $cachedView;
+    }
+
+    public function episodeCollection(): ResponseInterface
+    {
+        if ($this->podcast->type === 'serial') {
+            // podcast is serial
+            $episodes = model('EpisodeModel')
+                ->where('`published_at` <= UTC_TIMESTAMP()', null, false)
+                ->orderBy('season_number DESC, number ASC');
+        } else {
+            $episodes = model('EpisodeModel')
+                ->where('`published_at` <= UTC_TIMESTAMP()', null, false)
+                ->orderBy('published_at', 'DESC');
+        }
+
+        $pageNumber = (int) $this->request->getGet('page');
+
+        if ($pageNumber < 1) {
+            $episodes->paginate(12);
+            $pager = $episodes->pager;
+            $collection = new OrderedCollectionObject(null, $pager);
+        } else {
+            $paginatedEpisodes = $episodes->paginate(12, 'default', $pageNumber);
+            $pager = $episodes->pager;
+
+            $orderedItems = [];
+            if ($paginatedEpisodes !== null) {
+                foreach ($paginatedEpisodes as $episode) {
+                    $orderedItems[] = (new PodcastEpisode($episode))->toArray();
+                }
+            }
+
+            // @phpstan-ignore-next-line
+            $collection = new OrderedCollectionPage($pager, $orderedItems);
+        }
+
+        return $this->response
+            ->setContentType('application/activity+json')
+            ->setBody($collection->toJSON());
+    }
+
+    public function links(): string
+    {
+        set_podcast_metatags($this->podcast, 'links');
+        return view('podcast/links', [
+            'podcast' => $this->podcast,
+        ]);
+    }
+}

app/Controllers/PostController.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\Actor;
+use App\Entities\Podcast;
+use App\Entities\Post as CastopodPost;
+use App\Models\EpisodeModel;
+use App\Models\PodcastModel;
+use App\Models\PostModel;
+use CodeIgniter\Exceptions\PageNotFoundException;
+use CodeIgniter\HTTP\RedirectResponse;
+use CodeIgniter\HTTP\URI;
+use CodeIgniter\I18n\Time;
+use Modules\Analytics\AnalyticsTrait;
+use Modules\Fediverse\Controllers\PostController as FediversePostController;
+use Override;
+
+class PostController extends FediversePostController
+{
+    use AnalyticsTrait;
+
+    protected Podcast $podcast;
+
+    protected Actor $actor;
+
+    /**
+     * @var CastopodPost
+     */
+    protected $post;
+
+    /**
+     * @var list<string>
+     */
+    protected $helpers = ['auth', 'fediverse', 'svg', 'components', 'misc', 'seo', 'premium_podcasts'];
+
+    #[Override]
+    public function _remap(string $method, string ...$params): mixed
+    {
+
+        if (
+            ! ($podcast = (new PodcastModel())->getPodcastByHandle($params[0])) instanceof Podcast
+        ) {
+            throw PageNotFoundException::forPageNotFound();
+        }
+
+        $this->podcast = $podcast;
+        $this->actor = $this->podcast->actor;
+
+        if (count($params) <= 1) {
+            unset($params[0]);
+
+            return $this->{$method}(...$params);
+        }
+
+        if (
+            ! ($post = (new PostModel())->getPostById($params[1])) instanceof CastopodPost
+        ) {
+            throw PageNotFoundException::forPageNotFound();
+        }
+
+        $this->post = $post;
+
+        unset($params[0]);
+        unset($params[1]);
+
+        return $this->{$method}(...$params);
+    }
+
+    public function view(): string
+    {
+        $this->registerPodcastWebpageHit($this->podcast->id);
+
+        $cacheName = implode(
+            '_',
+            array_filter([
+                'page',
+                "post#{$this->post->id}",
+                service('request')
+                    ->getLocale(),
+                auth()
+                    ->loggedIn() ? 'authenticated' : null,
+            ]),
+        );
+
+        if (! ($cachedView = cache($cacheName))) {
+            set_post_metatags($this->post);
+            $data = [
+                'post'    => $this->post,
+                'podcast' => $this->podcast,
+            ];
+
+            // if user is logged in then send to the authenticated activity view
+            if (auth()->loggedIn()) {
+                helper('form');
+                return view('post/post', $data);
+            }
+
+            return view('post/post', $data, [
+                'cache'      => DECADE,
+                'cache_name' => $cacheName,
+            ]);
+        }
+
+        return $cachedView;
+    }
+
+    #[Override]
+    public function createAction(): RedirectResponse
+    {
+        $rules = [
+            'message'     => 'required|max_length[500]',
+            'episode_url' => 'valid_url_strict|permit_empty',
+        ];
+
+        if (! $this->validate($rules)) {
+            return redirect()
+                ->back()
+                ->withInput()
+                ->with('errors', $this->validator->getErrors());
+        }
+
+        $validData = $this->validator->getValidated();
+
+        $message = $validData['message'];
+
+        $newPost = new CastopodPost([
+            'actor_id'     => interact_as_actor_id(),
+            'published_at' => Time::now(),
+            'created_by'   => user_id(),
+        ]);
+
+        // get episode if episodeUrl has been set
+        $episodeUri = $validData['episode_url'];
+        if (
+            $episodeUri &&
+            ($params = extract_params_from_episode_uri(new URI($episodeUri))) &&
+            ($episode = (new EpisodeModel())->getEpisodeBySlug($params['podcastHandle'], $params['episodeSlug']))
+        ) {
+            $newPost->episode_id = $episode->id;
+        }
+
+        $newPost->message = $message;
+
+        $postModel = new PostModel();
+        if (
+            ! $postModel
+                ->addPost($newPost, ! (bool) $newPost->episode_id, true)
+        ) {
+            return redirect()
+                ->back()
+                ->withInput()
+                ->with('errors', $postModel->errors());
+        }
+
+        // Post has been successfully created
+        return redirect()->back();
+    }
+
+    #[Override]
+    public function replyAction(): RedirectResponse
+    {
+        $rules = [
+            'message' => 'required|max_length[500]',
+        ];
+
+        if (! $this->validate($rules)) {
+            return redirect()
+                ->back()
+                ->withInput()
+                ->with('errors', $this->validator->getErrors());
+        }
+
+        $validData = $this->validator->getValidated();
+
+        $newPost = new CastopodPost([
+            'actor_id'       => interact_as_actor_id(),
+            'in_reply_to_id' => $this->post->id,
+            'message'        => $validData['message'],
+            'published_at'   => Time::now(),
+            'created_by'     => user_id(),
+        ]);
+
+        if ($this->post->episode_id !== null) {
+            $newPost->episode_id = $this->post->episode_id;
+        }
+
+        $postModel = new PostModel();
+        if (! $postModel->addReply($newPost)) {
+            return redirect()
+                ->back()
+                ->withInput()
+                ->with('errors', $postModel->errors());
+        }
+
+        // Reply post without preview card has been successfully created
+        return redirect()->back();
+    }
+
+    #[Override]
+    public function favouriteAction(): RedirectResponse
+    {
+        model('FavouriteModel')->toggleFavourite(interact_as_actor(), $this->post);
+
+        return redirect()->back();
+    }
+
+    #[Override]
+    public function reblogAction(): RedirectResponse
+    {
+        (new PostModel())->toggleReblog(interact_as_actor(), $this->post);
+
+        return redirect()->back();
+    }
+
+    public function action(): RedirectResponse
+    {
+        $rules = [
+            'action' => 'required|in_list[favourite,reblog,reply]',
+        ];
+
+        if (! $this->validate($rules)) {
+            return redirect()
+                ->back()
+                ->withInput()
+                ->with('errors', $this->validator->getErrors());
+        }
+
+        $validData = $this->validator->getValidated();
+
+        $action = $validData['action'];
+        return match ($action) {
+            'favourite' => $this->favouriteAction(),
+            'reblog'    => $this->reblogAction(),
+            'reply'     => $this->replyAction(),
+            default     => redirect()
+                ->back()
+                ->withInput()
+                ->with('errors', 'error'),
+        };
+    }
+
+    public function remoteActionView(string $action): string
+    {
+        $this->registerPodcastWebpageHit($this->podcast->id);
+
+        set_remote_actions_metatags($this->post, $action);
+        $data = [
+            'podcast' => $this->podcast,
+            'actor'   => $this->actor,
+            'post'    => $this->post,
+            'action'  => $action,
+        ];
+
+        helper('form');
+
+        // NO VIEW CACHING: form has a CSRF token which should change on each request
+        return view('post/remote_action', $data);
+    }
+}

app/Controllers/WebmanifestController.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\Podcast;
+use App\Models\PodcastModel;
+use CodeIgniter\Controller;
+use CodeIgniter\Exceptions\PageNotFoundException;
+use CodeIgniter\HTTP\ResponseInterface;
+
+class WebmanifestController extends Controller
+{
+    /**
+     * @var array<string, array<string, string>>
+     */
+    final public const array THEME_COLORS = [
+        'pine' => [
+            'theme'      => '#009486',
+            'background' => '#F0F9F8',
+        ],
+        'lake' => [
+            'theme'      => '#00ACE0',
+            'background' => '#F0F7F9',
+        ],
+        'jacaranda' => [
+            'theme'      => '#562CDD',
+            'background' => '#F2F0F9',
+        ],
+        'crimson' => [
+            'theme'      => '#F24562',
+            'background' => '#F9F0F2',
+        ],
+        'amber' => [
+            'theme'      => '#FF6224',
+            'background' => '#F9F3F0',
+        ],
+        'onyx' => [
+            'theme'      => '#040406',
+            'background' => '#F3F3F7',
+        ],
+    ];
+
+    public function index(): ResponseInterface
+    {
+        helper('misc');
+
+        $webmanifest = [
+            'name'        => esc(service('settings') ->get('App.siteName')),
+            'description' => esc(service('settings') ->get('App.siteDescription')),
+            'lang'        => service('request')
+                ->getLocale(),
+            'start_url'        => base_url(),
+            'display'          => 'standalone',
+            'orientation'      => 'portrait',
+            'theme_color'      => self::THEME_COLORS[service('settings')->get('App.theme')]['theme'],
+            'background_color' => self::THEME_COLORS[service('settings')->get('App.theme')]['background'],
+            'icons'            => [
+                [
+                    'src'   => get_site_icon_url('192'),
+                    'type'  => 'image/png',
+                    'sizes' => '192x192',
+                ],
+                [
+                    'src'   => get_site_icon_url('512'),
+                    'type'  => 'image/png',
+                    'sizes' => '512x512',
+                ],
+            ],
+        ];
+
+        return $this->response->setJSON($webmanifest);
+    }
+
+    public function podcastManifest(string $podcastHandle): ResponseInterface
+    {
+        if (
+            ! ($podcast = (new PodcastModel())->getPodcastByHandle($podcastHandle)) instanceof Podcast
+        ) {
+            throw PageNotFoundException::forPageNotFound();
+        }
+
+        $webmanifest = [
+            'name'             => esc($podcast->title),
+            'short_name'       => $podcast->at_handle,
+            'description'      => $podcast->description,
+            'lang'             => $podcast->language_code,
+            'start_url'        => $podcast->link,
+            'scope'            => '/' . $podcast->at_handle,
+            'display'          => 'standalone',
+            'orientation'      => 'portrait',
+            'theme_color'      => self::THEME_COLORS[service('settings')->get('App.theme')]['theme'],
+            'background_color' => self::THEME_COLORS[service('settings')->get('App.theme')]['background'],
+            'icons'            => [
+                [
+                    'src'   => $podcast->cover->webmanifest192_url,
+                    'type'  => $podcast->cover->webmanifest192_mimetype,
+                    'sizes' => '192x192',
+                ],
+                [
+                    'src'   => $podcast->cover->webmanifest512_url,
+                    'type'  => $podcast->cover->webmanifest512_mimetype,
+                    'sizes' => '512x512',
+                ],
+            ],
+        ];
+
+        return $this->response->setJSON($webmanifest);
+    }
+}

app/Database/Migrations/2020-06-11-210000_add_analytics_podcasts_procedure.php

-<?php
-
-/**
- * Class AddAnalyticsPodcastsProcedure
- * Creates analytics_podcasts procedure in database
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-namespace App\Database\Migrations;
-
-use CodeIgniter\Database\Migration;
-
-class AddAnalyticsPodcastsProcedure extends Migration
-{
-    public function up()
-    {
-        // Creates Procedure for data insertion
-        // Example: CALL analytics_podcasts(1, 2, 'FR', 'IDF', 48.853, 2.349, PodcastAddict, 'phone', 'android', 0, 1);
-        $prefix = $this->db->getPrefix();
-
-        $createQuery = <<<EOD
-CREATE PROCEDURE `{$prefix}analytics_podcasts` (
-    IN `p_podcast_id` INT UNSIGNED,
-    IN `p_episode_id` INT UNSIGNED,
-    IN `p_country_code` VARCHAR(3) CHARSET utf8mb4,
-    IN `p_region_code` VARCHAR(3) CHARSET utf8mb4,
-    IN `p_latitude` FLOAT,
-    IN `p_longitude` FLOAT,
-    IN `p_service` VARCHAR(128) CHARSET utf8mb4,
-    IN `p_app` VARCHAR(128) CHARSET utf8mb4,
-    IN `p_device` VARCHAR(32) CHARSET utf8mb4,
-    IN `p_os` VARCHAR(32) CHARSET utf8mb4,
-    IN `p_bot` TINYINT(1) UNSIGNED,
-    IN `p_filesize` INT UNSIGNED,
-    IN `p_duration` INT UNSIGNED,
-    IN `p_age` INT UNSIGNED,
-    IN `p_new_listener` TINYINT(1) UNSIGNED
-    )  MODIFIES SQL DATA
-DETERMINISTIC
-SQL SECURITY INVOKER
-COMMENT 'Add one hit in podcast logs tables.'
-BEGIN
-
-SET @current_datetime = NOW();
-SET @current_date = DATE(@current_datetime);
-SET @current_hour = HOUR(@current_datetime);
-
-IF NOT `p_bot` THEN
-    INSERT INTO `{$prefix}analytics_podcasts`(`podcast_id`, `date`)
-        VALUES (p_podcast_id, @current_date)
-        ON DUPLICATE KEY UPDATE
-            `duration`=`duration`+`p_duration`,
-            `bandwidth`=`bandwidth`+`p_filesize`,
-            `hits`=`hits`+1,
-            `unique_listeners`=`unique_listeners`+`p_new_listener`;
-    INSERT INTO `{$prefix}analytics_podcasts_by_hour`(`podcast_id`, `date`, `hour`)
-        VALUES (p_podcast_id, @current_date, @current_hour)
-        ON DUPLICATE KEY UPDATE `hits`=`hits`+1;
-    INSERT INTO `{$prefix}analytics_podcasts_by_episode`(`podcast_id`, `episode_id`, `date`, `age`) 
-        VALUES (p_podcast_id, p_episode_id, @current_date, p_age)
-        ON DUPLICATE KEY UPDATE `hits`=`hits`+1;
-    INSERT INTO `{$prefix}analytics_podcasts_by_country`(`podcast_id`, `country_code`, `date`) 
-        VALUES (p_podcast_id, p_country_code, @current_date) 
-        ON DUPLICATE KEY UPDATE `hits`=`hits`+1;
-    INSERT INTO `{$prefix}analytics_podcasts_by_region`(`podcast_id`, `country_code`, `region_code`, `latitude`, `longitude`, `date`) 
-        VALUES (p_podcast_id, p_country_code, p_region_code, p_latitude, p_longitude, @current_date) 
-        ON DUPLICATE KEY UPDATE `hits`=`hits`+1;
-END IF;
-INSERT INTO `{$prefix}analytics_podcasts_by_player`(`podcast_id`, `service`, `app`, `device`, `os`, `is_bot`, `date`) 
-    VALUES (p_podcast_id, p_service, p_app, p_device, p_os, p_bot, @current_date) 
-    ON DUPLICATE KEY UPDATE `hits`=`hits`+1;
-END
-EOD;
-        $this->db->query($createQuery);
-    }
-
-    public function down()
-    {
-        $prefix = $this->db->getPrefix();
-        $this->db->query(
-            "DROP PROCEDURE IF EXISTS `{$prefix}analytics_podcasts`"
-        );
-    }
-}

app/Database/Migrations/2020-06-11-210000_add_analytics_website_procedure.php

-<?php
-
-/**
- * Class AddAnalyticsWebsiteProcedure
- * Creates analytics_website stored procedure in database
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-namespace App\Database\Migrations;
-
-use CodeIgniter\Database\Migration;
-
-class AddAnalyticsWebsiteProcedure extends Migration
-{
-    public function up()
-    {
-        // Creates Procedure for data insertion
-        // Example: CALL analytics_website(1,'FR','Firefox');
-        $procedureName = $this->db->prefixTable('analytics_website');
-        $createQuery = <<<EOD
-CREATE PROCEDURE `$procedureName` (IN `p_podcast_id` INT UNSIGNED, IN `p_browser` VARCHAR(191) CHARSET utf8mb4, IN `p_entry_page` VARCHAR(512) CHARSET utf8mb4, IN `p_referer_url` VARCHAR(512) CHARSET utf8mb4, IN `p_domain` VARCHAR(128) CHARSET utf8mb4, IN `p_keywords` VARCHAR(384) CHARSET utf8mb4)  MODIFIES SQL DATA
-DETERMINISTIC
-SQL SECURITY INVOKER
-COMMENT 'Add one hit in website logs tables.'
-BEGIN
-
-SET @current_date = DATE(NOW());
-
-INSERT INTO {$procedureName}_by_browser(`podcast_id`, `browser`, `date`) 
-    VALUES (p_podcast_id, p_browser, @current_date) 
-    ON DUPLICATE KEY UPDATE `hits`=`hits`+1;
-INSERT INTO {$procedureName}_by_referer(`podcast_id`, `referer_url`, `domain`, `keywords`, `date`) 
-    VALUES (p_podcast_id, p_referer_url, p_domain, p_keywords, @current_date) 
-    ON DUPLICATE KEY UPDATE `hits`=`hits`+1;
-INSERT INTO {$procedureName}_by_entry_page(`podcast_id`, `entry_page_url`, `date`) 
-    VALUES (p_podcast_id, p_entry_page, @current_date) 
-    ON DUPLICATE KEY UPDATE `hits`=`hits`+1;
-END
-EOD;
-        $this->db->query($createQuery);
-    }
-
-    public function down()
-    {
-        $procedureName = $this->db->prefixTable('analytics_website');
-        $this->db->query("DROP PROCEDURE IF EXISTS `$procedureName`");
-    }
-}

app/Database/Migrations/2020-07-03-191500_add_podcasts_users.php

-<?php
-
-/**
- * Class AddLanguages
- * Creates languages table in database
- *
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-namespace App\Database\Migrations;
-
-use CodeIgniter\Database\Migration;
-
-class AddPodcastsUsers extends Migration
-{
-    public function up()
-    {
-        $this->forge->addField([
-            'podcast_id' => [
-                'type' => 'INT',
-                'unsigned' => true,
-            ],
-            'user_id' => [
-                'type' => 'INT',
-                'unsigned' => true,
-            ],
-            'group_id' => [
-                'type' => 'INT',
-                'unsigned' => true,
-            ],
-        ]);
-        $this->forge->addPrimaryKey(['user_id', 'podcast_id']);
-        $this->forge->addForeignKey('user_id', 'users', 'id');
-        $this->forge->addForeignKey('podcast_id', 'podcasts', 'id');
-        $this->forge->addForeignKey('group_id', 'auth_groups', 'id');
-        $this->forge->createTable('podcasts_users');
-    }
-
-    public function down()
-    {
-        $this->forge->dropTable('podcasts_users');
-    }
-}

app/Database/Migrations/2020-12-25-150000_add_credit_view.php

-<?php
-
-/**
- * Class AddCreditView
- * Creates Credit View in database
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-namespace App\Database\Migrations;
-
-use CodeIgniter\Database\Migration;
-
-class AddCreditView extends Migration
-{
-    public function up()
-    {
-        // Creates View for credit UNION query
-        $viewName = $this->db->prefixTable('credits');
-        $personTable = $this->db->prefixTable('persons');
-        $podcastPersonTable = $this->db->prefixTable('podcasts_persons');
-        $episodePersonTable = $this->db->prefixTable('episodes_persons');
-        $createQuery = <<<EOD
-CREATE VIEW `$viewName` AS
-    SELECT `person_group`, `person_id`, `full_name`, `person_role`, `podcast_id`, NULL AS `episode_id` FROM `$podcastPersonTable`
-        INNER JOIN `$personTable`
-            ON (`person_id`=`$personTable`.`id`)
-    UNION
-    SELECT `person_group`, `person_id`, `full_name`, `person_role`, `podcast_id`, `episode_id` FROM `$episodePersonTable`
-        INNER JOIN `$personTable`
-            ON (`person_id`=`$personTable`.`id`)
-    ORDER BY `person_group`, `full_name`, `person_role`, `podcast_id`, `episode_id`;
-EOD;
-        $this->db->query($createQuery);
-    }
-
-    public function down()
-    {
-        $viewName = $this->db->prefixTable('credits');
-        $this->db->query("DROP VIEW IF EXISTS `$viewName`");
-    }
-}

app/Database/Migrations/2020-05-29-152000_add_categories.php → app/Database/Migrations/2021-05-29-152000_add_categories.php

 <?php
 
+declare(strict_types=1);
+
 /**
- * Class AddCategories
- * Creates categories table in database
+ * Class AddCategories Creates categories table in database
  *
- * @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\Database\Migrations;
 
-use CodeIgniter\Database\Migration;
+use Override;
 
-class AddCategories extends Migration
+class AddCategories extends BaseMigration
 {
-    public function up()
+    #[Override]
+    public function up(): void
     {
         $this->forge->addField([
             'id' => [
-                'type' => 'INT',
+                'type'     => 'INT',
                 'unsigned' => true,
             ],
             'parent_id' => [
-                'type' => 'INT',
+                'type'     => 'INT',
                 'unsigned' => true,
+                'null'     => true,
             ],
             'code' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 32,
             ],
             'apple_category' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 32,
             ],
             'google_category' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 32,
             ],
         ]);
-        $this->forge->addKey('id', true);
+        $this->forge->addPrimaryKey('id');
         $this->forge->addUniqueKey('code');
         $this->forge->addForeignKey('parent_id', 'categories', 'id');
         $this->forge->createTable('categories');
     }
 
-    public function down()
+    #[Override]
+    public function down(): void
     {
         $this->forge->dropTable('categories');
     }

app/Database/Migrations/2020-05-30-101000_add_languages.php → app/Database/Migrations/2021-05-30-101000_add_languages.php

 <?php
 
+declare(strict_types=1);
+
 /**
- * Class AddLanguages
- * Creates languages table in database
+ * Class AddLanguages Creates languages table in database
  *
- * @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\Database\Migrations;
 
-use CodeIgniter\Database\Migration;
+use Override;
 
-class AddLanguages extends Migration
+class AddLanguages extends BaseMigration
 {
-    public function up()
+    #[Override]
+    public function up(): void
     {
         $this->forge->addField([
             'code' => [
-                'type' => 'VARCHAR',
-                'comment' => 'ISO 639-1 language code',
+                'type'       => 'VARCHAR',
+                'comment'    => 'ISO 639-1 language code',
                 'constraint' => 2,
             ],
             'native_name' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 128,
             ],
         ]);
-        $this->forge->addKey('code', true);
+        $this->forge->addPrimaryKey('code');
         $this->forge->createTable('languages');
     }
 
-    public function down()
+    #[Override]
+    public function down(): void
     {
         $this->forge->dropTable('languages');
     }

app/Database/Migrations/2020-05-30-101500_add_podcasts.php → app/Database/Migrations/2021-05-30-101500_add_podcasts.php

 <?php
 
+declare(strict_types=1);
+
 /**
- * Class AddPodcasts
- * Creates podcasts table in database
+ * Class AddPodcasts Creates podcasts table in database
  *
- * @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\Database\Migrations;
 
-use CodeIgniter\Database\Migration;
+use Override;
 
-class AddPodcasts extends Migration
+class AddPodcasts extends BaseMigration
 {
-    public function up()
+    #[Override]
+    public function up(): void
     {
         $this->forge->addField([
             'id' => [
-                'type' => 'INT',
-                'unsigned' => true,
+                'type'           => 'INT',
+                'unsigned'       => true,
                 'auto_increment' => true,
             ],
-            'title' => [
-                'type' => 'VARCHAR',
-                'constraint' => 128,
+            'guid' => [
+                'type'       => 'CHAR',
+                'constraint' => 36,
             ],
-            'name' => [
-                'type' => 'VARCHAR',
+            'actor_id' => [
+                'type'     => 'INT',
+                'unsigned' => true,
+            ],
+            'handle' => [
+                'type'       => 'VARCHAR',
                 'constraint' => 32,
-                'unique' => true,
+            ],
+            'title' => [
+                'type'       => 'VARCHAR',
+                'constraint' => 128,
             ],
             'description_markdown' => [
                 'type' => 'TEXT',
@@ -38,47 +47,51 @@ class AddPodcasts extends Migration
             'description_html' => [
                 'type' => 'TEXT',
             ],
-            'image_uri' => [
-                'type' => 'VARCHAR',
-                'constraint' => 255,
+            'cover_id' => [
+                'type'     => 'INT',
+                'unsigned' => true,
+            ],
+            'banner_id' => [
+                'type'     => 'INT',
+                'unsigned' => true,
+                'null'     => true,
             ],
             'language_code' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 2,
             ],
             'category_id' => [
-                'type' => 'INT',
+                'type'     => 'INT',
                 'unsigned' => true,
-                'default' => 0,
+                'default'  => 0,
             ],
             'parental_advisory' => [
-                'type' => 'ENUM',
+                'type'       => 'ENUM',
                 'constraint' => ['clean', 'explicit'],
-                'null' => true,
-                'default' => null,
+                'null'       => true,
             ],
             'owner_name' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 128,
             ],
             'owner_email' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 255,
             ],
             'publisher' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 128,
-                'null' => true,
+                'null'       => true,
             ],
             'type' => [
-                'type' => 'ENUM',
+                'type'       => 'ENUM',
                 'constraint' => ['episodic', 'serial'],
-                'default' => 'episodic',
+                'default'    => 'episodic',
             ],
             'copyright' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 128,
-                'null' => true,
+                'null'       => true,
             ],
             'episode_description_footer_markdown' => [
                 'type' => 'TEXT',
@@ -89,94 +102,105 @@ class AddPodcasts extends Migration
                 'null' => true,
             ],
             'is_blocked' => [
-                'type' => 'TINYINT',
+                'type'       => 'TINYINT',
                 'constraint' => 1,
-                'default' => 0,
+                'default'    => 0,
             ],
             'is_completed' => [
-                'type' => 'TINYINT',
+                'type'       => 'TINYINT',
                 'constraint' => 1,
-                'default' => 0,
+                'default'    => 0,
             ],
             'is_locked' => [
-                'type' => 'TINYINT',
+                'type'       => 'TINYINT',
                 'constraint' => 1,
-                'default' => 1,
+                'default'    => 1,
             ],
             'imported_feed_url' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 512,
-                'comment' =>
-                    'The RSS feed URL if this podcast was imported, NULL otherwise.',
-                'null' => true,
+                'comment'    => 'The RSS feed URL if this podcast was imported, NULL otherwise.',
+                'null'       => true,
             ],
             'new_feed_url' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 512,
-                'comment' =>
-                    'The RSS new feed URL if this podcast is moving out, NULL otherwise.',
-                'null' => true,
+                'comment'    => 'The RSS new feed URL if this podcast is moving out, NULL otherwise.',
+                'null'       => true,
             ],
             'payment_pointer' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 128,
-                'comment' => 'Wallet address for Web Monetization payments',
-                'null' => true,
+                'comment'    => 'Wallet address for Web Monetization payments',
+                'null'       => true,
             ],
             'location_name' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 128,
-                'null' => true,
+                'null'       => true,
             ],
             'location_geo' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 32,
-                'null' => true,
+                'null'       => true,
             ],
-            'location_osmid' => [
-                'type' => 'VARCHAR',
+            'location_osm' => [
+                'type'       => 'VARCHAR',
                 'constraint' => 12,
-                'null' => true,
+                'null'       => true,
             ],
             'custom_rss' => [
                 'type' => 'JSON',
+                'null' => true,
             ],
             'partner_id' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 32,
-                'null' => true,
+                'null'       => true,
             ],
             'partner_link_url' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 512,
-                'null' => true,
+                'null'       => true,
             ],
             'partner_image_url' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 512,
-                'null' => true,
+                'null'       => true,
+            ],
+            'is_premium_by_default' => [
+                'type'       => 'TINYINT',
+                'constraint' => 1,
+                'default'    => 0,
             ],
             'created_by' => [
-                'type' => 'INT',
+                'type'     => 'INT',
                 'unsigned' => true,
             ],
             'updated_by' => [
-                'type' => 'INT',
+                'type'     => 'INT',
                 'unsigned' => true,
             ],
-            'created_at' => [
+            'published_at' => [
                 'type' => 'DATETIME',
+                'null' => true,
             ],
-            'updated_at' => [
+            'created_at' => [
                 'type' => 'DATETIME',
             ],
-            'deleted_at' => [
+            'updated_at' => [
                 'type' => 'DATETIME',
-                'null' => true,
             ],
         ]);
 
-        $this->forge->addKey('id', true);
+        $this->forge->addPrimaryKey('id');
+        // TODO: remove name in favor of username from actor
+        $this->forge->addUniqueKey('handle');
+        $this->forge->addUniqueKey('guid');
+        $this->forge->addUniqueKey('actor_id');
+        $this->forge->addForeignKey('actor_id', 'fediverse_actors', 'id', '', 'CASCADE');
+        $this->forge->addForeignKey('cover_id', 'media', 'id');
+        $this->forge->addForeignKey('banner_id', 'media', 'id', '', 'SET NULL');
         $this->forge->addForeignKey('category_id', 'categories', 'id');
         $this->forge->addForeignKey('language_code', 'languages', 'code');
         $this->forge->addForeignKey('created_by', 'users', 'id');
@@ -184,7 +208,8 @@ class AddPodcasts extends Migration
         $this->forge->createTable('podcasts');
     }
 
-    public function down()
+    #[Override]
+    public function down(): void
     {
         $this->forge->dropTable('podcasts');
     }

app/Database/Migrations/2020-06-05-170000_add_episodes.php → app/Database/Migrations/2021-06-05-170000_add_episodes.php

 <?php
 
+declare(strict_types=1);
+
 /**
- * Class AddEpisodes
- * Creates episodes table in database
+ * Class AddEpisodes Creates episodes table in database
  *
- * @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\Database\Migrations;
 
-use CodeIgniter\Database\Migration;
+use Override;
 
-class AddEpisodes extends Migration
+class AddEpisodes extends BaseMigration
 {
-    public function up()
+    #[Override]
+    public function up(): void
     {
         $this->forge->addField([
             'id' => [
-                'type' => 'INT',
-                'unsigned' => true,
+                'type'           => 'INT',
+                'unsigned'       => true,
                 'auto_increment' => true,
             ],
             'podcast_id' => [
-                'type' => 'INT',
+                'type'     => 'INT',
                 'unsigned' => true,
             ],
             'guid' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 255,
             ],
             'title' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 128,
             ],
             'slug' => [
-                'type' => 'VARCHAR',
-                'constraint' => 191,
-            ],
-            'enclosure_uri' => [
-                'type' => 'VARCHAR',
-                'constraint' => 255,
-            ],
-            'enclosure_duration' => [
-                'type' => 'INT',
-                'unsigned' => true,
-                'comment' => 'Playtime in seconds',
-            ],
-            'enclosure_mimetype' => [
-                'type' => 'VARCHAR',
-                'constraint' => 255,
-            ],
-            'enclosure_filesize' => [
-                'type' => 'INT',
-                'unsigned' => true,
-                'comment' => 'File size in bytes',
+                'type'       => 'VARCHAR',
+                'constraint' => 128,
             ],
-            'enclosure_headersize' => [
-                'type' => 'INT',
+            'audio_id' => [
+                'type'     => 'INT',
                 'unsigned' => true,
-                'comment' => 'Header size in bytes',
             ],
             'description_markdown' => [
                 'type' => 'TEXT',
@@ -68,72 +51,96 @@ class AddEpisodes extends Migration
             'description_html' => [
                 'type' => 'TEXT',
             ],
-            'image_uri' => [
-                'type' => 'VARCHAR',
-                'constraint' => 255,
-                'null' => true,
+            'cover_id' => [
+                'type'     => 'INT',
+                'unsigned' => true,
+                'null'     => true,
             ],
-            'transcript_uri' => [
-                'type' => 'VARCHAR',
-                'constraint' => 255,
-                'null' => true,
+            'transcript_id' => [
+                'type'     => 'INT',
+                'unsigned' => true,
+                'null'     => true,
             ],
-            'chapters_uri' => [
-                'type' => 'VARCHAR',
-                'constraint' => 255,
-                'null' => true,
+            'transcript_remote_url' => [
+                'type'       => 'VARCHAR',
+                'constraint' => 512,
+                'null'       => true,
+            ],
+            'chapters_id' => [
+                'type'     => 'INT',
+                'unsigned' => true,
+                'null'     => true,
+            ],
+            'chapters_remote_url' => [
+                'type'       => 'VARCHAR',
+                'constraint' => 512,
+                'null'       => true,
             ],
             'parental_advisory' => [
-                'type' => 'ENUM',
+                'type'       => 'ENUM',
                 'constraint' => ['clean', 'explicit'],
-                'null' => true,
-                'default' => null,
+                'null'       => true,
             ],
             'number' => [
-                'type' => 'INT',
+                'type'     => 'INT',
                 'unsigned' => true,
-                'null' => true,
+                'null'     => true,
             ],
             'season_number' => [
-                'type' => 'INT',
+                'type'     => 'INT',
                 'unsigned' => true,
-                'null' => true,
+                'null'     => true,
             ],
             'type' => [
-                'type' => 'ENUM',
+                'type'       => 'ENUM',
                 'constraint' => ['trailer', 'full', 'bonus'],
-                'default' => 'full',
+                'default'    => 'full',
             ],
             'is_blocked' => [
-                'type' => 'TINYINT',
+                'type'       => 'TINYINT',
                 'constraint' => 1,
-                'default' => 0,
+                'default'    => 0,
             ],
             'location_name' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 128,
-                'null' => true,
+                'null'       => true,
             ],
             'location_geo' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 32,
-                'null' => true,
+                'null'       => true,
             ],
-            'location_osmid' => [
-                'type' => 'VARCHAR',
+            'location_osm' => [
+                'type'       => 'VARCHAR',
                 'constraint' => 12,
-                'null' => true,
+                'null'       => true,
             ],
             'custom_rss' => [
                 'type' => 'JSON',
                 'null' => true,
             ],
+            'posts_count' => [
+                'type'     => 'INT',
+                'unsigned' => true,
+                'default'  => 0,
+            ],
+            'comments_count' => [
+                'type'     => 'INT',
+                'unsigned' => true,
+                'default'  => 0,
+            ],
+            'is_premium' => [
+                'type'       => 'TINYINT',
+                'constraint' => 1,
+                'default'    => 0,
+            ],
             'created_by' => [
-                'type' => 'INT',
+                'type'     => 'INT',
                 'unsigned' => true,
             ],
             'updated_by' => [
-                'type' => 'INT',
+                'type'     => 'INT',
                 'unsigned' => true,
             ],
             'published_at' => [
@@ -146,20 +153,29 @@ class AddEpisodes extends Migration
             'updated_at' => [
                 'type' => 'DATETIME',
             ],
-            'deleted_at' => [
-                'type' => 'DATETIME',
-                'null' => true,
-            ],
         ]);
-        $this->forge->addKey('id', true);
+        $this->forge->addPrimaryKey('id');
         $this->forge->addUniqueKey(['podcast_id', 'slug']);
-        $this->forge->addForeignKey('podcast_id', 'podcasts', 'id');
+        $this->forge->addForeignKey('podcast_id', 'podcasts', 'id', '', 'CASCADE');
+        $this->forge->addForeignKey('audio_id', 'media', 'id');
+        $this->forge->addForeignKey('cover_id', 'media', 'id', '', 'SET NULL');
+        $this->forge->addForeignKey('transcript_id', 'media', 'id', '', 'SET NULL');
+        $this->forge->addForeignKey('chapters_id', 'media', 'id', '', 'SET NULL');
         $this->forge->addForeignKey('created_by', 'users', 'id');
         $this->forge->addForeignKey('updated_by', 'users', 'id');
         $this->forge->createTable('episodes');
+
+        // Add Full-Text Search index on title and description_markdown
+        $prefix = $this->db->getPrefix();
+        $createQuery = <<<SQL
+            ALTER TABLE {$prefix}episodes
+            ADD FULLTEXT title (title, description_markdown);
+        SQL;
+        $this->db->query($createQuery);
     }
 
-    public function down()
+    #[Override]
+    public function down(): void
     {
         $this->forge->dropTable('episodes');
     }

app/Database/Migrations/2020-06-05-190000_add_platforms.php → app/Database/Migrations/2021-06-05-190000_add_platforms.php

 <?php
 
+declare(strict_types=1);
+
 /**
- * Class AddPlatforms
- * Creates platforms table in database
+ * Class AddPlatforms Creates platforms table in database
  *
- * @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\Database\Migrations;
 
-use CodeIgniter\Database\Migration;
+use Override;
 
-class AddPlatforms extends Migration
+class AddPlatforms extends BaseMigration
 {
-    public function up()
+    #[Override]
+    public function up(): void
     {
         $this->forge->addField([
             'slug' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 32,
             ],
             'type' => [
-                'type' => 'ENUM',
+                'type'       => 'ENUM',
                 'constraint' => ['podcasting', 'social', 'funding'],
             ],
             'label' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 32,
             ],
             'home_url' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 255,
             ],
             'submit_url' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 512,
-                'null' => true,
-                'default' => null,
+                'null'       => true,
             ],
         ]);
-        $this->forge->addField('`created_at` timestamp NOT NULL DEFAULT NOW()');
+        $this->forge->addField('`created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP()');
         $this->forge->addField(
-            '`updated_at` timestamp NOT NULL DEFAULT NOW() ON UPDATE NOW()'
+            '`updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP() ON UPDATE CURRENT_TIMESTAMP()',
         );
-        $this->forge->addKey('slug', true);
+        $this->forge->addPrimaryKey('slug');
         $this->forge->createTable('platforms');
     }
 
-    public function down()
+    #[Override]
+    public function down(): void
     {
         $this->forge->dropTable('platforms');
     }

app/Database/Migrations/2020-06-08-160000_add_podcasts_platforms.php → app/Database/Migrations/2021-06-05-200000_add_podcasts_platforms.php

 <?php
 
+declare(strict_types=1);
+
 /**
- * Class AddAddPodcastsPlatforms
- * Creates podcasts_platforms table in database
+ * Class AddAddPodcastsPlatforms Creates podcasts_platforms table in database
  *
- * @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\Database\Migrations;
 
-use CodeIgniter\Database\Migration;
+use Override;
 
-class AddPodcastsPlatforms extends Migration
+class AddPodcastsPlatforms extends BaseMigration
 {
-    public function up()
+    #[Override]
+    public function up(): void
     {
         $this->forge->addField([
             'podcast_id' => [
-                'type' => 'INT',
+                'type'     => 'INT',
                 'unsigned' => true,
             ],
             'platform_slug' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 32,
             ],
             'link_url' => [
-                'type' => 'VARCHAR',
+                'type'       => 'VARCHAR',
                 'constraint' => 512,
             ],
-            'link_content' => [
-                'type' => 'VARCHAR',
+            'account_id' => [
+                'type'       => 'VARCHAR',
                 'constraint' => 128,
-                'null' => true,
+                'null'       => true,
             ],
             'is_visible' => [
-                'type' => 'TINYINT',
+                'type'       => 'TINYINT',
                 'constraint' => 1,
-                'default' => 0,
+                'default'    => 0,
             ],
-            'is_on_embeddable_player' => [
-                'type' => 'TINYINT',
+            'is_on_embed' => [
+                'type'       => 'TINYINT',
                 'constraint' => 1,
-                'default' => 0,
+                'default'    => 0,
             ],
         ]);
 
         $this->forge->addPrimaryKey(['podcast_id', 'platform_slug']);
-        $this->forge->addForeignKey('podcast_id', 'podcasts', 'id');
-        $this->forge->addForeignKey('platform_slug', 'platforms', 'slug');
+        $this->forge->addForeignKey('podcast_id', 'podcasts', 'id', '', 'CASCADE');
+        $this->forge->addForeignKey('platform_slug', 'platforms', 'slug', 'CASCADE');
         $this->forge->createTable('podcasts_platforms');
     }
 
-    public function down()
+    #[Override]
+    public function down(): void
     {
         $this->forge->dropTable('podcasts_platforms');
     }

app/Database/Migrations/2021-08-12-150000_add_episode_comments.php

+<?php
+
+declare(strict_types=1);
+
+/**
+ * Class AddEpisodeComments creates episode_comments table in database
+ *
+ * @copyright  2021 Ad Aures
+ * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
+ * @link       https://castopod.org/
+ */
+
+namespace App\Database\Migrations;
+
+use Override;
+
+class AddEpisodeComments extends BaseMigration
+{
+    #[Override]
+    public function up(): void
+    {
+        $this->forge->addField([
+            'id' => [
+                'type'       => 'BINARY',
+                'constraint' => 16,
+            ],
+            'uri' => [
+                'type'       => 'VARCHAR',
+                'constraint' => 255,
+            ],
+            'episode_id' => [
+                'type'     => 'INT',
+                'unsigned' => true,
+            ],
+            'actor_id' => [
+                'type'     => 'INT',
+                'unsigned' => true,
+            ],
+            'in_reply_to_id' => [
+                'type'       => 'BINARY',
+                'constraint' => 16,
+                'null'       => true,
+            ],
+            'message' => [
+                'type'       => 'VARCHAR',
+                'constraint' => 5000,
+            ],
+            'message_html' => [
+                'type'       => 'VARCHAR',
+                'constraint' => 6000,
+            ],
+            'likes_count' => [
+                'type'     => 'INT',
+                'unsigned' => true,
+            ],
+            'replies_count' => [
+                'type'     => 'INT',
+                'unsigned' => true,
+            ],
+            'created_at' => [
+                'type' => 'DATETIME',
+            ],
+            'created_by' => [
+                'type'     => 'INT',
+                'unsigned' => true,
+                'null'     => true,
+            ],
+        ]);
+
+        $this->forge->addPrimaryKey('id');
+        $this->forge->addForeignKey('episode_id', 'episodes', 'id', '', 'CASCADE');
+        $this->forge->addForeignKey('actor_id', 'fediverse_actors', 'id', '', 'CASCADE');
+        $this->forge->addForeignKey('created_by', 'users', 'id');
+        $this->forge->createTable('episode_comments');
+    }
+
+    #[Override]
+    public function down(): void
+    {
+        $this->forge->dropTable('episode_comments');
+    }
+}