PHPackages                             shammaa/laravel-slug - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. shammaa/laravel-slug

ActiveLibrary[Utility & Helpers](/categories/utility)

shammaa/laravel-slug
====================

Professional Arabic-friendly slug generator for Laravel with automatic model integration

v1.7.3(4mo ago)454MITPHPPHP ^8.1

Since Nov 19Pushed 4mo agoCompare

[ Source](https://github.com/shammaa/laravel-slug)[ Packagist](https://packagist.org/packages/shammaa/laravel-slug)[ RSS](/packages/shammaa-laravel-slug/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (4)Versions (16)Used By (0)

Laravel Slug Package
====================

[](#laravel-slug-package)

A simple, professional slug generator for Laravel. Takes text → generates slug. That's it!

**Core Purpose:** Convert any text into a URL-friendly slug (e.g., "مقالات تقنية" → "مقالات-تقنية" or "maqalat-taqniya").

Features
--------

[](#features)

- ✅ **Simple & Clean** - Takes text, generates slug. That's it!
- ✅ **Automatic Model Integration** - Add trait, done!
- ✅ **Supports Translated Fields** - Works with translation packages (optional)
- ✅ **Preserve Original Language** - Keeps Arabic/Unicode characters by default
- ✅ **Unique Slugs** - Automatically ensures uniqueness in database
- ✅ **Auto-regeneration** - Regenerates when source field changes
- ✅ **Clean Text** - Removes HTML, punctuation, special characters
- ✅ **Find by Slug** - `findWhereSlug()` method for easy model retrieval (avoids conflicts)
- ✅ **Skip Generation** - Conditionally skip slug generation with `skipSlugGenerationWhen()`
- ✅ **Prevent Overwrite** - Protect existing slugs from being overwritten
- ✅ **Extra Scopes** - Multi-tenant support with custom uniqueness scopes
- ✅ **Custom Suffix** - Start suffix from custom number or use custom generator
- ✅ **Multiple Fields** - Generate slug from multiple source fields
- ✅ **Callable Source** - Generate slug from custom function/callable

Installation
------------

[](#installation)

### Install via Composer

[](#install-via-composer)

```
composer require shammaa/laravel-slug
```

**That's it!** The package will be installed automatically.

### Publish Configuration (Optional)

[](#publish-configuration-optional)

```
php artisan vendor:publish --tag=slug-config
```

This will create `config/slug.php` in your project with default settings.

Quick Start
-----------

[](#quick-start)

### 1. Add Trait to Your Model

[](#1-add-trait-to-your-model)

```