jPORTAL jest kompletnym systemem portalowym (coś jak PHP-Nuke) co oznacza, że za jego pomocą możesz praktycznie bez żadnej wiedzy na temat tworzenia stron (dynamicznych, HTML jest wskazany :)) sprawić sobie mały, średni a nawet duży serwis / vortal / portal.

Jak wygląda praca z systemem? Na początku najlepiej przeczytać tę dokumentacje, zainstalować system na swoim kompie i zapoznać się z jego obsługą. Wszystko polega na administracji serwisem internetowym za pomocą przeglądarki - możesz dodawać newsy, artykuły, bloki menu, pliki do download, linki do katalogu stron, bannery itd. klikając i wypełniając formularze. Możesz dodać także innych adminów, którym ustawisz prawa dostępu (np. tylko newsy) a oni będą pracować przy stronie :).

Jeżeli nie potrafisz sobie poradzić z instalacją bądź konfiguracją jPORTAL zajżyj na forum oficjalnej strony jPORTAL (Jucarii sexuale ieftine). Znajdziesz tam również dodatki do systemu takie jak dodatkowe moduły (np. galeria zdjęć) czy skóry. Proszę o nie pisanie maili do mnie ponieważ od pomocy jest forum!

- pytania, sugestie, komentarze: http://jportal.one.pl.
- najnowsza wersja jPORTAL: http://jportal.one.pl.
- artykuły na temat PHP i MySQL: http://phparea.one.pl.

ZAPRASZAM!
Patrz licencja.html.
Od wersji 2.0 raj dla leniwych! Nowy jPORTAL został wyposażony w instalator. Aby go uruchomić odpal system, powinna pokazać się biała strona z błędem bazy danych, dopisz za adrsem: install, podaj parametry bazy danych (dla mniej doświadczonych: naprawdę nie znam parametrów twojej bazy, zapytaj o to admina!), serwisu (nie jest to konieczne, możesz zmienić później) i kliknij w instaluj. Jeżeli uruchamiasz instalator na serwerze unix'owym musisz nadać plikom odpowiednie atrybuty (777). Jak to zrobić - niżej.

Uwaga! System zapisuje dane w plikach tekstowych więc w systemach Unixowych (Unix, Linux itd.) należy ustawić plikom odpowiednie prawa, najlepiej wykonać chmod 777 dla wszystkich plików w systemie (jak to zrobić opisane jest w artykule na http://phparea.one.pl)
Cały proces konfiguracyjny odbywa się za pomocą modułu w panelu admina. Oczywiście można też konfigurować w plikach co nie jest zbyt trudne jednak nie wspomnę o tym ani słowa, nie po to pisałem ten moduł.
Tutaj znajdziesz opis możliwości poszczególnych modułów wraz z drobnymi radami i wskazówkami, drobnymi dlatego, że obsługa systemu jest banalnie prosta! Aby dostać się do panelu wpisz admin.php. Początkowy login to: admin a hasło to: aaa. Użytkownik admin ma nieograniczony dostęp...

ogólne
1. Make clickable
We wszystkich modułach działa tzw. funkcja make clickable czyli automatyczna zamiana adresów (www jak i e-mail) na linki.

2. BBcode
jPORTAL obsługuje odrobinę obciętą wersje BBcode, brak takich znaczników jak color i size, które mogą tylko zapaprać stronę. Jest dodatkowy znacznik, nazywa się link i służy adminom do tworzenia linku z adresem względnym np. pliki/plik.zip, przy użyciu znacznika url należałoby wpisać http://serwer.com.pl/cos_tam/pliki/plik.zip. Oczywiście jest też rozszerzona wersja link czyli [link=xxx]napis[/link], normalne wykorzystanie to [link]xxx[/link]. Tych, którzy nie znają BBcode zapraszam do zobaczenia na forum w tym jP, jest tam opis (kliknij 'nowy temat')

3. Uśmieszki
Można je wyłączyć w panelu admina (ustawienia). Zamieniają takie rzeczy jak np. :) na obrazek. Są też specjalne :lol: (chamski śmiech) i :deb: (gość wali się młotem po głowie).

