How do I start using Winter for new projects?
Run the following command:
composer create-project wintercms/winter example.com "dev-develop"
How do I switch my existing projects to use Winter instead of October?
All existing plugins & themes remain compatible with this fork.
NOTE: If you were previously on October 1.0 you should also follow the Laravel 6 upgrade guide in order to update to Winter v1.1 at the same time.
Composer based Installation
Modify your composer.json as follows:
"october/rain": "1.1.*", "october/system": "1.1.*", "october/backend": "1.1.*", "october/cms": "1.1.*",
"winter/storm": "dev-develop as 1.1.999", "winter/wn-system-module": "dev-develop as 1.1.999", "winter/wn-backend-module": "dev-develop as 1.1.999", "winter/wn-cms-module": "dev-develop as 1.1.999",
Wizard based Installation
composer.json file from winter github repo to the root folder of your installation.
NOTE: After running
composer update, there is the potential for the
modulesdirectory to be unavailable if Composer removes the October CMS modules after installing the Winter CMS modules. If this occurs, please re-run
composer updateand the modules will be correctly installed.
You will also need to update bootstrap/autoload.php's
$helperPath = __DIR__.'/../vendor/october/rain/src/Support/helpers.php';
$helperPath = __DIR__.'/../vendor/winter/storm/src/Support/helpers.php';
If you are referencing any
October\Rain\* classes directly, you can continue to do so without fear of breaking as they are properly aliased to their
Winter\Storm\* equivalents, but we would recommend you change over the references anyways if you are committing to Winter CMS long term.
If you are making any calls to
october:* commands (including the
october:util set build usually in
composer.json) you will need to switch them to
It is also recommended to update references to
$.wn, although a compatibility layer exists for that functionality as well so that your existing projects will continue to work unmodified.
NOTE: If you are interacting with any of the
X-October-*headers directly, you will need to make sure you update them to be
Composer fails to generate autoload files - missing files from "tests" folder
If you have previously installed October from the Wizard installer, you may be missing the
tests folder in your install, or missing some required files within.
You can download a snapshot of Winter CMS from GitHub, and copy the
tests folder within the ZIP file and place that in your project folder to resolve this issue.
update command fails due to the
This dependency may require Composer v2 to be installed in order to be fully compatible. If you wish to continue to use Composer v1, you can remove the
wikimedia/composer-merge-plugin requirement from your
composer.json file to remove this dependency. Note that this dependency is used to bring in dependencies for plugins that have a
composer.json file within the plugin - if you have plugins with this requirement, you will need to include the plugin in your main