padrino-admin 0.7.5 → 0.7.6

data/VERSION

@@ -1 +1 @@
-0.7.5
+0.7.6

data/lib/padrino-admin.rb

@@ -8,6 +8,18 @@ Dir[File.dirname(__FILE__) + '/padrino-admin/*.rb'].each {|file| require file }
 Dir[File.dirname(__FILE__) + '/padrino-admin/{helpers,orm,middleware,utils}/*.rb'].each {|file| require file }
 Dir[File.dirname(__FILE__) + '/padrino-admin/generators/{actions,admin_app,admin_page,admin_uploader}.rb'].each {|file| require file }
 
+module Padrino
+  ##
+  # Padrino::Admin is beautiful Ajax Admin, with these fatures:
+  # 
+  # Orm Agnostic:: Adapters for datamapper, activerecord, mongomapper, couchdb (now only: datamapper and activerecord)
+  # Authentication:: Support for Account authentication, Account Permission managment
+  # Scaffold:: You can simply create a new "admin interface" simply providing a Model
+  # Ajax Uploads:: You can upload file, manage them and attach them to any model in a quick and simple way (coming soon)
+  # 
+  module Admin; end
+end
+
 ##
 # We need to apply Padrino::Admin::Utils::Extensions
 # 
@@ -18,7 +30,7 @@ String.send(:include, Padrino::Admin::Utils::Literal)
 # We need to add to Padrino::Application a +access_control+ class
 # 
 Padrino::Application.send(:cattr_accessor, :access_control)
-Padrino::Application.send(:access_control=, Class.new(Padrino::AccessControl::Base))
+Padrino::Application.send(:access_control=, Class.new(Padrino::Admin::AccessControl::Base))
 
 ##
 # If CarrierWave is defined we set the root directory

data/lib/padrino-admin/access_control.rb

@@ -1,402 +1,403 @@
 module Padrino
-
-  class AccessControlError < StandardError #:nodoc:
-  end
-
-  ##
-  # This module give to a padrino application an access control functionality like:
-  #   
-  #   class EcommerceDemo < Padrino::Application
-  #     enable :authentication
-  #     set :login_page, "/login" # or your login page
-  #     enable :store_location # if you want know what is the page that need authentication
-  # 
-  #     access_control.roles_for :any do
-  #       role.require_login "/cart"
-  #       role.require_login "/account"
-  #       role.allow "/account/create"
-  #     end
-  #   end
-  # 
-  # In the EcommerceDemo, we +only+ require logins for all paths that start with "/cart" like:
-  # 
-  #   - "/cart/add"
-  #   - "/cart/empty"
-  #   - "/cart/checkout"
-  # 
-  # same thing for "/account" so we require a login for:
-  # 
-  #   - "/account"
-  #   - "/account/edit"
-  #   - "/account/update"
-  # 
-  # but if we call "/account/create" we don't need to be logged in our site for do that.
-  # In EcommerceDemo example we set +redirect_back_or_default+ so if a +unlogged+ 
-  # user try to access "/account/edit" will be redirected to "/login" when login is done will be 
-  # redirected to "/account/edit".
-  # 
-  # If we need something more complex aka roles/permissions we can do that in the same simple way
-  # 
-  #   class AdminDemo < Padrino::Application
-  #     enable :authentication
-  #     set :login_page, "/sessions/new" # or your page
-  #     
-  #     access_control.roles_for :any do |role|
-  #       role.allow "/sessions"
-  #     end
-  #   
-  #     access_control.roles_for :admin do |role, account|
-  #       role.allow "/"
-  #       role.deny  "/posts"
-  #     end
-  #     
-  #     access_control.roles_for :editor do |role, account|
-  #       role.allow "/posts"
-  #     end
-  #   end
-  # 
-  #   If a user logged with role admin can:
-  #   
-  #   - Access to all paths that start with "/session" like "/sessions/{new,create}"
-  #   - Access to any page except those that start with "/posts"
-  # 
-  #   If a user logged with role editor can:
-  # 
-  #   - Access to all paths that start with "/session" like "/sessions/{new,create}"
-  #   - Access +only+ to paths that start with "/posts" like "/post/{new,edit,destroy}"
-  # 
-  # Finally we have another good fatures, the possibility in the same time we build role build also +tree+.
-  # Figure this scenario: in my admin every account need their own menu, so an Account with role editor have
-  # a menu different than an Account with role admin.
-  # 
-  # So:
-  # 
-  #   class AdminDemo < Padrino::Application
-  #     enable :authentication
-  #     set :redirect_to_default, "/" # or your page
-  #     
-  #     access_control.roles_for :any do |role|
-  #       role.allow "/sessions"
-  #     end
-  #     
-  #     access_control.roles_for :admin do |role, current_account|
-  #       
-  #       role.project_module :settings do |project|
-  #         project.menu :accounts, "/accounts" do |accounts|
-  #           accounts.add :new, "/accounts/new" do |account|
-  #             account.add :administrator, "/account/new/?role=administrator"               
-  #             account.add :editor,        "/account/new/?role=editor"
-  #           end
-  #         end
-  #         project.menu :spam_rules, "/manage_spam"
-  #       end
-  #       
-  #       role.project_module :categories do |project|
-  #         current_account.categories.each do |category|
-  #           project.menu category.name, "/categories/#{category.id}.js"
-  #         end
-  #       end
-  #     end
-  #     
-  #     access_control.roles_for :editor do |role, current_account|
-  #       
-  #       role.project_module :posts do |posts|
-  #         post.menu :list, "/posts"
-  #         post.menu :new,  "/posts/new"
-  #       end
-  #     end
-  # 
-  # In this example when we build our menu tree we are also defining roles so:
-  # 
-  # An Admin Account have access to:
-  # 
-  # - All paths that start with "/sessions"
-  # - All paths that start with "/accounts"
-  # - All paths that start with "/manage_spam"
-  # 
-  # An Editor Account have access to:
-  # 
-  # - All paths that start with "/posts"
-  # 
-  # Remember that you always deny a specific actions or allow globally others.
-  # 
-  # Remember that when you define role_for :a_role, you have also access to the Model Account.
-  #
-  module AccessControl
+  module Admin
+    class AccessControlError < StandardError #:nodoc:
+    end
 
     ##
