Proyectos de Subversion Moodle

# Moodle plugin « Point of View »

[![Licence GPL v3](https://img.shields.io/badge/license-GPL%20v3-informational)](https://github.com/Astor-Bizard/moodle-block_point_view/blob/master/LICENSE)

[![Moodle code prechecks](https://img.shields.io/badge/code%20prechecks-3%20errors%20|%204%20warning-critical?logo=data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAQAABILAAASCwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKHzzACd78xkoffM3LIH0MD+N9Qcjf/QALof1ICuH9TguivUrOpL2A4nA+gE0k/YnLI/2ODOT9ywAAAAAAAAAACh88wAne/NuKH3z9iyB9NQ/jfUdI4D0AC6H9Y4rh/X5Lor1vjqS9g2JwPoFNZP2rCyP9vczk/fEZJb1AmOV9QYqfvMAJ3zzdCh98/8sgfTgP431HySA9AAuiPWWK4f1/y6K9ck6kvYNicD6BTWT9rYsj/b/M5T3zzt68yI0dfIxLXrzACd883QoffP/LIH04D+N9R8kgPQAL4j1liuH9f8uivXJOpL1DYnA+gU1k/a2LY/2/zOU9880dfJNMnPySSp38gAnfPN0KH7z/yyC9eBAjvYfJID1AC+I9ZYrh/X/Lov1yTuT9g2JwPoFNZP2ti2P9v8zlPfPO3rzPDt68y8uevIAKHzzdCl98P8ugO7iQovtIRt57wAviPWYK4f1/y6L9cs8k/YOf7v6BTST9rcsj/b/M5T3zzt69BU/fPQQRWyrAFV0oHpTa4//R1l1+EJFTKlET2FXMIj0xCuH9f8ui/XnPpX2QUCY9y8wkPbWLI/2/zOU975mjdgedoy3LpKNiB9hXl2ZT0xM/0VCQ/80MjT/Ky00+S1foP0th/P9LIn1/y6M9eoujvbmLI72/y+Q9vQ7mPdpkJ++G3mEnnxqb33QWlxl9UtLUP9BQEP/NTQ3/ygnKf8qMT7TOYHZczKN960vjPXcL4723jCQ9r84lfZhV6b4CHR8jwB9hpwGZmx8PFVaaZlFS1rfOzxF+y8uMf8rKS3/NDI1nVBCNhBMqv8GRZj2GUaa9xtLnvcLxOH8AH+6+QAAAAAAAAAAAG1mXQB+c2MDV1VWIUVER1g3NjmNLSwwtSkoLM00MzaVVFNUHzc2OQDHxcIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAClpaYA4uLiAFZVWAY6Oj0TODY6JFVUVhUFBAkAw8LCAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA//8AAP//AADhAAAA4QAAACEAAAAhAAAAIQAAACEAAAAgAAAAAAAAAAAAAACAAQAA4B8AAPwfAAD//wAA//8AAA==)](https://moodle.org/plugins/block_point_view/v1.7/28329)

[![Licence GPL v3](https://img.shields.io/badge/downloads%20(last%2012%20months)-1,2k-green)](https://moodle.org/plugins/block_point_view/stats)

_Quentin Fombaron - October 20th 2020, Astor Bizard - January 13th 2023_

_Centre des Nouvelles Pédagogies (CNP*), Univ. Grenoble Alpes - University of innovation_

The plugin **Point of view** offers the possibility to react and give difficulty levels to activities within a Moodle course. Students know the difficulty of an activity (estimated by the teacher) thanks to color tracks. They also have the possibility to react via emojis, each representing an emotion, a feeling. It is fully customizable.

This plugin is developed by Quentin Fombaron and Astor Bizard. It is initially developped for [caseine.org](http://www.moodle.caseine.org). Do not hesitate to send your thinking and bug reports to the contact addresses below.

Contacts:

- [Quentin Fombaron](mailto:q.fombaron@outlook.fr)

- [Astor Bizard](mailto:astor.bizard@univ-grenoble-alpes.fr)

- [Caseine](mailto:contact.caseine@grenoble-inp.fr)

\* *The CNP, set up as part of the IDEX Training component, brings together the DAPI, PerForm and IDEX support teams.*

## Table of Contents

* [Point of View as a block](#point-of-view-as-a-block)

* [Usage](#usage)

    * [Difficulty tracks](#difficulty-tracks)

    * [Reactions](#reactions)

        * [Accessing reactions details](#accessing-reactions-details)

* [Configuration](#configuration)

    * [Enabling reactions](#enabling-reactions)

    * [Enabling difficulty tracks](#enabling-difficulty-tracks)

* [Customization](#customization)

    * [Reactions emoji](#reactions-emoji)

    * [Difficulty tracks colors](#difficulty-tracks-colors)

## Point of View as a block

The Point of View plugin is a block. For general information about how blocks work, see [Moodle documentation on blocks](https://docs.moodle.org/en/Block_settings).

## Usage

Once configured (see [Configuration](#configuration) below), the block enriches the display of course modules with difficulty tracks and reactions.

![Example of difficulty tracks and reaction on three modules.](metadata/screenshots/coursemodules_display.png)

### Difficulty tracks

The difficulty track is set by the teacher for each module. It appears on the left of the module name.

By default, Green track, Blue track, Red track and Black track are available. These colors are [customizable](#difficulty-tracks-colors).

### Reactions

Reactions are a way for students to express their point of view on a module. The reaction interface is displayed on the right of the module line.

The total number of votes for the module is displayed, as well as a preview of reactions that have been voted for. A green dot indicates that the user has voted.

Hovering the reactions or clicking on them reveals the different reactions, allowing the user to vote for a reaction by clicking on the associated emoji.

![Reactions interface.](metadata/screenshots/reactions_interface.png)

By default, the available reactions are "Easy!", "I'm getting better!" and "So hard...". These texts and their associated emoji are [customizable](#reactions-emoji).

Only one vote per module is allowed for each user. Users can freely change their vote, or remove it (by clicking again the previously selected reaction).

#### Accessing reactions details

Teachers can access detailed information about reactions by clicking the link in the block content:

![Block content with link to overview](metadata/screenshots/link_to_overview.png)

This leads to a table with information about votes for each user and each course module:

![Overview table with percentages](metadata/screenshots/overview_table_percentages.png)

Information about reactions votes is displayed as percentages by default. This can be toggled to number of votes by clicking on the reactions:

![Overview table with number of votes](metadata/screenshots/overview_table_numbers.png)

Clicking the arrow on the right of a row allows access to detailed information about each user's vote on the module:

![Overview table with users information](metadata/screenshots/overview_table_users.png)

## Configuration

Once added to a course, the Point of View block needs to be configured.

### Enabling reactions

To enable reactions in the course, the following option needs to be set to Yes:

![Global reactions activation](metadata/screenshots/block_reactions_activation.png)

Once enabled on block level, reactions can be enabled or disabled for each course module by checking the "Reactions" checkbox:

![Course module reactions activation](metadata/screenshots/module_reactions_activation.png)

Reactions can also be enabled or disabled for all course modules of one type:

![Reactions activation for a course module type](metadata/screenshots/enabledisable_reactions_by_module_type.png)

...or for all course modules in a section:

![Reactions activation for a course section](metadata/screenshots/enabledisable_reactions_by_section.png)

### Enabling difficulty tracks

To enable difficulty tracks in the course, the following option needs to be set to Yes:

![Global difficulty tracks activation](metadata/screenshots/block_difficultytracks_activation.png)

Once enabled on block level, difficulty tracks can be set for each course module with a dropdown menu:

![Course module difficulty track setting](metadata/screenshots/module_difficultytrack_setting.png)

## Customization

### Reactions emoji

Custom emoji can be defined to be used as reactions pictures. This can be done either at the site level (in plugin administration settings), or at the block level (on the block configuration page).

**Note:** Only **3** different reactions ("Easy", "I'm getting better" and "So hard" by default) are available.

Site administrators can define custom emoji to be used as reactions pictures site-wide:

![Custom reactions emoji at the site level](metadata/screenshots/custom_reaction_emoji_site_level.png)

11 files are needed: 3 emoji, 7 emoji groups (all possible groups from 1 to 3 emoji) and 1 neutral emoji meaning no vote on the activity. Please stick to the specified names.

|                      | Emoji                                | Emoji group                               | No vote emoji group  |

| -------------------- |:------------------------------------:|:-----------------------------------------:|:--------------------:|

| **File names**       | easy.png<br/>better.png<br/>hard.png | group\_E.png<br/>group\_B.png<br/>group\_H.png<br/>group\_EB.png<br/>group\_EH.png<br/>group\_BH.png<br/>group\_EBH.png | group\_.png           |

| **Preferred size**                | 200x200                              | 400x200                                                                                                          | 400x200              |

| **Extension**        | PNG                                  | PNG                                       | PNG                  |

At the block level, teachers can choose which emoji to use, as well as using their own custom emoji. The requirements are the same as above.

![Reactions emoji selection at the block level](metadata/screenshots/reactions_emoji_selection_block_level.png)

At the block level, custom text to be used for reactions can also be defined.

![Example of custom reactions texts](metadata/screenshots/custom_emoji_text.png)

### Difficulty tracks colors

Site administrators can define custom difficulty tracks colors. This is useful if your site uses a theme where one of the default colors renders badly.

**Note:** Only **4** difficulty tracks (Green, Blue, Red and Black by default) are available.

![Custom color setting for green difficulty track](metadata/screenshots/green_difficultytrack_color_setting.png)