8.6. 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.

8.6.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.

Il n’y a pas de fonction de désinstallation des extension dans Mahara. Une extension peut être toujours accédée par tout utilisateur qui en connaît l’URL ou en a l’accès. Au lieu d’activer ou de désactiver une extension dans les préférences des utilisateurs, il suffit d’utiliser les liens Cacher et Montrer. Quand une extension de production (artefact) a été cachée, Mahara arrête d’afficher le bloc (blocktype) correspondant dans les pages des portfolios.

Si vous voulez supprimer définitivement une extension de Mahara, vous devez supprimer son code et toutes les informations contenues dans la base de données qui concerne cette extension. Attention à ce que vous faites. En effaçant des informations importante à Mahara vous prenez le risque à rendre votre plateforme inaccessible ou non opérationnelle.

Note

Les fonctionnalités de base de Mahara peuvent être rendues inaccessibles aux utilisateurs en les cachant. Ceci permet par exemple de désactiver des fonctions que vos utilisateurs accèdent déjà à l’aide d’autres logiciels que vous utilisez, ou simplement d’empêcher les utilisateurs de faire certaines choses avec la plateforme. Toutefois, la décision de masquer des fonctionnalités de Mahara doit être mûrement réfléchie, car en procédant de la sorte les utilisateurs auront moins d’outils pour créer leurs productions dans leur portfolio.

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

8.6.1.1. Type de bloc : Fichier / Galerie

Vous aussi paramétrer l’accès à des images d’autres services de galeries d’images, comme Flickr ou Photobucket. Les paramètres que vous déterminez ici seront les mêmes pour tous les utilisateurs du site.

Configurer le bloc Galerie d’images

1. Utiliser Slimbox 2 ? : Cochez cette option si vous désirez utiliser ce script pour imbriquer les images sur une page. Slimbox2 est un script JavaScript, qui permet de créer une galerie d’images.
2. Cadre photo ? : Cochez cette option si vous désirez faire apparaître un cadre autour des miniatures de chaque photo dans les galeries.
3. Largeur maximale des photos : Fixe la largeur maximale [en pixels] de chaque photo qui sera affichée par le script Slimbox2.
4. Clé API de Flickr : Si vous désirez permettre aux utilisateurs d’afficher leurs photos hébergées par le service en ligne Flickr, vous devez indiquer ici une clé API valide. Vous devez faire une demande pour obtenir cette clé.
5. Clé API de Photobucket : Si vous désirez que vos utilisateurs puissent utiliser les services de Photobucket pour afficher une galerie de photos, vous devez indiquer une clé API valide ainsi qu’une clé privée. Vous pouvez obtenir ces deux informations sur la page développeurs de Photobucket.
6. Clé API privée : Indiquez ici la clé API privée que vous avez reçue.
7. Cliquez sur le bouton Enregistrer pour sauver vos modifications.

8.6.1.2. 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 installe en standard Flowplayer, a lecteur de média vidéos qui lit les fichiers FLV, MP4 (au format H.264) et MP3. Les vidéos sont incrustées et les sons joués grâce à Flowplayer.

D’autres formats de vidéos peuvent aussi être activés, mais les utilisateurs doivent alors posséder sur leur ordinateur le logiciel nécessaire pour les lire, il faut aussi que les plugins adéquats soient installés dans le navigateur web qui sera utilisé.

Configurer le bloc Média interne

1. Sélectionnez les types de fichiers que vous désirez autoriser vos utilisateurs à placer sur leurs pages de leurs portfolios.
2. Largeur: Déterminez la largeur par défaut (en pixels) pour une vidéo.
3. Hauteur: Déterminez la hauteur par défaut (en pixels) pour une vidéo.
4. Cliquez sur le bouton Enregistrer pour sauver vos modifications.

Note

Si vous autorisez des formats de fichiers qui ne peuvent pas être affichés par Flowplayer, certains utilisateurs qui n’auraient pas les logiciels nécessaires ne pourront pas voir ou écouter ces médias.

