silverstripe / silverstripe-forum

code/controllers/ForumMemberProfile.php

Doc Comments +1 added lines, -1 removed lines

@@ -556,7 +556,7 @@
 	/**
 	 * Return the with the passed ID (via URL parameters) or the current user
 	 *
-	 * @return null|Member Returns the member object or NULL if the member
+	 * @return DataObject|null Returns the member object or NULL if the member
 	 *                     was not found
 	 */
  	function Member() {

code/formfields/CheckableOption.php

Doc Comments +3 added lines

@@ -3,6 +3,9 @@
 class CheckableOption extends CompositeField {
 	protected $childField, $checkbox;
 		
+	/**
+	 * @param string $checkName
+	 */
 	function __construct($checkName, $childField, $value = "", $readonly = false) {
 		$this->name = $checkName;
 		$this->checkbox = new CheckboxField($checkName, "", $value);

code/formfields/ForumCountryDropdownField.php

Doc Comments +4 added lines

@@ -28,6 +28,10 @@
 		return i18n::get_locale();
 	}
 
+	/**
+	 * @param string $name
+	 * @param string $title
+	 */
 	function __construct($name, $title = null, $source = null, $value = "", $form=null) {
 		if(!is_array($source)) {
 			// Get a list of countries from Zend

code/model/ForumThread.php

Doc Comments +1 added lines, -1 removed lines

@@ -143,7 +143,7 @@
 	 * Check if they have visited this thread before. If they haven't increment 
 	 * the NumViews value by 1 and set visited to true.
 	 *
-	 * @return void
+	 * @return false|null
 	 */
 	public function incNumViews() {
 		if(Session::get('ForumViewed-' . $this->ID)) return false;

code/pagetypes/Forum.php

Doc Comments +13 added lines, -7 removed lines

@@ -354,7 +354,7 @@ 
 	/**
 	 * Get the number of total topics (threads) in this Forum
 	 *
-	 * @return int Returns the number of topics (threads)
+	 * @return string Returns the number of topics (threads)
 	 */
 	function getNumTopics() {
 		$sqlQuery = new SQLQuery();
@@ -369,7 +369,7 @@ 
 	/**
 	 * Get the number of total posts
 	 *
-	 * @return int Returns the number of posts
+	 * @return string Returns the number of posts
 	 */
 	function getNumPosts() {
 		$sqlQuery = new SQLQuery();
@@ -385,7 +385,7 @@ 
 	/**
 	 * Get the number of distinct Authors
 	 *
-	 * @return int
+	 * @return string
 	 */
 	function getNumAuthors() {
 		$sqlQuery = new SQLQuery();
@@ -399,7 +399,7 @@ 
 
 	/**
 	 * Returns the Topics (the first Post of each Thread) for this Forum
-	 * @return DataList
+	 * @return PaginatedList|null
 	 */
 	function getTopics() {
 		// Get a list of Posts
@@ -591,7 +591,7 @@ 
 	 *
 	 * Designed to be called via AJAX so return true / false
 	 *
-	 * @return bool
+	 * @return null|false
 	 */
 	function unsubscribe(SS_HTTPRequest $request) {
 		$member = Member::currentUser();
@@ -713,7 +713,7 @@ 
 	/**
 	 * Get posts to display. This method assumes an URL parameter "ID" which contains the thread ID.
 	 * @param string sortDirection The sort order direction, either ASC for ascending (default) or DESC for descending
-	 * @return DataObjectSet Posts
+	 * @return PaginatedList Posts
 	 */
 	function Posts($sortDirection = "ASC") {
 		$numPerPage = Forum::$posts_per_page;
@@ -764,7 +764,7 @@ 
 	/**
 	 * Get the usable BB codes
 	 *
-	 * @return DataObjectSet Returns the usable BB codes
+	 * @return ArrayList Returns the usable BB codes
 	 * @see BBCodeParser::usable_tags()
 	 */
 	function BBTags() {
@@ -1046,6 +1046,8 @@ 
 
 	/**
 	 * Send email to moderators notifying them the thread has been created or post added/edited.
+	 * @param DataObject $post
+	 * @param DataObject $thread
 	 */
 	function notifyModerators($post, $thread, $starting_thread = false) {
 		$moderators = $this->Moderators();
@@ -1370,6 +1372,10 @@ 
  * TODO: Remove once API in core
  */
 class Forum_DataQuery extends DataQuery {
+
+	/**
+	 * @param string $dataClass
+	 */
 	function __construct($dataClass, $query) {
 		parent::__construct($dataClass);
 		$this->query = $query;

code/pagetypes/ForumHolder.php

Doc Comments +6 added lines, -5 removed lines

@@ -219,7 +219,7 @@ 
 	/**
 	 * Get the number of total posts
 	 *
-	 * @return int Returns the number of posts
+	 * @return string Returns the number of posts
 	 */
 	public function getNumPosts() {
 			$sqlQuery = new SQLQuery();
@@ -236,7 +236,7 @@ 
 	/**
 	 * Get the number of total topics (threads)
 	 *
-	 * @return int Returns the number of topics (threads)
+	 * @return string Returns the number of topics (threads)
 	 */
 	function getNumTopics() {
 		$sqlQuery = new SQLQuery();
@@ -253,7 +253,7 @@ 
 	/**
 	 * Get the number of distinct authors
 	 *
-	 * @return int Returns the number of distinct authors
+	 * @return string Returns the number of distinct authors
 	 */
 	public function getNumAuthors() {
 		$sqlQuery = new SQLQuery();
@@ -348,7 +348,7 @@ 
 
 	/**
 	 * Get a list of Forum Categories
-	 * @return DataList
+	 * @return boolean
 	 */
 	function getShowInCategories() {
 	 	$forumCategories = ForumCategory::get()->filter('ForumHolderID', $this->ID);
@@ -495,8 +495,9 @@ 
 	 *                    it (keys: 'last_id', 'last_created')
 	 * @param int $lastVisit Unix timestamp of the last visit (GMT)
 	 * @param int $lastPostID ID of the last read post
-	 * @param int $thread ID of the relevant topic (set to NULL for all
+	 * @param integer $threadID ID of the relevant topic (set to NULL for all
 	 *                     topics)
+	 * @param integer $forumID
 	 * @return bool Returns TRUE if there are new posts available, otherwise
 	 *              FALSE.
 	 */