Ghidul Tuts + pentru șablon Etichete A patra lot

În cea de-a patra parte a seriei, am trecut prin cel de-al treilea lot de tag-uri șablon WordPress. În această a cincea parte, vom trece prin cel de-al patrulea lot de aproape 200 de etichete șablon. De-a lungul tutorialului, vom vedea etichetele șablonului despre comentarii din nou, la fel ca lotul anterior.

Obținerea și afișarea unui link către secțiunea "Comentarii": get_comments_link () & comments_link ()

Aceste etichete șablon revin și afișează linkul la secțiunea "Comentarii" a postării.

Parametrii

comments_link () nu acceptă nici un parametru, dar get_comments_link () acceptă una:

• $ POST_ID (opțional - întreg sau obiect):
  Codul postului.
  (Implicit: post curent)

folosire

Obținerea și afișarea listei de comentarii: wp_list_comments ()

Această etichetă populară de șablo listează comentariile trimise într-o postare.

Parametrii

Această etichetă șablon acceptă doi parametri:

• $ args (Optional-array):
  O serie dintre următoarele argumente:
  • 'Walker' (obiect): Instanța unei clase Walker pentru a lista comentariile.
    (Mod implicit: NUL)
  • 'adancime maxima' (intreg): adâncimea maximă a comentariilor.
    (Implicit: Gol)
  • 'stil' (șir): Stilul de ordine a listei ("ul" sau "ol").
    (Implicit: 'ul')
  • 'suna inapoi' (șir): funcția Callback pentru a fi utilizată.
    (Mod implicit: NUL)
  • 'End-apel invers' (șir): funcția de returnare a apelurilor pentru a fi utilizată la sfârșit.
    (Mod implicit: NUL)
  • 'tip' (șir): Tipul de comentarii în listă ("toate," comentariu "," pingback "," trackback "sau" pings ").
    (Implicit: "toate")
  • 'pagină' (număr întreg): Codul paginii pentru a lista comentariile pentru.
    (Implicit: Gol)
  • 'per pagină' (număr întreg): Numărul de comentarii pe listă pe pagină.
    (Implicit: Gol)
  • 'Avatar_size' (intreg): Dimensiunile imaginilor avatar.
    (Implicit: 32)
  • 'Reverse_top_level' (șir): Ordonarea comentariilor afișate ("desc" sau "asc").
    (Mod implicit: NUL)
  • 'Reverse_children' (boolean): Dacă doriți să inversați comentariile copilului din listă.
    (Implicit: Gol)
  • 'format' (șir): Cum se formatează lista de comentarii.
    (Implicit: 'html5' dacă tema acceptă marcajul HTML5, altfel 'xhtml')
  • 'Short_ping' (boolean): Fie pentru a trimite ping-uri scurte.
    (Mod implicit: FALS)
  • 'ecou' (boolean): dacă să ecou ieșirea (ADEVĂRAT) sau returnați-o (FALS).
    (Mod implicit: ADEVĂRAT)
• $ comentarii (Optional-array):
  Array de obiecte de comentariu.
  (Implicit: Toate comentariile pentru postarea curentă)

folosire

 'ol', // Obțineți comentarii numai. 'type' => 'comments', // Numărul de comentarii personalizate per pagină. 'per_page' => 15, // Reduceți dimensiunea avatarului. 'avatar_size' => 16, // Force utilizează marcajul HTML5. 'format' => 'html5', // Returnați ieșirea în loc de ecou. 'echo' => 0); $ comments_list = wp_list_comments ($ args); ?>

Obținerea și afișarea numărului de comentarii: get_comments_number () & comments_number ()

Aceste etichete șablon obține și afișa câte comentarii sunt postate la postare.

Parametrii

get_comments_number () acceptă un singur parametru:

• $ POST_ID (opțional - întreg sau obiect):
  Codul postului.
  (Implicit: post curent)

Și comments_number () acceptă trei parametri:

• $ zero, (Optional-string):
  Textul afișat dacă nu există comentarii.
  (Implicit: 'No Comments')
• $-unul (Optional-string):
  Textul de afișat dacă există doar un singur comentariu.
  (Implicit: '1 Comentariu')
• $ mai mult (Optional-string):
  Text pentru a fi afișat dacă există mai mult de un comentariu.
  (Implicit: '% Comentarii')

folosire

Obținerea și afișarea de clase automate pentru fiecare comentariu: get_comment_class () & comment_class ()

Aceste etichete șablon vă permit să adăugați clase semantice generate unde doriți în buclă de comentarii.

Parametrii

get_comment_class () acceptă trei parametri:

• clasa $ (șir opțional sau matrice):
  Nume de clasă suplimentare pe care să le adăugați.
  (Implicit: Gol)
• $ comment_ID (Opțional număr întreg):
  ID-ul comentariului cu care să lucrați.
  (Implicit: ID-ul comentariului curent)
• $ POST_ID (opțional - întreg sau obiect):
  Codul postului.
  (Implicit: post curent)

Și comment_class () acceptă patru parametri:

• clasa $ (șir opțional sau matrice):
  Nume de clasă suplimentare pe care să le adăugați.
  (Implicit: Gol)
• $ comment_ID (Opțional număr întreg):
  ID-ul comentariului cu care să lucrați.
  (Implicit: ID-ul comentariului curent)
• $ POST_ID (opțional - întreg sau obiect):
  Codul postului.
  (Implicit: post curent)
• $ echo (Optional-boolean):
  Fie ecou (ADEVĂRAT) sau retur (FALS) eticheta.
  (Mod implicit: ADEVĂRAT)

folosire

Afișarea formularului de comentariu: comment_form ()

Această etichetă șablon afișează întregul formular de comentariu.

Parametrii

Această etichetă șablon acceptă doi parametri:

• $ args (Optional-array):
  O serie dintre următoarele argumente:
  • 'câmpuri' (array): o matrice asociativă de coduri HTML implicite ("autor", "email" și "url").
    (Implicit: Toate cele trei)
  • 'Comment_field' (șir): codul HTML al comentariului TEXTAREA element.
  • 'Must_log_in' (șir): cod HTML pentru mesajul "trebuie să vă conectați pentru a comenta".
  • 'Conectat ca' (șir): cod HTML pentru mesajul "conectat ca ...". (Utilizare % 1 $ s pentru adresa URL a profilului, % 2 $ s pentru numele de utilizator și % 3 $ s pentru URL-ul de jurnalizare.)
  • 'Comment_notes_before' (șir): cod HTML pentru notele afișate înainte de formularul de comentarii.
  • 'Comment_notes_after' (șir): cod HTML pentru notele afișate după formularul de comentarii.
  • 'Id_form' (șir): ID-ul formularului de comentarii FORMĂ element.
  • 'Id_submit' (șir): ID-ul butonului de trimitere.
  • 'Name_submit' (șir): NUME parametru al butonului de trimitere.
  • 'Title_reply' (șir): Etichetă pentru butonul "Lăsați un răspuns".
  • 'Title_reply_to' (șir): Etichetă pentru butonul "Lăsați un răspuns la% s".
  • 'Cancel_reply_link' (șir): Textul linkului "Anulați răspunsul".
  • 'Label_submit' (șir): Etichetă pentru butonul "Postare comentariu".
  • 'format' (șir): Formatul formularului de comentariu ("xhtml" sau "html5", implicit este "xhtml").
• $ POST_ID (opțional - întreg sau obiect):
  Codul postului.
  (Implicit: post curent)

folosire

 array ('autor', 'email'), 'must_log_in' => __ ('Trebuie să fiți un utilizator conectat pentru a putea comenta'), 'translation_domain', 'label_submit' => "Trageți-l", "domeniu de traducere"), "format" => "html5"); comment_form ($ args); ?>

