Formato nuevo
Mostrar propiedades de infoblock en 1C-Bitrix
Las propiedades de infoblock (SKU, archivo, lista, enlace a elemento) viven en el admin; en el sitio las muestras en la plantilla del componente — casi siempre en el `template.php` del result.
Abajo: cómo funcionan el array `$arResult` y las claves de display. La sintaxis exacta y la API dependen de la versión de Bitrix y del tipo de componente — mira docs oficiales y no copies snippets de 2017 sin probarlos en tu proyecto. Hace falta PHP y HTML básicos.
Cómo funciona la salida
El componente de infoblock arma el elemento en `$arResult`. Las propiedades para display suelen vivir en `$arResult['DISPLAY_PROPERTIES']['PROPERTY_CODE']`. Una entrada tiene nombre y `DISPLAY_VALUE` (un valor preparado o un array de valores).
El código de propiedad (llamado `ATTRIBUTE` en notas viejas) se fija en el admin del infoblock. En la plantilla usa tu código — no el de otro en un ejemplo.
Antes de editar la plantilla:
- propiedad creada y rellena en el elemento
- display activado para list/detail si el componente lo exige
- trabajas en una copia de plantilla del componente
- limpia caché tras las ediciones
Tipos de propiedad — salida distinta
String y number a menudo se imprimen como un solo `DISPLAY_VALUE`. Una lista puede ser simple o múltiple — entonces el valor es un array que recorres. Un archivo es un enlace de descarga/vista. Los enlaces a elementos necesitan fetches extra de campos del elemento relacionado.
No mezcles `PROPERTIES` crudo y `DISPLAY_PROPERTIES` sin entender: el primero está más cerca de los datos de BD, el segundo del display listo.
Tipo → qué mirar
| Tipo de propiedad | En la práctica |
|---|---|
| String / number | Un valor en DISPLAY_VALUE |
| List | Un valor o un array |
| File | Enlace / ruta al archivo |
| Element link | IDs/datos de elementos relacionados |
| HTML/text | Escapado y tags permitidos |
Práctica en la plantilla
Marco típico: comprueba que la clave de propiedad exista en `DISPLAY_PROPERTIES`, imprime el nombre si hace falta, luego el valor. Para múltiples — `foreach`. Para un archivo — arma un enlace desde los datos de la propiedad.
Contadores de comentarios y vistas son campos/módulos aparte, no siempre una «propiedad de infoblock». Conéctalos solo si el proyecto usa de verdad esos mecanismos.
Checklist de debug «no se muestra»:
- el código de propiedad coincide con el admin
- el elemento está relleno
- el template.php correcto del componente en la página
- caché limpia
- el modo edición/debug muestra el área correcta
Qué evitar
No edites archivos en `bitrix/modules` y no pegues muros largos de código de foros de 2015–2017 sin entender la versión. Tras una actualización del core esas ediciones se rompen.
No vuelques 200 líneas de lógica de negocio en la plantilla — muévelas a result_modifier.php o a una capa de servicio si el proyecto lo permite.
Enlace con contenido y SEO
Las propiedades son útiles para specs de producto, archivos de lista de precios, badges. Para SEO importa más que los campos necesarios lleguen al HTML visible y a las plantillas meta — ver el artículo SEO de Bitrix.
Un «escaparate» de propiedades vacías en la ficha es peor para los usuarios que un set cuidadoso de atributos rellenos.
Qué llevarte
Salida de propiedades = plantilla del componente + código de propiedad + tipo de valor. `DISPLAY_PROPERTIES` es la brújula principal de display.
Revisa la API actual de Bitrix; la barra pública edita contenido pero no sustituye el trabajo de plantilla.
FAQ
¿Dónde se edita la salida de propiedades?
Suele ser en la plantilla del componente necesario (a menudo `template.php` bajo `bitrix/templates/...` o la plantilla del sitio). Prefiere una copia de plantilla del componente, no ediciones al core.
¿Qué es DISPLAY_PROPERTIES?
Un array de propiedades del elemento preparadas para display: nombre, valor(es), tipo. Útil para salida en ficha/lista.
¿Por qué la propiedad está vacía en el sitio?
No marcada para detail/list, código de propiedad incorrecto, caché, plantilla de componente equivocada, o la propiedad no está rellena en el elemento.
¿En qué se diferencia de la barra de sección pública?
La barra edita contenido visualmente. Esta pieza cubre la plantilla y el código de salida de propiedades por un desarrollador.
¿Se pueden mostrar propiedades sin PHP?
Algunas propiedades se muestran vía parámetros integrados del componente. Los formatos complejos siguen necesitando plantilla o código custom.
¿Pegando un snippet de propiedades Bitrix de 2017 — y la ficha sigue mostrando campos vacíos?
Cableamos DISPLAY_PROPERTIES en una copia de plantilla, alineamos código y tipo de propiedad, y limpiamos caché para que las specs se rendericen de verdad.
Hablar del proyecto
