Class RssHelper
RSS Helper class for easy output RSS structures.
- Cake\View\Helper implements Cake\Event\EventListenerInterface uses Cake\Core\InstanceConfigTrait
-
Cake\View\Helper\RssHelper
Link: https://book.cakephp.org/3.0/en/views/helpers/rss.html
Deprecated: 3.5.0 RssHelper is deprecated and will be removed in 4.0.0
Location: View/Helper/RssHelper.php
Properties summary
-
$actionpublicCurrent action.string -
$basepublicBase URLstring -
$datapublicPOSTed model dataarray -
$fieldpublicName of the current fieldstring -
$helperspublicHelpers used by RSS Helperarray -
$herepublicURL to current action.string -
$modelpublicName of the current modelstring -
$paramspublicParameter array.array -
$versionpublicDefault spec version of generated RSSstring
Magic properties summary
Inherited Properties
-
_View,_defaultConfig,_helperMap,fieldset,plugin,request,tags,theme_config,_configInitialized
Method Summary
- channel() publicReturns an RSS
<channel />element - document() publicReturns an RSS document wrapped in
<rss />tags - elem() publicGenerates an XML element
- implementedEvents() publicEvent listeners.
- item() publicConverts an array into an
<item />element and its contents - items() public
Transforms an array of data using an optional callback, and maps it to a set of
<item />tags - time() publicConverts a time in any format to an RSS time
Method Detail
channel()source public
channel( array $attrib [] , array $elements [] , string|null $content null )
Returns an RSS <channel /> element
Parameters
- array
$attriboptional [] -
<channel />tag attributes - array
$elementsoptional [] - Named array elements which are converted to tags
- string|null
$contentoptional null - Content (
<item />'s belonging to this channel
Returns
stringAn RSS
<channel />document()source public
document( array $attrib [] , string|null $content null )
Returns an RSS document wrapped in <rss /> tags
Parameters
- array
$attriboptional [] -
<rss />tag attributes - string|null
$contentoptional null - Tag content.
Returns
stringAn RSS document
elem()source public
elem( string $name , array $attrib [] , string|array|null $content null , boolean $endTag true )
Generates an XML element
Parameters
- string
$name - The name of the XML element
- array
$attriboptional [] - The attributes of the XML element
- string|array|null
$contentoptional null - XML element content
- boolean
$endTagoptional true - Whether the end tag of the element should be printed
Returns
stringXML
implementedEvents()source public
implementedEvents( )
Event listeners.
Returns
arrayOverrides
Cake\View\Helper::implementedEvents() item()source public
item( array $att [] , array $elements [] )
Converts an array into an <item /> element and its contents
Parameters
- array
$attoptional [] - The attributes of the
<item />element - array
$elementsoptional [] - The list of elements contained in this
<item />
Returns
stringAn RSS
<item /> elementitems()source public
items( array $items , string|array|null $callback null )
Transforms an array of data using an optional callback, and maps it to a set of <item /> tags
Parameters
- array
$items - The list of items to be mapped
- string|array|null
$callbackoptional null A string function name, or array containing an object and a string method name
Returns
stringA set of RSS
<item /> elementstime()source public
time( integer|string|DateTime $time )
Converts a time in any format to an RSS time
Parameters
- integer|string|DateTime
$time - UNIX timestamp or valid time string or DateTime object.
Returns
stringAn RSS-formatted timestamp
See
\Cake\View\Helper\TimeHelper::toRSSMethods inherited from Cake\View\Helper
__call()source public
__call( string $method , array $params )
Provide non fatal errors on missing method calls.
Parameters
- string
$method - Method to invoke
- array
$params - Array of params for the method.
__construct()source public
__construct( Cake\View\View $View , array $config [] )
Default Constructor
Parameters
-
Cake\View\View$View - The View this helper is being attached to.
- array
$configoptional [] - Configuration settings for the helper.
__debugInfo()source public
__debugInfo( )
Returns an array that can be used to describe the internal state of this object.
Returns
array__get()source public
__get( string $name )
Lazy loads helpers.
Parameters
- string
$name - Name of the property being accessed.
Returns
Cake\View\Helper|nullHelper instance if helper with provided name exists
_confirm()source protected
_confirm( string $message , string $okCode , string $cancelCode '' , array $options [] )
Returns a string to be used as onclick handler for confirm dialogs.
Parameters
- string
$message - Message to be displayed
- string
$okCode - Code to be executed after user chose 'OK'
- string
$cancelCodeoptional '' - Code to be executed after user chose 'Cancel'
- array
$optionsoptional [] - Array of options
Returns
stringonclick JS code
addClass()source public
addClass( array $options [] , string|null $class null , string $key 'class' )
Adds the given class to the element options
Parameters
- array
$optionsoptional [] - Array options/attributes to add a class to
- string|null
$classoptional null - The class name being added.
- string
$keyoptional 'class' - the key to use for class.
Returns
arrayArray of options with $key set.
getView()source public
getView( )
Get the view instance this helper is bound to.
Returns
Cake\View\ViewThe bound view instance.
initialize()source public
initialize( array $config )
Constructor hook method.
Implement this method to avoid having to overwrite the constructor and call parent.
Parameters
- array
$config - The configuration settings provided to this helper.
Methods used from Cake\Core\InstanceConfigTrait
_configDelete()source protected
_configDelete( string $key )
Deletes a single config key.
Parameters
- string
$key - Key to delete.
Throws
Cake\Core\Exception\Exceptionif attempting to clobber existing config
_configRead()source protected
_configRead( string|null $key )
Reads a config key.
Parameters
- string|null
$key - Key to read.
Returns
mixed_configWrite()source protected
_configWrite( string|array $key , mixed $value , boolean|string $merge false )
Writes a config key.
Parameters
- string|array
$key - Key to write to.
- mixed
$value - Value to write.
- boolean|string
$mergeoptional false True to merge recursively, 'shallow' for simple merge, false to overwrite, defaults to false.
Throws
Cake\Core\Exception\Exceptionif attempting to clobber existing config
config()source public
config( string|array|null $key null , mixed|null $value null , boolean $merge true )
Gets/Sets the config.
Usage
Reading the whole config:
$this->config();
Reading a specific value:
$this->config('key'); Reading a nested value:
$this->config('some.nested.key'); Setting a specific value:
$this->config('key', $value); Setting a nested value:
$this->config('some.nested.key', $value); Updating multiple config settings at the same time:
$this->config(['one' => 'value', 'another' => 'value']);
Parameters
- string|array|null
$keyoptional null - The key to get/set, or a complete array of configs.
- mixed|null
$valueoptional null - The value to set.
- boolean
$mergeoptional true - Whether to recursively merge or overwrite existing config, defaults to true.
Returns
mixedConfig value being read, or the object itself on write operations.
Throws
Cake\Core\Exception\ExceptionWhen trying to set a key that is invalid.
configShallow()source public
configShallow( string|array $key , mixed|null $value null )
Merge provided config with existing config. Unlike config() which does a recursive merge for nested keys, this method does a simple merge.
Setting a specific value:
$this->configShallow('key', $value); Setting a nested value:
$this->configShallow('some.nested.key', $value); Updating multiple config settings at the same time:
$this->configShallow(['one' => 'value', 'another' => 'value']);
Parameters
- string|array
$key - The key to set, or a complete array of configs.
- mixed|null
$valueoptional null - The value to set.
Returns
$this
getConfig()source public
getConfig( string|null $key null , mixed $default null )
Returns the config.
Usage
Reading the whole config:
$this->getConfig();
Reading a specific value:
$this->getConfig('key'); Reading a nested value:
$this->getConfig('some.nested.key'); Reading with default value:
$this->getConfig('some-key', 'default-value'); Parameters
- string|null
$keyoptional null - The key to get or null for the whole config.
- mixed
$defaultoptional null - The return value when the key does not exist.
Returns
mixedConfig value being read.
setConfig()source public
setConfig( string|array $key , mixed|null $value null , boolean $merge true )
Sets the config.
Usage
Setting a specific value:
$this->setConfig('key', $value); Setting a nested value:
$this->setConfig('some.nested.key', $value); Updating multiple config settings at the same time:
$this->setConfig(['one' => 'value', 'another' => 'value']);
Parameters
- string|array
$key - The key to set, or a complete array of configs.
- mixed|null
$valueoptional null - The value to set.
- boolean
$mergeoptional true - Whether to recursively merge or overwrite existing config, defaults to true.
Returns
$this
Throws
Cake\Core\Exception\ExceptionWhen trying to set a key that is invalid.
Properties detail
Magic properties detail
$Timesource
public Cake\View\Helper\TimeHelper
$Urlsource
public Cake\View\Helper\UrlHelper
© 2005–2017 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.
https://api.cakephp.org/3.4/class-Cake.View.Helper.RssHelper.html