Chris Taylor

<p>Wibstats is a WordPress plugin that gives a WordPress site, or each blog in a WordPress MU or BuddyPress installation, their own visitor statistics. The data stored includes the page viewed, date and time of visit, visitors browser, operating system and screen resolution, and the geographic location of the visitor (country and city) where it is possible to determine that information.</p>
<p>The plugin uses freely available APIs from several providers to determine the geographic location of the visitor. One of the APIs is chosen randomly for each visit to spread the load across each of the API providers.</p>
<p>A range of graphs and tables are available to users to see the visitors to their blog. WordPress MU site administrators also have the option to easily view the statistics for any particular blog, as well as for the main site.</p>
<p>The plugin relies on the <code>wp_footer</code> action, normally used in the footer.php file of the theme. Without this action no visitor statistics will be stored. Please check each template available to your end users to ensure they all use the <code>wp_footer action</code>.</p>
<h3>Shortcodes</h3>
<p>WibStats allows you to include statistics from your site in your blog posts and pages. This is done with shortcodes, simple bits of text that set some parameters for the information to display. For example:</p>
<pre><code>[wibstats report="popularsearches"] 
</code></pre>
<p>Will give you (for example);</p>
<pre><code>Search          Visitors
search 1        40%
search 2        30%
search 3        20%
search 4        10% 
</code></pre>
<p>Please note these examples here are not formatted correctly (due to WordPress readme file restrictions). The proper code looks like this:</p>
<pre><code><div class="wibstats_report [name of the report]">
<table>
    <thead>
        <tr>
            <th>Column 1</th>
            <th>Column 2</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>Row 1, column 1</td>
            <td>Row 1, column 2</td>
        </tr>
        <tr>
            <td>Row 2, column 1</td>
            <td>Row 2, column 2</td>
        </tr>
    </tbody>
</table>
</div>
</code></pre>
<p>Want another example? OK:</p>
<pre><code>[wibstats report="recentcountries"]
</code></pre>
<p>Gives:</p>
<pre><code>Country             Time
United Kingdom      9:22 pm
United States       9:21 pm
Portugal            9:18 pm
</code></pre>
<p>When showing country names WibStats will also show a small icon of the flag of that country.</p>
<p>There are quite a few different reports you can show (these go in the <code>report="report-name-here"</code> bit).</p>
<ul>
<li><code>popularcountries</code><br />
The most popular countries to visit your blog</li>
<li><code>popularcities</code><br />
The most popular cities to visit your blog</li>
<li><code>recentcountries</code><br />
The most recent countries to visit your blog</li>
<li><code>recentcities</code><br />
The most recent cities to visit your blog</li>
<li><code>popularbrowsers</code><br />
The most popular browsers to visit your blog</li>
<li><code>popularplatforms</code><br />
The most popular platforms (operating systems) to visit your blog</li>
<li><code>popularscreensizes</code><br />
The most popular screen sizes to visit your blog</li>
<li><code>popularsearches</code><br />
The most popular search words which found your blog</li>
<li><code>recentsearches</code><br />
The most recent search words which found your blog</li>
<li><code>populardays</code><br />
The most popular days of the week that people visited your blog</li>
<li><code>popularhours</code><br />
The most popular hours of the day that people visited your blog</li>
<li><code>popularmonths</code><br />
The most popular months of the year that people visited your blog</li>
<li><code>popularreferrers</code><br />
The most popular referring websites that sent visitors to your blog</li>
<li><code>recentreferrers</code><br />
The most recent referring websites that sent visitors to your blog</li>
<li><code>session</code><br />
A breakdown of the data associated with the current visitor to your blog (their country, city, browser etc)</li>
</ul>
<p>A couple of other options allow you to configure these reports as they display on your posts/pages.</p>
<pre><code>size
</code></pre>
<p>Sets the number of items you want to show (minimum 1, maximum 100)</p>
<pre><code>cache
</code></pre>
<p>Sets how long you want the report to be cached for. Caching means that the report isn’t recalculated every time someone visits the page, meaning the page is a little bit faster to load.</p>
<p>The <code>size</code> option is set in minutes, with “0” meaning not-cached-at-all (the report is recalculated every time someone visits the page it appears on) and “-1” for cached forever (the report is generated once then remains the same forever).</p>
<p>So, a couple more examples:</p>
<pre><code>[wibstats report="popularcities" size="25"]
</code></pre>
<p>This shows the top 25 most popular cities to visit your blog.</p>
<pre><code>[wibstats report="recentsearches" size="5" cache="0"]
</code></pre>
<p>This shows the top 5 latest search words which brought visitors to your blog, and is not cached at all.</p>
<pre><code>[wibstats report="popularreferrers" size="50" cache="-1"]
</code></pre>
<p>This shows the top 50 most popular referring websites (sites that have a link to your blog) and is cached forever. This means the report will show what the top referring sites are now and will never be updated.</p>
<h3>To-do</h3>
<ul>
<li>Stats-by-email, where Wibstats will email you daily, weekly or monthly with the latest statistics.</li>
<li>More ways to slice and dice the existing data. More graphs, perhaps using a serious graphic system (Flot, perhaps).</li>
<li>A “live” view showing who is visiting your blog Right Now</li>
<li>Storing the exit time for each page, so reports on how long people spent on your site can be built</li>
<li>More reports on average pages per visitor</li>
</ul>
<p>Any further ideas will be gratefully received.</p>


