Dè a th 'ann am filament laravel agus mar a chleachdas e e?

Tha filament laravel na fhrèam leasachaidh “luathaichte”, a bheir seachad grunn phàirtean làn-chruach.

Tha e air a dhealbhadh gus am pròiseas leasachaidh a sgioblachadh, ga dhèanamh furasta tagraidhean eireachdail a chruthachadh.

A’ cleachdadh an stac TALL (Tailwind CSS, Alpine.js, Laravel agus Livewire)

6 minuti

laravel filament na fhrèam riaghlaidh susbaint, le cruinneachadh brèagha de cho-phàirtean làn-chruach. Tha an frèam-obrach a’ toirt seachad an uidheamachd tòiseachaidh as fheàrr airson an ath thagradh agad laravel. Ann am beagan cheumannan faodaidh tu eadar-aghaidh rianachd breagha a chruthachadh, agus bidh e a’ gineadh co-phàirtean a tha furasta an cleachdadh agus a ghabhas scalladh.

Ann an questo Leabhar laravel filament chì sinn a h-uile ceum airson do phròiseact a chuir air dòigh laravel filament

Co-phàirt laravel filament

Feuch sinn a-mach dè na co-phàirtean a tha e a 'tabhann Filament Laravel:

• Neach-togail Pannal: Cruthaich pannal rianachd Laravel, airson iarrtasan mu choinneamh luchd-cleachdaidh, àrd-ùrlaran SaaS no tagradh sam bith eile as urrainn dhut smaoineachadh. Tha an Neach-togail Pannal a’ sìmpleachadh pròiseas cruthachadh eadar-aghaidh rianachd cumhachdach;
• Foirm Builder: A 'leigeil leat togail gu furasta foirmean neo-àbhaisteach Stèidhichte air Livewire le còrr air 25 co-phàirtean ro-mhìnichte. Bidh na foirmean gineadh air an dèanamh suas de raointean cur-a-steach sìmplidh;
• Neach-togail Clàr: a ’cruthachadh clàran dàta leasaichte agus eadar-ghnìomhach stèidhichte air Livewire airson suidheachadh sam bith. Seall dàta ann an cruth intuitive le òrdachadh, sìoladh agus duilleagachadh;
• Brathan: faodaidh tu riaghladh a chleachdadh brathan gus fiosrachadh a chumail ri luchd-cleachdaidh le bhith a’ cur teachdaireachdan ann an àm fìor a’ cleachdadh Livewire;
• gnìomhan: Fosgail modhan eadar-ghnìomhach agus sleamhnachadh thairis gus eòlas cleachdaiche rèidh a chumail suas. Tha an gnìomhan leigidh iad leat luchd-cleachdaidh a chumail an sàs agus ann an sruth an tagraidh agad;
• Neach-togail Infolist: Faic liosta de dhàta ri leughadh a-mhàin mu eintiteas sònraichte. Tha e cuideachd air a chleachdadh taobh a-staigh pasganan Filament eile, leithid Panel Builder gus goireasan app agus manaidsearan dàimh a thaisbeanadh, a bharrachd air modhan gnìomh. Sàbhalaidh ionnsachadh feartan Infolist Builder ùine iongantach an dà chuid nuair a chruthaicheas tu na tagraidhean Livewire àbhaisteach agad fhèin agus nuair a bhios tu a’ cleachdadh pacaidean eile Filament;
• widget: Cruthaich deas-bhòrdan airson an tagradh agad, le grafaichean agus staitistig fìor-ùine. Leigidh widgets leat ìomhaighean fiùghantach a chruthachadh airson sgrùdadh agus aithris;

Bun-bheachdan bunaiteach

Laravel Filament a’ toirt a-steach bun-bheachdan a tha a’ buntainn ris a h-uile pasgan:

