'datetime']; /** * The attributes excluded from the model's JSON form. * * @var array */ protected $hidden = [ 'password', 'remember_token', 'system_name', 'email_confirmed', 'external_auth_id', 'email', 'created_at', 'updated_at', 'image_id', 'roles', 'avatar', 'user_id', ]; /** * This holds the user's permissions when loaded. */ protected ?Collection $permissions; /** * This holds the user's avatar URL when loaded to prevent re-calculating within the same request. */ protected string $avatarUrl = ''; /** * This holds the default user when loaded. * * @var null|User */ protected static ?User $defaultUser = null; /** * Returns the default public user. */ public static function getDefault(): self { if (!is_null(static::$defaultUser)) { return static::$defaultUser; } static::$defaultUser = static::query()->where('system_name', '=', 'public')->first(); return static::$defaultUser; } /** * Check if the user is the default public user. */ public function isDefault(): bool { return $this->system_name === 'public'; } /** * The roles that belong to the user. * * @return BelongsToMany */ public function roles() { if ($this->id === 0) { return; } return $this->belongsToMany(Role::class); } /** * Check if the user has a role. */ public function hasRole($roleId): bool { return $this->roles->pluck('id')->contains($roleId); } /** * Check if the user has a role. */ public function hasSystemRole(string $roleSystemName): bool { return $this->roles->pluck('system_name')->contains($roleSystemName); } /** * Attach the default system role to this user. */ public function attachDefaultRole(): void { $roleId = intval(setting('registration-role')); if ($roleId && $this->roles()->where('id', '=', $roleId)->count() === 0) { $this->roles()->attach($roleId); } } /** * Check if the user has a particular permission. */ public function can(string $permissionName): bool { if ($this->email === 'guest') { return false; } return $this->permissions()->contains($permissionName); } /** * Get all permissions belonging to the current user. */ protected function permissions(): Collection { if (isset($this->permissions)) { return $this->permissions; } $this->permissions = $this->newQuery()->getConnection()->table('role_user', 'ru') ->select('role_permissions.name as name')->distinct() ->leftJoin('permission_role', 'ru.role_id', '=', 'permission_role.role_id') ->leftJoin('role_permissions', 'permission_role.permission_id', '=', 'role_permissions.id') ->where('ru.user_id', '=', $this->id) ->pluck('name'); return $this->permissions; } /** * Clear any cached permissions on this instance. */ public function clearPermissionCache() { $this->permissions = null; } /** * Attach a role to this user. */ public function attachRole(Role $role) { $this->roles()->attach($role->id); } /** * Get the social account associated with this user. */ public function socialAccounts(): HasMany { return $this->hasMany(SocialAccount::class); } /** * Check if the user has a social account, * If a driver is passed it checks for that single account type. * * @param bool|string $socialDriver * * @return bool */ public function hasSocialAccount($socialDriver = false) { if ($socialDriver === false) { return $this->socialAccounts()->count() > 0; } return $this->socialAccounts()->where('driver', '=', $socialDriver)->exists(); } /** * Returns a URL to the user's avatar. */ public function getAvatar(int $size = 50): string { $default = url('/user_avatar.png'); $imageId = $this->image_id; if ($imageId === 0 || $imageId === '0' || $imageId === null) { return $default; } if (!empty($this->avatarUrl)) { return $this->avatarUrl; } try { $avatar = $this->avatar ? url($this->avatar->getThumb($size, $size, false)) : $default; } catch (Exception $err) { $avatar = $default; } $this->avatarUrl = $avatar; return $avatar; } /** * Get the avatar for the user. */ public function avatar(): BelongsTo { return $this->belongsTo(Image::class, 'image_id'); } /** * Get the API tokens assigned to this user. */ public function apiTokens(): HasMany { return $this->hasMany(ApiToken::class); } /** * Get the favourite instances for this user. */ public function favourites(): HasMany { return $this->hasMany(Favourite::class); } /** * Get the MFA values belonging to this use. */ public function mfaValues(): HasMany { return $this->hasMany(MfaValue::class); } /** * Get the last activity time for this user. */ public function scopeWithLastActivityAt(Builder $query) { $query->addSelect(['activities.created_at as last_activity_at']) ->leftJoinSub(function (\Illuminate\Database\Query\Builder $query) { $query->from('activities')->select('user_id') ->selectRaw('max(created_at) as created_at') ->groupBy('user_id'); }, 'activities', 'users.id', '=', 'activities.user_id'); } /** * Get the url for editing this user. */ public function getEditUrl(string $path = ''): string { $uri = '/settings/users/' . $this->id . '/' . trim($path, '/'); return url(rtrim($uri, '/')); } /** * Get the url that links to this user's profile. */ public function getProfileUrl(): string { return url('/user/' . $this->slug); } /** * Get a shortened version of the user's name. */ public function getShortName(int $chars = 8): string { if (mb_strlen($this->name) <= $chars) { return $this->name; } $splitName = explode(' ', $this->name); if (mb_strlen($splitName[0]) <= $chars) { return $splitName[0]; } return ''; } /** * Send the password reset notification. * * @param string $token * * @return void */ public function sendPasswordResetNotification($token) { $this->notify(new ResetPassword($token)); } /** * {@inheritdoc} */ public function logDescriptor(): string { return "({$this->id}) {$this->name}"; } /** * {@inheritdoc} */ public function refreshSlug(): string { $this->slug = app(SlugGenerator::class)->generate($this); return $this->slug; } }