sfneal / users

src/Models/User.php

<?php

namespace Sfneal\Users\Models;

use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Database\Eloquent\Relations\HasOne;
use Illuminate\Database\Eloquent\Relations\MorphOne;
use Sfneal\Address\Models\Address;
use Sfneal\Address\Models\Traits\AddressAccessors;
use Sfneal\Casts\NewlineCast;
use Sfneal\Currency\Currency;
use Sfneal\Helpers\Strings\StringHelpers;
use Sfneal\Models\AuthModel;
use Sfneal\Scopes\OrderScope;
use Sfneal\Users\Builders\UserBuilder;
use Sfneal\Users\Factories\UserFactory;
use Sfneal\Users\Scopes\UserActiveScope;
use Sfneal\Users\Services\OrganizationService;
use Vkovic\LaravelCustomCasts\HasCustomCasts;

class User extends AuthModel
{
    // todo: refactor status to use Status model?
    use AddressAccessors;

The trait Sfneal\Address\Models\Traits\AddressAccessors requires some properties which are not provided by Sfneal\Users\Models\User: $city, $zip, $state, $address_2, $address, $address_1, $city_state

    use HasCustomCasts;
    use HasFactory;

    /**
     * The "booting" method of the model.
     *
     * @return void
     */
    protected static function boot()
    {
        parent::boot();

        // Global scopes
        static::addGlobalScope(new UserActiveScope());
        static::addGlobalScope(new OrderScope('last_name', 'asc'));
    }

    protected $dates = ['deleted_at'];
    protected $table = 'user';
    protected $primaryKey = 'id';

    /**
     * The attributes that are mass assignable.
     *
     * @var array
     */
    protected $fillable = [
        'role_id',
        'first_name',
        'middle_name',
        'last_name',
        'nickname',
        'nickname_preferred',
        'title',
        'suffix',
        'email',
        'phone_work',
        'phone_mobile',
        'fax',
        'website',
        'bio',
        'username',
        'password',
        'status',
        'rate',
    ];

    /**
     * The attributes that should be hidden from arrays.
     *
     * @var array
     */
    protected $hidden = [
        'password',
        'remember_token',
    ];

    /**
     * The attributes that should type cast.
     *
     * @var array
     */
    protected $casts = [
        'role_id' => 'int',
        'nickname_preferred' => 'int',
        'bio' => NewlineCast::class,
        'status' => 'int',
        'rate' => 'int',
    ];

    /**
     * @var array Attributes that should be appended to collections
     */
    protected $appends = [
        'name',
        'name_full',
    ];

    /**
     * Create a new factory instance for the model.
     *
     * @return UserFactory
     */
    protected static function newFactory(): UserFactory
    {
        return new UserFactory();
    }

    /**
     * Query Builder.
     *
     * @param  $query
     * @return UserBuilder
     */
    public function newEloquentBuilder($query)
    {
        return new UserBuilder($query);
    }

    /**
     * Custom User query Builder.
     *
     * @return UserBuilder|Builder
     */
    public static function query(): UserBuilder
    {
        return parent::query();
    }

    /**
     * User's 'role' relationship.
     *
     * @return BelongsTo
     */
    public function role()
    {
        return $this->belongsTo(Role::class, 'role_id', 'role_id');
    }

    /**
     * User's Notification Subscriptions.
     *
     * @return HasMany
     */
    public function notificationSubscriptions()
    {
        return $this->hasMany(UserNotification::class, 'user_id', 'id');
    }

    /**
     * User's 'team' relationship - indicates user is a member of the public team.
     *
     * @return HasOne
     */
    public function team()
    {
        return $this->hasOne(Team::class, 'user_id', 'id');
    }

    /**
     * User's address.
     *
     * @return MorphOne
     */
    public function address()
    {
        return $this->morphOne(Address::class, 'addressable');
    }

