# OC-Customization-Learning

**Repository Path**: smartent/OC-Customization-Learning

## Basic Information

- **Project Name**: OC-Customization-Learning
- **Description**: 这个仓库主要是专门针对OC的主题跟功能的定制
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://www.smartent.cn
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-26
- **Last Updated**: 2026-10-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Lombiq 开源 Orchard Core 扩展集（Readme 译文与功能概览）

## 简介

这是 **Lombiq** 公司几乎所有 **开源 Orchard Core 模块与主题** 的合集解决方案（Visual Studio / .NET 解决方案）。克隆后即可试用。

- 基于 [Orchard Core](https://orchardcore.net/)，同时演示 **通过 NuGet 引用 Orchard** 的 ASP.NET Core 网站写法。
- 只收录依赖 **已发布版 Orchard** 的扩展；依赖 nightly 的前沿扩展不在此仓。
- Orchard 1.x 有对应项目：[Lombiq's Open-Source Orchard Extensions](https://github.com/Lombiq/Open-Source-Orchard-Extensions)。

---

## 环境与起步

| 要求 | 说明 |
|------|------|
| **Node.js** | 多个项目需编译前端资源，见 [Lombiq Node.js Extensions](https://github.com/Lombiq/NodeJs-Extensions/#prerequisites) |
| **PowerShell 7** | 开发与脚本分析用 PS7，不要用 Windows PowerShell 5.x |
| **Git 子模块** | 扩展以 submodule 引入；克隆时用 `--recurse-submodules`，或之后执行 `git submodule update --init --recursive` |

---

## 包含的项目（按类别）

### 库（Libraries）

| 项目 | 功能 |
|------|------|
| **Lombiq.HelpfulLibraries** | Orchard 开发常用工具库 |
| **Lombiq.HelpfulLibraries.Cli** | 命令行调用辅助 |
| **Lombiq.HelpfulLibraries.LinqToDb** | 用 LINQ 通过 YesSql `ISession` 查库，少写裸 SQL |
| **Lombiq.HelpfulLibraries.Refit** | Refit HTTP 客户端辅助 |
| **Lombiq.HelpfulLibraries.RestEase** | RestEase 类型化 HTTP 客户端注册 |
| **Lombiq.HelpfulLibraries.SourceGenerators** | 源码生成器集合 |
| **Lombiq.OrchardCoreApiClient** | Orchard Core Web API 客户端（租户、内容管理等）+ 控制台示例 |

### 模块（Modules）

| 项目 | 功能 |
|------|------|
| **Lombiq.AuditTrailExtensions** | 审计轨迹（Audit Trail）增强 |
| **Lombiq.ChartJs** | Chart.js 图表展示 |
| **Lombiq.ContentEditors** | 自定义多页编辑器，异步加载/保存 |
| **Lombiq.ContentEditors.Samples** | Content Editors 示例模块 |
| **Lombiq.DataTables** | DataTables 表格，自定义数据源 |
| **Lombiq.DataTables.Samples** | DataTables 示例 |
| **Lombiq.EmailClient** | IMAP 收信（后台任务或按需） |
| **Lombiq.HelpfulExtensions** | 实用扩展（内容类型、小组件等）；DotNest SaaS 也用 |
| **Lombiq.HelpfulLibraries.Samples** | Helpful Libraries 示例 |
| **Lombiq.Hosting.Azure.ApplicationInsights** | Azure Application Insights 遥测集成 |
| **Lombiq.Hosting.BuildVersionDisplay** | 在 Default 租户后台显示构建/程序集版本 |
| **Lombiq.Hosting.MediaTheme.Bridge** | 从媒体库托管主题资源与模板（配合 MediaTheme） |
| **Lombiq.Hosting.Tenants.Admin.Login** | 从 Default 后台一键登录到其他租户管理员 |
| **Lombiq.Hosting.Tenants.EnvironmentRobots** | 控制站点不被搜索引擎收录 |
| **Lombiq.Hosting.Tenants.FeaturesGuard** | 按条件启用/保持/禁止租户上的功能集 |
| **Lombiq.Hosting.Tenants.IdleTenantManagement** | 空闲超时后关闭租户 Shell，释放资源 |
| **Lombiq.Hosting.Tenants.Maintenance** | 租户维护任务 |
| **Lombiq.Hosting.Tenants.Management** | 限制创建租户、在租户编辑器里配置 Shell 设置 |
| **Lombiq.JsonEditor** | 类似 jsoneditoronline 的 JSON 编辑器 |
| **Lombiq.LoginAsAnybody** | 管理员在后台「以任意用户身份登录」 |
| **Lombiq.OSOCE.Samples** | UI 测试与演示内容的占位/示例模块 |
| **Lombiq.Privacy** | GDPR 相关隐私与同意功能（**不能单靠此模块合规**） |
| **Lombiq.TrainingDemo** | Orchard 培训演示模块（对应 Dojo Course 3 等） |
| **Lombiq.UIKit** | 可复用 Shape（文本框、自定义 checkbox、下拉等）+ 基于 UI Kit 的小组件 |
| **Lombiq.VueJs** | 集成 Vue.js，组件可作 Orchard Shape 被主题/模块覆盖 |
| **Lombiq.Walkthroughs** | 站内交互式引导教程（工具提示） |

### 主题（Themes）

| 项目 | 功能 |
|------|------|
| **Lombiq.BaseTheme** | Bootstrap 5 主题基础设施、标准 Zone、前台菜单 |
| **Lombiq.BaseTheme.Samples** | BaseTheme 示例主题 |
| **Lombiq.Hosting.MediaTheme** | 媒体库托管主题（与 Bridge 配合） |
| **Lombiq.Hosting.MediaTheme.Tests.Theme** | Media Theme 本地开发测试用主题 |

### 工具类项目（Utilities）

| 项目 | 功能 |
|------|------|
| **Lombiq.Hosting.MediaTheme.Targets** | 构建时自动生成 Media Theme 包 |
| **Lombiq.NodeJs.Extensions** | MSBuild 集成的 SCSS/JS/MD 等前端流水线（npm） |
| **Lombiq.Npm.Targets** | 构建前自动 `npm install` 与自定义 npm 命令 |
| **Lombiq.SetupExtensions** | Orchard Core 安装/Setup 扩展 |

### 测试（Testing）

| 项目 | 功能 |
|------|------|
| **Lombiq.Tests** | 单元/集成测试辅助（ASP.NET Core、Orchard） |
| **Lombiq.Tests.UI** | Selenium UI 测试工具箱 |
| **Lombiq.Tests.UI.AppExtensions** | 被测 Web 应用的 UI 测试配置扩展 |
| **Lombiq.Tests.UI.Samples** | UI 测试示例与文档 |
| **Lombiq.Tests.UI.Shortcuts** | 快捷 API：开关功能、登录等，避免测试里走完整 UI 流程 |

### 工具（Tools）

| 项目 | 功能 |
|------|------|
| **Lombiq.Analyzers** | .NET 代码分析与规范 |
| **Lombiq.Analyzers.PowerShell** | PSScriptAnalyzer + Lombiq 配置 |
| **Lombiq.GitHub.Actions** | 共享 CI：构建测试、发 NuGet、子模块 PR 校验等 |

---

## 示例与配方（Recipes）

在后台可启用各类演示内容：

- **JsonEditor**：配方「JSON Editor Sample」→ 示例页面与字段配置  
- **UITestingToolbox**：见子项目 Samples Readme  
- **TrainingDemo**：首次建站选 **Training Demo** 配方  
- **DataTables**：启用 Samples 功能 + 配方「Employee」  
- **BaseTheme**：「TEST: Basic Orchard Features」或 Layers/Zones 配方；开发可用 Styling Demo 主题  
- **ChartJs**：配方「Income/Expense」  
- **Privacy**：配方「Privacy, Forms, Workflows」  
- **MediaTheme**：配方「Media Theme - Samples」  

---

## 其他说明（文档后半部分）

- **贡献**：Issue/PR 欢迎；商业支持由 Lombiq 提供。  
- **新扩展规范**：用户向功能要有 Recipe/示例项目、单元测试、可选前台菜单、UI 测试、NuGet 方案同步、更新本 Readme 列表等。  
- **PR**：子模块 PR 需对应超项目 PR；破坏性 API 变更需包验证与 `CompatibilitySuppressions.xml`。  
- **版本策略**：库项目倾向 **.NET LTS**；共享 NuGet 包倾向 Orchard **x.0.0** 主版本；根 Web 项目用 **最新 Orchard 补丁版**。  
- **依赖**：跨 Lombiq 项目要 **ProjectReference + 条件 PackageReference**；根 `Directory.Build.props` 的 `NuGetBuild` 可整仓切到 NuGet 引用。

---

## 一句话总结「有哪些功能」

这个仓库不是单一产品，而是 **Lombiq 的 Orchard Core 生态大礼包**：开发库（LINQ/Refit/API 客户端）、后台与前台增强（表格、图表、JSON 编辑器、Vue、UI Kit、隐私/GDPR）、**多租户托管**（登录跳转、功能守卫、空闲关闭、维护、robots）、**媒体库主题**、**培训与引导**（TrainingDemo、Walkthroughs）、**测试与 CI 工具链**，外加 BaseTheme 等主题基础设施。主站 `Lombiq.OSOCE.Web` 把它们聚在一起；另有 **NuGetTest** 方案验证「只靠 NuGet 包」能否跑通（与你改的 `Smartent-Themes-Modules-Custom` 思路类似）。

若需要，我可以把这份译文保存为同目录下的 `Readme.zh-CN.md`。