added comments for phpDoc - rss module

git-svn-id: http://xe-core.googlecode.com/svn/branches/1.5.0@10757 201d5d3c-b55e-5fd7-737f-ddc643e51545
This commit is contained in:
chschy 2012-05-31 06:53:06 +00:00
parent 3c609ae06a
commit 32284aa5a7
6 changed files with 90 additions and 48 deletions

View file

@ -1,23 +1,24 @@
<?php
/**
* @class rssAdminController
* The admin controller class of the rss module
*
* @author NHN (developers@xpressengine.com)
* @brief The admin controller class of the rss module
*
* RSS 2.0 format document output
*
**/
class rssAdminController extends rss {
/**
* @brief Initialization
* Initialization
*
* @return void
**/
function init() {
}
/**
* @brief All RSS feeds configurations
* All RSS feeds configurations
*
* @return void
**/
function procRssAdminInsertConfig() {
$oModuleModel = &getModel('module');
@ -83,7 +84,9 @@
/**
* @brief RSS Module configurations
* RSS Module configurations
*
* @return void
**/
function procRssAdminInsertModuleConfig() {
// Get the object
@ -121,7 +124,9 @@
/**
* @brief All Feeds with or without change
* All Feeds with or without change
*
* @return Object
**/
function procRssAdminToggleActivate() {
$oRssModel = &getModel('rss');
@ -144,7 +149,10 @@
/**
* @brief A funciton to configure all Feeds of the RSS module
* A funciton to configure all Feeds of the RSS module
*
* @param Object $config RSS all feeds config list
* @return Object
**/
function setFeedConfig($config) {
$oModuleController = &getController('module');
@ -154,7 +162,14 @@
/**
* @brief A function t configure the RSS module
* A function t configure the RSS module
*
* @param integer $module_srl Module_srl
* @param string $open_rss Choose open rss type. Y : Open all, H : Open summary, N : Not open
* @param string $open_total_feed N : use open total feed, T_N : not use open total feed
* @param string $feed_description Default value is 'N'
* @param string $feed_copyright Default value is 'N'
* @return Object
**/
function setRssModuleConfig($module_srl, $open_rss, $open_total_feed = 'N', $feed_description = 'N', $feed_copyright = 'N') {
$oModuleController = &getController('module');

View file

@ -1,13 +1,15 @@
<?php
/**
* @class rssAdminView
* @author misol (misol@korea.ac.kr)
* @brief The admin view class of the rss module
* The admin view class of the rss module
*
* @author NHN (developers@xpressengine.com)
**/
class rssAdminView extends rss {
/**
* @brief Initialization
* Initialization
*
* @return void
**/
function init() {
//Set template path
@ -16,7 +18,9 @@
/**
* @brief In case an administrator page has been initialized
* In case an administrator page has been initialized
*
* @return Object
**/
function dispRssAdminIndex() {
$oModuleModel = &getModel('module');
@ -53,4 +57,4 @@
$this->setTemplateFile('rss_admin_index');
}
}
?>
?>

View file

@ -1,14 +1,16 @@
<?php
/**
* @class rss
* High class of rss module
*
* @author NHN (developers@xpressengine.com)
* @brief The view class of the rss module
**/
class rss extends ModuleObject {
/**
* @brief Additional tasks required to accomplish during the installation
* Additional tasks required to accomplish during the installation
*
* @return Object
**/
function moduleInstall() {
// Register in action forward
@ -25,7 +27,8 @@
}
/**
* @brief A method to check if the installation has been successful
* A method to check if the installation has been successful
* @return bool
**/
function checkUpdate() {
$oModuleModel = &getModel('module');
@ -42,7 +45,9 @@
}
/**
* @brief Execute update
* Execute update
*
* @return Object
**/
function moduleUpdate() {
$oModuleModel = &getModel('module');
@ -63,7 +68,9 @@
}
/**
* @brief Re-generate the cache file
* Re-generate the cache file
*
* @return void
**/
function recompileCache() {
}

View file

@ -1,23 +1,24 @@
<?php
/**
* @class rssController
* The controller class of rss module
*
* @author NHN (developers@xpressengine.com)
* @brief rss module of the controller class
*
* Feed the document output
*
**/
class rssController extends rss {
/**
* @brief Initialization
* Initialization
*
* @return void
**/
function init() {
}
/**
* @brief Check whether to use RSS rss url by adding
* Check whether to use RSS rss url by adding
*
* @return Object
**/
function triggerRssUrlInsert() {
$oModuleModel = &getModel('module');

View file

@ -1,16 +1,18 @@
<?php
/**
* @class rssModel
* The model class of the rss module
*
* @author NHN (developers@xpressengine.com)
* @brief The model class of the rss module
*
* Feed the document output
*
**/
class rssModel extends rss {
/**
* @brief Create the Feed url.
* Create the Feed url.
*
* @param string $vid Vid
* @param string $mid mid
* @param string $format Feed format. ef)xe, atom, rss1.0
* @return string
**/
function getModuleFeedUrl($vid = null, $mid, $format) {
if(Context::isAllowRewrite()) {
@ -30,7 +32,10 @@
/**
* @brief Return the RSS configurations of the specific modules
* Return the RSS configurations of the specific modules
*
* @param integer $module_srl Module_srl
* @return Object
**/
function getRssModuleConfig($module_srl) {
// Get the configurations of the rss module

View file

@ -1,24 +1,27 @@
<?php
/**
* @class rssView
* @author NHN (developers@xpressengine.com)
* @brief The view class of the rss module
*
* Feed the document output
*
* The view class of the rss module
*
* @author NHN (developers@xpressengine.com)
**/
class rssView extends rss {
/**
* @brief Initialization
* Initialization
*
* @return void
**/
function init() {
}
/**
* @brief Feed output
* Feed output.
* When trying to directly print out the RSS, the results variable can be directly specified through $oRssView->rss($document_list)
*
* @param Object $document_list Document list
* @param string $rss_title Rss title
* @param string $add_description Add description
**/
function rss($document_list = null, $rss_title = null, $add_description = null) {
$oDocumentModel = &getModel('document');
@ -181,7 +184,9 @@
$this->setTemplateFile('display');
}
/**
* @brief ATOM output
* ATOM output
*
* @return Object
**/
function atom() {
Context::set('format', 'atom');
@ -189,7 +194,9 @@
}
/**
* @brief Error output
* Error output
*
* @return Object
**/
function dispError() {
// Prepare the output message
@ -197,8 +204,11 @@
}
/**
* @brief Additional configurations for a service module
* Additional configurations for a service module
* Receive the form for the form used by rss
*
* @param string $obj Will be inserted content in template
* @return Object
**/
function triggerDispRssAdditionSetup(&$obj) {
$current_module_srl = Context::get('module_srl');