express_admin 1.1.0

data/config/initializers/gravatar_image_tag.rb

@@ -0,0 +1,4 @@
+GravatarImageTag.configure do |config|
+  config.size                    = 40   # Set this to globally set the size of the gravatar image returned (1..512). Gravatar's default is 80
+  config.secure                  = true # Set this to true if you require secure images on your pages.
+end

data/lib/express_admin/engine.rb

@@ -0,0 +1,52 @@
+require "express_admin/menu"
+require "express_admin/version"
+require "express_templates"
+require "jquery-rails"
+require "foundation-rails"
+require "bourbon"
+require "gravatar_image_tag"
+require "kaminari"
+require "responders"
+require 'inherited_resources'
+
+# should be a way to add this folder to rails' autoload paths
+components = Dir.glob(File.join(File.dirname(__FILE__), '..', '..', 'app', 'components', '**', '*.rb'))
+components.each {|component| require component }
+
+module ExpressAdmin
+  class Engine < ::Rails::Engine
+
+   initializer :assets do |config|
+    engine_assets_path = File.join(File.dirname(__FILE__), '..', '..', 'app', 'assets')
+    all_assets = Dir.glob File.join(engine_assets_path, 'stylesheets', '**', '*.css*')
+    all_assets += Dir.glob File.join(engine_assets_path, 'javascripts', '**', '*.js*')
+    all_assets.each {|path| path.gsub!("#{engine_assets_path}/stylesheets/", '')}
+    all_assets.each {|path| path.gsub!("#{engine_assets_path}/javascripts/", '')}
+    all_assets.each {|path| path.gsub!("#{engine_assets_path}/fonts/", '')}
+    all_assets.each {|path| path.gsub!(/.(scss|coffee)$/, '')}
+    Rails.application.config.assets.paths << Rails.root.join('app', 'assets', 'fonts')
+    Rails.application.config.assets.precompile << /\.(?:svg|eot|woff|ttf)$/
+    Rails.application.config.assets.precompile << /\.(?:png)$/
+    Rails.application.config.assets.precompile += all_assets
+  end
+
+    def all_rails_engines
+      Rails.application.eager_load!
+      @all_engines ||= ::Rails::Engine.descendants
+    end
+
+    # Find all the rails engines that have
+    # :addon_name presumably from including
+    # ExpressAdmin::Menu::Loader
+    def all_addons
+      @all_addons ||= all_rails_engines.select do |engine|
+        engine.methods.include?(:addon_name)
+      end
+    end
+
+  end
+
+  class Railtie < ::Rails::Railtie
+    config.app_generators.template_engine :et
+  end
+end

data/lib/express_admin/menu.rb

@@ -0,0 +1,62 @@
+module ExpressAdmin
+  # Provide menus for Express Admin addon engines.
+  #
+  # To use:
+  #
+  # 1) include ExpressAdmin::Menu::Loader in your engine.rb
+  # 2) add a config/menu.yml defining the menu structure
+  #
+  # Example:
+  #
+  #     title: 'Blog'
+  #     path: 'express_blog.admin_blog_posts_path'
+  #     items:
+  #       -
+  #         title: 'Posts'
+  #         path: 'express_blog.admin_blog_posts_path'
+  #       -
+  #         title: 'Categories'
+  #         path: 'express_blog.admin_blog_categories_path'
+  module Menu
+
+    # Return the top level MenuItem for the addon or defined in the supplied path.
+    #
+    # Accepts an addon_name such as :express_admin or a path to a yaml file
+    # containing a menu definition.
+    def self.[](addon_name)
+      @menus ||= {}
+      @menus[addon_name.to_sym] ||= begin
+        addon_path = Gem.loaded_specs[addon_name].full_gem_path if addon_name.to_s.match(/^\w+$/)
+        menu_yml_path = File.join(addon_path, 'config', 'menu.yml')
+        from(menu_yml_path)
+      end
+    end
+
+    def self.from(yaml_path)
+      raise "unable to locate #{yaml_path}" unless File.exists?(yaml_path)
+      MenuItem.new YAML.load_file(yaml_path).with_indifferent_access
+    end
+
+
+    class MenuItem
+      attr :title, :path, :position, :items
+      def initialize(hash)
+        @title = hash[:title]
+        @path = hash[:path]
+        @position = hash[:position] || 99
+        @items = (hash[:items]||[]).map {|item| MenuItem.new(item)}
+      end
+    end
+
+    module Loader
+      def self.included(base)
+        class << base
+          def addon_name
+            self.to_s.split('::')[-2].underscore.to_sym
+          end
+        end
+      end
+    end
+
+  end
+end

