diff options
Diffstat (limited to 'vendor/jbroadway/urlify/README.md')
-rw-r--r-- | vendor/jbroadway/urlify/README.md | 108 |
1 files changed, 108 insertions, 0 deletions
diff --git a/vendor/jbroadway/urlify/README.md b/vendor/jbroadway/urlify/README.md new file mode 100644 index 000000000..0dcfab189 --- /dev/null +++ b/vendor/jbroadway/urlify/README.md @@ -0,0 +1,108 @@ +# URLify for PHP + +![GitHub Workflow Status (branch)](https://img.shields.io/github/workflow/status/jbroadway/urlify/Continuous%20Integration/master) +![Packagist License](https://img.shields.io/packagist/l/jbroadway/urlify) +![Packagist Version](https://img.shields.io/packagist/v/jbroadway/urlify) +![Packagist PHP Version Support](https://img.shields.io/packagist/php-v/jbroadway/urlify) +![Packagist Downloads](https://img.shields.io/packagist/dt/jbroadway/urlify) + +A fast PHP slug generator and transliteration library, started as a PHP port of +[URLify.js](https://github.com/django/django/blob/master/django/contrib/admin/static/admin/js/urlify.js) +from the Django project. + +Handles symbols from latin languages, Arabic, Azerbaijani, Bulgarian, Burmese, Croatian, Czech, Danish, Esperanto, +Estonian, Finnish, French, Switzerland (French), Austrian (French), Georgian, German, Switzerland (German), +Austrian (German), Greek, Hindi, Kazakh, Latvian, Lithuanian, Norwegian, Persian, Polish, Romanian, Russian, Swedish, +Serbian, Slovak, Turkish, Ukrainian and Vietnamese, and many other via `ASCII::to_transliterate()`. + +Symbols it cannot transliterate it can omit or replace with a specified character. + +## Installation + +Install the latest version with: + +```bash +$ composer require jbroadway/urlify +``` + +## Usage + +First, include Composer's autoloader: + +```php +require_once 'vendor/autoload.php'; +``` + +To generate slugs for URLs: + +```php +<?php + +echo URLify::slug (' J\'étudie le français '); +// "jetudie-le-francais" + +echo URLify::slug ('Lo siento, no hablo español.'); +// "lo-siento-no-hablo-espanol" +``` + +To generate slugs for file names: + +```php +<?php + +echo URLify::filter ('фото.jpg', 60, "", true); +// "foto.jpg" +``` + +To simply transliterate characters: + +```php +<?php + +echo URLify::downcode ('J\'étudie le français'); +// "J'etudie le francais" + +echo URLify::downcode ('Lo siento, no hablo español.'); +// "Lo siento, no hablo espanol." + +/* Or use transliterate() alias: */ + +echo URLify::transliterate ('Lo siento, no hablo español.'); +// "Lo siento, no hablo espanol." +``` + +To extend the character list: + +```php +<?php + +URLify::add_chars ([ + '¿' => '?', '®' => '(r)', '¼' => '1/4', + '½' => '1/2', '¾' => '3/4', '¶' => 'P' +]); + +echo URLify::downcode ('¿ ® ¼ ¼ ¾ ¶'); +// "? (r) 1/2 1/2 3/4 P" +``` + +To extend the list of words to remove: + +```php +<?php + +URLify::remove_words (['remove', 'these', 'too']); +``` + +To prioritize a certain language map: + +```php +<?php + +echo URLify::filter ('Ägypten und Österreich besitzen wie üblich ein Übermaß an ähnlich öligen Attachés', 60, 'de'); +// "aegypten-und-oesterreich-besitzen-wie-ueblich-ein-uebermass-aehnlich-oeligen-attaches" + +echo URLify::filter ('Cağaloğlu, çalıştığı, müjde, lazım, mahkûm', 60, 'tr'); +// "cagaloglu-calistigi-mujde-lazim-mahkum" +``` + +Please note that the "ü" is transliterated to "ue" in the first case, whereas it results in a simple "u" in the latter. |