如何使用AnQiCMS内置标签获取和显示系统配置信息(如网站名称、Logo)?

在网站运营和管理中,保持信息的一致性与更新的便捷性至关重要。AnQiCMS 作为一款高效的内容管理系统,充分考虑了这一点,提供了强大的内置标签功能,让网站的全局配置信息(如网站名称、Logo、备案号等)能够轻松地在前端模板中动态获取和展示。这意味着您无需硬编码,只需在后台一处修改,所有引用该信息的页面都会自动更新,极大地提升了网站的可维护性和运营效率。

理解AnQiCMS的系统配置

AnQiCMS 将网站的核心配置信息集中在后台的“后台设置” -> “全局功能设置”模块中。在这里,您可以管理和修改:

  • 网站名称:用于页面标题、品牌标识等。
  • 网站Logo:上传网站的视觉标志图片。
  • 网站备案号:符合法规要求的备案信息。
  • 版权信息:通常显示在网站页脚的版权声明。
  • 网站首页地址:网站的根域名或主页链接。
  • 移动端地址:针对移动设备访问的特定地址(如果启用)。
  • 模板静态文件地址:方便引用CSS、JS等静态资源。
  • 站点语言:当前网站的语言设置。
  • 以及通过自定义参数功能,您可以根据自身网站的独特需求,添加任何额外的配置项,比如客服电话、公司地址、特定社交媒体链接等。

这些配置的集中管理,使得对网站全局信息的掌控变得非常直观和高效。

系统标签的核心用法 ({% system %})

在AnQiCMS的模板文件中,我们主要通过 {% system %} 标签来获取这些在后台配置的系统信息。这个标签设计得非常灵活,可以根据您的具体需求以多种方式使用。

基本语法:

{% system with name="字段名称" %}

这种方式会直接输出指定字段的值。例如,如果您想直接在页面中显示网站名称,就可以这样写。

赋给变量使用:

{% system 变量名称 with name="字段名称" %}{{ 变量名称 }}

如果您希望在模板的多个位置重复使用某个配置信息,或者需要对获取到的值进行进一步的处理(例如与其他文本拼接),将它赋值给一个变量会是更好的选择,这也能提高模板代码的可读性。

多站点环境下的siteId参数:

如果您在AnQiCMS后台启用了多站点功能,并且希望在当前模板中获取其他站点的配置信息,可以通过添加 siteId 参数来实现:

{% system with name="SiteName" siteId="2" %}

这里的 siteId="2" 指的是ID为2的站点配置信息。

常用系统配置项及其在模板中的调用

下面我们来看看一些常见的系统配置项如何在模板中通过 {% system %} 标签进行获取和展示。

1. 网站名称 (SiteName)

这是网站最基本的标识,通常用于浏览器标题、页面顶部导航等。

  • 调用示例:
    
    <title>{% system with name="SiteName" %} - 您的副标题</title>
    
    或赋值给变量:
    
    {% system siteName with name="SiteName" %}
    <h1>欢迎访问 {{ siteName }}</h1>
    

2. 网站 Logo (SiteLogo)

网站 Logo 是品牌形象的重要组成部分。在后台上传后,您可以在模板中轻松引用。

  • 调用示例:
    
    {% system siteName with name="SiteName" %}
    <img src="{% system with name="SiteLogo" %}" alt="{{ siteName }}" class="website-logo" />
    
    这里我们将网站名称赋给 siteName 变量,作为 Logo 图片的 alt 属性值,有助于SEO和无障碍访问。

3. 网站备案号 (SiteIcp)

国内网站需要展示备案号,AnQiCMS让这一操作变得简单。

  • 调用示例:
    
    <p class="icp-info">
        <a href="https://beian.miit.gov.cn/" rel="nofollow" target="_blank">
            {% system with name="SiteIcp" %}
        </a>
    </p>
    

4. 版权信息 (SiteCopyright)

网站页脚常常包含版权声明,使用标签可以灵活管理这些内容。

  • 调用示例: “`twig