Quick Create

https://github.com/awcodes/filament-quick-create
Admin
Quick Create is a plugin for Filament Panels that adds a dropdown menu to the header to quickly...
Tokens:34,998
Snippets:497
Trust Score:9.6
License:MIT
Update:4 months ago
Show doc for...
Tokens:
Raw
### Install Filament Quick Create

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/README.md

Install the package using Composer. This is the initial step for integrating the plugin into your Filament project.

```bash
composer require awcodes/filament-quick-create
```

--------------------------------

### Hide Quick Create Until User Completes Setup

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/usage-examples.md

Make the Quick Create dropdown visible only after a user has completed their setup process.

```php
QuickCreatePlugin::make()
    ->hidden(fn () => ! auth()->user()->hasCompletedSetup())
```

--------------------------------

### Customized Translation Example

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/configuration.md

An example of a customized translation file for the Quick Create plugin, showing how to change the button label.

```php
return [
    'button_label' => 'Create New',
];
```

--------------------------------

### QuickCreatePlugin Return Type Example

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/README.md

Demonstrates that most configuration methods on the QuickCreatePlugin return the plugin instance itself, enabling method chaining for fluent configuration.

```php
QuickCreatePlugin::make()
    ->includes([...])      // returns QuickCreatePlugin
    ->label('New')         // returns QuickCreatePlugin
    ->keyBindings([...])   // returns QuickCreatePlugin
```

--------------------------------

### Complete Quick Create Plugin Configuration

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/configuration.md

A comprehensive example demonstrating various configuration options for the Quick Create plugin, including resource filtering, display settings, sorting, form display, modal customization, keyboard shortcuts, and visibility.

```php
use Awcodes\QuickCreate\QuickCreatePlugin;
use Filament\View\PanelsRenderHook;

QuickCreatePlugin::make()
    // Resource filtering
    ->includes([
        UserResource::class,
        AuthorResource::class,
    ])
    
    // Display
    ->rounded()
    ->label('New')
    ->hiddenIcons(false)
    ->tooltip('Quick create (Cmd+Shift+A)')
    
    // Sorting
    ->sort(true)
    ->sortBy('label')
    
    // Form display
    ->slideOver()
    ->alwaysShowModal(false)
    ->createAnother(null) // Use resource default
    
    // Modal customization
    ->modalWidths('2xl')
    ->modalHeading('Create New :label')
    ->modalDescription('Fill in the details to create a new :label')
    ->modalExtraAttributes([
        'data-testid' => 'quick-create-modal',
    ])
    
    // Keyboard shortcuts
    ->keyBindings(['cmd+shift+a', 'ctrl+shift+a'])
    
    // Visibility
    ->hidden(false)
    ->renderUsingHook(PanelsRenderHook::USER_MENU_BEFORE)
```

--------------------------------

### Dynamically Set Key Bindings

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/README.md

Configure keyboard shortcuts for the quick create feature dynamically based on user privileges. This example sets different shortcuts for admin users.

```php
->keyBindings(fn () => auth()->user()->isAdmin() ? ['cmd+shift+a'] : null)
```

--------------------------------

### Register QuickCreatePlugin with Filament

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-service-provider.md

Example of registering the QuickCreatePlugin within a Filament panel provider.

```php
use Awcodes\QuickCreate\QuickCreatePlugin;

// In your AdminPanelProvider or similar
public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            QuickCreatePlugin::make(),
        ])
        // ... other configuration
    ;
}
```

--------------------------------

### Rendering Livewire Component in View

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/architecture.md

Example of how to render the QuickCreateMenu Livewire component in a Blade view.

```php
// In view:
@livewire('quick-create-menu')
```

--------------------------------

### Icon Type Examples

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/types-and-constants.md

Examples of Heroicon class names used for icons, including outline and solid styles.

```php
'heroicon-o-user'
'heroicon-o-plus'
'heroicon-o-star'
'heroicon-s-pencil'
```

--------------------------------

### Closure Evaluation Example

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/architecture.md

Demonstrates how configuration properties can be dynamic closures and how the `evaluate()` method is used to resolve their values.

```php
protected bool|Closure $hidden = false;

// Store either:
$this->hidden = true;                    // Static boolean
$this->hidden = fn() => auth()->admin(); // Dynamic closure
```

```php
public function shouldBeHidden(): bool
{
    return $this->evaluate($this->hidden) ?? false;
}
```

--------------------------------

### QuickCreateMenu bootedInteractsWithActions() Method

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-menu-component.md

Finalizes action setup after Livewire initializes the component. It caches actions and validates their types, ensuring they are instances of Action or ActionGroup.

```php
public function bootedInteractsWithActions(): void
```

--------------------------------

### QuickCreateMenu getActions() Method Example

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-menu-component.md

Illustrates how the getActions() method generates a collection of CreateAction instances for each resource. This method is typically understood conceptually rather than called directly in user code.

```php
// Typically not called directly in user code, but understood as:
$actions = $component->getActions();
// Returns: Collection of CreateAction objects ready to mount in Livewire
```

--------------------------------

### Accessing Translations

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-service-provider.md

Example of how to access package translations using the __() helper function.

```php
__('quick-create::quick-create.button_label')
```

--------------------------------

### Dynamic Configuration Closures

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/types-and-constants.md

Examples of closures used for dynamic boolean, string, nullable string, array, and nullable array configurations.

```php
// Boolean configuration
fn (): bool => auth()->user()->isAdmin()
```

```php
// String configuration
fn (): string => auth()->user()->locale === 'es' ? 'Crear' : 'New'
```

```php
// Nullable string
fn (): ?string => auth()->user()->theme === 'dark' ? 'dark' : null
```

```php
// Array configuration
fn (): array => ['cmd+shift+a', 'ctrl+shift+a']
```

```php
// Nullable array
fn (): ?array => auth()->user()->powerUser ? ['cmd+shift+a'] : null
```

