2019-02-17 11:34:46 +01:00
|
|
|
<?php
|
|
|
|
|
|
|
|
namespace App\DataMapper;
|
|
|
|
|
2019-03-02 22:44:08 +01:00
|
|
|
use App\DataMapper\ClientSettings;
|
|
|
|
use App\DataMapper\CompanySettings;
|
|
|
|
use App\Utils\TranslationHelper;
|
|
|
|
|
2019-02-17 11:34:46 +01:00
|
|
|
/**
|
|
|
|
* ClientSettings
|
2019-04-08 14:43:20 +02:00
|
|
|
*
|
|
|
|
* Client settings are built as a superset of Company Settings
|
|
|
|
*
|
|
|
|
* If no client settings is specified, the default company setting is used.
|
|
|
|
*
|
|
|
|
* Client settings are passed down to the entity level where they can be further customized and then saved
|
|
|
|
* into the settings column of the entity, so there is no need to create additional entity level settings handlers.
|
|
|
|
*
|
2019-02-17 11:34:46 +01:00
|
|
|
*/
|
|
|
|
class ClientSettings extends BaseSettings
|
|
|
|
{
|
2019-03-02 22:44:08 +01:00
|
|
|
/**
|
2019-04-08 14:43:20 +02:00
|
|
|
* Settings which also have a parent company setting
|
2019-03-02 22:44:08 +01:00
|
|
|
*/
|
2019-02-17 11:34:46 +01:00
|
|
|
public $timezone_id;
|
2019-03-02 22:44:08 +01:00
|
|
|
public $date_format_id;
|
|
|
|
public $datetime_format_id;
|
|
|
|
public $military_time;
|
|
|
|
public $start_of_week;
|
|
|
|
public $financial_year_start;
|
2019-04-29 00:40:38 +02:00
|
|
|
public $payment_terms;
|
2019-03-02 22:44:08 +01:00
|
|
|
|
2019-02-17 11:34:46 +01:00
|
|
|
public $language_id;
|
|
|
|
public $currency_id;
|
2019-03-02 22:44:08 +01:00
|
|
|
public $default_task_rate;
|
|
|
|
public $send_reminders;
|
|
|
|
public $show_tasks_in_portal;
|
|
|
|
public $custom_message_dashboard;
|
|
|
|
public $custom_message_unpaid_invoice;
|
|
|
|
public $custom_message_paid_invoice;
|
|
|
|
public $custom_message_unapproved_quote;
|
|
|
|
public $show_currency_symbol;
|
|
|
|
public $show_currency_code;
|
2019-04-08 14:43:20 +02:00
|
|
|
public $inclusive_taxes;
|
2019-03-02 22:44:08 +01:00
|
|
|
|
2019-04-18 00:00:04 +02:00
|
|
|
public $custom_taxes1;
|
|
|
|
public $custom_taxes2;
|
2019-04-22 01:21:57 +02:00
|
|
|
public $lock_sent_invoices;
|
2019-04-23 14:22:13 +02:00
|
|
|
public $auto_bill;
|
2019-04-18 00:00:04 +02:00
|
|
|
|
2019-04-29 00:40:38 +02:00
|
|
|
/**
|
|
|
|
* Counter Variables
|
|
|
|
*/
|
|
|
|
public $invoice_number_prefix;
|
|
|
|
public $invoice_number_pattern;
|
|
|
|
|
|
|
|
public $quote_number_prefix;
|
|
|
|
public $quote_number_pattern;
|
|
|
|
|
|
|
|
public $client_number_prefix;
|
|
|
|
public $client_number_pattern;
|
|
|
|
|
|
|
|
public $credit_number_prefix;
|
|
|
|
public $credit_number_pattern;
|
|
|
|
|
|
|
|
public $shared_invoice_quote_counter;
|
|
|
|
|
2019-03-02 22:44:08 +01:00
|
|
|
/**
|
2019-04-29 02:54:26 +02:00
|
|
|
* Settings which which are unique to client settings
|
2019-03-02 22:44:08 +01:00
|
|
|
*/
|
|
|
|
public $industry_id;
|
|
|
|
public $size_id;
|
2019-04-24 03:49:41 +02:00
|
|
|
public $invoice_email_list; //default comma separated list of contact ids to email
|
2019-03-02 22:44:08 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Cast object values and return entire class
|
|
|
|
* prevents missing properties from not being returned
|
|
|
|
* and always ensure an up to date class is returned
|
|
|
|
*
|
|
|
|
* @return \stdClass
|
|
|
|
*/
|
|
|
|
public function __construct($obj)
|
|
|
|
{
|
|
|
|
parent::__construct($obj);
|
|
|
|
}
|
|
|
|
|
2019-02-17 11:34:46 +01:00
|
|
|
/**
|
2019-03-02 22:44:08 +01:00
|
|
|
*
|
|
|
|
* Default Client Settings scaffold
|
|
|
|
*
|
2019-02-17 11:34:46 +01:00
|
|
|
* @return \stdClass
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
public static function defaults() : \stdClass
|
|
|
|
{
|
|
|
|
|
|
|
|
return (object)[
|
2019-04-29 00:40:38 +02:00
|
|
|
'industry_id' => NULL,
|
|
|
|
'size_id' => NULL,
|
|
|
|
'invoice_email_list' => NULL,
|
2019-02-17 11:34:46 +01:00
|
|
|
];
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2019-03-02 22:44:08 +01:00
|
|
|
/**
|
|
|
|
* Merges settings from Company to Client
|
|
|
|
*
|
|
|
|
* @param \stdClass $company_settings
|
|
|
|
* @param \stdClass $client_settings
|
|
|
|
* @return \stdClass of merged settings
|
|
|
|
*/
|
2019-04-17 08:20:32 +02:00
|
|
|
public static function buildClientSettings($company_settings, $client_settings)
|
2019-03-02 22:44:08 +01:00
|
|
|
{
|
|
|
|
|
|
|
|
|
|
|
|
foreach($client_settings as $key => $value)
|
|
|
|
{
|
|
|
|
|
2019-04-24 12:01:40 +02:00
|
|
|
if(!isset($client_settings->{$key}) && property_exists($company_settings, $key)) {
|
2019-03-02 22:44:08 +01:00
|
|
|
$client_settings->{$key} = $company_settings->{$key};
|
2019-04-24 12:01:40 +02:00
|
|
|
}
|
2019-03-02 22:44:08 +01:00
|
|
|
|
2019-04-08 14:43:20 +02:00
|
|
|
}
|
|
|
|
|
2019-03-02 22:44:08 +01:00
|
|
|
return $client_settings;
|
|
|
|
}
|
|
|
|
|
2019-02-17 11:34:46 +01:00
|
|
|
}
|
|
|
|
|