slices 1.0.0

data/app/helpers/navigation_helper.rb

@@ -0,0 +1,195 @@
+# This module provices helpers for rendering common navigation from page structure
+#
+#   primary_navigation
+#   # =>  <ul id="primary_navigation">
+#   # =>    <li class="first active nav-home"><a href="/">Home page</a></li>
+#   # =>    <li class="nav-about"><a href="/about">About us</a></li>
+#   # =>    <li class="last nav-blog"><a href="/blog">Blog</a></li>
+#   # =>  </ul>
+#
+module NavigationHelper
+
+  #   primary_navigation
+  #   # =>  <ul id="primary_navigation">
+  #   # =>    <li class="first active nav-home"><a href="/">Home page</a></li>
+  #   # =>    <li class="nav-about"><a href="/about">About us</a></li>
+  #   # =>    <li class="nav-parent"><a href="/parent">Parent</a></li>
+  #   # =>    <li class="nav-aunt"><a href="/aunt">Aunt</a></li>
+  #   # =>    <li class="nav-uncle"><a href="/uncle">Uncle</a></li>
+  #   # =>    <li class="last nav-blog"><a href="/blog">Blog</a></li>
+  #   # =>  </ul>
+  #
+  # @param [String]       id        Dom id of the surronding ul element
+  # @return [String]
+  #
+  def primary_navigation(id = 'primary_navigation')
+    cache 'page/navigation/' + id + '/' + @page.id.to_s do
+      benchmark 'Rendered primary_navigation' do
+        nav = navigation(page: Page.home, depth: 1, id: id)
+        safe_concat nav
+        ''
+      end
+    end
+  end
+
+  # Render the secondary navigation if the current page isn't already rendered
+  # in the primary navigation.
+  #
+  #   secondary_navigaiton :depth => 10
+  #   # =>  <ul id="secondary_navigation">
+  #   # =>    <li class="first nav-parent-child"><a href="/parent/child">Child</a>
+  #   # =>      <ul>
+  #   # =>        <li class="first last nav-parent-child-grand-child"><a href="/parent/child/grand-child">Grand child</a></li>
+  #   # =>      </ul>
+  #   # =>    </li>
+  #   # =>    <li class="nav-parent-sibling"><a href="/parent/sibling">Sibling</a></li>
+  #   # =>    <li class="last nav-parent-youngest"><a href="/parent/youngest">Youngest</a></li>
+  #   # =>  </ul>
+  #
+  # @param  [Hash]       options
+  # @option options [Integer] :depth (1)                    Number of levels to render
+  # @option options [Integer] :id ('secondary_navigation')  Id of surrounding UL
+  # @return [String]
+  #
+  def secondary_navigation(options = {})
+    cache 'page/navigation/secondary/' + @page.id.to_s do
+      benchmark 'Rendered secondary_navigation' do
+        secondary_ancestors = (@page.ancestors[-2] || @page).navigable_children
+        nav = if secondary_ancestors.empty? || @page.home?
+                ''
+              else
+                page = secondary_ancestors.first
+                navigation(options.reverse_merge(page: page, id: 'secondary_navigation'))
+              end
+        safe_concat nav
+        ''
+      end
+    end
+  end
+
+  # Use the page structure to render nested navigation, each visible page is
+  # rendered in a +li+ element with child pages in a nested +ul+
+  #
+  # The first +li+ in a +ul+ has the class +first+, the last +li+ in a +ul+ has
+  # the class +last+ and the current page has the class +active+.
+  #
+  # Each +li+ has a class identifier generated from it's path and prefixed with
+  # +nav+, for example a page with path +/parent/child+ would have the class
+  # +nav-parent-child+. This identifier is a class is to avoid duplicate +ids+
+  # if multiple navigation elements are used on a page.
+  #
+  # The home page is assumed to be at the same level as it's children.
+  #
+  #   navigation depth: 4, page: Page.home, id: 'navigation'
+  #   # =>  <ul id="navigation">
+  #   # =>    <li class="first nav-home"><a href="/">Home page</a></li>
+  #   # =>    <li class="nav-about"><a href="/about">About us</a></li>
+  #   # =>    <li class="active nav-parent">
+  #   # =>      <a href="/parent">Parent</a>
+  #   # =>      <ul>
+  #   # =>        <li class="first nav-parent-child">
+  #   # =>          <a href="/parent/child">Child</a>
+  #   # =>          <ul>
+  #   # =>            <li class="first last nav-parent-child-grand-child"><a href="/parent/child/grand-child">Grand child</a></li>
+  #   # =>          </ul>
+  #   # =>        </li>
+  #   # =>        <li class="nav-parent-sibling"><a href="/parent/sibling">Sibling</a></li>
+  #   # =>        <li class="last nav-parent-youngest"><a href="/parent/youngest">Youngest</a></li>
+  #   # =>      </ul>
+  #   # =>    </li>
+  #   # =>    <li class="nav-aunt"><a href="/aunt">Aunt</a></li>
+  #   # =>    <li class="nav-uncle"><a href="/uncle">Uncle</a></li>
+  #   # =>    <li class="last nav-blog"><a href="/blog">Blog</a></li>
+  #   # =>  </ul>
+  #
+  #   navigation depth: 1, page: Page.home
+  #   # =>  <ul>
+  #   # =>    <li class="first nav-home"><a href="/">Home page</a></li>
+  #   # =>    <li class="nav-about"><a href="/about">About us</a></li>
+  #   # =>    <li class="active nav-parent"><a href="/parent">Parent</a></li>
+  #   # =>    <li class="nav-aunt"><a href="/aunt">Aunt</a></li>
+  #   # =>    <li class="nav-uncle"><a href="/uncle">Uncle</a></li>
+  #   # =>    <li class="last nav-blog"><a href="/blog">Blog</a></li>
+  #   # =>  </ul>
+  #
+  # @param  [Hash]       options
+  # @option options [Integer] :depth (1)              Number of levels to render
+  # @option options [Integer] :page  (current_page)   Page to start rendering
+  # @option options [Integer] :id                     Id of surrounding UL
+  # @option options [Integer] :class                  Class of surrounding UL
+  # @return [String]
+  #
+  def navigation(options = {})
+    options.reverse_merge!( page: @page, depth: 1 )
+    page = options[:page]
+    children = page.home? ? page.navigable_children : page.parent.navigable_children
+    html = (is_home_and_shown_in_nav?(page) ? nav_link(Page.home) : '').html_safe
+    html << list_items(children, options[:depth])
+    content_tag(:ul, html, options.slice(:id, :class))
+  end
+
+  # Link to a +page+, using the page name as the link name.
+  #
+  #   link_to Page.find_by_path('/parent')
+  #   # => <a href="/parent">Parent</a>
+  #
+  # @param  [Page]       page                         Page to link to
+  # @return [String]
+  #
+  def link_to_page(page)
+    link_to(page.name, page.navigation_path)
+  end
+
+  private
+
+  def list_items(pages, depth)
+    depth -= 1
+    pages.inject(''.html_safe) do |html, page|
+      html << nav_link(page, depth)
+    end
+  end
+
+  def nav_link(page, depth = 0)
+    content_tag(:li, class: nav_list_item_class(page)) do
+      html = link_to_page(page)
+      if (depth > 0) && page.navigable_children.any?
+        html << content_tag(:ul, list_items(page.navigable_children, depth))
+      end
+      html
+    end + "\n"
+  end
+
+  def is_home_and_shown_in_nav?(page)
+    page.home? && page.show_in_nav?
+  end
+
+  def is_first_sibling?(page)
+    if page.home? || is_home_and_shown_in_nav?(page.parent)
+      page.home?
+    else
+      page.first_sibling?
+    end
+  end
+
+  def is_active_sibling?(page)
+    if page.home?
+      page == @page
+    else
+      (page == @page) || @page.descended_from?(page)
+    end
+  end
+
+  def nav_list_item_class(page)
+    classes = []
+    classes << 'first' if is_first_sibling?(page)
+    classes << 'active' if is_active_sibling?(page)
+    classes << 'last' if page.last_sibling?
+    classes << nav_list_identifier(page)
+    classes.empty? ? nil : classes.join(' ')
+  end
+
+  def nav_list_identifier(page)
+    page.home? ? 'nav-home' : ('nav' + page.path.gsub('/', '-'))
+  end
+end
+

