. */ declare(strict_types=1); namespace FireflyIII\Support; use FireflyIII\Exceptions\FireflyException; use FireflyIII\Models\Transaction as TransactionModel; use FireflyIII\Models\TransactionCurrency; use FireflyIII\Models\TransactionJournal; use FireflyIII\Models\TransactionType; use FireflyIII\User; use Illuminate\Support\Collection; use Preferences as Prefs; /** * Class Amount * * @package FireflyIII\Support */ class Amount { /** * bool $sepBySpace is $localeconv['n_sep_by_space'] * int $signPosn = $localeconv['n_sign_posn'] * string $sign = $localeconv['negative_sign'] * bool $csPrecedes = $localeconv['n_cs_precedes'] * * @param bool $sepBySpace * @param int $signPosn * @param string $sign * @param bool $csPrecedes * * @return string */ public static function getAmountJsConfig(bool $sepBySpace, int $signPosn, string $sign, bool $csPrecedes): string { // negative first: $space = ' '; // require space between symbol and amount? if (!$sepBySpace) { $space = ''; // no } // there are five possible positions for the "+" or "-" sign (if it is even used) // pos_a and pos_e could be the ( and ) symbol. $posA = ''; // before everything $posB = ''; // before currency symbol $posC = ''; // after currency symbol $posD = ''; // before amount $posE = ''; // after everything // format would be (currency before amount) // AB%sC_D%vE // or: // AD%v_B%sCE (amount before currency) // the _ is the optional space // switch on how to display amount: switch ($signPosn) { default: case 0: // ( and ) around the whole thing $posA = '('; $posE = ')'; break; case 1: // The sign string precedes the quantity and currency_symbol $posA = $sign; break; case 2: // The sign string succeeds the quantity and currency_symbol $posE = $sign; break; case 3: // The sign string immediately precedes the currency_symbol $posB = $sign; break; case 4: // The sign string immediately succeeds the currency_symbol $posC = $sign; } // default is amount before currency $format = $posA . $posD . '%v' . $space . $posB . '%s' . $posC . $posE; if ($csPrecedes) { // alternative is currency before amount $format = $posA . $posB . '%s' . $posC . $space . $posD . '%v' . $posE; } return $format; } /** * This method will properly format the given number, in color or "black and white", * as a currency, given two things: the currency required and the current locale. * * @param \FireflyIII\Models\TransactionCurrency $format * @param string $amount * @param bool $coloured * * @return string */ public function formatAnything(TransactionCurrency $format, string $amount, bool $coloured = true): string { $locale = explode(',', trans('config.locale')); $locale = array_map('trim', $locale); setlocale(LC_MONETARY, $locale); $float = round($amount, 12); $info = localeconv(); $formatted = number_format($float, intval($format->decimal_places), $info['mon_decimal_point'], $info['mon_thousands_sep']); // some complicated switches to format the amount correctly: $precedes = $amount < 0 ? $info['n_cs_precedes'] : $info['p_cs_precedes']; $separated = $amount < 0 ? $info['n_sep_by_space'] : $info['p_sep_by_space']; $space = $separated ? ' ' : ''; $result = $format->symbol . $space . $formatted; if (!$precedes) { $result = $formatted . $space . $format->symbol; } if ($coloured === true) { if ($amount > 0) { return sprintf('%s', $result); } if ($amount < 0) { return sprintf('%s', $result); } return sprintf('%s', $result); } return $result; } /** * @return Collection */ public function getAllCurrencies(): Collection { return TransactionCurrency::orderBy('code', 'ASC')->get(); } /** * @return string */ public function getCurrencyCode(): string { $cache = new CacheProperties; $cache->addProperty('getCurrencyCode'); if ($cache->has()) { return $cache->get(); // @codeCoverageIgnore } else { $currencyPreference = Prefs::get('currencyPreference', config('firefly.default_currency', 'EUR')); $currency = TransactionCurrency::where('code', $currencyPreference->data)->first(); if ($currency) { $cache->store($currency->code); return $currency->code; } $cache->store(config('firefly.default_currency', 'EUR')); return strval(config('firefly.default_currency', 'EUR')); } } /** * @return string */ public function getCurrencySymbol(): string { $cache = new CacheProperties; $cache->addProperty('getCurrencySymbol'); if ($cache->has()) { return $cache->get(); // @codeCoverageIgnore } $currencyPreference = Prefs::get('currencyPreference', config('firefly.default_currency', 'EUR')); $currency = TransactionCurrency::where('code', $currencyPreference->data)->first(); $cache->store($currency->symbol); return $currency->symbol; } /** * @return \FireflyIII\Models\TransactionCurrency * @throws FireflyException */ public function getDefaultCurrency(): TransactionCurrency { $user = auth()->user(); return $this->getDefaultCurrencyByUser($user); } /** * @param User $user * * @return \FireflyIII\Models\TransactionCurrency * @throws FireflyException */ public function getDefaultCurrencyByUser(User $user): TransactionCurrency { $cache = new CacheProperties; $cache->addProperty('getDefaultCurrency'); $cache->addProperty($user->id); if ($cache->has()) { return $cache->get(); // @codeCoverageIgnore } $currencyPreference = Prefs::getForUser($user, 'currencyPreference', config('firefly.default_currency', 'EUR')); $currency = TransactionCurrency::where('code', $currencyPreference->data)->first(); if (is_null($currency)) { throw new FireflyException(sprintf('No currency found with code "%s"', $currencyPreference->data)); } $cache->store($currency); return $currency; } /** * This method returns the correct format rules required by accounting.js, * the library used to format amounts in charts. * * @param array $config * * @return array */ public function getJsConfig(array $config): array { $negative = self::getAmountJsConfig($config['n_sep_by_space'] === 1, $config['n_sign_posn'], $config['negative_sign'], $config['n_cs_precedes'] === 1); $positive = self::getAmountJsConfig($config['p_sep_by_space'] === 1, $config['p_sign_posn'], $config['positive_sign'], $config['p_cs_precedes'] === 1); return [ 'pos' => $positive, 'neg' => $negative, 'zero' => $positive, ]; } }