sproutcms/module

Template Sprout 4 Module

v4.0.2 2024-04-05 06:55 UTC

This package is auto-updated.

Last update: 2024-10-24 23:11:29 UTC


README

SproutCMS is a flexible and feature rich cms and application framework, developed in PHP, designed to enable quick and agile custom development. SproutCMS was built to reward innovation and encourage developers to produce complex applications. It is built by developers, for developers.

This a module template project for Sprout 4. It provides a sample module as a Composer package to be loaded into your Sprout project.

Demo

This module is actually functional and serves as the Demo module for the sproutcms/site project.

Install it and see for yourself:

composer create-project sproutcms/site
composer serve

Getting started

composer create-project sproutcms/module my-module

Now update the composer.json file:

  1. Update the package name
  2. Update (or remove) description + keywords
  3. Update the license (optional)
  4. Update the namespace (also in each php file)
  5. Update the package name (and in DemoModule::getVersion())

Usage

Install this into your project by publishing the package or with a local or VCS repository:

{
    "repositories": [{
        "type": "vcs",
        "url": "https://github.com/user/my-module"
    }]
}

Patch Locals

This tool will symlink sibling folders as package into a project. This is great for fast development across multiple packages. The config lives inside the composer file extra.locals.

Multiple Modules

It's possible to house more than one Sprout module in the same Composer package. One can configure multiple namespaces or simply create multiple module classes.