Why did the homepage banner not display when I used the `bannerList` tag in the template?

In the operation practice of AnQi CMS, sometimes you may encounter a headache: although you have already used it in the template,bannerListThe label, but the banner image on the homepage is reluctant to appear.This is like a carefully prepared opening animation, but it stalls at the critical moment.As an experienced website operations expert, I am well aware of this trouble. Today, let's work together to unravel the problem, starting from the template mechanism and content management strategy of AnQi CMS, find the root cause, and treat the symptoms accordingly.

Firstly, we need to clarify one point,bannerListThe tag is a powerful and commonly used tag built into Anqi CMS, which is specifically used to extract and display the list of Banner images on the website.When it does not work as expected, it is usually not a problem with the tag itself, but rather with the environment of use, background configuration, or data status that has deviated.

One, basic template and grammar review: starting from the source

We start from the template file itself, which is the most direct and easiest to make mistakes

1. Are the tag syntax and spelling correct?The template engine of AnQi CMS is similar to Django syntax, it is very sensitive to the format and case of tags.bannerListTags must start with{% bannerList banners %}in this format, wherebannerListThe label name must not have any spelling errors andcase sensitivity must be strictly matched. If you mistakenly writeBannerList/bannerlist, or use{{ }}instead of{% %}Wrap it, it will be ignored by the template engine. Similarly, when referencing variables in the loop body, also make surebannersthe variable name you defineformatches the variable name in the loop (such asitem), for example{{ item.Logo }}.

2. Is the label placed in the correct homepage template file?The homepage banner should naturally be in the homepage template. Anqi CMS usually names the homepage template asindex.htmlOrindex/index.htmlThe organization pattern of the template theme you are using depends on it. Please make sure you willbannerListThe label is embedded in the template that is actually used to render the homepage. If you place it in other non-homepage templates, you naturally cannot see the effect on the homepage.

3. Is the encoding of the template file UTF-8?Although this usually does not directly cause the label to not display, but incorrect encoding may cause other rendering problems, interfering with normal debugging.The AnQi CMS requires that all template files be unified with UTF-8 encoding, ensure that your template files have not quietly changed encoding formats due to the settings of the editor.

4. Does it haveemptyThe block or conditional judgment prevented the display? bannerListTags are usually withforCombined with loops, for example:

   {% bannerList banners %}
       {% for item in banners %}
           <a href="{{item.Link}}" target="_blank">
               <img src="{{item.Logo}}" alt="{{item.Alt}}" />
               <h5>{{item.Title}}</h5>
           </a>
       {% empty %}
           <!-- 如果没有Banner，这里的内容会显示 -->
           <p>首页暂无Banner图片。</p>
       {% endfor %}
   {% endbannerList %}
   

   If your backend is indeed not configured with any Banner, then{% empty %}The content in the block will be rendered. If your template does not have{% empty %}block andbannersthe variable is empty, then the entireforThe loop area will not produce any output, it looks like the label has not been activated. Therefore, checkbannerswhether the variable is really empty, or if there are any externalifcondition judgments such as{% if banners %}The entire Banner area was blocked.

Secondly, backend configuration and data level: content is king.

If the template syntax and placement are correct, the problem is likely to be in the backend content configuration.

1. The core check: Have you added a Banner image in the backend?This may sound like a basic step, but it is often overlooked.The Banner management of AnQi CMS is usually located under the 'Page Resources' or 'Content Management' module.Please log in to the backend, confirm that you have uploaded the Banner image and filled in the corresponding link, title, and description information.If the background list is empty, then the front end naturally has no image to display.

2. Banner group name (typeParameter) does it match? bannerListThe tag supports a very important parameter:type. It allows you to set different groups for Banner images, such as "Slides", "Ads", "Partners", etc.If you specify a group name (such as "Slideshow") when creating a Banner in the background, then it is used in the template.bannerListWhen the tag is used, it must also pass throughtype="幻灯"This form is used to specify the calling of the Banner under this group. For example:

   {% bannerList banners with type="幻灯" %}
       {# ... 循环显示幻灯组的Banner ... #}
   {% endbannerList %}
   

   If there is a Banner in the background, buttypeThe parameter settings are incorrect, or the template does not use it at alltypeParameter, and the background Banner is exactly divided into groups (typeDefault isdefaultGrouping, then the Banner cannot be displayed. Please check the grouping of the Banner in the background and ensure that the parameters in the template matchtypecorresponding. Is it correct?

3. Under the multi-site mode,siteIdcorrect?The AnQi CMS supports multi-site management. If you have enabled the multi-site feature and configured multiple sites in the background,bannerListthe tags also provide asiteIdParameters to specify which site's Banner data to call.By default, it will try to retrieve the Banner of the current site.But if you try to call another site's Banner in a template on a site, or because of some configuration reasonssiteIdParse error may cause the Banner not to display. In this case, you can try to specify explicitly in the tagsiteId="你的站点ID"to debug.

4. Is the banner image itself valid?Even if the Banner is configured, is the image link still valid?Did the image upload on the backend succeed? Is the image path correct?If the image itself does not exist on the server or the path is incorrect, althoughbannerListThe tag may have normally output the HTML structure, but the image could not be loaded, and it still looks like it is not displayed with the naked eye. At this point, you need to check the image element'ssrcProperty.

Section 3: Caching and Environmental Factors: Refresh and the world will change

Sometimes, the code and data are correct, but stubborn caches may become barriers to seeing the latest changes.

1. Secure CMS system cache cleanupAnQi CMS has a powerful caching mechanism to improve website performance.When you modify the background data or template file, the system cache may not be updated immediately, causing the front-end to still display the old state.Please make sure to log in to the backend, find the 'Update Cache' or similar option, and execute onceSystem cache cleanup.

2. Force refresh browser cacheThis is the simplest but also the most easily overlooked step. Your browser may cache old page content. Try refreshing in the browser.Force refresh(usually Ctrl+F5 or Cmd+Shift+R) to ensure that the latest page on the server is loaded.

4. Advanced debugging techniques: Let the problem nowhere to hide.

If these steps do not solve the problem, we need to delve deeper.

1. UtilizedumpFilter checkbannersVariable contentThe template engine of AnQi CMS provides a powerfuldumpThe filter can help you directly output the detailed structure and content of any variable on the front end. Find it in your template.bannerListAdd a line of code temporarily near the tag.

   
   {% bannerList banners %}
       {{ banners|dump }}
       {# ... 原始的for循环代码 ... #}
   {% endbannerList %}
   

   Or more directly, output anywhere in the template{{ banners|dump }}(IfbannersAvailable in the global context) After rendering the page, check the output of the pagedumpResult:
   • If displayed[]Or a similar empty array structure, explanationbannerListThe label works normally, but no matching Banner data has been extracted from the backend. At this point, focus on checking the backend configuration, especially the group name (type)
   • If a display shows an array containing multiple{}of object structures, it indicates