8.6.1.3. Type de bloc : Wall

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.

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.

8.6.1.4. Type de production : Comment

Si vous activez l’option de l’évaluation par note, chaque élément pourra être évalué par une échelle de 1 à 5, représentée par des petites étoiles.

Note

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

Activer l’évaluation par note

1. Sélectionnez cette option si vous désirez autoriser l’évaluation par notes.
2. Cliquez sur le bouton Enregistrer pour sauver vos modifications.

8.6.1.5. Type de productions : File

Vous pouvez paramétrer un certain nombre d’options pour le téléversement des fichiers.

Configurer le plug-in fichier

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 : Si vous cochez cette option, les comptes des utilisateurs actuels verront leur quota augmenté à la valeur indiquée sous Quota par défaut. Le quota sera mise à jour au moment ou vous cliquez sur le bouton Enregistrer
3. Quota par institution : Activez cette option si vous souhaitez permettre aux administrateurs des institutions de fixer leur propre quota d’espace disque à octroyer à leurs membres.
4. Forcer un quota maximum sur tout le site : Sélectionnez cette option pour éviter qu’un administrateur d’une institution n’octroie un quota d’espace disque supérieur à la valeur que vous avez indiquée pour l’ensemble du site.
5. 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.
6. 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.
7. Mettre à jour les quotas des groupes : Cochez cette option si vous désirez mettre à jour le quota dans chacun des groupes existants avec la valeur indiquée sous Quota du groupe par défaut. Le quota sera mise à jour au moment ou vous cliquez sur le bouton Enregistrer
8. Demander l’accord : En activant cette option, vous forcez les utilisateurs à accepter les règles de gestion des documents sur votre site avant chaque téléversement. Un texte par défaut est proposé. Il comprend les règles générales sur le droit d’auteur que l’utilisateur doit accepter avant de téléverser un document dans son espace de gestion des fichiers.
9. Utiliser l’accord personnalisé : Si ne désirez pas utiliser l’accord par défaut, vous pouvez créez votre propre texte en sélectionnant cette option. Vous ne pouvez sélectionner cette option que si vous avez préalablement activé l’option Demander l’accord.
10. 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.
11. Réduire automatiquement la taille des grandes images : Activez cette option 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.
12. Option utilisateur : Affiche aux utilisateurs, dans la page des préférences utilisateurs, l’option de retailler automatiquement les images.
13. Réduire automatiquement la taille des grandes images : Activez cette option 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.
14. Taille de l’image du profil : Choisissez la valeur maximale (en pixels) pour la largeur et la hauteur des images à afficher dans votre profil. Si une image est téléversée dans votre profil et qu’elle dépasse ces valeurs, son format sera modifié en concordance avec les valeurs maximales.
15. 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
16. Choisissez Tous pour sélectionner tous les types.
17. Sélectionner Aucun pour supprimer toutes les sélections que vous auriez faites.
18. Cliquez sur le bouton Enregistrer lorsque vous avez terminé de faire vos modifications.

8.6.1.6. 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 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. Cliquez sur le bouton Enregistrer pour sauver vos modifications.

8.6.1.7. Authentification : SAML

Si vous désirez utiliser l’authentification SAML sur votre site, vous devez donner ici le chemin vers le fichier php SAML.

Préparer votre site pour l’authentification par SAML

1. SimpleSAMLphp chemin d’accès à la librairie : Indiquez ici le chemin d’accès au dossier qui contient la librairie de SimpleSAMLphp, par exemple, si le chemin d’accès au fichier exécutable autoload.php est /chemin-vers/simplesamlphp_1_3/lib/_autoload.php alors cette valeur doit être /chemin-vers/simplesamlphp_1_3/
2. SimpleSAMLphp chemin d’accès au fichier de configuration : Indiquez ici le chemin d’accès au dossier qui contient le fichier de configuration à utiliser avec ce prestataire de services (SP) SimpleSAMLphp, par exemple : si le chemin vers le fichier config.php et /chemin-vers/simplesamlphp_1_3/config/config.php cette valeur doit être /chemin-vers/simplesamlphp_1_3/config/
3. Cliquez sur le bouton Enregistrer pour sauver vos modifications.

