lemon-development/lunarphp-bulgaria-shipping

LunarPHP shipping drivers for Bulgaria (Econt, Speedy)

dev-main 2025-12-13 18:53 UTC

Requires

• php: ^8.2
• lunarphp/core: ^1.0

MIT

README

A LunarPHP 1.x add-on that provides shipping drivers for Bulgarian couriers.

• ✅ Econt shipping driver (planned)
• ✅ Speedy shipping driver (planned)

Status: WIP – package is published and installable; courier integrations and admin settings are being implemented.

Requirements

• PHP 8.2+
• Lunar 1.x (lunarphp/core)

Installation

Install via Packagist

composer require lemon-development/lunarphp-bulgaria-shipping

Laravel package auto-discovery will register the service provider automatically.

Development install (local path)

If you are developing this package inside your Lunar app (monorepo-style):

1. Put the package here:

<your-app>/packages/lemon-development/lunarphp-bulgaria-shipping

1. Add a path repository to your app composer.json:

{
  "repositories": [
    {
      "type": "path",
      "url": "packages/lemon-development/lunarphp-bulgaria-shipping",
      "options": { "symlink": true }
    }
  ]
}

1. Require the package:

composer require lemon-development/lunarphp-bulgaria-shipping:"*"

Usage

Once drivers are implemented, you will be able to select courier drivers when creating Shipping Methods in the Lunar admin panel.

Typical flow:

1. Create a Shipping Zone
2. Create a Shipping Method
3. Choose the driver (Econt / Speedy)
4. Configure the method and rates/options

Configuration

Configuration and admin UI are coming in a future release.

Planned settings include:

• API credentials (test/live)
• services (to address / to office)
• office/pickup selection support
• optional COD (cash on delivery)
• optional delivery-time estimates

Development

After changing package code in a linked project:

composer dump-autoload
php artisan optimize:clear

License

MIT