source: main/waeup.uniben/trunk/src/waeup/uniben/students/browser.py @ 13566

Last change on this file since 13566 was 13335, checked in by Henrik Bettermann, 9 years ago

Line break must be at the end of line0.

  • Property svn:keywords set to Id
File size: 20.8 KB
RevLine 
[8911]1## $Id: browser.py 13335 2015-10-16 17:49:33Z henrik $
2##
3## Copyright (C) 2012 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##
18import grok
19from zope.i18n import translate
[9210]20from zope.schema.interfaces import ConstraintNotSatisfied
[12856]21from zope.formlib.textwidgets import BytesDisplayWidget
[9380]22from zope.component import getUtility
[9281]23from hurry.workflow.interfaces import IWorkflowInfo
[11069]24from waeup.kofa.interfaces import (
25    REQUESTED, IExtFileStore, IKofaUtils, IObjectHistory)
[8911]26from waeup.kofa.widgets.datewidget import FriendlyDatetimeDisplayWidget
[12121]27from waeup.kofa.browser.layout import action, KofaEditFormPage, UtilityView
[9205]28from waeup.kofa.students.browser import (
[9686]29    StudyLevelEditFormPage, StudyLevelDisplayFormPage,
[13063]30    StudentBasePDFFormPage, ExportPDFCourseRegistrationSlip,
[10025]31    CourseTicketDisplayFormPage, StudentTriggerTransitionFormPage,
[11069]32    msave, emit_lock_message,
[13063]33    StudentActivateView, StudentDeactivateView,
34    ExportPDFTranscriptSlip)
[12845]35from waeup.kofa.students.workflow import (CREATED, ADMITTED, PAID,
36    CLEARANCE, REQUESTED, RETURNING, CLEARED, REGISTERED, VALIDATED,
37    GRADUATED, TRANSCRIPT, FORBIDDEN_POSTGRAD_TRANS)
[9686]38from waeup.kofa.students.interfaces import IStudentsUtils, ICourseTicket
[9251]39from waeup.kofa.students.workflow import FORBIDDEN_POSTGRAD_TRANS
[8911]40from kofacustom.nigeria.students.browser import (
41    NigeriaOnlinePaymentDisplayFormPage,
[9251]42    NigeriaStudentBaseManageFormPage,
[9380]43    NigeriaStudentClearanceEditFormPage,
[8911]44    NigeriaOnlinePaymentAddFormPage,
[13063]45    NigeriaExportPDFPaymentSlip,
46    NigeriaExportPDFClearanceSlip,
[13297]47    NigeriaExportPDFBedTicketSlip,
[12856]48    NigeriaStudentPersonalDisplayFormPage,
[13085]49    NigeriaStudentPersonalManageFormPage,
50    NigeriaStudentPersonalEditFormPage
[9281]51    )
[8911]52
[9210]53from waeup.uniben.students.interfaces import (
[12121]54    ICustomStudent,
[12856]55    ICustomStudentOnlinePayment,
56    ICustomStudentStudyCourse,
[11552]57    ICustomStudentStudyLevel,
58    ICustomUGStudentClearance,
[12856]59    ICustomPGStudentClearance,
[13085]60    ICustomStudentPersonal,
61    ICustomStudentPersonalEdit)
[9210]62from waeup.uniben.interfaces import MessageFactory as _
[8911]63
64class CustomOnlinePaymentDisplayFormPage(NigeriaOnlinePaymentDisplayFormPage):
65    """ Page to view an online payment ticket
66    """
67    grok.context(ICustomStudentOnlinePayment)
[9775]68    form_fields = grok.AutoFields(ICustomStudentOnlinePayment).omit(
[9993]69        'provider_amt', 'gateway_amt', 'thirdparty_amt', 'p_item')
[8911]70    form_fields[
71        'creation_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')
72    form_fields[
73        'payment_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')
74
[9380]75class CustomStudentClearanceEditFormPage(NigeriaStudentClearanceEditFormPage):
76    """ View to edit student clearance data by student
77    """
78
[11552]79    @property
80    def form_fields(self):
81        if self.context.is_postgrad:
82            form_fields = grok.AutoFields(ICustomPGStudentClearance).omit(
[12391]83            'clearance_locked', 'nysc_location', 'clr_code', 'officer_comment',
84            'physical_clearance_date')
[11552]85        else:
86            form_fields = grok.AutoFields(ICustomUGStudentClearance).omit(
[12391]87            'clearance_locked', 'clr_code', 'officer_comment',
88            'physical_clearance_date')
[11552]89            form_fields['date_of_birth'].for_display = True
90            form_fields['nationality'].for_display = True
91            form_fields['lga'].for_display = True
92        return form_fields
93
[9380]94    def dataNotComplete(self):
95        store = getUtility(IExtFileStore)
96        if not store.getFileByContext(self.context, attr=u'birth_certificate.jpg'):
97            return _('No birth certificate uploaded.')
98        if not store.getFileByContext(self.context, attr=u'ref_let.jpg'):
99            return _('No guarantor/referee letter uploaded.')
100        if not store.getFileByContext(self.context, attr=u'acc_let.jpg'):
101            return _('No acceptance letter uploaded.')
102        if not store.getFileByContext(self.context, attr=u'fst_sit_scan.jpg'):
103            return _('No first sitting result uploaded.')
[9395]104        #if not store.getFileByContext(self.context, attr=u'scd_sit_scan.jpg'):
105        #    return _('No second sitting result uploaded.')
[9380]106        if not store.getFileByContext(self.context, attr=u'secr_cults.jpg'):
[9848]107            return _('No affidavit of non-membership of secret cults uploaded.')
[9380]108        return False
109
[8911]110class CustomOnlinePaymentAddFormPage(NigeriaOnlinePaymentAddFormPage):
111    """ Page to add an online payment ticket
112    """
113    form_fields = grok.AutoFields(ICustomStudentOnlinePayment).select(
114        'p_category')
115
[13063]116class CustomExportPDFPaymentSlip(NigeriaExportPDFPaymentSlip):
[8911]117    """Deliver a PDF slip of the context.
118    """
119    grok.context(ICustomStudentOnlinePayment)
[9775]120    form_fields = grok.AutoFields(ICustomStudentOnlinePayment).omit(
[9993]121        'provider_amt', 'gateway_amt', 'thirdparty_amt', 'p_item')
[8911]122    form_fields['creation_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')
[9205]123    form_fields['payment_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')
124
125
[13063]126class CustomExportPDFClearanceSlip(NigeriaExportPDFClearanceSlip):
[9551]127    """Deliver a PDF slip of the context.
128    """
129
[13303]130    @property
131    def omit_fields(self):
132        omit_fields = ('password', 'suspended', 'suspended_comment',
[13309]133                       'phone', 'adm_code', 'email', 'date_of_birth')
[13303]134        if self.context.faccode == 'JUPEB':
135            omit_fields += ('faculty', 'department')
136        return omit_fields
[11537]137
[13299]138    @property
139    def label(self):
140        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
[13300]141        line0 = ''
142        if self.context.faccode == 'JUPEB':
[13335]143            line0 = 'Joint Universities Preliminary Examinations Board (JUPEB)\n'
[13300]144        line1 = translate(_('Clearance Slip of'),
[13299]145            'waeup.kofa', target_language=portal_language) \
146            + ' %s' % self.context.display_fullname
[13335]147        return '%s%s' % (line0, line1)
[13299]148
[12846]149    def _sigsInFooter(self):
[12845]150        isStudent = getattr(
151            self.request.principal, 'user_type', None) == 'student'
[12852]152        if not isStudent and self.context.state in (CLEARED, RETURNING):
[12846]153            return (_('Date, Student Signature'),
154                    _('Date, Clearance Officer Signature'),
155                    )
156        return ()
[12845]157
[9551]158    def render(self):
159        studentview = StudentBasePDFFormPage(self.context.student,
160            self.request, self.omit_fields)
161        students_utils = getUtility(IStudentsUtils)
162        return students_utils.renderPDF(
163            self, 'clearance_slip.pdf',
164            self.context.student, studentview, signatures=self._signatures(),
[10271]165            sigs_in_footer=self._sigsInFooter(), show_scans=False,
166            omit_fields=self.omit_fields)
[9551]167
[12121]168
[13063]169class ExportClearanceInvitationSlip(UtilityView, grok.View):
[12121]170    """Deliver an invitation letter to physical clearance.
171
172    This form page is available only in Uniben.
173    """
174    grok.context(ICustomStudent)
175    grok.name('clearance_invitation_slip.pdf')
176    grok.require('waeup.viewStudent')
177    prefix = 'form'
178
[12263]179    label = u'Invitation Letter for Physical Clearance'
[12121]180
181    omit_fields = (
182        'suspended', 'phone', 'email',
183        'adm_code', 'suspended_comment',
184        'date_of_birth', 'current_level',
[12150]185        'department', 'current_mode',
[12121]186        'entry_session', 'matric_number', 'sex')
187
188    form_fields = []
189
190    @property
191    def note(self):
192        if self.context.physical_clearance_date:
193            return """
[12147]194<br /><br /><br /><br /><font size='12'>
195Dear %s,
196<br /><br /><br />
[12264]197You are invited for your physical clearance on:
[12121]198<br /><br />
[12264]199<strong>%s</strong>.
200<br /><br />
[12265]201Please bring along this letter of invitation to the University Main Auditorium
[12147]202<br /><br />
[12263]203on your clearance date.
[12147]204<br /><br /><br />
[12263]205Signed,
[12147]206<br /><br />
207The Registrar<br />
[12121]208</font>
209
[12147]210""" % (self.context.display_fullname, self.context.physical_clearance_date)
[12121]211        return
212
[12122]213
214    def update(self):
215        if self.context.student.state != REQUESTED \
216            or not  self.context.student.physical_clearance_date:
217            self.flash(_('Forbidden'), type="warning")
218            self.redirect(self.url(self.context))
219
[12121]220    def render(self):
221        studentview = StudentBasePDFFormPage(self.context.student,
222            self.request, self.omit_fields)
223        students_utils = getUtility(IStudentsUtils)
224        return students_utils.renderPDF(
225            self, 'clearance_invitation_slip',
226            self.context.student, studentview,
227            omit_fields=self.omit_fields,
228            note=self.note)
229
[12856]230class CustomStudentPersonalDisplayFormPage(
231    NigeriaStudentPersonalDisplayFormPage):
232    """ Page to display student personal data
233    """
234
235    form_fields = grok.AutoFields(ICustomStudentPersonal)
236    form_fields['perm_address'].custom_widget = BytesDisplayWidget
237    form_fields['next_kin_address'].custom_widget = BytesDisplayWidget
238    form_fields[
239        'personal_updated'].custom_widget = FriendlyDatetimeDisplayWidget('le')
240
241class CustomStudentPersonalManageFormPage(
242    NigeriaStudentPersonalManageFormPage):
243    """ Page to manage personal data
244    """
245
246    form_fields = grok.AutoFields(ICustomStudentPersonal)
247    form_fields['personal_updated'].for_display = True
248    form_fields[
249        'personal_updated'].custom_widget = FriendlyDatetimeDisplayWidget('le')
250
[13085]251class CstomStudentPersonalEditFormPage(NigeriaStudentPersonalEditFormPage):
252    """ Page to edit personal data
253    """
254    form_fields = grok.AutoFields(
255        ICustomStudentPersonalEdit).omit('personal_updated')
256
[9210]257class StudyCourseCOEditFormPage(KofaEditFormPage):
[9281]258    """ Page to edit the student study course data by clearance officers.
[9210]259
260    This form page is available only in Uniben.
261    """
262    grok.context(ICustomStudentStudyCourse)
263    grok.name('edit_level')
264    grok.require('waeup.clearStudent')
265    label = _('Edit current level')
266    pnav = 4
267    form_fields = grok.AutoFields(
268        ICustomStudentStudyCourse).select('current_level')
269
270    def update(self):
271        if not (self.context.is_current and
272            self.context.student.state == REQUESTED):
273            emit_lock_message(self)
274            return
275        super(StudyCourseCOEditFormPage, self).update()
276        return
277
278    @action(_('Save'), style='primary')
279    def save(self, **data):
280        try:
281            msave(self, **data)
282        except ConstraintNotSatisfied:
283            # The selected level might not exist in certificate
284            self.flash(_('Current level not available for certificate.'))
285            return
286        #notify(grok.ObjectModifiedEvent(self.context.__parent__))
[9281]287        return
288
289class CustomStudyLevelEditFormPage(StudyLevelEditFormPage):
290    """ Page to edit the student study level data by students.
291
292    """
[9686]293    grok.template('studyleveleditpage')
[9281]294
[9686]295class CustomStudyLevelDisplayFormPage(StudyLevelDisplayFormPage):
296    """ Page to display student study levels
297    """
298    grok.template('studylevelpage')
299
[13063]300class CustomExportPDFCourseRegistrationSlip(
301    ExportPDFCourseRegistrationSlip):
[9686]302    """Deliver a PDF slip of the context.
303    """
304
[9921]305    form_fields = grok.AutoFields(ICustomStudentStudyLevel).omit(
[12879]306        'level_verdict', 'gpa', 'level')
[9921]307
[12855]308    def update(self):
309        if self.context.student.state != REGISTERED \
310            or self.context.student.current_level != self.context.level:
311            self.flash(_('Forbidden'), type="warning")
312            self.redirect(self.url(self.context))
313
[10441]314    @property
315    def tabletitle(self):
316        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
317        tabletitle = []
318        tabletitle.append(translate(_('1st Semester Courses'), 'waeup.kofa',
319            target_language=portal_language))
320        tabletitle.append(translate(_('2nd Semester Courses'), 'waeup.kofa',
321            target_language=portal_language))
322        tabletitle.append(translate(_('Level Courses'), 'waeup.kofa',
323            target_language=portal_language))
324        tabletitle.append(translate(_('1st Trimester Courses'), 'waeup.kofa',
325            target_language=portal_language))
326        tabletitle.append(translate(_('2nd Trimester Courses'), 'waeup.kofa',
327            target_language=portal_language))
328        tabletitle.append(translate(_('3rd Trimester Courses'), 'waeup.kofa',
329            target_language=portal_language))
330        return tabletitle
331
[9686]332    def render(self):
333        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
[9909]334        Code = translate('Code', 'waeup.kofa', target_language=portal_language)
335        Title = translate('Title', 'waeup.kofa', target_language=portal_language)
336        Dept = translate('Dept.', 'waeup.kofa', target_language=portal_language)
337        Faculty = translate('Faculty', 'waeup.kofa', target_language=portal_language)
338        Cred = translate(_('Credits'), 'waeup.uniben', target_language=portal_language)
[9686]339        studentview = StudentBasePDFFormPage(self.context.student,
340            self.request, self.omit_fields)
341        students_utils = getUtility(IStudentsUtils)
[10441]342
343        tabledata = []
344        tableheader = []
345        contenttitle = []
346        for i in range(1,7):
347            tabledata.append(sorted(
348                [value for value in self.context.values() if value.semester == i],
349                key=lambda value: str(value.semester) + value.code))
350            tableheader.append([(Code,'code', 2.5),
351                             (Title,'title', 5),
352                             (Dept,'dcode', 1.5), (Faculty,'fcode', 1.5),
353                             (Cred, 'credits', 1.5),
354                             ])
[9686]355        return students_utils.renderPDF(
356            self, 'course_registration_slip.pdf',
357            self.context.student, studentview,
[10441]358            tableheader=tableheader,
359            tabledata=tabledata,
[10271]360            omit_fields=self.omit_fields
[9908]361            )
[9848]362
[13063]363class UnibenExportPDFCourseResultSlip(ExportPDFCourseRegistrationSlip):
[9848]364    """Deliver a PDF slip of the context.
365    """
366
367    grok.name('course_result_slip.pdf')
368
369    @property
[10441]370    def tabletitle(self):
371        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
372        tabletitle = []
373        tabletitle.append(translate(_('1st Semester Courses'), 'waeup.kofa',
374            target_language=portal_language))
375        tabletitle.append(translate(_('2nd Semester Courses'), 'waeup.kofa',
376            target_language=portal_language))
377        tabletitle.append(translate(_('Level Courses'), 'waeup.kofa',
378            target_language=portal_language))
379        tabletitle.append(translate(_('1st Trimester Courses'), 'waeup.kofa',
380            target_language=portal_language))
381        tabletitle.append(translate(_('2nd Trimester Courses'), 'waeup.kofa',
382            target_language=portal_language))
383        tabletitle.append(translate(_('3rd Trimester Courses'), 'waeup.kofa',
384            target_language=portal_language))
385        return tabletitle
386
387    @property
[9848]388    def label(self):
389        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
390        lang = self.request.cookies.get('kofa.language', portal_language)
391        level_title = translate(self.context.level_title, 'waeup.kofa',
392            target_language=lang)
393        return translate(_('Course Result Slip'),
394            'waeup.uniben', target_language=portal_language) \
395            + ' %s' % level_title
396
397    def render(self):
398        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
[9909]399        Code = translate('Code', 'waeup.kofa', target_language=portal_language)
400        Title = translate('Title', 'waeup.kofa', target_language=portal_language)
401        Dept = translate('Dept.', 'waeup.kofa', target_language=portal_language)
402        Faculty = translate('Faculty', 'waeup.kofa', target_language=portal_language)
403        Cred = translate(_('Credits'), 'waeup.uniben', target_language=portal_language)
404        Grade = translate('Grade', 'waeup.kofa', target_language=portal_language)
[9848]405        studentview = StudentBasePDFFormPage(self.context.student,
406            self.request, self.omit_fields)
407        students_utils = getUtility(IStudentsUtils)
[10441]408
409        tabledata = []
410        tableheader = []
411        contenttitle = []
412        for i in range(1,7):
413            tabledata.append(sorted(
414                [value for value in self.context.values() if value.semester == i],
415                key=lambda value: str(value.semester) + value.code))
416            tableheader.append([(Code,'code', 2.5),
417                             (Title,'title', 5),
418                             (Dept,'dcode', 1.5), (Faculty,'fcode', 1.5),
419                             (Cred, 'credits', 1.5),
420                             (Grade, 'grade', 1.5),
421                             ])
[9908]422        return students_utils.renderPDF(
423            self, 'course_registration_slip.pdf',
424            self.context.student, studentview,
[10441]425            tableheader=tableheader,
426            tabledata=tabledata,
[10271]427            omit_fields=self.omit_fields
[9908]428            )
[9686]429
430class CustomCourseTicketDisplayFormPage(CourseTicketDisplayFormPage):
431    """ Page to display course tickets
432    """
433    form_fields = grok.AutoFields(ICourseTicket).omit('score')
[11069]434
[13063]435class CustomStudentActivateView(StudentActivateView):
[11069]436    """ Activate student account
437    """
438
439    def update(self):
440        self.context.suspended = False
441        self.context.writeLogMessage(self, 'account activated')
442        history = IObjectHistory(self.context)
443        history.addMessage('Student account activated', user='undisclosed')
444        self.flash(_('Student account has been activated.'))
445        self.redirect(self.url(self.context))
446        return
447
[13063]448class CustomStudentDeactivateView(StudentDeactivateView):
[11069]449    """ Deactivate student account
450    """
451    def update(self):
452        self.context.suspended = True
453        self.context.writeLogMessage(self, 'account deactivated')
454        history = IObjectHistory(self.context)
455        history.addMessage('Student account deactivated', user='undisclosed')
456        self.flash(_('Student account has been deactivated.'))
457        self.redirect(self.url(self.context))
458        return
[12845]459
[13063]460class CustomExportPDFTranscriptSlip(ExportPDFTranscriptSlip):
[12845]461    """Deliver a PDF slip of the context.
462    """
463
464    def _sigsInFooter(self):
465        return []
466        #return (_('CERTIFIED TRUE COPY'),)
467
468    def _signatures(self):
469        return ([(
470            'Current HD<br /> D. R. (Exams & Records)<br /> '
471            'For: Registrar')],)
472
473    def render(self):
474        portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
475        Term = translate(_('Term'), 'waeup.kofa', target_language=portal_language)
476        Code = translate(_('Code'), 'waeup.kofa', target_language=portal_language)
477        Title = translate(_('Title'), 'waeup.kofa', target_language=portal_language)
478        Cred = translate(_('Credits'), 'waeup.kofa', target_language=portal_language)
479        #Score = translate(_('Score'), 'waeup.kofa', target_language=portal_language)
480        Grade = translate(_('Grade'), 'waeup.kofa', target_language=portal_language)
481        studentview = StudentBasePDFFormPage(self.context.student,
482            self.request, self.omit_fields)
483        students_utils = getUtility(IStudentsUtils)
484
485        tableheader = [(Code,'code', 2.5),
486                         (Title,'title', 8.5),
487                         (Term, 'semester', 1.5),
488                         (Cred, 'credits', 1.5),
489                         #(Score, 'score', 1.5),
490                         (Grade, 'grade', 1.5),
491                         ]
492
493        return students_utils.renderPDFTranscript(
494            self, 'transcript.pdf',
495            self.context.student, studentview,
496            omit_fields=self.omit_fields,
497            tableheader=tableheader,
498            signatures=self._signatures(),
499            sigs_in_footer=self._sigsInFooter(),
[13297]500            )
501
502class CustomExportPDFBedTicketSlip(NigeriaExportPDFBedTicketSlip):
503    """Deliver a PDF slip of the context.
504    """
505
[13317]506    omit_fields = ('password', 'suspended', 'suspended_comment',
507        'phone', 'adm_code', 'email', 'date_of_birth')
[13297]508
509    def render(self):
510        studentview = StudentBasePDFFormPage(self.context.student,
511            self.request, self.omit_fields)
512        students_utils = getUtility(IStudentsUtils)
513
514        note = """
[13328]515<br /><br /><br /><br /><br /><font size="14">
516Please endeavour to pay your hostel maintenance charge within <br /><br />
5174 days of being allocated a space or else you are deemed to have <br /><br />
518voluntarily forfeited it and it goes back into circulation to be <br /><br />
519available for booking afresh!</font>
520"""
[13297]521
522        return students_utils.renderPDF(
523            self, 'bed_allocation_slip.pdf',
524            self.context.student, studentview,
525            omit_fields=self.omit_fields,
526            note=note)
Note: See TracBrowser for help on using the repository browser.