Blocks are items which may be added to almost any page in Totara Learn and can be used to add additional content to pages throughout your Totara Learn site that are useful to users. For example, a Course completion status block may be added to a course page so that learners can quickly access and view their course progress. A Calendar block might be added to the site front page so that site users can see a list of events.
Blocks are managed by a site administrator or role with the site:manageblocks capability.
- Click Plugins > Blocks > Manage blocks on the Site administration menu.
- A list of blocks will be presented in a table providing information about each block, including additional options (where applicable):
- Name: Displays the name of the block.
Instances: Displays the total number of specific blocks created on your Totara Learn site.
- Version: Displays the version number of the block.
- Hide/Show: Click the eye icon to hide or show a specific block.
- Protect instances: Use this option to lock a particular type of block. Once locked, no-one will be able to add or delete instances. You can, of course, unlock again if you need to edit instances. This is intended to protect blocks like Navigation and Administration which can be very hard to get back if accidentally deleted.
- Settings: Some blocks provide a Settings link so that block defaults may be configured.
- Uninstall: Select the Uninstall link to uninstall a specific block.
Uninstalling a block will completely delete everything in the database associated with the plugin, including its configuration, log records, user files managed by the plugin etc. There is no way back and Totara Learn itself does not create any recovery backup.
The Activities block lists and allows navigation between the different activities available in a course (Forums, Quizzes, Assignments, Lesson module etc).
|Activity results||This block displays results from graded or rated activities in a course. You can then choose to display a number of highest or lowest scores, and whether to display individuals or groups.|
This block allows an administrator to bookmark site admin pages for easy access. These include the Notifications and Add/Edit courses pages. The administrator will then see the pages as a list of links.
Only site admin pages can be bookmarked i.e. pages accessed via Administration > Site administration.
The Administration block provides context-sensitive links to settings pages.
What appears in the Administration block depends upon the Context (Page being shown and user's permissions). For example, a site administrator on the front page will have Front page settings while a trainer in a course will have more options in Course administration than a learner
Displays a list of all system alerts related to logged in user.
The blog menu block provides links to:
Plus context-sensitive links for adding an entry about the course or a particular activity (if blog associations are enabled for the site and if a user has appropriate permissions).
A Blog Tags block displays a list of blogs where font size visually indicates each blog's use. The more frequently used blogs appear in a larger font size and least used in smaller fonts. This format is sometimes called a 'tag cloud'.
The Calendar block displays the following events:
The comments block can be added to any page to allow users to add comments.
The community finder block enables users to access public community hubs, such as Moodle.net, and search for courses to download or enrol in.
Course completion status
The course completion status block shows what has been done towards completing the course. The learner and trainer will both see this block.
The Course overview block is visible on a user's Dashboard and shows a list of all courses in which a user is enrolled/has an assigned role.
By default this block appears in the central content block on the Dashboard but can be moved to the left or right column.
The course/site summary block provides a summary and/or description for a course as contained in the summary text of the course settings.
The Courses block lists and allows navigation between all of the courses in which the logged in user is enrolled in. The block title shows as My courses and allows one-click access to a course's home page.
Provide a way to create custom dashboards and assign to groups of users (audiences).
Provides site-wide listings of all sessions and user bookings.
The Feedback block may be added to courses to provide a quick link to global feedback activities which have been set up from the front page.
The Flickr block settings allow the images that are displayed in the block to be changed based on Relevance (default), Date Posted, Date Taken, and Interestingness.
The Flickr block can only be added to a Tags page.
Links to Google Apps services for your domain.
An HTML block is a standard block used to add text, multimedia, widgets etc to a site front page or course page.
Recent posts made in the News forum are displayed in the Latest news block, along with a link to older archived news.
Learning plans allow staff quick and targeted access to relevant learning; including face to face events and e-learning. The learning plan enables staff to see at a glance their progress against specific learning events and the whole plan.
Logged in user
The logged in user block displays certain information about the user who is currently logged into a course.
The Login block provides logged out users an in-site area to enter their Username and Password and login, Create a new account, or retrieve/reset their password.
The main menu block can be used to add resources and activities to the front page.
The Mentees block is a front page block that provides mentors with quick access to their mentee(s) profile page(s). A mentor might be a parent for example who has access to their child's information through the link in the block.
The message block displays a list of new messages that have been received by the logged in user, with a link to their Messages window.
My latest badges
The My latest badges block can be added to the Site front page, a user's My home page or a course page and will display badges earned.
My Learning Nav
Provides a link to all courses a user is enrolled in.
My private files
The My private files block enables access to a user's private files area.
Provides a way for a manager to view information related to their staff.
The navigation block appears on every page of the site. It contains an expanding tree menu which includes Dashboard, Site Pages, and Courses. What appears in the navigation block depends on the role of the user, where they are in the site, and any settings that have been applied globally.
The Network Servers block allows users to roam to other Totara, Moodle, or Mahara servers. Works in conjunction with the 'Can roam to other Moodles' permission which allows a user to roam to another Moodle site which is part of a Moodle Network. The Moodle Network (MNet) feature allows a Moodle administrator to establish a link with another Moodle, and to share some resources with the users of that Moodle.
The Online users block shows a list of users who have been logged into the current course. The list is updated on a regular basis (the default is every 5 minutes but this may be changed).
The People Block contains a link to the list of participants associated with a course area in various roles.
Provides quick link to Totara Learn home, reports, and courses.
The quiz results block displays the highest and/or lowest grades achieved on a quiz within a course. There must be a quiz in the course to correctly configure this block.
Random glossary entry
The random glossary block can be used to display random entries from a glossary, which usually take the form of dictionary style definitions.
The Recent activity block lists course activity, such as updated resources and activities, forum posts and assignment submissions, since the user last accessed the course.
Recent blog entries
This block can be configured to display a certain number of the latest blog entries, filtered by context. For example, if you are viewing an assignment activity, this block would display the latest blog entries that are associated with that assignment.
Provides a link to a recent course the user has been working on.
Remote RSS feeds
The RSS feeds block enables RSS feeds from external websites to be displayed within Totara Learn. As the information on the other site (for example, news headlines or recently added documents) is changed the block will update to show the latest information.
This block can be added to pages to display the graph from a report. It can be used to build graphical dashboards.
Provides access to a list of reports to which a user has access.
The Search forum block allows you to search the course forums for a word or phrase. Type the word or phrase you want to find in the text field space.
The Section links block helps the student or teacher to quickly navigate to a particular topic/week section of the course (depending on whether the course uses either the 'Topics' or 'Weekly' format. The numbered links displayed within the block are the numbers assigned to the course topic/week sections.
The self completion block provides a link for students to declare that they have completed the course. This may be part of the Course completion requirements.
This block enables additional activities to be added to a course in social format. Note: it is not available for other course formats.
Provides statistics and information on what user's staff have been doing in Totara Learn.
A very effective way of viewing all tags is in a tags block, or 'tag cloud'.
Tags allows students and teachers to describe their interests in a way that is easy for people with similar interests to find them. The user's profile has a place to enter interests, which will create or add the user to an existing tag. Tag pages can be viewed and blog posts can be tagged.
Provides a list of system tasks that require action.
Displays any upcoming certification work a learner has been assigned.
The Upcoming events block displays future events in a summarised list. Events are generated directly from the calendar and/or activity deadlines, providing a link to full details or directly to the activity.
The YouTube block can only be added to a Tags page. This block will pull YouTube videos with the same tag words related to the current Tags page.
Program completions block
The Program completions block lists one or more selected programs and the user's completion status for each.
The program names displayed in the block content link to the individual programs. The user's completion status displays a progress bar if the logged in user is assigned to the program, otherwise Not assigned is displayed.
The block honours availability and visibility settings so only programs that are available to and visible by the logged in user may be displayed.
Adding Program completions block to a page
- Select Turn editing on for the particular page.
- Then select Program completions from the Add a block... menu.
Configuring Program completions block
Configurable options specific to the Program completions block are:
- Title: The title text to display in the block header. Program completions is used if no title text is specified.
- Title link: Text to use as a URL if you want the block title to function as a link. URL validity is not checked. Leave empty for a plain text block title that does not function as a link.
- Programs: The programs to be considered for display in the block content. Selected programs will be displayed in a list underneath this option. Programs can be deleted from this list using the delete icon next to the program name. If no programs have been selected in this option the block is not displayed.
- Show not assigned: By default the block only displays the programs (selected in the above option) which have been assigned to the logged in user. This checkbox can be used to show all programs selected in the above option, including those that have not been assigned to the logged in user. If this option is unchecked (default) and the logged in user is not assigned to any of the programs (selected in the above option) the block is not displayed.
- Maximum show: Defines the maximum number of programs to show in the list before displaying a Show more... link. Clicking Show more... displays the full list along with a Show less... link allowing the user to toggle between displaying the maximum defined number of programs and the full list. Leave empty or 0 for unlimited.
Report table block
The Report table block displays tabular data belonging to a selected Report builder report. Optionally a saved search for the report can also be selected to limit the data shown in the block.
The block content only displays the data table from the selected report including pagination and the option to sort by column headings. Other report functionality (such as filters, saved searches, and export options) are not included but can be accessed by clicking the View full report link at the bottom of the block content.
The records shown in the data table are restricted to the records accessible by the logged in user, not for the user who created the block.
If the selected report or selected saved search being used becomes unavailable (for example it is deleted or the search is made not public) then the block will act as if no report was selected and the block will not be shown.
Note that configuring two blocks with same report on the same page can interfere with column sorting.
Adding Report table block to a page
- Select Turn editing on for the particular page.
- then select Report table from the Add a block... menu.
Configuring Report table block
Configurable options specific to the Program completions block are:
- Title: The title text to display in the block header. If no title text is specified (default) the name of the selected report is used as the block title.
- Report: The Report pulldown allows you to select which report to display in the block. If no report is selected or if the logged in user does not have access to the selected report, the block will not be shown.
Only user generated reports are listed for selection. Embedded reports are not included since they may depend on URL parameters that are not be available on every page where the block may be displayed. User generated reports with Hide in my reports checked are still included in the dropdown list.
Only reports that the block creator has access to will be displayed in the dropdown list. The currently selected report is always shown, even if the user configuring the block does not have access to it. For example, if the block is created by one user then edited by another or the block creator loses access to a report they previously selected for display in the block. If the user switches to a different report then the inaccessible report is removed and is unavailable for selection on subsequent configuration attempts.
Saved search: Once a report is selected the Saved search dropdown is enabled and automatically populated with any public saved searches associated with the selected report. All available data is the default and the only option available if the report has no public saved searches.
Modifying the Report dropdown will reset the Saved search dropdown. If a selected saved search becomes unavailable the behaviour of the Saved search dropdown is the same as for a report that has become inaccessible (see above).
Backward incompatibility of saved searches with third party filters might occur. If saved searches do not work with your third party filters please contact the developer of these filters to update them.
- Hide block if zero results: If checked (the default) then the entire block is hidden if the selected report and associated saved search setting returns no records accessible by the logged in user. If unchecked and no results are returned then the block is shown with a message 'There are no records that match your selected criteria'.