def addMember(self, id, password, roles=('Member',), domains='',
properties=None):
'''Creates a PortalMember and returns it. The properties argument
can be a mapping with additional member properties. Raises an
exception if the given id already exists, the password does not
comply with the policy in effect, or the authenticated user is not
allowed to grant one of the roles listed (where Member is a special
role that can always be granted); these conditions should be
detected before the fact so that a cleaner message can be printed.
'''
if not self.isMemberIdAllowed(id):
raise 'Bad Request', 'The login name you selected is already ' \
'in use or is not valid. Please choose another.'
failMessage = self.testPasswordValidity(password)
if failMessage is not None:
raise 'Bad Request', failMessage
failMessage = self.testPropertiesValidity(properties)
if failMessage is not None:
raise 'Bad Request', failMessage
# Limit the granted roles.
# Anyone is always allowed to grant the 'Member' role.
limitGrantedRoles(roles, self, ('Member',))
membership = getToolByName(self, 'portal_membership')
membership.addMember(id, password, roles, domains)
member = membership.getMemberById(id)
if properties is not None:
member.setMemberProperties(properties)
self.afterAdd(member, id, password, properties)
return member
def addMember(self, id, password, roles=('Member',), domains='',
properties=None):
'''Creates a PortalMember and returns it. The properties argument
can be a mapping with additional member properties. Raises an
exception if the given id already exists, the password does not
comply with the policy in effect, or the authenticated user is not
allowed to grant one of the roles listed (where Member is a special
role that can always be granted); these conditions should be
detected before the fact so that a cleaner message can be printed.
'''
if not self.isMemberIdAllowed(id):
raise ValueError('The login name you selected is already '
'in use or is not valid. Please choose another.')
failMessage = self.testPasswordValidity(password)
if failMessage is not None:
raise ValueError(failMessage)
if properties is not None:
failMessage = self.testPropertiesValidity(properties)
if failMessage is not None:
raise ValueError(failMessage)
# Limit the granted roles.
# Anyone is always allowed to grant the 'Member' role.
limitGrantedRoles(roles, self, ('Member',))
membership = getToolByName(self, 'portal_membership')
membership.addMember(id, password, roles, domains, properties)
member = membership.getMemberById(id)
self.afterAdd(member, id, password, properties)
return member
