10.8. Extensions

Administration → Extensions

Note

Extensions est une rubrique accessible seulement par les administrateurs du site.

Les extensions ou plug-ins permettent d’ajouter des fonctionnalités à Mahara. Les extensions peuvent être ajoutées ou cachées en tout temps par un administrateur du site.

10.8.1. Administrer les extensions

Administration → Extensions → Administrer les extensions

La page Administrer les extensions liste toutes les extensions actuellement installées dans Mahara. Lorsqu’il est possible de paramétrer une extension, un lien est fourni à cet effet.

Les plug-ins dans Mahara restent toujours installés et les utilisateurs peuvent toujours y accéder s’ils connaissent l’URL et sont autorisés à y accéder. Les fonctionnalités des plug-ins sont donc toujours accessibles mais on peut soit les cacher ou les rendre visible à l’aides des boutons Cacher, Montrer qui se trouvent en face de chaque plug-in. Lorsqu’un plug-in de type production est caché, Mahara arrête d’afficher les blocs correspondant sur les pages qui les utilisent.

Warning when a plugin is not yet installed

Alerte lorsqu’un plug-in n’est pas installé

Si vous avez ajouté un nouveau plug-in à votre installation Mahara ou si un nouveau plug-in a été ajouté à la nouvelle distribution de Mahara vers laquelle vous mettez à jour la vôtre, vous devez installer ce plug-in. Un plug-in qui n’a pas été entièrement installé est affiché avec une alerte et listé en premier dans sa section. Cliquez sur le lien Installer pour procéder à l’installation.

Pour supprimer un plug-in installé, vous devez supprimer les fichiers et les dossiers contenant le code du plug-in et supprimer toute trace dans la base de données. De plus, vous devez supprimer sa présence dans un certain nombre de tables du système, comme « artefact », « artefact_config », « artefact_cron », etc. Référez-vous à l’exemple donné dans Information pour supprimer le plug-in My Learning.

Note

Les fonctions de bases de Mahara peuvent être cachées aux utilisateurs. Ceci peut être notamment intéressant si vous utilisez aussi un autre système qui propose ces fonctionnalités (par exemple cacher les forums de Mahara si vous utilisez les forums de Moodle). Toutefois, la décision de cacher des outils de Mahara aux utilisateurs doit être mûrement réfléchie, car vous les privez ainsi d’autant de ressources à placer sur leurs pages de portfolio.

Dans ce qui suit, seuls les plug-ins proposant un paramétrage particulier seront décrits.

10.8.1.1. Type de bloc : Fichier / Dossier

Vous pouvez choisir l’ordre d’affichage des fichiers contenus dans un bloc de type Dossier et aussi décider si les visiteurs des pages qui contiennent un bloc Dossier sont autorisés à télécharger le contenu d’un coup, sous la forme d’un fichier zip.

Configure the Folder block

Configurer le bloc Dossiers

  1. Ordre de tri par défaut des fichiers : Choisissez l’ordre de tri pour afficher le contenu d’un bloc Dossier. Le tri peut être fait de manière ascendante ou descendante.

    Note

    Quand un utilisateur place un bloc Dossier sur sa page, il peut modifier l’ordre de tri défini par défaut.

  2. Autoriser le téléchargement du contenu d’un dossier dans un fichier zip : En plaçant le sélecteur sur « Oui » vous permettez à ce que le contenu d’un dossier puisse être affiché sous la forme d’une archive zip dans un bloc de type Dossier. Cela permet alors aux utilisateurs accédant votre page de facilement télécharger sur son ordinateur tous les fichiers que le bloc contient.

    Voir aussi

    Les administrateurs du site peuvent décider, dans les préférence du type de production : Fichiers la durée de conservation du fichier zip créé sur le serveur.

10.8.1.3. Type de plug-in : File / internalmedia

Configurer ici les types de fichiers que vos utilisateurs auront le droit d’utiliser et inclure sur leurs pages avec le bloc Média externes. Si vous désactivez un type de fichier qui est déjà utilisé dans un bloc sur une page, le contenu se sera plus affiché.

