#Sluggable

CakePHP 3.0 Behavior to remove signed utf-8 character and make friendly url

Requirement:

Cakephp 3.x

PHP: >= 5.4.0

Installation:

Add the following lines to your application's composer.json:

    "require": {
        "crabstudio/cakephp-sluggable": "dev-master"
    }

followed by the command:

composer update

Or run the following command directly without changing your composer.json:

composer require crabstudio/cakephp-sluggable:dev-master

Usage:

In your Model Table, insert this one into function initialize:

        $this->addBehavior('Crabstudio/Sluggable.Sluggable', [
            'field' => 'title',
            'slug' => 'slug',
            'replacement' => '-', 
            'implementedFinders' => [
                'slugged' => 'findSlug',
                'check' => 'checkExist']
        ]);

Explain:

  field: name of field hold original string
  slug: name of field will save slugged string
  replacement: the connector character
  slugged: alias of function findSlug, you can change to new one. VD: 'friendlyName' => 'findSlug'
  check: alias of function checkExist, you can change to new one. VD: 'checkExisting' => 'checkExist'

Call function:

Ex1: 
$article = \Cake\ORM\TableRegistry::get('Articles')->find('slugged', ['slug' => 'how-to-make-friendly-url'])->first();
Ex2:
$this->loadModel('Articles');
$article = $this->Articles->find('slugged', ['slug' => 'how-to-make-friendly-url'])->first();
Ex3:
$isExist = $this->Articles->find('check', ['slug' => 'how-to-make-friendly-url'])->first();
if($isExist)
        do_some_thing;
else
        save entity;

Sample result:

Original: Nguyễn Anh Tuấn

Slugged: nguyen-anh-tuan