License Key Required

No license key entered. Enter or update your key with php artisan news:license <key>, or purchase one at scriptgain.com.

Fields

admin.bill-types._fields

All Templates

Status Shipped Default Shipped File resources/views/admin/bill-types/_fields.blade.php

admin.bill-types._fields 88 lines

Not Checked Yet

{{-- Shared create/edit fields for a bill type. --}}
<x-card title="What Residents See">
    <div class="grid gap-5 sm:grid-cols-2">
        <x-field label="Label" for="label" required
                 hint="What a resident sees on the payment page. For example: Water And Sewer Bill."
                 :error="$errors->first('label')">
            <x-input id="label" name="label" required maxlength="120" :value="old('label', $record->label)" />
        </x-field>

        <x-field label="Icon" for="icon" :error="$errors->first('icon')">
            <x-select id="icon" name="icon">
                @foreach ($iconOptions as $icon)
                    <option value="{{ $icon }}" @selected(old('icon', $record->icon ?: 'file-text') === $icon)>{{ $icon }}</option>
                @endforeach
            </x-select>
        </x-field>

        <x-field label="Description" for="description" class="sm:col-span-2"
                 hint="One line explaining what this covers. Shown under the label."
                 :error="$errors->first('description')">
            <textarea id="description" name="description" rows="2" maxlength="1000"
                      class="block w-full rounded-lg border-0 px-3 py-2 text-sm text-slate-900 ring-1 ring-inset ring-slate-300 focus:ring-2 focus:ring-inset focus:ring-brand-500">{{ old('description', $record->description) }}</textarea>
        </x-field>
    </div>
</x-card>

<x-card title="How Residents Pay It">
    <div class="space-y-6">
        <x-toggle name="requires_lookup"
                  :checked="old('requires_lookup', $record->exists ? $record->requires_lookup : true)"
                  label="Requires A Bill Reference"
                  description="The resident must look their bill up by reference number plus a second factor. Correct for utility bills and citations, where you issued the bill." />

        <x-toggle name="allows_open_payment"
                  :checked="old('allows_open_payment', $record->allows_open_payment)"
                  label="Can Be Paid Without A Bill Reference"
                  description="The resident types the amount themselves. Correct for permit fees and facility rentals, where no bill was ever issued. Set sensible limits below." />

        <x-toggle name="is_active"
                  :checked="old('is_active', $record->exists ? $record->is_active : true)"
                  label="Visible On The Public Site"
                  description="Switch this off to retire a type without deleting the bills raised under it." />
    </div>
</x-card>

<x-card title="Limits And Routing"
        subtitle="Limits apply only when a resident types the amount themselves. A bill-backed payment always charges the bill's balance.">
    <div class="grid gap-5 sm:grid-cols-2">
        <x-field label="Minimum Amount" for="min_amount"
                 hint="Leave blank to use the module default."
                 :error="$errors->first('min_amount')">
            <x-input id="min_amount" name="min_amount" inputmode="decimal"
                     :value="old('min_amount', $record->minDecimal())" placeholder="1.00" class="tabular" />
        </x-field>

        <x-field label="Maximum Amount" for="max_amount"
                 hint="A ceiling protects against a mistyped amount, for example 50000 instead of 500.00."
                 :error="$errors->first('max_amount')">
            <x-input id="max_amount" name="max_amount" inputmode="decimal"
                     :value="old('max_amount', $record->maxDecimal())" placeholder="5000.00" class="tabular" />
        </x-field>

        <x-field label="Department" for="department_id"
                 hint="For reporting. Does not change where the money goes."
                 :error="$errors->first('department_id')">
            <x-select id="department_id" name="department_id">
                <option value="">Not Department Specific</option>
                @foreach ($departments as $department)
                    <option value="{{ $department->id }}" @selected(old('department_id', $record->department_id) == $department->id)>{{ $department->name }}</option>
                @endforeach
            </x-select>
        </x-field>

        <x-field label="Sort Order" for="sort_order"
                 hint="Lower numbers appear first on the public page."
                 :error="$errors->first('sort_order')">
            <x-input id="sort_order" name="sort_order" type="number" min="0" max="9999"
                     :value="old('sort_order', $record->sort_order ?? 0)" class="tabular" />
        </x-field>

        <x-field label="Key" for="key" class="sm:col-span-2"
                 hint="Used in the public payment URL. Generated from the label if left blank. Changing it breaks any link already printed on a bill."
                 :error="$errors->first('key')">
            <x-input id="key" name="key" maxlength="64" :value="old('key', $record->key)" placeholder="utility" />
        </x-field>
    </div>
</x-card>

Change Note

Optional. Shown in the version history so the next person knows why.

Saving runs the same check. An invalid template is refused, not stored.

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

A collection of departments.

Icon Options.

Record.

Drop any of these in. Click to insert the opening tag at your cursor.

General

type, info, title

initials, src, name, size, md

color, neutral, dot

action, label, Record, modal

variant, primary, size, md, href, …

title, subtitle, padding, flush

name, action, method, POST, title, …

action, name, title, message, confirm, …

href, icon, danger

align, right, width

icon, folder, title, description

label, for, hint, error, required

href, icon, title, variant, secondary, …

name

type, text

name, title, subtitle, icon, tone, …

href, icon, active

title, subtitle, icon, back

title, subtitle, href, linkLabel

ids

id, label, Row

items

label, value, icon, trend, trendColor, …

color, neutral, pulse, label

