jro_apps/redmine Commit - r13916:836ac7f53722

1

# Redmine - project management software

1

# Redmine - project management software

2

3

#

3

#

4

# This program is free software; you can redistribute it and/or

4

# This program is free software; you can redistribute it and/or

5

# modify it under the terms of the GNU General Public License

5

# modify it under the terms of the GNU General Public License

6

# as published by the Free Software Foundation; either version 2

6

# as published by the Free Software Foundation; either version 2

7

# of the License, or (at your option) any later version.

7

# of the License, or (at your option) any later version.

8

#

8

#

9

# This program is distributed in the hope that it will be useful,

9

# This program is distributed in the hope that it will be useful,

10

# but WITHOUT ANY WARRANTY; without even the implied warranty of

10

# but WITHOUT ANY WARRANTY; without even the implied warranty of

11

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

11

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

12

# GNU General Public License for more details.

12

# GNU General Public License for more details.

13

#

13

#

14

# You should have received a copy of the GNU General Public License

14

# You should have received a copy of the GNU General Public License

15

# along with this program; if not, write to the Free Software

15

# along with this program; if not, write to the Free Software

16

# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

16

# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

17

18

class Member < ActiveRecord::Base

18

class Member < ActiveRecord::Base

19

belongs_to :user

19

belongs_to :user

20

belongs_to :principal, :foreign_key => 'user_id'

20

belongs_to :principal, :foreign_key => 'user_id'

21

has_many :member_roles, :dependent => :destroy

21

has_many :member_roles, :dependent => :destroy

22

has_many :roles, lambda {uniq}, :through => :member_roles

22

has_many :roles, lambda {uniq}, :through => :member_roles

23

belongs_to :project

23

belongs_to :project

24

25

validates_presence_of :principal, :project

25

validates_presence_of :principal, :project

26

validates_uniqueness_of :user_id, :scope => :project_id

26

validates_uniqueness_of :user_id, :scope => :project_id

27

validate :validate_role

27

validate :validate_role

28

attr_protected :id

28

attr_protected :id

29

30

before_destroy :set_issue_category_nil

30

before_destroy :set_issue_category_nil

31

32

alias :base_reload :reload

32

alias :base_reload :reload

33

def reload(*args)

33

def reload(*args)

34

@managed_roles = nil

34

@managed_roles = nil

35

base_reload(*args)

35

base_reload(*args)

36

end

36

end

37

38

def role

38

def role

39

end

39

end

40

41

def role=

41

def role=

42

end

42

end

43

44

def name

44

def name

45

self.user.name

45

self.user.name

46

end

46

end

47

48

alias :base_role_ids= :role_ids=

48

alias :base_role_ids= :role_ids=

49

def role_ids=(arg)

49

def role_ids=(arg)

50

ids = (arg || []).collect(&:to_i) - [0]

50

ids = (arg || []).collect(&:to_i) - [0]

51

# Keep inherited roles

51

# Keep inherited roles

52

ids += member_roles.select {|mr| !mr.inherited_from.nil?}.collect(&:role_id)

52

ids += member_roles.select {|mr| !mr.inherited_from.nil?}.collect(&:role_id)

53

54

new_role_ids = ids - role_ids

54

new_role_ids = ids - role_ids

55

# Add new roles

55

# Add new roles

56

new_role_ids.each {|id| member_roles << MemberRole.new(:role_id => id, :member => self) }

56

new_role_ids.each {|id| member_roles << MemberRole.new(:role_id => id, :member => self) }

57

# Remove roles (Rails' #role_ids= will not trigger MemberRole#on_destroy)

57

# Remove roles (Rails' #role_ids= will not trigger MemberRole#on_destroy)

58

member_roles_to_destroy = member_roles.select {|mr| !ids.include?(mr.role_id)}

58

member_roles_to_destroy = member_roles.select {|mr| !ids.include?(mr.role_id)}

59

if member_roles_to_destroy.any?

59

if member_roles_to_destroy.any?

60

member_roles_to_destroy.each(&:destroy)

60

member_roles_to_destroy.each(&:destroy)

61

end

61

end

62

end

62

end

63

64

def <=>(member)

64

def <=>(member)

65

a, b = roles.sort.first, member.roles.sort.first

65

a, b = roles.sort.first, member.roles.sort.first

66

if a == b

66

if a == b

67

if principal

67

if principal

68

principal <=> member.principal

68

principal <=> member.principal

69

else

69

else

70

1

70

1

71

end

71

end

72

elsif a

72

elsif a

73

a <=> b

73

a <=> b

