Saltar al contenido
Menú Documentación
Conexión WP > Documentación de Notion WP Sync

Documentación de Notion WP Sync

⚠️ NOTA IMPORTANTE

Notion WP Sync es un SINCRONIZACIÓN UNIDIRECCIONAL - De Notion a WordPress ¡SÓLO!
Los cambios realizados en WordPress NO sincronizar de nuevo con Notion, así que asegúrate de gestionar tus datos desde Notion para mantener todo actualizado correctamente.

Instalación y configuración

Para instalar nuestro Notion WP Sync en WordPress, siga los pasos que se indican a continuación:

  1. Descargue el archivo del plugin en su ordenador
  2. Inicie sesión en el panel de control de WordPress.
  3. En el menú de la izquierda, haga clic en Plugins y el Añadir nuevo.
  4. Haga clic en el botón Subir Plugin en la parte superior de la página.
  5. Haga clic en el botón Elegir archivo y seleccione el archivo del plugin que descargó en el paso 1.
  6. Haga clic en el botón Instalar ahora botón.
  7. Espere a que se instale el plugin y haga clic en el botón Activar botón.
Notion a WordPress: Configurar el plugin WP Sync de Notion y la clave de licencia en WordPress

Tras instalar y activar el plugin en WordPress, aparecerá en el menú de administración y accederá a los ajustes de conexión y configuración.

Antes de crear una conexión, se le pedirá que introduzca su clave de licencia para validar la instalación del plugin. Para activar esta clave de licencia, vaya a Notion WP Sync > Configuración.

Esta clave de licencia está disponible tanto en el correo electrónico de confirmación de la compra como en wpconnect.co > Mi Cuenta > Mis Productos Descargables > Claves de Licencia, Ver Licencias.

A continuación serás redirigido a la página de compra de tu producto. Haga clic en el icono de la llave para que aparezca el número de licencia y cópielo y péguelo en su Notion WP Sync Clave de licencia campo.

Una vez copiada la clave de licencia en el Notion WP Sync asegúrese de hacer clic en el botón Activar botón . Si su clave de licencia es válida, aparecerá una marca de verificación verde y sólo tendrá que guardar la configuración haciendo clic en el botón Actualizar ajustes botón.

A continuación, puede empezar a crear sus conexiones.

Crear una conexión

Para crear una nueva conexión con su cuenta Notion, vaya a Notion WP Sync > Todas las conexionespulse el botón Añadir nueva conexión e introduzca un nombre para su conexión.

Se le pedirá un Ficha de integración interna para conectar su cuenta. Le recomendamos que recupere este token utilizando este enlace o ver este vídeo.

Para una mejor comprensión, siga estos pasos:

  1. En su cuenta Notion, vaya a la página de integraciones: Notion account > Connections > Develop or manage integrations.
  2. Haga clic en el botón Nueva integración e introduzca un nombre para su integración. A continuación, seleccione el espacio de trabajo en el que desea utilizar la integración en el campo Espacio de trabajo asociado campo. Seleccione "Interno" para el Tipo. Y haga clic en Guardar botón.
  3. Una vez que la integración se haya creado correctamente, haga clic en Configurar los ajustes de integración botón: un Secreto de integración interna ya está creado.
  4. Seleccione el Capacidades de contenidoLeer contenido" y el Capacidades del usuario Leer la información del usuario, incluidas las direcciones de correo electrónico"y haga clic en Guardar botón.
  5. Ahora, puede hacer clic en Mostrar entonces Copia el Secreto de integración interna. Puede pegarlo en el Ficha de integración interna campo de su Notion WP Sync plugin.
Notion to WordPress - Notion WP Sync: Cómo crear una integración interna

⚠️ Una vez que su Ficha de integración interna se ha introducido en el campo, tiene que compartir sus páginas o bases de datos Notion con sus integraciones para ver su en los diferentes campos de selección de su plugin.
Para ello, seleccione el botón más opciones en la parte superior derecha de su página Notion ou base de datos, pase el puntero del ratón por encima de Añadir conexión y selecciona la conexión que acabas de crear. También puede consultar la Página de documentación de Notion para saber cómo crear un token de integración interna.

