OER Exchange moderation queue block

From MoodleDocs

The OER Exchange: moderation queue block is a Dashboard block for the moderators of an OER Exchange site. It shows, at a glance, what needs their attention: open reports, failed uploads and site registrations waiting for approval. Each heading links to the Exchange page where you deal with it. It is one of the Dashboard blocks for OER Exchange; see OER Exchange for the whole platform.

Installation

Install the plugin from the Moodle plugins directory, or download the ZIP file and follow Installing plugins. The files go in the folder blocks/oerexchangemodqueue. The plugin supports Moodle 5.0 to 5.3.

The block needs the OER Exchange plugin (local_oerexchange) 1.1.0 or later on the same site, and cannot be installed without it. Install it on the Exchange site, not on a client site.

Adding the block

  1. On your Dashboard, turn on Edit mode and add the OER Exchange: moderation queue block (see Blocks).
  2. Turn off Edit mode.

The block can only be added to the Dashboard, once per Dashboard. It has no settings of its own (apart from the usual Block settings) and no site settings. By default only managers can add it.

Using the block

The block on a moderator's Dashboard, with an open report and a failed parse.

The block shows the following sections. Each heading shows the current number in brackets and links to the page where you act on it. Below some headings, the block lists up to five items.

  • Open resource reports (N): reports about resources that are still open, with the titles of the five oldest. Links to the Moderation queue.
  • Open collection reports (N): reports about collections that are still open, with the titles of the five oldest. Reports about resources and about collections are counted separately. Links to the Moderation queue.
  • Failed parses (N): shared course backups that the Exchange could not read, with the titles of the five most recent. This usually means a damaged or incomplete upload. Links to the Moderation queue.
  • Hidden by moderators (N): how many resources a moderator has taken down and is still holding. Resources that the Exchange removed automatically are not counted. Links to Resources hidden by moderators.
  • Collections taken down (N): how many collections a moderator has taken down and is still holding. Collections that their owner has deleted are not counted. Links to Resources hidden by moderators, which lists held collections too.
  • Pending site registrations (N): client sites that have registered with the Exchange and wait for approval, with the names of the five oldest. Links to Registered sites.

If a resource or collection has been deleted since it was reported, the list shows (deleted resource) or (deleted collection) instead of its title.

The same pages are also in Site administration > Plugins > Local plugins > OER Exchange. How to handle reports, take resources down and approve sites is described on the OER Exchange page.

Who sees what

The sections depend on the viewer's capabilities in the OER Exchange plugin, not on who added the block:

  • local/oerexchange:moderate (Moderate reports and failed parses): the two report sections, Failed parses, Hidden by moderators and Collections taken down.
  • local/oerexchange:managesites (Manage registered client sites and the sandbox plugin allowlist): Pending site registrations.

Both are given to managers by default. A user with only one of them sees only that part of the block, and a user with neither sees nothing.

Capabilities

  • block/oerexchangemodqueue:myaddinstance (Add a new OER Exchange moderation queue block to Dashboard): add the block to your own Dashboard. Allowed for managers by default.
  • block/oerexchangemodqueue:addinstance (Add a new OER Exchange moderation queue block): add the block to other pages. Allowed for managers by default, but the block can only be placed on the Dashboard.

Unlike the other OER Exchange blocks, teachers and authenticated users cannot add this block by default, because it shows moderation information. See Capabilities.

Privacy

The block stores no data of its own. It only shows data that the OER Exchange plugin already stores (reports, uploads and site registrations), and that plugin's privacy provider handles it. See Privacy.

See also