ธีม FAQ

ธีมคำถามที่พบบ่อย

คำถามและคำตอบทั่วไปเกี่ยวกับธีม XOOPS การปรับแต่ง และการจัดการ

การติดตั้งและเปิดใช้งานธีม

ถาม: ฉันจะติดตั้งธีมใหม่ใน XOOPS ได้อย่างไร

ก:

ดาวน์โหลดไฟล์ zip ของธีม
ไปที่ XOOPS ผู้ดูแลระบบ > ลักษณะที่ปรากฏ > ธีม
คลิก “อัปโหลด” และเลือกไฟล์ zip
ธีมจะปรากฏในรายการธีม
คลิกเพื่อเปิดใช้งานสำหรับเว็บไซต์ของคุณ

ทางเลือก: แยกไฟล์ด้วยตนเองลงในไดเร็กทอรี /themes/ และรีเฟรชแผงผู้ดูแลระบบ

ถาม: การอัปโหลดธีมล้มเหลวเนื่องจาก “สิทธิ์ถูกปฏิเสธ”

A: แก้ไขการอนุญาตไดเรกทอรีธีม:

# Make themes directory writable
chmod 755 /path/to/xoops/themes

# Fix uploads if uploading
chmod 777 /path/to/xoops/uploads

# Fix ownership if needed
chown -R www-data:www-data /path/to/xoops/themes

ถาม: ฉันจะตั้งค่าธีมอื่นสำหรับผู้ใช้เฉพาะได้อย่างไร?

ก:

ไปที่ตัวจัดการผู้ใช้ > แก้ไขผู้ใช้
ไปที่แท็บ “อื่นๆ”
เลือกธีมที่ต้องการในรายการแบบเลื่อนลง “ธีมผู้ใช้”
บันทึก

ธีมที่ผู้ใช้เลือกจะแทนที่ธีมของไซต์เริ่มต้น

ถาม: ฉันสามารถมีธีมที่แตกต่างกันสำหรับไซต์ผู้ดูแลระบบและผู้ใช้ได้หรือไม่

ตอบ: ใช่ ตั้งค่าใน XOOPS ผู้ดูแลระบบ > การตั้งค่า:

ธีมส่วนหน้า - ธีมไซต์เริ่มต้น
ธีมผู้ดูแลระบบ - ธีมแผงควบคุมผู้ดูแลระบบ (ปกติจะแยกกัน)

ค้นหาการตั้งค่าเช่น:

theme_set - ธีมส่วนหน้า
admin_theme - ธีมผู้ดูแลระบบ

การปรับแต่งธีม

ถาม: ฉันจะปรับแต่งธีมที่มีอยู่ได้อย่างไร?

ตอบ: สร้างธีมลูกเพื่อเก็บรักษาการอัปเดต:

themes/
├── original_theme/
│   ├── style.css
│   ├── templates/
│   └── images/
└── custom_theme/          {* Create copy for editing *}
    ├── style.css
    ├── templates/
    └── images/

จากนั้นแก้ไข theme.html ในธีมที่คุณกำหนดเอง

ถาม: ฉันจะเปลี่ยนสีธีมได้อย่างไร?

ตอบ: แก้ไขไฟล์ CSS ของธีม:

# Locate theme CSS
themes/mytheme/style.css

# Or theme template
themes/mytheme/theme.html

สำหรับธีม XOOPS:

:root {
    --primary-color: #2c3e50;
    --secondary-color: #3498db;
    --accent-color: #e74c3c;
}

body {
    background-color: var(--primary-color);
    color: #333;
}

a {
    color: var(--secondary-color);
}

.button {
    background-color: var(--accent-color);
}

ถาม: ฉันจะเพิ่ม CSS ที่กำหนดเองลงในธีมได้อย่างไร

ตอบ: หลายตัวเลือก:

ตัวเลือกที่ 1: แก้ไข theme.html

<head>
    {* Existing CSS *}
    <link rel="stylesheet" href="{$xoops_url}/themes/{$xoops_theme}/custom.css">
</head>

ตัวเลือกที่ 2: สร้าง custom.css

# Create file
themes/mytheme/custom.css