-    # Method used by Padrino::Application when we register the extension
+    # This module give to a padrino application an access control functionality like:
+    #   
+    #   class EcommerceDemo < Padrino::Application
+    #     enable :authentication
+    #     set :login_page, "/login" # or your login page
+    #     enable :store_location # if you want know what is the page that need authentication
     # 
-    def self.registered(app)
-      app.set :session_id, "_padrino_#{File.basename(Padrino.root)}_#{app.app_name}".to_sym
-      app.helpers Padrino::Admin::Helpers
-      app.before { login_required }
-      app.use Padrino::Admin::Middleware::FlashMiddleware, app.session_id  # make sure that is the same of session_name in helpers
-      Padrino::Admin::Orm.extend_account!
-    end
+    #     access_control.roles_for :any do
+    #       role.require_login "/cart"
+    #       role.require_login "/account"
+    #       role.allow "/account/create"
+    #     end
+    #   end
+    # 
+    # In the EcommerceDemo, we +only+ require logins for all paths that start with "/cart" like:
+    # 
+    #   - "/cart/add"
+    #   - "/cart/empty"
+    #   - "/cart/checkout"
+    # 
+    # same thing for "/account" so we require a login for:
+    # 
+    #   - "/account"
+    #   - "/account/edit"
+    #   - "/account/update"
+    # 
+    # but if we call "/account/create" we don't need to be logged in our site for do that.
+    # In EcommerceDemo example we set +redirect_back_or_default+ so if a +unlogged+ 
+    # user try to access "/account/edit" will be redirected to "/login" when login is done will be 
+    # redirected to "/account/edit".
+    # 
+    # If we need something more complex aka roles/permissions we can do that in the same simple way
+    # 
+    #   class AdminDemo < Padrino::Application
+    #     enable :authentication
+    #     set :login_page, "/sessions/new" # or your page
+    #     
+    #     access_control.roles_for :any do |role|
+    #       role.allow "/sessions"
+    #     end
+    #   
+    #     access_control.roles_for :admin do |role, account|
+    #       role.allow "/"
+    #       role.deny  "/posts"
+    #     end
+    #     
+    #     access_control.roles_for :editor do |role, account|
+    #       role.allow "/posts"
+    #     end
+    #   end
+    # 
+    #   If a user logged with role admin can:
+    #   
+    #   - Access to all paths that start with "/session" like "/sessions/{new,create}"
+    #   - Access to any page except those that start with "/posts"
+    # 
+    #   If a user logged with role editor can:
+    # 
+    #   - Access to all paths that start with "/session" like "/sessions/{new,create}"
+    #   - Access +only+ to paths that start with "/posts" like "/post/{new,edit,destroy}"
+    # 
+    # Finally we have another good fatures, the possibility in the same time we build role build also +tree+.
+    # Figure this scenario: in my admin every account need their own menu, so an Account with role editor have
+    # a menu different than an Account with role admin.
+    # 
+    # So:
+    # 
+    #   class AdminDemo < Padrino::Application
+    #     enable :authentication
+    #     set :redirect_to_default, "/" # or your page
+    #     
+    #     access_control.roles_for :any do |role|
+    #       role.allow "/sessions"
+    #     end
+    #     
+    #     access_control.roles_for :admin do |role, current_account|
+    #       
+    #       role.project_module :settings do |project|
+    #         project.menu :accounts, "/accounts" do |accounts|
+    #           accounts.add :new, "/accounts/new" do |account|
+    #             account.add :administrator, "/account/new/?role=administrator"               
+    #             account.add :editor,        "/account/new/?role=editor"
+    #           end
+    #         end
+    #         project.menu :spam_rules, "/manage_spam"
+    #       end
+    #       
+    #       role.project_module :categories do |project|
+    #         current_account.categories.each do |category|
+    #           project.menu category.name, "/categories/#{category.id}.js"
+    #         end
+    #       end
+    #     end
+    #     
+    #     access_control.roles_for :editor do |role, current_account|
+    #       
+    #       role.project_module :posts do |posts|
+    #         post.menu :list, "/posts"
+    #         post.menu :new,  "/posts/new"
+    #       end
+    #     end
+    # 
+    # In this example when we build our menu tree we are also defining roles so:
+    # 
+    # An Admin Account have access to:
+    # 
+    # - All paths that start with "/sessions"
+    # - All paths that start with "/accounts"
+    # - All paths that start with "/manage_spam"
+    # 
+    # An Editor Account have access to:
+    # 
+    # - All paths that start with "/posts"
+    # 
+    # Remember that you always deny a specific actions or allow globally others.
+    # 
+    # Remember that when you define role_for :a_role, you have also access to the Model Account.
+    #
+    module AccessControl
+
+      ##
+      # Method used by Padrino::Application when we register the extension
+      # 
+      def self.registered(app)
+        app.set :session_id, "_padrino_#{File.basename(Padrino.root)}_#{app.app_name}".to_sym
+        app.helpers Padrino::Admin::Helpers
+        app.before { login_required }
+        app.use Padrino::Admin::Middleware::FlashMiddleware, app.session_id  # make sure that is the same of session_name in helpers
+        Padrino::Admin::Orm.extend_account!
+      end
+
+      class Base
+        class << self
+          attr_reader :roles
 
