Note: You are currently viewing documentation for Moodle 3.1. Up-to-date documentation for the latest stable version of Moodle is probably available here: Managing blocks.

Managing blocks: Difference between revisions

From MoodleDocs
(→‎Blocks (administrator) list: change list to 1.9)
(changed delete to uninstall)
 
(26 intermediate revisions by 8 users not shown)
Line 1: Line 1:
Location: ''Administration > Modules > Blocks''
{{Blocks}}
[[Image:blocks admin.png|thumb|Blocks administration]]
==Manage blocks==


The blocks administration page enables administrators to manage installed blocks and their settings.
An administrator can manage Moodle's blocks for the site in ''Administration > Site administration > Plugins > Blocks > Manage blocks'', including any contributed blocks that have been added.  


===Instances===


==Hiding a block==
The blocks page  lists the number of instance for each block. Clicking on a number results in the list of courses containing that block being displayed.  See [[Block settings]] for configuration settings that might be of interest to a site administrator or someone with Front Page editing permissions.


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.
===Version===


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]]).
Listed with each block is its version number — in the format 2012061700. This is helpful to ensure that you have the latest version of each block.


==Instances==
===Hiding a block===


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.
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.  


==Multiple blocks==
To reduce the length of course "Add a block" dropdown menus, you should hide blocks which will not be used, such as mentees (unless you have added a [[Parent role|mentor role]]) and network servers (unless you are using [[MNet|Moodle Networking]]).


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.
===Protecting blocks from deletion===


==Block deletion==
By clicking the padlock against a block in this column, you are preventing it from being deleted on the site. The [[Administration block]] and [[Navigation block]] are already padlocked, as major difficulties arise if these blocks are deleted. Only unlock them if you are absolutely sure you understand the consequences and have alternative settings and navigation features in place.


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.
===Block deletion===


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.  
Blocks can be deleted using the Uninstall link for the appropriate block (but see comments about the [[Administration block]] and [[Navigation block]] in the previous section) There is usually no reason for standard blocks to be uninstalled  (they are usually hidden) However, non-standard blocks may need to be uninstalled before upgrading.


==Block settings==
:''Note:'' To delete a block completely, in addition to uninstalling 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.
A few blocks have additional settings, which can be accessed via the links in the settings column.


*[[Courses block settings]]
===Block settings===
*[[Online Users block settings]]
*[[Remote RSS Feeds block settings]]


==Blocks (administrator) list==
Certain blocks have additional settings, which can be accessed via the links in the settings column.
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. 
==Block capabilities==


The list below has the administrator blocks shown in '''bold''':
*[[Capabilities/moodle/my:manageblocks|Manage dashboard blocks]]
*[[Capabilities/moodle/tag:editblocks|Edit blocks in tags pages]]
*[[Capabilities/moodle/user:manageownblocks|Manage blocks on own public user profile]]
*[[Capabilities/moodle/user:manageblocks|Manage blocks on user profile of other users]]
*[[Capabilities/moodle/block:edit|Edit a block's settings]]
*[[Capabilities/moodle/block:view|View block]]
*[[Capabilities/moodle/site:manageblocks|Manage blocks on a page]]


{| border="0"
In addition, every block has an ''addinstance'' capability (e.g. [[Capabilities/block/comments:addinstance|block/comments:addinstance]]) and most blocks also have a ''myaddinstance'' capability (e.g. [[Capabilities/block/comments:myaddinstance|block/comments:myaddinstance]]) for controlling whether a user with a particular role can add the block to a page or to their [[Dashboard]] respectively.
| |
{| 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]]
|-
|'''[[Main menu block]]'''
|-
|[[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]]
|-
|[[Upcoming Events block]]
|-
|}
| style="width:100px" | 
|[[Image:Block add frontpage dropdown list admin 1 9.jpg|frame|left| Admin blocks for site frontpage 1.9]]
|}


==Contributed blocks==
==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].
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/plugins Moodle Plugins directory]. See [[Installing plugins]] for details of how to install a block.
 
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==
*[[Block layout]]
*[[Block layout]]
*[[Installing contributed modules or plugins]]


[[Category:Block]]
[[Category:Site administration]]


[[eu:Blokeak_%28Kudeatzailea%29]]
[[eu:Blokeak_%28Kudeatzailea%29]]
[[ja:ブロック管理 (管理者)]]
[[ja:ブロック管理 (管理者)]]
[[de:Administration_von_Bl%C3%B6cken]]
[[es:Gestionando bloques]]

Latest revision as of 22:29, 3 August 2015

Manage blocks

An administrator can manage Moodle's blocks for the site in Administration > Site administration > Plugins > Blocks > Manage blocks, including any contributed blocks that have been added.

Instances

The blocks page lists the number of instance for each block. Clicking on a number results in the list of courses containing that block being displayed. See Block settings for configuration settings that might be of interest to a site administrator or someone with Front Page editing permissions.

Version

Listed with each block is its version number — in the format 2012061700. This is helpful to ensure that you have the latest version of each block.

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 mentees (unless you have added a mentor role) and network servers (unless you are using Moodle Networking).

Protecting blocks from deletion

By clicking the padlock against a block in this column, you are preventing it from being deleted on the site. The Administration block and Navigation block are already padlocked, as major difficulties arise if these blocks are deleted. Only unlock them if you are absolutely sure you understand the consequences and have alternative settings and navigation features in place.

Block deletion

Blocks can be deleted using the Uninstall link for the appropriate block (but see comments about the Administration block and Navigation block in the previous section) There is usually no reason for standard blocks to be uninstalled (they are usually hidden) However, non-standard blocks may need to be uninstalled before upgrading.

Note: To delete a block completely, in addition to uninstalling 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

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

Block capabilities

In addition, every block has an addinstance capability (e.g. block/comments:addinstance) and most blocks also have a myaddinstance capability (e.g. block/comments:myaddinstance) for controlling whether a user with a particular role can add the block to a page or to their Dashboard respectively.

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 Moodle Plugins directory. See Installing plugins for details of how to install a block.

See also