Giter Club home page Giter Club logo

mm-sluggable's Introduction

MongoMapper::Plugins::Sluggable

Tiny plugin for MongoMapper to cache a slugged version of a field

Usage

Either load it into all models, or individual models:

# add to all models
MongoMapper::Document.plugin(MongoMapper::Plugins::Sluggable)

# add to a specific model
plugin MongoMapper::Plugins::Sluggable

Then call sluggable to configure it

sluggable :title, :scope => :account_id

Options

Available options are:

  • :scope - scope to a specific field (default - nil)

  • :key - what the slug key is called (default - :slug)

  • :index - whether to add an index for the slug (default - true)

  • :method - what method to call on the field to sluggify it (default - :parameterize)

  • :callback - when to trigger the slugging (default - :before_validation_on_create)

  • :force - whether to reset the slug key on the sluggable feild is changed (default - false)

Eg.

sluggable :title, :scope => :account_id, :key => :title_slug, :method => :to_url, :index => false

This will slug the title to the title_slug key, scoped to the account, will use String#to_url to slug it and won’t add an index to the key

Versioning

If an item with the same slug exists, it will add a version number to the slug.

IE assuming we already have an item with the slug of “dave”, the slug will be generated as “dave-1”

Note on Patches/Pull Requests

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don’t break it in a future version unintentionally.

  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself in another branch so I can ignore when I pull)

  • Send me a pull request. Bonus points for topic branches.

Install

$ gem install mm-sluggable

See LICENSE for details.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.