DEV Community: oskar calvo

Configurar Graphify para usarlo con Claude cli

oskar calvo — Wed, 26 Aug 2026 06:13:09 +0000

Instalación y uso de Graphify (Linux / WSL)

(Contenido creado con IA)

Guía paso a paso para instalar Graphify una vez en el
entorno (máquina/WSL) y luego activarlo en cada proyecto. Basada en la instalación real hecha en
drupal (ver sección 8 para las particularidades de ese proyecto).

Graphify convierte una carpeta de código/config/docs en un grafo de conocimiento consultable
(graph.json, graph.html, GRAPH_REPORT.md) y puede integrarse con Claude Code para que
consulte ese grafo antes de rastrear todo el código.

1. Qué es global y qué es por-proyecto

Elemento	Alcance	Cuándo se instala
`uv` (gestor de Python)	Global, una vez por máquina	Sección 2
`graphifyy` (el CLI `graphify`)	Global, una vez por máquina	Sección 2
API key del backend LLM	Global (variable de entorno / `.env`)	Sección 3
`graphify-out/` (graph.json, graph.html, GRAPH_REPORT.md)	Por proyecto — es el dato generado a partir de ESE código	Sección 5
`.claude/settings.json` (hook), `.claude/skills/graphify/`, sección en `CLAUDE.md`	Por proyecto	Sección 6

No hace falta reinstalar uv/graphify en cada repo. Lo único que se repite por proyecto es
generar su grafo y activar la integración con Claude Code.

2. Instalar Graphify en el entorno (una vez)

Requisitos: Python 3.10+ (ya viene en la mayoría de distros/WSL) y curl.

# 1. Instalar uv (gestiona su propio Python, no depende del venv del sistema)
curl -LsSf https://astral.sh/uv/install.sh | sh
source "$HOME/.local/bin/env"   # o reinicia la shell; añade ~/.local/bin al PATH

# 2. Instalar graphify como herramienta global
uv tool install graphifyy

# 3. Comprobar
graphify --version
graphify --help

Nota WSL/Debian/Ubuntu: si en algún momento usas python3 -m venv directamente y falla con
No module named ensurepip pidiendo apt install python3.X-venv (requiere sudo), no lo
instales para esto: usa uv, que no depende del módulo venv del sistema. Así es como lo
resolvimos en drupal.

2.1 Instalar el soporte del backend LLM que vayas a usar

El extractor semántico necesita un paquete de cliente extra según el backend. Instálalo con el
extra correspondiente (si no sabes cuál usarás, all los trae todos):

uv tool install "graphifyy[gemini]"     # Google Gemini
uv tool install "graphifyy[anthropic]"  # Claude
uv tool install "graphifyy[openai]"     # OpenAI
uv tool install "graphifyy[ollama]"     # modelo local, sin API key
# o directamente:
uv tool install "graphifyy[all]"

Si lo instalaste sin el extra y graphify extract falla con the 'openai'/'anthropic' package is required for this backend, reinstala con --force y el extra correcto:

uv tool install "graphifyy[gemini]" --force

(Esto nos pasó la primera vez: el backend gemini usa internamente el cliente openai, y no se
instala por defecto.)

3. Configurar la API key

Solo hace falta si vas a extraer contenido semántico (docs, config, PDFs, imágenes). El parsing de
código puro (--code-only) no requiere key.

Backend	Variable de entorno
Gemini	`GEMINI_API_KEY` o `GOOGLE_API_KEY`
Claude	`ANTHROPIC_API_KEY`
OpenAI	`OPENAI_API_KEY`
DeepSeek	`DEEPSEEK_API_KEY`
Kimi	`MOONSHOT_API_KEY`
Ollama (local)	ninguna
Bedrock	credenciales AWS/IAM

export GEMINI_API_KEY="tu-clave"

Cuidado con las comillas: si la clave está en un .env como GEMINI_API_KEY="AQ.xxx", un
cut -d'=' -f2- se lleva las comillas literales dentro del valor y Gemini responde
Please pass a valid API key. Al extraer el valor de un .env, quítalas explícitamente:
val="$(grep '^GEMINI_API_KEY=' .env | cut -d'=' -f2-)"
val="${val%\"}"; val="${val#\"}"
export GEMINI_API_KEY="$val"
Límites del tier gratuito: el tier gratuito de Gemini (gemini-3-flash) tiene límites bajos
(5 peticiones/min, 250k tokens/min). Si graphify extract falla con errores 429 RESOURCE_EXHAUSTED, repite con --max-concurrency 1 (más lento pero no satura la cuota). El
caché interno evita reprocesar lo que ya se extrajo con éxito.

4. Decidir el alcance del grafo en un proyecto

Dos formas de usarlo:

A) Graficar todo el repo (proyectos pequeños, sin vendor/, node_modules/, dumps de BD, etc.
mezclados con el código):

cd mi-proyecto
graphify extract .

