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\Location;
-use App\Libraries\SimpleRSSElement;
+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 App\Models\SoundbiteModel;
-use App\Models\EpisodePersonModel;
-use App\Models\NoteModel;
+use App\Models\PostModel;
 use CodeIgniter\Entity\Entity;
 use CodeIgniter\Files\File;
 use CodeIgniter\HTTP\Files\UploadedFile;
 use CodeIgniter\I18n\Time;
-use League\CommonMark\CommonMarkConverter;
+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 File $audio_file
- * @property string $audio_file_url
- * @property string $audio_file_analytics_url
- * @property string $audio_file_web_url
- * @property string $audio_file_opengraph_url
- * @property string $audio_file_path
- * @property double $audio_file_duration
- * @property string $audio_file_mimetype
- * @property int $audio_file_size
- * @property int $audio_file_header_size
- * @property string $description Holds text only description, striped of any markdown or html special characters
+ * @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 Image $image
- * @property string|null $image_path
- * @property string|null $image_mimetype
- * @property File|null $transcript_file
- * @property string|null $transcript_file_url
- * @property string|null $transcript_file_path
- * @property string|null $transcript_file_remote_url
- * @property File|null $chapters_file
- * @property string|null $chapters_file_url
- * @property string|null $chapters_file_path
- * @property string|null $chapters_file_remote_url
+ * @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 $location
+ * @property Location|null $location
  * @property string|null $location_name
  * @property string|null $location_geo
- * @property string|null $location_osm_id
- * @property array|null $custom_rss
- * @property string $custom_rss_string
- * @property int $favourites_total
- * @property int $reblogs_total
- * @property int $notes_total
+ * @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 Time|null $deleted_at;
+ * @property string $publication_status
+ * @property Time|null $published_at
+ * @property Time $created_at
+ * @property Time $updated_at
  *
