app/Entities/Category.php

 <?php
+
+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/
  */
@@ -8,26 +11,37 @@
 namespace App\Entities;
 
 use App\Models\CategoryModel;
-use CodeIgniter\Entity;
+use CodeIgniter\Entity\Entity;
 
+/**
+ * @property int $id
+ * @property int $parent_id
+ * @property Category|null $parent
+ * @property string $code
+ * @property string $apple_category
+ * @property string $google_category
+ */
 class Category extends Entity
 {
-    protected $parent;
+    protected ?Category $parent = null;
 
+    /**
+     * @var array<string, string>
+     */
     protected $casts = [
-        'parent_id' => 'integer',
-        'code' => 'string',
-        'apple_category' => 'string',
+        'id'              => 'integer',
+        'parent_id'       => '?integer',
+        'code'            => 'string',
+        'apple_category'  => 'string',
         'google_category' => 'string',
     ];
 
-    public function getParent()
+    public function getParent(): ?self
     {
-        $category_model = new CategoryModel();
-        $parent_id = $this->attributes['parent_id'];
+        if ($this->parent_id === null) {
+            return null;
+        }
 
-        return $parent_id != 0
-            ? $category_model->find($this->attributes['parent_id'])
-            : null;
+        return (new CategoryModel())->getCategoryById($this->parent_id);
     }
 }

app/Entities/Clip/BaseClip.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\Entities\Clip;
+
+use App\Entities\Episode;
+use App\Entities\Podcast;
+use App\Models\EpisodeModel;
+use App\Models\PodcastModel;
+use CodeIgniter\Entity\Entity;
+use CodeIgniter\Files\File;
+use CodeIgniter\I18n\Time;
+use CodeIgniter\Shield\Entities\User;
+use Modules\Auth\Models\UserModel;
+use Modules\Media\Entities\Audio;
+use Modules\Media\Entities\Video;
+use Modules\Media\Models\MediaModel;
+
+/**
+ * @property int $id
+ * @property int $podcast_id
+ * @property Podcast $podcast
+ * @property int $episode_id
+ * @property Episode $episode
+ * @property string $title
+ * @property double $start_time
+ * @property double $end_time
+ * @property double $duration
+ * @property string $type
+ * @property int|null $media_id
+ * @property Video|Audio|null $media
+ * @property array<mixed>|null $metadata
+ * @property string $status
+ * @property string $logs
+ * @property User $user
+ * @property int $created_by
+ * @property int $updated_by
+ * @property Time|null $job_started_at
+ * @property Time|null $job_ended_at
+ */
+class BaseClip extends Entity
+{
+    /**
+     * @var Video|Audio|null
+     */
+    protected $media;
+
+    protected ?int $job_duration = null;
+
+    protected ?float $end_time = null;
+
+    /**
+     * @var array<int, string>
+     * @phpstan-var list<string>
+     */
+    protected $dates = ['created_at', 'updated_at', 'job_started_at', 'job_ended_at'];
+
+    /**
+     * @var array<string, string>
+     */
+    protected $casts = [
+        'id'         => 'integer',
+        'podcast_id' => 'integer',
+        'episode_id' => 'integer',
+        'title'      => 'string',
+        'start_time' => 'double',
+        'duration'   => 'double',
+        'type'       => 'string',
+        'media_id'   => '?integer',
+        'metadata'   => '?json-array',
+        'status'     => 'string',
+        'logs'       => 'string',
+        'created_by' => 'integer',
+        'updated_by' => 'integer',
+    ];
+
+    /**
+     * @param array<string, mixed>|null $data
+     */
+    public function __construct(?array $data = null)
+    {
+        parent::__construct($data);
+    }
+
+    public function getJobDuration(): ?int
+    {
+        if ($this->job_duration === null && $this->job_started_at && $this->job_ended_at) {
+            $this->job_duration = ($this->job_started_at->difference($this->job_ended_at))
+                ->getSeconds();
+        }
+
+        return $this->job_duration;
+    }
+
+    public function getEndTime(): float
+    {
+        if ($this->end_time === null) {
+            $this->end_time = $this->start_time + $this->duration;
+        }
+
+        return $this->end_time;
+    }
+
+    public function getPodcast(): ?Podcast
+    {
+        return (new PodcastModel())->getPodcastById($this->podcast_id);
+    }
+
+    public function getEpisode(): ?Episode
+    {
+        return (new EpisodeModel())->getEpisodeById($this->episode_id);
+    }
+
+    public function getUser(): ?User
+    {
+        /** @var ?User */
+        return (new UserModel())->find($this->created_by);
+    }
+
+    public function setMedia(File $file, string $fileKey): static
+    {
+        if ($this->media_id !== null) {
+            $this->getMedia()
+                ->setFile($file);
+            $this->getMedia()
+                ->updated_by = $this->attributes['updated_by'];
+            (new MediaModel('audio'))->updateMedia($this->getMedia());
+        } else {
+            $media = new Audio([
+                'file_key'      => $fileKey,
+                'language_code' => $this->getPodcast()
+                    ->language_code,
+                'uploaded_by' => $this->attributes['updated_by'],
+                'updated_by'  => $this->attributes['updated_by'],
+            ]);
+            $media->setFile($file);
+
+            $this->attributes['media_id'] = (new MediaModel())->saveMedia($media);
+        }
+
+        return $this;
+    }
+
+    public function getMedia(): Audio | Video | null
+    {
+        if ($this->media_id !== null && $this->media === null) {
+            $this->media = (new MediaModel($this->type))->getMediaById($this->media_id);
+        }
+
+        return $this->media;
+    }
+}

app/Entities/Clip/Soundbite.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\Entities\Clip;
+
+class Soundbite extends BaseClip
+{
+    protected string $type = 'audio';
+}

app/Entities/Clip/VideoClip.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\Entities\Clip;
+
+use CodeIgniter\Files\File;
+use Modules\Media\Entities\Video;
+use Modules\Media\Models\MediaModel;
+use Override;
+
+/**
+ * @property array{name:string,preview:string} $theme
+ * @property string $format
+ */
+class VideoClip extends BaseClip
+{
+    protected string $type = 'video';
+
+    /**
+     * @param array<string, mixed>|null $data
+     */
+    public function __construct(?array $data = null)
+    {
+        parent::__construct($data);
+
+        if ($this->metadata !== null && $this->metadata !== []) {
+            $this->theme = $this->metadata['theme'];
+            $this->format = $this->metadata['format'];
+        }
+    }
+
+    /**
+     * @param array{name:string,preview:string} $theme
+     */
+    public function setTheme(array $theme): self
+    {
+        // TODO: change?
+        $this->attributes['metadata'] = json_decode($this->attributes['metadata'] ?? '[]', true);
+
+        $this->attributes['theme'] = $theme;
+        $this->attributes['metadata']['theme'] = $theme;
+
+        $this->attributes['metadata'] = json_encode($this->attributes['metadata']);
+
+        return $this;
+    }
+
+    public function setFormat(string $format): self
+    {
+        $this->attributes['metadata'] = json_decode((string) $this->attributes['metadata'], true);
+
+        $this->attributes['format'] = $format;
+        $this->attributes['metadata']['format'] = $format;
+
+        $this->attributes['metadata'] = json_encode($this->attributes['metadata']);
+
+        return $this;
+    }
+
+    #[Override]
+    public function setMedia(File $file, string $fileKey): static
+    {
+        if ($this->attributes['media_id'] !== null) {
+            // media is already set, do nothing
+            return $this;
+        }
+
+        $video = new Video([
+            'file_key'      => $fileKey,
+            'language_code' => $this->getPodcast()
+                ->language_code,
+            'uploaded_by' => $this->attributes['created_by'],
+            'updated_by'  => $this->attributes['created_by'],
+        ]);
+        $video->setFile($file);
+
+        $this->attributes['media_id'] = (new MediaModel('video'))->saveMedia($video);
+
+        return $this;
+    }
+}

app/Entities/Credit.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\Entities;
+
+use App\Models\EpisodeModel;
+use App\Models\PersonModel;
+use App\Models\PodcastModel;
+use CodeIgniter\Entity\Entity;
+use RuntimeException;
+
+/**
+ * @property int $podcast_id
+ * @property Podcast|null $podcast
+ * @property int|null $episode_id
+ * @property Episode|null $episode
+ * @property string $full_name
+ * @property string $person_group
+ * @property string $group_label
+ * @property string $person_role
+ * @property string $role_label
+ * @property int $person_id
+ * @property Person|null $person
+ */
+class Credit extends Entity
+{
+    protected ?Person $person = null;
+
+    protected ?Podcast $podcast = null;
+
+    protected ?Episode $episode = null;
+
+    protected string $group_label;
+
+    protected string $role_label;
+
+    /**
+     * @var array<string, string>
+     */
+    protected $casts = [
+        'podcast_id'   => 'integer',
+        'episode_id'   => '?integer',
+        'person_id'    => 'integer',
+        'full_name'    => 'string',
+        'person_group' => 'string',
+        'person_role'  => 'string',
+    ];
+
+    public function getPerson(): ?Person
+    {
+        if ($this->person_id === null) {
+            throw new RuntimeException('Credit must have person_id before getting person.');
+        }
+
+        if (! $this->person instanceof Person) {
+            $this->person = (new PersonModel())->getPersonById($this->person_id);
+        }
+
+        return $this->person;
+    }
+
+    public function getPodcast(): ?Podcast
+    {
+        if ($this->podcast_id === null) {
+            throw new RuntimeException('Credit must have podcast_id before getting podcast.');
+        }
+
+        if (! $this->podcast instanceof Podcast) {
+            $this->podcast = (new PodcastModel())->getPodcastById($this->podcast_id);
+        }
+
+        return $this->podcast;
+    }
+
+    public function getEpisode(): ?Episode
+    {
+        if ($this->episode_id === null) {
+            throw new RuntimeException('Credit must have episode_id before getting episode.');
+        }
+
+        if (! $this->episode instanceof Episode) {
+            $this->episode = (new EpisodeModel())->getPublishedEpisodeById($this->podcast_id, $this->episode_id);
+        }
+
+        return $this->episode;
+    }
+
+    public function getGroupLabel(): string
+    {
+        if ($this->person_group === null) {
+            return '';
+        }
+
+        /** @var string */
+        return lang("PersonsTaxonomy.persons.{$this->person_group}.label");
+    }
+
+    public function getRoleLabel(): string
+    {
+        if ($this->person_group === '') {
+            return '';
+        }
+
+        if ($this->person_role === '') {
+            return '';
+        }
+
+        /** @var string */
+        return lang("PersonsTaxonomy.persons.{$this->person_group}.roles.{$this->person_role}.label");
+    }
+}

app/Entities/Episode.php

 <?php
+
+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\Entities;
 
+use App\Entities\Clip\Soundbite;
+use App\Models\ClipModel;
+use App\Models\EpisodeCommentModel;
+use App\Models\EpisodeModel;
+use App\Models\PersonModel;
 use App\Models\PodcastModel;
-use CodeIgniter\Entity;
+use App\Models\PostModel;
+use CodeIgniter\Entity\Entity;
+use CodeIgniter\Files\File;
+use CodeIgniter\HTTP\Files\UploadedFile;
+use CodeIgniter\I18n\Time;
+use Exception;
+use League\CommonMark\Environment\Environment;
+use League\CommonMark\Extension\Autolink\AutolinkExtension;
+use League\CommonMark\Extension\CommonMark\CommonMarkCoreExtension;
+use League\CommonMark\Extension\DisallowedRawHtml\DisallowedRawHtmlExtension;
+use League\CommonMark\Extension\SmartPunct\SmartPunctExtension;
+use League\CommonMark\MarkdownConverter;
+use Modules\Media\Entities\Audio;
+use Modules\Media\Entities\Chapters;
+use Modules\Media\Entities\Image;
+use Modules\Media\Entities\Transcript;
+use Modules\Media\Models\MediaModel;
+use Override;
+use RuntimeException;
 