B) Graficar solo unas rutas concretas (recomendado en proyectos con dependencias de terceros,
builds, backups SQL, sites/default/files, etc. que no aportan nada al grafo y disparan coste/
ruido). Se crea una copia física de solo esas rutas y se extrae sobre la copia:

cd mi-proyecto
mkdir -p graphify/source/<misma-estructura-de-carpetas>
cp -r ruta/a/incluir-1 graphify/source/ruta/a/incluir-1
cp -r ruta/a/incluir-2 graphify/source/ruta/a/incluir-2
# ... una copia por cada ruta a incluir, preservando la ruta relativa

Añade graphify/ a .gitignore para que esta copia y las herramientas no se comiteen:

echo '/graphify/' >> .gitignore

Esto es lo que se hizo en drupal: ver sección 8 para el ejemplo completo con
config/sync, módulos y temas custom/contrib concretos.

5. Generar el grafo

# Extracción completa (AST + semántica vía LLM)
graphify extract <ruta> --backend gemini

# Si el backend gratuito da 429, repetir más despacio:
graphify extract <ruta> --backend gemini --max-concurrency 1

# Generar/regenerar GRAPH_REPORT.md + graph.html con nombres de comunidad
graphify cluster-only <ruta> --backend gemini --max-concurrency 1 --batch-size 100

Flags útiles:

--no-gitignore: procesa también archivos que estén en .gitignore (útil si <ruta> es una copia aislada como en el método B, o si hay config versionada que normalmente se ignora).
--code-only: solo AST determinista, sin LLM, sin API key.
--force: fuerza re-extracción completa ignorando caché.

Resultado en <ruta>/graphify-out/:

graph.json — datos completos del grafo (nodos, edges, comunidades)
graph.html — visualización interactiva
GRAPH_REPORT.md — resumen en lenguaje natural + preguntas sugeridas

Es normal que algunos archivos de configuración muy simples (YAML triviales, toggles) no
generen nodo semántico propio — el modelo decide que no aportan nada nuevo más allá del AST. No
es un fallo; el resto del grafo (código, relaciones) sigue siendo válido.

6. Integrar con Claude Code en el proyecto

Si <ruta> del paso anterior es la raíz del proyecto, el grafo ya queda en
./graphify-out/graph.json, la ubicación por defecto que espera Graphify (hook, skill y comandos
sin --graph explícito).

Si usaste el método B (copia aislada, p. ej. graphify/source/), el grafo se genera por defecto
dentro de graphify/source/graphify-out/, no en la raíz. Muévelo una vez a la raíz (ubicación
que espera el resto de la integración):

mv graphify/source/graphify-out ./graphify-out

A partir de ahí, cualquier extract/update que vuelvas a lanzar sobre graphify/source debe
llevar la variable GRAPHIFY_OUT apuntando a esa ruta absoluta, o volverá a escribir dentro de
graphify/source/graphify-out (duplicando el grafo en vez de actualizar el de la raíz):

export GRAPHIFY_OUT="$(pwd)/graphify-out"
graphify update graphify/source        # o extract, con --backend

Una alternativa más simple si no te importa el symlink es dejar graphify-out como
ln -s graphify/source/graphify-out graphify-out: las lecturas (query, el hook, graph.html)
y las siguientes escrituras de extract/update graphify/source (que escriben en
graphify/source/graphify-out, el destino real del enlace) siguen funcionando igual sin tocar
GRAPHIFY_OUT. Mover el directorio de verdad a la raíz (como se hizo arriba) es preferible por
tenerlo en la ubicación canónica sin depender de un enlace, pero ambas opciones son válidas.

Instala la integración oficial (hook + skill + nota en CLAUDE.md), sin --strict:

graphify claude install --project

Esto crea/actualiza:

.claude/settings.json — hooks PreToolUse (advisory, nunca bloqueante sin --strict): avisan antes de un grep/Bash/Grep o de leer un archivo de código, sugiriendo graphify query primero.
.claude/skills/graphify/ — skill del comando /graphify.
CLAUDE.md — sección ## graphify con las reglas de cuándo consultar el grafo.

Revisa la sección añadida a CLAUDE.md: por defecto dice graphify update . para
refrescar el grafo tras cambios de código. Si usaste el método B (copia aislada), eso es
incorrecto — . es la raíz real del proyecto, no la copia, y lanzaría una extracción sin
acotar sobre todo el repo. Corrígelo a mano por graphify update graphify/source (o la ruta de
tu copia).

--strict es opcional y no se activó por defecto: bloquearía la primera lectura de código
por sesión hasta consultar el grafo. Con un grafo que no cubre todo el repo (método B), eso
puede bloquear tareas legítimas fuera del alcance graficado — se dejó desactivado.

7. Mantenimiento

Tras cambiar código dentro de las rutas graficadas: graphify update <ruta> (solo AST, sin coste de API). Si usaste copia aislada, primero hay que reflejar el cambio dentro de graphify/source/ (copiando el archivo modificado) y luego correr update sobre esa copia con GRAPHIFY_OUT apuntando al graphify-out/ real (ver sección 6):

  export GRAPHIFY_OUT="$(pwd)/graphify-out"
  graphify update graphify/source

