How to use the `replace` filter to replace the old word with a new word in the template?

When managing website content in AnQi CMS, we often encounter situations where we need to make minor adjustments to the text displayed in the template.Maybe the brand name needs to be updated, a keyword needs to be unified, or it's just a minor correction in display.At this time, if you always go to modify the source content, it may seem inefficient.replaceIt can help us replace strings directly in the template without modifying the original data, making our content more flexible and accurate.

Flexible applicationreplaceReplace string with filter

replaceA filter, as the name implies, is a tool used to replace specified old words (or old strings) with new words (or new strings) when outputting strings in a template.It can process the output content of template variables in real time without touching the original data stored in the database.This is very convenient for dynamically adjusting display content, or for batch and temporary modification of certain fixed text.

Its usage is very intuitive, following the general rules of Anqi CMS template filters. The basic syntax structure is as follows:

{{ 你的变量 | replace:"旧词,新词" }}

here,你的变量The text content you want to operate, it can be any output of a template variable.replaceFollowed by a colon:Then, a double-quoted string containing旧词and新词Comma separated,Separated.

Let's deepen our understanding through several specific examples. Assuming we have a variablewebsiteTitleIts value is"欢迎使用安企CMS".

Example 1: Basic replacementIf you want to replace the word “AnQi” with “AnQi”, you can write it like this:

{{ websiteTitle | replace:"安企,AnQi" }}

The rendered result will be:欢迎使用AnQiCMS

Example 2: Replace with empty (delete the old word)If we need to remove a word, for example, if we want to remove the word '安企' from the sentence, we can leave the new word blank:

{{ websiteTitle | replace:"安企," }}

The rendered result will be:欢迎使用CMS

Example 3: Insert the new word between each characterIf the old word is left blank, and the new word is not blank,replaceThe filter will interestingly insert the new word at the beginning of the string and after each UTF-8 sequence (simply understood as each character).

{{ websiteTitle | replace:",-" }}

The rendered result will be:-欢-迎-使-用-安-企-C-M-S-

replaceThe actual application scenarios of the filter

This tinyreplaceFilter, it can play a big role in practical applications:

• Brand consistency:When the company name or product name needs to be updated but you do not want to modify the article content in bulk, you can uniformly replace the old names in the template.For example, replace the old company name "Old Company" with "New Company" in all pages without having to modify hundreds of articles.
• SEO Optimization Aid:Keywords in the titles or descriptions of some pages need to be temporarily adjusted to adapt to the new SEO strategy without using the background editing function.For example, replacing the abbreviation of a product name with the full name can improve search matching.
• Correct template display errors:If some hard-coded text in the template is found to be incorrect later, it can bereplaceRapidly correct without modifying the template file itself (especially for complex template structures with multiple languages or sites).
• Content cleaning:Remove specific symbols or extra spaces to make the content display more neatly. For example, clean up any extra delimiters or special characters that may exist when importing content from the outside.

UsereplaceFilter considerations

ThoughreplaceThe filter function is powerful, but there are also some suggestions when using it:

• Avoid abuse: replaceSuitable for small-scale, dynamic text adjustment.If you need to make permanent and structural changes to a large amount of content, it is recommended to use the "Full Site Content Replacement" function provided by the Anqicms backend, or directly modify the original content, which is more conducive to content management and maintenance.
• Performance consideration: For very long strings or frequent use in loopsreplaceThis may have a slight impact on the rendering performance of the page. In most cases, this impact can be ignored, but if you encounter slow page loading, you can consider optimization.
• Replace logic: replaceThe filter is case-sensitive. If you need to perform a case-insensitive replacement, you may need to combine other methods (such as converting the string to uppercase or lowercase first) to achieve this.
• Priority:The template filter is executed at the time of page rendering and operates on the data obtained from the background. This means that if the background has already modified the data, the template in itreplaceWill affect the modified data.

replaceThe filter is an invaluable tool in the process of customizing Anqi CMS templates.It provides us with the ability to flexibly adjust text display in the front-end with concise syntax, greatly enhancing the efficiency and adaptability of content operation.Master and use it well, your security CMS website will have an even better content presentation effect.

Frequently Asked Questions (FAQ)

1. Q:replaceWill the filter modify the original content in my database?A: No.replaceThe filter only temporarily replaces the string output by template variables during page rendering, and the original data will remain unchanged in the database.It merely affects the display way of content on the front-end page.

2. Q: Can I usereplaceCan the filter replace HTML tags or attributes?A: Can.replaceThe filter is for string operations, it will handle any content in the string, including HTML tags and their attributes. For example, you can replace<img>label'ssrcPart of the property path. Please note that if replaced incorrectly, it may damage the page's HTML structure or cause functional exceptions. Be cautious when operating.

3. Q: If I want to replace multiple different old words in a string, I need to write multiplereplacefilter?A: Yes, if you need to replace multiple different old words with their corresponding new words, you need to use multiple in sequencereplacea filter. For example:{{ yourVariable | replace:"旧词1,新词1" | replace:"旧词2,新词2" | replace:"旧词3,新词3" }}. The filter will perform replacement operations in order from left to right.