IkiWiki/Plugin/tag.pm

   1 #!/usr/bin/perl
   2 # Ikiwiki tag plugin.
   3 package IkiWiki::Plugin::tag;
   4
   5 use warnings;
   6 use strict;
   7 use IkiWiki 2.00;
   8
   9 my %tags;
  10
  11 sub import { #{{{
  12         hook(type => "getopt", id => "tag", call => \&getopt);
  13         hook(type => "preprocess", id => "tag", call => \&preprocess, scan => 1);
  14         hook(type => "pagetemplate", id => "tag", call => \&pagetemplate);
  15 } # }}}
  16
  17 sub getopt () { #{{{
  18         eval q{use Getopt::Long};
  19         error($@) if $@;
  20         Getopt::Long::Configure('pass_through');
  21         GetOptions("tagbase=s" => \$config{tagbase});
  22 } #}}}
  23
  24 sub tagpage ($) { #{{{
  25         my $tag=shift;
  26
  27         if (exists $config{tagbase} &&
  28             defined $config{tagbase}) {
  29                 $tag=$config{tagbase}."/".$tag;
  30         }
  31
  32         return $tag;
  33 } #}}}
  34
  35 sub preprocess (@) { #{{{
  36         if (! @_) {
  37                 return "";
  38         }
  39         my %params=@_;
  40         my $page = $params{page};
  41         delete $params{page};
  42         delete $params{destpage};
  43         delete $params{preview};
  44
  45         foreach my $tag (keys %params) {
  46                 $tag=IkiWiki::linkpage($tag);
  47                 $tags{$page}{$tag}=1;
  48                 # hidden WikiLink
  49                 push @{$links{$page}}, tagpage($tag);
  50         }
  51
  52         return "";
  53 } # }}}
  54
  55 sub pagetemplate (@) { #{{{
  56         my %params=@_;
  57         my $page=$params{page};
  58         my $destpage=$params{destpage};
  59         my $template=$params{template};
  60
  61         $template->param(tags => [
  62                 map {
  63                         link => htmllink($page, $destpage, tagpage($_),
  64                                         rel => "tag")
  65                 }, sort keys %{$tags{$page}}
  66         ]) if exists $tags{$page} && %{$tags{$page}} && $template->query(name => "tags");
  67
  68         if ($template->query(name => "categories")) {
  69                 # It's an rss/atom template. Add any categories.
  70                 if (exists $tags{$page} && %{$tags{$page}}) {
  71                         $template->param(categories => [map { category => $_ },
  72                                 sort keys %{$tags{$page}}]);
  73                 }
  74         }
  75 } # }}}
  76
  77 1