source: main/kofacustom.dspg/trunk/src/kofacustom/dspg/applicants/browser.py @ 16728

## $Id: browser.py 16726 2021-11-25 22:26:32Z 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
from zope.component import getUtility, queryUtility
from zope.i18n import translate
from hurry.workflow.interfaces import IWorkflowState
from waeup.kofa.widgets.datewidget import FriendlyDatetimeDisplayWidget
from zope.formlib.textwidgets import BytesDisplayWidget
from waeup.kofa.interfaces import IExtFileStore, IKofaUtils
from waeup.kofa.browser.pages import doll_up
from waeup.kofa.applicants.interfaces import (
    IApplicant, IApplicantEdit,
    IApplicantsContainer,)
from waeup.kofa.applicants.browser import (ApplicantDisplayFormPage,
    ApplicantManageFormPage, ApplicantEditFormPage,
    ApplicantsContainerPage, ApplicationFeePaymentAddPage,
    ExportJobContainerOverview,
    ExportJobContainerJobStart,
    ExportJobContainerDownload,
    ApplicantBaseDisplayFormPage)
from waeup.kofa.browser.viewlets import ManageActionButton
from waeup.kofa.applicants.viewlets import (
    PaymentReceiptActionButton, PDFActionButton)
from waeup.kofa.applicants.pdf import PDFApplicationSlip
from waeup.kofa.applicants.workflow import ADMITTED, PAID, STARTED
from waeup.kofa.students.interfaces import IStudentsUtils
from kofacustom.nigeria.applicants.interfaces import (
    UG_OMIT_DISPLAY_FIELDS,
    UG_OMIT_PDF_FIELDS,
    UG_OMIT_MANAGE_FIELDS,
    UG_OMIT_EDIT_FIELDS
    )
from kofacustom.nigeria.applicants.browser import (
    NigeriaExportPDFPaymentSlipPage)
from kofacustom.dspg.applicants.interfaces import (
    ICustomUGApplicant, ICustomUGApplicantEdit,
    ICustomSpecialApplicant,
    ICustomApplicantOnlinePayment,
    ICustomApplicant,
    ND_OMIT_DISPLAY_FIELDS,
    ND_OMIT_PDF_FIELDS,
    ND_OMIT_MANAGE_FIELDS,
    ND_OMIT_EDIT_FIELDS
    )

from kofacustom.dspg.interfaces import MessageFactory as _

UG_OMIT_EDIT_FIELDS = [
    value for value in UG_OMIT_EDIT_FIELDS
        if not value in ('jamb_subjects', 'jamb_score', 'jamb_reg_number')]

PRE_OMIT_EDIT_FIELDS = UG_OMIT_EDIT_FIELDS + [
    'firstname',
    'middlename',
    'lastname',
    #'sex',
    'jamb_score'
    ]

##### Bursary exports

class BursaryExportPaymentsActionButton(ManageActionButton):
    """ 'Export payment data' button for faculties.
    """
    grok.context(IApplicantsContainer)
    grok.view(ApplicantsContainerPage)
    grok.require('waeup.exportBursaryData')
    icon = 'actionicon_down.png'
    text = _('Export payment data')
    grok.order(4)

    @property
    def target_url(self):
        return self.view.url(self.view.context) + '/exports/bursary.html'

class BursaryExportJobContainerOverview(ExportJobContainerOverview):
    """Page that lists active applicant data export jobs and provides links
    to discard or download CSV files.
    """
    grok.require('waeup.exportBursaryData')
    grok.name('bursary.html')

    def update(self, CREATE=None, DISCARD=None, job_id=None):
        if CREATE:
            self.redirect(self.url('@@start_bursary_export'))
            return
        if DISCARD and job_id:
            entry = self.context.entry_from_job_id(job_id)
            self.context.delete_export_entry(entry)
            ob_class = self.__implemented__.__name__.replace('waeup.kofa.','')
            self.context.logger.info(
                '%s - discarded: job_id=%s' % (ob_class, job_id))
            self.flash(_('Discarded export') + ' %s' % job_id)
        self.entries = doll_up(self, user=self.request.principal.id)
        return

class  BursaryExportJobContainerJobStart(ExportJobContainerJobStart):
    """View that starts export job.
    """
    grok.require('waeup.exportBursaryData')
    grok.name('start_bursary_export')

    def update(self):
        utils = queryUtility(IKofaUtils)
        if not utils.expensive_actions_allowed():
            self.flash(_(
                "Currently, exporters cannot be started due to high "
                "system load. Please try again later."), type='danger')
            self.entries = doll_up(self, user=None)
            return

        ob_class = self.__implemented__.__name__.replace('waeup.kofa.','')
        container_code = self.context.__parent__.code
        # Start payments exporter
        exporter = 'applicantpayments'
        job_id = self.context.start_export_job(exporter,
                                      self.request.principal.id,
                                      container=container_code)
        self.context.logger.info(
            '%s - exported: %s (%s), job_id=%s'
            % (ob_class, exporter, container_code, job_id))

        self.flash(_('Exports started.'))
        self.redirect(self.url(self.context, 'bursary.html'))
        return

    def render(self):
        return

