Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Toc no bullet

Overview

In cPanel & WHM version 11.32, we introduced a localized login page that allows users to select a locale for their session. This document explains the factors that determine the locale that you see when you log in to cPanel, WHM, or Webmail.

cpsrvd service checks

When you log in to the cPanel, WHM, or Webmail interface, the cpsrvd service performs the following checks to determine which locale to display:

  1. A locale query string parameter exists in the URL.
    • For example, the URL https://example.com:2083/login?locale=ru sets the Russian locale in the cPanel interface. 

    • If the URL has a locale query string parameter, the browser sets the session_locale cookie to the same value.

      Note
      titleNotes:
      • The session_locale cookie overrides the account's configured locale.
      • The session_locale cookie is valid for one year. 


  2. If your browser already contains the session_locale cookie, the login interface and the rest of the user's session uses the specified locale.
  3. If the URL does not specify a locale query string, and the browser does not have a session_locale cookie, the cpsrvd service checks if your browser sent an Accept-Language header. If your browser sent an Accept-Language header, the cpsrvd service uses the first valid locale that corresponds to the value of the Accept-Language header.

    Note
    titleNote:

    Not all browsers allow the Accept-Language header. 


  4. If you have not configured any of the above parameters, the login system uses the selected locate in the Server Locale option in WHM's Tweak Settings  interface (WHM >> Home >> Server Configuration >> Tweak Settings).

    Note
    titleNote:

    cPanel & WHM stores this setting in the /var/cpanel/cpanel.config file as the service_locale variable.


  5. If your system does not meet any of the above conditions, the login system uses the U.S. English locale by default.

Additional documentation

Localtab Group


Localtab
activetrue
titleSuggested documentation

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel = "locales" and space = currentSpace()


Localtab
titleFor cPanel users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel = "locales" and label = "cpanel" and space = currentSpace()


Localtab
titleFor WHM users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel = "locales" and label = "whm" and space = currentSpace()


Localtab
titleFor developers

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel = "locales" and space = "DD"