Docs home / hareadmin

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 via ContentLang; visitor config via Settings / 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 in bootstrap.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.rules como ids de user_rule (con ancestros) para que Auth::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.