zen 0.2.8 → 0.3b

data/lib/zen/package/sections/lib/sections/language/en/section_entries.yml

@@ -1,44 +0,0 @@
----
-titles:
-  index  : 'Section Entries'
-  edit   : 'Edit Entry'
-  new    : 'Add Entry'
-
-labels:
-  id         : '#'
-  title      : 'Title'
-  slug       : 'Slug'
-  status     : 'Status'
-  created_at : 'Created at'
-  updated_at : 'Updated at'
-  author     : 'Author'
-
-special:
-  status_hash:
-    draft      : 'Draft'
-    published  : 'Published'
-
-tabs:
-  basic       : 'Basic'
-  categories  : 'Categories'
-
-messages:
-  no_entries     : 'No section entries have been created.'
-  no_categories  : 'No categories have been assigned to the current section.'
-
-errors:
-  new          : 'Failed to create a new section entry.'
-  save         : 'Failed to save the section entry.'
-  delete       : 'Failed to delete the section entry with ID#%s'
-  no_delete    : "You haven't specified any section entries to delete."
-  invalid_entry: 'The specified entry is invalid.'
-
-success:
-  new     : 'The new section entry has been created.'
-  save    : 'The section entry has been modified.'
-  delete  : 'All selected entries have been deleted.'
-
-buttons:
-  new     : 'Add section entry'
-  delete  : 'Delete selected entries'
-  save    : 'Save entry'

data/lib/zen/package/sections/lib/sections/language/en/sections.yml

@@ -1,48 +0,0 @@
----
-titles:
-  index  : 'Sections'
-  edit   : 'Edit Section'
-  new    : 'Add Secton'
-
-labels:
-  id                       : '#'
-  name                     : 'Name'
-  slug                     : 'Slug'
-  description              : 'Description'
-  comment_allow            : 'Allow comments'
-  comment_require_account  : 'Comments require an account'
-  comment_moderate         : 'Moderate comments'
-  comment_format           : 'Comment format'
-  custom_field_groups      : 'Custom field groups'
-  category_groups          : 'Category groups'
-  manage_entries           : 'Manage entries'
-
-special:
-  boolean_hash:
-    'true'  : 'Yes'
-    'false' : 'No'
-
-tabs:
-  general            : 'General'
-  comment_settings   : 'Comment Settings'
-  group_assignments  : 'Group Assignments'
-
-messages:
-  no_sections: "No sections have been created yet."
-
-errors:
-  new            : 'Failed to create a new section.'
-  save           : 'Failed to modify the section.'
-  delete         : 'Failed to delete the section with ID #%s.'
-  no_delete      : 'You need to specify at least one section to delete.'
-  invalid_section: 'The specified section is invalid.'
-
-success:
-  new     : 'The new section has been created.'
-  save    : 'The section has been modified.'
-  delete  : 'The selected sections have been deleted.'
-
-buttons:
-  new     : 'Add section'
-  delete  : 'Delete selected sections'
-  save    : 'Save section'

data/lib/zen/package/sections/lib/sections/language/nl/section_entries.yml

@@ -1,44 +0,0 @@
----
-titles:
-  index: 'Sectie items'
-  edit : 'Sectie item aanpassen'
-  new  : 'Sectie item aanmaken'
-
-labels:
-  id        : '#'
-  title     : 'Titel'
-  slug      : 'Slug'
-  status    : 'Status'
-  created_at: 'Aanmaak datum'
-  updated_at: 'Aanpas datum'
-  author    : 'Auteur'
-
-special:
-  status_hash:
-    draft    : 'Voorbeeld'
-    published: 'Gepubliceerd'
-
-tabs:
-  basic     : 'Algemeen'
-  categories: 'Categoriën'
-
-messages:
-  no_entries   : 'Er zijn nog geen items aangemaakt.'
-  no_categories: 'De huidige sectie bevat geen categoriën.'
-
-success:
-  new   : 'Het sectie item is aangemaakt.'
-  save  : 'Het sectie item is aangepast.'
-  delete: 'Alle geselecteerde items zijn verwijderd.'
-
-errors:
-  new          : 'Het sectie item kon niet worden aangemaakt.'
-  save         : 'Het sectie item kon niet worden aangepast.'
-  delete       : 'Het sectie item met ID #%s kon niet worden verwijderd.'
-  no_delete    : 'U moet ten minste 1 item specificeren om te verwijderen.'
-  invalid_entry: 'Het opgegeven item is ongeldig.'
-
-buttons:
-  new   : 'Sectie item toevoegen'
-  save  : 'Sectie item opslaan'
-  delete: 'Geselecteerde items verwijderen'

