Hello!As an experienced website operation expert, I fully understand the confusion and anxiety you may feel when you update the AnQiCMS backend settings and find that the front-end does not take effect immediately.This is a very common phenomenon in website operation, usually not a system failure, but a mechanism designed to enhance website performance and user experience is in effect.Today, let's delve into the possible reasons behind this and provide detailed solutions.

Why does the front-end not take effect immediately after AnQiCMS backend contact information is updated?

When you have toiled away in the AnQiCMS backend to modify the contact information, only to find that the front page still displays outdated information, this usually means you have encountered a common 'cache' issue. AnQiCMS, as an enterprise-level content management system developed based on the Go language, one of its design philosophies is to provideHigh-performance architectureandEfficient content management solutionTo achieve this, the system widely uses various caching mechanisms to accelerate page loading and response speed, thereby enhancing user experience and search engine friendliness.

In simple terms, your website content may be 'temporarily stored' at multiple stages before being accessed by users, so that when users visit again, these temporarily stored data are read directly instead of regenerating them from the database each time.This can greatly reduce the server load and speed up the page rendering speed.

Then, which specific caching steps may have caused the contact information update to be not timely?

  1. AnQiCMS Internal Caching:The AnQiCMS system itself is designed to improve operational efficiency, caching some global settings, configuration information, and even some page content of the website.This means that even if you modify the data in the background and save it to the database, the system may still directly call the previously cached copy of the old data when responding quickly.This is the most common and most direct reason.

  2. Browser Caching (Client Caching):Your browser also plays the role of a 'cacher'.When you first visit a webpage, the browser will intelligently store some static resources on the page (such as CSS styles, JavaScript scripts, images, and even the entire HTML structure of the page) locally.Next time you visit the same page, the browser will check the local cache first.If it believes that the locally cached version is still 'fresh and valid', it will load it directly without requesting the latest content from the server.The AnQiCMS documentation also clearly states, for example, that after an image is uploaded, if the front-end is not updated, it is necessary to 'clear the local browser cache'. This is a prompt for this mechanism.

  3. CDN or Reverse Proxy Caching (Intermediate Layer Caching):Many websites deploy content delivery networks (CDN) or reverse proxy servers (such as Nginx, Apache) to enhance access speed and security.CDN will distribute your website content to servers closer to the users, while reverse proxy acts as a front-end for your website server, handling user requests.These intermediate layers will also cache web content.When a user requests a page, the CDN or reverse proxy may directly return old data from its cache without asking the AnQiCMS server if there is the latest content.This is often involved in the AnQiCMS Docker deployment tutorial, for example, configuring Nginx/OpenResty/Apache for reverse proxy in 1Panel, Baota Panel, and these proxy layers themselves may have caching functions.

  4. Template Call Issues (in rare cases):Although the possibility is low, if there is an error when calling the template tag for contact information, or if contact information is mistakenly hardcoded into the template file instead of being provided through AnQiCMS,{% contact %}Label (reference)design-tag.mdandtag-contact.mdThen, even if the background data is updated, the front-end cannot obtain it correctly.

After understanding these possible reasons, let's see how to investigate and solve the problems one by one.

Solution and Troubleshooting Steps

When facing the situation where the front-end information does not update, you can troubleshoot and operate according to the following steps:

  1. Clear the internal cache of AnQiCMS:This is the most direct and effective solution. AnQiCMS backend usually provides a 'Clear Cache' or 'Update Cache' button.

    • Operation Instructions:Log in to the AnQiCMS admin panel, navigate to "System Settings" or "Admin Home Page", and you will find a feature named "Update the cache" (refer to)help-index.mdThe introduction of the 'Update Cache' module).Click this button to force AnQiCMS system to clear its internal stored old data and reload the latest configuration information.Please check the front-end immediately after the operation is successful.

  2. Clear browser cache:Even if the internal cache of AnQiCMS has been cleared, your browser may still stubbornly display the old version.

    • Operation Instructions:
      • Hard refresh:Try pressing on the front page,Ctrl + F5(Windows/Linux) orCmd + Shift + R(macOS) combination key, which will force the browser to reload all resources from the server, ignoring local cache.
      • Manually clear:If hard refresh is not effective, you may need to go into the browser settings and manually clear the 'Cached images and files' in 'Browsing data'.The specific steps may vary depending on the browser, usually in the "History" or "Privacy and Security" settings.

  3. Refresh CDN or reverse proxy cache:If your website uses CDN services (such as Alibaba Cloud CDN, Tencent Cloud CDN, etc.) or has configured reverse proxy caching, you need to perform operations on the corresponding management platform.

    • Operation Instructions:
      • CDN:Log in to your CDN service provider's console, find the 'Refresh Cache' or 'Content Refresh' feature.You can choose to refresh a specific URL (i.e., the contact page URL of your website) or perform a full site refresh (but a full site refresh may cause a slight decrease in website access speed in the short term).
      • Reverse Proxy:If you are running a reverse proxy server (such as Nginx) by yourself, you may need to restart or reload its configuration. For example, for Nginx, you can connect to the server via SSH and executesudo systemctl reload nginxorsudo systemctl restart nginxa command.

  4. Check template code:If none of the above steps solve the problem, you need to check the website's template files.

    • Operation Instructions:Confirm that you have the front-end template file (usually located in/templatedirectory, and use.htmlsuffix, referencedesign-convention.mdDid you use the contact tags provided by AnQiCMS correctly in the parenthesis?
      • Search for similar{% contact with name="Cellphone" %}or{% contact with name="Address" %}code (reference)tag-contact.md).
      • ConfirmnameIs the value of the attribute consistent with the field name defined in the "Contact Information Settings" on the AnQiCMS backend (refer to the example below)help-setting-contact.md).
      • Check if there are any hardcoded old contact information in the template, and if so, replace them with dynamic tags.

  5. Review the system logs (advanced troubleshooting):If the above methods are still ineffective, the problem may be more complex. You can check the AnQiCMS runtime logs, which may reveal potential error messages.

    • Operation Instructions:AnQiCMS as a Go language application usually outputs runtime logs to the console or to a specified file (for example, in the Baota panel Go project configuration, there will be...)running.logFile, referencestart.md). Check these log files for any