class BursaryExportJobContainerDownload(ExportJobContainerDownload):
    """Page that downloads a students export csv file.

    """
    grok.require('waeup.exportBursaryData')

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

    @property
    def form_fields(self):
        form_fields = super(CustomApplicantsContainerPage, self).form_fields
        if self.request.principal.id == 'zope.anybody':
            return form_fields.omit('application_fee')
        return form_fields

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

    @property
    def form_fields(self):
        if self.context.special:
            return grok.AutoFields(ICustomSpecialApplicant)
        if self.target in ('conv', 'hndfincl', 'ndfincl'):
            form_fields = grok.AutoFields(ICustomSpecialApplicant)
            form_fields = form_fields.omit(
                'special_application',
                'carryover_courses_1',
                'carryover_courses_2',
                'locked', 'suspended')
            return form_fields
        form_fields = grok.AutoFields(ICustomUGApplicant)
        if self.context.is_nd:
            for field in ND_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)
        form_fields['notice'].custom_widget = BytesDisplayWidget
        form_fields['jamb_subjects'].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'):
            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 CustomPDFApplicationSlip(PDFApplicationSlip):

    def _reduced_slip(self):
        return getattr(self.context, 'result_uploaded', False)

    @property
    def note(self):
        if self.context.special:
            return '''<br /><br />
Head of Department Signature:
'''
        note = getattr(self.context.__parent__, 'application_slip_notice', None)
        if note:
            return '<br /><br />' + note
        pronoun = 'S/he'
        if self.context.sex == 'm':
            pronoun = 'He'
        else:
            pronoun = 'She'
        return '''<br /><br />
The applicant has declared that:

a) %s is not a member of any secret cult and will not join any.
b) %s will not engage in any cult activities.
c) %s will not be involved in any acts of terrorism, rape, robbery, fighting, illegal gathering and
any activities that could disrupt peace on campus.
d) %s does not have and will not acquire any form of weapon, fire arms, gun knife or any weapon
that can cause damage to life and property.
e) %s will strive to be worthy in character and learning at all times.

The applicant has acknowledged that offences will automatically lead to the expulsion from the
Polytechnic and also be dealt with in accordance with the law of the land.

The applicant promises to abide by all the Rules and Regulations of the Polytechnic if offered
admission.
''' % (
    pronoun, pronoun, pronoun, pronoun, pronoun)

    @property
    def form_fields(self):
        if self.context.special:
            return grok.AutoFields(ICustomSpecialApplicant)
        if self.target in ('conv', 'hndfincl', 'ndfincl'):
            form_fields = grok.AutoFields(ICustomSpecialApplicant)
            form_fields = form_fields.omit(
                'special_application',
                'locked', 'suspended', 'applicant_id')
            if not self.context.carryover_courses_1:
                form_fields = form_fields.omit('carryover_courses_1')
            if not self.context.carryover_courses_2:
                form_fields = form_fields.omit('carryover_courses_2')
            return form_fields
        form_fields = grok.AutoFields(ICustomUGApplicant)
        if self.context.is_nd:
            for field in ND_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 CustomApplicantManageFormPage(ApplicantManageFormPage):
    """A full edit view for applicant data.
    """

    @property
    def form_fields(self):
        if self.context.special:
            form_fields = grok.AutoFields(ICustomSpecialApplicant)
            form_fields['applicant_id'].for_display = True
            return form_fields
        if self.target in ('conv', 'hndfincl', 'ndfincl'):
            form_fields = grok.AutoFields(ICustomSpecialApplicant)
            form_fields = form_fields.omit(
                'special_application',
                'carryover_courses_1',
                'carryover_courses_2',
                'locked', 'suspended')
            form_fields['applicant_id'].for_display = True
            return form_fields
        form_fields = grok.AutoFields(ICustomUGApplicant)
        if self.context.is_nd:
            for field in ND_OMIT_MANAGE_FIELDS:
                form_fields = form_fields.omit(field)
        else:
            for field in UG_OMIT_MANAGE_FIELDS:
                form_fields = form_fields.omit(field)
        form_fields['student_id'].for_display = True
        form_fields['applicant_id'].for_display = True
        return form_fields

    def setUpWidgets(self, ignore_request=False):
        super(CustomApplicantManageFormPage,self).setUpWidgets(ignore_request)
        if self.context.special:
            self.widgets['carryover_courses_1'].height = 3
            self.widgets['carryover_courses_2'].height = 3
        return

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

    def unremovable(self, ticket):
        return True

    @property
    def form_fields(self):
        if self.context.special:
            form_fields = grok.AutoFields(ICustomSpecialApplicant).omit(
                'locked', 'suspended')
            form_fields['applicant_id'].for_display = True
            return form_fields
        if self.target in ('conv', 'hndfincl', 'ndfincl'):
            form_fields = grok.AutoFields(ICustomSpecialApplicant)
            form_fields = form_fields.omit(
                'special_application',
                'carryover_courses_1',
                'carryover_courses_2',
                'locked', 'suspended')
            form_fields['applicant_id'].for_display = True
            return form_fields
        form_fields = grok.AutoFields(ICustomUGApplicantEdit)
        if self.context.is_nd:
            for field in ND_OMIT_EDIT_FIELDS:
                form_fields = form_fields.omit(field)
        elif self.target is not None and self.target.startswith('pre'):
            for field in PRE_OMIT_EDIT_FIELDS:
                form_fields = form_fields.omit(field)
        else:
            for field in UG_OMIT_EDIT_FIELDS:
                form_fields = form_fields.omit(field)
        form_fields['applicant_id'].for_display = True
        form_fields['reg_number'].for_display = True
        return form_fields

    def setUpWidgets(self, ignore_request=False):
        super(CustomApplicantEditFormPage,self).setUpWidgets(ignore_request)
        if self.context.special:
            self.widgets['carryover_courses_1'].height = 3
            self.widgets['carryover_courses_2'].height = 3
        return

    @property
    def display_actions(self):
        state = IWorkflowState(self.context).getState()
        # If the form is unlocked, applicants are allowed to save the form
        # and remove unused tickets.
        actions = [[_('Save')], []]
        # Only in state started they can also add tickets.
        if state == STARTED:
            actions = [[_('Save')],
                [_('Add online payment ticket'),]]
        # In state paid, they can submit the data and further add tickets
        # if the application is special.
        elif self.context.special and state == PAID:
            actions = [[_('Save'), _('Finally Submit')],
                [_('Add online payment ticket'),]]
        elif state == PAID:
            actions = [[_('Save'), _('Finally Submit')], []]
        return actions

