README

Welcome to the VitexSoftware Ease HTML Widgets project! This repository contains a collection of reusable HTML widgets for PHP applications.

Table of Contents

• Introduction
• Installation
• Usage
• Contributing
• License

Introduction

VitexSoftware Ease HTML Widgets is a library designed to simplify the creation and management of HTML widgets in PHP applications. It provides a set of pre-built widgets that can be easily integrated into your projects.

Installation

To install the library, you can use Composer:

composer require vitexsoftware/ease-html-widgets

Usage

Here is a basic example of how to use one of the widgets:

SandClock

require '../vendor/autoload.php';

use \VitexSoftware\Ease\Html\Widgets\SandClock();

$widget = new SandClock();
echo $widget;

It gives you nice SandClock

OldTerminal

Locale Select

Simple chooser of availble locales

new \Ease\ui\LangSelect()

Live Age

Show live age based on unix timestamp

new \Ease\ui\LiveAge(new DateTime);

Browsing History

new BrowsingHistory();

Sticky note

new StickyNote();

Selectizer trait

Apply Selectize.js to InputBox or Select

class Selector extends \Ease\Html\SelectTag
{
    use \Ease\Html\Widgets\Selectizer;
}

$properties = [
    'valueField' => 'value',
    'labelField' => 'key',
    'searchField' => ['key', 'value']
];

$options = [
    ['key' => 'red', 'value' => 'Red'],
    ['key' => 'blue', 'value' => 'Blue'],
    ['key' => 'green', 'value' => 'Green'],
    ['key' => 'yellow', 'value' => 'Yellow'],
];

$s = new Selector('selector');
$s->selectize($properties, $options);

Contributing

We welcome contributions! Please read our contributing guidelines to get started.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Debian Packages

To install using Debian packages from repo.vitexsoftware.com, follow these steps:

1. Add the repository to your sources list:

wget -qO- https://repo.vitexsoftware.com/keyring.gpg | sudo tee /etc/apt/trusted.gpg.d/vitexsoftware.gpg
echo "deb [signed-by=/etc/apt/trusted.gpg.d/vitexsoftware.gpg]  https://repo.vitexsoftware.com  $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/vitexsoftware.list
sudo apt update

1. Update the package list:

sudo apt-get update

1. Install the package:

sudo apt-get install php-vitexsoftware-ease-html-widgets