news
1. Opis
System newsów, newsy można komentować lub przesłać znajomemu, dostępna jest także opcja wersji do druku. Odwiedzający może dodać news do bazy jednak przed jego publikacją musi zostać zatwierdzony przez admina.

2. Dodawanie
Obsługa intulicyjna. Nie musisz uzupełniać pola długa treść, jest ono opcjonalne i w przypadku braku długiej treści nie będzie też linku do niej kierującego pod newsem. Obrazek do newsa można wysłać na serwer za pomocą formularza bądź podać URL obrazka, można oczywiście wogóle go nie ustawiać. Obrazki znajdują się w katalogu upload/news/. W treści newsów można używać znaczników HTML i BBcode, system sam zamienia adresy na linki.

3. Działy
Teraz i Newsy można dodawać do działów (ale nie trzeba!). Działy są uniwersalne dla newsów i artykułów, aby odczytywać newsy według działu użyj strony tnews.php. UWAGA, niezależnie od tego czy news jest w dziale czy nie, wyświetlany jest na stronie głównej.

4. Strony
Zmieniła się zasada korzystania z newsów. Sugeruję, aby do archiwum przekierowywać TYLKO ważne wiadomości a resztę zostawiać tak jak zostały dodane, będą one dzielone po kilka, kilkanaście na stronę - zależy to od ustawień.

działy
1. Opis
Arty dzielone są na działy. Używa się tego gdy liczba artykułów jest duża i można je łatwo pogrupować ze względu na treść np. motocykle, samochody, ciężarówki. Istnieje możliwość dzielenia newsów!

artykuły
1. Opis
Artykuły listowane są w działach standardowo według daty co można zmienić w panelu admina. Dodatkowo każdy gość strony może sam zmienić sposób sortowania, który zostanie zapisany ciastku.

2. Dodawanie
Obsługa intuicyjna. W opisie do arta jak i w treci możesz używać znaczników HTML. Możesz wybrać opcję NL2BR, która automatycznie zamienia "entery" na znaczniki HTML'owe, nie poleca sie tego gdy w treści są HTML'owe tabele. Jeżeli artykuł jest bardzo długi i jego czytanie na jednej stronie sprawia problem możesz w jego treści wpisać znacznik <nextpage>. W jego miejscu system zakończy wyświetlanie arta, dodatkowo wyświetli panel nawigacyjny po stronach. W artykule można wpisać dowolną ilość znaczników, jednak aby zachować estetykę strony przy użyciu funkcji NL2BR nie powinno się wstukiwać "enterów" przed ani za znacznikiem.

infopages
1. Opis
Infopages służą do publikacji stron, których nie chcemy mieć w artykułach (np. info o sobie). Dodawanie jak w artykułach.

2. Wyświetlanie
Zobacz jaki numer ID ma tekst, do którego chcesz utworzyć odnośnik. Adres tego tekstu to: infopage.php?id=7 gdzie w miejsce 7 wstawiamy ID interesującego nas tekstu. Po otworzeniu takiego linku zostanie wyświetlona strona z artykułem o podanym ID.

komentarze
1. Opis
Newsy i artykuły można komentować. W zasadzie nie powinno być opcji modyfikacji i usuwania komentarzy jednak zawsze może znaleźć się jakiś idiota, który narobi nam kłopotu. Na podstronie komentarzy widzimy tytuł wypowiedzi, do czego to komentarz (artykuł, news) oraz imię autora wraz z jego e-mailem (jeżeli go podał - e-mail nie jest konieczny).

2. Usuń zaznaczone
Ze wzgędu na to, że ktoś złośliwy może dodać np. 50 komentarzy od tej wersji można zaznaczyć niechciane komentarze i jednym kliknięciem usunąć wszystkie.

księga gości
1. Opis
Aby się do niej dostać musisz użyć adresu: module.php?op=gbook. Tak jak wszystkie moduły obsługuje BBcode, zamienia adresy na linki, obsługuje uśmieszki, zabezpieczenia przed zbyt długą treścią, znacznikami HTML i PHP

2. Usuń zaznaczone
Ze wzgędu na to, że ktoś złośliwy może dodać np. 50 wpisów od tej wersji można zaznaczyć niechciane wpisy i jednym kliknięciem usunąć wszystkie.

sondy
1. Opis
System głosowania. Maksymalna liczba odpowiedzi to dziesięć, po dodaniu nowej sondy poprzednia przechodzi do archiwum, odwiedzający może przeglądać wyniki wszystkich sąd jednak głosować może tylko w aktualnej. Zabezpieczenie przed oddanie kilku głosów z jednego komputera lub usera (zależne od systemu operacyjnego i jego ustawień).

2. Zarządzanie
Ankiety można edytować, zakres funkcji został poszerzony, teraz możesz usuwać odpowiedzi, na które dodano głosy!

bannery
1. Opis
Bannery wyświetlane są po kolei. Zliczane są odsłony i kliknięcia w banner. Klient bądź ktoś kto ma banner w Twoim rotatorze może oglądać statystyki podając na podstronie banner.php hasło, którym jest tytuł bannera. Bannery podzielone są na trzy grupy: bannery A, bannery B i buttony. Te ostatnie różnią się od typu A i B tym, że są wyświetlane wszystkie naraz.

2. Dodawanie
Podaj tytuł bannera, będzie on także kluczem dostępu do statystyk bannera dla Twojego klienta. W pole alt wpisz tzw. tekst alternatywny, widoczny po przytrzymaniu kursora myszy na obrazku bądź w sytuacji gdy obrazek nie załaduje się. Następnie wpisz limit odsłon po którym emisja bannera zostanie zatrzymana (zero oznacza brak limitu). Teraz jeżeli banner jest obrazkiem (np. GIF) podaj jego adres oraz adres, na który ma przekierować system po kliknięciu. Jeżeli chcesz użyć kodu zewnętrznego (np. animacja flash) podaj w okienku kod zewnętrzny kod, który wstawia Flasha. Możesz tam wpisać coś w HTML'u lub JavaScript. Wybierz jeszcze, który sposób został użyty (kod czy obrazek) oraz grupę, w której ma zostać umieszczony banner (bannery czy buttony).

3. Instalacja
Jak zauważyłeś bannery podzielone są na grupy: bannery A, bannery B i buttony. Bannery A są standardowo zainstalowane u góry strony. Bannery B można wstawić np. do bloku (czyt. bloki menu) i wstawiać tam coraz popularniejsze bannery 120x60. Buttony wstawia się tak samo jak bannery B jedyną różnicą jest to, że buttony są wyświetlane wszystkie naraz zaś bannery (A i B) po jednym. Aby wstawić w dowolnym miejscu strony buttony wpisz:

<?
banner('button');
?>


a banner typu B:

<?
banner('bannerB');
?>


Oczywiście nie musisz używać bannera B, stworzyłem coś takiego bo niektórzy wstawiają bannery w różnych miejscach naraz (nagłówek, menu itd.).

bloki menu
1. Opis
Blok menu jest to po prostu okienko z linkami (standardowo z lewej i prawej strony), sondą czy innym bajerem. W systemie standardowo dołączonych jest kilka gotowych bloków z różnymi bajerami (czyt. gotowe bloki).

2. Dodawanie
W treści możesz (a nawet musisz :)) używać HTML'a i co najważniejsze PHP! Teraz nie ma już żanych ograniczeń, skrypt wpisujesz w znaczniku, który najbardziej lubisz, można łączyć HTML z PHP czego nie było wcześniej.

3. Zarządzanie
System pozwala na przenoszenie bloku z lewej strony na prawą (i odwrotnie) oraz na ustalenie kolejności bloków przez co staje się praktycznie bezobsługowy, to ogromna zaleta!

administratorzy
1. Opis
Do systemu można dodawać adminów, którym można nadawać odpowiednie prawa np. dostęp do newsów i forum - reszta zablokowana. Dodając admina, ustaw mu jakieś proste hasło, później może je sobie zmienić.

2. Zarządzanie
Niektórzy mogą powiedzieć, że system jest niedopracowany bo można odebrać prawa ostatniemu seperuserowi (do niedawna nawet go usunąć) w bazie, moim zdaniem jest to po prostu nieograniczanie w żaden sposób użytkownika skryptu natomiast prawa superusera należy dawać tylko najbardziej zaufanym!

forum
1. Opis
Każdy może dodać post na forum. Nie trzeba się rejestrować, dodatkowo skrypt zapisuje w ciachu nick, mail i podpis postującego. Zaznaczanie postów jako przeczytane i nie przeczytane jest dostępne tylko dla zarejestrowanych użytkowników. Na forum adresy automatycznie zamieniane są na linki, obsługa BBcode i uśmieszków. Przed nickiem nie zarejestrowanego usera dodawana jest tylda (~). Inne opcje: kategorie, oznacz wszystkie jako przeczytane, wyszukiwarka, avatarki, moderatorzy, i inne funkcje związane z użytkownikami.

subskrypcja
1. Opis
Użytkownicy dodają się za pomocą formularza (przykład w menu od razu po zainstalowaniu skryptu), muszą potwierdzić swoje zgłoszenie do dwóch tygodni. Nie ma formularza do usuwania, za to do każdego maila wysłanego z serwisu na koniec listu doklejana jest stopka z linkiem, który wypisuje z subskrypcji.

2. Zmiana ustawień
Treść stopki oraz nagłówka listu nie powinien być usuwany ponieważ zawiera ważne informacje dla subskrybenta. Jeżeli chciałbyś coś zmodyfikować zajrzyj do pliku config.php, nazwy zmiennych są na tyle wymowne, że nie będę nic więcej opisywał.

katalog stron
1. Opis
W katalogu stron można tworzyć katalogi z linkami oraz całe drzewa podkatalogów. Jeden link może być w maksymalnie 3 katalogach. Zliczane są kliknięcia w linki, jest wyszukiwarka - można wybrać kategorię, w których będą szukane wyrazy. Goć strony może zgłosić nieczynny link oraz dodać nowy link do katalogu (musi zostać zatwierdzony przez admina)

Wprowadziłem możliwość zmiany sposobu sortowania linków z poziomu panelu admina jak i przez gościa strony (w tym przypadku ustawienie zostaje zapisane w ciastku). Jest także podział linków na strony w przypadku ich dużej ilości.

pliki downloadu
1. Opis
Tu sprawa wygląda tak samo jak w linkach z tą różnicą, że podczas dodawania pliku należy podać jego wielkość. Druga różnica to brak możliwości zgłoszenia pliku przez gościa strony.

2. Uploader
Możesz uploadować pliki na serwer z poziomu WWW.

pozostałe
1. Zmiana hasła
Hasło może zmienić sobie każdy admin.

2. Klient SQL
Do okienka możesz wpisać pojedyncze zapytania jak i wkleić plik SQL z wieloma zapytaniami, wygenerowany np. przez phpMyAdmin.

2. Kopia zapasowa bazy
Co jakiś czas powinno się wykonywać kopie bazy danych. Wystarczy kliknąć w przycisk i zapisać pobrany plik na dysku. Aby przywrócić kopie bazy wklej zapisany tekst do klienta SQL.

gotowe bloki
1. Opis
W tej wersji jPORTAL są już dołączone przykładowe bloki (czyt. bloki menu). Możesz sam sobie coś dopisać, jeżeli będzie to coś przydatnego daj mi znać!

2. Przykłady
Jeżeli masz skrypt, który może być przydatny jak blok zapisz go do pliku, który należy umieścić w katalogu menu następnie zainkluduj plik w bloku. Oto kilka bloków dostępnych po zainstalowaniu systemu:

a) ostatnie posty na forum - last_post(ile, znakow, punktor) - listuje ostatnie posty na forum gdzie ile to ilość postów do wyświetlenia a znakow to długość po której przekroczeniu tytuł postu zostaje skracany np. mam problem ze skryptem jaco.NEWS zmieniany do mam problem ze skry..., punktor to kod HTML, który będzie wyświetlany jako punktor, np. jakiś obrazek lub po prostu > .
b) najpopularniejsze artykuły - top_art(znakow, ile, punktor) - listuje najpopularniejsze artykuły. Parametry jak wyżej.
c) najczęściej pobierane pliki - top_downloads(znakow, ile, punktor) - to samo co poprzednio...
d) najnowsze pliki - new_downloads(znakow, ile, punktor) - i znowu :)
e) formularz sondy - poll_form(punktor) - wstawia formularz głosowania do bloku, ta funkcja nie znajduje się w pliku module/bonus.inc.php.

skóry
1. Opis
Themes'y znajdują się w katalogu theme. Jak zrobic samemu skórkę? Zajrzyj na stronę jPORTAL gdzie znajdziesz tutorial jak stworzyć własny theme oraz opis standardu jP-Theme 1.1.

2. Dynamiczna zmiana skóry
Jeżeli w systemie znajduje się więcej niż jedna skórka możesz dać możliwość gościom Twojej strony na wybranie jednej z nich. Blok z polem wyboru skórki jest dostępny po zainstalowaniu systemu.

ustawienia
1. Opis
Moduł panelu admina pozwala na zmienianie parametrów systemu oraz ustawień serwisu, nowością jest możliwość przełączenia systemu do działania przy ustawieniu parsera na register_globals=Off

menadżer plików
1. Opis
Menadżer plików pozwala na przeglądanie serwera, zmianę nazw plików i katalogów, przenoszenie ich do innych katalogów, uploadu plików do dowolnego katalogu, stworzenie katalogu oraz edycję plików na serwerze z poziomu panelu admina. Menadżer rozróżnia podstawowe typy plików, które mogą znaleźć się na serwerze i przydziela im odpowiednie ikonki. UWAGA, nie można usunąć katalogu, w którym znajdują się jakieś pliki ale jest funkcja szybkiego usuwania! Pliki oznaczone gwiazdką są chronione przed zapisem.

użytkownicy
1. Opis
Użytkownik po wypełnieniu i wysłaniu formularza rejestracyjnego musi potwierdzić rejestrację wchodząc na adres, który zostanie przesłany mailem. Po potwierdzeniu rejestracji użytkownik może od razu się zalogować i korzystać ze swoich przywilejów.

2. Lista użytkowników
Po zalogowaniu każdy user może przeglądać listę, na której widzi jacy użytkownicy są aktualnie online na stronie oraz na GG i ICQ (jeżeli podali swoje numery).

3. PW (Prywatna Wiadomość)
Użytkownicy mogą między sobą wysyłać wiadomości tzw. PW. Wiadomościom można nadawać priorytet, można też po otrzymaniu użyć opcji odpowiedz oraz prześlij dalej. Wiadomości oznaczane są jako przeczytane po kliknięciu. Na forum oraz w komentarzach, nick zarejestrowanego usera jest linkiem kierującym na stronę modułu UserInfo dla danego użytkownika.

4. UserInfo
Moduł pozwala na poznanie danych użytkownika np. postuyjącego na forum.

logi
1. Opis
Każda operacja admina w panelu zapisywana jest do pliku logów. Jest to bardzo przydatna funkcja szczególnie wtedy gdy dochodzi do kłótni kto coś usunął itp. Logi można przeglądać w panelu admina jednak nie ma możliwości edycji ani usuwania. Obsługa logów jest automatyczna - w bazie zostaje siedem najnowszych logów.

Jeżeli znasz się na PHP możesz pomóc! W jaki sposób? Jest wiele możliwości. Możesz testować skrypt i przesyłać mi raporty o błędach, niedociągnięciach, możesz coś zasugerować (co zmienić, co dodać), pomóc przy samym kodzie lub napisać jakiś prosty blok menu (czyt. bloki menu). Jeżeli napisałeś jakiś dobry skrypt i chciałbyś aby znalazł się w tym portalu to pisz śmiało - jakoś się dogadamy :)
Tutoriale, opisy standardów: http://jportal.one.pl