modules/Fediverse/Filters/AllowCorsFilter.php → app/Filters/AllowCorsFilter.php

@@ -2,26 +2,43 @@
 
 declare(strict_types=1);
 
-namespace Modules\Fediverse\Filters;
+namespace App\Filters;
 
 use CodeIgniter\Filters\FilterInterface;
 use CodeIgniter\HTTP\RequestInterface;
 use CodeIgniter\HTTP\ResponseInterface;
+use Override;
 
 class AllowCorsFilter implements FilterInterface
 {
-    public function before(RequestInterface $request, $arguments = null): void
+    /**
+     * @param list<string>|null $arguments
+     *
+     * @return RequestInterface|ResponseInterface|string|null
+     */
+    #[Override]
+    public function before(RequestInterface $request, $arguments = null)
     {
-        // Do something here
+        return null;
     }
 
-    public function after(RequestInterface $request, ResponseInterface $response, $arguments = null): void
+    /**
+     * @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')
-            ->setHeader('Cache-Control', 'public, max-age=86400')
-            ->setStatusCode(200);
+            ->setHeader('Access-Control-Max-Age', '86400');
+
+        return $response;
     }
 }

app/Helpers/breadcrumb_helper.php

@@ -2,14 +2,6 @@
 
 declare(strict_types=1);
 
-/**
- * @copyright  2020 Ad Aures
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-use Config\Services;
-
 if (! function_exists('render_breadcrumb')) {
     /**
      * Renders the breadcrumb navigation through the Breadcrumb service
@@ -17,20 +9,18 @@ if (! function_exists('render_breadcrumb')) {
      * @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')) {
     /**
-     * @param string[] $newParams
+     * @param array<string|int,string> $newParams
      */
     function replace_breadcrumb_params(array $newParams): void
     {
-        $breadcrumb = Services::breadcrumb();
-        $breadcrumb->replaceParams(esc($newParams));
+        service('breadcrumb')->replaceParams($newParams);
     }
 }

app/Helpers/components_helper.php

@@ -9,37 +9,13 @@ declare(strict_types=1);
  */
 
 use App\Entities\Category;
+use App\Entities\Episode;
 use App\Entities\Location;
 use CodeIgniter\I18n\Time;
 use CodeIgniter\View\Table;
 
 // ------------------------------------------------------------------------
 
-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
-     */
-    function hint_tooltip(string $hintText = '', string $class = ''): string
-    {
-        $tooltip =
-            '<span data-tooltip="bottom" tabindex="0" title="' .
-            $hintText .
-            '" class="inline-block align-middle opacity-75 focus:ring-accent';
-
-        if ($class !== '') {
-            $tooltip .= ' ' . $class;
-        }
-
-        return $tooltip . '">' . icon('question') . '</span>';
-    }
-}
-
-// ------------------------------------------------------------------------
-
 if (! function_exists('data_table')) {
     /**
      * Data table component
@@ -57,14 +33,13 @@ if (! function_exists('data_table')) {
         $template = [
             'table_open' => '<table class="w-full whitespace-nowrap">',
 
-            'thead_open' =>
-                '<thead class="text-xs font-semibold text-left uppercase text-skin-muted">',
+            '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="border-t border-subtle hover:bg-base">',
+            'row_start'     => '<tr class="border-t border-subtle hover:bg-base">',
             'row_alt_start' => '<tr class="border-t border-subtle hover:bg-base">',
         ];
 
@@ -91,8 +66,8 @@ if (! function_exists('data_table')) {
             $table->addRow([
                 [
                     'colspan' => count($tableHeaders),
-                    'class' => 'px-4 py-2 italic font-semibold text-center',
-                    'data' => lang('Common.no_data'),
+                    'class'   => 'px-4 py-2 italic font-semibold text-center',
+                    'data'    => lang('Common.no_data'),
                 ],
             ]);
         }
@@ -113,31 +88,29 @@ if (! function_exists('publication_pill')) {
      */
     function publication_pill(?Time $publicationDate, string $publicationStatus, string $customClass = ''): string
     {
-        $class = match ($publicationStatus) {
-            'published' => 'text-pine-500 border-pine-500 bg-pine-50',
-            'scheduled' => 'text-red-600 border-red-600 bg-red-50',
-            'with_podcast' => 'text-blue-600 border-blue-600 bg-blue-50',
-            'not_published' => 'text-gray-600 border-gray-600 bg-gray-50',
-            default => 'text-gray-600 border-gray-600 bg-gray-50',
+        $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'),
+            'with_podcast'  => lang('Episode.with_podcast_hint'),
             'not_published' => '',
-            default => '',
+            default         => '',
         };
 
         $label = lang('Episode.publication_status.' . $publicationStatus);
 
-        return '<span ' . ($title === '' ? '' : 'title="' . $title . '"') . ' class="flex items-center px-1 font-semibold border rounded w-max ' .
-            $class .
-            ' ' .
-            $customClass .
-            '">' .
-            $label .
-            ($publicationStatus === 'with_podcast' ? '<Icon glyph="warning" class="flex-shrink-0 ml-1 text-lg" />' : '') .
-            '</span>';
+        // @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>';
     }
 }
 
@@ -156,20 +129,20 @@ if (! function_exists('publication_button')) {
                 $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 = 'warning';
-                $iconLeft = 'upload-cloud';
+                $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 = '';
@@ -180,7 +153,7 @@ if (! function_exists('publication_button')) {
         }
 
         return <<<HTML
-            <Button variant="{$variant}" uri="{$route}" iconLeft="{$iconLeft}" >{$label}</Button>
+            <x-Button variant="{$variant}" uri="{$route}" iconLeft="{$iconLeft}" >{$label}</x-Button>
         HTML;
     }
 }
@@ -206,7 +179,7 @@ if (! function_exists('publication_status_banner')) {
                 $bannerDisclaimer = lang('Podcast.publication_status_banner.draft_mode');
                 $bannerText = lang('Podcast.publication_status_banner.scheduled', [
                     'publication_date' => local_datetime($publicationDate),
-                ], null, false);
+                ]);
                 $linkRoute = route_to('podcast-publish_edit', $podcastId);
                 $linkLabel = lang('Podcast.publish_edit');
                 break;
@@ -219,8 +192,8 @@ if (! function_exists('publication_status_banner')) {
         }
 
         return <<<HTML
-        <div class="flex items-center px-12 py-1 border-b bg-stripes-gray border-subtle" role="alert">
-            <p class="text-gray-900">
+        <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>
@@ -232,6 +205,58 @@ if (! function_exists('publication_status_banner')) {
 
 // ------------------------------------------------------------------------
 
+if (! function_exists('episode_publication_status_banner')) {
+    /**
+     * Publication status banner component for podcasts
+     *
+     * Displays the appropriate banner depending on the podcast's publication status.
+     */
+    function episode_publication_status_banner(Episode $episode, string $class = ''): string
+    {
+        switch ($episode->publication_status) {
+            case 'not_published':
+                $linkRoute = route_to('episode-publish', $episode->podcast_id, $episode->id);
+                $publishLinkLabel = lang('Episode.publish');
+                break;
+            case 'scheduled':
+            case 'with_podcast':
+                $linkRoute = route_to('episode-publish_edit', $episode->podcast_id, $episode->id);
+                $publishLinkLabel = lang('Episode.publish_edit');
+                break;
+            default:
+                $bannerDisclaimer = '';
+                $linkRoute = '';
+                $publishLinkLabel = '';
+                break;
+        }
+
+        $bannerDisclaimer = lang('Episode.publication_status_banner.draft_mode');
+        $bannerText = lang('Episode.publication_status_banner.text', [
+            'publication_status' => $episode->publication_status,
+            'publication_date'   => $episode->published_at instanceof Time ? local_datetime(
+                $episode->published_at,
+            ) : null,
+        ]);
+        $previewLinkLabel = lang('Episode.publication_status_banner.preview');
+
+        return <<<HTML
+        <div class="flex flex-wrap gap-4 items-baseline px-4 md:px-12 py-2 bg-stripes-default border-subtle {$class}" role="alert">
+            <p class="flex items-baseline text-gray-900">
+                <span class="text-xs font-semibold tracking-wide uppercase">{$bannerDisclaimer}</span>
+                <span class="ml-3 text-sm">{$bannerText}</span>
+            </p>
+            <div class="flex items-baseline">    
+                <a href="{$episode->preview_link}" class="ml-1 text-sm font-semibold underline shadow-xs text-accent-base hover:text-accent-hover hover:no-underline">{$previewLinkLabel}</a>
+                <span class="mx-1">•</span>
+                <a href="{$linkRoute}" class="ml-1 text-sm font-semibold underline shadow-xs text-accent-base hover:text-accent-hover hover:no-underline">{$publishLinkLabel}</a>
+            </div>
+        </div>
+        HTML;
+    }
+}
+
+// ------------------------------------------------------------------------
+
 if (! function_exists('episode_numbering')) {
     /**
      * Returns relevant translated episode numbering.
@@ -242,7 +267,7 @@ if (! function_exists('episode_numbering')) {
         ?int $episodeNumber = null,
         ?int $seasonNumber = null,
         string $class = '',
-        bool $isAbbr = false
+        bool $isAbbr = false,
     ): string {
         if (! $episodeNumber && ! $seasonNumber) {
             return '';
@@ -292,19 +317,20 @@ if (! function_exists('location_link')) {
      */
     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 flex-shrink-0') . '<span class="truncate">' . esc($location->name) . '</span>',
+            icon('map-pin-2-fill', [
+                'class' => 'mr-2 flex-shrink-0',
+            ]) . '<span class="truncate">' . esc($location->name) . '</span>',
             [
-                'class' =>
-                    'w-full overflow-hidden inline-flex items-baseline hover:underline focus:ring-accent' .
+                'class' => 'w-full overflow-hidden inline-flex items-baseline hover:underline' .
                     ($class === '' ? '' : " {$class}"),
                 'target' => '_blank',
-                'rel' => 'noreferrer noopener',
+                'rel'    => 'noreferrer noopener',
             ],
         );
     }
@@ -326,7 +352,6 @@ if (! function_exists('audio_player')) {
                 id="castopod-vm-player"
                 theme="light"
                 language="{$language}"
-                icons="castopod-icons"
                 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));"
             >
