updated contrib modules

sites/all/modules/views/plugins/views_plugin_query.inc

@@ -2,7 +2,7 @@
 
 /**
  * @file
- * Defines the base query class, which is the underlying layer in a View.
+ * Definition of views_plugin_query.
  */
 
 /**
@@ -14,20 +14,21 @@
  */
 
 /**
- * Object used to create a SELECT query.
+ * The base query class, which is the underlying layer in a View.
  */
 class views_plugin_query extends views_plugin {
+
   /**
    * A pager plugin that should be provided by the display.
    *
    * @var views_plugin_pager
    */
-  var $pager = NULL;
+  public $pager = NULL;
 
   /**
    * Constructor; Create the basic query object and fill with default values.
    */
-  function init($base_table, $base_field, $options) {
+  public function init($base_table, $base_field, $options) {
     $this->base_table = $base_table;
     $this->base_field = $base_field;
     $this->unpack_options($this->options, $options);
@@ -37,13 +38,14 @@ class views_plugin_query extends views_plugin {
    * Generate a query and a countquery from all of the information supplied
    * to the object.
    *
-   * @param $get_count
-   *   Provide a countquery if this is true, otherwise provide a normal query.
+   * @param bool $get_count
+   *   Provide a countquery if this is TRUE, otherwise provide a normal query.
    *
    * @return SelectQuery
    *   A SelectQuery object.
    */
-  function query($get_count = FALSE) { }
+  public function query($get_count = FALSE) {
+  }
 
   /**
    * Let modules modify the query just prior to finalizing it.
@@ -51,7 +53,8 @@ class views_plugin_query extends views_plugin {
    * @param view $view
    *   The view which is executed.
    */
-  function alter(&$view) {  }
+  public function alter(&$view) {
+  }
 
   /**
    * Builds the necessary info to execute the query.
@@ -59,7 +62,8 @@ class views_plugin_query extends views_plugin {
    * @param view $view
    *   The view which is executed.
    */
-  function build(&$view) { }
+  public function build(&$view) {
+  }
 
   /**
    * Executes the query and fills the associated view object with according
@@ -74,7 +78,8 @@ class views_plugin_query extends views_plugin {
    * @param view $view
    *   The view which is executed.
    */
-  function execute(&$view) {  }
+  public function execute(&$view) {
+  }
 
   /**
    * Add a signature to the query, if such a thing is feasible.
@@ -85,48 +90,61 @@ class views_plugin_query extends views_plugin {
    * @param view $view
    *   The view which is executed.
    */
-  function add_signature(&$view) { }
+  public function add_signature(&$view) {
+  }
 
   /**
    * Get aggregation info for group by queries.
    *
    * If NULL, aggregation is not allowed.
    */
-  function get_aggregation_info() { }
+  public function get_aggregation_info() {
+  }
 
   /**
    * Add settings for the ui.
    */
-  function options_form(&$form, &$form_state) {
+  public function options_form(&$form, &$form_state) {
     parent::options_form($form, $form_state);
   }
 
-  function options_validate(&$form, &$form_state) { }
+  /**
+   * {@inheritdoc}
+   */
+  public function options_validate(&$form, &$form_state) {
+  }
 
-  function options_submit(&$form, &$form_state) { }
+  /**
+   * {@inheritdoc}
+   */
+  public function options_submit(&$form, &$form_state) {
+  }
 
-  function summary_title() {
+  /**
+   * {@inheritdoc}
+   */
+  public function summary_title() {
     return t('Settings');
   }
 
   /**
    * Set a LIMIT on the query, specifying a maximum number of results.
    */
-  function set_limit($limit) {
+  public function set_limit($limit) {
     $this->limit = $limit;
   }
 
   /**
    * Set an OFFSET on the query, specifying a number of results to skip
    */
-  function set_offset($offset) {
+  public function set_offset($offset) {
     $this->offset = $offset;
   }
 
   /**
    * Render the pager, if necessary.
    */
-  function render_pager($exposed_input) {
+  public function render_pager($exposed_input) {
     if (!empty($this->pager) && $this->pager->use_pager()) {
       return $this->pager->render($exposed_input);
     }
@@ -137,18 +155,18 @@ class views_plugin_query extends views_plugin {
   /**
    * Create a new grouping for the WHERE or HAVING clause.
    *
-   * @param $type
+   * @param string $type
    *   Either 'AND' or 'OR'. All items within this group will be added
    *   to the WHERE clause with this logical operator.
-   * @param $group
+   * @param string $group
    *   An ID to use for this group. If unspecified, an ID will be generated.
-   * @param $where
+   * @param string $where
    *   'where' or 'having'.
    *
-   * @return $group
+   * @return string
    *   The group ID generated.
    */
-  function set_where_group($type = 'AND', $group = NULL, $where = 'where') {
+  public function set_where_group($type = 'AND', $group = NULL, $where = 'where') {
     // Set an alias.
     $groups = &$this->$where;
 
@@ -168,19 +186,20 @@ class views_plugin_query extends views_plugin {
   /**
    * Control how all WHERE and HAVING groups are put together.
    *
-   * @param $type
-   *   Either 'AND' or 'OR'
+   * @param string $type
+   *   Either 'AND' or 'OR'.
    */
-  function set_group_operator($type = 'AND') {
+  public function set_group_operator($type = 'AND') {
     $this->group_operator = strtoupper($type);
   }
 
   /**
    * Returns the according entity objects for the given query results.
    */
-  function get_result_entities($results, $relationship = NULL) {
+  public function get_result_entities($results, $relationship = NULL) {
     return FALSE;
   }
+
 }
 
 /**