.. _tlwebadm_profiles:

The Profiles Module
~~~~~~~~~~~~~~~~~~~

On this page you can modify text shown in the profile chooser, and
manage profiles. You can create or delete a profile and configure the
profile order.

- :guilabel:`Introduction Texts` allows you to modify and manage
  translation of texts used in the profile chooser.

- :guilabel:`Profile List` allows you to configure the available
  profiles and their order.

.. _tlwebadm_profiles_introductions_texts:

Introduction Texts
^^^^^^^^^^^^^^^^^^

:guilabel:`Introduction texts` contains translation tables for greetings
and introduction texts. There is also a configuration option to enable
or disable the use of introduction texts.

- :guilabel:`Greeting Text` the text to show at the top of the profile
  chooser.

- :guilabel:`Show Introduction` disable or enable the introduction text
  which is shown to the user before the profile selection dialog.

- :guilabel:`Introduction Text` the text to show before presenting the
  list of profiles.

To add a new translation, fill in language code and the translated
string. Click the :guilabel:`Save` button to save the new translation
and add it to the translation table.

To delete a translation select the row using the checkbox in
:guilabel:`Delete` column of the translation table. Click the
:guilabel:`Save` button to carry out the actual deletion of selected
rows.

.. _tlwebadm_profiles_profiles_list:

Profile List
^^^^^^^^^^^^

The :guilabel:`Profile List` module contains functionality to manage
your profiles. You can change the default profile, or create new and
edit existing profiles. You can also change the order of profiles.

- :guilabel:`Default Profile` allows you to specify the default profile
  to be selected in the profile chooser.

- :guilabel:`Profile List` allows you to modify profiles and their
  order, or create new profiles.

Create a new profile by clicking the :guilabel:`Add new profile` button.
If you want to edit an existing profile, click the profile name in the
table of available profiles.

When creating a new or editing an existing profile a form is displayed.
This form is shared between both modes and each field details are
described below.

-  :guilabel:`Identification`

   An unique string identifier for the profile which is used when
   referencing this profile.

-  :guilabel:`XDG Session Desktop`

   The system desktop session configuration that this profile should be
   connected to.

-  :guilabel:`Default Name`

   A name for the profile which is displayed in the profile chooser.

-  :guilabel:`Availability`

   This will make the profile available to be selected and used. If you
   uncheck it will not be shown to the user in the profile chooser.

-  :guilabel:`Take Description From`

   The description is shown in the profile chooser when a profile is
   selected. This field can be a static text which is defined in the
   input field :guilabel:`Default Description`.

   -  :guilabel:`Test command`: This will take and use the output of
      defined :guilabel:`Test Command` as description for the profile.

   - :guilabel:`Manually defined text below`: This will use the text
     defined in the :guilabel:`Default Description` field below.

-  :guilabel:`Default Description`

   A text used as description for the profile. This is text is used if
   :guilabel:`Take Description From` above is selected to use the
   manually defined text.

-  :guilabel:`Icon Path`

   A filename of the icon to use in the profile chooser.

-  :guilabel:`Screenshot Path`

   A filename of the screenshot to use in the profile chooser.

-  :guilabel:`Command Line`

   This command is used to start up a session. In most cases this is
   something simple like ``xfce4-session``, but in some cases there
   might also be arguments like
   ``gnome-session --session gnome-classic``.

-  :guilabel:`Test Command`

   This command is evaluated and if it returns true, the profile is
   shown to the user. If the command evaluates as false, the profile
   will not be shown in the list of available profiles for the user.

   ThinLinc includes the tool :program:`tl-memberof-group` which may be
   used to test memebership of groups. You can use this tool as test
   command, such as ``${TLPREFIX}/bin/tl-memberof-group
   my_profile_access_group``. This example will give members of group
   ``my_profile_access_group`` access to the profile.

   If you only want to give a specific user access to the profile you
   may specify ``test ${USER} = user``.

When you have filled out the form, or changed any fields, click
:guilabel:`Save` button at the bottom of the form to save your changes
into the configuration file.

To delete a profile click the profile name in table of available
profiles. Then click the checkbox at the bottom of the form to verify
your intention about deletion of the profile. Complete the deletion by
clicking the :guilabel:`Delete` button.
