Skip to main content
Thank you for purchasing Advanced Tables! Below you’ll find extensive documentation on installing and using this plugin. Of course, if you have any questions, find a bug, need support, or have a feature request, please don’t hesitate to reach out to me at advancedtables@gmail.com.

Requirements

Advanced Tables requires PHP 8.2+, MySQL 5.7.8+ or Postgres, Filament 5.0.0+, and Laravel 11.28+.

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 your composer.json file:
composer config repositories.archilex composer https://advancedtables.privato.pub/composer
or
{
    "repositories": [
        {
            "type": "composer",
            "url": "https://advancedtables.privato.pub/composer"
        }
    ],
}
Then configure authentication:
composer config --auth http-basic.advancedtables.privato.pub "[license-email]" "[license-key]"
Finally, install the package
composer require archilex/filament-filter-sets

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
  1. Publish and run the migrations
    Important: If you are using a User class other than Laravel’s default User::class or a user’s table other than Laravel’s default users you should update these configurations before migrating.
    php artisan vendor:publish --tag="advanced-tables-migrations"
    php artisan migrate
    
  2. Publish the language files Optionally, you may publish the language files:
    php artisan vendor:publish --tag="advanced-tables-translations"
    
  3. 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:
    use Archilex\AdvancedTables\Plugin\AdvancedTablesPlugin;
    
    public function panel(Panel $panel): Panel
    {
        return $panel
            ->plugins([
                AdvancedTablesPlugin::make()
            ])
    }
    
  4. Add the HasViews trait to your User::class
    use Archilex\AdvancedTables\Concerns\HasViews;
    
    class User
    {
        use HasViews;
    }
    
  5. Integrate Advanced Table’s Tailwind and css files
    IMPORTANT: Filament v5 requires you create a custom theme to support a plugin’s additional Tailwind classes. Be sure to follow those instructions before continuing with this step.
    After you have created your custom theme, add Advanced Tables’ views to your new theme’s theme.css file usually located in resources/css/filament/admin/theme.css:
    @import '../../../../vendor/filament/filament/resources/css/theme.css';
    @import '../../../../vendor/archilex/filament-filter-sets/resources/css/plugin.css'; // Add
    
    @source '../../../../app/Filament';
    @source '../../../../resources/views/filament';
    @source '../../../../vendor/archilex/filament-filter-sets'; // Add
    
  6. Compile Next, compile your theme:
    npm run build
    
    Finally, run the Filament upgrade command:
    php artisan filament:upgrade
    
  7. 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.
After you’ve successfully installed Advanced Tables, you may review the Getting Started guide to learn how to add Advanced Tables to your resources, relation managers, pages, and/or table widgets.

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.
  1. 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::class or a user’s table other than Laravel’s default users you should publish the config file and update these configurations before migrating.
    php artisan vendor:publish --tag="advanced-tables-config"
    
  2. Publish the language files Optionally, publish the language files:
    php artisan vendor:publish --tag="advanced-tables-translations"
    
  3. Publish and run the migrations
    php artisan vendor:publish --tag="advanced-tables-migrations"
    php artisan migrate
    
  4. Add the HasViews trait to your User::class
    use Archilex\AdvancedTables\Concerns\HasViews;
    
    class User
    {
        use HasViews;
    }
    
  5. Integrate Advanced Tables’s custom css file Add the following line to the top of your app.css file:
    @import '../../vendor/archilex/filament-filter-sets/resources/css/plugin.css'; // Add
    
    @source '../../vendor/archilex/filament-filter-sets'; // Add
    
  6. Compile Next, compile your theme:
    npm run build
    
    Finally, run the Filament upgrade command:
    php artisan filament:upgrade
    
  7. 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.
After you’ve successfully installed Advanced Tables, you may review the Getting Started guide to learn how to add Advanced Tables to your tables.

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:
composer config http-basic.advancedtables.privato.pub "[license-email]" "[license-key]"
Tip: Make sure the auth.json file is in .gitignore to avoid leaking credentials into your git history.
If you are using Laravel Forge, you don’t need to create the auth.json file manually. Instead, you can set the credentials on the Composer Package Authentication screen of your server.

Fixing deployment errors

  1. 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.
  2. 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 authenticate error, you may need to ssh into your server and clear your composer global cache with composer clear-cache