Documentación sobre la integración de CC WordPress OLX
Documentación completa para un plugin que permite la integración de WooCommerce con la plataforma OLX (cc_wordpress_olx_integration).Índice
- Introducción
- Instalación
- Activación de la licencia
- Escritorio principal
- Integración de productos
- Gestión de la lista publicitaria
- Configuración de la API
- Gestión de la ubicación
- Resolución de problemas
- PREGUNTAS FRECUENTES
1. introducción
CC WordPress OLX Integration es un plugin profesional para WordPress que permite la integración completa de su tienda WooCommerce con la plataforma OLX. Le permite publicar, actualizar y gestionar sus anuncios directamente desde el panel de administración de WordPress, sin tener que iniciar sesión en el panel de OLX.El plug-in permite un control total sobre:
- Creación y publicación de anuncios OLX basados en productos WooCommerce
- Actualización de anuncios tras cambios en los productos
- Gestión del estado de los anuncios (activación, desactivación)
- Seguimiento de las estadísticas publicitarias
- Sincronización automática de ubicaciones (ciudades, distritos)
2. instalación
Requisitos del sistema- WordPress 5.0 o superior
- WooCommerce 3.0 o posterior
- PHP 7.0 o posterior
- Descargue el archivo ZIP del plug-in de la tienda oficial códigos.cocos
- Acceda al panel de administración de WordPress
- Vaya a: Plugins > Añadir nuevo > Enviar plugin
- Seleccione el archivo ZIP descargado y haga clic en "Instalar ahora".
- Una vez finalizada la instalación, haga clic en "Activar complemento".
Información
El plugin requiere un WooCommerce activo. Si WooCommerce no está instalado o activado, el plugin mostrará el mensaje correspondiente.
3. activación de la licencia
Es necesario activar la licencia antes de utilizar el plug-in:- Tras la instalación, aparecerá un nuevo elemento de menú "Integración OLX".
- Ir a la pestaña Integración OLX > Licencia
- Introduzca la clave de licencia recibida tras la compra
- Haga clic en "Activar licencia".
- Tras la activación, aparecerá un mensaje de confirmación y se desbloquearán todas las funciones del complemento.
Advertencia
Sin una licencia activa, el plug-in funcionará en modo limitado, sin la capacidad de publicar y gestionar anuncios en OLX.
4 Escritorio principal
El panel principal del complemento contiene información y estadísticas clave: Panel de estadísticas- Número total de anuncios
- Número de anuncios activos
- Número de anuncios pendientes
- Número de anuncios inactivos
- Nuevos anuncios
- Notificaciones impagadas
- Anuncios no confirmados
- Ver todos los anuncios - redirigir a la lista de anuncios
- Añadir nuevo anuncio - redirigir para añadir productos WooCommerce
Consejo
El panel de estadísticas ofrece una visión rápida del estado de los anuncios. El gráfico muestra el porcentaje de anuncios con diferentes estados.
5. integración de productos
La integración con los productos de WooCommerce se realiza a través de un panel adicional en la edición del producto: Integración de productos- Ve a editar tu producto WooCommerce (Productos > Editar)
- Localiza la sección "Integración con OLX" debajo de la descripción del producto
- Marca la opción "Habilitar la integración de OLX para este producto".
- Rellene el formulario de datos del anuncio
- Guarde los datos del producto pulsando el botón "Actualizar".
- Título de la solicitud - el mismo que el nombre del producto por defecto (requiere de 16 a 70 caracteres)
- Descripción del anuncio - descripción del producto por defecto (requiere 80-9000 caracteres)
- Categoría OLX - seleccionar una categoría OLX para un anuncio
- Atributos de categoría - campos adicionales específicos de la categoría seleccionada
- Tipo de cuenta - particular o empresa
- Datos de contacto - nombre de la empresa y número de teléfono
- Ubicación - ciudad y, opcionalmente, distrito
- Precio - valor, moneda y opción "negociable
- Botón "Publicar en OLX" - para nuevos anuncios
- Botón "Actualizar anuncio" - para anuncios existentes
- Botón "Desactivar anuncio" para los anuncios activos
- Botón "Activar anuncio" - para anuncios inactivos
- Botón "Eliminar anuncio" - eliminación completa de un anuncio de OLX
Nota
Las fotos del producto se utilizan automáticamente en el anuncio de OLX. Las primeras 8 fotos de la galería del producto serán enviadas a OLX.
6. gestión de la lista de anuncios
La pestaña "Lista de anuncios" le permite ver y gestionar todos sus anuncios: Filtrado de anuncios
- Por categoría de productos
- Según el estado del anuncio
- Por fecha (de-a)
- Búsqueda de texto
- Nombre del producto
- ID del anuncio (con enlace al anuncio en OLX)
- Estado del anuncio
- Categoría OLX
- Fecha de creación
- Fecha de caducidad
- Precio
- Acciones disponibles
- Desactivación del anuncio
- Activación de la publicidad
- Retirada de la notificación
- Actualización de estado
Consejo
Los anuncios que caducan en los próximos tres días se marcan con un mensaje de advertencia especial.
7 Ajustes API
En la pestaña "Configuración" puedes configurar la conexión a la API de OLX y los valores por defecto para los anuncios: Configuración de la API de OLX- ID de cliente - ID de cliente recibido de OLX
- Secreto de cliente - clave secreta de cliente recibida de OLX
- URI de redireccionamiento - dirección de autorización (configuración por defecto)
- URL de la API base - Dirección API de OLX (por defecto: https://www.olx.pl)
- Ciudad por defecto - lugar utilizado para los nuevos anuncios
- Barrio por defecto - barrio utilizado para los nuevos anuncios
- Número de teléfono por defecto - número de contacto para anuncios
- Nombre por defecto / nombre de la empresa - nombre de contacto para anuncios
- Tipo de cuenta por defecto - particular o empresa
- Moneda por defecto - divisa utilizada en los anuncios (PLN, EUR, USD)
- Titular del anuncio - texto añadido al principio de la descripción
- Pie de página - texto añadido al final de la descripción
- Activar encabezado/pie automático - si incluir estos elementos en las descripciones
Éxito
Una vez que te hayas conectado con éxito a la API de OLX, verás el mensaje "Conectado a la API de OLX. El token de acceso es válido".
8. gestión del sitio
La pestaña "Localizaciones" permite sincronizar los datos de localización con OLX: Datos de localización- Regiones/provincias
- Ciudades
- Distritos
- Sincronización de regiones
- Sincronización de ciudades (proceso incremental)
- Sincronización de distritos (para cada ciudad)
Información
La sincronización de ubicaciones permite almacenar los datos de ciudades y distritos en una base de datos local, lo que agiliza enormemente el plug-in.
Por defecto, el complemento tiene una base de datos preinstalada, por lo que no es necesario sincronizar las ciudades.
Por defecto, el complemento tiene una base de datos preinstalada, por lo que no es necesario sincronizar las ciudades.
9 Solución de problemas
El anuncio no está publicado en OLX- Comprobar que la licencia está activa
- Asegúrese de que los datos de la API (ID de cliente y secreto de cliente) son correctos.
- Compruebe que se han rellenado todos los campos obligatorios del formulario de anuncio
- Compruebe que el título y la descripción cumplen los requisitos de longitud (título: 16-70 caracteres, descripción: 80-9000 caracteres)
- Asegúrate de que la categoría OLX seleccionada es la categoría final (sin subcategorías)
- Compruebe que se han rellenado todos los atributos necesarios para la categoría seleccionada.
- Asegúrese de que el precio es un número mayor que cero
- Comprobar la exactitud del número de teléfono
- Comprueba la conexión a la API de OLX
- Asegúrese de que el token de acceso es válido
- Comprobar los permisos de escritura de la base de datos
Error
Si hay errores de comunicación con la API de OLX, asegúrate de que los parámetros de tu API son correctos y que tienes una cuenta activa en la plataforma de OLX con permisos de API.
10. PREGUNTAS FRECUENTES
¿Funciona el plugin sin WooCommerce?No, el plugin requiere un WooCommerce activo ya que se basa en los productos de WooCommerce como fuente de datos para los anuncios.
¿Cuántos anuncios puedo publicar en OLX?
El número de anuncios depende de tu plan en la plataforma OLX, no del plug-in.
¿Puedo utilizar el plug-in para varias tiendas?
Sí, cada licencia le permite utilizar el plugin en una instalación de WordPress. Se necesitan licencias separadas para varias tiendas.
¿El plug-in actualiza automáticamente los anuncios cuando cambia el producto?
No, tiene que hacer clic manualmente en "Actualizar anuncio" después de realizar cambios en el producto.
¿Qué ocurre con el anuncio cuando se agota el producto?
El plugin no desactiva automáticamente los anuncios. Puede configurar una función que compruebe las existencias y desactive los anuncios de los productos agotados.
¿Puedo tener diferentes configuraciones para diferentes anuncios?
Sí, cada producto puede tener una configuración de anuncios individual, independiente de la configuración predeterminada.
¿Admite el plug-in variantes de productos?
Sí, para los productos con variaciones puede crear anuncios que contengan todas las variantes disponibles.
¿Necesito una cuenta especial en OLX para utilizar el plug-in?
Sí, necesitas una cuenta con acceso a la API de OLX. Contacta con el soporte de OLX para obtener los datos de acceso a la API a través de la plataforma. https://developer.olx.pl/
Consejo
Si tiene algún problema con el plug-in o alguna pregunta sobre su funcionamiento, visite la página de soporte en cocos.codes/soporte.
