Avaa sähköpostijärjestelmä PHP:n kautta

Oppaan tavoite

Huom: Tämä opas on suunnattu kehittäjille ja näyttää, kuinka bluetronix CMS:n integroitu sähköpostijärjestelmä voidaan kutsua suoraan PHP:lla.

Bluetronix CMS tarjoaa keskeisiä PHP-toimintoja sähköpostin lähettämiseen.

Näin ollen SMTP-yhteyksiä, sähköpostitilejä ja peruslähetysominaisuuksia ei tarvitse ohjelmoida uudelleen jokaista PHP-skriptiä varten.

Suoran sähköpostin ja uutiskirjeiden lähettämiseen on seuraava toiminto käytettävissä:

BlueSMTPMail($MailType,$MailAccount,$SMTPType,$From,$To,$NewsletterTo,$Subject,$TextContent,$HTMLContent,$Attachments,$EmbedImages,$MailPlaceholderReplacement,$FormEntry);

Lomake-sähköpostien lähettämiseen on lisäksi seuraava toiminto käytettävissä:

BlueFormSend($SMTPType,$SendMail,$SendSubject,$CopyToCustomer,$TextToCustomer,$FormArchive,$FormID,$SendTo);

BlueSMTPMail()

BlueSMTPMail() avulla voidaan lähettää normaaleja sähköposteja ja uutiskirjeitä bluetronix CMS:n keskitetyn sähköpostijärjestelmän kautta.

Toimintokutsu on:

BlueSMTPMail(
   $MailType,
   $MailAccount,
   $SMTPType,
   $From,
   $To,
   $NewsletterTo,
   $Subject,
   $TextContent,
   $HTMLContent,
   $Attachments,
   $EmbedImages,
   $MailPlaceholderReplacement,
   $FormEntry
);

$MailType

Määrittelee, minkä tyyppinen sähköposti lähetetään.

Mahdolliset arvot:

Mail
Newsletter

Esimerkki:

$MailType = "Mail";

tai:

$MailType = "Newsletter";

$MailAccount

$MailAccount määrittelee sähköpostitilin, jonka SMTP-asetuksia käytetään.

Tämän arvon avulla ladataan vastaavat SMTP-konfiguraatiotiedot CMS:n tietokantatauluista.

Mikä konfiguraatio käytetään, riippuu lisäksi $SMTPType:sta.

$SMTPType

Määrittelee, käytetäänkö sisäistä vai ulkoista sähköpostitiliä.

Mahdolliset arvot:

Intern
Extern

Sisäinen

Kohdassa:

$SMTPType = "Intern";

käytetään sähköpostitiliä, joka on asetettu suoraan bluetronix CMS:ään.

Tilin tiedot löytyvät täältä:

Email → Accounts

Kohdassa $From käytettävä lähettäjäosoite on oltava olemassa tilinä.

Ulkoinen

Kohdassa:

$SMTPType = "Extern";

käytetään ulkoisia SMTP-kirjautumistietoja.

Näitä hallitaan CMS:ssä kohdassa:

Email → Server - Extern

.

Lähettäjän osoite, jota käytetään $From, on asetettava oikealla tavalla.

$From

Sisältää lähettäjän sähköpostiosoitteen.

Esimerkki:

$From = "info@example.com";

Sähköpostiosoitteen on vastattava valittua SMTP-konfiguraatiota.

$To

Sisältää tavallisen sähköpostin vastaanottajan sähköpostiosoitteen.

Esimerkki:

$To = "customer@example.com";

Tavallisen sähköpostin lähetyksessä tätä muuttujaa käytetään vastaanottajana.

$NewsletterTo

$NewsletterTo käytetään uutiskirjeiden lähettämisessä.

Muuttuja sisältää useita sähköpostiosoitteita tekstinä. Kukin sähköpostiosoite on erotettu rivinvaihdolla.

Esimerkki:

$NewsletterTo = "customer1@example.com\ncustomer2@example.com\ncustomer3@example.com";

$Subject

Sisältää sähköpostin aiheen.

Esimerkki:

$Subject = "Welcome to our website";

$TextContent

Sisältää sähköpostin pelkän tekstiosuuden.

