# PHP-Fusion Readme

Copyright © 2002 - 2011 Nick Jones
Wersja: 7.02.01 - Data wydania: 18/04/2011

## WPROWADZENIE

PHP-Fusion to lekki system zarządzania treścią (CMS) o otwartym kodzie źródłowym, napisany w PHP 5. Wykorzystuje bazę danych MySQL do przechowywania danych Twojej strony oraz zawiera prosty i wszechstronny system administracyjny. PHP-Fusion zawiera większość elementów, jakie można zobaczyć w innych CMS -ach.

Niniejszy program jest wolnym oprogramowaniem; możesz go rozprowadzać dalej i/lub modyfikować na warunkach Affero General Public License, wydanej przez Fundację Wolnego Oprogramowania - według wersji 3. tej Licencji lub którejś z późniejszych wersji.

Niniejszy program rozpowszechniany jest z nadzieją, iż będzie on użyteczny - jednak BEZ JAKIEJKOLWIEK GWARANCJI, nawet domyślnej gwarancji PRZYDATNOŚCI HANDLOWEJ albo PRZYDATNOŚCI DO OKREŚLONYCH ZASTOSOWAŃ. W celu uzyskania bliższych informacji - Affero General Public License.

Z pewnością wraz z niniejszym programem dostarczono Ci też egzemplarz Affero General Public License, jeśli nie, wejdź na www.fsf.org.

Ważne informacje: Nie wolno Ci usunąć informacji o prawach autorskich, tj:

> Powered by PHP-Fusion copyright © 2002 - 2011 by Nick Jones.
> Released as free software without warranties under GNU Affero GPL v3.

Osoby chcące usunąć stopkę powinny zapoznać się z licencją dostępną na www.php-fusion.co.uk.

## INSTALACJA

Przed instalacją upewnij się, że Twój serwer spełnia minimalne wymagania PHP-Fusion:

- PHP 5
- MySQL 4

Przed instalacją PHP-Fusion potrzebujesz utworzyć bazę danych MySQL. Możesz to zrobić poprzez panel zarządzający Twoim hostingiem lub w phpMyAdmin. Upewnij się, że masz pod ręką dane dostępu do MySQL, wliczając w to adres hosta, nazwę użytkownika, hasło oraz nazwę bazy danych, aby móc je podać podczas instalacji.

1. Zanim wgrasz pliki na serwer, zmień nazwę pliku _config.php (umieszczonego w katalogu /files) na config.php.
2. Wgraj zawartość katalogu /files na serwer.
3. O ile nie uruchamiasz PHP-Fusion na lokalnym serwerze, w większości przypadków będzie potrzeba zmiany praw dostępu dla następujących plików i katalogów, by umożliwiały zapis dla wszystkich (CHMOD 777):
   - administration/db_backups/
   - downloads/
   - downloads/images/
   - downloads/submissions/
   - downloads/submissions/images/
   - forum/attachments/
   - ftp_upload/
   - images/
   - images/imagelist.js
   - images/articles/
   - images/avatars/
   - images/news/
   - images/news/thumbs/
   - images/news_cats/
   - images/photoalbum/
   - images/photoalbum/submissions/
   - config.php
   Informacja: Niektóre serwery nie pozwalają na ustawienie praw zapisu dla wszystkich (CHMOD 777), w takim wypadku należy użyć CHMOD 755.
4. Przejdź na swoją stronę internetową, gdzie plik setup.php powinien uruchomić się automatycznie. Jeśli nie, potrzebujesz uruchomić plik setup.php ręcznie poprzez ręczne wpisanie pełnego adresu strony, po którym dopiszesz /setup.php. Przykład:
   http://www.yourdomain.com/setup.php.
5. Postępuj według pojawiających się na ekranie wskazówek.
6. Natychmiast po zakończeniu instalacji PHP-Fusion musisz zmienić prawa dostępu dla pliku config.php na tylko do odczytu (CHMOD 644) ORAZ usunąć plik setup.php z Twojego serwera.

## AKTUALIZACJA Z V7.00.XX lub v7.01.XX

Przed dokonaniem aktualizacji zaleca się wykonanie kopii zapasowej wszystkich plików oraz bazy danych. PHP-Fusion v7.02 jest bezpośrednim następcą PHP-Fusion v7.01. Musisz dokładnie przejść przez wszystkie etapy niniejszej instrukcji. Dodatkowo przy przejściu z PHP-Fusion v7.00 zaleca się wcześniejszą aktualizację do v7.01, a dopiero potem do v7.02.

1. Wersja 7.02 PHP-Fusion jest w dużej części kompatybilna z v7.01, jednakże wprowadzone zmiany mogą spowodować, że część wtyczek, skórek, modyfikacji czy paneli może nie działać poprawnie.
2. Po pierwsze, musisz wgrać skrypt aktualizujący z katalogu /upgrade v7 (lub /upgrade v701 jeśli aktualizujesz z v7.01) do katalogu /administration znajdującego się na Twoim serwerze oraz katalog /files/locale do głównego katalogu strony. Bez plików językowych, część nazw nie doda się poprawnie.
3. Zaloguj się jako Główny administrator i przejdź do zakładki Zarządzanie stroną w panelu administratora, kliknij na Aktualizacja, a następnie postępuj zgodnie z pojawiającymi się na ekranie wskazówkami. MUSISZ przejść przez wszystkie etapy aktualizacji! Proces aktualizacji kończy się dopiero wtedy, gdy na ekranie będzie jedynie widoczny komunikat 'Database upgrade complete'.
4. BARDZO WAŻNE: W tym wydaniu wprowadzono wiele zmian w strukturze systemu, niektóre elementy Twojej strony mogą nie działać poprawnie, dopóki nie zaktualizujesz wszystkich plików. MUSISZ wgrać WSZYSTKIE pliki z katalogu /files oprócz plików:
   - _config.php
   - setup.php
