path: root/IkiWiki/Plugin/pagestats.pm

#!/usr/bin/perl
#
# Produce page statistics in various forms.
#
# Currently supported:
#   cloud: produces statistics in the form of a del.icio.us-style tag cloud
#          (default)
#   table: produces a table with the number of backlinks for each page
#
# by Enrico Zini
package IkiWiki::Plugin::pagestats;

use warnings;
use strict;
use IkiWiki 3.00;

# Names of the HTML classes to use for the tag cloud
our @classes = ('smallestPC', 'smallPC', 'normalPC', 'bigPC', 'biggestPC' );

sub import {
    hook(type => "getsetup", id => "pagestats", call => \&getsetup);
    hook(type => "preprocess", id => "pagestats", call => \&preprocess);
}

sub getsetup () {
    return 
        plugin => {
            safe => 1,
            rebuild => undef,
            section => "widget",
        },
}

sub preprocess (@) {
    my %params=@_;
    $params{pages}="*" unless defined $params{pages};
    my $style = ($params{style} or 'cloud');
    
    my %counts;
    my $max = 0;
    foreach my $page (pagespec_match_list($params{page}, $params{pages},
                          # update when a displayed page is added/removed
                          deptype => deptype("presence"))) {
        use IkiWiki::Render;

        my @backlinks = IkiWiki::backlink_pages($page);

        if (exists $params{among}) {
            # only consider backlinks from the amoung pages
            @backlinks = pagespec_match_list(
                $params{page}, $params{among},
                # update whenever links on those pages change
                deptype => deptype("links"),
                list => \@backlinks
            );
        }
        else {
            # update when any page with links changes,
            # in case the links point to our displayed pages
            add_depends($params{page}, "*", deptype("links"));
        }

        $counts{$page} = scalar(@backlinks);
        $max = $counts{$page} if $counts{$page} > $max;
    }

    if (exists $params{show}) {
        my $i=0;
        my %show;
        foreach my $key (sort { $counts{$b} <=> $counts{$a} } keys %counts) {
            last if ++$i > $params{show};
            $show{$key}=$counts{$key};
        }
        %counts=%show;
    }

    if ($style eq 'table') {
        return "<table class='pageStats'>\n".
            join("\n", map {
                "<tr><td>".
                htmllink($params{page}, $params{destpage}, $_, noimageinline => 1).
                "</td><td>".$counts{$_}."</td></tr>"
            }
            sort { $counts{$b} <=> $counts{$a} } keys %counts).
            "\n</table>\n" ;
    }
    else {
        # In case of misspelling, default to a page cloud

        my $res = "<div class='pagecloud'>\n";
        foreach my $page (sort keys %counts) {
            next unless $counts{$page} > 0;

            my $class = $classes[$counts{$page} * scalar(@classes) / ($max + 1)];
            $res .= "<span class=\"$class\">".
                    htmllink($params{page}, $params{destpage}, $page).
                    "</span>\n";
        }
        $res .= "</div>\n";

        return $res;
    }
}

1