Actions

Help15

Difference between revisions of "Screen.languages.15"

From Joomla! Documentation

m (Related Information: category reorganizing)
 
(28 intermediate revisions by 9 users not shown)
Line 1: Line 1:
 +
==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==
[[Image:Screen_languages_15.png]]
+
In the Language Manager you can set the default Language for both the Front-end and Back-end of your Joomla! web site.
  
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.
+
==Screenshot==
 
+
[[Image:Extensions.Languages.png]]
==Version Changes==
+
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.
+
 
+
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==
 
==Column Headers==
Both the ''Site'' and ''Administrator'' tabs have the following column titles
+
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}}
  
*'''Language Name''' The names of the installed languages on this web site.
+
==Toolbar==
*'''Default''' The default language of the site, marked with a yellow graphical asterisk in this column.
+
At the top right you will see the toolbar:
*'''Version''' The version number of the installed language.
+
*'''Date''' This is 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
+
  
These details are fetched from the XML file included in the language pack.
+
[[Image: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.
 +
{{toolbaricon|Help}}
  
==Typical Usage==
+
==Site and Administrator Links==
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.
+
At the top left, above the columns, you will see two links as shown below:
  
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.
+
[[Image:Template_manager_links.png]]
 
+
*'''Site.''' Shows the Languages available for the Front-end of the web site.
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).
+
*'''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==
You can switch between the already installed languages for the '''Site''' and the '''Administrator''' by selecting the desired language and clicking on the '''Default''' button on the upper right part of the screen.
+
*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:
 
+
[[Image:Spanish_language_example.png|frame|center]]
==Points to Watch==
+
:*This User's choice is not affected by the Default Language set for the Front-end.
The switching between the languages does not respect the users presettings in  [[screen.users.15|User Manager]]. If you switch to another language, the user can view the site on that language they have preset in their user settings.
+
:*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 by using FTP because it issues in error both of frontend and backend!
+
  
==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

Contents

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

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

Screenshot

Extensions.Languages.png

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.

  • #. 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

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

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

  • 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