summaryrefslogtreecommitdiffstats
path: root/lib/public
diff options
context:
space:
mode:
authorChristoph Wurst <christoph@winzerhof-wurst.at>2021-11-11 11:02:48 +0100
committerChristoph Wurst <christoph@winzerhof-wurst.at>2021-11-11 11:02:48 +0100
commit0b72abb7a54ecf32b829ba610ec6903391d28273 (patch)
tree133d5313a2dde25495ee4270d54c74d829f7b788 /lib/public
parent4e1e81f336936f8fbffaba9c6f16f46379cf028e (diff)
downloadnextcloud-server-0b72abb7a54ecf32b829ba610ec6903391d28273.tar.gz
nextcloud-server-0b72abb7a54ecf32b829ba610ec6903391d28273.zip
Document allowed property names for calendar property searches
For API users it looked like any properties could be searched. But it turned out to be a hand picked list of properties that we index and then use for the search. To prevent application errors where special props are not found, I suggest we document the allowed values. Signed-off-by: Christoph Wurst <christoph@winzerhof-wurst.at>
Diffstat (limited to 'lib/public')
-rw-r--r--lib/public/Calendar/ICalendarQuery.php5
1 files changed, 5 insertions, 0 deletions
diff --git a/lib/public/Calendar/ICalendarQuery.php b/lib/public/Calendar/ICalendarQuery.php
index 142810d3fb9..d37c4b94225 100644
--- a/lib/public/Calendar/ICalendarQuery.php
+++ b/lib/public/Calendar/ICalendarQuery.php
@@ -51,6 +51,11 @@ interface ICalendarQuery {
/**
* Define the property name(s) to search for
*
+ * Note: Nextcloud only indexes *some* properties. You can not search for
+ * arbitrary properties.
+ *
+ * @param string $value one of CATEGORIES, COMMENT, DESCRIPTION, LOCATION, RESOURCES, STATUS, SUMMARY, ATTENDEE, CONTACT or ORGANIZER
+ *
* @since 23.0.0
*/
public function addSearchProperty(string $value): void;