Docs home / hareadmin

Controladores de complementos

El código de negocio no debe fijar un proveedor concreto. Las implementaciones se registran con canales AddonDriver; el negocio solo usa APIs y hooks genéricos.

Canales

  • editor — texto enriquecido (class="editor")
  • sms — OTP / avisos SMS
  • payment — pasarelas de pago
  • oauth — inicio de sesión de terceros
  • storage — almacenamiento de subidas
  • ai — chat LLM (llmhub)
  • map — mapas (maphub)

Controlador activo (sms / payment / editor / storage): site.driver_{canal} o yetuadmin.driver_{canal}; si falta, gana el mayor priority. OAuth es multi-activo: todos los proveedores configurados pueden mostrar botón.

SMS

  • Hooks: sms_send, sms_notice, sms_check. Los no activos deben devolver null.
  • Registro en configInit / appInit: AddonDriver::register('sms', $name, …)
  • Tienda oficial: alisms, tencentsms, huaweisms, twilio, vonage
  • Captcha de registro: si yetuadmin.user_register_captcha = mobile, el sitio debe tener un complemento SMS. Si falta, la página de registro enlaza a la tienda; api/sms/send devuelve el mismo error.
  • La UI debe distinguir correo y móvil. No reutilice una etiqueta genérica «Captcha» cuando el destino importa.
  • mode=dryrun valida en local sin llamar a la API remota.

Pago

  • Registro: AddonDriver::register('payment', $name, ['gateway' => Gateway::class, 'class' => Client::class])
  • Gateway implementa app\common\library\payment\GatewayInterface. Sitios: payment\Manager; API de tienda: GatewayManager.
  • Tienda oficial: alipay, wechatpay, douyinpay, stripe, paypal
  • Notificación: /addons/{name}/notify/index; éxito dispara payment_notify_success.
  • mode=dryrun devuelve una URL de pago simulada.

OAuth (inicio de sesión)

  • Canal oauth. Plantillas de login/registro usan el hook user_third_login.
  • Importante: hook() devuelve un array. Concatene antes de imprimir:
    $html = hook('user_third_login');
    echo is_array($html) ? implode('', array_map('strval', $html)) : (string) $html;
    No haga echo hook('user_third_login') directamente.
  • Núcleo: app\common\library\oauth\Manager y tabla yt_user_third (Manager::ensureTable()).
  • Proveedores: wechatlogin, qqlogin, weibologin, douyinlogin, googlelogin, applelogin, facebooklogin, xlogin, tiktoklogin, microsoftlogin
  • Flujo: connect → proveedor → callback. Dry-run omite la redirección remota.
  • Ajustes del complemento: solo Mode + credenciales del proveedor. La ruta Callback path (solo lectura) se copia a la consola.
  • Consola del proveedor (Live): registrar {dominio}{Callback path} exacto, sin .html.
  • Mode=dryrun no requiere claves reales; use live tras credenciales y callback en consola.

IA (LLM Hub)

  • Modelos: una fila = un model id concreto. family / is_latest / capability.
  • Proveedores: OpenAI, Anthropic, Google AI, DeepSeek, Qwen, DashScope, Doubao, Kimi, GLM, compatible OpenAI.
  • Canal ai. Complemento hub oficial: llmhub.
  • El negocio llama a Client::chat(). No fije SDKs de OpenAI/Anthropic en la app.
  • Proveedores: OpenAI, Anthropic, Google AI, DeepSeek, DashScope (Qwen), compatible OpenAI personalizado. Etiquetas opcionales; vacío = general.
  • Enrutado: predeterminado / por etiqueta / código manual. Multi-idioma zh/en/es + ContentLang.

Mapas (Map Hub)

  • Canal map. Hub oficial: maphub.
  • UI: class="map-picker" → YetuDrivers.bindMap.
  • Proveedores: Google Maps, Mapbox, Amap, Baidu Map. Idioma del mapa según la UI (o código fijo).

Paquetes de idioma (obligatorios)

Todo complemento nuevo debe incluir lang/zh.php, lang/en.php y lang/es.php con las mismas claves. El inglés es la fuente. Otros idiomas pueden llegar después. Prefiera claves compartidas de la plataforma.

Hacer / No hacer

  • Hacer: un proveedor → un complemento; APIs oficiales; documentar notify y dry-run en Ajustes.
  • Hacer: redacción global — nombre del proveedor/producto, sin enmarcar mercados locales frente a otros.
  • Hacer: en el manual, solo consejos de integración necesarios.
  • No: fijar nombres de clase de Alipay / Twilio / Google en el negocio.
  • No: JS/CSS de admin por página solo para la configuración del driver.