zen 0.2.4.1 → 0.2.5

data/lib/zen/package/comments/lib/comments/liquid/comment_form.rb

@@ -1,127 +0,0 @@
-require 'ramaze/gestalt'
-
-#:nodoc:
-module Comments
-  #:nodoc:
-  module Liquid
-    ##
-    # Liquid tag that can be used to generate the required form elements for submitting
-    # comments. It's important to remember that you still need to define your own
-    # form fields such as those for the name and Email, this tag merely generates
-    # the form open/closing tags and a few hidden fields. The following field (names)
-    # are required when creating a comment form:
-    #
-    # * name
-    # * website
-    # * email
-    # * comment
-    #
-    # Basic usage of this tag is as following:
-    #
-    #     {% comment_form section_entry="hello-world" %}
-    #
-    #       <p>
-    #           <label for="name">Name</label>
-    #           <input type="text" name="name" id="name" />
-    #       </p>
-    #
-    #       <input type="submit" value="Submit comment" />
-    #
-    #     {% endcomment_form %}
-    #
-    # The following arguments can be used:
-    #
-    # * section_entry: the slug of the entry
-    # * section_entry_id: the ID of the entry
-    #
-    # @author Yorick Peterse
-    # @since  0.1
-    #
-    class CommentForm < ::Liquid::Block
-      include ::Zen::Liquid::General
-      include ::Zen::Liquid::ControllerBehavior
-      include ::Ramaze::Helper::CSRF
-      include ::Ramaze::Helper::BlueForm
-      
-      ##
-      # Creates a new instance of the block and passes the tag name,
-      # all additional arguments and the HTML to the constructor method.
-      #
-      # @author Yorick Peterse
-      # @param  [String] tag_name The name of the tag that was called.
-      # @param  [String] arguments All additional arguments passed as a string.
-      # @param  [String] html The HTML inside the block.
-      # @since  0.1
-      #
-      def initialize(tag_name = 'comments_form', arguments = '', html = '')
-        super
-        
-        @arguments   = parse_key_values(arguments)
-        @args_parsed = false
-      end
-      
-      ##
-      # Renders the tag block.
-      # 
-      # @author Yorick Peterse
-      # @since  0.1
-      #
-      def render(context)
-        if @args_parsed == false
-          @arguments.each do |k, v|
-            v = v.to_s
-            
-            if context.has_key?(v)
-              @arguments[k] = h(context[v])
-            end
-          end
-        end
-        
-        @args_parsed = true
-        g            = Ramaze::Gestalt.new
-        user_html    = ''
-        
-        super(context).each { |h| user_html += h }
-        
-        # Get our section to which this form belongs
-        if @arguments.key?('section_entry')
-          section_entry = ::Sections::Models::SectionEntry[
-            :slug => @arguments['section_entry']
-          ]
-        else
-          section_entry = ::Sections::Models::SectionEntry[
-            @arguments['section_entry_id'].to_i
-          ]
-        end
-        
-        # Get the section entry's ID
-        if !section_entry.nil?
-          section_entry_id = section_entry.id
-        else
-          section_entry_id = nil
-        end
-        
-        # Get the user's ID if he/she is logged in
-        if !session[:user].nil?
-          user_id = session[:user].id
-        else
-          user_id = nil
-        end
-        
-        g_html = form_for(
-          nil, 
-          :method => :post, 
-          :action => Comments::Controllers::CommentsForm.r(:save)
-        ) do |f|
-          f.input_hidden(:csrf_token   , get_csrf_token)
-          f.input_hidden(:section_entry, section_entry_id)
-          f.input_hidden(:user_id      , user_id)
-          
-          user_html
-        end
-        
-        return g_html
-      end
-    end
-  end
-end

data/lib/zen/package/comments/lib/comments/liquid/comments.rb

