outpost-cms 0.0.3

data/app/helpers/list_helper.rb

@@ -0,0 +1,243 @@
+module ListHelper
+  # Public: Renders the attribute for this column and record
+  #
+  # column  - (Outpost::Column) The column object.
+  # record  - (Object) The ActiveRecord object being listed.
+  # 
+  # Examples
+  #   
+  #   column.attribute # => :published_at 
+  #   <%= render_attribute(column, @post) %>
+  #   # => 2013-03-13 11:39:37 -0700
+  # 
+  # Returns String of the rendered attribute.
+  def render_attribute(column, record)
+    if column.display.is_a? Proc
+      # If we passed a Proc to :display, use it.
+      record.instance_eval(&column.display)
+    else
+      if column._display_helper.present?
+        # If we've already figured out which method to use for
+        # this column, then use it. This is to prevent this method
+        # from having to fully run hundreds of times on each page.
+        display_helper = column._display_helper
+
+      elsif column.display.is_a? Symbol
+        display_helper = column.display
+
+      elsif self.methods.include? :"display_#{column.attribute}"
+        # If we have explicitly defined a helper for this attribute, use it.
+        display_helper = :"display_#{column.attribute}"
+
+      elsif record.class.respond_to?(:reflect_on_association) && 
+        record.class.reflect_on_association(column.attribute.to_sym)
+        # For associations, display the associated object's #to_title
+        display_helper = :display_record
+        
+      elsif record.class.respond_to?(:columns_hash) && 
+        (ar_column = record.class.columns_hash[column.attribute]) && 
+        self.methods.include?(type_helper = :"display_#{ar_column.type}")
+        # display_#{column_type} for generic display
+        # Example: display_datetime
+        display_helper = type_helper
+
+      else
+        # Fallback to just using attribute.to_s
+        display_helper = :display_string
+      end
+
+      value = record.send(column.attribute)
+      column._display_helper = display_helper
+      send(display_helper, value)
+    end
+  end
+
+  # Public: Format a DateTime for displaying in lists
+  # 
+  # date - (DateTime) The date to be formatted
+  #
+  # Examples
+  #
+  #   display_date(Time.now)
+  #   # => March 13th, 2012
+  #
+  # Returns String of formatted date
+  def display_date(date)
+    format_date(date, format: :full_date)
+  end
+
+  # Public: Display the attribute or "[blank]" if not present
+  #
+  # attrib  - (String) The attribute to display
+  # options - (Hash) A hash of options (default: {}).
+  #           fallback - (String) The string to use as placeholder text
+  #                      (default: "[blank]").
+  #
+  # Examples
+  #
+  #   display_or_fallback("Foo")
+  #   # => Foo
+  #
+  #   display_or_fallback("", fallback: "none")
+  #   # => none
+  #
+  # Returns String of either the attribute (if present) or "[blank]"
+  def display_or_fallback(attrib, options={})
+    fallback = options[:fallback] || "[blank]"
+    attrib.present? ? attrib.to_s : content_tag(:em, fallback)
+  end
+
+  # Public: Display the attribute as a string.
+  #
+  # attrib - (String) The attribute to display.
+  #
+  # Examples
+  #
+  #   display_string("anything")
+  #   # => "anything"
+  #
+  # Returns String of the attribute
+  def display_string(attrib)
+    attrib.to_s
+  end
+
+  # Public: Displays an String representation of the record using +#to_title+.
+  #
+  # record - (String) The associated record.
+  #
+  # Examples
+  # 
+  #   user = User.last
+  #   user.to_title # => "James Earl Jones"
+  #   display_record(User.last)
+  #   # => "James Earl Jones"
+  #
+  # Returns String representation of the passed-in record.
+  def display_record(record)
+    record.try(:to_title)
+  end
+  
+  # Public: Display a formatted DateTime.
+  #
+  # datetime - (DateTime) The DateTime object to format.
+  #
+  # Examples
+  #
+  #   display_datetime(Time.now)
+  #   # => "March 13th, 2013,  4:12pm"
+  #
+  # Returns String of the formatted date and time.
+  def display_datetime(datetime)
+    format_date(datetime, format: :full_date, time: true)
+  end
+  
+  # Public: Display a boolean attribute as a sweet icon.
+  #
+  # boolean - (boolean) true or false
+  #
+  # Examples
+  #
+  #   display_boolean(true)
+  #   # => <span class="badge badge-important">
+  #   # =>   <i class="icon-white icon-ok"></i>
+  #   # => </span>
+  #
+  # Returns String of the appropriate icon. 
+  def display_boolean(boolean)
+    content_tag(:span, 
+      content_tag(:i, "", class: boolean_bootstrap_map[!!boolean][:icon]), 
+      class: boolean_bootstrap_map[!!boolean][:badge])
+  end
+
+  # Private: Map for booleans to Bootstrap classes.
+  #
+  # Returns Hash
+  def boolean_bootstrap_map
+    {
+      true  => { icon: "icon-white icon-ok",     badge: "badge badge-success"},
+      false => { icon: "icon-white icon-remove", badge: "badge badge-important"}
+    }
+  end
+
+  # Public: Maps the passed-in sort mode (asc, desc) to the appropriate
+  # Bootstrap Glyphicons (icon-arrow-up, icon-arrow-down respectively)
+  #
+  # sort_mode - (String) The sort mode ("asc", "desc").
+  #
+  # Examples
+  #
+  #   <i class="<%= sort_mode_icon('asc') %>">
+  #   # => <i class="icon-arrow-up">
+  #
+  # Returns String of the icon class.
+  def sort_mode_icon(sort_mode)
+    case sort_mode
+    when "desc" then "icon-arrow-down"
+    when "asc"  then "icon-arrow-up"
+    end
+  end
+
+  # Public: Which sort mode to switch to. Useful for creating links to 
+  # switch the sort mode or change the list order.
+  #
+  # column            - (Outpost::Column) The column on which the sort 
+  #                     will be performed.
+  # current_order     - (String) The attribute that is currently being
+  #                     ordered.
+  # current_sort_mode - (String) The current sort mode ("asc", "desc").
+  #
+  # Examples
+  #   
+  #   <%= link_to column.header, request.parameters.merge({
+  #      :sort_mode => switch_sort_mode(
+  #          column, current_order, current_sort_mode
+  #      )
+  #   }) %>
+  #
+  # Returns String of the sort mode, "asc" or "desc"
+  def switch_sort_mode(column, current_order, current_sort_mode)
+    if column.attribute == current_order
+      case current_sort_mode
+      when "asc"  then "desc"
+      when "desc" then "asc"
+      else column.default_sort_mode
+      end
+    else
+      column.default_sort_mode
+    end
+  end
+
+  # Public: Generate a CSS class for the column. If the column represents 
+  # an association, the class will be "column-association".
+  #
+  # model     - (Class) The ActiveRecord model.
+  # attribute - (String) The attribute for this column.
+  #
+  # Examples
+  #
+  #   <tr class="<%= column_type_class(BlogEntry, 'created_at') %>">
+  #   # => <tr class="column-datetime">
+  #
+  # Returns String to be used as a CSS class.
+  def column_type_class(model, attribute)
+    if column = model.columns_hash[attribute]
+      "column-#{column.type}"
+    else
+      "column-association"
+    end
+  end
+
+  # Public: Generate a CSS class for this attribute
+  #
+  # attribute - (String) The attribute.
+  #
+  # Examples
+  #
+  #   <td class="<%= column_attribute_class('created_at') %>">
+  #   # => <td class="column-created_at">
+  #
+  # Returns String to be used as a CSS class.
+  def column_attribute_class(attribute)
+    "column-#{attribute}".parameterize
+  end
+end

