Overview

The resources directory in the BlogPlugin is used to manage UI assets, language translations, CSS, and JavaScript files. This ensures that the plugin remains modular and can easily integrate with the main application.

Directory Structure

+-- plugins
|   +-- webkul
|   |   +-- blogs
|   |   |   +-- resources
|   |   |   |   +-- css    # Source CSS assets
|   |   |   |   +-- dist   # Compiled assets registered with Filament
|   |   |   |   +-- lang   # Language translations
|   |   |   |   +-- views  # Blade views for UI templates

Views

• The views directory contains Blade template files for the plugin.
• These files are used to render the UI for the BlogPlugin without modifying the core Laravel application.

Language Translations

• The lang directory holds language files to support multilingual functionality.
• Each language file should be structured inside its own locale-based subdirectory (e.g., en, fr, es).

Registering View and Language Namespace

In BlogServiceProvider, we define the namespace for views and language files so they can be referenced easily.

Example: BlogServiceProvider.php

<?php

namespace Webkul\Blog;

use Webkul\PluginManager\Package;
use Webkul\PluginManager\PackageServiceProvider;

class BlogServiceProvider extends PackageServiceProvider
{
    /**
     * Plugin name identifier.
     */
    public static string $name = 'blogs';

    /**
     * View namespace for the plugin.
     */
    public static string $viewNamespace = 'blogs';

    public function configureCustomPackage(Package $package): void
    {
        $package->name(static::$name)
            ->hasViews()
            ->hasTranslations();
    }
}

The hasViews() and hasTranslations() calls register the resources/views and resources/lang directories under the plugin's namespace.

Using Views in Blade Templates

Once the views are registered, you can reference them using the blogs:: namespace:

@include('blogs::layouts.master')

Using Language Translations

To retrieve a translated string from the lang directory:

__('blogs::messages.welcome')

Where messages.php (inside resources/lang/en) contains:

return [
    'welcome' => 'Welcome to the Blog Plugin!',
];

In practice, plugins organize their language files to mirror the src/Filament directory structure. For example, the blogs plugin stores the admin post resource strings in resources/lang/en/filament/admin/resources/post.php and references them as:

__('blogs::filament/admin/resources/post.navigation.title')

Managing CSS and JavaScript Files

Filament provides a way to load custom assets (CSS and JavaScript) into the panel.

Example: Registering Assets

Modify BlogServiceProvider.php to include assets:

public function packageBooted(): void
{
    FilamentAsset::register([
        Css::make('blogs', __DIR__.'/../resources/dist/blogs.css'),
    ], 'blogs');
}