Historia wydań

0.2.6

Wydana 14 października 2026. Asystent AI, którego podłączysz do sklepu, może teraz czytać raport.

Od WordPressa 6.9 Merchgain rejestruje przez WordPress Abilities API trzy umiejętności tylko do odczytu: podsumowanie zysku za okres, produkty sprzedane ze stratą i produkty bez kosztu. Asystent AI podłączony do sklepu przez MCP odpowiada tymi samymi liczbami co ekran raportu — co może przeczytać i kto może go o to poprosić. Umiejętności wymagają tego samego uprawnienia „view WooCommerce reports” co ekran i niczego nie zmieniają. Merchgain nadal nie wykonuje żadnych połączeń wychodzących: liczby trafiają do asystenta tylko przez połączenie, które sam skonfigurujesz.

Produkt liczy się jako sprzedany ze stratą, gdy jego zapisany koszt był w okresie wyższy niż przychód. Zwroty wcześniejszej sprzedaży nie są stratą, a pozycje bez zapisanego kosztu nie są oceniane — obejmuje je lista produktów bez kosztu.

0.2.5

Wydana 11 października 2026. Pozycje sprzedane przed zapisaniem kosztu dostają szacunek, a ekran raportu ma nowy wygląd.

WooCommerce zapisuje koszt na zamówieniu w chwili sprzedaży, więc sklep, który wpisuje koszty dziś, nie ma ich na zeszłorocznych zamówieniach. Raport szacuje teraz takie pozycje z dzisiejszego kosztu każdego produktu — tą samą regułą, której WooCommerce używa przy zapisie kosztu, także dla wariantów — i pokazuje wynik we własnym panelu pod podsumowaniem. Szacunek nigdy nie jest doliczany do liczb zapisanych: podsumowanie, kolumny Koszt, Zysk i Marża oraz linia pokrycia liczą się dokładnie tak jak wcześniej. Ma własne kafelki, własne kolumny „Szacowany zysk” i „Szacowana marża”, które można sortować, i znak ≈ przy każdej szacowanej liczbie. Pozycje bez kosztu nawet dziś — produkt bez kosztu albo z kosztem zero, albo skasowany od dnia sprzedaży — nie są szacowane, a panel podaje, ile przychodu przez to zostaje poza szacunkiem. Nic nie jest zapisywane w sklepie: szacunek liczy się przy otwarciu raportu.

Eksport CSV ma na końcu pięć nowych kolumn — przychód, koszt, zysk, marżę i liczbę pozycji szacunku — i wyjaśnia je w notatce na końcu pliku. Dotychczasowe kolumny zostają na swoich miejscach. Jednorazowa prośba o recenzję może się teraz pojawić także pod raportem, który ma sam szacunek.

Zysk brutto jest teraz największą liczbą na ekranie, a obok niego, w panelu podsumowania, stoją przychód, koszt towaru i marża; pasek pokazuje, jak przychód dzieli się na koszt, zysk i część bez zapisanego kosztu. Marże w tabeli mają obok siebie pasek, a pole wyszukiwania i przycisk CSV stoją przy tabeli, której dotyczą. Liczby i sposób ich liczenia się nie zmieniły.

Trzy poprawki rzeczy, które w 0.2.4 działały źle. Odnośnik przy linii pokrycia zawsze mówił o 74%, niezależnie od prawdziwego udziału; teraz cytuje linię, a udział tuż poniżej 100% albo tuż powyżej 0% ma jedno miejsce po przecinku, zamiast zaokrąglenia do 100% albo 0%. Przejście z wyszukiwania produktów do widoku kategorii zachowywało wpisaną frazę, więc ekran mówił, że wyszukiwanie filtruje tabelę, której nie filtrowało, a eksport kategorii tracił notatkę o produktach liczonych w kilku kategoriach. Konto, które widzi raporty, ale nie może edytować produktów, dostawało nazwy z listy produktów bez kosztu jako puste odnośniki, które przeładowywały raport; teraz są to zwykłe nazwy.

0.2.4

Wydana 25 września 2026. Ostrzeżenie o brakujących kosztach znajduje ceny zakupu z ATUM-a, właściwie przypisuje WooCommerce Cost of Goods i rozpoznaje dwie kolejne wtyczki.

Od swojej wersji 1.5.0 ATUM Inventory Management trzyma ceny zakupu we własnej tabeli, a Merchgain czytał stare pole produktu, do którego ATUM już nie pisze — więc ostrzeżenie ich nie widziało. Teraz czyta tabelę. Starego pola nie liczy już wcale: w sklepie, który używał ATUM-a przed wersją 1.5.0, leży w nim zamrożona kopia, a pola o tej samej nazwie używają też inne wtyczki, więc żadnej z nich nie dałoby się uczciwie wskazać.

Koszty trzymane przez WooCommerce Cost of Goods były przypisywane wtyczce kosztowej WPFactory, która je tylko importuje; ostrzeżenie wymienia teraz właściwą wtyczkę. Wariant bez własnego kosztu we wtyczce WPFactory bierze tam koszt rodzica i jest teraz liczony, więc sklep, który trzyma te koszty na produktach zmiennych, nie widzi już zera. Ostrzeżenie rozpoznaje też Booster for WooCommerce i BjornTech PayPal POS integration for WooCommerce, a każdą wtyczkę nazywa nazwą, którą ta sama sobie nadaje. Gdy Booster ma włączone „Treat Variable Products as Simple Products”, wariant bierze tam cenę zakupu rodzica, a ostrzeżenie liczy go jako koszt trzymany w Boosterze.

Kwoty ujemne też nie są już liczone — liczą się tylko kwoty większe od zera.

0.2.3

