v2.4.0

Published: 2026-08-28 03:43 UTC

Commits

• feat: change version to v2.4.0 (da57ed3) by Restu Lomboe (2026-08-28)
• feat: advanced filter with session based (eb47f3d) by Restu Lomboe (2026-08-27)
• feat: make github action workflows for release (ff50109) by Restu Lomboe (2026-08-27)
• fix: fix bug search advanced filter with column date (b5caeab) by Restu Lomboe (2026-08-27)
• feat: make feature exclude column when export default and export custom (a4437f3) by Restu Lomboe (2026-08-27)
• feat: improvement query datatable (6d602cb) by Restu Lomboe (2026-08-27)

Detail

feat: change version to v2.4.0

• Hash: da57ed341f14050eda4ee1855c8232ed538e7a2a
• Author: Restu Lomboe [email protected]
• Date: 2026-08-28

feat: advanced filter with session based

• Hash: eb47f3dbe063eca21e59c0fd3a1988c3a17ae513
• Author: Restu Lomboe [email protected]
• Date: 2026-08-27

feat: make github action workflows for release

• Hash: ff50109577b57b7abf879b724de5478d41e9d2a4
• Author: Restu Lomboe [email protected]
• Date: 2026-08-27

fix: fix bug search advanced filter with column date

• Hash: b5caeabe2731187c4ad00b735aadf328093fff54
• Author: Restu Lomboe [email protected]
• Date: 2026-08-27

feat: make feature exclude column when export default and export custom

• Hash: a4437f33939287bcabce98757c319cd59460459f
• Author: Restu Lomboe [email protected]
• Date: 2026-08-27

feat: improvement query datatable

• Hash: 6d602cbbe616099f368d4323cfd42efe8b381a25
• Author: Restu Lomboe [email protected]
• Date: 2026-08-27

Stats

 .github/workflows/release.yml                      |  91 ++++
 README.md                                          | 168 +++++++
 composer.json                                      |   2 +-
 config/config.php                                  | 386 +--------------
 config/livewire-datatable.php                      |  42 ++
 resources/views/datatable.blade.php                | 475 +-----------------
 resources/views/exports/pdf.blade.php              |  74 ++-
 resources/views/placeholders/datatable.blade.php   | 150 +-----
 .../views/templates/bootstrap/datatable.blade.php  |   6 +-
 .../views/templates/tailwind/datatable.blade.php   |   7 +-
 src/Components/DataTable.php                       | 543 ++++++++++++++++++---
 src/DataSources/ModelDataSource.php                |  61 ++-
 src/Exports/DataTableExport.php                    |   6 +-
 src/Exports/DataTableQueryExport.php               | 141 ++++++
 src/LivewireDatatableFacade.php                    |   8 +-
 src/LivewireDatatableServiceProvider.php           |  31 +-
 src/Traits/WithExport.php                          | 163 +++----
 src/Traits/WithFormatters.php                      |  17 +-
 18 files changed, 1162 insertions(+), 1209 deletions(-)

✨ New Features

• Custom Export with Column Selection:

  • Interactive modal to choose which columns to export
  • Select All / Deselect All controls for quick selection
  • Columns grouped by their source table (main table + relations)
  • Smart column detection — excludes internal fields (id, password, remember_token, timestamps, soft deletes)
  • Per-export paper size (A4, Letter, Legal) and orientation (Portrait, Landscape)
  • Export to Excel or PDF with custom column selection
  • Dark mode support for the entire modal UI
  • Works across all template systems (Tailwind, Bootstrap)
  • Configurable theme classes for all modal elements

• Per-Export Paper Size & Orientation:

  • PDF exports now accept $paperSize and $orientation parameters
  • Falls back to config defaults when not specified
  • Dynamic PDF font sizing (140 / columnCount) and cell padding (80 / columnCount)
  • word-break: break-word prevents content overflow in PDF cells

