bcms_person 0.5.0

data/README

@@ -0,0 +1,9 @@
+== BrowserCMS Person extension
+
+This BrowserCMS 3.1 (or greater) extension allows you to create and group lists of people together in an attractive format.
+
+== Requirements
+
+* bcms_thumbnail - which should be installed and activated before you attempt to use this extension. bcms_thumbnail requires the ImageMagick command-line utilities (identify and mogrify for example).
+
+

data/app/controllers/application_controller.rb

@@ -0,0 +1,10 @@
+# Filters added to this controller apply to all controllers in the application.
+# Likewise, all the methods added will be available for all controllers.
+
+class ApplicationController < ActionController::Base
+  helper :all # include all helpers, all the time
+  protect_from_forgery # See ActionController::RequestForgeryProtection for details
+
+  # Scrub sensitive parameters from your log
+  # filter_parameter_logging :password
+end

data/app/controllers/cms/people_controller.rb

@@ -0,0 +1,2 @@
+class Cms::PeopleController < Cms::ContentBlockController
+end

data/app/controllers/cms/person_categories_controller.rb

@@ -0,0 +1,2 @@
+class Cms::PersonCategoriesController < Cms::ContentBlockController
+end

data/app/helpers/application_helper.rb

@@ -0,0 +1,3 @@
+# Methods added to this helper will be available to all templates in the application.
+module ApplicationHelper
+end

data/app/models/person.rb

@@ -0,0 +1,25 @@
+class Person < ActiveRecord::Base
+  acts_as_content_block
+  belongs_to_attachment
+  belongs_to :person_category
+
+  validates_presence_of :first_name, :last_name
+
+  def set_attachment_file_path
+    # The default behavior is use /attachments/file.txt for the attachment path,
+    # assuming file.txt was the name of the file the user uploaded
+    # You should override this with your own strategy for setting the attachment path
+    super
+  end
+
+  def set_attachment_section
+    # The default behavior is to put all attachments in the root section
+    # Override this method if you would like to change that
+    super
+  end
+
+  def display_name
+    "#{self.first_name} #{self.last_name}"
+  end
+
+end

data/app/models/person_category.rb

@@ -0,0 +1,9 @@
+class PersonCategory < ActiveRecord::Base
+  acts_as_content_block
+  acts_as_list
+
+  has_many :people
+
+  validates_presence_of :name
+
+end

data/app/portlets/helpers/person_list_by_category_portlet_helper.rb

@@ -0,0 +1,5 @@
+##
+# All methods from this helper will be available in the render.html.erb for PersonListByCategoryPortlet
+module PersonListByCategoryPortletHelper
+  
+end

data/app/portlets/person_list_by_category_portlet.rb

@@ -0,0 +1,13 @@
+class PersonListByCategoryPortlet < Portlet
+  # Mark this as 'true' to allow the portlet's template to be editable via the CMS admin UI.
+  enable_template_editor false
+     
+  def render
+    if self.person_category_id.blank?
+      @people = Person.find(:all, :order => (self.sort_order.blank?) ? 'first_name, last_name' : self.sort_order)
+    else
+      @person_category = PersonCategory.find(self.person_category_id.to_i)
+      @people = Person.find(:all, :conditions => ['person_category_id = ?', self.person_category_id], :order => (self.sort_order.blank?) ? 'first_name, last_name' : self.sort_order)
+    end
+  end
+end

data/app/views/cms/people/_form.html.erb