data/lib/express_admin/version.rb

@@ -0,0 +1,3 @@
+module ExpressAdmin
+  VERSION = "1.1.0"
+end

data/lib/express_admin.rb

@@ -0,0 +1,4 @@
+require "express_admin/engine"
+
+module ExpressAdmin
+end

data/lib/generators/express_admin/install/USAGE

@@ -0,0 +1,23 @@
+Description:
+    Installs a new AppExpress module.
+
+Example:
+    `rails generate express_admin:install`
+
+    Creates a standard AppExpress module:
+      app/assets/javascripts/express_awesome/admin/ajax_forms.js
+      app/controllers/express_awesome/admin_controller.rb
+      app/views/layouts/express_awesome/admin.html.et
+      config/menu.yml
+      lib/generators/express_awesome/install/install_generator.rb
+      lib/generators/express_awesome/install/USAGE
+      test/lib/generators/express_awesome/install/install_generator_test.rb
+
+    Adds an entry to config/routes.rb:
+      `mount ExpressAwesome::Engine, at: ExpressAwesome::Engine.config.express_awesome_mount_point`
+
+    Adds a line to app/assets/javascripts/express_awesome/admin/application.js:
+      `//= require express_admin`
+
+    Adds a line to app/assets/stylesheets/express_awesome/admin/application.css:
+      `*= require express_admin`

data/lib/generators/express_admin/install/install_generator.rb

@@ -0,0 +1,97 @@
+module ExpressAdmin
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path('../templates', __FILE__)
+      attr_reader :project_name, :project_class
+
+      def create_common_files
+        @project_name = destination_root.split('/').last
+      end
+
+      def create_installer
+        @project_class = @project_name.camelize
+
+        template 'install/installer.rb.erb',
+          File.join('lib/generators', @project_name, 'install', 'install_generator.rb')
+        template 'install/USAGE', File.join('lib/generators', @project_name, 'install', 'USAGE')
+        empty_directory File.join('lib/generators', @project_name, 'install', 'templates')
+        template 'install/installer_test.rb.erb',
+          File.join('test/lib/generators', @project_name, 'install', 'install_generator_test.rb')
+      end
+
+      def create_admin_controller
+        template 'controllers/admin_controller.rb.erb',
+          File.join('app/controllers', @project_name, 'admin', 'admin_controller.rb')
+      end
+
+      def create_admin_layout
+        template 'views/layouts/admin.html.et',
+          File.join('app/views/layouts', @project_name, 'admin.html.et')
+      end
+
+      def create_application_js
+        empty_directory("app/assets/javascripts/#{@project_name}/admin")
+        template 'assets/javascripts/application.js',
+          File.join('app/assets/javascripts', @project_name, 'admin', 'application.js')
+      end
+
+      def create_application_css
+        empty_directory("app/assets/stylesheets/#{@project_name}/admin")
+        template 'assets/stylesheets/application.css',
+          File.join('app/assets/stylesheets', @project_name, 'admin', 'application.css')
+      end
+
+      def insert_mount_point
+        @project_class = @project_name.camelize
+
+        if open(engine_path).any?
+          inject_into_file engine_path,
+            "    #{@project_class}::Engine.config.#{@project_name}_mount_point = '/'\n",
+            after: "class Engine < ::Rails::Engine\n"
+        end
+      end
+
+      def require_express_admin
+        @project_class = @project_name.camelize
+
+        if open(engine_path).any?
+          inject_into_file engine_path, "require 'express_admin'\n",
+            before: "module #{@project_class}"
+        end
+      end
+
+      def create_menu
+        template 'config/menu.yml.erb', File.join('config/menu.yml')
+      end
+
+      def add_express_admin_menu
+        if open(engine_path).any?
+          inject_into_file engine_path, "    include ::ExpressAdmin::Menu::Loader\n",
+            after: "class Engine < ::Rails::Engine\n"
+        end
+      end
+
+      def precompile_assets
+        assets = <<-'EOD'
+    initializer :assets do |config|
+      engine_assets_path = File.join(File.dirname(__FILE__), '..', '..', 'app', 'assets')
+      all_assets = Dir.glob File.join(engine_assets_path, 'stylesheets', '**', '*.css*')
+      all_assets += Dir.glob File.join(engine_assets_path, 'javascripts', '**', '*.js*')
+      all_assets.each {|path| path.gsub!("#{engine_assets_path}/stylesheets/", '')}
+      all_assets.each {|path| path.gsub!("#{engine_assets_path}/javascripts/", '')}
+      Rails.application.config.assets.precompile += all_assets
+    end
+EOD
+        if open(engine_path).any?
+          inject_into_file engine_path, assets, after: "class Engine < ::Rails::Engine\n"
+        end
+      end
+
+      private
+
+        def engine_path
+          Rails.root ? "#{Rails.root}/lib/#{@project_name}/engine.rb" : "lib/#{@project_name}/engine.rb"
+        end
+    end
+  end
+end

