Merge branch 'main' of https://github.com/filamentphp/filamentphp.com

content/authors/christopher-pitt.md

@@ -1,6 +1,6 @@
 ---
 name: Christopher Pitt
-slug: assertchris
+slug: christopher-pitt
 github_url: https://github.com/assertchris
 twitter_url: https://twitter.com/assertchris
 sponsor_url: https://github.com/sponsors/assertchris

content/authors/danharrin.md

@@ -2,7 +2,7 @@
 name: Dan Harrin
 slug: danharrin
 github_url: https://github.com/danharrin
-twitter_url: https://twitter.com/danjharrin]
+twitter_url: https://twitter.com/danjharrin
 sponsor_url: https://github.com/sponsors/danharrin
 ---
 

content/authors/dododedodonl.md

@@ -0,0 +1,9 @@
+---
+name: Tom Janssen
+slug: dododedodonl
+github_url: https://github.com/dododedodonl
+twitter_url: https://twitter.com/dododedodonl
+mastodon_url: https://phpc.social/@dododedodonl
+---
+
+Tom is a developer from The Netherlands. He works at [Dutch Coding Company_](https://dutchcodingcompany.com/).

content/authors/omar-haris.md

@@ -0,0 +1,8 @@
+---
+name: Omar Haris
+slug: omar-haris
+github_url: https://github.com/omar-haris
+linkedin_url: https://www.linkedin.com/in/omarharis
+---
+
+With over 8 years of experience, I possess a comprehensive understanding of the entire life cycle of software development projects. My adeptness extends to swiftly acquiring and mastering new technologies. Additionally, I bring to the table robust problem-solving abilities.

content/plugins/dododedodonl-socialite.md

@@ -0,0 +1,16 @@
+---
+name: Socialite
+slug: dododedodonl-socialite
+author_slug: dododedodonl
+categories: [panel-authentication]
+description: Filament support for `laravel/socialite`.
+discord_url: https://discord.com/channels/883083792112300104/962299008259342366
+docs_urls:
+  v3: https://raw.githubusercontent.com/DutchCodingCompany/filament-socialite/main/README.md
+  v2: https://raw.githubusercontent.com/DutchCodingCompany/filament-socialite/0.2.6/README.md
+github_repository: DutchCodingCompany/filament-socialite
+has_dark_theme: true
+has_translations: true
+versions: [2, 3]
+publish_date: 2023-12-05
+---

content/plugins/filament-minimal-theme.md

@@ -62,6 +62,8 @@ Next, replace the imported Panel Builder stylesheet with the Minimal Theme style
 + @import '/vendor/filament/minimal-theme/resources/css/index.css';
 ```
 
+Now compile your theme stylesheet using `npm run build`.
+
 #### Configuration
 
 Finally, register the theme plugin in your panel configuration file, and configure the colors and icons:

content/plugins/lara-zeus-bolt-pro.md

@@ -1,12 +1,12 @@
 ---
-name: Bolt Pro ⚡️ Advanced Forms Bolt Features.
+name: Bolt Pro ⚡️ Advanced Features for Bolt
 slug: lara-zeus-bolt-pro
 author_slug: lara-zeus
 categories: [panel-builder]
-checkout_url: https://store.larazeus.com/checkout/buy/610693ec-695d-4666-8136-da5e76c32b47?embed=1&logo=0
+checkout_url: https://store.larazeus.com/checkout/buy/610693ec-695d-4666-8136-da5e76c32b47?embed=1&media=0&logo=0&desc=0
 description: Advanced Forms Bolt management, More Filtering, Presets, and New Fields for Bolt the form builder
 discord_url: https://discord.com/channels/883083792112300104/1121563279668555897
-docs_url: http://larazeus.com/storage/docs/bolt/v2/bolt-pro.md
+docs_url: http://larazeus.com/storage/docs/bolt/v2/filament-bolt-pro.md
 url: https://larazeus.com/bolt-pro
 github_repository: lara-zeus/bolt-pro
 has_dark_theme: true

content/plugins/lara-zeus-bolt.md

@@ -1,5 +1,5 @@
 ---
-name: Bolt ⚡️ Form builder UI
+name: Bolt ⚡️ Form builder with UI
 slug: lara-zeus-bolt
 author_slug: lara-zeus
 categories: [panel-builder]

content/plugins/lara-zeus-helen.md

@@ -1,10 +1,10 @@
 ---
-name: Helen ⚡️ Short URLs managements
+name: Helen ⚡️ Short URLs Management
 slug: lara-zeus-helen
 author_slug: lara-zeus
 categories: [panel-builder]
-checkout_url: https://store.larazeus.com/checkout/buy/da5e7c95-f9a7-4502-b494-5b2152df1949?embed=1&logo=0
-description: Short URLs managements with QR code generator, statistics and custom actions
+checkout_url: https://store.larazeus.com/checkout/buy/da5e7c95-f9a7-4502-b494-5b2152df1949?embed=1&media=0&logo=0&desc=0
+description: Short URLs management with QR code generator, statistics and custom actions
 discord_url: https://discord.com/channels/883083792112300104/1184785048210264125
 docs_url: http://larazeus.com/storage/docs/helen/v1/filament.md
 url: https://larazeus.com/helen

content/plugins/lara-zeus-hermes.md

@@ -1,10 +1,10 @@
 ---
-name: Hermes ⚡️ Restaurants and Cafés Menu Managements
+name: Hermes ⚡️ Restaurants and Cafés Menu Management
 slug: lara-zeus-hermes
 author_slug: lara-zeus
 categories: [panel-builder]
-checkout_url: https://store.larazeus.com/checkout/buy/210bbf3c-b138-4cbc-ad59-f9366cb64770?embed=1&logo=0
-description: Restaurants and Cafés Menu Managements, with sections and prices
+checkout_url: https://store.larazeus.com/checkout/buy/210bbf3c-b138-4cbc-ad59-f9366cb64770?embed=1&media=0&logo=0&desc=0
+description: Restaurants and Cafés Menu Management, with sections and prices
 discord_url: https://discord.com/channels/883083792112300104/1184785263155748895
 docs_url: http://larazeus.com/storage/docs/hermes/v1/filament.md
 url: https://larazeus.com/hermes

content/plugins/lara-zeus-qr.md

@@ -1,9 +1,9 @@
 ---
-name: Qr ⚡️ Form Field
+name: Qr ⚡️ Component
 slug: lara-zeus-qr
 author_slug: lara-zeus
 categories: [form-builder, form-field]
-description: Qr Code Form Field to generate Qr with designing options.
+description: Qr Code Component, Form Field to generate Qr with designing options.
 discord_url: https://discord.com/channels/883083792112300104/1184785550964686919
 docs_url: https://raw.githubusercontent.com/lara-zeus/qr/1.x/docs/filament.md
 url: https://larazeus.com/qr

content/plugins/lara-zeus-sky.md

@@ -3,7 +3,7 @@ name: Sky ⚡️ CMS, with pages, posts, and more
 slug: lara-zeus-sky
 author_slug: lara-zeus
 categories: [panel-builder]
-description: CMS. it includes posts, pages, tags, and categories and more, with a frontend scaffolding. easy to customize it.
+description: CMS. it includes posts, pages, tags, categories and more, with a frontend scaffolding. easy to customize it.
 discord_url: https://discord.com/channels/883083792112300104/965924351289491496
 docs_url: https://raw.githubusercontent.com/lara-zeus/sky/3.x/docs/filament.md
 url: https://larazeus.com/sky

content/plugins/lara-zeus-thunder.md

@@ -1,9 +1,9 @@
 ---
-name: Thunder ⚡️ Ticketing System.
+name: Thunder ⚡️ Ticketing System
 slug: lara-zeus-thunder
 author_slug: lara-zeus
 categories: [panel-builder]
-checkout_url: https://store.larazeus.com/checkout/buy/e9fb129e-68cf-40eb-b3ab-c2878b6943cd?embed=1&logo=0
+checkout_url: https://store.larazeus.com/checkout/buy/e9fb129e-68cf-40eb-b3ab-c2878b6943cd?embed=1&media=0&logo=0&desc=0
 description: Ticketing system. with offices, chat, and Frontend Ready.
 discord_url: https://discord.com/channels/883083792112300104/1184785837335007322
 docs_url: http://larazeus.com/storage/docs/thunder/v2/filament.md

content/plugins/lara-zeus-wind.md

@@ -3,7 +3,7 @@ name: Wind ⚡️ Contact Us Form
 slug: lara-zeus-wind
 author_slug: lara-zeus
 categories: [panel-builder]
-description: Contact Us form, with departments, with a simple dashboard and frontend page to get you up and running easily.
+description: Contact Us form, with departments, and frontend ready.
 discord_url: https://discord.com/channels/883083792112300104/943098344174141460
 docs_url: https://raw.githubusercontent.com/lara-zeus/wind/3.x/docs/filament.md
 url: https://larazeus.com/wind

content/plugins/omar-haris-timezone-field.md

@@ -0,0 +1,14 @@
+---
+name: Timezone Field
+slug: omar-haris-timezone-field
+author_slug: omar-haris
+categories: [form-field, form-builder, table-column, table-builder]
+description:  A Laravel Filament component that enables users to choose a specific timezone grouped by regions, with support for multiple languages.
+discord_url: https://discord.com/channels/883083792112300104/1185728526817705984
+docs_url: https://raw.githubusercontent.com/omar-haris/filament-timezone-field/main/README.md
+github_repository: omar-haris/filament-timezone-field
+has_dark_theme: true
+has_translations: true
+versions: [3]
+publish_date: 2023-12-15
+---

content/plugins/ralphjsmit-onboarding-manager-pro.md

@@ -25,11 +25,13 @@ This package allows you to design beautiful and fully integrated onboarding expe
 - Add optional onboarding steps with the beautiful dashboard widget.
 - Guide your users through one or multiple [wizards](https://filamentphp.com/docs/2.x/forms/layout#wizard).💫
 - Redirect users to links (e.g. for an OAuth-process) or guide them through a multi-step wizard.
+- Let users complete actions straight from the dashboard using Filament actions (**NEW**). 
+- Allow users to skip actions (**NEW**).
 - Beautiful design & integration with Filament Admin.
 - Advanced widget design with native support for columns and column spans.
 - Support for dark mode. 🌚
 - Can be easily translated with a language file.
-  – Redirect to custom route after completing onboard flow.
+– Redirect to custom route after completing onboard flow.
 
 [**View changelog**](https://changelog.anystack.sh/filament-onboarding-manager-pro)
 
@@ -225,9 +227,15 @@ Track::make([
 ])
 ```
 
+You can also provide a name using a closure:
+
+```php
+Step::make(name: fn () => 'Hello ' . auth()->user()->first_name, identifier: 'greeting')
+```
+
 #### Adding a description
 
-You can add a description for the step by adding the `->description()` method:
+You can add a description for the step by adding the `->description()` method. Provide either a string, an `HtmlString` or a closure.
 
 ```php
 Step::make(name: 'Connect Notion', identifier: 'widget::connect-notion')
@@ -236,20 +244,50 @@ Step::make(name: 'Connect Notion', identifier: 'widget::connect-notion')
 
 #### Adding an icon
 
-You can add an icon to the step by using the `->icon()` method:
+You can add an icon (as string or as closure that returns string) to the step by using the `->icon()` method:
+
+```php
+Step::make(name: 'Connect Notion', identifier: 'widget::connect-notion')
+    ->icon('heroicon-o-check-circle')
+```
+
+#### Setting a color
+
+You can set the color of the icon using the `->color()` method. The default is `primary`.
 
 ```php
 Step::make(name: 'Connect Notion', identifier: 'widget::connect-notion')
     ->icon('heroicon-o-check-circle')
+    ->color('info')
 ```
 
-#### Adding a link
+#### Adding a url or action
 
-You can use the `->link()` method to add a link to the step. This link will be displayed to the user. You can use this to redirect to an OAuth provider or to a specific page in the dashboard:
+Each Step can have a button at the bottom of the page. This button can either be a link/url or an advanced Filament action, including things like modals or forms.
+
+You can use the `->url()` method to add a link to the step. Combine this method with the `performStepActionLabel()` to define the label that should be on the button. 
+
+The link will be displayed to the user. You can use this to redirect to an OAuth provider or to a specific page in the dashboard:
 
 ```php
 Step::make(name: 'Connect Notion', identifier: 'widget::connect-notion')
-    ->link('Add workspace →', route('callbacks.notion.authorize'), shouldOpenInNewTab: true)
+    ->performStepActionLabel('Add workspace →')
+    ->url(route('callbacks.notion.authorize'), shouldOpenInNewTab: true)
+```
+
+Alternatively, you can modify the `performStepAction()` to include any advanced code. This can include a modal or a form or any other PHP action that you want to run.
+
+For example, this is an action that would open the "notifications" slide-over using Livewire:
+
+```php
+Step::make(name: 'Notifications overview', identifier: 'open-notifications')
+  ->performStepAction(function (Action $action) {
+      return $action
+        ->label('Open notifications overview')
+        ->action(function (OnboardTrackWidget $livewire) {
+            $livewire->dispatch('open-modal', id: 'database-notifications');
+        });
+  })
 ```
 
 #### Determining if a step is complete
@@ -261,6 +299,40 @@ Step::make(name: 'Connect Notion', identifier: 'widget::connect-notion')
     ->completeIf(fn () => auth()->user()->workspaces()->exists())
 ```
 
+#### Allowing users to skip actions (NEW)
+
+You can now also allow your users to skip a certain step. You can do this by providing a closure to the `skippable()` method. Below is an example of how this logically might work together:
+
+```php
+Step::make(name: 'Notifications overview', identifier: 'open-notifications')
+  ->completeIf(function ()  {
+    return auth()->user()->onboarding_notifications_completed;
+  })
+  ->skippable(function ()  {
+      auth()->user()->onboarding_notifications_completed = true;
+      auth()->user()->save();
+  })
+  ->performStepAction(function (Action $action) {
+      return $action
+        ->label('Open notifications overview')
+        ->action(function (OnboardTrackWidget $livewire) {
+            $livewire->dispatch('open-modal', id: 'database-notifications');
+
+            auth()->user()->onboarding_notifications_completed = true;
+            auth()->user()->save();
+        });
+  })
+```
+
+By default, a user will be prompted with a model to confirm that they indeed want to skip the test. You can customize the modal details with the `->skipStepActionLabel()`, `->skipStepActionModalHeading()` and `->skipStepActionModalDescription()` methods:
+
+```php
+$step
+    ->skipStepActionLabel('Skip notifications')
+    ->skipStepActionModalHeading('Are you sure you want to skip this step?')
+    ->skipStepActionModalDescription('Your notifications will always still arrive in your overview.')
+```
+
 #### Adding a column span
 
 You can use the `->columnSpan()` method to specify how many columns wide the card should be. You can use the `Onboard::addTrack(/** Your steps */)->columns(/** Nr of columns */)` to specify how many columns there should be in total.
@@ -297,7 +369,8 @@ public function panel(Panel $panel): Panel
                     Step::make(name: 'Connect Notion', identifier: 'widget::connect-notion')
                         ->description('Sign in with Notion and grant access to your workspace.')
                         ->icon('heroicon-o-check-circle')
-                        ->link('Add workspace →', route('callbacks.notion.authorize'))
+                        ->performStepActionLabel('Add workspace →')
+                        ->url(route('callbacks.notion.authorize'))
                         ->completeIf(fn () => auth()->user()->workspaces()->exists())
                         ->columnSpan(1),
                     // Other steps
@@ -341,7 +414,8 @@ Track::make([
     Step::make(name: 'Connect Notion', identifier: 'widget::connect-notion')
         ->description('Sign in with Notion and grant access to your workspace.')
         ->icon('heroicon-o-check-circle')
-        ->link('Add workspace →', route('callbacks.notion.authorize'))
+        ->performStepActionLabel('Add workspace →')
+        ->url(route('callbacks.notion.authorize'))
         ->completeIf(fn () => auth()->user()->workspaces()->exists())
         ->columnSpan(1),
     // Other steps
@@ -378,7 +452,7 @@ $plugin
 
 #### Forcing a user to visit a link
 
-If you want your users to visit a link, e.g. for an OAuth app, you can use the exact same syntax as described earlier, without any changes.
+If you want your users to visit a url, e.g. for an OAuth app, you can use the exact same syntax as described earlier, without any changes.
 
 #### Adding wizards
 
@@ -409,7 +483,7 @@ Step::make('Your title', 'onboard::unique-identifier')
     ])
 ```
 
-> NB. The example import the steps for the wizard using `Filament\Forms\Components\Wizard\Step as WizardStep`. Otherwise it would collide with the `RalphJSmit\Filament\Onboard\Step`. The actual class name is still `Step`.
+> NB. The example import the steps for the wizard using `Filament\Forms\Components\Wizard\Step as WizardStep`. Otherwise, it would collide with the `RalphJSmit\Filament\Onboard\Step`. The actual class name is still `Step`.
 
 For all the `Step` configuration options (adding an icon and description), see the [Filament documentation](https://filamentphp.com/docs/3.x/forms/layout/wizard).
 
@@ -521,25 +595,34 @@ The below code is used to generate the cards in the onboarding widget:
 Track::make([
     Step::make('Create list', 'widget::create-list')
         ->description("Create a list to gather your subscribers.")
-        ->link('Add workspace →', route('callbacks.notion.authorize'))
+        ->performStepActionLabel('Create list')
+        ->url(fn () => ListResource::getUrl('create'))
         ->icon('tabler-list-check')
         ->columnSpan(2)
         ->completeIf(fn () => auth()->user()->workspaces()->exists()),
     Step::make('Connect Notion', 'widget::connect-notion')
         ->description("Sign in with Notion and grant access to your workspace.")
-        ->link('Add workspace →', route('callbacks.notion.authorize'))
+        ->performStepActionLabel('Add workspace →') 
+        ->url(route('callbacks.notion.authorize'))
         ->icon('tabler-brand-notion')
         ->columnSpan(2)
         ->completeIf(fn () => auth()->user()->workspaces()->exists()),
     Step::make('Embed form on site', 'widget::embed-form')
         ->description("Collect subscribers via the form or API. Or import subscribers from other software.")
-        ->link('Copy code', '#')
+        ->performStepActionLabel('Copy code')
+        ->performStepAction(function (Action $action) {
+            return $action
+                ->action(function (OnboardTrackWidget $livewire) {
+                    $livewire->dispatch('copy-code', code: '<div>...</div>')
+                }); 
+        })
         ->icon('tabler-code')
         ->columnSpan(3)
         ->completeIf(fn () => auth()->user()->copied_embed_form !== null),
     Step::make('Tweak the design', 'widget::tweak-design')
         ->description("Make your newsletter completely personal.")
-        ->link('Create a new design', '#')
+        ->performStepActionLabel('Create a new design')
+        ->url(fn () => DesignResource::getUrl('create'))
         ->icon('tabler-color-swatch')
         ->columnSpan(3)
         ->completeIf(fn () => auth()->user()->designs->first->created_at->lt(auth()->user()->designs->first->updated_at)),
@@ -560,7 +643,8 @@ Onboard::make()
     ->addTrack([
         Step::make('Connect to Notion', 'onboard::connect-notion')
             ->description('Click the button below to give Newsly access to your workspace')
-            ->link('Add workspace →', route('callbacks.notion.authorize'))
+            ->performStepActionLabel('Add workspace →')
+            ->url(route('callbacks.notion.authorize'))
             ->icon('tabler-brand-notion')
             ->completeIf(fn () => user()->workspaces()->exists()),
         Step::make('Create email list', 'onboard::create-email-list')

content/plugins/ralphjsmit-pulse.md

@@ -97,7 +97,7 @@ This recorder will track frequently visited pages in your Filament panel. The re
 
 ### Add plugin Blade files to `tailwind.config.js`
 
-For all panels that you want to use the package in, make sure that you have created a (Filament custom theme](https://filamentphp.com/docs/3.x/panels/themes#creating-a-custom-theme). Next, for each theme you need to add the following 2 lines to the `tailwind.config.js` file:
+For all panels that you want to use the package in, make sure that you have created a [Filament custom theme](https://filamentphp.com/docs/3.x/panels/themes#creating-a-custom-theme). Next, for each theme you need to add the following 2 lines to the `tailwind.config.js` file:
 
 ```js
 content: [