. */ declare(strict_types=1); namespace FireflyIII\TransactionRules\Triggers; use FireflyIII\Models\TransactionJournal; use FireflyIII\Repositories\Journal\JournalRepositoryInterface; use Log; /** * Class FromAccountContains. */ final class FromAccountContains 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 mixed $value * * @return bool */ public static function willMatchEverything($value = null): bool { if (null !== $value) { $res = '' === (string)$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 from-account contains X * * @param TransactionJournal $journal * * @return bool */ public function triggered(TransactionJournal $journal): bool { /** @var JournalRepositoryInterface $repository */ $repository = app(JournalRepositoryInterface::class); $source = $repository->getSourceAccount($journal); $strpos = stripos($source->name, $this->triggerValue); if (!(false === $strpos)) { Log::debug( sprintf( 'RuleTrigger %s for journal #%d: "%s" contains "%s", return true.', get_class($this), $journal->id, $source->name, $this->triggerValue ) ); return true; } Log::debug( sprintf( 'RuleTrigger %s for journal #%d: "%s" does not contain "%s", return false.', get_class($this), $journal->id, $source->name, $this->triggerValue ) ); return false; } }