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

Last change on this file since 8287 was 8268, checked in by Henrik Bettermann, 13 years ago

Store payment level in student payments.

For school fee paments p_session and p_level are calculated as defined
in w.k.students.utils

  • Property svn:keywords set to Id
File size: 72.1 KB
Line 
1## $Id: browser.py 8268 2012-04-25 06:02:54Z 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, TypeError):
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.p_level = pay_details['p_level']
1107        payment.amount_auth = pay_details['amount']
1108        payment = self._fillCustomFields(payment, pay_details)
1109        self.context[payment.p_id] = payment
1110        self.flash(_('Payment ticket created.'))
1111        self.redirect(self.url(self.context))
1112        return
1113
1114class OnlinePaymentDisplayFormPage(KofaDisplayFormPage):
1115    """ Page to view an online payment ticket
1116    """
1117    grok.context(IStudentOnlinePayment)
1118    grok.name('index')
1119    grok.require('waeup.viewStudent')
1120    form_fields = grok.AutoFields(IStudentOnlinePayment)
1121    form_fields[
1122        'creation_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')
1123    form_fields[
1124        'payment_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')
1125    pnav = 4
1126
1127    @property
1128    def label(self):
1129        return _('${a}: Online Payment Ticket ${b}', mapping = {
1130            'a':self.context.getStudent().display_fullname,
1131            'b':self.context.p_id})
1132
1133class OnlinePaymentCallbackPage(UtilityView, grok.View):
1134    """ Callback view
1135    """
1136    grok.context(IStudentOnlinePayment)
1137    grok.name('simulate_callback')
1138    grok.require('waeup.payStudent')
1139
1140    # This update method simulates a valid callback und must be
1141    # neutralized in the customization package.
1142    def update(self):
1143        if self.context.p_state == 'paid':
1144            self.flash(_('This ticket has already been paid.'))
1145            return
1146        student = self.context.getStudent()
1147        write_log_message(self,'valid callback: %s' % self.context.p_id)
1148        self.context.r_amount_approved = self.context.amount_auth
1149        self.context.r_code = u'00'
1150        self.context.p_state = 'paid'
1151        self.context.payment_date = datetime.utcnow()
1152        if self.context.p_category == 'clearance':
1153            # Create CLR access code
1154            pin, error = create_accesscode('CLR',0,student.student_id)
1155            if error:
1156                self.flash(_('Valid callback received. ${a}',
1157                    mapping = {'a':error}))
1158                return
1159            self.context.ac = pin
1160        elif self.context.p_category == 'schoolfee':
1161            # Create SFE access code
1162            pin, error = create_accesscode('SFE',0,student.student_id)
1163            if error:
1164                self.flash(_('Valid callback received. ${a}',
1165                    mapping = {'a':error}))
1166                return
1167            self.context.ac = pin
1168        elif self.context.p_category == 'bed_allocation':
1169            # Create HOS access code
1170            pin, error = create_accesscode('HOS',0,student.student_id)
1171            if error:
1172                self.flash(_('Valid callback received. ${a}',
1173                    mapping = {'a':error}))
1174                return
1175            self.context.ac = pin
1176        self.flash(_('Valid callback received.'))
1177        return
1178
1179    def render(self):
1180        self.redirect(self.url(self.context, '@@index'))
1181        return
1182
1183class ExportPDFPaymentSlipPage(UtilityView, grok.View):
1184    """Deliver a PDF slip of the context.
1185    """
1186    grok.context(IStudentOnlinePayment)
1187    grok.name('payment_slip.pdf')
1188    grok.require('waeup.viewStudent')
1189    form_fields = grok.AutoFields(IStudentOnlinePayment)
1190    form_fields['creation_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')
1191    form_fields['payment_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')
1192    prefix = 'form'
1193    note = None
1194
1195    @property
1196    def title(self):
1197        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
1198        return translate(_('Payment Data'), 'waeup.kofa',
1199            target_language=portal_language)
1200
1201    @property
1202    def label(self):
1203        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
1204        return translate(_('Online Payment Slip'),
1205            'waeup.kofa', target_language=portal_language) \
1206            + ' %s' % self.context.p_id
1207
1208    def render(self):
1209        #if self.context.p_state != 'paid':
1210        #    self.flash('Ticket not yet paid.')
1211        #    self.redirect(self.url(self.context))
1212        #    return
1213        studentview = StudentBaseDisplayFormPage(self.context.getStudent(),
1214            self.request)
1215        students_utils = getUtility(IStudentsUtils)
1216        return students_utils.renderPDF(self, 'payment_slip.pdf',
1217            self.context.getStudent(), studentview, note=self.note)
1218
1219
1220class AccommodationManageFormPage(KofaEditFormPage):
1221    """ Page to manage bed tickets.
1222
1223    This manage form page is for both students and students officers.
1224    """
1225    grok.context(IStudentAccommodation)
1226    grok.name('index')
1227    grok.require('waeup.handleAccommodation')
1228    form_fields = grok.AutoFields(IStudentAccommodation)
1229    grok.template('accommodationmanagepage')
1230    pnav = 4
1231    officers_only_actions = [_('Remove selected')]
1232
1233    @property
1234    def label(self):
1235        return _('${a}: Accommodation',
1236            mapping = {'a':self.context.__parent__.display_fullname})
1237
1238    def update(self):
1239        super(AccommodationManageFormPage, self).update()
1240        datatable.need()
1241        warning.need()
1242        return
1243
1244    @jsaction(_('Remove selected'))
1245    def delBedTickets(self, **data):
1246        if getattr(self.request.principal, 'user_type', None) == 'student':
1247            self.flash(_('You are not allowed to remove bed tickets.'))
1248            self.redirect(self.url(self.context))
1249            return
1250        form = self.request.form
1251        if form.has_key('val_id'):
1252            child_id = form['val_id']
1253        else:
1254            self.flash(_('No bed ticket selected.'))
1255            self.redirect(self.url(self.context))
1256            return
1257        if not isinstance(child_id, list):
1258            child_id = [child_id]
1259        deleted = []
1260        for id in child_id:
1261            del self.context[id]
1262            deleted.append(id)
1263        if len(deleted):
1264            self.flash(_('Successfully removed: ${a}',
1265                mapping = {'a':', '.join(deleted)}))
1266            write_log_message(self,'removed: % s' % ', '.join(deleted))
1267        self.redirect(self.url(self.context))
1268        return
1269
1270    @property
1271    def selected_actions(self):
1272        if getattr(self.request.principal, 'user_type', None) == 'student':
1273            return [action for action in self.actions
1274                    if not action.label in self.officers_only_actions]
1275        return self.actions
1276
1277class BedTicketAddPage(KofaPage):
1278    """ Page to add an online payment ticket
1279    """
1280    grok.context(IStudentAccommodation)
1281    grok.name('add')
1282    grok.require('waeup.handleAccommodation')
1283    grok.template('enterpin')
1284    ac_prefix = 'HOS'
1285    label = _('Add bed ticket')
1286    pnav = 4
1287    buttonname = _('Create bed ticket')
1288    notice = ''
1289
1290    def update(self, SUBMIT=None):
1291        student = self.context.getStudent()
1292        students_utils = getUtility(IStudentsUtils)
1293        acc_details  = students_utils.getAccommodationDetails(student)
1294        if not acc_details:
1295            self.flash(_("Your data are incomplete."))
1296            self.redirect(self.url(self.context))
1297            return
1298        if not student.state in acc_details['allowed_states']:
1299            self.flash(_("You are in the wrong registration state."))
1300            self.redirect(self.url(self.context))
1301            return
1302        if student['studycourse'].current_session != acc_details[
1303            'booking_session']:
1304            self.flash(
1305                _('Your current session does not match accommodation session.'))
1306            self.redirect(self.url(self.context))
1307            return
1308        if str(acc_details['booking_session']) in self.context.keys():
1309            self.flash(
1310                _('You already booked a bed space in current ' \
1311                    + 'accommodation session.'))
1312            self.redirect(self.url(self.context))
1313            return
1314        self.ac_series = self.request.form.get('ac_series', None)
1315        self.ac_number = self.request.form.get('ac_number', None)
1316        if SUBMIT is None:
1317            return
1318        pin = '%s-%s-%s' % (self.ac_prefix, self.ac_series, self.ac_number)
1319        code = get_access_code(pin)
1320        if not code:
1321            self.flash(_('Activation code is invalid.'))
1322            return
1323        # Search and book bed
1324        cat = queryUtility(ICatalog, name='beds_catalog', default=None)
1325        entries = cat.searchResults(
1326            owner=(student.student_id,student.student_id))
1327        if len(entries):
1328            # If bed space has bee manually allocated use this bed
1329            bed = [entry for entry in entries][0]
1330        else:
1331            # else search for other available beds
1332            entries = cat.searchResults(
1333                bed_type=(acc_details['bt'],acc_details['bt']))
1334            available_beds = [
1335                entry for entry in entries if entry.owner == NOT_OCCUPIED]
1336            if available_beds:
1337                students_utils = getUtility(IStudentsUtils)
1338                bed = students_utils.selectBed(available_beds)
1339                bed.bookBed(student.student_id)
1340            else:
1341                self.flash(_('There is no free bed in your category ${a}.',
1342                    mapping = {'a':acc_details['bt']}))
1343                return
1344        # Mark pin as used (this also fires a pin related transition)
1345        if code.state == USED:
1346            self.flash(_('Activation code has already been used.'))
1347            return
1348        else:
1349            comment = _(u'invalidated')
1350            # Here we know that the ac is in state initialized so we do not
1351            # expect an exception, but the owner might be different
1352            if not invalidate_accesscode(
1353                pin,comment,self.context.getStudent().student_id):
1354                self.flash(_('You are not the owner of this access code.'))
1355                return
1356        # Create bed ticket
1357        bedticket = createObject(u'waeup.BedTicket')
1358        bedticket.booking_code = pin
1359        bedticket.booking_session = acc_details['booking_session']
1360        bedticket.bed_type = acc_details['bt']
1361        bedticket.bed = bed
1362        hall_title = bed.__parent__.hostel_name
1363        coordinates = bed.getBedCoordinates()[1:]
1364        block, room_nr, bed_nr = coordinates
1365        bc = _('${a}, Block ${b}, Room ${c}, Bed ${d} (${e})', mapping = {
1366            'a':hall_title, 'b':block,
1367            'c':room_nr, 'd':bed_nr,
1368            'e':bed.bed_type})
1369        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
1370        bedticket.bed_coordinates = translate(
1371            bc, 'waeup.kofa',target_language=portal_language)
1372        key = str(acc_details['booking_session'])
1373        self.context[key] = bedticket
1374        self.flash(_('Bed ticket created and bed booked: ${a}',
1375            mapping = {'a':bedticket.bed_coordinates}))
1376        self.redirect(self.url(self.context))
1377        return
1378
1379class BedTicketDisplayFormPage(KofaDisplayFormPage):
1380    """ Page to display bed tickets
1381    """
1382    grok.context(IBedTicket)
1383    grok.name('index')
1384    grok.require('waeup.handleAccommodation')
1385    form_fields = grok.AutoFields(IBedTicket)
1386    pnav = 4
1387
1388    @property
1389    def label(self):
1390        return _('Bed Ticket for Session ${a}',
1391            mapping = {'a':self.context.getSessionString()})
1392
1393class ExportPDFBedTicketSlipPage(UtilityView, grok.View):
1394    """Deliver a PDF slip of the context.
1395    """
1396    grok.context(IBedTicket)
1397    grok.name('bed_allocation.pdf')
1398    grok.require('waeup.handleAccommodation')
1399    form_fields = grok.AutoFields(IBedTicket)
1400    form_fields['booking_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')
1401    prefix = 'form'
1402
1403    @property
1404    def title(self):
1405        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
1406        return translate(_('Bed Allocation Data'), 'waeup.kofa',
1407            target_language=portal_language)
1408
1409    @property
1410    def label(self):
1411        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
1412        return translate(_('Bed Allocation: '),
1413            'waeup.kofa', target_language=portal_language) \
1414            + ' %s' % self.context.bed_coordinates
1415
1416    def render(self):
1417        studentview = StudentBaseDisplayFormPage(self.context.getStudent(),
1418            self.request)
1419        students_utils = getUtility(IStudentsUtils)
1420        return students_utils.renderPDF(
1421            self, 'bed_allocation.pdf',
1422            self.context.getStudent(), studentview)
1423
1424class BedTicketRelocationPage(UtilityView, grok.View):
1425    """ Callback view
1426    """
1427    grok.context(IBedTicket)
1428    grok.name('relocate')
1429    grok.require('waeup.manageHostels')
1430
1431    # Relocate student if student parameters have changed or the bed_type
1432    # of the bed has changed
1433    def update(self):
1434        student = self.context.getStudent()
1435        students_utils = getUtility(IStudentsUtils)
1436        acc_details  = students_utils.getAccommodationDetails(student)
1437        if self.context.bed != None and \
1438              'reserved' in self.context.bed.bed_type:
1439            self.flash(_("Students in reserved beds can't be relocated."))
1440            self.redirect(self.url(self.context))
1441            return
1442        if acc_details['bt'] == self.context.bed_type and \
1443                self.context.bed != None and \
1444                self.context.bed.bed_type == self.context.bed_type:
1445            self.flash(_("Student can't be relocated."))
1446            self.redirect(self.url(self.context))
1447            return
1448        # Search a bed
1449        cat = queryUtility(ICatalog, name='beds_catalog', default=None)
1450        entries = cat.searchResults(
1451            owner=(student.student_id,student.student_id))
1452        if len(entries) and self.context.bed == None:
1453            # If booking has been cancelled but other bed space has been
1454            # manually allocated after cancellation use this bed
1455            new_bed = [entry for entry in entries][0]
1456        else:
1457            # Search for other available beds
1458            entries = cat.searchResults(
1459                bed_type=(acc_details['bt'],acc_details['bt']))
1460            available_beds = [
1461                entry for entry in entries if entry.owner == NOT_OCCUPIED]
1462            if available_beds:
1463                students_utils = getUtility(IStudentsUtils)
1464                new_bed = students_utils.selectBed(available_beds)
1465                new_bed.bookBed(student.student_id)
1466            else:
1467                self.flash(_('There is no free bed in your category ${a}.',
1468                    mapping = {'a':acc_details['bt']}))
1469                self.redirect(self.url(self.context))
1470                return
1471        # Release old bed if exists
1472        if self.context.bed != None:
1473            self.context.bed.owner = NOT_OCCUPIED
1474            notify(grok.ObjectModifiedEvent(self.context.bed))
1475        # Alocate new bed
1476        self.context.bed_type = acc_details['bt']
1477        self.context.bed = new_bed
1478        hall_title = new_bed.__parent__.hostel_name
1479        coordinates = new_bed.getBedCoordinates()[1:]
1480        block, room_nr, bed_nr = coordinates
1481        bc = _('${a}, Block ${b}, Room ${c}, Bed ${d} (${e})', mapping = {
1482            'a':hall_title, 'b':block,
1483            'c':room_nr, 'd':bed_nr,
1484            'e':new_bed.bed_type})
1485        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
1486        self.context.bed_coordinates = translate(
1487            bc, 'waeup.kofa',target_language=portal_language)
1488        self.flash(_('Student relocated: ${a}',
1489            mapping = {'a':self.context.bed_coordinates}))
1490        self.redirect(self.url(self.context))
1491        return
1492
1493    def render(self):
1494        return
1495
1496class StudentHistoryPage(KofaPage):
1497    """ Page to display student clearance data
1498    """
1499    grok.context(IStudent)
1500    grok.name('history')
1501    grok.require('waeup.viewStudent')
1502    grok.template('studenthistory')
1503    pnav = 4
1504
1505    @property
1506    def label(self):
1507        return _('${a}: History', mapping = {'a':self.context.display_fullname})
1508
1509# Pages for students only
1510
1511class StudentBaseEditFormPage(KofaEditFormPage):
1512    """ View to edit student base data
1513    """
1514    grok.context(IStudent)
1515    grok.name('edit_base')
1516    grok.require('waeup.handleStudent')
1517    form_fields = grok.AutoFields(IStudentBase).select(
1518        'email', 'phone')
1519    label = _('Edit base data')
1520    pnav = 4
1521
1522    @action(_('Save'), style='primary')
1523    def save(self, **data):
1524        msave(self, **data)
1525        return
1526
1527class StudentChangePasswordPage(KofaEditFormPage):
1528    """ View to manage student base data
1529    """
1530    grok.context(IStudent)
1531    grok.name('change_password')
1532    grok.require('waeup.handleStudent')
1533    grok.template('change_password')
1534    label = _('Change password')
1535    pnav = 4
1536
1537    @action(_('Save'), style='primary')
1538    def save(self, **data):
1539        form = self.request.form
1540        password = form.get('change_password', None)
1541        password_ctl = form.get('change_password_repeat', None)
1542        if password:
1543            validator = getUtility(IPasswordValidator)
1544            errors = validator.validate_password(password, password_ctl)
1545            if not errors:
1546                IUserAccount(self.context).setPassword(password)
1547                write_log_message(self, 'saved: password')
1548                self.flash(_('Password changed.'))
1549            else:
1550                self.flash( ' '.join(errors))
1551        return
1552
1553class StudentFilesUploadPage(KofaPage):
1554    """ View to upload files by student
1555    """
1556    grok.context(IStudent)
1557    grok.name('change_portrait')
1558    grok.require('waeup.uploadStudentFile')
1559    grok.template('filesuploadpage')
1560    label = _('Upload portrait')
1561    pnav = 4
1562
1563    def update(self):
1564        if self.context.getStudent().state != ADMITTED:
1565            emit_lock_message(self)
1566            return
1567        super(StudentFilesUploadPage, self).update()
1568        return
1569
1570class StartClearancePage(KofaPage):
1571    grok.context(IStudent)
1572    grok.name('start_clearance')
1573    grok.require('waeup.handleStudent')
1574    grok.template('enterpin')
1575    label = _('Start clearance')
1576    ac_prefix = 'CLR'
1577    notice = ''
1578    pnav = 4
1579    buttonname = _('Start clearance now')
1580
1581    @property
1582    def all_required_fields_filled(self):
1583        if self.context.email and self.context.phone:
1584            return True
1585        return False
1586
1587    @property
1588    def portrait_uploaded(self):
1589        store = getUtility(IExtFileStore)
1590        if store.getFileByContext(self.context, attr=u'passport.jpg'):
1591            return True
1592        return False
1593
1594    def update(self, SUBMIT=None):
1595        if not self.context.state == ADMITTED:
1596            self.flash(_("Wrong state"))
1597            self.redirect(self.url(self.context))
1598            return
1599        if not self.portrait_uploaded:
1600            self.flash(_("No portrait uploaded."))
1601            self.redirect(self.url(self.context, 'change_portrait'))
1602            return
1603        if not self.all_required_fields_filled:
1604            self.flash(_("Not all required fields filled."))
1605            self.redirect(self.url(self.context, 'edit_base'))
1606            return
1607        self.ac_series = self.request.form.get('ac_series', None)
1608        self.ac_number = self.request.form.get('ac_number', None)
1609
1610        if SUBMIT is None:
1611            return
1612        pin = '%s-%s-%s' % (self.ac_prefix, self.ac_series, self.ac_number)
1613        code = get_access_code(pin)
1614        if not code:
1615            self.flash(_('Activation code is invalid.'))
1616            return
1617        # Mark pin as used (this also fires a pin related transition)
1618        # and fire transition start_clearance
1619        if code.state == USED:
1620            self.flash(_('Activation code has already been used.'))
1621            return
1622        else:
1623            comment = _(u"invalidated")
1624            # Here we know that the ac is in state initialized so we do not
1625            # expect an exception, but the owner might be different
1626            if not invalidate_accesscode(pin,comment,self.context.student_id):
1627                self.flash(_('You are not the owner of this access code.'))
1628                return
1629            self.context.clr_code = pin
1630        IWorkflowInfo(self.context).fireTransition('start_clearance')
1631        self.flash(_('Clearance process has been started.'))
1632        self.redirect(self.url(self.context,'cedit'))
1633        return
1634
1635class StudentClearanceEditFormPage(StudentClearanceManageFormPage):
1636    """ View to edit student clearance data by student
1637    """
1638    grok.context(IStudent)
1639    grok.name('cedit')
1640    grok.require('waeup.handleStudent')
1641    label = _('Edit clearance data')
1642
1643    @property
1644    def form_fields(self):
1645        cm = getattr(self.context,'current_mode', None)
1646        if cm is not None and cm.startswith('pg'):
1647            form_fields = grok.AutoFields(IPGStudentClearance).omit('clearance_locked')
1648        else:
1649            form_fields = grok.AutoFields(IUGStudentClearance).omit('clearance_locked')
1650        return form_fields
1651
1652    def update(self):
1653        if self.context.clearance_locked:
1654            emit_lock_message(self)
1655            return
1656        return super(StudentClearanceEditFormPage, self).update()
1657
1658    @action(_('Save'), style='primary')
1659    def save(self, **data):
1660        self.applyData(self.context, **data)
1661        self.flash(_('Clearance form has been saved.'))
1662        return
1663
1664    def dataNotComplete(self):
1665        """To be implemented in the customization package.
1666        """
1667        return False
1668
1669    @action(_('Save and request clearance'), style='primary')
1670    def requestClearance(self, **data):
1671        self.applyData(self.context, **data)
1672        if self.dataNotComplete():
1673            self.flash(self.dataNotComplete())
1674            return
1675        self.flash(_('Clearance form has been saved.'))
1676        self.redirect(self.url(self.context,'request_clearance'))
1677        return
1678
1679class RequestClearancePage(KofaPage):
1680    grok.context(IStudent)
1681    grok.name('request_clearance')
1682    grok.require('waeup.handleStudent')
1683    grok.template('enterpin')
1684    label = _('Request clearance')
1685    notice = _('Enter the CLR access code used for starting clearance.')
1686    ac_prefix = 'CLR'
1687    pnav = 4
1688    buttonname = _('Request clearance now')
1689
1690    def update(self, SUBMIT=None):
1691        self.ac_series = self.request.form.get('ac_series', None)
1692        self.ac_number = self.request.form.get('ac_number', None)
1693        if SUBMIT is None:
1694            return
1695        pin = '%s-%s-%s' % (self.ac_prefix, self.ac_series, self.ac_number)
1696        if self.context.clr_code != pin:
1697            self.flash(_("This isn't your CLR access code."))
1698            return
1699        state = IWorkflowState(self.context).getState()
1700        # This shouldn't happen, but the application officer
1701        # might have forgotten to lock the form after changing the state
1702        if state != CLEARANCE:
1703            self.flash(_('This form cannot be submitted. Wrong state!'))
1704            return
1705        IWorkflowInfo(self.context).fireTransition('request_clearance')
1706        self.flash(_('Clearance has been requested.'))
1707        self.redirect(self.url(self.context))
1708        return
1709
1710class StartCourseRegistrationPage(KofaPage):
1711    grok.context(IStudentStudyCourse)
1712    grok.name('start_course_registration')
1713    grok.require('waeup.handleStudent')
1714    grok.template('enterpin')
1715    label = _('Start course registration')
1716    ac_prefix = 'SFE'
1717    notice = ''
1718    pnav = 4
1719    buttonname = _('Start course registration now')
1720
1721    def update(self, SUBMIT=None):
1722        if not self.context.getStudent().state in (CLEARED,RETURNING):
1723            self.flash(_("Wrong state"))
1724            self.redirect(self.url(self.context))
1725            return
1726        self.ac_series = self.request.form.get('ac_series', None)
1727        self.ac_number = self.request.form.get('ac_number', None)
1728
1729        if SUBMIT is None:
1730            return
1731        pin = '%s-%s-%s' % (self.ac_prefix, self.ac_series, self.ac_number)
1732        code = get_access_code(pin)
1733        if not code:
1734            self.flash(_('Activation code is invalid.'))
1735            return
1736        # Mark pin as used (this also fires a pin related transition)
1737        # and fire transition start_clearance
1738        if code.state == USED:
1739            self.flash(_('Activation code has already been used.'))
1740            return
1741        else:
1742            comment = _(u"invalidated")
1743            # Here we know that the ac is in state initialized so we do not
1744            # expect an exception, but the owner might be different
1745            if not invalidate_accesscode(
1746                pin,comment,self.context.getStudent().student_id):
1747                self.flash(_('You are not the owner of this access code.'))
1748                return
1749        if self.context.getStudent().state == CLEARED:
1750            IWorkflowInfo(self.context.getStudent()).fireTransition(
1751                'pay_first_school_fee')
1752        elif self.context.getStudent().state == RETURNING:
1753            IWorkflowInfo(self.context.getStudent()).fireTransition(
1754                'pay_school_fee')
1755        self.flash(_('Course registration has been started.'))
1756        self.redirect(self.url(self.context))
1757        return
1758
1759class AddStudyLevelFormPage(KofaEditFormPage):
1760    """ Page for students to add current study levels
1761    """
1762    grok.context(IStudentStudyCourse)
1763    grok.name('add')
1764    grok.require('waeup.handleStudent')
1765    grok.template('studyleveladdpage')
1766    form_fields = grok.AutoFields(IStudentStudyCourse)
1767    pnav = 4
1768
1769    @property
1770    def label(self):
1771        studylevelsource = StudyLevelSource().factory
1772        code = self.context.current_level
1773        title = studylevelsource.getTitle(self.context, code)
1774        return _('Add current level ${a}', mapping = {'a':title})
1775
1776    def update(self):
1777        if self.context.getStudent().state != PAID:
1778            emit_lock_message(self)
1779            return
1780        super(AddStudyLevelFormPage, self).update()
1781        return
1782
1783    @action(_('Create course list now'), style='primary')
1784    def addStudyLevel(self, **data):
1785        studylevel = StudentStudyLevel()
1786        studylevel.level = self.context.current_level
1787        studylevel.level_session = self.context.current_session
1788        try:
1789            self.context.addStudentStudyLevel(
1790                self.context.certificate,studylevel)
1791        except KeyError:
1792            self.flash(_('This level exists.'))
1793        self.redirect(self.url(self.context))
1794        return
1795
1796class StudyLevelEditFormPage(KofaEditFormPage):
1797    """ Page to edit the student study level data by students
1798    """
1799    grok.context(IStudentStudyLevel)
1800    grok.name('edit')
1801    grok.require('waeup.handleStudent')
1802    grok.template('studyleveleditpage')
1803    form_fields = grok.AutoFields(IStudentStudyLevel).omit(
1804        'level_session', 'level_verdict')
1805    pnav = 4
1806
1807    def update(self):
1808        if self.context.getStudent().state != PAID:
1809            emit_lock_message(self)
1810            return
1811        super(StudyLevelEditFormPage, self).update()
1812        datatable.need()
1813        warning.need()
1814        return
1815
1816    @property
1817    def label(self):
1818        # Here we know that the cookie has been set
1819        lang = self.request.cookies.get('kofa.language')
1820        level_title = translate(self.context.level_title, 'waeup.kofa',
1821            target_language=lang)
1822        return _('Add and remove course tickets of study level ${a}',
1823            mapping = {'a':level_title})
1824
1825    @property
1826    def total_credits(self):
1827        total_credits = 0
1828        for key, val in self.context.items():
1829            total_credits += val.credits
1830        return total_credits
1831
1832    @action(_('Add course ticket'))
1833    def addCourseTicket(self, **data):
1834        self.redirect(self.url(self.context, 'ctadd'))
1835
1836    @jsaction(_('Remove selected tickets'))
1837    def delCourseTicket(self, **data):
1838        form = self.request.form
1839        if form.has_key('val_id'):
1840            child_id = form['val_id']
1841        else:
1842            self.flash(_('No ticket selected.'))
1843            self.redirect(self.url(self.context, '@@edit'))
1844            return
1845        if not isinstance(child_id, list):
1846            child_id = [child_id]
1847        deleted = []
1848        for id in child_id:
1849            # Students are not allowed to remove core tickets
1850            if not self.context[id].mandatory:
1851                del self.context[id]
1852                deleted.append(id)
1853        if len(deleted):
1854            self.flash(_('Successfully removed: ${a}',
1855                mapping = {'a':', '.join(deleted)}))
1856        self.redirect(self.url(self.context, u'@@edit'))
1857        return
1858
1859    @action(_('Register course list'), style='primary')
1860    def RegisterCourses(self, **data):
1861        IWorkflowInfo(self.context.getStudent()).fireTransition(
1862            'register_courses')
1863        self.flash(_('Course list has been registered.'))
1864        self.redirect(self.url(self.context))
1865        return
1866
1867class CourseTicketAddFormPage2(CourseTicketAddFormPage):
1868    """Add a course ticket by student.
1869    """
1870    grok.name('ctadd')
1871    grok.require('waeup.handleStudent')
1872    form_fields = grok.AutoFields(ICourseTicketAdd).omit(
1873        'score', 'mandatory', 'automatic', 'carry_over')
1874
1875    def update(self):
1876        if self.context.getStudent().state != PAID:
1877            emit_lock_message(self)
1878            return
1879        super(CourseTicketAddFormPage2, self).update()
1880        return
1881
1882    @action(_('Add course ticket'))
1883    def addCourseTicket(self, **data):
1884        # Safety belt
1885        if self.context.getStudent().state != PAID:
1886            return
1887        ticket = CourseTicket()
1888        course = data['course']
1889        for name in ['code', 'title', 'credits', 'passmark', 'semester']:
1890            setattr(ticket, name, getattr(course, name))
1891        ticket.automatic = False
1892        try:
1893            self.context.addCourseTicket(ticket)
1894        except KeyError:
1895            self.flash(_('The ticket exists.'))
1896            return
1897        self.flash(_('Successfully added ${a}.',
1898            mapping = {'a':ticket.code}))
1899        self.redirect(self.url(self.context, u'@@edit'))
1900        return
1901
1902class ChangePasswordRequestPage(KofaForm):
1903    """Captcha'd page for students to request a password change.
1904    """
1905    grok.context(IUniversity)
1906    grok.name('sendpw')
1907    grok.require('waeup.Anonymous')
1908    grok.template('sendpassword')
1909    label = _('Send me a new password')
1910    form_fields = grok.AutoFields(IStudentChangePassword)
1911
1912    def update(self):
1913        # Handle captcha
1914        self.captcha = getUtility(ICaptchaManager).getCaptcha()
1915        self.captcha_result = self.captcha.verify(self.request)
1916        self.captcha_code = self.captcha.display(self.captcha_result.error_code)
1917        return
1918
1919    @action(_('Get new login credentials'), style='primary')
1920    def request(self, **data):
1921        if not self.captcha_result.is_valid:
1922            # Captcha will display error messages automatically.
1923            # No need to flash something.
1924            return
1925        # Search student or applicant
1926        reg_number = data['reg_number']
1927        email = data['email']
1928        cat = queryUtility(ICatalog, name='students_catalog')
1929        results = cat.searchResults(
1930            reg_number=(reg_number, reg_number),
1931            email=(email,email))
1932        if len(results) == 0:
1933            # Try also the applicants_catalog if no student record was found.
1934            cat = queryUtility(ICatalog, name='applicants_catalog')
1935            if cat is None:
1936                self.flash(_('Application package not installed.'))
1937                return
1938            results = cat.searchResults(
1939                reg_number=(reg_number, reg_number),
1940                email=(email,email))
1941        if len(results) == 0:
1942            self.flash(_('No record found.'))
1943            return
1944        student = list(results)[0]
1945        # Change password
1946        kofa_utils = getUtility(IKofaUtils)
1947        pwd = kofa_utils.genPassword()
1948        IUserAccount(student).setPassword(pwd)
1949        # Send email with new redentials
1950        msg = _('You have successfully changed your password for the')
1951        login_url = self.url(grok.getSite(), 'login')
1952        success = kofa_utils.sendCredentials(
1953            IUserAccount(student),pwd,login_url,msg)
1954        if success:
1955            self.flash(_('An email with your user name and password ' +
1956                'has been sent to ${a}.', mapping = {'a':email}))
1957        else:
1958            self.flash(_('An smtp server error occurred.'))
1959        return
1960
1961class SetPasswordPage(KofaPage):
1962    grok.context(IKofaObject)
1963    grok.name('setpassword')
1964    grok.require('waeup.Anonymous')
1965    grok.template('setpassword')
1966    label = _('Set password for first-time login')
1967    ac_prefix = 'PWD'
1968    pnav = 0
1969    set_button = _('Set')
1970
1971    def update(self, SUBMIT=None):
1972        self.reg_number = self.request.form.get('reg_number', None)
1973        self.ac_series = self.request.form.get('ac_series', None)
1974        self.ac_number = self.request.form.get('ac_number', None)
1975
1976        if SUBMIT is None:
1977            return
1978        hitlist = search(query=self.reg_number,
1979            searchtype='reg_number', view=self)
1980        if not hitlist:
1981            self.flash(_('No student found.'))
1982            return
1983        if len(hitlist) != 1:   # Cannot happen but anyway
1984            self.flash(_('More than one student found.'))
1985            return
1986        student = hitlist[0].context
1987        self.student_id = student.student_id
1988        student_pw = student.password
1989        pin = '%s-%s-%s' % (self.ac_prefix, self.ac_series, self.ac_number)
1990        code = get_access_code(pin)
1991        if not code:
1992            self.flash(_('Access code is invalid.'))
1993            return
1994        if student_pw and pin == student.adm_code:
1995            self.flash(_(
1996                'Password has already been set. Your Student Id is ${a}',
1997                mapping = {'a':self.student_id}))
1998            return
1999        elif student_pw:
2000            self.flash(
2001                _('Password has already been set. You are using the ' +
2002                'wrong Access Code.'))
2003            return
2004        # Mark pin as used (this also fires a pin related transition)
2005        # and set student password
2006        if code.state == USED:
2007            self.flash(_('Access code has already been used.'))
2008            return
2009        else:
2010            comment = _(u"invalidated")
2011            # Here we know that the ac is in state initialized so we do not
2012            # expect an exception
2013            invalidate_accesscode(pin,comment)
2014            IUserAccount(student).setPassword(self.ac_number)
2015            student.adm_code = pin
2016        self.flash(_('Password has been set. Your Student Id is ${a}',
2017            mapping = {'a':self.student_id}))
2018        return
Note: See TracBrowser for help on using the repository browser.