◆ PROGALLERY.PL · DOKUMENTACJA
◆ PROGALLERY.PL · DOCUMENTATION

Instrukcja instalacjiInstallation guide

9 KROKÓW + POMOC · OK. 10 MINUT · HOSTING Z CPANEL LUB DOWOLNY Z PHP 8.3
9 STEPS + HELP · ABOUT 10 MINUTES · CPANEL HOSTING OR ANY WITH PHP 8.3
TWÓJ POSTĘP · ZAPISANY W TEJ PRZEGLĄDARCE
YOUR PROGRESS · SAVED IN THIS BROWSER
0/ 9 kroków/ 9 steps
✓01WymaganiaRequirements
Krok 01 / 09ObowiązkowyRequired

Czego potrzebujeszWhat you need

  • Hosting z własną domeną i dostępem przez FTP albo menedżer plikówHosting with your own domain and FTP or file manager access
  • PHP 8.3 — dokładnie gałąź 8.3.x; instalator nie ruszy na 8.2 ani 8.4PHP 8.3 — exactly the 8.3.x branch; the installer will not run on 8.2 or 8.4
  • Rozszerzenie ionCube Loader — włączasz je w panelu hostingu, na liście rozszerzeń PHPThe ionCube Loader extension — enable it in your hosting panel, in the PHP extensions list
  • Rozszerzenia pdo_mysql, gd, mbstring, curl — na większości hostingów są domyślnieExtensions pdo_mysql, gd, mbstring, curl — enabled by default on most hosts
  • Baza MySQL lub MariaDBA MySQL or MariaDB database

Nie musisz tego sprawdzać ręcznie — pierwszy ekran instalatora pokaże każdy punkt na zielono albo powie, czego brakuje.

No need to check this by hand — the first installer screen shows every item in green or tells you what is missing.

✓02Wgranie plikówFiles uploaded ·
Krok 02 / 09WybórChoice

Wgraj pliki na serwerUpload files to the server

  1. Otwórz File Manager i wejdź do public_html/Open File Manager and go to public_html/
  2. Utwórz folder, np. galeria/Create a folder, e.g. gallery/
  3. Wgraj do niego plik ZIP przyciskiem UploadUpload the ZIP into it with Upload
  4. Kliknij ZIP prawym przyciskiem → ExtractRight-click the ZIP → Extract
  1. Połącz się danymi FTP od hostinguConnect with the FTP details from your host
  2. Wejdź do public_html/ i utwórz folder, np. galeria/Go to public_html/ and create a folder, e.g. gallery/
  3. Wgraj do niego rozpakowaną zawartość ZIPUpload the unpacked ZIP contents into it

Dalej adres https://twoja-domena.pl/galeria oznacza folder, który tu utworzyłeś.

From now on https://your-domain.com/gallery stands for the folder you created here.

✓03Baza danychDatabase ·
Krok 03 / 09WybórChoice

Baza danychThe database

Instalator ma dwa tryby. Wybierz jeden — krok 04 pokaże pola właśnie dla niego.

The installer has two modes. Pick one — step 04 will show the fields for it.

ZalecanyRecommended

Instalator sam zakłada bazę, użytkownika i uprawnienia przez API cPanelu. Tu nic nie robisz — w kroku 04 podasz adres panelu, login i hasło do cPanelu.

The installer creates the database, user and privileges via the cPanel API. Nothing to do here — in step 04 you enter the panel address, cPanel login and password.

Gdy hosting nie ma cPanelu albo wolisz własne nazwy. W MySQL® Databases:

When your host has no cPanel or you prefer your own names. In MySQL® Databases:

  1. Utwórz bazę, np. studio_galeriaCreate a database, e.g. studio_gallery
  2. Utwórz użytkownika z silnym hasłemCreate a user with a strong password
  3. Dodaj go do bazy z ALL PRIVILEGESAdd it to the database with ALL PRIVILEGES
Zapisz te dane
Write these down

Nazwa bazy, użytkownik i hasło będą potrzebne w kroku 04.

The database name, user and password are needed in step 04.

✓04Instalator uruchomionyInstaller completed
Krok 04 / 09ObowiązkowyRequired

Uruchom instalatorRun the installer

Otwórz w przeglądarce adres folderu z kroku 02 i dopisz ścieżkę instalatora:

Open the folder address from step 02 in your browser and add the installer path:

