COMCMS v0.9 版本发布，带前后端的一个响应式企业站

前言：踏入十二月，人生也即将进入下一个阶段。

最近忙于其他，代码也是偶尔更新。目前算是0.9的版本，就是基本上可以完成一个简单的企业站/博客的功能。

主要特点：前台完整演示：文章、产品、留言。界面响应式：响应PC和手机

预计：1.0版本的话，带有app端（预计只有安卓版本，苹果版本没有证书-_-'）演示，也算是可以应用于app、小程序（微信小程序、支付宝、百度小程序）。当然只是预告而已ORZ

github地址：https://github.com/hogenwang/comcms_core

讨论Q群：1600800

本次最重要的是，加上前台的完整前端。一方面，让整个小cms系统更加完整。另外一方面，也是演示了，如何搭配前端view进行开发。还有就是XCode如是使用。

之前有人提到，希望有多一点的二次开发文档。这个我尽量抽时间写写，其实主要还是XCode的用法。

话不多说，先看整体的效果吧：

以下就简单说一下，前台的一些特点和二次开发注意的内容：

1、前台控制器继承：HomeBaseController 主要是：

提供了后台配置，和前后端交互的json基础类JsonTip

所有需要展示网站完整页面的需要加入：

ViewBag.cfg = cfg;

2、ServerController 为数据交互提交方法，可以将所有需要交互的数据，方法都写在本控制器，当然，你也可以写在其他的。

而一般，提交的方法，都使用POST外加：AutoValidateAntiforgeryToken 保证数据提交的安全，最后，统一都返回一个json：

    /// <summary>
    /// 系统JSON提示实体类
    /// </summary>
    [Serializable]
    public class JsonTip
    {
        public JsonTip() { }
        /// <summary>
        /// 成功状态
        /// </summary>
        public static readonly string SUCCESS = "success";
        /// <summary>
        /// 失败状态
        /// </summary>
        public static readonly string ERROR = "error";
        /// <summary>
        /// 请求返回状态 默认 error（错误）;成功：success
        /// </summary>
        public string Status { get; set; } = ERROR;
        /// <summary>
        /// 提示信息
        /// </summary>
        public string Message { get; set; }
        /// <summary>
        /// 其他信息
        /// </summary>
        public string Other { get; set; }
        /// <summary>
        /// Id 可选
        /// </summary>
        public int Id { get; set; } = ;
        /// <summary>
        /// 返回URL
        /// </summary>
        public string ReturnUrl { get; set; }

        /// <summary>
        /// 获取JSON字符串
        /// </summary>
        /// <param name="json">JsonTip实体类</param>
        /// <returns></returns>
        public static string GetJsonString(JsonTip json)
        {
            if (json != null)
                return JsonConvert.SerializeObject(json);
            else
                return string.Empty;
        }
    }

如演示里面的提交留言：

#region 提交前台底部留言
        [HttpPost]
        [AutoValidateAntiforgeryToken]
        public IActionResult DoPostMessage(string name,string phone,string content)
        {
            if (string.IsNullOrWhiteSpace(name))
            {
                tip.Message = "请填写您的姓名！";
                return Json(tip);
            }
            if (!Utils.IsTel(phone))
            {
                tip.Message = "请填写正确的手机号码！";
                return Json(tip);
            }
            if (string.IsNullOrWhiteSpace(content))
            {
                tip.Message = "请填写您的留言内容！";
                return Json(tip);
            }

            Guestbook entity = new Guestbook()
            {
                AddTime = DateTime.Now,
                IP = Utils.GetIP(),
                KId = ,
                Nickname = name,
                Content = Utils.NoHTML(content),
                Tel = phone
            };
            entity.Insert();

            tip.Message = "留言成功，感谢您的留言！";
            tip.Status = JsonTip.SUCCESS;
            return Json(tip);
        }
        #endregion

可以看到，涉及到XCode的用法也是非常简单的，new一个对象后，最后调用Insert();就可以插入数据了。值得一提的是，如果插入这个数据后，想获取主键Id的值：entity.Id就可以了。不要用Insert() 返回值。

