Attributes for the SkinObject

If you use the selector as a skin object, you can pass a couple of parameters to the language selector, with these parameters you control the behavior. These same parameters can be set if you use the selector as a module, via the module settings option. NB: from the module settings page, you can generate the correct attributes for use with the skinobject. You can choose to either generate ascx type attributes, which will generate the complete skinobject for you, or xml type attributes, which will generate the correct xml settings for the language selector.

The following settings / parameters are supported:

parameter use allowed values default value
DisplayType Selects how the name of the language is rendered. Resourcename means that the names for languages will be pulled from the resource file. This is usefull if the automatic language/country name is not to your liking. The resources can be found in the file MLLanguageSelector.ascx.[Locale].resx

EnglishName
Lcid
Name
NativeName
TwoLetterISOCode
ThreeLetterISOCode
NativeLanguageName
EnglishLanguageName
ResourceName

NativeLanguageName
cssClass Sets the style of the dropdown menu and the links any valid css class name skinobject
Alignment To render  the links and/or flags of the selector horizontal or vertical Horizontal
Vertical
Horizontal
Separator To separate the links/flags. Use cssClass to format the separator any valid html empty
hideCurrent Hides the current selected language in the flag/links view. A special case is the use of this attribute in combination with the Menu. Due to the nature of the dropdown menu, hidecurrent is not supported for the menu, as this would hide the current language, making a different language seemingly selected in the selector. That language can not be selected, because it is already "selected". There is one exception to this: if there is only one language available for display in the menu, the menu (and the flagimage for the active language) will be invisible. True
False
True
Hyperlinks Show hyperlinks. This will render a hyperlink for all available languages True
False
False
Flags Shows flags. This will render a flag image/hyperlink for all available languages. All flags for DotNetNuke supported cultures (which is a subset of all asp.net 1.1 supported cultures) are included, in total 110. If you want to use your own flag, save a .gif image in the "flags" directory of the selector directory (the selector is installed in /desktopmodules/MLLanguageSelector/). Name your files after the 2-letter iso 3166 countrycode (so for instance "us.gif" for United States) True
False
False
Menu Show menu. This will render language dropdown menu. See remarks for attribute HideCurrent. True
False
True
MenuFlagPosition Setting to display a flag for the current selected language left or right from the pulldown menu None
Left
Right
None
displayLabel Show a label in front of the selector True
False
False
LabelCSSClass CSS class to be used for the label any valid cssclass skinobject
OnlyLanguageCode Use only language codes to switch languages (ie: "en" instead of "en-US"). This setting has not real impact, other than a small cleanup in your url: instead of language=en-US you will see: language=en. Note: if you have multiple locales for the same language installed (eg. en-US and en-GB, then this setting will cause one of the locales to be allways selected for both locales. True
False
False
ForceHidden Force the language selector to be invisible. Use this setting if you want to use the language selector only as a language mapping control True
False
False
UseStyleSheetForSkinobject Load module.css when only the skinobject is used. Disable loading of module.css when you get unwanted interference in your skin.css True
False
True
MapLanguages Setting for mapping languages from one language to another. By mapping is meant: redirect requests for mapped language to destination language. Syntax: [sourceLocale]:[destinationLocale]. You can add multiple mapped languages by seperating the mappings by a semicolon (;). 
Eg.: "en-US:en-GB;de-DE:nl-NL" for a Dutch site with 4 installed locales: en-US, en-GB, de-DE and nl-NL. We want all english requests to be redirected to the en-GB version of our site, and for the time being, while we work on the German version of our site, we want to redirect our German visitors to our Dutch site.
[sourceLocale]:[destinationLocale] empty
MapDomains Setting for mapping domains to a specific languages. At this moment only fully qualified domain names are supported, which means that the domain name cannot contain a forward slash ("/").   [fully qualified domain name]:[destinationLocale] empty
useFullLocaleCode Setting which allows you to set the way flag images are referenced. This is a change from earlier versions, the default value is True, which means that flags are referenced with the full locale code, ie. nl-NL or en-US True
False
True
tableLess As there is a lot of focus on tableless designs, you can now let the selector render tableless as well. The default is False, to prevent breaking of skins True
False
True
altFlagLocation You can now use your own flag images. If you use this attribute, the foldername should be relative from the portal root directory. If your portalID is 1, you might pass this value: "flags/16x16". The full name for a Dutch flag would then be: /portals/1/flags/16x16/nl-NL.gif. any valid path under the portal root dir empty
altImageType If your alternative flag images are not gif but png or something else, you can pass a different extension with this parameter any valid image extension. You do not need to use the preceding dot empty
FlagType Allows you to choose from (currently) 2 different flagtypes: simple and modern. The default value is "simple" simple
modern
simple

Last edited Jul 11, 2011 at 7:12 AM by erikvb, version 1

Comments

No comments yet.