Changeset 15880

Timestamp:

11 Dec 2019, 12:02:09 (5 years ago)

Author:

Henrik Bettermann

Message:

Add LetterPDFCreator utility and use this pdf creator
for admission slips. letterhead_admission.jpg file
must exist in students/static.

Location:

main/waeup.kofa/trunk

Files:

• CHANGES.txt (modified) (1 diff)
• src/waeup/kofa/browser/pdf.py (modified) (5 diffs)
• src/waeup/kofa/students/browser.py (modified) (2 diffs)
• src/waeup/kofa/students/fileviewlets.py (modified) (1 diff)
• src/waeup/kofa/students/interfaces.py (modified) (1 diff)
• src/waeup/kofa/students/static/actionicon_reload.png (deleted)
• src/waeup/kofa/students/utils.py (modified) (3 diffs)

main/waeup.kofa/trunk/CHANGES.txt

@@ -4 +4 @@
 1.6.1.dev0 (unreleased)
 =======================
+
+* Add LetterPDFCreator utility and use this pdf creator
+  for admission slips. letterhead_admission.jpg file
+  must exist in students/static.
 
 * Add application worklfow transition `reset6`.

main/waeup.kofa/trunk/src/waeup/kofa/browser/pdf.py

@@ -802 +802 @@
         if not getattr(doc, 'kofa_nodate', False):
             tz = getattr(queryUtility(IKofaUtils), 'tzinfo', pytz.utc)
-            #tz = getUtility(IKofaUtils).tzinfo
             today = now(tz).strftime('%d/%m/%Y %H:%M:%S %Z')
             canvas.drawString(2.2*cm, 0.5 * inch,
@@ -811 +810 @@
         canvas.kofa_footer_text =  doc.kofa_footer
         canvas.restoreState()
-        canvas.restoreState()
 
         # Metadata
@@ -820 +818 @@
 
     def create_pdf(self, data, headerline=None, title=None, author=None,
-                   footer='', note=None, sigs_in_footer=[], topMargin=1.5):
+                   footer='', note=None, sigs_in_footer=[], topMargin=1.5,
+                   letterhead_path=None):
         """Returns a binary data stream which is a PDF document.
         """
         pdf_stream = StringIO()
         bottomMargin = len(sigs_in_footer) and 1.9*inch or 1.2*inch
