From 7859be61857a96a79d1a1c6995a81b4b3da9582b Mon Sep 17 00:00:00 2001 From: Sybille Peters Date: Sat, 18 Nov 2023 05:32:04 +0100 Subject: [PATCH 1/2] Clarify foreign_table_where The previous explanation for foreign_table_where was slightly misleading. The examples speak for themselves, but they are further down on the page. The WHERE-clause is effectively appended to the existing WHERE clause created by TYPO3 using the default values and must start with AND. Also, additional clauses such as ORDER BY or GROUP BY may be added after the WHERE-clause. Resolves: #663 --- .../Type/Select/Properties/ForeignTableWhere.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/Documentation/ColumnsConfig/Type/Select/Properties/ForeignTableWhere.rst b/Documentation/ColumnsConfig/Type/Select/Properties/ForeignTableWhere.rst index 233cefce..8d6368f3 100644 --- a/Documentation/ColumnsConfig/Type/Select/Properties/ForeignTableWhere.rst +++ b/Documentation/ColumnsConfig/Type/Select/Properties/ForeignTableWhere.rst @@ -13,7 +13,11 @@ foreign_table_where :RenderType: all The items from :ref:`foreign_table ` - are selected with this WHERE-clause. + are selected with this WHERE-clause. The WHERE-clause is effectively + appended to the existing WHERE-clause (which contains default constraints, + such as 'NOT deleted') and must begin with AND. Additional clauses such as + ORDER BY may be added after the WHERE-clause. The result must be a valid SQL + statement. Field quoting ============= From 1d4b3aa8fc9fb7b05f8e69310d9c86507ec1708f Mon Sep 17 00:00:00 2001 From: Sybille Peters Date: Sat, 18 Nov 2023 12:15:11 +0100 Subject: [PATCH 2/2] Embed SQL with role:sql: --- .../Type/Select/Properties/ForeignTableWhere.rst | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/Documentation/ColumnsConfig/Type/Select/Properties/ForeignTableWhere.rst b/Documentation/ColumnsConfig/Type/Select/Properties/ForeignTableWhere.rst index 8d6368f3..df657c8e 100644 --- a/Documentation/ColumnsConfig/Type/Select/Properties/ForeignTableWhere.rst +++ b/Documentation/ColumnsConfig/Type/Select/Properties/ForeignTableWhere.rst @@ -13,11 +13,9 @@ foreign_table_where :RenderType: all The items from :ref:`foreign_table ` - are selected with this WHERE-clause. The WHERE-clause is effectively - appended to the existing WHERE-clause (which contains default constraints, - such as 'NOT deleted') and must begin with AND. Additional clauses such as - ORDER BY may be added after the WHERE-clause. The result must be a valid SQL - statement. + are selected with this :sql:`WHERE` clause. The :sql:`WHERE` clause is effectively + appended to the existing :sql:`WHERE` clause (which contains default constraints, + such as :sql:`NOT deleted) and must begin with :sql:`AND`. Field quoting =============