细致引见ZKEACMS for .Net Core【C#.Net教程】,ZKEACMS,.Net,Core

ZKEACMS.Core 是基于 .Net Core MVC 开辟的开源CMS，这篇文章主要为人人深度剖析了ZKEACMS for .Net Core，具有肯定的参考价值，感兴趣的小伙伴们能够参考一下

ZKEACMS 简介
ZKEACMS.Core 是基于 .Net Core MVC 开辟的开源CMS。ZKEACMS能够让用户自在计划页面规划，运用可视化编辑设想“所见即所得”，直接在页面上举行拖放增加内容。

ZKEACMS运用插件式设想，模块星散，经由过程横向扩大来雄厚CMS的功用。

相应式设想

ZKEACMS运用Bootstrap3的栅格体系来完成相应式设想，从而完成在差别的装备上都能够一般接见。同时站在Bootstrap伟人的肩膀上，有雄厚的主题资本能够运用。

简朴演示

接下来看看顺序设想及道理

项目构造

EasyFrameWork　　底层框架
ZKEACMS　　　CMS中心
ZKEACMS.Article 　　文章插件
ZKEACMS.Product　　产物插件
ZKEACMS.SectionWidget　　模板组件插件
ZKEACMS.WebHost

道理 - 接见请求流程

路由在ZKEACMS内里起到了症结性的作用，经由过程路由的优先级来决议接见的流程走向，如果找到婚配的路由，则优先走该路由对应的 Controller -> Action -> View，如果没有婚配的路由，则走路由优先权最低的“全捕获”路由来处置惩罚用户的请求，末了返回相应。

优先级最低的“全捕获”路由是用来处置惩罚用户自行建立的页面的。当请求进来时，先去数据库中查找是不是存在该页面，不存在则返回404。找到页面以后，再找出这个页面一切的组件、内容，然后一致挪用各个组件的“Display"要领来来获得对应的“ViewModel"和视图"View"，末了根据页面的规划来显现。

ZKEACMS 请求流程图

驱动页面组件：

widgetService.GetAllByPage(filterContext.HttpContext.RequestServices, page).Each(widget =>
{
  if (widget != null)
  {
    IWidgetPartDriver partDriver = widget.CreateServiceInstance(filterContext.HttpContext.RequestServices);
    WidgetViewModelPart part = partDriver.Display(widget, filterContext);
    lock (layout.ZoneWidgets)
    {
      if (layout.ZoneWidgets.ContainsKey(part.Widget.ZoneID))
      {
        layout.ZoneWidgets[part.Widget.ZoneID].TryAdd(part);
      }
      else
      {
        layout.ZoneWidgets.Add(part.Widget.ZoneID, new WidgetCollection { part });
      }
    }
    partDriver.Dispose();
  }
});

页面显现：

foreach (var widgetPart in Model.ZoneWidgets[zoneId].OrderBy(m => m.Widget.Position).ThenBy(m => m.Widget.WidgetName))
{
  <p style="@widgetPart.Widget.CustomStyle">
    <p class="widget @widgetPart.Widget.CustomClass">
      @if (widgetPart.Widget.Title.IsNotNullAndWhiteSpace())
      {
        <p class="panel panel-default">
          <p class="panel-heading">
            @widgetPart.Widget.Title
          </p>
          <p class="panel-body">
            @Html.DisPlayWidget(widgetPart)
          </p>
        </p>
      }
      else
      {
        @Html.DisPlayWidget(widgetPart)
      }
    </p>
  </p>
}

插件“最症结”的类 PluginBase

每一个插件/模块都必须要一个类继续PluginBase，作为插件初始化的进口，顺序在启动的时刻，会加载这些类并作一些症结的初始化事情。

public abstract class PluginBase : ResourceManager, IRouteRegister, IPluginStartup
{
  public abstract IEnumerable<RouteDescriptor> RegistRoute(); //注册该插件所须要的路由 可返回空
  public abstract IEnumerable<AdminMenu> AdminMenu(); //插件在后端供应的菜单 可返回空
  public abstract IEnumerable<PermissionDescriptor> RegistPermission(); //注册插件的权限
  public abstract IEnumerable<Type> WidgetServiceTypes(); //返回该插件中供应的一切组件的范例
  public abstract void ConfigureServices(IServiceCollection serviceCollection); //IOC 注册对应的接口与完成
  public virtual void InitPlug(); //初始化插件，在顺序启动时挪用该要领
}

