[ phpMyFAQ Documentacja ]

(obowiązuje dla wersji: 1.3.0 i nowszych)

  1. Wstęp
    1. Licencja
    2. Wsparcie
    3. Prawa autorskie
  2. Instalacja
    1. Wymagania
    2. Przygotowanie
    3. Skrypt instalacyjny
    4. Pierwsze kroki
    5. Uwagi
  3. Aktualizowanie
    1. Aktualizowanie phpMyFAQ 1.1.x
    2. Aktualizowanie phpMyFAQ 1.2.x
    3. Modyfikacja szablonów phpMyFAQ 1.3.x
  4. Administracja
    1. Administracja użytkownikami
    2. Administracja wpisami
    3. Administracja kategoriami
    4. Administracja nowościami
    5. Edycja pytań otwartych
    6. Statystyka ocen
    7. Cookies
    8. Przeglądanie sesji
    9. Przeglądanie sesji administratora
    10. Zmiana hasła
    11. Edycja konfiguracji
    12. Kopie zapasowe
    13. Wylogowanie
  5. Zmiany makiety, szablonów i arkuszy stylu
    1. Plik template/index.html
    2. Plik template/style.css
    3. Inne szablony
  6. I coś jeszcze na koniec

1. Wstęp

phpMyFAQ jest wielojęzycznym skryptem do tworzenia FAQ wykorzystującym bazę danych. Obecnie do przechowywania danych używany jest MySQL (w przyszłości wykorzystanę zostaną inne bazy danych), zaś PHP 4.1.0 (lub nowszy) jest stosowany do uzyskiwania połączeń z bazą danych. phpMyFAQ jest także systemem do zarządzania treścią (CMS) wykorzystującym role użytkowników z różnymi poziomami uprawnień. phpMyFAQ ma wbudowany system informowania o nowościach, śledzenia zachowania użytkownika, różne moduły językowe, szablony, obszerne wsparcie dla XML i PDF, system kopii zapasowych oraz łatwy w użyciu skrypt instalacyjny.

Poniższa dokumentacja ma wyjaśnić podstawowe zasady instalacji i administracji phpMyFAQ.

na górę strony


1.a. Licencja

phpMyFAQ opublikowany został w ramach Publicznej Licencji Mozilli w wersji 1.1 (MPL). Gwarantuje on darmowe użytkowanie phpMyFAQ, dostęp do kodu źródłowego oraz prawo do modyfikacji i rozpowszechniania skryptu.

Jedynym ograniczniem jest prawo autorskie, które przysługuje Bastianowi Poettnerowi i Thorstenowi Rinne. Każda zmodyfikowana wersja phpMyFAQ również podlega warunkom licencji MPL. Ograniczenia te nie dotyczą innych programów, które wykorzystują tylko niektóre funkcje phpMyFAQ, zatem mogą one być rozpowszechniane na dowolnych warunkach licencyjnych.

Komercyjne wykorzystanie lub dystrybucja phpMyFAQ, np. na CD-ROM, jest dozwolone tylko wówczas, gdy zachowana jest zgodność z powyższą licencją.

Zdecydowaliśmy się na wykorzystanie licencji MPL, ponieważ uważamy, iż jest ona rozsądnym kompromisem między otwartością kodu i swobodnym rozpowszechnianiem, a oddziaływaniem z innym oprogramowaniem niezależnie od przyjętego modelu licencjonowania. W porównaniu do innych modeli licencjonowania, MPL charakteryzuje się krótkim tekstem, który jest zrozumiały nawet dla początkujących.

na górę strony


1.b. Wsparcie

Jeśli w trakcie używania phpMyFAQ wystąpią jakiekolwiek problemy, zapraszamy do zgłoszenia tego na forum dyskusyjnym www.phpmyfaq.de. Nie oferujemy wsparcia telefonicznego lub za pomocą poczty elektronicznej.

na górę strony


1.c. Prawa autorskie

© 2001 - 2003 Bastian Poettner i Thorsten Rinne w ramach Publicznej Licencji Mozilli.
Wszelkie prawa zastrzeżone.

na górę strony


2.Instalacja

2.a. Wymagania phpMyFAQ

