Étendre Lekalao

Lekalao est une application Laravel : un fournisseur de services suffit pour remplacer une pièce par la vôtre. Gardez vos extensions dans un fournisseur à part (par exemple app/Providers/InstallationServiceProvider.php), pour que les mises à jour ne les écrasent pas.

Les pays des lecteurs

Lekalao n’embarque aucune base de géolocalisation : elles sont lourdes, vieillissent vite et leurs licences varient. Sans elle, la colonne Pays des statistiques reste vide ; tout le reste fonctionne. Pour l’afficher, implémentez App\Domain\Analytics\Contracts\GeoLocator :

app/Support/MaxMindGeoLocator.php

namespace App\Support;

use App\Domain\Analytics\Contracts\GeoLocator;
use GeoIp2\Database\Reader;
use Throwable;

class MaxMindGeoLocator implements GeoLocator
{
    public function __construct(private readonly Reader $reader) {}

    public function country(?string $ip): ?string
    {
        if ($ip === null) {
            return null;
        }

        try {
            return $this->reader->country($ip)->country->isoCode;
        } catch (Throwable) {
            return null;
        }
    }
}

app/Providers/InstallationServiceProvider.php

use App\Domain\Analytics\Contracts\GeoLocator;
use App\Support\MaxMindGeoLocator;
use GeoIp2\Database\Reader;

public function register(): void
{
    $this->app->singleton(GeoLocator::class, fn () => new MaxMindGeoLocator(
        new Reader(storage_path('app/GeoLite2-Country.mmdb')),
    ));
}

L’adresse IP n’est jamais enregistrée : elle sert à trouver le pays, puis elle est oubliée. Renvoyez un code à deux lettres (CM, FR) ou null.

Une passerelle de paiement

App\Domain\Billing\Gateways\BillingGateway décrit ce qu’une passerelle doit savoir faire :

Méthode	Rôle
`name()`	Le nom enregistré sur chaque paiement.
`checkout(Payment, string $returnUrl)`	Démarre un paiement et renvoie un `Checkout` : référence, adresse où envoyer le client.
`status(Payment)`	Demande à la passerelle où en est un paiement (bouton Vérifier à nouveau).
`verifyWebhook(Request)`	Vérifie qu’un appel vient bien de la passerelle.
`readWebhook(Request)`	Extrait la référence et le nouveau statut d’un appel, ou `null`.

Les appels de la passerelle arrivent sur POST /webhooks/billing. Branchez la vôtre dans AppServiceProvider, là où LEKALAO_BILLING_GATEWAY est lu, ou redéfinissez la liaison :

$this->app->bind(BillingGateway::class, fn () => new MaPasserelle(config('services.ma_passerelle')));

Un fournisseur d’envoi

Les fournisseurs proposés (SMTP, Amazon SES, Postmark, Mailgun, SendGrid, Brevo, Resend) sont décrits dans App\Domain\Settings\Enums\MailerTransport : champs du formulaire, configuration du transport Symfony Mailer, lecture des retours. Pour un nouveau fournisseur, ajoutez un cas à cette énumération, en suivant un fournisseur existant.

Les langues de l’interface

Ajoutez un fichier lang/{code}.json avec toutes les chaînes de lang/fr.json, et déclarez la langue dans config/lekalao.php, clé locales.

Ces points d’extension restent stables d’une version à l’autre. Le reste du code peut changer : évitez de modifier les fichiers de Lekalao directement.

Installer

Exploiter

Vendre le service

Étendre Lekalao

Les pays des lecteurs

Une passerelle de paiement

Un fournisseur d’envoi

Les langues de l’interface

​Les pays des lecteurs

​Une passerelle de paiement

​Un fournisseur d’envoi

​Les langues de l’interface

Les pays des lecteurs

Une passerelle de paiement

Un fournisseur d’envoi

Les langues de l’interface