WooCommerce Наредба Н-18 / NotASupto — документация за разработчици

Плъгинът NotASupto (генериране на складови разписки/документи за WooCommerce) предоставя филтър и действие, с които разработчиците могат да персонализират съдържанието на документите, без да променят кода на плъгина.

Поставяйте примерите във functions.php на дъщерна тема или в собствен плъгин.

Съвет: филтърът винаги връща стойност; действието само изпълнява код.

Филтри

notasupto_prepare_document_data

Променя данните на документа преди неговото генериране (позиции, суми, данни за клиента и т.н.).

• Параметри:
• $document_data (масив — всички данни за документа)
• $order_id
• $document (типът/обектът на документа)
• $partial_refund (bool — дали е частично връщане)
• Връща: $document_data

add_filter( 'notasupto_prepare_document_data', function ( $document_data, $order_id, $document, $partial_refund ) {
    // Пример: добави собствен текст/бележка към документа
    $document_data['custom_note'] = 'Благодарим за поръчката!';
    return $document_data;
}, 10, 4 );

Действия

notasupto_document_before_footer

Изпълнява се при рендиране на документа, непосредствено преди долния колонтитул (footer) — удобно за добавяне на собствено съдържание (напр. подпис, QR код, допълнителен текст).

• Параметри:
• $data (данните на документа)
• $lang (текущият език на документа)

add_action( 'notasupto_document_before_footer', function ( $data, $lang ) {
    echo '<div style="margin-top:10px;font-size:11px;">Документът е генериран автоматично.</div>';
}, 10, 2 );