mcms_pages 0.0.1

data/app/helpers/pages_helper.rb

@@ -0,0 +1,118 @@
+=begin
+
+  @File Name                 : pages_helper.rb
+  @Company Name              : Mindfire Solutions Private Limited
+  @Creator Name              : Vikram Kumar Mishra
+  @Date Created              : 2012-06-06
+  @Date Modified             : 2012-06-15
+  @Last Modification Details : default_page_parts method changed
+  @Purpose                   : To have view related logic for pages view mainly.
+
+=end
+
+module PagesHelper
+  
+  # @Parameters  : integer(column count of a layout)
+  # @Return      : Array
+  # @purpose     : To give layout a name on the basis of parameter
+  def layout_name count
+
+    # using case statement to decide layout name
+    case count
+
+      when 2
+
+        return "two_column_layout"
+          
+      when 3
+
+        return "three_column_layout"
+        
+      when 1
+
+        return "one_column_layout"
+
+      else
+        
+        return "default_layout"
+        
+    end # end case statement
+
+  end #end method
+
+  # @params    : none
+  # @return    : boolean
+  # @purpose   : To find
+  def deleteable?(page)
+
+    return page.deletable?
+
+  end
+
+
+  # @param    : Integer
+  # @return   : Array
+  # @purpose  : To find page parts according to param
+  def get_fragments(part, title)
+
+    #using case statement to get fragments
+    case part
+
+      when 0
+
+        if title == "header"
+          
+          # get header fragment
+          part = PagePart.find_page_parts_with_title_header
+
+        end
+        
+      when 1
+        
+        # get footer fragment
+        part = PagePart.find_page_parts_with_title_footer
+
+      when 2
+
+        if title == "left body"
+          
+          # get left body fragment
+          part = PagePart.find_page_parts_with_title_left_body
+
+        elsif title == "right body"
+          
+          # get right body fragment
+          part = PagePart.find_page_parts_with_title_right_body
+          
+        end
+        
+      when 3
+        
+        if title == "right body"
+
+          # get right body fragment
+          part = PagePart.find_page_parts_with_title_right_body
+
+        end
+      
+    end # end case
+
+  end # end method
+
+  # @param    : Integer(part_index of page part)
+  # @return   : Object
+  # @purpose  : To build a form object for dynamic creating the page part
+  def build_page_part index
+
+    # create a PagePart object and assign it to a variable
+    page = PagePart.new
+
+    #make the page part form
+    builder = ActionView::Helpers::FormBuilder.new( "page[page_parts_attributes][#{index}]", page, self, {}, proc {})
+
+    #return form object
+    return builder
+
+  end # end method
+
+end # end module

data/app/models/ckeditor/asset.rb

@@ -0,0 +1,8 @@
+class Ckeditor::Asset < ActiveRecord::Base
+
+  self.table_name = "mcms_assets"
+
+  include Ckeditor::Orm::ActiveRecord::AssetBase
+  include Ckeditor::Backend::Paperclip
+end
+

data/app/models/ckeditor/attachment_file.rb

@@ -0,0 +1,13 @@
+class Ckeditor::AttachmentFile < Ckeditor::Asset
+  has_attached_file :data,
+                    :url => "/ckeditor_assets/attachments/:id/:filename",
+                    :path => ":rails_root/public/ckeditor_assets/attachments/:id/:filename"
+
+  validates_attachment_size :data, :less_than => 100.megabytes
+  validates_attachment_presence :data
+
+	def url_thumb
+	  @url_thumb ||= Ckeditor::Utils.filethumb(filename)
+	end
+end
+

data/app/models/ckeditor/picture.rb

@@ -0,0 +1,14 @@
+class Ckeditor::Picture < Ckeditor::Asset
+  has_attached_file :data,
+                    :url  => "/ckeditor_assets/pictures/:id/:style_:basename.:extension",
+                    :path => ":rails_root/public/ckeditor_assets/pictures/:id/:style_:basename.:extension",
+	                  :styles => { :content => '800>', :thumb => '118x100#' }
+
+	validates_attachment_size :data, :less_than => 2.megabytes
+	validates_attachment_presence :data
+
+	def url_content
+	  url(:content)
+	end
+end
+