Configuración de importación

Contenido de la noción

Puedes importar tus páginas y bases de datos de Notion a WordPress.

  • Páginas de nociones: En esencia, son documentos digitales que pueden contener una amplia gama de información, desde texto e imágenes hasta archivos incrustados, bases de datos y mucho más.
Notion a WordPress - Notion WP Sync: Cómo importar contenido de Notion como páginas en WordPress
  • Bases de datos Notion: una de las características más potentes de la plataforma Notion, las bases de datos Notion son esencialmente tablas con columnas personalizables, en las que los usuarios pueden introducir y manipular datos de diversas maneras.
Notion a WordPress - Notion WP Sync: Cómo crear entradas en WordPress a partir de una base de datos Notion

Destino

Puede importar sus contenidos de varias formas: Tipo de puesto o Código corto.

Tipo de puesto

Puede importar sus contenidos de varias formas: Publicar en, Página o Tipo de entrada personalizado.

He aquí cómo funcionan estos tres elementos:

  • Publicar enArtículo: un artículo es un contenido que puede publicarse en un blog o en un sitio web. Generalmente se utilizan para mostrar información. Se crean y gestionan en el Puestos del panel de control de WordPress.
  • Páginauna página es un contenido estático que suele formar parte del menú de navegación de un sitio web. Se utilizan para mostrar información. Se crean y gestionan en el Páginas del panel de control de WordPress.
  • Tipo de entrada personalizado (CPT)un custom post type es un tipo de contenido personalizado que puede ser creado por plugins o temas de WordPress. Los CPT le permiten añadir tipos de contenido especializados a su sitio, como eventos, productos, carteras, etc. Se utilizan generalmente para ampliar las capacidades de WordPress y para añadir contenido estructurado a su sitio. Son similares a los posts y a las páginas en el sentido de que pueden ser publicados en su sitio y vistos por los usuarios, pero tienen sus propias etiquetas y características únicas que los distinguen. Existen varios tipos de CPT: CPTs creados por plugins o temas que has instalado en tu sitio WordPress, los que has creado a través de plugin como Custom Post Type UI o ToolSet o los que han sido creados manualmente mediante desarrollo personalizado.


Creación de Post Type Personalizados

En el caso de que estés utilizando un tema y/o desarrollo específico, puede que dispongas de otros tipos de post. Estos son todos los Custom Post Types que ya han sido definidos por sus temas o plugins instalados o por los desarrolladores de su sitio WordPress.

📌 Nuestro Notion WP Sync ofrece la posibilidad de crear sus Custom Post Types sobre la marcha específicamente para su contenido importado.

Para el tipo de entrada personalizado que creará a partir del archivo Notion WP Sync encontrará la posibilidad de mapear los siguientes campos de WordPress: "Título“, “Contenido“, “Babosa“, “Campo personalizado“.

También le permite crear sus propios campos personalizados.

⚠️ PRECAUCIÓNsi decide cambiar la configuración y dejar de utilizar el tipo de entrada personalizado creado específicamente mediante la función Notion WP Sync este CPT creado sobre la marcha ya no existirá en WordPress y el contenido importado tampoco estará disponible.

Código corto

Puede importar su contenido Notion en shortcode.

Notion a WordPress - Notion WP Sync: Cómo crear y utilizar un shortcode para mostrar el contenido de Notion en WP

La creación de su contenido shortcode creará un Custom Post Type: "Notion Contenido". Este Notion Contenido CPT puede ser utilizado por los desarrolladores.

También se puede exponer gracias a nuestro Notion Contenido en el editor Gutenberg.

El shortcode generado se puede utilizar en el bloque de shortcode de Gutenberg o en diferentes páginas de constructores como Divi, Elementor, WP Bakery, etc.

Notion a WordPress - Notion WP Sync: Cómo utilizar el contenido de Notion como widget en WP gracias al shortcode

Estado del puesto

Al igual que en WordPress, el contenido importado de Notion puede tener diferentes estados: "Publicado", "Borrador", "Programado", "Pendiente", "Privado".

