License Key Required
No license key entered.
Enter or update your key with php artisan news:license <key>,
or purchase one at scriptgain.com.
Form
admin.officials._form
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 the admin panel by the staff layout.- Validation error bag. Always present. Pairs with @error('field').
- The admin sidebar navigation structure.
- Sub-items of the currently open nav group.
- Breadcrumb trail for the current page.
- Signed-in staffer's initials, for the avatar.
- Signed-in staffer's name.
- Signed-in staffer's email address.
- The staffer's role, e.g. "Administrator".
- True when the signed-in staffer is an administrator.
- Number of open service requests, for the badge.
- Number of unread form submissions, for the badge.
- The configured admin-shell width class.
- URL of the uploaded site logo, or null.
- URL of the uploaded favicon, or null.
In This Template
- Offices.
- Record.
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-card title="Official Details">
<div class="grid gap-5 sm:grid-cols-2">
<x-field label="Full Name" for="name" required :error="$errors->first('name')">
<x-input id="name" name="name" :value="old('name', $record->name)" required />
</x-field>
<x-field label="Office Held" for="office" required :error="$errors->first('office')">
<input list="office-options" id="office" name="office" value="{{ old('office', $record->office) }}" required
class="block w-full rounded-lg border-0 py-2 px-3 text-sm text-slate-900 ring-1 ring-inset ring-slate-300 focus:ring-2 focus:ring-brand-600">
<datalist id="office-options">
@foreach ($offices as $office)
<option value="{{ $office }}"></option>
@endforeach
</datalist>
</x-field>
<x-field label="District Or Ward" for="district" :error="$errors->first('district')">
<x-input id="district" name="district" :value="old('district', $record->district)" placeholder="Ward 3, At Large" />
</x-field>
<x-field label="Sort Order" for="sort_order" hint="The mayor is usually 0." :error="$errors->first('sort_order')">
<x-input id="sort_order" name="sort_order" type="number" min="0" :value="old('sort_order', $record->sort_order ?? 0)" />
</x-field>
<x-field label="Term Start" for="term_start" :error="$errors->first('term_start')">
<x-input id="term_start" name="term_start" type="date" :value="old('term_start', $record->term_start?->format('Y-m-d'))" />
</x-field>
<x-field label="Term End" for="term_end" :error="$errors->first('term_end')">
<x-input id="term_end" name="term_end" type="date" :value="old('term_end', $record->term_end?->format('Y-m-d'))" />
</x-field>
<x-field label="Email" for="email" :error="$errors->first('email')">
<x-input id="email" name="email" type="email" :value="old('email', $record->email)" />
</x-field>
<x-field label="Phone" for="phone" :error="$errors->first('phone')">
<x-input id="phone" name="phone" :value="old('phone', $record->phone)" />
</x-field>
<x-field label="Biography" for="bio" class="sm:col-span-2" :error="$errors->first('bio')">
<textarea id="bio" name="bio" rows="8"
class="block w-full rounded-lg border-0 py-2 px-3 text-sm text-slate-900 ring-1 ring-inset ring-slate-300 focus:ring-2 focus:ring-brand-600">{{ old('bio', $record->bio) }}</textarea>
</x-field>
<x-field label="Photograph" for="photo" :error="$errors->first('photo')">
<input id="photo" name="photo" type="file" accept="image/*"
class="block w-full text-sm text-slate-600 file:mr-3 file:rounded-lg file:border-0 file:bg-brand-50 file:px-4 file:py-2 file:text-sm file:font-medium file:text-brand-700 hover:file:bg-brand-100">
@if ($record->photo_path)
<img src="{{ news_upload_url($record->photo_path) }}" alt="Current photograph" class="mt-3 h-20 w-20 rounded-full object-cover ring-1 ring-slate-200">
@endif
</x-field>
<div class="space-y-4">
<x-toggle name="is_current" :checked="old('is_current', $record->is_current ?? true)"
label="Currently In Office"
description="Former officials move to the historical roster." />
<x-toggle name="is_published" :checked="old('is_published', $record->is_published ?? true)"
label="Show On The Public Site" />
</div>
</div>
</x-card>
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.