dokno 1.0.0 → 1.3.0

data/config/routes.rb

@@ -3,8 +3,8 @@ Dokno::Engine.routes.draw do
   resources :articles
 
   get '/(:cat_code)',          to: 'categories#index',     as: :article_index
+  get '/up_for_review',        to: 'categories#index',     as: :up_for_review
   get 'article_panel/(:slug)', to: 'articles#panel',       as: :panel
-  post 'article_log',          to: 'articles#article_log', as: :article_log
   post 'article_preview',      to: 'articles#preview',     as: :preview
   post 'article_status',       to: 'articles#status',      as: :status
   root 'categories#index'

data/db/migrate/20201203190330_baseline.rb

@@ -13,12 +13,12 @@ class Baseline < ActiveRecord::Migration[6.0]
       t.string "slug"
       t.string "title"
       t.text "markdown"
-      t.datetime "created_at", precision: 6, null: false
-      t.datetime "updated_at", precision: 6, null: false
       t.text "summary"
       t.boolean "active", default: true
       t.bigint "views", default: 0
       t.datetime "last_viewed_at"
+      t.datetime "created_at", precision: 6, null: false
+      t.datetime "updated_at", precision: 6, null: false
       t.index ["slug"], name: "index_dokno_articles_on_slug", unique: true
     end
 
@@ -32,10 +32,10 @@ class Baseline < ActiveRecord::Migration[6.0]
 
     create_table "dokno_categories", force: :cascade do |t|
       t.string "name"
-      t.datetime "created_at", precision: 6, null: false
-      t.datetime "updated_at", precision: 6, null: false
       t.bigint "category_id"
       t.string "code", null: false
+      t.datetime "created_at", precision: 6, null: false
+      t.datetime "updated_at", precision: 6, null: false
       t.index ["category_id"], name: "index_dokno_categories_on_category_id"
       t.index ["code"], name: "index_dokno_categories_on_code", unique: true
       t.index ["name"], name: "index_dokno_categories_on_name", unique: true

data/db/migrate/20201211192306_add_review_due_at_to_articles.rb

@@ -0,0 +1,6 @@
+class AddReviewDueAtToArticles < ActiveRecord::Migration[6.0]
+  def change
+    add_column :dokno_articles, :review_due_at, :datetime
+    add_index :dokno_articles, :review_due_at
+  end
+end

data/db/migrate/20201213165700_add_starred_to_article.rb

@@ -0,0 +1,5 @@
+class AddStarredToArticle < ActiveRecord::Migration[6.0]
+  def change
+    add_column :dokno_articles, :starred, :boolean, default: false
+  end
+end

data/lib/dokno/config/config.rb

@@ -1,4 +1,8 @@
 module Dokno
+  module Error
+    class Config < StandardError; end
+  end
+
   def self.configure
     yield config
     config.validate
@@ -8,62 +12,71 @@ module Dokno
     @config ||= Config.new
   end
 
-  def self.config=(val)
-    @config = val
-  end
-
   class Config
-    # (String) Host application name for display within the mounted dashboard
-    attr_accessor :app_name
+    # Dokno configuration options
+    #
+    # app_name (String)
+    #   Host app name for display within the mounted dashboard
+    # tag_whitelist (Enumerable)
+    #   Determines which HTML tags are allowed in Article markdown
+    # attr_whitelist (Enumerable)
+    #   Determines which HTML attributes are allowed in Article markdown
+    # app_user_object (String)
+    #   Host app's user object
+    # app_user_auth_method (Symbol)
+    #   Host app's user object method to be used for edit authorization.
+    #   Should return boolean
+    # app_user_name_method (Symbol)
+    #   Host app's user object method that returns the authenticated user's name or other
+    #   identifier that will be included in change log events.
+    #   Should return a string
+    # article_review_period (ActiveSupport::Duration)
+    #   The amount of time before articles should be reviewed for accuracy/relevance
+    # article_review_prompt_days (Integer)
+    #   The number of days prior to an article being up for review that users should be prompted
 
-    # (Enumerable) Determines which HTML tags are allowed in Article markdown
+    attr_accessor :app_name
     attr_accessor :tag_whitelist
-
-    # (Enumerable) Determines which HTML attributes are allowed in Article markdown
     attr_accessor :attr_whitelist
-
-    # (String) Host application's user object
     attr_accessor :app_user_object
-
-    # (Symbol) Host application's user object method that should be used to authorize users to edit Dokno data
-    #   Should return boolean.
     attr_accessor :app_user_auth_method
