Configurar las URL de los tipos de contenido personalizados

POM Theme puede controlar las URL públicas de entradas individuales y de archivos de cada tipo de contenido personalizado desde Settings → Permalinks. Usa estos controles cuando una colección de contenido debería situarse bajo una página, heredar una jerarquía de taxonomía, usar un slug de archivo dedicado o exponer entradas sin una base de tipo de contenido.

Los sitios nuevos y existentes mantienen la estructura de slug personalizada actual hasta que se seleccione otro modo y se guarden los ajustes de enlaces permanentes.

Antes de cambiar una estructura de URL en producción

Confirma que el tipo de contenido personalizado tenga las características públicas necesarias en Settings → POM Theme → Content model:

• Publicly queryable expone las entradas individuales y sus controles de URL.
• Has archive expone el archivo general del tipo de contenido y sus controles de URL.
• Una taxonomía debe ser pública, jerárquica, estar conectada al tipo de contenido y usar URL jerárquicas antes de poder proporcionar una URL individual basada en taxonomía.
• Una página usada como base debe estar publicada. La portada estática y la página de entradas no se pueden seleccionar.

Haz un inventario de los enlaces en los menús, campañas y sistemas externos antes de cambiar una estructura establecida.

Configurar la URL de entrada individual

1. Abre Settings → Permalinks.
2. Busca Custom post type URLs y el tipo de contenido requerido.
3. Revisa Custom slug base. Esta es la base de tipo de contenido habitual y la ruta heredada que se conserva.
4. Elige un modo de Single entry URL:
   • Default (custom slug base) mantiene /custom-base/entry/.
   • No base utiliza /entry/ bajo la raíz del idioma actual.
   • Taxonomy-based utiliza el archivo de taxonomía seleccionado y la jerarquía de términos completa.
   • Page-based utiliza el enlace permanente completo de la Base page seleccionada.
5. Completa el selector de taxonomía o de página que se muestra para ese modo.
6. Guarda los ajustes de enlaces permanentes y abre una entrada representativa.

Por ejemplo, al seleccionar una página en /documentation/ se produce:

/documentation/install-the-theme/

POM Translate puede producir un equivalente localizado como /es/documentacion/instalar-el-tema/. Polylang utiliza la página base traducida asociada al idioma de la entrada y añade su directorio de idioma configurado.

Solo un tipo de contenido personalizado puede usar No base, porque dos tipos de contenido en la raíz del idioma serían ambiguos. Las páginas y las entradas normales conservan la prioridad en esa raíz.

Para conocer el comportamiento de selección específico de la taxonomía, consulta Situar las entradas individuales bajo los términos de taxonomía.

Configurar el archivo general del tipo de contenido

Para un tipo de contenido con soporte de archivo, elige un modo de Post type archive URL:

• Default (custom slug base) mantiene el archivo en la base personalizada.
• Custom archive slug añade un sufijo específico del archivo después de la base de slug personalizada.
• Page-based sitúa la base de slug personalizada bajo el enlace permanente de la Parent page seleccionada.

Para una base personalizada de /documentation/ y un slug de archivo de library, el archivo resultante es:

/documentation/library/

Para una página principal en /resources/ y una base personalizada de documentation, el archivo basado en página es:

/resources/
/resources/documentation/

La primera URL sigue siendo la página normal de WordPress. La segunda se resuelve en el archivo del tipo de contenido y utiliza su plantilla de archivo. Por lo tanto, las migas de pan enlazan la jerarquía de páginas antes de la etiqueta del archivo.

La misma página puede proporcionar la base de entrada individual y la página principal del archivo. En esa configuración, /resources/entry/ es una entrada individual, mientras que /resources/documentation/ es el archivo general. Una entrada cuyo slug coincida con la base del archivo recibe un sufijo numérico.

Entender la gestión de colisiones

POM Theme mantiene cada rama configurada sin ambigüedades:

• Una base personalizada o un slug de archivo personalizado modificados reciben un sufijo numérico al estilo de WordPress cuando una página existente, una base de taxonomía u otra ruta configurada lo posee.
• Una página y una entrada individual basada en página no pueden ocupar la misma ruta completa. La entrada posterior recibe un sufijo que comienza por -2.
• Una rama individual o de archivo respaldada por una página no puede ser idéntica a otra rama de CPT o de taxonomía respaldada por página configurada, ni estar por encima o por debajo de ella.
• Las entradas existentes se comprueban cuando se habilita un modo individual basado en página o sin base, y reciben sufijos numéricos solo donde existe una colisión de rutas.
• POM Translate también mantiene únicos los slugs de objetos localizados dentro de cada configuración regional.

La página seleccionada intencionadamente como archivo conserva su slug porque posee esa ruta de archivo.

Redirecciones, SEO y plugins de idioma

Las API de enlaces permanentes y de enlaces de archivo de WordPress devuelven la estructura canónica seleccionada. Los filtros canónicos de Rank Math y Yoast utilizan las mismas URL, incluida la paginación del archivo, y las integraciones de sitemaps reciben las URL a través de las API de enlaces estándar.

Las antiguas rutas individuales y de archivo del tipo de contenido personalizado permanecen disponibles como redirecciones permanentes a la nueva ubicación canónica. Los parámetros de consulta no relacionados se conservan. Los endpoints de feed, incrustación, paginación, página de comentarios y multipágina siguen usando sus significados habituales de WordPress.

POM Translate localiza la jerarquía de páginas, la base del archivo, el slug de la entrada y el prefijo de idioma. También genera enlaces canónicos y alternativos localizados a partir de la estructura seleccionada. Polylang utiliza las relaciones de páginas traducidas y su comportamiento configurado de directorio de idioma. Guarda Settings → Permalinks después de habilitar Polylang, cambiar su modo de URL o conectar traducciones de páginas.

Migas de pan

Para una entrada individual basada en página, las migas de pan de POM Theme enlazan cada página antecesora y la página base seleccionada antes de la entrada actual. Para un archivo basado en página, enlazan las páginas antecesoras y la página principal seleccionada antes de la etiqueta del archivo del tipo de contenido.

Las migas de pan de Rank Math y el esquema de migas de pan utilizan la misma jerarquía de páginas. Las entradas individuales basadas en taxonomía siguen usando sus antecesores de base de página, el rastro completo de términos y la entrada actual.

Verificar el resultado

Después de guardar:

1. Abre la página base individual seleccionada o la página principal del archivo.
2. Abre una entrada individual y el archivo general.
3. Confirma que las antiguas URL individuales y de archivo se redirigen permanentemente.
4. Comprueba la paginación del archivo y los feeds cuando el tipo de contenido los utilice.
5. Confirma la URL canónica, la entrada del sitemap y el rastro de migas de pan.
6. Repite las comprobaciones para cada idioma activo de POM Translate o Polylang.

Si una selección se restablece después de guardar, su página no está disponible o su rama se solapa con otra ruta configurada. Elige una rama de página distinta y guarda de nuevo. Si un nuevo slug contiene -2 o un número posterior, inspecciona las páginas, archivos, entradas y bases de taxonomía existentes en la misma ruta antes de renombrarlo.

Para restaurar la estructura anterior, selecciona el modo Default (custom slug base) aplicable y guarda Settings → Permalinks.