zb-blog模板使用手册

公共组件说明

本系统中提供的公共组件在ModuleService类中,
使用方式需要对thymeleaf有一定了解:${@module.get('categoryList')},参数是模块名。
如过看完此文档还不太会用,加q群130512958 QQ群130512958

模板文件位置

1.以zblog模板为例,你会发现所以模板名,都在theme文件夹下,将模板名例如”zblog“,在theme文件下新建zblog文件夹,在其下放置模板页面index.html,article.html等。

系统公共组件

  1. categoryList 分类,即文章所属大类,菜单
    示例:
    <li th:each="category:${@module.get('categoryList')}" th:class="${category.id==categoryId ? 'active':''}">
     <a th:href="@{${'/blog/category/' + category.id}}" th:text="${category.name}">
     </a>
    </li>
    
  2. tagList 标签,系统所有标签。
    <li th:each="item:${@module.get('tagList')}" class="tag-li">
     <a class="btn btn-default btn-xs" th:href="@{${'/blog/tag/'+item.id}}" th:text="${item.name}"></a>
    </li>
    
  3. sliderList 轮播文章
    ps:所有文章相关的列表都是文章list,里面可以获取到的属性都是BizArticle类中的属性。后面的文章集合就不一一举例了。
    <div class="swiper-container mb-20" th:if="${not #lists.isEmpty(sliderList)}">
     <div class="swiper-wrapper">
         <div th:each="item:${sliderList}" class="swiper-slide">
             <a th:href="@{${'/blog/article/'+item.id}}">
                 <img th:src="${item.sliderImg}">
                 <p class="slider-title" th:text="${item.title}"></p>
             </a>
         </div>
     </div>
     <!-- Add Pagination -->
     <div class="swiper-pagination"></div>
     <!-- Add Arrows -->
     <div class="swiper-button-prev"><i class="fa fa-chevron-circle-left"></i></div>
     <div class="swiper-button-next"><i class="fa fa-chevron-circle-right"></i></div>
    </div>
    
  4. recentList 最新文章
  5. recommendedList 推荐文章
  6. hotList 热门文章
  7. randomList 随机文章
  8. linkList 友链
    使用方式
    <li th:each="item:${@module.get('linkList')}"> 
     <a th:href="${item.url}" th:text="${item.name}" target="_blank"></a>
    </li>
    
  9. siteInfo 网站信息统计
    使用方式
    <li> <i class="fa fa-file fa-fw"></i> 文章总数:<span th:text="${@module.get('siteInfo').articleCount}"></span></li>
    <li> <i class="fa fa-tags fa-fw"></i> 标签总数:<span th:text="${@module.get('siteInfo').tagCount}"></span></li>
    <li> <i class="fa fa-folder-open fa-fw"></i> 分类总数:<span th:text="${@module.get('siteInfo').categoryCount}"></span></li>
    <li> <i class="fa fa-comments fa-fw"></i> 留言数量:<span th:text="${@module.get('siteInfo').commentCount}"></span></li>
    
  10. sysConfig 网站基础信息
    使用方式
    站长图片<div class="avatar"> <img th:src="${@module.get('sysConfig').SIT_PERSON_PIC}" alt=""></div>
    站长名称<p th:text="${@module.get('sysConfig').SITE_PERSON_NAME}" class="abname"></p>
    站长简介<p th:text="${@module.get('sysConfig').SITE_PERSON_DESC}" class="abtext"></p>
    网站标题<div class="avatar"> <img th:src="${@module.get('sysConfig').SIT_PERSON_NAME}" alt=""></div>
    网站keywords<p th:text="${@module.get('sysConfig').SITE_KWD}" class="abname"></p>
    网站description<p th:text="${@module.get('sysConfig').SITE_DESC}" class="abtext"></p>
    

系统api使用说明

  1. blog/api/comments 评论列表

    请求方式:post
    参数:

     sid:-1为留言板,其他值为文章id
     pageNumber:页码
     pageSize:分页数量(不传则默认10)
     status:1-审核通过, 0-待审核   
    
  2. blog/api/comment/save 保存评论
    请求方式:post
    参数:BizComment对象
     sid:-1为留言板,其他值为文章id
     pid:父级评论id
     nickname:昵称
     qq:qq号
     email:邮箱
     content:评论内容
    
  3. blog/api/article/look 查看文章时浏览次数+1
    请求方式:post
    参数:
     articleId:文章id
    
  4. blog/api/love 点赞
    请求方式:post
    参数:
     bizId:文章id or 评论id
     bizType:1-文章,2-评论