In the AnQiCMS document list, what do the `images`, `logo`, and `thumb` fields represent, and how should they be used?

When using AnQi CMS to manage website content, we often encounter scenarios involving image upload and display. In document structures (articles, products, etc.), categories, and even single pages,images/logoandthumbThese fields play different roles, working together to support the effective presentation and performance optimization of the website's visual content.Understanding their specific purpose can help us better plan content and optimize the user experience.

images: Multiple images display and rich content

imagesThe field is usually an array of image links (string[]Type), it is mainly used to store and display multiple images associated with specific content.Imagine you are releasing a product, you may need to show detailed images from different angles;Or when writing a travel diary, you want to use multiple photos to link the entire journey. At this time,imagesThe field is your ideal choice.

In Anqi CMS, when you publish through the interface (such asarchivePublishUpload a set of images toimageswhen the field is set, the system will intelligently use this image arraythe firstimage as the default for the contentlogo. This meansimagesIt not only provided a visual gallery but also indirectly determined the cover image of the content.

Actual application scenarios:

• Article detail page:Displaying article illustrations and albums.
• Product details page:Displaying multi-angle, multi-detail images of the product.
• Category or Single Page:If you need multiple images to be rotated as the page top Banner,imagesthe field can also be used.

Rational utilizationimagesThe field can greatly enrich the visual content of the page, providing users with more comprehensive information and a more immersive browsing experience.

logo: Main visual identifier

logoThe field is a single image link (stringType), it represents the contentmain visual identifierorCover image. It is usually the image you want to be displayed on various list pages, recommendation spots, or as the default content display image.

As mentioned earlier, if you provide the content when it is publishedimagesthenimagesthe first image in the array will be automatically designated aslogoOf course, you can also upload a single image aslogoThis will also provide a clear visual theme even without the need for multiple images.attachmentUploadIn the returned parameters of the interface,logoClearly marked as "Original", this indicates that it often refers to the original, uncompressed, or unadjusted main image.

Actual application scenarios:

• List page thumbnail:On article lists, product lists, and other pages,logoIt can be used as a direct display for each piece of content.
• Share card:When sharing on social media,logoit is often captured as the image of the shared content.
• Content cover:Identify the theme of the article, product, or category, enhancing recognition.
• Site Logo:In the system settings, it represents the brand image of the entire website.

logoThe importance of the field lies in its uniqueness and representativeness; it is the core visual element for the identification and dissemination of content across different scenarios.

thumb: Optimize the loading of thumbnails

thumbField is also a single image link (stringtype), but it differs fromlogomain distinction lies in itsoptimization purpose.thumbIslogoor other main images generated after system processingThumbnailVersion. This process typically includes image resizing, compression, and may even include watermark addition, with the core goal of accelerating web page loading speed and reducing user waiting time.

InattachmentUploadIn the returned parameters of the interface,thumbIt is explicitly marked as a "thumbnail". This means that when you upload an image, the system will not only store the original image (i.e.logo), but will also automatically generate an optimized one.thumb.For most websites, displaying a large list of content on a page (such as news lists, product categories) by directly loading high-definition images can severely affect page performance, and usingthumbIt can significantly improve user experience.

Actual application scenarios:

• List page, search results:Use when displaying content overviewthumbCan load quickly, save bandwidth.
• Mobile page:The mobile network environment is complex, loading small sizethumbCan greatly improve response speed.
• Related recommendation module:When recommending related content at the bottom or side of the article, usethumbIt can attract attention without occupying too many resources.

thumbThe field is a key factor in website performance optimization, ensuring that it balances visual richness with loading efficiency and user experience.

Summary

In AnQi CMS,imagesThe field is used to manage a group of images, providing rich visual content;logoThe field represents the original or main cover image of the content, which is the core visual identification of the content; whilethumbThe field islogoThe optimized version, designed to enhance page loading speed and user experience. The three work together to build a powerful and flexible image management and display mechanism for Anqi CMS.

Frequently Asked Questions (FAQ)

1.logoandthumbIt seems that all are links to images, what are the essential differences? logoThey usually point to the original or main image of the content, representing the "face" and main visual information of the content. AndthumbIs determined automatically by the system according tologoA thumbnail version generated, after size reduction and compression. The essential difference lies in the size and optimization level:thumbAims to load quickly, often used on list pages;logoIt is the original material, often used on detail pages or when high-definition display is required.

2. When publishing documents, I should upload them at the same time.imagesandlogo?In most cases, you just need to uploadimagesthe array. Anqi CMS will default toimagesin the array,the first imageautomatically as the document'slogo. If you are not satisfied with this automatically generatedlogoNot satisfied, or if you want to specify a particular cover image without displaying multiple images, you can directly specifylogoan image URL in the field.

3. Anqiy CMS will automatically generate for me.thumbDo you want a thumbnail? If I'm not satisfied with the automatically generated one?thumbWhat should I do?Yes, when you upload an image (whether it's throughimagesor directly specifylogo), Anqi CMS will usually base onlogoGenerate one or more automaticallythumbThumbnail version. According to the existing documents, the details and the list returned in it.thumbIt is automatically generated. If you want to have more precise control over the thumbnails, for example, custom cropping or processing, this may require going through the image upload interface (attachmentUpload), when uploading it directly, it uses the returned onethumbURL, or after content is published, global adjustments to thumbnail size can be made via the backend, but it is usually not possible to manually specify for individual articlesthumbThe specific link, unless customized development or throughlogoThe replacement to indirectly influencethumbThe regeneration.