diff --git a/app/helpers/application_helper.rb b/app/helpers/application_helper.rb index 49331b7..0234033 100644 --- a/app/helpers/application_helper.rb +++ b/app/helpers/application_helper.rb @@ -76,39 +76,71 @@ module ApplicationHelper end end - # Displays context help. Pass the content of the help message in the block - # passed to this method. Example: + # Displays context help. You can pass the content of the help message as the + # first parameter or using template code inside a block passed to this + # method. *Note*: the block is ignored if content is not + # nil + # + # The method returns the text generated, so you can also use it inside a + # <%= ... %> + # + # Follow some examples ... + # + # Passing the text as argument: + # + # <% help 'This your help message' %> + # + # Using a block: # # <% help do %> # This is the help message to be displayed. It can contain any HTML you - # want: bold, italic, and even - # <%= link_to '', 'links' %> using Rails helpers. + # want: bold, italic. It can also contain calls + # to any Rails helper, like <%= link_to 'home', :controller => 'home' %>. # <% end %> # # You can also pass an optional argument to force the use of textile in your # help message: # - # <% help :textile do %> + # <% help nil, :textile do %> # You can also use *textile*! # <% end %> # + # or, using the return of the method: + # + # <%= help 'this is your help message' %> + # # Formally, the type argument can be :html or # :textile. It defaults to :html. # # TODO: implement correcly the 'Help' button click - def help(type = :html, &block) - content = capture(&block) + def help(content = nil, type = :html, &block) + + if content.nil? + return '' if block.nil? + content = capture(&block) + end + if type == :textile content = RedCloth.new(content).to_html end + + # TODO: implement this button, and add style='display: none' to the help + # message DIV button = link_to_function(_('Help'), "alert('change me, Leandro!')") - concat(content_tag('div', button + content_tag('div', content, :class => 'help_message'), :class => 'help_box'), block.binding) + + text = content_tag('div', button + content_tag('div', content, :class => 'help_message'), :class => 'help_box') + + unless block.nil? + concat(text, block.binding) + end + + text end - # alias for help(:textile). Pass a block in the same way you would - # do if you called help directly. - def help_textile(&block) - help(:textile, &block) + # alias for help(content, :textile). You can pass a block in the + # same way you would do if you called help directly. + def help_textile(content = nil, &block) + help(content, :textile, &block) end end diff --git a/app/views/features/index.rhtml b/app/views/features/index.rhtml index 1dfefb1..aa79e58 100644 --- a/app/views/features/index.rhtml +++ b/app/views/features/index.rhtml @@ -1,3 +1,7 @@