https://docs.moodle.org/37/en/api.php?action=feedcontributions&user=Yuchenghu&feedformat=atomMoodleDocs - User contributions [en]2024-03-29T05:08:03ZUser contributionsMediaWiki 1.39.6https://docs.moodle.org/37/en/index.php?title=Installing_plugins&diff=106443Installing plugins2013-08-24T15:59:24Z<p>Yuchenghu: /* 从 Moodle 的插件目录中直接进行安装 */</p>
<hr />
<div>{{Installing Moodle}}<br />
An add-on is an optional plugin for adding additional features and functionality to Moodle, such as new activities, new quiz question types, new reports, integrations with other systems and many more. <br />
<br />
==What is meant by the words 'plugin' and 'add-on'?==<br />
<br />
Moodle = core code + plugins<br />
<br />
Plugins may be either standard plugins (included in the Moodle download package) or add-ons.<br />
<br />
== Considerations for production sites (skip if you're just moodling) ==<br />
<br />
'''VERY IMPORTANT''' Warning: Please be aware that some add-ons have not been reviewed, and the quality and/or suitability for your Moodle site has not been checked. Please be careful. It may not do what you expect, it may have serious security issues or it may even not work at all. This is however improving over time with the evolving new plugins directory system.<br />
<br />
* If you have a large site for production purposes consider if you '''really''' need the add-on? More functionality means more things to support, more things to (potentially) go wrong and more things to worry about at upgrade time. <br />
* Is the add-on supported and maintained? If something goes wrong can you get support? Will bugs be fixed?<br />
* If the add-on does not work in a future version of Moodle, what will you do about it?<br />
* Beware of ''patches'' ([https://moodle.org/plugins/browse.php?list=category&id=38 Moodle Plugins Directory Other category]) ! If an add-on modifies or replaces core files then be very careful. It can only be guaranteed to work with the exact build (version) of Moodle it was created for and is highly unlikely to survive a Moodle upgrade.<br />
<br />
==Installing an add-on==<br />
<br />
To install an add-on, its source code must be put (deployed) into the appropriate location inside the Moodle installation directory and the main administration page ''Administration > Site administration > Notifications'' must be visited. There are three ways how the add-on code can be deployed into Moodle.<br />
<br />
{{New features}}In Moodle 2.5 onwards, an add-on code may be deployed from within Moodle, either directly from the Moodle plugins directory or by uploading a ZIP file. The web server process has to have write access to the plugin type folder where the new add-on is to be installed in order to use either of these methods.<br />
<br />
Alternatively, an add-on code may be deployed manually at the server.<br />
<br />
===Installing directly from the Moodle plugins directory===<br />
<br />
# Login as an admin and go to ''Administration > Site administration > Plugins > Install add-ons''.<br />
# Click the button 'Install add-ons from Moodle plugins directory'.<br />
# Search for a plugin with an Install button (i.e. suitable for 2.5), click the Install button then click Continue.<br />
# Check that you obtain a 'Validation passed!' message, then click the button 'Install add-on'.<br />
<br />
===Installing via uploaded ZIP file===<br />
<br />
# Go to the [https://moodle.org/plugins Moodle plugins directory], select Moodle 2.5 as version, then choose an add-on with a Download button and download the ZIP file.<br />
# Login to your Moodle site as an admin and go to ''Administration > Site administration > Plugins > Install add-ons''.<br />
# Upload the ZIP file, select the appropriate plugin type, tick the acknowledgement checkbox, then click the button 'Install add-on from the ZIP file'.<br />
# Check that you obtain a 'Validation passed!' message, then click the button 'Install add-on'.<br />
<br />
{|<br />
| [[File:install add-ons.png|thumb|Install add-ons]]<br />
| [[File:add-on package validation.png|thumb|Add-on package validation]]<br />
|}<br />
<br />
For both of the above methods, after clicking the button 'Install add-on', you will then be automatically redirected to ''Settings > Site administration > Notifications'' and the installation process (i.e. creating required database tables etc) will happen.<br />
<br />
===Installing manually at the server===<br />
<br />
If you can't deploy the add-on code via the administration web interface, you have to copy it to the server file system manually (e.g. if the web server process does not have write access to the Moodle installation tree to do this for you).<br />
<br />
First, establish the correct place in the Moodle code tree for the add-on type. Common locations are:<br />
<br />
* /path/to/moodle/theme/ - themes<br />
* /path/to/moodle/mod/ - activity modules and resources<br />
* /path/to/moodle/blocks/ - sidebar blocks<br />
* /path/to/moodle/question/type/ - question types<br />
* /path/to/moodle/course/format/ - course formats<br />
* /path/to/moodle/admin/report/ - admin reports<br />
<br />
See [[:dev:Plugins]] for the full list of all plugin types and their locations within the Moodle tree.<br />
<br />
# Go to the [https://moodle.org/plugins Moodle plugins directory], select Moodle 2.5 as version, then choose an add-on with a Download button and download the ZIP file.<br />
# Upload or copy it to your Moodle server.<br />
# Unzip it in the right place for the plugin type (or follow add-on instructions). <br />
# In your Moodle site (as admin) go to ''Settings > Site administration > Notifications'' (you should, for most plugin types, get a message saying the add-on is installed).<br />
<br />
Note: The add-on may contain language files. They'll be found by your Moodle automatically. These language strings can be customized using the standard ''Settings > Site administration > Language'' editing interface. If you get a "Database error" when you try to edit your language files, there is a strong chance that the language files included within the downloaded ZIP file of this add-on have a coding problem. If you delete the ''plugin_name/lang/other_language_different_to_English/'' folder with the new language strings and the database error disappears, this is indeed the case. Please notify the plugin maintainer, so that it can be fixed in future releases.<br />
<br />
==Troubleshooting==<br />
<br />
===Errors===<br />
<br />
If you obtain an error, please [[Debugging|turn debugging on]] to obtain additional information about the cause of the error.<br />
<br />
;tool_installaddon/err_curl_exec - cURL error 60 : This suggests problems with the validation of the SSL certificate of the remote (moodle.org) site. This is also a known problem in Moodle Windows 7 servers running the Moodle package for Windows. See [[SSL certificate for moodle.org]] for more info and possible solutions.<br />
<br />
===When installing manually===<br />
<br />
* Check the file permissions. The web server needs to be able to read the plugin files. If the the rest of Moodle works then try to make the plugin permissions and ownership match. <br />
* Did you '''definitely''' unzip or install the add-on in the correct place?<br />
* Because Moodle scans plugin folders for new plugins you cannot have any other files or folders there. Make sure you deleted the zip file and don't try to rename (for example) an old version of the plugin to some other name - it will break.<br />
* Make sure the directory name for the plugin is correct. All the names '''have''' to match. If you change the name then it won't work.<br />
<br />
===Obtaining help===<br />
<br />
Ask in the appropriate forum in [http://moodle.org/course/view.php?id=5 Using Moodle]. Make sure you describe your system (including versions of MySQL, PHP etc.), what you tried and what happened. Copy and paste error messages exactly. Provide the link to the version of the add-on you downloaded (some have very similar names).<br />
<br />
==Uninstalling an add-on==<br />
<br />
To uninstall an add-on<br />
# Go to ''Administration> Site Administration > Plugins > Plugins overview'' and click the Uninstall link opposite the add-on you wish to remove<br />
# Use a file manager to remove/delete the actual plugin directory as instructed, otherwise Moodle will reinstall it next time you access the site administration<br />
<br />
Note: Certain plugin types offer the removal from the disk as well, though not yet all.<br />
<br />
==Plugins overview==<br />
<br />
[[File:plugins overview.png|thumb|left|Plugins overview highlighting available update with install button]]The Plugins overview page in ''Administration > Site Administration > Plugins > Plugins overview'' lists all installed plugins, together with the version number, availability (enabled or disabled) and settings link (if applicable).<br />
<br />
A 'Check for available updates' button enables admins to quickly check for any updates available to standard plugins or add-ons installed on the site (from the [http://moodle.org/plugins plugins directory]). Any updates available are highlighted, with further information and a download link in the notes column opposite the plugin.<br />
<br />
===Plugin updating from within Moodle===<br />
<br />
In Moodle 2.4 onwards, an administrator can enable updates deployment in ''Administration > Site Administration > Server > Update notifications''. Then when updates are available, 'Install this update' buttons are shown on the Plugins overview page. See [[Automatic updates deployment]] for more details.<br />
<br />
==Preventing installing add-ons from within Moodle==<br />
<br />
If required, installing and updating from within Moodle can be prevented by copying the following lines of code from config-dist.php and pasting them in config.php.<br />
<br />
// Use the following flag to completely disable the On-click add-on installation<br />
// feature and hide it from the server administration UI.<br />
//<br />
// $CFG->disableonclickaddoninstall = true;<br />
<br />
==See also==<br />
<br />
* [[Notifications]] for further details of update notifications<br />
* [[Add-on Review Criteria]]<br />
* [[Add-on FAQ]]<br />
* Using Moodle [http://moodle.org/mod/forum/view.php?id=44 General add-ons forum]<br />
* [[Installing Moodle from Git repository#Installing a contributed extension from its Git repository|Installing a contributed extension from its Git repository]]<br />
* [http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/ Managing add-ons in Moodle 2.5] blog post by Gavin Henrick<br />
<br />
For developers:<br />
<br />
*[[:dev:Category:Plugins|Plugins developer documentation]]<br />
*[[:dev:Plugin validation]]<br />
*[[:dev:On-click add-on installation]]<br />
<br />
[[Category:Contributed code]]<br />
<br />
[[de:Plugins installieren]]<br />
[[es:Instalando plugins]]</div>Yuchenghuhttps://docs.moodle.org/37/en/index.php?title=Installing_plugins&diff=106442Installing plugins2013-08-24T15:58:13Z<p>Yuchenghu: /* Installing directly from the Moodle plugins directory */</p>
<hr />
<div>{{Installing Moodle}}<br />
An add-on is an optional plugin for adding additional features and functionality to Moodle, such as new activities, new quiz question types, new reports, integrations with other systems and many more. <br />
<br />
==What is meant by the words 'plugin' and 'add-on'?==<br />
<br />
Moodle = core code + plugins<br />
<br />
Plugins may be either standard plugins (included in the Moodle download package) or add-ons.<br />
<br />
== Considerations for production sites (skip if you're just moodling) ==<br />
<br />
'''VERY IMPORTANT''' Warning: Please be aware that some add-ons have not been reviewed, and the quality and/or suitability for your Moodle site has not been checked. Please be careful. It may not do what you expect, it may have serious security issues or it may even not work at all. This is however improving over time with the evolving new plugins directory system.<br />
<br />
* If you have a large site for production purposes consider if you '''really''' need the add-on? More functionality means more things to support, more things to (potentially) go wrong and more things to worry about at upgrade time. <br />
* Is the add-on supported and maintained? If something goes wrong can you get support? Will bugs be fixed?<br />
* If the add-on does not work in a future version of Moodle, what will you do about it?<br />
* Beware of ''patches'' ([https://moodle.org/plugins/browse.php?list=category&id=38 Moodle Plugins Directory Other category]) ! If an add-on modifies or replaces core files then be very careful. It can only be guaranteed to work with the exact build (version) of Moodle it was created for and is highly unlikely to survive a Moodle upgrade.<br />
<br />
==Installing an add-on==<br />
<br />
To install an add-on, its source code must be put (deployed) into the appropriate location inside the Moodle installation directory and the main administration page ''Administration > Site administration > Notifications'' must be visited. There are three ways how the add-on code can be deployed into Moodle.<br />
<br />
{{New features}}In Moodle 2.5 onwards, an add-on code may be deployed from within Moodle, either directly from the Moodle plugins directory or by uploading a ZIP file. The web server process has to have write access to the plugin type folder where the new add-on is to be installed in order to use either of these methods.<br />
<br />
Alternatively, an add-on code may be deployed manually at the server.<br />
<br />
===从 Moodle 的插件目录中直接进行安装===<br />
<br />
请注意,这种安装方式需要到 Moodle 官方网站上进行插件查找,你可能需要要求注册用户才可以进行访问。<br />
<br />
# 用管理员登录后,进入目录''首页 > 网站管理 > 插件 > 安装扩展'' (对应的英文路径为:''Administration > Site administration > Plugins > Install add-ons'')<br />
# 单击按钮 '从 Moodle 扩展目录来安装扩展'。<br />
# 使用安装按钮来查找一个扩展(例如:2.5 稳定版),然后单击安装按钮继续。<br />
# 请确定你是否获得提示信息 '校验已通过!',然后单击按钮 '安装扩展'。<br />
<br />
查找和安装的详细办法请参考 OSSEZ 提供的技术指导:[http://www.ossez.com/thread-26431-1-1.html 从 Moodle 的插件目录中直接进行安装]<br />
<br />
===Installing via uploaded ZIP file===<br />
<br />
# Go to the [https://moodle.org/plugins Moodle plugins directory], select Moodle 2.5 as version, then choose an add-on with a Download button and download the ZIP file.<br />
# Login to your Moodle site as an admin and go to ''Administration > Site administration > Plugins > Install add-ons''.<br />
# Upload the ZIP file, select the appropriate plugin type, tick the acknowledgement checkbox, then click the button 'Install add-on from the ZIP file'.<br />
# Check that you obtain a 'Validation passed!' message, then click the button 'Install add-on'.<br />
<br />
{|<br />
| [[File:install add-ons.png|thumb|Install add-ons]]<br />
| [[File:add-on package validation.png|thumb|Add-on package validation]]<br />
|}<br />
<br />
For both of the above methods, after clicking the button 'Install add-on', you will then be automatically redirected to ''Settings > Site administration > Notifications'' and the installation process (i.e. creating required database tables etc) will happen.<br />
<br />
===Installing manually at the server===<br />
<br />
If you can't deploy the add-on code via the administration web interface, you have to copy it to the server file system manually (e.g. if the web server process does not have write access to the Moodle installation tree to do this for you).<br />
<br />
First, establish the correct place in the Moodle code tree for the add-on type. Common locations are:<br />
<br />
* /path/to/moodle/theme/ - themes<br />
* /path/to/moodle/mod/ - activity modules and resources<br />
* /path/to/moodle/blocks/ - sidebar blocks<br />
* /path/to/moodle/question/type/ - question types<br />
* /path/to/moodle/course/format/ - course formats<br />
* /path/to/moodle/admin/report/ - admin reports<br />
<br />
See [[:dev:Plugins]] for the full list of all plugin types and their locations within the Moodle tree.<br />
<br />
# Go to the [https://moodle.org/plugins Moodle plugins directory], select Moodle 2.5 as version, then choose an add-on with a Download button and download the ZIP file.<br />
# Upload or copy it to your Moodle server.<br />
# Unzip it in the right place for the plugin type (or follow add-on instructions). <br />
# In your Moodle site (as admin) go to ''Settings > Site administration > Notifications'' (you should, for most plugin types, get a message saying the add-on is installed).<br />
<br />
Note: The add-on may contain language files. They'll be found by your Moodle automatically. These language strings can be customized using the standard ''Settings > Site administration > Language'' editing interface. If you get a "Database error" when you try to edit your language files, there is a strong chance that the language files included within the downloaded ZIP file of this add-on have a coding problem. If you delete the ''plugin_name/lang/other_language_different_to_English/'' folder with the new language strings and the database error disappears, this is indeed the case. Please notify the plugin maintainer, so that it can be fixed in future releases.<br />
<br />
==Troubleshooting==<br />
<br />
===Errors===<br />
<br />
If you obtain an error, please [[Debugging|turn debugging on]] to obtain additional information about the cause of the error.<br />
<br />
;tool_installaddon/err_curl_exec - cURL error 60 : This suggests problems with the validation of the SSL certificate of the remote (moodle.org) site. This is also a known problem in Moodle Windows 7 servers running the Moodle package for Windows. See [[SSL certificate for moodle.org]] for more info and possible solutions.<br />
<br />
===When installing manually===<br />
<br />
* Check the file permissions. The web server needs to be able to read the plugin files. If the the rest of Moodle works then try to make the plugin permissions and ownership match. <br />
* Did you '''definitely''' unzip or install the add-on in the correct place?<br />
* Because Moodle scans plugin folders for new plugins you cannot have any other files or folders there. Make sure you deleted the zip file and don't try to rename (for example) an old version of the plugin to some other name - it will break.<br />
* Make sure the directory name for the plugin is correct. All the names '''have''' to match. If you change the name then it won't work.<br />
<br />
===Obtaining help===<br />
<br />
Ask in the appropriate forum in [http://moodle.org/course/view.php?id=5 Using Moodle]. Make sure you describe your system (including versions of MySQL, PHP etc.), what you tried and what happened. Copy and paste error messages exactly. Provide the link to the version of the add-on you downloaded (some have very similar names).<br />
<br />
==Uninstalling an add-on==<br />
<br />
To uninstall an add-on<br />
# Go to ''Administration> Site Administration > Plugins > Plugins overview'' and click the Uninstall link opposite the add-on you wish to remove<br />
# Use a file manager to remove/delete the actual plugin directory as instructed, otherwise Moodle will reinstall it next time you access the site administration<br />
<br />
Note: Certain plugin types offer the removal from the disk as well, though not yet all.<br />
<br />
==Plugins overview==<br />
<br />
[[File:plugins overview.png|thumb|left|Plugins overview highlighting available update with install button]]The Plugins overview page in ''Administration > Site Administration > Plugins > Plugins overview'' lists all installed plugins, together with the version number, availability (enabled or disabled) and settings link (if applicable).<br />
<br />
A 'Check for available updates' button enables admins to quickly check for any updates available to standard plugins or add-ons installed on the site (from the [http://moodle.org/plugins plugins directory]). Any updates available are highlighted, with further information and a download link in the notes column opposite the plugin.<br />
<br />
===Plugin updating from within Moodle===<br />
<br />
In Moodle 2.4 onwards, an administrator can enable updates deployment in ''Administration > Site Administration > Server > Update notifications''. Then when updates are available, 'Install this update' buttons are shown on the Plugins overview page. See [[Automatic updates deployment]] for more details.<br />
<br />
==Preventing installing add-ons from within Moodle==<br />
<br />
If required, installing and updating from within Moodle can be prevented by copying the following lines of code from config-dist.php and pasting them in config.php.<br />
<br />
// Use the following flag to completely disable the On-click add-on installation<br />
// feature and hide it from the server administration UI.<br />
//<br />
// $CFG->disableonclickaddoninstall = true;<br />
<br />
==See also==<br />
<br />
* [[Notifications]] for further details of update notifications<br />
* [[Add-on Review Criteria]]<br />
* [[Add-on FAQ]]<br />
* Using Moodle [http://moodle.org/mod/forum/view.php?id=44 General add-ons forum]<br />
* [[Installing Moodle from Git repository#Installing a contributed extension from its Git repository|Installing a contributed extension from its Git repository]]<br />
* [http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/ Managing add-ons in Moodle 2.5] blog post by Gavin Henrick<br />
<br />
For developers:<br />
<br />
*[[:dev:Category:Plugins|Plugins developer documentation]]<br />
*[[:dev:Plugin validation]]<br />
*[[:dev:On-click add-on installation]]<br />
<br />
[[Category:Contributed code]]<br />
<br />
[[de:Plugins installieren]]<br />
[[es:Instalando plugins]]</div>Yuchenghuhttps://docs.moodle.org/37/en/index.php?title=MoodleDocs:Guidelines_for_contributors&diff=106155MoodleDocs:Guidelines for contributors2013-07-24T00:36:40Z<p>Yuchenghu: </p>
<hr />
<div>{{Help}}You are welcome to contribute to Moodle Docs. Find something that can be improved, either in content, grammar or formatting, and fix it! Note: You will need to [[Special:Userlogin|login]] to edit pages.<br />
<br />
==Introduction==<br />
<br />
* Please note that all contributions are released here under [[License|GNU General Public License]].<br />
* Every page in Moodle has a link to a corresponding page in Moodle Docs. You can see this on [http://moodle.org moodle.org] and, from an administrator's perspective, on the [http://demo.moodle.net/ Moodle demo site].<br />
* You are encouraged to illustrate documentation with screenshots. Please refer to the [[MoodleDocs:Style guide|style guide]] for further information.<br />
* See [[MoodleDocs:Templates]] for ways of asking for editing help from other contributors.<br />
<br />
==Creating new pages==<br />
<br />
* You are welcome to create pages for additional documentation about Moodle. Simply type the name of your new page between double brackets <code><nowiki>[[New page name]]</nowiki></code> on an existing page and follow the link to start editing the new page. Alternatively, you may type in your browser address bar: <code><nowiki>https://docs.moodle.org/en/New_page_name</nowiki></code> (i.e. replace spaces in the new page name with underscores).<br />
* Please choose a short name and capitalize the first word only (with a few exceptions, such as the word ''Moodle'').<br />
* Please follow the [[MoodleDocs:Style guide|style guide]]. If you categorize new pages it can make it easier for users to find, but the important thing is to put good content into the page. <br />
* Page titles may be changed in the future by redirecting/moving pages, as part of documentation restructuring.<br />
<br />
==Inter-language linking==<br />
<br />
* Inter-language links between pages in different languages may be added by typing, for example, <code><nowiki>[[es:Corresponding page title in Spanish]]</nowiki></code> in the English MoodleDocs, or <code><nowiki>[[en:Corresponding page title in English]]</nowiki></code> in the [[:es:Portada|Spanish MoodleDocs]], at the bottom of the page, below the category link. Inter-language links will appear automatically in the "In other languages" block.<br />
<br />
== Page comments ==<br />
<br />
* For comments about a particular page, and/or short discussions, please use the corresponding talk page (click on the page comments tab). Please sign and date your talk page contribution by typing four tildes <nowiki>~~~~</nowiki>. There's also a handy button for signing in the toolbar of the editing field: [[Image:Signature Icon.png]]<br />
<br />
* For longer discussions about the documentation, please post on moodle.org in the [http://moodle.org/mod/forum/view.php?id=7135 Moodle community sites forum].<br />
<br />
* If you find an unsigned comment you can use the Template:Unsigned like so <nowiki>{{Unsigned|Username}}</nowiki> which will show as <small>(''The preceding comment was added by'' [[User:Username]])</small><br />
<br />
==Page protection==<br />
<br />
* Certain pages, such as the [[Table of Contents]], are protected from editing. Please use the page comments for suggesting additional content or other changes. <br />
<br />
==See also==<br />
<br />
*[[Moodle documentation FAQ]]<br />
*[http://moodle.org/mod/forum/view.php?id=7135 Moodle community sites forum].<br />
<br />
[[Category:MoodleDocs|Guidelines for contributors]]<br />
<br />
[[de:Hinweise für Moodle Docs Autoren]]<br />
[[es:MoodleDocs:Normas para colaboradores]]<br />
[[fr:MoodleDocs:Recommandations pour contributeurs]]<br />
[[ja:MoodleDocs:寄稿のガイドライン]]<br />
[[zh:MoodleDocs:魔灯贡献指南]]</div>Yuchenghuhttps://docs.moodle.org/37/en/index.php?title=MoodleDocs:Guidelines_for_contributors&diff=106154MoodleDocs:Guidelines for contributors2013-07-24T00:35:57Z<p>Yuchenghu: </p>
<hr />
<div>{{Help}}You are welcome to contribute to Moodle Docs. Find something that can be improved, either in content, grammar or formatting, and fix it! Note: You will need to [[Special:Userlogin|login]] to edit pages.<br />
<br />
==Introduction==<br />
<br />
* Please note that all contributions are released here under [[License|GNU General Public License]].<br />
* Every page in Moodle has a link to a corresponding page in Moodle Docs. You can see this on [http://moodle.org moodle.org] and, from an administrator's perspective, on the [http://demo.moodle.net/ Moodle demo site].<br />
* You are encouraged to illustrate documentation with screenshots. Please refer to the [[MoodleDocs:Style guide|style guide]] for further information.<br />
* See [[MoodleDocs:Templates]] for ways of asking for editing help from other contributors.<br />
<br />
==Creating new pages==<br />
<br />
* You are welcome to create pages for additional documentation about Moodle. Simply type the name of your new page between double brackets <code><nowiki>[[New page name]]</nowiki></code> on an existing page and follow the link to start editing the new page. Alternatively, you may type in your browser address bar: <code><nowiki>https://docs.moodle.org/en/New_page_name</nowiki></code> (i.e. replace spaces in the new page name with underscores).<br />
* Please choose a short name and capitalize the first word only (with a few exceptions, such as the word ''Moodle'').<br />
* Please follow the [[MoodleDocs:Style guide|style guide]]. If you categorize new pages it can make it easier for users to find, but the important thing is to put good content into the page. <br />
* Page titles may be changed in the future by redirecting/moving pages, as part of documentation restructuring.<br />
<br />
==Inter-language linking==<br />
<br />
* Inter-language links between pages in different languages may be added by typing, for example, <code><nowiki>[[es:Corresponding page title in Spanish]]</nowiki></code> in the English MoodleDocs, or <code><nowiki>[[en:Corresponding page title in English]]</nowiki></code> in the [[:es:Portada|Spanish MoodleDocs]], at the bottom of the page, below the category link. Inter-language links will appear automatically in the "In other languages" block.<br />
<br />
== Page comments ==<br />
<br />
* For comments about a particular page, and/or short discussions, please use the corresponding talk page (click on the page comments tab). Please sign and date your talk page contribution by typing four tildes <nowiki>~~~~</nowiki>. There's also a handy button for signing in the toolbar of the editing field: [[Image:Signature Icon.png]]<br />
<br />
* For longer discussions about the documentation, please post on moodle.org in the [http://moodle.org/mod/forum/view.php?id=7135 Moodle community sites forum].<br />
<br />
* If you find an unsigned comment you can use the Template:Unsigned like so <nowiki>{{Unsigned|Username}}</nowiki> which will show as <small>(''The preceding comment was added by'' [[User:Username]])</small><br />
<br />
==Page protection==<br />
<br />
* Certain pages, such as the [[Table of Contents]], are protected from editing. Please use the page comments for suggesting additional content or other changes. <br />
<br />
==See also==<br />
<br />
*[[Moodle documentation FAQ]]<br />
*[http://moodle.org/mod/forum/view.php?id=7135 Moodle community sites forum].<br />
<br />
[[Category:MoodleDocs|Guidelines for contributors]]<br />
<br />
[[de:Hinweise für Moodle Docs Autoren]]<br />
[[es:MoodleDocs:Normas para colaboradores]]<br />
[[fr:MoodleDocs:Recommandations pour contributeurs]]<br />
[[ja:MoodleDocs:寄稿のガイドライン]]<br />
[[zh_cn:MoodleDocs:魔灯贡献指南]]</div>Yuchenghuhttps://docs.moodle.org/37/en/index.php?title=Upgrading_FAQ&diff=105987Upgrading FAQ2013-07-13T20:28:50Z<p>Yuchenghu: </p>
<hr />
<div>{{Installing Moodle}}<br />
==How do I upgrade from 1.9 to 2.5?==<br />
<br />
1.9.x -> 1.9.latest -> 2.2.latest -> 2.5 <br />
<br />
(It is better to upgrade to latest current stable before going to next branch, the same for add-on plugins; upgrading from early stable branches usually works but there is no guarantee.)<br />
<br />
==How do I upgrade Moodle? Do I just overwrite the files?==<br />
<br />
Do NOT overwrite files, as it may cause strange errors. Read the [[Upgrading]] documentation before proceeding.<br />
<br />
==I obtain the message "Upgrade already running in this session, please wait!"==<br />
<br />
Most likely you refreshed the page before the completion message. If you are absolutely sure that there are no upgrade processes active (php and/or mysql), you can click on "!!!" and restart the upgrade.<br />
<br />
:''Note'': If you click on "'!!!" or try to restart the upgrade from another browser, there is a chance that your data in the database could be corrupted. If this happens, you will need to restore the database from sql dump and then restart the upgrade and wait - the process can take several hours on large sites.<br />
<br />
==Can I upgrade more than one version at a time?==<br />
<br />
You can only upgrade to Moodle 2.5 from Moodle 2.2.<br />
<br />
You can only upgrade to Moodle 2.2 from Moodle 1.9 or later.<br />
<br />
For information on upgrading from versions of Moodle prior to 1.9, see the section 'Upgrading more than one version' in the Moodle 2.2 documentation [https://docs.moodle.org/22/en/Upgrading Upgrading].<br />
<br />
==See also==<br />
<br />
* Using Moodle [https://moodle.org/mod/forum/discuss.php?d=224561 Notes on upgrading Moodle from 1.9.x to 2.4.1 on a shared server] forum discussion<br />
<br />
[[Category:FAQ]]<br />
<br />
[[ja:アップグレードFAQ]]<br />
[[zh:Moodle 升级常见问题]]</div>Yuchenghuhttps://docs.moodle.org/37/en/index.php?title=Flickr_public_repository&diff=105986Flickr public repository2013-07-13T16:00:54Z<p>Yuchenghu: </p>
<hr />
<div>{{Repositories}}<br />
The Flickr public repository enables a user to search Flickr and copy files from there into any of the Moodle file interfaces.<br />
<br />
==Flickr public repository setup==<br />
<br />
Location: ''Settings > Site administration > Modules > Repositories > Manage repositories''<br />
<br />
This page lets a site administrator configure access to a Flickr Public repository.<br />
<br />
To set this repository up you need to set the following field:<br />
*API Key<br />
<br />
===Setting up a Flickr API===<br />
To get your API Key you need to create an App inside your Flickr account. Visit [http://www.flickr.com/services/api/keys/ this link] to start creating your own API Key.<br />
#Click the "Get Another Key" button to start creating your App. <br />
<br />
[[Image:get-another-key.png]]<br />
<br />
#Choose "Apply for a Non-commercial Key"<br />
#Enter a title and brief description for the App (i.e. Moodle to Flickr Access - App to allow Moodle to access Flickr through it's repository API)<br />
#Tick the two boxes to show your agreement to Flickr's terms of use and then click submit.<br />
#You will now have the key for the new app. Copy and paste this into the field in your Moodle Flickr public configuration page.<br />
#Click save on the Moodle Flickr public configuration page.<br />
#Click "Save Changes"<br />
<br />
You should now have a working Flickr public repository. From the [[File picker]], click Flickr public and enter your required search term. Images will appear for you to select from:<br />
{|<br />
| [[File:flickrsearch23.png|thumb|Searching Flickr public]]<br />
| [[File:flickrpublic23.png|thumb|The search results]]<br />
|}<br />
<br />
==Repository capabilities==<br />
<br />
There is just one capability, [[Capabilities/repository/flickr public:view|Use Flickr public repository in file picker]], which is allowed for the default authenticated user role. <br />
<br />
==See also==<br />
<br />
*[[Flickr repository]]<br />
<br />
[[Category:Site administration]]<br />
<br />
[[eu:Flickr_publikoaren_ezarpenak]]<br />
[[de:Flickr Public Repository]]<br />
[[zh:Moodle 使用 Flickr 公共网络相册资源库]]</div>Yuchenghuhttps://docs.moodle.org/37/en/index.php?title=URL_resource&diff=105978URL resource2013-07-11T20:43:41Z<p>Yuchenghu: </p>
<hr />
<div>{{Resources}}<br />
<br />
A URL (''Uniform or Universal Resource Locator'') is a link on the internet to a website or online file. Teachers can use the URL resource to provide their students with web links for research, saving the student time and effort in manually typing out the address. The URLS can be displayed in various ways - see the [[URL resource settings]] for example, opening in a new window so a student can access and use the URL, close it and return easily to their original Moodle course page.<br />
<br />
[[File:URLexample.png]]<br />
<br />
See:<br />
*[[URL resource settings]]<br />
*[[URL resource FAQ]]<br />
<br />
[[de:Link/URL]]<br />
[[fr:URL]]<br />
[[zh:Moodle URL]]</div>Yuchenghuhttps://docs.moodle.org/37/en/index.php?title=Resources&diff=105976Resources2013-07-11T20:36:28Z<p>Yuchenghu: </p>
<hr />
<div>{{Managing a Moodle course}}<br />
A resource is an item that a teacher can use to support learning, such as a file or link. Moodle supports a range of resource types which teachers can add to their courses. In edit mode, a teacher can add resources via a drop down menu. Resources appear as a single link with an icon in front of it that represents the type of resource. <br />
<br />
*[[Book module|Book]] - Multi-page resources with a book-like format. '' Teachers can export their Books as IMS CP'' (admin must allow teacher role to export IMS)<br />
*[[File resource|File]] - A picture, a pdf document, a spreadsheet, a sound file, a video file<br />
*[[Folder]] - For helping organize files and one folder may contain other folders<br />
*[[IMS content package]] - Add static material from other sources in the standard IMS content package format<br />
*[[Label]] - Can be a few displayed words or an image used to separate resources and activities in a topic section, or can be a lengthy description or instructions<br />
*[[Page]] - The student sees a single, scrollable screen that a teacher creates with the robust HTML editor<br />
*[[URL resource|URL]] - You can send the student to any place they can reach on their web browser, for example Wikipedia<br />
<br />
==See also==<br />
<br />
*[[Resources FAQ]]<br />
<br />
[[Category:Resource]]<br />
<br />
[[es:Recursos]]<br />
[[eu:Baliabideak]]<br />
[[fr:Ressources]]<br />
[[de:Arbeitsmaterialien]]<br />
[[zh:Moodle 课程资源]]</div>Yuchenghuhttps://docs.moodle.org/37/en/index.php?title=MoodleDocs:Guidelines_for_contributors&diff=105951MoodleDocs:Guidelines for contributors2013-07-08T02:33:16Z<p>Yuchenghu: </p>
<hr />
<div>{{Help}}You are welcome to contribute to Moodle Docs. Find something that can be improved, either in content, grammar or formatting, and fix it! Note: You will need to [[Special:Userlogin|login]] to edit pages.<br />
<br />
==Introduction==<br />
<br />
* Please note that all contributions are released here under [[License|GNU General Public License]].<br />
* Every page in Moodle has a link to a corresponding page in Moodle Docs. You can see this on [http://moodle.org moodle.org] and, from an administrator's perspective, on the [http://demo.moodle.net/ Moodle demo site].<br />
* You are encouraged to illustrate documentation with screenshots. Please refer to the [[MoodleDocs:Style guide|style guide]] for further information.<br />
* See [[MoodleDocs:Templates]] for ways of asking for editing help from other contributors.<br />
<br />
==Creating new pages==<br />
<br />
* You are welcome to create pages for additional documentation about Moodle. Simply type the name of your new page between double brackets <code><nowiki>[[New page name]]</nowiki></code> on an existing page and follow the link to start editing the new page. Alternatively, you may type in your browser address bar: <code><nowiki>https://docs.moodle.org/en/New_page_name</nowiki></code> (i.e. replace spaces in the new page name with underscores).<br />
* Please choose a short name and capitalize the first word only (with a few exceptions, such as the word ''Moodle'').<br />
* Please follow the [[MoodleDocs:Style guide|style guide]]. If you categorize new pages it can make it easier for users to find, but the important thing is to put good content into the page. <br />
* Page titles may be changed in the future by redirecting/moving pages, as part of documentation restructuring.<br />
<br />
==Inter-language linking==<br />
<br />
* Inter-language links between pages in different languages may be added by typing, for example, <code><nowiki>[[es:Corresponding page title in Spanish]]</nowiki></code> in the English MoodleDocs, or <code><nowiki>[[en:Corresponding page title in English]]</nowiki></code> in the [[:es:Portada|Spanish MoodleDocs]], at the bottom of the page, below the category link. Inter-language links will appear automatically in the "In other languages" block.<br />
<br />
== Page comments ==<br />
<br />
* For comments about a particular page, and/or short discussions, please use the corresponding talk page (click on the page comments tab). Please sign and date your talk page contribution by typing four tildes <nowiki>~~~~</nowiki>. There's also a handy button for signing in the toolbar of the editing field: [[Image:Signature Icon.png]]<br />
<br />
* For longer discussions about the documentation, please post on moodle.org in the [http://moodle.org/mod/forum/view.php?id=7135 Moodle community sites forum].<br />
<br />
* If you find an unsigned comment you can use the Template:Unsigned like so <nowiki>{{Unsigned|Username}}</nowiki> which will show as <small>(''The preceding comment was added by'' [[User:Username]])</small><br />
<br />
==Page protection==<br />
<br />
* Certain pages, such as the [[Table of Contents]], are protected from editing. Please use the page comments for suggesting additional content or other changes. <br />
<br />
==See also==<br />
<br />
*[[Moodle documentation FAQ]]<br />
*[http://moodle.org/mod/forum/view.php?id=7135 Moodle community sites forum].<br />
<br />
[[Category:MoodleDocs|Guidelines for contributors]]<br />
<br />
[[de:Hinweise für Moodle Docs Autoren]]<br />
[[es:MoodleDocs:Normas para colaboradores]]<br />
[[fr:MoodleDocs:Recommandations pour contributeurs]]<br />
[[ja:MoodleDocs:寄稿のガイドライン]]<br />
[[zh:如何向Moodle维基投稿]]</div>Yuchenghuhttps://docs.moodle.org/37/en/index.php?title=Managing_accounts&diff=105950Managing accounts2013-07-08T02:30:39Z<p>Yuchenghu: </p>
<hr />
<div>{{Managing a Moodle site}}<br />
<br />
An administrator can perform various tasks relating to user accounts in ''Administration > Site administration > Users > Accounts''. The links below provide more information:<br />
<br />
* [[Browse list of users]] - how to search for, find and edit user accounts<br />
* [[Bulk user actions]] - how to message, confirm, download or perform other actions on a large group of users globally<br />
* [[Add a new user]] - how to create one individual user account<br />
* [[Upload users]] - how to bulk create new user accounts<br />
* [[User pictures]] - how to bulk upload profile pictures for users<br />
* [[User profile fields]] - how to create customised profile fields<br />
<br />
==See also==<br />
<br />
*[[Accounts FAQ]]<br />
<br />
[[Category:Accounts]]<br />
<br />
[[de:Nutzerverwaltung]]<br />
[[zh:管理账户]]</div>Yuchenghuhttps://docs.moodle.org/37/en/index.php?title=Managing_accounts&diff=105949Managing accounts2013-07-08T02:29:04Z<p>Yuchenghu: </p>
<hr />
<div>{{Managing a Moodle site}}<br />
<br />
An administrator can perform various tasks relating to user accounts in ''Administration > Site administration > Users > Accounts''. The links below provide more information:<br />
<br />
* [[Browse list of users]] - how to search for, find and edit user accounts<br />
* [[Bulk user actions]] - how to message, confirm, download or perform other actions on a large group of users globally<br />
* [[Add a new user]] - how to create one individual user account<br />
* [[Upload users]] - how to bulk create new user accounts<br />
* [[User pictures]] - how to bulk upload profile pictures for users<br />
* [[User profile fields]] - how to create customised profile fields<br />
<br />
==See also==<br />
<br />
*[[Accounts FAQ]]<br />
<br />
[[Category:Accounts]]<br />
<br />
[[de:Nutzerverwaltung]]<br />
[[zh:Nutzerverwaltung]]</div>Yuchenghuhttps://docs.moodle.org/37/en/index.php?title=Managing_accounts&diff=105948Managing accounts2013-07-08T02:19:58Z<p>Yuchenghu: </p>
<hr />
<div>{{Managing a Moodle site}}<br />
<br />
An administrator can perform various tasks relating to user accounts in ''Administration > Site administration > Users > Accounts''. The links below provide more information:<br />
<br />
* [[Browse list of users]] - how to search for, find and edit user accounts<br />
* [[Bulk user actions]] - how to message, confirm, download or perform other actions on a large group of users globally<br />
* [[Add a new user]] - how to create one individual user account<br />
* [[Upload users]] - how to bulk create new user accounts<br />
* [[User pictures]] - how to bulk upload profile pictures for users<br />
* [[User profile fields]] - how to create customised profile fields<br />
<br />
==See also==<br />
<br />
*[[Accounts FAQ]]<br />
<br />
[[Category:Accounts]]<br />
<br />
[[de:Nutzerverwaltung]]<br />
[[zh:管理账户]]</div>Yuchenghu