-    class Base
-      class << self
-        attr_reader :roles
+          def inherited(base) #:nodoc:
+            base.class_eval("@@cache={}; @authorizations=[]; @roles=[]; @mappers=[]")
+            base.send(:cattr_reader, :cache)
+            super
+          end
+
+          ##
+          # We map project modules for a given role or roles
+          # 
+          def roles_for(*roles, &block)
+            raise Padrino::Admin::AccessControlError, "Role #{role} must be present and must be a symbol!" if roles.any? { |r| !r.kind_of?(Symbol) } || roles.empty?
+            raise Padrino::Admin::AccessControlError, "You can't merge :any with other roles"              if roles.size > 1 && roles.any? { |r| r == :any }
+
+            if roles == [:any]
+              @authorizations << Authorization.new(&block)
+            else
+              raise Padrino::Admin::AccessControlError, "For use custom roles you need to define an Account Class" unless defined?(Account)
+              @roles.concat(roles)
+              @mappers << Proc.new { |account| Mapper.new(account, *roles, &block) }
+            end
+          end
 
-        def inherited(base) #:nodoc:
-          base.class_eval("@@cache={}; @authorizations=[]; @roles=[]; @mappers=[]")
-          base.send(:cattr_reader, :cache)
-          super
+          ##
+          # Returns (allowed && denied paths).
+          # If an account given we also give allowed & denied paths for their role.
+          # 
+          def auths(account=nil)
+            if account
+              cache[account.id] ||= Auths.new(@authorizations, @mappers, account)
+            else
+              cache[:any] ||= Auths.new(@authorizations)
+            end
+          end
         end
+      end # Base
 
