README

A simple and powerful Laravel package for generating SEO-friendly Kurdish slugs from Sorani and Kurmanji text.

It handles Kurdish-specific characters, Unicode normalization, Persian/Arabic character variants, and generates clean URL-friendly slugs for your Laravel applications.

✨ Features

🇹🇯 Sorani Kurdish support
🇹🇯 Kurmanji Kurdish support
🌐 Unicode-aware slug generation
🔗 Kurdish Unicode URL support
🧹 Removes unwanted characters automatically
⚡ Simple Laravel integration
🎯 Works with Laravel's Str-style workflow
📦 Composer package
🛠️ Easy to customize and extend

📦 Installation

Install the package using Composer:

composer require sirwancode/laravel-slug-kurdish

The package is automatically discovered by Laravel.

Manual Service Provider Registration

If package discovery is disabled or you are using a Laravel version/configuration where automatic discovery is unavailable, register the service provider manually.

SirwanCode\LaravelSlugKurdish\KuSlugServiceProvider::class,

🚀 Basic Usage

You can generate a Kurdish slug in sorani and kurmanji:

use sirwancode\laravelslugkurdish\KuSlug;

$slugSorani =  KuSlug::sorani( '  سڵاو! كــوردستان   ');  
$slugKurmanji =  KuSlug::kurmanji( '   Silav, Kurdistan!   ');

if you need unique slug:

use sirwancode\laravelslugkurdish\KuSlug;

$slugSorani =  KuSlug::sorani( '  سڵاو! كــوردستان   ',true);  
$slugKurmanji =  KuSlug::kurmanji( '   Silav, Kurdistan!   ',true);

🛠️ Configuration

publish configuration file using following command:

php artisan  vendor:publish --provider='sirwancode\laravelslugkurdish\KuSlugServiceProvider'    --force

a KuSlug.php is added to config folder of your application ,the configuration can be customized according to your application's requirements.

📁 Package Structure

laravel-slug-kurdish/
├── src/
│   ├── KuSlug.php
│   ├── KuSlugServiceProvider.php
│   ├── config.php 
├── composer.json
└── README.md

📋 Requirements

PHP 8.2+
Laravel 12+
Composer

⭐ Support

If this package is useful to you, consider giving the repository a ⭐ on GitHub.

Your support helps improve Kurdish open-source software.

Kurdish Laravel Tools

Built with ❤️ for Kurdish developers and Laravel applications.

Sorani • Kurmanji • Laravel • PHP • Open Source

sirwancode / laravel-slug-kurdish

Package info

Security

Statistics