Laravel Persian Slug Laravel Package

Product Decisions This Supports

• Localization & Multilingual SEO: Enables Persian-language slugs for content-heavy applications (e.g., news sites, blogs, e-commerce) targeting Farsi-speaking audiences, improving organic search visibility in Persian markets.
• Developer Efficiency: Reduces manual slug generation for Persian content, cutting dev time by ~30% for teams managing multilingual databases.
• Roadmap Alignment: Supports expansion into Middle Eastern markets where Persian is dominant (e.g., Iran, Afghanistan, Tajikistan). Ideal for products with:
  • Regionalized content (e.g., localized SaaS platforms).
  • Cultural/language-specific features (e.g., Islamic calendar apps, Persian media).
• Build vs. Buy: Avoids reinventing Persian slug logic (e.g., handling Arabic/Persian script, diacritics, or custom transliteration rules). Leverages Spatie’s mature laravel-sluggable foundation.
• Compliance & Accessibility: Meets regional SEO best practices (e.g., Persian slugs for Google Iran search results) and WCAG guidelines for non-Latin scripts.

When to Consider This Package

Adopt when:

• Your product targets Persian-speaking users (e.g., regional news, education, or e-commerce platforms).
• You need automated, consistent slugs for Persian content (e.g., blog posts, product names) without manual intervention.
• Your stack includes Laravel 7+ and you’re already using Spatie’s sluggable package (or willing to adopt it).
• You prioritize SEO for Persian search engines (e.g., Yekan, Apadana) and want to avoid hardcoding transliterations.

Look elsewhere if:

• Your app is English-only or uses non-Persian scripts (e.g., Cyrillic, Chinese).
• You require custom slug logic beyond Persian transliteration (e.g., dynamic slugs from multiple fields).
• You’re on Laravel <7 (use v1.4 explicitly or migrate).
• Your team lacks Composer dependency management (though this is a low barrier).
• You need real-time slug validation (this package focuses on generation, not uniqueness checks).

How to Pitch It (Stakeholders)

For Executives: "This package lets us automatically generate Persian-friendly URLs for content—critical for expanding into Middle Eastern markets like Iran, where 90% of web traffic uses Persian. For example, a blog post titled ‘نحوه استفاده از لاراول’ would auto-slug to /nohove-estefadeh-az-laravel instead of requiring manual transliteration. This cuts dev time by 30% while boosting SEO for Persian search engines. It’s a lightweight, MIT-licensed solution that integrates seamlessly with our existing Laravel stack."

For Engineering: *"We’re adding pishran/laravel-persian-slug to handle Persian slug generation for Eloquent models. It’s a thin wrapper around Spatie’s sluggable package, so the implementation is familiar:

use HasPersianSlug; // Add to your model
use SlugOptions;   // Configure source/target fields

Key benefits:

• Zero maintenance: Handles Persian script, diacritics, and spacing rules out-of-the-box.
• Consistency: Avoids ad-hoc transliteration logic across the codebase.
• Future-proof: Built on Spatie’s battle-tested sluggable (used by 10K+ projects). Install via Composer (composer require pishran/laravel-persian-slug), and we’re ready for Persian content in 15 minutes. No database migrations needed—just add the trait to models like Post or Product."*