data/app/helpers/pages_helper.rb

@@ -0,0 +1,119 @@
+# This module provides helper methods rendering pages and slices.
+module PagesHelper
+  include NavigationHelper
+  include AssetsHelper
+
+  # Defines and renders a container in a layout.
+  #
+  # For example adding the following to a layout will create two containers called
+  # container_one and container_two
+  #
+  #   <article class="container_one">
+  #     <%= container "container_one" %>
+  #   </article>
+  #   <aside class="container_two">
+  #     <%= container "container_two" %>
+  #   </aside>
+  #
+  # @param [String]   container     Name of container
+  # @return [String]                Contents of rendered slices in container
+  #
+  def container(container, options = {})
+    if @slice_renderer.present?
+      @slice_renderer.render_container(container)
+    end
+  end
+
+  # Returns the text with all the Textile[http://www.textism.com/tools/textile] codes turned into HTML tags.
+  #
+  # @param [String] text              Text to be textilized
+  # @return [String]                  Textilized string
+  #
+  def textilize(text)
+    unless text.blank?
+      red_cloth = RedCloth.new(text)
+      red_cloth.no_span_caps = true
+      red_cloth.to_html.html_safe
+    end
+  end
+
+  # Converts markdown to html.
+  #
+  # @param [String] text
+  # @return [String]
+  #
+  def markdown(text)
+    return if text.blank?
+    renderer = Redcarpet::Render::HTML.new(hard_wrap: true)
+    parser = Redcarpet::Markdown.new(renderer)
+    parser.render(text).html_safe
+  end
+
+  # Quick link to edit the current page in the CMS
+  #
+  # @return [String]                      Edit in CMS link
+  #
+  def edit_in_cms
+    if admin_signed_in?
+      links = []
+      links << link_to("Edit #{@page.class.to_s.underscore.humanize} in CMS", admin_page_path(@page), target: '_blank')
+      links << link_to('Edit template in CMS', admin_page_path(@page.parent, entries: 1), target: '_blank') if @page.entry?
+      content = links.collect {|l| content_tag(:p, l) }.join.html_safe
+
+      content_tag(:div, content, id: 'edit_in_cms')
+    end
+  end
+
+  # Translates the key and return an empty string if there is no translation.
+  #
+  #
+  # @param [String] key                   Translation key
+  # @param [Hash]   options
+  # @return [String]                      Translated key
+  #
+  def if_t(key, options = {})
+    translate(key, options) || ''
+  end
+
+  # Asynchronous Google Analytics Tracking Code. Only added in production when the
+  # user is not signed into the CMS.
+  #
+  #     google_analytics_tracking_code('ABC132')
+  #
+  # To track multiple accounts use the following
+  #
+  #     google_analytics_tracking_code('ABC132', 'DEF546')
+  #
+  # @param [Array, String]  web_property_ids        Web property ID(s)
+  # @return [String]                                GA embed code
+  #
+  def google_analytics_tracking_code(*web_property_ids)
+    if web_property_ids.first.present? && add_tracking_code?
+      analytics_que = "['_setAccount', '#{web_property_ids.shift}'], ['_trackPageview'], ['_trackPageLoadTime']"
+      web_property_ids.each_with_index do |web_property_id, index|
+        account = (index + 98).chr
+        analytics_que << ", ['#{account}._setAccount', '#{web_property_id}'], ['#{account}._trackPageview'], ['#{account}._trackPageLoadTime']"
+      end
+
+      javascript_tag <<-JAVASCRIPT
+var _gaq = _gaq || [];
+_gaq.push(#{analytics_que});
+(function() {
+  var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+  ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+  var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+})();
+      JAVASCRIPT
+    end
+  end
+
+  # If a tracking code should be added to the page. Returns +true+ when the app
+  # is in production mode and the user is not signed into the CMS
+  #
+  # @return [Boolean]
+  #
+  def add_tracking_code?
+    Rails.env.production? && ! admin_signed_in?
+  end
+end
+

data/app/models/admin.rb

@@ -0,0 +1,34 @@
+class Admin
+  include Mongoid::Document
+  include MongoSearch::Searchable
+
+  field :name
+  field :super_user, type: Boolean, :default => false
+
+  text_search_in :name, :email
+
+  validates_uniqueness_of :email, case_sensitive: false, scope: :site_id
+
+  validates_presence_of :email
+  attr_accessible :email, :password, :password_confirmation, :name
+
+  devise :database_authenticatable, :recoverable, :rememberable,
+    :trackable, :validatable, :omniauthable
+
+  def self.find_for_domain(domain)
+    where(email: /@#{domain}$/).first
+  end
+
+  def super?
+    self.super_user == true
+  end
+
+  def as_json(options)
+    super(options).tap do |json|
+      if current_admin = options[:current_admin]
+        json[:current_admin] = current_admin.id == id
+      end
+    end
+  end
+end
+

data/app/models/asset.rb

@@ -0,0 +1,211 @@
+class Asset
+  include Mongoid::Document
+  include Mongoid::Timestamps
+  include MongoSearch::Searchable
+  include Mongoid::Paperclip
+
+  IMAGE_REGEX = /(jpg|jpeg|gif|png)/
+  NORMALIZED_EXTENSIONS = { ".jpeg" => ".jpg" }
+
+  validates_with PaperclipValidator
+
+  field :file_content_type, type: String
+  field :file_file_name, type: String
+  field :file_file_size, type: Integer
+  field :file_fingerprint, type: String
+  field :file_dimensions, type: Hash, default: {}
+
+  field :destroyed_at, type: Time
+  field :tags, type: String
+  field :page_cache, type: Array, default: []
+
+  text_search_in :file_file_name, :tags, :search_page_cache
+
+  has_mongoid_attached_file :file,
+    default_style:   :admin,
+    max_size:        50.megabytes,
+    url:             '/system/:attachment/:mon_year/:id/:style/:filename',
+    path:            ':rails_root/public:url',
+    only_process:    [:admin],
+    styles:          Slices::Config.asset_styles,
+    convert_options: Slices::Config.asset_convert_options
+
+  before_file_post_process :is_image?
+  after_file_post_process :store_dimensions, if: :is_image?
+  before_save :reset_file_dimensions!, if: :file_fingerprint_changed?
+  before_save :rename_file
+
+  has_and_belongs_to_many :pages
+
+  index(
+    [
+      [ :destroyed_at, Mongo::ASCENDING ],
+      [ :created_at, Mongo::DESCENDING ]
+    ]
+  )
+  index :file_fingerprint
+  index :_keywords
+
+  def self.make(*args)
+    Slices::Asset::Maker.run(*args)
+  end
+
+  def self.search_for(term = nil)
+    if term.present?
+      all.ordered_active.text_search term
+    else
+      all.ordered_active
+    end
+  end
+
+  def self.ordered_active
+    where(destroyed_at: nil).desc(:created_at)
+  end
+
+  def as_json(options = nil)
+    {
+      id:                id.to_s,
+      name:              name,
+      file_file_name:    file_file_name,
+      file_file_size:    file_file_size,
+      file_content_type: file_content_type,
+      asset_url:         admin_image_url,
+      original_url:      file.url(:original),
+      errors:            errors,
+      created_at:        created_at,
+      tags:              tags,
+      pages:             page_cache
+    }
+  end
+
+  # Returns the url for the asset style. The style is created if it has not already
+  # been generated
+  #
+  # @param [Symbol] style     The asset style is defined in Slice::Config.asset_styles
+  def url_for(style)
+    reprocess_for(style)
+    file.url(style)
+  end
+
+  # Returns the dimensions the asset style. The style is created if it has not already
+  # been generated
+  #
+  #   asset.dimensions_for(:main)
+  #   "100x100"
+  #
+  # @param [Symbol] style     The asset style is defined in Slice::Config.asset_styles
+  def dimensions_for(style)
+    reprocess_for(style)
+    file_dimensions[style.to_s]
+  end
+
+  def reprocess_for(style)
+    if file.styles.has_key?(style) && ! file_dimensions.has_key?(style.to_s)
+      file.reprocess!(style)
+      save
+    end
+  rescue Errors::NotIdentifiedByImageMagickError, Errno::ENOENT
+  end
+
+  def reprocess_for!(style)
+    file.clear(style)
+    file_dimensions.delete(style.to_s)
+    file.flush_deletes
+    reprocess_for(style)
+  end
+
+  def store_dimensions
+    file.queued_for_write.each do |style, adapter|
+      geometry = Paperclip::Geometry.from_file(adapter)
+      self.file_dimensions[style.to_s] = geometry.to_s
+    end
+  end
+
+  def is_image?
+    file_content_type.present? && file_content_type.match(IMAGE_REGEX).present?
+  end
+
+  def file_extension
+    if file_file_name.present?
+      file_file_name.split('.').last.downcase
+    else
+      ''
+    end
+  end
+
+  def admin_image_url
+    if !new_record? && is_image?
+      url_for(:admin)
+    end
+  end
+
+  def soft_destroy!
+    update_attributes!(destroyed_at: Time.now)
+  end
+
+  def soft_destroyed?
+    destroyed_at.present?
+  end
+
+  def soft_restore!
+    update_attributes!(destroyed_at: nil)
+  end
+
+  def name
+    @new_name || file_file_name
+  end
+
+  def name=(new_name)
+    @new_name = new_name
+  end
+
+  def update_page_cache
+    self.page_cache = pages.collect do |page|
+      { id: page.id, name: page.name, path: page.path }
+    end
+  end
+
+  def search_page_cache
+    page_cache.inject([]) do |memo, page|
+      memo << page['name']
+      memo << page['path']
+    end.join ' '
+  end
+
+  # Reset all stored file dimensions except for the origin and admin styles,
+  # this is used when a new version of an asset is uploaded
+  #
+  def reset_file_dimensions!
+    self.file_dimensions.keys.each do |key|
+      next if key == 'original' || key == 'admin'
+      self.file_dimensions.delete key
+    end
+  end
+
+  private
+
+  def rename_file
+    return if @new_name.blank?
+
+    new_file_name = sanitize(@new_name)
+    Slices::Asset::Rename.run(file, new_file_name)
+    file.instance_write(:file_name, new_file_name)
+    set_keywords
+    @new_name = nil
+  end
+
+  def sanitize(filename)
+    file.send(:cleanup_filename, filename).tap do |name|
+      if self.file && self.file.original_filename
+        extension = normalized_extension
+        name << extension unless name.ends_with?(extension)
+      end
+    end
+  end
+
+  def normalized_extension
+    extname = File.extname(file.original_filename).downcase
+    NORMALIZED_EXTENSIONS.fetch(extname, extname)
+  end
+
+end