王菁资料,中法互译,郑成功小故事
2018.9.25 日深圳市友浩达科技有限公司发布基于orchard core开发的官网 。 本篇文章为你介绍如何基于orchard core开发一个公司网站。orchard core是一个免费和开源的社区交流项目，致力于在asp.net core平台开发应用程序和可重用性组件。它将创建用于asp.net core应用和扩展的共享组件，以及修改这些组件以便使其应用于终端用户，脚本人员和开发者。如果您现在是.net core 跨平台的爱好者，想找一个基于asp.net core开发的开源框架，orchard core是一个很不错的选择，orchard core是一个基于asp.net core构建的可扩展与模块化设计的开源cms系统，全部代码在github上已开源，其中使用了很多框架和最佳实战，它的架构设计值学习 。
官方文档介绍：
github: https://github.com/orchardcms/orchardcore
orchard core是全新一代的asp.net core cms。支持模块化和多租户。整个orchard core就是通过一个个模块module组成的，整个网站由主题和业务模块组成。基于orchard core开发网站主要分为2项任务：开发自定义主题和自定义模块。具体到友浩达的官方网站来说，我们需要自定义主题和自定义 微信公众号和新闻管理模块。
首先需要安装.net core sdk开发包，推荐微软最新的稳定的.net core 2.1 版本。同时推荐安装visual studio 15.8，如果安装了最新版本的visual studio 也就安装了最新的稳定版本.net core sdk。
打开vs2017 新建一个saasapp的asp.net core web应用程序，
然后选择空模板
选择诸如 .net 这种成熟的生态系统，其最大的优势之一，就是第三方软件包和插件的量非常庞大。正如其它的软件包系统一样，你可以下载并安装 .net 软件包，以获取协助，来完成几乎任何能想到的任务和难题。
nuget 即是包管理工具，也是官方的软件包仓库（ ）。你可以在网页上检索 nuget 软件包，并在自己的机器上使用终端（或者 visual studio 里的图形界面）安装它们
nuget包命令 目前预览版需加 -pre
install-package orchardcore.application.cms.targets -pre
或者在nuget搜索 orchardcore.application.cms.targets
打开startup.cs ,在configureservices加入
然后删除configure 中的
app.run(async (context) =>
{
await context.response.writeasync("hello world!");
});
加入
app. useorchardcore();
最终如下：
namespace saasapp
{
public class startup
{
// this method gets called by the runtime. use this method to add services to the container.
// for more information on how to configure your application, visit https://go.microsoft.com/fwlink/?linkid=398940
public void configureservices(iservicecollection services)
{
services.addscoped<iresourcemanifestprovider, resourcesbuilder.resourcemanifest>();
services.addorchardcms();
services.configure<identityoptions>(options =>
{
options.password.requiredigit = false;
options.password.requirelowercase = true;
options.password.requireuppercase = true;
options.password.requirenonalphanumeric = false;
options.password.requireduniquechars = 3;
options.password.requiredlength = 6;
});
}
// this method gets called by the runtime. use this method to configure the http request pipeline.
public void configure(iapplicationbuilder app, ihostingenvironment env)
{
if (env.isdevelopment())
{
app.usedeveloperexceptionpage();
}
app.useorchardcore();
}
}
这里要和大家说一下的resourcesbuilder.resourcemanifest，我们用我们bootstrap中文网的cdn资源替换了内置的google cdn资源，解决我们伟大的那堵墙所阻止的jquery库，如果不替换，进入到orchard core 的管理后台，你就会发现无法点开管理菜单。
然后运行程序，打开浏览会看到初始化安装界面。输入对应信息，然后完成安装。
注意密码必须包含大小写数字和字符才能成功提交。如上图中出现红色是不行的。安装好后配置一下，最终如下：
后台为/admin ，可以进入查看相关设置
我们将创建一个自定义模块来扩展orchard core。你需要一个已经安装了orchard core的web项目，上一章我们已经完成了这个工作。我们使用visual studio 2017打开项目。我们将添加一个新的.net core class library项目来包含我们的模块：
orchard core需要从web项目到每个模块或主题的引用。所以让我们继续现在添加引用，这样我们就不会忘记了。单击web项目上的“添加引用”，然后将web项目中的引用添加到新模块：
安装模块要求
一旦我们有了一个项目，我们就需要为项目添加一些东西，以便orchard core将其识别为一个模块。打开nuget包管理器，并安装 orchardcore.module.targets包。这个包包括（除其他外）我们需要能够添加扩展点的抽象。如果您要创建主题，请安装orchardcore.theme.targets
我们要添加的第一件事是我们的startup 类。这个类允许我们挂钩orchard core的启动管道; 这是我们做注册依赖项或路由等事情的地方。最基本的启动类看起来像这样：
using microsoft.extensions.dependencyinjection;
using orchardcore.modules;
namespace cvmdesktop
{
public class startup : startupbase
{
public override void configureservices(iservicecollection services)
{
}
}
}
再添加一个清单文件manifest.cs
每个模块和主题都需要有一个清单，它是一assembly：module 标签。清单存储orchard用于描述系统模块和主题的元数据，例如名称，版本，描述，作者和标签。下面是我们的清单样例：
using orchardcore.modules.manifest;
[assembly: module(
name = "cvmdesktop",
author = "weyhd",
website = "http://weyhd.com",
version = "0.0.1",
description = "cvm manage",
category = "infrastructure"
)]
此时，我们可以构建并运行。登录站点的管理面板，您将看到模块显示在“模块”页面中：
自定义模块添加admin菜单以及配置permission
1.在自定义模块项目中安装nuget包 orchardcore.environment.navigation
2.新建adminmenu.cs类
继承inavigationprovider并实现buildnavigation方法。
在builder中可设置多级菜单，在最后一级可以设置菜单请求路径以及权限。
3.新建permission.cs类
继承ipermissionprovider并实现getdefaultstereotypes以及getpermissions方法。
4.启动项目，进入后台启用模块
在左侧菜单即可看到新增的菜单
自定义模块中添加数据库curd操作
根据github上的issues#2248
1.新建index类引用yessql.indexes命名空间，继承mapindex类
此index包含实体中部分字段，亦可全部一致。
2.新建indexprovider类，继承indexprovider<t>
t表示数据操作实体类
3.重写describe方法
4.在map()中映射index类与实体类相关字段。
5.新建migrations类
继承datamigration，需要引用orchardcore.data.migration命名空间。需要安装nuget包orchardcore.data.abstractions。
6.添加create方法
注意名称必须是create，返回类型为int
在create方法中创建表
7.在想实现curd操作的地方注入yessql.isession，使用yessql中的isession进行相关curd操作即可
8.可使用imemorycache配合isession进行相关操作，如
如对本文有疑问，请在下面进行留言讨论，广大热心网友会与你互动！！ 点击进行留言回复
asp.net搭建博客，使用BlogEngine.NET+MySql搭建博客
我要评论
网友评论