Ghidul Tuts + pentru șablon Etichete Al doilea lot

În cea de-a doua parte a seriei, am trecut prin primul eșantion de șabloane WordPress. În această a treia parte, vom trece prin cel de-al doilea lot de aproape 200 de etichete șablon. De-a lungul tutorialului, vom vedea etichete șablon cu privire la taxonomii și termeni.

Descrierea unei categorii: category_description ()

Această etichetă șablon returnează descrierea unei categorii.

Parametrii

Această etichetă șablon acceptă un singur parametru:

  • $ cATEGORY_ID (Opțional număr întreg):
    ID-ul categoriei.
    (Implicit: categoria interogată)

folosire

Descrierea unei etichete: tag_description ()

Această etichetă șablon returnează descrierea unei etichete.

Parametrii

Această etichetă șablon acceptă un singur parametru:

  • $ tag_ID (Opțional număr întreg):
    ID-ul etichetei.
    (Implicit: Etichetă curentă)

folosire

Obținerea descrierii unui termen: term_description ()

Această etichetă șablon returnează pur și simplu descrierea unui termen.

Parametrii

Această etichetă șablon acceptă doi parametri:

  • $ term_ID (Opțional număr întreg):
    ID-ul termenului.
    (Implicit: Termen actual)
  • $ taxonomie (Optional-string):
    Taxonomia termenului.
    (Implicit: 'post_tag')

folosire

Obținerea și afișarea unui titlu de pagină pentru arhiva categoriei: single_cat_title ()

Această etichetă șablon revine și afișează titlul categoriei pentru utilizarea în titlurile paginilor.

Parametrii

Această etichetă șablon acceptă doi parametri:

  • $ prefix (Optional-string):
    Prefixul titlului.
    (Implicit: Gol)
  • $ echo (Optional-boolean):
    Fie ecou (ADEVĂRAT) sau retur (FALS) eticheta.
    (Mod implicit: ADEVĂRAT)

folosire

Obținerea și afișarea unui titlu de pagină pentru arhivele de etichete: single_tag_title ()

Această etichetă șablon revine și afișează titlul etichetei pentru utilizarea în titlurile paginilor.

Parametrii

Această etichetă șablon acceptă doi parametri:

  • $ prefix (Optional-string):
    Prefixul titlului.
    (Implicit: Gol)
  • $ echo (Optional-boolean):
    Fie ecou (ADEVĂRAT) sau retur (FALS) eticheta.
    (Mod implicit: ADEVĂRAT)

folosire

Obținerea și afișarea unui titlu al paginii pentru termenii Arhive: single_term_title ()

Această etichetă șablon revine și afișează titlul termenului pentru utilizarea în titlurile paginilor.

Parametrii

Această etichetă șablon acceptă doi parametri:

  • $ prefix (Optional-string):
    Prefixul titlului.
    (Implicit: Gol)
  • $ echo (Optional-boolean):
    Fie ecou (ADEVĂRAT) sau retur (FALS) eticheta.
    (Mod implicit: ADEVĂRAT)

folosire

Obținerea și afișarea categoriilor postării: get_the_category_list () & the_category ()

Aceste etichete șablon preluate și de ieșire categoriile care sunt atribuite postului.

Parametrii

Ambele etichete șablon acceptă trei parametri:

  • $ separator (Optional-string):
    Text separator.
    (Implicit: Gol - dacă acest parametru este gol, funcțiile vor reveni și vor afișa o listă neordonată de categorii)
  • $ parinti (Optional-string):
    Cum se afișează categoriile părinte ("multiple", "singure" sau goale).
    (Implicit: Gol)
  • $ POST_ID (Opțional număr întreg):
    Codul postului.
    (Implicit: post curent)

folosire

Obținerea și afișarea categoriilor postării pentru fluxuri: get_the_category_rss () & the_category_rss ()

Aceste etichete șablon fac ca categoriile atribuite postării să fie pregătite pentru fluxuri și să le returneze sau să le afișeze.

Parametrii

Ambele etichete șablon acceptă un singur parametru:

  • $ feed_type (Optional-string):
    Tipul feedului.
    (Implicit: tipul de alimentare implicit)

