IkiWiki/Plugin/skeleton.pm.example

   1 #!/usr/bin/perl
   2 # Ikiwiki skeleton plugin. Replace "skeleton" with the name of your plugin
   3 # in the lines below, remove hooks you don't use, and flesh out the code to
   4 # make it do something.
   5 package IkiWiki::Plugin::skeleton;
   6
   7 use warnings;
   8 use strict;
   9 use IkiWiki 2.00;
  10
  11 sub import {
  12         hook(type => "getopt", id => "skeleton",  call => \&getopt);
  13         hook(type => "getsetup", id => "skeleton",  call => \&getsetup);
  14         hook(type => "checkconfig", id => "skeleton", call => \&checkconfig);
  15         hook(type => "refresh", id => "skeleton", call => \&refresh);
  16         hook(type => "needsbuild", id => "skeleton", call => \&needsbuild);
  17         hook(type => "preprocess", id => "skeleton", call => \&preprocess);
  18         hook(type => "filter", id => "skeleton", call => \&filter);
  19         hook(type => "linkify", id => "skeleton", call => \&linkify);
  20         hook(type => "scan", id => "skeleton", call => \&scan);
  21         hook(type => "htmlize", id => "skeleton", call => \&htmlize);
  22         hook(type => "sanitize", id => "skeleton", call => \&sanitize);
  23         hook(type => "postscan", id => "skeleton", call => \&postscan);
  24         hook(type => "format", id => "skeleton", call => \&format);
  25         hook(type => "pagetemplate", id => "skeleton", call => \&pagetemplate);
  26         hook(type => "templatefile", id => "skeleton", call => \&templatefile);
  27         hook(type => "delete", id => "skeleton", call => \&delete);
  28         hook(type => "change", id => "skeleton", call => \&change);
  29         hook(type => "cgi", id => "skeleton", call => \&cgi);
  30         hook(type => "auth", id => "skeleton", call => \&auth);
  31         hook(type => "sessioncgi", id => "skeleton", call => \&sessioncgi);
  32         hook(type => "canedit", id => "skeleton", call => \&canedit);
  33         hook(type => "cansave", id => "skeleton", call => \&cansave);
  34         hook(type => "editcontent", id => "skeleton", call => \&editcontent);
  35         hook(type => "formbuilder_setup", id => "skeleton", call => \&formbuilder_setup);
  36         hook(type => "formbuilder", id => "skeleton", call => \&formbuilder);
  37         hook(type => "savestate", id => "skeleton", call => \&savestate);
  38 }
  39
  40 sub getopt () {
  41         debug("skeleton plugin getopt");
  42 }
  43
  44 sub getsetup () {
  45         return
  46                 plugin => {
  47                         safe => 1,
  48                         rebuild => undef,
  49                 },
  50                 skeleton => {
  51                         type => "boolean",
  52                         example => 0,
  53                         description => "example option",
  54                         safe => 0,
  55                         rebuild => 0,
  56                 },
  57 }
  58
  59 sub checkconfig () {
  60         debug("skeleton plugin checkconfig");
  61 }
  62
  63 sub refresh () {
  64         debug("skeleton plugin refresh");
  65 }
  66
  67 sub needsbuild () {
  68         debug("skeleton plugin needsbuild");
  69 }
  70
  71 sub preprocess (@) {
  72         my %params=@_;
  73
  74         return "skeleton plugin result";
  75 }
  76
  77 sub filter (@) {
  78         my %params=@_;
  79
  80         debug("skeleton plugin running as filter");
  81
  82         return $params{content};
  83 }
  84
  85 sub linkify (@) {
  86         my %params=@_;
  87
  88         debug("skeleton plugin running as linkify");
  89
  90         return $params{content};
  91 }
  92
  93 sub scan (@) { #{{{a
  94         my %params=@_;
  95
  96         debug("skeleton plugin running as scan");
  97 }
  98
  99 sub htmlize (@) {
 100         my %params=@_;
 101
 102         debug("skeleton plugin running as htmlize");
 103
 104         return $params{content};
 105 }
 106
 107 sub sanitize (@) {
 108         my %params=@_;
 109
 110         debug("skeleton plugin running as a sanitizer");
 111
 112         return $params{content};
 113 }
 114
 115 sub postscan (@) {
 116         my %params=@_;
 117
 118         debug("skeleton plugin running as postscan");
 119 }
 120
 121 sub format (@) {
 122         my %params=@_;
 123
 124         debug("skeleton plugin running as a formatter");
 125
 126         return $params{content};
 127 }
 128
 129 sub pagetemplate (@) {
 130         my %params=@_;
 131         my $page=$params{page};
 132         my $template=$params{template};
 133
 134         debug("skeleton plugin running as a pagetemplate hook");
 135 }
 136
 137 sub templatefile (@) {
 138         my %params=@_;
 139         my $page=$params{page};
 140
 141         debug("skeleton plugin running as a templatefile hook");
 142 }
 143
 144 sub delete (@) {
 145         my @files=@_;
 146
 147         debug("skeleton plugin told that files were deleted: @files");
 148 }
 149
 150 sub change (@) {
 151         my @files=@_;
 152
 153         debug("skeleton plugin told that changed files were rendered: @files");
 154 }
 155
 156 sub cgi ($) {
 157         my $cgi=shift;
 158
 159         debug("skeleton plugin running in cgi");
 160 }
 161
 162 sub auth ($$) {
 163         my $cgi=shift;
 164         my $session=shift;
 165
 166         debug("skeleton plugin running in auth");
 167 }
 168
 169 sub sessioncgi ($$) {
 170         my $cgi=shift;
 171         my $session=shift;
 172
 173         debug("skeleton plugin running in sessioncgi");
 174 }
 175
 176 sub canedit ($$$) {
 177         my $page=shift;
 178         my $cgi=shift;
 179         my $session=shift;
 180
 181         debug("skeleton plugin running in canedit");
 182 }
 183
 184 sub cansave ($$$$) {
 185         my $page=shift;
 186         my $content=shift;
 187         my $cgi=shift;
 188         my $session=shift;
 189
 190         debug("skeleton plugin running in cansave")
 191 }
 192
 193 sub editcontent ($$$) {
 194         my %params=@_;
 195
 196         debug("skeleton plugin running in editcontent");
 197
 198         return $params{content};
 199 }
 200
 201 sub formbuilder_setup (@) {
 202         my %params=@_;
 203
 204         debug("skeleton plugin running in formbuilder_setup");
 205 }
 206
 207 sub formbuilder (@) {
 208         my %params=@_;
 209
 210         debug("skeleton plugin running in formbuilder");
 211 }
 212
 213 sub savestate () {
 214         debug("skeleton plugin running in savestate");
 215 }
 216
 217 1