how to configure GNOME extensions

_toc.yml

@@ -94,13 +94,13 @@ chapters:
               - file: admin-guide/configuration/software/citrix_vda
           - file: admin-guide/configuration/files
             sections:
+              - file: admin-guide/configuration/files/distribute_files
               - file: admin-guide/configuration/files/windows_drives_in_home
               - file: admin-guide/configuration/files/central_storage_mount
               - file: admin-guide/configuration/files/partially_shared_home
+              - file: admin-guide/configuration/files/mount
               - file: admin-guide/configuration/files/autofs
               - file: admin-guide/configuration/files/afs
-              - file: admin-guide/configuration/files/mount
-              - file: admin-guide/configuration/files/distribute_files
               - file: admin-guide/configuration/files/systemd_tmpfiles
               - file: admin-guide/configuration/files/partitioning
               - file: admin-guide/configuration/files/resize_vm_disk
@@ -117,8 +117,9 @@ chapters:
               - file: admin-guide/configuration/desktop/autologin
               - file: admin-guide/configuration/desktop/screen_lock
               - file: admin-guide/configuration/desktop/banner_message
-              - file: admin-guide/configuration/desktop/alternative_desktops
+              - file: admin-guide/configuration/desktop/gnome_extentions
               - file: admin-guide/configuration/desktop/dconf
+              - file: admin-guide/configuration/desktop/alternative_desktops
           - file: admin-guide/configuration/monitoring
             sections:
               - file: admin-guide/configuration/monitoring/icinga2

admin-guide/configuration/desktop/gnome_extensions.md

@@ -0,0 +1,54 @@
+# Gnome Extensions
+
+Various extensions allow to extend the Gnome Desktop functionality.
+
+## Installing a Extension
+
+The systemwide installation directory for extensions is `/usr/share/gnome-shell/extensions/`, but they can also be installed for just a single user in `~/.local/share/gnome-shell/extensions/`.
+
+Gnome extensions can be installed as software package, via browser and the [Gnome Extensions Website](https://extensions.gnome.org/) or manually.
+
+## Configure an Extension for all Users
+
+In Hiera add the identifier/technical name of the desired extension to the `gnome::custom_extensions` list:
+
+```
+gnome::custom_extensions:
+  - 'desktop-icons@gnome-shell-extensions.gcampax.github.com'
+```
+
+You can figure out the technical name by listing the installation directory (see above chapter) or by checking the list of activated extensions before and after enabling it using the GUI (`Tweaks` on RHEL8 and `Extensions` onr RHEL9+):
+
+```
+$ dconf dump  /org/gnome/shell/ | grep enabled-extensions
+enabled-extensions=['appindicatorsupport@rgcjonas.gmail.com', 'desktop-icons@gnome-shell-extensions.gcampax.github.com']
+$
+```
+
+For the actual configuration of the extension itself, best do it with the GUI tool and then list the configuration of all extensions as follows:
+
+```
+$ dconf dump /org/gnome/shell/extensions/
+[dash-to-dock]
+show-trash=false
+dock-fixed=true
+dock-position='BOTTOM'
+$
+```
+or watch the changes live with
+
+```
+$ dconf watch /org/gnome/shell/extensions/
+/org/gnome/shell/extensions/desktop-icons/show-trash
+  false
+
+/org/gnome/shell/extensions/desktop-icons/show-home
+  false
+```
+and then bring your changes into your default [dconf configuration](dconf).
+
+Note that users may still override such configuration.
+To these settings do
+```
+rm ~/.config/dconf/user
+```

user-guide/gnome_desktop_icons.md

@@ -5,7 +5,7 @@ By default Gnome does not show any more icons on the desktop since version 3.
 This guide will show how to bring them back.
 
 ## Enable Desktop Icon Extension
-Start the "Tweak" tool:
+Start the "Tweak" tool (note in RHEL9+ this functionality move to the "Extensions" tool):
 
 
 ![Start "Tweak"](gnome_desktop_icons/start_tweak.png)