data/app/helpers/outpost_helper.rb

@@ -0,0 +1,49 @@
+module OutpostHelper
+  # Public: Maps the standard Rails flash keys (+notice+, +alert+) to the 
+  # appropriate Bootstrap alert class (+success+, +error+ respectively).
+  # Falls back to just returning the passed-in symbol as a string.
+  #
+  # name - The flash key as a Symbol.
+  #
+  # Examples
+  #
+  #   <div class="alert alert-<%= flash_alert_type(:notice) %>">
+  #   # => <div class="alert alert-success">
+  #
+  # Returns String of appropriate CSS class for Bootstrap alerts.
+  def flash_alert_type(name)
+    name_bootstrap_map = {
+      notice: "success",
+      alert:  "error"
+    }
+    
+    name_bootstrap_map[name.to_sym] || name.to_s
+  end
+
+  def render_flash_messages
+    if flash.present?
+      render '/outpost/shared/flash_messages', flash: flash
+    end
+  end
+
+  def render_breadcrumbs
+    if breadcrumbs.present?
+      render '/outpost/shared/breadcrumbs', breadcrumbs: breadcrumbs
+    end
+  end
+
+  def render_navigation
+    render '/outpost/shared/navigation', current_user: current_user
+  end
+
+  # Public: Place a modal anywhere with a button to toggle it.
+  # 
+  # options - (Hash) Options to pass into the modal template. Useful for 
+  #           CSS ID, and modal title.
+  # block   - The block that gets captured and rendered inside of the modal.
+  #
+  # Returns String of rendered modal and toggle button.
+  def modal_toggle(options={}, &block)
+    render "/outpost/shared/modal", options: options, body: capture(&block)
+  end
+end

