Date: Fri,  4 Feb 2011 16:58:00 +0000
Mime-Version: 1.0 (Produced by PhpWiki 1.4.0)
Content-Type: application/x-phpwiki;
  pagename=Help%2FMagicPhpWikiURLs;
  flags=PAGE_LOCKED;
  charset=UTF-8
Content-Transfer-Encoding: binary

== About phpwiki: URLs

一種特別的 URL, 用來建立連結以執行管理和 PhpWiki 裡的其他特殊功能.
這裡是它們如何運作的簡短描述.

phpwiki 的基礎語法: URL 是

<pre>
**phpwiki:**''pagename''**?**''query-args''
</pre>

如果 _pagename_ 被忽略,那麼預設為目前頁面.

_Query-args_ 應該是以標準 HTTP GET 格式表示的一組參數.

"action=''x''" 參數應該都要被給定. 他可以是這些值的其中一個:
**browse**, **diff**, **edit**, **viewsource**,
**zip**, **dumpserial**, **loadserial**,
**remove**, **lock**, **unlock**,
**login**, **logout**, **setprefs** or **save**.
預設的動作是 **browse**.

部份動作接受其他參數.

**FullTextSearch**, **TitleSearch**:

  接受 **s** 表示欲搜尋的字串, 而 **size** 表示輸入的長度.

**edit**:

  接受 **version**.

**remove**:

  接受 **verify**.

**save**:

  接受 **editversion**, **minor_edit**, 和 **content**.

**setprefs**:

  接受 **edit_area_width**, **edit_area_height**.

=== Writing Magic Links in Wiki Pages

一個 magic 連結看起來會是:

<pre>
**~[** ''text'' **|** ''phpwiki-url'' **]**
</pre>

"''text'' *|*" 是可選的,但通常建議使用. 如果給了,他會為此連結提供標籤.

_phpwiki-url_ 就如同上面描述的一樣,是一個 *phpwiki:* URL.

==== Some examples

{{{
[ Edit the SandBox | phpwiki:SandBox?action=edit ]
}}}
將會產生一個連結,而他將會直接引領你去編輯 SandBox, 像是:
[Edit the SandBox | phpwiki:SandBox?action=edit].

其他可能的用法:
* [ Diff the SandBox | phpwiki:SandBox?action=diff ],
* [ Lock the HomePage | phpwiki:HomePage?action=lock ],
* [ Get a Full Zip Dump | phpwiki:?action=zip&include=all ],
* Search for [ Page titles containing 'wiki' | phpwiki:?action=TitleSearch&s=wiki ]

=== Writing Magic Forms in Wiki Pages

''**Note**: 舊的 Magic forms 語法將不再支援.
他們需以 =<?plugin-form>= 代替.''

If the plugin is called using *<?plugin-form* instead of *<?plugin*
and the plugin supports searching, then it will be rendered as a form.

''size'':

  If given, specifies the size of the input area.

''s'':

  Specifies the default value for the input.

==== Examples:

A search plugin invoked with *<?plugin* instead of *<?plugin-form*
simply inserts the search results of the plugin:

{{{
<<TitleSearch s=wiki noheader=true >>
}}}

Search results for Page titles containing 'wiki':

<<TitleSearch s=wiki noheader=true >>

{{{
<?plugin-form FullTextSearch ?>
}}}

gives

<?plugin-form FullTextSearch ?>

While

{{{
<?plugin-form TitleSearch formsize=12 ?>
}}}

yields

<?plugin-form TitleSearch formsize=12 ?>

<noinclude>
----
[[PhpWikiDocumentation]]
</noinclude>