folklore/laravel
laravel-folklore
The shared foundation of the Laravel sites built by Folklore: entities and repositories over Eloquent models, JSON columns with references to other models (through folklore/laravel-json-data), and opt-in modules for medias, pages, auth and third-party services.
Versions
| Version | Branch | Status | Requires |
|---|---|---|---|
| 2.x | v2.x (default) |
In development, released as alphas | PHP 8.3+, Laravel 12 or 13 |
| 1.x | v1.1 |
Maintained: fixes and security | PHP 8.3+, Laravel 11 to 13 |
Installation
2.x, during its pre-releases:
composer require folklore/laravel-folklore:^2.0@alpha folklore/laravel-json-data:^1.0@alpha
folklore/laravel-json-data is required by the core. Require it too while it has no stable release: a stability flag doesn't apply to the dependencies of a required package.
The modules are off by default and are turned on in config/site.php; each one suggests the packages it needs. See the architecture.
With the panneau module, a site's admin starts from the standard resources: pages with their blocks, users and the media library, which the site's own classes extend (the architecture):
namespace App\Panneau\Resources;
class Pages extends \Folklore\Panneau\Resources\Pages {}
folklore:install writes these classes, with the site's contracts, entities, models, repositories and block types, and wires them in config/site.php and App\Providers\PanneauServiceProvider. It skips the files that exist, so it can run again to add a resource:
php artisan folklore:install # pages, users and medias
php artisan folklore:install --only=medias # one resource
php artisan folklore:install --dry-run # what it would write
--force overwrites the classes that exist. php artisan vendor:publish --tag=folklore-stubs publishes its stubs, and those of the make:* commands, to change them.
1.x:
composer require folklore/laravel-folklore:^1.1
Documentation
- docs/: architecture, decisions, the plan of 2.0 (roadmap) and the upgrade guide from 1.1.
- CHANGELOG
- AGENTS.md: how to work on this repository.
License
MIT
Related Packages
Version History
| Version | Released | PHP | Laravel | License |
|---|---|---|---|---|
| v8.5.13 | ^7.3| | ^8.12 | MIT | |
| v8.5.12 | ^7.3| | ^8.12 | MIT | |
| v8.5.11 | ^7.3| | ^8.12 | MIT | |
| v8.5.10 | ^7.3| | ^8.12 | MIT | |
| v8.5.9 | ^7.3| | ^8.12 | MIT | |
| v8.5.8 | ^7.3| | ^8.12 | MIT | |
| v8.5.7 | ^7.3| | ^8.12 | MIT | |
| v8.5.6 | ^7.3| | ^8.12 | MIT | |
| v8.5.5 | ^7.3| | ^8.12 | MIT | |
| v8.5.4 | ^7.3| | ^8.12 | MIT | |
| v8.5.3 | ^7.3| | ^8.12 | MIT | |
| v8.5.2 | ^7.3| | ^8.12 | MIT | |
| v8.5.1 | ^7.3| | ^8.12 | MIT | |
| v8.5.0 | ^7.3| | ^8.12 | MIT | |
| v8.4.4 | ^7.3| | ^8.12 | MIT | |
| v8.4.3 | ^7.3| | ^8.12 | MIT | |
| v8.4.2 | ^7.3| | ^8.12 | MIT | |
| v8.4.1 | ^7.3| | ^8.12 | MIT | |
| v8.4.0 | ^7.3| | ^8.12 | MIT | |
| v8.3.0 | ^7.3| | ^8.12 | MIT | |
| v8.2.0 | ^7.3 | ^8.0 | MIT | |
| v8.1.0 | ^7.3 | ^8.0 | MIT | |
| v8.0.3 | ^7.3 | ^8.0 | MIT | |
| v8.0.2 | ^7.3 | ^8.0 | MIT | |
| v8.0.1 | ^7.3 | ^8.0 | MIT | |
| v8.0.0 | ^7.3 | ^8.0 | MIT | |
| v7.30.1 | ^7.2.5| | ^7.29 | MIT | |
| v7.30.0 | ^7.2.5| | ^7.29 | MIT | |
| v7.29.0 | ^7.2.5| | ^7.29 | MIT | |
| v7.28.0 | ^7.2.5 | ^7.24 | MIT |
Showing the latest 30 of 109. See every release on Packagist
Pre-releases (2)
| Version | Released | Laravel | License |
|---|---|---|---|
| v4.0.0-BETA4 | 4.0.* | ||
| v4.0.0-BETA3 | 4.0.* |