Skip to content

Updating

Diego Smania edited this page Feb 10, 2022 · 6 revisions
  1. On the root folder of your project, first update the package with the next composer command:

    composer update jeroennoten/laravel-adminlte
  2. Then, update the required AdminLTE assets resources executing the next command:

    php artisan adminlte:update
  3. If you have previously published and modified the default master.blade.php file, the page.blade.php file or any other view provided by this package, then you may need to update them too. Please, note there could be huge updates on those views, so it is highly recommended to backup your view files previously. To update the views, you may follow next steps:

    Note: You may use a comparison tool (like meld) in order to identify the differences between the published files and the new ones. You will need to compare the published files at resources/views/vendor/adminlte with the package provided ones, at vendor/jeroennoten/laravel-adminlte/resources/views/.

    • Make a copy (or backup) of the views you have modified, those inside the folder resources/views/vendor/adminlte.

    • Publish the new set of views, using the --force option to overwrite the currently existing files.

      php artisan adminlte:install --only=main_views --force
    • Compare the new installed views with your backup files and redo the modifications you previously did to those views.

  4. From time to time, new configuration options may be added or default values may be changed, so it is also a recommendation to verify and update your package configuration file if needed. To update the configuration, you may follow next steps:

    • Make a copy (or backup) of your current package configuration file, the config/adminlte.php file.

    • Now, publish the new package configuration file and accept the overwrite warning (or use --force option to avoid the warning).

      php artisan adminlte:install --only=config
    • Compare with your backup configuration file and redo the modifications you previously made.

  5. In the particular case the update includes jumping to a new version of the underlying AdminLTE package, you may also want to update the plugins you have previously installed using the command php artisan adminlte:plugins install --plugin=somePlugin. In these cases, you may proceed as explained below.

    • Execute the command php artisan adminlte:plugins to get a status overview of the previously installed plugins.

    • For those ones you see the mismatch legend on the status column, you may want to update the plugin executing the next command:

      php artisan adminlte:plugins install --plugin=thePluginKeyWithMismatchLegend