Re-extracción semántica completa (por ejemplo tras añadir muchas rutas nuevas): graphify extract <ruta> --backend <backend> --force.
Desinstalar de un proyecto: graphify uninstall --project (quita hook, skill y sección de CLAUDE.md; con --purge borra también graphify-out/).

8. Limitaciones conocidas (comprobadas en la práctica)

Cobertura parcial: el grafo solo "sabe" de las rutas que se graficaron. Para cualquier otra parte del proyecto, hay que seguir buscando en el código directamente — decídselo explícitamente a Claude Code en CLAUDE.md si usas el método B.
El hook de lectura (Read/Glob) no se dispara para cualquier extensión: solo para un listado fijo de extensiones "genéricas" (.php, .js, .ts, .md, etc. — ver _HOOK_SOURCE_EXTS en el código de Graphify). En un proyecto Drupal, por ejemplo, no se dispara para .module, .install, .yml, .theme ni .twig, que es donde vive buena parte del código/config. El aviso de búsqueda (Bash|Grep) sí se dispara siempre que exista el grafo, independientemente de la extensión.
Coste y cuotas: la extracción semántica consume tokens del backend elegido. El tier gratuito de Gemini es fácil de agotar en proyectos con muchos archivos de config; usar --max-concurrency 1 lo evita a costa de tardar más.
El grafo es un punto de partida para orientarse, no la fuente de verdad — conviene verificar siempre en el código real antes de editar.

9. Ejemplo real: `drupal`

En este proyecto se usó el método B (copia aislada) porque el repo mezcla Drupal core, vendor/,
sites/default/files, dumps SQL, etc. junto al código propio. Solo interesaba graficar:

