. */ declare(strict_types=1); namespace FireflyIII\TransactionRules\Triggers; use FireflyIII\Models\TransactionJournal; use FireflyIII\Repositories\Journal\JournalRepositoryInterface; use Log; /** * Class AmountMore. */ final class AmountMore extends AbstractTrigger implements TriggerInterface { /** * A trigger is said to "match anything", or match any given transaction, * when the trigger value is very vague or has no restrictions. Easy examples * are the "AmountMore"-trigger combined with an amount of 0: any given transaction * has an amount of more than zero! Other examples are all the "Description"-triggers * which have hard time handling empty trigger values such as "" or "*" (wild cards). * * If the user tries to create such a trigger, this method MUST return true so Firefly III * can stop the storing / updating the trigger. If the trigger is in any way restrictive * (even if it will still include 99.9% of the users transactions), this method MUST return * false. * * @param null $value * * @return bool */ public static function willMatchEverything($value = null) { if (null !== $value) { $res = 0 === bccomp('0', strval($value)); if (true === $res) { Log::error(sprintf('Cannot use %s with a value equal to 0.', self::class)); } return $res; } Log::error(sprintf('Cannot use %s with a null value.', self::class)); return true; } /** * Returns true when amount is more than X. * * @param TransactionJournal $journal * * @return bool */ public function triggered(TransactionJournal $journal): bool { /** @var JournalRepositoryInterface $repos */ $repos = app(JournalRepositoryInterface::class); $repos->setUser($journal->user); $amount = $journal->destination_amount ?? $repos->getJournalTotal($journal); $compare = $this->triggerValue; $result = bccomp($amount, $compare); if (1 === $result) { Log::debug(sprintf('RuleTrigger AmountMore for journal #%d: %d is more than %d, so return true', $journal->id, $amount, $compare)); return true; } Log::debug(sprintf('RuleTrigger AmountMore for journal #%d: %d is NOT more than %d, so return false', $journal->id, $amount, $compare)); return false; } }