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

时间:2021-06-05 17:42:48

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

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

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

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

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

讨论Q群:1600800

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

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

话不多说,先看整体的效果吧:

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

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

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")]

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

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

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

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

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

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

也欢迎大家点个star。

最后再次提醒,讨论Q群:1600800