config/sync/**
web/modules/custom/*
web/modules/contrib/quiz
web/themes/custom/*
web/themes/contrib/bootstrap_barrio

Pasos aplicados (resumen; ver CLAUDE.md del proyecto para el resultado final):

# 0. Instalación global (una vez en la máquina/WSL)
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install "graphifyy[gemini]"     # ~/.local/bin ya estaba en el PATH

# 1. Copia aislada de solo las rutas a graficar
mkdir -p graphify/source/config graphify/source/web/modules/custom \
         graphify/source/web/modules/contrib graphify/source/web/themes/custom \
         graphify/source/web/themes/contrib
cp -r config/sync graphify/source/config/sync
cp -r web/modules/custom/. graphify/source/web/modules/custom/
cp -r web/modules/contrib/quiz graphify/source/web/modules/contrib/quiz
cp -r web/themes/custom/. graphify/source/web/themes/custom/
cp -r web/themes/contrib/bootstrap_barrio graphify/source/web/themes/contrib/bootstrap_barrio

# 2. Extracción (config/sync son YAML "contenido/conocimiento", no solo código -> --no-gitignore)
export GEMINI_API_KEY="..."
graphify extract graphify/source --backend gemini --no-gitignore --max-concurrency 1
graphify cluster-only graphify/source --backend gemini --max-concurrency 1 --batch-size 100

# 3. Mover el grafo a la raíz (ubicación canónica) e integrar con Claude Code
mv graphify/source/graphify-out ./graphify-out
graphify claude install --project
# (y corregir a mano el "graphify update ." -> ver sección 6/7, con GRAPHIFY_OUT, en CLAUDE.md)

Resultado final: ./graphify-out/graph.json (directorio real en la raíz, ~1600 nodos / ~2850
edges / ~296 comunidades), graphify instalado en global (~/.local/bin/graphify), copia
aislada del código en graphify/source/ (usada solo como entrada para futuras
extract/update), y el hook + la nota en CLAUDE.md activos para ese subconjunto de rutas.

Borrar registros de hook_update_N()

oskar calvo — Wed, 22 Jul 2026 12:39:33 +0000

A veces ocurre que estas desarrollando y lanzas varias veces un hook_update_N para depurar el código, con este código podemos resetear el hook_updat_N de un módulo al "numero" que necesitemos:

ddev drush php:eval "\Drupal::keyValue('system.schema')->set('module_name', 10001);"

En este caso ponemos el valor del registro de hook_update_N para el $modulo_name en 10001, por lo que el siguiente a ejecutar sería 10002.

Sincronizar bloques con Block placeholder

oskar calvo — Sun, 14 Jun 2026 11:46:53 +0000

Uno de las cosas que tenemos que entender cuando trabajamos con Drupal es que tenemos algunas entidades que funcionan a la vez como contenido y como entidad de configuración.

Drupal tiene un sistema de sincronización de configuraciones que es muy potente, y a su vez tiene módulos que extienden la sincronización de estas entidades con esa doble característica.

Existen varios de estos módulos, algunos de ellos los he probado en el pasado y reconozco que no se como están en 2025; vaya esto por delante.

Una de las cosas que vi en su día es que la sincronización funcionaba bien excepto cuando estas entidades llevaban asociadas files, en ese momento teníamos el problema de que la configuración generaba el yml pero el recurso multimedia que se había asociado no se sincronizaba por lo que o se subía a mano (no siempre se pueden subir a mano a según que servidores) o teníamos un problema.

El módulo block placeholder nos ayuda a solucionar en cierta manera esto,

¿Cómo lo hace Block Placeholder?

Genera un tipo de bloque que es únicamente configuración, no se le puede añadir campos, únicamente un nombre y definir que ese placeholder se pueda usar por uno o más bloques a la vez; esto sería que el placeholder pinta un único bloque o que pinte uno, dos, tres... bloques, y también definimos que tipos de bloque vamos a usar con ese placeholder.

Aquí un ejemplo del yml que genera el módulo de una entidad de configuración de block placeholder:

uuid: cf4113bd-c132-456a-aa59-b609009f81cd
langcode: en
status: true
dependencies: {  }
id: imagen_de_prueba_placeholder
label: 'Imagen de prueba placehodler'
reference_limit_type: unlimited
reference_limited_value: 1
block_types:
  imagen: imagen
sequence: null

Una vez tenemos creaco el placeholder, lo único que tenemos que hacer es crear el bloque en admin/content/block o editarlo si lo tenemos creado y en la sección de placeholder identificar el placeholder con el que queremos relacionarlo.

Los peros

Al principio suele ser tedioso andar creando en un entorno los bloques de tipo contenido, y luego tener que asociarlos a los placesholder, pero una vez que un bloque de contenido está creado se puede asociar al placeholder de forma manual o se puede usar un hook_post_update o hook_deploy para sincronizar la relación entre bloques de contenido y placeholder si fuera necesario.

En mi caso lo he empezado a usar en páginas que se construyen con la entidad views de drupal y el bloque va fuera de la vista, en una región superior, así que la configuración es añadir el placeholder y en el entorno de producción se configura la relación entre el placeholder y el bloque con el contenido.

Se puede usar también en bloques que no aparecen en admin/content/block pero en ese caso no veo tanta necesidad de hacerlo.

Usar h2non/imaginary con Ddev

oskar calvo — Sun, 14 Jun 2026 11:40:31 +0000

Se tiene que crear el archivo docker-compose.imaginary.yaml dentro de .ddev y añadir el siguiente contenido:

services:
  imaginary:
    image: h2non/imaginary:latest
    container_name: "ddev-${DDEV_PROJECT}-imaginary"
    labels:
      com.ddev.site-name: ${DDEV_SITENAME}
      com.ddev.approot: ${DDEV_APPROOT}
    expose: 
      - "9000"
    # ports:
    #   - "9000:9000" # Cambia el puerto si es necesario
    # volumes:
    #   - "imaginary-data:/data" # Opcional, si necesitas almacenar datos persistentes
    command: ["-enable-url-source"]
    restart: "no"
    environment:
      - VIRTUAL_HOST=$DDEV_HOSTNAME
      - HTTP_EXPOSE=7000:9000
      - HTTPS_EXPOSE=7001:9000

# volumes:
#   imaginary-data:

Y ya tenemos el proxy espuestos, lo siguiente es que cuando servimos una imagen lo tenemos que hacer apuntando al proxy y no a Drupal.

Añadir un enlace a un campo booleano

oskar calvo — Fri, 12 Jun 2026 06:42:10 +0000

Buenas, esto es algo que he tenido que sacar esta semana, algo que no esta resuelto en ningún módulo ni contribuido ni del core, no he hecho un módulo, únicamente un simple form_alter para resolverlo.

Contexto: se ha creado un tipo de contenido (nodo) llamado incidencia para que los usuarios anónimos puedan dar de alta incidencias, se ha creado un nodo y no un webform porque esas incidencias tendrán estados, comentarios de las personas que tienen que resolverlas y supervisarlas, etc.

Uno de los campos de este contenido es un cambo booleano tipo "Acepto condiciones y política de privacidad" y se quería añadir un enlace en la palabra "política de privacidad" para que llevase al nodo de política de privacidad.

aquí el código:

  /**
   * Privacy policy link.
   */
  #[Hook('form_alter')]
  public function privacy_policy_link(array &$form, FormStateInterface $form_state, $form_id): void {

    if ($form_id !== 'node_issue_form') {
      return;
    }


     // NOTE: Para una segunda iteración hacer un formulario para elegir cual es el nodo de politica de privacidad y desde el hook_form_alter llamarlo para no tener a fuego la ruta.

    $url = Url::fromUserInput('/politica-privacidad');
    $form['field_issue_privacy_policy']['widget']['value']['#title_display'] = 'after';
    $form['field_issue_privacy_policy']['widget']['value']['#title'] = t(
      'Acepto la <a href=":url" target="_blank">política de privacidad</a>',
      [':url' => $url->toString()]
    );
  }

Reseña de la Commit Conf 2026

oskar calvo — Sun, 07 Jun 2026 10:00:54 +0000

Este fin de semana ha sido la Commit Conf 2026.

