refinerycms 0.9.7.15 → 0.9.8

data/vendor/refinerycms/images/config/locales/zh-CN.yml

@@ -0,0 +1,35 @@
+zh-CN:
+  plugins:
+    refinery_images:
+      title: Images
+  no_file_chosen: was not attached. Please attach a valid image.
+  image_should_be_smaller_than_max_image_size: Files should be smaller than %{max_image_size} in size
+  image_must_be_these_formats: Your image must be either a JPG, PNG or GIF
+  admin:
+    images:
+      form:
+        image: Image
+        use_current_image: Use current image
+        or: or
+        replace_image: " replace it with this one..."
+        current_image: Current Image
+        maximum_image_size: The maximum image size is %{megabytes} megabytes.
+      index:
+        create_new_image: Create New Image
+        no_images_yet: There are no images yet. Click "Create New Image" to add your first image.
+        view:
+          switch_to: Switch to %{view_name} view
+          list: list
+          grid: grid
+      grid_view:
+        view_live: View this image <br/><em>Opens in a new window</em>
+      existing_image:
+        button_text: Insert
+        resize_image: Resize the image?
+        size: Size
+      insert:
+        existing_image: Existing Image
+        new_image: New Image
+  activerecord:
+    models:
+      image: image

data/vendor/refinerycms/images/config/routes.rb

@@ -0,0 +1,12 @@
+Refinery::Application.routes.draw do
+  scope(:path => 'refinery', :as => 'admin', :module => 'admin') do
+    resources :images do
+      collection do
+        get :insert
+      end
+      member do
+        get :url
+      end
+    end
+  end
+end

data/vendor/refinerycms/images/lib/images.rb

@@ -0,0 +1,59 @@
+require 'rack/cache'
+require 'dragonfly'
+require 'refinery'
+
+module Refinery
+  module Images
+    class Engine < Rails::Engine
+      initializer 'images-with-dragonfly' do |app|
+        app_images = Dragonfly[:images]
+        app_images.configure_with(:rmagick)
+        app_images.configure_with(:rails) do |c|
+          c.datastore.root_path = Rails.root.join('public', 'system', 'images').to_s
+          c.url_path_prefix = '/system/images'
+          if RefinerySetting.table_exists?
+            c.secret = RefinerySetting.find_or_set(:dragonfly_secret,
+                                                   Array.new(24) { rand(256) }.pack('C*').unpack('H*').first)
+          end
+        end
+        app_images.configure_with(:heroku, ENV['S3_BUCKET']) if Refinery.s3_backend
+
+        app_images.define_macro(ActiveRecord::Base, :image_accessor)
+        app_images.analyser.register(Dragonfly::Analysis::RMagickAnalyser)
+        app_images.analyser.register(Dragonfly::Analysis::FileCommandAnalyser)
+
+        app_images.instance_eval %{
+          def url_for(job, *args)
+            image_url = nil
+            if (fetcher = job.steps.detect{|s| s.class.step_name == :fetch}).present?
+              image_url = ['', fetcher.uid.to_s.split('/').last].join('/')
+            end
+            "\#{super}\#{image_url}"
+          end
+        }
+
+        ### Extend active record ###
+
+        app.config.middleware.insert_after 'Rack::Lock', 'Dragonfly::Middleware', :images, '/system/images'
+
+        app.config.middleware.insert_before 'Dragonfly::Middleware', 'Rack::Cache', {
+          :verbose     => true,
+          :metastore   => "file:#{Rails.root.join('tmp', 'dragonfly', 'cache', 'meta')}",
+          :entitystore => "file:#{Rails.root.join('tmp', 'dragonfly', 'cache', 'body')}"
+        }
+      end
+
+      config.after_initialize do
+        Refinery::Plugin.register do |plugin|
+          plugin.name = "refinery_images"
+          plugin.directory = "images"
+          plugin.version = %q{0.9.8}
+          plugin.menu_match = /(refinery|admin)\/image(_dialog)?s$/
+          plugin.activity = {
+            :class => Image
+          }
+        end
+      end
+    end
+  end
+end

data/vendor/refinerycms/images/lib/tasks/images.rake

