Class TextHelper

Text helper library.

Text manipulations: Highlight, excerpt, truncate, strip of links, convert email addresses to mailto: links...

AppHelper

TextHelper

Package: Cake\View\Helper
Link: http://book.cakephp.org/2.0/en/core-libraries/helpers/text.html
See: String
Copyright: Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
License: License (http://www.opensource.org/licenses/mit-license.php)
Location: Cake/View/Helper/TextHelper.php

Properties summary

$_engine protected

String utility instance
$_placeholders protected

array

An array of md5sums and their contents. Used when inserting links into text.
$helpers public

array

helpers

Magic properties summary

$Html public

HtmlHelper

Method Summary

__call() public

Call methods from String utility class
__construct() public

Constructor
_insertPlaceHolder() protected

Saves the placeholder for a string, for later use. This gets around double escaping content in URL's.
_linkEmails() protected

Links email addresses
_linkUrls() protected

Replace placeholders with links.
autoLink() public

Convert all links and email addresses to HTML links.
autoLinkEmails() public

Adds email links (<a href="mailto:....) to a given text.
autoLinkUrls() public

Adds links (<a href=....) to a given text, by finding text that begins with strings like http:// and ftp://.
excerpt() public
highlight() public
stripLinks() public
toList() public
truncate() public

Method Detail

__call() public ¶

__call( $method , $params )

Call methods from String utility class

__construct() public ¶

__construct( View $View , array $settings = array() )

Constructor

Settings:

engine Class name to use to replace String functionality. The class needs to be placed in the Utility directory.

Parameters

View $View: the view object the helper is attached to.
array $settings optional array(): Settings array Settings array

Throws

CakeException
when the engine class could not be found.

_insertPlaceHolder() protected ¶

_insertPlaceHolder( array $matches )

Saves the placeholder for a string, for later use. This gets around double escaping content in URL's.

Parameters

array $matches: An array of regexp matches.

Returns

string
Replaced values.

_linkEmails() protected ¶

_linkEmails( string $text , array $options )

Links email addresses

Parameters

string $text: The text to operate on
array $options: An array of options to use for the HTML.

Returns

string

See

TextHelper::autoLinkEmails()

_linkUrls() protected ¶

_linkUrls( string $text , array $htmlOptions )

Replace placeholders with links.

Parameters

string $text: The text to operate on.
array $htmlOptions: The options for the generated links.

Returns

string
The text with links inserted.

autoLink() public ¶

autoLink( string $text , array $options = array() )

Convert all links and email addresses to HTML links.

Options

escape Control HTML escaping of input. Defaults to true.

Parameters

string $text: Text
array $options optional array(): Array of HTML options, and options listed above.

Returns

string
The text with links

Link

http://book.cakephp.org/2.0/en/core-libraries/helpers/text.html#TextHelper::autoLink

autoLinkEmails() public ¶

autoLinkEmails( string $text , array $options = array() )

Adds email links (<a href="mailto:....) to a given text.

Options

escape Control HTML escaping of input. Defaults to true.

Parameters

string $text: Text
array $options optional array(): Array of HTML options, and options listed above.

Returns

string
The text with links

Link

http://book.cakephp.org/2.0/en/core-libraries/helpers/text.html#TextHelper::autoLinkEmails

autoLinkUrls() public ¶

autoLinkUrls( string $text , array $options = array() )

Adds links (<a href=....) to a given text, by finding text that begins with strings like http:// and ftp://.

Options

escape Control HTML escaping of input. Defaults to true.

Parameters

string $text: Text
array $options optional array(): Array of HTML options, and options listed above.

Returns

string
The text with links

Link

http://book.cakephp.org/2.0/en/core-libraries/helpers/text.html#TextHelper::autoLinkUrls

excerpt() public ¶

excerpt( string $text , string $phrase , integer $radius = 100 , string $ending = '...' )

Parameters

string $text: String to search the phrase in
string $phrase: Phrase that will be searched for
integer $radius optional 100: The amount of characters that will be returned on each side of the founded phrase
string $ending optional '...': Ending that will be appended

Returns

string
Modified string

See

String::excerpt()

Link

http://book.cakephp.org/2.0/en/core-libraries/helpers/text.html#TextHelper::excerpt

highlight() public ¶

highlight( string $text , string $phrase , array $options = array() )

Parameters

string $text: Text to search the phrase in
string $phrase: The phrase that will be searched
array $options optional array(): An array of html attributes and options.

Returns

string
The highlighted text

See

String::highlight()

Link

http://book.cakephp.org/2.0/en/core-libraries/helpers/text.html#TextHelper::highlight

stripLinks() public ¶

stripLinks( string $text )

Parameters

string $text: Text

Returns

string
The text without links

See

String::stripLinks()

Link

http://book.cakephp.org/2.0/en/core-libraries/helpers/text.html#TextHelper::stripLinks

toList() public ¶

toList( array $list , string $and = 'and' , string $separator = ', ' )

Parameters

array $list: The list to be joined
string $and optional 'and': The word used to join the last and second last items together with. Defaults to 'and'
string $separator optional ', ': The separator used to join all the other items together. Defaults to ', '

Returns

string
The glued together string.

See

String::toList()

Link

http://book.cakephp.org/2.0/en/core-libraries/helpers/text.html#TextHelper::toList

truncate() public ¶

truncate( string $text , integer $length = 100 , array $options = array() )

Parameters

string $text: String to truncate.
integer $length optional 100: Length of returned string, including ellipsis.
array $options optional array(): An array of html attributes and options.

Returns

string
Trimmed string.

See

String::truncate()

Link

http://book.cakephp.org/2.0/en/core-libraries/helpers/text.html#TextHelper::truncate

Properties detail

`$_engine` ¶

protected

String utility instance

`$_placeholders` ¶

protected array

An array of md5sums and their contents. Used when inserting links into text.

array()

`$helpers` ¶

public array

helpers

array('Html')

Magic properties detail

`$Html` ¶

public HtmlHelper

Packages

Classes

Class TextHelper

Properties summary

Magic properties summary

Method Summary

__call() public

__construct() public

_insertPlaceHolder() protected

_linkEmails() protected

_linkUrls() protected

autoLink() public

autoLinkEmails() public

autoLinkUrls() public

excerpt() public

highlight() public

stripLinks() public

toList() public

truncate() public

Method Detail

__call() public ¶

__construct() public ¶

Settings:

Parameters

Throws

_insertPlaceHolder() protected ¶

Parameters

Returns

_linkEmails() protected ¶

Parameters

Returns

See

_linkUrls() protected ¶

Parameters

Returns

autoLink() public ¶

Options

Parameters

Returns

Link

autoLinkEmails() public ¶

Options

Parameters

Returns

Link

autoLinkUrls() public ¶

Options

Parameters

Returns

Link

excerpt() public ¶

Parameters

Returns

See

Link

highlight() public ¶

Parameters

Returns

See

Link

stripLinks() public ¶

Parameters

Returns

See

Link

toList() public ¶

Parameters

Returns

See

Link

truncate() public ¶

Parameters

Returns

See

Link

Properties detail

$_engine ¶

$_placeholders ¶

$helpers ¶

Magic properties detail

`$_engine` ¶

`$_placeholders` ¶

`$helpers` ¶

`$Html` ¶