--------------------------------

### Conditionally Hide Quick Create

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/README.md

Hide the Quick Create button based on a condition. The example shows hiding it if the tenant requires onboarding.

```php
use Awcodes\QuickCreate\QuickCreatePlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            QuickCreatePlugin::make()
                ->hidden(fn() => Filament::getTenant()->requiresOnboarding()),
        ])
}
```

--------------------------------

### Get Registered QuickCreatePlugin Instance

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Retrieve the plugin instance from the Filament container for the current panel. Useful for accessing plugin configurations after it has been registered.

```php
$plugin = QuickCreatePlugin::get();
$resources = $plugin->getResources();
```

--------------------------------

### Get Filtered Resources

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Builds and returns the filtered list of resources available for quick creation, applying authorization checks and filters. Returns an array with resource metadata.

```php
public function getResources(): array
```

```php
$plugin = QuickCreatePlugin::get();
$resources = $plugin->getResources();

// Example output:
// [
//     [
//         'resource_name' => 'App\Filament\Resources\UserResource',
//         'label' => 'User',
//         'model' => 'App\Models\User',
//         'icon' => 'heroicon-o-user',
//         'action_name' => 'create_user',
//         'action' => "mountAction('create_user')",
//         'url' => null,
//         'navigation' => 0,
//     ],
//     // ... more resources
// ]
```

--------------------------------

### Dynamically Hide Quick Create

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/README.md

Conditionally hide the quick create button based on runtime logic, such as user roles. This example hides it for non-admin users.

```php
->hidden(fn () => !auth()->admin())
```

--------------------------------

### Method Chaining in Quick Create Plugin Configuration

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/configuration.md

Illustrates how to chain configuration methods in the Quick Create plugin, as all methods return the plugin instance.

```php
QuickCreatePlugin::make()
    ->includes([UserResource::class])
    ->label('New')
    ->keyBindings('cmd+shift+a')
    ->slideOver()
```

--------------------------------

### getId

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Gets the unique identifier for this plugin instance.

```APIDOC
## getId()

### Description
Get the unique identifier for this plugin.

### Method
`getId(): string`

### Parameters
None

### Request Example
None provided.

### Response
#### Success Response (200)
* **string** - Always returns 'quick-create'.

#### Response Example
None provided.
```

--------------------------------

### Configure Quick Create Plugin Options

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/README.md

Set various options for the Quick Create plugin, such as included/excluded resources, sorting, labels, keyboard shortcuts, and modal behavior. Use this in your Filament service provider's boot method.

```php
QuickCreatePlugin::make()
    ->includes([UserResource::class])        // Show only these resources
    ->excludes([AdminResource::class])       // Hide these resources
    ->sortBy('label')                        // Sort alphabetically or by navigation
    ->label('New')                           // Custom button label
    ->rounded()                              // Button border radius
    ->keyBindings(['cmd+shift+a'])           // Keyboard shortcuts
    ->alwaysShowModal()                      // Force modals for all resources
    ->slideOver()                            // Use slide-over instead of modal
    ->hidden(fn () => !auth()->admin())      // Conditional visibility
```

--------------------------------

### Get Plugin ID Method

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/INDEX.md

Method to retrieve the unique identifier for the plugin.

```php
getId()
```

--------------------------------

### QuickCreateMenu mount() Method

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-menu-component.md

Initializes the QuickCreateMenu component by populating its properties from the QuickCreatePlugin configuration. This method is called automatically during component mounting.

```php
public function mount(): void
```

--------------------------------

### Get Current Sort Field

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Retrieves the current sort field, which can be 'label' or 'navigation'.

```php
public function getSortField(): string
```

--------------------------------

### Create New QuickCreatePlugin Instance

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Use the factory method to create a new instance of the plugin. This is the recommended way to instantiate the plugin.

```php
use Awcodes\QuickCreate\QuickCreatePlugin;

$plugin = QuickCreatePlugin::make();
```

--------------------------------

### Get Actions for Livewire Component

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/INDEX.md

Retrieves the collection of CreateActions available in the Livewire component.

```php
QuickCreateMenu::getActions()
```

--------------------------------

### Initialize and Render Quick Create Menu Component

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/README.md

Instantiate the QuickCreateMenu Livewire component, retrieve its actions, and render the associated Blade template. This is typically handled by Filament's Livewire rendering process.

```php
$component = new QuickCreateMenu();
$component->mount()                          // Initialize component
$component->getActions()                     // Get CreateAction collection
$component->render()                         // Render Blade template
$component->toggleDropdown()                 // Toggle dropdown visibility
```

--------------------------------

### CreateAction Initialization

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/types-and-constants.md

Demonstrates how to initialize a CreateAction with a name.

```php
use Filament\Actions\CreateAction;

CreateAction::make($name)
```

--------------------------------

### HasActions Interface Contract

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/types-and-constants.md

Defines methods for components that manage actions, including getting actions and mounting/calling them.

```php
use Filament\Actions\Contracts\HasActions;

interface HasActions
{
    public function getActions(): Collection;
    public function mountAction($name, $arguments = []): void;
    public function callAction($name, $arguments = []): mixed;
    // ... other methods
}
```

--------------------------------

### Conditional Quick Create Plugin Configuration

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/configuration.md

Demonstrates how to conditionally configure Quick Create plugin options using Closures based on user roles, locale, or device type.

```php
QuickCreatePlugin::make()
    // Only show for admins
    ->hidden(fn () => ! auth()->user()->isAdmin())
    
    // Different label per user
    ->label(fn () => auth()->user()->locale === 'es' ? 'Crear' : 'New')
    
    // Enable key bindings for power users
    ->keyBindings(fn () => auth()->user()->powerUser 
        ? ['cmd+shift+a', 'ctrl+shift+a'] 
        : null
    )
    
    // Conditional slide-over for mobile
    ->slideOver(fn () => request()->header('User-Agent') =~ /Mobile/)
    
    // Use different modals on smaller screens
    ->modalWidths(fn () => request()->header('User-Agent') =~ /Mobile/
        ? 'full'
        : 'lg'
    )
```

