Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Document how conditions treat empty and null values

Abierto
  • ¿Algo no está bien?
#2,000 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

@joshdaugherty ya está trabajando en esto.

Desde el 30/9/2026.

  • #2001 de @joshdaugherty — abierto

Evaluación

Dificultad
1/5
Tiempo estimado
Menos de una hora
Aptitud para principiantes
25/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
php
Área
documentation

Línea de trabajo

The change belongs on the conditions page of the docs, under the 'Using a variable reference' section. To confirm the behaviour, read Statamic\Tags\Concerns\QueriesConditions::queryableConditionParams() in statamic/cms, which skips parameters whose value is an empty string but passes null through. Done means the note is in the docs, but PR #2001 is already open with this wording, so check that PR before writing anything new.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

The conditions page doesn't say what a condition does when its value is empty or null. Two different things happen, depending on how the value is passed. Both are easy to hit when the value comes from something that can be blank, such as a query-string value, an optional field or an empty picker.

Measured on statamic/cms v6.26.0, with the collection tag on a collection of 75 published entries:

Template Value the tag receives Result
type:is="", or type:is="{{ get:type }}" when type is absent from the query string '' The condition is skipped: all 75 entries are returned
:type:is="some_var" when some_var is null or not set null Filters to entries where type is null, so only entries without that field are returned
:type:is="some_var" when some_var is '' '' The condition is skipped, as in the first row

The skip comes from Statamic\Tags\Concerns\QueriesConditions::queryableConditionParams(), which rejects any parameter whose value is ''. A null is not rejected, so it reaches $query->where($field, null).

Both behaviors seem reasonable. What's missing is a note saying so, because the two forms look interchangeable and do opposite things when the value is blank. The first lists everything; the second can list nothing, for example on blueprint, which every entry has.

Suggested wording, under Using a variable reference:

If a condition's value is an empty string, the condition is skipped and the results are not filtered by it. If a variable reference (:field:is="variable") resolves to null, the condition filters for entries where that field is empty.

Docs PR with that wording: #2001.

Lenguaje dominante
PHP
Estrellas
133
Forks
405
Merge medio
21 h 45 min
PR fusionados (30 d)
12

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de statamic/docs

Todos los issues de statamic/docs

Issues similares

Más issues de PHP

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.