Tengo que reconocer que me ha gustado, lo primero agradecer a la organización porque solo aquellos que han organizado eventos saben el trabajo que supone preparar algo así y que salga todo a la perfección; desde aquí mi más sincero reconocimiento y aplauso.

El segundo agradecimiento a los voluntarios, sin ellos esto no habría sido posible, que alguien pare durante dos días su día a día para ayudar en un evento como este no es algo que se vea todos los días en este mundo donde está todo cada vez más acelerado, loco y cambiante.

Para mi este año ha sido diferente, y no se si seré capaz de explicar lo que quiero decir o va a quedar todo mal o peor, pero vamos con al disertación.

Después de la pandemia y con la aparición de los modelos de IA débil las comunidades virtuales y también foros han ido desapareciendo, ya no necesitamos ir a un foro, chats, o portales para hacer preguntas; tenemos una caja de texto o una consola en la que planteamos lo que queremos hacer se resuelve (mejor o peor, pero se resuelve), es por eso que este año me fijé más en los Open Space que había y decidí a cuál podría ir. De las charlas, van a estar todas grabadas, incluso si no es posible encontrar al ponente para plantearle dudas después de ver la charla también se puede plantear la duda a un modelo de IA débil para leer su respuesta.

No quiero decir con esto que las charlas (yo dí una charla) no sean necesarias, sean cosa del pasado y a otra cosa mariposa; lo que quiero hacer entender que en este mundo donde vivimos ahora mismo que nos suele separar del resto del mundo una interface el track de Espacio Abierto tiene un valor añadido por el contacto humano con otras personas que también asisten y no es tanto una relación "Maestro - Alumno" como podría ser una charla, es verdad que las sesiones de los Espacios Abiertos van guiadas por las personas que los proponen pero esas personas no están subidas a una tarima como si ocurre en las conferencias.

No se si he conseguido expresar correctamente o me fan a "funar" por esto.

El viernes el primer Espacio Abierto al que asistí fue el que organizaron: Maria Isabel Martin and Osmani Redondo con el título "Buscar trabajo en tiempos de crisis (y de IA)". Tengo que aplaudir porque fue una dinámica muy entretenida, se buscaba que todo el mundo participase y estaba muy bien organizado, con los tiempos controlados, se paraba a debatir los conceptos que se consideraban interesantes pero sin llegar a estancarnos.

El siguiente Espacio Abierto al que asistí fue el organizado por Daniel Rey Rey "De meetups a movimiento: construir comunidades técnicas que crecen", y en esta dinámica se volvió a tocar el tema que se lleva años tocando sobre que está ocurriendo con las comunidades de antes de la pandemia, si es posible re-impulsar/recuperar comunidades o si las comunidades que había hasta 2019 ya es cosa del pasado y tenemos que asumir que "el mundo ha cambiado".

El sábado la dinámica de Ana G Amor "Encajar, fingir o callar: cómo sobrevivimos (y qué nos cuesta). Masking y síndrome del impostor en entornos Tech" que quizás fue la que más me gustó; en esta sesión los asistentes nos pudimos sincerar con nuestros miedos, y pudimos descubrir que no somos los únicos que a veces pensamos cosas raras.

Luego pude asistir a media dinámica de Jorge Castaño ¿Qué implica ser Sénior?, la parte en la que estuve de la dinámica también muy bien organizada, con preguntas que iban al debate interesante y enriquecedor.

Y conseguí llegar a la segunda parte de de la dinámica Tech Communities, como siempre un placer debatir con otras comunidades de lo que nos duele y nos preocupa y quizás de esta Espacio Abierto es la frase que dijo una de las personas que participaban "si una comunidad tiene que morir que muera".

Además de las dinámicas de los Espacios Abiertos estuve en algunas charlas y conversando con la gente de la comunidad de SysAdmin de Galicia que hicieron acto de presencia.

De todo lo que he hablado con muchas personas en esta sesión de la Commit Conf es que todos estamos con dudas, con miedos, con incertidumbre en nuestras vidas, algunos he vivido más años otros menos pero las dudas, miedos, e incertidumbres pare que nos acompañan a todos en esta época tan líquida donde tenemos que vivir y creo que para mi esta Commit Conf 2026 es poder encontrar una pequeña isla en un mundo oceánico.

Añadir aljibe a un proyecto que ya tiene Ddev

oskar calvo — Tue, 14 Apr 2026 11:56:31 +0000

Ddev-aljibe es un plugin creado por la empresa Metadrop para añadir en una única instalación todas las dependencias necesarias para escribir y ejecutar test como la ejecutar herramientas de análisis de código estático de PHP que se pueden usar en proyectos de Drupal que se ejecutan mediante Ddev.

Vamos con los pasos para instalar e implementar Aljibe y comentar que cosas me he encontrado.

Tengo que avisar que previamente en mi proyecto en Ddev ya había instalado y configurado GrumPHP junto a PHPCS, PHPStan y PHPMD.