data/lib/zen/package/sections/lib/sections/language/nl/sections.yml

@@ -1,48 +0,0 @@
----
-titles:
-  index: 'Secties'
-  edit : 'Sectie aanpassen'
-  new  : 'Sectie toevoegen'
-
-labels:
-  id                     : '#'
-  name                   : 'Naam'
-  slug                   : 'Slug'
-  description            : 'Beschrijving'
-  comment_allow          : 'Reacties toegestaan'
-  comment_require_account: 'Reacties vereisen een account'
-  comment_moderate       : 'Beheer reacties'
-  comment_format         : 'Text opmaak'
-  custom_field_groups    : 'Veld groepen'
-  category_groups        : 'Categorie groepen'
-  manage_entries         : 'Beheer items'
-
-special:
-  boolean_hash:
-    'true' : 'Ja'
-    'false': 'Nee'
-
-tabs:
-  general          : 'Algemeen'
-  comment_settings : 'Reactie instellingen'
-  group_assignments: 'Groepen'
-
-messages:
-  no_sections: 'Er zijn nog geen secties aangemaakt.'
-
-success:
-  new   : 'De sectie is aangemaakt.'
-  save  : 'De sectie is aangepast.'
-  delete: 'Alle geselecteerde secties zijn verwijderd.'
-
-errors:
-  new            : 'De sectie kon niet worden aangemaakt.'
-  save           : 'De sectie kon niet worden aangepast.'
-  delete         : 'De sectie met ID #%s kon niet worden verwijderd.'
-  no_delete      : 'U moet ten minste 1 sectie specificeren om te verwijderen.'
-  invalid_section: 'De opgegeven sectie is ongeldig.'
-
-buttons:
-  new   : 'Sectie toevoegen'
-  save  : 'Sectie opslaan'
-  delete: 'Geselecteerde secties verwijderen'

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

