FLEKS 2.2 - instrukcja instalacji

Na początek:

FLEKS (Forumowy Lekki, Elastyczny i Konfigurowalny Styl, dawniej Jdevo) pozwala na wprowadzenie dynamicznie zmieniającego się stylu na forach punBB (planowane jest wprowadzenie obsługi innych for), oraz konfigurowania go przez użytkownika.

Instalacja

By zainstalować FLEKS potrzebujesz hostingu www, np. darmowy CBA.PL.
Uwaga! FLEKS wymaga PHP5 (w wersji 5.1.3 lub nowszej). Jeśli twój hosting nie wspiera tej wersji PHP - poszukaj lepszego. ;)

Podstawy

W folderze fleks/css znajduje się kilka plików: Przykładowo:
Gdy korzystasz z telefonu w nocy ładowane są pliki mobi.css i noc.css.
Gdy korzystasz z komputera w dzień ładowane są pliki pc.css i dzien.css.
Z tego powodu zalecam ścisły podział - kolory tylko w dzien.css i noc.css, a cała reszta, czyli struktura forum do pc.css i mobi.css.
Oprócz wyżej wymienionych należy otworzyć plik dane.php i zmienić wszystkie dane strony znajdujące się między akapitami na własne (dane strony są w linijkach zaczynających się od $FLEKS).

Wysyłanie gotowych plików na serwer

Należy skopiować folder fleks wraz z jego zawartością poprzez FTP na serwer (przykładowy klient ftp: Filezilla).
Po przesłaniu plików wpisz w przeglądarce adres folderu fleks na serwerze, np.:
http://mojserwer.example.com/fleks/
W efekcie powinna wyświetlić Ci się strona z konfiguracją stylu. ;)

Uwaga! Jeśli po otwarciu pliku styl.css wyświetli Ci się informacja w stylu:
Warning: Cannot modify header information
Jeśli używasz Windowsa musisz zainstalować program Notepad++ i otworzyć nim plik styl.php.
Następnie wybrać Format -> Konwertuj na format UTF-8 bez BOM, zapisać plik i wysłać go ponownie na serwer.
Jeśli używasz Linuksa: Notepad++ niestety nie ma wersji dla Linuksa. Jednakże jeśli używasz tego systemu to prawdopodobnie wiesz co zrobić. ;)

Łączenie FLEKS z twoim forum

Wklej poniższy kod do Modyfikacji CSS w panelu administracyjnym forum.
@import url(http://mojserwer.example.com/fleks/styl.css);

Następnie umieść w ogłoszeniu poniższy kod. Umieści on ramkę z ustawieniami FLEKS w Profil->Wyświetlanie.
<script type="text/javascript">$('#profile5').before('<form id="profile5"><div class="inform"><fieldset><legend>Dodatkowe ustawienia forum</legend><label><iframe src="http://mojserwer.example.com/fleks/ustawienia.php" width="100%" height="640px"></iframe></label></fieldset></div></form>');</script>
Pamiętaj aby zmienić mojserwer.example.com na właściwy adres, gdzie umieściłeś pliki!
Zalecam również umieszczenie w dowolnej części forum odnośnika do konfiguracji stylu, np. w Dodatkowe odnośniki w menu.

GRATULACJE! Udało Ci się poprawnie zainstalować i skonfigurować FLEKS na swoim forum! :)

Dodawanie własnych opcji

W nowej wersji FLEKS zadbałem, by dodawanie własnych opcji było jak najłatwiejsze! :3
Jedyny plik, który musisz w tym celu edytować to dane.php.
Przykładowa opcja: $opcja[] = 'przyklad';
$tytul_opcji['przyklad'] = 'Przykładowa opcja.';
$opis_opcji['przyklad'] = 'Ta opckja jest tylko przykładowa.';

//Domyślna wartość:
$przyklad[0]['NAZWA'] = 'Domyślnie';
$przyklad[0]['OPIS'] = 'Kolor niebieski';
$przyklad[0]['KOD'] = 'div.costam {color:blue};';

//Alternatywna wartość:
$przyklad[1]['NAZWA'] = 'Czerwony';
$przyklad[1]['OPIS'] = 'Kolor czerwony oraz dużo kodu z oddzielnego pliku';
$przyklad[1]['KOD'] = 'div.costam {color:red}; ';
$przyklad[1]['PLIK'] = 'css/nic.css';

Nazwę przyklad we wszystkich liniach kodu należy zastąpić własną, unikalną (nie może zawierać polskich znaków, spacji ani znaków specjalnych).
Następne linie tekstu to każda kolejna wartość opcji. Wartość z numerem 0 (pierwsza w kolejności) to wartość domyślna.
Zmienne obejmujące opis, kod, plik - są opcjonalne. Nie trzeba ich dawać jeśli nie ma takiej potrzeby.

Kod CSS może zajmować kilka lini tekstu np.:
$moje_avki[1]['KOD'] =
'/* Moje avatary */
div.awek {color: black}
.awek img {width: 100%}';

Ważne rzeczy:

Dodatkowe opcje do wgrania (gotowce).

Jak wgrywać własne opcje napisałem powyżej. Tutaj zostawiam kilka gotowców, które mogą komuś się przydać. ;)
Należy je wkleić w to miejsce dane.php, gdzie mają się wyświetlić (np. jeśli chcemy, by dana opcja wyświetliła się przed wyborem urządzenia wklejamy kod przed linią //Urządzenie.
Dźwięk w ChatBoxie: //Dźwięk w ChatBoxie
$opcja[] = 'dzwiek';
$tytul_opcji['dzwiek'] = 'ChatBox - powiadomienia dźwiękowe';

$dzwiek[0]['NAZWA'] = 'Włączone';
$dzwiek[0]['KOD'] = 'div.cb_all:last-child object { display: block;} .cb_wlacz {opacity: 1} .cb_wylacz {opacity: 0.5}';

$dzwiek[1]['NAZWA'] = 'Wyłączone';
$dzwiek[1]['KOD'] = '.cb_wlacz {opacity: 0.5} .cb_wylacz {opacity: 1}';
Nie jest to samodzielny kod! Instrukcje wgrywania znajdziesz
[TU].
Dźwięk jest domyślnie wyłączony (jeśli chcecie mieć domyślnie włączony - przeróbcie, to wcale nie jest ciężkie). ;)

Changelog

FLEKS 2 Beta 1 Pierwsze publiczne wydanie FLEKS!
FLEKS 2 Beta 2
FLEKS 2 Beta 3
FLEKS 2.0
FLEKS 2.1
FLEKS 2.1.1
FLEKS 2.2

Roadmap

Tutaj opisane są planowane PRZYSZŁE zmiany.
Przyszłe wersje:

Licencja

FLEKS jest rozpowszechniane na licencji GNU General Public License v3.0 i jest dostępne bezpłatnie.
Treść licencji możesz przeczytać tutaj: http://www.gnu.org/licenses/gpl-3.0.txt
Zabronione jest usuwanie informacji o licencji i autorze.
Użyto kod Sunrise - Sunset (sunrise-sunset.php) by Mike Challis oraz Mobile Detect (Mobile_Detect.php) na licencji MIT .