前言：踏入十二月，人生也即将进入下一个阶段。
最近忙于其他，代码也是偶尔更新。目前算是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