@@ -1,244 +0,0 @@
-#:nodoc:
-module Sections
-  #:nodoc:
-  module Plugin
-    ##
-    # The SectionEntries plugin can be used to retrieve section entries as well
-    # as the associated comments and user data. This allows you to relatively
-    # easily build a list of entries (e.g. blog articles) without having to
-    # retrieve and process the associated data manually.
-    #
-    # ## Usage
-    #
-    # Basic usage is as following:
-    #
-    #     entries = plugin(:section_entries, :limit => 10, :section => 'blog')
-    #     entries.each do |e|
-    #       puts e[:title]
-    #     end
-    #
-    # The values of custom fields are stored under the key :fields. This key
-    # contains a hash where the keys are the slugs of the custom fields and the
-    # values the values for the current entry.
-    #
-    #     entries.each do |e|
-    #       e[:fields][:thumbnail]
-    #     end
-    #
-    # User data can be found in the key :user:
-    #
-    #     entries.each do |e|
-    #       e[:user][:name]
-    #     end
-    #
-    # Last but not least, comments can be found under the key :comments:
-    #
-    #     entries.each do |e|
-    #       e[:comments].each do |c|
-    #         c[:comment]
-    #       end
-    #     end
-    #
-    # For a full list of available options see
-    # Sections::Plugin::SectionEntries.initialize.
-    #
-    # @author Yorick Peterse
-    # @since  0.2.5
-    #
-    class SectionEntries
-      include ::Zen::Plugin::Helper
-      include ::Sections::Model
-
-      ##
-      # Creates a new instance of the plugin and validates/stores the given
-      # configuration options. Please note that you always need to either
-      # specify a section from which to retrieve all entries or a single entry
-      # in order to use this plugin. You can retrieve a list of entries (or just
-      # a single one) by specifying the ID or the slug:
-      #
-      #     plugin(:section_entries, :section => 'blog')
-      #     plugin(:section_entries, :section => 10)
-      #
-      # @author Yorick Peterse
-      # @since  0.2.5
-      # @param  [Hash] options Hash with a collection of custom configuration
-      # options that determine how and what entries should be retrieved.
-      # @option options [Fixnum/Integer] :limit
-      # @option options [Fixnum/Integer] :offset
-      # @option options [NilClass/String/Integer/Fixnum] :section
-      # @option options [NilClass/String/Integer/Fixnum] :entry
-      # @option options [TrueClass] :markup When set to true the markup of all
-      # entries will be converted to the desired output (usually this is HTML).
-      # @option options [TrueClass] :comments When set to true all comments for
-      # each entry will be retrieved. Set to false by default.
-      # @option options [TrueClass] :comment_markup When set to true the markup
-      # of comments will be converted to the desired output.
-      # @option options [TrueClass] :categories When set to true all categories
-      # for each entry will be retrieved as well. This is set to false by
-      # default.
-      #
-      def initialize(options = {})
-        @options = {
-          :limit          => 20,
-          :offset         => 0,
-          :section        => nil,
-          :entry          => nil,
-          :markup         => true,
-          :comments       => false,
-          :comment_markup => true,
-          :categories     => false
-        }.merge(options)
-
-        validate_type(@options[:limit]   , :limit   , [Fixnum, Integer])
-        validate_type(@options[:offset]  , :limit   , [Fixnum, Integer])
-
-        validate_type(
-          @options[:section], :section, [NilClass, String, Integer, Fixnum]
-        )
-
-        validate_type(
-          @options[:entry], :entry, [NilClass, String, Integer, Fixnum]
-        )
-
-        validate_type(@options[:markup]  , :markup  , [TrueClass, FalseClass])
-        validate_type(@options[:comments], :comments, [TrueClass, FalseClass])
-
-        if @options[:section].nil? and @options[:entry].nil?
-          raise(
-            ArgumentError,
-            "You need to specify either an entry or a section to retrieve."
-          )
-        end
-      end
-
-      ##
-      # Fetches all the data and converts everything to a hash. Once this is
-      # done either an array of entries or a single entry hash will be returned.
-      #
-      # @author Yorick Peterse
-      # @since  0.2.5
-      # @return [Array/Hash]
-      #
-      def call
-        # Create the list with models to load using eager()
-        eager_models = [:custom_field_values, :user]
-        filter_hash  = {}
-
-        if @options[:comments] === true
-          eager_models.push(:comments)
-        end
-        
-        if @options[:categories] === true
-          eager_models.push(:categories)
-        end
-
-        # Get the section ID based on either the slug or ID.
-        if !@options[:section].nil?
-          # Retrieve the section by it's slug
-          if @options[:section].class == String
-            section_id = Section[:slug => @options[:section]].id
-          else
-            section_id = @options[:section]
-          end
-
-          filter_hash[:section_id] = section_id
-        end
-
-        # Retrieve a specific entry
-        if !@options[:entry].nil?
-          # Retrieve it by it's slug
-          if @options[:entry].class == String
-            filter_hash[:slug] = @options[:entry]
-          # Retrieve the entry by it's ID
-          else
-            filter_hash[:id] = @options[:entry]
-          end
-        end
-
-        # Get the correct status to retrieve
-        filter_hash[:section_entry_status_id] = \
-          ::Sections::Model::SectionEntryStatus[:name => 'published'].id
-
-        # Get the entries
-        entries = SectionEntry.filter(filter_hash) \
-          .eager(*eager_models) \
-          .limit(@options[:limit], @options[:offset]) \
-          .all
-
-        comment_format = nil
-
-        # Loop through all entries so we can process our custom field values
-        entries.each_with_index do |entry, index|
-          field_values = {}
-          user         = {}
-          comments     = []
-          categories   = []
-
-          # Store all the custom field values
-          entry.custom_field_values.each do |v|
-            name  = v.custom_field.slug.to_sym
-            value = v.value
-
-            # Convert the markup
-            if @options[:markup] === true
-              value = plugin(:markup, v.custom_field.format, value)
-            end
-
-            field_values[name] = value
-          end
-
-          # Get all the comments if the developer wants them
-          if @options[:comments] === true
-            if comment_format.nil?
-              comment_format = entry.section.comment_format
-            end
-
-            entry.comments.each do |c|
-              comment = c.values
-
-              if c.user
-                comment[:user] = c.user.values
-              end
-
-              # Convert the comment's markup
-              if @options[:comment_markup]
-                comment[:comment] = plugin(
-                  :markup, comment_format, comment[:comment]
-                )
-              end
-
-              comments.push(comment)
-            end
-          end
-
-          # Get the user data
-          if !entry.user.nil?
-            user = entry.user.values
-          end
-
-          # Get all categories
-          if @options[:categories] === true
-            categories = entry.categories.map do |cat|
-              cat.values
-            end
-          end
-
-          # Convert the entry to a hash and re-assign all data
-          entry              = entry.values
-          entry[:fields]     = field_values
-          entry[:user]       = user
-          entry[:comments]   = comments
-          entry[:categories] = categories
-          entries[index]     = entry
-        end
-
-        # Do we only want a single entry?
-        if !@options[:entry].nil?
-          entries = entries[0]
-        end
-
-        return entries
-      end
-    end # SectionEntries
-  end # Plugin
-end # Sections

