Le cadre « Émetteur » se dessine par-dessus le logo

Le symptôme est franc : vous générez un PDF, et le cadre qui contient votre raison sociale et votre adresse est dessiné par-dessus le logo. Illisible. Comme le logo est à sa taille normale, on cherche longtemps du côté des dimensions de l’image, où il n’y a rien à trouver.

Ce que ce n’est pas

La première piste, la plus naturelle, est la hauteur du logo : dans ConfigurationPDF, Dolibarr laisse fixer une hauteur maximale, et un logo trop haut peut effectivement déborder.

Sur une instance de test en 24.0.0, un logo large a été poussé à 50 mm puis à 28 mm de hauteur : le débordement se produit, mais seulement à des hauteurs que personne ne règle en pratique. Avec une hauteur normale, ce n’est pas la cause.

Ce que c’est

Le déclencheur est une option de mise en page : la position du bloc d’adresse selon la norme d’affranchissement, souvent appelée « position La Poste ». Quand elle est active, le bloc Émetteur est placé plus haut, et en version 24 il se retrouve dans la zone du logo.

La cause est dans le modèle de document pdf_eratosthene, au moment de dessiner le bloc de l’émetteur. Jusqu’à la 23, la position verticale était calculée avec une marge fixe ; en 24 elle utilise $this->marge_haute, nettement plus petite. Le bloc remonte donc sur le logo.

Le modèle Proforma hérite d’Eratosthène : c’est pourquoi le problème apparaît aussi sur les proformas. Le modèle Einstein, lui, n’est pas concerné.

Comment cela a été vérifié

• Reproduction sur une instance Docker Dolibarr 24.0.0 neuve, avec un logo large (rapport 6:1).
• Option de position d’adresse activée, hauteur de logo normale (20 mm) : le cadre se pose sur le logo.
• Même logo, option désactivée, hauteur poussée à 45 mm : pas de chevauchement.
• Ligne de code comparée sur les étiquettes 24.0.0 et 24.0.1, puis sur les branches 24.0 et de développement : identique partout. Sur la 23.0.4, la valeur est bien l’ancienne.

Les deux sorties

Décocher l’option, immédiat, sans toucher au code. Dans la configuration des PDF, désactivez la position d’adresse selon la norme d’affranchissement. Le bloc Émetteur reprend sa place et le logo redevient lisible.

Attendre la prochaine 24.0.x. Le correctif — une ligne — a été proposé au projet et fusionné dans la branche 24.0 le 8 septembre 2026 (contribution n° 40185, signalement n° 40184). Il sortira dans une prochaine version de maintenance. Si vous avez désactivé l’option, vous n’avez rien à faire : le fichier ne vous servira que le jour où vous voudrez la réactiver.

Ce qu’il faut en retenir

Quand un rendu PDF part de travers, l’ordre de vérification qui fait gagner du temps est : quel modèle est réellement utilisé, et de quel autre modèle il hérite ; puis quelles options de mise en page sont actives ; et seulement ensuite les dimensions de vos images. L’ordre intuitif est l’inverse, et il coûte des heures.