Šablony a data ve views

Každá šablona tématu dostává bohatou, předem poskládanou sadu proměnných — obsah, nastavení webu, navigaci, média a SEO data. Tento článek je referencí těchto dat a pravidel, kterých by se šablony měly držet.

Jak se šablona vybírá#

Pro obsah typu page na webu se šablonou mytheme Laravix vykreslí themes.mytheme::page.show.

Tento namespace se hledá nejdřív ve vaší šabloně a teprve pak ve výchozí, takže pohled „existuje", pokud ho poskytne kterákoli z nich. Teprve když ho nemá ani jedna — třeba u neznámého typu obsahu — spadne Laravix na themes.mytheme::default, který se hledá stejným způsobem. Stejná konvence platí pro každý typ obsahu včetně pluginových.

Prakticky: chcete-li změnit vzhled příspěvků, přidejte do své šablony post/show.blade.php. Chcete-li je nechat být, nepřidávejte nic. Viz Struktura šablony.

Dostupné proměnné#

Skládá je Laravix\Cms\Services\PageDataBuilder a CMS controller:

Práce s médii#

Modely médií nabízejí $media->url (originál) a $media->variantUrl(ImageVariant::LARGE) pro zmenšené varianty (THUMBNAIL, MEDIUM, LARGE, OG, FAVICON, FULL — viz Laravix\Cms\Enums\ImageVariant). Vždy vykreslete nejmenší variantu, která na dané místo stačí.

Práce s fieldy#

@php $fields = $content->fields->pluck('value', 'key'); @endphp
{{ $fields->get('excerpt') }}

Assety šablony#

Ze souboru udělají URL dva helpery, oba na Laravix\Cms\Laravix:

{{-- Stylesheet dodávaný s jádrem, z public/vendor/laravix/ --}}
<link rel="stylesheet" href="{{ \Laravix\Cms\Laravix::asset('app.css') }}">

{{-- Soubor, který si vaše šablona sestavila do themes/{theme}/dist/ --}}
@if ($themeStylesheet = \Laravix\Cms\Laravix::themeAsset('app.css', $site->theme))
    <link rel="stylesheet" href="{{ $themeStylesheet }}">
@endif

themeAsset() bere název souboru a klíč šablony a vrací null, když soubor v dist/ dané šablony není — vždy ho tedy ošetřete jako výše, místo abyste ho vypisovali rovnou do atributu. Vrácená URL končí značkou ?v= odvozenou z času poslední změny souboru, což zneplatní cache prohlížeče při každém přebuildování.

Oba helpery ukazují na skutečné soubory pod public/, což u šablon znamená symlink public/themes/{theme} vytvořený příkazem php artisan laravix:theme:link. Když se stylesheet šablony tiše nenačítá, zkontrolujte nejdřív tenhle odkaz.

Vykreslení obsahu z builderu#

Obsah navržený ve vizuálním builderu přichází jako $grapesjsHtml. Obsah postavený z klasických bloků přichází jako pole $content->blocks. Jádro dodává partial, který zvládá obojí, včetně JavaScriptu pro slidery, záložky, odpočty a bloky s vlastním kódem:

@include('laravix::cms.builder-content')

page/show.blade.php výchozí šablony dělá přesně tohle, když builder obsah existuje, a jinak spadne na prosté rozložení s titulkem a poli. Pokud bloky vykreslujete sami, každá položka $content->blocks je ['type' => ..., 'data' => [...]] a mapuje se na view šablony blocks/{type}.blade.php, které dostane data bloku plus $mediaMap.

URL a jazyky#

Odkazy na jiný obsah stavějte přes $content->path($defaultLocale) — vyřeší úvodní stránku, route prefixy i jazykové prefixy. V layoutu vypisujte alternates:

@foreach ($alternates as $altLocale => $altUrl)
    <link rel="alternate" hreflang="{{ $altLocale }}" href="{{ $altUrl }}">
@endforeach

SEO kontrakt#

Layouty by měly ctít pole $seo: $seo['title'] do <title>, vypsat popis a canonical odkaz, při $seo['noindex'] vydat robots meta noindex,nofollow a $seo['og_image_url'] použít pro Open Graph. layouts/app.blade.php výchozí šablony je kompletní referenční implementace včetně Open Graphu, Twitter karet a JSON-LD.

Související články#

• Struktura tématu
• Příkazy CLI — laravix:theme:link
• Vlastní bloky
• Obsahový model