Add logic for reminder generation

lib/midcom/admin/folder/locale/default.de.txt

@@ -220,4 +220,4 @@ Stilvorlage
 
 ---STRING objects with no navigation entry are still accessible on-site if the url is known
 Objekte ohne Navigationseintrag sind weiterhin verfügbar, insofern die URL bekannt ist
----STRINGEND
+---STRINGEND

lib/midcom/admin/folder/locale/default.en.txt

@@ -220,4 +220,4 @@ Style template
 
 ---STRING objects with no navigation entry are still accessible on-site if the url is known
 Objects that are hidden from navigation are still accessible on-site if the URL is known
----STRINGEND
+---STRINGEND

lib/org/openpsa/invoices/config/config.inc

@@ -7,6 +7,7 @@
 'invoice_number_format' => '#%06d',
 //contains the class file to create the pdf for the invoice, if set to false pdf-creation is disabled
 'invoice_pdfbuilder_class' => false, //implements org_openpsa_invoices_interfaces_pdfbuilder
+'invoice_pdfbuilder_reminder_class' => false,
 
 'invoice_mail_bcc'       => false,
 'invoice_mail_from_address' => '[email protected]',

lib/org/openpsa/invoices/config/routes.yml

@@ -58,6 +58,10 @@ create_pdf:
     path: /invoice/action/create_pdf/
     defaults: { _controller: 'org_openpsa_invoices_handler_invoice_action::create_pdf' }
 
+create_reminder:
+    path: /invoice/action/create_reminder/
+    defaults: { _controller: 'org_openpsa_invoices_handler_invoice_action::create_pdf_reminder' }
+
 recalc_invoice:
     path: /invoice/recalculation/{guid}/
     defaults: { _controller: 'org_openpsa_invoices_handler_invoice_items::recalculation' }

lib/org/openpsa/invoices/config/schemadb_default.inc

@@ -163,6 +163,17 @@
             'index_method' => 'attachment',
             'hidden' => true,
         ],
+        'pdf_file_reminder' => [
+            'title' => 'pdf file',
+            'type'    => 'blobs',
+            'widget' => 'downloads',
+            'type_config' => [
+                'sortable' => false,
+                'max_count' => 1,
+            ],
+            'index_method' => 'attachment',
+            'hidden' => true,
+        ],
         'files' => [
             'title' => 'Files',
             'type'    => 'blobs',

lib/org/openpsa/invoices/handler/invoice/action.php

@@ -130,6 +130,17 @@ public function _handler_create_pdf()
         }
     }
 
+    public function _handler_create_pdf_reminder()
+    {
+        $pdf_helper = new org_openpsa_invoices_invoice_pdf($this->invoice);
+        try {
+            $pdf_helper->render_and_attach('reminder');
+            return $this->reply(true, $this->_l10n->get('reminder pdf created'));
+        } catch (midcom_error $e) {
+            return $this->reply(false, $this->_l10n->get('reminder pdf creation failed') . ': ' . $e->getMessage());
+        }
+    }    
+
     public function _handler_send_by_mail()
     {
         $customerCard = org_openpsa_widgets_contact::get($this->invoice->customerContact);

lib/org/openpsa/invoices/handler/invoice/view.php

@@ -32,7 +32,7 @@ public function _handler_read(string $guid, array &$data)
         $data['object_view'] = $dm->get_content_html();
         $data['invoice_items'] = $this->invoice->get_invoice_items();
 
-        $this->populate_toolbar();
+        $this->populate_toolbar($this->invoice);
         $this->update_breadcrumb();
 
         midcom::get()->metadata->set_request_metadata($this->invoice->metadata->revised, $guid);
@@ -96,6 +96,12 @@ private function populate_toolbar()
                  && intval($billing_data->sendingoption) == 2) {
                 $buttons[] = $this->build_button('send_by_mail', 'paper-plane');
             }
+            if ($this->_config->get('invoice_pdfbuilder_reminder_class') && $this->invoice->get_status() == 'overdue') {
+                $button = $this->build_button('create_reminder', 'file-pdf-o');
+                $pdf_helper = new org_openpsa_invoices_invoice_pdf($this->invoice);
+                $button[MIDCOM_TOOLBAR_OPTIONS] = $pdf_helper->get_button_options('reminder');
+                $buttons[] = $button;
+            }
         }
 
         if ($this->invoice->is_cancelable()) {

lib/org/openpsa/invoices/invoice/pdf.php

@@ -21,9 +21,13 @@ public function __construct(org_openpsa_invoices_invoice_dba $invoice)
         $this->invoice = $invoice;
     }
 
-    public function get_attachment(bool $autocreate = false) : ?midcom_db_attachment
+    public function get_attachment(bool $autocreate = false, string $kind = null) : ?midcom_db_attachment
     {
-        $pdf_files = blobs::get_attachments($this->invoice, "pdf_file");
+        if ($kind == 'reminder') {
+            $pdf_files = blobs::get_attachments($this->invoice, "pdf_file_reminder");
+        } else {
+            $pdf_files = blobs::get_attachments($this->invoice, "pdf_file");
+        }
         if (!empty($pdf_files)) {
             return reset($pdf_files);
         }
@@ -33,17 +37,17 @@ public function get_attachment(bool $autocreate = false) : ?midcom_db_attachment
         return $this->render_and_attach();
     }
 