phpMyFAQ odwołuje się do bazy danych MySQL z poziomu PHP4. W celu pomyślnej instalacji skryptu niezbędne jest posiadanie serwera z:

  • PHP4 4.1.0 lub nowszym (Uwaga: phpMyFAQ 1.3.x nie będzie działać w PHP niższym niż 4.0.x)
  • MySQL 3.23.23 lub nowszą
  • niniejsza dokumentacja

Powyższe wymagania można sprawdzić uruchamiając na serwerze skrypt info.php z funkcją:

    <?php phpinfo(); ?>

Ten skrypt należy wysłać na serwer i otworzyć w przeglądarce. Wyświetlone zostaną wóczas wersje PHP i MySQL, które są zainstalowane na docelowym serwerze. Ponadto, skrypt instalacyjny phpMyFAQ również sprawdza te same dane podczas procesu instalacji. Jeśli wskazane wymagania nie będą spełnione, instalacja się nie uda.

phpMyFAQ nie będzie można używać na serwerze z PHP3 lub PHP 4.0.x.

Do przeglądania stron FAQ niezbędne jest posiadanie przeglądarki internetowej trzeciej generacji (np. Netscape 3.01). Formatowanie arkuszy stylów CSS będzie widoczne dopiero dla przeglądarek Netscape 6 lub Internet Explorer 5. Wykorzystanie funkcji wydruku wpisów z poziomu stron FAQ możliwe jest tylko przy włączeniu w przeglądarce obsługi JavaScript. Internet Explorer pozwala na taki wydruk dopiero od wersji 5.

na górę strony


2.b. Przygotowanie

phpMyFAQ rozprowadzane jest w formie skompresowanego archiwum ZIP. Pobrane archiwum należy rozpakować na dysku komputera. Lista wszystkich plików archiwum dostępna jest w phpmyfaq.txt.

Makietę phpMyFAQ można zmieniać przy pomocy szablonów. Opis działania szablonów znajduje się poniżej. Wszystkie rozpakowane z archiwum pliki należy pzresłać na serwer za pomocą dowolnego narzędzia FTP. Pliki można przenieść do dowolnego katalogu na serwerze - sugerujemy jednak utworzenie w tym celu katalogu faq/.
Ważne:
W katalogu, do którego skopiowano phpMyFAQ, musisz mieć prawa do zapisu - dotyczy to skryptów konfiguracyjnych data.php i config.php. W szczególności dotyczy to sytuacji, gdy PHP pracuje jako CGI lub jako mod_php z włączonym trybem safe-mode.

na górę strony


2.c. Skrypt instalacyjny

Otwórz w przeglądarce URL:

    http://www.twojadomena.com/faq/install/installer.php

Oczywiście, www.twojadomena.com musi być zastąpiona rzeczywistą nazwą domenową. Po załadowaniu powyższej strony należy podać adres serwera MySQL (np. db.dostawcainternetu.com), nazwę użytkownika MySQL, jego hasło dostępu i nazwę bazy danych. Pole prefiksu tabel MySQL można pozostawić puste. Jeżeli zamierzasz korzystać z wielu egzemplarzy FAQ w jednej bazie danych, to sugerujemy wprowadzenie prefiksów - np. sport dla FAQ poświęconemu sportowi, pogoda dla FAQ o pogodzie itd. Warto pamiętać, że prefiks może składać się tylko z liter oraz znaku podkreślenia dolnego "_". Używanie wielu egzemplarzy FAQ wymaga niezależnego zainstalowania phpMyFAQ w różnych katalogach (np. faq1/, faq2/. faq3/ itd.). Naciśnięcie przycisku "install" rozpoczyna proces instalacji tabel w wybranej bazie danych.

na górę strony


2.d. Pierwsze kroki

Niezwłocznie po udanej instalacji FAQ należy usunąć katalog /install! Dopiero po tej operacji można wejść do FAQ:

    http://www.twojadomena.com/faq/index.php

FAQ będzie puste i w domyślnej makiecie. W celu konfiguracji phpMyFAQ należy wejść tu

    http://www.twojadomena.com/faq/admin/index.php

