. */ declare(strict_types=1); namespace FireflyIII\Models; use FireflyIII\Enums\UserRoleEnum; use FireflyIII\Support\Models\ReturnsIntegerIdTrait; use FireflyIII\User; use Illuminate\Database\Eloquent\Model; use Illuminate\Database\Eloquent\Relations\BelongsToMany; use Illuminate\Database\Eloquent\Relations\HasMany; use Illuminate\Database\Eloquent\Relations\HasManyThrough; use Symfony\Component\HttpKernel\Exception\NotFoundHttpException; /** * @mixin IdeHelperUserGroup */ class UserGroup extends Model { use ReturnsIntegerIdTrait; protected $fillable = ['title']; /** * Route binder. Converts the key in the URL to the specified object (or throw 404). * * @throws NotFoundHttpException */ public static function routeBinder(string $value): self { if (auth()->check()) { $userGroupId = (int)$value; /** @var User $user */ $user = auth()->user(); /** @var null|UserGroup $userGroup */ $userGroup = self::find($userGroupId); if (null === $userGroup) { throw new NotFoundHttpException(); } // need at least ready only to be aware of the user group's existence, // but owner/full role (in the group) or global owner role may overrule this. $access = $user->hasRoleInGroupOrOwner($userGroup, UserRoleEnum::READ_ONLY) || $user->hasRole('owner'); if ($access) { return $userGroup; } } throw new NotFoundHttpException(); } /** * Link to accounts. */ public function accounts(): HasMany { return $this->hasMany(Account::class); } /** * Link to attachments. */ public function attachments(): HasMany { return $this->hasMany(Attachment::class); } /** * Link to bills. */ public function availableBudgets(): HasMany { return $this->hasMany(AvailableBudget::class); } /** * Link to bills. */ public function bills(): HasMany { return $this->hasMany(Bill::class); } /** * Link to budgets. */ public function budgets(): HasMany { return $this->hasMany(Budget::class); } /** * Link to categories. */ public function categories(): HasMany { return $this->hasMany(Category::class); } /** * Link to currencies */ public function currencies(): BelongsToMany { return $this->belongsToMany(TransactionCurrency::class)->withTimestamps()->withPivot('group_default'); } /** * Link to exchange rates. */ public function currencyExchangeRates(): HasMany { return $this->hasMany(CurrencyExchangeRate::class); } public function groupMemberships(): HasMany { return $this->hasMany(GroupMembership::class); } public function objectGroups(): HasMany { return $this->hasMany(ObjectGroup::class); } /** * Link to piggy banks. */ public function piggyBanks(): HasManyThrough { return $this->hasManyThrough(PiggyBank::class, Account::class); } public function recurrences(): HasMany { return $this->hasMany(Recurrence::class); } public function ruleGroups(): HasMany { return $this->hasMany(RuleGroup::class); } public function rules(): HasMany { return $this->hasMany(Rule::class); } public function tags(): HasMany { return $this->hasMany(Tag::class); } public function transactionGroups(): HasMany { return $this->hasMany(TransactionGroup::class); } /** * Link to transaction journals. */ public function transactionJournals(): HasMany { return $this->hasMany(TransactionJournal::class); } public function webhooks(): HasMany { return $this->hasMany(Webhook::class); } }