Traductions sans effort avec l'IA dans Laravel Nova

Photo par Cherry Lin sur Unsplash

Entrez dans le SharpAPI AI Translator pour Laravel Nova. Ce package intègre sans effort la traduction alimentée par l'IA directement dans votre tableau de bord Nova, éliminant les tâches de traduction répétitives et vous libérant pour vous concentrer sur les choses importantes.

Vous voulez voir tous les détails du package ? Rendez-vous sur GitHub : https://github.com/sharpapi/nova-ai-translator

Si vous utilisez spatie/laravel-translatable, nous supposons également que vous savez déjà comment configurer leur https://github.com/spatie/nova-translatable

Que fait exactement ce package ?

En un mot, il combine le package laravel-translatable de Spatie avec les super-pouvoirs de l'IA de SharpAPI, transformant ces champs de contenu dans votre application en ressources facilement traduisibles. Le résultat ? Une nouvelle action sur votre tableau de bord Nova appelée 🤖 Initiate AI Translation qui prend en charge le travail de traduction pour vous.

Depuis la liste des ressources Nova ou l'écran d'édition, vous pouvez programmer des traductions entre toutes les langues configurées directement dans Nova, avec l'IA qui prend le relais dès que vous appuyez sur le bouton. Besoin de traduire un article de blog de l'anglais vers l'espagnol ? C'est géré.

Pour qui est-ce fait ?

Si vous êtes un utilisateur de Laravel Nova gérant du contenu dans plusieurs langues, ce package est pour vous. Il est idéal pour les équipes qui travaillent régulièrement avec des applications internationalisées et qui ont besoin de contenu rapidement traduit sans passer manuellement par Google Translate. Imaginez tout le temps économisé lorsque votre contenu se traduit automatiquement directement depuis Nova !

Configuration du SharpAPI AI Translator

Exigences

Assurez-vous de faire fonctionner :

• Laravel : ^9.0+
• Laravel Nova : 4.0+
• PHP : 8.0+
• Et avoir installé spatie/laravel-translatable

Vous aurez également besoin d'un compte sur SharpAPI.com pour accéder à l'API, mais nous y reviendrons.

Installation

• Installer le package :

composer require sharpapi/nova-ai-translator

• Configurer l'accès à l'API :

Ajoutez votre clé API de SharpAPI à votre .env :

SHARP_API_KEY=your-sharp-api-key

• Configurer les langues prises en charge :

Définissez vos locales dans config/app.php sous la clé locales :

return [
   'locales' => [
       'en' => 'English',
       'es' => 'Spanish',
       'fr' => 'French',
       // Ajoutez toutes les autres langues dont votre application a besoin
   ],
];

• Ajouter à vos modèles de ressources Nova :

Vos modèles traduisibles doivent utiliser :

• Le trait HasTranslations de Spatie.
• [Fortement recommandé] Les traits Actionable et Notifiable pour suivre les actions.

Voici une configuration rapide pour, disons, un modèle BlogPost :

namespace App;

use Laravel
ova	rait;Nova	rait;Nova	rait;
use Spatie	rait;Translatable	rait;

class BlogPost
{
   use Actionable, Notifiable, HasTranslations;
   protected $translatable = ['title', 'subtitle', 'content'];
}

• Intégrer l'action TranslateModel :

Connectez l'action TranslateModel à votre ressource Nova en l'ajoutant au tableau des actions :

use SharpAPI	rait;NovaAiTranslator	rait;

public function actions()
{
   return [
       (new TranslateModel())->enabled(),
   ];
}

• Activer les files d'attente :

Cette action utilise une file d'attente pour gérer les traductions de manière asynchrone, assurez-vous donc que votre file d'attente est prête à fonctionner.

Utilisation de l'action TranslateModel dans Nova

Une fois intégrée, l'action se trouve directement dans votre ressource Nova. Voici comment cela fonctionne :

• Lancer la traduction par IA :

Ouvrez l'action soit depuis la liste des ressources, soit depuis la vue d'édition de toute ressource.

Exemple : Déclencher l'action depuis la vue d'édition

• Sélectionner les paramètres de traduction :

Un formulaire vous permet de choisir les langues source et cible et même de définir le ton. Vous verrez également une liste des champs qui seront traduits, donc pas de surprises.

• Appuyez sur Traduire et détendez-vous :

Une fois que vous avez confirmé, l'action vérifie si les champs cibles sont déjà remplis. S'ils le sont, elle vous suggère gentiment de les effacer avant de continuer. En supposant que tout soit en ordre, elle met en file d'attente le travail de traduction. Vous pouvez même garder un œil dessus si vous utilisez les traits Actionable et Notifiable.

• Suivre les progrès et les journaux :

La fonction de journal des actions de Nova aide à suivre les traductions. Cela est pratique si vous avez besoin de déboguer des problèmes ou si vous aimez simplement voir l'IA en action.

Exemple : Journal de traduction en action

Exemple : Gestion des erreurs (si cela se passe mal)

Astuces et conseils

• Configurez et oubliez : Cette configuration vous permet de mettre en file d'attente les traductions sans vous soucier du moment ou de la charge. Elle est particulièrement utile pour faire évoluer les applications multilingues sans augmenter les tâches de traduction.
• Stratégie de traduction : Ajustez la fréquence à laquelle vous déclenchez les traductions en fonction du volume et de la fréquence des mises à jour de contenu.
• Besoins de localisation ? : Comme cette configuration s'intègre avec spatie/laravel-translatable, vous obtenez le meilleur des deux mondes : une localisation structurée avec la puissance d'une traduction par IA.

Avec SharpAPI AI Translator pour Laravel Nova, le jeu de traduction de votre application vient de recevoir une énorme mise à niveau avec ses nouvelles capacités Laravel AI. Essayez-le, et faites-nous savoir comment cela fonctionne pour vous !