Domyślną nazwą użytkownika (login) jest admin z hasłem admin. Po tej autoryzacji następuje przejście do sekcji administracyjnej. W pierwszej kolejności należy zmienić domyślne hasło administratora.

na górę strony


2.e. uwagi

Funkcje wyszukiwarki:

Przeszukiwanie pełnotekstowe będzie działać dopiero wtedy, gdy w bazie FAQ znajdzie się przynajmniej 5 wpisów. Poszukiwane wyrażenie nie powinno znajdować się w więcej niż połowie wszystkich wpisów naszego FAQ, ponieważ w takim przypadku nic nie zostanie znalezione. To nie jest błąd, lecz właściwość bazy MySQL.

Ustawienia PHP:

O ile posiadasz dostęp do pliku php.ini, warto sprawdzić czy zmienna file_upload jest ustawiona na file_upload = On; w przeciwnym wypadku nie będzie działać opcja dodawania załączników do poszczególnych wpisów FAQ.

na górę strony


3. Aktualizowanie

Aktualizowanie do 1.3.0 jest możliwe dla poniższych wersji phpMyFAQ:

  • phpMyFAQ 1.1.x
  • phpMyFAQ 1.2.x

na górę strony


3.a. Aktualizowanie phpMyFAQ 1.1.x

Aktualizowanie phpMyFAQ 1.1.x jest proste. Po połączeniu FTP należy usunąć wszystkie pliki za wyjątkiem:

  • plików data.php i config.php w katalogu inc/

Następnie pliki nowej wersji FAQ należy wysłać na serwer i za pomocą przeglądarki otworzyć stronę:

    http://www.twojadomena.com/faq/install/update.php

Otworzy się formularz, z którego trzeba wybrać wersję FAQ, która ma być aktualizowana, a następnie klinąć przycisk aktualizacji. Należy pamiętać o usunięciu katalogu /install niezwłocznie po udanej aktualizacji! Logowanie do sekcji administracyjnej należy przeprowadzić używając domyślnego loginu i hasła (admin/admin). W pierwszej kolejności należy zmienić domyślne hasło administratora.

na górę strony


3.b. Aktualizowanie phpMyFAQ 1.2.x

Aktualizowanie phpMyFAQ 1.2.x również nie jest kłopotliwe. Należy usunąć wszystkie pliki za wyjątkiem:

  • data.php i config.php w katalogu inc/
  • obecnie używanej makiety w katalogu template/

Następnie pliki nowej wersji FAQ należy wysłać na serwer i wejść przeglądarką na stronę:

    http://www.twojadomena.com/faq/install/update.php

Otworzy się formularz, z któego należy wybrać wersję FAQ, która ma być aktualizowana i następnie klinąć przycisk aktualizacji. Należy pamiętać o usunięciu katalogu /install niezwłocznie po udanej aktualizacji! Logowanie do sekcji administracyjnej należy przeprowadzić używając domyślnego loginu i hasła (admin/admin). W pierwszej kolejności należy zmienić domyślne hasło administratora.

W celu dalszego używania w phpMyFAQ 1.3.0 istniejących szablonów, trzeba je nieco dostosować do nowszej wersji skryptu. Wyjaśnienia znajdują się w następnym paragrafie.

na górę strony


3.c. Modyfikacja szablonów dla phpMyFAQ 1.3.x

phpMyFAQ 1.3.0 jest wielojęzyczne oraz obsługuje PDF, zatem istniejące szablony należy zmodyfikować tak, by uwzględniały obsługę tych nowych funkcji. W phpMyFAQ 1.3.0 zmieniono następujące szablony:

  • template/artikel.html
  • Sugerujemy używanie nowego szablonu dostarczonego wraz z 1.3.0 - można go dostosować do własnych potrzeb i uniknąć zbędnych problemów.

  • template/index.html
  • Zmienił się kod JavaScript - nowy trzeba skopiowac do starego szablonu w miejscu wskazanym tu <script language="JavaScript" type="text/javascript"></script> - bez tej zmiany druk bezpośrednio ze stron FAQ nie będzie możliwy.

  • template/style.css
  • Tu trzeba dodać nowe wartości dla znaczników <pre>.

  • template/writecomment.html
  • Sugerujemy używanie nowego szablonu dostarczonego wraz z 1.3.0 - można go dostosować do własnych potrzeb i uniknąć zbędnych problemów.