Mahara comes with Video.js, a media player that can play a number of media files and does not require Flash (though it does have a Flash fallback option). Other video file types can be enabled, but users must have the appropriate software installed on their computers and the respective plugins enabled in their browsers to play them.

Configure the Embedded media block

Configurer le bloc Média interne

  1. Activez les différents formats de fichiers que vous permettez aux utilisateurs d’utiliser dans leur portfolios.
  2. Cliquez sur le bouton Enregistrer pour sauver vos modifications.

Note

Si vous autorisez l’inclusion de fichiers dont le type n’est pas reconnu par Video.js, certains utilisateurs risquent de ne pas avoir les programmes nécessaires pour les ouvrir.

Vous trouverez ici une comparaison des navigateurs web et des différents formats multimédias, sons et vidéos, qu’ils peuvent jouer à l’aide de la librairie Video.js. Ce n’est pas parce que Video.js supporte un format que votre navigateur va forcément pouvoir le jouer; il faut aussi que le navigateur supporte ce format. Dans le tableau, ne sont mentionnés que les navigateurs web supportés par Mahara.

Les appareils sous iOS peut ne pas toujours afficher correctement les fichier MP4 car il ne reconnaît que le profil MP4 « Baseline » et non le profil « High ». Vous pouvez consulter les spécifications d’Apple et convertir les vidéos en utilisant par exemple Handbrake. Les nouveaux appareils (depuis l’iPhone 5S et suivants) devraient reconnaître les profils « High » pour les vidéos.

Format de fichier Chrome Chrome pour Android Firefox Internet Explorer / Edge Opéra Safari (incl. iOS)
Fichier multimédia 3GPP            
Vidéos FLV Flash (nécessite Flash)      
Audio MP3
Vidéos MP4 (H.264)
Fichier vidéo MPEG            
Audio OGA    
Fichier audio OGG Vorbis    
Vidéos OGV      
Fichier vidéo WEBM    

Note

Alors que vous pouvez téléverser n’importe quel type de fichier depuis un ordinateur sous Android, vous ne pouvez pas téléverser des fichiers audio depuis un appareil sous iOS. Vous pouvez seulement téléverser des fichiers au format .mov. Ces derniers nécessitent qu’un plug-in soit installé sur le navigateur web pour être joués et ne sont pas reconnus par Video.js.

Les fichiers AVI et WMV ne peuvent être affichés que les ordinateurs sous Windows, à moins que vous n’ayez installé un plug-in Windows Media Player sur un autre système d’exploitation.

10.8.1.4. Type de bloc: Texte

Vous pouvez convertir le type de bloc Notes en Annotations sur tout le site.

Configure text settings

Configurer les paramètres du texte

  1. Mahara calcule le nombre de notes qu’il y a à convertir. Les annotations avec les caractéristiques suivantes sont incluses dans le processus de conversion :
    • ne sont pas réutilisées dans d’autres bloc;
    • n’ont pas de licence jointe;
    • n’ont pas de mots-clés;
    • n’ont pas de pièce jointe
    • n’a pas reçu de commentaires.
  2. Activez l’option Convertir les blocs de type « Note » pour convertir toutes les notes.
  3. Cliquez sur le bouton Enregistrer pour commencer le proccessus de conversion. La durée de ce travail dépend du nombre de notes à convertir.

Voir aussi

Si vous avez un gros site, la conversion des notes en texte peut prendre un certain temps. C’est pourquoi l’utilisation de la ligne de commande pour lancer le script devrait être préférée dans ce cas.

10.8.1.5. Type de bloc : Mur

Vous pouvez limiter le nombre de caractères de chacun des messages qui seront écrits sur le Mur. Les messages déjà placés ne seront pas modifiés.

Configure wall settings

Configurer les pramètres du mur

  1. Fixez le nombre maximum de caractères que vous autorisez pour les messages à placer sur votre mur.
  2. Cliquez sur le bouton Enregistrer pour sauver vos modifications.

10.8.1.6. Type de production : Comment

Activer l’évaluation par note dans la section des commentaires des productions et des pages. Vous pouvez modifier la présentation des évaluations par note ainsi que l’échelle de celles-ci.

Note

La note ne peut pas être appliquée seule. Il faut aussi ajouter un commentaire ou joindre un fichier.

