怎样在AnqiCMS中自定义联系方式参数并在模板中调用显示?

在网站运营中,保持与用户的顺畅沟通至关重要。除了传统的电话、邮箱等联系方式,很多时候我们还需要展示更多个性化的社交媒体或即时通讯信息。AnqiCMS 提供了一个非常灵活的联系方式管理模块,让您可以轻松自定义并灵活地在网站的任何位置展示这些信息。

接下来,我们将分两个主要步骤,详细讲解如何在 AnqiCMS 中自定义联系方式参数,并在模板中调用显示。

一、在 AnqiCMS 后台设置自定义联系方式参数

AnqiCMS 的后台管理系统让您可以轻松管理网站的各项设置。要自定义联系方式,您需要先登录后台。

  1. 进入联系方式设置页面: 登录后台管理界面后,在左侧导航栏找到“后台设置”菜单项。点击展开后,选择“联系方式设置”。您会看到一个包含默认联系信息(如联系人、联系电话、联系地址、联系邮箱、微信号、微信二维码等)的页面。

  2. 创建新的自定义参数: 如果这些内置的选项还不能满足您的需求,AnqiCMS 允许您创建自定义的联系方式参数。在“联系方式设置”页面的下方,您会找到一个名为“自定义设置参数”的区域。

    • 点击该区域旁边的“添加”按钮。
    • 在弹出的输入框中,首先填写参数名。这个参数名是您在模板中调用该自定义联系方式时会使用的标识符。强烈建议使用英文或拼音,并采用驼峰命名法则(例如:WhatsAppXiaoHongShu)。这样既能保持代码的规范性,也方便后续维护。即使您输入了中文,系统也会自动将其转换为驼峰命名。
    • 参数值中,填写该联系方式的实际内容。例如,如果您设置参数名为 WhatsApp,那么参数值就可以填写您的 WhatsApp 电话号码。
    • 备注字段可以用来简要说明这个自定义参数的用途,方便您和其他管理员日后查看和管理。
    • 填写完毕后,点击“保存”按钮。

完成以上步骤后,您就成功地在 AnqiCMS 后台添加了一个自定义的联系方式参数。例如,我们添加了一个名为 WhatsApp 的参数,并填入了您的 WhatsApp 号码。

二、在模板中调用显示自定义参数

后台参数设置完成后,下一步就是将这些信息展示到您的网站前台。AnqiCMS 提供了简单直观的模板标签,让您可以在网站的任何地方调用这些联系方式。

  1. 了解 contact 标签: AnqiCMS 提供了专门用于调用联系方式信息的 contact 标签。这个标签是您在模板中获取所有联系方式(包括内置和自定义)的关键。

  2. 调用自定义参数: 在您的网站模板文件(通常是 template 目录下的 .html 文件,如页头 partial/header.html、页脚 partial/footer.html 或联系我们页面 page/contact.html)中,您可以使用以下语法调用自定义的联系方式:

    {% contact with name="您的自定义参数名" %}
    

    例如,要调用我们刚才在后台自定义的 WhatsApp 联系方式,您只需在模板中这样写:

    <div>我的WhatsApp:{% contact with name="WhatsApp" %}</div>
    

    如果您希望将获取到的值存储到一个变量中,以便进行进一步处理或在模板中多次引用,可以这样操作:

    {% contact myWhatsApp with name="WhatsApp" %}
    <p>立即联系我们,WhatsApp 号码:<a href="https://wa.me/{{ myWhatsApp }}" target="_blank">{{ myWhatsApp }}</a></p>
    

    通过这种方式,您不仅可以显示号码,还可以直接构建一个 WhatsApp 的聊天链接。

  3. 调用内置联系方式: 内置的联系方式也可以用相同的方式调用。例如,要显示网站的联系电话和联系邮箱:

    <p>联系电话:{% contact with name="Cellphone" %}</p>
    <p>联系邮箱:{% contact with name="Email" %}</p>
    

    请注意 name 参数的值必须与 AnqiCMS 预定义的字段名称(如 CellphoneEmailAddress 等)完全匹配。

通过以上两个步骤,您就可以灵活地在 AnqiCMS 中添加和展示各种联系方式了。这种高度的可定制性,使得您的网站能够更好地满足不同的业务需求和用户沟通习惯。


常见问题 (FAQ)

1. 我自定义的参数名如果用了中文,在模板里怎么调用?

答:尽管 AnqiCMS 后台允许您输入中文参数名,但系统在内部会自动将其转换为驼峰命名的英文(或拼音)形式。例如,如果您输入“联系方式”,它可能会被处理为 LianXiFangShi。为了避免混淆和确保调用准确,强烈建议您在设置参数名时直接使用英文或拼音的驼峰命名,例如 WeChatOfficialAccountCustomerServiceEmail。这样在模板中直接使用 {% contact with name="WeChatOfficialAccount" %} 即可。

2. 为什么我在后台设置了自定义联系方式,但在前台模板中却显示不出来?

答:这通常有几个原因。首先,请检查模板中 contact 标签的 name 参数值是否与您在后台“自定义设置参数”中填写的“参数名”完全匹配,包括大小写。其次,请确保您在后台修改后点击了“保存”按钮。最后,AnqiCMS 会有缓存机制,请尝试在后台管理界面的左侧导航栏找到“更新缓存”并点击,清除网站缓存后再刷新前台页面查看效果。

3. 我可以将一个自定义参数设置为图片(比如另一个二维码)吗?

答:当然可以。您可以在自定义参数的“参数值”中直接填写图片的完整 URL 地址。然后在模板中调用时,结合 HTML 的 <img> 标签来显示它。例如,如果您设置了一个参数名为 AnotherQrcode,参数值为 http://yourdomain.com/uploads/images/another_qrcode.png,那么在模板中您可以这样调用: <img src="{% contact with name="AnotherQrcode" %}" alt="自定义二维码" />。这使得您可以灵活地添加各种图片作为联系方式的补充。