“模区块FAQ”

模区块常见问题

有关 XOOPS 模区块、安装和管理的常见问题和解答。

安装和激活

问：如何在XOOPS中安装模区块？

答： 1.下载模区块zip文件 2. 转到XOOPS管理 > 模区块 > 管理模区块 3. 单击“浏览”并选择 zip 文件 4. 点击“上传” 5. 该模区块出现在列表中（通常处于停用状态） 6. 单击激活图标以启用它

或者，将 zip 直接解压到 /XOOPS_root/modules/ 中并导航到管理面板。

问：模区块上传失败并显示“权限被拒绝”

答：这是一个文件权限问题：

# Fix module directory permissions
chmod 755 /path/to/xoops/modules

# Fix upload directory (if uploading)
chmod 777 /path/to/xoops/uploads

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

有关更多详细信息，请参阅模区块安装失败。

问：为什么安装后在管理面板中看不到该模区块？

答：检查以下内容：

模区块未激活 - 单击模区块列表中的眼睛图标
缺少管理页面 - 模区块在 XOOPSversion 中必须具有 hasAdmin = 1。php
语言文件丢失 - 需要language/english/admin.php
缓存未清除 - 清除缓存并刷新浏览器

# Clear XOOPS cache
rm -rf /path/to/xoops/xoops_data/caches/*

问：如何卸载模区块？

答：

转到XOOPS管理 > 模区块 > 管理模区块
停用模区块（单击眼睛图标）
单击trash/delete图标
如果要完全删除，请手动删除模区块文件夹：

rm -rf /path/to/xoops/modules/modulename

模区块管理

问：禁用和卸载有什么区别？

答：

禁用：停用模区块（单击眼睛图标）。数据库表仍然存在。
卸载：删除模区块。删除数据库表并从列表中删除。

要真正删除，还要删除该文件夹：

rm -rf modules/modulename

问：如何检查模区块是否正确安装？

A: 使用调试脚本：

<?php
// Create admin/debug_modules.php
require_once XOOPS_ROOT_PATH . '/mainfile.php';

if (!is_object($xoopsUser) || !$xoopsUser->isAdmin()) {
    exit('Admin only');
}

echo "<h1>Module Debug</h1>";

// List all modules
$module_handler = xoops_getHandler('module');
$modules = $module_handler->getObjects();

foreach ($modules as $module) {
    echo "<h2>" . $module->getVar('name') . "</h2>";
    echo "Status: " . ($module->getVar('isactive') ? "Active" : "Inactive") . "<br>";
    echo "Directory: " . $module->getVar('dirname') . "<br>";
    echo "Mid: " . $module->getVar('mid') . "<br>";
    echo "Version: " . $module->getVar('version') . "<br>";
}
?>

问：我可以运行同一模区块的多个版本吗？

答：不，XOOPS 本身不支持此功能。但是，您可以：

使用不同的目录名称创建副本：mymodule 和 mymodule2
更新两个模区块的 XOOPSversion 中的目录名。php 3.确保数据库表名唯一

不建议这样做，因为它们共享相同的代码。

模区块配置

问：在哪里配置模区块设置？

答：

转到XOOPS管理 > 模区块
单击模区块旁边的settings/gear图标
配置首选项

设置存储在 XOOPS_config 表中。

通过代码访问：

<?php
$module_handler = xoops_getHandler('module');
$module = $module_handler->getByDirname('modulename');
$config_handler = xoops_getHandler('config');
$settings = $config_handler->getConfigsByCat(0, $module->mid());

foreach ($settings as $setting) {
    echo $setting->getVar('conf_name') . ": " . $setting->getVar('conf_value');
}
?>

问：如何定义模区块配置选项？

答：在 XOOPS 版本中。php：

<?php
$modversion['config'] = [
    [
        'name' => 'items_per_page',
        'title' => '_AM_MYMODULE_ITEMS_PER_PAGE',
        'description' => '_AM_MYMODULE_ITEMS_PER_PAGE_DESC',
        'formtype' => 'text',
        'valuetype' => 'int',
        'default' => 10
    ],
    [
        'name' => 'enable_feature',
        'title' => '_AM_MYMODULE_ENABLE_FEATURE',
        'description' => '_AM_MYMODULE_ENABLE_FEATURE_DESC',
        'formtype' => 'yesno',
        'valuetype' => 'bool',
        'default' => 1
    ]
];
?>

模区块特点

问：如何向我的模区块添加管理页面？

A: 创建结构：

modules/mymodule/
├── admin/
│   ├── index.php
│   ├── menu.php
│   └── menu_en.php

在 XOOPS 版本中。php：

<?php
$modversion['hasAdmin'] = 1;
$modversion['adminindex'] = 'admin/index.php';
?>

创建admin/index.php：

<?php
require_once XOOPS_ROOT_PATH . '/kernel/admin.php';

xoops_cp_header();
echo "<h1>Module Administration</h1>";
xoops_cp_footer();
?>

问：如何向我的模区块添加搜索功能？

答： 1.在XOOPSversion.php中设置：

<?php
$modversion['hasSearch'] = 1;
$modversion['search'] = 'search.php';
?>

创建search.php：

<?php
function mymodule_search($queryArray, $andor, $limit, $offset) {
    // Search implementation
    $results = [];
    return $results;
}
?>

问：如何向我的模区块添加通知？

答： 1.在XOOPSversion.php中设置：

<?php
$modversion['hasNotification'] = 1;
$modversion['notification_categories'] = [
    ['name' => 'item_published', 'title' => '_NOT_ITEM_PUBLISHED']
];
$modversion['notifications'] = [
    ['name' => 'item_published', 'title' => '_NOT_ITEM_PUBLISHED']
];
?>

2.代码中触发通知：

<?php
$notification_handler = xoops_getHandler('notification');
$notification_handler->triggerEvent(
    'item_published',
    $item_id,
    'Item published',
    'description'
);
?>

模区块权限

问：如何设置模区块权限？

答：

转到XOOPS管理 > 模区块 > 模区块权限
选择模区块
选择user/group和权限级别
保存

代码中：

<?php
// Check if user can access module
if (!xoops_isUser()) {
    exit('Login required');
}

// Check specific permission
$mperm_handler = xoops_getHandler('member_permission');
$module_handler = xoops_getHandler('module');
$module = $module_handler->getByDirname('mymodule');

if (!$mperm_handler->userCanAccess($module->mid())) {
    exit('Access denied');
}
?>

模区块数据库

问：模区块数据库表存储在哪里？

答：全部位于主 XOOPS 数据库中，以您的表前缀为前缀（通常为 XOOPS_）：

# List all module tables
mysql> SHOW TABLES LIKE 'xoops_mymodule_%';

# Or in PHP
<?php
$result = $GLOBALS['xoopsDB']->query(
    "SHOW TABLES LIKE '" . XOOPS_DB_PREFIX . "mymodule_%'"
);
while ($row = $result->fetch_assoc()) {
    print_r($row);
}
?>

问：如何更新模区块数据库表？

A: 在您的模区块中创建更新脚本：

<?php
require_once '../../mainfile.php';

if (!is_object($xoopsUser) || !$xoopsUser->isAdmin()) {
    exit('Admin only');
}

// Add new column
$sql = "ALTER TABLE `" . XOOPS_DB_PREFIX . "mymodule_items`
        ADD COLUMN `new_field` VARCHAR(255)";

if ($GLOBALS['xoopsDB']->query($sql)) {
    echo "✓ Updated successfully";
} else {
    echo "✗ Error: " . $GLOBALS['xoopsDB']->error;
}
?>

模区块依赖

问：如何检查是否安装了所需的模区块？

答：

<?php
$module_handler = xoops_getHandler('module');

// Check if a module exists
$module = $module_handler->getByDirname('required_module');

if (!$module || !$module->getVar('isactive')) {
    die('Error: required_module is not installed or active');
}
?>

问：模区块可以依赖其他模区块吗？

A: 是的，在 XOOPSversion 中声明。php:

<?php
$modversion['dependencies'] = [
    [
        'dirname' => 'required_module',
        'version_min' => '1.0',
        'version_max' => 0,  // 0 = unlimited
        'order' => 1
    ]
];
?>

故障排除### 问：模区块出现在列表中但无法激活

答：检查：

XOOPSversion.php语法 - 使用PHP linter：

php -l modules/mymodule/xoopsversion.php

2.数据库SQL文件：

# Check SQL syntax
grep -n "CREATE TABLE" modules/mymodule/sql/mysql.sql

语言文件：

ls -la modules/mymodule/language/english/

有关详细诊断信息，请参阅模区块安装失败。

问：模区块已激活，但未在主站点中显示

答：

在XOOPSversion.php中设置hasMain = 1：

<?php
$modversion['hasMain'] = 1;
$modversion['main_file'] = 'index.php';
?>

创建modules/mymodule/index.php：

<?php
require_once '../../mainfile.php';
include_once XOOPS_ROOT_PATH . '/header.php';

echo "Welcome to my module";

include_once XOOPS_ROOT_PATH . '/footer.php';
?>

问：模区块导致“白屏死机”

A: 启用调试来查找错误：

<?php
// In mainfile.php
error_reporting(E_ALL);
ini_set('display_errors', '1');
define('XOOPS_DEBUG_LEVEL', 2);
?>

检查错误日志：

tail -100 /var/log/php/error.log
tail -100 /var/log/apache2/error.log

请参阅白屏死机以获取解决方案。

性能

问：模区块速度慢，如何优化？

答：

检查数据库查询 - 使用查询日志记录
缓存数据 - 使用XOOPS缓存：

<?php
$cache = xoops_cache_handler::getInstance();
$data = $cache->read('mykey');
if ($data === false) {
    $data = expensive_operation();
    $cache->write('mykey', $data, 3600);  // 1 hour
}
?>

优化模板 - 避免模板中出现循环
启用PHP操作码缓存 - APCu、XDebug等。

有关更多详细信息，请参阅性能FAQ。

模区块开发

问：在哪里可以找到模区块开发文档？

答：参见：

模区块开发指南
模区块结构
创建您的第一个模区块