adds comments for phpDoc

git-svn-id: http://xe-core.googlecode.com/svn/branches/1.5.0@10754 201d5d3c-b55e-5fd7-737f-ddc643e51545
This commit is contained in:
flyskyko 2012-05-30 08:17:56 +00:00
parent 455091f7e8
commit e010c07440
5 changed files with 149 additions and 55 deletions

View file

@ -1,22 +1,24 @@
<?php
/**
* @class addonAdminController
* @author NHN (developers@xpressengine.com)
* @brief admin controller class of addon modules
**/
require_once(_XE_PATH_.'modules/addon/addon.controller.php');
/**
* Admin controller class of addon modules
* @author NHN (developers@xpressengine.com)
**/
class addonAdminController extends addonController {
/**
* @brief Initialization
* Initialization
*
* @return void
**/
function init() {
}
/**
* @brief Set addon activate
* Set addon activate
*
* @return Object
**/
function procAddonAdminSaveActivate()
{
@ -109,7 +111,9 @@
}
/**
* @brief Add active/inactive change
* Add active/inactive change
*
* @return Object
**/
function procAddonAdminToggleActivate() {
$oAddonModel = &getAdminModel('addon');
@ -130,7 +134,9 @@
}
/**
* @brief Add the configuration information input
* Add the configuration information input
*
* @return Object
**/
function procAddonAdminSetupAddon() {
$args = Context::getRequestVars();
@ -156,8 +162,13 @@
/**
* @brief Add-on
* Adds Add to DB
* Adds addon to DB
*
* @param string $addon Addon name
* @param int $site_srl Site srl
* @param string $gtype site or global
* @param string $isUsed Whether to use
* @return Object
**/
function doInsert($addon, $site_srl = 0, $gtype = 'site', $isUsed = 'N') {
$args->addon = $addon;
@ -168,8 +179,13 @@
}
/**
* @brief Add-activated
* addons add-ons to the table on the activation state sikyeojum
* Activate addon
*
* @param string $addon Addon name
* @param int $site_srl Site srl
* @param string $type pc or modile
* @param string $gtype site or global
* @return Object
**/
function doActivate($addon, $site_srl = 0, $type = "pc", $gtype = 'site') {
$args->addon = $addon;
@ -181,9 +197,12 @@
}
/**
* @brief Disable Add-ons
* Deactivate Addon
*
* addons add a table to remove the name of the deactivation is sikige
* @param string $addon Addon name
* @param int $site_srl Site srl
* @param string $type pc or mobile
* @param string $gtype site or global
**/
function doDeactivate($addon, $site_srl = 0, $type = "pc", $gtype = 'site') {
$args->addon = $addon;

View file

@ -1,20 +1,23 @@
<?php
/**
* @class addonAdminModel
* Admin model class of addon module
* @author NHN (developers@xpressengine.com)
* @brief admin model class of addon modules
**/
class addonAdminModel extends addon {
/**
* @brief Initialization
* Initialization
*
* @return void
**/
function init() {
}
/**
* @brief Wanted to add the path to
* Returns a path of addon
*
* @param string $addon_name Name to get path
* @return string Returns a path
**/
function getAddonPath($addon_name) {
$class_path = sprintf('./addons/%s/', $addon_name);
@ -23,7 +26,9 @@
}
/**
* @brief Get addon list for super admin
* Get addon list for super admin
*
* @return Object
**/
function getAddonListForSuperAdmin()
{
@ -51,7 +56,11 @@
}
/**
* @brief Wanted to add the kind of information and
* Returns addon list
*
* @param int $site_srl Site srl
* @param string $gtype site or global
* @return array Returns addon list
**/
function getAddonList($site_srl = 0, $gtype = 'site') {
// Wanted to add a list of activated
@ -96,7 +105,12 @@
}
/**
* @brief Modules conf/info.xml wanted to read the information
* Returns a information of addon
*
* @param string $addon Name to get information
* @param int $site_srl Site srl
* @param string $gtype site or global
* @return object Returns a information
**/
function getAddonInfoXml($addon, $site_srl = 0, $gtype = 'site') {
// Get a path of the requested module. Return if not exists.
@ -294,7 +308,11 @@
}
/**
* @brief Add to the list of active guhaeom
* Returns activated addon list
*
* @param int $site_srl Site srl
* @param string $gtype site or global
* @return array Returns list
**/
function getInsertedAddons($site_srl = 0, $gtype = 'site') {
$args->list_order = 'addon';
@ -315,7 +333,13 @@
}
/**
* @brief Add-on is enabled, check whether
* Returns whether to activate
*
* @param string $addon Name to check
* @param int $site_srl Site srl
* @param string $type pc or mobile
* @param string $gtype site or global
* @return bool If addon is activated returns true. Otherwise returns false.
**/
function isActivatedAddon($addon, $site_srl = 0, $type = "pc", $gtype = 'site') {
$args->addon = $addon;

View file

@ -1,21 +1,23 @@
<?php
/**
* @class addonAdminView
* Admin view class of addon modules
* @author NHN (developers@xpressengine.com)
* @brief admin view class of addon modules
**/
class addonAdminView extends addon {
/**
* @brief Initialization
* Initialization
*
* @return void
**/
function init() {
$this->setTemplatePath($this->module_path.'tpl');
}
/**
* @brief Add Management main page (showing the list)
* Add Management main page (showing the list)
*
* @return Object
**/
function dispAddonAdminIndex() {
$oAdminModel = &getAdminModel('admin');
@ -39,7 +41,9 @@
}
/**
* @biref Setting out the details pop-up add-on
* Display setup page
*
* @return Object
**/
function dispAddonAdminSetup() {
$site_module_info = Context::get('site_module_info');
@ -86,7 +90,9 @@
}
/**
* @brief Add details (conf/info.xml) a pop-out
* Display information
*
* @return Object
**/
function dispAddonAdminInfo() {
$site_module_info = Context::get('site_module_info');

View file

@ -1,14 +1,14 @@
<?php
/**
* @class addon
* High class of addon modules
* @author NHN (developers@xpressengine.com)
* @brief high class of addon modules
**/
class addon extends ModuleObject {
/**
* @brief Implement if additional tasks are necessary when installing
* Implement if additional tasks are necessary when installing
*
* @return Object
**/
function moduleInstall() {
// Register to add a few
@ -28,7 +28,9 @@
}
/**
* @brief a method to check if successfully installed
* A method to check if successfully installed
*
* @return bool
**/
function checkUpdate() {
$oDB = &DB::getInstance();
@ -42,7 +44,9 @@
}
/**
* @brief Execute update
* Execute update
*
* @return Object
**/
function moduleUpdate() {
$oDB = &DB::getInstance();
@ -78,7 +82,9 @@
}
/**
* @brief Re-generate the cache file
* Re-generate the cache file
*
* @return Object
**/
function recompileCache() {
}

View file

@ -1,21 +1,23 @@
<?php
/**
* @class addonController
* Addon module's controller class
* @author NHN (developers@xpressengine.com)
* @brief addon module's controller class
**/
class addonController extends addon {
/**
* @brief Initialization
* Initialization
*
* @return void
**/
function init() {
}
/**
* @brief Main/Virtual-specific add-on file, the location of the cache Wanted
* Returns a cache file path
*
* @param $type pc or mobile
* @return string Returns a path
**/
function getCacheFilePath($type = "pc") {
static $addon_file;
@ -38,7 +40,11 @@
/**
* @brief Add-on mid settings
* Returns mid list that addons is run
*
* @param string $selected_addon Name to get list
* @param int $site_srl Site srl
* @return string[] Returns list that contain mid
**/
function _getMidList($selected_addon, $site_srl = 0) {
@ -50,7 +56,12 @@
/**
* @brief Add-on mid settings
* Adds mid into running mid list
*
* @param string $selected_addon Addon name to add mid
* @param string $mid Module id to add
* @param int $site_srl Site srl
* @return void
**/
function _setAddMid($selected_addon,$mid, $site_srl=0) {
// Wanted to add the requested information
@ -63,7 +74,12 @@
/**
* @brief Add-on mid settings
* Deletes mid from running mid list
*
* @param string $selected_addon Addon name to delete mid
* @param string $mid Module id to delete
* @param int $site_srl Site srl
* @return void
**/
function _setDelMid($selected_addon,$mid,$site_srl=0) {
// Wanted to add the requested information
@ -83,7 +99,12 @@
}
/**
* @brief Add-on mid settings
* Set running mid list
*
* @param string $selected_addon Addon name to set
* @param string[] $mid_list List to set
* @param int $site_srl Site srl
* @return void
**/
function _setMid($selected_addon,$mid_list,$site_srl=0) {
$args->mid_list = join('|@|',$mid_list);
@ -93,7 +114,9 @@
/**
* @brief Add mid-on
* Adds mid into running mid list
*
* @return Object
**/
function procAddonSetupAddonAddMid() {
$site_module_info = Context::get('site_module_info');
@ -105,7 +128,9 @@
}
/**
* @brief Add mid Delete
* Deletes mid from running mid list
*
* @return Object
**/
function procAddonSetupAddonDelMid() {
$site_module_info = Context::get('site_module_info');
@ -118,7 +143,12 @@
}
/**
* @brief Re-generate the cache file
* Re-generate the cache file
*
* @param int $site_srl Site srl
* @param string $type pc or mobile
* @param string $gtype site or global
* @return void
**/
function makeCacheFile($site_srl = 0, $type = "pc", $gtype = 'site') {
// Add-on module for use in creating the cache file
@ -155,7 +185,13 @@
}
/**
* @brief Add-On Set
* Save setup
*
* @param string $addon Addon name
* @param object $extra_vars Extra variables
* @param int $site_srl Site srl
* @param string $gtype site or global
* @return Object
**/
function doSetup($addon, $extra_vars,$site_srl=0, $gtype = 'site') {
if(!is_array($extra_vars->mid_list)) unset($extra_vars->mid_list);
@ -168,7 +204,10 @@
}
/**
* @brief Remove add-on information in the virtual site
* Remove add-on information in the virtual site
*
* @param int $site_srl Site srl
* @return void
**/
function removeAddonConfig($site_srl) {
$addon_path = _XE_PATH_.'files/cache/addons/';