Szolgáltatói konstansok

Minden szolgáltatóhoz tartoznak konstansok, amelyek felülírják az integráció beállításait. Mindegyik opcionális, a wp-config.php fájlba kell őket tenni. A példákban az alapértelmezett érték áll. Az integráció bekapcsolásához a három kötelező konstans is kell.

Közös konstansok

A legtöbb szolgáltatónál ugyanazok a konstansok szerepelnek, csak a névben lévő szolgáltatói előtag változik (a táblázatban ELŐTAG; a konkrét előtagot a szolgáltatónkénti szakasz mutatja).

Konstans	Típus	Mit állít
GRAVITYSMTP_ELŐTAG_ACTIVE	igaz/hamis	Az integráció aktív-e.
GRAVITYSMTP_ELŐTAG_ENABLED	igaz/hamis	Az integráció engedélyezett-e.
GRAVITYSMTP_ELŐTAG_CONFIGURED	igaz/hamis	Az integráció be van-e állítva.
GRAVITYSMTP_ELŐTAG_FROM_EMAIL	szöveg	A kimenő levelek feladó e-mail-címe.
GRAVITYSMTP_ELŐTAG_FROM_NAME	szöveg	A kimenő levelek feladójának neve.
GRAVITYSMTP_ELŐTAG_REPLY_TO_EMAIL	szöveg	A kimenő levelek válaszcíme.
GRAVITYSMTP_ELŐTAG_FORCE_FROM_EMAIL	igaz/hamis	Minden levélnél erőltesse-e a megadott feladó e-mail-címet.
GRAVITYSMTP_ELŐTAG_FORCE_FROM_NAME	igaz/hamis	Minden levélnél erőltesse-e a megadott feladó nevet.
GRAVITYSMTP_ELŐTAG_FORCE_REPLY_TO_EMAIL	igaz/hamis	Minden levélnél erőltesse-e a megadott válaszcímet.

Az alapérték az igaz/hamis konstansoknál false, a szöveges konstansoknál üres szöveg ('').

define( 'GRAVITYSMTP_BREVO_FROM_EMAIL', '[email protected]' );
define( 'GRAVITYSMTP_BREVO_FROM_NAME', 'Minta Kft.' );
define( 'GRAVITYSMTP_BREVO_FORCE_FROM_EMAIL', true );

Az erőltetés (FORCE_…) azt jelenti, hogy a Gravity SMTP akkor is a megadott értéket használja, ha a levelet küldő kód (egy másik bővítmény) mást állított be.

Egyes szolgáltatóknál a névben a „force” szó kétszer is szerepel a példákban (például GRAVITYSMTP_AMAZON_FORCE_FORCE_FROM_EMAIL, GRAVITYSMTP_MAILCHIMP_FORCE_FORCE_FROM_EMAIL, GRAVITYSMTP_SMTPCOM_FORCE_FORCE_FROM_EMAIL), vagy a SparkPostnál az ACTIVE, CONFIGURED és ENABLED konstans neve a példában …_FORCE_ACTIVE, …_FORCE_CONFIGURED, …_FORCE_ENABLED; vagy a „force” hiányzik belőle. Ezek elírásnak látszanak, a következetes alak a fenti táblázat szerinti …_FORCE_FROM_EMAIL és …_FORCE_FROM_NAME. Ha a konstans nem hat, ellenőrizd a nevét.

Szolgáltatónként

A táblázat mutatja az előtagot és a közös konstansokon felüli saját konstansokat.

