aerogel-admin 1.4.4

data/config/README.md

@@ -0,0 +1,3 @@
+A place for your ```*.conf``` files.
+
+Environment specific configs go into folders 'production' or 'development'.

data/db/model/README.md

@@ -0,0 +1 @@
+A place for your models.

data/db/model/admin/user_new_form.rb

@@ -0,0 +1,40 @@
+module Admin
+  class UserNewForm
+    include Model::NonPersistent
+
+    field :full_name, type: String
+    field :email, type: String
+    field :roles, type: Array, default: [:user]
+
+    validates_presence_of :full_name, :email, :roles
+    validates_format_of :email, with: /@/, message: :invalid_format
+
+    validate do |record|
+      # validate email
+      if User.elem_match( :authentications => { :provider => :password, :uid => record.email } ).count > 0
+        record.errors.add :email, :taken
+      elsif User.elem_match( :emails => { :email => record.email } ).count > 0
+        record.errors.add :email, :taken
+      end
+      # validate roles
+      if record.roles_changed?
+        unless Role.slugs.contains? record.roles
+          record.errors.add :roles, :invalid_roles
+        end
+      end
+
+    end
+
+    # accessors:
+    def roles=( value )
+      if value.is_a? Array
+        self[:roles] = value.map(&:to_sym)
+      elsif value.is_a? String
+        self[:roles] = value.split(",").map{|v| v.strip.to_sym}
+      else
+        raise ArgumentError.new "Invalid value of class #{value.class} passed to roles= setter"
+      end
+    end
+
+  end # class UserNewForm
+end # module Admin

data/db/model/user.rb

@@ -0,0 +1,26 @@
+class User
+
+  # Creates a User from Admin::UserNewForm.
+  #
+  def self.create_from_admin_user_new_form( object )
+    raise "Cannot create User from #{object.class}" unless object.is_a? Admin::UserNewForm
+
+    tmp_password = self.generate_confirmation_token # generates random password
+    self.new(
+      full_name: object.full_name,
+      roles: object.roles,
+      emails: [{
+        email: object.email,
+        confirmed: false
+      }],
+      authentications: [{
+        provider: :password,
+        uid: object.email,
+        email_id: object.email,
+        password: tmp_password,
+        password_confirmation: tmp_password
+      }]
+    )
+  end
+
+end # class User

data/db/seed/01_admin_roles.seed

@@ -0,0 +1,8 @@
+model Role
+
+find_by [:slug]
+
+seeds [
+{ slug: :admin,  name: "Administrator" }
+]
+

data/db/seed/02_admin_access.seed

@@ -0,0 +1,24 @@
+# A .seed file is a .conf file which stores
+# database seed data and rules.
+#
+
+# Model class to use
+#
+# ! required
+model Access
+
+# Attribute name or a list of attribute names to be used as key(s)
+# when finding objects
+#
+# Usage:
+#   find_by :name
+# or
+#   find_by [:first_name, :last_name]
+#
+# ! required
+find_by [:path, :role]
+
+seeds [
+{ path: '/admin/**',   access: :RW,  role: :admin }
+]
+

data/db/seed/development/20_users.seed

@@ -0,0 +1,45 @@
+model User
+
+find_by :full_name
+
+# Values of attributes listed here will be set even
+# if they exist already in the matching database object.
+#
+# Other attributes in the seed data will be treated as a default value,
+# i.e. they will only be set if the matching database object does not exist
+# or its corresponding attribute is not set.
+#
+# Usage:
+#   force :value
+# or:
+#   force [:value, :description]
+#
+# default is: no fields are forced
+
+#force :value
+
+def create_test_user( name )
+  email = "#{name}@#{name}"
+  {
+    full_name: name,
+    roles: [:user],
+    emails:[{
+      email: email,
+      confirmed: true
+    }],
+    authentications:[{
+      provider: :password,
+      uid: email,
+      email_id: email,
+      password: 'test',
+      password_confirmation: 'test'
+    }]
+  }
+end
+
+user_seeds = []
+20.times do |i|
+  user_seeds << create_test_user( "user#{i}" )
+end
+
+seeds user_seeds

data/db/seed/development/admin_users.seed

@@ -0,0 +1,38 @@
+model User
+
+find_by :full_name
+
+# Values of attributes listed here will be set even
+# if they exist already in the matching database object.
+#
+# Other attributes in the seed data will be treated as a default value,
+# i.e. they will only be set if the matching database object does not exist
+# or its corresponding attribute is not set.
+#
+# Usage:
+#   force :value
+# or:
+#   force [:value, :description]
+#
+# default is: no fields are forced
+
+#force :value
+
+seeds [
+{
+  full_name: 'admin',
+  roles: [:user, :admin],
+  emails:[{
+    email: 'admin@admin',
+    confirmed: true
+  }],
+  authentications:[{
+    provider: :password,
+    uid: 'admin@admin',
+    email_id: 'admin@admin',
+    password: 'admin',
+    password_confirmation: 'admin'
+  }]
+}
+]
+

data/lib/aerogel/admin.rb

@@ -0,0 +1,25 @@
+require 'aerogel/core'
+require 'aerogel/forms'
+require 'aerogel/users'
+require 'aerogel/media'
+require 'aerogel/bootstrap'
+require 'aerogel/font_awesome'
+
+require "aerogel/admin/version"
+require "aerogel/admin/core"
+require "aerogel/admin/menu"
+require "aerogel/admin/table_builder"
+require "aerogel/admin/tabs_builder"
+
+module Aerogel
+
+  # Finally, register module's root folder
+  register_path File.join( File.dirname(__FILE__), '..', '..' )
+
+  # configure module
+  on_load do |app|
+    app.register Aerogel::Admin
+  end
+
+end
+

