Standarde de codare HTML în WordPress

WordPress urmează un set de standarde de codare HTML care diferă de standardele PSR mai degrabă decât spații, și plasează suportul de deschidere pe aceeași linie.

Manualul WordPress acoperă standardele de codificare în mai multe detalii

Standarde de codare HTML

Validare

Toate paginile HTML trebuie verificate cu validatorul W3C pentru a se asigura că marcajul este bine format. Acest lucru în sine nu indică în mod direct un cod bun, dar ajută la eliminarea problemelor care pot fi testate prin automatizare. Nu înlocuiește revizuirea manuală a codului. (Pentru alți validatori, consultați Validarea HTML în Codex.)

Elemente cu auto-închidere

Toate etichetele trebuie să fie închise corespunzător. Pentru etichetele care pot împacheta noduri, cum ar fi text sau alte elemente, terminarea este o sarcină destul de banală. Pentru etichetele care se închid automat, bara oblică trebuie să aibă exact un spațiu înaintea acesteia:

<br />

mai degrabă decât compact, dar incorect:

<br/>

W3C specifică faptul că un spațiu ar trebui să precedă bara oblică cu auto-închidere (sursa).

Atribute și etichete

Toate etichetele și atributele trebuie scrise cu litere mici. În plus, valorile atributelor ar trebui să fie cu litere mici atunci când scopul textului din acestea trebuie interpretat doar de mașini. Pentru cazurile în care datele trebuie să poată fi citite de om, trebuie urmată scrierea corectă a titlului cu majuscule.

Pentru masini:

<meta http-equiv="content-type" content="text/html; charset=utf-8" />

Pentru oameni:

<a href="http://example.com/" title="Description Here">Example.com</a>

Ghilimele

Conform specificațiilor W3C pentru XHTML, toate atributele trebuie să aibă o valoare și trebuie să utilizeze ghilimele duble sau simple (sursa). Următoarele sunt exemple de utilizare corectă și necorespunzătoare a ghilimelelor și a perechilor atribut/valoare.

Corect:

<input type="text" name="email" disabled="disabled" />
<input type='text' name='email' disabled='disabled' />

Incorect:

<input type=text name=email disabled>

În HTML, atributele nu trebuie să aibă toate valori, iar valorile atributelor nu trebuie să fie întotdeauna între ghilimele. Deși toate exemplele de mai sus sunt HTML valide, neincluderea în ghilimele a atributelor poate duce la vulnerabilități de securitate. Puneți întotdeauna între ghilimele atributele.

Indentare

Ca și în cazul PHP, indentarea HTML ar trebui să reflecte întotdeauna structura logică. Folosiți tasta Tab și nu spații.

Când mixați PHP și HTML împreună, indentați blocurile PHP pentru a se potrivi cu codul HTML din jur. Închiderea blocurilor PHP ar trebui să se potrivească cu același nivel de indentare ca și blocul de deschidere.

Corect:

<?php if ( ! have_posts() ) : ?>
<div id="post-1" class="post">
<h1 class="entry-title">Not Found</h1>
<div class="entry-content">
<p>Apologies, but no results were found.</p>
<?php get_search_form(); ?>
</div>
</div>
<?php endif; ?>

Incorrect:

<?php if ( ! have_posts() ) : ?>
<div id="post-0" class="post error404 not-found">
<h1 class="entry-title">Not Found</h1>
<div class="entry-content">
<p>Apologies, but no results were found.</p>
<?php get_search_form(); ?>
</div>
</div>
<?php endif; ?>

Sursa: WordPress, licența CC BY-NC-SA 3.0. Traducere și adaptare Nicolae Sfetcu