-        ##
-        # We map project modules for a given role or roles
-        # 
-        def roles_for(*roles, &block)
-          raise Padrino::AccessControlError, "Role #{role} must be present and must be a symbol!" if roles.any? { |r| !r.kind_of?(Symbol) } || roles.empty?
-          raise Padrino::AccessControlError, "You can't merge :any with other roles"              if roles.size > 1 && roles.any? { |r| r == :any }
+      class Auths #:nodoc:
+        attr_reader :allowed, :denied, :project_modules
 
-          if roles == [:any]
-            @authorizations << Authorization.new(&block)
+        def initialize(authorizations, mappers=nil, account=nil) #:nodoc:
+          @allowed, @denied = [], []
+          unless authorizations.empty?
+            @allowed = authorizations.collect(&:allowed).flatten
+            @denied  = authorizations.collect(&:denied).flatten
+          end
+          if mappers && !mappers.empty?
+            maps = mappers.collect { |m|  m.call(account) }.reject { |m| !m.allowed? }
+            @allowed.concat(maps.collect(&:allowed).flatten)
+            @denied.concat(maps.collect(&:denied).flatten)
+            @project_modules = maps.collect(&:project_modules).flatten.uniq
           else
-            raise Padrino::AccessControlError, "For use custom roles you need to define an Account Class" unless defined?(Account)
-            @roles.concat(roles)
-            @mappers << Proc.new { |account| Mapper.new(account, *roles, &block) }
+            @project_modules = []
           end
+          @allowed.uniq!
+          @denied.uniq!
         end
 
         ##
-        # Returns (allowed && denied paths).
-        # If an account given we also give allowed & denied paths for their role.
+        # Return true if the requested path (like request.path_info) is allowed.
         # 
