Add new update package version 0.235 to autoload admin

2026-01-27 23:47:10 +01:00
parent e31074506c
commit 43aebc166f
14 changed files with 528 additions and 55 deletions
--- a/UPDATE_INSTRUCTIONS.md
+++ b/UPDATE_INSTRUCTIONS.md
@@ -0,0 +1,111 @@
+# Instrukcja tworzenia aktualizacji shopPRO
+
+## Struktura aktualizacji
+
+Aktualizacje znajdują się w folderze `updates/0.XX/` gdzie XX oznacza dziesiątki wersji.
+
+### Pliki aktualizacji:
+- `ver_X.XXX.zip` - paczka ZIP ze zmienionymi plikami (BEZ folderu wersji, bezpośrednio struktura katalogów)
+- `ver_X.XXX_sql.txt` - opcjonalny plik z zapytaniami SQL (jeśli wymagane zmiany w bazie)
+- `changelog.php` - historia zmian
+- `versions.php` - konfiguracja wersji (zmienna `$current_ver`)
+
+## Procedura tworzenia nowej aktualizacji
+
+### 1. Określ numer wersji
+Sprawdź ostatnią wersję w `updates/0.20/` i zwiększ o 1.
+
+### 2. Utwórz folder tymczasowy ze strukturą
+```bash
+mkdir -p updates/0.20/temp_XXX/sciezka/do/pliku
+```
+
+**WAŻNE:** W archiwum ZIP NIE powinno być folderu z nazwą wersji (np. ver_0.234/).
+Struktura ZIP powinna zaczynać się bezpośrednio od katalogów projektu (admin/, autoload/, itp.).
+
+### 3. Skopiuj zmienione pliki do folderu tymczasowego
+```bash
+cp sciezka/do/pliku.php updates/0.20/temp_XXX/sciezka/do/pliku.php
+```
+
+### 4. Utwórz plik ZIP z zawartości folderu (nie z samego folderu!)
+```powershell
+cd updates/0.20/temp_XXX
+powershell -Command "Compress-Archive -Path '*' -DestinationPath '../ver_X.XXX.zip' -Force"
+```
+
+### 5. Usuń folder tymczasowy
+```bash
+rm -rf updates/0.20/temp_XXX
+```
+
+### 6. Zaktualizuj changelog.php
+Dodaj wpis na początku pliku:
+```html
+<b>ver. X.XXX</b><br />
+- NEW/FIX/UPDATE - opis zmiany
+<hr>
+```
+
+Prefiksy:
+- `NEW` - nowa funkcjonalność
+- `FIX` - naprawa błędu
+- `UPDATE` - aktualizacja istniejącej funkcjonalności
+
+### 7. Zaktualizuj versions.php
+Zmień wartość `$current_ver` na nowy numer wersji (bez przedrostka 0.):
+```php
+$current_ver = 234; // dla wersji 0.234
+```
+
+### 8. (Opcjonalnie) Utwórz plik SQL
+Jeśli aktualizacja wymaga zmian w bazie danych, utwórz plik `ver_X.XXX_sql.txt` z zapytaniami SQL.
+
+## Przykład - aktualizacja 0.234
+
+Zmienione pliki:
+- `autoload/admin/controls/class.ShopOrder.php`
+- `admin/templates/shop-order/order-details.php`
+
+Opis: Dodanie przycisku do zaznaczania zamówienia jako wysłane do trustmate.io
+
+### Komendy:
+
+```bash
+# Utwórz strukturę w folderze tymczasowym
+mkdir -p updates/0.20/temp_234/autoload/admin/controls
+mkdir -p updates/0.20/temp_234/admin/templates/shop-order
+
+# Skopiuj pliki
+cp autoload/admin/controls/class.ShopOrder.php updates/0.20/temp_234/autoload/admin/controls/
+cp admin/templates/shop-order/order-details.php updates/0.20/temp_234/admin/templates/shop-order/
+
+# Utwórz ZIP z ZAWARTOŚCI folderu (ważne: wejdź do folderu i spakuj '*')
+cd updates/0.20/temp_234
+powershell -Command "Compress-Archive -Path '*' -DestinationPath '../ver_0.234.zip' -Force"
+
+# Wróć i usuń folder tymczasowy
+cd ..
+rm -rf temp_234
+```
+
+### Poprawna struktura ZIP:
+```
+ver_0.234.zip
+├── admin/
+│   └── templates/
+│       └── shop-order/
+│           └── order-details.php
+└── autoload/
+    └── admin/
+        └── controls/
+            └── class.ShopOrder.php
+```
+
+### NIEPOPRAWNA struktura (do uniknięcia):
+```
+ver_0.234.zip
+└── ver_0.234/          <-- tego folderu NIE powinno być!
+    ├── admin/
+    └── autoload/
+```