Enable comment ratings

Activer l’évaluation par note

  1. Activer l’évaluation par note : Placez le sélecteur sur « Oui » si vous désirez activer l’évaluation par note.

  2. Icône à utiliser pour afficher l’évaluation par note : Utilisez le menu contextuel pour sélectionner l’icône à utiliser pour l’évaluation par note. Vous pouvez choisir une des icônes suivantes :

    • Étoile
    • Cœur
    • Pouce levé
    • Vu
  3. Maximum de l’échelle d’évaluation : Choisissez l’échelle à utiliser pour évaluer quantitativement les commentaires.

    Note

    Si vous changer d’échelle, les évaluations déjà effectuées ne seront pas recalculées pour entrer dans les nouvelles limites que vous aurez fixées.

  4. Colour: Use the colour picker to select the colour for your icon or enter the hexadecimal color code.

  5. Générer un exemple : Affiche un aperçu votre système d’évaluation des commentaires.

  6. Cliquez sur le bouton Enregistrer pour sauver vos modifications.

10.8.1.7. Type de productions : File

Vous pouvez paramétrer un grand nombre d’options pour les téléversements de fichiers :

  • Quota par défaut pour un utilisateur
  • Quota du groupe par défaut
  • Accord avant de téléverser
  • Retailler l’image lors du téléversement
  • Taille de l’image du profil
  • Commentaires
  • Téléchargement du dossier

10.8.1.7.1. Quota par défaut pour un utilisateur

Configure the default user quota

Configurer le quota par défaut des utilisateurs

  1. Quota par défaut : Vous fixez ici le quota d’espace disque par défaut qui sera appliqué à tous les nouveaux utilisateurs. Le quota des utilisateurs déjà existants ne sera pas modifié.
  2. Mettre à jour les quotas des utilisateurs : Placez le sélecteur sur « Oui » si vous désirez mettre à jour le quota d’espace disque pour les utilisateurs existants avec la valeur définie dans la rubrique Quota par défaut. C’est seulement à ce moment que les quotas seront adaptés.
  3. Forcer un quota maximum sur tout le site : Placez le sélecteur sur « Oui » si vous ne désirez pas qu’un administrateur d’une institution puisse modifier ultérieurement le quota pour les utilisateurs de son institution.
  4. Quota maximum : Vous fixez ici la valeur maximale du quota d’espace disque qu’un administrateur a le droit de fixer pour un utilisateur dans l’institution qu’il administre. Les quotas déjà attribués aux utilisateurs existants ne seront pas revus à la baisse.
  5. Limite avant la notification de dépassement de quota * : Vous pouvez fixer un pourcentage qui une fois atteint envoie un message à l’utilisateur pour lui signifier qu’il atteindra bientôt la limite de son espace disque alloué. Il pourra alors décider de supprimer des documents pour faire de la place ou de contacter un administrateur pour demander plus de place.
  6. Notification à l’administrateur du site : Placez le sélecteur sur « Oui » si vous désirez qu’un message d’alerte soit envoyé aux administrateurs du site lorsqu’un utilisateur s’approche de la limite de son quota d’espace disque. Ceci permet d’anticiper les problèmes de prendre les actions qui s’imposent.
  7. Le quota de l’institution remplace celui des utilisateurs : Placez le sélecteur sur « Oui » si vous désirez que les administrateurs de des institutions puissent puissent fixer et gérer eux-mêmes le quota d’espace disque pour leurs utilisateurs au sein de leur institution.
  8. Cliquez sur le bouton Enregistrer en bas de la page lorsque vous avez terminé d’effectuer vos réglages, ou continuez à la section suivante de la page.

10.8.1.7.2. Quota du groupe par défaut

Configure the default group quota

Configurer le quota d’espace disque pour le groupe

  1. Quota du groupe par défaut : Vous pouvez fixer ici le quota d’espace disque que vous souhaitez fixer par défaut pour chaque groupe. Les groupes déjà existants ne sont pas concernés par les modifications que vous faites après leur création.
  2. Mettre à jour les quotas des groupes : Placez le sélecteur sur « Oui » si vous désirez mettre à jour le quota d’espace disque pour chaque groupe existant avec la valeur définie sous Quota par défaut. À ce moment seulement les groupes seront mis à jour.
  3. Cliquez sur le bouton Enregistrer en bas de la page lorsque vous avez terminé d’effectuer vos réglages, ou continuez à la section suivante de la page.

