xref: /plugin/diagrams/syntax/mediafile.php (revision 2bec1a225a06bb4c356005e6a5e76e5d4d346b20)
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        if ($format === 'metadata') {
93            $renderer->internalmedia($data['src']);
94            return true;
95        }
96        if ($format !== 'xhtml') {
97            return false;
98        }
99
100        $baseAttributes = [
101            'class' => 'media',
102            'width' => $data['width'] ?: '',
103            'height' => $data['height'] ?: '',
104            'title' => $data['title'] ?: '',
105        ];
106
107
108        if (is_a($renderer, 'renderer_plugin_dw2pdf')) {
109            $imageAttributes = $baseAttributes;
110            $imageAttributes['align'] = $data['align'];
111            $imageAttributes['src'] = $data['url'];
112
113            // if a PNG cache exists, use it
114            if (!$data['svg']) $data['svg'] = file_get_contents(mediaFN($data['src']));
115            $cachefile = getCacheName($data['svg'], '.diagrams.png');
116            if (file_exists($cachefile)) $imageAttributes['src'] = 'dw2pdf://' . $cachefile;
117
118            $renderer->doc .= '<img ' . buildAttributes($imageAttributes) . '/>';
119        } else {
120            $wrapperAttributes = $baseAttributes;
121            $wrapperAttributes['class'] .= ' diagrams-svg-wrapper media' . $data['align'];
122
123            $imageAttributes = [];
124            $imageAttributes['class'] = 'diagrams-svg';
125            $imageAttributes['data'] = $data['url'];
126            $imageAttributes['data-id'] = cleanID($data['src']);
127            $imageAttributes['type'] = 'image/svg+xml';
128            $imageAttributes['data-pos'] = $data['pos'] ?: '';
129            $imageAttributes['data-len'] = $data['len'] ?: '';
130
131            $image = sprintf('<object %s></object>', buildAttributes($imageAttributes, true));
132            $wrapper = sprintf('<div %s>%s</div>', buildAttributes($wrapperAttributes, true), $image);
133            $renderer->doc .= $wrapper;
134        }
135
136        return true;
137    }
138}
139