express_admin 1.1.0

data/app/components/express_admin/addon_sidebar_component.rb

@@ -0,0 +1,47 @@
+module ExpressAdmin
+  class AddonSidebarComponent < ExpressTemplates::Components::Base
+  # Replaces:
+  #
+  # .sidebar-wrapper
+  #   %aside.sidebar
+  #     %h5.title= <addon>::Engine.express_admin_menu.name
+  #     %ul.side-nav
+  #       - <addon>::Engine.express_admin_menu.items.each do |item|
+  #         %li
+  #           = link_to item.name, eval(item.path)
+
+    helper :menu_name, &-> { current_menu_name }
+
+    emits menu_item:    -> {
+                             li {
+                               link_to "{{item.title}}", "{{eval(item.path)}}"
+                             }
+                           },
+
+          menu_wrapper: -> {
+                             div._sidebar_wrapper {
+                               aside.sidebar {
+                                 h1 {
+                                   menu_name
+                                 }
+                                 ul {
+                                   _yield
+                                 }
+                               }
+                             }
+                           }
+
+    for_each -> { current_menu.items || [] }, as: :item, emit: :menu_item
+
+    wrap_with :menu_wrapper
+
+    def compile
+      %Q(begin
+        render(partial: "shared/\#\{current_module_path_name\}/sidebar")
+      rescue => e
+        #{super}
+      end)
+    end
+
+  end
+end

data/app/components/express_admin/flash_message_component.rb

@@ -0,0 +1,19 @@
+module ExpressAdmin
+  class FlashMessageComponent < ExpressTemplates::Components::Base
+
+    helper(:safe_message) {|message| message[1] }
+    helper(:classes) {|message| "flash nav-alert alert-box #{flash_class(message[0])}" }
+
+    emits -> {
+      div {
+        div(class: ExpressAdmin::FlashMessageComponent.classes('{{flash_message}}'), data: {alert: ''}) {
+          safe_message('{{flash_message}}')
+          a.close(:href => "#") { "&times;" }
+        }
+      }
+    }
+
+    for_each -> { flash }, as: :flash_message
+
+  end
+end

data/app/components/express_admin/main_region.rb

@@ -0,0 +1,9 @@
+module ExpressAdmin
+  class MainRegion < ExpressTemplates::Components::Container
+    emits -> {
+      div(:main)._large_8.columns {
+        _yield
+      }
+    }
+  end
+end

data/app/components/express_admin/mega_menu_component.rb

