From 51f953e2fd6e43bba7957d48cfd89c250543aade Mon Sep 17 00:00:00 2001 From: Letharion Date: Sun, 12 Aug 2012 18:43:08 +0200 Subject: [PATCH] Issue #1718956 by Letharion: Document that add_where() takes DatabaseCondition as an argument. --- plugins/views_plugin_query_default.inc | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/plugins/views_plugin_query_default.inc b/plugins/views_plugin_query_default.inc index 9398a96427c..0c3c1e003ed 100644 --- a/plugins/views_plugin_query_default.inc +++ b/plugins/views_plugin_query_default.inc @@ -859,7 +859,19 @@ class views_plugin_query_default extends views_plugin_query { * options such as IN, LIKE, or BETWEEN. Defaults to IN if $value is an array * = otherwise. If $field is a string you have to use 'formula' here. * - * @see QueryConditionInterface::condition() + * The $field, $value and $operator arguments can also be passed in with a + * single DatabaseCondition object, like this: + * @code + * $this->query->add_where( + * $this->options['group'], + * db_or() + * ->condition($field, $value, 'NOT IN') + * ->condition($field, $value, 'IS NULL') + * ); + * @endcode + * + * @see Drupal\Core\Database\Query\ConditionInterface::condition() + * @see Drupal\Core\Database\Query\Condition */ function add_where($group, $field, $value = NULL, $operator = NULL) { // Ensure all variants of 0 are actually 0. Thus '', 0 and NULL are all