Fetching contributors…
Cannot retrieve contributors at this time
45 lines (36 sloc) 2.01 KB

Documentation Guideline for Admin Page Framework

The documentation of Admin Page Framework is directly written in the source code and a document parser is used to generate HTML files from it.

Therefore, in order to write documentation, write it right before the definition of classes, methods, properties, and functions etc.


The syntax of DocBlock is employed.

The allowed HTML tags: b, i, a, ul, ol, li, p, br, var, samp, kbd, tt, code, blockquote, pre, h4, h3, h2, h1, strong, em, span.


 * Sets the given message to be displayed in the next page load. 
 * This is used to inform users about the submitted input data, such as "Updated sucessfully." or "Problem occured." etc. and normally used in validation callback methods.
 * <strong>Example</strong>
 * <code>if ( ! $bVerified ) {
 *      $this->setFieldErrors( $aErrors );      
 *      $this->setSettingNotice( 'There was an error in your input.' );
 *      return $aOldPageOptions;
 *  }</code>
 * @since           2.0.0
 * @access          protected
 * @remark          The user may use this method in their extended class definition.
 * @param           string          the text message to be displayed.
 * @param           string          ( optional ) the type of the message, either "error" or "updated"  is used.
 * @param           string          ( optional ) the ID of the message. This is used in the ID attribute of the message HTML element.
 * @return          void
protected function setSettingNotice( $sMsg, $sType='error', $sID=null ) {

        isset( $sID ) ? $sID : ( isset( $_GET['page'] ) ? $_GET['page'] : $this->oProp->sOptionKey ),



Before submitting your documentation, please raise an issue first so that we can discuss whether it is appropriate or something is missing or not.