Compare commits

...

2 Commits

Author SHA1 Message Date
Sabina Talipova 1993f741b7
Merge pull request #33 from creative-commoners/pulls/2.0/cms5-readme
DOC Update README.md for CMS 5
2023-04-24 13:26:51 +12:00
Guy Sartorelli 190bf80dbe
DOC Update README.md for CMS 5 2023-04-19 16:24:39 +12:00
1 changed files with 27 additions and 21 deletions

View File

@ -19,6 +19,12 @@ These recipes allow for the following features:
recipe dependencies without mandating the inclusion of all requirements directly. recipe dependencies without mandating the inclusion of all requirements directly.
- An `update-recipe` command to upgrade to a newer version of a recipe. - An `update-recipe` command to upgrade to a newer version of a recipe.
## Installation
```sh
composer require silverstripe/recipe-plugin
```
## Example output ## Example output
![example-output](docs/_images/require-usage.png) ![example-output](docs/_images/require-usage.png)
@ -27,15 +33,15 @@ These recipes allow for the following features:
Recipes can be introduced to any existing project (even if not created on a silverstripe base project) Recipes can be introduced to any existing project (even if not created on a silverstripe base project)
```shell ```sh
$ composer init composer init
$ composer require silverstripe/recipe-cms ^1.0@dev composer require silverstripe/recipe-cms
```` ```
Alternatively you can create a new project based on an existing recipe Alternatively you can create a new project based on an existing recipe
```shell ```sh
$ composer create-project silverstripe/recipe-cms ./myssproject ^1.0@dev composer create-project silverstripe/recipe-cms ./myssproject
``` ```
## Inlining recipes ## Inlining recipes
@ -50,18 +56,18 @@ install a new recipe.
Note that if you wish to run this command you must first install either a recipe via normal composer Note that if you wish to run this command you must first install either a recipe via normal composer
commands, or install the recipe plugin: commands, or install the recipe plugin:
```shell ```sh
$ composer init composer init
$ composer require silverstripe/recipe-plugin ^0.1 composer require silverstripe/recipe-plugin
$ composer require-recipe silverstripe/recipe-cms ^1.0@dev composer require-recipe silverstripe/recipe-cms
``` ```
or or
```shell ```sh
$ composer init composer init
$ composer require silverstripe/recipe-cms ^1.0@dev composer require silverstripe/recipe-cms
$ composer update-recipe silverstripe/recipe-cms composer update-recipe silverstripe/recipe-cms
``` ```
## Removing recipe dependencies or files ## Removing recipe dependencies or files
@ -80,9 +86,9 @@ as below.
"mysite/code/PageController.php" "mysite/code/PageController.php"
], ],
"project-dependencies-installed": { "project-dependencies-installed": {
"silverstripe/admin": "1.0.x-dev", "silverstripe/admin": "2.0.x-dev",
"silverstripe/asset-admin": "1.0.x-dev", "silverstripe/asset-admin": "2.0.x-dev",
"silverstripe/campaign-admin": "1.0.x-dev" "silverstripe/campaign-admin": "2.0.x-dev"
} }
} }
} }
@ -148,10 +154,10 @@ An example recipe:
"description": "Example silverstripe recipe", "description": "Example silverstripe recipe",
"type": "silverstripe-recipe", "type": "silverstripe-recipe",
"require": { "require": {
"silverstripe/recipe-plugin": "^0.1", "silverstripe/recipe-plugin": "^1.0",
"silverstripe/recipe-cms": "^1.0", "silverstripe/recipe-cms": "^5.0",
"silverstripe/blog": "^3.0@dev", "silverstripe/blog": "^4.0",
"silverstripe/lumberjack": "^2.1@dev", "silverstripe/lumberjack": "^3.0",
}, },
"extra": { "extra": {
"project-files": [ "project-files": [