How to efficiently batch update in the Anqi CMS template?stampToDateLabel's date format string? Practical guide

As an experienced website operations expert, I know the importance of the timeliness and presentation of website content for user experience and brand image. In such efficient and flexible systems as Anqi CMS, we often usestampToDateSuch date formatting tags are used to display the content release or update time. However, with the adjustment of operation strategies, the upgrading of brand image, or to better adapt to the reading habits of users in different regions (such as changing 'year-month-day' to 'day/month/year'), we may face a common problem: how to batch and accurately update allstampToDateLabel date format string?

It is obviously inefficient and prone to errors to manually search and replace files one by one, especially when there are many template files on a website.Don't worry, Anqi CMS, as a system dedicated to providing efficient solutions, its underlying architecture and template mechanism provides us with a variety of effective methods.Today, let's delve deeply into these practical skills.

Deep understandingstampToDateLabel and date format

Before we start the batch update, we first need tostampToDateThe label has a clear understanding. The AnQi CMS template engine supports syntax similar to Django templates, including thestampToDateThe tag is used to convert Unix timestamps to readable date-time strings. Its basic usage is:{{stampToDate(时间戳, "格式")}}.

The most critical part is the second parameter—the format string of the date. Anqicms is developed based on Go language, so this format string follows the Go language's unique date and time formatting rules rather than the commonY-m-d H:i:sorYYYY-MM-DD HH:mm:ssThe Go language uses a special 'reference time' to define the format:

2006-01-02 15:04:05.999999999 -0700 MST

This time itself has no special meaning, it is just used as a fixed reference point, you need to use it to 'mimic' the date format you want. For example:

  • If you want2023-10-27The format string is"2006-01-02".
  • If you want10/27/2023The format string is"01/02/2006".
  • If you want27 October 2023The format string is"02 January 2006".
  • If you want2023年10月27日 15:30:00The format string is"2006年01月02日 15:04:05".

Understanding this, we know that what we need to replace is not just any date format, but a specific format string that follows the Go language rules.

Why is it necessary to batch update the date format?

Batch updating the date format usually originates from the following types of needs:

  1. Unified visual style:When a website undergoes a UI redesign, it may need to unify the display formats of all dates and times to maintain overall visual consistency.
  2. Internationalization and localization:For websites that support multiple languages or are targeted at different regions, the date format can vary by geography. For example, the United States commonly usesMM/DD/YYYY, Europe commonly usesDD/MM/YYYY, China commonly usesYYYY-MM-DDBatch updates can quickly adapt to these localization requirements.
  3. SEO optimization considerations:Certain specific date formats may be more friendly to search engine crawling and parsing, or compatible with certain structured data standards.
  4. Business logic adjustment:Sometimes, the release date, update date, and other product-related dates need to be presented in a more prominent or concise manner. Batch adjustment can quickly respond to business changes.

Strategy and practice of batch updating date format strings

AnQi CMS provides background template editing functionality, but combining it with server command-line tools will be more efficient and stable for scenarios involving a large number of files or complex replacements.

1. Strategy one: Edit the Anqicms CMS background template (suitable for a small number of files or simple replacements)

The Anqi CMS backend provides a "template design" feature, allowing us to directly edit template files online.If the number of template files to be modified is not much, or it only involves the adjustment of individual date formats, this is the most intuitive way.

  1. Log in to the backend:Access your Anqicms CMS background management interface.
  2. Navigate to template design:Find 'Template Design' in the left menu bar and click 'Template Management'.
  3. Select and edit the template:Find the template package you are currently using, click to enter its file list. Open each file that containsstampToDatelabel's.htmlTemplate file.
  4. Find and replace:In the content area of the template editor, use the browser's find feature (usuallyCtrl+ForCmd+FSearchstampToDateFound the target format string and manually modify it to the new format.
  5. Save and update the cache:After the modification is completed, be sure to click Save. Then, find 'Update Cache' in the left menu of the background and execute it to ensure that the modified template takes effect.

Advantage:No server operation experience required, user-friendly interface, instant preview (may require refreshing the front-end page).Shortcomings:Not suitable for large files or complex replacements, manual operation is time-consuming and prone to errors.

2. Strategy two: Use server command-line tools for bulk replacement (recommended and efficient)

When it comes to dealing with a large number of template files, or when complex and precise replacement operations are required, using command-line tools directly on the server is the most powerful method. Here, we will mainly rely onfindandsedThese are the tools under Linux/Unix-like systems.

Important tip: Before performing any server file operations, please make sure to back up your entire website template directory! This is the golden rule and can prevent any irrecoverable losses.

The template files of AnQi CMS are usually stored in/www/wwwroot/您的域名/template/您的模板目录/Below, static resources are in/public/static/Our goal is.htmlTemplate file.

Step one: Connect to your server

Use an SSH client (such as PuTTY, Xshell, or the terminal built into macOS/Linux) to connect to your security CMS server.

Step two: Locate the template directory

Enter the root directory of your website template. For example:cd /www/wwwroot/your_site_name/template/your_template_name/

Step three: UsegrepCommand pre-search and verify (optional but strongly recommended)

Before performing the replacement, use firstgrepCommand search for the current format string, confirm which files will be affected, and view their specific context to write more precise replacement rules.

Assume you will translate all{{stampToDate(item.CreatedTime, "2006-01-02")}}The date format from"2006-01-02"changed to"02/01/2006".

Look up the current format:grep -r "stampToDate.*\"2006-01-02\"" .

  • -r: Recursively search the current directory and its subdirectories.
  • "stampToDate.*\"2006-01-02\"": This is the search pattern to be searched..*Match any character,\"Used to escape double quotes.
  • .: Represents the current directory.

Step four: Usesedcommand for batch replacement

sed(stream editor) is a powerful text stream processing tool that can search and replace text in files. Its basic syntax issed -i 's/旧字符串/新字符串/g' 文件名.

We usefindcommand combinationsedto perform batch operations.

Scenario one: Simple format string replacement

For example, replace all template files in"2006-01-02"Replace"02/01/2006":

find . -name "*.html" -exec sed -i 's/"2006-01-02"/"02\/01\/2006"/g' {} +
  • find . -name "*.html": Find all files in the current directory and its subdirectories.htmlfile.
  • -exec ... {} +: OnfindExecute the subsequent commands on each file found.{}The file name will be replaced,+This indicates that multiple file names are passed tosedto improve efficiency.
  • sed -i 's/旧字符串/新字符串/g':
    • -i: means in-place editing, that is, modifying the file content directly.Please backup before use!
    • sReplace command. *