Page properties and meta tags

In the Bitrix Site Manager, both section and page properties are supported.

The section properties are stored in the file .section.php of the correspondent folder (site section).

The page properties are specified in the page body, or between the service and visual sections of the prologue.

The following functions are used to handle properties:

CMain::SetPageProperty
CMain::SetDirProperty
CMain::ShowProperty
CMain::GetProperty
CMain::GetPageProperty
CMain::GetPagePropertyList
CMain::GetDirProperty
CMain::GetDirPropertyList

The page and section properties are used in meta tags. The system exposes the following functions to handle meta tags:

CMain::ShowMeta
CMain::GetMeta

Methods for setting properties

CMain::SetPageProperty sets the page property.

<?
$APPLICATION->SetPageProperty("keywords", "web, development, programming");
?>

CMain::SetDirProperty sets the section property.

<?
$APPLICATION->SetDirProperty("keywords", "design, web, site");
?>

Showing properties

CMain::ShowProperty displays the page or section properties using the delay function technology.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title><?$APPLICATION->ShowProperty("page_title")?></title>
</head>
<body link="#525252" alink="#F1555A" vlink="#939393" text="#000000">
...

Obtaining property value

CMain::GetProperty returns the page or section property.

<?
$keywords = $APPLICATION->GetProperty("keywords");
if (strlen($keywords)>0) echo $keywords;
?>

CMain::GetPageProperty returns the page property.

<?
$keywords = $APPLICATION->GetPageProperty("keywords");
if (strlen($keywords)>0) echo $keywords;
?>

CMain::GetPagePropertyList returns an array of all page properties.

<?
$arProp = $APPLICATION->GetPagePropertyList();
foreach($arProp as $key=>$value)
    echo '<meta name="'.$key.'" content="'.htmlspecialchars($value).'">';
?>

CMain::GetDirProperty returns the section property.

<?
$keywords = $APPLICATION->GetDirProperty("keywords");
if (strlen($keywords)>0) echo $keywords;
?>

CMain::GetDirPropertyList returns an array of the section properties, collected recursively up to the site root.

<?
$arProp = $APPLICATION->GetDirPropertyList();
foreach($arProp as $key=>$value)
    echo '<meta name="'.$key.'" content="'.htmlspecialchars($value).'">';
?>

Handling meta tags

CMain::ShowMeta emits the page or section property as the META tag using delay function technology.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<?$APPLICATION->ShowMeta("keywords_prop", "keywords")?>
<?$APPLICATION->ShowMeta("description_prop", "description")?>
</head>
<body link="#525252" alink="#F1555A" vlink="#939393" text="#000000">
...

CMain::GetMeta returns the page or section property decorated in the <meta> tag.

<?
$meta_keywords = $APPLICATION->GetMeta("keywords_prop", "keywords");
if (strlen($meta_keywords)>0) echo $meta_keywords;
?>