README

About

Filament plugin for product catalogue data.

• 🟧 Pages and simple sections (WIP)
• 🟧 Menus (WIP) — create hierarhical and sortable list of links
• 🟧 Banners (WIP)
• ⏳ Page tags (planned) — tag pages and browse them by tags
• ⏳ Blog section (planned)
• ⏳ News section (planned)
• ⏳ Document section (planned) — versioned documents
• ⏳ Locations section (planned)
• ⏳ Photo gallery section (planned)
• ⏳ Other resources coming when needed (suggest a feature and/or hire us)

Requirements

• PHP >= 8.2 (due to Pest 3 requirement)
• Filament 3
• Filament Shield plugin (to manage permissions)

See composer.json for details.

Installation

1. Download the plugin with composer:

  composer require eclipsephp/cms-plugin

1. Add it to your panel's plugins:

class AdminPanelProvider extends PanelProvider
{
    public function panel(Panel $panel): Panel
    {
        $panel
            ->default()
            ->id('admin')
            ->path('admin')
            ->discoverResources(in: app_path('Filament/Resources'), for: 'App\\Filament\\Resources')
            ->discoverPages(in: app_path('Filament/Pages'), for: 'App\\Filament\\Pages')
            ->plugins([
                \Eclipse\Cms\CmsPlugin::make(),
            ]);

        return $panel;
    }
}

1. Run migrations

php artisan migrate

Contributing

Issues

If you have some suggestions how to make this package better, please open an issue or even better, submit a pull request.

Should you want to contribute, please see the development guidelines in the DataLinx PHP package template.

Development

1. All development is subject to our PHP package development guidelines.
2. Our Filament app development docs will also be helpful.
3. Any PRs will generally need to adhere to these before being merged.

Requirements

See here.

Get started

1. Clone the git repo
2. Start the Lando container

   lando start

3. Install dependencies (this also runs the setup composer script)

   lando composer install

4. You can now develop and run tests. Happy coding 😉

💡 To manually test the plugin in the browser, see our recommendation, which is also how Filament suggests package development.
However, the plugin should be universal and not dependent on our app setup or core package.

Changelog

All notable changes to this project are automatically documented in the CHANGELOG.md file using the release workflow, based on the release-please GitHub action.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

For all this to work, commit messages must follow the Conventional commits specification, which is also enforced by a Git hook.