xref: /plugin/addnewpage/syntax.php (revision ea7ff5cd886ebc35fb7ccacb6eeb671dc974e3a6) 
1<?php
2
3// must be run within Dokuwiki
4if(!defined('DOKU_INC')) die();
5
6/**
7 * Add-New-Page Plugin: a simple form for adding new pages.
8 *
9 * @license  GPL 2 (http://www.gnu.org/licenses/gpl.html)
10 * @author   iDO <ido@idotech.info>
11 * @author   Sam Wilson <sam@samwilson.id.au>
12 */
13class syntax_plugin_addnewpage extends DokuWiki_Syntax_Plugin {
14
15    /**
16     * Syntax Type
17     */
18    public function getType() {
19        return 'substition';
20    }
21
22    /**
23     * Paragraph Type
24     */
25    public function getPType() {
26        return 'block';
27    }
28
29    /**
30     * @return int
31     */
32    public function getSort() {
33        return 199;
34    }
35
36    /**
37     * @param string $mode
38     */
39    public function connectTo($mode) {
40        $this->Lexer->addSpecialPattern('\{\{NEWPAGE[^\}]*\}\}', $mode, 'plugin_addnewpage');
41    }
42
43    /**
44     * Handler to prepare matched data for the rendering process
45     *
46     * Handled syntax options:
47     *   {{NEWPAGE}}
48     *   {{NEWPAGE>your:namespace}}
49     *   {{NEWPAGE#newtpl1,newtpl2}}
50     *   {{NEWPAGE#newtpl1|Title1,newtpl2|Title1}}
51     *   {{NEWPAGE>your:namespace#newtpl1|Title1,newtpl2|Title1}}
52     *
53     * @param   string       $match   The text matched by the patterns
54     * @param   int          $state   The lexer state for the match
55     * @param   int          $pos     The character position of the matched text
56     * @param   Doku_Handler $handler The Doku_Handler object
57     * @return  array Return an array with all data you want to use in render
58     * @codingStandardsIgnoreStart
59     */
60    public function handle($match, $state, $pos, Doku_Handler $handler) {
61        /* @codingStandardsIgnoreEnd */
62        $options = substr($match, 9, -2); // strip markup
63        $options = explode('#', $options, 2);
64
65        $namespace = trim(ltrim($options[0], '>'));
66        $templates = explode(',', $options[1]);
67        $templates = array_map('trim', $templates);
68        return array(
69            'namespace' => $namespace,
70            'newpagetemplates' => $templates
71        );
72    }
73
74    /**
75     * Create the new-page form.
76     *
77     * @param   $mode     string        output format being rendered
78     * @param   $renderer Doku_Renderer the current renderer object
79     * @param   $data     array         data created by handler()
80     * @return  boolean                 rendered correctly?
81     */
82    public function render($mode, Doku_Renderer $renderer, $data) {
83        global $lang;
84
85        if($mode == 'xhtml') {
86            $disablecache = null;
87            $namespaceinput = $this->_htmlNamespaceInput($data['namespace'], $disablecache);
88            if($namespaceinput === false) {
89                if($this->getConf('addpage_hideACL')) {
90                    $renderer->doc .= '';
91                } else {
92                    $renderer->doc .= $this->getLang('nooption');
93                }
94                return true;
95            }
96            if($disablecache) $renderer->info['cache'] = false;
97
98            $newpagetemplateinput = $this->_htmlTemplateInput($data['newpagetemplates']);
99
100            $form = '<div class="addnewpage">' . DOKU_LF
101                . DOKU_TAB . '<form name="addnewpage" method="get" action="' . DOKU_BASE . DOKU_SCRIPT . '" accept-charset="' . $lang['encoding'] . '">' . DOKU_LF
102                . DOKU_TAB . DOKU_TAB . $namespaceinput . DOKU_LF
103                . DOKU_TAB . DOKU_TAB . '<input class="edit" type="text" name="title" size="20" maxlength="255" tabindex="2" />' . DOKU_LF
104                . $newpagetemplateinput
105                . DOKU_TAB . DOKU_TAB . '<input type="hidden" name="do" value="edit" />' . DOKU_LF
106                . DOKU_TAB . DOKU_TAB . '<input type="hidden" name="id" />' . DOKU_LF
107                . DOKU_TAB . DOKU_TAB . '<input class="button" type="submit" value="' . $this->getLang('okbutton') . '" tabindex="4" />' . DOKU_LF
108                . DOKU_TAB . '</form>' . DOKU_LF
109                . '</div>';
110            $renderer->doc .= $form;
111
112            return true;
113        }
114        return false;
115    }
116
117    /**
118     * Parse namespace request
119     *
120     * @author Samuele Tognini <samuele@cli.di.unipi.it>
121     * @author Michael Braun <michael-dev@fami-braun.de>
122     */
123    protected function _parseNS($ns) {
124        global $ID;
125        if($ns == "@PAGE@") return $ID;
126        if($ns == "@NS@") return getNS($ID);
127        $ns = preg_replace("/^\.(:|$)/", dirname(str_replace(':', '/', $ID)) . "$1", $ns);
128        $ns = str_replace("/", ":", $ns);
129        $ns = cleanID($ns);
130        return $ns;
131    }
132
133    /**
134     * Create the HTML Select element for namespace selection.
135     *
136     * @param string|false $dest_ns The destination namespace, or false if none provided.
137     * @param bool $disablecache reference indicates if caching need to be disabled
138     * @global string $ID The page ID
139     * @return string Select element with appropriate NS selected.
140     */
141    protected function _htmlNamespaceInput($dest_ns, &$disablecache) {
142        global $ID;
143        $disablecache = false;
144
145        // If a NS has been provided:
146        // Whether to hide the NS selection (otherwise, show only subnamespaces).
147        $hide = $this->getConf('addpage_hide');
148
149        // Whether the user can create pages in the provided NS (or root, if no
150        // destination NS has been set.
151        $can_create = (auth_quickaclcheck($dest_ns . ":") >= AUTH_CREATE);
152
153        //namespace given, but hidden
154        if($hide && !empty($dest_ns)) {
155            if($can_create) {
156                return '<input type="hidden" name="np_cat" id="np_cat" value="' . $this->_parseNS($dest_ns) . '"/>';
157            } else {
158                return false;
159            }
160        }
161
162        //show select of given namespace
163        $currentns = getNS($ID);
164
165        $ret = '<select class="edit" id="np_cat" name="np_cat" tabindex="1">';
166
167        // Whether the NS select element has any options
168        $someopt = false;
169
170        // Show root namespace if requested and allowed
171        if($this->getConf('addpage_showroot') && $can_create) {
172            if(empty($dest_ns)) {
173                // If no namespace has been provided, add an option for the root NS.
174                $ret .= '<option ' . (($currentns == '') ? 'selected ' : '') . 'value="">' . $this->getLang('namespaceRoot') . '</option>';
175                $someopt = true;
176            } else {
177                // If a namespace has been provided, add an option for it.
178                $ret .= '<option ' . (($currentns == $dest_ns) ? 'selected ' : '') . 'value="' . formText($dest_ns) . '">' . formText($dest_ns) . '</option>';
179                $someopt = true;
180            }
181        }
182
183        $subnamespaces = $this->_getNamespaceList($dest_ns);
184        foreach($subnamespaces as $ns) {
185            if(auth_quickaclcheck($ns . ":") < AUTH_CREATE) continue;
186            $nsparts = explode(':', $ns);
187            $nsparts = str_repeat('&nbsp;&nbsp;', substr_count($ns, ':')) . $nsparts[count($nsparts) - 1];
188            $ret .= '<option ' . (($currentns == $ns) ? 'selected ' : '') . 'value="' . $ns . '">' . $nsparts . '</option>';
189            $someopt = true;
190            $disablecache = true;
191        }
192        $ret .= '</select>';
193
194        if($someopt) {
195            return $ret;
196        } else {
197            return false;
198        }
199    }
200
201    /**
202     * Get a list of namespaces below the given namespace.
203     * Recursively fetches subnamespaces.
204     *
205     * @param string $topns The top namespace
206     * @return array Multi-dimensional array of all namespaces below $tns
207     */
208    protected function _getNamespaceList($topns = '') {
209        global $conf;
210
211        $topns = utf8_encodeFN(str_replace(':', '/', $topns));
212
213        $excludes = $this->getConf('addpage_exclude');
214        if($excludes == "") {
215            $excludes = array();
216        } else {
217            $excludes = @explode(';', strtolower($excludes));
218        }
219        $searchdata = array();
220        search($searchdata, $conf['datadir'], 'search_namespaces', array(), $topns);
221
222        $namespaces = array();
223        foreach($searchdata as $ns) {
224            foreach($excludes as $exclude) {
225                if(strpos($ns['id'], $exclude) === 0) {
226                    continue 2;
227                }
228            }
229            $namespaces[] = $ns['id'];
230        }
231
232        return $namespaces;
233    }
234
235    /**
236     * Create html for selection of namespace templates
237     *
238     * @param array $newpagetemplates array of namespace templates
239     * @return string html of select or hidden input
240     */
241    public function _htmlTemplateInput($newpagetemplates) {
242        $cnt = count($newpagetemplates);
243        if($cnt < 1 || $cnt == 1 && $newpagetemplates[0] == '') {
244            $input = '';
245
246        } else {
247            if($cnt == 1) {
248                list($template, ) = $this->_parseNSTemplatePage($newpagetemplates[0]);
249                $input = '<input type="hidden" name="newpagetemplate" value="' . formText($template) . '" />';
250            } else {
251                $first = true;
252                $input = '<select name="newpagetemplate" tabindex="3">';
253                foreach($newpagetemplates as $template) {
254                    $p = ($first ? ' selected="selected"' : '');
255                    $first = false;
256
257                    list($template, $name) = $this->_parseNSTemplatePage($template);
258                    $p .= ' value="'.formText($template).'"';
259                    $input .= "<option $p>".formText($name)."</option>";
260                }
261                $input .= '</select>';
262            }
263            $input = DOKU_TAB . DOKU_TAB . $input . DOKU_LF;
264        }
265        return $input;
266    }
267
268    /**
269     * Parses and resolves the namespace template page
270     *
271     * @param $nstemplate
272     * @return array
273     */
274    protected function _parseNSTemplatePage($nstemplate) {
275        global $ID;
276
277        @list($template, $name) = explode('|', $nstemplate, 2);
278
279        $exist = null;
280        resolve_pageid(getNS($ID), $template, $exist); //get absolute id
281
282        if (is_null($name)) $name = $template;
283
284        return array($template, $name);
285    }
286
287}
288