help_center 0.0.5 → 0.0.6

data/app/helpers/help_center/support_posts_helper.rb

@@ -1,29 +1,29 @@
-module HelpCenter::SupportPostsHelper
-  # Override this to use avatars from other places than Gravatar
-  def avatar_tag(email)
-    gravatar_image_tag(email, gravatar: { size: 40 }, class: "rounded avatar")
-  end
-
-  def support_category_link(category)
-    link_to category.name, help_center.support_category_path(category),
-      style: "color: #{category.color}"
-  end
-
-  # Override this method to provide your own content formatting like Markdown
-  def formatted_content(text)
-    simple_format(text)
-  end
-
-  def support_post_classes(support_post)
-    klasses = ["support-post", "card", "mb-3"]
-    klasses << "solved" if support_post.solved?
-    klasses << "original-poster" if support_post.user == @support_thread.user
-    klasses
-  end
-
-  def support_user_badge(user)
-    if user.respond_to?(:moderator) && user.moderator?
-      content_tag :span, "Mod", class: "badge badge-default"
-    end
-  end
-end
+module HelpCenter::SupportPostsHelper
+  # Override this to use avatars from other places than Gravatar
+  def avatar_tag(email)
+    gravatar_image_tag(email, gravatar: { size: 40 }, class: "rounded avatar")
+  end
+
+  def support_category_link(category)
+    link_to category.name, help_center.support_category_path(category),
+      style: "color: #{category.color}"
+  end
+
+  # Override this method to provide your own content formatting like Markdown
+  def formatted_content(text)
+    simple_format(text)
+  end
+
+  def support_post_classes(support_post)
+    klasses = ["support-post", "card", "mb-3"]
+    klasses << "solved" if support_post.solved?
+    klasses << "original-poster" if support_post.user == @support_thread.user
+    klasses
+  end
+
+  def support_user_badge(user)
+    if user.respond_to?(:moderator) && user.moderator?
+      content_tag :span, "Mod", class: "badge badge-default"
+    end
+  end
+end

data/app/helpers/help_center/support_threads_helper.rb

@@ -1,28 +1,28 @@
-module HelpCenter::SupportThreadsHelper
-  # Used for flagging links in the navbar as active
-  def support_link_to(path, opts={}, &block)
-    link_to path, class: support_link_class(path, opts), &block
-  end
-
-  def support_link_class(matches, opts={})
-    case matches
-    when Array
-      "active" if matches.any?{ |m| request.path.starts_with?(m) }
-    when String
-      "active" if opts.fetch(:exact, false) ? request.path == matches : request.path.starts_with?(matches)
-    end
-  end
-
-  # A nice hack to manipulate the layout so we can have sub-layouts
-  # without any changes in the user's application.
-  #
-  # We use this for rendering the sidebar layout for all the support pages
-  #
-  # https://mattbrictson.com/easier-nested-layouts-in-rails
-  #
-  def parent_layout(layout)
-    @view_flow.set(:layout, output_buffer)
-    output = render(file: "layouts/#{layout}")
-    self.output_buffer = ActionView::OutputBuffer.new(output)
-  end
-end
+module HelpCenter::SupportThreadsHelper
+  # Used for flagging links in the navbar as active
+  def support_link_to(path, opts={}, &block)
+    link_to path, class: support_link_class(path, opts), &block
+  end
+
+  def support_link_class(matches, opts={})
+    case matches
+    when Array
+      "active" if matches.any?{ |m| request.path.starts_with?(m) }
+    when String
+      "active" if opts.fetch(:exact, false) ? request.path == matches : request.path.starts_with?(matches)
+    end
+  end
+
+  # A nice hack to manipulate the layout so we can have sub-layouts
+  # without any changes in the user's application.
+  #
+  # We use this for rendering the sidebar layout for all the support pages
+  #
+  # https://mattbrictson.com/easier-nested-layouts-in-rails
+  #
+  def parent_layout(layout)
+    @view_flow.set(:layout, output_buffer)
+    output = render(template: "layouts/#{layout}")
+    self.output_buffer = ActionView::OutputBuffer.new(output)
+  end
+end

data/app/jobs/help_center/support_post_notification_job.rb

@@ -1,42 +1,42 @@
-class HelpCenter::SupportPostNotificationJob < ApplicationJob
-  include HelpCenter::Engine.routes.url_helpers
-
-  def perform(support_post)
-    send_emails(support_post) if HelpCenter.send_email_notifications
-    send_webhook(support_post) if HelpCenter.send_slack_notifications
-  end
-
-  def send_emails(support_post)
-    support_thread = support_post.support_thread
-    users        = support_thread.subscribed_users - [support_post.user]
-    users.each do |user|
-      HelpCenter::UserMailer.new_post(support_post, user).deliver_later
-    end
-  end
-
-  def send_webhook(support_post)
-    slack_webhook_url = Rails.application.secrets.help_center_slack_url
-    return if slack_webhook_url.blank?
-
-    support_thread = support_post.support_thread
-    payload = {
-      fallback: "#{support_post.user.name} replied to <#{support_thread_url(support_thread, anchor: ActionView::RecordIdentifier.dom_id(support_post))}|#{support_thread.title}>",
-      pretext: "#{support_post.user.name} replied to <#{support_thread_url(support_thread, anchor: ActionView::RecordIdentifier.dom_id(support_post))}|#{support_thread.title}>",
-      fields: [
-        {
-          title: "Thread",
-          value: support_thread.title,
-          short: true
-        },
-        {
-          title: "Posted By",
-          value: support_post.user.name,
-          short: true,
-        },
-      ],
-      ts: support_post.created_at.to_i
-    }
-
-    HelpCenter::Slack.new(slack_webhook_url).post(payload)
-  end
-end
+class HelpCenter::SupportPostNotificationJob < ApplicationJob
+  include HelpCenter::Engine.routes.url_helpers
+
+  def perform(support_post)
+    send_emails(support_post) if HelpCenter.send_email_notifications
+    send_webhook(support_post) if HelpCenter.send_slack_notifications
+  end
+
+  def send_emails(support_post)
+    support_thread = support_post.support_thread
+    users        = support_thread.subscribed_users - [support_post.user]
+    users.each do |user|
+      HelpCenter::UserMailer.new_post(support_post, user).deliver_later
+    end
+  end
+
+  def send_webhook(support_post)
+    slack_webhook_url = Rails.application.secrets.help_center_slack_url
+    return if slack_webhook_url.blank?
+
+    support_thread = support_post.support_thread
+    payload = {
+      fallback: "#{support_post.user.name} replied to <#{support_thread_url(support_thread, anchor: ActionView::RecordIdentifier.dom_id(support_post))}|#{support_thread.title}>",
+      pretext: "#{support_post.user.name} replied to <#{support_thread_url(support_thread, anchor: ActionView::RecordIdentifier.dom_id(support_post))}|#{support_thread.title}>",
+      fields: [
+        {
+          title: "Thread",
+          value: support_thread.title,
+          short: true
+        },
+        {
+          title: "Posted By",
+          value: support_post.user.name,
+          short: true,
+        },
+      ],
+      ts: support_post.created_at.to_i
+    }
+
+    HelpCenter::Slack.new(slack_webhook_url).post(payload)
+  end
+end

data/app/jobs/help_center/support_thread_notification_job.rb

