test and docs

Author: =

CHANGELOG.md

@@ -4,6 +4,11 @@ All notable changes to `laravel-livewire-tables` will be documented in this file
 
 ## [Unreleased]
 
+## [dev-column-select] - 2022-05-14
+
+- Added functionality to bookmark or deep link column selection
+- Added functionality to identify different datatable components as unique in column selection and filter arrays
+
 ## [2.7.0] - 2022-05-07
 
 ### Added

docs/misc/multiple-tables.md

@@ -33,62 +33,25 @@ If you need the above, you should make them different components like so:
 <livewire:pending-users-table />
 ```
 
-## Introduction
-
-By default, your table has a name of `table`, as well as an internal array called `$table` which saves its state to the query string.
-
-The query string would look like this:
-
-```php
-// Under the hood
-public array $queryString = [
-    'table' => [
-        'search' => null,
-        'sort' => [],
-        ...
-    ],
-]
-```
-
-In order to have multiple tables on the same page, you need to tell it how to save the state of each table.
-
-## Setting the table name and data
-
-If you have multiple tables on the same page and you want them to have independent state saved in the query string, you must set a table name and data array.
-
-```php
-public string $tableName = 'users';
-public array $users = [];
-```
-
-The data array must be the same name as the table name. This data array will remain blank, I tried to create it dynamically in the query string but Livewire doesn't support that, so you have to define it yourself. It is a workaround until Livewire supports dynamic properties for the query string.
+## Disabling the query string for multiple of the same component
 
-Your query string will now look like this:
+If you must have multiple of the same component on the same page, you should disable the query string for those components so the query string state does not get replaced by one or the other:
 
 ```php
-// Under the hood
-public array $queryString = [
-    'users' => [
-        'search' => null,
-        'sort' => [],
-        ...
-    ],
-    // Other tables
-    'roles' => [
-        'search' => null,
-        'sort' => [],
-        ...
-    ],
-]
+public function configure(): void
+{
+    $this->setQueryStringDisabled();
+}
 ```
 
-## Disabling the query string for multiple of the same component
+## Disabling column selection for multiple of the same component
 
-If you must have multiple of the same component on the same page, you should disable the query string for those components so the query string state does not get replaced by one or the other:
+You should also disable the columns selection for those components so the query string and session state does not get replaced by one or the other:
 
 ```php
 public function configure(): void
 {
-    $this->setQueryStringDisabled();
+    $this->setColumnSelectStatus(true);
+    $this->setColumnSelectStatus(false);
 }
 ```

tests/DataTableComponentTest.php

@@ -40,4 +40,52 @@ public function primary_key_has_to_be_set(): void
 //            ->call('setPrimaryKey', null)
 //            ->call('setSearch', 'abcd');
     }
+
+    /** @test */
+    public function fingerprint_will_always_be_the_same_for_same_datatable(): void
+    {
+        $this->assertSame(
+            [
+                $this->basicTable->dataTableFingerprint(),
+                $this->basicTable->dataTableFingerprint(),
+                $this->basicTable->dataTableFingerprint(),
+            ],
+            [
+                $this->basicTable->dataTableFingerprint(),
+                $this->basicTable->dataTableFingerprint(),
+                $this->basicTable->dataTableFingerprint(),
+            ]
+        );
+        $this->assertSame($this->basicTable->dataTableFingerprint(), $this->fingerprintingAlgo($this->basicTable::class));
+    }
+
+    /** @test */
+    public function datatable_fingerprints_will_be_different_for_each_table(): void
+    {
+        $mockTable = new class() extends PetsTable {
+        };
+
+        $this->assertNotSame($this->basicTable->dataTableFingerprint(), $mockTable->dataTableFingerprint());
+    }
+
+    /** @test */
+    public function fingerprint_will_be_url_friendy(): void
+    {
+        $mocks = [];
+        for ($i = 0; $i < 9; $i++) {
+            $mocks[$i] = new class() extends PetsTable {
+            };
+            $this->assertFalse(filter_var('http://'.$mocks[$i]->dataTableFingerprint().'.dev', FILTER_VALIDATE_URL) === false);
+        }
+        // control
+        $this->assertTrue(filter_var('http://[9/$].dev', FILTER_VALIDATE_URL) === false);
+    }
+
+    protected function fingerPrintingAlgo($className)
+    {
+        $className = str_split($className);
+        $crc32 = sprintf('%u', crc32(serialize($className)));
+
+        return base_convert($crc32, 10, 36);
+    }
 }