开发文档

public/plugins/my-plugin/ ├── config.json # 插件配置（必须） ├── hooks.php # 钩子注册 ├── install.php # 安装脚本 ├── uninstall.php # 卸载脚本 ├── admin.php # 后台页面 ├── api.php # API接口 └── static/ # 静态资源

{ "name": "插件名称", "app_id": "plugin-slug", "version": "1.0.0", "description": "插件描述", "author": "作者", "type": 1, "system_requirement": "FmBlog v1.0.0以上", "php_version": "7.4+", "is_system": 0, "preview": "preview.jpg", "hooks": ["admin_menu", "admin_route"], "config": { "option1": "value1" } }

function plugin_install() { global $db; // 创建数据表 $db->query("CREATE TABLE IF NOT EXISTS fm_myplugin_data ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP )"); return true; }

// 注册后台菜单 Hook::add('admin_menu', function($menu) { $menu['功能扩展'][] = [ '我的插件', '?a=myplugin', 'layui-icon-component', 'admin' ]; return $menu; }); // 注册后台路由 Hook::add('admin_route', function($routeMap) { $routeMap['myplugin'] = 'myplugin_index'; return $routeMap; });

function myplugin_index() { global $db; fmblog_title('我的插件', '插件管理页面'); // 处理表单提交 if ($_SERVER['REQUEST_METHOD'] === 'POST') { $action = post('action'); // 处理逻辑... } // 渲染页面 include 'views/header.php'; // 页面内容... include 'views/footer.php'; }

// api/myplugin.php // 函数命名格式: api_{模块}_{动作} // 调用方式: api.php?m=myplugin&a=list function api_myplugin_list() { global $db; api_check_login(); $list = $db->name('myplugin_data')->select(); api_json_success(['list' => $list]); } function api_myplugin_add() { global $db; api_check_post(); $name = post('name', ''); if (empty($name)) { api_json_error('名称不能为空'); } $id = $db->name('myplugin_data')->insert([ 'name' => $name, 'create_time' => date('Y-m-d H:i:s') ]); api_json_success(['id' => $id], '添加成功'); } function api_myplugin_delete() { global $db; api_check_login(); $id = intval(get('id', 0)); if ($id <= 0) { api_json_error('ID无效'); } $db->name('myplugin_data')->where('id', $id)->delete(); api_json_success(null, '删除成功'); }

// 获取列表 GET /api.php?m=myplugin&a=list // 添加数据 POST /api.php?m=myplugin&a=add Body: {"name": "测试"} // 删除数据 GET /api.php?m=myplugin&a=delete&id=1

public/theme/my-theme/ ├── config.json # 主题配置 ├── fun.php # 主题函数 ├── header.php # 页头模板 ├── footer.php # 页脚模板 ├── home.php # 首页模板 ├── single.php # 文章详情 ├── category.php # 分类列表 ├── page.php # 默认单页 ├── page_about.php # 自定义单页模板 ├── 404.php # 404页面 └── static/ # 静态资源

{ "name": "主题名称", "slug": "theme-slug", "version": "1.0.0", "description": "主题描述", "author": "作者", "type": "theme", "preview": "preview.jpg", "settings_page": "settings.php" }

get_config('webtitle'); // 站点名称 get_config('seodesc'); // 站点描述 get_config('site_url'); // 站点URL get_home_url(); // 首页URL

get_article_url($article); // 文章URL get_category_url($cate); // 分类URL get_page_url($page); // 单页URL theme_url('css/style.css'); // 主题资源URL

// 获取导航菜单 $menus = get_nav_menus(); // 获取分类列表 $categories = get_categories(); // 获取置顶文章 $topArticles = get_top_articles(5); // 获取最新文章 $recentArticles = get_recent_articles(10); // 获取分类文章（带分页） $result = get_articles_by_category($cateId, 10, 1); // 返回: ['list' => [...], 'total' => 100, 'page' => 1, 'pages' => 10] // 搜索文章 $result = search_articles($keyword, 10, 1);

// 截取摘要 echo excerpt($article['content'], 200); // 格式化日期 echo format_date($article['create_time'], 'Y年m月d日'); // 分页HTML echo pagination($current, $totalPages, '/?p='); // 设置页面标题 set_page_title($title, $isHome); // 获取页面标题 echo get_page_title(); // 获取文章导航（上一篇/下一篇） $nav = get_article_nav($article); // 返回: ['prev' => [...], 'next' => [...]]

<?php load_theme_file('header.php'); $articles = get_articles_paged(10, $GLOBALS['current_page'] ?? 1); foreach ($articles['list'] as $article): ?> <article> <h2><a href="<?php echo get_article_url($article); ?>"> <?php echo htmlspecialchars($article['title']); ?> </a></h2> <p><?php echo excerpt($article['content'], 200); ?></p> </article> <?php endforeach; ?> <?php echo pagination($articles['page'], $articles['pages'], '/?p='); ?> <?php load_theme_file('footer.php'); ?>

<?php $article = $GLOBALS['current_article'] ?? null; if (!$article) { render_404(); exit; } set_page_title($article['title']); load_theme_file('header.php'); ?> <article> <h1><?php echo htmlspecialchars($article['title']); ?></h1> <div><?php echo $article['content']; ?></div> </article> <?php $nav = get_article_nav($article); if ($nav['prev']): ?> <a href="<?php echo get_article_url($nav['prev']); ?>">上一篇：<?php echo htmlspecialchars($nav['prev']['title']); ?></a> <?php endif; ?> <?php load_theme_file('footer.php'); ?>

public/theme/{主题名}/hooks.php

<?php if (!defined('IN_FMCMS')) { exit('Access Denied'); } // 后台头部添加主题设置链接 Hook::on('admin_header_logo', function() { echo '<a href="?a=theme_settings">主题设置</a>'; }); // 文章表单后添加自定义字段 Hook::on('admin_article_form_after', function($article) { $customValue = $article['custom_field'] ?? ''; echo '<div class="layui-form-item">'; echo '<label class="layui-form-label">自定义字段</label>'; echo '<div class="layui-input-block">'; echo '<input type="text" name="custom_field" value="' . htmlspecialchars($customValue) . '" class="layui-input">'; echo '</div></div>'; return $article; }); // 后台仪表盘添加统计卡片 Hook::on('admin_dashboard_stats', function($stats) { global $db; $totalViews = $db->name('article')->sum('views'); $stats['total_views'] = [ 'label' => '总浏览量', 'value' => $totalViews, 'sub' => '累计', 'icon' => 'layui-icon-chart' ]; return $stats; });