74

else

74

else

75

1

75

1

76

end

76

end

77

end

77

end

78

79

# Set member role ids ignoring any change to roles that

79

# Set member role ids ignoring any change to roles that

80

# user is not allowed to manage

80

# user is not allowed to manage

81

def set_editable_role_ids(ids, user=User.current)

81

def set_editable_role_ids(ids, user=User.current)

82

ids = (ids || []).collect(&:to_i) - [0]

82

ids = (ids || []).collect(&:to_i) - [0]

83

editable_role_ids = user.managed_roles(project).map(&:id)

83

editable_role_ids = user.managed_roles(project).map(&:id)

84

untouched_role_ids = self.role_ids - editable_role_ids

84

untouched_role_ids = self.role_ids - editable_role_ids

85

touched_role_ids = ids & editable_role_ids

85

touched_role_ids = ids & editable_role_ids

86

self.role_ids = untouched_role_ids + touched_role_ids

86

self.role_ids = untouched_role_ids + touched_role_ids

87

end

87

end

88

89

# Returns true if one of the member roles is inherited

89

# Returns true if one of the member roles is inherited

90

def any_inherited_role?

90

def any_inherited_role?

91

member_roles.any? {|mr| mr.inherited_from}

91

member_roles.any? {|mr| mr.inherited_from}

92

end

92

end

93

94

# Returns true if the member has the role and if it's inherited

94

# Returns true if the member has the role and if it's inherited

95

def has_inherited_role?(role)

95

def has_inherited_role?(role)

96

member_roles.any? {|mr| mr.role_id == role.id && mr.inherited_from.present?}

96

member_roles.any? {|mr| mr.role_id == role.id && mr.inherited_from.present?}

97

end

97

end

98

99

# Returns true if the member's role is editable by user

99

# Returns true if the member's role is editable by user

100

def role_editable?(role, user=User.current)

100

def role_editable?(role, user=User.current)

101

if has_inherited_role?(role)

101

if has_inherited_role?(role)

102

false

102

false

103

else

103

else

104

user.managed_roles(project).include?(role)

104

user.managed_roles(project).include?(role)

105

end

105

end

106

end

106

end

107

108

# Returns true if the member is deletable by user

108

# Returns true if the member is deletable by user

109

def deletable?(user=User.current)

109

def deletable?(user=User.current)

110

if any_inherited_role?

110

if any_inherited_role?

111

false

111

false

112

else

112

else

113

roles & user.managed_roles(project) == roles

113

roles & user.managed_roles(project) == roles

114

end

114

end

115

end

115

end

116

117

# Destroys the member

117

# Destroys the member

118

def destroy

118

def destroy

119

member_roles.reload.each(&:destroy_without_member_removal)

119

member_roles.reload.each(&:destroy_without_member_removal)

120

super

120

super

121

end

121

end

122

123

# Returns true if the member is user or is a group

123

# Returns true if the member is user or is a group

124

# that includes user

124

# that includes user

125

def include?(user)

125

def include?(user)

126

if principal.is_a?(Group)

126

if principal.is_a?(Group)

127

!user.nil? && user.groups.include?(principal)

127

!user.nil? && user.groups.include?(principal)

128

else

128

else

129

self.user == user

129

self.user == user

130

end

130

end

131

end

131

end

132

133

def set_issue_category_nil

133

def set_issue_category_nil

134

if user_id && project_id

134

if user_id && project_id

135

# remove category based auto assignments for this member

135

# remove category based auto assignments for this member

136

IssueCategory.where(["project_id = ? AND assigned_to_id = ?", project_id, user_id]).

136

IssueCategory.where(["project_id = ? AND assigned_to_id = ?", project_id, user_id]).

137

update_all("assigned_to_id = NULL")

137

update_all("assigned_to_id = NULL")

138

end

138

end

139

end

139

end

140

141

# Returns the roles that the member is allowed to manage

141

# Returns the roles that the member is allowed to manage

142

# in the project the member belongs to

142

# in the project the member belongs to

143

def managed_roles

143

def managed_roles

144

@managed_roles ||= begin

144

@managed_roles ||= begin

145

if principal.try(:admin?)

145

if principal.try(:admin?)

146

Role.givable.to_a

146

Role.givable.to_a

147

else

147

else

148

members_management_roles = roles.select do |role|

148

members_management_roles = roles.select do |role|

149

role.has_permission?(:manage_members)

149

role.has_permission?(:manage_members)

150

end

150

end

151

if members_management_roles.empty?

151

if members_management_roles.empty?

152

[]