Wydana 23 września 2026. Poprawka dla sklepów z bazą danych MariaDB, jednorazowa prośba o recenzję i nowe zrzuty ekranu.

W sklepach z bazą danych MariaDB tabele produktów i kategorii — oraz ich eksport CSV — wychodziły puste przy sortowaniu po zysku albo po marży, a zysk jest sortowaniem domyślnym. Baza odrzucała wyrażenie sortujące, a ekran nie pokazywał ani wierszy, ani błędu. Błąd nie dotyczył MySQL, a żadna liczba nigdy nie była błędna: kafelki podsumowania i pozostałe sortowania działały. Jeśli po otwarciu raportu tabela była pusta — to jest wersja, która to naprawia.

Pod raportem, w którym choć jedna sprzedaż ma zapisany koszt, pojawia się teraz jednorazowa prośba o recenzję wtyczki na WordPress.org — jakakolwiek będzie Twoja ocena. Pokazuje się tylko na ekranie raportu, nigdy w kokpicie, i zamyka się na dobre, gdy przejdziesz do recenzji albo wybierzesz „Nie pytaj więcej”. Decyzja jest zapisywana osobno dla każdego użytkownika i usuwana przy odinstalowaniu wtyczki.

Zrzuty ekranu w katalogu wtyczek zostały zrobione od nowa, w anglojęzycznym sklepie demonstracyjnym, z podpisami mówiącymi, co pokazuje każdy ekran.

0.2.2

Wydana 18 września 2026. Ostrzeżenie o brakujących kosztach mówi teraz, kiedy koszt trzyma inna wtyczka.

Produkt, który nie ma kosztu w polu WooCommerce, ale ma go w Cost of Goods for WooCommerce, ATUM Inventory Management, NI WooCommerce Cost of Goods albo Cost of Goods, jest policzony, a wtyczka wymieniona z nazwy. Pusty raport przestaje być zagadką — a dla sklepu, który liczy koszty od lat, to był cały problem.

Te wartości są liczone, nigdy z nich nie liczymy. Zysk i marża nadal biorą się wyłącznie z pola, które daje samo WooCommerce: liczba wzięta z pola, którego nikt nie sprawdzi, byłaby gorsza niż luka, którą zapełnia. Dlaczego granica leży właśnie tam i jak przenieść wartości — na stronie o kosztach w innej wtyczce.

0.2.1

Wydana 18 września 2026. Jedna zmiana, którą widać, i dwie, których nie.

Wtyczka jest teraz wymieniona w katalogu jako Merchgain – Gross Margin & Profit Reports for WooCommerce. Zmieniła się wyłącznie wyświetlana nazwa: ta sama wtyczka, ten sam adres w katalogu, te same ustawienia, te same dane. W sklepie nie trzeba robić nic.

Pozostałe dwie mają znaczenie tylko wtedy, gdy zainstalowane jest rozszerzenie Merchgain:

• widok kategorii przyspieszył. Grupowanie wykonywało dwa zapytania na produkt — w sklepie z 11 000 sprzedanych sztuk było to 6978 zapytań i 2,6 sekundy. Teraz jest to 18 zapytań i 0,8 sekundy, a liczby, które wychodzą, są takie same;
• odinstalowanie nie usuwa już danych zapamiętanych przez rozszerzenia Merchgain. Każde rozszerzenie sprząta po sobie samo.

0.2.0

Wydana 8 września 2026. Pierwsza publiczna wersja — za darmo w katalogu wtyczek WordPress.org, do zainstalowania z własnego panelu jak każda inna wtyczka.

Wersje 0.1.0 i 0.1.1 były wersjami recenzyjnymi wysłanymi do katalogu i nigdy nie zostały opublikowane. Kod jest tu ten sam, który przeszedł recenzję — zmienił się wyłącznie numer.

Co potrafi:

• karty podsumowania — przychód, koszt towaru, zysk brutto i marża za wybrany okres;
• zysk per produkt, z sortowaniem, wyszukiwaniem i paginacją;
• zysk per kategoria;
• ostrzeżenie o brakach kosztu, z odnośnikami wprost do produktów i kwotą przychodu bez pokrycia;
• eksport CSV bieżącego widoku;
• ostrzeżenie o obcych walutach, z wymienieniem walut i wyłączeniem tych zamówień;
• ekran powitalny dla sklepu, w którym funkcja kosztu własnego sprzedaży jest jeszcze wyłączona;
• wyniki w cache na godzinę, czyszczone od razu po zapisie kosztu, plus przycisk Przelicz;
• bez ograniczenia, jak daleko wstecz sięga raport — obejmuje całą historię zamówień.

Wymaga WooCommerce 10.3, WordPressa 6.7 i PHP 7.4. Działa z HPOS i z klasycznym zapisem zamówień.

Nad czym trwa praca

Dwie rzeczy, w tej kolejności:

• zysk w czasie — te same liczby agregowane po dniach, tygodniach albo miesiącach;
• porównanie z poprzednim okresem — różnice na kartach podsumowania.

Matematyka do obu siedzi już w rdzeniu wtyczki i ma testy; brakuje ekranu. Żadna z nich nie ma obiecanej daty. Wersja pojawia się na liście powyżej, gdy zostanie wydana, a nie gdy zostanie zaplanowana — i ta strona jest jedynym miejscem, w którym którekolwiek z tych zdań jest wypowiadane.

Skąd wiadomo, że ta lista jest uczciwa

Wtyczka wysyła swoją historię wydań w pliku readme.txt i to jego treść pokazuje listing na WordPress.org. Ta strona jest lustrem tamtego pliku, a nie osobnym tekstem — jedno źródło, więc oba miejsca nie mają jak się rozjechać. Czego brakuje tutaj, brakuje i tam, a to warte jest maila.