class CustomApplicationFeePaymentAddPage(ApplicationFeePaymentAddPage):
    """ Page to add an online payment ticket
    """

    @property
    def custom_requirements(self):
        store = getUtility(IExtFileStore)
        if not store.getFileByContext(self.context, attr=u'passport.jpg') \
            and self.context.__parent__.with_picture:
            return _('Upload your passport photo before making payment.')
        return ''

class CustomApplicantBaseDisplayFormPage(ApplicantBaseDisplayFormPage):

    grok.context(ICustomApplicant)

    @property
    def form_fields(self):
        if self.context.__parent__.prefix in (
            'conv', 'special', 'hndfincl', 'ndfincl'):
            form_fields = grok.AutoFields(ICustomApplicant).select(
                'applicant_id', 'reg_number', 'email')
            form_fields['reg_number'].field.title = u'Identification Number'
            return form_fields
        form_fields = grok.AutoFields(ICustomApplicant).select(
            'applicant_id', 'reg_number', 'email', 'course1')
        return form_fields

class CustomExportPDFPaymentSlipPage(NigeriaExportPDFPaymentSlipPage):
    """Deliver a PDF slip of the context.
    """

    grok.context(ICustomApplicantOnlinePayment)

    @property
    def form_fields(self):
        form_fields = grok.AutoFields(ICustomApplicantOnlinePayment).omit(
            'ac', 'provider_amt', 'gateway_amt', 'thirdparty_amt', 'p_item',
            'p_split_data')
        form_fields['creation_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')
        form_fields['payment_date'].custom_widget = FriendlyDatetimeDisplayWidget('le')
        if self.context.__parent__.__parent__.prefix in (
            'conv', 'special', 'hndfincl', 'ndfincl'):
            form_fields = form_fields.omit('p_session')
        return form_fields

    def render(self):
        if self.payment_slip_download_warning:
            self.flash(self.payment_slip_download_warning, type='danger')
            self.redirect(self.url(self.context))
            return
        applicantview = CustomApplicantBaseDisplayFormPage(self.context.__parent__,
            self.request)
        students_utils = getUtility(IStudentsUtils)
        return students_utils.renderPDF(self,'payment_slip.pdf',
            self.context.__parent__, applicantview, note=self.note)