Controladores de complementos
On this page
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 SMSpayment— pasarelas de pagooauth— inicio de sesión de tercerosstorage— almacenamiento de subidasai— 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 devolvernull. - 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/senddevuelve el mismo error. - La UI debe distinguir correo y móvil. No reutilice una etiqueta genérica «Captcha» cuando el destino importa.
mode=dryrunvalida 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 disparapayment_notify_success. mode=dryrundevuelve una URL de pago simulada.
OAuth (inicio de sesión)
- Canal
oauth. Plantillas de login/registro usan el hookuser_third_login. - Importante:
hook()devuelve un array. Concatene antes de imprimir:
No haga$html = hook('user_third_login'); echo is_array($html) ? implode('', array_map('strval', $html)) : (string) $html;echo hook('user_third_login')directamente. - Núcleo:
app\common\library\oauth\Managery tablayt_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 rutaCallback path(solo lectura) se copia a la consola. - Consola del proveedor (Live): registrar
{dominio}{Callback path}exacto, sin.html. Mode=dryrunno requiere claves reales; uselivetras credenciales y callback en consola.
IA (LLM Hub)
- Modelos: una fila = un
modelid 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.