xref: /plugin/struct/types/Media.php (revision 6b5e52fdc855fae6c9e4d14200a08724660445a3)
1<?php
2namespace dokuwiki\plugin\struct\types;
3
4use dokuwiki\plugin\struct\meta\ValidationException;
5
6class Media extends AbstractBaseType {
7
8    protected $config = array(
9        'mime' => 'image/',
10        'width' => 90,
11        'height' => 90,
12        'agg_width' => '',
13        'agg_height' => ''
14    );
15
16    /**
17     * Checks against the allowed mime types
18     *
19     * @param string $value
20     * @return int|string
21     */
22    public function validate($value) {
23        $value = parent::validate($value);
24
25        if(!trim($this->config['mime'])) return $value;
26        $allows = explode(',', $this->config['mime']);
27        $allows = array_map('trim', $allows);
28        $allows = array_filter($allows);
29
30        list(, $mime,) = mimetype($value, false);
31        foreach($allows as $allow) {
32            if(strpos($mime, $allow) === 0) return $value;
33        }
34
35        throw new ValidationException('Media mime type', $mime, $this->config['mime']);
36    }
37
38    /**
39     * Output the stored data
40     *
41     * If outputted in an aggregation we collect the images into a gallery.
42     *
43     * @param string|int $value the value stored in the database
44     * @param \Doku_Renderer $R the renderer currently used to render the data
45     * @param string $mode The mode the output is rendered in (eg. XHTML)
46     * @return bool true if $mode could be satisfied
47     */
48    public function renderValue($value, \Doku_Renderer $R, $mode) {
49        // get width and height from config
50        $width = null;
51        $height = null;
52        if($this->config['width']) $width = $this->config['width'];
53        if($this->config['height']) $height = $this->config['height'];
54        if(!empty($R->info['struct_table_hash'])) {
55            // this is an aggregation, check for special values
56            if($this->config['agg_width']) $width = $this->config['agg_width'];
57            if($this->config['agg_height']) $height = $this->config['agg_height'];
58        }
59
60        // depending on renderer type directly output or get value from it
61        $returnLink = null;
62        $html = '';
63        if(!media_isexternal($value)) {
64            if(is_a($R, '\Doku_Renderer_xhtml')) {
65                /** @var \Doku_Renderer_xhtml $R */
66                $html = $R->internalmedia($value, null, null, $width, $height, null, 'direct', true);
67            } else {
68                $R->internalmedia($value, null, null, $width, $height, null, 'direct');
69            }
70        } else {
71            if(is_a($R, '\Doku_Renderer_xhtml')) {
72                /** @var \Doku_Renderer_xhtml $R */
73                $html = $R->externalmedia($value, null, null, $width, $height, null, 'direct', true);
74            } else {
75                $R->externalmedia($value, null, null, $width, $height, null, 'direct');
76            }
77        }
78
79        // add gallery meta data in XHTML
80        if($mode == 'xhtml') {
81            list(, $mime,) = mimetype($value, false);
82            if(substr($mime, 0, 6) == 'image/') {
83                $hash = !empty($R->info['struct_table_hash']) ? "[gal-" . $R->info['struct_table_hash'] . "]" : '';
84                $html = str_replace('href', "rel=\"lightbox$hash\" href", $html);
85            }
86            $R->doc .= $html;
87        }
88
89        return true;
90    }
91
92    /**
93     * Return the editor to edit a single value
94     *
95     * @param string $name the form name where this has to be stored
96     * @param string $value the current value
97     * @param bool $isRaw ignored
98     *
99     * @return string html
100     */
101    public function valueEditor($name, $value, $isRaw = false) {
102        $name = hsc($name);
103        $value = hsc($value);
104
105        $id = 'struct__' . md5($name);
106
107        $html = "<input id=\"$id\" class=\"struct_media\"  name=\"$name\" value=\"$value\" />";
108        $html .= "<button type=\"button\" class=\"struct_media\">";
109        $html .= "<img src=\"" . DOKU_BASE . "lib/images/toolbar/image.png\" height=\"16\" width=\"16\">";
110        $html .= "</button>";
111        return $html;
112    }
113}
114