Skip to content

A Rails plugin which makes it drop-dead simple to add ajax editing controls to any text element on your site.

License

Notifications You must be signed in to change notification settings

ColinK/acts_as_adminable

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ActsAsAdminable
===============

ActsAsAdminable extends the content_tag text helper by allowing you to specify one extra option in the hash, ":key => 'SomeUniqueString'".  This will load the content of the element from your database, and, if the "admin" criteria are met, will also let you ajax-edit the contents of the object by clicking on it.

Example
=======

In your view, merely do this:
<%= content_tag :h1, 'A Title Goes Here', :key => 'title_h1' %>

"Click to Edit" is the default text that will be displayed the very first time (and it can be a useful visual placeholder in your code).  You could also pass in nil for that argument, in which case the text would be 'Click to Edit'.

The :key argument must be a globally unique string.  It's important that the content_tag also have a unique "id" HTML attribute, although ActsAsAdminable will use the :key for that purpose, if you didn't specify a different one.  So also make sure that you either specify a unique "id" HTML attribute, or that :key does not collide with any other element's "id" attribute.

The editable form which replaces your element will use either a <textarea> or an <input type="text"> tag, depending on the original tag type.
:h[1..6], :b, :i, :u, :span, and :a will result in a single-line <input> tag, and
:div, :td and :blockquote will result in a textarea.
All other tags will result in a textarea.

Copyright (c) 2009 The Killswitch Collective, released under the MIT license

About

A Rails plugin which makes it drop-dead simple to add ajax editing controls to any text element on your site.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages