# wp_mail_embed_args

URL: https://chugunov.pro/api-wordpress/filters/wp_mail_embed_args/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: хук-фильтр.
Появился в версии: 6.9.0.

## Сигнатура

```php
apply_filters( 'wp_mail_embed_args', array $args )
```

## Описание

Фильтрует аргументы метода addEmbeddedImage() класса PHPMailer.

## Параметры

- `$args` `array` — обязательный. Массив аргументов метода addEmbeddedImage() класса PHPMailer.
  
  path stringПуть к файлу.
  
  cid stringContent-ID изображения. По умолчанию: ключ в массиве embeds.
  
  name stringИмя файла изображения.
  
  encoding stringКодировка изображения. По умолчанию: 'base64'.
  
  type stringMIME-тип изображения. По умолчанию: пустая строка, что позволяет PHPMailer определить его автоматически.
  
  disposition stringРасположение изображения (disposition). По умолчанию: 'inline'.

## Фильтруемое значение

Массив аргументов метода addEmbeddedImage() класса PHPMailer.

path stringПуть к файлу.

cid stringContent-ID изображения. По умолчанию: ключ в массиве embeds.

name stringИмя файла изображения.

encoding stringКодировка изображения. По умолчанию: 'base64'.

type stringMIME-тип изображения. По умолчанию: пустая строка, что позволяет PHPMailer определить его автоматически.

disposition stringРасположение изображения (disposition). По умолчанию: 'inline'.

## Исходный код

Файл: `wp-includes/pluggable.php:588`

```php
$embed_args = apply_filters(
	'wp_mail_embed_args',
	array(
		'path'        => $embed_path,
		'cid'         => (string) $key,
		'name'        => basename( $embed_path ),
		'encoding'    => 'base64',
		'type'        => '',
		'disposition' => 'inline',
	)
);
```

## История изменений

- 6.9.0 — Introduced.

## Связанные

Используется в: [`wp_mail`](https://chugunov.pro/api-wordpress/functions/wp_mail/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/hooks/wp_mail_embed_args/