Johan Petersson
Mar 24, 2022
  2367
(11 votes)

New templates and “getting started” experience

Since we released CMS 12 and Commerce 14 our “getting started” experience has been lacking a bit. We decided to not upgrade our Visual Studio extension and instead rely on the new dotnet new experience. This meant that we had no item templates or the old trusty Alloy sample site available for CMS 12. We initially released two templates to create empty Content Cloud or Commerce Cloud projects and a CLI tool to create and manage databases. But we felt we could improve this experience further.

First, we decided to open source our templates so the community – you – can contribute and report issues. The new templates are now located on GitHub at https://github.com/episerver/content-templates.

When you install the templates they will be available from the command line as well as show up in the “New project dialog” in Visual Studio 2022 and later. In Visual Studio 2019 this can be enabled by toggling a preview flag, see https://devblogs.microsoft.com/dotnet/net-cli-templates-in-visual-studio/. Unfortunately, the item templates are not available in Visual Studio yet, but there are plans from Microsoft to enable this in the .NET 7 timeframe.

Install the templates by running following command:

dotnet new --install EPiServer.Templates

We also set out to make the templates cross-platform by enabling basic Docker support. The Docker support is not meant to be used when deploying the application, but rather as an effortless way to get started without the need to install Microsoft SQL Server.

The Alloy templates also got a bit of a refresh. We updated Bootstrap to the latest version and updated the look and feel to be a bit more modern.

This template previously contained code for creating an administrator user on startup, we have now added this capability in the product instead. This is enabled in all new templates. On first request you are redirected to a view where you can create the first administrator user. This is only enabled on loopback addresses (localhost) and when no user exists.

The following project templates are available:

  • Alloy (epi-alloy-mvc)
    Demonstration template. The Alloy template contains a site for a fictional company, Alloy Technologies, to demonstrate the most notable features of Optimizely Content cloud and gives you a site that is ready to explore and to learn from.
  • Empty Content Cloud (epi-cms-empty)
  • Empty Commerce Cloud (epi-commerce-empty)

And the following item templates:

  • Content component (epi-cms-contentcomponent)
    View component for blocks and partial content.
  • Content Type (epi-cms-contenttype)
  • Initialization Module (epi-cms-initializationmodule)
  • Scheduled Job (epi-cms-job)
  • Page Controller (epi-cms-pagecontroller)
  • Razor Page (epi-cms-razorpage)

To use a template, run following command:

dotnet new epi-alloy-mvc --name My.Web

The name option is optional. If you don't provide one, the directory name will be used instead.

To see a list of all available options that are template-specific, run following command:

dotnet new epi-alloy-mvc --help
Optimizely Alloy MVC (C#)
Author: Episerver AB
Description: Example MVC application for testing and learning Optimizely CMS.
Options:
  --enable-docker  Enable Docker support
                   bool - Optional
                   Default: false

  --sa-password    The password the SA database account should have
                   string - Optional
                   Default: Qwerty12345!

Hope this helps and improves your experience working with our products. Don’t hesitate to report any issues or suggestions on GitHub at https://github.com/episerver/content-templates. Also, look out for an update of the templates soon with full .NET6 support.

Mar 24, 2022

Comments

Erik Henningson
Erik Henningson Mar 26, 2022 04:10 PM

Great news! 

Karen McDougall
Karen McDougall Apr 6, 2022 11:39 AM

Fantastic news! I'm looking forward to using those fresh Alloy templates in the upcoming trainings!

Please login to comment.
Latest blogs
The 1001st Piece in your 1000 Piece Puzzle: .NET Default Interface Functions

I was recently working with a client who wanted a reasonably large subsystem added to Optimizely that would add automated management to their...

Greg J | Nov 28, 2022 | Syndicated blog

Video Demonstration, creating a CMS12 Alloy Sample Site

Hey All Below you will find a quick video demonstration on how to install a local version of Alloy Sample based on CMS12 / .Net 6. As you will see ...

Minesh Shah (Netcel) | Nov 28, 2022

How to create an admin user I Optimizely CMS – with Episerver CLI

In this blog post I’ll show how to create an admin user for Optimizely CMS in a new environment where you don’t have access to the admin interface.

Ove Lartelius | Nov 28, 2022 | Syndicated blog

Optimizely shortcuts in CMS 12 will get a trailing slash appended!

Not all URLs will work when the trailing slash is added, and that could cause problems. Hopefully it will be fixed soon.

Tomas Hensrud Gulla | Nov 26, 2022 | Syndicated blog

One week left of the beta certification period

Today it's one week until the last beta certification day. Do you exam no later than Wednesday the 30th.  Here are the reference and exam guides:...

Karen McDougall | Nov 23, 2022

Unbelievable FREE Heatmapping With Optimizely Web

Within this guide, you will learn how to integrate a free heat mapping tool to Optimizely Web so you can turbocharge your A/B testing capabilities....

Jon Jones | Nov 22, 2022 | Syndicated blog