When building website templates in AnQi CMS, the organization of template files is one of the core issues you need to pay attention to. AnQi CMS provides two main template organization modes:Folder organization modeandFlat file organization mode.These two modes have their own characteristics, and the choice will directly affect the efficiency of your template creation and the final presentation of the content.Understand their differences and impact can help you make more informed decisions based on project requirements.

Folder organization mode: structured and refined control

Folder organization mode is a hierarchical structure that is very familiar to us when we use the computer files in our daily lives.In this mode, template files are placed in different subdirectories based on the content type or function they serve.archive/The product (product) related templates are located under the directoryproduct/While the single page (page) has an independent onepage/Catalog. The system will automatically search for a matching template file in the corresponding folder based on the current content model and ID.

Impact on template creation:Using a folder organization mode, the structure of your template project will be very clear and organized. When you need to modify or add a template for a content model, you can directly locate the corresponding folder, for example, if you need to adjust the style of the article list page, you will naturally look for itarchive/list.htmlorarchive/list-{分类id}.html.This clear classification method greatly improves the maintainability and collaboration efficiency of templates for large projects or websites with multiple content models.Developers can focus on template development for specific modules, reducing the hassle of file searching and naming conflicts.list-{分类id}.html）or a specific document（bydetail-{文档ID}.html）指定专属的模板，而无需在通用模板中编写复杂的判断逻辑。

Impact on content display：

Flattened file organization mode: Simple and Quick to Get Started

In contrast to the folder organization mode, the flat file organization mode places all template files directly at the root level of the template directory. To distinguish different content types of templates, this mode relies on more strict file naming conventions, which usually use underscores (_）to connect the content model or page type with the template feature. For example, the homepage template might beindex.html，the article list page template isarchive_list.html，the product detail page template isproduct_detail.html.

Impact on template creation:For small projects, personal blogs, or websites with relatively simple content models, the flat layout may appear more concise and have a quick learning curve at the beginning.All template files are presented without exception in a directory, and the file path is also shorter.But this double-edged sword, as the content and features of the website grow, the number of template files will rapidly increase, resulting in a long and difficult-to-manage directory.You need to be very familiar with and strictly adhere to naming conventions in order to quickly find what you need among many files, otherwise you may face the困扰 of a“sea of files”.archive_list.htmlWrite more conditional judgment statements in it.{% if ... %}), to switch different display logic according to content ID or category ID, which may make a single template file bulky and complex.

Impact on content display：In terms of content display, the flat design mode usually means fewer personalized direct template files, and more reliance on conditional logic within general templates to adapt to different content display needs.For websites with simple structures and unified visual styles, this approach is not a big deal, and the page style that users see will remain highly consistent.但如果您的网站需要为不同内容（尤其是同类型内容下的不同分类）提供显著差异化的用户体验，那么扁平化模式可能会让实现变得复杂，甚至在性能上带来轻微的负担，因为每次加载模板都需要解析更多的条件判断。

How to choose the right model for you?

Choose which template organization mode to use, mainly depends on the scale of your project, content complexity, and future expansion expectations:

  • If your website is small-scale, with a single content model (such as, only articles), and no complex customization needs in the short termThen, the flat file organization mode allows you to get started quickly and maintain a simple template structure.
  • If your website has multiple content models, a complex content structure is required, to provide differentiated display for different content, or if it is expected that the website will continue to develop and grow，then the folder organization mode will be a more robust choice. It provides better scalability, maintainability, and fine-grained control, enabling your template project to stand the test of time.

The strength of Anqi CMS lies in the flexibility it provides for this choice.No matter which mode you ultimately choose, the key is to clearly plan at the beginning of the project and adhere to a set of unified organization and naming conventions, which will be the foundation for your efficient website operation.

Common Questions (FAQ)

  1. Does folder organization mode mean that my website URL structure will also be hierarchical?No, the organization pattern of the template is relatively independent from the final URL structure of your website (such as whether it includes directory levels, whether it is pseudo-static, etc.).URL structure is mainly controlled by the "pseudo-static rules" function of the Aanqi CMS background.You can choose folder mode to organize templates, but configure flat URLs through pseudo-static rules, vice versa.The template organization is more about considering development and maintenance efficiency.

  2. Can I use both organization modes at the same time in the same security CMS website?In general, a template package (i.e.,/templateThe content under the directory contains a specific template theme) and will follow a unified organization pattern.The design of AnQi CMS encourages the use of consistent patterns within the same template to ensure system stability and the accuracy of template parsing.If you need the advantages of both modes, it is recommended to choose the folder organization mode, as it provides more powerful fine-grained customization capabilities, which can simulate some flatness with different subfolders and naming conventions, while retaining the advantages of hierarchical structure.

  3. If I chose the flat mode but later the website grew larger, can I switch to the folder mode?Can be switched, but it is a process that requires manual operation.This means you need to recreate the folder structure, and move the original flattened template files to the corresponding folders according to the new naming conventions, and modify their filenames.This process requires attention to detail and patience, especially for websites with many template files.Therefore, choosing an appropriate model based on the forecast of future development at the early stage of the project can effectively avoid unnecessary refactoring work in the later stage.