+/**
+ * @property int $id
+ * @property int $podcast_id
+ * @property Podcast $podcast
+ * @property ?string $preview_id
+ * @property string $preview_link
+ * @property string $link
+ * @property string $guid
+ * @property string $slug
+ * @property string $title
+ * @property int $audio_id
+ * @property ?Audio $audio
+ * @property string $audio_url
+ * @property string $audio_web_url
+ * @property string $audio_opengraph_url
+ * @property string|null $description Holds text only description, striped of any markdown or html special characters
+ * @property string $description_markdown
+ * @property string $description_html
+ * @property ?int $cover_id
+ * @property ?Image $cover
+ * @property int|null $transcript_id
+ * @property Transcript|null $transcript
+ * @property string|null $transcript_remote_url
+ * @property int|null $chapters_id
+ * @property Chapters|null $chapters
+ * @property string|null $chapters_remote_url
+ * @property string|null $parental_advisory
+ * @property int $number
+ * @property int $season_number
+ * @property string $type
+ * @property bool $is_blocked
+ * @property Location|null $location
+ * @property string|null $location_name
+ * @property string|null $location_geo
+ * @property string|null $location_osm
+ * @property bool $is_published_on_hubs
+ * @property int $downloads_count
+ * @property int $posts_count
+ * @property int $comments_count
+ * @property EpisodeComment[]|null $comments
+ * @property bool $is_premium
+ * @property int $created_by
+ * @property int $updated_by
+ * @property string $publication_status
+ * @property Time|null $published_at
+ * @property Time $created_at
+ * @property Time $updated_at
+ *
+ * @property Person[] $persons
+ * @property Soundbite[] $soundbites
+ * @property string $embed_url
+ */
 class Episode extends Entity
 {
-    protected \App\Entities\Podcast $podcast;
-    protected string $GUID;
-    protected string $link;
-    protected \CodeIgniter\Files\File $image;
-    protected string $image_media_path;
-    protected string $image_url;
-    protected \CodeIgniter\Files\File $enclosure;
-    protected string $enclosure_media_path;
-    protected string $enclosure_url;
-    protected array $enclosure_metadata;
+    public string $link = '';
+
+    public string $audio_url = '';
+
+    public string $audio_web_url = '';
+
+    public string $audio_opengraph_url = '';
+
+    protected Podcast $podcast;
+
+    protected ?Audio $audio = null;
+
+    protected string $embed_url = '';
+
+    protected ?Image $cover = null;
+
+    protected ?string $description = null;
+
+    protected ?Transcript $transcript = null;
+
+    protected ?Chapters $chapters = null;
+
+    /**
+     * @var Person[]|null
+     */
+    protected ?array $persons = null;
+
+    /**
+     * @var Soundbite[]|null
+     */
+    protected ?array $soundbites = null;
+
+    /**
+     * @var Post[]|null
+     */
+    protected ?array $posts = null;
+
+    /**
+     * @var EpisodeComment[]|null
+     */
+    protected ?array $comments = null;
+
+    protected ?Location $location = null;
 
+    protected ?string $publication_status = null;
+
+    /**
+     * @var array<int, string>
+     * @phpstan-var list<string>
+     */
+    protected $dates = ['published_at', 'created_at', 'updated_at'];
+
+    /**
+     * @var array<string, string>
+     */
     protected $casts = [
-        'slug' => 'string',
-        'title' => 'string',
-        'enclosure_uri' => 'string',
-        'pub_date' => 'datetime',
-        'description' => 'string',
-        'image_uri' => '?string',
-        'author_name' => '?string',
-        'author_email' => '?string',
-        'explicit' => 'boolean',
-        'number' => 'integer',
-        'season_number' => '?integer',
-        'type' => 'string',
-        'block' => 'boolean',
+        'id'                    => 'integer',
+        'podcast_id'            => 'integer',
+        'preview_id'            => '?string',
+        'guid'                  => 'string',
+        'slug'                  => 'string',
+        'title'                 => 'string',
+        'audio_id'              => 'integer',
+        'description_markdown'  => 'string',
+        'description_html'      => 'string',
+        'cover_id'              => '?integer',
+        'transcript_id'         => '?integer',
+        'transcript_remote_url' => '?string',
+        'chapters_id'           => '?integer',
+        'chapters_remote_url'   => '?string',
+        'parental_advisory'     => '?string',
+        'number'                => '?integer',
+        'season_number'         => '?integer',
+        'type'                  => 'string',
+        'is_blocked'            => 'boolean',
+        'location_name'         => '?string',
+        'location_geo'          => '?string',
+        'location_osm'          => '?string',
+        'is_published_on_hubs'  => 'boolean',
+        'downloads_count'       => 'integer',
+        'posts_count'           => 'integer',
+        'comments_count'        => 'integer',
+        'is_premium'            => 'boolean',
+        'created_by'            => 'integer',
+        'updated_by'            => 'integer',
     ];
 
-    public function setImage(?\CodeIgniter\HTTP\Files\UploadedFile $image)
+    /**
+     * @param array<string, mixed> $data
+     */
+    #[Override]
+    public function injectRawData(array $data): static
     {
-        if ($image->isValid()) {
-            // check whether the user has inputted an image and store it
-            $this->attributes['image_uri'] = save_podcast_media(
-                $image,
-                $this->getPodcast()->name,
-                $this->attributes['slug']
-            );
-        } elseif (
-            $APICdata = $this->getEnclosureMetadata()['attached_picture']
-        ) {
-            // if the user didn't input an image,
-            // check if the uploaded audio file has an attached cover and store it
-            $cover_image = new \CodeIgniter\Files\File('episode_cover');
-            file_put_contents($cover_image, $APICdata);
-
-            $this->attributes['image_uri'] = save_podcast_media(
-                $cover_image,
-                $this->getPodcast()->name,
-                $this->attributes['slug']
-            );
+        parent::injectRawData($data);
+
+        $this->link = url_to('episode', esc($this->getPodcast()->handle, 'url'), esc($this->attributes['slug'], 'url'));
+
+        $this->audio_url = url_to(
+            'episode-audio',
+            $this->getPodcast()
+                ->handle,
+            $this->slug,
+            $this->getAudio()
+                ->file_extension,
+        );
+
+        $this->audio_opengraph_url = $this->audio_url . '?_from=-+Open+Graph+-';
+        $this->audio_web_url = $this->audio_url . '?_from=-+Website+-';
+
+        return $this;
+    }
+
+    public function setCover(UploadedFile | File|null $file = null): self
+    {
+        if (! $file instanceof File || ($file instanceof UploadedFile && ! $file->isValid())) {
+            return $this;
+        }
+
+        if (array_key_exists('cover_id', $this->attributes) && $this->attributes['cover_id'] !== null) {
+            $this->getCover()
+                ->setFile($file);
+            $this->getCover()
+                ->updated_by = $this->attributes['updated_by'];
+            (new MediaModel('image'))->updateMedia($this->getCover());
+        } else {
+            $cover = new Image([
+                'file_key' => 'podcasts/' . $this->getPodcast()->handle . '/' . $this->attributes['slug'] . '.' . $file->getExtension(),
+                'sizes'    => config('Images')
+                    ->podcastCoverSizes,
+                'uploaded_by' => $this->attributes['updated_by'],
+                'updated_by'  => $this->attributes['updated_by'],
+            ]);
+            $cover->setFile($file);
+
+            $this->attributes['cover_id'] = (new MediaModel('image'))->saveMedia($cover);
         }
 
         return $this;
     }
 
-    public function getImage()
+    public function getCover(): Image
+    {
+        if ($this->cover instanceof Image) {
+            return $this->cover;
+        }
+
+        if ($this->cover_id === null) {
+            $this->cover = $this->getPodcast()
+                ->getCover();
+
+            return $this->cover;
+        }
+
+        $this->cover = (new MediaModel('image'))->getMediaById($this->cover_id);
+
+        return $this->cover;
+    }
+
+    public function setAudio(UploadedFile | File|null $file = null): self
     {
-        return new \CodeIgniter\Files\File($this->getImageMediaPath());
+        if (! $file instanceof File || ($file instanceof UploadedFile && ! $file->isValid())) {
+            return $this;
+        }
+
+        if ($this->audio_id !== 0) {
+            $this->getAudio()
+                ->setFile($file);
+            $this->getAudio()
+                ->updated_by = $this->attributes['updated_by'];
+            (new MediaModel('audio'))->updateMedia($this->getAudio());
+        } else {
+            $audio = new Audio([
+                'file_key'      => 'podcasts/' . $this->getPodcast()->handle . '/' . $file->getRandomName(),
+                'language_code' => $this->getPodcast()
+                    ->language_code,
+                'uploaded_by' => $this->attributes['updated_by'],
+                'updated_by'  => $this->attributes['updated_by'],
+            ]);
+            $audio->setFile($file);
+
+            $this->attributes['audio_id'] = (new MediaModel())->saveMedia($audio);
+        }
+
+        return $this;
     }
 
-    public function getImageMediaPath()
+    public function getAudio(): Audio
     {
-        return media_path($this->attributes['image_uri']);
+        if (! $this->audio instanceof Audio) {
+            $this->audio = (new MediaModel('audio'))->getMediaById($this->audio_id);
+        }
+
+        return $this->audio;
     }
 
-    public function getImageUrl()
+    public function setTranscript(UploadedFile | File|null $file = null): self
     {
-        if ($image_uri = $this->attributes['image_uri']) {
-            return media_url($image_uri);
+        if (! $file instanceof File || ($file instanceof UploadedFile && ! $file->isValid())) {
+            return $this;
+        }
+
+        if ($this->getTranscript() instanceof Transcript) {
+            $this->getTranscript()
+                ->setFile($file);
+            $this->getTranscript()
+                ->updated_by = $this->attributes['updated_by'];
+            (new MediaModel('transcript'))->updateMedia($this->getTranscript());
+        } else {
+            $transcript = new Transcript([
+                'file_key'      => 'podcasts/' . $this->getPodcast()->handle . '/' . $this->attributes['slug'] . '-transcript.' . $file->getExtension(),
+                'language_code' => $this->getPodcast()
+                    ->language_code,
+                'uploaded_by' => $this->attributes['updated_by'],
+                'updated_by'  => $this->attributes['updated_by'],
+            ]);
+            $transcript->setFile($file);
+
+            $this->attributes['transcript_id'] = (new MediaModel('transcript'))->saveMedia($transcript);
         }
-        return $this->getPodcast()->image_url;
+
+        return $this;
     }
 
-    public function setEnclosure(
-        \CodeIgniter\HTTP\Files\UploadedFile $enclosure = null
-    ) {
-        if ($enclosure->isValid()) {
-            helper('media');
+    public function getTranscript(): ?Transcript
+    {
+        if ($this->transcript_id !== null && ! $this->transcript instanceof Transcript) {
+            $this->transcript = (new MediaModel('transcript'))->getMediaById($this->transcript_id);
+        }
 
-            $this->attributes['enclosure_uri'] = save_podcast_media(
-                $enclosure,
-                $this->getPodcast()->name,
-                $this->attributes['slug']
-            );
+        return $this->transcript;
+    }
 
+    public function setChapters(UploadedFile | File|null $file = null): self
+    {
+        if (! $file instanceof File || ($file instanceof UploadedFile && ! $file->isValid())) {
             return $this;
         }
+
+        if ($this->getChapters() instanceof Chapters) {
+            $this->getChapters()
+                ->setFile($file);
+            $this->getChapters()
+                ->updated_by = $this->attributes['updated_by'];
+            (new MediaModel('chapters'))->updateMedia($this->getChapters());
+        } else {
+            $chapters = new Chapters([
+                'file_key'      => 'podcasts/' . $this->getPodcast()->handle . '/' . $this->attributes['slug'] . '-chapters' . '.' . $file->getExtension(),
+                'language_code' => $this->getPodcast()
+                    ->language_code,
+                'uploaded_by' => $this->attributes['updated_by'],
+                'updated_by'  => $this->attributes['updated_by'],
+            ]);
+            $chapters->setFile($file);
+
+            $this->attributes['chapters_id'] = (new MediaModel('chapters'))->saveMedia($chapters);
+        }
+
+        return $this;
     }
 
-    public function getEnclosure()
+    public function getChapters(): ?Chapters
     {
-        return new \CodeIgniter\Files\File($this->getEnclosureMediaPath());
+        if ($this->chapters_id !== null && ! $this->chapters instanceof Chapters) {
+            $this->chapters = (new MediaModel('chapters'))->getMediaById($this->chapters_id);
+        }
+
+        return $this->chapters;
     }
 
-    public function getEnclosureMediaPath()
+    /**
+     * Gets transcript url from transcript file uri if it exists or returns the transcript_remote_url which can be null.
+     */
+    public function getTranscriptUrl(): ?string
     {
-        helper('media');
+        if ($this->transcript instanceof Transcript) {
+            return $this->transcript->file_url;
+        }
 
-        return media_path($this->attributes['enclosure_uri']);
+        return $this->transcript_remote_url;
     }
 
-    public function getEnclosureUrl()
+    /**
+     * Gets chapters file url from chapters file uri if it exists or returns the chapters_remote_url which can be null.
+     */
+    public function getChaptersFileUrl(): ?string
     {
-        return base_url(
-            route_to(
-                'analytics_hit',
-                $this->attributes['podcast_id'],
-                $this->attributes['id'],
-                $this->attributes['enclosure_uri']
-            )
-        );
+        if ($this->chapters instanceof Chapters) {
+            return $this->chapters->file_url;
+        }
+
+        return $this->chapters_remote_url;
     }
 
-    public function getEnclosureMetadata()
+    /**
+     * Returns the episode's persons
+     *
+     * @return Person[]
+     */
+    public function getPersons(): array
     {
-        helper('id3');
+        if ($this->id === null) {
+            throw new RuntimeException('Episode must be created before getting persons.');
+        }
 
-        return get_file_tags($this->getEnclosure());
+        if ($this->persons === null) {
+            $this->persons = (new PersonModel())->getEpisodePersons($this->podcast_id, $this->id);
+        }
+
+        return $this->persons;
     }
 
-    public function getLink()
+    /**
+     * Returns the episode’s clips
+     *
+     * @return Soundbite[]
+     */
+    public function getSoundbites(): array
     {
-        return base_url(
-            route_to(
-                'episode_view',
-                $this->getPodcast()->name,
-                $this->attributes['slug']
-            )
-        );
+        if ($this->id === null) {
+            throw new RuntimeException('Episode must be created before getting soundbites.');
+        }
+
+        if ($this->soundbites === null) {
+            $this->soundbites = (new ClipModel())->getEpisodeSoundbites($this->getPodcast()->id, $this->id);
+        }
+
+        return $this->soundbites;
+    }
+
+    /**
+     * @return Post[]
+     */
+    public function getPosts(): array
+    {
+        if ($this->id === null) {
+            throw new RuntimeException('Episode must be created before getting posts.');
+        }
+
+        if ($this->posts === null) {
+            $this->posts = (new PostModel())->getEpisodePosts($this->id);
+        }
+
+        return $this->posts;
+    }
+
+    /**
+     * @return EpisodeComment[]
+     */
+    public function getComments(): array
+    {
+        if ($this->id === null) {
+            throw new RuntimeException('Episode must be created before getting comments.');
+        }
+
+        if ($this->comments === null) {
+            $this->comments = (new EpisodeCommentModel())->getEpisodeComments($this->id);
+        }
+
+        return $this->comments;
+    }
+
+    public function getEmbedUrl(?string $theme = null): string
+    {
+        return $theme
+                ? url_to('embed-theme', esc($this->getPodcast()->handle), esc($this->attributes['slug']), $theme)
+                : url_to('embed', esc($this->getPodcast()->handle), esc($this->attributes['slug']));
+    }
+
+    public function setGuid(?string $guid = null): static
+    {
+        $this->attributes['guid'] = $guid ?? $this->link;
+
+        return $this;
+    }
+
+    public function getPodcast(): ?Podcast
+    {
+        return (new PodcastModel())->getPodcastById($this->podcast_id);
+    }
+
+    public function setDescriptionMarkdown(string $descriptionMarkdown): static
+    {
+        $config = [
+            'html_input'         => 'escape',
+            'allow_unsafe_links' => false,
+        ];
+
+        $environment = new Environment($config);
+        $environment->addExtension(new CommonMarkCoreExtension());
+        $environment->addExtension(new AutolinkExtension());
+        $environment->addExtension(new SmartPunctExtension());
+        $environment->addExtension(new DisallowedRawHtmlExtension());
+
+        $converter = new MarkdownConverter($environment);
+
+        $this->attributes['description_markdown'] = $descriptionMarkdown;
+        $this->attributes['description_html'] = $converter->convert($descriptionMarkdown);
+
+        return $this;
+    }
+
+    public function getDescription(): string
+    {
+        if ($this->description === null) {
+            $this->description = trim(
+                (string) preg_replace('~\s+~', ' ', strip_tags((string) $this->attributes['description_html'])),
+            );
+        }
+
+        return $this->description;
+    }
+
+    public function getPublicationStatus(): string
+    {
+        if ($this->publication_status === null) {
+            if (! $this->published_at instanceof Time) {
+                $this->publication_status = 'not_published';
+            } elseif ($this->getPodcast()->publication_status !== 'published') {
+                $this->publication_status = 'with_podcast';
+            } elseif ($this->published_at->isBefore(Time::now())) {
+                $this->publication_status = 'published';
+            } else {
+                $this->publication_status = 'scheduled';
+            }
+        }
+
+        return $this->publication_status;
+    }
+
+    /**
+     * Saves the location name and fetches OpenStreetMap info
+     */
+    public function setLocation(?Location $location = null): static
+    {
+        if (! $location instanceof Location) {
+            $this->attributes['location_name'] = null;
+            $this->attributes['location_geo'] = null;
+            $this->attributes['location_osm'] = null;
+
+            return $this;
+        }
+
+        if (
+            ! isset($this->attributes['location_name']) ||
+            $this->attributes['location_name'] !== $location->name
+        ) {
+            $location->fetchOsmLocation();
+
+            $this->attributes['location_name'] = $location->name;
+            $this->attributes['location_geo'] = $location->geo;
+            $this->attributes['location_osm'] = $location->osm;
+        }
+
+        return $this;
     }
 
-    public function getGUID()
+    public function getLocation(): ?Location
     {
-        return $this->getLink();
+        if ($this->location_name === null) {
+            return null;
+        }
+
+        if (! $this->location instanceof Location) {
+            $this->location = new Location($this->location_name, $this->location_geo, $this->location_osm);
+        }
+
+        return $this->location;
     }
 
-    public function getPodcast()
+    public function getPreviewLink(): string
     {
-        $podcast_model = new PodcastModel();
+        if ($this->preview_id === null) {
+            // generate preview id
+            if (! $previewUUID = (new EpisodeModel())->setEpisodePreviewId($this->id)) {
+                throw new Exception('Could not set episode preview id');
+            }
+
+            $this->preview_id = $previewUUID;
+        }
+
+        return url_to('episode-preview', (string) $this->preview_id);
+    }
+
+    /**
+     * Returns the episode's clip count
+     */
+    public function getClipCount(): int|string
+    {
+        if ($this->id === null) {
+            throw new RuntimeException('Episode must be created before getting number of video clips.');
+        }
 
-        return $podcast_model->find($this->attributes['podcast_id']);
+        return (new ClipModel())->getClipCount($this->podcast_id, $this->id);
     }
 }

app/Entities/EpisodeComment.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\Entities;
+
+use App\Models\ActorModel;
+use App\Models\EpisodeCommentModel;
+use App\Models\EpisodeModel;
+use CodeIgniter\I18n\Time;
+use Michalsn\Uuid\UuidEntity;
+use RuntimeException;
+
+/**
+ * @property string $id
+ * @property string $uri
+ * @property int $episode_id
+ * @property Episode|null $episode
+ * @property int $actor_id
+ * @property Actor|null $actor
+ * @property string $in_reply_to_id
+ * @property EpisodeComment|null $reply_to_comment
+ * @property string $message
+ * @property string $message_html
+ * @property int $likes_count
+ * @property int $replies_count
+ * @property Time $created_at
+ * @property int $created_by
+ *
+ * @property EpisodeComment[] $replies
+ */
+class EpisodeComment extends UuidEntity
+{
+    protected ?Episode $episode = null;
+
+    protected ?Actor $actor = null;
+
+    protected ?EpisodeComment $reply_to_comment = null;
+
+    /**
+     * @var EpisodeComment[]|null
+     */
+    protected ?array $replies = null;
+
+    protected bool $has_replies = false;
+
+    /**
+     * @var array<int, string>
+     * @phpstan-var list<string>
+     */
+    protected $dates = ['created_at'];
+
+    /**
+     * @var array<string, string>
+     */
+    protected $casts = [
+        'id'             => 'string',
+        'uri'            => 'string',
+        'episode_id'     => 'integer',
+        'actor_id'       => 'integer',
+        'in_reply_to_id' => '?string',
+        'message'        => 'string',
+        'message_html'   => 'string',
+        'likes_count'    => 'integer',
+        'replies_count'  => 'integer',
+        'created_by'     => 'integer',
+        'is_from_post'   => 'boolean',
+    ];
+
+    public function getEpisode(): ?Episode
+    {
+        if ($this->episode_id === null) {
+            throw new RuntimeException('Comment must have an episode_id before getting episode.');
+        }
+
+        if (! $this->episode instanceof Episode) {
+            $this->episode = (new EpisodeModel())->getEpisodeById($this->episode_id);
+        }
+
+        return $this->episode;
+    }
+
+    /**
+     * Returns the comment's actor
+     */
+    public function getActor(): ?Actor
+    {
+        if ($this->actor_id === null) {
+            throw new RuntimeException('Comment must have an actor_id before getting actor.');
+        }
+
+        if (! $this->actor instanceof Actor) {
+            $this->actor = model(ActorModel::class, false)
+                ->getActorById($this->actor_id);
+        }
+
+        return $this->actor;
+    }
+
+    /**
+     * @return EpisodeComment[]
+     */
+    public function getReplies(): array
+    {
+        if ($this->id === null) {
+            throw new RuntimeException('Comment must be created before getting replies.');
+        }
+
+        if ($this->replies === null) {
+            $this->replies = (new EpisodeCommentModel())->getCommentReplies($this->id);
+        }
+
+        return $this->replies;
+    }
+
+    public function getHasReplies(): bool
+    {
+        return $this->getReplies() !== [];
+    }
+
+    public function getReplyToComment(): ?self
+    {
+        if ($this->in_reply_to_id === null) {
+            throw new RuntimeException('Comment is not a reply.');
+        }
+
+        if (! $this->reply_to_comment instanceof self) {
+            $this->reply_to_comment = model(EpisodeCommentModel::class, false)
+                ->getCommentById($this->in_reply_to_id);
+        }
+
+        return $this->reply_to_comment;
+    }
+
+    public function setMessage(string $message): static
+    {
+        helper('fediverse');
+
+        $messageWithoutTags = strip_tags($message);
+
+        $this->attributes['message'] = $messageWithoutTags;
+        $this->attributes['message_html'] = str_replace("\n", '<br />', linkify($messageWithoutTags));
+
+        return $this;
+    }
+}

app/Entities/Language.php

 <?php
+
+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\Entities;
 
-use CodeIgniter\Entity;
+use CodeIgniter\Entity\Entity;
 
+/**
+ * @property string $code
+ * @property string $native_name
+ */
 class Language extends Entity
 {
+    /**
+     * @var array<string, string>
+     */
     protected $casts = [
-        'code' => 'string',
+        'code'        => 'string',
         'native_name' => 'string',
     ];
 }

app/Entities/AnalyticsPodcastsByPlayer.php → app/Entities/Like.php

 <?php
+
+declare(strict_types=1);
+
 /**
- * Class AnalyticsPodcastsByPlayer
- * Entity for AnalyticsPodcastsByPlayer
- * @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\Entities;
 
-use CodeIgniter\Entity;
+use Michalsn\Uuid\UuidEntity;
 
-class AnalyticsPodcastsByPlayer extends Entity
+/**
+ * @property int $actor_id
+ * @property string $comment_id
+ */
+class Like extends UuidEntity
 {
+    /**
+     * @var string[]
+     */
+    protected $uuids = ['comment_id'];
+
+    /**
+     * @var array<string, string>
+     */
     protected $casts = [
-        'podcast_id' => 'integer',
-        'player' => 'string',
-        'date' => 'datetime',
-        'hits' => 'integer',
+        'actor_id'   => 'integer',
+        'comment_id' => 'string',
     ];
 }

app/Entities/Location.php

+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright  2021 Ad Aures
+ * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
+ * @link       https://castopod.org/
+ */
+
+namespace App\Entities;
+
+use CodeIgniter\Entity\Entity;
+
+/**
+ * @property string $url
+ * @property string $name
+ * @property string|null $geo
+ * @property string|null $osm
+ * @property double|null $latitude
+ * @property double|null $longitude
+ */
+class Location extends Entity
+{
+    private const string OSM_URL = 'https://www.openstreetmap.org/';
+
+    private const string NOMINATIM_URL = 'https://nominatim.openstreetmap.org/';
+
+    public function __construct(
+        protected string $name,
+        protected ?string $geo = null,
+        protected ?string $osm = null,
+    ) {
+        $latitude = null;
+        $longitude = null;
+        if ($geo !== null) {
+            $geoArray = explode(',', substr($geo, 4));
+
+            if (count($geoArray) === 2) {
+                $latitude = (float) $geoArray[0];
+                $longitude = (float) $geoArray[1];
+            }
+        }
+
+        parent::__construct([
+            'name'      => $name,
+            'geo'       => $geo,
+            'osm'       => $osm,
+            'latitude'  => $latitude,
+            'longitude' => $longitude,
+        ]);
+    }
+
+    public function getUrl(): string
+    {
+        if ($this->osm !== null) {
+            return self::OSM_URL .
+                [
+                    'N' => 'node',
+                    'W' => 'way',
+                    'R' => 'relation',
+                ][substr($this->osm, 0, 1)] .
+                '/' .
+                substr($this->osm, 1);
+        }
+
+        if ($this->geo !== null) {
+            return self::OSM_URL .
+                '#map=17/' .
+                str_replace(',', '/', substr($this->geo, 4));
+        }
+
+        return self::OSM_URL . 'search?query=' . urlencode($this->name);
+    }
+
+    /**
+     * Fetches places from Nominatim OpenStreetMap
+     */
+    public function fetchOsmLocation(): static
+    {
+        $client = service('curlrequest');
+
+        $response = $client->request(
+            'GET',
+            self::NOMINATIM_URL .
+                'search.php?q=' .
+                urlencode($this->name) .
+                '&polygon_geojson=1&format=jsonv2',
+            [
+                'headers' => [
+                    'User-Agent' => 'Castopod/' . CP_VERSION,
+                    'Accept'     => 'application/json',
+                ],
+            ],
+        );
+
+        $places = json_decode((string) $response->getBody(), false, 512, JSON_THROW_ON_ERROR);
+
+        if ($places === []) {
+            return $this;
+        }
+
+        if (property_exists($places[0], 'lat') && $places[0]->lat !== null && (property_exists(
+            $places[0],
+            'lon',
+        ) && $places[0]->lon !== null)) {
+            $this->attributes['geo'] = "geo:{$places[0]->lat},{$places[0]->lon}";
+        }
+
+        if (property_exists($places[0], 'osm_type') && $places[0]->osm_type !== null && (property_exists(
+            $places[0],
+            'osm_id',
+        ) && $places[0]->osm_id !== null)) {
+            $this->attributes['osm'] = strtoupper(substr((string) $places[0]->osm_type, 0, 1)) . $places[0]->osm_id;
+        }
+
+        return $this;
+    }
+}

app/Entities/Page.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\Entities;
+
+use CodeIgniter\Entity\Entity;
+use CodeIgniter\I18n\Time;
+use League\CommonMark\Environment\Environment;
+use League\CommonMark\Extension\Autolink\AutolinkExtension;
+use League\CommonMark\Extension\CommonMark\CommonMarkCoreExtension;
+use League\CommonMark\Extension\DisallowedRawHtml\DisallowedRawHtmlExtension;
+use League\CommonMark\Extension\SmartPunct\SmartPunctExtension;
+use League\CommonMark\MarkdownConverter;
+
+/**
+ * @property int $id
+ * @property string $title
+ * @property string $link
+ * @property string $slug
+ * @property string $content_markdown
+ * @property string $content_html
+ * @property Time $created_at
+ * @property Time $updated_at
+ * @property Time|null $delete_at
+ */
+class Page extends Entity
+{
+    protected string $link;
+
+    protected string $content_html;
+
+    /**
+     * @var array<string, string>
+     */
+    protected $casts = [
+        'id'               => 'integer',
+        'title'            => 'string',
+        'slug'             => 'string',
+        'content_markdown' => 'string',
+        'content_html'     => 'string',
+    ];
+
+    public function getLink(): string
+    {
+        return url_to('page', $this->attributes['slug']);
+    }
+
+    public function setContentMarkdown(string $contentMarkdown): static
+    {
+        $config = [
+            'allow_unsafe_links' => false,
+        ];
+
+        $environment = new Environment($config);
+        $environment->addExtension(new CommonMarkCoreExtension());
+        $environment->addExtension(new AutolinkExtension());
+        $environment->addExtension(new SmartPunctExtension());
+        $environment->addExtension(new DisallowedRawHtmlExtension());
+
+        $converter = new MarkdownConverter($environment);
+
+        $this->attributes['content_markdown'] = $contentMarkdown;
+        $this->attributes['content_html'] = $converter->convert($contentMarkdown);
+
+        return $this;
+    }
+}

app/Entities/Person.php

+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright  2021 Ad Aures
+ * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
+ * @link       https://castopod.org/
+ */
+
+namespace App\Entities;
+
+use App\Models\PersonModel;
+use CodeIgniter\Entity\Entity;
+use CodeIgniter\Files\File;
+use CodeIgniter\HTTP\Files\UploadedFile;
+use Modules\Media\Entities\Image;
+use Modules\Media\Models\MediaModel;
+use RuntimeException;
+
+/**
+ * @property int $id
+ * @property string $full_name
+ * @property string $unique_name
+ * @property string|null $information_url
+ * @property int $avatar_id
+ * @property ?Image $avatar
+ * @property int $created_by
+ * @property int $updated_by
+ * @property object[]|null $roles
+ */
+class Person extends Entity
+{
+    protected ?Image $avatar = null;
+
+    /**
+     * @var object[]|null
+     */
+    protected ?array $roles = null;
+
+    /**
+     * @var array<string, string>
+     */
+    protected $casts = [
+        'id'              => 'integer',
+        'full_name'       => 'string',
+        'unique_name'     => 'string',
+        'information_url' => '?string',
+        'avatar_id'       => '?int',
+        'podcast_id'      => '?integer',
+        'episode_id'      => '?integer',
+        'created_by'      => 'integer',
+        'updated_by'      => 'integer',
+    ];
+
+    /**
+     * Saves the person avatar in `public/media/persons/`
+     */
+    public function setAvatar(UploadedFile | File|null $file = null): static
+    {
+        if (! $file instanceof File || ($file instanceof UploadedFile && ! $file->isValid())) {
+            return $this;
+        }
+
+        if (array_key_exists('avatar_id', $this->attributes) && $this->attributes['avatar_id'] !== null) {
+            $this->getAvatar()
+                ->setFile($file);
+            $this->getAvatar()
+                ->updated_by = $this->attributes['updated_by'];
+            (new MediaModel('image'))->updateMedia($this->getAvatar());
+        } else {
+            $avatar = new Image([
+                'file_key' => 'persons/' . $this->attributes['unique_name'] . '.' . $file->getExtension(),
+                'sizes'    => config('Images')
+                    ->personAvatarSizes,
+                'uploaded_by' => $this->attributes['updated_by'],
+                'updated_by'  => $this->attributes['updated_by'],
+            ]);
+            $avatar->setFile($file);
+
+            $this->attributes['avatar_id'] = (new MediaModel('image'))->saveMedia($avatar);
+        }
+
+        return $this;
+    }
+
+    public function getAvatar(): ?Image
+    {
+        if ($this->avatar_id === null) {
+            return null;
+        }
+
+        if (! $this->avatar instanceof Image) {
+            $this->avatar = (new MediaModel('image'))->getMediaById($this->avatar_id);
+        }
+
+        return $this->avatar;
+    }
+
+    /**
+     * @return object[]
+     */
+    public function getRoles(): array
+    {
+        if ($this->attributes['podcast_id'] === null) {
+            throw new RuntimeException('Person must have a podcast_id before getting roles.');
+        }
+
+        if ($this->roles === null) {
+            $this->roles = (new PersonModel())->getPersonRoles(
+                $this->id,
+                (int) $this->attributes['podcast_id'],
+                array_key_exists('episode_id', $this->attributes) ? (int) $this->attributes['episode_id'] : null,
+            );
+        }
+
+        return $this->roles;
+    }
+}

app/Entities/Podcast.php

 <?php
+
+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\Entities;
 
+use App\Models\ActorModel;
+use App\Models\CategoryModel;
 use App\Models\EpisodeModel;
-use CodeIgniter\Entity;
+use App\Models\PersonModel;
+use CodeIgniter\Entity\Entity;
+use CodeIgniter\Files\File;
+use CodeIgniter\HTTP\Files\UploadedFile;
+use CodeIgniter\I18n\Time;
+use CodeIgniter\Shield\Entities\User;
+use Exception;
+use League\CommonMark\Environment\Environment;
+use League\CommonMark\Extension\Autolink\AutolinkExtension;
+use League\CommonMark\Extension\CommonMark\CommonMarkCoreExtension;
+use League\CommonMark\Extension\DisallowedRawHtml\DisallowedRawHtmlExtension;
+use League\CommonMark\Extension\SmartPunct\SmartPunctExtension;
+use League\CommonMark\MarkdownConverter;
+use Modules\Auth\Models\UserModel;
+use Modules\Media\Entities\Image;
+use Modules\Media\Models\MediaModel;
+use Modules\Platforms\Entities\Platform;
+use Modules\Platforms\Models\PlatformModel;
+use Modules\PremiumPodcasts\Entities\Subscription;
+use Modules\PremiumPodcasts\Models\SubscriptionModel;
+use RuntimeException;
 
+/**
+ * @property int $id
+ * @property string $guid
+ * @property int $actor_id
+ * @property Actor|null $actor
+ * @property string $handle
+ * @property string $at_handle
+ * @property string $link
+ * @property string $feed_url
+ * @property string $title
+ * @property string|null $description Holds text only description, striped of any markdown or html special characters
+ * @property string $description_markdown
+ * @property  string $description_html
+ * @property int $cover_id
+ * @property ?Image $cover
+ * @property int|null $banner_id
+ * @property ?Image $banner
+ * @property string $language_code
+ * @property int $category_id
+ * @property Category|null $category
+ * @property int[] $other_categories_ids
+ * @property Category[] $other_categories
+ * @property string|null $parental_advisory
+ * @property string|null $publisher
+ * @property string $owner_name
+ * @property string $owner_email
+ * @property string $type
+ * @property string|null $copyright
+ * @property bool $is_blocked
+ * @property bool $is_completed
+ * @property bool $is_locked
+ * @property string|null $imported_feed_url
+ * @property string|null $new_feed_url
+ * @property Location|null $location
+ * @property string|null $location_name
+ * @property string|null $location_geo
+ * @property string|null $location_osm
+ * @property bool $is_published_on_hubs
+ * @property int $created_by
+ * @property int $updated_by
+ * @property string $publication_status
+ * @property bool $is_premium_by_default
+ * @property bool $is_premium
+ * @property Time|null $published_at
+ * @property Time $created_at
+ * @property Time $updated_at
+ *
+ * @property Episode[] $episodes
+ * @property Person[] $persons
+ * @property User[] $contributors
+ * @property Subscription[] $subscriptions
+ * @property Platform[] $podcasting_platforms
+ * @property Platform[] $social_platforms
+ * @property Platform[] $funding_platforms
+ */
 class Podcast extends Entity
 {
-    protected $link;
-    protected \CodeIgniter\Files\File $image;
-    protected $image_media_path;
-    protected $image_url;
-    protected $episodes;
+    protected string $link;
+
+    protected string $at_handle;
+
+    protected ?Actor $actor = null;
+
+    protected ?Image $cover = null;
+
+    protected ?Image $banner = null;
+
+    protected ?string $description = null;
+
+    protected ?Category $category = null;
+
+    /**
+     * @var Category[]|null
+     */
+    protected ?array $other_categories = null;
+
+    /**
+     * @var int[]
+     */
+    protected array $other_categories_ids = [];
+
+    /**
+     * @var Episode[]|null
+     */
+    protected ?array $episodes = null;
+
+    /**
+     * @var Person[]|null
+     */
+    protected ?array $persons = null;
+
+    /**
+     * @var User[]|null
+     */
+    protected ?array $contributors = null;
+
+    /**
+     * @var Subscription[]|null
+     */
+    protected ?array $subscriptions = null;
+
+    /**
+     * @var Platform[]|null
+     */
+    protected ?array $podcasting_platforms = null;
+
+    /**
+     * @var Platform[]|null
+     */
+    protected ?array $social_platforms = null;
+
+    /**
+     * @var Platform[]|null
+     */
+    protected ?array $funding_platforms = null;
+
+    protected ?Location $location = null;
 
+    protected ?string $publication_status = null;
+
+    /**
+     * @var array<int, string>
+     * @phpstan-var list<string>
+     */
+    protected $dates = ['published_at', 'created_at', 'updated_at'];
+
+    /**
+     * @var array<string, string>
+     */
     protected $casts = [
-        'id' => 'integer',
-        'title' => 'string',
-        'name' => 'string',
-        'description' => 'string',
-        'image_uri' => 'string',
-        'language' => 'string',
-        'category' => 'string',
-        'explicit' => 'boolean',
-        'author_name' => '?string',
-        'author_email' => '?string',
-        'owner_name' => '?string',
-        'owner_email' => '?string',
-        'type' => 'string',
-        'copyright' => '?string',
-        'block' => 'boolean',
-        'complete' => 'boolean',
-        'episode_description_footer' => '?string',
-        'custom_html_head' => '?string',
+        'id'                    => 'integer',
+        'guid'                  => 'string',
+        'actor_id'              => 'integer',
+        'handle'                => 'string',
+        'title'                 => 'string',
+        'description_markdown'  => 'string',
+        'description_html'      => 'string',
+        'cover_id'              => 'int',
+        'banner_id'             => '?int',
+        'language_code'         => 'string',
+        'category_id'           => 'integer',
+        'parental_advisory'     => '?string',
+        'publisher'             => '?string',
+        'owner_name'            => 'string',
+        'owner_email'           => 'string',
+        'type'                  => 'string',
+        'copyright'             => '?string',
+        'is_blocked'            => 'boolean',
+        'is_completed'          => 'boolean',
+        'is_locked'             => 'boolean',
+        'is_premium_by_default' => 'boolean',
+        'imported_feed_url'     => '?string',
+        'new_feed_url'          => '?string',
+        'location_name'         => '?string',
+        'location_geo'          => '?string',
+        'location_osm'          => '?string',
+        'is_published_on_hubs'  => 'boolean',
+        'created_by'            => 'integer',
+        'updated_by'            => 'integer',
     ];
 
-    public function setImage(\CodeIgniter\HTTP\Files\UploadedFile $image = null)
+    public function getAtHandle(): string
     {
-        if ($image) {
-            helper('media');
+        return '@' . $this->handle;
+    }
 
-            $this->attributes['image_uri'] = save_podcast_media(
-                $image,
-                $this->attributes['name'],
-                'cover'
-            );
+    public function getActor(): ?Actor
+    {
+        if ($this->actor_id === 0) {
+            throw new RuntimeException('Podcast must have an actor_id before getting actor.');
+        }
+
+        if (! $this->actor instanceof Actor) {
+            $this->actor = model(ActorModel::class, false)
+                ->getActorById($this->actor_id);
+        }
+
+        return $this->actor;
+    }
+
+    public function setCover(UploadedFile | File|null $file = null): self
+    {
+        if (! $file instanceof File || ($file instanceof UploadedFile && ! $file->isValid())) {
+            return $this;
+        }
+
+        if (array_key_exists('cover_id', $this->attributes) && $this->attributes['cover_id'] !== null) {
+            $this->getCover()
+                ->setFile($file);
+            $this->getCover()
+                ->updated_by = $this->attributes['updated_by'];
+            (new MediaModel('image'))->updateMedia($this->getCover());
+        } else {
+            $cover = new Image([
+                'file_key' => 'podcasts/' . $this->attributes['handle'] . '/cover.' . $file->getExtension(),
+                'sizes'    => config('Images')
+                    ->podcastCoverSizes,
+                'uploaded_by' => $this->attributes['updated_by'],
+                'updated_by'  => $this->attributes['updated_by'],
+            ]);
+            $cover->setFile($file);
+
+            $this->attributes['cover_id'] = (new MediaModel('image'))->saveMedia($cover);
+        }
+
+        return $this;
+    }
 
+    public function getCover(): Image
+    {
+        if (! $this->cover instanceof Image) {
+            $cover = (new MediaModel('image'))->getMediaById($this->cover_id);
+
+            if (! $cover instanceof Image) {
+                throw new Exception('Could not retrieve podcast cover.');
+            }
+
+            $this->cover = $cover;
+        }
+
+        return $this->cover;
+    }
+
+    public function setBanner(UploadedFile | File|null $file = null): self
+    {
+        if (! $file instanceof File || ($file instanceof UploadedFile && ! $file->isValid())) {
             return $this;
         }
+
+        if (array_key_exists('banner_id', $this->attributes) && $this->attributes['banner_id'] !== null) {
+            $this->getBanner()
+                ->setFile($file);
+            $this->getBanner()
+                ->updated_by = $this->attributes['updated_by'];
+            (new MediaModel('image'))->updateMedia($this->getBanner());
+        } else {
+            $banner = new Image([
+                'file_key' => 'podcasts/' . $this->attributes['handle'] . '/banner.' . $file->getExtension(),
+                'sizes'    => config('Images')
+                    ->podcastBannerSizes,
+                'uploaded_by' => $this->attributes['updated_by'],
+                'updated_by'  => $this->attributes['updated_by'],
+            ]);
+            $banner->setFile($file);
+
+            $this->attributes['banner_id'] = (new MediaModel('image'))->saveMedia($banner);
+        }
+
+        return $this;
+    }
+
+    public function getBanner(): ?Image
+    {
+        if ($this->banner_id === null) {
+            return null;
+        }
+
+        if (! $this->banner instanceof Image) {
+            $this->banner = (new MediaModel('image'))->getMediaById($this->banner_id);
+        }
+
+        return $this->banner;
+    }
+
+    public function getLink(): string
+    {
+        return url_to('podcast-activity', $this->attributes['handle']);
+    }
+
+    public function getFeedUrl(): string
+    {
+        return url_to('podcast-rss-feed', $this->attributes['handle']);
+    }
+
+    /**
+     * Returns the podcast's episodes
+     *
+     * @return Episode[]
+     */
+    public function getEpisodes(): array
+    {
+        if ($this->id === null) {
+            throw new RuntimeException('Podcast must be created before getting episodes.');
+        }
+
+        if ($this->episodes === null) {
+            $this->episodes = (new EpisodeModel())->getPodcastEpisodes($this->id, $this->type);
+        }
+
+        return $this->episodes;
+    }
+
+    /**
+     * Returns the podcast's episodes count
+     */
+    public function getEpisodesCount(): int|string
+    {
+        if ($this->id === null) {
+            throw new RuntimeException('Podcast must be created before getting number of episodes.');
+        }
+
+        return (new EpisodeModel())->getPodcastEpisodesCount($this->id);
+    }
+
+    /**
+     * Returns the podcast's persons
+     *
+     * @return Person[]
+     */
+    public function getPersons(): array
+    {
+        if ($this->id === null) {
+            throw new RuntimeException('Podcast must be created before getting persons.');
+        }
+
+        if ($this->persons === null) {
+            $this->persons = (new PersonModel())->getPodcastPersons($this->id);
+        }
+
+        return $this->persons;
+    }
+
+    /**
+     * Returns the podcast category entity
+     */
+    public function getCategory(): ?Category
+    {
+        if ($this->id === null) {
+            throw new RuntimeException('Podcast must be created before getting category.');
+        }
+
+        if (! $this->category instanceof Category) {
+            $this->category = (new CategoryModel())->getCategoryById($this->category_id);
+        }
+
+        return $this->category;
+    }
+
+    /**
+     * Returns all podcast subscriptions
+     *
+     * @return Subscription[]
+     */
+    public function getSubscriptions(): array
+    {
+        if ($this->id === null) {
+            throw new RuntimeException('Podcasts must be created before getting subscriptions.');
+        }
+
+        if ($this->subscriptions === null) {
+            $this->subscriptions = (new SubscriptionModel())->getPodcastSubscriptions($this->id);
+        }
+
+        return $this->subscriptions;
+    }
+
+    /**
+     * Returns all podcast contributors
+     *
+     * @return User[]
+     */
+    public function getContributors(): array
+    {
+        if ($this->id === null) {
+            throw new RuntimeException('Podcasts must be created before getting contributors.');
+        }
+
+        if ($this->contributors === null) {
+            $this->contributors = (new UserModel())->getPodcastContributors($this->id);
+        }
+
+        return $this->contributors;
+    }
+
+    public function setDescriptionMarkdown(string $descriptionMarkdown): static
+    {
+        $config = [
+            'html_input'         => 'escape',
+            'allow_unsafe_links' => false,
+        ];
+
+        $environment = new Environment($config);
+        $environment->addExtension(new CommonMarkCoreExtension());
+        $environment->addExtension(new AutolinkExtension());
+        $environment->addExtension(new SmartPunctExtension());
+        $environment->addExtension(new DisallowedRawHtmlExtension());
+
+        $converter = new MarkdownConverter($environment);
+
+        $this->attributes['description_markdown'] = $descriptionMarkdown;
+        $this->attributes['description_html'] = $converter->convert($descriptionMarkdown);
+
+        return $this;
+    }
+
+    public function getDescription(): string
+    {
+        if ($this->description === null) {
+            $this->description = trim(
+                (string) preg_replace('~\s+~', ' ', strip_tags((string) $this->attributes['description_html'])),
+            );
+        }
+
+        return $this->description;
+    }
+
+    public function getPublicationStatus(): string
+    {
+        if ($this->publication_status === null) {
+            if (! $this->published_at instanceof Time) {
+                $this->publication_status = 'not_published';
+            } elseif ($this->published_at->isBefore(Time::now())) {
+                $this->publication_status = 'published';
+            } else {
+                $this->publication_status = 'scheduled';
+            }
+        }
+
+        return $this->publication_status;
     }
 
-    public function getImage()
+    /**
+     * Returns the podcast's podcasting platform links
+     *
+     * @return Platform[]
+     */
+    public function getPodcastingPlatforms(): array
     {
-        return new \CodeIgniter\Files\File($this->getImageMediaPath());
+        if ($this->id === null) {
+            throw new RuntimeException('Podcast must be created before getting podcasting platform links.');
+        }
+
+        if ($this->podcasting_platforms === null) {
+            $this->podcasting_platforms = (new PlatformModel())->getPlatforms($this->id, 'podcasting');
+        }
+
+        return $this->podcasting_platforms;
     }
 
-    public function getImageMediaPath()
+    /**
+     * Returns the podcast's social platform links
+     *
+     * @return Platform[]
+     */
+    public function getSocialPlatforms(): array
     {
-        return media_path($this->attributes['image_uri']);
+        if ($this->id === null) {
+            throw new RuntimeException('Podcast must be created before getting social platform links.');
+        }
+
+        if ($this->social_platforms === null) {
+            $this->social_platforms = (new PlatformModel())->getPlatforms($this->id, 'social');
+        }
+
+        return $this->social_platforms;
     }
 
-    public function getImageUrl()
+    /**
+     * Returns the podcast's funding platform links
+     *
+     * @return Platform[]
+     */
+    public function getFundingPlatforms(): array
     {
-        return media_url($this->attributes['image_uri']);
+        if ($this->id === null) {
+            throw new RuntimeException('Podcast must be created before getting funding platform links.');
+        }
+
+        if ($this->funding_platforms === null) {
+            $this->funding_platforms = (new PlatformModel())->getPlatforms($this->id, 'funding');
+        }
+
+        return $this->funding_platforms;
     }
 
-    public function getLink()
+    /**
+     * @return Category[]
+     */
+    public function getOtherCategories(): array
     {
-        return base_url(route_to('podcast_view', $this->attributes['name']));
+        if ($this->id === null) {
+            throw new RuntimeException('Podcast must be created before getting other categories.');
+        }
+
+        if ($this->other_categories === null) {
+            $this->other_categories = (new CategoryModel())->getPodcastCategories($this->id);
+        }
+
+        return $this->other_categories;
     }
 
-    public function getFeedUrl()
+    /**
+     * @return int[]
+     */
+    public function getOtherCategoriesIds(): array
     {
-        return base_url(route_to('podcast_feed', $this->attributes['name']));
+        if ($this->other_categories_ids === []) {
+            $this->other_categories_ids = array_column($this->getOtherCategories(), 'id');
+        }
+
+        return $this->other_categories_ids;
     }
 
-    public function getEpisodes()
+    /**
+     * Saves the location name and fetches OpenStreetMap info
+     */
+    public function setLocation(?Location $location = null): static
     {
-        $episode_model = new EpisodeModel();
+        if (! $location instanceof Location) {
+            $this->attributes['location_name'] = null;
+            $this->attributes['location_geo'] = null;
+            $this->attributes['location_osm'] = null;
+
+            return $this;
+        }
+
+        if (
+            ! isset($this->attributes['location_name']) ||
+            $this->attributes['location_name'] !== $location->name
+        ) {
+            $location->fetchOsmLocation();
 
-        return $episode_model
-            ->where('podcast_id', $this->attributes['id'])
-            ->findAll();
+            $this->attributes['location_name'] = $location->name;
+            $this->attributes['location_geo'] = $location->geo;
+            $this->attributes['location_osm'] = $location->osm;
+        }
+
+        return $this;
+    }
+
+    public function getLocation(): ?Location
+    {
+        if ($this->location_name === null) {
+            return null;
+        }
+
+        if (! $this->location instanceof Location) {
+            $this->location = new Location($this->location_name, $this->location_geo, $this->location_osm);
+        }
+
+        return $this->location;
+    }
+
+    public function getIsPremium(): bool
+    {
+        // podcast is premium if at least one of its episodes is set as premium
+        return (new EpisodeModel())->doesPodcastHavePremiumEpisodes($this->id);
     }
 }

app/Entities/Post.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\Entities;
+
+use App\Models\EpisodeModel;
+use Modules\Fediverse\Entities\Post as FediversePost;
+use RuntimeException;
+
+/**
+ * @property int|null $episode_id
+ * @property Episode|null $episode
+ */
+class Post extends FediversePost
+{
+    protected ?Episode $episode = null;
+
+    /**
+     * @var array<string, string>
+     */
+    protected $casts = [
+        'id'               => 'string',
+        'uri'              => 'string',
+        'actor_id'         => 'integer',
+        'in_reply_to_id'   => '?string',
+        'reblog_of_id'     => '?string',
+        'episode_id'       => '?integer',
+        'message'          => 'string',
+        'message_html'     => 'string',
+        'favourites_count' => 'integer',
+        'reblogs_count'    => 'integer',
+        'replies_count'    => 'integer',
+        'created_by'       => 'integer',
+    ];
+
+    /**
+     * Returns the post's attached episode
+     */
+    public function getEpisode(): ?Episode
+    {
+        if ($this->episode_id === null) {
+            throw new RuntimeException('Post must have an episode_id before getting episode.');
+        }
+
+        if (! $this->episode instanceof Episode) {
+            $this->episode = (new EpisodeModel())->getEpisodeById($this->episode_id);
+        }
+
+        return $this->episode;
+    }
+}

app/Filters/AllowCorsFilter.php

+<?php
+
+declare(strict_types=1);
+
+namespace App\Filters;
+
+use CodeIgniter\Filters\FilterInterface;
+use CodeIgniter\HTTP\RequestInterface;
+use CodeIgniter\HTTP\ResponseInterface;
+use Override;
+
+class AllowCorsFilter implements FilterInterface
+{
+    /**
+     * @param list<string>|null $arguments
+     *
+     * @return RequestInterface|ResponseInterface|string|null
+     */
+    #[Override]
+    public function before(RequestInterface $request, $arguments = null)
+    {
+        return null;
+    }
+
+    /**
+     * @param list<string>|null $arguments
+     *
+     * @return ResponseInterface|null
+     */
+    #[Override]
+    public function after(RequestInterface $request, ResponseInterface $response, $arguments = null)
+    {
+        if (! $response->hasHeader('Cache-Control')) {
+            $response->setHeader('Cache-Control', 'public, max-age=86400');
+        }
+
+        $response->setHeader('Access-Control-Allow-Origin', '*') // for allowing any domain, insecure
+            ->setHeader('Access-Control-Allow-Headers', '*') // for allowing any headers, insecure
+            ->setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS') // allows GET and OPTIONS methods only
+            ->setHeader('Access-Control-Max-Age', '86400');
+
+        return $response;
+    }
+}

app/Helpers/analytics_helper.php

-
-<?php
-/**
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-/**
- * Set user country in session variable, for analytics purpose
- */
-function set_user_session_country()
-{
-    $session = \Config\Services::session();
-    $session->start();
-    $db = \Config\Database::connect();
-
-    $country = 'N/A';
-
-    // Finds country:
-    if (!$session->has('country')) {
-        try {
-            $reader = new \GeoIp2\Database\Reader(
-                WRITEPATH . 'uploads/GeoLite2-Country/GeoLite2-Country.mmdb'
-            );
-            $geoip = $reader->country($_SERVER['REMOTE_ADDR']);
-            $country = $geoip->country->isoCode;
-        } catch (\Exception $e) {
-            // If things go wrong the show must go on and the user must be able to download the file
-        }
-        $session->set('country', $country);
-    }
-}
-
-/**
- * Set user player in session variable, for analytics purpose
- */
-function set_user_session_player()
-{
-    $session = \Config\Services::session();
-    $session->start();
-
-    if (!$session->has('player')) {
-        $session = \Config\Services::session();
-        $session->start();
-
-        $playerName = '- Unknown Player -';
-
-        $useragent = $_SERVER['HTTP_USER_AGENT'];
-
-        try {
-            $jsonUserAgents = json_decode(
-                file_get_contents(
-                    WRITEPATH . 'uploads/user-agents/src/user-agents.json'
-                ),
-                true
-            );
-
-            //Search for current HTTP_USER_AGENT in json file:
-            foreach ($jsonUserAgents as $player) {
-                foreach ($player['user_agents'] as $useragentsRegexp) {
-                    //Does the HTTP_USER_AGENT match this regexp:
-                    if (preg_match("#{$useragentsRegexp}#", $useragent)) {
-                        if (isset($player['bot'])) {
-                            //It’s a bot!
-                            $playerName = '- Bot -';
-                        } else {
-                            //It isn’t a bot, we store device/os/app:
-                            $playerName =
-                                (isset($player['device'])
-                                    ? $player['device'] . '/'
-                                    : '') .
-                                (isset($player['os'])
-                                    ? $player['os'] . '/'
-                                    : '') .
-                                (isset($player['app']) ? $player['app'] : '?');
-                        }
-                        //We found it!
-                        break 2;
-                    }
-                }
-            }
-        } catch (\Exception $e) {
-            // If things go wrong the show must go on and the user must be able to download the file
-        }
-        if ($playerName == '- Unknown Player -') {
-            // Add to unknown list
-            try {
-                $db = \Config\Database::connect();
-                $procedureNameAUU = $db->prefixTable(
-                    'analytics_unknown_useragents'
-                );
-                $db->query("CALL $procedureNameAUU(?)", [$useragent]);
-            } catch (\Exception $e) {
-                // If things go wrong the show must go on and the user must be able to download the file
-            }
-        }
-        $session->set('player', $playerName);
-    }
-}
-
-/**
- * Set user browser in session variable, for analytics purpose
- */
-function set_user_session_browser()
-{
-    $session = \Config\Services::session();
-    $session->start();
-
-    if (!$session->has('browser')) {
-        $browserName = '- Other -';
-        try {
-            $whichbrowser = new \WhichBrowser\Parser(getallheaders());
-            $browserName = $whichbrowser->browser->name;
-        } catch (\Exception $e) {
-            $browserName = '- Could not get browser name -';
-        }
-        if ($browserName == null) {
-            $browserName = '- Could not get browser name -';
-        }
-        $session->set('browser', $browserName);
-    }
-}
-
-/**
- * Set user referer in session variable, for analytics purpose
- */
-function set_user_session_referer()
-{
-    $session = \Config\Services::session();
-    $session->start();
-
-    $newreferer = isset($_SERVER['HTTP_REFERER'])
-        ? parse_url($_SERVER['HTTP_REFERER'], PHP_URL_HOST)
-        : '- Direct -';
-    $newreferer =
-        $newreferer == parse_url(current_url(false), PHP_URL_HOST)
-            ? '- Direct -'
-            : $newreferer;
-    if (!$session->has('referer') or $newreferer != '- Direct -') {
-        $session->set('referer', $newreferer);
-    }
-}
-
-function webpage_hit($podcast_id)
-{
-    $session = \Config\Services::session();
-    $session->start();
-    $db = \Config\Database::connect();
-
-    $procedureName = $db->prefixTable('analytics_website');
-    $db->query("call $procedureName(?,?,?,?)", [
-        $podcast_id,
-        $session->get('country'),
-        $session->get('browser'),
-        $session->get('referer'),
-    ]);
-}
-
-function podcast_hit($p_podcast_id, $p_episode_id)
-{
-    $session = \Config\Services::session();
-    $session->start();
-    $first_time_for_this_episode = true;
-
-    if ($session->has('episodes')) {
-        if (in_array($p_episode_id, $session->get('episodes'))) {
-            $first_time_for_this_episode = false;
-        } else {
-            $session->push('episodes', [$p_episode_id]);
-        }
-    } else {
-        $session->set('episodes', [$p_episode_id]);
-    }
-
-    if ($first_time_for_this_episode) {
-        $db = \Config\Database::connect();
-        $procedureName = $db->prefixTable('analytics_podcasts');
-        try {
-            $db->query("CALL $procedureName(?,?,?,?);", [
-                $p_podcast_id,
-                $p_episode_id,
-                $session->get('country'),
-                $session->get('player'),
-            ]);
-        } catch (\Exception $e) {
-            // If things go wrong the show must go on and the user must be able to download the file
-        }
-    }
-}
-

app/Helpers/breadcrumb_helper.php

+<?php
+
+declare(strict_types=1);
+
+if (! function_exists('render_breadcrumb')) {
+    /**
+     * Renders the breadcrumb navigation through the Breadcrumb service
+     *
+     * @param string|null $class to be added to the breadcrumb nav
+     * @return string html breadcrumb
+     */
+    function render_breadcrumb(?string $class = null): string
+    {
+        return service('breadcrumb')->render($class);
+    }
+}
+
+if (! function_exists('replace_breadcrumb_params')) {
+    /**
+     * @param array<string|int,string> $newParams
+     */
+    function replace_breadcrumb_params(array $newParams): void
+    {
+        service('breadcrumb')->replaceParams($newParams);
+    }
+}

app/Helpers/components_helper.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/
+ */
+
+use App\Entities\Category;
+use App\Entities\Episode;
+use App\Entities\Location;
+use CodeIgniter\I18n\Time;
+use CodeIgniter\View\Table;
+
+// ------------------------------------------------------------------------
+
+if (! function_exists('data_table')) {
+    /**
+     * Data table component
+     *
+     * Creates a stylized table.
+     *
+     * @param array<array<string, mixed>> $columns array of associate arrays with `header` and `cell` keys where `cell` is a function with a row of $data as parameter
+     * @param mixed[] $data data to loop through and display in rows
+     * @param mixed ...$rest Any other argument to pass to the `cell` function
+     */
+    function data_table(array $columns, array $data = [], string $class = '', mixed ...$rest): string
+    {
+        $table = new Table();
+
+        $template = [
+            'table_open' => '<table class="w-full whitespace-nowrap">',
+
+            'thead_open' => '<thead class="text-xs font-semibold text-left uppercase text-skin-muted">',
+
+            'heading_cell_start' => '<th class="px-4 py-2">',
+            'cell_start'         => '<td class="px-4 py-2">',
+            'cell_alt_start'     => '<td class="px-4 py-2">',
+
+            'row_start'     => '<tr class="border-t border-subtle hover:bg-base">',
+            'row_alt_start' => '<tr class="border-t border-subtle hover:bg-base">',
+        ];
+
+        $table->setTemplate($template);
+
+        $tableHeaders = [];
+        foreach ($columns as $column) {
+            $tableHeaders[] = $column['header'];
+        }
+
+        $table->setHeading($tableHeaders);
+
+        if (($dataCount = count($data)) !== 0) {
+            for ($i = 0; $i < $dataCount; ++$i) {
+                $row = $data[$i];
+                $rowData = [];
+                foreach ($columns as $column) {
+                    $rowData[] = $column['cell']($row, ...$rest);
+                }
+
+                $table->addRow($rowData);
+            }
+        } else {
+            $table->addRow([
+                [
+                    'colspan' => count($tableHeaders),
+                    'class'   => 'px-4 py-2 italic font-semibold text-center',
+                    'data'    => lang('Common.no_data'),
+                ],
+            ]);
+        }
+
+        return '<div class="overflow-x-auto rounded-lg bg-elevated border-3 border-subtle ' . $class . '" >' .
+            $table->generate() .
+            '</div>';
+    }
+}
+
+// ------------------------------------------------------------------------
+
+if (! function_exists('publication_pill')) {
+    /**
+     * Publication pill component
+     *
+     * Shows the stylized publication datetime in regards to current datetime.
+     */
+    function publication_pill(?Time $publicationDate, string $publicationStatus, string $customClass = ''): string
+    {
+        $variant = match ($publicationStatus) {
+            'published'     => 'success',
+            'scheduled'     => 'warning',
+            'with_podcast'  => 'info',
+            'not_published' => 'default',
+            default         => 'default',
+        };
+
+        $title = match ($publicationStatus) {
+            'published', 'scheduled' => (string) $publicationDate,
+            'with_podcast'  => lang('Episode.with_podcast_hint'),
+            'not_published' => '',
+            default         => '',
+        };
+
+        $label = lang('Episode.publication_status.' . $publicationStatus);
+
+        // @icon("error-warning-fill")
+        return '<x-Pill ' . ($title === '' ? '' : 'title="' . $title . '"') . ' variant="' . $variant . '" class="' . $customClass .
+            '">' . $label . ($publicationStatus === 'with_podcast' ? icon('error-warning-fill', [
+                'class' => 'flex-shrink-0 ml-1 text-lg',
+            ]) : '') .
+            '</x-Pill>';
+    }
+}
+
+// ------------------------------------------------------------------------
+
+if (! function_exists('publication_button')) {
+    /**
+     * Publication button component for episodes
+     *
+     * Displays the appropriate publication button depending on the publication post.
+     */
+    function publication_button(int $podcastId, int $episodeId, string $publicationStatus): string
+    {
+        switch ($publicationStatus) {
+            case 'not_published':
+                $label = lang('Episode.publish');
+                $route = route_to('episode-publish', $podcastId, $episodeId);
+                $variant = 'primary';
+                $iconLeft = 'upload-cloud-fill'; // @icon("upload-cloud-fill")
+                break;
+            case 'with_podcast':
+            case 'scheduled':
+                $label = lang('Episode.publish_edit');
+                $route = route_to('episode-publish_edit', $podcastId, $episodeId);
+                $variant = 'warning';
+                $iconLeft = 'upload-cloud-fill'; // @icon("upload-cloud-fill")
+                break;
+            case 'published':
+                $label = lang('Episode.unpublish');
+                $route = route_to('episode-unpublish', $podcastId, $episodeId);
+                $variant = 'danger';
+                $iconLeft = 'cloud-off-fill'; // @icon("cloud-off-fill")
+                break;
+            default:
+                $label = '';
+                $route = '';
+                $variant = '';
+                $iconLeft = '';
+                break;
+        }
+
+        return <<<HTML
+            <x-Button variant="{$variant}" uri="{$route}" iconLeft="{$iconLeft}" >{$label}</x-Button>
+        HTML;
+    }
+}
+
+// ------------------------------------------------------------------------
+
+if (! function_exists('publication_status_banner')) {
+    /**
+     * Publication status banner component for podcasts
+     *
+     * Displays the appropriate banner depending on the podcast's publication status.
+     */
+    function publication_status_banner(?Time $publicationDate, int $podcastId, string $publicationStatus): string
+    {
+        switch ($publicationStatus) {
+            case 'not_published':
+                $bannerDisclaimer = lang('Podcast.publication_status_banner.draft_mode');
+                $bannerText = lang('Podcast.publication_status_banner.not_published');
+                $linkRoute = route_to('podcast-publish', $podcastId);
+                $linkLabel = lang('Podcast.publish');
+                break;
+            case 'scheduled':
+                $bannerDisclaimer = lang('Podcast.publication_status_banner.draft_mode');
+                $bannerText = lang('Podcast.publication_status_banner.scheduled', [
+                    'publication_date' => local_datetime($publicationDate),
+                ]);
+                $linkRoute = route_to('podcast-publish_edit', $podcastId);
+                $linkLabel = lang('Podcast.publish_edit');
+                break;
+            default:
+                $bannerDisclaimer = '';
+                $bannerText = '';
+                $linkRoute = '';
+                $linkLabel = '';
+                break;
+        }
+
+        return <<<HTML
+        <div class="flex flex-wrap items-baseline px-4 py-2 border-b md:px-12 bg-stripes-default border-subtle" role="alert">
+            <p class="flex items-baseline text-gray-900">
+                <span class="text-xs font-semibold tracking-wide uppercase">{$bannerDisclaimer}</span>
+                <span class="ml-3 text-sm">{$bannerText}</span>
+            </p>
+            <a href="{$linkRoute}" class="ml-1 text-sm font-semibold underline shadow-xs text-accent-base hover:text-accent-hover hover:no-underline">{$linkLabel}</a>
+        </div>
+        HTML;
+    }
+}
+
+// ------------------------------------------------------------------------
+
+if (! function_exists('episode_publication_status_banner')) {
+    /**
+     * Publication status banner component for podcasts
+     *
+     * Displays the appropriate banner depending on the podcast's publication status.
+     */
+    function episode_publication_status_banner(Episode $episode, string $class = ''): string
+    {
+        switch ($episode->publication_status) {
+            case 'not_published':
+                $linkRoute = route_to('episode-publish', $episode->podcast_id, $episode->id);
+                $publishLinkLabel = lang('Episode.publish');
+                break;
+            case 'scheduled':
+            case 'with_podcast':
+                $linkRoute = route_to('episode-publish_edit', $episode->podcast_id, $episode->id);
+                $publishLinkLabel = lang('Episode.publish_edit');
+                break;
+            default:
+                $bannerDisclaimer = '';
+                $linkRoute = '';
+                $publishLinkLabel = '';
+                break;
+        }
+
+        $bannerDisclaimer = lang('Episode.publication_status_banner.draft_mode');
+        $bannerText = lang('Episode.publication_status_banner.text', [
+            'publication_status' => $episode->publication_status,
+            'publication_date'   => $episode->published_at instanceof Time ? local_datetime(
+                $episode->published_at,
+            ) : null,
+        ]);
+        $previewLinkLabel = lang('Episode.publication_status_banner.preview');
+
+        return <<<HTML
+        <div class="flex flex-wrap gap-4 items-baseline px-4 md:px-12 py-2 bg-stripes-default border-subtle {$class}" role="alert">
+            <p class="flex items-baseline text-gray-900">
+                <span class="text-xs font-semibold tracking-wide uppercase">{$bannerDisclaimer}</span>
+                <span class="ml-3 text-sm">{$bannerText}</span>
+            </p>
+            <div class="flex items-baseline">    
+                <a href="{$episode->preview_link}" class="ml-1 text-sm font-semibold underline shadow-xs text-accent-base hover:text-accent-hover hover:no-underline">{$previewLinkLabel}</a>
+                <span class="mx-1">•</span>
+                <a href="{$linkRoute}" class="ml-1 text-sm font-semibold underline shadow-xs text-accent-base hover:text-accent-hover hover:no-underline">{$publishLinkLabel}</a>
+            </div>
+        </div>
+        HTML;
+    }
+}
+
+// ------------------------------------------------------------------------
+
+if (! function_exists('episode_numbering')) {
+    /**
+     * Returns relevant translated episode numbering.
+     *
+     * @param bool $isAbbr component will show abbreviated numbering if true
+     */
+    function episode_numbering(
+        ?int $episodeNumber = null,
+        ?int $seasonNumber = null,
+        string $class = '',
+        bool $isAbbr = false,
+    ): string {
+        if (! $episodeNumber && ! $seasonNumber) {
+            return '';
+        }
+
+        $transKey = '';
+        $args = [];
+        if ($episodeNumber !== null) {
+            $args['episodeNumber'] = sprintf('%02d', $episodeNumber);
+        }
+
+        if ($seasonNumber !== null) {
+            $args['seasonNumber'] = sprintf('%02d', $seasonNumber);
+        }
+
+        if ($episodeNumber !== null && $seasonNumber !== null) {
+            $transKey = 'Episode.season_episode';
+        } elseif ($episodeNumber !== null && $seasonNumber === null) {
+            $transKey = 'Episode.number';
+        } elseif ($episodeNumber === null && $seasonNumber !== null) {
+            $transKey = 'Episode.season';
+        }
+
+        if ($isAbbr) {
+            return '<abbr class="tracking-wider ' .
+                $class .
+                '" title="' .
+                lang($transKey, $args) .
+                '" data-tooltip="bottom">' .
+                lang($transKey . '_abbr', $args) .
+                '</abbr>';
+        }
+
+        return '<span class="' .
+            $class .
+            '">' .
+            lang($transKey, $args) .
+            '</span>';
+    }
+}
+
+// ------------------------------------------------------------------------
+
+if (! function_exists('location_link')) {
+    /**
+     * Returns link to display from location info
+     */
+    function location_link(?Location $location, string $class = ''): string
+    {
+        if (! $location instanceof Location) {
+            return '';
+        }
+
+        return anchor(
+            $location->url,
+            icon('map-pin-2-fill', [
+                'class' => 'mr-2 flex-shrink-0',
+            ]) . '<span class="truncate">' . esc($location->name) . '</span>',
+            [
+                'class' => 'w-full overflow-hidden inline-flex items-baseline hover:underline' .
+                    ($class === '' ? '' : " {$class}"),
+                'target' => '_blank',
+                'rel'    => 'noreferrer noopener',
+            ],
+        );
+    }
+}
+
+// ------------------------------------------------------------------------
+
+if (! function_exists('audio_player')) {
+    /**
+     * Returns audio player
+     */
+    function audio_player(string $source, string $mediaType, string $class = ''): string
+    {
+        $language = service('request')
+            ->getLocale();
+
+        return <<<HTML
+            <vm-player
+                id="castopod-vm-player"
+                theme="light"
+                language="{$language}"
+                class="{$class} relative z-0"
+                style="--vm-player-box-shadow:0; --vm-player-theme: hsl(var(--color-accent-base)); --vm-control-focus-color: hsl(var(--color-accent-contrast)); --vm-control-spacing: 4px; --vm-menu-item-focus-bg: hsl(var(--color-background-highlight));"
+            >
+                <vm-audio preload="none">
+                    <source src="{$source}" type="{$mediaType}" />
+                </vm-audio>
+                <vm-ui>
+                    <vm-icon-library></vm-icon-library>
+                    <vm-controls full-width>
+                        <vm-playback-control></vm-playback-control>
+                        <vm-volume-control></vm-volume-control>
+                        <vm-current-time></vm-current-time>
+                        <vm-scrubber-control></vm-scrubber-control>
+                        <vm-end-time></vm-end-time>
+                        <vm-settings-control></vm-settings-control>
+                        <vm-default-settings></vm-default-settings>
+                    </vm-controls>
+                </vm-ui>
+            </vm-player>
+        HTML;
+    }
+}
+
+// ------------------------------------------------------------------------
+
+if (! function_exists('relative_time')) {
+    function relative_time(Time $time, string $class = ''): string
+    {
+        $formatter = new IntlDateFormatter(service(
+            'request',
+        )->getLocale(), IntlDateFormatter::MEDIUM, IntlDateFormatter::NONE);
+        $translatedDate = $time->toLocalizedString($formatter->getPattern());
+        $datetime = $time->format(DateTime::ATOM);
+
+        return <<<HTML
+            <relative-time tense="auto" class="{$class}" datetime="{$datetime}">
+                <time
+                    datetime="{$datetime}"
+                    title="{$time}">{$translatedDate}</time>
+            </relative-time>
+        HTML;
+    }
+}
+
+// ------------------------------------------------------------------------
+
+if (! function_exists('local_datetime')) {
+    function local_datetime(Time $time): string
+    {
+        $formatter = new IntlDateFormatter(service(
+            'request',
+        )->getLocale(), IntlDateFormatter::MEDIUM, IntlDateFormatter::LONG);
+        $translatedDate = $time->toLocalizedString($formatter->getPattern());
+        $datetime = $time->format(DateTime::ATOM);
+
+        return <<<HTML
+            <relative-time datetime="{$datetime}"
+                prefix=""
+                threshold="PT0S"
+                weekday="long"
+                day="numeric"
+                month="long"
+                year="numeric"
+                hour="numeric"
+                minute="numeric">
+                <time
+                    datetime="{$datetime}"
+                    title="{$time}">{$translatedDate}</time>
+            </relative-time>
+        HTML;
+    }
+}
+
+// ------------------------------------------------------------------------
+
+if (! function_exists('local_date')) {
+    function local_date(Time $time): string
+    {
+        $formatter = new IntlDateFormatter(service(
+            'request',
+        )->getLocale(), IntlDateFormatter::MEDIUM, IntlDateFormatter::NONE);
+        $translatedDate = $time->toLocalizedString($formatter->getPattern());
+
+        return <<<HTML
+            <time title="{$time}">{$translatedDate}</time>
+        HTML;
+    }
+}
+
+// ------------------------------------------------------------------------
+
+if (! function_exists('explicit_badge')) {
+    function explicit_badge(bool $isExplicit, string $class = ''): string
+    {
+        if (! $isExplicit) {
+            return '';
+        }
+
+        $explicitLabel = lang('Common.explicit');
+        return <<<HTML
+            <span class="px-1 text-xs font-semibold leading-tight tracking-wider uppercase border md:border-white/50 {$class}">{$explicitLabel}</span>
+        HTML;
+    }
+}
+
+// ------------------------------------------------------------------------
+
+if (! function_exists('category_label')) {
+    function category_label(Category $category): string
+    {
+        $categoryLabel = '';
+        if ($category->parent_id !== null) {
+            $categoryLabel .= lang('Podcast.category_options.' . $category->parent->code) . ' › ';
+        }
+
+        return $categoryLabel . lang('Podcast.category_options.' . $category->code);
+    }
+}
+
+// ------------------------------------------------------------------------
+
+if (! function_exists('downloads_abbr')) {
+    function downloads_abbr(int $downloads): string
+    {
+        if ($downloads < 1000) {
+            return (string) $downloads;
+        }
+
+        $option = match (true) {
+            $downloads < 1_000_000 => [
+                'divider' => 1_000,
+                'suffix'  => 'K',
+            ],
+            $downloads < 1_000_000_000 => [
+                'divider' => 1_000_000,
+                'suffix'  => 'M',
+            ],
+            default => [
+                'divider' => 1_000_000_000,
+                'suffix'  => 'B',
+            ],
+        };
+        $formatter = new NumberFormatter(service('request')->getLocale(), NumberFormatter::DECIMAL);
+
+        $formatter->setPattern('#,##0.##');
+
+        $abbr = $formatter->format($downloads / $option['divider']) . $option['suffix'];
+
+        return <<<HTML
+            <abbr title="{$downloads}">{$abbr}</abbr>
+        HTML;
+    }
+}

app/Helpers/form_helper.php

+<?php
+
+declare(strict_types=1);
+
+if (! function_exists('form_textarea')) {
+    /**
+     * Adapted textarea field from CI4 core: without value escaping.
+     */
+    function form_textarea(mixed $data = '', string $value = '', mixed $extra = ''): string
+    {
+        $defaults = [
+            'name' => is_array($data) ? '' : $data,
+            'cols' => '40',
+            'rows' => '10',
+        ];
+        if (! is_array($data) || ! isset($data['value'])) {
+            $val = $value;
+        } else {
+            $val = $data['value'];
+            unset($data['value']); // textareas don't use the value attribute
+        }
+
+        // Unsets default rows and cols if defined in extra field as array or string.
+        if ((is_array($extra) && array_key_exists('rows', $extra)) || (is_string($extra) && stripos(
+            (string) preg_replace('~\s+~', '', $extra),
+            'rows=',
+        ) !== false)) {
+            unset($defaults['rows']);
+        }
+
+        if ((is_array($extra) && array_key_exists('cols', $extra)) || (is_string($extra) && stripos(
+            (string) preg_replace('~\s+~', '', $extra),
+            'cols=',
+        ) !== false)) {
+            unset($defaults['cols']);
+        }
+
+        return '<textarea ' . rtrim(parse_form_attributes($data, $defaults)) . stringify_attributes(
+            $extra,
+        ) . '>' . $val . "</textarea>\n";
+    }
+}
+
+if (! function_exists('parse_form_attributes')) {
+    /**
+     * Parse the form attributes
+     *
+     * Helper function used by some of the form helpers
+     *
+     * @param array<string, string>|string $attributes List of attributes
+     * @param array<string, mixed>        $default    Default values
+     */
+    function parse_form_attributes(array|string $attributes, array $default): string
+    {
+        if (is_array($attributes)) {
+            foreach (array_keys($default) as $key) {
+                if (isset($attributes[$key])) {
+                    $default[$key] = $attributes[$key];
+                    unset($attributes[$key]);
+                }
+            }
+
+            if ($attributes !== []) {
+                $default = array_merge($default, $attributes);
+            }
+        }
+
+        $att = '';
+
+        foreach ($default as $key => $val) {
+            if (! is_bool($val)) {
+                if ($key === 'name' && ! strlen((string) $default['name'])) {
+                    continue;
+                }
+
+                $att .= $key . '="' . $val . '"' . ($key === array_key_last($default) ? '' : ' ');
+            } else {
+                $att .= $key . ' ';
+            }
+        }
+
+        return $att;
+    }
+}

app/Helpers/id3_helper.php

 <?php
+
+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/
  */
-
-use JamesHeinrich\GetID3\GetID3;
+use App\Entities\Episode;
+use CodeIgniter\I18n\Time;
 use JamesHeinrich\GetID3\WriteTags;
+use Modules\Media\FileManagers\FileManagerInterface;
 
-/**
- * Gets audio file metadata and ID3 info
- *
- * @param UploadedFile $file
- *
- * @return array
- */
-function get_file_tags($file)
-{
-    $getID3 = new GetID3();
-    $FileInfo = $getID3->analyze($file);
+if (! function_exists('write_audio_file_tags')) {
+    /**
+     * Write audio file metadata / ID3 tags
+     */
+    function write_audio_file_tags(Episode $episode): void
+    {
+        helper('media');
 
-    return [
-        'filesize' => $FileInfo['filesize'],
-        'mime_type' => $FileInfo['mime_type'],
-        'playtime_seconds' => $FileInfo['playtime_seconds'],
-        'attached_picture' => array_key_exists('comments', $FileInfo)
-            ? $FileInfo['comments']['picture'][0]['data']
-            : null,
-    ];
-}
-
-/**
- * Write audio file metadata / ID3 tags
- *
- * @param App\Entities\Episode $episode
- *
- * @return UploadedFile
- */
-function write_enclosure_tags($episode)
-{
-    $TextEncoding = 'UTF-8';
+        $TextEncoding = 'UTF-8';
 
-    // Initialize getID3 tag-writing module
-    $tagwriter = new WriteTags();
-    $tagwriter->filename = $episode->enclosure_media_path;
+        // Initialize getID3 tag-writing module
+        $tagwriter = new WriteTags();
+        $tagwriter->filename = $episode->audio->file_name;
 
-    // set various options (optional)
-    $tagwriter->tagformats = ['id3v2.4'];
-    $tagwriter->tag_encoding = $TextEncoding;
+        // set various options (optional)
+        $tagwriter->tagformats = ['id3v2.4'];
+        $tagwriter->tag_encoding = $TextEncoding;
 
-    $cover = new \CodeIgniter\Files\File($episode->image_media_path);
+        /** @var FileManagerInterface $fileManager */
+        $fileManager = service('file_manager');
 
-    $APICdata = file_get_contents($cover->getRealPath());
+        $APICdata = (string) $fileManager->getFileContents($episode->cover->id3_key);
 
-    // TODO: variables used for podcast specific tags
-    // $podcast_url = $episode->podcast->link;
-    // $podcast_feed_url = $episode->podcast->feed_url;
-    // $episode_media_url = $episode->link;
+        // TODO: variables used for podcast specific tags
+        // $podcastUrl = $episode->podcast->link;
+        // $podcastFeedUrl = $episode->podcast->feed_url;
+        // $episodeMediaUrl = $episode->link;
 
-    // populate data array
-    $TagData = [
-        'title' => [$episode->title],
-        'artist' => [$episode->podcast->author],
-        'album' => [$episode->podcast->title],
-        'year' => [$episode->pub_date->format('Y')],
-        'genre' => ['Podcast'],
-        'comment' => [$episode->description],
-        'track_number' => [strval($episode->number)],
-        'copyright_message' => [$episode->podcast->copyright],
-        'publisher' => ['Podlibre'],
-        'encoded_by' => ['Castopod'],
+        // populate data array
+        $TagData = [
+            'title'             => [esc($episode->title)],
+            'artist'            => [$episode->podcast->publisher ?? esc($episode->podcast->owner_name)],
+            'album'             => [esc($episode->podcast->title)],
+            'year'              => [$episode->published_at instanceof Time ? $episode->published_at->format('Y') : ''],
+            'genre'             => ['Podcast'],
+            'comment'           => [$episode->description],
+            'track_number'      => [(string) $episode->number],
+            'copyright_message' => [$episode->podcast->copyright],
+            'publisher'         => [$episode->podcast->publisher ?? esc($episode->podcast->owner_name)],
+            'encoded_by'        => ['Castopod'],
 
-        // TODO: find a way to add the remaining tags for podcasts as the library doesn't seem to allow it
-        // 'website' => [$podcast_url],
-        // 'podcast' => [],
-        // 'podcast_identifier' => [$episode_media_url],
-        // 'podcast_feed' => [$podcast_feed_url],
-        // 'podcast_description' => [$podcast->description],
-    ];
+            // TODO: find a way to add the remaining tags for podcasts as the library doesn't seem to allow it
+            // 'website' => [$podcast_url],
+            // 'podcast' => [],
+            // 'podcast_identifier' => [$episode_media_url],
+            // 'podcast_feed' => [$podcast_feed_url],
+            // 'podcast_description' => [$podcast->description_markdown],
+        ];
 
-    $TagData['attached_picture'][] = [
-        'picturetypeid' => 2, // Cover. More: module.tag.id3v2.php
-        'data' => $APICdata,
-        'description' => 'cover',
-        'mime' => $cover->getMimeType(),
-    ];
+        $TagData['attached_picture'][] = [
+            // picturetypeid == Cover. More: module.tag.id3v2.php
+            'picturetypeid' => 2,
+            'data'          => $APICdata,
+            'description'   => 'cover',
+            'mime'          => $episode->cover->file_mimetype,
+        ];
 
-    $tagwriter->tag_data = $TagData;
+        $tagwriter->tag_data = $TagData;
 
-    // write tags
-    if ($tagwriter->WriteTags()) {
-        echo 'Successfully wrote tags<br>';
-        if (!empty($tagwriter->warnings)) {
-            echo 'There were some warnings:<br>' .
-                implode('<br><br>', $tagwriter->warnings);
+        // write tags
+        if ($tagwriter->WriteTags()) {
+            // Successfully wrote tags
+            if ($tagwriter->warnings !== []) {
+                log_message('warning', 'There were some warnings:' . PHP_EOL . implode(PHP_EOL, $tagwriter->warnings));
+            }
+        } else {
+            log_message('critical', 'Failed to write tags!' . PHP_EOL . implode(PHP_EOL, $tagwriter->errors));
         }
-    } else {
-        echo 'Failed to write tags!<br>' .
-            implode('<br><br>', $tagwriter->errors);
     }
 }