10.8.1.7.3. Accord avant de téléverser

Configure the upload agreement

Configurer les options d’accord avant téléversement

  1. Demander l’accord : Placez le sélecteur sur « Oui » si vous désirez obliger les utilisateurs à accepter un certain nombre de conditions légales ou de bonne conduite avant de téléverser un document sur votre site. Ils devront alors accepter les conditions proposées avant de pouvoir sélectionner un document depuis leur ordinateur et le téléverser dans Mahara.
  2. Accord par défaut : Un texte défini par défaut sera affiché à chaque fois qu’un utilisateur voudra déposer un fichier sur la plateforme et que l’option Demander l’accord est activée.
  3. Utiliser l’accord personnalisé : Si vous désirez créer votre propre texte pour l’accord à accepter avant qu’un utilisateur puisse téléverser un document, placez le sélecteur sur « Oui », en plus de l’option Demander l’accord.
  4. Accord personnalisé : Vous indiquez ici l’accord personnalisé qui viendra remplacer le texte de l’accord par défaut. Vous pouvez mettre ici la copie de votre charte d’utilisation des documents au sein de votre institution qui règle le droit d’auteur, le droit de citation, de diffusion, etc. Vous pouvez aussi, par exemple, indiquer les règles légales en vigueur dans votre pays. Il est aussi possible, afin de minimiser la taille du texte, de proposez un lien ou une liste de liens vers des documents placés sur votre serveur web ou ailleurs sur Internet.
  5. Cliquez sur le bouton Enregistrer en bas de la page lorsque vous avez terminé d’effectuer vos réglages, ou continuez à la section suivante de la page.

10.8.1.7.4. Retailler l’image lors du téléversement

Configure the image resizing options

Configurer les options de retaillage des images

  1. Réduire automatiquement la taille des grandes images : Placez le sélecteur sur « Oui » si vous désirez que les images de grande taille qui sont téléversées soient automatiquement réduites à la largeur et hauteur maximale donnée en paramètre, si elles dépassent ces valeurs.
  2. Options utilisateurs : Placez le sélecteur sur « Oui » si vous désirez afficher aux utilisateurs une option de retailler automatiquement les images téléversées dans leur panneau de préférences.
  3. Largeur maximale : Indiquez la valeur en pixels de la largeur maximale à laquelle les images doivent être enregistrées sur la plateforme au moment du téléversement.
  4. Hauteur maximale : Indiquez la valeur en pixels de la hauteur maximale à laquelle les images doivent être enregistrées sur la plateforme au moment du téléversement.
  5. Cliquez sur le bouton Enregistrer en bas de la page lorsque vous avez terminé d’effectuer vos réglages, ou continuez à la section suivante de la page.

10.8.1.7.5. Taille de l’image du profil

Configure the size of the profile pictures

Configurer la taille des images pour les profils

  1. Largueur : Indiquez la valeur en pixels de la largeur maximale des images affichées dans le profil des utilisateurs.
  2. Hauteur : Indiquez la valeur en pixels de la hauteur maximale des images affichées dans le profil des utilisateurs.
  3. Cliquez sur le bouton Enregistrer en bas de la page lorsque vous avez terminé d’effectuer vos réglages, ou continuez à la section suivante de la page.

Note

Chaque image téléversée comme image pour le profil d’un utilisateur sera retaillée à ces dimensions si l’image originale est plus grande.

10.8.1.7.6. Commentaires

Configure the default comment settings for different file types

