the_role 2.0.2 → 2.0.3

data/README.md

@@ -106,6 +106,16 @@ def self.up
 end
 ```
 
+### Change User model
+
+```ruby
+class User < ActiveRecord::Base
+  include TheRoleUserModel
+
+  # has_many :pages
+end
+```
+
 ### Create Role model
 
 Generate Role model
@@ -154,14 +164,14 @@ class ApplicationController < ActionController::Base
 
   # your Access Denied processor
   def access_denied
-    return render(text: 'access_denied: requires an role')
+    return render(text: 'access_denied: requires a role')
   end
 
   # 1) LOGIN_REQUIRE => authenticate_user!    for Devise
   # 2) LOGIN_REQUIRE => require_login         for Sorcery
   # 3) LOGIN_REQUIRE => user_require_method   for other Authentication solution
 
-  # Define aliases method for correctly work TheRole's controllers
+  # Define method aliases for the correct TheRole's controller work
   alias_method :login_required,     :LOGIN_REQUIRE
   alias_method :role_access_denied, :access_denied
 end
@@ -177,6 +187,10 @@ class PagesController < ApplicationController
   before_action :set_page,       only: [:edit, :update, :destroy]
   before_action :owner_required, only: [:edit, :update, :destroy]
 
+  def edit
+     # ONLY OWNER CAN EDIT THIS PAGE
+  end
+
   private
 
   def set_page
@@ -184,7 +198,7 @@ class PagesController < ApplicationController
 
     # TheRole: You should define OWNER CHECK OBJECT
     # When editable object was found
-    # You should to define @owner_check_object before invoke of **owner_required** method
+    # You should define @owner_check_object before invoking **owner_required** method
     @owner_check_object = @page
   end
 end
@@ -199,7 +213,7 @@ end
 //= require the_role
 ```
 
