Битрикс. Заголовок страницы
02.06.2018
Теги: CMS • Web-разработка • Битрикс • ОтложенныеФункции
С заголовком страницы в Битрикс все очень запутано. Через панель управления можно установить «Заголовок страницы» и «Заголовок окна браузера». «Заголовок страницы» — это содержимое тега <h1>
страницы, а «Заголовок окна браузера» — содержимое тега <title>
. Однако, выводить на страницу и то и другое можно с помощью метода CMain::ShowTitle()
, только вызывать его надо по-разному.
Если совсем коротко:
<title><?php $APPLICATION->ShowTitle(); /* Выводим «Заголовок окна браузера» */ ?></title>
<h1><?php $APPLICATION->ShowTitle(false); /* Выводим «Заголовок страницы» */ ?></h1>
Чтобы установить заголовки страницы программно, существуют специализированные функции:
- CMain::SetTitle() — Устанавливает заголовок страницы
- CMain::GetTitle() — Возвращает заголовок страницы
- CMain::ShowTitle() — Отображает заголовок страницы
И более общие функции работы со свойствами страницы и раздела:
- CMain::ShowProperty() — Отображает свойство страницы, учитывая свойства раздела
- CMain::GetProperty() — Возвращает свойство страницы, учитывая свойства раздела
- CMain::GetPageProperty() — Возвращает свойство страницы
- CMain::GetDirProperty() — Возвращает свойство раздела
- CMain::GetPagePropertyList() — Возвращает массив всех свойств страницы
- CMain::GetDirPropertyList() — Возвращает массив всех свойств раздела
- CMain::SetPageProperty() — Устанавливает свойство страницы
- CMain::SetDirProperty() — Устанавливает свойство раздела
- CMain::ShowMeta() — Отображает свойство раздела/страницы обрамленное тегом
meta
- CMain::GetMeta() — Возвращает свойство раздела/страницы обрамленное тегом
meta
Метод SetTitle('…')
устанавливает «Заголовок страницы», а метод SetPageProperty('title', '…')
устанавливает «Заголовок окна браузера». При вызове ShowTitle()
без аргументов будет показан «Заголовок окна браузера», потому что фактически происходит вызов ShowTitle('title')
. Если нужно, чтобы ShowTitle()
выводил на страницу «Заголовок страницы», надо вызвать его с аргументом false
.
<?php require($_SERVER['DOCUMENT_ROOT'].'/bitrix/header.php'); ?> <?php $APPLICATION->SetTitle('Заголовок страницы'); $APPLICATION->SetPageProperty('title', 'Заголовок окна браузера'); ?> <?php $APPLICATION->ShowTitle(); ?> <br/> <?php $APPLICATION->ShowTitle(false); ?> <?php require($_SERVER['DOCUMENT_ROOT'].'/bitrix/footer.php'); ?>
Заголовок окна браузера
<br/>
Заголовок страницы
Вообще, с помощью ShowTitle()
можно вывести любое свойство страницы в качестве заголовка окна браузера. Для этого надо передать первым аргументом имя свойства, предварительно установленное с помощью SetPageProperty()
:
<?php $APPLICATION->SetPageProperty('heading', 'Мой заголовок'); ?> <title><?php $APPLICATION->ShowTitle('heading'); ?></title>
Метод GetTitle()
по умолчанию вызывается с аргументом false
и возвращает заголовок страницы, установленный с помощью метода SetTitle()
. Можно передать методу имя свойства страницы (предварительно установленное с помощью SetPageProperty()
), значение которого будет выведено в качестве заголовка, например GetTitle('title')
.
Столкнулся с тем, что компоненты, расположенные на странице, тоже могут устанавливать свойства страницы. Если вдруг вылезли непонятные заголовки или мета-теги, надо смотреть все компоненты и снимать галочки:
- Устанавливать заголовок страницы
- Устанавливать заголовок окна браузера
- Устанавливать ключевые слова страницы
- Устанавливать описание страницы
Поиск: CMS • ShowTitle • Web-разработка • Битрикс • Отложенные функции • Заголовок