Mail

📧 Powerful, Flexible Email Templating for MedusaJS

Нужна доработка этого плагина?

Связаться с нами

npm install @vymalo/medusa-mail

Категория

notification

Создано

Community

Версия

1.0.9

Последнее обновление

7 месяцев назад

Звезды на Github

NPM Github

Medusa ПлагиныMail

MedusaJS Mail Templates

📧 Powerful, Flexible Email Templating for MedusaJS

🌟 Features

Advanced email template generation
Nodemailer integration
SMTP and transport flexibility
Preview and development modes
Internationalization support
Extensive customization options

📦 Installation

Install the package using npm:


npm install @vymalo/medusa-mail

Or using yarn:


yarn add @vymalo/medusa-mail

🔧 Configuration Types


interface EmailConfig<T = any> {
  // Nodemailer message configuration
  message?: Mail.Options;

  // Email transport options
  transport?: NodeMailerTransportOptions;

  // Template views and rendering
  views?: View;

  // Send behavior control
  send?: boolean;
  preview?: boolean | PreviewEmailOpts;

  // Advanced rendering options
  customRender?: boolean;
  render?: (view: string, locals?: T) => Promise<any>;
  
  // Internationalization
  i18n?: any;

  // Rendering configurations
  textOnly?: boolean;
  htmlToText?: HtmlToTextOptions | false;
  
  // Subject line customization
  subjectPrefix?: string | false;

  // HTML inlining and styling
  juice?: boolean;
  juiceSettings?: JuiceGlobalConfig;
  juiceResources?: juice.Options;

  // Custom template path resolution
  getPath?: (path: string, template: string, locals: any) => string;
}

🚀 Usage Example


modules: [
  {
    resolve: "@medusajs/medusa/notification",
    options: {
      providers: [
        {
          resolve: `@vymalo/medusa-mail`,
          id: "email-provider",
          options: {
            // Basic configuration
            channels: ["email"],
            message: {
              from: "no-reply@yourcompany.com"
            },
            
            // Environment-specific settings
            send: process.env.NODE_ENV === "production",
            preview: process.env.NODE_ENV !== "production",
            
            // Transport configuration
            transport: "smtp://localhost:1025",
            
            // Advanced customizations
            subjectPrefix: process.env.NODE_ENV !== "production" 
              ? `[${process.env.NODE_ENV.toUpperCase()}]` 
              : false,
            
            // HTML to text conversion
            htmlToText: {
              wordwrap: 130,
              preserveNewlines: true
            }
          },
        },
      ],
    },
  }
]