na górę strony


4. Administracja

Całą administrację phpMyFAQ prowadzi się przez przeglądarkę. Sekcja administracyjna zlokalizowana jest pod adresem:

    http://www.twojadomena.com/faq/admin/index.php

Wejście do tej sekcji jest możliwe po podaniu loginu i hasła. Po zalogowaniu się zostanie wyświetlona strona z menu administracyjnym po lewej oraz niektórymi statystykami, wpisami i komentarzami w części głównej. Menu administracyjne zawiera:

  • Administracja użytkownikami
  • Dodaj wpis
  • Akceptuj wpisy
  • Edytuj wpisy
  • Administracja kategoriami
  • Dodaj nowości
  • Edytuj nowości
  • Edytuj pytania otwarte
  • Statystyka
  • Cookies
  • Sesje
  • Sesje Admina
  • Zmień hasło
  • Edytuj konfigurację
  • Kopia zapasowa
  • Wyloguj
  • Początek

na górę strony


4.a. Zarządzanie użytkownikami

phpMyFAQ posiada możliwość elastycznego nadawania różnych poziomów uprawnień dla zarejestrowanych użytkowników. Różnym osobom - zarejestrowanym z różnymi loginami i hasłami - można przydzielać odmienne uprawnienia. Uprawnienia są bardzo szczegółowe: można np. pozwolić użytkownikowi na edycję wpisów, ale już nie na ich usuwanie. Uprawnienia tego rodzaju należy przydzielać rozważnie. Przykładowo, edycja wpisu może prowadzić do całkowitego usunięcia jego treści - a to w praktyce jest równoważne usunięciu danego wpisu. Nie ma ograniczeń liczby zarejestrowanych użytkowników.

Przegląd wszystkich zarejestrowanych użytkowników dostępny jest na głównym ekranie sekcji "Administracja użytkownikami". Na tej stronie znajduje się lista ich profili wraz z cyfrowym oznaczeniem poziomu uprawnień - wartość 1 oznacza, że użytkownik ma dane uprawnienie, wartość 0 przeciwnie: że nie ma danego uprawnienia. Kolejność tych cyfrowych oznczeń odpowiada jednoznacznie ich kolejności na stronie, na której są one przypisane do danego użytkownika.

Należy pamiętać, iż nowy użytkownik z definicji nie ma żadnych uprawnień - zostają mu one przydzielone na stronie edycji jego profilu. Użytkownik znany jako admin nie może być usunięty, a jego login (admin) nie może być zmieniony.

na górę strony


