misc/plugins/referer.wp2

#?SuikaWikiConfig/2.0

Plugin:
  @Name: Referer
  @Description:
    @@@: Backward hyperlinking
    @@lang:en
  @License: %%Perl%%
  @Author:
    @@Name:
      @@@@: Wakaba
      @@@lang:ja
      @@@script:Latn
    @@Mail[list]: w@suika.fam.cx
  @Date.RCS:
    $Date: 2004/03/11 08:06:09 $
  @RequiredPlugin[list]: 
    InterWikiCore
    WikiStructure
    WikiLinking
  @RequiredModule[list]:
    URI
  @Use:
    use Message::Util::Error;
    require URI;
    my $INTERWIKICORE;
    my $WIKIRESOURCE;
    my $WIKILINKING;

PluginConst:
  @NS_XHTML1:
    http://www.w3.org/1999/xhtml
  @INTERWIKICORE:
    {($INTERWIKICORE ||= SuikaWiki::Plugin->module_package ('InterWikiCore'))}
  @WIKIRESOURCE:
    {($WIKIRESOURCE ||= SuikaWiki::Plugin->module_package ('WikiResource'))}
  @WIKILINKING:
    {($WIKILINKING ||= SuikaWiki::Plugin->module_package ('WikiLinking'))}

FormattingRule:
  @Category[list]:
    view
    view-resource
    form-input
  @Name: referer-list
  @Parameter:
    @@Name: page
    @@Type: WikiName
    @@Default: (auto)
    @@Description:
      @@@: WikiPage name
      @@lang: en
  @Formatting:
    __ATTRTEXT:%page__;
    my @list;
    try {
      @list = map {[split /\x09/, $_, 2]}
              split /\x0A/,
              $o->{wiki}->{db}->get ('referer',
                                     $o->{wiki}->name ($p->{page} ||
                                       $o->{wiki}->{var}->{page}));
    } catch SuikaWiki::DB::Util::Error with {
      # 
    };
    
    if (@list) {
      my $list = $p->{-parent}->append_new_node
                     (type => '#element',
                      namespace_uri => $NS_XHTML1,
                      local_name => 'ol');
      my $default_label = $WIKIRESOURCE->get
                             (name => 'Referer:URIReference2Label',
                              o => $o, wiki => $o->{wiki});
      my $li_label = $WIKIRESOURCE->get
                            (name => 'Referer:RefererList:Label',
                             o => $o, wiki => $o->{wiki});
      for my $item (sort {$b->[1] <=> $a->[1] or $a->[0] cmp $b->[0]} @list) {
        local $o->{iwc__param}->{uri_reference} = URI->new ($item->[0]);
        my $label;
        try {
          if ($o->{wiki}->{db}->exist (ref__item_template => [$item->[0]])) {
            $label = $o->{wiki}->{db}->get (ref__item_template => [$item->[0]]);
          } else {
            my $site = $INTERWIKICORE->get_site_entry_by_uri_reference_match
                         (o => $o,
                          page => $o->{wiki}->{config}->{page}->{InterWikiName});
            $label = $site ? $site->get_attribute_value ('URIReference2Label')
                           : $default_label;
            $o->{wiki}->{db}->set (ref__item_template => [$item->[0]]
                                                      => $label);
          }
        } catch SuikaWiki::DB::Util::Error with {};
        $WIKILINKING->to_resource_by_uri_in_html ({
          label => $li_label,
          ref__label => $label || $default_label,
        } => {
          uri => $o->{iwc__param}->{uri_reference},
        }, {
          o => $o,
          parent => $list->append_new_node
                     (type => '#element',
                      namespace_uri => $NS_XHTML1,
                      local_name => 'li'),
          ref__weight => $item->[1],
        });
      }
    }

