getDefaultAttachOrder() ?? Placeholder\Container\AbstractContainer::APPEND; } $title = (string) $title; if ($title !== '') { if ($setType === Placeholder\Container\AbstractContainer::SET) { $this->set($title); } elseif ($setType === Placeholder\Container\AbstractContainer::PREPEND) { $this->prepend($title); } else { $this->append($title); } } return $this; } /** * Render title (wrapped by title tag) * * @param string|null $indent * @return string */ public function toString($indent = null) { $indent = null !== $indent ? $this->getWhitespace($indent) : $this->getIndent(); $output = $this->renderTitle(); return $indent . ''; } /** * Render title string * * @return string */ public function renderTitle() { $items = []; $itemCallback = $this->getTitleItemCallback(); foreach ($this as $item) { $items[] = $itemCallback($item); } $separator = $this->getSeparator(); $output = ''; $prefix = $this->getPrefix(); if ($prefix) { $output .= $prefix; } $output .= implode($separator, $items); $postfix = $this->getPostfix(); if ($postfix) { $output .= $postfix; } $output = $this->autoEscape ? $this->escape($output) : $output; return $output; } /** * Set a default order to add titles * * @param string $setType * @throws Exception\DomainException * @return HeadTitle */ public function setDefaultAttachOrder($setType) { if ( ! in_array($setType, [ Placeholder\Container\AbstractContainer::APPEND, Placeholder\Container\AbstractContainer::SET, Placeholder\Container\AbstractContainer::PREPEND, ], true) ) { throw new Exception\DomainException( "You must use a valid attach order: 'PREPEND', 'APPEND' or 'SET'" ); } $this->defaultAttachOrder = $setType; return $this; } /** * Get the default attach order, if any. * * @return string|null */ public function getDefaultAttachOrder() { return $this->defaultAttachOrder; } /** * Create and return a callback for normalizing title items. * * If translation is not enabled, or no translator is present, returns a * callable that simply returns the provided item; otherwise, returns a * callable that returns a translation of the provided item. * * @return callable */ private function getTitleItemCallback() { if (! $this->isTranslatorEnabled() || ! $this->hasTranslator()) { return static fn($item) => $item; } $translator = $this->getTranslator(); $textDomain = $this->getTranslatorTextDomain(); return static fn($item) => $translator->translate($item, $textDomain); } }