How can you determine which category list template file is being used on the current page?

As a senior website operation expert, I know how important it is to understand the underlying logic of the page when managing the content system.Especially when it comes to website customization, function expansion, or daily maintenance, quickly locating the template file being used can greatly improve efficiency.Today, let's delve into how to accurately determine which category list template file is being used on the current page in AnQiCMS (AnQiCMS).

A security CMS with its flexible content model and powerful template system makes website design effortless.This also hides a set of strict template search mechanisms. Understanding this mechanism is the key to your efficient website operation.

Anqi CMS template file search mechanism: a step-by-step logic

The Anqi CMS does not choose templates randomly, but follows a clear, step-by-step search logic.When a user visits a category list page, the system will search for the most matching template file according to certain priority.

First, the most basic judgment is based onContent modelIn AnQi CMS, each category belongs to a specific content model (such as article model, product model, etc.).Therefore, the naming of classification list templates usually includes the name of the model it belongs to.

1. The default naming rule is basic:

The AnqiCMS provides a set of default naming conventions that allow the system to find the corresponding templates even without additional settings. This set of rules mainly has two forms:

• Universal Category List Template:For a classification list page of a certain content model, AnQi CMS will first try to find a universal list template named after the model table name. For example, if your classification belongs to the "Article" model (the model table name is usuallyarticle），The system will search forarticle/list.htmlfile. If it belongs to the "product" model (the model table name is usuallyproduct)，it will search forproduct/list.html. This provides a default display style at the model level.
• Specific category ID template:To achieve finer control, Anqi CMS also supports setting unique list templates for each specific category. The system will try to find the format of{模型table}/list-{分类id}.htmla file. For example, if a category's ID is123and it belongs to the 'Article' model, then the system will try to findarticle/list-123.htmlIf the file is found, it will take precedence over the generalarticle/list.htmlis used.

Whether your template uses the "folder organization mode" or the "flat file organization mode", the naming logic above is consistent, but the file storage path is slightly different (for example, in the flat mode it may be possible toarticle_list.htmlorarticle_list-123.html)

2. Back-end settings: The power of customization

However, Anqi CMS gives operators greater flexibility. You can manage the back-end interface, foreach specific categoryManually specify a category list template file.

Log in to the backend and navigate to “Content Management” -> “Document Categories”, edit a specific category, and you will find an input box named “Category Template” in the “Other Parameters” section. Here, you can enter any template filename you wish to use, for exampledownload.htmlor even more specificmy_custom_category_list.html.

Important reminder:This template specified manually in the background has priorityhigher thanAll default naming rules mentioned previously. This means that if a category is explicitly specified in the backgrounddownload.htmlas its list template, then even if there isarticle/list-123.htmlorarticle/list.html, the system will choose without hesitation.download.htmlTo render the page. This is like issuing a special pass for a specific category, indicating its exclusive display method.

In addition, there is also an option in the category settings to 'Apply to subcategories'.If it is checked, all subcategories under the current category (if no separate template is specified) will inherit the use of this custom category template, which is very useful for unifying the display style of a series of categories.

3. Mobile template: Details not to be overlooked.

With the popularity of mobile devices, the importance of mobile experience is self-evident.AnQi CMS also fully considers this point. If your website has enabled the PC + mobile independent site mode, and there ismobile/The template directory, then the system will prioritize in searching for templatesmobile/The directory follows the same search logic as mentioned above. That is, whether it is the default naming rule or the backend custom settings, it will first try to find inmobile/Search for the corresponding template file in the directory, and only if not found will it revert to the template on the PC.

Actual operation: How to quickly locate the template file?

When you are facing a category list page and want to know which template file it actually uses, you can follow the following steps to investigate:

1. Firstly, check the backend category settings:The most direct and authoritative way is to log in to the Anqi CMS backend.Find the category of the current page and enter its editing page.In the "Other Parameters" section, check the "Category Template" field. If you enter a specific template file name here, then congrats, this is the template currently being used on this page.
2. Check specific category ID template:If the 'category template' field in the background is empty, then you need to determine the content model of the category (for examplearticleorproduct) and category ID. Then, look for it in your template directory.{模型table}/list-{分类id}.htmlsuch a file.
3. Return to the general category list template:If neither of the above two cases apply, the system is likely using the universal list template of the content model. You need to search for{模型table}/list.htmlfile.
4. Don't forget the mobile version:If you are visiting the website on a mobile device**or the website supports PC+mobile independent site mode, please make sure to first inmobile/the directory according to the above steps search.

Understanding this search mechanism not only helps you quickly locate files for modification, but also allows you to have a clear mind and control when designing the structure and content display of the website.

Why understanding this logic is crucial?

• Precise customization:You can design a unique layout for a specific category without affecting other categories.
• Efficient maintenance:When the page encounters problems or needs adjustments, it can quickly locate the source file, saving precious time.
• Expansion upgrade:When introducing new features or plugins, a clear template structure makes integration work smoother.
• SEO optimization:Keep the template structure clear and naming conventions, which also helps search engines better understand and crawl your website content.

Mastering the search logic of Anqi CMS templates is a必修 course for you to become an excellent website operator.I hope this article can lift the veil of mystery of template search for you, making your operation work more skillful.

Frequently Asked Questions (FAQ)

Q1: Why did I change it?article/list.htmlBut the article list page on the website did not change?

A1: This is likely due to the following two situations: first, the page you are visiting may not be a general article list, but a list page of a specific category, and this category is specified in the background "category template" settings to use other template files (such asmy_article_list.html），or there is a higher priority onearticle/list-{分类id}.htmlFile. Secondly, the Anqi CMS may have a caching mechanism. After modifying the file, please try to clear the system cache (usually there is a "Update Cache" function in the background), and clear the browser cache before viewing.

Q2: Can I use a completely different list template for different content models (such as articles and products)?

A2: Of course you can. The template search mechanism of AnQi CMS is designed specifically for this. You just need to create corresponding general list templates for different content models, such asarticle/list.htmlused for article lists,product/list.htmlUsed for product list. If a more detailed distinction is needed, you can also specify an independent template file for each specific category under each category model in the background.

Q3: What will happen if a custom template filename is set in the category settings of the background, but the file does not exist in the actual template directory?

A3: If you specify a non-existent template file in the background, when the user accesses the category list page, the system will error out because it cannot find the specified template, which will usually display an error page (such as a 404 or 500 error), causing the page to fail to load normally.Therefore, after customizing the template filename in the background, please make sure that the file has been uploaded and placed in the template directory correctly.