| Setting Up Your Store > Managing String Resources > How to Add New Strings |
How To Add New Strings
|
Related Topics: AppConfigs Parameters | String Resources |
IMPORTANT:
If you want to add new string resources for other Locales (e.g. en-GB, fr-FR, etc.), please make sure you have ADDED that locale already.
See Adding New Locale.
Two (2) ways to Add New Strings:
String resources can be added to the store site's database in two (2) ways: individually or in a batch. Batch entry of new string resources are entered either by remote or by uploading a certain file from the server PC. These are discussed thoroughly on this page.
Adding a New String Resource Individually:
To add a new string resource individually takes only the common display of the Manage String Resource page to perform. The following procedure must be carried out in order to do this.
Login to the admin site. Go to Misc and then click String Resources Mgr.
Then the Manage String Resource page opens. By default, it displays the string resources for US Locale setting. Set the Locale first on the left upper side of the page to the Locale you are going to map the string resources which you are about to create and upload. Then click
.
String Locales (Default):
Then a new row of fields will appear allowing you to add new string mapped to a specific locale.
The Manage String Resources page consists of the following fields:
Field
Description & Usage
ID
Auto assigned by the database for every new string resource being added that identifies this from any other string resource settings in the database.
Name
This is the assigned delimiter name for a string resource (e.g. account.aspx.11)
Value
This is the string value for this string resource (e.g. MicroPay)
Locale
This is the assigned locale name setting by which this string resource belongs to. (e.g. en-US, en-GB).
After supplying the required specifications for the string resource being created, click
which will then saves and loads the new specifications to the store site's database and thereby perform the indicated adjustments to its operation.
To disregard the changes being made, click
. Do this if you do NOT want to continue the current editing work. Take note that aborting an editing task by other means will automatically update/create a string resource parameter. Always use the Cancel button for this purpose.
If the system variable being edited is supposed to be removed from the system, use the
button . A WORD OF WARNING! PLEASE BE CAREFUL IN PERFORMING THIS PROCEDURE FOR THIS WILL SPELL GREAT TROUBLE IN THE FUNCTIONALITY OF THE STORE SITE'S OPERATION SPECIALLY ON THIS PART (STRING RESOURCE DELETING TASK). This section must be handled by qualified experts only.
Then a confirmation text message: Item Updated appears on the upper left of the page indicating the specified changes will take effect on the store site. Also, it brings back the control to the Manage String Resource page on display mode. The update that has been made will be seen as you browse on that string resource.
Click the Reset Cache for the changes to successfully update.
Adding A New String Resources in A Batch:
Batch entry of string resources requires that a certain new locale must be defined first. In other words, batch entry only works when a new locale setting is defined in the store site which then allows it to accommodate other languages aside from the default American English language. Discussions on this topic regarding Locale and its settings and definitions are discussed in comprehensive details on the Managing Locale Settings page. At default, the American English locale is loaded to the store site system. In this form of string resource entry, a process of uploading an Excel file that contains the predefined configurations of all string resources to add is conducted. All strings used in the store site are stored in the String Resource table in the db, and loaded from language specific Excel string resource .XLS files in /StringResources directory.
There are three (3) ways to Add a new string resources in a batch namely: (Click on each button to see screenshots)
Login to the admin site. Go to Misc and then click String Resources Mgr.
Then the Manage String Resource page opens which contain the default list of string resources.
To start the procedure of creating a new string resource for the store site in a batch , set the Locale for which we are about to add the new string resources.
Since the newly added Locale have no string resources yet, the page will be displayed as BLANK. Take a look on the buttons that will help us load string resources by batch either from your local server or PC, or thru supplying the missing strings.
These are the buttons useful in managing new string resources by Batch:
To load or reload string resources from an Excel file found on the server, click
. This will then generate a confirmation prompt that asks the administrator whether to continue the uploading process or not. Take note that there must be a corresponding Excel formatted string resource file (e.g. strings.en-GB) available on the server directory \StringResources. Otherwise, this process will NOT generate anything from the database. Click
to proceed, otherwise click
to abort the uploading.
When
To load or reload string resources from an Excel file found on a remote PC, click
. This will then generate a confirmation prompt that asks the administrator whether to continue the uploading process or not. Click
When
Browse for the Excel file you will upload then click
.
When the uploading is successful, you will get a confirmation message with a link : Upload successful. Click here to go to begin processing the upload. Click on that link to continue the uploading process.
Proceed to the Step 2 which is verifying the content of the Excel file. If the Preview looks good, click on the link Begin Import Processing. Otherwise, click Cancel Import link to abort the uploading process.
Each string is being processed and status is displayed on the left most column of the page. When ALL status is OK, click the link Back to String Resources.
Then the Manage String Resources page displays the string resources for your NEW Locale.
The third (3rd) way to load a new set of string resources for a certain locale is by supplying the necessary strings one by one by copying and pasting to its respective missing parameter. This process is done by clicking
. You will have then the String Resource Parameters Comparison page, which allows you to enter strings one by one, mapped to the Locale you selected. Fill in the corresponding value box then click
. By performing this action, uploads the currently defined string resource parameters to the database. To check if this has been loaded, click on the link Back to String Resource manager.
Then the newly uploaded string resources are now displayed mapped to the selected Locale.
Click the Reset Cache for the changes to successfully update.
Common Question: I'm seeing weird strings like common.cs.7 on the web pages?
This means that your string resources did not get loaded. The usual fix to this is iisreset, or to restart your own site by updating the web.config file.
To update web.config on a hosted server, just ftp it from the hosted server to your c:\ dir, and then file transfer (ftp) it right back.
Versions 5.8+ will try to reload strings as necessary IF they weren't loaded on application start. We cache these for obvious performance reasons.
If your strings don't come back, ensure that you have your strings loaded by going to the Admin -> Misc -> String Resource manager, and make sure the strings for your active locale are there. If they aren't, you may have to reload them from your stringresources excel file(s). This can also be done through the admin site.
If you are just seeing one or two of these strings on your site, it means that you upgraded, and we have added new string resources. You can reload your strings from our new excel file (provided with the upgrade) by going to:
1. Login to your Admin site -> Go to Misc click String Resource Mgr.
2. Select the locale you need to reload (e.g. en-US)
3. Click
You may need to restart your web (by updating web.config file) or RESET CACHE to cause an application restart, IF the new strings are not picked up immediately.
NOTES:
Some String Resources are ONLY visible to the Admin SuperUsers (SAs).
If unusual strings, like common.cs.7, appear on the web pages, this means that the string resources did NOT get loaded. The usual fix to this is IISRESET, or to restart the site by updating the Web.Config file. To update Web.Config on a hosted server, just ftp it from the hosted server to C:\ Dir, and then ftp it right back.
Versions 5.8+ will try to reload strings as necessary IF they weren't loaded on application start. We cache these for obvious performance reasons.
If the strings does NOT come back, ensure that you have the strings loaded by going to the Manage String Resource page and make sure the strings for the active locale are there. If they are NOT, these have to be reloaded from the string resources Excel file(s).
If seeing just one or two of these strings on the site, it means that it has been upgraded, and new string resources have been added already. Strings can be reloaded from the new excel file (provided with the upgrade) by going to Manage String Resource page.
Select the locale you need to reload (e.g. en-US) click reload strings from server button (first button). You may need to restart your web (by updating Web.Config file) to cause an application restart, IF the new strings are not picked up immediately.
In adding a new string, always insert them into the MASTER .xls file, and keep it separate from ours. Then reload your strings in the admin site from that file! that way, when we do an upgrade, you can change all your strings back easily.
Important Reminder: Always perform RESET CACHE when you make changes in the String Resources.
System Requirements | Security Best Practices | Support & Upgrade Contracts | Downloads | Contact Us
Copyright © 1995-2006 All rights reserved.
