prepare 3.9.0, small adjustments to alias field

Author: koertho

CHANGELOG.md

@@ -2,8 +2,13 @@
 
 All notable changes to this project will be documented in this file.
 
-## [3.8.0] - 2025-05-20
-Added: StaticArrayUtils::filterByPrefixes
+## [3.9.0] - 2025-05-20
+- Added: StaticArrayUtils::filterByPrefixes ([#100](https://github.com/heimrichhannot/contao-utils-bundle/pull/100))
+- Added: AliasField ([#102](https://github.com/heimrichhannot/contao-utils-bundle/pull/102))
+
+## [3.8.0] - 2025-04-14
+- Changed: Url Util Improvements by @ericges in https://github.com/heimrichhannot/contao-utils-bundle/pull/94
+- Fixed: EntityFinderHelper.php by @ericges in https://github.com/heimrichhannot/contao-utils-bundle/pull/95
 
 ## [3.7.1] - 2025-03-20
 - Changed: enhance code quality by using rector

README.md

@@ -143,6 +143,32 @@ DateAddedField::register('tl_example')
 ;
 ```
 
+#### Alias field
+
+Add an alias field to your dca. Set the alias if the alias field is empty on save and check for duplicates.
+
+```php
+use HeimrichHannot\UtilsBundle\Dca\AliasField;
+
+AliasField::register('tl_example');
+```
+
+You can pass additional options to adjust the field:
+```php
+# contao/dca/tl_example.php
+use HeimrichHannot\UtilsBundle\Dca\AliasField;
+
+AliasField::register('tl_example')
+    AliasField::register('tl_md_newsletter')
+    ->setAliasExistCallback([NewsletterCallbackListener::class, 'checkAliasExist']) // set a custom alias exist callback
+    ->setExclude(false) // set the dca field exclude option
+    ->setSearch(false) // set the dca field search option
+    ->setFilter(false) // set the dca field filter option
+    ->setSorting(true) // set the dca field sorting option
+    ->setFlag(null) // set the dca field flag option
+;
+```
+
 ### Entity Finder
 
 The entity finder is a command to search for any contao entities in your database.

src/Dca/AliasField.php

@@ -6,6 +6,14 @@ class AliasField extends AbstractDcaField
 {
     private static $tables = [];
 
+    /**
+     * @return AliasFieldConfiguration
+     */
+    public static function register(string $table): DcaFieldConfiguration
+    {
+        return parent::register($table);
+    }
+
     protected static function storeConfig(DcaFieldConfiguration $config): void
     {
         self::$tables[$config->getTable()] = $config;
@@ -27,7 +35,13 @@ public static function getField(): array
             'exclude' => true,
             'search' => true,
             'inputType' => 'text',
-            'eval' => ['rgxp' => 'alias', 'unique' => true, 'maxlength' => 128, 'tl_class' => 'w50'],
+            'eval' => [
+                'rgxp' => 'alias',
+                'unique' => true,
+                'maxlength' => 128,
+                'tl_class' => 'w50',
+                'doNotCopy'=>true,
+            ],
             'save_callback' => [],
             'sql' => "varchar(255) BINARY NOT NULL default ''",
         ];