Tätä osaa voivat käyttää esimerkiksi sähköpostiohjelmat, jotka eivät voi esittää HTML-sähköposteja.

Esimerkki:

$TextContent = "Thank you for your request.";

$HTMLContent

Sisältää sähköpostin HTML-osuuden.

Esimerkki:

$HTMLContent = "<h1>Thank you</h1><p>Thank you for your request.</p>";

Tällä voidaan lähettää muotoiltuja sähköposteja, joissa on otsikoita, tekstejä, linkkejä, kuvia ja muita HTML-elementtejä.

$Attachments

$Attachments avulla voidaan liittää tiedostoja sähköpostiin.

Tiedostot ilmoitetaan niiden polun perusteella verkkosivustolla.

Esimerkki:

$Attachments = "/bx_doc/Intro.pdf";

Useiden liitteiden kohdalla yksittäiset tiedostopolut erotetaan rivinvaihdolla.

Esimerkki:

$Attachments = "/bx_doc/Intro.pdf\n/bx_doc/PriceList.pdf";

$EmbedImages

$EmbedImages avulla voidaan määrätä, tullaanko kuvia upottamaan suoraan sähköpostiin.

Esimerkki:

$EmbedImages = "ja";

Kun vaihtoehto on valittu, HTML-sähköpostissa käytetyt kuvat integroidaan suoraan sähköpostiin eikä niitä ladata pelkästään ulkoisista URL-osoitteista.

Tällä tavoin kuvat voivat olla vastaanottajalle suoraan saatavilla sähköpostissa ilman, että niitä tarvitsee ensin ladata erikseen verkkopalvelimelta.

$MailPlaceholderReplacement

$MailPlaceholderReplacement avulla voidaan korvata paikkamerkit kohdassa:

$TextContent
$HTMLContent

yksilöllisillä arvoilla.

Periaate on:

Search
   ↓
Replace

Tällä tavoin voidaan esimerkiksi luoda personoituja sisältöjä sähköpostiin.

Tyypillisiä käyttötarkoituksia ovat:

• Name des Empfängers
• Kundennummer
• Bestellnummer
• individuelle Links
• weitere dynamische Inhalte

$FormEntry

$FormEntry avulla voidaan määrätä, tallennetaanko lähetys lisäksi lomarchive.

Kohdassa:

$FormEntry = "JA";

lisäksi tietokantataulussa:

00_form

tallennettu.

Näin lähetys voidaan dokumentoida samanaikaisesti lomake- tai arkistotietona.

Esimerkki: Lähetä normaali sähköposti

Seuraava esimerkki lähettää tavallisen HTML- ja tekstisähköpostin sisäisestä sähköpostitilistä.

$MailType                  = "Mail";
$MailAccount               = "info@example.com";
$SMTPType                  = "Intern";
$From                      = "info@example.com";
$To                        = "customer@example.com";
$NewsletterTo              = "";
$Subject                   = "Your request";
$TextContent               = "Thank you for your request.";
$HTMLContent               = "<h1>Thank you</h1><p>Thank you for your request.</p>";
$Attachments               = "/bx_doc/Intro.pdf";
$EmbedImages               = "ja";
$MailPlaceholderReplacement = "";
$FormEntry                 = "NEIN";

BlueSMTPMail($MailType,$MailAccount,$SMTPType,$From,$To,$NewsletterTo,$Subject,$TextContent,$HTMLContent,$Attachments,$EmbedImages,$MailPlaceholderReplacement,$FormEntry);

Prosessi yksinkertaistettuna:

PHP
   ↓
BlueSMTPMail()
   ↓
internen Mail-Account laden
   ↓
SMTP-Verbindung verwenden
   ↓
E-Mail erzeugen
   ↓
E-Mail versenden
   ↓
MailCache-Eintrag erzeugen

Esimerkki: Lähetä uutiskirje

Uutiskirjeelle asetetaan $MailType:

Newsletter

arvo.

Vastaanottajat annetaan sen jälkeen $NewsletterTo avulla.

