WIT Post Views/Visitors v1.0.2 – monitorizeaza vizitatorii si afisarile pe wordpress

In urma cu cateva zile a fost lansat WordPress 2.9 FINAL.Imediat dupa aceasta lansare am intampinat probleme de compatibilitate cu WP-Post Views, vechea extensie ce ma ajuta la monitorizarea traficului fiecarei pagini wordpress.Asa a luat nastere o noua extensie : WIT Post Views/Visitors.

Update 23 decembrie 2009

Ce este WIT Post Views/Visitors?

Este o alternativa mai buna la WP-Post Views in opinia mea ce va poate ajuta la monitorizarea „traficului”,daca imi permiteti sa spun asa, a unei singure pagini(post,page). Imbunatatirea adusa pluginului anterior o constituie faptul ca vom putea monitoriza atat numarul de vizitatori unici al unei pagini, cat si numarul de afisari ale acesteia. O functie pusa la dispozitie ne va permite sa formatam un mesaj asa cum observam pe paginile WorldIT, in special pe pagina principala. Pe WorldIT extensia functioneaza, informandu-ne cu privire la numarul de afisari ale unei pagini.

Cum il instalam?

1. Descarcati arhiva extensiei WIT Post Views/Visitors.
2. Incarcati aceasta extensie dezarhivata in folderul /wp-content/plugins/
3. Activati pluginul din panoul de administrare WordPress
4. Instalare terminata. 🙂

Cum putem vizualiza statisticile?

Extensia iti pune la dispozitie functia wit_get_post_info ce ne va permite sa extragem informatiile unei pagini si sa o afisam in mod corespunzator.

Structura functiei :

/*
   $type = poate fi views sau unique_views in functie de ce dorim sa vizualizam
   $message = array('mesajul in care nu avem vizualizari',
                            'mesajul in cazul in care avem o vizualizare',
                            'mesajul in cazul in care avem mai mult de o vizualizare')
   $show  = in cazul in care dorim sa afisam direct bufferul aceasta variabila trebuie sa ramana TRUE,in caz contrar va returna informatia 

*/ 
function wit_get_post_info($type = 'views',$message = array('Nici o afisare','O afisare','# afisari'),$show = TRUE);

Exemplu :

$mesaj = wit_get_post_info('views',array('Nici o afisare.','O afisare.','# afisari.'),FALSE);  
echo $mesaj;

Pasii pentru instalarea sistemului de afisare a statisticilor

1. Deschidem wp-content/themes//index.php .Extensia mai poate fi plasata si in archive.php, single.php, post.php sau page.php
2. Cautati < ?php while (have_posts()) : the_post(); ?>
3. Adaugati linia de mai jos oriunde doriti sa afisati mesajul.

<?php if(function_exists('wit_get_post_info')) { wit_get_post_info('views',array('Nici o afisare.','O afisare.','# afisari.')); } ?>  

You may place it in archive.php, single.php, post.php or page.php also.
In cazul in care s-au facut 10 afisari mesajul returnat va fi „10 afisari”, iar daca numarul acestora va fi 0 va fi returnat mesajul „Nici o afisare” ce va fi trimis catre obiectul HTML. 🙂

Daca apar probleme la contorizarea vizitelor provenite de la vizitatorii nelogati adaugati linia :

wit_activate_stats();

imediat dupa functia the_post(); din fisierele single.php si page.php. Incerc sa rezolv aceasta problema! 🙂

Daca dorim sa nu stocam informatii referitoare la numarul de afisari/vizitatori unici, in fisierul extensiei cautam liniile 34,35:

$countViews    = TRUE; //TRUE - stocheaza afisarile, FALSE - nu
$countVisitors = TRUE; // TRUE - stocheaza vizitatorii unici, FALSE - nu

Vreau sa importez statisticile din WP-Post Views

In aceasta situatie rulati urmati pasii urmatori :
1. Descarcati arhiva si uploadati fisierul wit-convertor in folderul radacina al blogului.
2. Executati fisierul PHP tastand in browser : http://www.site.com/wit-import.php
3. Alegeti varianta „Da”
4. Stergeti fisierul incarcat doar daca v-a afisat mesajul „Importarea a avut loc cu succes…”.
5. Gata! 😀

Vreau sa creez un top al celor mai posturi

Structura functiei

/*
     $meta = wit_views sau wit_unique_views in functie de ce clasament dorim sa facem : top afisari sau top vizitatori
     $type  = DESC : descrescator sau ASC : crescator
     $limit  = limita de articole ce vor fi incluse
     $nchars = numarul de caractere din articol ce vor fi incluse in clasament
     $display = afiseaza direct in browser clasamentul sau returneaza  functia aceste informatii
*/
function wit_get_viewed($meta='wit_views',$type = 'DESC',$limit = 10, $nchars = 0, $display = true);

Pentru a formata modul in care sunt afisate adresele va trebui sa accesam fisierul wit-post views-visitors.php si vom cauta liniile 36 si 37.Pentru a crea o structura a unui articol din clasament pentru afisari va trebui sa editam

$most_viewed_template  = '<li><a href="%POST_URL%"  title="%POST_TITLE%">%POST_TITLE%</a> - %VIEW_COUNT%';

iar daca vom dori sa editam modul in care arata structura clasamentului pentru vizitatori

$most_uviewed_template = '<li><a href="%POST_URL%"  title="%POST_TITLE%">%POST_TITLE%</a> - %VIEW_U_COUNT%';

In aceasta structura putem folosi „hashtagurile” de mai jos pentru a folosi diferite informatii ale unor articole. 🙂

%VIEW_COUNT% – numarul de afisari
%VIEW_U_COUNT% – numarul de vizitatori unici
%POST_TITLE% – titlul articolului
%POST_EXCERPT% – excerptul articolului
%POST_CONTENT% – continutul articolului
%POST_URL% – adresa catre articol

Exemplu de folosire:
Daca vom introduce linia oriunde intr-una din paginile temei wordpress:

 echo wit_get_viewed('wit_unique_views','DESC',5, 0,FALSE);

si va genera un clasamentul celor mai vizitate 5 pagini dupa numarul de vizitatori unici, folosind functia pentru afisare echo,aceasta nefiind automata in aceasta situatie.De asemenea am ales sa nu afisam continut din articol, al 3-lea argument al functiei fiind 0. 😀

Post Scriptum

Aceasta extensie am incercat sa o fac cat mai simpla, facilitatile complexe nefiind luate in seama.In cazul in care vor exista persoane ce doresc sa dezvolt aceasta extensie, un simplu comentariu si vom discuta. De asemenea,daca intampinati probleme, nu ezitati sa scrieti! 😀

Cine ma ajuta sa pun extensia in galeria de extensii WordPress? 😀

Updates

1.0.1 – Versiunea de lansare
1.0.2 – Am adaugat functia wit_get_viewed ce permite crearea unui top al celor mai accesate sau celor mai putin accesate pagini de pe blog.