Ein Foto gehoert zu keinem (ganzjaehrig) oder mehreren Erscheinungsbildern und erscheint nur dort, vor den ganzjaehrigen Fotos. Bausteine waehlen "automatisch" oder eine eigene Auswahl; Titelbereich und Abschluss zeigen das erste passende Foto ihrer Liste. Titelbild und "Bilder je Baustein" des Erscheinungsbilds werden in die Bausteine uebernommen und entfallen dort. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
127 lines
4.3 KiB
PHP
127 lines
4.3 KiB
PHP
<?php
|
||
|
||
namespace App\Models;
|
||
|
||
use App\Models\Concerns\BelongsToTenant;
|
||
use App\Tenancy\TenantContext;
|
||
use Carbon\CarbonInterface;
|
||
use Database\Factories\AppearanceFactory;
|
||
use Illuminate\Database\Eloquent\Attributes\Fillable;
|
||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
||
use Illuminate\Database\Eloquent\Model;
|
||
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
||
|
||
/**
|
||
* A seasonal look of a site (e.g. summer, winter, Christmas, New Year's Eve): colour tokens, texts and banner
|
||
* change, photos made for it (Photo::appearance_ids) are shown – the page structure does not (sections may be limited to
|
||
* appearances, see SectionRegistry). Offers are advertised by their own rules (OfferShowcase). The period recurs every year ("MM-DD" to "MM-DD",
|
||
* inclusive; a period may run over the turn of the year). The default appearance applies when none matches.
|
||
*/
|
||
#[Fillable(['site_id', 'name', 'starts_md', 'ends_md', 'priority', 'is_default', 'is_active', 'tokens', 'overrides'])]
|
||
class Appearance extends Model
|
||
{
|
||
/** @use HasFactory<AppearanceFactory> */
|
||
use BelongsToTenant, HasFactory;
|
||
|
||
/**
|
||
* Texts an appearance can replace, with their admin labels. Sections read them through Theme::text().
|
||
*/
|
||
public const OVERRIDABLE = [
|
||
'banner.text' => 'Banner: Text',
|
||
'banner.link_label' => 'Banner: Link-Text',
|
||
'banner.link_url' => 'Banner: Link-Ziel',
|
||
'hero.eyebrow' => 'Titelbereich: kleine Überschrift',
|
||
'hero.title' => 'Titelbereich: Überschrift',
|
||
'hero.text' => 'Titelbereich: Text',
|
||
'cta.title' => 'Abschluss: Überschrift',
|
||
'cta.text' => 'Abschluss: Text',
|
||
];
|
||
|
||
/**
|
||
* Get the attributes that should be cast.
|
||
*
|
||
* @return array<string, string>
|
||
*/
|
||
protected function casts(): array
|
||
{
|
||
return [
|
||
'is_default' => 'boolean',
|
||
'is_active' => 'boolean',
|
||
'tokens' => 'array',
|
||
'overrides' => 'array',
|
||
];
|
||
}
|
||
|
||
/**
|
||
* @return BelongsTo<Site, $this>
|
||
*/
|
||
public function site(): BelongsTo
|
||
{
|
||
return $this->belongsTo(Site::class);
|
||
}
|
||
|
||
/**
|
||
* Names by id of the landlord's appearances, loaded once per request and landlord.
|
||
*
|
||
* @return array<int, string>
|
||
*/
|
||
public static function names(): array
|
||
{
|
||
// once() keys its cache by the closure's bound variables, so each landlord gets its own entry.
|
||
$tenantId = app(TenantContext::class)->id();
|
||
|
||
return once(function (): array {
|
||
return self::query()->pluck('name', 'id')->all();
|
||
});
|
||
}
|
||
|
||
/**
|
||
* Choices for "Zeigen in" at the photos, e.g. "Winter · 01.11.–31.03."; with several websites prefixed by the website.
|
||
*
|
||
* @return array<int, string>
|
||
*/
|
||
public static function photoOptions(): array
|
||
{
|
||
$appearances = self::query()->with('site')->orderByDesc('is_default')->orderBy('starts_md')->orderBy('name')->get();
|
||
$severalSites = $appearances->pluck('site_id')->unique()->count() > 1;
|
||
|
||
return $appearances->mapWithKeys(fn (Appearance $appearance): array => [
|
||
$appearance->id => ($severalSites ? $appearance->site?->name.': ' : '').$appearance->periodLabel(),
|
||
])->all();
|
||
}
|
||
|
||
/**
|
||
* "Winter · 01.11.–31.03.", "Standard · wenn kein Zeitraum passt".
|
||
*/
|
||
public function periodLabel(): string
|
||
{
|
||
if ($this->starts_md === null || $this->ends_md === null) {
|
||
return $this->name.($this->is_default ? ' · wenn kein Zeitraum passt' : '');
|
||
}
|
||
|
||
$day = fn (string $monthDay): string => substr($monthDay, 3, 2).'.'.substr($monthDay, 0, 2).'.';
|
||
|
||
return $this->name.' · '.$day($this->starts_md).'–'.$day($this->ends_md);
|
||
}
|
||
|
||
public function covers(CarbonInterface $date): bool
|
||
{
|
||
if ($this->starts_md === null || $this->ends_md === null) {
|
||
return false;
|
||
}
|
||
|
||
$day = $date->format('m-d');
|
||
|
||
return $this->starts_md <= $this->ends_md
|
||
? $day >= $this->starts_md && $day <= $this->ends_md
|
||
: $day >= $this->starts_md || $day <= $this->ends_md;
|
||
}
|
||
|
||
public function override(string $key): ?string
|
||
{
|
||
$value = data_get($this->overrides, $key);
|
||
|
||
return filled($value) ? (string) $value : null;
|
||
}
|
||
}
|