mirror of
https://code.castopod.org/adaures/castopod
synced 2025-04-23 01:01:20 +00:00
568 lines
14 KiB
PHP
568 lines
14 KiB
PHP
<?php
|
||
|
||
/**
|
||
* @copyright 2020 Podlibre
|
||
* @license https://www.gnu.org/licenses/agpl-3.0.en.html AGPL3
|
||
* @link https://castopod.org/
|
||
*/
|
||
|
||
namespace App\Entities;
|
||
|
||
use App\Models\PodcastModel;
|
||
use App\Models\SoundbiteModel;
|
||
use App\Models\EpisodePersonModel;
|
||
use CodeIgniter\Entity;
|
||
use CodeIgniter\I18n\Time;
|
||
use League\CommonMark\CommonMarkConverter;
|
||
|
||
class Episode extends Entity
|
||
{
|
||
/**
|
||
* @var \App\Entities\Podcast
|
||
*/
|
||
protected $podcast;
|
||
|
||
/**
|
||
* @var string
|
||
*/
|
||
protected $link;
|
||
|
||
/**
|
||
* @var \App\Entities\Image
|
||
*/
|
||
protected $image;
|
||
|
||
/**
|
||
* @var \CodeIgniter\Files\File
|
||
*/
|
||
protected $enclosure;
|
||
|
||
/**
|
||
* @var \CodeIgniter\Files\File
|
||
*/
|
||
protected $transcript;
|
||
|
||
/**
|
||
* @var \CodeIgniter\Files\File
|
||
*/
|
||
protected $chapters;
|
||
|
||
/**
|
||
* @var string
|
||
*/
|
||
protected $enclosure_media_path;
|
||
|
||
/**
|
||
* @var string
|
||
*/
|
||
protected $enclosure_url;
|
||
|
||
/**
|
||
* @var string
|
||
*/
|
||
protected $enclosure_web_url;
|
||
|
||
/**
|
||
* @var string
|
||
*/
|
||
protected $enclosure_opengraph_url;
|
||
|
||
/**
|
||
* @var string
|
||
*/
|
||
protected $transcript_url;
|
||
|
||
/**
|
||
* @var string
|
||
*/
|
||
protected $chapters_url;
|
||
|
||
/**
|
||
* @var \App\Entities\EpisodePerson[]
|
||
*/
|
||
protected $episode_persons;
|
||
|
||
/**
|
||
* @var \App\Entities\Soundbite[]
|
||
*/
|
||
protected $soundbites;
|
||
|
||
/**
|
||
* Holds text only description, striped of any markdown or html special characters
|
||
*
|
||
* @var string
|
||
*/
|
||
protected $description;
|
||
|
||
/**
|
||
* The embeddable player URL
|
||
*
|
||
* @var string
|
||
*/
|
||
protected $embeddable_player;
|
||
|
||
/**
|
||
* @var string
|
||
*/
|
||
protected $publication_status;
|
||
|
||
protected $dates = [
|
||
'published_at',
|
||
'created_at',
|
||
'updated_at',
|
||
'deleted_at',
|
||
];
|
||
|
||
protected $casts = [
|
||
'id' => 'integer',
|
||
'guid' => 'string',
|
||
'slug' => 'string',
|
||
'title' => 'string',
|
||
'enclosure_uri' => 'string',
|
||
'enclosure_duration' => 'integer',
|
||
'enclosure_mimetype' => 'string',
|
||
'enclosure_filesize' => 'integer',
|
||
'enclosure_headersize' => 'integer',
|
||
'description_markdown' => 'string',
|
||
'description_html' => 'string',
|
||
'image_uri' => '?string',
|
||
'transcript_uri' => '?string',
|
||
'chapters_uri' => '?string',
|
||
'parental_advisory' => '?string',
|
||
'number' => '?integer',
|
||
'season_number' => '?integer',
|
||
'type' => 'string',
|
||
'is_blocked' => 'boolean',
|
||
'location_name' => '?string',
|
||
'location_geo' => '?string',
|
||
'location_osmid' => '?string',
|
||
'created_by' => 'integer',
|
||
'updated_by' => 'integer',
|
||
];
|
||
|
||
/**
|
||
* Saves an episode image
|
||
*
|
||
* @param \CodeIgniter\HTTP\Files\UploadedFile|\CodeIgniter\Files\File $image
|
||
*
|
||
*/
|
||
public function setImage($image)
|
||
{
|
||
if (
|
||
!empty($image) &&
|
||
(!($image instanceof \CodeIgniter\HTTP\Files\UploadedFile) ||
|
||
$image->isValid())
|
||
) {
|
||
helper('media');
|
||
|
||
// check whether the user has inputted an image and store it
|
||
$this->attributes['image_uri'] = save_podcast_media(
|
||
$image,
|
||
$this->getPodcast()->name,
|
||
$this->attributes['slug']
|
||
);
|
||
|
||
$this->image = new \App\Entities\Image(
|
||
$this->attributes['image_uri']
|
||
);
|
||
$this->image->saveSizes();
|
||
}
|
||
|
||
return $this;
|
||
}
|
||
|
||
public function getImage(): \App\Entities\Image
|
||
{
|
||
if ($image_uri = $this->attributes['image_uri']) {
|
||
return new \App\Entities\Image($image_uri);
|
||
}
|
||
return $this->getPodcast()->image;
|
||
}
|
||
|
||
/**
|
||
* Saves an enclosure
|
||
*
|
||
* @param \CodeIgniter\HTTP\Files\UploadedFile|\CodeIgniter\Files\File $enclosure
|
||
*
|
||
*/
|
||
public function setEnclosure($enclosure = null)
|
||
{
|
||
if (
|
||
!empty($enclosure) &&
|
||
(!($enclosure instanceof \CodeIgniter\HTTP\Files\UploadedFile) ||
|
||
$enclosure->isValid())
|
||
) {
|
||
helper(['media', 'id3']);
|
||
|
||
$enclosure_metadata = get_file_tags($enclosure);
|
||
|
||
$this->attributes['enclosure_uri'] = save_podcast_media(
|
||
$enclosure,
|
||
$this->getPodcast()->name,
|
||
$this->attributes['slug']
|
||
);
|
||
$this->attributes['enclosure_duration'] = round(
|
||
$enclosure_metadata['playtime_seconds']
|
||
);
|
||
$this->attributes['enclosure_mimetype'] =
|
||
$enclosure_metadata['mime_type'];
|
||
$this->attributes['enclosure_filesize'] =
|
||
$enclosure_metadata['filesize'];
|
||
$this->attributes['enclosure_headersize'] =
|
||
$enclosure_metadata['avdataoffset'];
|
||
|
||
return $this;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Saves an episode transcript
|
||
*
|
||
* @param \CodeIgniter\HTTP\Files\UploadedFile|\CodeIgniter\Files\File $transcript
|
||
*
|
||
*/
|
||
public function setTranscript($transcript)
|
||
{
|
||
if (
|
||
!empty($transcript) &&
|
||
(!($transcript instanceof \CodeIgniter\HTTP\Files\UploadedFile) ||
|
||
$transcript->isValid())
|
||
) {
|
||
helper('media');
|
||
|
||
$this->attributes['transcript_uri'] = save_podcast_media(
|
||
$transcript,
|
||
$this->getPodcast()->name,
|
||
$this->attributes['slug'] . '-transcript'
|
||
);
|
||
}
|
||
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* Saves an episode chapters
|
||
*
|
||
* @param \CodeIgniter\HTTP\Files\UploadedFile|\CodeIgniter\Files\File $chapters
|
||
*
|
||
*/
|
||
public function setChapters($chapters)
|
||
{
|
||
if (
|
||
!empty($chapters) &&
|
||
(!($chapters instanceof \CodeIgniter\HTTP\Files\UploadedFile) ||
|
||
$chapters->isValid())
|
||
) {
|
||
helper('media');
|
||
|
||
$this->attributes['chapters_uri'] = save_podcast_media(
|
||
$chapters,
|
||
$this->getPodcast()->name,
|
||
$this->attributes['slug'] . '-chapters'
|
||
);
|
||
}
|
||
|
||
return $this;
|
||
}
|
||
|
||
public function getEnclosure()
|
||
{
|
||
return new \CodeIgniter\Files\File($this->getEnclosureMediaPath());
|
||
}
|
||
|
||
public function getTranscript()
|
||
{
|
||
return $this->attributes['transcript_uri']
|
||
? new \CodeIgniter\Files\File($this->getTranscriptMediaPath())
|
||
: null;
|
||
}
|
||
|
||
public function getChapters()
|
||
{
|
||
return $this->attributes['chapters_uri']
|
||
? new \CodeIgniter\Files\File($this->getChaptersMediaPath())
|
||
: null;
|
||
}
|
||
|
||
public function getEnclosureMediaPath()
|
||
{
|
||
helper('media');
|
||
|
||
return media_path($this->attributes['enclosure_uri']);
|
||
}
|
||
|
||
public function getTranscriptMediaPath()
|
||
{
|
||
helper('media');
|
||
|
||
return $this->attributes['transcript_uri']
|
||
? media_path($this->attributes['transcript_uri'])
|
||
: null;
|
||
}
|
||
|
||
public function getChaptersMediaPath()
|
||
{
|
||
helper('media');
|
||
|
||
return $this->attributes['chapters_uri']
|
||
? media_path($this->attributes['chapters_uri'])
|
||
: null;
|
||
}
|
||
|
||
public function getEnclosureUrl()
|
||
{
|
||
helper('analytics');
|
||
|
||
return base_url(
|
||
route_to(
|
||
'analytics_hit',
|
||
base64_url_encode(
|
||
pack(
|
||
'I*',
|
||
$this->attributes['podcast_id'],
|
||
$this->attributes['id'],
|
||
// bytes_threshold: number of bytes that must be downloaded for an episode to be counted in download analytics
|
||
// - if file is shorter than 60sec, then it's enclosure_filesize
|
||
// - if file is longer than 60 seconds then it's enclosure_headersize + 60 seconds
|
||
$this->attributes['enclosure_duration'] <= 60
|
||
? $this->attributes['enclosure_filesize']
|
||
: $this->attributes['enclosure_headersize'] +
|
||
floor(
|
||
(($this->attributes['enclosure_filesize'] -
|
||
$this->attributes[
|
||
'enclosure_headersize'
|
||
]) /
|
||
$this->attributes[
|
||
'enclosure_duration'
|
||
]) *
|
||
60
|
||
),
|
||
$this->attributes['enclosure_filesize'],
|
||
$this->attributes['enclosure_duration'],
|
||
strtotime($this->attributes['published_at'])
|
||
)
|
||
),
|
||
$this->attributes['enclosure_uri']
|
||
)
|
||
);
|
||
}
|
||
|
||
public function getEnclosureWebUrl()
|
||
{
|
||
return $this->getEnclosureUrl() . '?_from=-+Website+-';
|
||
}
|
||
|
||
public function getEnclosureOpengraphUrl()
|
||
{
|
||
return $this->getEnclosureUrl() . '?_from=-+Open+Graph+-';
|
||
}
|
||
|
||
public function getTranscriptUrl()
|
||
{
|
||
return $this->attributes['transcript_uri']
|
||
? base_url($this->getTranscriptMediaPath())
|
||
: null;
|
||
}
|
||
|
||
public function getChaptersUrl()
|
||
{
|
||
return $this->attributes['chapters_uri']
|
||
? base_url($this->getChaptersMediaPath())
|
||
: null;
|
||
}
|
||
|
||
/**
|
||
* Returns the episode's persons
|
||
*
|
||
* @return \App\Entities\EpisodePerson[]
|
||
*/
|
||
public function getEpisodePersons()
|
||
{
|
||
if (empty($this->id)) {
|
||
throw new \RuntimeException(
|
||
'Episode must be created before getting persons.'
|
||
);
|
||
}
|
||
|
||
if (empty($this->episode_persons)) {
|
||
$this->episode_persons = (new EpisodePersonModel())->getPersonsByEpisodeId(
|
||
$this->podcast_id,
|
||
$this->id
|
||
);
|
||
}
|
||
|
||
return $this->episode_persons;
|
||
}
|
||
|
||
/**
|
||
* Returns the episode’s soundbites
|
||
*
|
||
* @return \App\Entities\Episode[]
|
||
*/
|
||
public function getSoundbites()
|
||
{
|
||
if (empty($this->id)) {
|
||
throw new \RuntimeException(
|
||
'Episode must be created before getting soundbites.'
|
||
);
|
||
}
|
||
|
||
if (empty($this->soundbites)) {
|
||
$this->soundbites = (new SoundbiteModel())->getEpisodeSoundbites(
|
||
$this->getPodcast()->id,
|
||
$this->id
|
||
);
|
||
}
|
||
|
||
return $this->soundbites;
|
||
}
|
||
|
||
public function getLink()
|
||
{
|
||
return base_url(
|
||
route_to(
|
||
'episode',
|
||
$this->getPodcast()->name,
|
||
$this->attributes['slug']
|
||
)
|
||
);
|
||
}
|
||
|
||
public function getEmbeddablePlayer($theme = null)
|
||
{
|
||
return base_url(
|
||
$theme
|
||
? route_to(
|
||
'embeddable-player-theme',
|
||
$this->getPodcast()->name,
|
||
$this->attributes['slug'],
|
||
$theme
|
||
)
|
||
: route_to(
|
||
'embeddable-player',
|
||
$this->getPodcast()->name,
|
||
$this->attributes['slug']
|
||
)
|
||
);
|
||
}
|
||
|
||
public function setGuid(string $guid)
|
||
{
|
||
return $this->attributes['guid'] = empty($guid)
|
||
? $this->getLink()
|
||
: $guid;
|
||
}
|
||
|
||
public function getPodcast()
|
||
{
|
||
return (new PodcastModel())->getPodcastById(
|
||
$this->attributes['podcast_id']
|
||
);
|
||
}
|
||
|
||
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 getDescriptionHtml()
|
||
{
|
||
if (
|
||
$descriptionFooter = $this->getPodcast()
|
||
->episode_description_footer_html
|
||
) {
|
||
return $this->attributes['description_html'] .
|
||
'<footer>' .
|
||
$descriptionFooter .
|
||
'</footer>';
|
||
}
|
||
|
||
return $this->attributes['description_html'];
|
||
}
|
||
|
||
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;
|
||
}
|
||
|
||
public function getPublicationStatus()
|
||
{
|
||
if ($this->publication_status) {
|
||
return $this->publication_status;
|
||
}
|
||
|
||
if (!$this->published_at) {
|
||
return 'not_published';
|
||
}
|
||
|
||
helper('date');
|
||
if ($this->published_at->isBefore(Time::now())) {
|
||
return 'published';
|
||
}
|
||
|
||
return 'scheduled';
|
||
}
|
||
|
||
/**
|
||
* 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;
|
||
}
|
||
}
|