Recomandări pentru fișierele șablon în teme WordPress. Testarea temei

Recomandări pentru fișierele șablon

La dezvoltarea temei, verificați fișierele șablon în funcție de următoarele standarde specifice.

Antet document (header.php)

Utilizați DOCTYPE corect.
Eticheta de deschidere <html> ar trebui să includă language_attributes().
Elementul de caractere <meta> trebuie să fie plasat înainte de orice altceva, inclusiv elementul <title>.
Utilizați bloginfo() pentru a seta setul de caractere <meta> și descrierea elementelor.
Utilizați wp_title() pentru a seta elementul <title>.
Utilizați Automatic Feed Links pentru a adăuga linkuri la flux.
Adaugă un apel la wp_head(), înainte de a închide eticheta </head>. Modulele folosesc acest cârlig de acțiune pentru a adăuga propriile lor scripturi, foi de stil, și alte funcționalități.
Nu legați foile de stil tematice în șablonul Antet. Utilizați cârligul de acțiune wp_enqueue_scripts într-o funcție a temei în schimb.

Iată un exemplu de HTML5 corect formatat care corespunde zonei de antet:

<!DOCTYPE html>
<html <?php language_attributes(); ?>>
<head>
<meta charset=”<?php bloginfo( ‘charset’ ); ?>”
/>
<title><?php wp_title(); ?></title>
<link rel=”profile” href=”http://gmpg.org/xfn/11″ />
<link rel=”pingback” href=”<?php bloginfo( ‘pingback_url’
); ?>” />
<?php if ( is_singular() && get_option(
‘thread_comments’ ) ) wp_enqueue_script( ‘comment-reply’ ); ?>
<?php wp_head(); ?>
</head>

Meniuri de navigare (header.php)

Navigarea principală a temei ar trebui să suporte un meniu personalizat cu wp_nav_menu().
- Meniurile ar trebui să sprijine titluri de legătură lungi și o cantitate mare de elemente din listă. Aceste elemente nu trebuie să deranjeze design-ul sau aspectul.
- Articole din submeniu ar trebui să afișeze în mod corect. Dacă este posibil, să sprijine stilurile de meniu de derulare pentru elementele submeniu. Derulările permit să se vadă meniul în profunzime în loc să se vadă doar nivelul superior.

Piese (widget-uri) (sidebar.php)

Tema trebuie să fie widgetizată cât mai mult posibil. Orice zona din structură care funcționează ca un widget (nor de etichete, blogroll, lista de categorii) sau ar putea să accepte widgeturi (bara laterală) ar trebui să permită widgeturi.
Conținutul care apare în zonele widgetizate implicit (codare directă în bara laterală, de exemplu) ar trebui să dispară atunci când widgeturile sunt activate din Aspect > Piese.

Subsol (footer.php)

Utilizați apelul wp_footer(), pentru a apare chiar înainte de închiderea etichetei body.

<?php wp_footer(); ?>
</body>
</html>

Index (index.php)

Afișează o listă de postări în format extras sau complet. Selectați unul sau altul, după caz.
Include wp_link_pages() pentru a suporta linkuri de navigare în postări.

Arhiva (archive.php)

Afișează titlul arhivei (arhive în funcți de etichetă, categorie, dată, sau autor).
Afișează o listă de postări în format extras sau complet. Selectați unul sau altul, după caz.
Include wp_link_pages() pentru supot de linkuri sprijini de navigare în postări.

Pagini (page.php)

Afișează titlul paginii și conținutul paginii.
Afișează lista de comentarii și formularul de comentariu (cu excepția cazului când comentariile sunt dezactivate).
Include wp_link_pages() pentru a suporta linkuri de navigare într-o pagină.
Metadatele, cum ar fi etichetele, categoriile, datele și autorii, nu ar trebui să fie afișate .
Afișează un link „Edit” pentru utilizatorii autentificați cu permisiuni de editare.

Postare singulară (single.php)

Include wp_link_pages() pentru a suporta linkuri de navigare într-o postare.
Afișează titlul postării și conținutul postării.
- Titlul ar trebui să fie text curat în loc de link ce indica spre sine însuși.
Afișează data postării.
- Respectă setările formatelor de date și oră cu excepția cazului în care este important pentru proiectare altfel. (Setările utilizatorului pentru formatul de date ți oră sunt în panourile de administrare > Setări > Generale).
- Pentru rezultatele bazate pe setarea utilizatorului, folosiți the_time( get_option ( 'date_format' ) ).
Afișează numele autorului (dacă este cazul).
Arată categoriile și etichetele postării.
Afișează un link „Edit” pentru utilizatorii autentificați cu permisiuni de editare.
Afișează lista de comentarii și formularul de comentariu.
Arată linkurile de navigare pentru un către postarea anterioară și cea ulterioară utilizând previous_post_link() și next_post_link().