-        topMargin += title.count('\n') * 0.2
+        if letterhead_path:
+            topMargin += 1.2
+        else:
+            topMargin += title.count('\n') * 0.2
         doc = SimpleDocTemplate(
             pdf_stream,
@@ -841 +843 @@
         doc.kofa_footer = footer
         doc.sigs_in_footer = sigs_in_footer
+        doc.letterhead_path = letterhead_path
         if note is not None:
             html = format_html(note)
@@ -859 +862 @@
     pagesize = landscape(A4)
 
+class LetterPDFCreator(PDFCreator):
+    """A utility to help with generating PDF docs with an original letterhead.
+    """
+    grok.name('letter')
+    letterhead_pos = [0, 0]
+
+    def paint_background(self, canvas, doc):
+        """Paint letterhead background of a PDF.
+
+        The `doc` is expected to be some reportlab SimpleDocTemplate
+        or similar object.
+
+        This is a callback method that will be called from reportlab
+        when creating PDFs with :meth:`create_pdf`.
+        """
+        canvas.saveState()
+        width, height = doc.width, doc.height
+        width += doc.leftMargin + doc.rightMargin
+        height += doc.topMargin + doc.bottomMargin
+
+        # Letterhead
+        if doc.letterhead_path is not None:
+            canvas.saveState()
+            canvas.drawImage(doc.letterhead_path,
+                self.letterhead_pos[0], self.letterhead_pos[1],
+                width=width, height=height)
+            canvas.restoreState()
+
+        # Footer
+        if getattr(doc, 'sigs_in_footer', False):
+            self._drawSignatureBoxes(
+                canvas, width, height, doc.sigs_in_footer)
+        #canvas.line(2.2*cm, 0.62*inch, width-2.2*cm, 0.62*inch)
+        canvas.setFont("Helvetica", 9)
+        if not getattr(doc, 'kofa_nodate', False):
+            tz = getattr(queryUtility(IKofaUtils), 'tzinfo', pytz.utc)
+            today = now(tz).strftime('%d/%m/%Y %H:%M:%S %Z')
+            #canvas.drawString(2.2*cm, 0.5 * inch,
+            #    translate(_(u'Date: ${a}', mapping = {'a': today})))
+            canvas.drawString(2.2*cm, 0.3 * inch,
+                translate(_(u'Date: ${a}', mapping = {'a': today})))
+        # set canves attributes needed to render `page x of y`
+        canvas.kofa_footer_x_pos = width-2.2*cm
+        #canvas.kofa_footer_y_pos = 0.5 * inch
+        canvas.kofa_footer_y_pos = 0.3 * inch
+        canvas.kofa_footer_text =  doc.kofa_footer
+        canvas.restoreState()
+
+        # Metadata
+        title = getattr(doc, 'kofa_title', '')
+        canvas.setAuthor(getattr(doc, 'kofa_author', 'Unknown'))
+        canvas.setSubject(title)
+        canvas.setCreator(u'WAeUP Kofa')
+        return
+
+
 class A3LandscapePDFCreator(LandscapePDFCreator):
     """A utility to help with generating PDF docs in

main/waeup.kofa/trunk/src/waeup/kofa/students/browser.py

@@ -22 +22 @@
 import pytz
 import sys
+import os
 import textwrap
 from cStringIO import StringIO
@@ -543 +544 @@
     def render(self):
         students_utils = getUtility(IStudentsUtils)
+        letterhead_path = os.path.join(
+            os.path.dirname(__file__), 'static', 'letterhead_admission.jpg')
+        if not os.path.exists(letterhead_path):
+            letterhead_path = None
         return students_utils.renderPDFAdmissionLetter(self,
-            self.context.student, omit_fields=self.omit_fields)
+            self.context.student, omit_fields=self.omit_fields,
+            letterhead_path=letterhead_path)
 
 class StudentBaseManageFormPage(KofaEditFormPage):

main/waeup.kofa/trunk/src/waeup/kofa/students/fileviewlets.py

@@ -24 +24 @@
     IExtFileStore, IFileStoreNameChooser, IKofaObject, IKofaUtils)
 from waeup.kofa.utils.helpers import string_from_bytes, file_size
-from waeup.kofa.browser import DEFAULT_IMAGE_PATH
 
 from waeup.kofa.students.interfaces import IStudent, IStudentsUtils

main/waeup.kofa/trunk/src/waeup/kofa/students/interfaces.py

@@ -145 +145 @@
 
     def renderPDFAdmissionLetter(view, student=None, omit_fields=(),
-                                 pre_text=None, post_text=None,):
+                                 pre_text=None, post_text=None,
+                                 letterhead_path=None):
         """Render pdf admission letter.
         """

main/waeup.kofa/trunk/src/waeup/kofa/students/utils.py

@@ -859 +859 @@
 
     def renderPDFAdmissionLetter(self, view, student=None, omit_fields=(),
-                                 pre_text=None, post_text=None,):
+                                 pre_text=None, post_text=None,
+                                 letterhead_path=None):
         """Render pdf admission letter.
         """
@@ -865 +866 @@
             return
         style = getSampleStyleSheet()
-        creator = self.getPDFCreator(student)
+        if letterhead_path:
+            creator = getUtility(IPDFCreator, name='letter')
+        else:
+            creator = getUtility(IPDFCreator)
         portal_language = getUtility(IKofaUtils).PORTAL_LANGUAGE
         data = []
@@ -912 +916 @@
         pdf_stream = creator.create_pdf(
             data, None, doc_title, author=author, footer=footer_text,
-            note=post_text)
+            note=post_text, letterhead_path=letterhead_path)
         return pdf_stream