--------------------------------

### Configure Resource Inclusion

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/configuration.md

Specify which resources should be available in the Quick Create dropdown. Use either `includes` or `excludes`, but not both. `includes` takes precedence.

```php
->includes([
    App\Filament\Resources\UserResource::class,
    App\Filament\Resources\RoleResource::class,
])
```

```php
->excludes([
    App\Filament\Resources\TeamResource::class,
])
```

--------------------------------

### Configure Keybindings for Quick Create

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/README.md

Assign keyboard shortcuts to trigger the Quick Create dropdown. This allows for faster access to the creation menu via keyboard commands.

```php
use Awcodes\QuickCreate\QuickCreatePlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            QuickCreatePlugin::make()
                ->keyBindings(['command+shift+a', 'ctrl+shift+a']),
        ])
}
```

--------------------------------

### Generating Resource Metadata

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/architecture.md

Example of how the resource metadata array is generated programmatically, extracting details from a resource instance.

```php
$resource = app($resourceName);
[
    'resource_name' => $resourceName,
    'label' => Str::ucfirst($resource->getModelLabel()),
    'model' => $resource->getModel(),
    'icon' => $resource->getNavigationIcon(),
    'action_name' => 'create_' . Str::of($resource->getModel())->replace('\\', '')->snake(),
    'action' => $shouldUseModal ? "mountAction('$actionName')" : null,
    'url' => $shouldUseModal ? null : $resource::getUrl('create'),
    'navigation' => $resource->getNavigationSort(),
]
```

--------------------------------

### getSortField()

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Get the current sort field being used by the plugin. This will be either 'label' for alphabetical sorting or 'navigation' for sort order.

```APIDOC
## getSortField()

### Description
Get the current sort field ('label' or 'navigation').

### Returns
`string` — The current sort field

### Example
```php
$sortField = $plugin->getSortField();
```
```

--------------------------------

### Multi-Tenant Configuration for Quick Create

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/usage-examples.md

Configure Quick Create to be hidden when no tenant is selected in a multi-tenant application. Resources will be automatically scoped to the current tenant.

```php
QuickCreatePlugin::make()
    ->hidden(fn () => ! Filament::getTenant())
```

--------------------------------

### QuickCreatePlugin API Reference

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/MANIFEST.md

This section details the QuickCreatePlugin class, including its static and instance methods for configuring resource filtering, sorting, display, modal behavior, and more.

```APIDOC
## QuickCreatePlugin API Reference

### Description
Provides a complete reference for the QuickCreatePlugin class, covering its static and instance methods for customizing the quick creation functionality.

### Class Methods
- **make()**: Static method to instantiate the plugin.
- **get()**: Static method to retrieve an instance of the plugin.

### Instance Methods
- **Resource Filtering**:
  - `excludes(array $resources)`: Excludes specified resources.
  - `includes(array $resources)`: Includes only specified resources.
  - `getResources()`: Retrieves the list of resources to be displayed.
- **Sorting**:
  - `sort(array $sorts)`: Sets custom sorting options.
  - `sortBy(string $column, string $direction = 'asc')`: Sets a default sort column and direction.
  - `isSortable(bool $sortable)`: Enables or disables sorting.
- **Display**:
  - `rounded()`: Applies rounded styling.
  - `label(string $label)`: Sets a custom label.
  - `hiddenIcons()`: Hides icons.
  - `tooltip(string $tooltip)`: Sets a tooltip.
- **Modal/Form Configuration**:
  - `alwaysShowModal()`: Configures the modal to always be shown.
  - `slideOver()`: Configures the modal to be a slide-over.
  - `modalWidths(string $width)`: Sets the modal width.
  - `etc()`: (Placeholder for other modal/form related methods)
- **Create Another**:
  - `createAnother()`: Enables the 'Create Another' functionality.
  - `canCreateAnother(bool $condition)`: Controls the ability to create another record.
- **Keyboard Shortcuts**:
  - `keyBindings(array $bindings)`: Defines custom keyboard bindings.
  - `getKeyBindings()`: Retrieves the defined keyboard bindings.
- **Visibility**:
  - `hidden(bool $condition)`: Hides the plugin based on a condition.
  - `shouldBeHidden()`: Determines if the plugin should be hidden.
- **Rendering**:
  - `renderUsingHook(string $hookName)`: Renders using a specific hook.
  - `getRenderHook()`: Retrieves the render hook configuration.
- **Helper**:
  - `getId()`: Retrieves the unique identifier for the plugin.

### Parameters
Parameters vary per method. Refer to individual method documentation for details on types, requirements, and descriptions.
```

--------------------------------

### Configure Keyboard Shortcuts

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/configuration.md

Define keyboard shortcuts to toggle the Quick Create dropdown. Accepts a single string or an array of strings. Defaults to `null`.

```php
->keyBindings('cmd+shift+a')
```

```php
->keyBindings(['cmd+shift+a', 'ctrl+shift+a'])
```

```php
->keyBindings(fn () => auth()->user()->isAdmin() ? ['cmd+shift+a'] : null)
```

--------------------------------

### Render Resources in Slide Over

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/README.md

Configure Quick Create to render simple resources in a slide-over panel instead of a standard modal. Use the `slideOver()` modifier for this behavior.

```php
use Awcodes\QuickCreate\QuickCreatePlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            QuickCreatePlugin::make()
                ->slideOver(),
        ])
}
```

--------------------------------

### HasForms Interface Contract

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/types-and-constants.md

Defines methods for components that manage forms, including getting the form schema, form instance, and form actions.