Configurer les valeurs par défaut pour autoriser les commentaires sur les différents types de fichiers

  1. Cliquez sur le bouton Tout sélectionner pour sélectionner tout type de fichier.
  2. Cliquez sur le bouton Tout désélectionner pour supprimer toute sélection précédemment effectuée.
  3. Activation des commentaires par défaut : Sélectionnez les productions pour lesquelles la possibilité de faire des commentaires sera activée par défaut. Les utilisateurs pourront ensuite modifier cette propriété, pour chaque production, en allant dans leur zone de gestion de fichiers. Vous pouvez activer les commentaires pour les :
    • archives, soit les fichiers compressés
    • fichiers audio
    • fichiers
    • dossiers
    • Images
    • images du profil
    • fichiers vidéo
  4. Cliquez sur le bouton Enregistrer en bas de la page lorsque vous avez terminé d’effectuer vos réglages, ou continuez à la section suivante de la page.

10.8.1.7.7. Téléchargement du dossier

Configure the folder download settings

Configurer les paramètres de téléchargement du dossier

  1. Durée de conservation du fichier zip : Fixez la durée maximale pendant laquelle le fichier zip créé sur le serveur restera à disposition pour être téléchargé. La durée par défaut est de 3’600 secondes (1 heure).
  2. Cliquez sur le bouton Enregistrer lorsque vous avez terminé de faire vos modifications.

10.8.1.8. Type de production : Profile

Dans le profil de l’utilisateur, vous pouvez décider quelles informations doivent être obligatoirement renseignées par l’utilisateur ou présentent dans le fichier d’importation des utilisateurs par CSV. Les rubriques seront alors clairement marquées comme rubriques obligatoires dans l’interface de l’utilisateur.

Les rubriques du profil marquées comme rubriques cherchables, permettent aux utilisateurs de rechercher d’autres utilisateurs au moyen du contenu de ces rubriques.

Sélectionnez les rubriques du profil que vous désirez afficher dans Administration → Utilisateurs → Recherche des utilisateurs.

Voir aussi

Vous pouvez facilement ajouter des rubriques personnalisées par une modification d’un fichier local dans le code de base de Mahara.

Choose mandatory and searchable profile fields

Sélectionnez les rubriques du profil qui seront obligatoires et cherchables

  1. Rubriques obligatoires : Sélectionnez ici les rubriques que vous désirez rendre obligatoire à la saisie par les utilisateurs. Certaines rubriques ne peuvent pas être désélectionnées, car elles doivent rester obligatoires pour le bon fonctionnement de Mahara.

  2. Rubriques cherchables : Sélectionnez les rubriques que vous désirez faire entrer dans les critères de recherche possibles pour trouver des utilisateurs par d’autre utilisateurs. Certaines rubriques ne peuvent pas être désélectionnées pour le bon fonctionnement de Mahara

  3. Administration user search: Select the fields that you want to display in the User search table. The fields you select here are not exported to the CSV file though.

    Note

    Utilisez les boutons Tout sélectionner et Tout désélectionner pour sélectionner toutes les rubriques du profil en une seule fois ou pour effacer toute sélection précédemment effectuée.

  4. Cliquez sur le bouton Enregister pour sauvegarder vos modifications.

10.8.1.9. Authentification : SAML

Si vous désirez utiliser le système d’authentification SAML sur votre site, vous trouverez ici toute l’information nécessaire concernant les certificats et les métadonnées pour votre site.

Note

SimpleSAMLphp est une dépendance fonctionnelle qui est inclue dans Mahara, ce qui rend l’installation d’un système d’authentification basé sur SAML beaucoup plus facile.

Il est possible que vous deviez installer manuellement d’autres services dépendants sur votre serveur. Veuillez vous conformer aux instructions à l’écran si cela devait être le cas.

Prepare your site for SAML authentication

Préparer votre site pour l’authentification par SAML

  1. Prestataire de service EntityId : Il s’agit du numéro d’identification (ID) unique qui identifie votre instance Mahara en tant que prestataire de service d’authentification; par ex. exemple.ch/mahara. Cette rubrique est remplie automatiquement avec le wwwroot de votre instance de Mahara. Si l’information vous semble erronée, vous pouvez la modifier ici.

  2. Signature algorithm: This is the algorithm that will be used to sign SAML requests. This makes it possible to use the SAML authentication with ADFS (Active Directory Federation Services). The following options are available:

    • SHA256 (défaut)
    • SHA384
    • SHA512
    • SHA1 ancien (dangereux)

    Avertissement

    L’algorithme SHA1 n’est supporter que pour assurer une comptabilité descendante. A moins que vous ne deviez absolument utiliser cet algorithme, il est recommandé d’utiliser SHA256 à la place.

  3. Métadonnées : Le lien des métadonnées vous renvoie sur la page des métadonnées de votre SAML que vous devez donner à votre prestataire de serveur d’identité.

  4. Public key: The public key is generated and rotated automatically. Typically, you would not need to copy it from here since you copy the entire metadata. It is displayed for verification purposes.

  5. Cliquez sur le bouton Enregistrer pour valider vos modifications ou pour mettre à jour manuellement la clé.

