如何在模板中获取当前单页面的ID并通过`pageDetail`标签显示其标题？
作为一名资深的安企CMS网站运营人员，我深知内容在网站中的核心地位，以及模板制作在实现内容有效呈现方面的重要性。当我们需要在单页面详情模板中精准地获取并展示当前页面的ID和标题时，AnQiCMS提供了直观且高效的模板标签pageDetail来完成这项任务。
在AnQiCMS模板中获取当前单页面的ID和标题
在AnQiCMS的模板体系中，pageDetail标签是专门用于处理单页面详情数据获取的关键工具。它允许我们灵活地从当前单页面或指定单页面中提取各种信息，包括其唯一的标识符ID和用户可读的标题。
理解AnQiCMS模板与pageDetail标签
AnQiCMS的模板引擎采用了类似Django语法的标记方式，使得内容与逻辑分离，便于网站维护和样式定制。在模板文件中，变量通过双花括号{{变量}}定义，而逻辑控制标签（如条件判断、循环）则使用单花括号和百分号{% 标签 %}。
pageDetail标签正是这样一种强大的逻辑标签，其主要作用是在单页面详情页上下文中，或者通过明确指定ID，来获取单页面的详细数据。当你在一个单页面的详情模板（例如page/detail.html或page.html）中使用pageDetail标签时，它会智能地识别当前正在被访问的单页面，并从中提取所需的数据，无需额外指定ID。
获取当前单页面的ID
要获取当前单页面的ID，我们可以在单页面详情模板中直接使用pageDetail标签，并将其name参数设置为Id。由于pageDetail标签在单页面详情页中具备自动识别当前页面的能力，因此我们通常不需要再提供id参数。
例如，在你的page/detail.html模板文件中，你可以这样获取当前单页面的ID：
<p>当前单页面ID：{% pageDetail with name="Id" %}</p>
这段代码会直接输出当前单页面的数字ID。
显示当前单页面的标题
与获取ID类似，要显示当前单页面的标题，我们同样利用pageDetail标签，但这次将name参数设置为Title。这能确保我们获取到的是该单页面在后台配置的正式标题。
在同一个单页面详情模板中，显示标题的代码会是：
<h1>{% pageDetail with name="Title" %}</h1>
这将会把当前单页面的标题以H1标签的形式呈现在页面上。
实践操作：在模板中实现
在AnQiCMS中，单页面的详情模板通常位于你当前使用的模板主题目录下的page/detail.html或page.html文件。为了清晰地展示如何在这些模板中获取ID和标题，我们可以结合使用它们。
以下是一个具体的模板代码示例，它会在单页面上同时显示其ID和标题：
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>{% pageDetail with name="Title" %} - {% system with name="SiteName" %}</title>
</head>
<body>
<header>
<nav>
{# 导航栏内容 #}
</nav>
</header>
<main>
<section>
{# 使用pageDetail标签直接输出当前单页面的ID和标题 #}
<h1>当前页面标题：{% pageDetail with name="Title" %}</h1>
<p>当前页面ID：{% pageDetail with name="Id" %}</p>
{# 也可以将ID和标题存储到变量中，方便在模板其他位置复用 #}
{% pageDetail currentPageId with name="Id" %}
{% pageDetail currentPageTitle with name="Title" %}
<div class="page-info">
页面ID（来自变量）：{{ currentPageId }}
<br>
页面标题（来自变量）：{{ currentPageTitle }}
</div>
<article>
<h2>页面内容</h2>
{# 显示单页面的内容，需要使用safe过滤器以避免HTML转义 #}
<div>{% pageDetail with name="Content" %}{{ pageDetail.Content|safe }}</div>
</article>
</section>
</main>
<footer>
{# 页脚内容 #}
</footer>
</body>
</html>
在这个示例中，我们首先在<title>标签内利用pageDetail获取标题，并通过{% system with name="SiteName" %}获取网站名称作为标题后缀。接着，在页面主体中，我们分别使用{% pageDetail with name="Title" %}和{% pageDetail with name="Id" %}直接输出标题和ID。为了演示变量的复用，我们还展示了如何将它们赋值给currentPageId和currentPageTitle变量，并在后续使用。最后，还简单展示了如何显示单页面的内容。
扩展应用：获取其他单页面信息
pageDetail标签的强大之处不仅限于ID和Title。通过更改name参数，你还可以获取单页面的其他丰富信息，例如：
- 单页面链接：
{% pageDetail with name="Link" %} - 单页面描述：
{% pageDetail with name="Description" %} - 单页面内容：
{% pageDetail with name="Content" %}(注意，获取内容时常需配合|safe过滤器以正确渲染HTML) - 单页面缩略图：
{% pageDetail with name="Thumb" %} - 单页面幻灯片组图：
{% pageDetail pageImages with name="Images" %}{% for img in pageImages %}<img src="{{ img }}" />{% endfor %}
如果需要获取的不是当前访问的单页面信息，你可以通过id或token参数明确指定目标单页面。例如，要获取ID为5的“关于我们”页面的标题，即使当前不在该页面，也可以使用{% pageDetail with name="Title" id="5" %}。
通过这些灵活的标签和参数组合，AnQiCMS让模板制作变得更加高效和定制化，确保网站内容能以您期望的方式精确呈现。
常见问题解答 (FAQ)
问：如何在非单页面模板（例如首页或列表页）中获取特定单页面的ID和标题？
答：pageDetail标签支持通过id或token参数来明确指定要查询的单页面。例如，如果你想在网站的首页显示ID为8的“联系我们”单页面的标题，可以使用{% pageDetail with name="Title" id="8" %}。如果你知道其URL别名（例如about-us），也可以使用{% pageDetail with name="Title" token="about-us" %}来获取标题。
问：pageDetail标签除了ID和Title，还能获取哪些单页面的字段？
答：pageDetail标签非常灵活，根据name参数的不同，除了ID（Id）和标题（Title），还可以获取单页面的链接（Link）、描述（Description）、完整内容（Content）、缩略图大图（Logo）、缩略图（Thumb）以及幻灯片组图（Images）等丰富信息。在获取如Content这类可能包含HTML标签的字段时，通常建议配合|safe过滤器使用，以确保内容能正确渲染。
问：如果我在单页面详情模板中使用了pageDetail标签，但当前访问的URL并不是一个有效的单页面详情页，会发生什么？
答：如果pageDetail标签在非单页面详情页被调用，并且没有通过id或token参数明确指定页面，它可能无法获取到有效的单页面上下文信息。在这种情况下，pageDetail标签所尝试获取的字段（如ID或Title）将可能输出为空值。为了避免这种情况，请确保在模板中调用pageDetail时，要么当前URL确实指向一个单页面详情，要么通过id或token参数提供一个明确的单页面标识符。