```php
use Filament\Forms\Contracts\HasForms;

interface HasForms
{
    public function getFormSchema($formStatePath = 'data'): array;
    public function getForm($formStatePath = 'data'): Form;
    public function getFormActions($formStatePath = 'data'): array;
    // ... other methods
}
```

--------------------------------

### Create with Default Settings

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/usage-examples.md

Use the plugin with its default behavior, displaying all creatable resources sorted alphabetically and using modals for resources without create pages.

```php
use Awcodes\QuickCreate\QuickCreatePlugin;

QuickCreatePlugin::make()
```

--------------------------------

### Hide Quick Create During Onboarding

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/usage-examples.md

Control the visibility of the Quick Create dropdown based on tenant onboarding status.

```php
use Filament\Facades\Filament;

QuickCreatePlugin::make()
    ->hidden(fn () => Filament::getTenant()?->requiresOnboarding())
```

--------------------------------

### QuickCreateMenuComponent Reference

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/MANIFEST.md

This section covers the QuickCreateMenu Livewire component, detailing its public properties, lifecycle methods, and primary methods for action retrieval and rendering.

```APIDOC
## QuickCreateMenuComponent Reference

### Description
Reference for the QuickCreateMenu Livewire component, including its public properties, lifecycle methods, and core functionalities for managing actions and rendering.

### Public Properties
- (Details on public properties would be listed here if available in source)

### Lifecycle Methods
- **mount()**: Initializes the component.
- **bootedInteractsWithActions()**: Handles interactions related to actions after booting.

### Primary Methods
- **getActions()**: Retrieves the available actions for the component.
- **render()**: Renders the component's view.
- **toggleDropdown()**: Toggles the visibility of the dropdown menu.

### Protected Methods
- **cacheActions()**: Caches the actions for performance.

### Other Details
- Explains the record creation flow.
- Details JavaScript integration, form integration, and configuration properties.
- Covers view rendering details.
```

--------------------------------

### Adding Custom CSS Classes to Buttons

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/blade-template.md

Shows how to add custom CSS classes to a button element for styling. This example adds 'shadow-lg' and 'border-2 border-primary-500' classes.

```blade
{{-- Original button --}}
<button @class([...]) ...>

{{-- Add custom classes --}}
<button @class([
    'flex flex-shrink-0 bg-gray-100 items-center justify-center text-primary-500 hover:text-primary-900 dark:bg-gray-800 hover:bg-primary-500 dark:hover:bg-primary-500',
    'rounded-full' => $rounded,
    'rounded-md' => ! $rounded,
    'size-8' => ! $label,
    'py-1 ps-3 pe-4 gap-1' => $label,
    'shadow-lg' => true,  {{-- Add custom class --}}
    'border-2 border-primary-500' => true,  {{-- Add another --}}
]) ...>
```

--------------------------------

### QuickCreateMenu Component Structure

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/architecture.md

Illustrates the QuickCreateMenu Livewire component, which extends Component and uses traits for action and form management.

```php
class QuickCreateMenu extends Component implements HasActions, HasForms
{
    use InteractsWithActions;  // From Filament
    use InteractsWithForms;    // From Filament
}
```

--------------------------------

### Filament Panel Plugin Integration

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/architecture.md

Demonstrates how to register the QuickCreatePlugin with a Filament panel using the plugins() method.

```php
Panel->plugins([
    QuickCreatePlugin::make(),
])
```

--------------------------------

### Filter Resources with Includes

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/README.md

Use the 'includes' method to specify exactly which resources should be available in the quick create menu. This is useful for limiting the options to a predefined set.

```php
->includes([
    UserResource::class,
    ProductResource::class,
])
```

--------------------------------

### Customizing Dropdown List Item Rendering

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/blade-template.md

Illustrates how to customize the content within a dropdown list item. This example adds a bold label and a smaller text for the model name.

```blade
{{-- Original item --}}
<x-filament::dropdown.list.item
    :icon="$hiddenIcons ? null : $resource['icon']"
    :wire:click="$resource['action']"
    :href="$resource['url']"
    :tag="$resource['url'] ? 'a' : 'button'"
    class="{{ 'quick-create-action-' . str($resource['label'])->slug() }}"
>
    {{ $resource['label'] }}
</x-filament::dropdown.list.item>

{{-- Customize --}}
<x-filament::dropdown.list.item
    :icon="$hiddenIcons ? null : $resource['icon']"
    :wire:click="$resource['action']"
    :href="$resource['url']"
    :tag="$resource['url'] ? 'a' : 'button'"
    class="{{ 'quick-create-action-' . str($resource['label'])->slug() }}"
>
    <span class="font-semibold">{{ $resource['label'] }}</span>
    <span class="text-xs text-gray-500">{{ $resource['model'] }}</span>
</x-filament::dropdown.list.item>
```

--------------------------------

### Configure Create Another Behavior

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Overrides the default "create another" behavior. By default, the plugin respects the resource's create action settings. Examples show how to always allow or never allow 'create another'.

```php
// Always allow "create another"
QuickCreatePlugin::make()
    ->createAnother(true)

// Never allow "create another"
QuickCreatePlugin::make()
    ->createAnother(false)
```

--------------------------------

### Multi-Platform Keyboard Shortcuts for Quick Create

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/README.md

Configure keyboard shortcuts for the QuickCreatePlugin that work across different operating systems. This enhances accessibility and workflow efficiency.

```php
QuickCreatePlugin::make()
    ->keyBindings(['cmd+shift+a', 'ctrl+shift+a'])
```

--------------------------------

### QuickCreatePlugin->includes()

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Include only specific resources in the dropdown menu. This method is used to explicitly define which resources should be available for quick creation.

