aboutsummaryrefslogtreecommitdiffstats
path: root/library/urlify/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'library/urlify/README.md')
-rw-r--r--library/urlify/README.md70
1 files changed, 70 insertions, 0 deletions
diff --git a/library/urlify/README.md b/library/urlify/README.md
new file mode 100644
index 000000000..7c2c42a12
--- /dev/null
+++ b/library/urlify/README.md
@@ -0,0 +1,70 @@
+# URLify for PHP
+
+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, Greek, Turkish,
+Russian, Ukrainian, Czech, Polish, and Latvian. Symbols it cannot transliterate
+it will simply omit.
+
+* Author: [jbroadway](http://github.com/jbroadway)
+* License: MIT
+
+## Usage:
+
+To generate slugs for URLs:
+
+```php
+<?php
+
+echo URLify::filter (' J\'étudie le français ');
+// "jetudie-le-francais"
+
+echo URLify::filter ('Lo siento, no hablo español.');
+// "lo-siento-no-hablo-espanol"
+
+?>
+```
+
+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 (array (
+ '¿' => '?', '®' => '(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 (array ('remove', 'these', 'too'));
+
+?>
+```