folosire

Obținerea și afișarea etichetelor unui mesaj: get_the_tag_list () & the_tags ()

Aceste etichete șablon returnează sau afișează etichetele postărilor dvs..

Parametrii

Ambele etichete șablon acceptă trei parametri:

  • $ înainte (Optional-string):
    Textul sau codul HTML care trebuie afișat înainte de ieșire.
    (Implicit: Goliți pentru get_the_tag_list () și "Etichete:" pentru the_tags ())
  • $ sep (Optional-string):
    Textul folosit ca separator.
    (Implicit: Goliți pentru get_the_tag_list () si pentru the_tags ())
  • $ după (Optional-string):
    Textul sau codul HTML afișat după ieșire.
    (Implicit: Gol)

folosire

". __ ("Tag-uri:", "domeniu de traducere"), · ","
'); ?>

Obținerea și afișarea termenilor unui mesaj: get_the_term_list () & termenii()

Aceste etichete șablon primesc și ecou o listă de termeni alocați postării.

Parametrii

Ambele etichete șablon acceptă cinci parametri:

  • $ POST_ID (Opțional număr întreg):
    Codul postului.
    (Implicit: post curent)
  • $ taxonomie (Necesar string):
    Taxonomie pentru afișarea termenilor.
    (Implicit: Gol)
  • $ înainte (Optional-string):
    Textul sau codul HTML care trebuie afișat înainte de ieșire.
    (Implicit: Gol)
  • $ sep (Optional-string):
    Text separator.
    (Mod implicit: ', ')
  • $ după (Optional-string):
    Textul sau codul HTML afișat după ieșire.
    (Implicit: Gol)

folosire

ID, "mărci disponibile"); // Afișați termenii postării curente de la taxonomia "Brand-uri disponibile" cu unele personalizări. the_terms ($ post-> ID, 'available-brands', __ ('Brands disponibile:', 'domain-translation'), '-'); ?>

Afișarea taxonomiilor unui mesaj: the_taxonomies ()

Această etichetă de șablon afișează taxonomiile și termenii asociați taxonomiilor respective.

Parametrii