```APIDOC
## QuickCreatePlugin->includes()

### Description
Include only specific resources in the dropdown menu. Cannot be used together with `excludes()`. When includes are specified, only these resources will be displayed.

### Method
`public`

### Parameters
#### Request Body
- **resources** (`array`) - Required - Array of resource class names to include (e.g., `[UserResource::class]`)

### Returns
`static` — The plugin instance for method chaining

### Example
```php
QuickCreatePlugin::make()
    ->includes([
        UserResource::class,
        AuthorResource::class,
    ])
```
```

--------------------------------

### Resource Metadata Structure

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/README.md

Illustrates the data structure for each resource displayed in the quick create dropdown, including its name, label, model, icon, and associated actions or URLs.

```php
[
    'resource_name' => 'App\Filament\Resources\UserResource',
    'label' => 'User',
    'model' => 'App\Models\User',
    'icon' => 'heroicon-o-user',
    'action_name' => 'create_user',
    'action' => "mountAction('create_user')",  // Or null
    'url' => null,                              // Or create page URL
    'navigation' => 0,
]
```

--------------------------------

### Livewire Component Initialization

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/INDEX.md

Initializes the Livewire component and prepares it for rendering.

```php
QuickCreateMenu::mount()
```

--------------------------------

### Mobile-Responsive Quick Create Configuration

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/usage-examples.md

Adapt the Quick Create plugin's UI for mobile users by conditionally setting the label, slide-over behavior, and modal widths based on the User-Agent header.

```php
QuickCreatePlugin::make()
    ->label(fn () => request()->header('User-Agent') =~ /Mobile/ ? 'New' : null)
    ->slideOver(fn () => request()->header('User-Agent') =~ /Mobile/)
    ->modalWidths(fn () => request()->header('User-Agent') =~ /Mobile/ ? 'full' : 'lg')
```

--------------------------------

### Complex Quick Create Plugin Configuration

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/usage-examples.md

Configure the Quick Create plugin for a multi-user SaaS application, including resource inclusion, UI customization, and visibility controls.

```php
use App\Filament\Resources{
    UserResource,
    ProductResource, 
    OrderResource,
    AdminResource,
};
use Awcodes\QuickCreate\QuickCreatePlugin;
use Filament\View\PanelsRenderHook;

QuickCreatePlugin::make()
    // Only show commonly-used resources
    ->includes([
        UserResource::class,
        ProductResource::class,
        OrderResource::class,
    ])
    
    // Friendly interface
    ->label('New')
    ->rounded()
    ->keyBindings(['cmd+shift+a', 'ctrl+shift+a'])
    ->tooltip('Quick create (Cmd+Shift+A)')
    
    // Better UX for forms
    ->slideOver()
    ->modalWidths(['md', 'lg', 'xl'])
    ->modalHeading('Create New :label')
    ->modalDescription('Add a new :label to your workspace')
    
    // Visibility
    ->hidden(fn () => ! auth()->user()->hasPermission('create_resources'))
    ->renderUsingHook(PanelsRenderHook::USER_MENU_BEFORE)
```

--------------------------------

### Dynamically Set Label

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/README.md

Set the label for the quick create button dynamically based on user locale. This allows for multi-language support.

```php
->label(fn () => auth()->user()->locale === 'es' ? 'Crear' : 'New')
```

--------------------------------

### Configuration Flow

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/architecture.md

Illustrates the sequence of operations from user configuration to component rendering.

```mermaid
graph TD
    User Code
        -> QuickCreatePlugin::make() 
    QuickCreatePlugin::make() -> stores config
    stores config -> Panel->plugins([$plugin]) 
    Panel->plugins([$plugin]) -> calls boot() and register()
    calls boot() and register() -> Plugin::register()
    Plugin::register() -> renders @livewire('quick-create-menu')
    renders @livewire('quick-create-menu') -> QuickCreateMenu::mount()
    QuickCreateMenu::mount() -> reads config from QuickCreatePlugin::get()
    reads config from QuickCreatePlugin::get() -> Component properties populated with configuration
    Component properties populated with configuration -> Blade renders with configured options
```

--------------------------------

### Sort Resources by Label

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/README.md

Sort the resources in the quick create menu alphabetically by their labels. This provides a predictable order for users.

```php
->sortBy('label')
```

--------------------------------

### Include Specific Resources in Quick Create

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/README.md

Configure the plugin to only include specified resources in the Quick Create dropdown. This is ideal when you have many resources but only want a few to be easily accessible.

```php
use Awcodes\QuickCreate\QuickCreatePlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            QuickCreatePlugin::make()
                ->includes([
                    \App\Filament\Resources\UserResource::class,
                ]),
        ])
}
```

--------------------------------

### QuickCreatePlugin::make()

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

A factory method to create a new instance of the QuickCreatePlugin. This is the primary way to instantiate the plugin before configuring it.

```APIDOC
## QuickCreatePlugin::make()

### Description
Factory method that creates a new instance of the plugin.

### Method
`static`

### Parameters
None

### Returns
`static` — A new instance of `QuickCreatePlugin`

### Example
```php
use Awcodes\QuickCreate\QuickCreatePlugin;

$plugin = QuickCreatePlugin::make();
```
```

--------------------------------

### QuickCreateServiceProvider Class Definition

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-service-provider.md

Defines the QuickCreateServiceProvider class, extending Spatie's PackageServiceProvider.

```php
namespace Awcodes\QuickCreate;

class QuickCreateServiceProvider extends PackageServiceProvider
```

--------------------------------

### Retrieve Quick Create Plugin Instance and Resources

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/README.md

Access the current instance of the Quick Create plugin and retrieve its filtered resources. Useful for dynamic checks or displaying available resources.

```php
QuickCreatePlugin::get()                     // Get current plugin instance
$plugin->getResources()                      // Get filtered resources
$plugin->isSortable()                        // Check if sorting enabled
```

--------------------------------

### QuickCreateMenu render() Method

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-menu-component.md

