Difference between revisions of "Help system"

From Joomla! Documentation

(Marked this version for translation)
(Several markup and capitalization changes.)
 
Line 1: Line 1:
 
<noinclude><languages /></noinclude>
 
<noinclude><languages /></noinclude>
 
<translate><!--T:2-->
 
<translate><!--T:2-->
After a brief introduction to the Joomla help system, this document begins by describing how the help system works, which is something of general interest although written primarily for the benefit of site integrators who must customise Joomla installations. It then proceeds to describe how to set up your own help server, which is something that will be of interest to translators wanting to localise help screens and to third-party developers wanting to provide integrated help from their extensions. Finally, a more detailed description of how to add help support to Joomla extensions is aimed at developers.</translate>
+
After a brief introduction to the Joomla Help system, this document describes how the Help system works, which is something of general interest although written primarily for the benefit of site integrators who must customise Joomla installations. It then proceeds to describe how to set up your own Help server, which is something that will be of interest to translators wanting to localise Help screens and to third-party developers wanting to provide integrated Help for their extensions. Finally, a more detailed description of how to add Help support to Joomla extensions is aimed at developers.</translate>
  
 
<translate>
 
<translate>
==Introduction to the Joomla help system== <!--T:3-->
+
==Introduction to the Joomla Help System== <!--T:3-->
 
</translate>
 
</translate>
 
<onlyinclude>
 
<onlyinclude>
 
<translate><!--T:4-->
 
<translate><!--T:4-->
The Joomla help system provides context-sensitive information to users logged in to the Joomla Administrator. Generally help information is accessed by clicking on the help toolbar button located at the top right of almost all screens (Note that the toolbar button may be located elsewhere if you are not using one of the administrator templates shipped with Joomla). Clicking on this toolbar button will open a new browser window with information relevant to the screen on which it was clicked.</translate>
+
The Joomla Help system provides context-sensitive information to users logged into the Joomla Administrator. Generally Help information is accessed by clicking on the ''Help'' toolbar button located at the top right of almost all screens (Note that the toolbar button may be located elsewhere if you are not using one of the Administrator templates shipped with Joomla). Clicking on this toolbar button will open a new browser window with information relevant to the screen on which it was clicked.</translate>
  
 
<translate><!--T:5-->
 
