Articular

News engine for the Neoteric Design CMS.

Installation

Neoteric CMS gems are served from a private host. Replace SECURE_GEMHOST with the source address.

# Gemfile
source SECURE_GEMHOST do
  gem 'articular', '~> 2.4.1'
end

$ bundle install
$ rails g articular:install
$ rake db:migrate

The install generator:

• Sets up the articular_articlew table
• Bootstraps active_admin integration if ActiveAdmin is detected
• Sets up an initial NewsPost resource

You can also run the active_admin bootstrapper independently. This adds the appropriate JS/CSS needed for Articular's admin UI.

$ rails g articular:active_admin

You can generate additional post resources.

$ rails g articular:resource CoolBlogPost

This generates:

• Model
• Model spec
• Controller
• Views/RSS feed
• Routes
• ActiveAdmin resource (if activeadmin present)

Usage

Out of the box, you'll get a NewsPost model and a corresponding controller

Model

class NewsPost < Articular::Article
end

Instance methods

Class methods

Controller

class AnyNameController < ApplicationController
  include Articular::Controller
end

Articular will guess what class it's working with based on the controller's name, but this can be overridden. Most of the operations like generating the title and pagination have been broken down into small methods so they can be easily overriden. See lib/articular/controller.rb for what's under the hood.

In addition to these methods, feel free to replace the actions according to your own needs.

View Helpers

Because of the fancy date-based routes, Articular includes some url helpers for generating links to articles. It does the reflection on the article class and date for you and uses Rails' url_for under the hood that should work in most instances. You can override the optional options hash if it doesn't.

article_path(news_post)
#=> "/news/2016/04/cotton-eye-joe"

article_url(blog_post)
#=> "http://mydomain.com/blog/2016/10/31/legend-of-spooky-pete"

Tags

Ships with support for Neoteric Design Topical tagging engine.

class NewsPost < Articular::Article
  topical_on :news_topics
end

To use a different tagging method, remove that reference from the model, and override the tagged action in your controller.

Admin/editor support

Articular comes with (hopefully) everything you need to set up an admin interface. Articular can generate one for you when you're installing.

• Assets: Include articular.js and articular.scss
• Strong parameters: adding Articular.params to the whitelist

ActiveAdmin Example

# app/assets/javascripts/active_admin.js.coffeescript

# ...
#= require articular
# ...

// app/assets/stylesheets/active_admin.css.scss

// ...
@import 'articular';
// ...

# app/admin/news_posts.rb

ActiveAdmin.register NewsPost do
  menu :priority => 2
  actions :all, :except => :show
  config.sort_order = 'published_at DESC'

  permit_params Articular.params, news_topic_ids: []

  filter :title
  filter :body
  filter :published_at

  scope :all
  scope :published

  form :partial => 'form'

  index do
    column :title
    column :state do |post|
      span post.state, :class => "state-label #{post.state}"
    end
    column :published_at

    actions
  end

  controller do
    def find_resource
      scoped_collection.friendly.find(params[:id]) #FriendlyId Find
    end
  end
end

See also the default ActiveAdmin register template.

Testing

A RSpec linting module is available to double check functionality.

describe NewsPost do
  include Articular::SpecHelpers::Lint
end

TODO

• [] Rails generator for adding new article models
• [] Documentation for Archive and Navigator modules