cornerstone 0.0.1 → 0.0.5

data/app/controllers/cornerstone/application_controller.rb

@@ -0,0 +1,6 @@
+module Cornerstone
+  class ApplicationController < ActionController::Base
+
+  end
+end
+

data/app/controllers/cornerstone/discussions_controller.rb

@@ -0,0 +1,58 @@
+module Cornerstone
+  class DiscussionsController < ApplicationController
+
+    respond_to :html
+
+    # GET /cornerstone/discussions/
+    def index
+      @categories = Category.discussions
+    end
+
+    # GET /cornerstone/discussions/new
+    def new
+      @categories = Category.discussions
+      @category = Category.find(params[:cat]) if params[:cat]
+      @discussion = Discussion.new
+      @discussion.category_id = @category.id if @category
+      @discussion.posts.build
+      respond_with(@discussion)
+    end
+
+    # GET /cornerstone/discussions/:category
+    def category
+      @category = Category.includes(:discussions => :posts).find(params[:category])
+      @discussions = @category.discussions
+      respond_with(@discussions, :template => "cornerstone/discussions/categorical_index")
+    end
+
+    # GET /cornerstone/discussions/:category/:id
+    def show
+      @discussion = Discussion.includes(:posts => :user).find(params[:id])
+      @new_post = Post.new
+      @posts = @discussion.posts
+    end
+
+    # POST /cornerstone/discussions/
+    def create
+      @discussion = Discussion.new(params[:discussion])
+
+      # assign user if signed in
+      if current_cornerstone_user
+        @discussion.user = current_cornerstone_user
+        @discussion.posts.first.user = current_cornerstone_user
+      end
+
+      respond_with(@discussion.category, @discussion) do |format|
+        if @discussion.save
+          flash[:notice] = 'Discussion was successfully created.'
+          format.html {redirect_to category_discussion_path(@discussion.category, @discussion)}
+        else
+          @categories = Category.discussions
+          format.html {render :new}
+        end
+      end
+    end
+
+  end
+end
+

data/app/controllers/cornerstone/help_controller.rb

@@ -0,0 +1,11 @@
+module Cornerstone
+  class HelpController < ApplicationController
+
+    # GET /
+    def index
+      @discussion_categories = Category.select("name, item_count").discussions
+    end
+
+  end
+end
+

data/app/controllers/cornerstone/posts_controller.rb

@@ -0,0 +1,66 @@
+module Cornerstone
+  class PostsController < ApplicationController
+    respond_to :html
+
+    # POST /cornerstone/discussions/:discussion_id/posts
+    def create
+      @discussion = Discussion.includes(:posts => :user).find(params[:discussion_id])
+      existing_posts = @discussion.posts.dup
+      @post = @discussion.posts.new(params[:post])
+
+      # assign user if signed in
+      if current_cornerstone_user
+        @post.user = current_cornerstone_user
+      end
+            
+      respond_with(@discussion, @post) do |format|
+        if @post.save
+          # close discussion if commit param dictates
+          unless params[:comment_close].nil?
+            @discussion.update_attribute(:status, Discussion::STATUS.last)
+          else
+            # re-open discussion if discussion is closed
+            if @discussion.closed?
+              @discussion.update_attribute(:status, Discussion::STATUS.first)
+            end
+          end
+
+          flash[:notice] = 'Comment was successfully created.'
+          format.html {redirect_to category_discussion_path(@discussion.category, @discussion)}
+        else
+          @new_post = @post
+          @posts = existing_posts
+          format.html {render :template => "cornerstone/discussions/show"}
+        end
+      end
+    end
+    
+    # GET /cornerstone/discussions/:discussion_id/posts/:id/edit
+    def edit
+      @post = Post.includes(:user, :discussion).find(params[:id])
+      raise Cornerstone::AccessDenied unless @post.created_by?(current_cornerstone_user)
+      @discussion = @post.discussion
+      respond_with(@discussion, @post)
+    end
+
+    # PUT /cornerstone/discussions/:discussion_id/posts/:id
+    def update
+      @post = Post.includes(:user, :discussion).find(params[:id])
+      raise Cornerstone::AccessDenied unless @post.created_by?(current_cornerstone_user)
+      @discussion = @post.discussion
+      flash[:notice] = "Post was successfully updated." if @post.update_attributes(params[:post])
+      respond_with(@discussion, @post, :location => category_discussion_path(@discussion.category, @discussion))
+    end
+    
+    # DELETE /cornerstone/discussions/:discussion_id/posts/:id
+    def destroy
+      @post = Post.includes(:user, :discussion).find(params[:id])
+      raise Cornerstone::AccessDenied unless @post.created_by?(current_cornerstone_user)
+      @discussion = @post.discussion
+      flash[:notice] = "Post was successfully deleted." if @post.destroy
+      respond_with(@discussion, @post, :location => category_discussion_path(@discussion.category, @discussion))
+    end
+
+  end
+end
+

