thredded 0.1.0 → 0.2.2

data/app/decorators/thredded/base_topic_decorator.rb

@@ -0,0 +1,14 @@
+module Thredded
+  class BaseTopicDecorator < SimpleDelegator
+    include Rails.application.routes.url_helpers
+    include ActionView::Helpers::UrlHelper
+
+    def slug
+      __getobj__.slug.nil? ? id : __getobj__.slug
+    end
+
+    def original
+      __getobj__
+    end
+  end
+end

data/app/decorators/thredded/base_user_topic_decorator.rb

@@ -0,0 +1,63 @@
+module Thredded
+  class BaseUserTopicDecorator < SimpleDelegator
+    extend ActiveModel::Naming
+    include ActiveModel::Conversion
+
+    class << self
+      # @return [Class<ActiveRecord::Base>]
+      def topic_class
+        fail 'Implement in subclass'
+      end
+
+      def decorator_class
+        "#{topic_class.name}Decorator".constantize
+      end
+
+      def decorate_all(user, topics)
+        topics.map { |topic| new(user, topic) }
+      end
+
+      def model_name
+        ActiveModel::Name.new(self, nil, topic_class.name.demodulize)
+      end
+    end
+
+    def initialize(user, topic)
+      @user  = user || Thredded::NullUser.new
+      @topic = self.class.decorator_class.new(topic)
+      super(@topic)
+    end
+
+    def to_model
+      topic
+    end
+
+    def persisted?
+      false
+    end
+
+    def css_class
+      [read_status_class, topic.css_class].map(&:presence).compact.join(' ')
+    end
+
+    def read_status_class
+      if read?
+        'thredded--topic--read'
+      else
+        'thredded--topic--unread'
+      end
+    end
+
+    def read?
+      fail 'Subclass responsibility'
+    end
+
+    def to_ary
+      [self]
+    end
+
+    private
+
+    attr_reader :topic, :user
+  end
+end

data/app/decorators/thredded/messageboard_decorator.rb

@@ -0,0 +1,41 @@
+module Thredded
+  class MessageboardDecorator < SimpleDelegator
+    include ActionView::Helpers::NumberHelper
+    include ActionView::Helpers::TagHelper
+
+    def initialize(messageboard)
+      super
+      @messageboard = messageboard
+    end
+
+    def original
+      messageboard
+    end
+
+    def meta
+      topics_count = number_to_human(messageboard.topics_count)
+      posts_count = number_to_human(messageboard.posts_count)
+
+      "#{topics_count} topics / #{posts_count} posts".downcase
+    end
+
+    def latest_topic
+      @latest_topic ||= begin
+        messageboard.topics.order_latest_first.first ||
+          Thredded::NullTopic.new
+      end
+    end
+
+    def latest_user
+      latest_topic.last_user
+    end
+
+    def category_options
+      messageboard.categories.map { |cat| [cat.name, cat.id] }
+    end
+
+    private
+
+    attr_reader :messageboard
+  end
+end

data/app/decorators/thredded/post_decorator.rb

@@ -0,0 +1,40 @@
+module Thredded
+  class PostDecorator < SimpleDelegator
+    attr_reader :post
+
+    def initialize(post)
+      super
+      @post = post
+    end
+
+    def user_name
+      if user
+        user.to_s
+      else
+        'Anonymous'
+      end
+    end
+
+    def original
+      post
+    end
+
+    def avatar_url
+      super.sub(/\Ahttp:/, '')
+    end
+
+    def to_ary
+      [self]
+    end
+
+    private
+
+    def created_at_str
+      created_at.getutc.to_s
+    end
+
+    def created_at_utc
+      created_at.getutc.iso8601
+    end
+  end
+end

data/app/decorators/thredded/private_topic_decorator.rb

@@ -0,0 +1,23 @@
+require 'thredded/base_topic_decorator'
+
+module Thredded
+  class PrivateTopicDecorator < SimpleDelegator
+    def initialize(private_topic)
+      super Thredded::BaseTopicDecorator.new(private_topic)
+    end
+
+    def self.model_name
+      ActiveModel::Name.new(self, nil, 'PrivateTopic')
+    end
+
+    def to_model
+      __getobj__
+    end
+
+    def css_class
+      classes = []
+      classes << 'thredded--private-topic'
+      classes.join(' ')
+    end
+  end
+end

data/app/decorators/thredded/topic_decorator.rb

@@ -0,0 +1,25 @@
+require 'thredded/base_topic_decorator'
+
+module Thredded
+  class TopicDecorator < SimpleDelegator
+    def initialize(private_topic)
+      super(Thredded::BaseTopicDecorator.new(private_topic))
+    end
+
+    def self.model_name
+      ActiveModel::Name.new(self, nil, 'Topic')
+    end
+
+    def css_class
+      classes = []
+      classes << 'thredded--topic--locked' if locked?
+      classes << 'thredded--topic--sticky' if sticky?
+      classes += ['thredded--topic--category'] + categories.map { |c| "thredded--topic--category--#{c.name}" } if categories.present?
+      classes.join(' ')
+    end
+
+    def category_options
+      messageboard.decorate.category_options
+    end
+  end
+end

data/app/decorators/thredded/topic_email_decorator.rb

@@ -0,0 +1,24 @@
+module Thredded
+  class TopicEmailDecorator
+    # @param [Thredded::TopicCommon] topic
+    def initialize(topic)
+      @topic = topic
+    end
+
+    def smtp_api_tag(tag)
+      %({"category": ["thredded_#{@topic.private? ? 'private_topic' : @topic.messageboard.name}","#{tag}"]})
+    end
+
+    def subject
+      "#{Thredded.email_outgoing_prefix} #{@topic.title}"
+    end
+
+    def reply_to
+      Thredded.email_reply_to.call(@topic)
+    end
+
+    def no_reply
+      Thredded.email_from
+    end
+  end
+end

data/app/decorators/thredded/user_private_topic_decorator.rb

@@ -0,0 +1,13 @@
+require 'thredded/base_user_topic_decorator'
+
+module Thredded
+  class UserPrivateTopicDecorator < BaseUserTopicDecorator
+    def self.topic_class
+      PrivateTopic
+    end
+
+    def read?
+      topic.private_users.find_by(user: user).try(:read?)
+    end
+  end
+end

data/app/decorators/thredded/user_topic_decorator.rb

@@ -0,0 +1,37 @@
+require 'thredded/base_user_topic_decorator'
+
+module Thredded
+  class UserTopicDecorator < BaseUserTopicDecorator
+    def self.topic_class
+      Topic
+    end
+
+    def farthest_page
+      read_status.page
+    end
+
+    def farthest_post
+      read_status.farthest_post
+    end
+
+    def read?
+      topic.posts_count == read_status.posts_count
+    end
+
+    private
+
+    def read_status
+      if user.id > 0
+        @read_status ||= topic.user_topic_reads.select do |reads|
+          reads.user_id == user.id
+        end
+      end
+
+      if @read_status.blank?
+        Thredded::NullTopicRead.new
+      else
+        @read_status.first
+      end
+    end
+  end
+end

data/app/forms/thredded/private_topic_form.rb

@@ -0,0 +1,126 @@
+module Thredded
+  class PrivateTopicForm
+    include ActiveModel::Model
+
+    attr_accessor \
+      :title,
+      :category_ids,
+      :user_ids,
+      :locked,
+      :sticky,
+      :content,
+      :private_topic
+
+    attr_reader :user, :params
+
+    validate :validate_children
+
+    def initialize(params = {})
+      @params = params
+      @title = params[:title]
+      @category_ids = params[:category_ids] || []
+      @user_ids = params[:user_ids] || []
+      @user = params[:user] || fail('user is required')
+      @locked = params[:locked]
+      @sticky = params[:sticky]
+      @content = params[:content]
+    end
+
+    def self.model_name
+      Thredded::PrivateTopic.model_name
+    end
+
+    def users
+      @user.thredded_can_message_users
+    end
+
+    def users_for_select
+      (users - [@user]).map { |user| [user.to_s, user.id] }
+    end
+
+    def id
+      private_topic.id
+    end
+
+    def save
+      return false unless valid?
+
+      ActiveRecord::Base.transaction do
+        private_topic.save!
+        post.save!
+      end
+      true
+    end
+
+    def private_topic
+      @private_topic ||= Thredded::PrivateTopic.new(
+        title: title,
+        users: private_users,
+        user: non_null_user,
+        last_user: non_null_user)
+    end
+
+    def post
+      @post ||= private_topic.posts.build(
+        content: content,
+        user: non_null_user)
+    end
+
+    def users_selected_options
+      { selected: private_user_ids }
+    end
+
+    def users_select_html_options
+      {
+        multiple: true,
+        required: true,
+        'data-placeholder' => 'select users to participate in this topic',
+        'data-thredded-users-select' => true
+      }
+    end
+
+    private
+
+    def topic_categories
+      if category_ids
+        ids = category_ids.reject(&:empty?).map(&:to_i)
+        Category.where(id: ids)
+      else
+        []
+      end
+    end
+
+    def private_users
+      Thredded.user_class.where(id: normalized_user_ids)
+    end
+
+    def private_user_ids
+      private_users.map(&:id)
+    end
+
+    def normalized_user_ids
+      user_ids
+        .reject(&:empty?)
+        .map(&:to_i)
+        .push(user.id)
+        .uniq
+    end
+
+    # @return [Thredded.user_class, nil] return a user or nil if the user is a NullUser
+    # This is necessary because assigning a NullUser to an ActiveRecord association results in an exception.
+    def non_null_user
+      @user unless @user.thredded_anonymous?
+    end
+
+    def validate_children
+      promote_errors(private_topic.errors) if private_topic.invalid?
+      promote_errors(post.errors) if post.invalid?
+    end
+
+    def promote_errors(child_errors)
+      child_errors.each do |attribute, message|
+        errors.add(attribute, message)
+      end
+    end
+  end
+end

data/app/forms/thredded/topic_form.rb

@@ -0,0 +1,94 @@
+module Thredded
+  class TopicForm
+    include ActiveModel::Model
+
+    attr_accessor :title, :category_ids, :locked, :sticky, :content, :topic
+    attr_reader :user, :messageboard
+
+    validate :validate_children
+
+    def initialize(params = {})
+      @title = params[:title]
+      @category_ids = params[:category_ids]
+      @locked = params[:locked] || false
+      @sticky = params[:sticky] || false
+      @content = params[:content]
+      @user = params[:user] || fail('user is required')
+      @messageboard = params[:messageboard]
+    end
+
+    def self.model_name
+      Thredded::Topic.model_name
+    end
+
+    def categories
+      topic.messageboard.categories
+    end
+
+    def category_options
+      topic.messageboard.decorate.category_options
+    end
+
+    def filter
+      topic.messageboard.filter
+    end
+
+    def save
+      return false unless valid?
+
+      ActiveRecord::Base.transaction do
+        topic.save!
+        post.save!
+      end
+      true
+    end
+
+    def topic
+      @topic ||= messageboard.topics.build(
+        title: title,
+        locked: locked,
+        sticky: sticky,
+        user: non_null_user,
+        last_user: non_null_user,
+        categories: topic_categories,
+      )
+    end
+
+    def post
+      @post ||= topic.posts.build(
+        content: content,
+        user: non_null_user,
+        messageboard: messageboard,
+        filter: messageboard.filter
+      )
+    end
+
+    private
+
+    # @return [Thredded.user_class, nil] return a user or nil if the user is a NullUser
+    # This is necessary because assigning a NullUser to an ActiveRecord association results in an exception.
+    def non_null_user
+      @user unless @user.thredded_anonymous?
+    end
+
+    def topic_categories
+      if category_ids
+        ids = category_ids.reject(&:empty?).map(&:to_i)
+        Category.where(id: ids)
+      else
+        []
+      end
+    end
+
+    def validate_children
+      promote_errors(topic.errors) if topic.invalid?
+      promote_errors(post.errors) if post.invalid?
+    end
+
+    def promote_errors(child_errors)
+      child_errors.each do |attribute, message|
+        errors.add(attribute, message)
+      end
+    end
+  end
+end

data/app/helpers/thredded/application_helper.rb

