Instalacja i konfiguracja

Wymagania

  1.  Hosting z obsługą PHP 8 i mod_rewrite albo własny serwer (Apache, LiteSpeed, Nginx). Strona będzie działać także na starszej wersji PHP, choć nie polecam.  W zasadzie obecnie każdy hosting spełni te wymagania. Sam korzystam z webd.pl (link afiliacyjny) i jestem zadowolony. Najtańsza opcja kosztuje obecnie zaledwie sto złotych rocznie i z powodzeniem spełni wymagania.
  2.  Dostęp do FTP lub SFTP potrzebny do przesłania plików strony, również w przypadku tworzenia galerii do przesłania zdjęć (plików graficznych), a także wtedy, jeśli zamierzamy umieścić na stronie jakieś pliki do pobrania. Warto dodać, że w zasadzie każdy hosting zapewnia taki dostęp i/lub własny menedżer plików w przeglądarce.
  3. Potrzebny będzie także adres strony i raczej trzeba będzie sobie domenę wykupić. Epoka darmowych subdomen się w zasadzie skończyła, choć jest jeszcze parę możliwości, aczkolwiek niezbyt atrakcyjnych. Kupując hosting zwykle też dostajemy subdomenę w ramach tego hostingu, choć zwykle to nie jest prestiżowa i ładna nazwa.

Instalacja

  1. Jeśli strona korzysta z hostingu, który pozwala na zdalne rozpakowanie archiwów, to pierwszym krokiem będzie przesłanie pliku archiwum na zdalny serwer. W przeciwnym wypadku trzeba archiwum rozpakować lokalnie i przesyłać pliki do odpowiedniego katalogu serwera.
  2. Pliki strony muszą być w głównym katalogu strony, czyli takim do którego prowadzi adres strony, np. twojadomena.pl i otworzy się główny plik index.php. Dobrze jest wcześniej obejrzeć sobie szablony miniPHP i do wybranego przez siebie wykonać plik graficzny (logo strony)oraz przesłać na serwer.
  3. Gdy korzystamy z hostingu, wszystkie przesłane pliki stają się własnością użytkownika hostingu, a instancja serwera httpd działa z uprawnieniami tego użytkownika. Jeżeli to jest jakiś inny serwer, należy się upewnić przed konfiguracją, że instalator będzie miał prawa do zapisu plików. Kiedy już przekonamy się, że wszystko działa prawidłowo, możemy przystąpić do szczegółowej konfiguracji.
    Zobacz stronę instalatora Instalator w trybie podglądu

