module RailsConnector

  # @api public
  module CmsTagHelper

    # Returns an HTML block tag containing content from an Obj.
    # Add HTML attributes by passing an attributes hash to options.
    # The helper method is somewhat similar to (and internally uses) http://api.rubyonrails.org/classes/ActionView/Helpers/TagHelper.html#method-i-content_tag.
    #
    # This helper method also renders additional data attributes, which are needed for inplace editing.
    # These attributes are only rendered when appropriate, i.e. not for a regular visitor.
    #
    # @param tag_name [String, Symbol] Name of the html tag (e.g. +:h1+ or +:div+).
    # @param obj [Obj] A {Obj} from which attribute is read.
    # @param attribute [String, Symbol] Which attribute of the Obj should be rendered.
    # @param options [Hash] Additional options, which are passed to +content_tag+. Use them to add HTML attributes to the tag.
    # @return [String] The rendered html tag
    #
    # Example Usage:
    #     <%= cms_tag :h2, @obj, :headline, class: "very_important" %>
    # (renders an <h2> tag containing the text of the +headline+ attribute of +@obj+ and assigns the tag a css class called +very_important+.)
    # @api public
    def cms_tag(tag_name, obj, attribute, options = {})
      begin
        field_type = obj.type_of_attribute(attribute.to_s)
      rescue RailsConnectorError => e
        return content_tag(tag_name, '', options)
      end

      options = options.merge({
        'data-ip-field-id' => obj.id,
        'data-ip-field-obj-class' => obj.obj_class,
        'data-ip-field-name' => attribute,
        'data-ip-field-type' => field_type,
      }) if inplace_editing_allowed?

      if field_type == 'widget'
        rendered_widgets = obj.widgets(attribute).map do |widget|
          render_widget(widget, obj, attribute, obj)
        end
        inner_html = safe_join(rendered_widgets)
      else
        if inplace_editing_allowed?
          original_value = display_original_value(obj[attribute]) || ''
          # Concate with empty string to disable html_safe:
          options['data-ip-field-original-content'] = '' + original_value
        end
        inner_html = display_value(obj[attribute])
      end

      content_tag(tag_name, inner_html, options)
    end

    class List

      attr_reader :output

      def initialize(template)
        @template = template
      end

      # @param tag_name [String, Symbol] Name of the html tag (e.g. +:div+ or +:span+).
      # @param options [Hash] Additional options, which are passed to +content_tag+. Use them to add HTML attributes to the tag.
      # @return [String] The rendered html tag
      #
      # @example Render a <div> tag containing the text "random content" and assigns the tag a css class called +very_important+.
      #   <%= list.tag :div, class: "very_important" do %>
      #     random content
      #   <% end %>
      def tag(tag_name, options = {}, &block)
        if @output.present?
          raise '"list.tag" can only be called once per iteration!'
        else
          @output = @template.content_tag(tag_name, options, &block) + "\n"

          nil
        end
      end

    end

    # @param tag_name [String, Symbol] Name of the html tag (e.g. +:h1+ or +:div+).
    # @param obj [Obj] A {Obj} from which method_name is read.
    # @param method_name [String, Symbol] Which method_name of the Obj should be rendered. Currently only +toclist+ is supported
    # @param options [Hash] Additional options, which are passed to +content_tag+. Use them to add HTML attributes to the tag.
    # @yieldparam [List] list An instance, where +tag+ should be called once.
    # @yieldparam [Obj] child Each child of +toclist+
    # @return [String] The rendered html tag
    #
    # @example
    #   <%= cms_tag_list :div, @obj, :toclist, class: "very_important" do |list, child| %>
    #     <%= list.tag :div, class: "also_important" do %>
    #       <%= link_to cms_path(child) do %>
    #         <%= cms_tag :span, child, :title %>
    #       <% end %>
    #     <% end %>
    #   <% end %>
    #
    #   # results for an obj with two children in
    #
    #   <div class="very_important">
    #     <div class="also_important"><a href="/child1"><span>Child 1</span></a></div>
    #     <div class="also_important"><a href="/child2"><span>Child 2</span></a></div>
    #   </div>
    def cms_tag_list(tag_name, obj, method_name, options = {})
      if method_name.to_s == 'toclist'
        items = obj.toclist
      else
        raise "#{method_name} is not (yet) supported. Currently only toclist is supported."
      end

      inner_html = "\n".html_safe

      items.each do |item|
        list = List.new(self)

        yield list, item

        inner_html << list.output
      end

      options = options.merge({
        'data-ip-child-list-path' => obj.path,
      }) if inplace_editing_allowed?

      content_tag(tag_name, inner_html, options)
    end

    def render_widget(widget, obj, field_name, container)
      options = {
        'data-ip-widget-id' => widget.id,
        'data-ip-widget-obj-class' => widget.obj_class,
      } if inplace_editing_allowed?

      content_tag(:div, options || {}) do
        WidgetRenderer.new(request).process('show', widget, obj, field_name, container)
      end
    end

  end

end