admin/institutions: Add institution tags

New feature in Mahara 18.10: You can set up
institution tags for your members to use as
official tags helping to choose the right one
(Bug #1722861).

source/administration/institutions.rst

@@ -72,7 +72,7 @@ Add an institution
 .. note::
    Only site administrators can add institutions. However, once an institution exists, institution administrators can change many of the settings.
 
-When you want to add an institution by clicking the *Add* button on *Administration menu → Institutions → Institutions*, you need to provide some basic information for the new institution. You can change all settings later on.
+When you want to add an institution by clicking the *Add institution* button on *Administration menu → Institutions → Institutions*, you need to provide some basic information for the new institution. You can change all settings later on.
 
 .. figure:: /images/administration/institution_add.*
    :alt: Add a new institution
@@ -141,11 +141,18 @@ When you want to add an institution by clicking the *Add* button on *Administrat
      :index:`When the maximum number of accounts has been reached <single: Notification to administrators about full institution membership quota>` and another user tries to register for the institution, the site administrator as well as the institution administrator for that institution receive a notification. That allows them to take further steps.
 
 #. **Allow SmartEvidence**: :index:`Activate <single: SmartEvidence: Active frameworks for an institution>` :ref:`SmartEvidence <smartevidence>` if you want your institution users to work with it.
+#. |new in Mahara 18.10| **Allow institution tags**: :index:`If <single: New in Mahara 18.10; Turn on institution tags>` set to "Yes", you can set up tags for the members of your institution to use in their portfolios.
+
+   .. note::
+      When turned on, the new menu item *Tags* will appear in the institution sub menu.
+
 #. **Review accounts before self-deletion**: If set to "Yes", an institution administrator needs to approve or deny the deletion of a user account when the deletion is initiated by the user.
 
    .. note::
       This setting gives institutions in a formal learning setting the possibility to prevent accidental account deletion by people before portfolios are archived if required.
 
+      If the field is set to "Yes" and greyed out, the site administrator requires the confirmation for all institutions on the site.
+
 #. **Locked fields**: Switch any value to "Yes" if you don't want to allow changes to it by users. Disabled switches are for profile fields which are locked in the institution settings for "No institution". These profile fields are locked at the site level and cannot be unlocked for individual institutions.
 
    .. note::
@@ -276,6 +283,11 @@ Your Mahara site itself is listed as institution under *Administration menu →
 
 #. **Threaded comments**: Display comments on a page in a threaded manner so you can see easily which comment is a reply to which previous comment.
 #. **Allow SmartEvidence**: :index:`Activate <SmartEvidence: Active frameworks for the site institution>` :ref:`SmartEvidence <smartevidence>` if you want your institution users to work with it.
+#. |new in Mahara 18.10| **Allow institution tags**: If set to "Yes", you can set up tags for the members of your institution to use in their portfolios.
+
+   .. note::
+      When turned on, the new menu item *Tags* will appear in the institution sub menu.
+
 #. **Review accounts before self-deletion**: If set to "Yes", the site administrator needs to approve or deny the deletion of a user account that is not in associated with an institution when the deletion is initiated by the user.
 #. **Locked fields**: Switch any value to "Yes" if you don't want to allow changes to it by users. Any field that you enable here is locked from editing in institutions.
 
@@ -1216,6 +1228,58 @@ The *files area* in an institution holds all files that are uploaded by administ
 
    Institution files area
 
+.. index::
+   pair: Institution; Tags
+   single: New in Mahara 18.10; Institution tags
+
+.. _institution_tags:
+
+|new in Mahara 18.10| Tags
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+*Administration menu → Institutions → Tags*
+
+Manage institution tags
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. figure:: /images/administration/institution_tags.*
+   :alt: Manage institution tags
+
+   Manage institution tags
+
+#. **Institution**: If you administer more than one institution, select the one for which you want to manage tags. If there is only one institution, its name will be displayed without the drop-down menu.
+#. Click the *Create tag* button to set up a new tag.
+#. **Tag**: Lists all the tags created in this institution.
+#. **Times used**: Displays the number of times the tag has been used by institution members.
+#. Click the *Delete* button |delete| to remove a tag.
+#. If a tag is currently in use, you cannnot delete it.
+
+Create an institution tag
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. figure:: /images/administration/institution_tags_add.*
+   :alt: Create an institution tag
+
+   Create an institution tag
+
+#. Click the *Create tag* button on the *Tags* page to set up a new tag.
+#. **Institution tag**: Enter a new institution tag. It can consist of multiple words.
+#. Click the *Save* button to save this new tag or click *Cancel* to abort the action.
+
+Use an institution tag
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. figure:: /images/administration/institution_tags_use.*
+   :alt: Use institution tags
+
+   Use institution tags
+
+You can use tags from the institution to which you belong anywhere you can enter tags.
+
+#. Click into the tag search box and start typing a couple of letters of the tag you are looking for. The search narrows down to the potential tags
+#. Institution tags are prefixed with the institution's name.
+#. You see the actual tag after the institution name including how many times you have used it.
+
 .. index::
    pair: Institution; Pending user account registration
    pair: Institution; New account