]> git.mxchange.org Git - mailer.git/blobdiff - inc/ajax/ajax_installer.php
More stuff for mysql3->mysql switch.
[mailer.git] / inc / ajax / ajax_installer.php
index d6041f458c1aae399de680d296ecc30352c5ef8e..eea4629ee956909843db01033d9a79a452daf530 100644 (file)
  * -------------------------------------------------------------------- *
  * Kurzbeschreibung  : AJAX-bezogene Funktionen fuer Installer          *
  * -------------------------------------------------------------------- *
- * $Revision::                                                        $ *
- * $Date::                                                            $ *
- * $Tag:: 0.2.1-FINAL                                                 $ *
- * $Author::                                                          $ *
- * -------------------------------------------------------------------- *
  * Copyright (c) 2003 - 2009 by Roland Haeder                           *
- * Copyright (c) 2009 - 2012 by Mailer Developer Team                   *
+ * Copyright (c) 2009 - 2013 by Mailer Developer Team                   *
  * For more information visit: http://mxchange.org                      *
  *                                                                      *
  * This program is free software; you can redistribute it and/or modify *
 // Some security stuff...
 if (!defined('__SECURITY')) {
        die();
+} elseif ((!isAjaxOutputMode()) || (!isInstaller())) {
+       header('HTTP/1.1 403 Forbidden');
+       die(json_encode(array('reply_content' => 'Access forbidden'), JSON_FORCE_OBJECT));
 } // END - if
 
+//-----------------------------------------------------------------------------
+//         Generic call-back functions, they all rely on session data
+//-----------------------------------------------------------------------------
+
+// Establish a database link
+function establishAjaxInstallerDatabaseLink () {
+       // This requires some session data
+       if (!isSessionDataSet(array('mysql_host', 'mysql_dbase', 'mysql_prefix', 'mysql_login', 'mysql_password1', 'mysql_password2', 'mysql_engine', 'database_extension'))) {
+               // Some required session data is not set
+               reportBug(__FUNCTION__, __LINE__, 'Required session data for this step not found.');
+       } // END - if
+
+       // Remove any previous flag
+       unsetSqlLinkUp(__FUNCTION__, __LINE__);
+
+       // Establish link
+       $linkResource = sqlConnectToDatabase(getSession('mysql_host'), getSession('mysql_login'), getSession('mysql_password1'), __FUNCTION__, __LINE__);
+
+       // Is this a link resource?
+       if (!isValidSqlLink($linkResource)) {
+               // Is not a resource
+               reportBug(__FUNCTION__, __LINE__, 'linkResource[]=' . gettype($linkResource) . ', expected: link resource');
+       } elseif (!isSqlLinkUp()) {
+               // SQL link is not up
+               reportBug(__FUNCTION__, __LINE__, 'Could not bring up SQL link.');
+       }
+
+       // Does selecting the database work?
+       if (!sqlSelectDatabase(getSession('mysql_dbase'), __FUNCTION__, __LINE__)) {
+               // Could not be selected
+               reportBug(__FUNCTION__, __LINE__, 'Could not select database ' . getSession('mysql_dbase'));
+       } elseif (!isInstallerSqlsReadable(getSession('base_path'))) {
+               // Installation area not found
+               reportBug(__FUNCTION__, __LINE__, 'SQL dumps not found. Please extract ALL files from the archive or checkout all files out from SVN.');
+       } elseif (ifFatalErrorsDetected()) {
+               // Some other fatal error occured
+               reportBug(__FUNCTION__, __LINE__, 'Some fatal error detected, please check debug.log for details.');
+       }
+
+       // Set type, prefix from POST data and database name for later queries
+       setConfigEntry('_TABLE_TYPE'  , getSession('mysql_engine'));
+       setConfigEntry('_DB_TYPE'     , getSession('database_extension'));
+       setConfigEntry('_MYSQL_PREFIX', getSession('mysql_prefix'));
+       setConfigEntry('__DB_NAME'    , getSession('mysql_dbase'));
+}
+
 //-----------------------------------------------------------------------------
 //             Call-back functions for processing AJAX requests
 //-----------------------------------------------------------------------------