152

[]

153

elsif members_management_roles.any?(&:all_roles_managed?)

153

elsif members_management_roles.any?(&:all_roles_managed?)

154

Role.givable.to_a

154

Role.givable.to_a

155

else

155

else

156

members_management_roles.map(&:managed_roles).reduce(&:|)

156

members_management_roles.map(&:managed_roles).reduce(&:|)

157

end

157

end

158

end

158

end

159

end

159

end

160

end

160

end

161

162

# Creates memberships for principal with the attributes

162

# Creates memberships for principal with the attributes

163

# * project_ids : one or more project ids

163

# * project_ids : one or more project ids

164

# * role_ids : ids of the roles to give to each membership

164

# * role_ids : ids of the roles to give to each membership

165

#

165

#

166

# Example:

166

# Example:

167

# Member.create_principal_memberships(user, :project_ids => [2, 5], :role_ids => [1, 3]

167

# Member.create_principal_memberships(user, :project_ids => [2, 5], :role_ids => [1, 3]

168

def self.create_principal_memberships(principal, attributes)

168

def self.create_principal_memberships(principal, attributes)

169

members = []

169

members = []

170

if attributes

170

if attributes

171

project_ids = Array.wrap(attributes[:project_ids] || attributes[:project_id])

171

project_ids = Array.wrap(attributes[:project_ids] || attributes[:project_id])

172

role_ids = attributes[:role_ids]

172

role_ids = attributes[:role_ids]

173

project_ids.each do |project_id|

173

project_ids.each do |project_id|

174

members << Member.new(:principal => principal, :role_ids => role_ids, :project_id => project_id)

174

members << Member.new(:principal => principal, :role_ids => role_ids, :project_id => project_id)

175

end

175

end

176

principal.members << members

176

principal.members << members

177

end

177

end

178

members

178

members

179

end

179

end

180

181

# Finds or initilizes a Member for the given project and principal

181

# Finds or initilizes a Member for the given project and principal

182

def self.find_or_new(project, principal)

182

def self.find_or_new(project, principal)

183

project_id = project.is_a?(Project) ? project.id : project

183

project_id = project.is_a?(Project) ? project.id : project

184

principal_id = principal.is_a?(Principal) ? principal.id : principal

184

principal_id = principal.is_a?(Principal) ? principal.id : principal

185

186

member = Member.find_by_project_id_and_user_id(project_id, principal_id)

186

member = Member.find_by_project_id_and_user_id(project_id, principal_id)

187

member ||= Member.new(:project_id => project_id, :user_id => principal_id)

187

member ||= Member.new(:project_id => project_id, :user_id => principal_id)

188

member

188

member

189

end

189

end

190

191

protected

191

protected

192

193

def validate_role

193

def validate_role

194

errors.add_on_empty :role if member_roles.empty? && roles.empty?

194

errors.add_on_empty :role if member_roles.empty? && roles.empty?

195

end

195

end

196

end

196

end

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

             # Redmine - project management software
             # Copyright (C) 2006-2015  Jean-Philippe Lang
             #
             # This program is free software; you can redistribute it and/or
             # modify it under the terms of the GNU General Public License
             # as published by the Free Software Foundation; either version 2
             # of the License, or (at your option) any later version.
             #
             # This program is distributed in the hope that it will be useful,
             # but WITHOUT ANY WARRANTY; without even the implied warranty of
             # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
             # GNU General Public License for more details.
             #
             # You should have received a copy of the GNU General Public License
             # along with this program; if not, write to the Free Software
             # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
             class Member < ActiveRecord::Base
               belongs_to :user
               belongs_to :principal, :foreign_key => 'user_id'
               has_many :member_roles, :dependent => :destroy
               has_many :roles, lambda {uniq}, :through => :member_roles
               belongs_to :project
               validates_presence_of :principal, :project
               validates_uniqueness_of :user_id, :scope => :project_id
               validate :validate_role
               attr_protected :id
               before_destroy :set_issue_category_nil
               alias :base_reload :reload
               def reload(*args)
                 @managed_roles = nil
                 base_reload(*args)
               end
               def role
               end
               def role=
               end
               def name
                 self.user.name
               end
               alias :base_role_ids= :role_ids=
               def role_ids=(arg)
                 ids = (arg || []).collect(&:to_i) - [0]
                 # Keep inherited roles
                 ids += member_roles.select {|mr| !mr.inherited_from.nil?}.collect(&:role_id)
                 new_role_ids = ids - role_ids
                 # Add new roles
                 new_role_ids.each {|id| member_roles << MemberRole.new(:role_id => id, :member => self) }
                 # Remove roles (Rails' #role_ids= will not trigger MemberRole#on_destroy)
                 member_roles_to_destroy = member_roles.select {|mr| !ids.include?(mr.role_id)}
                 if member_roles_to_destroy.any?
                   member_roles_to_destroy.each(&:destroy)
                 end
               end
               def <=>(member)
                 a, b = roles.sort.first, member.roles.sort.first
                 if a == b
                   if principal
                     principal <=> member.principal
                   else
                   end
                 elsif a
                   a <=> b
                 else
                 end
               end