Renders the Blade view for the Quick Create menu component, passing necessary data like keyboard bindings for JavaScript event handling.

```php
public function render(): View
```

--------------------------------

### Render Quick Create at Top of Page

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/usage-examples.md

Display the Quick Create dropdown at the very beginning of the page content area.

```php
QuickCreatePlugin::make()
    ->renderUsingHook(PanelsRenderHook::PAGE_START)
```

--------------------------------

### Filament Authorization Check for Quick Create

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/usage-examples.md

Demonstrates how Quick Create respects Filament's authorization. Ensure resources are only creatable if the user has the necessary permissions.

```php
// In your Resource
public static function canCreate(): bool
{
    return auth()->user()->hasPermission('users.create');
}
```

--------------------------------

### Sort Quick Create by Navigation Order

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/README.md

Configure Quick Create to sort options based on their order in the Filament navigation. This provides a consistent ordering with the main navigation menu.

```php
use Awcodes\QuickCreate\QuickCreatePlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            QuickCreatePlugin::make()
                ->sortBy('navigation'),
        ])
}
```

--------------------------------

### Register Livewire Component in PHP

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-service-provider.md

How to register the QuickCreateMenu Livewire component programmatically in PHP.

```php
Livewire::component('quick-create-menu', QuickCreateMenu::class);
```

--------------------------------

### QuickCreatePlugin::get()

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Retrieves the plugin instance from the Filament container for the current panel. Useful for accessing the plugin's configuration after it has been registered.

```APIDOC
## QuickCreatePlugin::get()

### Description
Retrieves the plugin instance from the Filament container for the current panel.

### Method
`static`

### Parameters
None

### Returns
`static` — The registered instance of `QuickCreatePlugin`

### Example
```php
$plugin = QuickCreatePlugin::get();
$resources = $plugin->getResources();
```
```

--------------------------------

### Create a Custom Filament Theme

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/README.md

Generate a custom theme for your Filament application. This is a prerequisite for using the Quick Create plugin with a custom theme.

```bash
php artisan make:filament-theme
```

--------------------------------

### Force All Resources to Show in Modal

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/README.md

Ensure that all Quick Create items are displayed in a modal, overriding the default behavior that might redirect to a create page.

```php
use Awcodes\QuickCreate\QuickCreatePlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            QuickCreatePlugin::make()
                ->alwaysShowModal(),
        ])
}
```

--------------------------------

### Project Structure

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/architecture.md

The file and directory structure of the filament-quick-create plugin.

```tree
filament-quick-create/
├── src/
│   ├── QuickCreatePlugin.php              # Main plugin class
│   ├── QuickCreateServiceProvider.php     # Laravel service provider
│   └── Components/
│       └── QuickCreateMenu.php            # Livewire component
├── resources/
│   ├── views/
│   │   └── components/
│   │       └── create-menu.blade.php      # Blade template
│   └── lang/
│       ├── en/
│       │   └── quick-create.php           # English translations
│       └── ckb/
│           └── quick-create.php           # Kurdish translations
├── tests/                                  # Test suite
├── composer.json                           # Package metadata
└── README.md                               # Documentation
```

--------------------------------

### QuickCreateMenu Class Definition

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-menu-component.md

Defines the QuickCreateMenu component, a Livewire component integrating with Filament's action and form systems for dynamic creation capabilities.

```php
namespace Awcodes\QuickCreate\Components;

class QuickCreateMenu extends Component implements HasActions, HasForms
```

--------------------------------

### BootingPackage Method Signature

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-service-provider.md

Signature for the bootingPackage method, used to register the Livewire component.

```php
public function bootingPackage(): void
```

--------------------------------

### Use Resource Defaults for 'Create Another'

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/usage-examples.md

Revert to the default behavior where each resource determines whether the 'Create another' option is available.

```php
QuickCreatePlugin::make()
    ->createAnother(null)  // This is the default
```

--------------------------------

### Limited Resource Set for Quick Create

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/README.md

Configure the QuickCreatePlugin to only include specific resources. This limits the available options to a curated list, improving usability.

```php
QuickCreatePlugin::make()
    ->includes([
        UserResource::class,
        ProductResource::class,
    ])
```

--------------------------------

### Authorization Flow in Resource Creation

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/architecture.md

Illustrates the multi-stage authorization process for resource creation, from resource-level checks to action-specific authorization and policy enforcement.

```text
1. Plugin::getResources()
   • For each resource: if !$resource->canCreate() skip it
   ↓
2. CreateAction::authorize()
   • Action is created with ->authorize($r::canCreate())
   ↓
3. CreateAction save handler
   • Form submission triggers authorization re-check
   ↓
4. Resource policy (if exists)
   • Filament invokes model policy for 'create'
```

--------------------------------

### Testing Selectors for Quick Create Component

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/README.md

These CSS classes can be used for testing the root container and individual resource links within the quick create component.

```html
<!-- Root container -->
<div class="quick-create-component">

<!-- Individual resources -->
<a class="quick-create-action-user">User</a>
<a class="quick-create-action-product">Product</a>
```

--------------------------------

### Enhanced Modal Experience with Quick Create

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/README.md

Customize the modal appearance for the QuickCreatePlugin, including slide-over behavior, modal width, heading, and description. This provides a more tailored user interface.

```php
QuickCreatePlugin::make()
    ->slideOver()
    ->modalWidths('2xl')
    ->modalHeading('Create New :label')
    ->modalDescription('Fill in the details to create a new :label')
```

--------------------------------

### getTooltip()

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Retrieves the currently configured tooltip text for the Quick Create button.

```APIDOC
## getTooltip()

### Description
Get the configured tooltip text.

### Method
`getTooltip`

### Response
#### Success Response
- **?string** - The tooltip text
```

--------------------------------

### QuickCreatePlugin Class Structure

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/architecture.md

