diff --git a/lang/de/docs/releaseold.html b/lang/de/docs/releaseold.html deleted file mode 100644 index 48ac5a4deaa..00000000000 --- a/lang/de/docs/releaseold.html +++ /dev/null @@ -1,365 +0,0 @@ -
- -Older releases can be seen in the Moodle.org announcement forum. - - -
- -
Version: $Id$
diff --git a/lang/th/docs/README.txt b/lang/th/docs/README.txt deleted file mode 100644 index 27265d05da4..00000000000 --- a/lang/th/docs/README.txt +++ /dev/null @@ -1,48 +0,0 @@ -Moodle documentation --------------------- - -If you want to translate this documentation into another language, -I would suggest that you: - - 1) don't include English versions of the files in this directory - because they will be used automatically anyway if it is missing - from your language pack. - - 2) translate them in this order (starting with the important ones): - - MOST IMPORTANT - |------------------- - | - | - files.php - | - install.html - | - installamp.html - | - upgrade.html - | - faq.html - | - | ----------------- - | - | - teacher.html - | - module_files.txt - | - | ----------------- - | - | - intro.html - | - features.html - | - release.html - | - | ----------------- - | - | - developer.html - | - cvs.html - | - future.html - | - | ----------------- - | - | - license.html - | - |------------------- - LEAST IMPORTANT - - 3) Please don't translate credits.html at all - it changes too much. - - diff --git a/lang/th/docs/background.html b/lang/th/docs/background.html deleted file mode 100644 index da03dd07b60..00000000000 --- a/lang/th/docs/background.html +++ /dev/null @@ -1,79 +0,0 @@ - - - --- -Moodle is an active and evolving work in progress. Development was started - by Martin - Dougiamas who continues to lead the project:
---I've been working on it, in some way or other, for several years. It - started in the 90's when I was webmaster at Curtin - University of Technology and a system administrator of their WebCT installation. - I encountered many frustrations with the WebCT beast and developed an itch - that needed scratching - there had to be a better way (no, not Blackboard - :-)
-I also know a lot of people in schools and smaller institutions (and - some big ones!) who want to make better use of the Internet but don't know - where to start in the maze of technologies and pedagogies that are out there. - I've always hoped there would be a Free alternative that such people could - use to help them move their teaching skills into the online environment.
-My strong beliefs in the unrealised possibilities of Internet-based education - led me to complete a Masters and then a PhD in Education, combining my former - career in Computer Science with newly constructed knowledge about the nature - of learning and collaboration. In particular, I am particularly influenced - by the epistemology of social constructionism - which not only treats learning - as a social activity, but focusses attention on the learning that occurs while - actively constructing artifacts (such as texts) for others to see or use. -
-It is crucial to me that this software be easy to use - in fact it should - be as intuitive as possible.
-I'm committed to continuing my work on Moodle and on keeping it Open - and Free. I have a deeply-held belief in the importance of unrestricted education - and empowered teaching, and Moodle is the main way I can contribute to the - realisation of these ideals.
-A number of early prototypes were produced and discarded before he released - version 1.0 upon a largely unsuspecting world on August 20, 2002. This version - was targeted towards smaller, more intimate classes at University level, and - was the subject of research case studies that closely analysed the nature of - collaboration and reflection that occurred among these small groups of adult - participants. -
-Since then there has been steady series of new releases adding new features, - better scalability and improved performance. -
-As Moodle has spread and the community has grown, more input is being drawn - from a wider variety of people in different teaching situations. For example, - Moodle is now used not only in Universities, but in high schools, primary schools, - non-profit organisations, private companies, by independent teachers and even - homeschooling parents. A growing number of people from around the world are - contributing to Moodle in different ways - for more details see the Credits - page. -
-An important feature of the Moodle project is the moodle.org - web site, which provides a central point for information, discussion and collaboration - among Moodle users, who include system administrators, teachers, researchers, - instructional designers and of course, developers. Like Moodle, this site is - always evolving to suit the needs of the community, and like Moodle it will - always be Free. -
-In 2003, the company moodle.com - was launched to provide additional commercial support for those who need it, as - well as managed hosting, consulting and other services. -
-For more about our future plans for Moodle, see the Future - roadmap.
-
Version: $Id$
- - - diff --git a/lang/th/docs/coding.html b/lang/th/docs/coding.html deleted file mode 100644 index 38b4be41875..00000000000 --- a/lang/th/docs/coding.html +++ /dev/null @@ -1,190 +0,0 @@ - - -Any collaborative project needs consistency and stability - to stay strong.
-These guidelines are to provide a goal for all Moodle code - to strive to. It's true that some of the older existing code falls short in - a few areas, but it will all be fixed eventually. All new code definitely must - adhere to these standards as closely as possible.
--
I know it can be a little annoying to change your style - if you're used to something else, but balance that annoyance against the annoyance - of all the people trying later on to make sense of Moodle code with mixed styles. - There are obviously many good points for and against any style that people use, - but the current style just is, so please stick to it.
-GOOD: $quiz
- GOOD: $errorstring
-GOOD: $assignments (for an array of objects)
- GOOD: $i (but only in little loops)
-
- BAD: $Quiz
- BAD: $aReallyLongVariableNameWithoutAGoodReason
- BAD: $error_string
define("FORUM_MODE_FLATOLDEST", - 1);
- function forum_set_display_mode($mode=0)
- {
- global $USER,
- $CFG;
-
- if ($mode)
- {
- $USER->mode
- = $mode;
- } else if (empty($USER->mode))
- {
- $USER->mode
- = $CFG->forum_displaymode;
- }
- }
if ($quiz->attempts)
- {
- if ($numattempts >
- $quiz->attempts)
- {
- error($strtoomanyattempts,
- "view.php?id=$cm->id");
- }
- }
$var = 'some text without any
- variables';
- $var = "with special characters like a new line \n";
- $var = 'a very, very long string with a '.$single.' variable in it';
- $var = "some $text with $many variables $within it";
function forum_get_ratings_mean($postid,
- $scale, $ratings=NULL)
- {
- /// Return the mean rating of a post given
- to the current user by others.
- /// Scale is an array of possible ratings in the scale
- /// Ratings is an optional simple array of actual ratings (just integers)
-
- if (!$ratings)
- {
- $ratings
- = array(); //
- Initialize the empty array
- if ($rates
- = get_records("forum_ratings",
- "post", $postid))
- {
- //
- Process each rating in turn
- foreach
- ($rates as $rate)
- {
- ....etc
foreach ($objects
- as $key =>
- $thing) {
- process($thing);
-
- }
-
- if ($x ==
- $y)
- {
- $a
- = $b;
- } else if ($x ==
- $z) {
- $a
- = $c;
- } else {
- $a
- = $d;
- }
-
Version: $Id$
- - diff --git a/lang/th/docs/credits.html b/lang/th/docs/credits.html deleted file mode 100644 index 1a9fc956cb1..00000000000 --- a/lang/th/docs/credits.html +++ /dev/null @@ -1,209 +0,0 @@ - - - --- - diff --git a/lang/th/docs/cvs.html b/lang/th/docs/cvs.html deleted file mode 100644 index 9a6fcfe5bcb..00000000000 --- a/lang/th/docs/cvs.html +++ /dev/null @@ -1,150 +0,0 @@ - - -Overall guidance
---Martin Dougiamas is the originator, lead developer, project manager, release manager and general teaboy for the whole Moodle project. Do you take sugar?
-The Moodle software package is Copyright © 1999-2004, Martin Dougiamas under the GNU GPL.
--
Main Developers
---A special thanks from all of us goes to those who have contributed substantial and ongoing amounts of time - to writing Moodle code and helping it grow. These are people who "get" what developing Moodle is all about and without whom Moodle would be a far lesser thing:
---- Eloy Lafuente (stronk7), Ray Kingdon, Williams Castillo, Petri Asikainen, Henrik Kaipe, Zbigniew Fiedorowicz, Gustav Delius, Thomas Robb, Janne Mikkonen, Jon Papaioannou, - Scott Elliott
--
Other Contributors
---Many other people have contributed (and are still contributing) with constructive - discussions, support, testing and various chunks of code and documentation. This list is long and always - changing, but some names include (in the order they were added): -
---- Peter C. Taylor, Art Lader, Matt Hope, Tom Murdock, Sébastien Namèche, James Miller, Dustin - Rue, Holger Schadeck, Giovanni Tummarello, John Windmueller, Sean Keogh, Mitsuhiro - Yoshida, Greg Barnett, Mark Kimes, Mary Hunter, Russell Jungwirth, Przemyslaw Stencel, Roberto - Pinna (Bobo), John "Captain" Eyre, Paula Edmiston, Howard Miller, - Claudio Tavares, P. Timothy Ervin, Bob Calder, Ursula - Raab, David Delgado, Mad Alex, Gaëtan Frenoy, Bernard Boucher, Bryan Williams, Mike Churchward, Rob Butner, Koen Roggemans.
-Sorry if we've forgotten to include your name here - the Moodle community is large and active so this list is difficult - to maintain! Please email Martin and make your suggestions! :-)
-Thanks also to everyone of you who have -
--
-- donated via the Donations - page, -
-- contributed to the bug tracker, - and -
-- participated in the Moodle - Community
--
Translators
---One of Moodle's strengths is the number of translations it has. Each translation takes many hours of work, as there are - over 1000 phrases to translate (plus hundreds of help files!). Many of the languages - have more than one contributor, sometimes working together and sometimes working serially. -
-Maintaining a list of all these wonderful people is too difficult, so please look at the Language - download page for names and details.
--
Themes
---Themes give Moodle sites some colour and life. Here are all the themes carried - as part of the Moodle distribution, along with their authors: -
--
-- standard* and cordoroyblue, by Martin Dougiamas -
-- oceanblue, by Mitsuhiro Yoshida, http://mitstek.com -
-- brightretro, cornflower, by Thomas Murdock, http://sand-paper.org -
-- garden, by Spiggy, http://phpgirl.com
-- formal_white, by Andrea Bicciolo
--
Moodle libraries
--- -Some of Moodle's libraries were written by other people, and are being redistributed - as part of Moodle under their respective open source licenses that thankfully - allow us to do so. My thanks go out to the authors of all these excellent - products - without them Moodle would be missing important functionality. Copyright - information for each package is included below:
-ADOdb - lib/adodb
---Database abstraction library for MySQL, PostgreSQL, MSSQL, Oracle, Interbase, - Foxpro, Access, ADO, Sybase, DB2 and ODBC.
-Version: 4.20
-
- Copyright © 2000-2004 John Lim (jlim@natsoft.com.my)
- License: Dual LGPL and BSD-style
- URL: http://php.weblogs.com/adodb
-Graph Class - lib/graphlib.php
---Class to draw line, point, bar, and area graphs, including numeric x-axis - and double y-axis.
-Version: 1.6.3 (with modifications)
-
- Copyright © 2000 Herman Veluwenkamp, hermanV@mindless.com
- License: LGPL
--html2text - lib/html2text.php
---PHP script to convert HTML into an approximate text equivalent
-Version: 1.0 (with modifications)
-
- Copyright © 2002 Mark Wilton-Jones
- License: HowToCreate script license with written permission
- URL: http://www.howtocreate.co.uk/php/
--htmlArea - lib/editor
---Javascript/HTML script to put a GUI editor in textareas on Internet Explorer and Mozilla
-Version: 3.0 beta (with modifications)
-
- Copyright © 2002 interactivetools.com, inc.
- License: htmlArea License (based on BSD license)
-IP-Atlas - lib/ipatlas
---PHP scripts to show the location of an IP address on a map.
- -
-
- Version: 1.0 (with modifications)
- Copyright © 2002 Ivan Kozik
- License: GNU GPL
- URL: http://www.xpenguin.com/ip-atlas.phpmimeTeX - filter/tex
---Compiled C program to convert TeX into GIFs
-
-
- Version: 1.4
- Copyright © 2002-2004 John Forkosh Associates, Inc
- License: GNU GPL
- URL: http://www.forkosh.com/mimetex.html
-URL: http://moodle.org/download/mimetex-
- PclZip - lib/pclzip--Class to create, manage and unpack zip files.
-
-
- Version: 2.0 RC2
- Copyright © 2003 Vincent Blavet <vincent@phpconcept.net>
- License: GNU GPL
- URL: http://www.phpconcept.net
-PHP mailer - lib/class.phpmailer.php
---Class for sending email using either sendmail, PHP mail(), or SMTP. - Methods are based upon the standard AspEmail(tm) classes.
-
-
- Version 1.71,
- Copyright © 2003 Brent R. Matzelle <bmatzelle@yahoo.com>
- License: LGPL
- URL: http://phpmailer.sourceforge.net
-Snoopy - lib/snoopy
---A PHP net client
-
-
- Version: 1.0
- Copyright © 1999-2000 Monte Ohrt <monte@ispi.net>
- License: GNU LGPL
- URL: http://snoopy.sourceforge.com
-Spreadsheet::WriteExcel - lib/excel
---A library for generating Excel Spreadsheets.
-
-
- Version: 2002-11-28
- Copyright © 2002 Xavier Noguer <xnoguer@rezebra.com>
- License: GNU LGPL
- URL: http://jeffn.users.phpclasses.org/browse.html/package/767.html
-SMTP class - lib/class.smtp.php
---Class that can be used to connect and communicate with any SMTP - server.
-
- It implements all the SMTP functions defined in RFC821 except TURN.
-
- Version: 03/26/2001
- Copyright © 2001 Chris Ryan <chris@greatbridge.com>-
-Version: $Id$
-
-- -CVS is the Concurrent Versioning System. It's a commonly used way of storing - source code because it keeps versions of all files so that nothing is ever - lost, and usage by different people is tracked. It also provides ways to merge - code if two or more people are working on the same file. All code and all - versions are stored on a central server (in the case of Moodle, at Sourceforge). -
-If you just want to access the current CVS version of Moodle with read-only access then - you don't need this page - just follow the simpler CVS instructions on the Moodle download page.
- -To use Moodle's - CVS archive (as a developer - with write access), you first need to have an account - on Sourceforge. For the examples on this page, let's assume your username - is myusername and your password - is mypassword. Take special note of the - sourceforge instructions to create your CVS home directory - something you have to - do with every new account to "enable" it for CVS. Basically you just have to use ssh to interactively connect to cvs.sourceforge.net.
- -Once you have - a working Sourceforge account, contact Martin Dougiamas so he can give you write access - to particular Moodle directories.
- -To avoid being prompted for mypassword - every time you run a CVS command, follow the Sourceforge - directions for using authorized keys. This step is optional, but it can - make your CVS experience a lot nicer.
-With that done, you should have all the permissions you need, so you just - need to set up your machine and download the current sources so you can start - working on them. Below are instructions for Unix and Windows systems.
-1. Using CVS on Unix
---Sourceforge CVS uses ssh as a transport layer for security, so you will - have to set this CVS_RSH environment variable in your Unix shell:
---setenv CVS_RSH ssh (for csh, tcsh etc)-export CVS_RSH=ssh (for sh, bash etc)-It's best to put this in your .bashrc or .cshrc so you don't have to type - it all the time. Then, check out Moodle using this (all one line):
---cvs -z3 -d:ext:myusername@cvs.sourceforge.net:/cvsroot/moodle co moodle-The command is similar for other CVS modules (such as the contrib folder or the MySQL Admin folder):
---cvs -z3 -d:ext:myusername@cvs.sourceforge.net:/cvsroot/moodle co contrib-
-cvs -z3 -d:ext:myusername@cvs.sourceforge.net:/cvsroot/moodle co mysqlDon't try to do run this first CVS command over an existing moodle installation - - start fresh with a new directory.
-Note that you will be prompted for mypassword - for each command unless you set up authorized - keys
-Now, you should have a new 'moodle' directory. You can rename it and move - it around if you like. Go into it:
---cd moodle-All the latest Moodle files should be in there. You can now change files - in your copy. To compare your files against the main CVS copy on the server - use cvs diff, eg:
---cvs diff -c config-dist.php -cvs diff -c lang-To fetch the latest updates from the server use:
---cvs update -dP-To copy your new files back to the server you would do something like: -
---cd lang/ca -cvs commit-You will be prompted to add some comments (depends on your default text - editor) ... add a meangingful comment and close the editor ... the files - will be sent to Sourceforge and stored. Done!
-To save more time you can put default arguments into a file called .cvsrc - in your home directory. For example, mine contains:
---diff -c -update -dP-Try 'cvs help' for more details ...
--
2. Using CVS on Windows
---First, you need to download a completely fresh copy of Moodle using your - developer account.
---1. Get TortoiseCVS from tortoisecvs.org - and install it, then reboot.
-
-
- 2. Find or create a new folder somewhere where you want Moodle to be downloaded - to.
-
- 3. Right-mouse-click that folder and choose "CVS Checkout" - from the menu. You should see a dialog box.
-
- 4. Copy this text into the CVSROOT field (using your own username!):--:ext:myusername@cvs.sourceforge.net:/cvsroot/moodle--
- 5. Under the "Module" field, type "moodle" to get Moodle, "contrib" to get the contributions directory, or "mysql" to get the MySQL Admin module.
-
- 7. Press the button: "OK" and everything should - be downloaded.
-A dialog box should show all the files being downloaded, and after a while - you should have a complete copy of Moodle. After this first checkout, you - can fetch the latest updated files from the CVS server:
---1. Right-mouse-click on your Moodle folder (or any file) and select - "CVS Update".
-
-After modifying files (you will note they change from green top red!), - you can commit them back to the CVS server like this:
---1. Right-mouse-click on your Moodle folder (or any file) and select - "CVS Commit...".
-
-
- 2. In the dialog box, type a clear description of the changes you are - committing.
-
- 3. Click "OK". Your changes will be sent to the server.
--
Good luck!
--
Version: $Id$
- - diff --git a/lang/th/docs/developer.html b/lang/th/docs/developer.html deleted file mode 100644 index 16a511b8c83..00000000000 --- a/lang/th/docs/developer.html +++ /dev/null @@ -1,293 +0,0 @@ - ---This document describes some of Moodle's design and how you can contribute.
-It's a bit thin at the moment - better documentation will come eventually!
-Sections in this document:
- -
-
--From a system administrator's perspective, Moodle has been designed according - to the following criteria:
--
-- Moodle should run on the widest variety of platforms
-
-
- The web application platform that runs on most platforms is PHP combined - with MySQL, and this is the environment that Moodle has been developed in - (on Linux, Windows, and Mac OS X). Moodle also uses the ADOdb library for - database abstraction, which means Moodle can use more - than ten different brands of database (unfortunately, though, it can - not yet set up tables in all these databases - - more on this later).
-
-- Moodle should be easy to install, learn and modify
-
-
- Early prototypes of Moodle (1999) were built using Zope - - an advanced object-oriented web application server. Unfortunately I found - that although the technology was pretty cool, it had a very steep learning - curve and was not very flexible in terms of system administration. The PHP - scripting language, on the other hand, is very easy to get into (especially - if you've done any programming using any other scripting language). Early - on I made the decision to avoid using a class-oriented design - again, to - keep it simple to understand for novices. Code reuse is instead achieved - by libraries of clearly-named functions and consistent layout of script - files. PHP is also easy to install (binaries are available for every platform) - and is widely available to the point that most web hosting services provide - it as standard.
-
-- It should be easy to upgrade from one version to the next
-
-
- Moodle knows what version it is (as well as the versions of all plug-in - modules) and a mechanism has been built-in so that Moodle can properly upgrade - itself to new versions (for example it can rename database tables or add - new fields). If using CVS in Unix for example, one can just do a "cvs - update -d" and then visit the site home page to complete an upgrade.
-
-- It should be modular to allow for growth
-
-
- Moodle has a number of features that are modular, including themes, activities, - interface languages, database schemas and course formats. This allows anyone - to add features to the main codebase or to even distribute them separately. - More on this below in the next section.
-
-- It should be able to be used in conjunction with other systems
-
-
- One thing Moodle does is keep all files for one course within a single, - normal directory on the server. This would allow a system administrator - to provide seamless forms of file-level access for each teacher, such as - Appletalk, SMB, NFS, FTP, WebDAV and so on. The authentication modules allow - Moodle to use LDAP, IMAP, POP3, NNTP and other databases as sources for - user information. Otherwise, there is work yet to do. Features planned for - Moodle in future versions include: import and export of Moodle data using - XML-based formats (including IMS and SCORM); and increased use of style - sheets for interface formatting (so that it can be integrated visually into - other web sites).
-
--As mentioned above, Moodle has a number of features that are modular. Even - if you are not a programmer there are things you can change or help with.
-Learning Activities
---These are by far the most important modules, and reside in the 'mod' directory. - There are seven default modules: assignment, choice, forum, journal, quiz, - resource, and survey. Each module is in a separate subdirectory and consists - of the following mandatory elements (plus extra scripts unique to each module):
--
-- mod.html: a form to set up or update an instance of this module
-- version.php: defines some meta-info and provides upgrading code
-- icon.gif: a 16x16 icon for the module
-- db/: SQL dumps of all the required db tables and data (for each database - type)
-- index.php: a page to list all instances in a course
-- view.php: a page to view a particular instance
-- lib.php: any/all functions defined by the module should be in here. - If the modulename if called widget, then the required functions include: -
--
-- widget_add_instance() - code to add a new instance of widget
-- widget_update_instance() - code to update an existing instance
-- widget_delete_instance() - code to delete an instance
-- widget_user_outline() - given an instance, return a summary of a - user's contribution
-- widget_user_complete() - given an instance, print details of a user's - contribution
-
-- To avoid possible conflict, any module functions should be named - starting with widget_ and any constants you define should start with - WIDGET_
-- Lastly, each module will have some language files that contain strings - for that module. See below.
-The easiest way to start a new learning activity module is to use the template - in mod/newmodule_template.zip. - Unzip it and follow the README inside.
-You might also like to post first in the Activities - modules forum on Using Moodle.
--
Themes
---Themes (or skins) define the look of a site. A number of simple themes - are provided in the main distribution, but you may want to create your own - theme with your own colours, logo, styles and graphics.
-Each theme is in a subdirectory of the "theme" directory, and - contains at least the following files:
--
-- config.php: defines the theme colours used throughout - the site
-- styles.php: the style sheet, containing CSS definitions - for standard HTML elements as well as many Moodle elements.
-- header.html: Included at the top of each page. This - is what you need to edit to add a logo at the top of pages, for example.
-- footer.html: Included at the bottom of each page.
-To create your own themes for current versions of Moodle:
--
-- Copy one of the existing theme folders to one with a new name. I recommend - starting with one of the standard themes.
-- Edit config.php and insert your own colours.
-- Edit styles.php and change your CSS styles.
-- Edit header.html and footer.html to add new logos, or change the layout. -
-Note that all these steps are optional - you can make a radically different - look to your site simply by editing the colours in config.php
-Note also that Moodle upgrades may break themes slightly, so check - the release notes carefully if you are using a custom theme.
-In particular, Moodle 2.0 will have a completely new display system, probably - based on XSL transformations of XML output from Moodle. It is likely that - the themes for this will be a completely different format, but the advantage - will be a much higher possible degree of customisation (including moving - elements around the page).
-More discussion about this in the Themes - forum on Using Moodle. If you create a nice theme that you think others - might want to use, please post your zip file on the themes forum!
-
-Languages
---Moodle has been designed for internationalisation. Each 'string' or 'page' - of text that is displayed as part of the interface is drawn from a set of - language files. Each language is a subdirectory of the directory 'lang'. - The structure of the lang directory is as follows:
-lang/en - directory containing all files for one language - (eg English)
--
-- moodle.php - strings for main interface
-- assignment.php - strings for assignment module
-- choice.php - strings for choice module
-- forum.php - strings for forum module
-- journal.php - strings for journal module
-- quiz.php - strings for quiz module
-- resource.php - strings for resource module
-- survey.php - strings for survey module
-- .... plus other modules if any.
-
-
- A string is called from these files using the get_string() - or print_string() functions. Each string - supports variable substitution, to support variable ordering in different - languages.
-
- eg $strdueby = get_string("assignmentdueby", "assignment", - userdate($date));
-
- If a string doesn't exist in a particular language, then the equivalent - in English will automatically be used instead.lang/en/help - contains whole help pages (for popup context-sensitive - help)
---Main help pages are situated here, while help pages specific to each - module are located in subdirectories with the module's name.
-You can insert a helpbutton in a page with the helpbutton function.
-eg helpbutton("text", "Click here for help about text");
-and for modules:
-helpbutton("forumtypes", "Forum types", "forum");
-Note that you can edit languages online, using the administration web tools - under "Check this language". This makes it easy to not to only - create new languages but to refine existing ones. If you are starting a - new language, please contact me, Martin - Dougiamas.
-You might also like to post in the Languages - forum on Using Moodle.
-If you are maintaining a language an ongoing basis, I can give you CVS - write access to the Moodle source code so that you can directly maintain - the files.
-Database Schemas
---Given a working database with defined tables, the intentionally simple - SQL used in Moodle should work fine with a wide variety of database brands.
-A problem exists with automatically creating new tables - in a database, which is what Moodle tries to do upon initial installation. - Because every database is very different, there doesn't yet exist any way - to do this in a platform-independent way. To support this automation in - each database, schemas can be created that list the required SQL to create - Moodle tables in a particular database. These are files in lib/db - and inside the db subdirectory of each module.
-Currently, only MySQL and PostgreSQL are fully supported in this way (no-one - wrote the schemas for other brands).
-Moodle 1.2 will use a new method of database-independent XML schemas that - will make all this unnecessary.
--
Course Formats
---Moodle currently supports three different course formats: weekly, topics - and social.
-These are a little more connected to the rest of the code (and hence, less - "pluggable") but it is still quite easy to add new ones.
-If you have any ideas for different formats that you need or would like - to see, get in touch with me and I'll do my absolute best to have them available - in future releases.
--
Documentation and articles
---If you feel like writing a tutorial, an article, an academic paper or anything - else about Moodle, please do!
-Put it on the web and make sure you include links to http://moodle.org/
--
Participating in the bug tracker
---Finally, I would like to invite you to register on the "bug tracker" - at http://moodle.org/bugs - so you can file any bugs that you find and perhaps participate in discussing - and fixing them.
-"Bugs" not only includes software bugs with current versions - of Moodle, but also new ideas, feature requests and even constructive criticism - of existing features. The beauty of open source is that anyone can participate - in some way and help to create a better product for all of us to enjoy. - In this project, your input is very welcome!
-
-
------Thanks for using Moodle!
-
-
- Martin Dougiamas, Lead - Developer
-
-- --
Version: $Id$
- - diff --git a/lang/th/docs/docstyles.css b/lang/th/docs/docstyles.css deleted file mode 100644 index 555c6346970..00000000000 --- a/lang/th/docs/docstyles.css +++ /dev/null @@ -1,119 +0,0 @@ - -body, td, th, li { - font-family: "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif; -} - -th { - font-weight: bold; -} - -a:link { - text-decoration: none; - color: blue; -} - -a:visited { - text-decoration: none; - color: blue; -} - -a:hover { - text-decoration: underline; - color: red; -} - -form { - margin-bottom: 0; -} - - -li { - margin-bottom: 10px; - -} - -.question { - font-size: medium; - font-weight: bold; - font-family: "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif; - border: 1px dotted; - padding: 10px; - background-color: #EEEEEE; -} - -.answer { - font-family: "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif; - font-size: medium; - border: none; - padding-left: 40px; -} - -.normaltext { - font-family: "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif; - font-size: medium; - border: none; - margin-left: 30px; - -} - -.answercode { - font-family: "Courier New", Courier, mono; - font-size: small; - border: none; - padding-left: 60px; -} - -.questionlink { - font-family: "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif; - font-size: medium; - border: none; - padding-left: 40px; -} - -.examplecode { - font-family: "Courier New", Courier, mono; - font-size: small; - border: thin dashed #999999; - background-color: #FBFBFB; - margin: auto; - padding: 30px; - height: auto; - width: auto; -} -h1 { - font-weight: bold; - color: #000000; - background-color: #CCCCCC; - padding: 5px; - font-size: large; - border-width: 1px; - border-color: #CCCCCC; - -moz-border-radius: 10px; -} -h2 { - font-weight: bold; - color: #FFFFFF; - background-color: #666666; - padding: 5px; - font-size: medium; - border-width: 1px; - border-color: #666666; - -moz-border-radius: 10px; -} -h3 { - font-weight: normal; - color: #FFFFFF; - background-color: #666666; - padding: 5px; - font-size: medium; - -moz-border-radius: 10px; -} -.spaced { - - margin-bottom: 30px; -} - -ul { - margin-top: 10px; - -} diff --git a/lang/th/docs/faq.html b/lang/th/docs/faq.html deleted file mode 100644 index 52d94b4c0bd..00000000000 --- a/lang/th/docs/faq.html +++ /dev/null @@ -1,804 +0,0 @@ - - -This page contains answers to some of the most - frequently asked questions by people installing Moodle. If you have - followed the installation instructions but - you still have a problem, then this page is probably the best place to be.
- -If you don't find your answer here try the Using - Moodle course on moodle.org. Start by searching the forums using a few keywords, - in case your problem has already been discussed. If you don't find - anything, then try posting your question into the appropriate forum - somebody will - usually be able to help you.
- - -If you have tried a number of solutions without resolving an issue, -and you are running behind a firewall, it may be advisable to try re-configuring your -firewall to ensure that it is not blocking a required function or necessary communication. -Firewalls very rarely cause problems with Moodle but are occasionally responsible for -reduced functionality due to a mis-configuration in the firewall settings. - - - -
Use this list to jump to the appropriate answer below:
- -Whenever I try to access or view a file that I uploaded, I get an error "File not Found"
- - - -PHP - is it installed and what version do I have?
- - - - - - - -My pages show fatal errors such as : call to undefined function: get_string()
- - - -Why do I keep getting error messages about "headers already sent"?
- - - -I keep getting this error: Failed opening required '/web/moodle/lib/setup.php'
- - - -Any text I add with an apostrophe (') or a quote (") causes errors or comes up with a slash added
- - - -I keep getting error messages about session_start
- - - -When I go to the admin page, I get told to make dirroot blank!
- - - -I login but the login link doesn't change. I am logged in and can navigate freely.
- - - -When trying to add a resource I receive error messages.
- - - -During the initial setting-up process, I never get asked to create an admin account!
- -I can't log in at all- I just stay stuck on the login screen.
- -How do I backup my Moodle site?
- -Why doesn't my Moodle site display the - - time & date correctly?
- -Email copies are not being sent - - from my forums
- -- - - - - - - -
For example: Not Found: The requested URL /moodle/file.php/2/myfile.jpg - - - - was not found on this server.
- - - -Your web server needs to be configured to allow the part of - - - - the URL after a script name to be passed directly to the script. This is usually - - - - enabled in Apache 1, but is usually disabled by default in Apache 2. To turn - - - - it on, add this line to your httpd.conf, or to a .htaccess file in your local - - - - directory (see the Install documentation - - - - for more details):
- - - -AcceptPathInfo on
- - - -Note, this will ONLY work for Apache versions 2.x.
- - - -If you are not using Apache 2 and you still have this problem - - - - (unlikely) then you can switch Moodle to use an alternative method. The disadvantages - - - - are a slight loss of performance for your users and you won't be able to use - - - - relative links within HTML resources.
- - - -To use this alternative method: login as Admin, go into the - - - - "Configure Variables" page and change the setting for "slasharguments". - - - - You should now be able to access your uploaded files.
- - - -- - - - - - - -
Make a new file on your web site called info.php, containing the following - - - - text, and call it from your browser:
- - - - - - - -<?PHP phpinfo() ?>
- - - -If nothing happens then you don't have PHP installed. See the - - - - installation docs for some information about where to download it for your computer.
- - - -- - - -
Check the dirroot variable in config.php. You must use complete, - - - - absolute pathnames, eg:
- - - -$CFG->dirroot = "d:\inetpub\sites\www.yoursite.com\web\moodle";
- - - -- - - -
Redhat Linux platform please see: Redhat Linux
- - - -- - - -
If you see errors like:
- - - -Parse error: parse error, unexpected T_VARIABLE in c:\program
-
-
-
- files\easyphp\www\moodle\config.php on line 94
-
-
-
- Fatal error: Call to undefined function: get_string() in c:\program files\easyphp\www\moodle\mod\resource\lib.php
-
-
-
- on line 11
then it's likely you have left out a semi-colon or ending quote - - - - from a line in config.php (previous to line 94).
- - - -Another reason could be that you have opened config.php in a - - - - program like Word to edit it, and saved it as a HTML web page, instead of a - - - - proper text file.
- - - -- - - -
If you see errors like this:
- - - -Warning: Cannot add header information - headers already - - - - sent by (output started at /webs/moodle/config.php:87) in /webs/moodle/lib/moodlelib.php - - - - on line 1322
- - - -Warning: Cannot add header information - headers already - - - - sent by (output started at /webs/moodle/config.php:87) in /webs/moodle/lib/moodlelib.php - - - - on line 1323
- - - -Warning: Cannot add header information - headers already - - - - sent by (output started at /webs/moodle/config.php:87) in /webs/moodle/login/index.php - - - - on line 54
- - - -You have blank lines or spaces after the final ?> in your config.php - - - - file. Sometimes text editors add these - for example Notepad on Windows - so - - - - you may have to try a different text editor to remove these spaces or blank - - - - lines completely.
- - - -- - - -
In your config.php, the setting that you use for the dirroot - - - - variable must be the complete path from the root of your server's hard - - - - drive.
- - - -Sometimes people only use the path from their home directory, - - - - or relative to the root of the web server directory.
- - - -- - - -
Problems caused by apostrophes are caused by incorrect "magic - - - - quotes" settings. Moodle requires the following settings (which are usually - - - - the default):
- - - -magic_quotes_gpc = On
-
-
-
- magic_quotes_runtime = Off
See the section on webserver - - configuration in the Installation docs for more details.
- -- - - - - - - - - - - - - - - -
If you see errors like this:
- - - -Warning: session_start() [function.session-start]: open(/tmp\sess_d40f380d37d431fc1516e9a895ad9ce0, O_RDWR) failed: No such file or directory (2) in G:\web\moodle\lib\setup.php on line 123
- - - -Warning: session_start() [function.session-start]: open(/tmp\sess_d40f380d37d431fc1516e9a895ad9ce0, O_RDWR) failed: No such file or directory (2) in G:\web\moodle\lib\setup.php on line 123
- - - -Warning: session_start() [function.session-start]: Cannot send session cache limiter - headers already sent (output started at G:\web\moodle\lib\setup.php:1) in G:\web\moodle\lib\setup.php on line 123
- - - - - - - -... these are all related to the fact that PHP is failing to save - - - - "session" files on your hard disk (in a directory called /tmp). Usually the - - - - reason is that you don't HAVE a directory called /tmp on your computer. This - - - - is usually the case with Windows installations. - - - - - - - -
The solution is to fix the PHP setting for this path to point to a real directory. You can do this in your php.ini file:
- - - -session.save_path = C:\temp
- - - -or otherwise in a .htaccess file in your main moodle directory:
- - - -php_value session.save_path "/home/moodle/sessions"
- -- - - - - - - -
If you see errors like this in Moodle 1.0.9:
- - - - - - - -| Please fix your settings in config.php:
-
-
-
- You have: - - - - $CFG->dirroot = "/home/users/fred/public_html/moodle"; - - - - but it should be: - - - - $CFG->dirroot = ""; |
then you have encountered a small bug that occurs on some servers. The problem is with the error-checking mechanism, not with your actual path. To fix it, find this line (line 66) in the file admin/index.php:
- - - -if ($dirroot != $CFG->dirroot) {
- - - -and change it to this:
- - - -if (!empty($dirroot) and $dirroot != $CFG->dirroot) {
- -- - - - - -
Make sure the URL in your $CFG->wwwroot setting is exactly the - - same as the one you are actually using to access the site.
- -- - - -
Assuming you are using Apache, then it's quite likely that your - - setting in config.php for $CFG->wwwroot is different from the actual URL you - - are using to access the site. Also try turning off "secureforms" in the - - admin settings.
- -- - - - - - - -
This is a known bug in versions of Moodle up to 1.0.9, now fixed in the main code and version 1.1.
- - - -It doesn't affect all people, it only occurs when the person installing Moodle has a - - cookie in their browser from another program on the same site, called "user", "admin", or "teacher".
- - - -Quick fixes include deleting those cookies from your browser before installing, using a different browser, or editing the file moodle/admin/user.php to insert these lines near the top:
- - - -unset($user);
unset($admin);
unset($teacher);
After performing any of these fixes it might be a good idea - - to drop all the tables in your database and re-install again from scratch.
- -- - - - - - - -
The most common cause for this is that your own computer (not your Moodle server) - - has a firewall that is stripping referrer information from the browser. Here are - - some instructions for fixing Norton firewall products.
- - - -The server admin can also fix this for everyone by editing the Moodle configuration - - page and changing the variable "secureforms" to "No".
- - - -Another possible cause of this problem is that sessions are - - not configured properly on the server. You can test this by calling the script - - http://yourserver/moodle/lib/session-test.php.
- -- - - - - - - -
There are two main things you need to make a copy of: the database and the uploaded files. The Moodle scripts themselves are less important, since you can always download a fresh copy if you have to.
- - - -There are many ways to do such backups. Here is an outline of a little script you can run on Unix to backup the database (it works well to have such a script run daily via a cron task
- -cd /my/backup/directory
- -mv moodle-database.sql.gz moodle-database-old.sql.gz
- -mysqldump -h example.com -u myusername --password=mypassword -C -Q -e -a mydatabasename > moodle-database.sql
- -gzip moodle-database.sql
- -For the files, you can use rsync regularly to copy only the changed files to another host:
- -rsync -auvtz --delete -e ssh mysshusername@example.com:/my/server/directory - - /my/backup/directory/
- -- - - - - -
Each language requires a specific language code (called a locale - - code) to allow dates to be displayed correctly. The language packs contain default - - standard codes, but sometimes these don't work on Windows servers.
- -You can find the correct locale codes for Windows on these two - - pages: Language - - codes and Country/region - - codes.(eg "esp_esp" for spanish)
- -These new locale codes can be entered on the Admin -> Configure - - -> Variables page, where they override the ones in the currently chosen language - - pack.
- -- -
You must set up cron properly if you want Moodle - - to send out automatic email from forums, journals, assignments etc. This same - - process also performs a number of clean-up tasks such as deleting old unconfirmed - - users, unenrolling old students and so on.
- -Basically, you need to set up a process to regularly call the - - script http://yoursite/admin/cron.php. Please see the - - section on cron in the Installation documentation.
- -Tip: Try the default setting in Moodle variables page. Leave the smtphost blank. - -This will be acceptable for the majority of users. -
-
- - -
Suggest - - - - a new FAQ (include the answer!)
- - - -Thanks to John Eyre for helping to maintain this - - - - FAQ.
- - - - - - - -Version: $Id: faq.html,v 1.6 2003/03/30 13:54:28 - - - - moodler Exp $
- - - - - - - - - - - - - diff --git a/lang/th/docs/features.html b/lang/th/docs/features.html deleted file mode 100644 index 8e8dbedc7af..00000000000 --- a/lang/th/docs/features.html +++ /dev/null @@ -1,219 +0,0 @@ - - - - --- -Moodle is an active and evolving product. This page lists just some of the - many features it contains:
-Overall design
--
-- Promotes a social constructionist pedagogy (collaboration, activities, critical - reflection, etc)
-- Suitable for 100% online classes as well as supplementing face-to-face learning -
-- Simple, lightweight, efficient, compatible, low-tech browser interface
-- Easy to install on almost any platform that supports PHP. Requires only - one database (and can share it).
-- Full database abstraction supports all major brands of database (except - for initial table definition)
-- Course listing shows descriptions for every course on the server, including - accessibility to guests.
-- Courses can be categorised and searched - one Moodle site can support thousands - of courses
-- Emphasis on strong security throughout. Forms are all checked, data validated, - cookies encrypted etc
-- Most text entry areas (resources, forum postings, journal entries etc) can - be edited using an embedded WYSIWYG HTML editor
-Site management
--
-- Site is managed by an admin user, defined during setup
-- Plug-in "themes" allow the admin to customise the site colours, fonts, layout - etc to suit local needs
-- Plug-in activity modules can be added to existing Moodle installations
-- Plug-in language packs allow full localisation to any language. These can - be edited using a built-in web-based editor. Currently there are language - packs for over 34 - languages.
-- The code is clearly-written PHP under a GPL license - easy to modify to - suit your needs
-User management
--
-- Goals are to reduce admin involvement to a minimum, while retaining high - security
-- Supports a range of authentication mechanisms through plug-in authentication - modules, allowing easy integration with existing systems.
-- Standard email method: students can create their own login accounts. Email - addresses are verified by confirmation.
-- LDAP method: account logins can be checked against an LDAP server. Admin - can specify which fields to use.
-- IMAP, POP3, NNTP: account logins are checked against a mail or news server. - SSL, certificates and TLS are supported.
-- External database: any database containing at least two fields can be used - as an external authentication source.
-- Each person requires only one account for the whole server - each account - can have different access
-- An admin account controls the creation of courses and creates teachers by - assigning users to courses
-- A course creator account is only allowed to create courses and teach in - them
-- Teachers may have editing privileges removed so that they can't modify the - course (eg for part-time tutors)
-- Security - teachers can add an "enrolment key" to their courses to keep - out non-students. They can give out this key face-to-face or via personal - email etc
-- Teachers can enrol students manually if desired
-- Teachers can unenrol students manually if desired, otherwise they are automatically - unenrolled after a certain period of inactivity (set by the admin)
-- Students are encouraged to build an online profile including photos, description. - Email addresses can be protected from display if required.
-- Every user can specify their own timezone, and every date in Moodle is translated - to that timezone (eg posting dates, assignment due dates etc)
-- Every user can choose the language used for the Moodle interface (English, - French, German, Spanish, Portuguese etc)
-Course management
--
-- A full teacher has full control over all settings for a course, including - restricting other teachers
-- Choice of course formats such as by week, by topic or a discussion-focussed - social format
-- Flexible array of course activities - Forums, Journals, Quizzes, Resources, - Choices, Surveys, Assignments, Chats, Workshops
-- Recent changes to the course since the last login can be displayed on the - course home page - helps give sense of community
-- Most text entry areas (resources, forum postings, journal entries etc) can - be edited using an embedded WYSIWYG HTML editor
-- All grades for Forums, Journals, Quizzes and Assignments can be viewed on - one page (and downloaded as a spreadsheet file)
-- Full user logging and tracking - activity reports for each student are available - with graphs and details about each module (last access, number of times read) - as well as a detailed "story" of each students involvement including postings, - journal entries etc on one page.
-- Mail integration - copies of forum posts, teacher feedback etc can be mailed - in HTML or plain text.
-- Custom scales - teachers can define their own scales to be used for grading - forums, assignments and journals
-- Courses can be packaged as a single zip file using the Backup function. - These can be restored on any Moodle server.
-Assignment Module
--
-- Assignments can be specified with a due date and a maximum grade.
-- Students can upload their assignments (any file format) to the server - - they are date-stamped.
-- Late assignments are allowed, but the amount of lateness is shown clearly - to the teacher
-- For each particular assignment, the whole class can be assessed (grade and - comment) on one page in one form.
-- Teacher feedback is appended to the assignment page for each student, and - notification is mailed out.
-- The teacher can choose to allow resubmission of assignments after grading - (for regrading)
-Chat Module
--
-- Allows smooth, synchronous text interaction
-- Includes profile pictures in the chat window
-- Supports URLs, smilies, embedded HTML, images etc
-- All sessions are logged for later viewing, and these can also be made available - to students
-Choice Module
--
-- Like a poll. Can either be used to vote on something, or to get feedback - from every student (eg research consent)
-- Teacher sees intuitive table view of who chose what
-- Students can optionally be allowed to see an up-to-date graph of results
-Forum Module
--
-- Different types of forums are available, such as teacher-only, course news, - open-to-all, and one-thread-per-user.
-- All postings have the authors photo attached.
-- Discussions can be viewed nested, flat or threaded, oldest or newest first.
-- Individual forums can be subscribed to by each person so that copies are - forwarded via email, or the teacher can force subscription for all
-- The teacher can choose not to allow replies (eg for an announcements-only - forum)
-- Discussion threads can be easily moved between forums by the teacher
-- Attached images are shown inline
-- If forum ratings are being used, these can be restricted to a range of dates
-Journal Module
--
-- Journals are private between student and teacher.
-- Each journal entry can be directed by an open question.
-- For each particular journal entry, the whole class can be assessed on one - page in one form
-- Teacher feedback is appended to the journal entry page, and notification - is mailed out.
-Quiz Module
--
-- Teachers can define a database of questions for re-use in different quizzes
-- Questions can be stored in categories for easy access, and these categories - can be "published" to make them accessible from any course on the - site.
-- Quizzes are automatically graded, and can be re-graded if questions are - modified
-- Quizzes can have a limited time window outside of which they are not available
-- At the teacher's option, quizzes can be attempted multiple times, and can - show feedback and/or correct answers
-- Quiz questions and quiz answers can be shuffled (randomised) to reduce cheating
-- Questions allow HTML and images
-- Questions can be imported from external text files
-- Quizzes can be attempted multiple times, if desired
-- Attempts can be cumulative, if desired, and finished over several sessions
-- Multiple-choice questions supporting single or multiple answers
-- Short Answer questions (words or phrases)
-- True-False questions
-- Matching questions
-- Random questions
-- Numerical questions (with allowable ranges)
-- Embedded-answer questions (cloze style) with answers within passages of - text
-- Embedded descriptive text and graphics
-Resource Module
--
-- Supports display of any electronic content, Word, Powerpoint, Flash, Video, - Sounds etc
-- Files can be uploaded and managed on the server, or created on the fly using - web forms (text or HTML)
-- External content on the web can be linked to or seamlessly included within - the course interface.
-- External web applications can be linked in with data passed to them
-Survey Module
--
-- Built-in surveys (COLLES, ATTLS) have been proven as instruments for analysing online classes
-- Online survey reports always available, including many graphs. Data is downloadable as an Excel spreadsheet or CSV text file.
-- Survey interface prevents partly-finished surveys.
-- Feedback is provided to the student of their results compared to the class averages -
-Workshop Module
--
-- Allows peer assessement of documents, and the teacher can manage and grade - the assessment.
-- Supports a wide range of possible grading scales
-- Teacher can provide sample documents for students to practice grading
-- Very flexible with many options.
--
Version: $Id$
- - diff --git a/lang/th/docs/files.php b/lang/th/docs/files.php deleted file mode 100644 index 6747b5e3487..00000000000 --- a/lang/th/docs/files.php +++ /dev/null @@ -1,31 +0,0 @@ - diff --git a/lang/th/docs/future.html b/lang/th/docs/future.html deleted file mode 100644 index c7a63fc1f4f..00000000000 --- a/lang/th/docs/future.html +++ /dev/null @@ -1,60 +0,0 @@ - - ---As Moodle gains in maturity, its directions are increasingly influenced by - the community of developers and users. A dynamic database of proposed features - and their status can be found at moodle.org/bugs. - Your contributions in the form of ideas, code, - feedback and promotion are all very welcome - see the Developers - manual for more details.
-Here is our current vision of the future, though this always changes depending on what developers want to work on. -
-Version 1.3 - May 2004
--- -Coming only weeks after Moodle 1.2, the main purpose of this release is to add the recently developed support for calendars and events into the main distribution.
-Version 2.0 - Later in 2004
---This major release will include some major changes in internal structure - designed to add flexibility and scalability in many areas. Among the major - targets are:
--
-- Completely rewritten display layer using XHTML-compatible code and complete implementation - of templates for increased standards-compliance, flexibility and accessibility
-- Wider use of PHP classes in key areas of the Moodle code, to make some - things easier for programmers writing new modules or integrating with - external systems
-- New architecture for Enrolments with plugins (similar to the - existing Authentication architecture) so that - external systems (eg Student Records, Paypal, LDAP etc) - can control student and teacher access within courses
-Version 2.1
---This release will start to take advantage of the new structuring and add new features such as:
--
-- New access-control system allowing finely-defined roles and rights -
-- Stronger pedagogical support for both teachers and students
-- Basic support for standard learning objects (SCORM content packages)
-- Better integration of Moodle with moodle.org (for teachers to share and collaborate)
--
- -
Version: $Id$
- diff --git a/lang/th/docs/install.html b/lang/th/docs/install.html deleted file mode 100644 index a4611c926f6..00000000000 --- a/lang/th/docs/install.html +++ /dev/null @@ -1,421 +0,0 @@ - - ---This guide explains how to install Moodle for the first time. It goes into some detail - about some of the steps, in order to cover the wide variety of small differences between - web server setups, so this document may look long and complicated. Don't be put off by this - - I usually set Moodle up in a few minutes!
-Take your time and work through this document carefully - it will save you time later on.
-Sections in this document:
--
-- Requirements
-- Download
-- Site structure
-- Create a data directory
-- Create a database
-- Check web server settings
-- Edit config.php
-- Go to the admin page
-- Set up cron
-- Create a new course
--
--Moodle is primarily developed in Linux using Apache, MySQL and PHP (also - sometimes known as the LAMP platform), but is also regularly tested with PostgreSQL - and on Windows XP, Mac OS X and Netware 6 operating systems
-The requirements for Moodle are as follows:
--
-- Web server software. Most people use Apache, - but Moodle should work fine under any web server that supports PHP, such - as IIS on Windows platforms.
-- PHP scripting language (version 4.1.0 - or later), with the following settings: -
--
-- GD library - turned ON, with support for JPG and PNG formats
-- zlib library turned ON (if you want to use backup/restore on Windows)
-- Sessions support turned ON
-- File uploading turned ON
-- Safe Mode must be turned OFF (see the forums on moodle.org for problems - caused by Safe Mode)
-- a working database server: MySQL - or PostgreSQL are - completely supported and recommended for use with Moodle 1.1. Other - databases will be supported fully in a future release.
-Most web hosts support all of this by default. If you are signed up with - one of the few webhosts that does not support these features ask them why, - and consider taking your business elsewhere.
-If you want to run Moodle on your own computer and all this looks a bit daunting, - then please see our guide: Installing - Apache, MySQL and PHP. It provides some step-by-step instructions to install - all this on most popular platforms.
--
--There are two ways to get Moodle, as a compressed package and via CVS. These - are explained in detail on the download page: http://moodle.org/download/
-After downloading and unpacking the archive, or checking out the files via - CVS, you will be left with a directory called "moodle", containing - a number of files and folders.
-You can either place the whole folder in your web server documents directory, - in which case the site will be located at http://yourwebserver.com/moodle, - or you can copy all the contents straight into the main web server documents - directory, in which case the site will be simply http://yourwebserver.com.
-
-
--Here is a quick summary of the contents of the Moodle folder, to help get - you oriented:
---config.php - the ONLY file you need to edit to get started
-
- version.php - defines the current version of Moodle code
- index.php - the front page of the site-
-- admin/ - code to administrate the whole server
-- auth/ - plugin modules to authenticate users
-- course/ - code to display and manage courses
-- doc/ - help documentation for Moodle (eg this page)
-- files/ - code to display and manage uploaded files
-- lang/ - texts in different languages, one directory per language
-- lib/ - libraries of core Moodle code
-- login/ - code to handle login and account creation
-- mod/ - all Moodle course modules
-- pix/ - generic site graphics
-- theme/ - theme packs/skins to change the look of the site.
-- user/ - code to display and manage users
--
--Moodle will also need some space on your hard disk to store uploaded files, - such as course documents and user pictures.
-Create a directory for this purpose somewhere. For security, it's best that - this directory is NOT accessible directly via the web. The easiest way to do this - is to simply locate it OUTSIDE the web directory, otherwise protect it - by creating a file in the data directory called .htaccess, containing this line: -
- --deny from all-To make sure that Moodle can save uploaded files in this directory, check that - the web server software (eg Apache) has permission to write - to this directory. On Unix machines, this means setting the owner of the directory - to be something like "nobody" or "apache".
-On many shared hosting servers, you will probably need to restrict all file access - to your "group" (to prevent other webhost customers from looking at or changing your files), - but provide full read/write access to everyone else (which will allow the web server - to access your files). Speak to your server administrator if you are having - trouble setting this up securely.
-
-
--You need to create an empty database (eg "moodle") in your database system - along with a special user (eg "moodleuser") that has access to that database - (and that database only). You could use the "root" user if you wanted to, but - this is not recommended for a production system: if hackers manage to discover - the password then your whole database system would be at risk, rather than - just one database. -
-Example command lines for MySQL:
-- # mysql -u root -p - > CREATE DATABASE moodle; - > GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,INDEX,ALTER ON moodle.* - TO moodleuser@localhost IDENTIFIED BY 'yourpassword'; - > quit - # mysqladmin -p reload --Example command lines for PostgreSQL:
-- # su - postgres - > psql -c "create user moodleuser createdb;" template1 - > psql -c "create database moodle;" -U moodleuser template1 - > psql -c "alter user moodleuser nocreatedb;" template1 --(For MySQL I highly recommend the use of phpMyAdmin - to manage your databases - you can do all this via a web interface).
-As of version 1.0.8, Moodle now supports table prefixes, and so can safely share - a database with tables from other applications.
-
-
--Firstly, make sure that your web server is set up to use index.php as a default - page (perhaps in addition to index.html, default.htm and so on).
-In Apache, this is done using a DirectoryIndex parameter in your httpd.conf - file. Mine usually looks like this:
---DirectoryIndex index.php index.html index.htm-Just make sure index.php is in the list (and preferably towards the start - of the list, for efficiency).
-Secondly, if you are using Apache 2, then you should turn on the AcceptPathInfo - variable, which allows scripts to be passed arguments like http://server/file.php/arg1/arg2. - This is essential to allow relative links between your resources, and also - provides a performance boost for people using your Moodle web site. You can - turn this on by adding these lines to your httpd.conf file.
---AcceptPathInfo on-Thirdly, Moodle requires a number of PHP settings to be active for it to - work. On most servers these will already be the default settings. - However, some PHP servers (and some of the more recent PHP versions) may - have things set differently. These are defined in PHP's configuration - file (usually called php.ini):
-- --magic_quotes_gpc = 1 (preferred but not necessary) -magic_quotes_runtime = 0 (necessary) -file_uploads = 1 -session.auto_start = 0 -session.bug_compat_warn = 0 --If you don't have access to httpd.conf or php.ini on your server, or you - have Moodle on a server with other applications that require different settings, - then don't worry, you can still OVERRIDE all of the default settings. -
To do this, you need to create a file called .htaccess in Moodle's - main directory that contains definitions for these settings. - This only works on Apache servers and only when Overrides have been allowed. - -
---DirectoryIndex index.php index.html index.htm - -<IfDefine APACHE2> - AcceptPathInfo on -</IfDefine> - -php_flag magic_quotes_gpc 1 -php_flag magic_quotes_runtime 0 -php_flag file_uploads 1 -php_flag session.auto_start 0 -php_flag session.bug_compat_warn 0-You can also do things like define the maximum size for uploaded files: - -
---LimitRequestBody 0 -php_value upload_max_filesize 2M -php_value post_max_size 2M --The easiest thing to do is just copy the sample file from lib/htaccess - and edit it to suit your needs. It contains further instructions. For - example, in a Unix shell: -
--cp lib/htaccess .htaccess-
-
--Now you can edit the configuration file, config.php, using a - text editor. This file is used by all other files in Moodle.
-To start with, make a copy of config-dist.php and name it - config.php. We do this so that your config.php won't be overwritten in case - you upgrade Moodle later on.
-Edit config.php to specify the database details that you - just defined (including a table prefix - notice that this is REQUIRED for - PostgreSQL), as well as the site address, file system directory and data directory. - The config file itself has detailed directions and examples.
-Once you have done this the rest of the installation is via a web interface. - For the rest of this installation document we will assume your site is at: - http://example.com/moodle
-
-
--The admin page should now be working at: http://example.com/moodle/admin. - If you try and access the front page of your site you'll be taken there automatically - anyway. The first time you access this admin page, you will be presented with - a GPL "shrinkwrap" agreement with which you must agree before you - can continue with the setup.
-(Moodle will also try to set some cookies in your browser. If you have your - browser set up to let you choose to accept cookies, then you must accept - the Moodle cookies, or Moodle won't work properly.) -
Now Moodle will start setting up your database and creating tables to store - data. Firstly, the main database tables are created. You should see a number - of SQL statements followed by status messages (in green or red) that look - like this:
---CREATE TABLE course ( id int(10) unsigned NOT NULL auto_increment, category - int(10) unsigned NOT NULL default '0', password varchar(50) NOT NULL default - '', fullname varchar(254) NOT NULL default '', shortname varchar(15) NOT - NULL default '', summary text NOT NULL, format tinyint(4) NOT NULL default - '1', teacher varchar(100) NOT NULL default 'Teacher', startdate int(10) - unsigned NOT NULL default '0', enddate int(10) unsigned NOT NULL default - '0', timemodified int(10) unsigned NOT NULL default '0', PRIMARY KEY (id)) - TYPE=MyISAM
-SUCCESS
-...and so on, followed by: Main databases set up - successfully.
-If you don't see these, then there must have been some problem with the database - or the configuration settings you defined in config.php. Check that PHP isn't - in a restricted "Safe Mode" (commercial web hosts sometimes have safe mode - turned on). You can check PHP variables by creating a little file containing - <? phpinfo() ?> and looking at it through a browser. Check all these and - try this page again.
-Scroll down the very bottom of the page and press the "Continue" - link.
-Next you will see a similar page that sets up all the tables required by - each Moodle module. As before, they should all be green.
-Scroll down the very bottom of the page and press the "Continue" - link.
-You should now see a form where you can define more configuration variables - for your installation, such as the default language, SMTP hosts and so on. - Don't worry too much about getting everything right just now - you can always - come back and edit these later on using the admin interface. Scroll down to - the bottom and click "Save changes".
-If (and only if) you find yourself getting stuck on this page, unable to - continue, then your server probably has what I call the "buggy referrer" problem. - This is easy to fix: just turn off the "secureforms" setting, then - try to continue again.
-The next page is a form where you can define parameters for your Moodle site - and the front page, such as the name, format, description and so on. Fill - this out (you can always come back and change these later) and then press - "Save changes".
-Finally, you will then be asked to create a top-level administration user - for future access to the admin pages. Fill out the details with your own name, - email etc and then click "Save changes". Not all the fields are - required, but if you miss any important fields you'll be re-prompted for them. -
-----------Make sure you remember the username and password you chose - for the administration user account, as they will be necessary to - access the administration page in future.
-(If for any reason your install is interrupted, or there is a system error - of some kind that prevents you from logging in using the admin account, you - can usually log in using the default username of "admin", - with password "admin".)
-Once successful, you will be returned to home page of your site. Note the - administration links that appear down the left hand side of the page (these - items also appear on a separate Admin page) - these items are only visible - to you because you are logged in as the admin user. All your further administration - of Moodle can now be done using this menu, such as:
--
-- creating and deleting courses
-- creating and editing user accounts
-- administering teacher accounts
-- changing site-wide settings like themes etc
-
-
--Some of Moodle's modules require continual checks to perform tasks. For example, - Moodle needs to check the discussion forums so it can mail out copies of posts - to people who have subscribed.
-The script that does all this is located in the admin directory, and is called - cron.php. However, it can not run itself, so you need to set up a mechanism - where this script is run regularly (eg every five or ten minutes). This provides - a "heartbeat" so that the script can perform functions at periods - defined by each module.
-Note that the machine performing the cron does not need to be the same - machine that is running Moodle. For example, if you have a limited web - hosting service that does not have cron, then you can might choose to run - cron on another server or on your home computer. All that matters is that - the cron.php file is called regularly.
-The load of this script is not very high, so 5 minutes is usually reasonable, - but if you're worried about it you can reduce the time period to something - like 15 minutes or even 30 minutes. It's best not to make the time period - too long, as delaying mail-outs can slow down activity within the course.
-First, test that the script works by running it directly from your browser:
---http://example.com/moodle/admin/cron.php-Now, you need to set up some of way of running the script automatically and - regularly.
-Running the script from a command line
-You can call the page from the command line just as you did in the example - above. For example, you can use a Unix utility like 'wget':
---wget -q -O /dev/null http://example.com/moodle/admin/cron.php-Note in this example that the output is thrown away (to /dev/null).
-The same thing using lynx:
---lynx -dump http://example.com/moodle/admin/cron.php > /dev/null-Alternatively you could use a standalone version of PHP, compiled to be run - on the command line. The advantage with doing this is that your web server - logs aren't filled with constant requests to cron.php. The disadvantage is - that you need to have access to a command-line version of php.
---/opt/bin/php /web/moodle/admin/cron.php - - -(Windows) C:\apache\php\php.exe C:\apache\htdocs\moodle\admin\cron.php - --Automatically running the script every 5 minutes
-On Unix systems: Use cron. Edit your cron settings from the commandline - using "crontab -e" and add a line like:
---*/5 * * * * wget -q -O /dev/null http://example.com/moodle/admin/cron.php-Usually, the "crontab" command will put you into the 'vi' editor. You enter - "insert mode" by pressing "i", then type in the line as above, then exit insert mode by - pressing ESC. You save and exit by typing ":wq", or quit without saving using ":q!" (without the quotes).
-On Windows systems: The simplest way is to use this little package moodle-cron-for-windows.zip - which makes this whole thing very easy. You can also explore using the built-in - Windows feature for "Scheduled Tasks".
-On web hosts: Your web-based control panel may have a web page that allows - you to set up this cron process. Ask your administrator for details on how - it works.
- -
--Now that Moodle is running properly, you can create a course.
-Select "Create a new course" from the Admin page (or the admin - links on the home page).
-Fill out the form, paying special attention to the course format. You don't - have to worry about the details too much at this stage, as everything can - be changed later by the teacher.
-Press "Save changes", and you will be taken to a new form where - you can assign teachers to the course. You can only add existing user accounts - from this form - if you want to create a new teacher account then either ask - the teacher to create one for themselves (see the login page), or create one - for them using the "Add a new user" on the Admin page.
-Once done, the course is ready to customise, and is accessible via the "Courses" - link on the home page.
-See the "Teacher Manual" for more details - on course-building.
-
- -
Version: $Id$
- diff --git a/lang/th/docs/installamp.html b/lang/th/docs/installamp.html deleted file mode 100644 index 76d87174fbb..00000000000 --- a/lang/th/docs/installamp.html +++ /dev/null @@ -1,155 +0,0 @@ - --- -Moodle is written in a scripting language called PHP, and stores most of its - data in a database. The database we recommend is MySQL. Before installing Moodle - you must have a working PHP installation and a working database to turn your - computer into a functional web server platform. These packages can be tricky - to set up for average computer users, so this page has been written to try to - make this process as simple as possible for different platforms:
--
-- Hosting Service
-- Mac OS X
-- Redhat Linux
-- Windows
--
Hosting Service
---Unfortunately hosting services vary quite a lot in the way they work. Some - will even install Moodle for you.
-Most will offer a web-based control panel to control your site, create databases - and set up cron. Some may also offer terminal access via ssh, so that you - can use the command shell to do things.
-You should work your way through the Installation - guide and take each step at a time. Ask your hosting provider if you get - stuck.
--
Mac OS X
---The easiest way to do this is use the Apache server that Apple provides, - and add PHP and MySQL using Marc Liyanage's packages. Both of the pages below - come with good instructions that we won't duplicate here:
---PHP: Download from here: http://www.entropy.ch/software/macosx/php/
-MySQL: Download here: http://www.entropy.ch/software/macosx/mysql/
-Once these are installed the standard Installation - guide should be fairly straightforward.
-A more detailed walkthrough is here: http://moodle.org/wiki/index.php/InstallingMoodle
--
Redhat Linux
---You should install all available RPM packages for Apache, PHP and MySQL. - One package that people frequently forget is the php-mysql package which is - necessary for PHP to talk to MySQL.
-Once these are installed the standard Installation - guide should be fairly straightforward.
-A more detailed walkthrough is here: http://moodle.org/wiki/index.php/InstallingMoodle
--
Windows
---The easiest way to do this is use EasyPHP, - a package that bundles all the software you need into a single Windows application. - Here are the steps from start to finish:
--
-- Firstly, if you have ever installed MySQL before (even as part of another - package), uninstall it all, delete all the MySQL files and make sure you - delete c:\my.cnf and c:\windows\my.ini.You - might want to do a search and delete ANY file called my.cnf - or my.ini.
-- If you've ever installed PHP before delete any files called php4ts.dll - from around your Windows directory, as well as any files called php.ini.
-- Download EasyPHP from here: http://www.easyphp.org/telechargements/dn.php?F=easyphp1-7 - (approx 10 Mb)
-- Run the downloaded file: easyphp1-7_setup.exe. The installation - process is in French but is otherwise much like installing any other Windows - program - I advise accepting the defaults and letting it all install. Note - that "Suivant" means Next and "Oui" means Yes.
-- At the end of the install leave the checkbox selected to "Lancer - EasyPHP" (Start EasyPHP) and hit the 'Terminer" button. You might - be taken to a information web page which you can safely ignore.
-- If all went well - congratulations! Apache, PHP and MySQL are all installed - and running! You should see a black E in your toolbar tray. You can right - click on it to get a menu which will let you control the running programs.
-- Some things may be in French and you may prefer English. You can download this file http://www.easyphp.org/telechargements/dn.php?F=indexUS_1.7 which contains English versions of www and home folder in the EasyPHP1-7 folder. These can be copied over the default files.
-- The next thing you need to do is to set up a database for Moodle to use. - Right-click the black E in the toolbar tray and choose Administration, then click DB Management (beside PHPMyAdmin).
-- If asked for a username, use "root" with a blank password. You - should see a phpMyAdmin web interface that allows you to create a new databases - and user accounts.
-- Create a new database by typing "moodle" into the field and - hitting the "Create" button. That was easy!
-- You can also create a new user to access your database if you want. This - can be a bit tricky for a first-time user, so you might just want to use - the existing user "root" with no password in your Moodle config - for now, and fix this later.
-- You're ready to install Moodle! Download the latest release of Moodle - from http://moodle.org/download, - then unzip the archive.
-- Copy your moodle files into C:\Program Files\EasyPHP\www. You - can either copy the entire moodle directory (ie C:\Program Files\EasyPHP\www\moodle) - or copy all the contents of the moodle directory. If you choose - this second option then you will be able to access your Moodle home page - using http://localhost/ instead of http://localhost/moodle/.
-- Make a new empty folder somewhere else for Moodle to store uploaded files - in, eg: C:\moodledata
-- Go into your Moodle folder. Make a copy of config-dist.php, and call - it config.php
-- Edit config.php using a text editor (Notepad will do, just be careful - that it doesn't add unwanted spaces at the end).
-- Put in all your new database info:
-
- $CFG->dbtype = 'mysql';
- $CFG->dbhost = 'localhost';
- $CFG->dbname = 'moodle';
- $CFG->dbuser = 'root';
- $CFG->dbpass = '';
- $CFG->dbpersist = true;
- $CFG->prefix = 'mdl_';- And put in all your file paths:
-
- $CFG->wwwroot = 'http://localhost/moodle'; // Use an external address - if you know it.
- $CFG->dirroot = 'C:\Program Files\EasyPHP\www\moodle';
- $CFG->dataroot = 'C:\moodledata';- Save config.php - you can ignore the other settings if there are any.
-- You're nearly there now! The rest of the setup is all web-based. Visit - http://localhost/moodle/admin/ - with your browser to continue the setup via your browser.
-- To use zip files with Moodle (for example the backups use zip) you might - need to enable "zlib". You can do this by going to your EasyPHP - directory (C:\Program Files\EasyPHP), and running the program - phpini.exe in there. Put a mark in the checkbox next to "zlib.dll". - Close that window, then go to the black E in your toolbar and right-click - it to get a menu - select "Restart" from this menu.
-- Lastly, you need to set up some sort of cron. See the Installation - guide for more details on this.
-If you don't or can't use EasyPHP, here are some a few tips to make sure - your PHP is set up correctly and avoid common problems:
--
-- Make sure you enable the GD module so Moodle can process images - you - may have to edit php.ini and remove the comment (;) from this line: 'extension=php_gd2.dll'. -
-- Make sure you enable the Zlib module so that you can create and unpack - zip files from within Moodle.
-- Make sure sessions is turned on - you may have to edit php.ini and fix - the directory for session.save_path - instead of the default - "/tmp" use a Windows directory like "c:/temp".
--
Version: $Id$
- - -