Instalacja

TubePress instaluje się jak każda klasyczna aplikacja PHP: prześlij pliki, skieruj przeglądarkę na swoją domenę i postępuj zgodnie z krótkim kreatorem konfiguracji. Bez wiersza poleceń, bez etapu kompilacji.

Zarezerwuj około pięciu minut. Przed rozpoczęciem upewnij się, że serwer spełnia wymagania i miej pod ręką dane dostępu do bazy danych.

Pobierz TubePress

Pobierz najnowszą wersję ze strony pobierania. To pojedynczy, niewielki plik ZIP zawierający pełny, edytowalny kod źródłowy PHP — bez klucza licencyjnego i bez ionCube.

Prześlij na serwer

Rozpakuj plik ZIP i prześlij jego zawartość na serwer za pomocą FTP/SFTP lub menedżera plików swojego hostingu. Jedyna ważna zasada: web root musi wskazywać na katalog public/, a nie na katalog główny projektu. Wszystko inne — config/, src/, storage/, themes/, plugins/ — znajduje się poziom wyżej niż document root i nigdy nie jest serwowane bezpośrednio.

Uruchom instalator WWW

Odwiedź swoją domenę w przeglądarce. Ponieważ marker config/installed.php jeszcze nie istnieje, TubePress skieruje Cię bezpośrednio do kreatora konfiguracji. Składa się on z sześciu kroków:

1. Powitanie. Krótki ekran wprowadzający — kliknij, aby rozpocząć.
2. Sprawdzenie systemu. Weryfikuje wersję PHP, rozszerzenia i katalogi z możliwością zapisu. Gdy wszystkie wymagane sprawdzenia przejdą pomyślnie, instalator automatycznie przechodzi dalej; jeśli coś nie przejdzie, każdy element rozwija się z instrukcją naprawy.
3. Baza danych. Wprowadź host, nazwę, użytkownika i hasło bazy danych. TubePress łączy się, tworzy bazę danych jeśli może (lub używa istniejącej na hostingu współdzielonym), wykonuje wszystkie migracje SQL i zapisuje plik config/database.php. Pole hosta akceptuje również format host:port lub ścieżkę do gniazda.
4. Administrator. Utwórz konto administratora — nazwę użytkownika (3–50 znaków), prawidłowy adres e-mail i hasło o długości co najmniej 8 znaków.
5. Ustawienia. Nadaj nazwę swojej witrynie (opis jest opcjonalny). Adres URL witryny jest wykrywany automatycznie, a domyślna liczba filmów na stronę wynosi 24 — obie wartości można edytować później.
6. Ukończono. TubePress tworzy domyślne strony, ustawienia i wartości domyślne SEO, zapisuje marker instalacji i udostępnia link do nowego panelu administracyjnego.

Uprawnienia do plików

Użytkownik serwera WWW (często www-data) musi być właścicielem i mieć możliwość zapisu w trzech lokalizacjach: config/ (do zapisywania ustawień), storage/ (logi, pliki tymczasowe i kopie zapasowe) oraz public/uploads/ (Twoje multimedia). Sprawdzenie systemu oznaczy te lokalizacje, które nie mają uprawnień do zapisu.

# Give the web-server user ownership
chown -R www-data:www-data config storage public/uploads

# Directories 755, files 644
find config storage public/uploads -type d -exec chmod 755 {} \;
find config storage public/uploads -type f -exec chmod 644 {} \;

Tylko te trzy ścieżki muszą mieć możliwość zapisu przez serwer; reszta struktury plików może pozostać tylko do odczytu.

Apache vs Nginx

Oba są w pełni obsługiwane i wykrywane automatycznie podczas instalacji.

• Apache — ustaw AllowOverride All, aby dostarczone pliki .htaccess obsługiwały czyste adresy URL i blokowały dostęp do wrażliwych folderów. Po zakończeniu instalacji TubePress tworzy dowiązania symboliczne public/themes i public/templates, dzięki czemu zasoby motywu są prawidłowo rozwiązywane.
• Nginx — dodaj standardową regułę try_files … /index.php?$query_string, utwórz alias /themes/ i /templates/ wskazujące na foldery projektu i zastosuj deny dla ścieżek config/, src/ i storage/. Pełne fragmenty konfiguracji znajdują się w Wymaganiach.

Lokalne środowisko deweloperskie (localhost)

TubePress działa na zwykłej instalacji localhost z protokołem HTTP bez żadnej specjalnej konfiguracji — instalator, sesje i logowanie działają bez HTTPS. Dwie proste opcje:

• Lokalny serwer WWW (najbliższy środowisku produkcyjnemu) — wskaż Apache lub Nginx na folder public/, dokładnie jak powyżej.
• Wbudowany serwer PHP (bez konfiguracji) — z katalogu głównego projektu uruchom poniższe polecenie, a następnie otwórz http://localhost:8000.

php -S localhost:8000 -t public public/router.php

Dołączony plik router.php zapewnia czyste adresy URL, a kontroler frontu serwuje zasoby motywu i panelu administracyjnego bezpośrednio — dzięki czemu stylizacja działa od razu bez konfigurowania aliasów zasobów.

Po instalacji

Zaloguj się pod adresem /admin przy użyciu właśnie utworzonego konta i zacznij konfigurować swoją witrynę. Przewodnik pierwsze kroki przeprowadzi Cię przez konfigurację identyfikacji witryny, brandingu, pierwszych filmów i listy kontrolnej przed uruchomieniem. Warto też wcześnie wzmocnić logowanie do panelu administracyjnego — patrz Bezpieczeństwo.

Następne kroki