Ghidul Tuts + pentru Șablon Etichete A opta lot

În cea de-a opta parte a seriei, am trecut prin cel de-al șaptelea lot de tag-uri șablon WordPress. În această nouă parte, vom trece prin ultimul lot din aproape 200 de etichete șablon. De-a lungul tutorialului, vom vedea etichete șablon despre marcaje și alte etichete șablon "diverse".

Avertizare privind marcajele: De la WordPress 3.5, "marcajele" sunt ascunse în mod implicit din panoul de administrare. Pentru a lucra cu marcaje, trebuie să instalați pluginul Link Manager.

Obținerea și afișarea unei liste de marcaje: wp_list_bookmarks ()

Această etichetă șablon returnează sau reflectă o listă de marcaje, o caracteristică veche a WordPress.

Parametrii

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

• $ args (Optional-array):
  O serie dintre următoarele argumente:
  • 'Orderby' (șir): cum se comandă marcajele. Acceptă "nume", "link_id", "url", "destinație", "descriere", "proprietar" (utilizatorul care a adăugat marcajul), "rating", "actualizat" "rss", "lungime" (lungimea numelui marcajului), "rand" (aleatoriu).
    (Implicit: "nume")
  • 'Ordin' (șir): să comandați articole în ordine ascendentă ("ASC") sau descendentă ("DESC").
    (Implicit: "ASC")
  • 'limită' (număr întreg): Numărul de elemente afișate.
    (Implicit: -1, care înseamnă toate marcajele)
  • 'categorie' (șir): ID-uri de categorie separate prin virgulă pentru a obține elemente de la.
    (Implicit: "ceea ce înseamnă toate categoriile)
  • 'Exclude_category' (șir): Categoriile de marcaje "ID-uri pentru a exclude.
    (Mod implicit:")
  • 'Numele categoriei' (șir): un nume de categorie pentru a afișa marcajele de la (categoria de suprascriere).
    (Mod implicit:")
  • 'Hide_invisible' (integer): dacă să ascundeți link-urile invizibile sau să le arătați.
    (Implicit: 1)
  • 'Show_updated' (intreg): Dacă ultimul timestamp actualizat trebuie afișat sau nu.
    (Implicit: 0)
  • 'ecou' (intreg): Fie pentru a ecou ieșirea (1), fie pentru ao returna (0).
    (Implicit: 1)
  • „Categorizați“ (număr întreg): dacă grupați marcajele după categoriile lor (1) sau nu (0).
    (Implicit: 1)
  • 'Title_li' (șir): Împachetează ieșirea cu a
  • eticheta și afișează un titlu înaintea listei de marcaje. Probabil doriți să setați acest lucru la un șir gol și să dezactivați împachetarea.
    (Implicit: "Marcaje")
  • 'Title_before' (șir): cod HTML care trebuie adăugat înaintea fiecărui titlu.
    (Mod implicit: '

    „)

  • 'Title_after' (șir): codul HTML pe care îl adăugați după fiecare titlu.
    (Mod implicit: '„)
  • 'clasă' (șir): nume de clase CSS care se adaugă la fiecare categorie.
    (Implicit: 'linkcat')
  • 'Category_before' (șir): codul HTML pe care îl adăugați înaintea fiecărei categorii.
    (Mod implicit: '
  • „)
  • 'Category_after' (șir): codul HTML pe care îl adăugați după fiecare categorie.
    (Mod implicit: '
  „)
  • 'Category_orderby' (șir): cum se comandă categoriile. Acceptă "numele", "id", "slug" și "contează".
    (Implicit: "nume")
  • 'Category_order' (șir): să ordoneze categoriile în ordine ascendentă ("ASC") sau descendentă ("DESC").
    (Implicit: "ASC")

folosire

 'rand', // Luați doar 5 marcaje. 'limit' => 5, // Luați marcaje dintr-o anumită categorie. 'category_name' => 'Friends', // Nu e ecou. 'echo' => 0, // clasa personalizată. 'class' => 'friends-bookmark-list'); $ bookmarks_list = wp_list_bookmarks ($ args); ?>

Obținerea unei matrice a tuturor marcajelor: get_bookmarks ()

Această etichetă șablon returnează o serie de marcaje WordPress.

Parametrii

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

• $ args (Optional-array):
  O serie dintre următoarele argumente:
  • 'Orderby' (șir): Cum să comandați linkurile. Acceptă câmpuri post, cum ar fi "nume", "ID", "titlu", "data" etc..
    (Implicit: "nume")
  • 'Ordin' (șir): să comandați articole în ordine ascendentă ("ASC") sau descendentă ("DESC").
    (Implicit: "ASC")
  • 'limită' (număr întreg): Numărul de elemente afișate.
    (Implicit: -1, ceea ce înseamnă tot)
  • 'categorie' (șir): ID-uri de categorie separate prin virgulă pentru a obține elemente de la.
    (Implicit: Gol)
  • 'Numele categoriei' (șir): numele categoriei pentru a obține elemente de la.
    (Implicit: Gol)
  • 'Hide_invisible' (integer sau boolean): dacă să se afișeze sau să se ascundă legăturile marcate ca "invizibile".
    (Mod implicit: 1 | TRUE)
  • 'Show_updated' (intreg sau boolean): Dacă se afișează ora la care a fost actualizat ultimul marcaj.
    (Mod implicit: 0 | FALSE)
  • 'include' (șir): lista de ID-uri separate de comenzi pentru a include.
    (Implicit: Gol)
  • 'exclude' (șir): lista de ID-uri separate pentru virgulă pentru a exclude.
    (Implicit: Gol)

folosire

 'titlu', 'comanda' => 'ASC', 'limit' => 15, 'hide_invisible' => false, 'exclude' => '12, 16,23 '); $ bookmarks_array = get_bookmarks ($ args); ?>

Obținerea datelor din marcaje: get_bookmark ()

Această etichetă șablon returnează toate datele unui marcaj dat.

Parametrii

Această etichetă șablon acceptă trei parametri:

• $ semn de carte (Necesar-mixt):
  ID-ul sau obiectul de carte.
  (Mod implicit: NUL)
• $ ieșire (Optional-string):
  Fie constanta OBJECT, ARRAY_N, fie ARRAY_A.
  (Mod implicit: OBIECT)
• filtru $ (Optional-string):
  Fie pentru a scăpa de ieșire sau nu. Dacă doriți să filtrați ieșirea, setați această opțiune la 'display'.
  (Implicit: "brut")

folosire

Obținerea datelor câmpului unui singur exemplar: get_bookmark_field ()

Această etichetă de șablon vă permite să preluați datele câmpului unui singur marcaj.

Parametrii

Această etichetă șablon acceptă trei parametri:

• câmp $ (Necesar string):
  Numele câmpului.
  (Mod implicit: NUL)
• $ semn de carte (Obligatoriu număr întreg):
  ID-ul marcajelor.
  (Mod implicit: NUL)
• $ context (Optional-string):
  Cum se filtrează valoarea câmpului - fie "raw", "edit", "atribut", "js", "db".
  (Implicit: "afișare")

folosire

Obținerea și afișarea linkului "Editați marcajul": get_edit_bookmark_link () & edit_bookmark_link ()

Aceste etichete șablon vă permit să obțineți sau să faceți ecou un link "editați acest marcaj" pentru a fi utilizat în șabloanele dvs..

Parametrii

get_edit_bookmark_link () acceptă un singur parametru:

• $ bookmark_id (Obligatoriu număr întreg):
  ID-ul marcajului.
  (Implicit: 0)

Și edit_bookmark_link () acceptă patru parametri:

• $ Text (Optional-string):
  Text pentru a afișa linkul.
  (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)
• $ bookmark_id (Obligatoriu număr întreg):
  ID-ul marcajului.
  (Mod implicit: NUL)

folosire

","'); // Afișați linkul "editați un marcaj" al unui anumit marcaj. edit_bookmark_link (__ ("Editare", "domeniu de traducere"), ",", 98); ?>

Obținerea și afișarea informațiilor despre site-ul dvs.: get_bloginfo () & bloginfo ()

Aceste etichete de șablon extrem de populare revin și afișează informațiile generale ale site-ului dvs..

Parametrii

get_ bloginfo () acceptă doi parametri:

• $ spectacol (Optional-string):
  Puțină informație de preluat. Una dintre următoarele valori:
  • 'Url' (șir): adresa URL de domiciliu.
  • 'Wpurl' (șir): URL-ul în care este instalat WordPress.
  • 'Descriere' (șir): Descrierea site-ului.
  • 'Rdf_url' (șir): URL-ul feedului RDF / RSS 1.0.
  • 'Rss_url' (șir): URL-ul feedului RSS 0.92.
  • 'Rss2_url' (șir): URL-ul feedului RSS 2.0.
  • 'Atom_url' (șir): Adresa URL a fluxului Atom.
  • 'Comments_rss2_url' (șir): URL-ul feedului RSS 2.0 pentru comentarii.
  • 'Comments_atom_url' (șir): Adresa URL a fluxului Atom pentru comentarii.
  • 'Pingback_url' (șir): Adresa URL a fișierului XML-RPC pingback.
  • 'Stylesheet_url' (șir): URL-ul principalului fișier CSS al temei.
  • 'Stylesheet_directory' (șir): Adresa URL a directorului principal al fișierului CSS al temei.
  • 'Template_directory' sau 'Template_url' (șir): adresa URL a directorului temei active.
  • 'ADMIN_EMAIL' (șir): adresa de e-mail introdusă când WordPress a fost instalat.
  • 'Charset' (șir): Setul de caractere al site-ului.
  • 'Html_type' (șir): Tipul de conținut al paginilor HTML WordPress.
  • 'versiune' (șir): versiunea WordPress.
  • 'limba' (șir): Limba instalării WordPress.
  • 'Text_direction' (șir): Direcția text a limbii.
  • 'Nume' (șir): Numele site-ului.
  (Implicit: "nume")
• filtru $ (Optional-string):
  Setați-l la 'filtru' pentru a filtra adresa URL returnată din această etichetă de șablon.
  (Implicit: "brut")

Și bloginfo () acceptă un singur parametru:

• $ spectacol (Optional-string):
  Aceleași detalii ca mai sus.
  (Implicit: 'blogname')

folosire

Obținerea și afișarea automată Clase: get_body_class () & body_class ()

Aceste etichete șablon foarte populare generează clase semantice și ne permite să le ecou sau să le returnez. De asemenea, ne permite să adăugăm nume suplimentare de clasă.

Parametrii

Ambele etichete șablon acceptă un singur parametru:

• clasa $ (șir opțional sau matrice):
  Se adaugă nume suplimentare de clase CSS.
  (Implicit: Gol)

folosire

Obținerea și afișarea unui meniu de navigare: wp_nav_menu ()

Această etichetă șablon revine sau afișează meniurile de navigare, o caracteristică principală a WordPress. Puteți vedea probabil această etichetă șablon - toate temele WordPress noi lansate în 2013 sau ulterior.

Parametrii

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

• $ args (Optional-array):
  O serie dintre următoarele argumente:
  • 'meniul' (șir): ID-ul, slug sau numele meniului.
    (Implicit: Gol)
  • 'Menu_class' (șir): clasa CSS a UL element al meniului.
    (Implicit: "meniu")
  • 'Menu_id' (șir): ID-ul codului UL element al meniului.
    (Implicit: meniu slug, incrementat)
  • 'Container' (șir): dacă să înfășurați UL, și ce să-l împachetezi.
    (Mod implicit: DIV)
  • 'Container_class' (șir): clasa CSS a elementului de înfășurare.
    (Implicit: 'meniu- menu slug -container')
  • 'Container_id' (șir): ID-ul elementului de înfășurare.
    (Implicit: Gol)
  • 'Fallback_cb' (callback sau boolean): Numele unei funcții de rezervă pentru a rula în cazul în care meniul nu există. Setați la falsă pentru a nu face rezervări.
    (Mod implicit: 'Wp_page_menu')
  • 'inainte de' (șir): Text înainte de textul linkului.
    (Implicit: Gol)
  • 'după' (șir): Text după textul linkului.
    (Implicit: Gol)
  • 'Link_before' (șir): Text înainte de link.
    (Implicit: Gol)
  • 'Link_after' (șir): Text după link.
    (Implicit: Gol)
  • 'ecou' (boolean): Dacă eticheta șablonului sau nu.
    (Mod implicit: ADEVĂRAT)
  • 'adâncime' (număr întreg): Câte nivele ale ierarhiei trebuie incluse.
    (Implicit: 0, ceea ce înseamnă toate nivelele)
  • 'Walker' (obiect): instanță a unei clase personalizate pentru walker.
    (Implicit: Gol)
  • 'Theme_location' (șir): locația temei care va fi utilizată. Trebuie să fie înregistrat cu register_nav_menu () pentru a putea fi selectat de către utilizator.
    (Implicit: Gol)
  • 'Items_wrap' (șir): modul în care ar trebui să fie înfășurate elementele din listă.
    (Mod implicit:
    % 3 $ s
    )

folosire

 'prim-nav', 'link_before' => '',' theme_location '=>' primar '); wp_nav_menu ($ args); ?>

Obținerea și afișarea titlurilor de pagini: wp_title ()

Această etichetă șablon revine sau reflectă titlul paginii paginilor dvs..

Parametrii

Această etichetă șablon acceptă trei parametri:

• $ sep (Optional-string):
  Textul folosit ca separator.
  (Mod implicit: '"')
• $ echo (Optional-boolean):
  Indiferent de ecou (ADEVĂRAT) sau retur (FALS) eticheta.
  (Mod implicit: ADEVĂRAT)
• $ seplocation (Optional-string):
  Poziția separatorului și direcția crocantă. Setați-l la "drept" pentru a inversa pescuitul.
  (Implicit: Gol)

folosire

Obținerea și afișarea adresei URL de pornire: get_home_url () & HOME_URL ()

Aceste etichete șablon returnează pur și simplu adresa URL de domiciliu.

Parametrii

get_home_url () acceptă trei parametri:

• $ blog_id (Opțional număr întreg):
  ID-ul blogului.
  (Mod implicit: NUL)
• calea de $ (Optional-string):
  Cale opțională pentru a adăuga la adresa URL.
  (Implicit: Gol)
• schema de $ (Optional-string):
  Schemă pentru a da contextul urlului de domiciliu ("http", "https" sau "relativă").
  (Mod implicit: NUL)

Și HOME_URL () acceptă doi parametri:

• calea de $ (Optional-string):
  Cale opțională pentru a adăuga la adresa URL.
  (Implicit: Gol)
• schema de $ (Optional-string):
  Schemă pentru a da contextul urlului de domiciliu ("http", "https" sau "relativă").
  (Mod implicit: NUL)

Nu confundați aceste două funcții, deoarece "o returnează ieșirea și o afișează" - știu că am făcut-o. Diferența este puțin ciudată: în timp ce get_home_url () revine funcția un URL de acasă al unui blog specific, HOME_URL () funcția returnează adresa URL de origine a site-ul curent. Amintiți-vă: nici unul dintre ei nu ecouri nimic!

folosire

Obținerea și afișarea adresei URL a site-ului: get_site_url () & Adresa paginii()

Aceste etichete șablon primesc și ecou "URL-ul site-ului", adresa unde este instalat WordPress.

Parametrii

get_site_url () acceptă trei parametri:

• $ blog_id (Opțional număr întreg):
  ID-ul blogului.
  (Implicit: site-ul curent)
• calea de $ (Optional-string):
  Cale opțională pentru a adăuga la adresa URL.
  (Implicit: Gol)
• schema de $ (Optional-string):
  Schemă pentru a da contextul urlului de domiciliu ("http", "https" sau "relativă").
  (Implicit: Conexiune normală sau securizată, în funcție de is_ssl ())

Și Adresa paginii() acceptă doi parametri:

• calea de $ (Optional-string):
  Cale opțională pentru a adăuga la adresa URL.
  (Implicit: Gol)
• schema de $ (Optional-string):
  Schemă pentru a da contextul urlului de domiciliu ("http", "https" sau "relativă").
  (Implicit: Conexiune normală sau securizată, în funcție de is_ssl ())

Ca și în cazul HOME_URL () și get_home_url (), nu confundați aceste două funcții, deoarece "o returnează ieșirea, iar cealaltă afișează". In timp ce get_site_url () revine funcția un URL specific site-ului unui blog, Adresa paginii() funcția returnează adresa URL a site-ului site-ul curent. Amintiți-vă: nici unul dintre ei nu ecouri nimic!

folosire

Obținerea codului actual al site-ului: get_current_blog_id ()

Această etichetă de șablon returnează pur și simplu ID-ul site-ului curent într-o rețea Multisite.

Parametrii

Această etichetă șablon nu acceptă parametri.

folosire

Obținerea și afișarea adresei URL a panoului de administrare: get_admin_url () & admin_url ()

Aceste etichete șablon revin și afișează o adresă URL a Tabloului de bord al site-ului dvs. web.

Parametrii

get_admin_url () acceptă trei parametri:

• $ blog_ID (Opțional număr întreg):
  ID-ul blogului.
  (Implicit: site-ul curent)
• calea de $ (Optional-string):
  Cale opțională pentru a adăuga la adresa URL.
  (Implicit: Gol)
• schema de $ (Optional-string):
  Schema de utilizat. "admin" respectă schema definită (cu is_ssl () funcția), dar puteți să o înlocuiți prin setarea acestui parametru. Acceptă "http", "https", "admin", "rpc", "login" și "login_post".
  (Implicit: 'admin')

Și admin_url () acceptă doi parametri:

• calea de $ (Optional-string):
  Cale opțională pentru a adăuga la adresa URL.
  (Implicit: Gol)
• schema de $ (Optional-string):
  Schema de utilizat. "admin" respectă schema definită (cu is_ssl () ), dar puteți să o înlocuiți prin setarea acestui parametru la "http" sau "https".
  (Implicit: 'admin')

folosire

Obținerea și afișarea unui articol despre un tip de feed: get_feed_link () & the_feed_link ()

Aceste etichete șablon returnă și emite permalink-ul unui feed.

Parametrii

get_feed_link () acceptă un singur parametru:

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

Și the_feed_link () acceptă doi parametri:

• $ ancora (Necesar string):
  Text de afișat pentru link.
  (Mod implicit: NUL)
• $ feed_type (Optional-string):
  Tipul feedului.
  (Implicit: tipul de alimentare implicit)

folosire

Efectuarea capătului de coardă cu sau fără limită de tragere: user_trailingslashit ()

Această etichetă șablon verifică structura dvs. permalink și adaugă o slash înclinată sau elimină slash-ul existent la sfârșitul adresei URL date.

Parametrii

Această etichetă șablon acceptă doi parametri:

• $ string (Necesar string):
  Adresa URL cu sau fără o slash înclinată.
  (Mod implicit: NUL)
• $ type_of_url (Depreciată-string):
  Asta nu este tehnic depreciat, dar nu este folosit în funcție, deci nu are niciun efect.

folosire

Obținerea numărului de zile de la începutul săptămânii: calendar_week_mod ()

Această etichetă șablon ciudat devine numărul de zile de la începutul săptămânii. Este practic o operație "modulo".

Sincer, nu știu cum să folosesc acest lucru sau De ce pentru a utiliza acest lucru. Dacă știți de ce există acest etichetă de șablon, trageți un comentariu pentru a-mi informa și cititorii!

Parametrii

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

• număr $ (Obligatoriu număr întreg):
  Zile de la începutul săptămânii.
  (Implicit: 0)

folosire

Obținerea și afișarea calendarului: get_calendar ()

Amintiți-vă acele calendare pe care le-am folosit în barele laterale ale blogurilor noastre? Această etichetă de șablon face exact acest lucru: Se întoarce sau afișează calendarul.

Parametrii

Această etichetă șablon acceptă doi parametri:

• $ inițială (Optional-boolean):
  Utilizați numele calendarului inițial (ADEVĂRAT) sau nu (FALS).
  (Mod implicit: ADEVĂRAT)
• $ echo (Optional-boolean):
  Indiferent de ecou (ADEVĂRAT) sau retur (FALS) ieșire.
  (Mod implicit: ADEVĂRAT)

folosire

Concluzie

Sper că ți-a plăcut acest ultim set de etichete șablon. În următoarea parte, finala seriei, vom revizui ceea ce am învățat și vom încheia seria.

Dacă aveți întrebări, comentarii sau corecții, vă puteți împărtăși gândurile cu noi în secțiunea Comentarii. Și dacă ți-a plăcut articolul, nu uita să îl împarți cu prietenii tăi!