data/app/helpers/render_helper.rb

@@ -0,0 +1,41 @@
+module RenderHelper
+  # Public: Render the table wrapper.
+  #
+  # records - (Array) Records that are being represented in the table.
+  # model   - (Class) The ActiveRecord model for this table.
+  # block   - The rendered table. Should return a String.
+  #
+  # Examples
+  #
+  #   <%= list_table @posts, Post do %>
+  #     <table>...</table>
+  #   <% end %>
+  #
+  # Returns a String of the table, or a message if no records are present.
+  def list_table(records, model, &block)
+    render '/outpost/shared/list_table', 
+      :model   => model, 
+      :records => records, 
+      :table   => capture(&block)
+  end
+
+  # Public: Render a fieldset.
+  #
+  # title - (String) The title of this fieldset. If +nil+ is passed
+  #         in, then no legend will be rendered, and the fieldset block
+  #         will not be added to the sidebar sections.
+  # block - The body of the fieldset. Should return a String.
+  #
+  # Examples
+  #
+  #   <%= form_block "Publishing" do %>
+  #     <input type="text">...
+  #   <% end %>
+  #
+  # Returns a String of the fieldset.
+  def form_block(title="", &block)
+    render "/outpost/shared/form_block", 
+      :title => title, 
+      :body  => capture(&block)
+  end
+end

data/app/helpers/utility_helper.rb