• Uile-a-steach: Cha bhith thu ag ath-thogail na h-aon phàirtean UI a-rithist. Filament a’ toirt seachad innealan riatanach deiseil airson an cleachdadh, a’ sàbhaladh ùine is oidhirp dhut.
• Stacan TALL: Filament luathaich an stac TALL (Tailwind CSS, Alpine.js, Laravel, agus Livewire) gus tagraidhean fiùghantach, seasmhach, làn-chruach a chruthachadh.

Stàladh laravel filament

Tha sinn an uair sin a dhol air adhart gu stàladh Laravel le Filament. Ach, mus gluais thu air adhart, dèan cinnteach gu bheil na riatanasan a leanas agad airson a chleachdadh filament V3.

PHP 8.1+
Laravel v10.0+
LiveWire v3.0+

ceum 1: Stàladh an toiseach laravel san t-siostam agad le bhith a’ ruith an àithne a chaidh a thoirt seachad gus an tionndadh 11 de laravel.

composer create-project laravel/laravel filament-tutorial

Aon uair ‘s gu bheil am pròiseas stàlaidh deiseil, ùraich am faidhle agad .env leis an ainm stòr-dàta agus dèan an imrich a’ cleachdadh an àithne php artisan migrate

ceum 2: An ath feumaidh sinn a stàladh Filament gus an eadar-aghaidh rianachd ùr snasail againn a ghineadh, gus sin a dhèanamh ruith an àithne a leanas.

composer require filament/filament:"^3.0-stable" -W

ceum 3: a-nis feumaidh sinn an gineadair pannal a stàladh Filament, a chruthaicheas agus a chlàras solaraiche seirbheis ùr laravel chiamatach AdminPanelProvider.

app/Providers/Filament/AdminPanelProvider.php

Am pannal filament laravel a’ tighinn le pacaidean ro-stàlaichte nach fheum thu a stàladh air leth (Form Builder, Table Builder, Notifications, Actions, Infolists, e Widgets packages).

php artisan filament:install --panels

ceum 4: A-nis cruthaichidh sinn a 'chiad neach-cleachdaidh againn a' cleachdadh an òrdugh a leanas. Thèid iarraidh ort d’ ainm, seòladh puist-d agus facal-faire a chuir a-steach mar a chithear gu h-ìosal.

php artisan make:filament-user

A-nis is urrainn dhuinn faighinn chun eadar-aghaidh rianachd a chruthaich sinn agus an tagradh a chruthachadh.

php artisan make:filament-user

Name:
> bloginnovazione

Email address:
> bloginnovazione@gmail.com

Password:
>

Success! bloginnovazione@gmail.com may now log in at http://localhost/admin/login.

Gus an ionad rianachd fhaicinn, ruith an aplacaid php artisan serve, fosgail an tagradh sa bhrobhsair agad agus cuir a-steach /admin às deidh an URL. Chì thu an roinn logadh a-steach rianachd mar a chithear san ìomhaigh agus cuir a-steach do theisteanasan cleachdaiche ùr-chruthaichte.

Às deidh dhut logadh a-steach, chì thu am pannal rianachd:

A-nis tha thu deiseil airson tòiseachadh air an tagradh agad a thogail.

Pròiseact reic thogalaichean le filament laravel

O chionn ghoirid leasaich mi pròiseact beag seilbh / làrach togail agus iomairtean margaidheachd is reic thogalaichean co-cheangailte riutha.

Ma tha thu airson sgrùdadh nas doimhne a dhèanamh air structar a’ phròiseict faodaidh tu cliog air a’ cheangal seo gus faighinn chun stòr air GitHub.

Anns a’ phròiseact chruthaich mi cuid de ghoireasan:

• Stòras Sianal: airson stiùireadh Sianalan Reic;
• Goireas Taighe: airson riaghladh thogalaichean
• Goireas Margaidheachd:: airson riaghladh gnìomhan Margaidheachd
• Stòras Reic: airson riaghladh reic
• Làrach-obrach: airson riaghladh làraich togail

