Requirements
Advanced Tables requiresPHP 8.1+, MySQL 5.7.8+ or Postgres, Filament 3.2.133+, and Laravel 10+.
Advanced Tables v1 is fully compatible with Filament v2. After purchasing a license here, please refer to the Filter Sets v1 documentation for installation and usage instructions.
New Installation
Purchasing a license
Advanced Tables has partnered with Privato to handle payment, licensing, and distribution. After purchase, you will receive an email from Privato with your license key.Installing with Composer
To install Advanced Tables you’ll need to add the package to yourcomposer.json file:
Setting up Advanced Tables in Filament Panels (including Relation Managers, Table Widgets, and Panel Pages)
If using Filament’s standalone Table Builder, please refer to the Filament Table Builder setup instructions-
Publish and run the migrations
Important: If you are using a User class other than Laravel’s default
User::classor a user’s table other than Laravel’s defaultusersyou should update these configurations before migrating. -
Publish the language files
Optionally, you may publish the language files:
-
Add Advanced Tables to your Filament Panel
Add Advanced Tables to a panel by instantiating the plugin class and passing it to the
plugin()method of the configuration: -
Add the
HasViewstrait to yourUser::class -
Integrate Filter Set’s Tailwind and css files
Filament v3 recommends developers create a custom theme to better support a plugin’s additional Tailwind classes. After you have created your custom theme, add Advanced Tables’ views to your new theme’s
tailwind.config.jsfile usually located inresources/css/filament/admin/tailwind.config.js:Next, import Advanced Tables’s custom stylesheet into your theme’s css file: -
Compile
Next, compile your theme:
Finally, run the Filament upgrade command:
- Setting up tenancy If you are installing Advanced Tables into a multi-tenancy application, please refer to the separate instructions to set up multi-tenancy.
Setting up Advanced Tables in Filament Table Builder
If using Filament Panels, please refer to the Filament Panels setup instructions.
Important: Beyond the normal requirements, using Advanced Tables with Filament Table Builder requires you have some type of user authentication system such as Laravel Breeze since each view belongs to the currently authenticated user.
-
Publish the config files
While optional, it is recommended you publish the config file to be able to fully customize Advanced Table. However, If you are using a User class other than Laravel’s default
User::classor a user’s table other than Laravel’s defaultusersyou should publish the config file and update these configurations before migrating. -
Publish the language files
Optionally, publish the language files:
-
Publish and run the migrations
-
Add the
HasViewstrait to yourUser::class -
Integrate Advanced Tables’s custom css file
Add the following line to the top of your
app.cssfile: -
Compile
Next, compile your theme:
Finally, run the Filament upgrade command:
- Setting up tenancy If you are installing Advanced Tables into a multi-tenancy application, please refer to the separate instructions to set up multi-tenancy.
Deploying
When deploying, it is not advised to store your `auth.json“ file inside your project’s version control repository. To store your credentials on your deployment server you may create a Composer auth.json file in your project directory using the following command:Important: Don’t forget to append a colon (:) and your fingerprint domain to your password.You can see your credentials in your Anystack account:
Anystack > Transactions > View details next to Filament Filter Sets.
Tip: Make sure theIf you are using Laravel Forge, you don’t need to create theauth.jsonfile is in.gitignoreto avoid leaking credentials into your git history.
auth.json file manually. Instead, you can set the credentials on the Composer Package Authentication screen of your server.
Fixing deployment errors
-
The most common mistake when deploying, is not adding the colon (:) followed by the domain you registered.
license_key:domain. Please review the instructions above. -
If you have set up everything correctly and are getting the error:
../advanced-tables-for-filament-3.7.29.zip' URL required authentication (HTTP 401). You must be using the interactive console to authenticateerror, you may need to ssh into your server and clear your composer global cache withcomposer clear-cache