# E-mail szűrők

> Az értesítő e-mailek szövegét és tárgyát módosító szűrők listája, példákkal.

A bővítmény minden e-mailjének szövegéhez és tárgyához tartozik egy szűrő. Ezekkel tagsági szintenként vagy más tag- és tagságadat alapján módosíthatod a tartalmat, és többnyelvű e-mailek küldésére is használhatod őket. Ez egyéni kód, a saját felelősségedre alkalmazd.

## A szűrők listája

| E-mail | Szöveg szűrője | Tárgy szűrője |
| --- | --- | --- |
| Fizetős tagság aktiválása | `rcp_subscription_active_email` | `rcp_subscription_active_subject` |
| Ingyenes tagság aktiválása | `rcp_subscription_free_email` | `rcp_subscription_free_subject` |
| Próbatagság aktiválása | `rcp_subscription_trial_email` | `rcp_subscription_trial_subject` |
| Lemondott tagság | `rcp_subscription_cancelled_email` | `rcp_subscription_cancelled_subject` |
| Lejárt tagság | `rcp_subscription_expired_email` | `rcp_subscription_expired_subject` |
| Megérkezett fizetés | `rcp_payment_received_email` | nincs ilyen szűrő ebben a listában |
| Megújítási fizetés sikertelen | `rcp_subscription_renewal_payment_failed_email` | `rcp_subscription_renewal_payment_failed_subject` |
| Kézi fizetés (értesítés az adminnak) | `rcp_before_admin_email_manual_payment_thanks` | nincs ilyen szűrő ebben a listában |

A szűrők paraméterei:

- A tagság-állapotú e-mailek (aktiválás, lemondás, lejárat) szűrője: `$message` (vagy `$subject`), `$user_id`, `$status`, `$membership`.
- A megérkezett fizetés e-mailjéé: `$message`, `$payment_id`, `$payment`. A felhasználó azonosítója a `$payment['user_id']` értékből olvasható ki.
- A sikertelen megújítási fizetés e-mailjéé: `$message` (vagy `$subject`), `$user_id`, `$status`.
- A kézi fizetés admin értesítéséé: `$admin_message`, `$member->ID`.

## Példa: más szöveg a 3-as szintnek

Ez a példa az „aktív tagság” e-mail szövegét cseréli le, ha a felhasználó a 3-as azonosítójú tagsági szinten van:

```php
function ag_new_subscription_active_email( $message, $user_id, $status, $membership ) {
	$level_id = $membership->get_object_id();

	// Más szöveg, ha a felhasználó a 3-as szinten van.
	if ( 3 == $level_id ) {
		$message = __( 'Your new message can go in here.', 'rcp' );
	}

	return $message;
}
add_filter( 'rcp_subscription_active_email', 'ag_new_subscription_active_email', 10, 4 );
```

## Példa: a kézi fizetés admin értesítése

Ez a példa a kézi fizetés után az adminnak küldött értesítés szövegét írja át:

```php
function ag_rcp_admin_email_manual_payment( $message, $user_id ) {
	$member           = new RCP_Member( $user_id );
	$membership_level = $member->get_pending_subscription_name();

	// Alakítsd tetszés szerint.
	$new_message = __( 'Hello', 'rcp' ) . "\n\n" . $member->display_name . ' (' . $member->user_login . ') ' . __( 'just submitted a manual payment on', 'rcp' ) . ' ' . $site_name . ".\n\n" . __( 'Membership level', 'rcp' ) . ': ' . $membership_level . "\n\n";

	return $new_message;
}
add_filter( 'rcp_before_admin_email_manual_payment_thanks', 'ag_rcp_admin_email_manual_payment', 10, 2 );
```

A `$site_name` változót a saját kódodban kell meghatároznod, például a `get_bloginfo( 'name' )` értékéből.

Az e-mailek általános beállításait és a beépített sablon címkéket az e-mail beállítások fejezete írja le. Saját címkét a kódpéldák fejezetében találsz.