In website content operations, we often encounter situations where we need to process strings, such as cleaning user input data, normalizing display content, or removing unnecessary characters and extra spaces from text.These seemingly minor operations can significantly improve the tidiness and professionalism of website content.As an AnQiCMS user, you will find that the system provides powerful and flexible template filter functions that can easily meet these string processing requirements.

AnQiCMS's template engine is built-in with various filters, allowing you to modify strings on the content display level without writing complex code. This article will focus on how to usecutandtrimA series of filters that efficiently remove specified characters from strings or handle extra spaces.

Flexible applicationcutFilter: accurately remove any specified character.

When you need to remove a specific character or phrase from any position in a string,cutThe filter is your powerful assistant. It will search for the specified "keyword" throughout the string and remove it all.

For example, suppose you import a text from a source that contains some unnecessary special characters, such as extra spaces after all periods or commas in article tags. You can usecutFilter to clean up this content.

{# 假设有一个变量 `content` 的值为 "这是,一个,带有,逗号的,字符串。" #}
{{ content|cut:"," }}
{# 输出结果将是："这是一个带有逗号的字符串。" #}

This filter can not only remove individual characters but also remove phrases. If you want to remove all occurrences of the words '安企', you just need to do this operation: 

{# 假设 `productName` 的值为 "安企CMS是一款优秀的安企建站系统。" #}
{{ productName|cut:"安企" }}
{# 输出结果将是："CMS是一款优秀的建站系统。" #}

It is worth noting that,cutThe filter is of "global" effect, it will remove all matched specified content, regardless of whether they appear at the beginning, middle, or end of the string.Therefore, make sure you really want these characters or phrases to be removed from the entire string.

Clean boundaries and extra spaces:trimSeries filter

In many scenarios, we mainly focus on irregular content at the beginning or end of strings, such as leading and trailing spaces that users may accidentally leave when entering, or unnecessary boundary symbols in some system-generated text. At this point,trimSeries filters are particularly useful. They focus on handling the boundaries of strings.

1.trimFilter: Remove leading and trailing spaces or specified characters

trimThe filter removes all spaces and new lines at the beginning and end of a string by default. This is very useful for cleaning user input or removing unnecessary whitespace when displaying data.

{# 假设 `username` 的值为 "  张三丰  " #}
{{ username|trim }}
{# 输出结果将是："张三丰" #}

Furthermore,trimThe filter can also specify the character set to be removed.It checks the beginning and end of the string and removes all characters contained in the specified character set until it encounters a character not in the character set.

{# 假设 `productCode` 的值为 "---ABC-XYZ---" #}
{{ productCode|trim:"-" }}
{# 输出结果将是："ABC-XYZ" #}

2.trimLeftFilter: Only remove leading spaces or specified characters

If you only need to handle the irregular content on the left (the beginning) of a string, for example, a product title may contain a prefix that you do not want to display,trimLeftthe filter can come in handy. It works withtrimThe way it works is similar, but it only acts on the beginning part of the string.

{# 假设 `title` 的值为 "   产品名称  " #}
{{ title|trimLeft }}
{# 输出结果将是："产品名称  " #}

{# 假设 `sku` 的值为 "SKU-12345" #}
{{ sku|trimLeft:"SKU-" }}
{# 输出结果将是："12345" #}

3.trimRightFilter: Only remove trailing spaces or specified characters.

Similarly,trimRightThe filter is specifically used to clean up irregular content at the end of a string.

{# 假设 `description` 的值为 "这是一段描述内容。 " #}
{{ description|trimRight }}
{# 输出结果将是："这是一段描述内容。" #}

{# 假设 `fileName` 的值为 "document.pdf.bak" #}
{{ fileName|trimRight:".bak" }}
{# 输出结果将是："document.pdf" #}

When to use which method?

SelectcutOrtrimA series of filters, depending on your specific needs:

  • Usecut:When you need to remove all occurrences of a specific character or phrase from any position in a string. For example, to remove all HTML tags from an article (although there are usually more professional filters likestriptags), or remove all delimiters from specific product codes.
  • UsetrimSeries:When you are mainly concerned with the cleaning of the string edges.For example, remove leading and trailing spaces from user input text, clean up the slashes at the beginning and end of URL paths, or remove specific identifiers from the beginning and end of filenames.

By flexibly combining these filters, you can achieve powerful string processing functionality in AnQiCMS, keeping your website content in **status**. These filters only take effect when displayed on the page and will not modify the original data in your database. You can safely try and adjust them.

Frequently Asked Questions (FAQ)

Q1:cutFilters andtrimWhat are the main differences of the filter?

cutThe filter will be applied to the string'sany positionRemove all matched specified characters or phrases.trimSeries filters(trim/trimLeft/trimRightIt only focuses on the string'sstart and/or end, remove the specified characters or spaces. Simply put,cutis globaltrimis boundary-based.

Q2: I want to remove multiple consecutive spaces in a string, leaving only one space, can these filters do that?

cutFilter if you use to remove spaces (|cut:" "It will remove all spaces in a string, not shorten multiple consecutive spaces into one.AnQiCMS's built-in filters do not currently provide a single function to condense multiple consecutive spaces into one.If you have this requirement, you may need to process it through front-end JavaScript or standardize it at the data entry stage to ensure the cleanliness of the data source.

Q3: Will using these filters for string operations change the original data I saved in the AnQiCMS backend?

I won't. AnQiCMS template filters (includingcutandtrim) only take effect when the data is rendered to the web page, and they process thedisplay form of the data.The original data you save in the background (database) will remain unchanged, ensuring data integrity and traceability.You can safely use these filters to optimize the display of content.