WordPress
WordPress conecta tu flujo con tu web WordPress, tanto si está alojada en WordPress.com como en tu propio servidor. Con un mismo componente puedes consultar, publicar, modificar y borrar entradas y páginas, y consultar, crear y actualizar usuarios.
Eliges qué hacer con dos campos: Operation (la acción) y Entity (sobre qué). El componente muestra solo los campos que necesita esa combinación.
Cuándo usarlo
- Publicar en el blog de la empresa los artículos que redacta un agente.
- Guardar como borrador una entrada para que el equipo la revise antes de publicarla.
- Revisar las últimas entradas publicadas para preparar un boletín.
- Dar de alta como usuarios de la web a los colaboradores nuevos.
- Actualizar el contenido de una página, como la de horarios o la de precios.
Configuración
El componente necesita una credencial WordPress API. En ella eliges el tipo de alojamiento e indicas la dirección de la web y los datos de acceso. Ver Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial de tu web WordPress. |
| Operation | La acción: Get (consultar), Create (crear), Update (actualizar) o Delete (borrar). Por defecto, Get. |
| Entity | Sobre qué se actúa: Post (entrada), Page (página) o User (usuario). En webs de WordPress.com, al consultar aparece también Site (sitio). Por defecto, Post. |
| Site ID | Solo en webs de WordPress.com: el identificador del sitio con el que trabajas. Puedes obtenerlo consultando la entidad Site. |
| Entity ID | El identificador de la entrada, la página o el usuario. No aparece al crear. Es obligatorio para actualizar y borrar. |
Qué puedes hacer con cada entidad
| Entidad | Get | Create | Update | Delete |
|---|---|---|---|---|
| Post | Sí | Sí | Sí | Sí |
| Page | Sí | Sí | Sí | Sí |
| User | Sí | Sí | Sí | Sí (webs en tu propio servidor) |
| Site (solo WordPress.com) | Sí | No | No | No |
Consultar (Get)
| Campo | Qué hace |
|---|---|
| Entity ID | Si lo rellenas, se consulta solo ese elemento. Si lo dejas vacío, se devuelve una lista. |
| Search | Opcional. Un texto para filtrar la lista: solo aparecen los elementos que lo contienen. |
| Limit | Opción avanzada. Cuántos elementos devuelve la lista como máximo. Por defecto, 10. |
| Order By | Opción avanzada. El campo por el que se ordena la lista. Con un guion delante se ordena de mayor a menor, por ejemplo -date (las más recientes primero), que es el valor por defecto. Sin guion, una web en tu propio servidor usa su orden habitual y WordPress.com ordena de menor a mayor. |
| Get Status | Opción avanzada, para entradas y páginas. Qué estado deben tener: publish (publicadas), draft (borradores), pending (pendientes de revisión), future (programadas) o private (privadas). Por defecto, publish. |
Crear o actualizar una entrada o una página
| Campo | Qué hace |
|---|---|
| Title | El título. Obligatorio al crear. |
| Add Others Caracteristics | Opción avanzada. Actívala para rellenar más datos. |
| Other Caracteristics | Qué datos adicionales quieres rellenar. Cada uno muestra su propio campo: Author (autor, a elegir entre los de la web), Parent (página o entrada superior), Content (contenido), Slug (la parte final de la dirección), Password (contraseña para protegerla), Status (estado: publicada, borrador, pendiente, programada o privada), Comment Status y Ping Status (si admite comentarios y avisos de otras webs), Menu Order (posición en los menús) y Featured Media (imagen destacada, con el campo Featured Image ID). |
El título y el contenido admiten texto con formato web.
Al actualizar, solo cambia lo que rellenas: un Title vacío, o un detalle que no seleccionas, conserva su valor actual.
Crear o actualizar un usuario
Email (obligatorio al crear), Username, Name of user, First name, Last name, Role (administrator, editor, author, contributor o subscriber) y Password.
En webs de WordPress.com, crear un usuario envía una invitación a ese correo con el rol de autor.
Al actualizar un usuario, solo cambian los campos que rellenas; no hace falta el correo para cambiar el rol o los nombres.
Para borrar un usuario, WordPress exige indicar a qué otro usuario pasan sus entradas y páginas; si no, las borraría con él. El componente no borra ningún usuario sin ese dato: devuelve un error que lo explica.
Resultado
La salida Result entrega lo que devuelve WordPress: los elementos consultados, o el elemento creado o actualizado con sus datos. Al borrar, entrega un mensaje de confirmación. Si el elemento pedido no existe, no devuelve nada.
Conéctala a un agente, a Parse Data o a otro componente. El componente también puede usarse como herramienta de un agente.
Ejemplo
Una inmobiliaria publica cada semana un artículo sobre el mercado de su zona:
- Un agente redacta el artículo a partir de las noticias de la semana.
- Añade WordPress, elige Create en Operation y Post en Entity.
- Conecta el título del artículo a Title, activa Add Others Caracteristics y elige Content y Status.
- Conecta el texto a Content y elige draft en Status para que el equipo lo revise antes de publicarlo.
Buenas prácticas
- Crea las entradas como borrador mientras pruebas el flujo, y cambia a publicadas cuando confíes en el resultado.
- Usa una cuenta de WordPress con los permisos justos para lo que hace el flujo.
Componentes relacionados
- WooCommerce: gestiona la tienda WooCommerce de una web WordPress.