Minahito
minah****@users*****
2006年 11月 2日 (木) 00:01:08 JST
Index: xoops2jp/html/modules/legacy/admin/actions/ModuleInstallAction.class.php
diff -u xoops2jp/html/modules/legacy/admin/actions/ModuleInstallAction.class.php:1.1.2.2 xoops2jp/html/modules/legacy/admin/actions/ModuleInstallAction.class.php:1.1.2.3
--- xoops2jp/html/modules/legacy/admin/actions/ModuleInstallAction.class.php:1.1.2.2 Sun Oct 15 00:54:58 2006
+++ xoops2jp/html/modules/legacy/admin/actions/ModuleInstallAction.class.php Thu Nov 2 00:01:08 2006
@@ -11,13 +11,54 @@
require_once XOOPS_LEGACY_PATH."/admin/forms/ModuleInstallForm.class.php";
/**
- * Install module
+ * @brief Module Install function having possibility to extend by module developers.
+ *
+ * The precondition is that the specified module has been not installed.
+ *
+ * @section cinstall The custom-installer
+ *
+ * Module developers can use their own custom-installer in this action. Unlike
+ * the module update function, the standard installer in this action is perhaps
+ * no problems. But, duplicatable modules or some modules with the special
+ * framework may need the custom-installer.
+ *
+ * @subsection convention Convention
+ *
+ * See Legacy_ModuleInstallAction::_getInstaller().
+ *
+ * \li $modversion['legacy_installer']['installer']['class'] = {classname};
+ * \li $modversion['legacy_installer']['installer']['namespace'] = {namespace}; (Optional)
+ * \li $modversion['legacy_installer']['installer']['filepath'] = {filepath}; (Optional)
+ *
+ * You must declare your sub-class of Legacy_ModuleInstaller as
+ * {namespace}_{classname} in {filepath}. You must specify classname. Others
+ * are decided by the naming convention without your descriptions. Namespace
+ * is ucfirst(dirname). Filepath is "admin/class/{classname}.class.php".
+ *
+ * For example, "news" module.
+ *
+ * $modversion['legacy_installer']['installer']['class'] = "Installer";
+ *
+ * You must declare News_Installer in XOOPS_ROOT_PATH . "/modules/news/admin/class/Installerr.class.php".
+ *
+ * In the case where you specify the filepath, take care you describe the
+ * filepath with absolute path.
+ *
+ * @subsection process Install Process
+ *
+ * \li Gets a instance of the installer class through Legacy_ModuleInstallAction::_getInstaller().
+ * \li Sets the new XoopsModule built from xoops_version, to the instance.
+ * \li Sets a value indicating whether an administrator hopes the force-mode, to the instance.
+ * \li Calls executeInstall().
+ *
+ * @see Legacy_ModuleInstallAction::_getInstaller()
+ * @see Legacy_ModuleInstaller
+ * @see Legacy_ModuleInstallUtils
+ *
+ * @todo These classes are good to abstract again.
*/
-class Legacy_ModuleInstallAction extends Legacy_AbstractModuleInstallAction
+class Legacy_ModuleInstallAction extends Legacy_Action
{
- var $mLicence;
- var $mLicenceText;
-
/**
* @var XCube_Delegate
*/
@@ -28,9 +69,21 @@
*/
var $mInstallFail = null;
+ /**
+ * @private
+ * @var XoopsModule
+ */
+ var $mXoopsModule = null;
+
+ /**
+ * @private
+ * @var Legacy_ModuleUinstaller
+ */
+ var $mInstaller = null;
+
function Legacy_ModuleInstallAction($flag)
{
- parent::Legacy_AbstractModuleInstallAction($flag);
+ parent::Legacy_Action($flag);
$this->mInstallSuccess =& new XCube_Delegate();
$this->mInstallSuccess->register('Legacy_ModuleInstallAction.InstallSuccess');
@@ -39,58 +92,136 @@
$this->mInstallFail->register('Legacy_ModuleInstallAction.InstallFail');
}
- function &_getInstaller($dirname)
+ function prepare(&$controller, &$xoopsUser)
{
- $installer =& new Legacy_ModuleInstaller($dirname);
+ $dirname = $controller->mRoot->mContext->mRequest->getRequest('dirname');
+
+ $handler =& xoops_gethandler('module');
+ $this->mXoopsModule =& $handler->getByDirname($dirname);
+
+ if (is_object($this->mXoopsModule)) {
+ return false;
+ }
+
+ $this->mXoopsModule =& $handler->create();
+ $this->mXoopsModule->set('weight', 1);
+ $this->mXoopsModule->loadInfoAsVar($dirname);
+
+ if ($this->mXoopsModule->get('dirname') == null) {
+ return null;
+ }
+
+ if ($this->mXoopsModule->get('dirname') == 'system') {
+ $this->mXoopsModule->set('mid', 1);
+ }
+
+ $this->_setupActionForm();
+
+ $this->mInstaller =& $this->_getInstaller();
+
+ //
+ // Set the current object.
+ //
+ $this->mInstaller->setCurrentXoopsModule($this->mXoopsModule);
+
+ return true;
+ }
+
+ function &_getInstaller()
+ {
+ $dirname = $this->mXoopsModule->get('dirname');
+ $this->mXoopsModule->loadInfo($dirname, false);
+
+ $info = $this->mXoopsModule->modinfo;
+
+ if (isset($info['legacy_installer']) && is_array($info['legacy_installer']) && isset($info['legacy_installer']['installer'])) {
+ $updateInfo = $info['legacy_installer']['installer'];
+
+ $className = $updateInfo['class'];
+ $filePath = isset($updateInfo['filepath']) ? $updateInfo['filepath'] : XOOPS_MODULE_PATH . "/${dirname}/admin/class/${className}.class.php";
+ $namespace = isset($updateInfo['namespace']) ? $updateInfo['namespace'] : ucfirst($dirname);
+
+ if ($namespace != null) {
+ $className = "${namespace}_${className}";
+ }
+
+ if (!class_exists($className) && file_exists($filePath)) {
+ require_once $filePath;
+ }
+
+ if (class_exists($className)) {
+ $installer =& new $className();
+ return $installer;
+ }
+ }
+
+ $installer =& new Legacy_ModuleInstaller();
return $installer;
}
-
+
function _setupActionForm()
{
$this->mActionForm =& new Legacy_ModuleInstallForm();
$this->mActionForm->prepare();
}
- function executeViewSuccess(&$controller,&$xoopsUser,&$renderer)
+ function getDefaultView(&$controller, &$xoopsUser)
+ {
+ $this->mActionForm->load($this->mXoopsModule);
+
+ return LEGACY_FRAME_VIEW_INPUT;
+ }
+
+ function execute(&$controller, &$xoopsUser)
{
- if (!$this->mLog->hasError()) {
- $this->mInstallSuccess->call(new XCube_Ref($this->mModuleObject), new XCube_Ref($this->mLog));
- XCube_DelegateUtils::call('Legacy.Admin.Event.ModuleInstall.' . ucfirst($this->mModuleObject->get('dirname') . '.Success'), new XCube_Ref($this->mModuleObject), new XCube_Ref($this->mLog));
+ if (isset($_REQUEST['_form_control_cancel'])) {
+ return LEGACY_FRAME_VIEW_CANCEL;
}
- else {
- $this->mInstallFail->call(new XCube_Ref($this->mModuleObject), new XCube_Ref($this->mLog));
- XCube_DelegateUtils::call('Legacy.Admin.Event.ModuleInstall.' . ucfirst($this->mModuleObject->get('dirname') . '.Fail'), new XCube_Ref($this->mModuleObject), new XCube_Ref($this->mLog));
+
+ $this->mActionForm->fetch();
+ $this->mActionForm->validate();
+
+ if ($this->mActionForm->hasError()) {
+ return $this->getDefaultView($controller, $xoopsUser);
}
+
+ $this->mInstaller->setForceMode($this->mActionForm->get('force'));
+ $this->mInstaller->executeInstall();
- $renderer->setTemplateName("module_install_success.html");
- $renderer->setAttribute('module', $this->mModuleObject);
- $renderer->setAttribute('log', $this->mLog->mMessages);
+ return LEGACY_FRAME_VIEW_SUCCESS;
}
-
- function executeViewIndex(&$controller,&$xoopsUser,&$renderer)
+
+ /**
+ * @todo no $renderer. It should be $render.
+ */
+ function executeViewSuccess(&$controller,&$xoopsUser,&$renderer)
{
- $renderer->setAttribute('module', $this->mModuleObject);
- $renderer->setAttribute('actionForm', $this->mActionForm);
-
- if (isset($this->mModuleObject->modinfo['installer'])) {
- //
- // Jump
- //
- $controller->executeForward('index.php?action=InstallWizard&dirname=' . $this->mModuleObject->get('dirname'));
+ if (!$this->mInstaller->mLog->hasError()) {
+ $this->mInstallSuccess->call(new XCube_Ref($this->mXoopsModule), new XCube_Ref($this->mInstaller->mLog));
+ XCube_DelegateUtils::call('Legacy.Admin.Event.ModuleInstall.' . ucfirst($this->mXoopsModule->get('dirname') . '.Success'), new XCube_Ref($this->mXoopsModule), new XCube_Ref($this->mInstaller->mLog));
}
else {
- $renderer->setTemplateName("module_install.html");
+ $this->mInstallFail->call(new XCube_Ref($this->mXoopsModule), new XCube_Ref($this->mInstaller->mLog));
+ XCube_DelegateUtils::call('Legacy.Admin.Event.ModuleInstall.' . ucfirst($this->mXoopsModule->get('dirname') . '.Fail'), new XCube_Ref($this->mXoopsModule), new XCube_Ref($this->mInstaller->mLog));
}
+
+ $renderer->setTemplateName("module_install_success.html");
+ $renderer->setAttribute('module', $this->mXoopsModule);
+ $renderer->setAttribute('log', $this->mInstaller->mLog->mMessages);
}
- function executeViewInput(&$controller, &$xoopsUser, &$renderer)
+ /**
+ * @todo no $renderer. It should be $render.
+ */
+ function executeViewInput(&$controller,&$xoopsUser,&$renderer)
{
$renderer->setTemplateName("module_install.html");
- $renderer->setAttribute('module', $this->mModuleObject);
+ $renderer->setAttribute('module', $this->mXoopsModule);
$renderer->setAttribute('actionForm', $this->mActionForm);
+ $renderer->setAttribute('currentVersion', round($this->mXoopsModule->get('version') / 100, 2));
}
-
- function executeViewCancel(&$controller, &$xoopsUser, &$renderer)
+
+ function executeViewCancel(&$controller, &$xoopsUser, &$render)
{
$controller->executeForward("./index.php?action=InstallList");
}