mirror/opensourcepos
1
0
Fork 0
mirror of https://github.com/opensourcepos/opensourcepos.git synced 2026-07-27 23:27:04 -04:00
Code Issues Packages Projects Releases Wiki Activity

feat(plugins): add registerModule helper and replace asset injection with explicit CSS links

Browse Source 
- Add BasePlugin::registerModule() to register permission-system modules,
  auto-grant to admin (person_id=1), idempotent via INSERT IGNORE
- Replace inject:css/js placeholders in header.php with explicit versioned
  asset links for reliable loading outside build pipeline
- Update home.php module icons to use pluginContent() hook with SVG fallback,
  enabling plugins to override module icons

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>
This commit is contained in:
Travis Garrison
2026-07-22 17:02:42 +04:00
parent 0e5192a317
commit a6036cb082
5 changed files with 277 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

78
app/Libraries/Plugins/BasePlugin.php
View File

@@ -81,4 +81,82 @@ abstract class BasePlugin implements PluginInterface
$namespace = substr(get_class($this), 0, strrpos(get_class($this), '\\'));
return view($namespace . '\\Views\\' . $viewName, $data);
}
/**
* Register a module in the permission system and auto-grant it to admin (person_id=1).
* Call from install(). Idempotent — safe to call multiple times.
*
* Convention: prefix module_id with plugin_id (e.g. 'mailchimp_dashboard').
* Language keys resolved from plugin's Language/{locale}/Module.php file.
*/
protected function registerModule(
string $module_id,
int $sort = 500,
string $admin_menu_group = 'office'
): bool {
$db = \Config\Database::connect();
$db->table('modules')->ignore(true)->insert([
'module_id' => $module_id,
'name_lang_key' => 'module_' . $module_id,
'desc_lang_key' => 'module_' . $module_id . '_desc',
'sort' => $sort,
]);
$db->table('permissions')->ignore(true)->insert([
'permission_id' => $module_id,
'module_id' => $module_id,
]);
$db->table('grants')->ignore(true)->insert([
'permission_id' => $module_id,
'person_id' => 1,
'menu_group' => $admin_menu_group,
]);
return true;
}
/**
* Remove a module and all its permissions from the permission system.
* Grants cascade automatically via FK. Call from uninstall().
*
* Note: ospos_permissions has no FK cascade from ospos_modules, so
* permissions must be deleted before the module row.
*/
protected function unregisterModule(string $module_id): bool
{
$db = \Config\Database::connect();
$db->table('permissions')->where('module_id', $module_id)->delete();
$db->table('modules')->where('module_id', $module_id)->delete();
return true;
}
/**
* Register a sub-permission under an existing module and auto-grant to admin.
* Sub-permissions use menu_group '--' per core convention.
* Call from install() after registerModule().
*/
protected function registerSubPermission(string $permission_id, string $module_id): bool
{
$db = \Config\Database::connect();
$db->table('permissions')->ignore(true)->insert([
'permission_id' => $permission_id,
'module_id' => $module_id,
]);
$db->table('grants')->ignore(true)->insert([
'permission_id' => $permission_id,
'person_id' => 1,
'menu_group' => '--',
]);
return true;
}
/**
* Remove a specific sub-permission. Grants cascade automatically via FK.
* unregisterModule() already handles this for all sub-permissions under a module,
* so only call this directly when removing a sub-permission independently.
*/
protected function unregisterSubPermission(string $permission_id): bool
{
\Config\Database::connect()->table('permissions')
->where('permission_id', $permission_id)->delete();
return true;
}
}