rectitude-open/filament-news

This is my package filament-news

v1.4.0 2025-05-29 12:10 UTC

This package is auto-updated.

Last update: 2025-05-29 12:12:15 UTC


README

Filament News Banner

Filament News

Do not use Tests PHPStan Latest Version on Packagist Total Downloads PRs Welcome

Filament News is a Filament plugin that provides a comprehensive news management interface for your application. It's designed to help you quickly set up a backend for managing news articles, complete with common features such as categories, tags, featured images, summaries, weight, and revision history. This package streamlines the process of integrating a robust news system into your Filament admin panel.

This package is also a standalone part of a CMS project: FilaPress.

Resource Page Cluster Migration Model Config View Localization

Installation

You can install the package via composer:

composer require rectitude-open/filament-news

You can publish and run the migrations with:

php artisan vendor:publish --tag="filament-news-migrations"
php artisan migrate

You can publish the config file with:

php artisan vendor:publish --tag="filament-news-config"

Optionally, you can publish the translations using

php artisan vendor:publish --tag="filament-news-config-translations"

This is the contents of the published config file:

return [
    'news_model' => RectitudeOpen\FilamentNews\Models\News::class,
    'news_category_model' => RectitudeOpen\FilamentNews\Models\NewsCategory::class,
    'tag_model' => RectitudeOpen\FilamentNews\Models\Tag::class,

    'news_category_page' => RectitudeOpen\FilamentNews\Filament\Pages\NewsCategory::class,
    'news_filament_resource' => RectitudeOpen\FilamentNews\Filament\Resources\NewsResource::class,
    'news_tag_filament_resource' => RectitudeOpen\FilamentNews\Filament\Resources\NewsTagResource::class,
];

Usage

The package provides a cluster page that allows you to view News in your Filament admin panel.

To use the cluster page provided by this package, you need to register it in your Panel Provider first.

namespace App\Providers\Filament;

use RectitudeOpen\FilamentNews\FilamentNewsPlugin;

class AdminPanelProvider extends PanelProvider
{
    public function panel(Panel $panel): Panel
    {
        return $panel
            ->plugins([
                FilamentNewsPlugin::make()
            ]);
    }
}

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.