data/app/models/layout.rb

@@ -0,0 +1,64 @@
+=begin
+
+  @File Name                 : layout.rb
+  @Company Name              : Mindfire Solutions Private Limited
+  @Creator Name              : Vikram Kumar Mishra
+  @Date Created              : 2012-06-04
+  @Date Modified             : 2012-06-15
+  @Last Modification Details : 
+  @Purpose                   : To deal with database table "mcms_layouts" and all operations related to that table mainly.
+                               It may deal with other tables and DB related operations.
+=end
+
+#defining model class to interact with database. It inherits the rails's base class ActiveRecord::Base
+class Layout < ActiveRecord::Base
+
+  #By default it access the table named "pages",
+  #so explicitly setting the table name to access required table
+  self.table_name = "mcms_layouts"
+
+  #definig the list of accessible attributes as required by rails
+  attr_accessible :column_count, :left, :main, :name, :right, :header, :footer
+
+  #Associating table "mcms_pages" with table "mcms_page_parts" using has_many relation
+  has_many :pages,
+           :foreign_key => :layout_id,
+           :class_name => 'Page',
+           :inverse_of => :layout,
+           :dependent => :destroy
+
+  # @param   : None
+  # @return  : Array
+  # @purpose : To find all layouts
+  def self.find_all_layouts
+
+    # finding all layouts from the DB and return the array
+    return self.select("id, name");
+
+  end # end method
+
+  # @param   : integer(layout_id)
+  # @return  : Array
+  # @purpose : To find the page parts in given layout
+  def self.find_page_parts layout_id
+
+    #initializing an array with some default value
+    page_part_array = []
+
+    # finding the layout with given id
+    layout = self.find_by_id(layout_id)
+
+    # check and include page part in page part array if page part value is
+    # true in DB
+    page_part_array << "header" if layout["header"]
+    page_part_array << "footer" if layout["footer"]
+    page_part_array << "left body" if layout["left"]
+    page_part_array << "right body" if layout["right"]
+    page_part_array << "main body" if layout["main"]
+
+    # return the array
+    return page_part_array
+
+  end # end method
+  
+end # end class

data/app/models/page.rb

