PHP code example of digitalpulsebe / craft-deepl-translator

1. Go to this page and download the library: Download digitalpulsebe/craft-deepl-translator library. Choose the download type require.

2. Extract the ZIP file and open the index.php.

3. Add this code to the index.php.
    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

digitalpulsebe / craft-deepl-translator example snippets


use digitalpulsebe\craftmultitranslator\events\ElementTranslationEvent;
use digitalpulsebe\craftmultitranslator\services\TranslateService;

Event::on(
    TranslateService::class,
    TranslateService::EVENT_BEFORE_ELEMENT_TRANSLATION,
    function (ElementTranslationEvent $event) {
        $sourceElement = $event->sourceElement;
        $sourceSite = $event->sourceSite;
        $targetSite = $event->targetSite;
    
        if ($sourceSite->handle == 'disabledSite') {
            $event->isValid = false; // cancel translation for this scenario
        }
    }
);

use digitalpulsebe\craftmultitranslator\events\ElementTranslationEvent;
use digitalpulsebe\craftmultitranslator\services\TranslateService;
use digitalpulsebe\craftmultitranslator\MultiTranslator;

Event::on(
    TranslateService::class,
    TranslateService::EVENT_AFTER_ELEMENT_TRANSLATION,
    function (ElementTranslationEvent $event) {
        $event->targetElement->slug = MultiTranslator::getInstance()->translate->translateText(
            $event->sourceSite->language,
            $event->targetSite->language,
            $event->sourceElement->slug
        );
    }
);

use digitalpulsebe\craftmultitranslator\events\FieldTranslationEvent;
use digitalpulsebe\craftmultitranslator\services\TranslateService;

Event::on(
    TranslateService::class,
    TranslateService::EVENT_BEFORE_FIELD_TRANSLATION,
    function (FieldTranslationEvent $event) {
        if ($event->field->handle == 'fieldTable') {
            $event->isValid = false; // cancel translation for this field
        }
    }
);

use digitalpulsebe\craftmultitranslator\events\FieldTranslationEvent;
use digitalpulsebe\craftmultitranslator\services\TranslateService;

Event::on(
    TranslateService::class,
    TranslateService::EVENT_AFTER_FIELD_TRANSLATION,
    function (FieldTranslationEvent $event) {
        if ($event->field->handle == 'body') {
            $event->translatedValue = 'CUSTOM VALUE';
        }
    }
);



namespace myplugin\providers;

use craft\helpers\App;
use digitalpulsebe\craftmultitranslator\providers\Provider;

class GeminiProvider extends Provider
{
    public static function getHandle(): string
    {
        return 'gemini';
    }

    public static function getDisplayName(): string
    {
        return 'Google Gemini';
    }

    public function getSettingsTemplatePath(): ?string
    {
        // Path to a Twig template that renders your provider's settings fields.
        // Return null if the provider needs no configurable settings.
        return 'my-plugin/_providers/gemini/_settings';
    }

    public function isConnected(): bool
    {
        try {
            // Perform a lightweight connectivity check.
            return !empty($this->getSetting('apiKey'));
        } catch (\Throwable $e) {
            return false;
        }
    }

    public function translate(string $sourceLocale = null, string $targetLocale = null, string $text = null): ?string
    {
        if (empty($text)) {
            return null;
        }

        $apiKey = App::parseEnv($this->getSetting('apiKey', ''));
        $model  = $this->getSetting('model', 'gemini-2.0-flash');

        // ... call the Gemini API and return the translated string ...

        return null;
    }
}

use digitalpulsebe\craftmultitranslator\events\RegisterApiProvidersEvent;
use digitalpulsebe\craftmultitranslator\services\TranslateService;
use yii\base\Event;

Event::on(
    TranslateService::class,
    TranslateService::EVENT_REGISTER_API_PROVIDERS,
    function (RegisterApiProvidersEvent $event) {
        $event->providers[] = \myplugin\providers\GeminiProvider::class;
    }
);
bash
composer 
bash
ddev composer