radiant_extensions_plugins/plugins/default_order/.svn/text-base/README.svn-base

   1 DefaultOrder
   2 ============
   3
   4 Author : Antonin AMAND
   5 Email : aamand@gwikzone.org
   6
   7 The default_order plugin provides a 'order_by' method to
   8 be called in your models.
   9
  10 ex :
  11
  12 class Contact < ActiveRecord::Base
  13   order_by "first_name, last_name"
  14
  15 end
  16
  17 the order_by method will append the given argument to
  18 :order Hash key of ActiveRecord::Base.find method
  19 IF IT HAS NOT BEEN PROVIDED.
  20
  21 ex :
  22
  23 Contact.find(:all, :conditions => "last_name LIKE '%toto%'")
  24 # will act as if you had written this
  25 Contact.find(:all, :order => "last_name, first_name",
  26         :conditions => "last_name LIKE '%toto%'")
  27 # but if you provide :order it will override the default order
  28
  29 If you use those attributes in other models, you
  30 may want to specify the table_name :
  31
  32 class Contact < ActiveRecord::Base
  33   order_by "contacts.first_name, contacts.last_name"
  34
  35 end