Класс RssHelper
Класс RSS Helper для удобной выдачи структур RSS.
- Объект
-
Helper -
AppHelper -
RssHelper
Авторские права: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
Лицензия: MIT License
Ссылка: http://book.cakephp.org/2.0/ru/core-libraries/helpers/rss.html
Расположение: Cake/View/Helper/RssHelper.php
Подробное описание методов
channelsource public
channel( array $attrib array() , array $elements array() , string $content null )
Возвращает элемент RSS <channel />
Параметры
- массив
$attribнеобязательно array() -
<channel />атрибуты тега - массив
$elementsнеобязательно array() - Именованный массив элементов, которые преобразуются в теги
- строка
$contentнеобязательно null - Содержание (
<item />, относящиеся к этому каналу)
Возвращаемое значение
stringЭлемент RSS
<channel />Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/rss.html#RssHelper::channeldocumentsource public
document( array $attrib array() , string $content null )
Возвращает документ RSS, заключенный в <rss /> теги
Параметры
- массив
$attribнеобязательно array() -
<rss />атрибуты тега - строка
$contentнеобязательно null - Содержимое тега.
Возвращаемое значение
stringДокумент RSS
Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/rss.html#RssHelper::documentelemsource public
elem( string $name , array $attrib array() , string|array $content null , boolean $endTag true )
Генерирует XML элемент
Параметры
- строка
$name - Имя XML элемента
- массив
$attribнеобязательно array() - Атрибуты XML элемента
- строка|массив
$contentнеобязательно null - Содержимое XML элемента
- логическое значение
$endTagнеобязательно true - Нужно ли печатать закрывающий тег элемента
Возвращаемое значение
stringXML
Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/rss.html#RssHelper::elemitemsource public
item( array $att array() , array $elements array() )
Преобразует массив в элемент <item /> и его содержимое
Параметры
- массив
$attнеобязательно array() - Атрибуты элемента
<item /> - массив
$elementsнеобязательно array() - Список элементов, содержащихся в этом элементе
<item />
Возвращаемое значение
stringЭлемент RSS
<item />Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/rss.html#RssHelper::itemitemssource public
items( array $items , string|array $callback null )
Преобразует массив данных с помощью необязательного обратного вызова и отображает его в виде набора тегов <item />
Параметры
- массив
$items - Список элементов для отображения
- строка|массив
$callbackнеобязательно null - Имя функции-строки или массив, содержащий объект и имя метода строки
Возвращаемое значение
stringНабор элементов RSS
<item />Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/rss.html#RssHelper::itemstimesource public
time( integer|string|DateTime $time )
Преобразует время в любом формате в RSS время
Параметры
- целое число|строка|DateTime
$time - Маркер времени Unix или допустимая строка времени или объект DateTime.
Возвращаемое значение
stringМаркер времени в формате RSS
См. также
TimeHelper::toRSS()Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/rss.html#RssHelper::timeНаследуемые методы из Helper
__callsource public
__call( string $method , array $params )
Обеспечивает некритические ошибки при вызовах отсутствующих методов.
Параметры
- строка
$method - Метод для вызова
- массив
$params - Массив параметров для метода.
__constructsource public
__construct( View $View , array $settings array() )
Конструктор по умолчанию
Параметры
-
View$View - Представление, к которому прикреплен этот помощник.
- массив
$settingsнеобязательно array() - Настройки конфигурации для помощника.
Переопределяет
Object::__construct() __getsource public
__get( string $name )
Лениво загружает помощников. Также предоставляет доступ к устаревшим свойствам запроса.
Устарело
3.0.0 Доступ к свойствам запроса через этот метод устарел и будет удален в версии 3.0.Параметры
- строка
$name - Имя свойства, к которому осуществляется доступ.
Возвращаемое значение
mixedПомощник или свойство, найденное в $name
__setsource public
__set( string $name , mixed $value )
Обеспечивает обратную совместимость доступа для установки значений в объект запроса.
Устарело
3.0.0 Этот метод будет удален в версии 3.0Параметры
- строка
$name - Имя свойства, к которому осуществляется доступ.
- смешанное значение
$value - Значение для установки.
_confirmsource protected
_confirm( string $message , string $okCode , string $cancelCode '' , array $options array() )
Возвращает строку, используемую в качестве обработчика onclick для диалоговых окон подтверждения.
Параметры
- строка
$message - Сообщение, которое будет отображено
- строка
$okCode - Код, который будет выполнен после того, как пользователь выбрал 'ОК'
- строка
$cancelCodeнеобязательно '' - Код, который будет выполнен после того, как пользователь выбрал 'Отмена'
- массив
$optionsнеобязательно array() - Массив опций
Возвращаемое значение
stringJS код onclick
_encodeUrlsource protected
_encodeUrl( string $url )
Кодирует URL для использования в атрибутах HTML.
Параметры
- строка
$url - URL для кодирования.
Возвращает
stringURL, закодированный для контекстов URL и HTML.
_formatAttributesource protected
_formatAttribute( string $key , string $value , boolean $escape true )
Форматирует отдельный атрибут и возвращает строковое значение составленного атрибута. Работает с миниатюрными атрибутами, которые имеют то же значение, что и их имя, например, 'disabled' и 'checked'.
Устарело
3.0.0 Этот метод будет перемещен в HtmlHelper в версии 3.0Параметры
- строка
$key - Имя атрибута для создания.
- строка
$value - Значение атрибута для создания.
- логическое значение
$escapeнеобязательно true - Определяет, должно ли значение быть экранировано.
Возвращает
stringСоставленный атрибут.
_initInputFieldsource protected
_initInputField( string $field , array $options array() )
Устанавливает значения по умолчанию для тега input. Установит атрибуты name, value и id для массива атрибутов html.
Параметры
- строка
$field - Имя поля для инициализации.
- массив
$optionsнеобязательно array() - Массив параметров для использования при инициализации поля ввода.
Возвращает
arrayМассив параметров для поля формы.
_namesource protected
_name( array|string $options array() , string $field null , string $key 'name' )
Получает имя поля ввода для текущего тега. Создаёт атрибуты имени input с использованием формата CakePHP data[Model][field].
Параметры
- массив|строка
$optionsнеобязательно array() - Если массив, должен быть массивом атрибутов, к которым необходимо добавить $key. Если строка или null, будет использоваться как сущность View.
- строка
$fieldнеобязательно null - Имя поля.
- строка
$keyнеобязательно 'name' - Имя атрибута для установки, по умолчанию 'name'.
Возвращает
mixedЕсли для $options был передан массив, будет возвращён массив с установленным $key. Если была передана строка, будет возвращена строка.
_parseAttributessource protected
_parseAttributes( array $options , array $exclude null , string $insertBefore ' ' , string $insertAfter null )
Возвращает строку, разделённую пробелами, с элементами массива $options. Если ключ в массиве $options совпадает с одним из перечисленных в Helper::$_minimizedAttributes,
И его значение равно:
- '1' (строка)
- 1 (целое число)
- true (булево)
- 'true' (строка)
то значение будет изменено, чтобы быть идентичным имени ключа. Если значение не равно одному из этих трёх, параметр не выводится.
'escape' — специальный параметр, который управляет преобразованием атрибутов в их закодированные html-сущности. Установите в false, чтобы отключить html-кодирование.
Если значение для любого ключа параметра установлено в null или false, этот параметр будет исключен из вывода.
Устарело
3.0.0 Этот метод будет перемещен в HtmlHelper в версии 3.0Параметры
- массив
$options - Массив параметров.
- массив
$excludeнеобязательно null - Массив параметров, которые нужно исключить; эти параметры не будут частью возвращаемого значения.
- строка
$insertBeforeнеобязательно ' ' - Строка, которая должна быть вставлена перед параметрами.
- строка
$insertAfterнеобязательно null - Строка, которая должна быть вставлена после параметров.
Возвращает
stringСоставленные атрибуты.
_selectedArraysource protected
_selectedArray( string|array $data , string $key 'id' )
Преобразует набор записей из ассоциации hasAndBelongsToMany в список выбранных параметров для элемента множественного выбора.
Параметры
- строка|массив
$data - Массив данных или имя модели.
- строка
$keyнеобязательно 'id' - Имя поля.
Возвращает
arrayмассив
addClasssource public
addClass( array $options array() , string $class null , string $key 'class' )
Добавляет указанный класс к параметрам элемента.
Параметры
- массив
$optionsнеобязательно array() - Массив параметров/атрибутов, к которому добавляется класс.
- строка
$classнеобязательно null - Имя добавляемого класса.
- строка
$keyнеобязательно 'class' - Ключ для использования в классе.
Возвращает
arrayМассив параметров с установленным $key.
afterLayoutsource public
afterLayout( string $layoutFile )
Обработчик после макета. afterLayout вызывается после отрисовки макета.
Переопределяется в подклассах.
Параметры
- строка
$layoutFile - Файл макета, который был отрисован.
afterRendersource public
afterRender( string $viewFile )
Обработчик после отрисовки. afterRender вызывается после отрисовки файла представления, но перед отрисовкой макета.
Переопределяется в подклассах.
Параметры
- строка
$viewFile - Файл представления, который был отрисован.
afterRenderFilesource public
afterRenderFile( string $viewFile , string $content )
Обработчик после отрисовки файла. Вызывается после отрисовки любого фрагмента представления.
Переопределяется в подклассах.
Параметры
- строка
$viewFile - Только что отрисованный файл.
- строка
$content - Содержимое, которое было отрисовано.
assetTimestampsource public
assetTimestamp( string $path )
Добавляет отметку времени к ресурсу файла на основе значения Asset.timestamp в Configure. Если Asset.timestamp имеет значение true и debug > 0, или Asset.timestamp === 'force', будет добавлена отметка времени.
Параметры
- строка
$path - Путь к файлу для добавления отметки времени, путь должен находиться внутри WWW_ROOT.
Возвращает
stringПуть с добавленной отметкой времени или без неё.
assetUrlsource public
assetUrl( string|array $path , array $options array() )
Генерирует URL для данного файла ресурса. В зависимости от переданных параметров предоставляет полный URL с доменным именем. Также вызывает Helper::assetTimestamp() для добавления отметки времени к локальным файлам.
Параметры
- строка|массив
$path - Строка пути или массив URL.
- массив
$optionsнеобязательно array() - Массив параметров. Возможные ключи:
fullBaseВозвращает полный URL с доменным именемpathPrefixПрефикс пути для относительных URLextРасширение ресурса для добавленияpluginЛожное значение предотвратит обработку пути как плагина.
Возвращает
stringСгенерированный URL
beforeLayoutsource public
beforeLayout( string $layoutFile )
Обработчик перед макетом. beforeLayout вызывается перед отрисовкой макета.
Переопределяется в подклассах.
Параметры
- строка
$layoutFile - Макет, который будет отрисован.
beforeRendersource public
beforeRender( string $viewFile )
Обработчик перед отрисовкой. beforeRender вызывается перед отрисовкой файла представления.
Переопределяется в подклассах.
Параметры
- строка
$viewFile - Файл представления, который будет отрисован
beforeRenderFilesource public
beforeRenderFile( string $viewFile )
Обработчик перед отрисовкой файла. Вызывается перед отрисовкой любого фрагмента представления.
Переопределяется в подклассах.
Параметры
- строка
$viewFile - Файл, который собирается отрисовать.
cleansource public
clean( string|array $output )
Используется для удаления вредных тегов из содержимого. Удаляет ряд известных атак XSS из содержимого. Однако, не гарантирует удаление всех возможных уязвимостей. Лучшим способом предотвращения всех возможных атак является экранирование содержимого.
Устаревший
3.0.0 Этот метод будет удален в версии 3.0Параметры
- строка|массив
$output - Массив строк для очистки или одна строка для очистки.
Возвращает
string|array|nullОчищенное содержимое для вывода
domIdsource public
domId( array|string $options null , string $id 'id' )
Генерирует идентификатор DOM для выбранного элемента, если он не задан. Использует текущие настройки View::entity() для генерации идентификатора с использованием верблюжьего регистра.
Параметры
- массив|строка
$optionsнеобязательно null - Массив HTML-атрибутов, в который нужно добавить $id, или строка с путем к сущности представления для получения domId.
- строка
$idнеобязательно 'id' - Имя атрибута 'id'.
Возвращает
mixedЕсли $options был массивом, будет возвращён массив с заданным $id. Если была передана строка, будет возвращена строка.
entitysource public
entity( )
Возвращает ссылку на сущность текущего контекста в виде массива элементов идентификатора.
Возвращает
arrayМассив, содержащий элементы идентификации сущности
fieldsource public
field( )
Получает текущее поле модели контекста отрисовки. Удаляет суффиксы полей, такие как год, месяц, день, час, минута, полуденный, когда текущая сущность содержит более 2 элементов.
Возвращает
stringстрока
modelsource public
model( )
Получает текущую используемую модель контекста отрисовки.
Возвращает
stringстрока
outputsource public
output( string $str )
Возвращает строку, сгенерированную методом помощника
Этот метод может быть переопределён в подклассах для выполнения обобщённой обработки вывода после отрисовки.
Устаревший
3.0.0 Этот метод будет удалён в будущих версиях.Параметры
- строка
$str - Строка, которая должна быть выведена.
Возвращает
stringстрока
setEntitysource public
setEntity( string $entity , boolean $setScope false )
Устанавливает свойства модели и поля помощника в соответствии с парой имя-значение, разделённой точкой, в $entity.
Параметры
- строка
$entity - Имя поля, например, "ИмяМодели.ИмяПоля" или "ИмяМодели.ИД.ИмяПоля"
- логическое значение
$setScopeнеобязательно false - Устанавливает область представления в указанную модель в $tagValue
urlsource public
url( string|array $url null , boolean $full false )
Находит URL для указанного действия.
Возвращает URL, указывающий на предоставленные параметры.
Параметры
- строка|массив
$urlнеобязательно null - Относительный URL-адрес, например
/products/view/23, или массив параметров URL. Использование массива для URL позволит вам воспользоваться функциями обратного маршрутизирования CakePHP. - логическое значение
$fullнеобязательно false - Если true, к результату будет добавлен полный базовый URL
Возвращает
stringПолный переведённый URL с базовым путём.
Ссылка
http://book.cakephp.org/2.0/ru/views/helpers.htmlvaluesource public
value( array|string $options array() , string $field null , string $key 'value' )
Получает данные для текущего тега
Параметры
- массив|строка
$optionsнеобязательно array() - Если массив, должен содержать массив атрибутов, к которым нужно добавить $key. Если строка или null, будет использоваться как сущность представления.
- строка
$fieldнеобязательно null - Имя поля.
- строка
$keyнеобязательно 'value' - Имя атрибута, который нужно установить, по умолчанию 'value'
Возвращает
mixedЕсли для $options был передан массив, будет возвращён массив с заданным $key. Если была передана строка, будет возвращена строка.
webrootsource public
webroot( string $file )
Проверяет существование файла при использовании темы, если файл не найден, возвращается путь по умолчанию
Параметры
- строка
$file - Файл, для которого нужно создать путь webroot.
Возвращает
stringПуть к файлу, доступный через веб.
Методы, унаследованные от Объекта
_mergeVarssource protected
_mergeVars( array $properties , string $class , boolean $normalize true )
Объединяет свойство $property этого объекта со свойством в определении $class. Значение свойства этого класса будет объединено поверх значения $class.
Это обеспечивает часть магической функциональности CakePHP. Если вы хотите отключить её, переопределите этот метод как пустую функцию.
Параметры
- массив
$properties - Имя свойств для объединения.
- строка
$class - Класс для объединения свойства с.
- логическое значение
$normalizeнеобязательно true - Установите значение в true, чтобы выполнить нормализацию свойств через Hash::normalize() перед объединением.
_setsource protected
_set( array $properties array() )
Позволяет установить несколько свойств объекта в одной строке кода. Будет установлены только свойства, которые являются частью объявления класса.
Параметры
- массив
$propertiesнеобязательно array() - Ассоциативный массив, содержащий свойства и соответствующие значения.
_stopsource protected
_stop( integer|string $status 0 )
Останавливает выполнение текущего скрипта. Обёртка для exit(), что упрощает тестирование.
Параметры
- целое число|строка
$statusнеобязательно 0 - см. http://php.net/exit для значений
dispatchMethodsource public
dispatchMethod( string $method , array $params array() )
Вызывает метод этого объекта с заданными параметрами. Представляет собой ОО-обёртку для call_user_func_array.
Параметры
- строка
$method - Имя вызываемого метода
- массив
$paramsнеобязательно array() - Список параметров, используемых при вызове $method
Возвращает
mixedВозвращает результат вызова метода
logsource public
log( string $msg , integer $type LOG_ERR , null|string|array $scope null )
Удобный метод для записи сообщения в CakeLog. Для получения дополнительной информации о записи в журналы см. CakeLog::write().
Параметры
- строка
$msg - Сообщение журнала
- целое число
$typeнеобязательно LOG_ERR - Константа типа ошибки. Определена в app/Config/core.php.
- null|строка|массив
$scopeнеобязательно null - Область(и), в которой создается сообщение журнала. Дополнительную информацию о областях ведения журнала см. в CakeLog::config().
Возвращаемые значения
booleanУспешность записи в журнал
requestActionsource public
requestAction( string|array $url , array $extra array() )
Вызывает метод контроллера из любого места. Может использоваться для связи контроллеров или подключения плагинов к основному приложению. requestAction может возвращать отрисованный вид или значение возвращаемого значения действий контроллера.
Под капотом этот метод использует Router::reverse() для преобразования параметра $url в строку URL. Вы должны использовать форматы URL, совместимые с Router::reverse().
Передача данных POST и GET
Данные POST и GET могут быть смоделированы в requestAction. Используйте $extra['url'] для данных GET. Параметр $extra['data'] позволяет моделировать данные POST.
Параметры
- строка|массив
$url - Строка или массив, представляющий URL. В отличие от других массивов URL в CakePHP, этот URL не будет автоматически обрабатывать переданные и именованные аргументы в параметре $url.
- массив
$extraнеобязательно array() - Если массив содержит ключ "return", он устанавливает AutoRender в true. Также может использоваться для отправки данных GET/POST и именованных/переданных аргументов.
Возвращаемые значения
mixedБулево значение true или false об успехе/неудачи, или содержимое отрисованного действия, если в $extra установлен ключ 'return'.
toStringsource public
toString( )
Преобразование объекта в строку. Каждый класс может переопределять этот метод по мере необходимости.
Возвращаемые значения
stringНазвание этого класса
Краткое описание свойств
Наследованные свойства от Helper
$_associationsource
protected string
Имя текущей модели, сущности которой находятся в области видимости.
См.
Helper::setEntity()$_entityPathsource
protected string
Список элементов, разделённый точками, для текущей сущности поля.
См.
Helper::setEntity()$_fieldSuffixessource
protected array
Список строк, которые должны обрабатываться как суффиксы или подвводные данные для родительского поля. Используется в основном для полей даты/времени.
array( 'year', 'month', 'day', 'hour', 'min', 'second', 'meridian' )
$_helperMapsource
protected array
Таблица поиска помощников, используемая для отложенной загрузки объектов помощников.
array() $_minimizedAttributessource
protected array
Миниатюрные атрибуты
array( 'allowfullscreen', 'async', 'autofocus', 'autoplay', 'checked', 'compact', 'controls', 'declare', 'default', 'defaultchecked', 'defaultmuted', 'defaultselected', 'defer', 'disabled', 'enabled', 'formnovalidate', 'hidden', 'indeterminate', 'inert', 'ismap', 'itemscope', 'loop', 'multiple', 'muted', 'nohref', 'noresize', 'noshade', 'novalidate', 'nowrap', 'open', 'pauseonexit', 'readonly', 'required', 'reversed', 'scoped', 'seamless', 'selected', 'sortable', 'spellcheck', 'truespeed', 'typemustmatch', 'visible' )
$_modelScopesource
protected string
Имя текущей модели, сущности которой находятся в области видимости.
См.
Helper::setEntity()$fieldsetsource
public array
Массив полей ('имя_поля' => массив('тип' => 'строка', 'длина' => 100), первичный ключ и проверяет массив ('имя_поля'))
array() Краткое описание магических свойств
$Timesource
public TimeHelper
© 2005–2016 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
http://api.cakephp.org/2.7/class-RssHelper.html