kadmin 0.1.4

data/app/controllers/kadmin/dash_controller.rb

@@ -0,0 +1,19 @@
+module Kadmin
+  class DashController < Kadmin::ApplicationController
+    # @!group Endpoints
+
+    # GET /
+    def index
+    end
+
+    # @!endgroup
+
+    # @!group Helpers
+
+    def set_navbar_links
+      @layout_navbar_links = Kadmin.config.navbar_links
+    end
+
+    # @!endgroup
+  end
+end

data/app/controllers/rails_admin/application_controller.rb

@@ -0,0 +1,58 @@
+module Kadmin
+  class ApplicationController < ActionController::Base
+    layout 'kadmin/application'
+
+    helper Kadmin::ApplicationHelper
+    helper Kadmin::BootstrapHelper
+    helper Kadmin::NavigationHelper
+    helper Kadmin::PaginationHelper
+
+    include Kadmin::Concerns::AuthorizedUser
+
+    before_action :authorize
+    before_action :set_navbar_links
+    before_action :set_default_format
+
+    # @!group Error Handling
+
+    unless defined?(BetterErrors)
+      rescue_from StandardError, with: :handle_error
+      rescue_from ActiveRecord::RecordNotFound, with: :not_found
+      rescue_from ActionController::ParameterMissing, with: :params_missing
+    end
+
+    def params_missing(error)
+      handle_error(error, title: I18n.t('kadmin.errors.params_missing'), status: :bad_request)
+    end
+
+    def not_found(error)
+      handle_error(error, title: I18n.t('kadmin.errors.not_found'), status: :not_found)
+    end
+
+    def handle_error(error, options = {})
+      options = {
+        title: error.try(:title) || error.class.name,
+        message: error.message,
+        status: :internal_server_error
+      }.merge(options)
+      render 'kadmin/error', status: options[:status], locals: options
+    end
+
+    # @!endgroup
+
+    # @!group Helpers
+
+    # Overload in the sub-controllers to set up the links in the layout
+    def set_navbar_links
+      @layout_navbar_links = []
+    end
+    protected :set_navbar_links
+
+    def set_default_format
+      params[:format] = 'html' if params[:format].blank?
+    end
+    protected :set_default_format
+
+    # @!endgroup
+  end
+end

data/app/helpers/kadmin/application_helper.rb

@@ -0,0 +1,4 @@
+module Kadmin
+  module ApplicationHelper
+  end
+end

data/app/helpers/kadmin/bootstrap_helper.rb

