BotDetect CAPTCHA Chinese Localization

This page contains the details of Chinese Captcha (中国验证码, 中国captcha) locales fully supported by BotDetect, for which there are both localized Captcha images and audio Captcha sounds available.

Supported Chinese CAPTCHA Locales

zh-cmn-CN (Chinese Mandarin)
zh-yue-HK (Hong Kong Cantonese)

Chinese Mandarin CAPTCHA

Captcha Locale overview:

Language	Country	BotDetect Locale settings
Mandarin	PRC	`cmn, cmn-CN, zh-cmn-CN`

Examples and specifications of individual Captcha feature localizations:

Chinese Mandarin localized Captcha images
Chinese Mandarin localized audio Captcha sounds
Chinese Mandarin localized Captcha codes

Chinese Mandarin Localized CAPTCHA Images

Example Captcha images generated by BotDetect using the base Simplified Han character set for all Captcha ImageStyle values can be seen in the BotDetect Captcha image styles demo

To use BotDetect Captcha images localized for the Chinese Mandarin Captcha Locale in your application, you can specify the Locale value:

In PHP applications, you can use either the application-global setting in the lib/botdetect/CaptchaConfig.php file:

// Set the default Locale for all Captcha instances in the 
// PHP application to Chinese Mandarin
$LBD_CaptchaConfig->Locale = 'cmn-CN';

or the Captcha object instance-specific value:

<?php 
  $SampleCaptcha = new Captcha("SampleCaptcha");
  $SampleCaptcha->UserInputID = "CaptchaCode";
  // Set the Captcha object instance Locale to Chinese Mandarin
  $SampleCaptcha->Locale = 'cmn-CN';
  echo $SampleCaptcha->Html(); 
?>

In ASP.NET applications, you can use either the .aspx page source:

<!-- Captcha control localized to Chinese Mandarin -->
<BotDetect:Captcha ID="SampleCaptcha" runat="server" Locale="cmn-CN" />

or the page code-behind:

