ZauberCMS
  • 🪄Welcome to ZauberCMS
  • Getting Started
    • 💡Quick Start
      • Databases
  • Creating A Website
    • 📹Website Build Video Tutorial
    • Content Types
      • Element Types
      • Compositions
    • Current Content Properties
      • Textbox & Textarea
      • Text Editor (Radzen)
      • Text Editor (TinyMCE)
      • Numeric
      • True / False
      • Rating
      • Checkbox, Dropdown & Radio Lists
      • Media Picker
      • Navigation
      • Material Icon Picker
      • Content Picker
      • Date Picker
      • Custom Component Picker
      • Api Key Picker
      • Colour Picker
      • Block List Editor
      • Editor Notes
      • Google Map Location Picker
      • Simple List Manager
      • Simple Dictionary Manager
      • SEO Property
      • Code Editor
      • Colour Theme Picker
    • Content
      • Publish & Unpublish
    • Querying Data
      • Extension Methods
    • Views
    • Controllers (Route Hi-Jacking)
    • Custom Components
    • Users & Roles
      • Restrict Access By Role
    • Logs
    • Audit
    • Global Settings
      • Using Global Settings
    • SEO Sitemaps
    • Hosting
  • Extending ZauberCMS
    • Overview
    • BlockListEditor
      • Content Block Preview
      • Content Block
    • Custom List Data
    • Custom Content Property
    • Custom Validation
    • Custom Admin Sections
      • Section Nav Group Menu
      • Trees
        • Tree Context Menus
      • Reusing Content Editors
    • Saving Custom Data
    • Using AppState Events
    • Before & After Save
    • Email & Storage Providers
    • Seed Data
    • SEO Checks
  • Identity
    • Overview
    • External Authentication Providers
    • Account Layout
  • Language
    • Overview
    • Adding Language Dictionaries
    • Setting The Language
    • Using Language Dictionaries
  • AppSettings
    • Detailed Errors
    • Media Settings
    • Enable Path Urls
Powered by GitBook
On this page
  • Using .Net Template
  • Using Nuget
  • Starter Site
  1. Getting Started

Quick Start

This page will run you through getting ZauberCMS up and running (Using either the .Net template or Nuget) and then creating your first page and getting data out the CMS.

PreviousWelcome to ZauberCMSNextDatabases

Last updated 1 month ago

Using .Net Template

Fastest way to get started is using the .Net Template, firstly install the ZauberCMS template (--force just makes sure you install the latest one)

dotnet new install ZauberCMS.Template --force

Then simple create your solution using the below:

dotnet new zaubercms -n "YourSiteName"

Watch this website build tutorial for more information

Using Nuget

If you want to use the Nuget package manually you can follow this video - Please note: This video is from when we were using Blazor for the front end, but the same concept applies now for V3+. Just create a new .NET MVC app instead of a Blazor app.

  1. Create a new .NET MVC project

  2. Clear out everything, so you are left with just the wwwroot and an empty program.cs like below

  3. Now install the ZauberCMS nuget package

  4. dotnet add package ZauberCMS
  5. In your Program.cs, update it to add the AddZauberCMS methods to the builder and the app and the correct namespaces

  6. using ZauberCMS.Components;
    using ZauberCMS.Core.Plugins;
    
    var builder = WebApplication.CreateBuilder(args);
    
    builder.AddZauberCms();
    
    var app = builder.Build();
    
    app.AddZauberCms<App>();
    
    app.Run();
  7. Now build your solution, and the ZauberCMS appSettings.json default will be added to the solution,

  8. Now just build and run the app and you'll see the install page with instructions to browse to /admin and create an account. The first account created will be made and admin, and it will redirect you to the admin.

Starter Site

Currently the repo for ZauberCMS on Github comes with the starter site out of the box and uses SQLite.

Get Up & Running

  • Clone the repo

  • Build and run the app

  • When the starter site loads

  • Go to /admin

  • Register as a new user and you will be redirected to the admin

💡
📹Website Build Video Tutorial
Video showing how to get started with the Nuget package
Blank Blazor App