The custom content model has added a new field, will the text of old articles not be readable

The custom content model has added a new field, the text of the old article will not be unreadable. The addition of the field affects the field level, not the text storage layer: the new field has no value on existing documents, the template reads the empty value, and the text itself is output as usual. What really makes people think it's unreadable is when this new field is written as a required item in the template, or when the column name is not aligned with the new field during batch import, leading to overwriting, as well as not conducting a thorough check after the field is modified and the entire site is released.

Which layer does the new field affect?

AnQiCMS's custom content model supports flexible content structures. The content model determines which custom fields an article can fill. The addition, renaming, and adjustment of filling requirements, as well as the scope of effect, are all defined by the field definition: whether the list page and detail page display, what input items appear in the background editing interface, and what columns are available for import and export. The main text is stored independently and will not be rewritten or truncated because of an additional field.

Please note the mandatory field setting of the field. Setting a new field as mandatory will only affect newly created and saved documents; existing documents will not be filled in forcibly, but will be required to be filled in the next time they are edited and saved, which may cause the illusion that 'old articles cannot be changed'.

Will old articles not be readable: there are three cases.

The first type, the template only outputs the text, without looking at the new fields, the behavior does not change. The second type, the template refers to the new field, and the old document is empty in this field, the page outputs a blank position, the structure does not report an error but visually lacks content, this type of problem is most likely to appear in the subtitles of the list page and parameter bars. The third type, the field is renamed or deleted and then rebuilt, and the template refers to the old field name, the value cannot be obtained, and it looks like the content is lost.

The troubleshooting method is very direct: take an old article and view the rendering results with the template before and after the change, and compare the position of the blank to determine whether it is an empty value or the field name does not match.

The order of batch migration

First define the field and aperture, then move on to the content. It is recommended to: Build fields in the test station or draft status, write clear field usage and value range; choose a category as a pilot, fill in the new fields under the category, and confirm that the template displays normally; then proceed in batches by category. When the quantity is large, use batch import processing, AnQiCMS supports ZIP compressed packages and Excel spreadsheets as two entry methods, the column names of the import table must correspond to the new fields one by one, otherwise there will be a situation where it is filled in but cannot be read.

The unified modification of the old expression should be done through site-wide replacement, batch replacement of keywords or links, which is more labor-saving than manual editing article by article; the replacement range is recommended to be limited to the needed category to avoid mistakenly affecting the same name.

How to roll back if it is broken

Make a backup before changing the field. Backup and restore cover data and static files, if the adjustment of field structure fails, you can roll back to the previous state. There is a second layer of margin for document-level mistakes: deleting formal documents is moved to the recycle bin instead of physical deletion, which can be restored; changes that are not wanted to be exposed prematurely should be placed in draft status, and those that need to be released at a certain pace should use pending release and scheduled release control, and mistakes will not be directly seen by customers.

Common questions

Will adding a field trigger a full site regeneration?No, the change in field definition does not equal the change in text; only template changes affect rendering.

Can an empty value be given a default display?In the template, make conditional judgments on empty values, and display the agreed placeholder text if you cannot get it, which is clearer than leaving it blank.

Which trial classification should be selected?Select the category that is moderate in document quantity and the most typical in field usage, where the problem is most likely to be exposed.