Wibstats

Wibstats is a Wordpress plugin that gives each blog in a Wordpress, Wordpress MU or BuddyPress installation their own visitor statistics.

Yann at WP&amp;Co

<h4>Show a list of all the WPMU sub-sites</h4>
<p>This WordPress MU plugin installs a <strong>new sidebar widget</strong> that can display the <strong>list of children sites</strong> of your main <strong>mother site</strong> in a single or multi-column format.<br />
The <strong>post count</strong> is displayed for each sub-site / blog of the <strong>blogs listing</strong>.<br />
It also creates a <strong>new PHP function</strong> that can be included in any template to <strong>display an ordered list</strong> that can be designed as a block of information using CSS.</p>
<p>The list can be ordered by blog name, post count, blog creation date or last update, in ascending or descending order.<br />
Blogs can be excluded from the list based on various criteria or individually by blog ID.</p>
<p>Since version 2.0.0, this plugin supports WPML multiple-language blogs: it will automatically list only blogs using the active language, except where WPML filters are deactivated,<br />
or a special ‘in’ (international) langiage is created.</p>
<p>If you don’t like the widget or don’t use sidebars, you can also <strong>include the list in the content of any page or post</strong> of your blog,<br />
by simply adding the special <code>[!YDWPMUBL]</code> special tag, or <strong>include the blog listing in a template</strong> with the <code><?php yd_display_wpmu_bloglist() ?></code> function.<br />
The list design is <strong>highly customizable</strong> allowing different settings when displayed as a widget on the home page and other blog pages, and when used inside templates.</p>
<p>All display parameters can be set in the settings (options) page, or overridden in the template function call.</p>
<p>The display style of each element of the listing can be individually customized using CSS.</p>
<p>The plugin uses <strong>cache</strong> and sitemeta table information to avoid multiple database query.<br />
It has its own widget control pannel and admin settings page.<br />
It is <strong>fully internationalized</strong>.</p>
<p>Base package includes .pot file for translation of the interface, and English, Spanish, Galician, French, Dutch and German versions.<br />
The plugin can be used to display text in any WordPress compatible language and charset.</p>
<h4>Active support</h4>
<p>Drop me a line on my <a href="http://www.yann.com/en/wp-plugins/yd-wpmu-bloglist-widget" title="Yann Dubois' Bloglist Widget for WordPress MU" rel="nofollow ugc">YD WPMU Bloglist plugin support site</a> to report bugs, ask for a specific feature or improvement, or just tell me how you’re using the plugin.</p>
<h4>Description en Français :</h4>
<p>Ce plug-in WordPress installe un nouveau widget dans votre barre latérale qui peut afficher la liste des “sous-sites” de votre site principal WordPress MU, triés selons divers critères au choix.</p>
<p>Le nombre de billets publiés dans chaque blog est également indiqué.</p>
<p>La liste peut être triée notamment par nom de site, par nombre de billets publiés, par date de création ou de mise à jour.<br />
On peut sélectionner quels blogs sont inclus ou exclus de la liste selon divers critères, et exclure individuellement des blogs par identifiant.</p>
<p>Depuis la version 2.0.0 ce plugin supporte les sites multi-lingues utilisant WPML. Seuls les blogs de la langue active seront listés.</p>
<p>La liste est affichée sous forme d’un bloc, sur une ou plusieurs colonnes et on peut choisir le nombre de colonnes à utiliser.<br />
Si vous n’aimez pas le principe du widget ou n’utilisez pas de barres latérales, vous pouvez inclure la liste des blogs n’impore où dans le contenu des pages et billets de votre blog,<br />
simplement en insérant un “tag” spécial.</p>
<p>Chaque élément affiché dispose d’un conteneur séparé permettant de complètement personnaliser le style d’affichage à l’aide de feuilles de style CSS.</p>
<p>Le plugin utilise un système de cache pour éviter les requêtes de base de données redondantes.</p>
<p>Il a son propre panneau de contrôle et sa page de réglages (options) dans l’administration.<br />
Il est entièrement internationalisé.</p>
<p>La distribution standard inclut le fichier de traduction .pot et les versions française, anglaise, espagnole, galicienne, hollandaise et allemande.<br />
Le plugin peut fonctionner avec n’importe quelle langue ou jeu de caractères y compris le chinois.<br />
Pour toute aide ou information en français, laissez-moi un commentaire sur le <a href="http://www.yann.com/en/wp-plugins/yd-wpmu-bloglist-widget" title="Yann Dubois' Bloglist Widget for WordPress" rel="nofollow ugc">site de support du plugin YD WPMU Bloglist Widget</a>.</p>
<h4>Funding Credits</h4>
<p>Original and additional developments of this plugin has been paid for by <a href="http://www.wellcom.fr" title="Wellcom" rel="nofollow ugc">Wellcom.fr</a>. Please visit their site!</p>
<p>Le développement d’origine et les améliorations de cette extension ont été financés par <a href="http://www.wellcom.fr" title="Wellcom" rel="nofollow ugc">Wellcom.fr</a>. Allez visiter leur site !</p>
<h4>Translation</h4>
<p>If you want to contribute to a translation of this plugin, please drop me a line by e-mail or leave a comment on the <a href="http://www.yann.com/en/wp-plugins/yd-wpmu-bloglist-widget" title="Yann Dubois' Bloglist Widget for WordPress MU" rel="nofollow ugc">plugin’s page</a>.<br />
You will get credit for your translation in the plugin file and this documentation, as well as a link on this page and on my developers’ blog.</p>
<h4>Translation credits</h4>
<ul>
<li>Spanish and Galician translation kindly provided by: <a href="http://www.arumeinformatica.es/" title="Arume" rel="nofollow ugc">Arume</a></li>
<li>Dutch translation kindly provided by: <a href="http://www.fethiyehotels.com" title="Rene" rel="nofollow ugc">Rene</a></li>
<li>German translation by: <a href="http://www.pangaea.nl/diensten/exact-webshop" title="Pangaea" rel="nofollow ugc">Rian Kramer</a></li>
<li>Ukrainian translation by: <a href="http://webhostinggeeks.com/" title="Web Geek" rel="nofollow ugc">Mikalay Lisica</a></li>
</ul>
<h3>Widget control pannel</h3>
<p>The widget has its own control pannel for setting-up its look and feel. You can administer it from the widgets admin page.<br />
Remember to clear the cache when you make changes, if you want to see them right away (see hereunder).</p>
<h3>Widget options page</h3>
<p>Use the widget’s own option page to clear the cache and reset default settings.<br />
Otherwise, the cache expires only when content is added to the blog or widget control panel options are changed.</p>
<h3>Revisions</h3>
<ul>
<li>2.1.1 Indonesian translation by Syamsul Alam</li>
<li>2.1.0 New features: drop-down, sort by domain, filter hooks, show_count=false, wp-style arguments</li>
<li>2.0.0 Major new release : WPML support, blog exclusion options</li>
<li>1.0.2 Bugfix in postcount order; German version.</li>
<li>1.0.1 Bugfix in settings update.</li>
<li>1.0.0 Final release. Includes improved settings page and Dutch version.</li>
<li>0.2.2 Bug fixes in the options page (when saving settings) – still considered beta (check cache IRL).</li>
<li>0.2.1 Third debug (“duplicate link” issue for subdomains) – still considered beta (check cache IRL).</li>
<li>0.2.0 Second debug (thanks to TB@Wellcom) – still considered beta (check cache IRL).</li>
<li>0.1.1 First debug (thanks to Arume) – still considered beta (check cache IRL).</li>
<li>0.1.0 Original beta version.</li>
</ul>
<h3>Did you like it?</h3>
<p>Drop me a line on http://www.yann.com/en/wp-plugins/yd-wpmu-bloglist-widget</p>
<p>And… <em>please</em> rate this plugin –></p>


YD WPMU Bloglist Widget

Sidebar widget and template function to display an ordered blog list of subsites (with post count) on a page of the WordPress MU main site.

Wibstats vs YD WPMU Bloglist Widget