data/lib/generators/express_admin/install/templates/assets/javascripts/application.js

@@ -0,0 +1 @@
+//= require_tree .

data/lib/generators/express_admin/install/templates/assets/stylesheets/application.css

@@ -0,0 +1,5 @@
+/*
+*= require express_admin
+*= require_tree .
+*= require_self
+*/

data/lib/generators/express_admin/install/templates/config/menu.yml.erb

@@ -0,0 +1,3 @@
+title: '<%= project_name.titleize %>'
+path: '#'
+items:

data/lib/generators/express_admin/install/templates/controllers/admin_controller.rb.erb

@@ -0,0 +1,34 @@
+require_dependency "<%= project_name %>/application_controller"
+
+module <%= project_class %>
+  module Admin
+    class AdminController < ApplicationController
+      inherit_resources  # Use inherited_resources
+
+      helper ::ExpressAdmin::AdminHelper
+      before_filter :authenticate_user! if defined?(Devise)
+      layout "<%= project_name %>/admin"
+
+      before_filter :load_collection, only: [:show]
+      before_filter :build_new_resource, only: [:index]
+
+      def show
+        show! do |format|
+          format.html { render :index }
+        end
+      end
+
+      private
+
+        def load_collection
+          collection # from InheritedResources
+        end
+
+        def build_new_resource
+          @resource_params = {}
+          build_resource
+        end
+
+    end
+  end
+end

data/lib/generators/express_admin/install/templates/install/USAGE

@@ -0,0 +1,8 @@
+Description:
+    Explain the generator
+
+Example:
+    rails generate install Thing
+
+    This will create:
+        what/will/it/create

data/lib/generators/express_admin/install/templates/install/installer.rb.erb

@@ -0,0 +1,10 @@
+class <%= project_class %>::InstallGenerator < Rails::Generators::Base
+  source_root File.expand_path('../templates', __FILE__)
+
+  desc "mount <%= project_name %> engine"
+  def install
+    route "mount <%= project_class %>::Engine, at: <%= project_class %>::Engine.config.<%= project_name %>_mount_point"
+    rake "<%= project_name %>:install:migrations"
+  end
+
+end

data/lib/generators/express_admin/install/templates/install/installer_test.rb.erb

@@ -0,0 +1,16 @@
+require 'test_helper'
+require 'generators/<%= project_name %>/install/install_generator'
+
+module <%= project_class %>
+  class <%= project_class %>::InstallGeneratorTest < Rails::Generators::TestCase
+    tests <%= project_class %>::InstallGenerator
+    destination Rails.root.join('tmp/generators')
+    setup :prepare_destination
+
+    # test "generator runs without errors" do
+    #   assert_nothing_raised do
+    #     run_generator ["arguments"]
+    #   end
+    # end
+  end
+end

data/lib/generators/express_admin/install/templates/views/layouts/admin.html.et

@@ -0,0 +1 @@
+render(template: 'layouts/express_admin/admin')

