Initial commit of intern.ccwn.org contentsHEADmaster

1 files changed, 1404 insertions, 0 deletions

diff --git a/hugo/libraries/relation.lib.php b/hugo/libraries/relation.lib.php
new file mode 100644
index 0000000..94a7d81
--- /dev/null
+++ b/hugo/libraries/relation.lib.php
@@ -0,0 +1,1404 @@
+<?php
+/* vim: set expandtab sw=4 ts=4 sts=4: */
+/**
+ * Set of functions used with the relation and pdf feature
+ *
+ * @package PhpMyAdmin
+ */
+if (! defined('PHPMYADMIN')) {
+    exit;
+}
+
+/**
+ * Executes a query as controluser if possible, otherwise as normal user
+ *
+ * @param string  $sql        the query to execute
+ * @param boolean $show_error whether to display SQL error messages or not
+ * @param int     $options    query options
+ *
+ * @return integer   the result set, or false if no result set
+ *
+ * @access  public
+ *
+ */
+function PMA_queryAsControlUser($sql, $show_error = true, $options = 0)
+{
+    // Avoid caching of the number of rows affected; for example, this function
+    // is called for tracking purposes but we want to display the correct number
+    // of rows affected by the original query, not by the query generated for
+    // tracking.
+    $cache_affected_rows = false;
+
+    if ($show_error) {
+        $result = PMA_DBI_query(
+            $sql,
+            $GLOBALS['controllink'],
+            $options,
+            $cache_affected_rows
+        );
+    } else {
+        $result = @PMA_DBI_try_query(
+            $sql,
+            $GLOBALS['controllink'],
+            $options,
+            $cache_affected_rows
+        );
+    } // end if... else...
+
+    if ($result) {
+        return $result;
+    } else {
+        return false;
+    }
+} // end of the "PMA_queryAsControlUser()" function
+
+/**
+ * Returns current relation parameters
+ *
+ * @return array   $cfgRelation
+ */
+function PMA_getRelationsParam()
+{
+    if (empty($_SESSION['relation'][$GLOBALS['server']])) {
+        $_SESSION['relation'][$GLOBALS['server']] = PMA__getRelationsParam();
+    }
+
+    // just for BC but needs to be before PMA_getRelationsParamDiagnostic()
+    // which uses it
+    $GLOBALS['cfgRelation'] = $_SESSION['relation'][$GLOBALS['server']];
+
+    return $_SESSION['relation'][$GLOBALS['server']];
+}
+
+/**
+ * prints out diagnostic info for pma relation feature
+ *
+ * @param array $cfgRelation Relation configuration
+ *
+ * @return string
+ */
+function PMA_getRelationsParamDiagnostic($cfgRelation)
+{
+    $retval = '';
+
+    $messages['error'] = '<font color="red"><strong>'
+        . __('not OK')
+        . '</strong></font>'
+        . ' [ <a href="%s" target="documentation">'
+        . __('Documentation')
+        . '</a> ]';
+
+    $messages['ok'] = '<font color="green"><strong>'
+        .  _pgettext('Correctly working', 'OK')
+        . '</strong></font>';
+
+    $messages['enabled']  = '<font color="green">' . __('Enabled') . '</font>';
+    $messages['disabled'] = '<font color="red">'   . __('Disabled') . '</font>';
+
+    if (false === $GLOBALS['cfg']['Server']['pmadb']) {
+        $retval .= 'PMA Database ... '
+             . sprintf($messages['error'], 'pmadb')
+             . '<br />' . "\n"
+             . __('General relation features')
+             . ' <font color="green">' . __('Disabled')
+             . '</font>' . "\n";
+    } else {
+        $retval .= '<table>' . "\n";
+        $retval .= PMA_getDiagMessageForParameter(
+            'pmadb',
+            $GLOBALS['cfg']['Server']['pmadb'],
+            $messages,
+            'pmadb'
+        );
+        $retval .= PMA_getDiagMessageForParameter(
+            'relation',
+            isset($cfgRelation['relation']),
+            $messages,
+            'relation'
+        );
+        $retval .= PMA_getDiagMessageForFeature(
+            __('General relation features'),
+            'relwork',
+            $messages
+        );
+        $retval .= PMA_getDiagMessageForParameter(
+            'table_info',
+            isset($cfgRelation['table_info']),
+            $messages,
+            'table_info'
+        );
+        $retval .= PMA_getDiagMessageForFeature(
+            __('Display Features'),
+            'displaywork',
+            $messages
+        );
+        $retval .= PMA_getDiagMessageForParameter(
+            'table_coords',
+            isset($cfgRelation['table_coords']),
+            $messages,
+            'table_coords'
+        );
+        $retval .= PMA_getDiagMessageForParameter(
+            'pdf_pages',
+            isset($cfgRelation['pdf_pages']),
+            $messages,
+            'pdf_pages'
+        );
+        $retval .= PMA_getDiagMessageForFeature(
+            __('Creation of PDFs'),
+            'pdfwork',
+            $messages
+        );
+        $retval .= PMA_getDiagMessageForParameter(
+            'column_info',
+            isset($cfgRelation['column_info']),
+            $messages,
+            'column_info'
+        );
+        $retval .= PMA_getDiagMessageForFeature(
+            __('Displaying Column Comments'),
+            'commwork',
+            $messages,
+            false
+        );
+        $retval .= PMA_getDiagMessageForFeature(
+            __('Browser transformation'),
+            'mimework',
+            $messages
+        );
+        if ($cfgRelation['commwork'] && ! $cfgRelation['mimework']) {
+            $retval .= '<tr><td colspan=2 class="left">';
+            $retval .=  __('Please see the documentation on how to update your column_comments table');
+            $retval .= '</td></tr>';
+        }
+        $retval .= PMA_getDiagMessageForParameter(
+            'bookmarktable',
+            isset($cfgRelation['bookmark']),
+            $messages,
+            'bookmark'
+        );
+        $retval .= PMA_getDiagMessageForFeature(
+            __('Bookmarked SQL query'),
+            'bookmarkwork',
+            $messages
+        );
+        $retval .= PMA_getDiagMessageForParameter(
+            'history',
+            isset($cfgRelation['history']),
+            $messages,
+            'history'
+        );
+        $retval .= PMA_getDiagMessageForFeature(
+            __('SQL history'),
+            'historywork',
+            $messages
+        );
+        $retval .= PMA_getDiagMessageForParameter(
+            'designer_coords',
+            isset($cfgRelation['designer_coords']),
+            $messages,
+            'designer_coords'
+        );
+        $retval .= PMA_getDiagMessageForFeature(
+            __('Designer'),
+            'designerwork',
+            $messages
+        );
+        $retval .= PMA_getDiagMessageForParameter(
+            'recent',
+            isset($cfgRelation['recent']),
+            $messages,
+            'recent'
+        );
+        $retval .= PMA_getDiagMessageForFeature(
+            __('Persistent recently used tables'),
+            'recentwork',
+            $messages
+        );
+        $retval .= PMA_getDiagMessageForParameter(
+            'table_uiprefs',
+            isset($cfgRelation['table_uiprefs']),
+            $messages,
+            'table_uiprefs'
+        );
+        $retval .= PMA_getDiagMessageForFeature(
+            __('Persistent tables\' UI preferences'),
+            'uiprefswork',
+            $messages
+        );
+        $retval .= PMA_getDiagMessageForParameter(
+            'tracking',
+            isset($cfgRelation['tracking']),
+            $messages,
+            'tracking'
+        );
+        $retval .= PMA_getDiagMessageForFeature(
+            __('Tracking'),
+            'trackingwork',
+            $messages
+        );
+        $retval .= PMA_getDiagMessageForParameter(
+            'userconfig',
+            isset($cfgRelation['userconfig']),
+            $messages,
+            'userconfig'
+        );
+        $retval .= PMA_getDiagMessageForFeature(
+            __('User preferences'),
+            'userconfigwork',
+            $messages
+        );
+        $retval .= '</table>' . "\n";
+
+        $retval .= '<p>' . __('Quick steps to setup advanced features:') . '</p>';
+        $retval .= '<ul>';
+        $retval .= '<li>';
+        $retval .= __(
+            'Create the needed tables with the '
+            . '<code>examples/create_tables.sql</code>.'
+        );
+        $retval .= ' ' . PMA_Util::showDocu('setup', 'linked-tables');
+        $retval .= '</li>';
+        $retval .= '<li>';
+        $retval .= __('Create a pma user and give access to these tables.');
+        $retval .= ' ' . PMA_Util::showDocu('config', 'cfg_Servers_controluser');
+        $retval .= '</li>';
+        $retval .= '<li>';
+        $retval .= __(
+            'Enable advanced features in configuration file '
+            . '(<code>config.inc.php</code>), for example by '
+            . 'starting from <code>config.sample.inc.php</code>.'
+        );
+        $retval .= ' ' . PMA_Util::showDocu('setup', 'quick-install');
+        $retval .= '</li>';
+        $retval .= '<li>';
+        $retval .= __(
+            'Re-login to phpMyAdmin to load the updated configuration file.'
+        );
+        $retval .= '</li>';
+        $retval .= '</ul>';
+    }
+
+    return $retval;
+}
+
+/**
+ * prints out one diagnostic message for a feature
+ *
+ * @param string  $feature_name       feature name in a message string
+ * @param string  $relation_parameter the $GLOBALS['cfgRelation'] parameter to check
+ * @param array   $messages           utility messages
+ * @param boolean $skip_line          whether to skip a line after the message
+ *
+ * @return string
+ */
+function PMA_getDiagMessageForFeature($feature_name,
+    $relation_parameter, $messages, $skip_line = true
+) {
+    $retval = '    <tr><td colspan=2 class="right">' . $feature_name . ': ';
+    if ($GLOBALS['cfgRelation'][$relation_parameter]) {
+        $retval .= $messages['enabled'];
+    } else {
+        $retval .= $messages['disabled'];
+    }
+    $retval .= '</td></tr>';
+    if ($skip_line) {
+        $retval .= '<tr><td>&nbsp;</td></tr>';
+    }
+    return $retval;
+}
+
+/**
+ * prints out one diagnostic message for a configuration parameter
+ *
+ * @param string  $parameter              config parameter name to display
+ * @param boolean $relation_parameter_set whether this parameter is set
+ * @param array   $messages               utility messages
+ * @param string  $doc_anchor             anchor in documentation
+ *
+ * @return void
+ */
+function PMA_getDiagMessageForParameter($parameter,
+    $relation_parameter_set, $messages, $doc_anchor
+) {
+    $retval = '<tr><th class="left">';
+    $retval .= '$cfg[\'Servers\'][$i][\'' . $parameter . '\']  ... ';
+    $retval .= '</th><td class="right">';
+    if ($relation_parameter_set) {
+        $retval .= $messages['ok'];
+    } else {
+        $retval .= sprintf(
+            $messages['error'],
+            PMA_Util::getDocuLink('config', 'cfg_Servers_' . $doc_anchor)
+        );
+    }
+    $retval .= '</td></tr>' . "\n";
+    return $retval;
+}
+
+
+/**
+ * Defines the relation parameters for the current user
+ * just a copy of the functions used for relations ;-)
+ * but added some stuff to check what will work
+ *
+ * @access  protected
+ * @return array    the relation parameters for the current user
+ */
+function PMA__getRelationsParam()
+{
+    $cfgRelation                = array();
+    $cfgRelation['relwork']     = false;
+    $cfgRelation['displaywork'] = false;
+    $cfgRelation['bookmarkwork']= false;
+    $cfgRelation['pdfwork']     = false;
+    $cfgRelation['commwork']    = false;
+    $cfgRelation['mimework']    = false;
+    $cfgRelation['historywork'] = false;
+    $cfgRelation['recentwork']  = false;
+    $cfgRelation['uiprefswork'] = false;
+    $cfgRelation['trackingwork'] = false;
+    $cfgRelation['designerwork'] = false;
+    $cfgRelation['userconfigwork'] = false;
+    $cfgRelation['allworks']    = false;
+    $cfgRelation['user']        = null;
+    $cfgRelation['db']          = null;
+
+    if ($GLOBALS['server'] == 0 || empty($GLOBALS['cfg']['Server']['pmadb'])
+        || ! PMA_DBI_select_db($GLOBALS['cfg']['Server']['pmadb'], $GLOBALS['controllink'])
+    ) {
+        // No server selected -> no bookmark table
+        // we return the array with the falses in it,
+        // to avoid some 'Unitialized string offset' errors later
+        $GLOBALS['cfg']['Server']['pmadb'] = false;
+        return $cfgRelation;
+    }
+
+
+    $cfgRelation['user']  = $GLOBALS['cfg']['Server']['user'];
+    $cfgRelation['db']    = $GLOBALS['cfg']['Server']['pmadb'];
+
+    //  Now I just check if all tables that i need are present so I can for
+    //  example enable relations but not pdf...
+    //  I was thinking of checking if they have all required columns but I
+    //  fear it might be too slow
+
+    $tab_query = 'SHOW TABLES FROM '
+        . PMA_Util::backquote(
+            $GLOBALS['cfg']['Server']['pmadb']
+        );
+    $tab_rs    = PMA_queryAsControlUser($tab_query, false, PMA_DBI_QUERY_STORE);
+
+    if (! $tab_rs) {
+        // query failed ... ?
+        //$GLOBALS['cfg']['Server']['pmadb'] = false;
+        return $cfgRelation;
+    }
+
+    while ($curr_table = @PMA_DBI_fetch_row($tab_rs)) {
+        if ($curr_table[0] == $GLOBALS['cfg']['Server']['bookmarktable']) {
+            $cfgRelation['bookmark']        = $curr_table[0];
+        } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['relation']) {
+            $cfgRelation['relation']        = $curr_table[0];
+        } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['table_info']) {
+            $cfgRelation['table_info']      = $curr_table[0];
+        } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['table_coords']) {
+            $cfgRelation['table_coords']    = $curr_table[0];
+        } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['designer_coords']) {
+            $cfgRelation['designer_coords']    = $curr_table[0];
+        } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['column_info']) {
+            $cfgRelation['column_info'] = $curr_table[0];
+        } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['pdf_pages']) {
+            $cfgRelation['pdf_pages']       = $curr_table[0];
+        } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['history']) {
+            $cfgRelation['history'] = $curr_table[0];
+        } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['recent']) {
+            $cfgRelation['recent'] = $curr_table[0];
+        } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['table_uiprefs']) {
+            $cfgRelation['table_uiprefs'] = $curr_table[0];
+        } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['tracking']) {
+            $cfgRelation['tracking'] = $curr_table[0];
+        } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['userconfig']) {
+            $cfgRelation['userconfig'] = $curr_table[0];
+        }
+    } // end while
+    PMA_DBI_free_result($tab_rs);
+
+    if (isset($cfgRelation['relation'])) {
+        $cfgRelation['relwork']         = true;
+        if (isset($cfgRelation['table_info'])) {
+                $cfgRelation['displaywork'] = true;
+        }
+    }
+
+    if (isset($cfgRelation['table_coords']) && isset($cfgRelation['pdf_pages'])) {
+        $cfgRelation['pdfwork']     = true;
+    }
+
+    if (isset($cfgRelation['column_info'])) {
+        $cfgRelation['commwork']    = true;
+        $cfgRelation['mimework'] = true;
+    }
+
+    if (isset($cfgRelation['history'])) {
+        $cfgRelation['historywork']     = true;
+    }
+
+    if (isset($cfgRelation['recent'])) {
+        $cfgRelation['recentwork']      = true;
+    }
+
+    if (isset($cfgRelation['table_uiprefs'])) {
+        $cfgRelation['uiprefswork']     = true;
+    }
+
+    if (isset($cfgRelation['tracking'])) {
+        $cfgRelation['trackingwork']     = true;
+    }
+
+    if (isset($cfgRelation['userconfig'])) {
+        $cfgRelation['userconfigwork']   = true;
+    }
+
+    // we do not absolutely need that the internal relations or the PDF
+    // schema feature be activated
+    if (isset($cfgRelation['designer_coords'])) {
+        $cfgRelation['designerwork']     = true;
+    }
+
+    if (isset($cfgRelation['bookmark'])) {
+        $cfgRelation['bookmarkwork']     = true;
+    }
+
+    if ($cfgRelation['relwork'] && $cfgRelation['displaywork']
+        && $cfgRelation['pdfwork'] && $cfgRelation['commwork']
+        && $cfgRelation['mimework'] && $cfgRelation['historywork']
+        && $cfgRelation['recentwork'] && $cfgRelation['uiprefswork']
+        && $cfgRelation['trackingwork'] && $cfgRelation['userconfigwork']
+        && $cfgRelation['bookmarkwork'] && $cfgRelation['designerwork']
+    ) {
+        $cfgRelation['allworks'] = true;
+    }
+
+    return $cfgRelation;
+} // end of the 'PMA_getRelationsParam()' function
+
+/**
+ * Gets all Relations to foreign tables for a given table or
+ * optionally a given column in a table
+ *
+ * @param string $db     the name of the db to check for
+ * @param string $table  the name of the table to check for
+ * @param string $column the name of the column to check for
+ * @param string $source the source for foreign key information
+ *
+ * @return array    db,table,column
+ *
+ * @access  public
+ */
+function PMA_getForeigners($db, $table, $column = '', $source = 'both')
+{
+    $cfgRelation = PMA_getRelationsParam();
+    $foreign = array();
+
+    if ($cfgRelation['relwork'] && ($source == 'both' || $source == 'internal')) {
+        $rel_query = '
+             SELECT `master_field`,
+                    `foreign_db`,
+                    `foreign_table`,
+                    `foreign_field`
+               FROM ' . PMA_Util::backquote($cfgRelation['db']) . '.' . PMA_Util::backquote($cfgRelation['relation']) . '
+              WHERE `master_db`    = \'' . PMA_Util::sqlAddSlashes($db) . '\'
+                AND `master_table` = \'' . PMA_Util::sqlAddSlashes($table) . '\' ';
+        if (strlen($column)) {
+            $rel_query .= ' AND `master_field` = \'' . PMA_Util::sqlAddSlashes($column) . '\'';
+        }
+        $foreign = PMA_DBI_fetch_result($rel_query, 'master_field', null, $GLOBALS['controllink']);
+    }
+
+    if (($source == 'both' || $source == 'foreign') && strlen($table)) {
+
+        $show_create_table_query = 'SHOW CREATE TABLE '
+            . PMA_Util::backquote($db) . '.' . PMA_Util::backquote($table);
+        $show_create_table = PMA_DBI_fetch_value($show_create_table_query, 0, 1);
+        $analyzed_sql = PMA_SQP_analyze(PMA_SQP_parse($show_create_table));
+
+        foreach ($analyzed_sql[0]['foreign_keys'] as $one_key) {
+            // The analyzer may return more than one column name in the
+            // index list or the ref_index_list; if this happens,
+            // the current logic just discards the whole index; having
+            // more than one index field is currently unsupported (see FAQ 3.6)
+            if (count($one_key['index_list']) == 1) {
+                foreach ($one_key['index_list'] as $i => $field) {
+                    // If a foreign key is defined in the 'internal' source (pmadb)
+                    // and as a native foreign key, we won't get it twice
+                    // if $source='both' because we use $field as key
+
+                    // The parser looks for a CONSTRAINT clause just before
+                    // the FOREIGN KEY clause. It finds it (as output from
+                    // SHOW CREATE TABLE) in MySQL 4.0.13, but not in older
+                    // versions like 3.23.58.
+                    // In those cases, the FOREIGN KEY parsing will put numbers
+                    // like -1, 0, 1... instead of the constraint number.
+
+                    if (isset($one_key['constraint'])) {
+                        $foreign[$field]['constraint'] = $one_key['constraint'];
+                    }
+
+                    if (isset($one_key['ref_db_name'])) {
+                        $foreign[$field]['foreign_db'] = $one_key['ref_db_name'];
+                    } else {
+                        $foreign[$field]['foreign_db'] = $db;
+                    }
+                    $foreign[$field]['foreign_table'] = $one_key['ref_table_name'];
+                    $foreign[$field]['foreign_field'] = $one_key['ref_index_list'][$i];
+                    if (isset($one_key['on_delete'])) {
+                        $foreign[$field]['on_delete'] = $one_key['on_delete'];
+                    }
+                    if (isset($one_key['on_update'])) {
+                        $foreign[$field]['on_update'] = $one_key['on_update'];
+                    }
+                }
+            }
+        }
+    }
+
+    /**
+     * Emulating relations for some information_schema and data_dictionary tables
+     */
+    $is_information_schema = strtolower($db) == 'information_schema';
+    $is_data_dictionary = PMA_DRIZZLE && strtolower($db) == 'data_dictionary';
+    if (($is_information_schema || $is_data_dictionary) && ($source == 'internal' || $source == 'both')) {
+        if ($is_information_schema) {
+            $relations_key = 'information_schema_relations';
+            include_once './libraries/information_schema_relations.lib.php';
+        } else {
+            $relations_key = 'data_dictionary_relations';
+            include_once './libraries/data_dictionary_relations.lib.php';
+        }
+        if (isset($GLOBALS[$relations_key][$table])) {
+            foreach ($GLOBALS[$relations_key][$table] as $field => $relations) {
+                if ((! strlen($column) || $column == $field)
+                    && (! isset($foreign[$field]) || ! strlen($foreign[$field]))
+                ) {
+                    $foreign[$field] = $relations;
+                }
+            }
+        }
+    }
+
+    return $foreign;
+} // end of the 'PMA_getForeigners()' function
+
+/**
+ * Gets the display field of a table
+ *
+ * @param string $db    the name of the db to check for
+ * @param string $table the name of the table to check for
+ *
+ * @return string   field name
+ *
+ * @access  public
+ */
+function PMA_getDisplayField($db, $table)
+{
+    $cfgRelation = PMA_getRelationsParam();
+
+    /**
+     * Try to fetch the display field from DB.
+     */
+    if ($cfgRelation['displaywork']) {
+        $disp_query = '
+             SELECT `display_field`
+               FROM ' . PMA_Util::backquote($cfgRelation['db']) . '.' . PMA_Util::backquote($cfgRelation['table_info']) . '
+              WHERE `db_name`    = \'' . PMA_Util::sqlAddSlashes($db) . '\'
+                AND `table_name` = \'' . PMA_Util::sqlAddSlashes($table) . '\'';
+
+        $row = PMA_DBI_fetch_single_row($disp_query, 'ASSOC', $GLOBALS['controllink']);
+        if (isset($row['display_field'])) {
+            return $row['display_field'];
+        }
+    }
+
+    /**
+     * Emulating the display field for some information_schema tables.
+     */
+    if ($db == 'information_schema') {
+        switch ($table) {
+        case 'CHARACTER_SETS':
+            return 'DESCRIPTION';
+        case 'TABLES':
+            return 'TABLE_COMMENT';
+        }
+    }
+
+    /**
+     * No Luck...
+     */
+    return false;
+
+} // end of the 'PMA_getDisplayField()' function
+
+/**
+ * Gets the comments for all columns of a table or the db itself
+ *
+ * @param string $db    the name of the db to check for
+ * @param string $table the name of the table to check for
+ *
+ * @return array    [column_name] = comment
+ *
+ * @access  public
+ */
+function PMA_getComments($db, $table = '')
+{
+    $comments = array();
+
+    if ($table != '') {
+        // MySQL native column comments
+        $columns = PMA_DBI_get_columns($db, $table, null, true);
+        if ($columns) {
+            foreach ($columns as $column) {
+                if (! empty($column['Comment'])) {
+                    $comments[$column['Field']] = $column['Comment'];
+                }
+            }
+        }
+    } else {
+        $comments[] = PMA_getDbComment($db);
+    }
+
+    return $comments;
+} // end of the 'PMA_getComments()' function
+
+/**
+ * Gets the comment for a db
+ *
+ * @param string $db the name of the db to check for
+ *
+ * @return string   comment
+ *
+ * @access  public
+ */
+function PMA_getDbComment($db)
+{
+    $cfgRelation = PMA_getRelationsParam();
+    $comment = '';
+
+    if ($cfgRelation['commwork']) {
+        // pmadb internal db comment
+        $com_qry = "
+             SELECT `comment`
+               FROM " . PMA_Util::backquote($cfgRelation['db']) . "." . PMA_Util::backquote($cfgRelation['column_info']) . "
+              WHERE db_name     = '" . PMA_Util::sqlAddSlashes($db) . "'
+                AND table_name  = ''
+                AND column_name = '(db_comment)'";
+        $com_rs = PMA_queryAsControlUser($com_qry, true, PMA_DBI_QUERY_STORE);
+
+        if ($com_rs && PMA_DBI_num_rows($com_rs) > 0) {
+            $row = PMA_DBI_fetch_assoc($com_rs);
+            $comment = $row['comment'];
+        }
+        PMA_DBI_free_result($com_rs);
+    }
+
+    return $comment;
+} // end of the 'PMA_getDbComment()' function
+
+/**
+ * Gets the comment for a db
+ *
+ * @access  public
+ *
+ * @return string   comment
+ */
+function PMA_getDbComments()
+{
+    $cfgRelation = PMA_getRelationsParam();
+    $comments = array();
+
+    if ($cfgRelation['commwork']) {
+        // pmadb internal db comment
+        $com_qry = "
+             SELECT `db_name`, `comment`
+               FROM " . PMA_Util::backquote($cfgRelation['db']) . "." . PMA_Util::backquote($cfgRelation['column_info']) . "
+              WHERE `column_name` = '(db_comment)'";
+        $com_rs = PMA_queryAsControlUser($com_qry, true, PMA_DBI_QUERY_STORE);
+
+        if ($com_rs && PMA_DBI_num_rows($com_rs) > 0) {
+            while ($row = PMA_DBI_fetch_assoc($com_rs)) {
+                $comments[$row['db_name']] = $row['comment'];
+            }
+        }
+        PMA_DBI_free_result($com_rs);
+    }
+
+    return $comments;
+} // end of the 'PMA_getDbComments()' function
+
+/**
+ * Set a database comment to a certain value.
+ *
+ * @param string $db      the name of the db
+ * @param string $comment the value of the column
+ *
+ * @return boolean  true, if comment-query was made.
+ *
+ * @access  public
+ */
+function PMA_setDbComment($db, $comment = '')
+{
+    $cfgRelation = PMA_getRelationsParam();
+
+    if (! $cfgRelation['commwork']) {
+        return false;
+    }
+
+    if (strlen($comment)) {
+        $upd_query = "
+             INSERT INTO
+                    " . PMA_Util::backquote($cfgRelation['db']) . "." . PMA_Util::backquote($cfgRelation['column_info']) . "
+                    (`db_name`, `table_name`, `column_name`, `comment`)
+             VALUES (
+                   '" . PMA_Util::sqlAddSlashes($db) . "',
+                   '',
+                   '(db_comment)',
+                   '" . PMA_Util::sqlAddSlashes($comment) . "')
+             ON DUPLICATE KEY UPDATE
+                `comment` = '" . PMA_Util::sqlAddSlashes($comment) . "'";
+    } else {
+        $upd_query = '
+             DELETE FROM
+                    ' . PMA_Util::backquote($cfgRelation['db']) . '.' . PMA_Util::backquote($cfgRelation['column_info']) . '
+              WHERE `db_name`     = \'' . PMA_Util::sqlAddSlashes($db) . '\'
+                AND `table_name`  = \'\'
+                AND `column_name` = \'(db_comment)\'';
+    }
+
+    if (isset($upd_query)) {
+        return PMA_queryAsControlUser($upd_query);
+    }
+
+    return false;
+} // end of 'PMA_setDbComment()' function
+
+/**
+ * Set a SQL history entry
+ *
+ * @param string $db       the name of the db
+ * @param string $table    the name of the table
+ * @param string $username the username
+ * @param string $sqlquery the sql query
+ *
+ * @return void
+ *
+ * @access  public
+ */
+function PMA_setHistory($db, $table, $username, $sqlquery)
+{
+    // Prevent to run this automatically on Footer class destroying in testsuite
+    if (defined('TESTSUITE') || strlen($sqlquery) > $GLOBALS['cfg']['MaxCharactersInDisplayedSQL']) {
+        return;
+    }
+
+    $cfgRelation = PMA_getRelationsParam();
+
+    if (! isset($_SESSION['sql_history'])) {
+        $_SESSION['sql_history'] = array();
+    }
+
+    $key = md5($sqlquery . $db . $table);
+
+    if (isset($_SESSION['sql_history'][$key])) {
+        unset($_SESSION['sql_history'][$key]);
+    }
+
+    $_SESSION['sql_history'][$key] = array(
+        'db' => $db,
+        'table' => $table,
+        'sqlquery' => $sqlquery,
+    );
+
+    if (count($_SESSION['sql_history']) > $GLOBALS['cfg']['QueryHistoryMax']) {
+        // history should not exceed a maximum count
+        array_shift($_SESSION['sql_history']);
+    }
+
+    if (! $cfgRelation['historywork'] || ! $GLOBALS['cfg']['QueryHistoryDB']) {
+        return;
+    }
+
+    PMA_queryAsControlUser(
+        'INSERT INTO
+                ' . PMA_Util::backquote($cfgRelation['db']) . '.' . PMA_Util::backquote($cfgRelation['history']) . '
+              (`username`,
+                `db`,
+                `table`,
+                `timevalue`,
+                `sqlquery`)
+        VALUES
+              (\'' . PMA_Util::sqlAddSlashes($username) . '\',
+               \'' . PMA_Util::sqlAddSlashes($db) . '\',
+               \'' . PMA_Util::sqlAddSlashes($table) . '\',
+               NOW(),
+               \'' . PMA_Util::sqlAddSlashes($sqlquery) . '\')'
+    );
+} // end of 'PMA_setHistory()' function
+
+/**
+ * Gets a SQL history entry
+ *
+ * @param string $username the username
+ *
+ * @return array    list of history items
+ *
+ * @access  public
+ */
+function PMA_getHistory($username)
+{
+    $cfgRelation = PMA_getRelationsParam();
+
+    /**
+     * if db-based history is disabled but there exists a session-based
+     * history, use it
+     */
+    if (! $GLOBALS['cfg']['QueryHistoryDB'] && isset($_SESSION['sql_history'])) {
+            return array_reverse($_SESSION['sql_history']);
+    } 
+
+    if (! $cfgRelation['historywork']) {
+        return false;
+    }
+
+    $hist_query = '
+         SELECT `db`,
+                `table`,
+                `sqlquery`
+           FROM ' . PMA_Util::backquote($cfgRelation['db']) . '.' . PMA_Util::backquote($cfgRelation['history']) . '
+          WHERE `username` = \'' . PMA_Util::sqlAddSlashes($username) . '\'
+       ORDER BY `id` DESC';
+
+    return PMA_DBI_fetch_result($hist_query, null, null, $GLOBALS['controllink']);
+} // end of 'PMA_getHistory()' function
+
+/**
+ * purges SQL history
+ *
+ * deletes entries that exceeds $cfg['QueryHistoryMax'], oldest first, for the
+ * given user
+ *
+ * @param string $username the username
+ *
+ * @return void
+ *
+ * @access  public
+ */
+function PMA_purgeHistory($username)
+{
+    $cfgRelation = PMA_getRelationsParam();
+    if (! $GLOBALS['cfg']['QueryHistoryDB'] || ! $cfgRelation['historywork']) {
+        return;
+    }
+
+    if (! $cfgRelation['historywork']) {
+        return;
+    }
+
+    $search_query = '
+         SELECT `timevalue`
+           FROM ' . PMA_Util::backquote($cfgRelation['db']) . '.' . PMA_Util::backquote($cfgRelation['history']) . '
+          WHERE `username` = \'' . PMA_Util::sqlAddSlashes($username) . '\'
+       ORDER BY `timevalue` DESC
+          LIMIT ' . $GLOBALS['cfg']['QueryHistoryMax'] . ', 1';
+
+    if ($max_time = PMA_DBI_fetch_value($search_query, 0, 0, $GLOBALS['controllink'])) {
+        PMA_queryAsControlUser(
+            'DELETE FROM
+                    ' . PMA_Util::backquote($cfgRelation['db']) . '.' . PMA_Util::backquote($cfgRelation['history']) . '
+              WHERE `username` = \'' . PMA_Util::sqlAddSlashes($username) . '\'
+                AND `timevalue` <= \'' . $max_time . '\''
+        );
+    }
+} // end of 'PMA_purgeHistory()' function
+
+/**
+ * Prepares the dropdown for one mode
+ *
+ * @param array  $foreign the keys and values for foreigns
+ * @param string $data    the current data of the dropdown
+ * @param string $mode    the needed mode
+ *
+ * @return array   the <option value=""><option>s
+ *
+ * @access  protected
+ */
+function PMA__foreignDropdownBuild($foreign, $data, $mode)
+{
+    $reloptions = array();
+
+    // id-only is a special mode used when no foreign display column
+    // is available
+    if ($mode == 'id-content' || $mode == 'id-only') {
+        // sort for id-content
+        if ($GLOBALS['cfg']['NaturalOrder']) {
+            uksort($foreign, 'strnatcasecmp');
+        } else {
+            ksort($foreign);
+        }
+    } elseif ($mode == 'content-id') {
+        // sort for content-id
+        if ($GLOBALS['cfg']['NaturalOrder']) {
+            natcasesort($foreign);
+        } else {
+            asort($foreign);
+        }
+    }
+
+    foreach ($foreign as $key => $value) {
+        if (PMA_strlen($value) <= $GLOBALS['cfg']['LimitChars']) {
+            $vtitle = '';
+            $value  = htmlspecialchars($value);
+        } else {
+            $vtitle  = htmlspecialchars($value);
+            $value  = htmlspecialchars(substr($value, 0, $GLOBALS['cfg']['LimitChars']) . '...');
+        }
+
+        $reloption = '<option value="' . htmlspecialchars($key) . '"';
+        if ($vtitle != '') {
+            $reloption .= ' title="' . $vtitle . '"';
+        }
+
+        if ((string) $key == (string) $data) {
+            $reloption .= ' selected="selected"';
+        }
+
+        if ($mode == 'content-id') {
+            $reloptions[] = $reloption . '>' . $value . '&nbsp;-&nbsp;' . htmlspecialchars($key) .  '</option>';
+        } elseif ($mode == 'id-content') {
+            $reloptions[] = $reloption . '>' . htmlspecialchars($key) .  '&nbsp;-&nbsp;' . $value . '</option>';
+        } elseif ($mode == 'id-only') {
+            $reloptions[] = $reloption . '>' . htmlspecialchars($key) . '</option>';
+        }
+    } // end foreach
+
+    return $reloptions;
+} // end of 'PMA__foreignDropdownBuild' function
+
+/**
+ * Outputs dropdown with values of foreign fields
+ *
+ * @param array  $disp_row        array of the displayed row
+ * @param string $foreign_field   the foreign field
+ * @param string $foreign_display the foreign field to display
+ * @param string $data            the current data of the dropdown (field in row)
+ * @param int    $max             maximum number of items in the dropdown
+ *
+ * @return string   the <option value=""><option>s
+ *
+ * @access  public
+ */
+function PMA_foreignDropdown($disp_row, $foreign_field, $foreign_display, $data,
+    $max = null
+) {
+    if (null === $max) {
+        $max = $GLOBALS['cfg']['ForeignKeyMaxLimit'];
+    }
+
+    $foreign = array();
+
+    // collect the data
+    foreach ($disp_row as $relrow) {
+        $key   = $relrow[$foreign_field];
+
+        // if the display field has been defined for this foreign table
+        if ($foreign_display) {
+            $value  = $relrow[$foreign_display];
+        } else {
+            $value = '';
+        } // end if ($foreign_display)
+
+        $foreign[$key] = $value;
+    } // end foreach
+
+    // put the dropdown sections in correct order
+    $top = array();
+    $bottom = array();
+    if ($foreign_display) {
+        if (PMA_isValid($GLOBALS['cfg']['ForeignKeyDropdownOrder'], 'array')) {
+            if (PMA_isValid($GLOBALS['cfg']['ForeignKeyDropdownOrder'][0])) {
+                $top = PMA__foreignDropdownBuild(
+                    $foreign,
+                    $data,
+                    $GLOBALS['cfg']['ForeignKeyDropdownOrder'][0]
+                );
+            }
+            if (PMA_isValid($GLOBALS['cfg']['ForeignKeyDropdownOrder'][1])) {
+                $bottom = PMA__foreignDropdownBuild(
+                    $foreign,
+                    $data,
+                    $GLOBALS['cfg']['ForeignKeyDropdownOrder'][1]
+                );
+            }
+        } else {
+            $top = PMA__foreignDropdownBuild($foreign, $data, 'id-content');
+            $bottom = PMA__foreignDropdownBuild($foreign, $data, 'content-id');
+        }
+    } else {
+        $top = PMA__foreignDropdownBuild($foreign, $data, 'id-only');
+    }
+
+    // beginning of dropdown
+    $ret = '<option value="">&nbsp;</option>';
+    $top_count = count($top);
+    if ($max == -1 || $top_count < $max) {
+        $ret .= implode('', $top);
+        if ($foreign_display && $top_count > 0) {
+            // this empty option is to visually mark the beginning of the
+            // second series of values (bottom)
+            $ret .= '<option value="">&nbsp;</option>';
+        }
+    }
+    if ($foreign_display) {
+        $ret .= implode('', $bottom);
+    }
+
+    return $ret;
+} // end of 'PMA_foreignDropdown()' function
+
+/**
+ * Gets foreign keys in preparation for a drop-down selector
+ *
+ * @param array  $foreigners     array of the foreign keys
+ * @param string $field          the foreign field name
+ * @param bool   $override_total whether to override the total
+ * @param string $foreign_filter a possible filter
+ * @param string $foreign_limit  a possible LIMIT clause
+ *
+ * @return array    data about the foreign keys
+ *
+ * @access  public
+ */
+
+function PMA_getForeignData($foreigners, $field, $override_total, $foreign_filter, $foreign_limit)
+{
+    // we always show the foreign field in the drop-down; if a display
+    // field is defined, we show it besides the foreign field
+    $foreign_link = false;
+    if ($foreigners && isset($foreigners[$field])) {
+        $foreigner       = $foreigners[$field];
+        $foreign_db      = $foreigner['foreign_db'];
+        $foreign_table   = $foreigner['foreign_table'];
+        $foreign_field   = $foreigner['foreign_field'];
+
+        // Count number of rows in the foreign table. Currently we do
+        // not use a drop-down if more than ForeignKeyMaxLimit rows in the
+        // foreign table,
+        // for speed reasons and because we need a better interface for this.
+        //
+        // We could also do the SELECT anyway, with a LIMIT, and ensure that
+        // the current value of the field is one of the choices.
+
+        $the_total   = PMA_Table::countRecords($foreign_db, $foreign_table, true);
+
+        if ($override_total == true || $the_total < $GLOBALS['cfg']['ForeignKeyMaxLimit']) {
+            // foreign_display can be false if no display field defined:
+            $foreign_display = PMA_getDisplayField($foreign_db, $foreign_table);
+
+            $f_query_main = 'SELECT ' . PMA_Util::backquote($foreign_field)
+                        . (($foreign_display == false) ? '' : ', ' . PMA_Util::backquote($foreign_display));
+            $f_query_from = ' FROM ' . PMA_Util::backquote($foreign_db) . '.' . PMA_Util::backquote($foreign_table);
+            $f_query_filter = empty($foreign_filter) ? '' : ' WHERE ' . PMA_Util::backquote($foreign_field)
+                            . ' LIKE "%' . PMA_Util::sqlAddSlashes($foreign_filter, true) . '%"'
+                            . (($foreign_display == false) ? '' : ' OR ' . PMA_Util::backquote($foreign_display)
+                                . ' LIKE "%' . PMA_Util::sqlAddSlashes($foreign_filter, true) . '%"'
+                                );
+            $f_query_order = ($foreign_display == false) ? '' :' ORDER BY ' . PMA_Util::backquote($foreign_table) . '.' . PMA_Util::backquote($foreign_display);
+            $f_query_limit = isset($foreign_limit) ? $foreign_limit : '';
+
+            if (!empty($foreign_filter)) {
+                $res = PMA_DBI_query('SELECT COUNT(*)' . $f_query_from . $f_query_filter);
+                if ($res) {
+                    $the_total = PMA_DBI_fetch_value($res);
+                    @PMA_DBI_free_result($res);
+                } else {
+                    $the_total = 0;
+                }
+            }
+
+            $disp  = PMA_DBI_query($f_query_main . $f_query_from . $f_query_filter . $f_query_order . $f_query_limit);
+            if ($disp && PMA_DBI_num_rows($disp) > 0) {
+                // If a resultset has been created, pre-cache it in the $disp_row array
+                // This helps us from not needing to use mysql_data_seek by accessing a pre-cached
+                // PHP array. Usually those resultsets are not that big, so a performance hit should
+                // not be expected.
+                $disp_row = array();
+                while ($single_disp_row = @PMA_DBI_fetch_assoc($disp)) {
+                    $disp_row[] = $single_disp_row;
+                }
+                @PMA_DBI_free_result($disp);
+            }
+        } else {
+            $disp_row = null;
+            $foreign_link = true;
+        }
+    }  // end if $foreigners
+
+    $foreignData['foreign_link'] = $foreign_link;
+    $foreignData['the_total'] = isset($the_total) ? $the_total : null;
+    $foreignData['foreign_display'] = isset($foreign_display) ? $foreign_display : null;
+    $foreignData['disp_row'] = isset($disp_row) ? $disp_row : null;
+    $foreignData['foreign_field'] = isset($foreign_field) ? $foreign_field : null;
+    return $foreignData;
+} // end of 'PMA_getForeignData()' function
+
+/**
+ * Finds all related tables
+ *
+ * @param array  $all_tables All the involved tables
+ * @param string $master     The master table to form the LEFT JOIN clause
+ *
+ * @return string LEFT JOIN
+ * @access  private
+ */
+function PMA_getRelatives($all_tables, $master)
+{
+    $fromclause = '';
+    $emerg = '';
+
+    // The list of tables that we still couldn't connect
+    $remaining_tables = $all_tables;
+    unset($remaining_tables[$master]);
+    // The list of allready connected tables
+    $known_tables[$master] = $master;
+    $run = 0;
+    while (count($remaining_tables) > 0) {
+        // Whether to go from master to foreign or vice versa
+        if ($run % 2 == 0) {
+            $from = 'master';
+            $to    = 'foreign';
+        } else {
+            $from = 'foreign';
+            $to    = 'master';
+        }
+        $in_know = '(\'' . implode('\', \'', $known_tables) . '\')';
+        $in_left = '(\'' . implode('\', \'', $remaining_tables) . '\')';
+        $rel_query = 'SELECT *'
+                   . '  FROM ' . PMA_Util::backquote($GLOBALS['cfgRelation']['db'])
+                   .       '.' . PMA_Util::backquote($GLOBALS['cfgRelation']['relation'])
+                   . ' WHERE ' . $from . '_db = \'' . PMA_Util::sqlAddSlashes($GLOBALS['db']) . '\''
+                   . '   AND ' . $to   . '_db = \'' . PMA_Util::sqlAddSlashes($GLOBALS['db']) . '\''
+                   . '   AND ' . $from . '_table IN ' . $in_know
+                   . '   AND ' . $to   . '_table IN ' . $in_left;
+        $relations = @PMA_DBI_query($rel_query, $GLOBALS['controllink']);
+        while ($row = PMA_DBI_fetch_assoc($relations)) {
+            $found_table                = $row[$to . '_table'];
+            if (isset($remaining_tables[$found_table])) {
+                $fromclause
+                    .= "\n" . ' LEFT JOIN '
+                    . PMA_Util::backquote($GLOBALS['db']) . '.' . PMA_Util::backquote($row[$to . '_table']) . ' ON '
+                    . PMA_Util::backquote($row[$from . '_table']) . '.'
+                    . PMA_Util::backquote($row[$from . '_field']) . ' = '
+                    . PMA_Util::backquote($row[$to . '_table']) . '.'
+                    . PMA_Util::backquote($row[$to . '_field']) . ' ';
+                $known_tables[$found_table] = $found_table;
+                unset($remaining_tables[$found_table]);
+            }
+        } // end while
+        $run++;
+        if ($run > 5) {
+            foreach ($remaining_tables as $table) {
+                $emerg .= ', ' . PMA_Util::backquote($table);
+                unset($remaining_tables[$table]);
+            }
+        }
+    } // end while
+    $fromclause = $emerg . $fromclause;
+    return $fromclause;
+} // end of the "PMA_getRelatives()" function
+
+/**
+ * Rename a field in relation tables
+ *
+ * usually called after a column in a table was renamed
+ *
+ * @param string $db       databse name
+ * @param string $table    table name
+ * @param string $field    old field name
+ * @param string $new_name new field name
+ *
+ * @return void
+ */
+function PMA_REL_renameField($db, $table, $field, $new_name)
+{
+    $cfgRelation = PMA_getRelationsParam();
+
+    if ($cfgRelation['displaywork']) {
+        $table_query = 'UPDATE '
+            . PMA_Util::backquote($cfgRelation['db']) . '.'
+            . PMA_Util::backquote($cfgRelation['table_info'])
+            . '   SET display_field = \'' . PMA_Util::sqlAddSlashes($new_name) . '\''
+            . ' WHERE db_name       = \'' . PMA_Util::sqlAddSlashes($db) . '\''
+            . '   AND table_name    = \'' . PMA_Util::sqlAddSlashes($table) . '\''
+            . '   AND display_field = \'' . PMA_Util::sqlAddSlashes($field) . '\'';
+        PMA_queryAsControlUser($table_query);
+    }
+
+    if ($cfgRelation['relwork']) {
+        $table_query = 'UPDATE '
+            . PMA_Util::backquote($cfgRelation['db']) . '.'
+            . PMA_Util::backquote($cfgRelation['relation'])
+            . '   SET master_field = \'' . PMA_Util::sqlAddSlashes($new_name) . '\''
+            . ' WHERE master_db    = \'' . PMA_Util::sqlAddSlashes($db) . '\''
+            . '   AND master_table = \'' . PMA_Util::sqlAddSlashes($table) . '\''
+            . '   AND master_field = \'' . PMA_Util::sqlAddSlashes($field) . '\'';
+        PMA_queryAsControlUser($table_query);
+
+        $table_query = 'UPDATE '
+            . PMA_Util::backquote($cfgRelation['db']) . '.'
+            . PMA_Util::backquote($cfgRelation['relation'])
+            . '   SET foreign_field = \'' . PMA_Util::sqlAddSlashes($new_name) . '\''
+            . ' WHERE foreign_db    = \'' . PMA_Util::sqlAddSlashes($db) . '\''
+            . '   AND foreign_table = \'' . PMA_Util::sqlAddSlashes($table) . '\''
+            . '   AND foreign_field = \'' . PMA_Util::sqlAddSlashes($field) . '\'';
+        PMA_queryAsControlUser($table_query);
+
+    } // end if relwork
+}
+
+
+/**
+ * Performs SQL query used for renaming table.
+ *
+ * @param string $table        Relation table to use
+ * @param string $source_db    Source database name
+ * @param string $target_db    Target database name
+ * @param string $source_table Source table name
+ * @param string $target_table Target table name
+ * @param string $db_field     Name of database field
+ * @param string $table_field  Name of table field
+ *
+ * @return nothing.
+ */
+function PMA_REL_renameSingleTable($table,
+    $source_db, $target_db,
+    $source_table, $target_table,
+    $db_field, $table_field
+) {
+    $query = 'UPDATE '
+        . PMA_Util::backquote($GLOBALS['cfgRelation']['db']) . '.'
+        . PMA_Util::backquote($GLOBALS['cfgRelation'][$table])
+        . ' SET ' . $db_field . ' = \'' . PMA_Util::sqlAddSlashes($target_db) . '\', '
+        . ' ' . $table_field . ' = \'' . PMA_Util::sqlAddSlashes($target_table) . '\''
+        . ' WHERE '
+        . $db_field . '  = \'' . PMA_Util::sqlAddSlashes($source_db) . '\''
+        . ' AND '
+        . $table_field . ' = \'' . PMA_Util::sqlAddSlashes($source_table) . '\'';
+    PMA_queryAsControlUser($query);
+}
+
+
+/**
+ * Rename a table in relation tables
+ *
+ * usually called after table has been moved
+ *
+ * @param string $source_db    Source database name
+ * @param string $target_db    Target database name
+ * @param string $source_table Source table name
+ * @param string $target_table Target table name
+ *
+ * @return nothing
+ */
+function PMA_REL_renameTable($source_db, $target_db, $source_table, $target_table)
+{
+    // Move old entries from PMA-DBs to new table
+    if ($GLOBALS['cfgRelation']['commwork']) {
+        PMA_REL_renameSingleTable(
+            'column_info',
+            $source_db, $target_db,
+            $source_table, $target_table,
+            'db_name', 'table_name'
+        );
+    }
+
+    // updating bookmarks is not possible since only a single table is
+    // moved, and not the whole DB.
+
+    if ($GLOBALS['cfgRelation']['displaywork']) {
+        PMA_REL_renameSingleTable(
+            'table_info',
+            $source_db, $target_db,
+            $source_table, $target_table,
+            'db_name', 'table_name'
+        );
+    }
+
+    if ($GLOBALS['cfgRelation']['relwork']) {
+        PMA_REL_renameSingleTable(
+            'relation',
+            $source_db, $target_db,
+            $source_table, $target_table,
+            'foreign_db', 'foreign_table'
+        );
+
+        PMA_REL_renameSingleTable(
+            'relation',
+            $source_db, $target_db,
+            $source_table, $target_table,
+            'master_db', 'master_table'
+        );
+    }
+
+    /**
+     * @todo Can't get moving PDFs the right way. The page numbers
+     * always get screwed up independently from duplication because the
+     * numbers do not seem to be stored on a per-database basis. Would
+     * the author of pdf support please have a look at it?
+     */
+
+    if ($GLOBALS['cfgRelation']['pdfwork']) {
+        PMA_REL_renameSingleTable(
+            'table_coords',
+            $source_db, $target_db,
+            $source_table, $target_table,
+            'db_name', 'table_name'
+        );
+    }
+
+    if ($GLOBALS['cfgRelation']['designerwork']) {
+        PMA_REL_renameSingleTable(
+            'designer_coords',
+            $source_db, $target_db,
+            $source_table, $target_table,
+            'db_name', 'table_name'
+        );
+    }
+}
+
+/**
+ * Create a PDF page
+ *
+ * @param string $newpage     name of the new PDF page
+ * @param array  $cfgRelation Relation configuration
+ * @param string $db          database name
+ *
+ * @return string   $pdf_page_number
+ */
+function PMA_REL_createPage($newpage, $cfgRelation, $db)
+{
+    if (! isset($newpage) || $newpage == '') {
+        $newpage = __('no description');
+    }
+    $ins_query   = 'INSERT INTO '
+        . PMA_Util::backquote($GLOBALS['cfgRelation']['db']) . '.'
+        . PMA_Util::backquote($cfgRelation['pdf_pages'])
+        . ' (db_name, page_descr)'
+        . ' VALUES (\''
+        . PMA_Util::sqlAddSlashes($db) . '\', \''
+        . PMA_Util::sqlAddSlashes($newpage) . '\')';
+    PMA_queryAsControlUser($ins_query, false);
+
+    return PMA_DBI_insert_id(
+        isset($GLOBALS['controllink']) ? $GLOBALS['controllink'] : ''
+    );
+}
+?>