Shows the QuickCreatePlugin class implementing the Plugin interface and using the EvaluatesClosures trait from Filament.

```php
class QuickCreatePlugin implements Plugin
{
    use EvaluatesClosures;  // From Filament
}
```

--------------------------------

### QuickCreateMenu toggleDropdown() Method

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-menu-component.md

Emits a Livewire event to toggle the dropdown menu's visibility. This is typically triggered by keyboard shortcuts.

```php
public function toggleDropdown(): void
```

--------------------------------

### getResources()

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Builds and returns the filtered list of resources available for quick creation. Applies authorization checks and filters based on includes/excludes settings. Returns an array with resource metadata including labels, icons, URLs, and actions.

```APIDOC
## getResources()

### Description
Builds and returns the filtered list of resources available for quick creation. Applies authorization checks and filters based on includes/excludes settings. Returns an array with resource metadata including labels, icons, URLs, and actions.

### Returns
`array` — Array of resource arrays, each containing:
- `resource_name` (string) — The resource class name
- `label` (string) — User-friendly resource label
- `model` (string) — The Eloquent model class name
- `icon` (string|null) — Navigation icon name
- `action_name` (string) — Unique action name for mounting
- `action` (string|null) — Livewire action to mount (for modals)
- `url` (string|null) — Create page URL (for redirects)
- `navigation` (int|null) — Navigation sort order

### Example
```php
$plugin = QuickCreatePlugin::get();
$resources = $plugin->getResources();

// Example output:
// [
//     [
//         'resource_name' => 'App\Filament\Resources\UserResource',
//         'label' => 'User',
//         'model' => 'App\Models\User',
//         'icon' => 'heroicon-o-user',
//         'action_name' => 'create_user',
//         'action' => "mountAction('create_user')",
//         'url' => null,
//         'navigation' => 0,
//     ],
//     // ... more resources
// ]
```
```

--------------------------------

### Set Optional Button Label

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/configuration.md

Define custom text to display next to the plus icon on the Quick Create button. Defaults to `null` (no label).

```php
->label('Add New')
```

--------------------------------

### Register Filament Quick Create Plugin

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/INDEX.md

Register the plugin with your User resource, define a label, and set keyboard shortcuts for quick access. This snippet shows how to enable the slide-over functionality.

```php
// Step 1: Register plugin
QuickCreatePlugin::make()
    ->includes([UserResource::class])
    ->label('New')
    ->keyBindings(['cmd+shift+a', 'ctrl+shift+a'])
    ->slideOver()
```

--------------------------------

### Register Keyboard Shortcuts

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Registers keyboard shortcuts to toggle the Quick Create dropdown. Supports multiple bindings. This method is chainable.

```php
// Single keyboard shortcut
QuickCreatePlugin::make()
    ->keyBindings('cmd+shift+a')

// Multiple shortcuts
QuickCreatePlugin::make()
    ->keyBindings(['cmd+shift+a', 'ctrl+shift+a'])
```

--------------------------------

### Available Render Hooks

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/configuration.md

Lists the available Filament render hooks for displaying the Quick Create menu.

```php
use Filament\View\PanelsRenderHook;

PanelsRenderHook::USER_MENU_BEFORE      // Before user menu (default)
PanelsRenderHook::USER_MENU_AFTER       // After user menu
PanelsRenderHook::SIDEBAR_NAV_START     // Beginning of sidebar navigation
PanelsRenderHook::SIDEBAR_NAV_END       // End of sidebar navigation
PanelsRenderHook::PAGE_START            // Top of page content
PanelsRenderHook::PAGE_END              // Bottom of page content
```

--------------------------------

### tooltip(string|Closure|null $tooltip)

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Sets a custom tooltip for the Quick Create button. This can be a string, a closure, or null to use the default.

```APIDOC
## tooltip(string|Closure|null $tooltip)

### Description
Set a custom tooltip for the Quick Create button.

### Method
`tooltip`

### Parameters
#### Path Parameters
- **tooltip** (string|Closure|null) - Optional - The tooltip text. Defaults to localized 'button_label'.

### Request Example
```php
QuickCreatePlugin::make()
    ->tooltip('Create a new record (Cmd+Shift+A)')
```

### Response
#### Success Response
- **static** - The plugin instance for method chaining
```

--------------------------------

### Service Provider Type

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/types-and-constants.md

Extends Spatie's base for automated package bootstrap, including auto-discovery, resource publishing, and translation/view loading.

```php
use Spatie\LaravelPackageTools\PackageServiceProvider;

class QuickCreateServiceProvider extends PackageServiceProvider
```

--------------------------------

### Set Custom Label for Quick Create Button

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Use the `label` method to set a custom text for the Quick Create button. This can be a static string or a dynamic closure.

```php
QuickCreatePlugin::make()
    ->label('New')
```

```php
QuickCreatePlugin::make()
    ->label(fn () => auth()->user()->locale === 'es' ? 'Crear' : 'New')
```

--------------------------------

### keyBindings

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Registers keyboard shortcuts to toggle the Quick Create dropdown. This method supports registering a single shortcut or an array of multiple shortcuts.

```APIDOC
## keyBindings(string|array|Closure|null $bindings)

### Description
Register keyboard shortcuts to toggle the Quick Create dropdown. Supports multiple bindings.

### Method
```php
public function keyBindings(string|array|Closure|null $bindings): static
```

### Parameters
#### Path Parameters
- **bindings** (string|array|Closure|null) - Required - Single binding string or array of binding strings

### Request Example
```php
// Single keyboard shortcut
QuickCreatePlugin::make()
    ->keyBindings('cmd+shift+a')

// Multiple shortcuts
QuickCreatePlugin::make()
    ->keyBindings(['cmd+shift+a', 'ctrl+shift+a'])
```

### Response
#### Success Response (200)
- **static** - The plugin instance for method chaining
```

--------------------------------

