README

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist pavlinter/yii2-buttons "dev-master"

or add

"pavlinter/yii2-buttons": "dev-master"

to the require section of your composer.json file.

Usage

Ajax Buttons

Simple GET Request

<?= \pavlinter\buttons\AjaxButton::widget([
    /*
    'options' => [
        'class' => 'btn btn-primary',
    ],
    'spinnerOptions' => [
        'class' => 'ab-spinner-black', //ab-spinner-red|ab-spinner-green|ab-spinner-blue|ab-spinner-white
    ],
    */
    'id' => 'my-btn',
    'label' => 'My Button',
    'ajaxOptions' => [
        /*
        'dataType' => 'json',
        'always' => 'function(jqXHR, textStatus){jQuery(".ab-show-" + abId).hide();jQuery(".ab-hide-" + abId).show();}',
        'fail' => 'function(){}',
        'then' => 'function(){}',
        */
        'url' => ['', 'id' => 5], //default current page
        'done' => 'function(data){

        }',
    ],
]);?>

Simple POST Request

<?= \pavlinter\buttons\AjaxButton::widget([
    'ajaxOptions' => [
        'data' => [
            'id' => 6,
        ],
        'done' => 'function(data){}',
    ],
]);?>

Send Form

<?php $form = ActiveForm::begin(['id' => 'myForm']); ?>
    <input type="text" name="name" value="Jon"/>
    <input type="text" name="phone" value="4859282"/>
    <?= \pavlinter\buttons\AjaxButton::widget([
        'ajaxOptions' => [
            'type' => 'post',
            'done' => 'function(data){}',
        ],
    ]);?>
<?php ActiveForm::end(); ?>

Send form and own data

<?= \pavlinter\buttons\AjaxButton::widget([
    'ajaxOptions' => [
        'type' => 'post',
        'dataType' => 'html',
        'beforeSend' => 'function(jqXHR, settings){
            //defined abId = id widget;
            var data = $("#myForm").serializeArray();
            data.push({name: "id",value: abId});
            settings.data = $.param(data);
        }',
        'data' => [],
        'done' => 'function(data){

        }',
    ],
]);?>

Redirect Buttons

Add hidden input and send form

<?php $form = ActiveForm::begin([
    'id' => 'myTestForm',
]); ?>

    <?= \pavlinter\buttons\InputButton::widget([
        'label' => 'Redirect To Contact Page',
        'input' => 'redirectId',
        'name' => 'redirect',
        'value' => \yii\helpers\Url::to(['site/contact']),
        'formSelector' => $form, //form object or form selector
    ]);?>

    <?= \pavlinter\buttons\InputButton::widget([
        'options' => [],
        'label' => 'Redirect To About Page',
        'input' => [
            'id' => 'redirectId',
            'class' => 'simpleClass',
        ],
        'name' => 'redirect',
        'value' => \yii\helpers\Url::to(['site/about']),
        'formSelector' => '#myTestForm',
    ]);?>

    <?= \pavlinter\buttons\InputButton::widget([
        'label' => 'Remove Input',
        'input' => 'redirectId',
        'name' => 'redirect',
        //'value' => null, //remove redirect input and send form
        'formSelector' => $form,
    ]);?>

<?php ActiveForm::end(); ?>

Controller

public function actionIndex($id = null)
{
    ...
    if (($redirect = Yii::$app->request->post('redirect'))) {
        return $this->redirect($redirect);
    }
    ...

    return $this->render('index');
}