Szolgáltató	Előtag	Saját konstansok	Legkorábbi verzió
Amazon SES	AMAZON	ACCESS_KEY_ID, SECRET_ACCESS_KEY, REGION (alapérték: us-east-1), TENANT	1.4
Brevo	BREVO	API_KEY	1.0
Cloudflare Email	CLOUDFLARE	ACCOUNT_ID, API_TOKEN	2.2
Egyéni SMTP	GENERIC	lásd lent	1.1.0
Elastic Email	ELASTIC_EMAIL	API_KEY	1.7.0
Emailit	EMAILIT	API_KEY	2.0.0
Google / Gmail	GOOGLE	CLIENT_ID, CLIENT_SECRET, USE_RETURN_PATH	1.1.0
Mailchimp Transactional	MAILCHIMP	API_KEY	1.5
MailerSend	MAILERSEND	API_KEY	1.7.0
Mailgun	MAILGUN	API_KEY, DOMAIN, REGION (alapérték: us), USE_RETURN_PATH	1.0
Mailjet	MAILJET	API_KEY, API_SECRET	1.8.0
Mailtrap	MAILTRAP	API_KEY, SANDBOX_MODE, SANDBOX_INBOX_ID	2.2
Microsoft 365 / Outlook	MICROSOFT	CLIENT_ID, CLIENT_SECRET, USE_RETURN_PATH	1.1.0
PHP Mail	PHPMAIL	USE_RETURN_PATH	1.1.0
Postmark	POSTMARK	SERVER_API_TOKEN, MESSAGE_STREAM (alapérték: outbound)	1.0
Resend	RESEND	API_KEY	2.0.0
SendGrid	SENDGRID	API_KEY, IP_POOL_NAME, REGION	1.0
SMTP.com	SMTPCOM	API_KEY, CHANNEL_NAME	2.2
SMTP2GO	SMTP2GO	API_KEY	1.7.0
SparkPost	SPARKPOST	API_KEY, ACCOUNT_LOCATION (alapérték: us)	1.8.0
Zoho Mail	ZOHO	CLIENT_ID, CLIENT_SECRET, DATACENTER_REGION (alapérték: United States), USE_RETURN_PATH	1.6.0

A „legkorábbi verzió” az a Gravity SMTP-verzió, amelytől a konstansok működnek.

Amazon SES

define( 'GRAVITYSMTP_AMAZON_ACCESS_KEY_ID', '' );
define( 'GRAVITYSMTP_AMAZON_SECRET_ACCESS_KEY', '' );
define( 'GRAVITYSMTP_AMAZON_REGION', 'us-east-1' );
define( 'GRAVITYSMTP_AMAZON_TENANT', '' );

• GRAVITYSMTP_AMAZON_ACCESS_KEY_ID: az Amazon SES hozzáférési kulcsának azonosítója.
• GRAVITYSMTP_AMAZON_SECRET_ACCESS_KEY: a titkos hozzáférési kulcs.
• GRAVITYSMTP_AMAZON_REGION: az Amazon SES régiója.
• GRAVITYSMTP_AMAZON_TENANT: az Amazon SES bérlő (tenant) neve.

Brevo

define( 'GRAVITYSMTP_BREVO_API_KEY', '' );

A GRAVITYSMTP_BREVO_API_KEY a Brevo API-hoz való hitelesítéshez használt kulcs.

Cloudflare Email

define( 'GRAVITYSMTP_CLOUDFLARE_ACCOUNT_ID', '' );
define( 'GRAVITYSMTP_CLOUDFLARE_API_TOKEN', '' );

• GRAVITYSMTP_CLOUDFLARE_ACCOUNT_ID: a Cloudflare-fiók azonosítója.
• GRAVITYSMTP_CLOUDFLARE_API_TOKEN: az API-token. Mindkettő a Cloudflare Email Service API-hoz való hitelesítéshez kell.

Elastic Email

define( 'GRAVITYSMTP_ELASTIC_EMAIL_API_KEY', '' );

Emailit

define( 'GRAVITYSMTP_EMAILIT_API_KEY', '' );

Google / Gmail

define( 'GRAVITYSMTP_GOOGLE_CLIENT_ID', '' );
define( 'GRAVITYSMTP_GOOGLE_CLIENT_SECRET', '' );
define( 'GRAVITYSMTP_GOOGLE_USE_RETURN_PATH', false );

