strapi-plugin-auto-slug-manager-a-mi13

Strapi Plugin Auto Slug Manager

🔗 Universal auto slug generator for all Strapi content types with Rich Text support

✨ Features

• Universal - Works with ANY content type that has a slug field
• Rich Text Support - Extracts text from both Rich Text Blocks (new editor) and classic Rich Text (HTML) fields
• Multiple Field Types - Supports string, Rich Text Blocks, and classic Rich Text fields
• Cyrillic Support - Proper transliteration of Russian/Cyrillic characters
• Smart Uniqueness - Automatically adds suffixes (-1, -2, -3) for unique slugs
• Auto-discovery - Automatically finds and processes all content types with slug fields
• Configurable - Update existing slugs or keep them unchanged
• Admin Panel - Beautiful settings interface with real-time configuration
• Zero Configuration - Works out of the box with sensible defaults
• 🌐 Multi-locale Support - Choose from 8 different locales for transliteration (ru, en, de, fr, es, it, pl, tr)
• 🎛️ Easy Configuration - Change locale directly from admin panel without code editing

🚀 Installation

npm install strapi-plugin-auto-slug-manager-a-mi13
# or
yarn add strapi-plugin-auto-slug-manager-a-mi13

⚙️ Configuration

Add the plugin to your config/plugins.js or config/plugins.ts:

module.exports = {
  'auto-slug-manager': {
    enabled: true,
    config: {
      enabled: true,                    // Enable/disable plugin globally
      sourceField: 'title',             // Primary field to generate slug from
      fallbackField: 'name',            // Fallback field if primary is empty
      handleRichText: true,             // Process Rich Text (blocks) fields
      addSuffixForUnique: true,         // Add suffixes for uniqueness
      supportCyrillic: true,            // Support Cyrillic transliteration
      updateExistingSlugs: true,        // Update existing slugs when title changes
      slugifyOptions: {
        lower: true,
        strict: true,
        locale: 'ru'
      }
    }
  }
};

📖 Usage

• Add a slug field to any content type in your Strapi schema
• Create or edit entries - slugs will be automatically generated from title or name fields
• Rich Text support - Works with both regular string fields and Rich Text editor fields

Example Content Type Schema

{
  "kind": "collectionType",
  "collectionName": "articles",
  "info": {
    "singularName": "article",
    "pluralName": "articles",
    "displayName": "Articles"
  },
  "attributes": {
    "title": {
      "type": "blocks"
    },
    "slug": {
      "type": "uid",
      "targetField": "title"
    }
  }
}

🎯 How it Works

• Auto-discovery: Plugin scans all content types for slug fields
• Lifecycle hooks: Registers beforeCreate and beforeUpdate hooks
• Smart text extraction: Automatically detects and processes different field types:
  • String fields → direct text extraction
  • Rich Text Blocks → extracts text from JSON structure
  • Classic Rich Text → strips HTML tags and extracts clean text
• Slug generation: Uses slugify with Cyrillic support
• Uniqueness check: Ensures all slugs are unique within the content type

🔧 API Endpoints

The plugin provides API endpoints for managing settings:

• GET /auto-slug-manager/settings - Get current settings
• PUT /auto-slug-manager/settings - Update settings
• GET /auto-slug-manager/status - Get plugin status and discovered content types

📝 Field Types Supported

Rich Text Blocks (New Editor)

{
  "title": [
    {
      "type": "paragraph",
      "children": [
        {
          "type": "text",
          "text": "My Article Title"
        }
      ]
    }
  ]
}

Rich Text (Classic Editor)

{
  "title": "<h1>My Article Title</h1><p>Some description</p>"
}

Regular String

{
  "title": "My Article Title"
}

All three will generate: my-article-title

🌍 Multi-locale Support

The plugin supports 8 different locales for transliteration. You can change the locale directly from the admin panel:

Available Locales

Locale	Language	Example
ru	Russian	Моя статья → moya-statya
en	English	My Article → my-article
de	German	Mein Artikel → mein-artikel
fr	French	Mon Article → mon-article
es	Spanish	Mi Artículo → mi-articulo
it	Italian	Il Mio Articolo → il-mio-articolo
pl	Polish	Mój Artykuł → moj-artykul
tr	Turkish	Benim Makalem → benim-makalem

How to Change Locale

• Go to Admin Panel → Settings → Auto Slug Manager
• Find "🔧 Настройки генерации слагов" section
• Select your preferred locale from the dropdown
• Click "Сохранить настройки"

Examples

Russian locale (ru):

• Моя статья → moya-statya
• Тестовая запись → testovaya-zapis

English locale (en):

• My Article → my-article
• Test Entry → test-entry

🔧 Development

# Clone the repository
git clone https://github.com/A-mi13/strapi-plugin-auto-slug-manager
cd strapi-plugin-auto-slug-manager

# Install dependencies
npm install

# Build the plugin
npm run build

🤝 Contributing

Contributions are welcome! Please read our contributing guidelines before submitting PRs.

📄 License

MIT License - see LICENSE file for details.

🐛 Issues

Found a bug? Please create an issue on GitHub.

📦 Related

• Strapi Documentation
• Strapi Plugin Development

Made with ❤️ for the Strapi community

Changelog

[1.1.0] - 2025-08-06

Added

• 🌐 Multi-locale Support: Added support for 8 different locales (ru, en, de, fr, es, it, pl, tr)
• 🎛️ Admin Panel Locale Selection: Users can now change locale directly from admin panel without editing code
• 🔧 Enhanced Configuration: Improved settings management with proper slugifyOptions handling
• 📝 Better Documentation: Updated README with multi-locale examples and configuration guide

Changed

• ⚙️ Configuration Priority: Admin panel settings now take precedence over config file settings
• 🔄 Settings Initialization: Improved settings initialization from plugin configuration
• 📦 Package Name: Updated to strapi-plugin-auto-slug-manager-a-mi13 for npm publishing

Fixed

• 🐛 Locale Configuration: Fixed issue where locale settings from config/plugins.ts were not being applied
• 🔧 Settings Store: Fixed settings initialization to properly merge slugifyOptions
• ⚡ Performance: Optimized settings loading and application

Technical

• 🏗️ Architecture: Improved settings store with proper initialization from plugin config
• 🔌 Bootstrap: Enhanced bootstrap process to load settings from plugin configuration
• 🎯 API: Better handling of slugifyOptions in settings API