Core concepts and basic usage

Includes 7 Modules 09:30

Included modules

Introduction

Time requirement

1 hour

Dependencies

None

Orchard ecosystem as under the Orchard link collection
Showcasing complex/notable Orchard apps from Show Orchard.
Architectural overview
- .NET -> ASP.NET Core -> ASP.NET Core MVC -> Orchard Core
- Uses a lot of other open-source projects and common web frameworks/library (e.g. Json.NET, Lucene, xUnit, YesSQL, jQuery, Bootstrap)
- Modularized architecture (modules, themes)
How to get my own Orchard instance?
- Official Orchard releases as source or from NuGet
- Using the preview package feed
Using Orchard as a full, decoupled, and headless CMS
Installing Orchard (running the setup): choosing a database engine (and its implications), recipes
Basic site settings
Demo: fire up Visual Studio and create a new ASP.NET Core Web Application. Follow the Getting started with Orchard Core as a NuGet package page to create an Orchard Core CMS application.
Demo: installing and basic settings. You can install with the Agency theme at this stage if you want to show differences between recipes or install with the Blog recipe right away to showcase its content types later.

Introduction

Time requirement

2 hours

Dependencies

None

Content model and content management
- Content types, parts and fields
- Creating and editing content items and content types, Content Preview
- Versioning: drafts (and Draftable metadata) and published versions
- Other metadata (apart from Securable and indexing-related)
- Demo: basic content types of The Blog recipe (Page, widgets, Blog Post, listing content items like Blog does)
- Demo: basic content types of The Agency recipe (Landing Page, widgets, change the content of the Landing Page content item)
- Demo: creating a content type
- Demo: editing and versioning a content item
- Exercise: creating a content type with fields and parts and creating items based on instructions
Modules and themes
- Enabling/disabling module features and themes
- Dependencies
- Always enabled features
User management and roles, permissions
- Users: user management features, enabling Users Registration, listing users, settings
- Roles: editing existing roles, creating new roles, permissions (general ones and for content types)
- Securable metadata and dynamic content type permissions
- Demo: users and roles admin pages
- Demo: register with a new user, verify the email address (configure SMTP), and see the details of the user in the admin UI
- Exercise: creating a role with selected permissions; enabling registration, registering a new user and assigning it to the newly created role

Introduction

Time requirement

1 hour

Dependencies

Basic site management

Taxonomies
Widgets in Layers
- Layers and layer rules, zones (theme anatomy)
- Adding new supported zones
- When to add widgets to content items (differences between Bag Part, Flow Part, Widgets List Part) and when to layers
- Demo: creating a new layer and an Html Widget
- Demo: creating a new content type with the Widget stereotype, add that to a Zone
- Exercise: creating NotTheHomepage layer and an Html Widget in the Footer zone in that layer
Navigation
- Creating and editing a menu
  - Adding and editing Link Menu Items and Content Menu Items
  - Editing link hierarchy
- Comparison with Admin Menus
- Exercise: creating a menu with all kinds of items
Media management
- Managing media with Media Library
- Inserting images into text fields
- For this, prepare suitable files. Pictures from the Wikipedia Cat article are included in the Attachments folder.

Introduction

Time requirement

2 hours 30 minutes

Dependencies

Intermediate content management

Search and indexing (see the official docs for a guide on this)
- Enabling Lucene; what is an indexing service (eg. Lucene)
- Enabling a content type for full-text (content type editor)
- Creating and configuring an index
Forms, Liquid and Workflows
- An overview of Workflows features
- Overview of Liquid
- Creating a new Liquid Template by displaying the attached media of a Media Field ( ContentType__MediaField )
- Using Forms, using ReCaptcha to prevent spam
- Demo: creating a workflow that displays a greeting for users upon logon, displaying their name with Liquid ( Hello {{User.Identity.Name}}! )
- Demo: creating a workflow that displays the site name for users upon logon with Liquid ( Welcome to {{Site.SiteName}}! )
- Demo: creating a contact form and handling form posts with a workflow. See the official docs on this.
Auditing content with Audit Trail

Introduction

Time requirement

1 hour 30 minutes

Dependencies

Advanced content management

Deployment and recipes
- Exporting/importing content
- Remote deployment
Queries and Templates
- SQL queries (see the official docs for sample queries)
- Displaying query results from a Liquid template (e.g. with Liquid Page)
- Lucene queries
OpenID
- Set up the Authorization Server
- Allow Client Credentials Flow
- Add a new Application
- Mention the ViewContentApi permission
- Demo: using Postman to get a new access token and manipulate content items using the built-in APIs in Orchard Core

Introduction

Time requirement

1 hour

Dependencies

Intermediate content management

Multi-tenancy
Writing recipes
- Installing and enabling themes/features
- Commands
- Adding exported content types and content items
Optional: localization
- Installing a .po package
- Setting up locales and creating localized content items

Introduction

Time requirement

30 minutes

Dependencies

Basic site management

Troubleshooting
- Enabling the display of all thrown exception
- Understanding log files (see sample in attachments)
- Contacting module authors and filing reproducible, meaningful bug reports

Privacy consent

Core concepts and basic usage

Included modules

Introduction

Introduction

Introduction

Introduction

Introduction

Introduction

Introduction