wp_create_page: crear una página
Crea una página. Es idéntico a wp_create_post con el tipo de contenido fijado a page.
Argumentos
| Argumento | Valor por defecto | Significado |
|---|---|---|
title |
— | El título |
content |
— | El cuerpo |
excerpt |
— | El extracto |
slug |
— | El slug; se deriva del título cuando se omite |
status |
draft |
El estado de la página |
dry_run |
— | Informar sin crear |
Permisos
Allow content writes abierto, y la capacidad edit_pages — no edit_posts. Crear páginas exige un nivel más alto que crear entradas en los roles estándar de WordPress.
Ámbitos: mcp:read, mcp:write, wp:content:read, wp:content:write.
Mecánica
El valor por defecto de borrador, la ejecución en seco y la gestión de campos son como se describe en wp_create_post.
El resto de esta página trata sobre lo que hace diferente la creación de una página.
El contenido del maquetador debe componerse correctamente
Una página creada con texto plano se renderiza como texto plano. Una página del maquetador POM necesita una estructura de shortcode válida, lo que significa que las herramientas de creación primero:
pom_get_authoring_contextpom_get_available_shortcodespom_get_shortcode_schemapara cada uno usado- Componer
pom_validate_builder_content- Y después crear
La herramienta almacena el content que envíes sin validarlo, de modo que una página no validada se guarda sin problema y se renderiza incorrectamente. Consulta Crear contenido del maquetador POM.
Lo que no establece
Crear una página establece los campos anteriores y nada más:
- sin página madre, de modo que una página nueva es de nivel superior independientemente de dónde corresponda en la estructura;
- sin plantilla de página;
- sin entrada de menú — consulta Editar un menú de navegación;
- sin imagen destacada;
- sin campos de metadatos ni de SEO.
La página madre es lo que más sorprende. Una página pensada para estar bajo Servicios se crea en el nivel superior, con una URL de nivel superior, y moverla después cambia esa URL.
Lee de vuelta el slug derivado
Crea una página en borrador titulada «Servicios de mantenimiento» con este contenido: … Dame el ID y el slug que derivó.
El slug importa más en una página que en una entrada, porque se convierte en una URL pública de nivel superior en el momento en que la página se publica — y cambiarlo después rompe lo que ya enlaza a ella. Compruébalo mientras la página aún es un borrador y nada depende de ella.
Problemas comunes
| Síntoma | Causa |
|---|---|
| Se rechaza la escritura | La puerta de escritura de contenido está cerrada |
pom_ai_mcp_forbidden |
No hay capacidad edit_pages |
| La página está en el nivel superior | No se establece una página madre al crearla |
| La URL no es la que querías | El slug se derivó del título |
| Se renderiza como texto plano | El contenido del maquetador no se compuso ni validó |
| No está en el menú | Las entradas de menú son un paso aparte |