Această etichetă șablon acceptă un singur parametru:

  • $ args (Optional-array):
    O serie dintre următoarele argumente:
    • 'post' (număr întreg): ID-ul postului.
      (Implicit: 0)
    • 'inainte de' (șir): codul HTML de adăugat înainte de ieșire.
      (Implicit: Gol)
    • 'Sep' (șir): Text separator.
      (Mod implicit:")
    • 'după' (șir): cod HTML care trebuie adăugat după ieșire.
      (Implicit: Gol)
    • „Șablon“ (șir): șablonul de utilizat pentru afișarea termenilor de taxonomie.
      (Implicit: '% s:% l.' Unde % s este eticheta de taxonomie și % t este lista de link-uri de termeni)

folosire

 '
',' sep '=>', ',' după '=>'
'); the_taxonomies ($ args); ?>

Obținerea și afișarea linkului "Editați eticheta": get_edit_tag_link () & edit_tag_link ()

Aceste etichete de șabloane returnează sau ecou un link "editați această etichetă" pentru a fi utilizat în șabloanele dvs..

Parametrii

get_edit_tag_link () acceptă doi parametri:

  • $ tag_ID (Obligatoriu număr întreg):
    ID-ul etichetei.
    (Mod implicit: NUL)
  • $ taxonomie (Optional-string):
    Tipologia taxonomiei.
    (Implicit: 'post_tag')

Și edit_tag_link () acceptă patru parametri:

  • $ link- (Optional-string):
    Text de afișat pentru link.
    (Implicit: 'Editează acest lucru')
  • $ înainte (Optional-string):
    Textul sau codul HTML care trebuie afișat înainte de ieșire.
    (Implicit: Gol)
  • $ după (Optional-string):
    Textul sau codul HTML afișat după ieșire.
    (Implicit: Gol)
  • $ tag-ul (Necesar obiect):
    Obiect tag.
    (Mod implicit: NUL)

folosire

","'); // Afișarea linkului "Etichetă de editare" a unei anumite etichete. edit_tag_link (__ ("Editare", "domeniu de traducere"), ",", 11); ?>

Obținerea și afișarea listei de categorii: wp_list_categories ()

Această etichetă șablon returnează sau afișează o listă de categorii sau termeni din orice tip de taxonomie.

Parametrii

Această etichetă șablon acceptă un singur parametru:

  • $ args (Optional-array):
    O serie dintre următoarele argumente:
    • 'Show_option_all' (șir): Afișează un link către domiciliu (sau pagina "Postări" setată în Setări> Citire) dacă ați setat-o ​​la o valoare ne-gol. Valoarea va fi textul de ancorare al linkului.
      (Implicit: Gol)
    • 'Show_option_none' (șir): Text pentru a afișa dacă nu există categorii.
      (Implicit: "Nu există categorii")
    • 'Orderby' (șir): Cum să comandați linkurile prin. Acceptă "numele", "ID", "slug", "count" și "term_group".
      (Implicit: "nume")
    • 'Ordin' (șir): să comandați articole în ordine ascendentă ("ASC") sau descendentă ("DESC").
      (Implicit: "ASC")
    • 'stil' (șir): Stil pentru afișarea categoriilor -'list 'pentru a genera o listă neordonată sau' none 'pentru a genera o listă de linkuri separate cu
      s.
      (Implicit: 'list')
    • 'SHOW_COUNT' (număr întreg): Afișați numărul postărilor de lângă linkul pentru fiecare categorie.
      (Implicit: 0)
    • 'Hide_empty' (întreg): Ascundeți categoriile goale sau nu.
      (Implicit: 1)
    • 'Use_desc_for_title' (integer): Utilizați descrierile ca atribute "titlu" ale legăturilor.
      (Implicit: 1)
    • 'Child_of' (număr întreg): Afișează numai copiii unui ID dat dintr-o categorie.
      (Implicit: 0)
    • 'a hrani' (șir): dacă este setată la orice valoare neuniformă, link-urile de categorie de feed vor apărea lângă link-uri de categorie. Valoarea va fi textul ancoră al legăturilor.
      (Implicit: Gol)
    • 'Feed_type' (șir): Tipul hranei pentru animale ("rss", "rss2", "atom" sau "rdf").
      (Implicit: Gol)
    • 'Feed_image' (șir): Calea imaginii pentru a înlocui textul de ancorare și pentru a afișa o imagine în schimb.
      (Implicit: Gol)
    • 'exclude' (șir): Listă de coduri separate pentru categorii de categorii pentru a exclude.
      (Implicit: Gol)
    • 'Exclude_tree' (șir): Aceeași ca "excludeți", dar trebuie să o utilizați dacă argumentul "ierarhic" este setat la 1
      (Implicit: Gol)
    • 'Current_category' (integer): adaugă o clasă "curent-pisică" atunci când este potrivit.
      (Implicit: 0)
    • 'ierarhic' (integer): Afișați elementele cu ordine ierarhică sau nu.
      (Implicit: 1)
    • 'Title_li' (șir): Împachetează ieșirea cu a
    • eticheta și afișează un titlu înaintea listei de categorii. Probabil doriți să setați acest lucru la un șir gol și să dezactivați împachetarea.
      (Implicit: "Categorii")
    • 'ecou' (intreg): Fie pentru a ecou ieșirea (1), fie pentru ao returna (0).
      (Implicit: 1)
    • 'adâncime' (întreg): adâncimea maximă.
      (Implicit: 0)
    • „Taxonomie“ (șir): Taxonomie la listă.
      (Implicit: "categorie")

folosire

 __ ("Toate postările", "domeniul de traducere"), // Ordonează după numărul postărilor. 'orderby' => 'count', // Afișați numărul postărilor. 'show_count' => 1, // Afișați link-uri pentru feed. 'feed' => 'Feed', // Eliminați title_li. 'title_li' => "); wp_list_categories ($ args);?>

Obținerea și afișarea unei coborâri HTML a categoriilor: wp_dropdown_categories ()

Această etichetă șablon returnează sau reflectă un meniu derulant (