@@ -0,0 +1,136 @@
+module UtilityHelper
+    # Public: Format a DateTime by keyword.
+  #
+  # date    - (DateTime) The date to format.
+  # options - (Hash) A hash of options (default: {}):
+  #           :with   - (String) The custom strftime string to use to
+  #                     format the date.
+  #           :format - (String) The format to use. Options are:
+  #                     * "iso" (2012-10-11)
+  #                     * "full_date" (October 11th, 2011)
+  #                     * "event" (Wednesday, October 11)
+  #                     * "short_date" (Oct 11, 2011)
+  #           :time   - (Boolean) Whether or not to show the time.
+  #
+  # Examples
+  #
+  #   format_date(Time.now, format: "iso", time: true)
+  #   # => "2013-03-13,  1:10pm"
+  #
+  #   format_date(Time.now, with: "%D")
+  #   # => "03/13/13"
+  #
+  #   format_date(Time.now)
+  #   # =>  "Mar 13, 2013"
+  #
+  # Returns String of the formatted date
+  def format_date(date, options={})
+    return nil if !date.respond_to?(:strftime)
+    
+    format_str = options[:with] if options[:with].present?
+
+    format_str ||= case options[:format].to_s
+      when "iso"       then "%F"
+      when "full_date" then "%B #{date.day.ordinalize}, %Y"
+      when "event"     then "%A, %B %-d"
+      else "%b %-d, %Y"
+    end
+    
+    format_str += ", %l:%M%P" if options[:time] == true
+
+    date.strftime(format_str)
+  end
+
+  # Public: Render a block of content or fallback to a message.
+  #
+  # records - (Array) The list of records to check.
+  # options - (Hash) A hash of options (default: {}):
+  #           :message - (String) The fallback message to display.
+  #           :title   - (String) The title of the collection.
+  # block   - The block to capture if the collection is present.
+  #
+  # Examples
+  #
+  #   records = []
+  #   any_to_list? records, message: "Empty!" do
+  #     "Hidden"
+  #   end
+  #   # => "Empty!"
+  #
+  #   records = [1, 2, 3]
+  #   any_to_list? records, message: "Empty!" do
+  #     "Numbers!"
+  #   end
+  #   # => "Numbers!"
+  #
+  # Returns String of the captured block.
+  def any_to_list?(records, options={}, &block)
+    if records.present?
+      return capture(&block)
+    else
+      if options[:message].blank?
+        if options[:title].present?
+          options[:message] = "There are currently no #{options[:title]}"
+        else
+          options[:message] = "There is nothing here to list."
+        end
+      end
+
+      return options[:message].html_safe
+    end
+  end
+
+  # Public: Set the first part of the page title.
+  #
+  # elements - Zero or more strings to prepend onto the page title.
+  #            The final argument can optionally be hash:
+  #            :separator - (String) The separator to use between 
+  #                         elements (default: " | ").
+  # 
+  # Examples
+  #
+  #   set_page_title "Events", "Forum", separator: " :: "
+  #   # => "Events :: Forum"
+  #
+  # Returns String of the first element, meant to allow you to use this
+  # method to add to the page title and display a header at the same time.
+  def add_to_page_title(*elements)
+    @TITLE_ELEMENTS ||= []
+    @TITLE_ELEMENTS += elements
+    elements.first
+  end
+
+  # Public: Generate the full page title.
+  #
+  # last_element - (String) The string that will be appendended onto the 
+  #                rest of the title.
+  # separator    - (String) The separator to use between the title and the last
+  #                element (default: " | ").
+  #
+  # Examples
+  #
+  #   content_for(:page_title) # => "Home"
+  #   page_title("KPCC", "::")
+  #   # => "Home :: KPCC"
+  #
+  # Returns String of the full title.
+  def page_title(separator=" | ")
+    @TITLE_ELEMENTS.compact.join(separator).html_safe
+  end
+
+  # Public: Render pure json from a partial.
+  # This helper is intended to be used to render jbuilder templates.
+
+  # path     - (String) The path to the json partial.
+  # location - (Hash) A hash of locals to pass directly to the partial
+  #            (default: {}).
+  #
+  # Examples
+  #
+  #   render_json('api/private/v1/posts/collection', posts: @posts)
+  #
+  # Returns String of a JSON object.
+  def render_json(path, locals={})
+    raw(j(render(partial: path, formats: [:json], locals: locals)))
+  end
+end

data/app/inputs/date_time_input.rb