Afișarea unui titlu pentru formularul de comentarii: comment_form_title ()

Această etichetă șablon reflectă un titlu dinamic pentru formularul de comentarii.

Parametrii

Această etichetă șablon acceptă trei parametri:

• $ noreplytext (Optional-string):
  Textul linkului, dacă nu este un link "răspundeți la comentariu".
  (Implicit: "Lasă un răspuns")
• $ replytext (Optional-string):
  Textul linkului dacă este un link "răspundeți la comentariu".
  (Implicit: "Lăsați un răspuns la% s")
• $ linktoparent (Optional-boolean):
  Indiferent dacă se leagă numele comentatorului de comentariul său sau nu.
  (Mod implicit: ADEVĂRAT)

folosire

Obținerea și afișarea linkului "Răspundeți la comentariu": get_comment_reply_link () & comment_reply_link ()

Aceste etichete șablon vă permit să returnați sau să afișați un link de răspuns pentru comentariul dat.

Parametrii

Ambele etichete șablon acceptă trei parametri:

• $ args (Optional-array):
  O serie dintre următoarele argumente:
  • 'Add_below' (șir): prima parte a selectorului folosit pentru a identifica comentariul pentru a răspunde mai jos. Valoarea rezultată este trecută ca primul parametru pentru a adăugaComment.moveForm (), concatenat ca $ add_below- $ comment-> comment_ID.
    (Implicit: "comentariu")
  • 'Respond_id' (șir): Selectorul care identifică comentariul care răspunde. A trecut ca al treilea parametru pentru a adăugaComment.moveForm () și a fost adăugat la adresa URL a link-ului ca valoare hash.
    (Implicit: "răspunde")
  • 'REPLY_TEXT' (șir): Textul linkului "Răspundeți".
    (Implicit: 'Răspunde')
  • 'Login_text' (șir): Textul linkului pentru a răspunde dacă este deconectat.
    (Implicit: 'Conectați-vă la răspuns')
  • 'adâncime' (intreg): Adâncimea noului comentariu - trebuie să fie mai mare de 0 și mai mică decât valoarea opțiunii 'thread_comments_depth' setată în Setări> Discuție.
    (Implicit: 0)
  • 'inainte de' (șir): codul HTML de adăugat înainte de ieșire.
    (Implicit: Gol)
  • 'după' (șir): cod HTML care trebuie adăugat după ieșire.
    (Implicit: Gol)
• $ comment_ID (Opțional număr întreg):
  ID-ul comentariului cu care să lucrați.
  (Implicit: ID-ul comentariului curent)
• $ POST_ID (opțional - întreg sau obiect):
  Codul postului.
  (Implicit: post curent)

folosire

 __ ('Conectați-vă la Shout Back', 'translation-domain'), 'after' => '
'); $ comment_reply_link = get_comment_reply_link ($ args); ?>

Obținerea și afișarea câmpurilor ascunse ale formularului "Răspundeți la comentariu": get_comment_id_fields () & comment_id_fields ()

Aceste etichete șablon ecou sau returnează ascunse și obligatorii intrare câmpurile unui link "răspundeți la comentariu".

Parametrii

Ambele etichete șablon acceptă un singur parametru:

• $ POST_ID (Opțional număr întreg):
  Codul postului.
  (Implicit: ID-ul postului curent)

folosire

Obținerea și afișarea linkului "Anulați răspunsul": get_cancel_comment_reply_link () & cancel_comment_reply_link ()

Aceste etichete șablon returnează sau ecou un link "Anulare răspuns" pentru a fi utilizat cu formularul de răspuns pentru comentarii.

Parametrii

Ambele etichete șablon acceptă un singur parametru:

• $ Text (Optional-string):
  Text pentru a fi afișat ca link "anula răspuns".
  (Implicit: "Faceți clic aici pentru a anula răspunsul.")

folosire

Obținerea și afișarea linkului pentru "Următoarele comentarii": get_next_comments_link () & next_comments_link ()

Aceste etichete șablon returnează sau tipăresc link-ul "următorii comentarii" în secțiunea Comentarii a temei.

Parametrii

Ambele etichete șablon acceptă doi parametri:

