xref: /plugin/struct/admin/schemas.php (revision 0ceefd5c55d49dcf9a9f59c8e57e60eaeea1c187)
187fdbc6bSMichael Große<?php
287fdbc6bSMichael Große/**
387fdbc6bSMichael Große * DokuWiki Plugin struct (Admin Component)
487fdbc6bSMichael Große *
587fdbc6bSMichael Große * @license GPL 2 http://www.gnu.org/licenses/gpl-2.0.html
687fdbc6bSMichael Große * @author  Andreas Gohr, Michael Große <dokuwiki@cosmocode.de>
787fdbc6bSMichael Große */
887fdbc6bSMichael Große
987fdbc6bSMichael Großeuse dokuwiki\Form\Form;
10f36cc634SAndreas Gohruse dokuwiki\plugin\struct\meta\CSVExporter;
111fc2361fSSzymon Olewniczakuse dokuwiki\plugin\struct\meta\CSVLookupImporter;
121fc2361fSSzymon Olewniczakuse dokuwiki\plugin\struct\meta\CSVPageImporter;
13ba766201SAndreas Gohruse dokuwiki\plugin\struct\meta\Schema;
14ba766201SAndreas Gohruse dokuwiki\plugin\struct\meta\SchemaBuilder;
15ba766201SAndreas Gohruse dokuwiki\plugin\struct\meta\SchemaEditor;
16ba766201SAndreas Gohruse dokuwiki\plugin\struct\meta\SchemaImporter;
17ba766201SAndreas Gohruse dokuwiki\plugin\struct\meta\StructException;
1887fdbc6bSMichael Große
19d5a1a6dcSAndreas Gohr// must be run within Dokuwiki
2087fdbc6bSMichael Großeif(!defined('DOKU_INC')) die();
2187fdbc6bSMichael Große
2287fdbc6bSMichael Großeclass admin_plugin_struct_schemas extends DokuWiki_Admin_Plugin {
2387fdbc6bSMichael Große
2487fdbc6bSMichael Große    /**
2587fdbc6bSMichael Große     * @return int sort number in admin menu
2687fdbc6bSMichael Große     */
2787fdbc6bSMichael Große    public function getMenuSort() {
2887fdbc6bSMichael Große        return 500;
2987fdbc6bSMichael Große    }
3087fdbc6bSMichael Große
3187fdbc6bSMichael Große    /**
3287fdbc6bSMichael Große     * @return bool true if only access for superuser, false is for superusers and moderators
3387fdbc6bSMichael Große     */
3487fdbc6bSMichael Große    public function forAdminOnly() {
354d220607SAndreas Gohr        return false;
3687fdbc6bSMichael Große    }
3787fdbc6bSMichael Große
3887fdbc6bSMichael Große    /**
3987fdbc6bSMichael Große     * Should carry out any processing required by the plugin.
4087fdbc6bSMichael Große     */
4187fdbc6bSMichael Große    public function handle() {
4287fdbc6bSMichael Große        global $INPUT;
43d5a1a6dcSAndreas Gohr        global $ID;
44e33460e2SMichael Grosse        global $config_cascade;
45e33460e2SMichael Grosse        $config_file_path = end($config_cascade['main']['local']);
4687fdbc6bSMichael Große
478ddf87afSAndreas Gohr        // form submit
4887fdbc6bSMichael Große        $table = Schema::cleanTableName($INPUT->str('table'));
4987fdbc6bSMichael Große        if($table && $INPUT->bool('save') && checkSecurityToken()) {
50d5a1a6dcSAndreas Gohr            $builder = new SchemaBuilder($table, $INPUT->arr('schema'));
5187fdbc6bSMichael Große            if(!$builder->build()) {
5287fdbc6bSMichael Große                msg('something went wrong while saving', -1);
5387fdbc6bSMichael Große            }
54ae5c46faSAndreas Gohr            touch(action_plugin_struct_cache::getSchemaRefreshFile());
5587fdbc6bSMichael Große        }
568ddf87afSAndreas Gohr        // export
57d486d6d7SAndreas Gohr        if($table && $INPUT->bool('export')) {
58d5a1a6dcSAndreas Gohr            $builder = new Schema($table);
59d486d6d7SAndreas Gohr            header('Content-Type: application/json');
60d486d6d7SAndreas Gohr            header("Content-Disposition: attachment; filename=$table.struct.json");
61d486d6d7SAndreas Gohr            echo $builder->toJSON();
62d486d6d7SAndreas Gohr            exit;
63d486d6d7SAndreas Gohr        }
648ddf87afSAndreas Gohr        // import
658ddf87afSAndreas Gohr        if($table && $INPUT->bool('import')) {
668ddf87afSAndreas Gohr            if(isset($_FILES['schemafile']['tmp_name'])) {
678ddf87afSAndreas Gohr                $json = io_readFile($_FILES['schemafile']['tmp_name'], false);
688ddf87afSAndreas Gohr                if(!$json) {
698ddf87afSAndreas Gohr                    msg('Something went wrong with the upload', -1);
708ddf87afSAndreas Gohr                } else {
710845722bSAndreas Gohr                    $builder = new SchemaImporter($table, $json, $INPUT->bool('lookup'));
728ddf87afSAndreas Gohr                    if(!$builder->build()) {
738ddf87afSAndreas Gohr                        msg('something went wrong while saving', -1);
748ddf87afSAndreas Gohr                    }
75ae5c46faSAndreas Gohr                    touch(action_plugin_struct_cache::getSchemaRefreshFile());
768ddf87afSAndreas Gohr                }
778ddf87afSAndreas Gohr            }
788ddf87afSAndreas Gohr        }
79a0b3799eSAndreas Gohr
80a0b3799eSAndreas Gohr        // import CSV
81a0b3799eSAndreas Gohr        if($table && $INPUT->bool('importcsv')) {
82a0b3799eSAndreas Gohr            if(isset($_FILES['csvfile']['tmp_name'])) {
83a0b3799eSAndreas Gohr                try {
841fc2361fSSzymon Olewniczak                    if ($INPUT->bool('lookup')) {
851fc2361fSSzymon Olewniczak                        $csvImporter = new CSVLookupImporter($table, $_FILES['csvfile']['tmp_name']);
861fc2361fSSzymon Olewniczak                    } else {
871fc2361fSSzymon Olewniczak                        $csvImporter = new CSVPageImporter($table, $_FILES['csvfile']['tmp_name']);
881fc2361fSSzymon Olewniczak                    }
891fc2361fSSzymon Olewniczak                    $csvImporter->import();
901fc2361fSSzymon Olewniczak
916d2df532SAndreas Gohr                    msg($this->getLang('admin_csvdone'), 1);
92a0b3799eSAndreas Gohr                } catch(StructException $e) {
93a0b3799eSAndreas Gohr                    msg(hsc($e->getMessage()), -1);
94a0b3799eSAndreas Gohr                }
95a0b3799eSAndreas Gohr            }
96a0b3799eSAndreas Gohr        }
97a0b3799eSAndreas Gohr
98f36cc634SAndreas Gohr        // export CSV
99f36cc634SAndreas Gohr        if($table && $INPUT->bool('exportcsv')) {
100f36cc634SAndreas Gohr            header('Content-Type: text/csv');
101f36cc634SAndreas Gohr            header('Content-Disposition: attachment; filename="' . $table . '.csv";');
102f36cc634SAndreas Gohr            new CSVExporter($table);
103f36cc634SAndreas Gohr            exit();
104f36cc634SAndreas Gohr        }
105f36cc634SAndreas Gohr
106d5a1a6dcSAndreas Gohr        // delete
107d5a1a6dcSAndreas Gohr        if($table && $INPUT->bool('delete')) {
108d5a1a6dcSAndreas Gohr            if($table != $INPUT->str('confirm')) {
109d5a1a6dcSAndreas Gohr                msg($this->getLang('del_fail'), -1);
110d5a1a6dcSAndreas Gohr            } else {
111d5a1a6dcSAndreas Gohr                try {
112d5a1a6dcSAndreas Gohr                    $schema = new Schema($table);
113d5a1a6dcSAndreas Gohr                    $schema->delete();
114d5a1a6dcSAndreas Gohr                    msg($this->getLang('del_ok'), 1);
115ae5c46faSAndreas Gohr                    touch(action_plugin_struct_cache::getSchemaRefreshFile());
116d5a1a6dcSAndreas Gohr                    send_redirect(wl($ID, array('do' => 'admin', 'page' => 'struct_schemas'), true, '&'));
117d5a1a6dcSAndreas Gohr                } catch(StructException $e) {
118d5a1a6dcSAndreas Gohr                    msg(hsc($e->getMessage()), -1);
119d5a1a6dcSAndreas Gohr                }
120d5a1a6dcSAndreas Gohr            }
121d5a1a6dcSAndreas Gohr        }
122d5a1a6dcSAndreas Gohr
12379c83e06SMichael Große        // clear
12479c83e06SMichael Große        if($table && $INPUT->bool('clear')) {
12579c83e06SMichael Große            if($table != $INPUT->str('confirm_clear')) {
12679c83e06SMichael Große                msg($this->getLang('clear_fail'), -1);
12779c83e06SMichael Große            } else {
12879c83e06SMichael Große                try {
12979c83e06SMichael Große                    $schema = new Schema($table);
13079c83e06SMichael Große                    $schema->clear();
13179c83e06SMichael Große                    msg($this->getLang('clear_ok'), 1);
13279c83e06SMichael Große                    touch(action_plugin_struct_cache::getSchemaRefreshFile());
13379c83e06SMichael Große                    send_redirect(wl($ID, array('do' => 'admin', 'page' => 'struct_schemas'), true, '&'));
13479c83e06SMichael Große                } catch(StructException $e) {
13579c83e06SMichael Große                    msg(hsc($e->getMessage()), -1);
13679c83e06SMichael Große                }
13779c83e06SMichael Große            }
13879c83e06SMichael Große        }
13979c83e06SMichael Große
14087fdbc6bSMichael Große    }
14187fdbc6bSMichael Große
14287fdbc6bSMichael Große    /**
14387fdbc6bSMichael Große     * Render HTML output, e.g. helpful text and a form
14487fdbc6bSMichael Große     */
14587fdbc6bSMichael Große    public function html() {
14687fdbc6bSMichael Große        global $INPUT;
14787fdbc6bSMichael Große
14887fdbc6bSMichael Große        $table = Schema::cleanTableName($INPUT->str('table'));
14987fdbc6bSMichael Große        if($table) {
150*0ceefd5cSAnna Dabrowska            $schema = new Schema($table, 0);
1517c080d69SAndreas Gohr
1526af24d3eSAndreas Gohr            echo $this->locale_xhtml('editor_edit');
153*0ceefd5cSAnna Dabrowska            echo '<h2>' . sprintf($this->getLang('edithl'), hsc($table)) . '</h2>';
1548ddf87afSAndreas Gohr
1558ddf87afSAndreas Gohr            echo '<ul class="tabs" id="plugin__struct_tabs">';
1568ddf87afSAndreas Gohr            /** @noinspection HtmlUnknownAnchorTarget */
1578ddf87afSAndreas Gohr            echo '<li class="active"><a href="#plugin__struct_editor">' . $this->getLang('tab_edit') . '</a></li>';
1588ddf87afSAndreas Gohr            /** @noinspection HtmlUnknownAnchorTarget */
1598ddf87afSAndreas Gohr            echo '<li><a href="#plugin__struct_json">' . $this->getLang('tab_export') . '</a></li>';
160d5a1a6dcSAndreas Gohr            /** @noinspection HtmlUnknownAnchorTarget */
161d5a1a6dcSAndreas Gohr            echo '<li><a href="#plugin__struct_delete">' . $this->getLang('tab_delete') . '</a></li>';
1628ddf87afSAndreas Gohr            echo '</ul>';
1638ddf87afSAndreas Gohr            echo '<div class="panelHeader"></div>';
1648ddf87afSAndreas Gohr
1657c080d69SAndreas Gohr            $editor = new SchemaEditor($schema);
16687fdbc6bSMichael Große            echo $editor->getEditor();
1670845722bSAndreas Gohr            echo $this->html_json($schema);
1680845722bSAndreas Gohr            echo $this->html_delete($schema);
169d486d6d7SAndreas Gohr
17087fdbc6bSMichael Große        } else {
1716af24d3eSAndreas Gohr            echo $this->locale_xhtml('editor_intro');
1728ddf87afSAndreas Gohr            echo $this->html_newschema();
17387fdbc6bSMichael Große        }
17487fdbc6bSMichael Große    }
17587fdbc6bSMichael Große
17687fdbc6bSMichael Große    /**
1778ddf87afSAndreas Gohr     * Form for handling import/export from/to JSON
1780845722bSAndreas Gohr     *
1790845722bSAndreas Gohr     * @param Schema $schema
1808ddf87afSAndreas Gohr     * @return string
1818ddf87afSAndreas Gohr     */
1820845722bSAndreas Gohr    protected function html_json(Schema $schema) {
1838ddf87afSAndreas Gohr        $form = new Form(array('enctype' => 'multipart/form-data', 'id' => 'plugin__struct_json'));
1848ddf87afSAndreas Gohr        $form->setHiddenField('do', 'admin');
1858ddf87afSAndreas Gohr        $form->setHiddenField('page', 'struct_schemas');
1860845722bSAndreas Gohr        $form->setHiddenField('table', $schema->getTable());
1878ddf87afSAndreas Gohr
1888ddf87afSAndreas Gohr        $form->addFieldsetOpen($this->getLang('export'));
1898ddf87afSAndreas Gohr        $form->addButton('export', $this->getLang('btn_export'));
1908ddf87afSAndreas Gohr        $form->addFieldsetClose();
1918ddf87afSAndreas Gohr
1928ddf87afSAndreas Gohr        $form->addFieldsetOpen($this->getLang('import'));
1930bd068beSMichael Große        $form->addElement(new \dokuwiki\Form\InputElement('file', 'schemafile'))->attr('accept', '.json');
1948ddf87afSAndreas Gohr        $form->addButton('import', $this->getLang('btn_import'));
1958ddf87afSAndreas Gohr        $form->addHTML('<p>' . $this->getLang('import_warning') . '</p>');
1968ddf87afSAndreas Gohr        $form->addFieldsetClose();
197a0b3799eSAndreas Gohr
1986d2df532SAndreas Gohr        $form->addFieldsetOpen($this->getLang('admin_csvexport'));
199f36cc634SAndreas Gohr        $form->addButton('exportcsv', $this->getLang('btn_export'));
200f36cc634SAndreas Gohr        $form->addFieldsetClose();
201f36cc634SAndreas Gohr
2026d2df532SAndreas Gohr        $form->addFieldsetOpen($this->getLang('admin_csvimport'));
2030bd068beSMichael Große        $form->addElement(new \dokuwiki\Form\InputElement('file', 'csvfile'))->attr('accept', '.csv');
204a0b3799eSAndreas Gohr        $form->addButton('importcsv', $this->getLang('btn_import'));
205a22f2592SMichael Große        $form->addCheckbox('createPage', 'Create missing pages')->addClass('block edit');
2066d2df532SAndreas Gohr        $form->addHTML('<p><a href="https://www.dokuwiki.org/plugin:struct:csvimport">' . $this->getLang('admin_csvhelp') . '</a></p>');
207a0b3799eSAndreas Gohr        $form->addFieldsetClose();
208a0b3799eSAndreas Gohr
2098ddf87afSAndreas Gohr        return $form->toHTML();
2108ddf87afSAndreas Gohr    }
2118ddf87afSAndreas Gohr
2128ddf87afSAndreas Gohr    /**
213d5a1a6dcSAndreas Gohr     * Form for deleting schemas
2140845722bSAndreas Gohr     *
2150845722bSAndreas Gohr     * @param Schema $schema
216d5a1a6dcSAndreas Gohr     * @return string
217d5a1a6dcSAndreas Gohr     */
2180845722bSAndreas Gohr    protected function html_delete(Schema $schema) {
219d5a1a6dcSAndreas Gohr        $form = new Form(array('id' => 'plugin__struct_delete'));
220d5a1a6dcSAndreas Gohr        $form->setHiddenField('do', 'admin');
221d5a1a6dcSAndreas Gohr        $form->setHiddenField('page', 'struct_schemas');
2220845722bSAndreas Gohr        $form->setHiddenField('table', $schema->getTable());
223d5a1a6dcSAndreas Gohr
22479c83e06SMichael Große        $form->addFieldsetOpen($this->getLang('btn_delete'));
225d5a1a6dcSAndreas Gohr        $form->addHTML($this->locale_xhtml('delete_intro'));
226d5a1a6dcSAndreas Gohr        $form->addTextInput('confirm', $this->getLang('del_confirm'));
227d5a1a6dcSAndreas Gohr        $form->addButton('delete', $this->getLang('btn_delete'));
228d5a1a6dcSAndreas Gohr        $form->addFieldsetClose();
22979c83e06SMichael Große
23079c83e06SMichael Große        $form->addFieldsetOpen($this->getLang('btn_clear'));
23179c83e06SMichael Große        $form->addHTML($this->locale_xhtml('clear_intro'));
23279c83e06SMichael Große        $form->addTextInput('confirm_clear', $this->getLang('clear_confirm'));
23379c83e06SMichael Große        $form->addButton('clear', $this->getLang('btn_clear'));
23479c83e06SMichael Große        $form->addFieldsetClose();
23579c83e06SMichael Große
236d5a1a6dcSAndreas Gohr        return $form->toHTML();
237d5a1a6dcSAndreas Gohr    }
238d5a1a6dcSAndreas Gohr
239d5a1a6dcSAndreas Gohr    /**
24087fdbc6bSMichael Große     * Form to add a new schema
2418ddf87afSAndreas Gohr     *
2428ddf87afSAndreas Gohr     * @return string
24387fdbc6bSMichael Große     */
24487fdbc6bSMichael Große    protected function html_newschema() {
24587fdbc6bSMichael Große        $form = new Form();
2464e427bd5SAndreas Gohr        $form->addClass('struct_newschema');
24787fdbc6bSMichael Große        $form->addFieldsetOpen($this->getLang('create'));
24887fdbc6bSMichael Große        $form->setHiddenField('do', 'admin');
249dbffe06eSAndreas Gohr        $form->setHiddenField('page', 'struct_schemas');
25087fdbc6bSMichael Große        $form->addTextInput('table', $this->getLang('schemaname'));
25187fdbc6bSMichael Große        $form->addButton('', $this->getLang('save'));
25287fdbc6bSMichael Große        $form->addHTML('<p>' . $this->getLang('createhint') . '</p>'); // FIXME is that true? we probably could
25387fdbc6bSMichael Große        $form->addFieldsetClose();
2548ddf87afSAndreas Gohr        return $form->toHTML();
25587fdbc6bSMichael Große    }
25687fdbc6bSMichael Große
25787fdbc6bSMichael Große    /**
25887fdbc6bSMichael Große     * Adds all available schemas to the Table of Contents
25987fdbc6bSMichael Große     *
26087fdbc6bSMichael Große     * @return array
26187fdbc6bSMichael Große     */
26287fdbc6bSMichael Große    public function getTOC() {
26387fdbc6bSMichael Große        global $ID;
26487fdbc6bSMichael Große
26587fdbc6bSMichael Große        $toc = array();
2668ddf87afSAndreas Gohr        $link = wl(
2678ddf87afSAndreas Gohr            $ID, array(
26887fdbc6bSMichael Große                   'do' => 'admin',
269dbffe06eSAndreas Gohr                   'page' => 'struct_assignments'
2708ddf87afSAndreas Gohr               )
2718ddf87afSAndreas Gohr        );
272dbffe06eSAndreas Gohr        $toc[] = html_mktocitem($link, $this->getLang('menu_assignments'), 0, '');
2737c080d69SAndreas Gohr        $slink = wl(
2748ddf87afSAndreas Gohr            $ID, array(
275dbffe06eSAndreas Gohr                   'do' => 'admin',
276dbffe06eSAndreas Gohr                   'page' => 'struct_schemas'
2778ddf87afSAndreas Gohr               )
2788ddf87afSAndreas Gohr        );
2797c080d69SAndreas Gohr        $toc[] = html_mktocitem($slink, $this->getLang('menu'), 0, '');
28087fdbc6bSMichael Große
281*0ceefd5cSAnna Dabrowska        $tables = Schema::getAll();
2827c080d69SAndreas Gohr        if($tables) {
283097f4a53SAndreas Gohr            foreach($tables as $table) {
2848ddf87afSAndreas Gohr                $link = wl(
2858ddf87afSAndreas Gohr                    $ID, array(
28687fdbc6bSMichael Große                           'do' => 'admin',
287dbffe06eSAndreas Gohr                           'page' => 'struct_schemas',
288097f4a53SAndreas Gohr                           'table' => $table
2898ddf87afSAndreas Gohr                       )
2908ddf87afSAndreas Gohr                );
29187fdbc6bSMichael Große
292*0ceefd5cSAnna Dabrowska                $toc[] = html_mktocitem($link, hsc($table), 1, '');
2937c080d69SAndreas Gohr            }
2947c080d69SAndreas Gohr        }
2957c080d69SAndreas Gohr
29687fdbc6bSMichael Große        return $toc;
29787fdbc6bSMichael Große    }
29887fdbc6bSMichael Große
299a0b3799eSAndreas Gohr
300a0b3799eSAndreas Gohr
30187fdbc6bSMichael Große}
30287fdbc6bSMichael Große
30387fdbc6bSMichael Große// vim:ts=4:sw=4:et:
304