@@ -0,0 +1,152 @@
+=begin
+
+  @File Name                 : page.rb
+  @Company Name              : Mindfire Solutions Private Limited
+  @Creator Name              : Vikram Kumar Mishra
+  @Date Created              : 2012-06-05
+  @Date Modified             : 2012-06-15
+  @Last Modification Details : belongs_to layout added
+  @Purpose                   : To deal with database table "mcms_pages" and all operations related to that table mainly.
+                               It may deal with other tables and DB related operations.
+=end
+
+require 'friendly_id'
+
+#defining model class to interact with database. It inherits the rails's base class ActiveRecord::Base
+class Page < ActiveRecord::Base
+
+  # extending gem friendly_id
+  extend FriendlyId
+
+  # using title for custom url
+  friendly_id :title, use: :slugged
+
+  #By default it access the table named "pages",
+  #so explicitly setting the table name to access required table
+  self.table_name = "mcms_pages"
+
+  #definig the list of accessible attributes as required by rails
+  attr_accessible :link_url, :published, :show_in_menu, :title, :page_parts_attributes, :page_parts_pages_attributes,
+                  :parent_id, :layout_id, :slug
+
+  #include rails standard validation for title
+  validates :title, :presence => true, :uniqueness => true
+
+  # Nested pages, i.e. page underneath another page
+  #acts_as_nested_set :dependent => :destroy
+
+  #Associating table "mcms_pages" with table "mcms_page_parts" using has_many relation
+#  has_many :page_parts,
+#           :foreign_key => :page_id,
+#           :class_name => 'PagePart',
+#           :inverse_of => :page,
+#           :dependent => :destroy
+
+  #defining has_many :through relationship
+  has_many :page_parts_pages, :class_name => 'PagePartsPage'
+
+  #defining has_many relation of page_parts to pages through page_part_pages
+  has_many :page_parts, :through => :page_parts_pages
+
+  # Associating table mcms_pages to itself. That is self referential has_many relationship using the key parent id
+  # Hence a page can have many pages
+  has_many :children,
+           :class_name => "Page",
+           :foreign_key => :parent_id,
+           :dependent => :destroy
+
+  # Hence a page can belongs to another page
+  belongs_to :parent, :class_name => "Page"
+
+  # A page will belongs to a layout
+  belongs_to :layout, :class_name => "Layout"
+
+
+  #Save Parent and child form together by using association with dependents destroy
+  accepts_nested_attributes_for :page_parts_pages, :allow_destroy => true
+  accepts_nested_attributes_for :page_parts, :allow_destroy => true
+
+  # @params  : None
+  # @return  : Array
+  # @Purpose : To find title and id of all pages
+  def self.find_all_pages
+
+    #finding title and id of all pages
+    return self.select("id, title")
+
+  end # end method
+
+  # @param = integer
+  # @return = Array
+  # Helps to resolve the situation where you have a path and an id
+  # If page corresponding to path is not found then try finding page
+  # by id.
+  def self.find_by_slug_or_id(path, id)
+
+    # if path is present
+    if path.present?
+
+      # then call find_by_path method to find the page
+      find_by_path(path)
+
+    #if path is not present but ID is present,
+    elsif id.present?
+
+      # then call rails find method to find page by id
+      find_by_path(id)
+
+    end # end outer if
+
+  end # end method
+
+  # @params    : string(path)
+  # @return    : Array(page)
+  # @purpose   : With slugs scoped to the parent page we need to find a page by its full path.
+  #              For example with about/example we would need to find 'about' and then its child
+  #              called 'example' otherwise it may clash with another page called /example.
+  def self.find_by_path(path)
+
+    # split the path param and assign it to a variable, and reject spliting if it is blank
+    split_path = path.to_s.split('/').reject(&:blank?)
+
+    # find page details using find_by_slug method and assign it to a variable
+    page = Page.find_by_slug(split_path.shift)
+
+    # find child page and then details of page using find_by_slug method and assign it to a variable
+    page = page.children.find_by_slug(split_path.shift) until page.nil? || split_path.empty?
+
+    # return page variable
+    page
+
+  end # end method
+
+  # @params    : none
+  # @return    : boolean
+  # @purpose   : To check whther the page ios deletable or not
+  def deletable?
+
+    # if link url is / or /404 then page is not deletable
+    if link_url == '/' || link_url == '/404'
+
+      false
+
+    else
+
+      true
+
+    end # end if
+
+  end # end method
+
+  # @param   : none
+  # @return   : none
+  # @purpose  : make nested url for child pages in the form of parent/child
+  def nested_url
+
+    # find the parent of the current page and convert the current page slug to nested url
+    [parent, to_param.to_s].compact.flatten
+
+  end # end method
+
+end #end class
+

data/app/models/page_part.rb