-            	# Set member role ids ignoring any change to roles that
+              # Set member role ids ignoring any change to roles that
-            	# user is not allowed to manage
+              # user is not allowed to manage
               def set_editable_role_ids(ids, user=User.current)
                 ids = (ids || []).collect(&:to_i) - [0]
                 editable_role_ids = user.managed_roles(project).map(&:id)
                 untouched_role_ids = self.role_ids - editable_role_ids
                 touched_role_ids = ids & editable_role_ids
                 self.role_ids = untouched_role_ids + touched_role_ids
               end
-            	# Returns true if one of the member roles is inherited
+              # Returns true if one of the member roles is inherited
               def any_inherited_role?
                 member_roles.any? {|mr| mr.inherited_from}
               end
-            	# Returns true if the member has the role and if it's inherited
+              # Returns true if the member has the role and if it's inherited
               def has_inherited_role?(role)
                 member_roles.any? {|mr| mr.role_id == role.id && mr.inherited_from.present?}
               end
-            	# Returns true if the member's role is editable by user
+              # Returns true if the member's role is editable by user
               def role_editable?(role, user=User.current)
                 if has_inherited_role?(role)
                   false
                 else
                   user.managed_roles(project).include?(role)
                 end
               end
-            	# Returns true if the member is deletable by user
+              # Returns true if the member is deletable by user
               def deletable?(user=User.current)
                 if any_inherited_role?
                   false
                 else
                   roles & user.managed_roles(project) == roles
                 end
               end
-            	# Destroys the member
+              # Destroys the member
               def destroy
                 member_roles.reload.each(&:destroy_without_member_removal)
                 super
               end
-            	# Returns true if the member is user or is a group
+              # Returns true if the member is user or is a group
-            	# that includes user
+              # that includes user
               def include?(user)
                 if principal.is_a?(Group)
                   !user.nil? && user.groups.include?(principal)
                 else
                   self.user == user
                 end
               end
               def set_issue_category_nil
                 if user_id && project_id
                   # remove category based auto assignments for this member
                   IssueCategory.where(["project_id = ? AND assigned_to_id = ?", project_id, user_id]).
                     update_all("assigned_to_id = NULL")
                 end
               end
               # Returns the roles that the member is allowed to manage
               # in the project the member belongs to
               def managed_roles
                 @managed_roles ||= begin
                   if principal.try(:admin?)
                     Role.givable.to_a
                   else
                     members_management_roles = roles.select do |role|
                       role.has_permission?(:manage_members)
                     end
                     if members_management_roles.empty?
                       []
                     elsif members_management_roles.any?(&:all_roles_managed?)
                       Role.givable.to_a
                     else
                       members_management_roles.map(&:managed_roles).reduce(&:|)
                     end
                   end
                 end
               end
               # Creates memberships for principal with the attributes
               # * project_ids : one or more project ids
               # * role_ids : ids of the roles to give to each membership
               #
               # Example:
               #   Member.create_principal_memberships(user, :project_ids => [2, 5], :role_ids => [1, 3]
               def self.create_principal_memberships(principal, attributes)
                 members = []
                 if attributes
                   project_ids = Array.wrap(attributes[:project_ids] || attributes[:project_id])
                   role_ids = attributes[:role_ids]
                   project_ids.each do |project_id|
                     members << Member.new(:principal => principal, :role_ids => role_ids, :project_id => project_id)
                   end
                   principal.members << members
                 end
                 members
               end
               # Finds or initilizes a Member for the given project and principal
               def self.find_or_new(project, principal)
                 project_id = project.is_a?(Project) ? project.id : project
                 principal_id = principal.is_a?(Principal) ? principal.id : principal
                 member = Member.find_by_project_id_and_user_id(project_id, principal_id)
                 member ||= Member.new(:project_id => project_id, :user_id => principal_id)
                 member
               end
               protected
               def validate_role
                 errors.add_on_empty :role if member_roles.empty? && roles.empty?
               end
             end