DocumentationSDK sur GitHub

Documentation Guides pratiques

Configurer l’éditeur

Réglez l’apparence, la langue, le mode et les fonctionnalités disponibles.

Sur cette page

Définir les réglages par défaut

Enregistrez les réglages dans le tableau de bord. Les options de montage explicites priment sur editorConfig ; les valeurs omises viennent du tableau de bord. Le SDK ne peut pas activer une fonction bloquée par le service, l’abonnement ou le tableau de bord.

Changer l’apparence et la langue

theme habille l’interface de l’éditeur. Pour modifier le design de l’email, utilisez ses propres réglages. locale accepte en, fr ou es. Le texte rédigé est conservé ; les libellés des minuteurs suivent la langue de l’interface.

typescript
import { mount } from '@weavour/editor';

const editor = mount('#email-editor', {
  editorKey: 'YOUR_PUBLIC_EDITOR_KEY',
  userId: 'user-123',
  locale: 'en',
  theme: {
    mode: 'light',
    primaryColor: '#6b59d0',
    shellColor: '#f7f8fc',
    inputColor: '#ffffff',
    fontFamily: 'Inter',
    cornerRadius: 8,
    density: 'compact',
  },
  onError: console.error,
});

await editor.ready;
editor.updateConfig({ theme: { mode: 'dark' }, locale: 'fr' });

Passer de l’édition à l’aperçu

Définissez mode au montage ou appelez updateConfig({ mode: 'preview' }). Utilisez edit pour reprendre l’édition. Le contenu et l’historique d’annulation sont conservés ; les autres modes suspendent la sauvegarde automatique. Ces modes nécessitent le SDK 0.1.7 et un éditeur hébergé compatible.

typescript
// Call these from your application's preview and edit actions.
function showPreview() {
  editor.updateConfig({ mode: 'preview' });
}

function resumeEditing() {
  editor.updateConfig({ mode: 'edit' });
}

Choisir les blocs et fonctions

allowedBlocks filtre la palette d’insertion. Un tableau vide masque toutes les entrées ; le contenu existant est conservé. Les options de fonctionnalités s’appliquent au montage ou via updateConfig().

Les blocs d’organisation nécessitent userId et organizationId. Désactivez enableOrganizationBlocks pour masquer l’enregistrement et la réutilisation, tout en conservant les blocs sauvegardés. Avant de désactiver la sauvegarde automatique, terminez les écritures à conserver.

typescript
// Run on your mounted editor instance.
editor.updateConfig({
  allowedBlocks: ['text', 'heading', 'image', 'button', 'section', 'columns'],
  enableTemplates: true,
  enableEmailAudit: true,
  enableTestEmail: false,
  enableOrganizationBlocks: false, // Hide organization block saving and reuse.
});

// Opt out of hosted drafts when your application manages persistence.
editor.updateConfig({ enableAutosave: false });

Blocs personnalisés

Passez customBlocks pour enregistrer les blocs définis par votre application. Chaque définition fournit des valeurs JSON initiales, des contrôles et un rendu HTML. Ces blocs suivent les blocs standard dans la même grille. Ajoutez custom:<id> à toute liste allowedBlocks explicite.

Activer l’IA

Configurez les crédits gérés ou votre clé OpenAI dans le tableau de bord. Ne transmettez jamais de clé fournisseur au SDK. L’IA nécessite un accès payant dans les deux cas.

Besoin d’aide ? Contactez-nous