1
# IVLE - Informatics Virtual Learning Environment
2
# Copyright (C) 2007-2009 The University of Melbourne
4
# This program is free software; you can redistribute it and/or modify
5
# it under the terms of the GNU General Public License as published by
6
# the Free Software Foundation; either version 2 of the License, or
7
# (at your option) any later version.
9
# This program is distributed in the hope that it will be useful,
10
# but WITHOUT ANY WARRANTY; without even the implied warranty of
11
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12
# GNU General Public License for more details.
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
16
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
18
# Author: Matt Giuca, Will Grant
21
import formencode.validators
22
from genshi.filters import HTMLFormFiller
24
from ivle.webapp.base.rest import JSONRESTView, require_permission
25
from ivle.webapp.base.xhtml import XHTMLView
26
from ivle.webapp.base.plugins import ViewPlugin, MediaPlugin
27
from ivle.webapp.admin.publishing import root_to_user, user_url
32
# List of fields returned as part of the user JSON dictionary
33
# (as returned by the get_user action)
35
"login", "state", "unixid", "email", "nick", "fullname",
36
"admin", "studentid", "acct_exp", "pass_exp", "last_login",
40
class UserRESTView(JSONRESTView):
42
A REST interface to the user object.
45
@require_permission('view')
48
user = ivle.util.object_to_dict(user_fields_list, self.context)
49
# Convert time stamps to nice strings
50
for k in 'pass_exp', 'acct_exp', 'last_login':
51
if user[k] is not None:
52
user[k] = unicode(user[k])
54
user['local_password'] = self.context.passhash is not None
57
class UserEditSchema(formencode.Schema):
58
nick = formencode.validators.UnicodeString(not_empty=True)
59
email = formencode.validators.Email(not_empty=False,
62
class UserEditView(XHTMLView):
63
"""A form to change a user's details."""
64
template = 'templates/user-edit.html'
68
def filter(self, stream, ctx):
69
return stream | HTMLFormFiller(data=ctx['data'])
71
def populate(self, req, ctx):
72
if req.method == 'POST':
73
data = dict(req.get_fieldstorage())
75
validator = UserEditSchema()
76
data = validator.to_python(data, state=req)
77
self.context.nick = data['nick']
78
self.context.email = unicode(data['email']) if data['email'] \
81
req.throw_redirect(req.uri)
82
except formencode.Invalid, e:
83
errors = e.unpack_errors()
85
data = {'nick': self.context.nick,
86
'email': self.context.email
90
ctx['format_datetime'] = ivle.date.make_date_nice
91
ctx['format_datetime_short'] = ivle.date.format_datetime_for_paragraph
94
ctx['user'] = self.context
96
ctx['errors'] = errors
98
class UserAdminSchema(formencode.Schema):
99
admin = formencode.validators.StringBoolean(if_missing=False)
100
fullname = formencode.validators.UnicodeString(not_empty=True)
101
studentid = formencode.validators.UnicodeString(not_empty=False,
105
class UserAdminView(XHTMLView):
106
"""A form for admins to change more of a user's details."""
107
template = 'templates/user-admin.html'
110
def authorize(self, req):
111
"""Only allow access if the requesting user is an admin."""
112
return req.user.admin
114
def filter(self, stream, ctx):
115
return stream | HTMLFormFiller(data=ctx['data'])
117
def populate(self, req, ctx):
118
if req.method == 'POST':
119
data = dict(req.get_fieldstorage())
121
validator = UserAdminSchema()
122
data = validator.to_python(data, state=req)
124
self.context.admin = data['admin']
125
self.context.fullname = data['fullname'] \
126
if data['fullname'] else None
127
self.context.studentid = data['studentid'] \
128
if data['studentid'] else None
130
req.throw_redirect(req.uri)
131
except formencode.Invalid, e:
132
errors = e.unpack_errors()
134
data = {'admin': self.context.admin,
135
'fullname': self.context.fullname,
136
'studentid': self.context.studentid,
141
ctx['user'] = self.context
143
ctx['errors'] = errors
145
class PasswordChangeView(XHTMLView):
146
"""A form to change a user's password, with knowledge of the old one."""
147
template = 'templates/user-password-change.html'
151
def authorize(self, req):
152
"""Only allow access if the requesting user holds the permission,
153
and the target user has a password set. Otherwise we might be
154
clobbering external authn.
156
return super(PasswordChangeView, self).authorize(req) and \
157
self.context.passhash is not None
159
def populate(self, req, ctx):
161
if req.method == 'POST':
162
data = dict(req.get_fieldstorage())
163
if data.get('old_password') is None or \
164
not self.context.authenticate(data.get('old_password')):
165
error = 'Incorrect password.'
166
elif data.get('new_password') != data.get('new_password_again'):
167
error = 'New passwords do not match.'
168
elif not data.get('new_password'):
169
error = 'New password cannot be empty.'
171
self.context.password = data['new_password']
173
req.throw_redirect(req.uri)
176
ctx['user'] = self.context
179
class PasswordResetView(XHTMLView):
180
"""A form to reset a user's password, without knowledge of the old one."""
181
template = 'templates/user-password-reset.html'
184
def authorize(self, req):
185
"""Only allow access if the requesting user is an admin."""
186
return req.user.admin
188
def populate(self, req, ctx):
190
if req.method == 'POST':
191
data = dict(req.get_fieldstorage())
192
if data.get('new_password') != data.get('new_password_again'):
193
error = 'New passwords do not match.'
194
elif not data.get('new_password'):
195
error = 'New password cannot be empty.'
197
self.context.password = data['new_password']
199
req.throw_redirect(req.uri)
201
ctx['user'] = self.context
204
class Plugin(ViewPlugin, MediaPlugin):
206
The Plugin class for the user plugin.
209
forward_routes = (root_to_user,)
210
reverse_routes = (user_url,)
211
views = [(ivle.database.User, '+edit', UserEditView),
212
(ivle.database.User, '+admin', UserAdminView),
213
(ivle.database.User, '+changepassword', PasswordChangeView),
214
(ivle.database.User, '+resetpassword', PasswordResetView),
215
(ivle.database.User, '+index', UserRESTView, 'api'),
218
public_forward_routes = forward_routes
219
public_reverse_routes = reverse_routes