Editing and localizing error messages

About error messages

Poetic allows you to edit the content of the error messages that display throughout the system. You can change the language, text, and dynamic values of the error message. You can also create versions of the error message in other languages.

Within an error message, dynamic values (the numbers in braces) display specific text within an error message. For example, an error message may include the name of a company the user selected.

Displaying the Search Error Messages page

You manage error messages from the Search Error Messages page. To display the page :

  1. On the Administration menu, click Site maintenance.
  2. On the Site Maintenance menu, click the Customization tab.
  3. On the Customization tab, click Error messages.

Selecting the error to edit

Because of the sheer number of error messages, before you can select a message, you must specify search criteria.

You can search for errors based on:

After specifying the search criteria, click Search Error Messages.

The list of errors matching your criteria displays.

To edit an error, click its Edit link.

The Error Message Header page displays.

Editing an error message

For Poetic errors, the information at the top of the Error Message Header page is not editable. For information on configuring custom errors, see Adding and editing custom error messages.

The table at the bottom of the Error Message Header page contains a list of the customized and localized versions of the error.

To edit the message, click the Edit link for the version of the message you want to edit.

The Error Message Maintenance page displays.

In the Error message content text box, edit the message text.

After you finish editing, click Save.

Using dynamic values in error messages

If the error message includes a number enclosed in braces, such as {0}, it means that the error message displays a specific value.

For example, in a message telling the user that they typed a duplicate company name, {0} is replaced by the actual company name the user typed.

For messages that can display multiple values, the first value is {0}, the second is {1}, and so on.

To ensure that the message remains as clear and helpful as possible, do not remove any of these values.

Formatting error messages

You can also include formatting in the error messages. The formatting uses HTML tags that use [] instead of <>. For example, to start a new paragraph in an error message, you would use [p] instead of <p>.

The allowed formatting includes:

[p] [/p] Used to add a paragraph.
[br] Used to insert a line break.
[ol] [/ol] Used to add an ordered list to the message.
[li] [/li] Used to add a list item.
[table] [/table]
[tr] [/tr]
[td] [/td]
Used to add a table to the message.
[b] [/b] Used to make text bold.

You can also provide style information. When the message is displayed, Poetic converts the [] back to <> so that the HTML will be processed correctly.

Please note that Poetic changes all instances of [] to <>. When editing the message text, be careful to only use [] for HTML markup.

Localizing an error message

To create a version of the error message in a new language:

  1. Click the Copy link for the version of the message you want to copy.

    The Error Message Maintenance page displays.

  2. From the Language dropdown, select the language to use.
  3. In the Error message content text box, edit the text for this version of the message.
  4. Click Save.

Removing a localized version of an error message

To remove a version of the error message, click the Remove link for the version you want to remove.

Note that you cannot remove the default language version of the message.