Table des matières

Upcoming articles - Documentation

1. Installation

Commencez par télécharger la dernière version du module Upcoming articles.

Pour installer votre extension, ouvrez le panneau d'administration de Joomla puis cliquez sur Système dans le menu latéral de gauche. Ensuite, cliquez sur Extensions dans la rubrique Installation.

Ouvrez l'onglet Archive à envoyer, cliquez sur le bouton et localisez l'archive ZIP mod_articles_upcoming_j4.zip sur votre ordinateur. Sélectionnez la pour lancer le processus d'installation.

Quelques secondes plus tard, un message vous confirme que le processus d'installation s'est correctement déroulé.

Installation in Joomla

Maintenant, votre extension Upcoming articles est disponible dans votre gestionnaire de modules.

Module installation

2. Utilisation

2.1 Les paramètres

Créons notre premier module Upcoming articles.
Depuis le gestionnaire de module, cliquez sur le bouton Nouveau.
Ensuite, cliquez sur Upcoming articles.

Jetons un oeil aux paramètres du module :

Upcoming articles documentation

  • Nombre d'articles à afficher: indiquez le nombre maximum d'articles que le module doit afficher.
  • Catégorie: sélectionnez la ou les catégories pour vos articles à paraitre.
  • Afficher la date: sélectionnez si le module doit afficher ou non la date de publication des articles.

N'oubliez pas d'indiquez la position du module et d'assigner le module à la bonne page. Lorsque vous avez terminé, cliquez sur le bouton Enregistrer & Fermer.

3. Affichage

Voici quelques informations qui pourront vous être utiles.

3.1 Format de la date

Pour vous aider à afficher la date de vos prochains articles au bon format, j'ai réalisé ce tableau avec quelques exemples:

# Format Résultat
1 d-m-Y 01-01-2020
2 d.m.y 01.01.20
3 d m 01 01
4 d M Y 01 Jan 2020
5 m-d Jan-01

3.2 Aligner la date et le titre de l'article sur la même ligne

Parce que ce sera plus simple et plus facile pour vous, je vous conseille d'utiliser - autant que possible - les classes CSS de votre template.

Mon template Cassiopeia utilise Bootstrap 5,j'ai donc choisi d'utiliser l'affichage media object:

<div class="d-flex">
	<div class="flex-shrink-0">
		<img src="..." alt="...">
	</div>
	<div class="flex-grow-1 ms-3">
    This is some content from a media component. You can replace this with any content and adjust it as needed.
	</div>
</div>

Avec cet exemple, il est très facile de créer un override simple et basique où la date sera affichée à la place de l'image et où le titre de l'article sera affiché à la place de l'en-tête du média.

Voici une override que j'ai créée pour vous pour afficher la date sur la même ligne que le titre de l'article:

<?php
	/**
		* @package     Joomla.Site
		* @subpackage  mod_articles_upcoming
		* @author	   web-eau.net
		* @copyright   Copyright (C) 2005 - 2020 Open Source Matters, Inc. All rights reserved.
		* @license     GNU General Public License version 2 or later; see LICENSE.txt
	*/
	
	defined('_JEXEC') or die;
?>

<?php if (count($list['articleList'])) { ?>
    
    <div class="<?php echo $moduleclass_sfx; ?> d-flex">
		<?php foreach ($list['articleList'] as $item) : ?>
		
            <?php if ($showDate) { ?>
				<div class="flex-shrink-0 mod-articles-category-date fw-bold">
					<?php echo JHtml::_('date', $item->publish_up, $params->get('show_date_format', JText::_('DATE_FORMAT_LC4'))); ?>
				</div>
			<?php } ?>
			
				<div class="flex-grow-1 ms-3">
                    <?php echo $item->title; ?>
				</div>
		<?php endforeach; ?>		
	</div>
            
<?php } ?>

N'hésitez pas à copier / coller ce code this code si vous l'aimez et si votre template utilise aussi Bootstrap 5. La démo, présente ci-dessous, utilise cette override !

4. Demo

Upcoming articles

08 Juil
Joomla 5: what to expect form the 1st release?
10 Aoû
What are the new web languages to learn?

web-eau.net

29800 Landerneau

06 74 50 27 99

daniel@web-eau.net