-
-    # (Symbol) Host application's user object method that should return the authenticated user's name or other
-    #   identifier that will be included in change log events. Should return a string.
     attr_accessor :app_user_name_method
+    attr_accessor :article_review_period
+    attr_accessor :article_review_prompt_days
 
     # Defaults
-    TAG_WHITELIST        = %w[code img h1 h2 h3 h4 h5 h6 a em u i b strong ol ul li table thead tbody tfoot tr th td blockquote hr br p]
-    ATTR_WHITELIST       = %w[src alt title href target]
-    APP_USER_OBJECT      = 'current_user'
-    APP_USER_AUTH_METHOD = 'admin?'
-    APP_USER_NAME_METHOD = 'name'
+    TAG_WHITELIST              = %w[code img h1 h2 h3 h4 h5 h6 a em u i b strong ol ul li table thead tbody tfoot tr th td blockquote hr br p]
+    ATTR_WHITELIST             = %w[src alt title href target]
+    APP_USER_OBJECT            = 'current_user'
+    APP_USER_AUTH_METHOD       = :admin?
+    APP_USER_NAME_METHOD       = :name
+    ARTICLE_REVIEW_PERIOD      = 1.year
+    ARTICLE_REVIEW_PROMPT_DAYS = 30
 
     def initialize
-      self.app_name             = Rails.application.class.module_parent.name.underscore.humanize.upcase
-      self.tag_whitelist        = TAG_WHITELIST
-      self.attr_whitelist       = ATTR_WHITELIST
-      self.app_user_object      = APP_USER_OBJECT
-      self.app_user_auth_method = APP_USER_AUTH_METHOD
-      self.app_user_name_method = APP_USER_NAME_METHOD
+      self.app_name                   = Rails.application.class.module_parent.name.underscore.humanize.upcase
+      self.tag_whitelist              = TAG_WHITELIST
+      self.attr_whitelist             = ATTR_WHITELIST
+      self.app_user_object            = APP_USER_OBJECT
+      self.app_user_auth_method       = APP_USER_AUTH_METHOD
+      self.app_user_name_method       = APP_USER_NAME_METHOD
+      self.article_review_period      = ARTICLE_REVIEW_PERIOD
+      self.article_review_prompt_days = ARTICLE_REVIEW_PROMPT_DAYS
     end
 
     def validate
-      validate_tag_whitelist
-      validate_attr_whitelist
+      validate_config_option(option: 'tag_whitelist',              expected_class: Enumerable,              example: '%w[a p strong]')
+      validate_config_option(option: 'attr_whitelist',             expected_class: Enumerable,              example: '%w[class href]')
+      validate_config_option(option: 'app_user_object',            expected_class: String,                  example: 'current_user')
+      validate_config_option(option: 'app_user_auth_method',       expected_class: Symbol,                  example: ':admin?')
+      validate_config_option(option: 'app_user_name_method',       expected_class: Symbol,                  example: ':name')
+      validate_config_option(option: 'article_review_period',      expected_class: ActiveSupport::Duration, example: '1.year')
+      validate_config_option(option: 'article_review_prompt_days', expected_class: Integer,                 example: '30')
     end
 
-    def validate_tag_whitelist
-      return unless !tag_whitelist.is_a?(Enumerable)
-
-      raise "#{config_error_prefix} tag_whitelist must be Enumerable"
-    end
-
-    def validate_attr_whitelist
-      return unless !attr_whitelist.is_a?(Enumerable)
-
-      raise "#{config_error_prefix} attr_whitelist must be Enumerable"
+    def validate_config_option(option:, expected_class:, example:)
+      return unless !send(option.to_sym).is_a? expected_class
+      raise Error::Config, "#{config_error_prefix} #{option} must be #{expected_class}, e.g. #{example}"
     end
 
     def config_error_prefix

data/lib/dokno/engine.rb

@@ -4,10 +4,6 @@ module Dokno
   class Engine < ::Rails::Engine
     isolate_namespace Dokno
 
-    initializer 'Dokno precompile', group: :all do |app|
-      app.config.assets.precompile << "dokno_manifest.js"
-    end
-
     config.generators do |g|
       g.test_framework :rspec
     end
@@ -18,6 +14,10 @@ module Dokno
       end
     end
 
+    initializer 'Dokno precompile', group: :all do |app|
+      app.config.assets.precompile << "dokno_manifest.js"
+    end
+
     initializer 'local_helper.action_controller' do
       ActiveSupport.on_load :action_controller do
         helper Dokno::ApplicationHelper

