dmstr/yii2-widgets2-module

Yii 2.0 Framework Widget Manager

2.7.4 2024-05-13 11:08 UTC

Requires

• 2amigos/yii2-ckeditor-widget: ^2.0.2
• 2amigos/yii2-translateable-behavior: ^1.1.0
• bedezign/yii2-audit: ^1.0
• bower-asset/jquery-cookie: ~1.4.1
• dmstr/yii2-active-record-permissions: ^1.0.0
• dmstr/yii2-ajax-button: ^1.0
• dmstr/yii2-json-editor: ^1.0.0
• dmstr/yii2-web: ^0.3.1 || ^0.4.0 || ^1.0.0
• insolita/yii2-adminlte-widgets: ^1.1.4
• justinrainbow/json-schema: ^5.2.0
• kdn/yii2-json-editor: ^2.5.1
• mikehaertl/php-shellcommand: ^1.2.4
• rmrevin/yii2-fontawesome: ~2.9
• scrivo/highlight.php: ~8.0 || ~9.0
• trntv/yii2-aceeditor: ^2.1.0
• yiisoft/yii2: 2.0.*
• yiisoft/yii2-twig: ^2.0.4
• zhuravljov/yii2-datetime-widgets: ^1.1.0

proprietary

• Tobias Munk

• extension
• yii2

README

Widget manager using twig templates

Installation

The preferred way to install this extension is through composer.

Either run

composer require dmstr/yii2-widgets2-module

to the require section of your composer.json file.

Testing

cd tests

docker-compose up -d

docker-compose run phpfpm bash

setup.sh

Config

...
'modules => [
	'widgets' => [
		'class' => '\hrzg\widget\Module',
		'layout' => '@backend/views/layouts/main',
		'playgroundLayout' => '@frontend/views/layouts/main',
		'dateBasedAccessControl' => true,
		'datepickerMinutes' => false,
		'timezone' => 'Europe/Berlin',
		// set ajax option for JsonEditor
		'allowAjaxInSchema' => false,
        // If true, the json content properties will be validated against the json schema from the widget_template.
        // To be BC the default is false, but you should enable it
		'validateContentSchema' => false
	]
]
...

Settings

availablePhpClasses availableFrontendPhpClasses - Templates with one of the listed classes in this setting will be outputed in cell widgets dropdown for available templates (default: hrzg\widget\widgets\TwigTemplate)

Usage

Once the extension is installed, simply use it in your code by :

Layout

Example with yii2-prototype-module

• Yii 2.0 Twig extension
• Twig documentation

{{ use ('hrzg/widget/widgets') }}
{{ cell_widget({id: 'main'}) }}

Widget

• Standard Twig widget hrzg\widget\widgets\TwigTemplate
• Char-Rank ordering 001, 10, 5, aa1, aa1.2, b0 (not numeric)

JSON

• JSON schema editor

Settings

Section: widgets

Key: availablePhpClasses

Type: JSON

####Example:

{"hrzg\\widget\\widgets\\TwigTemplate": "Twig layout"}

Widget example

Basic

{
    "title": "Basic",
    "type": "object",
    "properties": {
        "headline": {
            "type": "string",
            "default": "Avo vole tioma profitanto ts,"
        },
        "text_html": {
            "type": "string",
            "format": "html",
            "default": "Ja sub kiam aliu, fo unt fora danke helpverbo, dev bv tele kibi piedpilko.",
            "options": {
                "wysiwyg": true
            }
        }
    }
}

<h2>{{ headline }}</h2>
<p>{{ text_html }}</p>

For more examples, please see the docs

Upgrading

from 0.2 to 0.3

{{ cell_widget({id: 'header'}) }}

RBAC

Available Permission items

Settings