PHPackages marshmallow/nova-sortable - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Admin Panels](/categories/admin) 4. / 5. marshmallow/nova-sortable ActiveLibrary[Admin Panels](/categories/admin) marshmallow/nova-sortable ========================= This Laravel Nova package allows you to reorder models in a Nova resource's index view using drag & drop. 4.0.1(1y ago)07.1k—4.8%[2 PRs](https://github.com/marshmallow-packages/nova-sortable/pulls)MITVuePHP >=8.1CI passing Since Nov 1Pushed 1mo ago2 watchersCompare [ Source](https://github.com/marshmallow-packages/nova-sortable)[ Packagist](https://packagist.org/packages/marshmallow/nova-sortable)[ GitHub Sponsors](https://github.com/marshmallow)[ RSS](/packages/marshmallow-nova-sortable/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (3)Dependencies (4)Versions (77)Used By (0) Nova Sortable ============= [](#nova-sortable) Important This package was originally forked from [outl1ne/nova-sortable](https://github.com/outl1ne/nova-sortable). Since we were making many opinionated changes and the owner archived the repository, we decided to continue development in our own version rather than submitting pull requests that might not benefit all users of the original package. You're welcome to use this package, we're actively maintaining it. If you encounter any issues, please don't hesitate to reach out. [![Latest Version on Packagist](https://camo.githubusercontent.com/214b5bda25d03a6ae8c1721a2b13c8950aae59beb03198f7dbe6d61b832c2aa9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d617273686d616c6c6f772f6e6f76612d736f727461626c652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/marshmallow/nova-sortable)[![Total Downloads](https://camo.githubusercontent.com/473bb5cbd1f2efe393a6097ed85b87ace912f1a51aaf47d25226ecdb7a21a17a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d617273686d616c6c6f772f6e6f76612d736f727461626c652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/marshmallow/nova-sortable) This [Laravel Nova](https://nova.laravel.com) package allows you to reorder models in a Nova resource's index view using drag & drop. Uses Spatie's [eloquent-sortable](https://github.com/spatie/eloquent-sortable) under the hood. Requirements ------------ [](#requirements) - `php: >=8.0` - `laravel/nova: ^4.0|^5.0` Features -------- [](#features) - Drag & drop reorder (on either Index view or HasMany view) - BelongsTo/MorphsTo reorder support w/ pivot tables - Move to start and end arrows (makes item first/last) - Everything from [eloquent-sortable](https://github.com/spatie/eloquent-sortable) - Localization Screenshots ----------- [](#screenshots) [![Sortable](./docs/sortable.gif)](./docs/sortable.gif) Installation ------------ [](#installation) Install the package in a Laravel Nova project via Composer: ``` # Install package composer require marshmallow/nova-sortable ``` Usage ----- [](#usage) ### Create migration [](#create-migration) Add an order field to the model using Laravel migrations: ``` // Add order column to the model Schema::table('some_model', function (Blueprint $table) { $table->integer('sort_order'); }); // Set default sort order (just copy ID to sort order) DB::statement('UPDATE some_model SET sort_order = id'); ``` ### Implement eloquent-sortable [](#implement-eloquent-sortable) Implement the Spatie's `eloquent-sortable` interface and apply the trait: ``` use Spatie\EloquentSortable\Sortable; use Spatie\EloquentSortable\SortableTrait; class SomeModel extends Eloquent implements Sortable { use SortableTrait; public $sortable = [ 'order_column_name' => 'sort_order', 'sort_when_creating' => true, ]; ... } ``` When the model does not have a sortable configuration, the default eloquent-sortable configuration will be used. ### Apply HasSortableRows to Nova resource [](#apply-hassortablerows-to-nova-resource) Apply `HasSortableRows` trait from this package on the Resource: ``` use Marshmallow\NovaSortable\Traits\HasSortableRows; class MyResource extends Resource { use HasSortableRows; ... } ``` NB! This overrides the `indexQuery()` method. ### Disallowing sorting on a per-request/resource basis [](#disallowing-sorting-on-a-per-requestresource-basis) You can disable sorting on a per-request or per-resource basis by overriding the `canSort()` on the Resource method like so: ``` public static function canSort(NovaRequest $request, $resource) { // Do whatever here, ie: // return user()->isAdmin(); // return $resource->id !== 5; return true; } ``` NB! This requires you to disable caching (see below). ### Disabling caching [](#disabling-caching) If you want to disable caching due to using `canSort` or running tests, you can set `sortableCacheEnabled` to false on the resource that has the `HasSortableRows` trait. See the example below: ``` class Artist extends Resource { use HasSortableRows; public static $sortableCacheEnabled = false; } ``` Or if you want to temporarily disable sortability cache (for tests), you can call `Resource::disableSortabilityCache()` on the resource. Custom sortable options ----------------------- [](#custom-sortable-options) ### Nova sorting order [](#nova-sorting-order) To sort your resource in a different order in Nova, you can set the `nova_order_by` flag to `DESC` (`ASC` by default) in the `$sortable` array. ``` class SomeModel extends Eloquent implements Sortable { use SortableTrait; public $sortable = [ 'order_column_name' => 'sort_order', 'sort_when_creating' => true, 'nova_order_by' => 'DESC', ]; ... } ``` ### Ignoring policies [](#ignoring-policies) If you have a resource that has `authorizedToUpdate` false, but you want the user to still be able to sort it, you can use the `ignore_policies` flag like so: ``` class SomeModel extends Eloquent implements Sortable { use SortableTrait; public $sortable = [ 'order_column_name' => 'sort_order', 'sort_when_creating' => true, 'ignore_policies' => true, ]; ... } ``` Sorting on HasMany relationship ------------------------------- [](#sorting-on-hasmany-relationship) **NB!** The resource can only be sorted on **either** the Index view **or** the HasMany list view, but not both! Sorting on HasMany is simple. Add `'sort_on_has_many' => true` to the `$sortable` array on the model. Like so: ``` public $sortable = [ 'order_column_name' => 'sort_order', 'sort_when_creating' => true, 'sort_on_has_many' => true, ]; ``` The sort on has many configuration can be apply in a per model basis or it can be added in the eloquent-sortable configuration for all the models. ``` return [ // Spatie sortable configuration /** * Add sort on has many in all the models. **/ 'sort_on_has_many' => true, ]; ``` Sorting on ManyToMany relationships ----------------------------------- [](#sorting-on-manytomany-relationships) Sorting on BelongsToMany and MorphToMany relationships is available, but requires special steps. See the documentation here: [Sorting ManyToMany relationships (w/ pivot table)](docs/sorting/many-to-many.md). Localization ------------ [](#localization) The translation file(s) can be published by using the following publish command: ``` php artisan vendor:publish --provider="Marshmallow\NovaSortable\ToolServiceProvider" --tag="translations" ``` You can add your translations to `resources/lang/vendor/nova-sortable/` by creating a new translations file with the locale name (ie `et.json`) and copying the JSON from the existing `en.json`. Other usecases -------------- [](#other-usecases) ### Using indexQuery [](#using-indexquery) This package overwrites the `indexQuery` of the Resource and if you still want to use it, you can do it as follows: ``` use HasSortableRows { indexQuery as indexSortableQuery; } public static function indexQuery(NovaRequest $request, $query) { // Do whatever with the query // ie $query->withCount(['children', 'descendants', 'modules']); return parent::indexQuery($request, static::indexSortableQuery($request, $query)); } ``` Credits ------- [](#credits) - [Tarvo Reinpalu](https://github.com/Tarpsvo) License ------- [](#license) Nova Sortable is open-sourced software licensed under the [MIT license](LICENSE.md). ### Health Score 50 — FairBetter than 96% of packages Maintenance69 Regular maintenance activity Popularity23 Limited adoption so far Community11 Small or concentrated contributor base Maturity81 Battle-tested with a long release history Bus Factor1 Top contributor holds 52.5% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~31 days Recently: every ~84 days Total 73 Last Release 159d ago Major Versions 1.6.2 → 2.0.02020-12-04 2.4.4 → v3.0.02022-05-12 v3.7.0 → 4.0.02025-01-17 PHP version history (5 changes)1.0.0PHP >=7.1.0 2.0.0PHP >=7.3.0 v3.0.0PHP ^8.0 3.0.1PHP >=8.0 4.0.0PHP >=8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/be33d2624e24c516e73892b0929447cc762f3622c024ab8d0d2a59042e5d2c7f?d=identicon)[marshmallow](/maintainers/marshmallow) --- Top Contributors [![stefvanesch](https://avatars.githubusercontent.com/u/46725619?v=4)](https://github.com/stefvanesch "stefvanesch (21 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (18 commits)")[![LTKort](https://avatars.githubusercontent.com/u/2412670?v=4)](https://github.com/LTKort "LTKort (1 commits)") --- Tags laravelnovaoptimistdigitaloutl1neeloquent-sortable ### Embed Badge ![Health badge](/badges/marshmallow-nova-sortable/health.svg) ``` [![Health](https://phpackages.com/badges/marshmallow-nova-sortable/health.svg)](https://phpackages.com/packages/marshmallow-nova-sortable) ``` ### Alternatives [optimistdigital/nova-sortable This Laravel Nova package allows you to reorder models in a Nova resource's index view using drag & drop. 2872.1M6](/packages/optimistdigital-nova-sortable)[outl1ne/nova-sortable This Laravel Nova package allows you to reorder models in a Nova resource's index view using drag & drop. 2861.8M9](/packages/outl1ne-nova-sortable)[optimistdigital/nova-settings A Laravel Nova tool for editing custom settings using native Nova fields. 297874.5k3](/packages/optimistdigital-nova-settings)[outl1ne/nova-translations-loader This Laravel Nova package helps developers load translations into their packages. 395.1M42](/packages/outl1ne-nova-translations-loader)[optimistdigital/nova-translations-loader This Laravel Nova package helps developers load translations into their packages. 393.7M10](/packages/optimistdigital-nova-translations-loader)[optimistdigital/nova-page-manager Page(s) and region(s) manager for Laravel Nova. 17988.5k](/packages/optimistdigital-nova-page-manager) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)