How do I start using Winter CMS? Posted in Tips on May 20, 2021.

Luke Towers

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.*",
"laravel/framework": ...,

to

"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",
"laravel/framework": "~6.0",

Wizard based Installation

Copy the 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 modules directory to be unavailable if Composer removes the October CMS modules after installing the Winter CMS modules. If this occurs, please re-run composer update and 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'; to $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:version or october:util set build usually in composer.json) you will need to switch them to winter:* instead.

It is also recommended to update references to $.oc 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 X-Winter-* instead.

Troubleshooting

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.

Composer create-project or update command fails due to the composer-merge-plugin dependency

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 composer.json file.

Keep informed

Sign up to our newsletter to receive updates on Winter CMS releases, new features in the works, and much more.
We'll never spam or give this address away.

Latest blog post

The Winter CMS Web Installer is now available!

Published June 17, 2021
We are super excited to announce that our new Web-based Installer is finally available for download, to make it super easy to get your next Winter CMS project started!

View this post Read all posts

Latest Winter CMS release

v1.1.3

Released April 26, 2021
3 UX/UI Improvements, 19 API Changes, 23 Bug Fixes, 3 Security Improvements, 4 Translation Improvements, 1 Community Improvement, 2 Dependencies

View details View all releases