# Szolgáltatói konstansok

> A Gravity SMTP szolgáltatói integrációit felülíró konstansok a wp-config.php fájlban: közös elemek és szolgáltatónkénti listák.

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](https://hub.hellowp.io/hu/plugins/gravitysmtp/fejlesztoknek-konstansok-beallitas/) 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 (`''`).

```php
define( 'GRAVITYSMTP_BREVO_FROM_EMAIL', 'info@pelda.hu' );
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

```php
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

```php
define( 'GRAVITYSMTP_BREVO_API_KEY', '' );
```

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

### Cloudflare Email

```php
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

```php
define( 'GRAVITYSMTP_ELASTIC_EMAIL_API_KEY', '' );
```

### Emailit

```php
define( 'GRAVITYSMTP_EMAILIT_API_KEY', '' );
```

### Google / Gmail

```php
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

```php
define( 'GRAVITYSMTP_MAILCHIMP_API_KEY', '' );
```

### MailerSend

```php
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

```php
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

```php
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

```php
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

```php
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.

```php
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

```php
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

```php
define( 'GRAVITYSMTP_RESEND_API_KEY', '' );
```

A `GRAVITYSMTP_RESEND_API_KEY` a Resend API-tokent adja meg.

### SendGrid

```php
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).

```php
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

```php
define( 'GRAVITYSMTP_SMTP2GO_API_KEY', '' );
```

A `GRAVITYSMTP_SMTP2GO_API_KEY` az SMTP2GO API-kulcsot adja meg.

### SparkPost

```php
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

```php
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` |

```php
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](https://hub.hellowp.io/hu/plugins/gravitysmtp/szolgaltatok-egyedi-smtp/) mutatja.
