- What is liberusoftware/module-cms-hello?
- It is a trivial proof-of-concept CMS module for Liberu CMS built on Laravel. It demonstrates the full module pipeline: descriptor, isolation, contract, service, event, route, migration, config, and tests. Use it to learn how a Liberu CMS module is wired together, not as a production feature.
- How do I install liberusoftware/module-cms-hello?
- Install it with Composer inside a Laravel application that already uses Liberu CMS. Run composer require liberusoftware/module-cms-hello and follow the Liberu CMS module registration conventions for your installation. Because it is a demo module, check its stability and Laravel constraints before adding it to an existing application.
- Which Laravel versions does module-cms-hello support?
- The package is a Liberu CMS module for Laravel, but the provided context does not list exact version constraints. Check its composer.json for laravel/framework or illuminate/support requirements and confirm the Liberu CMS version it targets. Match those constraints to your application before installing.
- Can I use this package as a starter template for a custom CMS module?
- Yes, that is its main purpose. It provides a minimal example of module structure, routing, config, migrations, services, events, contracts, and tests. Copy the pattern into your own module namespace and replace the hello-world behavior with your CMS feature rather than shipping the demo as-is.
- What files and structure does the module include?
- It includes a module descriptor, isolated module code, a contract, a service, an event, a route definition, a migration, config, and tests. These pieces mirror the pipeline that a Liberu CMS module needs to exercise. Exact paths depend on the package, so inspect vendor/liberusoftware/module-cms-hello after installation.
- How does routing work in this hello-world module?
- The module registers a simple route to demonstrate CMS route integration. It exposes the hello endpoint through the module route file loaded by the Liberu CMS module pipeline. Use it as a pattern for adding your own routes, middleware, and controllers.
- Do I need to publish config or run migrations for this module?
- The module includes config and a migration specifically to exercise those pipeline stages. In a demo setup, run migrations if the module service provider loads them, and publish config only if the package documents publishable assets. Check the module provider and Liberu CMS installation docs for the exact commands.
- What do the contract, service, and event demonstrate?
- They show how a module can bind a contract to a service and dispatch an event within the CMS module lifecycle. The point is to demonstrate isolation and dependency inversion rather than complex business logic. Use these examples to structure your own module services and events.
- How do I test liberusoftware/module-cms-hello?
- The module includes tests as part of its pipeline proof. Run the package test suite with your normal Composer and PHPUnit setup, or copy its test patterns into your own module. In a host Laravel application, also verify route, migration, config, and event behavior with integration tests.
- Is module-cms-hello production-ready, and what are the alternatives?
- No, it is explicitly a trivial proof-of-concept and starter example, not a production CMS feature. For real functionality, build on Liberu CMS modules or use a maintained Laravel CMS package. Treat this package as documentation-by-example and check maintenance activity before relying on it.