name

flush

tabs, default

name, checked, label, description

Admin Panel

title, message, icon, folder, href, …

tree, active, rootLabel, rootHref

title, subtitle, icon, edit, action, …

title, icon, folder, subtitle, records, …

search, placeholder, createHref, createLabel

edit, delete, preview, name, title, …

record, kind, Page

Layouts

title, shellMaxWidth

title, description, heroless, maxWidth

Records

name, action, reference, trigger, icon

Site (Public)

href, title, description, icon, meta, …

title, message, icon, folder

title, subtitle, eyebrow, icon, crumbs, …

supportEmail, supportPhone

disclaimer, takedownContact, retentionDays, compact

title, subtitle, href, linkLabel, tone, …

maxWidth

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.

{{-- Shared create/edit fields for a bill type. --}}
<x-card title="What Residents See">
    <div class="grid gap-5 sm:grid-cols-2">
        <x-field label="Label" for="label" required
                 hint="What a resident sees on the payment page. For example: Water And Sewer Bill."
                 :error="$errors->first('label')">
            <x-input id="label" name="label" required maxlength="120" :value="old('label', $record->label)" />
        </x-field>

        <x-field label="Icon" for="icon" :error="$errors->first('icon')">
            <x-select id="icon" name="icon">
                @foreach ($iconOptions as $icon)
                    <option value="{{ $icon }}" @selected(old('icon', $record->icon ?: 'file-text') === $icon)>{{ $icon }}</option>
                @endforeach
            </x-select>
        </x-field>

        <x-field label="Description" for="description" class="sm:col-span-2"
                 hint="One line explaining what this covers. Shown under the label."
                 :error="$errors->first('description')">
            <textarea id="description" name="description" rows="2" maxlength="1000"
                      class="block w-full rounded-lg border-0 px-3 py-2 text-sm text-slate-900 ring-1 ring-inset ring-slate-300 focus:ring-2 focus:ring-inset focus:ring-brand-500">{{ old('description', $record->description) }}</textarea>
        </x-field>
    </div>
</x-card>

<x-card title="How Residents Pay It">
    <div class="space-y-6">
        <x-toggle name="requires_lookup"
                  :checked="old('requires_lookup', $record->exists ? $record->requires_lookup : true)"
                  label="Requires A Bill Reference"
                  description="The resident must look their bill up by reference number plus a second factor. Correct for utility bills and citations, where you issued the bill." />

        <x-toggle name="allows_open_payment"
                  :checked="old('allows_open_payment', $record->allows_open_payment)"
                  label="Can Be Paid Without A Bill Reference"
                  description="The resident types the amount themselves. Correct for permit fees and facility rentals, where no bill was ever issued. Set sensible limits below." />

        <x-toggle name="is_active"
                  :checked="old('is_active', $record->exists ? $record->is_active : true)"
                  label="Visible On The Public Site"
                  description="Switch this off to retire a type without deleting the bills raised under it." />
    </div>
</x-card>

<x-card title="Limits And Routing"
        subtitle="Limits apply only when a resident types the amount themselves. A bill-backed payment always charges the bill's balance.">
    <div class="grid gap-5 sm:grid-cols-2">
        <x-field label="Minimum Amount" for="min_amount"
                 hint="Leave blank to use the module default."
                 :error="$errors->first('min_amount')">
            <x-input id="min_amount" name="min_amount" inputmode="decimal"
                     :value="old('min_amount', $record->minDecimal())" placeholder="1.00" class="tabular" />
        </x-field>

        <x-field label="Maximum Amount" for="max_amount"
                 hint="A ceiling protects against a mistyped amount, for example 50000 instead of 500.00."
                 :error="$errors->first('max_amount')">
            <x-input id="max_amount" name="max_amount" inputmode="decimal"
                     :value="old('max_amount', $record->maxDecimal())" placeholder="5000.00" class="tabular" />
        </x-field>

        <x-field label="Department" for="department_id"
                 hint="For reporting. Does not change where the money goes."
                 :error="$errors->first('department_id')">
            <x-select id="department_id" name="department_id">
                <option value="">Not Department Specific</option>
                @foreach ($departments as $department)
                    <option value="{{ $department->id }}" @selected(old('department_id', $record->department_id) == $department->id)>{{ $department->name }}</option>
                @endforeach
            </x-select>
        </x-field>

        <x-field label="Sort Order" for="sort_order"
                 hint="Lower numbers appear first on the public page."
                 :error="$errors->first('sort_order')">
            <x-input id="sort_order" name="sort_order" type="number" min="0" max="9999"
                     :value="old('sort_order', $record->sort_order ?? 0)" class="tabular" />
        </x-field>

        <x-field label="Key" for="key" class="sm:col-span-2"
                 hint="Used in the public payment URL. Generated from the label if left blank. Changing it breaks any link already printed on a bill."
                 :error="$errors->first('key')">
            <x-input id="key" name="key" maxlength="64" :value="old('key', $record->key)" placeholder="utility" />
        </x-field>
    </div>
</x-card>

Blade In One Screen

The directives you will use most.

{{ $variable }}

Print a value, escaped. Safe by default.

{!! $html !!}

Print raw HTML. Only for content you trust.

@if / @else / @endif

Show something conditionally.

@foreach / @endforeach

Loop over a collection.

<x-card>

Use a shared component. Every component in Shared Components is available.

{{-- comment --}}

A comment that never reaches the browser.

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.