El inicio de sesión de miembros parece solo «poner un botón de inicio de sesión», pero en realidad tiene tres rutas: escaneo de código QR de WeChat, autorización de la cuenta oficial dentro de WeChat y vinculación del teléfono móvil después de la autorización. Las tres rutas tienen AppID, URL de callback y conmutadores diferentes; cuando se configuran mal, los síntomas también se parecen mucho: el botón no aparece o, después de autorizar, se sigue pidiendo la vinculación.

I. Activación y entrada
Después de activar el módulo de miembros, aparece el menú «Miembros» a la izquierda y el front-end habilita las páginas de inicio de sesión y del centro de miembros. Los métodos de inicio de sesión están en «Configuración → Miembros e inicio de sesión → Métodos de inicio de sesión» (/admin/settings/member/login-methods); primero hay que hacer clic en «Mostrar configuración avanzada» para que aparezca esa sección.
II. Escaneo de código QR de WeChat (aplicación web de la plataforma abierta)
El inicio de sesión por escaneo utiliza la «aplicación web» de la plataforma abierta de WeChat y requiere completar el AppID y el AppSecret de esa aplicación; no es el mismo AppID que el de WeChat Pay. La URL de callback se genera automáticamente a partir de la URL del sitio en «Datos básicos del sitio», con la forma https://<域名>/member/callback/wechat; el callback del administrador es /admin/wechat/callback. Antes de usarlo, hay que registrar el dominio de callback en la plataforma abierta y el sitio debe ser HTTPS.
Una vez completada la configuración, en la página de inicio de sesión del panel de administración aparece «Inicio de sesión con código QR de WeChat» y en la página de cambio de contraseña aparece «Vinculación con WeChat»; además, en la página de inicio de sesión de miembros hay que activar el conmutador «Inicio de sesión con WeChat» para que aparezca el botón de escaneo para miembros. Si se borra cualquiera de los parámetros, se ocultan las entradas de escaneo tanto para miembros como para administradores; si solo se desactiva el conmutador, se oculta el botón para miembros, pero el escaneo del administrador sigue disponible; las vinculaciones ya guardadas no se pierden.
III. Autorización web de la cuenta oficial (dentro del navegador de WeChat)
Esta ruta utiliza el AppID y el AppSecret de la cuenta oficial, y requiere que coincidan con el AppID de WeChat Pay. Cuando ambos campos no están vacíos, al abrir /member/login en el navegador de WeChat se inicia automáticamente la autorización web y ya no se muestra la página de escaneo. Primero hay que establecer el dominio del sitio como «dominio de autorización web» en la plataforma de cuentas oficiales; la URL de callback es https://<域名>/member/wechat/oa/callback, no se muestra en el panel de administración y debe registrarse manualmente.

IV. Vinculación del teléfono móvil
Después de la autorización de la cuenta oficial, en el primer inicio de sesión se intentarán guardar el apodo y el avatar de WeChat; el teléfono móvil queda vacío. Se entra en la página «Vincular teléfono móvil» en los siguientes casos: ese WeChat no tiene un miembro correspondiente y el unionid tampoco coincide con ningún miembro. Basta con rellenar un número de teléfono móvil de China continental de 11 dígitos y confirmar para iniciar sesión; las reglas son:
- El número ya pertenece a algún miembro: se vincula el WeChat actual a ese miembro; si hay varios con el mismo número, se usa el creado primero;
- El número no está registrado: se crea un nuevo miembro, el apodo y el avatar se toman de los datos de WeChat y el teléfono móvil se guarda con el valor introducido;
- Si el formato es incorrecto, se muestra «Introduce un número de móvil válido de 11 dígitos»; si ese WeChat ya está vinculado a otro miembro, se rechaza;
- La vinculación del teléfono móvil no envía código de verificación por SMS ni valida la titularidad del número, solo compara por el texto del número.
V. Sesión y datos de la cuenta
La sesión de miembro tiene una validez de 12 horas, el nombre de la cookie es kc_member y no afecta a la sesión del administrador del panel; si se vuelve a escanear el código en el mismo navegador, la sesión anterior deja de ser válida. Todos los datos de la cuenta son opcionales; el teléfono móvil debe ser de 11 dígitos y empezar por 1[3-9]; del correo electrónico solo se valida el formato. Se pueden guardar como máximo 50 direcciones de envío; el pedido guarda una instantánea en el momento de la compra, por lo que cambiar la dirección después no afecta a los pedidos históricos.
VI. Reclamación de pedidos
Se puede realizar un pedido sin haber iniciado sesión. La página de pago muestra «Registrar en mi cuenta» cuando se cumplen simultáneamente las siguientes condiciones: el pedido sigue pendiente de pago, aún no está asociado a ningún miembro, el miembro actual ya ha rellenado su teléfono móvil y el teléfono del miembro coincide exactamente con el teléfono del contacto del pedido. Una vez que el pedido se ha pagado o cancelado, ya no se puede reclamar.
VII. Errores frecuentes
- No aparece el botón de escaneo: comprueba si el AppID/Secret de la plataforma abierta está completo y si el conmutador de WeChat en la página de inicio de sesión de miembros está activado;
- En WeChat se sigue pidiendo la vinculación: la autorización web de la cuenta oficial no está bien configurada, o ese WeChat realmente no tiene un miembro correspondiente;
- Error en el callback: confirma que la URL del sitio es HTTPS y que el dominio de callback registrado en la plataforma abierta/plataforma de cuentas oficiales coincide con el sitio;
- Se muestra que el estado de inicio de sesión ha caducado: el state de autorización ha caducado o no coincide; basta con volver a iniciar la autorización;
- Miembro desactivado: se muestra «Este miembro ha sido desactivado» y no se crea la sesión.
Resumen
El escaneo utiliza la plataforma abierta y, dentro de WeChat, se usa la autorización de la cuenta oficial; ambos tienen AppID y callback diferentes. Solo cuando, tras la autorización, no existe un miembro correspondiente hay que vincular el teléfono móvil. Diagnosticar estas tres partes por separado es más eficaz que quedarse mirando el botón de inicio de sesión.