Basic Examples
Basic Examples
Assume you have two localized versions of a site:
SetCloudDirectory["/HTTPLanguageRedirect"]
In[]:=
CloudObject
Out[]=
CloudDeploy["Hello","en/index.nb",Permissions"Public"]
In[]:=
CloudObject
Out[]=
CloudDeploy["Hola","es/index.nb",Permissions"Public"]
In[]:=
CloudObject
Out[]=
HTTPLanguageRedirect
CloudDeploy
[{"en","es"}],CloudObject["index.nb"],Permissions"Public"
In[]:=
CloudObject
Out[]=
Now send users to the root of your site:
URL[First[CloudObject[""]]<>"/"]
In[]:=
URL
Out[]=
Based on their browser settings, they will be automatically redirected to the correct localized version:
Association[URLRead[HTTPRequest[CloudObject[""],<|"Headers"<|"Accept-Language""en"|>|>],"Headers",FollowRedirectsFalse]]["location"]
In[]:=
en/
Out[]=
Association[URLRead[HTTPRequest[CloudObject[""],<|"Headers"<|"Accept-Language""es"|>|>],"Headers",FollowRedirectsFalse]]["location"]
In[]:=
es/
Out[]=
Scope
Scope
You may support multiple languages:
[{"en","fr","es","de"}]
In[]:=
Options
Options
If you are supporting regional variants, you should include the generic language, and use the “PreferredRegion” option to rewrite the generic language to the preferred regional variant:
[{"en","fr","en-ca","en-us","fr-ca"},"PreferredRegion"{"fr""fr-ca","en""en-ca"}]
In[]:=
The “FallbackLanguage” option returns a default language if none are applicable:
[{"fr","es"},"FallbackLanguage""fr"]
Possible Issues
Possible Issues
This function will redirect to a lower-case version of your supported languages:
ToLowerCase[{"en-US","en","FR"}]
In[]:=
{en-us,en,fr}
Out[]=
The Wolfram Cloud currently only supports “index.nb” and “index.html” for base directory URLs.