If the `type` parameter is not set, which Banner group will `bannerList` default to calling?

As an experienced website operations expert, I often deal with various content management systems in my daily work, and I am well aware of the impact of each detailed function on the efficiency of website operations.AnQiCMS (AnQiCMS) stands out among many CMS systems for its lightweight, efficient, and flexible features.Today, let's delve deeply into a problem that often arises when developing templates or managing content on AnQiCMS: whenbannerListTags not settypeWhen a parameter is specified, which Banner group will it default to call?

Unveiling Anqi CMSbannerListLabel: Not settypeWhen a parameter is specified, which Banner group will it default to call?

In website operation, the Banner carousel is a key element to attract users' attention, convey core information, and guide user behavior. AnQiCMS provides powerfulbannerListTags, allowing operators and developers to flexibly control the display of banners in different areas of the website. However, for developers who are new to AnQiCMS or use the tag without thorough understanding, a common question is: what if it is not explicitly specifiedtypeParameter, how will the system handle it?

The answer is:WhenbannerListThe tag is not settypeWhen the parameter is specified, AnQiCMS will default to calling the Banner group named "default".

This design concept reflects AnQiCMS' considerations for ease of use.In most web designs, the homepage or main content area usually has a common Banner carousel, carrying the core promotion content of the website.AnQiCMS has named this most commonly used and basic Banner collection as "default" and made it becomebannerListThe default behavior of the label. This means that even if you use the label for the first time, or just need a standard main Banner area, you do not need to make any additional parameter settings, and the system can intelligently display the preset carousel content.This greatly simplifies the work of template development and initial website construction.

UnderstandingbannerListBasic usage of tags

bannerListThe tag is mainly used to obtain Banner data from the background and display it as a list on the front end. It will store the obtained Banner data in a variable that you can name yourself (for examplebannersThis variable is an array object, you need to iterate through it to display the details of each Banner.

A basic call example without anytypeThe parameter, it will default to get all Banners under the "default" group:

{% bannerList banners %}
    {% for item in banners %}
    <a href="{{ item.Link }}" target="_blank">
        <img src="{{ item.Logo }}" alt="{{ item.Alt }}" />
        <h5>{{ item.Title }}</h5>
    </a>
    {% endfor %}
{% endbannerList %}

In the code above:

• {% bannerList banners %}: Declare to get the Banner list and assign its data to a name ofbanners.
• {% for item in banners %}：TraversebannersEach Banner data item in the array is assigned toitemVariable.
• {{ item.Link }}Output the current Banner's link address.
• {{ item.Logo }}Output the current Banner's image address.
• {{ item.Alt }}：Output the current Banner image's alt text, which is very important for SEO and accessibility.
• {{ item.Title }}Output the current Banner's title text, usually used to display above the image or as a prompt message.

Flexible applicationtypeCall a specific group of parameters

Of course, as an experienced operations expert, we know that website needs are often diverse.You may wish to display different themed Banners in different areas of the website, such as "News Center Banner", "Product Recommendation Banner", or "Footer Promotion Banner".At this point, the Banner Grouping function of AnQiCMS comes into play.

You can create multiple Banner groups in the AnQiCMS backend and upload corresponding Banner images for each group. When you want to call a specific group's Banner, just inbannerListExplicitly specify in the tagtypeParameters and their corresponding group names are sufficient.

For example, if you create a Banner group named 'Slide' in the background, you can call it in the following way:

{# 调用名为“幻灯”的Banner分组 #}
{% bannerList banners with type="幻灯" %}
    {% for item in banners %}
    <a href="{{ item.Link }}" target="_blank">
        <img src="{{ item.Logo }}" alt="{{ item.Alt }}" />
        <h5>{{ item.Title }}</h5>
    </a>
    {% endfor %}
{% endbannerList %}

In this way, you can easily manage and display all customized Banner content on the website, greatly enhancing the flexibility and operational efficiency of the website content.

Operations Tips

1. Unified Naming Conventions:When creating a Banner group in the background, it is recommended to use meaningful and easily distinguishable names and align them with the front endtypeparameters to avoid confusion.
2. Optimize image size:No matter which group's Banner, the image file size should be optimized to ensure website loading speed and improve user experience.
3. Perfect the Alt attribute:Add descriptive text to each Banner imagealtThis not only helps with SEO, but also improves the accessibility of the website.
4. Updated regularly:Maintain the timeliness and freshness of the Banner content, regularly update promotional, event, or new product information, which can better attract users.

In summary, AnQiCMS'sbannerListTag without specifyingtypeWhen a parameter is specified, it will intelligently default to calling the 'default' Banner group, providing the website with the convenience of out-of-the-box use. And through flexible applicationtypeParameter grouping calls, you can inject customized visual vitality into every corner of the website, effectively support the implementation of operation strategies, and achieve accurate marketing and efficient distribution of content.

Frequently Asked Questions (FAQ)

1. How to create a new Banner group in the AnQiCMS backend?In most cases, you can find the 'Banner Management' or 'Slideshow Management' entry under the 'Content Management' or 'Page Resources' related menus in the AnQiCMS backend.After entering, you can add new Banner entries and select or create a new group name when editing.The specific path may vary due to the AnQiCMS version or theme settings, please refer to the backend operation manual or find it in the relevant module.

2. If I created a new Banner group but the front-end still displays the Banner of the 'default' group, what could be the reason?This is usually due to the template in the front-end.bannerListThe tag is not set correctlytypeOr, parameter,typeThe parameter value does not match the group name created in the background (including case, full-width and half-width, etc.). Please check the front-end code to ensure that{% bannerList banners with type="您的分组名" %}The 'Your Group Name' is consistent with the background settings.

3. In addition to the home page Banner, what other position settings for Banner images does AnQiCMS support?The design of AnQiCMS is very flexible. In addition to usingbannerListthe global Banner called by tags, according to the document description, you can also indocument category (Category)andSingle Page (Page)In the editing interface, find the "Banner Image" settings option.This means you can set a dedicated Banner for specific category pages or independent pages to further enhance the customization and visual appeal of the content.