    /**
     * Determine if a User has a particular 'role_id'.
     *
     * @param  int  $role_id
     * @return bool
     */
    public function isRoleId(int $role_id): bool
    {
        return $this->role_id == $role_id;

The property role_id does not exist on Sfneal\Users\Models\User. Did you mean role?

    }

    /**
     * Determine if a User has a particular 'role name'.
     *
     * @param  string  $role
     * @return bool
     */
    public function isRole(string $role): bool
    {
        return strtolower($this->role->name) == strtolower($role);

The property name does not seem to exist on Sfneal\Users\Models\Role. Are you sure there is no database migration missing?

    }

    /**
     * Determine if a User has an 'admin' role.
     *
     * @return bool
     */
    public function isAdmin(): bool
    {
        // User is considered an 'admin' if user is a 'web developer'
        return $this->isRoleId(3) || $this->isRoleId(4);
    }

    /**
     * Determine if a User has a 'web developer' role.
     *
     * @return bool
     */
    public function isWebDeveloper(): bool
    {
        return $this->isRoleId(4);
    }

    /**
     * Determine if a User has an 'employee' role.
     *
     * @return bool
     */
    public function isEmployee(): bool
    {
        return $this->isRoleId(1);
    }

    /**
     * Determine if a User has an 'contractor' role.
     *
     * @return bool
     */
    public function isContractor(): bool
    {
        return $this->isRoleId(2);
    }

    /**
     * Determine if a User is 'active'.
     *
     * @return bool
     */
    public function isActive(): bool
    {
        return $this->attributes['status'] == 1;
    }

    /**
     * Determine if a User's $nickname is preferred over their $first_name.
     *
     * @return bool
     */
    public function isNicknamePreferred(): bool
    {
        return $this->attributes['nickname_preferred'] == 1;
    }

    /**
     * Retrieve a User's initials.
     *
     * @return string
     */
    public function getInitialsAttribute()
    {
        return StringHelpers::implodeFiltered('', collect([

array($this->attributes['first_name'], $this->attributes['middle_name'], $this->attributes['last_name']) of type array is incompatible with the type Illuminate\Contracts\Support\Arrayable expected by parameter $value of collect().

            $this->attributes['first_name'],
            $this->attributes['middle_name'],
            $this->attributes['last_name'],
        ])->map(function ($name) {
            return substr($name, 0, 1);
        })->toArray());
    }

    /**
     * Get the AWS S3 file upload directory for an Inquiry model by retrieving the table name and primary key.
     *
     * @param  string  $base_dir
     * @return string
     */
    public function getUploadDirectory($base_dir = 'images'): string
    {
        return $base_dir.'/'.str_replace('_', '-', $this->getTable()).'/'.$this->getKey();
    }

    /**
     * Mutate the 'middle_name' attribute.
     *
     * @param  string|null  $value
     */
    public function setMiddleNameAttribute(?string $value = null)
    {
        if (! is_null($value)) {
            // Remove leading & trailing whitespace
            $middle_name = trim($value);

            // Append '.' to the middle name if's a single letter
            $this->attributes['middle_name'] = strlen($middle_name) == 1 ? "{$middle_name}." : $middle_name;
        }
    }

    /**
     * Mutate the 'first_name' attribute.
     *
     * @param  string|null  $value
     */
    public function setFirstNameAttribute(?string $value = null)
    {
        if (! is_null($value)) {
            $this->attributes['first_name'] = trim($value);
        }
    }

    /**
     * Mutate the 'last_name' attribute.
     *
     * @param  string|null  $value
     */
    public function setLastNameAttribute(?string $value = null)
    {
        if (! is_null($value)) {
            $this->attributes['last_name'] = trim($value);
        }
    }

    /**
     * Access the 'first_name' attribute.
     *
     * @param  string|null  $value
     * @return string
     */
    public function getFirstNameAttribute(?string $value = null): string
    {
        return trim($value);

It seems like $value can also be of type null; however, parameter $string of trim() does only seem to accept string, maybe add an additional type check?

    }

    /**
     * Access the 'last_name' attribute.
     *
     * @param  string|null  $value
     * @return string
     */
    public function getLastNameAttribute(?string $value = null): string
    {
        return trim($value);

It seems like $value can also be of type null; however, parameter $string of trim() does only seem to accept string, maybe add an additional type check?

    }

    /**
     * Retrieve the User's name (first & last).
     *
     * @return string
     */
    public function getNameAttribute(): string
    {
        if ($this->nameAttributesAreNotAccessible()) {
            return '';
        }

        // Use nickname instead of first if it is set & preferred
        $first = (isset($this->attributes['nickname']) && $this->isNicknamePreferred())
            ? $this->attributes['nickname']
            : $this->attributes['first_name'];

        // Return concatenated name
        return "{$first} {$this->attributes['last_name']}";
    }

    /**
     * Retrieve the User's full name with middle initial.
     *
     * @return string
     */
    public function getNameFullAttribute(): string
    {
        if ($this->nameAttributesAreNotAccessible()) {
            return '';
        }

        $name = $this->attributes['first_name'];
        if (array_key_exists('middle_name', $this->attributes) && $this->attributes['middle_name']) {
            $name .= ' '.$this->attributes['middle_name'];
        }

        return "{$name} {$this->attributes['last_name']}";
    }

    private function nameAttributesAreNotAccessible(): bool
    {
        return ! isset($this->attributes['first_name']) || ! isset($this->attributes['last_name']);
    }

    /**
     * Retrieve the User's name with their suffix.
     *
     * @return string
     */
    public function getNameSuffixAttribute(): string
    {
        return $this->getNameFullAttribute().($this->attributes['suffix'] ? ", {$this->attributes['suffix']}" : '');
    }

    /**
     * Get the 'list_name' attribute.
     *
     * @return string
     */
    public function getListNameAttribute()
    {
        return implode(', ', array_reverse(explode(' ', $this->getNameAttribute())));
    }

    /**
     * Get the 'name_link' attribute that returns a url to the User's team.show page.
     *
     * @return string
     */
    public function getNameLinkAttribute()
    {
        return '<a href="'.route('user.show', ['user' => $this->getKey()]).'">'.$this->getNameAttribute().'</a>';
    }

    /**
     * Retrieve an email link.
     *
     * @return string
     */
    public function getEmailLinkAttribute(): string
    {
        return $this->attributes['email'] ? ('mailto:'.$this->attributes['email']) : '#!';
    }

    /**
     * Retrieve a work phone link.
     *
     * @return string
     */
    public function getPhoneWorkLinkAttribute(): string
    {
        return $this->attributes['phone_work'] ? ('tel:'.$this->attributes['phone_work']) : '#!';
    }

    /**
     * Retrieve a mobile phone link.
     *
     * @return string
     */
    public function getPhoneMobileLinkAttribute(): string
    {
        return $this->attributes['phone_mobile'] ? ('tel:'.$this->attributes['phone_mobile']) : '#!';
    }

    /**
     * Retrieve the User's rate formatted as dollars.
     *
     * @return string
     */
    public function getRateFormattedAttribute(): string
    {
        return (! empty($this->attributes['rate'])) ? Currency::dollars($this->attributes['rate']) : '-';
    }

    /**
     * Retrieve the raw 'text' attribute with newline chars.
     *
     * @return mixed
     */
    public function getTextareaAttribute()
    {
        return $this->attributes['bio'];
    }

    /**
     * Retrieve a User's custom email footer.
     *
     * @return string
     */
    public function getEmailFooterAttribute(): string
    {
        $footer = "{$this->attributes['name']}";
        $footer .= $this->attributes['title'] ? "\n{$this->attributes['title']}" : '';
        $footer .= "\n".OrganizationService::name() ?? '';
        $footer .= "\n".($this->attributes['phone_work'] ?? OrganizationService::phone()) ?? '';
        $footer .= $this->attributes['email'] ? "\n{$this->attributes['email']}" : '';

        return $footer;
    }
}