Bloginfo: Informaţii despre WP


Săptămâna trecută am citit cu mare interes un articol în limba germană al lui Vladimir Simovic alias Perun despre prezentarea informaţiilor despre WordPress în site-ul propriu. După un scurt schimb de email-uri el mi-a permis preluarea conţinutului articolului amintit (în traducere liberă). De regulă cei care utilizează WordPress în realizarea de site-uri web cunosc toate informaţiile despre propriul lor site, acestea fiind vizualizate în backend-ul instalaţiei. Însă deseori este de folos oferirea acestor informaţii şi în frontend, deci în partea vizibilă tuturor vizitatorilor. Pentru aceasta se poate apela la tag-ul bloginfo(); care, preluat într-un apel PHP de genul <?php bloginfo(‘description’); ?> permite inserarea descrierii site-ului de ex. într-un fişier al temei curente, precum single.php sau index.php.

imagine

Parametrul description din parantezele de mai sus nu este singurul suportat, existând în momentul actual alţi 21 de parametri. Îi enumăr în continuare pe toţi alături de o simplă explicaţie:

  • admin_email = adresa email a administratorului
  • atom_url = adresa url a feedului Atom, de ex. http://www.domeniuldvs.ro/feed/atom
  • charset = encoding-ul suportat, de ex. UTF-8
  • comments_atom_url = adresa fluxului RSS pentru comentarii în format Atom: http://www.domeniuldvs.ro/comments/feed/atom
  • comments_rss2_url = adresa fluxului RSS pentru comentarii în format RSS 2.0: http://www.domeniuldvs.ro/comments/feed
  • description = descrierea, subtitlul site-ului
  • url = pagina de start, de ex. http://www.domeniuldvs.ro
  • html_type = tipul documentului, cel mai adesea text/html
  • language = limba blogului, de ex. ro-RO
  • name = numele site-ului, de fapt titlul principal
  • pingback_url = adresa url al fişierului xmlrpc, care preia între altele pingbackurile şi permite contactul cu editori externi, un exemplu: http://www.domeniuldvs.ro/xmlrpc.php
  • rdf_url = adresa fluxului RSS în format RSS 1.0, de ex. http://www.domeniuldvs.ro/feed/rdf
  • rss2_url = adresa url a fluxului RSS în format RSS 2.0, de ex. http://www.domeniuldvs.ro/feed
  • rss_url = adresa fluxului RSS în format RSS 0.92, de ex. http://www.domeniuldvs.ro/feed/rss
  • siteurl = pagina de start, de ex. http://www.domeniuldvs.ro; de fapt identic cu parametrul url
  • stylesheet_directory = adresa directorului temei active, de ex. http://www.domeniuldvs.ro/wp-content/themes/default
  • stylesheet_url = adresa fişierului css, de ex. http://www.domeniuldvs.ro/wp-content/themes/default/style.css
  • template_directory = adresa directorului temei active, de ex. http://www.domeniuldvs.ro/wp-content/themes/default; de fapt identic cu parametrul stylesheet_directory
  • template_url = adresa directorului temei active, de ex. http://www.domeniuldvs.ro/wp-content/themes/default; de fapt identic cu parametrii stylesheet_directory şi template_directory
  • text_direction = direcţia textului, cel mai adesea ltr (left to right = de la stânga spre dreapta)
  • version = versiunea WordPress utilizată, actuala versiune este WordPress 2.9.2
  • wpurl = locaţia directorului WordPress; de regulă adresa url şi locaţia WP este identică, însă se poate alege şi determina o altă locaţie, un subdirector ca de ex. http://www.domeniuldvs.ro/wp

Dacă nu se doreşte afişarea acestor informaţii ci doar prelucrarea lor se poate utiliza funcţia get_bloginfo(). Pentru prezentarea în cadrul fluxului RSS se recurge la funcţia bloginfo_rss(). Şi în acest caz aveţi posibilitatea de a apela pentru prelucrarea şi afişarea viitoare la funcţia alternativă get_bloginfo_rss(). Toate aceste funcţii PHP preiau datele din aceleaşi surse şi suportă aceeaşi parametrii listaţi mai sus. Valorile acestora se pot indica şi schimba cu drepturi de administrator din meniul Settings/Setări, submeniurile General/General şi Reading/Afişare. O posibilitate de a afla absolut toate informaţiile despre un site realizat cu WP, inclusiv pluginurile active cu setările preferate sau alte opţiuni ca de exemplu tipul documentelor, este deschiderea şi citirea fişierului /wp-admin/options.php.

Probabil că unii şi-au pus deja problema: pentru a introduce şi prezenta aceste informaţii cu ajutorul funcţiilor PHP ar fi nevoie de un plugin suplimentar ca de ex. ExecPHP sau runPHP care execută coduri PHP în site-uri WP, plus că funcţiile nu sunt tocmai uşor de ţinut minte. Articolul lui Vladimir a atras după sine un comentariu al lui Thomas Scholz, acesta din urmă recomandând un cod care odată introdus în fişierul functions.php al temei WP utilizate în mod curent permite introducerea tuturor informaţiilor suportate în pagini sau articole cu ajutorul shortcodurilor:

[PHP]function bloginfo_shortcode($atts){
extract(shortcode_atts(array(‘key’=>’name’), $atts));
return get_bloginfo($key);
}
add_shortcode(‘bloginfo’, ‘bloginfo_shortcode’);[/PHP]

Deci dacă scrieţi [bloginfo key=charset] într-o pagină sau articol va afişat caracterul encoding utilizat de WP, în cazul meu UTF-8. Pentru o mai uşoară utilizare eu am transcris toţi parametrii de mai sus în shortcoduri (vezi captura) şi preluând codul de mai sus am închegat un plugin cu numele de WP-Bloginfo, care poate fi descărcat de aici (sau ca arhivă zip direct aici). Pentru cei interesaţi de acest subiect, prezentarea unor informaţii din backend în frontend, mai amintesc şi pluginurile Blog-url Shortcodes (sunt valabile două shortcoduri, [blogurl] şi [posturl]) şi Template Tag Shortcodes (aici în directorul oficial de pluginuri WP). Ultimul suportă o mulţime de taguri şi funcţii WP apelabile prin shortcoduri, însă din păcate în testele mele nu a funcţionat.


Apreciază articolul:

1 stea2 stea3 stea4 stea5 stea (4 evaluări, media: 5,00 din 5)
Loading...Loading...

0 comentarii


Lasă un răspuns

Adresa ta de email nu va fi publicată. Câmpurile necesare sunt marcate *