. */ declare(strict_types=1); namespace FireflyIII\Models; use Crypt; use Illuminate\Database\Eloquent\Model; use Illuminate\Database\Eloquent\Relations\BelongsTo; use Illuminate\Database\Eloquent\SoftDeletes; use Symfony\Component\HttpKernel\Exception\NotFoundHttpException; use Watson\Validating\ValidatingTrait; /** * Class Category. */ class Category extends Model { use SoftDeletes, ValidatingTrait; /** * The attributes that should be casted to native types. * * @var array */ protected $casts = [ 'created_at' => 'datetime', 'updated_at' => 'datetime', 'deleted_at' => 'datetime', 'encrypted' => 'boolean', ]; /** @var array */ protected $fillable = ['user_id', 'name']; /** @var array */ protected $hidden = ['encrypted']; /** @var array */ protected $rules = ['name' => 'required|between:1,200']; /** * @param array $fields * * @return Category */ public static function firstOrCreateEncrypted(array $fields) { // everything but the name: $query = self::orderBy('id'); $search = $fields; unset($search['name']); foreach ($search as $name => $value) { $query->where($name, $value); } $set = $query->get(['categories.*']); /** @var Category $category */ foreach ($set as $category) { if ($category->name === $fields['name']) { return $category; } } // create it! $category = self::create($fields); return $category; } /** * @param string $value * * @return Category */ public static function routeBinder($guard, string $value): Category { if ($guard->check()) { $categoryId = intval($value); $category = $guard->user()->categories()->find($categoryId); if (!is_null($category)) { return $category; } } throw new NotFoundHttpException; } /** * @codeCoverageIgnore * * @param $value * * @return string */ public function getNameAttribute($value) { if ($this->encrypted) { return Crypt::decrypt($value); } return $value; } /** * @codeCoverageIgnore * * @param $value */ public function setNameAttribute($value) { $encrypt = config('firefly.encryption'); $this->attributes['name'] = $encrypt ? Crypt::encrypt($value) : $value; $this->attributes['encrypted'] = $encrypt; } /** * @codeCoverageIgnore * @return \Illuminate\Database\Eloquent\Relations\BelongsToMany */ public function transactionJournals() { return $this->belongsToMany('FireflyIII\Models\TransactionJournal', 'category_transaction_journal', 'category_id'); } /** * @codeCoverageIgnore * @return \Illuminate\Database\Eloquent\Relations\BelongsToMany */ public function transactions() { return $this->belongsToMany('FireflyIII\Models\Transaction', 'category_transaction', 'category_id'); } /** * @codeCoverageIgnore * @return BelongsTo */ public function user(): BelongsTo { return $this->belongsTo('FireflyIII\User'); } }