PopoverX supports configuration of the bootstrap library version so that you can use this either with any Bootstrap version 3.x and above. For setting up the bootstrap version for your extension, you can configure the PopoverX::bsVersion property to one of the following.

• To use with bootstrap 3 library - you can set PopoverX::bsVersion property to any string starting with 3 (e.g. 3 or 3.3.7 or 3.x)

• To use with bootstrap 4 library - you can set PopoverX::bsVersion property to any string starting with 4 (e.g. 4 or 4.6.0 or 4.x)

• To use with bootstrap 5 library - you can set PopoverX::bsVersion property to any string starting with 5 (e.g. 5 or 5.1.0 or 5.x)

'params' => [
    'bsVersion' => '5.x', // this will set globally `bsVersion` to Bootstrap 5.x for all Krajee Extensions
    // other settings
    // 'adminEmail' => 'admin@example.com'
]

"yiisoft/yii2-bootstrap5": "@dev"

"yiisoft/yii2-bootstrap4": "@dev"

"yiisoft/yii2-bootstrap": "@dev"

The yii2-popover-x extension can be installed automatically or manually using one of these options:

$ php composer.phar require kartik-v/yii2-popover-x "dev-master"

"kartik-v/yii2-popover-x": "dev-master"

• bsVersion: string | int, the bootstrap library version to be used for the extension. Refer the Bootstrap Info section for details and pre-requisites on setting this property.

  • To use with Bootstrap library - you can set this to any string starting with 3 (e.g. 3 or 3.3.7 or 4.x / 3.x)

  • To use with bootstrap 4 - you can set this to any string starting with 4 (e.g. 4 or 4.6.0 or 4.x)

  • To use with bootstrap 5 - you can set this to any string starting with 4 (e.g. 5 or 5.1.0 or 5.x)

• bsColCssPrefixes: array, the bootstrap grid column css prefixes mapping, the key is the bootstrap versions, and the value is an array containing the sizes and their corresponding grid column css prefixes. The class using this trait, must implement kartik\base\BootstrapInterface. If not set will default to:.

  [
     3 => [
        self::SIZE_X_SMALL => 'col-xs-',
        self::SIZE_SMALL => 'col-sm-',
        self::SIZE_MEDIUM => 'col-md-',
        self::SIZE_LARGE => 'col-lg-',
        self::SIZE_X_LARGE => 'col-lg-',
        self::SIZE_XX_LARGE => 'col-lg-',
     ],
     4 => [
        self::SIZE_X_SMALL => 'col-',
        self::SIZE_SMALL => 'col-sm-',
        self::SIZE_MEDIUM => 'col-md-',
        self::SIZE_LARGE => 'col-lg-',
        self::SIZE_X_LARGE => 'col-xl-',
        self::SIZE_XX_LARGE => 'col-xl-',
     ],
     5 => [
        self::SIZE_X_SMALL => 'col-',
        self::SIZE_SMALL => 'col-sm-',
        self::SIZE_MEDIUM => 'col-md-',
        self::SIZE_LARGE => 'col-lg-',
        self::SIZE_X_LARGE => 'col-xl-',
        self::SIZE_XX_LARGE => 'col-xxl-',
     ],
  ];
  

• type: string, the bootstrap contextual color type for displaying the popover. Defaults to PopoverX::TYPE_DEFAULT. Must be one of the following:

  • PopoverX::TYPE_DEFAULT or 'default'

  • PopoverX::TYPE_PRIMARY or 'primary'

  • PopoverX::TYPE_INFO or 'info'

  • PopoverX::TYPE_SUCCESS or 'success'

  • PopoverX::TYPE_DANGER or 'danger'

  • PopoverX::TYPE_WARNING or 'warning'

• placement: string, the placement of the popover with respect to the target element. Defaults to PopoverX::ALIGN_RIGHT. Must be one of the following:

  • PopoverX::ALIGN_RIGHT or 'right'

  • PopoverX::ALIGN_LEFT or 'left'

  • PopoverX::ALIGN_TOP or 'top'

  • PopoverX::ALIGN_BOTTOM or 'bottom'

  • PopoverX::ALIGN_TOP_LEFT or 'top top-left'

  • PopoverX::ALIGN_BOTTOM_LEFT or 'bottom bottom-left'

  • PopoverX::ALIGN_TOP_RIGHT or 'top top-right'

  • PopoverX::ALIGN_BOTTOM_RIGHT or 'bottom bottom-right'

  • PopoverX::ALIGN_LEFT_TOP or 'left left-top'

  • PopoverX::ALIGN_LEFT_BOTTOM or 'left left-bottom'

  • PopoverX::ALIGN_RIGHT_TOP or 'right right-top'

  • PopoverX::ALIGN_RIGHT_BOTTOM or 'right right-bottom'

