Format Helper

A CakePHP helper to handle some common format topics.

Setup

Include helper in your AppView class as

$this->loadHelper('Tools.Format', [
    ...
]);

You can store default configs also in Configure key 'Format'.

Usage

icon()

Deprecated: Use IconHelper::render() instead.

Display font icons using the default namespace or an already prefixed one.

echo $this->Html->link(
    $this->Format->icon('view'),
    $url,
    $attributes
);

Font Awesome v4 works out of the box. For v5/v6 you want to use a custom namespace and prefix (either in app.php or in AppView.php):

$this->loadHelper('Tools.Format', [
    'iconNamespace' => 'fas',
    'autoPrefix' => 'fa',
]);

You can alias them via Configure for more usability:

// In app.php
    'Format' => [
        'fontIcons' => [
            'login' => 'fa fa-sign-in',
            'logout' => 'fa fa-sign-out',
            'translate' => 'fa fa-language',
        ],
    ],

// in the template
echo $this->Format->icon('translate', ['title' => 'Translate this']);

Note: For forward compatibility you can also use 'iconHelper' => true` config to directly forward any old helper call to the new one. This can be useful for the ones inside plugins you do not control.

yesNo()

Displays yes/no symbol for e.g. boolean values as more user friendly representation.

ok()

Display a colored result based on the 2nd argument being true or false.

echo $this->Format->ok($text, $bool, $optionalAttributes);

disabledLink()

Display a disabled link with a default title.

array2table()

Translate a result array into a HTML table.

Format.md 1.6 KB Permalink History Raw