public
Fork of technoweenie/permalink_fu
Description: ActiveRecord plugin for automatically converting fields to permalinks.
Clone URL: git://github.com/github/permalink_fu.git
commit  1050fce6f2bb8c269bf08267a66ad22b29775c63
tree    2bd55dfcd18614514bc0e207da8810687c9b835f
parent  d9d796cfa5a133eaa2382aacc3758e0f05b9c96a
name age message
file README Thu Mar 13 20:15:02 -0700 2008 fixed typo in README [nakajima]
file init.rb Mon Oct 15 14:19:36 -0700 2007 append incrementing numbers for duplicate guids [technoweenie]
directory lib/ Fri Mar 14 11:41:55 -0700 2008 moved condition evaluation into #should_create_... [nakajima]
directory test/ Thu Mar 13 18:07:51 -0700 2008 has_permalink now takes conditions (pretty much... [nakajima]
README
PermalinkFu

This is a simple plugin extracted from Mephisto for creating permalinks from attributes.

  class Article < ActiveRecord::Base
    has_permalink :title
  end

This will escape the title, making it fit to use in a URL in the after_validation callback.

Use PermalinkFu.escape to escape a string manually if you like.

If you're having issues with Iconv, you can manually tweak PermalinkFu.translation_to PermalinkFu.translation_from.
These are set to nil if Iconv is not loaded.  You can also manually set them to nil if you don't want to use iconv.

[Added 3.13.2008 by Pat Nakajima] You can now add conditions to #has_permalink like so:

  class Article < ActiveRecord::Base
    has_permalink :title, :if => Proc.new { |article| article.needs_permalink? }
  end

Use the :if or :unless options to specify a Proc, method, or string to be called or evaluated. The permalink
will only be generated if the option evaluates to true.