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

Managing blocks: Difference between revisions

From MoodleDocs
(adding a non-standard block)
 
(46 intermediate revisions by 9 users not shown)
Line 1: Line 1:
Location: Administration >> [[Configuration]] >> Blocks  
{{Blocks}}
==Manage blocks==


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


== Instances ==
===Instances===


This number tells you how many times a particular type of block is used in the courses on your Moodle site.
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.


== Multiple ==
===Hiding a block===


Some blocks can be added multiple times to the same course. This of course is supported only by blocks for which it makes sense. For example, it makes sense to have two HTML blocks (and configure each one to show something different), but it doesn't make sense to have two Administration blocks. For those blocks which do support multiple instances, the administrator can choose to allow it or not.
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.  


== Delete==
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 Network|Moodle Networking]]).


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.
===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 [[Settings 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.


==Adding a non-standard block==
===Block deletion===


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


==Block configuration==
:''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.


*[[Courses block configuration|Courses]]
===Block settings===
*[[Online Users block configuration|Online Users]]
 
*[[Remote RSS Feeds block configuration|Remote RSS Feeds]]
Certain blocks have additional settings, which can be accessed via the links in the settings column.
 
==Block capabilities==
 
*[[Capabilities/moodle/my:manageblocks|Manage My Moodle page 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]]
 
==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/plugins Moodle Plugins directory]. See [[Installing plugins]] for details of how to install a block.


==See also==
==See also==
Line 29: Line 47:
*[[Block layout]]
*[[Block layout]]


[[Category:Administrator]]
[[Category:Site administration]]
[[Category:Block]]
 
[[eu:Blokeak_%28Kudeatzailea%29]]
[[ja:ブロック管理 (管理者)]]
[[de:Administration_von_Bl%C3%B6cken]]

Latest revision as of 21:30, 6 August 2012

Manage blocks

An administrator can manage Moodle's blocks for the site in Settings > 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 Network|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 Settings 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 link in the delete column (but see comments about the Settings block and Navigation block in the previous section) There is usually no reason for standard blocks to be deleted (they are usually hidden) 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

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

Block capabilities

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