@@ -0,0 +1,99 @@
+=begin
+  @File Name                 : page_part.rb
+  @Company Name              : Mindfire Solutions Private Limited
+  @Creator Name              : Vikram Kumar Mishra
+  @Date Created              : 2012-06-05
+  @Date Modified             : 2012-06-08
+  @Last Modification Details : Title field validation added
+  @Purpose                   : To deal with database table "mcms_page_parts" and all operations related to that table mainly.
+                               It may deal with other tables and DB related operations.
+=end
+
+#defining model class to interact with database. It inherits the rails's base class ActiveRecord::Base
+class PagePart < ActiveRecord::Base
+
+  #By default it access the table named "page_parts",
+  #so explicitly setting the table name to access required table
+  self.table_name = "mcms_page_parts"
+
+  #defining has_many :through relationship
+  has_many :page_parts_pages, :class_name => 'PagePartsPage'
+
+  #defining has_many relation of page_parts to pages through page_part_pages
+  has_many :pages, :through => :page_parts_pages
+
+  #defining the list of accessible attributes as required by rails
+  attr_accessible :body, :page_id, :title, :page_parts_pages_attributes
+
+  #validating title field to have non-blank value
+  validates :title, :presence  => true
+
+  # @param    : none
+  # @return   : array
+  # @purpose  : To find all page_parts with title header
+  def self.find_page_parts_with_title_header
+
+    #find all page parts with title header and assign it to a variable
+    header_part = self.find_all_by_title("header")
+
+    # calling method to find unique pages and assigning them to an array
+    page_title = PagePartsPage.find_unique_page_parts_pages(header_part)
+
+    # returning the array
+    return page_title
+    
+  end # end method
+
+  # @param    : none
+  # @return   : array
+  # @purpose  : To find all page_parts with title header
+  def self.find_page_parts_with_title_footer
+
+    #find all page parts with title header and assign it to a variable
+    footer_part = self.find_all_by_title("footer")
+
+    # calling method to find unique pages and assigning them to an array
+    page_title = PagePartsPage.find_unique_page_parts_pages(footer_part)
+
+    # returning the array
+    return page_title
+
+  end # end method
+
+  # @param    : none
+  # @return   : array
+  # @purpose  : To find all page_parts with title right body
+  def self.find_page_parts_with_title_right_body
+
+     #find all page parts with title header and assign it to a variable
+    right_body = self.find_all_by_title("right body")
+
+    # calling method to find unique pages and assigning them to an array
+    page_title = PagePartsPage.find_unique_page_parts_pages(right_body)
+
+    # returning the array
+    return page_title
+
+  end # end method
+
+  # @param    : none
+  # @return   : array
+  # @purpose  : To find all page_parts with title left body
+  def self.find_page_parts_with_title_left_body
+
+     #find all page parts with title header and assign it to a variable
+    left_body = self.find_all_by_title("left body")
+
+    # calling method to find unique pages and assigning them to an array
+    page_title = PagePartsPage.find_unique_page_parts_pages(left_body)
+
+    # returning the array
+    return page_title
+
+  end # end method
+
+  def self.find_page_parts_with_title_main_body
+    return "main body"
+  end
+  
+end  # end class

data/app/models/page_parts_page.rb

@@ -0,0 +1,52 @@
+=begin
+
+  @File Name                 : page_parts_page.rb
+  @Company Name              : Mindfire Solutions Private Limited
+  @Creator Name              : Vikram Kumar Mishra
+  @Date Created              : 2012-06-25
+  @Date Modified             : 
+  @Last Modification Details : 
+  @Purpose                   : To deal many to many relationship for page and page_parts
+=end
+
+#defining model class to interact with database. It inherits the rails's base class ActiveRecord::Base
+class PagePartsPage < ActiveRecord::Base
+
+  #By default it access the table named "pages",
+  #so explicitly setting the table name to access required table
+  self.table_name = "mcms_page_parts_pages"
+
+  #definig the list of accessible attributes as required by rails
+  attr_accessible :page_id, :page_part_id
+
+  # A page_parts_pages will belongs to pages
+  belongs_to :page, :foreign_key => :page_id
+
+   # A page_parts_pages will belongs to page_parts
+  belongs_to :page_part, :foreign_key => :page_part_id
+
+  # @params  : Array
+  # @returns : Array
+  # @purpose : To find page_id from page_parts_pages table on the basis of unique page_part_id
+  def self.find_unique_page_parts_pages(parts)
+
+    #initialize an empty array
+    page_title = Hash.new
+    
+    # for each parts
+    parts.each do |part|
+
+      #find first page id using the page_part part
+      page_parts_pages = self.find_by_page_part_id(part.id)
+
+      # insert page title in the array
+      page_title[page_parts_pages.page_part.id] = page_parts_pages.page.title if not page_parts_pages.nil?
+      
+    end # end loop
+
+    # return array of page title
+    return page_title
+
+  end # end method
+  
+end # end class

