*/ protected $casts = [ 'id' => 'integer', 'actor_id' => 'integer', 'name' => 'string', 'title' => 'string', 'description_markdown' => 'string', 'description_html' => 'string', 'image_path' => 'string', 'image_mimetype' => 'string', 'language_code' => 'string', 'category_id' => 'integer', 'parental_advisory' => '?string', 'publisher' => '?string', 'owner_name' => 'string', 'owner_email' => 'string', 'type' => 'string', 'copyright' => '?string', 'episode_description_footer_markdown' => '?string', 'episode_description_footer_html' => '?string', 'is_blocked' => 'boolean', 'is_completed' => 'boolean', 'is_locked' => 'boolean', 'imported_feed_url' => '?string', 'new_feed_url' => '?string', 'location_name' => '?string', 'location_geo' => '?string', 'location_osm' => '?string', 'payment_pointer' => '?string', 'custom_rss' => '?json-array', 'partner_id' => '?string', 'partner_link_url' => '?string', 'partner_image_url' => '?string', 'created_by' => 'integer', 'updated_by' => 'integer', ]; public function getActor(): Actor { if ($this->actor_id === 0) { throw new RuntimeException('Podcast must have an actor_id before getting actor.',); } if ($this->actor === null) { $this->actor = model('ActorModel') ->getActorById($this->actor_id); } return $this->actor; } /** * Saves a cover image to the corresponding podcast folder in `public/media/podcast_name/` */ public function setImage(Image $image): static { // Save image $image->saveImage('podcasts/' . $this->attributes['name'], 'cover'); $this->attributes['image_mimetype'] = $image->mimetype; $this->attributes['image_path'] = $image->path; return $this; } public function getImage(): Image { return new Image(null, $this->image_path, $this->image_mimetype); } public function getLink(): string { return url_to('podcast-activity', $this->attributes['name']); } public function getFeedUrl(): string { return url_to('podcast_feed', $this->attributes['name']); } /** * Returns the podcast's episodes * * @return Episode[] */ public function getEpisodes(): array { if ($this->id === null) { throw new RuntimeException('Podcast must be created before getting episodes.',); } if ($this->episodes === null) { $this->episodes = (new EpisodeModel())->getPodcastEpisodes($this->id, $this->type,); } return $this->episodes; } /** * Returns the podcast's persons * * @return Person[] */ public function getPersons(): array { if ($this->id === null) { throw new RuntimeException('Podcast must be created before getting persons.',); } if ($this->persons === null) { $this->persons = (new PersonModel())->getPodcastPersons($this->id); } return $this->persons; } /** * Returns the podcast category entity */ public function getCategory(): ?Category { if ($this->id === null) { throw new RuntimeException('Podcast must be created before getting category.',); } if ($this->category === null) { $this->category = (new CategoryModel())->getCategoryById($this->category_id,); } return $this->category; } /** * Returns all podcast contributors * * @return User[] */ public function getContributors(): array { if ($this->id === null) { throw new RuntimeException('Podcasts must be created before getting contributors.',); } if ($this->contributors === null) { $this->contributors = (new UserModel())->getPodcastContributors($this->id,); } return $this->contributors; } public function setDescriptionMarkdown(string $descriptionMarkdown): static { $converter = new CommonMarkConverter([ 'html_input' => 'strip', 'allow_unsafe_links' => false, ]); $this->attributes['description_markdown'] = $descriptionMarkdown; $this->attributes['description_html'] = $converter->convertToHtml($descriptionMarkdown,); return $this; } public function setEpisodeDescriptionFooterMarkdown(?string $episodeDescriptionFooterMarkdown = null): static { if ($episodeDescriptionFooterMarkdown) { $converter = new CommonMarkConverter([ 'html_input' => 'strip', 'allow_unsafe_links' => false, ]); $this->attributes[ 'episode_description_footer_markdown' ] = $episodeDescriptionFooterMarkdown; $this->attributes[ 'episode_description_footer_html' ] = $converter->convertToHtml($episodeDescriptionFooterMarkdown); } return $this; } public function getDescription(): string { if ($this->description === null) { $this->description = trim( (string) preg_replace('~\s+~', ' ', strip_tags($this->attributes['description_html']),), ); } return $this->description; } /** * Returns the podcast's podcasting platform links * * @return Platform[] */ public function getPodcastingPlatforms(): array { if ($this->id === null) { throw new RuntimeException('Podcast must be created before getting podcasting platform links.',); } if ($this->podcasting_platforms === null) { $this->podcasting_platforms = (new PlatformModel())->getPodcastPlatforms($this->id, 'podcasting',); } return $this->podcasting_platforms; } /** * Returns the podcast's social platform links * * @return Platform[] */ public function getSocialPlatforms(): array { if ($this->id === null) { throw new RuntimeException('Podcast must be created before getting social platform links.',); } if ($this->social_platforms === null) { $this->social_platforms = (new PlatformModel())->getPodcastPlatforms($this->id, 'social',); } return $this->social_platforms; } /** * Returns the podcast's funding platform links * * @return Platform[] */ public function getFundingPlatforms(): array { if ($this->id === null) { throw new RuntimeException('Podcast must be created before getting funding platform links.',); } if ($this->funding_platforms === null) { $this->funding_platforms = (new PlatformModel())->getPodcastPlatforms($this->id, 'funding',); } return $this->funding_platforms; } /** * @return Category[] */ public function getOtherCategories(): array { if ($this->id === null) { throw new RuntimeException('Podcast must be created before getting other categories.',); } if ($this->other_categories === null) { $this->other_categories = (new CategoryModel())->getPodcastCategories($this->id,); } return $this->other_categories; } /** * @return int[] */ public function getOtherCategoriesIds(): array { if ($this->other_categories_ids === null) { $this->other_categories_ids = array_column($this->getOtherCategories(), 'id',); } return $this->other_categories_ids; } /** * Saves the location name and fetches OpenStreetMap info */ public function setLocation(?Location $location = null): static { if ($location === null) { $this->attributes['location_name'] = null; $this->attributes['location_geo'] = null; $this->attributes['location_osm'] = null; return $this; } if ( ! isset($this->attributes['location_name']) || $this->attributes['location_name'] !== $location->name ) { $location->fetchOsmLocation(); $this->attributes['location_name'] = $location->name; $this->attributes['location_geo'] = $location->geo; $this->attributes['location_osm'] = $location->osm; } return $this; } public function getLocation(): ?Location { if ($this->location_name === null) { return null; } if ($this->location === null) { $this->location = new Location($this->location_name, $this->location_geo, $this->location_osm,); } return $this->location; } /** * Get custom rss tag as XML String */ public function getCustomRssString(): string { if ($this->attributes['custom_rss'] === null) { return ''; } helper('rss'); $xmlNode = (new SimpleRSSElement( '', ))->addChild('channel'); array_to_rss([ 'elements' => $this->custom_rss, ], $xmlNode,); return str_replace(['', ''], '', $xmlNode->asXML()); } /** * Saves custom rss tag into json */ public function setCustomRssString(string $customRssString): static { if ($customRssString === '') { return $this; } helper('rss'); $customRssArray = rss_to_array( simplexml_load_string( '' . $customRssString . '', ), )['elements'][0]; if (array_key_exists('elements', $customRssArray)) { $this->attributes['custom_rss'] = json_encode($customRssArray['elements'],); } else { $this->attributes['custom_rss'] = null; } return $this; } }