fix(pdf): honor show_help_text_in_detail in PDF output + release 0.74.18

The submission detail view rendered per-field help text under each
label when show_help_text_in_detail was checked, but the PDF and
bulk-PDF outputs ignored the flag entirely. _build_pdf_rows didn't
carry help_text onto its per-field entry dict, so the templates had
nothing to render.

Added help_text to _build_pdf_rows, plus rendering hooks in
submission_pdf.html and submission_bulk_pdf.html (main form table
plus the approval-step section tables in both). Style matches the
detail view: small italic line beneath the label.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: matteius

CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.74.18] - 2026-05-04
+
+### Fixed
+- **`show_help_text_in_detail` now applies to PDF output too.** The
+  submission detail view honored the per-field flag (rendering help
+  text in italics under the label) but the PDF and bulk-PDF templates
+  did not — ``_build_pdf_rows`` never carried ``help_text`` onto the
+  per-field entry dict, so the templates had nothing to render. Added
+  ``help_text`` to ``_build_pdf_rows``, plus rendering hooks in
+  ``submission_pdf.html`` and ``submission_bulk_pdf.html`` (main form
+  table and approval-step section tables in both). Help text appears
+  beneath the label in a smaller italic style, matching the detail
+  view's treatment.
+
 ## [0.74.17] - 2026-05-04
 
 ### Changed

django_forms_workflows/templates/django_forms_workflows/submission_bulk_pdf.html