-        def auths(account=nil)
-          if account
-            cache[account.id] ||= Auths.new(@authorizations, @mappers, account)
-          else
-            cache[:any] ||= Auths.new(@authorizations)
-          end
+        def can?(request_path)
+          return true if @allowed.empty?
+          request_path = "/" if request_path.blank?
+          @allowed.any? { |path| request_path =~ /^#{path}/ } && !cannot?(request_path)
         end
-      end
-    end # Base
-
-    class Auths #:nodoc:
-      attr_reader :allowed, :denied, :project_modules
 
-      def initialize(authorizations, mappers=nil, account=nil) #:nodoc:
-        @allowed, @denied = [], []
-        unless authorizations.empty?
-          @allowed = authorizations.collect(&:allowed).flatten
-          @denied  = authorizations.collect(&:denied).flatten
-        end
-        if mappers && !mappers.empty?
-          maps = mappers.collect { |m|  m.call(account) }.reject { |m| !m.allowed? }
-          @allowed.concat(maps.collect(&:allowed).flatten)
-          @denied.concat(maps.collect(&:denied).flatten)
-          @project_modules = maps.collect(&:project_modules).flatten.uniq
-        else
-          @project_modules = []
+        ##
+        # Return true if the requested path (like request.path_info) is +not+ allowed.
+        # 
+        def cannot?(request_path)
+          return false if @denied.empty?
+          request_path = "/" if request_path.blank?
+          @denied.any? { |path| request_path =~ /^#{path}/ }
         end
-        @allowed.uniq!
-        @denied.uniq!
-      end
+      end # Auths
 
-      ##
-      # Return true if the requested path (like request.path_info) is allowed.
-      # 
-      def can?(request_path)
-        return true if @allowed.empty?
-        request_path = "/" if request_path.blank?
-        @allowed.any? { |path| request_path =~ /^#{path}/ } && !cannot?(request_path)
-      end
+      class Authorization
+        attr_reader :allowed, :denied
 
-      ##
-      # Return true if the requested path (like request.path_info) is +not+ allowed.
-      # 
-      def cannot?(request_path)
-        return false if @denied.empty?
-        request_path = "/" if request_path.blank?
-        @denied.any? { |path| request_path =~ /^#{path}/ }
-      end
-    end # Auths
+        def initialize(&block) #:nodoc:
+          @allowed = []
+          @denied  = []
+          yield self
+        end
 
-    class Authorization
-      attr_reader :allowed, :denied
+        ##
+        # Allow a specified path
+        # 
+        def allow(path)
+          @allowed << path unless @allowed.include?(path)
+        end
 
-      def initialize(&block) #:nodoc:
-        @allowed = []
-        @denied  = []
-        yield self
-      end
+        ##
+        # Deny a specified path
+        # 
+        def require_login(path)
+          @denied << path unless @denied.include?(path)
+        end
+        alias :deny :require_login
+      end # Authorization
 
-      ##
-      # Allow a specified path
-      # 
-      def allow(path)
-        @allowed << path unless @allowed.include?(path)
-      end
+      class Mapper
+        attr_reader :project_modules, :roles, :denied
 
-      ##
-      # Deny a specified path
-      # 
-      def require_login(path)
-        @denied << path unless @denied.include?(path)
-      end
-      alias :deny :require_login
-    end # Authorization
-
-    class Mapper
-      attr_reader :project_modules, :roles, :denied
-
-      def initialize(account, *roles, &block) #:nodoc:
-        @project_modules = []
-        @allowed         = []
-        @denied          = []
-        @roles           = roles
-        @account         = account.dup
-        yield(self, @account)
-      end
+        def initialize(account, *roles, &block) #:nodoc:
+          @project_modules = []
+          @allowed         = []
+          @denied          = []
+          @roles           = roles
+          @account         = account.dup
+          yield(self, @account)
+        end
 
-      ##
-      # Create a new project module
-      # 
-      def project_module(name, path=nil, &block)
-        @project_modules << ProjectModule.new(name, path, &block)
-      end
+        ##
+        # Create a new project module
+        # 
+        def project_module(name, path=nil, &block)
+          @project_modules << ProjectModule.new(name, path, &block)
+        end
 
-      ##
-      # Globally allow an paths for the current role
-      # 
-      def allow(path)
-        @allowed << path unless @allowed.include?(path)
-      end
+        ##
+        # Globally allow an paths for the current role
+        # 
+        def allow(path)
+          @allowed << path unless @allowed.include?(path)
+        end
 
-      ##
-      # Globally deny an pathsfor the current role
-      # 
-      def deny(path)
-        @denied << path unless @allowed.include?(path)
-      end
+        ##
+        # Globally deny an pathsfor the current role
+        # 
+        def deny(path)
+          @denied << path unless @allowed.include?(path)
+        end
 
-      ##
-      # Return true if role is included in given roles
-      # 
-      def allowed?
-        @roles.any? { |r| r == @account.role.to_s.downcase.to_sym }
-      end
+        ##
+        # Return true if role is included in given roles
+        # 
+        def allowed?
+          @roles.any? { |r| r == @account.role.to_s.downcase.to_sym }
+        end
 
-      ##
-      # Return allowed paths
-      # 
-      def allowed
-        @project_modules.each { |pm| @allowed.concat(pm.allowed)  }
-        @allowed.uniq
-      end
-    end # Mapper
-
-    class ProjectModule
-      attr_reader :name, :menus, :path
-
-      def initialize(name, path=nil, options={}, &block) #:nodoc:
-        @name     = name
-        @options  = options
-        @allowed  = []
-        @menus    = []
-        @path     = path
-        @allowed << path if path
-        yield self if block_given?
-      end
+        ##
+        # Return allowed paths
+        # 
+        def allowed
+          @project_modules.each { |pm| @allowed.concat(pm.allowed)  }
+          @allowed.uniq
+        end
+      end # Mapper
+
+      class ProjectModule
+        attr_reader :name, :menus, :path
+
+        def initialize(name, path=nil, options={}, &block) #:nodoc:
+          @name     = name
+          @options  = options
+          @allowed  = []
+          @menus    = []
+          @path     = path
+          @allowed << path if path
+          yield self if block_given?
+        end
 
-      ##
-      # Build a new menu and automaitcally add the action on the allowed actions.
-      # 
-      def menu(name, path=nil, options={}, &block)
-        @menus << Menu.new(name, path, options, &block)
-      end
+        ##
+        # Build a new menu and automaitcally add the action on the allowed actions.
+        # 
+        def menu(name, path=nil, options={}, &block)
+          @menus << Menu.new(name, path, options, &block)
+        end
 
-      ##
-      # Return allowed controllers
-      # 
-      def allowed
-        @menus.each { |m| @allowed.concat(m.allowed) }
-        @allowed.uniq
-      end
+        ##
+        # Return allowed controllers
+        # 
+        def allowed
+          @menus.each { |m| @allowed.concat(m.allowed) }
+          @allowed.uniq
+        end
 
-      ##
-      # Return the original name or try to translate or humanize the symbol
-      # 
-      def human_name
-        @name.is_a?(Symbol) ? I18n.t("admin.menus.#{@name}", :default => @name.to_s.humanize) : @name
-      end
+        ##
+        # Return the original name or try to translate or humanize the symbol
+        # 
+        def human_name
+          @name.is_a?(Symbol) ? I18n.t("admin.menus.#{@name}", :default => @name.to_s.humanize) : @name
+        end
 
-      ##
-      # Return symbol for the given project module
-      # 
-      def uid
-        @name.to_s.downcase.gsub(/[^a-z0-9]+/, '').gsub(/-+$/, '').gsub(/^-+$/, '').to_sym
-      end
+        ##
+        # Return symbol for the given project module
+        # 
+        def uid
+          @name.to_s.downcase.gsub(/[^a-z0-9]+/, '').gsub(/-+$/, '').gsub(/^-+$/, '').to_sym
+        end
 
-      ##
-      # Return ExtJs Config for this project module
-      # 
-      def config
-        options = @options.merge(:text => human_name)
-        options.merge!(:menu => @menus.collect(&:config)) if @menus.size > 0
-        options.merge!(:handler => Padrino::Admin::Config::Variable.new("function(){ Admin.app.load('#{path}') }")) if @path
-        options
-      end
-    end # ProjectModule
-
-    class Menu
-      attr_reader :name, :options, :items, :path
-
-      def initialize(name, path=nil, options={}, &block) #:nodoc:
-        @name    = name
-        @path    = path
-        @options = options
-        @allowed = []
-        @items   = []        
-        @allowed << path if path
-        yield self if block_given?
-      end
+        ##
+        # Return ExtJs Config for this project module
+        # 
+        def config
+          options = @options.merge(:text => human_name)
+          options.merge!(:menu => @menus.collect(&:config)) if @menus.size > 0
+          options.merge!(:handler => Padrino::Admin::Config::Variable.new("function(){ Admin.app.load('#{path}') }")) if @path
+          options
+        end
+      end # ProjectModule
+
+      class Menu
+        attr_reader :name, :options, :items, :path
+
+        def initialize(name, path=nil, options={}, &block) #:nodoc:
+          @name    = name
+          @path    = path
+          @options = options
+          @allowed = []
+          @items   = []        
+          @allowed << path if path
+          yield self if block_given?
+        end
 
-      ##
-      # Add a new submenu to the menu
-      # 
-      def add(name, path=nil, options={}, &block)
-        @items << Menu.new(name, path, options, &block)
-      end
+        ##
+        # Add a new submenu to the menu
+        # 
+        def add(name, path=nil, options={}, &block)
+          @items << Menu.new(name, path, options, &block)
+        end
 
-      ##
-      # Return allowed controllers
-      # 
-      def allowed
-        @items.each { |i| @allowed.concat(i.allowed) }
-        @allowed.uniq
-      end
+        ##
+        # Return allowed controllers
+        # 
+        def allowed
+          @items.each { |i| @allowed.concat(i.allowed) }
+          @allowed.uniq
+        end
 
-      ##
-      # Return the original name or try to translate or humanize the symbol
-      # 
-      def human_name
-        @name.is_a?(Symbol) ? I18n.t("admin.menus.#{@name}", :default => @name.to_s.humanize) : @name
-      end
+        ##
+        # Return the original name or try to translate or humanize the symbol
+        # 
+        def human_name
+          @name.is_a?(Symbol) ? I18n.t("admin.menus.#{@name}", :default => @name.to_s.humanize) : @name
+        end
 
-      ##
-      # Return a unique id for the given project module
-      # 
-      def uid
-        @name.to_s.downcase.gsub(/[^a-z0-9]+/, '').gsub(/-+$/, '').gsub(/^-+$/, '').to_sym
-      end
+        ##
+        # Return a unique id for the given project module
+        # 
+        def uid
+          @name.to_s.downcase.gsub(/[^a-z0-9]+/, '').gsub(/-+$/, '').gsub(/^-+$/, '').to_sym
+        end
 
-      ##
-      # Return ExtJs Config for this menu
-      # 
-      def config
-        if @path.blank? && @items.empty?
-          options = human_name
-        else
-          options = @options.merge(:text => human_name)
-          options.merge!(:menu => @items.collect(&:config)) if @items.size > 0
-          options.merge!(:handler => "function(){ Admin.app.load('#{path}') }".to_l) if @path
+        ##
+        # Return ExtJs Config for this menu
+        # 
+        def config
+          if @path.blank? && @items.empty?
+            options = human_name
+          else
+            options = @options.merge(:text => human_name)
+            options.merge!(:menu => @items.collect(&:config)) if @items.size > 0
+            options.merge!(:handler => "function(){ Admin.app.load('#{path}') }".to_l) if @path
+          end
+          options
         end
-        options
-      end
-    end # Menu
-  end # AccessControl
+      end # Menu
+    end # AccessControl
+  end # Admin
 end # Padrino

data/lib/padrino-admin/config.rb

@@ -13,7 +13,7 @@ module Padrino
       # 
       #   { "function": "alert('Test')" }
       # 
-      # But if in our javascript need to "eval" this function is not possible because
+      # But if in our javascript we need to "eval" this function is not possible because
       # it's a string.
       # 
       # Using Padrino::Config::Variable the result will be:

data/lib/padrino-admin/helpers/authentication.rb

@@ -38,7 +38,7 @@ module Padrino
       ##
       # Returns true if the +current_account+ is allowed to see the requested path
       # 
-      # For configure this role please refer to: +Padrino::AccessControl::Base+
+      # For configure this role please refer to: +Padrino::Admin::AccessControl::Base+
       # 
       def allowed?
         access_control.auths(current_account).can?(request.path_info)

data/lib/padrino-admin/helpers/view.rb

@@ -86,10 +86,10 @@ module Padrino
       ##
       # This method generates a new ExtJs BoxComponent.
       # 
-      #   Examples:
+      # ==== Examples
       # 
-      #     -box "My Title", "My Subtitle", :submit => true, :collapsible => true, :style => "padding:none", :start => :close do
-      #       my content
+      #   -box "My Title", "My Subtitle", :submit => true, :collapsible => true, :style => "padding:none", :start => :close do
+      #     my content
       # 
       # Defaults:
       # 
@@ -155,7 +155,8 @@ module Padrino
       # :function:: name of the function. Default is autogenerated.
       # :multiple:: if true returns a collections of +:value+. Default false.
       # 
-      # Example multiple values:
+      # ==== Examples multiple values:
+      # 
       #   # Generate:
       #   # <script type="text/javascript">
       #   #   function showAccountImages(){
@@ -276,7 +277,7 @@ module Padrino
         [content_tag(:script, javascript, :type => 'text/javascript'), container, tag(:div, :class => :clear)].join("\n")
       end
 
-      module AbstractFormBuilder
+      module AbstractFormBuilder #:nodoc:
         # f.open_window_grid :upload_ids, :brand_ids, :with => :brands, :get => :id, :show => :name
         def open_window_grid(field, options={})
           @template.open_window_grid object_name, field, options

data/lib/padrino-admin/orm.rb

@@ -1,6 +1,14 @@
 module Padrino
   module Admin
 
+    ##
+    # Extend your orm adding these functions:
+    # 
+    # * Translatable columns names (if not just support them)
+    # * Full text search
+    # * Pagination
+    # * Extend Account Model with: role, validation, permission, authentication
+    # 
     module Orm
 
       class ExtSearch < Struct.new(:count, :records); end

data/lib/padrino-admin/orm/activerecord.rb

@@ -26,7 +26,7 @@ module Padrino
             ##
             # Transforms attribute key names into a more humane format, such as "First name" instead of "first_name". 
             # 
-            # Example:
+            # ==== Examples
             #   Person.human_attribute_name("first_name") # => "First name"
             # 
             # Specify +options+ with additional translating options.

data/lib/padrino-admin/orm/datamapper.rb

@@ -50,7 +50,7 @@ module Padrino
             ##
             # Transforms attribute key names into a more humane format, such as "First name" instead of "first_name". 
             # 
-            # Example:
+            # ==== Examples
             #   Person.human_attribute_name("first_name") # => "First name"
             # 
             # Specify +options+ with additional translating options.

data/padrino-admin.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{padrino-admin}
-  s.version = "0.7.5"
+  s.version = "0.7.6"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Padrino Team", "Nathan Esquenazi", "Davide D'Agostino", "Arthur Chiu"]
-  s.date = %q{2010-02-09}
+  s.date = %q{2010-02-10}
   s.description = %q{Admin View for Padrino applications}
   s.email = %q{padrinorb@gmail.com}
   s.extra_rdoc_files = [
@@ -356,9 +356,9 @@ Gem::Specification.new do |s|
 
     if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<json_pure>, [">= 1.2.0"])
-      s.add_runtime_dependency(%q<padrino-core>, ["= 0.7.5"])
-      s.add_runtime_dependency(%q<padrino-gen>, ["= 0.7.5"])
-      s.add_runtime_dependency(%q<padrino-helpers>, ["= 0.7.5"])
+      s.add_runtime_dependency(%q<padrino-core>, ["= 0.7.6"])
+      s.add_runtime_dependency(%q<padrino-gen>, ["= 0.7.6"])
+      s.add_runtime_dependency(%q<padrino-helpers>, ["= 0.7.6"])
       s.add_runtime_dependency(%q<tilt>, [">= 0.4"])
       s.add_development_dependency(%q<haml>, [">= 2.2.1"])
       s.add_development_dependency(%q<shoulda>, [">= 0"])
@@ -367,9 +367,9 @@ Gem::Specification.new do |s|
       s.add_development_dependency(%q<webrat>, [">= 0.5.1"])
     else
       s.add_dependency(%q<json_pure>, [">= 1.2.0"])
-      s.add_dependency(%q<padrino-core>, ["= 0.7.5"])
-      s.add_dependency(%q<padrino-gen>, ["= 0.7.5"])
-      s.add_dependency(%q<padrino-helpers>, ["= 0.7.5"])
+      s.add_dependency(%q<padrino-core>, ["= 0.7.6"])
+      s.add_dependency(%q<padrino-gen>, ["= 0.7.6"])
+      s.add_dependency(%q<padrino-helpers>, ["= 0.7.6"])
       s.add_dependency(%q<tilt>, [">= 0.4"])
       s.add_dependency(%q<haml>, [">= 2.2.1"])
       s.add_dependency(%q<shoulda>, [">= 0"])
@@ -379,9 +379,9 @@ Gem::Specification.new do |s|
     end
   else
     s.add_dependency(%q<json_pure>, [">= 1.2.0"])
-    s.add_dependency(%q<padrino-core>, ["= 0.7.5"])
-    s.add_dependency(%q<padrino-gen>, ["= 0.7.5"])
-    s.add_dependency(%q<padrino-helpers>, ["= 0.7.5"])
+    s.add_dependency(%q<padrino-core>, ["= 0.7.6"])
+    s.add_dependency(%q<padrino-gen>, ["= 0.7.6"])
+    s.add_dependency(%q<padrino-helpers>, ["= 0.7.6"])
     s.add_dependency(%q<tilt>, [">= 0.4"])
     s.add_dependency(%q<haml>, [">= 2.2.1"])
     s.add_dependency(%q<shoulda>, [">= 0"])

data/test/test_access_control.rb

@@ -4,7 +4,7 @@ class TestAccessControl < Test::Unit::TestCase
 
   def setup
     load_fixture 'data_mapper'
-    @access = Class.new(Padrino::AccessControl::Base)
+    @access = Class.new(Padrino::Admin::AccessControl::Base)
 
     @access.roles_for :any do |role|
       role.allow "/sessions"
@@ -38,7 +38,7 @@ class TestAccessControl < Test::Unit::TestCase
   context 'for authorization functionality' do
 
     should 'check empty auths' do
-      empty = Class.new(Padrino::AccessControl::Base)
+      empty = Class.new(Padrino::Admin::AccessControl::Base)
       assert empty.auths.can?("/foo/bar")
       assert ! empty.auths.cannot?("/foo/bar")
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: padrino-admin
 version: !ruby/object:Gem::Version 
-  version: 0.7.5
+  version: 0.7.6
 platform: ruby
 authors: 
 - Padrino Team
@@ -12,7 +12,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-02-09 00:00:00 +01:00
+date: 2010-02-10 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -33,7 +33,7 @@ dependencies:
     requirements: 
     - - "="
       - !ruby/object:Gem::Version 
-        version: 0.7.5
+        version: 0.7.6
     version: 
 - !ruby/object:Gem::Dependency 
   name: padrino-gen
@@ -43,7 +43,7 @@ dependencies:
     requirements: 
     - - "="
       - !ruby/object:Gem::Version 
-        version: 0.7.5
+        version: 0.7.6
     version: 
 - !ruby/object:Gem::Dependency 
   name: padrino-helpers
@@ -53,7 +53,7 @@ dependencies:
     requirements: 
     - - "="
       - !ruby/object:Gem::Version 
-        version: 0.7.5
+        version: 0.7.6
     version: 
 - !ruby/object:Gem::Dependency 
   name: tilt