]> CyberLeo.Net >> Repos - SourceForge/phpwiki.git/blob - lib/plugin/RecentChangesCached.php
Update PHP Doc; type compatibility
[SourceForge/phpwiki.git] / lib / plugin / RecentChangesCached.php
1 <?php
2
3 /**
4  * Copyright 1999, 2000, 2001, 2002 $ThePhpWikiProgrammingTeam
5  * Copyright (C) 2002 Johannes Große                                   |
6  *
7  * This file is part of PhpWiki.
8  *
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.
13  *
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.
18  *
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.
22  */
23
24 /* There is a bug in it:
25    When the cache is empty and you safe the wikipages,
26    an immediately created cached output of
27    RecentChanges will at the rss-image-link include
28    an action=edit
29 */
30
31 require_once 'lib/WikiPluginCached.php';
32 require_once 'lib/plugin/RecentChanges.php';
33
34 class WikiPlugin_RecentChangesCached
35     extends WikiPluginCached
36 {
37     function getPluginType()
38     {
39         return PLUGIN_CACHED_HTML;
40     }
41
42     function getDescription()
43     {
44         return 'Cache output of RecentChanges called with default arguments.';
45     }
46
47     function getDefaultArguments()
48     {
49         return WikiPlugin_RecentChanges::getDefaultArguments();
50     }
51
52     function getExpire($dbi, $argarray, $request)
53     {
54         return '+900'; // 15 minutes
55     }
56
57     // We don't go through pi parsing, instead we go directly to the
58     // better plugin methods.
59     /**
60      * @param WikiDB $dbi
61      * @param string $argstr
62      * @param WikiRequest $request
63      * @param string $basepage
64      * @return mixed
65      */
66     function getHtml($dbi, $args, $request, $basepage)
67     {
68         $plugin = new WikiPlugin_RecentChanges();
69         $changes = $plugin->getChanges($dbi, $args);
70         return $plugin->format($changes, $args);
71         /*
72         $loader = new WikiPluginLoader();
73         return $loader->expandPI('<?plugin RecentChanges '
74             . WikiPluginCached::glueArgs($argarray)
75                                  . ' ?>', $request, $this, $basepage);
76         */
77     }
78
79     // ->box is used to display a fixed-width, narrow version with common header.
80     // Just a limited list of pagenames, without date.
81     // This does not use ->run, to avoid pi construction and deconstruction
82     function box($args = '', $request = null, $basepage = '', $do_save = false)
83     {
84         if (!$request) $request =& $GLOBALS['request'];
85         if (!isset($args['limit'])) $args['limit'] = 12;
86         $args['format'] = 'box';
87         $args['show_minor'] = false;
88         $args['show_major'] = true;
89         $args['show_deleted'] = 'sometimes';
90         $args['show_all'] = false;
91         $args['days'] = 90;
92
93         $cache = $this->newCache();
94         if (is_array($args))
95             ksort($args);
96         $argscopy = $args;
97         unset($argscopy['limit']);
98         $this->_args =& $args;
99         $this->_type = $this->getPluginType();
100         $this->_static = false;
101
102         /* OLD: */
103         //list($id, $url) = $this->genUrl($cache, $args);
104
105         /* NEW: This cache entry needs an update on major changes.
106          * So we should rather use an unique ID, because there will only be
107          * one global cached box.
108          */
109         $id = $cache->generateId(serialize(array("RecentChangesCachedBox", $argscopy)));
110         $content = $cache->get($id, 'imagecache');
111         if ($do_save || !$content || !$content['html']) {
112             $this->resetError();
113             $plugin = new WikiPlugin_RecentChanges();
114             $title = WikiLink($this->getName(), '', SplitPagename($this->getName()));
115             $changes = $plugin->getChanges($request->_dbi, $args);
116             $content['html'] =
117                 $this->makeBox($title,
118                     $plugin->format($changes, $args));
119             if ($errortext = $this->getError()) {
120                 $this->printError($errortext, 'html');
121                 return HTML();
122             }
123             $do_save = true;
124         }
125         if ($do_save) {
126             $content['args'] = md5($this->_pi);
127             $expire = $this->getExpire($request->_dbi, $content['args'], $request);
128             $cache->save($id, $content, $expire, 'imagecache');
129         }
130         if ($content['html'])
131             return $content['html'];
132         return HTML();
133     }
134
135     // force box cache update on major changes.
136     function box_update($args = false, $request = false, $basepage = false)
137     {
138         $this->box($args, $request, $basepage, true);
139     }
140
141 }
142
143 // Local Variables:
144 // mode: php
145 // tab-width: 8
146 // c-basic-offset: 4
147 // c-hanging-comment-ender-p: nil
148 // indent-tabs-mode: nil
149 // End: