Skip to main content

​
Panel Configuration

Publish the panel configuration file if it has not already been published: 
php artisan vendor:publish --tag=lunar-panel
This creates config/lunar-panel.php with the following options:
OptionTypeDefaultDescription
enable_variantsbooltrueShow the variants manager when editing a product. Set to false if the storefront does not support variants.
pdf_renderingstringdownloadHow PDFs are handled in the panel. Options are download or stream.
scout_enabledboolfalseUse Laravel Scout for searching supported models in panel tables.
order_count_statusesarray['payment-received']Order statuses included in the navigation badge count.

​
Product Association Types

By default, the admin panel provides three association types in the product associations dropdown: Cross Sell, Up Sell, and Alternate. These come from the Lunar\Base\Enums\ProductAssociation enum. To add custom association types, create a new backed enum that implements the ProvidesProductAssociationType interface: 
namespace App\Enums;

use Lunar\Base\Enums\Concerns\ProvidesProductAssociationType;

enum ProductAssociation: string implements ProvidesProductAssociationType
{
    case CROSS_SELL = 'cross-sell';
    case UP_SELL = 'up-sell';
    case ALTERNATE = 'alternate';
    case BUNDLE = 'bundle';
    case ACCESSORY = 'accessory';

    public function label(): string
    {
        return match ($this) {
            self::CROSS_SELL => 'Cross Sell',
            self::UP_SELL => 'Up Sell',
            self::ALTERNATE => 'Alternate',
            self::BUNDLE => 'Bundle',
            self::ACCESSORY => 'Accessory',
        };
    }
}
Then update config/lunar/products.php to point to the custom enum: 
return [
    'association_types_enum' => \App\Enums\ProductAssociation::class,
];
The admin panel reads from this configuration automatically. The custom types will appear in the association type dropdown when creating or viewing product associations, with no additional setup required.
The enum must be a backed string enum, and each case must implement a label() method that returns the human-readable name. See the Associations reference for full details on using custom types in application code.