Extension for the Yii2 framework

Installs: 16 445

Dependents: 0

Suggesters: 0

Security: 0

Stars: 14

Watchers: 4

Forks: 9

Open Issues: 0



v1.1.5 2018-04-30 12:12 UTC

This package is auto-updated.

Last update: 2024-05-26 08:44:17 UTC



This extension allows you to quickly add full-featured modal forms to your appllication. Main featues are:

  1. Based on bootstrap modal forms.
  2. Allows quickly add behavior to interact with viewing and updating data in modal dialogs.
  3. Catch form post events, converts them to ajax request and display results in the same modal dialog.


The preferred way to install this extension is through composer.

To install, either run

$ php composer.phar require conquer/modal "*"

or add

"conquer/modal": "*"

to the require section of your composer.json file.


Somewhere in the main layout

    'selector' => '.modal-form',

Whenever you want to add behavior to tag a, just add class 'modal-form'

    echo Html::a('Some modal action', ['controller/action'], ['class' => 'modal-form']);

To improve traffic data and error exceptions you need to control layout rendering when ajax requests. I recommend you to override default rendering in your controllers:

class Controller extends \yii\web\Controller
     * Exclude layout rendering when ajax requests
    public function render($view, $params = [])
        if (\Yii::$app->request->isAjax) {
            return $this->renderPartial($view, $params);
        return parent::render($view, $params);

Client Options

To add client options use clientOptions key. Available client options are: id, class, tabindex.

  • Id key replaces existing auto generated id attribute.
  • Class key adds classes to html class attribute.
  • Tabindex key replaces existing default tabindex html attribute (-1), when false, then no tabindex attribute appears.
    'selector' => '.modal-form',
    'clientOptions' => [
        'id' => 'sample-unique-id',
        'class' => 'sample-class1 sample-class2',
        'tabindex' => false


conquer/modal is released under the MIT License. See the bundled LICENSE for details.