WooCommerce – ein PDF als Anhang in den Bestell-Emails mitsenden

/**
 * WooCommerce: Rechtliche PDF-Dokumente (AGB, Widerrufsbelehrung)
 * als Anhang an Bestell-E-Mails mitsenden.
 *
 * Die PDF-Dateien liegen fest im Child-Theme-Ordner unter /woocommerce/,
 * z.B. wp-content/themes/child-theme/woocommerce/AGB.pdf
 *
 * Kein Plugin nötig – nutzt den WooCommerce-Standard-Filter
 * woocommerce_email_attachments.
 */

/**
 * Liefert den Pfad zum Theme-Unterordner, in dem die PDFs liegen.
 *
 * get_stylesheet_directory() zeigt immer auf das AKTIVE Theme
 * (bei einem Child-Theme also dessen Ordner, nicht das Parent-Theme).
 * Falls du kein Child-Theme nutzt, hier stattdessen
 * get_template_directory() verwenden.
 *
 * @return string Absoluter Serverpfad, z.B. .../child-theme/woocommerce
 */
function rd_legal_pdf_directory() {
	return get_stylesheet_directory() . '/woocommerce';
}

/**
 * Definiert, welche PDF-Dateien an welche WooCommerce-E-Mails
 * angehängt werden sollen.
 *
 * Struktur: E-Mail-ID => Liste der Dateinamen (relativ zu rd_legal_pdf_directory()).
 * Eine Übersicht gängiger E-Mail-IDs findest du in den Kommentaren unten.
 *
 * @return array
 */
function rd_legal_pdf_attachment_map() {
	return array(
		'customer_processing_order' => array(
			'AGB.pdf',
			'Widerrufsformular.pdf',
		),

		// Weitere Beispiele, bei Bedarf einkommentieren und anpassen:
		// 'customer_completed_order' => array( 'AGB.pdf' ),
		// 'new_order'                => array( 'AGB.pdf', 'Widerrufsformular.pdf' ),

		// Alle verfügbaren Standard-E-Mail-IDs von WooCommerce:
		// new_order, cancelled_order, failed_order, order_on_hold,
		// customer_processing_order, customer_on_hold_order,
		// customer_completed_order, customer_refunded_order,
		// customer_invoice, customer_note, customer_reset_password,
		// customer_new_account
	);
}

/**
 * Hängt die konfigurierten PDF-Dateien an die passende(n)
 * WooCommerce-E-Mail(s) an.
 *
 * @param array         $attachments Bisherige Anhänge (Dateipfade).
 * @param string        $email_id    ID der aktuell versendeten E-Mail.
 * @param WC_Order|null $order       Bestellobjekt (kann bei Nicht-Order-Mails null sein).
 * @return array
 */
add_filter( 'woocommerce_email_attachments', 'rd_attach_legal_pdfs_to_email', 10, 3 );
function rd_attach_legal_pdfs_to_email( $attachments, $email_id, $order ) {

	$attachment_map = rd_legal_pdf_attachment_map();

	// Für diese E-Mail-ID ist nichts konfiguriert -> nichts tun.
	if ( empty( $attachment_map[ $email_id ] ) ) {
		return $attachments;
	}

	$pdf_directory = rd_legal_pdf_directory();

	foreach ( $attachment_map[ $email_id ] as $filename ) {

		$file_path = trailingslashit( $pdf_directory ) . $filename;

		if ( file_exists( $file_path ) ) {
			$attachments[] = $file_path;
		} else {
			// Fehlende Datei loggen, damit man es merkt, statt dass
			// die PDF einfach stillschweigend fehlt.
			if ( function_exists( 'wc_get_logger' ) ) {
				wc_get_logger()->warning(
					sprintf( 'PDF-Anhang nicht gefunden: %s', $file_path ),
					array( 'source' => 'rd-legal-pdf-attachments' )
				);
			}
		}
	}

	return $attachments;
}

/**
 * WooCommerce: Rechtliche PDF-Dokumente (AGB, Widerrufsbelehrung)
 * als Anhang an Bestell-E-Mails mitsenden.
 *
 * Die PDF-Dateien liegen direkt im Uploads-Root, z.B.
 * wp-content/uploads/AGB.pdf
 *
 * Kein Plugin nötig – nutzt den WooCommerce-Standard-Filter
 * woocommerce_email_attachments.
 */

/**
 * Liefert den Serverpfad zum WordPress-Uploads-Verzeichnis
 * (Basisordner der Mediathek, i.d.R. wp-content/uploads).
 *
 * @return string Absoluter Serverpfad.
 */
function rd_legal_pdf_directory() {
	$upload_dir = wp_upload_dir();
	return $upload_dir['basedir'];
}

/**
 * Definiert, welche PDF-Dateien an welche WooCommerce-E-Mails
 * angehängt werden sollen.
 *
 * Struktur: E-Mail-ID => Liste der Dateinamen (relativ zu rd_legal_pdf_directory()).
 *
 * @return array
 */
function rd_legal_pdf_attachment_map() {
	return array(
		'customer_processing_order' => array(
			'AGB.pdf',
			'Widerrufsbelehrung.pdf',
		),

		// Weitere Beispiele, bei Bedarf einkommentieren und anpassen:
		// 'customer_completed_order' => array( 'AGB.pdf' ),
		// 'new_order'                => array( 'AGB.pdf', 'Widerrufsbelehrung.pdf' ),

		// Alle verfügbaren Standard-E-Mail-IDs von WooCommerce:
		// new_order, cancelled_order, failed_order, order_on_hold,
		// customer_processing_order, customer_on_hold_order,
		// customer_completed_order, customer_refunded_order,
		// customer_invoice, customer_note, customer_reset_password,
		// customer_new_account
	);
}

/**
 * Hängt die konfigurierten PDF-Dateien an die passende(n)
 * WooCommerce-E-Mail(s) an.
 *
 * @param array         $attachments Bisherige Anhänge (Dateipfade).
 * @param string        $email_id    ID der aktuell versendeten E-Mail.
 * @param WC_Order|null $order       Bestellobjekt (kann bei Nicht-Order-Mails null sein).
 * @return array
 */
add_filter( 'woocommerce_email_attachments', 'rd_attach_legal_pdfs_to_email', 10, 3 );
function rd_attach_legal_pdfs_to_email( $attachments, $email_id, $order ) {

	$attachment_map = rd_legal_pdf_attachment_map();

	// Für diese E-Mail-ID ist nichts konfiguriert -> nichts tun.
	if ( empty( $attachment_map[ $email_id ] ) ) {
		return $attachments;
	}

	$pdf_directory = rd_legal_pdf_directory();

	foreach ( $attachment_map[ $email_id ] as $filename ) {

		$file_path = trailingslashit( $pdf_directory ) . $filename;

		if ( file_exists( $file_path ) ) {
			$attachments[] = $file_path;
		} else {
			// Fehlende Datei loggen, damit man es merkt, statt dass
			// die PDF einfach stillschweigend fehlt.
			if ( function_exists( 'wc_get_logger' ) ) {
				wc_get_logger()->warning(
					sprintf( 'PDF-Anhang nicht gefunden: %s', $file_path ),
					array( 'source' => 'rd-legal-pdf-attachments' )
				);
			}
		}
	}

	return $attachments;
}