Editing MediaWiki extensions

{{Template:MediaWiki Installation}}

== 擴充套件的安裝 ==
* 下載[http://www.mediawiki.org/wiki/Manual:Extensions 擴充套件] (或從[http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/ SVN]下載)
* 放置於 {mediawiki}/extensions/
* 修改LocalSettings.php
** 注意檔首無BOM格式
** (選擇性) 在檔尾嵌入: require_once("extensions/ExtensionFunctions.php"); ## [http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/ExtensionFunctions.php?view=log 下載ExtensionFunctions.php]
** 在檔尾嵌入擴充套件 require_once("extensions/ExtensionName.php");
:: 避免放在 require_once( "includes/DefaultSettings.php" ); 之前

== 擴充套件: 自訂新增文章的格式 ==
用途
* 事先自訂新文章的格式，方便使用者編輯

應用例子
* Wikinews讓使用者[http://en.wikinews.org/wiki/Wikinews:Writing_an_article 撰寫新聞](Writing an article)時，能套用[http://en.wikinews.org/wiki/Template:New_page Template:New page模版]。 點選網頁上方View source或Edit即可看到模版語法。
* [http://proj.daodin.net/mediawiki/index.php/%E9%A6%96%E9%A0%81 全球之聲GVO中文翻譯小組協作平台]，讓成員翻譯文章時，能套用[http://proj.daodin.net/mediawiki/index.php/%E6%A8%A1%E6%9D%BF:Newarticle 模板:Newarticle]。
* [http://index.wikia.com/index.php?title=%E9%A6%96%E9%A1%B5&variant=zh-tw 圍紀導航]讓使用者添加新站，能套用[http://index.wikia.com/wiki/Template:Addnewwiki 模板 Add New Wiki]。

安裝「輸入欄」和「新增文章」套件
* 下載[http://www.mediawiki.org/wiki/Extension:InputBox Inputbox 「輸入欄」]套件
* 下載[http://www.mediawiki.org/wiki/Extension:CreateArticle CreateArticle 「新增文章」]套件
* 將原始碼複製到{mediawiki}/extensions 
* 檔案結構為
<pre>
{MediaWiki}/
|- extensions/
   |- CreateArticle.php
   |- inputbox.php
</pre>
* 修改LocalSettings.php，在頁尾加入
<pre>
require_once("extensions/inputbox.php");
require_once("extensions/CreateArticle.php" );
</pre>


Demo: 學習單範本
<pre>
<center>在此輸入學習單標題</center>
<inputbox> 
type=create
default=學習單_
width=30
preload=Template:New_worksheet
buttonlabel= 新增學習單
</inputbox>
</pre>

{{Tip | tip=
若遭遇錯誤訊息「Input box: type not defined.」
: 請刪除 type=create 該行結尾處的空白字元。 }}

== 擴充套件: 匯入自由圖像 ==
用途: 
* 匯入[http://www.flickr.com/search/advanced/ Flickr]中創用CC授權的相片


安裝方法
* 檢查PHP.ini的 allow_url_fopen 是On
* 下載安裝[http://www.mediawiki.org/wiki/Extension:ImportFreeImages ImportFreeImages] 及 [http://sourceforge.net/projects/phpflickr phpFlickr]套件
* 檔案結構為
<pre>
{MediaWiki}/
|- extensions/
   |- ImportFreeImages/
      |- ImportFreeImages.php
      |- README
</pre>

* 修改LocalSettings.php: 啟用ImportFreeImages套件
* 修改ImportFreeImages套件
** 取得[http://www.flickr.com/services/api/misc.api_keys.html Flickr API Key]，並填入ImportFreeImages.php中的$wgIFI_FlickrAPIKey
** 修正phpflickr的位置(原ImportFreeImages.php 中指到 extensions/phpFlickr-2.0.0)
* 檔案結構為
<pre>
{MediaWiki}/
|- extensions/
   |- phpFlickr-2.0.0/
      |- PEAR/
      |- phpFlickr.php
      |- ...
</pre>
* 連結到 Special:ImportFreeImages
* 修改Template:flickrx 其中x是創用CC的[http://www.flickr.com/services/api/flickr.photos.licenses.getInfo.html 授權ID]

Demo
* [http://index.wikia.com/wiki/%E7%89%B9%E6%AE%8A:ImportFreeImages?q=cat 尋找一隻貓]

== 擴充套件: 展示FreeMind心智圖 ==
用途: 上載[http://freemind.sourceforge.net/wiki/index.php/Main_Page FreeMind]心智圖到MediaWiki，透過支援[http://www.adobe.com/tw/products/flashplayer/ Flash Player]的瀏覽器即可展示。

安裝
* 下載FreeMind extension
** 下載[http://freemind.cvs.sourceforge.net/freemind/mediawiki/extensions/ freemind/] 共11個檔案，置於{mediawiki}/extensions/freemind
** 下載[http://freemind.cvs.sourceforge.net/freemind/mediawiki/extensions/ FreeMind.php]，置於 {mediawiki}/extensions
* 檔案結構為
<pre>
{MediaWiki}/
|- extensions/
   |- freemind/
      |- appletwindow.php ... (等共11個檔案)
   |- FreeMind.php
</pre>
* 修改LocalSettings.php
** 嵌入FreeMind套件: LocalSettings.php 檔尾加入 require_once("extensions/FreeMind.php");
** 增加FreeMind的檔案類型(.mm)

使用
* 在文章中的編輯語法
<pre><mm>[[Image:filename.mm]]</mm> </pre>


== 擴充套件: 嵌入Flash動畫/服務 ==
用途: 在MediaWiki嵌入flash檔，可以直接展示flash動畫/服務，如[http://www.debugmode.com/wink/ Wink]的[[Multimedia Online Helpdesk Software|說明動畫]] 或 [http://www.meebo.com/ Meebo]的線上聊天室(meebo me widgets, [http://www.library.ohiou.edu/subjects/bizwiki/index.php/Main_Page 例])。

安裝
* 複製[http://junkchest.blogspot.com/2005/03/wiki-adding-extensions-to-mediawiki.html#c111006002941461725 程式碼]，並儲存為gflash.php，置於{mediawiki}/extensions/
* 修改LocalSettings.php
** 嵌入FreeMind套件: LocalSettings.php 檔尾加入 require_once("extensions/gflash.php");
** (選擇性) 增加允許上載的Flash檔案類型(.swf)

使用
* 在文章中的編輯語法
<pre><gflash>寬度 高度 flash檔所在的網址</gflash>
例如: <gflash>480 340 http://www.chikinramen.com/exercise/exercise43.swf</gflash> </pre>

{{Tips}} 因為flash檔是編譯後的檔案，如果要提供良好的協同編輯互動，建議同時提供原始專案檔。


== 其他擴充套件 ==
* 以[[MediaWiki footnotes|註腳方式]]呈現參考資料
* 將「所見即所得」的線上編輯器[[Integrate FCKeditor to MediaWiki|FCKeditor整合至MediaWiki]]
* 自動偵測行動裝置 (例如手機) 上的瀏覽器，並切換版面為行動裝置適合閱讀的版面 [https://www.mediawiki.org/wiki/Extension:MobileFrontend Extension:MobileFrontend]
* [http://www.mediawiki.org/wiki/Category:Extensions 更多擴充套件... ...]

== 擴充套件的相關文件 ==
* [http://www.mediawiki.org/wiki/Extending_wiki_markup Extending wiki markup - MediaWiki]

他山之石
* [http://www.mediawiki.org/wiki/Category:Extensions_used_on_Wikimedia Extensions used on Wikimedia]([http://zh.wikipedia.org/w/index.php?title=Special:Version&variant=zh-tw Wikipedia]...)
* [http://index.wikia.com/wiki/%E7%89%B9%E6%AE%8A:Version 版本 - wiki网址导航 - a Wikia wiki]


[[Category:MediaWiki]]