. */ declare(strict_types=1); namespace FireflyIII\TransactionRules\Triggers; use FireflyIII\Models\Account; use FireflyIII\Models\TransactionJournal; use Log; /** * Class ToAccountStarts. */ final class ToAccountStarts 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 = '' === strval($value); if (true === $res) { Log::error(sprintf('Cannot use %s with "" as a value.', self::class)); } return $res; } Log::error(sprintf('Cannot use %s with a null value.', self::class)); return true; } /** * Returns true when to-account starts with X * * @param TransactionJournal $journal * * @return bool */ public function triggered(TransactionJournal $journal): bool { $toAccountName = ''; /** @var Account $account */ foreach ($journal->destinationAccountList() as $account) { $toAccountName .= strtolower($account->name); } $search = strtolower($this->triggerValue); $part = substr($toAccountName, 0, strlen($search)); if ($part === $search) { Log::debug(sprintf('RuleTrigger ToAccountStarts for journal #%d: "%s" starts with "%s", return true.', $journal->id, $toAccountName, $search)); return true; } Log::debug(sprintf('RuleTrigger ToAccountStarts for journal #%d: "%s" does not start with "%s", return false.', $journal->id, $toAccountName, $search)); return false; } }