การสร้างเทมเพลตอย่างชาญฉลาดใน XOOPS

ภาพรวม

XOOPS ใช้เครื่องมือเทมเพลต Smarty เพื่อแยกการนำเสนอออกจากตรรกะ คู่มือนี้ครอบคลุมไวยากรณ์ของ Smarty คุณลักษณะเฉพาะ XOOPS และแนวทางปฏิบัติที่ดีที่สุดของเทมเพลต

ไวยากรณ์พื้นฐาน

ตัวแปร

{* Scalar variables *}
<{$variable}>
<{$article.title}>
<{$user->getUsername()}>

{* Array access *}
<{$items[0]}>
<{$config['setting']}>

{* Default values *}
<{$title|default:'Untitled'}>

ตัวแก้ไข

{* Text transformations *}
<{$text|upper}>
<{$text|lower}>
<{$text|capitalize}>
<{$text|truncate:100:'...'}>

{* HTML handling *}
<{$content|strip_tags}>
<{$html|escape:'html'}>
<{$url|escape:'url'}>

{* Date formatting *}
<{$timestamp|date_format:'%Y-%m-%d'}>
<{$date|date_format:$xoops_config.dateformat}>

{* Chaining modifiers *}
<{$text|strip_tags|truncate:50|escape}>

เงื่อนไข

{* If/else *}
<{if $logged_in}>
    Welcome, <{$username}>!
<{elseif $is_guest}>
    Please log in.
<{else}>
    Unknown state.
<{/if}>

{* Comparisons *}
<{if $count > 0}>
<{if $status == 'published'}>
<{if $items|@count >= 5}>

{* Logical operators *}
<{if $is_admin && $can_edit}>
<{if $type == 'news' || $type == 'article'}>
<{if !$is_hidden}>

ลูป

{* Foreach with items *}
<{foreach item=article from=$articles}>
    <h2><{$article.title}></h2>
<{/foreach}>

{* With key *}
<{foreach key=id item=value from=$items}>
    <{$id}>: <{$value}>
<{/foreach}>

{* With iteration info *}
<{foreach item=item from=$items name=itemloop}>
    <{$smarty.foreach.itemloop.index}>
    <{$smarty.foreach.itemloop.iteration}>
    <{$smarty.foreach.itemloop.first}>
    <{$smarty.foreach.itemloop.last}>
<{/foreach}>

{* Foreachelse for empty arrays *}
<{foreach item=item from=$items}>
    <{$item.name}>
<{foreachelse}>
    No items found.
<{/foreach}>

ส่วน (แบบเดิม)

<{section name=i loop=$items}>
    <{$items[i].title}>
<{/section}>

XOOPS-คุณสมบัติเฉพาะ

ตัวแปรร่วม

{* Site info *}
<{$xoops_sitename}>
<{$xoops_url}>
<{$xoops_rootpath}>
<{$xoops_theme}>

{* User info *}
<{$xoops_isuser}>
<{$xoops_isadmin}>
<{$xoops_userid}>
<{$xoops_uname}>

{* Module info *}
<{$xoops_dirname}>
<{$xoops_pagetitle}>

{* Meta *}
<{$xoops_meta_keywords}>
<{$xoops_meta_description}>

รวมไฟล์

{* Include from theme *}
<{include file="theme:header.html"}>

{* Include from module *}
<{include file="db:modulename_partial.tpl"}>

{* Include with variables *}
<{include file="db:mymodule_item.tpl" item=$article}>

{* Include from file system *}
<{include file="$xoops_rootpath/modules/mymodule/templates/partial.tpl"}>

บล็อกการแสดงผล

{* In theme.html *}
<{foreach item=block from=$xoops_lblocks}>
    <div class="block">
        <{if $block.title}>
            <h3><{$block.title}></h3>
        <{/if}>
        <{$block.content}>
    </div>
<{/foreach}>

การรวมแบบฟอร์ม

{* XoopsForm rendering *}
<{$form.javascript}>
<form action="<{$form.action}>" method="<{$form.method}>">
    <{foreach item=element from=$form.elements}>
        <div class="form-group">
            <label><{$element.caption}></label>
            <{$element.body}>
            <{if $element.description}>
                <small><{$element.description}></small>
            <{/if}>
        </div>
    <{/foreach}>
</form>

ฟังก์ชั่นที่กำหนดเอง

ลงทะเบียนโดย XOOPS

{* XoopsFormLoader *}
<{xoFormLoader form=$form}>

{* Breadcrumb *}
<{xoBreadcrumb}>

{* Module menu *}
<{xoModuleMenu}>

ปลั๊กอินที่กำหนดเอง

include/smarty_plugins/function.myfunction.php

function smarty_function_myfunction($params, $smarty)
{
    $name = $params['name'] ?? 'World';
    return "Hello, {$name}!";
}

<{myfunction name="XOOPS"}>

เทมเพลตองค์กร

โครงสร้างที่แนะนำ

templates/
├── admin/
│   ├── index.tpl
│   ├── item_list.tpl
│   └── item_form.tpl
├── blocks/
│   ├── recent.tpl
│   └── popular.tpl
├── frontend/
│   ├── index.tpl
│   ├── item_view.tpl
│   └── item_list.tpl
└── partials/
    ├── _header.tpl
    ├── _footer.tpl
    └── _pagination.tpl

เทมเพลตบางส่วน

{* partials/_pagination.tpl *}
<nav class="pagination">
    <{if $page > 1}>
        <a href="<{$base_url}>&page=<{$page-1}>">Previous</a>
    <{/if}>

    <span>Page <{$page}> of <{$total_pages}></span>

    <{if $page < $total_pages}>
        <a href="<{$base_url}>&page=<{$page+1}>">Next</a>
    <{/if}>
</nav>

{* Usage *}
<{include file="db:mymodule_pagination.tpl" page=$current_page total_pages=$pages base_url=$url}>

ประสิทธิภาพ

แคช

// In PHP
$xoopsTpl->caching = 1;
$xoopsTpl->cache_lifetime = 3600; // 1 hour

// Check if cached
if (!$xoopsTpl->is_cached('mymodule_index.tpl')) {
    // Fetch data only if not cached
    $items = $handler->getObjects();
    $xoopsTpl->assign('items', $items);
}

ล้างแคช

// Clear specific template
$xoopsTpl->clear_cache('mymodule_index.tpl');

// Clear all module templates
$xoopsTpl->clear_all_cache();

แนวทางปฏิบัติที่ดีที่สุด

1. Escape Output - หลีกเลี่ยงเนื้อหาที่ผู้ใช้สร้างขึ้นเสมอ
2. ใช้ตัวแก้ไข - ใช้การแปลงที่เหมาะสม
3. รักษาตรรกะให้น้อยที่สุด - ตรรกะที่ซับซ้อนอยู่ใน PHP
4. ใช้บางส่วน - นำชิ้นส่วนเทมเพลตทั่วไปกลับมาใช้ใหม่
5. ความหมาย HTML - ใช้องค์ประกอบ HTML5 ที่เหมาะสม
6. การเข้าถึง - รวมแอตทริบิวต์ ARIA ในกรณีที่จำเป็น

เอกสารที่เกี่ยวข้อง

• การพัฒนาธีม - การสร้างธีม
• ../../04-API-อ้างอิง/เทมเพลต/เทมเพลต-ระบบ - XOOPS เทมเพลต API
• ../../03-Module-Development/Block-Development - บล็อกเทมเพลต
• ../Forms/Form-Elements - การแสดงแบบฟอร์ม