class Project extends Model

Traits

HasFactory

Properties

protected array $hidden

The attributes hidden from the model's JSON form.

Methods

Builder
scopeInCommon(Builder $query, User $user, int $volumeId, array $roles = null)

Scope a query to all projects that the user and the volume with the given ID have in common.

Builder
scopeAccessibleBy(Builder $query, User $user)

Scope a query to all projects that are accessible by a user.

BelongsToMany
users()

The members of this project. Every member has a project-specific project_role_id besides their global user role.

BelongsToMany
admins()

All members of this project with the admin role.

BelongsToMany
editors()

All members of this project with the editor role.

BelongsToMany
guests()

All members of this project with the guest role.

BelongsTo
creator()

The user that created this project. On creation this user is automatically added to the project's users with the 'admin' role by the ProjectObserver.

HasMany
invitations()

The project invitations of this project.

void
addUserId(int $userId, int $roleId)

Adds the user with the given role to this project.

void
changeRole(int $userId, int $roleId)

Changes the role of an existing user in this project.

bool
userCanBeRemoved(int $userId)

Determines if the user can be removed from the project.

bool
removeUserId(int $userId)

Removes the user by ID from this project.

BelongsToMany
volumes()

The volumes of this project.

BelongsToMany
imageVolumes()

The image volumes of this project.

BelongsToMany
videoVolumes()

The video volumes of this project.

void
addVolumeId(int $id) deprecated

Adds a volume to this project if it wasn't already.

removeVolume(Volume $volume, bool $force = false)

Detaches the volume from this project. Fails if this is the last project, the volume is attached to, unless force is true.

removeAllVolumes(bool $force = false)

Detaches all volumes from this project. Fails if this is the last project, one of the volumes is attached to, unless force is true.

BelongsToMany
labelTrees()

The label trees, this project is using.

BelongsToMany
authorizedLabelTrees()

The private label trees that authorized this project to use them.

string
getThumbnailUrlAttribute()

URL to a unique thumbnail image for this project.

bool
hasGeoInfo()

Check if the project has volumes which have some images with GPS coordinates.

flushGeoInfoCache()

Flush the cached information if this project has volumes which have images with GPS coordinates.

Details

at line 34
Builder scopeInCommon(Builder $query, User $user, int $volumeId, array $roles = null)

Scope a query to all projects that the user and the volume with the given ID have in common.

Parameters

Builder $query
User $user
int $volumeId
array $roles

Array of role IDs to restrict the project membership to. Default is any role.

Return Value

Builder

at line 54
Builder scopeAccessibleBy(Builder $query, User $user)

Scope a query to all projects that are accessible by a user.

Parameters

Builder $query
User $user

Return Value

Builder

at line 74
BelongsToMany users()

The members of this project. Every member has a project-specific project_role_id besides their global user role.

Return Value

BelongsToMany

at line 85
BelongsToMany admins()

All members of this project with the admin role.

Return Value

BelongsToMany

at line 95
BelongsToMany editors()

All members of this project with the editor role.

Return Value

BelongsToMany

at line 105
BelongsToMany guests()

All members of this project with the guest role.

Return Value

BelongsToMany

at line 117
BelongsTo creator()

The user that created this project. On creation this user is automatically added to the project's users with the 'admin' role by the ProjectObserver.

Return Value

BelongsTo

at line 127
HasMany invitations()

The project invitations of this project.

Return Value

HasMany

at line 139
void addUserId(int $userId, int $roleId)

Adds the user with the given role to this project.

Parameters

int $userId
int $roleId

Return Value

void

at line 151
void changeRole(int $userId, int $roleId)

Changes the role of an existing user in this project.

Parameters

int $userId
int $roleId

Return Value

void

at line 162
bool userCanBeRemoved(int $userId)

Determines if the user can be removed from the project.

Parameters

int $userId

Return Value

bool

at line 173
bool removeUserId(int $userId)

Removes the user by ID from this project.

Parameters

int $userId

Return Value

bool

at line 187
BelongsToMany volumes()

The volumes of this project.

Return Value

BelongsToMany

at line 197
BelongsToMany imageVolumes()

The image volumes of this project.

Return Value

BelongsToMany

at line 207
BelongsToMany videoVolumes()

The video volumes of this project.

Return Value

BelongsToMany

at line 219
void addVolumeId(int $id) deprecated

deprecated Use `$project->volumes()->attach($id)` instead.

Adds a volume to this project if it wasn't already.

Parameters

int $id

Return Value

void

at line 234
removeVolume(Volume $volume, bool $force = false)

Detaches the volume from this project. Fails if this is the last project, the volume is attached to, unless force is true.

Parameters

Volume $volume
bool $force

Delete the volume completely if this is the last project it belongs to

at line 264
removeAllVolumes(bool $force = false)

Detaches all volumes from this project. Fails if this is the last project, one of the volumes is attached to, unless force is true.

Parameters

bool $force

at line 287
BelongsToMany labelTrees()

The label trees, this project is using.

Return Value

BelongsToMany

at line 297
BelongsToMany authorizedLabelTrees()

The private label trees that authorized this project to use them.

Return Value

BelongsToMany

at line 307
string getThumbnailUrlAttribute()

URL to a unique thumbnail image for this project.

Return Value

string

at line 328
bool hasGeoInfo()

Check if the project has volumes which have some images with GPS coordinates.

Return Value

bool

at line 342
flushGeoInfoCache()

Flush the cached information if this project has volumes which have images with GPS coordinates.