2 // $Id: PageGroup.php 8212 2011-12-16 13:26:15Z vargenau $
4 * Copyright 1999,2000,2001,2002,2004 $ThePhpWikiProgrammingTeam
5 * Copyright 2009 Marc-Etienne Vargenau, Alcatel-Lucent
7 * This file is part of PhpWiki.
9 * PhpWiki is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * PhpWiki is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License along
20 * with PhpWiki; if not, write to the Free Software Foundation, Inc.,
21 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
27 * <<PageGroup parent=MyTableOfContents >>
30 * parent=MyTableOfContents
31 * label="Visit more pages in MyTableOfContents"
34 * <<PageGroup parent=MyTableOfContents section=PartTwo loop=true >>
36 * <<PageGroup parent=MyTableOfContents loop=1 >>
39 * Updated to use new HTML(). It mostly works, but it's still a giant hackish mess.
41 class WikiPlugin_PageGroup
45 return _("PageGroup");
48 function getDescription() {
49 return sprintf(_("PageGroup for %s"),'[pagename]');
52 function getDefaultArguments() {
56 'section' => _("Contents"),
62 // Stolen from IncludePage.php
63 function extractGroupSection ($section, $content, $page) {
64 $qsection = preg_replace('/\s+/', '\s+', preg_quote($section, '/'));
65 if (preg_match("/ ^(!{1,})\\s*$qsection" // section header
66 . " \\s*$\\n?" // possible blank lines
67 . " ( (?: ^.*\\n? )*? )" // some lines
68 . " (?= ^\\1 | \\Z)/xm", // sec header (same or higher level) (or EOF)
69 implode("\n", $content),
72 //FIXME: return list of Wiki_Pagename objects
73 foreach (explode("\n", $match[2]) as $line) {
75 // Strip trailing blanks lines and ---- <hr>s
76 $text = preg_replace("/\\s*^-{4,}\\s*$/", "", $text);
77 // Strip leading list chars: * or #
78 $text = preg_replace("/^[\*#]+\s*(\S.+)$/", "\\1", $text);
79 // Strip surrounding []
80 // FIXME: parse [ name | link ]
81 $text = preg_replace("/^\[\s*(\S.+)\s*\]$/", "\\1", $text);
87 return array(sprintf(_("<%s: no such section>"), $page ." ". $section));
90 function run($dbi, $argstr, &$request, $basepage) {
92 $args = $this->getArgs($argstr, $request);
95 return $this->error(sprintf(_("A required argument '%s' is missing."), 'parent'));
97 $directions = array ('next' => _("Next"),
98 'previous' => _("Previous"),
99 'contents' => _("Contents"),
100 'first' => _("First"),
105 $sep = $WikiTheme->getButtonSeparator();
107 $sep = " | "; // force some kind of separator
111 $label = $WikiTheme->makeLinkButton($parent);
113 // This is where the list extraction occurs from the named
114 // $section on the $parent page.
116 $p = $dbi->getPage($parent);
118 $r = $p->getRevision($rev);
119 if ((!$r) || ($r->hasDefaultContents())) {
120 return $this->error(sprintf(_("%s: no such revision %d."),
124 $r = $p->getCurrentRevision();
127 $c = $r->getContent();
128 $c = $this->extractGroupSection($section, $c, $parent);
130 $pagename = $request->getArg('pagename');
132 // The ordered list of page names determines the page
133 // ordering. Right now it doesn't work with a WikiList, only
134 // normal lines of text containing the page names.
136 $thispage = array_search($pagename, $c);
138 $go = array ('previous','next');
140 $links->pushcontent($label);
141 $links->pushcontent(" [ "); // an experiment
142 $lastindex = count($c) - 1; // array is 0-based, count is 1-based!
144 foreach ( $go as $go_item ) {
145 //yuck this smells, needs optimization.
146 if ($go_item == 'previous') {
148 if ($thispage == 0) {
149 $linkpage = $c[$lastindex];
151 $linkpage = $c[$thispage - 1];
153 // mind the French : punctuation
154 $text = fmt("%s: %s", $directions[$go_item],
155 $WikiTheme->makeLinkButton($linkpage));
156 $links->pushcontent($text);
157 $links->pushcontent($sep); // this works because
158 // there are only 2 go
159 // items, previous,next
161 if ($thispage == 0) {
164 $linkpage = $c[$thispage - 1];
165 $text = fmt("%s: %s", $directions[$go_item],
166 $WikiTheme->makeLinkButton($linkpage));
167 $links->pushcontent($text);
168 $links->pushcontent($sep); //this works
174 } elseif ($go_item == 'next') {
176 if ($thispage == $lastindex) {
179 $linkpage = $c[$thispage + 1];
181 $text = fmt("%s: %s", $directions[$go_item],
182 $WikiTheme->makeLinkButton($linkpage));
184 if ($thispage == $lastindex) {
187 $linkpage = $c[$thispage + 1];
188 $text = fmt("%s: %s", $directions[$go_item],
189 $WikiTheme->makeLinkButton($linkpage));
192 $links->pushcontent($text);
195 $links->pushcontent(" ] "); // an experiment
204 // c-hanging-comment-ender-p: nil
205 // indent-tabs-mode: nil