Ai Admin Jqadm Laravel Package

Getting Started

This package provides the Vue.js + Bootstrap-based admin interface for the Aimeos e-commerce platform. Start by installing the core Aimeos package (aimeos/aimeos) and then this UI component via Composer: composer require aimeos/ai-admin-jqadm. After installation, publish the assets (php artisan vendor:publish --tag=ai-admin-jqadm) and configure the admin routes in routes/web.php — typically Route::prefix('admin')->middleware('auth')->group(...) using Aimeos\Jobs\Admin\Jqadm\Index::class. The first login will show the default dashboard with module links (products, orders, customers, etc.). Check the config/aimeos.php file to customize which modules are available.

Implementation Patterns

• Module customization: Extend or override any admin module (e.g., product editor) by publishing views with php artisan vendor:publish --tag=ai-admin-jqadm-views and modifying the Vue components in resources/views/vendor/aimeos/admin/jqadm/.
• Client-side extension: Register custom Vue plugins or mixins in resources/js/admin.js before initializing the app (e.g., for added validation, analytics hooks, or custom field types).
• Data transformation: Use Aimeos’ built-in view composers and hooks (e.g., admin/jqadm/get/after) in app/Providers/AimeosServiceProvider.php to inject or modify data sent to the frontend (e.g., adding dynamic dropdowns, pre-filling fields).
• Multi-site support: Configure separate tenant contexts in config/aimeos.php under admin/jqadm/sites to separate admin views by domain or brand.

Gotchas and Tips

• Asset recompilation: If changes to Vue components don’t reflect, run npm run dev and ensure Laravel Mix is recompiling to public/vendor/aimeos/admin/ — common pitfall is stale cached assets in storage/framework/views.
• Permission confusion: Admin permissions are controlled via Aimeos’ RBAC system in config/aimeos.php under admin/jqadm/items, not Laravel gate policies — ensure admin/jqadm permissions match your role definitions.
• I18n gotcha: Translations are managed by Aimeos’ i18n system (resources/lang/vendor/aimeos/admin/), not Laravel’s default resources/lang. Update both JSON and PHP translation files for full coverage.
• Debugging Vue: Enable Vue devtools by setting APP_DEBUG=true and ensuring mix.js() includes vue in webpack.mix.js. Use console.log('admin-data', window.AimeosAdmin?.store) to inspect state in dev mode.
• Extending the editor: To add custom fields to product/category forms, use the admin/jqadm/form job and extend the BaseForm component — don’t modify core files directly. Prefer composition over inheritance.