data/lib/generators/express_admin/scaffold/scaffold_generator.rb

@@ -0,0 +1,135 @@
+require 'rails/generators/rails/scaffold/scaffold_generator'
+
+module ExpressAdmin
+  module Generators
+    class ScaffoldGenerator < ::Rails::Generators::ScaffoldGenerator
+      source_root File.expand_path("../templates", __FILE__)
+      attr_reader :view_path, :resource_class
+
+      remove_hook_for :scaffold_controller
+
+      def create_root_folder
+        empty_directory admin_view_path
+      end
+
+      def copy_view_files
+        available_views.each do |view|
+          template "#{view}.html.et.erb", File.join(admin_view_path, "#{view}.html.et")
+        end
+      end
+
+      def generate_controller
+        controller_file_path = File.join(["app/controllers", project_name, admin_controller_path, "#{controller_file_name}_controller.rb"].compact)
+        template "controller/controller.rb", controller_file_path
+      end
+
+      def add_route
+        route_path = Rails.root ? "#{Rails.root}/config/routes.rb": "config/routes.rb"
+        if open(route_path).grep("scope '#{project_path}'").any?
+          inject_into_file 'config/routes.rb', "        resources :#{controller_file_name}\n",
+            after: "scope '#{project_path}' do\n"
+        else
+          if module_name
+            admin_route = <<-EOD
+  namespace :admin do
+    scope '#{module_name}' do
+      resources :#{controller_file_name}, except: [:edit]
+    end
+  end
+EOD
+          else
+            admin_route = <<-EOD
+  namespace :admin do
+    resources :#{controller_file_name}, except: [:edit]
+  end
+EOD
+          end
+          inject_into_file 'config/routes.rb', admin_route,
+            after: "#{namespaced?}::Engine.routes.draw do\n"
+        end
+      end
+
+      def add_menu_item
+menu_entry = %Q(
+  -
+    title: '#{controller_file_name.titleize}'
+    path: '#{namespaced?.to_s.underscore}.#{project_name}_admin_#{controller_file_name}_path'
+)
+        menu_path = Rails.root ? "#{Rails.root}/config/menu.yml": "config/menu.yml"
+        if File.exists?(menu_path)
+          inject_into_file menu_path, menu_entry, after: 'items:'
+        end
+      end
+
+
+      protected
+        def available_views
+          %w(index)
+        end
+
+        def available_actions
+          %w(index show update destroy)
+        end
+
+        def handler
+          :et
+        end
+
+        def project_path
+          project_name || Rails.application.class.parent_name
+        end
+
+        def project_name
+          namespaced_path rescue nil
+        end
+
+        def module_name
+          controller_class_path.last if controller_class_path.size.eql?(2)
+        end
+
+        def admin_controller_path
+          # place the generated controller into an Admin module
+          acp = controller_class_path.dup
+          if acp.empty?
+            acp.push 'admin'
+          else
+            acp.insert(1,'admin').compact.slice(1..-1)
+          end
+          File.join acp
+        end
+
+        def model_class_name
+          class_path_parts = class_name.split("::")
+          class_path_parts.unshift namespace.to_s if namespaced?
+          class_path_parts.join("::")
+        end
+
+        def admin_view_path
+          path_parts = ["app/views", project_name, admin_controller_path, controller_file_name]
+          File.join path_parts.compact
+        end
+
+        def model_path
+          if Rails.application
+            class_name.underscore
+          else
+            # drop the module name for the engine as the generators
+            # we invoke will automatically add it back again
+            class_name.split("::").slice(1..-1).join("::").underscore
+          end
+        end
+
+      private
+
+        def destroy(what, *args)
+          log :destroy, what
+          argument = args.flat_map(&:to_s).join(" ")
+          # in_root { run_ruby_script("bin/rails destroy #{what} #{argument}", verbose: true) }
+          system("bin/rails destroy #{what} #{argument}")
+        end
+
+
+
+    end
+  end
+end

data/lib/generators/express_admin/scaffold/templates/controller/controller.rb