-If you not use **bootstrap-sass** gem you should to add following componetns from your bootstrap version instead **the_role/bootstrap_sass**:
+If you don't use **bootstrap-sass** gem you should add the following componetns from your bootstrap version instead **the_role/bootstrap_sass**:
 
 ```
 bootstrap/variables
@@ -236,17 +250,17 @@ end
 
 ## Understanding
 
-#### TheRole instead CanCan?
+#### TheRole instead of CanCan?
 
-TheRole in contrast to CanCan has simple and predefined way to find access state for current role. If you didn't want to create your own role scheme with CanCan Abilities - TheRole can be great solution for your.
+TheRole in contrast to CanCan has simple and predefined way to find access state of current role. If you don't want to create your own role scheme with CanCan Abilities - TheRole can be a great solution for your.
 
-You can manage roles with simple UI. TheRole's ACL structure inspired by Rails controllers, that is why it's so great for Rails application.
+You can manage roles with simple UI. TheRole's ACL structure is inspired by Rails controllers, that is why it's so great for Rails application.
 
 #### What does it mean semantic?
 
-Semantic - the science of meaning. Human should fast to understand what is happening in a role system.
+Semantic - the science of meaning. Human should be able to understand fast what is happening in a role system.
 
-Look at next Role hash. If you can understand access rules - this authorization system is semantically.
+Look at the next Role hash. If you can understand access rules - this authorization system is semantic.
 
 ```ruby
 role = {
@@ -298,11 +312,11 @@ And you can use them as well as other access rules.
 
 #### Who is Administrator?
 
-Administrator it's a user who can access any section and the rules of your application.
+Administrator is the user who can access any section and the rules of your application.
 
 Administrator is the owner of any objects in your application.
 
-Administrator it's a user, which has virtual section **system** and rule **administrator** in the role-hash.
+Administrator is the user, which has virtual section **system** and rule **administrator** in the role-hash.
 
 
 ```ruby
@@ -315,11 +329,11 @@ admin_role_fragment = {
 
 #### Who is Moderator?
 
-Moderator it's a user, which has access to any actions of some section(s).
+Moderator is the user, which has access to any actions of some section(s).
 
-Moderator is's owner of any objects of some class.
+Moderator is the owner of any objects of some class.
 
-Moderator it's a user, which has a virtual section **moderator**, with **section name** as rule name.
+Moderator is the user, which has a virtual section **moderator**, with **section name** as rule name.
 
 There is Moderator of Pages (controller) and Twitter (virtual section)
 
@@ -365,7 +379,7 @@ Is it Moderator?
 @user.moderator?(:articles)        => true | false
 ```
 
-Has a user an access to **rule** of **section** (action of controller)?
+Has user got an access to **rule** of **section** (action of controller)?
 
 ```ruby
 @user.has_role?(:pages,    :show)  => true | false
@@ -373,7 +387,7 @@ Has a user an access to **rule** of **section** (action of controller)?
 @user.has_role?(:articles, :edit)  => true | false
 ```
 
-Is it **Owner** of object?
+Is user **Owner** of object?
 
 ```ruby
 @user.owner?(@page)                => true | false
@@ -421,19 +435,19 @@ Is it **Owner** of object?
 #### UPDATE
 
 ```ruby
-# set this rule on true
+# set this rule on
 @role.rule_on(:pages, :index)
 ```
 
 ```ruby
-# set this rule on false
+# set this rule off
 @role.rule_off(:pages, :index)
 ```
 
 ```ruby
 # Incoming hash is true-mask-hash
-# All rules of Role will be reset to false
-# Only rules from true-mask-hash will be set on true
+# All the rules of the Role will be reseted to false
+# Only rules from true-mask-hash will be set true
 new_role_hash = {
   :pages => {
     :index => true,
@@ -450,12 +464,13 @@ new_role_hash = {
 # delete a section
 @role.delete_section(:pages)
 
-# delete rule in section
+# delete a rule in section
 @role.delete_rule(:pages, :show)
 ```
 
 #### Changelog
 
+* 2.0.3 - create role fix, cleanup
 * 2.0.2 - code cleanup, readme
 * 2.0.1 - code cleanup
 * 2.0.0 - Rails 4 ready, configurable, tests

data/app/controllers/admin/roles_controller.rb

@@ -19,7 +19,7 @@ class Admin::RolesController < ApplicationController
   def edit; end
 
   def create
-    @role = Role.new params[:role]
+    @role = Role.new role_params
 
     if @role.save
       flash[:notice] = t 'the_role.role_created'
@@ -46,6 +46,10 @@ class Admin::RolesController < ApplicationController
 
   protected
 
+  def role_params
+    params.require(:role).permit(:name, :title, :description)
+  end
+
   def role_find
     @role = Role.find params[:id]
 

data/lib/the_role/version.rb

@@ -1,3 +1,3 @@
 module TheRole
-  VERSION = "2.0.2"
+  VERSION = "2.0.3"
 end

data/lib/the_role.rb

@@ -7,16 +7,11 @@ require 'the_role/param_helper'
 
 module TheRole
   class Engine < Rails::Engine
-    initializer "TheRole precompile hook", :group => :all do |app|
-      app.config.assets.precompile += %w( admin_the_role.js admin_the_role.css )
-    end
+    # initializer "TheRole precompile hook", group: :all do |app|
+    #   app.config.assets.precompile += %w( x.js y.css )
+    # end
 
     # http://stackoverflow.com/questions/6279325/adding-to-rails-autoload-path-from-gem
-
-    # config.to_prepare do
-    #   Role.send :include, TheRole::RoleModel if the_class_exists? :Role
-    #   User.send :include, TheRole::UserModel if the_class_exists? :User
-    #   ApplicationController.send :include, TheRole::Requires if the_class_exists? :ApplicationController
-    # end
+    # config.to_prepare do; end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: the_role
 version: !ruby/object:Gem::Version
-  version: 2.0.2
+  version: 2.0.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-27 00:00:00.000000000 Z
+date: 2013-06-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: haml
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &76998310 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,12 +21,7 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *76998310
 description: Authorization for Rails 4 with Web Interface
 email:
 - zykin-ilya@ya.ru
@@ -94,7 +89,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: the_role
-rubygems_version: 1.8.25
+rubygems_version: 1.8.15
 signing_key: 
 specification_version: 3
 summary: Authorization for Rails 4