# General Upgrade Instructions
Update the package
composer update lunarphp/lunar
Run any migrations
php artisan migrate
Re-publish the admin hub assets
php artisan lunar:hub:install
# Publishing changes
All publishing commands for Lunar now use
. as a separator.
# Brand requirement is now configurable.
Whether the product brand is required on your store is now configurable, the default behaviour is set to
true. If you wish to change this, simply update
'require_brand' => false,
# Migrating from GetCandy to Lunar
The initial release of Lunar will be version
0.1.0. This allows for a rapid development cycle until we reach
Understandably, a complete name change is not small task, so we've outlined steps you need to take to bring your install
up to the latest Lunar version and move away from GetCandy.
# Update composer dependencies
"getcandy/admin": "^2.0-beta", "getcandy/core": "^2.0-beta"
Any add-ons you are using will need their namespaces updated, the package name should remain the same, i.e.
Once done, remember to run
composer update to pull in the latest packages.
# Update namespaces
If you are using any GetCandy classes, such as models, you will need to update their namespace:
A simple find and replace in your code should be sufficient, the strings you should search for are:
GetCandy get-candy getcandy
# Config changes
- Rename the
- Rename the
- Change the prefix in
Also make sure any class references in your config files have been updated to the
# Meilisearch users
Lunar no longer ships with Meilisearch by default. If you use Meilisearch and wish to carry on using it, you will need to require the new Lunar meilisearch package.
composer require lunarphp/meilisearch
This will install the appropriate packages that Scout needs and also register the set up command so you can keep using it, you just need to update the signature.
php artisan lunar:meilisearch:setup
# MySQL Search
If you were previously using the
mysql Scout driver, you should change this to
database_index. This populates the
search_index table with the terms to be searched upon. You may need to run the scout import command:
php artisan scout:import Lunar\Models\Product
# Database migration
If you are using the
getcandy_ prefix in your database, then you will likely want to update this to
We have created a command for this purpose to try make the switch as easy as possible.
php artisan lunar:migrate:getcandy
# What this command will do
- Remove any previous GetCandy migrations from the
- Run the migrations again with the
lunar_prefix, creating new tables.
- Copy across the data from the old
getcandy_tables into the new
- Update any polymorphic
GetCandyclasses to the
- Update field types in
# What this command will not do
- Affect any custom tables that have been added outside the core packages.
The intention of this is to provide a non-destructive way to migrate the data. Once the command has been run
getcandy_ tables should remain intact, so you are free to check the data and remove when ready.