• GRAVITYSMTP_GOOGLE_CLIENT_ID: a Google Cloud Console-ban létrehozott OAuth-alkalmazás kliensazonosítója.
• GRAVITYSMTP_GOOGLE_CLIENT_SECRET: ugyanennek az alkalmazásnak a titkos kulcsa.
• GRAVITYSMTP_GOOGLE_USE_RETURN_PATH: a Google-integrációval küldött leveleknél használja-e a visszatérési útvonalat (true vagy false).

Mailchimp Transactional

define( 'GRAVITYSMTP_MAILCHIMP_API_KEY', '' );

MailerSend

define( 'GRAVITYSMTP_MAILERSEND_API_KEY', '' );

A GRAVITYSMTP_MAILERSEND_API_KEY a MailerSend API-tokent adja meg. A többi konstans a közös táblázat szerinti.

Mailgun

define( 'GRAVITYSMTP_MAILGUN_API_KEY', '' );
define( 'GRAVITYSMTP_MAILGUN_DOMAIN', '' );
define( 'GRAVITYSMTP_MAILGUN_REGION', 'us' ); // us vagy eu
define( 'GRAVITYSMTP_MAILGUN_USE_RETURN_PATH', false ); // true vagy false

• GRAVITYSMTP_MAILGUN_API_KEY: a Mailgun API-hoz való hitelesítéshez használt kulcs.
• GRAVITYSMTP_MAILGUN_DOMAIN: az ellenőrzött domain, amelyről a levelek mennek.
• GRAVITYSMTP_MAILGUN_REGION: a szolgáltatás régiója, ahonnan a levelek indulnak (us vagy eu).
• GRAVITYSMTP_MAILGUN_USE_RETURN_PATH: használja-e a visszatérési útvonalat a kimenő leveleknél.

Mailjet

define( 'GRAVITYSMTP_MAILJET_API_KEY', '' );
define( 'GRAVITYSMTP_MAILJET_API_SECRET', '' );

• GRAVITYSMTP_MAILJET_API_KEY: a Mailjet API-kulcs.
• GRAVITYSMTP_MAILJET_API_SECRET: a hozzá tartozó titkos kulcs.

Mailtrap

define( 'GRAVITYSMTP_MAILTRAP_API_KEY', '' );
define( 'GRAVITYSMTP_MAILTRAP_SANDBOX_MODE', false );
define( 'GRAVITYSMTP_MAILTRAP_SANDBOX_INBOX_ID', '' );

• GRAVITYSMTP_MAILTRAP_API_KEY: a Mailtrap API-kulcs.
• GRAVITYSMTP_MAILTRAP_SANDBOX_MODE: bekapcsolja a Mailtrap homokozó (sandbox) módját. Bekapcsolva a levelek nem a valódi címzettekhez, hanem a Mailtrap homokozójába érkeznek.
• GRAVITYSMTP_MAILTRAP_SANDBOX_INBOX_ID: a homokozó postaládájának azonosítója. Homokozó módban kötelező.

Microsoft 365 / Outlook

define( 'GRAVITYSMTP_MICROSOFT_CLIENT_ID', '' );
define( 'GRAVITYSMTP_MICROSOFT_CLIENT_SECRET', '' );
define( 'GRAVITYSMTP_MICROSOFT_USE_RETURN_PATH', false ); // true vagy false

• GRAVITYSMTP_MICROSOFT_CLIENT_ID: a Microsoft Azure által az OAuth-hitelesítéshez adott kliensazonosító.
• GRAVITYSMTP_MICROSOFT_CLIENT_SECRET: az Azure-alkalmazás titkos kulcsa az OAuth-hitelesítéshez.
• GRAVITYSMTP_MICROSOFT_USE_RETURN_PATH: használja-e a visszatérési útvonalat a kimenő leveleknél.