@@ -334,7 +359,7 @@ if (! function_exists('audio_player')) {
                     <source src="{$source}" type="{$mediaType}" />
                 </vm-audio>
                 <vm-ui>
-                    <vm-icon-library name="castopod-icons"></vm-icon-library>
+                    <vm-icon-library></vm-icon-library>
                     <vm-controls full-width>
                         <vm-playback-control></vm-playback-control>
                         <vm-volume-control></vm-volume-control>
@@ -356,17 +381,17 @@ if (! function_exists('relative_time')) {
     function relative_time(Time $time, string $class = ''): string
     {
         $formatter = new IntlDateFormatter(service(
-            'request'
+            'request',
         )->getLocale(), IntlDateFormatter::MEDIUM, IntlDateFormatter::NONE);
         $translatedDate = $time->toLocalizedString($formatter->getPattern());
-        $datetime = $time->format(DateTime::ISO8601);
+        $datetime = $time->format(DateTime::ATOM);
 
         return <<<HTML
-            <time-ago class="{$class}" datetime="{$datetime}">
+            <relative-time tense="auto" class="{$class}" datetime="{$datetime}">
                 <time
                     datetime="{$datetime}"
                     title="{$time}">{$translatedDate}</time>
-            </time-ago>
+            </relative-time>
         HTML;
     }
 }
@@ -377,23 +402,25 @@ if (! function_exists('local_datetime')) {
     function local_datetime(Time $time): string
     {
         $formatter = new IntlDateFormatter(service(
-            'request'
+            'request',
         )->getLocale(), IntlDateFormatter::MEDIUM, IntlDateFormatter::LONG);
         $translatedDate = $time->toLocalizedString($formatter->getPattern());
-        $datetime = $time->format(DateTime::ISO8601);
+        $datetime = $time->format(DateTime::ATOM);
 
         return <<<HTML
-            <local-time datetime="{$datetime}" 
-                weekday="long" 
-                month="long"
+            <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>
-            </local-time>
+            </relative-time>
         HTML;
     }
 }
@@ -404,7 +431,7 @@ if (! function_exists('local_date')) {
     function local_date(Time $time): string
     {
         $formatter = new IntlDateFormatter(service(
-            'request'
+            'request',
         )->getLocale(), IntlDateFormatter::MEDIUM, IntlDateFormatter::NONE);
         $translatedDate = $time->toLocalizedString($formatter->getPattern());
 
@@ -414,7 +441,6 @@ if (! function_exists('local_date')) {
     }
 }
 
-
 // ------------------------------------------------------------------------
 
 if (! function_exists('explicit_badge')) {
@@ -433,17 +459,49 @@ if (! function_exists('explicit_badge')) {
 
 // ------------------------------------------------------------------------
 
-
 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, [], null, false) . ' › ';
+            $categoryLabel .= lang('Podcast.category_options.' . $category->parent->code) . ' › ';
         }
 
-        return $categoryLabel . lang('Podcast.category_options.' . $category->code, [], null, false);
+        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

@@ -22,26 +22,25 @@ if (! function_exists('form_textarea')) {
 
         // 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(
-            preg_replace('~\s+~', '', $extra),
-            'rows='
+            (string) preg_replace('~\s+~', '', $extra),
+            'rows=',
         ) !== false)) {
             unset($defaults['rows']);
         }
 
         if ((is_array($extra) && array_key_exists('cols', $extra)) || (is_string($extra) && stripos(
-            preg_replace('~\s+~', '', $extra),
-            'cols='
+            (string) preg_replace('~\s+~', '', $extra),
+            'cols=',
         ) !== false)) {
             unset($defaults['cols']);
         }
 
         return '<textarea ' . rtrim(parse_form_attributes($data, $defaults)) . stringify_attributes(
-            $extra
+            $extra,
         ) . '>' . $val . "</textarea>\n";
     }
 }
 