https://twoja-domena.pl/galeria/install/install.php

Pierwszy ekran sprawdza PHP 8.3, ionCube i rozszerzenia. Wszystko na zielono — idziesz dalej.

The first screen checks PHP 8.3, ionCube and extensions. All green — carry on.

Dane bazy · tryb z kroku 03Database details · mode from step 03
Adres panelu
Panel address
panel.twoja-domena.pl
Login i hasło cPanel
cPanel login and password
te same, którymi logujesz się do hostinguthe ones you use to sign in to your hosting
Host
localhost — gdy nie działa, 127.0.0.1— if that fails, 127.0.0.1
Baza / użytkownik / hasło
Database / user / password
dane zapisane w kroku 03the details saved in step 03
Reszta formularzaRest of the form
Site URL
https://twoja-domena.pl/galeria
Studio Name
nazwa studia widoczna dla klientówstudio name shown to clients
Nadawca e-mail
Sender e-mail
noreply@twoja-domena.pl
Admin Email / Password
Twój login do panelu — ustaw silne hasłoyour panel sign-in — set a strong password

Kliknij Zainstaluj. Po chwili zobaczysz potwierdzenie — w trybie automatycznym także dane bazy. Zachowaj je.

Click Install. A moment later you'll see a confirmation — in automatic mode also the database details. Keep them.

✓05Folder install/ usuniętyinstall/ folder removed
Krok 05 / 09ObowiązkowyRequired

Usuń folder instalacyjnyRemove the install folder

Bez tego nie kończ
Don't skip this

Folder install/ nie może zostać na serwerze — pozwoliłby uruchomić instalację od nowa.

The install/ folder must not stay on the server — it would allow running the installation again.

Najszybciej: przycisk Usuń folder /install/ na ekranie potwierdzenia. Możesz też skasować go przez FTP albo menedżer plików.

Quickest: the Delete /install/ folder button on the confirmation screen. You can also delete it via FTP or the file manager.

✓06Zalogowany do paneluSigned in to the panel
Krok 06 / 09ObowiązkowyRequired

Zaloguj się do paneluSign in to the panel

https://twoja-domena.pl/galeria/admin/

E-mail i hasło to te, które podałeś w instalatorze jako Admin Email / Password.

Use the email and password you entered in the installer as Admin Email / Password.

✓07Licencja aktywnaLicence active
Krok 07 / 09ObowiązkowyRequired

Aktywuj licencję i utwórz pierwszą galerięActivate your licence and create your first gallery

Po instalacji system działa w okresie próbnym. Gdy się skończy, istniejące galerie działają dalej, ale nie utworzysz nowych.

After installation the system runs in a trial period. When it ends, existing galleries keep working, but you can't create new ones.

AktywacjaActivation
  1. Kliknij plakietkę Trial w prawym górnym rogu paneluClick the Trial badge in the top-right corner of the panel
  2. Wpisz klucz licencyjny z maila i adres e-mail podany przy zakupieEnter the licence key from your email and the email used at purchase
  3. Kliknij Aktywuj licencję — plakietka zmieni się na AktywnaClick Activate licence — the badge changes to Active
Pierwsza galeriaFirst gallery
  1. W panelu: Galerie → Nowa galeriaIn the panel: Galleries → New gallery
  2. Podaj nazwę galerii, klienta i jego e-mail; hasło jest opcjonalneEnter the gallery name, client and their email; the password is optional
  3. Wybierz motyw, utwórz galerię i przeciągnij zdjęciaPick a theme, create the gallery and drag in your photos
  4. Wyślij link — klient dostanie maila z adresem galeriiSend the link — the client gets an email with the gallery address
✓08Aplikacja mobilnaMobile app
Krok 08 / 09OpcjonalnyOptional

Aplikacja mobilnaThe mobile app

Panel fotografa na Androida: galerie, zdjęcia, selekcje klientów, sesje, zapytania o termin i powiadomienia push. Plik APK pobierzesz z panelu, ze strony licencji — po aktywacji.

The photographer's panel for Android: galleries, photos, client selections, sessions, booking requests and push notifications. Download the APK from the panel, on the licence page — after activation.

Adres serwera
Server address
ten sam co Site URL, np. the same as Site URL, e.g. https://twoja-domena.pl/galeria
Login i hasło
Login and password
te same co do paneluthe same as for the panel
Google Play Protect