<translate><!--T:5-->
A typical toolbar with a help button looks like this:</translate>
+
A typical toolbar with a Help button looks like:</translate>
  
 
[[Image:Help16-Global.Config Toolbar-<translate><!--T:22-->
 
[[Image:Help16-Global.Config Toolbar-<translate><!--T:22-->
Line 17: Line 17:
  
 
<translate><!--T:6-->
 
<translate><!--T:6-->
In addition, by clicking on the {{rarr|Help,Joomla Help,<menu item>}}, a list of help topics will be displayed. Clicking on any of these topic titles will bring up relevant information on the same page.</translate>
+
In addition, by clicking on the {{rarr|Help,Joomla Help,''<menu item>''}}, a list of Help topics will be displayed. Clicking on any of these topic titles will bring up relevant information on the same page.</translate>
  
 
<translate><!--T:7-->
 
<translate><!--T:7-->
The help system can access information stored locally as part of the Joomla installation, or from a remote help server. It is fully multi-lingual and can be localised using one of the official translations, or by providing your own help information using a separately hosted help server. Third-party extension developers can integrate help information for components that they supply, either from the local component file structure, or from a remote help server. Furthermore, site integrators can override any or all help screens to fully customise a particular Joomla installation.</translate>
+
The Help system can access information stored locally as part of the Joomla installation, or from a remote Help server. It is fully multilingual and can be localised using one of the official translations, or by providing your own Help information using a separately hosted Help server. Third-party extension developers can integrate Help information for components that they supply, either from the local component file structure, or from a remote Help server. Furthermore, site integrators can override any or all Help screens to fully customise a particular Joomla installation.</translate>
  
<translate>=== Read more about === <!--T:8-->
+
<translate>=== Read More About === <!--T:8-->
* [[S:MyLanguage/Help system/How the help system works|how the help system works]].</translate>
+
* [[S:MyLanguage/Help system/How the help system works|how the Help system works]].</translate>
 
<translate><!--T:9-->
 
<translate><!--T:9-->
* [[S:MyLanguage/Help system/Help servers|setting up your own help server]].</translate>
+
* [[S:MyLanguage/Help system/Help servers|setting up your own Help server]].</translate>
 
<translate><!--T:10-->
 
<translate><!--T:10-->
* [[S:MyLanguage/Help system/Local help files|using local help files]].</translate>
+
* [[S:MyLanguage/Help system/Local help files|using local Help files]].</translate>
 
<translate><!--T:11-->
 
<translate><!--T:11-->
* [[S:MyLanguage/Help system/Translation and localisation|translating and localising help screens]].</translate>
+
* [[S:MyLanguage/Help system/Translation and localisation|translating and localising Help screens]].</translate>
 
<translate><!--T:12-->
 
<translate><!--T:12-->
* [[S:MyLanguage/Help system/Administrator help area|how the administrator help area works]].</translate>
+
* [[S:MyLanguage/Help system/Administrator help area|how the administrator Help area works]].</translate>
 
<translate><!--T:13-->
 
<translate><!--T:13-->
* [[S:MyLanguage/Help system/Adding a help button to the toolbar|adding help support to Joomla extensions]].</translate>
+
* [[S:MyLanguage/Help system/Adding a help button to the toolbar|adding Help support to Joomla extensions]].</translate>
  
 
<translate>
 
<translate>
==See also== <!--T:14-->
+
==See Also== <!--T:14-->
 
</translate>
 
</translate>
 
<translate><!--T:15-->
 
<translate><!--T:15-->
* [[S:MyLanguage/Help system/Helpsites XML format|Format of the helpsites XML file]].</translate>
+
* [[S:MyLanguage/Help system/Helpsites XML format|Format of the Helpsites XML file]].</translate>
 
<translate><!--T:16-->
 
<translate><!--T:16-->
* [[S:MyLanguage/Help system/Substitution codes|Substitution codes]] for use in help screen URLs.</translate>
+
* [[S:MyLanguage/Help system/Substitution codes|Substitution codes]] for use in Help screen URLs.</translate>
 
<translate>
 
<translate>
 
<!--T:23-->
 
<!--T:23-->
* [[S:MyLanguage/Help4.x:Help_screens|Table of help screens for Joomla 4.x]] {{JVer|4.x}}</translate>
+
* [[S:MyLanguage/Help4.x:Help_screens|Table of Help screens for Joomla 4.x]] {{JVer|4.x}}</translate>
 
<translate><!--T:17-->
 
<translate><!--T:17-->
* [[S:MyLanguage/Help31:Help screens|Table of help screens for Joomla 3.x]] {{JVer|3.x}}</translate>
+
* [[S:MyLanguage/Help31:Help screens|Table of Help screens for Joomla 3.x]] {{JVer|3.x}}</translate>
 
<translate><!--T:20-->
 
<translate><!--T:20-->
* [[S:MyLanguage/Using_chunks_in_Joomla_help_screens|Using chunks in Joomla help screens]] {{JVer|3.x}}</translate>
+
* [[S:MyLanguage/Using_chunks_in_Joomla_help_screens|Using chunks in Joomla Help screens]] {{JVer|3.x}}</translate>
  
 
<noinclude>
 
<noinclude>

Latest revision as of 15:56, 25 November 2022

Other languages:
Deutsch • ‎English • ‎Nederlands • ‎Türkçe • ‎español • ‎français • ‎italiano • ‎português • ‎日本語

After a brief introduction to the Joomla Help system, this document describes how the Help system works, which is something of general interest although written primarily for the benefit of site integrators who must customise Joomla installations. It then proceeds to describe how to set up your own Help server, which is something that will be of interest to translators wanting to localise Help screens and to third-party developers wanting to provide integrated Help for their extensions. Finally, a more detailed description of how to add Help support to Joomla extensions is aimed at developers.

Introduction to the Joomla Help System[edit]

The Joomla Help system provides context-sensitive information to users logged into the Joomla Administrator. Generally Help information is accessed by clicking on the Help toolbar button located at the top right of almost all screens (Note that the toolbar button may be located elsewhere if you are not using one of the Administrator templates shipped with Joomla). Clicking on this toolbar button will open a new browser window with information relevant to the screen on which it was clicked.

A typical toolbar with a Help button looks like:

Help16-Global.Config Toolbar-en.png

In addition, by clicking on the Help  Joomla Help  <menu item>, a list of Help topics will be displayed. Clicking on any of these topic titles will bring up relevant information on the same page.

The Help system can access information stored locally as part of the Joomla installation, or from a remote Help server. It is fully multilingual and can be localised using one of the official translations, or by providing your own Help information using a separately hosted Help server. Third-party extension developers can integrate Help information for components that they supply, either from the local component file structure, or from a remote Help server. Furthermore, site integrators can override any or all Help screens to fully customise a particular Joomla installation.

Read More About[edit]

See Also[edit]