• Enhanced Export API:

  • export(string $type, ?array $selectedColumns, ?string $paperSize, ?string $orientation) — supports passing selected columns, paper size, and orientation
  • customExport() action for Livewire modal integration
  • #[Computed] exportColumns property — lists all exportable columns with labels
  • showCustomExportPanel() / closeCustomExport() actions for modal management
  • toggleCustomExportColumn(), selectAllExportColumns(), deselectAllExportColumns() for column selection

🔧 Improvements

• Default export (Excel/PDF buttons) remains fully backward compatible
• Existing export respects filters and search as before
• DOMPDF options: isHtml5ParserEnabled, isFontSubsettingEnabled, defaultFont => serif, dpi => 96 for better PDF rendering
• [@page](https://github.com/page) { margin: 10mm; } for consistent PDF margins

🎨 UI/UX

• Custom Export option added to export dropdown with visual separator
• Modal with checkboxes organized by table groups
• Livewire live model binding for instant UI updates
• Disabled submit button when no columns selected
• Smooth dark mode adaptation for all modal elements

Highlights

• Livewire v4 Upgrade: The package has been upgraded to support Livewire v4, ensuring compatibility with the latest version of the framework.
• Bootstrap 5+ Template Support: A new default template for Bootstrap 5+ has been added, allowing users to choose between Tailwind CSS and Bootstrap for styling their DataTables. This includes extensive dynamic class configuration for Bootstrap elements.
• Advanced Filter Bug Fix: A bug related to the advanced search filter when used with query scopes has been resolved, improving the reliability of filtering functionality.
• Enhanced Type Hinting and Readability: Numerous methods across the codebase have been updated with explicit type hints for parameters and return types, improving code clarity, maintainability, and static analysis.

v1.4.0 - 2025-12-11

✨ New Features

• Advanced Dynamic Filter System:

  • Multiple column filtering with configurable UI
  • Filter by multiple conditions on same table
  • Real-time filter application with visual feedback
  • Filter state management (add, delete, reset)
  • Works seamlessly with sorting and pagination
  • Support for text input and dropdown filters
  • Enable/disable filters via configuration
  • Advanced filter panel with collapsible interface

• Default Sort Configuration:

  • Custom default sort field per table
  • Custom default sort direction (asc/desc)
  • Maintains default sort on page load
  • Flexible sort reset with filtering
  • Supports sorting by relationships

• Fully Dynamic CSS Classes:

  • All CSS classes moved to configuration file
  • Dynamic class binding for all UI elements
  • Data attributes for debugging and inspection
  • Complete theme customization without template changes
  • Icon styling configuration (SVG classes)
  • Layout wrapper configuration
  • Text styling configuration

• Enhanced Export with Filtering:

  • Export respects active filters and search
  • Export with applied sorting
  • Filtered exports with proper naming convention
  • Support for searched data export

🔧 Improvements

• Improved sorting behavior when filtering is active
• Better pagination handling with active filters
• Reset sort field when filtering data
• Dynamic class extraction via getClass() method
• All SVG icon classes configurable
• All layout wrapper classes configurable
• Per-page text styling configurable
• Column header text styling configurable

🏗 Architecture

• Implemented filterData() method for filtering logic
• Enhanced getQuery() computed property for filtered queries
• Improved sort reset mechanism
• Dynamic theme loading from configuration
• Trait-based approach maintained for extensibility

🎨 UI/UX

• Professional filter panel with icons
• Smooth animations and transitions
• Responsive filter controls
• Dark mode support for all new elements
• Better visual hierarchy in filter UI
• Collapsible filter sections
• Visual feedback for active filters

🔐 Security

• Filter validation with model scope
• Safe query parameter handling
• Protection against unauthorized filtering

📚 Documentation

• Added advanced filtering documentation
• Filter configuration examples
• Default sort configuration guide
• Theme customization guide
• Dynamic class configuration reference
• CSS class reference with data-class attributes

[v1.3.0] - 2025-10-18

✨ New Features

• Added comprehensive export functionality:

  • Export to Excel and PDF formats
  • Support for exporting all data regardless of pagination
  • Configurable export buttons with dropdown interface
  • Custom filename generation with search context
  • Proper formatting in exported files
  • Exclude action columns from exports
  • Support for all data types and relationships

• Enhanced pagination system:

  • Added "Show All" records option
  • Dynamic handling of large datasets
  • Improved performance with optimized queries
  • Maintains search and sort functionality
  • Smooth transition between page sizes

🔧 Improvements

• Optimized data export for large datasets
• Better handling of formatters in exports
• Improved memory efficiency for large exports
• Enhanced search functionality with export integration
• Added export button position configuration
• support custom params for scopr

🏗 Architecture

• Introduced WithExport trait for export functionality
• Added DataTableExport class for Excel exports
• Improved PDF template system
• Better handling of data transformations

📚 Documentation

• Added export configuration documentation
• Updated pagination examples
• Added formatter integration examples
• New examples for customizing exports

[v1.2.0] - 2025-09-19

✨ New Features

• Enhanced API integration:

  • Flexible response mapping
  • Customizable query parameters
  • Robust error handling
  • Support for nested API responses

• Added advanced value formatting system:

  • Simple formatters (date, datetime, currency, boolean, etc.)
  • Complex formatters with customizable options
  • Custom date format patterns support
  • Flexible number and currency formatting
  • Text manipulation (limit, words, markdown)
  • Support for both Model and API data sources

• Improved pagination system:

  • Support for both default and simple pagination
  • Total count display in simple pagination mode
  • Consistent behavior across data sources
  • Query parameter preservation in pagination links

🔧 Improvements

• Refactored formatting logic into WithFormatters trait
• Added support for custom formatter options
• Improved type declarations and PHP 8.2 compatibility
• Better error handling for API responses

🏗 Architecture

• Introduced WithFormatters trait for better code organization
• Improved separation of concerns in data handling
• Enhanced type safety across components
• Better abstraction for data sources

📚 Documentation

• Added comprehensive formatter documentation
• Improved API integration examples
• Added date format pattern examples
• Updated configuration examples

Release v1.1.0

✨ New Features

• ⚡ Server-side rendering - Handle large datasets efficiently
• 🚀 Performance improvements - Up to 40% faster with Livewire Computed Properties
• 📄 Dynamic pagination - Added simplePaginate method option
• 🔢 Enhanced number column - no column now sortable with proper numbering
• 🔍 Query scope support - Apply custom model scopes for filtered datasets

🔧 Configuration

Pagination Options

// Global config
'default_pagination' => 'simplePaginate', // or 'paginate'

// Per component
'pagination' => 'simplePaginate'

Number Column Usage

'columns' => [
    'no' => '#',        // Auto-numbered, sortable
    'name' => 'Name',
    'email' => 'Email'
]

Query Scope Usage

// In your model
public function scopeActive($query) {
    return $query->where('status', 'active');
}

// In component
'model' => User::class,
'scope' => 'active'  // Apply the scope

# Update existing
composer update developerawam/livewire-datatable

# clear cache
php artisan optimize:clear

🔄 Breaking Changes

None - fully backward compatible

📝 Release Notes

🚀 Highlights

• Initial stable release of Laravel Livewire DataTable
• Built for Laravel 12.x, Livewire 3.x, and TailwindCSS 3.x
• Out of the box: search, sorting, pagination, theming, and dark mode

✨ Features

• 🔍 Live Search with debouncing
• 🔄 Column Sorting, including relationship fields
• 📄 Dynamic Pagination
• 🎨 Customizable Themes with TailwindCSS
• 🌓 Dark Mode Support (automatic with Tailwind dark mode)
• 📱 Responsive Design
• 🔗 Relationship Column Support
• ⚡ Real-time Updates via Livewire
• 🎯 Custom Cell Templates for action buttons or custom UI
• 🛠 Event-driven Architecture for interactive tables

🔒 Security

• Please report security issues via [email protected]
• (not GitHub issues)