CMS后端Web框架【免费下载链接】OrchardCoreOrchard Core is an open-source modular and multi-tenant application framework built with ASP.NET Core, and a content management system (CMS) built on top of that framework.项目地址https://gitcode.com/gh_mirrors/or/OrchardCore点击查看免费下载解耦式Decoupled开发模式让你在同一 Web 应用中同时拥有由 Orchard Core 驱动的管理后台以及完全由自己编写的 ASP.NET Core Razor Pages / Controllers 前端。本指南将带你从零创建一个可编辑、可渲染博客文章的完整网站涵盖内容建模、内容项加载、自定义路由、别名Alias与预览Preview功能并深入源码验证每一步的底层实现。读完本文你将掌握如何把 Orchard Core 作为内容管理后端无缝接入任意 ASP.NET Core 应用同时保持对页面输出 HTML 的绝对控制权。什么是解耦式 CMS解耦式Decoupled是一种开发模型网站的前端页面渲染与后端管理后台托管在同一个 Web 应用中但只有后端由 CMS 驱动。开发者可以自行编写 ASP.NET Razor Pages 或 Controllers对网站生成的 HTML 拥有完全控制权同时仍借助 CMS本案例中即 Orchard Core来完成内容创作与管理。注意本指南虽然从一个全新的项目起步并使用 Razor Pages但其中大部分内容同样适用于为任何已有的 ASP.NET Core 应用接入 Orchard Core 作为内容管理后端的场景。前置条件开始之前你应当具备创建新 ASP.NET Core 项目的能力熟悉 C# 与 HTML已安装 .NET SDK安装了 Visual Studio .NET 或 Visual Studio Code搭建项目方式一从 Visual Studio .NET 创建打开 Visual Studio .NET新建一个ASP.NET Core Web Application项目。输入项目名称Project name与位置Location。本教程使用OrchardSite作为项目名点击Create。选择Web Application模板其余保持默认点击Create。方式二从命令行创建在目标目录下执行dotnet new webapp -o OrchardSite其中OrchardSite即要创建的项目名。该命令会创建一个基于Razor Pages的 Web 应用。验证网站可运行启动项目新建的网站应能正常运行默认首页即为 Razor Pages 模板生成的页面。如果本地App_Data目录或端口存在冲突请清理后重新启动。将 Orchard Core CMS 接入网站打开或双击编辑项目的.csproj文件将PropertyGroup修改为PropertyGroup TargetFrameworknet10.0/TargetFramework /PropertyGroup说明此目标框架配置允许 Razor Pages 在运行时被重载而无需每次修改页面后重新编译整个项目。新增一个ItemGroup引用 Orchard Core CMS 的聚合包ItemGroup PackageReference IncludeOrchardCore.Application.Cms.Core.Targets Version3.0.1 / /ItemGroup该包会把 Orchard Core CMS 所需的全部模块与依赖引入项目。版本号请以当前 NuGet 上发布的最新稳定版本为准。编辑Program.cs注册 Orchard Core CMS 服务builder.Services.AddOrchardCms();⚠️Razor Pages 警告不要直接调用builder.Services.AddRazorPages()因为AddOrchardCms()内部已经包含了 Razor Pages 的注册。这一点可以从源码得到印证在 ServiceExtensions.cs 中AddOrchardCms()通过services.AddOrchardCore()链式调用了AddSecurity()、AddApiProblemDetails()、AddMvc()、AddIdGeneration()、AddSetupFeatures(OrchardCore.Setup)、AddDataAccess()、AddDataStorage()、AddTheming()、AddGlobalFeatures(OrchardCore.Liquid.Core)、AddCaching()等一系列扩展其中AddMvc()已负责注册 MVC 与 Razor Pages 管道。继续编辑Program.cs添加app.UseOrchardCore();。如果文件中存在以下代码行请全部移除builder.Services.AddRazorPages(); if (!app.Environment.IsDevelopment()) { app.UseExceptionHandler(/Error); app.UseHsts(); } app.UseHttpsRedirection(); app.UseRouting(); app.UseAuthorization(); app.MapRazorPages();移除它们的原因是Razor Pages 的注册与路由映射已经由 Orchard Core 内部完成重复注册会导致管道冲突。下面是一个最小化Program.cs的完整示例var builder WebApplication.CreateBuilder(args); // Add services to the container. builder.Services.AddOrchardCms(); var app builder.Build(); app.UseStaticFiles(); app.UseOrchardCore(); app.Run();再次启动应用此时会出现 Orchard Core 的Setup站点初始化界面初始化站点Setup 界面会要求你提供一些信息用于创建存储内容与用户账号的数据库输入站点名称本示例使用My Site。在Recipe配方下拉框中选择Blank site空白站点——该配方专门适用于解耦式decoupled与无头式headless模式。若自动检测到的时区不正确请手动选择时区。默认情况下所有日期与时间的录入和渲染都会相对于该时区进行。选择数据库服务器。最简单的方式是选择Sqlite无需任何额外配置步骤。在Super User超级用户区域输入账号信息本示例使用admin作为用户名。点击Finish Setup。几秒后网站会显示与原模板相同的首页并带有 Welcome 欢迎信息。如果你选择了Sqlite应用的全部状态数据都会存储在项目根目录下的App_Data文件夹中。若初始化过程中出现问题可尝试删除已有的App_Data文件夹然后重新执行本小节步骤。创建博客文章Blog Posts这一部分将覆盖 Orchard Core CMS 的核心内容管理概念内容类型Content Types与内容项Content Items。内容建模Content Modeling在 Orchard Core CMS 中大部分被管理的内容被称为内容项Content Item。内容项是一个带版本管理的文档可以是页面、文章、博客文章、新闻条目或任何你需要编辑的东西。每个内容项都基于一种内容类型Content Type内容类型定义了它由哪些属性构成。例如任何文章都会有标题和正文一篇博客文章可能还会有标签。Orchard Core CMS 允许你按照自己的意愿建模内容类型这被称为内容建模content modeling。给开发者的提示内容类型Content Type类似于一个类class而内容项Content Item可以看作是该类的实例instance。创建 Blog Post 内容类型Orchard Core 预置了一组可组合的内容管理元素称为内容部件Content Parts可以像搭 LEGO 积木一样用来构建自定义类型。例如**Title Part标题部件**提供了输入内容项标题的友好编辑器并默认将标题文本设置为界面中显示的文本另一个重要的部件是Markdown Body PartMarkdown 正文部件它提供了以 Markdown 形式存储并渲染内容项正文的能力非常适合博客文章。给开发者的提示内容部件Content Part类似于偏类partial class多个 Content Part 聚合在一起便定义了内容类型Content Type内容字段Content Field则类似于添加到内容类型上的自定义属性。现在创建一个名为Blog Post的新内容类型并添加必要的内容部件打开运行中的网站访问/admin。在登录界面输入 Setup 阶段设置的用户凭据。进入站点的管理端。在左侧菜单选择Design→Content Definition→Content Types。点击右上角的Create new type。在Display Name显示名称中输入Blog PostTechnical Name技术名称会自动生成为BlogPost。点击Create。在内容部件列表中勾选Title和Markdown Body然后点击Save。在随后的页面中滚动到页面底部将部件顺序调整为期望的顺序例如 Title 在前、MarkdownBody 在后然后点击Save。每个内容部件前都有一个Edit按钮允许你仅为当前类型定义该部件可用的设置。点击MarkdownBody部件旁的Edit。将编辑器类型选择为Wysiwyg editor所见即所得编辑器然后点击Save。至此Blog Post内容类型就准备好了。创建博客文章在左侧菜单选择Content→ContentItems。点击New Blog Post会展开一个针对BlogPost内容类型的编辑器。填写Title与MarkdownBody表单元素然后点击Publish发布。本示例使用This is a new day作为标题正文填入一些 Lorem Ipsum 文本。发布后内容项列表页会显示名为This is a new day的博客文章。随着内容项增多它们都会出现在这个页面上。在网站上渲染内容接下来创建自定义 Razor Page通过自定义 URL 展示任意博客文章。创建自定义 Razor Page在编辑器中于Pages文件夹下新建文件BlogPost.cshtml内容如下page /blogpost/{id} h1This is the blog post: Id/h1 functions { [FromRoute] public string Id { get; set; } }然后打开 URL/blogpost/1即可访问该页面。ℹ️访问路由值在路由中名为{id}的 URL 片段会自动赋值给Id属性并通过Id语法渲染。根据内容项标识加载博客文章Orchard Core 中每个内容项都有一个唯一且不可变的内容项标识符Content Item Identifier我们可以利用它在 Razor Page 中加载博客文章。编辑BlogPost.cshtmlpage /blogpost/{id} using OrchardCore inject IOrchardHelper Orchard { var blogPost await Orchard.GetContentItemByIdAsync(Id); } h1This is the blog post: blogPost.DisplayText/h1 functions { [FromRoute] public string Id { get; set; } }然后在 Content Items 页面点击刚创建的博客文章找到 URL 中/ContentItems/之后的部分那便是该内容项的内容项标识符例如截图中的4tavbc16br9mx2htvyggzvzmd3打开 URL/blogpost/[YOUR_ID]将[YOUR_ID]替换为你自己的内容项标识符页面应显示该博客文章的实际标题。从源码层面看GetContentItemByIdAsync是定义在 ContentOrchardHelperExtensions.cs 中的IOrchardHelper扩展方法它从HttpContext.RequestServices中解析出IContentManager并调用contentManager.GetAsync(contentItemId, option)加载内容项。其中可选的VersionOptions参数允许你加载特定版本如草稿、最新版本或已发布版本默认加载当前发布版本。ℹ️约定DisplayText是每个内容项都具备的通用属性ContentItemId、Author等属性同样通用。但每个内容类型还定义了各自独特的动态属性集合例如我们在内容建模阶段添加的 Markdown Body 部件。访问内容项的其他动态属性内容项的动态属性位于Content属性中它是一份 JSON 文档。在标题后追加一行调试代码... h1This is the blog post: blogPost.DisplayText/h1 Orchard.ConsoleLog(blogPost) ...重新打开带内容项标识符的博客页面按F12打开浏览器开发者工具的Console控制台即可看到该内容项的完整状态其中会显示当前内容项的全部属性包括包含所有已配置动态部件的Content属性。展开MarkdownBodyPart节点可以看到存放博客正文的Markdown字段。ConsoleLog是 OrchardRazorHelperExtensions.cs 中提供的调试辅助它生成一段scriptconsole.log(...)/script将对象序列化为 JSON 输出到浏览器控制台在生产环境下输出为null因此不会泄露内部数据。对于ContentItem序列化内容包括ContentItemId、ContentItemVersionId、ContentType、DisplayText、Latest、Published、ModifiedUtc、PublishedUtc、CreatedUtc、Owner、Author与Content。Liquid 模板中也有对应的ConsoleLogFilter实现见 ConsoleLogFilter.cs。接着直接在页面中输出 Markdown 正文... h1blogPost.DisplayText/h1 pblogPost.Content.MarkdownBodyPart.Markdown/p Orchard.ConsoleLog(blogPost) ...刷新页面即可看到 Markdown 原文。最后借助 Orchard Core 的 Markdown 服务将 Markdown 转换为 HTMLpawait Orchard.MarkdownToHtmlAsync((string) blogPost.Content.MarkdownBodyPart.Markdown)/pℹ️底层原理Markdown 渲染能力来自 OrchardCore.Markdown 模块其抽象接口 IMarkdownService.cs 仅暴露一个string ToHtml(string markdown)方法具体实现由 Markdown 模块按配置的编辑器/渲染器提供因此你无需关心底层转换细节。根据自定义 slug 加载博客文章虽然可以通过内容项标识符加载博客文章但这对用户并不友好更好的 SEO 优化是在 URL 中复用标题。在 Orchard Core CMS 中**Alias Part别名部件**允许为内容项提供一个自定义的友好文本标识。在管理端打开Design→Content Definition→Content Types→Blog Post。在页面底部点击Add Parts。勾选Alias并点击Save。将Alias移动到Title下方并保存。编辑博客文章此时会出现Alias文本框输入一些文本本示例使用new-day。接下来更新 Razor Page在 URL 与加载方式上都改用别名page /blogpost/{slug} using OrchardCore inject IOrchardHelper Orchard { var blogPost await Orchard.GetContentItemByHandleAsync($alias:{Slug}); } ... functions { [FromRoute] public string Slug { get; set; } }改动要点路由与局部属性都改用slug命名并换用GetContentItemByHandleAsync方法通过别名加载内容项。打开页面/blogpost/new-day应显示与之前完全相同的结果但 URL 更友好、更利于 SEO。ℹ️底层原理GetContentItemByHandleAsync同样定义在 ContentOrchardHelperExtensions.cs 中。它先调用GetContentItemIdByHandleAsync通过IContentHandleManager.GetContentItemIdAsync(handle)将alias:new-day这样的句柄handle解析为内容项标识符再调用contentManager.GetAsync(...)加载内容项。handle 前缀不止alias:例如还支持slug:myblog/my-blog-post这类基于路由路径的句柄。这样设计使内容加载与具体的标识符来源解耦方便扩展更多句柄类型。使用自定义模式自动生成 slugAlias Part提供了一些自定义设置可以自动生成别名。本例中我们希望它根据标题自动生成。为此Orchard Core 使用名为Liquid的模板语言配合一些自定义函数来操作内容项属性。Orchard 提供了通常适用的默认模式。编辑 Blog Post 的内容定义点击Alias部件旁的Edit。在Pattern模式文本框中查看预填的模式默认模式会动态提取内容项的DisplayText属性——在本例中即标题——并对其调用slugify过滤器将标题转换为可用于 slug 的值。编辑博客文章内容项。清空Alias文本框让系统按自定义模式自动生成别名。点击Publish (and continue)发布并继续。此时别名自动生成为this-is-a-new-day打开 URL/blogpost/this-is-a-new-day确认该路由对自动生成的别名同样有效。练习创建一个带Title的新博客文章验证别名会被自动生成并能通过其自定义 URL 正常展示。为 Blog Post 配置预览Preview功能Preview预览是对内容编辑者非常有用的功能。编辑博客文章时点击Preview按钮会打开一个新窗口实时展示当前编辑值的效果。编辑一篇已有博客文章点击Preview将新窗口并排摆放。在预览窗口可见时修改Title注意结果如何自动更新。CMS 不知道渲染内容项时该使用哪个 Razor Page因此会使用一个通用页面。不过与我们为别名提供模式的方式相同我们也可以提供一个模式指定在预览内容项时调用哪个特定页面编辑 Blog Post 的内容定义点击Add Parts勾选Preview点击Save。在部件列表中点击Preview旁的Edit为此内容类型修改其设置。在Pattern模式文本框中输入/blogpost/{{ ContentItem.Content.AliasPart.Alias }}——这与 Razor Page 中配置的路由生成方式一致即把内容项的 AliasPart.Alias 注入到路径中。点击Save然后在编辑某篇博客文章时打开预览。如文首截图所示预览现在会使用我们为 Blog Post 专门配置的路由编辑者可以获得与线上渲染完全一致的所见即所得体验。建议也可以为预览使用专门的模板例如在预览窗口中为编辑者提供提示、检测错误并渲染出来。编辑者还能调整窗口大小以在不同客户端尺寸下测试渲染效果。总结在本教程中我们学会了如何启动一个新的 Orchard Core CMS 项目通过dotnet new webapp或 Visual Studio .NET创建自定义内容类型Content Types并组合内容部件Content Parts编辑与发布内容项Content Items创建带自定义路由的 Razor Pages 来渲染内容使用内容项标识符与别名alias等不同标识加载内容项在编辑内容时渲染所见即所得WYSIWYG的预览界面整个流程的核心在于解耦式模型把内容创作交给 Orchard Core 管理后台把内容渲染完全交还给开发者。通过IOrchardHelper提供的GetContentItemByIdAsync、GetContentItemByHandleAsync、MarkdownToHtmlAsync等扩展方法源码见 ContentOrchardHelperExtensions.cs你可以用任何 ASP.NET Core 技术自由组织页面输出。若要进一步深入可在仓库中继续研读src/OrchardCore/OrchardCore.ContentManagement.Abstractions下的内容管理抽象以及src/OrchardCore/OrchardCore.Alias、src/OrchardCore/OrchardCore.Contents等模块的实现。官方还提供了配套的视频教程演示本文全部步骤的动态过程。赞分享CMS后端Web框架【免费下载链接】OrchardCoreOrchard Core is an open-source modular and multi-tenant application framework built with ASP.NET Core, and a content management system (CMS) built on top of that framework.项目地址https://gitcode.com/gh_mirrors/or/OrchardCore点击查看免费下载相关推荐ASP.NET Core Razor Pages 实战指南以页面为中心的服务端渲染应用构建与选型ASP.NET Core Razor Pages 实战指南以页面为中心的服务端渲染应用构建与选型 导读 Razor Pages 是 ASP.NET Core人工智能AI 技能AI 插件douyin-downloader 快速上手教程抖音批量下载、去水印与主页全量备份douyin downloader 快速上手教程抖音批量下载、去水印与主页全量备份 douyin downloader 是一个用 Python 编写的开源 抖CMS后端Web框架django CMS 前端实战为站点添加样式、渲染 CMS 菜单导航与页面布局django CMS 前端实战为站点添加样式、渲染 CMS 菜单导航与页面布局 导读 本文是 django CMS 官方教程系列的第 5 章对应 docs/CMS后端上一篇新手用 downkyi 做 B站视频下载5分钟装好批量存片与8K原画质都会了下一篇CityPicker 城市选择器接入指南Android 省市区联动一次搞定创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考