1<?php
2
3use dokuwiki\plugin\diagrams\Diagrams;
4
5/**
6 * Class syntax_plugin_diagrams
7 */
8class syntax_plugin_diagrams_mediafile extends DokuWiki_Syntax_Plugin
9{
10
11    /**
12     * @inheritdoc
13     */
14    public function getType()
15    {
16        return 'substition';
17    }
18
19    /**
20     * @inheritdoc
21     */
22    public function getSort()
23    {
24        return 319;
25    }
26
27    /**
28     * @inheritdoc
29     */
30    public function connectTo($mode)
31    {
32        // only register if mediafile mode is enabled
33        if (!($this->getConf('mode') & Diagrams::MODE_MEDIA)) return;
34
35        // grab all SVG images
36        $this->Lexer->addSpecialPattern('\{\{[^\}]+(?:\.svg)[^\}]*?\}\}', $mode, 'plugin_diagrams_mediafile');
37    }
38
39    /**
40     * Parse SVG syntax into media data
41     *
42     * @param string $match
43     * @param int $state
44     * @param int $pos
45     * @param Doku_Handler $handler
46     * @return array|bool
47     */
48    public function handle($match, $state, $pos, Doku_Handler $handler)
49    {
50        $data = Doku_Handler_Parse_Media($match);
51
52        /** @var helper_plugin_diagrams $helper */
53        $helper = plugin_load('helper', 'diagrams');
54        if (!$data['type'] == 'internalmedia' || !$helper->isDiagramFile(mediaFN($data['src']))) {
55            // This is not a local diagrams file, but some other SVG media file
56            $handler->media($match, $state, $pos);
57            return false;
58        }
59
60        $data['url'] = ml($data['src'], ['cache' => 'nocache'], true, '&');
61        return $data;
62    }
63
64    /**
65     * Handle rewrites made by the move plugin
66     *
67     * @param string $match
68     * @param int $state
69     * @param int $pos
70     * @param string $plugin
71     * @param helper_plugin_move_handler $handler
72     * @return void
73     */
74    public function handleMove($match, $state, $pos, $plugin, $handler)
75    {
76        if ($plugin !== 'diagrams_mediafile') return;
77
78        $handler->media($match, $state, $pos);
79    }
80
81    /**
82     * Render the diagram SVG as <object> instead of <img> to allow links,
83     * except when rendering to a PDF
84     *
85     * @param string $format
86     * @param Doku_Renderer $renderer
87     * @param array $data
88     * @return bool
89     */
90    public function render($format, Doku_Renderer $renderer, $data)
91    {
92        global $conf;
93
94        if ($format === 'metadata') {
95            $renderer->internalmedia($data['src']);
96            return true;
97        }
98        if ($format !== 'xhtml') {
99            return false;
100        }
101
102        // check for cached PNG
103        $cachefile = $this->getCachedPNG($data);
104
105        if (is_a($renderer, 'renderer_plugin_dw2pdf')) {
106            $imageAttributes = [
107                'class' => 'media',
108                'width' => empty($data['width']) ? '' : $data['width'],
109                'height' => empty($data['height']) ? '' : $data['height'],
110                'title' => $data['title'] ?? '',
111                'alt' => $data['title'] ?? '',
112                'align' => $data['align'],
113                'src' => $data['url'],
114            ];
115
116            // if a PNG cache exists, use it instead of the real URL
117            if ($cachefile) {
118                $imageAttributes['src'] = 'dw2pdf://' . $cachefile;
119            }
120
121            $renderer->doc .= '<img ' . buildAttributes($imageAttributes) . '/>';
122        } else {
123            $wrapperAttributes = [];
124            $wrapperAttributes['title'] = $data['title'] ?? '';
125            $wrapperAttributes['class'] = 'media diagrams-svg-wrapper media' . $data['align'];
126
127            $imageAttributes = [];
128            $imageAttributes['class'] = 'diagrams-svg';
129            $imageAttributes['data'] = $data['url'];
130            $imageAttributes['data-id'] = cleanID($data['src'] ?? '');
131            $imageAttributes['type'] = 'image/svg+xml';
132            $imageAttributes['data-pos'] = $data['pos'] ?? '';
133            $imageAttributes['data-len'] = $data['len'] ?? '';
134            $imageAttributes['width'] = empty($data['width']) ? '' : $data['width'];
135            $imageAttributes['height'] = empty($data['height']) ? '' : $data['height'];
136
137            if ($cachefile) {
138                // strip cache dir and our cache extension from data attribute
139                $imageAttributes['data-pngcache'] = str_replace([$conf['cachedir'], Diagrams::CACHE_EXT], '', $cachefile);
140            }
141
142            $image = sprintf('<object %s><span class="diagrams-alt">' . hsc($wrapperAttributes['title']) . '</span></object>', buildAttributes($imageAttributes, true));
143            // wrapper for action buttons
144            $actionButtons = '<div class="diagrams-buttons"></div>';
145            $wrapper = sprintf('<div %s>%s%s</div>', buildAttributes($wrapperAttributes, true), $image, $actionButtons);
146            $renderer->doc .= $wrapper;
147        }
148
149        return true;
150    }
151
152    /**
153     * PNG cache file without extension, if caching is enabled and file exists.
154     * Returns an empty string on older revisions (checking $REV), because
155     * PNG caching does not support versioning.
156     *
157     * @param array $data
158     * @return string
159     */
160    protected function getCachedPNG($data)
161    {
162        global $REV;
163
164        if (!$this->getConf('pngcache') || $REV) return '';
165
166        if (empty($data['svg'])) {
167            $data['svg'] = file_get_contents(mediaFN($data['src']));
168        }
169        $cachefile = getCacheName($data['svg'], Diagrams::CACHE_EXT);
170        if (file_exists($cachefile)) return $cachefile;
171
172        return '';
173    }
174}
175