Note

Cliquez sur le bouton Enregistrer pour mettre à jour la clé publique, contrôlez bien que celle-ci a été modifiée en regardant la date d’expiration ainsi que les derniers caractères de la clé publique.

10.8.1.10. Recherche : Elasticsearch

The regular Mahara search is limited to finding users and in certain places titles, descriptions and tags of pages or collections. However, Mahara can be extended to use allow for fulltext search capabilities. The Mahara core project team chose to use Elasticsearch. This is a powerful and extensible fulltext search engine. It does require a Java server, e.g. Tomcat, to run and thus may not be available for small instances of Mahara.

Note

If you are upgrading from a version of Mahara prior to Mahara 17.10 and you already had Elasticsearch in use, please take a look at the upgrade instructions.

Configure the Elasticsearch plugin

Configurer le plug-in de recheche Elasticsearch

  1. La plupart des options de configuration pour Elasticsearch doivent être paramétrées au niveau du serveur. Ici sont affichées les options actuelles sans que vous ne puissiez les modifier directement.
  2. Nb. max. d’enregistrements à chaque cron : La valeur indiquée ici correspond aux nombre maximal d’enregistrements qui sont passés à la file d’attente du traitement par Elasticsearch à chaque lancement du script cron. Une rubrique vide ou une valeur de 0 signifie qu’il n’y a pas de limite.
  3. Types de productions : Sélectionnez les différents types de productions que vous désirez inclure dans la recherche avec Elasticsearch. Seules les productions qui possèdent une hiérarchie définie ci-dessous sont disponibles pour la recherche. Après avoir effectué des modifications sur cette page, vous devez lancer une reconstruction de l’index pour qu’Elesticsearch puisse les prendre en compte.
  4. Hiérarchie des types de productions : Entrez la hiérarchie pour chaque type de production, en séparant chaque élément par un | (trait vertical). Placez chaque type de productions sur une nouvelle ligne.
  5. Restaurer l’index : Affiche le nombre d’enregistrements de chaque type actuellement dans la file d’attente d’envoi au serveur Elasticsearch. Les enregistrements sont envoyés à Elasticsearch à chaque fois que le script cron est invoqué (par défaut toutes les 5 minutes).
  6. Cliquez sur le bouton Restaurer pour supprimer tous les index de recherche ainsi que tous les enregistrements de la file d’attente d’envoi au serveur Elasticsearch.
  7. Cliquez sur le bouton Enregister pour sauvegarder vos modifications.

Voir aussi

Vous trouverez d’autres informations sur Elasticsearch dans Mahara sur le wiki. Commencez avec la lecture des informations pour les développeurs

10.8.1.12. Interaction : Forum

Le délai avant envoi détermine le temps (en minutes) que Mahara va attendre avant d’envoyer effectivement le message qui est placé dans un forum. Pendant ce temps, l’auteur du message peut le modifier ou le supprimer. Une fois que le message a été envoyé, si des modifications interviennet sur ce message, la date et le nom de celui qui l’aura modifié seront mentionnés dans le message du forum.

Set the edit time before the forum post is finalised

Fixer la durée d’attente avant qu’un message de forum soit considéré comme finalisé

  1. Délai avant envoi : Fixé le délai que Mahara doit attendre avant d’envoyer les messages placés dans les forums.
  2. Cliquez sur le bouton Enregistrer pour sauver vos modifications.

10.8.1.13. Module: LTI

Vous pouvez activer l’API LTI pour utiliser l”intégration LTI dans Mahara.

Configure the LTI plugin

