EmDash conserva conceptos de contenido que ya conoces, como entradas, páginas, taxonomías, menús, medios y revisiones. Astro aporta la capa del tema: rutas, layouts, componentes y renderizado en el servidor.
Lo que permanece familiar
Los editores siguen trabajando con tipos de contenido con nombre, campos estructurados, los estados de borrador y publicado, categorías jerárquicas, etiquetas planas, menús anidados, medios e historial de revisiones. Esos conceptos pasan a las colecciones de EmDash y a sus pantallas de gestión.
El flujo de desarrollo cambia. La selección de plantillas PHP se convierte en rutas explícitas de Astro, las partes de plantilla pasan a ser componentes importados y el código se despliega por separado del contenido de la base de datos. No necesitas React para construir el sitio público; los componentes .astro combinan TypeScript del lado del servidor con plantillas similares a HTML.
Mapa de conceptos
| WordPress | EmDash y Astro |
|---|---|
| Post Type | Colección EmDash |
| Post Meta | Campo de colección |
| Categoría o etiqueta | Taxonomía EmDash |
WP_Query | getEmDashCollection() |
get_post() | getEmDashEntry() |
the_content() | <PortableText /> |
| Jerarquía de plantillas | Archivos en src/pages/ |
| Parte de plantilla | Componente .astro importado |
header.php y footer.php | Layout de Astro |
wp_nav_menu() | getMenu() |
| Sidebar | Área de widgets y <WidgetArea /> |
| Options API | Configuración del sitio, o ctx.kv de un plugin |
| Plugin de WordPress | Plugin EmDash sandboxed o nativo |
Modelo de contenido
Crea y edita colecciones en Content Types dentro del administrador de EmDash. Una colección tiene campos tipados explícitos y puede activar borradores, revisiones, programación, búsqueda, SEO o comentarios.
Las consultas devuelven entradas de live collections de Astro. entry.id es el identificador de la ruta y normalmente es el slug; entry.data.id es el ID de contenido de la base de datos.
El siguiente archivo consulta las entradas en orden de publicación:
---
import { getEmDashCollection } from "emdash";
const { entries: posts, error } = await getEmDashCollection("posts", {
orderBy: { published_at: "desc" },
limit: 10,
});
if (error) return new Response("Could not load posts", { status: 500 });
---
{posts.map((post) => (
<article>
<h2><a href={`/posts/${post.id}`}>{post.data.title}</a></h2>
{post.data.excerpt && <p>{post.data.excerpt}</p>}
</article>
))}
Archivos del tema
Las rutas de Astro sustituyen la jerarquía de plantillas de WordPress. Una plantilla elige su propia estructura de URL en lugar de depender de nombres de archivo mágicos.
| Archivo WordPress | Archivo actual del blog-template |
|---|---|
front-page.php o home.php | src/pages/index.astro |
single.php | src/pages/posts/[slug].astro |
archive.php | src/pages/posts/index.astro |
page.php | src/pages/pages/[slug].astro |
category.php | src/pages/category/[slug].astro |
tag.php | src/pages/tag/[slug].astro |
search.php | src/pages/search.astro |
404.php | src/pages/404.astro |
header.php y footer.php | src/layouts/Base.astro |
Lee Astro para desarrolladores de WordPress para conocer la estructura del proyecto, la sintaxis de componentes, las props, los slots, los layouts, el enrutamiento y el flujo de consultas renderizadas en el servidor que usan las plantillas de EmDash.
Menús y áreas de widgets
Los menús y las áreas de widgets viven en la base de datos y siguen siendo editables después de la configuración. Las plantillas los consultan en el momento de la solicitud:
---
import { getMenu } from "emdash";
import { WidgetArea } from "emdash/ui";
const primary = await getMenu("primary");
---
<nav>
{primary?.items.map((item) => <a href={item.url}>{item.label}</a>)}
</nav>
<aside><WidgetArea name="sidebar" /></aside>
Configuración del sitio y taxonomías
La identidad del sitio al estilo del Customizer vive en los ajustes de EmDash. Obtén los ajustes una sola vez y usa la URL del logotipo ya resuelta cuando exista:
---
import { getSiteSettings } from "emdash";
const settings = await getSiteSettings();
---
<a href="/">
{settings.logo?.url
? <img src={settings.logo.url} alt={settings.logo.alt || settings.title} />
: settings.title}
</a>
Los términos de taxonomía son registros independientes, no valores almacenados directamente en entry.data. Resuelve un término y luego usa su slug en un filtro de colección:
import { getEmDashCollection, getTerm } from "emdash";
const news = await getTerm("category", "news", { includeCounts: false });
const { entries: posts } = news
? await getEmDashCollection("posts", { where: { category: news.slug } })
: { entries: [] };
Formatos de plugins
EmDash tiene dos formatos de plugins:
- Un plugin sandboxed usa
emdash-plugin.jsoncpara su identidad y su contrato de confianza, más un objetosrc/plugin.tsexportado por defecto y tipado conSandboxedPlugin. Puede ejecutarse en un runtime aislado y usar Block Kit para la UI de administración. - Un plugin nativo exporta una fábrica de descriptores en tiempo de compilación y una función
createPlugin()en tiempo de ejecución construida condefinePlugin(). Usa este formato para componentes React de administración, componentes Astro públicos o fragmentos de página.
Comienza con Elegir un formato de plugin. Los nombres de los hooks y las APIs de PluginContext son compartidos, pero las formas del paquete y de los manejadores no son intercambiables.
Importar contenido de WordPress
En la barra lateral del administrador, selecciona Import para abrir la página Import from WordPress, o visita directamente /_emdash/admin/import/wordpress. EmDash admite dos rutas de importación:
- Sube un archivo WordPress eXtended RSS (WXR) exportado desde Tools → Export.
- Instala el plugin EmDash Exporter en el sitio de WordPress y conéctate con una contraseña de aplicación de WordPress. Esta ruta puede incluir contenido que una API REST pública normal no expone.
Introducir una URL de WordPress sin el exportador puede detectar el sitio y contar las entradas, páginas y medios públicos. Ese sondeo REST no importa contenido.
El importador asigna el estado publish de WordPress al estado published de EmDash. Los estados borrador, pendiente, privado, programado, papelera y desconocido pasan a ser borradores. Una importación WXR incorpora una entrada protegida con contraseña como borrador, sea cual sea su estado en WordPress. Revisa los permisos importados y el estado de publicación antes de cambiar el DNS o retirar WordPress.
Sigue Migrar desde WordPress para el procedimiento completo y el comportamiento de reintento.
Flujo de trabajo editorial
El administrador de EmDash ofrece listas de colecciones, un editor de Portable Text, gestión de medios, edición de menús, gestión de taxonomías, revisiones y enlaces de vista previa. No es una copia visual de wp-admin: los bloques de Gutenberg se convierten en Portable Text, y las pantallas disponibles dependen de las colecciones y funciones configuradas para el sitio.