MINOR Fixed phpdoc documentation

git-svn-id: svn://svn.silverstripe.com/silverstripe/open/modules/sapphire/trunk@103385 467b73ca-7a2a-4603-9d3b-597d59a354a9
This commit is contained in:
Ingo Schommer 2010-04-23 00:11:41 +00:00
parent af88731959
commit 6460d09570
40 changed files with 150 additions and 74 deletions

View File

@ -85,7 +85,7 @@ abstract class DataFormatter extends Object {
/** /**
* Get a DataFormatter object suitable for handling the given file extension. * Get a DataFormatter object suitable for handling the given file extension.
* *
* @string $extension * @param string $extension
* @return DataFormatter * @return DataFormatter
*/ */
static function for_extension($extension) { static function for_extension($extension) {

View File

@ -1,8 +1,5 @@
<?php <?php
/** /**
* @package sapphire
* @subpackage api
*
* Sapphire's generic RESTful server. * Sapphire's generic RESTful server.
* *
* This class gives your application a RESTful API for free. All you have to do is define static $api_access = true on * This class gives your application a RESTful API for free. All you have to do is define static $api_access = true on
@ -86,6 +83,9 @@
* @todo i18n integration (e.g. Page/1.xml?lang=de_DE) * @todo i18n integration (e.g. Page/1.xml?lang=de_DE)
* @todo Access to decoratable methods/relations like SiteTree/1/Versions or SiteTree/1/Version/22 * @todo Access to decoratable methods/relations like SiteTree/1/Versions or SiteTree/1/Version/22
* @todo Respect $api_access array notation in search contexts * @todo Respect $api_access array notation in search contexts
*
* @package sapphire
* @subpackage api
*/ */
class RestfulServer extends Controller { class RestfulServer extends Controller {
static $url_handlers = array( static $url_handlers = array(
@ -585,6 +585,9 @@ class RestfulServer extends Controller {
/** /**
* Restful server handler for a DataObjectSet * Restful server handler for a DataObjectSet
*
* @package sapphire
* @subpackage api
*/ */
class RestfulServer_List { class RestfulServer_List {
static $url_handlers = array( static $url_handlers = array(
@ -602,6 +605,9 @@ class RestfulServer_List {
/** /**
* Restful server handler for a single DataObject * Restful server handler for a single DataObject
*
* @package sapphire
* @subpackage api
*/ */
class RestfulServer_Item { class RestfulServer_Item {
static $url_handlers = array( static $url_handlers = array(

View File

@ -3,6 +3,7 @@
* RestfulService class allows you to consume various RESTful APIs. * RestfulService class allows you to consume various RESTful APIs.
* Through this you could connect and aggregate data of various web services. * Through this you could connect and aggregate data of various web services.
* For more info visit wiki documentation - http://doc.silverstripe.org/doku.php?id=restfulservice * For more info visit wiki documentation - http://doc.silverstripe.org/doku.php?id=restfulservice
*
* @package sapphire * @package sapphire
* @subpackage integration * @subpackage integration
*/ */
@ -354,6 +355,10 @@ class RestfulService extends ViewableData {
} }
} }
/**
* @package sapphire
* @subpackage integration
*/
class RestfulService_Response extends SS_HTTPResponse { class RestfulService_Response extends SS_HTTPResponse {
protected $simpleXML; protected $simpleXML;

3
cache/Cache.php vendored
View File

@ -1,5 +1,4 @@
<?php <?php
/** /**
* SS_Cache provides a bunch of static functions wrapping the Zend_Cache system in something a little more * SS_Cache provides a bunch of static functions wrapping the Zend_Cache system in something a little more
* easy to use with the SilverStripe config system. * easy to use with the SilverStripe config system.
@ -58,6 +57,8 @@
* SS_Cache::pick_backend('two-level', 'any', 10); // No need for special backend for aggregate - TwoLevels with a File slow backend supports tags * SS_Cache::pick_backend('two-level', 'any', 10); // No need for special backend for aggregate - TwoLevels with a File slow backend supports tags
* *
* @author hfried * @author hfried
* @package sapphire
* @subpackage core
*/ */
class SS_Cache { class SS_Cache {

View File

@ -595,5 +595,4 @@ class ManifestBuilder {
return $results;; return $results;;
} }
} }
?> ?>

View File

@ -3,6 +3,7 @@
/** /**
* Requirements tracker, for javascript and css. * Requirements tracker, for javascript and css.
* @todo Document the requirements tracker, and discuss it with the others. * @todo Document the requirements tracker, and discuss it with the others.
*
* @package sapphire * @package sapphire
* @subpackage view * @subpackage view
*/ */
@ -304,6 +305,10 @@ class Requirements {
} }
/**
* @package sapphire
* @subpackage view
*/
class Requirements_Backend { class Requirements_Backend {
/** /**
* Paths to all required .js files relative to the webroot. * Paths to all required .js files relative to the webroot.

View File

@ -668,6 +668,9 @@ class SSViewer_FromString extends SSViewer {
* This shouldn't be used as an example of how to add functionality to SSViewer - the eventual plan is to re-write * This shouldn't be used as an example of how to add functionality to SSViewer - the eventual plan is to re-write
* SSViewer using a proper parser (probably http://github.com/hafriedlander/php-peg), so that extra functionality * SSViewer using a proper parser (probably http://github.com/hafriedlander/php-peg), so that extra functionality
* can be added without relying on ad-hoc parsers like this. * can be added without relying on ad-hoc parsers like this.
*
* @package sapphire
* @subpackage view
*/ */
class SSViewer_PartialParser { class SSViewer_PartialParser {

View File

@ -26,6 +26,8 @@
* backend (and the two-level backend with the File backend as the slow store) meets this requirement * backend (and the two-level backend with the File backend as the slow store) meets this requirement
* *
* @author hfried * @author hfried
* @package sapphire
* @subpackage core
*/ */
class Aggregate extends ViewableData { class Aggregate extends ViewableData {
@ -119,6 +121,8 @@ class Aggregate extends ViewableData {
* A subclass of Aggregate that calculates aggregates for the result of a has_many query. * A subclass of Aggregate that calculates aggregates for the result of a has_many query.
* *
* @author hfried * @author hfried
* @package sapphire
* @subpackage core
*/ */
class Aggregate_Relationship extends Aggregate { class Aggregate_Relationship extends Aggregate {

View File

@ -1,5 +1,4 @@
<?php <?php
/** /**
* Utility class to render views of the differences between two data objects (or two versions of the * Utility class to render views of the differences between two data objects (or two versions of the
* same data object). * same data object).
@ -30,6 +29,9 @@
* <code> * <code>
* $diff->ignoreFields('AuthorID', 'Status'); * $diff->ignoreFields('AuthorID', 'Status');
* </code> * </code>
*
* @package sapphire
* @subpackage misc
*/ */
class DataDifferencer extends ViewableData { class DataDifferencer extends ViewableData {
protected $fromRecord; protected $fromRecord;

View File

@ -3071,8 +3071,7 @@ class DataObject extends ViewableData implements DataObjectInterface, i18nEntity
* *
* @param boolean $includerelations a boolean value to indicate if the labels returned include relation fields * @param boolean $includerelations a boolean value to indicate if the labels returned include relation fields
* *
* @return array of all element labels if no argument given * @return array|string Array of all element labels if no argument given, otherwise the label of the field
* @return string of label if field
*/ */
public function fieldLabels($includerelations = true) { public function fieldLabels($includerelations = true) {
$customLabels = $this->stat('field_labels'); $customLabels = $this->stat('field_labels');

View File

@ -7,6 +7,7 @@ require_once("core/model/DB.php");
* *
* Utility functions for administrating the database. These can be accessed * Utility functions for administrating the database. These can be accessed
* via URL, e.g. http://www.yourdomain.com/db/build. * via URL, e.g. http://www.yourdomain.com/db/build.
*
* @package sapphire * @package sapphire
* @subpackage model * @subpackage model
*/ */

View File

@ -2,6 +2,7 @@
/** /**
* This is a class used to represent key->value pairs generated from database queries. * This is a class used to represent key->value pairs generated from database queries.
* The query isn't actually executed until you need it. * The query isn't actually executed until you need it.
*
* @package sapphire * @package sapphire
* @subpackage model * @subpackage model
*/ */
@ -83,6 +84,10 @@ class SQLMap extends Object implements IteratorAggregate {
} }
} }
/**
* @package sapphire
* @subpackage model
*/
class SQLMap_Iterator extends Object implements Iterator { class SQLMap_Iterator extends Object implements Iterator {
protected $items; protected $items;
protected $keyField, $titleField; protected $keyField, $titleField;

View File

@ -13,7 +13,6 @@ abstract class StringField extends DBField {
* Construct a string type field with a set of optional parameters * Construct a string type field with a set of optional parameters
* @param $name string The name of the field * @param $name string The name of the field
* @param $options array An array of options e.g. array('nullifyEmpty'=>false). See {@link StringField::setOptions()} for information on the available options * @param $options array An array of options e.g. array('nullifyEmpty'=>false). See {@link StringField::setOptions()} for information on the available options
* @return unknown_type
*/ */
function __construct($name = null, $options = array()) { function __construct($name = null, $options = array()) {
// Workaround: The singleton pattern calls this constructor with true/1 as the second parameter, so we must ignore it // Workaround: The singleton pattern calls this constructor with true/1 as the second parameter, so we must ignore it
@ -43,7 +42,6 @@ abstract class StringField extends DBField {
/** /**
* Set whether this field stores empty strings rather than converting them to null * Set whether this field stores empty strings rather than converting them to null
* @param $value boolean True if empty strings are to be converted to null * @param $value boolean True if empty strings are to be converted to null
* @return
*/ */
function setNullifyEmpty($value) { function setNullifyEmpty($value) {
$this->nullifyEmpty == $value ? true : false; $this->nullifyEmpty == $value ? true : false;

View File

@ -275,7 +275,10 @@ class BulkLoader_Result extends Object {
* the import of this object. This information is stored * the import of this object. This information is stored
* in a custom object property "_BulkLoaderMessage". * in a custom object property "_BulkLoaderMessage".
* *
* @example array(array('ID'=>1, 'ClassName'=>'Member', 'Message'=>'Updated existing record based on ParentID relation')) * Example:
* <code>
* array(array('ID'=>1, 'ClassName'=>'Member', 'Message'=>'Updated existing record based on ParentID relation'))
* </code>
*/ */
protected $created = array(); protected $created = array();

View File

@ -233,8 +233,8 @@ class CodeViewer extends Controller {
} }
/** /**
* Finish the <pre> block in method content. * Finish the "pre" block in method content.
* Will remove whitespace and <pre></pre> blocks * Will remove whitespace and empty "pre" blocks
*/ */
function closeOffMethodContentPre() { function closeOffMethodContentPre() {
$this->currentMethod['content'] = trim($this->currentMethod['content']); $this->currentMethod['content'] = trim($this->currentMethod['content']);

View File

@ -1,4 +1,6 @@
<?php <?php
require_once 'Zend/Log.php';
/** /**
* Wrapper class for a logging handler like {@link Zend_Log} * Wrapper class for a logging handler like {@link Zend_Log}
* which takes a message (or a map of context variables) and * which takes a message (or a map of context variables) and
@ -42,9 +44,6 @@
* @package sapphire * @package sapphire
* @subpackage dev * @subpackage dev
*/ */
require_once 'Zend/Log.php';
class SS_Log { class SS_Log {
const ERR = Zend_Log::ERR; const ERR = Zend_Log::ERR;

View File

@ -1,4 +1,6 @@
<?php <?php
require_once 'Zend/Log/Writer/Abstract.php';
/** /**
* Sends an error message to an email whenever an error occurs * Sends an error message to an email whenever an error occurs
* in sapphire. * in sapphire.
@ -8,9 +10,6 @@
* @package sapphire * @package sapphire
* @subpackage dev * @subpackage dev
*/ */
require_once 'Zend/Log/Writer/Abstract.php';
class SS_LogEmailWriter extends Zend_Log_Writer_Abstract { class SS_LogEmailWriter extends Zend_Log_Writer_Abstract {
protected $emailAddress; protected $emailAddress;

View File

@ -1,12 +1,12 @@
<?php <?php
require_once 'Zend/Log/Formatter/Interface.php';
/** /**
* Formats SS error emails with a basic layout. * Formats SS error emails with a basic layout.
*
* @package sapphire * @package sapphire
* @subpackage dev * @subpackage dev
*/ */
require_once 'Zend/Log/Formatter/Interface.php';
class SS_LogErrorEmailFormatter implements Zend_Log_Formatter_Interface { class SS_LogErrorEmailFormatter implements Zend_Log_Formatter_Interface {
public function format($event) { public function format($event) {

View File

@ -1,13 +1,12 @@
<?php <?php
require_once 'Zend/Log/Formatter/Interface.php';
/** /**
* Formats SS error entries in an error file log. * Formats SS error entries in an error file log.
* Format: [d-M-Y h:i:s] <type> at <file> line <line>: <errormessage> <url> * Format: [d-M-Y h:i:s] <type> at <file> line <line>: <errormessage> <url>
* @package sapphire * @package sapphire
* @subpackage dev * @subpackage dev
*/ */
require_once 'Zend/Log/Formatter/Interface.php';
class SS_LogErrorFileFormatter implements Zend_Log_Formatter_Interface { class SS_LogErrorFileFormatter implements Zend_Log_Formatter_Interface {
public function format($event) { public function format($event) {

View File

@ -1,4 +1,6 @@
<?php <?php
require_once 'Zend/Log/Writer/Abstract.php';
/** /**
* Sends an error message to an email whenever an * Sends an error message to an email whenever an
* error occurs in sapphire. * error occurs in sapphire.
@ -13,9 +15,6 @@
* @package sapphire * @package sapphire
* @subpackage dev * @subpackage dev
*/ */
require_once 'Zend/Log/Writer/Abstract.php';
class SS_LogFileWriter extends Zend_Log_Writer_Abstract { class SS_LogFileWriter extends Zend_Log_Writer_Abstract {
/** /**

View File

@ -83,6 +83,10 @@ class ModelViewer extends Controller {
} }
} }
/**
* @package sapphire
* @subpackage tools
*/
class ModelViewer_Module extends ModelViewer { class ModelViewer_Module extends ModelViewer {
static $url_handlers = array( static $url_handlers = array(
'graph' => 'graph', 'graph' => 'graph',
@ -111,6 +115,9 @@ class ModelViewer_Module extends ModelViewer {
/** /**
* Represents a single model in the model viewer * Represents a single model in the model viewer
*
* @package sapphire
* @subpackage tools
*/ */
class ModelViewer_Model extends ViewableData { class ModelViewer_Model extends ViewableData {
protected $className; protected $className;
@ -169,6 +176,10 @@ class ModelViewer_Model extends ViewableData {
} }
} }
/**
* @package sapphire
* @subpackage tools
*/
class ModelViewer_Field extends ViewableData { class ModelViewer_Field extends ViewableData {
public $Model, $Name, $Type; public $Model, $Name, $Type;
@ -181,6 +192,10 @@ class ModelViewer_Field extends ViewableData {
} }
} }
/**
* @package sapphire
* @subpackage tools
*/
class ModelViewer_Relation extends ViewableData { class ModelViewer_Relation extends ViewableData {
public $Model, $Name, $RelationType, $RelatedClass; public $Model, $Name, $RelationType, $RelatedClass;

View File

@ -1,21 +1,4 @@
<?php <?php
/**
* Gathers details about PHPUnit2 test suites as they
* are been executed. This does not actually format any output
* but simply gathers extended information about the overall
* results of all suites & their tests for use elsewhere.
*
* Changelog:
* 0.6 First created [David Spurr]
* 0.7 Added fix to getTestException provided [Glen Ogilvie]
*
* @package sapphire
* @subpackage testing
*
* @version 0.7 2006-03-12
* @author David Spurr
*/
require_once 'PHPUnit/Framework/TestResult.php'; require_once 'PHPUnit/Framework/TestResult.php';
require_once 'PHPUnit/Framework/TestListener.php'; require_once 'PHPUnit/Framework/TestListener.php';
@ -40,6 +23,22 @@ define('TEST_SUCCESS', 1);
define('TEST_INCOMPLETE', 2); define('TEST_INCOMPLETE', 2);
/**#@-*/ /**#@-*/
/**
* Gathers details about PHPUnit2 test suites as they
* are been executed. This does not actually format any output
* but simply gathers extended information about the overall
* results of all suites & their tests for use elsewhere.
*
* Changelog:
* 0.6 First created [David Spurr]
* 0.7 Added fix to getTestException provided [Glen Ogilvie]
*
* @package sapphire
* @subpackage testing
*
* @version 0.7 2006-03-12
* @author David Spurr
*/
class SapphireTestReporter implements PHPUnit_Framework_TestListener { class SapphireTestReporter implements PHPUnit_Framework_TestListener {
/** /**
* Holds array of suites and total number of tests run * Holds array of suites and total number of tests run

View File

@ -132,8 +132,8 @@ class TestViewer extends Controller {
} }
/** /**
* Finish the <pre> block in method content. * Finish the "pre" block in method content.
* Will remove whitespace and <pre></pre> blocks * Will remove whitespace and empty "pre" blocks
*/ */
function closeOffMethodContentPre() { function closeOffMethodContentPre() {
$this->currentMethod['content'] = trim($this->currentMethod['content']); $this->currentMethod['content'] = trim($this->currentMethod['content']);

View File

@ -17,13 +17,18 @@ require_once 'thirdparty/spyc/spyc.php';
* However, if you want to define a relationship, you can do so using "=>" * However, if you want to define a relationship, you can do so using "=>"
* *
* There are a couple of lines like this: * There are a couple of lines like this:
* @example Parent: =>Page.about * <code>
* Parent: =>Page.about
* </code>
* This will tell the system to set the ParentID database field to the ID of the Page object with the identifier ÒaboutÓ. * This will tell the system to set the ParentID database field to the ID of the Page object with the identifier ÒaboutÓ.
* This can be used on any has-one or many-many relationship. * This can be used on any has-one or many-many relationship.
* Note that we use the name of the relationship (Parent), and not the name of the database field (ParentID) * Note that we use the name of the relationship (Parent), and not the name of the database field (ParentID)
* *
* On many-many relationships, you should specify a comma separated list of values. * On many-many relationships, you should specify a comma separated list of values.
* @example MyRelation: =>Class.inst1,=>Class.inst2,=>Class.inst3 * <code>
* MyRelation: =>Class.inst1,=>Class.inst2,=>Class.inst3
* </code>
*
* An crucial thing to note is that the YAML file specifies DataObjects, not database records. * An crucial thing to note is that the YAML file specifies DataObjects, not database records.
* The database is populated by instantiating DataObject objects, setting the fields listed, and calling write(). * The database is populated by instantiating DataObject objects, setting the fields listed, and calling write().
* This means that any onBeforeWrite() or default value logic will be executed as part of the test. * This means that any onBeforeWrite() or default value logic will be executed as part of the test.

View File

@ -44,8 +44,6 @@ class Upload extends Controller {
* <code> * <code>
* array("jpg","GIF") * array("jpg","GIF")
* </code> * </code>
*
* @var array
*/ */
public $allowedExtensions = array(); public $allowedExtensions = array();

View File

@ -679,6 +679,8 @@ JS;
/** /**
* @todo Tie this into ComplexTableField_Item better. * @todo Tie this into ComplexTableField_Item better.
* @package forms
* @subpackage fields-relational
*/ */
class ComplexTableField_ItemRequest extends RequestHandler { class ComplexTableField_ItemRequest extends RequestHandler {
protected $ctf; protected $ctf;

View File

@ -537,6 +537,9 @@ class FieldSet extends DataObjectSet {
/** /**
* A fieldset designed to store a list of hidden fields. When inserted into a template, only the * A fieldset designed to store a list of hidden fields. When inserted into a template, only the
* input tags will be included * input tags will be included
*
* @package forms
* @subpackage fields-structural
*/ */
class HiddenFieldSet extends FieldSet { class HiddenFieldSet extends FieldSet {
function forTemplate() { function forTemplate() {

View File

@ -31,8 +31,6 @@ class FileField extends FormField {
* <code> * <code>
* array("jpg","GIF") * array("jpg","GIF")
* </code> * </code>
*
* @var array
*/ */
public $allowedExtensions = array(); public $allowedExtensions = array();

View File

@ -1280,6 +1280,10 @@ class Form extends RequestHandler {
} }
} }
/**
* @package forms
* @subpackage core
*/
class Form_FieldMap extends ViewableData { class Form_FieldMap extends ViewableData {
protected $form; protected $form;

View File

@ -593,8 +593,9 @@ HTML;
* words. Also resolves combined fieldnames with dot syntax * words. Also resolves combined fieldnames with dot syntax
* to spaced words. * to spaced words.
* *
* @example 'TotalAmount' will return 'Total Amount' * Examples:
* @example 'Organisation.ZipCode' will return 'Organisation Zip Code' * - 'TotalAmount' will return 'Total Amount'
* - 'Organisation.ZipCode' will return 'Organisation Zip Code'
* *
* @param string $fieldName * @param string $fieldName
* @return string * @return string

View File

@ -7,6 +7,8 @@
* the currently active config using set_active. Whichever config is active when HtmlEditorField#Field is called wins. * the currently active config using set_active. Whichever config is active when HtmlEditorField#Field is called wins.
* *
* @author "Hamish Friedlander" <hamish@silverstripe.com> * @author "Hamish Friedlander" <hamish@silverstripe.com>
* @package forms
* @subpackage fields-formattedinput
*/ */
class HtmlEditorConfig { class HtmlEditorConfig {
@ -142,7 +144,7 @@ class HtmlEditorConfig {
* *
* @see http://wiki.moxiecode.com/index.php/TinyMCE:API/tinymce.PluginManager/load * @see http://wiki.moxiecode.com/index.php/TinyMCE:API/tinymce.PluginManager/load
* *
* @param[0..] a string, or several strings, or a single array of strings - The plugins to enable * @param String [0..] a string, or several strings, or a single array of strings - The plugins to enable
* @return null * @return null
*/ */
function enablePlugins() { function enablePlugins() {
@ -160,7 +162,7 @@ class HtmlEditorConfig {
/** /**
* Enable one or several plugins. Will properly handle being passed a plugin that is already disabled * Enable one or several plugins. Will properly handle being passed a plugin that is already disabled
* @param[0..] a string, or several strings, or a single array of strings - The plugins to disable * @param String [0..] a string, or several strings, or a single array of strings - The plugins to disable
* @return null * @return null
*/ */
function disablePlugins() { function disablePlugins() {
@ -183,8 +185,9 @@ class HtmlEditorConfig {
/** /**
* Totally re-set the buttons on a given line * Totally re-set the buttons on a given line
* @param[0] integer from 1..3 - The line number to redefine *
* @param[1..] a string or several strings, or a single array of strings - The button names to make this line contain * @param integer from 1..3 - The line number to redefine
* @param string a string or several strings, or a single array of strings - The button names to make this line contain
* @return null * @return null
*/ */
function setButtonsForLine() { function setButtonsForLine() {
@ -200,8 +203,8 @@ class HtmlEditorConfig {
/** /**
* Add buttons to the end of a line * Add buttons to the end of a line
* @param[0] integer from 1..3 * @param integer from 1..3
* @param[1..] a string, or several strings, or a single array of strings - The button names to add to the end of this line * @param string a string, or several strings, or a single array of strings - The button names to add to the end of this line
* @return null * @return null
*/ */
function addButtonsToLine() { function addButtonsToLine() {
@ -235,8 +238,8 @@ class HtmlEditorConfig {
/** /**
* Insert buttons before the first occurance of another button * Insert buttons before the first occurance of another button
* @param[0] string - the name of the button to insert other buttons before * @param string - the name of the button to insert other buttons before
* @param[1..] a string, or several strings, or a single array of strings - the button names to insert before that button * @param string a string, or several strings, or a single array of strings - the button names to insert before that button
* @return boolean - true if insertion occured, false if it did not (because the given button name was not found) * @return boolean - true if insertion occured, false if it did not (because the given button name was not found)
*/ */
function insertButtonsBefore() { function insertButtonsBefore() {
@ -247,8 +250,8 @@ class HtmlEditorConfig {
/** /**
* Insert buttons after the first occurance of another button * Insert buttons after the first occurance of another button
* @param[0] string - the name of the button to insert other buttons after * @param string - the name of the button to insert other buttons after
* @param[1..] a string, or several strings, or a single array of strings - the button names to insert after that button * @param string a string, or several strings, or a single array of strings - the button names to insert after that button
* @return boolean - true if insertion occured, false if it did not (because the given button name was not found) * @return boolean - true if insertion occured, false if it did not (because the given button name was not found)
*/ */
function insertButtonsAfter() { function insertButtonsAfter() {
@ -259,7 +262,7 @@ class HtmlEditorConfig {
/** /**
* Remove the first occurance of buttons * Remove the first occurance of buttons
* @param[0..] string - the name of the buttons to remove * @param string one or more strings - the name of the buttons to remove
* @return null * @return null
*/ */
function removeButtons() { function removeButtons() {

View File

@ -15,7 +15,8 @@
* $field->setIsNullLabel(_T(SOME_MODULE_ISNULL_LABEL, "Is Null"); * $field->setIsNullLabel(_T(SOME_MODULE_ISNULL_LABEL, "Is Null");
* *
* @author Pete Bacon Darwin * @author Pete Bacon Darwin
* * @package forms
* @subpackage fields-basic
*/ */
class NullableField extends FormField { class NullableField extends FormField {
/** /**
@ -57,7 +58,6 @@ class NullableField extends FormField {
/** /**
* Set the label used for the Is Null checkbox. * Set the label used for the Is Null checkbox.
* @param $isNulLabel string * @param $isNulLabel string
* @return
*/ */
function setIsNullLabel(string $isNulLabel){ function setIsNullLabel(string $isNulLabel){
$this->isNullLabel = $isNulLabel; $this->isNullLabel = $isNulLabel;

View File

@ -149,7 +149,7 @@ class TableListField extends FormField {
* @var $customSourceItems DataObjectSet Use the manual setting of a result-set only as a last-resort * @var $customSourceItems DataObjectSet Use the manual setting of a result-set only as a last-resort
* for sets which can't be resolved in a single query. * for sets which can't be resolved in a single query.
* *
* @todo: Add pagination support for customSourceItems. * @todo Add pagination support for customSourceItems.
*/ */
protected $customSourceItems; protected $customSourceItems;
@ -1407,6 +1407,10 @@ class TableListField_Item extends ViewableData {
} }
} }
/**
* @package forms
* @subpackage fields-relational
*/
class TableListField_ItemRequest extends RequestHandler { class TableListField_ItemRequest extends RequestHandler {
protected $ctf; protected $ctf;
protected $itemID; protected $itemID;

View File

@ -288,6 +288,10 @@ class TreeDropdownField extends FormField {
} }
} }
/**
* @package forms
* @subpackage fields-relational
*/
class TreeDropdownField_Readonly extends TreeDropdownField { class TreeDropdownField_Readonly extends TreeDropdownField {
protected $readonly = true; protected $readonly = true;

View File

@ -2,6 +2,7 @@
/** /**
* This formfield represents many-many joins using a tree selector shown in a dropdown styled element * This formfield represents many-many joins using a tree selector shown in a dropdown styled element
* which can be added to any form usually in the CMS. * which can be added to any form usually in the CMS.
*
* @package forms * @package forms
* @subpackage fields-relational * @subpackage fields-relational
*/ */
@ -128,6 +129,10 @@ HTML;
} }
} }
/**
* @package forms
* @subpackage fields-relational
*/
class TreeMultiselectField_Readonly extends TreeMultiselectField { class TreeMultiselectField_Readonly extends TreeMultiselectField {
protected $readonly = true; protected $readonly = true;

View File

@ -324,7 +324,7 @@ class SSHTMLBBCodeParser
* $_preparsed variable. The method uses _buildTag() to check if a tag is * $_preparsed variable. The method uses _buildTag() to check if a tag is
* valid and to build the actual tag to be added to the tag array. * valid and to build the actual tag to be added to the tag array.
* *
* @todo: - rewrite whole method, as this one is old and probably slow * @todo - rewrite whole method, as this one is old and probably slow
* - see if a recursive method would be better than an iterative one * - see if a recursive method would be better than an iterative one
* *
* @return none * @return none

View File

@ -88,7 +88,7 @@ class SearchContext extends Object {
} }
/** /**
* @refactor move to SQLQuery * @todo move to SQLQuery
* @todo fix hack * @todo fix hack
*/ */
protected function applyBaseTableFields() { protected function applyBaseTableFields() {

View File

@ -9,6 +9,8 @@
* SQL syntax used: Column IN ('val1','val2') * SQL syntax used: Column IN ('val1','val2')
* *
* @todo Add negation (NOT IN)6 * @todo Add negation (NOT IN)6
* @package sapphire
* @subpackage search
*/ */
class ExactMatchMultiFilter extends SearchFilter { class ExactMatchMultiFilter extends SearchFilter {

View File

@ -1,10 +1,12 @@
<?php <?php
/** /**
* A PermissionRole represents a collection of permission codes that can be applied to groups. * A PermissionRole represents a collection of permission codes that can be applied to groups.
* *
* Because permission codes are very granular, this lets website administrators create more * Because permission codes are very granular, this lets website administrators create more
* business-oriented units of access control - Roles - and assign those to groups. * business-oriented units of access control - Roles - and assign those to groups.
*
* @package sapphire
* @subpackage security
*/ */
class PermissionRole extends DataObject { class PermissionRole extends DataObject {
static $db = array( static $db = array(

View File

@ -215,6 +215,10 @@ class Widget_Controller extends Controller {
} }
} }
/**
* @package sapphire
* @subpackage widgets
*/
class Widget_TreeDropdownField extends TreeDropdownField { class Widget_TreeDropdownField extends TreeDropdownField {
function FieldHolder() {} function FieldHolder() {}
function Field() {} function Field() {}