安裝插件

出自MoodleDocs
前往:導覽、​搜尋

附加組件是一種可選的插件,可以為Moodle增加額外的特性及功能,如新的活動,新的測驗問題類型,新的報告,或與其他系統進行整合等等。

「插件」和「附加組件」是什麼意思?

Moodle = 核心代碼 + 插件

插件可以是標準的插件(通過Moodle軟體包一起下載的插件為標準插件),也可以是附加組件。

生產站點的注意事項(如果只是使用Moodle請跳過這一步)

非常重要的警告:請注意一些附加組件並沒有被審閱過,他們的質量或(及)適應性是否適合你的Moodle站點也沒有被檢查過。請小心使用。他們可能達不到你的期望,也可能有安全問題,甚至根本不能正常運行。這就是為什麼需要完善隨著時間推移不斷發展的新插件目錄系統。

  • 如果你的生產站點比較龐大,考慮一下你真的需要用到插件嗎?更多的功能意味著更多的支持,(潛在)更多的錯誤,升級的時候需要擔心更多的東西。
  • 插件能獲得支持或維護嗎?如若出了問題能否找到支持?有人修復Bug嗎?
  • 如若插件在Moodle以後的版本不能用了,你怎麼辦?
  • 留意補丁其他類型的插件目錄)!如果插件被修改或替換了核心文件,那麼就要當心了。插件只能在創建它時的Moodle確切版本下才能正常工作,插件極有可能不會在Moodle升級後還存活下來。

安裝附加組件

為安裝插件,其源碼必須部署在Moodle安裝目錄下合適的位置,還需要訪問管理主頁管理>網站管理>通告。有3種方法可以部署插件代碼。

Moodle 2.5及以上版本,插件可以從Moodle內部部署,或者直接從插件目錄上傳壓縮文件。Web伺服器必須要有插件目錄文件夾的可寫權限以使新插件可以通過這些方法中的一個進行安裝。

除此之外,插件源碼也可以在伺服器手動部署。

直接在插件目錄進行安裝

  1. 以管理員身份登錄,訪問管理>網站管理>插件>安裝插件
  2. 點擊按鈕「從Moodle插件目錄安裝插件」。
  3. 使用安裝按鈕進行搜索插件,點擊安裝按鈕然後點擊繼續。
  4. 核驗是否收到「驗證通過!」的信息,然後點擊「安裝插件」按鈕。

通過上傳的ZIP文件進行安裝

  1. 訪問Moodle插件目錄頁面,選擇你站點當前的Moodle版本,然後選擇一個插件並點擊下載按鈕進行ZIP文件的下載。
  2. 以管理員身份登錄,訪問管理>網站管理>插件>安裝插件
  3. 上傳ZIP文件,選擇合適的插件類型,勾選確認複選框,然後點擊按鈕「從ZIP文件安裝插件」。
  4. 核驗是否收到「驗證通過!」的信息,然後點擊「安裝插件」按鈕。

安裝附加組件

對於上述兩種方法,點擊按鈕「安裝插件」之後,頁面會自動跳轉到設置>網站管理>通告,然後安裝進程(如,創建必要的資料庫等等)會開始進行。

在伺服器手動安裝

如果不能通過Web管理界面部署插件源碼,那麼必須手動複製源碼到伺服器的文件系統(如,當你沒有Web伺服器Moodle安裝目錄的可寫權限時)。

首先,為插件類型在Moodle源碼目錄下建立正確的位置。通常位置在:

  • /path/to/moodle/theme/ —— 佈景
  • /path/to/moodle/mod/ —— 活動模组及資源
  • /path/to/moodle/blocks/ —— 側邊欄
  • /path/to/moodle/question/type/ —— 問題類型
  • /path/to/moodle/course/format/ —— 課程格式
  • /path/to/moodle/admin/report/ —— 管理報告