-    public function get_button_options() : array
+    public function get_button_options(string $kind = 'invoice') : array
     {
         if ($attachment = $this->get_attachment()) {
-            if ($this->invoice->sent) {
-                $message = 'invoice has already been sent. should it be replaced?';
+            if ($this->invoice->sent && (!($kind == 'reminder' && $this->invoice->get_status() == 'overdue'))) {
+                $message = $kind . ' has already been sent. should it be replaced?';
             }
             // check if auto generated parameter is same as md5 in current-file
             // if not the file was manually uploaded
             elseif ($checksum = $attachment->get_parameter('org.openpsa.invoices', 'auto_generated')) {
                 if ($checksum !== md5_file($attachment->get_path())) {
-                    $message = 'current pdf file was manually uploaded shall it be replaced ?';
+                        $message = 'current pdf file was manually uploaded shall it be replaced ?';
                 }
             }
         }
@@ -63,9 +67,14 @@ public function get_button_options() : array
         ];
     }
 
-    public function render_and_attach() : midcom_db_attachment
+    public function render_and_attach(string $kind = null) : midcom_db_attachment
     {
-        $client_class = midcom_baseclasses_components_configuration::get('org.openpsa.invoices', 'config')->get('invoice_pdfbuilder_class');
+        if ($kind == null) {
+            $client_class = midcom_baseclasses_components_configuration::get('org.openpsa.invoices', 'config')->get('invoice_pdfbuilder_class');
+        } else {
+            $client_class = midcom_baseclasses_components_configuration::get('org.openpsa.invoices', 'config')->get('invoice_pdfbuilder_' . $kind . '_class');
+        }
+
         if (!class_exists($client_class)) {
             throw new midcom_error('Could not find PDF renderer ' . $client_class);
         }
@@ -78,15 +87,20 @@ public function render_and_attach() : midcom_db_attachment
         }
         // renders the pdf and attaches it to the invoice
         $pdf_builder = new $client_class($this->invoice);
-        $filename = midcom_helper_misc::urlize($this->invoice->get_label()) . '.pdf';
+        if ($kind == 'reminder') {
+            $name = "guids_pdf_file_reminder";
+            $filename = midcom_helper_misc::urlize($this->invoice->get_label()) . '_reminder' . '.pdf';
+        } else {
+            $name = "guids_pdf_file";
+            $filename = midcom_helper_misc::urlize($this->invoice->get_label()) . '.pdf';
+        }
 
         // tmp filename
         $tmp_file = midcom::get()->config->get('midcom_tempdir') . "/" . $filename;
 
         // render pdf to tmp filename
         $pdf_builder->render($tmp_file);
-
-        $attachment = $this->get_attachment();
+        $attachment = $this->get_attachment(false, $kind);
         if ($attachment) {
             $attachment->name = $filename;
             $attachment->title = $this->invoice->get_label();
@@ -95,7 +109,7 @@ public function render_and_attach() : midcom_db_attachment
         } else {
             $attachment = $this->invoice->create_attachment($filename, $this->invoice->get_label(), "application/pdf");
             if (   !$attachment
-                || !$this->invoice->set_parameter("midcom.helper.datamanager2.type.blobs", "guids_pdf_file", $attachment->guid . ":" . $attachment->guid)) {
+                || !$this->invoice->set_parameter("midcom.helper.datamanager2.type.blobs", $name, $attachment->guid . ":" . $attachment->guid)) {
                 throw new midcom_error("Failed to create invoice attachment for pdf: " . midcom_connection::get_error_string());
             }
         }

lib/org/openpsa/invoices/locale/default.de.txt

@@ -126,6 +126,10 @@ Rechnungsdaten
 Diese Rechnung wurde bereits verschickt. Soll die Datei trotzdem neu erzeugt werden?
 ---STRINGEND
 
+---STRING reminder has already been sent. should it be replaced?
+Diese Mahnung wurde bereits verschickt. Soll die Datei trotzdem neu erzeugt werden?
+---STRINGEND
+
 ---STRING invoice items
 Rechnungspositionen
 ---STRINGEND
@@ -414,14 +418,26 @@ Die derzeitige PDF-Datei wurde manuell hochgeladen. Soll diese Datei wirklich er
 PDF erzeugen
 ---STRINGEND
 
+---STRING create_reminder
+Mahnung erzeugen
+---STRINGEND
+
 ---STRING pdf created
 PDF-Datei wurde erfolgreich erzeugt
 ---STRINGEND
 
+---STRING reminder pdf created
+Mahnungs PDF-Datei wurde erfolgreich erzeugt
+---STRINGEND
+
 ---STRING pdf creation failed
 PDF-Datei konnte nicht erzeugt werden
 ---STRINGEND
 
+---STRING reminder pdf creation failed
+Mahnungs PDF-Datei konnte nicht erzeugt werden
+---STRINGEND
+
 ---STRING position
 Position
 ---STRINGEND

lib/org/openpsa/invoices/locale/default.en.txt

@@ -130,6 +130,10 @@ Invoice data
 This invoice has already been sent. Should the file be regenerated anyways?
 ---STRINGEND
 
+---STRING reminder has already been sent. should it be replaced?
+This reminder has already been sent. Should the file be regenerated anyways?
+---STRINGEND
+
 ---STRING invoice items
 Invoice items
 ---STRINGEND
@@ -425,3 +429,7 @@ Could not create PDF
 ---STRING position
 Position
 ---STRINGEND
+
+---STRING create_reminder
+create reminder
+---STRINGEND

lib/org/openpsa/invoices/style/admin-read.php

@@ -124,6 +124,10 @@
         <p><strong><?php echo $data['l10n']->get('pdf file'); ?></strong></p>
         <?php echo org_openpsa_helpers_fileinfo::render($invoice, 'pdf_file');
     }
+    if ($view['pdf_file_reminder'] != "") { ?>
+        <p><strong><?php echo $data['l10n']->get('pdf file'); ?></strong></p>
+        <?php echo org_openpsa_helpers_fileinfo::render($invoice, 'pdf_file_reminder');
+    }
 
     $tabs = [];
     if ($expenses_url) {