Cada uno de estos estados comprueba las siguientes condiciones:

  • PUBLICADO contenido es visible públicamente en su sitio web.
  • PROYECTO El contenido se guarda como trabajo en curso y no es visible para el público.
  • PROGRAMADO"El contenido se publicará en una fecha y hora determinadas en el futuro.
  • PENDIENTE"El contenido está a la espera de revisión o aprobación antes de ser publicado.
  • PRIVADO"sólo es visible para los usuarios registrados con los permisos adecuados.

En función del estado elegido, el contenido sincronizado recibirá el estado definido en los ajustes.

Si decide cambiar el estado en la configuración más adelante, tenga en cuenta que el cambio de estado de los contenidos ya importados dependerá de la estrategia de importación que haya definido (consulte las distintas estrategias de importación de contenidos).

📌 Si deseas utilizar una propiedad en tu base de datos Notion para definir el estado de las entradas, tendrás que utilizar los valores definidos en WordPress para esta propiedad. El artículo ¿Cómo configurar el estado de sincronización en Notion WP Sync? lo explica con detalle.

Post autor

En el proceso de importación de sus contenidos, se le pide que elija un autor que se asignará a cada contenido importado. La elección de este autor debe realizarse únicamente entre los usuarios registrados del sitio, es decir, los usuarios que tienen acceso a la parte administrativa del sitio, independientemente de su función.

Ahora puede utilizar el atributo author de Notion para asignar autores a entradas, páginas o tipos de entrada personalizados (CPT) en su mapeo. Esto funciona para usuarios existentes tanto en Notion como en WordPress. Simplemente asigne el atributo "Autor (correo electrónico)"en el campo Campo Notion a la columna "Autor"en el campo Importar como en WordPress.

⚠️Users ya debe existir en WordPress con el misma dirección de correo electrónico como su cuenta Notion.
Esta función no crear nuevos usuarios de WordPress durante la sincronización de contenidos.
Si no se encuentra un usuario que coincida, el puesto se asignará al usuario definido en el campo Autor del mensaje por defecto en el campo Importar como sección.

Color del texto por defecto en Notion

En Notion, hay diez colores disponibles para el texto, incluido el predeterminado, llamado "Texto por defecto": definido como blanco en modo oscuro y negro en modo claro.

Puede definir un color personalizado para el texto utilizando la opción "Texto por defecto" en Notion al importar contenidos a WordPress.

En el Importar como un selector de color está disponible cuando se asigna la sección "Contenido de la página" Campo Notion - tanto si lo importa como "Publicar en", "Usuario", o "Término taxonómico".

Para establecer un color: pulse el botón Seleccionar color y elija un color de la paleta, introduzca un código hexadecimal o elija uno de los 8 colores predefinidos debajo de la paleta. En WordPress, el contenido importado utilizará este color seleccionado.

Para eliminar un color seleccionado: pulse el botón Claro botón.

⚠️The color que defina aquí sólo se aplicará a los textos formateados como "Texto por defecto" en Notion, y no se aplicará a textos formateados con otro color, como "texto morado" o "texto rojo". Éstos conservarán el mismo color (morado o rojo) en WordPress.

Configuración de mapas

Ahora puede vincular sus páginas y campos de bases de datos con campos de WordPress.

Para ello, pulse el botón Añadir campo . A continuación aparecen dos listas desplegables, una contiene los campos de su página o base de datos Notion, la segunda los campos WordPress con los que puede mapearlos.

Publicar en

Para las entradas, encontrarás la posibilidad de mapear los siguientes campos de WordPress: "Título", "Imagen destacada", "Contenido", "Extracto", "Slug", "Etiqueta", "Categoría" o "Campo personalizado".

Página

Para las páginas, encontrará la posibilidad de asignar los siguientes campos de WordPress: "Título", "Imagen destacada", "Contenido", "Extracto", "Slug", "Etiqueta", "Categoría" o "Campo personalizado".

Tipo de entrada personalizada existente

Para los Custom Post Types existentes, es decir, creados por plugins o temas de WordPress presentes en su sitio, encontrará la posibilidad de mapear los siguientes campos de WordPress y cualquier campo vinculado a su CPT: Título, Contenido, Slug, Taxonomías o Campo Personalizado.

