Joomla! Documentation™

Introduction

How best to add images to an article depends on which version of Joomla and which editor are in use. This article has illustrations for Joomla 4, with notes on differences in Joomla 3, and TinyMCE the Joomla default editor. To get started, open an article for editing:

• Select Content → Articles in the Administrator menu.
• Select the title of the article you wish to edit

After inserting the article text, place the cursor at the location where the image should appear.

Adding a local image

If the image is located in the images folder of your Joomla installation you should insert the image using the CMS Content → Media button In the TinyMCE edit toolbar (In Joomla 3: Select the Image button):

In the popup window, navigate to the image you want to use and click to select it. On selection a form will appear prompting for additional data. In Joomla 4 the form is to the left. In joomla 3 the form is at the bottom (scroll down):

1. Définissez les propriétés de l'image. Dans la plupart des cas, vous devez remplir le champ Description de l'image (texte Alt). Les autres champs sont utilisés pour personnaliser l'apparence de l'image avec votre propre code CSS.
   • Description : l'attribut alt de l'image, une caractéristique importante pour l'accessibilité et la conformité avec les standards du web. Dans Joomla 3, il est appelé Titre de l'image.

• Image Class : Si une image est utilisée sans légende, certaines classes personnalisées peuvent être appliquées ici. Par exemple, dans Joomla 4, float-end ms-2 mb-1 alignera l'image à droite et fera flotter le texte autour d'elle avec des marges à gauche et en dessous pour éviter que le texte ne touche l'image. Dans Joomla 3, le style équivalent est pull-right.
• Classe de la figure : si une légende est définie, une classe d'alignement, le cas échéant, doit être appliquée à la figure. Il s'agit d'une balise html qui entoure la balise img. Notez que dans Cassiopeia, les marges sont appliquées par la feuille de style du modèle.

1. • Légende de la figure : permet de définir la légende qui s'affiche en tant que titre sous l'image.

In Joomla 3

• Alignement : définit l'alignement de l'image. Par défaut, l'alignement est paramétré sur Non défini.
• Classe de légende : permet d'appliquer la classe définie à l'élément figcaption.

Sélectionnez le bouton "Insérer un média" pour insérer l'image. L'écran Insérer une image se fermera et l'image sera affichée dans l'éditeur. Ou sélectionnez le bouton Annuler pour quitter l'écran Insérer une image.

Astuce: sélectionnez le bouton Toggle Editor pour voir les styles d'image et de légende appliqués.

Using Drag and Drop for Local images

In both Joomla 4 and Joomla 3 you can drag an image from the desktop or a file browser directly into the article text and the image will be uploaded to the media folder and placed in the article. The only snag is that all such uploaded images will be placed in the same media folder. The location of the Images Directory used for upload and whether this feature is enabled (On by default) are set in the TinyMCE configuration Options.

Adding a remote image

If the image you wish to use is not in the images folder of your Joomla installation a slightly different procedure is needed.

• Select Insert → Image from the TinyMCE toolbar to open a dialog box. In Joomla 3, use the Image icon and the same dialog as used for local images.
• Insert the image url in the Source field.
• Fill out the other fields as required.
• Advanced provides some formatting options applied as in-line styles. Experiment with 1rem, 2, groove. (This feature is incomplete)

Using Drag and Drop for Remote images

You can drag and drop an image from a remote web site directly into your article text. But be aware that this may also copy the image container html with class statements not valid for your site.

Chargement d'images avec l'écran d'insertion d'images

Vous pouvez télécharger de nouvelles images en utilisant l'écran Media (l'écran Image dans Joomla 3).

• Ouvrez d'abord le navigateur média et naviguez jusqu'au dossier dans lequel vous souhaitez stocker les nouvelles images de l'article en cours.
• Sélectionnez le bouton Upload en haut à gauche de l'écran Media (dans Joomla 3, faites défiler jusqu'au bouton Browse en bas du formulaire Image) pour ouvrir un navigateur de fichiers.
• Sélectionnez les fichiers images que vous souhaitez télécharger. Sélectionnez Ouvrir dans le navigateur de fichiers pour confirmer la sélection. Remarque : le style et la présentation du navigateur de fichiers dépendent du navigateur et du système d'exploitation que vous utilisez. Dans Joomla 4, le téléchargement est immédiat. Dans Joomla 3, sélectionnez le bouton Démarrer le téléchargement.
• Les fichiers sélectionnés apparaissent dans l'ordre alphabétique dans l'écran Média/Image.
• Lorsque le téléchargement est terminé, un avis de confirmation vert apparaît en haut de l'écran.

Vous pouvez maintenant sélectionner et insérer l'image chargée comme précédemment.