data/lib/zen/package/sections/lib/sections/plugin/sections.rb

@@ -1,87 +0,0 @@
-#:nodoc:
-module Sections
-  #:nodoc:
-  module Plugin
-    ##
-    # Plugin that can be used to display sections and their details. If you want
-    # to display section entries instead you should use the plugin
-    # Sections::Plugin::SectionEntries.
-    #
-    # ## Usage
-    #
-    #     section = plugin(:sections, :section => 10)
-    #     section.name # => "My Section"
-    #
-    # @author Yorick Peterse
-    # @since  0.2.5
-    #
-    class Sections
-      include ::Zen::Plugin::Helper
-      include ::Sections::Model
-
-      ##
-      # Creates a new instance of the plugin and saves/validates the given
-      # configuration options.
-      #
-      # @example
-      #  plugin = Sections::Plugin::Sections.new(:section => 10)
-      #
-      # @author Yorick Peterse
-      # @since  0.2.5
-      # @param  [Hash] options Hash with a set of configuration files to use.
-      #
-      def initialize(options = {})
-        @options = {
-          :limit   => 20,
-          :offset  => 0,
-          :section => nil
-        }.merge(options)
-
-        validate_type(@options[:limit]  , :limit  , [Fixnum, Integer])
-        validate_type(@options[:offset] , :offset , [Fixnum, Integer])
-
-        validate_type(
-          @options[:section], :section, [NilClass, Integer, Fixnum, String]
-        )
-      end
-
-      ##
-      # Retrieves the section(s) based on the given configuration options. When
-      # multiple sections are retrieved they're returned as an array, otherwise
-      # a single instance of Sections::Model::Sections will be returned.
-      #
-      # @author Yorick Peterse
-      # @since  0.2.5
-      # @return [Array/Sections::Model::Section] List of all sections that were
-      # retrieved or an instance of Sections::Model::Section in case a specific
-      # section was retrieved from the database.
-      #
-      def call
-        # Retrieve a single section
-        if !@options[:section].nil?
-          # Retrieve a section by it's slug
-          if @options[:section].class == String
-            sections = Section[:slug => @options[:section]]
-          # Retrieve a section by it's ID
-          else
-            sections = Section[@options[:section]]
-          end
-        # Retrieve mutliple sections
-        else
-          sections = Section.limit(@options[:limit], @options[:offset]).all
-        end
-
-        # Convert every section to a hash
-        if sections.class == Array
-          sections.each_with_index do |section, index|
-            sections[index] = section.values
-          end
-        else
-          sections = sections.values
-        end
-
-        return sections
-      end
-    end # Sections
-  end # Plugin
-end # Sections