bubooon/simple-tables

Simple TableView for Laravel

1.0.0 2019-09-16 12:30 UTC

Requires

• php: ^7.1.3
• laravel/framework: 5.*

MIT

• Siarhei

• grid
• laravel
• table
• datatable
• tableview

README

This is simple way to show data in tables for users.

Screenshot:

Features

• Show tables with data using Illuminate\Database\Eloquent\Builder
• Set custom value for column using Closure
• Pagination
• Change page size
• Sort by column
• Filter by column (text input, dropdown)
• Create your own filters
• Full search input (search value from text input in list of columns)

Installing

Add composer package

composer require bubooon/simple-tables

Register provider in config/app.php

Bubooon\SimpleTables\SimpleTableServiceProvider::class

Copy assets

php artisan vendor:publish --tag=simple-tables

Add js to app.js

...
require('./simpletables');
...

Add css to app.sass

...
@import 'simple-tables';

Compile

npm run dev

Add code in layout or page for register JQuery plugin for table.

{!! $simpletable ?? '' !!}

Markup of Simple Tables based on Twitter Bootstrap 4, but you need include these styles by yourself, if you need it.

Usage

Hello world

$provider = new BuilderDataProvider((new User)->newQuery());
$grid = new SimpleTable($provider,['id','email','created_at','updated_at']);
echo $grid->render();

Setting pagination, default sort and fields for which sorting is available

$provider = new BuilderDataProvider($query, [
    'pagination' => [
        'pageSize' => 25
    ],
    'fieldsList' => ['id', 'email', 'status', 'age', 'created_at'],
    'sort' => [
        'id' => 'DESC'
    ]
]);

Add filters for columns

$provider->filter('email', 'email', 'like'); // serach substring
$provider->filter('was_found', 'was_found'); // strict search
$provider->filter('transaction_id', 'transaction_id', 'is_null'); //0 - IS NULL, 1 - IS NOT NULL, null - nothing

Setting fields for full search

$fields = ['email', 'description', 'first_name', 'last_name'];
$provider->fullSearch($fields);

Add your custom filtering

if ($last_update = request('date_created')) {
    switch ($last_update) {
        case 1:
            $provider->whereRaw('str_to_date(result.response ->> "$**.LastUpdatedDate", \'["%d/%m/%Y %T"]\') > now() - INTERVAL 1 WEEK');
            break;
        case 2:
            $provider->whereRaw('str_to_date(result.response ->> "$**.LastUpdatedDate", \'["%d/%m/%Y %T"]\') > now() - INTERVAL 1 MONTH');
            break;
    }
}

Setting fields in table

$table = new SimpleTable($provider, [
    'id', //just show value with defautl sorts by this column
    [
        'attribute' => 'email',
        'sort' => false, //remove ability to sort by this column
        'filter' => true, //add input[type=text] filter for this column 
        'label' => 'User email', //set custom header of column,
        'style' => 'width:250px' //css style for column
    ],
    [
        'attribute' => 'status',
        'filter' => [ //add dropdown filter
            '' => '',
            1 => 'Available',
            0 => 'Not available'
        ],
        'value' => function($row){
            return $row->status ? 'available' : 'not available';
        }
    ]
], [
    'fullSearch' => true, //add full search field
    'pageSizes' => [10, 25, 50, 100], //set available sizes of page,
    'showFooter' => false //hide table footer
]);

Features planned

• ArrayDataProvider
• Online demo with examples
• Support of multiple tables on one page
• More customization

License

This project is licensed under the MIT License - see the LICENSE.md file for details