2020-11-09 03:39:42 +01:00
< ? php
/**
* Invoice Ninja ( https :// invoiceninja . com ) .
*
* @ link https :// github . com / invoiceninja / invoiceninja source repository
*
2021-01-03 22:54:54 +01:00
* @ copyright Copyright ( c ) 2021. Invoice Ninja LLC ( https :// invoiceninja . com )
2020-11-09 03:39:42 +01:00
*
* @ license https :// opensource . org / licenses / AAL
*/
namespace App\Mail\Engine ;
use App\DataMapper\EmailTemplateDefaults ;
2021-05-17 00:09:20 +02:00
use App\Models\Account ;
2020-12-25 12:13:26 +01:00
use App\Utils\Helpers ;
2020-11-09 03:39:42 +01:00
use App\Utils\Number ;
use App\Utils\Traits\MakesDates ;
2020-11-25 15:19:52 +01:00
class PaymentEmailEngine extends BaseEmailEngine
2020-11-09 03:39:42 +01:00
{
use MakesDates ;
2020-11-25 15:19:52 +01:00
public $client ;
2020-11-09 03:39:42 +01:00
2020-11-25 15:19:52 +01:00
public $payment ;
2020-11-09 03:39:42 +01:00
public $template_data ;
public $settings ;
public $company ;
public $contact ;
2020-12-25 12:13:26 +01:00
private $helpers ;
2021-04-20 13:32:25 +02:00
2020-11-09 03:39:42 +01:00
public function __construct ( $payment , $contact , $template_data = null )
{
$this -> payment = $payment ;
$this -> company = $payment -> company ;
$this -> client = $payment -> client ;
$this -> contact = $contact ? : $this -> client -> primary_contact () -> first ();
$this -> settings = $this -> client -> getMergedSettings ();
$this -> template_data = $template_data ;
2020-12-25 12:13:26 +01:00
$this -> helpers = new Helpers ();
2020-11-09 03:39:42 +01:00
}
public function build ()
{
2020-11-25 15:19:52 +01:00
if ( is_array ( $this -> template_data ) && array_key_exists ( 'body' , $this -> template_data ) && strlen ( $this -> template_data [ 'body' ]) > 0 ) {
2020-11-09 03:39:42 +01:00
$body_template = $this -> template_data [ 'body' ];
2020-11-25 15:19:52 +01:00
} elseif ( strlen ( $this -> client -> getSetting ( 'email_template_payment' )) > 0 ) {
2020-11-09 03:39:42 +01:00
$body_template = $this -> client -> getSetting ( 'email_template_payment' );
2020-11-25 15:19:52 +01:00
} else {
2020-11-09 03:39:42 +01:00
$body_template = EmailTemplateDefaults :: getDefaultTemplate ( 'email_template_payment' , $this -> client -> locale ());
}
2020-11-25 15:19:52 +01:00
if ( is_array ( $this -> template_data ) && array_key_exists ( 'subject' , $this -> template_data ) && strlen ( $this -> template_data [ 'subject' ]) > 0 ) {
2020-11-09 03:39:42 +01:00
$subject_template = $this -> template_data [ 'subject' ];
2020-11-25 15:19:52 +01:00
} elseif ( strlen ( $this -> client -> getSetting ( 'email_subject_payment' )) > 0 ) {
2020-11-09 03:39:42 +01:00
$subject_template = $this -> client -> getSetting ( 'email_subject_payment' );
2020-11-25 15:19:52 +01:00
} else {
2020-11-09 03:39:42 +01:00
$subject_template = EmailTemplateDefaults :: getDefaultTemplate ( 'email_subject_payment' , $this -> client -> locale ());
}
$this -> setTemplate ( $this -> client -> getSetting ( 'email_style' ))
-> setContact ( $this -> contact )
-> setVariables ( $this -> makeValues ())
-> setSubject ( $subject_template )
-> setBody ( $body_template )
-> setFooter ( '' )
-> setViewLink ( '' )
-> setViewText ( '' );
2021-05-17 00:09:20 +02:00
if ( $this -> client -> getSetting ( 'pdf_email_attachment' ) !== false && $this -> company -> account -> hasFeature ( Account :: FEATURE_PDF_ATTACHMENT )) {
$this -> payment -> invoices -> each ( function ( $invoice ){
2021-06-12 13:50:01 +02:00
$this -> setAttachments ([ $invoice -> pdf_file_path ( $invoice -> invitations -> first ())]);
2021-05-17 00:09:20 +02:00
});
}
2020-11-09 03:39:42 +01:00
return $this ;
}
2021-03-31 03:55:33 +02:00
public function makePaymentVariables ()
2020-11-09 03:39:42 +01:00
{
$data = [];
$data [ '$from' ] = [ 'value' => '' , 'label' => ctrans ( 'texts.from' )];
$data [ '$to' ] = [ 'value' => '' , 'label' => ctrans ( 'texts.to' )];
$data [ '$number' ] = [ 'value' => $this -> payment -> number ? : ' ' , 'label' => ctrans ( 'texts.payment_number' )];
2020-11-09 03:57:34 +01:00
$data [ '$payment.number' ] = & $data [ '$number' ];
2020-11-09 03:39:42 +01:00
$data [ '$entity' ] = [ 'value' => '' , 'label' => ctrans ( 'texts.payment' )];
$data [ '$payment.amount' ] = [ 'value' => Number :: formatMoney ( $this -> payment -> amount , $this -> client ) ? : ' ' , 'label' => ctrans ( 'texts.amount' )];
$data [ '$amount' ] = & $data [ '$payment.amount' ];
2021-02-23 11:04:39 +01:00
$data [ '$payment.date' ] = [ 'value' => $this -> translateDate ( $this -> payment -> date , $this -> client -> date_format (), $this -> client -> locale ()), 'label' => ctrans ( 'texts.payment_date' )];
2020-11-09 03:39:42 +01:00
$data [ '$transaction_reference' ] = [ 'value' => $this -> payment -> transaction_reference , 'label' => ctrans ( 'texts.transaction_reference' )];
$data [ '$public_notes' ] = [ 'value' => $this -> payment -> public_notes , 'label' => ctrans ( 'texts.notes' )];
2020-12-25 12:29:13 +01:00
$data [ '$payment1' ] = [ 'value' => $this -> helpers -> formatCustomFieldValue ( $this -> company -> custom_fields , 'payment1' , $this -> payment -> custom_value1 , $this -> client ) ? : ' ' , 'label' => $this -> helpers -> makeCustomField ( $this -> company -> custom_fields , 'payment1' )];
$data [ '$payment2' ] = [ 'value' => $this -> helpers -> formatCustomFieldValue ( $this -> company -> custom_fields , 'payment2' , $this -> payment -> custom_value2 , $this -> client ) ? : ' ' , 'label' => $this -> helpers -> makeCustomField ( $this -> company -> custom_fields , 'payment2' )];
$data [ '$payment3' ] = [ 'value' => $this -> helpers -> formatCustomFieldValue ( $this -> company -> custom_fields , 'payment3' , $this -> payment -> custom_value3 , $this -> client ) ? : ' ' , 'label' => $this -> helpers -> makeCustomField ( $this -> company -> custom_fields , 'payment3' )];
$data [ '$payment4' ] = [ 'value' => $this -> helpers -> formatCustomFieldValue ( $this -> company -> custom_fields , 'payment4' , $this -> payment -> custom_value4 , $this -> client ) ? : ' ' , 'label' => $this -> helpers -> makeCustomField ( $this -> company -> custom_fields , 'payment4' )];
2020-11-25 15:19:52 +01:00
// $data['$type'] = ['value' => $this->payment->type->name ?: '', 'label' => ctrans('texts.payment_type')];
2020-11-09 03:39:42 +01:00
2020-12-25 12:29:13 +01:00
$data [ '$client1' ] = [ 'value' => $this -> helpers -> formatCustomFieldValue ( $this -> company -> custom_fields , 'client1' , $this -> client -> custom_value1 , $this -> client ) ? : ' ' , 'label' => $this -> helpers -> makeCustomField ( $this -> company -> custom_fields , 'client1' )];
$data [ '$client2' ] = [ 'value' => $this -> helpers -> formatCustomFieldValue ( $this -> company -> custom_fields , 'client2' , $this -> client -> custom_value2 , $this -> client ) ? : ' ' , 'label' => $this -> helpers -> makeCustomField ( $this -> company -> custom_fields , 'client2' )];
$data [ '$client3' ] = [ 'value' => $this -> helpers -> formatCustomFieldValue ( $this -> company -> custom_fields , 'client3' , $this -> client -> custom_value3 , $this -> client ) ? : ' ' , 'label' => $this -> helpers -> makeCustomField ( $this -> company -> custom_fields , 'client3' )];
$data [ '$client4' ] = [ 'value' => $this -> helpers -> formatCustomFieldValue ( $this -> company -> custom_fields , 'client4' , $this -> client -> custom_value4 , $this -> client ) ? : ' ' , 'label' => $this -> helpers -> makeCustomField ( $this -> company -> custom_fields , 'client4' )];
2020-11-09 03:39:42 +01:00
$data [ '$address1' ] = [ 'value' => $this -> client -> address1 ? : ' ' , 'label' => ctrans ( 'texts.address1' )];
$data [ '$address2' ] = [ 'value' => $this -> client -> address2 ? : ' ' , 'label' => ctrans ( 'texts.address2' )];
$data [ '$id_number' ] = [ 'value' => $this -> client -> id_number ? : ' ' , 'label' => ctrans ( 'texts.id_number' )];
2021-01-25 11:34:12 +01:00
$data [ '$client.number' ] = [ 'value' => $this -> client -> number ? : ' ' , 'label' => ctrans ( 'texts.number' )];
2020-11-09 03:39:42 +01:00
$data [ '$vat_number' ] = [ 'value' => $this -> client -> vat_number ? : ' ' , 'label' => ctrans ( 'texts.vat_number' )];
$data [ '$website' ] = [ 'value' => $this -> client -> present () -> website () ? : ' ' , 'label' => ctrans ( 'texts.website' )];
$data [ '$phone' ] = [ 'value' => $this -> client -> present () -> phone () ? : ' ' , 'label' => ctrans ( 'texts.phone' )];
$data [ '$country' ] = [ 'value' => isset ( $this -> client -> country -> name ) ? $this -> client -> country -> name : '' , 'label' => ctrans ( 'texts.country' )];
$data [ '$email' ] = [ 'value' => isset ( $this -> contact ) ? $this -> contact -> email : 'no contact email on record' , 'label' => ctrans ( 'texts.email' )];
$data [ '$client_name' ] = [ 'value' => $this -> client -> present () -> name () ? : ' ' , 'label' => ctrans ( 'texts.client_name' )];
$data [ '$client.name' ] = & $data [ '$client_name' ];
$data [ '$client.address1' ] = & $data [ '$address1' ];
$data [ '$client.address2' ] = & $data [ '$address2' ];
$data [ '$client_address' ] = [ 'value' => $this -> client -> present () -> address () ? : ' ' , 'label' => ctrans ( 'texts.address' )];
$data [ '$client.address' ] = & $data [ '$client_address' ];
$data [ '$client.id_number' ] = & $data [ '$id_number' ];
$data [ '$client.vat_number' ] = & $data [ '$vat_number' ];
$data [ '$client.website' ] = & $data [ '$website' ];
$data [ '$client.phone' ] = & $data [ '$phone' ];
$data [ '$city_state_postal' ] = [ 'value' => $this -> client -> present () -> cityStateZip ( $this -> client -> city , $this -> client -> state , $this -> client -> postal_code , false ) ? : ' ' , 'label' => ctrans ( 'texts.city_state_postal' )];
$data [ '$client.city_state_postal' ] = & $data [ '$city_state_postal' ];
$data [ '$postal_city_state' ] = [ 'value' => $this -> client -> present () -> cityStateZip ( $this -> client -> city , $this -> client -> state , $this -> client -> postal_code , true ) ? : ' ' , 'label' => ctrans ( 'texts.postal_city_state' )];
$data [ '$client.postal_city_state' ] = & $data [ '$postal_city_state' ];
$data [ '$client.country' ] = & $data [ '$country' ];
$data [ '$client.email' ] = & $data [ '$email' ];
$data [ '$client.balance' ] = [ 'value' => Number :: formatMoney ( $this -> client -> balance , $this -> client ), 'label' => ctrans ( 'texts.account_balance' )];
$data [ '$outstanding' ] = [ 'value' => Number :: formatMoney ( $this -> client -> balance , $this -> client ), 'label' => ctrans ( 'texts.account_balance' )];
$data [ '$client_balance' ] = [ 'value' => Number :: formatMoney ( $this -> client -> balance , $this -> client ), 'label' => ctrans ( 'texts.account_balance' )];
$data [ '$paid_to_date' ] = [ 'value' => Number :: formatMoney ( $this -> client -> paid_to_date , $this -> client ), 'label' => ctrans ( 'texts.paid_to_date' )];
2021-03-31 23:28:51 +02:00
$data [ '$contact.full_name' ] = [ 'value' => isset ( $this -> contact ) ? $this -> contact -> present () -> name () : '' , 'label' => ctrans ( 'texts.name' )];
$data [ '$contact.email' ] = [ 'value' => isset ( $this -> contact ) ? $this -> contact -> email : '' , 'label' => ctrans ( 'texts.email' )];
$data [ '$contact.phone' ] = [ 'value' => isset ( $this -> contact ) ? $this -> contact -> phone : '' , 'label' => ctrans ( 'texts.phone' )];
2020-11-09 03:39:42 +01:00
$data [ '$contact.name' ] = [ 'value' => isset ( $this -> contact ) ? $this -> contact -> present () -> name () : 'no contact name on record' , 'label' => ctrans ( 'texts.contact_name' )];
$data [ '$contact.first_name' ] = [ 'value' => isset ( $this -> contact ) ? $this -> contact -> first_name : '' , 'label' => ctrans ( 'texts.first_name' )];
$data [ '$contact.last_name' ] = [ 'value' => isset ( $this -> contact ) ? $this -> contact -> last_name : '' , 'label' => ctrans ( 'texts.last_name' )];
2020-12-25 12:29:13 +01:00
$data [ '$contact.custom1' ] = [ 'value' => isset ( $this -> contact ) ? $this -> contact -> custom_value1 : ' ' , 'label' => $this -> helpers -> makeCustomField ( $this -> company -> custom_fields , 'contact1' )];
$data [ '$contact.custom2' ] = [ 'value' => isset ( $this -> contact ) ? $this -> contact -> custom_value2 : ' ' , 'label' => $this -> helpers -> makeCustomField ( $this -> company -> custom_fields , 'contact1' )];
$data [ '$contact.custom3' ] = [ 'value' => isset ( $this -> contact ) ? $this -> contact -> custom_value3 : ' ' , 'label' => $this -> helpers -> makeCustomField ( $this -> company -> custom_fields , 'contact1' )];
$data [ '$contact.custom4' ] = [ 'value' => isset ( $this -> contact ) ? $this -> contact -> custom_value4 : ' ' , 'label' => $this -> helpers -> makeCustomField ( $this -> company -> custom_fields , 'contact1' )];
2020-11-09 03:39:42 +01:00
$data [ '$company.city_state_postal' ] = [ 'value' => $this -> company -> present () -> cityStateZip ( $this -> settings -> city , $this -> settings -> state , $this -> settings -> postal_code , false ) ? : ' ' , 'label' => ctrans ( 'texts.city_state_postal' )];
$data [ '$company.postal_city_state' ] = [ 'value' => $this -> company -> present () -> cityStateZip ( $this -> settings -> city , $this -> settings -> state , $this -> settings -> postal_code , true ) ? : ' ' , 'label' => ctrans ( 'texts.postal_city_state' )];
$data [ '$company.name' ] = [ 'value' => $this -> company -> present () -> name () ? : ' ' , 'label' => ctrans ( 'texts.company_name' )];
$data [ '$company.address1' ] = [ 'value' => $this -> settings -> address1 ? : ' ' , 'label' => ctrans ( 'texts.address1' )];
$data [ '$company.address2' ] = [ 'value' => $this -> settings -> address2 ? : ' ' , 'label' => ctrans ( 'texts.address2' )];
$data [ '$company.city' ] = [ 'value' => $this -> settings -> city ? : ' ' , 'label' => ctrans ( 'texts.city' )];
$data [ '$company.state' ] = [ 'value' => $this -> settings -> state ? : ' ' , 'label' => ctrans ( 'texts.state' )];
$data [ '$company.postal_code' ] = [ 'value' => $this -> settings -> postal_code ? : ' ' , 'label' => ctrans ( 'texts.postal_code' )];
//$data['$company.country'] = ['value' => $this->getCountryName(), 'label' => ctrans('texts.country')];
$data [ '$company.phone' ] = [ 'value' => $this -> settings -> phone ? : ' ' , 'label' => ctrans ( 'texts.phone' )];
$data [ '$company.email' ] = [ 'value' => $this -> settings -> email ? : ' ' , 'label' => ctrans ( 'texts.email' )];
$data [ '$company.vat_number' ] = [ 'value' => $this -> settings -> vat_number ? : ' ' , 'label' => ctrans ( 'texts.vat_number' )];
$data [ '$company.id_number' ] = [ 'value' => $this -> settings -> id_number ? : ' ' , 'label' => ctrans ( 'texts.id_number' )];
$data [ '$company.website' ] = [ 'value' => $this -> settings -> website ? : ' ' , 'label' => ctrans ( 'texts.website' )];
$data [ '$company.address' ] = [ 'value' => $this -> company -> present () -> address ( $this -> settings ) ? : ' ' , 'label' => ctrans ( 'texts.address' )];
$logo = $this -> company -> present () -> logo ( $this -> settings );
$data [ '$company.logo' ] = [ 'value' => $logo ? : ' ' , 'label' => ctrans ( 'texts.logo' )];
$data [ '$company_logo' ] = & $data [ '$company.logo' ];
2020-12-25 12:29:13 +01:00
$data [ '$company1' ] = [ 'value' => $this -> helpers -> formatCustomFieldValue ( $this -> company -> custom_fields , 'company1' , $this -> settings -> custom_value1 , $this -> client ) ? : ' ' , 'label' => $this -> helpers -> makeCustomField ( $this -> company -> custom_fields , 'company1' )];
$data [ '$company2' ] = [ 'value' => $this -> helpers -> formatCustomFieldValue ( $this -> company -> custom_fields , 'company2' , $this -> settings -> custom_value2 , $this -> client ) ? : ' ' , 'label' => $this -> helpers -> makeCustomField ( $this -> company -> custom_fields , 'company2' )];
$data [ '$company3' ] = [ 'value' => $this -> helpers -> formatCustomFieldValue ( $this -> company -> custom_fields , 'company3' , $this -> settings -> custom_value3 , $this -> client ) ? : ' ' , 'label' => $this -> helpers -> makeCustomField ( $this -> company -> custom_fields , 'company3' )];
$data [ '$company4' ] = [ 'value' => $this -> helpers -> formatCustomFieldValue ( $this -> company -> custom_fields , 'company4' , $this -> settings -> custom_value4 , $this -> client ) ? : ' ' , 'label' => $this -> helpers -> makeCustomField ( $this -> company -> custom_fields , 'company4' )];
2020-11-09 03:39:42 +01:00
2021-04-20 13:32:25 +02:00
$data [ '$view_link' ] = [ 'value' => '<a class="button" href="' . $this -> payment -> getLink () . '">' . ctrans ( 'texts.view_payment' ) . '</a>' , 'label' => ctrans ( 'texts.view_payment' )];
2020-11-09 03:39:42 +01:00
$data [ '$view_url' ] = [ 'value' => $this -> payment -> getLink (), 'label' => ctrans ( 'texts.view_payment' )];
$data [ '$invoices' ] = [ 'value' => $this -> formatInvoices (), 'label' => ctrans ( 'texts.invoices' )];
return $data ;
}
private function formatInvoices ()
{
2021-01-28 00:35:52 +01:00
$invoice_list = '<br><br>' ;
2020-11-09 03:39:42 +01:00
2020-11-25 15:19:52 +01:00
foreach ( $this -> payment -> invoices as $invoice ) {
2020-11-09 03:39:42 +01:00
$invoice_list .= ctrans ( 'texts.invoice_number_short' ) . " { $invoice -> number } - " . Number :: formatMoney ( $invoice -> pivot -> amount , $this -> client ) . " <br> " ;
}
return $invoice_list ;
}
public function makeValues () : array
{
$data = [];
$values = $this -> makePaymentVariables ();
foreach ( $values as $key => $value ) {
$data [ $key ] = $value [ 'value' ];
}
return $data ;
}
}