refinerycms 0.9.5.30 → 0.9.5.31

data/vendor/plugins/inquiries/inquiries.md

@@ -0,0 +1,31 @@
+# Inquiries
+
+![Refinery Inquiries](http://refinerycms.com/system/images/0000/0626/inquiries.png)
+
+## About
+
+Refinery gives you a simple contact form that notifies you and the customer when an inquiry is made.
+
+In summary you can:
+
+* Collect and manage inquiries
+* Specify who is notified when a new inquiry comes in
+* Customise an auto responder email that is sent to the person making the inquiry
+
+When inquiries come in, you and the customer are notified. The inquiry will now show up as an "open" inquiry. The idea is to deal with the inquiry and then "close" it so you know it's been sorted.
+
+== How do I get notified?
+
+Go into your inquiries section and click on "Update who gets notified"
+
+== How do I edit the auto confirmation email
+
+Go into your inquiries section and click on "Edit confirmation email"
+
+== But I don't want a contact form how do I kill it?
+
+Your contact form loads because you have a page in your site that is told to not just render a normal page, but load the contact form instead.
+
+By default this page is called "Contact Us". Go to your "Pages" tab and click the edit icon on "Contact Us". Now  click on "Hide/Show Advanced Options" and you'll see that a "custom URL" is set to ``/inquiries/new``. Simply change this to nothing, or delete the contact us page.
+
+You might also want to remove the Inquiries plugin from your backend view. To do that, you go to the "Users" tab edit your user, uncheck "Inquiries" from the list of plugins you can access.

data/vendor/plugins/news/app/controllers/news_items_controller.rb

@@ -1,30 +1,20 @@
 class NewsItemsController < ApplicationController
 
-  before_filter :get_latest_posts
-  before_filter :load_page, :only => [:index, :show]
-
-  def index
-    respond_to do |wants|
-      wants.html
-    end
-  end
-
-  def show
-    @news_item = NewsItem.find(params[:id], :conditions => ["publish_date < ?", Time.now])
-
-    respond_to do |wants|
-     wants.html
-    end
-  end
+  before_filter :find_latest_news_items, :find_page
+  before_filter :find_news_item, :only => [:show]
 
 protected
 
-  def get_latest_posts
+  def find_latest_news_items
     @news_items = NewsItem.latest
   end
 
-  def load_page
+  def find_news_item
+    @news_item = NewsItem.find(params[:id], :conditions => ["publish_date < ?", Time.now])
+  end
+
+  def find_page
     @page = Page.find_by_link_url("/news", :include => [:parts, :slugs])
   end
 
-end
+end

data/vendor/plugins/news/app/views/news_items/index.html.erb

@@ -1,7 +1,7 @@
 <% content_for :body_content_left do %>
   <%= @page[:body] %>
 
-  <% if @news_items.size > 0 %>
+  <% unless @news_items.empty? %>
     <% @news_items.each do |item| %>
       <h3><%= link_to item.title, news_item_url(item) %></h3>
       <p>

data/vendor/plugins/news/app/views/news_items/show.html.erb

@@ -1,18 +1,13 @@
-<% content_for :title, "#{@news_item.title} - " -%>
-<div id='body_content' class='clearfix'>
-  <div id='body_content_left' class='clearfix'>
-    <h1>
-      <%= @news_item.title %>
-    </h1>
-    <p>
-      <small>Published <%= @news_item.publish_date.strftime("%A %d of %B, %Y") %></small>
-    </p>
-    <%= @news_item.body %>
-    <p>
-      <%= link_to "Back to all news", news_items_url %>
-    </p>
-  </div>
-  <div id='body_content_right' class='clearfix'>
-    <%= render :partial => 'recent_posts' %>
-  </div>
-</div>
+<% content_for :body_content_title, "<h1>#{@news_item.title}</h1>" %>
+<% content_for :body_content_left do %>
+  <p>
+    <small>Published <%= @news_item.publish_date.strftime("%A %d of %B, %Y") %></small>
+  </p>
+  <%= @news_item.body %>
+  <p>
+    <%= link_to "Back to all news", news_items_url %>
+  </p>
+<% end %>
+<% content_for :body_content_right, render(:partial => 'recent_posts') %>
+
+<%= render :partial => "/shared/content_page" %>

data/vendor/plugins/news/news.md

@@ -0,0 +1,20 @@
+# News
+
+![Refinery News](http://refinerycms.com/system/images/0000/0646/news.png)
+
+## About
+
+Refinery's news plugin allows you to post updates to the news section of your website.
+
+Key features:
+
+* Default news page shows a summary of recent news posts
+* Detail view shows the full post and also linked to recent news on the "side bar"
+
+## But I don't want a news section, how do I kill it?
+
+Your news section loads because you have a page in your site that is told to not just render a normal page, but load the news section instead.
+
+By default this page is called "News". Go to your "Pages" tab and click the edit icon on "News". Now  click on "Hide/Show Advanced Options" and you'll see that a "custom URL" is set to ``/news``. Simply change this to nothing, or delete the "News" page.
+
+You might also want to remove the News plugin from your backend view. To do that, you go to the "Users" tab edit your user, uncheck "News" from the list of plugins you can access.

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

@@ -2,13 +2,7 @@ class PagesController < ApplicationController
 
   def home
     @page = Page.find_by_link_url("/", :include => [:parts, :slugs])
-    if @page.nil?
-      error_404
-    else
-      respond_to do |wants|
-        wants.html
-      end
-    end
+    error_404 unless @page.present?
   end
 
   def show
@@ -18,11 +12,7 @@ class PagesController < ApplicationController
       # 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 unless first_live_child.nil?
-      else
-        respond_to do |wants|
-          wants.html
-        end
+        redirect_to first_live_child.url if first_live_child.present?
       end
     else
       error_404

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

@@ -13,7 +13,7 @@ class Page < ActiveRecord::Base
   accepts_nested_attributes_for :parts, :allow_destroy => true
 
   acts_as_indexed :fields => [:title, :meta_keywords, :meta_description, :custom_title, :browser_title, :all_page_part_content],
-          :index_file => [RAILS_ROOT,"tmp","index"]
+          :index_file => %W(#{RAILS_ROOT} tmp index)
 
   before_destroy :deletable?
 
@@ -28,8 +28,8 @@ class Page < ActiveRecord::Base
       super
     else
       puts "This page is not deletable. Please use .destroy! if you really want it gone or first:"
-      puts "unset .link_url" unless self.link_url.blank?
-      puts "unset .menu_match" unless self.menu_match.blank?
+      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
       return false
     end
@@ -57,9 +57,9 @@ class Page < ActiveRecord::Base
   end
 
   def url
-    if not (self.link_url.blank?)
+    if self.link_url.present?
       self.link_url
-    elsif not self.to_param.blank?
+    elsif self.to_param.present?
       "/pages/#{self.to_param}"
     end
   end

data/vendor/plugins/pages/app/presenters/page_presenter.rb

@@ -0,0 +1,3 @@
+class PagePresenter < Refinery::BasePresenter
+  #delegate DEFAULT_FIELDS.keys :to => :model
+end

data/vendor/plugins/pages/pages.md

@@ -0,0 +1,141 @@
+# Pages
+
+![Refinery Pages](http://refinerycms.com/system/images/0000/0656/pages.png)
+
+## About
+
+One core part of is Pages. Plugins such as news and inquiries hook to pages. The menu is rendered based off the structure of your pages.
+
+Pages have one key thing about them that is unique - page parts.
+
+## Page Parts
+
+![Refinery Page Parts](http://refinerycms.com/system/images/0000/0586/editing-page.png)
+
+### What are they
+
+Think of a page part is a single piece of content on your page. At [Resolve Digital](http://www.resolvedigital.co.nz) we often simply use ``body`` and ``side_body``. One is for the main content and one is for the content which goes on a side bit of the page to display other information.
+
+### Default Page Parts
+
+You can change what the default page parts are called or add more by editing the "Default Page Parts" setting. This is a serialize array of names. The default looks like this
+
+    --- 
+    - body
+    - side_body
+  
+Add more to this setting if you want more default page parts.
+
+### Adding Page Parts for Specify Pages
+
+You can add extra page parts to your pages by setting the "New Page Parts" to ``true`` and editing the page you want to add a part to and clicked the little "+" icon.
+
+Note in the user-facing front end we call them "content sections" not "page parts".
+
+## Page Options
+
+### Draft/Published
+
+You can have draft and published pages. This is controlled by checking and unchecking the "Save as Draft" field on the page form, when editing the page.
+
+### Custom Title
+
+There are three options for how the page title will be rendered on the front end.
+
+* ``None``: will just default to the page title
+* ``Text``: allows you to have a different name for the page in the backend to the front end (sometimes good for SEO)
+* ``Image``: If you're designer is using a custom non-standard web font, this is ideal. Bang the image of your title right in there (_we don't recommend this though!_)
+
+### Show in menu
+
+You can hide a page from the navigation if you like by unchecking "show in menu"
+
+### Custom URL
+
+This allows you to make your page not link to a normal page but make it show something else. This could be a donation link to a completely different site for example. Or as Refinery uses it, you might want to link to another plugin.
+
+The "contact us" page for example has a Custom URL of ``/inquiries/new`` because we want it to load the inquiries form from the inquiries plugin instead.
+
+### WYMEditor (the visual editor)
+
+Refinery is backed by [WYMEditor](http://www.wymeditor.org/)
+
+It's a standards compliant editor that we've trimmed to only have what we feel is absolutely necessary. When you're editing the content is a page part you're using [WYMEditor](http://www.wymeditor.org/).
+
+You can also switch to "source" view and edit XHTML manually.
+
+### Custom selectable styles in WYMEditor
+
+![Refinery Page Editor Styles](http://refinerycms.com/system/images/0000/0596/editing-page-style.png)
+
+Some sites require a little more than just your standard bold and heading controls. This is where the "css" style drop down comes in hand.
+
+It allows your customers to select a style you define. You need to edut/create a CSS file called ``theme.css``. You could have this in one of two places
+
+1. ``/public/stylesheets/themes.css``
+2. ``/themes/your_theme_name/stylesheets/themes.css``
+
+Inside that file you define your styles like this
+
+    .category-name-style-name {
+      // apply your CSS rules here
+    }
+    
+For example if I wanted to add a style that allowed my users to highlight their text a light yellow colour I would put this
+
+    .text-highlight-yellow {
+      background: LightYellow;
+    }
+    
+Now edit ``public/javascripts/admin.js``. We're going to need to tell WYMEditor that we have some new styles it should load when the editor is loaded.
+
+Currently your ``admin.js`` file will have something like this
+
+    var wymeditorClassesItems = [
+        {name: 'text-align', rules:['left', 'center', 'right', 'justify'], join: '-'}
+     ,  {name: 'image-align', rules:['left', 'right'], join: '-'}
+     ,  {name: 'font-size', rules:['small','normal','large'], join: '-'}
+    ]
+    
+Let's just breakdown a single WYMeditor class line and understand it:
+
+    {name: 'font-size', rules:['small','normal','large'], join: '-'}
+    
+``font-size`` is the name of the category and ``small``, ``normal``, ``large`` are the actual styles. So for this to match up with the styles in my theme.css file the class name has to be:
+
+    .font-size-small { // CSS rules here }
+    .font-size-normal { // CSS rules here }
+    .font-size-large { // CSS rules here }
+    
+So going back to our text highlighting above we make the new style show up in the editor by changing our ``admin.js`` file to:
+
+    var wymeditorClassesItems = [
+        {name: 'text-align', rules:['left', 'center', 'right', 'justify'], join: '-'}
+     ,  {name: 'image-align', rules:['left', 'right'], join: '-'}
+     ,  {name: 'font-size', rules:['small','normal','large'], join: '-'}
+     ,  {name: 'text-highlight', rules:['yellow'], join: '-'}
+    ]
+
+### Dialogs that show from WYMEditor
+
+![Refinery Page Editor Link Dialog](http://refinerycms.com/system/images/0000/0636/link-dialog.png)
+
+## Page Link dialog
+
+The link dialog lets you link in several different ways
+
+* To an internal page
+* To an external page
+* To an email address
+* To a resource you've uploaded in the Resources tab.
+
+## Insert Image dialog
+
+Simply lets you select from an existing image found in the Images tab or upload a new one right within the dialog.
+
+## Refinery Default Pages
+
+Some pages you have to keep in order for Refinery to fully function.
+
+* Page not found - the default 404 page, it's hidden from the navigation
+* Down for maintenance - renders when you're site is being updated.

data/vendor/plugins/pages/rails/init.rb

@@ -4,4 +4,4 @@ Refinery::Plugin.register do |plugin|
   plugin.version = 1.0
   plugin.menu_match = /admin\/((pages)|(page_dialogs)|(page_parts))$/
   plugin.activity = {:class => Page, :url_prefix => "edit_", :title => "title", :created_image => "page_add.png", :updated_image => "page_edit.png"}
-end
+end

data/vendor/plugins/refinery/app/views/admin/_head.html.erb

@@ -20,6 +20,7 @@
     <% end %>
   <% end %>
   <script type='text/javascript'>jQuery.noConflict();</script>
+  <%= javascript_include_tag 'admin' %>
   <%= javascript_include_tag 'refinery/prototype.enhancements.js', 'fastinit', 'refinery/tooltips', 'livepipe', 'tabs', 'thickbox', "wymeditor/jquery.refinery.wymeditor.js", 'refinery/boot_wym', 'refinery/admin', :cache => (use_caching ? "cache/admin" : false) %>
   <%= "<script type='text/javascript' src='http://getfirebug.com/releases/lite/1.2/firebug-lite-compressed.js'></script>" if RefinerySetting.find_or_set(:show_firebug_lite, false) == true -%>
   <%= "<script type='text/javascript'>jQuery(document).ready(function(){ jQuery('#flash').fadeIn(550); });</script>" unless flash.empty? -%>

data/vendor/plugins/refinery/app/views/layouts/application.html.erb

@@ -1,21 +1,8 @@
-<% setup # sets up any meta tags and page title -%>
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>
-      <%= yield :title %> - <%= RefinerySetting.find_or_set(:site_name, "Company Name") %>
-    </title>
-    <%= render :partial => 'shared/google_analytics' unless local_request? %>
-    <%= stylesheet_link_tag 'application' %>
-    <%= stylesheet_link_tag 'formatting', 'theme' %>
-    <%= stylesheet_link_tag 'home' if @page.home? %>
-    <!--[if IE 7]><%= stylesheet_link_tag 'ie7' %><![endif]-->
-    <link rel="shortcut icon" href="/favicon.ico" />
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <%= yield :head %>
-  </head>
+  <%= render :partial => "/shared/head" %>
   <body>
-    <%= render :partial => "/shared/ie6check" if request.env['HTTP_USER_AGENT'] =~ /MSIE/ %>
+    <%= render :partial => "/shared/ie6check" if request.env['HTTP_USER_AGENT'] =~ /MSIE/ -%>
     <div id='page_container'>
       <div id='page' class='clearfix'>
         <div id='header' class='clearfix'>

data/vendor/plugins/refinery/app/views/shared/_head.html.erb

@@ -0,0 +1,13 @@
+<% theme ||= false -%>
+<head>
+  <title><%= browser_title(yield(:title)) %></title>
+  <%= render :partial => 'shared/google_analytics' unless local_request? %>
+  <%= stylesheet_link_tag "#{'theme/' if theme}application", "#{'theme/' if theme}formatting", "theme" %>
+  <%= stylesheet_link_tag "#{'theme/' if theme}home" if home_page? %>
+  <%= "<!--[if IE 7]>#{stylesheet_link_tag 'ie7'}<![endif]-->" if request.env['HTTP_USER_AGENT'] =~ /MSIE/ -%>
+  <link rel="shortcut icon" href="/favicon.ico" />
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+  <%= "<meta name=\"keywords\" content=\"#{@meta.meta_keywords}\" />" if @meta.meta_keywords.present? %>
+  <%= "<meta name=\"description\" content=\"#{@meta.meta_description}\" />" if @meta.meta_description.present? -%>
+  <%= yield :head %>
+</head>

data/vendor/plugins/refinery/app/views/shared/_header.html.erb

@@ -1,4 +1,4 @@
 <div id='header_content'>
   <h1><%= link_to RefinerySetting[:site_name], root_url %></h1>
   <%= render :partial => "/shared/menu" %>
-</div>
+</div>

data/vendor/plugins/refinery/app/views/shared/_menu.html.erb

@@ -1,18 +1,7 @@
-<%
-  cache(:action_suffix => "site_menu") do
-    # cache important lookups
-    hide_children = RefinerySetting.find_or_set(:menu_hide_children, false)
-    siblings = nil # all pages in the top level menu have the same siblings, basically.
-%>
+<% cache(:action_suffix => "site_menu") do %>
   <ul id='<%= dom_id ||= "menu" %>' class='menu clearfix'>
-    <% @menu_pages.each do |page| -%>
-      <%= render :partial => '/shared/menu_branch', :locals => {
-          :page => page,
-          :position => @menu_pages.index(page),
-          :root => true,
-          :siblings => ((siblings ||= page.shown_siblings) - [self]),
-          :hide_children => hide_children
-      } -%>
-    <% end -%>
+    <%= render :partial => "/shared/menu_branch", :collection => @menu_pages, :locals => {
+      :hide_children => RefinerySetting.find_or_set(:menu_hide_children, false)
+    } -%>
   </ul>
 <% end %>

data/vendor/plugins/refinery/app/views/shared/_menu_branch.html.erb

@@ -1,28 +1,23 @@
-<%# this is pretty bad code - need to rethink this one -%>
 <%
   css = []
-  css << "selected" if selected_page?(page) or descendant_page_selected?(page)
-  css << "first" if position == 0
-  css << "last" if position == (siblings ||= page.shown_siblings).size
-  domid = "#{page.title.gsub(" ", "_").downcase}_item" unless page.title.blank?
-
-   if page.in_menu?
+  css << "selected" if selected_page?(menu_branch) or descendant_page_selected?(menu_branch)
+  css << "first" if menu_branch_counter == 0
+  css << "last" if menu_branch_counter == menu_branch.shown_siblings.size
+  domid = "item_#{menu_branch_counter}" unless menu_branch.parent_id.present? or menu_branch.title.blank?
 -%>
-<li<%= " class='#{css.join(' ')}'" unless css.blank? -%><%= " id='#{domid}'" unless domid.blank? -%>>
-  <%= link_to page.title, page.url %>
-  <% unless hide_children or (children = page.children.collect{|c| c if c.in_menu? }.compact).empty? %>
-    <ul class='clearfix'>
-      <% children.each do |child| -%>
-        <% shown_siblings = child.shown_siblings %>
-        <%= render :partial => '/shared/menu_branch', :locals => {
-          :page => child,
-          :position => page.children.index(child),
-          :root => false,
-          :siblings => shown_siblings,
-          :hide_children => hide_children
-        } -%>
-      <% end %>
-    </ul>
-  <% end %>
-</li>
-<% end -%>
+<% if menu_branch.in_menu? %>
+  <li<%= " class='#{css.join(' ')}'" if css.present? -%><%= " id='#{domid}'" if domid.present? -%>>
+    <%= link_to menu_branch.title, menu_branch.url %>
+    <% 
+      unless hide_children or       
+        menu_branch.parent_id.present? or       
+        (children = menu_branch.children.collect{|c| c if c.in_menu? }.compact).empty? 
+    -%>
+      <ul class='clearfix'>
+        <%= render :partial => "/shared/menu_branch",
+                    :collection => children,
+                    :locals => {:hide_children => hide_children} -%>
+      </ul>
+    <% end -%>
+  </li>
+<% end -%>