訪問dev:插件以參閱完整的插件列表及他們在Moodle目錄下的位置。

  1. 訪問Moodle插件目錄頁面,選擇你站點當前的Moodle版本,然後選擇一個插件並點擊下載按鈕進行下載ZIP文件。
  2. 將ZIP文件上傳或複製到Moodle伺服器。
  3. 根據插件類型解壓ZIP文件到正確的地方(或根據插件說明來做)。
  4. 以管理員帳號登錄後,訪問設置>網站管理>通告(對大多數插件類型而言,會得到一條說插件已安裝的消息通知)。

注意:插件可能包含語言文件。Moodle可以自動探測出他們。使用標準的設置>網站管理>語言編輯界面可以對這些語言字符串進行定製化操作。如若在編輯語言文件出現「資料庫錯誤」的提示則很有可能是下載的插件內的語言文件有編碼問題。如若刪除含有語言字符串的「plugin_name/lang/other_language_different_to_English/」文件夾後,錯誤消失了,那麼可以確定是語言文件有問題。請告知插件維護人員以使插件在未來的版本可以得到修復。

疑難解答

錯誤

如果出現錯誤,請打開調試模式以獲得關於引起錯誤原因的額外信息。

tool_installaddon/err_curl_exec - cURL error 60
這個信息表明了錯誤是由遠程伺服器站點SSL證書認證引起的問題。運行在Win7伺服器上的Moodle會出現這種問題。參見moodle.org的SSL認證文檔獲取更多相關信息及可能的解決方案。

出現文件權限錯誤

安裝插件後,接著創建、保存並部署模组實例時會出現的一個常見錯誤是「出現一個文件權限錯誤。請檢查腳本及所在目錄的權限後重試」。如果看到這條錯 誤信息,那麼插件目錄的文件權限很可能被設置為711使得不能正常運行。通過FTP客戶端或虛擬主機控制面板對安裝模组的文件夾及文件進行文件權限設置, 如,設置/moodle/mod/[myplugin]/ 為755,然後查看是否可以正常訪問模组實例。

如果是手動安裝

  • 檢查文件權限。Web伺服器需要讀取插件文件。如果Moodle其他功能正常運行,那麼試著讓插件權限與所有權相匹配。
  • 是否能確定地把插件解壓或安裝在正確的地方?
  • 因為Moodle會瀏覽插件文件夾以搜尋新的插件,所以插件目錄內不能有任何其他文件或文件夾。確保已經刪除了壓縮包,也不要嘗試著把舊版本的插件重命名為(舉例)其他名字——這樣還是會崩潰的。
  • 確保插件目錄名是對的。所有文件名必須相匹配。所有名稱必須相匹配。如若改變文件名,插件則不能正常工作。

獲得幫助

使用Moodle討論區的合適區塊詢問。務必要描述清楚你的問題(包括MySLQ、PHP的版本等)及為此做過什麼,出現了什麼情況。粘貼並複製所有錯誤信息。提供下載插件的具體連結(很多插件名是相似的)。

卸載插件

如需卸載插件:

  1. 訪問管理>網站管理>插件>插件概覽,然後點擊欲移除插件相對應的卸載按鈕;
  2. 按照指示使用文件管理器移除/刪除對應的插件目錄,否則下次訪問管理界面時插件會重新安裝。

插件概覽


插件概覽高亮了檢查可用更新按鈕

管理>網站管理>插件>插件概覽內的插件概覽頁面列出了所有已安裝的插件,並說明了插件的版本號,是否已發布(2.7新功能),可用性(啟用或禁用)及設置連結(如果有的話)。

按鈕「檢查可用更新」使得管理員可以快速檢查安裝在Moodle站點上的標準插件或附加組件(從插件目錄得知)是否有可用更新。任何可用更新都會高亮顯示,並附有進一步的信息及與插件相對應的備註欄里的下載連結。

從Moodle內部更新插件

Moodle2.4版本及以上,管理員可以通過管理>網站管理>伺服器>更新通知啟用更新部署。每當有可用更新,「安裝這個更新」的按鈕就會顯示在插件概覽頁面。參見自動更新部署以獲取更多信息。

避免從Moodle內部安裝插件

如有需要,從config-dist.php粘貼如下代碼到config.php可以防止從Moodle內部安裝及升級插件:
// Use the following flag to completely disable the On-click add-on installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

另請參閱

為開發人員: