Complementos
Addons live under addons/{name}/. Install detects file conflicts. You can also install from Admin → Addons or the store.
Prefer platform building blocks
Addon code should reuse HareAdmin built-ins instead of bundling parallel stacks. Smaller packages, consistent admin UX, fewer conflicts.
- Table / form / upload / dialog / toast: use
Table.api,Form.api,Fast.api.ajax/confirm/contentDialog, Toastr, Layer. - Editor / SMS / payment / storage: register via drivers; consumers only use generic classes (e.g.
.editor). - Admin page scripts: prefer inline scripts in the view; do not add thin
public/assets/js/backend/**wrappers for one list page. - Copy:
lang()+ short reusable keys; content viaContentLang; visitor config viaSettings/localize. - CSS: AdminLTE4 / Bootstrap 5 + system content CSS; ship only business-critical extras.
- Introduce third-party libs under addon
assets/only when the platform has no equivalent; register paths inbootstrap.js.
Layout
blog/
├── Blog.php # main class (install/uninstall/menu/hooks)
├── info.ini
├── config.php # settings schema
├── bootstrap.js # optional RequireJS paths
├── install.sql
├── controller/ model/ view/
├── lang/ # merged into yt_lang
├── app/ # overlays project app/
├── public/ # overlays project public/
└── assets/ # copied to public/assets/addons/blog/
Notes
assets/→/public/assets/addons/{name}/; use__ADDON__in views. Keep it lean.- Lang PHP files merge via
LangPack::mergeAddon. - Register drivers in
configInit; consumers use generic classes.
Config / localize
Visitor-facing strings: localize => true in config.php. Read via Settings. Full rules: Internationalization → Settings / localize.
CLI
php think addon -a blog -c create|enable|disable|uninstall|package
Capacidades de grupo de miembros (UserCapability)
Los grupos de miembros son un núcleo ligero: tabla user_group, campo group_id y CRUD. La ACL diaria se gestiona activando capacidades en el formulario del grupo. El árbol user/rule es avanzado y está oculto en el menú por defecto (yetuadmin.member_rule_menu = false).
No publique un complemento aparte solo para group_id. Los complementos de negocio registran las capacidades que necesitan; el operador solo marca casillas.
Registro
En el configInit del complemento o el hook user_capability_init:
\app\common\library\UserCapability::register('addon/shop/buy', [
'title' => 'Shop buy',
'category' => 'shop',
'category_title' => 'Shop',
'priority' => 50,
]);
name debe coincidir con la ruta completa de regla en la comprobación (mismo estilo que user_rule.name).
Comprobación
Auth::instance()->hasCapability('addon/shop/buy');
Auth::check() sigue admitiendo rutas relativas al módulo. Prefiera hasCapability() para nombres de capacidad completos registrados.
Almacenamiento y compatibilidad
- Las selecciones se escriben en
user_group.rulescomo ids deuser_rule(con ancestros) para queAuth::check()siga funcionando. - Al guardar el formulario de capacidades se conservan nodos personalizados que no están en el registro.
- Integrados en el núcleo: login / registro / centro de miembros / perfil (frontend + API).
Hacer / Evitar
- Hacer: registrar capacidades desde el complemento que las aplica.
- Hacer: reutilizar etiquetas i18n cortas (
Login,Profile, …). - Evitar: pedir al operador mantener el árbol de reglas para la ACL cotidiana.
- Evitar: codificar ACL de proveedor fuera del modelo capacidad + grupo.
Edición de desarrollo; el comportamiento puede evolucionar.