DOWNLOADS EXAMPLES SKINS DOCS SUPPORT
 
 

Using non-alpha-numeric and non-western characters

Displaying special glyphs, symbols and characters such as:

& ' ? å ä ö

... that are not included in the standard Western Latin (English) character set (e.g. latin-1, ISO-8859-1) correctly within the player, such as Arabic, Asian, Cyrillic and some European Languages is a tricky endeavor.

Overview:

The problem is that servers (and programming languages) are generally set up using English character sets. Some characters hold special meaning for programming languages and can interfere with Flash, actionscript, XML, PHP and so on. Translations to non-English characters are handled on the client side or are translated on the server to display to the client.

Testing non-western characters requires that a PC's system be set up specifically for a given language. There is also an additional layer of complexity because a server can be configured specifically for use with a given language. In addition, not only does the server and the PC need to be in sync, but the HTML page that displays Wimpy and the wimpy.swf file need to also be in sync. So developing and testing is an enormous task.

To date, the only way to successfully display non-western characters is to run Wimpy off of an XML playlist. Using an XML playlist allows you to establish the characters directly in the XML - whereas using the "automatic" method of displaying the playlist within Wimpy is dependant on the server sending the characters to the player. When using the ID3 option to extract the title and artist info from the MP3 files is also dependent on the server interpreting the characters -- which is problematic if the server is not set up to handle non-western characters.

Best method:

Run Wimpy off of an XML playlist.

Create an XML playlist, then URL encode the <artist> and <title> information. You can URL encode this text using:
urlencoder

 

Alternative Server-side method:

If you're bent on using the automatic ID3 tag reading, you can try configuring the Wimpy scripts  and / or the server to handle non-Western characters. When going down this road, you should set the "Using non-Western characters" option in the Customizer tool so that the Wimpy flash file will know that a non-western character set is being used.

Non-western characters are double-byte characters, so the server needs to be able to handle double-byte characters.

When using the PHP version, you may have success if you're using the PHP version and PHP is configured with "Multibyte String Functions" - this feature may or may not be set up on your PHP enabled server.

When using the ASP version, you can configure the wimpy.asp script to use a specific character set.   Open wimpy.asp in a text editor and review the "Character mapping" section:

'// Character Mapping
'// If you are experiencing problems displaying glyphs and other
'// double-byte (multibyte) characters, set myCharSet
'// for your language's characters set here.
'//
'// For more information on "codepage" see:
'// http://msdn.microsoft.com/library/default.asp?url=/library/en-us/iissdk/html/268f1db1-9a36-4591-956b-d7269aeadcb0.asp
'//
'// For more information on "CharSet" see:
'// http://msdn.microsoft.com/library/default.asp?url=/workshop/author/dhtml/reference/charsets/charset4.asp
'//
'// In order to use a custom character mapping, you must "useCustomCharset" to "yes"
'//
'// Example:
'// useCustomCharset = "yes"
'//
useCustomCharset = "no"
myCodePage = 65001
myCharSet = "uft-8"

 

 

See Also:

Using non-Western characters

Multibyte String Functions

XML playlists

URL encoding text

 

 

 

 

  ©Copyright Plaino LLC. All rights reserved.