Различные функции

21.09.2013

Здесь я привел различные функции API Bitrix, которые я часто использую, а искать их каждый раз в официальной документации неудобно.

Форматирование даты/времени из формата битрикса


FormatDate(
    'Нужный формат (d.m.Y)',
     MakeTimeStamp($arResult["ACTIVE_FROM"], CSite::GetDateFormat())
);

У функции FormatDate расширенный набор форматов, в отличии от стандартной php функции date

Форматирование даты/времени в формат битрикса


ConvertTimeStamp($item->created_time,'FULL');
//FULL|SHORT - 1 - дата, время; 2 - дата, по умолчанию SHORT

Подключаем произвольный файл (аналог включаемой области)


$APPLICATION->IncludeFile(
	'/include/action_on_main.php',
	array(),
	array('MODE'=>'html')
);

Отложенные функции

Вывод отложенной функции


global $APPLICATION;
$APPLICATION->ShowViewContent('name_content');

Задание отложенной функции из шаблона компонента


$this->SetViewTarget('name_content');
отложенный текст
$this->EndViewTarget();

Задание отложенной функции из любого другого места


$APPLICATION->AddViewContent('name_content','отложенный текст');

Отложенное добавление строки в HEAD


global $APPLICATION;
$APPLICATION->AddHeadString(
    '<link href="/css/style.css";  type="text/css" rel="stylesheet" />',
    $bUnique=false);
//если $bUnique=true; добавляемая строка будет проверена на уникальность,
// по умолчанию $bUnique=false;

Генерация пароля


$new_password = randString($length,$chars);
// где 
//$length - длина строки
//$chars - состав символов, по умолчанию это 
$chars = 'abcdefghijklnmopqrstuvwxyzABCDEFGHIJKLNMOPQRSTUVWXYZ0123456789';
//$chars - может быть массивом: 
$chars = array(
  'abcdefghijklnmopqrstuvwxyz',
  'ABCDEFGHIJKLNMOPQRSTUVWXYZ',
  '0123456789',
  '!@#\$%^&*()',
); //тогда в результат попадут символы из каждой строки

Проверка корректности email


if (!check_email($email)){
    echo 'Email не корректен';
}

LocalRedirect


LocalRedirect(
 string url, //относительный либо абсолютный адрес
 bool skip_security_check=false, //true - пропустить проверку
                                 //модуля безопасности на фишинг
 string status="302 Found" //статус
);

Транслитерация

Не нашел описание этой функции в документации битрикса, взял отсюда. Для автоматического создания символьного кода из названия битрикс использует именно эту функцию:


$trans = Cutil::translit($name,"ru",$arParams=array());

В массиве $arParams могут быть следующие значения:

max_len	Максимальная длина результата транслитерации (по умолчанию 100)
change_case	Приведение результата к регистру, L - к нижнему, U - верхнему (по умолчанию L)
replace_space	Замена для символа пробела (по умолчанию _)
replace_other	Замена для прочих символов (по умолчанию _)
delete_repeat_replace	Удалять лишние символы замены (по умолчанию true)