In managing content in AnQi CMS, we often encounter questions about image fields, especiallylogoandthumbthese two fields, they are in the document details interfacearchiveDetailAll of them involve the representation of images, but the actual use and meaning have subtle yet important differences.Understanding the differences can help us better optimize the visual presentation and loading performance of the website.

logo字段：文档的“身份名片”

当我们谈到logoWhen a field is mentioned, it usually refers to the main and representative image of the document.You can imagine it as the main visual image of an article or a product, just like a brand's logo, it is the first impression of the content.

在实际操作中，logo字段往往承载着以下职责：

  • 主要展示图片：In the document detail page,logothe field usually provides a relatively complete and high-definition image, used to display the core content of the article or product.
  • the preferred image in the content management system:When publishing or editing documents, you may upload multiple images. Safe CMS usually uses thethe first imageimages you explicitly specify as 'main image' as the main image of thelogo。It represents the document's 'cover'.
  • Specified thumbnail at import:Even when importing documents,logoThe field is also defined as "Document thumbnail", which means it may not be the original image but the main visual image specified by the user.
  • Visual identifier for categories:For categories (categoryDetail), logoThe field also plays a similar role, being a visual identifier for categories, although it may be empty in the actual return, and relies more onthumb.

In simple terms,logois the "large picture" or "main picture" that you hope users will see first when viewing the document. It is more focused onthe core identification of the content.

thumbfield: the "behind-the-scenes hero" of performance optimization

whilethumbfield, full name is "thumbnail", as the name implies, it represents theThumbnail.logoCompared to,thumbcore value lies inoptimization of website performance and the adaptability of page layout.

thumbThe characteristics of the field are reflected in:

  • System automatically generated:In most cases,thumbIt is generated according to the Anqi CMS system:logo(or other images within the document) automatically cropped and compressed to meet different display requirements. At the image upload interface (attachmentUpload）的返回示例中，我们可以清晰地看到上传的原图（)logo字段（auto）和系统自动生成的缩略图（auto）的区别，缩略图的URL通常会带有thumb字段（auto）的thumb_Prefix.
  • Small size, low resolution: thumbThe size is smaller, and the file size is optimized, aimed at quick loading and reducing user waiting time.
  • Commonly used on list pages and recommendation slots:In the places where a large number of images need to be displayed, such as the article list page, related recommendations, and search results, usethumbCan greatly improve page loading speed while maintaining the neatness and consistency of the page layout.
  • Default selection for category list:In the return data of category details or category list,thumbField evenlogois empty, and it is often possible to see athumb_prefix picture URL, which further indicates thatthumbis a default and optimized way of displaying pictures provided by the system.

Therefore,thumbField is provided by the system toEnhance user experience and website loading efficiencyThe automatically processed image version, it focuses more onFunctionality and performance.

Core Difference Summary

Although in some cases,logoandthumbThe URL looks very similar, even pointing to different size versions of the same image, but theirdesign intent and recommended usageare different:

  1. Different purposes: logointended to be used as contentMain visual identifier，Convey core information.thumbis used forPerformance optimization and layout display，Provide quick loading small size images.
  2. Source and processing methods are different: logoIt is usually the original image uploaded by the user or the specified main image.thumbwhich is based on the systemlogoautomatically processed (cropped, compressed) to generateoptimized version.thumbThe image link usually hasthumb_such a prefix, indicating that this is a processed thumbnail.
  3. Different use cases:When displaying a large image on the document detail page, it will be used preferentially.logo. And in scenarios that require quick loading and uniform size, such as list pages, recommended positions, and sidebars,thumbit is a more ideal choice.

Understood this, we can make more targeted choices for the appropriate image fields when doing website content operation and frontend development, ensuring both the visual appeal of the content and the performance of the website, providing users with a smooth browsing experience.

Common Questions (FAQ)

Q1: In the security CMS, what size of image should I upload as the document?logoWhat is the appropriate size?

A1: To ensure the clarity of the image on the detail page and its display effect on different devices, it is recommended to upload images with high quality and moderate size aslogo。The specific size depends on your website design and theme requirements, but it is usually recommended to be between 800px and 1200px wide, and the file size should not be too large (for example, controlled within a few hundred KB), so that it can be automatically generated by the systemthumbauto