启用页眉和页脚输出缓存

项目
07/19/2023

若要改善在 Power Pages 中处理页眉和页脚 Web 模板的性能，可启用页眉和页脚输出缓存。在每一次页面加载时分析和呈现页眉和页脚 Web 模板。缓存页眉和页脚输出大大减少了页面处理时间。

页眉和页脚模板由网站记录的选项部分中的页眉模板和页脚模板字段所决定。如果未指定页眉或页脚模板，则显示默认的页眉和页脚。

您可以创建使用本文中概述的 {% substitution %} 标签的自定义页眉和页脚 Web 模板。

对于所有新网站，默认已启用输出缓存。以下站点设置可用并默认设置为 true 以支持此功能：

Header/OutputCache/Enabled：将该值设置为 true 以启用页眉的输出缓存。
Footer/OutputCache/Enabled：将该值设置为 true 以启用页脚的输出缓存。

如果已升级到新版本的 Power Pages，则默认禁用输出缓存 - 这意味着在每次加载页面时对页眉和页脚 Web 模板进行分析和呈现。若要启用输出缓存，必须更新页眉、页脚和语言下拉列表 Web 模板并创建所需的站点设置。

备注

如果您仅通过站点设置启用输出缓存，则页眉和页脚的有些部分不会正确呈现，并且会显示一条错误消息。

对现有网站启用页眉和页脚输出缓存

步骤 1：更新页眉 Web 模板

打开“门户管理”应用。
转到内容>Web 模板。
打开页眉 Web 模板。

更新源字段中的代码：

查找以下代码和更新它：

现有代码

<li>
    <a href={% if homeurl%}/{{ homeurl }}{% endif %}/Account/Login/LogOff?returnUrl={{ request.raw_url_encode | escape }} title={{ snippets["links/logout"] | default:resx["Sign_Out"] | escape }}>
    {{ snippets["links/logout"] | default:resx["Sign_Out"] | escape }}
    </a>
</li>
</ul>
</li>
{% else %}
<li>
    <a href={% if homeurl%}/{{ homeurl }}{% endif %}/SignIn?returnUrl={{ request.raw_url_encode }}>
    {{ snippets["links/login"] | default:resx["Sign_In"] }}
    </a>
</li>

更新的代码

<li>
   <a href={% if homeurl%}/{{ homeurl }}{% endif %}{{ website.sign_out_url_substitution }} title={{ snippets["links/logout"] | default:resx["Sign_Out"] | escape }}>
   {{ snippets["links/logout"] | default:resx["Sign_Out"] | escape }}
   </a>
</li>
</ul>
</li>
{% else %}
<li>
   <a href={% if homeurl%}/{{ homeurl }}{% endif %}{{ website.sign_in_url_substitution }}>
   {{ snippets["links/login"] | default:resx["Sign_In"] }}
   </a>
</li>

查找以下代码和更新它：

现有代码

  {% assign current_page = page.adx_partialurl %}
  {% assign sr_page = sitemarkers[Search].url | remove: '/' %}
  {% assign forum_page = sitemarkers[Forums].url | remove: '/' %}
  {% if current_page == sr_page or current_page == forum_page %}
    <section class=page_section section-landing-{{ current_page }} color-inverse>
      <div class=container>
        <div class=row >
          <div class=col-md-12 text-center>
            {% if current_page == sr_page %}
              <h1 class=section-landing-heading>{% editable snippets 'Search/Title' default: resx["Discover_Contoso"] %}</h1>
              {% include 'Search' %}
            {% endif %}
          </div>
        </div>
      </div>
    </section>
{% endif %}

更新的代码

{% substitution %}
    {% assign current_page = page.id %}
    {% assign sr_page = sitemarkers[Search].id %}
    {% assign forum_page = sitemarkers[Forums].id %}
    {% if current_page == sr_page or current_page == forum_page %}
      {% assign section_class = section-landing-search %}
      {% if current_page == forum_page %}
        {% assign section_class = section-landing-forums %}
      {% endif %}
     <section class=page_section section-landing-{{ current_page }} {{ section_class | h }} color-inverse>
        <div class=container>
          <div class=row >
            <div class=col-md-12 text-center>
              {% if current_page == sr_page %}
                <h1 class=section-landing-heading>{% editable snippets 'Search/Title' default: resx["Discover_Contoso"] %}</h1>
                {% include 'Search' %}
              {% endif %}
            </div>
          </div>
        </div>
      </section>
    {% endif %}
{% endsubstitution %}

保存 Web 模板。

步骤 2：更新页脚 Web 模板

打开“门户管理”应用。
转到内容>Web 模板。
打开页脚 Web 模板。

在源字段中，找到以下代码和更新它：

现有代码

<section id=gethelp class=page_section section-diagonal-right color-inverse {% if page %}{% unless page.parent %}home-section{% endunless %}{% endif %} hidden-print>

更新的代码

<section id=gethelp class=page_section section-diagonal-right color-inverse {% substitution %}{% if page %}{% unless page.parent %}home-section{% endunless %}{% endif %}{% endsubstitution %} hidden-print>

保存 Web 模板。

步骤 3：更新语言下拉列表 Web 模板

打开“门户管理”应用。
转到网站>Web 模板。
打开语言下拉列表 Web 模板。

在源字段中，找到以下代码，并确保 language 对象使用 url.substitution 属性而不是 url：

<a href=/{{ language.url_substitution }} title={{ language.name }} data-code={{ language.code }}>{{ language.name }}</a>

保存 Web 模板。

步骤 4：创建站点设置

创建以下站点设置：

客户	值
Header/OutputCache/Enabled	真
Footer/OutputCache/Enabled	真

通过

启用页眉和页脚输出缓存

对现有网站启用页眉和页脚输出缓存

反馈

其他资源