El primer paso para instalar ddev-aljibe es añadir el plugin ddev add-on get metadrop/ddev-aljibe, una vez añadido el plugin reiniciamos ddev restart y ejecutamos ddev aljibe-assistant, el asistente pasará a realizarnos una serie de preguntas para realizar la instalación.

Una cosa que tuve que hacer a mitad del proceso y que se puede hacer previamente es actualizar el proyecto ddev composer update.

Al ejecutar el asistente este irá haciendo una serie de preguntas, las respuesta que yo di para que no me sobrescribiera el proyecto son las siguientes:

Please enter the project name (default XXXX):

En esta opción simplemente pulsar intro.

By default, Drupal 11 will be installed. Do you wnat to install Drupal 10 instead? [y/N]

En esta opción indicamos 10 u 11, en mi caso era un proyecto en Drupal 11 así que marqué N

Do you want to initialize a git repository for your new project? [Y/n]

En mi caso como ya tenía un proyecto de git montado señalé n.

Do you want to install Drupal? [Y/n]

Como el proyecto ya tenía Drupal instalado le dije que no.

A continuación pasó a instalar todo.

Un problema que sufrí es que en la instalación me movió el paquete vlucas/phpdotenv de requirement a requirement-dev en el archivo composer.json, no tengo claro si esto es porque yo tenía alguna configuración rara o es así como lo hace, pero lo volví a mover a requirement y todo volvió a funcionar.

Al ejecutar ddev behat me daba los siguientes errores.

PHP Fatal error: Declaration of NuvoleWeb\Drupal\DrupalExtension\ServiceContainer\DrupalExtension::configure(Symfony\Component\Config\Definition\Builder\ArrayNodeDefinition $builder) must be compatible with Drupal\DrupalExtension\ServiceContainer\DrupalExtension::configure(Symfony\Component\Config\Definition\Builder\ArrayNodeDefinition $builder): void in /var/www/html/vendor/nuvoleweb/drupal-behat/src/DrupalExtension/ServiceContainer/DrupalExtension.php on line 55

Fatal error: Declaration of NuvoleWeb\Drupal\DrupalExtension\ServiceContainer\DrupalExtension::configure(Symfony\Component\Config\Definition\Builder\ArrayNodeDefinition $builder) must be compatible with Drupal\DrupalExtension\ServiceContainer\DrupalExtension::configure(Symfony\Component\Config\Definition\Builder\ArrayNodeDefinition $builder): void in /var/www/html/vendor/nuvoleweb/drupal-behat/src/DrupalExtension/ServiceContainer/DrupalExtension.php on line 55
Failed to run behat : exit status 255

El parche para solucionarlo:

--- a/src/DrupalExtension/ServiceContainer/DrupalExtension.php
+++ b/src/DrupalExtension/ServiceContainer/DrupalExtension.php
@@ -16,7 +16,7 @@ class DrupalExtension extends BaseDrupalExtension {
   /**
    * {@inheritdoc}
    */
-  public function load(ContainerBuilder $container, array $config) {
+  public function load(ContainerBuilder $container, array $config): void {
     parent::load($container, $config);

     // Load default service definitions.
@@ -52,7 +52,7 @@ class DrupalExtension extends BaseDrupalExtension {
   /**
    * {@inheritdoc}
    */
-  public function configure(ArrayNodeDefinition $builder) {
+  public function configure(ArrayNodeDefinition $builder): void {
     parent::configure($builder);

     $builder->append(

También encontré que se modificaron los archivos .gitignore, settings.php, grumphp.yml; no tengo claro si la modificación de .gitignore y settings.php es por la actualización a la ultima versión del core de Drupal o por la instalación del plugin, en el caso del archivo grumphp.yml si que es cosa de Aljibe, mi solución fue revisar lo que había cambiado, lo que me gustaba mantenerlo, lo que no me gustaba quitarlo y recuperar lo que yo tenía.

Por ejemplo yo sigo Conventional Commits mientras que Metadrop propone commits que empiezan por "Issue #$number: ....". También revisé las configuraciones de PHPStan, PHPmd para ver si lo que había añadido en las configuraciones es lo mismo que yo tenía añadido.

Añadir un capo de tipo hora y minutos en un formulario

oskar calvo — Wed, 01 Apr 2026 11:09:36 +0000

Una de las cosas que más me gusta es el FORM API de Drupal.

Hoy vamos a ver como añadir un campo para recoger únicamente horas y minutos,

La forma de hacerlo es, a partir de la versión 11.30 de Drupal la siguiente.

    $form['datetime_time_only'] = [
      '#type' => 'datetime',
      '#date_date_element' => 'none',
      '#date_time_element' => 'time',
      '#date_time_format' => 'H:i',
    ];

Si estamos trabajando en versiones anteriores a la 11.30 la forma que he encontrado de hacerlo es con el módulo duration_field el cual define un Element para que podamos añadir a nuestros formularios un campo de tipo time

 // Usage example:
 // @code
 $form['duration'] = [
   '#type' => 'duration',
   '#title' => $this->t('Duration),
   // Only 15 minute increments.
   '#date_increment' => 900,
   // Hide seconds.
   '#granularity' => 'y:m:d:h:i',
   // Require hours and minutes.
   '#required_elements' => 'h:i',
 ];

Comento esto porque algunos modelos LLM no saben las diferentes opciones que existen y sugieren paparruchas.

Drupal Canvas, creación de páginas I

oskar calvo — Wed, 24 Dec 2025 13:17:49 +0000

Vamos con la creación de una página, para ello simplemente le damos a crear una página en el botón + Add Page que nos llevará a una página como esta:

Importante, en mi caso he añadido dos idiomas a la web, con la ruta https://drupalcms.ddev.site/en/canvas/editor/canvas_page/12 y https://drupalcms.ddev.site/es/canvas/editor/canvas_page/12 no me funciona Canvas (tengo que investigar esto), pero con la ruta https://drupalcms.ddev.site/canvas/editor/canvas_page/12 vemos la página lista para crear contenido.

Esta página recuerda en su estructura a la de Gutenberg de Wordpress

Lateral izquierdo

En el lateral izquierdo tenemos el menú principal, con los siguientes elementos en orden:

Library
Layers
Code
Pages
Templates

Library

Esta opción del menú nos pinta todos los componentes que tenemos habilitados* en nuestro portal web y también nos permite elegir entre patrones si tenemos creado alguno.

Layers

Esta opción nos permite definir con que capa de la página queremos trabajar, en e caso de Byte existen tres capas, Contenido, cabecera, y pie.

También muestra los diferentes componentes que se están usando en cada capa en una estructura jerárquica, y en permite mover algunos componentes arriba y abajo.

Code

Esta opción nos permite añadir componentes mediante código, a esto e dedicaremos una entrada en exclusiva de esta serie.

Pages

Esta opción nos muestra el listado de todas las páginas que existen, recordemos, páginas de Canvas.

Templates

Esta opción nos permite usar Canvas para personalizar los view mode que tenemos definidos de tipos de nodos.

En caso de que se quiera usar un view mode concreto tenemos que ver si está activado en el nodo para poder usarlo.

NOTA: Lo que he visto por ahora con los nodos es que si añadimos un componente a un tipo de nodo (por ejemplo de blog) en Canvas afecta a todos los nodos, no he visto una forma para que un componente se aplique a un único nodo, estoy preguntando y mirando esto, porque si esto no se puede realizar sería algo a tener en cuenta si queremos elegir entre Layout Builder y Canvas.

Lateral derecho

En el lateral derecho vemos las opciones de configuración del componente que se está trabando. Cuando se entra a la página lo que se muestra son los valores básicos de la página: título, URL, SEO Settings, Media, Page Title (meta-atributos), Meta Description.

Drupal Canvas, Adminstración de contenido

oskar calvo — Wed, 24 Dec 2025 12:08:50 +0000

Este artículo los escribo con una instalación de DrupalCMS beta 2.x y template de instalación "Byte".

Cuando hemos arrancado lo primero que he visto es que las páginas de canvas son independientes de la sección de contenido que solemos ver en Drupal.

Pages nos pinta el listado de "paginas" (no confundir con "basic pages") de Canvas, y el enlace CMS nos pinta la administración clasica de /admin/content de Drupal.

Drupal CMS

Como se puede ver en las imágenes la administración (publicar/despublicar/borrar) para las páginas de Canvas es parecida, las operaciones que podemos hacer son borrar/ver/editar, y crear una página nueva además de buscar por el título de la página y filtrar por publicadas/despublicadas.

Drupal Canvas, introducción

oskar calvo — Wed, 24 Dec 2025 11:57:09 +0000

Canvas es un módulo añadido a Drupal que permite la construcción de páginas webs simplemente agarrando y soltando elementos y luego personalizando dichos elementos.

Uno de los puntos importantes respecto a otros módulos de Drupal que permitían construir páginas es que esta vez Canvas no viene de desarrolladores de backend dando funcionalidades a creadores de contenido/diseñadores, sino que ha sido un trabajo de análisis de que había en el mercado, ver como funcionaba, coger lo mejor de todo aquello que se ha analizado, hablar con diseñadores y creadores de contenido y luego sacar las funcionalidades que se quieren implementar, vamos que se ha pensando más como un producto con los diseñadores y creadores de contenido como público objetivo.

Que nadie me mal interprete, no digo que Layout Builder, Paragraphs, Panels, etc... no fueran buenos productos, pero mi opinión personal es que en la comunidad de Drupal durante muchos años hemos pensado en sacar módulos/productos pensados para desarrolladores backend/hardcoder y no tanto herramientas sencillas de usar para diseñadores o creadores de contenidos, y esto es precisamente lo que hizo que Wordpress triunfase donde no lo hizo Drupal, ellos sacaron un producto pensado para diseñadores o personas sin conocimientos y sin ganas de leerse un libro enorme.

Con Canvas Drupal rompe esa dinámica y tenemos una herramienta pensada para ese tipo de usuarios.

Añadir programáticamente un campo de tipo cshs a un formulario.

oskar calvo — Tue, 11 Nov 2025 11:20:42 +0000

El módulo Client-side Hierarchical Select de Drupal permite elegir un elemento de un select cuando tenemos una jerarquía en árbol con múltiples valores.

(Fuente de la foto: https://www.drupal.org/project/cshs)

Añadir este widget a las entidades de contenido es sencillo, simplemente en la pestaña de "Administrar la visualización del formulario" podemos elegir que widget queremos usar y si tenemos activado el módulo Cshs lo veremos para los campos de taxonomías.

El problema es que los formularios creados a medida para añadir funcionalidades, o los formularios de entidades de configuración no tienen la opción de "Administrar la visualización del formulario".

En este caso muestro como usando el módulo Hux añado un hook_form_alter para añadir un campo adicional a la entidad que trae el módulo simplenews para poder categorizar los tipos de boletines que se crean usando un vocabulario ya definido en el proyecto.


  /**
   * Implement hook_form_alter().
   */
  #[Alter('form')]
  public function addThematicFieldToNewsletters(&$form, \Drupal\Core\Form\FormStateInterface $form_state, $form_id) : void {

        if (in_array($form_id, ['simplenews_newsletter_edit_form', 'simplenews_newsletter_add_form'], TRUE)) {
          $form['container_thematics'] = [
            '#type' => 'fieldset',
            '#title' => $this->t('Thematics'),
          ];

          $form['container_thematics']['thematics'] = [
            '#type' => 'cshs',
            '#title' => $this->t('Select the thematic'),
            '#options' => $this->buildCshsOptions('thematics'),
            '#weight' => 100,
                /** @var \Drupal\simplenews\Entity\Newsletter $newsletter */
            '#default_value' => $form_state->getFormObject()->getEntity()->getThirdPartySetting('gobcan_newsletters', 'thematics', NULL),

          ];

            // Añadir entity builder para procesar los third party settings
            $form['#entity_builders'][] = [$this, 'buildThematicsEntity'];
        }

  }

Para definir correctamente el widget de formulario de Cshs tenemos que definir el campo del formulario como ´'#type' => 'cshs',´ , además el array de ´#Options´ no sirve un array de tipo clave valor, sino que tiene que tener una estructura concreta para que Cshs pueda procesarlo, por eso se ha creado el método ´buildCshsOptions()´.


    /**
     * Entity builder para las temáticas.
     */
    public function buildThematicsEntity($entity_type, \Drupal\simplenews\Entity\Newsletter $newsletter, &$form, \Drupal\Core\Form\FormStateInterface $form_state) : void {
      $thematics_value = $form_state->getValue('thematics');
      $newsletter->setThirdPartySetting($module_name, 'thematics', $thematics_value);
    }

Esta funciión es la función necesaria para guardar los valores en la entidad como configuraciones de terceros.

  private function buildCshsOptions(string $vocabulary): array {

    $term_options = [];
    $terms = $this->entityTypeManager
      ->getStorage('taxonomy_term')
      ->loadTree($vocabulary,0,NULL,TRUE);

    foreach ($terms as $term) {
      $termId = $term->id();
      if($term->parent->target_id) {
        $term_options[$termId] = new CshsOption($term->getName(),$term->parent->target_id);
      } else {
        $term_options[$termId] = new CshsOption($term->getName());
      }
    }

        return $term_options;
  }

En este método construimos la estructura del array que necesita Cshs para poder construir el widget correcto, usamos la clase CshsOption que trae el módulo para hacerlo.

El código es de David Mudie (dmudie) lo saqué de esta Issue en Drupal.org

DEV Community: oskar calvo

Configurar Graphify para usarlo con Claude cli

Instalación y uso de Graphify (Linux / WSL)

1. Qué es global y qué es por-proyecto

2. Instalar Graphify en el entorno (una vez)

2.1 Instalar el soporte del backend LLM que vayas a usar

3. Configurar la API key

4. Decidir el alcance del grafo en un proyecto

5. Generar el grafo

6. Integrar con Claude Code en el proyecto

7. Mantenimiento

8. Limitaciones conocidas (comprobadas en la práctica)

9. Ejemplo real: drupal

Borrar registros de hook_update_N()

Sincronizar bloques con Block placeholder

¿Cómo lo hace Block Placeholder?

Los peros

Usar h2non/imaginary con Ddev

Añadir un enlace a un campo booleano

Reseña de la Commit Conf 2026

Añadir aljibe a un proyecto que ya tiene Ddev

Añadir un capo de tipo hora y minutos en un formulario

Drupal Canvas, creación de páginas I

Lateral izquierdo

Library

Layers

Code

Pages

Templates

Lateral derecho

Drupal Canvas, Adminstración de contenido

Pages

Drupal CMS

Drupal Canvas, introducción

Añadir programáticamente un campo de tipo cshs a un formulario.

(Fuente de la foto: https://www.drupal.org/project/cshs)

9. Ejemplo real: `drupal`