@@ -0,0 +1,12 @@
+##
+# DateTimeInput
+#
+# Just renders a normal text field instead of trying to
+# be a date selector. The date_time_input javascript will
+# take care of filling it in.
+#
+class DateTimeInput < SimpleForm::Inputs::Base
+  def input
+    @builder.text_field(attribute_name, input_html_options)
+  end
+end

data/app/models/permission.rb

@@ -0,0 +1,18 @@
+class Permission < ActiveRecord::Base
+  outpost_model
+  
+  #-------------------
+  # Association
+  has_many :user_permissions
+  has_many :users, class_name: Outpost.config.user_class, through: :user_permissions, dependent: :destroy
+  
+  #-------------------
+  # Validation
+  validates :resource, uniqueness: true
+  
+  #-------------------
+  
+  def title
+    self.resource.titleize
+  end
+end

data/app/models/user_permission.rb

@@ -0,0 +1,4 @@
+class UserPermission < ActiveRecord::Base
+  belongs_to :user, class_name: Outpost.user_class
+  belongs_to :permission
+end

data/app/views/kaminari/bootstrap/_first_page.html.erb

@@ -0,0 +1,3 @@
+<li>
+  <%= link_to_unless current_page.first?, raw(t 'views.pagination.first'), url, :remote => remote %>
+</li>

data/app/views/kaminari/bootstrap/_gap.html.erb

@@ -0,0 +1,3 @@
+<li class="disabled">
+  <%= link_to raw(t 'views.pagination.truncate'), '#' %>
+</li>

data/app/views/kaminari/bootstrap/_last_page.html.erb

@@ -0,0 +1,3 @@
+<li>
+  <%= link_to_unless current_page.last?, raw(t 'views.pagination.last'), url, {:remote => remote} %>
+</li>

data/app/views/kaminari/bootstrap/_next_page.html.erb

@@ -0,0 +1,3 @@
+<li>
+  <%= link_to_unless current_page.last?, raw(t 'views.pagination.next'), url, :rel => 'next', :remote => remote %>
+</li>

data/app/views/kaminari/bootstrap/_page.html.erb

@@ -0,0 +1,3 @@
+<li class="<%= 'active' if page.current? %>">
+  <%= link_to page, page.current? ? '#' : url, {:remote => remote, :rel => page.next? ? 'next' : page.prev? ? 'prev' : nil} %>
+</li>

data/app/views/kaminari/bootstrap/_paginator.html.erb

@@ -0,0 +1,17 @@
+<%= paginator.render do -%>
+  <div class="pagination">
+    <ul>
+      <%= first_page_tag unless current_page.first? %>
+      <%= prev_page_tag unless current_page.first? %>
+      <% each_page do |page| -%>
+        <% if page.left_outer? || page.right_outer? || page.inside_window? -%>
+          <%= page_tag page %>
+        <% elsif !page.was_truncated? -%>
+          <%= gap_tag %>
+        <% end -%>
+      <% end -%>
+      <%= next_page_tag unless current_page.last? %>
+      <%= last_page_tag unless current_page.last? %>
+    </ul>
+  </div>
+<% end -%>

data/app/views/kaminari/bootstrap/_prev_page.html.erb

@@ -0,0 +1,3 @@
+<li>
+  <%= link_to_unless current_page.first?, raw(t 'views.pagination.previous'), url, :rel => 'prev', :remote => remote %>
+</li>

data/app/views/layouts/outpost/application.html.erb