Function:
  @Name: add_referer
  @Main:
    my (undef, %opt) = @_;
    return unless $opt{wiki}->{db};
    return unless $opt{uri};
    $opt{page} ||= $opt{wiki}->{var}->{page};
    my $o = $opt{o} || {wiki => $opt{wiki}};
    
    ## To be canonical URI reference object
    unless (ref $opt{uri}) {
      $opt{uri} = URI->new ($opt{uri})->canonical;
    } else {
      $opt{uri} = $opt{uri}->canonical;
    }

    local $o->{iwc__param} = {
      uri_reference => $opt{uri},
    };

    ## Check with site definition
    my $site = $INTERWIKICORE->get_site_entry_by_uri_reference_match
                  (o => $o,
                   page => $opt{wiki}->{config}->{page}->{InterWikiName});
    if ($site) {
      my $v = 1;
      my $check = $site->get_attribute_value
                                    ('RefererLog', default => '1');
      try {
        $v = $o->{wiki}->{plugin}
               ->boolean_formatter ('iwc__urireference_operation')
               ->replace ($check, param => $o);
      } catch Message::Util::Formatter::error with {
        my $err = shift;
        if ($err->{-object}->{-category_name} eq 'iwc__urireference_operation') {
          my $wiki = $err->{-option}->{param}->{wiki};
          SuikaWiki::Plugin->module_package ('Error')
                           ->reporting_formatting_template_error
                               ($err, $err->{option}->{param}->{wiki},
                                template => $check);
        } else {
          $err->throw;
        }
      };
      return unless $v;
    }
    
    ## Update referer list
    my %referer;
    for (split /\x0A/, $opt{wiki}->{db}->get ('referer', $opt{page})) {
      my ($n, $t) = split /\x09/, $_, 2;
      $referer{$n} = $t + 0;
    }
    $referer{$o->{iwc__param}->{uri_reference}}++;
    $opt{wiki}->{db}->set ('referer', $opt{page}
            => join "\x0A", map {$_ . "\x09" . $referer{$_}} keys %referer);

FormattingRule:
  @Category[list]: link-to-resource
  @Name: ref--referer-item-weight
  @Formatting:
    $p->{-parent}->append_text ($o->{link}->{option}->{ref__weight});

FormattingRule:
  @Category[list]: link-to-resource
  @Name: ref--referer-item-label
  @Description:
    @@@:
      Label for referer list item, that is taken from InterWikiName database.
    @@lang: en
  @Formatting:
    try {
      $f->replace ($o->{link}->{src}->{ref__label},
                   param => $o,
                   -parent => $p->{-parent});
    } catch Message::Util::Formatter::error with {
      my $err = shift;
      if ($err->{-object}->{-category_name} eq $f->{-category_name}) {
        my $wiki = $err->{option}->{param}->{wiki};
        SuikaWiki::Plugin->module_package ('Error')
                         ->reporting_formatting_template_error
                             ($err, $wiki,
                              template => $o->{link}->{src}->{ref__label});
        undef;
      } else {
        $err->throw;
      }
    };

ViewFragment:
  @Name: ws--post-content
  @Description:
    @@@: After content body -- referer lista
    @@lang:en
  @Order: 150
  @Formatting:
        %section (
          id => referer,
          title => {%res(name=>Referer);}p, heading,
          content => {%referer-list;}p,
        );

Resource:
  @Referer:RefererList:Label:
    {%ref--referer-item-weight;} %ref--referer-item-label;
  @Referer:URIReference2Label:
    <%link-to-it (label => {%uri-reference;}p);>