@@ -47,7 +91,7 @@ if (!defined('__SECURITY')) {
 // Processes AJAX requests for installer
 function doAjaxProcessInstall () {
        // 'do' must always be set and installation phase must be true
-       if (!isInstallationPhase()) {
+       if (!isInstaller()) {
                // This shall not happen
                reportBug(__FUNCTION__, __LINE__, 'This AJAX request handler was called outside the installer.');
        } elseif (!isPostRequestElementSet('do')) {
@@ -56,10 +100,11 @@ function doAjaxProcessInstall () {
        } // END - if
 
        // Notify all modules that we are installing
-       $GLOBALS['__mailer_installing'] =  true;
+       $GLOBALS['__mailer_installing'] = TRUE;
 
        // Again we do a call-back, so generate a function name depending on 'do'
        $callbackName = 'doAjaxInstaller' . capitalizeUnderscoreString(postRequestElement('do'));
+       $GLOBALS['ajax_callback_function'] = $callbackName;
 
        // Is the call-back function there?
        if (!function_exists($callbackName)) {
@@ -100,6 +145,8 @@ function doAjaxInstallerFooterNavigation () {
                case 'database_config':
                case 'smtp_config':
                case 'other_config':
+               case 'extensions':
+               case 'first_admin':
                        array_push($enabledNavigations, 'previous');
                case 'welcome': // Only 'next' works for welcome page
                        array_push($enabledNavigations, 'next');
@@ -107,6 +154,10 @@ function doAjaxInstallerFooterNavigation () {
 
                case 'overview': // Enable only 'previous'
                        array_push($enabledNavigations, 'previous');
+                       if (isInstallationDataCompleted()) {
+                               // Add 'finish'
+                               array_push($enabledNavigations, 'finish');
+                       } // END - if
                        break;
 
                default: // Unsupported value
@@ -118,12 +169,42 @@ function doAjaxInstallerFooterNavigation () {
        } // END - switch
 
        // Output the array for JSON reply
-       setAjaxReplyContent(json_encode($enabledNavigations, JSON_FORCE_OBJECT));
+       setAjaxReplyContent(encodeJson($enabledNavigations));
 
        // All okay if we reach this point
        setHttpStatus('200 OK');
 }
 
+// Processes installer AJAX calls for content-requests
+function doAjaxInstallerDoStep () {
+       // 'step' must be there
+       if (!isPostRequestElementSet('step')) {
+               // This shall not happen
+               reportBug(__FUNCTION__, __LINE__, 'The JavaScript did not send "step" which is fatal.');
+       } // END - if
+
+       // Construct call-back name
+       $callbackName = 'doAjaxInstallerStep' . capitalizeUnderscoreString(postRequestElement('step'));
+
+       // Is the function there?
+       if (function_exists($callbackName)) {
+               // Call it for setting values in session
+               $status = call_user_func($callbackName);
+       } else {
+               // Log missing functions
+               reportBug(__FUNCTION__, __LINE__, 'Call-back function ' . $callbackName . ' does not exist.');
+       }
+
+       // Did the installation step went fine?
+       if ($status === TRUE) {
+               // All fine
+               setAjaxReplyContent(encodeJson(postRequestElement('step') . '=OK'));
+
+               // All okay if we reach this point
+               setHttpStatus('200 OK');
+       } // END - if
+}
+
 // Processes installer AJAX calls for content-requests
 function doAjaxInstallerRequestContent () {
        // 'tab' must be there
@@ -141,7 +222,7 @@ function doAjaxInstallerRequestContent () {
                call_user_func($callbackName);
        } else {
                // Log missing functions
-               logDebugMessage(__FUNCTION__, __LINE__, 'Call-back function ' . $callbackName . ' does not exist.');
+               reportBug(__FUNCTION__, __LINE__, 'Call-back function ' . $callbackName . ' does not exist.');
        }
 
        // Is the HTTP status still the same? (204 No Content)
@@ -155,7 +236,7 @@ function doAjaxInstallerRequestContent () {
                        setHttpStatus('200 OK');
                } else {
                        // Set 404 error
-                       setHttpStatus('404 NOT FOUND');
+                       setHttpStatus('404 Not Found');
                }
        } // END - if
 }
@@ -171,8 +252,14 @@ function doAjaxInstallerChangeWarning () {
        // "Walk" through all elements
        $OUT = '<ol>';
        foreach (explode(':', postRequestElement('elements')) as $element) {
-               // Add row
-               $OUT .= '<li>{--INSTALLER_CHANGED_ELEMENT_' . strtoupper($element) . '--}</li>';
+               // Is it an extension?
+               if (substr($element, 0, 4) == 'ext_') {
+                       // Add row for extension
+                       $OUT .= '<li>{%message,INSTALLER_CHANGED_ELEMENT_EXTENSION=' . str_replace('_', '-', $element) . '%}</li>';
+               } else {
+                       // Add generic row
+                       $OUT .= '<li>{--INSTALLER_CHANGED_ELEMENT_' . strtoupper($element) . '--}</li>';
+               }
        } // END - foreach
        $OUT .= '</ol>';
 
@@ -207,7 +294,7 @@ function doAjaxInstallerSaveChanges () {
        $currentTab = postRequestElement('tab');
 
        // Remove some elements which should not be saved
-       foreach (array('do', 'level') as $removedElement) {
+       foreach (array('tab', 'do', 'level') as $removedElement) {
                // Remove this element from POST data
                unsetPostRequestElement($removedElement);
        } // END - foreach
@@ -227,17 +314,18 @@ function doAjaxInstallerSaveChanges () {
        // Now set all remaining data in session
        foreach (postRequestArray() as $key => $value) {
                // Set it, if it is valid, else it will be added to $saveStatus (call-by-reference)
+               //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'key=' . $key . ',value[' . gettype($value) . '=' . $value);
                $saveStatus['is_saved'] = (
                        // Is the data valid?
                        (isInstallerDataValid($saveStatus, $key, $value))
                &&
                        // And can it be stored in session?
-                       (setSession($key, $value))
+                       (setSessionCompiled($key, $value))
                );
 
                // Save the overall status for below final check
                $isAllSaved = (($isAllSaved === TRUE) && ($saveStatus['is_saved'] === TRUE));
-               //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'key=' . $key . ',value=' . $value . ',is_saved=' . intval($saveStatus['is_saved']) . ',isAllSaved=' . intval($isAllSaved));
+               //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'key=' . $key . ',value[' . gettype($value) . '=' . $value . ',is_saved=' . intval($saveStatus['is_saved']) . ',isAllSaved=' . intval($isAllSaved));
        } // END - foreach
 
        // 'is_saved' is still true?
@@ -251,12 +339,16 @@ function doAjaxInstallerSaveChanges () {
        } // END - if
 
        // Output the status array for JSON reply
-       setAjaxReplyContent(json_encode($saveStatus, JSON_FORCE_OBJECT));
+       setAjaxReplyContent(encodeJson($saveStatus));
 
        // All okay if we reach this point
        setHttpStatus('200 OK');
 }
 
+// ----------------------------------------------------------------------------
+//          Call-back functions for preparing installer page requests
+// ----------------------------------------------------------------------------
+
 // Prepare AJAX request 'welcome'
 function doAjaxPrepareInstallerWelcome () {
        // Kept empty to prevent logfile entry
@@ -267,31 +359,31 @@ function doAjaxPrepareInstallerBaseData () {
        // Is 'base_path' not set?
        if (!isSessionVariableSet('base_path')) {
                // Then set it from PATH
-               setSession('base_path', getPath());
+               setSessionCompiled('base_path', getPath());
        } // END - if
 
        // Is 'base_url' not set?
        if (!isSessionVariableSet('base_url')) {
                // Then set it from URL
-               setSession('base_url', getUrl());
+               setSessionCompiled('base_url', getUrl());
        } // END - if
 
        // Is 'main_title' not set?
        if (!isSessionVariableSet('main_title')) {
                // Then set it from default main title
-               setSession('main_title', '{--DEFAULT_MAIN_TITLE--}');
+               setSessionCompiled('main_title', compileRawCode(getMessage('DEFAULT_MAIN_TITLE')));
        } // END - if
 
        // Is 'slogan' not set?
        if (!isSessionVariableSet('slogan')) {
                // Then set it from default slogan
-               setSession('slogan', '{--DEFAULT_SLOGAN--}');
+               setSessionCompiled('slogan', compileRawCode(getMessage('DEFAULT_SLOGAN')));
        } // END - if
 
        // Is 'webmaster' not set?
        if (!isSessionVariableSet('webmaster')) {
                // Then set it from default webmaster email address
-               setSession('webmaster', '{--DEFAULT_WEBMASTER--}');
+               setSessionCompiled('webmaster', '{--DEFAULT_WEBMASTER--}');
        } // END - if
 }
 
@@ -300,43 +392,49 @@ function doAjaxPrepareInstallerDatabaseConfig () {
        // Is 'mysql_host' not set?
        if (!isSessionVariableSet('mysql_host')) {
                // Then set it directly
-               setSession('mysql_host', 'localhost');
+               setSessionCompiled('mysql_host', 'localhost');
        } // END - if
 
        // Is 'mysql_dbase' not set?
        if (!isSessionVariableSet('mysql_dbase')) {
                // Then set it directly
-               setSession('mysql_dbase', 'your_database');
+               setSessionCompiled('mysql_dbase', 'your_database');
        } // END - if
 
        // Is 'mysql_prefix' not set?
        if (!isSessionVariableSet('mysql_prefix')) {
                // Then set it directly
-               setSession('mysql_prefix', 'mailer');
+               setSessionCompiled('mysql_prefix', 'mailer');
        } // END - if
 
        // Is 'mysql_login' not set?
        if (!isSessionVariableSet('mysql_login')) {
                // Then set it directly
-               setSession('mysql_login', 'your_login');
+               setSessionCompiled('mysql_login', 'your_login');
        } // END - if
 
        // Is 'mysql_dbase' not set?
-       if (!isSessionVariableSet('mysql_pass1')) {
+       if (!isSessionVariableSet('mysql_password1')) {
+               // Then set it directly
+               setSessionCompiled('mysql_password1', '');
+       } // END - if
+
+       // Is 'mysql_password2' not set?
+       if (!isSessionVariableSet('mysql_password2')) {
                // Then set it directly
-               setSession('mysql_pass1', '');
+               setSessionCompiled('mysql_password2', '');
        } // END - if
 
-       // Is 'mysql_pass2' not set?
-       if (!isSessionVariableSet('mysql_pass2')) {
+       // Is 'mysql_engine' not set?
+       if (!isSessionVariableSet('mysql_engine')) {
                // Then set it directly
-               setSession('mysql_pass2', '');
+               setSessionCompiled('mysql_engine', 'MyISAM');
        } // END - if
 
-       // Is 'mysql_type' not set?
-       if (!isSessionVariableSet('mysql_type')) {
+       // Is 'mysql_engine' not set?
+       if (!isSessionVariableSet('database_extension')) {
                // Then set it directly
-               setSession('mysql_type', 'MyISAM');
+               setSessionCompiled('database_extension', 'mysqli');
        } // END - if
 }
 
@@ -350,25 +448,67 @@ function doAjaxPrepareInstallerOtherConfig () {
        // Is 'output_mode' not set?
        if (!isSessionVariableSet('output_mode')) {
                // Then set it directly
-               setSession('output_mode', 'render');
+               setSessionCompiled('output_mode', 'render');
        } // END - if
 
        // Is 'warn_no_pass' not set?
        if (!isSessionVariableSet('warn_no_pass')) {
                // Then set it directly
-               setSession('warn_no_pass', 'Y');
+               setSessionCompiled('warn_no_pass', 'Y');
        } // END - if
 
        // Is 'write_footer' not set?
        if (!isSessionVariableSet('write_footer')) {
                // Then set it directly
-               setSession('write_footer', 'Y');
+               setSessionCompiled('write_footer', 'Y');
        } // END - if
 
        // Is 'enable_backlink' not set?
        if (!isSessionVariableSet('enable_backlink')) {
                // Then set it directly
-               setSession('enable_backlink', 'Y');
+               setSessionCompiled('enable_backlink', 'Y');
+       } // END - if
+}
+
+// Prepare AJAX request 'extensions'
+function doAjaxPrepareInstallerExtensions () {
+       // Is 'extensions' set?
+       if (!isSessionVariableSet('extensions')) {
+               /*
+                * At least ext-admins, ext-sql_patches and ext-task should be installed
+                * (ext-sql_patches is a must!)
+                */
+               setSessionCompiled('extensions', 'admins:sql_patches:task');
+       } elseif (strpos(getSession('extensions'), 'sql_patches') === FALSE) {
+               // Add missing ext-sql_patches
+               setSessionCompiled('extensions', getSession('extensions') . ':sql_patches');
+       }
+}
+
+// Prepare AJAX request 'first_admin'
+function doAjaxPrepareInstallerFirstAdmin () {
+       // Is 'admin_login' set?
+       if (!isSessionVariableSet('admin_login')) {
+               // Set it
+               setSessionCompiled('admin_login', 'admin');
+       } // END - if
+
+       // Is 'admin_email' set?
+       if (!isSessionVariableSet('admin_email')) {
+               // Set it
+               setSessionCompiled('admin_email', getSession('webmaster'));
+       } // END - if
+
+       // Is 'admin_password1' set?
+       if (!isSessionVariableSet('admin_password1')) {
+               // Set it
+               setSessionCompiled('admin_password1', '');
+       } // END - if
+
+       // Is 'admin_password2' set?
+       if (!isSessionVariableSet('admin_password2')) {
+               // Set it
+               setSessionCompiled('admin_password2', '');
        } // END - if
 }
 
@@ -400,12 +540,9 @@ function doAjaxPrepareInstallerOverview () {
        $output     = '';
 
        // Check all data in session
-       foreach (getSessionArray() as $key => $value) {
-               // Skip 'mailer_theme', 'tab' and 'installer'
-               if (in_array($key, array('mailer_theme', 'tab', 'installer'))) {
-                       // Skip this
-                       continue;
-               } // END - if
+       foreach (array_keys($GLOBALS['installer_groups']) as $key) {
+               // Get values from session
+               $value = getSession($key);
 
                // Is the data valid?
                $verificationStatus['is_valid'] = (isInstallerDataValid($verificationStatus, $key, $value));
@@ -422,7 +559,7 @@ function doAjaxPrepareInstallerOverview () {
        } // END - foreach
 
        // Is it still true?
-       if ($isAllValid === TRUE) {
+       if ((isInstallationDataCompleted()) && ($isAllValid === TRUE)) {
                // Set 'done' and message
                $verificationStatus['status']  = 'done';
                $verificationStatus['message'] = '{--INSTALLER_OVERVIEW_FINAL_CHECK_DONE--}';
@@ -434,27 +571,189 @@ function doAjaxPrepareInstallerOverview () {
        // Is it still valid?
        if ($verificationStatus['status'] != 'done') {
                // Log message away
-               logDebugMessage(__FUNCTION__, __LINE__, 'Final check on all stored data failed. message=' . $verificationStatus['message']);
+               //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'Final check on all stored data failed. message=' . $verificationStatus['message']);
+
+               // Process failed fields
+               $verificationStatus['failed_fields'] = handleInstallerFailedFields($verificationStatus['failed_fields']);
 
                // Output the array for JSON reply
-               setAjaxReplyContent(json_encode($verificationStatus, JSON_FORCE_OBJECT));
+               setAjaxReplyContent(loadTemplate('install_overview_failed', TRUE, $verificationStatus));
 
                /*
                 * Something went wrong, this might happen when e.g. the user has tried
                 * to save invalid database login data but hit reload button on error
                 * message.
                 */
-               setHttpStatus('500 Internal Server Error');
+               setHttpStatus('200 OK');
 
                // Abort here
                return;
        } // END - if
+}
 
-       // Output final rendered content
-       setAjaxReplyContent($output);
+// ----------------------------------------------------------------------------
+//            Call-back functions for doing installation steps
+// ----------------------------------------------------------------------------
 
-       // All okay if we reach this point
-       setHttpStatus('200 OK');
+// Call-back function to import first tables.sql file
+function doAjaxInstallerStepImportTablesSql () {
+       // Establish database link
+       establishAjaxInstallerDatabaseLink();
+
+       // Init SQL array
+       initSqls();
+
+       // Import tables.sql
+       importInstallSqlDump('tables');
+
+       // Are some SQLs found?
+       if (countSqls() == 0) {
+               // Abort here
+               reportBug(__FUNCTION__, __LINE__, '{--INSTALLER_SQL_IMPORT_FAILED--}');
+       } // END - if
+
+       // Now run all queries through
+       runFilterChain('run_sqls');
+
+       // Close SQL link
+       sqlCloseLink(__FUNCTION__, __LINE__);
+
+       // All fine
+       return TRUE;
+}
+
+// Call-back function to import menu SQL file
+function doAjaxInstallerStepImportMenuSql () {
+       // Establish database link
+       establishAjaxInstallerDatabaseLink();
+
+       // Init SQL array
+       initSqls();
+
+       // Import tables.sql
+       importInstallSqlDump('menu-' . getLanguage());
+
+       // Are some SQLs found?
+       if (countSqls() == 0) {
+               // Abort here
+               reportBug(__FUNCTION__, __LINE__, '{--INSTALLER_SQL_IMPORT_FAILED--}');
+       } // END - if
+
+       // Now run all queries through
+       runFilterChain('run_sqls');
+
+       // Close SQL link
+       sqlCloseLink(__FUNCTION__, __LINE__);
+
+       // All fine
+       return TRUE;
+}
+
+// Call-back function to install some important extensions
+function doAjaxInstallerStepInstallExtensions () {
+       // Only one element is required
+       if (!isSessionVariableSet('extensions')) {
+               // Some required session data is not set
+               reportBug(__FUNCTION__, __LINE__, 'Required session data for this step not found.');
+       } // END - if
+
+       // Establish database link
+       establishAjaxInstallerDatabaseLink();
+
+       // Get all extensions
+       $extensions = explode(':', getSession('extensions'));
+
+       // Make sure ext-sql_patches is first
+       array_unshift($extensions, 'sql_patches');
+
+       // "Walk" through all extensions
+       foreach ($extensions as $key => $ext_name) {
+               // Is ext-sql_patches not at key=0?
+               if (($key == 0) && ($ext_name == 'sql_patches')) {
+                       // Then skip this entry
+                       continue;
+               } elseif ((!loadExtension($ext_name, 'test', '0.0.0', TRUE)) || (!registerExtension($ext_name, NULL))) {
+                       // Didn't work
+                       reportBug(__FUNCTION__, __LINE__, 'Cannot load/register extension ' . $ext_name . '.');
+               } // END - if
+       } // END - foreach
+
+       // All fine
+       return TRUE;
+}
+
+// Call-back function to write local configuration file
+function doAjaxInstallerStepWriteLocalConfig () {
+       // Is all set?
+       if (!isSessionDataSet(array('base_path', 'base_url', 'main_title', 'slogan', 'webmaster', 'mysql_host', 'mysql_dbase', 'mysql_prefix', 'mysql_login', 'mysql_password1', 'mysql_password2', 'mysql_engine', 'database_extension', 'output_mode', 'warn_no_pass', 'write_footer', 'enable_backlink'))) {
+               // Some required session data is not set
+               reportBug(__FUNCTION__, __LINE__, 'Required session data for this step not found.');
+       } elseif (isInstalled()) {
+               // Is already installed = local config written
+               reportBug(__FUNCTION__, __LINE__, 'Local config file is already written.');
+       } elseif (isAdminRegistered()) {
+               // Admin is already registered
+               reportBug(__FUNCTION__, __LINE__, 'First administrator account is already registered.');
+       }
+
+       // Establish database link
+       establishAjaxInstallerDatabaseLink();
+
+       // Write config file
+       if (!doInstallWriteLocalConfigurationFile(
+               getSession('base_path'),
+               getSession('base_url'),
+               getSession('main_title'),
+               getSession('slogan'),
+               getSession('webmaster'),
+               getSession('warn_no_pass'),
+               getSession('write_footer'),
+               getSession('enable_backlink'),
+               getSession('mysql_host'),
+               getSession('mysql_dbase'),
+               getSession('mysql_login'),
+               getSession('mysql_password1'),
+               getSession('mysql_prefix'),
+               getSession('mysql_engine'),
+               getSession('database_extension'),
+               getSession('smtp_host'),
+               getSession('smtp_user'),
+               getSession('smtp_password1')
+       )) {
+               // Something bad went wrong
+               removeFile(getSession('base_path') . getCachePath() . 'config-local.php');
+               reportBug(__FUNCTION__, __LINE__, 'Did not fully write config-local.php .');
+       }
+
+       // Change ADMIN_REGISTERED flag
+       $done = changeDataInLocalConfigurationFile('ADMIN-SETUP', "setConfigEntry('ADMIN_REGISTERED', '", "');", 'Y', 0);
+
+       // All fine
+       return $done;
+}
+
+// Call-back function to register first admin
+function doAjaxInstallerStepRegisterFirstAdmin () {
+       // Is all set?
+       if (!isSessionDataSet(array('admin_login', 'admin_email', 'admin_password1', 'admin_password2'))) {
+               // Some required session data is not set
+               reportBug(__FUNCTION__, __LINE__, 'Required session data for this step not found.');
+       } elseif (isAdminRegistered()) {
+               // First admin is already registered
+               reportBug(__FUNCTION__, __LINE__, 'First administrator is already registered.');
+       }
+
+       // Establish database link
+       establishAjaxInstallerDatabaseLink();
+
+       // Load admin include
+       loadIncludeOnce('inc/modules/admin/admin-inc.php');
+
+       // Register first admin
+       $ret = addAdminAccount(getSession('admin_login'), md5(getSession('admin_password1')), getSession('admin_email'), 'allow');
+
+       // Did it work?
+       return ($ret == 'done');
 }
 
 // [EOF]