Download the PHP package it-delmax/filament-treeview without Composer
On this page you can find all versions of the php package it-delmax/filament-treeview. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package filament-treeview
Filament Tree View
A powerful drag-and-drop tree view for Filament resources. Display and manage hierarchical data with the same elegant developer experience you expect from Filament.
Why This Package?
We created Filament Tree View because we couldn't find a hierarchical data solution that truly embraced Filament's philosophy and architecture. Most tree packages feel like external additions rather than native Filament components.
Our Goal: Make hierarchical data management feel as natural as using Filament's Table component.
Built on Proven Technology
Rather than reinventing the wheel, we leverage battle-tested libraries:
- Laravel Adjacency List - Mature, proven package for recursive relationships with thousands of production deployments
- Pragmatic Drag & Drop - Atlassian's accessible, performant drag-and-drop library used in Jira, Trello, and Confluence
- Filament's Core Components - Built with the same patterns, conventions, and architecture as native Filament resources
This foundation gives you reliability, performance, and accessibility out of the box.
Features
- 🌳 Drag-and-Drop Reordering - Intuitive tree manipulation with visual feedback
- 📦 Drop-in Replacement - Familiar API if you've used Filament Tables
- 🎯 Depth Control - Limit tree nesting to prevent overly complex hierarchies
- 💾 Save Modes - Choose between auto-save or batch save with manual confirmation
- 🎨 Custom Fields - Display any data in your tree nodes with TextField and IconField
- 🔧 Actions Support - Full support for Filament actions (edit, delete, custom actions)
- 🌗 Dark Mode - Seamless integration with Filament's theming system
- ♿ Accessible - Keyboard navigation and screen reader support built-in
- 🔒 Safe Operations - Prevents circular references and invalid moves
Requirements
- PHP 8.2 or higher
- Laravel 11 or 12
- Filament 4.0 or higher
Installation
Install the package via Composer:
Publish the package assets:
That's it! The plugin registers its CSS and JavaScript assets with Filament automatically. Everything is now configured and ready to use.
Quick Start
1. Prepare Your Database
Create a migration with the required tree structure columns:
2. Add Trait to Your Model
Add the HasTreeStructure trait to enable tree functionality:
The trait provides:
- Recursive parent/child relationships
- Automatic cascade delete for descendants
- Tree query helpers (roots, leaves, depth calculations)
3. Add Tree Configuration to Your Resource
Add a tree() method to your resource alongside form() and table():
4. Create a Tree Page
Create a simple page that extends TreePage:
That's it! You now have a fully functional drag-and-drop tree view with manual save mode.
Advanced Configuration
Need more control? The tree view offers powerful customization options. All configuration is optional - only add what you need.
Understanding Defaults
The tree uses sensible defaults for most settings:
- Fields: Required - You must configure which fields to display
- Actions: Optional - No actions shown unless you add them
- Collapse: Enabled by default - individual toggles + header Expand All/Collapse All buttons
- Save Mode: Manual save with Save/Cancel buttons (safer)
- Depth: 10 levels by default
Quick Links:
- Tree Behavior - Depth limits, collapse, auto-save
- Custom Fields - Display custom data in nodes
- Actions - Add edit, delete, and custom actions
- Model Configuration - Customize column names
- Empty State - Customize the "no records" view
- Save Behavior - Manual vs auto-save
- Query Customization - Filter and order records
Tree Behavior
Control how your tree displays and behaves:
Available Options:
| Method | Default | Description |
|---|---|---|
maxDepth(int\|null) |
10 levels | Restrict maximum tree depth (pass null for unlimited) |
collapsible(bool) |
Enabled | Individual toggles + header Expand All/Collapse All buttons |
collapsed() |
Expanded | Start with nodes collapsed instead of expanded |
autoSave() |
Disabled | Save changes immediately on drag-and-drop |
Common Patterns:
Custom Fields
Fields are required - you must configure which fields to display in your tree nodes.
Use the Field API to define what data appears in each tree node:
TextField Options
IconField Options
Actions
Add actions to tree nodes just like Filament Tables:
Model Configuration
The HasTreeStructure trait uses sensible defaults, but you can customize column names for legacy databases:
Working with Existing Databases
Custom Parent Field Name
If your legacy database uses a different column name for the parent relationship (instead of parent_id), override the getParentKeyName() method:
Common legacy field names:
parent_category_id- Category-specific parent fieldcategory_parent_id- Alternative naming conventionparent- Simplified field nameparent_node_id- Generic tree structure naming
No migration needed! The tree view will automatically use your custom field name for all queries and updates.
Custom Root Parent Value
If your existing database uses -1, 0, or another value to represent root nodes instead of NULL, override the getParentKeyDefaultValue() method:
Combining Both Customizations
You can override both methods for complete legacy database support:
No database migrations needed! The package handles all queries and updates automatically.
Customizing Empty State
Save Behavior
By default, the tree uses manual save mode - changes require clicking "Save Changes":
Enable auto-save to save immediately on every drag-and-drop:
Why manual save is the default:
- ✅ Review all changes before committing
- ✅ Cancel to discard unwanted changes
- ✅ Safer for production environments
- ✅ Better for complex hierarchies
When to use auto-save:
- Simple admin-only trees
- Single-user scenarios
- Immediate feedback preferred
Query Customization
Modify the base query for your tree:
Common Patterns
Real-world examples to help you get started quickly:
Building a Navigation Menu
Product Categories with Status
Department Hierarchy
Troubleshooting
Styling Issues or Missing Styles
If the tree view appears unstyled or layouts look broken:
-
Republish assets:
-
Clear browser cache - Hard refresh your browser (Cmd+Shift+R on Mac, Ctrl+Shift+R on Windows/Linux)
- Clear application caches:
JavaScript Not Loading
If drag-and-drop doesn't work after installation:
Drag Restrictions
If you can't drag items to certain positions:
- Depth limit reached - Check your
maxDepth()setting - Circular reference - Can't move a parent into its own descendant
- Custom canDrop logic - Review any custom drop validation
Performance with Large Trees
For trees with hundreds of nodes:
- Consider pagination or filtering at the root level
- Use
->collapsed()to start with nodes collapsed - Eager load relationships in
modifyQueryUsing()
ComponentNotFoundException After Creating TreePage
If you encounter Unable to find component: [app.filament.resources.blog.categories.pages.tree-categories] when clicking actions:
Cause: Laravel and Livewire cache component registries. New TreePage classes aren't immediately discoverable.
Fix:
This clears Composer's autoloader, Livewire's component cache, and all Laravel caches. The error occurs after creating new TreePage classes or when updating the plugin in development environments.
Testing
Run the test suite:
Run Pint for code style:
Contributing
We welcome contributions! Please see CONTRIBUTING.md for details.
Security
If you discover a security vulnerability, please email [email protected]. All security vulnerabilities will be promptly addressed.
Credits
Built with these excellent open-source libraries:
- Laravel Adjacency List by Jonas Staudenmeir - Battle-tested recursive tree queries with thousands of production deployments
- Pragmatic Drag & Drop by Atlassian - Accessible, performant drag-and-drop used in Jira, Trello, and Confluence
License
The MIT License (MIT). Please see License File for more information.
Built with ❤️ by Openplain
