MoodleDocs - User contributions [en]

Moodle research

2011-06-28T07:11:09Z

Lasko:

{{Moodle in education}}

A growing, community-contributed collection of research into LMS (Learning Management Systems) and particularly Moodle.

=Moodle-specific research=
Academic, governmental, organisational research (mostly) involving Moodle (design, use, implementation...). Check [[Moodle research FAQ|here]] for details.
==Print (papers, reports, collections, theses...)==
*Al-Ajlan, A. & Zedan,H. (2008) [http://www.computer.org/portal/web/csdl/doi/10.1109/FTDCS.2008.22 Why Moodle] 12th IEEE International Workshop on Future Trends of Distributed Computing Systems, 2008
*Alier, M., Casany, J., Casado, P. (2007) [http://74.125.155.132/scholar?q=cache:9f3NRhHqyDMJ:scholar.google.com/+moodle&hl=en&as_sdt=0,5 Mobile Extension Of A Web Based Moodle Virtual Classroom]. Proceedings of E-Challenges Conference, 2007.
*Al Naddabi, Z. (2007). [http://www.editlib.org/p/26540 A Moodle Course: Design and Implementation in English for Academic Purposes Instruction]. In T. Bastiaens & S. Carliner (Eds.), Proceedings of World Conference on E-Learning in Corporate, Government, Healthcare, and Higher Education 2007
*Beatty, B. & Ulasewicz, C. (2006) [http://www.springerlink.com/content/bg0613214k409500/ Faculty Perspectives on Moving from Blackboard to the Moodle Learning Management System]. TechTrends Volume 50, Number 4, 36-45.
*Berggren, A. et al (2005) [http://74.125.155.132/scholar?q=cache:2t2PDSl4o_4J:scholar.google.com/+moodle&hl=en&as_sdt=0,5 Practical and Pedagogical Issues for Teacher Adoption of IMS Learning Design Standards in Moodle LMS]. Journal of Interactive Media in Education, 2005(02)
*Brandl, K. (2007) [http://74.125.155.132/scholar?q=cache:b1gGpxaaCR0J:scholar.google.com/+moodle&hl=en&as_sdt=0,5 Are You Ready to "Moodle"?]. Language Learning & Technology, May 2005, Vol.9(2)
*Burgos, D. et al. (2007) [http://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.169.251&rep=rep1&type=pdf A First Step Mapping IMS Learning Design and Moodle]. Journal of Universal Computer Science, Vol. 13 (7).
*Cowan, P. (2006). [http://www.editlib.org/p/22507 Factors influencing Pre-Service teachers’ attitudes towards using a Moodle environment for teaching and learning]. In C. Crawford et al. (Eds.), Proceedings of Society for Information Technology & Teacher Education International Conference 2006
*Deng, Y. & Hemphill, L. (2006). [http://www.editlib.org/p/22054 Demonstrating Online K12 Teaching Strategies in a Moodle Course Management Environment]. In C. Crawford et al. (Eds.), Proceedings of Society for Information Technology & Teacher Education International Conference 2006
*DeSchryver, M., Mishra, P., Koehleer, M. & Francis, A. (2009). [http://www.editlib.org/?fuseaction=Reader.ViewFullText&paper_id=30612 Moodle vs. Facebook: Does using Facebook for Discussions in an Online Course Enhance Perceived Social Presence and Student Interaction?]. In I. Gibson et al. (Eds.), Proceedings of Society for Information Technology & Teacher Education International Conference 2009
*Dougiamas, M. & Taylor, P. (2003). [http://www.editlib.org/p/13739 Moodle: Using Learning Communities to Create an Open Source Course Management System]. In D. Lassner & C. McNaught (Eds.), Proceedings of World Conference on Educational Multimedia, Hypermedia and Telecommunications 2003.
*Graf, S. &List, B.(2005) [http://ieeexplore.ieee.org/xpl/freeabs_all.jsp?arnumber=1508637 An evaluation of open source e-learning platforms stressing adaptation issues]. Advanced Learning Technologies, 2005. ICALT 2005.
*Guttierez, E. et al. (2009) [http://www.sciencedirect.com/science?_ob=ArticleURL&_udi=B6VCJ-4XB1967-2&_user=10&_coverDate=02%2F28%2F2010&_rdoc=1&_fmt=high&_orig=gateway&_origin=gateway&_sort=d&_docanchor=&view=c&_searchStrId=1688004089&_rerunOrigin=scholar.google&_acct=C000050221&_version=1&_urlVersion=0&_userid=10&md5=f9a939ec272e44d724d630209831642a&searchtype=a A new Moodle module supporting automatic verification of VHDL-based assignments]. Computers & Education, Vol 54 (2), Feb 2010.
*Hueros, D. & Sanchez, A. (2010) [http://www.sciencedirect.com/science?_ob=ArticleURL&_udi=B6VDC-50HWJ4Y-4&_user=10&_coverDate=11%2F30%2F2010&_rdoc=1&_fmt=high&_orig=gateway&_origin=gateway&_sort=d&_docanchor=&view=c&_searchStrId=1687987167&_rerunOrigin=scholar.google&_acct=C000050221&_version=1&_urlVersion=0&_userid=10&md5=15927cf368be7fc0df80aa91ac4e92a3&searchtype=a Motivational factors that influence the acceptance of Moodle using Technology Acceptance Model (TAM)]. Computers in Human Behavior. Vol. 26(6) Nov 2010.
*Jide, W. & Li, Z. (2009) [http://en.cnki.com.cn/Article_en/CJFDTOTAL-YCJY200905004.htm New Progresses in the Domestic Research on Moodle] Journal of Distance Education.
*Knutzen, B. & Kennedy, D.M. (2008). [http://www.editlib.org/p/28913 Can Learning to Use Moodle Alter Teachers’ Approaches to Teaching?]. In J. Luca & E. Weippl (Eds.), Proceedings of World Conference on Educational Multimedia, Hypermedia and Telecommunications 2008
*Pfaffman, J. (2004). [http://www.editlib.org/p/13664 Integrating Moodle into a Course for Pre- and In-service Teachers]. In R. Ferdig et al. (Eds.), Proceedings of Society for Information Technology & Teacher Education International Conference 2004
*Kemp, J. Livingstone, D. (2008) [http://74.125.155.132/scholar?q=cache:Kvnq5aCMDSwJ:scholar.google.com/+moodle&hl=en&as_sdt=0,5 Integrating Web-Based and 3D Learning Environments: Second Life Meets Moodle]. UPGRADE Vol. IX, No. 3, June 2008
*Romero,C. et al (2009) [http://www.sciencedirect.com/science?_ob=ArticleURL&_udi=B6V03-4R98K46-7&_user=10&_coverDate=03%2F31%2F2009&_rdoc=1&_fmt=high&_orig=gateway&_origin=gateway&_sort=d&_docanchor=&view=c&_searchStrId=1687992777&_rerunOrigin=scholar.google&_acct=C000050221&_version=1&_urlVersion=0&_userid=10&md5=f15fe515105a3c120401c2a6c6d1551e&searchtype=a Evolutionary algorithms for subgroup discovery in e-learning: A practical application using Moodle data]. Expert Systems with Applications, Volume 36(2)1, March 2009.
*Romero, S. Ventura, C. & Garcia, E. (2007) [http://www.sciencedirect.com/science?_ob=ArticleURL&_udi=B6VCJ-4P7FCT6-1&_user=10&_coverDate=08%2F31%2F2008&_rdoc=1&_fmt=high&_orig=gateway&_origin=gateway&_sort=d&_docanchor=&view=c&_searchStrId=1686659096&_rerunOrigin=scholar.google&_acct=C000050221&_version=1&_urlVersion=0&_userid=10&md5=b77769e114cba19d78a12526b8755858&searchtype=a Data mining in course management systems: Moodle case study and tutorial]. Computers & Education. Vol. 51 (1), Aug 2008 (Abstract only, paid access).
*Li, P. et al. (2009) [http://en.cnki.com.cn/Article_en/CJFDTOTAL-YCJY200803014.htm Classroom Response Systems Based on Moodle]. Distance Education Journal;2008-03
*Martín-Blas, T. & Serrano-Fernández (2009) [http://www.sciencedirect.com/science?_ob=ArticleURL&_udi=B6VCJ-4T2RYPV-1&_user=10&_coverDate=01%2F31%2F2009&_rdoc=1&_fmt=high&_orig=gateway&_origin=gateway&_sort=d&_docanchor=&view=c&_searchStrId=1687986242&_rerunOrigin=scholar.google&_acct=C000050221&_version=1&_urlVersion=0&_userid=10&md5=81ca28b957fbd194f133ad342073759a&searchtype=a The role of new technologies in the learning process: Moodle as a teaching tool in Physics]. Computers & Education. Vol. 52(1), Jan 2009.
*Meurant, R.C. (2009) [http://www.springerlink.com/content/u08884qr83704276/ Computer-Based Internet-Hosted Assessment of L2 Literacy: Computerizing and Administering of the Oxford Quick Placement Test in ExamView and Moodle].Communications in Computer and Information Science, 2009, Vol. 60.
*Rakoczi, Gergely. (2010) [http://www.fm-kp.si/zalozba/ISBN/978-961-266-066-6/prispevki/rakoczi.pdf "Cast your Eyes on Moodle: An Eye Tracking Study investigating learning with Moodle"]
*Liu Suqin & Li Jiahou (2007) [http://en.cnki.com.cn/Article_en/CJFDTOTAL-YCJY200701002.htm Curriculum Design BIG6 Mode Based on Moodle]. Distance Education Journal.
*Stewart, B. et al (2007) [http://www.igi-global.com/bookstore/article.aspx?TitleId=1705 Choosing MOODLE: An Evaluation of Learning Management Systems at Athabasca University. International Journal of Distance Education Technologies (IJDET)]. Vol. 5(3)
*Zenha-Rela,M. & Carvalho, R.(2006) [http://ieeexplore.ieee.org/xpl/freeabs_all.jsp?arnumber=4117034 Work in Progress: Self Evaluation Through Monitored Peer Review Using the Moodle Platform]. Frontiers in Education Conference.
*Zhiqiang, M & Yanli, W. (2008) [http://en.cnki.com.cn/Article_en/CJFDTOTAL-DDJY200807013.htm An Analysis of Moodle-based Online Learning Barriers]. Distance Education in China, Aug 2008.

==Presentations and videos==
==Other material (eg projects)==

=LMS research - general=
Broader academic, governmental, organisational research on LMS/VLE useful to Moodle to learn from. Check [[Moodle research FAQ|here]] for details.
==Print (papers, reports, collections, theses...)==
*Carmean, C. & Haefner,J. (2002). [http://net.educause.edu/ir/library/pdf/ERM0261.pdf Mind over matter: Transforming course management systems into effective learning environments]. EDUCAUSE Review, Vol. 37, No. 6, pp. 27–33.
*Chang, Chinhong Lim (2008) [http://firstmonday.org/htbin/cgiwrap/bin/ojs/index.php/fm/article/view/2530/2303 Faculty Perceptions and Utilization of a Learning Management System in Higher Education] (dissertation)
*Keesee, G. & Shepard, M.(2011) [http://www.westga.edu/~distance/ojdla/spring141/keesee_shepard141.html Perceived Attributes Predict Course Management System Adopter Status]. Online Journal of Distance Learning Administration, Vol 14/1.
*Lane, L. (2009) [http://firstmonday.org/htbin/cgiwrap/bin/ojs/index.php/fm/article/view/2530/2303 Insidious pedagogy: How course management systems impact teaching]. First Monday, Vol. 14, Number 10 - 5 Oct 2009
*[http://en.wikipedia.org/wiki/Ofsted OFSTED] (2009) [http://www.ofsted.gov.uk/Ofsted-home/Publications-and-research/Browse-all-by/Documents-by-type/Thematic-reports/Virtual-learning-environments-an-evaluation-of-their-development-in-a-sample-of-educational-settings Virtual learning environments: an evaluation of their development in a sample of educational settings].
*Sancar, H. & Cagiltay, K. (2008). [http://www.editlib.org/p/28931 Effective Use of LMS: Pedagogy through the Technology]. In J. Luca & E. Weippl (Eds.), Proceedings of World Conference on Educational Multimedia, Hypermedia and Telecommunications 2008

==Presentations and videos==
==Other material==
=Questions? Try here=
See the growing list at [[Moodle research FAQ]]

Moodle in education

2011-06-28T06:56:47Z

Lasko: /* Starting with Moodle */

{{Teacher documentation}}
Welcome! The purpose of this page is to provide educators with a brief overview of teaching and learning with Moodle and useful links by general topics.

==Moodle principles==

The design and development of Moodle has been guided by a [https://docs.moodle.org/en/Philosophy social constructionist] theory and practice of teaching and learning. While Moodle can be and is used to support a number of other pedagogical and andragogical approaches, the core Moodle package will continue to be built with these [[five key principles]] in mind.

*[[Pedagogy|Moodle Pedagogy]]

==Moodle in education and training==

Although initially designed for higher education environment (university), Moodle has quickly become used across a broad range of organisations worldwide to conduct courses fully online or support face-to-face teaching and learning.

Its modularity, flexibility, security and free availability have attracted learning communities ranging from single primary school classrooms to large universities, businesses, government departments and other places where people learn.

* [[Primary education]] - Common uses of Moodle in primary education settings.

* [[Secondary education]] - Common uses of Moodle in secondary education settings.

* [[Tertiary education]] - Common uses of Moodle in tertiary education settings.

* [[Adult education and training]] - Common uses of Moodle in adult education and business/government training.

==Versions of Moodle==
[[Moodle_version_history|Since 2002]], Moodle has undergone many changes and updated versions. Currently, the most widely used stable version of Moodle is 1.9.x

'''Moodle 2.0''' is a major new stable version released in November 2010. It contains a [[Moodle_2.0_release_notes|many improvements and new features]]. Users will be able import and export content in and out Moodle easier, [[Course completion|scaffold courses]] and [[Activity completion|activities]] by using conditions for entry, improved evaluations with re-designed Quiz and Workshop activities, search, enrol in and share courses via [[Community hub]], enter comments in a range of places, navigate easier, integrate better with other systems, mobile devices, customise their [[My Moodle|personal home page]] and more. Check this [http://www.youtube.com/view_play_list?p=5F39867B1037BA89 playlist of short clips] for the new and redesigned features in Moodle 2.0.

==Starting with Moodle==

Countless anecdotes from Moodle users suggest that the best way to learn Moodle is by simply trying and using it in ways you find it creative and useful - like a [http://www.slideshare.net/moodlefan/what-is-moodle-explained-with-lego-presentation box of Lego].

* [[Getting started for teachers|Getting started for teachers]] - general overview of technical features of a course with links to expand your knowledge of the how to make different features work, currently for Moodle 1.x.
* [http://moodle.org/course/view.php?id=17223 moodle.org/educators] – a course with explanations, FAQ, examples of use, useful links, tips, strategies and resources to help educators make the most of Moodle
* [[Mt Orange School Demo]] - A demo site in Moodle 2.0, fully populated with accounts and examples to see and play with. Great way to explore the features of Moodle and many ways they could be used in places where people teach and learn. Site link - [http://school.demo.moodle.net Mt Orange School Demo]
* [[Teaching FAQ]] - Commonly asked questions about Moodle and its use
* [http://download.moodle.org Download Moodle] – Choose from the official Moodle packages to install on your own server.

==Moodle community==

Moodle has been made and improved with participation, mutual help from software developers, educators, translators and many others worldwide. There are many ways to participate in Moodle community, regardless of your background and interest.

* [http://moodle.org Moodle.org] - The multilingual ''alma mater'' of moodlers worldwide! Forums, documents, users, activities, demos, history, Particularly Helpful Moodlers and more. You can see and contribute to the good will and effort of thousands over the years.
* [https://docs.moodle.org Moodle Docs] - A wikipedia-style documentation about Moodle that we all write. This document is part of Moodle Docs and anyone can contribute, easily.
* [http://moodle.com/partners/ Moodle Partners] – Optional commercial services for Moodle users, including fully-serviced Moodle hosting, remote support contracts, custom code development and consulting.
* [http://tracker.moodle.org/ Moodle Tracker] – Community database for recording and managing bugs, improvements and feature requests for Moodle.
* [http://moodle.org/course/view.php?id=33 MoodleMoots] - List of famously named gatherings of Moodle users, developers and enthusiasts around the world! Other events included.
* [http://moodle.org/mod/page/view.php?id=7750 Moodle on social networks] – Connect with fellow moodlers.
* [http://moodle.org/mod/page/view.php?id=7748 Getting help] – There are many ways in which you can ask for and get help.
* [[Moodle research]] - A growing, community-contributed collection of research into LMS (Learning Management Systems) and particularly Moodle.

==Reference==
*[[:Category:Teacher]] - List of links to "Teacher" related pages.
*[[Moodle manuals]] - List of links to manuals in different languages.
*[http://moodle.org/mod/data/view.php?id=7246 Moodle Books] - List of Moodle books in different languages.
*[http://moodle.org/mod/page/view.php?id=7745 Tutorials] - Links to manuals and popular video tutorials
*[[Using Moodle book]] - A real book you can reprint!
*[http://moodle.org/mod/forum/discuss.php?d=150830 Moodle Tool Guide for Teachers] - Great printable poster of Moodle tools and their suitability for different learning tasks.
*[https://docs.moodle.org/en/Moodle_Teacher_Certificate Course Creator Certificate] - Get certified by demonstrating your skills in using Moodle as a teacher.

==Useful links==
*[http://moodle.org/mod/page/view.php?id=7743 Teaching Do and Donts] - A poster with explanatory links.
*[[Student documentation examples]] - Useful documents for students, multi-language.
*[[Student FAQ]] - Questions that students may have about Moodle.
*[[Trainer]] - Useful links for Trainers
*Non Internet Moodles - Information for small installations and sandboxes
:[[Complete install packages]] - for installing Moodle on a small server or a standalone computer
:[[Installation guide - Moodle for Windows on a USB Memory Stick]]
:[[Development:Windows_Installer_anywhere]]

[[Category:Teacher]]
[[cs:Rukověť učitele]]
[[de:Dokumentation für Trainer]]
[[es:Documentación para Profesores]]
[[eu:Irakasleentzako dokumentazioa]]
[[fi:Opettajan opas]]
[[fr:Documentation enseignant]]
[[it:Documentazione per Docenti]]
[[ja:教師ドキュメント]]
[[nl:Documentatie voor leraren]]
[[ru:Учителям]]
[[zh:教师文档]]

Moodle in education

2011-06-28T06:56:13Z

Lasko: /* Moodle community */

{{Teacher documentation}}
Welcome! The purpose of this page is to provide educators with a brief overview of teaching and learning with Moodle and useful links by general topics.

==Moodle principles==

The design and development of Moodle has been guided by a [https://docs.moodle.org/en/Philosophy social constructionist] theory and practice of teaching and learning. While Moodle can be and is used to support a number of other pedagogical and andragogical approaches, the core Moodle package will continue to be built with these [[five key principles]] in mind.

*[[Pedagogy|Moodle Pedagogy]]

==Moodle in education and training==

Although initially designed for higher education environment (university), Moodle has quickly become used across a broad range of organisations worldwide to conduct courses fully online or support face-to-face teaching and learning.

Its modularity, flexibility, security and free availability have attracted learning communities ranging from single primary school classrooms to large universities, businesses, government departments and other places where people learn.

* [[Primary education]] - Common uses of Moodle in primary education settings.

* [[Secondary education]] - Common uses of Moodle in secondary education settings.

* [[Tertiary education]] - Common uses of Moodle in tertiary education settings.

* [[Adult education and training]] - Common uses of Moodle in adult education and business/government training.

==Versions of Moodle==
[[Moodle_version_history|Since 2002]], Moodle has undergone many changes and updated versions. Currently, the most widely used stable version of Moodle is 1.9.x

'''Moodle 2.0''' is a major new stable version released in November 2010. It contains a [[Moodle_2.0_release_notes|many improvements and new features]]. Users will be able import and export content in and out Moodle easier, [[Course completion|scaffold courses]] and [[Activity completion|activities]] by using conditions for entry, improved evaluations with re-designed Quiz and Workshop activities, search, enrol in and share courses via [[Community hub]], enter comments in a range of places, navigate easier, integrate better with other systems, mobile devices, customise their [[My Moodle|personal home page]] and more. Check this [http://www.youtube.com/view_play_list?p=5F39867B1037BA89 playlist of short clips] for the new and redesigned features in Moodle 2.0.

==Starting with Moodle==

Countless anecdotes from Moodle users suggest that the best way to learn Moodle is by simply trying and using it in ways you find it creative and useful - like a [http://www.slideshare.net/moodlefan/what-is-moodle-explained-with-lego-presentation box of Lego].

* [[Getting started for teachers|Getting started for teachers]] - general overview of technical features of a course with links to expand your knowledge of the how to make different features work, currently for Moodle 1.x.
* [http://moodle.org/course/view.php?id=17223 moodle.org/educators] – a course with explanations, FAQ, examples of use, useful links, tips, strategies and resources to help educators make the most of Moodle
* [[Mt Orange School Demo]] - A demo site in Moodle 2.0, fully populated with accounts and examples to see and play with. Great way to explore the features of Moodle and many ways they could be used in places where people teach and learn. Site link - [http://school.demo.moodle.net Mt Orange School Demo]
* [[Teaching with Moodle]] - a wiki on common approaches, strategies (needs updating).
* [http://download.moodle.org Download Moodle] – Choose from the official Moodle packages to install on your own server.

==Moodle community==

Moodle has been made and improved with participation, mutual help from software developers, educators, translators and many others worldwide. There are many ways to participate in Moodle community, regardless of your background and interest.

* [http://moodle.org Moodle.org] - The multilingual ''alma mater'' of moodlers worldwide! Forums, documents, users, activities, demos, history, Particularly Helpful Moodlers and more. You can see and contribute to the good will and effort of thousands over the years.
* [https://docs.moodle.org Moodle Docs] - A wikipedia-style documentation about Moodle that we all write. This document is part of Moodle Docs and anyone can contribute, easily.
* [http://moodle.com/partners/ Moodle Partners] – Optional commercial services for Moodle users, including fully-serviced Moodle hosting, remote support contracts, custom code development and consulting.
* [http://tracker.moodle.org/ Moodle Tracker] – Community database for recording and managing bugs, improvements and feature requests for Moodle.
* [http://moodle.org/course/view.php?id=33 MoodleMoots] - List of famously named gatherings of Moodle users, developers and enthusiasts around the world! Other events included.
* [http://moodle.org/mod/page/view.php?id=7750 Moodle on social networks] – Connect with fellow moodlers.
* [http://moodle.org/mod/page/view.php?id=7748 Getting help] – There are many ways in which you can ask for and get help.
* [[Moodle research]] - A growing, community-contributed collection of research into LMS (Learning Management Systems) and particularly Moodle.

==Reference==
*[[:Category:Teacher]] - List of links to "Teacher" related pages.
*[[Moodle manuals]] - List of links to manuals in different languages.
*[http://moodle.org/mod/data/view.php?id=7246 Moodle Books] - List of Moodle books in different languages.
*[http://moodle.org/mod/page/view.php?id=7745 Tutorials] - Links to manuals and popular video tutorials
*[[Using Moodle book]] - A real book you can reprint!
*[http://moodle.org/mod/forum/discuss.php?d=150830 Moodle Tool Guide for Teachers] - Great printable poster of Moodle tools and their suitability for different learning tasks.
*[https://docs.moodle.org/en/Moodle_Teacher_Certificate Course Creator Certificate] - Get certified by demonstrating your skills in using Moodle as a teacher.

==Useful links==
*[http://moodle.org/mod/page/view.php?id=7743 Teaching Do and Donts] - A poster with explanatory links.
*[[Student documentation examples]] - Useful documents for students, multi-language.
*[[Student FAQ]] - Questions that students may have about Moodle.
*[[Trainer]] - Useful links for Trainers
*Non Internet Moodles - Information for small installations and sandboxes
:[[Complete install packages]] - for installing Moodle on a small server or a standalone computer
:[[Installation guide - Moodle for Windows on a USB Memory Stick]]
:[[Development:Windows_Installer_anywhere]]

[[Category:Teacher]]
[[cs:Rukověť učitele]]
[[de:Dokumentation für Trainer]]
[[es:Documentación para Profesores]]
[[eu:Irakasleentzako dokumentazioa]]
[[fi:Opettajan opas]]
[[fr:Documentation enseignant]]
[[it:Documentazione per Docenti]]
[[ja:教師ドキュメント]]
[[nl:Documentatie voor leraren]]
[[ru:Учителям]]
[[zh:教师文档]]

Upgrading

2011-06-15T05:08:30Z

Lasko:

Moodle is designed to upgrade itself from one version to the next. The procedure is
# [[Site backup|Back up everything]].
# Replace the old version of the code with the new one.
# Visit the [[Site_administration_block#Notifications|administrator notifications]] link, which triggers Moodle to self-update.
These steps are explained in more detail below.

Sometimes there are specific considerations when upgrading to a particular version. Please refer to [[Upgrading to Moodle 1.6]], [[Upgrading to Moodle 1.8]], [[Upgrading to Moodle 1.9]] or [[Upgrading to Moodle 2.0]] if applicable. You also have to be more careful if you have installed additional plug-ins or customised the code.

See this tutorial if you are [http://ic.eflclasses.org/tutorials/howtoupgrademoodlewithcpanel.swf upgrading Moodle on cpanel]. It is a bit rough around the edges and is a little dated, but you should get the idea.

There is also a separate page about [[Ubuntu_Debian_Upgrades|upgrading Moodle if you installed it using the Ubuntu/Kubuntu/Debian package manager]].

__TOC__

When upgrading a Moodle installation you should follow these steps:

==Before you upgrade your site for real==

You are strongly advised to make a copy of your entire Moodle site onto another computer (see [[Moodle migration]]) and run the upgrade there to verify it will work.

==Check the requirements==
Spend some time re-reading the [[Installing Moodle | installation documentation]] and documentation for the new version. Check the system requirements for the target version you want to upgrade-to in ''Administration > Server > [[Environment]]''.
==Put your Site into Maintenance Mode==
Before you begin upgrading your site, you should put it into [[Maintenance_mode | Maintenance Mode]] to stop any non-admin users from logging in.

== Backup important data ==
See [[Site backup]] for more specific information.

There are three areas that should be backed up before any upgrade:
#Moodle software (For example, everything in server/htdocs/moodle)
#Moodle uploaded files (For example, server/moodledata)
#Moodle database (For example, the SQL or Postgres database)

Experienced site administrators know that it is a best practice (a very good idea) to make a backup of any production system before a major upgrade. In fact, it is a good idea to automate your server to backup your Moodle installation daily. Most upgrades on sites that have used the standard Moodle packages (no contributed code and no little tweaks to the php files), will not have any major issues with the upgrade process.

:''TIP:'' One more time, "do not risk what you can not afford to lose": do regular backups, make sure it is really backed up and know how to restore a backup!

== Install the new Moodle software ==
Upgrading can be a simple process or a more complicated process. Sites that have not used contributed code and are migrating from say Moodle 1.x.1 to 1.x.3 '''should''' not have a problem. However, we still recommend that with any production server that you have made a successful backup of the MySQL database, the moodledata directory and the moodle program folders and files.

*Do not overwrite an old installation unless you know what you are doing ... sometimes old files can cause problems in new installations. Review the backup section above.

=== Standard install package ===
Having read the cautions about backups, download a copy of the standard install package. Here is a set of simple instructions for an average site.
*It is probably a good idea to use the [[Site administration block]]>Server>Maintenance mode to prevent user activity as the site upgrades.
*Having moved your old Moodle software program files to another location, unzip or unpack the upgrade file so that all new the Moodle software program files are in the location the old files used to be in on the server. Moodle will adjust SQL and [[Moodledata directory|moodledata]] if it needs to in the upgrade.
*Copy your old [[Configuration file|config.php file]] back to the new Moodle directory.
*If you had added any custom plugins or themes into your Moodle you can add them to the new code. It is important to check that you get the correct version for your new version of Moodle. You should check in the optional plugins database. Be particularly careful that you do not overwrite any code in the new version of Moodle. If you are upgrading to Moodle 2.0 or newer, note that all optional plugins and themes required a significant rewrite and most do not have 2.0 versions (yet).
*Use the notification link in the site administration to start the upgrade process. You will see a series of lines or screens indicating progress.
*After a successful upgrade, turn off the maintenance mode, so your users can get into the site.

=== Using a downloaded archive ===
In some installs, the site administrator may overwrite the Moodle code with a backup copy. Or create a new clean install copy of Moodle, then restore an archive (via a compressed file or parts of a saved set of Moodle code files and folders).

*Do not overwrite an old installation unless you know what you are doing ... sometimes old files can cause problems in new or "cleaned" installations. The best way is to rename the current Moodle code directory (for example rename "moodle" to "moodleold"), then unpack the new Moodle archive into the old location (for example, a new directory called "moodle").

====Linux====
mv moodle moodle.backup
tar xvzf moodle-1.1.tgz

Next, copy across your config.php, any other plugins such as custom themes, and your .htaccess file if you created one ('''check that optional/custom plugins are the correct version for your new Moodle first'''):

cp moodle.backup/config.php moodle
cp -pr moodle.backup/theme/mytheme moodle/theme/mytheme
cp -pr moodle.backup/mod/mymod moodle/mod/mymod

Don't forget to

sudo chown www-data moodle/config.php

if necessary.

where www-data is whatever user the Apache user is on your system. This is often 'apache' or 'www'.
You can find out by doing 'ls -l' in your /var/www/moodle folder (or wherever your moodle site is)
and then looking at the owner and group.

so you may see something like

ls -l
...lots of lines...
-rw-r--r-- 1 apache system 784 Jun 28 2007 config.php
...lots more lines...

so the owner is apache and the group is system.

To replicate this on your new system you can do 'chown apache:system config.php'

or to do a whole group do

chown apache:system ./*

and recursively

chown -R apache:system ./*

=== Using CVS ===

You can use CVS for updating or upgrading your Moodle.
First you need to do a CVS checkout in your (empty) Moodle root directory.

You can use any of our [[CVS_for_Administrators#CVS_Servers|CVS Mirror servers]]. Just replace '''SERVER.cvs.moodle.org''' in the instructions below with the name of the mirror server you chose!.

====For Linux servers====

To do a CVS checkout of Moodle, you first have to logon to the Moodle CVS server.

<nowiki>cvs -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle login</nowiki>
No password for anonymous, so just hit the Enter button.

Go to the directory where you want the Moodle root to come and type

<nowiki>cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_18_STABLE moodle</nowiki>
(where MOODLE_18_STABLE is the desired version)

To update, just go into the Moodle root directory and update to the new files:

cvs update -dP
To update to a new version type in the following and change 18 to whatever newest version upgrade number is
cvs -Q update -dP -r MOODLE_18_STABLE

Make sure you use the "d" parameter to create new directories if necessary, and the "P" parameter to prune empty directories.

====For Windows servers====

You can use Tortoise CVS to do the initial checkout and the updates.

If you have been editing Moodle files, watch the messages very closely for possible conflicts. All your customised themes and non-standard plugins will be untouched.

Do not forget to trigger the install process in the site administration block (see below).

=== Using Git ===

You can use [[Git]] for updating or upgrading your Moodle.
First you need to do a Git checkout in your (empty) Moodle root directory.

See [[Git for Administrators]] for further details.

== Finishing the upgrade ==

The last step is to trigger the upgrade processes within Moodle.

To do this just visit the [[Site administration block]] admin page (or ''<nowiki>http://example.com/moodle/admin</nowiki>'') and the "Notifications" link.

Moodle will automatically detect the new version and perform all the SQL database or file system upgrades that are necessary. If there is anything it can't do itself (very rare) then you will see messages telling you what you need to do.

Assuming all goes well (no error messages) then you can start using your new version of Moodle and enjoy the new features!

:''TIP:'' Use the site administration block>Server>Maintenance mode to prevent users from changing data during the upgrade.
:''TIP:'' If you are running a large scale Moodle site (e.g. have more tha 10,000+ courses and 40,000+ users), make sure that you do your own performance profiling testing. Post a thread or check the [http://moodle.org/mod/forum/view.php?id=28 Installation problems forum] and check [[Tracker]] for potential issues.

== Verify the upgrade (optional) ==

If you wish to confirm that the database definitions in the upgraded database match the definitions of a new, clean install (which they should) you might like to look at [[Verify Database Schema]].

==Upgrading more than one version==

In general, it is recommended to upgrade via the newest of each major version of Moodle, for example 1.7 -> 1.9. An exception to this is when upgrading from 1.5 or 1.6, when it is recommended that 1.7 and 1.8 are skipped, in other words upgrade 1.5 -> 1.6 -> 1.9. (The main reason for this recommendation is that the default roles settings obtained when upgrading to 1.7 are not ideal for 1.8 onwards, 1.8 has problems with groups, etc.)

==See also==

*[[Installing Moodle]]
*[[Installation FAQ]]
*[[Upgrading to Moodle 1.6]]
*[[Upgrading to Moodle 1.8]]
*[[Upgrading to Moodle 1.9]]
*[[Upgrading to Moodle 2.0]]
*[[Environment]]
*[[Git]] Version control and upgrading
*Moodle.org [http://moodle.org/mod/forum/view.php?id=28 Installation problems forum]
*[http://ic.eflclasses.org/tutorials/howtoupgrademoodlewithcpanel.swf How to upgrade Moodle with cpanel tutorial] - screencasts of older Moodle/Cpanel install but useful (also, a very large file that will take some time to load).

Using Moodle.org forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=26731&parent=125858 Using cvs]
*[http://moodle.org/mod/forum/discuss.php?d=56915 Upgrading from 1.5.2 to 1.7]
*[http://moodle.org/mod/forum/discuss.php?d=56991 Upgrade nightmares.... any help appreciated]
*[http://moodle.org/mod/forum/discuss.php?d=62463 After upgrading i get "Your site may not be secure." msg]
*[http://moodle.org/mod/forum/discuss.php?d=104887 Best practices for QA]

[[Category:Installation]]

[[es:Actualización de moodle]]
[[fr:Mise à jour]]
[[ja:アップグレード]]
[[nl:Upgraden]]
[[zh:升级]]
[[pl:Aktualizacja]]
[[de:Aktualisierung von Moodle]]
[[ru:Обновление]]

Upgrading

2011-06-15T05:06:30Z

Lasko:

{{Getting Moodle}}

Moodle is designed to upgrade itself from one version to the next. The procedure is
# [[Site backup|Back up everything]].
# Replace the old version of the code with the new one.
# Visit the [[Site_administration_block#Notifications|administrator notifications]] link, which triggers Moodle to self-update.
These steps are explained in more detail below.

Sometimes there are specific considerations when upgrading to a particular version. Please refer to [[Upgrading to Moodle 1.6]], [[Upgrading to Moodle 1.8]], [[Upgrading to Moodle 1.9]] or [[Upgrading to Moodle 2.0]] if applicable. You also have to be more careful if you have installed additional plug-ins or customised the code.

See this tutorial if you are [http://ic.eflclasses.org/tutorials/howtoupgrademoodlewithcpanel.swf upgrading Moodle on cpanel]. It is a bit rough around the edges and is a little dated, but you should get the idea.

There is also a separate page about [[Ubuntu_Debian_Upgrades|upgrading Moodle if you installed it using the Ubuntu/Kubuntu/Debian package manager]].

__TOC__

When upgrading a Moodle installation you should follow these steps:

==Before you upgrade your site for real==

You are strongly advised to make a copy of your entire Moodle site onto another computer (see [[Moodle migration]]) and run the upgrade there to verify it will work.

==Check the requirements==
Spend some time re-reading the [[Installing Moodle | installation documentation]] and documentation for the new version. Check the system requirements for the target version you want to upgrade-to in ''Administration > Server > [[Environment]]''.
==Put your Site into Maintenance Mode==
Before you begin upgrading your site, you should put it into [[Maintenance_mode | Maintenance Mode]] to stop any non-admin users from logging in.

== Backup important data ==
See [[Site backup]] for more specific information.

There are three areas that should be backed up before any upgrade:
#Moodle software (For example, everything in server/htdocs/moodle)
#Moodle uploaded files (For example, server/moodledata)
#Moodle database (For example, the SQL or Postgres database)

Experienced site administrators know that it is a best practice (a very good idea) to make a backup of any production system before a major upgrade. In fact, it is a good idea to automate your server to backup your Moodle installation daily. Most upgrades on sites that have used the standard Moodle packages (no contributed code and no little tweaks to the php files), will not have any major issues with the upgrade process.

:''TIP:'' One more time, "do not risk what you can not afford to lose": do regular backups, make sure it is really backed up and know how to restore a backup!

== Install the new Moodle software ==
Upgrading can be a simple process or a more complicated process. Sites that have not used contributed code and are migrating from say Moodle 1.x.1 to 1.x.3 '''should''' not have a problem. However, we still recommend that with any production server that you have made a successful backup of the MySQL database, the moodledata directory and the moodle program folders and files.

*Do not overwrite an old installation unless you know what you are doing ... sometimes old files can cause problems in new installations. Review the backup section above.

=== Standard install package ===
Having read the cautions about backups, download a copy of the standard install package. Here is a set of simple instructions for an average site.
*It is probably a good idea to use the [[Site administration block]]>Server>Maintenance mode to prevent user activity as the site upgrades.
*Having moved your old Moodle software program files to another location, unzip or unpack the upgrade file so that all new the Moodle software program files are in the location the old files used to be in on the server. Moodle will adjust SQL and [[Moodledata directory|moodledata]] if it needs to in the upgrade.
*Copy your old [[Configuration file|config.php file]] back to the new Moodle directory.
*If you had added any custom plugins or themes into your Moodle you can add them to the new code. It is important to check that you get the correct version for your new version of Moodle. You should check in the optional plugins database. Be particularly careful that you do not overwrite any code in the new version of Moodle. If you are upgrading to Moodle 2.0 or newer, note that all optional plugins and themes required a significant rewrite and most do not have 2.0 versions (yet).
*Use the notification link in the site administration to start the upgrade process. You will see a series of lines or screens indicating progress.
*After a successful upgrade, turn off the maintenance mode, so your users can get into the site.

=== Using a downloaded archive ===
In some installs, the site administrator may overwrite the Moodle code with a backup copy. Or create a new clean install copy of Moodle, then restore an archive (via a compressed file or parts of a saved set of Moodle code files and folders).

*Do not overwrite an old installation unless you know what you are doing ... sometimes old files can cause problems in new or "cleaned" installations. The best way is to rename the current Moodle code directory (for example rename "moodle" to "moodleold"), then unpack the new Moodle archive into the old location (for example, a new directory called "moodle").

====Linux====
mv moodle moodle.backup
tar xvzf moodle-1.1.tgz

Next, copy across your config.php, any other plugins such as custom themes, and your .htaccess file if you created one ('''check that optional/custom plugins are the correct version for your new Moodle first'''):

cp moodle.backup/config.php moodle
cp -pr moodle.backup/theme/mytheme moodle/theme/mytheme
cp -pr moodle.backup/mod/mymod moodle/mod/mymod

Don't forget to

sudo chown www-data moodle/config.php

if necessary.

where www-data is whatever user the Apache user is on your system. This is often 'apache' or 'www'.
You can find out by doing 'ls -l' in your /var/www/moodle folder (or wherever your moodle site is)
and then looking at the owner and group.

so you may see something like

ls -l
...lots of lines...
-rw-r--r-- 1 apache system 784 Jun 28 2007 config.php
...lots more lines...

so the owner is apache and the group is system.

To replicate this on your new system you can do 'chown apache:system config.php'

or to do a whole group do

chown apache:system ./*

and recursively

chown -R apache:system ./*

=== Using CVS ===

You can use CVS for updating or upgrading your Moodle.
First you need to do a CVS checkout in your (empty) Moodle root directory.

You can use any of our [[CVS_for_Administrators#CVS_Servers|CVS Mirror servers]]. Just replace '''SERVER.cvs.moodle.org''' in the instructions below with the name of the mirror server you chose!.

====For Linux servers====

To do a CVS checkout of Moodle, you first have to logon to the Moodle CVS server.

<nowiki>cvs -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle login</nowiki>
No password for anonymous, so just hit the Enter button.

Go to the directory where you want the Moodle root to come and type

<nowiki>cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_18_STABLE moodle</nowiki>
(where MOODLE_18_STABLE is the desired version)

To update, just go into the Moodle root directory and update to the new files:

cvs update -dP
To update to a new version type in the following and change 18 to whatever newest version upgrade number is
cvs -Q update -dP -r MOODLE_18_STABLE

Make sure you use the "d" parameter to create new directories if necessary, and the "P" parameter to prune empty directories.

====For Windows servers====

You can use Tortoise CVS to do the initial checkout and the updates.

If you have been editing Moodle files, watch the messages very closely for possible conflicts. All your customised themes and non-standard plugins will be untouched.

Do not forget to trigger the install process in the site administration block (see below).

=== Using Git ===

You can use [[Git]] for updating or upgrading your Moodle.
First you need to do a Git checkout in your (empty) Moodle root directory.

See [[Git for Administrators]] for further details.

== Finishing the upgrade ==

The last step is to trigger the upgrade processes within Moodle.

To do this just visit the [[Site administration block]] admin page (or ''<nowiki>http://example.com/moodle/admin</nowiki>'') and the "Notifications" link.

Moodle will automatically detect the new version and perform all the SQL database or file system upgrades that are necessary. If there is anything it can't do itself (very rare) then you will see messages telling you what you need to do.

Assuming all goes well (no error messages) then you can start using your new version of Moodle and enjoy the new features!

:''TIP:'' Use the site administration block>Server>Maintenance mode to prevent users from changing data during the upgrade.
:''TIP:'' If you are running a large scale Moodle site (e.g. have more tha 10,000+ courses and 40,000+ users), make sure that you do your own performance profiling testing. Post a thread or check the [http://moodle.org/mod/forum/view.php?id=28 Installation problems forum] and check [[Tracker]] for potential issues.

== Verify the upgrade (optional) ==

If you wish to confirm that the database definitions in the upgraded database match the definitions of a new, clean install (which they should) you might like to look at [[Verify Database Schema]].

==Upgrading more than one version==

In general, it is recommended to upgrade via the newest of each major version of Moodle, for example 1.7 -> 1.9. An exception to this is when upgrading from 1.5 or 1.6, when it is recommended that 1.7 and 1.8 are skipped, in other words upgrade 1.5 -> 1.6 -> 1.9. (The main reason for this recommendation is that the default roles settings obtained when upgrading to 1.7 are not ideal for 1.8 onwards, 1.8 has problems with groups, etc.)

==See also==

*[[Installing Moodle]]
*[[Installation FAQ]]
*[[Upgrading to Moodle 1.6]]
*[[Upgrading to Moodle 1.8]]
*[[Upgrading to Moodle 1.9]]
*[[Upgrading to Moodle 2.0]]
*[[Environment]]
*[[Git]] Version control and upgrading
*Moodle.org [http://moodle.org/mod/forum/view.php?id=28 Installation problems forum]
*[http://ic.eflclasses.org/tutorials/howtoupgrademoodlewithcpanel.swf How to upgrade Moodle with cpanel tutorial] - screencasts of older Moodle/Cpanel install but useful (also, a very large file that will take some time to load).

Using Moodle.org forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=26731&parent=125858 Using cvs]
*[http://moodle.org/mod/forum/discuss.php?d=56915 Upgrading from 1.5.2 to 1.7]
*[http://moodle.org/mod/forum/discuss.php?d=56991 Upgrade nightmares.... any help appreciated]
*[http://moodle.org/mod/forum/discuss.php?d=62463 After upgrading i get "Your site may not be secure." msg]
*[http://moodle.org/mod/forum/discuss.php?d=104887 Best practices for QA]

[[Category:Installation]]

[[es:Actualización de moodle]]
[[fr:Mise à jour]]
[[ja:アップグレード]]
[[nl:Upgraden]]
[[zh:升级]]
[[pl:Aktualizacja]]
[[de:Aktualisierung von Moodle]]
[[ru:Обновление]]

Upgrading

2011-06-15T05:05:54Z

Lasko:

{{Getting Moodle}
Moodle is designed to upgrade itself from one version to the next. The procedure is
# [[Site backup|Back up everything]].
# Replace the old version of the code with the new one.
# Visit the [[Site_administration_block#Notifications|administrator notifications]] link, which triggers Moodle to self-update.
These steps are explained in more detail below.

Sometimes there are specific considerations when upgrading to a particular version. Please refer to [[Upgrading to Moodle 1.6]], [[Upgrading to Moodle 1.8]], [[Upgrading to Moodle 1.9]] or [[Upgrading to Moodle 2.0]] if applicable. You also have to be more careful if you have installed additional plug-ins or customised the code.

See this tutorial if you are [http://ic.eflclasses.org/tutorials/howtoupgrademoodlewithcpanel.swf upgrading Moodle on cpanel]. It is a bit rough around the edges and is a little dated, but you should get the idea.

There is also a separate page about [[Ubuntu_Debian_Upgrades|upgrading Moodle if you installed it using the Ubuntu/Kubuntu/Debian package manager]].

__TOC__

When upgrading a Moodle installation you should follow these steps:

==Before you upgrade your site for real==

You are strongly advised to make a copy of your entire Moodle site onto another computer (see [[Moodle migration]]) and run the upgrade there to verify it will work.

==Check the requirements==
Spend some time re-reading the [[Installing Moodle | installation documentation]] and documentation for the new version. Check the system requirements for the target version you want to upgrade-to in ''Administration > Server > [[Environment]]''.
==Put your Site into Maintenance Mode==
Before you begin upgrading your site, you should put it into [[Maintenance_mode | Maintenance Mode]] to stop any non-admin users from logging in.

== Backup important data ==
See [[Site backup]] for more specific information.

There are three areas that should be backed up before any upgrade:
#Moodle software (For example, everything in server/htdocs/moodle)
#Moodle uploaded files (For example, server/moodledata)
#Moodle database (For example, the SQL or Postgres database)

Experienced site administrators know that it is a best practice (a very good idea) to make a backup of any production system before a major upgrade. In fact, it is a good idea to automate your server to backup your Moodle installation daily. Most upgrades on sites that have used the standard Moodle packages (no contributed code and no little tweaks to the php files), will not have any major issues with the upgrade process.

:''TIP:'' One more time, "do not risk what you can not afford to lose": do regular backups, make sure it is really backed up and know how to restore a backup!

== Install the new Moodle software ==
Upgrading can be a simple process or a more complicated process. Sites that have not used contributed code and are migrating from say Moodle 1.x.1 to 1.x.3 '''should''' not have a problem. However, we still recommend that with any production server that you have made a successful backup of the MySQL database, the moodledata directory and the moodle program folders and files.

*Do not overwrite an old installation unless you know what you are doing ... sometimes old files can cause problems in new installations. Review the backup section above.

=== Standard install package ===
Having read the cautions about backups, download a copy of the standard install package. Here is a set of simple instructions for an average site.
*It is probably a good idea to use the [[Site administration block]]>Server>Maintenance mode to prevent user activity as the site upgrades.
*Having moved your old Moodle software program files to another location, unzip or unpack the upgrade file so that all new the Moodle software program files are in the location the old files used to be in on the server. Moodle will adjust SQL and [[Moodledata directory|moodledata]] if it needs to in the upgrade.
*Copy your old [[Configuration file|config.php file]] back to the new Moodle directory.
*If you had added any custom plugins or themes into your Moodle you can add them to the new code. It is important to check that you get the correct version for your new version of Moodle. You should check in the optional plugins database. Be particularly careful that you do not overwrite any code in the new version of Moodle. If you are upgrading to Moodle 2.0 or newer, note that all optional plugins and themes required a significant rewrite and most do not have 2.0 versions (yet).
*Use the notification link in the site administration to start the upgrade process. You will see a series of lines or screens indicating progress.
*After a successful upgrade, turn off the maintenance mode, so your users can get into the site.

=== Using a downloaded archive ===
In some installs, the site administrator may overwrite the Moodle code with a backup copy. Or create a new clean install copy of Moodle, then restore an archive (via a compressed file or parts of a saved set of Moodle code files and folders).

*Do not overwrite an old installation unless you know what you are doing ... sometimes old files can cause problems in new or "cleaned" installations. The best way is to rename the current Moodle code directory (for example rename "moodle" to "moodleold"), then unpack the new Moodle archive into the old location (for example, a new directory called "moodle").

====Linux====
mv moodle moodle.backup
tar xvzf moodle-1.1.tgz

Next, copy across your config.php, any other plugins such as custom themes, and your .htaccess file if you created one ('''check that optional/custom plugins are the correct version for your new Moodle first'''):

cp moodle.backup/config.php moodle
cp -pr moodle.backup/theme/mytheme moodle/theme/mytheme
cp -pr moodle.backup/mod/mymod moodle/mod/mymod

Don't forget to

sudo chown www-data moodle/config.php

if necessary.

where www-data is whatever user the Apache user is on your system. This is often 'apache' or 'www'.
You can find out by doing 'ls -l' in your /var/www/moodle folder (or wherever your moodle site is)
and then looking at the owner and group.

so you may see something like

ls -l
...lots of lines...
-rw-r--r-- 1 apache system 784 Jun 28 2007 config.php
...lots more lines...

so the owner is apache and the group is system.

To replicate this on your new system you can do 'chown apache:system config.php'

or to do a whole group do

chown apache:system ./*

and recursively

chown -R apache:system ./*

=== Using CVS ===

You can use CVS for updating or upgrading your Moodle.
First you need to do a CVS checkout in your (empty) Moodle root directory.

You can use any of our [[CVS_for_Administrators#CVS_Servers|CVS Mirror servers]]. Just replace '''SERVER.cvs.moodle.org''' in the instructions below with the name of the mirror server you chose!.

====For Linux servers====

To do a CVS checkout of Moodle, you first have to logon to the Moodle CVS server.

<nowiki>cvs -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle login</nowiki>
No password for anonymous, so just hit the Enter button.

Go to the directory where you want the Moodle root to come and type

<nowiki>cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_18_STABLE moodle</nowiki>
(where MOODLE_18_STABLE is the desired version)

To update, just go into the Moodle root directory and update to the new files:

cvs update -dP
To update to a new version type in the following and change 18 to whatever newest version upgrade number is
cvs -Q update -dP -r MOODLE_18_STABLE

Make sure you use the "d" parameter to create new directories if necessary, and the "P" parameter to prune empty directories.

====For Windows servers====

You can use Tortoise CVS to do the initial checkout and the updates.

If you have been editing Moodle files, watch the messages very closely for possible conflicts. All your customised themes and non-standard plugins will be untouched.

Do not forget to trigger the install process in the site administration block (see below).

=== Using Git ===

You can use [[Git]] for updating or upgrading your Moodle.
First you need to do a Git checkout in your (empty) Moodle root directory.

See [[Git for Administrators]] for further details.

== Finishing the upgrade ==

The last step is to trigger the upgrade processes within Moodle.

To do this just visit the [[Site administration block]] admin page (or ''<nowiki>http://example.com/moodle/admin</nowiki>'') and the "Notifications" link.

Moodle will automatically detect the new version and perform all the SQL database or file system upgrades that are necessary. If there is anything it can't do itself (very rare) then you will see messages telling you what you need to do.

Assuming all goes well (no error messages) then you can start using your new version of Moodle and enjoy the new features!

:''TIP:'' Use the site administration block>Server>Maintenance mode to prevent users from changing data during the upgrade.
:''TIP:'' If you are running a large scale Moodle site (e.g. have more tha 10,000+ courses and 40,000+ users), make sure that you do your own performance profiling testing. Post a thread or check the [http://moodle.org/mod/forum/view.php?id=28 Installation problems forum] and check [[Tracker]] for potential issues.

== Verify the upgrade (optional) ==

If you wish to confirm that the database definitions in the upgraded database match the definitions of a new, clean install (which they should) you might like to look at [[Verify Database Schema]].

==Upgrading more than one version==

In general, it is recommended to upgrade via the newest of each major version of Moodle, for example 1.7 -> 1.9. An exception to this is when upgrading from 1.5 or 1.6, when it is recommended that 1.7 and 1.8 are skipped, in other words upgrade 1.5 -> 1.6 -> 1.9. (The main reason for this recommendation is that the default roles settings obtained when upgrading to 1.7 are not ideal for 1.8 onwards, 1.8 has problems with groups, etc.)

==See also==

*[[Installing Moodle]]
*[[Installation FAQ]]
*[[Upgrading to Moodle 1.6]]
*[[Upgrading to Moodle 1.8]]
*[[Upgrading to Moodle 1.9]]
*[[Upgrading to Moodle 2.0]]
*[[Environment]]
*[[Git]] Version control and upgrading
*Moodle.org [http://moodle.org/mod/forum/view.php?id=28 Installation problems forum]
*[http://ic.eflclasses.org/tutorials/howtoupgrademoodlewithcpanel.swf How to upgrade Moodle with cpanel tutorial] - screencasts of older Moodle/Cpanel install but useful (also, a very large file that will take some time to load).

Using Moodle.org forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=26731&parent=125858 Using cvs]
*[http://moodle.org/mod/forum/discuss.php?d=56915 Upgrading from 1.5.2 to 1.7]
*[http://moodle.org/mod/forum/discuss.php?d=56991 Upgrade nightmares.... any help appreciated]
*[http://moodle.org/mod/forum/discuss.php?d=62463 After upgrading i get "Your site may not be secure." msg]
*[http://moodle.org/mod/forum/discuss.php?d=104887 Best practices for QA]

[[Category:Installation]]

[[es:Actualización de moodle]]
[[fr:Mise à jour]]
[[ja:アップグレード]]
[[nl:Upgraden]]
[[zh:升级]]
[[pl:Aktualizacja]]
[[de:Aktualisierung von Moodle]]
[[ru:Обновление]]

Emoticon images

2011-06-14T06:35:22Z

Lasko:

{{Filters}}

The list of images that will be used to replace the emoticon text can be defined at [[HTML settings]] admin page. The images defined here are used by [[Display emoticons as images]] filter and TinyMCE HTML editor's Insert emoticon popup menu.
[[Image:emoticon-setting.png|thumb|Emoticon setting page]]

== Form table fields ==

The form table maps the emoticon characters like <code>:-)</code> to an image that will be used to display that emoticon. Images can be provided either by the Moodle core itself or by any other installed plugin (like an activity module, block, theme or your plocal plugin). For accessibility reasons, alternative texts for these images should be defined, too.

=== Emoticon text ===

Into the first column, insert the text representation of the emoticon. The emoticon filter converts these texts into images. The text must pass the following constraints:

* It must be at least two characters long
* It can not contain <code>:/</code> and <code>//</code> substring to avoid accidental breaking of URL addresses
* It must contain some non-alphanumeric character to prevent from breaking HTML tags in the text

=== Image name and component ===

The default set of emoticons are provided by Moodle core itself. In that case, the image component is set to ''core''. The image name is a relative path to a file without the trailing slash and without the file extension. The image must be located in the <code>/pix</code> folder of the given component.

''Example:'' if the image name is set to <code>s/smiley</code> and the image component is set to <code>core</code>, the image file <code>{dirroot}/pix/s/smiley.gif</code> from your Moodle installation folder is used to display that emoticon.

=== Alternative text ===

Alternative texts are taken from [[Translation|language packs]] that can be again provided by either the core or a plugin. The first field value is the string identifier and the second field value is the name of the component providing that string (see the language packs documentation for details).

''Example:'' if the emoticon has the alternative text set to <code>smiley</code> and <code>core_pix</code>, then the localized text will be obtained from the file <code>{dataroot}/lang/XX/pix.php</code> where XX is the current language code. If that translation is available, the value from the English pack <code>{dirroot}/lang/en/pix.php</code> will be used.

''Technical note:'' these two values are passed as the parameters to the <code>get_string()</code> function to obtain the alternative text

== Custom emoticons ==

To support your own emoticons, just add another row into the form table. However, if the images and their alternative texts are not available in the Moodle yet, you will have to add them in a form of an installed plugin, typically together with a theme or via your local plugin. The following section illustrates some options how to register emoticons provided by various types of plugins.

=== Emoticon provided by activity module ===

Let us say we want to use the emoticons system to display [[Workshop module]] icon instead of <code>(workshopicon)</code> text. As you can see, the icon is located in <code>{dirroot}/mod/workshop/pix/icon.gif</code>. Just add the following row into the emoticons form table:

{| class="nicetable"
|-
! Text
! Image name
! Image component
! colspan="2" | Alternative text
|-
| (workshopicon)
| icon
| mod_workshop
|
|
|}

Save changes in the form and the icon should appear at the end of the row. If you have the emoticon filter enabled, whenever you or your users type <code>(workshopicon)</code> in the text, it will be replaced with the image.

You may want to use the localized term for the Workshop module as the alternative text for that image. Because the Workshop module already contains a string that we can use, just add the following values into the last two columns of the table and save the changes again:

{| class="nicetable"
|-
! Text
! Image name
! Image component
! colspan="2" | Alternative text
|-
| (workshopicon)
| icon
| mod_workshop
| modulename
| mod_workshop
|}

=== Emoticon provided by installed theme ===

[[Development:Themes 2.0|Themes in Moodle 2.0]] are able to override any standard image provided by the Moodle core by default. So if a file <code>{themedir}/pix_core/s/biggrin.*</code> exists it is automatically used instead of standard <code>{dirroot}/pix/s/biggrin.*</code>. Themes like any other plugins are also able to extend the standard emoticon set or change the file names or their directories.

Let us say you have installed a theme named <code>mychool</code> that comes with its own set of standard emoticons. Those emoticons must be located in the <code>/pix</code> subfolder of that theme, for example in <code>{themedir}/pix/smilies/happy.png</code>. Now you want to use the emoticons provided by this theme instead of the default Moodle emoticon set. Just replace the relevant rows in the table with the new values:

{| class="nicetable"
|-
! Text
! Image name
! Image component
! colspan="2" | Alternative text
|-
| :-)
| smilies/happy
| theme_myschool
| smiley
| core_pix
|}

Note that we replaced just the image name and component. So the alternative text will be taken from the core language pack which is probably already localized into many languages.

=== Preparing own set of emoticons ===

If you have a set of images you would like to use as emoticons at your site, we recommend you to prepare a local plugin that will just provided these emoticons, without any other functionality. Even though this way involves a bit more work at the beginning, it is preferable over direct modification of the standard Moodle files. By encapsulating your emoticon with a local plugin, you can safely upgrade your site without the risk of overwriting your modifications, deploy the local plugin at multiple servers and share your work easily with the others.

Writing a local plugin that provides a set of emoticons is not hard even if you are not experienced PHP developers. You can use a [http://github.com/mudrd8mz/moodle-local_aliens published example] as a scaffold for your own work.

[[Category:Administrator]]

Podcasting

2011-06-14T04:09:56Z

Lasko:

{{Working with media}}
'''Please refer to [[Page_notes#Audio|these notes]] before editing this page.'''
'''Podcasting''' is an easy way to deliver a series of audio files in such a way that people can subscribe and have all current and future 'episodes' downloaded automatically to their computer or media player.

== Podcasting in Moodle ==

There are several ways to podcast in Moodle:

* Create a discussion forum and activate an RSS feed for the forum. Then simply post messages with media files as attachments. These will be delivered as podcasts in the [[RSS in forums|RSS feed]].
:''Note:'' This works in some situations and not in others. For example, users that do not have full permissions to access the forum may find that their podcast software does not have rights to the media files.
* Use the optional [[Ipodcast module]] which creates a specific podcasting activity type in Moodle. The advantage of this method is that it includes extra ''metadata'' designed to work well with Apple's ''iTunes'' software (such as keywords and category labels).
* Use "Podcaster" module: [http://moodle.org/mod/data/view.php?d=13&rid=2160 found here in Modules and Plugins].

== Podcasting about Moodle ==

You may also like to know that a podcast ''about'' Moodle is in preparation, tentatively called "[[Portal:mCast|mCast]]".

== Software for receiving podcasts ==

* Apple's [http://www.apple.com/itunes/ iTunes] is currently one of the more popular pieces of software for subscribing to podcasts
* [http://juicereceiver.sourceforge.net/ Juice] (previously known as ''iPodder'') which is open-source and available on Windows and Macintosh.
* [http://getsongbird.com/ Songbird], a truly cross-platform, Open Source media player.
* [http://www.gnome.org/projects/rhythmbox/ Rhythmbox] for the Gnome Desktop
* [http://amarok.kde.org/ Amarok] for KDE

==See also==

*Using Moodle [http://moodle.org/mod/forum/view.php?id=7230 Podcasting module forum]
* [http://en.wikipedia.org/wiki/Podcasting Wikipedia article on podcasting]
* [http://www.apple.com/podcasting Apple webpage on podcasting]
*[[Audio in Moodle]]
*[[iTunes university block]] contributed code that links to iTunes U

[[Category:RSS]]
[[Category:Contributed code]]
[[Category:Audio]]

[[pl:Podcasting]]

Speech tools

2011-06-14T04:09:22Z

Lasko:

{{Working with media}}
'''Please refer to [[Page_notes#Audio|these notes]] before editing this page.'''

Moodle has no built-in tools for speech messaging or audioconferencing. However, there are some interesting projects which are working towards enabling the use of voice tools within Moodle, at various stages of maturity:

==Free tools==
*[[Audio_in_Moodle#See_also|for a list of audio tools]] - duplicates all information below, plus a few more
* '''[http://www.covcell.org COVCELL]''', an EU-funded project to provide various enhancements for online language learning, including audio conferencing.
**See also [http://moodle.org/mod/forum/view.php?id=5368 COVCELL discussion forum on moodle.org] The audio conferencing will use a RED5 Flash-based server.
* Integration of Moodle with '''[http://gong.ust.hk/ Gong]''' (requires a Java server)
**[[NanoGong]] is Open Source, may require code change of HTML editor
* Integration of Moodle with '''[http://www.dimdim.com/ dimdim]''' open-source webconferencing system. (requires Windows or Linux for the server, Flash+IE/FireFox for the admin and client - still in beta (9 April 2007))
* '''[http://moodle.org/mod/forum/discuss.php?d=50265 MoodleSpeex]''' Java applets for voice messaging (note: does not require any modifications/additions to the server setup)
*[[Audio_in_Moodle#Using_Audacity_to_Convert_audio_and_Record_voice Audacity]] is Open Source

==Commercial tools==

* The '''Horizon Wimba''' company provides a subscription-based service providing [http://www.horizonwimba.com/products/voicetools/ voice tools] for use in VLEs. [[Wimba Voice Tools module]] has been created in Wimba to integrate into Moodle.

==See also==
*[[Audio_in_Moodle]]
*[[Portable recording devices]]
*[[MP3 player]]

*[[Audio_in_Moodle#See_also|List of audio tools]] in Audio in Moodle

[[Category:Administrator]]
[[Category:Teacher]]
[[Category:Audio]]

Grade category settings

2011-06-14T04:06:51Z

Lasko:

{{Gradebook}}
'''Please refer to [[Page_notes#Grade categories|these notes]] before editing this page.'''Location: ''Administration > Grades > Grade Category Settings''

Grade category settings enable administrators to choose which options appear for teachers when [[Grade categories|adding/editing a grade category]] in their course gradebook, and their default values. Settings are applied site-wide.

There are 2 check boxes next to most features on this page. The "Force" check box eliminates any options the teacher will see. For example, the teacher will only see and be able to use the "mean of all grades" as an aggregation. The "Advanced" checkbox will hide the specific feature until the "Show advanced" button is used by the teacher. This will reduce initial menu choices for teachers but allow them to see them if they wish.

[[Image:Grade category settings.png|thumb|100px|left|]]
==Hide forced settings==
The default is to show the forced settings (see below). If these are not to be used check this box to hide them. Unchecking the "Force" setting will simply restore each category's setting to its previous state, prior to the application of the forced global setting. Administrators can thus experiment with these settings without fear of losing any specific category settings.

==Aggregation settings==
Select the type of aggregation method from a pulldown menu from 1 of 9 choices. However there are two check boxes which will effect this default, in addition to the Hide forced settings.

The "Force" checkbox only allows the selected aggregation method to apply. This results in switches and drop-down elements being disabled in all course gradebooks. For example, if the Aggregation Type setting is forced as "Mean", teachers will no longer have the option to change the aggregation type of each grade category separately, the option will not be there in the category edit form.

==Available aggregation types==
[[Image:Available agg types.png|thumb|Available aggregation types setting]]
In Moodle 1.9.5 onwards, administrators may reduce the number of aggregation types available for teachers to use.

By default, all existing aggregation types are available (Mean of grades, Weighted mean of grades, Simple weighted mean of grades, Mean of grades (with extra credits), Median of grades, Lowest grade, Highest grade, Mode of grades, Sum of grades). This list may be reduced to only a few types, with additional types being enabled as/when teachers request them.

Note that reducing the number of aggregation types simply results in disabled aggregation types not appearing in the aggregation type dropdown menu. All existing grade category calculations remain the same, regardless of whether the aggregation type is later disabled by an administrator.

==Aggregate only non-empty grades==
The default is no.

==Include outcomes in aggregation==
The default is no.

==Aggregate including subcategories==
The default is no. Yes will include subcategory grades in the aggregation.

==Keep the highest==
Keeps only the X number of highest grades in the report

==Drop the lowest==
Drops the lowest X number of grades from the report.

==See also==
*[[Grade categories]] - for teachers
*[http://www.youtube.com/watch?v=p6zWwJGb9TA Video demonstrating how to use gradebook site settings and defaults]
*[http://www.youtube.com/watch?v=sUslTuZPu6A Video showing the effects of the grade category settings]

[[Category:Grades]]

[[de:Einstellungen_für_Bewertungskategorien]]
[[fr:Réglages des catégories d'évaluation]]
[[ja:評定カテゴリ設定]]

Grade aggregation

2011-06-14T04:05:46Z

Lasko:

{{Gradebook}}
'''Please refer to [[Page_notes#Grade categories|these notes]] before editing this page.'''
The aggregation dropdown menu lets you choose the aggregation strategy that will be used to calculate each participant's overall grade for a [[Grade categories|grade category]]. The different options are explained below.

The grades are first converted to percentage values (interval from 0 to 1), then aggregated using one of the strategies below and finally converted to the associated category item's range (between Minimum grade and Maximum grade).

Important: An empty grade is simply a missing gradebook entry, and could mean different things. For example, it could be a participant who hasn't yet submitted an assignment, an assignment submission not yet graded by the teacher, or a grade that has been manually deleted by the gradebook administrator. Caution in interpreting these "empty grades" is thus advised.

== Mean of grades ==
The sum of all grades divided by the total number of grades.
A1 70/100, A2 20/80, A3 10/10, category max 100:
(0.7 + 0.25 + 1.0)/3 = 0.65 --> 65/100

== Weighted mean ==
Each grade item can be given a weight, which is then used in the arithmetic mean aggregation to influence the importance of each item in the overall mean. In simple terms, the category "total" will be equal to the sum of the scores in each grade item, these scores being multiplied by the grade items' weights, and that sum being finally divided by the sum of the weights, as shown in this example.
A1 70/100 weight 10, A2 20/80 weight 5, A3 10/10 weight 3, category max 100:
(0.7*10 + 0.25*5 + 1.0*3)/18 = 0.625 --> 62.5/100

== Simple weighted mean ==
The difference from Weighted mean is that weight is calculated as Maximum grade - Minimum grade for each item. 100 point assignment has weight 100, 10 point assignment has weight 10.
A1 70/100, A2 20/80, A3 10/10, category max 100:
(0.7*100 + 0.25*80 + 1.0*10)/190 = 0.526 --> 52.6/100

== Mean of grades (with extra credits) ==
Arithmetic mean with a twist. An old, now unsupported aggregation strategy provided here only for backward compatibility with old activities.

A value greater than 0 treats a grade item's grades as extra credit during aggregation. The number is a factor by which the grade value will be multiplied before it is added to the sum of all grades, but the item itself will not be counted in the division. For example:

* Item 1 is graded 0-100 and its "Extra credit" value is set to 2
* Item 2 is graded 0-100 and its "Extra credit" value is left at 0.0000
* Item 3 is graded 0-100 and its "Extra credit" value is left at 0.0000
* All 3 items belong to Category 1, which has "Mean of grades (with extra credits)" as its aggregation strategy
* A student gets graded 20 on Item 1, 40 on Item 2 and 70 on Item 3
* The student's total for Category 1 will be 95/100 since 20*2 + (40 + 70)/2 = 95

== Median of grades ==
The middle grade (or the mean of the two middle grades) when grades are arranged in order of size. The advantage over the mean is that it is not affected by outliers (grades which are uncommonly far from the mean).
A1 70/100, A2 20/80, A3 10/10, category max 100:
0.7 + 0.25 + 1.0 --> 0.70 --> 70/100

== Smallest grade ==
The result is the smallest grade after normalisation. It is usually used in combination with Aggregate only non-empty grades.
A1 70/100, A2 20/80, A3 10/10, category max 100:
min(0.7 + 0.25 + 1.0) = 0.25 --> 25/100

== Highest grade ==
The result is the highest grade after normalisation.
A1 70/100, A2 20/80, A3 10/10, category max 100:
max(0.7 + 0.25 + 1.0) = 1.0 --> 100/100

== Mode of grades ==
The mode is the grade that occurs the most frequently. It is more often used for non-numerical grades. The advantage over the mean is that it is not affected by outliers (grades which are uncommonly far from the mean). However it loses its meaning once there is more than one most frequently occurring grade (only one is kept), or when all the grades are different from each other.
A1 70/100, A2 35/50, A3 20/80, A4 10/10, A5 7/10 category max 100:
mode(0.7; 0.7; 0.25; 1.0; 0.7) = 0.7 --> 70/100

== Sum of grades ==
The sum of all grade values. Scale grades are ignored. This is the only type that does not convert the grades to percentages internally. The Maximum grade of associated category item is calculated automatically as a sum of maximums from all aggregated items.
A1 70/100, A2 20/80, A3 10/10:
70 + 20 + 10 = 100/190

When the "Sum of grades" aggregation strategy is used, a grade item can act as Extra credit for the category. This means that the grade item's maximum grade will not be added to the category total's maximum grade, but the item's grade will. Following is an example:

* Item 1 is graded 0-100
* Item 2 is graded 0-75
* Item 1 has the "Act as extra credit" checkbox ticked, Item 2 doesn't.
* Both items belong to Category 1, which has "Sum of grades" as its aggregation strategy
* Category 1's total will be graded 0-75
* A student gets graded 20 on Item 1 and 70 on Item 2
* The student's total for Category 1 will be 75/75 (20+70 = 90 but Item 1 only acts as extra credit, so it brings the total to its maximum)

==Available aggregation types==
[[Image:Available agg types.png|thumb|Available aggregation types setting]]
In Moodle 1.9.5 onwards, a new available aggregation types setting in ''Administration > Grades > [[Grade category settings]]'' enables administrators to reduce the number of aggregation types.

Note that reducing the number of aggregation types simply results in disabled aggregation types not appearing in the aggregation type dropdown menu. All existing grade category calculations remain the same, regardless of whether the aggregation type is later disabled by an administrator.

[[ca:Agregació de les categories]]
[[fr:Tendance centrale de la catégorie]]

Grade aggregation

2011-06-14T04:05:11Z

Lasko:

{{Gradebook}}
'''Please refer to [[Page_notes#Grade category|these notes]] before editing this page.'''
The aggregation dropdown menu lets you choose the aggregation strategy that will be used to calculate each participant's overall grade for a [[Grade categories|grade category]]. The different options are explained below.

The grades are first converted to percentage values (interval from 0 to 1), then aggregated using one of the strategies below and finally converted to the associated category item's range (between Minimum grade and Maximum grade).

Important: An empty grade is simply a missing gradebook entry, and could mean different things. For example, it could be a participant who hasn't yet submitted an assignment, an assignment submission not yet graded by the teacher, or a grade that has been manually deleted by the gradebook administrator. Caution in interpreting these "empty grades" is thus advised.

== Mean of grades ==
The sum of all grades divided by the total number of grades.
A1 70/100, A2 20/80, A3 10/10, category max 100:
(0.7 + 0.25 + 1.0)/3 = 0.65 --> 65/100

== Weighted mean ==
Each grade item can be given a weight, which is then used in the arithmetic mean aggregation to influence the importance of each item in the overall mean. In simple terms, the category "total" will be equal to the sum of the scores in each grade item, these scores being multiplied by the grade items' weights, and that sum being finally divided by the sum of the weights, as shown in this example.
A1 70/100 weight 10, A2 20/80 weight 5, A3 10/10 weight 3, category max 100:
(0.7*10 + 0.25*5 + 1.0*3)/18 = 0.625 --> 62.5/100

== Simple weighted mean ==
The difference from Weighted mean is that weight is calculated as Maximum grade - Minimum grade for each item. 100 point assignment has weight 100, 10 point assignment has weight 10.
A1 70/100, A2 20/80, A3 10/10, category max 100:
(0.7*100 + 0.25*80 + 1.0*10)/190 = 0.526 --> 52.6/100

== Mean of grades (with extra credits) ==
Arithmetic mean with a twist. An old, now unsupported aggregation strategy provided here only for backward compatibility with old activities.

A value greater than 0 treats a grade item's grades as extra credit during aggregation. The number is a factor by which the grade value will be multiplied before it is added to the sum of all grades, but the item itself will not be counted in the division. For example:

* Item 1 is graded 0-100 and its "Extra credit" value is set to 2
* Item 2 is graded 0-100 and its "Extra credit" value is left at 0.0000
* Item 3 is graded 0-100 and its "Extra credit" value is left at 0.0000
* All 3 items belong to Category 1, which has "Mean of grades (with extra credits)" as its aggregation strategy
* A student gets graded 20 on Item 1, 40 on Item 2 and 70 on Item 3
* The student's total for Category 1 will be 95/100 since 20*2 + (40 + 70)/2 = 95

== Median of grades ==
The middle grade (or the mean of the two middle grades) when grades are arranged in order of size. The advantage over the mean is that it is not affected by outliers (grades which are uncommonly far from the mean).
A1 70/100, A2 20/80, A3 10/10, category max 100:
0.7 + 0.25 + 1.0 --> 0.70 --> 70/100

== Smallest grade ==
The result is the smallest grade after normalisation. It is usually used in combination with Aggregate only non-empty grades.
A1 70/100, A2 20/80, A3 10/10, category max 100:
min(0.7 + 0.25 + 1.0) = 0.25 --> 25/100

== Highest grade ==
The result is the highest grade after normalisation.
A1 70/100, A2 20/80, A3 10/10, category max 100:
max(0.7 + 0.25 + 1.0) = 1.0 --> 100/100

== Mode of grades ==
The mode is the grade that occurs the most frequently. It is more often used for non-numerical grades. The advantage over the mean is that it is not affected by outliers (grades which are uncommonly far from the mean). However it loses its meaning once there is more than one most frequently occurring grade (only one is kept), or when all the grades are different from each other.
A1 70/100, A2 35/50, A3 20/80, A4 10/10, A5 7/10 category max 100:
mode(0.7; 0.7; 0.25; 1.0; 0.7) = 0.7 --> 70/100

== Sum of grades ==
The sum of all grade values. Scale grades are ignored. This is the only type that does not convert the grades to percentages internally. The Maximum grade of associated category item is calculated automatically as a sum of maximums from all aggregated items.
A1 70/100, A2 20/80, A3 10/10:
70 + 20 + 10 = 100/190

When the "Sum of grades" aggregation strategy is used, a grade item can act as Extra credit for the category. This means that the grade item's maximum grade will not be added to the category total's maximum grade, but the item's grade will. Following is an example:

* Item 1 is graded 0-100
* Item 2 is graded 0-75
* Item 1 has the "Act as extra credit" checkbox ticked, Item 2 doesn't.
* Both items belong to Category 1, which has "Sum of grades" as its aggregation strategy
* Category 1's total will be graded 0-75
* A student gets graded 20 on Item 1 and 70 on Item 2
* The student's total for Category 1 will be 75/75 (20+70 = 90 but Item 1 only acts as extra credit, so it brings the total to its maximum)

==Available aggregation types==
[[Image:Available agg types.png|thumb|Available aggregation types setting]]
In Moodle 1.9.5 onwards, a new available aggregation types setting in ''Administration > Grades > [[Grade category settings]]'' enables administrators to reduce the number of aggregation types.

Note that reducing the number of aggregation types simply results in disabled aggregation types not appearing in the aggregation type dropdown menu. All existing grade category calculations remain the same, regardless of whether the aggregation type is later disabled by an administrator.

[[ca:Agregació de les categories]]
[[fr:Tendance centrale de la catégorie]]

Edit categories and items

2011-06-14T04:04:02Z

Lasko:

{{Gradebook}}
'''Please refer to [[Page_notes#Edit categories and items|these notes]] before editing this page.'''

==Introduction==
On this page, teachers and administrators can:
*Add
** [[Grade_categories|grade categories]]
** [[Grade_items|grade items]]
** [[Outcome_items|outcome items]]
*Perform the following actions on grade categories and items:
**Edit
**Move in and out of categories
**[[Grade hiding|Hide or show]]
**[[Grade locking|Lock or unlock]]
**Delete
*Synchronise legacy grades
*Edit [[Grade calculations|calculation formulas]] for grade categories
[[image:edit_categories_and_items.png|thumb|right|Editing categories and items]]

==Course grade category==
The course grade category represents the course as a container for grade categories and grade items. It cannot be deleted or moved, but it can be [[Grade_hiding|hidden]] and [[Grade_locking|locked]] like other categories and items. When a course is created, this category is automatically created. Its '''Name''' value is empty and optional, in which case the category's name is displayed as that of the course it represents. If a name is given manually to this category, that name will be used instead of the course name. See [[Grade_categories|grade categories editing]] for more information.

==Deleting categories==
What happens to grade items in a grade category when that category is deleted? They automatically get assigned to the parent category of the deleted category. For example, take the following structure:

Course (category)
|_ Semester 1 (category)
|_ Week 1 (category)
|_ Quiz 1 (item)
|_ Assignment 1 (item)
|_ Week 2 (category)
|_ Quiz 2 (item)
|_ Assignment 2 (item)
...

If we delete Week 1, the items within it will be moved up to the Semester 1 category, and we will have the following structure:

Course (category)
|_ Semester 1 (category)
|_ Quiz 1 (item)
|_ Assignment 1 (item)
|_ Week 2 (category)
|_ Quiz 2 (item)
|_ Assignment 2 (item)
...

As you can see, categories and items can live along-side each other without problems, but the result may look confusing to students and teachers alike.

==Moving categories and items==
[[image:edit_categories_and_items_move.png|thumb|right|Moving a grade item]]
Each grade category and grade item has a little up-and-down icon next to it (apart from the course grade category), which triggers the '''move''' action when clicked. The page then changes as shown in the screenshot on the right of this section:

*The element to be moved is highlighted and the word (Move) appears next to it
*Rectangular boxes preceded by an arrow appear in places where you can move your selected item or category.
*You can cancel your action at any time using the "Cancel" button at the bottom of the page

Once you have clicked one of the destination rectangles, your item will appear there instead of its original place. If you moved a category that contained items and/or categories, all its contents will also be moved along with it.

Moving items and categories does not affect individual grades. However, it affects the scores aggregated by categories and, if these categories have special [[Grade calculations|calculation formulas]] in place, also affects the scores aggregated under the course grade category (course totals).

==Synchronise legacy grades==

All current modules with grading support should be converted to use new gradebook API. Due to performance reasons the grades from legacy modules are not updated automatically, the synchronisation must be done manually by clicking on ''Synchronise legacy grades'' button in each course. '''This action may take a very long time''', depending on the number of activities, grades and participants in your course.

==Easier editing of categories and items==
[[Image:Edit categories and items simple view.png|thumb|Edit categories and items simple view in 1.9.5]]
[[Image:Grade category and item edit.png|thumb|Combined grade category and grade item editing in 1.9.5]]
In Moodle 1.9.5 onwards, a new Edit categories and items page, with simple and full view, enables teachers to move multiple items between categories and quickly edit multiple settings.

Categories can only be moved one at a time, but all their contents are moved as well.

Category aggregation type can be changed instantly (without submitting the form) by changing the selected option in the aggregation dropdown menu.

Contrasting colours indicate category nesting. The categories and grade items are also indented with a cell coloured by the parent category's colour, to make the nesting even clearer.

Extra credit and weight appear in two different columns. If none of the categories have an aggregation type that makes use of either extra credit or weights, these columns are omitted.

Forms for editing grade categories and their associated grade items (e.g. course category and course total) have been combined into one form. This also means that there is no edit icon in the grader report for course and category totals. You just edit the category itself instead.

[[ca:grade/edit/tree/index]]
[[fr:Modifier les catégories et éléments]]
[[ru:Редактирование категорий и элементов оценивания]]

General grade settings

2011-06-14T04:03:02Z

Lasko:

{{Gradebook}}
'''Please refer to [[Page_notes#Gradebook|these notes]] before editing this page.'''
Location: ''Administration > Grades > General settings''

General grade settings allow the site administrator to set site defaults, and to enable or disable the graded roles, outcomes, scales in aggregated grades, publishing grades or unlimiting grades features. These settings are site-wide settings that will affect all [[Gradebook|gradebooks]] used by all teachers.

==Graded Roles==
Graded roles are the type of user that will appear in the gradebook. Sometimes various users will be graded for various purposes. Most of the time "student" is the only one needed.

Grade roles can be found under the Settings Block Site Administration --> Grades --> General Settings

:Note: a site must select '''at least''' one role that can be graded.

==Enable outcomes==
{{Moodle 1.9}}
[[Outcomes]] allow grading of activities according to a "scale", instead of a numeric score. It is new in Moodle 1.9. The default site setting is "no". Check the box to enable this feature. Teachers will now be able to implement outcomes into their gradebooks.

==User profile report==
The default user profile report setting has just one option, [[User report]], unless a custom user report has been added to the site.

User reports are available for teachers via students' profiles by following the grade link in the "Activity reports" tab. Alternatively, teachers can view the user reports for all or selected students in the course by selecting "User report" in the gradebook dropdown menu.

==Aggregation position==
Aggregation position default is either the first or last column.

==Include scales in aggregation==
Scales can be included as numbers in all aggregated grades across all gradebooks in all courses. Changing this setting will force all aggregated grades to be recalculated.

If this is checked (and it is by default) then all custom scales will have a corresponding value that is assigned based on the number of options in the scale (ie. three values will have values of 1,2,3) and this will be included in the grade aggregation.

==Show submitted date for hidden grades==
When a grade is hidden from the user, the default setting shows a dash (-) mark, Enable this to show the date that the grade was submitted rather than a dash for a hidden grade

==Enable publishing==
[[Image:Grade publishing settings.png|thumb|Grade publishing settings]]
Grade publishing is a way of importing and exporting grades via a URL without being logged in to Moodle. Grade publishing is intended for administrators only. Security implications should be thoroughly considered before allowing non-admin users to publish grades.

Grade publishing may be enabled by checking the gradepublishing box. If enabled, administrators are provided with [[Grade export|grade export]] publishing settings in each course gradebook.

==Grade export display type==
This is the default setting for exporting grades. A user may select a different setting.

* Real - Grade from minimum to maximum range indicating total points received. Default from 0-100 but may be arbitrary.
* Percentage - Grade from 0 - 100% indicating the total points received divided by maximum possible amount times 100.
* [[Grade letters|Letter]]- Grade in the form of a letter representing a range of percentages.

Note: Teachers can edit the actual display type right before export.

==Grade export decimal points==

During the export process, this is the default number of decimal places for all grades that is to be shown. Number of decimal places range from 0-5. This number can be changed by the teacher.

==Primary grade export methods==
The default method of export which will show at the time of export. The default is none and that setting forces the user to select one of the export types:

* ods (OpenOffice spreadsheet)
* txt (Plain text file)
* xls (Excel spreadsheet)
* xml (Extensible Markup Language file)

==Navigation method==
[[Image:gradebook tabs navigation.png|thumb|Tabs navigation]]
In some versions of Moodle, tabs navigation of the gradebook may be enabled in addition to/instead of the existing drop down menu in a course.

==Unlimited grades==
In Moodle 1.9.5 onwards, teachers can enter grades over 100% directly in the gradebook if the ''unlimitedgrades'' setting is enabled.

[[Category:Administrator]]

[[es:Ajustes_generales_de_las_calificaciones]]
[[de:Grundeinstellungen_für_Bewertungen]]
[[fr:Réglages généraux des notes]]
[[ja:一般評定設定]]

Grade calculations

2011-06-14T04:01:21Z

Lasko:

{{Gradebook}}
A grade calculation is a formula used to determine grades, based (optionally) on other grade items. Note that this is not the same as [[Calculated_question_type|Calculated question types]].

Calculations for the gradebook follow the pattern of formulas/functions in popular spreadsheet programs. They start with an equal (=) sign, and use common mathematical operators and functions to produce a single numerical output. This output is then used as the computed value for the grade item you are editing.

==Setting a grade calculation==
[[Image:Calc_icon.JPG|thumb|Calculator symbol]]
[[Image:Final_calc.JPG|thumb|Example calculation]]
To set a grade calculation:
# Login as teacher or other user with permission to edit grades
# Click on Grades in the course administration block
# Click the 'Categories and items' tab (or select it from the gradebook dropdown menu)
# Click the 'calculator symbol' (in the 'Actions' column) opposite the grade category you wish to set a calculation for
# Start with an equal sign (=)
# Choose a function; Example: =sum()
# Plug in your ID numbers enclosed in double square brackets, for example <nowiki>=sum([[item1]][[item2]][[item3]])</nowiki>
# Separate each ID number with a comma, for example <nowiki>=sum([[item1]],[[item2]],[[item3]])</nowiki>
# Click the "Save Changes" button

==Assigning ID numbers==

You can include the values of other grade items by using their ID number as references in your formulas. The ID number is surrounded by double square brackets, for example if you have a grade item with Quiz.3 as ID number, you will refer to this item as <nowiki>[[Quiz.3]]</nowiki> in your calculation.

Below the calculation field is a list of your course with its grade categories and grade items. Next to each item or category's total is displayed the ID number you can use in your calculation (already surrounded with double square brackets). However, since the ID number is optional, some items may not yet have one. These items without an ID number have instead a form field which lets you enter an ID number directly.

As soon as you have assigned the ID numbers you need, you can click the "Add ID numbers" button, and the page will reload and show you the same list with the ID numbers you have just assigned.

==Calculation functions==

Every calculation must start with an equal sign (=). Following is a list of the functions supported by the calculation. The comma (,) character is used to separate arguments within function brackets. The comma can also be used to separate different functions. (The separator character could be a semicolon (;) in other languages, see below).

* average<nowiki>([[item1]], [[item2]]...)</nowiki>: Returns the average of a sample
* max<nowiki>([[item1]], [[item2]]...)</nowiki>: Returns the maximum value in a list of arguments
* min<nowiki>([[item1]], [[item2]]...):</nowiki> Returns the minimum value in a list of arguments
* mod(dividend, divisor): Calculates the remainder of a division
* pi(): Returns the value of the number Pi
* power(base, power): Raises a number to the power of another
* round(number, count): Rounds a number to a predefined accuracy
* sum(<nowiki>[[item1]], [[item2]]...)</nowiki>: Returns the sum of all arguments
* an asterisk (*) gives the product of two items: <nowiki>[[item1]]*[[item2]]</nowiki>

A number of mathematical functions is also supported:

* sin
* sinh
* arcsin
* asin
* arcsinh
* asinh
* cos
* cosh
* arccos
* acos
* arccosh
* acosh
* tan
* tanh
* arctan
* atan
* arctanh
* atanh
* sqrt
* abs
* ln
* log
* exp

==Example calculations==

* <nowiki>=average([[Quiz.1]], [[Quiz.4]], [[Assignment.1]])</nowiki>
* <nowiki>=average(max([[Quiz.1]], [[Quiz.4]], [[Assignment.1]]), min([[Quiz.1]], [[Quiz.4]], [[Assignment.1]]))</nowiki>
* Weighted grade calculations where item 1 is weighted 30%, item 2 is weighted at 60% and item 3 is weighted at 200%: <nowiki>=sum([[1]]*0.3,[[2]]*0.6,[[3]]*2)</nowiki>

==Calculations when user language is not English==

Calculation formulas use decimal and list separators as defined in each language pack.

The decimal separator (a symbol used to mark the boundary between the integral and the fractional parts of a decimal number) is a point (.) in English. In other languages it may be a comma (,).

The list separator (a symbol used to separate a list of ID numbers in square brackets) is a comma (,) in English. In other languages it may be a semicolon (;).

==See also==
*[http://www.youtube.com/watch?v=WKUGyzAXcyA Video on how to set up calculations in the gradebook (basic)]
*[http://www.youtube.com/watch?v=VBEj8mmu8lM Video on how to set up calculations in the gradebook (advanced)]

[[ca:grade/edit/tree/calculation]]
[[fr:Calcul de notes]]
[[ru:Формулы и вычисления оценок]]
[[ja:評定計算]]

Plagiarism prevention

2011-06-14T03:45:52Z

Lasko:

{{Copyright and plagiarism}}
'''Please refer to [[Page_notes#Plagiarism prevention|these notes]] before editing this page.'''

Location: ''Administration > Plugins > Plagiarism prevention''

Plagiarism prevention is a method that tries to detect when users cheat by submitting content they have copied instead of writing it themselves.

==Enabling plagiarism prevention==

To make use of plagiarism prevention, the feature must be enabled by an administrator by checking the enable plagiarism plugins box in ''Site administration > [[Advanced features]]''.

==Plagiarism Prevention Plugins==

Plagiarism Prevention plugins currently include:

*[[Plagiarism Prevention Turnitin|Turnitin]] - Integration with the turnitin.com Plagiarism prevention tool
*[[Plagiarism Prevention Crot 2.0|Crot for Moodle 2.0]] - Crot Plagiarism prevention plug-in

==See also==
* [[Development:Plagiarism API]]
* [[Turnitin|Turnitin Plugins for older Moodle versions]]
* [http://code.google.com/p/sunner-projects/wiki/AntiPlagiarismBlock Anti-Plagiarism Block] for Moodle 1.9 - Integration with the [http://theory.stanford.edu/~aiken/moss/ MOSS], an automatic system for determining the similarity of program
* [[Crot 1|Crot Plugin for older Moodle versions]]

Licences

2011-06-14T03:44:23Z

Lasko:

{{Copyright and plagiarism}}
'''Please refer to [[Page_notes#Licences|these notes]] before editing this page.'''

An administrator can enable any/all of the following licences for use when [[Publish a course|publishing a course]]:

* [http://en.wikipedia.org/wiki/All_rights_reserved All rights reserved]
* [http://creativecommons.org/licenses/publicdomain/ Public domain]
* [http://creativecommons.org/licenses/by/3.0/ Creative Commons]
* [http://creativecommons.org/licenses/by-nd/3.0/ Creative Commons - NoDerivs]
* [http://creativecommons.org/licenses/by-nc-nd/3.0/ Creative Commons - No Commercial NoDerivs]
* [http://creativecommons.org/licenses/by-nd/3.0/ Creative Commons - No Commercial]
* [http://creativecommons.org/licenses/by-nc-sa/3.0/ Creative Commons - No Commercial ShareAlike]
* [http://creativecommons.org/licenses/by-sa/3.0/ Creative Commons - ShareAlike]
* Other - licence not already listed

[[Category:Hub]]

[[de:Lizenzen]]

Picasa portfolio

2011-06-14T03:40:59Z

Lasko: Created page with "{{Portfolios}} '''Please refer to these notes before editing this page.'''"

{{Portfolios}}
'''Please refer to [[Page_notes#Portfolios|these notes]] before editing this page.'''

Flickr.com portfolio

2011-06-14T03:38:21Z

Lasko: Created page with "{{Portfolios}} '''Please refer to these notes before editing this page.'''"

{{Portfolios}}
'''Please refer to [[Page_notes#Flickr|these notes]] before editing this page.'''

File download portfolio

2011-06-14T03:37:17Z

Lasko: Created page with "{{Portfolios}} '''Please refer to these notes before editing this page.'''"

{{Portfolios}}
'''Please refer to [[Page_notes#Portfolios|these notes]] before editing this page.'''

Box.net portfolio

2011-06-14T03:35:24Z

Lasko:

{{Portfolios}}
'''Please refer to [[Page_notes#Portfolios|these notes]] before editing this page.'''
===Obtaining an API key===

Visit http://enabled.box.net and register a developer account. You can then navigate to My projects, and create a new one. For all the settings, Moodle doesn't care what you put in '''except''' for the callback url, which should be $CFG->wwwroot/portfolio/add.php?postcontrol=1. Box.net will append the relevant authentication tokens to the url (detecting it already contains ? and everything already)

[[Category:Portfolios]]

Portfolios

2011-06-14T03:34:55Z

Lasko:

{{Portfolios}}
'''Please refer to [[Page_notes#Portfolios|these notes]] before editing this page.'''

Portfolios in Moodle 2.0 onwards enable data, such as forum posts or assignment submissions, to be exported to external systems.

Portfolios in Moodle 2.0 video:

<mediaplayer>http://www.youtube.com/watch?v=Ic2j6esjPR8</mediaplayer>
==Enabling portfolios==

Enabling the use of portfolios is a 2-step process for an administrator:

# Check the enableportfolios box in ''Site Administration > [[Advanced features]]''
# Enable selected portfolio plugins in ''Site Administration > Plugins > Portfolios > Manage portfolios''

==Portfolio plugins==

Portfolio plugins available in Moodle 2.0 include:

* [[Box.net portfolio plugin|Box.net internet storage]]
* File download
* Flickr online photo management system
* Google Docs
* [[Development:Mahara Portfolio Plugin|Mahara ePortfolio]]
* Picasa

==Using portfolios==
#When portfolios are enabled, forum posts and other exportable data (see below) have a save link beside them.
#User clicks one of these buttons.
#User is able to choose from a list of configured portfolios (this step will be skipped if there's only one).
#User may be asked to define the export format of the captured content e.g. HTML, images and text.
#User may be asked to define some metadata to go with the captured content (some will be generated automatically).
#The content and metadata is COPIED to the external portfolio system.
#User has the option to return to the page they were previously viewing or visit the their portfolio (certain portfolios only).

==Export formats==

Possible export formats include
* HTML
* [[Development:LEAP2A_Portfolio_Implementation|LEAP2A]], a specification for e-portfolio portability
* Images
* Text

Additional formats such as PDF can be added.

==Exportable data==

* Assignment submissions - single and multiple file uploads
* Chat sessions
* Database activity module entries (##export## tag may be added to list and single templates)
* Database activities
* Forum posts
* Glossary entries

==See also==

*[[Portfolios FAQ]]
*[[Development:Portfolio API]]
*MDL-14591 - META: Develop new Portfolio API

[[Category:Portfolios]]

[[eu:Portfolioak]]

Template:Portfolios

2011-06-14T03:34:09Z

Lasko:

<div class="sideblock right" style="width: 18em;">
<div class="header">[[Portfolios]]</div>
<div class="content">
* [[Box.net portfolio plugin|Box.net]]
* [[File download]]
* [[Google Docs]]
* [[Flickr]]
* [[Picasa]]
* [[Mahara|Mahara ePortfolio]]
* [[Custom external portfolios]]

{{Managing content}}
</div>
</div>

<includeonly>[[Category:Portofolios]]</includeonly>
<noinclude>This template will categorize articles that include it into [[:Category:Portfolios]].</noinclude>

Portfolios

2011-06-14T03:29:00Z

Lasko:

{{{Portfolios}}
'''Please refer to [[Page_notes#Portfolios|these notes]] before editing this page.'''

Portfolios in Moodle 2.0 onwards enable data, such as forum posts or assignment submissions, to be exported to external systems.

Portfolios in Moodle 2.0 video:

<mediaplayer>http://www.youtube.com/watch?v=Ic2j6esjPR8</mediaplayer>
==Enabling portfolios==

Enabling the use of portfolios is a 2-step process for an administrator:

# Check the enableportfolios box in ''Site Administration > [[Advanced features]]''
# Enable selected portfolio plugins in ''Site Administration > Plugins > Portfolios > Manage portfolios''

==Portfolio plugins==

Portfolio plugins available in Moodle 2.0 include:

* [[Box.net portfolio plugin|Box.net internet storage]]
* File download
* Flickr online photo management system
* Google Docs
* [[Development:Mahara Portfolio Plugin|Mahara ePortfolio]]
* Picasa

==Using portfolios==
#When portfolios are enabled, forum posts and other exportable data (see below) have a save link beside them.
#User clicks one of these buttons.
#User is able to choose from a list of configured portfolios (this step will be skipped if there's only one).
#User may be asked to define the export format of the captured content e.g. HTML, images and text.
#User may be asked to define some metadata to go with the captured content (some will be generated automatically).
#The content and metadata is COPIED to the external portfolio system.
#User has the option to return to the page they were previously viewing or visit the their portfolio (certain portfolios only).

==Export formats==

Possible export formats include
* HTML
* [[Development:LEAP2A_Portfolio_Implementation|LEAP2A]], a specification for e-portfolio portability
* Images
* Text

Additional formats such as PDF can be added.

==Exportable data==

* Assignment submissions - single and multiple file uploads
* Chat sessions
* Database activity module entries (##export## tag may be added to list and single templates)
* Database activities
* Forum posts
* Glossary entries

==See also==

*[[Portfolios FAQ]]
*[[Development:Portfolio API]]
*MDL-14591 - META: Develop new Portfolio API

[[Category:Portfolios]]

[[eu:Portfolioak]]

YouTube videos repository

2011-06-14T03:18:57Z

Lasko: Created page with "{{Repositories}} '''Please refer to these notes before editing this page.'''"

{{Repositories}}
'''Please refer to [[Page_notes#Youtube videos|these notes]] before editing this page.'''

WebDAV repository

2011-06-14T03:15:13Z

Lasko:

{{Repositories}}
'''Please refer to [[Page_notes#WebDAV repository|these notes]] before editing this page.'''

Web-based Distributed Authoring and Versioning (WebDAV) is a set of methods based on the Hypertext Transfer Protocol (HTTP) that facilitates collaboration between users in editing and managing documents and files stored on World Wide Web servers.

A WebDAV repository can be enabled by an administrator in ''Site administration > Modules > Repositories > Manage repositories''.

==WebDAV configuration==

[[Image:Webdav config.png|thumb|WebDAV configuration]]After enabling the WebDAV repository, a repository instance can be created in ''Site administration > Modules > Repositories > WebDAV repository''.

===Options===
WebDAV type: Choose from HTTP or HTTPS connection

WebDAV server: The server name

WebDAV path: The path to webdav directory

Authentication: We currently only support HTTP Basic Authentication

WebDAV server port: The webdav server port

WebDAV server user: HTTP Basic authentication username

WebDAV server password: HTTP Basic authentication password

For example, if you are going to added an webdav server at http://webdavserver.tld/path/to/dir, you should use following options:
WebDAV type: HTTP
WebDAV Server: webdavserver.tld
WebDAV path: /path/to/dir/

==See also==

* MDL-22663

[[Category:Repositories]]
[[de:WebDAV Repository]]

URL downloader repository

2011-06-14T03:14:36Z

Lasko:

{{Repositories}}
'''Please refer to [[Page_notes#Repositories|these notes]] before editing this page.'''

URL Downloader plugin is used to obtain resources by providing a url to webpage or file.

If user provides a html web page, Moodle will parse the web page to list all images used in web page.

If user provides a link to file, Moodle will try to download this file no matter what type it is.

Upload a file repository

2011-06-14T02:57:02Z

Lasko: Created page with "{{Repositories}} '''Please refer to these notes before editing this page.'''"

{{Repositories}}
'''Please refer to [[Page_notes#Upload a file|these notes]] before editing this page.'''

Server files repository

2011-06-14T02:56:38Z

Lasko: Created page with "{{Repositories}} '''Please refer to these notes before editing this page.'''"

{{Repositories}}
'''Please refer to [[Page_notes#Server files|these notes]] before editing this page.'''

Recent files repository

2011-06-14T02:53:35Z

Lasko: Created page with "{{Repositories}} '''Please refer to these notes before editing this page.'''"

{{Repositories}}
'''Please refer to [[Page_notes#Recent files|these notes]] before editing this page.'''

Picasa web album repository

2011-06-14T02:52:48Z

Lasko: Created page with "{{Repositories}} '''Please refer to these notes before editing this page.'''"

{{Repositories}}
'''Please refer to [[Page_notes#Picasa web album|these notes]] before editing this page.'''

Merlot.org repository

2011-06-14T02:51:42Z

Lasko: Created page with "{{Repositories}} '''Please refer to these notes before editing this page.'''"

{{Repositories}}
'''Please refer to [[Page_notes#Repositories|these notes]] before editing this page.'''

Mahara portfolio

2011-06-14T02:44:48Z

Lasko:

{{Repositories}}
'''Please refer to [[Page_notes#Mahara|these notes]] before editing this page.'''

From the [http://www.mahara.org/ Mahara web site]:

"Mahara is an open source e-portfolio, weblog, resume builder and social networking system, connecting users and creating online learner communities. Mahara is designed to provide users with the tools to demonstrate their life-long learning, skills and development over time to selected audiences."

It has close links with Moodle. There is a built in single sign on facility called [[Mahoodle]]. Future versions of Moodle will have even closer ties as the [[Development:Mahara Portfolio Plugin|Mahara Portfolio Plugin]] development progresses.

A short manual for a Mahara installation networked to Moodle 1.9 can be found [http://moodle.tokem.fi/mod/book/view.php?id=50979 HERE].

[[Category:Mahara]]

[[eu:Mahara]]

Google Drive repository

2011-06-14T02:44:00Z

Lasko: Created page with "{{Repositories}} '''Please refer to these notes before editing this page.'''"

{{Repositories}}
'''Please refer to [[Page_notes#Google Docs|these notes]] before editing this page.'''

Flickr public repository

2011-06-14T02:43:28Z

Lasko:

{{Repositories}}
'''Please refer to [[Page_notes#Flickr public repository configuration|these notes]] before editing this page.'''

Location: ''Administration > Modules > Repositories > Manage repositories''

This page lets you configure access to a Flickr Public repository. It will allow a user to search Flickr and copy files from there into any of the Moodle file interfaces.

To set this repository up you need to set the following field:
*API Key

==Setting up a Flickr API==
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.
#Click the "Get Another Key" button to start creating your App. [[Image:get-another-key.png]]
#Choose "Apply for a Non-commercial Key"
#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)
#Tick the two boxes to show your agreement to Flickr's terms of use and then click submit.
#You will now have the key for the new app. Copy and paste this into the field in your Moodle Flickr public configuration page.
#Click save on the Moodle Flickr public configuration page.
#Click "Save Changes"

You should now have a working Flickr public repository. Try adding a file from Flickr as a resource in Moodle to test it!

==See Also==
*[[Manage_repositories|Manage Repositories]]
*[[Flickr_configuration|Flickr Repository]]

[[Category:Repositories]]

[[eu:Flickr_publikoaren_ezarpenak]]
[[de:Flickr Public Repository]]

Flickr repository

2011-06-14T02:42:43Z

Lasko:

{{Repositories}}
'''Please refer to [[Page_notes#Flickr repository configuration|these notes]] before editing this page.'''

Location: ''Administration > Modules > Repositories > Manage repositories''

This page lets you configure access to a Flickr repository. It will allow a user to log into their Flickr account and copy files from their account into any of the Moodle file interfaces.

To set this repository up you need to set the following two fields:
*API Key
*Secret

==Setting up a Flickr API==
To get your API Key and Secret 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 and secret.
#Click the "Get Another Key" button to start creating your App. [[Image:get-another-key.png]]
#Choose "Apply for a Non-commercial Key"
#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)
#Tick the two boxes to show your agreement to Flickr's terms of use and then click submit.
#You will now have the key and secret for the new app. Copy and paste these into the fields in your Moodle Flickr configuration page.
#Click save on the Moodle Flickr configuration page.
#Revisit the settings of your Flickr repository in Moodle and copy the callback URL from that page.
#Revisit your Flickr App page and click on the "Edit Auth Flow for this App" link
#Paste the URL from your Moodle page into the Callback URL field on your Flickr App
#Click "Save Changes"

You should now have a working Flickr repository. Try adding a file from your Flickr account as a resource in Moodle to test it!

==See Also==
*[[Manage_repositories|Manage Repositories]]
*[[Flickr_Public_Configuration|Flickr Public Repository]]

[[Category:Repositories]]

[[eu:Flickr ezarpenak]]
[[de:Flickr Repository]]

File system repository

2011-06-14T02:41:25Z

Lasko:

{{Repositories}}
'''Please refer to [[Page_notes#File system repository configuration|these notes]] before editing this page.'''

==How to use the filesystem as a repository==

This module allows you to share any of the sub-directories found in $CFG->dataroot/repository as a browseable repository inside Moodle.

It needs to be configured by a system administrator, because it requires write access to the system disk.

Here is [http://moodle.drupalgardens.com/article/tue-06152010-1918/ftp-files-moodle-20-repository-api a video] that may be helpful.

===1. Create some folders to be repositories===

Inside your "Moodledata" directory (the one where all your data is stored), create one called "repository".

Inside that, make one folder for each repository you want to create. Short, simple, one-word names are best, I'm going to use "clipart" as my example.

Inside your "clipart" folder put your files (in this example it could be hundreds of useful images that you got from [http://www.openclipart.org/ openclipart.org]).

Note that these directories can be ANYTHING your operating system supports. You could mount a whole hard drive there, or mount a shared Windows network drive via SAMBA. You could have a symbolic link to a directory that allows FTP access. The sky is the limit here for a creative Moodle admin!!

===2. Enable the File System repository plugin===

You do this in the Settings block, under Site Administration > Plugins > Repositories > Manage repositories >File system.

Once enabled, click on the "Settings" link beside it.

Alternatively, you will now see "File system" in the list of links in Plugins > Repositories. Click on this link, will also take you to the settings page.

===3. (Optional) Set up the personal repositories===
Still in the File system settings page:
You can safely ignore the settings at the top. These are for rare cases where you want to allow users to create their own virtual repositories from the filesystem, either for themselves or a course.

===4. Create some actual usable repositories (instances)===
In settings at the bottom of the page
# Click on "Add a repository instance".
# Give it a name. The name will display in the [[File picker]] interface with the other repository areas.
# Choose the appropriate subdirectory from the list.
# Click save

===5. Check permissions===

Although permissions should be on by default, you may have to check the roles and make sure that the "Authenticated User" role (or some other role, if you have set up a special one) has the "repository/filesystem:view" capability allowed.

(If you are using 2.0 Preview 1 then this was not on by default)

===6. Use it!===

Everything should be working. If you try to add a file in Moodle, then the File Picker should show you your new file system repository, and you should be able to browse it and select files to use.

Note that file types are respected (based on file extensions), so if you are adding an image in the editor, then you won't see Office docs (for example) appear in the File Picker.

[[Image:Repository-filesystem-filepicker.png]]

==FAQ==
===How do the files get into the File system repository?===
#Get your person with server access to copy them in
#Set up FTP
===Is there a way to upload files to a File system repository from inside Moodle?===
If you are talking about core (vanilla) Moodle: not at the moment

==See also==
* Overview of [[Repositories|Repositories]]
* [http://moodle.drupalgardens.com/article/tue-06152010-1918/ftp-files-moodle-20-repository-api FTP files into Moodle 2.0 with the repository API article from moodle.drupalgardens.com] including screencast

[[Category:Repositories]]
[[de:Dateisystem-Repository]]

Dropbox repository

2011-06-14T02:40:43Z

Lasko:

{{Repositories}}
'''Please refer to [[Page_notes#Repositories|these notes]] before editing this page.'''

A Dropbox repository can be enabled by an administrator in ''Site administration > Modules > Repositories > Manage repositories''.

==Sign up app keys at dropbox==

# Go to https://www.dropbox.com/developers/apps
# Create an app, you must change app status to Production. This feature is only availble for new API developers, but not for Moodle repository users. See MDL-26949
# Copy the app keys

==Configuration==
Once enabled by the administrator a Dropbox API Key and Secret will need to be added to the Dropbox settings in order for it to work. This will be ''the'' Dropbox available to all users throughout the site (and each will need the correct Dropbox login credentials to access it from their courses). To gather the Dropbox API Key and Secret click the "Dropbox Developers" link on the Dropbox repository settings page. On the next page you'll be prompted to login with your Dropbox username and password and to create a Dropbox app.

Once the App has been created at Dropbox.com you'll have the API Secret and Key available at the bottom of the App page. Entering those on the Dropbox settings page (and clicking Save) back in Moodle will finish the configuration. Dropbox is now available to the entire site.

To access it editing teachers need only "Add..." a new file while editing or creating a resource to see Dropbox as a new option.

==See also==

* [http://www.youtube.com/watch?v=V221JLCywWs Import files from Dropbox into Moodle 2.0 video]
* MDL-19168
* MDL-26949 - Can't change the Dropbox API key and secret to production status

[[Category:Repositories]]
[[de:Dropbox]]

Box.net repository

2011-06-14T02:40:18Z

Lasko:

{{Repositories}}
'''Please refer to [[Page_notes#Repositories|these notes]] before editing this page.'''

Location: ''Administration > Modules > Repositories > Manage repositories''

[[Category:Repositories]]

===Obtaining an API key===

Create a Box.net account at http://www.box.net/.

Visit http://www.box.net/developers/api. Click on Start developing, then Create new application, fill out the form and 'Save service' to get your API key. For all the settings, Moodle doesn't care what you put in.

[[eu:Box.net_ezarpenak]]
[[de:Box.net Repository]]

Amazon S3 repository

2011-06-14T02:39:48Z

Lasko: Created page with "{{Repositories}} '''Please refer to these notes before editing this page.'''"

{{Repositories}}
'''Please refer to [[Page_notes#Repositories|these notes]] before editing this page.'''

Alfresco repository

2011-06-14T02:39:27Z

Lasko:

{{stub}}{{Repositories}}
'''Please refer to [[Page_notes#Repositories|these notes]] before editing this page.'''

An Alfresco repository can be enabled by an administrator in ''Administration > Modules > Repositories > Manage repositories''.

[[Category:Repositories]]

Repositories

2011-06-14T02:18:33Z

Lasko:

{{Repositories}}
'''Please refer to [[Page_notes#Repositories|these notes]] before editing this page.'''

The repository feature in Moodle 2.0 onwards allows a site administrator to [[Manage repositories|manage site folders]] in the "[[Moodledata directory]]" from Site administration > Plugins > Repositories. Repositories appear in [[File picker]] for the users. Users can browse external repositories.

The Moodle 2.0 File picker standard install will show Server files, Upload files and Private files repositories along with the contextual Upload files and Recent files links. Moodle comes with 15 other hidden repositories which can be turned on and renamed if required by the site administrator.

Repositories in Moodle 2.0 video:

<mediaplayer>http://www.youtube.com/watch?v=zdrdyev82bU</mediaplayer>

==Vocabulary==
'''Repository plugin''': it is also called a repository type. It can be named Box.net, Flickr, Mahara, Youtube... Adding a plugin allow users to create instances of this plugin. Only instances are displayed into the file picker. Type only exist in order to let a Moodle administrator to deactivate/delete all instances of a type in one click.

'''Repository instance''': An instance is displayed into the file picker and it is the access point to an external repository. An instance can have specific settings (for example be linked to a personal account).

*First case: when you add the plugin, an instance is automatically created and can not be edited. The Moodle administrator cannot change the instance name. The instance name displayed into the file picker will be exactly the same as the plugin name. For example Youtube, Box.net...
*Second case: the plugin allow the Moodle administrator to add multiple instances. An instance has a name for example Flickr Public access to Martin account, Martin's Mahara... For this second case it is important to identify two different kind of instances:
#Common instances: The instances set by Moodle administrator in these same administration pages will be available into any file picker.
#Private instance: A teacher can set some instances available only for a course, and an user can set some instances only available for himself. In order to set instances for a course the teacher will go to the course page, and in order to set instances for a personal use, a user will go on his profile page. An administrator cannot add/edit private instances from the administration pages.

Import files from Dropbox into Moodle 2.0 video:

<mediaplayer>http://www.youtube.com/watch?v=V221JLCywWs</mediaplayer>
==Enabling repositories==

Repositories can be enabled by an administrator in ''Site administration > Plugins > Repositories > Manage repositories''.

A repository plugin may be set to

* Enabled and visible - appears in the file picker
* Enabled and hidden
* Disabled - default setting

The order in which repositories are shown in the file picker may be set using the up and down arrows.

==Available repository plugins==

*Upload a file
*Server files
*Recent files
*[[Private files]]
*[[Alfresco repository]]
*[[Box.net repository configuration|Box.net]]
*[[Legacy course files]]
*[[Dropbox]]
*[[File system repository configuration|File system]]
*[[Flickr repository configuration|Flickr]]
*[[Flickr public repository configuration|Flickr public]]
*Google Docs
*Merlot.org
*Picasa web album
*Amazon S3
*URL Downloader
*[[WebDAV repository]]
*Wikimedia
*Youtube videos

==Contributed repository plugins==

Additional repository plugins may be installed, such as

*[http://moodle.org/mod/data/view.php?d=13&rid=2611 Riffly] audio-only or audio-video recording
*[http://moodle.org/mod/data/view.php?d=13&rid=2612 Nanogong] audio recording
*Mahara (see MDL-21993)

==See also==

* [[Repositories FAQ]]
* [http://moodle.drupalgardens.com/article/tue-06152010-1918/ftp-files-moodle-20-repository-api FTP files into Moodle 2.0 with the repository API]

[[Category:Repositories]]

[[eu:Biltegiak]]
[[de:Repositories]]
[[fr:Dépôts]]

Template:Repositories

2011-06-14T02:16:42Z

Lasko:

<div class="sideblock right" style="width: 18em;">
<div class="header">[[Repositories]]</div>
<div class="content">
* [[Alfresco repository|Alfresco]]
* [[Amazon S3]]
* [[Box.net_repository_configuration|Box.net]]
* [[Dropbox]]
* [[File_system_repository_configuration|File system]]
* [[Flickr repository configuration|Flickr]]
* [[Flickr Public Configuration|Flickr public]]
* [[Google Docs]]
* [[Legacy course files]]
* [[Mahara]]
* [[Merlot.org]]
* [[Picasa web album]]
* [[Private files]]
* [[Recent files]]
* [[Server files]]
* [[Upload a file]]
* [[admin/repository/url|URL Downloader]]
* [[WebDAV repository|WebDAV]]
* [[Youtube videos]]
* [[Custom external repositories]]

{{Managing content}}
</div>
</div>

<includeonly>[[Category:Repositories]]</includeonly>
<noinclude>This template will categorize articles that include it into [[:Category:Repositories]].</noinclude>

Word censorship filter

2011-06-14T02:15:00Z

Lasko:

{{Filters}}
'''Please refer to [[Page_notes#Filters|these notes]] before editing this page.'''

Location: Word Censorship settings link in ''Administration > Modules > Filters''

The word censorship filter enables certain user-selected words to be "blacked out" in the flow of the text. The primary use is for censoring obscene or other unwanted words in the text.

In Moodle 1.6 onwards, the word censorship settings page allows the administrator to edit a list of words via a web interface. For backwards compatibility, the old list in the language pack is retained and will be used if the list on the settings page is empty. To avoid inadvertently causing offence, there is no default list on the settings page.

==Previous word censorship==

Prior to Moodle 1.6, the list of words is contained in the language pack in the file ''censor.php'' (Example: for German use ''lang/de/censor.php''). To change the word list you need to directly edit this file. A default list is provided for many languages. Warning: You may find the content of this file offensive.

==See also==

*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=79711 filtering profanity] forum discussion

[[Category:Filter]]

[[es:Palabras censuradas (filtro)]]
[[fr:Filtre censure de mots inadéquats]]
[[ja:ワードセンサーシップ]]

TeX notation

2011-06-14T02:14:33Z

Lasko:

{{Filters}}
'''Please refer to [[Page_notes#Filters|these notes]] before editing this page.'''
'''TeX notation''' is a popular method of representing complicated typesetting of the kind needed for advanced mathmatical equations using simple text conventions. Various software programs, including the [[TeX Filter]] for Moodle can turn this text format into a graphical depiction.

For more information about using Tex look at [[Using TeX Notation]].

== See also ==

* [http://en.wikipedia.org/wiki/TeX Wikipedia article on TeX]

Multi-language content filter

2011-06-14T02:14:08Z

Lasko:

{{Filters}}
'''Please refer to [[Page_notes#Filters|these notes]] before editing this page.'''

The Multi-language content filter enables resources to be created in multiple languages. When turned on, it looks for <nowiki></nowiki> tags which indicate that a text contains multiple languages. Then it selects and outputs the best language for the current user. The language of the resource will change when the user changes their selected Moodle language.

The multilang syntax was changed in 1.8. <nowiki><lang></nowiki> is not supported any more. It is required to add ''class="multilang"'' into each <nowiki></nowiki> tag in multilang block. The new syntax is backwards compatible with old plugins, which means it can be used in older Moodle version.

== How to use in a course ==

To use this feature first create your contents in multiple languages (in the same resource). Then enclose each language block (aka multilang block) in the following tags:

<nowiki>your_content_here
your_content_in_other_language_here</nowiki>

It is essential to be in '''the code editing mode''' (press <nowiki>[<>]</nowiki> in the HTML editor), when you enter these tags for them to work. Only spaces, tabs and enters can be used between the individual languages in the multilang block. Please note that ''class="multilang"'' is not required prior to 1.8. There is a lang drop-down markup tool in the HTML editor in later versions of Moodle. The first versions, at least to 1.8.2, do not make "multilang" language tags. If you are working in a sufficiently new version of the HTML editor you can add these tags without going to the code editing mode. If something doesn't work properly you should check how the markup looks in code mode.

Following code
<nowiki><lang="XX">your_content_here</lang>
<lang="YY">your_content_in_other_language_here</lang></nowiki>
does NOT work.

The obsoleted HTML tagging
<nowiki><lang lang="XX">your_content_here</lang>
<lang lang="YY">your_content_in_other_language_here</lang>

your_content_here
your_content_in_other_language_here</nowiki>
will not work in 1.8 and later. In 1.8 the lang attribute without ''class="multilang"'' can be used to mark the language of the text - see http://www.w3.org/TR/html4/struct/dirlang.html

== How it works internally ==

# Filter first looks for ''multilang blocks'' in the text
# For each multilang block:
#* If there are texts in the currently active language, print them
#* Else, if there exists texts in the current parent language, print them
#* Else, print the first language found in the text
# Text outside of multilang blocks will be shown always

==Course summary and title tags==

To be able to change text such as resource titles and summaries, an administrator must choose ''Filter all strings'' in the site administration.

<nowiki> Matematically Matematiskt (svenska)</nowiki>
functions as English or Swedish title.

It doesn't work for course titles and site names (neither long nor short version) in some versions of Moodle. At least from 1.8.2 long course titles and site name, both full and breadcrumb were multilang filtered.

In the course summary:

<nowiki>Growth is often a major concern in planning society.
How can one avoid superficial conclusions? 
(Exists in Swedish too. Finns på svenska också)
Tillväxt är ofta använt i samhällsdebatten.
Hur kan man undvika ytliga slutsatser?
(Finns på engelska också. Exists in English too.)
 </nowiki>

Can show in the chosen language (and point out that the other language is there). Please note that ''class="multilang"'' is not required prior to Moodle 1.8.

== Translations with tags ==
If you wish to translate a word or phrase in an English text to another language:

<nowiki>If I want to include an explanation 
(sv: förklaring) in a running text
can I do it?</nowiki>
or
<nowiki>If I want to include an explanation
in a running text can I do it? 
If I want to include an explanation (sv:
förklaring) in a running text can I do it?</nowiki>

would both work, but not:

<nowiki>If I want to include an explanation 
(sv: förklaring) in a running text
can I do it?</nowiki>
or
<nowiki>If I want to include an explanation 
(sv: förklaring) in a running text can I do it?</nowiki>
which would show the Swedish even if English was the chosen language. NOTE that before 1.8 the "span lang=en" must contain something, at least a space.

== New multilang syntax ==
{{Moodle 1.8}}
* <nowiki> and <lang></nowiki> should not be used anymore
* Existing content can be upgraded using the admin/multilangupgrade.php script, there is a link in the admin notification page if a multilang upgrade is required.
* The multilang filter can be configured to use old syntax only - see ''Multi-Language Content Settings''; this setting may be removed in 1.9
* New syntax is forced during a new 1.8 installation, for upgraded sites the new syntax is enabled after the multilang upgrade

== Common problems ==

* The multilang filter is not enabled. The administrator for the Moodle site you are using must go to Site administration> modules> Multilanguage Content and enable it (by clicking on the "eye")
* ''Filter all strings'' not enabled on sites that need multilang in titles, navigation, headings, etc. The administrator for the Moodle site you are using must go to Site administration> appearance> Filter settings and set a check in "filter alll strings". This will increase server load slightly, so don't do it unless you really need it.
* Extra characters between language span tags - editor might add <nowiki> </nowiki> or other tags, please review the html in source view
* If the course setting is "force" some language, you won't be able to change the displayed language.
* Extra spaces in language span tag
* Can not easily access language choice dropdown! Unfortunately you must go to the site homepage or your own profile to change the displayed language. Want a change? see [http://tracker.moodle.org/browse/MDL-11531 MDL-11531]. It is possible to manually quickly change displayed lang by editing the URL in the browsers address bar. See Tips and tricks below!

==Tips and tricks==
===Lang dropdown in HTML editor===
In later versions of Moodle there is a lang dropdown in the HTML editor that can be used to do multilang markup. You may have to go to the "edit source" mode (with the ['''<>'''] button) to check, and maybe correct, how things turned out.
===Changing language displayed without going to front page===
It is possible to change the displayed language by manually changing the link.
*Here is the default language page at id=2306. This link is in English, the default language:
:http://moodle.org/mod/resource/view.php?id=2306
*The link to change the page display to Spanish is
:http://moodle.org/mod/resource/view.php?id=2306&lang=es ,
*When the default language is an other language, to change the page to an English version, the link would be:
:http://moodle.org/mod/resource/view.php?id=2306&lang=en

Thusly, with a bit of editing, you can manually change the displayed language by adding "&lang=xx" to the URL in the location bar of the browser. Where xx is the abbreviation for the language you want.

===Bandwidth-adaptivity===
One inventive fellow has made a hack to use the multilang filter to be able to adapt the sent content to a users chosen bandwidth. Especiallly international courses can have users with extremely varied Internet connection speeds and this can allow them to chose what level of content (Low = text and small pictures, medium = some mp3, high = some video and other heavy stuff) suits them.
[http://paaralan.blogspot.com/2009/08/hack-bandwidth-adaptivity-for-moodle.html the blog with description and downloads]

== See also ==

*[[Filters|Filters administration]]
Using Moodle forum discussions:

*[http://moodle.org/mod/forum/discuss.php?d=51603 Multilanguage filter - does not work ...]
*[http://moodle.org/mod/forum/discuss.php?d=74340 Problems with multilang filter and SPAN tags]
*[http://moodle.org/mod/forum/discuss.php?d=94006 Multilingual Content]
*[http://moodle.org/mod/forum/discuss.php?d=95134 Multilingual VS HTML editor]

[[Category:Teacher]]
[[Category:Filter]]
[[Category:Language]]

[[es:Filtros (Administrador)]]
[[fr:Contenu multilingue]]
[[ja:多言語シンタックス]]

Multimedia plugins filter

2011-06-14T02:13:42Z

Lasko:

{{Filters}}
'''Please refer to [[Page_notes#Filters|these notes]] before editing this page.'''

Location: Multimedia Plugins settings link in ''Site administration > Modules > Filters > Manage filters''

The Multimedia plugins filter finds URLs that point to multimedia resources in text and replaces them with an appropriate multimedia player.

== Supported media formats ==
* .mp3 - MPEG Audio Stream, Layer III
* .swf - Macromedia Flash Format File (Adobe, Inc.)
* .mov - QuickTime Video Clip (Apple Computer, Inc.)
* .wmv - Windows Media File (Microsoft)
* .mpg - MPEG Animation
* .avi - Audio Video Interleave File
* .flv - Flash Video File (Macromedia, Inc.)
* .ram - RealMedia Metafile (RealNetworks, Inc.)
* .rpm - RealMedia Player Plug-in (RealNetworks)
* .rm - RealMedia Streaming Media (Real Networks, Inc.)
* .mp4 (in Moodle 1.9.6 onwards)
* .m4v (in Moodle 1.9.6 onwards)
* .ogg (in Moodle 2.0 onwards)
* .ogv (in Moodle 2.0 onwards)

In Moodle 1.9.6 onwards, a YouTube link filter (disabled by default) is also available.

== Usage ==

Insert the URL of the multimedia resource into your text (which can be the URL of a file in the course files area). When displayed a suitable player will be provided. Moodle detects the media type using the filename extension, so you should ensure that the file contents match the extension correctly.

For some file types, like Flash, you can size the plugin using an extended syntax:

<a href="somepath.swf?d=640x480">My link name</a>

where the first number is the width in pixels, and the second is the height.

== Required Software ==

Although Moodle prepares the media files to be played in the browser, the actual playback is handled by various types of browser plug-in software, primarily Adobe Flash, Quicktime, Windows Media Player and Real Player. If users do not have these installed they may be prompted to go and install them by their browser. These pieces of software are generally free, easily installed and widely used so this will only be an issue for small numbers of users.

== Settings page ==
The settings page is in the administration block. Prior to version 1.7, this can be reached from ''Configuration > Filters > MultiMedia Plugins''. In 1.7 it can be found via ''Administration > Modules > Filters > MultiMedia Plugins''. In 1.8 it can be found via:
''Notifications > Modules > Filters > MultiMedia Plugins > Settings''.

There is an individual setting to turn on or off each supported media type. Note that by default all but the Flash (.swf) filter are enabled. As Flash files present a theoretical security risk, it is strongly recommended not to allow users to add flash content.

== YouTube Link Filter ==

The youtube filter uses a custom delimiting tag inserted anywhere within the text of a resource to embed and display an embedded youtube player
without having to paste the embed code into the HTML of the page. It is also designed to ignore youtube links placed in standard <a href> tags.

* Enable the filter from the administration menu in Moodle: Modules -> Filters -> Manage filters.
* To embed the youtube video, create a standard <code><a href="..."></code> link to the YouTube video page
* The filter strips out additional php GET parameters
* Multiple links can be placed within a page.

Examples:
*This is some text of a page.<code><a href="http://www.youtube.com/watch?v=zs2XiyLYJOo">Nice video</a></code> This is some more text in a page.
*This is some text of a page.<code><a href="http://www.youtube.com/watch?v=zs2XiyLYJOo#d=600x400"></a></code> This is some more text in a page.

==FAQ Media and Moodle 2+==

UPDATE: see http://tracker.moodle.org/browse/MDL-26697 Lots of work on the Media management --[[User:Derek Chirnside|Derek Chirnside]] 21:27, 6 March 2011 (UTC)

The following issues are fixed in Moodle 2.0.3 (MDL-26697):

Bug fixes:
* fixed broken flash resizing via URL
* upgraded Flowplayer
* fixed invalid context in format_text()
* all media related CSS moved from themes to filter and resources
* fixed automatic pdf resizing in resources

Changes:
* reworked filter_mediaplugin system settings - grouped by player type instead of individual extensions, added more information
* improved regex url matching
* removed old unused players, Eolas fix and UFO embedding
* image embedding moved to filter_urltolink
* new Flowplayer embedding API
* accessibility and compatibility tweaks in Flowplayer
* SWF embedding now works only in trusted texts, it is now enabled by default (works everywhere if "Allow EMBED and OBJECT tags" enabled)
* new default video width and height

New features:
* automatic Flash video resizing using information from video metadata
* Flash HD video support (*.f4v)
* Flash video embedding with HTML5 fallback - compatible with iOS and other mobile devices
* Vimeo embedding
* no-cookie YouTube site supported
* HTML 5 audio and video with multiple source URLs and QuickTime fallback
* more video and audio extensions in filelib.php
* MP3 player colours customisable via CSS in themes
* nomediaplugin class in a tag prevents media embedding

===What is the best way of Embedding media in Moodle?===
Sizing of windows in a popup to match media, or of the embed is a problem. Access to the right quality of player often means adding more code. At present Flowplayer is used. ?d=640x480 doesn't work any more.
#Interesting discussion on Moodle Mahem list: https://groups.google.com/forum/?pli=1#!topic/moodlemayhem/txt_5pNwATk
#Playing Flash FLV & SWF in MOODLE 2.0: http://moodle.org/mod/forum/discuss.php?d=163374
#What about SWF? There have been some security worries on using SWF. But tha advantage is that it comes with a player bundled in it.

Tracker issues:
#http://tracker.moodle.org/browse/PULL-96

===How can I have embedded media resized appropriately?===
Some thoughts on this are still in development.

#Detect size of file: http://tracker.moodle.org/browse/MDL-8984
#Patch: http://tracker.moodle.org/browse/MDL-23870

An extract from here: http://moodle.org/mod/forum/discuss.php?d=169935

Hi,
I am using Moodle 2.0 (Build: 20101214) for streaming lecture videos. The vids are encoded as FLV (flash video), H.263 video and MP3 audio. Aspect ratio is 4:3 (640x480). I upload the vids to a repository, and use the "add a file" feature.

The built-in player (flowplayer 3.2.3) works nicely, until you attempt fullscreen viewing. Flowplayer apparently has the scaling set to 'scale', which fills the screen and ignores aspect ratios.

from http://flowplayer.org/documentation/configuration/clips.html, I see that available scaling options are:

* fit: Fit to window by preserving the aspect ratio encoded in the file's metadata.
* half: Half-size (preserves aspect ratio)
* orig: Use the dimensions encoded in the file. If the video is too big for the available space, the video is scaled using the 'fit' option.
* scale: Scale the video to fill all available space. Ignores the dimensions in the metadata. This is the default setting.

My question is, how do I change this setting? where would I find it?"

----

Useful information to have, maybe.

== See also ==

* [[Filters]]
* [[MP3 player]]
* [[Audio in Moodle]]
* [[Speech tools]]

Using Moodle forum discussions:
* [http://moodle.org/mod/forum/discuss.php?d=37119 Multimedia plugin vs object embed]
* [http://moodle.org/mod/forum/discuss.php?d=29588 Size of embedded Flash]
* [http://moodle.org/mod/forum/discuss.php?d=89416&parent=394828 Linking to FLV video files]
* [http://moodle.org/mod/forum/discuss.php?d=90781 video streaming]
* [http://moodle.org/mod/forum/discuss.php?d=95174 Media filter does not work for rm files]
* [http://moodle.org/mod/forum/discuss.php?d=98698 swf filter security]
* [http://moodle.org/mod/forum/discuss.php?d=125619 How to upload a screen capture video to the Moodle?]
* [http://moodle.org/mod/forum/discuss.php?d=143478 Best video format]

[[Category:Filter]]

[[pl:Pluginy_Multimedia]]
[[ja:マルチメディアプラグイン]]
[[de:Multimedia Plugins]]
[[fr:Extensions multimédia]]
[[es:Multimedia plugins (filtro)|Multimedia plugins]]

HTML tidy filter

2011-06-14T02:13:15Z

Lasko: Created page with "{{Filters}} '''Please refer to these notes before editing this page.'''"

{{Filters}}
'''Please refer to [[Page_notes#Filters|these notes]] before editing this page.'''

Glossary auto-linking filter

2011-06-14T02:13:01Z

Lasko: Created page with "{{Filters}} '''Please refer to these notes before editing this page.'''"

{{Filters}}
'''Please refer to [[Page_notes#Filters|these notes]] before editing this page.'''

Email protection filter

2011-06-14T02:12:46Z

Lasko: Created page with "{{Filters}} '''Please refer to these notes before editing this page.'''"

{{Filters}}
'''Please refer to [[Page_notes#Filters|these notes]] before editing this page.'''