@@ -1,40 +1,40 @@
-class HelpCenter::SupportThreadNotificationJob < ApplicationJob
-  include HelpCenter::Engine.routes.url_helpers
-
-  def perform(support_thread)
-    send_emails(support_thread) if HelpCenter.send_email_notifications
-    send_webhook(support_thread) if HelpCenter.send_slack_notifications
-  end
-
-  def send_emails(support_thread)
-    support_thread.notify_users.each do |user|
-      HelpCenter::UserMailer.new_thread(support_thread, user).deliver_later
-    end
-  end
-
-  def send_webhook(support_thread)
-    slack_webhook_url = Rails.application.secrets.simple_discussion_slack_url
-    return if slack_webhook_url.blank?
-
-    support_post = support_thread.support_posts.first
-    payload = {
-      fallback: "A new discussion was started: <#{support_thread_url(support_thread, anchor: ActionView::RecordIdentifier.dom_id(support_posts))}|#{support_thread.title}>",
-      pretext: "A new discussion was started: <#{support_thread_url(support_thread, anchor: ActionView::RecordIdentifier.dom_id(support_posts))}|#{support_thread.title}>",
-      fields: [
-        {
-          title: "Thread",
-          value: support_thread.title,
-          short: true
-        },
-        {
-          title: "Posted By",
-          value: support_post.user.name,
-          short: true,
-        },
-      ],
-      ts: support_post.created_at.to_i
-    }
-
-    HelpCenter::Slack.new(slack_webhook_url).post(payload)
-  end
-end
+class HelpCenter::SupportThreadNotificationJob < ApplicationJob
+  include HelpCenter::Engine.routes.url_helpers
+
+  def perform(support_thread)
+    send_emails(support_thread) if HelpCenter.send_email_notifications
+    send_webhook(support_thread) if HelpCenter.send_slack_notifications
+  end
+
+  def send_emails(support_thread)
+    support_thread.notify_users.each do |user|
+      HelpCenter::UserMailer.new_thread(support_thread, user).deliver_later
+    end
+  end
+
+  def send_webhook(support_thread)
+    slack_webhook_url = Rails.application.secrets.simple_discussion_slack_url
+    return if slack_webhook_url.blank?
+
+    support_post = support_thread.support_posts.first
+    payload = {
+      fallback: "A new discussion was started: <#{support_thread_url(support_thread, anchor: ActionView::RecordIdentifier.dom_id(support_posts))}|#{support_thread.title}>",
+      pretext: "A new discussion was started: <#{support_thread_url(support_thread, anchor: ActionView::RecordIdentifier.dom_id(support_posts))}|#{support_thread.title}>",
+      fields: [
+        {
+          title: "Thread",
+          value: support_thread.title,
+          short: true
+        },
+        {
+          title: "Posted By",
+          value: support_post.user.name,
+          short: true,
+        },
+      ],
+      ts: support_post.created_at.to_i
+    }
+
+    HelpCenter::Slack.new(slack_webhook_url).post(payload)
+  end
+end

data/app/mailers/help_center/user_mailer.rb

@@ -1,28 +1,28 @@
-class HelpCenter::UserMailer < ApplicationMailer
-  # You can set the default `from` address in ApplicationMailer
-
-  helper HelpCenter::SupportPostsHelper
-  helper HelpCenter::Engine.routes.url_helpers
-
-  def new_thread(support_thread, recipient)
-    @support_thread = support_thread
-    @support_post   = support_thread.support_posts.first
-    @recipient    = recipient
-
-    mail(
-      to: "#{@recipient.name} <#{@recipient.email}>",
-      subject: @support_thread.title
-    )
-  end
-
-  def new_post(support_post, recipient)
-    @support_post   = support_post
-    @support_thread = support_post.support_thread
-    @recipient    = recipient
-
-    mail(
-      to: "#{@recipient.name} <#{@recipient.email}>",
-      subject: "New post in #{@support_thread.title}"
-    )
-  end
-end
+class HelpCenter::UserMailer < ApplicationMailer
+  # You can set the default `from` address in ApplicationMailer
+
+  helper HelpCenter::SupportPostsHelper
+  helper HelpCenter::Engine.routes.url_helpers
+
+  def new_thread(support_thread, recipient)
+    @support_thread = support_thread
+    @support_post   = support_thread.support_posts.first
+    @recipient    = recipient
+
+    mail(
+      to: "#{@recipient.name} <#{@recipient.email}>",
+      subject: @support_thread.title
+    )
+  end
+
+  def new_post(support_post, recipient)
+    @support_post   = support_post
+    @support_thread = support_post.support_thread
+    @recipient    = recipient
+
+    mail(
+      to: "#{@recipient.name} <#{@recipient.email}>",
+      subject: "New post in #{@support_thread.title}"
+    )
+  end
+end

data/app/models/support_category.rb