@@ -0,0 +1,53 @@
+module Kadmin
+  # Collection of Bootstrap helpers
+  module BootstrapHelper
+    # @see http://getbootstrap.com/components/#glyphicons-glyphs
+    # @param [String] icon the part after glyphicon-
+    def glyphicon(icon)
+      return content_tag(:span, ' ', class: "glyphicon glyphicon-#{icon}", 'aria-hidden': 'true')
+    end
+
+    # @param [Boolean] condition condition of evaluate
+    # @param [String] icon_true the glyphicon to use if true
+    # @param [String] icon_false the glyphicon to use if false
+    def glyphicon_if_else(condition, icon_true, icon_false)
+      return condition ? glyphicon(icon_true) : glyphicon(icon_false)
+    end
+
+    # Generates HTML for a bootstrap alert message, optionally closable.
+    # @param [String] type the type of the alert: danger, success, info, warning, or any alert-<TYPE> defined in your CSS
+    # @param [String] text optionally some text if you're not going to pass a block
+    # @param [Boolean] dismissible if true, adds a close button to the alert. Requires JS enabled
+    # @param [Proc] block optional block to pass if you want add more complex HTML inside
+    def alert(type, text: '', dismissible: true, &block)
+      css_classes = %W(alert alert-#{type})
+      css_classes << 'alert-dismissible' if dismissible
+
+      block_content = capture(&block)
+
+      html = nil
+      unless block_content.blank? && text.blank?
+        html = content_tag(:div, '', class: css_classes.join(' '), role: 'alert') do
+          content = text.html_safe
+
+          if dismissible
+            button = button_tag(type: 'button', class: 'close', 'data-dismiss': 'alert') do
+              content_tag(:span, '&times', {}, false)
+            end
+            content.concat(button)
+          end
+
+          content.concat(capture(&block)) if block_given?
+        end
+      end
+
+      return html
+    end
+
+    # @param [Hash, String] url_options anything accepted by link_to and image_tag
+    # @param [Integer] max_height maximum height of the thumbnail
+    def thumbnail_link(url_options, max_height)
+      return link_to(image_tag(url_options), url_options, class: 'thumbnail', style: "max-height: #{max_height}px", target: 'new')
+    end
+  end
+end

data/app/helpers/kadmin/form_builder.rb

@@ -0,0 +1,9 @@
+module Kadmin
+  class FormBuilder < ActionView::Helpers::FormBuilder
+    # Creates a checkbox where the value is 0 when checked, 1 when unchecked.
+    # @see Kadmin::Forms::InvertedCheckBox
+    def inverted_check_box(method, options = {})
+      Kadmin::Forms::InvertedCheckBox.new(@object_name, method, @template, '0', '1', objectify_options(options)).render
+    end
+  end
+end

data/app/helpers/kadmin/forms/inverted_check_box.rb

@@ -0,0 +1,10 @@
+module Kadmin
+  module Forms
+    class InvertedCheckBox < ActionView::Helpers::Tags::CheckBox
+      # Overload how it gets the value and return the invert
+      def value(*args)
+        return !super
+      end
+    end
+  end
+end

data/app/helpers/kadmin/navigation_helper.rb

@@ -0,0 +1,28 @@
+module Kadmin
+  module NavigationHelper
+    # Generates HTML for a bootstrap navigation link
+    # @param [String] title the navigation text
+    # @param [Hash, String] path the path for the link
+    # @param [Proc] block optional block to include content within the link
+    def nav_link_to(title, path, &block)
+      css_classes = []
+      css_classes << 'active' if request.path.starts_with?(path)
+      return content_tag(:li, link_to(title, path, &block), class: css_classes.join(' '))
+    end
+
+    # Generates a navigation drop down for bootstrap
+    # @param [String] prompt dropdown prompt
+    # @param [Array<Hash,String>] links list of links to add within the dropdown
+    def dropdown(prompt, links = [])
+      button_content = content_tag(:span, '', class: 'caret').prepend(prompt)
+      button = button_tag(button_content, type: 'button', data: { toggle: 'dropdown' }, class: 'btn btn-default')
+      list = content_tag(:ul, '', class: 'dropdown-menu') do
+        links.reduce(ActiveSupport::SafeBuffer.new) do |buffer, link|
+          buffer + content_tag(:li, link)
+        end
+      end
+
+      return content_tag(:div, button + list, class: 'dropdown', style: 'display: inline-block;')
+    end
+  end
+end

data/app/helpers/kadmin/pagination_helper.rb

@@ -0,0 +1,95 @@
+module Kadmin
+  module PaginationHelper
+    # @param [Kadmin::Finder::Pager] pager context to paginate
+    # @param [Array<Integer>] sizes array of page sizes
+    def paginate(pager, sizes)
+      return content_tag(:div, pagination_page_list(pager) + pagination_size_list(pager, sizes), class: 'btn-toolbar')
+    end
+
+    # Page Links
+    # Always include:
+    # => Previous page, first, last, next
+    # If we're over page 10, at ... after previous link
+    # If there aren't showing the last page yet, add ... before next link
+    def pagination_page_list(pager)
+      links = []
+      window = (pager.current_page - 2)..(pager.current_page + 2)
+
+      window = Range.new(0, window.end - window.begin) if window.begin.negative?
+      window = Range.new(window.begin, pager.pages - 1) if window.end >= pager.pages
+
+      first_link = pagination_navigate_link(pager, 0, '&laquo;')
+      previous_link = pagination_navigate_link(pager, pager.current_page - 1, '&lsaquo;')
+      last_link = pagination_navigate_link(pager, pager.pages - 1, '&raquo;')
+      next_link = pagination_navigate_link(pager, pager.current_page + 1, '&rsaquo;')
+
+      if pager.previous_page?(window.begin)
+        links << pagination_non_link('&hellip;', 'disabled')
+      end
+
+      window.each do |number|
+        links << pagination_page_link(number, pager)
+      end
+
+      if pager.next_page?(window.end)
+        links << pagination_non_link('&hellip;', 'disabled')
+      end
+
+      links.unshift(first_link, previous_link)
+      links << next_link
+      links << last_link
+
+      return content_tag(:div, links.reduce(&:+), class: 'btn-group')
+    end
+    private :pagination_page_list
+
+    def pagination_non_link(text, css_classes = nil)
+      classes = %w(btn btn-default) + Array.wrap(css_classes)
+      return content_tag(:div, text.to_s.html_safe, class: classes.join(' '))
+    end
+    private :pagination_non_link
+
+    def pagination_link(text, options = {}, css_classes = nil)
+      classes = %w(btn btn-default) + Array.wrap(css_classes)
+      return link_to(text.to_s.html_safe, params.merge(options), class: classes.join(' '))
+    end
+    private :pagination_link
+
+    def pagination_page_link(page, pager)
+      link = if pager.current_page?(page)
+        pagination_non_link(page + 1, 'active')
+      else
+        pagination_link(page + 1, page_offset: pager.offset_at(page))
+      end
+
+      return link
+    end
+    private :pagination_page_link
+
+    def pagination_navigate_link(pager, page, text)
+      link = if pager.contains?(page)
+        pagination_link(text, page_offset: pager.offset_at(page))
+      else
+        pagination_non_link(text, 'disabled')
+      end
+
+      return link
+    end
+    private :pagination_navigate_link
+
+    # Page Sizes
+    def pagination_size_list(pager, sizes)
+      label = content_tag(:div, 'Per page: ', class: 'btn')
+      links = sizes.map do |size|
+        if pager.size == size
+          pagination_non_link(size, 'active')
+        else
+          pagination_link(size, page_size: size)
+        end
+      end.reduce(&:+)
+
+      return content_tag(:div, label + links, class: 'btn-group')
+    end
+    private :pagination_size_list
+  end
+end

data/app/views/kadmin/_alerts.html.erb

@@ -0,0 +1,14 @@
+<% if flash.notice.present? || flash.alert.present? %>
+  <div class='alerts'>
+    <%= alert('danger') do %>
+      <% Array.wrap(flash.alert).each do |danger| %>
+        <p><%= glyphicon('exclamation-sign') %> <%= danger&.html_safe %></p>
+      <% end %>
+    <% end %>
+    <%= alert('success') do %>
+      <% Array.wrap(flash.notice).each do |success| %>
+        <p><%= glyphicon('ok-sign') %> <%= success&.html_safe %></p>
+      <% end %>
+    <% end %>
+  </div>
+<% end %>

data/app/views/kadmin/auth/login.html.erb

@@ -0,0 +1,4 @@
+<div style='text-align: center; margin-top: 1em'>
+  <p><%= link_to(t('kadmin.auth.please_login'), omniauth_provider_link) %></p>
+  <p><%= t('kadmin.auth.login_required') %></p>
+</div>

data/app/views/kadmin/dash/index.html.erb

@@ -0,0 +1,5 @@
+<div class='jumbotron' style='margin-top: 1em;'>
+  <h1 class='display-3'><%= t('kadmin.welcome', user: current_user) %></h1>
+  <hr class='m-y-2'>
+  <p><%= t('kadmin.dash_message') %></p>
+</div>

data/app/views/kadmin/error.html.erb

@@ -0,0 +1,5 @@
+<div class='jumbotron' style='margin-top: 1em'>
+  <h1 class='display-3'><%= title %></h1>
+  <hr class='m-y-2'>
+  <p><%= message %></p>
+</div>

data/app/views/layouts/kadmin/application.html.erb

@@ -0,0 +1,68 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <meta http-equiv="X-UA-Compatible" content="IE=edge">
+    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+    <!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags -->
+
+    <title>Admin</title>
+
+    <%= stylesheet_link_tag "kadmin/application", media: "all" %>
+    <%= javascript_include_tag "kadmin/application" %>
+    <%= csrf_meta_tags %>
+
+    <!-- Additional CSS -->
+    <%= yield :stylesheets %>
+  </head>
+  <body>
+    <nav class="navbar navbar-default navbar-static-top" style="margin-bottom: 0;">
+      <div class="container-fluid">
+        <div class="navbar-header">
+          <%= link_to('Admin Dashboard', Kadmin.config.mount_path, { class: 'navbar-brand' }) %>
+          <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
+            <span class="icon-bar"></span>
+            <span class="icon-bar"></span>
+            <span class="icon-bar"></span>
+          </button>
+        </div>
+        <div class="collapse navbar-collapse">
+          <% unless @layout_navbar_links.blank? %>
+            <ul class="nav navbar-nav navbar-left">
+              <% @layout_navbar_links.each do |link| %>
+                <%= nav_link_to(link[:title], link[:path]) %>
+              <% end %>
+            </ul>
+          <% end %>
+          <% if logged_in? %>
+            <ul class="nav navbar-nav navbar-right">
+              <li><%= link_to(t('kadmin.authorization.logout'), Kadmin::Engine.routes.url_helpers.auth_logout_path) %></li>
+            </ul>
+          <% end %>
+        </div>
+    </nav>
+    <div class="container-fluid content">
+      <div class="row">
+        <% if content_for?(:sidebar) %>
+          <!-- main -->
+          <div class="col-sm-8 col-md-8 col-lg-9 main">
+            <%= render partial: 'kadmin/alerts' %>
+            <%= yield %>
+          </div>
+          <!-- sidebar -->
+          <div class="col-sm-4 col-md-4 col-lg-3 sidebar hidden-xs">
+            <%= yield(:sidebar) %>
+          </div>
+        <% else %>
+          <div class="col-sm-12 col-md-12 main">
+            <%= render partial: 'kadmin/alerts' %>
+            <%= yield %>
+          </div>
+        <% end %>
+      </div>
+    </div>
+
+    <!-- Additional scripts -->
+    <%= yield :javascripts %>
+  </body>
+</html>

data/config/initializers/action_view.rb

@@ -0,0 +1,2 @@
+# Allow use of custom field tags for form builder
+ActionView::Base.default_form_builder = Kadmin::FormBuilder

data/config/initializers/assets.rb

@@ -0,0 +1,5 @@
+# Load engine assets
+# While loading images by extensions seem to work, loading JS and (S)CSS by extension seems
+# to cause issues, although loading them by filename is fine. Go figure.
+Rails.application.config.assets.precompile += %w(select2.css select2-bootstrap.css select2.js)
+Rails.application.config.assets.precompile += Dir.glob("#{Kadmin::Engine.root}/app/assets/**/*").reject { |fn| File.directory?(fn) }

data/config/locales/de.yml

@@ -0,0 +1,14 @@
+de:
+  kadmin:
+    auth:
+      error: Ein Fehler ist aufgetreten; bitte nochmal versuchen
+      login_required: Ein gültiges E-Mail von Google ist erforderlich
+      please_login: Bitte melden Sie sich an
+      unauthorized: Unberechtigte Zugriff
+      unauthorized_message: Sie haben für die gewünschte Seite leider keine Zugriffsrechte; falls Sie haben sollten, bitte das Apps & Services Team kontaktieren
+    dash_message: Schaue Dir mal die Bereiche in der Navigationsleiste oben. Wenn es irgenwelche Probleme gibt, oder es fehlt Dir Zugriffsrechte, bitte das Apps & Services Team kontaktieren.
+    error: Fehler
+    errors:
+      not_found: Objekt nicht gefunden
+      params_missing: Fehlenden erforderlichen Parameter
+    welcome: Willkommen zurück, %{user}!

data/config/locales/en.yml

@@ -0,0 +1,14 @@
+en:
+  kadmin:
+    auth:
+      error: An error occurred; please try again
+      login_required: A valid Google enabled email is necessary to login
+      please_login: Please authenticate yourself
+      unauthorized: Unauthorized access
+      unauthorized_message: You are not authorized to access this resource; if you think you should be, contact the Apps & Services team
+    dash_message: See the top navigation bar for the different admin sections. If you are missing authorizations, or if there is any issue at all, contact the Apps & Services team!
+    error: Error
+    errors:
+      not_found: Requested object not found
+      params_missing: Missing required parameters
+    welcome: Welcome %{user}!

data/config/routes.rb

@@ -0,0 +1,12 @@
+Kadmin::Engine.routes.draw do
+  get '/', controller: :dash, action: :index
+
+  scope '/auth', controller: :auth, as: 'auth', defaults: { format: 'html' } do
+    get '/login', action: :login, as: :login
+    get '/logout', action: :logout, as: :logout
+    get '/:provider/callback', action: :save
+    post '/:provider/callback', action: :save
+    get '/failure', action: :failure, as: :failure
+    get '/unauthorized', action: :unauthorized, as: :unauthorized
+  end
+end