From 625b08294e625d3dccba82088fc07d7350845f61 Mon Sep 17 00:00:00 2001
From: Erick Hitter <ehitter@gmail.com>
Date: Sun, 25 Aug 2013 10:51:31 -0400
Subject: [PATCH] Fix phpdoc
---
tag-dropdown-widget.php | 80 ++++++++++++++++++++++++++---------------
1 file changed, 52 insertions(+), 28 deletions(-)
diff --git a/tag-dropdown-widget.php b/tag-dropdown-widget.php
index 94503d5..b25b81c 100644
--- a/tag-dropdown-widget.php
+++ b/tag-dropdown-widget.php
@@ -31,7 +31,7 @@ class taxonomy_dropdown_widget_plugin {
*/
private static $__instance = null;
- /*
+ /**
* Class variables
*/
var $option_defaults = array(
@@ -62,9 +62,11 @@ class taxonomy_dropdown_widget_plugin {
return self::$__instance;
}
- /*
+ /**
* Register actions and activation/deactivation hooks
- * @uses add_action, register_activation_hook, register_deactivation_hook
+ * @uses add_action
+ * @uses register_activation_hook
+ * @uses register_deactivation_hook
* @return null
*/
private function __construct() {
@@ -74,7 +76,7 @@ class taxonomy_dropdown_widget_plugin {
register_deactivation_hook( __FILE__, array( $this, 'deactivation_hook' ) );
}
- /*
+ /**
* Run plugin cleanup on activation
* @uses this::cleanup
* @hook activation
@@ -84,7 +86,7 @@ class taxonomy_dropdown_widget_plugin {
$this->cleanup();
}
- /*
+ /**
* Unregister widget when plugin is deactivated and run cleanup
* @uses this::cleanup
* @hook deactivation
@@ -94,7 +96,7 @@ class taxonomy_dropdown_widget_plugin {
$this->cleanup();
}
- /*
+ /**
* Remove options related to plugin versions older than 2.0.
* @uses add_filter
* @uses delete_option
@@ -116,7 +118,7 @@ class taxonomy_dropdown_widget_plugin {
}
}
- /*
+ /**
* Register widget
* @uses register_widget
* @action widgets_init
@@ -127,11 +129,20 @@ class taxonomy_dropdown_widget_plugin {
register_widget( 'taxonomy_dropdown_widget' );
}
- /*
+ /**
* Render widget
* @param array $options
* @param string|int $id
- * @uses wp_parse_args, sanitize_title, apply_filters, get_terms, is_wp_error, is_tag, is_tax, esc_url, get_term_link, selected
+ * @uses wp_parse_args
+ * @uses sanitize_title
+ * @uses apply_filters
+ * @uses get_terms
+ * @uses is_wp_error
+ * @uses is_tag
+ * @uses is_tax
+ * @uses esc_url
+ * @uses get_term_link
+ * @uses selected
* @return string or false
*/
function render_dropdown( $options, $id = false ) {
@@ -213,10 +224,13 @@ class taxonomy_dropdown_widget_plugin {
}
}
- /*
+ /**
* Sanitize plugin options
* @param array $options
- * @uses taxonomy_exists, sanitize_text_field, absint, wp_parse_args
+ * @uses taxonomy_exists
+ * @uses sanitize_text_field
+ * @uses absint
+ * @uses wp_parse_args
* @return array
*/
function sanitize_options( $options ) {
@@ -314,16 +328,17 @@ $GLOBALS['taxonomy_dropdown_widget_plugin'] = taxonomy_dropdown_widget_plugin::g
** TAXONOMY DROPDOWN WIDGET
**/
class taxonomy_dropdown_widget extends WP_Widget {
- /*
+ /**
* Class variables
*/
var $defaults = array(
'title' => 'Tags'
);
- /*
+ /**
* Register widget and populate class variables
- * @uses $this::WP_Widget, $taxonomy_dropdown_widget_plugin
+ * @uses this::WP_Widget
+ * @uses taxonomy_dropdown_widget_plugin
* @return null
*/
function taxonomy_dropdown_widget() {
@@ -338,11 +353,13 @@ class taxonomy_dropdown_widget extends WP_Widget {
$this->defaults = array_merge( $taxonomy_dropdown_widget_plugin->option_defaults, $this->defaults );
}
- /*
+ /**
* Render widget
* @param array $args
* @param array $instance
- * @uses $taxonomy_dropdown_widget_plugin, wp_parse_args, apply_filters
+ * @uses taxonomy_dropdown_widget_plugin
+ * @uses wp_parse_args
+ * @uses apply_filters
* @return string or null
*/
function widget( $args, $instance ) {
@@ -374,11 +391,11 @@ class taxonomy_dropdown_widget extends WP_Widget {
}
}
- /*
+ /**
* Options sanitization
* @param array $new_instance
* @param array $old_instance
- * @uses $taxonomy_dropdown_widget_plugin
+ * @uses taxonomy_dropdown_widget_plugin
* @return array
*/
function update( $new_instance, $old_instance ) {
@@ -390,10 +407,17 @@ class taxonomy_dropdown_widget extends WP_Widget {
return $taxonomy_dropdown_widget_plugin->sanitize_options( $new_instance );
}
- /*
+ /**
* Widget options
* @param array $instance
- * @uses wp_parse_args, get_taxonomies, _e, $this::get_field_id, $this::get_field_name, esc_attr, selected, checked
+ * @uses wp_parse_args
+ * @uses get_taxonomies
+ * @uses _e
+ * @uses this::get_field_id
+ * @uses this::get_field_name
+ * @uses esc_attr
+ * @uses selected
+ * @uses checked
* @return string
*/
function form( $instance ) {
@@ -521,11 +545,11 @@ class taxonomy_dropdown_widget extends WP_Widget {
** HELPER FUNCTIONS
**/
-/*
+/**
* Render taxonomy dropdown
* @param array $options
* @param string|int $id
- * @uses $taxonomy_dropdown_widget_plugin
+ * @uses taxonomy_dropdown_widget_plugin
* @return string or false
*/
function taxonomy_dropdown_widget( $options = array(), $id = '' ) {
@@ -544,10 +568,10 @@ function taxonomy_dropdown_widget( $options = array(), $id = '' ) {
**/
if ( !function_exists( 'generateTagDropdown' ) ):
- /*
+ /**
* Build tag dropdown based on provided arguments
* @since 1.7
- * @uses $taxonomy_dropdown_widget_plugin
+ * @uses taxonomy_dropdown_widget_plugin
* @return string or false
*/
function generateTagDropdown( $args ) {
@@ -563,10 +587,10 @@ if ( !function_exists( 'generateTagDropdown' ) ):
endif;
if ( !function_exists( 'TDW_direct' ) ):
- /*
+ /**
* Build tag dropdown based on provided arguments
* @since 1.6
- * @uses $taxonomy_dropdown_widget_plugin
+ * @uses taxonomy_dropdown_widget_plugin
* @return string or false
*/
function TDW_direct( $limit = false, $count = false, $exclude = false ) {
@@ -593,10 +617,10 @@ if ( !function_exists( 'TDW_direct' ) ):
endif;
if ( !function_exists( 'makeTagDropdown' ) ):
- /*
+ /**
* Build tag dropdown based on provided arguments
* @since 1.3
- * @uses $taxonomy_dropdown_widget_plugin
+ * @uses taxonomy_dropdown_widget_plugin
* @return string or false
*/
function makeTagDropdown( $limit = false ) {
--
GitLab