Translate comments into English

git-svn-id: http://xe-core.googlecode.com/svn/sandbox@6877 201d5d3c-b55e-5fd7-737f-ddc643e51545

modules/admin/admin.admin.controller.php

@@ -2,35 +2,35 @@
     /**
      * @class  adminAdminController
      * @author zero (zero@nzeo.com)
-     * @brief  admin 모듈의 admin controller class
+     * @brief  admin controller class of admin module
      **/
 
     class adminAdminController extends admin {
         /**
-         * @brief 초기화
+         * @brief initialization
+         * @return none
          **/
         function init() {
-            // 접속 사용자에 대한 체크
+            // forbit access if the user is not an administrator
             $oMemberModel = &getModel('member');
             $logged_info = $oMemberModel->getLoggedInfo();
-
-            // 관리자가 아니면 금지
             if($logged_info->is_admin!='Y') return $this->stop("msg_is_not_administrator");
         }
 
         /**
-         * @brief 모든 캐시 파일 재생성
+         * @brief Regenerate all cache files
+         * @return none
          **/
         function procAdminRecompileCacheFile() {
             $oModuleModel = &getModel('module');
             $module_list = $oModuleModel->getModuleList();
 
-            // 개발 디버그 파일들 제거
+            // remove debug files 
             FileHandler::removeFile(_XE_PATH_.'files/_debug_message.php');
             FileHandler::removeFile(_XE_PATH_.'files/_debug_db_query.php');
             FileHandler::removeFile(_XE_PATH_.'files/_db_slow_query.php');
 
-            // 각 모듈마다 돌면서 캐시 파일 제거
+            // call recompileCache for each module
             foreach($module_list as $module) {
                 $oModule = null;
                 $oModule = &getClass($module->module);
@@ -41,7 +41,8 @@
         }
 
         /**
-         * @brief 관리자 로그아웃
+         * @brief Logout
+         * @return none
          **/
         function procAdminLogout() {
             $oMemberController = &getController('member');

modules/admin/admin.admin.view.php

@@ -2,30 +2,28 @@
     /**
      * @class  adminAdminView
      * @author zero (zero@nzeo.com)
-     * @brief  admin 모듈의 admin view class
+     * @brief  admin view class of admin module
      **/
 
     class adminAdminView extends admin {
 
         /**
-         * @brief 초기화
+         * @brief Initilization
+         * @return none
          **/
         function init() {
-            // template path 지정
             $this->setTemplatePath($this->module_path.'tpl');
 
-            // 접속 사용자에 대한 체크
+            // forbit access if the user is not an administrator
             $oMemberModel = &getModel('member');
             $logged_info = $oMemberModel->getLoggedInfo();
-
-            // 관리자가 아니면 금지
             if($logged_info->is_admin!='Y') return $this->stop("msg_is_not_administrator");
 
-            // 관리자용 레이아웃으로 변경
+            // change into administration layout 
             $this->setLayoutPath($this->getTemplatePath());
             $this->setLayoutFile('layout.html');
 
-            // 설치된 모듈 목록 가져와서 적절히 분리
+            // Retrieve the list of installed modules 
             $oModuleModel = &getModel('module');
             $installed_module_list = $oModuleModel->getModulesXmlInfo();
 
@@ -33,7 +31,7 @@
             $package_idx = 0;
             foreach($installed_module_list as $key => $val) {
                 if($val->module == 'admin' || !$val->admin_index_act) continue;
-                // action 정보 구함
+                // get action information 
                 $action_spec = $oModuleModel->getModuleActionXml($val->module);
                 $actions = array();
                 if($action_spec->default_index_act) $actions[] = $action_spec->default_index_act;
@@ -47,14 +45,14 @@
                 $obj->index_act = $val->admin_index_act;
                 if(in_array(Context::get('act'), $actions)) $obj->selected = true;
 
-                // 패키지 모듈
+                // Packages 
                 if($val->category == 'package') {
                     if($package_idx == 0) $obj->position = "first";
                     else $obj->position = "mid";
                     $package_modules[] = $obj;
                     $package_idx ++;
                     if($obj->selected) Context::set('package_selected',true);
-                // 일반 모듈
+                // Modules 
                 } else {
                     $installed_modules[] = $obj;
                 }
@@ -83,17 +81,16 @@
         }
 
         /**
-         * @brief 관리자 메인 페이지 출력
+         * @brief Display main administration page
+         * @return none
          **/
         function dispAdminIndex() {
-            /**
+            //Retrieve recent news and set them into context
-             * 최근 뉴스를 가져와서 세팅
-             **/
             $newest_news_url = sprintf("http://news.xpressengine.com/%s/news.php", Context::getLangType());
             $cache_file = sprintf("%sfiles/cache/newest_news.%s.cache.php", _XE_PATH_,Context::getLangType());
             if(!file_exists($cache_file) || filemtime($cache_file)+ 60*60 < time()) {
-                // 네트웍 상태로 데이터를 가져오지 못할 상황을 고려해 일단 filemtime을 변경하여 관리자 페이지 refresh시에 다시 읽ㅇ 오지 않도록 함
+                // Considering if data cannot be retrieved due to network problem, modify filemtime to prevent trying to reload again when refreshing administration page
-                // 뉴스를 보지는 못하지만 관리자 페이지 접속은 이상없도록 함
+                // Ensure to access the administration page even though news cannot be displayed
                 FileHandler::writeFile($cache_file,'');
                 FileHandler::getRemoteFile($newest_news_url, $cache_file, null, 1, 'GET', 'text/html', array('REQUESTURL'=>getFullUrl('')));
             }
@@ -120,31 +117,29 @@
                 Context::set('download_link', $buff->zbxe_news->attrs->download_link);
             }
 
-            // DB 정보를 세팅
+            // DB Information 
             $db_info = Context::getDBInfo();
             Context::set('selected_lang', $db_info->lang_type);
 
-            // 현재 버젼과 설치 경로 세팅
+            // Current Version and Installed Path
             Context::set('current_version', __ZBXE_VERSION__);
             Context::set('installed_path', realpath('./'));
 
-            // 모듈 목록을 가져옴
+            // Get list of modules
             $oModuleModel = &getModel('module');
             $module_list = $oModuleModel->getModuleList();
             Context::set('module_list', $module_list);
 
-            // 애드온 목록을 가져옴
+            // Get list of addons
             $oAddonModel = &getAdminModel('addon');
             $addon_list = $oAddonModel->getAddonList();
             Context::set('addon_list', $addon_list);
 
-            /**
+            // Get statistics
-             * 각종 통계를 추출
-             **/
             $args->date = date("Ymd000000", time()-60*60*24);
             $today = date("Ymd");
 
-            // 회원현황
+            // Member Status
             $output = executeQueryArray("admin.getMemberStatus", $args);
             if($output->data) {
                 foreach($output->data as $var) {
@@ -158,7 +153,7 @@
             $output = executeQuery("admin.getMemberCount", $args);
             $status->member->total = $output->data->count;
 
-            // 문서현황
+            // Document Status
             $output = executeQueryArray("admin.getDocumentStatus", $args);
             if($output->data) {
                 foreach($output->data as $var) {
@@ -172,7 +167,7 @@
             $output = executeQuery("admin.getDocumentCount", $args);
             $status->document->total = $output->data->count;
 
-            // 댓글현황
+            // Comment Status 
             $output = executeQueryArray("admin.getCommentStatus", $args);
             if($output->data) {
                 foreach($output->data as $var) {
@@ -186,7 +181,7 @@
             $output = executeQuery("admin.getCommentCount", $args);
             $status->comment->total = $output->data->count;
 
-            // 엮인글현황
+            // Trackback Status 
             $output = executeQueryArray("admin.getTrackbackStatus", $args);
             if($output->data) {
                 foreach($output->data as $var) {
@@ -200,7 +195,7 @@
             $output = executeQuery("admin.getTrackbackCount", $args);
             $status->trackback->total = $output->data->count;
 
-            // 첨부파일현황
+            // Attached files Status 
             $output = executeQueryArray("admin.getFileStatus", $args);
             if($output->data) {
                 foreach($output->data as $var) {
@@ -214,7 +209,7 @@
             $output = executeQuery("admin.getFileCount", $args);
             $status->file->total = $output->data->count;
 
-            // 게시물 신고현황
+            // Reported documents Status
             $output = executeQueryArray("admin.getDocumentDeclaredStatus", $args);
             if($output->data) {
                 foreach($output->data as $var) {
@@ -228,7 +223,7 @@
             $output = executeQuery("admin.getDocumentDeclaredCount", $args);
             $status->documentDeclared->total = $output->data->count;
 
-            // 댓글 신고현황
+            // Reported comments Status
             $output = executeQueryArray("admin.getCommentDeclaredStatus", $args);
             if($output->data) {
                 foreach($output->data as $var) {
@@ -253,7 +248,8 @@
         }
 
         /**
-         * @brief 관리자 설정
+         * @brief Display Configuration(settings) page
+         * @return none
          **/
         function dispAdminConfig() {
             $db_info = Context::getDBInfo();

modules/admin/admin.class.php

@@ -2,50 +2,53 @@
     /**
      * @class  admin
      * @author zero (zero@nzeo.com)
-     * @brief  admin 모듈의 high class
+     * @brief  base class of admin module 
      **/
 
     class admin extends ModuleObject {
 
         /**
-         * @brief 설치시 추가 작업이 필요할시 구현
+         * @brief install admin module 
+         * @return new Object
          **/
         function moduleInstall() {
             return new Object();
         }
 
         /**
-         * @brief 설치가 이상이 없는지 체크하는 method
+         * @brief if update is necessary it returns true
          **/
         function checkUpdate() {
             return false;
         }
 
         /**
-         * @brief 업데이트 실행
+         * @brief update module 
+         * @return new Object
          **/
         function moduleUpdate() {
             return new Object();
         }
 
         /**
-         * @brief 캐시 파일 재생성
+         * @brief regenerate cache file
+         * @return none
          **/
         function recompileCache() {
 
-            // 템플릿 컴파일 파일 삭제
+            // remove compiled templates
             FileHandler::removeFilesInDir("./files/cache/template_compiled");
 
-            // optimized 파일 삭제
+            // remove optimized files 
             FileHandler::removeFilesInDir("./files/cache/optimized");
 
-            // js_filter_compiled 파일 삭제
+            // remove js_filter_compiled files 
             FileHandler::removeFilesInDir("./files/cache/js_filter_compiled");
 
-            // queries 파일 삭제
+            // remove cached queries 
             FileHandler::removeFilesInDir("./files/cache/queries");
 
-            // ./files/cache/news* 파일 삭제
+            // remove ./files/cache/news* files 
             $directory = dir(_XE_PATH_."files/cache/");
             while($entry = $directory->read()) {
                 if(substr($entry,0,11)=='newest_news') FileHandler::removeFile("./files/cache/".$entry);