Looking for the v10 manual? Visit our new user's guide!
Search Descriptions Version
This article applies to: MultiStore

String Resource Mgr

From the admin console, click Content → String Resource Mgr

String resources are used to generate most of the text seen on the front end of the site and in the admin section. These strings are read into the database from an Excel file that resides on your site, and when the skin or any of the .aspx files see a label from that string list the software replaces the label with the value from the string list. For example, signin.aspx.11 becomes "Please enter your e-mail address".

This system makes translating your site into other languages extremely easy, as all you have to do is translate the initial Excel file and then upload it to your site (see below). There is more information on localizing your site here.

The String Resource Manager is broken into 3 main sections. The first is the Search area, which allows you to find strings by either their label, or their value. You can also click on one of the letters to view the strings in sections alphabetically.

The second area is the list of strings, which will show all strings by default, or the results of whatever search you performed last. Each string can be either modified with the 'Edit' button, or removed with the 'Delete' button. Note how strings which have been modified appear in bold, to make them easier to locate.

The third part of this page is the list of actions that can be taken to manage your strings (each explained below).

NOTE: If your site has multiple locales installed, these options will not appear until the desired locale is chosen from the locale dropdown, which will appear under the Search box.

Adding a String Resource

To add a new string , click the 'ADD NEW String' button, and fill out the required fields. Be aware that in order for the string to be displayed, the site's skin or the .aspx page where you wish the string to be displayed will have to be modified to call that string.

Attribute NameDescription
NameThis is how the string is referred to in the skin or code files. Customers will not see this value.
ValueThis is the actual content of the string, what will be displayed on the front end.
LocaleThis is the locale to assign the string to. The string will only be displayed when that locale is being viewed on the site.

Reload from Excel file on Server

It may become necessary during the setup/maintenance of your site to reload the entire string resource list. Store admins may want to reset strings to the default, they may be installing a new locale, the existing strings may have been purged, etc. This option allows store admins to do that, and draws the strings from the strings.en-US.xls (or other .NET locale-named files - strings.fr-FR.xls, etc) in the /StringResources folder on the server where the software is installed.

To do this, click the 'Reload from Excel file on Server' button and click 'OK' on the popup prompt.

On the following screen, check the desired options (if any) and click 'Reload Preview'.

'Replace Existing' tells the software to overwrite existing strings. Use this if you are importing a new file that contains some old strings as well as new ones and want to replace them all.
'Leave my modified strings' tells the software to leave any strings which have been modified alone.

The next screen will show a preview of the changes which are going to be made. Any strings that will be replaced should say 'OK' for the status, and strings which are being skipped will be marked in red.

If the preview looks acceptable, click the 'Begin Reload Processing' link, and the site will reload all of the strings. This may take some time! A status screen will display once the process is complete.

Reload from Excel file on your PC

This allows you to upload a string file from the local PC you're working on instead of using one already loaded on the server. The steps are the same as for reloading from the server (see above), except that you must specify the file to be uploaded first.

Show Missing Strings

With this option, you can view a list of the strings (if any) that appear in the site's default locale but are not in the locale you have currently selected in the dropdown list. You can either export them to an Excel file for easy creation outside of the application, or you can enter the desired values right on this page and click the Add/Update button to save them to the locale.

Show Modified Strings

With this function, you can view a list of the strings (if any) that have been changed from their default values, and export them to an Excel sheet if desired.

Clear Locale

This button clears ALL strings from the currently-selected locale. Be sure this is what you want to do, as there is no way to undo this!