Help15

Difference between revisions of "Screen.languages.15"

From Joomla! Documentation

m (→‎Related Information: category reorganizing)
 
(38 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{inuse}}
+
==How to Access==
 +
Select '''Extensions → Language Manager''' from the drop-down menu on the back-end of your Joomla! installation '''or''' click the icon '''Language''' in the control center.
  
 
==Description==
 
==Description==
In the Language Manager you can configure the available languages installed. You can set a default language displayed to new users, though Joomla! allows registered users to select a preferred language in the front-end.
+
In the Language Manager you can set the default Language for both the Front-end and Back-end of your Joomla! web site.
  
==Version Changes==
+
==Screenshot==
In Joomla! 1.0.x the Language Manager was accessible from Site -> Language Manager -> Site Languages menu item. As only the front-end was localized in Joomla! 1.0.x, only the site languages were listed. The published language was selected in the ''Language'' drop down list of the ''Locale'' tab in the ''Global Configuration'' screen.
+
[[Image:Extensions.Languages.png]]
  
In Joomla! 1.5 a language is a type of extensions, so the Language Manager was moved to the [[screen.installer.15|Extensions]] menu.
+
==Column Headers==
 +
Both the ''Site'' and ''Administrator'' tabs have the following column titles. These details are fetched from the XML file included in the language pack.
 +
{{colheader|Number}}
 +
*'''Checkbox.''' Check this radio button to select the Language.
 +
*'''Language Name.''' The names of the installed Languages on this web site.
 +
*'''Default.''' The default language of the site, marked with a yellow graphical asterisk in this column. ''Note'': to every user a language can be assigned (see "User Management"), user from groups "Administrator" and "Super Administrator" can select their preferred language themself at login.
 +
*'''Version.''' The version number of the installed language.
 +
*'''Date.''' The creation date of the language.
 +
*'''Author.''' The name of the language translator is displayed in this column.
 +
*'''Author E-mail.''' The e-mail address of the translator.
 +
{{colheader|Display}}
  
==Column Headers==
+
==Toolbar==
{{Help screen column header Number}}
+
At the top right you will see the toolbar:
{{Help screen column header Language Name}}
 
{{Help screen column header Default}}
 
{{Help screen column header Version}}
 
{{Help screen column header Date}}
 
{{Help screen column header Author}}
 
{{Help screen column header Author E-mail}}
 
  
==Typical Usage==
+
[[Image:Language_manager_toolbar.png]]
Language Manager is available by clicking its icon in the Control Panel of the administration back-end or from the Extensions -> Language Manager menu item.
+
*'''Default.''' Select the Language that you want to be the default Language. Then click this button. The default star symbol will show in the Default column, indicating that this is now the default Language.
 +
{{toolbaricon|Help}}
  
To set the default language, choose the radio button of the preferred language and click on the ''Default'' toolbar icon in the top right corner.
+
==Site and Administrator Links==
 +
At the top left, above the columns, you will see two links as shown below:
  
New languages are installed with the help of the [[screen.installer.15|Extension Manager]], then they appear in the Language Manager for configuration. You can select either ''Site'' or ''Administrator'' to display the languages for these interfaces. You can set the site in one language and administration to another. Individual articles can also be configured to use a different language (in the Advanced Parameter pane when editing the article).
+
[[Image:Template_manager_links.png]]
 +
*'''Site.''' Shows the Languages available for the Front-end of the web site.
 +
*'''Administrator.''' Shows the Languages available for the Back-end of the web site. Note that the languages for the Front and Back end can be different.
  
 
==Quick Tips==
 