细致完成能够参考“文章”插件 ArticlePlug.cs 或许“产物”插件 ProductPlug.cs

加载插件 Startup.cs

public void ConfigureServices(IServiceCollection services)
{
  services.UseEasyFrameWork(Configuration).LoadEnablePlugins(plugin =>
  {
    var cmsPlugin = plugin as PluginBase;
    if (cmsPlugin != null)
    {
      cmsPlugin.InitPlug();
    }
  }, null);      
}

组件组成

一个页面，由许多的组件组成，每一个组件都能够包括差别的内容（Content），像笔墨，图片，视频等，内容由组件决议，显现体式格局由组件的模板(View)决议。

关联与显现体式格局大抵如下图所示：

实体 Enity

每一个组件都邑对应一个实体，用于存储与该组件相干的一些信息。实体必须继续于 BasicWidget 类。

比方HTML组件的实体类：

[ViewConfigure(typeof(HtmlWidgetMetaData)), Table("HtmlWidget")]
public class HtmlWidget : BasicWidget
{
  public string HTML { get; set; }
}
class HtmlWidgetMetaData : WidgetMetaData<HtmlWidget>
{
  protected override void ViewConfigure()
  {
    base.ViewConfigure();
    ViewConfig(m => m.HTML).AsTextArea().AddClass("html").Order(NextOrder());
  }
}

实体类内里运用到了元数据设置[ViewConfigure(typeof(HtmlWidgetMetaData))]，经由过程简朴的设置来掌握表单页面、列表页面的显现。如果设置为文本或下拉框；必填，长度等的考证。

这里完成体式格局是向MVC内里增加一个新的ModelMetadataDetailsProviderProvider，这个Provider的作用就是抓取这些元数据的设置信息并提交给MVC。

services.AddMvc(option =>
  {
    option.ModelMetadataDetailsProviders.Add(new DataAnnotationsMetadataProvider());
  })

效劳 Service

WidgetService 是数据与模板的桥梁，经由过程Service抓取数据并送给页面模板。 Service 必须继续自 WidgetService<WidgetBase, CMSDbContext>。如果营业庞杂，则重写(override)基类的对应要领来完成。

比方HTML组件的Service：

public class HtmlWidgetService : WidgetService<HtmlWidget, CMSDbContext>
{
  public HtmlWidgetService(IWidgetBasePartService widgetService, IApplicationContext applicationContext)
    : base(widgetService, applicationContext)
  {
  }
 
  public override DbSet<HtmlWidget> CurrentDbSet
  {
    get
    {
      return DbContext.HtmlWidget;
    }
  }
}

视图实体 ViewModel

ViewModel 不是必须的，当实体（Entity）作为ViewModel传到视图不足以满足请求时，能够新建一个ViewModel，并将这个ViewModel传过去，这将请求重写 Display 要领

public override WidgetViewModelPart Display(WidgetBase widget, ActionContext actionContext)
{
  //do some thing
  return widget.ToWidgetViewModelPart(new ViewModel());
}

视图 / 模板 Widget.cshtml

模板 (Template) 用于显现内容。经由过程了Service网络到了模板所要的“Model”，末了模板把它们显现出来。

动态编译疏散的模板

插件的资本都在各自的文件夹下面，默许的视图引擎（ViewEngine）并不能找到这些视图并举行编译。MVC4版本的ZKEACMS是经由过程重写了ViewEngine来得以完成。.net core mvc 能够更轻易完成了，完成本身的 ConfigureOptions<RazorViewEngineOptions> ，然后经由过程依靠注入就行。

