add

分类

命令

重要程度

★☆☆☆☆

格式
?cmd=add &page=页面名称
概述

运行后显示编辑画面。按下更新按钮后,会在当前指定页面底部添加编辑框输入的内容。

参数

不能省略页面名称。页面名称必须进行编码。

edit的编辑画面显示当前页面内容相反,add的编辑画面总是空的。为了防止不小心输入改变现有内容,仅在当前页面添加内容的话使用add很方便。

备注

虽然当初已被作为默认主题菜单中的「添加」功能,但edit命令(编辑)已经足够,因此已从删除默认主题的菜单中删除。

当 PKWK_READONLY 启用时,该插件的所有请求都会失效。

addline

分类
(命令)
块型插件
内联型插件
重要程度
★★☆☆☆
格式
#addline( [设定名称] {, [above|below|up|down|btn:[按钮名称]|ltext:[左文本]|rtext:[右文本]]} )
&addline( [设定名称] {, [before|after|above|below|up|down]} ){ [链接名称] };
参数
设定名称: 指定「:config/plugin/addline/设定名称」
  • above|below|up|down: 与#comment相同,追加时指定按钮的上下
  • btn: 提交按钮的名称
  • ltext,rtext: 提交按钮左右附带的文本
  • before,after: 内联型时,指定添加链接的前(左)或后(右)
概述
按下按钮或者链接,将指定的字符串变成设定页面指定的行单元。内联型也可以添加同行内的字符串单元。按钮或链接的符号也可以改变。
作者
sha

aname

分类

块型插件

内联型插件

重要程度

★★★★☆

格式

#aname( 锚点名称 [,{[super], [full], [noid]}, 锚点字符串] )

&aname( 锚点名称 [,{[super], [full], [noid]}] ){ 锚点字符串 };

概述

创建一个可用作锚点的链接。

参数

锚点名称用作URL片段的标识符。锚点名称不能省略。锚点名称必须使用半角英文(大写/小写)。

super,full,noid决定了锚点的显示方式。

  • super - 锚点字符串显示为上标。省略时不会显示上标。
  • full - 锚点显示完整的URL。省略时只显示片段标识符。
  • noid - 不显示片段标识符。

如果指定了锚点字符串,该字符串才会成为锚点。用户才会看到。省略时锚点对应空字符串。


指定super,full,noid任意一个时,省略锚点字符串无法省略。

插件内設定

  • PLUGIN_ANAME_ID_MAX 锚点名称的最大长度
  • PLUGIN_ANAME_ID_REGEX 允许作为锚点名称的正则表达式
  • PLUGIN_ANAME_ID_MUST_UNIQUE 如果有重复的锚点名称则报错
备注

通常情况下作为内联型插件使用。如果想在两个块型插件之间设置锚点,也可以用块型插件的格式来使用。

由于PukiWiki内部调用了aname插件,它必须始终存在。

article

分类

(命令)

块型插件

重要程度

★★★☆☆

格式
#article
概述

在指定的位置显示简易的BBS。

插件内设定

  • PLUGIN_ARTICLE_COLS 文本区域中的列数
  • PLUGIN_ARTICLE_ROWS 文本区域中的行数
  • PLUGIN_ARTICLE_NAME_COLS 用户名区域中的列数
  • PLUGIN_ARTICLE_SUBJECT_COLS 标题区域中的列数
  • PLUGIN_ARTICLE_NAME_FORMAT 用户名格式
  • PLUGIN_ARTICLE_SUBJECT_FORMAT 标题格式
  • PLUGIN_ARTICLE_INS 输入内容是否在输入框的之前或之后显示
  • PLUGIN_ARTICLE_COMMENT 是否允许在发表后进行单行注释
  • PLUGIN_ARTICLE_AUTO_BR 是否自动转换换行
  • PLUGIN_ARTICLE_MAIL_AUTO_SEND 是否通过电子邮件自动转发帖子内容
  • PLUGIN_ARTICLE_MAIL_FROM 用于转发的发送方电子邮件地址
  • PLUGIN_ARTICLE_MAIL_SUBJECT_PREFIX 用于转发的电子邮件标题
  • $_plugin_article_mailto 用于转发的收件方电子邮件地址
备注

启用 PKWK_READONLY 时,此插件的全部请求都会失效。

attach

分类

(命令)

块型插件

重要程度

★★★★★

格式
#attach( [nolist] [,noform] )
概述

显示页面的附件列表,设置文件的上传表单。

参数

用 nolist, noform 指定显示格式。

  • nolist - 隐藏文件附件列表。省略时显示列表。
  • noform - 隐藏上传表单。省略时显示上传表单。
插件内設定

  • PLUGIN_ATTACH_MAX_FILESIZE 可上传的最大文件大小
  • PLUGIN_ATTACH_UPLOAD_ADMIN_ONLY 是否限制仅管理员可以上传
  • PLUGIN_ATTACH_DELETE_ADMIN_ONLY 是否限制仅管理员可以删除
  • PLUGIN_ATTACH_DELETE_ADMIN_NOBACKUP 允许PLUGIN_ATTACH_DELETE_ADMIN_ONLY时,是否省略管理员备份
  • PLUGIN_ATTACH_PASSWORD_REQUIRE 是否在上传/删除时要求密码(PLUGIN_ATTACH_~_ADMIN_ONLY优先)
  • PLUGIN_ATTACH_RENAME_ENABLE 是否允许重命名
  • PLUGIN_ATTACH_FILE_MODE 上传的文件的权限模式
  • PLUGIN_ATTACH_FILE_ICON 文件的图标
  • PLUGIN_ATTACH_CONFIG_PAGE_MIME 下载时mime-type的描述页
备注

此插件使用默认主题时是必要的,因为默认主题菜单中“上传”需要调用。

增加插件内的 PLUGIN_ATTACH_MAX_FILESIZE 时,注意设置PukiWiki之外的上限,如在php.ini中upload_max_filesize、Apache中LimitRequestBody等。

启用 PKWK_READONLY 时,此插件的「文件的新增添加、删除、锁定(解锁)」请求会失效。

attachref

分类
(命令)

块型插件
重要程度
★★☆☆☆
格式
&attachref( [附件名称] [, {ref参数 }{, button }]} ){ [按钮名称] };
参数
  • button − 显示<form></form>的提交按钮。默认情况下,显示为[添加]的字符串链接。更改<按钮名称>可改变链接或按钮显示的字符串。
概述
附件存在时与 ref 功能相同。当附件不存在时显示为[添加]的链接,点击后可出现上传框,由此上传附件后,[添加]链接所在处会变成&ref(...);。可指定显示缩略图的大小也很方便。
作者
sha