feat: add slug generation functionality with DefaultSlugGenerator and ContentSlugFactory

Author: cklei-carly

config/inspirecms.php

@@ -5,6 +5,7 @@
 use SolutionForest\InspireCms\Commands\ExecuteImportCommand;
 use SolutionForest\InspireCms\Content\DefaultPreviewProvider;
 use SolutionForest\InspireCms\Content\DefaultSegmentProvider;
+use SolutionForest\InspireCms\Content\DefaultSlugGenerator;
 use SolutionForest\InspireCms\Exports\Exporters\DocumentTypeExporter;
 use SolutionForest\InspireCms\Exports\Exporters\FieldGroupExporter;
 use SolutionForest\InspireCms\Exports\Exporters\ImportUsedExporter;
@@ -444,6 +445,7 @@
         ],
         'segment_provider' => DefaultSegmentProvider::class,
         'preview_provider' => DefaultPreviewProvider::class,
+        'slug_generator' => DefaultSlugGenerator::class,
     ],
 
     'sitemap' => [

src/Content/DefaultSlugGenerator.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace SolutionForest\InspireCms\Content;
+
+use Illuminate\Support\Str;
+
+class DefaultSlugGenerator implements SlugGeneratorInterface
+{
+    public function generate($text) 
+    {
+        return Str::slug($text);
+    }
+}

src/Content/SlugGeneratorInterface.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace SolutionForest\InspireCms\Content;
+
+interface SlugGeneratorInterface
+{
+    /**
+     * Generates a slug from the provided text.
+     *
+     * @param string $text The text to convert into a slug
+     * @return string The generated slug
+     */
+    public function generate($text);
+}

src/Factories/ContentSlugFactory.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace SolutionForest\InspireCms\Factories;
+
+use SolutionForest\InspireCms\Content\DefaultSlugGenerator;
+use SolutionForest\InspireCms\Content\SlugGeneratorInterface;
+use SolutionForest\InspireCms\InspireCmsConfig;
+
+class ContentSlugFactory
+{
+    public static function create(): SlugGeneratorInterface
+    {
+        $class = InspireCmsConfig::get('frontend.slug_generator', DefaultSlugGenerator::class);
+
+        static::guardAgainstInvalidContentSlugGenerator($class);
+
+        return app($class);
+    }
+
+    protected static function guardAgainstInvalidContentSlugGenerator(string $class): void
+    {
+        if (! in_array(SlugGeneratorInterface::class, class_implements($class))) {
+            throw new \InvalidArgumentException('Must implement ' . SlugGeneratorInterface::class);
+        }
+    }
+}

src/Filament/Resources/ContentResource.php

@@ -26,6 +26,7 @@
 use SolutionForest\InspireCms\DataTypes\Manifest\ContentStatusOption;
 use SolutionForest\InspireCms\Dtos\LanguageDto;
 use SolutionForest\InspireCms\Facades\InspireCms;
+use SolutionForest\InspireCms\Factories\ContentSlugFactory;
 use SolutionForest\InspireCms\Filament\Clusters\Content;
 use SolutionForest\InspireCms\Filament\Concerns\ClusterSectionResourceTrait;
 use SolutionForest\InspireCms\Filament\Contracts\ClusterSectionResource;
@@ -512,10 +513,10 @@ protected static function getTitleFormComponent()
             ->validationAttribute(__('inspirecms::resources/content.title.validation_attribute'))
             ->placeholder(__('inspirecms::resources/content.title.placeholder'))
             ->helperText(__('inspirecms::resources/content.title.instructions'))
-            ->live(true, 500)->afterStateUpdated(function ($state, $get, $set, $operation, ContentForm $livewire) {
+            ->live(true, 5000)->afterStateUpdated(function ($state, $get, $set, $operation, ContentForm $livewire) {
                 // Fill slug if empty / operation is create
                 if ($operation === 'create' || empty($get('slug'))) {
-                    $set('slug', Str::slug($state));
+                    $set('slug', ContentSlugFactory::create()->generate($state));
                 }
                 $locale = $livewire->getActiveActionsLocale();
                 $set("webSetting.seo.meta_title.{$locale}", $state);
@@ -536,7 +537,10 @@ protected static function getSlugFormComponent()
             ->validationAttribute(__('inspirecms::resources/content.slug.validation_attribute'))
             ->placeholder(__('inspirecms::resources/content.slug.placeholder'))
             ->helperText(__('inspirecms::resources/content.slug.instructions'))
-            ->live(true, 500)->afterStateUpdated(fn ($component, $state) => $component->state(Str::slug($state)))
+            ->live(true, 5000)
+            ->afterStateUpdated(function ($component, $state) {
+                return $component->state(ContentSlugFactory::create()->generate($state));
+            })
             ->unique(table: static::getModel(), column: 'slug', ignoreRecord: true, modifyRuleUsing: function (\Illuminate\Validation\Rules\Unique $rule, callable $get, ContentForm $livewire, string $operation) {
                 $model = new (static::getModel());