Configurer le plug-in LTI

  1. Ce message vous permet de savoir si les fonctionnalités LTI sont activées ou non.

  2. Configurer l’élément : Liste des éléments configurables pour LTI.

  3. Statut : Affiche les éléments de configuration qui sont déjà utilisés et ceux qui ne le sont pas.

  4. Auto-configurer LTI : Placez le sélecteur sur « Oui » si vous désirez que LTI soit automatiquement configuré pour vous.

    Note

    Une fois l’auto-configuration effectuée, vous ne voyez plus cette option. Vous pouvez l’afficher à nouveau en modifiant manuellement des paramètres dans la section Services Web.

  5. Cliquez sur le bouton Enregistrer pour valider vos modifications.

10.8.1.14. Module : API Mobile

Vous devez activer l’API Mobile pour utiliser « Mahara Mobile », la nouvelle app Mahara.

Configure the mobile API

Configurer l’API mobile

  1. Le message vous indique si l’API mobile est activée ou non.

  2. Élément de configuration : Liste des éléments de configuration pour les applications mobiles utilisant l’API mobile.

  3. Statut : Affiche les éléments de configuration qui sont déjà utilisés et ceux qui ne le sont pas.

  4. Auto-configurer l’API des applications mobiles ? : Placez le sélecteur sur « Oui » si vous désirez que tous les paramètres soient configurés de manière automatique.

    Note

    Une fois l’auto-configuration effectuée, vous ne voyez plus cette option. Vous pouvez l’afficher à nouveau en modifiant manuellement des paramètres dans la section Services Web.

  5. Génération manuelle des jetons : Placez le sélecteur sur « Oui » si vous désirez permettre à vos utilisateurs de générer manuellement les jetons d’accès initiaux pour les applications mobiles. Ceci n’est nécessaire que si la méthode d’authentification utilisée ne supporte pas la génération automatique des jetons. Ceci est actuellement le cas avec MNet, par exemple.

  6. Cliquez sur le bouton Enregistrer pour valider vos modifications.

10.8.2. Filtres HTML

Administration → Extensions → Filtres HTML

Mahara utilise HTML Purifier pour filtrer les lignes de code qui pourraient nuire à la sécurité de votre système. Si vous désirez placer du code dans les pages de Mahara, par exemple avec un iframe ou du JavaScript vous devez écrire un filtre en php pour éviter que votre code soit filtré et retiré par HTML Purifier. Les filtres doivent toujours être spécifiques à un service particulier et ne pas donner carte blanche, afin de ne pas créer des trous dans la sécurité de votre site.

Mahara est installé avec un certain nombre de filtres. D’autres peuvent être téléversés et installés. Si vous avez créé un filtre HTML, vous pouvez l’installer en décompressant le fichier zip dans le dossier /htdocs/lib/htmlpurifiercustom puis ensuite en cliquant sur le bouton Installer.

Les filtres personnalisés pour les iframes permettent d’inclure des médias depuis YouTube et WikiEducator par exemple. Ils facilitent la tâche des utilisateurs, en leur permettent de placer simplement l’URL du média qu’ils désirent inclure, sans devoir chercher le code d’inclusion nécessaire (<embed> ou <iframe>) sur le site où le média est présent.

Note

Vous n’êtes pas forcé de créer des filtres sur mesure pour intégrer des médias dans les pages du portfolio, si vous êtes satisfait avec la gestion des codes <iframe> pour les encapsuler. Vous pouvez éditer la listes des sites encapsulables dans autoriser des sources pour les iframes.

Si toutefois vous voulez coller directement l’adresse d’une ressources (par ex. : un film sur YouTube), dans ce cas vous devez écrire une filtre sur mesure en php.

10.8.3. Sources « iframe » autorisées

Administration → Extensions → Sources « iframe » autorisées

Cette fonction vous permet, en tant qu’administrateur du site, de spécifier une base d’URL pour les médias que vous autorisez à vos utilisateurs à inclure sur leurs pages. Ces iframes sont considérées comme sûres et ne seront pas supprimées après l’édition du contenu d’un bloc de type Texte, Annotation, Media externe, ou dans un article du journal. Vous n’avez pas à écrire des filtres personnalisés pour ces sources d’iframes.

