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 modeThese two patterns have their own characteristics, and the choice will directly affect the efficiency of your template creation and the presentation of the final content.Understand the differences and impacts, which can help you make more informed decisions based on your project needs.
Folder organization mode: Structured and refined control
A folder organization pattern is a hierarchical structure that is very familiar to us when we use 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.For example, the templates related to articles (archives) may be locatedarchive/Under the directory, the templates related to product (product) are locatedproduct/Under the directory, while the single page (page) has an independentpage/The catalog. The system will automatically go to the corresponding folder to find the matching template file 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 of a content model, you can directly locate to the corresponding folder, for example, if you want to adjust the style of the article list page, you will naturally go to look for itarchive/list.htmlorarchive/list-{分类id}.htmlThis clear classification method greatly improves the maintainability and collaboration efficiency of websites for large projects or those with multiple content models.Developers can focus on template development for specific modules, reducing the hassle of file searching and naming conflicts.Moreover, it naturally supports more granular template customization, such as for a specific category (vialist-{分类id}.html）or a specific document（throughdetail-{文档ID}.html）specify a dedicated template without writing complex judgment logic in the general template.
Impact on content display：On the content display level, the folder organization mode gives you high flexibility and fine-grained control capabilities.You can easily design completely different layouts and styles for different types of content models (such as articles, products, cases) because they have independent template files.It is more important that, by convention, you can make the system use a unique display template for all content under a specific category or for a specific single page, which is a very powerful feature for websites that need highly customized content display, such as product category pages requiring special filters, or an event page needing a unique visual design.This means that the website's front-end can present a diverse and precise visual experience based on the type and properties of the back-end content, making the user feel the professionalism and specificity of the content.
Flattened file organization mode: Simplified and Quick Start
Compared 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 between templates of different content types, this mode relies on stricter file naming conventions, usually using underscores (_Connect content models or page types to template functionality. For example, the home page template might beindex.html, article list page template isarchive_list.html, product detail page template isproduct_detail.html.
Impact on template creation:For small projects, personal blogs, or websites with relatively simple content models, a flat structure may appear more concise and have a quick learning curve in the early stages.All template files are presented in a directory without reservation, and the file path is also shorter.But this double-edged sword, as the content and functions of the website grow, the number of template files will increase rapidly, making the directory long and difficult to manage.You need to be very familiar with and strictly adhere to the naming conventions, so that you can quickly find what you need among many files, otherwise you may face the trouble of being overwhelmed by 'a sea of files'.Moreover, the flattened mode often needs to return to the general template when implementing fine-grained customization for specific categories or documents (such asarchive_list.html(Write more conditional judgment statements here){% if ... %}), to switch different display logic based on content ID or category ID, which may lead to a single template file becoming bulky and complex.
Impact on content display：In terms of content display, the flat design model usually means fewer personalized direct template files, and more reliance on conditional logic within general templates to adapt to different display needs.For websites with simple structure and uniform visual style, this approach is no problem, the page style seen by users will remain highly consistent.But if your website needs to provide a significantly differentiated user experience for different content (especially different categories under the same type of content), the flat mode may make implementation complex, and even bring a slight burden on performance, because each time the template is loaded, more conditional judgments need to be parsed.
How to choose a suitable model for you?
Choose which template organization mode to use, mainly depending on the scale of your project, the complexity of the content, and future expansion expectations:
- If your website is small-scale, has a single content model (such as, only articles), and does not have complex customization needs in the short termThen the flattened file organization mode can help you get started quickly, keeping the template structure simple.
- If your website has multiple content models, the content structure is complex, and you need to provide differentiated display for different content, or if it is expected that the website will continue to grow in the futureThen the folder organization mode will be a more stable choice. It provides better scalability, maintainability, and fine-grained control, allowing your template project to withstand the test of time.
The strength of AnQi CMS lies in the flexibility it provides for this choice.No matter which model you ultimately choose, the key is to plan clearly at the beginning of the project and adhere to a unified organization and naming convention, which will be the foundation for your efficient website operation.
Frequently Asked Questions (FAQ)
Does folder organization mode mean that my website URL structure will also be hierarchical?No, the organizational pattern of the template is relatively independent from the final URL structure of your website (such as whether it contains directory levels, whether it is static, etc.)The structure of the URL is mainly controlled by the 'pseudo-static rules' function of the AnQi CMS backend.You can choose the folder mode to organize templates, but configure a flat URL through pseudo-static rules, and vice versa.The template organization is more about considering development and maintenance efficiency.
Can I use these two organization modes simultaneously on the same AnQi CMS website?In general, a template package is
/templateA specific template theme under the directory 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 accuracy in template parsing.If you need the advantages of two modes, it is recommended to choose the folder organization mode, as it provides more powerful fine-grained customization capabilities, which can simulate some flat simplicity through different subfolders and naming conventions, while retaining the advantages of hierarchical structure.If I choose the flattened mode, but the website has grown later, can I switch to folder mode?Can switch, but this is a process that requires manual operation.This means you need to recreate the folder structure, and according to the new naming convention, move the original flattened template files to the corresponding folders and change their filenames.This process requires meticulousness 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 later.