data/app/views/mcms_pages/admin/layouts/index.html.erb

@@ -0,0 +1,54 @@
+<!--
+
+  @File Name                 : admin/layouts/index.html.erb
+  @Company Name              : Mindfire Solutions Private Limited
+  @Creator Name              : Vikram Kumar Mishra
+  @Date Created              : 2012-06-15
+  @Date Modified             : 
+  @Last Modification Details :
+  @Purpose                   : To display all the layouts and respective image and let the user choose the specific layout.
+
+-->
+
+<h3> Click on the Image you want to choose as layout </h3>
+
+<div id="layout-images-div">
+
+  <!--
+    looping through all the elements of @layouts array to
+    show preview images for all layouts
+  -->
+  <% @layouts.each do |layout| %>
+
+    <div class="layout-images">
+
+      <div class="layout-name">
+
+        <%= layout.name %>
+
+      </div>
+      <div class="layout-image">
+
+        <%= image_tag("layouts/#{layout.name.tr(' ', '-')}.png", :size => "400x400", :alt => "#{layout.name}", :title => "click to view large") %>
+        
+      </div>
+      <div class="layout-link">
+
+        <!-- if parent_id is not 0 then send parent_id through url -->
+        <% if not @page_parent_id == 0 %>
+        
+          <%= link_to("Use This Layout", new_admin_page_path(:layout_id => "#{layout.id}", :parent_id => "#{@page_parent_id}")) %>
+
+        <% else %>
+          
+          <%= link_to("Use This Layout", new_admin_page_path(:layout_id => "#{layout.id}")) %>
+        
+        <% end %>
+
+      </div>
+
+    </div>
+
+  <% end %>
+
+</div>

data/app/views/mcms_pages/admin/pages/_action.html.erb

@@ -0,0 +1,19 @@
+<!--
+
+  @File Name                 : admin/pages/_mcms_action.html.erb
+  @Company Name              : Mindfire Solutions Private Limited
+  @Creator Name              : Vikram Kumar Mishra
+  @Date Created              : 2012-06-09
+  @Date Modified             : 2012-06-14
+  @Last Modification Details : 'mcms-' removed from css selectors
+  @Purpose                   : Application level action for admin pages will be defined here.
+
+-->
+
+
+<section id="application-actions">
+
+  <%= link_to "Add a New Page", new_admin_page_path, :id => "page-new" %>
+
+</section>
+

data/app/views/mcms_pages/admin/pages/_error_messages.html.erb

@@ -0,0 +1,42 @@
+<!--
+
+  @File Name                 : admin/pages/_error_messages.html.erb
+  @Company Name              : Mindfire Solutions Private Limited
+  @Creator Name              : Vikram Kumar Mishra
+  @Date Created              : 2012-07-04
+  @Date Modified             : 
+  @Last Modification Details : 
+  @Purpose                   : To display the form errors
+
+-->
+
+<!-- check for occurences of any errors --> 
+<% if object.errors.any? %>
+
+  <div class="error-explanation" id="error-explanation">
+    
+    <ul>
+
+      <% unless defined?(include_object_name) and include_object_name %>
+      
+        <% object.errors.each do |key, value| %>
+      
+          <li><%= value %></li>
+          
+        <% end %>
+          
+      <% else %>
+          
+        <% object.errors.full_messages.each do |value| %>
+          
+          <li><%= value %></li>
+          
+        <% end %>
+          
+      <% end %>
+          
+    </ul>
+
+  </div>
+
+<% end %>