@@ -0,0 +1,14 @@
+<% module_namespacing do -%>
+module Admin
+  class <%= controller_class_name %>Controller < AdminController
+
+    defaults resource_class: <%= model_class_name %>
+
+    private
+
+      def <%= singular_table_name %>_params
+        params.require(:<%= singular_table_name %>).permit!
+      end
+  end
+end
+<% end -%>

data/lib/generators/express_admin/scaffold/templates/index.html.et.erb

@@ -0,0 +1,10 @@
+row {
+  main_region {
+    smart_table(:<%= plural_table_name %>, show_on_click: true)
+  }
+  sidebar_region {
+    widget_box(:new_<%= singular_table_name %>) {
+      smart_form(:<%= singular_table_name %>)
+    }
+  }
+}

data/lib/generators/express_admin/scaffold/templates/model/model.rb

@@ -0,0 +1,4 @@
+module <%= project_name %>
+  class <%= singular_table_name.classify %> < ActiveRecord::Base
+  end
+end

data/lib/generators/express_admin/scaffold/templates/show.html.et.erb

@@ -0,0 +1,10 @@
+row {
+  main_region {
+    smart_table(:<%= plural_table_name %>)
+  }
+  sidebar_region {
+    widget_box(:edit_<%= singular_table_name %>) {
+      smart_form(:<%= singular_table_name %>)
+    }
+  }
+}

data/lib/tasks/express_admin_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :express_admin do
+#   # Task goes here
+# end

data/test/bin/run

@@ -0,0 +1 @@
+rake test

data/test/dummy/README.rdoc

@@ -0,0 +1,28 @@
+== README
+
+This README would normally document whatever steps are necessary to get the
+application up and running.
+
+Things you may want to cover:
+
+* Ruby version
+
+* System dependencies
+
+* Configuration
+
+* Database creation
+
+* Database initialization
+
+* How to run the test suite
+
+* Services (job queues, cache servers, search engines, etc.)
+
+* Deployment instructions
+
+* ...
+
+
+Please feel free to use a different markup language if you do not plan to run
+<tt>rake doc:app</tt>.

data/test/dummy/Rakefile

@@ -0,0 +1,6 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require File.expand_path('../config/application', __FILE__)
+
+Rails.application.load_tasks

data/test/dummy/app/assets/javascripts/application.js

@@ -0,0 +1,13 @@
+// This is a manifest file that'll be compiled into application.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or vendor/assets/javascripts of plugins, if any, can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// compiled file.
+//
+// Read Sprockets README (https://github.com/sstephenson/sprockets#sprockets-directives) for details
+// about supported directives.
+//
+//= require_tree .

data/test/dummy/app/assets/javascripts/demo.js

@@ -0,0 +1,2 @@
+// Place all the behaviors and hooks related to the matching controller here.
+// All this logic will automatically be available in application.js.

data/test/dummy/app/assets/stylesheets/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or vendor/assets/stylesheets of plugins, if any, can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any styles
+ * defined in the other CSS/SCSS files in this directory. It is generally better to create a new
+ * file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/test/dummy/app/assets/stylesheets/demo.css.scss

@@ -0,0 +1,3 @@
+// Place all the styles related to the demo controller here.
+// They will automatically be included in application.css.
+// You can use Sass (SCSS) here: http://sass-lang.com/

data/test/dummy/app/controllers/application_controller.rb

@@ -0,0 +1,5 @@
+class ApplicationController < ActionController::Base
+  # Prevent CSRF attacks by raising an exception.
+  # For APIs, you may want to use :null_session instead.
+  protect_from_forgery with: :exception
+end

data/test/dummy/app/controllers/demo_controller.rb

@@ -0,0 +1,8 @@
+class DemoController < ApplicationController
+  def show
+  end
+
+  def sign_in
+    render layout: 'express_admin/external'
+  end
+end

data/test/dummy/app/helpers/application_helper.rb

@@ -0,0 +1,2 @@
+module ApplicationHelper
+end

data/test/dummy/app/helpers/demo_helper.rb

@@ -0,0 +1,2 @@
+module DemoHelper
+end

data/test/dummy/app/views/demo/show.html.et

@@ -0,0 +1,2 @@
+h1 "Demo#show"
+p "Find me in app/views/demo/show.html.et"