Konfiguracja

  1. Konfiguracja składa się z kilku etapów. Część z nich wykonać można lokalnie i potrzebne będą programy graficzne, część zaś można wykonać zdalnie np. za pomocą panelu hostingu typu cPanel lub przy połączeniu FTP (SFTP) z serwerem.
  2. Po umieszczeniu plików na serwerze, pierwszą czynnością powinno byc uruchomienie install.php. Ten plik pozwoli na ustanowienie loginu i hasła do edycji zawartości. Potem przejdziemy do danych strony, wyglądu, konfiguracji formularza kontaktowego oraz konfiguracji podstron. Po wykonaniu czynności plik zmieni nazwę na install.php.old, dopisze dyrektywę zabezpieczającą do .htaccess i przeniesie nas do index.php, czyli wyświetli stronę. W razie potrzeby zmiany hasła, trzeba na serwerze przywrocić starą nazwę pliku instalcyjnego i go uruchomić w przeglądarce.
  3. Przygotowanie plików graficznych. Warto wykonać sobie mały plik png o wielkości 32x32 piksele i nazwać go favicon.ico i zamienić nim plik znajdujący sie w instalce. Nic się nie stanie, jeśli tego nie zrobimy, po prostu będzie wyświetlac się oryginalna ikonka miniPHP.
  4. Należy też przygotować główny plik graficzny, który ma sie wyświetlić u góry strony. Zwykle mówi się, że to logo strony. W niektórych szablonach wystarczy, jeśli będzie to zwykły jpg, ale przeważnie lepiej będzie wyglądać plik png z transparentnym tłem. Jeśli ktoś potrafi może przygotować grafikę wektorową svg. Taki plik musi mieć nazwę, którą potem wpiszemy do konfiguracji (np. header.png lub header.svg). Warto też zrobić sobie obrazek o nazwie fb-image.jpg, który będzie wykorzystany do ewentualnego udostępniania strony w serwisach takich jak Facebook lub X. Przykłady graficznego layoutu można sobie obejrzeć na stronie Galeria.
  5. Ważne dla konstrukcji strony pliki graficzne trzeba przesłać na serwer i wykorzystać do tego np. połączenie FPT (SFTP). Kolejne pliki graficzne (gif, jpg, jpeg, png, webp) można już przesyłać korzystając ze strony Wysyłanie. Aby uniknąć przypadkowego nadpisania ważnych dla wyglądu strony plików graficznych, mechanizm wysyłania nie pozwala nadać plikom istniejących już nazw. Gdy plik znajduje się juz na serwerze umieszczamy go na stronie stosując przycisk Wstaw/edytuj obraz. Zdjęcia i rysunki na stronie to dziś rzecz oczywista, pamiętać należy, że wstawianie zdjęć prosto z aparatu o szerokości sięgające 5000 pikseli to zdecydowanie zły pomysł. Będą to duże pliki i będą spowalniać działanie strony.
  6. Kilka uwag o opcjach instalatora, który służy do konfiguracji witryny. Trzeba będzie wpisać tytuł strony, jej krótki opis, słowa kluczowe, slogan strony, autora, naszą domenę (to będzie ważne dla udostępnienia np. na Facebooku). Prócz tego jeszcze zredagować trzeba zawartość stopki strony i wpisać swój mail, jeśli będziemy korzystać z formularza kontaktowego. Ten plik można edytować lokalnie lub bezpośrednio na serwerze, o ile mamy taką możliwość. W dalszej części edycji  trzeba skonfigurować kolejne podstrony. Jak będą się nazywać linki (np. o-firmie.html), jak będzie wyglądał napis w menu (np. O firmie) oraz jak będzie wyglądał tytuł tej podstrony (np. Informacje o firmie). Domyślnie tych stron łącznie z formularzem jest pięć. Jeśli wcześniej zakomentujemy część pozycji w pliku config.inc.php, możemy zmniejszyć ich ilość, możemy też dodać następne dopisując je według tego samego schematu. Jeśli liczba podstron  wzrośnie, lepiej wybrać szablon z pionowym menu po lewej stronie. Używając wpisu true lub false, możemy właczyć lub wyłączyć formularz kontaktowy.
  7. Konfigurację trzeba przeprowadzić uważnie, żeby uniknąć błędów, instalator ma wskazówki zapisane pod każdym okienkiem, więc nie powinno być to szczególnie trudne.
  8. Ważne jest zdecydowanie się na określony typ wyglądu. MiniPHP ma kilka szablonów, można je sobie przerabiać, jeśli ktoś potrafi. Kolejne szablony bedą się pojawiać sukcesywnie. Szablony są katalogu /themes, a w nich pliki css. Do łatwych zadań należy np. zmiana kolorów. 
  9. Do dyspozycji użytkownika jest również prosta galeria z tzw. lightboxem. Jest zaprogramowana tak, że poszczególne galerie tworzymy dodając katalogi w katalogu obrazków. A więc np. /img/wakacje i stosujemy tag [gallery] wakacje [/gallery] - obrazki będą się wyświetlać w kolejności alfabetycznej, a więc należy to wziąć pod uwagę nadając nazwy plikom, o ile zależy nam na konkretnej kolejności.
  10. Jeśli chcemy udostępnić pliki do pobrania, wysyłamy je za pomocą FTP (SFTP) na serwer. Do tego służy katalog /files. A następnie na odpowiedniej stronie używamy opcji  Wstaw/edytuj łącze (Ctrl+K). W wyskakującym okienku wpiszemy na przykład: files/nasz-plik.pdf w rubryce URL.
  11. Edycja ręczna pliku .htaccess bedzie potrzebna jeśli będziemy chcieli ponownie uruchomić instalator. Linie zaczynające się od:
    # ------------------------------------------------------------
    # Ochrona przed bezpośrednim uruchamianiem PHP
    # Dodane automatycznie przez install.php
    należy usunąć, a nazwę pliku install.php.old zmienić na install.php.