czim/laravel-cms-models

Laravel CMS: Main Models Module Generator

![Software License][ico-license] , _(*1)

CMS for Laravel - Main Models Module

This module offers the means to edit Eloquent models through the Laravel CMS., _(*2)

Features:, _(*3)

• Model listings
• Edit forms for creating and updating model records
• Elaborate (optional) module configuration and customization.
  • Customizable listing columns, scopes, filters, sorting, etc.
  • Customizable edit form html, fields, validation rules, create vs. edit forms, etc.
  • Customizable model references, display labels, etc.
• Support for Translatable models
• Support for Listify'd models, with drag/drop reordering
• Support for nested child-parent listings and breadcrumb trails

To be used to with the Laravel CMS Core., _(*4)

For a better end-user experience when using file uploads, installing the Laravel CMS Upload Module is recommended., _(*5)

Version Compatibility

Changelog

View the changelog., _(*6)

Installation

Add the module class to your cms-modules.php configuration file:, _(*7)

``` php 'modules' => [ // ... Czim\CmsModels\Modules\ModelModuleGenerator::class, ],, <sub>(*8)</sub>

Add the service provider to your `cms-modules.php` configuration file:

``` php
    'providers' => [
        // ...
        Czim\CmsModels\Providers\CmsModelsServiceProvider::class,
        // ...
    ],

To publish the config:, <sub>(*9)</sub>

bash php artisan vendor:publish, <sub>(*10)</sub>

Configuration

Models may be added with basic functionality by simply registering them in the cms-models config, or special CMS model configuration files may be created for them to customize them as needed., <sub>(*11)</sub>

Adding and Configuring Models

To register models with the CMS module, you can either:, <sub>(*12)</sub>

• Add their full class name to the cms-models.models config array:, <sub>(*13)</sub>

  <?php
        'models' => [
            App\Models\YourModel::class,
        ],
  

• Create a model configuration file for them in the configured directory.
  By default, this is in the app/Cms/Models/ directory; this is defined under the cms-models.collector.source.dir key., <sub>(*14)</sub>

For more details about customizing how models are configured, see the documentation on Model Configuration., <sub>(*15)</sub>

Troubleshooting

If you run into problems, please consult the CMS core troubleshooting section., <sub>(*16)</sub>

Further information

• General information about the CMS
• Model Configuration
• Strategies for all kinds of CMS setup and interaction

Contributing

Please see CONTRIBUTING for details., <sub>(*17)</sub>

Credits

• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*18)</sub>