Aplikacja instaluje się z pliku, nie ze Sklepu Play, więc Android może pokazać „Play Protect nie zna aplikacji tego dewelopera”. Wybierz Zainstaluj mimo to.

The app installs from a file, not from the Play Store, so Android may show “Play Protect doesn't recognise this app's developer”. Choose Install anyway.

✓09Ochrona antybotowa sprawdzonaBot protection checked
Krok 09 / 09Jeśli dotyczyIf applicable

Ochrona antybotowa hostinguHosting bot protection

Wiele hostingów stawia przed stroną weryfikację „Potwierdź, że nie jesteś robotem” — np. ochrona antyDDoS hostingu, Cloudflare (Bot Fight Mode), Imunify360. Człowiek w przeglądarce klika i idzie dalej. Aplikacja mobilna tego nie zrobi — pokaże wtedy: „Hosting zablokował aplikację ochroną antybotową”.

Many hosts put a “Confirm you are not a robot” check in front of your site — e.g. the host's anti-DDoS layer, Cloudflare (Bot Fight Mode), Imunify360. A person in a browser clicks and moves on. The mobile app cannot — it will show: “Hosting blocked the app with bot protection”.

Wyjątek dla ścieżkiPath exception
/galeria/api/v1/*

Zamień /galeria na swój folder z kroku 02. W panelu hostingu szukaj sekcji w rodzaju „zaufane endpointy”, „wyjątki” lub „whitelist” i wybierz typ ścieżka — nie adres IP, bo telefon zmienia go między Wi-Fi a siecią komórkową. Brak takiej opcji? Poproś o nią pomoc techniczną hostingu.

Replace /galeria with your folder from step 02. In your hosting panel look for something like “trusted endpoints”, “exceptions” or “whitelist” and choose the path type — not an IP address, as the phone switches it between Wi-Fi and mobile data. No such option? Ask your host's support.

Wyjątek zdejmuje wyłącznie weryfikację antybotową dla API aplikacji. Zapora (WAF), ochrona logowania i sama strona galerii zostają chronione jak dotąd.

The exception lifts only the bot check for the app API. The firewall (WAF), sign-in protection and the gallery site itself stay protected as before.

PomocHelp

Najczęstsze problemyCommon issues

Instalator: brak ionCube Loader albo zła wersja PHPInstaller: ionCube Loader missing or wrong PHP version
  • W panelu hostingu ustaw PHP 8.3 dla tej domenySet PHP 8.3 for this domain in your hosting panel
  • Na liście rozszerzeń PHP włącz ionCube Loader i odśwież instalatorEnable ionCube Loader in the PHP extensions list and reload the installer
„Database connection failed”
  • Sprawdź nazwę bazy, użytkownika i hasłoCheck the database name, user and password
  • Sprawdź, czy użytkownik ma uprawnienia do bazyCheck that the user has privileges on the database
  • Spróbuj 127.0.0.1 zamiast localhostTry 127.0.0.1 instead of localhost
„Could not write config.php”
  • Folder galerii musi mieć prawo zapisu (755 lub 775)The gallery folder needs write access (755 or 775)
  • W menedżerze plików: prawy przycisk → Permissions; właścicielem ma być Twoje kontoIn the file manager: right-click → Permissions; your account must be the owner
Nie widzę paneluI can't see the panel
  • Sprawdź adres — panel jest pod /admin/Check the address — the panel is under /admin/
  • Upewnij się, że folder install/ jest usuniętyMake sure the install/ folder has been removed
  • Wyczyść pamięć przeglądarki (Ctrl+Shift+Del)Clear your browser cache (Ctrl+Shift+Del)
Aplikacja: „Hosting zablokował aplikację ochroną antybotową”App: “Hosting blocked the app with bot protection”
  • Dodaj wyjątek dla ścieżki /api/v1/* — zobacz krok 09Add a path exception for /api/v1/* — see step 09
Okres próbny wygasłThe trial has expired
PomocHelp

Wsparcie techniczneTechnical support

Coś nie działa albo wolisz, żebyśmy zainstalowali system za Ciebie? Napisz — podaj adres strony, numer kroku i to, co widzisz na ekranie.

Something not working, or would you rather we install it for you? Write to us — include your site address, the step number and what you see on screen.

support@progallery.pl