Warp Tree changelog
Update with composer update qalainau/filament-warp-tree, then run php artisan filament:assets.
1.1.0 Nov 22, 2026
Added
$defaultOpenLevelfor the tree page:TreePage(andTreeWidget,TreeRelationManager) can open the branches down to a level when it is shown, with the same name and meaning asdefaultOpenLevel()ofSelectTree,TreeNavigationand the tree grid. The default is0— only the roots, as before.
1.0.4 Nov 19, 2026
Fixed
- Console error
warpTree… is not defined: on pages where Livewire re-renders a Tree field inside another Alpine component, the browser console could showwarpTreeSelectTree is not defined(and the same for the other Tree components) before the component's script had arrived. Empty components are now registered up front, and the real ones replace them as soon as they load. No visible change.
1.0.3 Nov 17, 2026
Fixed
- Tree grid: with a row opened, the count below the table counted the rows opened under it as well (“Showing 1 to 5 of 3 results”, or “11 to 25 of 30” on the second page). It now counts the top level, as the total already did (“Showing 1 to 3 of 3 results”). Display only; on standard tables and on Warp Tables (
->warp()).
1.0.2 Nov 17, 2026
Changed
- README: the tree grid on a Warp Table (
->warp()) needs Warp Table 1.5.0 or later, which shows the first column with its indent and arrow. The note that PHPStan does not know->warpTree()was out of date since 1.0.1 (the plugin ships a PHPStan extension) and now links to “Static analysis”.
1.0.1 Nov 16, 2026
Fixed
- Static analysis: Larastan no longer reports “Call to an undefined method” for
->warpTree(),->warpTreeSum(). The plugin shipsextension.neon, a PHPStan extension that reads Filament's macros (loaded automatically withphpstan/extension-installer; otherwise add it toincludes). See “Static analysis” in the README. - Static analysis: the setting methods of the plugin class are declared as returning the plugin, so
$panel->plugin(…::make()->…())no longer fails with “Panel::plugin() expects Filament\Contracts\Plugin”.
1.0.0 Nov 15, 2026
Added
- Choosing:
SelectTreereads only the opened branches (fast on trees of 50,000 items), searches with the path (inside bos finds Sales › East › Boston › Inside sales), shows the chosen item as a path, and checks the value on the server. Lowest level only, a parent with everything under it, disabled and hidden items, extra items such as No department, child counts, levels opened at first, lists that stay open, adding an item from the field, nested sets, other key columns, soft-deleted items. Icons on items (icon(),leafIcon(), or an icon per record), each SVG sent once per request. - Switching:
Compat\SelectTreetakes the methods and defaults of codewithdennis/filament-select-tree, so changing the import is enough. - Showing:
TreePathColumn,TreePathEntryand theTreeNodevalidation rule. - Filtering:
TreeFilterfilters a table by a branch and everything under it, and shows the path again after the page is reloaded. - Tree grid:
->warpTree()on a table andHasTreeGridon its page (list page, relation manager or table widget) show the rows of the table as a tree. The first column gets the indent and an arrow; the rows under a row are read when it is opened; pagination counts the top level and sorting sorts siblings.->warpTreeSum()shows on a parent the total of itself and everything under it. Search and filters show the matching rows with their parents (faded) and open the branches down to them.TreeIndentActionandTreeOutdentActionchange a row's parent, checked on the server (the table's query,canEdit()or the policy'supdate, no loops,maxDepth()). Needs only aparent_idcolumn. - Querying:
HasTree,descendantKeys(),ancestorKeys(),withinSubtreeOf()andwhereInSubtree(). - Who sees what:
visibleSubtree()on the plugin,ScopedToVisibleSubtreeon resources andonlyVisibleSubtree()on fields and filters. - Editing:
TreePageto drag (or use Alt + arrow keys), rename, add, move, merge and delete items, with the records filed under them (TreeRecords) counted and moved along, stale moves refused, a history of changes, and icons on items (getTreeIcon()). - Works in reorderable repeaters, builders, tabs, wizards, modals and modals inside modals, relation managers, with
live()and$set, and in SPA mode. Filament tenancy, ten languages. - A tree next to a table:
HasTreeNavigationputs the tree on the left of a resource's list page. Clicking a branch filters the table to that branch and everything under it (kept in the URL), each branch shows how many rows it holds, and rows are moved by dragging them onto a branch — several at once when they are ticked.MoveToBranchBulkActiondoes the same without dragging. Moves checkcanEdit()for every row and read rows and branches again through the resource, so tenancy andvisibleSubtree()hold. TreeBuilder: a form field to edit a small tree inside the form of its record — add, edit and delete items in modals, drag or use Alt + arrow keys to reorder and nest. Saved as a nested array (a JSON column) or as rows of aHasManyrelationship. The method names and the stored shape match saade/filament-adjacency-list.- Several items at once: tick rows of the tree (Shift for a range) and drag one of them, or press Move to…, to move them together — all or nothing, with the same checks as a single move (
moveTreeNodes()). - Open all / close all buttons beside the search box. Opening stops after 500 branches on very large trees.
- CSV:
protected static bool $hasCsvActionsadds Export CSV and Import CSV. The import updates names, parents and order by id, or adds a tree from another system; every row is checked (visible items only, permissions, loops, depth limit) before anything is written. CheckboxTree: the tree inside the form with a checkbox on every item, for permissions and visibility. A parent has three states (checked, partly checked, empty); checking a parent checks everything under it, also in branches that were never opened.cascade(false)checks items one by one.- Rows of the tree: your own buttons on each row (
getTreeNodeActions(): Filament actions that get the row's item as$record), a badge (getTreeBadge(),getTreeBadgeColor()), a description under the name (getTreeDescription()), and the whole form of an item in a modal (protected static bool $editsInModal). Rows are read again after an action. - A depth limit:
protected static ?int $maxDepthon the tree page, widget and relation manager. Drops inside an item at the limit are not offered, and the server refuses every move, merge and new item that would go deeper — counting the levels under the moved item. TreeWidget: the tree page as a widget, with a resource (query, form, labels, permissions) or just a model (policy), editable or read-only.TreeRelationManager: edit the tree that belongs to a record (menu items, a bill of materials) on that record's edit page. Only the record's own items can be seen, moved or chosen as a target.InteractsWithTree: the trait behind the three, for a Livewire component of your own.- Restricting pages per role:
canAccessUsing()andcanWriteUsing()onFilamentWarpTreePlugindecide, per page, who may open aTreePageand who may only look at it. Read-only people see no buttons that change the tree, can't drag rows, and get a 403 when callingmoveTreeNode()ormoveTreeNodes()directly; the hidden actions don't open.TreePage::canWrite()can be overridden to make a page read only.