3、为了方便演示，我大部分获取数据都写在views里面，建议还是写在Controller里面。如首页模板

    IList<Link> listLinks = Link.FindAll(Link._.KId == , Link._.Sequence.Asc(), null, , );

    //处理bannr广告
    var bannerPC = Ads.GetSlideAds();
    var bannerMobile = Ads.GetSlideAds();

4、后台文章，可以配置相应的模板，可以根据不同情况配置不同模板。如演示，关于我们、联系我们和新闻中心模板就不一样。

因为编译了模板，所以选择模板使用反射实现：

            //获取模板 模板规则，以Index_开头的，为栏目列表，以Detial_开头的为文章详情
            List<string> listTpls = new List<string>();
            var asms = AppDomain.CurrentDomain.GetAssemblies();
            foreach (var asmItem in asms)
            {
                var types = asmItem.GetTypes().Where(e => e.Name.StartsWith("Views_Article")).ToList();
                if (types.Count == ) continue;
                foreach (var type in types)
                {
                    string viewName = type.Name.Replace("Views_Article_", "") + ".cshtml";
                    listTpls.Add(viewName);
                }
            }
            ViewBag.ListTpl = listTpls;

注意看注释部分内容哦。

5、列表分页的，这里我使用了手动计算分页的形式：

                IList<Article> list = new List<Article>();
                int numPerPage, currentPage, startRowIndex;
                numPerPage = model.PageSize;
                if (page > 0)
                    currentPage = page;
                else
                    currentPage = 1;

                startRowIndex = (currentPage - 1) * numPerPage;

                var ex = Article._.IsHide != 1 & Article._.IsDel != 1;

                //如果显示下级栏目文章
                if (model.IsShowSubDetail == 1)
                {
                    //获取下级所有栏目
                    List<int> allsubkids = new List<int>();
                    allsubkids.Add(model.Id);

                    IList<ArticleCategory> allkind = ArticleCategory.FindAllSubKinds(model.Id);
                    if (allkind != null && allkind.Count > 0)
                    {
                        foreach (var s in allkind)
                        {
                            allsubkids.Add(s.Id);
                        }
                    }
                    ex &= Article._.KId.In(allsubkids);
                }
                else
                    ex &= Article._.KId == model.Id;
                long totalCount = Article.FindCount(ex, Article._.Sequence.Asc().And(Article._.Id.Desc()), null, startRowIndex, numPerPage);
                int pageCount = (int)totalCount / numPerPage;//总页数
                if (totalCount % numPerPage > 0)
                {
                    pageCount += 1;
                }
                list = Article.FindAll(ex, Article._.Sequence.Asc().And(Article._.Id.Desc()), null, startRowIndex, numPerPage);
                ViewBag.list = list;//列表
                //分页信息
                ViewBag.totalCount = totalCount;
                ViewBag.pageCount = pageCount;
                ViewBag.page = page;
                ViewBag.pagesize = numPerPage;

　　而views里面调用分页代码：

@Html.Raw(Pages.GetPageStr(ViewBag.pagesize, (int)ViewBag.totalCount, ViewBag.page, $"/Article/Index/{Model.Id}" + "?page={0}", , , ""))

6、后台权限使用方法

由于上面提到统一执行post返回一个标准的json。所以后台权限，目前设计验证两种，一种是普通的验证，错误返回提示页面，另外一种是提交验证，错误返回一个json。也就是POST提交的时候。

用法也是很简单，给方法名加上：

[MyAuthorize( "viewlist",  "articlecategory")]

[MyAuthorize( "add",  "articlecategory", "JSON")]

其中第一个参数为事件权限，在后台：后台权限》事件权限管理管理

第二个参数为页面的key。这个在后台栏目权限管理中设置：

这样，在二次开发中，就可以很快速的添加功能和权限控制了。

其他方面暂不一一列出。如果有什么不明白的，可以给我留言。

也欢迎大家点个star。

最后再次提醒，讨论Q群：1600800