@@ -0,0 +1,101 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <% add_to_page_title "Outpost" %>
+  <title><%= page_title %></title>
+  <%= stylesheet_link_tag "outpost/application" %>
+  <%= javascript_include_tag "outpost/application" %>
+  
+  <link rel="shortcut icon" href="/favicon.ico" />
+  <%= csrf_meta_tags %>
+</head>
+<body>
+
+<div class="navbar navbar-fixed-top navbar-inverse">
+  <div class="navbar-inner">
+    <div class="container">
+      <a href="<%=outpost_root_path%>" class="brand">Outpost</a>
+      
+      <% if current_user %>
+        <ul class="nav">
+          
+          <!-- Full Navigation -->
+          <li class="dropdown">
+            <a href="#" class="dropdown-toggle" data-toggle="dropdown"><i class="icon-align-justify icon-white"></i> Navigation <b class="caret"></b></a>
+            <% models = current_user.allowed_resources.sort_by(&:name) %>
+            <% per_col = 20 %>
+            <% cols = (models.size.to_f / per_col.to_f).ceil %>
+
+            <ul class="dropdown-menu cms-nav" style="width:<%= cols * 400 + cols * 10 %>px">
+              <% models.each_with_index do |model, index| %>
+                <% if index % per_col == 0 %>
+                  <div class="grouper">
+                <% end %>
+                
+                <li>
+                  <a href="<%=model.admin_index_path%>">
+                    <%= model.name.titleize.pluralize %>
+                  </a>
+                  
+                  <div class="btn-links">
+                    <% if model.respond_to?(:admin_new_path) %>
+                      <a class="add btn btn-mini" href="<%=model.admin_new_path%>"><i class="icon-plus-sign"></i> Add</a>
+                    <% end %>
+                  </div>
+                </li>
+                
+                <% if index % per_col == per_col - 1 or model == models.last %>
+                  </div>
+                <% end %>
+                
+              <% end %>
+            </ul> <!-- dropdown-menu -->
+          </li> <!-- dropdown -->
+        </ul> <!-- nav -->
+
+        <ul class="nav pull-right">
+          <li class="dropdown">
+            <a href="#" class="dropdown-toggle" data-toggle="dropdown"><i class='icon-user icon-white'></i> <%= current_user.name %> <b class="caret"></b></a>
+            <ul class="dropdown-menu">
+              <li><%= link_to "Logout", outpost_logout_path, id: "logout" %></li>
+            </ul>
+          </li>
+        </ul>
+      <% else %>
+        <ul class="nav pull-right">
+          <li><%= link_to "Login", outpost_login_path %></li>
+        </ul>
+      <% end %>
+    </div>
+  </div>
+</div>
+
+<% if current_user %>
+  <div class="navbar navbar-fixed-top fixed-breadcrumbs">
+    <% if breadcrumbs.present? %>
+      <div class="breadcrumb unstyled">
+        <div class="container">
+          <%= render_breadcrumbs %>
+        </div>
+      </div>
+    <% end %>
+  </div> <!-- navbar -->
+<% end %>
+
+<div id="main" class="container">
+  <div class="row">
+    <div class="span<%= content_for?(:sidebar) ? "9" : "12" %>">
+      <%= render_flash_messages %>
+      <%= yield %>
+    </div>
+    <% if content_for?(:sidebar) %>
+      <div class="span3" id="admin-sidebar">
+        <%= yield :sidebar %>
+      </div>
+    <% end %>
+  </div> <!-- row -->
+</div> <!-- container main -->
+
+<%= yield :footer %>
+</body>
+</html>

data/app/views/layouts/outpost/minimal.html.erb

@@ -0,0 +1,26 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <% add_to_page_title "Outpost" %>
+  <title><%= page_title %></title>
+  <%= stylesheet_link_tag "outpost/application" %>
+  <%= javascript_include_tag "outpost/application" %>
+  
+  <%= csrf_meta_tags %>
+</head>
+<body>
+
+  <div class="navbar navbar-fixed-top navbar-inverse">
+  <div class="navbar-inner">
+    <div class="container-fluid">
+      <a href="<%=outpost_root_path%>" class="brand">Outpost</a>
+    </div>
+  </div>
+</div>
+
+<div id="main" class="container-fluid">
+  <%= yield %>
+</div> <!-- container main -->
+
+</body>
+</html>

data/app/views/outpost/errors/error_404.html.erb

@@ -0,0 +1 @@
+<h3>Not Found.</h3>