# Add your styles
body { background: #fff; }

ตัวเลือกที่ 3: การตั้งค่าผู้ดูแลระบบ (หากรองรับ) ไปที่ XOOPS ผู้ดูแลระบบ > การตั้งค่า > การตั้งค่าธีม และเพิ่ม CSS แบบกำหนดเอง

ถาม: ฉันจะแก้ไขเทมเพลต HTML ธีมได้อย่างไร

A: ค้นหาไฟล์เทมเพลต:

# List theme templates
ls -la themes/mytheme/templates/

# Common templates
themes/mytheme/templates/theme.html      {* Main layout *}
themes/mytheme/templates/header.html     {* Header *}
themes/mytheme/templates/footer.html     {* Footer *}
themes/mytheme/templates/sidebar.html    {* Sidebar *}

แก้ไขด้วยไวยากรณ์ Smarty ที่เหมาะสม:

{* XOOPS Theme Template *}
<!DOCTYPE html>
<html>
<head>
    <meta charset="{$xoops_charset}">
    <title>{$xoops_pagetitle}</title>
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <link rel="stylesheet" href="{$xoops_url}/themes/{$xoops_theme}/style.css">
</head>
<body>
    <header>
        {include file="file:header.html"}
    </header>

    <main>
        <div class="container">
            <div class="row">
                <div class="col-md-9">
                    {$xoops_contents}
                </div>
                <aside class="col-md-3">
                    {include file="file:sidebar.html"}
                </aside>
            </div>
        </div>
    </main>

    <footer>
        {include file="file:footer.html"}
    </footer>
</body>
</html>

โครงสร้างธีม

ถาม: ไฟล์ใดบ้างที่จำเป็นในธีม?

A: โครงสร้างขั้นต่ำ:

themes/mytheme/
├── theme.html              {* Main template (required) *}
├── style.css              {* Stylesheet (optional but recommended) *}
├── screenshot.png         {* Preview image for admin (optional) *}
├── images/                {* Theme images *}
│   └── logo.png
└── templates/             {* Optional: Additional templates *}
    ├── header.html
    ├── footer.html
    └── sidebar.html

ดูโครงสร้างธีมสำหรับรายละเอียด

ถาม: ฉันจะสร้างธีมตั้งแต่เริ่มต้นได้อย่างไร

A: สร้างโครงสร้าง:

mkdir -p themes/mytheme/images
cd themes/mytheme

สร้าง theme.html:

<!DOCTYPE html>
<html>
<head>
    <meta charset="{$xoops_charset}">
    <title>{$xoops_pagetitle}</title>
    <link rel="stylesheet" href="{$xoops_url}/themes/{$xoops_theme}/style.css">
</head>
<body>
    <header>{$xoops_headers}</header>
    <main>{$xoops_contents}</main>
    <footer>{$xoops_footers}</footer>
</body>
</html>

สร้าง style.css:

* { margin: 0; padding: 0; }
body { font-family: Arial, sans-serif; }
header { background: #333; color: #fff; padding: 20px; }
main { padding: 20px; }
footer { background: #f5f5f5; padding: 20px; border-top: 1px solid #ddd; }

ตัวแปรธีม

ถาม: มีตัวแปรอะไรบ้างในเทมเพลตธีม?

ตอบ: ตัวแปรธีม XOOPS ทั่วไป:

{* Site Information *}
{$xoops_sitename}          {* Site name *}
{$xoops_url}               {* Site URL *}
{$xoops_theme}             {* Current theme name *}

{* Page Content *}
{$xoops_contents}          {* Main page content *}
{$xoops_pagetitle}         {* Page title *}
{$xoops_headers}           {* Meta tags, styles in head *}

{* Module Information *}
{$xoops_module_header}     {* Module-specific header *}
{$xoops_moduledesc}        {* Module description *}

{* User Information *}
{$xoops_isuser}            {* Is user logged in? *}
{$xoops_userid}            {* User ID *}
{$xoops_uname}             {* Username *}

{* Blocks *}
{$xoops_blocks}            {* All block content *}

{* Other *}
{$xoops_charset}           {* Document charset *}
{$xoops_version}           {* XOOPS version *}

ถาม: ฉันจะเพิ่มตัวแปรที่กำหนดเองให้กับธีมของฉันได้อย่างไร

A: ในโค้ด PHP ของคุณก่อนแสดงผล:

<?php
// In module or admin code
require_once XOOPS_ROOT_PATH . '/class/xoopstpl.php';
$xoopsTpl = new XoopsTpl();

// Add custom variables
$xoopsTpl->assign('my_variable', 'value');
$xoopsTpl->assign('data_array', ['key1' => 'val1', 'key2' => 'val2']);

// Use in theme template
$xoopsTpl->display('file:theme.html');
?>

ในธีม:

<p>{$my_variable}</p>
<p>{$data_array.key1}</p>

การจัดรูปแบบธีม

ถาม: ฉันจะทำให้ธีมของฉันตอบสนองได้อย่างไร

ตอบ: ใช้ CSS Grid หรือ Flexbox:

/* Mobile first approach */
body {
    font-size: 14px;
}

.container {
    display: grid;
    grid-template-columns: 1fr;
    gap: 20px;
}

main {
    order: 2;
}

aside {
    order: 3;
}

/* Tablet and up */
@media (min-width: 768px) {
    .container {
        grid-template-columns: 2fr 1fr;
    }
}

/* Desktop and up */
@media (min-width: 1200px) {
    .container {
        grid-template-columns: 3fr 1fr;
    }
}

หรือใช้การรวม Bootstrap:

<head>
    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5/dist/css/bootstrap.min.css" rel="stylesheet">
</head>

<div class="container">
    <div class="row">
        <div class="col-md-9">{$xoops_contents}</div>
        <div class="col-md-3">{* Sidebar *}</div>
    </div>
</div>

ถาม: ฉันจะเพิ่มโหมดมืดให้กับธีมของฉันได้อย่างไร

ก:

/* Light mode (default) */
:root {
    --bg-color: #ffffff;
    --text-color: #000000;
    --border-color: #cccccc;
}

body {
    background-color: var(--bg-color);
    color: var(--text-color);
    transition: background-color 0.3s, color 0.3s;
}

/* Dark mode */
@media (prefers-color-scheme: dark) {
    :root {
        --bg-color: #1a1a1a;
        --text-color: #ffffff;
        --border-color: #444444;
    }
}

/* Or with CSS class */
body.dark-mode {
    --bg-color: #1a1a1a;
    --text-color: #ffffff;
    --border-color: #444444;
}

สลับกับ JavaScript:

<script>
document.getElementById('dark-mode-toggle').addEventListener('click', function() {
    document.body.classList.toggle('dark-mode');
    localStorage.setItem('darkMode', document.body.classList.contains('dark-mode'));
});

// Load preference
if (localStorage.getItem('darkMode') === 'true') {
    document.body.classList.add('dark-mode');
}
</script>

ปัญหาธีม

ถาม: ธีมแสดงข้อผิดพลาด “ตัวแปรเทมเพลตที่ไม่รู้จัก”

A: ตัวแปรไม่ได้ถูกส่งไปยังเทมเพลต ตรวจสอบ:

กำหนดตัวแปร ใน PHP:

<?php
$xoopsTpl->assign('variable_name', $value);
?>

มีเทมเพลต ตามที่ระบุไว้
ไวยากรณ์เทมเพลตถูกต้อง:

{* Correct *}
{$variable_name}

{* Wrong *}
$variable_name
{variable_name}

ถาม: CSS การเปลี่ยนแปลงไม่ปรากฏในเบราว์เซอร์

A: ล้างแคชของเบราว์เซอร์:

ฮาร์ดรีเฟรช: Ctrl+Shift+R (Cmd+Shift+R บน Mac)
ล้างแคชธีมบนเซิร์ฟเวอร์:

rm -rf xoops_data/caches/smarty_cache/themes/*
rm -rf xoops_data/caches/smarty_compile/themes/*

ตรวจสอบเส้นทางไฟล์ CSS ในธีม:

ls -la themes/mytheme/style.css

ถาม: รูปภาพในธีมไม่โหลด

A: ตรวจสอบเส้นทางรูปภาพ:

{* WRONG - relative path from web root *}
<img src="themes/mytheme/images/logo.png">

{* CORRECT - use xoops_url *}
<img src="{$xoops_url}/themes/{$xoops_theme}/images/logo.png">

{* Or in CSS *}
background-image: url('{$xoops_url}/themes/{$xoops_theme}/images/bg.png');

ถาม: เทมเพลตธีมหายไปหรือทำให้เกิดข้อผิดพลาด

ตอบ: ดูข้อผิดพลาดของเทมเพลตสำหรับการแก้ไขข้อบกพร่อง

การกระจายธีม

ถาม: ฉันจะจัดแพ็คเกจธีมเพื่อจำหน่ายได้อย่างไร

A: สร้างรหัสไปรษณีย์ที่สามารถแจกจ่ายได้:

# Structure
mytheme/
├── theme.html           {* Required *}
├── style.css
├── screenshot.png       {* 300x225 recommended *}
├── README.txt
├── LICENSE
├── images/
│   ├── logo.png
│   └── favicon.ico
└── templates/           {* Optional *}
    ├── header.html
    └── footer.html

# Create zip
zip -r mytheme.zip mytheme/

ถาม: ฉันสามารถขายธีม XOOPS ของฉันได้หรือไม่

ตอบ: ตรวจสอบใบอนุญาต XOOPS:

ธีมที่ใช้คลาส/เทมเพลต XOOPS ต้องเป็นไปตามใบอนุญาต XOOPS
ธีม CSS/HTML ล้วนๆ มีข้อจำกัดน้อยกว่า
ตรวจสอบ XOOPS หลักเกณฑ์การมีส่วนร่วม เพื่อดูรายละเอียด

การแสดงธีม

ถาม: ฉันจะเพิ่มประสิทธิภาพการทำงานของธีมได้อย่างไร?

ก:

ย่อ CSS/JS - ลบโค้ดที่ไม่ได้ใช้
เพิ่มประสิทธิภาพรูปภาพ - ใช้รูปแบบที่เหมาะสม (WebP, AVIF)
ใช้ CDN สำหรับทรัพยากร
รูปภาพ ขี้เกียจโหลด:

<img src="image.jpg" loading="lazy">

เวอร์ชันที่ใช้แคช:

<link rel="stylesheet" href="{$xoops_url}/themes/{$xoops_theme}/style.css?v={$xoops_version}">

ดูประสิทธิภาพ FAQ สำหรับรายละเอียดเพิ่มเติม

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

ข้อผิดพลาดของเทมเพลต
โครงสร้างธีม
ประสิทธิภาพ FAQ
การดีบักอย่างชาญฉลาด

#xoops #themes #faq #การแก้ไขปัญหา #การปรับแต่ง