How to apply TDK filters provided by AnQiCMS, such as `truncatechars`, to control the length of Description?
As an expert in the operation of AanQin CMS, I fully understand the importance of TDK (Title, Description, Keywords) for the performance of a website in search engines and the attractiveness to users' clicks.Description tag, serving as a summary below the title on the search engine results page (SERP), its length directly affects the first impression of the user on the content and their willingness to click.Too long to be truncated, cannot convey the information completely; too short may be contentless and lack吸引力.Our Anqi CMS provides powerful template tags and filters, allowing us to precisely control the display length of Description.
Precisely control the length of Description: AnQi CMS TDK filter application
In Anqi CMS, the TDK information of the website can be set in various ways, whether it is the global homepage TDK or the dynamic TDK for articles, categories, single pages, and other content. These contents will eventually be output to the web page through template tags.<head>The area is for search engine reading. However, the Description content entered in the background may be longer than the actual display length of the search engine. To optimize the SERP display effect, we need to use the length limiter provided by the Anqi CMS filter.
The Anqi CMS template engine supports filters similar to Django template syntax, which provides great convenience for refined content output. Among them,truncatecharsThe filter is exactly used to control the number of characters in a string accurately.
truncatecharsThe mechanism of the filter's function
truncatecharsThe filter is designed to truncate a string to a specified number of characters. When the number of characters in the original string exceeds the limit we set,truncatecharsIt will automatically truncate the excess part and add an ellipsis at the end of the string...), to indicate that the content has been truncated. This approach ensures the conciseness of the Description while suggesting that users can click to view more content, in line with search engines' recommendations for Description length.
For example, if we want to limit the Description to 150 characters,truncatechars:150It can achieve this purpose. It will calculate all characters in the string (including spaces and punctuation) and truncate when it reaches 150 characters.
how to converttruncatecharsApply to Description length control
In the Anqi CMS template, Description is usually throughtdktags to call.tdkThe tag is a universal TDK tag that can intelligently output the corresponding Title, Keywords, and Description based on the type of the current page (home page, article detail page, category list page, etc).
Apply to DescriptiontruncatecharsFilter, we can call in thetdkApply the filter directly when the tag output Description. Here is the specific application method:
First, in your template file (for examplebase.htmlOr the specific article/categorization template) of<head>The area where the Description output is found. It will usually be like this:
<meta name="description" content="{% tdk with name="Description" %}">
To control its length, we can apply it directly totdkthe output result of the tagtruncatecharsFilter. Assuming we want the Description to be no longer than 150 characters, we can modify it like this:
<meta name="description" content="{% tdk with name="Description" %}|truncatechars:150">
Or, for better readability, you can also changetdkLabel the output content and then apply a filter to the variable:
{% tdk seoDescription with name="Description" %}
<meta name="description" content="{{ seoDescription|truncatechars:150 }}">
In these two methods,truncatechars:150Ensure that the Description content rendered in the HTML is truncated when it exceeds 150 characters and accompanied by an ellipsis. For example, if the original Description is 'This is a very long description text, which contains many details intended to attract users to click and learn more, but may be too long for search engines', aftertruncatechars:150After processing, it may display as “This is a very very long description text, which contains many details, intended to attract users to click and learn more, but may be too long for search engines…”
**Practice and Precautions
While usingtruncatecharsPerform Description length control and follow these practices:
- Refer to SEO length: There is a difference in the display length of Description by search engines, but it is generally recommended to control it within 120-160 characters. You can adjust it based on the target search engine and actual test results.
truncatecharsthe parameter. - Content core in front: Ensure the most important information and keywords of the Description are within the first 120 characters, even if truncated, so that the core selling points can be seen by the user.
- Keep semantic integrity: Try to avoid cutting off key information in the middle. When editing the Description in the background, it's best to estimate the display length so that truncation occurs in a place with relatively complete semantics. Although
truncatecharsIt is truncated by characters, but good original copy can reduce the abruptness after truncation. - Unified application across the entire site.: To maintain the professionalism and consistency of the website, it is recommended to apply the same length control strategy to all dynamically generated Descriptions.
- Browser and device testingAfter applying, make sure to test the page display effect on different browsers and mobile devices, and check if the Description in the SERP of the search engine simulator meets expectations.
Provided by Anqi CMStruncatecharsThe filter allows us to effectively optimize the display of Description, ensuring it is concise and attractive in search engine results, thereby improving the website's SEO performance and click-through rate.
Frequently Asked Questions (FAQ)
Q1: UsetruncatecharsDoes truncating the Description filter affect the original Description content stored on the back-end?A1: No.truncatecharsThe filter only processes the output string at template rendering time; it does not modify the original Description content stored in the database.When editing and viewing the Description in the background, it is still complete and not truncated.
Q2: BesidestruncatecharsDo you have any other filters in AnQi CMS that can control the length of the Description?A2: Yes. If you want to truncate Description by word instead of character, you can usetruncatewordsFilter. For example,{{ seoDescription|truncatewords:20 }}It will truncate to 20 words. Additionally, if the Description content contains HTML tags and you wish to retain the HTML structure when truncating, you can usetruncatechars_htmlortruncatewords_htmlThey will intelligently handle HTML tags to prevent truncation and damage to the page structure. But usually, the Description content should be plain text, sotruncatecharsmore commonly used.
Q3: How to know the length of Description so as to settruncatecharsthe parameter?A3: The length of the description is not constant, it is affected by the search engine algorithm and the size of the device screen. Generally, it is recommended totruncatecharsThe parameter is set between 120 and 160. You can view the display status of competitors' Description by searching for keywords, or use tools like Google Search Console to view the actual display effect.On mobile devices, the number of characters displayed is usually fewer, so setting it conservatively at 120-130 characters is a safe starting point.Regularly check and adjust based on data feedback is**practice.