L’interface d’administration vous permet d’ajouter et de modifier les sources de manière facilitée. Mahara est installé avec un grand nombre de sources iframe autorisées que vous pouvez prendre pour exemple lors de la création d’une nouvelle source.

Add and edit allowed iframe sources

Ajouter et modifier les sources d’iframes autorisées

  1. Nom d’affichage : Ce que l’utilisateur voir dans le bloc de médias externes.
  2. Site : La base de l’URL du code iframe.
  3. Cliquez sur le bouton Modifier
    pour mettre à jour le nom d’affichage ou la favicon des iframe existants
  4. Cliquez sur le bouton Supprimer pour supprimer une source iframe autorisée.
  5. Nom d’affichage : Modifiez le nom d’affichage d’une source iframe existante ici, après avoir cliqué sur le bouton Modifier
    .
  6. Icône du serveur : Sélectionnez la base de l’URL où le favicon se trouve pour ce site, si celui n’est pas trouvé automatiquement par Mahara.
  7. Cliquez sur le bouton Enregistrer pour conserver vos modifications.
  8. Site: Add a new iframe source by entering its base URL here. Please make sure to leave out the https://. Only letters, digits and . / - _ are allowed.
  9. Nom d’affichage : Choisissez le nom qui est attribué à la source d’un iframe. Par convention, on utilise normalement le nom du site qui héberge le contenu externe.
  10. Cliquez sur le bouton Ajouter pour entrer votre site dans la liste des sources iframe autorisées. Si le favicon ne s’affiche pas, modifiez votre enregistrement en spécifiant l’adresse pour accéder à l’icône, comme indiqué à l’étape 6 plus haut.

Note

Certains sites peuvent être accédés par une famille d’URL différentes, comme GoogleApps, Glogster, etc. Vous devez alors indiquez toutes les bases d’URL possibles, afin de vous assurer que les iframes venant de ces sites puissent être affiché dans Mahara. Si vous donnez à plusieurs sites le même nom, il n’apparaîtra qu’une seule fois dans la liste pour ne pas prendre inutilement de la place.

Voir aussi

Des membres de la communauté Mahara ont commencé à partager les sources iframe qu’ils utilisent sur leur propres sites ainsi que les URL à utiliser pour que cela fonctionne dans Mahara. Vous pouvez accéder à cette liste sur le wiki et aussi y ajouter vos propres sources iframe.

10.8.4. URL simplifiées

Administration → Extensions → URL simplifiées

Vous pouvez configurer votre site pour utiliser des URL plus accessibles à des êtres humains pour les profils des utilisateurs et les groupes, et les pages (de groupes) des portfolios. Par exemple :

Cette option vous permet de créer des URL plus faciles à mémoriser.

Voir aussi

Veuillez suivre les instructions de configuration qui figurent sur le wiki pour activer cette fonction sur votre site. Pour réaliser cette tâche, vous devez pouvoir accéder aux fichiers du serveur.

Dans la zone d’administration, vous pouvez générer de nouvelles URL simplifiées pour les utilisateurs existants, les groupes et les pages. Ceci est particulièrement important lorsque vous mettez à jour une ancienne version de Mahara et que vous voulez réinitialiser toutes les URLs simplifiées.

Regenerate clean URLs for existing users in bulk

Générer à nouveau en lot les URL simplifiées pour les utilisateurs existants

  1. Cliquez sur le bouton Envoyer pour générer de nouvelles URL simplifiées. En faisant cela, vous détruisez toutes les anciennes URL simplifiées.
  2. Le résultat de cette action est affiché en haut de l’écran.

Avertissement

Si vous générez des URL simplifiées pour tous vos utilisateurs, ceux qui auraient déjà modifié celle-ci perdront ces modifications et les liens sur ces URL risquent d’être rompus. Nous vous recommandons de n’utiliser cette fonction que lorsque vous mettez à jour votre Mahara ou lorsque quelque chose s’est mal passé avec la gestion des URL simplifiées.

10.8.5. Module Compétences

Pour plus d’informations sur le module Compétences, veuillez vous référer à la section qui lui est dédiée.

10.8.6. Services web

Pour des informations sur les services web, veuillez vous rendre à la section prévue à cet effet.