fix: itunes:explicit RSS tag content

Must have changed from yes/no/clean to the more sensible true/false at some point without us noticing. This updates it.

includes/explicit_content.php

@@ -13,7 +13,7 @@
             'type' => 'checkbox',
             'html' => ['style' => 'width: 200px;'],
             'default' => '-1',
-            'options' => [0 => 'no', 1 => 'yes', 2 => 'clean'],
+            'options' => [0 => 'false', 1 => 'true'],
         ],
         'position' => 770,
     ];

lib/feeds/base.php

@@ -287,7 +287,7 @@ function override_feed_head($hook, $podcast, $feed, $format)
         echo "\t".apply_filters('podlove_feed_itunes_block', $block);
         echo PHP_EOL;
 
-        $explicit = sprintf('<itunes:explicit>%s</itunes:explicit>', ($podcast->explicit == 2) ? 'clean' : (($podcast->explicit) ? 'yes' : 'no'));
+        $explicit = sprintf('<itunes:explicit>%s</itunes:explicit>', $podcast->explicit_text());
         echo "\t".apply_filters('podlove_feed_itunes_explicit', $explicit);
         echo PHP_EOL;
 

lib/model/episode.php

@@ -224,11 +224,12 @@ public function categories($args = [])
 
     public function explicit_text()
     {
+        // backwards compatibility
         if ($this->explicit == 2) {
-            return 'clean';
+            return 'false';
         }
 
-        return $this->explicit ? 'yes' : 'no';
+        return $this->explicit ? 'true' : 'false';
     }
 
     public function media_files($args = [])

lib/model/podcast.php

@@ -235,6 +235,16 @@ public function default_copyright_claim()
         return '© '.date('Y').' '.($this->author_name ?? $this->title);
     }
 
+    public function explicit_text()
+    {
+        // backwards compatibility
+        if ($this->explicit == 2) {
+            return 'false';
+        }
+
+        return $this->explicit ? 'true' : 'false';
+    }
+
     /**
      * Episodes.
      *

lib/settings/podcast/tab/directory.php

@@ -124,9 +124,8 @@ public function register_page()
 
             $wrapper->select('explicit', [
                 'label' => __('Explicit Content?', 'podlove-podcasting-plugin-for-wordpress'),
-                'description' => __('', 'podlove-podcasting-plugin-for-wordpress'),
-                'type' => 'checkbox',
-                'options' => [0 => 'no', 1 => 'yes', 2 => 'clean'],
+                'description' => __('True: If you specify true, indicating the presence of explicit content, directories may display an Explicit parental advisory graphic for your podcast. False: If you specify false, indicating that your podcast does not contain explicit language or adult content, directories may display a Clean parental advisory graphic for your podcast.', 'podlove-podcasting-plugin-for-wordpress'),
+                'options' => [0 => 'false', 1 => 'true'],
             ]);
 
             $wrapper->checkbox('complete', [

lib/template/episode.php

@@ -213,7 +213,7 @@ public function recordingDate($format = '')
     /**
      * Explicit status.
      *
-     * "yes", "no" or "clean"
+     * "true" or "false"
      *
      * @accessor
      */

lib/version.php

@@ -42,7 +42,7 @@
 
 use Podlove\Jobs\CronJobRunner;
 
-define('Podlove\DATABASE_VERSION', 156);
+define('Podlove\DATABASE_VERSION', 157);
 
 add_action('admin_init', '\Podlove\maybe_run_database_migrations');
 add_action('admin_init', '\Podlove\run_database_migrations', 5);
@@ -1653,6 +1653,16 @@ function run_migrations_for_version($version)
             $podcast->feed_transcripts = 'generated';
             $podcast->save();
 
+            break;
+        case 157:
+            $podcast = Model\Podcast::get();
+
+            // update deprecated "clean" value to "false"
+            if ($podcast->explicit == 2) {
+              $podcast->explicit = 0;
+              $podcast->save();
+            }
+
             break;
     }
 }

readme.txt

@@ -117,6 +117,7 @@ This product includes GeoLite2 data created by MaxMind, available from http://ww
 
 = 4.1.7 =
 
+* fix `itunes:explicit` RSS tag. It now contains the valid values "true" or "false".
 * fix typo in API: `explicit` field was mistyped as `expicit`
 
 = 4.1.6 =