License Key Required

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

Import

admin.bills.import

All Templates

Status Shipped Default Shipped File resources/views/admin/bills/import.blade.php

admin.bills.import 92 lines

Not Checked Yet

<x-layouts.app title="Import Bills">
    <x-page-header title="Import Bills" icon="upload"
                   subtitle="Load a billing run from a CSV file exported by your utility billing or finance system.">
        <x-slot:actions>
            <x-button variant="secondary" icon="chevron-left" :href="route('bills.index')">Back To Bills</x-button>
        </x-slot:actions>
    </x-page-header>

    @error('file')
        <div class="mb-5 rounded-lg bg-rose-50 px-4 py-3 text-sm text-rose-800 ring-1 ring-rose-200">{{ $message }}</div>
    @enderror

    <div class="grid gap-6 lg:grid-cols-3">
        <x-card class="lg:col-span-2" title="Upload A CSV File">
            <form method="POST" action="{{ route('bills.import.store') }}" enctype="multipart/form-data" class="space-y-5">
                @csrf

                <x-field label="Bill Type" for="bill_type_id" required
                         hint="Every bill in this file is created as this type."
                         :error="$errors->first('bill_type_id')">
                    <x-select id="bill_type_id" name="bill_type_id" required>
                        <option value="">Choose A Type</option>
                        @foreach ($types as $type)
                            <option value="{{ $type->id }}">{{ $type->label }}</option>
                        @endforeach
                    </x-select>
                </x-field>

                <x-field label="CSV File" for="file" required
                         hint="Up to 5 MB. The first row must be a header row."
                         :error="$errors->first('file')">
                    <input id="file" name="file" type="file" accept=".csv,text/csv" required
                           class="block w-full rounded-lg border-0 bg-white px-3 py-2 text-sm text-slate-900 ring-1 ring-inset ring-slate-300 file:mr-3 file:rounded-md file:border-0 file:bg-brand-50 file:px-3 file:py-1.5 file:text-sm file:font-medium file:text-brand-700 focus:ring-2 focus:ring-inset focus:ring-brand-500">
                </x-field>

                <div class="section-divider pt-5 flex items-center justify-end gap-2">
                    <x-button variant="secondary" :href="route('bills.index')">Cancel</x-button>
                    <x-button type="submit" icon="upload">Import Bills</x-button>
                </div>
            </form>
        </x-card>

        <x-card title="File Format" subtitle="Column headers are matched by name, in any order.">
            <dl class="space-y-3 text-sm">
                <div>
                    <dt class="font-medium text-slate-900">amount <span class="text-rose-500">required</span></dt>
                    <dd class="text-slate-500">The amount due, for example 124.50</dd>
                </div>
                <div>
                    <dt class="font-medium text-slate-900">account_number</dt>
                    <dd class="text-slate-500">Utility account or citation number</dd>
                </div>
                <div>
                    <dt class="font-medium text-slate-900">name</dt>
                    <dd class="text-slate-500">Who the bill is addressed to</dd>
                </div>
                <div>
                    <dt class="font-medium text-slate-900">email</dt>
                    <dd class="text-slate-500">Used for the receipt, and to link the bill to a resident record</dd>
                </div>
                <div>
                    <dt class="font-medium text-slate-900">phone</dt>
                    <dd class="text-slate-500">Optional</dd>
                </div>
                <div>
                    <dt class="font-medium text-slate-900">last_name</dt>
                    <dd class="text-slate-500">Second factor for online lookup. Taken from <span class="font-mono text-xs">name</span> if absent</dd>
                </div>
                <div>
                    <dt class="font-medium text-slate-900">zip</dt>
                    <dd class="text-slate-500">Second factor for online lookup. Recommended</dd>
                </div>
                <div>
                    <dt class="font-medium text-slate-900">description</dt>
                    <dd class="text-slate-500">Shown to the resident, for example "Water and sewer, March 2026"</dd>
                </div>
                <div>
                    <dt class="font-medium text-slate-900">due_date</dt>
                    <dd class="text-slate-500">Any recognisable date format</dd>
                </div>
            </dl>

            <div class="section-divider mt-5 pt-5">
                <p class="text-sm text-slate-600">
                    Reference numbers are generated automatically. Rows with a missing or unreadable amount are
                    skipped and reported back to you by line number rather than being silently dropped.
                </p>
            </div>
        </x-card>
    </div>