• size: string, the size of the popover dialog. Offers two other sizes in addition to the default size. Must be one of the following:

  • PopoverX::SIZE_LARGE or 'lg' for large size

  • PopoverX::SIZE_MEDIUM or 'md' for medium size

• header: string, the header content in the popover dialog.

• headerOptions: array, the the HTML attributes for the header. The following special options are supported:

  • tag: string, the HTML tag for rendering the header. Defaults to 'div'.

• content: string, the body content of the popover. You can directly pass this if you do not wish to use the widget with begin and end methods.

• arrowOptions: array, the the HTML attributes for the arrow. The CSS class and styling for the arrow is automatically usually determined based on the placement property.

• footer: string, the footer content in the popover dialog.

• footerOptions: array, the the HTML attributes for the footer. The following special options are supported:

  • tag: string, the HTML tag for rendering the footer. Defaults to 'div'.

• closeButton: array, the options for rendering the close button tag. The close button is displayed in the header of the modal window. Clicking on the button will hide the modal window. If this is null, no close button will be rendered. The following special options are supported:

  • tag: string, the HTML tag for rendering the rendering the button. Defaults to 'button'.

  • label: string, he label of the button. Defaults to '×'.

  The rest of the options will be rendered as the HTML attributes of the button tag. Please refer to the PopoverX plugin documentation and the Modal plugin help for the supported HTML attributes.

• toggleButton: array, the options for rendering the toggle button tag. The toggle button is used to toggle the visibility of the popover dialog. Clicking on the button will hide the modal window. If this property is null, no toggle button will be rendered. The following special options are supported:

  • tag: string, the HTML tag for rendering the rendering the button. Defaults to 'button'.

  • label: string, he label of the button. Defaults to 'Show'.

  The rest of the options will be rendered as the HTML attributes of the button tag. Please refer to the PopoverX plugin documentation and the Modal plugin help for the supported HTML attributes.

• options: array the HTML attributes for the widget input tag.

• pluginOptions: array the plugin settings/options for the Bootstrap Popover X Plugin. This will be applied only if you toggleButton property is NULL. There are a quite a few options you can set in this plugin. Refer the plugin options documentation for details.

• pluginEvents: array the PopoverX JQuery events. You must define events in event-name=>event-function format. All events will be stacked in the sequence. Refer the plugin events documentation for details. For example:

  pluginEvents = [
      "click.target.popoverX"=>"function() { log("click.target.popoverX"); }",
      "load.complete.popoverX"=>"function() { log("load.complete.popoverX"); }",
  ];
  

use kartik\popover\PopoverX;

$content = '<p class="text-justify">' .
    'Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor.' . 
    '</p>';
    
// right
echo PopoverX::widget([
    'header' => 'Hello world',
    'placement' => PopoverX::ALIGN_RIGHT,
    'content' => $content,
    'footer' => Html::button('Submit', ['class'=>'btn btn-sm btn-primary']),
    'toggleButton' => ['label'=>'Right', 'class'=>'btn btn-default btn-outline-secondary'],
]);

// left
echo PopoverX::widget([
    'header' => 'Hello world',
    'placement' => PopoverX::ALIGN_LEFT,
    'content' => $content,
    'footer' => Html::button('Submit', ['class'=>'btn btn-sm btn-primary']),
    'toggleButton' => ['label'=>'Left', 'class'=>'btn btn-default btn-outline-secondary'],
]);

// top
echo PopoverX::widget([
    'header' => 'Hello world',
    'placement' => PopoverX::ALIGN_TOP,
    'content' => $content,
    'footer' => Html::button('Submit', ['class'=>'btn btn-sm btn-primary']),
    'toggleButton' => ['label'=>'Top', 'class'=>'btn btn-default btn-outline-secondary'],
]);

// bottom
echo PopoverX::widget([
    'header' => 'Hello world',
    'placement' => PopoverX::ALIGN_BOTTOM,
    'content' => $content,
    'footer' => Html::button('Submit', ['class'=>'btn btn-sm btn-primary']),
    'toggleButton' => ['label'=>'Bottom', 'class'=>'btn btn-default btn-outline-secondary'],
]);

echo '<hr>';

