环境要求

JVCMS 基于 PHP + MySQL 开发，部署前请确认服务器满足以下条件：

安装步骤

• 将 JVCMS 发行版上传至网站根目录并解压
• 创建 MySQL 数据库（utf8 字符集）
• 浏览器访问站点域名，进入安装向导填写数据库信息
• 安装完成后删除或保护 install.php，登录后台开始建站

部署时请根据服务器类型配置伪静态，具体规则见「伪静态配置」章节。

目录结构

├── index.php              # 前台入口
├── admin.php              # 后台入口
├── api.php                # 应用市场接口
├── config.php             # 数据库配置
├── Application/
│   ├── Controllers/       # 控制器（Web/Admin/Api）
│   ├── Core/              # 内核：Lang、Hook、Setting 等
│   ├── Kernel/Kernel.php  # 全局常量与契约定义
│   ├── Models/Repository.php  # 数据仓库层
│   ├── Plugin/            # 插件目录
│   └── Template/Engine/   # 模板引擎
├── Template/
│   └── default/           # 默认模板
│       ├── pc/            # PC端模板
│       └── mobile/        # 移动端模板（存在则自动启用）
├── languages/             # 17语言包
└── uploads/               # 上传文件

URL 路由规则

JVCMS 前台采用伪静态路由，支持语言前缀（如 /en/list/4.html）：

模板中使用 {jv:url} 前缀标签自动生成带语言前缀的链接，例如：

<a href="{jv:url}list/4.html">列表页</a>
<a href="{jv:url}article/123.html">详情页</a>

伪静态配置

请根据服务器类型选择对应的一组伪静态规则，保存到相应配置文件后重载 Web 服务。IIS / Windows 需先安装 URL Rewrite 模块。

Nginx：写入站点 server 段内，或单独的伪静态配置文件。

# Nginx 伪静态
location / {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php?s=$1 last;
    }
}
rewrite ^/[a-z][a-z]/index\.php$ /index.php last;
rewrite ^/[a-z][a-z]-[A-Z][A-Z]/index\.php$ /index.php last;

Apache：保存为网站根目录下的 .htaccess 文件。

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^[a-z][a-z]/index\.php$ index.php [QSA,L]
RewriteRule ^[a-z][a-z]-[A-Z][A-Z]/index\.php$ index.php [QSA,L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>

IIS / Windows：保存为网站根目录下的 web.config 文件。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.webServer>
    <rewrite>
      <rules>
        <rule name="JVCMS Lang Index" stopProcessing="true">
          <match url="^[a-z][a-z]/index\.php$" />
          <action type="Rewrite" url="index.php" />
        </rule>
        <rule name="JVCMS Lang Index Region" stopProcessing="true">
          <match url="^[a-z][a-z]-[A-Z][A-Z]/index\.php$" />
          <action type="Rewrite" url="index.php" />
        </rule>
        <rule name="JVCMS" stopProcessing="true">
          <match url="(.*)" />
          <conditions>
            <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
          </conditions>
          <action type="Rewrite" url="index.php/{R:1}" />
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>

模板开发

每个模板存放于 /Template/[模板代号]/ 目录，包含独立的 pc/ 与 mobile/ 子目录。切换模板只需在后台“我的应用”中启用对应模板；当移动端目录存在时，手机访问自动使用 mobile/ 模板，否则回退到 pc/ 模板。

/Template/blog/
├── pc/
│   ├── header.html      # 公共头部
│   ├── footer.html      # 公共底部
│   ├── index.html       # 首页
│   ├── lists_article.html   # 文章列表页
│   ├── article.html     # 文章详情页
│   └── skin/            # css/js/images 资源
└── mobile/              # 移动端（可选）

模板文件为纯 HTML，不允许包含 PHP 代码，全部数据通过 {jv:...} 标签输出。公共部分使用 include 标签引入：

{jv:include file='header.html' /}
<div class="main">
  {jv:artlist typeid="4" loop="10"}
  <a href="{jv:arcurl}">{jv:title}</a>
  {/jv:artlist}
</div>
{jv:include file='footer.html' /}

多语言机制

系统内置 17 种语言：简体中文、繁體中文、हिन्दी、English、Indonesia、Português、Русский、اردو、Español、日本語、বাংলা、Tiếng Việt、Deutsch、Türkçe、ไทย、Français、한국어。语言包位于 languages/{语言代码}/web.php（前台）与 admin.php（后台）。

模板中通过 lang 标签输出多语言文本：

{jv:lang name='view_more' /}

<!-- languages/en/web.php -->
<?php return ['view_more' => 'View More'];

语言切换器使用 language 循环标签生成：

{jv:language}
  <a href="{jv:language_url}">{jv:name}</a>
{/jv:language}

详情页字段

文章/下载/商品详情页可直接使用以下字段别名：

插件开发

插件存放于 Application/Plugin/[插件代号]/ 目录，入口文件为 plugin.php。插件通过 Hook 机制挂载到模板钩子点或后台菜单。

Application/Plugin/myplugin/
├── plugin.php       # 插件入口（注册钩子/菜单）
├── config.php       # 插件信息
└── ...              # 业务文件

模板中预留钩子点：

{jv:hook name='footer_ad' /}

# 插件内监听
Hook::add('template_footer_ad', function($html, $data){
    return $html . '<div>插件输出</div>';
});

后台菜单集成：插件可注册独立的后台管理页面与左侧导航菜单，通过 AdminController 的插件路由处理 GET/POST 请求。

分页设置

• 每个分类可在后台“分类管理”中单独设置每页显示数量（1-200，默认10）
• 当文章总数超过每页数量时自动显示分页导航
• 分页URL格式：/list/4.html（第1页）、/list/4/2.html（第2页）
• 分页导航包含：首页 / 上一页 / 页码 / 下一页 / 尾页，当前页高亮

{jv:pagelist /}