- * @property EpisodePerson[] $persons;
- * @property Soundbite[] $soundbites;
- * @property string $embeddable_player_url;
+ * @property Person[] $persons
+ * @property Soundbite[] $soundbites
+ * @property string $embed_url
  */
 class Episode extends Entity
 {
-    /**
-     * @var Podcast
-     */
-    protected $podcast;
+    public string $link = '';
 
-    /**
-     * @var string
-     */
-    protected $link;
+    public string $audio_url = '';
 
-    /**
-     * @var File
-     */
-    protected $audio_file;
+    public string $audio_web_url = '';
 
-    /**
-     * @var string
-     */
-    protected $audio_file_url;
+    public string $audio_opengraph_url = '';
 
-    /**
-     * @var string
-     */
-    protected $audio_file_analytics_url;
+    protected Podcast $podcast;
 
-    /**
-     * @var string
-     */
-    protected $audio_file_web_url;
+    protected ?Audio $audio = null;
 
-    /**
-     * @var string
-     */
-    protected $audio_file_opengraph_url;
+    protected string $embed_url = '';
 
-    /**
-     * @var string
-     */
-    protected $embeddable_player_url;
+    protected ?Image $cover = null;
 
-    /**
-     * @var Image
-     */
-    protected $image;
+    protected ?string $description = null;
 
-    /**
-     * @var string
-     */
-    protected $description;
+    protected ?Transcript $transcript = null;
 
-    /**
-     * @var File
-     */
-    protected $transcript_file;
+    protected ?Chapters $chapters = null;
 
     /**
-     * @var File
+     * @var Person[]|null
      */
-    protected $chapters_file;
+    protected ?array $persons = null;
 
     /**
-     * @var EpisodePerson[]
+     * @var Soundbite[]|null
      */
-    protected $persons;
+    protected ?array $soundbites = null;
 
     /**
-     * @var Soundbite[]
+     * @var Post[]|null
      */
-    protected $soundbites;
+    protected ?array $posts = null;
 
     /**
-     * @var Note[]
+     * @var EpisodeComment[]|null
      */
-    protected $notes;
+    protected ?array $comments = null;
 
-    /**
-     * @var Location|null
-     */
-    protected $location;
+    protected ?Location $location = null;
 
-    /**
-     * @var string
-     */
-    protected $custom_rss_string;
+    protected ?string $publication_status = null;
 
     /**
-     * @var string
+     * @var array<int, string>
+     * @phpstan-var list<string>
      */
-    protected $publication_status;
-
-    /**
-     * @var string[]
-     */
-    protected $dates = [
-        'published_at',
-        'created_at',
-        'updated_at',
-        'deleted_at',
-    ];
+    protected $dates = ['published_at', 'created_at', 'updated_at'];
 
     /**
      * @var array<string, string>
      */
     protected $casts = [
-        'id' => 'integer',
-        'podcast_id' => 'integer',
-        'guid' => 'string',
-        'slug' => 'string',
-        'title' => 'string',
-        'audio_file_path' => 'string',
-        'audio_file_duration' => 'double',
-        'audio_file_mimetype' => 'string',
-        'audio_file_size' => 'integer',
-        'audio_file_header_size' => 'integer',
-        'description_markdown' => 'string',
-        'description_html' => 'string',
-        'image_path' => '?string',
-        'image_mimetype' => '?string',
-        'transcript_file_path' => '?string',
-        'transcript_file_remote_url' => '?string',
-        'chapters_file_path' => '?string',
-        'chapters_file_remote_url' => '?string',
-        'parental_advisory' => '?string',
-        'number' => '?integer',
-        'season_number' => '?integer',
-        'type' => 'string',
-        'is_blocked' => 'boolean',
-        'location_name' => '?string',
-        'location_geo' => '?string',
-        'location_osm_id' => '?string',
-        'custom_rss' => '?json-array',
-        'favourites_total' => 'integer',
-        'reblogs_total' => 'integer',
-        'notes_total' => 'integer',
-        'created_by' => 'integer',
-        'updated_by' => 'integer',
+        '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',
     ];
 
     /**
-     * Saves an episode image
-     *
-     * @param Image|null $image
+     * @param array<string, mixed> $data
      */
-    public function setImage($image = null): self
+    #[Override]
+    public function injectRawData(array $data): static
     {
-        if ($image === null) {
-            return $this;
-        }
+        parent::injectRawData($data);
+
+        $this->link = url_to('episode', esc($this->getPodcast()->handle, 'url'), esc($this->attributes['slug'], 'url'));
 
-        // Save image
-        $image->saveImage(
-            'podcasts/' . $this->getPodcast()->name,
-            $this->attributes['slug'],
+        $this->audio_url = url_to(
+            'episode-audio',
+            $this->getPodcast()
+                ->handle,
+            $this->slug,
+            $this->getAudio()
+                ->file_extension,
         );
 
-        $this->attributes['image_mimetype'] = $image->mimetype;
-        $this->attributes['image_path'] = $image->path;
+        $this->audio_opengraph_url = $this->audio_url . '?_from=-+Open+Graph+-';
+        $this->audio_web_url = $this->audio_url . '?_from=-+Website+-';
 
         return $this;
     }
 
-    public function getImage(): Image
+    public function setCover(UploadedFile | File|null $file = null): self
     {
-        if ($imagePath = $this->attributes['image_path']) {
-            return new Image(
-                null,
-                $imagePath,
-                $this->attributes['image_mimetype'],
-            );
+        if (! $file instanceof File || ($file instanceof UploadedFile && ! $file->isValid())) {
+            return $this;
         }
 
-        return $this->podcast->image;
-    }
-
-    /**
-     * Saves an audio file
-     *
-     * @param UploadedFile|File $audioFile
-     */
-    public function setAudioFile($audioFile)
-    {
-        helper(['media', 'id3']);
-
-        $audio_metadata = get_file_tags($audioFile);
+        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['audio_file_path'] = save_media(
-            $audioFile,
-            'podcasts/' . $this->getPodcast()->name,
-            $this->attributes['slug'],
-        );
-        $this->attributes['audio_file_duration'] =
-            $audio_metadata['playtime_seconds'];
-        $this->attributes['audio_file_mimetype'] = $audio_metadata['mime_type'];
-        $this->attributes['audio_file_size'] = $audio_metadata['filesize'];
-        $this->attributes['audio_file_header_size'] =
-            $audio_metadata['avdataoffset'];
+            $this->attributes['cover_id'] = (new MediaModel('image'))->saveMedia($cover);
+        }
 
         return $this;
     }
 
-    /**
-     * Saves an episode transcript file
-     *
-     * @param UploadedFile|File $transcriptFile
-     */
-    public function setTranscriptFile($transcriptFile)
+    public function getCover(): Image
     {
-        helper('media');
+        if ($this->cover instanceof Image) {
+            return $this->cover;
+        }
 
-        $this->attributes['transcript_file_path'] = save_media(
-            $transcriptFile,
-            $this->getPodcast()->name,
-            $this->attributes['slug'] . '-transcript',
-        );
+        if ($this->cover_id === null) {
+            $this->cover = $this->getPodcast()
+                ->getCover();
 
-        return $this;
+            return $this->cover;
+        }
+
+        $this->cover = (new MediaModel('image'))->getMediaById($this->cover_id);
+
+        return $this->cover;
     }
 
-    /**
-     * Saves an episode chapters file
-     *
-     * @param UploadedFile|File $chaptersFile
-     */
-    public function setChaptersFile($chaptersFile)
+    public function setAudio(UploadedFile | File|null $file = null): self
     {
-        helper('media');
+        if (! $file instanceof File || ($file instanceof UploadedFile && ! $file->isValid())) {
+            return $this;
+        }
 
-        $this->attributes['chapters_file_path'] = save_media(
-            $chaptersFile,
-            $this->getPodcast()->name,
-            $this->attributes['slug'] . '-chapters',
-        );
+        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 getAudioFile(): File
+    public function getAudio(): Audio
     {
-        helper('media');
+        if (! $this->audio instanceof Audio) {
+            $this->audio = (new MediaModel('audio'))->getMediaById($this->audio_id);
+        }
 
-        return new File(media_path($this->audio_file_path));
+        return $this->audio;
     }
 
-    public function getTranscriptFile(): ?File
+    public function setTranscript(UploadedFile | File|null $file = null): self
     {
-        if ($this->attributes['transcript_file_path']) {
-            helper('media');
+        if (! $file instanceof File || ($file instanceof UploadedFile && ! $file->isValid())) {
+            return $this;
+        }
 
-            return new File(
-                media_path($this->attributes['transcript_file_path']),
-            );
+        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 null;
+        return $this;
     }
 
-    public function getChaptersFile(): ?File
+    public function getTranscript(): ?Transcript
     {
-        if ($this->attributes['chapters_file_path']) {
-            helper('media');
-
-            return new File(
-                media_path($this->attributes['chapters_file_path']),
-            );
+        if ($this->transcript_id !== null && ! $this->transcript instanceof Transcript) {
+            $this->transcript = (new MediaModel('transcript'))->getMediaById($this->transcript_id);
         }
 
-        return null;
+        return $this->transcript;
     }
 
-    public function getAudioFileUrl(): string
+    public function setChapters(UploadedFile | File|null $file = null): self
     {
-        helper('media');
+        if (! $file instanceof File || ($file instanceof UploadedFile && ! $file->isValid())) {
+            return $this;
+        }
 
-        return media_base_url($this->audio_file_path);
-    }
+        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);
 
-    public function getAudioFileAnalyticsUrl(): string
-    {
-        helper('analytics');
-
-        return generate_episode_analytics_url(
-            $this->podcast_id,
-            $this->id,
-            $this->audio_file_path,
-            $this->audio_file_duration,
-            $this->audio_file_size,
-            $this->audio_file_header_size,
-            $this->published_at,
-        );
-    }
+            $this->attributes['chapters_id'] = (new MediaModel('chapters'))->saveMedia($chapters);
+        }
 
-    public function getAudioFileWebUrl(): string
-    {
-        return $this->getAudioFileAnalyticsUrl() . '?_from=-+Website+-';
+        return $this;
     }
 
-    public function getAudioFileOpengraphUrl(): string
+    public function getChapters(): ?Chapters
     {
-        return $this->getAudioFileAnalyticsUrl() . '?_from=-+Open+Graph+-';
+        if ($this->chapters_id !== null && ! $this->chapters instanceof Chapters) {
+            $this->chapters = (new MediaModel('chapters'))->getMediaById($this->chapters_id);
+        }
+
+        return $this->chapters;
     }
 
     /**
-     * Gets transcript url from transcript file uri if it exists
-     * or returns the transcript_file_remote_url which can be null.
+     * Gets transcript url from transcript file uri if it exists or returns the transcript_remote_url which can be null.
      */
-    public function getTranscriptFileUrl(): ?string
+    public function getTranscriptUrl(): ?string
     {
-        if ($this->attributes['transcript_file_path']) {
-            return media_base_url($this->attributes['transcript_file_path']);
-        } else {
-            return $this->attributes['transcript_file_remote_url'];
+        if ($this->transcript instanceof Transcript) {
+            return $this->transcript->file_url;
         }
+
+        return $this->transcript_remote_url;
     }
 
     /**
-     * Gets chapters file url from chapters file uri if it exists
-     * or returns the chapters_file_remote_url which can be null.
+     * 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
     {
-        if ($this->chapters_file_path) {
-            return media_base_url($this->chapters_file_path);
+        if ($this->chapters instanceof Chapters) {
+            return $this->chapters->file_url;
         }
 
-        return $this->chapters_file_remote_url;
+        return $this->chapters_remote_url;
     }
 
     /**
      * Returns the episode's persons
      *
-     * @return EpisodePerson[]
+     * @return Person[]
      */
     public function getPersons(): array
     {
-        if (empty($this->id)) {
-            throw new RuntimeException(
-                'Episode must be created before getting persons.',
-            );
+        if ($this->id === null) {
+            throw new RuntimeException('Episode must be created before getting persons.');
         }
 
-        if (empty($this->persons)) {
-            $this->persons = (new EpisodePersonModel())->getEpisodePersons(
-                $this->podcast_id,
-                $this->id,
-            );
+        if ($this->persons === null) {
+            $this->persons = (new PersonModel())->getEpisodePersons($this->podcast_id, $this->id);
         }
 
         return $this->persons;
     }
 
     /**
-     * Returns the episode’s soundbites
+     * Returns the episode’s clips
      *
      * @return Soundbite[]
      */
     public function getSoundbites(): array
     {
-        if (empty($this->id)) {
-            throw new RuntimeException(
-                'Episode must be created before getting soundbites.',
-            );
+        if ($this->id === null) {
+            throw new RuntimeException('Episode must be created before getting soundbites.');
         }
 
-        if (empty($this->soundbites)) {
-            $this->soundbites = (new SoundbiteModel())->getEpisodeSoundbites(
-                $this->getPodcast()->id,
-                $this->id,
-            );
+        if ($this->soundbites === null) {
+            $this->soundbites = (new ClipModel())->getEpisodeSoundbites($this->getPodcast()->id, $this->id);
         }
 
         return $this->soundbites;
     }
 
     /**
-     * @return Note[]
+     * @return Post[]
      */
-    public function getNotes(): array
+    public function getPosts(): array
     {
-        if (empty($this->id)) {
-            throw new RuntimeException(
-                'Episode must be created before getting soundbites.',
-            );
+        if ($this->id === null) {
+            throw new RuntimeException('Episode must be created before getting posts.');
         }
 
-        if (empty($this->notes)) {
-            $this->notes = (new NoteModel())->getEpisodeNotes($this->id);
+        if ($this->posts === null) {
+            $this->posts = (new PostModel())->getEpisodePosts($this->id);
         }
 
-        return $this->notes;
+        return $this->posts;
     }
 
-    public function getLink(): string
+    /**
+     * @return EpisodeComment[]
+     */
+    public function getComments(): array
     {
-        return base_url(
-            route_to(
-                'episode',
-                $this->getPodcast()->name,
-                $this->attributes['slug'],
-            ),
-        );
+        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 getEmbeddablePlayerUrl($theme = null): string
+    public function getEmbedUrl(?string $theme = null): string
     {
-        return base_url(
-            $theme
-                ? route_to(
-                    'embeddable-player-theme',
-                    $this->getPodcast()->name,
-                    $this->attributes['slug'],
-                    $theme,
-                )
-                : route_to(
-                    'embeddable-player',
-                    $this->getPodcast()->name,
-                    $this->attributes['slug'],
-                ),
-        );
+        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)
+    public function setGuid(?string $guid = null): static
     {
-        if ($guid === null) {
-            $this->attributes['guid'] = $this->getLink();
-        } else {
-            $this->attributes['guid'] = $guid;
-        }
+        $this->attributes['guid'] = $guid ?? $this->link;
 
         return $this;
     }
 
-    public function getPodcast(): Podcast
+    public function getPodcast(): ?Podcast
     {
-        return (new PodcastModel())->getPodcastById(
-            $this->attributes['podcast_id'],
-        );
+        return (new PodcastModel())->getPodcastById($this->podcast_id);
     }
 
-    public function setDescriptionMarkdown(string $descriptionMarkdown)
+    public function setDescriptionMarkdown(string $descriptionMarkdown): static
     {
-        $converter = new CommonMarkConverter([
-            'html_input' => 'strip',
+        $config = [
+            'html_input'         => 'escape',
             'allow_unsafe_links' => false,
-        ]);
+        ];
 
-        $this->attributes['description_markdown'] = $descriptionMarkdown;
-        $this->attributes['description_html'] = $converter->convertToHtml(
-            $descriptionMarkdown,
-        );
+        $environment = new Environment($config);
+        $environment->addExtension(new CommonMarkCoreExtension());
+        $environment->addExtension(new AutolinkExtension());
+        $environment->addExtension(new SmartPunctExtension());
+        $environment->addExtension(new DisallowedRawHtmlExtension());
 
-        return $this;
-    }
+        $converter = new MarkdownConverter($environment);
 
-    public function getDescriptionHtml(?string $serviceSlug = null): string
-    {
-        $descriptionHtml = '';
-        if (
-            $this->getPodcast()->partner_id !== null &&
-            $this->getPodcast()->partner_link_url !== null &&
-            $this->getPodcast()->partner_image_url !== null
-        ) {
-            $descriptionHtml .= "<div><a href=\"{$this->getPartnerLink(
-                $serviceSlug,
-            )}\" rel=\"sponsored noopener noreferrer\" target=\"_blank\"><img src=\"{$this->getPartnerImageUrl(
-                $serviceSlug,
-            )}\" alt=\"Partner image\" /></a></div>";
-        }
-
-        $descriptionHtml .= $this->attributes['description_html'];
-
-        if ($this->getPodcast()->episode_description_footer_html) {
-            $descriptionHtml .= "<footer>{$this->getPodcast()->episode_description_footer_html}</footer>";
-        }
+        $this->attributes['description_markdown'] = $descriptionMarkdown;
+        $this->attributes['description_html'] = $converter->convert($descriptionMarkdown);
 
-        return $descriptionHtml;
+        return $this;
     }
 
     public function getDescription(): string
     {
         if ($this->description === null) {
             $this->description = trim(
-                preg_replace(
-                    '/\s+/',
-                    ' ',
-                    strip_tags($this->attributes['description_html']),
-                ),
+                (string) preg_replace('~\s+~', ' ', strip_tags((string) $this->attributes['description_html'])),
             );
         }
 
@@ -575,47 +504,43 @@ class Episode extends Entity
 
     public function getPublicationStatus(): string
     {
-        if ($this->publication_status) {
-            return $this->publication_status;
-        }
-
-        if (!$this->published_at) {
-            return 'not_published';
-        }
-
-        helper('date');
-        if ($this->published_at->isBefore(Time::now())) {
-            return 'published';
+        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 'scheduled';
+        return $this->publication_status;
     }
 
     /**
      * Saves the location name and fetches OpenStreetMap info
      */
-    public function setLocation(?string $newLocationName = null)
+    public function setLocation(?Location $location = null): static
     {
-        if ($newLocationName === null) {
+        if (! $location instanceof Location) {
             $this->attributes['location_name'] = null;
             $this->attributes['location_geo'] = null;
-            $this->attributes['location_osm_id'] = null;
-        }
-
-        helper('location');
+            $this->attributes['location_osm'] = null;
 
-        $oldLocationName = $this->attributes['location_name'];
+            return $this;
+        }
 
         if (
-            $oldLocationName === null ||
-            $oldLocationName !== $newLocationName
+            ! isset($this->attributes['location_name']) ||
+            $this->attributes['location_name'] !== $location->name
         ) {
-            $this->attributes['location_name'] = $newLocationName;
+            $location->fetchOsmLocation();
 
-            if ($location = fetch_osm_location($newLocationName)) {
-                $this->attributes['location_geo'] = $location['geo'];
-                $this->attributes['location_osm_id'] = $location['osm_id'];
-            }
+            $this->attributes['location_name'] = $location->name;
+            $this->attributes['location_geo'] = $location->geo;
+            $this->attributes['location_osm'] = $location->osm;
         }
 
         return $this;
@@ -627,101 +552,36 @@ class Episode extends Entity
             return null;
         }
 
-        if ($this->location === null) {
-            $this->location = new Location([
-                'name' => $this->location_name,
-                'geo' => $this->location_geo,
-                'osm_id' => $this->location_osm_id,
-            ]);
+        if (! $this->location instanceof Location) {
+            $this->location = new Location($this->location_name, $this->location_geo, $this->location_osm);
         }
 
         return $this->location;
     }
 
-    /**
-     * Get custom rss tag as XML String
-     */
-    function getCustomRssString(): string
+    public function getPreviewLink(): string
     {
-        if ($this->custom_rss === null) {
-            return '';
-        }
+        if ($this->preview_id === null) {
+            // generate preview id
+            if (! $previewUUID = (new EpisodeModel())->setEpisodePreviewId($this->id)) {
+                throw new Exception('Could not set episode preview id');
+            }
 
-        helper('rss');
-
-        $xmlNode = (new SimpleRSSElement(
-            '<?xml version="1.0" encoding="utf-8"?><rss xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd" xmlns:podcast="https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md" xmlns:content="http://purl.org/rss/1.0/modules/content/" version="2.0"/>',
-        ))
-            ->addChild('channel')
-            ->addChild('item');
-        array_to_rss(
-            [
-                'elements' => $this->custom_rss,
-            ],
-            $xmlNode,
-        );
+            $this->preview_id = $previewUUID;
+        }
 
-        return str_replace(['<item>', '</item>'], '', $xmlNode->asXML());
+        return url_to('episode-preview', (string) $this->preview_id);
     }
 
     /**
-     * Saves custom rss tag into json
+     * Returns the episode's clip count
      */
-    function setCustomRssString(?string $customRssString = null)
-    {
-        if ($customRssString === null) {
-            return $this;
-        }
-
-        helper('rss');
-        $customRssArray = rss_to_array(
-            simplexml_load_string(
-                '<?xml version="1.0" encoding="utf-8"?><rss xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd" xmlns:podcast="https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md" xmlns:content="http://purl.org/rss/1.0/modules/content/" version="2.0"><channel><item>' .
-                    $customRssString .
-                    '</item></channel></rss>',
-            ),
-        )['elements'][0]['elements'][0];
-
-        if (array_key_exists('elements', $customRssArray)) {
-            $this->attributes['custom_rss'] = json_encode(
-                $customRssArray['elements'],
-            );
-        } else {
-            $this->attributes['custom_rss'] = null;
-        }
-
-        return $this;
-    }
-
-    function getPartnerLink(?string $serviceSlug = null): string
-    {
-        $partnerLink =
-            rtrim($this->getPodcast()->partner_link_url, '/') .
-            '?pid=' .
-            $this->getPodcast()->partner_id .
-            '&guid=' .
-            urlencode($this->attributes['guid']);
-
-        if ($serviceSlug !== null) {
-            $partnerLink .= '&_from=' . $serviceSlug;
-        }
-
-        return $partnerLink;
-    }
-
-    function getPartnerImageUrl($serviceSlug = null): string
+    public function getClipCount(): int|string
     {
-        $partnerImageUrl =
-            rtrim($this->getPodcast()->partner_image_url, '/') .
-            '?pid=' .
-            $this->getPodcast()->partner_id .
-            '&guid=' .
-            urlencode($this->attributes['guid']);
-
-        if ($serviceSlug !== null) {
-            $partnerImageUrl = '&_from=' . $serviceSlug;
+        if ($this->id === null) {
+            throw new RuntimeException('Episode must be created before getting number of video clips.');
         }
 
-        return $partnerImageUrl;
+        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/EpisodePerson.php

-<?php
-
-/**
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-namespace App\Entities;
-
-use CodeIgniter\Entity\Entity;
-use App\Models\PersonModel;
-
-/**
- * @property int $id
- * @property int $podcast_id
- * @property int $episode_id
- * @property int $person_id
- * @property Person $person
- * @property string|null $person_group
- * @property string|null $person_role
- */
-class EpisodePerson extends Entity
-{
-    /**
-     * @var Person
-     */
-    protected $person;
-
-    /**
-     * @var array<string, string>
-     */
-    protected $casts = [
-        'id' => 'integer',
-        'podcast_id' => 'integer',
-        'episode_id' => 'integer',
-        'person_id' => 'integer',
-        'person_group' => '?string',
-        'person_role' => '?string',
-    ];
-
-    public function getPerson(): Person
-    {
-        return (new PersonModel())->getPersonById(
-            $this->attributes['person_id'],
-        );
-    }
-}

app/Entities/Image.php

-<?php
-
-/**
- * @copyright  2021 Podlibre
- * @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\Files\File;
-use Config\Images as ImagesConfig;
-use Config\Services;
-use RuntimeException;
-
-/**
- * @property File|null $file
- * @property string $dirname
- * @property string $filename
- * @property string $extension
- * @property string $mimetype
- * @property string $path
- * @property string $url
- * @property string $thumbnail_path
- * @property string $thumbnail_url
- * @property string $medium_path
- * @property string $medium_url
- * @property string $large_path
- * @property string $large_url
- * @property string $feed_path
- * @property string $feed_url
- * @property string $id3_path
- * @property string $id3_url
- */
-class Image extends Entity
-{
-    /**
-     * @var ImagesConfig
-     */
-    protected $config;
-
-    /**
-     * @var null|File
-     */
-    protected $file;
-
-    /**
-     * @var string
-     */
-    protected $dirname;
-
-    /**
-     * @var string
-     */
-    protected $filename;
-
-    /**
-     * @var string
-     */
-    protected $extension;
-
-    public function __construct(
-        ?File $file,
-        string $path = '',
-        string $mimetype = ''
-    ) {
-        if ($file === null && $path === '') {
-            throw new RuntimeException(
-                'File or path must be set to create an Image.',
-            );
-        }
-
-        $this->config = config('Images');
-
-        $dirname = '';
-        $filename = '';
-        $extension = '';
-
-        if ($file !== null) {
-            $dirname = $file->getPath();
-            $filename = $file->getBasename();
-            $extension = $file->getExtension();
-            $mimetype = $file->getMimeType();
-        }
-
-        if ($path !== '') {
-            [
-                'filename' => $filename,
-                'dirname' => $dirname,
-                'extension' => $extension,
-            ] = pathinfo($path);
-        }
-
-        $this->file = $file;
-        $this->dirname = $dirname;
-        $this->filename = $filename;
-        $this->extension = $extension;
-        $this->mimetype = $mimetype;
-    }
-
-    function getFile(): File
-    {
-        if ($this->file === null) {
-            $this->file = new File($this->path);
-        }
-
-        return $this->file;
-    }
-
-    function getPath(): string
-    {
-        return $this->dirname . '/' . $this->filename . '.' . $this->extension;
-    }
-
-    function getUrl(): string
-    {
-        helper('media');
-
-        return media_base_url($this->path);
-    }
-
-    function getThumbnailPath(): string
-    {
-        return $this->dirname .
-            '/' .
-            $this->filename .
-            $this->config->thumbnailSuffix .
-            '.' .
-            $this->extension;
-    }
-
-    function getThumbnailUrl(): string
-    {
-        helper('media');
-
-        return media_base_url($this->thumbnail_path);
-    }
-
-    function getMediumPath(): string
-    {
-        return $this->dirname .
-            '/' .
-            $this->filename .
-            $this->config->mediumSuffix .
-            '.' .
-            $this->extension;
-    }
-
-    function getMediumUrl(): string
-    {
-        helper('media');
-
-        return media_base_url($this->medium_path);
-    }
-
-    function getLargePath(): string
-    {
-        return $this->dirname .
-            '/' .
-            $this->filename .
-            $this->config->largeSuffix .
-            '.' .
-            $this->extension;
-    }
-
-    function getLargeUrl(): string
-    {
-        helper('media');
-
-        return media_base_url($this->large_path);
-    }
-
-    function getFeedPath(): string
-    {
-        return $this->dirname .
-            '/' .
-            $this->filename .
-            $this->config->feedSuffix .
-            '.' .
-            $this->extension;
-    }
-
-    function getFeedUrl(): string
-    {
-        helper('media');
-
-        return media_base_url($this->feed_path);
-    }
-
-    function getId3Path(): string
-    {
-        return $this->dirname .
-            '/' .
-            $this->filename .
-            $this->config->id3Suffix .
-            '.' .
-            $this->extension;
-    }
-
-    function getId3Url(): string
-    {
-        helper('media');
-
-        return media_base_url($this->id3_path);
-    }
-
-    public function saveImage(string $dirname, string $filename): void
-    {
-        helper('media');
-
-        $this->dirname = $dirname;
-        $this->filename = $filename;
-
-        save_media($this->file, $this->dirname, $this->filename);
-
-        $imageService = Services::image();
-
-        $thumbnailSize = $this->config->thumbnailSize;
-        $mediumSize = $this->config->mediumSize;
-        $largeSize = $this->config->largeSize;
-        $feedSize = $this->config->feedSize;
-        $id3Size = $this->config->id3Size;
-
-        $imageService
-            ->withFile(media_path($this->path))
-            ->resize($thumbnailSize, $thumbnailSize)
-            ->save(media_path($this->thumbnail_path));
-
-        $imageService
-            ->withFile(media_path($this->path))
-            ->resize($mediumSize, $mediumSize)
-            ->save(media_path($this->medium_path));
-
-        $imageService
-            ->withFile(media_path($this->path))
-            ->resize($largeSize, $largeSize)
-            ->save(media_path($this->large_path));
-
-        $imageService
-            ->withFile(media_path($this->path))
-            ->resize($feedSize, $feedSize)
-            ->save(media_path($this->feed_path));
-
-        $imageService
-            ->withFile(media_path($this->path))
-            ->resize($id3Size, $id3Size)
-            ->save(media_path($this->id3_path));
-    }
-}

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/
  */
@@ -20,7 +22,7 @@ class Language extends Entity
      * @var array<string, string>
      */
     protected $casts = [
-        'code' => 'string',
+        'code'        => 'string',
         'native_name' => 'string',
     ];
 }

app/Entities/Like.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 Michalsn\Uuid\UuidEntity;
+
+/**
+ * @property int $actor_id
+ * @property string $comment_id
+ */
+class Like extends UuidEntity
+{
+    /**
+     * @var string[]
+     */
+    protected $uuids = ['comment_id'];
+
+    /**
+     * @var array<string, string>
+     */
+    protected $casts = [
+        'actor_id'   => 'integer',
+        'comment_id' => 'string',
+    ];
+}

app/Entities/Location.php

 <?php
 
+declare(strict_types=1);
+
 /**
- * @copyright  2021 Podlibre
+ * @copyright  2021 Ad Aures
  * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
  * @link       https://castopod.org/
  */
@@ -14,24 +16,52 @@ use CodeIgniter\Entity\Entity;
  * @property string $url
  * @property string $name
  * @property string|null $geo
- * @property string|null $osm_id
+ * @property string|null $osm
+ * @property double|null $latitude
+ * @property double|null $longitude
  */
 class Location extends Entity
 {
-    /**
-     * @var string
-     */
-    const OSM_URL = 'https://www.openstreetmap.org/';
+    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_id !== null) {
+        if ($this->osm !== null) {
             return self::OSM_URL .
-                ['N' => 'node', 'W' => 'way', 'R' => 'relation'][
-                    substr($this->osm_id, 0, 1)
-                ] .
+                [
+                    'N' => 'node',
+                    'W' => 'way',
+                    'R' => 'relation',
+                ][substr($this->osm, 0, 1)] .
                 '/' .
-                substr($this->osm_id, 1);
+                substr($this->osm, 1);
         }
 
         if ($this->geo !== null) {
@@ -42,4 +72,48 @@ class Location extends Entity
 
         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 Podlibre
+ * @copyright  2020 Ad Aures
  * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
  * @link       https://castopod.org/
  */
@@ -10,7 +12,12 @@ namespace App\Entities;
 
 use CodeIgniter\Entity\Entity;
 use CodeIgniter\I18n\Time;
-use League\CommonMark\CommonMarkConverter;
+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
@@ -25,25 +32,19 @@ use League\CommonMark\CommonMarkConverter;
  */
 class Page extends Entity
 {
-    /**
-     * @var string
-     */
-    protected $link;
+    protected string $link;
 
-    /**
-     * @var string
-     */
-    protected $content_html;
+    protected string $content_html;
 
     /**
      * @var array<string, string>
      */
     protected $casts = [
-        'id' => 'integer',
-        'title' => 'string',
-        'slug' => 'string',
+        'id'               => 'integer',
+        'title'            => 'string',
+        'slug'             => 'string',
         'content_markdown' => 'string',
-        'content_html' => 'string',
+        'content_html'     => 'string',
     ];
 
     public function getLink(): string
@@ -51,17 +52,22 @@ class Page extends Entity
         return url_to('page', $this->attributes['slug']);
     }
 
-    public function setContentMarkdown(string $contentMarkdown): self
+    public function setContentMarkdown(string $contentMarkdown): static
     {
-        $converter = new CommonMarkConverter([
-            'html_input' => 'strip',
+        $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->convertToHtml(
-            $contentMarkdown,
-        );
+        $this->attributes['content_html'] = $converter->convert($contentMarkdown);
 
         return $this;
     }

app/Entities/Person.php

 <?php
 
+declare(strict_types=1);
+
 /**
- * @copyright  2021 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 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 Image $image
- * @property string $image_path
- * @property string $image_mimetype
+ * @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 Image
+     * @var object[]|null
      */
-    protected $image;
+    protected ?array $roles = null;
 
     /**
      * @var array<string, string>
      */
     protected $casts = [
-        'id' => 'integer',
-        'full_name' => 'string',
-        'unique_name' => 'string',
+        'id'              => 'integer',
+        'full_name'       => 'string',
+        'unique_name'     => 'string',
         'information_url' => '?string',
-        'image_path' => 'string',
-        'image_mimetype' => 'string',
-        'created_by' => 'integer',
-        'updated_by' => 'integer',
+        'avatar_id'       => '?int',
+        'podcast_id'      => '?integer',
+        'episode_id'      => '?integer',
+        'created_by'      => 'integer',
+        'updated_by'      => 'integer',
     ];
 
     /**
-     * Saves a picture in `public/media/persons/`
+     * Saves the person avatar in `public/media/persons/`
      */
-    public function setImage(Image $image): self
+    public function setAvatar(UploadedFile | File|null $file = null): static
     {
-        helper('media');
+        if (! $file instanceof File || ($file instanceof UploadedFile && ! $file->isValid())) {
+            return $this;
+        }
 
-        // Save image
-        $image->saveImage('persons', $this->attributes['unique_name']);
+        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['image_mimetype'] = $image->mimetype;
-        $this->attributes['image_path'] = $image->path;
+            $this->attributes['avatar_id'] = (new MediaModel('image'))->saveMedia($avatar);
+        }
 
         return $this;
     }
 
-    public function getImage(): Image
+    public function getAvatar(): ?Image
     {
-        return new Image(
-            null,
-            $this->attributes['image_path'],
-            $this->attributes['image_mimetype'],
-        );
+        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\Libraries\SimpleRSSElement;
+use App\Models\ActorModel;
 use App\Models\CategoryModel;
 use App\Models\EpisodeModel;
-use App\Models\PlatformModel;
-use App\Models\PodcastPersonModel;
+use App\Models\PersonModel;
 use CodeIgniter\Entity\Entity;
-use App\Models\UserModel;
+use CodeIgniter\Files\File;
+use CodeIgniter\HTTP\Files\UploadedFile;
 use CodeIgniter\I18n\Time;
-use League\CommonMark\CommonMarkConverter;
+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 $actor
- * @property string $name
+ * @property Actor|null $actor
+ * @property string $handle
+ * @property string $at_handle
  * @property string $link
  * @property string $feed_url
  * @property string $title
- * @property string $description Holds text only description, striped of any markdown or html special characters
+ * @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 Image $image
- * @property string $image_path
- * @property string $image_mimetype
+ * @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 $category
+ * @property Category|null $category
  * @property int[] $other_categories_ids
  * @property Category[] $other_categories
  * @property string|null $parental_advisory
@@ -44,197 +63,250 @@ use RuntimeException;
  * @property string $owner_email
  * @property string $type
  * @property string|null $copyright
- * @property string|null $episode_description_footer_markdown
- * @property string|null $episode_description_footer_html
  * @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 $location
+ * @property Location|null $location
  * @property string|null $location_name
  * @property string|null $location_geo
- * @property string|null $location_osm_id
- * @property string|null $payment_pointer
- * @property array|null $custom_rss
- * @property string $custom_rss_string
- * @property string|null $partner_id
- * @property string|null $partner_link_url
- * @property string|null $partner_image_url
+ * @property string|null $location_osm
+ * @property bool $is_published_on_hubs
  * @property int $created_by
  * @property int $updated_by
- * @property Time $created_at;
- * @property Time $updated_at;
- * @property Time|null $deleted_at;
+ * @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 PodcastPerson[] $persons
+ * @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
 {
-    /**
-     * @var string
-     */
-    protected $link;
+    protected string $link;
 
-    /**
-     * @var Actor
-     */
-    protected $actor;
+    protected string $at_handle;
 
-    /**
-     * @var Image
-     */
-    protected $image;
+    protected ?Actor $actor = null;
 
-    /**
-     * @var string
-     */
-    protected $description;
+    protected ?Image $cover = null;
 
-    /**
-     * @var Category
-     */
-    protected $category;
+    protected ?Image $banner = null;
+
+    protected ?string $description = null;
+
+    protected ?Category $category = null;
 
     /**
-     * @var Category[]
+     * @var Category[]|null
      */
-    protected $other_categories;
+    protected ?array $other_categories = null;
 
     /**
-     * @var string[]
+     * @var int[]
      */
-    protected $other_categories_ids;
+    protected array $other_categories_ids = [];
 
     /**
-     * @var Episode[]
+     * @var Episode[]|null
      */
-    protected $episodes;
+    protected ?array $episodes = null;
 
     /**
-     * @var PodcastPerson[]
+     * @var Person[]|null
      */
-    protected $persons;
+    protected ?array $persons = null;
 
     /**
-     * @var User[]
+     * @var User[]|null
      */
-    protected $contributors;
+    protected ?array $contributors = null;
 
     /**
-     * @var Platform[]
+     * @var Subscription[]|null
      */
-    protected $podcasting_platforms;
+    protected ?array $subscriptions = null;
 
     /**
-     * @var Platform[]
+     * @var Platform[]|null
      */
-    protected $social_platforms;
+    protected ?array $podcasting_platforms = null;
 
     /**
-     * @var Platform[]
+     * @var Platform[]|null
      */
-    protected $funding_platforms;
+    protected ?array $social_platforms = null;
 
     /**
-     * @var Location|null
+     * @var Platform[]|null
      */
-    protected $location;
+    protected ?array $funding_platforms = null;
+
+    protected ?Location $location = null;
+
+    protected ?string $publication_status = null;
 
     /**
-     * @var string
+     * @var array<int, string>
+     * @phpstan-var list<string>
      */
-    protected $custom_rss_string;
+    protected $dates = ['published_at', 'created_at', 'updated_at'];
 
     /**
      * @var array<string, string>
      */
     protected $casts = [
-        'id' => 'integer',
-        'actor_id' => 'integer',
-        'name' => 'string',
-        'title' => 'string',
-        'description_markdown' => 'string',
-        'description_html' => 'string',
-        'image_path' => 'string',
-        'image_mimetype' => 'string',
-        'language_code' => 'string',
-        'category_id' => 'integer',
-        'parental_advisory' => '?string',
-        'publisher' => '?string',
-        'owner_name' => 'string',
-        'owner_email' => 'string',
-        'type' => 'string',
-        'copyright' => '?string',
-        'episode_description_footer_markdown' => '?string',
-        'episode_description_footer_html' => '?string',
-        'is_blocked' => 'boolean',
-        'is_completed' => 'boolean',
-        'is_locked' => 'boolean',
-        'imported_feed_url' => '?string',
-        'new_feed_url' => '?string',
-        'location_name' => '?string',
-        'location_geo' => '?string',
-        'location_osm_id' => '?string',
-        'payment_pointer' => '?string',
-        'custom_rss' => '?json-array',
-        'partner_id' => '?string',
-        'partner_link_url' => '?string',
-        'partner_image_url' => '?string',
-        'created_by' => 'integer',
-        'updated_by' => 'integer',
+        '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 getActor(): Actor
+    public function getAtHandle(): string
     {
-        if (!$this->actor_id) {
-            throw new RuntimeException(
-                'Podcast must have an actor_id before getting actor.',
-            );
+        return '@' . $this->handle;
+    }
+
+    public function getActor(): ?Actor
+    {
+        if ($this->actor_id === 0) {
+            throw new RuntimeException('Podcast must have an actor_id before getting actor.');
         }
 
-        if ($this->actor === null) {
-            $this->actor = model('ActorModel')->getActorById($this->actor_id);
+        if (! $this->actor instanceof Actor) {
+            $this->actor = model(ActorModel::class, false)
+                ->getActorById($this->actor_id);
         }
 
         return $this->actor;
     }
 
-    /**
-     * Saves a cover image to the corresponding podcast folder in `public/media/podcast_name/`
-     *
-     * @param Image $image
-     */
-    public function setImage($image): self
+    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
     {
-        // Save image
-        $image->saveImage('podcasts/' . $this->attributes['name'], 'cover');
+        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['image_mimetype'] = $image->mimetype;
-        $this->attributes['image_path'] = $image->path;
+            $this->attributes['banner_id'] = (new MediaModel('image'))->saveMedia($banner);
+        }
 
         return $this;
     }
 
-    public function getImage(): Image
+    public function getBanner(): ?Image
     {
-        return new Image(null, $this->image_path, $this->image_mimetype);
+        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['name']);
+        return url_to('podcast-activity', $this->attributes['handle']);
     }
 
     public function getFeedUrl(): string
     {
-        return url_to('podcast_feed', $this->attributes['name']);
+        return url_to('podcast-rss-feed', $this->attributes['handle']);
     }
 
     /**
@@ -244,39 +316,42 @@ class Podcast extends Entity
      */
     public function getEpisodes(): array
     {
-        if (empty($this->id)) {
-            throw new RuntimeException(
-                'Podcast must be created before getting episodes.',
-            );
+        if ($this->id === null) {
+            throw new RuntimeException('Podcast must be created before getting episodes.');
         }
 
-        if (empty($this->episodes)) {
-            $this->episodes = (new EpisodeModel())->getPodcastEpisodes(
-                $this->id,
-                $this->type,
-            );
+        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 PodcastPerson[]
+     * @return Person[]
      */
     public function getPersons(): array
     {
-        if (empty($this->id)) {
-            throw new RuntimeException(
-                'Podcast must be created before getting persons.',
-            );
+        if ($this->id === null) {
+            throw new RuntimeException('Podcast must be created before getting persons.');
         }
 
-        if (empty($this->persons)) {
-            $this->persons = (new PodcastPersonModel())->getPodcastPersons(
-                $this->id,
-            );
+        if ($this->persons === null) {
+            $this->persons = (new PersonModel())->getPodcastPersons($this->id);
         }
 
         return $this->persons;
@@ -284,26 +359,38 @@ class Podcast extends Entity
 
     /**
      * Returns the podcast category entity
-     *
-     * @return Category
      */
-    public function getCategory(): Category
+    public function getCategory(): ?Category
     {
-        if (empty($this->id)) {
-            throw new RuntimeException(
-                'Podcast must be created before getting category.',
-            );
+        if ($this->id === null) {
+            throw new RuntimeException('Podcast must be created before getting category.');
         }
 
-        if (empty($this->category)) {
-            $this->category = (new CategoryModel())->getCategoryById(
-                $this->category_id,
-            );
+        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
      *
@@ -311,69 +398,62 @@ class Podcast extends Entity
      */
     public function getContributors(): array
     {
-        if (empty($this->id)) {
-            throw new RuntimeException(
-                'Podcasts must be created before getting contributors.',
-            );
+        if ($this->id === null) {
+            throw new RuntimeException('Podcasts must be created before getting contributors.');
         }
 
-        if (empty($this->contributors)) {
-            $this->contributors = (new UserModel())->getPodcastContributors(
-                $this->id,
-            );
+        if ($this->contributors === null) {
+            $this->contributors = (new UserModel())->getPodcastContributors($this->id);
         }
 
         return $this->contributors;
     }
 
-    public function setDescriptionMarkdown(string $descriptionMarkdown): self
+    public function setDescriptionMarkdown(string $descriptionMarkdown): static
     {
-        $converter = new CommonMarkConverter([
-            'html_input' => 'strip',
+        $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->convertToHtml(
-            $descriptionMarkdown,
-        );
+        $this->attributes['description_html'] = $converter->convert($descriptionMarkdown);
 
         return $this;
     }
 
-    public function setEpisodeDescriptionFooterMarkdown(
-        ?string $episodeDescriptionFooterMarkdown = null
-    ): self {
-        if ($episodeDescriptionFooterMarkdown) {
-            $converter = new CommonMarkConverter([
-                'html_input' => 'strip',
-                'allow_unsafe_links' => false,
-            ]);
-
-            $this->attributes[
-                'episode_description_footer_markdown'
-            ] = $episodeDescriptionFooterMarkdown;
-            $this->attributes[
-                'episode_description_footer_html'
-            ] = $converter->convertToHtml($episodeDescriptionFooterMarkdown);
+    public function getDescription(): string
+    {
+        if ($this->description === null) {
+            $this->description = trim(
+                (string) preg_replace('~\s+~', ' ', strip_tags((string) $this->attributes['description_html'])),
+            );
         }
 
-        return $this;
+        return $this->description;
     }
 
-    public function getDescription(): string
+    public function getPublicationStatus(): string
     {
-        if ($this->description) {
-            return $this->description;
+        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 trim(
-            preg_replace(
-                '/\s+/',
-                ' ',
-                strip_tags($this->attributes['description_html']),
-            ),
-        );
+        return $this->publication_status;
     }
 
     /**
@@ -383,17 +463,12 @@ class Podcast extends Entity
      */
     public function getPodcastingPlatforms(): array
     {
-        if (empty($this->id)) {
-            throw new RuntimeException(
-                'Podcast must be created before getting podcasting platform links.',
-            );
+        if ($this->id === null) {
+            throw new RuntimeException('Podcast must be created before getting podcasting platform links.');
         }
 
-        if (empty($this->podcasting_platforms)) {
-            $this->podcasting_platforms = (new PlatformModel())->getPodcastPlatforms(
-                $this->id,
-                'podcasting',
-            );
+        if ($this->podcasting_platforms === null) {
+            $this->podcasting_platforms = (new PlatformModel())->getPlatforms($this->id, 'podcasting');
         }
 
         return $this->podcasting_platforms;
@@ -406,17 +481,12 @@ class Podcast extends Entity
      */
     public function getSocialPlatforms(): array
     {
-        if (empty($this->id)) {
-            throw new RuntimeException(
-                'Podcast must be created before getting social platform links.',
-            );
+        if ($this->id === null) {
+            throw new RuntimeException('Podcast must be created before getting social platform links.');
         }
 
-        if (empty($this->social_platforms)) {
-            $this->social_platforms = (new PlatformModel())->getPodcastPlatforms(
-                $this->id,
-                'social',
-            );
+        if ($this->social_platforms === null) {
+            $this->social_platforms = (new PlatformModel())->getPlatforms($this->id, 'social');
         }
 
         return $this->social_platforms;
@@ -429,17 +499,12 @@ class Podcast extends Entity
      */
     public function getFundingPlatforms(): array
     {
-        if (empty($this->id)) {
-            throw new RuntimeException(
-                'Podcast must be created before getting funding platform links.',
-            );
+        if ($this->id === null) {
+            throw new RuntimeException('Podcast must be created before getting funding platform links.');
         }
 
-        if (empty($this->funding_platforms)) {
-            $this->funding_platforms = (new PlatformModel())->getPodcastPlatforms(
-                $this->id,
-                'funding',
-            );
+        if ($this->funding_platforms === null) {
+            $this->funding_platforms = (new PlatformModel())->getPlatforms($this->id, 'funding');
         }
 
         return $this->funding_platforms;
@@ -450,31 +515,24 @@ class Podcast extends Entity
      */
     public function getOtherCategories(): array
     {
-        if (empty($this->id)) {
-            throw new RuntimeException(
-                'Podcast must be created before getting other categories.',
-            );
+        if ($this->id === null) {
+            throw new RuntimeException('Podcast must be created before getting other categories.');
         }
 
-        if (empty($this->other_categories)) {
-            $this->other_categories = (new CategoryModel())->getPodcastCategories(
-                $this->id,
-            );
+        if ($this->other_categories === null) {
+            $this->other_categories = (new CategoryModel())->getPodcastCategories($this->id);
         }
 
         return $this->other_categories;
     }
 
     /**
-     * @return array<int>
+     * @return int[]
      */
     public function getOtherCategoriesIds(): array
     {
-        if (empty($this->other_categories_ids)) {
-            $this->other_categories_ids = array_column(
-                $this->getOtherCategories(),
-                'id',
-            );
+        if ($this->other_categories_ids === []) {
+            $this->other_categories_ids = array_column($this->getOtherCategories(), 'id');
         }
 
         return $this->other_categories_ids;
@@ -483,28 +541,25 @@ class Podcast extends Entity
     /**
      * Saves the location name and fetches OpenStreetMap info
      */
-    public function setLocation(?string $newLocationName = null)
+    public function setLocation(?Location $location = null): static
     {
-        if ($newLocationName === null) {
+        if (! $location instanceof Location) {
             $this->attributes['location_name'] = null;
             $this->attributes['location_geo'] = null;
-            $this->attributes['location_osm_id'] = null;
-        }
+            $this->attributes['location_osm'] = null;
 
-        helper('location');
-
-        $oldLocationName = $this->attributes['location_name'];
+            return $this;
+        }
 
         if (
-            $oldLocationName === null ||
-            $oldLocationName !== $newLocationName
+            ! isset($this->attributes['location_name']) ||
+            $this->attributes['location_name'] !== $location->name
         ) {
-            $this->attributes['location_name'] = $newLocationName;
+            $location->fetchOsmLocation();
 
-            if ($location = fetch_osm_location($newLocationName)) {
-                $this->attributes['location_geo'] = $location['geo'];
-                $this->attributes['location_osm_id'] = $location['osm_id'];
-            }
+            $this->attributes['location_name'] = $location->name;
+            $this->attributes['location_geo'] = $location->geo;
+            $this->attributes['location_osm'] = $location->osm;
         }
 
         return $this;
@@ -516,71 +571,16 @@ class Podcast extends Entity
             return null;
         }
 
-        if ($this->location === null) {
-            $this->location = new Location([
-                'name' => $this->location_name,
-                'geo' => $this->location_geo,
-                'osm_id' => $this->location_osm_id,
-            ]);
+        if (! $this->location instanceof Location) {
+            $this->location = new Location($this->location_name, $this->location_geo, $this->location_osm);
         }
 
         return $this->location;
     }
 
-    /**
-     * Get custom rss tag as XML String
-     *
-     * @return string
-     */
-    function getCustomRssString(): string
+    public function getIsPremium(): bool
     {
-        if (empty($this->attributes['custom_rss'])) {
-            return '';
-        }
-
-        helper('rss');
-
-        $xmlNode = (new SimpleRSSElement(
-            '<?xml version="1.0" encoding="utf-8"?><rss xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd" xmlns:podcast="https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md" xmlns:content="http://purl.org/rss/1.0/modules/content/" version="2.0"/>',
-        ))->addChild('channel');
-        array_to_rss(
-            [
-                'elements' => $this->custom_rss,
-            ],
-            $xmlNode,
-        );
-
-        return str_replace(['<channel>', '</channel>'], '', $xmlNode->asXML());
-    }
-
-    /**
-     * Saves custom rss tag into json
-     *
-     * @param string $customRssString
-     */
-    function setCustomRssString($customRssString): self
-    {
-        if (empty($customRssString)) {
-            return $this;
-        }
-
-        helper('rss');
-        $customRssArray = rss_to_array(
-            simplexml_load_string(
-                '<?xml version="1.0" encoding="utf-8"?><rss xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd" xmlns:podcast="https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md" xmlns:content="http://purl.org/rss/1.0/modules/content/" version="2.0"><channel>' .
-                    $customRssString .
-                    '</channel></rss>',
-            ),
-        )['elements'][0];
-
-        if (array_key_exists('elements', $customRssArray)) {
-            $this->attributes['custom_rss'] = json_encode(
-                $customRssArray['elements'],
-            );
-        } else {
-            $this->attributes['custom_rss'] = null;
-        }
-
-        return $this;
+        // podcast is premium if at least one of its episodes is set as premium
+        return (new EpisodeModel())->doesPodcastHavePremiumEpisodes($this->id);
     }
 }

app/Entities/PodcastPerson.php

-<?php
-
-/**
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-namespace App\Entities;
-
-use CodeIgniter\Entity\Entity;
-use App\Models\PersonModel;
-
-/**
- * @property int $id
- * @property int $podcast_id
- * @property int $person_id
- * @property Person $person
- * @property string|null $person_group
- * @property string|null $person_role
- */
-class PodcastPerson extends Entity
-{
-    /**
-     * @var Person
-     */
-    protected $person;
-
-    /**
-     * @var array<string, string>
-     */
-    protected $casts = [
-        'id' => 'integer',
-        'podcast_id' => 'integer',
-        'person_id' => 'integer',
-        'person_group' => '?string',
-        'person_role' => '?string',
-    ];
-
-    public function getPerson(): ?Person
-    {
-        return (new PersonModel())->getPersonById(
-            $this->attributes['person_id'],
-        );
-    }
-}

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

app/Entities/Soundbite.php

-<?php
-
-/**
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-namespace App\Entities;
-
-use CodeIgniter\Entity\Entity;
-
-/**
- * @property int $id
- * @property int $podcast_id
- * @property int $episode_id
- * @property double $start_time
- * @property double $duration
- * @property string|null $label
- * @property int $created_by
- * @property int $updated_by
- */
-class Soundbite extends Entity
-{
-    /**
-     * @var array<string, string>
-     */
-    protected $casts = [
-        'id' => 'integer',
-        'podcast_id' => 'integer',
-        'episode_id' => 'integer',
-        'start_time' => 'double',
-        'duration' => 'double',
-        'label' => '?string',
-        'created_by' => 'integer',
-        'updated_by' => 'integer',
-    ];
-}

app/Entities/User.php

-<?php
-
-/**
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-namespace App\Entities;
-
-use RuntimeException;
-use App\Models\PodcastModel;
-use Myth\Auth\Entities\User as MythAuthUser;
-
-/**
- * @property int $id
- * @property string $username
- * @property string $email
- * @property string $password
- * @property bool $active
- * @property bool $force_pass_reset
- * @property int|null $podcast_id
- * @property string|null $podcast_role
- *
- * @property Podcast[] $podcasts All podcasts the user is contributing to
- */
-class User extends MythAuthUser
-{
-    /**
-     * @var Podcast[]
-     */
-    protected $podcasts = [];
-
-    /**
-     * Array of field names and the type of value to cast them as
-     * when they are accessed.
-     *
-     * @var array<string, string>
-     */
-    protected $casts = [
-        'id' => 'integer',
-        'active' => 'boolean',
-        'force_pass_reset' => 'boolean',
-        'podcast_id' => '?integer',
-        'podcast_role' => '?string',
-    ];
-
-    /**
-     * Returns the podcasts the user is contributing to
-     *
-     * @return Podcast[]
-     */
-    public function getPodcasts(): array
-    {
-        if ($this->id === null) {
-            throw new RuntimeException(
-                'Users must be created before getting podcasts.',
-            );
-        }
-
-        if ($this->podcasts === null) {
-            $this->podcasts = (new PodcastModel())->getUserPodcasts($this->id);
-        }
-
-        return $this->podcasts;
-    }
-}

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/Filters/PermissionFilter.php

-<?php
-
-namespace App\Filters;
-
-use App\Models\PodcastModel;
-use Config\Services;
-use CodeIgniter\HTTP\RequestInterface;
-use CodeIgniter\HTTP\ResponseInterface;
-use CodeIgniter\Filters\FilterInterface;
-use Myth\Auth\Exceptions\PermissionException;
-
-class PermissionFilter implements FilterInterface
-{
-    /**
-     * Do whatever processing this filter needs to do.
-     * By default it should not return anything during
-     * normal execution. However, when an abnormal state
-     * is found, it should return an instance of
-     * CodeIgniter\HTTP\Response. If it does, script
-     * execution will end and that Response will be
-     * sent back to the client, allowing for error pages,
-     * redirects, etc.
-     *
-     * @param array|null                         $params
-     * @return void|mixed
-     */
-    public function before(RequestInterface $request, $params = null)
-    {
-        helper('auth');
-
-        if (empty($params)) {
-            return;
-        }
-
-        $authenticate = Services::authentication();
-
-        // if no user is logged in then send to the login form
-        if (!$authenticate->check()) {
-            session()->set('redirect_url', current_url());
-            return redirect('login');
-        }
-
-        helper('misc');
-        $authorize = Services::authorization();
-        $router = Services::router();
-        $routerParams = $router->params();
-        $result = false;
-
-        // Check if user has at least one of the permissions
-        foreach ($params as $permission) {
-            // check if permission is for a specific podcast
-            if (
-                (startsWith($permission, 'podcast-') ||
-                    startsWith($permission, 'podcast_episodes-')) &&
-                count($routerParams) > 0
-            ) {
-                if (
-                    ($groupId = (new PodcastModel())->getContributorGroupId(
-                        $authenticate->id(),
-                        $routerParams[0],
-                    )) &&
-                    $authorize->groupHasPermission($permission, $groupId)
-                ) {
-                    $result = true;
-                    break;
-                }
-            } elseif (
-                $authorize->hasPermission($permission, $authenticate->id())
-            ) {
-                $result = true;
-                break;
-            }
-        }
-
-        if (!$result) {
-            if ($authenticate->silent()) {
-                $redirectURL = session('redirect_url') ?? '/';
-                unset($_SESSION['redirect_url']);
-                return redirect()
-                    ->to($redirectURL)
-                    ->with('error', lang('Auth.notEnoughPrivilege'));
-            }
-            throw new PermissionException(lang('Auth.notEnoughPrivilege'));
-        }
-    }
-
-    //--------------------------------------------------------------------
-    /**
-     * Allows After filters to inspect and modify the response
-     * object as needed. This method does not allow any way
-     * to stop execution of other after filters, short of
-     * throwing an Exception or Error.
-     *
-     * @param array|null                          $arguments
-     */
-    public function after(
-        RequestInterface $request,
-        ResponseInterface $response,
-        $arguments = null
-    ): void {
-    }
-
-    //--------------------------------------------------------------------
-}

app/Helpers/auth_helper.php

-<?php
-
-/**
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-use ActivityPub\Entities\Actor;
-use App\Entities\User;
-use CodeIgniter\Database\Exceptions\DataException;
-use Config\Services;
-
-if (!function_exists('user')) {
-    /**
-     * Returns the User instance for the current logged in user.
-     */
-    function user(): ?User
-    {
-        $authenticate = Services::authentication();
-        $authenticate->check();
-        return $authenticate->user();
-    }
-}
-
-if (!function_exists('set_interact_as_actor')) {
-    /**
-     * Sets the actor id of which the user is acting as
-     */
-    function set_interact_as_actor($actorId): void
-    {
-        $authenticate = Services::authentication();
-        $authenticate->check();
-
-        $session = session();
-        $session->set('interact_as_actor_id', $actorId);
-    }
-}
-
-if (!function_exists('remove_interact_as_actor')) {
-    /**
-     * Removes the actor id of which the user is acting as
-     */
-    function remove_interact_as_actor(): void
-    {
-        $session = session();
-        $session->remove('interact_as_actor_id');
-    }
-}
-
-if (!function_exists('interact_as_actor_id')) {
-    /**
-     * Sets the podcast id of which the user is acting as
-     */
-    function interact_as_actor_id(): int
-    {
-        $authenticate = Services::authentication();
-        $authenticate->check();
-
-        $session = session();
-        return $session->get('interact_as_actor_id');
-    }
-}
-
-if (!function_exists('interact_as_actor')) {
-    /**
-     * Get the actor the user is currently interacting as
-     *
-     * @return Actor|false
-     */
-    function interact_as_actor()
-    {
-        $authenticate = Services::authentication();
-        $authenticate->check();
-
-        $session = session();
-        if ($session->has('interact_as_actor_id')) {
-            return model('ActorModel')->getActorById(
-                $session->get('interact_as_actor_id'),
-            );
-        }
-
-        return false;
-    }
-}
-
-if (!function_exists('can_user_interact')) {
-    /**
-     * @throws DataException
-     */
-    function can_user_interact(): bool
-    {
-        return (bool) interact_as_actor();
-    }
-}

app/Helpers/breadcrumb_helper.php

 <?php
 
-/**
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
+declare(strict_types=1);
 
-use Config\Services;
-
-if (!function_exists('render_breadcrumb')) {
+if (! function_exists('render_breadcrumb')) {
     /**
      * Renders the breadcrumb navigation through the Breadcrumb service
      *
-     * @param  string $class to be added to the breadcrumb nav
+     * @param string|null $class to be added to the breadcrumb nav
      * @return string html breadcrumb
      */
-    function render_breadcrumb(string $class = null): string
+    function render_breadcrumb(?string $class = null): string
     {
-        $breadcrumb = Services::breadcrumb();
-        return $breadcrumb->render($class);
+        return service('breadcrumb')->render($class);
     }
 }
 
-if (!function_exists('replace_breadcrumb_params')) {
-    function replace_breadcrumb_params($newParams): void
+if (! function_exists('replace_breadcrumb_params')) {
+    /**
+     * @param array<string|int,string> $newParams
+     */
+    function replace_breadcrumb_params(array $newParams): void
     {
-        $breadcrumb = Services::breadcrumb();
-        $breadcrumb->replaceParams($newParams);
+        service('breadcrumb')->replaceParams($newParams);
     }
 }

app/Helpers/components_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 App\Entities\Category;
+use App\Entities\Episode;
 use App\Entities\Location;
-use CodeIgniter\View\Table;
 use CodeIgniter\I18n\Time;
-
-if (!function_exists('button')) {
-    /**
-     * Button component
-     *
-     * Creates a stylized button or button like anchor tag if the URL is defined.
-     *
-     * @param array  $customOptions button options: variant, size, iconLeft, iconRight
-     * @param array  $customAttributes Additional attributes
-     *
-     * @return string
-     */
-    function button(
-        string $label = '',
-        string $uri = '',
-        array $customOptions = [],
-        array $customAttributes = []
-    ): string {
-        $defaultOptions = [
-            'variant' => 'default',
-            'size' => 'base',
-            'iconLeft' => null,
-            'iconRight' => null,
-            'isSquared' => false,
-        ];
-        $options = array_merge($defaultOptions, $customOptions);
-
-        $baseClass =
-            'inline-flex items-center font-semibold shadow-xs rounded-full focus:outline-none focus:ring';
-
-        $variantClass = [
-            'default' => 'text-black bg-gray-300 hover:bg-gray-400',
-            'primary' => 'text-white bg-pine-700 hover:bg-pine-800',
-            'secondary' => 'text-white bg-gray-700 hover:bg-gray-800',
-            'accent' => 'text-white bg-rose-600 hover:bg-rose-800',
-            'success' => 'text-white bg-green-600 hover:bg-green-700',
-            'danger' => 'text-white bg-red-600 hover:bg-red-700',
-            'warning' => 'text-black bg-yellow-500 hover:bg-yellow-600',
-            'info' => 'text-white bg-blue-500 hover:bg-blue-600',
-        ];
-
-        $sizeClass = [
-            'small' => 'text-xs md:text-sm',
-            'base' => 'text-sm md:text-base',
-            'large' => 'text-lg md:text-xl',
-        ];
-
-        $basePaddings = [
-            'small' => 'px-2 md:px-3 md:py-1',
-            'base' => 'px-3 py-1 md:px-4 md:py-2',
-            'large' => 'px-3 py-2 md:px-5',
-        ];
-
-        $squaredPaddings = [
-            'small' => 'p-1',
-            'base' => 'p-2',
-            'large' => 'p-3',
-        ];
-
-        $buttonClass =
-            $baseClass .
-            ' ' .
-            ($options['isSquared']
-                ? $squaredPaddings[$options['size']]
-                : $basePaddings[$options['size']]) .
-            ' ' .
-            $sizeClass[$options['size']] .
-            ' ' .
-            $variantClass[$options['variant']];
-
-        if (!empty($customAttributes['class'])) {
-            $buttonClass .= ' ' . $customAttributes['class'];
-            unset($customAttributes['class']);
-        }
-
-        if ($options['iconLeft']) {
-            $label = icon($options['iconLeft'], 'mr-2') . $label;
-        }
-
-        if ($options['iconRight']) {
-            $label .= icon($options['iconRight'], 'ml-2');
-        }
-
-        if ($uri !== '') {
-            return anchor(
-                $uri,
-                $label,
-                array_merge(
-                    [
-                        'class' => $buttonClass,
-                    ],
-                    $customAttributes,
-                ),
-            );
-        }
-
-        $defaultButtonAttributes = [
-            'type' => 'button',
-        ];
-        $attributes = stringify_attributes(
-            array_merge($defaultButtonAttributes, $customAttributes),
-        );
-
-        return <<<HTML
-            <button class="{$buttonClass}" {$attributes}>
-            {$label}
-            </button>
-        HTML;
-    }
-}
-
-// ------------------------------------------------------------------------
-
-if (!function_exists('icon_button')) {
-    /**
-     * Icon Button component
-     *
-     * Abstracts the `button()` helper to create a stylized icon button
-     *
-     * @param string $icon The button icon
-     * @param string $title The button label
-     * @param array  $customOptions button options: variant, size, iconLeft, iconRight
-     * @param array  $customAttributes Additional attributes
-     *
-     * @return string
-     */
-    function icon_button(
-        string $icon,
-        string $title,
-        string $uri = '',
-        array $customOptions = [],
-        array $customAttributes = []
-    ): string {
-        $defaultOptions = [
-            'isSquared' => true,
-        ];
-        $options = array_merge($defaultOptions, $customOptions);
-
-        $defaultAttributes = [
-            'title' => $title,
-            'data-toggle' => 'tooltip',
-            'data-placement' => 'bottom',
-        ];
-        $attributes = array_merge($defaultAttributes, $customAttributes);
-
-        return button(icon($icon), $uri, $options, $attributes);
-    }
-}
-
-// ------------------------------------------------------------------------
-
-if (!function_exists('hint_tooltip')) {
-    /**
-     * Hint component
-     *
-     * Used to produce tooltip with a question mark icon for hint texts
-     *
-     * @param string $hintText The hint text
-     *
-     * @return string
-     */
-    function hint_tooltip(string $hintText = '', string $class = ''): string
-    {
-        $tooltip =
-            '<span data-toggle="tooltip" data-placement="bottom" tabindex="0" title="' .
-            $hintText .
-            '" class="inline-block text-gray-500 align-middle outline-none focus:ring';
-
-        if ($class !== '') {
-            $tooltip .= ' ' . $class;
-        }
-
-        return $tooltip . '">' . icon('question') . '</span>';
-    }
-}
+use CodeIgniter\View\Table;
 
 // ------------------------------------------------------------------------
 
-if (!function_exists('data_table')) {
+if (! function_exists('data_table')) {
     /**
      * Data table component
      *
      * Creates a stylized table.
      *
-     * @param array     $columns array of associate arrays with `header` and `cell` keys where `cell` is a function with a row of $data as parameter
-     * @param array     $data data to loop through and display in rows
-     * @param array     ...$rest Any other argument to pass to the `cell` function
-     *
-     * @return string
+     * @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 = [], ...$rest): string
+    function data_table(array $columns, array $data = [], string $class = '', mixed ...$rest): string
     {
         $table = new Table();
 
         $template = [
-            'table_open' => '<table class="w-full whitespace-no-wrap">',
+            'table_open' => '<table class="w-full whitespace-nowrap">',
 
-            'thead_open' =>
-                '<thead class="text-xs font-semibold text-left text-gray-500 uppercase border-b">',
+            '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">',
+            'cell_start'         => '<td class="px-4 py-2">',
+            'cell_alt_start'     => '<td class="px-4 py-2">',
 
-            'row_start' => '<tr class="bg-gray-100 hover:bg-pine-100">',
-            'row_alt_start' => '<tr class="hover:bg-pine-100">',
+            '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);
@@ -233,13 +59,20 @@ if (!function_exists('data_table')) {
                 foreach ($columns as $column) {
                     $rowData[] = $column['cell']($row, ...$rest);
                 }
+
                 $table->addRow($rowData);
             }
         } else {
-            return lang('Common.no_data');
+            $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 bg-white rounded-lg shadow" >' .
+        return '<div class="overflow-x-auto rounded-lg bg-elevated border-3 border-subtle ' . $class . '" >' .
             $table->generate() .
             '</div>';
     }
@@ -247,91 +80,69 @@ if (!function_exists('data_table')) {
 
 // ------------------------------------------------------------------------
 
-if (!function_exists('publication_pill')) {
+if (! function_exists('publication_pill')) {
     /**
      * Publication pill component
      *
      * Shows the stylized publication datetime in regards to current datetime.
-     *
-     * @return string
      */
-    function publication_pill(
-        ?Time $publicationDate,
-        string $publicationStatus,
-        string $customClass = ''
-    ): string {
-        if ($publicationDate === null) {
-            return '';
-        }
-
-        $class =
-            $publicationStatus === 'published'
-                ? 'text-pine-500 border-pine-500'
-                : 'text-red-600 border-red-600';
-
-        $langOptions = [
-            '<time pubdate datetime="' .
-            $publicationDate->format(DateTime::ATOM) .
-            '" title="' .
-            $publicationDate .
-            '">' .
-            lang('Common.mediumDate', [$publicationDate]) .
-            '</time>',
-        ];
-
-        $label = lang(
-            'Episode.publication_status.' . $publicationStatus,
-            $langOptions,
-        );
-
-        return '<span class="px-1 font-semibold border ' .
-            $class .
-            ' ' .
-            $customClass .
-            '">' .
-            $label .
-            '</span>';
+    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')) {
+if (! function_exists('publication_button')) {
     /**
-     * Publication button component
-     *
-     * Displays the appropriate publication button depending on the publication status.
+     * Publication button component for episodes
      *
-     * @param boolean   $publicationStatus the episode's publication status     *
-     * @return string
+     * Displays the appropriate publication button depending on the publication post.
      */
-    function publication_button(
-        int $podcastId,
-        int $episodeId,
-        bool $publicationStatus
-    ): string {
+    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';
+                $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 = 'accent';
-                $iconLeft = 'upload-cloud';
+                $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';
+                $iconLeft = 'cloud-off-fill'; // @icon("cloud-off-fill")
                 break;
             default:
                 $label = '';
@@ -341,16 +152,112 @@ if (!function_exists('publication_button')) {
                 break;
         }
 
-        return button($label, $route, [
-            'variant' => $variant,
-            'iconLeft' => $iconLeft,
+        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')) {
+if (! function_exists('episode_numbering')) {
     /**
      * Returns relevant translated episode numbering.
      *
@@ -360,20 +267,20 @@ if (!function_exists('episode_numbering')) {
         ?int $episodeNumber = null,
         ?int $seasonNumber = null,
         string $class = '',
-        bool $isAbbr = false
+        bool $isAbbr = false,
     ): string {
-        if (!$episodeNumber && !$seasonNumber) {
+        if (! $episodeNumber && ! $seasonNumber) {
             return '';
         }
 
         $transKey = '';
         $args = [];
         if ($episodeNumber !== null) {
-            $args['episodeNumber'] = $episodeNumber;
+            $args['episodeNumber'] = sprintf('%02d', $episodeNumber);
         }
 
         if ($seasonNumber !== null) {
-            $args['seasonNumber'] = $seasonNumber;
+            $args['seasonNumber'] = sprintf('%02d', $seasonNumber);
         }
 
         if ($episodeNumber !== null && $seasonNumber !== null) {
@@ -385,11 +292,11 @@ if (!function_exists('episode_numbering')) {
         }
 
         if ($isAbbr) {
-            return '<abbr class="' .
+            return '<abbr class="tracking-wider ' .
                 $class .
                 '" title="' .
                 lang($transKey, $args) .
-                '">' .
+                '" data-tooltip="bottom">' .
                 lang($transKey . '_abbr', $args) .
                 '</abbr>';
         }
@@ -402,28 +309,199 @@ if (!function_exists('episode_numbering')) {
     }
 }
 
-if (!function_exists('location_link')) {
+// ------------------------------------------------------------------------
+
+if (! function_exists('location_link')) {
     /**
      * Returns link to display from location info
      */
     function location_link(?Location $location, string $class = ''): string
     {
-        if ($location === null) {
+        if (! $location instanceof Location) {
             return '';
         }
 
         return anchor(
             $location->url,
-            icon('map-pin', 'mr-2') . $location->name,
+            icon('map-pin-2-fill', [
+                'class' => 'mr-2 flex-shrink-0',
+            ]) . '<span class="truncate">' . esc($location->name) . '</span>',
             [
-                'class' =>
-                    'inline-flex items-baseline hover:underline' .
-                    (empty($class) ? '' : " {$class}"),
+                'class' => 'w-full overflow-hidden inline-flex items-baseline hover:underline' .
+                    ($class === '' ? '' : " {$class}"),
                 'target' => '_blank',
-                'rel' => 'noreferrer noopener',
+                '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
 
-/**
- * @copyright  2020 Podlibre
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
+declare(strict_types=1);
 
-if (!function_exists('form_section')) {
+if (! function_exists('form_textarea')) {
     /**
-     * Form section
-     *
-     * Used to produce a responsive form section with a title and subtitle. To close section,
-     * use form_section_close()
-     *
-     * @param string $title The section title
-     * @param string $subtitle The section subtitle
-     * @param array  $attributes  Additional attributes
-     *
-     * @return string
+     * Adapted textarea field from CI4 core: without value escaping.
      */
-    function form_section(
-        string $title = '',
-        string $subtitle = '',
-        array $attributes = [],
-        string $customSubtitleClass = ''
-    ): string {
-        $subtitleClass = 'text-sm text-gray-600';
-        if ($customSubtitleClass !== '') {
-            $subtitleClass = $customSubtitleClass;
+    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
         }
 
-        $section =
-            '<div class="flex flex-wrap w-full gap-6 mb-8"' .
-            stringify_attributes($attributes) .
-            ">\n";
+        // 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']);
+        }
 
-        $info =
-            '<div class="w-full max-w-xs"><h2 class="text-lg font-semibold">' .
-            $title .
-            '</h2><p class="' .
-            $subtitleClass .
-            '">' .
-            $subtitle .
-            '</p></div>';
+        if ((is_array($extra) && array_key_exists('cols', $extra)) || (is_string($extra) && stripos(
+            (string) preg_replace('~\s+~', '', $extra),
+            'cols=',
+        ) !== false)) {
+            unset($defaults['cols']);
+        }
 
-        return $section . $info . '<div class="flex flex-col w-full max-w-lg">';
+        return '<textarea ' . rtrim(parse_form_attributes($data, $defaults)) . stringify_attributes(
+            $extra,
+        ) . '>' . $val . "</textarea>\n";
     }
 }
 
-//--------------------------------------------------------------------
-
-if (!function_exists('form_section_close')) {
+if (! function_exists('parse_form_attributes')) {
     /**
-     * Form Section close Tag
+     * Parse the form attributes
      *
-     * @param string $extra
+     * Helper function used by some of the form helpers
      *
-     * @return string
+     * @param array<string, string>|string $attributes List of attributes
+     * @param array<string, mixed>        $default    Default values
      */
-    function form_section_close(string $extra = ''): string
+    function parse_form_attributes(array|string $attributes, array $default): string
     {
-        return '</div></div>' . $extra;
-    }
-}
-
-//--------------------------------------------------------------------
-
-if (!function_exists('form_switch')) {
-    /**
-     * Form Checkbox Switch
-     *
-     * Abstracts form_label to stylize it as a switch toggle
-     *
-     * @return string
-     */
-    function form_switch(
-        $label = '',
-        array $data = [],
-        string $value = '',
-        bool $checked = false,
-        string $class = '',
-        array $extra = []
-    ): string {
-        $data['class'] = 'form-switch';
-
-        return '<label class="relative inline-flex items-center' .
-            ' ' .
-            $class .
-            '">' .
-            form_checkbox($data, $value, $checked, $extra) .
-            '<span class="form-switch-slider"></span>' .
-            '<span class="ml-2">' .
-            $label .
-            '</span></label>';
-    }
-}
-
-//--------------------------------------------------------------------
-
-if (!function_exists('form_label')) {
-    /**
-     * Form Label Tag
-     *
-     * @param string $label_text The text to appear onscreen
-     * @param string $id         The id the label applies to
-     * @param array  $attributes Additional attributes
-     * @param string  $hintText Hint text to add next to the label
-     * @param boolean  $isOptional adds an optional text if true
-     *
-     * @return string
-     */
-    function form_label(
-        string $label_text = '',
-        string $id = '',
-        array $attributes = [],
-        string $hintText = '',
-        bool $isOptional = false
-    ): string {
-        $label = '<label';
-
-        if ($id !== '') {
-            $label .= ' for="' . $id . '"';
-        }
-
-        if (is_array($attributes) && $attributes) {
-            foreach ($attributes as $key => $val) {
-                $label .= ' ' . $key . '="' . $val . '"';
+        if (is_array($attributes)) {
+            foreach (array_keys($default) as $key) {
+                if (isset($attributes[$key])) {
+                    $default[$key] = $attributes[$key];
+                    unset($attributes[$key]);
+                }
             }
-        }
-
-        $label_content = $label_text;
-        if ($isOptional) {
-            $label_content .=
-                '<small class="ml-1 lowercase">(' .
-                lang('Common.optional') .
-                ')</small>';
-        }
 
-        if ($hintText !== '') {
-            $label_content .= hint_tooltip($hintText, 'ml-1');
+            if ($attributes !== []) {
+                $default = array_merge($default, $attributes);
+            }
         }
 
-        return $label . '>' . $label_content . '</label>';
-    }
-}
+        $att = '';
 
-//--------------------------------------------------------------------
-
-if (!function_exists('form_multiselect')) {
-    /**
-     * Multi-select menu
-     *
-     * @return string
-     */
-    function form_multiselect(
-        string $name = '',
-        array $options = [],
-        array $selected = [],
-        array $customExtra = []
-    ): string {
-        $defaultExtra = [
-            'data-class' => $customExtra['class'],
-            'data-select-text' => lang('Common.forms.multiSelect.selectText'),
-            'data-loading-text' => lang('Common.forms.multiSelect.loadingText'),
-            'data-no-results-text' => lang(
-                'Common.forms.multiSelect.noResultsText',
-            ),
-            'data-no-choices-text' => lang(
-                'Common.forms.multiSelect.noChoicesText',
-            ),
-            'data-max-item-text' => lang(
-                'Common.forms.multiSelect.maxItemText',
-            ),
-        ];
-        $extra = stringify_attributes(array_merge($defaultExtra, $customExtra));
+        foreach ($default as $key => $val) {
+            if (! is_bool($val)) {
+                if ($key === 'name' && ! strlen((string) $default['name'])) {
+                    continue;
+                }
 
-        if (stripos($extra, 'multiple') === false) {
-            $extra .= ' multiple="multiple"';
+                $att .= $key . '="' . $val . '"' . ($key === array_key_last($default) ? '' : ' ');
+            } else {
+                $att .= $key . ' ';
+            }
         }
 
-        return form_dropdown($name, $options, $selected, $extra);
+        return $att;
     }
 }
-
-//--------------------------------------------------------------------