A feladó nevét (FROM_NAME) és annak erőltetését (FORCE_FROM_NAME) ennél a szolgáltatónál nem lehet konstanssal állítani: a Microsoft magától a Microsoft-fiókban a feladó e-mail-címhez tartozó nevet használja.

PHP Mail

A PHP Mail konstansainak előtagja GRAVITYSMTP_PHPMAIL_. Itt nincs ACTIVE és CONFIGURED konstans, a bekapcsolást az ENABLED végzi.

define( 'GRAVITYSMTP_PHPMAIL_ENABLED', false ); // true vagy false
define( 'GRAVITYSMTP_PHPMAIL_FROM_EMAIL', '' );
define( 'GRAVITYSMTP_PHPMAIL_FROM_NAME', '' );
define( 'GRAVITYSMTP_PHPMAIL_REPLY_TO_EMAIL', '' );
define( 'GRAVITYSMTP_PHPMAIL_FORCE_FROM_EMAIL', false );
define( 'GRAVITYSMTP_PHPMAIL_FORCE_FROM_NAME', false );
define( 'GRAVITYSMTP_PHPMAIL_FORCE_REPLY_TO_EMAIL', false );
define( 'GRAVITYSMTP_PHPMAIL_USE_RETURN_PATH', false ); // true vagy false

A GRAVITYSMTP_PHPMAIL_USE_RETURN_PATH azt állítja, használja-e a visszatérési útvonalat a kimenő leveleknél. A többi konstans a közös táblázat szerint működik.

Postmark

define( 'GRAVITYSMTP_POSTMARK_SERVER_API_TOKEN', '' );
define( 'GRAVITYSMTP_POSTMARK_MESSAGE_STREAM', 'outbound' );

• GRAVITYSMTP_POSTMARK_SERVER_API_TOKEN: a Postmark API-hoz való hitelesítéshez használt kiszolgáló-token.
• GRAVITYSMTP_POSTMARK_MESSAGE_STREAM: a Postmark üzenetfolyam (message stream), amelyen át a levelek mennek. Így a levelek tranzakciós, tömeges vagy egyéni folyamba is irányíthatók, ha a Postmarkban be van állítva. Alapértéke outbound.

A Postmark konstanslistájában a válaszcím erőltetése (FORCE_REPLY_TO_EMAIL) nem szerepel.

Resend

define( 'GRAVITYSMTP_RESEND_API_KEY', '' );

A GRAVITYSMTP_RESEND_API_KEY a Resend API-tokent adja meg.

SendGrid

define( 'GRAVITYSMTP_SENDGRID_API_KEY', '' );
define( 'GRAVITYSMTP_SENDGRID_IP_POOL_NAME', '' );
define( 'GRAVITYSMTP_SENDGRID_REGION', '' );

• GRAVITYSMTP_SENDGRID_API_KEY: a SendGrid API-hoz való hitelesítéshez használt kulcs.
• GRAVITYSMTP_SENDGRID_IP_POOL_NAME: a SendGrid IP-készlet (IP pool) neve.
• GRAVITYSMTP_SENDGRID_REGION: a SendGrid régiója.

SMTP.com

Az előtag GRAVITYSMTP_SMTPCOM_ (pont nélkül).

define( 'GRAVITYSMTP_SMTPCOM_API_KEY', '' );
define( 'GRAVITYSMTP_SMTPCOM_CHANNEL_NAME', '' );

• GRAVITYSMTP_SMTPCOM_API_KEY: az SMTP.com API-kulcs.
• GRAVITYSMTP_SMTPCOM_CHANNEL_NAME: az SMTP.com csatorna (channel) neve.

Egyes leírásokban az API-kulcs konstansa GRAVITYSMTP_SMTPCOM_ACCESS_KEY néven szerepel. Ha az API_KEY alak nem hat, próbáld ezzel.

SMTP2GO

define( 'GRAVITYSMTP_SMTP2GO_API_KEY', '' );

A GRAVITYSMTP_SMTP2GO_API_KEY az SMTP2GO API-kulcsot adja meg.

