After the home page banner image is uploaded, the front-end page does not update and display. How should I investigate?

As an experienced website operation expert, I fully understand the frustration you feel when, after uploading a beautiful homepage banner image to the AnQiCMS backend, you find that the front page remains unchanged and still displays the old content.This is indeed a small episode often encountered in the process of content update, but it is usually not a big problem.Next, I will lead you step by step to troubleshoot, hoping to help your website Banner look brand new.

After the home page banner image is uploaded, the front-end page does not update and display. How should I investigate?

When you carefully upload a new homepage banner image in the AnQiCMS backend and eagerly refresh the front page, only to find that it is still the old scene, it is undoubtedly confusing.But please be assured that this is usually not a system failure, but some minor details that we overlooked.As a content operations expert, I know that every detail can affect the final presentation.Let us investigate from the most common to the deepest causes one by one.

First Step: Confirm if the Banner image has been successfully uploaded and configured

Firstly, we need to go back to the root of the problem - the AnQiCMS admin panel. Please log in to the admin panel and navigate toPage Resources>Image Resource ManagementCheck if the new Banner image you uploaded really exists. If the image has been successfully displayed in the image library, the file upload itself is usually fine.

Next, we need to confirm whether these images have been correctly associated with the display position of the homepage Banner. In AnQiCMS, the management of the homepage Banner is usually inBackend settingsorFunction ManagementFind a named option called 'Home Banner' or 'Carousel'. Check:

  1. Is the image selected and added to the Banner list?Many CMS systems require you to upload images first, then 'select' and 'add' them to the carousel list in the Banner management interface.
  2. Is the Banner enabled?Ensure that the status of the newly added Banner is set to 'Enabled' or 'Visible'.
  3. Is the Banner group set?Based ontag-/anqiapi-other/3498.htmlDescription of the document, Banner supports sorting bytypeParameters are grouped and called. If your homepage template specifies a specific group (such astype="幻灯"Please ensure that your new Banner is added to the correct group. If it is added to the wrong group, the front-end will naturally not be able to call it.
  4. Is the order of the banners correct?If you want the new image to appear immediately, please check if its order is sufficiently high.

If all the above configurations are confirmed to be correct, the Banner image looks normal in the background, then we can proceed to the next step of troubleshooting.

Step 2: Clear the omnipresent cache

Once the basic situation is confirmed, what we are facing next is the 'root of all evil' in website operation - caching. This is almost the primary suspect for all issues where front-end content is not updated.

  1. Browser cache:Just like in our daily life, if we open a webpage and find that the content has not been updated, the simplest way is to clear the browser cache.For web page updates, simply pressing F5 may not be enough.Ctrl + F5 (Windows/Linux) or Cmd + Shift + R (Mac)Perform a hard refresh, which will force the browser to download all resources from the server instead of using local cache.If the refresh does not change after a hard refresh, then we need to consider the server-side issue.

  2. AnQiCMS System Cache:AnQiCMS as a high-performance CMS, in order to improve access speed, it will extensively use system caching.After you have updated the Banner image or related configuration, the system may still be providing old cached content.Update the cacheOptions (based onhelp-index.mdDocument description). Click it to perform a full system cache cleanup operation. This will clear out old data stored internally by the system, forcing it to regenerate the latest content.

  3. CDN Cache (if used):If your website uses a CDN (Content Delivery Network) service to accelerate access, then the CDN will also cache your website's static resources, including banner images.Even if you clear the browser and server cache, CDN nodes may still be distributing old images.You need to log in to your CDN service provider's console, find the corresponding domain, and perform a 'refresh cache' or 'preheat' operation.Generally, you can choose to refresh a single URL or the entire directory.

Step 3: Deep Check Home Page Template Code

If the problem is not resolved after the cache is cleared, then we need to turn our attention to the website's template files.This is the 'skeleton' of the display content of AnQiCMS, any display issue may be related to the template code.

Based ondesign-director.md, the home page template is usually located in/templatethe directory.index/index.htmlorindex.html. You can find the template design in the backgroundTemplate DesignIn function, edit or view these files online.

We need to pay special attention to the call tags of the Banner image. According totag-/anqiapi-other/3498.htmlDocument, the tag used by AnQiCMS to call the home page banner is{% bannerList %}Check:

  1. bannerListIs the tag correctly present?Make sure your home page template includes a code snippet similar to the following:
    
{% 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 %}
  2. typeDo the parameters match?If your backend Banner is set to group, and in the template.bannerListThe label hastypeParameters (e.g.,)with type="幻灯"), please make sure that thetypeThe value is exactly the same as the Banner group name configured in your backend.
  3. Is the image URL field correct? tag-/anqiapi-other/3498.htmlSpecify the URL of the Banner image by{{item.Logo}}Retrieve. Please confirm that the template is.<img>Tagssrcthe property is used correctly.{{item.Logo}}.
  4. Is there a conditional judgment to prevent display?Check{% for item in banners %}Are there any loops inside?{% if %}These judgments may not render the image due to certain conditions not being met.

Step 4: Check the image processing and storage configuration.

AnQiCMS provides rich image processing features (refer to)help-setting-content.md), these settings may also affect the normal display of images:

  1. WebP conversion or automatic compression:InBackend settings>Content SettingsIf you have enabled options such as 'Enable Webp image format' or 'Automatically compress large images', the newly uploaded images will be processed.If an error occurs during the process, it may cause the image to fail to generate or load.You can temporarily disable these options and re-upload the image to see if the problem is resolved.
  2. Image URL check:Use the browser developer tools (usually F12 key), switch to the “Network” (network) tab, and refresh the page.Find the loading request for Banner images and check its HTTP status code.
    • 200 OK:Image loaded normally. If it still does not display, it may be a CSS or JS issue.
    • 404 Not Found:Image file does not exist.This may mean that the image was not generated successfully, the path is incorrect, or there is a file permission issue.Check the complete URL of the image displayed in the developer tools, and see if it matches the URL in the background "Image Resource Management".
    • 5xx Server Error：Server-side error, possibly involving failed image processing, file system permissions, etc.
  3. File storage permissions：Images uploaded to AnQiCMS are usually stored in/public/uploadsdirectory. Please make sure that this directory and its subdirectories are accessible to the web server user (such aswwwUser）has read and write permissions. Insufficient permissions may cause the image to fail to upload or the server to fail to read.

Step 5: Check server environment and reverse proxy issues

For