data/app/helpers/cornerstone/application_helper.rb

@@ -0,0 +1,5 @@
+module Cornerstone
+  module ApplicationHelper
+  end
+end
+

data/app/helpers/cornerstone/discussions_helper.rb

@@ -0,0 +1,16 @@
+module Cornerstone
+  module DiscussionsHelper
+
+    # Returns details and links about the latest discussion for a given category
+    def latest_discussion_details(category)
+      if discussion = category.latest_discussion
+        render :partial => 'latest_discussion', :object => discussion,
+                                                :locals => {:category => category}
+      else
+        "N/A"
+      end
+    end
+
+  end
+end
+

data/app/helpers/cornerstone/help_helper.rb

@@ -0,0 +1,4 @@
+module Cornerstone
+  module HelpHelper
+  end
+end

data/app/mailers/cornerstone/cornerstone_mailer.rb

@@ -0,0 +1,31 @@
+module Cornerstone
+  class CornerstoneMailer < ActionMailer::Base
+    default from: Cornerstone::Config.mailer_from
+
+    # Email admins on new discussion - refer to post observer
+    def new_discussion(post, discussion)
+      @post = post
+      @discussion = discussion
+      mail :to => Cornerstone::Config.admin_emails
+    end
+
+    # Email user that created new discussion - refer to post observer
+    def new_discussion_user(post, discussion)
+      @post = post
+      @discussion = discussion
+      mail :to => post.author_email
+    end
+
+    # Email a single participant within a discussion - refer to post observer
+    def new_post(name, email, post, discussion)
+      @post = post
+      @discussion = discussion
+      @name = name
+
+      mail :to => email,
+           :subject => I18n.t('cornerstone.cornerstone_mailer.new_post.subject',
+                              :topic => @discussion.subject)
+    end
+
+  end
+end

data/app/models/cornerstone/article.rb

@@ -0,0 +1,20 @@
+module Cornerstone
+  class Article < ActiveRecord::Base
+    # == CONSTANTS == #
+
+    # == ASSOCIATIONS == #
+    belongs_to :category
+
+    # == ACCESSIBILITY == #
+    # == SCOPES == #
+
+    # == VALIDATIONS == #
+    validates_presence_of :title, :body, :category
+
+    # == CALLBACKS == #
+    # == CLASS METHODS == #
+    # == INSTANCE METHODS == #
+
+  end
+end
+

data/app/models/cornerstone/category.rb

@@ -0,0 +1,45 @@
+module Cornerstone
+  class Category < ActiveRecord::Base
+
+    # == CONSTANTS == #
+    TYPES = ["Discussion", "Article"]
+
+    # == ASSOCIATIONS == #
+    has_many :discussions, :dependent => :destroy
+    has_many :articles, :dependent => :destroy
+
+    # == ACCESSIBILITY == #
+    attr_accessible :name, :category_type, :description
+
+    # == SCOPES == #
+
+    scope :discussions, lambda { where("cornerstone_categories.category_type = 'Discussion'") }
+    scope :articles, lambda { where("cornerstone_categories.category_type = 'Article'") }
+
+    # == VALIDATIONS == #
+    validates :name, :presence => true,
+                     :length => {:maximum => 50}
+
+    validates :category_type, :inclusion => { :in => Cornerstone::Category::TYPES }
+
+    validates :description, :presence => true,
+                            :length => {:maximum => 500}
+
+    # == CALLBACKS == #
+    # == CLASS METHODS == #
+
+    # == INSTANCE METHODS == #
+
+    # Provides the latest discussion created for this category
+    def latest_discussion
+      latest_discussions(1).first
+    end
+
+    # Provides the last 'num' discussions created for this category
+    def latest_discussions(num=nil)
+      Discussion.latest_for_category(self, num)
+    end
+
+  end
+end
+

data/app/models/cornerstone/discussion.rb

