yeswiki-extension-groupmanagement

• English
• Français

English

Extension YesWiki to make easier the management of admins of entries.

Authors

• Jérémy Dufraisse
• Habitat Participatif France
• and all contributors indicated on this page : https://github.com/J9rem/yeswiki-extension-groupmanagement/graphs/contributors

Install

In page GererMisesAJour on your YesWiki website, search extension groupmanagement and install it. You may have to install the extension alternativeupdatej9rem by copiyng the folder alternativeupdatej9rem from this archive into the folder tools on your website.

This extension requires extension comschange to manage write acl check when using bazarliste.

Use Cases

This extension allows you to transfer the right to certain accounts to define groups, without being an administrator of the site.

• Accounts that can obtain this right must own a record in a well-identified form.
• These accounts can then add other members in the group of administrators of this card and/or in the group of people authorized to see this card.

Configuration

Forms To use this extension, it is needed to organize forms before :

• 1 form containing wanted users' group information (structures) which we keep the number.
• 1 form to create entroes for members. The concerned member should have an account link to the entry member. This could be done with a field utilisateur_wikini to put in the form member.
• create a link between the two forms : add into the form member, if not already done, a field of type liste, radio or checkbox that is linked to the form structure.

Extension's usage

1. create, as an administrator, a new page
2. use the components button, to add the rights management action {{groupmanagement}}
3. click on the toothed wheel of the action (not the one on the website)
4. choose the structures form first, the member form second and tick the bazar fields that need to be scanned
5. Check the box to give write rights if this is the desired behavior.
6. A suffix will be added to each structures card name to give the name of the associated group. This suffix is customizable.
7. It is possible to configure a macro group where each administrator of a structure will be added, but the name must not contain underscore character.
8. Save and then return
9. You can now choose a structure and allow potential members to be amdministrators.

The newly created groups can then be used anywhere to set finer read or edit rights.

Restriction only for specific structures:

• it is possible to activate the option only for specific structures.
• for that:
  1. go to the page GererConfig on the wiki
  2. in the part groupmanagement, for option groupmanagement[authorizedParents], itype the list of entry's name of concerned structures, separated by coma (put * to authorized all entries)

Tips

• bazar field autoregisterlinkedentryatcreation aims to be added in the structure form so that the connected account is automatically linked to this structure when it is created. This can only work if the logged-in user already has a member card associated with their account.
• bazar field aclselect is a new field provided by this extension that allows you to define whether you want your card to be visible or not. this field is still under construction.

Warranty

Like written in the licence file, there is no warranty on usage of this software. Refer to licence file for details. Developpers of this extension can not be responsible of consequences of the usage of this extension.

---

Français

Extension YesWiki pour mettre faciliter la gestion des droits des fiches.

Auteurs

• Jérémy Dufraisse
• Habitat Participatif France
• et tous les contributeurs et toutes les contributrices indiqués sur cette page : https://github.com/J9rem/yeswiki-extension-groupmanagement/graphs/contributors

Installation

Dans la page GererMisesAJour de votre YesWiki, recherchez l'extension groupmanagement et installez-là. Vous pourriez avoir besoin d'installer l'extension alternativeupdatej9rem en copiant le dossier alternativeupdatej9rem depuis l'archive dans le dossier tools sur votre site.

Cette extension a besoin de l'extension comschange pour pouvoir vérifier les droits deécriture en utilisant bazarliste.

Utilisation

Cas d'usage

Cet extension permet de transférer le droit à certains comptes de définir des groupes, sans être administrateur du site.

• Les comptes qui peuvent obtenir ce droit doivent être propriétaire d'une fiche dans un formulaire bien identifié.
• Ces comptes peuvent alors ajouter d'autres membres dans le groupe des administrateurs de cette fiche et/ou dans le groupe des personnes autorisées à voir cette fiche.

Configuration

Les formulaires Pour utiliser cette extension, il faut au préalable organiser vos formulaires :

• 1 formulaire qui contiendra les informations des groupes utilisateurs souhaités (structures) dont on note le numéro.
• 1 formulaire pour la création des fiches des membres. Il est souvent souhaitable que la personne connectée ait un compte lié à la fiche membre. Ceci peut être garanti grâce au champ utilisateur_wikini à placer dans le formulaire membre.
• Lier les 2 formulaires : ajouter au formulaire membre, si ça n'est pas déjà le cas, un champ de type liste, radio ou checkbox qui pointe vers le formulaire structure.

Utilisation de l'extension

1. créer, en tant qu'administrateur, une nouvelle page
2. utiliser le bouton composants, pour ajouter l'action de gestion des droits {{groupmanagement}}
3. cliquer sur la roue crantée de l'action (pas celle du site internet)
4. choisir le formulaire structures en premier, le formulaire membre en second et cocher les champs bazar qu'il faut scanner
5. cocher la case pour donner les droits d'écriture si c'est le comportement souhaité.
6. un suffixe sera ajouté à chaque nom de fiche structures pour donner le nom du groupe associé. Ce suffixe est personnalisable mais n'accepte pas les underscores.
7. Il est possible de configurer un macro groupe où chaque administrateur d'une structure sera ajouté.
8. Sauvegarder puis retour
9. Vous pouvez maintenant choisir une structure et autoriser les membres potentiels à être administrateurs.

Les nouveaux groupes créés peuvent alors être utilisés partout pour définir des droits de lecture ou de modification plus fins.

Restriction uniquement pour certaines structures:

• il est possible de restreindre l'option uniquement à certaines structures.
• pour celà :
  1. se rendre dans la page GererConfig de votre wiki
  2. dans la partie groupmanagement, pour l'option groupmanagement[authorizedParents], indiquer la liste des noms des fiches structures concernées, séparées par des virguules (mettre * pour retirer la restriction)

Astuces

• champ bazar autoregisterlinkedentryatcreation a pour objectif d'être ajouté dans le formulaire structure afin que le compte connecté soit automatiquement relié à cette structure lors de la création de celle-ci. Ceci ne peut fonctionner que si l'utilisateur connecté possède déjà une fiche membre associée à son compte.
• champ bazar aclselect est un nouveau champ fournit par cette extension qui permet de définir si on veut que sa fiche soit visible ou non. ce champ est encore en phase de construction.

Garantie

Comme énoncé dans le fichier de licence, il n'y a pas de garantie sur l'usage de ce logiciel. Référer au fichier de licence pour les détails. Les développeurs de cette extension ne peuvent être responsables des conséquences qui découlent de l'usage de cette extension.