SparkPost

define( 'GRAVITYSMTP_SPARKPOST_API_KEY', '' );
define( 'GRAVITYSMTP_SPARKPOST_ACCOUNT_LOCATION', 'us' ); // us vagy eu

• GRAVITYSMTP_SPARKPOST_API_KEY: a SparkPost API-kulcs.
• GRAVITYSMTP_SPARKPOST_ACCOUNT_LOCATION: a fiók helye: us az Egyesült Államok, eu Európa.

Zoho Mail

define( 'GRAVITYSMTP_ZOHO_CLIENT_ID', '' );
define( 'GRAVITYSMTP_ZOHO_CLIENT_SECRET', '' );
define( 'GRAVITYSMTP_ZOHO_DATACENTER_REGION', 'United States' );
define( 'GRAVITYSMTP_ZOHO_USE_RETURN_PATH', false ); // true vagy false

• GRAVITYSMTP_ZOHO_CLIENT_ID: a Zoho API-konzolban kapott kliensazonosító.
• GRAVITYSMTP_ZOHO_CLIENT_SECRET: a Zoho API-konzolban kapott titkos kulcs.
• GRAVITYSMTP_ZOHO_DATACENTER_REGION: a Zoho API-konzolban megadott adatközpont-régió.
• GRAVITYSMTP_ZOHO_USE_RETURN_PATH: használja-e a visszatérési útvonalat a kimenő leveleknél.

A többi konstans (ACTIVE, CONFIGURED, FROM_EMAIL, FROM_NAME, REPLY_TO_EMAIL és a FORCE_… változatok) a közös táblázat szerint működik. A feladó nevének erőltetése GRAVITYSMTP_ZOHO_FORCE_FROM_NAME néven állítható (nem …_FROM_NAME néven, az a feladó nevét adja meg).

Egyéni SMTP

Az egyéni SMTP-kapcsolat azonosítója generic, ezért a konstansok előtagja GRAVITYSMTP_GENERIC_. A közös konstansok mellett ezek tartoznak hozzá:

Konstans	Mit állít	Alapérték
GRAVITYSMTP_GENERIC_HOST	A levelezőszerver címe.	üres
GRAVITYSMTP_GENERIC_PORT	Az SMTP-kapcsolat portja.	üres
GRAVITYSMTP_GENERIC_USERNAME	A bejelentkezéshez használt felhasználónév.	üres
GRAVITYSMTP_GENERIC_PASSWORD	A bejelentkezéshez használt jelszó.	üres
GRAVITYSMTP_GENERIC_AUTH	A szerver kér-e felhasználónevet és jelszót a küldő azonosításához.	true
GRAVITYSMTP_GENERIC_AUTO_TLS	Használjon-e automatikusan TLS-titkosítást a kapcsolathoz.	true
GRAVITYSMTP_GENERIC_ENCRYPTION_TYPE	A kapcsolat titkosítási módja: tls, ssl vagy none.	tls
GRAVITYSMTP_GENERIC_USE_RETURN_PATH	Visszatérési útvonal (Return Path) használata.	true

define( 'GRAVITYSMTP_GENERIC_ACTIVE', true );
define( 'GRAVITYSMTP_GENERIC_CONFIGURED', true );
define( 'GRAVITYSMTP_GENERIC_ENABLED', true );
define( 'GRAVITYSMTP_GENERIC_HOST', 'smtp.pelda.hu' );
define( 'GRAVITYSMTP_GENERIC_PORT', '587' );
define( 'GRAVITYSMTP_GENERIC_ENCRYPTION_TYPE', 'tls' ); // tls, ssl vagy none
define( 'GRAVITYSMTP_GENERIC_USERNAME', 'felhasznalo' );
define( 'GRAVITYSMTP_GENERIC_PASSWORD', 'jelszo' );

Az egyéni SMTP beállításait a felületen a saját fejezete mutatja.