Встроенные функции

Blox CMS предоставляет ряд встроенных функций.

isEmpty($var) — проверка на пустое значение

  • Возвращает true для параметров, имеющих значение null, false или для пустых строк. Для остальных случаев функция возвращает false.

В отличие от php-функции empty(), для функции isEmpty() число 0 является "нормальным" данным (математический подход).

Смотрите также метод Str::isInteger().


qq($var) — отладочная функция

В распоряжении разработчика имеются функция qq() для отладки скриптов. Функция qq() работает, как стандартная PHP-функция print_r(), за исключением того, что она выводит результаты не на страницу, а записывает их в лог-файл ./---qq.log в папке сайта.

Чтобы отладочные переменные записывались в лог-файл, необходимо включить журнал отладки в разделе "Настройки сайта".

В качестве параметра функции qq() могут быть переменные любого типа, в том числе объекты. Пример использования:

<?php
...
qq($_SESSION);// Отобразить все переменные сессии
...
?>

В каждой записи лог-файла фиксируются:

  • момент времени, когда вызывалась функция qq() ;
  • время, прошедшее с момента предыдущего вызова функции qq()
    (время выполнения самой функции сюда не входит);
  • значение параметра функции qq() .

Таким образом, эту отладочную функцию можно использовать и для получения времени выполнения того или иного скрипта. Для этого нужно в начале и в конце скрипта поставить, например, такие коды: qq('start'); и qq('finish');.

Примечания

  • При отладке, в конфигурации сайта index.php должно быть отключено кэширование.
  • После отладки, log-файл желательно удалить.

pp($htm, $left=0, $top=0, $zIndex=null) — абсолютное позиционирование

Абсолютное позиционирование html-кода относительно родительского элемента. Родительский элемент должен иметь свойство position:relative.

  • Возвращает html-код, позиционированный абсолютно
  • $htm — любой html-код
  • $left — отступ слева (px)
  • $top — отступ сверху (px)
  • $zIndex — свойство z-index:

Обычно используется для позиционирования кнопок редактирования. Пример: echo pp($dat['edit'], -22);