dm_forum 4.2.1.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3506b203a501e3947202c72e34736bf2de3d6ae7
+  data.tar.gz: ac2c16612a4216a13406d6904674196cdab9b7cf
+SHA512:
+  metadata.gz: 43f82a4dbaef34e13cf79c8aab88e2d25a71b94645677875126bda3bf6f20646c2d671bb7a6d27460607d9776623e38f28a176300d4b66a2c97c8fa20dfb4f1e
+  data.tar.gz: 64af476e10ba9edaecd5a8aaad85089284054a58c7fcf09cf26d0b45443f4ed445563e0276422d2a1cb684938af06ace0714be3c75c4b0e1f656ab160a90ad81

data/MIT-LICENSE

@@ -0,0 +1,23 @@
+Copyright 2013 digitalMoksha LLC
+
+Portions of this code is based off of Heterotic Beast and it's ancestors, which was
+Copyright (c) 2006 - 2011 Josh Goebel, Courtenay Gasking, Rick Olson and Jacques Distler
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,33 @@
+# dm_forum
+
+**dm_forum** provides the forum management system for the MokshaCMS collection of gems.  Forum and forum categories can be created.  Forums can be publically open, or private with access limited to specific registered users or users that are registered in an event/workshop (dm_event)
+
+_The MokshaCMS collection of gems provides an integrated system of services for content, event, forum, learning, and newsletter management.  It supports sites with multiple languages and mutliple distinct sites per installation.  Administration is built in.  Additional services/engines can be written to provide additional functionality._
+
+- core foundation ([dm_core](https://github.com/digitalmoksha/dm_core))
+- content management ([dm_cms](https://github.com/digitalmoksha/dm_cms))
+- event management ([dm_event](https://github.com/digitalmoksha/dm_event))
+- forum management ([dm_forum](https://github.com/digitalmoksha/dm_forum))
+- learning management ([dm_lms](https://github.com/digitalmoksha/dm_lms))
+- newsletter management ([dm_newsletter](https://github.com/digitalmoksha/dm_newsletter))
+
+## Installation
+
+Add the following to your Gem file:
+
+```
+gem 'dm_preferences',       '~> 1.0'
+gem 'dm_core',              git: 'https://github.com/digitalmoksha/dm_core.git', branch: '4-2-stable'
+gem 'dm_cms',               git: 'https://github.com/digitalmoksha/dm_cms.git', branch: '4-2-stable'
+gem 'dm_forum',             git: 'https://github.com/digitalmoksha/dm_forum.git', branch: '4-2-stable'
+gem 'themes_for_rails',     git: 'git://github.com/digitalmoksha/themes_for_rails.git'
+gem 'aced_rails',           git: 'git://github.com/digitalmoksha/aced_rails.git'
+```
+
+After running `bundle install`, run 
+
+```
+rake dm_core:install:migrations
+rake dm_cms:install:migrations
+rake dm_forum:install:migrations
+```

data/Rakefile

@@ -0,0 +1,30 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rdoc/task'
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'DmForum'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+APP_RAKEFILE = File.expand_path("../spec/dummy/Rakefile", __FILE__)
+load 'rails/tasks/engine.rake'
+
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+desc "Run all specs in spec directory (excluding plugin specs)"
+RSpec::Core::RakeTask.new(:spec => 'app:db:test:prepare')
+
+task :default => :spec

data/app/assets/javascripts/dm_forum/admin.js

@@ -0,0 +1,20 @@
+$(document).ready(function() {
+  
+  //----------------------------------------------------------------
+  $('#forum_user_table').dataTable( {
+     bJQueryUI: false,
+     bAutoWidth: false,
+     sPaginationType: 'full_numbers',
+     iDisplayLength: 10,
+     bProcessing: false,
+     bServerSide: true,
+     bStateSave: false,
+     aaSorting: [[0, 'asc']],
+     sDom: '<"datatable-header"f>t<"datatable-footer">',
+     oLanguage: {
+       sLengthMenu: "<span>Show entries:</span> _MENU_"
+     },
+     sAjaxSource: $('#forum_user_table').data('source')
+  });
+
+});

data/app/assets/javascripts/dm_forum/application.js

@@ -0,0 +1,16 @@
+// This is a manifest file that'll be compiled into application.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or vendor/assets/javascripts of plugins, if any, can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// the compiled file.
+//
+// WARNING: THE FIRST BLANK LINE MARKS THE END OF WHAT'S TO BE PROCESSED, ANY BLANK LINE SHOULD
+// GO AFTER THE REQUIRES BELOW.
+//
+//= require jquery
+//= require jquery_ujs
+//= require_tree .
+

data/app/assets/javascripts/dm_forum/dm_forum.js

@@ -0,0 +1,3 @@
+$(document).ready(function() {
+  
+});

data/app/assets/stylesheets/dm_forum/admin.css

@@ -0,0 +1,2 @@
+/*=== DmForum specific CSS ===*/
+

data/app/assets/stylesheets/dm_forum/application.css

@@ -0,0 +1,12 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or vendor/assets/stylesheets of plugins, if any, can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the top of the
+ * compiled file, but it's generally better to create a new file per style scope.
+ *
+ *= require_self
+ */

data/app/controllers/dm_forum/admin/admin_controller.rb

@@ -0,0 +1,13 @@
+class DmForum::Admin::AdminController < DmCore::Admin::AdminController
+  before_filter   :authorize_access
+  
+protected
+
+  #------------------------------------------------------------------------------
+  def authorize_access
+    unless can?(:manage_forums, :all)
+      flash[:alert] = "Unauthorized Access!"
+      redirect_to current_account.index_path 
+    end
+  end
+end

data/app/controllers/dm_forum/admin/dashboard_controller.rb

@@ -0,0 +1,12 @@
+class DmForum::Admin::DashboardController < DmForum::Admin::AdminController
+  
+  #------------------------------------------------------------------------------
+  def widget_forum_comments
+    @comment_day = params[:comment_day].to_i
+    respond_to do |format|
+      format.html
+      format.js
+    end
+  end
+
+end

data/app/controllers/dm_forum/admin/forum_categories_controller.rb

@@ -0,0 +1,80 @@
+class DmForum::Admin::ForumCategoriesController < DmForum::Admin::AdminController
+  include DmForum::PermittedParams
+
+  before_filter   :check_forum_site,  only:   [:index]
+  before_filter   :category_lookup,   except: [:index, :new, :create]
+  
+  # GET /admin/forum_categories
+  #------------------------------------------------------------------------------
+  def index
+    @forum_categories = ForumCategory.ordered
+  end
+
+  # GET /admin/forum_categories/1
+  #------------------------------------------------------------------------------
+  def show
+  end
+
+  # GET /admin/forum_categories/new
+  #------------------------------------------------------------------------------
+  def new
+    @forum_category = ForumCategory.new
+  end
+
+  # GET /admin/forum_categories/1/edit
+  #------------------------------------------------------------------------------
+  def edit
+  end
+
+  # POST /admin/forum_categories
+  #------------------------------------------------------------------------------
+  def create
+    @forum_category = ForumCategory.new(forum_category_params)
+
+    if @forum_category.save
+      redirect_to admin_forum_category_url(@forum_category), notice: 'Forum Category was successfully created.'
+    else
+      render action: :new
+    end
+  end
+
+  # PUT /admin/forum_categories/1
+  #------------------------------------------------------------------------------
+  def update
+    if @forum_category.update_attributes(forum_category_params)
+      redirect_to admin_forum_category_url(@forum_category), notice: 'Forum Category was successfully updated.'
+    else
+      render action: :edit
+    end
+  end
+
+  # DELETE /admin/forum_categories/1
+  #------------------------------------------------------------------------------
+  def destroy
+    @forum_category.destroy
+
+    redirect_to admin_forum_categories_url
+  end
+  
+  #------------------------------------------------------------------------------
+  def sort
+    @forum_category.update_attribute(:row_order_position, params[:item][:row_order_position])
+
+    #--- this action will be called via ajax
+    render nothing: true
+  end
+  
+private
+
+  # make sure a ForumSite singleton is created
+  #------------------------------------------------------------------------------
+  def check_forum_site
+    ForumSite.create(enabled: true) unless ForumSite.site
+  end
+  
+  #------------------------------------------------------------------------------
+  def category_lookup
+    @forum_category = ForumCategory.find(params[:id])
+  end
+
+end

data/app/controllers/dm_forum/admin/forum_sites_controller.rb

@@ -0,0 +1,40 @@
+# This controller is now deprecated.  At the moment I find no use
+# for the enableg, tagline, or description.
+#------------------------------------------------------------------------------
+class DmForum::Admin::ForumSitesController < DmForum::Admin::AdminController
+  include DmForum::PermittedParams
+
+  before_filter   :forum_site_lookup
+
+  # GET /admin/fms/forum_site
+  #------------------------------------------------------------------------------
+  def show
+    unless @forum_site
+      @forum_site = ForumSite.create(enabled: true)
+    end
+  end
+
+
+  # GET /admin/fms/forum_site/edit
+  #------------------------------------------------------------------------------
+  def edit
+  end
+
+  # PUT /admin/fms/forum_site
+  #------------------------------------------------------------------------------
+  def update
+    if @forum_site.update_attributes(forum_site_params)
+      redirect_to dm_forum.admin_forum_site_url, notice: "Forum settings were successfully updated."
+    else
+      render action: :edit
+    end
+  end
+
+private
+
+  #------------------------------------------------------------------------------
+  def forum_site_lookup
+    @forum_site = ForumSite.site
+  end
+
+end

data/app/controllers/dm_forum/admin/forums_controller.rb

@@ -0,0 +1,113 @@
+class DmForum::Admin::ForumsController < DmForum::Admin::AdminController
+  include DmForum::PermittedParams
+
+  before_filter   :category_lookup, :only =>    [:index, :new, :create]
+  before_filter   :forum_lookup,    :except =>  [:index, :new, :create]
+  #before_filter   :set_title
+  
+  # GET /admin/fms/forums
+  #------------------------------------------------------------------------------
+  def index
+    if ForumSite.first
+      @forums = @forum_category.forums.ordered
+    else
+      redirect_to admin_forum_site_path, notice: "Please configure the Forum system first"
+    end
+  end
+
+  #------------------------------------------------------------------------------
+  def show
+    
+  end
+  
+  # GET /admin/fms/forums/new
+  #------------------------------------------------------------------------------
+  def new
+    @forum = @forum_category.forums.build
+  end
+
+  # GET /admin/fms/forums/1/edit
+  #------------------------------------------------------------------------------
+  def edit
+  end
+
+  # POST /admin/fms/forums
+  #------------------------------------------------------------------------------
+  def create
+    @forum = @forum_category.forums.new(forum_params)
+    @forum.forum_site = ForumSite.site
+    
+    if @forum.save
+      redirect_to admin_forum_category_url(@forum_category), notice: 'Forum was successfully created.'
+    else
+      render action: :new
+    end
+  end
+
+  # PUT /admin/fms/forums/1
+  #------------------------------------------------------------------------------
+  def update
+    if @forum.update_attributes(forum_params)
+      redirect_to admin_forum_url(@forum), notice: 'Forum was successfully updated.'
+    else
+      render action: :edit
+    end
+  end
+
+  # DELETE /admin/fms/forums/1
+  #------------------------------------------------------------------------------
+  def destroy
+    @forum.destroy
+
+    redirect_to admin_forum_category_url(@forum.forum_category)
+  end
+  
+  #------------------------------------------------------------------------------
+  def sort
+    @forum.update_attribute(:row_order_position, params[:item][:row_order_position])
+
+    #--- this action will be called via ajax
+    render nothing: true
+  end
+  
+  #------------------------------------------------------------------------------
+  def forum_users
+    respond_to do |format|
+      format.json { render json: ForumUserDatatable.new(view_context, @forum) }
+    end
+  end
+  
+  # Add user(s) to forum.
+  # => user_id: add a single user
+  #------------------------------------------------------------------------------
+  def forum_add_member
+    if !params[:user_id].blank?
+      user = User.find(params[:user_id])
+      @forum.add_member(user)
+      redirect_to admin_forum_url(@forum), notice: "Forum access granted for #{user.full_name}"
+    else
+      redirect_to admin_forum_url(@forum), alert: "Incorrect parameters supplied"
+    end
+  end
+  
+  #------------------------------------------------------------------------------
+  def forum_delete_member
+    user = User.find(params[:user_id])
+    @forum.remove_member(user)
+    redirect_to admin_forum_url(@forum), notice: "Forum access removed for #{user.full_name}"
+  end
+  
+private
+
+  #------------------------------------------------------------------------------
+  def category_lookup
+    @forum_category = ForumCategory.find(params[:forum_category_id])
+  end
+
+  #------------------------------------------------------------------------------
+  def forum_lookup
+    @forum = Forum.friendly.find(params[:id])
+    @forum_category = @forum.forum_category
+  end
+
+end

data/app/controllers/dm_forum/application_controller.rb

@@ -0,0 +1,25 @@
+# Subclass from main ApplicationController, which will subclass from DmCore
+#------------------------------------------------------------------------------
+class DmForum::ApplicationController < ::ApplicationController
+  include ApplicationHelper  
+
+  #--- these are needed to support rendering layouts built for the CMS
+  helper    DmCms::RenderHelper
+  helper    DmCore::LiquidHelper
+  helper    DmCms::PagesHelper
+  include   DmCore::RenderHelper
+
+  #before_filter :authenticate_user!
+
+  layout    'forum_templates/forum_list'
+
+  rescue_from ActiveRecord::RecordNotFound, :with => :record_not_found
+  
+private
+
+  #------------------------------------------------------------------------------
+  def record_not_found
+    flash[:error] = "The forum or discussion you were looking for could not be found."
+    redirect_to forum_root_path
+  end
+end

data/app/controllers/dm_forum/forum_comments_controller.rb

@@ -0,0 +1,88 @@
+class DmForum::ForumCommentsController < DmForum::ApplicationController
+  include DmForum::PermittedParams
+  include ActionView::RecordIdentifier        # for the dom_id method
+  
+  before_filter :find_parents
+  before_filter :find_post, :only => [:edit, :update, :destroy]
+
+  # {todo} look into caching and sweepers - most of our stuff is not directly public
+  #cache_sweeper :forum_comments_sweeper, :only => [:create, :update, :destroy]
+
+  # /posts
+  # /users/1/posts
+  # /forums/1/posts
+  # /forums/1/topics/1/posts
+  #------------------------------------------------------------------------------
+  def index
+    @followed         = user_signed_in? && params[:followed]
+    @q                = params[:q] ? params[:q].purify : nil
+    @posts            = (@parent ? @parent.forum_comments : ForumSite.site.forum_comments).search(@q, :page => page_number)
+    @followed_posts   = user_signed_in? ? (@parent ? @parent.forum_comments : ForumSite.site.forum_comments).search_followed(current_user.id, @q, :page => page_number) : nil
+    @users            = @user ? {@user.id => @user} : User.index_from(@posts)
+  end
+
+  #------------------------------------------------------------------------------
+  def show
+    redirect_to forum_forum_topic_path(@forum, @forum_topic)
+  end
+
+  #------------------------------------------------------------------------------
+  def edit
+  end
+
+  #------------------------------------------------------------------------------
+  def create
+    @forum_comment = ForumComment.create_comment(@forum_topic, params[:forum_comment][:body], current_user)    
+    if @forum_comment.new_record?
+      redirect_to forum_forum_topic_path(@forum, @forum_topic)
+    else
+      current_user.following.follow(@forum_topic)
+      flash[:notice] = 'Comment successfully created.'
+      redirect_to(forum_forum_topic_path(@forum, @forum_topic, {:anchor => dom_id(@forum_comment), :page => @forum_topic.last_page}))
+    end
+  end
+
+  #------------------------------------------------------------------------------
+  def update
+    if @forum_comment.update_attributes(forum_comment_params)
+      flash[:notice] = 'Post was successfully updated.'
+      redirect_to(forum_forum_topic_path(@forum, @forum_topic, {:anchor => dom_id(@forum_comment), :page => @forum_topic.comment_page(@forum_comment)}))
+    else
+      render :action => :edit
+    end
+  end
+
+  #------------------------------------------------------------------------------
+  def destroy
+    @forum_comment.destroy
+
+    if @forum.forum_topics.exists?(@forum_topic)
+      redirect_to forum_forum_topic_path(@forum, @forum_topic)
+    else
+      redirect_to @forum
+    end
+  end
+
+protected
+
+  #------------------------------------------------------------------------------
+  def find_parents
+    if params[:user_id]
+      @parent = @user = User.find(params[:user_id])
+    elsif params[:forum_id]
+      @parent = @forum        = Forum.find_by_slug!(params[:forum_id])
+      @parent = @forum_topic  = @forum.forum_topics.find_by_slug(params[:forum_topic_id]) if params[:forum_topic_id]
+      authorize! :read, @forum
+    end
+  end
+
+  #------------------------------------------------------------------------------
+  def find_post
+    forum_comment = @forum_topic.forum_comments.find(params[:id])
+    if forum_comment.user == current_user || can?(:moderate, @forum)
+      @forum_comment = forum_comment
+    else
+      raise ActiveRecord::RecordNotFound
+    end
+  end
+end

data/app/controllers/dm_forum/forum_topics_controller.rb

@@ -0,0 +1,93 @@
+class DmForum::ForumTopicsController < DmForum::ApplicationController
+  include DmForum::PermittedParams
+
+  before_filter :find_forum
+  before_filter :find_topic, :only => [:show, :edit, :update, :destroy]
+  # before_filter :admin_required, :only => [:edit, :update, :destroy]
+  # 
+
+  layout    'forum_templates/forum_list'
+
+  #------------------------------------------------------------------------------
+  def index
+    respond_to do |format|
+      format.html { redirect_to forum_path(@forum) }
+      format.xml  do
+        @forum_topics = find_forum.topics.paginate(:page => page_number)
+        render :xml  => @forum_topics
+      end
+    end
+  end
+  
+  #------------------------------------------------------------------------------
+  def show
+    (session[:forum_topics] ||= {})[@forum_topic.id] = Time.now.utc if user_signed_in?
+    @forum_topic.hit! unless user_signed_in? && @forum_topic.user_id == current_user.id
+    @forum_comments = @forum_topic.forum_comments.paginate :page => page_number
+    @forum_comment  = ForumComment.new
+    @following      = user_signed_in? && @forum_topic.followed_by?(current_user.following)
+  end
+  
+  #------------------------------------------------------------------------------
+  def new
+    @forum_topic = @forum.forum_topics.new
+  end
+  
+  #------------------------------------------------------------------------------
+  def create
+    params[:forum_topic].delete(:forum_id)
+    @forum_topic = @forum.forum_topics.new(forum_topic_params)
+    @forum_topic.user = current_user
+    if @forum_topic.save
+      current_user.following.follow(@forum_topic)
+      redirect_to forum_forum_topic_path(@forum, @forum_topic), notice: 'Topic was successfully created.'
+    else
+      render :action => :new
+    end
+  end
+  
+  #------------------------------------------------------------------------------
+  def edit
+  end
+  
+  #------------------------------------------------------------------------------
+  def update
+    #current_user.revise @topic, params[:topic]
+    attributes = forum_topic_params
+    @forum_topic.title = attributes[:title] if attributes.key?(:title)
+    @forum_topic.sticky, @forum_topic.locked, @forum_topic.forum_id = attributes[:sticky], attributes[:locked], attributes[:forum_id] if can?(:moderate, @forum_topic.forum)
+    @forum_topic.save
+    if @forum_topic.errors.empty?
+      flash[:notice] = 'Topic was successfully updated.'
+      redirect_to(forum_forum_topic_path(Forum.find(@forum_topic.forum_id), @forum_topic))
+    else
+      render :action => "edit"
+    end
+  end
+  
+  #------------------------------------------------------------------------------
+  def destroy
+    @forum_topic.destroy if is_admin?
+    redirect_to @forum
+  end
+  
+  #------------------------------------------------------------------------------
+  def toggle_follow
+    @forum_topic  = @forum.forum_topics.find(params[:forum_topic_id])
+    @following    = current_user.following.following?(@forum_topic)
+    @following    ? current_user.following.stop_following(@forum_topic) : current_user.following.follow(@forum_topic)
+  end
+  
+protected
+  
+  #------------------------------------------------------------------------------
+  def find_forum
+    @forum = Forum.find_by_slug!(params[:forum_id])
+    authorize! :read, @forum
+  end
+  
+  #------------------------------------------------------------------------------
+  def find_topic
+    @forum_topic = @forum.forum_topics.find_by_slug!(params[:id])
+  end
+end

data/app/controllers/dm_forum/forums_controller.rb

@@ -0,0 +1,45 @@
+class DmForum::ForumsController < DmForum::ApplicationController
+  include ApplicationHelper  
+
+  #--- these are needed to support rendering layouts built for the CMS
+  helper DmCms::RenderHelper
+  helper DmCore::LiquidHelper
+  helper DmCms::PagesHelper
+  include DmCore::RenderHelper
+  
+  before_filter   :forum_lookup, :except =>  [:list, :categories]
+
+  layout    'forum_templates/forum_list', :only => [:list, :show, :categories]
+  
+  #------------------------------------------------------------------------------
+  def categories
+    @forum_categories = ForumCategory.ordered
+  end
+  
+  # GET /forum
+  #------------------------------------------------------------------------------
+  def list
+    @forums = Forum.available_to_user(current_user)
+  end
+
+  # GET /forum/:slug
+  #------------------------------------------------------------------------------
+  def show
+    (session[:forums]       ||= {})[@forum.id] = Time.now.utc
+    (session[:forums_page]  ||= Hash.new(1))[@forum.id] = page_number if page_number > 1
+    @followed                 = user_signed_in? && params[:followed]
+    @forum_topics           ||= @forum.forum_topics.paginate :page => page_number
+    @followed_topics        ||= user_signed_in? ? 
+        (@forum.followed_topics(current_user).paginate :page => page_number) :
+        nil
+  end
+
+protected
+
+  #------------------------------------------------------------------------------
+  def forum_lookup
+    @forum = Forum.find_by_slug!(params[:id])
+    authorize! :read, @forum
+  end
+
+end