Comentarii (comments.php)

Comentariul autorului trebuie evidențiat în mod diferit.
Arată gravatare (avatare utilizator) dacă este cazul.
Suportă comentarii pe subiecte.
Arată trackback/pingback.
Acest fișier nu trebuie să conțină definiții de funcții, cu excepția cazului în care function_exist() caută eventualele erori de redeclarare. În mod ideal, toate funcțiile trebuie să fie în functions.php.

Rezultatele căutării (search.php)

Afișează o listă de postări în format extras sau complet. Selectați unul sau altul, după caz.
Pagina cu rezultatele căutării arată termenul de căutare care a generat rezultatele. Este un mod simplu, dar util, pentru a reaminti cuiva ce a căutat ultima dată – mai ales în cazul cu zero rezultate. Utilizați the_search_query() sau get_search_query() (afișare sau returnare valoare, respectiv). De exemplu:

<h3><?php
printf( __( ‘Rezultate căutare pentru: %s’ ), ‘<span>’ .
get_search_query() . ‘</span>’); ?></h3>

Este o bună practică aceea de a include formularul de căutare din nou pe pagina de rezultate.Se poate face cu: get_search_form().

JavaScript

Codil JavaScript trebuie să fie plasat în fișiere externe ori de câte ori este posibil.
Utilizați wp_enqueue_script() pentru a încărca scripturile.
JavaScript încărcat direct în documente HTML (fișiere șablon) ar trebui să fie codificat CDATA pentru a preveni erorile în browsere mai vechi.

Captura de ecran

Creați o captură de ecran pentru temă. Captura de ecran ar trebui să fie numită screenshot.png, și ar trebui să fie plasată în directorul de nivel superior. Captura de ecran ar trebui să arate cu exactitate design-ul temei și să fie salvată în format PNG. Dimensiunea recomandată a imaginii este de 880×660 px. Captura de ecran va fi afișată doar ca 387×290 px, dar imaginea mai mare decât dublu ca dimensiuni permite o înaltă rezoluție la vizualizarea pe ecrane HiDPI.

Rețineți că, eventual, .jpg, .jpeg, și .gif sunt, de asemenea extensii și formate de fișier valabile pentru imagine (deși nu sunt recomandate).

Personalizare temă

Temele pot suporta opțional Ecranul de Personalizare a Temei.

Atunci când este disponibil Ecranul de Personalizare a Temei pentru un rol de utilizator, utilizați capabilitatea de utilizator „edit_theme_options” în loc de „switch_themes” cu excepția cazului în care rolul de utilizator are permisiunea, de asemenea, să schimbe temele.

Dacă utilizați capabilitatea „edit_themes” oriunde în temă pentru a obține accesul rolului de Administrator la Ecranul de Personalizare a Temei (sau poate unele ecrane personalizate), să fiți conștienți de faptul că începând cu versiunea 3.0 această capabilitate nu este atribuită rolului de Administrator implicit în cazul instalării WordPress multisite. În acest caz, utilizați capabilitatea „edit_theme_options” dacă doriți ca adminstratorul să aibă acces la meniul „Personalizare” al temei.

Procesul de testare a temei

Repară erorile PHP și WordPress. Adaugă următoarea setare de depanare în fișierul wp-config.php pentru a vedea apeluri de funcții depreciate și alte erori legate de WordPress: define(‘WP_DEBUG’, true);.
Verifică fișierele șablon conform listei de verificare a fișierelor șablon (a se vedea mai sus).
Rulează utilizând Setul de Testare a Temei.
Validează HTML și CSS.
Verifică pentru erori JavaScript.
Testează în toate browserele țintă, precum IE9, Safari, Chrome, Opera, Firefox și Microsoft Edge.
Curăță toate comentarii fără legătură, setările de depanare, sau elementele TODO.
Vezi instrucțiunile WordPress pentru verificarea temei dacă o publici în directorul WordPress pentru teme.

Traducere din wordpress.org