data/lib/aerogel/admin/core.rb

@@ -0,0 +1,14 @@
+module Aerogel::Admin
+
+  def self.registered(app)
+    setup_reloader(app) if Aerogel.config.aerogel.reloader?
+
+    # module initialization
+  end
+
+  def self.setup_reloader(app)
+    app.use Aerogel::Reloader, :routes, before: true do
+      Aerogel::Admin::Menu.reset!
+    end
+  end
+end # module Aerogel::Admin

data/lib/aerogel/admin/menu.rb

@@ -0,0 +1,38 @@
+module Aerogel::Admin
+  class Menu
+    attr_accessor :items
+    def initialize()
+      @items = []
+    end
+
+    def self.instance
+      @instance ||= self.new
+    end
+
+    def self.reset!
+      instance.items.clear
+    end
+
+    class Item
+      attr_accessor :url, :icon, :label, :priority
+      def initialize( url, opts = {} )
+        self.url = url
+        self.icon = opts[:icon]
+        self.label = opts[:label] || url
+        self.priority = opts[:priority] || 50
+      end
+
+      def self.create( url, opts = {} )
+        Menu.instance.items << self.new( url, opts )
+      end
+
+      def human_label
+        if label.is_a? Symbol
+          I18n.t label
+        else
+          label.humanize
+        end
+      end
+    end # class Item
+  end # class Menu
+end # module Aerogel::Admin

data/lib/aerogel/admin/table_builder.rb

@@ -0,0 +1,100 @@
+module Aerogel::Admin
+
+  # TableBuilder constructs and displays a table populated with data obtained
+  # from passed object.
+  #
+  # Example:
+  #   table User.all do
+  #     column :full_name
+  #     column :roles
+  #   end
+  #
+  class TableBuilder < Aerogel::Render::BlockHelper
+
+    attr_accessor :object, :options, :columns, :style
+
+    DEFAULT_OPTIONS = {
+      class: 'table-striped',
+      style: 'standard',
+      html_params: {}
+    }
+
+    def initialize( object, options = {}, &block )
+      super( &block )
+      self.object = object
+      self.options = DEFAULT_OPTIONS.deep_merge( options )
+      self.style = self.options[:style]
+      self.columns = []
+    end
+
+    def column( *args, &block )
+      self.columns << Column.new( self, *args, &block )
+      nil
+    end
+
+    def template( name )
+      "admin/table_builder/#{style}/#{name}".to_sym
+    end
+
+    def wrap( content )
+      erb template("table.html"), locals: { table: self }, layout: false
+    end
+
+    # Renders html params for <table ...>
+    #
+    def html_params
+      attrs = @options[:html_params].dup
+      attrs.merge!({
+        # :action => @options[:action]
+      })
+      attrs.map{|n, v| v.nil? ? "#{n}" : "#{n}=\"#{v}\""}.join(" ")
+    end
+
+
+  private
+
+    class Column
+
+      attr_accessor :table, :field, :label, :options, :block
+
+      KNOWN_OPTIONS = [ :label ]
+
+      def initialize( table, field, options = {}, &block )
+        self.table = table
+        self.field = field
+        self.options = options
+        self.block = block
+        self.label = self.options[:label] || self.field.to_sym
+      end
+
+      def human_label
+        if label.is_a? Symbol
+          if table.object.respond_to? :human_attribute_name
+            table.object.human_attribute_name label, default: label
+          elsif table.object.respond_to?( :first ) &&  table.object.first.class.respond_to?( :human_attribute_name )
+            table.object.first.class.human_attribute_name label, default: label
+          else
+            I18n.t label
+          end
+        elsif label.is_a? String
+          label
+        else
+          label.to_s.humanize
+        end
+      end
+
+      # Renders html params for column cells
+      #
+      def html_params
+        attrs = @options.except( *KNOWN_OPTIONS )
+        attrs = attrs.deep_merge( @options[:html_params] ) if @options.key? :html_params
+        attrs.to_html_params
+      end
+
+    end # class Column
+
+  end # class TableBuilder
+
+end # module Aerogel::Admin
+
+

data/lib/aerogel/admin/tabs_builder.rb

@@ -0,0 +1,69 @@
+module Aerogel::Admin
+
+  # TabsBuilder constructs and displays a tab navigation.
+  # from passed object.
+  #
+  # Example:
+  #   tabs do
+  #     tab "/url/to/page1", label: "Page 1"
+  #     tab "/url/to/page2", label: "Page 2"
+  #   end
+  #
+  class TabsBuilder < Aerogel::Render::BlockHelper
+
+    attr_accessor :options, :tabs, :style
+
+    DEFAULT_OPTIONS = {
+      style: 'standard'
+    }
+
+    def initialize( options = {}, &block )
+      super( &block )
+      self.options = DEFAULT_OPTIONS.deep_merge( options )
+      self.style = self.options[:style]
+      self.tabs = []
+    end
+
+    def tab( *args, &block )
+      self.tabs << Tab.new( *args, &block )
+      nil
+    end
+
+    def template( name )
+      "admin/tabs_builder/#{style}/#{name}".to_sym
+    end
+
+    def wrap( content )
+      erb template("tabs.html"), locals: { tabs: self }, layout: false
+    end
+
+  private
+
+    class Tab
+
+      attr_accessor :url, :label, :options, :block
+
+      def initialize( url, options = {}, &block )
+        self.url = url
+        self.options = options
+        self.label = self.options[:label] || self.url
+        self.block = block
+      end
+
+      def human_label
+        if label.is_a? String
+          label
+        elsif label.is_a? Symbol
+          I18n.t label
+        else
+          label.humanize
+        end
+      end
+
+    end # class Tab
+
+  end # class TabsBuilder
+
+end # module Aerogel::Admin
+
+