</x-layouts.app>

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

Types.

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, portalName, Portal, nav, heading, …

title, docTitle, Document, back

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.

<x-layouts.app title="Import Bills">
    <x-page-header title="Import Bills" icon="upload"
                   subtitle="Load a billing run from a CSV file exported by your utility billing or finance system.">
        <x-slot:actions>
            <x-button variant="secondary" icon="chevron-left" :href="route('bills.index')">Back To Bills</x-button>
        </x-slot:actions>
    </x-page-header>

    @error('file')
        <div class="mb-5 rounded-lg bg-rose-50 px-4 py-3 text-sm text-rose-800 ring-1 ring-rose-200">{{ $message }}</div>
    @enderror

    <div class="grid gap-6 lg:grid-cols-3">
        <x-card class="lg:col-span-2" title="Upload A CSV File">
            <form method="POST" action="{{ route('bills.import.store') }}" enctype="multipart/form-data" class="space-y-5">
                @csrf

                <x-field label="Bill Type" for="bill_type_id" required
                         hint="Every bill in this file is created as this type."
                         :error="$errors->first('bill_type_id')">
                    <x-select id="bill_type_id" name="bill_type_id" required>
                        <option value="">Choose A Type</option>
                        @foreach ($types as $type)
                            <option value="{{ $type->id }}">{{ $type->label }}</option>
                        @endforeach
                    </x-select>
                </x-field>

                <x-field label="CSV File" for="file" required
                         hint="Up to 5 MB. The first row must be a header row."
                         :error="$errors->first('file')">
                    <input id="file" name="file" type="file" accept=".csv,text/csv" required
                           class="block w-full rounded-lg border-0 bg-white px-3 py-2 text-sm text-slate-900 ring-1 ring-inset ring-slate-300 file:mr-3 file:rounded-md file:border-0 file:bg-brand-50 file:px-3 file:py-1.5 file:text-sm file:font-medium file:text-brand-700 focus:ring-2 focus:ring-inset focus:ring-brand-500">
                </x-field>

                <div class="section-divider pt-5 flex items-center justify-end gap-2">
                    <x-button variant="secondary" :href="route('bills.index')">Cancel</x-button>
                    <x-button type="submit" icon="upload">Import Bills</x-button>
                </div>
            </form>
        </x-card>

        <x-card title="File Format" subtitle="Column headers are matched by name, in any order.">
            <dl class="space-y-3 text-sm">
                <div>
                    <dt class="font-medium text-slate-900">amount <span class="text-rose-500">required</span></dt>
                    <dd class="text-slate-500">The amount due, for example 124.50</dd>
                </div>
                <div>
                    <dt class="font-medium text-slate-900">account_number</dt>
                    <dd class="text-slate-500">Utility account or citation number</dd>
                </div>
                <div>
                    <dt class="font-medium text-slate-900">name</dt>
                    <dd class="text-slate-500">Who the bill is addressed to</dd>
                </div>
                <div>
                    <dt class="font-medium text-slate-900">email</dt>
                    <dd class="text-slate-500">Used for the receipt, and to link the bill to a resident record</dd>
                </div>
                <div>
                    <dt class="font-medium text-slate-900">phone</dt>
                    <dd class="text-slate-500">Optional</dd>
                </div>
                <div>
                    <dt class="font-medium text-slate-900">last_name</dt>
                    <dd class="text-slate-500">Second factor for online lookup. Taken from <span class="font-mono text-xs">name</span> if absent</dd>
                </div>
                <div>
                    <dt class="font-medium text-slate-900">zip</dt>
                    <dd class="text-slate-500">Second factor for online lookup. Recommended</dd>
                </div>
                <div>
                    <dt class="font-medium text-slate-900">description</dt>
                    <dd class="text-slate-500">Shown to the resident, for example "Water and sewer, March 2026"</dd>
                </div>
                <div>
                    <dt class="font-medium text-slate-900">due_date</dt>
                    <dd class="text-slate-500">Any recognisable date format</dd>
                </div>
            </dl>

            <div class="section-divider mt-5 pt-5">
                <p class="text-sm text-slate-600">
                    Reference numbers are generated automatically. Rows with a missing or unreadable amount are
                    skipped and reported back to you by line number rather than being silently dropped.
                </p>
            </div>
        </x-card>
    </div>
</x-layouts.app>

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.