Clarify title insertion feature

Author: PierreRaybaut

datalab/config.py

@@ -201,6 +201,9 @@ class ViewSection(conf.Section, metaclass=conf.SectionMeta):
     # - "right": right
     plot_toolbar_position = conf.Option()
 
+    # Ignore information message when inserting object title as annotation label:
+    ignore_title_insertion_msg = conf.Option()
+
     # String formatting for shape legends
     sig_format = conf.Option()
     ima_format = conf.Option()

datalab/gui/actionhandler.py

@@ -692,10 +692,12 @@ def create_first_actions(self):
                 toolbar_pos=-1,
             )
             self.new_action(
-                _("Add object title to plot"),
+                _("Insert object title as annotation label"),
                 separator=True,
                 triggered=self.panel.add_label_with_title,
-                tip=_("Add object title as a label to the plot"),
+                tip=_(
+                    "Add the selected object's title as a label to the plot annotations"
+                ),
             )
             self.new_action(
                 _("Copy titles to clipboard"),

datalab/gui/panel/base.py

@@ -1957,4 +1957,19 @@ def add_label_with_title(self, title: str | None = None) -> None:
         objs = self.objview.get_sel_objects(include_groups=True)
         for obj in objs:
             create_adapter_from_object(obj).add_label_with_title(title=title)
+        if not Conf.view.ignore_title_insertion_msg.get(False):
+            answer = QW.QMessageBox.information(
+                self,
+                _("Annotation added"),
+                _(
+                    "The label has been added as an annotation. "
+                    "You can edit or remove it using the annotation editing window."
+                    "<br><br>"
+                    "Choosing to ignore this message will prevent it "
+                    "from being displayed again."
+                ),
+                QW.QMessageBox.Ok | QW.QMessageBox.Ignore,
+            )
+            if answer == QW.QMessageBox.Ignore:
+                Conf.view.ignore_title_insertion_msg.set(True)
         self.refresh_plot("selected", True, False)

datalab/gui/settings.py

@@ -233,6 +233,14 @@ class ViewSettings(gds.DataSet):
             ("right", _("Right (of plot)"), "libre-gui-arrow-right.svg"),
         ),
     )
+    ignore_title_insertion_msg = gds.BoolItem(
+        "",
+        _("Ignore title insertion message"),
+        help=_(
+            "Ignore information message when inserting object title as annotation label"
+        ),
+        default=False,
+    )
     _g0 = gds.EndGroup("")
 
     g1 = gds.BeginGroup(_("Signal"))

datalab/locale/fr/LC_MESSAGES/datalab.po

@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version:  datalab\n"
 "Report-Msgid-Bugs-To: p.raybaut@codra.fr\n"
-"POT-Creation-Date: 2025-09-12 13:45+0200\n"
+"POT-Creation-Date: 2025-09-13 18:49+0200\n"
 "PO-Revision-Date: 2025-05-22 15:46+0200\n"
 "Last-Translator: Christophe Debonnel <c.debonnel@codra.fr>\n"
 "Language: fr\n"
@@ -137,10 +137,12 @@ msgstr "Supprimer les métadonnées"
 msgid "Delete all that is contained in object metadata"
 msgstr "Supprimer toutes les métadonnées liées à l'objet"
 
-msgid "Add object title to plot"
-msgstr "Ajouter le titre de l'objet au graphique"
+#, fuzzy
+msgid "Insert object title as annotation label"
+msgstr "Ajouter le titre de l'objet comme étiquette au graphique"
 
-msgid "Add object title as a label to the plot"
+#, fuzzy
+msgid "Add the selected object's title as a label to the plot annotations"
 msgstr "Ajouter le titre de l'objet comme étiquette au graphique"
 
 msgid "Copy titles to clipboard"
@@ -974,6 +976,13 @@ msgstr "Tous les objets associés aux résultats doivent avoir les mêmes ROIs p
 msgid "Are you sure you want to delete all results of the selected object(s)?"
 msgstr "Êtes-vous sûr de vouloir supprimer tous les résultats des objets sélectionnés ?"
 
+msgid "Annotation added"
+msgstr "Annotation ajoutée"
+
+#, fuzzy
+msgid "The label has been added as an annotation. You can edit or remove it using the annotation editing window.<br><br>Choosing to ignore this message will prevent it from being displayed again."
+msgstr "L'étiquette a été ajoutée comme annotation. Vous pouvez la modifier ou la supprimer en utilisant la fenêtre d'édition des annotations.<br><br>Vous pouvez désactiver ce message dans les préférences ou en cliquant sur 'Ignorer' ci-dessous."
+
 msgid "Macro panel"
 msgstr "Panneau des macros"
 
@@ -1878,6 +1887,12 @@ msgstr "Gauche (à gauche du graphique)"
 msgid "Right (of plot)"
 msgstr "Droite (à droite du graphique)"
 
+msgid "Ignore title insertion message"
+msgstr "Ignorer le message d'insertion du titre"
+
+msgid "Ignore information message when inserting object title as annotation label"
+msgstr "Ignorer le message d'information lors de l'insertion du titre de l'objet en tant qu'étiquette d'annotation"
+
 msgid "Signal"
 msgstr "Signal"
 

doc/locale/fr/LC_MESSAGES/features/general/plugins.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: DataLab \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-07-08 14:49+0200\n"
+"POT-Creation-Date: 2025-09-13 18:41+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -227,9 +227,6 @@ msgstr "titre du nouveau signal"
 msgid "size of the new signal (default: None, get from current signal)"
 msgstr "taille du nouveau signal (par défaut : None, obtenue à partir du signal actuel)"
 
-msgid "hide signal type parameter (default: True)"
-msgstr "masquer le paramètre de type de signal (par défaut : True)"
-
 msgid "Returns"
 msgstr "Retourne"
 
@@ -280,3 +277,4 @@ msgstr "Instancier et obtenir les plugins disponibles"
 
 msgid "List of available plugins (as instances)"
 msgstr "Liste des plugins disponibles (en tant qu'instances)"
+