@@ -0,0 +1,68 @@
+module ExpressAdmin
+  class MegaMenuComponent < ExpressTemplates::Components::Base
+    # %h1 "Modules"
+
+    # - if admin_menus.any?
+    #   %nav
+    #     %ul
+    #       - admin_menus.each do |menu|
+    #         %li
+    #           = link_to eval(menu.main.path) do
+    #             %i.icon{class: "icon-express_#{menu.main.title.downcase}"}
+    #             %span= menu.main.title
+    # - else
+    #   .empty-state-wrapper
+    #     %p.lead.text-muted No modules added yet.
+    #     %p
+    #       = link_to app_express.addons_path, class: 'button success radius' do
+    #         %span.icon.ion-plus
+    #           Add Module
+
+    helper(:extra_menu) {
+      render(partial: 'shared/express_admin/express_admin_extra_menu') rescue nil
+    }
+
+    fragments menu_item: -> {
+                        li {
+                          a(href: "{{eval(menu.path)}}") {
+                            i.icon(class: "icon-express_{{menu.title.downcase}}")
+                            span "{{menu.title}}"
+                          }
+                        }
+                      },
+
+              empty_state: -> {
+                div._empty_state_wrapper {
+                  p.lead._text_muted "No modules added yet."
+                }
+              },
+
+              menu_wrapper: -> {
+                li.megamenu._has_dropdown {
+                  a("Manage", href: '#', onClick: 'return false;')
+                  ul.dropdown._dropdown_wrapper {
+                    li._megamenu_overlay {
+                      div._megamenu_container {
+                        div.main {
+                          h1 "Modules"
+                          nav {
+                            ul {
+                              _yield
+                            }
+                          }
+                        }
+                        div.extra {
+                          extra_menu
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+
+    for_each -> {admin_menus}, as: 'menu', emit: :menu_item, empty: :empty_state
+
+    wrap_with :menu_wrapper, dont_wrap_if: -> { admin_menus.empty? }
+
+  end
+end

data/app/components/express_admin/page_header_component.rb

@@ -0,0 +1,39 @@
+module ExpressAdmin
+  class PageHeaderComponent < ExpressTemplates::Components::Base
+    ETC = ExpressTemplates::Components
+
+    class PageHeader < ExpressTemplates::Components::Base
+      include ETC::Capabilities::Conditionality
+
+      emits -> {
+              h1 {
+                content_for(:page_header)
+              }
+            }
+
+      only_if -> { content_for?(:page_header) }
+
+    end
+
+    class PageHeaderLead < ExpressTemplates::Components::Base
+      include ETC::Capabilities::Conditionality
+
+      emits -> {
+              p.lead {
+                content_for(:page_header_lead)
+              }
+            }
+
+      only_if -> { content_for?(:page_header_lead) }
+
+    end
+
+    emits -> {
+        page_header
+        page_header_lead
+    }
+
+  end
+
+
+end

data/app/components/express_admin/setting_form.rb

@@ -0,0 +1,45 @@
+module ExpressAdmin
+  class SettingForm < ExpressTemplates::Components::Container
+    include ExpressTemplates::Components::Capabilities::Configurable
+
+    # .widget-box
+    #   %h2.widget-header Blog
+    #   .widget-body
+    #     = form_tag admin_blog_settings_path, id: 'blog-setting-form', onSubmit: 'return false;', method: 'patch' do
+    #       = hidden_field_tag :form_id, 'blog-setting-form'
+    #       - ExpressBlog.settings.blog_setting.each do |setting|
+    #         = edit_setting setting
+    #       .form-group.widget-buttons
+    #         = submit_tag 'Save', class: 'button tiny right radius ajax-submit'
+
+
+    helper(:save_button) { submit_tag 'Save', class: 'button tiny right radius ajax-submit' }
+
+    helper(:settings_path) { self.send("admin_#{current_module_path_name.gsub(/express_/, '')}_settings_path") }
+
+    helper(:settings) { |setting_type|
+      current_module.settings.send("#{setting_type}_setting").map do |setting|
+        edit_setting(setting)
+      end.join()
+    }
+
+    emits -> {
+        widget_box(my[:id]) {
+          setting_selector = my[:id].to_s.gsub('_', '-')
+          form(href: ExpressAdmin::SettingForm.settings_path, id: "#{setting_selector}-setting-form", onSubmit: 'return false;', method: 'POST') {
+            form_rails_support(:patch)
+            hidden_field_tag :form_id, "#{setting_selector}-setting-form"
+            div._form_group {
+              _yield
+            }
+            settings(my[:id])
+            div._form_group._widget_buttons {
+              save_button
+            }
+          }
+        }
+      }
+
+
+  end
+end

data/app/components/express_admin/sidebar_region.rb

@@ -0,0 +1,11 @@
+module ExpressAdmin
+  class SidebarRegion < ExpressTemplates::Components::Container
+    emits -> {
+      div(:sidebar)._large_4.columns {
+        div._container {
+          _yield
+        }
+      }
+    }
+  end
+end

data/app/components/express_admin/smart_form.rb

@@ -0,0 +1,70 @@
+require 'rails/generators/generated_attribute'
+module ExpressAdmin
+  class SmartForm < ExpressTemplates::Components::Base
+    include ExpressTemplates::Components::Capabilities::Configurable
+
+    emits -> {
+      express_form(form_args) {
+        attributes.each do |attrib|
+          form_field_for(attrib)
+        end
+        submit(class: "button right tight tiny")
+      }
+    }
+
+    TIMESTAMPS = ['updated_at', 'created_at']
+
+    def form_field_for(attrib)
+      field_type_substitutions = {'text_area'       => 'textarea',
+                                  'datetime_select' => 'datetime',
+                                  'check_box'       => 'checkbox'}
+      field_type = attrib.field_type.to_s.sub(/_field$/,'')
+      case
+      when attrib.name.eql?('id')
+        hidden(:id)
+      when TIMESTAMPS.include?(attrib.name)
+        div {
+          label {
+            "#{attrib.name.titleize}: {{@#{resource_name}.try(:#{attrib.name})}}"
+          }
+        }
+      else
+        self.send((field_type_substitutions[field_type] || field_type), attrib.name.to_sym)
+      end
+    end
+
+
+    protected
+
+      def form_args
+        {           id: resource_name,
+                action: action_path,
+         resource_name: resource_name }
+      end
+
+      def action_path
+        "{{resource.persisted? ? resource_path(resource.id) : collection_path}}"
+      end
+
+      def resource_name
+        @config[:id].to_s.singularize
+      end
+
+      def columns
+        resource_class.constantize.columns
+      end
+
+      def attributes
+        columns.map do |attrib|
+          field_definition = [attrib.name, attrib.type] # index not important here for now
+          Rails::Generators::GeneratedAttribute.parse(field_definition.join(":"))
+        end
+      end
+
+      def resource_class
+        # TODO: Module namespace needs to be guessed somehow
+        @config[:class_name] || "ExpressCms::#{resource_name.classify}"
+      end
+
+  end
+end

data/app/components/express_admin/smart_table.rb

@@ -0,0 +1,97 @@
+module ExpressAdmin
+  class SmartTable < ExpressTemplates::Components::Base
+    include ExpressTemplates::Components::Capabilities::Configurable
+
+    MAX_COLS_TO_SHOW_IDX = 5
+
+    emits -> {
+      table(my[:id], 'data-turbolinks-permanent': nil)._table_hover {
+        thead {
+          tr {
+            display_columns.each do |column|
+              th.send(column.name) {
+                div { # wrap in div so we can use overflow
+                  column.name.titleize
+                }
+              }
+            end
+            th.actions { 'Actions' }
+            show_hidden_columns_header_indicator if columns_hidden?
+          }
+        }
+        tbody {
+          for_each(collection_var) {
+            tr(id: row_id, 'data-resource-url': resource_link) {
+              display_columns.each do |column|
+                td.send(column.name) {
+                  cell_value(column.name)
+                }
+              end
+              td {
+                link_to 'Delete', resource_link, method: :delete, data: {confirm: 'Are you sure?'}, class: 'button tiny secondary'
+              }
+              show_hidden_column_cell if columns_hidden?
+            }
+          }
+        }
+      }
+      if @config[:show_on_click]
+        script {
+          %Q(
+            $(document).on('click', 'tr', function(e){
+              e.preventDefault();
+              Turbolinks.visit($(this).attr('data-resource-url'), { cacheRequest: false, change: ['#{collection_member_name}', e.currentTarget.id] });
+            })
+          )
+        }
+      end
+    }
+
+    def resource_link
+      "{{resource_path(#{collection_member_name}.id)}}"
+    end
+
+    def row_id
+      "#{collection_member_name}:{{#{collection_member_name}.id}}"
+    end
+
+    def collection_member_name
+      @config[:id].to_s.singularize
+    end
+
+    def collection_var
+      "@#{collection_member_name.pluralize}".to_sym
+    end
+
+    def cell_value(column_name)
+      "{{#{collection_member_name}.#{column_name}}}"
+    end
+
+    def display_columns
+      columns.slice(0..MAX_COLS_TO_SHOW_IDX)
+    end
+
+    def columns_hidden?
+      columns.size > MAX_COLS_TO_SHOW_IDX+1
+    end
+
+    def show_hidden_columns_header_indicator
+      th._more_columns_indicator {
+        "..."
+      }
+    end
+
+    def show_hidden_column_cell
+      td._more_columns_indicator
+    end
+
+    def columns
+      resource_class.constantize.content_columns
+    end
+
+    def resource_class
+      # TODO: Module namespace needs to be guessed somehow
+      @config[:class_name] || "ExpressCms::#{collection_member_name.classify}"
+    end
+  end
+end

data/app/components/express_admin/widget_box.rb

@@ -0,0 +1,22 @@
+module ExpressAdmin
+  class WidgetBox < ExpressTemplates::Components::Column
+    emits -> {
+      div._widget_box._form_container {
+        h2._widget_header(box_title)
+        div._widget_body {
+          _yield
+        }
+      }
+    }
+
+    protected
+
+      def resource_name
+        my[:id].to_s.titleize
+      end
+
+      def box_title
+        "{{resource.persisted? ? 'Edit #{resource_name}' : 'New #{resource_name}'}}"
+      end
+  end
+end

data/app/helpers/express_admin/admin_helper.rb

@@ -0,0 +1,104 @@
+module ExpressAdmin
+  module AdminHelper
+
+    # TODO move this out
+    #include ExpressMedia::Admin::MediaHelper if Kernel.const_defined?("ExpressMedia::Engine")
+
+    def title_partial
+      (ExpressAdmin::Engine.config.title_partial rescue nil) || 'shared/express_admin/title'
+    end
+
+    def title_partial_or_express_admin
+      render(title_partial) rescue 'ExpressAdmin'
+    end
+
+    def sign_in_or_sign_out
+      if self.respond_to?(:user_signed_in?)
+        if user_signed_in?
+          link_to 'Sign out', main_app.destroy_user_session_path, method: :delete
+        else
+          link_to 'Sign in', main_app.user_session_path
+        end
+      end
+    end
+
+    def current_module
+      controller.class.to_s.split('::').first.constantize
+    end
+
+    def current_module_path_name
+      current_module.to_s.underscore
+    end
+
+    def current_engine
+      "#{current_module}::Engine".constantize
+    end
+
+    def current_menu
+      ExpressAdmin::Menu[current_module_path_name]
+    end
+
+    def current_menu_name
+      current_menu.title
+    end
+
+    def current_user_gravatar
+      if defined?(current_user) && !current_user.nil?
+        gravatar_image_tag current_user.email
+      end
+    end
+
+    def title_content
+      content_for?(:title) ? yield(:title) : Rails.application.class.parent_name.underscore.titleize
+    end
+
+    def description_meta_content
+      content_for?(:description) ? yield(:description) : 'Testapp'
+    end
+
+    def admin_javascript_and_css_includes
+      current_module_path = current_module.to_s.underscore
+      a = []
+      a << stylesheet_link_tag("#{current_module_path}/admin/application")
+      a << stylesheet_link_tag("app_express/admin/application") if defined?(AppExpress)
+      a << javascript_include_tag("express_admin", 'data-turbolinks-track' => true)
+      a << javascript_include_tag("#{current_module_path}/admin/application", 'data-turbolinks-track' => true)
+      a.join()
+    end
+
+    def admin_menus
+      addons = ExpressAdmin::Engine.all_addons.map do |engine|
+        ExpressAdmin::Menu[engine.addon_name.to_s] rescue nil
+      end.compact
+
+      addons.sort do |addonA, addonB|
+        if addonA.position == addonB.position
+          addonA.title <=> addonB.title
+        else
+          addonA.position <=> addonB.position
+        end
+      end
+    end
+
+    def menu_item(name, path)
+      content_tag(:li, link_to(name, path), class: is_active?(path))
+    end
+
+    def is_active?(path)
+      if request.path.eql?(path)
+        "active"
+      else
+        nil
+      end
+    end
+
+    def flash_class(key)
+      case key
+      when 'notice' then 'info'
+      when 'success' then 'success'
+      when 'alert' then 'warning'
+      when 'error' then 'alert'
+      end
+    end
+  end
+end

data/app/helpers/express_admin/module_settings_helper.rb

@@ -0,0 +1,53 @@
+module ExpressAdmin
+  module ModuleSettingsHelper
+    def edit_setting(param)
+      setting = setting_for(param)
+      domkey = param.gsub(/\W/, '_')
+
+      name = "settings[#{param}]"
+      title = param.titlecase
+      value = params[param.to_sym].nil? ? setting.value : params[param.to_sym]
+      html = ""
+
+      if setting.boolean?
+        html << content_tag(:div, class: 'form-group') do
+          hidden_field_tag(name, '0') +
+          check_box_tag(name, true, value, class: 'setting', id: domkey) +
+          content_tag(:label, title, class: 'checkbox', for: domkey)
+        end
+
+      elsif setting.selector?
+        html << content_tag(:div, class: 'form-group') do
+          content_tag(:label, title, for: domkey) +
+          select_tag(name, options_for_select(setting.definition.selection, value), class: 'setting', id: domkey)
+        end
+
+      else
+        html << content_tag(:div, class: 'form-group') do
+          content_tag(:label, title, for: domkey) +
+          text_field_tag(name, value, class: 'textbox', id: domkey)
+        end
+
+      end
+
+      if setting.errors.messages[:value]
+        html << content_tag(:span, [setting.errors.messages[:value]].flatten.first, class: 'error')
+        html = content_tag(:span, html, class: "error-with-field")
+      end
+
+      html.html_safe
+
+    end
+
+    def setting_for(setting)
+      @editable_setting ||= {}
+      @editable_setting[setting] ||= ExpressAdmin.module_name.constantize.settings.find_or_create_by(setting: setting)
+    end
+
+    def definition_for(setting)
+      if setting = setting_for(setting)
+        setting.definition
+      end
+    end
+  end
+end

data/app/views/express_admin/dashboard/show.html.et

@@ -0,0 +1,6 @@
+div.send("small-12").columns
+
+content_for(:page_header) {
+  h1 "Welcome to ExpressAdmin"
+  p.lead "If you see this page it is because your app has not provided a dashboard."
+}

data/app/views/layouts/express_admin/admin.html.et

@@ -0,0 +1,31 @@
+doctype
+html {
+  head {
+    title { title_content }
+    meta(name: "description", content: "{{description_meta_content}}")
+    meta(name: "viewport", content: "width=device-width, initial-scale=1.0")
+    # Modernizr is required for Zurb Foundation
+    javascript_include_tag 'vendor/modernizr'
+    admin_javascript_and_css_includes
+    yield(:page_css)
+    csrf_meta_tags
+  }
+  body {
+    header {
+      render('shared/express_admin/navigation_bar')
+    }
+    main(role: "main")._main_container {
+      addon_sidebar_component
+      div._content_body {
+        flash_message_component
+        div.row._page_header {
+          page_header_component
+        }
+        div.row._page_body {
+          yield
+        }
+      }
+    }
+    yield(:page_javascript)
+  }
+}

data/app/views/layouts/express_admin/external.html.et

@@ -0,0 +1,15 @@
+html(lang: 'en') {
+  head {
+    meta charset: 'utf-8'
+    meta content: 'width=device-width, initial-scale=1.0', name: 'viewport'
+    title { yield(:title) }
+    stylesheet_link_tag 'express_admin/application'
+    javascript_include_tag :modernizr
+    javascript_include_tag 'express_admin/application'
+    csrf_meta_tags
+  }
+  body {
+    flash_message_component
+    yield
+  }
+}

data/app/views/shared/express_admin/_messages.html.et

@@ -0,0 +1 @@
+flash_message_component

data/app/views/shared/express_admin/_navigation_bar.html.et

@@ -0,0 +1,20 @@
+# navigation styled for Zurb Foundation 5
+# the syntax for data-topbar may need to change for Zurb Foundation 5
+nav._top_bar(data: {topbar: true, options: "is_hover:false"}) {
+  title_partial_or_express_admin
+  div._top_bar_section {
+    ul {
+      li.divider
+      mega_menu_component
+    }
+  }
+  section._top_bar_section {
+    ul.left {
+      li.divider
+      li {
+        a(href: '/') { "View Site" }
+      }
+    }
+    render partial: 'shared/express_admin/navigation_bar_profile'
+  }
+}

data/app/views/shared/express_admin/_navigation_bar_profile.html.et

@@ -0,0 +1,8 @@
+ul.right {
+  li.gravatar {
+    current_user_gravatar
+  } 
+  li {
+    sign_in_or_sign_out
+  }
+}

data/app/views/shared/express_admin/_title.html.et

@@ -0,0 +1,8 @@
+ul(class: 'title-area') {
+  li.name {
+    a("ExpressAdmin", href: '#', disabled: true)
+  }
+  li(class:"toggle-topbar menu-icon") {
+    a(href: "#") { span { menu } }
+  }
+}