1	wakaba	1.1	#?SuikaWikiConfig/2.0
2
3			Plugin:
4			@Name: Referer
5			@Description:
6			@@@: Backward hyperlinking
7			@@lang:en
8			@License: %%Perl%%
9			@Author:
10			@@Name:
11			@@@@: Wakaba
12			@@@lang:ja
13			@@@script:Latn
14			@@Mail[list]: w@suika.fam.cx
15			@Date.RCS:
16	wakaba	1.3	$Date: 2004/03/11 08:06:09 $
17	wakaba	1.1	@RequiredPlugin[list]:
18			InterWikiCore
19			WikiStructure
20			WikiLinking
21			@RequiredModule[list]:
22			URI
23			@Use:
24			use Message::Util::Error;
25			require URI;
26			my $INTERWIKICORE;
27			my $WIKIRESOURCE;
28			my $WIKILINKING;
29
30			PluginConst:
31			@NS_XHTML1:
32			http://www.w3.org/1999/xhtml
33			@INTERWIKICORE:
34			{($INTERWIKICORE \|\|= SuikaWiki::Plugin->module_package ('InterWikiCore'))}
35			@WIKIRESOURCE:
36			{($WIKIRESOURCE \|\|= SuikaWiki::Plugin->module_package ('WikiResource'))}
37			@WIKILINKING:
38			{($WIKILINKING \|\|= SuikaWiki::Plugin->module_package ('WikiLinking'))}
39
40			FormattingRule:
41			@Category[list]:
42			view
43			view-resource
44			form-input
45			@Name: referer-list
46			@Parameter:
47			@@Name: page
48			@@Type: WikiName
49			@@Default: (auto)
50			@@Description:
51			@@@: WikiPage name
52			@@lang: en
53			@Formatting:
54			__ATTRTEXT:%page__;
55			my @list;
56			try {
57			@list = map {[split /\x09/, $_, 2]}
58			split /\x0A/,
59			$o->{wiki}->{db}->get ('referer',
60			$o->{wiki}->name ($p->{page} \|\|
61			$o->{wiki}->{var}->{page}));
62			} catch SuikaWiki::DB::Util::Error with {
63			#
64			};
65
66			if (@list) {
67			my $list = $p->{-parent}->append_new_node
68			(type => '#element',
69			namespace_uri => $NS_XHTML1,
70			local_name => 'ol');
71	wakaba	1.2	my $default_label = $WIKIRESOURCE->get
72			(name => 'Referer:URIReference2Label',
73			o => $o, wiki => $o->{wiki});
74			my $li_label = $WIKIRESOURCE->get
75			(name => 'Referer:RefererList:Label',
76			o => $o, wiki => $o->{wiki});
77			for my $item (sort {$b->[1] <=> $a->[1] or $a->[0] cmp $b->[0]} @list) {
78			local $o->{iwc__param}->{uri_reference} = URI->new ($item->[0]);
79			my $label;
80			try {
81			if ($o->{wiki}->{db}->exist (ref__item_template => [$item->[0]])) {
82			$label = $o->{wiki}->{db}->get (ref__item_template => [$item->[0]]);
83			} else {
84			my $site = $INTERWIKICORE->get_site_entry_by_uri_reference_match
85			(o => $o,
86			page => $o->{wiki}->{config}->{page}->{InterWikiName});
87			$label = $site ? $site->get_attribute_value ('URIReference2Label')
88			: $default_label;
89			$o->{wiki}->{db}->set (ref__item_template => [$item->[0]]
90			=> $label);
91			}
92			} catch SuikaWiki::DB::Util::Error with {};
93	wakaba	1.1	$WIKILINKING->to_resource_by_uri_in_html ({
94	wakaba	1.2	label => $li_label,
95			ref__label => $label \|\| $default_label,
96	wakaba	1.1	} => {
97	wakaba	1.2	uri => $o->{iwc__param}->{uri_reference},
98	wakaba	1.1	}, {
99			o => $o,
100			parent => $list->append_new_node
101			(type => '#element',
102			namespace_uri => $NS_XHTML1,
103			local_name => 'li'),
104	wakaba	1.2	ref__weight => $item->[1],
105	wakaba	1.1	});
106			}
107			}
108
109			Function:
110			@Name: add_referer
111			@Main:
112			my (undef, %opt) = @_;
113			return unless $opt{wiki}->{db};
114	wakaba	1.2	return unless $opt{uri};
115	wakaba	1.1	$opt{page} \|\|= $opt{wiki}->{var}->{page};
116			my $o = $opt{o} \|\| {wiki => $opt{wiki}};
117
118			## To be canonical URI reference object
119			unless (ref $opt{uri}) {
120			$opt{uri} = URI->new ($opt{uri})->canonical;
121			} else {
122			$opt{uri} = $opt{uri}->canonical;
123			}
124
125			local $o->{iwc__param} = {
126			uri_reference => $opt{uri},
127			};
128
129			## Check with site definition
130			my $site = $INTERWIKICORE->get_site_entry_by_uri_reference_match
131			(o => $o,
132			page => $opt{wiki}->{config}->{page}->{InterWikiName});
133			if ($site) {
134			my $v = 1;
135			my $check = $site->get_attribute_value
136			('RefererLog', default => '1');
137			try {
138			$v = $o->{wiki}->{plugin}
139			->boolean_formatter ('iwc__urireference_operation')
140			->replace ($check, param => $o);
141			} catch Message::Util::Formatter::error with {
142			my $err = shift;
143			if ($err->{-object}->{-category_name} eq 'iwc__urireference_operation') {
144			my $wiki = $err->{-option}->{param}->{wiki};
145			SuikaWiki::Plugin->module_package ('Error')
146			->reporting_formatting_template_error
147			($err, $err->{option}->{param}->{wiki},
148			template => $check);
149			} else {
150			$err->throw;
151			}
152			};
153			return unless $v;
154			}
155
156			## Update referer list
157			my %referer;
158			for (split /\x0A/, $opt{wiki}->{db}->get ('referer', $opt{page})) {
159			my ($n, $t) = split /\x09/, $_, 2;
160			$referer{$n} = $t + 0;
161			}
162			$referer{$o->{iwc__param}->{uri_reference}}++;
163			$opt{wiki}->{db}->set ('referer', $opt{page}
164			=> join "\x0A", map {$_ . "\x09" . $referer{$_}} keys %referer);
165
166			FormattingRule:
167			@Category[list]: link-to-resource
168			@Name: ref--referer-item-weight
169			@Formatting:
170			$p->{-parent}->append_text ($o->{link}->{option}->{ref__weight});
171
172			FormattingRule:
173			@Category[list]: link-to-resource
174			@Name: ref--referer-item-label
175	wakaba	1.2	@Description:
176			@@@:
177			Label for referer list item, that is taken from InterWikiName database.
178			@@lang: en
179	wakaba	1.1	@Formatting:
180	wakaba	1.2	try {
181			$f->replace ($o->{link}->{src}->{ref__label},
182			param => $o,
183			-parent => $p->{-parent});
184			} catch Message::Util::Formatter::error with {
185			my $err = shift;
186			if ($err->{-object}->{-category_name} eq $f->{-category_name}) {
187			my $wiki = $err->{option}->{param}->{wiki};
188			SuikaWiki::Plugin->module_package ('Error')
189			->reporting_formatting_template_error
190			($err, $wiki,
191			template => $o->{link}->{src}->{ref__label});
192			undef;
193			} else {
194			$err->throw;
195			}
196			};
197	wakaba	1.3
198			ViewFragment:
199			@Name: ws--post-content
200			@Description:
201			@@@: After content body -- referer lista
202			@@lang:en
203			@Order: 150
204			@Formatting:
205			%section (
206			id => referer,
207			title => {%res(name=>Referer);}p, heading,
208			content => {%referer-list;}p,
209			);
210	wakaba	1.1
211			Resource:
212			@Referer:RefererList:Label:
213			{%ref--referer-item-weight;} %ref--referer-item-label;
214			@Referer:URIReference2Label:
215			<%link-to-it (label => {%uri-reference;}p);>