All pages

reference

Troubleshooting and support

Fixes for the problems that come up most, and where to reach the author.

Installation

The package can't be found.

bash
composer require asmit/advanced-kanban
  • Check that your license is active for this domain
  • Check the repository entry in composer.json
  • Check the package name

Assets don't load.

bash
php artisan filament:assets
  • Clear the application cache: php artisan cache:clear
  • Clear the view cache: php artisan view:clear

Configuration

The page isn't in the navigation.

  • The page must extend KanbanPage
  • Check the navigation properties on the page
  • Check that the page is registered on the panel

Records don't show up in a column.

  • The column key must match the value stored in the status field
  • Check that the model has the status field you passed to statusField()

Cards jump back after a drop.

  • The target column may not be in the source column's allowedTransitions()
  • The card may be locked by lockCardUsing()

Card order isn't kept.

  • orderField() must point at an existing sortable column
  • Rows with a null position sort wherever the database puts nulls — backfill them once

Performance

Loading is slow with many records.

  • Set recordsPerColumn() so columns load in pages
  • Index the status column, the order column, and the fields you search
  • Eager load relations with modifyRecordQueryUsing()
  • Narrow the base query with modifyQueryUsing()

Error messages

"Column not found" — a column key doesn't match any status value in the database, or a required column is missing from columns().

"Model not found" — the model class isn't imported or doesn't exist.

Practices worth keeping

  • Validate input in custom actions, and authorise them the way you authorise the rest of the panel
  • Keep move side effects in the move hooks, not in model events that also fire elsewhere
  • Index every column the board sorts, filters, or searches on
  • Keep custom card components thin — query in the page, render in the view

Support

Advanced Kanban is a premium plugin and needs a valid license for production use.