@@ -0,0 +1,15 @@
+<%= f.cms_text_field :name, :label => 'Full Name', :instructions => 'This is just to identify the person in the backend.' %>
+<%= f.cms_text_field :first_name, :instructions => 'Required' %>
+<%= f.cms_text_field :middle_name %>
+<%= f.cms_text_field :last_name, :instructions => 'Required' %>
+<%= f.cms_drop_down :person_category_id,  PersonCategory.all(:order => "name").map{|c| [c.name, c.id]}, :prompt => "- Select one -", :label => "Person Category", :instructions => 'Please select what type of person this is. You can add more categories under "Person -> Person Category" in the admin interface.'  %>
+<%= f.cms_text_field :job_title %>
+<%= f.cms_text_field :phone %>
+<%= f.cms_text_field :office %>
+<%= f.cms_text_editor :summary, :instructions => 'Used in compact listings - should probably be 2 to 3 sentences.' %>
+<%= f.cms_text_editor :description, :instructions => 'The full description of this person. If you enter content here, we\'ll create a toggle that allows visitors to switch between the summary and full description content. Requires jQuery.' %>
+<%= f.cms_file_field :attachment_file, :label => "Photo", :instructions => 'Upload a cropped jpg, png, or gif of any reasonable size - we\'ll scale it automatically.' %>
+<%= f.cms_date_picker :start_date %>
+<%= f.cms_date_picker :end_date %>
+<%= f.cms_check_box :sticky, :instructions => 'This person should always be at the top of lists.' %>
+

data/app/views/cms/people/render.html.erb

@@ -0,0 +1,30 @@
+<div class="person person-<%= @content_block.id %>">
+  <div class="person-photo">
+    <% unless @content_block.attachment.blank? %>
+      <%= image_tag(thumbnail(@content_block,'100'), :alt => @content_block.display_name, :class => 'thumbnail-photo') %>
+    <% end %>
+  </div>
+
+  <div class="person-meta">
+    <%= (@content_block.phone.blank?) ? '' : %Q|<div class="phone"><span>Phone:</span> #{@content_block.phone}</div>| %>
+    <%= (@content_block.office.blank?) ? '' : %Q|<div class="office"><span>Office:</span> #{@content_block.office}</div>| %>
+    <%= (@content_block.start_date.blank?) ? '' : %Q|<div class="start_date"><span>From:</span> #{@content_block.start_date.month}/#{content_block.start_date.year}</div>| %>
+    <%= (@content_block.end_date.blank?) ? '' : %Q|<div class="end_date"><span>To:</span> #{@content_block.start_date.month}/#{content_block.start_date.year}</div>| %>
+  </div>
+
+  <div class="person-content">
+    <h2 class="person-name"><%= h @content_block.display_name %><a name="<%= @content_block.display_name.gsub(/[^a-z\d]/i,'-').downcase %>"></a></h2>
+    <%= (@content_block.job_title.blank?) ? '' : "<h3 class=\"person-job-title\">#{h @content_block.job_title}</h3>" %>
+    <div class="summary" id="person-<%= @content_block.id %>-summary"><%= @content_block.summary %></div>
+    <% if ! @content_block.description.blank? %>
+      <div class="description" style="display: none;" id="person-<%= @content_block.id %>-description">
+        <% unless @content_block.attachment.blank? %>
+          <%= image_tag(thumbnail(@content_block,'200'), :alt => @content_block.display_name, :class=>'full-photo') %>
+        <% end %>
+        <%= @content_block.description %>
+      </div>
+      <div class="person-details-toggle"><a href="#" id="person-<%= @content_block.id %>-toggle" class="person-toggle">more &raquo;</a></div>
+    <% end %>
+  </div>
+  <div class="clear"></div>
+</div>

data/app/views/cms/person_categories/_form.html.erb

@@ -0,0 +1,3 @@
+<%= f.cms_text_field :name %>
+<%= f.cms_text_field :description %>
+<%= f.cms_text_field :position, :instructions => 'Sets the order of this category in lists.' %>

data/app/views/cms/person_categories/render.html.erb

@@ -0,0 +1,3 @@
+
+<p><b>Name:</b> <%= @content_block.name %></p>
+<p><b>Description:</b> <%= @content_block.description %></p>

data/app/views/portlets/person_list_by_category/_form.html.erb

@@ -0,0 +1,14 @@
+<%= f.cms_text_field :name %>
+<%= f.cms_text_editor :description, :instructions => 'Appears below the title and above the list of people' %>
+<%= f.cms_drop_down :person_category_id,  PersonCategory.all(:order => "name").map{|c| [c.name, c.id.to_s]}, :prompt => "- All people -", :label => "Person Category", :instructions => 'Display people in this category.'  %>
+<%= f.cms_drop_down :sort_order, [
+  ['Last Name','sticky desc, last_name, first_name'],
+  ['Last Name reverse','sticky desc, last_name desc, first_name desc'],
+  ['First Name','sticky desc, first_name, last_name'],
+  ['First name reverse','sticky desc, first_name desc, last_name desc'],
+  ['Start date','sticky desc, start_date'],
+  ['Start date reverse','sticky desc, start_date desc']
+], :prompt => '- Choose a sort order -', :instructions => 'The sort order of people in this category.' %>
+<%= f.cms_template_editor :template %>
+<%= f.cms_check_box :display_name, :instructions => "Show the name of this portlet in an h2 tag" %>
+<%= f.cms_text_editor :none_found_message, :instructions => 'Text to display if no people are found.' %>

data/app/views/portlets/person_list_by_category/render.html.erb

@@ -0,0 +1,19 @@
+<% 
+  require_javascript_include(['jquery','../bcms/person/bcms_person']) 
+  require_stylesheet_link(['../bcms/person/bcms_person'])
+-%>
+<div class="person-list person-category-<%= (@person_category.blank?) ? 'all' : @person_category.name.gsub(/[^a-z\d]/i,'-').downcase %>">
+  <% if @portlet.display_name %>
+    <h2><%=h @portlet.name %></h2>
+  <% end %>
+  <% unless @portlet.description.blank? %>
+    <div class="description"><%= @portlet.description %></div>
+  <% end %>
+  <% unless @people.blank? %>
+    <% @people.each do |person| %>
+      <%= render_connectable person %>
+    <% end %>
+  <% else %>
+    <%= @portlet.none_found_message %>
+  <% end %>
+</div>

data/db/migrate/20100416173927_create_people.rb

@@ -0,0 +1,37 @@
+class CreatePeople < ActiveRecord::Migration
+  def self.up
+    create_content_table :people do |t|
+      t.string :first_name 
+      t.string :middle_name 
+      t.string :last_name 
+      t.string :job_title 
+      t.string :phone 
+      t.string :office 
+      t.text :summary, :size => (64.kilobytes + 1) 
+      t.text :description, :size => (64.kilobytes + 1) 
+      t.belongs_to :attachment
+      t.integer :attachment_version 
+      t.date :start_date 
+      t.date :end_date 
+      t.string :type_of_person
+      t.boolean :sticky
+      t.references :person_category
+    end
+
+    add_index :people, :person_category_id
+    add_index :people, :sticky
+    
+    unless Section.with_path('/people').exists?
+      Section.create!(:name => "Person", :parent => Section.system.first, :path => '/people', :allow_groups=>:all)
+    end
+    ContentType.create!(:name => "Person", :group_name => "Person")
+  end
+
+  def self.down
+    ContentType.delete_all(['name = ?', 'Person'])
+    CategoryType.all(:conditions => ['name = ?', 'Person']).each(&:destroy)
+    #If you aren't creating a versioned table, be sure to comment this out.
+    drop_table :person_versions
+    drop_table :people
+  end
+end

data/db/migrate/20100416190408_create_person_categories.rb

@@ -0,0 +1,24 @@
+class CreatePersonCategories < ActiveRecord::Migration
+  def self.up
+    create_content_table :person_categories do |t|
+      t.string :name 
+      t.string :description
+      t.integer :position
+    end
+    ContentType.create!(:name => "PersonCategory", :group_name => "Person")
+    ['Staff','Board Member','Alumni'].each do |cat|
+      PersonCategory.create(:publish_on_save => true, :name => cat)
+    end
+    [:position].each do|col|
+      add_index :person_categories, col
+    end
+  end
+
+  def self.down
+    ContentType.delete_all(['name = ?', 'PersonCategory'])
+    CategoryType.all(:conditions => ['name = ?', 'Person Category']).each(&:destroy)
+    #If you aren't creating a versioned table, be sure to comment this out.
+    drop_table :person_category_versions
+    drop_table :person_categories
+  end
+end

data/lib/bcms_person.rb

@@ -0,0 +1 @@
+require 'bcms_person/routes'

data/lib/bcms_person/routes.rb

@@ -0,0 +1,8 @@
+module Cms::Routes
+  def routes_for_bcms_person
+    namespace(:cms) do |cms|
+      cms.content_blocks :person_categories
+      cms.content_blocks :people
+    end  
+  end
+end

data/public/bcms/person/README

@@ -0,0 +1 @@
+Use this directory to add public files that should copied from the gem into the project.

data/public/bcms/person/bcms_person.css

@@ -0,0 +1,46 @@
+.clear{
+  clear: both;
+}
+
+.person{
+  margin-bottom: 2em;
+}
+
+.person h2{
+  margin-bottom: 5px;
+}
+
+.person-photo{
+  float: left;
+  width: 110px;
+  text-align: center;
+}
+
+.person-photo img{
+  width: 100px;
+}
+
+.person-meta{
+  float: right;
+  text-align: left;
+  margin-left: 10px;
+  margin-bottom: 10px;
+  width: 150px;
+}
+
+.person-meta span{
+  font-weight: bold;
+}
+
+.person-content{
+  margin-left: 110px;
+}
+
+.person-toggle {
+  font-size: 10px;
+}
+
+.full-photo{
+  float: right;
+  margin: 0px 0px 10px 10px;
+}

data/public/bcms/person/bcms_person.js

@@ -0,0 +1,15 @@
+jQuery(document).ready(function(){
+   jQuery('.person-toggle').click(function(e){
+     e.preventDefault();
+     var personId = jQuery(this).attr('id').split('-')[1];
+     if(jQuery('#person-' + personId + '-summary').is(':visible')){
+      jQuery('#person-' + personId + '-summary').hide();
+      jQuery('#person-' + personId + '-description').show();
+      jQuery(this).html('« less');
+     } else {
+      jQuery('#person-' + personId + '-summary').show();
+      jQuery('#person-' + personId + '-description').hide();
+      jQuery(this).html('more »');
+     }
+   });
+});

data/rails/init.rb

@@ -0,0 +1,4 @@
+gem_root = File.expand_path(File.join(File.dirname(__FILE__), ".."))
+Cms.add_to_rails_paths gem_root
+Cms.add_generator_paths gem_root, "db/migrate/[0-9]*_*.rb"
+Cms.add_generator_paths gem_root, "public/bcms/person/**/*"

metadata

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification 
+name: bcms_person
+version: !ruby/object:Gem::Version 
+  hash: 11
+  prerelease: false
+  segments: 
+  - 0
+  - 5
+  - 0
+  version: 0.5.0
+platform: ruby
+authors: 
+- Dan Collis-Puro
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-18 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: bcms_thumbnail
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 1
+        - 0
+        - 2
+        version: 1.0.2
+  type: :runtime
+  version_requirements: *id001
+description: 
+email: dan@collispuro.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- app/portlets/helpers/person_list_by_category_portlet_helper.rb
+- app/portlets/person_list_by_category_portlet.rb
+- app/helpers/application_helper.rb
+- app/views/portlets/person_list_by_category/_form.html.erb
+- app/views/portlets/person_list_by_category/render.html.erb
+- app/views/cms/people/_form.html.erb
+- app/views/cms/people/render.html.erb
+- app/views/cms/person_categories/_form.html.erb
+- app/views/cms/person_categories/render.html.erb
+- app/controllers/application_controller.rb
+- app/controllers/cms/person_categories_controller.rb
+- app/controllers/cms/people_controller.rb
+- app/models/person.rb
+- app/models/person_category.rb
+- db/migrate/20100416190408_create_person_categories.rb
+- db/migrate/20100416173927_create_people.rb
+- lib/bcms_person.rb
+- lib/bcms_person/routes.rb
+- rails/init.rb
+- public/bcms/person/bcms_person.js
+- public/bcms/person/README
+- public/bcms/person/bcms_person.css
+- README
+has_rdoc: true
+homepage: http://collispuro.com
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: bcms_person
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A staffer / board member / general person module for BrowserCMS
+test_files: []
+