@@ -0,0 +1,50 @@
+namespace :images do
+
+  desc "Regenerate all thumbnails. Useful for when you've changed size or cropping on the images after images have been uploaded."
+  task :regenerate => :environment do
+=begin
+    thumbnails_size = Image.count(:conditions => "parent_id IS NOT NULL")
+    puts "Preparing to delete #{thumbnails_size} generated thumbnails"
+
+    if Image.destroy_all("parent_id IS NOT null")
+      puts "--> #{thumbnails_size} thumbnails deleted"
+    else
+      puts "There may have been a problem deleting the thumbnails."
+    end
+
+    originals = Image.originals
+    puts "Preparing to regenerate thumbnails for #{originals.size} images"
+
+    originals.each do |image|
+      begin
+        image.rebuild_thumbnails!
+      rescue Exception => e
+        puts "--> ERROR image #{image.id} could not be saved because #{e.message}"
+      end
+    end
+    puts "Image regeneration complete."
+=end
+    puts "TODO: update task for Dragonfly"
+  end
+
+  desc "Update thumbnails. Useful for when you have added new thumbnail sizes and you just need to regenerate those without regenerating all the thumbnails again."
+  task :update => :environment do
+=begin
+  originals = Image.originals
+
+    puts "Preparing to update #{originals.size} images. This may take a few minutes. Please wait..."
+
+    originals.each do |image|
+      begin
+        image.rebuild_missing_thumbnails!
+      rescue Exception => e
+        puts "--> ERROR image #{image.id} could not be saved because #{e.message}"
+      end
+    end
+
+    puts "Thumbnail update complete."
+=end
+    puts "TODO: update task for Dragonfly"
+ end
+
+end

data/vendor/refinerycms/images/readme.md