public class PluginRazorViewEngineOptionsSetup : ConfigureOptions<RazorViewEngineOptions>
{
  public PluginRazorViewEngineOptionsSetup(IHostingEnvironment hostingEnvironment, IPluginLoader loader) :
    base(options => ConfigureRazor(options, hostingEnvironment, loader))
  {
 
  }
  private static void ConfigureRazor(RazorViewEngineOptions options, IHostingEnvironment hostingEnvironment, IPluginLoader loader)
  {
    if (hostingEnvironment.IsDevelopment())
    {
      options.FileProviders.Add(new DeveloperViewFileProvider());
    }
    loader.GetPluginAssemblies().Each(assembly =>
    {
      var reference = MetadataReference.CreateFromFile(assembly.Location);
      options.AdditionalCompilationReferences.Add(reference);        
    });
    loader.GetPlugins().Where(m => m.Enable && m.ID.IsNotNullAndWhiteSpace()).Each(m =>
    {
      var directory = new DirectoryInfo(m.RelativePath);
      if (hostingEnvironment.IsDevelopment())
      {
        options.ViewLocationFormats.Add($"/Porject.RootPath/{directory.Name}" + "/Views/{1}/{0}" + RazorViewEngine.ViewExtension);
        options.ViewLocationFormats.Add($"/Porject.RootPath/{directory.Name}" + "/Views/Shared/{0}" + RazorViewEngine.ViewExtension);
        options.ViewLocationFormats.Add($"/Porject.RootPath/{directory.Name}" + "/Views/{0}" + RazorViewEngine.ViewExtension);
      }
      else
      {
        options.ViewLocationFormats.Add($"/{Loader.PluginFolder}/{directory.Name}" + "/Views/{1}/{0}" + RazorViewEngine.ViewExtension);
        options.ViewLocationFormats.Add($"/{Loader.PluginFolder}/{directory.Name}" + "/Views/Shared/{0}" + RazorViewEngine.ViewExtension);
        options.ViewLocationFormats.Add($"/{Loader.PluginFolder}/{directory.Name}" + "/Views/{0}" + RazorViewEngine.ViewExtension);
      }
    });
    options.ViewLocationFormats.Add("/Views/{0}" + RazorViewEngine.ViewExtension);
  }
}

看上面代码您可能会发生迷惑，为何要分开辟环境。这是由于ZKEACMS宣布和开辟的时刻的文件夹目次构造差别形成的。为了轻易开辟，所以到场了开辟环境的迥殊处置惩罚。接下来就是注入这个设置：

services.TryAddEnumerable(ServiceDescriptor.Transient<IConfigureOptions<RazorViewEngineOptions>, PluginRazorViewEngineOptionsSetup>()); 　　

EntityFrameWork

ZKEACMS for .net core 运用EntityFrameWork作为数据库接见。数据库相干设置 EntityFrameWorkConfigure

public class EntityFrameWorkConfigure : IOnConfiguring
{
  public void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
  {
    optionsBuilder.UseSqlServer(Easy.Builder.Configuration.GetSection("ConnectionStrings")["DefaultConnection"]);
  }
}

对Entity的设置依旧能够直接写在对应的类或属性上。如果想运用 Entity Framework Fluent API，那末请建立一个类，并继续自 IOnModelCreating

class EntityFrameWorkModelCreating : IOnModelCreating
{
  public void OnModelCreating(ModelBuilder modelBuilder)
  {
    modelBuilder.Entity<LayoutHtml>().Ignore(m => m.Description).Ignore(m => m.Status).Ignore(m => m.Title);
  }
}

主题

ZKEACMS 运用Bootstrap3作为基础，运用LESS，定议了许多的变量，像边距，色彩，背景等等，能够经由过程简朴的修正变量就可以“编译”出一个本身的主题。

或许也能够直接运用已有的Bootstrap3的主题作为基础，然后疾速建立主题。

末了

关于ZKEACMS另有许多，如果您也感兴趣，迎接到场我们。

ZKEACMS for .net core 就是要让建网站变得更简朴，疾速。页面的修正与改版也变得更轻松，便利。

【相干引荐】

1. .Net Core 之图形考证码

2. .NET Core设置文件加载与DI注入设置数据

3. .NET Core CLI东西文档dotnet-publish

4. 分享.net MVC中运用forms考证实例代码

5. 在.net core 下怎样举行http请求？

6. CentOS上运转ZKEACMS的实例教程

以上就是细致引见ZKEACMS for .Net Core的细致内容，更多请关注ki4网别的相干文章！

正文

细致引见ZKEACMS for .Net Core【C#.Net教程】,ZKEACMS,.Net,Core

相关阅读

关于验证码生成要领的汇总引见【C#.Net教程】,

c言语“或”标记【C#.Net教程】,c语言,或符号

.net和c#有什么区别【C#.Net教程】,.net,c#

伪代码是什么？如何写一个伪代码？【C#.Net教程】,伪代码,c语言,算法