get_language_attributes() — это функция в WordPress, которая возвращает строку атрибутов языка для использования в HTML-теге <html>. Эти атрибуты включают язык контента (lang) и направление текста (dir), что важно для обеспечения правильного отображения контента в разных языках и культурах.
Синтаксис
get_language_attributes( $doctype )- $doctype (string, необязательный): Тип документа, для которого должны быть возвращены атрибуты. Возможные значения:
htmlилиxhtml. По умолчанию —html.
Зачем использовать get_language_attributes()?
- Локализация: Обеспечивает правильное указание языка контента, что важно для поисковых систем и пользователей.
- Доступность: Помогает браузерам и другим агентам правильно интерпретировать и отображать контент.
- Универсальность: Автоматически определяет язык и направление текста на основе настроек сайта.
Примеры использования
Пример 1: Использование в теме WordPress
Часто get_language_attributes() используется в файле header.php для установки атрибутов языка в теге <html>.
<!DOCTYPE html>
<html <?php echo get_language_attributes(); ?>>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<title><?php wp_title(); ?></title>
<?php wp_head(); ?>
</head>
<body <?php body_class(); ?>>Пример 2: Использование с типом документа xhtml
Если ваш сайт использует XHTML, вы можете передать соответствующий параметр в функцию.
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html <?php echo get_language_attributes( 'xhtml' ); ?>>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<title><?php wp_title(); ?></title>
<?php wp_head(); ?>
</head>
<body <?php body_class(); ?>>В этом примере атрибуты языка будут соответствовать стандарту XHTML.
Использование функции language_attributes()
Однако так делают редко. Чаще используется обёртка — функция language_attributes(), которая сразу выводит строку атрибутов.
<!DOCTYPE html>
<html <?php language_attributes(); ?>>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<title><?php wp_title(); ?></title>
<?php wp_head(); ?>
</head>
<body <?php body_class(); ?>>Фильтр language_attributes
Внутри функции также существует хук:
apply_filters( 'language_attributes', $output, $doctype );Здесь $output — это строка с атрибутами, которую мы можем изменить, и параметр $doctype, про который мы говорили ранее.
К примеру, если значение $doctype равно xhtml, мы можем возвращать false.
add_filter( 'language_attributes', function( $output, $doctype ) {
if ( $doctype == 'xhtml' ) {
return false;
}
return $output;
}, 10, 2 );Заключение
Функция get_language_attributes() является важным инструментом для разработчиков WordPress, обеспечивая правильное указание языка и направления текста в HTML-документе. Использование этой функции способствует улучшению доступности и SEO вашего сайта.
Правильное и регулярное использование get_language_attributes() и language_attributes() в темах и плагинах WordPress помогает создавать более доступные и локализованные веб-сайты, улучшая их восприятие пользователями и поисковыми системами.