5. Zmień prawa dostępu dla następujących katalogów, by umożliwić zapis dla wszystkich (CHMOD 777):
   - downloads/
   - downloads/images/
   - downloads/submissions/
   - downloads/submissions/images/
   - ftp_upload/

Jeśli masz jakiekolwiek wątpliwości, nie krępuj się i zapytaj na forum jednego z supportów o pomoc. W naszej społeczności mamy wielu doświadczonych użytkowników, którzy mogą pomóc lub poradzić podczas procesu aktualizacji.

## PORADY DOTYCZĄCE BEZPIECZEŃSTWA

Kilka porad, które mogą poprawić bezpieczeństwo Twojej strony:

- upewnij się, że plik config.php jest tylko do odczytu (powinien mieć CHMOD 644),
- nigdy nie pozostawiaj pliku setup.php na serwerze, gdy PHP-Fusion jest już zainstalowane,
- upewnij się, że hasła do FTP i MySQL różnią się od siebie oraz że są bezpieczne,
- nigdy nie pozwalaj by załączniki na forum miały rozszerzenia .php, .html, .exe lub jakikolwiek inne rozszerzenie plików tekstowych,
- korzystaj jedynie ze sprawdzonych i uznanych za bezpieczne dodatków.

## OFICJALNE SUPPORTY

Jeśli masz pytanie lub problem dotyczący PHP-Fusion, odwiedź stronę poświęconą temu projektowi - www.php-fusion.co.uk i napisz wiadomość na naszym forum. Postaramy się rozwiązać Twój problem w ciągu 48 godzin.

Dodatki: Możliwości PHP-Fusion można rozszerzyć dodając wtyczki (Infusions), które instaluje się w niezwykle prosty sposób. Możesz znaleźć wiele użytecznych wtyczek na stronie AddonDB. Jeśli interesują Cię polskojęzyczne dodatki, wejdź na stronę Laboratorium Modułów

Jeśli nie satysfakcjonują Cię standardowe, dołączone do PHP-Fusion skórki, ponownie odwiedź oficjalną bazę skórek dla PHP-Fusion: AddonDB. Ich pokaźną kolekcję można też zobaczyć w polskojęzycznej galerii Themes4Fusion, a następnie pobrać z Laboratorium Modułów.

PHP-Fusion ma też szereg stron, wokół których skupia się społeczność użytkowników PHP-Fusion krajów takich jak: Arabia Saudyjska, Brazylia, Czechy, Dania, Francja, Hiszpania, Iran, Niderlandy (Holandia, Belgia), Niemcy, Norwegia, Polska,Rosja, Rumunia, Szwecja, Turcja, Węgry i Włochy.

## ZGŁASZANIE BŁĘDÓW

W przypadku znalezienia błędów, zgłoś je do swojego krajowego Supportu lub Głównego Supportu (po angielsku). Więcej informacji na stronach poszczególnych Supportów.

## POLSKA WERSJA PHP-FUSION

Polska wersja PHP-Fusion została przygotowana w ramach projektu PHP-Fusion po polsku przez zespół administratorów, moderatorów i użytkowników Polskiego Oficjalnego Supportu PHP-Fusion.
Jeśli widzisz błędy w PHP-Fusion, zgłoś je na naszym forum. Uważasz, że polskie tłumaczenie zawiera wymagające poprawy niedociągnięcia? Napisz nam o tym korzystając z odpowiedniego formularza dostępnego na - http://www.launchpad.net/pf-pl.

## PODZIĘKOWANIA

### Założyciel projektu

- Nick Jones {Digitanium}

### Kierownik projektu

- Hans Kristian Flaatten {Starefossen}

### Główni programiści

- Andy B {gh0st2k}
- Arda Kilicdagi {SoulSmasher}
- Christian Damsgaard Jørgensen {PMM}
- Karoly Nagy {Korcsii}
- Maarten Kossen {mpkossen/mistermartin75}
- Marcus Gottschalk {MarcusG}
- Max Toball {Matonor}
- Nicolae Crefelean {Kneekoo}
- Paul Beuk {Muscapaul}
- Robert Gaudyn {Wooya}

### Zespół programistów

- Craig Dewar {Fangree_Craig
- James {Daywalker}
- Johan K. Jensen {Josso}
- Patric Forcelini {IceWasp}
- Sveinung Skjaerseth {sveinungs}

### Zarządzanie

- Arda Kilicdagi {SoulSmasher}
- Hans Kristian Flaatten {Starefossen}
- Happy Svensson {KEFF}
- Jan Mølgaard {Janmol}
- Johan Wilson {Barspin}
- Nick Jones {Digitanium}
- Nicolae Crefelean {Kneekoo}
- Paul Beuk {Muscapaul}
- Philip Daly {Hobbyman}
- Richard Ainz {Homdax}

### Dodatkowe wsparcie

- Philip Daly {Hobbyman}
- Johan Wilson {Barspin}
- Valerio Vendrame {lelebart}
- Claus Pedersen {Flyingduck}

### Skrypty autorstwa osób trzecich:

- TinyMCE v3.3.8 - Edytor HTML WYSIWYG autorstwa Moxiecode.
- PHPMailer v2.0.4 - Klasa wysyłające e-maile ze wsparciem dla SMTP autorstwa Brenta R. Matzelle'a.
- HTTPDownload v1.3 - Klasa obsługująca download autorstwa Nguyen Quoc Bao.
- jQuery v1.5.0 - Biblioteka Javascript/Ajax.
- Nuvola Icons - Grafiki użyte w tagach BBCode, kategoriach newsów i ikonach administracyjnych autorstwa Davida Vignoni.