Stèidhich mi clàr seòlaidh le bhith a’ cruinneachadh nan nithean. Gu h-ìosal tha mi ag aithris air na roghainnean a chaidh a dhèanamh sa chlas ChannelResource: nì a’ chlàr Channel air a chur ann am buidheann Marketing, le ìomhaigh globe-alt, bileagan Canali agus an còigeamh àite ann an òrdugh nithean clàr seòlaidh.

protected static ?string $model = Channel::class;
protected static ?string $navigationGroup = 'Marketing';
protected static ?string $navigationIcon = 'heroicon-o-globe-alt';
protected static ?string $navigationLabel = 'Canali';
protected static ?int $navigationSort = 5;

foirm

Anns an Fhoirm Riaghladh Seilbh chleachd sinn diofar sheòrsaichean fiosrachaidh:

Select: gus cothrom a thoirt don làrach togail a thaghadh far a bheil an togalach na phàirt, a’ gabhail brath air an dàimh aon-ri-iomadh worksite air a shònrachadh ann an model

Forms\Components\Select::make('worksite_id')
                    ->label('Cantiere')
                    ->relationship('worksite', 'name')
                    ->required(),

TextInput: gus leigeil le còd seilbh a shuidheachadh, inntrigeadh èigneachail, bileag Còd, agus 15 caractar as fhaide

Forms\Components\TextInput::make('code')
                    ->label('Codice')
                    ->required()
                    ->maxLength(15),

Select: gus am bi e comasach an seòrsa seilbh a thaghadh eadar àros agus Villa

Forms\Components\Select::make('type')
                    ->label('Tipologia')
                    ->options([
                        'appartamento' => 'Appartamento',
                        'villa' => 'Villa',
                    ]),

FileUpLoad: gus leigeil le ìomhaigh an togalaich a luchdachadh suas, far a bheil:

• preserveFilenames: gus ainm tùsail an fhaidhle a chumail
• imagePreviewHeight: gus meud (àirde) ro-shealladh an deilbh a mhìneachadh
• imageResizeTargetWidth e imageResizeTargetHeight: gus àirde is leud na h-ìomhaigh a chaidh a luchdachadh suas ath-mhìneachadh

Forms\Components\FileUpload::make('attachment')
                    ->image()
                    ->preserveFilenames()
                    ->imageResizeMode('cover')
                    ->imageCropAspectRatio('16:9')
                    ->imageResizeTargetWidth('300')
                    ->imageResizeTargetHeight('150')
                    ->imagePreviewHeight('250')
                    ->loadingIndicatorPosition('left')
                    ->panelAspectRatio('2:1')
                    ->panelLayout('integrated')
                    ->removeUploadedFileButtonPosition('right')
                    ->uploadButtonPosition('left')
                    ->uploadProgressIndicatorPosition('left'),

RichEditor: gus leigeil leis an raon a bhith air a luchdachadh followup le suidheachadh stoidhle agus bàr inneal deasachaidh

Forms\Components\RichEditor::make('followup')
                    ->label('Follow Up')
                    ->maxLength(255),

Clàr

Anns an liosta de stuthan luchdaichte, chleachd sinn na dòighean a leanas:

ImageColumn: gus an dealbh den togalach a tha air a stòradh san raon fhaicinn attachment

Tables\Columns\ImageColumn::make('attachment')
                    ->label('Foto'),

TextColumn: a’ taisbeanadh prìs an togalaich airson a reic, a’ dèanamh am fiosrachadh a ghabhas sgrùdadh agus òrdachadh

Tables\Columns\TextColumn::make('price')
                    ->label('Prezzo')
                    ->searchable()
                    ->sortable(),

Ann an questo Leabhar laravel filament tha sinn air faicinn mar a shuidhicheas tu filament ann am pròiseact Laravel, gus barrachd ionnsachadh mu bhith a’ riaghladh ceadan ann am pròiseact Laravel, faodaidh tu barrachd a leughadh mun artaigil againn Leabhar laravel filament gach l 'suidheachadh dreuchd.