What circumstances require manually specifying the `siteId` parameter of the `bannerList` tag?

As an experienced website operations expert, I have a deep understanding of the multi-site management and template tag features of AnQiCMS. Today, let's talk aboutbannerListA seemingly simple yet crucial parameter in a label.siteIdUnder what circumstances do we need to manually specify it?

bannerListTags andsiteIdThe default behavior of the parameter

In the template development of AnQiCMS, when we usebannerListsuch tags to obtain the list of website Banner images, usually we don'tneed to manually specifysiteIdParametersThis is because AnQiCMS is very intelligent.

When a user visits a site, the system automatically identifies the site ID of the current context. For example, if the user visits the website 'Site A', then all items that are not explicitly specifiedsiteIdThe template tag (includingbannerList/archiveList/categoryListThis means that if you only operate one website, or the template you are currently developing is for a specific site, then let the system handle it automatically.siteIdThis is the most convenient and recommended method. It ensures that the data is closely associated with the current website, avoiding unnecessary configuration and potential errors.

When do you need to specify manually?siteId?

AlthoughsiteIdParameters usually do not require manual intervention, but their existence is not redundant. Manually specifiedsiteIdThe scenarios mainly occur in the following situations:

1. Cross-site data call:This is the most core and most common requirement. When you are on the page of 'Site A', and you need to display the Banner list of 'Site B', you must specify it manually.siteId.For example, you may have a main brand station (Station A), under which multiple sub-brand stations (Station B, Station C, etc.) are attached.On a certain page of the main station, you want to display the latest Banners of all sub-brand sites in a carousel, or on a promotional page of a certain sub-site, you need to reference a specific Banner from a sibling site.siteId就成了数据精确获取的关键。

   • Example scenario:
     • 企业门户网站：Your company operates multiple product lines, each with an independent AnQiCMS sub-site.On the company's homepage (main site), you want to have an area for a carousel to display the featured Banners of various product line sub-sites.bannerList标签，并手动指定每个子站点的siteId来获取它们的Banner。
     • Content Aggregation Page:You may be on a comprehensive content page, where you need to integrate recommendations from different sub-sites, including their Banners. Specify manuallysiteIdIt can allow you to accurately pull the Banner data of the required site.
     • Cross-site promotion:Some sub-site is running a large promotion, you would like to place a prominent promotion banner at the bottom of other related sub-site pages. Through manual specificationsiteIdIt can directly obtain and display the promotional Banner without switching the current site environment.

2. Development and debugging phase:During development or testing, especially in a multi-site environment, you may need to quickly verify whether the Banner configuration of a specific site is correct, or you may need to temporarily simulate the display effect of a specific site in a shared development environment. Manual specificationsiteIdCan load the Banner data of a specified site without changing the current URL or configuration, which is helpful to improve development efficiency.

3. Template reusability and versatility:Imagine you are developing a very general component template that may be used on multiple sites and in some cases needs to dynamically retrieve a specific site's Banner based on some logic. Although this scenario is relatively advanced,siteIdThe existence of parameters provides the possibility for this complex logic, allowing the general template to adapt more flexibly to the needs of multiple sites.

How to specify manuallysiteId?

Manually specifiedsiteIdVery simple, just need to inbannerListtag.siteIdAssign the parameter and give it the corresponding site ID value.

First, you need to know the target site.siteIdThis ID is usually visible in the "Multi-site Management" module of the AnQiCMS backend, where each site's unique identifier can be found.

Assuming the ID of the target site is2Then the code to call the Banner list of the site in the template will be like this:

{# 假设当前在站点A，但需要获取站点ID为2的站点的Banner列表 #}
{% bannerList otherSiteBanners with siteId="2" %}
    {% for item in otherSiteBanners %}
    <a href="{{item.Link}}" target="_blank">
        <img src="{{item.Logo}}" alt="{{item.Alt}}" />
        <h5>{{item.Title}}</h5>
    </a>
    {% endfor %}
{% endbannerList %}

In this way, even if the current page belongs to 'Site A',bannerListThe label will also accurately obtain Banner data from the backend configuration of "Site ID is 2" and display it.

Summary

siteIdParameter inbannerListThe role of tags (and many other data acquisition tags in AnQiCMS) is clear and powerful: it provides a mechanism that allows us to manage multiple sites in AnQiCMS.Precisely obtain data from any specified site, not just the currently visited site. In most cases, the system will handle it automaticallysiteId, but when it is necessary to call cross-site data, perform specific development debugging, or build highly flexible general templates, manual specification is requiredsiteIdIt has become an indispensable tool. Understanding and using this parameter effectively can make your AnQiCMS operation more efficient and flexible.

---

Common Questions (FAQ)

1. How do I know a specific site?siteIdWhat is it?You can find it in the AnQiCMS backend management interface. Usually in the "Multi-site Management" or similar module, each created site will have a unique numeric identifier (ID), which is what you need to use in the templatesiteId.

2. If my AnQiCMS only manages one website, do I still need to usesiteIdthe parameter?If your AnQiCMS only manages one website, the system will automatically identify and load the data of the website.siteIdThe parameter will be set to the current site by default. Manually specifying it will not bring any additional advantages but may increase maintenance costs.

3. siteIdCan the parameter be used to call website data running on other AnQiCMS servers?No.siteIdThe parameter is limited tothe same AnQiCMS system instance underThrough its "multi-site management" feature, it creates and manages multiple websites and calls data between them.It cannot cross different AnQiCMS installation instances to retrieve data.If you need to retrieve data from AnQiCMS instances on different servers, you usually need to implement it through API interfaces or other integration methods.