@@ -1,115 +0,0 @@
-#:nodoc:
-module Comments
-  #:nodoc:
-  module Liquid
-    ##
-    # Tag that can be used to display a number of comments based on the section entry ID
-    # or the slug of a section entry.
-    #
-    # @example
-    #  {% comments section_entry="hello-world" limit="10" %}
-    #    {{comment}}
-    #  {% endcomments %}
-    #
-    # The following arguments can be used for this tag:
-    #
-    # * section_entry: the slug of the section entry for which to retrieve all comments
-    # * limit: the amount of comments to retriee
-    # * offset: the offset from which to start retrieving comments
-    #
-    # @author Yorick Peterse
-    # @since  0.1
-    #
-    class Comments < ::Liquid::Block
-      include ::Ramaze::Helper::CGI
-      include ::Zen::Liquid::General
-      
-      ##
-      # Creates a new instance of the block and passes the tag name,
-      # all additional arguments and the HTML to the constructor method.
-      #
-      # @author Yorick Peterse
-      # @param  [String] tag_name The name of the tag that was called.
-      # @param  [String] arguments All additional arguments passed as a string.
-      # @param  [String] html The HTML inside the block.
-      # @since  0.1
-      #
-      def initialize(tag_name = 'comments', arguments = '', html = '')
-        super
-        
-        @arguments = {
-          'limit'  => nil,
-          'offset' => nil
-        }.merge(parse_key_values(arguments))
-        
-        @args_parsed = false
-        
-        if !@arguments.key?('section_entry') or @arguments['section_entry'].empty?
-          raise(
-            ArgumentError, 
-            "You need to specify a section entry's slug in order to retrieve a set of comments"
-          )
-        end
-      end
-      
-      ##
-      # Retrieves all comments and renders the tag block.
-      # 
-      # @author Yorick Peterse
-      # @since  0.1
-      #
-      def render context
-        if @args_parsed == false
-          @arguments = merge_context(@arguments, context)
-        end
-        
-        @args_parsed = true
-        result       = []
-        filter_hash  = {:status => 'open'}
-        comments     = []
-        format       = nil
-        
-        if @arguments.key?('section_entry')
-          entry = ::Sections::Models::SectionEntry[:slug => @arguments['section_entry']]
-          
-          return if entry.nil?
-          filter_hash[:section_entry_id] = entry.id
-        end
-    
-        comments = ::Comments::Models::Comment
-          .eager(:user, :section_entry)
-          .filter(filter_hash)
-          .limit(@arguments['limit'], @arguments['offset'])
-          
-        context['total_rows'] = comments.count
-        
-        comments.each_with_index do |comment, index|
-          context['index'] = index
-          
-          if format.nil?
-            section = comment.section_entry.section
-            format  = section.comment_format
-          end
-          
-          comment.values.each { |k, v| context[k.to_s] = v }
-          
-          # Convert the comment body into HTML
-          context['comment'] = Zen::Plugin.call(
-            'com.zen.plugin.markup', format.to_sym, context['comment']
-          )
-          
-          ['email', 'name', 'website'].each do |c|
-            if context[c].nil? or context[c].empty?
-              context[c] = comment.user.send(c)
-            end
-          end
-          
-          result.push(render_all(@nodelist, context))
-        end
-        
-        result.push(render_all(@nodelist, context)) if result.empty?
-        return result
-      end
-    end
-  end
-end

data/lib/zen/package/menus/lib/menus/liquid/menus.rb