Las taxonomías se utilizan para agrupar contenidos similares en varios CPT. Pueden utilizarse para crear filtros o búsquedas de contenido.

Ejemplo de campos disponibles para un CPT de Propiedad: Título, Contenido, Slug, Tipo de propiedad (taxonomía), Ciudad (taxonomía), Campo personalizado, etc..

Campos personalizados

También puede considerar añadir campos específicos a su contenido importado de WordPress asignando su campo Notion a un campo personalizado que puede nombrar y que encontrará en el contenido importado una vez que la sincronización se haya completado.

⚠️ PRECAUCIÓN, si modifica la configuración y elimina un campo personalizado que se creó a partir del archivo Notion WP Sync no lo encontrará en ninguno de los contenidos importados.

Ajustes de sincronización

Puede elegir los parámetros de sincronización del Notion WP Sync plugin.

Haciendo clic en Sincronizar ahora podrá sincronizar sus contenidos por primera vez, aunque no haya seleccionado el botón Sólo manual gatillo.

Estrategia

Existen varias estrategias de importación para su contenido Notion en WordPress. Hemos definido 3 de ellas que son: Añadir / Añadir y actualizare/ Añadir, actualizar y eliminar.

Cada una de estas estrategias funciona como se ha mencionado:

  • AÑADE mode sólo añadirá nuevo contenido a su sitio web y no afectará al contenido existente.
  • AÑADIR/ACTUALIZAR añadirá nuevos contenidos y actualizará los existentes si se han editado en Notion
  • AÑADIR/ACTUALIZAR/BORRAR añadirá nuevos contenidos, actualizará los existentes si se han editado en Notion y eliminará los que se hayan borrado en Notion.

Disparador

Los disparadores permiten controlar cuándo se importan los datos de Notion a WordPress. Hay tres opciones de activación posibles: "Manual“, “Recurrente" y "Instantánea“.

  • MANUALle permite importar manualmente los datos haciendo clic en el botón Sincronizar ahora . Esto resulta útil si necesita importar datos ocasionalmente o desea tener más control sobre cuándo hacerlo.
  • RECURRENTEpermite programar la importación de datos a intervalos regulares. Puede elegir la frecuencia de la importación, por ejemplo cada "30 minutos", "Una vez por hora", "Una vez al día", "Dos veces al día" o "Una vez por semana". Esto es útil si quieres actualizar regularmente tu sitio WordPress con los últimos contenidos introducidos en tu espacio de trabajo Notion.
  • INSTANT: te permite importar datos en cuanto se añaden o actualizan en Notion (dependiendo de la estrategia de importación seleccionada). Esto es útil si quieres que tu sitio WordPress esté sincronizado en tiempo real con Notion, pero también puede consumir muchos recursos si tienes una gran cantidad de datos que se actualizan con frecuencia.
Notion to WordPress - Notion WP Sync: Cómo configurar los ajustes de sincronización y disparadores

Publicación

Una vez configurados todos los parámetros, no olvide publicar su conexión haciendo clic en Publique o Actualización en caso de modificación de la configuración. Y ya está.

Si ha elegido una sincronización manual, no dude en pulsar el botón Sincronizar ahora para sincronizar sus primeros contenidos y verlos aparecer en WordPress.

Campos y bloques de contenido compatibles

Propiedades admitidas (bases de datos):

  • Casilla de verificación
  • Fecha
  • Correo electrónico
  • Archivos y soportes
  • Selección múltiple
  • Número
  • Personas
  • Número de teléfono
  • Texto enriquecido ("Texto" en Notion)
  • Seleccione
  • Estado
  • Título
  • URL
  • Fórmula

Bloques de contenido compatibles (páginas):

  • Párrafo
  • Rúbrica (1,2,3)
  • Lista de viñetas/Lista de pedidos
  • Cita
  • Tabla (columna de cabecera no compatible)
  • Conmutar (Ver restricciones)
  • Separador
  • Llamada (contenido en recuadro - Ver restricciones)
  • Imagen
  • Vídeo (enlaces Spotify y Loom también)
  • Archivos
  • Columnas

