.. meta::
   :description: Manage profiles and introduction texts in the ThinLinc
                 web administration interface, including creating,
                 editing, and organizing user profiles and translations
                 for the profile chooser.

.. _tlwebadm_profiles:

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. See :ref:`profiles` for more information on what a
profile is.

- :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` contain translation tables for greetings
and introduction texts. You can configure whether to display the
introduction texts using :guilabel:`Show introduction` and whether to
prevent users from hiding them using :guilabel:`Force introduction`.

When an introduction text is updated, user preferences to hide it are
automatically reset, ensuring that new information is always shown to
all users.

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

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

To add a new translation, fill in the 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, create new or edit
existing profiles, or change the order of profiles.

- :guilabel:`Default profile` allows you to specify the default profile
  to be selected in the profile chooser for first time users.

- :guilabel:`Active profiles` allows you to modify active profiles and
  their order, or create new profiles. These are presented to the user
  in the same order as in the list. Note that other criteria must also
  be satisfied for a profile to be available to a user.

- :guilabel:`Inactive profiles` allows you to modify inactive
  profiles. These are not presented to the user.

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 pop-up is displayed.
This pop-up is shared between both modes and each field details are
described below.

-  :guilabel:`Identification`

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

-  :guilabel:`Make profile available`

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

-  :guilabel:`XDG session desktop`

   The system desktop session configuration that this profile should be
   connected to. See :servconf:`/profiles/<profile key>/xdg_session` for
   more information.

-  :guilabel:`Default name`

   A name for the profile which is displayed 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 the
      defined :guilabel:`Test command` as the 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 the 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. See
   :servconf:`/profiles/<profile key>/icon` for more information.

-  :guilabel:`Screenshot path`

   A filename of the screenshot to use in the profile chooser. See
   :servconf:`/profiles/<profile key>/screenshot` for more information.

-  :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``. See
   :servconf:`/profiles/<profile key>/cmdline` for more information.

-  :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. See
   :servconf:`/profiles/<profile key>/testcmd` for more information.

When you have finished editing the fields, click :guilabel:`Save` button
at the bottom of the pop-up to save your changes into the configuration
file.

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