mirror of
https://github.com/invoiceninja/invoiceninja.git
synced 2024-11-05 18:52:44 +01:00
1c21b6dc7c
* Fixes for invoice item line totals * Refactoring invoice calculations * Update api-docs * Fixes for invoice calculations * remove tests * fixes for config files
441 lines
13 KiB
PHP
441 lines
13 KiB
PHP
<?php
|
|
/**
|
|
* Invoice Ninja (https://invoiceninja.com)
|
|
*
|
|
* @link https://github.com/invoiceninja/invoiceninja source repository
|
|
*
|
|
* @copyright Copyright (c) 2019. Invoice Ninja LLC (https://invoiceninja.com)
|
|
*
|
|
* @license https://opensource.org/licenses/AAL
|
|
*/
|
|
|
|
namespace App\Utils\Traits;
|
|
|
|
use App\Utils\Number;
|
|
|
|
/**
|
|
* Class MakesInvoiceValues
|
|
* @package App\Utils\Traits
|
|
*/
|
|
trait MakesInvoiceValues
|
|
{
|
|
/**
|
|
* Master list of columns used
|
|
* for invoice tables
|
|
* @var array
|
|
*/
|
|
private static $master_columns = [
|
|
'date',
|
|
'discount',
|
|
'product_key',
|
|
'notes',
|
|
'cost',
|
|
'quantity',
|
|
'tax_name1',
|
|
'tax_name2',
|
|
'tax_name3',
|
|
'line_total',
|
|
'custom_label1',
|
|
'custom_label2',
|
|
'custom_label3',
|
|
'custom_label4',
|
|
];
|
|
|
|
/**
|
|
* Master list of invoice labels
|
|
* @var array
|
|
*/
|
|
private static $labels = [
|
|
'invoice_date',
|
|
'due_date',
|
|
'invoice_number',
|
|
'po_number',
|
|
'discount',
|
|
'taxes',
|
|
'tax',
|
|
'item',
|
|
'description',
|
|
'unit_cost',
|
|
'quantity',
|
|
'line_total',
|
|
'subtotal',
|
|
'paid_to_date',
|
|
'balance_due',
|
|
'partial_due',
|
|
'terms',
|
|
'your_invoice',
|
|
'quote',
|
|
'your_quote',
|
|
'quote_date',
|
|
'quote_number',
|
|
'total',
|
|
'invoice_issued_to',
|
|
'quote_issued_to',
|
|
'rate',
|
|
'hours',
|
|
'balance',
|
|
'from',
|
|
'to',
|
|
'invoice_to',
|
|
'quote_to',
|
|
'details',
|
|
'invoice_no',
|
|
'quote_no',
|
|
'valid_until',
|
|
'client_name',
|
|
'address1',
|
|
'address2',
|
|
'id_number',
|
|
'vat_number',
|
|
'city_state_postal',
|
|
'postal_city_state',
|
|
'country',
|
|
'email',
|
|
'contact_name',
|
|
'company_name',
|
|
'website',
|
|
'phone',
|
|
'blank',
|
|
'surcharge',
|
|
'tax_invoice',
|
|
'tax_quote',
|
|
'statement',
|
|
'statement_date',
|
|
'your_statement',
|
|
'statement_issued_to',
|
|
'statement_to',
|
|
'credit_note',
|
|
'credit_date',
|
|
'credit_number',
|
|
'credit_issued_to',
|
|
'credit_to',
|
|
'your_credit',
|
|
'phone',
|
|
'invoice_total',
|
|
'outstanding',
|
|
'invoice_due_date',
|
|
'quote_due_date',
|
|
'service',
|
|
'product_key',
|
|
'unit_cost',
|
|
'custom_value1',
|
|
'custom_value2',
|
|
'delivery_note',
|
|
'date',
|
|
'method',
|
|
'payment_date',
|
|
'reference',
|
|
'amount',
|
|
'amount_paid',
|
|
];
|
|
|
|
/**
|
|
* Iterates and translates all labels
|
|
*
|
|
* @return array returns an array of
|
|
* keyed labels (appended with _label)
|
|
*/
|
|
public function makeLabels() :array
|
|
{
|
|
$data = [];
|
|
|
|
foreach(self::$labels as $label)
|
|
$data['$'.$label . '_label'] = ctrans('texts.'.$label);
|
|
|
|
return $data;
|
|
}
|
|
|
|
/**
|
|
* Transforms all placeholders
|
|
* to invoice values
|
|
*
|
|
* @return array returns an array
|
|
* of keyed labels (appended with _label)
|
|
*/
|
|
public function makeValues() :array
|
|
{
|
|
if(!$this->client->currency() || !$this->client){
|
|
throw new Exception(debug_backtrace()[1]['function'], 1);
|
|
exit;
|
|
}
|
|
|
|
$data = [];
|
|
|
|
$data['$invoice_date'] = $this->invoice_date;
|
|
$data['$due_date'] = $this->due_date;
|
|
$data['$invoice_number'] = $this->invoice_number;
|
|
$data['$po_number'] = $this->po_number;
|
|
$data['$line_taxes'] = $this->makeLineTaxes();
|
|
$data['$total_taxes'] = $this->makeTotalTaxes();
|
|
// $data['$tax'] = ;
|
|
// $data['$item'] = ;
|
|
// $data['$description'] = ;
|
|
// $data['$unit_cost'] = ;
|
|
// $data['$quantity'] = ;
|
|
// $data['$line_total'] = ;
|
|
// $data['$paid_to_date'] = ;
|
|
$data['$discount'] = Number::formatMoney($this->calc()->getTotalDiscount(), $this->client);
|
|
$data['$subtotal'] = Number::formatMoney($this->calc()->getSubTotal(), $this->client);
|
|
$data['$balance_due'] = Number::formatMoney($this->balance, $this->client);
|
|
$data['$partial_due'] = Number::formatMoney($this->partial, $this->client);
|
|
$data['$total'] = Number::formatMoney($this->calc()->getTotal(), $this->client);
|
|
$data['$balance'] = Number::formatMoney($this->calc()->getBalance(), $this->client);
|
|
$data['$taxes'] = Number::formatMoney($this->calc()->getItemTotalTaxes(), $this->client);
|
|
$data['$terms'] = $this->terms;
|
|
// $data['$your_invoice'] = ;
|
|
// $data['$quote'] = ;
|
|
// $data['$your_quote'] = ;
|
|
// $data['$quote_date'] = ;
|
|
// $data['$quote_number'] = ;
|
|
// $data['$invoice_issued_to'] = ;
|
|
// $data['$quote_issued_to'] = ;
|
|
// $data['$rate'] = ;
|
|
// $data['$hours'] = ;
|
|
// $data['$from'] = ;
|
|
// $data['$to'] = ;
|
|
// $data['$invoice_to'] = ;
|
|
// $data['$quote_to'] = ;
|
|
// $data['$details'] = ;
|
|
$data['$invoice_no'] = $this->invoice_number;
|
|
// $data['$quote_no'] = ;
|
|
// $data['$valid_until'] = ;
|
|
$data['$client_name'] = $this->present()->clientName();
|
|
$data['$client_address'] = $this->present()->address();
|
|
$data['$address1'] = $this->client->address1;
|
|
$data['$address2'] = $this->client->address2;
|
|
$data['$id_number'] = $this->client->id_number;
|
|
$data['$vat_number'] = $this->client->vat_number;
|
|
$data['$website'] = $this->client->present()->website();
|
|
$data['$phone'] = $this->client->present()->phone();
|
|
$data['$city_state_postal'] = $this->present()->cityStateZip($this->client->city, $this->client->state, $this->client->postal_code, FALSE);
|
|
$data['$postal_city_state'] = $this->present()->cityStateZip($this->client->city, $this->client->state, $this->client->postal_code, TRUE);
|
|
$data['$country'] = $this->client->country->name;
|
|
$data['$email'] = isset($this->client->primary_contact()->first()->email) ?: 'no contact email on record';
|
|
$data['$contact_name'] = $this->client->present()->primary_contact_name();
|
|
$data['$company_name'] = $this->company->present()->name();
|
|
$data['$company_address1'] = $this->company->address1;
|
|
$data['$company_address2'] = $this->company->address2;
|
|
$data['$company_city'] = $this->company->city;
|
|
$data['$company_state'] = $this->company->state;
|
|
$data['$company_postal_code'] = $this->company->postal_code;
|
|
$data['$company_country'] = $this->company->country() ? $this->company->country()->name : '';
|
|
$data['$company_phone'] = $this->company->phone;
|
|
$data['$company_email'] = $this->company->email;
|
|
$data['$company_vat_number'] = $this->company->vat_number;
|
|
$data['$company_id_number'] = $this->company->id_number;
|
|
$data['$company_address'] = $this->company->present()->address();
|
|
$data['$company_logo'] = $this->company->present()->logo();
|
|
//$data['$blank'] = ;
|
|
//$data['$surcharge'] = ;
|
|
/*
|
|
$data['$tax_invoice'] =
|
|
$data['$tax_quote'] =
|
|
$data['$statement'] = ;
|
|
$data['$statement_date'] = ;
|
|
$data['$your_statement'] = ;
|
|
$data['$statement_issued_to'] = ;
|
|
$data['$statement_to'] = ;
|
|
$data['$credit_note'] = ;
|
|
$data['$credit_date'] = ;
|
|
$data['$credit_number'] = ;
|
|
$data['$credit_issued_to'] = ;
|
|
$data['$credit_to'] = ;
|
|
$data['$your_credit'] = ;
|
|
$data['$phone'] = ;
|
|
$data['$invoice_total'] = ;
|
|
$data['$outstanding'] = ;
|
|
$data['$invoice_due_date'] = ;
|
|
$data['$quote_due_date'] = ;
|
|
$data['$service'] = ;
|
|
$data['$product_key'] = ;
|
|
$data['$unit_cost'] = ;
|
|
$data['$custom_value1'] = ;
|
|
$data['$custom_value2'] = ;
|
|
$data['$delivery_note'] = ;
|
|
$data['$date'] = ;
|
|
$data['$method'] = ;
|
|
$data['$payment_date'] = ;
|
|
$data['$reference'] = ;
|
|
$data['$amount'] = ;
|
|
$data['$amount_paid'] =;
|
|
*/
|
|
return $data;
|
|
}
|
|
|
|
/**
|
|
* Returns a formatted HTML table of invoice line items
|
|
*
|
|
* @param array $columns The columns to be displayed
|
|
*
|
|
* @return string[HTML string
|
|
*/
|
|
public function table(array $columns) :?string
|
|
{
|
|
|
|
$data = '<table class="table table-striped items">';
|
|
$data .= '<thead><tr class="heading">';
|
|
|
|
$column_headers = $this->transformColumnsForHeader($columns);
|
|
|
|
foreach($column_headers as $column)
|
|
$data .= '<td>' . ctrans('texts.'.$column.'') . '</td>';
|
|
|
|
$data .= '</tr></thead>';
|
|
|
|
$columns = $this->transformColumnsForLineItems($columns);
|
|
|
|
$items = $this->transformLineItems($this->line_items);
|
|
|
|
foreach($items as $item)
|
|
{
|
|
|
|
$data .= '<tr class="item">';
|
|
|
|
foreach($columns as $column)
|
|
{
|
|
$data .= '<td>'. $item->{$column} . '</td>';
|
|
}
|
|
$data .= '</tr>';
|
|
|
|
}
|
|
|
|
$data .= '</table>';
|
|
|
|
return $data;
|
|
}
|
|
|
|
|
|
/**
|
|
* Transform the column headers into translated header values
|
|
*
|
|
* @param array $columns The column header values
|
|
* @return array The new column header variables
|
|
*/
|
|
private function transformColumnsForHeader(array $columns) :array
|
|
{
|
|
|
|
$pre_columns = $columns;
|
|
$columns = array_intersect($columns, self::$master_columns);
|
|
|
|
return str_replace([
|
|
'tax_name1',
|
|
'tax_name2'
|
|
],
|
|
[
|
|
'tax',
|
|
'tax',
|
|
],
|
|
$columns);
|
|
|
|
}
|
|
|
|
/**
|
|
*
|
|
* Transform the column headers into invoice variables
|
|
*
|
|
* @param array $columns The column header values
|
|
* @return array The invoice variables
|
|
*/
|
|
private function transformColumnsForLineItems(array $columns) :array
|
|
{
|
|
/* Removes any invalid columns the user has entered. */
|
|
$columns = array_intersect($columns, self::$master_columns);
|
|
|
|
return str_replace([
|
|
'custom_invoice_label1',
|
|
'custom_invoice_label2',
|
|
'custom_invoice_label3',
|
|
'custom_invoice_label4',
|
|
'tax_name1',
|
|
'tax_name2'
|
|
],
|
|
[
|
|
'custom_invoice_value1',
|
|
'custom_invoice_value2',
|
|
'custom_invoice_value3',
|
|
'custom_invoice_value4',
|
|
'tax_rate1',
|
|
'tax_rate2'
|
|
],
|
|
$columns);
|
|
|
|
}
|
|
|
|
/**
|
|
* Formats the line items for display
|
|
* @param array $items The array of invoice items
|
|
* @return array The formatted array of invoice items
|
|
*/
|
|
private function transformLineItems(array $items) :array
|
|
{
|
|
|
|
foreach($items as $item)
|
|
{
|
|
|
|
$item->cost = Number::formatMoney($item->cost, $this->client);
|
|
$item->line_total = Number::formatMoney($item->line_total, $this->client);
|
|
|
|
if(isset($item->discount) && $item->discount > 0)
|
|
{
|
|
|
|
if($item->is_amount_discount)
|
|
$item->discount = Number::formatMoney($item->discount, $this->client);
|
|
else
|
|
$item->discount = $item->discount . '%';
|
|
}
|
|
|
|
}
|
|
|
|
|
|
return $items;
|
|
}
|
|
|
|
/**
|
|
* Due to the way we are compiling the blade template we
|
|
* have no ability to iterate, so in the case
|
|
* of line taxes where there are multiple rows,
|
|
* we use this function to format a section of rows
|
|
*
|
|
* @return string a collection of <tr> rows with line item
|
|
* aggregate data
|
|
*/
|
|
private function makeLineTaxes() :string
|
|
{
|
|
|
|
$tax_map = $this->calc()->getTaxMap();
|
|
|
|
$data = '';
|
|
|
|
foreach($tax_map as $tax)
|
|
{
|
|
$data .= '<tr class="line_taxes">';
|
|
$data .= '<td>'. $tax['name'] .'</td>';
|
|
$data .= '<td>'. Number::formatMoney($tax['total'], $this->client) .'</td></tr>';
|
|
}
|
|
|
|
return $data;
|
|
}
|
|
|
|
/**
|
|
* @return string a collectino of <tr> with
|
|
* itemised total tax data
|
|
*/
|
|
|
|
private function makeTotalTaxes() :string
|
|
{
|
|
|
|
$total_tax_map = $this->calc()->getTotalTaxMap();
|
|
|
|
$data = '';
|
|
|
|
foreach($total_tax_map as $tax)
|
|
{
|
|
$data .= '<tr class="total_taxes">';
|
|
$data .= '<td>'. $tax['name'] .'</td>';
|
|
$data .= '<td>'. Number::formatMoney($tax['total'], $this->client) .'</td></tr>';
|
|
}
|
|
|
|
return $data;
|
|
|
|
}
|
|
} |