[C#]
    
// Set the Captcha instance Locale to Chinese Mandarin    
SampleCaptcha.Locale = "cmn-CN";

[VB.NET]
    
' Set the Captcha instance Locale to Chinese Mandarin    
SampleCaptcha.Locale = "cmn-CN"

Locale-dependent Captcha strings can be configured in the <botDetect> Web.config configuration section.

In ASP Classic applications, you can use either the application-global setting in the BotDetect\CaptchaConfig.asp file:

' Set the default Locale for all Captcha instances in the 
' Classic ASP application to Chinese Mandarin
LBD_Configuration_Locale = "cmn-CN"

or the Captcha object instance-specific value:

<%
  Dim SampleCaptcha : Set SampleCaptcha = (New Captcha)("SampleCaptcha")
  SampleCaptcha.UserInputID = "CaptchaCode"
  ' Set the Captcha object instance Locale to Chinese Mandarin
  SampleCaptcha.Locale = "cmn-CN"
  Response.Write SampleCaptcha.Html
%>

[back to top]

Chinese Mandarin Localized Audio CAPTCHA Sounds

Example audio Captcha sounds generated by BotDetect using the Chinese Mandarin Locale setting can be heard in the BotDetect Captcha features demo

To use BotDetect sounds localized for the Chinese Mandarin Captcha Locale, you should also download the Chinese Mandarin Pronunciation Sound Package and deploy the .bdsp file to the BotDetect sounds folder your application uses:

PHP applications always use lib/botdetect/Resources/Sounds.
ASP.NET applications use Bin\BotDetectSounds by default. A custom folder can be specified in the <botDetect> configuration section.
ASP Classic applications use Redistribute\BotDetectSounds in the BotDetect installation folder by default. A custom folder can be specified in the BotDetect/CaptchaConfig.asp file.

[back to top]

Chinese Mandarin Localized CAPTCHA Codes

The cmn-CN Captcha locale uses the default Simplified Han character set, consisting of 24 Wubi keyboard input method representative characters.

Unicode Captcha Codes and Font Requirements

This table on the left uses the actual Unicode characters drawn in localized Captcha images.

Displaying these characters in your browser requires having fonts which support them installed on the client machine.

In ASP.NET and ASP Classic versions of BotDetect, generating localized Captcha images using these characters also requires supporting fonts on your server.

If viewing these characters in your browser or generating them in Captcha images on your server fails, you can enable the required localization support for on both client and server machines using Control Panel:

Windows 2000, XP, 2003 Server: Regional and Language Options → Languages → Supplemental language support.

Windows Vista, 7, 2008 Server: Region and Language → Keyboards and Languages → Install/uninstall languages.

CodeStyle.Alpha Chinese Mandarin CAPTCHA Characters

Unicode code point	Name	Character
`0x91D1`	gold	金
`0x4EBA`	person	人
`0x6708`	moon	月
`0x767D`	white	白
`0x79BE`	grain	禾
`0x8A00`	speech	言
`0x7ACB`	stand	立
`0x6C34`	water	水
`0x706B`	fire	火
`0x4E4B`	it	之
`0x5DE5`	work	工
`0x6728`	wood	木
`0x5927`	big	大
`0x571F`	earth	土
`0x738B`	king	王
`0x76EE`	eye	目
`0x65E5`	sun	日
`0x53E3`	mouth	口
`0x7530`	field	田
`0x5C71`	mountain	山
`0x53C8`	again	又
`0x5973`	woman	女
`0x5B50`	child	子
`0x5DF2`	already	已

CodeStyle.Numeric Chinese Mandarin CAPTCHA Characters

Unicode code point	Name	Character
`0x0030`	zero	0
`0x0031`	one	1
`0x0032`	two	2
`0x0033`	three	3
`0x0034`	four	4
`0x0035`	five	5
`0x0036`	six	6
`0x0037`	seven	7 (not used)
`0x0038`	eight	8
`0x0039`	nine	9

CodeStyle.Alphanumeric Chinese Mandarin CAPTCHA Characters

Unicode code point	Name	Character
`0x91D1`	gold	金
`0x4EBA`	person	人
`0x6708`	moon	月
`0x767D`	white	白
`0x79BE`	grain	禾
`0x8A00`	speech	言
`0x7ACB`	stand	立
`0x6C34`	water	水
`0x706B`	fire	火
`0x4E4B`	it	之
`0x5DE5`	work	工
`0x6728`	wood	木
`0x5927`	big	大
`0x571F`	earth	土
`0x738B`	king	王
`0x76EE`	eye	目
`0x65E5`	sun	日
`0x53E3`	mouth	口
`0x7530`	field	田
`0x5C71`	mountain	山
`0x53C8`	again	又
`0x5973`	woman	女
`0x5B50`	child	子
`0x5DF2`	already	已
`0x0030`	zero	0
`0x0031`	one	1
`0x0032`	two	2
`0x0033`	three	3
`0x0034`	four	4
`0x0035`	five	5
`0x0036`	six	6
`0x0037`	seven	7 (not used)
`0x0038`	eight	8
`0x0039`	nine	9

If you want to customize the exact character set used for Captcha code generation, you can specify your custom charsets in PHP, ASP.NET and Classic ASP implementations of BotDetect.

[back to top]

Hong Kong Cantonese CAPTCHA

Captcha Locale overview:

Language	Country	BotDetect Locale settings
Cantonese	Hong Kong	`yue-HK, zh-yue-HK`

Examples and specifications of individual Captcha feature localizations:

Hong Kong Cantonese localized Captcha images
Hong Kong Cantonese localized audio Captcha sounds
Hong Kong Cantonese localized Captcha codes

Hong Kong Cantonese Localized CAPTCHA Images

Example Captcha images generated by BotDetect using the base Traditional Han character set for all Captcha ImageStyle values can be seen in the BotDetect Captcha image styles demo

To use BotDetect Captcha images localized for the Hong Kong Cantonese Captcha Locale in your application, you can specify the Locale value:

In PHP applications, you can use either the application-global setting in the lib/botdetect/CaptchaConfig.php file:

// Set the default Locale for all Captcha instances in the 
// PHP application to Hong Kong Cantonese
$LBD_CaptchaConfig->Locale = 'yue-HK';

or the Captcha object instance-specific value:

<?php 
  $SampleCaptcha = new Captcha("SampleCaptcha");
  $SampleCaptcha->UserInputID = "CaptchaCode";
  // Set the Captcha object instance Locale to Hong Kong Cantonese
  $SampleCaptcha->Locale = 'yue-HK';
  echo $SampleCaptcha->Html(); 
?>

In ASP.NET applications, you can use either the .aspx page source:

<!-- Captcha control localized to Hong Kong Cantonese -->
<BotDetect:Captcha ID="SampleCaptcha" runat="server" Locale="yue-HK" />

or the page code-behind:

[C#]
    
// Set the Captcha instance Locale to Hong Kong Cantonese    
SampleCaptcha.Locale = "yue-HK";

[VB.NET]
    
' Set the Captcha instance Locale to Hong Kong Cantonese    
SampleCaptcha.Locale = "yue-HK"

Locale-dependent Captcha strings can be configured in the <botDetect> Web.config configuration section.

In ASP Classic applications, you can use either the application-global setting in the BotDetect\CaptchaConfig.asp file:

' Set the default Locale for all Captcha instances in the 
' Classic ASP application to Hong Kong Cantonese
LBD_Configuration_Locale = "yue-HK"

or the Captcha object instance-specific value:

<%
  Dim SampleCaptcha : Set SampleCaptcha = (New Captcha)("SampleCaptcha")
  SampleCaptcha.UserInputID = "CaptchaCode"
  ' Set the Captcha object instance Locale to Hong Kong Cantonese
  SampleCaptcha.Locale = "yue-HK"
  Response.Write SampleCaptcha.Html
%>

[back to top]

Hong Kong Cantonese Localized Audio CAPTCHA Sounds

Example audio Captcha sounds generated by BotDetect using the Hong Kong Cantonese Locale setting can be heard in the BotDetect Captcha features demo

To use BotDetect sounds localized for the Hong Kong Cantonese Captcha Locale, you should also download the Hong Kong Cantonese Pronunciation Sound Package and deploy the .bdsp file to the BotDetect sounds folder your application uses:

PHP applications always use lib/botdetect/Resources/Sounds.
ASP.NET applications use Bin\BotDetectSounds by default. A custom folder can be specified in the <botDetect> configuration section.
ASP Classic applications use Redistribute\BotDetectSounds in the BotDetect installation folder by default. A custom folder can be specified in the BotDetect/CaptchaConfig.asp file.

[back to top]

Hong Kong Cantonese Localized CAPTCHA Codes

The yue-HK Captcha locale uses the default Traditional Han character set, consisting of 24 Cangjie radicals.

Unicode Captcha Codes and Font Requirements

This table on the left uses the actual Unicode characters drawn in localized Captcha images.

Displaying these characters in your browser requires having fonts which support them installed on the client machine.

In ASP.NET and ASP Classic versions of BotDetect, generating localized Captcha images using these characters also requires supporting fonts on your server.

If viewing these characters in your browser or generating them in Captcha images on your server fails, you can enable the required localization support for on both client and server machines using Control Panel:

Windows 2000, XP, 2003 Server: Regional and Language Options → Languages → Supplemental language support.

Windows Vista, 7, 2008 Server: Region and Language → Keyboards and Languages → Install/uninstall languages.

CodeStyle.Alpha Hong Kong Cantonese CAPTCHA Characters

Unicode code point	Name	Character
`0x4E00`	one	一 (not used)
`0x4E2D`	centre	中
`0x4EBA`	person	人
`0x5341`	ten	十
`0x535C`	fortune telling	卜
`0x53E3`	mouth	口
`0x571F`	earth	土
`0x5927`	big	大
`0x5973`	woman	女
`0x5C38`	corpse	尸
`0x5C71`	mountain	山
`0x5EFF`	twenty	廿
`0x5F13`	bow	弓
`0x5FC3`	heart	心
`0x6208`	weapon	戈
`0x624B`	hand	手
`0x65E5`	sun	日
`0x6708`	moon	月
`0x6728`	wood	木
`0x6C34`	water	水
`0x706B`	fire	火
`0x7530`	field	田
`0x7AF9`	bamboo	竹
`0x91D1`	gold	金

CodeStyle.Numeric Hong Kong Cantonese CAPTCHA Characters

Unicode code point	Name	Character
`0x0030`	zero	0
`0x0031`	one	1
`0x0032`	two	2
`0x0033`	three	3
`0x0034`	four	4
`0x0035`	five	5
`0x0036`	six	6
`0x0037`	seven	7 (not used)
`0x0038`	eight	8
`0x0039`	nine	9

CodeStyle.Alphanumeric Hong Kong Cantonese CAPTCHA Characters

Unicode code point	Name	Character
`0x4E00`	one	一 (not used)
`0x4E2D`	centre	中
`0x4EBA`	person	人
`0x5341`	ten	十
`0x535C`	fortune telling	卜
`0x53E3`	mouth	口
`0x571F`	earth	土
`0x5927`	big	大
`0x5973`	woman	女
`0x5C38`	corpse	尸
`0x5C71`	mountain	山
`0x5EFF`	twenty	廿
`0x5F13`	bow	弓
`0x5FC3`	heart	心
`0x6208`	weapon	戈
`0x624B`	hand	手
`0x65E5`	sun	日
`0x6708`	moon	月
`0x6728`	wood	木
`0x6C34`	water	水
`0x706B`	fire	火
`0x7530`	field	田
`0x7AF9`	bamboo	竹
`0x91D1`	gold	金
`0x0030`	zero	0
`0x0031`	one	1
`0x0032`	two	2
`0x0033`	three	3
`0x0034`	four	4
`0x0035`	five	5
`0x0036`	six	6
`0x0037`	seven	7 (not used)
`0x0038`	eight	8
`0x0039`	nine	9

If you want to customize the exact character set used for Captcha code generation, you can specify your custom charsets in PHP, ASP.NET and Classic ASP implementations of BotDetect.

[back to top]