4.b. Administracja wpisami

  • Dodawanie wpisów

    Wpisy można dodawać bezpośrednio w sekcji administracyjnej. Z definicji nowy wpis NIE jest publikowany - czyli nie jest dostępny w publicznej części phpMyFAQ. Formularz dodawania nowego wpisu składa się z następująych pól:

    • Temat
      To miejsce na wpisanie pytania FAQ lub czołówki pozostałej części wpisu
    • Treść
      W tym miejscu można wpisać odpowiedź na zadane w FAQ pytanie lub rozwiązanie problemu podanego w czołówce. Dopuszcza się w tym miejscu zastosowanie paru podstawowych znaczników HTML do formatowania wprowadzanego tekstu:
      • <b>...</b> - pogrubienie pisma
      • <i>...</i> - kursywa
      • <u>...</u> - podkreślenie
      • <a href="http://www.url.com">...</a> - łącze do http://www.url.com

      Ze względów bezpiczeństwa pozostałe znaczniki HTML są usuwane. Treść wpisów można formatować znacznikami BB-Code.

      Aktywacja BB-Codes w FAQ wyklucza stosowanie wyżej wzmiankowanych znaczników HTML - w takiej sytuacji można używać tylko BB-Codes. Oto lista BB-Codes:

      • [b]...[/b] - pogrubienie pisma
      • [i]...[/i] - kursywa
      • [u]...[/u] - podkreślenie
      • [ul]...[/ul] - lista wyliczeniowa. Pojedyncze składowe takiej listy uzyskuje się w ten sposób: [li]punktor 1[/li] wewnątrz znacznika [ul]
      • [code]...[/code] - preformatowany tekst np. dla fragmentów kodu.
      • [php]...[/php] - preformatowany tekst dla kodu php (jego użycie spowoduje kolorowanie składni)
      • [img]...[/img] - wstawia grafikę - musi być wprowadzony w formie pełnego URLa http://www.url.com/grafika.jpg
      • [url]www.phpmyfaq.de[/url] - łącze do http://www.phpmyfaq.de otwierane w nowym oknie
      • [url=http://www.phpmyfaq.de]nazwane łącze[/url] - łącze z nazwą do phpMyFAQ otwierane w nowym oknie
      • wszystkie adresy URL są automatycznie przekształcane na łącza.

      Po włączeniu BB-Codes na publicznej części phpMyFAQ automatycznie pojawia się łącze do strony z pomocą. BB-Codes muszą być wpisane małymi literami.

    • Plik
      Do konkretnego wpisu można dodać plikowy załącznik. Takie załączniki przechowywane są w specjalnej ścieżce, do której odnosi się dany wpis. Jeśli żaden wpis nie odnosi się do załącznika, pozostaje on niewidoczny.
    • Język

    • Można określić język każdego wpisu. Z definicji przyjmuje się, iż wpis jest w jezyku używanym przez przeglądarkę. Tworzenie wpisów w różnych językach wygląda następująco.
      Napisz tekst w języku angielskim (lub dowolnym innym), a następnie zapisz go. Następnie wybierz opcję edytuj wpisy i wtedy wybierz ostatnio wprowadzony wpis w języku angielskim. Zmień temat, treść, słowa kluczowe i sam język - np. portugalski używany w Brazylii. Zachowaj taki wpis. Wtedy pokliknięciu opcji edytuj wpisy, obydwa pojawią się na liście, będą posiadać ten sam identyfikator, lecz różnić się będą językami.
    • Słowa kluczowe
      Słowa kluczowe brane są pod uwagę przy przeszukiwaniu bazy danych. W przypadku, gdy dane słowo nie znajduje się w samej treści wpisu, lecz oddaje jego charakter, wówczas warto wpisać je w pole słów kluczowych. Wtedy rezulataty przeszukiwania będą bardziej adekwatne. Możliwa jest także sytuacja inna: można celowo wśród słów kluczowych zamieścić słowa nie powiązane z treścią danego wpisu. W takiej sytuacji nawet wpisanie przy wyszukiwaniu złego terminu zaowocuje poprawnym wynikiem przeszukiwania.
    • Autor
      To pole jest opcjonalne. Nie zostaje wyświetlane na FAQ i służy tylko celom technicznym.
    • Kategoria
      Położenie danego wpisu w hierarchii całego FAQ zależy od przypisania do wybranej kategorii.
    • Aktywować
      Aktywowanie wpisu wyświetla go w publicznej części FAQ i pozwala przeszukiwać. Deaktywacja wpisu czyni go niewidocznym dla publiczności - dla anonimowego internauty. Wpisy, które są zaproponowane przez anonimowych internautów domyślnie pozostają deaktywowane. Chroni to FAQ przed nadużyciami
    • Data
      Data ostatniej zmiany.
    • Dokonano zmian?
      Dzięki temu polu można śledzić jakich zmian dokonano w danym wpisie. Jest to informacja szczególnie cenna, gdy FAQ prowadzone przez wspólnie przez kilka osób. Informacje wpisane do tego pola nie będą widoczne w części publicznej FAQ.
    • Sesje
      W tej części są zapisywane wszystkie wcześniejsze zmiany w części administracyjnej włącznie z dodawaniem nowych użytkowników i zmianami treści.
  • Akceptuj wpisy
    Sekcja zawiera wszystkie nieaktywne wpisy, które pozostają niewidoczne w części publicznej FAQ. Tutaj także zlokalizowane są wszystkie sugestie i propozycje od internautów. W celu akceptacji tych wpisów należy klinąć łącze, o którym mowa, i edytować wybrane wpisy. Gdy zdecydujesz "Zaakceptować" wpis - stanie się on "Aktywny" i będzie widoczny w publicznej części FAQ. Oczywiście w tym miejscu można także usunąć wybrany wpis. Przed takim usunięciem będziesz poproszony o potwierdzenie swojej decyzji.
  • Edytuj wpisy
    Na tej stronie pojawiają się wszystkie wpisy. Kliknięcie na wybranym wpisie otworzy taki sam formularz, jak przy dodawaniu nowego wpisu.

na górę strony


4.c. Adminstracja kategoriami

W phpMyFAQ można tworzyć kategorie i podkategorie FAQ. Ponadto można zmieniać ich kolejność. Niestety - jeszcze pracujemy nad tą ostatnią funkcjonalnością.

na górę strony


4.d. Adminstracja nowościami

Na startowej stronie phpMyFAQ publikowane są nowości dotyczące samego FAQ. Sekcja administracyjna służy do dodawania nowych wiadomości, edycji lub usuwania istniejących.

na górę strony


4.e. Edycja pytań otwartych

Anonimowi internauci mogą za pośrednictwem phpMyFAQ zadawać pytania. Takie pytania otwarte publikowane są w publicznej części FAQ. Internauci mogą dawać odpowiedzi na pytania otwarte. Z poziomu sekcji administracyjnej można odrzucać zadane pytania otwarte, a także przypisać im odpowiedzi w celu publikacji w FAQ.

na górę strony


4.f. Statystyka ocen

Pod każdym wpisem w FAQ znajduje się narzędzie do oceniania. Każdy wpis może być oceniony w skali od 1 do 5 - gdzie 1 to ocena najniższa, a 5 najwyższa. Dla każdego ocenionego wpisu wyświetlona zostaje jego ocena średnia oraz ilość wszystkich oddanych głosów. W sekcji administracyjnej wyświetlany jest skrócony przegląd takich ocen - wpisy z punktacją poniżej 2 oznaczone są czerwonym kolorem, natomiast kolor zielony wskazuje średnie oceny od 4 w górę.

na górę strony


4.g. Cookies

Przy każdym zalogowaniu do phpMyFAQ w komputerze logującego się zapisywane jest cookie. To dość wygodne narzędzie, ale zawsze stanowi ono potencjalną dziurę w bezpieczeństwie. Cookies należy zatem stosować tylko na tym komputerze, do którego tylko my mamy dostęp.

na górę strony


4.h. Sesje

Dzięki tej funkcji można obserwować zachowanie gości. Każdemu odwiedzającemu przypisywany jest identyfikator, który towarzyszy w ciągu przeglądania stron FAQ. Na podstawie tych użytecznych informacji można dostosować treść i strukturę FAQ do potrzeb odwiedzających go internautów. W tej części można także przeszukać zgromadzone sesje w celu odnalezienia określonych adresów IP, minimalnych liczb określonych działań lub daty wizyt.

na górę strony


4.i. Sesje Admina

Tutaj zbierane są informacje o zachowaniach użytkowników, którzy zalogowali się do sekcji administracyjnej phpMyFAQ. Gdy podejrzewasz, że do systemu dostał się potencjalny włamywacz - tu można się o tym upewnić.

na górę strony


4.j. Zmień hasło

Nazwa sekcji wyjaśnia jej charakter. W tej części administratora można uniemożliwić zarejestrowanemu użytkownikowi zmianę hasła. Może to być użyteczne przy wielu zarejestrowanych w systemie osobach.

na górę strony


4.k. Edytuj konfigurację

Ta część phpMyFAQ służy do zmiany ogólnej konfiguracji. Nie można tu zmieniać kolorystyki i makiety. Należy pamiętać, że nie wolno używać znaczników HTML, gdy aktywowana jest opcja BB-Codes.

Jeśli trzeba wprowadzić wiele adresów email, należy oddzielać je przecinkami (",").

na górę strony


4.l. Kopia zapasowa

Za pomocą tej funkcji można utworzyć kopię zapasową całego FAQ w jednym pliku. Dzięki temu odtworzenie FAQ w sytuacji kryzysowej nie stanowi problemu. W ten sposób można także odtwarzać system przy porzenosinach na nowy serwer. Sugerujemy regularne tworzenie kopii zapasowych.

  • Kopia zapasowa danych
    Ten rodzaj kopii zawiera wszystkie wpisy, użytkowników, komentarze itd.
  • Kopia zapasowa LOGów
    Zawiera sesje i sesje admina (czyli wszystkie pliki LOG). Oczywiście ponowne uruchomienie FAQ nie wymaga uprzedniego posiadania tego rodzaju kopii. Służą one celom statystycznym
  • utwórz plik XML
    W pliku XML można zapisać wszystkie wpisy FAQ. Wygenerowany plik XML trafi do katalogu xml/phpmyfaq.xml. Trwają prace programistyczne nad narzędziem do importowania tak przygotowanego materiału do systemu.

na górę strony


4.m. Wyloguj

Kliknięcie na Wyloguj usuwa bieżącą sesję, czyli wylogowuje użytkownika. Rekomendujemy takie wylogowanie z oczywistych względów bezpieczeństwa.

na górę strony


5. Zmiany makiety, szablonów i arkuszy stylów

Począwszy od wersji 1.2.0 kod skryptu i wygląd są niemal zupełnie oddzielone. Makieta opiera się na kilku szablonach - można je zmieniać i dostosować do wyglądu istniejącego serwisu WWW. Najważniejsze pliki szablonów znajdują się w katalogu template/.

Uwaga: szablony nie dotyczą wyglądu sekcji administracyjnej. Jeżeli chcesz zmieniać wygląd części administracyjnej, musisz zmodyfikować plik admin.php. Należy pamiętać, że taki zmieniony wygląd strony administratora zostanie usunięty przy pierwszej aktualizacji phpMyFAQ.

na górę strony


5.a. Plik template/index.html

Domyślna makieta phpMyFAQ zawiera się w pliku index.html. Jest to normalny plik HTML zawierający zmienne ujęte w nawiasy klamrowe - w miejsce zmiennych wpisywana jest treść FAQ.

Przykład:

    <td width="200" class="little" align="center">{userOnline}</td>

W trakcie analizy pliku template/index.html zmienna {userOnline} zostaje zastąpiona aktualną liczbą internautów przeglądających w danej chwili strony FAQ.

Szablony można swobodnie zmieniać, choć sugerujemy zachowanie kopii oryginalnych szablonów na wszelki wypadek. Teoretycznie szablony można zmieniać posługując sie dowolnym edytorem - testy przeprowadzone z użyciem Dreamweaver'a przebiegły pomyślnie. Jednak Microsoft Frontpage, Adobe GoLive lub NetObjects Fusion mogą uszkodzić szablony.

na górę strony


5.b. Plik template/style.css

Krój pisma, czcionki, kolorystyka i temu podobne można zmieniać z poziomu arkusza stylów kaskadowych style.css. Kompendium informacji o CSS znajduje się na oficjalnej stronie W3C.

na górę strony


5.c. Inne szablony

Jeśli takie będzie życzenie większości, możemy przygotować większą liczbę szablonów. Zapraszamy do odwiedzenia naszego forum dyskusyjnego w celu zgłoszenia zapotrzebowania na nowe szablony.

na górę strony


6. I coś jeszcze na koniec

Dziękujemy za pobranie i używanie phpMyFAQ! :-)

Autorzy niniejszej dokumentacji: Thorsten Rinne, Bastian Poettner
Ostatnia zmiana: 06.05.2003

Poszukujemy ochotników, którzy zechcą wykonać kolejne przekłady dokumentacji.

Podziękowania:
Stephan Hochhaus za anglojęzyczną dokumentację,
Matthias Sommerfeld za pomoc przy tłumaczeniu na angielski,
Volodymyr Ganopolskyy za dokumentację rosyjskojęzyczną,
Erwin Leenheer za przekład dokumentacji na holenderski,
Hanne Parusel za grafikę phpMyFAQ,
Kai-Uwe Wärner za testowanie wersji beta,
Siegfried Meffert za pomysły struktury bazy danych,
zespołowi IG4 i wszystkim innym stosującym nasze oprogramowanie na swoich stronach WWW

© 2001-2003 Thorsten Rinne und Bastian Poettner

na górę strony