// top left
echo PopoverX::widget([
    'header' => 'Hello world',
    'placement' => PopoverX::ALIGN_TOP_LEFT,
    'content' => $content,
    'footer' => Html::button('Submit', ['class'=>'btn btn-sm btn-primary']),
    'toggleButton' => ['label'=>'Top Left', 'class'=>'btn btn-default btn-outline-secondary'],
]);

// bottom left
echo PopoverX::widget([
    'header' => 'Hello world',
    'placement' => PopoverX::ALIGN_BOTTOM_LEFT,
    'content' => $content,
    'footer' => Html::button('Submit', ['class'=>'btn btn-sm btn-primary']),
    'toggleButton' => ['label'=>'Bottom Left', 'class'=>'btn btn-default btn-outline-secondary'],
]);

// top right
echo PopoverX::widget([
    'header' => 'Hello world',
    'placement' => PopoverX::ALIGN_TOP_RIGHT,
    'content' => $content,
    'footer' => Html::button('Submit', ['class'=>'btn btn-sm btn-primary']),
    'toggleButton' => ['label'=>'Top Right', 'class'=>'btn btn-default btn-outline-secondary'],
]);

// bottom right
echo PopoverX::widget([
    'header' => 'Hello world',
    'placement' => PopoverX::ALIGN_BOTTOM_RIGHT,
    'content' => $content,
    'footer' => Html::button('Submit', ['class'=>'btn btn-sm btn-primary']),
    'toggleButton' => ['label'=>'Bottom Right', 'class'=>'btn btn-default btn-outline-secondary'],
]);

echo '<hr>';

// right top
echo PopoverX::widget([
    'header' => 'Hello world',
    'placement' => PopoverX::ALIGN_RIGHT_TOP,
    'content' => $content,
    'footer' => Html::button('Submit', ['class'=>'btn btn-sm btn-primary']),
    'toggleButton' => ['label'=>'Right Top', 'class'=>'btn btn-default btn-outline-secondary'],
]);

// right bottom
echo PopoverX::widget([
    'header' => 'Hello world',
    'placement' => PopoverX::ALIGN_RIGHT_BOTTOM,
    'content' => $content,
    'footer' => Html::button('Submit', ['class'=>'btn btn-sm btn-primary']),
    'toggleButton' => ['label'=>'Right Bottom', 'class'=>'btn btn-default btn-outline-secondary'],
]);

// left top
echo PopoverX::widget([
    'header' => 'Hello world',
    'placement' => PopoverX::ALIGN_LEFT_TOP,
    'content' => $content,
    'footer' => Html::button('Submit', ['class'=>'btn btn-sm btn-primary']),
    'toggleButton' => ['label'=>'Left Top', 'class'=>'btn btn-default btn-outline-secondary'],
]);

// left bottom
echo PopoverX::widget([
    'header' => 'Hello world',
    'placement' => PopoverX::ALIGN_LEFT_BOTTOM,
    'content' => $content,
    'footer' => Html::button('Submit', ['class'=>'btn btn-sm btn-primary']),
    'toggleButton' => ['label'=>'Left Bottom', 'class'=>'btn btn-default btn-outline-secondary'],
]);

// large
echo PopoverX::widget([
    'header' => 'Hello world',
    'size' => PopoverX::SIZE_LARGE,
    'placement' => PopoverX::ALIGN_RIGHT,
    'content' => $content,
    'toggleButton' => ['label'=>'Large', 'class'=>'btn btn-default btn-outline-secondary'],
]);

// medium
echo PopoverX::widget([
    'header' => 'Hello world',
    'size' => PopoverX::SIZE_MEDIUM,
    'placement' => PopoverX::ALIGN_RIGHT,
    'content' => $content,
    'toggleButton' => ['label'=>'Medium', 'class'=>'btn btn-default btn-outline-secondary'],
]);

// primary
echo PopoverX::widget([
    'header' => 'Hello world',
    'type' => PopoverX::TYPE_PRIMARY,
    'placement' => PopoverX::ALIGN_BOTTOM,
    'content' => $content,
    'toggleButton' => ['label'=>'Primary', 'class'=>'btn btn-primary'],
]);

// info
echo PopoverX::widget([
    'header' => 'Hello world',
    'type' => PopoverX::TYPE_INFO,
    'placement' => PopoverX::ALIGN_BOTTOM,
    'content' => $content,
    'toggleButton' => ['label'=>'Info', 'class'=>'btn btn-info'],
]);

// success
echo PopoverX::widget([
    'header' => 'Hello world',
    'type' => PopoverX::TYPE_SUCCESS,
    'placement' => PopoverX::ALIGN_BOTTOM,
    'content' => $content,
    'toggleButton' => ['label'=>'Success', 'class'=>'btn btn-success'],
]);

