AnQiCMS navigation tag mystery: default navigation behavior parsing when 'typeId' is not specified

In website operation, the navigation system is undoubtedly the cornerstone of user experience and information architecture.An well-designed, logically clear navigation can guide users to quickly find the information they need, enhancing the overall usability of the website.AutoCMS (AutoCMS) is a powerful and flexible content management system that provides intuitive template tags, allowing developers and operators to easily build complex navigation structures.

Among them,navListTags are the core tools used in the AnQiCMS template engine to obtain the page navigation list.It allows us to selectively call from the flexible configuration of multiple navigation categories from the background as needed.navListwhen a tag is used, if it is inadvertently or intentionally not specifiedtypeIdParameters, which navigation list will the system call by default? As an experienced website operation expert, today I will deeply analyze the mechanism of AnQiCMS for everyone.

RevealnavListThe core function of the tag

First, let's briefly review.navListThe function of the label. According to the AnQiCMS documentation,navListThe main function of the label is to "get the page navigation list". Its basic usage is like this:{% navList navs %}...{% endnavList %}. Through this tag, we can iterate through the navigation data configured in the background to build the top menu, sidebar menu, or footer links of the website.

typeId参数：Navigation category “ID card”

InnavListAmong many parameters of the tag,typeIdPlaying a crucial role.It is actually the unique identifier for the background 'Navigation Category'.In AnQiCMS backend management system, you can create and manage multiple navigation categories under the 'Website Navigation Settings' feature module.typeId，used to distinguish different navigation groups, such as “main navigation”, “footer navigation”, “sidebar navigation”, and so on. When we call in the template,navListand specifytypeIdfor example,{% navList navs with typeId=2 %}，system will accurately call the link list contained in the navigation category with ID2.

Default behavior:typeId=1of the "default navigation"

then,navListthe tag is not explicitly specifiedtypeIdWhat will the system do? The answer is hidden in the design philosophy of AnQiCMS:IfnavListTag not specifiedtypeId, it will default to callingtypeId=1the corresponding navigation list.

This means that in the AnQiCMS backend management system, you can usually find the 'Navigation Category Management' under the 'Website Navigation Settings' feature module. The system will automatically create a category named 'Default Navigation' during the initial installation, and it'stypeId通常被设定为1。因此，如果您在模板中仅使用{% navList navs %}，而不带任何typeId参数，AnQiCMS就会智能地去获取并渲染这个typeId=1的“默认导航”列表。

The actual effect of this default behavior

Understanding this default behavior is of great significance for template development and daily operations.

  1. Simplifying development and maintenance:For websites that need only one primary navigation or do not want to make fine-grained navigation category distinctions, this default mechanism greatly simplifies the template code. Developers do not need to explicitly specify it each time.typeIdEnglish translation: Can be used directly in the simplest formnavListLabel.
  2. Ensure basic functionality:Even during the template development process, some navigation tagstypeIdThe core navigation system of the website is usually able to revert to the default settings, preventing a complete crash, thus ensuring the basic accessibility of the website.
  3. Potential configuration risks:However, if the background'stypeId=1“Default navigation” is incorrectly modified, deleted, or its content is not what you expect when not specifiedtypeIdThis content is displayed at the time, the website front-end may appear unexpected navigation structure, even missing navigation. This requires operational personnel to manage the default navigation category with caution.typeId=1This default navigation category should be managed with caution.

**Practical Suggestions

To ensure the clarity and maintainability of the template, and to avoid potential confusion, senior operation experts usually suggest thatnavListwhen labeling, specify as clearly as possibletypeIdParameter. Unless you are one hundred percent sure that you need to call the default navigation and its content is as expected, otherwise明确的typeIdcan avoid the trouble of later debugging and make the template intention clearer.

For example, if you have a main navigation, even if it corresponds totypeId=1it is recommended to be written as{% navList mainNavs with typeId=1 %}. This makes the code more readable and easier to track and manage different navigations.

Summary

In summary, the value of AnQiCMS'snavListlabels are not specifiedtypeIdautotypeId=1The “default navigation” list.Understand and make good use of this default mechanism, which can help you develop templates and manage content for the AnQiCMS website more efficiently, and also better avoid potential configuration risks.Between flexibility and simplicity, AnQiCMS provides a clever balance point, and mastering these details is the key to becoming an excellent website operation expert.

Common Questions (FAQ)

autotypeId=1autonavListauto

A1:If the default navigation is deleted, the system may not be able to find the corresponding navigation list data, which may cause the template to callnavListLabel output is empty, or the display logic for empty data according to the template produces different display effects (for example, displaying 'No navigation items' or not displaying any content at all).To avoid such problems, it is not recommended to arbitrarily delete the default navigation, or to make appropriate judgments and treatments when the navigation data is empty in the template.

Q2: How can I call another navigation list on the page, excluding the 'default navigation'?

A2:Firstly, you need to create a new navigation category (for example, named "Footer Navigation") under the "Website Navigation Settings" -> "Navigation Category Management" in the AnQiCMS backend, and the system will automatically assign it a uniquetypeId[for example]typeId=2）。接着，in English，the navigation location needs to be explicitly specified in your website template.typeIdparameter to call, for example:{% navList footerNavs with typeId=2 %}...{% endnavList %}.

Q3:siteIdParameter innavListwhat role does it play? It will affecttypeIdthe default behavior?

A3: siteIdThe parameter is mainly used for the multi-site management scenario of AnQiCMS. It allows you to call the specifiedsiteId(other sites) navigation data.siteIdThe parameter will not changetypeIdThe default value. This means that if you only specifynavListinsiteIdand do not specifytypeId, the system will use thesiteIdspecified target site through the parametertypeId=1Navigation list data retrieval. If neither is specified, then from the current site'stypeId=1Navigation list retrieval.