As a senior website operations 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 in use 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).
The Anqi CMS, with its flexible content model and powerful template system, makes website design a breeze.But this also hides a set of rigorous template search mechanisms. Understanding this mechanism is the key to your efficient website operation.
Anqi CMS template file search mechanism: a logical progression
AutoCMS is not a random choice of template, but follows a clear, step-by-step search logic.When the user accesses a category list page, the system will search for the most matching template file according to a certain priority.
First, the most basic judgment is based onContent Model.In the Aanqi CMS, each category belongs to a specific content model (such as article model, product model, etc.).Therefore, the naming of the classification list template usually includes the name of the model it belongs to.
1. The default naming rule is basic:
The AutoCMS provides a set of default naming conventions, allowing the system to find the corresponding templates even without additional settings. This rule mainly has two forms:
- General category list template:For a category list page of a certain content model, the Anqi CMS will first try to find a general list template named after the model table name. For example, if your category belongs to the 'article' model (the model table name is usually
article），The system will searcharticle/list.htmlfile. If it belongs to the "product" model (the model table name is usuallyproduct），it will searchproduct/list.html. This provides a default display style at the model level. - Specific Category ID Template:To achieve more fine-grained control, the security CMS also supports setting unique list templates for each specific category. The system will try to find the format of
{模型table}/list-{分类id}.htmlThe file. For example, if a category's ID is123, and it belongs to the "article" model, the system will try to findarticle/list-123.htmlIf this file is found, it will take precedence over the generalarticle/list.htmlis used.
No matter your template uses the "folder organization mode" or the "flattened file organization mode", the naming logic is consistent; it is just the file storage path that differs slightly (for example, in the flattened mode it might be)article_list.htmlorarticle_list-123.html).
2. Backend settings: The power of customization
However, Anqi CMS gives operators greater flexibility. You can manage in the backend interface,for each specific categoryManually specify a list template file for a category.
In the background, go 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, such asdownload.htmlor even more specificmy_custom_category_list.html.
Important reminder:This template specified manually in the background, its priorityis higherAll default naming rules mentioned earlier. 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 not hesitate to choosedownload.htmlRender the page. It's like issuing a 'special pass' for a specific category, indicating its exclusive display method.
Moreover, there is an option 'Apply to subcategories' in the classification settings.If this option is checked, all subcategories under the current category (if no separate template is specified) will inherit the use of this custom category template. This is very useful for unifying the display style of a series of category categories.
3. Mobile Template: Details Not to Be Overlooked
With the popularity of mobile devices, the importance of mobile experience is self-evident.The Anqi CMS also fully considers this point.mobile/Template directory, so the system will prioritize in the search for templates,mobile/The directory follows the same search logic as above. That is, whether it is the default naming rule or the background custom settings, it will first try to find inmobile/Searching for the corresponding template file in the directory, if not found, it will fall back to the PC template.
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 uses, you can follow the following steps to troubleshoot:
- First, check the backend category settings:Firstly, 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.Check the "Classification Template" field under "Other Parameters".If you specify a specific template filename here, congratulations, this is the template currently being used on the page.
- Check the 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 example
articleorproduct）and category ID. Then, check if the template exists in your template directory{模型table}/list-{分类id}.htmlSuch a file. - Roll back to the general category list template:If neither of the above two cases apply, the system is likely using the generic list template for the content model. You need to find
{模型table}/list.htmlfile. - Don't forget the mobile version:If you are browsing the website on a mobile device**or the website supports PC+mobile independent site mode, please make sure to do the following steps first.
mobile/Look for the directory as described in the above steps.
Understanding this search mechanism can not only help you quickly locate files for modification, but also enable you to have a clear思路 and control when designing website structure and content display.
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 has problems or needs adjustments, it can quickly find the source file, saving precious time.
- Expansion and upgrade:When introducing new features or plugins, a clear template structure makes integration work more smooth.
- [en] SEO Optimization:Maintain a clear template structure and naming conventions also helps search engines better understand and crawl your website content.
Mastering the search logic of the Anqi CMS template is a must-course for you to become an excellent website operator.Hope this article can lift the veil of mystery of template search and make your operation work more proficient.
Common Questions (FAQ)
Q1: Why did I modify it?article/list.htmlFile, but the article list page on the website hasn't changed?
A1:This is likely due to the following two situations: Firstly, 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 to use a different template file in the "Category Template" settings in the background (for example,my_article_list.html），or there is a higher priority onearticle/list-{分类id}.htmlFile.Secondly, the Anqi CMS may have a caching mechanism. After modifying a 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 completely different list templates for different content models (such as articles and products)?
A2：Of course, you can. The template search mechanism of AnQi CMS is designed for this. You just need to create a corresponding universal list template for different content models, for examplearticle/list.htmlfor article lists,product/list.htmlUsed for product list. If a more detailed distinction is needed, independent template files can also be specified for each specific category under each category model in the background.
Q3：If a custom template filename is set in the background category settings, but this file does not exist in the actual template directory, what will happen?
A3:If you specify a non-existent template file in the background, when the user accesses the category list page, the system will report an error due to the inability to find the specified template, usually displaying an error page (such as a 404 or 500 error), causing the page to fail to load normally.Therefore, after customizing the template file name in the background, please make sure that the file has been uploaded and placed in the template directory.