如何在 AnQiCMS 模板中调用后台设置的联系方式信息？
作为一名精通安企CMS内容运营的资深人员，我深知网站信息管理的高效性对于吸引和保留用户至关重要。尤其是联系方式这类基础而又关键的信息，其统一管理和灵活调用是提升运营效率和确保信息准确性的基石。下面，我将详细介绍如何在AnQiCMS模板中调用后台设置的联系方式信息。
安企CMS后台联系方式的统一管理
在AnQiCMS中，网站的联系方式信息被集中统一管理，这极大地简化了内容的更新流程。您无需修改模板文件即可快速更新网站的电话、地址、邮箱等信息。这些设置位于后台的“后台设置”菜单下的“联系方式设置”选项。
在该界面，AnQiCMS提供了诸多默认的联系方式字段，例如联系人（UserName）、联系电话（Cellphone）、联系地址（Address）、联系邮箱（Email）、微信号（Wechat）及微信二维码（Qrcode）等。此外，为了满足不同网站的个性化需求，AnQiCMS还支持自定义设置参数。您只需提供一个“参数名”（供模板调用，建议使用英文字母并遵循驼峰命名法），一个“参数值”以及一个“备注”来标识其用途，便可轻松扩展联系方式字段。
通过这种方式，网站运营者可以在一个地方集中管理所有对外联系信息，确保全站数据的一致性，并在需要更新时快速生效，避免了手动修改多个模板文件可能带来的遗漏和错误。
在AnQiCMS模板中调用联系方式
AnQiCMS的模板引擎采用了类似Django的语法结构，变量输出使用双花括号 {{变量}}，而逻辑控制则使用单花括号和百分号 {% 标签 %}。调用后台设置的联系方式信息，主要依赖于内置的 contact 标签。
contact 标签的设计宗旨便是简洁高效地获取后台配置的联系方式。其基本使用方法是 {% contact 变量名称 with name="字段名称" %}。其中，“字段名称”是您在后台“联系方式设置”中对应字段的标识符。如果您选择提供“变量名称”，那么该字段的值将被赋给这个变量，供后续在模板中使用；如果不指定“变量名称”，标签会直接输出字段的值。
以下是调用各个联系方式字段的具体示例：
调用联系人信息
如果您想在模板中显示后台设置的联系人姓名，可以使用如下方式：
<span>联系人：{% contact with name="UserName" %}</span>
或者，如果您希望将值赋给一个变量再使用：
{% contact agentName with name="UserName" %}
<span>联系人：{{agentName}}</span>
调用联系电话
要显示联系电话，将 name 属性设置为 Cellphone：
<span>联系电话：{% contact with name="Cellphone" %}</span>
在移动端，您还可以将其包裹在 tel: 链接中，方便用户点击拨打：
<a href="tel:{% contact with name="Cellphone" %}" rel="nofollow">联系电话：{% contact with name="Cellphone" %}</a>
调用联系地址
对于公司或店铺的物理地址，使用 Address 字段：
<span>联系地址：{% contact with name="Address" %}</span>
调用联系邮箱
显示企业的对外邮箱地址，name 属性应为 Email：
<span>联系邮箱：<a href="mailto:{% contact with name="Email" %}">{% contact with name="Email" %}</a></span>
调用微信号与微信二维码
对于微信信息，您可以分别调用微信号文本和二维码图片：
<span>微信号：{% contact with name="Wechat" %}</span>
<div class="wechat-qrcode">
<img src="{% contact with name="Qrcode" %}" alt="微信二维码" />
</div>
调用其他内置社交媒体联系方式
AnQiCMS还内置了QQ、WhatsApp、Facebook、Twitter、Tiktok、Pinterest、Linkedin、Instagram、Youtube等社交媒体联系方式字段。您可以根据需要在后台设置并按照对应的字段名称进行调用。例如，调用WhatsApp：
<span>WhatsApp：{% contact with name="WhatsApp" %}</span>
调用自定义设置参数
如果您在后台的“联系方式设置”中添加了自定义参数，例如您创建了一个名为 ServiceHotline 的参数，用于显示24小时服务热线，您可以在模板中这样调用：
<span>24小时服务热线：{% contact with name="ServiceHotline" %}</span>
请注意，这里的 ServiceHotline 应与您在后台自定义参数时设置的“参数名”保持一致，并且遵循您在后台设置时的驼峰命名规则。
实际应用场景示例
将这些联系方式信息整合到网站的页脚、“联系我们”页面或网站头部，是常见的应用方式。例如，一个典型的网站页脚可能包含以下联系信息：
<footer>
<div class="contact-info">
<p>联系人：{% contact with name="UserName" %}</p>
<p>电话：<a href="tel:{% contact with name="Cellphone" %}" rel="nofollow">{% contact with name="Cellphone" %}</a></p>
<p>邮箱：<a href="mailto:{% contact with name="Email" %}">{% contact with name="Email" %}</a></p>
<p>地址：{% contact with name="Address" %}</p>
<div class="social-links">
{% contact wechatAccount with name="Wechat" %}
{% if wechatAccount %}
<span>微信：{{wechatAccount}}</span>
{% endif %}
{% contact whatsappLink with name="WhatsApp" %}
{% if whatsappLink %}
<a href="{{whatsappLink}}" target="_blank" rel="noopener noreferrer">WhatsApp</a>
{% endif %}
<img src="{% contact with name="Qrcode" %}" alt="微信二维码" style="width: 80px; height: 80px;" />
</div>
</div>
<div class="copyright">
© {% now "2006" %} 版权所有 {% system with name="SiteName" %}
</div>
</footer>
这个示例展示了如何灵活地组合 contact 标签来展示多种联系方式。使用 {% if %} 标签可以判断某些可选字段是否存在，避免在未设置时显示空内容。
总结
通过AnQiCMS提供的 contact 标签，网站运营人员能够轻松地在网站模板中动态调用后台设置的联系方式信息。这种集中管理和灵活调用的机制，不仅提高了信息更新的效率，也确保了网站对外信息的准确性和一致性。无论是标准的联系字段还是自定义的扩展信息，AnQiCMS都能提供强大而便捷的支持，助力您的网站运营更加高效和专业。
常见问题解答 (FAQ)
1. 如果后台某个联系方式字段为空，模板中会显示什么？
答：如果后台“联系方式设置”中某个字段的值为空，那么在模板中通过 {% contact with name="字段名称" %} 调用时，该位置会输出一个空字符串。为了避免页面上出现不必要的空白或标签，建议您在调用这些可选字段时，使用 {% if %} 逻辑判断其是否存在内容，例如：
{% contact phoneNum with name="Cellphone" %}
{% if phoneNum %}
<p>联系电话：{{phoneNum}}</p>
{% endif %}
2. 如何调用我在后台自定义的联系方式字段？
答：您在后台“联系方式设置”中自定义的任何字段，都可以通过您在创建时指定的“参数名”来调用。例如，如果您创建了一个名为“ServiceEmail”的自定义字段，您就可以在模板中使用 {% contact with name="ServiceEmail" %} 来调用其值。请确保您使用的“参数名”与后台设置时的大小写完全一致，遵循驼峰命名法则。
3. 如果我的AnQiCMS部署了多个站点，是否能调用其他站点的联系方式？
答：是的，AnQiCMS的多站点管理功能支持您调用其他站点的联系方式信息。 contact 标签提供了一个 siteId 参数，您可以通过指定其他站点的ID来获取其联系方式。例如，如果您想调用ID为2的站点的联系电话，可以使用 {% contact with name="Cellphone" siteId="2" %}。如果不指定 siteId 参数，标签会默认获取当前站点的联系方式。