1<?php
2/**
3 * Search with Scopes
4 *
5 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
6 * @author     i-net software <tools@inetsoftware.de>
7 * @author     Gerry Weissbach <gweissbach@inetsoftware.de>
8 */
9
10// must be run within Dokuwiki
11if (!defined('DOKU_INC')) die();
12if (!defined('DOKU_PLUGIN')) define('DOKU_PLUGIN', DOKU_INC . 'lib/plugins/');
13
14use dokuwiki\File\PageResolver;
15
16class syntax_plugin_siteexport_toc extends DokuWiki_Syntax_Plugin {
17
18    private $insideToc = false;
19    private $savedToc = array();
20    private $options = array();
21
22    private $mergedPages = array();
23    private $includedPages = array();
24    private $merghintIds = array();
25    private $mergeHints = array();
26
27    public function getType() { return 'protected'; }
28    public function getPType() { return 'block'; }
29    public function getAllowedTypes() { return array('container'); }
30    public function getSort() { return 100; }
31
32    /**
33     * Connect pattern to lexer
34     */
35    public function connectTo($mode) {
36        $this->Lexer->addEntryPattern('<toc>(?=.*?</toc>)', $mode, 'plugin_siteexport_toc');
37        $this->Lexer->addEntryPattern('<toc .+?>(?=.*?</toc>)', $mode, 'plugin_siteexport_toc');
38        $this->Lexer->addSpecialPattern("\[\[.+?\]\]", $mode, 'plugin_siteexport_toc');
39    }
40
41    public function postConnect() {
42        $this->Lexer->addExitPattern('</toc.*?>', 'plugin_siteexport_toc');
43    }
44
45    public function handle($match, $state, $pos, Doku_Handler $handler) {
46        global $ID, $INFO;
47
48        switch ($state) {
49            case DOKU_LEXER_ENTER:
50
51                $this->insideToc = true;
52                $this->options = explode(' ', substr($match, 5, -1)?:"");
53                return array('start' => true, 'pos' => $pos, 'options' => $this->options);
54
55            case DOKU_LEXER_SPECIAL:
56
57                if ($this->insideToc) {
58
59                    $link = preg_replace(array('/^\[\[/', '/\]\]$/u'), '', $match);
60                    // Split title from URL
61                    $link = explode('|', $link, 2);
62                    if (!isset($link[1])) {
63                        $link[1] = NULL;
64                    } else if (preg_match('/^\{\{[^\}]+\}\}$/', $link[1])) {
65                        // If the title is an image, convert it to an array containing the image details
66                        $link[1] = Doku_Handler_Parse_Media($link[1]);
67                    }
68                    $link[0] = trim($link[0]);
69
70                    if (!(preg_match('/^[a-zA-Z0-9\.]+>{1}.*$/u', $link[0]) ||
71                    preg_match('/^\\\\\\\\[\w.:?\-;,]+?\\\\/u', $link[0]) ||
72                    preg_match('#^([a-z0-9\-\.+]+?)://#i', $link[0]) ||
73                    preg_match('<' . PREG_PATTERN_VALID_EMAIL . '>', $link[0]) ||
74                    preg_match('!^#.+!', $link[0]))
75                    ) {
76
77                        // Get current depth from call stack
78                        $depth = 1;
79                        if ( isset( $handler->CallWriter ) && $handler->CallWriter instanceof Doku_Handler_List ) {
80
81                            $calls = array_reverse($handler->CallWriter->calls);
82                            $call = $calls[0];
83                            foreach ($calls as $item) {
84                                if (in_array($item[0], array('list_item', 'list_open'))) { $call = $item; break; }
85                            }
86
87                            $listType = null;
88                            $depth = $handler->CallWriter->interpretSyntax($call[1][0], $listType)-1; // Minus one because of plus one inside the interpret function
89                        }
90
91                        if (empty($link[0])) { break; } // No empty elements. This would lead to problems
92                        return array($link[0], $link[1], $depth);
93                    } else {
94                        // use parser! - but with another p
95                        $handler->internallink($match, $state, $pos);
96                    }
97                } else {
98                    // use parser!
99                    $handler->internallink($match, $state, $pos);
100                }
101
102                return false;
103            case DOKU_LEXER_UNMATCHED:
104
105                $handler->addCall('cdata', array($match), $pos);
106
107                return false;
108            case DOKU_LEXER_EXIT:
109
110                $this->insideToc = false;
111                return 'save__meta';
112        }
113        return false;
114    }
115
116    public function render($mode, Doku_Renderer $renderer, $data) {
117        global $ID, $lang, $INFO;
118
119        list($SID, $NAME, $DEPTH) = $data;
120
121        $exists = page_exists( (new PageResolver( $ID ))->resolveId($SID) );
122
123//        $SID = cleanID($SID); // hier kein cleanID, da sonst moeglicherweise der anker verloren geht
124
125        //    Render XHTML and ODT
126        if ($mode != 'metadata' ) {
127
128            // TOC Title
129            if (is_array($data) && $data['start'] == true) {
130
131                if (is_Array($data['options'])) {
132                    foreach ($data['options'] as $opt) {
133                        switch ($opt) {
134                            case 'description' : $renderer->meta['sitetoc']['showDescription'] = true; break;
135                            case 'notoc' : $renderer->meta['sitetoc']['noTOC'] = true; break;
136                            case 'merge' : $renderer->meta['sitetoc']['mergeDoc'] = true; break;
137                            case 'nohead' : $renderer->meta['sitetoc']['noTocHeader'] = true; break;
138                            case 'mergeheader' : $renderer->meta['sitetoc']['mergeHeader'] = true; break;
139                            case 'pagebreak' : $renderer->meta['sitetoc']['pagebreak'] = true; break;
140                            case 'mergehint' : $renderer->meta['sitetoc']['mergehint'] = true; break;
141                        }
142                    }
143                }
144
145                $renderer->section_open("1 sitetoc");
146                if ($renderer->meta['sitetoc']['noTocHeader'] === false) {
147                    $renderer->header($lang['toc'], 1, $data['pos']);
148                }
149
150                return true;
151            } else
152
153            // All Output has been done
154            if (!is_array($data) && $data == 'save__meta') {
155
156                // Close TOC
157                $renderer->section_close();
158
159                if ($renderer->meta['sitetoc']['noTOC'] === true) {
160                    $renderer->doc = preg_replace("/<div.*?sitetoc.*?$/si", "", $renderer->doc);
161                }
162
163                // If this is not set, we may have it as Metadata
164                if (empty($this->mergedPages) && $renderer->meta['sitetoc']['mergeDoc']) {
165                    $toc = $renderer->meta['sitetoc']['siteexportTOC'];
166
167                    if (is_array($toc)) {
168                        foreach ($toc as $tocItem) {
169                            $this->mergedPages[] = array($tocItem['id'], $tocItem['depth']);
170                        }
171                    }
172
173                }
174
175                // If there is some data to be merged
176                if (count($this->mergedPages) > 0) {
177
178                    $renderer->doc = ''; // Start fresh!
179
180                    $renderer->section_open("1 mergedsite" . ($renderer->meta['sitetoc']['mergehint'] && count($this->mergedPages) > 1 ? ' mergehint' : ''));
181
182                    // Prepare lookup Array
183                    foreach ($this->mergedPages as $tocItem) {
184                        list($this->includedPages[]) = explode('#', $tocItem[0]);
185                    }
186
187                    // Load the instructions
188                    $instr = array();
189                    foreach ($this->mergedPages as $tocElement) {
190
191                        list($tocItem, $depth) = $tocElement;
192                        $file = wikiFN($tocItem);
193
194                        if (@file_exists($file)) {
195                            $instructions = p_cached_instructions($file, false, $tocItem);
196                        } else {
197                            $instructions = p_get_instructions(io_readWikiPage($file, $tocItem));
198                        }
199
200                        // Convert Link and header instructions
201                        $instructions = $this->_convertInstructions($instructions, $addID = null, $renderer, $depth);
202
203                        if ($renderer->meta['sitetoc']['mergeHeader'] && count($this->mergedPages) > 1) {
204                            // get a hint for merged pages
205                            if ($renderer->meta['sitetoc']['mergehint']) {
206                                // only if the first section is already there
207                                $mergeHint = p_get_metadata($tocItem, 'mergehint', METADATA_RENDER_USING_SIMPLE_CACHE);
208                                if (empty($mergeHint)) { $mergeHint = p_get_metadata($tocItem, 'thema', METADATA_RENDER_USING_SIMPLE_CACHE); }
209                                if (empty($mergeHint)) { $mergeHint = tpl_pagetitle($tocItem, true); }
210                                $instructions = $this->_mergeWithHeaders($this->_initialHeaderStructure($instructions), $instructions, 1, $mergeHint);
211                            }
212                            // Merge
213                            $instr = $this->_mergeWithHeaders($instr, $instructions, 1);
214
215                        } else
216                        if ($renderer->meta['sitetoc']['pagebreak']) {
217                            $sitepagebreak = array(array(
218                                'plugin',
219                                array(
220                                    'siteexport_toctools',
221                                    array(
222                                        'pagebreak',
223                                        null,
224                                        null
225                                    )
226                                )
227                            ));
228                            $instr = array_merge($instr, $instructions, $sitepagebreak);
229                        } else {
230                            // Concat
231                            $instr = array_merge($instr, $instructions);
232                        }
233                    }
234
235                    if (!empty($instr)) {
236                        if ( $this->_cleanAllInstructions($instr, true) ) {
237                            // There are no toc elements, remove the mergesite mergehint
238                            $renderer->doc = preg_replace( '/(class=".*?\s)mergedsite/', '\1', $renderer->doc );
239                            $renderer->doc = preg_replace( '/(class=".*?\s)mergehint/', '\1', $renderer->doc );
240                        }
241
242                        // print "<pre>"; print_r($instr); print "</pre>";
243                        $this->_render_output($renderer, $mode, $instr);
244                    }
245
246                    $renderer->section_close();
247                }
248                return true;
249            }
250
251            // Save the current ID
252            $LNID = $SID;
253
254            // Add ID to flags['mergeDoc']
255            if ($renderer->meta['sitetoc']['mergeDoc'] === true) { // || (count($renderer->meta['sitetoc']['siteexportTOC']) > 0 && $renderer->meta['sitetoc']['siteexportMergeDoc'] === true) ) {
256                $this->mergedPages[] = array($SID, $DEPTH);
257                $SID = (new PageResolver( $ID ))->resolveId($SID);
258                $exists = page_exists( $SID );
259            } else {
260                // // print normal internal link (XHTML odt)
261                $renderer->internallink($LNID, $NAME, null);
262
263                // Display Description underneath
264                if ($renderer->meta['sitetoc']['showDescription'] === true) {
265                    $renderer->cdata(p_get_metadata($SID, 'description abstract', true));
266                }
267            }
268
269            // Render Metadata
270        } else if ($mode == 'metadata') {
271            if (!is_array($data) && $data == 'save__meta') {
272                $renderer->meta['sitetoc']['siteexportTOC'] = $this->savedToc;
273
274                foreach ($this->savedToc as $page) {
275                    $renderer->meta['relation']['references'][$page['id']] = $page['exists'];
276                }
277
278                $this->savedToc = array();
279            } else if (!isset($data['start']) && !isset($data['pos'])) {
280                $this->savedToc[] = $this->__addTocItem($SID, $NAME, $DEPTH, $renderer);
281            }
282        }
283
284        return true;
285    }
286
287    /*
288     * pull apart the ID and create an Entry for the TOC
289     */
290    private function __addTocItem($id, $name, $depth, $renderer) {
291        global $conf;
292        global $ID;
293
294        $exists = false; $isImage = false; $linktype = null;
295        $id = (new PageResolver( $ID ) )->resolveId($id);
296        $exists = page_exists( $id );
297        $name = $renderer->_getLinkTitle($name, $default, $isImage, $id, $linktype);
298
299        // Render Title
300        $default = $renderer->_simpleTitle($id);
301
302        //keep hash anchor
303        list($id, $hash) = explode('#', $id, 2);
304        if (!empty($hash)) $hash = $renderer->_headerToLink($hash);
305
306        // Build Sitetoc Item
307        $item = array();
308        $item['id'] = $id;
309        $item['name'] = $name;
310        $item['anchor'] = $hash;
311        $item['depth'] = $depth;
312        $item['exists'] = $exists;
313        if (!$conf['skipacl'] && auth_quickaclcheck($item['id']) < AUTH_READ) {
314            return false;
315        }
316
317        return $item;
318    }
319
320    /*
321     * Render the output of one page
322     */
323    private function _render_output($renderer, $mode, $instr) {
324        global $ID;
325
326        // Section IDs
327        // $addID = sectionID($addID, $check);    //not possible to use a:b:c for id
328
329        if ($mode == 'xhtml') {
330
331            //--------RENDER
332            //renderer information(TOC build / Cache used)
333            $info = array();
334            $content = p_render($mode, $instr, $info);
335
336            //Remove TOC`s, section edit buttons and tags
337            $content = $this->_cleanXHTML($content);
338
339            // embed the included page
340            // $renderer->doc .= '<div class="include">';
341            //add an anchor to find start of a inserted page
342            // $renderer->doc .= "<a name='$addID' id='$addID'>";
343            $renderer->doc .= $content;
344            // $renderer->doc .= '</div>';
345        } else {
346
347            // Loop through the instructions
348            foreach ($instr as $instruction) {
349                // Execute the callback against the Renderer
350                call_user_func_array(array($renderer, $instruction[0]), $instruction[1]);
351            }
352        }
353    }
354
355    /*
356     * Corrects relative internal links and media and
357     * converts headers of included pages to subheaders of the current page
358     */
359    private function _convertInstructions($instr, $id, &$renderer, $depth = 1) {
360        global $ID;
361        global $conf;
362
363        $n = count($instr);
364
365        for ($i = 0; $i < $n; $i++) {
366            //internal links(links inside this wiki) an relative links
367            if ((substr($instr[$i][0], 0, 12) == 'internallink')) {
368                $this->_convert_link($renderer, $instr[$i], $id);
369            }
370            else if ((substr($instr[$i][0], 0, 13) == 'internalmedia')) {
371                $this->_convert_media($renderer, $instr[$i], $id);
372            }
373            else if ((substr($instr[$i][0], 0, 6) == 'header')) {
374                $this->_convert_header($renderer, $instr[$i], $depth-1); // -1 because the depth starts at 1
375            }
376            else if ((substr($instr[$i][0], 0, 12) == 'section_open')) {
377                $this->_convert_section($renderer, $instr[$i], $depth-1); // -1 because the depth starts at 1
378            }
379        }
380
381        //if its the document start, cut off the first element(document information)
382        if ($instr[0][0] == 'document_start')
383        return array_slice($instr, 1, -1);
384        else
385        return $instr;
386    }
387
388    /*
389     * Convert link of given instruction
390     */
391    private function _convert_link(&$renderer, &$instr, $id) {
392        global $ID;
393
394        $exists = false;
395
396        resolve_pageid(getNS($id), $instr[1][0], $exists);
397        list($pageID, $pageReference) = explode("#", $instr[1][0], 2);
398
399        if (in_array($pageID, $this->includedPages)) {
400            // Crate new internal Links
401            $check = null;
402
403            // Either get existing reference or create from first heading. If still not there take the alternate ID
404            $pageNameLink = empty($pageReference) ? sectionID($pageID, $check) : $pageReference;
405
406            $instr[1][0] = $ID . "#" . $pageNameLink;
407
408        } else {
409            // Convert external Links to plain Text
410
411            $instr = array(
412                        "cdata",
413            array($instr[1][1]),
414            $instr[2]
415            );
416        }
417    }
418
419    /*
420     * Convert internalmedia of given instruction
421     */
422    private function _convert_media(&$renderer, &$instr, $id) {
423        global $ID;
424
425        // Resolvemedia returns the absolute path to media by reference
426        $exists = false;
427        resolve_mediaid(getNS($id), $instr[1][0], $exists);
428    }
429
430    /**
431     * @param integer $depth
432     */
433    private function _convert_header(&$renderer, &$instr, $depth) {
434        // More Depth!
435        $instr[1][1] += $depth;
436    }
437
438    /**
439     * @param integer $depth
440     */
441    private function _convert_section(&$renderer, &$instr, $depth) {
442        // More Depth!
443        $instr[1][0] += $depth;
444    }
445
446    private function _mergeWithHeaders($existing, $newInstructions, $level = 1, $mergeHint = array()) {
447
448        $returnInstructions = array();
449        $preparedInstructions = array();
450        $existingStart = $existingEnd = 0;
451        $firstRun = true;
452
453        while ($this->_findNextHeaderSection($existing, $level, $existingStart, $existingEnd)) {
454
455            if ($firstRun) {
456                $returnInstructions = array_merge($returnInstructions, array_slice($existing, 0, $existingStart));
457                $firstRun = false;
458            }
459
460            $currentSlice = array_slice($existing, $existingStart, $existingEnd-$existingStart);
461
462            // Find matching part with headername
463            $newStart = $newEnd = 0;
464            if ($this->_findNextHeaderSection($newInstructions, $level, $newStart, $newEnd, $currentSlice[0][1][0])) {
465
466                $newSlice = array_slice($newInstructions, $newStart, $newEnd-$newStart);
467                if ($newSlice[0][0] == 'header')
468                    array_shift($newSlice); // Remove Heading
469
470                // merge found parts on next level.
471                $returnedInstructions = $this->_mergeWithHeaders($currentSlice, $newSlice, $level+1, $mergeHint);
472
473                // Put them at the end!
474                $preparedInstructions = array_merge($preparedInstructions, $returnedInstructions);
475
476                // Remove from input
477                array_splice($newInstructions, $newStart, $newEnd-$newStart);
478            } else {
479                // Nothing else found
480                $preparedInstructions = array_merge($preparedInstructions, $currentSlice);
481            }
482
483            $existingStart = $existingEnd;
484        }
485
486        // Append the rest
487        $returnInstructions = array_merge($returnInstructions, array_slice($existing, $existingStart));
488
489        // Check for section close inconsistencies and put one at the very end ...
490        $section_postpend = array();
491        if (
492            (
493                ($tmp1 = array_slice($newInstructions, -1))
494                && ($tmp1[0][0] == 'section_close')
495            )
496            &&
497            (
498                ($tmp2 = array_slice($newInstructions, -2))
499                && ($tmp2[0][0] == 'section_close')
500            )
501        ) {
502            $section_postpend = array_splice($newInstructions, -1);
503        }
504        if (
505            (
506                ($tmp3 = array_slice($returnInstructions, -1))
507                && ($tmp3[0][0] == 'section_close')
508            )
509            &&
510            (
511                ($tmp4 = array_slice($returnInstructions, -2))
512                && ($tmp4[0][0] == 'section_close')
513            )
514        ) {
515            $section_postpend = array_merge($section_postpend, array_splice($returnInstructions, -1));
516        }
517
518        // What if there are headings left inside the $newInstructions?????
519        // Find matching part with headername
520        $newStart = $newEnd = 0;
521        $section_prepend = array();
522        if ($this->_findNextHeaderSection($newInstructions, $level, $newStart, $newEnd)) {
523            // If there are header in here, build a prepend and have the rest at the end
524            $section_prepend = array_splice($newInstructions, 0, $newStart);
525        } else {
526            // If not, prepend all of it.
527            $section_prepend = $newInstructions;
528            $newInstructions = array();
529        }
530
531        $this->_insertMergeHint($section_prepend, $mergeHint);
532
533        $returnInstructions = array_merge($returnInstructions, $section_prepend, $preparedInstructions, $newInstructions, $section_postpend);
534
535        return $returnInstructions;
536    }
537
538    /**
539     * @param integer $level
540     */
541    private function _findNextHeaderSection($section, $level, &$start, &$end, $headerName = null) {
542
543        $inCount = count($section);
544        $currentSlice = -1;
545
546        // Find Level 1 Header that matches.
547        for ($i = $start; $i < $inCount; $i++) {
548
549            $instruction = $section[$i];
550            $end = $i; // Or it will be lost and a section close will be missing.
551
552            // First Level Header
553            if ($instruction[0] == 'header' && $instruction[1][1] == $level) {
554
555                if ($currentSlice > 0) {
556                    return true;
557                }
558
559                if ($headerName == null || ($headerName == $instruction[1][0])) {
560                    // Begin of new slice ...
561                    $start = $currentSlice = $i;
562                }
563            }
564        }
565
566        // Nothing found
567        $end = $i; // Or it will be lost and a section close will be missing.
568        return $currentSlice > 0;
569    }
570
571    private function _cleanAllInstructions(&$instr, $advanced=false) {
572        $this->_cleanInstructions($instr, '/p_(close|open)/');
573        $this->_cleanInstructions($instr, '/section_(close|open)/');
574        $this->_cleanInstructions($instr, '/listu_(close|open)/');
575        $this->_cleanInstructions($instr, '/listo_(close|open)/');
576
577        if ( !$advanced ) {
578            return false;
579        }
580
581        $currentMergeHint = null;
582        $listOfMergeHintNames= [];
583
584        for( $i=0; $i<count($instr); $i++ ) {
585
586            $hasMoreEntries = count($instr)-1 > $i;
587
588            if ( $instr[$i][0] == 'header' ) {
589                // reset after header
590                $currentMergeHint = null;
591            }
592
593            if ( $instr[$i][1][0] == 'siteexport_toctools' && $instr[$i][1][0][0] != 'pagebreak' ) {
594                if ( $currentMergeHint != null && $instr[$i][1][1][2] == $currentMergeHint[1][1][2] ) {
595
596                    if ( $instr[$i][1][1][1] == 'end' ) {
597                        // look ahead, if the next hint is also the same ID, if so: remove this ending hint.
598                        $shouldSpliceAway = false;
599                        for( $ii=$i+1; $ii<count($instr); $ii++ ) {
600                            if ( $instr[$ii][0] == 'header' ) {
601                                // Jumping over a section now ... we have to leave the last entry
602                                break;
603                            } else if ( $instr[$ii][1][0] == 'siteexport_toctools' && $instr[$ii][1][0][0] != 'pagebreak' ) {
604                                if ( $instr[$ii][1][1][2] == $currentMergeHint[1][1][2] && $instr[$ii][1][1][1] == 'start' ) {
605                                    // Found another one, that is identicall - so this will be removed.
606                                    // also remove the current ending element
607                                    $shouldSpliceAway = true;
608                                }
609
610                                // Okay, this was a toctools whatever ... but maybe not a start of the same type.
611                                // we're done.
612                                break;
613                            }
614                        }
615
616                        if ( !$shouldSpliceAway ) {
617                            // print "<pre>NOT Splicing away ". print_r($instr[$i], true) . "</pre>";
618                            continue;
619                        }
620                        // print "<pre>Splicing away ". print_r($instr[$i], true) . "</pre>";
621                    }
622
623                    // print "<p>Removing 'mergehint' in between  </p>";
624                    array_splice($instr, $i--, 1);
625                } else {
626                    // print "<p>Resetting Mergehint '" . $instr[$i][1][1][2] . "' == '" . $currentMergeHint[1][1][2] . "'</p>";
627                    $currentMergeHint = $instr[$i];
628                    $listOfMergeHintNames[] = $instr[$i][1][1][2];
629                }
630            }
631        }
632
633/*
634        print "<pre>" . print_r($instr, 1) . "</pre>";
635
636//*/
637
638        // There is only ONE distinct mergehint -> remove all
639        $listOfMergeHintNames = array_unique($listOfMergeHintNames);
640        if ( count($listOfMergeHintNames) == 1 ) {
641            for( $i=0; $i<count($instr); $i++ ) {
642                if ( $instr[$i][1][0] == 'siteexport_toctools' && $instr[$i][1][0][0] != 'pagebreak' ) {
643                    array_splice($instr, $i--, 1);
644                }
645            }
646        }
647
648        return count($listOfMergeHintNames) == 1;
649    }
650
651    /**
652     * @param string $tag
653     */
654    private function _cleanInstructions(&$instructions, $tag) {
655
656
657/*
658        print "<pre>";
659        print "$tag ->\n";
660        print_r($instructions);
661        print "</pre>";
662//*/
663        $inCount = count($instructions);
664        for ($i = 0; $i < $inCount; $i++) {
665
666            // Last instruction
667            if ($i == $inCount-1) {
668                break;
669            }
670
671            if (preg_match($tag, $instructions[$i][0]) && preg_match($tag, $instructions[$i+1][0]) && $instructions[$i][0] != $instructions[$i+1][0]) {
672/*
673        print "<pre>";
674        print "Removed ->\n";
675        print_r($instructions[$i-1]);
676        print "---\n";
677        print_r($instructions[$i]);
678        print_r($instructions[$i+1]);
679        print "---\n";
680        print_r($instructions[$i+2]);
681        print "</pre>";
682//*/
683
684                // found different tags, but both match the expression and follow each other - so they can be elliminated
685                array_splice($instructions, $i, 2);
686                $inCount -= 2;
687                $i--;
688            }
689        }
690/*
691        print "<pre>";
692        print "$tag ->\n";
693        print_r($instructions);
694        print "</pre>";
695//*/
696    }
697
698    /**
699     * Strip everything except for the headers
700     */
701    private function _initialHeaderStructure($instructions) {
702        $inCount = count($instructions);
703        for ($i = 0; $i < $inCount; $i++) {
704
705            // Last instruction
706            if ($i == $inCount-1) {
707                break;
708            }
709
710            if (!in_array($instructions[$i][0], array('header', 'section_open', 'section_close', 'p_open', 'p_close'))) {
711                // found non-matching
712                array_splice($instructions, $i, 1);
713                $inCount--;
714                $i--;
715            }
716        }
717        return $instructions;
718    }
719
720    private function _insertMergeHint(&$instructions, $mergeHint) {
721
722        // Surround new slice with a mergehint
723        if (empty($mergeHint)) { return; }
724
725        // No emtpy insruction sets.
726        $this->_cleanAllInstructions($instructions);
727
728        if (empty($instructions)) { return; }
729
730        $mergeHintPrepend = $this->_toctoolPrepends( $instructions );
731
732        // only section content should be surrounded.
733        if ($instructions[0][0] != 'section_open') { return; }
734
735        // save for later use
736        $mergeHintId = sectionid($mergeHint, $this->mergeHints);
737        $this->merghintIds[$mergeHintId] = $mergeHint;
738
739        // Insert section information
740        array_push( $mergeHintPrepend, array(
741            'plugin',
742            array(
743                'siteexport_toctools',
744                array(
745                    'mergehint',
746                    'start',
747                    $mergeHint,
748                    $mergeHintId
749                )
750            )
751        ) );
752
753        $mergeHintPostpend = array(array(
754            'plugin',
755            array(
756                'siteexport_toctools',
757                array(
758                    'mergehint',
759                    'end',
760                    $mergeHint
761                )
762            )
763        ));
764
765        $instructions = array_merge($mergeHintPrepend, $instructions, $mergeHintPostpend);
766/*
767        print "<pre>"; print_r($instructions); print "</pre>";
768//*/
769    }
770
771    private function _toctoolPrepends( &$instructions ) {
772
773        $mergeHintPrependPrepend = array();
774
775        // 2021-01-14 This did no good - if a merged page had two mergehints, the first was stripped.
776/*
777        if ( $instructions[0][0] == 'plugin' && $instructions[0][1][0] == 'siteexport_toctools' && $instructions[0][1][1][1] == 'start' ) {
778
779            // This is already section merge hint ... but it will have a section at its end ... hopefully
780            do {
781                $_instructions = array_shift( $instructions );
782                array_push( $mergeHintPrependPrepend, $_instructions);
783            } while( !($_instructions[0] == 'plugin' && $_instructions[1][0] == 'siteexport_toctools' && $_instructions[1][1][1] == 'end' ) ) ;
784            array_splice($mergeHintPrepend, 0, 0, $mergeHintPrependPrepend);
785        }
786//*/
787/*
788        print "<pre>"; print_r($instructions); print "</pre>";
789//*/
790        return $mergeHintPrependPrepend;
791    }
792
793    /**
794     * Remove TOC, section edit buttons and tags
795     */
796    private function _cleanXHTML($xhtml) {
797        $replace = array(
798            '!<div class="toc">.*?(</div>\n</div>)!s' => '', // remove TOCs
799            '#<!-- SECTION \[(\d*-\d*)\] -->#s'       => '', // remove section edit buttons
800            '!<div id="tags">.*?(</div>)!s'           => ''  // remove category tags
801        );
802        $xhtml = preg_replace(array_keys($replace), array_values($replace), $xhtml);
803        return $xhtml;
804    }
805
806    /**
807     * Allow the plugin to prevent DokuWiki creating a second instance of itself
808     *
809     * @return bool   true if the plugin can not be instantiated more than once
810     */
811    public function isSingleton() {
812        return true;
813    }
814}
815// vim:ts=4:sw=4:et:enc=utf-8:
816