Řešení potíží

Přílohy se neodesílají

Soubor neexistuje

Zkontrolujte, že soubor v knihovně médií existuje:

1. Přejděte do Média
2. Najděte přílohu
3. Ověřte, že soubor je dostupný

Špatný e-mail

Ověřte, že máte vybraný správný e-mail:

1. V nastavení přílohy zkontrolujte pole Attach to emails
2. Ujistěte se, že je vybrán e-mail, který se odesílá

Omezení země

Pokud máte nastavené Enabled countries:

1. Zkontrolujte, zda země objednávky odpovídá seznamu
2. Nechte pole prázdné pro všechny země

E-mail je blokován

Příliš velké přílohy

Někteří e-mailoví poskytovatelé blokují e-maily s velkými přílohami:

• Gmail: max 25 MB
• Outlook: max 20 MB
• Většina hostingů: max 10-25 MB

Řešení:

• Zmenšete velikost souborů
• Použijte odkaz na stažení místo přílohy

Blokované typy souborů

Některé typy souborů jsou blokovány:

• .exe, .bat, .cmd
• Archivy s heslem

Doporučené formáty:

• PDF dokumenty
• Obrázky (JPG, PNG)

Produktová příloha se nepřipojí

Příloha není nastavena u produktu

1. Otevřete detail produktu
2. Vyberte záložku Attachments
3. Nastavte přílohy
4. Uložte produkt

E-mail není vybrán

V nastavení přílohy u produktu zkontrolujte pole Attach to emails.

Custom fields nefungují

Cesta neexistuje

Modul kontroluje existenci souboru:

if ( file_exists( $field['custom_field'] ) ) {
    $attachments[] = $field['custom_field'];
}

Zkontrolujte:

1. Že order meta obsahuje správnou cestu
2. Že soubor na cestě existuje
3. Že cesta je absolutní

Meta klíč je špatný

Ujistěte se, že zadáváte správný meta klíč (včetně podtržítka na začátku, pokud je použit).

Diagnostika

Kontrola příloh v e-mailu

add_filter( 'woocommerce_email_attachments', function( $attachments, $email_id, $order ) {
    error_log( sprintf(
        'E-mail: %s, Přílohy: %s',
        $email_id,
        print_r( $attachments, true )
    ) );

    return $attachments;
}, 999, 3 );

Kontrola nastavení modulu

$module = wpify_woo_container()->get(
    \WpifyWoo\Modules\EmailAttachments\EmailAttachmentsModule::class
);

$settings = $module->get_setting( 'email_attachments' );
print_r( $settings );

Kontrola produktových příloh

$attachments = get_post_meta( $product_id, 'email_attachments', true );
print_r( $attachments );

Výkon

Příliš mnoho příloh

Každá příloha zvyšuje velikost e-mailu a dobu odesílání:

• Omezte počet příloh na e-mail
• Zvažte použití odkazů místo příloh
• Použijte modul Asynchronní e-maily pro zlepšení výkonu

Velké soubory

Pro velké soubory:

1. Komprimujte PDF dokumenty
2. Optimalizujte obrázky
3. Zvažte rozdělení do více e-mailů

E-maily se nedoručují

Kontrola spam složky

E-maily s přílohami mají vyšší pravděpodobnost označení jako spam:

1. Zkontrolujte spam složku
2. Použijte SMTP plugin pro lepší doručitelnost
3. Nastavte SPF a DKIM záznamy