License Key Required
No license key entered.
Enter or update your key with php artisan news:license <key>,
or purchase one at scriptgain.com.
Show
site.files.show
Compiled PHP
What Blade turns your template into. This is what the syntax check parses.
Loading…
Available Variables And Components
A guide to what this template can use, derived from the shipped source. Click any item to insert it at your cursor. It is a helpful reference, not a runtime guarantee.
Always Available
Shared with every public page by the site layout.- Validation error bag. Always present. Pairs with @error('field').
- All site settings as an array, e.g. $site['site_name'].
- The municipality's short display name.
- The full legal name, e.g. "City Of Springfield".
- Main navigation items. Loop over it with @foreach.
- The small utility links in the top bar.
- The footer navigation links.
- The Quick Links grid items.
- The first few Quick Links, featured in the hero.
- The current emergency alert, or null when none is live.
- Up to eight departments listed in the footer.
- The configured page-width class, e.g. max-w-7xl. Use on your outer container.
- The current year, for the footer copyright line.
- URL of the uploaded site logo, or null.
- URL of the uploaded favicon, or null.
In This Template
- Breadcrumb trail for the current page.
- File.
- Related.
Drop any of these in. Click to insert the opening tag at your cursor.
General
Admin Panel
Layouts
Records
Site (Public)
Common Blade
- Print a value, safely escaped. The default choice.
- Print raw HTML. Only for content you trust.
- Show something conditionally.
- Loop over a collection.
- Loop, with a fallback when the collection is empty.
- Show a validation message for a field.
- A small block of PHP. Never on line 1. Keep logic out of templates.
- A comment that never reaches the browser.
Civic Helpers
- Build a URL to a named route, e.g. a department page.
- Link to a single news post.
- Turn a stored upload path into a public URL.
- A cache-busted URL for a bundled asset.
- Read a config value, e.g. the site width class.
- Build an absolute URL to a path.
No History Yet
Every save, revert, and reset of this template is recorded here, with a one-click way back to any of them.
The Template That Shipped With The Product
Read only. This is what Reset To Default puts back.
<x-layouts.public :title="$file->title">
<x-site.page-hero :title="$file->title" :eyebrow="$file->folder?->name" :crumbs="$crumbs" />
<x-site.section :divider="false">
<div class="grid gap-10 lg:grid-cols-3">
<div class="min-w-0 lg:col-span-2">
@if ($file->description)
<div class="prose-civic">{!! nl2br(e($file->description)) !!}</div>
@endif
@if ($file->isImage())
<figure class="mt-8">
<img src="{{ $file->url() }}" alt="{{ $file->alt_text }}"
class="w-full rounded-2xl object-contain ring-1 ring-slate-200">
@if ($file->alt_text)
<figcaption class="mt-2 text-sm text-slate-500">{{ $file->alt_text }}</figcaption>
@endif
</figure>
@endif
<a href="{{ route('site.files.download', $file) }}"
class="mt-8 flex items-center gap-4 rounded-2xl bg-brand-700 p-6 text-white transition hover:bg-brand-800 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-brand-600 focus-visible:ring-offset-2">
<x-icon name="download" class="w-8 h-8 shrink-0" />
<span class="min-w-0">
<span class="block text-lg font-semibold">Download This File</span>
<span class="block truncate text-sm text-brand-100">{{ $file->file_name }} · {{ $file->sizeDisplay() }}</span>
</span>
</a>
</div>
<aside class="space-y-6" aria-label="File Details">
<div class="rounded-2xl bg-slate-50 p-6 ring-1 ring-slate-200">
<h2 class="font-semibold text-slate-900">File Details</h2>
<span class="seal-rule mt-3 mb-4"></span>
<dl class="space-y-3 text-sm">
@if ($file->reference)
<div>
<dt class="font-medium text-slate-500">Reference</dt>
<dd class="text-slate-900">{{ $file->reference }}</dd>
</div>
@endif
@if ($file->document_date)
<div>
<dt class="font-medium text-slate-500">Document Date</dt>
<dd class="text-slate-900">{{ $file->document_date->format(config('news.date_format')) }}</dd>
</div>
@endif
@if ($file->folder)
<div>
<dt class="font-medium text-slate-500">Folder</dt>
<dd><a href="{{ route('site.files', ['folder' => $file->folder->slug]) }}" class="rounded text-brand-700 hover:underline focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-brand-600">{{ $file->folder->name }}</a></dd>
</div>
@endif
@if ($file->department)
<div>
<dt class="font-medium text-slate-500">Department</dt>
<dd><a href="{{ route('site.departments.show', $file->department->slug) }}" class="rounded text-brand-700 hover:underline focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-brand-600">{{ $file->department->name }}</a></dd>
</div>
@endif
<div>
<dt class="font-medium text-slate-500">File</dt>
<dd class="text-slate-900">{{ $file->extension() }} · {{ $file->sizeDisplay() }}</dd>
</div>
</dl>
</div>
@if ($related->count())
<div class="rounded-2xl bg-white p-6 ring-1 ring-slate-200">
<h2 class="font-semibold text-slate-900">Related Files</h2>
<span class="seal-rule mt-3 mb-4"></span>
<ul class="space-y-3 text-sm">
@foreach ($related as $item)
<li><a href="{{ route('site.files.show', $item) }}" class="rounded text-brand-700 hover:underline focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-brand-600">{{ $item->title }}</a></li>
@endforeach
</ul>
</div>
@endif
</aside>
</div>
</x-site.section>
</x-layouts.public>
Blade In One Screen
The directives you will use most.
- Print a value, escaped. Safe by default.
- Print raw HTML. Only for content you trust.
- Show something conditionally.
- Loop over a collection.
- Use a shared component. Every component in Shared Components is available.
- A comment that never reaches the browser.
{{ $variable }}
{!! $html !!}
@if / @else / @endif
@foreach / @endforeach
<x-card>
{{-- comment --}}
House Rules
Follow these and your edits will survive updates.
-
Never start line 1 with
@php. Blade mis-parses it and the page fails. The editor refuses to save it. - Keep logic out of templates. If you need a calculation, it belongs in a composer or component class, not here.
- The shipped file is never modified. Reset To Default always gets you back.
- Every save is versioned. You can revert to any earlier version in one click.
- Press Tab inside the editor to indent rather than jump to the next field.