Download the PHP package akaunting/laravel-sortable without Composer
On this page you can find all versions of the php package akaunting/laravel-sortable. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package laravel-sortable
Sortable behavior package for Laravel
This package allows you to add sortable behavior to models
and views
. It ships with a trait where you can set the sortable fields and a blade directive to generate table headers automatically.
Getting Started
1. Install
Run the following command:
2. Publish
Publish configuration
3. Configure
You can change the column sorting settings of your app from config/sortable.php
file
Usage
All you have to do is use the Sortable
trait inside your model and define the $sortable
fields.
If you don't define the $sortable
array, the Scheme::hasColumn()
function is used which runs an extra database query.
Scope
The trait adds a sortable
scope to the model so you can use it just before paginate
:
You can set also default sorting field which will be applied when URL is empty.
Blade Directive
There is also a blade
directive for you to create sortable links in your views:
The first parameter is the column in database. The second one is displayed inside the anchor tag. The third one is an array()
, and it sets the default (GET) query string. The fourth one is also an array()
for additional anchor-tag attributes. You can use a custom URL as 'href' attribute in the fourth parameter, which will append the query string.
Only the first parameter is required.
Examples:
Icon Set
You can use any icon set you want. Just change the icons.wrapper
from the config file accordingly. By default, it uses Font Awesome.
Blade Component
Same as the directive, there is also a blade
component for you to create sortable links in your views:
Sorting Relationships
The package supports HasOne
and BelongsTo
relational sorting:
And you can use the relation in views:
Note: In case there is a self-referencing model (like comments, categories etc.); parent table will be aliased with
parent_
string.
Advanced Relation
You can also extend the relation sorting feature by creating a function with Sortable
suffix. There you're free to write your own queries and apply orderBy()
manually:
The usage in controller
and view
remains the same.
Aliasing
You can declare the $sortableAs
array in your model and use it to alias (bypass column exists check), and ignore prefixing with table:
In controller
In view
It's very useful when you want to sort results using withCount()
.
Changelog
Please see Releases for more information what has changed recently.
Contributing
Pull requests are more than welcome. You must follow the PSR coding standards.
Security
Please review our security policy on how to report security vulnerabilities.
Credits
- Denis Duliçi
- Martin Kiesel
- All Contributors
License
The MIT License (MIT). Please see LICENSE for more information.