8.6.1.8. Recherche : Recherche interne

Si votre site compte un grand nombre d’utilisateurs et qu’il fonctionne avec une base de données PostgreSQL, la recherche d’utilisateurs est plus rapide en utilisant la méthode de recherche exacte. Cette méthode fonctionne aussi avec une base de données MySQL, mais dans ce cas il n’y a pas de gain de performance dans les recherches.

L’avantage des recherches exactes est que lorsque vous avez par exemple 20 utilisateurs avec le prénom « Nicolas », avec des noms de famille différents, vous pouvez trouver plus rapidement un utilisateur en tapant par exemple « Nicolas Martignoni ». Les résultats obtenus éviteront d’afficher par exemple « Nicolas Thorel », « Nicolas Henzelin », « Nicolas Flutsch », etc.

Toutefois, des résultats de recherche partiels, sur des parties des rubriques du profil, n’affichent pas de résultats. Donc, par exemple si vous avez demandé de rechercher un utilisateur qui se nomme Paula et que vous avez entré Paul dans la boîte de recherche, cet utilisateur ne sera pas trouvé.

Configurer le plug-in de recherche interne

1. Recherche exacte : Sélectionnez cette option si vous désirez activer les recherches exactes.
2. Cliquez sur le bouton Enregistrer pour sauver vos modifications.

8.6.1.9. 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.

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.

8.6.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.

8.6.3. Sources « iframe » autorisées

Administration → Extensions → Sources « iframe » autorisées

Cette fonctionnalité vous permet, en tant qu’administrateur du site, de spécifier la base des URLs que vous accepté de voir encapsulées dans les pages de vos utilisateurs. Ces iframes sont alors considérées comme étant sans danger pour votre serveur et ne seront pas supprimées du code HTML lorsqu’il est contrôlé par le « purificateur » de Mahara. Il est alors possible de placer les informations contenues dans l’iframe dans un article de journal, dans une boîte de texte ou sur une page à l’aide du bloc « Médias externes »

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.

Ajouter et modifier les sources d’iframes autorisées

1. Site : La base de l’URL du code iframe.
2. Nom d’affichage : Ce que l’utilisateur voir dans le bloc de médias externes.
3. Cliquez sur le bouton Modifier pour modifier le nom d’affichage d’un source iframe ou le favicon de cette source.
4. Cliquez sur le bouton Supprimer pour supprimer une source iframe autorisée.
5. Nom d’affichage : Modifiez le nom qui est attribué à la source d’un iframe existant 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 : Ajoutez une nouvelle source iframe autorisée en entrant la base de son URL ici. Veillez à ne pas mettre le protocole (http://``ou ``https://) devant l’adresse. Seules les lettres, les chiffres et les caractères . / - _ sont autorisés ici.
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 utiliser plusieurs adresses URLs, par ex. : GoogleApps ou Glogster. Pour chaque URL de ces sites qui propose l’encapsulage par iframe, vous devez créer une entrée dans la liste des sites autorisés. Si vous donnez le même nom de site à différentes bases d’URLs, le site n’apparaîtra qu’une seule fois dans les sources d’encapsulage affichées dans le bloc « Médias externes ».

8.6.4. URLs 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 :

• page de profil d’un utilisateur : http://mahara.exemple.fr/utilisateur/nicolas-thorel
• page du portfolio : http://mahara.exemple.fr/utilisateur/paula/page-de-paula-caterino
• page d’accueil d’un groupe : http://mahara.exemple.fr/groupe/groupe-de-paula
• page du portfolio d’un groupe : http://mahara.exemple.fr/groupe/groupe-de-paula/une-jolie-page-du-groupe

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.

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.