==Quick Tips==
{{Help screen quick tips placeholder}}
+
*Users can use any Language from the list of installed Languages, either by having it assigned in the [[screen.users.15|User Manager]] or by filling out a [[Screen.menus.edit.15#User Form Layout|Menu Item Manager - New/Edit - User Form Layout]] at the Front end. This will cause the Joomla! system prompts to be generated in this Language just for this User. For example, if a User chooses Spanish as their language, then the Search Module will show with prompts in Spanish, as shown below:
You can switch between the installed languages for the '''Site''' end the '''Administrator''' by selecting the desired language and clicking on the '''Default''' button on the upper right part of the screen.
+
[[Image:Spanish_language_example.png|frame|center]]
 
+
:*This User's choice is not affected by the Default Language set for the Front-end.
==Points to Watch==
+
:*Changing a User's Language or the Default Language does not affect the web site's Articles and other content.
{{Help screen points to watch placeholder}}
 
  
==Dependencies==
+
*'''Important''': Do not delete the default language files (for example, with FTP). This will create errors on both the Front-end and Back-end.
The languages listed in the Language Manager can be installed in the [[screen.installer.15|Extension Manager]] from Extensions -> Install/Uninstall menu item. The unnecessary languages can be removed on the Languages tab of the Extension Manager.
 
  
When several languages are installed, the default interface language can be overridden by a registered user on the ''Edit Your Details'' screen opened from User Menu -> Your Details menu item in the front-end after logging in. Users with administration privileges (managers, administrators and super administrators) can select the language of the back-end as well.
+
*Additional Languages can be added using the [[screen.installer.15#Install Screen|Extension Manager - Install Screen]].
  
The selected language is displayed for the appropriate user in [[screen.users.15|User Manager]] parameters.  
+
*If desired, you can show the Front-end site in one Language and show the Back-end administration pages in a different Language. Also, individual articles can be configured to use a different language in the Advanced Parameter pane when editing the Article.
  
[[Category:DocCamp]]
+
==Related Information==
 +
*To install more Languages: [[screen.installer.15#Install Screen|Extension Manager - Install Screen]]
 +
*To uninstall a Language: [[screen.installer.15#Languages Screen|Extension Manager - Languages screen]]
 +
*To change the Language for a User: [[screen.users.15|User Manager]]
 +
*To create a form that allows a User to set their own Language: [[screen.menus.edit.15#User Form Layout|Menu Item Manager - New/Edit - User Form Layout]]
 +
*To set the Language of an Article: [[screen.content.edit.15#Parameters - Advanced|Article Manager - New/Edit - Parameters - Advanced
 +
]]
 +
<noinclude>{{cathelp|1.5|Language Manager Helps Screens|Extensions Help Screens}}</noinclude>

Latest revision as of 22:17, 4 August 2012

How to Access[edit]

Select Extensions → Language Manager from the drop-down menu on the back-end of your Joomla! installation or click the icon Language in the control center.

Description[edit]

In the Language Manager you can set the default Language for both the Front-end and Back-end of your Joomla! web site.

Screenshot[edit]

Extensions.Languages.png

Column Headers[edit]

Both the Site and Administrator tabs have the following column titles. These details are fetched from the XML file included in the language pack.

  • #. An indexing number automatically assigned by Joomla! for ease of reference.
  • Checkbox. Check this radio button to select the Language.
  • Language Name. The names of the installed Languages on this web site.
  • Default. The default language of the site, marked with a yellow graphical asterisk in this column. Note: to every user a language can be assigned (see "User Management"), user from groups "Administrator" and "Super Administrator" can select their preferred language themself at login.
  • Version. The version number of the installed language.
  • Date. The creation date of the language.
  • Author. The name of the language translator is displayed in this column.
  • Author E-mail. The e-mail address of the translator.
  • Display #. The number of items to display on one page. If there are more items than this number, you can use the page navigation buttons (Start, Prev, Next, End, and page numbers) to navigate between pages. Note that if you have a large number of items, it may be helpful to use the Filter options, located above the column headings, to limit which items display (where applicable).

Toolbar[edit]

At the top right you will see the toolbar:

Language manager toolbar.png

  • Default. Select the Language that you want to be the default Language. Then click this button. The default star symbol will show in the Default column, indicating that this is now the default Language.
  • Help. Opens this Help Screen.

Site and Administrator Links[edit]

At the top left, above the columns, you will see two links as shown below:

Template manager links.png

  • Site. Shows the Languages available for the Front-end of the web site.
  • Administrator. Shows the Languages available for the Back-end of the web site. Note that the languages for the Front and Back end can be different.

Quick Tips[edit]

  • Users can use any Language from the list of installed Languages, either by having it assigned in the User Manager or by filling out a Menu Item Manager - New/Edit - User Form Layout at the Front end. This will cause the Joomla! system prompts to be generated in this Language just for this User. For example, if a User chooses Spanish as their language, then the Search Module will show with prompts in Spanish, as shown below:
Spanish language example.png
  • This User's choice is not affected by the Default Language set for the Front-end.
  • Changing a User's Language or the Default Language does not affect the web site's Articles and other content.
  • Important: Do not delete the default language files (for example, with FTP). This will create errors on both the Front-end and Back-end.
  • If desired, you can show the Front-end site in one Language and show the Back-end administration pages in a different Language. Also, individual articles can be configured to use a different language in the Advanced Parameter pane when editing the Article.

Related Information[edit]