EUCA

Damit Nachrichten E-Mails versenden können muss entsprechende E-Mail-Server und Template Konfiguration vorhanden sein.

Beispiel-Konfig mesh-plugins/acta-nova/config.yml



mail:

  sendMails: false                           # Boolean to enable/disable sending emails (default: false)

                                             # ENV: MESH_PLUGIN_ACTA_NOVA_MAIL_SEND_MAILS

  sender: "noreply@gentics.com"              # Email address used as sender for notification emails

                                             # ENV: MESH_PLUGIN_ACTA_NOVA_MAIL_SENDER



  smtp:

    hostname: "smtp.example.com"             # Hostname of the SMTP server

                                             # ENV: MESH_PLUGIN_ACTA_NOVA_MAIL_SMTP_HOSTNAME

    port: 587                                # Port of the SMTP server (e.g., 587 for TLS, 465 for SSL)

                                             # ENV: MESH_PLUGIN_ACTA_NOVA_MAIL_SMTP_PORT

    username: "user@example.com"             # Username for SMTP server authentication

                                             # ENV: MESH_PLUGIN_ACTA_NOVA_MAIL_SMTP_USERNAME

    password: "securepassword"               # Password for SMTP server authentication

                                             # ENV: MESH_PLUGIN_ACTA_NOVA_MAIL_SMTP_PASSWORD

    ssl: false                               # Whether to use SSL for connecting to the SMTP server

                                             # ENV: MESH_PLUGIN_ACTA_NOVA_MAIL_SMTP_SSL

    sslTrustAll: false                       # Whether to trust all SSL certificates

                                             # ENV: MESH_PLUGIN_ACTA_NOVA_MAIL_SMTP_SSL_TRUST_ALL



  mailProjectMapping:                        # Project-specific email configurations

                                             # No direct ENV variable for this field

    default:

      templatePath: "/templates/notificationCreated_andp_%s.hbs"  # Path to the email template

      portalBaseUrl: "${ANDP_MAIL_PORTALURL_DEFAULT}"             # Base URL for the portal

mailProjectMapping:

Es gibt Anwendungsfälle in denen unterschiedliche Mail-Templates je Portal verwendet werden sollen. Loggt sich ein User das erste mal ein, dann wird das aktuelle verwendete Portal (der Mesh Project Name) in seinen Einstellungen gespeichert. z.B. "DialogPortal"

Bekommt dieser User nun eine Nachricht wird ein mailProjectMapping "DialogPortal" gesucht und für den E-Mail-Versand (Template + Base-URL) herangezogen. Es sollte aber immer auch als Fallback ein default Mapping vorhanden sein.



  mailProjectMapping:                        

    default:

      templatePath: "/templates/notificationCreated_andp_%s.hbs"  # Path to the email template

      portalBaseUrl: "${ANDP_MAIL_PORTALURL_DEFAULT}"  

    DialogPortal:

      templatePath: "/templates/notificationCreated_dialogportal_%s.hbs"  # Path to the email template for Dialogportal

      portalBaseUrl: "${ANDP_MAIL_PORTALURL_DIALOGPORTAL}"

Der templatePath ist der Pfad zum E-Mail-Templatate im Mesh-Acta-Nova-Plugin Storage Directory (z.b. /mesh-plugins/acta-nova/storage/templates/....)

Das "_%s" wird durch die Sprache der Nachricht (definiert in ActaNova) ersetzt, z.B. durch "de-AT". Als Fallback wird aber immer auch nach einem Handlebars Template ohne "_%s" gesucht.

Die Base-URL sollte die URL zum Portal beinhalten (damit die Verlinkung im E-Mail korrekt ist). Hier kann entweder hardcoded eine URL definiert werden (z.B. https://actanova-dialogportal.at) oder eine ENV Variable verwendet werden (siehe Beispiel). Wichtig: die ENV Variable muss aus Security Gründen einen speziellen Namen haben: ANDP_MAIL_PORTALURL_XXX, wobei nur das XXX frei gewählt werden kann.

E-Mail Konfiguration