vitexsoftware/ease-bootstrap5-widgets

EasePHP framework addons and code snipplets

1.5.0 2026-06-03 17:12 UTC

Requires

• vitexsoftware/ease-twbootstrap5: ^1.3

Requires (Dev)

• ergebnis/composer-normalize: ^2.51
• ergebnis/php-cs-fixer-config: ^6.61
• friendsofphp/php-cs-fixer: ^3.95
• phpstan/phpstan: *
• phpunit/phpunit: *

MIT

• Vítězslav Dvořák

README

EasePHP Twitter bootstrap5 Widgets

Object oriented PHP Framework for easy&fast writing small/middle sized apps.

Bricks Included

• BsIcon - Bootstrap Icons <i> tag wrapper
• Toggle - Bootstrap 5 switch/toggle component
• Selectizer - Select with search functionality
• MainPageMenu - Large icon navigation menu
• LangSelect - Language selector dropdown
• LangLinks - Language selector navigation links
• LoginForm - Ready-made Bootstrap 5 login form
• PasswordInputShowHide - Password field with show/hide toggle button

Bootstrap Icons (BsIcon)

Renders a Bootstrap Icons <i class="bi bi-{name}"> tag. Drop-in for the removed FaIcon class.

// Pass the icon name (with or without the bi- prefix)
new \Ease\TWB5\Widgets\BsIcon('house');
new \Ease\TWB5\Widgets\BsIcon('bi-gear');

// With extra attributes
new \Ease\TWB5\Widgets\BsIcon('person-circle', ['aria-hidden' => 'true']);

Requires Bootstrap Icons CSS to be loaded in the page.

Login Form (LoginForm)

A Bootstrap 5 form with username and password fields ready to submit.

// Empty form
$form = new \Ease\TWB5\Widgets\LoginForm();

// Pre-filled username
$form = new \Ease\TWB5\Widgets\LoginForm('admin');

// Custom action
$form = new \Ease\TWB5\Widgets\LoginForm(null, null, ['action' => 'login.php']);

Password Input with Show/Hide (PasswordInputShowHide)

Password field wrapped in an input-group with a Bootstrap Icons eye toggle button.

$passwordField = new \Ease\TWB5\Widgets\PasswordInputShowHide('password', _('Password'));

Requires Bootstrap Icons CSS and jQuery.

Bootstrap5 Toggle

Ease support for https://github.com/palcarazm/bootstrap5-toggle

new Ease\TWB5\Widgets\Toggle('swname', true, 1,['onText' => 'YES', 'offText' => 'NO']);

Language Selector Dropdown (LangSelect)

Bootstrap 5 dropdown-based language selector that integrates with Ease\Locale for internationalization.

// Basic usage
$langSelector = new \Ease\TWB5\Widgets\LangSelect();

// With custom URL parameter name (default is 'locale')
$langSelector = new \Ease\TWB5\Widgets\LangSelect('lang');

// With additional properties
$langSelector = new \Ease\TWB5\Widgets\LangSelect('locale', ['class' => 'dropdown my-custom-class']);

Features:

• Automatically detects available languages from Ease\Locale
• Shows current language with a globe icon (Bootstrap Icons)
• Preserves existing URL parameters when switching languages
• Fully styled with Bootstrap 5 dropdown component
• Active language is highlighted in the dropdown menu
• Uses Bootstrap 5's data-bs-toggle attributes

Language Navigation Links (LangLinks)

Bootstrap 5 navigation-style language selector that displays languages as pills or tabs.

// Basic usage (nav pills style)
$langLinks = new \Ease\TWB5\Widgets\LangLinks();

// As navigation tabs
$langLinks = new \Ease\TWB5\Widgets\LangLinks(['class' => 'nav nav-tabs']);

// New Bootstrap 5 underline style
$langLinks = new \Ease\TWB5\Widgets\LangLinks(['class' => 'nav nav-underline']);

// Inline style
$langLinks = new \Ease\TWB5\Widgets\LangLinks(['class' => 'nav nav-pills d-inline-flex']);

// Vertical layout
$langLinks = new \Ease\TWB5\Widgets\LangLinks(['class' => 'nav flex-column']);

Features:

• Displays all available languages as navigation links
• Supports all Bootstrap 5 nav styles (pills, tabs, underline)
• Current language is marked as active
• Can be used inline or as block element
• Preserves URL parameters when switching languages

Installation

Composer:

composer require vitexsoftware/ease-twbootstrap5-widgets

Older versions and its requirements https://packagist.org/packages/vitexsoftware/

For Debian, Ubuntu & friends please use repo:

sudo apt install php-vitexsoftware-ease-bootstrap5-widgets

In this case please add this to your app composer.json:

"require": {
    "ease-bricks": "*"
},
"repositories": [
    {
        "type": "path",
        "url": "/usr/share/php/EaseCore",
        "options": {
            "symlink": true
        }
    },
    {
        "type": "path",
        "url": "/usr/share/php/EaseTWB5",
        "options": {
            "symlink": true
        }
    },
    {
        "type": "path",
        "url": "/usr/share/php/EaseTWB5Widgets",
        "options": {
            "symlink": true
        }
    }
]

Links

Homepage: https://www.vitexsoftware.cz/ease.php

GitHub: https://github.com/VitexSoftware/php-ease-bootstrap5-widgets

PhpDocumentor: https://www.vitexsoftware.cz/php-ease-bootstrap5-widgets/