@@ -49,6 +49,7 @@
         .col-label { width: 22%; }
         .col-value  { width: 28%; }
         .data-table th { background-color: #f0f0f0; font-weight: bold; font-size: 8pt; color: #333; border: 1px solid #d0d0d0; padding: 3pt 6pt; text-align: left; vertical-align: top; }
+        .data-table .field-help { font-size: 7pt; font-style: italic; color: #666; font-weight: normal; margin-top: 1pt; }
         .data-table td { font-size: 9pt; border: 1px solid #d0d0d0; padding: 3pt 6pt; vertical-align: top; }
         .data-table tr { page-break-inside: avoid; break-inside: avoid; }
         .section-row td { background-color: #e8f0f7 !important; color: #1a3a52; font-weight: bold; font-size: 8pt; letter-spacing: 0.3pt; text-transform: uppercase; padding: 4pt 6pt; border: 1px solid #b8ccd8; }
@@ -118,21 +119,21 @@
     <tr><td colspan="4" style="background: #f8f9fa; padding: 8pt;">{{ row.value|render_markdown }}</td></tr>
     {% elif row.type == 'pair' %}
     <tr>
-        <th>{{ row.fields.0.label }}</th>
+        <th>{{ row.fields.0.label }}{% if row.fields.0.help_text %}<div class="field-help">{{ row.fields.0.help_text }}</div>{% endif %}</th>
         <td>{% with v=row.fields.0.value %}{% if v.filename %}{{ v.filename }}{% if v.size %} ({{ v.size|filesizeformat }}){% endif %}{% else %}{{ v }}{% endif %}{% endwith %}</td>
-        <th>{{ row.fields.1.label }}</th>
+        <th>{{ row.fields.1.label }}{% if row.fields.1.help_text %}<div class="field-help">{{ row.fields.1.help_text }}</div>{% endif %}</th>
         <td>{% with v=row.fields.1.value %}{% if v.filename %}{{ v.filename }}{% if v.size %} ({{ v.size|filesizeformat }}){% endif %}{% else %}{{ v }}{% endif %}{% endwith %}</td>
     </tr>
     {% elif row.type == 'triple' %}
     {% for field in row.fields %}
     <tr>
-        <th>{{ field.label }}</th>
+        <th>{{ field.label }}{% if field.help_text %}<div class="field-help">{{ field.help_text }}</div>{% endif %}</th>
         <td colspan="3">{% with v=field.value %}{% if v.filename %}{{ v.filename }}{% if v.size %} ({{ v.size|filesizeformat }}){% endif %}{% else %}{{ v }}{% endif %}{% endwith %}</td>
     </tr>
     {% endfor %}
     {% else %}
     <tr>
-        <th>{{ row.fields.0.label }}</th>
+        <th>{{ row.fields.0.label }}{% if row.fields.0.help_text %}<div class="field-help">{{ row.fields.0.help_text }}</div>{% endif %}</th>
         <td colspan="3">{% with v=row.fields.0.value %}{% if v.filename %}{{ v.filename }}{% if v.size %} ({{ v.size|filesizeformat }}){% endif %}{% else %}{{ v }}{% endif %}{% endwith %}</td>
     </tr>
     {% endif %}
@@ -162,15 +163,15 @@
     <tr><td colspan="4" style="background: #f8f9fa; padding: 8pt;">{{ row.value|render_markdown }}</td></tr>
     {% elif row.type == 'pair' %}
     <tr>
-        <th>{{ row.fields.0.label }}</th>
+        <th>{{ row.fields.0.label }}{% if row.fields.0.help_text %}<div class="field-help">{{ row.fields.0.help_text }}</div>{% endif %}</th>
         <td>{% with v=row.fields.0.value %}{% if v.filename %}{{ v.filename }}{% else %}{{ v }}{% endif %}{% endwith %}</td>
-        <th>{{ row.fields.1.label }}</th>
+        <th>{{ row.fields.1.label }}{% if row.fields.1.help_text %}<div class="field-help">{{ row.fields.1.help_text }}</div>{% endif %}</th>
         <td>{% with v=row.fields.1.value %}{% if v.filename %}{{ v.filename }}{% else %}{{ v }}{% endif %}{% endwith %}</td>
     </tr>
     {% else %}
     {% for field in row.fields %}
     <tr>
-        <th>{{ field.label }}</th>
+        <th>{{ field.label }}{% if field.help_text %}<div class="field-help">{{ field.help_text }}</div>{% endif %}</th>
         <td colspan="3">{% with v=field.value %}{% if v.filename %}{{ v.filename }}{% else %}{{ v }}{% endif %}{% endwith %}</td>
     </tr>
     {% endfor %}

django_forms_workflows/templates/django_forms_workflows/submission_pdf.html

@@ -93,6 +93,13 @@
             text-align: left;
             vertical-align: top;
         }
+        .data-table .field-help {
+            font-size: 7pt;
+            font-style: italic;
+            color: #666;
+            font-weight: normal;
+            margin-top: 1pt;
+        }
         .data-table td {
             font-size: 9pt;
             border: 1px solid #d0d0d0;
@@ -265,23 +272,23 @@
 
     {% elif row.type == 'pair' %}
     <tr>
-        <th>{{ row.fields.0.label }}</th>
+        <th>{{ row.fields.0.label }}{% if row.fields.0.help_text %}<div class="field-help">{{ row.fields.0.help_text }}</div>{% endif %}</th>
         <td>{% with v=row.fields.0.value %}{% if v|is_signature %}<img src="{{ v }}" style="max-width:200px;max-height:80px;">{% elif v.filename %}{{ v.filename }}{% if v.size %} ({{ v.size|filesizeformat }}){% endif %}{% else %}{{ v }}{% endif %}{% endwith %}</td>
-        <th>{{ row.fields.1.label }}</th>
+        <th>{{ row.fields.1.label }}{% if row.fields.1.help_text %}<div class="field-help">{{ row.fields.1.help_text }}</div>{% endif %}</th>
         <td>{% with v=row.fields.1.value %}{% if v|is_signature %}<img src="{{ v }}" style="max-width:200px;max-height:80px;">{% elif v.filename %}{{ v.filename }}{% if v.size %} ({{ v.size|filesizeformat }}){% endif %}{% else %}{{ v }}{% endif %}{% endwith %}</td>
     </tr>
 
     {% elif row.type == 'triple' %}
     {% for field in row.fields %}
     <tr>
-        <th>{{ field.label }}</th>
+        <th>{{ field.label }}{% if field.help_text %}<div class="field-help">{{ field.help_text }}</div>{% endif %}</th>
         <td colspan="3">{% with v=field.value %}{% if v|is_signature %}<img src="{{ v }}" style="max-width:360px;max-height:120px;">{% elif v.filename %}{{ v.filename }}{% if v.size %} ({{ v.size|filesizeformat }}){% endif %}{% else %}{{ v }}{% endif %}{% endwith %}</td>
     </tr>
     {% endfor %}
 
     {% else %}
     <tr>
-        <th>{{ row.fields.0.label }}</th>
+        <th>{{ row.fields.0.label }}{% if row.fields.0.help_text %}<div class="field-help">{{ row.fields.0.help_text }}</div>{% endif %}</th>
         <td colspan="3">{% with v=row.fields.0.value %}{% if v|is_signature %}<img src="{{ v }}" style="max-width:360px;max-height:120px;">{% elif v.filename %}{{ v.filename }}{% if v.size %} ({{ v.size|filesizeformat }}){% endif %}{% else %}{{ v }}{% endif %}{% endwith %}</td>
     </tr>
     {% endif %}
@@ -335,15 +342,15 @@ <h3 style="margin-top: 20px;">Attachments</h3>
     </tr>
     {% elif row.type == 'pair' %}
     <tr>
-        <th>{{ row.fields.0.label }}</th>
+        <th>{{ row.fields.0.label }}{% if row.fields.0.help_text %}<div class="field-help">{{ row.fields.0.help_text }}</div>{% endif %}</th>
         <td>{% with v=row.fields.0.value %}{% if v|is_signature %}<img src="{{ v }}" style="max-width:200px;max-height:80px;">{% elif v.filename %}{{ v.filename }}{% else %}{{ v }}{% endif %}{% endwith %}</td>
-        <th>{{ row.fields.1.label }}</th>
+        <th>{{ row.fields.1.label }}{% if row.fields.1.help_text %}<div class="field-help">{{ row.fields.1.help_text }}</div>{% endif %}</th>
         <td>{% with v=row.fields.1.value %}{% if v|is_signature %}<img src="{{ v }}" style="max-width:200px;max-height:80px;">{% elif v.filename %}{{ v.filename }}{% else %}{{ v }}{% endif %}{% endwith %}</td>
     </tr>
     {% else %}
     {% for field in row.fields %}
     <tr>
-        <th>{{ field.label }}</th>
+        <th>{{ field.label }}{% if field.help_text %}<div class="field-help">{{ field.help_text }}</div>{% endif %}</th>
         <td colspan="3">{% with v=field.value %}{% if v|is_signature %}<img src="{{ v }}" style="max-width:360px;max-height:120px;">{% elif v.filename %}{{ v.filename }}{% else %}{{ v }}{% endif %}{% endwith %}</td>
     </tr>
     {% endfor %}

django_forms_workflows/views.py

@@ -3355,6 +3355,7 @@ def flush_third():
             "key": key,
             "value": _get_choice_label(field, form_data[key]),
             "width": field.width,
+            "help_text": field.help_text if field.show_help_text_in_detail else "",
         }
 
         if field.width == "half":

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "django-forms-workflows"
-version = "0.74.17"
+version = "0.74.18"
 description = "Enterprise-grade, database-driven form builder with approval workflows and external data integration"
 license = "LGPL-3.0-only"
 readme = "README.md"