@@ -1,13 +1,16 @@
-class SupportCategory < ApplicationRecord
-  extend FriendlyId
-  friendly_id :name, use: :slugged
-
-  scope :sorted, ->{ order(position: :asc) }
-
-  validates :name, :slug, :color, presence: true
-
-  def color
-    colour = super
-    colour.start_with?("#") ? colour : "##{colour}"
-  end
-end
+class SupportCategory < ApplicationRecord
+  extend FriendlyId
+  friendly_id :name, use: :slugged
+  
+  has_many :support_threads
+  has_rich_text :description
+
+  scope :sorted, ->{ order(position: :asc) }
+
+  validates :name, :slug, :color, presence: true
+
+  def color
+    colour = super
+    colour.start_with?("#") ? colour : "##{colour}"
+  end
+end

data/app/models/support_post.rb

@@ -1,15 +1,15 @@
-class SupportPost < ApplicationRecord
-  belongs_to :support_thread, counter_cache: true, touch: true
-  belongs_to :user
-  has_many :reactions, as: :reactable
-
-  validates :user_id, :body, presence: true
-
-  scope :sorted, ->{ order(:created_at) }
-
-  after_update :solve_support_thread, if: :solved?
-
-  def solve_support_thread
-    support_thread.update(solved: true)
-  end
-end
+class SupportPost < ApplicationRecord
+  belongs_to :support_thread, counter_cache: true, touch: true
+  belongs_to :user
+  has_many :reactions, as: :reactable
+
+  validates :user_id, :body, presence: true
+
+  scope :sorted, ->{ order(:created_at) }
+
+  after_update :solve_support_thread, if: :solved?
+
+  def solve_support_thread
+    support_thread.update(solved: true)
+  end
+end

data/app/models/support_subscription.rb

@@ -1,19 +1,19 @@
-class SupportSubscription < ApplicationRecord
-  belongs_to :support_thread
-  belongs_to :user
-
-  scope :optin, ->{ where(subscription_type: :optin) }
-  scope :optout, ->{ where(subscription_type: :optout) }
-
-  validates :subscription_type, presence: true, inclusion: { in: %w{ optin optout } }
-  validates :user_id, uniqueness: { scope: :support_thread_id }
-
-  def toggle!
-    case subscription_type
-    when "optin"
-      update(subscription_type: "optout")
-    when "optout"
-      update(subscription_type: "optin")
-    end
-  end
-end
+class SupportSubscription < ApplicationRecord
+  belongs_to :support_thread
+  belongs_to :user
+
+  scope :optin, ->{ where(subscription_type: :optin) }
+  scope :optout, ->{ where(subscription_type: :optout) }
+
+  validates :subscription_type, presence: true, inclusion: { in: %w{ optin optout } }
+  validates :user_id, uniqueness: { scope: :support_thread_id }
+
+  def toggle!
+    case subscription_type
+    when "optin"
+      update(subscription_type: "optout")
+    when "optout"
+      update(subscription_type: "optin")
+    end
+  end
+end

data/app/models/support_thread.rb

