mskrypty

mskrypty.ovh.org -> Download -> mGaleria -> Instalacja i konfiguracja

mGaleria 1.5 - Instalacja i konfiguracja

Wymagania:

PHP 4.3 lub nowsze
Zainstalowane GD.

Nowości w stosunku do wersji poprzedniej:

  • galerie wyszukiwane są w określonym porządku
  • bardziej przyjazny kod - łatwiejszy w instalacji na stronie

Instalacja:

  • rozpakuj archiwum
  • nadaj prawa do zapisu katalogowi 'thumbs' i katalogom, które zawiera
  • uruchom przeglądarkę i odwołaj się do pliku index.php

Dodawanie galerii:

Aby dodać nową galerię należy w katalogu 'galleries' stworzyć nowy katalog (o dowolnej nazwie, np. 'imieniny' - katalog nowej galerii). Następnie w tym katalogu należy umieścić zdjęcia, które chcemy pokazać (tylko pliki typu: jpg, gif, png). Utworzony katalog ze zdjęciami należy wpisać do pliku galleries.txt. Jego format jest następujący:

nazwa katalogu|||Tytuł galerii
nazwa innego katalogu|||Tytuł innej galerii

gdzie:

  • pierwsza kolumna (nazwa katalogu) - nazwa utworzonego przez nas katalogu (imieniny)
  • druga kolumna (Tytuł galerii) - tytuł dodawanej galerii - będzie wyświetlał się na zdjęciami (np. Imieniny 2007)
Jeżeli nie dokonamy wpisu w pliku galleries.txt, dodana galeria nie zostanie wykryta! Wpis w tym pliku jest zatem konieczny.
Konstrukcja taka daje nam możliwość ukrycia galerii (możemy nie pokazywać jej na stronie, ale nie musimy usuwać jej z serwera).
Ponadto, galerie mogą być zapisane w pliku i wyświetlane w wybranej przez nas kolejności.
UWAGA! Proszę nie zostawiać pustych linii w tym pliku!

Katalog o takiej samej nazwie należy utworzyć również w katalogu 'thumbs'.
Powinniśmy mieć zatem dwa katalogi o nazwie 'imieniny' w naszej strukturze: 'galleries/imieniny' oraz 'thumbs/imieniny'. Katalogowi utworzonemu w 'thumbs' należy nadać prawa do zapisu.
Po uruchomieniu mGalerii nowa galeria zostanie wykryta i zobaczymy do niej odnośnik w widoku głównym (widokiem, albo katalogiem głównym będę określał listę galerii, która wyświetla się po normalnym uruchomieniu galerii - odwołaniu się do pliku index.php). Kiedy go klikniemy, zostaną utworzone i wyświetlone miniatury wstawionych zdjęć.

Usuwanie galerii:

Aby usunąć przedtem utworzoną galerię: imieniny, należy usunąć katalogi o nazwie imieniny z katalogu: 'galleries' oraz z katalogu miniatur: 'thumbs'. Koniecznie należy również usunąć odpowiednią linię z pliku galleries.txt. W przeciwnym razie będą pojawiać się błędy, ponieważ mGaleria będzie odwoływać się do katalogu, który nie istnieje.

Aby usunąć pojedynczy obraz z galerii wystarczy usunąć plik ze zdjęciem z katalogu danej galerii (tzn. z 'galleries/imieniny'), miniatura z katalogu 'thumbs/imieniny' zostanie usunięta automatycznie po otwarciu danej galerii w przeglądarce.

Konfiguracja:

W pliku config.php znajdują się zmienne konfiguracyjne, których wartości można zmieniać.

Zmienna $galleryTitle przechowuje tytuł galerii, wyświetlany przy każdym otwarciu galerii w widoku głównym.
Zmienne: $thumbWidth oraz $thumbHeight oznaczają odpowiednio: szerokość i wysokość miniatury, jaka ma być utworzona dla każdego zdjęcia. Miniatura jest tworzona dla danego zdjęcia tylko wtedy, kiedy nie istnieje. Zatem jeśli zmienimy w pliku config.php wartości dla zmiennych $thumbWidth oraz $thumbHeight, rozmiary istniejących miniatur nie zostaną zmodyfikowane. Jeżeli dodamy zaś nowe zdjęcia, miniatury dla nich zostaną utworzone według nowych ustawień. Aby zatem zmienić rozmiary miniatur już istniejących, należy je usunąć, następnie zmienić ustawienia w config.php i otworzyć odpowiednią galerię w przeglądarce. Zostaną wtedy wygenerowane nowe miniatury o nowych rozmiarach.

Poniższe cztery zmienne określają wartości atrybutów kaskadowego arkusza stylów dla miniatur:

  • zmienna $thumbMargin określa atrybut 'margin'
  • zmienna $thumbBorder określa rozmiar obramowania
  • zmienna $thumbBorderColor określa kolor obramowania
  • zmienna $thumbBorderStyle określa styl obramowania
Oprócz atrybutów arkusza stylów dla miniatur można ustawić inne parametry:
  • zmienna $numInHorizontal określa ilość miniatur wyświetlanych w poziomie
  • $numInVertical określa ilość miniatur wyświetlanych w pionie
  • $dirWithGalleries zawiera ścieżkę do katalogu z galeriami. Domyślnie: './galleries/'
  • $dirWithThumbs zawiera nazwę katalogu, którego zawartość stanowią katalogi z miniaturami poszczególnych galerii. Domyślnie: './thumbs'. Zalecam dokonanie tutaj zmiany. Z uwagi na to, że katalog ten powinien mieć prawa do zapisu warto umieścić go ponad katalogiem 'public_html'. W przeciwnym razie będzie możliwe zapisywanie do tego katalogu z zewnątrz! Stanowi to zagrożenie dla serwera!
    Istnieje jednak inna możliwość zabezpieczenia się przed niepowołanym dostępem - przy pomocy pliku .htaccess.
Otaczanie mGalerii1.5 własną grafiką jest bardzo proste. W pliku w layout-em wystarczy "zainclude'ować" pliki: config.php oraz classes.php, oraz utworzyć obiekt klasy: ViewGallery. Prościej: w pliku: index.php można wymienić wszystko, za wyjątkiem sekcji zawartych między: <?php oraz ?>.

Aktualizacja mGalerii do mGalerii1.5.

W katalogu, określonym zmienną konfiguracyjną $dirWithGalleries (domyślnie: 'galleries') należy dodać plik: galleries.txt i zaindeksować w nim wszystkie galerie (format pliku galleries.txt pokazany powyżej, w punkcie: "Dodawanie galerii"). Należy również wymienić wszystkie pliki z rozszerzeniem php. Oprócz tego usunąć trzeba pliki tekstowe z katalogów z galeriami. W poprzedniej wersji mGalerii w każdym katalogu z galerią znajdował się plik tekstowy, w którym zapisana była nazwa galerii. Obecnie te informacje są przechowywane w pliku galleries.txt, o którym napisane jest wyżej.
Nieusunięcie plików o których mowa powoduje błędy!

Licencja:

Skryptu mGaleria1.5 można używać bezpłatnie, pod warunkiem, że zapis: "mGaleria by mim" wraz z odnośnikiem do strony http://mskrypty.ovh.org/mgaleria.php pozostanie widoczny na każdej podstronie generowanej przez skrypt.