update docs

Author: cklei-carly

docs/caching.md

@@ -2,19 +2,21 @@
 title: Caching
 slug: caching
 path: docs/v1/caching
-uri: /docs/1.x/caching
+uri: /docs/v1/caching
 heading: Caching
-brief:
+brief: 
+quick_links: []
 ---
 
+
 ## Overview
 
 Caching in InspireCMS accelerates content delivery by storing frequently accessed data in fast-access storage. The system employs several caching strategies:
 
--   **Language Cache**
--   **Navigation Cache**: Makes menu loading faster
--   **Route Cache**: Improves URL resolution
--   **KeyValue Cache**: Stores simple configuration and settings data
+- **Language Cache**
+- **Navigation Cache**: Makes menu loading faster
+- **Route Cache**: Improves URL resolution
+- **KeyValue Cache**: Stores simple configuration and settings data
 
 ---
 
@@ -105,7 +107,6 @@ Clear the language cache manually:
 // Clear all language cache
 \SolutionForest\InspireCms\Facades\InspireCms::forgetCachedLanguages();
 ```
-
 ---
 
 ## Navigation Caching
@@ -154,6 +155,7 @@ php artisan inspirecms:clear-cache --routes
 
 InspireCMS provides a persistent key-value storage system with caching capabilities through the `KeyValue` model.
 
+
 ### Working with KeyValue Model
 
 The `KeyValue` model provides a simple way to store and retrieve configuration values:
@@ -212,7 +214,7 @@ php artisan inspirecms:clear-cache --navigation
 
 InspireCMS automatically clears relevant caches when:
 
--   Content is created, updated or deleted
--   Settings are changed
--   Templates are modified
--   Navigation is restructured
+- Content is created, updated or deleted
+- Settings are changed
+- Templates are modified
+- Navigation is restructured

docs/configuration.md

@@ -1,3 +1,13 @@
+---
+title: Configuration
+slug: configuration
+path: docs/v1/configuration
+uri: /docs/v1/configuration
+heading: Configuration
+brief: 
+quick_links: []
+---
+
 ## Configuration Files
 
 InspireCMS's configuration is primarily managed through the `config/inspirecms.php` file. If this file doesn't exist after installation, you can publish it using:
@@ -41,7 +51,7 @@ php artisan vendor:publish --tag="inspirecms-config"
 
 ### Authentication
 
-Configure how users authenticate with your CMS \([learn more about laravel authentication](<(https://laravel.com/docs/12.x/authentication#adding-custom-guards)>)\):
+Configure how users authenticate with your CMS \([learn more about laravel authentication](https://laravel.com/docs/12.x/authentication#adding-custom-guards)\):
 
 ```php
 'auth' => [
@@ -492,7 +502,7 @@ Control how InspireCMS handles frontend requests:
      * Override to implement custom slug generation rules
      */
     'slug_generator' => \SolutionForest\InspireCms\Content\DefaultSlugGenerator::class,
-
+	
 	'fallback_seo' => [
 		'title' => env('APP_NAME', 'Home'),
 		'description' => null,
@@ -556,4 +566,4 @@ Configure language and translation settings:
     // Format: language code or locale identifier
     'user_preferred_locales' => ['en','zh_CN','zh_TW'],
 ],
-```
+```

docs/content-drafts-revisions.md

@@ -2,15 +2,19 @@
 title: Content Drafts & Revisions
 slug: content-drafts-revisions
 path: docs/v1/content-drafts-revisions
-uri: /docs/1.x/content-drafts-revisions
+uri: /docs/v1/content-drafts-revisions
 heading: Content Drafts & Revisions
 brief: InspireCMS provides a content versioning system that allows you to work with drafts and track revisions of your content. This guide explains how to use these features to manage your content workflow effectively.
+
+quick_links: []
 ---
 
-## Content States Overview
+## Overview
 
 In InspireCMS, content can exist in various states:
 
+![Content](https://inspirecms.net/storage/doc/eYLJ6RJp8oYQQAgdXI7flQOGsktGGiMe4vmqvXDU.png)
+
 1. **Draft**: Content that is being worked on but not yet published
 2. **Published**: Content that is live and visible to site visitors
 3. **Unpublished**: Previously published content that has been taken offline

docs/content-routing.md

@@ -2,9 +2,10 @@
 title: Content Routing
 slug: content-routing
 path: docs/v1/content-routing
-uri: /docs/1.x/content-routing
+uri: /docs/v1/content-routing
 heading: Content Routing
-brief:
+brief: 
+quick_links: []
 ---
 
 ## Overview
@@ -15,6 +16,18 @@ By default, content URLs follow a hierarchical structure:
 /parent-section/child-section/content-slug
 ```
 
+**Example Content Structure**:
+
+```plaintext
+- Root
+  - about
+  - products
+    - widgets
+      - blue-widget
+    - gadgets
+      - red-gadget
+```
+
 For example:
 
 -   `/about`: A top-level "About" page
@@ -49,6 +62,16 @@ Define constraints to validate parameters:
 ]
 ```
 
+### Accessing Route Variables in Blade
+
+After setting a content route with parameters, you can access those variables in your Blade templates. For example, if your route is defined as `/blog/{year}/{month}/{slug}`, you can access the `{year}` variable like this in your `blade.php` file:
+
+```php
+<p>Year: {{ $year }}</p>
+```
+
+This allows you to dynamically display content based on the URL parameters.
+
 ---
 
 ## Content Slugs
@@ -79,6 +102,38 @@ Slugs must:
 -   Not conflict with existing routes or reserved words
 -   Be unique within their parent section
 
+### Customizing the Slug Generator
+You can customize how slugs are generated by modifying the `slug_generator` setting in your configuration file. Here's how:
+
+1. Locate `frontend` section in the `config/inspirecms.php` file.
+
+2. **Edit the Slug Generator**:
+   Change the `slug_generator` to your custom class:
+   ```php
+   'frontend' => [
+       'slug_generator' => \App\CustomSlugGenerator::class,
+   ],
+   ```
+
+3. **Create Your Custom Slug Generator**:
+   Implement your custom slug generator class:
+   ```php
+   namespace App;
+
+   use SolutionForest\InspireCms\Content\DefaultSlugGenerator;
+
+   class CustomSlugGenerator extends DefaultSlugGenerator {
+       public function generate($text, $language = DefaultSlugGenerator::LANG_AUTO, $separator = '-') {
+           // Custom logic for slug generation
+           return strtolower(trim(preg_replace('/[^A-Za-z0-9-]+/', '-', $text)));
+       }
+   }
+   ```
+
+4. **Test Your Changes**:
+   After saving your configuration and custom class, create new content or edit existing content to see your custom slug generation in action.
+
+
 ---
 
 ## Route Registration

docs/control-panel.md

@@ -2,10 +2,10 @@
 title: Control Panel
 slug: control-panel
 path: docs/v1/control-panel
-uri: /docs/1.x/control-panel
+uri: /docs/v1/control-panel
 heading: Control Panel
-
 brief:
+quick_links: []
 ---
 
 ## Accessing the Control Panel
@@ -31,6 +31,8 @@ The path can be customized in your configuration if needed:
 
 The control panel is organized into several main sections:
 
+![Dashboard](https://inspirecms.net/storage/doc/V07Wy5bOcg2wwMD40qwBP32izQNvfi5F2eKEwZ8R.png)
+
 1. **Content**: Manage pages, blog posts, and other content types
 2. **Media**: Upload and organize images, documents, and other media
 3. **Settings**: Configure system settings, templates, and site options

docs/custom-fields.md

@@ -1,10 +1,11 @@
 ---
-title:
+title: Custom Fields
 slug: custom-fields
 path: docs/v1/custom-fields
-uri: /docs/1.x/custom-fields
+uri: /docs/v1/custom-fields
 heading: Custom Fields
 brief:
+quick_links: []
 ---
 
 Note: This document depends on the [Filament Field Group](https://github.com/solutionforest/filament-field-group). Field types may not update automatically; for missing or updated field references, please consult that repository.
@@ -54,6 +55,9 @@ InspireCMS offers a wide range of field types for different content needs:
 Field groups organize related fields together. To create a field group:
 
 1. Navigate to **Settings** > **Custom Fields** in the admin panel
+
+    ![Setting_custom_fields](https://inspirecms.net/storage/doc/E8Bb2dfWuVYlpgGZtB2w53EPWheLQYT16YzYD6Rj.png)
+
 2. Click **New Custom Fields**
 3. Add fields to the group using the form
 4. Enter a name and slug for your field group
@@ -65,8 +69,14 @@ Field groups organize related fields together. To create a field group:
 After creating field groups, associate them with document types:
 
 1. Navigate to **Settings** > **Document Types**
+
+    ![Setting_document_types](https://inspirecms.net/storage/doc/E0M1cUvrKfFvjMLqBUeUakAC4ZIuhKFz4nvAGLkn.png)
+
 2. Create or edit a document type
 3. Under "Structures," select the relevant field groups
+
+    ![select_field_group](https://inspirecms.net/storage/doc/TWqCvxdmz9jjT8pW0NG0vlMUJfrDsnldEK7KRp3L.png)
+
 4. Save your document type
 
 ---

docs/customize-the-admin-panel.md

@@ -2,9 +2,12 @@
 title: Customize the Admin Panel
 slug: customize-the-admin-panel
 path: docs/v1/customize-the-admin-panel
-uri: /docs/1.x/customize-the-admin-panel
+uri: /docs/v1/customize-the-admin-panel
 heading: Customize the Admin Panel
-brief: This guide explains how to customize and extend the admin panel to meet your specific needs, including creating custom resources, pages, widgets, and modifying the appearance to match your brand. Whether you need to add new functionality or tailor the existing features, InspireCMS offers multiple extension points for developers.
+brief: This guide explains how to customize and extend the admin panel to meet your specific needs, including creating custom resources, pages, widgets, and modifying the appearance to match your brand. 
+
+Whether you need to add new functionality or tailor the existing features, InspireCMS offers multiple extension points for developers.
+quick_links: []
 ---
 
 ## Overview