Adds Twig filters for working with json.

dev-main 2021-10-21 12:22 UTC

This package is auto-updated.

Last update: 2024-05-21 18:08:00 UTC


README

Adds Twig filters for working with json.

Screenshot

Requirements

This plugin requires Craft CMS 3.0.0-beta.23 or later.

Installation

To install the plugin, follow these instructions.

  1. Open your terminal and go to your Craft project:

     cd /path/to/project
    
  2. Then tell Composer to load the plugin:

     composer require chattervast/jsond
    
  3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Json'd.

Json'd Overview

Json'd adds 3 twig filters: |json_decoded , |json_last_error , and |json_last_error_msg .

Using Json'd

json_decoded

Pass a json string to |json_decoded and it will return an object.

{{ entry.jsonField|json_decoded }}

To return an array instead of an object, pass a parameter of 'true'.

{{ entry.jsonField|json_decoded('true') }}

|json_decoded accepts all of the parameters that the json_decoded function in PHP accepts.

{{ entry.jsonField|json_decoded('object/associative', 'depth', 'option') }}

Object/associative is set to false by default returning an object. Depth (passed as an integer), sets the depth to which the json is decoded. Default recursion depth in PHP is 512. Options available are: JSON_BIGINT_AS_STRING - Decodes large integers as their original string value. JSON_OBJECT_AS_ARRAY - Decodes as array. Default of |json_decoded. JSON_THROW_ON_ERROR - Throws JsonException if an error occurs instead of setting the global error state that is retrieved with json_last_error().

json_last_error_msg

Returns the error string of json_decoded.

{{ entry.jsonField|json_last_error_msg }}

Accepts 'encode' as a parameter to return the error string of json_encode.

{{ entry.jsonField|json_last_error_msg('encode') }}

json_last_error

Returns the last error of json_decoded.

{{ entry.jsonField|json_last_error }}

Accepts 'encode' as a parameter to return the last error of json_encode.

{{ entry.jsonField|json_last_error('encode') }}

PHP Documentation

To read the full documentation of the PHP functions and their accepted parameters and return values, see these links:

json_decoded json_last_error_msg json_last_error

Brought to you by Chattervast