​je ne fais jamais d'affichage via du code PHP, je passe par smarty et les templates

Avec un préfiltre tu peux modifier dynamiquement le contenu de la page par défaut
le but est de modifier le template pictute.tpl de :

id="theImage"
à
{$MON_BT}
id="theImage"
_______________________________________________________

​ avec quelque chose comme cela ( je n'ai rien testé c'est juste pour montrer l'architecture générale):

add_event_handler('loc_begin_picture', 'ajouter_btnOverlay');

function ajouter_btnOverlay()
{   $contenu_html_du_bouton =  '<button id="btnOverlay">Action</button>';
// le css sera dans un fichier css......
    global $template;
    $template->set_prefilter('picture', 'add_mon_bouton');
    $template->assign('MON_BT',$contenu_html_du_bouton);
}


function add_mon_bouton($content)
{   $search = 'id="theImage"';
    $replacement = '{$MON_BT}'. $search.
    return str_replace($search, $replacement, $content);
}

je ne sais pas si la documentation précise l'utilisation des triggers...
Selon moi(**), il n'y a pas de réponse formelle(pour les triggers généraux).

La boîte à outils de PIWIGO pour la personnalisation est très complète.

Chaque page propose un trigger BEGIN et un trigger END.

Selon ce que tu souhaites faire, ce sera plus simple/possible dans l'un ou l'autre des triggers.

Par défaut je privilégie l'ordre logique  le BEGIN ,si c'est plus simple ou impossible, je prends le END

Impossible, signifie que les variables dont j'aurai besoin n'existent pas dans le BEGIN, mais sont définies dans le END.

A contrario dans le END tu ne pourras plus revenir sur certains éléments.

Dans ta demande initiale, je t'ai proposé un pré filtre, car l'ajout/modification était basique et ne nécessitait pas de logique.

Cela correspondait bien à l'ajout dynamique d' une variable, à un emplacement que tu avais choisi.

il existe déjà de variables pour des emplacements prédéfinis:(ex pour picture)
{$PLUGIN_PICTURE_ACTIONS}
{$PLUGIN_PICTURE_AFTER}

Si ton ajout est plus important ou que tu souhaites de la logique:
Tu peux/dois définir un mini template  personnel et l'ajouter à la page.

Tout cela pour rester dynamique, sinon il y a les template-extensions.

** RQ:
      je ne suis pas un développeur, je m'amuse avec un petit site.
      L'équipe PWIGO me corrigera, si l'on peut mieux faire......