data/lib/dokno/version.rb

@@ -1,3 +1,3 @@
 module Dokno
-  VERSION = '1.0.0'
+  VERSION = '1.3.0'
 end

data/lib/generators/dokno/templates/config/initializers/dokno.rb

@@ -1,14 +1,27 @@
 Dokno.configure do |config|
-  config.tag_whitelist          = Dokno::Config::TAG_WHITELIST
-  config.attr_whitelist         = Dokno::Config::ATTR_WHITELIST
+  # To control the permitted HTML tags and attributes within articles,
+  # uncomment and change the defaults.
+  #   (Enumerable) tag_whitelist
+  #   (Enumerable) attr_whitelist
+  # config.tag_whitelist         = %w[code img h1 h2 h3 h4 h5 h6 a em u i b strong ol ul li table thead tbody tfoot tr th td blockquote hr br p]
+  # config.attr_whitelist        = %w[src alt title href target]
 
   # To restrict Dokno data modification and include indentifying information
   # in change log entries, provide the appropriate user values for your app below.
   #   (String) app_user_object
   #   (Symbol) app_user_auth_method
   #   (Symbol) app_user_name_method
+  # config.app_user_object       = 'current_user'
+  # config.app_user_auth_method  = :admin?
+  # config.app_user_name_method  = :name
 
-  # config.app_user_object      = 'current_user'
-  # config.app_user_auth_method = :admin?
-  # config.app_user_name_method = :name
+  # To control the amount of time before a created/updated article is flagged
+  # for accuracy/relevance review, uncomment and change the default.
+  #   (ActiveSupport::Duration) article_review_period
+  # config.article_review_period = 1.year
+
+  # To control the number of days prior to an article being up for review
+  # that users should be prompted to re-review, uncomment and change the default.
+  #   (Integer) article_review_prompt_days
+  # config.article_review_prompt_days = 30
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dokno
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Courtney Payne
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-12-03 00:00:00.000000000 Z
+date: 2020-12-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: diffy
@@ -38,6 +38,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.5'
+- !ruby/object:Gem::Dependency
+  name: bullet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.34'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.34'
 - !ruby/object:Gem::Dependency
   name: database_cleaner-active_record
   requirement: !ruby/object:Gem::Requirement
@@ -52,6 +80,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: faker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.15'
 - !ruby/object:Gem::Dependency
   name: pg
   requirement: !ruby/object:Gem::Requirement
@@ -86,6 +128,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.9'
+- !ruby/object:Gem::Dependency
+  name: puma
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.1'
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
@@ -127,50 +183,61 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 4.0.1
 - !ruby/object:Gem::Dependency
-  name: simplecov
+  name: selenium-webdriver
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: '3.142'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.142.7
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: '3.142'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.142.7
 - !ruby/object:Gem::Dependency
-  name: bullet
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.1'
+        version: 0.19.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.1'
+        version: 0.19.1
 - !ruby/object:Gem::Dependency
-  name: faker
+  name: webdrivers
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.15'
+        version: '4.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.4.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.15'
+        version: '4.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.4.1
 description: Dokno allows you to easily mount a self-contained knowledgebase / wiki
-  / help system to your Rails app where you and your users can author articles relevant
-  to your app.
+  / help system to your Rails app.
 email:
 - cpayne624@gmail.com
 executables: []
@@ -211,11 +278,14 @@ files:
 - app/views/dokno/categories/index.html.erb
 - app/views/dokno/categories/new.html.erb
 - app/views/layouts/dokno/application.html.erb
+- app/views/partials/_category_header.html.erb
 - app/views/partials/_form_errors.html.erb
 - app/views/partials/_logs.html.erb
 - app/views/partials/_pagination.html.erb
 - config/routes.rb
 - db/migrate/20201203190330_baseline.rb
+- db/migrate/20201211192306_add_review_due_at_to_articles.rb
+- db/migrate/20201213165700_add_starred_to_article.rb
 - lib/dokno.rb
 - lib/dokno/config/config.rb
 - lib/dokno/engine.rb
@@ -230,7 +300,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/cpayne624/dokno/issues
   changelog_uri: https://github.com/cpayne624/dokno/blob/master/CHANGELOG.md
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -245,8 +315,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
-signing_key: 
+rubygems_version: 3.2.0.rc.1
+signing_key:
 specification_version: 4
 summary: Dokno (dough-no) is a lightweight mountable Rails Engine for storing and
   managing your app's domain knowledge.