Added doc for TaxonomyNoEntries & TaxonomySubtree by mnocon · Pull Request #3082 · ibexa/documentation-developer

mnocon · 2026-03-11T11:20:42Z

Doc for https://github.com/ibexa/taxonomy/pull/404

Target: 4.6, v5

Update: as suggested in review, this PR also adds the missing TaxonomySubtree criterion

github-actions · 2026-03-11T11:20:55Z

Preview of modified files

Preview of modified Markdown:

mnocon · 2026-03-11T11:26:49Z

docs/search/criteria_reference/taxonomy_no_entries.md

+
+# TaxonomyNoEntries Criterion
+
+The [`TaxonomyNoEntries` Search Criterion](https://example.com/api/php_api/php_api_reference/classes/Ibexa-Contracts-Taxonomy-Search-Query-Criterion-TaxonomyNoEntries.html) searches for content that has no entries assigned from the specified [taxonomy](taxonomy.md).


The example.com is a TMP change that must be removed before merge - the criterion is not part of the PHP API reference until it's released

barw4

LGTM aside from one unrelated change. Is there any reason why we have no documentation about src/contracts/Search/Query/Criterion/TaxonomySubtree.php?

mnocon · 2026-03-11T12:48:01Z

Thanks, doc for Taxonomy Subtree added in 91bb827

julitafalcondusza

Just cosmetic remarks.

docs/content_management/taxonomy/taxonomy_api.md

docs/search/criteria_reference/taxonomy_no_entries.md

docs/search/criteria_reference/taxonomy_subtree.md

docs/search/criteria_reference/taxonomy_no_entries.md

+The [`TaxonomyNoEntries` Search Criterion](https://example.com/api/php_api/php_api_reference/classes/Ibexa-Contracts-Taxonomy-Search-Query-Criterion-TaxonomyNoEntries.html) searches for content that has no entries assigned from the specified [taxonomy](taxonomy.md).
+
+Use it when you need to find content items to which no taxonomy entries have been assigned (for example, articles without tags).
+It is available for all supported search engines and in [repository filtering](search_api.md#repository-filtering)


docs/search/criteria_reference/taxonomy_no_entries.md

docs/search/criteria_reference/taxonomy_subtree.md

Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com>

docs/search/criteria_reference/taxonomy_no_entries.md

github-actions · 2026-03-25T08:16:46Z

code_samples/ change report

Before (on target branch)	After (in current PR)
`code_samples/search/content/taxonomy_no_entries_criterion.php`	`code_samples/search/content/taxonomy_no_entries_criterion.php`
	docs/search/criteria_reference/taxonomy_no_entries.md@22:```php hl_lines="11-14" `docs/search/criteria_reference/taxonomy_no_entries.md@23:[[= include_file('code_samples/search/content/taxonomy_no_entries_criterion.php') =]]` docs/search/criteria_reference/taxonomy_no_entries.md@24:``` `001⫶<?php` `002⫶` `003⫶declare(strict_types=1);` `004⫶` `005⫶use Ibexa\Contracts\Core\Repository\Values\Content\Query;` `006⫶use Ibexa\Contracts\Core\Repository\Values\Content\Query\Criterion\ContentTypeIdentifier;` `007⫶use Ibexa\Contracts\Core\Repository\Values\Content\Query\Criterion\LogicalAnd;` `008⫶use Ibexa\Contracts\Taxonomy\Search\Query\Criterion\TaxonomyNoEntries;` `009⫶` `010⫶$query = new Query();` `011❇️$query->query = new LogicalAnd(` `012❇️ [` `013❇️ new TaxonomyNoEntries('tags'),` `014❇️ new ContentTypeIdentifier('article'),` `015⫶ ]` `016⫶);` `017⫶` `018⫶/** @var \Ibexa\Contracts\Core\Repository\SearchService $searchService */` `019⫶$results = $searchService->findContent($query);`
`code_samples/search/content/taxonomy_subtree_criterion.php`	`code_samples/search/content/taxonomy_subtree_criterion.php`
	docs/search/criteria_reference/taxonomy_subtree.md@19:```php hl_lines="11-14" `docs/search/criteria_reference/taxonomy_subtree.md@20:[[= include_file('code_samples/search/content/taxonomy_subtree_criterion.php') =]]` docs/search/criteria_reference/taxonomy_subtree.md@21:``` `001⫶<?php` `002⫶` `003⫶declare(strict_types=1);` `004⫶` `005⫶use Ibexa\Contracts\Core\Repository\Values\Content\Query;` `006⫶use Ibexa\Contracts\Core\Repository\Values\Content\Query\Criterion\ContentTypeIdentifier;` `007⫶use Ibexa\Contracts\Core\Repository\Values\Content\Query\Criterion\LogicalAnd;` `008⫶use Ibexa\Contracts\Taxonomy\Search\Query\Criterion\TaxonomySubtree;` `009⫶` `010⫶$query = new Query();` `011❇️$query->query = new LogicalAnd(` `012❇️ [` `013❇️ new TaxonomySubtree(42),` `014❇️ new ContentTypeIdentifier('article'),` `015⫶ ]` `016⫶);` `017⫶` `018⫶/** @var \Ibexa\Contracts\Core\Repository\SearchService $searchService */` `019⫶$results = $searchService->findContent($query);`

Download colorized diff

sonarqubecloud · 2026-03-25T08:21:23Z

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

adriendupuis · 2026-04-07T13:37:31Z

docs/search/criteria_reference/taxonomy_no_entries.md

+
+# TaxonomyNoEntries Criterion
+
+The [`TaxonomyNoEntries`](https://example.com/api/php_api/php_api_reference/classes/Ibexa-Contracts-Taxonomy-Search-Query-Criterion-TaxonomyNoEntries.html) Search Criterion searches for content that has no entries assigned from the specified [taxonomy](taxonomy.md).


Don't forget to update this before merge:

Suggested change

The [`TaxonomyNoEntries`](https://example.com/api/php_api/php_api_reference/classes/Ibexa-Contracts-Taxonomy-Search-Query-Criterion-TaxonomyNoEntries.html) Search Criterion searches for content that has no entries assigned from the specified [taxonomy](taxonomy.md).

The [`TaxonomyNoEntries`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Taxonomy-Search-Query-Criterion-TaxonomyNoEntries.html) Search Criterion searches for content that has no entries assigned from the specified [taxonomy](taxonomy.md).

mnocon force-pushed the ibx-6365-TaxonomyNoEntries-criterion branch 2 times, most recently from d990996 to 10ca6d8 Compare March 11, 2026 11:25

mnocon marked this pull request as ready for review March 11, 2026 11:25

mnocon added the Needs DEV review label Mar 11, 2026

mnocon requested a review from barw4 March 11, 2026 11:26

mnocon commented Mar 11, 2026

View reviewed changes

Added doc for TaxonomyNoEntries

b586e26

mnocon force-pushed the ibx-6365-TaxonomyNoEntries-criterion branch from 10ca6d8 to b586e26 Compare March 11, 2026 11:29

barw4 approved these changes Mar 11, 2026

View reviewed changes

mnocon added 2 commits March 11, 2026 13:37

Added doc for Taxonomy subtree

91bb827

Fixed CS

8500d82

mnocon force-pushed the ibx-6365-TaxonomyNoEntries-criterion branch from b1c1c2d to 8500d82 Compare March 11, 2026 12:38

mnocon requested a review from barw4 March 11, 2026 12:48

barw4 approved these changes Mar 11, 2026

View reviewed changes

mnocon added Needs DOC review and removed Needs DEV review labels Mar 11, 2026

mnocon requested a review from a team March 11, 2026 13:55

mnocon added the Wait with merge PRs that shouldn't be merged instantly label Mar 11, 2026

ibexa-workflow-automation-1 bot requested review from adriendupuis, dabrt and julitafalcondusza and removed request for a team March 11, 2026 13:55

julitafalcondusza approved these changes Mar 18, 2026

View reviewed changes

ibexa deleted a comment from julitafalcondusza Mar 18, 2026

dabrt approved these changes Mar 18, 2026

View reviewed changes

Apply suggestions from code review

f70cf18

Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com>

mnocon commented Mar 18, 2026

View reviewed changes

docs/search/criteria_reference/taxonomy_no_entries.md Outdated Show resolved Hide resolved

Apply suggestion from @mnocon

9092797

mnocon removed the Needs DOC review label Mar 18, 2026

Rebuild

7baf71d

adriendupuis changed the title ~~Added doc for TaxonomyNoEntries~~ Added doc for TaxonomyNoEntries & TaxonomySubtree Apr 1, 2026

adriendupuis mentioned this pull request Apr 1, 2026

Release notes #3076

Draft

7 tasks

adriendupuis reviewed Apr 7, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Added doc for TaxonomyNoEntries & TaxonomySubtree#3082

Added doc for TaxonomyNoEntries & TaxonomySubtree#3082
mnocon wants to merge 6 commits into4.6from
ibx-6365-TaxonomyNoEntries-criterion

mnocon commented Mar 11, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 11, 2026 •

edited

Loading

Uh oh!

mnocon Mar 11, 2026 •

edited

Loading

Uh oh!

barw4 left a comment

Uh oh!

mnocon commented Mar 11, 2026 •

edited

Loading

Uh oh!

julitafalcondusza left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment was marked as resolved.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Mar 25, 2026

Uh oh!

sonarqubecloud bot commented Mar 25, 2026

Uh oh!

adriendupuis Apr 7, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants


		# TaxonomyNoEntries Criterion

		The [`TaxonomyNoEntries` Search Criterion](https://example.com/api/php_api/php_api_reference/classes/Ibexa-Contracts-Taxonomy-Search-Query-Criterion-TaxonomyNoEntries.html) searches for content that has no entries assigned from the specified [taxonomy](taxonomy.md).


		# TaxonomyNoEntries Criterion

		The [`TaxonomyNoEntries`](https://example.com/api/php_api/php_api_reference/classes/Ibexa-Contracts-Taxonomy-Search-Query-Criterion-TaxonomyNoEntries.html) Search Criterion searches for content that has no entries assigned from the specified [taxonomy](taxonomy.md).

	The [`TaxonomyNoEntries`](https://example.com/api/php_api/php_api_reference/classes/Ibexa-Contracts-Taxonomy-Search-Query-Criterion-TaxonomyNoEntries.html) Search Criterion searches for content that has no entries assigned from the specified [taxonomy](taxonomy.md).
	The [`TaxonomyNoEntries`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Taxonomy-Search-Query-Criterion-TaxonomyNoEntries.html) Search Criterion searches for content that has no entries assigned from the specified [taxonomy](taxonomy.md).

Conversation

mnocon commented Mar 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Mar 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Preview of modified files

Uh oh!

mnocon Mar 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

barw4 left a comment

Choose a reason for hiding this comment

Uh oh!

mnocon commented Mar 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

julitafalcondusza left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment was marked as resolved.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Mar 25, 2026

code_samples/ change report

Uh oh!

sonarqubecloud bot commented Mar 25, 2026

Quality Gate passed

Uh oh!

adriendupuis Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

mnocon commented Mar 11, 2026 •

edited

Loading

github-actions bot commented Mar 11, 2026 •

edited

Loading

mnocon Mar 11, 2026 •

edited

Loading

mnocon commented Mar 11, 2026 •

edited

Loading