lipsiadmin 2.9

data/CHANGELOG

@@ -0,0 +1,90 @@
+2009-02-27
+  * Fixed a litte padding in firefox for datetimefield
+  * Fixed a typo in account.rb
+  * Fixed attachment creation for new records
+  * Fixed a little problem with the generation of the attachment table
+  * Added an options for prevent sending email, usefull for test rescue but not email report
+  * Fixed a translation in backend_helper
+  * Fixed a double render action in pdf
+  * Added send_data as an options in pdf builder (for the controller)
+  * Fixed the en locale for backend
+  * Added scope to the component events
+  * Added a new task for update javascripts (add require 'lipsiadmin_tasks' if you don't have yet in your RakeFile)
+  * Fixed padding in DateTime Field for firefox
+  * Removed not necessary frontend images 
+  * Extended Ext Component to be more flexible
+  * Small refactoring of ext components
+
+2009-02-26
+  * Removed a grid unusued var
+  * Added a new method to grid for getSelection
+  * Added a as default grid.on("dblclick", edit)
+  * Added a component handler (eg. grid.on(:dblclick, ...))
+  * Fixed a litte error in date renderer
+  * Fixed a litte error in Ext.form.DateTimeField
+  * Added a padding for exceptions in standard.css
+  * Fixed a litte error in backend.js
+  * Fixed update, for force text/html header
+  * Added two helpers to ext for mask, unmask Backend.app
+  * Improved the exception_notifier and rescue templates for backend
+  * Fixed ext_alert helper
+  * Fixed ext_date_select
+  * Fixed a little problem in exception notifier
+  * Added a rescue if association not found in column_store
+  * Improved documentation of box helper
+  * Fixed a missing localization in box helper
+  * Added :start => :close/:ope to the box helper
+  * Added :style => "mystyle" to the box helper
+  * Added in grid builder (edit, new, destroy) path for toolbar
+  * Little reformat to Lipsiadmin::Controller::Ext::ColumnStore
+  * Added new renderer in column model (boolean, eur_money, us_money)
+  * Updated the remember file of script/generate backend_page
+  * Improved store_data :include etc... see documentation Lipsiadmin::Controller::Ext for more details
+  * Fixed a dataIndex conditions
+  * Imporoved mapping columns for a better search
+
+2009-02-25
+  * Improved documentation now is online here http://api.lipsiasoft.com
+  * Refactored text_field, text_area, password_field helpers
+  * Refactored country_select helper
+  * Refactored ext_date_select, ext_datetime_select helpers
+  
+2008-02-24
+  * Rename Js app from Lipsiadmin.app to Backend.app
+  * Added the possibility to reuse pages/froms/grids in windows.
+  * Removed all external plugins
+  * Rewritten Attachment creation
+  * Rewritten Authentication and Menu creation
+  * Rewritten all Helpers (now more fast)
+  * Added a new helper for build extjs calendar (eg. ext_datetime :model, :created_at)
+  * Added a new helper for build ext box
+  * Included the missing country_select
+  * Added helpers for build rjs grids
+  * Grid by default have a search box that is no longer clientside but serverside
+  * Improved html tags using the extjs stylesheets
+  * Improved performances of javascript
+  * Minimized ExtJs and Rails javascripts
+  * Added a support request
+  * Added an exception notifier
+  * Rewritten pdf builder and helper
+  * Added a pdf builder for actionmailer
+  * Added method missing in ActiveRecord to intercept calls to non-localized methods (eg. name instead of name_cz)
+  * Added utility scopes for paginate, include, search
+  * Added a new literal method for prevent json to "strignify" javascripts funtctions (eg. "function() { alert('me')}".to_l)
+  * Added a new module for escape utf8 chars for servers that don't have java with utf8 fonts (it's used by pdf builder)
+  
+2008-05-21
+  * Added a new PDF generator, we don't need the expensive PRINCEXML, we can use pd4ml
+
+2008-05-12.
+  * Added a manifest that show the current routes that are necessary to add
+
+2008-05-09.
+  * Added ext-all-debug.js (Was autodetect if env == development)
+  * Removed menuitems table and added new module project 
+  * Improve Auth System with project modules
+  * Initial rdoc documentation
+  * Removed from admin view list to index so we can use cruds
+  * Improve Admin -> Accounts for add project modules
+  * Added new class AccessControl (Documented)
+  * New config file for roles, modules in initializers/access_rules.rb

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Davide D'Agostino, LipsiaSoft s.r.l.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README

