source: main/kofacustom.iuokada/trunk/src/kofacustom/iuokada/applicants/browser.py @ 17024

## $Id: browser.py 17024 2022-07-15 11:01:24Z henrik $
##
## Copyright (C) 2011 Uli Fouquet & Henrik Bettermann
## This program is free software; you can redistribute it and/or modify
## it under the terms of the GNU General Public License as published by
## the Free Software Foundation; either version 2 of the License, or
## (at your option) any later version.
##
## This program is distributed in the hope that it will be useful,
## but WITHOUT ANY WARRANTY; without even the implied warranty of
## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
## GNU General Public License for more details.
##
## You should have received a copy of the GNU General Public License
## along with this program; if not, write to the Free Software
## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
##
"""UI components for basic applicants and related components.
"""
import grok
import os
from zope.component import getUtility, queryUtility
from zope.catalog.interfaces import ICatalog
from zope.formlib.textwidgets import BytesDisplayWidget
from waeup.kofa.interfaces import (
    IExtFileStore, IFileStoreNameChooser)
from waeup.kofa.utils.helpers import string_from_bytes, file_size, now
from waeup.kofa.applicants.browser import (
    ApplicantRegistrationPage, ApplicantsContainerPage, AdditionalFile,
    RefereeReportAddFormPage, ExportPDFReportSlipPage, ExportPDFReportSlipPage2,
    RefereeReportDisplayFormPage,
    ApplicantsContainerManageFormPage,
    ApplicantAddFormPage,
    ApplicantsRootPage)
from waeup.kofa.applicants.interfaces import (
    ISpecialApplicant, IApplicantsContainer, AppCatCertificateSource)
from kofacustom.nigeria.applicants.browser import (
    NigeriaApplicantDisplayFormPage,
    NigeriaApplicantManageFormPage,
    NigeriaApplicantEditFormPage,
    NigeriaPDFApplicationSlip)
from waeup.kofa.widgets.datewidget import (
    FriendlyDateDisplayWidget,
    FriendlyDatetimeDisplayWidget)
from kofacustom.nigeria.applicants.interfaces import (
    OMIT_DISPLAY_FIELDS,
    #UG_OMIT_DISPLAY_FIELDS,
    #UG_OMIT_PDF_FIELDS,
    #UG_OMIT_MANAGE_FIELDS,
    #UG_OMIT_EDIT_FIELDS,
    #PG_OMIT_DISPLAY_FIELDS,
    #PG_OMIT_PDF_FIELDS,
    #PG_OMIT_MANAGE_FIELDS,
    #PG_OMIT_EDIT_FIELDS,
    )
from kofacustom.iuokada.applicants.interfaces import (
    ICustomPGApplicant, ICustomUGApplicant, ICustomApplicant,
    ICustomPGApplicantEdit, ICustomUGApplicantEdit,
    ICustomApplicantOnlinePayment, ICustomApplicantRefereeReport,
    ITranscriptApplicant, ICustomApplicantRegisterUpdate
    )
from kofacustom.iuokada.interfaces import MessageFactory as _

MAX_FILE_UPLOAD_SIZE = 1024 * 500

# UG students are all undergraduate students.
UG_OMIT_DISPLAY_FIELDS = OMIT_DISPLAY_FIELDS + (
    #'jamb_subjects_list',
    'programme_type',)
UG_OMIT_PDF_FIELDS = UG_OMIT_DISPLAY_FIELDS + ('phone',)
UG_OMIT_MANAGE_FIELDS = (
    'special_application',
    #'jamb_subjects_list',
    'programme_type',
    'course1',
    'course2',)
UG_OMIT_EDIT_FIELDS = UG_OMIT_MANAGE_FIELDS + OMIT_DISPLAY_FIELDS + (
    'student_id',
    'notice',
    'screening_score',
    'screening_venue',
    'screening_date',
    #'jamb_age',
    #'jamb_subjects',
    #'jamb_score',
    #'jamb_reg_number',
    'aggregate',
    )

JUPEB_OMIT_FIELDS = (
    'jamb_age',
    'jamb_subjects',
    'jamb_score',
    'jamb_reg_number',
    'jamb_subjects_list',
    'jamb_fname',
    )

# PG has its own interface
PG_OMIT_DISPLAY_FIELDS = OMIT_DISPLAY_FIELDS + (
    'employer',
    'emp_position',
    'emp_start',
    'emp_end',
    'emp_reason',
    'employer2',
    'emp2_position',
    'emp2_start',
    'emp2_end',
    'emp2_reason',
    )