$MailType                  = "Newsletter";
$MailAccount               = "newsletter@example.com";
$SMTPType                  = "Intern";
$From                      = "newsletter@example.com";
$To                        = "";
$NewsletterTo              = "customer1@example.com\ncustomer2@example.com\ncustomer3@example.com";
$Subject                   = "Our latest news";
$TextContent               = "Discover our latest news and products.";
$HTMLContent               = "<h1>Our latest news</h1><p>Discover our latest news and products.</p>";
$Attachments               = "";
$EmbedImages               = "ja";
$MailPlaceholderReplacement = "";
$FormEntry                 = "NEIN";

BlueSMTPMail($MailType,$MailAccount,$SMTPType,$From,$To,$NewsletterTo,$Subject,$TextContent,$HTMLContent,$Attachments,$EmbedImages,$MailPlaceholderReplacement,$FormEntry);

Yksittäiset uutiskirjeen vastaanottajat erotetaan $NewsletterTo -kentässä rivinvaihdoilla.

Käytä ulkoista SMTP-yhteyttä

Jos ulkoista sähköpostipalvelinta halutaan käyttää, asetetaan:

$SMTPType = "Extern";

arvo.

SMTP-tunnistetiedot on ensin asetettava:

Email → Server - Extern

ennen kuin ne voidaan käyttää.

Esimerkki:

$SMTPType    = "Extern";
$From        = "mail@external-domain.com";
$MailAccount = "mail@external-domain.com";

BlueFormSend()

Lisäksi suoran sähköpostin lähetyksen ohella on saatavana toiminto:

BlueFormSend($SMTPType,$SendMail,$SendSubject,$CopyToCustomer,$TextToCustomer,$FormArchive,$FormID,$SendTo);

tätä varten.

Tämä toiminto on erityisesti tarkoitettu sähköpostin lähettämiseen CMS-lomakkeiden yhteydessä.

Muuttujat ovat jo täysin englanninkielisessä muodossa.

BlueFormSend()-funktion parametrit

MailCache

Jokainen BlueSMTPMail() -kutsu luo lisäksi merkinnän tietokannan tauluun:

00_MailCache

Tämän taulun kautta voit tarkistaa sähköpostin lähetysstatuksen.

Siitä voidaan esimerkiksi tarkistaa, onko sähköposti käsitelty tai lähetetty onnistuneesti.

MailCache-merkinnät ovat käytössä:

1 Woche

tallennettu.

Tyypillinen sähköpostin lähetysprosessi

PHP-Skript
   ↓
BlueSMTPMail()
   ↓
MailType prüfen
   ↓
MailAccount auswählen
   ↓
SMTPType prüfen
   ↓
SMTP-Konfiguration laden
   ↓
Empfänger bestimmen
   ↓
Text- und HTML-Inhalt erstellen
   ↓
Platzhalter ersetzen
   ↓
Anhänge hinzufügen
   ↓
Bilder gegebenenfalls einbetten
   ↓
E-Mail versenden
   ↓
00_MailCache aktualisieren
   ↓
optional 00_form speichern

BlueSMTPMail-parametrien yleiskatsaus

Zusammenfassung

bluetronix CMS:n keskitetty sähköpostijärjestelmä voidaan kutsua suoraan omasta PHP-koodista.

Für normalen E-Mail- und Newsletter-Versand wird verwendet:

BlueSMTPMail($MailType,$MailAccount,$SMTPType,$From,$To,$NewsletterTo,$Subject,$TextContent,$HTMLContent,$Attachments,$EmbedImages,$MailPlaceholderReplacement,$FormEntry);

CMS-lomakkeille on lisäksi saatavilla:

BlueFormSend($SMTPType,$SendMail,$SendSubject,$CopyToCustomer,$TextToCustomer,$FormArchive,$FormID,$SendTo);

Die SMTP-Konfiguration kann entweder über:

Sisäinen
→ Sähköposti → Tilit

tai:

Extern
→ Email → Server - Extern

erfolgen.

Jokainen sähköpostin lähetys tapahtuu lisäksi seuraavasti:

00_MailCache

protokolliert. Die entsprechenden Cache-Einträge bleiben eine Woche erhalten.

Tämä mahdollistaa kehittäjien käyttää bluetronix CMS:n jo olemassa olevaa sähköpostijärjestelmää suoraan omista PHP-skripteistään, ilman että heidän tarvitsee itse toteuttaa koko SMTP-logiikkaa.