Modèles et Blocs

Aperçu

Publisher fournit des modèles personnalisables pour afficher les articles et les blocs pour l’intégration de barres latérales/widgets. Ce guide couvre la personnalisation des modèles et la configuration des blocs.

Fichiers Modèles

Modèles Principaux

Modèle	Objectif
publisher_index.tpl	Page d’accueil du module
publisher_item.tpl	Affichage d’un seul article
publisher_category.tpl	Liste des catégories
publisher_archive.tpl	Page d’archive
publisher_search.tpl	Résultats de recherche
publisher_submit.tpl	Formulaire de soumission d’article
publisher_print.tpl	Affichage imprimable

Modèles de Blocs

Modèle	Objectif
publisher_block_latest.tpl	Bloc des articles les plus récents
publisher_block_spotlight.tpl	Bloc d’article en vedette
publisher_block_category.tpl	Bloc de liste de catégories
publisher_block_author.tpl	Bloc d’articles de l’auteur

Template Variables

Article Variables

{* Available in publisher_item.tpl *}
<{$item.title}>           {* Article title *}
<{$item.body}>            {* Full content *}
<{$item.summary}>         {* Summary/excerpt *}
<{$item.author}>          {* Author name *}
<{$item.authorid}>        {* Author user ID *}
<{$item.datesub}>         {* Publication date *}
<{$item.datemodified}>    {* Last modified date *}
<{$item.counter}>         {* View count *}
<{$item.rating}>          {* Average rating *}
<{$item.votes}>           {* Number of votes *}
<{$item.categoryname}>    {* Category name *}
<{$item.categorylink}>    {* Category URL *}
<{$item.itemurl}>         {* Article URL *}
<{$item.image}>           {* Featured image *}

Category Variables

{* Available in publisher_category.tpl *}
<{$category.name}>        {* Category name *}
<{$category.description}> {* Category description *}
<{$category.image}>       {* Category image *}
<{$category.total}>       {* Article count *}
<{$category.link}>        {* Category URL *}

Customizing Templates

Override Location

Copy templates to your theme to customize:

themes/mytheme/modules/publisher/
├── publisher_index.tpl
├── publisher_item.tpl
└── blocks/
    └── publisher_block_latest.tpl

Example: Custom Article Template

{* themes/mytheme/modules/publisher/publisher_item.tpl *}
<article class="publisher-article">
    <header>
        <h1><{$item.title}></h1>
        <div class="meta">
            <span class="author">By <{$item.author}></span>
            <span class="date"><{$item.datesub}></span>
            <span class="category">
                <a href="<{$item.categorylink}>"><{$item.categoryname}></a>
            </span>
        </div>
    </header>

    <{if $item.image}>
    <figure class="featured-image">
        <img src="<{$item.image}>" alt="<{$item.title}>">
    </figure>
    <{/if}>

    <div class="content">
        <{$item.body}>
    </div>

    <footer>
        <{if $item.who_when}>
            <p class="attribution"><{$item.who_when}></p>
        <{/if}>

        <div class="actions">
            <{if $can_edit}>
                <a href="<{$xoops_url}>/modules/publisher/submit.php?itemid=<{$item.itemid}>">
                    Edit Article
                </a>
            <{/if}>
            <a href="<{$item.printlink}>" target="_blank">Print</a>
            <a href="<{$item.maillink}>">Email</a>
        </div>
    </footer>
</article>

Blocks

Available Blocks

Block	Description
Latest News	Shows recent articles
Spotlight	Featured article highlight
Category Menu	Category navigation
Archives	Archive links
Top Authors	Most active writers
Popular Items	Most viewed articles

Block Options

Latest News Block

Option	Description
Items to display	Number of articles
Category filter	Limit to specific categories
Show summary	Display article excerpt
Title length	Truncate titles
Template	Block template file

Custom Block Template

{* themes/mytheme/modules/publisher/blocks/publisher_block_latest.tpl *}
<div class="publisher-latest-block">
    <{foreach item=item from=$block.items}>
    <article class="block-item">
        <h4>
            <a href="<{$item.link}>"><{$item.title}></a>
        </h4>
        <{if $block.show_summary}>
            <p><{$item.summary}></p>
        <{/if}>
        <div class="block-meta">
            <span class="date"><{$item.date}></span>
            <span class="views"><{$item.counter}> views</span>
        </div>
    </article>
    <{/foreach}>
</div>

Template Tricks

Conditional Display

{* Show different content for different users *}
<{if $xoops_isadmin}>
    <a href="admin/item.php?op=edit&itemid=<{$item.itemid}>">Admin Edit</a>
<{elseif $item.uid == $xoops_userid}>
    <a href="submit.php?itemid=<{$item.itemid}>">Edit Your Article</a>
<{/if}>

Custom CSS Class

{* Add status-based styling *}
<article class="article <{$item.status}>">
    {* Content *}
</article>

Date Formatting

{* Format dates with Smarty *}
<time datetime="<{$item.datesub|date_format:'%Y-%m-%d'}>">
    <{$item.datesub|date_format:$xoops_config.dateformat}>
</time>

Related Documentation

• ../User-Guide/Basic-Configuration - Module settings
• ../User-Guide/Creating-Articles - Content management
• ../../04-API-Reference/Template/Template-System - XOOPS template engine
• ../../02-Core-Concepts/Themes/Theme-Development - Theme customization