Orimari AdminPages
Transkrypt
Orimari AdminPages
Orimari AdminPages - dokumentacja – Autor: Miłosz Chmura Email: [email protected] Data: 10.X.2008. Spis treści 1. Wstęp ............................................................................................................................................................................... 3 2. Organizacja katalogów strony........................................................................................................................................... 5 admin..................................................................................................................................................................................... 5 files ........................................................................................................................................................................................ 5 pl oraz en ............................................................................................................................................................................... 6 movies ................................................................................................................................................................................... 6 photos ................................................................................................................................................................................... 6 presentations ........................................................................................................................................................................ 6 uploads .................................................................................................................................................................................. 6 .htaccess, index.bck oraz index.php ...................................................................................................................................... 6 sitemap.xml i robots.txt ........................................................................................................................................................ 6 3. Organizacja bazy danych................................................................................................................................................... 7 usersadmin ............................................................................................................................................................................ 7 languages............................................................................................................................................................................... 7 menus .................................................................................................................................................................................... 7 pagesetings ............................................................................................................................................................................ 7 questions ............................................................................................................................................................................... 8 pages ..................................................................................................................................................................................... 8 mainpages ............................................................................................................................................................................. 8 menupages ............................................................................................................................................................................ 8 submenupages ...................................................................................................................................................................... 8 4. AdminPages ...................................................................................................................................................................... 9 Logowanie ............................................................................................................................................................................. 9 Administracja strony „Zadaj pytanie” .................................................................................................................................. 10 Zarządzanie prezentacjami na serwerze.............................................................................................................................. 12 Zarządzanie galeriami na serwerze...................................................................................................................................... 13 Zarządzanie filmami na serwerze ........................................................................................................................................ 14 Zarządzanie pozostałymi plikami na serwerze .................................................................................................................... 15 Archiwizacja bazy danych .................................................................................................................................................... 15 Zarządzanie ustawieniami strony ........................................................................................................................................ 15 Zarządzanie profilem użytkownika ...................................................................................................................................... 16 Zadawanie zapytań bazie danych ........................................................................................................................................ 16 Lista wszystkich plików na serwerze.................................................................................................................................... 16 Bezpośredni dostęp do wybranych plików .......................................................................................................................... 16 Zarządzanie głównymi meni ................................................................................................................................................ 17 Zarządzanie stronami i podstronami ................................................................................................................................... 17 1. Wstęp Poniższa dokumentacja opisuje sposób użytkowania stron administracyjnych (AdminPages) dla strony http://www.orimari.com/ oraz organizację samej strony. AdminPages oraz nazwy tabel i pól w bazie danych, które są używane przez stronę Orimari, są w języku angielskim. W następnym rozdziale opisana jest organizacja katalogów i ich znaczenie dla strony, po nim opisana jest organizaja bazy danych MySql, a na końcu wyjaśnione jest w jaki sposób można wykorzystywać moduły dostępne na AdminPages. Konwencje: • • • • • • • • • • / – znacza katalog główny na którym umieszczona jest strona w internecie (jest to skrót dla http://www.orimari.com/) wszystkie katalogi są podkreślone, np. katalog, a wszystkie pliki są pisane kursywą np. index.php strona – strona która jest administrowana, ta widziana przez zwykłego użytkownika gdy wchodzi na http://www.orimari.com. główny index.php – jest to główny, początkowy skrypt, który znajduje się bezpośrednio na / katalog języka – folder w którym znajdują się wszystkie strony główne dla pewnego języka; każdy katalog języka ma swój początkowy plik index.php strony główne – strony które są nadrzędne, mają swój własny plik, który się znajduje w katalogu języka i które mogą zawierać swoje podstrony, np. onko.php podstrony – strony, które są podrzędne pewnej stronie głównej i które nie mają swój własny plik, a identyfikują się poprzez parametr id, np. onko.php?id=2 DB – baza danych (eng. database); skrót używany do odwoływania się do tabeli; DB->users oznacza tabelę users w bazie danych użytkownik, zwykły użytkownik – osoba, która korzysta ze strony http://www.orimari.com użytkownik AdminPages – osoba, która ma dostęp do stron administracyjnych http://www.orimari.com/admin W skrócie działanie strony polega na: 1. Rozpoznanie języka w skrypcie /index.php (czyli adres strony – http://www.orimari.com/), pokazanie krótkiego intro w tym języku, i przekierowanie do odpowiedniego katalogu języka. Np. jeśli rozpoznany język przeglądarki to polski, strona zostanie przekierowana do pliku /pl/index.php. 2. Wyświetlenie zawartości strony na podstawie szablonu /files/template.php. Zawartość strony jest ściągnieta z bazy danych na podstawie nazwy katalogu języka w którym się użytkownik znajduje, nazwy pliku, oraz identyfikatora podstrony (id); z bazy danych oprócz zawartości strony, ściagają się główne meni, submeni, nazwa galerii, nazwa filmu (galeria i odtwarzacz filmu są dynamicznie generowane na stronie na podstawie plików znajdujących się na serwerze). Na przykład jeśli adres strony to /en/onko.php, z bazy danych zostaje ściągnieta strona onko.php w języku angielskim. Jeżeli natomiast adres strony to /en/onko.php?id=2, z bazy danych zostaje ściągnieta druga podstrona strony onko.php w języku angielskim. 3. Gdy zostanie kliknięty link zmiany języka, użytkownik zostaje przekierowany do katalogu zmienionego języka, ale z tą samą nazwą strony. Jeśli strona taka nie istnieje, użytkownik jest przekierowany do strony początkowej dla tego języka (index.php). Na przykład jeśli użytkownik znajduje się na stronie /en/onko.php i chce zmienić język na polski, po kliknięciu linku zmiany języka zostaje on przekierowany na /pl/onko.php. Jednakże, jeśli ta strona nie istnieje zostaje on przekierowany na /pl/index.php – stronę początkową katalogu języka polskiego. Wymagania/Zalecenia: Aby strona internetowa poprawnie funkcjonowała wymagane jest użycie serwera, który obsługuję dynamiczne wykonywanie skryptów PHP v.5 lub wyżej oraz wymagany jest dostęp do bazy danych MySQL v.5 lub wyżej. Do administrowania strony (AdminPages) jak również do przeglądania strony zalecana jest przeglądarka Firefox, z włączoną obsługą skryptów JavaScript oraz wtyczką Adobe Flash Player. 2. Organizacja katalogów strony Na / znajduję się lista katalogów i plików: • • • • • • • • • • • • • admin files pl en movies photos presentations uploads .htaccess index.bck index.php sitemap.xml robots.txt admin W tym katalogu znajdują się strony, które służą do administrowania strony, tzw. AdminPages. Aby się dostać do strony AdminPages trzeba przejść do /admin/index.php i wpisać użytkownika i hasło (które jest zapisane w DB->usersadmin). Wiecęj w rozdziale AdminPages. files W tym katalogu znajdują wszystkie pliki i katalogi ważne dla funkcjonowania strony. W poszczególnych katalogach znajdują są wtyczki: htmlMimeMail5 (wysyłanie emaili ze strony), lightbox (oglądanie zdjęć), flashPlayer (odtwarzacz filmów), captcha (autentyfikacja), jpgRotator (główny rotator zdjęć, znajdujący się na górze po prawej stronie). Warto dodać, że w katalogu jpgRotator można ustawić wyświetlane zdjęcia. Znajdują się one w podkatalogu jpg; plik konfiguracyjny to jpgrotator.xml. W katalogu files umieszczone są także wszystkie pliki, które definiują design strony. Są to między innymi obrazki dla pasku nawigacyjnego (katalog nav), oraz pozostałe zdjęcia (meni, główny obrazek, ikona). Najważniejszym plikiem dla designu strony jest orimari.css; w tym pliku znajdują wszystkie ustawienia kaskadowych arkuszy stylów. Pozostałe pliki w katalogu files to: • • • error404.php – strona błędu, która się pojawia, gdy użytkownik próbuje uzyskać dostęp do nieistniejącej strony na serwerze. db_data.php – skrypt, w którym zapisane są informacje dostępu do bazy danych: baza danych, użytkownik, hasło, nazwa tablicy; skrypt ten jest nie dostępny publicznie. template.php – jest to szablon, czyli struktura każdej strony, tzn. rotator zdjęć i meni główne na górze i na dole. W szablonie tym zdefiniowane jest także pozycja submeni, galerii, oraz filmu na stronie. • • header.php i footer.php to skrypty które definiują nagłówek i stopkę każdej strony głównej; są używane między innymi przez plik template.php. functions.php – skrypt, w którym zawarte są funkcje do generowanie meni, submeni, galerii zdjęć i odtwarzacza filmu flash; są używane między innymi przez plik template.php. pl oraz en W tych katalogach zawarte są strony główne/pliki dla poszczególnego języka. movies W tym katalogu znajdują się adobe flash filmiki (.flv). Każdy plik .flv może, ale nie musi, mieć zdjęcie, które się bedzię pokazywać zanim zostanie odtworzony filmik. Każdy plik .flv może też, ale nie musi, mieć plik .info, w którym jest zdefiniowana szerokość i wysokość odtwarzacza dla tego filmiku. Na przykład dla pliku filmik.flv mogą istnieć pliki filmik.jpg oraz filmik.info (nazwa pliku musi być taka sama; zmienia się tylko rozszerzenie). photos W tym katalogu znajdują się podkatalogi ze zdjęciami. Jeżeli w jakimś podkatalogu znajduje się plik gallery.info katalog ten jest galerią. W każdej galerii, oprócz pliku gallery.info, znajdują się .jpg zdjęcia wielkich rozmiarów (700x480) oraz podkatalog /mini/, w którym znajdują się miniaturki zdjęć. W pliku gallery.info znajduję się informacja o galerii: nazwa galerii oraz dotatkowe informacje. presentations W tym katalogu znajdują sie PowerPoint prezentacje. Każda prezentacja może, ale nie musi, mieć zdjęcie, które sie bedzię pokazywać jako link przy ściąganiu pliku. Na przykład dla prezentacji prezentacja.ppt może istnieć plik prezentacja.jpg (nazwa pliku musi być taka sama; zmienia się tylko rozszerzenie). uploads W tym katalogu znajdują się pliki jakiegokolwieg rozszerzenia, załadowane na serwer poprzez AdminPages. .htaccess, index.bck oraz index.php Plik .htaccess definiuje reguły dla serwera: wyświetlanie strony błędu 404 (/files/error404.php) oraz limity uploadowanych plików (ustawione na 20MB). Gdy są wykonywane jakieś poważniejsze zmiany na serwerze plik index.bck można wykorzystać jako tymczasową informację o niedostępności strony; wystarczy zmienić nazwę pliku index.bck na index.php. Plik index.php zostaje wywołany kiedykolwieg użytkownik wchodzi na stronę http://www.orimari.com/. Skrypt ten rozpoznaje preferowany język przeglądarki, wyświetla logo strony i intro w najbardziej odpowiednim języku, a następnie przekierowuje użytkownika do strony początkowej (index.php) katalogu odpowiedniego języka. sitemap.xml i robots.txt Te dwa pliki są wykorzystywane w wyszukiwarkach w celu organizacji i pozycjonowaniu strony. 3. Organizacja bazy danych Strona http://www.orimari.com/ opiera się na bazie danych MySql. Każda strona główna jest dynamicznie generowana poprzez serwer, korzystając z danych ściągnietych z bazy danych (takich jak zawartość strony, nazwa galerii dla tej strony) oraz plików znajdujących się na serwerze (takich jak zdjęć z katalogu /photos/galeria/). W bazie danych MySql znajdują się następujące tablice: • • • • • • • • • usersadmin languages menus pagesettings questions pages mainpages menupages submenupages usersadmin Jest to najważniejsza tabela dla AdmiPages – zawiera ona listę użytkowników AdminPages, którzy mają dostęp do AdminPages i jest ona używana podczas loginu do stron administracyjnych. Znajdują się w niej pola: username, password, name i surname. Pole username jest nazwą użytkownika, który ma prawo dostępu do AdminPages, a w polu password zachowane jest jego hasło w postaci shaszowanej przez funkcję md5(). languages Ta tabela przedstawia listę dostępnych języków strony; pola languageID i language (dwuliterowy skrót nazwy języka). menus W tej tabeli znajduje się lista głównych meni; zawiera pola: menuID, name (górne lub dolne meni eng. mainMenu i bottomMenu), languageID (identyfikator języka z DB->languages górnego lub dolnego meni). pagesetings W tej tabeli znajdują się niektóre ustawienia dla strony; zawiera pola: settingID, property (nazwa wartości), value (wartość), languageID. W tabeli pagesettings znajdują się wartości Description i Keywords dla każdego języka – wartości te używane są w wyszukiwarkach w celu pozycjonowania strony. questions Ta tabela służy do obsługi strony „Zadaj pytanie”, na której zwykły użytkownik może zadać pytanie z internetu i wysłać je do bazy danych oraz na email [email protected]; z tej tabeli ściągane są również pytania i odpowiedzi które wyświetlają sie na niej jako najczęściej zadawane pytania. Tabela zawiera pola: questionID, name (imię nadawcy), surname (nazwisko nadawcy), mail (email nadawcy), question (pytanie postawione przez nadawcę), answer (odpowiedź udzielona przez authorA), datetimeQ (data zadania pytania), datetimeA (data odpowiedzi na pytanie), showOnPage (czy pytanie ma się pojawić na stronie?), authorA (autor odpowiedzi na pytanie – tylko osoba która ma dostęp do AdminPages). pages Ta tabela zawiera wszystkie strony i podstrony, które używają szablon /files/template.php; zawiera pola: pageID, pageIDHolder (jeśli strona jest podstroną, jest to identyfikator strony rodzica/strony głównej), textContent (zawartość strony), movieName (nazwa pliku filmu znajdującego się w katalogu /movies/), galleryDir (nazwa katalogu/galerii, która znajduję się w katalogu /photos/), description (opis strony – używany jedynie w AdminPages). mainpages Ta tabela zawiera dodatkowe informacje dla stron głównych, które są jednakowe dla wszystkich jej podstron; zawiera pola: pageID (identyfikator strony ten sam jak i w DB->pages), title (tytuł strony), titleSubMenuPosition (wyśrodkowanie tytułu i podmeni: na lewo, po środku), filename (nazwa pliku głównej strony), languageID. menupages Ta tabela definiuje elementy głównych meni z DB->menus. Elementami mogą być strony główne z DB->main lub zewnętrzny adres; zawiera pola: menuID (identyfikator głównego meni), pageID (identyfikator głównej strony), externalLink (zewnętrzny adres zamiast pageID), itemName (nazwa elementu dla menuID), orderNumber (uporządkowanie elementów dla menuID). submenupages Ta tabela definiuje elementy podmeni dla głównych stron z DB->mainpages. Elementami mogą być jedynie podstrony strony głównej lub zewnętrzny adres; zawiera pola: pageIDHolder (identyfikator strony głównej), pageIDLink (identyfikator podstrony), externalLink (zewnętrzny adres zamiast pageIDLink), itemName (nazwa elementu podmeni dla pageIDHolder), orderNumber (uporządkowanie elementów podmeni dla pageIDHolder ). 4. AdminPages Ten rozdział opisuje obsługę i możliwości AdminPages. Najpierw opisany jest sposób logowania do stron administracyjnych, a następnie krok po kroku opisany jest każdy moduł. Pod każdym podrozdziałem znajduję się link do opisywanego modułu oraz używane tablice bazy danych lub miejsce składowania plików na serwerze. Wiadomośći W AdminPages ważnym elementem interakcji z użytkownikiem są wiadomości. W większości wypadków informują one użytkownika o tym czy operacja została poprawnie wykonana. Istnieją trzy typy wiadomości: czerwona – oznacza wystąpienie błędu, zielona – oznacza poprawne wykonanie operacji oraz niebieska – daje dodatkową informację użytkownikowi. Logowanie (http://www.orimari.com/admin/index.php DB->usersadmin) Aby można było się zalogować do AdminPages potrzebna jest nazwa użytkownika i hasło1. Logowanie możliwe jest poprzez otwarcie strony http://www.orimari.com/admin/2. Bezpieczne logowanie odbywa się poprzez skrypt JavaScript, dlatego też zalecane jest jego włączenie – jeśli skrypt nie jest włączony zostanie wyświetlona odpowiednia informacja kolorem czerwonym. Strona logowania jest pokazana na Zdjęciu 4.1. Zdjęcie 4.1 Jeżeli logowanie przebiegło prawidłowo zostanie otworzona strona główna z opcjami, pokazana na Zdjęciu 4.2, lub strona z której nastąpiło przekierowanie do logowania. 1 aby stworzyć nowego użytkownika AdminPages trzeba dodać nowy element w DB->usersAdmin gdy użytkownik AdminPages nie jest zalogowany, otwarcie innej istniejącej strony w katalogu /admin/ spowoduje przekierowanie na strone logowania, a po poprawnym loginie z powrotem na tą stronę. 2 Zdjęcie 4.2 Warto zauważyć, że na każdej stronie w górnym prawym rogu znajduję się opcja wylogowania się z AdminPages, link do nadrzędnej strony i/lub link do otwartej strony, oraz nazwa zalogowanego użytkownika (na zdjęciu jest nim admin). Na samej górze znajduję się nazwa strony (na zdjęciu jest to Welcome admin!). Na każdej stronie znajduje się też krótki opis strony, do czego służy i jak można z niej skorzystać. Opcje które są dostępne na AdminPages opisane są poniżej. Opcja Logout służy po prostu do wylogowania się ze strony. Po poprawnym wylogowaniu powinna się pojawić informacja widoczna na Zdjęciu 4.3. Zdjęcie 4.3 Administracja strony „Zadaj pytanie” (http://www.orimari.com/admin/question.php DB->questions) Na tej stronie można zarządzać pytaniami zadanymi na stronie „Zadaj pytanie”. Na Zdjęciu 4.4 pokazana jest strona administracyjna. Pytania są wyświetlane w tabelce w kolejności wybranej przez użytkownika AdminPages i w kolejności, w której były zadawane. Można filtrować pytania poprzez wybranie opcji Display filter: (i) pokaż wszyskie, (ii) pokaż te, które nie są odpowiedziane, (iii) pokaż te, które nie są pokazane na stronie, (iv) pokaż te, które są pokazane na stronie. Jeżeli istnieje więcej niż jedno pytanie, pod tabelką wyświetlona zostanie opcja zmiany kolejności pytania wyświetlanych jako najczęściej zadawane pytania na stronie „Zadaj pytanie”. Każdy rząd tabelki oprócz informacji o pytaniu/odpowiedzi, po prawej stronie zawiera opcje edycji Edit oraz usunięcia Delete pytania. Zdjęcie 4.4 Po wybraniu opcji Edit pojawia się szczegółowa informacja o pytaniu: (i) imie i nazwisko osoby która zadała pytanie i kiedy, (ii) zadane pytanie, (iii) odpowiedź na pytanie, (iv) czy pokazać pytanie na stronie jako często zadawane pytania (Show on page?), (v) informacja o osobie która odpowiedziała na pytanie i kiedy (tylko użytkownicy AdminPages mogą odpowiadać na pytania). Użytkownik AdminPages może zmienić zarówno pytanie jak i odpowiedź, oraz decydować o tym czy pytanie i odpowiedź mają się pojawić na stronie „Zadaj pytanie”. Edycja pytania pokazana jest na Zdjęciu 4.5. Zdjęcie 4.5 Zarządzanie prezentacjami na serwerze (http://www.orimari.com/admin/presentation.php /presentations/) Na tej stronie można załadować nową prezentację na serwer lub zarządzać istniejącymi prezentacjami. Strona jest pokazana na Zdjęciu 4.6. Zdjęcie 4.6 Dodawanie prezentacji Aby dodać prezentację należy wybrać plik w odpowiednim formacie (PowerPoint). Można też wybrać zdjęcie, które zostanie pokazane na stronie zamiast linku/tekstu do ściągnięcia prezentacji. Na przykład zamiast tekstu Ściągnij prezentację, wyświetlony zostanie obrazek . Jeśli pole Name pozostanie puste, plik na serwerze będzie nazwany tak samo jak oryginalny plik. Przegląd prezentacji Na stronie jest tabelka, w której oprócz opcji dodawania nowej prezentacji, znajduje się lista istniejących prezentacji na serwerze. W drugiej kolumnie wyświetlone jest zdjęcie, jeśli zostało ściągniete dla tej prezentacji oraz wielkość prezentacji. Dostępne opcje dla poszczególnej prezentacji to: (i) ściągnij download, (ii) usuń delete, (iii) zarządzaj manage. Zarządzanie prezentacją Na stronie zarządzania poszczególną prezentacją można zmienić jej nazwę pliku oraz dodać/usunąć/zmienić jej zdjęcie. Przy zmianie nazwy pliku prezentacji trzeba pamiętać o zmianie zawartości wszystkich stron, które używają tej nazwy pliku. Na stronie tej jest też wyświetlony relatywny adres dla tej prezentacji. Zarządzanie galeriami na serwerze (http://www.orimari.com/admin/gallery.php /photos/) Na tej stronie można załadować nową galerię zdjęć na serwer lub zarządzać istniejącymi galeriami. Strona jest pokazana na Zdjęciu 4.7. Zdjęcie 4.7 Dodawanie galerii Aby dodać galerię należy wybrać zdjęcie (.jpg, .gif, .png) lub szereg zdjęć spakowanych jako plik .zip. Można też wypełnić dodatkowe informacje o galerii. Na przykład pole PL-Name oznacza nazwę galerii wyświetlaną na pokazie zdjęć na polskiej stronie, a pole PL-Info oznacza dodatkową informację o galerii, takie jak fot. Jan Kowalski i jest wyświetlane na polskiej stronie jako stopka galerii. Jeśli pole Gallery Directory pozostanie puste, katalog galerii na serwerze przyjmnie nazwę oryginalnego załadowanego pliku (zdjęcia lub .zip). Przegląd galerii Na stronie jest tabelka, w której oprócz opcji dodawania nowej galerii, znajduje się lista istniejących galerii na serwerze. W pierwszej kolumnie można przejść do strony zarządzania galerią manage, w drugiej kolumnie wyświetlona jest wielkość galerii oraz dodatkowe informacje, a w trzeciej pokazane są miniaturowe zdjęcia tej galerii. Zarządzanie galerią Na stronie zarządzania poszczególną galerią można zmienić jej nazwę katalogu oraz edytować jej dodatkowe informacje. Na tej stronie znajduję się też tabelka, która wyświetla zdjęcia w kolejności w jakiej się będą pokazywać na pokazie zdjęć. W tabelce tej można dodać na koniec galerii nowe zdjęcie lub szereg zdjęć na tych samych zasadach jak przy tworzeniu nowej galerii. W tabelce znajduję się też lista zdjęć istniejących w galerii razem z ich nazwą i wielkością. Zdjęcia można oglądnąć w pełnych rozmiarach (po przyciśnięciu na zdjęcie) lub usunąć z galerii Delete. Jeżeli istnieje więcej niż jedno zdjęcie w galerii, pod tabelką wyświetlona zostanie opcja zmiany kolejności zdjęć. Zarządzanie filmami na serwerze (http://www.orimari.com/admin/movie.php /movies/) Na tej stronie można załadować nowy film na serwer lub zarządzać istniejącymi filmami. Strona jest bardzo podobna do tej służącej zarządzaniu prezentacjami, pokazanej na Zdjęciu 4.6. Dodawanie filmu Aby dodać film należy wybrać plik w odpowiednim formacie (Adobe Flash .flv). Można też wybrać zdjęcie, które zostanie pokazane na stronie zanim zostanie odtwarzany film. Dodatkowo można ustawić szerokośc i wysokość odtwarzacza na stronie. Jeśli pole Name pozostanie puste, plik na serwerze będzie nazwany tak samo jak oryginalny plik. Przegląd filmów Na stronie jest tabelka, w której oprócz opcji dodawania nowego filmu, znajduje się lista istniejących filmów na serwerze. W drugiej kolumnie wyświetlone jest zdjęcie, jeśli zostało ściągniete dla tego filmu, wielkość filmu oraz informacje o rozmiarach odtwarzacza. W trzeciej kolumnie znajduje się odtwarzacz, w którym można podglądnąć film. Dostępne opcje dla poszczególnego filmu to: (i) ściągnij download, (ii) usuń delete, (iii) zarządzaj manage. Zarządzanie filmem Na stronie zarządzania poszczególnym filmem można zmienić jego nazwę pliku oraz dodać/usunąć/zmienić jego zdjęcie. Zarządzanie pozostałymi plikami na serwerze (http://www.orimari.com/admin/upload.php /uploads/) Na tej stronie można załadować nowy plik dowolnego formatu i zarządzać istniejącymi plikami na stronie. Strona jest podobna do tej służącej zarządzaniu prezentacjami, pokazanej na Zdjęciu 4.6. Dodawanie pliku Aby dodać plik należy go wybrać z komputera. Jeśli pole Name pozostanie puste, plik na serwerze będzie nazwany tak samo jak oryginalny plik. Przegląd plików Na stronie jest tabelka, w której oprócz opcji dodawania nowego pliku, znajduje się lista istniejących plików na serwerze. W drugiej kolumnie wyświetlona jest wielkość pliku oraz jego ikona, jeśli plik ma rozpoznawalny format. Dostępne opcje dla poszczególnego pliku to: (i) ściągnij download, (ii) usuń delete, (iii) zarządzaj manage. Zarządzanie plikiem Na stronie zarządzania poszczególnym plikiem można zmienić jego nazwę. Na stronie tej jest też wyświetlony relatywny adres dla tego pliku. Archiwizacja bazy danych (http://www.orimari.com/admin/archive.php /admin/bck/) Na tej stronie znajduje się lista plików .sql, które są archiwami całej bazy danych MySql używanej na stronie; w nazwie pliku znajduje się data archiwizacji bazy danych. Pliki te można ściągnąć download (klikając na ich nazwę) lub usunąć delete?. Aby zarchiwizować bazę danych należy kliknąćna You can make a new archive by clicking here. Jeżeli archiwizacja przebiegła pomyślnie, plik zostanie dodany do listy plików .sql na tej stronie. Archiwizacja bazy danych wykonana więcej niż raz dziennie nadpisuje plik .sql z tego dnia. Zarchiwizowany plik można wykorzystać na stronie /admin/query.php w celu odzyskania bazy danych. Zarządzanie ustawieniami strony (http://www.orimari.com/admin/settings.php DB->settings) Na tej stronie można ustawiać niektóre opcje strony. Dostępne opcje/wartości to Description (zwięzły opis strony) i Keywords (słowa kluczowe strony oddwajane przecinkiem) dla poszczególnych języków; służą one wyszukiwarkom w celu pozycjonowania stron. Aby zmienić poszczególną opcje/wartość trzeba kliknąć na Edit. Opcja Delete jest niedostępna. Zarządzanie profilem użytkownika (http://www.orimari.com/admin/profile.php DB->usersadmin) Na tej stronie można zmienić profil użytkownika AdminPages, tj. imię i nazwisko oraz hasło. Ważne jest aby użytkownik nie miał zbyt krótkiego/prostego hasła, gdyż wejście niepowołanych osób do AdminPages umożliwia im degradację całej strony! Zadawanie zapytań bazie danych (http://www.orimari.com/admin/query.php) Ta strona umożliwia bezpośredni dostęp bazy danych poprze zapytania. Zapytania można wprowadzić bezpośredniu lub z pliku (.sql). Przy wykonywaniu więcej niż jednego zapytania, muszą być one oddzielone średnikiem (;) i nową linią. Po wykonaniu zapytania powrotna informacja zostanie wyświetlona. Na przykład dla zapytania SELECT zostanie pokazana tablica z wynikami. Na tej stronie można też odzyskać zawartość bazy danych poprzez wybranie odpowiedniego archiwalnego pliku utworzonego na stronie /admin/archive.php. Uwaga: Należy być bardzo ostrożnym przy wykonywaniu jakichkolwiek zapytań, gdyż jednym zapytaniem można zdegradować całą bazę danych! Lista wszystkich plików na serwerze (http://www.orimari.com/admin/list.php) Na tej stronie znajduje się lista wszystkich katalogów i plików na serwerze poczewszy od /. Lista nie zawiera plików znajdujących się w katalogu /admin/ oraz w katalogu /files/. Dla każdego pliku jest wyświetlony jego relatywny adres oraz opcja jego usunięcia delete?. Uwaga: Usuwanie plików na tej stronie nie jest zalecane! Jeżeli istnieje możliwość usunięcia plików poprzez inny moduł należy to zrobić w tym module! Bezpośredni dostęp do wybranych plików (http://www.orimari.com/admin/files.php) Na tej stronie znajduje się lista plików, które można przeglądać i edytować. Pliki do których jest umożliwiony dostęp to wszystkie pliki główne ze strony polskiej i angielskiej oraz pliki: orimari.css, header.php, footer.php i główny index.php. Po kliknięciu na nazwę pliku otwiera się strona z edytorem na której można zobaczyć/edytować zawartość pliku. Uwaga: Pliki te są ważne dla funkcjonowania strony, dlatego też należy być bardzo ostrożnym przy ich edycji! Zarządzanie głównymi meni (http://www.orimari.com/admin/menu.php DB->menus, DB->mainpages) Na tej stronie można zarządzać głównymi meni na stronie angielskiej i na stronie polskiej. Górne meni to mainMenu, a dolne to bottomMenu. Wybór elementów meni nie oznacza dodawanie nowej strony, lecz tylko dodawanie nowego elementu/linku do istniejącej strony. Nowe strony (oraz podstrony) dodaje sie na stronie /admin/page.php. Dla każdego meni pokazana jest lista elementów (nazw), które będą się wyświetlać na stronie w tej samej kojności. Można przemieszczać elementy meni, w celu zmiany kolejności ich wyświetlania (up i down). Możliwe jest też usunięcie elementu meni przez przyciśnięcie przycisku remove. Przy dodawaniu add nowego elementu, trzeba podać jego nazwę oraz wybrać stronę Choose page... na którą ma przechodzić po jego kliknięciu. Zamiast strony można wybrać zewnętrzny adres poprzez kliknięcie na Use external link... i wpisanie dowolnego http:// adresu. Po wykonaniu wszystkich zmian trzeba zachować meni Update; jeśli zmiany były wykonywane na więcej niż jednym meni, trzeba przycisnąć przycisk znajdujący się na końcu strony Update All, który zachowuje wszystkie meni naraz. Zarządzanie stronami i podstronami (http://www.orimari.com/admin/page.php DB->pages) Na tej stronie można zarządzać wszystkimi stronami i podstronami strony http://www.orimari.com/, oprócz głównego index.php oraz strony „Zadaj pytanie”. Strona http://www.orimari.com/ jest podzielona na katalogi języków: pl i en, a w każdym z tych katalogów znajdują się strony główne, które mają swoją nazwę i tytuł. Te główne strony można dodawać i edytować (poprzez kliknięcie na jej nazwę) na stronie początkowej admin/page.php pokazanej na Zdjęciu 4.8. Każda strona główna może zawierać swoje podstrony, do których można przejść poprzez kliknięcie na odpowiednie elementy podmeni tej strony głównej. Zauważ, że przy kliknięciu na element głównego meni zawsze ładuje się zawartość strony głównej (bez znaczenia czy zawiera podstrony, czy też nie). Zawartość podstron strony głównej ładuję się dopiero po kliknięciu odpowiedniego elementu podmeni. Nowa strona główna Gdy dodawana jest nowa strona główna, potrzebne jest zdefiniowanie nazwy pliku Page filename i języka strony Language, który zostaje potem utworzony w odpowiednim katalogu języka. Pozostałe parametry, które można zdefiniować przy dodawaniu strony to jej tytuł Title oraz wyrównanie tytułu Title and submenu position: po lewej stronie lub na środku. Tytuł najlepiej jest wyrównać po lewej stronie, a wyrównanie po środku należy używać gdy tytuł zajmuje więcej niż jedną linię lub zawiera dużo znaków. To są jedyne parametry, które można ustawić na głównej stronie, a które są identyczne dla każdej jej podstrony (sekcja Page settings). Kolejnym ważnym parametrem nowej strony jest jej zawartość Text Content. To pole jest przygotowane kolorystycznie do wpisywania kodu html, które się pojawia bezpośrednio pod tytułem (lub pod podmeni, jeśli istnieje). Na nowej stronie można też wybrać film Movie i/lub galerię zdjęć Gallery, które można załadować na serwer na odpowiednich stronach. Pole Description krótko opisuje stronę (sekcja General settings). Zdjęcie 4.8 Po utworzeniu nowej strony możemy ją wybrać przy dodawaniu nowych elementów dla głównych meni na stronie /admin/menu.php. Podstrony Po utworzeniu strony głównej można do niej dodawać podstrony. Podstronę dodaję się na stronie edycji strony głównej w sekcji Subpages. Po kliknięciu na You may add another subpage here. trzeba wypełnić parametry nowej podstrony podobnie jak przy dodawaniu nowej strony głównej. Jedyne parametry, które można wypełnić to General settings. Przy wypełnianiu parametrów podstrony warto jest dodać jej krótki opis Description, gdyż będzie się on pojawiał zamiast identyfikatora strony na liście podstron w sekcji Subpages. Po dodaniu nowej podstrony pojawia się ona w sekcji Subpages. To nie oznacza, że jest ona dodana w podmeni – dodawanie elementów podmeni znajduję się w sekcji Submenu. W sekcji Submenu można dodawać elementy podmeni w podobny sposób jak dodawanie elementów w głównych meni. Jedyną różnicą jest to, że w podmeni można dodawać jedynie podstrony należące do specificznej strony głównej oraz to, że można dodatkowo wybrać opcję This page, co oznacza, że element meni jest odnośnikiem na stronę główną/rodzica. Sekcje Subpages i Submenu są pokazane na Zdjęciu 4.9. Zdjęcie 4.9 Edycja i usuwanie Każdą podstronę można usunąć i dowolnie edytować. Przy usuwaniu strony głównej plik oraz wszystkie jej podstrony są też usuwane. Stronie głównej można zmieniać wszystkie parametry oprócz języka. Dodawanie prezentacji Powyżej zostało wyjaśnione w jaki sposób można wybrać na stronie film lub galerię, natomiast nie zostało opisane w jaki sposób można dodać link do ściągnięcia prezentacji. Ponieważ prezentacja jest przeznaczona do ściągnięcia, a nie do oglądania na stronie, sposób jej dodawania na stronę jest odmienny. Prezentację można dodać w polu Text Content (zawartość strony). Po wybraniu odpowiedniego miejsca w kodzie html, należy w wyborniku choose presentation... wybrać odpowiednią prezentację. Gotowy kod html zostanie wklejony w wybranym miejscu w polu Text Content.