Page d'accueil: mettre en évidence la dernière ressource publiée

Rappels sur l'initialisation des gabarits :

Chaque gabarit de mise en pages doit être initialisé (en tout début de code) par la fonction pxTemplateInit. Pour rappel, les gabarits se trouvent dans .../manager/templates/default/
Le gabarit de page d'accueil étant category_homepage.php. L'initialisation du gabarit permet d'agir sur la gestion des ressources à afficher: classement, nombre et langue.
Voici l'exemple du gabarit de page d'accueil du thème par défaut de Plume:

Plusieurs paramètres sont possibles (documentation officielle de Plume):
Par défaut aucun paramètre n'est donné.
Plusieurs peuvent être transmis en même temps et constituer ainsi une longue chaîne . Ils devront alors être séparés distinctement par le caractère |. Par exemple si vous souhaitez utiliser deux paramètres simultanément, param1 et param2, alors vous devrez appeler la fonction ainsi:

pxTemplateInit('param1|param2')

L'ordre n'a pas d'importance.
Certains paramètres peuvent avoir une valeur. Par exemple pour définir le nombre de ressources affichées par page à 10, vous utiliserez le paramètre res_per_page:10

Paramètres simples:

• order_res_manual : Pour classer manuellement les ressources par leur titre dans les pages de catégories.
• order_cat_manual : Pour classer manuellement les catégories par leur nom dans les listes de catégories.
• remove_numbers : Pour enlever les nombres du début d'un titre de ressource ou de catégorie. Si vous placez par exemple 01., 10. ou 17. au début du nom d'une catégorie ou d'une ressource, ce nombre servira à son classement manuel mais ne sera pas affiché.

Paramètres avec valeurs:

• res_per_page:XX : Nombre de ressources par pages. Changez XX par le nombre de ressources désirées.
• set_lang:XX: Définit la localisation du gabarit en cours. Changez XX par les deux lettres du code ISO de la langue. Si une partie de votre site est en français alors que le reste l'est en anglais, vous pouvez créer de nouveaux gabarits pour les catégories, articles et brèves et les utiliser en passant l'argument set_lang:fr. C'est fort utile pour gérer le nom des jours/mois dans le bon langage. Les curieux pourront regarder la fonction PHP setlocale, l'argument LC_ALL est utilisé.

Note: Il est essentiel d'appeler cette fonction après chaque utilisation de la fonction process... .

Repérer la boucle $last:

Editer votre gabarit category_homepage.php est repérer la boucle php suivante. Cette boucle est utilisable dans tous les patrons (gabarit), vous devez juste l'initialiser auparavant avec la fonction pxGetLastResources : par exemple :

Plusieurs paramètres sont possibles:

pxGetLastResources( $limit, $type, $category )

• $limit - Nombre de ressources (5); par défaut la limite est de 5.
• $type - Type de ressources ('') pour toutes, 'news' ou 'articles'.
• $category - Identifiant de catégorie ('')

Cette fonction extrait la liste des dernières ressources et la place dans la variable $last pour une utilisation ultérieure par la boucle $last. Cette dernière ne peut donc être utilisée qu'après un appel à la fonction pxGetLastResources.

En général, l'appel de la fonction pxGetLastResources se fait en tout début de code avec l'initialisation du gabarit (cf plus haut).

Extraire et mettre en valeur la dernière ressource:

A l'intérieur de la boucle $last, l'utilisation de nombreuses fonctions est possible (titre de la dernière ressource, description, informations, dates, auteur ....), vous trouverez des explications complètes sur le site officiel de Plume. Observez bien celles qui sont déjà présentes dans votre gabarit de page d'accueil. Nous allons utiliser ici les fonctions présentes dans le gabarit category_homepage.php d'origine (première installation de Plume = thème par défaut / en anglais !).
Nous allons extraire les informations concernant la dernière ressource publiée, il suffit de ne pas les intégrer dans une boucle $last et de les placer dans un bloc différent (div par exemple).
Il sera facile de mettre en valeur ce bloc avec un peu de CSS ...;-):

<div id="lastresource">

<?php pxGetLastResources(); ?>
<h2><a href="<?php pxResPath(); ?>"><?php pxResTitle('%s'); ?></a></h2>
<p><a href="<?php pxResPath(); ?>">#</a> The <?php pxResDateModification('%Y-%m-%d at %H:%M'); ?>by <a href="<?php pxResAuthorEmail('mailto:%s'); ?>"><?php pxResAuthor(); ?></a>.<?php pxResCategories('<br />In %s'); ?>.</p>
<?php pxResDescription(); ?>

</div>

Afficher le reste des ressources (boucle $last, moins la dernière ressource):

Nous allons réinitialiser pxGetLastResouces et faire une simple boucle $last dans un autre bloc (par exemple). Grâce à la mise en place d'un compteur (merci Loïc !!), la boucle ne va pas prendre en compte votre dernière ressource : heureusement car on vient de la mettre en évidence dans un bloc "spécial pour elle"...
Voici donc le deuxième bloc :

<div id="content">

<?php pxGetLastResources(); ?>
<?php $i = 1; ?>
<?php while (!$last->EOF() ): ?>
<?php if ($i >= 2): ?>	        

<h2><a href="<?php pxResPath(); ?>"><?php pxResTitle('%s'); ?></a></h2>
<p><a href="<?php pxResPath(); ?>">#</a> The <?php pxResDateModification('%Y-%m-%d at %H:%M'); ?>by <a href="<?php pxResAuthorEmail('mailto:%s'); ?>"><?php pxResAuthor(); ?></a>.<?php pxResCategories('<br />In %s'); ?>.</p>
<?php pxResDescription(); ?>

<?php endif; $i  ; ?>
<?php $last->moveNext(); endwhile; ?>

</div>

Voici le principe de base, il est possible de faire plusieurs boucles en fonction de vos paramètres dans pxTemplateInit et pxGetLastResources. Mettre en évidence votre dernier article et/ou news sera du plus bel effet avec une css adéquate ....

Variante dans la boucle $last:

Si vous voulez que la boucle $last ne prenne pas en compte les N dernières ressources, il suffit de remplacer cette ligne (compteur php):

par celle-ci :

M=N 1 (N étant le chiffre correspondant au nombre des "dernières ressources" que vous ne voulez pas prendre en compte!)
Par exemple, si vous ne voulez pas afficher les 4 dernières ressources, il faudra écrire: