Widget Lista taxonomiei

De cand am scris pentru prima oara pluginul Tag Dropdown Widget pe care se bazeaza acest plugin (in noiembrie 2009), WordPress a introdus taxonomii personalizate si, asa cum am discutat mai detaliat mai jos, a vazut ca un nou widget API il depaseste pe predecesorul sau. Ca parte a rescrierii legate de API-uri widget-uri, am extins pluginul pentru a sustine taxonomii personalizate neierarhice, ceea ce a necesitat un nou nume pentru plugin.

Cand am scris pentru prima data pluginul Tag Dropdown Widget, pe care l-am fortat ulterior pentru a crea pluginul Widget Lista de etichete, WordPress a fost in mijlocul unei modificari a modului de gestionare a widgeturilor. Am decis sa folosesc vechile metode de widget pentru a asigura cea mai mare compatibilitate la momentul respectiv. In cei aproape doi ani de cand am lansat prima versiune a acestui plugin, noul sistem widget a fost adoptat pe scara larga, punand acest plugin in dezavantaj. Asadar, am rescris pluginul pentru a utiliza noul API widget si am adaugat suport pentru taxonomii non-ierarhice, altele decat doar post tag-uri.

Dupa cum sa discutat mai sus, sistemul de widget-uri WordPress sa schimbat drastic de cand am lansat acest plugin pentru prima data. Pentru a facilita utilizarea multipla a aceluiasi widget, permitandu-le fiecaruia sa isi mentina propriul set de optiuni, modul de stocare a optiunilor widgetului s-a schimbat. Ca rezultat, nu exista o modalitate practica de tranzitie a optiunilor unui widget de la versiunea 0.3.1 la 1.0.

Introduceti functia <? Php if (function_exists (‘taxonomy_list_widget’)) ecou taxonomy_list_widget ($ args, $ id); ?> unde ar trebui sa apara lista, specificand $ args ca o serie de argumente si, optional, $ id ca un sir care identifica in mod unic aceasta lista.

• taxonomie – slug de taxonomie pentru lista. Implicit la post_tag.
• select_name – numele primei optiuni (implicite) din lista. Implicit pentru a selecta eticheta.
• max_name_length – numar intreg care reprezinta lungimea maxima a numelui termenului de afisat. Setati la 0 pentru a afisa numele complete. Valori implicite la 0.
• cutoff – sir care indica faptul ca un nume de termen a fost cutoff pe baza setarii max_name_length. Valorile implicite sunt elipse (& hellip;).
• limit – numar intreg care specifica numarul maxim de termeni de recuperat. Setati la 0 fara limita. Valori implicite la 0.
• orderby – fie nume pentru a comanda dupa numele termenului, fie numarati pentru a comanda dupa numarul de postari asociate termenului dat. Numele implicite.
• order – fie ASC pentru ordine crescatoare, fie DESC pentru ordine descendenta. Valori implicite la ASC.
• prag – numar intreg care specifica numarul minim de posturi carora trebuie sa li se atribuie un termen pentru a fi inclus in lista. Setati la 0 pentru moment prag. Valori implicite la 0.
• incexc – includeti sau excludeti pentru a include sau exclude termenii ale caror ID-uri sunt incluse in incexc_ids. In mod implicit, aceasta restrictie nu este activata.
• incexc_ids – lista separata de virgule a ID-urilor de termeni pentru a include sau exclude pe baza setarii incexc.
• hide_empty – setat la false pentru a include in lista orice termeni care nu au fost atribuiti niciunui obiect (adica etichete neutilizate). Valori implicite la true.
• post_counts – setat la true pentru a include numarul de posturi dupa numele termenilor. Implicit la false.
• delimitator – seteaza stilul listei. Optiunile native sunt ul, ol si nl pentru lista cu marcatori, lista numerotata si, respectiv, intreruperile de linie. Trecand o matrice cu chei before_list, after_list, before_item si after_item, puteti personaliza complet stilul listei.
• rel – fie dofollow, fie nofollow. Poate folosi in continuare filtrul taxonomy_list_widget_link_rel pentru a specifica relatia de legatura.

Versiunea 1.0 reprezinta o rescriere completa a pluginului original Tag List Widget. Ca parte a rescrierii, toate functiile anterioare pentru generarea listelor de etichete au fost invechite sau marcate ca invechite, deoarece nu pot accesa completul complet de caracteristici introduse in versiunea 1.0. Desi functiile inca exista, capacitatile lor sunt extrem de limitate si nu ar trebui inlocuite cu taxonomy_list_widget ().

ID-urile termenului pot fi obtinute intr-o varietate de moduri. Cel mai usor este sa vizitati editorul de termeni de taxonomie (Post Tag-uri, care se gaseste sub Postari, de exemplu) si, in timp ce plasati cursorul peste numele termenului, sa consultati bara de stare a browserului dvs. La sfarsitul adresei afisate in bara de stare, termenul ID va urma textul „tag_ID”.

De asemenea, puteti obtine ID-ul termenului facand clic pe linkul de editare de sub numele oricarui termen din pagina Post Tag-uri. Apoi, uita-te la bara de adrese a browserului tau. La sfarsitul adresei, termenul ID va urma textul „tag_ID”.

Acest plugin se bazeaza pe functia get_terms a lui WordPress (https://codex.wordpress.org/Function_Reference/get_terms). Pentru a modifica argumentele transmise acestei functii, utilizati filtrul taxonomy_list_widget_options pentru a specifica oricare dintre argumentele discutate in pagina Codex pentru get_terms.

Pentru a face posibila directionarea catre o anumita referinta de filtru, daca utilizati mai multe instante ale listei (widget-uri multiple, utilizarea functiei taxonomy_list_widget sau o combinatie a acestora), filtrul ofera un al doilea argument, $ id, care este fie ID-ul numeric al instanta widgetului sau sirul furnizat ca al doilea argument la taxonomy_list_widget.