sails-hook-slugs

sails-hook-slugs

This Sails.js hook generates URL-friendly slugs in your models.

Installation

Add this hook to your Sails app:

$ npm install sails-hook-slugs

That's all!

Usage

Add an attribute of type slug in a model:

module.exports = {

  attributes: {
    title: {
      type: 'string',
      required: true,
      unique: true
    },
    content: {
      type: 'text'
    },
    slug: {
      type: 'slug',
      from: 'title'
    }
  }
};

Configure your slug attribute:

• from: name of the attribute from which the slug will be defined (required)

A slug attribute is automatically set when you create a record:

Post.create({
  title: 'This is a new post!!!',
  content: 'Post content'
})
.then(function(post) {
  console.log(post.slug); // 'This-is-a-new-post'
});

If a record of the same model has the same slug, a UUID is added at the end of the new slug:

Post.create({
  title: 'This is a new post!!!!',
  content: 'A new post again'
})
.then(function(post) {
  console.log(post.slug); // 'This-is-a-new-posta50ec97e-9ae1-44a5-8fb2-81c665b61538'
});

Like any other attribute, you can use dynamic finders:

Post.findOneBySlug('This-is-a-new-post')
.then(function(post) {
  // Use the post
})
.catch(function(err) {
  // ...
});

License

MIT © 2015 Jérémie Ledentu