Campos, bloques de contenido y vistas no compatibles

Esto es lo que aún no soporta nuestro plugin:

  • Hojas de ruta
  • Previsualización de enlaces web
  • Audios
  • Inserción de archivos
  • Vista del tablero
    Vista del gráfico
  • Vista de la galería
  • Vista de lista
  • Vista del calendario
  • Vista cronológica
  • Base de datos sincronizada
  • Marcadores
  • Índice
  • Fórmula matemática
  • Botón
  • Migas de pan
  • Bloque sincronizado, Embeds
  • Mención/Mencionar una página
  • Enlaces de páginas secundarias/enlaces internos
  • Fecha o recordatorio
  • Ecuación - En este bloque
  • Bloque IA
  • Casillas de verificación


Los enlaces internos no se convertirán en enlaces de páginas WP.
Sólo se admite la vista Tabla.

Restricciones

Notion es una aplicación que ofrece una amplia gama de funcionalidades.

Nos esforzamos por mantener el mayor número posible de estas funciones durante nuestro proceso de importación; sin embargo, debido a problemas de compatibilidad con Gutenberg, opciones por nuestra parte, o limitaciones de la API NotionSin embargo, algunas de estas funcionalidades siguen estando restringidas con nuestro plugin.

En páginas

Esto es lo que hemos decidido restringir en nuestro plugin:

¡Toggles ya es compatible con Gutenberg!

Por lo tanto, hemos añadido soporte para toggles; sin embargo, como el anidamiento es infinito en Notion, hemos decidido limitarlo al segundo nivel. Por lo tanto, no podrás tener más de 2 niveles de toggles (que es muuuuucho más que suficiente).

Consulte el ejemplo siguiente:

1. Obras

2. También funciona
3. No trabaje

Del mismo modo, se admiten llamadas. Sin embargo, no podrá anidar una llamada dentro de otra llamada (bueno, un nivel es suficiente, ¿no?).

Consulte el ejemplo siguiente:

1. ⚠️ Obras
2. ⚠️ No funcionan

Tabla de compatibilidad

Solución de problemas

Asegúrese de haber creado las bases de datos y los nombres de los campos Notion antes de añadir una nueva conexión. Si no lo ve, espere 1 minuto. Por razones de rendimiento, los elementos de Notion se almacenan en caché durante un minuto.

Si es necesario, puede acceder a los registros de un servidor FTP en esta carpeta:
/wp-content/uploads/notionwpsync-logs

Problemas de sincronización

Pueden aparecer algunos problemas al sincronizar. Algunos proveedores de alojamiento desactivan algunas funciones de PHP para garantizar el rendimiento de los servidores.

API Notion: error 403

In your Notion integration settings, ensure that you have checked the token Capacidades del usuario “Leer la información de los usuarios, incluidas las direcciones de correo electrónico“.

Tiempo de espera del servidor

Si tiene que importar una gran cantidad de contenidos, el proceso de sincronización tardará algún tiempo en sincronizar todos los datos, especialmente si se trata de la primera sincronización. Es posible que se produzca lo que se denomina un "tiempo de espera del servidor". Dependerá del número de filas que desee importar, del tamaño y del número de imágenes, pero también de la configuración del servidor. Es más probable que esto ocurra si has optado por una oferta básica de alojamiento.

Consulte con su proveedor de alojamiento y aumente el tiempo de ejecución, el tamaño de memoria permitido y el tamaño de archivo al máximo si es necesario.

Autenticación básica

En caso de que haya configurado una Autenticación Básica para proteger el acceso al sitio o a alguna información del sitio, la llamada a WP Cron es entonces imposible, imposibilitando la sincronización recurrente e instantánea.

Problemas de caché con WP-Cron

WP-Cron necesita que se cargue la página para activarse y por lo tanto sincronizarse. En caso de utilizar un sistema de caché (WP Rocket o WP Super Cache por ejemplo), es necesario utilizar un cron de servidor.


Artículos avanzados

es_ES