PG_OMIT_PDF_FIELDS = PG_OMIT_DISPLAY_FIELDS + ('phone',)
PG_OMIT_MANAGE_FIELDS = (
    'special_application',
    'employer',
    'emp_position',
    'emp_start',
    'emp_end',
    'emp_reason',
    'employer2',
    'emp2_position',
    'emp2_start',
    'emp2_end',
    'emp2_reason',
    'course1',
    'course2',
    )
PG_OMIT_EDIT_FIELDS = PG_OMIT_MANAGE_FIELDS + PG_OMIT_DISPLAY_FIELDS + (
    'student_id',
    'notice',
    'screening_score',
    'screening_venue',
    'screening_date',)

TRANS_OMIT_FIELDS = ('suspended', 'applicant_id',)

TRANS_SHORT_OMIT_FIELDS = TRANS_OMIT_FIELDS + (
    #'date_of_birth',
    'sex',
    'nationality',
    #'entry_mode',
    #'entry_session',
    'end_session',
    #'course_studied',
    #'course_changed',
    #'change_level',
    )

class CustomApplicantsRootPage(ApplicantsRootPage):
    
    grok.template('applicantsrootpage')

class CustomApplicantsContainerPage(ApplicantsContainerPage):
    """The standard view for regular applicant containers.
    """

    @property
    def form_fields(self):
        form_fields = grok.AutoFields(IApplicantsContainer).omit(
            'title', 'description')
        if self.request.principal.id == 'zope.anybody':
            form_fields = form_fields.omit(
                'code', 'prefix', 'year', 'mode', 'hidden',
                'strict_deadline', 'application_category',
                'application_slip_notice',
                'application_fee', 'with_picture',
                'startdate', 'enddate')
        return form_fields

class CustomApplicantsContainerManageFormPage(ApplicantsContainerManageFormPage):

    max_applicants = 3000

class CustomApplicantDisplayFormPage(NigeriaApplicantDisplayFormPage):
    """A display view for applicant data.
    """

    @property
    def form_fields(self):
        if self.target is not None and self.target == 'tscf':
            form_fields = grok.AutoFields(ITranscriptApplicant)
            for field in TRANS_OMIT_FIELDS:
                form_fields = form_fields.omit(field)
            form_fields['dispatch_address'].custom_widget = BytesDisplayWidget
            #form_fields['perm_address'].custom_widget = BytesDisplayWidget
            return form_fields
        if self.target is not None and self.target == 'tscs':
            form_fields = grok.AutoFields(ITranscriptApplicant)
            for field in TRANS_SHORT_OMIT_FIELDS:
                form_fields = form_fields.omit(field)
            form_fields['dispatch_address'].custom_widget = BytesDisplayWidget
            #form_fields['perm_address'].custom_widget = BytesDisplayWidget
            return form_fields
        if self.target is not None and self.target.startswith('pg'):
            form_fields = grok.AutoFields(ICustomPGApplicant)
            for field in PG_OMIT_DISPLAY_FIELDS:
                form_fields = form_fields.omit(field)
        else:
            form_fields = grok.AutoFields(ICustomUGApplicant)
            for field in UG_OMIT_DISPLAY_FIELDS:
                form_fields = form_fields.omit(field)
        if self.target is not None and self.target == 'pre':
            for field in JUPEB_OMIT_FIELDS:
                form_fields = form_fields.omit(field)
        #form_fields['perm_address'].custom_widget = BytesDisplayWidget
        form_fields['notice'].custom_widget = BytesDisplayWidget
        if not getattr(self.context, 'student_id'):
            form_fields = form_fields.omit('student_id')
        if not getattr(self.context, 'screening_score'):
            form_fields = form_fields.omit('screening_score')
        if not getattr(self.context, 'screening_venue') or self._not_paid():
            form_fields = form_fields.omit('screening_venue')
        if not getattr(self.context, 'screening_date') or self._not_paid():
            form_fields = form_fields.omit('screening_date')
        return form_fields

def getCerts(view, coursex):
    yield(dict(code='', title='--', selected=''))
    appcatcertificatesource = AppCatCertificateSource().factory
    for cert in appcatcertificatesource.getValues(view.context):
        selected = ''
        course = getattr(view.context, coursex)
        if course is not None and course.code == cert.code:
            selected = 'selected'
        title = appcatcertificatesource.getTitle(view.context, cert)
        yield(dict(code=cert.code, title=title, selected=selected))

