coderius/yii2-pell-widget Pell content editor widget for Yii2.

Pell content WYSIWYG editor Widget for Yii2

  1. Installation
  2. Usage
  3. Examples widget usage
  4. Testing
  5. Further Information
  6. Contributing
  7. Credits
  8. License

Software License Code Coverage Code Intelligence Status Code Quality CodeFactor Build Status

Renders a Pell WYSIWYG text editor plugin widget.

Live demo

Installation

The preferred way to install this extension is through composer.

Either run

composer require coderius/yii2-pell-widget:"~1.0"

or add

"coderius/yii2-pell-widget" : "~1.0"

to the require section of your application's composer.json file.

Usage

For example to use the pell editor with a model:

`php echo Pell::widget([

'model' => $model,
'attribute' => 'text',

]); `

Inside form without model:

`php $value = 'textarea some content';

echo \coderius\pell\Pell::widget([

'name' => 'textarea-name',
'value'  => $value,
'clientOptions' =>[]

]); `

The following example will used not as an element of form:

`php echo Pell::widget([

'asFormPart'  => false,
'value'  => $value,
'clientOptions' =>[
    'onChange' => new JsExpression(
        "html => {
            console.log(html);
        },"
    )
]

]); `

You can also use this widget in an ActiveForm using the widget() method, for example like this:


use coderius\pell\Pell;

<?= $form->field($model, 'text')->widget(Pell::className(), []);?>
About ClientOptions

Please, remember that if you are required to add javascript to the configuration of the js plugin and is required to be plain JS, make use of JsExpression. That class was made by Yii for that specific purpose. For example:

// Having the following scenario
<script> 
    function jsFunctionToBeCalled() {
        // ...
    }
</script>

<?= $form->field($model, 'content')->widget(Pell::className(), [
        'clientOptions' => [
            'defaultParagraphSeparato' => 'div',

            // ...

            'actions' => [
                'bold',
                'italic',
                'underline',
                'strikethrough',
                'heading1',
                'heading2',
                'paragraph',
                'quote',
                'olist',
                'ulist',
                'code',
                'line',
                'link',
                'image',
                [
                    'name'   => 'backColor',
                    'icon'   => '<div style="background-color:pink;">A</div>',
                    'title'  => 'Highlight Color',
                    // this will render the function name without quotes on the configuration options of the plugin
                    'result' => new JsExpression('jsFunctionToBeCalled')
                ],
            ],
            
            // ...
        ]
        
    ]
]); ?>

Examples widget usage

Please see Examples usage in yii2 view files for more examples.

Testing

$ phpunit

Further Information

Please, check the Pell plugin github documentation for further information about its configuration options.

Contributing

Please see CONTRIBUTING for details.

Credits

License

The MIT License (MIT). Please see License File for more information.

Web development has never been so fun!
coderius.biz.ua

0 0
1 follower
2 downloads
Yii Version: 2.0
License: MIT
Category: User Interface
Developed by: Sergio
Created on: Nov 9, 2019
Last updated: 8 days ago
Packagist Profile
Github Repository

Related Extensions