mauricerenck / kirby-podcaster

Kirby Podcast Plugin

Podcaster

A Kirby Podcast Plugin

---

Features

• ✅ Ready for Kirby 4
• ✅ Panel blueprint for a full featured RSS feed
• ✅ Run multiple podcasts with just one Kirby installation
• ✅ Panel blueprint for episodes details
• ✅ Podcaster Analytics with detailed metrics
• ✅ Tracking of episodes/feeds using Matomo
• ✅ Tracking of episodes using PodTrac
• ✅ Podcast Chapters
• ✅ Snippet for a simple HTML5-Player
• ✅ Snippet for the advanced Podlove Player
• ✅ Configure and style your website player within the panel

Installation

This version of the plugin requires Kirby 3.9.0 or higher. The recommended way of installing is by using Composer:

composer require mauricerenck/podcaster

Or download the latest release unzip it, copy it to site/plugins/podcaster

---

Setup

There is a full video guide on setting up your podcast step by step on the Podcaster Website

• Setup your podcast
• Setup analytics
• Setup Podlove Player
• Podcaster in your templates
• Podcaster Snippets
• Advanced Settings
• Migrate from version 2
• List of all fields
• List of all options

kirby-podcaster's Issues

Improve handling of missing ID3 data

If no ID3 data is set, error messages are thrown in the panel after upload.

Panel: Statistics and Wizard throw errors

Since the latest Kirby update the stats page and the wizard throw the following error:
this.$store.state.form is undefined

Umlaute in chapter titles are displayed as encoded characters

Currently using Umlaute in chapter titles show up as encoded characters. The reasons for this seems to be that the titles are passed into Xml::encode, which is a security measurement. I wonder if there is a similar function in kirby that keeps the security but allows using Umlaute to fix this issue?

feedRSS - Wrong date format with config intl date handler

Thanks for your plugin, it's really great 🙂

I created a podcast in french, on my website. I did config kirby date.handler with intl to have date in french.
But it create wrong date in the RSS feed : 91, 31 3 2024 0:: instead of Sun, 31 Mar 2024 00:00:00 +0100.

Conflict with toFile()

Hi, I'm using clean install of Zero One theme. If i add podcaster to it, i'm faced with the following error on each call of the toFile() function:

Example call: cover()->toFile()): ?>

Error thrown with message "Call to a member function toFile() on null"

Stacktrace:
#9 Error in /var/www/-/html/site/plugins/zero-one/templates/blog.php:31
#8 include in /var/www/-/html/kirby/src/Filesystem/F.php:425
#7 Kirby\Filesystem\F:loadIsolated in /var/www/-html/kirby/src/Filesystem/F.php:364
#6 Kirby\Filesystem\F:Kirby\Filesystem{closure} in /var/www/-/html/kirby/src/Filesystem/F.php:372
#5 Kirby\Filesystem\F:load in /var/www/-/html/kirby/src/Toolkit/Tpl.php:36
#4 Kirby\Toolkit\Tpl:load in /var/www/-/html/kirby/src/Template/Template.php:155
#3 Kirby\Template\Template:render in /var/www/-/html/kirby/src/Cms/Page.php:1071
#2 Kirby\Cms\Page:render in /var/www/-/html/kirby/src/Cms/App.php:800
#1 Kirby\Cms\App:io in /var/www/-/html/kirby/src/Cms/App.php:1239
#0 Kirby\Cms\App:render in /var/www/-/html/index.php:17

What i have tried:

• Update kirby (was 2 updates behind, now on latest 3.9
• Switch between PHP 8.1/8.2
• Remove podcaster plugin folder; instant "fix"

I hope you can help me and this is enough info, if not please let me know what you need.

Missing language tag in RSS feed

The iTunes Podcast Validator can't find a language tag. The language entry says:

ITC.PodcastsConnect.language.null

use download trigger word in rout

ID3 detection throws error if no data

Try to catch those errors:
Undefined index: tags_html

Can't upload cover art for episodes

There is no way to set the episode cover art in the panel if it wasn't already set in the mp3 metadata. I can only select uploaded files, not upload any new files.

API Timeouts

When running the plugin locally with the php server, API requests for language, categories and podlove data are getting very slow and run into timeouts (see: https://forum.getkirby.com/t/podcaster-plugin-problem-fetching-apple-data).

Podlove player doesn't work properly

I'm working on local host

The error message I posted has not been seen again, but the issue I have is that the podloveplayer is not rendered. The HTML5 audio player is rendered.

I Inspect the DOM and I can see the js for the podlove player is inserted but it's not visible

If you need info, please ask!

[Feature Request] Make the podcast cover image optional

Currently the poster cover image of the podcast is not required in the panel, but not adding an image breaks the Podlove player snippet.

I’d suggest to keep the poster image optional and fix the code that generates the JSON config for the Podlove player. It can be configured to work without an image.

Call to a member function query() on null

Hey there,

I’ve tried to set up the podcaster plugin on my server after successfully installing it locally. But whenever I enable the sqlite statistics I receive the following error, opening the website:

Call to a member function query() on null.

Any idea what might cause the issue?

"Class 'GetId3\GetId3Core' not found" when uploading audio file

Whenever I upload an audio file I get
Class 'GetId3\GetId3Core' not found
This error was already occurring in earlier versions of this plugin, I just ignored it until now.

My guess is that it's released to the mp3scan symlink, because I'm not able to upload or create symlinks on my server. I tried working around that problem by creating a symlink with php, but that didn't fix the GetId3 error:
<?php $target = 'vendor/wapmorgan/mp3info/bin/mp3scan'; $link = 'vendor/bin/mp3scan'; symlink($target, $link); echo readlink($link); ?>

Can't get the plugin to work / How to add episodes?

Hey there,

I can't get this plugin to work. I get this whenever I try to open the feed:

Call to a member function podcasterMatomoFeedEnabled() on null

I guess that's because it doesn't find any episodes? If yes, how do I add them?

My current page setup is:

kirby/
├── home/
├── contact/
├── [...]
└── podcast/
   ├── feed
   ├── episode-1

My "Source Page" is "podcast". I'm using the podcasterfeed blueprint for the feed page and the following blueprint for my episode site:

title: Podcast Episode
tabs:
    podcast:
        extends: tabs/podcasterepisode

My mp3 file is uploaded to the "podcasterMp3" field within the episode-1 panel.

Kirby API errors

{"status":"error","message":"Unauthenticated","code":401,"exception":"Kirby\\Exception\\AuthException","key":"error.auth","file":"\/kirby\/config\/api\/authentication.php","line":14,"details":[],"route":"podcaster\/stats\/graph\/feeds\/([a-zA-Z0-9\\.\\-_%= \\+\\@\\(\\)]+)"}

PHP Deprecated: Array and string offset access syntax with curly braces is deprecated

With Kirby V3 and PHP v7.4.1:

Deprecated: Array and string offset access syntax with curly braces is deprecated in /Users/felixhaberle/Sites/format-plus/website/site/plugins/podcaster/lib/PiwikTracker.php on line 476

I think this can be fixed with changing $domain{$dl} to $domain[$dl]. Thank you!

Custom Links for Episodes

I would like to define the URL to which my episodes should be redirected when a user clicks on the episode link. This makes sense if UTM parameters etc. are attached to the URL or a short link is to be used.

Allow other audio formats

extend the plugin to not only support mp3 files