@@ -0,0 +1,58 @@
+# Images
+
+![Refinery Images](http://refinerycms.com/system/images/0000/0616/images.png)
+
+## About
+
+All Refinery's images are stored in one place, the images plugin. You can customise what sized thumbnails are generated when an image is uploaded.
+
+Images and other file uploads are handled using [attachment_fu](http://github.com/technoweenie/attachment_fu)
+
+## Generating Thumbnails
+
+Refinery lets you generate a range of thumbnails when an image is uploaded so you can output this on a page in an appropriate size.
+
+To specify the sizes of your thumbnails edit the "Image Thumbnails" setting.
+
+This setting is stored as a serialized hash and is directly passed to [attachment_fu](http://github.com/technoweenie/attachment_fu)
+
+Here's what the default looks like
+
+    ---
+    :dialog_thumb: c106x106
+    :preview: c96x96
+    :medium: 225x255>
+    :large: 450x450>
+    :small: 110x110>
+    :grid: c135x135
+
+Refinery requires some of these, so you won't want to delete any, but add new ones to meet your design needs. Each thumbnail is not just a size guide but a [RMagick geometry string](http://www.imagemagick.org/RMagick/doc/imusage.html#geometry) that allows you to define min and max size too.
+
+Refinery also extends the [geometry string](http://www.imagemagick.org/RMagick/doc/imusage.html#geometry) support to allow cropping. Here's some examples
+
+    :grid: c135x135
+
+This will crop (_that's what the "c" stands for_) the grid thumbnail down to ``135x135`` exactly, without stretching the image.
+
+_Note: you will have to restart your web server after changing this setting for the changes to take effect._
+
+## Using a Thumbnail Size in Your View
+
+Take the default thumbnails above to use the ``:large`` thumbnail I would collect that image out of the database and apply it like this in my view:
+
+    <%= image_fu @image, :large %>
+
+``image_fu`` is a command we have created that automatically adds width and height attributes to the generated image so that web browsers render your pages more smoothly as they know in advance how big an image is going to be before it is fully downloaded.
+
+If I wanted to replace all the images inside a content section without the user having to resize images in the editor then I would use the built in ``content_fu`` command like this in my view:
+
+    <%= content_fu @page[:body], :large %>
+
+``content_fu`` is a command we have created that automatically changes all images with the url /system/images to use a particular thumbnail size. This makes it easy to protect your pages from having gigantic images inserted into them that blow out the design.
+
+## Related Settings
+
+### "Preferred Image View"
+
+Set to ``"grid"`` to get your images to display as a grid of thumbnails
+Set to ``"list"`` to get your images to display as a list with image titles.

data/vendor/refinerycms/pages/app/controllers/admin/pages_controller.rb

@@ -0,0 +1,71 @@
+class Admin::PagesController < Admin::BaseController
+
+  crudify :page,
+          :conditions => "parent_id IS NULL",
+          :order => "position ASC",
+          :include => [:parts, :slugs, :children, :parent],
+          :paging => false
+
+  before_filter :find_pages_for_parents_list, :only => [:new, :create, :edit, :update]
+  after_filter :expire_caching, :only => [:create, :update, :destroy, :update_positions]
+
+  rescue_from FriendlyId::ReservedError, :with => :show_errors_for_reserved_slug
+
+  def new
+    @page = Page.new
+    Page.default_parts.each_with_index do |page_part, index|
+      @page.parts << PagePart.new(:title => page_part, :position => index)
+    end
+  end
+
+protected
+  def expire_caching
+    expire_menu_fragment_caching
+    expire_action_caching
+  end
+
+  def expire_menu_fragment_caching
+    Rails.cache.delete("#{Refinery.base_cache_key}_menu_pages")
+    expire_fragment %r{#{RefinerySetting.find_or_set(:refinery_menu_cache_action_suffix, "site_menu")}}
+  end
+
+  def expire_action_caching
+    expire_fragment %r{.*/pages/.*}
+  end
+
+  # This finds all of the pages that could possibly be assigned as the current page's parent.
+  def find_pages_for_parents_list
+    @pages_for_parents_list = []
+    Page.find_all_by_parent_id(nil, :order => "position ASC").each do |page|
+      @pages_for_parents_list << page
+      @pages_for_parents_list += add_pages_branch_to_parents_list(page)
+    end
+    @pages_for_parents_list.flatten.compact!
+
+    # We need to remove all references to the current page or any of its decendants or we get a nightmare.
+    @pages_for_parents_list.reject! do |page|
+      page.id == @page.id or @page.descendants.include?(page)
+    end unless @page.nil? or @page.new_record?
+  end
+
+  def add_pages_branch_to_parents_list(page)
+    list = []
+    page.children.each do |child|
+      list << child
+      list += add_pages_branch_to_parents_list(child) if child.children.any?
+    end
+    list
+  end
+
+  def show_errors_for_reserved_slug(exception)
+    flash[:error] = "Sorry, but that title is a reserved system word."
+    if params[:action] == 'update'
+      find_page
+      render :edit
+    else
+      @page = Page.new(params[:page])
+      render :new
+    end
+  end
+
+end

data/vendor/refinerycms/pages/app/controllers/pages_controller.rb

@@ -0,0 +1,45 @@
+class PagesController < ApplicationController
+
+  caches_action :home, :show,
+                :cache_path => Proc.new { |c| "#{c.request.host_with_port}/views/pages/#{c.params[:path]}" },
+                :if => Proc.new { |c|
+                  c.send(:logged_in?) == false and
+                  (!RefinerySetting.table_exists? ||
+                    RefinerySetting.find_or_set(:page_caching_enabled, true, :scoping => 'pages'))
+                }
+
+  def home
+    error_404 unless (@page = Page.find_by_link_url("/", :include => [:parts, :slugs])).present?
+  end
+
+  # This action can be accessed normally, or as nested pages.
+  # Assuming a page named "mission" that is a child of "about",
+  # you can access the pages with the following URLs:
+  #
+  #   GET /pages/about
+  #   GET /about
+  #
+  #   GET /pages/mission
+  #   GET /about/mission
+  #
+  def show
+    @page = if params[:path]
+      Page.find(params[:path].split('/').last, :include => [:parts, :slugs])
+    else
+      Page.find(params[:id], :include => [:parts, :slugs])
+    end
+
+    if @page.try(:live?) or
+       (refinery_user? and
+        current_user.authorized_plugins.include?("refinery_pages"))
+      # if the admin wants this to be a "placeholder" page which goes to its first child, go to that instead.
+      if @page.skip_to_first_child
+        first_live_child = @page.children.find_by_draft(false, :order => "position ASC")
+        redirect_to first_live_child.url if first_live_child.present?
+      end
+    else
+      error_404
+    end
+  end
+
+end

data/vendor/refinerycms/pages/app/models/page.rb

@@ -0,0 +1,255 @@
+class Page < ActiveRecord::Base
+  validates :title, :presence => true
+
+  acts_as_tree :order => "position ASC",
+               :include => [:children, :slugs]
+
+  # Docs for friendly_id http://github.com/norman/friendly_id
+  has_friendly_id :title, :use_slug => true,
+                  :reserved_words => %w(index new session login logout users refinery admin images wymiframe)
+
+  has_many :parts,
+           :class_name => "PagePart",
+           :order => "position ASC",
+           :inverse_of => :page
+
+  accepts_nested_attributes_for :parts,
+                                :allow_destroy => true
+
+  # Docs for acts_as_indexed http://github.com/dougal/acts_as_indexed
+  acts_as_indexed :fields => [:title, :meta_keywords, :meta_description, :custom_title, :browser_title, :all_page_part_content]
+
+  before_destroy :deletable?
+  after_save :reposition_parts!
+  after_save :invalidate_child_cached_url
+
+  # when a dialog pops up to link to a page, how many pages per page should there be
+  PAGES_PER_DIALOG = 14
+
+  # when listing pages out in the admin area, how many pages should show per page
+  PAGES_PER_ADMIN_INDEX = 20
+
+  # when collecting the pages path how is each of the pages seperated?
+  PATH_SEPARATOR = " - "
+
+  # Am I allowed to delete this page?
+  # If a link_url is set we don't want to break the link so we don't allow them to delete
+  # If deletable is set to false then we don't allow this page to be deleted. These are often Refinery system pages
+  def deletable?
+    self.deletable && self.link_url.blank? and self.menu_match.blank?
+  end
+
+  # Repositions the child page_parts that belong to this page.
+  # This ensures that they are in the correct 0,1,2,3,4... etc order.
+  def reposition_parts!
+    self.parts.each_with_index do |part, index|
+      part.update_attribute(:position, index)
+    end
+  end
+
+  # Before destroying a page we check to see if it's a deletable page or not
+  # Refinery system pages are not deletable.
+  def destroy
+    if self.deletable?
+      super
+    else
+      unless Rails.env.test?
+        # give useful feedback when trying to delete from console
+        puts "This page is not deletable. Please use .destroy! if you really want it deleted "
+        puts "unset .link_url," if self.link_url.present?
+        puts "unset .menu_match," if self.menu_match.present?
+        puts "set .deletable to true" unless self.deletable
+      end
+
+      return false
+    end
+  end
+
+  # If you want to destroy a page that is set to be not deletable this is the way to do it.
+  def destroy!
+    self.menu_match = nil
+    self.link_url = nil
+    self.deletable = true
+
+    self.destroy
+  end
+
+  def indented_title
+    "#{"--" * self.ancestors.size} #{self.title}".chomp
+  end
+
+  # Used for the browser title to get the full path to this page
+  # It automatically prints out this page title and all of it's parent page titles joined by a PATH_SEPARATOR
+  def path(reverse = true)
+    unless self.parent.nil?
+      parts = [self.title, self.parent.path(reverse)]
+      parts.reverse! if reverse
+      parts.join(PATH_SEPARATOR)
+    else
+      self.title
+    end
+  end
+
+  # When this page is rendered in the navigation, where should it link?
+  # If a custom "link_url" is set, it uses that otherwise it defaults to a normal page URL.
+  # The "link_url" is often used to link to a plugin rather than a page.
+  #
+  # For example if I had a "Contact" page I don't want it to just render a contact us page
+  # I want it to show the Inquiries form so I can collect inquiries. So I would set the "link_url"
+  # to "/contact"
+  def url
+    if self.link_url.present?
+      link_url_localised?
+    elsif use_marketable_urls?
+      url_marketable
+    elsif self.to_param.present?
+      url_normal
+    end
+  end
+
+  def link_url_localised?
+    if self.link_url =~ /^\// and defined?(::Refinery::I18n) and ::Refinery::I18n.enabled? and
+       ::I18n.locale != ::Refinery::I18n.default_frontend_locale
+      "/#{::I18n.locale}#{self.link_url}"
+    else
+      self.link_url
+    end
+  end
+
+  def url_marketable
+    {:controller => "/pages", :action => "show", :path => self.nested_url}
+  end
+
+  def url_normal
+    {:controller => "/pages", :action => "show", :id => self.to_param}
+  end
+
+  # Returns an array with all ancestors to_param, allow with its own
+  # Ex: with an About page and a Mission underneath,
+  # Page.find('mission').nested_url would return:
+  #
+  #   ['about', 'mission']
+  #
+  def nested_url
+    Rails.cache.fetch(url_cache_key) { uncached_nested_url }
+  end
+
+  def uncached_nested_url
+    self.parent ? [parent.nested_url, self.to_param].flatten : [self.to_param]
+  end
+
+  # Returns the string version of nested_url, i.e., the path that should be generated
+  # by the router
+  def nested_path
+    @nested_path ||= "/#{nested_url.join('/')}"
+  end
+
+  def url_cache_key
+    "#{cache_key}#nested_url"
+  end
+
+  def cache_key
+    "#{Refinery.base_cache_key}/#{super}"
+  end
+
+  def use_marketable_urls?
+    RefinerySetting.find_or_set(:use_marketable_urls, true, :scoping => 'pages')
+  end
+
+  # Returns true if this page is "published"
+  def live?
+    not self.draft?
+  end
+
+  # Return true if this page can be shown in the navigation.
+  # If it's a draft or is set to not show in the menu it will return false.
+  # If any of the page's ancestors aren't to be shown in the menu then this page is not either.
+  def in_menu?
+    self.live? && self.show_in_menu? && self.ancestors.all? { |a| a.in_menu? }
+  end
+
+  # Returns true if this page is the home page or links to it.
+  def home?
+    self.link_url == "/"
+  end
+
+  # Returns all visible sibling pages that can be rendered for the menu
+  def shown_siblings
+    self.siblings.reject { |sibling| not sibling.in_menu? }
+  end
+
+  class << self
+    # Accessor to find out the default page parts created for each new page
+    def default_parts
+      RefinerySetting.find_or_set(:default_page_parts, ["Body", "Side Body"])
+    end
+
+    # Returns how many pages per page should there be when paginating pages
+    def per_page(dialog = false)
+      dialog ? PAGES_PER_DIALOG : PAGES_PER_ADMIN_INDEX
+    end
+
+    # Returns all the top level pages, usually to render the top level navigation.
+    def top_level(include_children = false)
+      where(:show_in_menu => true, :draft => false).order('position ASC').includes(:slugs, :children, :parent, :parts)
+    end
+  end
+
+  # Accessor method to get a page part from a page.
+  # Example:
+  #
+  #    Page.first[:body]
+  #
+  # Will return the body page part of the first page.
+  def [](part_title)
+    # don't want to override a super method when trying to call a page part.
+    # the way that we call page parts seems flawed, will probably revert to page.parts[:title] in a future release.
+    if (super_value = super).blank?
+      # self.parts is already eager loaded so we can now just grab the first element matching the title we specified.
+      part = self.parts.detect do |part|
+        part.title == part_title.to_s or
+        part.title.downcase.gsub(" ", "_") == part_title.to_s.downcase.gsub(" ", "_")
+      end
+
+      return part.body unless part.nil?
+    end
+
+    super_value
+  end
+
+  # In the admin area we use a slightly different title to inform the which pages are draft or hidden pages
+  def title_with_meta
+    title = self.title
+    title << " <em>(hidden)</em>" unless self.show_in_menu?
+    title << " <em>(draft)</em>" if self.draft?
+
+    title.strip
+  end
+
+  # Used to index all the content on this page so it can be easily searched.
+  def all_page_part_content
+    self.parts.collect {|p| p.body}.join(" ")
+  end
+
+  ##
+  # Protects generated slugs from title if they are in the list of reserved words
+  # This applies mostly to plugin-generated pages.
+  #
+  # Returns the sluggified string
+  def normalize_friendly_id(slug_string)
+    sluggified = super
+    if use_marketable_urls? && self.class.friendly_id_config.reserved_words.include?(sluggified)
+      sluggified += "-page"
+    end
+    sluggified
+  end
+
+  private
+
+  def invalidate_child_cached_url
+    return true unless use_marketable_urls?
+    children.each do |child|
+      Rails.cache.delete(child.url_cache_key)
+    end
+  end
+end