@@ -1,152 +0,0 @@
-require 'ramaze/gestalt'
-
-#:nodoc:
-module Menus
-  #:nodoc:
-  module Liquid
-    ##
-    # The menus tag can be used to display all menu items for a given menu slug or ID.
-    # Basic usage of this tag is as following:
-    #
-    #     {% menus slug="main" %}
-    #
-    # Given we had a menu of which the slug is "main" the output would look like the this:
-    #
-    #     <ul>
-    #         <li>
-    #             <a href="http://zen-cms.com/" title="Zen CMS">Zen CMS</a>
-    #         </li>
-    #     </ul>
-    #
-    # This tag takes the following arguments: 
-    #
-    # * slug: the slug of the menu for which to retrieve all items.
-    # * id: the ID of the menu for which to retrieve all items.
-    # * order: string (either "asc" or "desc") that will be used to order the menu items.
-    #
-    # If both the slug and ID are specified the ID will be used instead of the slug.
-    #
-    # @example
-    #  {% menus slug="main" order="asc" %}
-    #
-    # @author Yorick Peterse
-    # @since  0.2a
-    #
-    class Menus < ::Liquid::Tag
-      include ::Zen::Liquid::General
-
-      ##
-      # Initializes the tag class and converts the arguments string into a key/value
-      # hash.
-      #
-      # @author Yorick Peterse
-      # @since  0.2a
-      # @param  [String] tag_name The name of the tag ("menus").
-      # @param  [String] arguments All arguments passed as key="value" combinations.
-      # @param  [String] tokens All tokens passed to the tag.
-      # 
-      def initialize(tag_name = 'menus', arguments = '', tokens = '')
-        super
-
-        @arguments = {
-          'order' => 'desc'
-        }.merge(parse_key_values(arguments))
-
-        @args_parsed = false
-      end
-
-      ##
-      # Retrieves the specified menu, generates the HTML and renders the Liquid template.
-      #
-      # @author Yorick Peterse
-      # @since  0.2a
-      # @param  [Liquid::Context] context The current Liquid instance.
-      # @return [String] The HTML for the specified navigation menu. 
-      #
-      def render(context)
-        if @args_parsed == false
-          @arguments = merge_context(@arguments, context) 
-        end
-
-        @args_parsed = true
-        menu_items   = []
-        
-        if @arguments.key?('id')
-          menu = ::Menus::Models::Menu[@arguments['slug'].to_i]
-
-        elsif @arguments.key?('slug')
-          menu = ::Menus::Models::Menu[:slug => @arguments['slug']]
-
-        else
-          raise(
-            ArgumentError, 
-            "You need to specify either the ID or the slug in order to retrieve a menu."
-          )
-        end
-
-        return if menu.nil?
-
-        menu_items = ::Menus::Models::MenuItem.filter(:menu_id => menu.id)
-          .order(:order.send(@arguments['order']))
-        
-        # Build the navigation menu
-        @g                 = ::Ramaze::Gestalt.new
-        attributes         = {}
-        attributes[:class] = menu.css_class if !menu.css_class.nil?
-        attributes[:id]    = menu.css_id if !menu.css_id.nil?
-
-        # Organize all menu items in a parent/child hierachy
-        items_ordered = {}
-
-        @g.ul(attributes) do
-          menu_items.each do |item| 
-            if item.parent_id.nil?
-              self.menu_item(item)
-            end
-          end
-        end
-
-        return @g.to_s
-      end
-
-      ##
-      # Helper method used for generating a <li> and <a> tag for the current navigation 
-      # item. If the item has any sub items those will be generated as well.
-      #
-      # @author Yorick Peterse
-      # @since  0.2a
-      # @param  [Object] item The current navigation item
-      #
-      def menu_item(item)
-        attributes         = {}
-        
-        if !item.css_class.nil? and !item.css_class.empty?
-          attributes[:class] = item.css_class
-        end
-
-        if !item.css_id.nil? and !item.css_id.empty?
-          attributes[:id] = item.css_id
-        end
-
-        children = item.children
-
-        @g.li(attributes) do
-          if !item.url.nil? and !item.url.empty?
-            @g.a(:href => item.url, :title => item.name) { item.name }
-          else
-            @g.span { item.name }
-          end
-          
-          if !children.empty?
-            @g.ul(:class => :children) do
-              item.children.each do |i| 
-                self.menu_item(i)
-              end
-            end
-          end
-        end # end of @g.li(attributes) do
-      end
-
-    end
-  end
-end

data/lib/zen/package/sections/lib/sections/liquid/section_entries.rb