@@ -1,85 +1,85 @@
-class SupportThread < ApplicationRecord
-  extend FriendlyId
-  friendly_id :title, use: :slugged
-
-  belongs_to :support_category
-  belongs_to :user
-  has_many :support_posts
-  has_many :support_subscriptions
-  has_many :optin_subscribers,  ->{ where(support_subscriptions: { subscription_type: :optin }) },  through: :support_subscriptions, source: :user
-  has_many :optout_subscribers, ->{ where(support_subscriptions: { subscription_type: :optout }) }, through: :support_subscriptions, source: :user
-  has_many :users, through: :support_posts
-
-  has_rich_text :content
-
-  accepts_nested_attributes_for :support_posts
-
-  validates :support_category, presence: true
-  validates :user_id, :title, presence: true
-  validates_associated :support_posts
-
-  scope :pinned_first, ->{ order(pinned: :desc) }
-  scope :solved,       ->{ where(solved: true) }
-  scope :sorted,       ->{ order(position: :asc) }
-  scope :unpinned,     ->{ where.not(pinned: true) }
-  scope :unsolved,     ->{ where.not(solved: true) }
-
-  def subscribed_users
-    (users + optin_subscribers).uniq - optout_subscribers
-  end
-
-  def subscription_for(user)
-    return nil if user.nil?
-    support_subscriptions.find_by(user_id: user.id)
-  end
-
-  def subscribed?(user)
-    return false if user.nil?
-
-    subscription = subscription_for(user)
-
-    if subscription.present?
-      subscription.subscription_type == "optin"
-    else
-      support_posts.where(user_id: user.id).any?
-    end
-  end
-
-  def toggle_subscription(user)
-    subscription = subscription_for(user)
-
-    if subscription.present?
-      subscription.toggle!
-    elsif support_posts.where(user_id: user.id).any?
-      support_subscriptions.create(user: user, subscription_type: "optout")
-    else
-      support_subscriptions.create(user: user, subscription_type: "optin")
-    end
-  end
-
-  def subscribed_reason(user)
-    return I18n.t('.not_receiving_notifications') if user.nil?
-
-    subscription = subscription_for(user)
-
-    if subscription.present?
-      if subscription.subscription_type == "optout"
-        I18n.t('.ignoring_thread')
-      elsif subscription.subscription_type == "optin"
-        I18n.t('.receiving_notifications_because_subscribed')
-      end
-    elsif support_posts.where(user_id: user.id).any?
-      I18n.t('.receiving_notifications_because_posted')
-    else
-      I18n.t('.not_receiving_notifications')
-    end
-  end
-
-  # These are the users to notify on a new thread. Currently this does nothing,
-  # but you can override this to provide whatever functionality you like here.
-  #
-  # For example: You might use this to send all moderators an email of new threads.
-  def notify_users
-    []
-  end
-end
+class SupportThread < ApplicationRecord
+  extend FriendlyId
+  friendly_id :title, use: :slugged
+
+  belongs_to :support_category
+  belongs_to :user
+  has_many :support_posts
+  has_many :support_subscriptions
+  has_many :optin_subscribers,  ->{ where(support_subscriptions: { subscription_type: :optin }) },  through: :support_subscriptions, source: :user
+  has_many :optout_subscribers, ->{ where(support_subscriptions: { subscription_type: :optout }) }, through: :support_subscriptions, source: :user
+  has_many :users, through: :support_posts
+
+  has_rich_text :content
+
+  accepts_nested_attributes_for :support_posts
+
+  validates :support_category, presence: true
+  validates :user_id, :title, presence: true
+  validates_associated :support_posts
+
+  scope :pinned_first, ->{ order(pinned: :desc) }
+  scope :solved,       ->{ where(solved: true) }
+  scope :sorted,       ->{ order(position: :asc) }
+  scope :unpinned,     ->{ where.not(pinned: true) }
+  scope :unsolved,     ->{ where.not(solved: true) }
+
+  def subscribed_users
+    (users + optin_subscribers).uniq - optout_subscribers
+  end
+
+  def subscription_for(user)
+    return nil if user.nil?
+    support_subscriptions.find_by(user_id: user.id)
+  end
+
+  def subscribed?(user)
+    return false if user.nil?
+
+    subscription = subscription_for(user)
+
+    if subscription.present?
+      subscription.subscription_type == "optin"
+    else
+      support_posts.where(user_id: user.id).any?
+    end
+  end
+
+  def toggle_subscription(user)
+    subscription = subscription_for(user)
+
+    if subscription.present?
+      subscription.toggle!
+    elsif support_posts.where(user_id: user.id).any?
+      support_subscriptions.create(user: user, subscription_type: "optout")
+    else
+      support_subscriptions.create(user: user, subscription_type: "optin")
+    end
+  end
+
+  def subscribed_reason(user)
+    return I18n.t('.not_receiving_notifications') if user.nil?
+
+    subscription = subscription_for(user)
+
+    if subscription.present?
+      if subscription.subscription_type == "optout"
+        I18n.t('.ignoring_thread')
+      elsif subscription.subscription_type == "optin"
+        I18n.t('.receiving_notifications_because_subscribed')
+      end
+    elsif support_posts.where(user_id: user.id).any?
+      I18n.t('.receiving_notifications_because_posted')
+    else
+      I18n.t('.not_receiving_notifications')
+    end
+  end
+
+  # These are the users to notify on a new thread. Currently this does nothing,
+  # but you can override this to provide whatever functionality you like here.
+  #
+  # For example: You might use this to send all moderators an email of new threads.
+  def notify_users
+    []
+  end
+end