stringWrapper = StringUtils::getWrapper($this->encoding); } /** * Set feed encoding */ public function setEncoding(string $enc): Entry { $this->stringWrapper = StringUtils::getWrapper($enc); $this->encoding = $enc; return $this; } /** * Get feed encoding */ public function getEncoding(): string { return $this->encoding; } /** * Set entry transcript * * @param TranscriptArray $value * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function setPodcastIndexTranscript(array $value): Entry { $this->data['transcript'] = Validator::validateTranscript($value); return $this; } /** * Set entry chapters * * @param ChaptersArray $value * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function setPodcastIndexChapters(array $value): Entry { $this->data['chapters'] = Validator::validateChapters($value); return $this; } /** * Add multiple entry soundbites * * @param list $values * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function addPodcastIndexSoundbites(array $values): Entry { foreach ($values as $value) { $this->addPodcastIndexSoundbite($value); } return $this; } /** * Set entry soundbites. * If no argument is passed, the existing soundbite entries get removed. * * @param list $values * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function setPodcastIndexSoundbites(array $values = []): self { $this->data['soundbites'] = []; foreach ($values as $value) { $this->addPodcastIndexSoundbite($value); } return $this; } /** * Add a single entry soundbite * * @param SoundbiteArray $value * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function addPodcastIndexSoundbite(array $value): Entry { if (! isset($this->data['soundbites'])) { $this->data['soundbites'] = []; } /** @var list $this->data['soundbites'] */ $this->data['soundbites'][] = Validator::validateSoundbite($value); return $this; } /** * Adds a feed location tag. * * @param LocationArray $value * @return $this */ public function addPodcastIndexLocation(array $value): self { if (! isset($this->data['locations'])) { $this->data['locations'] = []; } /** @var list $this->data['locations'] */ $this->data['locations'][] = Validator::validateLocation($value); return $this; } /** * Set multiple location tags * * @param list $values * @return $this */ public function setPodcastIndexLocations(array $values = []): self { $this->data['locations'] = []; foreach ($values as $value) { $this->addPodcastIndexLocation($value); } return $this; } /** * Set entry license * * @param LicenseArray $value * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function setPodcastIndexLicense(array $value): self { $this->data['license'] = Validator::validateLicense($value); return $this; } /** * Add entry person * * @param PersonArray $value * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function addPodcastIndexPerson(array $value): self { if (! isset($this->data['people'])) { $this->data['people'] = []; } /** @var list $this->data['people'] */ $this->data['people'][] = Validator::validatePerson($value); return $this; } /** * Set a new array of people. * If no argument is passed, it will just remove all existing people. * * @param list $values * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function setPodcastIndexPeople(array $values = []): self { $this->data['people'] = []; foreach ($values as $value) { $this->addPodcastIndexPerson($value); } return $this; } /** * Set a new array of persons. (alias of setPodcastIndexPeople) * If no argument is passed, it will just remove all existing persons. * * @param list $values * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function setPodcastIndexPersons(array $values = []): self { return $this->setPodcastIndexPeople($values); } /** * Add entry txt * * @param TxtArray $value * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function addPodcastIndexTxt(array $value): self { if (! isset($this->data['txts'])) { $this->data['txts'] = []; } /** @var list $this->data['txts'] */ $this->data['txts'][] = Validator::validateTxt($value); return $this; } /** * Set a new array of txts. * If no argument is passed, it will just remove all existing txt entries. * * @param list $values * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function setPodcastIndexTxts(array $values = []): self { $this->data['txts'] = []; foreach ($values as $value) { $this->addPodcastIndexTxt($value); } return $this; } /** * Add a social interact for the entry. * * @param SocialInteractArray $value * @return $this */ public function addPodcastIndexSocialInteract(array $value): self { if (! isset($this->data['socialInteracts'])) { $this->data['socialInteracts'] = []; } /** @var list $this->data['socialInteracts'] */ $this->data['socialInteracts'][] = Validator::validateSocialInteract($value); return $this; } /** * Create a new set of social interacts for the entry. * If no argument is passed, existing social interacts will be removed. * * @param list $values * @return $this */ public function setPodcastIndexSocialInteracts(array $values = []): self { $this->data['socialInteracts'] = []; foreach ($values as $value) { $this->addPodcastIndexSocialInteract($value); } return $this; } /** * Reset all value elements. * All value entries will be removed, including their nested valueRecipients and valueTimeSplits. * * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function resetPodcastIndexValues(): self { $this->data['values'] = []; return $this; } /** * Adds a value element with one or more valueRecipients as children. * Optionally, a set of value time splits can also be attached. * * @param ValueArray $value * @param list $valueRecipients * @param list $valueTimeSplits * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function addPodcastIndexValue(array $value, array $valueRecipients, array $valueTimeSplits = []): self { if (count($valueRecipients) < 1) { throw new Writer\Exception\InvalidArgumentException( 'invalid parameter: the second argument of "value" must be an array containing ' . 'at least one entry with valueRecipient data' ); } $value = Validator::validateValue($value); foreach ($valueRecipients as $valueRecipient) { $value['valueRecipients'][] = Validator::validateValueRecipient($valueRecipient); } if ($valueTimeSplits && count($valueTimeSplits) > 0) { foreach ($valueTimeSplits as $split) { $value['valueTimeSplits'][] = Validator::validateValueTimeSplit($split); } } if (! isset($this->data['values'])) { $this->data['values'] = []; } /** @var list $this->data['values'] */ $this->data['values'][] = $value; return $this; } /** * Set entry season * * @param SeasonArray $value * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function setPodcastIndexSeason(array $value): self { $this->data['season'] = Validator::validateSeason($value); return $this; } /** * Set entry episode * * @param EpisodeArray $value * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function setPodcastIndexEpisode(array $value): self { $this->data['episode'] = Validator::validateEpisode($value); return $this; } /** * Set entry alternateEnclosure * * @param AlternateEnclosureArray $enclosure * @param list $sources * @param null|IntegrityArray $integrity * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function addPodcastIndexAlternateEnclosure(array $enclosure, array $sources, ?array $integrity = null): self { if (count($sources) < 1) { throw new Writer\Exception\InvalidArgumentException( 'invalid parameter: the second argument to "alternateEnclosure" must be an array containing ' . 'at least one source entry' ); } $enclosure = Validator::validateAlternateEnclosure($enclosure); foreach ($sources as $source) { $enclosure['sources'][] = Validator::validateSource($source); } if ($integrity !== null) { $enclosure['integrity'] = Validator::validateIntegrity($integrity); } if (! isset($this->data['alternateEnclosures'])) { $this->data['alternateEnclosures'] = []; } /** @var list $this->data['alternateEnclosures'] */ $this->data['alternateEnclosures'][] = $enclosure; return $this; } /** * Reset all alternate enclosure elements. * All alternate enclosure entries will be removed, including their nested sources and integrities. * * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function resetPodcastIndexAlternateEnclosures(): self { $this->data['alternateEnclosures'] = []; return $this; } /** * Adds an `image` element to the episode. * * @param DetailedImageArray $value * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function addPodcastIndexDetailedImage(array $value): self { if (! isset($this->data['detailedImages'])) { $this->data['detailedImages'] = []; } /** @var list $this->data['detailedImages'] */ $this->data['detailedImages'][] = Validator::validateDetailedImage($value); return $this; } /** * Sets multiple episode `image` elements. * If no argument is passed, all existing image entries are removed. * * @param list $values * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function setPodcastIndexDetailedImages(array $values = []): self { $this->data['detailedImages'] = []; foreach ($values as $value) { $this->addPodcastIndexDetailedImage($value); } return $this; } /** * Adds an `contentLink` element to the episode. * * @param ContentLinkArray $value * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function addPodcastIndexContentLink(array $value): self { if (! isset($this->data['contentLinks'])) { $this->data['contentLinks'] = []; } /** @var list $this->data['contentLinks'] */ $this->data['contentLinks'][] = Validator::validateContentLink($value); return $this; } /** * Sets multiple episode `contentLink` elements. * If no argument is passed, all existing entries are removed. * * @param list $values * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function setPodcastIndexContentLinks(array $values = []): self { $this->data['contentLinks'] = []; foreach ($values as $value) { $this->addPodcastIndexContentLink($value); } return $this; } /** * Adds a funding tag. * * @param FundingArray $value * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function addPodcastIndexFunding(array $value): self { if (! isset($this->data['fundings'])) { $this->data['fundings'] = []; } /** @var list $this->data['fundings'] */ $this->data['fundings'][] = Validator::validateFunding($value); return $this; } /** * Set multiple funding tags * * @param list $values * @return $this * @throws Writer\Exception\InvalidArgumentException */ public function setPodcastIndexFundings(array $values = []): self { $this->data['fundings'] = []; foreach ($values as $value) { $this->addPodcastIndexFunding($value); } return $this; } /** * Set a chat element. * * @psalm-param ChatArray $value * @return $this */ public function setPodcastIndexChat(array $value): self { $this->data['chat'] = Validator::validateChat($value); return $this; } /** * Overloading: proxy to internal setters * * @return mixed * @throws Writer\Exception\BadMethodCallException */ public function __call(string $method, array $params) { $point = lcfirst(substr($method, 15)); if ( ! method_exists($this, 'setPodcastIndex' . ucfirst($point)) && ! method_exists($this, 'addPodcastIndex' . ucfirst($point)) && ! method_exists($this, 'addPodcastIndex' . rtrim(ucfirst($point), 's')) ) { throw new Writer\Exception\BadMethodCallException( 'invalid method: ' . $method ); } if ( ! array_key_exists($point, $this->data) || empty($this->data[$point]) ) { return; } return $this->data[$point]; } /** * Get persons. * Specific get call for non-default naming. */ public function getPodcastIndexPersons(): array { /** @var list $persons */ $persons = $this->getPodcastIndexPeople(); return $persons; } }