### Create Action Configuration

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/architecture.md

Configures the 'CreateAction' for mounting in Filament. It handles authorization, model binding, schema application, and the save action callback.

```php
CreateAction::make($action_name)
    ->authorize($r::canCreate())
    ->model($resource['model'])
    ->schema($formSchema)
    ->action($saveClosure)
    // ... other configuration

// When mounted:
// • Filament validates authorization
// • Mounts action in modal
// • Renders form with schema
// • Calls action callback on submission
```

--------------------------------

### Register Livewire Component in Blade

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-service-provider.md

How to render the QuickCreateMenu Livewire component in a Blade view.

```blade
@livewire('quick-create-menu')
```

--------------------------------

### Default English Translation for Quick Create

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/configuration.md

Shows the default English translation file for the Quick Create plugin. Customize translations by publishing and modifying these files.

```php
// resources/lang/en/quick-create.php
return [
    'button_label' => 'Quick Create',
];
```

--------------------------------

### QuickCreateMenu shouldBeHidden() Method

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-menu-component.md

Determines if the Quick Create menu component should be hidden based on the plugin's configuration. It delegates this check to the QuickCreatePlugin.

```php
public function shouldBeHidden(): bool
```

--------------------------------

### Registering Menu Item via Render Hook

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/architecture.md

Inserts the quick create menu into the Filament panel using the render hook system. This ensures the menu appears in the user menu.

```php
Panel->renderHook(
    name: $this->getRenderHook(),
    hook: fn () => Blade::render("@livewire('quick-create-menu')")
)
```

--------------------------------

### shouldBeHidden

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Checks if the Quick Create menu should be hidden based on its current configuration.

```APIDOC
## shouldBeHidden()

### Description
Check if the Quick Create menu should be hidden.

### Method
`shouldBeHidden(): bool`

### Parameters
None

### Request Example
None provided.

### Response
#### Success Response (200)
* **bool** - True if the menu should be hidden.

#### Response Example
None provided.
```

--------------------------------

### Tenancy Support for Resource Loading and Saving

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/architecture.md

Demonstrates how the plugin respects Filament's multi-tenancy configuration. It skips resources if no tenant is selected and saves records through the tenant relationship when applicable.

```php
// In getResources():
if (Filament::hasTenancy() && !Filament::getTenant()) {
    return null;  // Skip resource if no tenant selected
}

// In action handler:
if ($r::isScopedToTenant() && ($tenant = Filament::getTenant())) {
    $relationship = $r::getTenantRelationship($tenant);
    // Save through tenant relationship
}
```

--------------------------------

### Render Quick Create in Sidebar

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/usage-examples.md

Change the rendering location of the Quick Create dropdown to appear at the end of the sidebar navigation.

```php
use Awcodes\QuickCreate\QuickCreatePlugin;
use Filament\View\PanelsRenderHook;

QuickCreatePlugin::make()
    ->renderUsingHook(PanelsRenderHook::SIDEBAR_NAV_END)
```

--------------------------------

### Resolving Resource Instance using App Make

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/architecture.md

Shows how to resolve a specific resource class instance using Laravel's `App::make()` within a Livewire component, leveraging dependency injection.

```php
// In Livewire component:
App::make($resource['resource_name'])  // Resolves resource
```

--------------------------------

### canCreateAnother

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Retrieves the configured setting for the "create another" option. Returns true or false if explicitly overridden, or null if the resource's default setting is being used.

```APIDOC
## canCreateAnother()

### Description
Get the configured "create another" setting.

### Method
```php
public function canCreateAnother(): ?bool
```

### Response
#### Success Response (200)
- **bool|null** - True/false if overridden, null if using resource default
```

--------------------------------

### Exclude Resources from Quick Create

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/README.md

Configure the plugin to exclude specific resources from appearing in the Quick Create dropdown. This is useful for resources that should not be readily accessible.

```php
use Awcodes\QuickCreate\QuickCreatePlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            QuickCreatePlugin::make()
                ->excludes([
                    \App\Filament\Resources\UserResource::class,
                ]),
        ])
}
```

--------------------------------

### QuickCreatePlugin Class Definition

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Defines the main plugin class that integrates with the Filament Admin Panel.

```php
namespace Awcodes\QuickCreate;

class QuickCreatePlugin implements Plugin
```

--------------------------------

### Render Livewire Component

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/INDEX.md

Renders the main template for the Livewire Quick Create component.

```php
QuickCreateMenu::render()
```

--------------------------------

### getKeyBindings

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/quick-create-plugin.md

Retrieves the configured keyboard bindings as an array of strings.

```APIDOC
## getKeyBindings()

### Description
Get the configured keyboard bindings as an array.

### Method
```php
public function getKeyBindings(): ?array
```

### Response
#### Success Response (200)
- **array|null** - Array of keyboard binding strings
```

--------------------------------

### Register Filament Plugin

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/README.md

Register the QuickCreatePlugin in your panel provider configuration to enable its functionality.

```php
use Awcodes\QuickCreate\QuickCreatePlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            QuickCreatePlugin::make(),
        ]);
}
```

--------------------------------

### Set Button Tooltip

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/configuration.md

Customize the tooltip text that appears when hovering over the Quick Create button. Defaults to a localized 'button_label'.

```php
->tooltip('Create a new record')
```

--------------------------------

### Always Allow 'Create Another' Action

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/usage-examples.md

Enable the 'Create another' checkbox by default for all resources after a successful creation.

```php
QuickCreatePlugin::make()
    ->createAnother(true)
```

--------------------------------

### Default English Translation for Button Label

Source: https://github.com/awcodes/filament-quick-create/blob/5.x/_autodocs/architecture.md

Defines the default English label for the quick create button. This can be overridden by publishing and modifying the translation file.

```php
return [
    'button_label' => 'Quick Create',  // Default English
];
```
Tokens:
Raw