Joomla! Documentation - User contributions [en]

J3.x:Two Factor Authentication

2017-06-16T12:44:16Z

Crispness: /* See Also */ fix link

<noinclude><languages /></noinclude>
<noinclude>{{Joomla version|version=3.2|time=and after|}}
{{-}}
{{Top portal heading|color=white-bkgd|icon=lock|icon-color=#5091cd|size=3x|text-color=#333|title=<translate>
Two-Factor Authentication</translate>}}</noinclude>
<translate>
Joomla! was the first major CMS to implement Two-Factor Authentication. This adds a single-use code received on your smartphone or a Yubikey to your existing passwords to make your site extra hacker-proof.</translate>

<div class="row">
<div class="large-6 large-centered columns">
<div class="video-container">
{{#widget:YouTube|id=NbG6eehASW8}}
</div>
</div>
</div>

<translate>
Traditionally, when you want to log in to a website, you have to provide your username and your password in order to identify yourself to the system.</translate>
<translate>
The biggest problem with this approach is your username and password can be stolen or guessed. For example, if your computer is infested with malware or you try to access your site from an untrusted network, such as a public WiFi hotspot, it is possible someone could intercept your username and password. This means they can log into your site as you. Because your username and password is compromised, your site can now be hacked.</translate>

<translate>
In order to prevent that, Joomla! 3.2.0 and later versions, come with a built-in Two-Factor Authentication system that secures your site login with a secondary, single use secret code. This is called [[wp:Two-factor authentication|Two-Factor Authentication]] or shortened to 2FA. </translate>

<translate>
==Enable Two-Factor Authentication== 
</translate>
<translate>
The very first time you’re installing Joomla! 3.2 or higher, and access your backend, you’ll see a notice about post-installation messages.</translate>

[[Image:Joomla-two-factor-authentication-post-installation-<translate>
en</translate>.png]]

<translate>
Click on the ''Review Messages'' button, you’ll see a screen which indicates that Two-Factor Authentication is Available.</translate>
<translate>
Click on the ''Enable Two-Factor Authentication'' button.</translate>

[[Image:Joomla-two-factor-authentication-enable-<translate>
en</translate>.png]]

<translate>
To set up the Two-Factor Authentication, go to the User Manager, edit a User and go to the Two-Factor Authentication Tab:</translate>

[[Image:Joomla-two-factor-authentication-tab-<translate>
en</translate>.png]]

<translate>
If the Two-Factor Authentication Tab does not appear, it is possible that the associated plugin is not enabled. In that case go to the Plugin Manager and find the Two Factor plugins. There are normally two - one for Google Authenticator and the other for Yubikey. Enable those that you intend to use. The return to the User Manager and try again.

==Authentication Methods==
===Google Authenticator=== 
</translate>
<translate>
[[wikipedia:Google_Authenticator|Google Authenticator]] is an application for smartphones and desktops created by Google which allows you to generate a six digit security password which changes every 30 seconds. In order to log in to your site, you’ll need to use your username, your password and the six digit security code which changes every thirty seconds.</translate>

<translate>
You can enable Two-Factor Authentication for the Frontend, the Backend or for Both. This can be set up in the plug-in ''Two-Factor Authentication – Google Authenticator''.</translate>

<translate>
This provides extra protection against hackers trying to log in to your account. Even if they were able to get hold of your credentials they have a maximum 30s to hack your site. This is usually not practical for hackers. In this way, the Two-Factor Authentication prevents your site against unauthorized access.</translate>

<translate>
Setting up the Two-Factor Authentication with Google Authenticator is actually really easy.</translate>

<translate>
====Step 1 – Get Google Authenticator==== 
</translate>
<translate>
Download and Install Google Authenticator on your smartphone or desktop.</translate>

[[Image:Joomla-Google-Authenticator-download-<translate>
en</translate>.png]]

<translate>
====Step 2 - Set up==== 
</translate>
<translate>
You can see a QR Code to scan with a mobile phone with the application of Google Authenticator installed.</translate>

[[Image:Joomla-Google-Authenticator-setup-<translate>
en</translate>.png]]

<translate>
====Step 3 - Activate Two-Factor Authentication==== 
</translate>
<translate>
Go to the Activate Two-Factor Authenticator field and enter the six digit security code you can see on the screen of your smartphone device. Then click on ''Save & Close''.</translate>

[[Image:Joomla-Google-Authenticator-activate-<translate>
en</translate>.png]]

<translate>
Now, your site access is protected by Two-Factor Authentication. Log out from your backend, you’ll see that instead of asking for the username and password only, Joomla! is asking for a secret key. The Secret Key is the six digit password you can see on your Google Authenticator screen.</translate>

[[Image:Joomla-Google-Authenticator-login-<translate>
en</translate>.png]]

<translate>
If you don’t enter the secret code or a random one, you won’t be able to login. This is what will happen to a hacker who tries to access your backend, since they don’t have the correct secret key.</translate>

<translate>

===Yubikey=== 
</translate>
<translate>
This feature allows you to use a Yubikey secure hardware token for Two-Factor Authentication. In addition to your username and password you will also need to insert your Yubikey into your computer's USB port, click inside the Secret Key area of the site's login area and touch Yubikey's gold disk. If you have an NFC-equipped Android smartphone you can just approach a compatible Yubikey token (Yubikey Neo) to the NFC reader to copy the secret code to the device's clipboard. The secret code generated by your Yubikey is unique to your device and changes constantly. This provides extra protection against hackers logging in to your account even if they were able to get hold of your password.</translate>

<translate>
You can enable Two-Factor Authentication for the Frontend, the Backend or for Both. This can be set up in the plug-in ''Two-Factor Authentication – Yubikey''.</translate>

[[Image:Joomla-two-factor-authentication-Yubikey-<translate>
en</translate>.png]]

<translate>
==== See Also ====
*See also: [https://docs.joomla.org/Backup Backup Basics for a Joomla! Web Site]

===Contributor==== 
</translate>
* Nicholas Dionysopoulos
__NOTOC__
<noinclude>
<translate>

[[Category:Joomla! 3.x]]
[[Category:Joomla! 3.2]]
[[Category:Security]]
[[Category:Tutorials]]
</translate>
</noinclude>

J3.x:Two Factor Authentication

2017-06-16T12:43:29Z

Crispness: /* See Also */ fix link

<noinclude><languages /></noinclude>
<noinclude>{{Joomla version|version=3.2|time=and after|}}
{{-}}
{{Top portal heading|color=white-bkgd|icon=lock|icon-color=#5091cd|size=3x|text-color=#333|title=<translate>
Two-Factor Authentication</translate>}}</noinclude>
<translate>
Joomla! was the first major CMS to implement Two-Factor Authentication. This adds a single-use code received on your smartphone or a Yubikey to your existing passwords to make your site extra hacker-proof.</translate>

<div class="row">
<div class="large-6 large-centered columns">
<div class="video-container">
{{#widget:YouTube|id=NbG6eehASW8}}
</div>
</div>
</div>

<translate>
Traditionally, when you want to log in to a website, you have to provide your username and your password in order to identify yourself to the system.</translate>
<translate>
The biggest problem with this approach is your username and password can be stolen or guessed. For example, if your computer is infested with malware or you try to access your site from an untrusted network, such as a public WiFi hotspot, it is possible someone could intercept your username and password. This means they can log into your site as you. Because your username and password is compromised, your site can now be hacked.</translate>

<translate>
In order to prevent that, Joomla! 3.2.0 and later versions, come with a built-in Two-Factor Authentication system that secures your site login with a secondary, single use secret code. This is called [[wp:Two-factor authentication|Two-Factor Authentication]] or shortened to 2FA. </translate>

<translate>
==Enable Two-Factor Authentication== 
</translate>
<translate>
The very first time you’re installing Joomla! 3.2 or higher, and access your backend, you’ll see a notice about post-installation messages.</translate>

[[Image:Joomla-two-factor-authentication-post-installation-<translate>
en</translate>.png]]

<translate>
Click on the ''Review Messages'' button, you’ll see a screen which indicates that Two-Factor Authentication is Available.</translate>
<translate>
Click on the ''Enable Two-Factor Authentication'' button.</translate>

[[Image:Joomla-two-factor-authentication-enable-<translate>
en</translate>.png]]

<translate>
To set up the Two-Factor Authentication, go to the User Manager, edit a User and go to the Two-Factor Authentication Tab:</translate>

[[Image:Joomla-two-factor-authentication-tab-<translate>
en</translate>.png]]

<translate>
If the Two-Factor Authentication Tab does not appear, it is possible that the associated plugin is not enabled. In that case go to the Plugin Manager and find the Two Factor plugins. There are normally two - one for Google Authenticator and the other for Yubikey. Enable those that you intend to use. The return to the User Manager and try again.

==Authentication Methods==
===Google Authenticator=== 
</translate>
<translate>
[[wikipedia:Google_Authenticator|Google Authenticator]] is an application for smartphones and desktops created by Google which allows you to generate a six digit security password which changes every 30 seconds. In order to log in to your site, you’ll need to use your username, your password and the six digit security code which changes every thirty seconds.</translate>

<translate>
You can enable Two-Factor Authentication for the Frontend, the Backend or for Both. This can be set up in the plug-in ''Two-Factor Authentication – Google Authenticator''.</translate>

<translate>
This provides extra protection against hackers trying to log in to your account. Even if they were able to get hold of your credentials they have a maximum 30s to hack your site. This is usually not practical for hackers. In this way, the Two-Factor Authentication prevents your site against unauthorized access.</translate>

<translate>
Setting up the Two-Factor Authentication with Google Authenticator is actually really easy.</translate>

<translate>
====Step 1 – Get Google Authenticator==== 
</translate>
<translate>
Download and Install Google Authenticator on your smartphone or desktop.</translate>

[[Image:Joomla-Google-Authenticator-download-<translate>
en</translate>.png]]

<translate>
====Step 2 - Set up==== 
</translate>
<translate>
You can see a QR Code to scan with a mobile phone with the application of Google Authenticator installed.</translate>

[[Image:Joomla-Google-Authenticator-setup-<translate>
en</translate>.png]]

<translate>
====Step 3 - Activate Two-Factor Authentication==== 
</translate>
<translate>
Go to the Activate Two-Factor Authenticator field and enter the six digit security code you can see on the screen of your smartphone device. Then click on ''Save & Close''.</translate>

[[Image:Joomla-Google-Authenticator-activate-<translate>
en</translate>.png]]

<translate>
Now, your site access is protected by Two-Factor Authentication. Log out from your backend, you’ll see that instead of asking for the username and password only, Joomla! is asking for a secret key. The Secret Key is the six digit password you can see on your Google Authenticator screen.</translate>

[[Image:Joomla-Google-Authenticator-login-<translate>
en</translate>.png]]

<translate>
If you don’t enter the secret code or a random one, you won’t be able to login. This is what will happen to a hacker who tries to access your backend, since they don’t have the correct secret key.</translate>

<translate>

===Yubikey=== 
</translate>
<translate>
This feature allows you to use a Yubikey secure hardware token for Two-Factor Authentication. In addition to your username and password you will also need to insert your Yubikey into your computer's USB port, click inside the Secret Key area of the site's login area and touch Yubikey's gold disk. If you have an NFC-equipped Android smartphone you can just approach a compatible Yubikey token (Yubikey Neo) to the NFC reader to copy the secret code to the device's clipboard. The secret code generated by your Yubikey is unique to your device and changes constantly. This provides extra protection against hackers logging in to your account even if they were able to get hold of your password.</translate>

<translate>
You can enable Two-Factor Authentication for the Frontend, the Backend or for Both. This can be set up in the plug-in ''Two-Factor Authentication – Yubikey''.</translate>

[[Image:Joomla-two-factor-authentication-Yubikey-<translate>
en</translate>.png]]

<translate>
==== See Also ====
*See also: [[S:MyLanguage/J3.x:Backup]]

===Contributor==== 
</translate>
* Nicholas Dionysopoulos
__NOTOC__
<noinclude>
<translate>

[[Category:Joomla! 3.x]]
[[Category:Joomla! 3.2]]
[[Category:Security]]
[[Category:Tutorials]]
</translate>
</noinclude>

J3.x:Two Factor Authentication

2017-06-16T12:42:43Z

Crispness: add see also

<noinclude><languages /></noinclude>
<noinclude>{{Joomla version|version=3.2|time=and after|}}
{{-}}
{{Top portal heading|color=white-bkgd|icon=lock|icon-color=#5091cd|size=3x|text-color=#333|title=<translate>
Two-Factor Authentication</translate>}}</noinclude>
<translate>
Joomla! was the first major CMS to implement Two-Factor Authentication. This adds a single-use code received on your smartphone or a Yubikey to your existing passwords to make your site extra hacker-proof.</translate>

<div class="row">
<div class="large-6 large-centered columns">
<div class="video-container">
{{#widget:YouTube|id=NbG6eehASW8}}
</div>
</div>
</div>

<translate>
Traditionally, when you want to log in to a website, you have to provide your username and your password in order to identify yourself to the system.</translate>
<translate>
The biggest problem with this approach is your username and password can be stolen or guessed. For example, if your computer is infested with malware or you try to access your site from an untrusted network, such as a public WiFi hotspot, it is possible someone could intercept your username and password. This means they can log into your site as you. Because your username and password is compromised, your site can now be hacked.</translate>

<translate>
In order to prevent that, Joomla! 3.2.0 and later versions, come with a built-in Two-Factor Authentication system that secures your site login with a secondary, single use secret code. This is called [[wp:Two-factor authentication|Two-Factor Authentication]] or shortened to 2FA. </translate>

<translate>
==Enable Two-Factor Authentication== 
</translate>
<translate>
The very first time you’re installing Joomla! 3.2 or higher, and access your backend, you’ll see a notice about post-installation messages.</translate>

[[Image:Joomla-two-factor-authentication-post-installation-<translate>
en</translate>.png]]

<translate>
Click on the ''Review Messages'' button, you’ll see a screen which indicates that Two-Factor Authentication is Available.</translate>
<translate>
Click on the ''Enable Two-Factor Authentication'' button.</translate>

[[Image:Joomla-two-factor-authentication-enable-<translate>
en</translate>.png]]

<translate>
To set up the Two-Factor Authentication, go to the User Manager, edit a User and go to the Two-Factor Authentication Tab:</translate>

[[Image:Joomla-two-factor-authentication-tab-<translate>
en</translate>.png]]

<translate>
If the Two-Factor Authentication Tab does not appear, it is possible that the associated plugin is not enabled. In that case go to the Plugin Manager and find the Two Factor plugins. There are normally two - one for Google Authenticator and the other for Yubikey. Enable those that you intend to use. The return to the User Manager and try again.

==Authentication Methods==
===Google Authenticator=== 
</translate>
<translate>
[[wikipedia:Google_Authenticator|Google Authenticator]] is an application for smartphones and desktops created by Google which allows you to generate a six digit security password which changes every 30 seconds. In order to log in to your site, you’ll need to use your username, your password and the six digit security code which changes every thirty seconds.</translate>

<translate>
You can enable Two-Factor Authentication for the Frontend, the Backend or for Both. This can be set up in the plug-in ''Two-Factor Authentication – Google Authenticator''.</translate>

<translate>
This provides extra protection against hackers trying to log in to your account. Even if they were able to get hold of your credentials they have a maximum 30s to hack your site. This is usually not practical for hackers. In this way, the Two-Factor Authentication prevents your site against unauthorized access.</translate>

<translate>
Setting up the Two-Factor Authentication with Google Authenticator is actually really easy.</translate>

<translate>
====Step 1 – Get Google Authenticator==== 
</translate>
<translate>
Download and Install Google Authenticator on your smartphone or desktop.</translate>

[[Image:Joomla-Google-Authenticator-download-<translate>
en</translate>.png]]

<translate>
====Step 2 - Set up==== 
</translate>
<translate>
You can see a QR Code to scan with a mobile phone with the application of Google Authenticator installed.</translate>

[[Image:Joomla-Google-Authenticator-setup-<translate>
en</translate>.png]]

<translate>
====Step 3 - Activate Two-Factor Authentication==== 
</translate>
<translate>
Go to the Activate Two-Factor Authenticator field and enter the six digit security code you can see on the screen of your smartphone device. Then click on ''Save & Close''.</translate>

[[Image:Joomla-Google-Authenticator-activate-<translate>
en</translate>.png]]

<translate>
Now, your site access is protected by Two-Factor Authentication. Log out from your backend, you’ll see that instead of asking for the username and password only, Joomla! is asking for a secret key. The Secret Key is the six digit password you can see on your Google Authenticator screen.</translate>

[[Image:Joomla-Google-Authenticator-login-<translate>
en</translate>.png]]

<translate>
If you don’t enter the secret code or a random one, you won’t be able to login. This is what will happen to a hacker who tries to access your backend, since they don’t have the correct secret key.</translate>

<translate>

===Yubikey=== 
</translate>
<translate>
This feature allows you to use a Yubikey secure hardware token for Two-Factor Authentication. In addition to your username and password you will also need to insert your Yubikey into your computer's USB port, click inside the Secret Key area of the site's login area and touch Yubikey's gold disk. If you have an NFC-equipped Android smartphone you can just approach a compatible Yubikey token (Yubikey Neo) to the NFC reader to copy the secret code to the device's clipboard. The secret code generated by your Yubikey is unique to your device and changes constantly. This provides extra protection against hackers logging in to your account even if they were able to get hold of your password.</translate>

<translate>
You can enable Two-Factor Authentication for the Frontend, the Backend or for Both. This can be set up in the plug-in ''Two-Factor Authentication – Yubikey''.</translate>

[[Image:Joomla-two-factor-authentication-Yubikey-<translate>
en</translate>.png]]

<translate>
==== See Also ====
*See also: [[S:MyLanguage/J3.x:Backup Basics for a Joomla! Web Site]]

===Contributor==== 
</translate>
* Nicholas Dionysopoulos
__NOTOC__
<noinclude>
<translate>

[[Category:Joomla! 3.x]]
[[Category:Joomla! 3.2]]
[[Category:Security]]
[[Category:Tutorials]]
</translate>
</noinclude>

J3.x:Two Factor Authentication

2017-06-16T12:37:32Z

Crispness: demote headings

<noinclude><languages /></noinclude>
<noinclude>{{Joomla version|version=3.2|time=and after|}}
{{-}}
{{Top portal heading|color=white-bkgd|icon=lock|icon-color=#5091cd|size=3x|text-color=#333|title=<translate>
Two-Factor Authentication</translate>}}</noinclude>
<translate>
Joomla! was the first major CMS to implement Two-Factor Authentication. This adds a single-use code received on your smartphone or a Yubikey to your existing passwords to make your site extra hacker-proof.</translate>

<div class="row">
<div class="large-6 large-centered columns">
<div class="video-container">
{{#widget:YouTube|id=NbG6eehASW8}}
</div>
</div>
</div>

<translate>
Traditionally, when you want to log in to a website, you have to provide your username and your password in order to identify yourself to the system.</translate>
<translate>
The biggest problem with this approach is your username and password can be stolen or guessed. For example, if your computer is infested with malware or you try to access your site from an untrusted network, such as a public WiFi hotspot, it is possible someone could intercept your username and password. This means they can log into your site as you. Because your username and password is compromised, your site can now be hacked.</translate>

<translate>
In order to prevent that, Joomla! 3.2.0 and later versions, come with a built-in Two-Factor Authentication system that secures your site login with a secondary, single use secret code. This is called [[wp:Two-factor authentication|Two-Factor Authentication]] or shortened to 2FA. </translate>

<translate>
==Enable Two-Factor Authentication== 
</translate>
<translate>
The very first time you’re installing Joomla! 3.2 or higher, and access your backend, you’ll see a notice about post-installation messages.</translate>

[[Image:Joomla-two-factor-authentication-post-installation-<translate>
en</translate>.png]]

<translate>
Click on the ''Review Messages'' button, you’ll see a screen which indicates that Two-Factor Authentication is Available.</translate>
<translate>
Click on the ''Enable Two-Factor Authentication'' button.</translate>

[[Image:Joomla-two-factor-authentication-enable-<translate>
en</translate>.png]]

<translate>
To set up the Two-Factor Authentication, go to the User Manager, edit a User and go to the Two-Factor Authentication Tab:</translate>

[[Image:Joomla-two-factor-authentication-tab-<translate>
en</translate>.png]]

<translate>
If the Two-Factor Authentication Tab does not appear, it is possible that the associated plugin is not enabled. In that case go to the Plugin Manager and find the Two Factor plugins. There are normally two - one for Google Authenticator and the other for Yubikey. Enable those that you intend to use. The return to the User Manager and try again.

==Authentication Methods==
===Google Authenticator=== 
</translate>
<translate>
[[wikipedia:Google_Authenticator|Google Authenticator]] is an application for smartphones and desktops created by Google which allows you to generate a six digit security password which changes every 30 seconds. In order to log in to your site, you’ll need to use your username, your password and the six digit security code which changes every thirty seconds.</translate>

<translate>
You can enable Two-Factor Authentication for the Frontend, the Backend or for Both. This can be set up in the plug-in ''Two-Factor Authentication – Google Authenticator''.</translate>

<translate>
This provides extra protection against hackers trying to log in to your account. Even if they were able to get hold of your credentials they have a maximum 30s to hack your site. This is usually not practical for hackers. In this way, the Two-Factor Authentication prevents your site against unauthorized access.</translate>

<translate>
Setting up the Two-Factor Authentication with Google Authenticator is actually really easy.</translate>

<translate>
====Step 1 – Get Google Authenticator==== 
</translate>
<translate>
Download and Install Google Authenticator on your smartphone or desktop.</translate>

[[Image:Joomla-Google-Authenticator-download-<translate>
en</translate>.png]]

<translate>
====Step 2 - Set up==== 
</translate>
<translate>
You can see a QR Code to scan with a mobile phone with the application of Google Authenticator installed.</translate>

[[Image:Joomla-Google-Authenticator-setup-<translate>
en</translate>.png]]

<translate>
====Step 3 - Activate Two-Factor Authentication==== 
</translate>
<translate>
Go to the Activate Two-Factor Authenticator field and enter the six digit security code you can see on the screen of your smartphone device. Then click on ''Save & Close''.</translate>

[[Image:Joomla-Google-Authenticator-activate-<translate>
en</translate>.png]]

<translate>
Now, your site access is protected by Two-Factor Authentication. Log out from your backend, you’ll see that instead of asking for the username and password only, Joomla! is asking for a secret key. The Secret Key is the six digit password you can see on your Google Authenticator screen.</translate>

[[Image:Joomla-Google-Authenticator-login-<translate>
en</translate>.png]]

<translate>
If you don’t enter the secret code or a random one, you won’t be able to login. This is what will happen to a hacker who tries to access your backend, since they don’t have the correct secret key.</translate>

<translate>

===Yubikey=== 
</translate>
<translate>
This feature allows you to use a Yubikey secure hardware token for Two-Factor Authentication. In addition to your username and password you will also need to insert your Yubikey into your computer's USB port, click inside the Secret Key area of the site's login area and touch Yubikey's gold disk. If you have an NFC-equipped Android smartphone you can just approach a compatible Yubikey token (Yubikey Neo) to the NFC reader to copy the secret code to the device's clipboard. The secret code generated by your Yubikey is unique to your device and changes constantly. This provides extra protection against hackers logging in to your account even if they were able to get hold of your password.</translate>

<translate>
You can enable Two-Factor Authentication for the Frontend, the Backend or for Both. This can be set up in the plug-in ''Two-Factor Authentication – Yubikey''.</translate>

[[Image:Joomla-two-factor-authentication-Yubikey-<translate>
en</translate>.png]]

<translate>
====Contributor==== 
</translate>
* Nicholas Dionysopoulos
__NOTOC__
<noinclude>
<translate>

[[Category:Joomla! 3.x]]
[[Category:Joomla! 3.2]]
[[Category:Security]]
[[Category:Tutorials]]
</translate>
</noinclude>

J3.x:Two Factor Authentication

2017-06-16T12:36:59Z

Crispness: demote hdgs

<noinclude><languages /></noinclude>
<noinclude>{{Joomla version|version=3.2|time=and after|}}
{{-}}
{{Top portal heading|color=white-bkgd|icon=lock|icon-color=#5091cd|size=3x|text-color=#333|title=<translate>
Two-Factor Authentication</translate>}}</noinclude>
<translate>
Joomla! was the first major CMS to implement Two-Factor Authentication. This adds a single-use code received on your smartphone or a Yubikey to your existing passwords to make your site extra hacker-proof.</translate>

<div class="row">
<div class="large-6 large-centered columns">
<div class="video-container">
{{#widget:YouTube|id=NbG6eehASW8}}
</div>
</div>
</div>

<translate>
Traditionally, when you want to log in to a website, you have to provide your username and your password in order to identify yourself to the system.</translate>
<translate>
The biggest problem with this approach is your username and password can be stolen or guessed. For example, if your computer is infested with malware or you try to access your site from an untrusted network, such as a public WiFi hotspot, it is possible someone could intercept your username and password. This means they can log into your site as you. Because your username and password is compromised, your site can now be hacked.</translate>

<translate>
In order to prevent that, Joomla! 3.2.0 and later versions, come with a built-in Two-Factor Authentication system that secures your site login with a secondary, single use secret code. This is called [[wp:Two-factor authentication|Two-Factor Authentication]] or shortened to 2FA. </translate>

<translate>
==Enable Two-Factor Authentication== 
</translate>
<translate>
The very first time you’re installing Joomla! 3.2 or higher, and access your backend, you’ll see a notice about post-installation messages.</translate>

[[Image:Joomla-two-factor-authentication-post-installation-<translate>
en</translate>.png]]

<translate>
Click on the ''Review Messages'' button, you’ll see a screen which indicates that Two-Factor Authentication is Available.</translate>
<translate>
Click on the ''Enable Two-Factor Authentication'' button.</translate>

[[Image:Joomla-two-factor-authentication-enable-<translate>
en</translate>.png]]

<translate>
To set up the Two-Factor Authentication, go to the User Manager, edit a User and go to the Two-Factor Authentication Tab:</translate>

[[Image:Joomla-two-factor-authentication-tab-<translate>
en</translate>.png]]

<translate>
If the Two-Factor Authentication Tab does not appear, it is possible that the associated plugin is not enabled. In that case go to the Plugin Manager and find the Two Factor plugins. There are normally two - one for Google Authenticator and the other for Yubikey. Enable those that you intend to use. The return to the User Manager and try again.

==Authentication Methods==
===Google Authenticator=== 
</translate>
<translate>
[[wikipedia:Google_Authenticator|Google Authenticator]] is an application for smartphones and desktops created by Google which allows you to generate a six digit security password which changes every 30 seconds. In order to log in to your site, you’ll need to use your username, your password and the six digit security code which changes every thirty seconds.</translate>

<translate>
You can enable Two-Factor Authentication for the Frontend, the Backend or for Both. This can be set up in the plug-in ''Two-Factor Authentication – Google Authenticator''.</translate>

<translate>
This provides extra protection against hackers trying to log in to your account. Even if they were able to get hold of your credentials they have a maximum 30s to hack your site. This is usually not practical for hackers. In this way, the Two-Factor Authentication prevents your site against unauthorized access.</translate>

<translate>
Setting up the Two-Factor Authentication with Google Authenticator is actually really easy.</translate>

<translate>
====Step 1 – Get Google Authenticator==== 
</translate>
<translate>
Download and Install Google Authenticator on your smartphone or desktop.</translate>

[[Image:Joomla-Google-Authenticator-download-<translate>
en</translate>.png]]

<translate>
====Step 2 - Set up==== 
</translate>
<translate>
You can see a QR Code to scan with a mobile phone with the application of Google Authenticator installed.</translate>

[[Image:Joomla-Google-Authenticator-setup-<translate>
en</translate>.png]]

<translate>
====Step 3 - Activate Two-Factor Authentication==== 
</translate>
<translate>
Go to the Activate Two-Factor Authenticator field and enter the six digit security code you can see on the screen of your smartphone device. Then click on ''Save & Close''.</translate>

[[Image:Joomla-Google-Authenticator-activate-<translate>
en</translate>.png]]

<translate>
Now, your site access is protected by Two-Factor Authentication. Log out from your backend, you’ll see that instead of asking for the username and password only, Joomla! is asking for a secret key. The Secret Key is the six digit password you can see on your Google Authenticator screen.</translate>

[[Image:Joomla-Google-Authenticator-login-<translate>
en</translate>.png]]

<translate>
If you don’t enter the secret code or a random one, you won’t be able to login. This is what will happen to a hacker who tries to access your backend, since they don’t have the correct secret key.</translate>

<translate>

==Yubikey== 
</translate>
<translate>
This feature allows you to use a Yubikey secure hardware token for Two-Factor Authentication. In addition to your username and password you will also need to insert your Yubikey into your computer's USB port, click inside the Secret Key area of the site's login area and touch Yubikey's gold disk. If you have an NFC-equipped Android smartphone you can just approach a compatible Yubikey token (Yubikey Neo) to the NFC reader to copy the secret code to the device's clipboard. The secret code generated by your Yubikey is unique to your device and changes constantly. This provides extra protection against hackers logging in to your account even if they were able to get hold of your password.</translate>

<translate>
You can enable Two-Factor Authentication for the Frontend, the Backend or for Both. This can be set up in the plug-in ''Two-Factor Authentication – Yubikey''.</translate>

[[Image:Joomla-two-factor-authentication-Yubikey-<translate>
en</translate>.png]]

<translate>
===Contributor=== 
</translate>
* Nicholas Dionysopoulos
__NOTOC__
<noinclude>
<translate>

[[Category:Joomla! 3.x]]
[[Category:Joomla! 3.2]]
[[Category:Security]]
[[Category:Tutorials]]
</translate>
</noinclude>

J3.x:Two Factor Authentication

2017-06-16T12:36:09Z

Crispness: move pseudo heading

<noinclude><languages /></noinclude>
<noinclude>{{Joomla version|version=3.2|time=and after|}}
{{-}}
{{Top portal heading|color=white-bkgd|icon=lock|icon-color=#5091cd|size=3x|text-color=#333|title=<translate>
Two-Factor Authentication</translate>}}</noinclude>
<translate>
Joomla! was the first major CMS to implement Two-Factor Authentication. This adds a single-use code received on your smartphone or a Yubikey to your existing passwords to make your site extra hacker-proof.</translate>

<div class="row">
<div class="large-6 large-centered columns">
<div class="video-container">
{{#widget:YouTube|id=NbG6eehASW8}}
</div>
</div>
</div>

<translate>
Traditionally, when you want to log in to a website, you have to provide your username and your password in order to identify yourself to the system.</translate>
<translate>
The biggest problem with this approach is your username and password can be stolen or guessed. For example, if your computer is infested with malware or you try to access your site from an untrusted network, such as a public WiFi hotspot, it is possible someone could intercept your username and password. This means they can log into your site as you. Because your username and password is compromised, your site can now be hacked.</translate>

<translate>
In order to prevent that, Joomla! 3.2.0 and later versions, come with a built-in Two-Factor Authentication system that secures your site login with a secondary, single use secret code. This is called [[wp:Two-factor authentication|Two-Factor Authentication]] or shortened to 2FA. </translate>

<translate>
==Enable Two-Factor Authentication== 
</translate>
<translate>
The very first time you’re installing Joomla! 3.2 or higher, and access your backend, you’ll see a notice about post-installation messages.</translate>

[[Image:Joomla-two-factor-authentication-post-installation-<translate>
en</translate>.png]]

<translate>
Click on the ''Review Messages'' button, you’ll see a screen which indicates that Two-Factor Authentication is Available.</translate>
<translate>
Click on the ''Enable Two-Factor Authentication'' button.</translate>

[[Image:Joomla-two-factor-authentication-enable-<translate>
en</translate>.png]]

<translate>
To set up the Two-Factor Authentication, go to the User Manager, edit a User and go to the Two-Factor Authentication Tab:</translate>

[[Image:Joomla-two-factor-authentication-tab-<translate>
en</translate>.png]]

<translate>
If the Two-Factor Authentication Tab does not appear, it is possible that the associated plugin is not enabled. In that case go to the Plugin Manager and find the Two Factor plugins. There are normally two - one for Google Authenticator and the other for Yubikey. Enable those that you intend to use. The return to the User Manager and try again.

==Google Authenticator== 
</translate>
<translate>
[[wikipedia:Google_Authenticator|Google Authenticator]] is an application for smartphones and desktops created by Google which allows you to generate a six digit security password which changes every 30 seconds. In order to log in to your site, you’ll need to use your username, your password and the six digit security code which changes every thirty seconds.</translate>

<translate>
You can enable Two-Factor Authentication for the Frontend, the Backend or for Both. This can be set up in the plug-in ''Two-Factor Authentication – Google Authenticator''.</translate>

<translate>
This provides extra protection against hackers trying to log in to your account. Even if they were able to get hold of your credentials they have a maximum 30s to hack your site. This is usually not practical for hackers. In this way, the Two-Factor Authentication prevents your site against unauthorized access.</translate>

<translate>
Setting up the Two-Factor Authentication with Google Authenticator is actually really easy.</translate>

<translate>
====Step 1 – Get Google Authenticator==== 
</translate>
<translate>
Download and Install Google Authenticator on your smartphone or desktop.</translate>

[[Image:Joomla-Google-Authenticator-download-<translate>
en</translate>.png]]

<translate>
====Step 2 - Set up==== 
</translate>
<translate>
You can see a QR Code to scan with a mobile phone with the application of Google Authenticator installed.</translate>

[[Image:Joomla-Google-Authenticator-setup-<translate>
en</translate>.png]]

<translate>
====Step 3 - Activate Two-Factor Authentication==== 
</translate>
<translate>
Go to the Activate Two-Factor Authenticator field and enter the six digit security code you can see on the screen of your smartphone device. Then click on ''Save & Close''.</translate>

[[Image:Joomla-Google-Authenticator-activate-<translate>
en</translate>.png]]

<translate>
Now, your site access is protected by Two-Factor Authentication. Log out from your backend, you’ll see that instead of asking for the username and password only, Joomla! is asking for a secret key. The Secret Key is the six digit password you can see on your Google Authenticator screen.</translate>

[[Image:Joomla-Google-Authenticator-login-<translate>
en</translate>.png]]

<translate>
If you don’t enter the secret code or a random one, you won’t be able to login. This is what will happen to a hacker who tries to access your backend, since they don’t have the correct secret key.</translate>

<translate>
==Yubikey== 
</translate>
<translate>
This feature allows you to use a Yubikey secure hardware token for Two-Factor Authentication. In addition to your username and password you will also need to insert your Yubikey into your computer's USB port, click inside the Secret Key area of the site's login area and touch Yubikey's gold disk. If you have an NFC-equipped Android smartphone you can just approach a compatible Yubikey token (Yubikey Neo) to the NFC reader to copy the secret code to the device's clipboard. The secret code generated by your Yubikey is unique to your device and changes constantly. This provides extra protection against hackers logging in to your account even if they were able to get hold of your password.</translate>

<translate>
You can enable Two-Factor Authentication for the Frontend, the Backend or for Both. This can be set up in the plug-in ''Two-Factor Authentication – Yubikey''.</translate>

[[Image:Joomla-two-factor-authentication-Yubikey-<translate>
en</translate>.png]]

<translate>
===Contributor=== 
</translate>
* Nicholas Dionysopoulos
__NOTOC__
<noinclude>
<translate>

[[Category:Joomla! 3.x]]
[[Category:Joomla! 3.2]]
[[Category:Security]]
[[Category:Tutorials]]
</translate>
</noinclude>

J3.x:Two Factor Authentication

2017-06-16T12:33:50Z

Crispness: add section on enabling plugins

<noinclude><languages /></noinclude>
<noinclude>{{Joomla version|version=3.2|time=and after|}}
{{-}}
{{Top portal heading|color=white-bkgd|icon=lock|icon-color=#5091cd|size=3x|text-color=#333|title=<translate>
Two-Factor Authentication</translate>}}</noinclude>
<translate>
Joomla! was the first major CMS to implement Two-Factor Authentication. This adds a single-use code received on your smartphone or a Yubikey to your existing passwords to make your site extra hacker-proof.</translate>

<div class="row">
<div class="large-6 large-centered columns">
<div class="video-container">
{{#widget:YouTube|id=NbG6eehASW8}}
</div>
</div>
</div>

<translate>
Traditionally, when you want to log in to a website, you have to provide your username and your password in order to identify yourself to the system.</translate>
<translate>
The biggest problem with this approach is your username and password can be stolen or guessed. For example, if your computer is infested with malware or you try to access your site from an untrusted network, such as a public WiFi hotspot, it is possible someone could intercept your username and password. This means they can log into your site as you. Because your username and password is compromised, your site can now be hacked.</translate>

<translate>
In order to prevent that, Joomla! 3.2.0 and later versions, come with a built-in Two-Factor Authentication system that secures your site login with a secondary, single use secret code. This is called [[wp:Two-factor authentication|Two-Factor Authentication]] or shortened to 2FA. </translate>

<translate>
==Enable Two-Factor Authentication== 
</translate>
<translate>
The very first time you’re installing Joomla! 3.2 or higher, and access your backend, you’ll see a notice about post-installation messages.</translate>

[[Image:Joomla-two-factor-authentication-post-installation-<translate>
en</translate>.png]]

<translate>
Click on the ''Review Messages'' button, you’ll see a screen which indicates that Two-Factor Authentication is Available.</translate>
<translate>
Click on the ''Enable Two-Factor Authentication'' button.</translate>

[[Image:Joomla-two-factor-authentication-enable-<translate>
en</translate>.png]]

<translate>
To set up the Two-Factor Authentication, go to the User Manager, edit a User and go to the Two-Factor Authentication Tab:</translate>

[[Image:Joomla-two-factor-authentication-tab-<translate>
en</translate>.png]]

<translate>
Two authentication methods are available:</translate>

<translate>
If the Two-Factor Authentication Tab does not appear, it is possible that the associated plugin is not enabled. In that case go to the Plugin Manager and find the Two Factor plugins. There are normally two - one for Google Authenticator and the other for Yubikey. Enable those that you intend to use. The return to the User Manager and try again.

==Google Authenticator== 
</translate>
<translate>
[[wikipedia:Google_Authenticator|Google Authenticator]] is an application for smartphones and desktops created by Google which allows you to generate a six digit security password which changes every 30 seconds. In order to log in to your site, you’ll need to use your username, your password and the six digit security code which changes every thirty seconds.</translate>

<translate>
You can enable Two-Factor Authentication for the Frontend, the Backend or for Both. This can be set up in the plug-in ''Two-Factor Authentication – Google Authenticator''.</translate>

<translate>
This provides extra protection against hackers trying to log in to your account. Even if they were able to get hold of your credentials they have a maximum 30s to hack your site. This is usually not practical for hackers. In this way, the Two-Factor Authentication prevents your site against unauthorized access.</translate>

<translate>
Setting up the Two-Factor Authentication with Google Authenticator is actually really easy.</translate>

<translate>
====Step 1 – Get Google Authenticator==== 
</translate>
<translate>
Download and Install Google Authenticator on your smartphone or desktop.</translate>

[[Image:Joomla-Google-Authenticator-download-<translate>
en</translate>.png]]

<translate>
====Step 2 - Set up==== 
</translate>
<translate>
You can see a QR Code to scan with a mobile phone with the application of Google Authenticator installed.</translate>

[[Image:Joomla-Google-Authenticator-setup-<translate>
en</translate>.png]]

<translate>
====Step 3 - Activate Two-Factor Authentication==== 
</translate>
<translate>
Go to the Activate Two-Factor Authenticator field and enter the six digit security code you can see on the screen of your smartphone device. Then click on ''Save & Close''.</translate>

[[Image:Joomla-Google-Authenticator-activate-<translate>
en</translate>.png]]

<translate>
Now, your site access is protected by Two-Factor Authentication. Log out from your backend, you’ll see that instead of asking for the username and password only, Joomla! is asking for a secret key. The Secret Key is the six digit password you can see on your Google Authenticator screen.</translate>

[[Image:Joomla-Google-Authenticator-login-<translate>
en</translate>.png]]

<translate>
If you don’t enter the secret code or a random one, you won’t be able to login. This is what will happen to a hacker who tries to access your backend, since they don’t have the correct secret key.</translate>

<translate>
==Yubikey== 
</translate>
<translate>
This feature allows you to use a Yubikey secure hardware token for Two-Factor Authentication. In addition to your username and password you will also need to insert your Yubikey into your computer's USB port, click inside the Secret Key area of the site's login area and touch Yubikey's gold disk. If you have an NFC-equipped Android smartphone you can just approach a compatible Yubikey token (Yubikey Neo) to the NFC reader to copy the secret code to the device's clipboard. The secret code generated by your Yubikey is unique to your device and changes constantly. This provides extra protection against hackers logging in to your account even if they were able to get hold of your password.</translate>

<translate>
You can enable Two-Factor Authentication for the Frontend, the Backend or for Both. This can be set up in the plug-in ''Two-Factor Authentication – Yubikey''.</translate>

[[Image:Joomla-two-factor-authentication-Yubikey-<translate>
en</translate>.png]]

<translate>
===Contributor=== 
</translate>
* Nicholas Dionysopoulos
__NOTOC__
<noinclude>
<translate>

[[Category:Joomla! 3.x]]
[[Category:Joomla! 3.2]]
[[Category:Security]]
[[Category:Tutorials]]
</translate>
</noinclude>

Microdata

2017-06-16T09:25:46Z

Crispness: add missing quote

<noinclude><languages /></noinclude>
{{incomplete}}
<noinclude>{{Joomla version|version=3.2|time=and after}}</noinclude>
<translate>==What is Microdata?== 
Microdata is a way of adding contextual information to your website and its contents, allowing search engines to better understand the information you provide them with.</translate>
__TOC__
<translate>
Contextual information allows search engines to understand the meaning of the information presented on your website, which allows it to better answer more verbose 'natural language' queries where an understanding of the meaning helps to interpret the most relevant content to be displayed.</translate>

<translate>
Microdata can be used to explain just about anything you would ever want to explain, and there are more 'schemas' being added on a regular basis. There are several vocabularies in existence, however at present the system favoured by search engines is that of [https://schema.org schema.org].</translate>
<br>
<translate>
To understand how search engines use the microdata information take a look at [https://www.youtube.com/watch?v=A-kX0Aut-18 this short video].</translate>

<translate>==Joomla! 3.x roadmap for Microdata== </translate>
<translate>
The 3.2 release introduced the JMicrodata library, part of one of the many successful projects submitted during GSoC 2013 and the 3.3 release introduced microdata elements into two of the core component’s layouts. For 3.4, we aim to continue refining the JMicrodata library to ensure it is flexible and easy to use for users of all skill levels and continue implementing microdata elements into core layouts.</translate>

<translate>==How do I use Microdata?== 
Microdata can be added to Joomla! using template overrides or with the use of plugins which allow you to insert microdata into specific resources.</translate>
<br>
<translate>
As of '''Joomla!''' {{JVer|3.2}} there is a [https://github.com/joomla/joomla-cms/tree/master/libraries/joomla/microdata library] within Joomla! which allows developers to pull in microdata without needing to format it correctly.</translate>

<translate>==JMicrodata== 
[https://github.com/joomla/joomla-cms/blob/master/libraries/joomla/microdata/microdata.php JMicrodata] is a library to implement and output http://schema.org microdata semantics.</translate>
<br>
<br>
<translate>
The library was designed with this goals in mind:</translate>
<translate>
# Having the '''possibility to switch the Microdata Type dynamically''', you just change the Type (there are 558 different available types).</translate>
<translate>
# '''Display validated semantics''', the library takes care to display data correctly.</translate>
<translate>
# '''Enable/disable the microdata''' semantics.</translate>
<translate>
# '''Fallbacks''', you should never lose any meaningful semantic.</translate>
<translate>
The JMicrodata class uses the [https://github.com/joomla/joomla-cms/blob/master/libraries/joomla/microdata/types.json types.json] file which contains all available http://schema.org <i>Types</i> and <i>Properties</i>, that file was automatically created with the https://github.com/PAlexcom/Spider4Schema web crawler.</translate>

<translate>==How do I use the JMicrodata library?== 
First of all you need to make an instance of the library in your extensions:</translate>

<source lang="php">
<?php
$microdata = new JMicrodata('Article');
?>
</source>

<translate>
So let's suppose that you have the following string which is part of your article:</translate>

<source lang="html4strict">
<div>

<span>
Written by Alexandru Pruteanu
</span>

Here is the article text...
<div>
</source>

<translate>
And you want to add microdata semantics and you setup the current scope type as <i>Article</i>:</translate>

<source lang="php">
<?php
$microdata = new JMicrodata('Article');
?>

<div <?php echo $microdata->displayScope();?>>

<span>
Written by <?php echo $microdata->content('Alexandru Pruteanu')->property('author')->fallback('Person', 'name')->display();?>
</span>

<?php echo $microdata->content('Here is the article text...')->property('articleBody')->display();?>
<div>
</source>

<translate>
The library will display:</translate>

<source lang="html4strict">
<div itemscope itemtype='https://schema.org/Article'>

<span>
Written by
<span itemprop='author' itemscope itemtype='https://schema.org/Person'>
<span itemprop='name'>Alexandru Pruteanu</span>
</span>
</span>

<span itemprop='articleBody'>Here is the article text...</span>
<div>
</source>

<translate>
What happens if the current scope is something else than <i>Article</i>, for example a <i>Product</i> scope, and the current scope doesn't have an <i>author</i> and <i>articleBody</i> property?</translate>

<source lang="php">
<?php
$microdata = new JMicrodata('Product');
?>

<div <?php echo $microdata->displayScope();?>>

<span>
Written by <?php echo $microdata->content('Alexandru Pruteanu')->property('author')->fallback('Person', 'name')->display();?>
</span>

<?php echo $microdata->content('Here is the article text...')->property('articleBody')->display();?>
<div>
</source>

<translate>
As you've added a fallback <tt>->fallback('Person', 'name')</tt>, it will fallback to the <i>Person</i> type, and you will not lose any meaningful semantic.</translate>

<source lang="html4strict">
<div itemscope itemtype='https://schema.org/Product'>

<span>
Written by
<span itemscope itemtype='https://schema.org/Person'>
<span itemprop='name'>Alexandru Pruteanu</span>
</span>
</span>

Here is the article text...
<div>
</source>

<translate>
If you don't need all that microdata information, you just disable that feature by calling: <tt>$microdata->enable(false);</tt></translate>

<source lang="php">
<?php
$microdata = new JMicrodata('Product');
$microdata->enable(false);
?>

<div <?php echo $microdata->displayScope();?>>

<span>
Written by <?php echo $microdata->content('Alexandru Pruteanu')->property('author')->fallback('Person', 'name')->display();?>
</span>

<?php echo $microdata->content('Here is the article text...')->property('articleBody')->display();?>
<div>

</source>

<translate>
The library will display the following:</translate>

<source lang="html4strict">
<div>

<span>
Written by Alexandru Pruteanu
</span>

Here is the article text...
<div>
</source>

<translate>==JMicrodata documentation== 
All Microdata HTML output is handled by the JMicrodata class.</translate>
<br>
<br>
<code>'''JMicrodata::htmlScope($scope);'''</code><br>
<translate>
Return:</translate>

<source lang="php">
itemscope itemtype="http://schema.org/$scope"
</source>

<translate>
the HTML <i>Scope</i> of the given <i>Type</i>, must be inside a HTML tag element.</translate>
<br>
<br>
<code>'''JMicrodata::htmlProperty($property);'''</code><br>
<translate>
Return:</translate>

<source lang="php">
itemprop="$property"
</source>

<translate>
the HTML of the given <i>Property</i>, must be inside a HTML tag element.</translate>
<br>
<br>
<code>'''JMicrodata::htmlSpan($content, $property = "", $scope = "", $inverse = false);'''</code><br>
<translate>
Return:</translate>

<source lang="php">
<span itemscope itemtype="http://schema.org/$scope" itemprop="$property">
$content
</span>
</source>

<translate>
the microdata in a <span> tag, there is also available a JMicrodata::htmlDiv() method with the same functionalities.</translate>
<br>
<br>
<code>'''JMicrodata::htmlMeta($content, $property, $scope = "", $inverse = false);'''</code><br>
<translate>
Return:</translate>

<source lang="php">
<meta $property $scope content="$content">
</source>

<translate>
the microdata in a <meta> tag with the <i>content for machines</i>, this method does not add the meta tag in the <head> section of the page.</translate>
<br>
<br>
<code>'''$microdata = JMicrodata($type = "", $flag = true);'''</code><br>
<translate>
Create a new instance of the <i>JMicrodata</i> class and setup the current <i>Type</i>, the flag param is for enabling or disabling HTML microdata semantics output. Fallback to <i>Thing</i> Type if the Type isn't available or given.</translate>
<br>
<br>
<code>'''$microdata->enable($flag = true);'''</code><br>
<translate>
Enable or Disable HTML Microdata semantics output.</translate>
<br>
<br>
<code>'''$microdata->isEnabled();'''</code><br>
<translate>
Return true if Microdata semantics HTML output are enabled.</translate>
<br>
<br>
<code>'''$microdata->setType($type);'''</code><br>
<translate>
Set a new Schema.org <i>Type</i>, there is also a $microdata->getType() function to retrieve the current <i>Type</i>.</translate>
<br>
<br>
<code>'''$microdata->property($name);'''</code><br>
<translate>
Setup the <i>Property</i> if available in the current <i>Type</i> Scope, there is also a $microdata->getProperty() function to retrieve the current <i>Property</i>.</translate>
<br>
<br>
<code>'''$microdata->content($value, $machineValue = null);'''</code><br>
<translate>
Setup a <i>Text value</i> or <i>Content value</i> for the Microdata, there is also a $microdata->getContent() function to retrieve the current <i>Text value</i>.</translate>
<br>
<br>
<code>'''$microdata->fallback($type, $property);'''</code>
<br><translate>
Setup a Fallback <i>Type</i> and <i>Property</i>, there are also the $microdata->getFallbackType() and $microdata->getFallbackProperty() to retrieve the Fallback <i>Type</i> and Fallback <i>Property</i>. Fallback to <i>Thing Type</i> if the <i>Type</i> isn't available, Fallback to <i>null</i> the Property if isn't available.</translate>
<br>
<br>
<code>'''$microdata->displayScope();'''</code><br>
<translate>
Return:</translate>

<source lang="php">
itemscope itemtype="http://schema.org/$scope
</source>

<translate>
the HTML with the <i>Scope</i> of the current <i>Type</i>, must be inserted inside a tag element.</translate>

<code>'''$microdata->display($displayType = "", $emptyOutput = false);'''</code>
<translate>
Return the Microdata HTML, if the <i>Property</i> isn't available it checks for a Fallback, otherwise return ''.</translate>

<translate>
There are 4 types of $displayType:</translate>
* inline
* span
* html
* meta
<translate>


<u>This method contains the HTML Microdata display logic</u>,
If you specify the <i>$displayType</i> param, the Microdata will be returned the way you specified and expect — to,
Otherwise if the <i>$displayType</i> param is empty it will be processed by the <i>display()</i> method and returned the HTML in the right way, with the expected <i>Property</i> Type (example of expectedTypes = URL, Text, Person ...)</translate>

<translate>
— What happens if you call display($displayType = "meta") ?</translate>

<translate>
The returned HTML will be inside a <meta> HTML tag.</translate>

<translate>
— What happend if you call display()?</translate>

<translate>
The method will automatically check the expected type for the given Property, and will return the right Microdata HTML.</translate>

<translate>
There are 3 types of Microdata:</translate>

<translate>
* nested → example:</translate>
<source lang="php">
itemprop="$property" itemscope itemtype="http://schema.org/$scope"</source>

<translate>
if there is also available a $content it will output</translate>
<source lang="php">
<span itemprop="$property" itemscope itemtype="http://schema.org/$scope">$content</span></source>
<translate>

* meta → example:</translate>
<source lang="php">
<meta content="$content" itemprop="$property"></source>
<translate>
if no $content is available will output</translate>
<source lang="php">
itemprop="$property"</source>

<translate>
* normal → example:</translate>
<source lang="php">
itemprop="$property"</source>
<translate>
if there is available a $content will output</translate>
<source lang="php">
<span itemprop="$property">$content</span></source>

<translate>
For some usage examples you can see the library test file https://github.com/joomla/joomla-cms/blob/master/tests/unit/suites/libraries/joomla/microdata/JMicrodataTest.php
</translate>

<translate>==How To implement Microdata yourself== 
* [[S:MyLanguage/How To Implement Rich Snippet for Breadcrumbs|How To Implement Rich Snippet for Breadcrumbs]]</translate>

<noinclude>
<translate>
[[Category:Search Engine Optimisation]]</translate>
</noinclude>

Microdata

2017-06-16T09:24:09Z

Crispness: add missing quote

<noinclude><languages /></noinclude>
{{incomplete}}
<noinclude>{{Joomla version|version=3.2|time=and after}}</noinclude>
<translate>==What is Microdata?== 
Microdata is a way of adding contextual information to your website and its contents, allowing search engines to better understand the information you provide them with.</translate>
__TOC__
<translate>
Contextual information allows search engines to understand the meaning of the information presented on your website, which allows it to better answer more verbose 'natural language' queries where an understanding of the meaning helps to interpret the most relevant content to be displayed.</translate>

<translate>
Microdata can be used to explain just about anything you would ever want to explain, and there are more 'schemas' being added on a regular basis. There are several vocabularies in existence, however at present the system favoured by search engines is that of [https://schema.org schema.org].</translate>
<br>
<translate>
To understand how search engines use the microdata information take a look at [https://www.youtube.com/watch?v=A-kX0Aut-18 this short video].</translate>

<translate>==Joomla! 3.x roadmap for Microdata== </translate>
<translate>
The 3.2 release introduced the JMicrodata library, part of one of the many successful projects submitted during GSoC 2013 and the 3.3 release introduced microdata elements into two of the core component’s layouts. For 3.4, we aim to continue refining the JMicrodata library to ensure it is flexible and easy to use for users of all skill levels and continue implementing microdata elements into core layouts.</translate>

<translate>==How do I use Microdata?== 
Microdata can be added to Joomla! using template overrides or with the use of plugins which allow you to insert microdata into specific resources.</translate>
<br>
<translate>
As of '''Joomla!''' {{JVer|3.2}} there is a [https://github.com/joomla/joomla-cms/tree/master/libraries/joomla/microdata library] within Joomla! which allows developers to pull in microdata without needing to format it correctly.</translate>

<translate>==JMicrodata== 
[https://github.com/joomla/joomla-cms/blob/master/libraries/joomla/microdata/microdata.php JMicrodata] is a library to implement and output http://schema.org microdata semantics.</translate>
<br>
<br>
<translate>
The library was designed with this goals in mind:</translate>
<translate>
# Having the '''possibility to switch the Microdata Type dynamically''', you just change the Type (there are 558 different available types).</translate>
<translate>
# '''Display validated semantics''', the library takes care to display data correctly.</translate>
<translate>
# '''Enable/disable the microdata''' semantics.</translate>
<translate>
# '''Fallbacks''', you should never lose any meaningful semantic.</translate>
<translate>
The JMicrodata class uses the [https://github.com/joomla/joomla-cms/blob/master/libraries/joomla/microdata/types.json types.json] file which contains all available http://schema.org <i>Types</i> and <i>Properties</i>, that file was automatically created with the https://github.com/PAlexcom/Spider4Schema web crawler.</translate>

<translate>==How do I use the JMicrodata library?== 
First of all you need to make an instance of the library in your extensions:</translate>

<source lang="php">
<?php
$microdata = new JMicrodata('Article');
?>
</source>

<translate>
So let's suppose that you have the following string which is part of your article:</translate>

<source lang="html4strict">
<div>

<span>
Written by Alexandru Pruteanu
</span>

Here is the article text...
<div>
</source>

<translate>
And you want to add microdata semantics and you setup the current scope type as <i>Article</i>:</translate>

<source lang="php">
<?php
$microdata = new JMicrodata('Article');
?>

<div <?php echo $microdata->displayScope();?>>

<span>
Written by <?php echo $microdata->content('Alexandru Pruteanu')->property('author')->fallback('Person', 'name')->display();?>
</span>

<?php echo $microdata->content('Here is the article text...')->property('articleBody')->display();?>
<div>
</source>

<translate>
The library will display:</translate>

<source lang="html4strict">
<div itemscope itemtype='https://schema.org/Article'>

<span>
Written by
<span itemprop='author' itemscope itemtype='https://schema.org/Person'>
<span itemprop='name'>Alexandru Pruteanu</span>
</span>
</span>

<span itemprop='articleBody'>Here is the article text...</span>
<div>
</source>

<translate>
What happens if the current scope is something else than <i>Article</i>, for example a <i>Product</i> scope, and the current scope doesn't have an <i>author</i> and <i>articleBody</i> property?</translate>

<source lang="php">
<?php
$microdata = new JMicrodata('Product');
?>

<div <?php echo $microdata->displayScope();?>>

<span>
Written by <?php echo $microdata->content('Alexandru Pruteanu')->property('author')->fallback('Person', 'name')->display();?>
</span>

<?php echo $microdata->content('Here is the article text...')->property('articleBody')->display();?>
<div>
</source>

<translate>
As you've added a fallback <tt>->fallback('Person', 'name')</tt>, it will fallback to the <i>Person</i> type, and you will not lose any meaningful semantic.</translate>

<source lang="html4strict">
<div itemscope itemtype='https://schema.org/Product'>

<span>
Written by
<span itemscope itemtype='https://schema.org/Person'>
<span itemprop='name'>Alexandru Pruteanu</span>
</span>
</span>

Here is the article text...
<div>
</source>

<translate>
If you don't need all that microdata information, you just disable that feature by calling: <tt>$microdata->enable(false);</tt></translate>

<source lang="php">
<?php
$microdata = new JMicrodata('Product');
$microdata->enable(false);
?>

<div <?php echo $microdata->displayScope();?>>

<span>
Written by <?php echo $microdata->content('Alexandru Pruteanu')->property('author')->fallback('Person', 'name')->display();?>
</span>

<?php echo $microdata->content('Here is the article text...')->property('articleBody')->display();?>
<div>

</source>

<translate>
The library will display the following:</translate>

<source lang="html4strict">
<div>

<span>
Written by Alexandru Pruteanu
</span>

Here is the article text...
<div>
</source>

<translate>==JMicrodata documentation== 
All Microdata HTML output is handled by the JMicrodata class.</translate>
<br>
<br>
<code>'''JMicrodata::htmlScope($scope);'''</code><br>
<translate>
Return:</translate>

<source lang="php">
itemscope itemtype="http://schema.org/$scope"
</source>

<translate>
the HTML <i>Scope</i> of the given <i>Type</i>, must be inside a HTML tag element.</translate>
<br>
<br>
<code>'''JMicrodata::htmlProperty($property);'''</code><br>
<translate>
Return:</translate>

<source lang="php">
itemprop="$property"
</source>

<translate>
the HTML of the given <i>Property</i>, must be inside a HTML tag element.</translate>
<br>
<br>
<code>'''JMicrodata::htmlSpan($content, $property = "", $scope = "", $inverse = false);'''</code><br>
<translate>
Return:</translate>

<source lang="php">
<span itemscope itemtype="http://schema.org/$scope" itemprop="$property">
$content
</span>
</source>

<translate>
the microdata in a <span> tag, there is also available a JMicrodata::htmlDiv() method with the same functionalities.</translate>
<br>
<br>
<code>'''JMicrodata::htmlMeta($content, $property, $scope = "", $inverse = false);'''</code><br>
<translate>
Return:</translate>

<source lang="php">
<meta $property $scope content="$content">
</source>

<translate>
the microdata in a <meta> tag with the <i>content for machines</i>, this method does not add the meta tag in the <head> section of the page.</translate>
<br>
<br>
<code>'''$microdata = JMicrodata($type = "", $flag = true);'''</code><br>
<translate>
Create a new instance of the <i>JMicrodata</i> class and setup the current <i>Type</i>, the flag param is for enabling or disabling HTML microdata semantics output. Fallback to <i>Thing</i> Type if the Type isn't available or given.</translate>
<br>
<br>
<code>'''$microdata->enable($flag = true);'''</code><br>
<translate>
Enable or Disable HTML Microdata semantics output.</translate>
<br>
<br>
<code>'''$microdata->isEnabled();'''</code><br>
<translate>
Return true if Microdata semantics HTML output are enabled.</translate>
<br>
<br>
<code>'''$microdata->setType($type);'''</code><br>
<translate>
Set a new Schema.org <i>Type</i>, there is also a $microdata->getType() function to retrieve the current <i>Type</i>.</translate>
<br>
<br>
<code>'''$microdata->property($name);'''</code><br>
<translate>
Setup the <i>Property</i> if available in the current <i>Type</i> Scope, there is also a $microdata->getProperty() function to retrieve the current <i>Property</i>.</translate>
<br>
<br>
<code>'''$microdata->content($value, $machineValue = null);'''</code><br>
<translate>
Setup a <i>Text value</i> or <i>Content value</i> for the Microdata, there is also a $microdata->getContent() function to retrieve the current <i>Text value</i>.</translate>
<br>
<br>
<code>'''$microdata->fallback($type, $property);'''</code>
<br><translate>
Setup a Fallback <i>Type</i> and <i>Property</i>, there are also the $microdata->getFallbackType() and $microdata->getFallbackProperty() to retrieve the Fallback <i>Type</i> and Fallback <i>Property</i>. Fallback to <i>Thing Type</i> if the <i>Type</i> isn't available, Fallback to <i>null</i> the Property if isn't available.</translate>
<br>
<br>
<code>'''$microdata->displayScope();'''</code><br>
<translate>
Return:</translate>

<source lang="php">
itemscope itemtype="http://schema.org/$scope
</source>

<translate>
the HTML with the <i>Scope</i> of the current <i>Type</i>, must be inserted inside a tag element.</translate>

<code>'''$microdata->display($displayType = "", $emptyOutput = false);'''</code>
<translate>
Return the Microdata HTML, if the <i>Property</i> isn't available it checks for a Fallback, otherwise return ''.</translate>

<translate>
There are 4 types of $displayType:</translate>
* inline
* span
* html
* meta
<translate>


<u>This method contains the HTML Microdata display logic</u>,
If you specify the <i>$displayType</i> param, the Microdata will be returned the way you specified and expect — to,
Otherwise if the <i>$displayType</i> param is empty it will be processed by the <i>display()</i> method and returned the HTML in the right way, with the expected <i>Property</i> Type (example of expectedTypes = URL, Text, Person ...)</translate>

<translate>
— What happens if you call display($displayType = "meta") ?</translate>

<translate>
The returned HTML will be inside a <meta> HTML tag.</translate>

<translate>
— What happend if you call display()?</translate>

<translate>
The method will automatically check the expected type for the given Property, and will return the right Microdata HTML.</translate>

<translate>
There are 3 types of Microdata:</translate>

<translate>
* nested → example:</translate>
<source lang="php">
itemprop="$property" itemscope itemtype="http://schema.org/$scope</source>

<translate>
if there is also available a $content it will output</translate>
<source lang="php">
<span itemprop="$property" itemscope itemtype="http://schema.org/$scope">$content</span></source>
<translate>

* meta → example:</translate>
<source lang="php">
<meta content="$content" itemprop="$property"></source>
<translate>
if no $content is available will output</translate>
<source lang="php">
itemprop="$property"</source>

<translate>
* normal → example:</translate>
<source lang="php">
itemprop="$property"</source>
<translate>
if there is available a $content will output</translate>
<source lang="php">
<span itemprop="$property">$content</span></source>

<translate>
For some usage examples you can see the library test file https://github.com/joomla/joomla-cms/blob/master/tests/unit/suites/libraries/joomla/microdata/JMicrodataTest.php
</translate>

<translate>==How To implement Microdata yourself== 
* [[S:MyLanguage/How To Implement Rich Snippet for Breadcrumbs|How To Implement Rich Snippet for Breadcrumbs]]</translate>

<noinclude>
<translate>
[[Category:Search Engine Optimisation]]</translate>
</noinclude>

User:Crispness

2012-08-08T11:50:05Z

Crispness: blank page

User:Crispness

2012-08-08T11:49:49Z

Crispness: Created page with "Hello"

Hello

Help25:Menus Menu Item Contact Category

2012-08-08T08:16:21Z

Crispness: /* Quick Tips */

{{inuse}}

Used to show all of the published Contacts in a given Category. Note that Contact Categories are separate from Article Categories. Contacts and Contact Categories are entered by selecting Components/Contacts. See [[screen.contactmanager.15|Contact Manager]] and [[screen.categories.15|Category Manager]] for more information.
=Menu Item Contacts: List Contacts in a Category =

==How To Access==
To create a new Category List Menu Item:
* Select Menus → [name of the menu] from the drop-down menu on the back-end of your Joomla! installation (for example, Menus → Main Menu).
* Click '''New''' to create a new menu item or click on an existing item to edit.
* Click the Menu Item Type Select button and then click the '''List contacts in a category''' link under Contacts.

To edit an existing Category List Menu Item, click its Title in Menu Manager: Menu Items.

==Description==
Used to show contacts belonging to a specific Category in a list layout.
{{Chunk25:colheader|List Layout}}

==Screenshot==
[[File:Help25-contact-category-list-screenshot.png|frame|none]]

==Column Headers==

===Common Options===
See [[Help25:Menus_Menu_Item_Manager_Edit|Menu Item Manager: New Menu Item]] for help on fields common to all Menu Item types, including Details, Link Type Options, Page Display Options, Metadata Options, and Module Assignments for this Menu Item.

===Required Settings===
This layout requires that you select a category. This is done in the list box shown below.
[[File:Help25-chunk-article-category-select-category.png|frame|none]]
{{Chunk25:colheader|Choose a category}}

===Category Options===
The Category Options control the way that category information is shown in the layout. The Category List Layout has the following Category Options, as shown below.
[[Image:Help25-chunk-article-category-category-options.png|frame|none]]
{{Chunk25:colheader|Category Title}}
{{Chunk25:colheader|Category Description}}
{{Chunk25:colheader|Category Image}}
{{Chunk25:colheader|Subcategory Levels}}
{{Chunk25:colheader|Empty Categories}}
{{Chunk25:colheader|No Articles Message}}
{{Chunk25:colheader|Subcategories Descriptions}}
{{Chunk25:colheader|No Articles in Category}}
{{Chunk25:colheader|Page Subheading}}

===List Layouts===
List Layout Options control the appearance of the list layout.
[[File:Help25-chunk-article-category-list-layout-options.png|frame|none]]
{{Chunk25:colheader|Display Select}}
{{Chunk25:colheader|Filter Field}}
{{Chunk25:colheader|Table Headings}}
{{Chunk25:colheader|Show Date}}
{{Chunk25:colheader|Date Format}}
{{Chunk25:colheader|Show Hits in List}}
{{Chunk25:colheader|Show Author in List}}
{{Chunk25:colheader|Category Order}}
{{Chunk25:colheader|Article Order}}
{{Chunk25:colheader|Date for Ordering}}
{{Chunk25:colheader|Pagination}}
{{Chunk25:colheader|Pagination Results}}
{{Chunk25:colheader|No Articles to List}}

===Article Options===
The Category List Layout has the following Article Options, as shown below. These options determine how the articles will show in the list layout.
[[Image:Help25-article-featured-article-options.png|frame|none]]
In addition to Yes/No or Hide/Show, these options allow the following settings.
*''Use Global:'' Use the default value from [[Help25:Content_Article_Manager#Options|Article Manager Options]].

The Article Options are as follows.
{{Chunk25:colheader|Show Title}}
{{Chunk25:colheader|Linked Titles}}
{{Chunk25:colheader|Show Intro Text}}
{{Chunk25:colheader|Show Category}}
{{Chunk25:colheader|Link Category}}
{{Chunk25:colheader|Show Parent}}
{{Chunk25:colheader|Link Parent}}
{{Chunk25:colheader|Show Author}}
{{Chunk25:colheader|Link Author}}
{{Chunk25:colheader|Show Create Date}}
{{Chunk25:colheader|Show Modify Date}}
{{Chunk25:colheader|Show Publish Date}}
{{Chunk25:colheader|Show Navigation}}
{{Chunk25:colheader|Show Voting}}
{{Chunk25:colheader|Show Read More}}
{{Chunk25:colheader|Show Title with Read More}}
{{Chunk25:colheader|Show Icons}}
{{Chunk25:colheader|Show Print Icon}}
{{Chunk25:colheader|Show Email Icon}}
{{Chunk25:colheader|Show Hits}}
{{Chunk25:colheader|Show Unauthorised Links}}

===Integration Options===
The Featured Articles layout has the following Integration Options.
[[File:Help25-chunk-integration-options.png‎|frame|none]]
These determine whether a news feed will be available for the page and what information it will show.
{{Chunk25:colheader|Show Feed Link}}
{{Chunk25:colheader|For each feed item show}}

==Toolbar==
At the top right you will see the toolbar:

[[File:Help25-chunk-menu-item-toolbar.png]]

The functions are:
{{Chunk25:Help_screen_toolbar_icon_Save|menu item}}
{{Chunk25:Help_screen_toolbar_icon_SaveAndClose|menu item}}
{{Chunk25:Help_screen_toolbar_icon_SaveAndNew|menu item}}
{{Chunk25:Help_screen_toolbar_icon_SaveAsCopy|menu item}}
{{Chunk25:Help_screen_toolbar_icon_Cancel}}
{{Chunk25:Help_screen_toolbar_icon_Help}}

==Quick Tips==
* The Category List layout is a convenient way to list a compact directory of contacts in a category that can include filtering and searching.

==Related Information==
* To create a new Category see [[Help25:Components_Content_Categories_Edit|Category Manager: Add or Edit]].
* To create a new menu see [[Help25:Menus_Menu_Manager|Menus Menu Manager]].

<noinclude>{{cathelp|2.5|Menu Item Manager Help Screens|Menus Helps Screens}}</noinclude>
<noinclude>{{cathelp|2.5|Menu Item Manager Help Screens|Menus Helps Screens}}</noinclude>

Help25:Menus Menu Item Contact Category

2012-08-08T08:15:29Z

Crispness: /* Menu Item Articles: Category List */

{{inuse}}

Used to show all of the published Contacts in a given Category. Note that Contact Categories are separate from Article Categories. Contacts and Contact Categories are entered by selecting Components/Contacts. See [[screen.contactmanager.15|Contact Manager]] and [[screen.categories.15|Category Manager]] for more information.
=Menu Item Contacts: List Contacts in a Category =

==How To Access==
To create a new Category List Menu Item:
* Select Menus → [name of the menu] from the drop-down menu on the back-end of your Joomla! installation (for example, Menus → Main Menu).
* Click '''New''' to create a new menu item or click on an existing item to edit.
* Click the Menu Item Type Select button and then click the '''List contacts in a category''' link under Contacts.

To edit an existing Category List Menu Item, click its Title in Menu Manager: Menu Items.

==Description==
Used to show contacts belonging to a specific Category in a list layout.
{{Chunk25:colheader|List Layout}}

==Screenshot==
[[File:Help25-contact-category-list-screenshot.png|frame|none]]

==Column Headers==

===Common Options===
See [[Help25:Menus_Menu_Item_Manager_Edit|Menu Item Manager: New Menu Item]] for help on fields common to all Menu Item types, including Details, Link Type Options, Page Display Options, Metadata Options, and Module Assignments for this Menu Item.

===Required Settings===
This layout requires that you select a category. This is done in the list box shown below.
[[File:Help25-chunk-article-category-select-category.png|frame|none]]
{{Chunk25:colheader|Choose a category}}

===Category Options===
The Category Options control the way that category information is shown in the layout. The Category List Layout has the following Category Options, as shown below.
[[Image:Help25-chunk-article-category-category-options.png|frame|none]]
{{Chunk25:colheader|Category Title}}
{{Chunk25:colheader|Category Description}}
{{Chunk25:colheader|Category Image}}
{{Chunk25:colheader|Subcategory Levels}}
{{Chunk25:colheader|Empty Categories}}
{{Chunk25:colheader|No Articles Message}}
{{Chunk25:colheader|Subcategories Descriptions}}
{{Chunk25:colheader|No Articles in Category}}
{{Chunk25:colheader|Page Subheading}}

===List Layouts===
List Layout Options control the appearance of the list layout.
[[File:Help25-chunk-article-category-list-layout-options.png|frame|none]]
{{Chunk25:colheader|Display Select}}
{{Chunk25:colheader|Filter Field}}
{{Chunk25:colheader|Table Headings}}
{{Chunk25:colheader|Show Date}}
{{Chunk25:colheader|Date Format}}
{{Chunk25:colheader|Show Hits in List}}
{{Chunk25:colheader|Show Author in List}}
{{Chunk25:colheader|Category Order}}
{{Chunk25:colheader|Article Order}}
{{Chunk25:colheader|Date for Ordering}}
{{Chunk25:colheader|Pagination}}
{{Chunk25:colheader|Pagination Results}}
{{Chunk25:colheader|No Articles to List}}

===Article Options===
The Category List Layout has the following Article Options, as shown below. These options determine how the articles will show in the list layout.
[[Image:Help25-article-featured-article-options.png|frame|none]]
In addition to Yes/No or Hide/Show, these options allow the following settings.
*''Use Global:'' Use the default value from [[Help25:Content_Article_Manager#Options|Article Manager Options]].

The Article Options are as follows.
{{Chunk25:colheader|Show Title}}
{{Chunk25:colheader|Linked Titles}}
{{Chunk25:colheader|Show Intro Text}}
{{Chunk25:colheader|Show Category}}
{{Chunk25:colheader|Link Category}}
{{Chunk25:colheader|Show Parent}}
{{Chunk25:colheader|Link Parent}}
{{Chunk25:colheader|Show Author}}
{{Chunk25:colheader|Link Author}}
{{Chunk25:colheader|Show Create Date}}
{{Chunk25:colheader|Show Modify Date}}
{{Chunk25:colheader|Show Publish Date}}
{{Chunk25:colheader|Show Navigation}}
{{Chunk25:colheader|Show Voting}}
{{Chunk25:colheader|Show Read More}}
{{Chunk25:colheader|Show Title with Read More}}
{{Chunk25:colheader|Show Icons}}
{{Chunk25:colheader|Show Print Icon}}
{{Chunk25:colheader|Show Email Icon}}
{{Chunk25:colheader|Show Hits}}
{{Chunk25:colheader|Show Unauthorised Links}}

===Integration Options===
The Featured Articles layout has the following Integration Options.
[[File:Help25-chunk-integration-options.png‎|frame|none]]
These determine whether a news feed will be available for the page and what information it will show.
{{Chunk25:colheader|Show Feed Link}}
{{Chunk25:colheader|For each feed item show}}

==Toolbar==
At the top right you will see the toolbar:

[[File:Help25-chunk-menu-item-toolbar.png]]

The functions are:
{{Chunk25:Help_screen_toolbar_icon_Save|menu item}}
{{Chunk25:Help_screen_toolbar_icon_SaveAndClose|menu item}}
{{Chunk25:Help_screen_toolbar_icon_SaveAndNew|menu item}}
{{Chunk25:Help_screen_toolbar_icon_SaveAsCopy|menu item}}
{{Chunk25:Help_screen_toolbar_icon_Cancel}}
{{Chunk25:Help_screen_toolbar_icon_Help}}

==Quick Tips==
* The Category List layout is a convenient way to list a compact directory of articles in a category that can include filtering and searching.

==Related Information==
* To create a new Category see [[Help25:Components_Content_Categories_Edit|Category Manager: Add or Edit]].
* To create a new menu see [[Help25:Menus_Menu_Manager|Menus Menu Manager]].

<noinclude>{{cathelp|2.5|Menu Item Manager Help Screens|Menus Helps Screens}}</noinclude>
<noinclude>{{cathelp|2.5|Menu Item Manager Help Screens|Menus Helps Screens}}</noinclude>

Help25:Menus Menu Item Contact Category

2012-08-08T08:14:29Z

Crispness: /* Description */

{{inuse}}

Used to show all of the published Contacts in a given Category. Note that Contact Categories are separate from Article Categories. Contacts and Contact Categories are entered by selecting Components/Contacts. See [[screen.contactmanager.15|Contact Manager]] and [[screen.categories.15|Category Manager]] for more information.
=Menu Item Articles: Category List=

==How To Access==
To create a new Category List Menu Item:
* Select Menus → [name of the menu] from the drop-down menu on the back-end of your Joomla! installation (for example, Menus → Main Menu).
* Click '''New''' to create a new menu item or click on an existing item to edit.
* Click the Menu Item Type Select button and then click the '''List contacts in a category''' link under Contacts.

To edit an existing Category List Menu Item, click its Title in Menu Manager: Menu Items.

==Description==
Used to show contacts belonging to a specific Category in a list layout.
{{Chunk25:colheader|List Layout}}

==Screenshot==
[[File:Help25-contact-category-list-screenshot.png|frame|none]]

==Column Headers==

===Common Options===
See [[Help25:Menus_Menu_Item_Manager_Edit|Menu Item Manager: New Menu Item]] for help on fields common to all Menu Item types, including Details, Link Type Options, Page Display Options, Metadata Options, and Module Assignments for this Menu Item.

===Required Settings===
This layout requires that you select a category. This is done in the list box shown below.
[[File:Help25-chunk-article-category-select-category.png|frame|none]]
{{Chunk25:colheader|Choose a category}}

===Category Options===
The Category Options control the way that category information is shown in the layout. The Category List Layout has the following Category Options, as shown below.
[[Image:Help25-chunk-article-category-category-options.png|frame|none]]
{{Chunk25:colheader|Category Title}}
{{Chunk25:colheader|Category Description}}
{{Chunk25:colheader|Category Image}}
{{Chunk25:colheader|Subcategory Levels}}
{{Chunk25:colheader|Empty Categories}}
{{Chunk25:colheader|No Articles Message}}
{{Chunk25:colheader|Subcategories Descriptions}}
{{Chunk25:colheader|No Articles in Category}}
{{Chunk25:colheader|Page Subheading}}

===List Layouts===
List Layout Options control the appearance of the list layout.
[[File:Help25-chunk-article-category-list-layout-options.png|frame|none]]
{{Chunk25:colheader|Display Select}}
{{Chunk25:colheader|Filter Field}}
{{Chunk25:colheader|Table Headings}}
{{Chunk25:colheader|Show Date}}
{{Chunk25:colheader|Date Format}}
{{Chunk25:colheader|Show Hits in List}}
{{Chunk25:colheader|Show Author in List}}
{{Chunk25:colheader|Category Order}}
{{Chunk25:colheader|Article Order}}
{{Chunk25:colheader|Date for Ordering}}
{{Chunk25:colheader|Pagination}}
{{Chunk25:colheader|Pagination Results}}
{{Chunk25:colheader|No Articles to List}}

===Article Options===
The Category List Layout has the following Article Options, as shown below. These options determine how the articles will show in the list layout.
[[Image:Help25-article-featured-article-options.png|frame|none]]
In addition to Yes/No or Hide/Show, these options allow the following settings.
*''Use Global:'' Use the default value from [[Help25:Content_Article_Manager#Options|Article Manager Options]].

The Article Options are as follows.
{{Chunk25:colheader|Show Title}}
{{Chunk25:colheader|Linked Titles}}
{{Chunk25:colheader|Show Intro Text}}
{{Chunk25:colheader|Show Category}}
{{Chunk25:colheader|Link Category}}
{{Chunk25:colheader|Show Parent}}
{{Chunk25:colheader|Link Parent}}
{{Chunk25:colheader|Show Author}}
{{Chunk25:colheader|Link Author}}
{{Chunk25:colheader|Show Create Date}}
{{Chunk25:colheader|Show Modify Date}}
{{Chunk25:colheader|Show Publish Date}}
{{Chunk25:colheader|Show Navigation}}
{{Chunk25:colheader|Show Voting}}
{{Chunk25:colheader|Show Read More}}
{{Chunk25:colheader|Show Title with Read More}}
{{Chunk25:colheader|Show Icons}}
{{Chunk25:colheader|Show Print Icon}}
{{Chunk25:colheader|Show Email Icon}}
{{Chunk25:colheader|Show Hits}}
{{Chunk25:colheader|Show Unauthorised Links}}

===Integration Options===
The Featured Articles layout has the following Integration Options.
[[File:Help25-chunk-integration-options.png‎|frame|none]]
These determine whether a news feed will be available for the page and what information it will show.
{{Chunk25:colheader|Show Feed Link}}
{{Chunk25:colheader|For each feed item show}}

==Toolbar==
At the top right you will see the toolbar:

[[File:Help25-chunk-menu-item-toolbar.png]]

The functions are:
{{Chunk25:Help_screen_toolbar_icon_Save|menu item}}
{{Chunk25:Help_screen_toolbar_icon_SaveAndClose|menu item}}
{{Chunk25:Help_screen_toolbar_icon_SaveAndNew|menu item}}
{{Chunk25:Help_screen_toolbar_icon_SaveAsCopy|menu item}}
{{Chunk25:Help_screen_toolbar_icon_Cancel}}
{{Chunk25:Help_screen_toolbar_icon_Help}}

==Quick Tips==
* The Category List layout is a convenient way to list a compact directory of articles in a category that can include filtering and searching.

==Related Information==
* To create a new Category see [[Help25:Components_Content_Categories_Edit|Category Manager: Add or Edit]].
* To create a new menu see [[Help25:Menus_Menu_Manager|Menus Menu Manager]].

<noinclude>{{cathelp|2.5|Menu Item Manager Help Screens|Menus Helps Screens}}</noinclude>
<noinclude>{{cathelp|2.5|Menu Item Manager Help Screens|Menus Helps Screens}}</noinclude>

Help25:Menus Menu Item Contact Category

2012-08-08T08:14:04Z

Crispness: rm unrequired templates

{{inuse}}

Used to show all of the published Contacts in a given Category. Note that Contact Categories are separate from Article Categories. Contacts and Contact Categories are entered by selecting Components/Contacts. See [[screen.contactmanager.15|Contact Manager]] and [[screen.categories.15|Category Manager]] for more information.
=Menu Item Articles: Category List=

==How To Access==
To create a new Category List Menu Item:
* Select Menus → [name of the menu] from the drop-down menu on the back-end of your Joomla! installation (for example, Menus → Main Menu).
* Click '''New''' to create a new menu item or click on an existing item to edit.
* Click the Menu Item Type Select button and then click the '''List contacts in a category''' link under Contacts.

To edit an existing Category List Menu Item, click its Title in Menu Manager: Menu Items.

==Description==
Used to show articles belonging to a specific Category in a list layout.
{{Chunk25:colheader|List Layout}}

==Screenshot==
[[File:Help25-contact-category-list-screenshot.png|frame|none]]

==Column Headers==

===Common Options===
See [[Help25:Menus_Menu_Item_Manager_Edit|Menu Item Manager: New Menu Item]] for help on fields common to all Menu Item types, including Details, Link Type Options, Page Display Options, Metadata Options, and Module Assignments for this Menu Item.

===Required Settings===
This layout requires that you select a category. This is done in the list box shown below.
[[File:Help25-chunk-article-category-select-category.png|frame|none]]
{{Chunk25:colheader|Choose a category}}

===Category Options===
The Category Options control the way that category information is shown in the layout. The Category List Layout has the following Category Options, as shown below.
[[Image:Help25-chunk-article-category-category-options.png|frame|none]]
{{Chunk25:colheader|Category Title}}
{{Chunk25:colheader|Category Description}}
{{Chunk25:colheader|Category Image}}
{{Chunk25:colheader|Subcategory Levels}}
{{Chunk25:colheader|Empty Categories}}
{{Chunk25:colheader|No Articles Message}}
{{Chunk25:colheader|Subcategories Descriptions}}
{{Chunk25:colheader|No Articles in Category}}
{{Chunk25:colheader|Page Subheading}}

===List Layouts===
List Layout Options control the appearance of the list layout.
[[File:Help25-chunk-article-category-list-layout-options.png|frame|none]]
{{Chunk25:colheader|Display Select}}
{{Chunk25:colheader|Filter Field}}
{{Chunk25:colheader|Table Headings}}
{{Chunk25:colheader|Show Date}}
{{Chunk25:colheader|Date Format}}
{{Chunk25:colheader|Show Hits in List}}
{{Chunk25:colheader|Show Author in List}}
{{Chunk25:colheader|Category Order}}
{{Chunk25:colheader|Article Order}}
{{Chunk25:colheader|Date for Ordering}}
{{Chunk25:colheader|Pagination}}
{{Chunk25:colheader|Pagination Results}}
{{Chunk25:colheader|No Articles to List}}

===Article Options===
The Category List Layout has the following Article Options, as shown below. These options determine how the articles will show in the list layout.
[[Image:Help25-article-featured-article-options.png|frame|none]]
In addition to Yes/No or Hide/Show, these options allow the following settings.
*''Use Global:'' Use the default value from [[Help25:Content_Article_Manager#Options|Article Manager Options]].

The Article Options are as follows.
{{Chunk25:colheader|Show Title}}
{{Chunk25:colheader|Linked Titles}}
{{Chunk25:colheader|Show Intro Text}}
{{Chunk25:colheader|Show Category}}
{{Chunk25:colheader|Link Category}}
{{Chunk25:colheader|Show Parent}}
{{Chunk25:colheader|Link Parent}}
{{Chunk25:colheader|Show Author}}
{{Chunk25:colheader|Link Author}}
{{Chunk25:colheader|Show Create Date}}
{{Chunk25:colheader|Show Modify Date}}
{{Chunk25:colheader|Show Publish Date}}
{{Chunk25:colheader|Show Navigation}}
{{Chunk25:colheader|Show Voting}}
{{Chunk25:colheader|Show Read More}}
{{Chunk25:colheader|Show Title with Read More}}
{{Chunk25:colheader|Show Icons}}
{{Chunk25:colheader|Show Print Icon}}
{{Chunk25:colheader|Show Email Icon}}
{{Chunk25:colheader|Show Hits}}
{{Chunk25:colheader|Show Unauthorised Links}}

===Integration Options===
The Featured Articles layout has the following Integration Options.
[[File:Help25-chunk-integration-options.png‎|frame|none]]
These determine whether a news feed will be available for the page and what information it will show.
{{Chunk25:colheader|Show Feed Link}}
{{Chunk25:colheader|For each feed item show}}

==Toolbar==
At the top right you will see the toolbar:

[[File:Help25-chunk-menu-item-toolbar.png]]

The functions are:
{{Chunk25:Help_screen_toolbar_icon_Save|menu item}}
{{Chunk25:Help_screen_toolbar_icon_SaveAndClose|menu item}}
{{Chunk25:Help_screen_toolbar_icon_SaveAndNew|menu item}}
{{Chunk25:Help_screen_toolbar_icon_SaveAsCopy|menu item}}
{{Chunk25:Help_screen_toolbar_icon_Cancel}}
{{Chunk25:Help_screen_toolbar_icon_Help}}

==Quick Tips==
* The Category List layout is a convenient way to list a compact directory of articles in a category that can include filtering and searching.

==Related Information==
* To create a new Category see [[Help25:Components_Content_Categories_Edit|Category Manager: Add or Edit]].
* To create a new menu see [[Help25:Menus_Menu_Manager|Menus Menu Manager]].

<noinclude>{{cathelp|2.5|Menu Item Manager Help Screens|Menus Helps Screens}}</noinclude>
<noinclude>{{cathelp|2.5|Menu Item Manager Help Screens|Menus Helps Screens}}</noinclude>

Help25:Menus Menu Item Contact Category

2012-08-08T08:13:02Z

Crispness: /* Screenshot */ correct screenshot file name

{{page|references wrong version}}
{{page|has wrong image}}
{{inuse}}

Used to show all of the published Contacts in a given Category. Note that Contact Categories are separate from Article Categories. Contacts and Contact Categories are entered by selecting Components/Contacts. See [[screen.contactmanager.15|Contact Manager]] and [[screen.categories.15|Category Manager]] for more information.
=Menu Item Articles: Category List=

==How To Access==
To create a new Category List Menu Item:
* Select Menus → [name of the menu] from the drop-down menu on the back-end of your Joomla! installation (for example, Menus → Main Menu).
* Click '''New''' to create a new menu item or click on an existing item to edit.
* Click the Menu Item Type Select button and then click the '''List contacts in a category''' link under Contacts.

To edit an existing Category List Menu Item, click its Title in Menu Manager: Menu Items.

==Description==
Used to show articles belonging to a specific Category in a list layout.
{{Chunk25:colheader|List Layout}}

==Screenshot==
[[File:Help25-contact-category-list-screenshot.png|frame|none]]

==Column Headers==

===Common Options===
See [[Help25:Menus_Menu_Item_Manager_Edit|Menu Item Manager: New Menu Item]] for help on fields common to all Menu Item types, including Details, Link Type Options, Page Display Options, Metadata Options, and Module Assignments for this Menu Item.

===Required Settings===
This layout requires that you select a category. This is done in the list box shown below.
[[File:Help25-chunk-article-category-select-category.png|frame|none]]
{{Chunk25:colheader|Choose a category}}

===Category Options===
The Category Options control the way that category information is shown in the layout. The Category List Layout has the following Category Options, as shown below.
[[Image:Help25-chunk-article-category-category-options.png|frame|none]]
{{Chunk25:colheader|Category Title}}
{{Chunk25:colheader|Category Description}}
{{Chunk25:colheader|Category Image}}
{{Chunk25:colheader|Subcategory Levels}}
{{Chunk25:colheader|Empty Categories}}
{{Chunk25:colheader|No Articles Message}}
{{Chunk25:colheader|Subcategories Descriptions}}
{{Chunk25:colheader|No Articles in Category}}
{{Chunk25:colheader|Page Subheading}}

===List Layouts===
List Layout Options control the appearance of the list layout.
[[File:Help25-chunk-article-category-list-layout-options.png|frame|none]]
{{Chunk25:colheader|Display Select}}
{{Chunk25:colheader|Filter Field}}
{{Chunk25:colheader|Table Headings}}
{{Chunk25:colheader|Show Date}}
{{Chunk25:colheader|Date Format}}
{{Chunk25:colheader|Show Hits in List}}
{{Chunk25:colheader|Show Author in List}}
{{Chunk25:colheader|Category Order}}
{{Chunk25:colheader|Article Order}}
{{Chunk25:colheader|Date for Ordering}}
{{Chunk25:colheader|Pagination}}
{{Chunk25:colheader|Pagination Results}}
{{Chunk25:colheader|No Articles to List}}

===Article Options===
The Category List Layout has the following Article Options, as shown below. These options determine how the articles will show in the list layout.
[[Image:Help25-article-featured-article-options.png|frame|none]]
In addition to Yes/No or Hide/Show, these options allow the following settings.
*''Use Global:'' Use the default value from [[Help25:Content_Article_Manager#Options|Article Manager Options]].

The Article Options are as follows.
{{Chunk25:colheader|Show Title}}
{{Chunk25:colheader|Linked Titles}}
{{Chunk25:colheader|Show Intro Text}}
{{Chunk25:colheader|Show Category}}
{{Chunk25:colheader|Link Category}}
{{Chunk25:colheader|Show Parent}}
{{Chunk25:colheader|Link Parent}}
{{Chunk25:colheader|Show Author}}
{{Chunk25:colheader|Link Author}}
{{Chunk25:colheader|Show Create Date}}
{{Chunk25:colheader|Show Modify Date}}
{{Chunk25:colheader|Show Publish Date}}
{{Chunk25:colheader|Show Navigation}}
{{Chunk25:colheader|Show Voting}}
{{Chunk25:colheader|Show Read More}}
{{Chunk25:colheader|Show Title with Read More}}
{{Chunk25:colheader|Show Icons}}
{{Chunk25:colheader|Show Print Icon}}
{{Chunk25:colheader|Show Email Icon}}
{{Chunk25:colheader|Show Hits}}
{{Chunk25:colheader|Show Unauthorised Links}}

===Integration Options===
The Featured Articles layout has the following Integration Options.
[[File:Help25-chunk-integration-options.png‎|frame|none]]
These determine whether a news feed will be available for the page and what information it will show.
{{Chunk25:colheader|Show Feed Link}}
{{Chunk25:colheader|For each feed item show}}

==Toolbar==
At the top right you will see the toolbar:

[[File:Help25-chunk-menu-item-toolbar.png]]

The functions are:
{{Chunk25:Help_screen_toolbar_icon_Save|menu item}}
{{Chunk25:Help_screen_toolbar_icon_SaveAndClose|menu item}}
{{Chunk25:Help_screen_toolbar_icon_SaveAndNew|menu item}}
{{Chunk25:Help_screen_toolbar_icon_SaveAsCopy|menu item}}
{{Chunk25:Help_screen_toolbar_icon_Cancel}}
{{Chunk25:Help_screen_toolbar_icon_Help}}

==Quick Tips==
* The Category List layout is a convenient way to list a compact directory of articles in a category that can include filtering and searching.

==Related Information==
* To create a new Category see [[Help25:Components_Content_Categories_Edit|Category Manager: Add or Edit]].
* To create a new menu see [[Help25:Menus_Menu_Manager|Menus Menu Manager]].

<noinclude>{{cathelp|2.5|Menu Item Manager Help Screens|Menus Helps Screens}}</noinclude>
<noinclude>{{cathelp|2.5|Menu Item Manager Help Screens|Menus Helps Screens}}</noinclude>

File:Help25-contact-category-list-screenshot.png

2012-08-08T08:12:28Z

Crispness: screenshots for version 2.5 help screens

== Summary ==
screenshots for version 2.5 help screens
== Licensing ==
{{PD}}

Help25:Menus Menu Item Contact Category

2012-08-08T06:58:35Z

Crispness: copy basic text from Help25:Menus Menu Item Article Category List before customising to Contacts

{{page|references wrong version}}
{{page|has wrong image}}
{{inuse}}

Used to show all of the published Contacts in a given Category. Note that Contact Categories are separate from Article Categories. Contacts and Contact Categories are entered by selecting Components/Contacts. See [[screen.contactmanager.15|Contact Manager]] and [[screen.categories.15|Category Manager]] for more information.
=Menu Item Articles: Category List=

==How To Access==
To create a new Category List Menu Item:
* Select Menus → [name of the menu] from the drop-down menu on the back-end of your Joomla! installation (for example, Menus → Main Menu).
* Click '''New''' to create a new menu item or click on an existing item to edit.
* Click the Menu Item Type Select button and then click the '''List contacts in a category''' link under Contacts.

To edit an existing Category List Menu Item, click its Title in Menu Manager: Menu Items.

==Description==
Used to show articles belonging to a specific Category in a list layout.
{{Chunk25:colheader|List Layout}}

==Screenshot==
[[File:Help25-article-category-list-screenshot.png|frame|none]]

==Column Headers==

===Common Options===
See [[Help25:Menus_Menu_Item_Manager_Edit|Menu Item Manager: New Menu Item]] for help on fields common to all Menu Item types, including Details, Link Type Options, Page Display Options, Metadata Options, and Module Assignments for this Menu Item.

===Required Settings===
This layout requires that you select a category. This is done in the list box shown below.
[[File:Help25-chunk-article-category-select-category.png|frame|none]]
{{Chunk25:colheader|Choose a category}}

===Category Options===
The Category Options control the way that category information is shown in the layout. The Category List Layout has the following Category Options, as shown below.
[[Image:Help25-chunk-article-category-category-options.png|frame|none]]
{{Chunk25:colheader|Category Title}}
{{Chunk25:colheader|Category Description}}
{{Chunk25:colheader|Category Image}}
{{Chunk25:colheader|Subcategory Levels}}
{{Chunk25:colheader|Empty Categories}}
{{Chunk25:colheader|No Articles Message}}
{{Chunk25:colheader|Subcategories Descriptions}}
{{Chunk25:colheader|No Articles in Category}}
{{Chunk25:colheader|Page Subheading}}

===List Layouts===
List Layout Options control the appearance of the list layout.
[[File:Help25-chunk-article-category-list-layout-options.png|frame|none]]
{{Chunk25:colheader|Display Select}}
{{Chunk25:colheader|Filter Field}}
{{Chunk25:colheader|Table Headings}}
{{Chunk25:colheader|Show Date}}
{{Chunk25:colheader|Date Format}}
{{Chunk25:colheader|Show Hits in List}}
{{Chunk25:colheader|Show Author in List}}
{{Chunk25:colheader|Category Order}}
{{Chunk25:colheader|Article Order}}
{{Chunk25:colheader|Date for Ordering}}
{{Chunk25:colheader|Pagination}}
{{Chunk25:colheader|Pagination Results}}
{{Chunk25:colheader|No Articles to List}}

===Article Options===
The Category List Layout has the following Article Options, as shown below. These options determine how the articles will show in the list layout.
[[Image:Help25-article-featured-article-options.png|frame|none]]
In addition to Yes/No or Hide/Show, these options allow the following settings.
*''Use Global:'' Use the default value from [[Help25:Content_Article_Manager#Options|Article Manager Options]].

The Article Options are as follows.
{{Chunk25:colheader|Show Title}}
{{Chunk25:colheader|Linked Titles}}
{{Chunk25:colheader|Show Intro Text}}
{{Chunk25:colheader|Show Category}}
{{Chunk25:colheader|Link Category}}
{{Chunk25:colheader|Show Parent}}
{{Chunk25:colheader|Link Parent}}
{{Chunk25:colheader|Show Author}}
{{Chunk25:colheader|Link Author}}
{{Chunk25:colheader|Show Create Date}}
{{Chunk25:colheader|Show Modify Date}}
{{Chunk25:colheader|Show Publish Date}}
{{Chunk25:colheader|Show Navigation}}
{{Chunk25:colheader|Show Voting}}
{{Chunk25:colheader|Show Read More}}
{{Chunk25:colheader|Show Title with Read More}}
{{Chunk25:colheader|Show Icons}}
{{Chunk25:colheader|Show Print Icon}}
{{Chunk25:colheader|Show Email Icon}}
{{Chunk25:colheader|Show Hits}}
{{Chunk25:colheader|Show Unauthorised Links}}

===Integration Options===
The Featured Articles layout has the following Integration Options.
[[File:Help25-chunk-integration-options.png‎|frame|none]]
These determine whether a news feed will be available for the page and what information it will show.
{{Chunk25:colheader|Show Feed Link}}
{{Chunk25:colheader|For each feed item show}}

==Toolbar==
At the top right you will see the toolbar:

[[File:Help25-chunk-menu-item-toolbar.png]]

The functions are:
{{Chunk25:Help_screen_toolbar_icon_Save|menu item}}
{{Chunk25:Help_screen_toolbar_icon_SaveAndClose|menu item}}
{{Chunk25:Help_screen_toolbar_icon_SaveAndNew|menu item}}
{{Chunk25:Help_screen_toolbar_icon_SaveAsCopy|menu item}}
{{Chunk25:Help_screen_toolbar_icon_Cancel}}
{{Chunk25:Help_screen_toolbar_icon_Help}}

==Quick Tips==
* The Category List layout is a convenient way to list a compact directory of articles in a category that can include filtering and searching.

==Related Information==
* To create a new Category see [[Help25:Components_Content_Categories_Edit|Category Manager: Add or Edit]].
* To create a new menu see [[Help25:Menus_Menu_Manager|Menus Menu Manager]].

<noinclude>{{cathelp|2.5|Menu Item Manager Help Screens|Menus Helps Screens}}</noinclude>
<noinclude>{{cathelp|2.5|Menu Item Manager Help Screens|Menus Helps Screens}}</noinclude>

Help25 talk:Menus Menu Item Article Category List

2012-08-08T06:53:46Z

Crispness: /* Missing functionality */ wrong page

==Missing functionality==
In the [[Help25:Menus_Menu_Item_Article_Category_List#List_Layouts]] section, there is an indication that it is possible to define the # of hits to show in a list. This functionality is not available in my Current installation (j2.5.6). Should it be removed from these docs? [[User:Crispness|Crispness]] 10:59, 7 August 2012 (CDT)

The help screens should exactly match the version of Joomla to which they refer, so yes, please make the change. Thanks. [[User:Chris Davenport|Chris Davenport]] 15:22, 7 August 2012 (CDT)

:@[[User:Crispness|Crispness]], could you please elaborate more? I took a quick look because I have one site with a Category List menu item for a page which we hide the number of hits. I went to the [[Help25:Menus_Menu_Item_Article_Category_List|Menus_Menu_Item_Article_Category_List]] screen, enabled it, they showed, then disabled it, which reset it back to the way we show the list on that particular website. It is possible your template is at fault? Quite a few template makers add styles to way the list is shown on a page. Perhaps there is a problem with the CSS or a [[How to override the output from the Joomla! core|template override]] file. It is a functioning choice, show hits, hide them or use global. Yes, I am running Joomla! 2.5.6 too. Thanks [[User:Hutchy68|Hutchy68]] 17:23, 7 August 2012 (CDT)
::I know I Said "# of hits". What I meant was "# of Articles". Sorry. Can someone confirm that # of Articles to show is '''not''' a valid option in j2.5.6? [[User:Crispness|Crispness]] 17:32, 7 August 2012 (CDT)
:::# Articles to show is valid and I just tested it, works just fine in 2.5.6. Options are 5, 10, 15, 20, 30, 50, 100 and all. Everything seems to be as it should. [[User:Hutchy68|Hutchy68]] 21:18, 7 August 2012 (CDT)
[[File:Screen Shot 2012-08-08 at 07.28.40.png|right]]OK. Here's my screenshot from my ''Menu Manager - Edit Manu Item -List Contacts in a Category - List Layouts''. Are we talking about the same thing? Because its not there on mine. (although I wish it was) [[User:Crispness|Crispness]] 01:35, 8 August 2012 (CDT).
::::Doh! It's available in Article Category List, but not List Contacts by Category. So why are these different? Is that a bug? [[User:Crispness|Crispness]] 01:38, 8 August 2012 (CDT)
:::::Yup. The page I should be at is [[Help25:Menus_Menu_Item_Contact_Category]] and it '''IS''' wrong. It has screenshots from J1.5 I think. So what now. Do I file a bug? I can update that doc page. Some of the text can come from here. I can update the screenshots. But it doesnt solve my problem. There is no way anymore of specifying the # of contacts in a category list. [[User:Crispness|Crispness]] 01:53, 8 August 2012 (CDT)

Help25 talk:Menus Menu Item Article Category List

2012-08-08T06:38:31Z

Crispness: /* Missing functionality */ Doh!

Help25 talk:Menus Menu Item Article Category List

2012-08-08T06:35:07Z

Crispness: /* Missing functionality */ Here's a screenshot

File:Screen Shot 2012-08-08 at 07.28.40.png

2012-08-08T06:31:36Z

Crispness: Menu Manager - Edit Manu Item -List Contacts in a Category - List Layouts

== Summary ==
Menu Manager - Edit Manu Item -List Contacts in a Category - List Layouts
== Licensing ==
{{PD}}

Help25 talk:Menus Menu Item Article Category List

2012-08-07T22:32:43Z

Crispness: /* Missing functionality */ My bad

Help25 talk:Menus Menu Item Article Category List

2012-08-07T15:59:23Z

Crispness: Question?