'integer', 'title' => 'string', 'name' => 'string', 'description_markdown' => 'string', 'description_html' => 'string', 'image_uri' => '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_osmid' => '?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', ]; /** * Saves a cover image to the corresponding podcast folder in `public/media/podcast_name/` * * @param \CodeIgniter\HTTP\Files\UploadedFile|\CodeIgniter\Files\File $image * */ public function setImage($image = null) { if ($image) { helper('media'); $this->attributes['image_uri'] = save_podcast_media( $image, $this->attributes['name'], 'cover' ); $this->image = new \App\Entities\Image( $this->attributes['image_uri'] ); $this->image->saveSizes(); } return $this; } public function getImage() { return new \App\Entities\Image($this->attributes['image_uri']); } public function getLink() { return base_url(route_to('podcast', $this->attributes['name'])); } public function getFeedUrl() { return base_url(route_to('podcast_feed', $this->attributes['name'])); } /** * Returns the podcast's episodes * * @return \App\Entities\Episode[] */ public function getEpisodes() { if (empty($this->id)) { throw new \RuntimeException( 'Podcast must be created before getting episodes.' ); } if (empty($this->episodes)) { $this->episodes = (new EpisodeModel())->getPodcastEpisodes( $this->id, $this->type ); } return $this->episodes; } /** * Returns the podcast's persons * * @return \App\Entities\PodcastPerson[] */ public function getPodcastPersons() { if (empty($this->id)) { throw new \RuntimeException( 'Podcast must be created before getting persons.' ); } if (empty($this->podcast_persons)) { $this->podcast_persons = (new PodcastPersonModel())->getPersonsByPodcastId( $this->id ); } return $this->podcast_persons; } /** * Returns the podcast category entity * * @return \App\Entities\Category */ public function getCategory() { if (empty($this->id)) { throw new \RuntimeException( 'Podcast must be created before getting category.' ); } if (empty($this->category)) { $this->category = (new CategoryModel())->find($this->category_id); } return $this->category; } /** * Returns all podcast contributors * * @return \App\Entities\User[] */ public function getContributors() { if (empty($this->id)) { throw new \RuntimeException( 'Podcasts must be created before getting contributors.' ); } if (empty($this->contributors)) { $this->contributors = (new UserModel())->getPodcastContributors( $this->id ); } return $this->contributors; } public function setDescriptionMarkdown(string $descriptionMarkdown) { $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 ) { 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() { if ($this->description) { return $this->description; } return trim( preg_replace( '/\s+/', ' ', strip_tags($this->attributes['description_html']) ) ); } public function setCreatedBy(\App\Entities\User $user) { $this->attributes['created_by'] = $user->id; return $this; } public function setUpdatedBy(\App\Entities\User $user) { $this->attributes['updated_by'] = $user->id; return $this; } /** * Returns the podcast's podcasting platform links * * @return \App\Entities\Platform[] */ public function getPodcastingPlatforms() { if (empty($this->id)) { throw new \RuntimeException( 'Podcast must be created before getting podcasting platform links.' ); } if (empty($this->podcastingPlatforms)) { $this->podcastingPlatforms = (new PlatformModel())->getPodcastPlatforms( $this->id, 'podcasting' ); } return $this->podcastingPlatforms; } /** * Returns true if the podcast has podcasting platform links */ public function getHasPodcastingPlatforms() { if (empty($this->id)) { throw new \RuntimeException( 'Podcast must be created before getting podcasting platform.' ); } foreach ($this->getPodcastingPlatforms() as $podcastingPlatform) { if ($podcastingPlatform->is_on_embeddable_player) { return true; } } return false; } /** * Returns the podcast's social platform links * * @return \App\Entities\Platform[] */ public function getSocialPlatforms() { if (empty($this->id)) { throw new \RuntimeException( 'Podcast must be created before getting social platform links.' ); } if (empty($this->socialPlatforms)) { $this->socialPlatforms = (new PlatformModel())->getPodcastPlatforms( $this->id, 'social' ); } return $this->socialPlatforms; } /** * Returns true if the podcast has social platform links */ public function getHasSocialPlatforms() { if (empty($this->id)) { throw new \RuntimeException( 'Podcast must be created before getting social platform.' ); } foreach ($this->getSocialPlatforms() as $socialPlatform) { if ($socialPlatform->is_on_embeddable_player) { return true; } } return false; } /** * Returns the podcast's funding platform links * * @return \App\Entities\Platform[] */ public function getFundingPlatforms() { if (empty($this->id)) { throw new \RuntimeException( 'Podcast must be created before getting funding platform links.' ); } if (empty($this->fundingPlatforms)) { $this->fundingPlatforms = (new PlatformModel())->getPodcastPlatforms( $this->id, 'funding' ); } return $this->fundingPlatforms; } /** * Returns true if the podcast has social platform links */ public function getHasFundingPlatforms() { if (empty($this->id)) { throw new \RuntimeException( 'Podcast must be created before getting Funding platform.' ); } foreach ($this->getFundingPlatforms() as $fundingPlatform) { if ($fundingPlatform->is_on_embeddable_player) { return true; } } return false; } public function getOtherCategories() { if (empty($this->id)) { throw new \RuntimeException( 'Podcast must be created before getting other categories.' ); } if (empty($this->other_categories)) { $this->other_categories = (new CategoryModel())->getPodcastCategories( $this->id ); } return $this->other_categories; } public function getOtherCategoriesIds() { if (empty($this->other_categories_ids)) { $this->other_categories_ids = array_column( $this->getOtherCategories(), 'id' ); } return $this->other_categories_ids; } /** * Saves the location name and fetches OpenStreetMap info * * @param string $locationName * */ public function setLocation($locationName = null) { helper('location'); if ( $locationName && (empty($this->attributes['location_name']) || $this->attributes['location_name'] != $locationName) ) { $this->attributes['location_name'] = $locationName; if ($location = fetch_osm_location($locationName)) { $this->attributes['location_geo'] = $location['geo']; $this->attributes['location_osmid'] = $location['osmid']; } } elseif (empty($locationName)) { $this->attributes['location_name'] = null; $this->attributes['location_geo'] = null; $this->attributes['location_osmid'] = null; } return $this; } /** * Get custom rss tag as XML String * * @return string * */ function getCustomRssString() { helper('rss'); if (empty($this->attributes['custom_rss'])) { return ''; } else { $xmlNode = (new \App\Libraries\SimpleRSSElement( '' ))->addChild('channel'); array_to_rss( [ 'elements' => $this->custom_rss, ], $xmlNode ); return str_replace( ['', ''], '', $xmlNode->asXML() ); } } /** * Saves custom rss tag into json * * @param string $customRssString * */ function setCustomRssString($customRssString) { 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; } } }