def saveCourses(view):
    """In custom packages we needed to customize the certificate
    select widget. We just save course1 and course2 if these customized
    fields appear in the form.
    """
    changed_courses = []
    form = view.request.form
    course1 = form.get('custom.course1', None)
    if not course1:
        return 'Please select your 1st Choice Course of Study.', None
    cat = queryUtility(ICatalog, name='certificates_catalog')
    results = list(
        cat.searchResults(code=(course1, course1)))
    new_course1 = results[0]
    old_course1 = view.context.course1
    if old_course1 != new_course1:
        view.context.course1 = new_course1
        changed_courses.append('course1')
    new_course2 = None
    old_course2 = view.context.course2
    course2 = form.get('custom.course2', None)
    if course2:
        results = list(
            cat.searchResults(code=(course2, course2)))
        new_course2 = results[0]
    if old_course2 != new_course2:
        view.context.course2 = new_course2
        changed_courses.append('course2')
    return None, changed_courses

def display_fileupload(view, filename):
    if view.target.startswith('tsc'):
        return False
    if filename[1] == 'res_stat.pdf':
        if view.context.subtype != 'transfer':
            return False
    if filename[1] == 'jamb.pdf' \
        and view.target is not None \
        and view.target.startswith('pg'):
        return False
    if filename[1] == 'nysc.pdf' \
        and view.target is not None \
        and not view.target.startswith('pg'):
        return False
    return True

class CustomApplicantManageFormPage(NigeriaApplicantManageFormPage):
    """A full edit view for applicant data.
    """

    def getCerts(self, coursex):
        return getCerts(self, coursex)

    def saveCourses(self):
        return saveCourses(self)

    def display_fileupload(self, filename):
        return display_fileupload(self, filename)

    @property
    def display_refereereports(self):
        if self.context.refereereports:
            return True
        return False

    @property
    def form_fields(self):
        self.course_selector = False
        if self.target is not None and self.target == 'tscf':
            form_fields = grok.AutoFields(ITranscriptApplicant)
            for field in TRANS_OMIT_FIELDS:
                form_fields = form_fields.omit(field)
            return form_fields
        if self.target is not None and self.target == 'tscs':
            form_fields = grok.AutoFields(ITranscriptApplicant)
            for field in TRANS_SHORT_OMIT_FIELDS:
                form_fields = form_fields.omit(field)
            return form_fields
        self.course_selector = True
        if self.target is not None and self.target.startswith('pg'):
            form_fields = grok.AutoFields(ICustomPGApplicant)
            for field in PG_OMIT_MANAGE_FIELDS:
                form_fields = form_fields.omit(field)
        else:
            form_fields = grok.AutoFields(ICustomUGApplicant)
            for field in UG_OMIT_MANAGE_FIELDS:
                form_fields = form_fields.omit(field)
        if self.target is not None and self.target == 'pre':
            for field in JUPEB_OMIT_FIELDS:
                form_fields = form_fields.omit(field)
        form_fields['student_id'].for_display = True
        form_fields['applicant_id'].for_display = True
        return form_fields

class CustomApplicantEditFormPage(NigeriaApplicantEditFormPage):
    """An applicant-centered edit view for applicant data.
    """

    def getCerts(self, coursex):
        return getCerts(self, coursex)

    def saveCourses(self):
        return saveCourses(self)

    def display_fileupload(self, filename):
        return display_fileupload(self, filename)

    @property
    def _finalsubmit_msg(self):
        if self.context.subtype in ('transfer', 'de'):
            return 'Form has been submitted. Please note: DE and Transfer applicants are to present their application form and the proof of JAMB local transfer form at the admissions office for application approval.'
        return _('Form has been submitted.')

    def dataNotComplete(self, data):
        store = getUtility(IExtFileStore)
        if self.context.subtype \
            and self.context.subtype not in ('transfer', 'de', 'jupeb') \
            and (not self.context.jamb_fname
                 or not self.context.jamb_reg_number):
            return _('JAMB fields must be filled.')
        if self.context.subtype in ('transfer', 'de') \
            and not self.context.ref_number:
            return _('Reference Number field must be filled.')
        if self.context.__parent__.with_picture:
            store = getUtility(IExtFileStore)
            if not store.getFileByContext(self.context, attr=u'passport.jpg'):
                return _('No passport picture uploaded.')
        if self.context.subtype == 'transfer' \
            and self.context.__parent__.code!= 'ug2020' \
            and not store.getFileByContext(self.context, attr=u'res_stat.pdf'):
            return _('No statement of result pdf file uploaded.')
        return False

    @property
    def form_fields(self):
        self.course_selector = False
        if self.target is not None and self.target == 'tscf':
            form_fields = grok.AutoFields(ITranscriptApplicant)
            for field in TRANS_OMIT_FIELDS:
                form_fields = form_fields.omit(field)
                form_fields = form_fields.omit('locked')
            return form_fields
        if self.target is not None and self.target == 'tscs':
            form_fields = grok.AutoFields(ITranscriptApplicant)
            for field in TRANS_SHORT_OMIT_FIELDS:
                form_fields = form_fields.omit(field)
                form_fields = form_fields.omit('locked')
            return form_fields
        self.course_selector = True
        if self.target is not None and self.target.startswith('pg'):
            form_fields = grok.AutoFields(ICustomPGApplicantEdit)
            for field in PG_OMIT_EDIT_FIELDS:
                form_fields = form_fields.omit(field)
        else:
            form_fields = grok.AutoFields(ICustomUGApplicantEdit)
            for field in UG_OMIT_EDIT_FIELDS:
                form_fields = form_fields.omit(field)
        if self.target is not None and self.target == 'pre':
            for field in JUPEB_OMIT_FIELDS:
                form_fields = form_fields.omit(field)
        form_fields['applicant_id'].for_display = True
        form_fields['reg_number'].for_display = True
        return form_fields

