Wymagania
Wersja 1.2.0 wymaga WordPress 6.0+, PHP 7.4+ i aktywnego WooCommerce. Readme podaje WooCommerce 8.0 jako minimalną wersję. Wtyczka obsługuje klasyczne zamówienia i HPOS.
Instalacja z WordPress.org
- Zainstaluj i aktywuj WooCommerce.
- Otwórz Wtyczki → Dodaj nową i wyszukaj pełną nazwę Inference Works Order Invoice Attach for WooCommerce. Możesz też pobrać ZIP z WordPress.org i wybrać Wyślij wtyczkę na serwer.
- Zainstaluj i aktywuj wtyczkę. Jest dostępna wyłącznie jako Free; nie wymaga zakupu ani klucza licencji.
- Otwórz Inference Works → Faktury do zamówień (Order invoices) i wybierz e-maile, które mają otrzymywać PDF.
- W edycji zamówienia znajdź metabox Invoice PDF i wgraj gotową fakturę. Następnie zmień status lub wyślij e-mail z fakturą dla klienta.
Wtyczka nie wystawia dokumentów: przygotuj PDF w swoim programie księgowym. Nie nadaje numerów, nie korzysta z API księgowości i nie tworzy korekt.
Aktualizacja z wersji 1.1.0 lub starszej
Wersja 1.2.0 ma nowy slug inference-works-order-invoice-attach. Wyłącz poprzednią wtyczkę przed aktywacją nowej. Nie usuwaj starej kopii z włączoną opcją czyszczenia faktur przy odinstalowaniu. Nowa wersja importuje wcześniejsze ustawienia bez nadpisywania nowych oraz odczytuje stare metadane i linki pobierania. Pliki PDF nie są przenoszone. Gdy obie kopie są aktywne, nowa wstrzymuje wewnętrzną obsługę do wyłączenia starej, aby uniknąć podwójnych akcji.
Dostęp do plików
Nowe faktury trafiają do wp-content/uploads/iwoia-invoices/{rok}/{miesiąc}/ pod losową 32-znakową nazwą, poza biblioteką mediów. Starsze mogą pozostać w oia-invoices.
Na Apache wtyczka zapisuje dodatkowe zabezpieczenia index.php i .htaccess. Nginx ignoruje .htaccess: administrator serwera musi zablokować bezpośredni publiczny dostęp do obu katalogów faktur. Losowe nazwy utrudniają odgadnięcie adresu, ale nie zastępują kontroli dostępu. Pobieranie przez endpoint sprawdza uprawnienia: zarządzanie sklepem, właściciela zamówienia lub poprawny klucz zamówienia dla gościa.