插件扩展

插件注册的扩展标签，启用插件后可用。

留言表单 guestbookform

渲染内置留言板表单，自动带上来源栏目、回跳地址与 CSRF 令牌。

调用格式

{pycms:guestbookform /}

参数

完整示例

<section class="guestbook">
    <h2>在线留言</h2>
    {pycms:guestbookform catid="$category.id" /}
</section>

留言字段来自后台「模型管理 → 表单模型」；验证码由平台设置 captcha_guestbook 控制。

留言列表 guestbook

读取已审核通过的留言，支持条数与空数据提示；标签本身直接循环。

调用格式

{pycms:guestbook num="30" id="message"}...{/pycms:guestbook}

参数

可用字段

• $message.id
• $message.name
• $message.email
• $message.content
• $message.create_time
• $message.category_name
• $message.fields

完整示例

{pycms:guestbook num="30" id="message" empty="还没有留言，来抢沙发吧。"}
    <div class="guestbook-item">
        <strong>{$message.name}</strong>
        <time>{pycms:date name="$message.create_time" format="Y-m-d H:i" /}</time>
        <p>{$message.content}</p>
        {pycms:volist name="$message.fields" id="field"}
            <span>{$field.display|raw}</span>
        {/pycms:volist}
    </div>
{/pycms:guestbook}

只显示后台审核通过的留言；字段展示使用 $message.fields 循环。