source: main/waeup.kofa/trunk/src/waeup/kofa/students/browser.py @ 8258

Last change on this file since 8258 was 8258, checked in by Henrik Bettermann, 12 years ago

Ease customization.

  • Property svn:keywords set to Id
File size: 71.8 KB
Line 
1## $Id: browser.py 8258 2012-04-23 13:33:07Z henrik $
2##
3## Copyright (C) 2011 Uli Fouquet & Henrik Bettermann
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.
8##
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.
13##
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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17##
18"""UI components for students and related components.
19"""
20import sys
21import grok
22from urllib import urlencode
23from time import time
24from datetime import datetime
25from copy import deepcopy
26from zope.event import notify
27from zope.i18n import translate
28from zope.catalog.interfaces import ICatalog
29from zope.component import queryUtility, getUtility, createObject
30from zope.schema.interfaces import ConstraintNotSatisfied
31from zope.formlib.textwidgets import BytesDisplayWidget
32from hurry.workflow.interfaces import IWorkflowInfo, IWorkflowState
33from waeup.kofa.accesscodes import (
34    invalidate_accesscode, get_access_code, create_accesscode)
35from waeup.kofa.accesscodes.workflow import USED
36from waeup.kofa.browser import (
37    KofaPage, KofaEditFormPage, KofaAddFormPage, KofaDisplayFormPage,
38    ContactAdminForm, KofaForm, NullValidator)
39from waeup.kofa.browser.interfaces import ICaptchaManager
40from waeup.kofa.browser.breadcrumbs import Breadcrumb
41from waeup.kofa.browser.resources import datepicker, datatable, tabs, warning
42from waeup.kofa.browser.layout import jsaction, action, UtilityView
43from waeup.kofa.interfaces import (
44    IKofaObject, IUserAccount, IExtFileStore, IPasswordValidator, IContactForm,
45    IKofaUtils, IUniversity)
46from waeup.kofa.interfaces import MessageFactory as _
47from waeup.kofa.widgets.datewidget import (
48    FriendlyDateWidget, FriendlyDateDisplayWidget,
49    FriendlyDatetimeDisplayWidget)
50from waeup.kofa.widgets.restwidget import ReSTDisplayWidget
51from waeup.kofa.students.interfaces import (
52    IStudentsContainer, IStudent,
53    IUGStudentClearance,IPGStudentClearance,
54    IStudentPersonal, IStudentBase, IStudentStudyCourse,
55    IStudentAccommodation, IStudentStudyLevel,
56    ICourseTicket, ICourseTicketAdd, IStudentPaymentsContainer,
57    IStudentOnlinePayment, IBedTicket, IStudentsUtils, IStudentChangePassword
58    )
59from waeup.kofa.students.catalog import search
60from waeup.kofa.students.workflow import (ADMITTED, PAID,
61    CLEARANCE, REQUESTED, RETURNING, CLEARED, REGISTERED, VALIDATED)
62from waeup.kofa.students.studylevel import StudentStudyLevel, CourseTicket
63from waeup.kofa.students.vocabularies import StudyLevelSource
64from waeup.kofa.browser.resources import toggleall
65from waeup.kofa.hostels.hostel import NOT_OCCUPIED
66from waeup.kofa.utils.helpers import get_current_principal
67
68def write_log_message(view, message):
69    ob_class = view.__implemented__.__name__.replace('waeup.kofa.','')
70    view.context.getStudent().loggerInfo(ob_class, message)
71    return
72
73# Save function used for save methods in pages
74def msave(view, **data):
75    changed_fields = view.applyData(view.context, **data)
76    # Turn list of lists into single list
77    if changed_fields:
78        changed_fields = reduce(lambda x,y: x+y, changed_fields.values())
79    # Inform catalog if certificate has changed
80    # (applyData does this only for the context)
81    if 'certificate' in changed_fields:
82        notify(grok.ObjectModifiedEvent(view.context.getStudent()))
83    fields_string = ' + '.join(changed_fields)
84    view.flash(_('Form has been saved.'))
85    if fields_string:
86        write_log_message(view, 'saved: %s' % fields_string)
87    return
88
89def emit_lock_message(view):
90    """Flash a lock message.
91    """
92    view.flash(_('The requested form is locked (read-only).'))
93    view.redirect(view.url(view.context))
94    return
95
96class StudentsBreadcrumb(Breadcrumb):
97    """A breadcrumb for the students container.
98    """
99    grok.context(IStudentsContainer)
100    title = _('Students')
101
102    @property
103    def target(self):
104        user = get_current_principal()
105        if getattr(user, 'user_type', None) == 'student':
106            return None
107        return self.viewname
108
109class StudentBreadcrumb(Breadcrumb):
110    """A breadcrumb for the student container.
111    """
112    grok.context(IStudent)
113
114    def title(self):
115        return self.context.display_fullname
116
117class SudyCourseBreadcrumb(Breadcrumb):
118    """A breadcrumb for the student study course.
119    """
120    grok.context(IStudentStudyCourse)
121    title = _('Study Course')
122
123class PaymentsBreadcrumb(Breadcrumb):
124    """A breadcrumb for the student payments folder.
125    """
126    grok.context(IStudentPaymentsContainer)
127    title = _('Payments')
128
129class OnlinePaymentBreadcrumb(Breadcrumb):
130    """A breadcrumb for payments.
131    """
132    grok.context(IStudentOnlinePayment)
133
134    @property
135    def title(self):
136        return self.context.p_id
137
138class AccommodationBreadcrumb(Breadcrumb):
139    """A breadcrumb for the student accommodation folder.
140    """
141    grok.context(IStudentAccommodation)
142    title = _('Accommodation')
143
144class BedTicketBreadcrumb(Breadcrumb):
145    """A breadcrumb for bed tickets.
146    """
147    grok.context(IBedTicket)
148
149    @property
150    def title(self):
151        return _('Bed Ticket ${a}',
152            mapping = {'a':self.context.getSessionString()})
153
154class StudyLevelBreadcrumb(Breadcrumb):
155    """A breadcrumb for course lists.
156    """
157    grok.context(IStudentStudyLevel)
158
159    @property
160    def title(self):
161        return self.context.level_title
162
163class StudentsContainerPage(KofaPage):
164    """The standard view for student containers.
165    """
166    grok.context(IStudentsContainer)
167    grok.name('index')
168    grok.require('waeup.viewStudentsContainer')
169    grok.template('containerpage')
170    label = _('Student Section')
171    search_button = _('Search')
172    pnav = 4
173
174    def update(self, *args, **kw):
175        datatable.need()
176        form = self.request.form
177        self.hitlist = []
178        if 'searchterm' in form and form['searchterm']:
179            self.searchterm = form['searchterm']
180            self.searchtype = form['searchtype']
181        elif 'old_searchterm' in form:
182            self.searchterm = form['old_searchterm']
183            self.searchtype = form['old_searchtype']
184        else:
185            if 'search' in form:
186                self.flash(_('Empty search string'))
187            return
188        if self.searchtype == 'current_session':
189            try:
190                self.searchterm = int(self.searchterm)
191            except ValueError:
192                self.flash('Only year dates allowed (e.g. 2011).')
193                return
194        self.hitlist = search(query=self.searchterm,
195            searchtype=self.searchtype, view=self)
196        if not self.hitlist:
197            self.flash('No student found.')
198        return
199
200class StudentsContainerManagePage(KofaPage):
201    """The manage page for student containers.
202    """
203    grok.context(IStudentsContainer)
204    grok.name('manage')
205    grok.require('waeup.manageStudent')
206    grok.template('containermanagepage')
207    pnav = 4
208    label = _('Manage student section')
209    search_button = _('Search')
210    remove_button = _('Remove selected')
211
212    def update(self, *args, **kw):
213        datatable.need()
214        toggleall.need()
215        warning.need()
216        form = self.request.form
217        self.hitlist = []
218        if 'searchterm' in form and form['searchterm']:
219            self.searchterm = form['searchterm']
220            self.searchtype = form['searchtype']
221        elif 'old_searchterm' in form:
222            self.searchterm = form['old_searchterm']
223            self.searchtype = form['old_searchtype']
224        else:
225            if 'search' in form:
226                self.flash(_('Empty search string'))
227            return
228        if self.searchtype == 'current_session':
229            try:
230                self.searchterm = int(self.searchterm)
231            except ValueError:
232                self.flash('Only year dates allowed (e.g. 2011).')
233                return
234        if not 'entries' in form:
235            self.hitlist = search(query=self.searchterm,
236                searchtype=self.searchtype, view=self)
237            if not self.hitlist:
238                self.flash(_('No student found.'))
239            if 'remove' in form:
240                self.flash(_('No item selected.'))
241            return
242        entries = form['entries']
243        if isinstance(entries, basestring):
244            entries = [entries]
245        deleted = []
246        for entry in entries:
247            if 'remove' in form:
248                del self.context[entry]
249                deleted.append(entry)
250        self.hitlist = search(query=self.searchterm,
251            searchtype=self.searchtype, view=self)
252        if len(deleted):
253            self.flash(_('Successfully removed: ${a}',
254                mapping = {'a':', '.join(deleted)}))
255        return
256
257class StudentAddFormPage(KofaAddFormPage):
258    """Add-form to add a student.
259    """
260    grok.context(IStudentsContainer)
261    grok.require('waeup.manageStudent')
262    grok.name('addstudent')
263    form_fields = grok.AutoFields(IStudent).select(
264        'firstname', 'middlename', 'lastname', 'reg_number')
265    label = _('Add student')
266    pnav = 4
267
268    @action(_('Create student record'), style='primary')
269    def addStudent(self, **data):
270        student = createObject(u'waeup.Student')
271        self.applyData(student, **data)
272        self.context.addStudent(student)
273        self.flash(_('Student record created.'))
274        self.redirect(self.url(self.context[student.student_id], 'index'))
275        return
276
277class StudentBaseDisplayFormPage(KofaDisplayFormPage):
278    """ Page to display student base data
279    """
280    grok.context(IStudent)
281    grok.name('index')
282    grok.require('waeup.viewStudent')
283    grok.template('basepage')
284    form_fields = grok.AutoFields(IStudentBase).omit('password')
285    pnav = 4
286
287    @property
288    def label(self):
289        return _('${a}: Base Data',
290            mapping = {'a':self.context.display_fullname})
291
292    @property
293    def hasPassword(self):
294        if self.context.password:
295            return _('set')
296        return _('unset')
297
298class ContactStudentForm(ContactAdminForm):
299    grok.context(IStudent)
300    grok.name('contactstudent')
301    grok.require('waeup.viewStudent')
302    pnav = 4
303    form_fields = grok.AutoFields(IContactForm).select('subject', 'body')
304
305    def update(self, subject=u''):
306        self.form_fields.get('subject').field.default = subject
307        self.subject = subject
308        return
309
310    def label(self):
311        return _(u'Send message to ${a}',
312            mapping = {'a':self.context.display_fullname})
313
314    @action('Send message now', style='primary')
315    def send(self, *args, **data):
316        try:
317            email = self.request.principal.email
318        except AttributeError:
319            email = self.config.email_admin
320        usertype = getattr(self.request.principal,
321                           'user_type', 'system').title()
322        kofa_utils = getUtility(IKofaUtils)
323        success = kofa_utils.sendContactForm(
324                self.request.principal.title,email,
325                self.context.display_fullname,self.context.email,
326                self.request.principal.id,usertype,
327                self.config.name,
328                data['body'],data['subject'])
329        if success:
330            self.flash(_('Your message has been sent.'))
331        else:
332            self.flash(_('An smtp server error occurred.'))
333        return
334
335class StudentBaseManageFormPage(KofaEditFormPage):
336    """ View to manage student base data
337    """
338    grok.context(IStudent)
339    grok.name('manage_base')
340    grok.require('waeup.manageStudent')
341    form_fields = grok.AutoFields(IStudentBase).omit('student_id')
342    grok.template('basemanagepage')
343    label = _('Manage base data')
344    pnav = 4
345
346    def update(self):
347        datepicker.need() # Enable jQuery datepicker in date fields.
348        tabs.need()
349        self.tab1 = self.tab2 = ''
350        qs = self.request.get('QUERY_STRING', '')
351        if not qs:
352            qs = 'tab1'
353        setattr(self, qs, 'active')
354        super(StudentBaseManageFormPage, self).update()
355        self.wf_info = IWorkflowInfo(self.context)
356        return
357
358    def getTransitions(self):
359        """Return a list of dicts of allowed transition ids and titles.
360
361        Each list entry provides keys ``name`` and ``title`` for
362        internal name and (human readable) title of a single
363        transition.
364        """
365        allowed_transitions = self.wf_info.getManualTransitions()
366        return [dict(name='', title=_('No transition'))] +[
367            dict(name=x, title=y) for x, y in allowed_transitions]
368
369    @action(_('Save'), style='primary')
370    def save(self, **data):
371        form = self.request.form
372        password = form.get('password', None)
373        password_ctl = form.get('control_password', None)
374        if password:
375            validator = getUtility(IPasswordValidator)
376            errors = validator.validate_password(password, password_ctl)
377            if errors:
378                self.flash( ' '.join(errors))
379                return
380        changed_fields = self.applyData(self.context, **data)
381        # Turn list of lists into single list
382        if changed_fields:
383            changed_fields = reduce(lambda x,y: x+y, changed_fields.values())
384        else:
385            changed_fields = []
386        if password:
387            # Now we know that the form has no errors and can set password ...
388            IUserAccount(self.context).setPassword(password)
389            changed_fields.append('password')
390        # ... and execute transition
391        if form.has_key('transition') and form['transition']:
392            transition_id = form['transition']
393            self.wf_info.fireTransition(transition_id)
394        fields_string = ' + '.join(changed_fields)
395        self.flash(_('Form has been saved.'))
396        if fields_string:
397            write_log_message(self, 'saved: % s' % fields_string)
398        return
399
400class StudentClearanceDisplayFormPage(KofaDisplayFormPage):
401    """ Page to display student clearance data
402    """
403    grok.context(IStudent)
404    grok.name('view_clearance')
405    grok.require('waeup.viewStudent')
406    pnav = 4
407
408    @property
409    def separators(self):
410        return getUtility(IStudentsUtils).SEPARATORS_DICT
411
412    @property
413    def form_fields(self):
414        cm = getattr(self.context,'current_mode', None)
415        if cm is not None and cm.startswith('pg'):
416            form_fields = grok.AutoFields(IPGStudentClearance).omit('clearance_locked')
417        else:
418            form_fields = grok.AutoFields(IUGStudentClearance).omit('clearance_locked')
419        return form_fields
420
421    @property
422    def label(self):
423        return _('${a}: Clearance Data',
424            mapping = {'a':self.context.display_fullname})
425
426class ExportPDFClearanceSlipPage(grok.View):
427    """Deliver a PDF slip of the context.
428    """
429    grok.context(IStudent)
430    grok.name('clearance.pdf')
431    grok.require('waeup.viewStudent')
432    prefix = 'form'
433
434    @property
435    def form_fields(self):
436        cm = getattr(self.context,'current_mode', None)
437        if cm is not None and cm.startswith('pg'):
438            form_fields = grok.AutoFields(IPGStudentClearance).omit('clearance_locked')
439        else:
440            form_fields = grok.AutoFields(IUGStudentClearance).omit('clearance_locked')
441        return form_fields
442
443    @property
444    def title(self):
445        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
446        return translate(_('Clearance Data'), 'waeup.kofa',
447            target_language=portal_language)
448
449    @property
450    def label(self):
451        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
452        return translate(_('Clearance Slip of '),
453            'waeup.kofa', target_language=portal_language) \
454            + ' %s' % self.context.display_fullname
455
456    def render(self):
457        studentview = StudentBaseDisplayFormPage(self.context.getStudent(),
458            self.request)
459        students_utils = getUtility(IStudentsUtils)
460        return students_utils.renderPDF(
461            self, 'clearance.pdf',
462            self.context.getStudent(), studentview)
463
464class StudentClearanceManageFormPage(KofaEditFormPage):
465    """ Page to manage student clearance data
466    """
467    grok.context(IStudent)
468    grok.name('manage_clearance')
469    grok.require('waeup.manageStudent')
470    grok.template('clearanceeditpage')
471    label = _('Manage clearance data')
472    pnav = 4
473
474    @property
475    def separators(self):
476        return getUtility(IStudentsUtils).SEPARATORS_DICT
477
478    @property
479    def form_fields(self):
480        cm = getattr(self.context,'current_mode', None)
481        if cm is not None and cm.startswith('pg'):
482            form_fields = grok.AutoFields(IPGStudentClearance)
483        else:
484            form_fields = grok.AutoFields(IUGStudentClearance)
485        return form_fields
486
487    def update(self):
488        datepicker.need() # Enable jQuery datepicker in date fields.
489        tabs.need()
490        self.tab1 = self.tab2 = ''
491        qs = self.request.get('QUERY_STRING', '')
492        if not qs:
493            qs = 'tab1'
494        setattr(self, qs, 'active')
495        return super(StudentClearanceManageFormPage, self).update()
496
497    @action(_('Save'), style='primary')
498    def save(self, **data):
499        msave(self, **data)
500        return
501
502class StudentClearPage(UtilityView, grok.View):
503    """ Clear student by clearance officer
504    """
505    grok.context(IStudent)
506    grok.name('clear')
507    grok.require('waeup.clearStudent')
508
509    def update(self):
510        if self.context.state == REQUESTED:
511            IWorkflowInfo(self.context).fireTransition('clear')
512            self.flash(_('Student has been cleared.'))
513        else:
514            self.flash(_('Student is in wrong state.'))
515        self.redirect(self.url(self.context,'view_clearance'))
516        return
517
518    def render(self):
519        return
520
521class StudentRejectClearancePage(UtilityView, grok.View):
522    """ Reject clearance by clearance officers
523    """
524    grok.context(IStudent)
525    grok.name('reject_clearance')
526    grok.require('waeup.clearStudent')
527
528    def update(self):
529        if self.context.state == CLEARED:
530            IWorkflowInfo(self.context).fireTransition('reset4')
531            message = _('Clearance has been annulled.')
532            self.flash(message)
533        elif self.context.state == REQUESTED:
534            IWorkflowInfo(self.context).fireTransition('reset3')
535            message = _('Clearance request has been rejected.')
536            self.flash(message)
537        else:
538            self.flash(_('Student is in wrong state.'))
539            self.redirect(self.url(self.context,'view_clearance'))
540            return
541        args = {'subject':message}
542        self.redirect(self.url(self.context) +
543            '/contactstudent?%s' % urlencode(args))
544        return
545
546    def render(self):
547        return
548
549class StudentPersonalDisplayFormPage(KofaDisplayFormPage):
550    """ Page to display student personal data
551    """
552    grok.context(IStudent)
553    grok.name('view_personal')
554    grok.require('waeup.viewStudent')
555    form_fields = grok.AutoFields(IStudentPersonal)
556    form_fields['perm_address'].custom_widget = BytesDisplayWidget
557    pnav = 4
558
559    @property
560    def label(self):
561        return _('${a}: Personal Data',
562            mapping = {'a':self.context.display_fullname})
563
564class StudentPersonalEditFormPage(KofaEditFormPage):
565    """ Page to edit personal data
566    """
567    grok.context(IStudent)
568    grok.name('edit_personal')
569    grok.require('waeup.handleStudent')
570    form_fields = grok.AutoFields(IStudentPersonal)
571    label = _('Edit personal data')
572    pnav = 4
573
574    @action(_('Save'), style='primary')
575    def save(self, **data):
576        msave(self, **data)
577        return
578
579class StudyCourseDisplayFormPage(KofaDisplayFormPage):
580    """ Page to display the student study course data
581    """
582    grok.context(IStudentStudyCourse)
583    grok.name('index')
584    grok.require('waeup.viewStudent')
585    form_fields = grok.AutoFields(IStudentStudyCourse)
586    grok.template('studycoursepage')
587    pnav = 4
588
589    @property
590    def label(self):
591        return _('${a}: Study Course',
592            mapping = {'a':self.context.__parent__.display_fullname})
593
594    @property
595    def current_mode(self):
596        if self.context.certificate is not None:
597            studymodes_dict = getUtility(IKofaUtils).STUDY_MODES_DICT
598            return studymodes_dict[self.context.certificate.study_mode]
599        return
600
601    @property
602    def department(self):
603        if self.context.certificate is not None:
604            return self.context.certificate.__parent__.__parent__
605        return
606
607    @property
608    def faculty(self):
609        if self.context.certificate is not None:
610            return self.context.certificate.__parent__.__parent__.__parent__
611        return
612
613class StudyCourseManageFormPage(KofaEditFormPage):
614    """ Page to edit the student study course data
615    """
616    grok.context(IStudentStudyCourse)
617    grok.name('manage')
618    grok.require('waeup.manageStudent')
619    grok.template('studycoursemanagepage')
620    form_fields = grok.AutoFields(IStudentStudyCourse)
621    label = _('Manage study course')
622    pnav = 4
623    taboneactions = [_('Save'),_('Cancel')]
624    tabtwoactions = [_('Remove selected levels'),_('Cancel')]
625    tabthreeactions = [_('Add study level')]
626
627    def update(self):
628        super(StudyCourseManageFormPage, self).update()
629        tabs.need()
630        self.tab1 = self.tab2 = ''
631        qs = self.request.get('QUERY_STRING', '')
632        if not qs:
633            qs = 'tab1'
634        setattr(self, qs, 'active')
635        warning.need()
636        datatable.need()
637        return
638
639    @action(_('Save'), style='primary')
640    def save(self, **data):
641        try:
642            msave(self, **data)
643        except ConstraintNotSatisfied:
644            # The selected level might not exist in certificate
645            self.flash(_('Current level not available for certificate.'))
646            return
647        notify(grok.ObjectModifiedEvent(self.context.__parent__))
648        return
649
650    @property
651    def level_dict(self):
652        studylevelsource = StudyLevelSource().factory
653        for code in studylevelsource.getValues(self.context):
654            title = studylevelsource.getTitle(self.context, code)
655            yield(dict(code=code, title=title))
656
657    @action(_('Add study level'))
658    def addStudyLevel(self, **data):
659        level_code = self.request.form.get('addlevel', None)
660        studylevel = StudentStudyLevel()
661        studylevel.level = int(level_code)
662        try:
663            self.context.addStudentStudyLevel(
664                self.context.certificate,studylevel)
665            self.flash(_('Study level has been added.'))
666        except KeyError:
667            self.flash(_('This level exists.'))
668        self.redirect(self.url(self.context, u'@@manage')+'?tab2')
669        return
670
671    @jsaction(_('Remove selected levels'))
672    def delStudyLevels(self, **data):
673        form = self.request.form
674        if form.has_key('val_id'):
675            child_id = form['val_id']
676        else:
677            self.flash(_('No study level selected.'))
678            self.redirect(self.url(self.context, '@@manage')+'?tab2')
679            return
680        if not isinstance(child_id, list):
681            child_id = [child_id]
682        deleted = []
683        for id in child_id:
684            del self.context[id]
685            deleted.append(id)
686        if len(deleted):
687            self.flash(_('Successfully removed: ${a}',
688                mapping = {'a':', '.join(deleted)}))
689        self.redirect(self.url(self.context, u'@@manage')+'?tab2')
690        return
691
692class StudyLevelDisplayFormPage(KofaDisplayFormPage):
693    """ Page to display student study levels
694    """
695    grok.context(IStudentStudyLevel)
696    grok.name('index')
697    grok.require('waeup.viewStudent')
698    form_fields = grok.AutoFields(IStudentStudyLevel)
699    grok.template('studylevelpage')
700    pnav = 4
701
702    def update(self):
703        super(StudyLevelDisplayFormPage, self).update()
704        datatable.need()
705        return
706
707    @property
708    def translated_values(self):
709        lang = self.request.cookies.get('kofa.language')
710        for value in self.context.values():
711            # We have to make a deepcopy otherwise we'll override
712            # the object's dict values (not the attributes).
713            value_dict = deepcopy(value.__dict__)
714            value_dict['mandatory'] = translate(str(value.mandatory), 'zope',
715                target_language=lang)
716            value_dict['carry_over'] = translate(str(value.carry_over), 'zope',
717                target_language=lang)
718            value_dict['automatic'] = translate(str(value.automatic), 'zope',
719                target_language=lang)
720            yield value_dict
721
722    @property
723    def label(self):
724        # Here we know that the cookie has been set
725        lang = self.request.cookies.get('kofa.language')
726        level_title = translate(self.context.level_title, 'waeup.kofa',
727            target_language=lang)
728        return _('${a}: Study Level ${b}', mapping = {
729            'a':self.context.getStudent().display_fullname,
730            'b':level_title})
731
732    @property
733    def total_credits(self):
734        total_credits = 0
735        for key, val in self.context.items():
736            total_credits += val.credits
737        return total_credits
738
739class ExportPDFCourseRegistrationSlipPage(UtilityView, grok.View):
740    """Deliver a PDF slip of the context.
741    """
742    grok.context(IStudentStudyLevel)
743    grok.name('course_registration.pdf')
744    grok.require('waeup.viewStudent')
745    form_fields = grok.AutoFields(IStudentStudyLevel)
746    prefix = 'form'
747
748    @property
749    def title(self):
750        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
751        return translate(_('Level Data'), 'waeup.kofa',
752            target_language=portal_language)
753
754    @property
755    def content_title(self):
756        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
757        return translate(_('Course List'), 'waeup.kofa',
758            target_language=portal_language)
759
760    @property
761    def label(self):
762        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
763        lang = self.request.cookies.get('kofa.language', portal_language)
764        level_title = translate(self.context.level_title, 'waeup.kofa',
765            target_language=lang)
766        return translate(_('Course Registration Slip'),
767            'waeup.kofa', target_language=portal_language) \
768            + ' %s' % level_title
769
770    def render(self):
771        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
772        Sem = translate(_('Sem.'), 'waeup.kofa', target_language=portal_language)
773        Code = translate(_('Code'), 'waeup.kofa', target_language=portal_language)
774        Title = translate(_('Title'), 'waeup.kofa', target_language=portal_language)
775        Dept = translate(_('Dept.'), 'waeup.kofa', target_language=portal_language)
776        Faculty = translate(_('Faculty'), 'waeup.kofa', target_language=portal_language)
777        Cred = translate(_('Cred.'), 'waeup.kofa', target_language=portal_language)
778        Mand = translate(_('Mand.'), 'waeup.kofa', target_language=portal_language)
779        Score = translate(_('Score'), 'waeup.kofa', target_language=portal_language)
780        studentview = StudentBaseDisplayFormPage(self.context.getStudent(),
781            self.request)
782        students_utils = getUtility(IStudentsUtils)
783        tabledata = sorted(self.context.values(),
784            key=lambda value: str(value.semester) + value.code)
785        return students_utils.renderPDF(
786            self, 'course_registration.pdf',
787            self.context.getStudent(), studentview,
788            tableheader=[(Sem,'semester', 1.5),(Code,'code', 2.5),
789                         (Title,'title', 5),
790                         (Dept,'dcode', 1.5), (Faculty,'fcode', 1.5),
791                         (Cred, 'credits', 1.5),
792                         (Mand, 'mandatory', 1.5),
793                         (Score, 'score', 1.5),
794                         #('Auto', 'automatic', 1.5)
795                         ],
796            tabledata=tabledata)
797
798class StudyLevelManageFormPage(KofaEditFormPage):
799    """ Page to edit the student study level data
800    """
801    grok.context(IStudentStudyLevel)
802    grok.name('manage')
803    grok.require('waeup.manageStudent')
804    grok.template('studylevelmanagepage')
805    form_fields = grok.AutoFields(IStudentStudyLevel)
806    pnav = 4
807    taboneactions = [_('Save'),_('Cancel')]
808    tabtwoactions = [_('Add course ticket'),
809        _('Remove selected tickets'),_('Cancel')]
810
811    def update(self):
812        super(StudyLevelManageFormPage, self).update()
813        tabs.need()
814        self.tab1 = self.tab2 = ''
815        qs = self.request.get('QUERY_STRING', '')
816        if not qs:
817            qs = 'tab1'
818        setattr(self, qs, 'active')
819        warning.need()
820        datatable.need()
821        return
822
823    @property
824    def label(self):
825        # Here we know that the cookie has been set
826        lang = self.request.cookies.get('kofa.language')
827        level_title = translate(self.context.level_title, 'waeup.kofa',
828            target_language=lang)
829        return _('Manage study level ${a}',
830            mapping = {'a':level_title})
831
832    @action(_('Save'), style='primary')
833    def save(self, **data):
834        msave(self, **data)
835        return
836
837    @action(_('Add course ticket'))
838    def addCourseTicket(self, **data):
839        self.redirect(self.url(self.context, '@@add'))
840
841    @jsaction(_('Remove selected tickets'))
842    def delCourseTicket(self, **data):
843        form = self.request.form
844        if form.has_key('val_id'):
845            child_id = form['val_id']
846        else:
847            self.flash(_('No ticket selected.'))
848            self.redirect(self.url(self.context, '@@manage')+'?tab2')
849            return
850        if not isinstance(child_id, list):
851            child_id = [child_id]
852        deleted = []
853        for id in child_id:
854            del self.context[id]
855            deleted.append(id)
856        if len(deleted):
857            self.flash(_('Successfully removed: ${a}',
858                mapping = {'a':', '.join(deleted)}))
859        self.redirect(self.url(self.context, u'@@manage')+'?tab2')
860        return
861
862class ValidateCoursesPage(UtilityView, grok.View):
863    """ Validate course list by course adviser
864    """
865    grok.context(IStudentStudyLevel)
866    grok.name('validate_courses')
867    grok.require('waeup.validateStudent')
868
869    def update(self):
870        if str(self.context.__parent__.current_level) != self.context.__name__:
871            self.flash(_('This level does not correspond current level.'))
872        elif self.context.getStudent().state == REGISTERED:
873            IWorkflowInfo(self.context.getStudent()).fireTransition(
874                'validate_courses')
875            self.flash(_('Course list has been validated.'))
876        else:
877            self.flash(_('Student is in the wrong state.'))
878        self.redirect(self.url(self.context))
879        return
880
881    def render(self):
882        return
883
884class RejectCoursesPage(UtilityView, grok.View):
885    """ Reject course list by course adviser
886    """
887    grok.context(IStudentStudyLevel)
888    grok.name('reject_courses')
889    grok.require('waeup.validateStudent')
890
891    def update(self):
892        if str(self.context.__parent__.current_level) != self.context.__name__:
893            self.flash(_('This level does not correspond current level.'))
894            self.redirect(self.url(self.context))
895            return
896        elif self.context.getStudent().state == VALIDATED:
897            IWorkflowInfo(self.context.getStudent()).fireTransition('reset8')
898            message = _('Course list request has been annulled.')
899            self.flash(message)
900        elif self.context.getStudent().state == REGISTERED:
901            IWorkflowInfo(self.context.getStudent()).fireTransition('reset7')
902            message = _('Course list request has been rejected:')
903            self.flash(message)
904        else:
905            self.flash(_('Student is in the wrong state.'))
906            self.redirect(self.url(self.context))
907            return
908        args = {'subject':message}
909        self.redirect(self.url(self.context.getStudent()) +
910            '/contactstudent?%s' % urlencode(args))
911        return
912
913    def render(self):
914        return
915
916class CourseTicketAddFormPage(KofaAddFormPage):
917    """Add a course ticket.
918    """
919    grok.context(IStudentStudyLevel)
920    grok.name('add')
921    grok.require('waeup.manageStudent')
922    label = _('Add course ticket')
923    form_fields = grok.AutoFields(ICourseTicketAdd).omit(
924        'score', 'automatic', 'carry_over')
925    pnav = 4
926
927    @action(_('Add course ticket'))
928    def addCourseTicket(self, **data):
929        ticket = CourseTicket()
930        course = data['course']
931        ticket.automatic = False
932        ticket.carry_over = False
933        ticket.code = course.code
934        ticket.title = course.title
935        ticket.fcode = course.__parent__.__parent__.__parent__.code
936        ticket.dcode = course.__parent__.__parent__.code
937        ticket.credits = course.credits
938        ticket.passmark = course.passmark
939        ticket.semester = course.semester
940        try:
941            self.context.addCourseTicket(ticket)
942        except KeyError:
943            self.flash(_('The ticket exists.'))
944            return
945        self.flash(_('Successfully added ${a}.',
946            mapping = {'a':ticket.code}))
947        self.redirect(self.url(self.context, u'@@manage')+'?tab2')
948        return
949
950    @action(_('Cancel'), validator=NullValidator)
951    def cancel(self, **data):
952        self.redirect(self.url(self.context))
953
954class CourseTicketDisplayFormPage(KofaDisplayFormPage):
955    """ Page to display course tickets
956    """
957    grok.context(ICourseTicket)
958    grok.name('index')
959    grok.require('waeup.viewStudent')
960    form_fields = grok.AutoFields(ICourseTicket)
961    grok.template('courseticketpage')
962    pnav = 4
963
964    @property
965    def label(self):
966        return _('${a}: Course Ticket ${b}', mapping = {
967            'a':self.context.getStudent().display_fullname,
968            'b':self.context.code})
969
970class CourseTicketManageFormPage(KofaEditFormPage):
971    """ Page to manage course tickets
972    """
973    grok.context(ICourseTicket)
974    grok.name('manage')
975    grok.require('waeup.manageStudent')
976    form_fields = grok.AutoFields(ICourseTicket)
977    grok.template('courseticketmanagepage')
978    pnav = 4
979
980    @property
981    def label(self):
982        return _('Manage course ticket ${a}', mapping = {'a':self.context.code})
983
984    @action('Save', style='primary')
985    def save(self, **data):
986        msave(self, **data)
987        return
988
989class PaymentsManageFormPage(KofaEditFormPage):
990    """ Page to manage the student payments
991
992    This manage form page is for both students and students officers.
993    """
994    grok.context(IStudentPaymentsContainer)
995    grok.name('index')
996    grok.require('waeup.payStudent')
997    form_fields = grok.AutoFields(IStudentPaymentsContainer)
998    grok.template('paymentsmanagepage')
999    pnav = 4
1000
1001    def unremovable(self, ticket):
1002        usertype = getattr(self.request.principal, 'user_type', None)
1003        if not usertype:
1004            return False
1005        return (self.request.principal.user_type == 'student' and ticket.r_code)
1006
1007    @property
1008    def label(self):
1009        return _('${a}: Payments',
1010            mapping = {'a':self.context.__parent__.display_fullname})
1011
1012    def update(self):
1013        super(PaymentsManageFormPage, self).update()
1014        datatable.need()
1015        warning.need()
1016        return
1017
1018    @jsaction(_('Remove selected tickets'))
1019    def delPaymentTicket(self, **data):
1020        form = self.request.form
1021        if form.has_key('val_id'):
1022            child_id = form['val_id']
1023        else:
1024            self.flash(_('No payment selected.'))
1025            self.redirect(self.url(self.context))
1026            return
1027        if not isinstance(child_id, list):
1028            child_id = [child_id]
1029        deleted = []
1030        for id in child_id:
1031            # Students are not allowed to remove used payment tickets
1032            if not self.unremovable(self.context[id]):
1033                del self.context[id]
1034                deleted.append(id)
1035        if len(deleted):
1036            self.flash(_('Successfully removed: ${a}',
1037                mapping = {'a': ', '.join(deleted)}))
1038            write_log_message(self,'removed: % s' % ', '.join(deleted))
1039        self.redirect(self.url(self.context))
1040        return
1041
1042    @action(_('Add online payment ticket'))
1043    def addPaymentTicket(self, **data):
1044        self.redirect(self.url(self.context, '@@addop'))
1045
1046class OnlinePaymentAddFormPage(KofaAddFormPage):
1047    """ Page to add an online payment ticket
1048    """
1049    grok.context(IStudentPaymentsContainer)
1050    grok.name('addop')
1051    grok.require('waeup.payStudent')
1052    form_fields = grok.AutoFields(IStudentOnlinePayment).select(
1053        'p_category')
1054    label = _('Add online payment')
1055    pnav = 4
1056    factory = u'waeup.StudentOnlinePayment'
1057
1058    def _fillCustomFields(self, payment, pay_details):
1059        """No custom fields in the base package
1060        """
1061        return payment
1062
1063    @action(_('Create ticket'), style='primary')
1064    def createTicket(self, **data):
1065        p_category = data['p_category']
1066        student = self.context.__parent__
1067        if p_category == 'bed_allocation' and student[
1068            'studycourse'].current_session != grok.getSite()[
1069            'configuration'].accommodation_session:
1070                self.flash(
1071                    _('Your current session does not match ' + \
1072                    'accommodation session.'))
1073                self.redirect(self.url(self.context))
1074                return
1075        students_utils = getUtility(IStudentsUtils)
1076        try:
1077            pay_details  = students_utils.getPaymentDetails(
1078                p_category,student)
1079        except AttributeError:
1080            self.flash(
1081                _('Study course data are incomplete.'))
1082            self.redirect(self.url(self.context))
1083            return
1084        if pay_details['error']:
1085            self.flash(pay_details['error'])
1086            self.redirect(self.url(self.context))
1087            return
1088        p_item = pay_details['p_item']
1089        p_session = pay_details['p_session']
1090        for key in self.context.keys():
1091            ticket = self.context[key]
1092            if ticket.p_state == 'paid' and\
1093               ticket.p_category == p_category and \
1094               ticket.p_item == p_item and \
1095               ticket.p_session == p_session:
1096                  self.flash(
1097                      _('This type of payment has already been made.'))
1098                  self.redirect(self.url(self.context))
1099                  return
1100        payment = createObject(self.factory)
1101        self.applyData(payment, **data)
1102        timestamp = "%d" % int(time()*1000)
1103        payment.p_id = "p%s" % timestamp
1104        payment.p_item = p_item
1105        payment.p_session = p_session
1106        payment.amount_auth = pay_details['amount']
1107        payment = self._fillCustomFields(payment, pay_details)
1108        self.context[payment.p_id] = payment
1109        self.flash(_('Payment ticket created.'))
1110        self.redirect(self.url(self.context))
1111        return
1112
1113class OnlinePaymentDisplayFormPage(KofaDisplayFormPage):
1114    """ Page to view an online payment ticket
1115    """
1116    grok.context(IStudentOnlinePayment)
1117    grok.name('index')
1118    grok.require('waeup.viewStudent')
1119    form_fields = grok.AutoFields(IStudentOnlinePayment)
1120    form_fields[
1121        'creation_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')
1122    form_fields[
1123        'payment_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')
1124    pnav = 4
1125
1126    @property
1127    def label(self):
1128        return _('${a}: Online Payment Ticket ${b}', mapping = {
1129            'a':self.context.getStudent().display_fullname,
1130            'b':self.context.p_id})
1131
1132class OnlinePaymentCallbackPage(UtilityView, grok.View):
1133    """ Callback view
1134    """
1135    grok.context(IStudentOnlinePayment)
1136    grok.name('simulate_callback')
1137    grok.require('waeup.payStudent')
1138
1139    # This update method simulates a valid callback und must be
1140    # neutralized in the customization package.
1141    def update(self):
1142        if self.context.p_state == 'paid':
1143            self.flash(_('This ticket has already been paid.'))
1144            return
1145        student = self.context.getStudent()
1146        write_log_message(self,'valid callback: %s' % self.context.p_id)
1147        self.context.r_amount_approved = self.context.amount_auth
1148        self.context.r_code = u'00'
1149        self.context.p_state = 'paid'
1150        self.context.payment_date = datetime.utcnow()
1151        if self.context.p_category == 'clearance':
1152            # Create CLR access code
1153            pin, error = create_accesscode('CLR',0,student.student_id)
1154            if error:
1155                self.flash(_('Valid callback received. ${a}',
1156                    mapping = {'a':error}))
1157                return
1158            self.context.ac = pin
1159        elif self.context.p_category == 'schoolfee':
1160            # Create SFE access code
1161            pin, error = create_accesscode('SFE',0,student.student_id)
1162            if error:
1163                self.flash(_('Valid callback received. ${a}',
1164                    mapping = {'a':error}))
1165                return
1166            self.context.ac = pin
1167        elif self.context.p_category == 'bed_allocation':
1168            # Create HOS access code
1169            pin, error = create_accesscode('HOS',0,student.student_id)
1170            if error:
1171                self.flash(_('Valid callback received. ${a}',
1172                    mapping = {'a':error}))
1173                return
1174            self.context.ac = pin
1175        self.flash(_('Valid callback received.'))
1176        return
1177
1178    def render(self):
1179        self.redirect(self.url(self.context, '@@index'))
1180        return
1181
1182class ExportPDFPaymentSlipPage(UtilityView, grok.View):
1183    """Deliver a PDF slip of the context.
1184    """
1185    grok.context(IStudentOnlinePayment)
1186    grok.name('payment_receipt.pdf')
1187    grok.require('waeup.viewStudent')
1188    form_fields = grok.AutoFields(IStudentOnlinePayment)
1189    form_fields['creation_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')
1190    form_fields['payment_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')
1191    prefix = 'form'
1192    title = 'Payment Data'
1193    note = None
1194
1195    @property
1196    def label(self):
1197        return 'Online Payment Receipt %s' % self.context.p_id
1198
1199    def render(self):
1200        if self.context.p_state != 'paid':
1201            self.flash('Ticket not yet paid.')
1202            self.redirect(self.url(self.context))
1203            return
1204        studentview = StudentBaseDisplayFormPage(self.context.getStudent(),
1205            self.request)
1206        students_utils = getUtility(IStudentsUtils)
1207        return students_utils.renderPDF(self, 'payment_receipt.pdf',
1208            self.context.getStudent(), studentview, note=self.note)
1209
1210
1211class AccommodationManageFormPage(KofaEditFormPage):
1212    """ Page to manage bed tickets.
1213
1214    This manage form page is for both students and students officers.
1215    """
1216    grok.context(IStudentAccommodation)
1217    grok.name('index')
1218    grok.require('waeup.handleAccommodation')
1219    form_fields = grok.AutoFields(IStudentAccommodation)
1220    grok.template('accommodationmanagepage')
1221    pnav = 4
1222    officers_only_actions = [_('Remove selected')]
1223
1224    @property
1225    def label(self):
1226        return _('${a}: Accommodation',
1227            mapping = {'a':self.context.__parent__.display_fullname})
1228
1229    def update(self):
1230        super(AccommodationManageFormPage, self).update()
1231        datatable.need()
1232        warning.need()
1233        return
1234
1235    @jsaction(_('Remove selected'))
1236    def delBedTickets(self, **data):
1237        if getattr(self.request.principal, 'user_type', None) == 'student':
1238            self.flash(_('You are not allowed to remove bed tickets.'))
1239            self.redirect(self.url(self.context))
1240            return
1241        form = self.request.form
1242        if form.has_key('val_id'):
1243            child_id = form['val_id']
1244        else:
1245            self.flash(_('No bed ticket selected.'))
1246            self.redirect(self.url(self.context))
1247            return
1248        if not isinstance(child_id, list):
1249            child_id = [child_id]
1250        deleted = []
1251        for id in child_id:
1252            del self.context[id]
1253            deleted.append(id)
1254        if len(deleted):
1255            self.flash(_('Successfully removed: ${a}',
1256                mapping = {'a':', '.join(deleted)}))
1257            write_log_message(self,'removed: % s' % ', '.join(deleted))
1258        self.redirect(self.url(self.context))
1259        return
1260
1261    @property
1262    def selected_actions(self):
1263        if getattr(self.request.principal, 'user_type', None) == 'student':
1264            return [action for action in self.actions
1265                    if not action.label in self.officers_only_actions]
1266        return self.actions
1267
1268class BedTicketAddPage(KofaPage):
1269    """ Page to add an online payment ticket
1270    """
1271    grok.context(IStudentAccommodation)
1272    grok.name('add')
1273    grok.require('waeup.handleAccommodation')
1274    grok.template('enterpin')
1275    ac_prefix = 'HOS'
1276    label = _('Add bed ticket')
1277    pnav = 4
1278    buttonname = _('Create bed ticket')
1279    notice = ''
1280
1281    def update(self, SUBMIT=None):
1282        student = self.context.getStudent()
1283        students_utils = getUtility(IStudentsUtils)
1284        acc_details  = students_utils.getAccommodationDetails(student)
1285        if not acc_details:
1286            self.flash(_("Your data are incomplete."))
1287            self.redirect(self.url(self.context))
1288            return
1289        if not student.state in acc_details['allowed_states']:
1290            self.flash(_("You are in the wrong registration state."))
1291            self.redirect(self.url(self.context))
1292            return
1293        if student['studycourse'].current_session != acc_details[
1294            'booking_session']:
1295            self.flash(
1296                _('Your current session does not match accommodation session.'))
1297            self.redirect(self.url(self.context))
1298            return
1299        if str(acc_details['booking_session']) in self.context.keys():
1300            self.flash(
1301                _('You already booked a bed space in current ' \
1302                    + 'accommodation session.'))
1303            self.redirect(self.url(self.context))
1304            return
1305        self.ac_series = self.request.form.get('ac_series', None)
1306        self.ac_number = self.request.form.get('ac_number', None)
1307        if SUBMIT is None:
1308            return
1309        pin = '%s-%s-%s' % (self.ac_prefix, self.ac_series, self.ac_number)
1310        code = get_access_code(pin)
1311        if not code:
1312            self.flash(_('Activation code is invalid.'))
1313            return
1314        # Search and book bed
1315        cat = queryUtility(ICatalog, name='beds_catalog', default=None)
1316        entries = cat.searchResults(
1317            owner=(student.student_id,student.student_id))
1318        if len(entries):
1319            # If bed space has bee manually allocated use this bed
1320            bed = [entry for entry in entries][0]
1321        else:
1322            # else search for other available beds
1323            entries = cat.searchResults(
1324                bed_type=(acc_details['bt'],acc_details['bt']))
1325            available_beds = [
1326                entry for entry in entries if entry.owner == NOT_OCCUPIED]
1327            if available_beds:
1328                students_utils = getUtility(IStudentsUtils)
1329                bed = students_utils.selectBed(available_beds)
1330                bed.bookBed(student.student_id)
1331            else:
1332                self.flash(_('There is no free bed in your category ${a}.',
1333                    mapping = {'a':acc_details['bt']}))
1334                return
1335        # Mark pin as used (this also fires a pin related transition)
1336        if code.state == USED:
1337            self.flash(_('Activation code has already been used.'))
1338            return
1339        else:
1340            comment = _(u'invalidated')
1341            # Here we know that the ac is in state initialized so we do not
1342            # expect an exception, but the owner might be different
1343            if not invalidate_accesscode(
1344                pin,comment,self.context.getStudent().student_id):
1345                self.flash(_('You are not the owner of this access code.'))
1346                return
1347        # Create bed ticket
1348        bedticket = createObject(u'waeup.BedTicket')
1349        bedticket.booking_code = pin
1350        bedticket.booking_session = acc_details['booking_session']
1351        bedticket.bed_type = acc_details['bt']
1352        bedticket.bed = bed
1353        hall_title = bed.__parent__.hostel_name
1354        coordinates = bed.getBedCoordinates()[1:]
1355        block, room_nr, bed_nr = coordinates
1356        bc = _('${a}, Block ${b}, Room ${c}, Bed ${d} (${e})', mapping = {
1357            'a':hall_title, 'b':block,
1358            'c':room_nr, 'd':bed_nr,
1359            'e':bed.bed_type})
1360        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
1361        bedticket.bed_coordinates = translate(
1362            bc, 'waeup.kofa',target_language=portal_language)
1363        key = str(acc_details['booking_session'])
1364        self.context[key] = bedticket
1365        self.flash(_('Bed ticket created and bed booked: ${a}',
1366            mapping = {'a':bedticket.bed_coordinates}))
1367        self.redirect(self.url(self.context))
1368        return
1369
1370class BedTicketDisplayFormPage(KofaDisplayFormPage):
1371    """ Page to display bed tickets
1372    """
1373    grok.context(IBedTicket)
1374    grok.name('index')
1375    grok.require('waeup.handleAccommodation')
1376    form_fields = grok.AutoFields(IBedTicket)
1377    pnav = 4
1378
1379    @property
1380    def label(self):
1381        return _('Bed Ticket for Session ${a}',
1382            mapping = {'a':self.context.getSessionString()})
1383
1384class ExportPDFBedTicketSlipPage(UtilityView, grok.View):
1385    """Deliver a PDF slip of the context.
1386    """
1387    grok.context(IBedTicket)
1388    grok.name('bed_allocation.pdf')
1389    grok.require('waeup.handleAccommodation')
1390    form_fields = grok.AutoFields(IBedTicket)
1391    form_fields['booking_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')
1392    prefix = 'form'
1393
1394    @property
1395    def title(self):
1396        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
1397        return translate(_('Bed Allocation Data'), 'waeup.kofa',
1398            target_language=portal_language)
1399
1400    @property
1401    def label(self):
1402        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
1403        return translate(_('Bed Allocation: '),
1404            'waeup.kofa', target_language=portal_language) \
1405            + ' %s' % self.context.bed_coordinates
1406
1407    def render(self):
1408        studentview = StudentBaseDisplayFormPage(self.context.getStudent(),
1409            self.request)
1410        students_utils = getUtility(IStudentsUtils)
1411        return students_utils.renderPDF(
1412            self, 'bed_allocation.pdf',
1413            self.context.getStudent(), studentview)
1414
1415class BedTicketRelocationPage(UtilityView, grok.View):
1416    """ Callback view
1417    """
1418    grok.context(IBedTicket)
1419    grok.name('relocate')
1420    grok.require('waeup.manageHostels')
1421
1422    # Relocate student if student parameters have changed or the bed_type
1423    # of the bed has changed
1424    def update(self):
1425        student = self.context.getStudent()
1426        students_utils = getUtility(IStudentsUtils)
1427        acc_details  = students_utils.getAccommodationDetails(student)
1428        if self.context.bed != None and \
1429              'reserved' in self.context.bed.bed_type:
1430            self.flash(_("Students in reserved beds can't be relocated."))
1431            self.redirect(self.url(self.context))
1432            return
1433        if acc_details['bt'] == self.context.bed_type and \
1434                self.context.bed != None and \
1435                self.context.bed.bed_type == self.context.bed_type:
1436            self.flash(_("Student can't be relocated."))
1437            self.redirect(self.url(self.context))
1438            return
1439        # Search a bed
1440        cat = queryUtility(ICatalog, name='beds_catalog', default=None)
1441        entries = cat.searchResults(
1442            owner=(student.student_id,student.student_id))
1443        if len(entries) and self.context.bed == None:
1444            # If booking has been cancelled but other bed space has been
1445            # manually allocated after cancellation use this bed
1446            new_bed = [entry for entry in entries][0]
1447        else:
1448            # Search for other available beds
1449            entries = cat.searchResults(
1450                bed_type=(acc_details['bt'],acc_details['bt']))
1451            available_beds = [
1452                entry for entry in entries if entry.owner == NOT_OCCUPIED]
1453            if available_beds:
1454                students_utils = getUtility(IStudentsUtils)
1455                new_bed = students_utils.selectBed(available_beds)
1456                new_bed.bookBed(student.student_id)
1457            else:
1458                self.flash(_('There is no free bed in your category ${a}.',
1459                    mapping = {'a':acc_details['bt']}))
1460                self.redirect(self.url(self.context))
1461                return
1462        # Release old bed if exists
1463        if self.context.bed != None:
1464            self.context.bed.owner = NOT_OCCUPIED
1465            notify(grok.ObjectModifiedEvent(self.context.bed))
1466        # Alocate new bed
1467        self.context.bed_type = acc_details['bt']
1468        self.context.bed = new_bed
1469        hall_title = new_bed.__parent__.hostel_name
1470        coordinates = new_bed.getBedCoordinates()[1:]
1471        block, room_nr, bed_nr = coordinates
1472        bc = _('${a}, Block ${b}, Room ${c}, Bed ${d} (${e})', mapping = {
1473            'a':hall_title, 'b':block,
1474            'c':room_nr, 'd':bed_nr,
1475            'e':new_bed.bed_type})
1476        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
1477        self.context.bed_coordinates = translate(
1478            bc, 'waeup.kofa',target_language=portal_language)
1479        self.flash(_('Student relocated: ${a}',
1480            mapping = {'a':self.context.bed_coordinates}))
1481        self.redirect(self.url(self.context))
1482        return
1483
1484    def render(self):
1485        return
1486
1487class StudentHistoryPage(KofaPage):
1488    """ Page to display student clearance data
1489    """
1490    grok.context(IStudent)
1491    grok.name('history')
1492    grok.require('waeup.viewStudent')
1493    grok.template('studenthistory')
1494    pnav = 4
1495
1496    @property
1497    def label(self):
1498        return _('${a}: History', mapping = {'a':self.context.display_fullname})
1499
1500# Pages for students only
1501
1502class StudentBaseEditFormPage(KofaEditFormPage):
1503    """ View to edit student base data
1504    """
1505    grok.context(IStudent)
1506    grok.name('edit_base')
1507    grok.require('waeup.handleStudent')
1508    form_fields = grok.AutoFields(IStudentBase).select(
1509        'email', 'phone')
1510    label = _('Edit base data')
1511    pnav = 4
1512
1513    @action(_('Save'), style='primary')
1514    def save(self, **data):
1515        msave(self, **data)
1516        return
1517
1518class StudentChangePasswordPage(KofaEditFormPage):
1519    """ View to manage student base data
1520    """
1521    grok.context(IStudent)
1522    grok.name('change_password')
1523    grok.require('waeup.handleStudent')
1524    grok.template('change_password')
1525    label = _('Change password')
1526    pnav = 4
1527
1528    @action(_('Save'), style='primary')
1529    def save(self, **data):
1530        form = self.request.form
1531        password = form.get('change_password', None)
1532        password_ctl = form.get('change_password_repeat', None)
1533        if password:
1534            validator = getUtility(IPasswordValidator)
1535            errors = validator.validate_password(password, password_ctl)
1536            if not errors:
1537                IUserAccount(self.context).setPassword(password)
1538                write_log_message(self, 'saved: password')
1539                self.flash(_('Password changed.'))
1540            else:
1541                self.flash( ' '.join(errors))
1542        return
1543
1544class StudentFilesUploadPage(KofaPage):
1545    """ View to upload files by student
1546    """
1547    grok.context(IStudent)
1548    grok.name('change_portrait')
1549    grok.require('waeup.uploadStudentFile')
1550    grok.template('filesuploadpage')
1551    label = _('Upload portrait')
1552    pnav = 4
1553
1554    def update(self):
1555        if self.context.getStudent().state != ADMITTED:
1556            emit_lock_message(self)
1557            return
1558        super(StudentFilesUploadPage, self).update()
1559        return
1560
1561class StartClearancePage(KofaPage):
1562    grok.context(IStudent)
1563    grok.name('start_clearance')
1564    grok.require('waeup.handleStudent')
1565    grok.template('enterpin')
1566    label = _('Start clearance')
1567    ac_prefix = 'CLR'
1568    notice = ''
1569    pnav = 4
1570    buttonname = _('Start clearance now')
1571
1572    @property
1573    def all_required_fields_filled(self):
1574        if self.context.email and self.context.phone:
1575            return True
1576        return False
1577
1578    @property
1579    def portrait_uploaded(self):
1580        store = getUtility(IExtFileStore)
1581        if store.getFileByContext(self.context, attr=u'passport.jpg'):
1582            return True
1583        return False
1584
1585    def update(self, SUBMIT=None):
1586        if not self.context.state == ADMITTED:
1587            self.flash(_("Wrong state"))
1588            self.redirect(self.url(self.context))
1589            return
1590        if not self.portrait_uploaded:
1591            self.flash(_("No portrait uploaded."))
1592            self.redirect(self.url(self.context, 'change_portrait'))
1593            return
1594        if not self.all_required_fields_filled:
1595            self.flash(_("Not all required fields filled."))
1596            self.redirect(self.url(self.context, 'edit_base'))
1597            return
1598        self.ac_series = self.request.form.get('ac_series', None)
1599        self.ac_number = self.request.form.get('ac_number', None)
1600
1601        if SUBMIT is None:
1602            return
1603        pin = '%s-%s-%s' % (self.ac_prefix, self.ac_series, self.ac_number)
1604        code = get_access_code(pin)
1605        if not code:
1606            self.flash(_('Activation code is invalid.'))
1607            return
1608        # Mark pin as used (this also fires a pin related transition)
1609        # and fire transition start_clearance
1610        if code.state == USED:
1611            self.flash(_('Activation code has already been used.'))
1612            return
1613        else:
1614            comment = _(u"invalidated")
1615            # Here we know that the ac is in state initialized so we do not
1616            # expect an exception, but the owner might be different
1617            if not invalidate_accesscode(pin,comment,self.context.student_id):
1618                self.flash(_('You are not the owner of this access code.'))
1619                return
1620            self.context.clr_code = pin
1621        IWorkflowInfo(self.context).fireTransition('start_clearance')
1622        self.flash(_('Clearance process has been started.'))
1623        self.redirect(self.url(self.context,'cedit'))
1624        return
1625
1626class StudentClearanceEditFormPage(StudentClearanceManageFormPage):
1627    """ View to edit student clearance data by student
1628    """
1629    grok.context(IStudent)
1630    grok.name('cedit')
1631    grok.require('waeup.handleStudent')
1632    label = _('Edit clearance data')
1633
1634    @property
1635    def form_fields(self):
1636        cm = getattr(self.context,'current_mode', None)
1637        if cm is not None and cm.startswith('pg'):
1638            form_fields = grok.AutoFields(IPGStudentClearance).omit('clearance_locked')
1639        else:
1640            form_fields = grok.AutoFields(IUGStudentClearance).omit('clearance_locked')
1641        return form_fields
1642
1643    def update(self):
1644        if self.context.clearance_locked:
1645            emit_lock_message(self)
1646            return
1647        return super(StudentClearanceEditFormPage, self).update()
1648
1649    @action(_('Save'), style='primary')
1650    def save(self, **data):
1651        self.applyData(self.context, **data)
1652        self.flash(_('Clearance form has been saved.'))
1653        return
1654
1655    def dataNotComplete(self):
1656        """To be implemented in the customization package.
1657        """
1658        return False
1659
1660    @action(_('Save and request clearance'), style='primary')
1661    def requestClearance(self, **data):
1662        self.applyData(self.context, **data)
1663        if self.dataNotComplete():
1664            self.flash(self.dataNotComplete())
1665            return
1666        self.flash(_('Clearance form has been saved.'))
1667        self.redirect(self.url(self.context,'request_clearance'))
1668        return
1669
1670class RequestClearancePage(KofaPage):
1671    grok.context(IStudent)
1672    grok.name('request_clearance')
1673    grok.require('waeup.handleStudent')
1674    grok.template('enterpin')
1675    label = _('Request clearance')
1676    notice = _('Enter the CLR access code used for starting clearance.')
1677    ac_prefix = 'CLR'
1678    pnav = 4
1679    buttonname = _('Request clearance now')
1680
1681    def update(self, SUBMIT=None):
1682        self.ac_series = self.request.form.get('ac_series', None)
1683        self.ac_number = self.request.form.get('ac_number', None)
1684        if SUBMIT is None:
1685            return
1686        pin = '%s-%s-%s' % (self.ac_prefix, self.ac_series, self.ac_number)
1687        if self.context.clr_code != pin:
1688            self.flash(_("This isn't your CLR access code."))
1689            return
1690        state = IWorkflowState(self.context).getState()
1691        # This shouldn't happen, but the application officer
1692        # might have forgotten to lock the form after changing the state
1693        if state != CLEARANCE:
1694            self.flash(_('This form cannot be submitted. Wrong state!'))
1695            return
1696        IWorkflowInfo(self.context).fireTransition('request_clearance')
1697        self.flash(_('Clearance has been requested.'))
1698        self.redirect(self.url(self.context))
1699        return
1700
1701class StartCourseRegistrationPage(KofaPage):
1702    grok.context(IStudentStudyCourse)
1703    grok.name('start_course_registration')
1704    grok.require('waeup.handleStudent')
1705    grok.template('enterpin')
1706    label = _('Start course registration')
1707    ac_prefix = 'SFE'
1708    notice = ''
1709    pnav = 4
1710    buttonname = _('Start course registration now')
1711
1712    def update(self, SUBMIT=None):
1713        if not self.context.getStudent().state in (CLEARED,RETURNING):
1714            self.flash(_("Wrong state"))
1715            self.redirect(self.url(self.context))
1716            return
1717        self.ac_series = self.request.form.get('ac_series', None)
1718        self.ac_number = self.request.form.get('ac_number', None)
1719
1720        if SUBMIT is None:
1721            return
1722        pin = '%s-%s-%s' % (self.ac_prefix, self.ac_series, self.ac_number)
1723        code = get_access_code(pin)
1724        if not code:
1725            self.flash(_('Activation code is invalid.'))
1726            return
1727        # Mark pin as used (this also fires a pin related transition)
1728        # and fire transition start_clearance
1729        if code.state == USED:
1730            self.flash(_('Activation code has already been used.'))
1731            return
1732        else:
1733            comment = _(u"invalidated")
1734            # Here we know that the ac is in state initialized so we do not
1735            # expect an exception, but the owner might be different
1736            if not invalidate_accesscode(
1737                pin,comment,self.context.getStudent().student_id):
1738                self.flash(_('You are not the owner of this access code.'))
1739                return
1740        if self.context.getStudent().state == CLEARED:
1741            IWorkflowInfo(self.context.getStudent()).fireTransition(
1742                'pay_first_school_fee')
1743        elif self.context.getStudent().state == RETURNING:
1744            IWorkflowInfo(self.context.getStudent()).fireTransition(
1745                'pay_school_fee')
1746        self.flash(_('Course registration has been started.'))
1747        self.redirect(self.url(self.context))
1748        return
1749
1750class AddStudyLevelFormPage(KofaEditFormPage):
1751    """ Page for students to add current study levels
1752    """
1753    grok.context(IStudentStudyCourse)
1754    grok.name('add')
1755    grok.require('waeup.handleStudent')
1756    grok.template('studyleveladdpage')
1757    form_fields = grok.AutoFields(IStudentStudyCourse)
1758    pnav = 4
1759
1760    @property
1761    def label(self):
1762        studylevelsource = StudyLevelSource().factory
1763        code = self.context.current_level
1764        title = studylevelsource.getTitle(self.context, code)
1765        return _('Add current level ${a}', mapping = {'a':title})
1766
1767    def update(self):
1768        if self.context.getStudent().state != PAID:
1769            emit_lock_message(self)
1770            return
1771        super(AddStudyLevelFormPage, self).update()
1772        return
1773
1774    @action(_('Create course list now'), style='primary')
1775    def addStudyLevel(self, **data):
1776        studylevel = StudentStudyLevel()
1777        studylevel.level = self.context.current_level
1778        studylevel.level_session = self.context.current_session
1779        try:
1780            self.context.addStudentStudyLevel(
1781                self.context.certificate,studylevel)
1782        except KeyError:
1783            self.flash(_('This level exists.'))
1784        self.redirect(self.url(self.context))
1785        return
1786
1787class StudyLevelEditFormPage(KofaEditFormPage):
1788    """ Page to edit the student study level data by students
1789    """
1790    grok.context(IStudentStudyLevel)
1791    grok.name('edit')
1792    grok.require('waeup.handleStudent')
1793    grok.template('studyleveleditpage')
1794    form_fields = grok.AutoFields(IStudentStudyLevel).omit(
1795        'level_session', 'level_verdict')
1796    pnav = 4
1797
1798    def update(self):
1799        if self.context.getStudent().state != PAID:
1800            emit_lock_message(self)
1801            return
1802        super(StudyLevelEditFormPage, self).update()
1803        datatable.need()
1804        warning.need()
1805        return
1806
1807    @property
1808    def label(self):
1809        # Here we know that the cookie has been set
1810        lang = self.request.cookies.get('kofa.language')
1811        level_title = translate(self.context.level_title, 'waeup.kofa',
1812            target_language=lang)
1813        return _('Add and remove course tickets of study level ${a}',
1814            mapping = {'a':level_title})
1815
1816    @property
1817    def total_credits(self):
1818        total_credits = 0
1819        for key, val in self.context.items():
1820            total_credits += val.credits
1821        return total_credits
1822
1823    @action(_('Add course ticket'))
1824    def addCourseTicket(self, **data):
1825        self.redirect(self.url(self.context, 'ctadd'))
1826
1827    @jsaction(_('Remove selected tickets'))
1828    def delCourseTicket(self, **data):
1829        form = self.request.form
1830        if form.has_key('val_id'):
1831            child_id = form['val_id']
1832        else:
1833            self.flash(_('No ticket selected.'))
1834            self.redirect(self.url(self.context, '@@edit'))
1835            return
1836        if not isinstance(child_id, list):
1837            child_id = [child_id]
1838        deleted = []
1839        for id in child_id:
1840            # Students are not allowed to remove core tickets
1841            if not self.context[id].mandatory:
1842                del self.context[id]
1843                deleted.append(id)
1844        if len(deleted):
1845            self.flash(_('Successfully removed: ${a}',
1846                mapping = {'a':', '.join(deleted)}))
1847        self.redirect(self.url(self.context, u'@@edit'))
1848        return
1849
1850    @action(_('Register course list'), style='primary')
1851    def RegisterCourses(self, **data):
1852        IWorkflowInfo(self.context.getStudent()).fireTransition(
1853            'register_courses')
1854        self.flash(_('Course list has been registered.'))
1855        self.redirect(self.url(self.context))
1856        return
1857
1858class CourseTicketAddFormPage2(CourseTicketAddFormPage):
1859    """Add a course ticket by student.
1860    """
1861    grok.name('ctadd')
1862    grok.require('waeup.handleStudent')
1863    form_fields = grok.AutoFields(ICourseTicketAdd).omit(
1864        'score', 'mandatory', 'automatic', 'carry_over')
1865
1866    def update(self):
1867        if self.context.getStudent().state != PAID:
1868            emit_lock_message(self)
1869            return
1870        super(CourseTicketAddFormPage2, self).update()
1871        return
1872
1873    @action(_('Add course ticket'))
1874    def addCourseTicket(self, **data):
1875        # Safety belt
1876        if self.context.getStudent().state != PAID:
1877            return
1878        ticket = CourseTicket()
1879        course = data['course']
1880        for name in ['code', 'title', 'credits', 'passmark', 'semester']:
1881            setattr(ticket, name, getattr(course, name))
1882        ticket.automatic = False
1883        try:
1884            self.context.addCourseTicket(ticket)
1885        except KeyError:
1886            self.flash(_('The ticket exists.'))
1887            return
1888        self.flash(_('Successfully added ${a}.',
1889            mapping = {'a':ticket.code}))
1890        self.redirect(self.url(self.context, u'@@edit'))
1891        return
1892
1893class ChangePasswordRequestPage(KofaForm):
1894    """Captcha'd page for students to request a password change.
1895    """
1896    grok.context(IUniversity)
1897    grok.name('sendpw')
1898    grok.require('waeup.Anonymous')
1899    grok.template('sendpassword')
1900    label = _('Send me a new password')
1901    form_fields = grok.AutoFields(IStudentChangePassword)
1902
1903    def update(self):
1904        # Handle captcha
1905        self.captcha = getUtility(ICaptchaManager).getCaptcha()
1906        self.captcha_result = self.captcha.verify(self.request)
1907        self.captcha_code = self.captcha.display(self.captcha_result.error_code)
1908        return
1909
1910    @action(_('Get new login credentials'), style='primary')
1911    def request(self, **data):
1912        if not self.captcha_result.is_valid:
1913            # Captcha will display error messages automatically.
1914            # No need to flash something.
1915            return
1916        # Search student or applicant
1917        reg_number = data['reg_number']
1918        email = data['email']
1919        cat = queryUtility(ICatalog, name='students_catalog')
1920        results = cat.searchResults(
1921            reg_number=(reg_number, reg_number),
1922            email=(email,email))
1923        if len(results) == 0:
1924            # Try also the applicants_catalog if no student record was found.
1925            cat = queryUtility(ICatalog, name='applicants_catalog')
1926            if cat is None:
1927                self.flash(_('Application package not installed.'))
1928                return
1929            results = cat.searchResults(
1930                reg_number=(reg_number, reg_number),
1931                email=(email,email))
1932        if len(results) == 0:
1933            self.flash(_('No record found.'))
1934            return
1935        student = list(results)[0]
1936        # Change password
1937        kofa_utils = getUtility(IKofaUtils)
1938        pwd = kofa_utils.genPassword()
1939        IUserAccount(student).setPassword(pwd)
1940        # Send email with new redentials
1941        msg = _('You have successfully changed your password for the')
1942        login_url = self.url(grok.getSite(), 'login')
1943        success = kofa_utils.sendCredentials(
1944            IUserAccount(student),pwd,login_url,msg)
1945        if success:
1946            self.flash(_('An email with your user name and password ' +
1947                'has been sent to ${a}.', mapping = {'a':email}))
1948        else:
1949            self.flash(_('An smtp server error occurred.'))
1950        return
1951
1952class SetPasswordPage(KofaPage):
1953    grok.context(IKofaObject)
1954    grok.name('setpassword')
1955    grok.require('waeup.Anonymous')
1956    grok.template('setpassword')
1957    label = _('Set password for first-time login')
1958    ac_prefix = 'PWD'
1959    pnav = 0
1960    set_button = _('Set')
1961
1962    def update(self, SUBMIT=None):
1963        self.reg_number = self.request.form.get('reg_number', None)
1964        self.ac_series = self.request.form.get('ac_series', None)
1965        self.ac_number = self.request.form.get('ac_number', None)
1966
1967        if SUBMIT is None:
1968            return
1969        hitlist = search(query=self.reg_number,
1970            searchtype='reg_number', view=self)
1971        if not hitlist:
1972            self.flash(_('No student found.'))
1973            return
1974        if len(hitlist) != 1:   # Cannot happen but anyway
1975            self.flash(_('More than one student found.'))
1976            return
1977        student = hitlist[0].context
1978        self.student_id = student.student_id
1979        student_pw = student.password
1980        pin = '%s-%s-%s' % (self.ac_prefix, self.ac_series, self.ac_number)
1981        code = get_access_code(pin)
1982        if not code:
1983            self.flash(_('Access code is invalid.'))
1984            return
1985        if student_pw and pin == student.adm_code:
1986            self.flash(_(
1987                'Password has already been set. Your Student Id is ${a}',
1988                mapping = {'a':self.student_id}))
1989            return
1990        elif student_pw:
1991            self.flash(
1992                _('Password has already been set. You are using the ' +
1993                'wrong Access Code.'))
1994            return
1995        # Mark pin as used (this also fires a pin related transition)
1996        # and set student password
1997        if code.state == USED:
1998            self.flash(_('Access code has already been used.'))
1999            return
2000        else:
2001            comment = _(u"invalidated")
2002            # Here we know that the ac is in state initialized so we do not
2003            # expect an exception
2004            invalidate_accesscode(pin,comment)
2005            IUserAccount(student).setPassword(self.ac_number)
2006            student.adm_code = pin
2007        self.flash(_('Password has been set. Your Student Id is ${a}',
2008            mapping = {'a':self.student_id}))
2009        return
Note: See TracBrowser for help on using the repository browser.