This is a test site. Any changes will be lost!

Blocks administration: Difference between revisions

From MoodleDocs
Reformat page 3 major sections with sub sections, configurations are see also
m See also: link edit
 
(20 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Location: ''Administration > Modules > Blocks''  
Location: ''Administration > Modules > Blocks''
[[Image:blocks admin.png|thumb|Blocks administration]]


The blocks administration page enables the administrator to manage installed blocks and their settings. It is also possible to install 3rd party blocks to a Moodle site.
The blocks administration page enables administrators to manage installed blocks and their settings.


==Block administration page==
This page can be found in the [[Site administration block]] under Modules. It is a table that lists all the installed blocks. In addition to the columns below, the  block name and it's install version number are also shown.


=== Hide ===
==Hiding a block==
The site administrator can hide or reveal a specific block from all users by clicking on the icon.  This is different than deleting.


=== Instances ===
The hide/show column allows selected blocks to be hidden i.e. they do not appear in any course "Add a block" dropdown menu and cannot be used in any course. To hide a block, click the eye icon so that it changes to a closed eye.


This column provides a number of all the times the particular type of block is used in the courses on the Moodle site. It is linked to a list of those courses.
To reduce the length of course "Add a block" dropdown menus, you should hide blocks which will not be used, such as global search (unless you have enabled the global search feature in ''Administration > Miscellaneous > Experimental''), mentees (unless you have added a [[Parent role|mentor role]]) and network servers (unless you are using [[Moodle Network|Moodle Networking]]).


=== Multiple ===
==Instances==


The multiple column shows which blocks are capable of being added more than once to a course, with an option to turn off this feature.  
The blocks page also lists the number of instance for each block. Clicking on a number results in the list of courses containing that block being displayed.


=== Delete===
==Multiple blocks==


To delete a block click here and it will be removed from Moodle. However you will need to use a file manager and remove/delete the actual module directory from the moodle/blocks directory, otherwise Moodle will reinstall it next time you visit the admin page.
Some blocks, such as the HTML block, can be used more than once on a course page. You can choose whether or not to allow this by clicking the change link in the Multiple column.


=== Settings ===
==Block deletion==
Some blocks have additional settings that can be modified by the administrator.


==Adding a non-standard block==
Any block can be deleted using the link in the delete column. There is no reason for standard blocks to be deleted, however non-standard blocks may need to be deleted before upgrading.


You may add [[:Category:Block (non-standard)|non-standard blocks]] simply by using a file manager to copy the new block as a directory into the moodle/blocks directory and Moodle will install it next time you visit the admin page.  Moodle uses the name of the directory as the name of the block.  The same applies for blocks which you delete and wish to reinstall later.
Note: To delete a block completely, in addition to deleting it on the blocks page, you also need to remove/delete the actual block folder from the ''moodle/blocks'' folder, otherwise Moodle will reinstall it next time you access the site administration.
 
==Block settings==
A few blocks have additional settings, which can be accessed via the links in the settings column.
 
*[[Courses block settings]]
*[[Online Users block settings]]
*[[Remote RSS Feeds block settings]]
 
==Blocks (administrator) list==
In edit mode, a Moodle page can show a block which contains a list of blocks that are available to add in that context for a [[Roles and capabilities|role]]There are special blocks only available to [[Administrator]].
 
Examples of context include  a Site's front page or a Course's main page and more recently to include a block in an activity module. Some blocks only appear once in a specific context. Only being able to show one site administration block on the main page.  A few [[Blocks (teacher)|teacher blocks]] are available to administrators in their contextual pull down menu. 
 
The list below has the administrator blocks shown in '''bold''':
 
{| border="0"
| |
{| border="2";"
|'''[[Activities block]]'''
|-
|'''[[Student projects/Admin page cleanup/Bookmarks|Admin bookmarks block]]'''
|-
|'''[[Blog Menu block|Blogs Menu]]'''
|-
|'''[[Blog Tags block|Blogs Tags]]'''
|-
|[[Calendar block|  Calendar]]
|-
|Course/Site description links to '''[[Front Page settings|Site Front Page settings]]''' or '''[[Course settings]]'''
|-
|'''[[Courses block|Courses]]'''
|-
|  [[Global Search block]]
|-
|[[HTML block|HTML]]
|-
|'''[[Latest News block]]'''
|-
|[[Loan calculator block|Loan Calculator]] (from 1.6 onwards)
|-
|'''[[Main menu block]]'''
|-
|'''[[Log in|Login]]'''
|-
|[[Mentees block]] (from 1.8 onwards)
|-
|[[Messages block|Messages]]
|-
|'''[[Network Servers block]]'''
|-
|'''[[People block]]'''
|-
|[[Random Glossary Entry]]
|-
|'''[[Recent Activity block]]'''
|-
|[[Remote RSS Feeds]]
|-
|'''[[Search Forums block|Search Forums]]'''
|-
|'''[[Site administration block|Site Administration]]'''
|-
|[[Upcoming Events block]]
|-
|'''[[Sticky blocks]]'''
|-
|}
| style="width:100px" |  
|[[Image:Block add dropdown list admin 1 8.JPG|thumb| Example of a Blocks pulldown menu for Administrators]]
|}
 
==Contributed blocks==
 
In addition to using the blocks included in the standard download, other Moodlers have developed their own blocks which they share with the Moodle community. You can download these contributed blocks from the Moodle.org [http://moodle.org/mod/data/view.php?id=6009 Modules and plugins database].
 
Warning: Be aware that contributed blocks may have quality issues, may not work correctly, and may not work when you upgrade Moodle. You should test them thoroughly before using them and be prepared to uninstall them before upgrading.


==See also==
==See also==
*[[Courses block configuration]]
 
*[[Online Users block configuration]]
*[[Remote RSS Feeds block configuration]]
*[[Block layout]]
*[[Block layout]]
Or the block category index below
*[[Installing contributed modules or plugins]]


[[Category:Block]]
[[Category:Block]]
[[eu:Blokeak_%28Kudeatzailea%29]]
[[ja:ブロック管理 (管理者)]]
[[ja:ブロック管理 (管理者)]]

Latest revision as of 16:42, 13 March 2008

Location: Administration > Modules > Blocks

Blocks administration

The blocks administration page enables administrators to manage installed blocks and their settings.


Hiding a block

The hide/show column allows selected blocks to be hidden i.e. they do not appear in any course "Add a block" dropdown menu and cannot be used in any course. To hide a block, click the eye icon so that it changes to a closed eye.

To reduce the length of course "Add a block" dropdown menus, you should hide blocks which will not be used, such as global search (unless you have enabled the global search feature in Administration > Miscellaneous > Experimental), mentees (unless you have added a mentor role) and network servers (unless you are using Moodle Networking).

Instances

The blocks page also lists the number of instance for each block. Clicking on a number results in the list of courses containing that block being displayed.

Multiple blocks

Some blocks, such as the HTML block, can be used more than once on a course page. You can choose whether or not to allow this by clicking the change link in the Multiple column.

Block deletion

Any block can be deleted using the link in the delete column. There is no reason for standard blocks to be deleted, however non-standard blocks may need to be deleted before upgrading.

Note: To delete a block completely, in addition to deleting it on the blocks page, you also need to remove/delete the actual block folder from the moodle/blocks folder, otherwise Moodle will reinstall it next time you access the site administration.

Block settings

A few blocks have additional settings, which can be accessed via the links in the settings column.

Blocks (administrator) list

In edit mode, a Moodle page can show a block which contains a list of blocks that are available to add in that context for a role. There are special blocks only available to Administrator.

Examples of context include a Site's front page or a Course's main page and more recently to include a block in an activity module. Some blocks only appear once in a specific context. Only being able to show one site administration block on the main page. A few teacher blocks are available to administrators in their contextual pull down menu.

The list below has the administrator blocks shown in bold:

Activities block
Admin bookmarks block
Blogs Menu
Blogs Tags
Calendar
Course/Site description links to Site Front Page settings or Course settings
Courses
Global Search block
HTML
Latest News block
Loan Calculator (from 1.6 onwards)
Main menu block
Login
Mentees block (from 1.8 onwards)
Messages
Network Servers block
People block
Random Glossary Entry
Recent Activity block
Remote RSS Feeds
Search Forums
Site Administration
Upcoming Events block
Sticky blocks
Example of a Blocks pulldown menu for Administrators

Contributed blocks

In addition to using the blocks included in the standard download, other Moodlers have developed their own blocks which they share with the Moodle community. You can download these contributed blocks from the Moodle.org Modules and plugins database.

Warning: Be aware that contributed blocks may have quality issues, may not work correctly, and may not work when you upgrade Moodle. You should test them thoroughly before using them and be prepared to uninstall them before upgrading.

See also