From 1aad31abe87a9bbdc06aa1532d24d346fd8dd709 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 26df29870d2bb6fa3735a1d09b64ca11ff2210d0 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 =============