@@ -1,228 +0,0 @@
-#:nodoc:
-module Sections
-  #:nodoc:
-  module Liquid
-    ##
-    # The SectionEntries tag can be used to retrieve all section entries
-    # for the given section. A basic example of this looks like the following:
-    #
-    #     {% section_entries section="blog" %}
-    #         Do something in here
-    #     {% endsection_entries %}
-    #
-    # When using this tag you can specify the following optionally arguments:
-    #
-    # * section: the slug of the section for which to retrieve all entries
-    # * limit: the amount of entries to retrieve
-    # * offset: the offset from which to start selecting entries
-    # * section_entry: the slug of the section entry to select
-    # * order: the sort order type
-    # * order_by: the name of the column to sort on
-    # * category: retrieves all entries that are using the specified category
-    #
-    # These arguments can be specified as following:
-    #
-    #     {% section_entries section="blog" limit="10" offset="20" %}
-    #         Do something in here
-    #     {% endsection_entries %}
-    #
-    # Inside this block you can output the values of your custom fields by
-    # calling the variable tag containing the name of the custom field. For example,
-    # if you have a field called "body" you can output it for each entry as following:
-    #
-    #     {% section_entries section="blog" limit="10" offset="20" %}
-    #         {{body}}
-    #     {% endsection_entries %}
-    #
-    # The following variables are available by default:
-    #
-    # * id: the ID of the section entry
-    # * title: the entry title
-    # * slug: the entry slug
-    # * status: the status of the entry
-    # * created_at
-    # * updated_at
-    # * section_id: the ID of the section to which this entry belongs
-    #
-    # @example
-    #  {% section_entries section="blog" limit="10" offset="20" %}
-    #  <article>
-    #      <header>
-    #         <h1>{{title}}</h1>
-    #      </header>
-    #
-    #      {{body}}
-    #  </article>
-    #  {% endsection_entries %}
-    #
-    # @author Yorick Peterse
-    # @since  0.1
-    #
-    class SectionEntries < ::Liquid::Block
-      include ::Ramaze::Helper::CGI
-      include ::Zen::Liquid::General
-      
-      ##
-      # Creates a new instance of the block and passes the tag name,
-      # all additional arguments and the HTML to the constructor method.
-      #
-      # @author Yorick Peterse
-      # @since  0.1
-      # @param  [String] tag_name The name of the tag that was called.
-      # @param  [String] arguments All additional arguments passed as a string.
-      # @param  [String] html The HTML inside the block.
-      #
-      def initialize(tag_name ='section_entries', arguments = '', html = '')
-        super
-
-        @arguments = {
-          'limit'    => 10,
-          'offset'   => 0,
-          'section'  => '',
-          'order'    => 'desc',
-          'order_by' => 'id',
-          'category' => ''
-        }.merge(parse_key_values(arguments))
-        
-        @args_parsed = false
-      end
-      
-      ##
-      # Processes the arguments set in the constructor, retrieves all data and renders 
-      # the tag block. When outputting data inside the tag block you can always use the 
-      # following variables regardless on whether there are any section entries:
-      #
-      # * total_rows: the amount of rows retrieved
-      # * index: the current index
-      #
-      # Depending on whether you have any entries or not you can use the following
-      # values as well:
-      #
-      # * comments: array containing all comments for each entry
-      # * categories: array of all categories for each entry
-      # * user: data about the author of each entry
-      #
-      # On top of that you can of course also use your own custom values. Each value
-      # can be accessed by it's slug.
-      # 
-      # @author Yorick Peterse
-      # @since  0.1
-      #
-      def render(context)
-        @arguments = merge_context(@arguments, context) if @args_parsed == false
-                
-        @args_parsed = true
-        result       = []
-        entries      = []
-        filter_hash  = {:status => 'published'}
-        
-        # ------
-        # Filter by a section entry's slug
-        if @arguments.key?('section_entry')
-          if @arguments['section_entry'].empty?
-            raise(ArgumentError, "You need to specify a section entry to retrieve")
-          end
-          
-          filter_hash[:slug] = @arguments['section_entry']
-
-        # ------
-        # Filter by a category's slug
-        elsif @arguments.key?('category') and !@arguments['category'].empty?
-          category = ::Categories::Models::Category[:slug => @arguments['category']]
-
-          # Bail out of the category doesn't exist
-          return result if category.nil?
-    
-          # Retrieve the category group
-          group = category.category_group
-
-          # Now it's time to retrieve all section IDs
-          filter_hash[:section_id] = group.sections.map { |s| s.id }
-        
-        # ------
-        # Filter by a section's slug
-        else
-          if @arguments['section'].empty?
-            @arguments['section'] = ::Settings::Model::Setting.get_settings[:default_section]
-          end
-          
-          section = ::Sections::Models::Section[:slug => @arguments['section']]
-          
-          return result if section.nil?
-
-          filter_hash[:section_id] = section.id
-        end
-        
-        entries = ::Sections::Models::SectionEntry
-          .eager(:custom_field_values, :categories, :comments, :section, :user)
-          .filter(filter_hash)
-          .order(@arguments['order_by'].to_sym.send(@arguments['order']))
-          .limit(@arguments['limit'], @arguments['offset'])
-        
-        context['total_rows'] = entries.count
-        
-        entries.each_with_index do |entry, index|
-          entry.values.each { |k, v| context[k.to_s] = v }
-          
-          context['index']      = index
-          context['categories'] = []
-          context['comments']   = []
-          context['user']       = {}
-          
-          # Retrieve all categories
-          entry.categories.each do |c|
-            values = {}
-            
-            c.values.each { |k, v| values[k.to_s] = v }
-            context['categories'].push(values)
-          end
-          
-          # Get the user for the current entry
-          if !entry.user.nil?
-            entry.user.values.each { |k, v| context['user'][k.to_s] = v }
-          end
-          
-          # Retrieve all comments
-          entry.comments.each do |c|
-            values = {}
-            
-            c.values.each { |k, v| values[k.to_s] = v }
-            
-            # Pull the Email, name and website fields from the user table in case the comment
-            # was posted by somebody who was logged in to the backend.
-            ['email', 'name', 'website'].each do |m|
-              if values[m].nil? or values[m].empty?
-                values[m] = c.user.send(m)
-              end
-            end
-            
-            values['comment'] = Zen::Plugin.call(
-              'com.zen.plugin.markup', 
-              entry.section.comment_format.to_sym, 
-              values['comment']
-            )
-
-            context['comments'].push(values)
-          end
-          
-          # Get all our custom fields
-          entry.custom_field_values.each do |field_value|
-            field = field_value.custom_field
-            name  = field.slug
-            value = ::Zen::Plugin.call(
-              'com.zen.plugin.markup', field.format.to_sym, field_value.value
-            )
-            
-            context[name.to_s] = value
-          end
-          
-          result.push(render_all(@nodelist, context))
-        end
-        
-        result.push(render_all(@nodelist, context)) if result.empty?
-
-        return result
-      end
-    end
-  end
-end