@@ -0,0 +1,60 @@
+==Lipsiadmin
+
+Lipsiadmin is a new revolutionary admin for your projects.
+
+Is developped by http://www.lipsiasoft.com that use it from 2 years in production enviroments.
+
+Lipsiadmin is based on Ext Js 2.2 framework (with prototype adapter) works with Rails 2+
+
+This admin is for newbie developper but also for experts, is not entirely written in javascript 
+because the aim of developper wose build in a agile way web/site apps so we use extjs in a new 
+intelligent way a mixin of <tt>old</tt> html and new ajax functions, 
+for example ext manage the layout of page, grids, tree and errors, but form are in html code.
+
+Author:: Davide D'Agostino
+Copyright:: Copyright (c) 2009 Lipsiasoft s.r.l. (http://www.lipsiasoft.com)
+License:: MIT License (http://www.opensource.org/licenses/mit-license.php)
+Api Documentation:: http://api.lipsiasoft.com
+Community:: http://groups.google.com/group/lipsiadmin
+
+==Requirements
+
+Rails 2+
+Haml 2+
+
+==Installation
+
+  script/plugin install git://github.com/Lipsiasoft/lipsiadmin.git
+
+The version 2.9 version is an alpha relase and the gem will be aviable from 3.0
+
+In future you can simply do:
+
+  in config/environments.rb
+  config.gem "lipsiadmin"
+  
+then (if you don't have it already)
+  
+  $ rake gems:install
+  
+==Examples
+
+now run script/generate and you can see some like:
+
+  Installed Generators
+    Builtin: controller, integration_test, mailer, migration, model, etc..
+    Lipsiadmin: attachment, backend, backend_page, pdf
+
+So you can do:
+
+  $ script/generate backend # Generate the base admin
+  $ script/generate backend_page yourmodel # Generate a "scaffold" for your model
+  $ script/generate attachment # Generate the an attachments
+  $ script/generate pdf PdfName # Generate a new pdf document
+
+==Contribute
+
+Please contribute in coding, patch, and submitting translation api documentation etc...
+
+Community can be found here:: http://groups.google.com/group/lipsiadmin
+Api documentation can be found here:: http://api.lipsiasoft.com

data/Rakefile

@@ -0,0 +1,90 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/packagetask'
+require 'rake/gempackagetask'
+require 'rake/contrib/sshpublisher'
+
+PKG_NAME      = 'lipsiadmin'
+PKG_VERSION   = "2.9"
+PKG_FILE_NAME = "#{PKG_NAME}-#{PKG_VERSION}"
+
+$LOAD_PATH << File.join(File.dirname(__FILE__), 'lib')
+
+desc 'Default: install the gem.'
+task :default => [:install]
+
+desc 'Generate documentation for the lipsiadmin plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'doc'
+  rdoc.title    = 'Lipsiadmin'
+  rdoc.options << '--line-numbers' << '--inline-source' << '--accessor' << 'cattr_accessor=object'
+  rdoc.options << '--charset' << 'utf-8'
+  rdoc.template = 'resources/rdoc/horo'
+  rdoc.rdoc_files.include('README', 'CHANGELOG')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+desc 'Clean up files.'
+task :clean do |t|
+  FileUtils.rm_rf "doc"
+  FileUtils.rm_rf "tmp"
+  FileUtils.rm_rf "pkg"
+end
+
+spec = Gem::Specification.new do |s| 
+  s.name              = PKG_NAME
+  s.version           = PKG_VERSION
+  s.author            = "Davide D'Agostino"
+  s.email             = "d.dagostino@lipsiasoft.com"
+  s.homepage          = "http://groups.google.com/group/lipsiadmin"
+  s.rubyforge_project = "lipsiadmin"
+  s.platform          = Gem::Platform::RUBY
+  s.summary           = "Lipsiadmin is a new revolutionary admin for your projects.Lipsiadmin is based on Ext Js 2.0. framework (with prototype adapter) and is ready for Rails 2.0. This admin is for newbie developper but also for experts, is not entirely written in javascript because the aim of developper wose build in a agile way web/site apps so we use extjs in a new intelligent way a mixin of “old” html and new ajax functions, for example ext manage the layout of page, grids, tree and errors, but form are in html code."
+  s.files             = FileList["CHANGELOG", "README", "MIT-LICENSE", "Rakefile", "init.rb", "{lipsiadmin_generators,lib,resources,tasks}/**/*"].to_a
+  s.has_rdoc          = true
+  s.requirements     << 'Haml'
+  s.requirements     << 'Rails'
+end
+
+Rake::GemPackageTask.new(spec) do |p|
+  p.gem_spec = spec
+  p.need_tar = true
+  p.need_zip = true
+end
+
+desc "Install the gem locally"
+task :install => [:uninstall, :repackage] do
+  sh %{sudo gem install pkg/#{PKG_FILE_NAME}.gem --no-ri --no-rdoc}
+end
+
+desc "Unistall the gem from local"
+task :uninstall => [:clean] do
+  sh %{sudo gem uninstall #{PKG_NAME}} rescue nil
+end
+ 
+desc "Generate a gemspec file for GitHub"
+task :gemspec do
+  File.open("#{spec.name}.gemspec", 'w') do |f|
+    f.write spec.to_ruby
+  end
+end
+
+desc "Publish the API documentation"
+task :pdoc => [:rdoc] do 
+  Rake::SshDirPublisher.new("root@server1.lipsiasoft.com", "/var/www/apps/lipsiadmin/rdoc", "doc").upload
+end
+
+desc "Publish the release files to RubyForge."
+task :release => [ :package ] do
+  require 'rubyforge'
+  require 'rake/contrib/rubyforgepublisher'
+
+  packages = %w( gem tgz zip ).collect{ |ext| "pkg/#{PKG_NAME}-#{PKG_VERSION}.#{ext}" }
+
+  rubyforge = RubyForge.new
+  rubyforge.configure
+  rubyforge.login
+  rubyforge.add_release(PKG_NAME, PKG_NAME, "REL #{PKG_VERSION}", *packages)
+end

data/init.rb

@@ -0,0 +1 @@
+require 'lipsiadmin'

data/lib/access_control/authentication.rb

@@ -0,0 +1,105 @@
+module Lipsiadmin
+  module AccessControl
+    # This provide a simple login for backend and frontend.
+    # Use backend_login_required in backend and
+    # frontend_login_requirded in frontend.
+    # 
+    #   Examples:
+    # 
+    #     class FrontendController <  ApplicationController
+    #       before_filter :login_frontend_required, :except => [:login]
+    #     end
+    # 
+    module Authentication
+      protected
+        
+        # Returns true if <tt>current_account</tt> is logged and active.
+        def logged_in?
+          current_account != :false && current_account.active?
+        end
+        
+        # Returns the current_account, it's an instance of <tt>Account</tt> model
+        def current_account
+          @current_account ||= (login_from_session || :false)
+        end
+        
+        # Ovverride the current_account, you must provide an instance of Account Model
+        # 
+        #   Examples:
+        #   
+        #     current_account = Account.last
+        # 
+        def current_account=(new_account)
+          session[:account] = (new_account.nil? || new_account.is_a?(Symbol)) ? nil : new_account.id
+          @current_account = new_account
+        end
+
+        # Returns true if the <tt>current_account</tt> is allowed to see the requested
+        # controller/action.
+        # 
+        # For configure this role please refer to: <tt>Lipsiadmin::AccessControl::Base</tt>
+        def allowed?
+          allowed = current_account.maps.collect(&:allowed)[0]
+          denied  = current_account.maps.collect(&:denied)[0]
+          
+          allow = allowed.find do |a|
+            a[:controller] == params[:controller] &&
+            (a[:action].blank? || a[:action] == params[:action])
+          end
+          
+          deny = denied.find do |a|
+            a[:controller] == params[:controller] &&
+            (a[:action].blank? || a[:action] == params[:action])
+          end
+          
+          return allow && !deny
+        end
+
+        # Returns a helper to pass in a <tt>before_filter</tt> for check if
+        # an account are: <tt>logged_in?</tt> and <tt>allowed?</tt>
+        # 
+        # By default this method is used in BackendController so is not necessary
+        def backend_login_required
+          logged_in?  && allowed? || access_denied(:backend)
+        end
+        
+        # Returns a helper to pass in a <tt>before_filter</tt> for check if
+        # an account are: <tt>logged_in?</tt> and <tt>allowed?</tt>
+        #
+        #   Examples:
+        # 
+        #     before_filter :login_frontend_required, :except => [:login]
+        # 
+        def fronted_login_required
+          logged_in?  && allowed? || access_denied(:backend)
+        end
+
+        def access_denied(where)#:nodoc:
+          respond_to do |format|
+            format.html { redirect_to :controller => "#{where}/sessions", :action => :new }
+            format.js { render(:update) { |page| page.alert "You don't allowed to access to this javascript" } }
+          end
+          false
+        end  
+
+        def store_location#:nodoc:
+          session[:return_to] = request.request_uri
+        end
+        
+        # Redirect the account to the page that requested an authentication or
+        # if the account is not allowed/logged return it to a default page
+        def redirect_back_or_default(default)
+          redirect_to(session[:return_to] || default)
+          session[:return_to] = nil
+        end
+
+        def self.included(base)#:nodoc:
+          base.send :helper_method, :current_account, :logged_in?
+        end
+
+        def login_from_session#:nodoc:
+          self.current_account = Account.find_by_id(session[:account]) if session[:account]
+        end
+    end # Module Authentication
+  end # Module AccessControl
+end # Module Backend

data/lib/access_control/base.rb

@@ -0,0 +1,227 @@
+module Lipsiadmin
+  module AccessControl
+    module Helper#:nodoc:
+      def recognize_path(path)#:nodoc:
+        case path
+          when String then ActionController::Routing::Routes.recognize_path(path, :method => :get)
+          when Hash   then path
+        end
+      end
+    end
+    
+    # This Class map and get roles/projects for accounts
+    # 
+    #   Examples:
+    #   
+    #     roles_for :administrator do |role|
+    #       role.allow_all_actions "/backend/base"
+    #       role.deny_action_of    "/backend/accounts/details"
+    #     
+    #       role.project_module :administration do |project|
+    #         project.menu :general_settings, "/backend/settings" do |submenu|
+    #           submenu.add :accounts, "/backend/accounts" do |submenu|
+    #             submenu.add :sub_accounts, "/backend/accounts/subaccounts"
+    #           end
+    #         end
+    #       end
+    #     end
+    # 
+    #   If a user logged with role administrator or that have a project_module administrator can:
+    #   
+    #   - Access in all actions of "/backend/base" controller
+    #   - Denied access to ONLY action <tt>"/backend/accounts/details"</tt>
+    #   - Access to a project module called Administration
+    #   - Access to all actions of the controller "/backend/settings"
+    #   - Access to all actions EXCEPT <tt>details</tt> of controller "/backend/accounts"
+    # 
+    class Base
+      
+      class << self
+        
+        # We map project modules for a given role or roles
+        def roles_for(*roles, &block)
+          roles.each { |role| raise AccessControlError, "Role #{role} must be a symbol!" unless role.is_a?(Symbol)  }
+          @mappers ||= []
+          @roles   ||= []
+          @roles.concat(roles)
+          @mappers << Mapper.new(*roles, &block)
+        end        
+        
+        # Returns all roles
+        def roles
+          @roles.collect(&:to_s)
+        end
+        
+        # Returns all project modules ids
+        def project_modules
+          @mappers.inject([]) do |pm, maps|
+            pm.concat(maps.project_modules.collect(&:uid))
+          end.uniq
+        end
+        
+        # Returns maps for a given role
+        def find_by_role(role)
+          role = case role
+            when String then role.downcase.to_sym
+            when Symbol then role
+          end
+          return @mappers.find_all { |m| m.roles.include?(role.to_sym) }
+        end
+      
+        # Returns maps for a given project modules uids
+        def find_by_project_modules(*uids)
+          uids.inject([]) do |maps, uid|
+            maps.concat @mappers.find_all { |m| m.project_modules.collect(&:uid).include?(uid.to_s) }
+          end
+        end
+      end
+      
+    end
+    
+    class Mapper
+      include Helper
+      attr_reader :project_modules, :roles
+      
+      def initialize(*roles, &block)#:nodoc:
+        @project_modules = []
+        @allowed         = []
+        @denied          = []
+        @roles           = roles
+        yield self
+      end
+      
+      # Create a new project module
+      def project_module(name, controller=nil, &block)
+        @project_modules << ProjectModule.new(name, controller, &block)
+      end
+      
+      # Globally allow an action of a controller for the current role
+      def allow_action(path)
+        @allowed << recognize_path(path)
+      end
+      
+      # Globally deny an action of a controllerfor the current role
+      def deny_action(path)
+        @denied << recognize_path(path)
+      end
+      
+      # Globally allow all actions from a controller for the current role
+      def allow_all_actions(path)
+        @allowed << { :controller => recognize_path(path)[:controller] }
+      end
+      
+      # Globally denty all actions from a controller for the current role
+      def deny_all_actions(path)
+        @denied << { :controller => recognize_path(path)[:controller] }
+      end
+      
+      # Return allowed actions/controllers
+      def allowed
+        @project_modules.each { |pm| @allowed.concat pm.allowed  }
+        return @allowed.uniq
+      end
+      
+      # Return denied actions/controllers
+      def denied
+        return @denied.uniq
+      end
+    end
+    
+    class ProjectModule
+      include Helper
+      include ActionController::UrlWriter
+      attr_reader :name, :menus, :url
+      
+      def initialize(name, path=nil, options={}, &block)#:nodoc:
+        @name = name
+        @options = options
+        @allowed = []
+        @menus   = []
+        if path
+          @url      = recognize_path(path)
+          @allowed << { :controller => @url[:controller] }
+        end
+        yield self
+      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  }
+        return @allowed.uniq
+      end
+      
+      # Return the original name or try to humanize the symbol
+      def human_name
+        return @name.is_a?(Symbol) ? @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(/^-+$/, '')
+      end
+      
+      # Return ExtJs Config for this project module
+      def config
+        options = @options.merge(:id => uid, :text => human_name)
+        options.merge!(:menu => @menus.collect(&:config)) if @menus.size > 0
+        options.merge!(:handler =>  ActiveSupport::JSON::Variable.new("function(){ Backend.app.load('#{url_for(@url.merge(:only_path => true))}') }")) if @url
+        return options
+      end
+    end
+    
+    class Menu
+      include Helper
+      include ActionController::UrlWriter
+      attr_reader :name, :options, :url, :items
+      
+      def initialize(name, path=nil, options={}, &block)#:nodoc:
+        @name    = name
+        @options = options
+        @allowed = []
+        @items   = []        
+        if path
+          @url     = recognize_path(path) 
+          @allowed << { :controller => @url[:controller] } if path
+        end
+        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
+      
+      # Return allowed controllers
+      def allowed
+        @items.each { |i| @allowed.concat i.allowed }
+        return @allowed.uniq
+      end
+      
+      # Return the original name or try to humanize the symbol
+      def human_name
+        return @name.is_a?(Symbol) ? @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(/^-+$/, '')
+      end
+      
+      # Return ExtJs Config for this menu
+      def config
+        options = @options.merge(:id => uid, :text => human_name)
+        options.merge!(:menu => @items.collect(&:config)) if @items.size > 0
+        options.merge!(:handler =>  ActiveSupport::JSON::Variable.new("function(){ Backend.app.load('#{url_for(@url.merge(:only_path => true))}') }")) if @url
+        return options
+      end
+    end
+    
+    class AccessControlError < StandardError#:nodoc:
+    end
+  end
+end