From 47043a54a535941f5cdcdacb4a9dd2bb5de887c1 Mon Sep 17 00:00:00 2001 From: Benjamin Eberlei Date: Sun, 13 Jan 2013 09:37:45 +0100 Subject: [PATCH] Update en/reference/filters.rst --- en/reference/filters.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/en/reference/filters.rst b/en/reference/filters.rst index 3f3ab8492..34485b087 100644 --- a/en/reference/filters.rst +++ b/en/reference/filters.rst @@ -23,6 +23,11 @@ illustrate how the filter feature works. A filter class must extend the base method. The method receives the ``ClassMetadata`` of the filtered entity and the table alias of the SQL table of the entity. +.. note:: + + In the case of joined or single table inheritance, you always get passed the ClassMetadata of the + inheritance root. This is necessary to avoid edge cases that would break the SQL when applying the filters. + Parameters for the query should be set on the filter object by ``SQLFilter#setParameter()``. Only parameters set via this function can be used in filters. The ``SQLFilter#getParameter()`` function takes care of the