Note: You are currently viewing documentation for Moodle 2.2. Up-to-date documentation for the latest stable version is available here: Database fields.

Database fields: Difference between revisions

From MoodleDocs
(added more info and screenshot)
Line 52: Line 52:


=== Picture ===
=== Picture ===
[[File:Picturefield.png]]
[[File:Picturefield.png]]



Revision as of 21:08, 28 November 2011

This page requires updating for Moodle 2.2. Please do so and remove this template when finished.

A field is a named unit of information. Each entry in a database activity module can have multiple fields of multiple types e.g. a text field called 'favourite color' which allows you to type in your favourite shade, or a menu called 'state' that lets you choose one from a list of the 50 that make up the United States of America. By combining several fields with appropriate names and types you should be able to capture all the relevant information about the items in your database.


Field name and description

  • The name is what is shown when an entry is added. It must be unique and short. The description is for your benefit to help identify that field.

Field types

Checkbox

Checkboxfield1.png

This allows you to offer checkboxes for the user to select. Add the options one under the other. The word will appear next to a checkbox when the user clicks to add an entry. They can check more than one box.

Date

Datefield1.png

This allows a user to enter a date by picking a day, month and year from a drop down list.

File

Filefield.png

Users can upload a file from their computer. If it is an image file then the picture field may be a better choice.

Latitude/longitude

Latlongfield.png

Users can enter a geographic location using latitude and longitude. For example, Moodle HQ is at latitude -31.9545, longitude 115.877. When viewing the record, links are automatically generated linking to geographic data services such as Google Earth, OpenStreetMap, GeaBios,Mapstars and more. (The teacher can choose which of those links appear, if any.)

Menu

Menufield.png

The text entered in the options area will be presented as a drop-down list for the user to choose from. Each line become a different option.

Menu (Multi-select)

Multiselectfield.png

The text entered in the options area will be presented as a list for the user to choose from and each line become a different option. By holding down control or shift as they click, users will be able to select multiple options. This is a fairly advanced computer skill so it may be wise to use multiple checkboxes instead.

Number

Stores a floating number. Examples:

  • -1000
  • 0
  • 0.123

Picture

Picturefield.png

This allows a user to upload and display an image file. "Single view" is when the image is viewed on its own; "list view" is when it is viewed in with other images. Single view can be larger than list view.

Radio buttons

Allows the user to choose one from a range of options. If the user doesn't select any of these options then they will be prompted to do so and can only submit the entry when one option is chosen.

If you only have two options and they are opposites (true/false, yes/no) then you could simply use a single checkbox instead. However checkboxes default to their unchecked status and so people could submit without actively selecting one of the options. This may not always be appropriate.

Text

Users can enter text up to 60 characters in length. For longer text, or for text that requires formatting such as headers and bullet points, you can use a textarea field.

Textarea

Allows users to enter a long piece of text including formatting similar to that found when creating forum posts. Max number of characters in text area = ?

URL

Ask the user to enter a URL. If you select autolink then the URL becomes a clickable link. If you also enter a forced name for the link then that text will be used for the hyperlink. For example in a database of authors you may wish people to enter the author's website. If you enter the text 'homepage' as a forced name then clicking on text "homepage" will take you to the entered URL.

See also