@@ -0,0 +1,90 @@
+module Cornerstone
+  class Discussion < ActiveRecord::Base
+
+    # == CONSTANTS == #
+    STATUS = Cornerstone::Config.discussion_statuses
+
+    # == ASSOCIATIONS == #
+    belongs_to :category, :counter_cache => :item_count
+    # belongs_to 'user' also established by acts_as_cornerstone_user
+
+    has_many :posts, :dependent => :destroy
+    accepts_nested_attributes_for :posts
+
+    # == ACCESSIBILITY == #
+    attr_accessible :subject, :privte, :category_id, :posts_attributes
+
+    # == SCOPES == #
+    default_scope :order => "created_at DESC",
+                  :conditions => {:privte => false}
+
+    scope :latest_for_category, lambda { |cat, num=5|
+                                         where(:category_id => cat.id)
+                                         .limit(num) }
+
+    # == VALIDATIONS == #
+    validates :subject, :presence => true,
+                        :length => { :maximum => 50 }
+
+    validates :status, :inclusion => { :in => Cornerstone::Discussion::STATUS }
+
+    validates :category, :presence => true
+
+    # == CALLBACKS == #
+    after_save :set_latest_discussion, :on => :create
+
+    # == CLASS METHODS == #
+
+    # == INSTANCE METHODS == #
+    def author_name
+      self.posts.first.author_name
+    end
+
+    # returns true if discussion is 'closed'
+    def closed?
+      self.status == Cornerstone::Discussion::STATUS.last
+    end
+
+    # returns true if it was created by given user or if given user is an admin
+    def created_by?(check_user)
+      return false unless check_user.present?
+      return true if check_user.cornerstone_admin?
+      self.user && self.user == check_user
+    end
+
+    # returns an array of participants for the discussion
+    def participants(exclude_email=nil)
+      ps = []
+      self.posts.each do |p|
+        if p.author_name && p.author_email
+          ps << [p.author_name, p.author_email]
+        end
+      end
+      ps.delete_if{|p| p[1] == exclude_email}.uniq
+    end
+
+    # return a nicely formatted string for emailing
+    # i.e. Name <email_address>, Name <email_address>
+    def participants_email_list(exclude_email=nil)
+      participants(exclude_email).collect{ |p| "#{p[0]} <#{p[1]}>" }.join(", ")
+    end
+
+    #######
+    private
+    #######
+
+    # Update the category's latest discussion author/date
+    def set_latest_discussion
+      post = self.posts.first
+      if post
+        cat = self.category
+        cat.latest_discussion_author = post.author_name
+        cat.latest_discussion_date = Time.now.to_s(:db)
+        cat.save
+      end
+    end
+
+
+  end
+
+end

data/app/models/cornerstone/post.rb

@@ -0,0 +1,103 @@
+module Cornerstone
+  class Post < ActiveRecord::Base
+
+    belongs_to :discussion
+    # belongs_to 'user' also established by acts_as_cornerstone_user
+
+    # == CONSTANTS == #
+    # == ASSOCIATIONS == #
+    # == ACCESSIBILITY == #
+    attr_accessible :body, :name, :email
+
+    # == SCOPES == #
+    default_scope :order => "created_at ASC"
+
+    # == VALIDATIONS == #
+
+    validates :body, :presence => true,
+                     :length => {:maximum => 3000}
+
+    validates :name, :presence => true,
+                     :length => { :maximum => 50 },
+                     :if => Proc.new { |p| !p.try(:user) }
+
+    validates :email, :format => { :with => /\A([^@\s]+)@((?:[-a-z0-9]+\.)+[a-z]{2,})\Z/i },
+                      :if => Proc.new { |p| !p.try(:user) }
+
+    # == CALLBACKS == #
+    after_save :update_counter_cache
+    after_save :set_latest_post, :on => :create
+
+    after_destroy :update_counter_cache
+
+
+
+
+    # TODO: SANITATION ON NAME BODY EMAIL
+
+    # == CLASS METHODS == #
+
+
+    # == INSTANCE METHODS == #
+
+    # return the author name of the post
+    def author_name
+      #@cornerstone_name ||= anonymous_or_user_attr(:name)
+      anonymous_or_user_attr(:cornerstone_name)
+    end
+
+    # return the author email of the post
+    def author_email
+      #@cornerstone_email ||= anonymous_or_user_attr(:email)
+      anonymous_or_user_attr(:cornerstone_email)
+    end
+
+    # returns true if it was created by given user or if given user is an admin
+    def created_by?(check_user)
+      return false unless check_user.present?
+      return true if check_user.cornerstone_admin?      
+      self.user && self.user == check_user
+    end
+    
+    #######
+    private
+    #######
+
+    # Custom counter cache.  Does not include the first post of a discussion.
+    def update_counter_cache
+      self.discussion.reply_count = Post.where(:discussion_id => self.discussion.id)
+                                        .count - 1
+      self.discussion.save
+    end
+
+    # Returns the requested attribute of the user if it exists, or post's attribute
+    def anonymous_or_user_attr(attr)
+      unless self.user_id.nil?
+        mthd = "user_#{attr.to_s}"
+        # TODO: rails caching is messing this relationship up.
+        #       will .user work even if model name is something else. e.g. AdminUser ??
+        self.user.send(attr)
+      else
+        case attr
+        when :cornerstone_name
+          self.send(:name)
+        when :cornerstone_email
+          self.send(:email)
+        end
+      end
+    end
+
+    # Update the discussion's latest post author/date
+    def set_latest_post
+      discussion = self.discussion
+      if discussion
+        discussion.latest_post_author = self.author_name
+        discussion.latest_post_date = Time.now.to_s(:db)
+        discussion.save
+      end
+    end
+
+
+  end
+end
+