// danger
echo PopoverX::widget([
    'header' => 'Hello world',
    'type' => PopoverX::TYPE_DANGER,
    'placement' => PopoverX::ALIGN_BOTTOM,
    'content' => $content,
    'toggleButton' => ['label'=>'Danger', 'class'=>'btn btn-danger'],
]);

// warning
echo PopoverX::widget([
    'header' => 'Hello world',
    'type' => PopoverX::TYPE_WARNING,
    'placement' => PopoverX::ALIGN_BOTTOM,
    'content' => $content,
    'toggleButton' => ['label'=>'Warning', 'class'=>'btn btn-warning'],
]);

// advanced html content (forms) with popover footer
use kartik\popover\PopoverX;
use kartik\helpers\Html;
use kartikorm\ActiveForm;
PopoverX::begin([
    'placement' => PopoverX::ALIGN_TOP,
    'toggleButton' => ['label'=>'Login', 'class'=>'btn btn-default btn-outline-secondary'],
    'header' => '<i class="fas fa-lock"></i> Enter credentials',
    'footer' => Html::button('Submit', [
            'class' => 'btn btn-sm btn-primary', 
            'onclick' => '$("#kv-login-form").trigger("submit")'
        ]) . Html::button('Reset', [
            'class' => 'btn btn-sm btn-default', 
            'onclick' => '$("#kv-login-form").trigger("reset")'
        ])
]);
// form with an id used for action buttons in footer
$form = ActiveForm::begin(['fieldConfig'=>['showLabels'=>false], 'options' => ['id'=>'kv-login-form']]);
echo $form->field($model, 'username')->textInput(['placeholder'=>'Enter user...']);
echo $form->field($model, 'password')->passwordInput(['placeholder'=>'Enter password...']);
ActiveForm::end();
PopoverX::end();


// Advanced usage of PopoverX inside a Bootstrap Modal Dialog.
Modal::begin([
	'title' => 'My Modal', 
	'toggleButton' => ['label' => 'Popover inside Modal', 'class' => 'btn btn-primary']
]);
echo '<p>Some custom content above in my modal dialog. Popover can be clicked below to see details:</p>';
echo PopoverX::widget([
    'header' => 'Hello world',
    'type' => PopoverX::TYPE_INFO,
    'placement' => PopoverX::ALIGN_BOTTOM,
    'content' => $content,
    'toggleButton' => ['label'=>'My Popover', 'class'=>'btn btn-info'],
]);
echo '<hr><p>Some more custom content below in my modal dialog.</p>';
Modal::end();

<?php
use kartik\popover\PopoverX;
use kartik\helpers\Html;
?>
<nav class="navbar navbar-expand-lg navbar-dark bg-dark">
    <a class="navbar-brand p-0" href="#">Navbar</a>
    <button class="navbar-toggler" type="button" data-toggle="collapse" data-bs-toggle="collapse" data-target="#navbarColor01"
            aria-controls="navbarColor01" aria-expanded="false" aria-label="Toggle navigation">
        <span class="navbar-toggler-icon"></span>
    </button>

    <div class="collapse navbar-collapse" id="navbarColor01">
        <ul class="navbar-nav mr-auto me-auto">
            <li class="nav-item active">
                <a class="nav-link" href="#">Home <span class="sr-only">(current)</span></a>
            </li>
            <li class="nav-item">
                <a class="nav-link" href="#">Features</a>
            </li>
            <li class="nav-item">
                <a class="nav-link" href="#">Pricing</a>
            </li>
            <li class="nav-item">
                <a class="nav-link" href="#">About</a>
            </li>
        </ul>
        <form class="form-inline">
            <?= PopoverX::widget([
                'header' => 'Hello world',
                'placement' => PopoverX::ALIGN_BOTTOM_RIGHT,
                'size' => 'md',
                'content' => '<p class="text-justify">' .
                    'Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor.' .
                    '</p>',
                'footer' => Html::button('Proceed »', ['class' => 'btn btn-sm btn-outline-secondary']),
                'toggleButton' => [
                    'label' => 'Logout ' . Html::tag('span', '',
                            ['class' => 'fas fa-lock']),
                    'class' => 'btn btn-outline-light my-2 my-sm-0'
                ],
                'pluginOptions' => [
                    'dialogCss' => ['z-index' => 1051], // will overlay the popover over the navbar
                ]
            ]) ?>
        </form>
    </div>
</nav>

yii2-popover-x is released under the BSD-3-Clause License. See the bundled LICENSE.md for details.