source: main/waeup.kofa/trunk/src/waeup/kofa/students/fileviewlets.py @ 18076

## $Id: fileviewlets.py 18076 2025-05-18 16:27:41Z henrik $
##
## Copyright (C) 2014 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
##

import os
import grok
from zope.component import getUtility
from waeup.kofa.interfaces import MessageFactory as _
from waeup.kofa.interfaces import (
    IExtFileStore, IFileStoreNameChooser, IKofaObject, IKofaUtils)
from waeup.kofa.utils.helpers import string_from_bytes, file_size

from waeup.kofa.students.interfaces import IStudent, IStudentsUtils

from waeup.kofa.browser.fileviewlets import (
    FileDisplay, FileUpload, Image)

from waeup.kofa.browser.layout import (
    default_filedisplay_template,
    default_fileupload_template)

from waeup.kofa.students.browser import (
    StudentBaseDisplayFormPage, StudentBaseManageFormPage,
    StudentClearanceDisplayFormPage, StudentClearanceManageFormPage,
    ExportPDFClearanceSlip, StudentFilesUploadPage, StudentSignatureUploadPage,
    StudentFinalClearanceUploadPage)

grok.context(IKofaObject) # Make IKofaObject the default context
grok.templatedir('browser_templates')

# File viewlet baseclasses for student base page

class StudentFileDisplay(FileDisplay):
    """Base file display viewlet.
    """
    grok.baseclass()
    grok.context(IStudent)
    grok.view(StudentClearanceDisplayFormPage)
    grok.order(1)
    grok.require('waeup.viewStudent')


class StudentFileUpload(FileUpload):
    """Base upload viewlet.
    """
    grok.baseclass()
    grok.context(IStudent)
    grok.view(StudentClearanceManageFormPage)
    grok.require('waeup.uploadStudentFile')

    @property
    def mus(self):
        students_utils = getUtility(IStudentsUtils)
        return 1024 * students_utils.MAX_KB

    @property
    def show_viewlet(self):
        students_utils = getUtility(IStudentsUtils)
        if self.__name__ in students_utils.SKIP_UPLOAD_VIEWLETS:
            return False
        return True


class StudentImage(Image):
    """Renders images for students.
    """
    grok.baseclass()
    grok.context(IStudent)
    grok.require('waeup.viewStudent')

    @property
    def add_id(self):
        return self.context.student_id

# File viewlets for student base and clearance page

class PassportDisplay(StudentFileDisplay):
    """Passport display viewlet.
    """
    grok.order(1)
    grok.context(IStudent)
    grok.view(StudentBaseDisplayFormPage)
    grok.require('waeup.viewStudent')
    grok.template('imagedisplay')
    label = _(u'Passport Picture')
    download_name = u'passport.jpg'


class PassportUploadManage(StudentFileUpload):
    """Passport upload viewlet for officers.
    """
    grok.order(1)
    grok.context(IStudent)
    grok.view(StudentBaseManageFormPage)
    grok.require('waeup.manageStudent')
    grok.template('imageupload')
    label = _(u'Passport Picture (jpg only)')
    download_name = u'passport.jpg'
    tab_redirect = '#tab2'

    @property
    def mus(self):
        kofa_utils = getUtility(IKofaUtils)
        return kofa_utils.MAX_PASSPORT_SIZE

class PassportUploadEdit(PassportUploadManage):
    """Passport upload viewlet for students.
    """
    grok.view(StudentFilesUploadPage)
    grok.require('waeup.uploadStudentFile')

class SignatureDisplay(StudentFileDisplay):
    """Signature display viewlet.
    """
    grok.order(2)
    grok.context(IStudent)
    grok.view(StudentBaseDisplayFormPage)
    grok.require('waeup.viewStudent')
    grok.template('imagedisplay')
    label = _(u'Scanned Signature')
    download_name = u'signature.jpg'

class SignatureUploadManage(StudentFileUpload):
    """Signature upload viewlet for officers.
    """
    grok.order(2)
    grok.context(IStudent)
    grok.view(StudentBaseManageFormPage)
    grok.require('waeup.manageStudent')
    grok.template('imageupload')
    label = _(u'Scanned Signature (jpg only)')
    download_name = u'signature.jpg'

    @property
    def mus(self):
        kofa_utils = getUtility(IKofaUtils)
        return kofa_utils.MAX_PASSPORT_SIZE


class SignatureUploadEdit(SignatureUploadManage):
    """Signature upload viewlet for students.
    """
    grok.view(StudentSignatureUploadPage)
    grok.require('waeup.uploadStudentFile')


class FinalClearanceDisplay(StudentFileDisplay):
    """Final Clearance Routing Slip display viewlet.
    """
    grok.order(4)
    grok.context(IStudent)
    grok.view(StudentBaseDisplayFormPage)
    grok.require('waeup.viewStudent')
    label = _(u'Scanned Final Clearance Routing Slip ')
    download_name = u'routingslip.pdf'

class FinalClearanceUploadManage(StudentFileUpload):
    """Final Clearance Routing Slip upload viewlet for officers.
    """
    grok.order(4)
    grok.context(IStudent)
    grok.view(StudentBaseManageFormPage)
    grok.require('waeup.manageStudent')
    label = _(u'Scanned Final Clearance Routing Slip (pdf only)')
    download_name = u'routingslip.pdf'
    mus = 1024 * 500

class FinalClearanceUploadEdit(FinalClearanceUploadManage):
    """Final Clearance Form upload viewlet for students.
    """
    grok.view(StudentFinalClearanceUploadPage)
    grok.require('waeup.uploadStudentFile')

class BirthCertificateDisplay(StudentFileDisplay):
    """Birth Certificate display viewlet.
    """
    grok.order(1)
    label = _(u'Birth Certificate')
    title = _(u'Birth Certificate Scan')
    download_name = u'birth_certificate'


class BirthCertificateSlip(BirthCertificateDisplay):
    grok.view(ExportPDFClearanceSlip)


class BirthCertificateUpload(StudentFileUpload):
    """Birth Certificate upload viewlet.
    """
    grok.order(1)
    label = _(u'Birth Certificate')
    title = _(u'Birth Certificate Scan')
    download_name = u'birth_certificate'
    tab_redirect = '#tab2-top'


class Passport(StudentImage):
    """Renders jpeg passport picture.
    """
    grok.name('passport.jpg')
    download_name = u'passport.jpg'
    grok.context(IStudent)

class Signature(StudentImage):
    """Renders jpeg signature.
    """
    grok.name('signature.jpg')
    download_name = u'signature.jpg'
    grok.context(IStudent)

class FinalClearance(StudentImage):
    """Renders pdf slip.
    """
    grok.name('routingslip.pdf')
    download_name = u'routingslip'


class ApplicationSlipImage(StudentImage):
    """Renders application slip scan.
    """
    grok.name('application_slip')
    download_name = u'application_slip'


class FinalTranscriptImage(StudentImage):
    """Renders final transcript.
    """
    grok.name('final_transcript')
    download_name = u'final_transcript'


class BirthCertificateImage(StudentImage):
    """Renders birth certificate scan.
    """
    grok.name('birth_certificate')
    download_name = u'birth_certificate'