Liferay 7 GA5：Web Content模板获取全量博客数据报错咨询

我刚好在Liferay 7.x里做过类似的需求，你之前的代码报错是因为Web Content模板默认不会自动提供entries变量，得通过Liferay的服务API手动获取博客条目。下面给你一步步的解决方案，包含获取博客封面图、标题、短描述和链接的完整代码：

核心思路 #

Liferay的博客本质是BlogsEntry实体，我们可以通过BlogsEntryLocalService这个本地服务来获取当前站点下的所有博客，然后在FreeMarker模板里遍历展示。

完整FreeMarker代码示例 #

<#-- 1. 获取BlogsEntry本地服务实例 -->
<#assign blogsEntryLocalService = serviceLocator.findService("com.liferay.blogs.service.BlogsEntryLocalService")>

<#-- 2. 获取当前站点的groupId（确保只获取当前站点的博客） -->
<#assign groupId = themeDisplay.getScopeGroupId()>

<#-- 3. 获取当前站点下所有博客，按创建时间倒序排列（最新的在前） -->
<#-- 参数说明：groupId, 起始索引, 结束索引(-1表示所有), 排序器 -->
<#assign entries = blogsEntryLocalService.getGroupEntries(
    groupId, 
    0, 
    -1, 
    com.liferay.portal.kernel.util.OrderByComparatorFactoryUtil.create(
        "BlogsEntry", 
        "createDate", 
        false
    )
)>

<#-- 4. 遍历并展示博客内容 -->
<#if entries?has_content>
  <div class="footer-blog-list">
    <#list entries as blogEntry>
      <div class="footer-blog-item">
        <!-- 展示博客封面图 -->
        <#if blogEntry.getImageId() > 0>
          <img 
            src="${themeDisplay.getPathImage()}/blogs?img_id=${blogEntry.getImageId()}" 
            alt="${blogEntry.getTitle()}"
            class="footer-blog-image"
          >
        </#if>

        <!-- 博客标题 -->
        <h5 class="footer-blog-title">${blogEntry.getTitle()}</h5>

        <!-- 博客短描述 -->
        <p class="footer-blog-desc">${blogEntry.getDescription()}</p>

        <!-- 博客跳转链接 -->
        <a 
          href="${blogEntry.getURL(themeDisplay)}" 
          class="footer-blog-link"
          target="_blank"
        >
          查看详情
        </a>
      </div>
    </#list>
  </div>
<#else>
  <p class="no-blog-tip">当前站点暂无博客内容</p>
</#if>

代码细节解释 #

• serviceLocator：Liferay模板内置的工具，用来获取系统的本地服务，这里我们拿到BlogsEntryLocalService来操作博客数据。
• themeDisplay：也是模板内置对象，用来获取当前站点、用户、上下文路径等信息，getScopeGroupId()确保我们只拉取当前站点的博客，不会跨站点。
• 排序器：用OrderByComparatorFactoryUtil创建排序规则，这里是按createDate倒序，你也可以改成modifiedDate或者title排序。
• 封面图处理：通过getImageId()判断是否有上传封面图，有则生成对应的图片URL；如果没有就跳过图片展示。
• 博客链接：getURL(themeDisplay)会自动生成符合Liferay路由规则的博客详情页链接，不用手动拼接路径。

注意事项 #

1. 权限问题：确保你的Web Content模板有足够的权限访问BlogsEntryLocalService，一般默认模板权限是够的，如果遇到权限报错，可以检查模板的权限设置。
2. 性能优化：如果站点博客数量很多，不建议用-1获取所有条目，改成固定数量（比如0, 5只展示最新5篇），避免页面加载过慢。
3. 样式美化：代码里的CSS类（比如footer-blog-list、footer-blog-item）可以根据你的页脚设计自定义样式，让展示更贴合站点风格。

内容的提问来源于stack exchange，提问作者Marco