• etichetă $ (Optional-string):
  Text de afișat pentru link.
  (Implicit: "Comentarii mai noi" ')
• $ MAX_PAGE (Opțional număr întreg):
  Numărul maxim al paginii.
  (Implicit: 0)

folosire

Obținerea și afișarea linkului pentru "Comentarii anterioare": get_previous_comments_link () & previous_comments_link ()

Aceste etichete șablon returnează sau imprimă linkul "comentarii anterioare" în secțiunea Comentarii a temei.

Parametrii

Ambele etichete șablon acceptă un singur parametru:

• etichetă $ (Optional-string):
  Text de afișat pentru link.
  (Implicit: '«Comentarii mai vechi»)

folosire

Obținerea de linkuri de paginare pentru comentarii: paginate_comments_links ()

Această etichetă șablon returnează legăturile de paginare pentru secțiunea Comentariile temei.

Parametrii

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

• $ args (Optional-array):
  O serie dintre următoarele argumente:
  • 'baza' (șir): URL-ul de bază care va fi utilizat pentru a crea legături paginate.
  • 'format' (șir): Argumentul utilizat pentru înlocuirea numărului paginii.
  • 'total' (număr întreg): Numărul total de pagini.
  • 'actual' (număr întreg): Numărul paginii curente.
  • 'ecou' (boolean): Dacă eticheta șablonului sau nu.
    (Mod implicit: ADEVĂRAT)
  • 'Add_fragment' (șir): Text pentru a prefixa adresele URL ale paginii.
    (Implicit: '#comments')

folosire

 false, 'add_fragment' => "); $ comment_pagination = paginate_comments_links ($ args);?>

Obținerea și afișarea linkului "Editați comentariul": get_edit_comment_link () & edit_comment_link ()

Aceste etichete de șabloane returnează sau ecou un link "editați acest comentariu" pentru a le utiliza în șabloanele dvs..

Parametrii

get_edit_comment_link () acceptă un parametru:

• $ comment_ID (Opțional număr întreg):
  ID-ul comentariului cu care să lucrați.
  (Implicit: ID-ul comentariului curent)

Și edit_comment_link () acceptă trei 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)

folosire

","'); ?>

Obținerea și afișarea linkului "Feed Feed": get_post_comments_feed_link () & post_comments_feed_link ()

Aceste etichete șablon revin sau afișează un link pentru fluxul de comentarii.

Parametrii

get_post_comments_feed_link () acceptă doi parametri:

• $ POST_ID (Opțional număr întreg):
  Codul postului.
  (Implicit: post curent)
• $ hrana pentru animale (Optional-string):
  Tipul feedului.
  (Implicit: tipul de alimentare implicit)

Și post_comments_feed_link () acceptă trei parametri:

• $ LINK_TEXT (Optional-string):
  Text de afișat pentru link.
  (Implicit: "Feed Feed")
• $ POST_ID (Opțional număr întreg):
  Codul postului.
  (Implicit: post curent)
• $ hrana pentru animale (Optional-string):
  Tipul feedului.
  (Implicit: tipul de alimentare implicit)

folosire

ID, "atom"); // Afișează link-ul "comentarii" al postării pentru feedul implicit. post_comments_feed_link (); ?>

Afișarea unei linkuri a pop-up-ului "Comentarii": comments_popup_link ()

Această etichetă șablon afișează o legătură a ferestrei populare "Comentarii", în cazul în care doriți să utilizați link-uri pop-up în listele postale.

Parametrii

Această etichetă șablon acceptă cinci parametri:

• $ zero, (Optional-string):
  Textul afișat dacă nu există comentarii.
  (Implicit: 'No Comments')
• $-unul (Optional-string):
  Textul de afișat dacă există doar un singur comentariu.
  (Implicit: '1 Comentariu')
• $ mai mult (Optional-string):
  Text pentru a fi afișat dacă există mai mult de un comentariu.
  (Implicit: '% Comentarii')
• $ css_class (Optional-string):
  Se adaugă nume suplimentare de clase CSS.
  (Implicit: Gol)
• $ none (Optional-string):
  Textul afișat dacă comentariile sunt dezactivate.
  (Implicit: "Comentarii dezactivate")

folosire

Afișarea Scriptului popup "Comentarii": comments_popup_script ()

Această etichetă șablon construiește și imprimă script-ul de pe ecranul "Comentarii".

Parametrii

Această etichetă șablon acceptă trei parametri:

• $ lățime (Opțional număr întreg):
  Lățimea ferestrei pop-up.
  (Implicit: 400)
• $ înălțime (Opțional număr întreg):
  Înălțimea ferestrei pop-up.
  (Implicit: 400)
• fișier $ (Optional-string):
  Adresa URL care se afișează pe bara de adrese a pop-up-ului.
  (Implicit: Adresa URL de pornire)

folosire

Concluzie

Sper că ți-a plăcut acest al patrulea set de etichete șablon. Există încă patru loturi pentru a merge, deci stați la acord pentru mai multe etichete șablon!

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!