1<?php
2
3namespace dokuwiki\Ui;
4
5use dokuwiki\ChangeLog\PageChangeLog;
6use dokuwiki\ChangeLog\MediaChangeLog;
7use dokuwiki\Form\Form;
8
9/**
10 * DokuWiki Revisions Interface
11 *
12 * @package dokuwiki\Ui
13 */
14class Revisions extends Ui
15{
16    protected $first;
17    protected $media_id;
18
19    /**
20     * Revisions Ui constructor
21     *
22     * @param int $first  skip the first n changelog lines
23     * @param bool|string $media_id  id of media, or false for current page
24     */
25    public function __construct($first = 0, $media_id = false)
26    {
27        $this->first    = $first;
28        $this->media_id = $media_id;
29    }
30
31    /**
32     * Display list of old revisions
33     *
34     * @author Andreas Gohr <andi@splitbrain.org>
35     * @author Ben Coburn <btcoburn@silicodon.net>
36     * @author Kate Arzamastseva <pshns@ukr.net>
37     * @author Satoshi Sahara <sahara.satoshi@gmail.com>
38     *
39     * @return void
40     */
41    public function show()
42    {
43        global $ID;
44
45        if ($this->media_id) {
46            return $this->showMediaRevisions($this->media_id);
47        } else {
48            return $this->showPageRevisions($ID);
49        }
50    }
51
52    /**
53     * Display a list of Media Revisions in the MediaManager
54     *
55     * @param string $id  media id
56     * @return void
57     */
58    protected function showMediaRevisions($id)
59    {
60        global $lang;
61
62        // get revisions, and set correct pagenation parameters (first, hasNext)
63        $first   = $this->first;
64        $hasNext = false;
65        $revisions = $this->getRevisions($first, $hasNext);
66
67        // create the form
68        $form = new Form([
69                'id' => 'page__revisions', // must not be "media__revisions"
70                'action' => media_managerURL(['image' => $id], '&'),
71                'class'  => 'changes',
72        ]);
73        $form->setHiddenField('mediado', 'diff'); // required for media revisions
74        $form->addTagOpen('div')->addClass('no');
75
76        // start listing
77        $form->addTagOpen('ul');
78        foreach ($revisions as $info) {
79            $rev = $info['date'];
80            $class = ($info['type'] === DOKU_CHANGE_TYPE_MINOR_EDIT) ? 'minor' : '';
81            $form->addTagOpen('li')->addClass($class);
82            $form->addTagOpen('div')->addClass('li');
83
84            if (isset($info['current'])) {
85               $form->addCheckbox('rev2[]')->val('current');
86            } elseif (file_exists(mediaFN($id, $rev))) {
87                $form->addCheckbox('rev2[]')->val($rev);
88            } else {
89                $form->addCheckbox('')->val($rev)->attr('disabled','disabled');
90            }
91            $form->addHTML(' ');
92
93            $objRevInfo = $this->getObjRevInfo($info);
94            $html = implode(' ', [
95                $objRevInfo->editDate(),          // edit date and time
96                $objRevInfo->difflink(),          // link to diffview icon
97                $objRevInfo->itemName(),          // name of page or media
98                '<div>',
99                $objRevInfo->editSummary(),       // edit summary
100                $objRevInfo->editor(),            // editor info
101                html_sizechange($info['sizechange']), // size change indicator
102                $objRevInfo->currentIndicator(),  // current indicator (only when k=1)
103                '</div>',
104            ]);
105            $form->addHTML($html);
106
107            $form->addTagClose('div');
108            $form->addTagClose('li');
109        }
110        $form->addTagClose('ul');  // end of revision list
111
112        // show button for diff view
113        $form->addButton('do[diff]', $lang['diff2'])->attr('type', 'submit');
114
115        $form->addTagClose('div'); // close div class=no
116
117        print $form->toHTML('Revisions');
118
119        // provide navigation for pagenated revision list (of pages and/or media files)
120        print $this->htmlNavigation($id, $first, $hasNext);
121    }
122
123    /**
124     * Display a list of Page Revisions
125     *
126     * @return void
127     */
128    protected function showPageRevisions($id)
129    {
130        global $lang;
131
132        // get revisions, and set correct pagenation parameters (first, hasNext)
133        $first   = $this->first;
134        $hasNext = false;
135        $revisions = $this->getRevisions($first, $hasNext);
136
137        // print intro
138        print p_locale_xhtml('revisions');
139
140        // create the form
141        $form = new Form([
142                'id' => 'page__revisions',
143                'class' => 'changes',
144        ]);
145        $form->addTagOpen('div')->addClass('no');
146
147        // start listing
148        $form->addTagOpen('ul');
149        foreach ($revisions as $info) {
150            $rev = $info['date'];
151            $class = ($info['type'] === DOKU_CHANGE_TYPE_MINOR_EDIT) ? 'minor' : '';
152            $form->addTagOpen('li')->addClass($class);
153            $form->addTagOpen('div')->addClass('li');
154
155            if (page_exists($id, $rev)) {
156                $form->addCheckbox('rev2[]')->val($rev);
157            } else {
158                $form->addCheckbox('')->val($rev)->attr('disabled','disabled');
159            }
160            $form->addHTML(' ');
161
162            $objRevInfo = $this->getObjRevInfo($info);
163            $html = implode(' ', [
164                $objRevInfo->editDate(),          // edit date and time
165                $objRevInfo->difflink(),          // link to diffview icon
166                $objRevInfo->itemName(),          // name of page or media
167                $objRevInfo->editSummary(),       // edit summary
168                $objRevInfo->editor(),            // editor info
169                $objRevInfo->sizechange(),        // size change indicator
170                $objRevInfo->currentIndicator(),  // current indicator (only when k=1)
171            ]);
172            $form->addHTML($html);
173            $form->addTagClose('div');
174            $form->addTagClose('li');
175        }
176        $form->addTagClose('ul');  // end of revision list
177
178        // show button for diff view
179        $form->addButton('do[diff]', $lang['diff2'])->attr('type', 'submit');
180
181        $form->addTagClose('div'); // close div class=no
182
183        print $form->toHTML('Revisions');
184
185        // provide navigation for pagenated revision list (of pages and/or media files)
186        print $this->htmlNavigation($id, $first, $hasNext);
187    }
188
189
190    /**
191     * Get revisions, and set correct pagenation parameters (first, hasNext)
192     *
193     * @param int  $first
194     * @param bool $hasNext
195     * @return array  revisions to be shown in a pagenated list
196     * @see also https://www.dokuwiki.org/devel:changelog
197     */
198    protected function getRevisions(&$first, &$hasNext)
199    {
200        global $INFO, $conf;
201
202        if ($this->media_id) {
203            $changelog = new MediaChangeLog($this->media_id);
204        } else {
205            $changelog = new PageChangeLog($INFO['id']);
206        }
207
208        $revisions = [];
209
210        /* we need to get one additional log entry to be able to
211         * decide if this is the last page or is there another one.
212         * see also Ui\Recent::getRecents()
213         */
214        $revlist = $changelog->getRevisions($first, $conf['recent'] +1);
215        if (count($revlist) == 0 && $first != 0) {
216            $first = 0;
217            $revlist = $changelog->getRevisions($first, $conf['recent'] +1);
218        }
219        $exists = ($this->media_id) ? file_exists(mediaFN($this->media_id)) : $INFO['exists'];
220        if ($first === 0 && $exists) {
221            // add current page or media as revision[0]
222            if ($this->media_id) {
223                $rev = filemtime(fullpath(mediaFN($this->media_id)));
224                $changelog->setChunkSize(1024);
225                $revinfo = $changelog->getRevisionInfo($rev) ?: array(
226                        'date' => $rev,
227                        'ip'   => null,
228                        'type' => null,
229                        'id'   => $this->media_id,
230                        'user' => null,
231                        'sum'  => null,
232                        'extra' => null,
233                        'sizechange' => null,
234                );
235                $revisions[] = $revinfo + array(
236                        'media' => true,
237                        'current' => true,
238                );
239            } else {
240                if (isset($INFO['meta']['last_change'])) {
241                    $type = $INFO['meta']['last_change']['type'];
242                    $sizechange = $INFO['meta']['last_change']['sizechange'];
243                } else {
244                    $type = $sizechange = null;
245                }
246
247                $revisions[] = array(
248                        'date' => $INFO['lastmod'],
249                        'ip'   => null,
250                        'type' => $type,
251                        'id'   => $INFO['id'],
252                        'user' => $INFO['editor'],
253                        'sum'  => $INFO['sum'],
254                        'extra' => null,
255                        'sizechange' => $sizechange,
256                        'current' => true,
257                );
258            }
259        }
260
261        // decide if this is the last page or is there another one
262        $hasNext = false;
263        if (count($revlist) > $conf['recent']) {
264            $hasNext = true;
265            array_pop($revlist); // remove one additional log entry
266        }
267
268        // append each revison info array to the revisions
269        foreach ($revlist as $rev) {
270            if ($this->media_id) {
271                $revisions[] = $changelog->getRevisionInfo($rev) + array('media' => true);
272            } else {
273                $revisions[] = $changelog->getRevisionInfo($rev);
274            }
275        }
276        return $revisions;
277    }
278
279    /**
280     * Navigation buttons for Pagenation (prev/next)
281     *
282     * @param string $id  page id or media id
283     * @param int  $first
284     * @param bool $hasNext
285     * @return array  html
286     */
287    protected function htmlNavigation($id, $first, $hasNext)
288    {
289        global $conf;
290
291        $html = '<div class="pagenav">';
292        $last = $first + $conf['recent'];
293        if ($first > 0) {
294            $first = max($first - $conf['recent'], 0);
295            $html.= '<div class="pagenav-prev">';
296            if ($this->media_id) {
297                $html.= html_btn('newer', $id, "p", media_managerURL(['first' => $first], '&', false, true));
298            } else {
299                $html.= html_btn('newer', $id, "p" ,['do' => 'revisions', 'first' => $first]);
300            }
301            $html.= '</div>';
302        }
303        if ($hasNext) {
304            $html.= '<div class="pagenav-next">';
305            if ($this->media_id) {
306                $html.= html_btn('older', $id, "n", media_managerURL(['first' => $last], '&', false, true));
307            } else {
308                $html.= html_btn('older', $id, "n", ['do' => 'revisions', 'first' => $last]);
309            }
310            $html.= '</div>';
311        }
312        $html.= '</div>';
313        return $html;
314    }
315
316    /**
317     * Returns instance of objRevInfo
318     *
319     * @param array $info  Revision info structure of a page or media file
320     * @return objRevInfo object (anonymous class)
321     */
322    protected function getObjRevInfo(array $info)
323    {
324        return new class ($info) // anonymous class (objRevInfo)
325        {
326            protected $info;
327
328            public function __construct(array $info)
329            {
330                if (!isset($info['current'])) {
331                    $info['current'] = false;
332                }
333                $this->info = $info;
334            }
335
336            // current indicator
337            public function currentIndicator()
338            {
339                global $lang;
340                return ($this->info['current']) ? '('.$lang['current'].')' : '';
341            }
342
343            // edit date and time of the page or media file
344            public function editDate()
345            {
346                return '<span class="date">'. dformat($this->info['date']) .'</span>';
347            }
348
349            // edit summary
350            public function editSummary()
351            {
352                return '<span class="sum">'.' – '. hsc($this->info['sum']).'</span>';
353            }
354
355            // editor of the page or media file
356            public function editor()
357            {
358                // slightly different with display of Ui\Recent, i.e. external edit
359                global $lang;
360                $html = '<span class="user">';
361                if (!$this->info['user'] && !$this->info['ip']) {
362                    $html.= '('.$lang['external_edit'].')';
363                } elseif ($this->info['user']) {
364                    $html.= '<bdi>'. editorinfo($this->info['user']) .'</bdi>';
365                    if (auth_ismanager()) $html.= ' <bdo dir="ltr">('. $this->info['ip'] .')</bdo>';
366                } else {
367                    $html.= '<bdo dir="ltr">'. $this->info['ip'] .'</bdo>';
368                }
369                $html.= '</span>';
370                return $html;
371            }
372
373            // name of the page or media file
374            public function itemName()
375            {
376                // slightly different with display of Ui\Recent, i.e. revison may not exists
377                $id = $this->info['id'];
378                $rev = $this->info['date'];
379
380                if (isset($this->info['media'])) {
381                    // media file revision
382                    if (isset($this->info['current'])) {
383                        $href = media_managerURL(['image'=> $id, 'tab_details'=> 'view'], '&');
384                        $html = '<a href="'.$href.'" class="wikilink1">'.$id.'</a>';
385                    } elseif (file_exists(mediaFN($id, $rev))) {
386                        $href = media_managerURL(['image'=> $id, 'tab_details'=> 'view', 'rev'=> $rev], '&');
387                        $html = '<a href="'.$href.'" class="wikilink1">'.$id.'</a>';
388                    } else {
389                        $html = $id;
390                    }
391                    return $html;
392                } else {
393                    // page revision
394                    $display_name = useHeading('navigation') ? hsc(p_get_first_heading($id)) : $id;
395                    if (!$display_name) $display_name = $id;
396                    if ($this->info['current'] || page_exists($id, $rev)) {
397                        $href = wl($id, "rev=$rev", false, '&');
398                        $html = '<a href="'.$href.'" class="wikilink1">'.$display_name.'</a>';
399                    } else {
400                        $html = $display_name;
401                    }
402                    return $html;
403                }
404            }
405
406            // icon difflink
407            public function difflink()
408            {
409                global $lang;
410                $id = $this->info['id'];
411                $rev = $this->info['date'];
412
413                if (isset($this->info['media'])) {
414                    // media file revision
415                    if (isset($this->info['current']) || !file_exists(mediaFN($id, $rev))) {
416                        $html = '<img src="'.DOKU_BASE.'lib/images/blank.gif" width="15" height="11" alt="" />';
417                    } else {
418                        $href = media_managerURL(['image'=> $id, 'rev'=> $rev, 'mediado'=>'diff'], '&');
419                        $html = '<a href="'.$href.'" class="diff_link">'
420                              . '<img src="'.DOKU_BASE.'lib/images/diff.png" width="15" height="11"'
421                              . ' title="'. $lang['diff'] .'" alt="'.$lang['diff'] .'" />'
422                              . '</a> ';
423                    }
424                    return $html;
425                } else {
426                    // page revision
427                    if ($this->info['current'] || !page_exists($id, $rev)) {
428                        $html = '<img src="'.DOKU_BASE.'lib/images/blank.gif" width="15" height="11" alt="" />';
429                    } else {
430                        $href = wl($id, "rev=$rev,do=diff", false, '&');
431                        $html = '<a href="'.$href.'" class="diff_link">'
432                              . '<img src="'.DOKU_BASE.'lib/images/diff.png" width="15" height="11"'
433                              . ' title="'.$lang['diff'].'" alt="'.$lang['diff'].'" />'
434                              . '</a>';
435                    }
436                    return $html;
437                }
438            }
439
440            // size change
441            public function sizeChange()
442            {
443                $class = 'sizechange';
444                $value = filesize_h(abs($this->info['sizechange']));
445                if ($this->info['sizechange'] > 0) {
446                    $class .= ' positive';
447                    $value = '+' . $value;
448                } elseif ($this->info['sizechange'] < 0) {
449                    $class .= ' negative';
450                    $value = '-' . $value;
451                } else {
452                    $value = '±' . $value;
453                }
454                return '<span class="'.$class.'">'.$value.'</span>';
455            }
456        }; // end of anonymous class (objRevInfo)
457    }
458
459}
460