'boolean', 'use_totp' => 'boolean', 'gravatar' => 'boolean', ]; /** * @var array */ protected $dates = ['totp_authenticated_at']; /** * The attributes excluded from the model's JSON form. * * @var array */ protected $hidden = ['password', 'remember_token', 'totp_secret', 'totp_authenticated_at']; /** * Default values for specific fields in the database. * * @var array */ protected $attributes = [ 'external_id' => null, 'root_admin' => false, 'language' => 'en', 'use_totp' => false, 'totp_secret' => null, ]; /** * Rules verifying that the data being stored matches the expectations of the database. * * @var array */ public static $validationRules = [ 'uuid' => 'required|string|size:36|unique:users,uuid', 'email' => 'required|email|between:1,191|unique:users,email', 'external_id' => 'sometimes|nullable|string|max:191|unique:users,external_id', 'username' => 'required|between:1,191|unique:users,username', 'name_first' => 'required|string|between:1,191', 'name_last' => 'required|string|between:1,191', 'password' => 'sometimes|nullable|string', 'root_admin' => 'boolean', 'language' => 'string', 'use_totp' => 'boolean', 'totp_secret' => 'nullable|string', ]; /** * Implement language verification by overriding Eloquence's gather * rules function. */ public static function getRules() { $rules = parent::getRules(); $rules['language'][] = new In(array_keys((new self)->getAvailableLanguages())); $rules['username'][] = new Username; return $rules; } /** * Return the user model in a format that can be passed over to Vue templates. * * @return array */ public function toReactObject(): array { $object = (new Collection($this->toArray()))->except(['id', 'external_id'])->toArray(); $object['avatar_url'] = $this->avatarURL(); $object['role_name'] = $this->roleName(); return $object; } /** * Send the password reset notification. * * @param string $token */ public function sendPasswordResetNotification($token) { $this->notify(new ResetPasswordNotification($token)); } /** * Store the username as a lowercase string. * * @param string $value */ public function setUsernameAttribute(string $value) { $this->attributes['username'] = mb_strtolower($value); } /** * Return a concatenated result for the accounts full name. * * @return string */ public function getNameAttribute() { return trim($this->name_first . ' ' . $this->name_last); } /** * Get's the avatar url for the user. * * @return string */ public function avatarURL(): string { return 'https://www.gravatar.com/avatar/' . md5($this->email) . '.jpg'; } /** * Get's the name of the role assigned to a user. * * @return string|null */ public function roleName():? string { return $this->root_admin ? 'Super Administrator' : null; } /** * Gets the admin role associated with a user. * * @return \Illuminate\Database\Eloquent\Relations\HasOne */ public function adminRole() { return $this->hasOne(AdminRole::class, 'id', 'admin_role_id'); } /** * Returns all servers that a user owns. * * @return \Illuminate\Database\Eloquent\Relations\HasMany */ public function servers() { return $this->hasMany(Server::class, 'owner_id'); } /** * @return \Illuminate\Database\Eloquent\Relations\HasMany */ public function apiKeys() { return $this->hasMany(ApiKey::class) ->where('key_type', ApiKey::TYPE_ACCOUNT); } /** * @return \Illuminate\Database\Eloquent\Relations\HasMany */ public function recoveryTokens() { return $this->hasMany(RecoveryToken::class); } /** * Returns all of the servers that a user can access by way of being the owner of the * server, or because they are assigned as a subuser for that server. * * @return \Illuminate\Database\Eloquent\Builder */ public function accessibleServers() { return Server::query() ->select('servers.*') ->leftJoin('subusers', 'subusers.server_id', '=', 'servers.id') ->where(function (Builder $builder) { $builder->where('servers.owner_id', $this->id)->orWhere('subusers.user_id', $this->id); }) ->groupBy('servers.id'); } }