@@ -0,0 +1,41 @@
+module Thredded
+  module ApplicationHelper
+    # Render the page container with the supplied block as content.
+    def thredded_page(&block)
+      # enable the host app to easily check whether a thredded view is being rendered:
+      content_for :thredded, true
+      content_for :thredded_page_content, &block
+      render partial: 'thredded/shared/page'
+    end
+
+    # @param user [Thredded.user_class, Thredded::NullUser]
+    # @return [String] path to the user as specified by {Thredded.user_path}
+    def user_path(user)
+      Thredded.user_path(self, user)
+    end
+
+    # @param user [Thredded.user_class, Thredded::NullUser]
+    # @return [String] html_safe link to the user
+    def user_link(user)
+      render partial: 'thredded/users/link', locals: { user: user }
+    end
+
+    # @param datetime [DateTime]
+    # @return [String] html_safe datetime presentation
+    def time_ago(datetime)
+      render partial: 'thredded/shared/time_ago', locals: { datetime: datetime }
+    end
+
+    def paginate(collection, args = {})
+      super(collection, args.reverse_merge(views_prefix: 'thredded'))
+    end
+
+    def edit_post_path(post)
+      if post.private_topic_post?
+        edit_private_topic_private_post_path(post.postable, post)
+      else
+        edit_messageboard_topic_post_path(messageboard, post.postable, post)
+      end
+    end
+  end
+end

data/app/jobs/thredded/activity_updater_job.rb

@@ -0,0 +1,20 @@
+module Thredded
+  class ActivityUpdaterJob < ::ActiveJob::Base
+    queue_as :default
+
+    def perform(user_id, messageboard_id)
+      now = Time.zone.now
+
+      user_detail = Thredded::UserDetail.for_user_id(user_id)
+      user_detail.update_column(:last_seen_at, now)
+
+      Thredded::MessageboardUser
+        .where(
+          thredded_messageboard_id: messageboard_id,
+          thredded_user_detail_id: user_detail.id
+        )
+        .first_or_initialize
+        .update!(last_seen_at: now)
+    end
+  end
+end

data/app/jobs/thredded/at_notifier_job.rb

@@ -0,0 +1,11 @@
+module Thredded
+  class AtNotifierJob < ::ActiveJob::Base
+    queue_as :default
+
+    def perform(post_type, post_id)
+      post = post_type.to_s.constantize.find(post_id)
+
+      NotifyMentionedUsers.new(post).run
+    end
+  end
+end

data/app/jobs/thredded/notify_private_topic_users_job.rb

@@ -0,0 +1,11 @@
+module Thredded
+  class NotifyPrivateTopicUsersJob < ::ActiveJob::Base
+    queue_as :default
+
+    def perform(private_topic_id)
+      private_topic = Thredded::PrivateTopic.find(private_topic_id)
+
+      NotifyPrivateTopicUsers.new(private_topic).run
+    end
+  end
+end

data/app/mailers/thredded/base_mailer.rb

@@ -0,0 +1,4 @@
+module Thredded
+  class BaseMailer < ActionMailer::Base
+  end
+end

data/app/mailers/thredded/post_mailer.rb

@@ -0,0 +1,15 @@
+module Thredded
+  class PostMailer < Thredded::BaseMailer
+    def at_notification(post_id, emails)
+      @post                = Post.find(post_id)
+      email_details        = TopicEmailDecorator.new(@post.postable)
+      headers['X-SMTPAPI'] = email_details.smtp_api_tag('at_notification')
+
+      mail from:     email_details.no_reply,
+           to:       email_details.no_reply,
+           bcc:      emails,
+           reply_to: email_details.reply_to,
+           subject:  email_details.subject
+    end
+  end
+end

data/app/mailers/thredded/private_post_mailer.rb

@@ -0,0 +1,15 @@
+module Thredded
+  class PrivatePostMailer < Thredded::BaseMailer
+    def at_notification(post_id, emails)
+      @post                = PrivatePost.find(post_id)
+      email_details        = TopicEmailDecorator.new(@post.postable)
+      headers['X-SMTPAPI'] = email_details.smtp_api_tag('at_notification')
+
+      mail from:     email_details.no_reply,
+           to:       email_details.no_reply,
+           bcc:      emails,
+           reply_to: email_details.reply_to,
+           subject:  email_details.subject
+    end
+  end
+end

data/app/mailers/thredded/private_topic_mailer.rb

@@ -0,0 +1,15 @@
+module Thredded
+  class PrivateTopicMailer < Thredded::BaseMailer
+    def message_notification(private_topic_id, emails)
+      @topic               = PrivateTopic.find(private_topic_id)
+      email_details        = TopicEmailDecorator.new(@topic)
+      headers['X-SMTPAPI'] = email_details.smtp_api_tag('private_topic_mailer')
+
+      mail from:     email_details.no_reply,
+           to:       email_details.no_reply,
+           bcc:      emails,
+           reply_to: email_details.reply_to,
+           subject:  email_details.subject
+    end
+  end
+end