-
 if (! function_exists('parse_form_attributes')) {
     /**
      * Parse the form attributes
@@ -61,7 +60,7 @@ if (! function_exists('parse_form_attributes')) {
                 }
             }
 
-            if (! empty($attributes)) {
+            if ($attributes !== []) {
                 $default = array_merge($default, $attributes);
             }
         }

app/Helpers/id3_helper.php

@@ -7,9 +7,10 @@ declare(strict_types=1);
  * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
  * @link       https://castopod.org/
  */
-
 use App\Entities\Episode;
+use CodeIgniter\I18n\Time;
 use JamesHeinrich\GetID3\WriteTags;
+use Modules\Media\FileManagers\FileManagerInterface;
 
 if (! function_exists('write_audio_file_tags')) {
     /**
@@ -23,13 +24,16 @@ if (! function_exists('write_audio_file_tags')) {
 
         // Initialize getID3 tag-writing module
         $tagwriter = new WriteTags();
-        $tagwriter->filename = media_path($episode->audio->file_path);
+        $tagwriter->filename = $episode->audio->file_name;
 
         // set various options (optional)
         $tagwriter->tagformats = ['id3v2.4'];
         $tagwriter->tag_encoding = $TextEncoding;
 
-        $APICdata = file_get_contents(media_path($episode->cover->id3_path));
+        /** @var FileManagerInterface $fileManager */
+        $fileManager = service('file_manager');
+
+        $APICdata = (string) $fileManager->getFileContents($episode->cover->id3_key);
 
         // TODO: variables used for podcast specific tags
         // $podcastUrl = $episode->podcast->link;
@@ -38,24 +42,16 @@ if (! function_exists('write_audio_file_tags')) {
 
         // populate data array
         $TagData = [
-            'title' => [esc($episode->title)],
-            'artist' => [
-                $episode->podcast->publisher === null
-                    ? esc($episode->podcast->owner_name)
-                    : $episode->podcast->publisher,
-            ],
-            'album' => [esc($episode->podcast->title)],
-            'year' => [$episode->published_at !== null ? $episode->published_at->format('Y') : ''],
-            'genre' => ['Podcast'],
-            'comment' => [$episode->description],
-            'track_number' => [(string) $episode->number],
+            'title'             => [esc($episode->title)],
+            'artist'            => [$episode->podcast->publisher ?? esc($episode->podcast->owner_name)],
+            'album'             => [esc($episode->podcast->title)],
+            'year'              => [$episode->published_at instanceof Time ? $episode->published_at->format('Y') : ''],
+            'genre'             => ['Podcast'],
+            'comment'           => [$episode->description],
+            'track_number'      => [(string) $episode->number],
             'copyright_message' => [$episode->podcast->copyright],
-            'publisher' => [
-                $episode->podcast->publisher === null
-                    ? esc($episode->podcast->owner_name)
-                    : $episode->podcast->publisher,
-            ],
-            'encoded_by' => ['Castopod'],
+            'publisher'         => [$episode->podcast->publisher ?? esc($episode->podcast->owner_name)],
+            'encoded_by'        => ['Castopod'],
 
             // TODO: find a way to add the remaining tags for podcasts as the library doesn't seem to allow it
             // 'website' => [$podcast_url],
@@ -68,23 +64,21 @@ if (! function_exists('write_audio_file_tags')) {
         $TagData['attached_picture'][] = [
             // picturetypeid == Cover. More: module.tag.id3v2.php
             'picturetypeid' => 2,
-            'data' => $APICdata,
-            'description' => 'cover',
-            'mime' => $episode->cover->file_mimetype,
+            'data'          => $APICdata,
+            'description'   => 'cover',
+            'mime'          => $episode->cover->file_mimetype,
         ];
 
         $tagwriter->tag_data = $TagData;
 
         // write tags
         if ($tagwriter->WriteTags()) {
-            echo 'Successfully wrote tags<br>';
+            // Successfully wrote tags
             if ($tagwriter->warnings !== []) {
-                echo 'There were some warnings:<br>' .
-                    implode('<br><br>', $tagwriter->warnings);
+                log_message('warning', 'There were some warnings:' . PHP_EOL . implode(PHP_EOL, $tagwriter->warnings));
             }
         } else {
-            echo 'Failed to write tags!<br>' .
-                implode('<br><br>', $tagwriter->errors);
+            log_message('critical', 'Failed to write tags!' . PHP_EOL . implode(PHP_EOL, $tagwriter->errors));
         }
     }
 }

app/Helpers/media_helper.php

-<?php
-
-declare(strict_types=1);
-
-/**
- * @copyright  2020 Ad Aures
- * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
- * @link       https://castopod.org/
- */
-
-use CodeIgniter\Files\File;
-use CodeIgniter\HTTP\Files\UploadedFile;
-use CodeIgniter\HTTP\ResponseInterface;
-use Config\Mimes;
-use Config\Services;
-
-if (! function_exists('save_media')) {
-    /**
-     * Saves a file to the corresponding podcast folder in `public/media`
-     */
-    function save_media(File | UploadedFile $file, string $folder = '', string $filename = null): string
-    {
-        if (($extension = $file->getExtension()) !== '') {
-            $filename = $filename . '.' . $extension;
-        }
-
-        $mediaRoot = config('App')
-            ->mediaRoot . '/' . $folder;
-
-        if (! file_exists($mediaRoot)) {
-            mkdir($mediaRoot, 0777, true);
-        }
-
-        if (! file_exists($mediaRoot . '/index.html')) {
-            touch($mediaRoot . '/index.html');
-        }
-
-        // move to media folder, overwrite file if already existing
-        $file->move($mediaRoot . '/', $filename, true);
-
-        return $folder . '/' . $filename;
-    }
-}
-
-if (! function_exists('download_file')) {
-    function download_file(string $fileUrl, string $mimetype = ''): File
-    {
-        $client = Services::curlrequest();
-
-        $response = $client->get($fileUrl, [
-            'headers' => [
-                'User-Agent' => 'Castopod/' . CP_VERSION,
-            ],
-        ]);
-
-        // redirect to new file location
-        $newFileUrl = $fileUrl;
-        while (
-            in_array(
-                $response->getStatusCode(),
-                [
-                    ResponseInterface::HTTP_MOVED_PERMANENTLY,
-                    ResponseInterface::HTTP_FOUND,
-                    ResponseInterface::HTTP_SEE_OTHER,
-                    ResponseInterface::HTTP_NOT_MODIFIED,
-                    ResponseInterface::HTTP_TEMPORARY_REDIRECT,
-                    ResponseInterface::HTTP_PERMANENT_REDIRECT,
-                ],
-                true,
-            )
-        ) {
-            $newFileUrl = trim($response->header('location')->getValue());
-            $response = $client->get($newFileUrl, [
-                'headers' => [
-                    'User-Agent' => 'Castopod/' . CP_VERSION,
-                ],
-                'http_errors' => false,
-            ]);
-        }
-
-        $fileExtension = pathinfo(parse_url($newFileUrl, PHP_URL_PATH), PATHINFO_EXTENSION);
-        $extension = $fileExtension === '' ? Mimes::guessExtensionFromType($mimetype) : $fileExtension;
-        $tmpFilename =
-            time() .
-            '_' .
-            bin2hex(random_bytes(10)) .
-            '.' .
-            $extension;
-        $tmpFilePath = WRITEPATH . 'uploads/' . $tmpFilename;
-        file_put_contents($tmpFilePath, $response->getBody());
-
-        return new File($tmpFilePath);
-    }
-}
-
-if (! function_exists('media_path')) {
-    /**
-     * Prefixes the root media path to a given uri
-     *
-     * @param  string|string[] $uri URI string or array of URI segments
-     */
-    function media_path(string | array $uri = ''): string
-    {
-        // convert segment array to string
-        if (is_array($uri)) {
-            $uri = implode('/', $uri);
-        }
-
-        $uri = trim($uri, '/');
-
-        return config('App')->mediaRoot . '/' . $uri;
-    }
-}
-
-if (! function_exists('media_base_url')) {
-    /**
-     * Return the media base URL to use in views
-     *
-     * @param  string|string[] $uri URI string or array of URI segments
-     */
-    function media_base_url(string | array $uri = ''): string
-    {
-        // convert segment array to string
-        if (is_array($uri)) {
-            $uri = implode('/', $uri);
-        }
-
-        $uri = trim($uri, '/');
-
-        $appConfig = config('App');
-        $mediaBaseUrl = $appConfig->mediaBaseURL === '' ? $appConfig->baseURL : $appConfig->mediaBaseURL;
-
-        return rtrim((string) $mediaBaseUrl, '/') .
-            '/' .
-            $appConfig->mediaRoot .
-            '/' .
-            $uri;
-    }
-}

app/Helpers/misc_helper.php

@@ -2,13 +2,18 @@
 
 declare(strict_types=1);
 
+use App\Entities\Person;
+use App\Entities\Podcast;
+use Cocur\Slugify\Slugify;
+use Config\Images;
+use Modules\Media\Entities\Image;
+
 /**
  * @copyright  2020 Ad Aures
  * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
  * @link       https://castopod.org/
  */
 
-
 if (! function_exists('get_browser_language')) {
     /**
      * Gets the browser default language using the request header key `HTTP_ACCEPT_LANGUAGE`. Returns Castopod's default
@@ -36,105 +41,8 @@ if (! function_exists('slugify')) {
             $text = substr($text, 0, strrpos(substr($text, 0, $maxLength), ' '));
         }
 
-        // replace non letter or digits by -
-        $text = preg_replace('~[^\pL\d]+~u', '-', $text);
-
-        $unwanted = [
-            'Š' => 'S',
-            'š' => 's',
-            'Đ' => 'Dj',
-            'đ' => 'dj',
-            'Ž' => 'Z',
-            'ž' => 'z',
-            'Č' => 'C',
-            'č' => 'c',
-            'Ć' => 'C',
-            'ć' => 'c',
-            'À' => 'A',
-            'Á' => 'A',
-            'Â' => 'A',
-            'Ã' => 'A',
-            'Ä' => 'A',
-            'Å' => 'A',
-            'Æ' => 'AE',
-            'Ç' => 'C',
-            'È' => 'E',
-            'É' => 'E',
-            'Ê' => 'E',
-            'Ë' => 'E',
-            'Ì' => 'I',
-            'Í' => 'I',
-            'Î' => 'I',
-            'Ï' => 'I',
-            'Ñ' => 'N',
-            'Ò' => 'O',
-            'Ó' => 'O',
-            'Ô' => 'O',
-            'Õ' => 'O',
-            'Ö' => 'O',
-            'Ø' => 'O',
-            'Œ' => 'OE',
-            'Ù' => 'U',
-            'Ú' => 'U',
-            'Û' => 'U',
-            'Ü' => 'U',
-            'Ý' => 'Y',
-            'Þ' => 'B',
-            'ß' => 'Ss',
-            'à' => 'a',
-            'á' => 'a',
-            'â' => 'a',
-            'ã' => 'a',
-            'ä' => 'a',
-            'å' => 'a',
-            'æ' => 'ae',
-            'ç' => 'c',
-            'è' => 'e',
-            'é' => 'e',
-            'ê' => 'e',
-            'ë' => 'e',
-            'ì' => 'i',
-            'í' => 'i',
-            'î' => 'i',
-            'ï' => 'i',
-            'ð' => 'o',
-            'ñ' => 'n',
-            'ò' => 'o',
-            'ó' => 'o',
-            'ô' => 'o',
-            'õ' => 'o',
-            'ö' => 'o',
-            'ø' => 'o',
-            'œ' => 'OE',
-            'ù' => 'u',
-            'ú' => 'u',
-            'û' => 'u',
-            'ý' => 'y',
-            'þ' => 'b',
-            'ÿ' => 'y',
-            'Ŕ' => 'R',
-            'ŕ' => 'r',
-            '/' => '-',
-            ' ' => '-',
-        ];
-        $text = strtr($text, $unwanted);
-
-        // transliterate
-        $text = iconv('utf-8', 'us-ascii//TRANSLIT', $text);
-
-        // remove unwanted characters
-        $text = preg_replace('~[^\-\w]+~', '', $text);
-
-        // trim
-        $text = trim($text, '-');
-
-        // remove duplicate -
-        $text = preg_replace('~-+~', '-', $text);
-
-        // lowercase
-        $text = strtolower($text);
-
-        return $text;
+        $slugify = new Slugify();
+        return $slugify->slugify($text);
     }
 }
 
@@ -172,7 +80,6 @@ if (! function_exists('format_duration')) {
     }
 }
 
-
 if (! function_exists('format_duration_symbol')) {
     /**
      * Formats duration in seconds to an hh(h) mm(min) ss(s) string. Doesn't show leading zeros if any.
@@ -203,22 +110,6 @@ if (! function_exists('format_duration_symbol')) {
 
 //--------------------------------------------------------------------
 
-if (! function_exists('podcast_uuid')) {
-    /**
-     * Generate UUIDv5 for podcast. For more information, see
-     * https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md#guid
-     */
-    function podcast_uuid(string $feedUrl): string
-    {
-        $uuid = service('uuid');
-        // 'ead4c236-bf58-58c6-a2c6-a6b28d128cb6' is the uuid of the podcast namespace
-        return $uuid->uuid5('ead4c236-bf58-58c6-a2c6-a6b28d128cb6', $feedUrl)
-            ->toString();
-    }
-}
-
-//--------------------------------------------------------------------
-
 if (! function_exists('generate_random_salt')) {
     function generate_random_salt(int $length = 64): string
     {
@@ -237,9 +128,7 @@ if (! function_exists('generate_random_salt')) {
 
 //--------------------------------------------------------------------
 
-
 if (! function_exists('file_upload_max_size')) {
-
     /**
      * Returns a file size limit in bytes based on the PHP upload_max_filesize and post_max_size Adapted from:
      * https://stackoverflow.com/a/25370978
@@ -274,7 +163,7 @@ if (! function_exists('parse_size')) {
         $size = (float) preg_replace('~[^0-9\.]~', '', $size); // Remove the non-numeric characters from the size.
         if ($unit !== '') {
             // Find the position of the unit in the ordered string which is the power of magnitude to multiply a kilobyte by.
-            return round($size * pow(1024, (float) stripos('bkmgtpezy', $unit[0])));
+            return round($size * 1024 ** ((float) stripos('bkmgtpezy', $unit[0])));
         }
 
         return round($size);
@@ -293,8 +182,90 @@ if (! function_exists('format_bytes')) {
         $pow = floor(($bytes ? log($bytes) : 0) / log($is_binary ? 1024 : 1000));
         $pow = min($pow, count($units) - 1);
 
-        $bytes /= pow($is_binary ? 1024 : 1000, $pow);
+        $bytes /= ($is_binary ? 1024 : 1000) ** $pow;
 
         return round($bytes, $precision) . $units[$pow];
     }
 }
+
+if (! function_exists('get_site_icon_url')) {
+    function get_site_icon_url(string $size): string
+    {
+        if (config('App')->siteIcon['ico'] === service('settings')->get('App.siteIcon')['ico']) {
+            // return default site icon url
+            return base_url(service('settings')->get('App.siteIcon')[$size]);
+        }
+
+        return service('file_manager')->getUrl(service('settings')->get('App.siteIcon')[$size]);
+    }
+}
+
+if (! function_exists('get_podcast_banner')) {
+    function get_podcast_banner_url(Podcast $podcast, string $size): string
+    {
+        if (! $podcast->banner instanceof Image) {
+            $defaultBanner = config('Images')
+                ->podcastBannerDefaultPaths[service('settings')->get('App.theme')] ?? config(
+                    Images::class,
+                )->podcastBannerDefaultPaths['default'];
+
+            $sizes = config('Images')
+                ->podcastBannerSizes;
+
+            $sizeConfig = $sizes[$size];
+            helper('filesystem');
+
+            // return default site icon url
+            return base_url(
+                change_file_path($defaultBanner['path'], '_' . $size, $sizeConfig['extension'] ?? null),
+            );
+        }
+
+        $sizeKey = $size . '_url';
+        return $podcast->banner->{$sizeKey};
+    }
+}
+
+if (! function_exists('get_podcast_banner_mimetype')) {
+    function get_podcast_banner_mimetype(Podcast $podcast, string $size): string
+    {
+        if (! $podcast->banner instanceof Image) {
+            $sizes = config('Images')
+                ->podcastBannerSizes;
+
+            $sizeConfig = $sizes[$size];
+            helper('filesystem');
+
+            // return default site icon url
+            return array_key_exists('mimetype', $sizeConfig) ? $sizeConfig['mimetype'] : config(
+                Images::class,
+            )->podcastBannerDefaultMimeType;
+        }
+
+        $mimetype = $size . '_mimetype';
+        return $podcast->banner->{$mimetype};
+    }
+}
+
+if (! function_exists('get_avatar_url')) {
+    function get_avatar_url(Person $person, string $size): string
+    {
+        if (! $person->avatar instanceof Image) {
+            $defaultAvatarPath = config('Images')
+                ->avatarDefaultPath;
+
+            $sizes = config('Images')
+                ->personAvatarSizes;
+
+            $sizeConfig = $sizes[$size];
+
+            helper('filesystem');
+
+            // return default avatar url
+            return base_url(change_file_path($defaultAvatarPath, '_' . $size, $sizeConfig['extension'] ?? null));
+        }
+
+        $sizeKey = $size . '_url';
+        return $person->avatar->{$sizeKey};
+    }
+}

app/Helpers/page_helper.php

@@ -16,30 +16,36 @@ if (! function_exists('render_page_links')) {
      *
      * @return string html pages navigation
      */
-    function render_page_links(string $class = null): string
+    function render_page_links(?string $class = null, ?string $podcastHandle = null): string
     {
         $pages = (new PageModel())->findAll();
         $links = anchor(route_to('home'), lang('Common.home'), [
-            'class' => 'px-2 py-1 underline hover:no-underline focus:ring-accent',
+            'class' => 'px-2 py-1 underline hover:no-underline',
         ]);
+        if ($podcastHandle !== null) {
+            $links .= anchor(route_to('podcast-links', $podcastHandle), lang('Podcast.links'), [
+                'class' => 'px-2 py-1 underline hover:no-underline',
+            ]);
+        }
+
         $links .= anchor(route_to('credits'), lang('Person.credits'), [
-            'class' => 'px-2 py-1 underline hover:no-underline focus:ring-accent',
+            'class' => 'px-2 py-1 underline hover:no-underline',
         ]);
         $links .= anchor(route_to('map'), lang('Page.map.title'), [
-            'class' => 'px-2 py-1 underline hover:no-underline focus:ring-accent',
+            'class' => 'px-2 py-1 underline hover:no-underline',
         ]);
         foreach ($pages as $page) {
             $links .= anchor($page->link, esc($page->title), [
-                'class' => 'px-2  py-1 underline hover:no-underline focus:ring-accent',
+                'class' => 'px-2  py-1 underline hover:no-underline',
             ]);
         }
 
         // if set in .env, add legal notice link at the end of page links
         if (config('App')->legalNoticeURL !== null) {
             $links .= anchor(config('App')->legalNoticeURL, lang('Common.legal_notice'), [
-                'class' => 'px-2 py-1 underline hover:no-underline focus:ring-accent',
+                'class'  => 'px-2 py-1 underline hover:no-underline',
                 'target' => '_blank',
-                'rel' => 'noopener noreferrer',
+                'rel'    => 'noopener noreferrer',
             ]);
         }
 

app/Helpers/rss_helper.php

@@ -7,12 +7,16 @@ declare(strict_types=1);
  * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
  * @link       https://castopod.org/
  */
-
 use App\Entities\Category;
+use App\Entities\Location;
 use App\Entities\Podcast;
-use App\Libraries\SimpleRSSElement;
+use App\Libraries\RssFeed;
+use App\Models\PodcastModel;
 use CodeIgniter\I18n\Time;
 use Config\Mimes;
+use Modules\Media\Entities\Chapters;
+use Modules\Media\Entities\Transcript;
+use Modules\Plugins\Core\Plugins;
 use Modules\PremiumPodcasts\Entities\Subscription;
 
 if (! function_exists('get_rss_feed')) {
@@ -25,25 +29,21 @@ if (! function_exists('get_rss_feed')) {
     function get_rss_feed(
         Podcast $podcast,
         string $serviceSlug = '',
-        Subscription $subscription = null,
-        string $token = null
+        ?Subscription $subscription = null,
+        ?string $token = null,
     ): string {
-        $episodes = $podcast->episodes;
+        /** @var Plugins $plugins */
+        $plugins = service('plugins');
 
-        $itunesNamespace = 'http://www.itunes.com/dtds/podcast-1.0.dtd';
+        $episodes = $podcast->episodes;
 
-        $podcastNamespace =
-            'https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md';
+        $rss = new RssFeed();
 
-        $atomNamespace = 'http://www.w3.org/2005/Atom';
-
-        $rss = new SimpleRSSElement(
-            "<?xml version='1.0' encoding='utf-8'?><rss version='2.0' xmlns:itunes='{$itunesNamespace}' xmlns:podcast='{$podcastNamespace}' xmlns:atom='{$atomNamespace}' xmlns:content='http://purl.org/rss/1.0/modules/content/'></rss>"
-        );
+        $plugins->rssBeforeChannel($podcast);
 
         $channel = $rss->addChild('channel');
 
-        $atomLink = $channel->addChild('link', null, $atomNamespace);
+        $atomLink = $channel->addChild('link', null, RssFeed::ATOM_NAMESPACE);
         $atomLink->addAttribute('href', $podcast->feed_url);
         $atomLink->addAttribute('rel', 'self');
         $atomLink->addAttribute('type', 'application/rss+xml');
@@ -52,14 +52,14 @@ if (! function_exists('get_rss_feed')) {
         $websubHubs = config('WebSub')
             ->hubs;
         foreach ($websubHubs as $websubHub) {
-            $atomLinkHub = $channel->addChild('link', null, $atomNamespace);
+            $atomLinkHub = $channel->addChild('link', null, RssFeed::ATOM_NAMESPACE);
             $atomLinkHub->addAttribute('href', $websubHub);
             $atomLinkHub->addAttribute('rel', 'hub');
             $atomLinkHub->addAttribute('type', 'application/rss+xml');
         }
 
         if ($podcast->new_feed_url !== null) {
-            $channel->addChild('new-feed-url', $podcast->new_feed_url, $itunesNamespace);
+            $channel->addChild('new-feed-url', $podcast->new_feed_url, RssFeed::ITUNES_NAMESPACE);
         }
 
         // the last build date corresponds to the creation of the feed.xml cache
@@ -67,17 +67,27 @@ if (! function_exists('get_rss_feed')) {
         $channel->addChild('generator', 'Castopod - https://castopod.org/');
         $channel->addChild('docs', 'https://cyber.harvard.edu/rss/rss.html');
 
-        $channel->addChild('guid', $podcast->guid, $podcastNamespace);
+        if ($podcast->guid === '') {
+            // FIXME: guid shouldn't be empty here as it should be filled upon Podcast creation
+            $uuid = service('uuid');
+            // 'ead4c236-bf58-58c6-a2c6-a6b28d128cb6' is the uuid of the podcast namespace
+            $podcast->guid = $uuid->uuid5('ead4c236-bf58-58c6-a2c6-a6b28d128cb6', $podcast->feed_url)
+                ->toString();
+
+            (new PodcastModel())->save($podcast);
+        }
+
+        $channel->addChild('guid', $podcast->guid, RssFeed::PODCAST_NAMESPACE);
         $channel->addChild('title', $podcast->title, null, false);
         $channel->addChildWithCDATA('description', $podcast->description_html);
 
-        $itunesImage = $channel->addChild('image', null, $itunesNamespace);
+        $itunesImage = $channel->addChild('image', null, RssFeed::ITUNES_NAMESPACE);
 
         $itunesImage->addAttribute('href', $podcast->cover->feed_url);
 
         $channel->addChild('language', $podcast->language_code);
-        if ($podcast->location !== null) {
-            $locationElement = $channel->addChild('location', $podcast->location->name, $podcastNamespace);
+        if ($podcast->location instanceof Location) {
+            $locationElement = $channel->addChild('location', $podcast->location->name, RssFeed::PODCAST_NAMESPACE);
             if ($podcast->location->geo !== null) {
                 $locationElement->addAttribute('geo', $podcast->location->geo);
             }
@@ -87,27 +97,16 @@ if (! function_exists('get_rss_feed')) {
             }
         }
 
-        if ($podcast->payment_pointer !== null) {
-            $valueElement = $channel->addChild('value', null, $podcastNamespace);
-            $valueElement->addAttribute('type', 'webmonetization');
-            $valueElement->addAttribute('method', '');
-            $valueElement->addAttribute('suggested', '');
-            $recipientElement = $valueElement->addChild('valueRecipient', null, $podcastNamespace);
-            $recipientElement->addAttribute('name', $podcast->owner_name);
-            $recipientElement->addAttribute('type', 'ILP');
-            $recipientElement->addAttribute('address', $podcast->payment_pointer);
-            $recipientElement->addAttribute('split', '100');
-        }
-
         $channel
-            ->addChild('locked', $podcast->is_locked ? 'yes' : 'no', $podcastNamespace)
+            ->addChild('locked', $podcast->is_locked ? 'yes' : 'no', RssFeed::PODCAST_NAMESPACE)
             ->addAttribute('owner', $podcast->owner_email);
+
         if ($podcast->imported_feed_url !== null) {
-            $channel->addChild('previousUrl', $podcast->imported_feed_url, $podcastNamespace);
+            $channel->addChild('previousUrl', $podcast->imported_feed_url, RssFeed::PODCAST_NAMESPACE);
         }
 
         foreach ($podcast->podcasting_platforms as $podcastingPlatform) {
-            $podcastingPlatformElement = $channel->addChild('id', null, $podcastNamespace);
+            $podcastingPlatformElement = $channel->addChild('id', null, RssFeed::PODCAST_NAMESPACE);
             $podcastingPlatformElement->addAttribute('platform', $podcastingPlatform->slug);
             if ($podcastingPlatform->account_id !== null) {
                 $podcastingPlatformElement->addAttribute('id', $podcastingPlatform->account_id);
@@ -118,7 +117,7 @@ if (! function_exists('get_rss_feed')) {
             }
         }
 
-        $castopodSocialElement = $channel->addChild('social', null, $podcastNamespace);
+        $castopodSocialElement = $channel->addChild('social', null, RssFeed::PODCAST_NAMESPACE);
         $castopodSocialElement->addAttribute('priority', '1');
         $castopodSocialElement->addAttribute('platform', 'castopod');
         $castopodSocialElement->addAttribute('protocol', 'activitypub');
@@ -126,7 +125,7 @@ if (! function_exists('get_rss_feed')) {
         $castopodSocialElement->addAttribute('accountUrl', $podcast->link);
 
         foreach ($podcast->social_platforms as $socialPlatform) {
-            $socialElement = $channel->addChild('social', null, $podcastNamespace,);
+            $socialElement = $channel->addChild('social', null, RssFeed::PODCAST_NAMESPACE);
             $socialElement->addAttribute('priority', '2');
             $socialElement->addAttribute('platform', $socialPlatform->slug);
 
@@ -134,7 +133,7 @@ if (! function_exists('get_rss_feed')) {
             if (in_array(
                 $socialPlatform->slug,
                 ['mastodon', 'peertube', 'funkwhale', 'misskey', 'mobilizon', 'pixelfed', 'plume', 'writefreely'],
-                true
+                true,
             )) {
                 $socialElement->addAttribute('protocol', 'activitypub');
             } else {
@@ -150,41 +149,41 @@ if (! function_exists('get_rss_feed')) {
             }
 
             if ($socialPlatform->slug === 'mastodon') {
-                $socialSignUpelement = $socialElement->addChild('socialSignUp', null, $podcastNamespace);
+                $socialSignUpelement = $socialElement->addChild('socialSignUp', null, RssFeed::PODCAST_NAMESPACE);
                 $socialSignUpelement->addAttribute('priority', '1');
                 $socialSignUpelement->addAttribute(
                     'homeUrl',
-                    parse_url($socialPlatform->link_url, PHP_URL_SCHEME) . '://' . parse_url(
-                        $socialPlatform->link_url,
-                        PHP_URL_HOST
-                    ) . '/public'
+                    parse_url((string) $socialPlatform->link_url, PHP_URL_SCHEME) . '://' . parse_url(
+                        (string) $socialPlatform->link_url,
+                        PHP_URL_HOST,
+                    ) . '/public',
                 );
                 $socialSignUpelement->addAttribute(
                     'signUpUrl',
-                    parse_url($socialPlatform->link_url, PHP_URL_SCHEME) . '://' . parse_url(
-                        $socialPlatform->link_url,
-                        PHP_URL_HOST
-                    ) . '/auth/sign_up'
+                    parse_url((string) $socialPlatform->link_url, PHP_URL_SCHEME) . '://' . parse_url(
+                        (string) $socialPlatform->link_url,
+                        PHP_URL_HOST,
+                    ) . '/auth/sign_up',
                 );
                 $castopodSocialSignUpelement = $castopodSocialElement->addChild(
                     'socialSignUp',
                     null,
-                    $podcastNamespace
+                    RssFeed::PODCAST_NAMESPACE,
                 );
                 $castopodSocialSignUpelement->addAttribute('priority', '1');
                 $castopodSocialSignUpelement->addAttribute(
                     'homeUrl',
-                    parse_url($socialPlatform->link_url, PHP_URL_SCHEME) . '://' . parse_url(
-                        $socialPlatform->link_url,
-                        PHP_URL_HOST
-                    ) . '/public'
+                    parse_url((string) $socialPlatform->link_url, PHP_URL_SCHEME) . '://' . parse_url(
+                        (string) $socialPlatform->link_url,
+                        PHP_URL_HOST,
+                    ) . '/public',
                 );
                 $castopodSocialSignUpelement->addAttribute(
                     'signUpUrl',
-                    parse_url($socialPlatform->link_url, PHP_URL_SCHEME) . '://' . parse_url(
-                        $socialPlatform->link_url,
-                        PHP_URL_HOST
-                    ) . '/auth/sign_up'
+                    parse_url((string) $socialPlatform->link_url, PHP_URL_SCHEME) . '://' . parse_url(
+                        (string) $socialPlatform->link_url,
+                        PHP_URL_HOST,
+                    ) . '/auth/sign_up',
                 );
             }
         }
@@ -193,7 +192,7 @@ if (! function_exists('get_rss_feed')) {
             $fundingPlatformElement = $channel->addChild(
                 'funding',
                 $fundingPlatform->account_id,
-                $podcastNamespace,
+                RssFeed::PODCAST_NAMESPACE,
             );
             $fundingPlatformElement->addAttribute('platform', $fundingPlatform->slug);
             if ($fundingPlatform->link_url !== null) {
@@ -203,9 +202,9 @@ if (! function_exists('get_rss_feed')) {
 
         foreach ($podcast->persons as $person) {
             foreach ($person->roles as $role) {
-                $personElement = $channel->addChild('person', $person->full_name, $podcastNamespace,);
+                $personElement = $channel->addChild('person', $person->full_name, RssFeed::PODCAST_NAMESPACE);
 
-                $personElement->addAttribute('img', $person->avatar->medium_url);
+                $personElement->addAttribute('img', get_avatar_url($person, 'medium'));
 
                 if ($person->information_url !== null) {
                     $personElement->addAttribute('href', $person->information_url);
@@ -232,32 +231,26 @@ if (! function_exists('get_rss_feed')) {
         $channel->addChild(
             'explicit',
             $podcast->parental_advisory === 'explicit' ? 'true' : 'false',
-            $itunesNamespace,
+            RssFeed::ITUNES_NAMESPACE,
         );
 
-        $channel->addChild(
-            'author',
-            $podcast->publisher ? $podcast->publisher : $podcast->owner_name,
-            $itunesNamespace,
-            false
-        );
+        $channel->addChild('author', $podcast->publisher ?: $podcast->owner_name, RssFeed::ITUNES_NAMESPACE, false);
         $channel->addChild('link', $podcast->link);
 
-        $owner = $channel->addChild('owner', null, $itunesNamespace);
+        $owner = $channel->addChild('owner', null, RssFeed::ITUNES_NAMESPACE);
 
-        $owner->addChild('name', $podcast->owner_name, $itunesNamespace, false);
+        $owner->addChild('name', $podcast->owner_name, RssFeed::ITUNES_NAMESPACE, false);
+        $owner->addChild('email', $podcast->owner_email, RssFeed::ITUNES_NAMESPACE);
 
-        $owner->addChild('email', $podcast->owner_email, $itunesNamespace);
-
-        $channel->addChild('type', $podcast->type, $itunesNamespace);
+        $channel->addChild('type', $podcast->type, RssFeed::ITUNES_NAMESPACE);
         $podcast->copyright &&
             $channel->addChild('copyright', $podcast->copyright);
-        if ($podcast->is_blocked) {
-            $channel->addChild('block', 'Yes', $itunesNamespace);
+        if ($podcast->is_blocked || $subscription instanceof Subscription) {
+            $channel->addChild('block', 'Yes', RssFeed::ITUNES_NAMESPACE);
         }
 
         if ($podcast->is_completed) {
-            $channel->addChild('complete', 'Yes', $itunesNamespace);
+            $channel->addChild('complete', 'Yes', RssFeed::ITUNES_NAMESPACE);
         }
 
         $image = $channel->addChild('image');
@@ -265,17 +258,16 @@ if (! function_exists('get_rss_feed')) {
         $image->addChild('title', $podcast->title, null, false);
         $image->addChild('link', $podcast->link);
 
-        if ($podcast->custom_rss !== null) {
-            array_to_rss([
-                'elements' => $podcast->custom_rss,
-            ], $channel);
-        }
+        // run plugins hook at the end
+        $plugins->rssAfterChannel($podcast, $channel);
 
         foreach ($episodes as $episode) {
-            if ($episode->is_premium && $subscription === null) {
+            if ($episode->is_premium && ! $subscription instanceof Subscription) {
                 continue;
             }
 
+            $plugins->rssBeforeItem($episode);
+
             $item = $channel->addChild('item');
             $item->addChild('title', $episode->title, null, false);
             $enclosure = $item->addChild('enclosure');
@@ -287,15 +279,15 @@ if (! function_exists('get_rss_feed')) {
 
             $enclosure->addAttribute(
                 'url',
-                $episode->audio_analytics_url . ($enclosureParams === '' ? '' : '?' . $enclosureParams),
+                $episode->audio_url . ($enclosureParams === '' ? '' : '?' . $enclosureParams),
             );
             $enclosure->addAttribute('length', (string) $episode->audio->file_size);
             $enclosure->addAttribute('type', $episode->audio->file_mimetype);
 
             $item->addChild('guid', $episode->guid);
             $item->addChild('pubDate', $episode->published_at->format(DATE_RFC1123));
-            if ($episode->location !== null) {
-                $locationElement = $item->addChild('location', $episode->location->name, $podcastNamespace,);
+            if ($episode->location instanceof Location) {
+                $locationElement = $item->addChild('location', $episode->location->name, RssFeed::PODCAST_NAMESPACE);
                 if ($episode->location->geo !== null) {
                     $locationElement->addAttribute('geo', $episode->location->geo);
                 }
@@ -305,10 +297,10 @@ if (! function_exists('get_rss_feed')) {
                 }
             }
 
-            $item->addChildWithCDATA('description', $episode->getDescriptionHtml($serviceSlug));
-            $item->addChild('duration', (string) round($episode->audio->duration), $itunesNamespace);
+            $item->addChildWithCDATA('description', $episode->description_html);
+            $item->addChild('duration', (string) round($episode->audio->duration), RssFeed::ITUNES_NAMESPACE);
             $item->addChild('link', $episode->link);
-            $episodeItunesImage = $item->addChild('image', null, $itunesNamespace);
+            $episodeItunesImage = $item->addChild('image', null, RssFeed::ITUNES_NAMESPACE);
             $episodeItunesImage->addAttribute('href', $episode->cover->feed_url);
 
             $episode->parental_advisory &&
@@ -317,71 +309,89 @@ if (! function_exists('get_rss_feed')) {
                     $episode->parental_advisory === 'explicit'
                         ? 'true'
                         : 'false',
-                    $itunesNamespace,
+                    RssFeed::ITUNES_NAMESPACE,
                 );
 
             $episode->number &&
-                $item->addChild('episode', (string) $episode->number, $itunesNamespace);
+                $item->addChild('episode', (string) $episode->number, RssFeed::ITUNES_NAMESPACE);
             $episode->season_number &&
-                $item->addChild('season', (string) $episode->season_number, $itunesNamespace);
-            $item->addChild('episodeType', $episode->type, $itunesNamespace);
+                $item->addChild('season', (string) $episode->season_number, RssFeed::ITUNES_NAMESPACE);
+            $item->addChild('episodeType', $episode->type, RssFeed::ITUNES_NAMESPACE);
+
+            // If episode is of type trailer, add podcast:trailer tag on channel level
+            if ($episode->type === 'trailer') {
+                $trailer = $channel->addChild('trailer', $episode->title, RssFeed::PODCAST_NAMESPACE);
+                $trailer->addAttribute('pubdate', $episode->published_at->format(DATE_RFC2822));
+                $trailer->addAttribute(
+                    'url',
+                    $episode->audio_url . ($enclosureParams === '' ? '' : '?' . $enclosureParams),
+                );
+                $trailer->addAttribute('length', (string) $episode->audio->file_size);
+                $trailer->addAttribute('type', $episode->audio->file_mimetype);
+                if ($episode->season_number !== null) {
+                    $trailer->addAttribute('season', (string) $episode->season_number);
+                }
+            }
 
             // add link to episode comments as podcast-activity format
-            $comments = $item->addChild('comments', null, $podcastNamespace);
+            $comments = $item->addChild('comments', null, RssFeed::PODCAST_NAMESPACE);
             $comments->addAttribute('uri', url_to('episode-comments', $podcast->handle, $episode->slug));
             $comments->addAttribute('contentType', 'application/podcast-activity+json');
 
             if ($episode->getPosts()) {
                 $socialInteractUri = $episode->getPosts()[0]
                     ->uri;
-                $socialInteractElement = $item->addChild('socialInteract', null, $podcastNamespace);
+                $socialInteractElement = $item->addChild('socialInteract', null, RssFeed::PODCAST_NAMESPACE);
                 $socialInteractElement->addAttribute('uri', $socialInteractUri);
                 $socialInteractElement->addAttribute('priority', '1');
                 $socialInteractElement->addAttribute('platform', 'castopod');
                 $socialInteractElement->addAttribute('protocol', 'activitypub');
                 $socialInteractElement->addAttribute(
                     'accountId',
-                    "@{$podcast->actor->username}@{$podcast->actor->domain}"
+                    "@{$podcast->actor->username}@{$podcast->actor->domain}",
                 );
                 $socialInteractElement->addAttribute(
                     'pubDate',
                     $episode->getPosts()[0]
-                        ->published_at->format(DateTime::ISO8601)
+                        ->published_at->format(DateTime::ISO8601),
                 );
             }
 
-            if ($episode->transcript !== null) {
-                $transcriptElement = $item->addChild('transcript', null, $podcastNamespace);
+            if ($episode->transcript instanceof Transcript) {
+                $transcriptElement = $item->addChild('transcript', null, RssFeed::PODCAST_NAMESPACE);
                 $transcriptElement->addAttribute('url', $episode->transcript->file_url);
                 $transcriptElement->addAttribute(
                     'type',
                     Mimes::guessTypeFromExtension(
-                        pathinfo($episode->transcript->file_url, PATHINFO_EXTENSION)
+                        pathinfo($episode->transcript->file_url, PATHINFO_EXTENSION),
                     ) ?? 'text/html',
                 );
+                // Castopod only allows for captions (SubRip files)
+                $transcriptElement->addAttribute('rel', 'captions');
+                // TODO: allow for multiple languages
                 $transcriptElement->addAttribute('language', $podcast->language_code);
             }
 
-            if ($episode->getChapters() !== null) {
-                $chaptersElement = $item->addChild('chapters', null, $podcastNamespace);
+            if ($episode->getChapters() instanceof Chapters) {
+                $chaptersElement = $item->addChild('chapters', null, RssFeed::PODCAST_NAMESPACE);
                 $chaptersElement->addAttribute('url', $episode->chapters->file_url);
                 $chaptersElement->addAttribute('type', 'application/json+chapters');
             }
 
             foreach ($episode->soundbites as $soundbite) {
                 // TODO: differentiate video from soundbites?
-                $soundbiteElement = $item->addChild('soundbite', $soundbite->title, $podcastNamespace);
-                $soundbiteElement->addAttribute('start_time', (string) $soundbite->start_time);
+                $soundbiteElement = $item->addChild('soundbite', $soundbite->title, RssFeed::PODCAST_NAMESPACE);
+                $soundbiteElement->addAttribute('startTime', (string) $soundbite->start_time);
                 $soundbiteElement->addAttribute('duration', (string) round($soundbite->duration, 3));
             }
 
             foreach ($episode->persons as $person) {
                 foreach ($person->roles as $role) {
-                    $personElement = $item->addChild('person', esc($person->full_name), $podcastNamespace,);
+                    $personElement = $item->addChild('person', esc($person->full_name), RssFeed::PODCAST_NAMESPACE);
 
                     $personElement->addAttribute(
                         'role',
-                        esc(lang("PersonsTaxonomy.persons.{$role->group}.roles.{$role->role}.label", [], 'en'),),
+                        esc(lang("PersonsTaxonomy.persons.{$role->group}.roles.{$role->role}.label", [], 'en')),
                     );
 
                     $personElement->addAttribute(
@@ -389,7 +399,7 @@ if (! function_exists('get_rss_feed')) {
                         esc(lang("PersonsTaxonomy.persons.{$role->group}.label", [], 'en')),
                     );
 
-                    $personElement->addAttribute('img', $person->avatar->medium_url);
+                    $personElement->addAttribute('img', get_avatar_url($person, 'medium'));
 
                     if ($person->information_url !== null) {
                         $personElement->addAttribute('href', $person->information_url);
@@ -398,14 +408,10 @@ if (! function_exists('get_rss_feed')) {
             }
 
             if ($episode->is_blocked) {
-                $item->addChild('block', 'Yes', $itunesNamespace);
+                $item->addChild('block', 'Yes', RssFeed::ITUNES_NAMESPACE);
             }
 
-            if ($episode->custom_rss !== null) {
-                array_to_rss([
-                    'elements' => $episode->custom_rss,
-                ], $item);
-            }
+            $plugins->rssAfterItem($episode, $item);
         }
 
         return $rss->asXML();
@@ -416,20 +422,18 @@ if (! function_exists('add_category_tag')) {
     /**
      * Adds <itunes:category> and <category> tags to node for a given category
      */
-    function add_category_tag(SimpleXMLElement $node, Category $category): void
+    function add_category_tag(RssFeed $node, Category $category): void
     {
-        $itunesNamespace = 'http://www.itunes.com/dtds/podcast-1.0.dtd';
-
-        $itunesCategory = $node->addChild('category', null, $itunesNamespace);
+        $itunesCategory = $node->addChild('category', null, RssFeed::ITUNES_NAMESPACE);
         $itunesCategory->addAttribute(
             'text',
-            $category->parent !== null
+            $category->parent instanceof Category
                 ? $category->parent->apple_category
                 : $category->apple_category,
         );
 
-        if ($category->parent !== null) {
-            $itunesCategoryChild = $itunesCategory->addChild('category', null, $itunesNamespace);
+        if ($category->parent instanceof Category) {
+            $itunesCategoryChild = $itunesCategory->addChild('category', null, RssFeed::ITUNES_NAMESPACE);
             $itunesCategoryChild->addAttribute('text', $category->apple_category);
             $node->addChild('category', $category->parent->apple_category);
         }
@@ -437,75 +441,3 @@ if (! function_exists('add_category_tag')) {
         $node->addChild('category', $category->apple_category);
     }
 }
-
-if (! function_exists('rss_to_array')) {
-    /**
-     * Converts XML to array
-     *
-     * FIXME: param should be SimpleRSSElement
-     *
-     * @return array<string, mixed>
-     */
-    function rss_to_array(SimpleXMLElement $rssNode): array
-    {
-        $nameSpaces = [
-            '',
-            'http://www.itunes.com/dtds/podcast-1.0.dtd',
-            'https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md',
-        ];
-        $arrayNode = [];
-        $arrayNode['name'] = $rssNode->getName();
-        $arrayNode['namespace'] = $rssNode->getNamespaces(false);
-        foreach ($rssNode->attributes() as $key => $value) {
-            $arrayNode['attributes'][$key] = (string) $value;
-        }
-
-        $textcontent = trim((string) $rssNode);
-        if (strlen($textcontent) > 0) {
-            $arrayNode['content'] = $textcontent;
-        }
-
-        foreach ($nameSpaces as $currentNameSpace) {
-            foreach ($rssNode->children($currentNameSpace) as $childXmlNode) {
-                $arrayNode['elements'][] = rss_to_array($childXmlNode);
-            }
-        }
-
-        return $arrayNode;
-    }
-}
-
-if (! function_exists('array_to_rss')) {
-    /**
-     * Inserts array (converted to XML node) in XML node
-     *
-     * @param array<string, mixed> $arrayNode
-     * @param SimpleRSSElement $xmlNode The XML parent node where this arrayNode should be attached
-     */
-    function array_to_rss(array $arrayNode, SimpleRSSElement &$xmlNode): SimpleRSSElement
-    {
-        if (array_key_exists('elements', $arrayNode)) {
-            foreach ($arrayNode['elements'] as $childArrayNode) {
-                $childXmlNode = $xmlNode->addChild(
-                    $childArrayNode['name'],
-                    $childArrayNode['content'] ?? null,
-                    $childArrayNode['namespace'] === []
-                        ? null
-                        : current($childArrayNode['namespace'])
-                );
-                if (array_key_exists('attributes', $childArrayNode)) {
-                    foreach (
-                        $childArrayNode['attributes']
-                        as $attributeKey => $attributeValue
-                    ) {
-                        $childXmlNode->addAttribute($attributeKey, $attributeValue);
-                    }
-                }
-
-                array_to_rss($childArrayNode, $childXmlNode);
-            }
-        }
-
-        return $xmlNode;
-    }
-}

app/Helpers/seo_helper.php

@@ -8,18 +8,19 @@ use App\Entities\EpisodeComment;
 use App\Entities\Page;
 use App\Entities\Podcast;
 use App\Entities\Post;
-use Melbahja\Seo\MetaTags;
+use App\Libraries\HtmlHead;
 use Melbahja\Seo\Schema;
 use Melbahja\Seo\Schema\Thing;
+use Modules\Fediverse\Entities\PreviewCard;
 
 /**
- * @copyright  2021 Ad Aures
+ * @copyright  2024 Ad Aures
  * @license    https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
  * @link       https://castopod.org/
  */
 
-if (! function_exists('get_podcast_metatags')) {
-    function get_podcast_metatags(Podcast $podcast, string $page): string
+if (! function_exists('set_podcast_metatags')) {
+    function set_podcast_metatags(Podcast $podcast, string $page): void
     {
         $category = '';
         if ($podcast->category->parent_id !== null) {
@@ -30,27 +31,28 @@ if (! function_exists('get_podcast_metatags')) {
 
         $schema = new Schema(
             new Thing('PodcastSeries', [
-                'name' => $podcast->title,
-                'headline' => $podcast->title,
-                'url' => current_url(),
-                'sameAs' => $podcast->link,
-                'identifier' => $podcast->guid,
-                'image' => $podcast->cover->feed_url,
+                'name'        => $podcast->title,
+                'headline'    => $podcast->title,
+                'url'         => current_url(),
+                'sameAs'      => $podcast->link,
+                'identifier'  => $podcast->guid,
+                'image'       => $podcast->cover->feed_url,
                 'description' => $podcast->description,
-                'webFeed' => $podcast->feed_url,
-                'accessMode' => 'auditory',
-                'author' => $podcast->owner_name,
-                'creator' => $podcast->owner_name,
-                'publisher' => $podcast->publisher,
-                'inLanguage' => $podcast->language_code,
-                'genre' => $category,
-            ])
+                'webFeed'     => $podcast->feed_url,
+                'accessMode'  => 'auditory',
+                'author'      => $podcast->owner_name,
+                'creator'     => $podcast->owner_name,
+                'publisher'   => $podcast->publisher,
+                'inLanguage'  => $podcast->language_code,
+                'genre'       => $category,
+            ]),
         );
 
-        $metatags = new MetaTags();
+        /** @var HtmlHead $head */
+        $head = service('html_head');
 
-        $metatags
-            ->title($podcast->title . ' (@' . $podcast->handle . ') • ' . lang('Podcast.' . $page))
+        $head
+            ->title(sprintf('%s (@%s) • %s', $podcast->title, $podcast->handle, lang('Podcast.' . $page)))
             ->description(esc($podcast->description))
             ->image((string) $podcast->cover->og_url)
             ->canonical((string) current_url())
@@ -58,47 +60,42 @@ if (! function_exists('get_podcast_metatags')) {
             ->og('image:height', (string) config('Images')->podcastCoverSizes['og']['height'])
             ->og('locale', $podcast->language_code)
             ->og('site_name', esc(service('settings')->get('App.siteName')))
-            ->push('link', [
-                'rel' => 'alternate',
+            ->tag('link', null, [
+                'rel'  => 'alternate',
                 'type' => 'application/activity+json',
                 'href' => url_to('podcast-activity', esc($podcast->handle)),
-            ]);
-
-        if ($podcast->payment_pointer) {
-            $metatags->meta('monetization', $podcast->payment_pointer);
-        }
-
-        return '<link type="application/rss+xml" rel="alternate" title="' . esc(
-            $podcast->title
-        ) . '" href="' . $podcast->feed_url . '" />' . PHP_EOL . $metatags->__toString() . PHP_EOL . $schema->__toString();
+            ])->appendRawContent('<link type="application/rss+xml" rel="alternate" title="' . esc(
+                $podcast->title,
+            ) . '" href="' . $podcast->feed_url . '" />' . $schema);
     }
 }
 
-if (! function_exists('get_episode_metatags')) {
-    function get_episode_metatags(Episode $episode): string
+if (! function_exists('set_episode_metatags')) {
+    function set_episode_metatags(Episode $episode): void
     {
         $schema = new Schema(
             new Thing('PodcastEpisode', [
-                'url' => url_to('episode', esc($episode->podcast->handle), $episode->slug),
-                'name' => $episode->title,
-                'image' => $episode->cover->feed_url,
-                'description' => $episode->description,
-                'datePublished' => $episode->published_at->format(DATE_ISO8601),
-                'timeRequired' => iso8601_duration($episode->audio->duration),
-                'duration' => iso8601_duration($episode->audio->duration),
+                'url'             => url_to('episode', esc($episode->podcast->handle), $episode->slug),
+                'name'            => $episode->title,
+                'image'           => $episode->cover->feed_url,
+                'description'     => $episode->description,
+                'datePublished'   => $episode->published_at->format(DATE_ATOM),
+                'timeRequired'    => iso8601_duration($episode->audio->duration),
+                'duration'        => iso8601_duration($episode->audio->duration),
                 'associatedMedia' => new Thing('MediaObject', [
-                    'contentUrl' => $episode->audio->file_url,
+                    'contentUrl' => $episode->audio_url,
                 ]),
                 'partOfSeries' => new Thing('PodcastSeries', [
                     'name' => $episode->podcast->title,
-                    'url' => $episode->podcast->link,
+                    'url'  => $episode->podcast->link,
                 ]),
-            ])
+            ]),
         );
 
-        $metatags = new MetaTags();
+        /** @var HtmlHead $head */
+        $head = service('html_head');
 
-        $metatags
+        $head
             ->title($episode->title)
             ->description(esc($episode->description))
             ->image((string) $episode->cover->og_url, 'player')
@@ -109,42 +106,37 @@ if (! function_exists('get_episode_metatags')) {
             ->og('locale', $episode->podcast->language_code)
             ->og('audio', $episode->audio_opengraph_url)
             ->og('audio:type', $episode->audio->file_mimetype)
-            ->meta('article:published_time', $episode->published_at->format(DATE_ISO8601))
-            ->meta('article:modified_time', $episode->updated_at->format(DATE_ISO8601))
+            ->meta('article:published_time', $episode->published_at->format(DATE_ATOM))
+            ->meta('article:modified_time', $episode->updated_at->format(DATE_ATOM))
             ->twitter('audio:partner', $episode->podcast->publisher ?? '')
             ->twitter('audio:artist_name', esc($episode->podcast->owner_name))
             ->twitter('player', $episode->getEmbedUrl('light'))
             ->twitter('player:width', (string) config('Embed')->width)
             ->twitter('player:height', (string) config('Embed')->height)
-            ->push('link', [
-                'rel' => 'alternate',
+            ->tag('link', null, [
+                'rel'  => 'alternate',
                 'type' => 'application/activity+json',
-                'href' => url_to('episode', $episode->podcast->handle, $episode->slug),
-            ]);
-
-        if ($episode->podcast->payment_pointer) {
-            $metatags->meta('monetization', $episode->podcast->payment_pointer);
-        }
-
-        return $metatags->__toString() . PHP_EOL . '<link rel="alternate" type="application/json+oembed" href="' . base_url(
-            route_to('episode-oembed-json', $episode->podcast->handle, $episode->slug)
-        ) . '" title="' . esc(
-            $episode->title
-        ) . ' oEmbed json" />' . PHP_EOL . '<link rel="alternate" type="text/xml+oembed" href="' . base_url(
-            route_to('episode-oembed-xml', $episode->podcast->handle, $episode->slug)
-        ) . '" title="' . esc($episode->title) . ' oEmbed xml" />' . PHP_EOL . $schema->__toString();
+                'href' => $episode->link,
+            ])
+            ->appendRawContent('<link rel="alternate" type="application/json+oembed" href="' . base_url(
+                route_to('episode-oembed-json', $episode->podcast->handle, $episode->slug),
+            ) . '" title="' . esc(
+                $episode->title,
+            ) . ' oEmbed json" />' . '<link rel="alternate" type="text/xml+oembed" href="' . base_url(
+                route_to('episode-oembed-xml', $episode->podcast->handle, $episode->slug),
+            ) . '" title="' . esc($episode->title) . ' oEmbed xml" />' . $schema);
     }
 }
 
-if (! function_exists('get_post_metatags')) {
-    function get_post_metatags(Post $post): string
+if (! function_exists('set_post_metatags')) {
+    function set_post_metatags(Post $post): void
     {
         $socialMediaPosting = new Thing('SocialMediaPosting', [
-            '@id' => url_to('post', esc($post->actor->username), $post->id),
-            'datePublished' => $post->published_at->format(DATE_ISO8601),
-            'author' => new Thing('Person', [
+            '@id'           => url_to('post', esc($post->actor->username), $post->id),
+            'datePublished' => $post->published_at->format(DATE_ATOM),
+            'author'        => new Thing('Person', [
                 'name' => $post->actor->display_name,
-                'url' => $post->actor->uri,
+                'url'  => $post->actor->uri,
             ]),
             'text' => $post->message,
         ]);
@@ -152,16 +144,16 @@ if (! function_exists('get_post_metatags')) {
         if ($post->episode_id !== null) {
             $socialMediaPosting->__set('sharedContent', new Thing('Audio', [
                 'headline' => $post->episode->title,
-                'url' => $post->episode->link,
-                'author' => new Thing('Person', [
+                'url'      => $post->episode->link,
+                'author'   => new Thing('Person', [
                     'name' => $post->episode->podcast->owner_name,
                 ]),
             ]));
-        } elseif ($post->preview_card !== null) {
+        } elseif ($post->preview_card instanceof PreviewCard) {
             $socialMediaPosting->__set('sharedContent', new Thing('WebPage', [
                 'headline' => $post->preview_card->title,
-                'url' => $post->preview_card->url,
-                'author' => new Thing('Person', [
+                'url'      => $post->preview_card->url,
+                'author'   => new Thing('Person', [
                     'name' => $post->preview_card->author_name,
                 ]),
             ]));
@@ -169,8 +161,10 @@ if (! function_exists('get_post_metatags')) {
 
         $schema = new Schema($socialMediaPosting);
 
-        $metatags = new MetaTags();
-        $metatags
+        /** @var HtmlHead $head */
+        $head = service('html_head');
+
+        $head
             ->title(lang('Post.title', [
                 'actorDisplayName' => $post->actor->display_name,
             ]))
@@ -178,65 +172,64 @@ if (! function_exists('get_post_metatags')) {
             ->image($post->actor->avatar_image_url)
             ->canonical((string) current_url())
             ->og('site_name', esc(service('settings')->get('App.siteName')))
-            ->push('link', [
-                'rel' => 'alternate',
+            ->tag('link', null, [
+                'rel'  => 'alternate',
                 'type' => 'application/activity+json',
                 'href' => url_to('post', esc($post->actor->username), $post->id),
-            ]);
-
-        return $metatags->__toString() . PHP_EOL . $schema->__toString();
+            ])->appendRawContent((string) $schema);
     }
 }
 
-if (! function_exists('get_episode_comment_metatags')) {
-    function get_episode_comment_metatags(EpisodeComment $episodeComment): string
+if (! function_exists('set_episode_comment_metatags')) {
+    function set_episode_comment_metatags(EpisodeComment $episodeComment): void
     {
         $schema = new Schema(new Thing('SocialMediaPosting', [
             '@id' => url_to(
                 'episode-comment',
                 esc($episodeComment->actor->username),
                 $episodeComment->episode->slug,
-                $episodeComment->id
+                $episodeComment->id,
             ),
-            'datePublished' => $episodeComment->created_at->format(DATE_ISO8601),
-            'author' => new Thing('Person', [
+            'datePublished' => $episodeComment->created_at->format(DATE_ATOM),
+            'author'        => new Thing('Person', [
                 'name' => $episodeComment->actor->display_name,
-                'url' => $episodeComment->actor->uri,
+                'url'  => $episodeComment->actor->uri,
             ]),
-            'text' => $episodeComment->message,
+            'text'        => $episodeComment->message,
             'upvoteCount' => $episodeComment->likes_count,
         ]));
 
-        $metatags = new MetaTags();
-        $metatags
+        /** @var HtmlHead $head */
+        $head = service('html_head');
+
+        $head
             ->title(lang('Comment.title', [
                 'actorDisplayName' => $episodeComment->actor->display_name,
-                'episodeTitle' => $episodeComment->episode->title,
+                'episodeTitle'     => $episodeComment->episode->title,
             ]))
             ->description($episodeComment->message)
             ->image($episodeComment->actor->avatar_image_url)
             ->canonical((string) current_url())
             ->og('site_name', esc(service('settings')->get('App.siteName')))
-            ->push('link', [
-                'rel' => 'alternate',
+            ->tag('link', null, [
+                'rel'  => 'alternate',
                 'type' => 'application/activity+json',
                 'href' => url_to(
                     'episode-comment',
                     $episodeComment->actor->username,
                     $episodeComment->episode->slug,
-                    $episodeComment->id
+                    $episodeComment->id,
                 ),
-            ]);
-
-        return $metatags->__toString() . PHP_EOL . $schema->__toString();
+            ])->appendRawContent((string) $schema);
     }
 }
 
-if (! function_exists('get_follow_metatags')) {
-    function get_follow_metatags(Actor $actor): string
+if (! function_exists('set_follow_metatags')) {
+    function set_follow_metatags(Actor $actor): void
     {
-        $metatags = new MetaTags();
-        $metatags
+        /** @var HtmlHead $head */
+        $head = service('html_head');
+        $head
             ->title(lang('Podcast.followTitle', [
                 'actorDisplayName' => $actor->display_name,
             ]))
@@ -244,16 +237,15 @@ if (! function_exists('get_follow_metatags')) {
             ->image($actor->avatar_image_url)
             ->canonical((string) current_url())
             ->og('site_name', esc(service('settings')->get('App.siteName')));
-
-        return $metatags->__toString();
     }
 }
 
-if (! function_exists('get_remote_actions_metatags')) {
-    function get_remote_actions_metatags(Post $post, string $action): string
+if (! function_exists('set_remote_actions_metatags')) {
+    function set_remote_actions_metatags(Post $post, string $action): void
     {
-        $metatags = new MetaTags();
-        $metatags
+        /** @var HtmlHead $head */
+        $head = service('html_head');
+        $head
             ->title(lang('Fediverse.' . $action . '.title', [
                 'actorDisplayName' => $post->actor->display_name,
             ],))
@@ -261,42 +253,40 @@ if (! function_exists('get_remote_actions_metatags')) {
             ->image($post->actor->avatar_image_url)
             ->canonical((string) current_url())
             ->og('site_name', esc(service('settings')->get('App.siteName')));
-
-        return $metatags->__toString();
     }
 }
 
-if (! function_exists('get_home_metatags')) {
-    function get_home_metatags(): string
+if (! function_exists('set_home_metatags')) {
+    function set_home_metatags(): void
     {
-        $metatags = new MetaTags();
-        $metatags
+        /** @var HtmlHead $head */
+        $head = service('html_head');
+        $head
             ->title(service('settings')->get('App.siteName'))
             ->description(esc(service('settings')->get('App.siteDescription')))
-            ->image(service('settings')->get('App.siteIcon')['512'])
+            ->image(get_site_icon_url('512'))
             ->canonical((string) current_url())
             ->og('site_name', esc(service('settings')->get('App.siteName')));
 
-        return $metatags->__toString();
     }
 }
 
-if (! function_exists('get_page_metatags')) {
-    function get_page_metatags(Page $page): string
+if (! function_exists('set_page_metatags')) {
+    function set_page_metatags(Page $page): void
     {
-        $metatags = new MetaTags();
-        $metatags
+        /** @var HtmlHead $head */
+        $head = service('html_head');
+        $head
             ->title(
                 $page->title . service('settings')->get('App.siteTitleSeparator') . service(
-                    'settings'
-                )->get('App.siteName')
+                    'settings',
+                )->get('App.siteName'),
             )
             ->description(esc(service('settings')->get('App.siteDescription')))
-            ->image(service('settings')->get('App.siteIcon')['512'])
+            ->image(get_site_icon_url('512'))
             ->canonical((string) current_url())
             ->og('site_name', esc(service('settings')->get('App.siteName')));
 
-        return $metatags->__toString();
     }
 }
 

app/Helpers/svg_helper.php

@@ -8,39 +8,6 @@ declare(strict_types=1);
  * @link       https://castopod.org/
  */
 
-if (! function_exists('icon')) {
-    /**
-     * Returns the inline svg icon
-     *
-     * @param  string $name name of the icon file without the .svg extension
-     * @param  string $class to be added to the svg string
-     * @param string|null $type type of icon to be added
-     * @return string svg contents
-     */
-    function icon(string $name, string $class = '', string $type = null): string
-    {
-        if ($type !== null) {
-            $name = $type . '/' . $name;
-        }
-
-        try {
-            $svgContents = file_get_contents('assets/icons/' . $name . '.svg');
-        } catch (Exception) {
-            if ($type !== null) {
-                return icon('default', $class, $type);
-            }
-
-            return '□';
-        }
-
-        if ($class !== '') {
-            return str_replace('<svg', '<svg class="' . $class . '"', $svgContents);
-        }
-
-        return $svgContents;
-    }
-}
-
 if (! function_exists('svg')) {
     /**
      * Returns the inline svg image

app/Helpers/url_helper.php

@@ -16,13 +16,14 @@ if (! function_exists('host_url')) {
      */
     function host_url(): ?string
     {
-        if (isset($_SERVER['HTTP_HOST'])) {
+        $superglobals = service('superglobals');
+        if ($superglobals->server('HTTP_HOST') !== null) {
             $protocol =
-                (isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') ||
-                $_SERVER['SERVER_PORT'] === 443
+                ($superglobals->server('HTTPS') !== null && $superglobals->server('HTTPS') !== 'off') ||
+                (int) $superglobals->server('SERVER_PORT') === 443
                     ? 'https://'
                     : 'http://';
-            return $protocol . $_SERVER['HTTP_HOST'] . '/';
+            return $protocol . $superglobals->server('HTTP_HOST') . '/';
         }
 
         return null;
@@ -40,7 +41,9 @@ if (! function_exists('current_domain')) {
      */
     function current_domain(): string
     {
+        /** @var URI $uri */
         $uri = current_url(true);
+
         return $uri->getHost() . ($uri->getPort() ? ':' . $uri->getPort() : '');
     }
 }
@@ -74,7 +77,7 @@ if (! function_exists('extract_params_from_episode_uri')) {
 
         return [
             'podcastHandle' => $matches['podcastHandle'],
-            'episodeSlug' => $matches['episodeSlug'],
+            'episodeSlug'   => $matches['episodeSlug'],
         ];
     }
 }

app/Language/.rsync-filter

@@ -2,9 +2,11 @@
 + fr/***
 + pl/***
 + de/***
-+ pt-BR/***
-+ nn-NO/***
++ pt-br/***
++ nn-no/***
 + es/***
-+ zh-Hans/***
++ zh-hans/***
 + ca/***
++ br/***
++ sr-latn/***
 - **

app/Language/ar/Episode.php

@@ -23,6 +23,8 @@ return [
     'back_to_episodes' => 'العودة إلى حلقات {podcast}',
     'comments' => 'التعليقات',
     'activity' => 'النشاط',
+    'chapters' => 'Chapters',
+    'transcript' => 'Transcript',
     'description' => 'وصف الحلقة',
     'number_of_comments' => '{numberOfComments, plural,
         one {# comment}
@@ -30,4 +32,19 @@ return [
     }',
     'all_podcast_episodes' => 'كافة حلقات البودكاست',
     'back_to_podcast' => 'العودة إلى البودكاست',
+    'preview' => [
+        'title' => 'Preview',
+        'not_published' => 'Not published',
+        'text' => '{publication_status, select,
+            published {This episode is not yet published.}
+            scheduled {This episode is scheduled for publication on {publication_date}.}
+            with_podcast {This episode will be published at the same time as the podcast.}
+            other {This episode is not yet published.}
+        }',
+        'publish' => 'Publish',
+        'publish_edit' => 'Edit publication',
+    ],
+    'no_chapters' => 'No chapters are available for this episode.',
+    'download_transcript' => 'Download transcript ({extension})',
+    'no_transcript' => 'No transcript available for this episode.',
 ];

app/Language/ar/Podcast.php

@@ -25,6 +25,7 @@ return [
         one {# post}
         other {# posts}
     }',
+    'links' => 'Links',
     'activity' => 'النشاط',
     'episodes' => 'الحلقات',
     'episodes_title' => 'حلقات {podcastTitle}',
@@ -50,4 +51,5 @@ return [
         other {# persons}
     }',
     'persons_list' => 'أشخاص',
+    'castopod_website' => 'Castopod (website)',
 ];

app/Language/br/Comment.php

@@ -19,18 +19,16 @@ return [
     ],
     'likes' => '{numberOfLikes, plural,
         one {# muiañ-karet}
-        2 {# vuiañ-karet}
-        22 {# vuiañ-karet}
-        32 {# vuiañ-karet}
-        42 {# vuiañ-karet}
-        52 {# vuiañ-karet}
-        62 {# vuiañ-karet}
-        82 {# vuiañ-karet}
+        two {# vuiañ-karet}
+        few {# muiañ-karet}
+        many {# muiañ-karet}
         other {# muiañ-karet}
     }',
     'replies' => '{numberOfReplies, plural,
-        0 {respont ebet}
         one {# respont}
+        two {# respont}
+        few {# respont}
+        many {# respont}
         other {# respont}
     }',
     'like' => 'Muiañ-karet',

app/Language/br/Episode.php

@@ -16,27 +16,41 @@ return [
     'season_episode' => 'Koulzad {seasonNumber} rann {episodeNumber}',
     'season_episode_abbr' => 'K{seasonNumber}:R{episodeNumber}',
     'persons' => '{personsCount, plural,
-        0 {den ebet}
         one {# den}
         two {# zen}
+        few {# den}
+        many {# den}
         other {# den}
-        22 {# zen}
-        32 {# zen}
-        42 {# zen}
-        52 {# zen}
-        62 {# zen}
-        82 {# zen}
     }',
     'persons_list' => 'Emellerien·ezed',
     'back_to_episodes' => 'Mont da rannoù {podcast}',
     'comments' => 'Evezhiadennoù',
     'activity' => 'Oberiantiz',
+    'chapters' => 'Chabistroù',
+    'transcript' => 'Transcript',
     'description' => 'Deskrivadur ar rann',
     'number_of_comments' => '{numberOfComments, plural,
-        0 {evezhiadenn ebet}
         one {# evezhiadenn}
+        two {# evezhiadenn}
+        few {# evezhiadenn}
+        many {# evezhiadenn}
         other {# evezhiadenn}
     }',
     'all_podcast_episodes' => 'Holl rannoù ar podkast',
     'back_to_podcast' => 'Mont d\'ar podkast en-dro',
+    'preview' => [
+        'title' => 'Rakwel',
+        'not_published' => 'Diembann',
+        'text' => '{publication_status, select,
+            published {N\'eo ket bet embannet ar rann-mañ c\'hoazh.}
+            scheduled {Raktreset eo an embann a-benn an/ar {publication_date}.}
+            with_podcast {Ar rann-mañ a vo embannet war un dro gant ar podkast.}
+            other {N\'eo ket bet embannet ar rann-mañ c\'hoazh.}
+        }',
+        'publish' => 'Embann',
+        'publish_edit' => 'Kemmañ an embannadur',
+    ],
+    'no_chapters' => 'N\'eus chabistr ebet evit ar rann.',
+    'download_transcript' => 'Download transcript ({extension})',
+    'no_transcript' => 'No transcript available for this episode.',
 ];

app/Language/br/Podcast.php

@@ -9,108 +9,49 @@ declare(strict_types=1);
  */
 
 return [
-    'feed' => 'Lanv RSS ar podkast',
+    'feed' => 'Gwazh RSS ar podkast',
     'season' => 'Koulzad {seasonNumber}',
     'list_of_episodes_year' => 'Rannoù {year} ({episodeCount})',
     'list_of_episodes_season' =>
         'Rannoù koulzad {seasonNumber} ({episodeCount})',
     'no_episode' => 'N\'eo bet kavet rann ebet!',
     'follow' => 'Heuliañ',
-    'followTitle' => 'Heuliañ {actorDisplayName} war ar c\'hevrebed!',
+    'followTitle' => 'Heuliañ {actorDisplayName} war ar fediverse!',
     'followers' => '{numberOfFollowers, plural,
-        0 {heulier·ez ebet}
         one {# heulier·ez}
+        two {# heulier·ez}
+        few {# heulier·ez}
+        many {# heulier·ez}
         other {# heulier·ez}
     }',
     'posts' => '{numberOfPosts, plural,
-        0 {kemennadenn ebet}
-        1 {# gemennadenn}
-        2 {# gemennadenn}
-        3 {# c\'hemennadenn}
-        4 {# c\'hemennadenn}
-        9 {# c\'hemennadenn}
+        one {# gemennadenn}
+        two {# gemennadenn}
+        few {# c\'hemennadenn}
+        many {# kemennadenn}
         other {# kemennadenn}
-        21 {# gemennadenn}
-        22 {# gemennadenn}
-        23 {# c\'hemennadenn}
-        24 {# c\'hemennadenn}
-        29 {# c\'hemennadenn}
-        31 {# gemennadenn}
-        32 {# gemennadenn}
-        33 {# c\'hemennadenn}
-        34 {# c\'hemennadenn}
-        39 {# c\'hemennadenn}
-        41 {# gemennadenn}
-        42 {# gemennadenn}
-        43 {# c\'hemennadenn}
-        44 {# c\'hemennadenn}
-        49 {# c\'hemennadenn}
-        51 {# gemennadenn}
-        52 {# gemennadenn}
-        53 {# c\'hemennadenn}
-        54 {# c\'hemennadenn}
-        59 {# c\'hemennadenn}
-        61 {# gemennadenn}
-        62 {# gemennadenn}
-        63 {# c\'hemennadenn}
-        64 {# c\'hemennadenn}
-        69 {# c\'hemennadenn}
-        81 {# gemennadenn}
-        82 {# gemennadenn}
-        83 {# c\'hemennadenn}
-        84 {# c\'hemennadenn}
-        89 {# c\'hemennadenn}
     }',
-    'activity' => 'Oberiantiz',
+    'links' => 'Liammoù',
+    'activity' => 'Obererezh',
     'episodes' => 'Rannoù',
     'episodes_title' => 'Rannoù {podcastTitle}',
     'about' => 'A-zivout',
     'stats' => [
         'title' => 'Stadegoù',
         'number_of_seasons' => '{0, plural,
-        0 {koulzad ebet}
-        1 {# c\'houlzad}
-        2 {# goulzad}
-        3 {# c\'houlzad}
-        4 {# c\'houlzad}
-        9 {# c\'houlzad}
-        other {# koulzad}
-        21 {# c\'houlzad}
-        22 {# goulzad}
-        23 {# c\'houlzad}
-        24 {# c\'houlzad}
-        29 {# c\'houlzad}
-        31 {# c\'houlzad}
-        32 {# goulzad}
-        33 {# c\'houlzad}
-        34 {# c\'houlzad}
-        39 {# c\'houlzad}
-        41 {# c\'houlzad}
-        42 {# goulzad}
-        43 {# c\'houlzad}
-        44 {# c\'houlzad}
-        49 {# c\'houlzad}
-        51 {# c\'houlzad}
-        52 {# goulzad}
-        53 {# c\'houlzad}
-        54 {# c\'houlzad}
-        59 {# c\'houlzad}
-        61 {# c\'houlzad}
-        62 {# goulzad}
-        63 {# c\'houlzad}
-        64 {# c\'houlzad}
-        69 {# c\'houlzad}
-        81 {# c\'houlzad}
-        82 {# goulzad}
-        83 {# c\'houlzad}
-        84 {# c\'houlzad}
-        89 {# c\'houlzad}
-    }',
+            one {# c\'houlzad}
+            two {# goulzad}
+            few {# c\'houlzad}
+            many {# koulzad}
+            other {# koulzad}
+        }',
         'number_of_episodes' => '{0, plural,
-        0 {rann ebet}
-        one {# rann}
-        other {# rann}
-    }',
+            one {# rann}
+            two {# rann}
+            few {# rann}
+            many {# rann}
+            other {# rann}
+        }',
         'first_published_at' => 'Embannet eo bet ar rann gentañ d\'ar/d\'an {0, date, medium}',
     ],
     'sponsor' => 'Harpit',
@@ -118,16 +59,12 @@ return [
     'find_on' => 'Kavit {podcastTitle} war',
     'listen_on' => 'Selaouit war',
     'persons' => '{personsCount, plural,
-        0 {den ebet}
         one {# den}
         two {# zen}
+        few {# den}
+        many {# den}
         other {# den}
-        22 {# zen}
-        32 {# zen}
-        42 {# zen}
-        52 {# zen}
-        62 {# zen}
-        82 {# zen}
     }',
     'persons_list' => 'Emellerien·ezed',
+    'castopod_website' => 'Castopod (lec\'hienn)',
 ];

app/Language/ca/Episode.php

@@ -23,6 +23,8 @@ return [
     'back_to_episodes' => 'Tornar als episodis de {podcast}',
     'comments' => 'Comentaris',
     'activity' => 'Activitat',
+    'chapters' => 'Chapters',
+    'transcript' => 'Transcript',
     'description' => 'Descripció de l\'episodi',
     'number_of_comments' => '{numberOfComments, plural,
         one {# comentari}
@@ -30,4 +32,19 @@ return [
     }',
     'all_podcast_episodes' => 'Tots els episodis del podcast',
     'back_to_podcast' => 'Tornar al podcast',
+    'preview' => [
+        'title' => 'Preview',
+        'not_published' => 'Not published',
+        'text' => '{publication_status, select,
+            published {This episode is not yet published.}
+            scheduled {This episode is scheduled for publication on {publication_date}.}
+            with_podcast {This episode will be published at the same time as the podcast.}
+            other {This episode is not yet published.}
+        }',
+        'publish' => 'Publish',
+        'publish_edit' => 'Edit publication',
+    ],
+    'no_chapters' => 'No chapters are available for this episode.',
+    'download_transcript' => 'Download transcript ({extension})',
+    'no_transcript' => 'No transcript available for this episode.',
 ];

app/Language/ca/Podcast.php

@@ -25,6 +25,7 @@ return [
         one {# publicació}
         other {# publicacions}
     }',
+    'links' => 'Enllaços',
     'activity' => 'Activitat',
     'episodes' => 'Episodis',
     'episodes_title' => 'Episodis de {podcastTitle}',
@@ -50,4 +51,5 @@ return [
         other {# persones}
     }',
     'persons_list' => 'Persones',
+    'castopod_website' => 'Castopod (website)',
 ];