AdminAddLocaleAction 類別 參考文件
[Action]

類別AdminAddLocaleAction的繼承圖:

全部成員列表

公開方法(Public Methods)
	AdminAddLocaleAction ($actionInfo, $request)
	validate ()
	_performUploadLocale ()
	perform ()
私有方法(Private Methods)
	_performScanLocales ()

---

詳細描述

Takes care of adding new locales to the system

定義在 adminaddlocaleaction.class.php 檔案之第 16 行.

---

建構子與解構子說明文件

AdminAddLocaleAction::AdminAddLocaleAction (  $  actionInfo, $  request )

定義在 adminaddlocaleaction.class.php 檔案之第 19 行. 參考 $request, 及 SiteAdminAction::SiteAdminAction(). { $this->SiteAdminAction( $actionInfo, $request ); // decide what to do based on which submit button was clicked if( $this->_request->getValue( "addLocale" ) != "" ) $this->_op = "uploadLocale"; else $this->_op = "scanLocales"; }

---

函式成員說明文件

AdminAddLocaleAction::_performScanLocales (   )  [private]

scans the locale folder looking for new locales 傳回值: always true 定義在 adminaddlocaleaction.class.php 檔案之第 55 行. 被參考於 perform(). { $locales = new Locales(); // find all the new locales that we have not yet stored $f = new LocaleFinder(); $newLocaleCodes = $f->find(); // success message $successMessage = ""; // set up the view $this->_view = new AdminSiteLocalesListView( $this->_blogInfo ); // if there are no new locales, there's no point in doing anything! if( count( $newLocaleCodes ) == 0 ) { $this->_view->setErrorMessage( $this->_locale->tr("error_no_new_locales_found" )); return false; } foreach( $newLocaleCodes as $newLocaleCode ) { // add the locale to the config settings $res = $locales->addLocale( $newLocaleCode ); // and create a success message $successMessage .= $this->_locale->pr("locale_added_ok", $newLocaleCode)."<br/>"; } if( $successMessage != "" ) $this->_view->setSuccessMessage( $successMessage ); return true; }

AdminAddLocaleAction::_performUploadLocale (   )

定義在 adminaddlocaleaction.class.php 檔案之第 88 行. 參考 $result, 及 HttpVars::getFiles(). 被參考於 perform(). { // since we are here, the file name was validated to be ok, so we can // continue with the operation $files = HttpVars::getFiles(); $uploads = new FileUploads( $files ); $this->_view = new AdminSiteLocalesListView( $this->_blogInfo ); // we can first of all move the file to the destionation folder $result = $uploads->process( $this->_config->getValue( "locale_folder" )); // the only thing that can happen is that the file was not correctly saved if( $result[0]->getError() != 0 ) { $this->_view->setErrorMessage( $this->_locale->tr("error_saving_locale")); return false; } // and once it's there, we can do as if we were adding a locale code $upload = new FileUpload( $files["localeFile"] ); $res = preg_match( REGEXP_VALID_LOCALE, $upload->getFileName(), $matches ); $localeCode = $matches[1]; // add the file to the list of locales $locales = new Locales(); $locales->addLocale( $localeCode ); $this->_view->setSuccessMessage( $this->_locale->pr( "locale_added_ok", $localeCode )); return true; }

AdminAddLocaleAction::perform (   )

Receives the HTTP request from the client as parameter, so that we can extract the parameters and perform our business logic. The result of this will be a view, which will normally be the output of the processing we just did or for example an error view showing an error message. Once we have completed processing, the controller will call the getView() method to get the resulting view and send it back to the customer. 傳回值: Returns nothing 依據Action重新實作. 定義在 adminaddlocaleaction.class.php 檔案之第 120 行. 參考 $result, _performScanLocales(), _performUploadLocale(), 及 AdminAction::setCommonData(). { if( $this->_op == "scanLocales" ) $result = $this->_performScanLocales(); else $result = $this->_performUploadLocale(); $this->setCommonData(); return $result; }

AdminAddLocaleAction::validate (   )

This method can be used for data validation and is always executed before perform(). If it returns 'true', execution will continue as normal. If it returns 'false', the process will be stopped and the current contents of the view will be returned. If the view is empty, an exception will be thrown. As of pLog 1.0, it is not necessary to implement data validation code here and it is recommended to use the data validation framework (see methods Action::registerFieldValidator() and related) There is more information about the data validation framework in the wiki: http://wiki.plogworld.net/index.php/PLog_1.0/Forms_and_data_validation. With the default code provided in the Action::validate() method, the callback method Action::validationErrorProcessing() will be called and after that, the view set via the Action::setValidationErrorView() will be used to generate the contents of the error message. 傳回值: Returns true if data is correct or false otherwise. See above for more details. 依據Action重新實作. 定義在 adminaddlocaleaction.class.php 檔案之第 30 行. 參考 HttpVars::getFiles(), Locales::isValidLocaleFileName(), 及 AdminAction::setCommonData(). { // first of all, we have to see if the name of the file is valid if( $this->_op == "uploadLocale" ) { $files = HttpVars::getFiles(); $upload = new FileUpload( $files["localeFile"] ); if( !Locales::isValidLocaleFileName( $upload->getFileName())) { $this->_view = new AdminTemplatedView( $this->_blogInfo, "newlocale" ); $this->_view->setErrorMessage( $this->_locale->tr("error_invalid_locale_file")); $this->setCommonData(); return false; } } return true; }

---

此類別(class) 文件是由下列檔案中產生:

• class/action/admin/adminaddlocaleaction.class.php

 

© 2005 LifeType. All rights reserved.	總站 | 德國 | 台灣	網站地圖 | 聯絡我們