>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #3495516. --> Reported by: [jwilson3](https://www.drupal.org/user/220177) Related to !15 >>> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <p>Label Help's README describes a way to add label help programmatically via custom code.</p> <p>This was a holdover of something that worked in Drupal 7, but the code samples in the README do not actually work in the 8.x or 2.x branches of this module.</p> <h4 id="summary-steps-reproduce">Steps to reproduce</h4> <p>1. Install Drupal 10.<br> 2. Install Label Help.<br> 3. Create a custom module with the following code:</p> <div class="codeblock"> <pre><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br></span><span style="color: #FF8000">/**<br>&nbsp;* Implements hook_form_alter().<br>&nbsp;* <br>&nbsp;* Adds label_help to the Node Title field on Article node type.<br>&nbsp;*/<br></span><span style="color: #007700">function </span><span style="color: #0000BB">my_module_form_node_article_form_alter</span><span style="color: #007700">(&amp;</span><span style="color: #0000BB">$form</span><span style="color: #007700">, &amp;</span><span style="color: #0000BB">$form_state</span><span style="color: #007700">, </span><span style="color: #0000BB">$form_id</span><span style="color: #007700">) {<br>&nbsp; </span><span style="color: #0000BB">$form</span><span style="color: #007700">[</span><span style="color: #DD0000">'title'</span><span style="color: #007700">][</span><span style="color: #DD0000">'#theme_options'</span><span style="color: #007700">][</span><span style="color: #DD0000">'description at top'</span><span style="color: #007700">] = </span><span style="color: #0000BB">t</span><span style="color: #007700">(</span><span style="color: #DD0000">'Label help message for the Title field.'</span><span style="color: #007700">);<br>}<br></span><span style="color: #0000BB">?&gt;</span></span></pre></div> <p>4. Load /node/add/article page.</p> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <p>Instead of <code>$element['#theme_options']['description at top']</code>, support a <code>$element['#label_help']</code> property in order to self-document the <em>raison d'etre</em>. </p> <p>The supported syntax is:</p> <div class="codeblock"> <pre><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br></span><span style="color: #FF8000">/**<br>&nbsp;* Implements hook_form_alter().<br>&nbsp;* <br>&nbsp;* Adds label_help to the Node Title field on Article node type.<br>&nbsp;*/<br></span><span style="color: #007700">function </span><span style="color: #0000BB">my_module_form_node_article_form_alter</span><span style="color: #007700">(&amp;</span><span style="color: #0000BB">$form</span><span style="color: #007700">, &amp;</span><span style="color: #0000BB">$form_state</span><span style="color: #007700">, </span><span style="color: #0000BB">$form_id</span><span style="color: #007700">) {<br>&nbsp; </span><span style="color: #0000BB">$form</span><span style="color: #007700">[</span><span style="color: #DD0000">'title'</span><span style="color: #007700">][</span><span style="color: #DD0000">'#label_help'</span><span style="color: #007700">] = </span><span style="color: #0000BB">t</span><span style="color: #007700">(</span><span style="color: #DD0000">'Label help message for the Title field.'</span><span style="color: #007700">);<br>}<br></span><span style="color: #0000BB">?&gt;</span></span></pre></div> <p>For this to work, we must move the label_help module's main logic out of hook_form_alter() and into a Form API <em>process callback</em>, in order to completely sidestep a problem where label_help_form_alter() executes before a hook_form_alter() in a custom module has had a chance to add the #label_help property.</p> <h3 id="summary-remaining-tasks">Remaining tasks</h3> <h3 id="summary-ui-changes">User interface changes</h3> <h3 id="summary-api-changes">API changes</h3> <h3 id="summary-data-model-changes">Data model changes</h3>