# PHP-Fusion Readme

Copyright © 2002 - 2010 Nick Jones
Wersja: 7.01.04 - Data wydania: 21/01/2011

## WPROWADZENIE

PHP-Fusion to lekki system zarządzania treścią (CMS) o otwartym kodzie źródłowym, napisany w PHP 5 (kompatybilny z PHP 4). 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 - 2008 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ą 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 były one zapisywalne dla wszystkich (CHMOD 777):
   - administration/db_backups/
   - images/
   - images/imagelist.js
   - images/articles/
   - images/avatars/
   - images/news/
   - images/news/thumbs/
   - images/news_cats/
   - images/photoalbum/
   - images/photoalbum/submissions/
   - forum/attachments/
   - config.php
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

Przed dokonaniem aktualizacji zaleca się wykonanie kopii zapasowej wszystkich plików oraz bazy danych. PHP-Fusion v7.01 jest bezpośrednim następcą PHP-Fusion v7.00. Musisz dokładnie przejść przez wszystkie etapy niniejszej instrukcji.

1. Wersja 7 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 do katalogu /administration znajdującego się na Twoim serwerze oraz katalog /files/locales 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

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 przecią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, Brazylia, Bułgaria, Czechy, Dania, Francja, Hiszpania, Iran, Niderlandy (Holandia, Belgia), Niemcy, Norwegia, Polska, Rosja, Rumunia, Słowacja, 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 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 na stronie poświęconej polskim plikom językowym do PHP-Fusion - http://www.launchpad.net/pf-pl.

## PODZIĘKOWANIA

### Założyciel projektu

- Nick Jones {Digitanium}

### Główni programiści

- Hans Kristian Flaatten {Starefossen}
- Maarten Kossen {mpkossen/mistermartin75}
- Paul Beuk {Muscapaul}
- Arda Kilicdagi {SoulSmasher}
- Nicolae Crefelean {Kneekoo}

### Zespół programistów

- Sveinung Skjaerseth {sveinungs}
- Johan K. Jensen {Josso}
- James {Daywalker}
- Craig Dewar {Fangree_Craig}
- Karoly Nagy {Korcsii}

### Zarządzanie

- Happy Svensson {KEFF}
- Jan Mølgaard {Janmol}
- Paul Beuk {Muscapaul}
- Nicolae Crefelean {Kneekoo}
- Arda Kilicdagi {SoulSmasher}
- Hans Kristian Flaatten {Starefossen}
- Philip Daly {Hobbyman}

### Dodatkowe wsparcie

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

### 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.4.2 - Biblioteka Javascript/Ajax.
- Nuvola Icons - Grafiki użyte w tagach BBCode, kategoriach newsów i ikonach administracyjnych autorstwa Davida Vignoni.