mirror of
https://github.com/filamentphp/filament.git
synced 2026-09-24 15:42:09 +08:00
docs
This commit is contained in:
@@ -8,12 +8,12 @@ While Filament comes with virtually any tool you'll need to build great apps, so
|
||||
|
||||
Before we dive in, it's important to understand the different contexts in which plugins can be used. There are two main contexts:
|
||||
|
||||
1. **Panel Plugins**: These are plugins that are used with [Panel Builders](../panels/installation). They are typically used only to add functionality when used inside a Panel or as a complete Panel in and of itself. Examples of this are:
|
||||
1. **Panel Plugins**: These are plugins that are used with [Panel Builders](../introduction/installation). They are typically used only to add functionality when used inside a Panel or as a complete Panel in and of itself. Examples of this are:
|
||||
1. A plugin that adds specific functionality to the dashboard in the form of Widgets.
|
||||
2. A plugin that adds a set of Resources / functionality to an app like a Blog or User Management feature.
|
||||
2. **Standalone Plugins**: These are plugins that are used in any context outside a Panel Builder. Examples of this are:
|
||||
1. A plugin that adds custom fields to be used with the [Form Builders](..//forms/installation/).
|
||||
2. A plugin that adds custom columns or filters to the [Table Builders](..//tables/installation/).
|
||||
1. A plugin that adds custom fields to be used with the [Form Builders](../forms/installation/).
|
||||
2. A plugin that adds custom columns or filters to the [Table Builders](../tables/installation/).
|
||||
|
||||
Although these are two different mental contexts to keep in mind when building plugins, they can be used together inside the same plugin. They do not have to be mutually exclusive.
|
||||
|
||||
|
||||
@@ -4,8 +4,6 @@ title: Broadcast notifications
|
||||
|
||||
## Introduction
|
||||
|
||||
> To start, make sure the package is [installed](installation) - `@livewire('notifications')` should be in your Blade layout somewhere.
|
||||
|
||||
By default, Filament will send flash notifications via the Laravel session. However, you may wish that your notifications are "broadcast" to a user in real-time, instead. This could be used to send a temporary success notification from a queued job after it has finished processing.
|
||||
|
||||
We have a native integration with [Laravel Echo](https://laravel.com/docs/broadcasting#client-side-installation). Make sure Echo is installed, as well as a [server-side websockets integration](https://laravel.com/docs/broadcasting#server-side-installation) like Pusher.
|
||||
|
||||
@@ -36,8 +36,6 @@ SpatieMediaLibraryFileUpload::make('avatar')
|
||||
|
||||
The media library file upload supports all the customization options of the [original file upload component](https://filamentphp.com/docs/forms/fields/file-upload).
|
||||
|
||||
> The field will automatically load and save its uploads to your model. To set this functionality up, **you must also follow the instructions set out in the [setting a form model](https://filamentphp.com/docs/forms/adding-a-form-to-a-livewire-component#setting-a-form-model) section**. If you're using a [panel](../panels), you can skip this step.
|
||||
|
||||
### Passing a collection
|
||||
|
||||
Optionally, you may pass a [`collection()`](https://spatie.be/docs/laravel-medialibrary/working-with-media-collections/simple-media-collections) allows you to group files into categories:
|
||||
|
||||
@@ -36,8 +36,6 @@ use Filament\Forms\Components\SpatieTagsInput;
|
||||
SpatieTagsInput::make('tags')
|
||||
```
|
||||
|
||||
> The field will automatically load and save its tags to your model. To set this functionality up, **you must also follow the instructions set out in the [field relationships](https://filamentphp.com/docs/forms/adding-a-form-to-a-livewire-component#setting-a-form-model) section**. If you're using the [Panel Builder](../panels), you can skip this step.
|
||||
|
||||
Optionally, you may pass a [`type()`](https://spatie.be/docs/laravel-tags/advanced-usage/using-types) allows you to group tags into collections:
|
||||
|
||||
```php
|
||||
|
||||
@@ -2,6 +2,6 @@
|
||||
title: Table widgets
|
||||
---
|
||||
|
||||
When using the [Panel Builder](../panels), you can use table widgets. These use the [table builder](../tables). You can find out how to create them [here](../panels/dashboard#table-widgets).
|
||||
When inside a panel, you can use table widgets. These use the [table builder](../tables). You can find out how to create them [here](../panels/dashboard#table-widgets).
|
||||
|
||||
If you're not using the Panel Builder, there's no need to use a "widget" to render a table. You can simply [add a table to a Livewire component](../tables/adding-a-table-to-a-livewire-component), which does not provide any specific benefits over a widget.
|
||||
|
||||
Reference in New Issue
Block a user