class CustomPDFApplicationSlip(NigeriaPDFApplicationSlip):

    @property
    def form_fields(self):
        if self.target is not None and self.target.startswith('pg'):
            form_fields = grok.AutoFields(ICustomPGApplicant)
            for field in PG_OMIT_PDF_FIELDS:
                form_fields = form_fields.omit(field)
        else:
            form_fields = grok.AutoFields(ICustomUGApplicant)
            for field in UG_OMIT_PDF_FIELDS:
                form_fields = form_fields.omit(field)
        if not getattr(self.context, 'student_id'):
            form_fields = form_fields.omit('student_id')
        if not getattr(self.context, 'screening_score'):
            form_fields = form_fields.omit('screening_score')
        if not getattr(self.context, 'screening_venue'):
            form_fields = form_fields.omit('screening_venue')
        if not getattr(self.context, 'screening_date'):
            form_fields = form_fields.omit('screening_date')
        return form_fields

class CustomApplicantRegistrationPage(ApplicantRegistrationPage):
    """Captcha'd registration page for applicants.
    """
    @property
    def form_fields(self):
        form_fields = None
        if self.context.mode == 'update':
            form_fields = grok.AutoFields(ICustomApplicantRegisterUpdate).select(
                'lastname','reg_number','email')
        else: #if self.context.mode == 'create':
            form_fields = grok.AutoFields(ICustomUGApplicant).select(
                'firstname', 'middlename', 'lastname', 'email', 'phone')
        return form_fields

class CustomApplicantAddFormPage(ApplicantAddFormPage):
    """Add-form to add an applicant.
    """
    form_fields = grok.AutoFields(ICustomApplicant).select(
        'firstname', 'middlename', 'lastname',
        'email', 'phone')

class RefereeReportAddFormPage(RefereeReportAddFormPage):
    """Add-form to add an referee report. This form
    is protected by a mandate.
    """
    form_fields = grok.AutoFields(
        ICustomApplicantRefereeReport).omit('creation_date')

class CustomRefereeReportDisplayFormPage(RefereeReportDisplayFormPage):
    """A display view for referee reports.
    """
    form_fields = grok.AutoFields(ICustomApplicantRefereeReport)
    form_fields[
        'creation_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')


class CustomExportPDFReportSlipPage(ExportPDFReportSlipPage):
    form_fields = grok.AutoFields(ICustomApplicantRefereeReport)
    form_fields[
        'creation_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')

class CustomExportPDFReportSlipPage2(ExportPDFReportSlipPage2):
    form_fields = grok.AutoFields(ICustomApplicantRefereeReport)
    form_fields[
        'creation_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')

class ResultStatement(AdditionalFile):
    grok.name('res_stat')

class JAMBResult(AdditionalFile):
    grok.name('jamb')

class FirstSitting(AdditionalFile):
    grok.name('fst_sit_scan')

class SecondSitting(AdditionalFile):
    grok.name('scd_sit_scan')

class HighQual(AdditionalFile):
    grok.name('hq_scan')

class AdvancedLevelResult(AdditionalFile):
    grok.name('alr_scan')

class NYSCCertificate(AdditionalFile):
    grok.name('nysc')

class PaymentReceipts(AdditionalFile):
    grok.name('rmp')