MSGallery jest prostym systemem umożliwiającym tworzenie galerii i umieszczanie ich w internecie.
Przykładową galerię można obejrzeć na mojej stronie, klikając na link umieszczony w menu.
W skład systemu MSGallery wchodzi:
- program umożliwiający tworzenie galerii
- szablon umożliwiający wyświetlanie przygotowanej galerii
Program MSGallery został napisany w języku C# oraz skompilowany za pomocą darmowego Visual Studio Express.
Do poprawnego działania wymaga zainstalowanego .net Framework 2.0.
Cechy progrmu MSGallery:
- możliwość tworzenia i pracowania nad wieloma galeriami - każda w innym folderze
- automatyczna zmiana rozmiaru zdjęć do ustalonej najbardziej nam pasującej wielkości wg boku dłuższego bądź krótszego
- automatyczne znakowanie zdjęć własną pieczęcią o określonych przez użytkownika parametrach i wybranym przez niego miejscu
- segregowanie zdjęć wg albumów -> galerii -> zdjęć w określonej kolejności
Hierarchia zawartości:
- MSGaleria - dane przechowywane we wskazanym przez użytkownika folderze, zawierającym plik msgallery.xml (plik przechowujący ustwienia oraz układ albumów i galerii względem siebie)
- Album - wirtualny element nie posiadający odwzorowania w strukturze katalogów - dane o nim są zapisane w msgallery.xml
- Galeria - dane przechowywane są w subkatalogu MSGalerii, gdzie nazwa katalogu to złożenie litery "G" oraz czterocyfrowej liczby oznaczającej numer galerii np. "G0001". Wewnątrz katalogu znajduje się plik z opisami zdjęć oraz same zdjęcia wraz z miniaturkami
- Zdjecie - plik zdjęcia w formacjie jpg (jedyny obłsugiwany przez program format) o nazwie takiej samej jak zdjęcie oryginalne, bądź o nazwie takiej samej jak oryginalne poszerzonej o datę dodania - w przypadku istnienia pliku o takiej nazwie.
- Galeria - dane przechowywane są w subkatalogu MSGalerii, gdzie nazwa katalogu to złożenie litery "G" oraz czterocyfrowej liczby oznaczającej numer galerii np. "G0001". Wewnątrz katalogu znajduje się plik z opisami zdjęć oraz same zdjęcia wraz z miniaturkami
- Album - wirtualny element nie posiadający odwzorowania w strukturze katalogów - dane o nim są zapisane w msgallery.xml
Program nie posiada instalatora. Aby rozpocząć pracę, należy rozpakować zawartość archiwum dostępnego poniżej w wybranym przez siebie miejscu (zalecane to c:\Program Files\MSGallery\) oraz uruchomić plik msGallery.exe
Wówczas należy stworzyć nową galerię we wskazanym przez siebie nowym, bądź innym, jendakże pustym folderze oraz ustawić jednorazowo (dla danej galerii) parametry takie jak
- rozmiar zdjęcia i miniatury
- kompresję zdjęcia i miniatury
- rodzaj skalowania - czyli wg którego boku ma się odbywać
- treść pieczęci na zdjęciu
- rozmiar czcionki nanoszonej na zdjęcie pieczęci
- odległość pieczęci od prawej i dolnej krawędzi
- opis galerii
Po powyższych operacjach można zająć się strukturą galerii dodając albumy, galerie, zdjęcia.
Szablon wykorzystuje PHP oraz JAVA SCRIPT - m.in. AJAX (podziękowania dla autora obiektu AdvancedAJAX) i do poprawnego działania niezbędne jest spełenienie tychże wymagań.
Szablon należy przegrać do wcześniej wybranego przez nas folderu na serwerze hostingowym, struktura po powyższej operacji w tymże folderze ma wyglądać następująco:
- msGallery
- advajax.js
- brak.jpg
- brakm.jpg
- config.php
- galeriaXml.php
- msgalleryXml.php
- nag_1.php
- nag_2.php
- nag_3.php
- srodek.phpp
- styl.css
- index.php
Następnie należy do tegoż katalogu przegrać pliki z folderu utworzonego za pomocą programu MSGallery - plik struktury galerii msgallery.xml oraz foldery zdjęć, struktura będzie wyglądała następująco (przykładowo dla jednej galerii z jednym zdjęciem):
- G0001
- 1.jpg
- 1_sm.jpg
- galeria.xml
- msGallery
- advajax.js
- brak.jpg
- brakm.jpg
- config.php
- galeriaXml.php
- msgalleryXml.php
- nag_1.php
- nag_2.php
- nag_3.php
- srodek.phpp
- styl.css
- index.php
- msgallery.xml
Aby dokonywać aktualizacji galerii, należy nadpisywać na serwerze pliki i foldery zmienione przez program.
Plik config.php zawiera dane konfiguracyjne umieszczone w czytelny sposób, aby dostosować szablon do własnych wymagań należy dokonać odpowiednich zmian.
Bezwarunkowo należy podać w pliku konfiguracyjnym bezpośredni adres przez jaki będzie uzyskiwany dostęp do galerii:
$url = "http://www.skomy.miase.pl/example/msGallery/"; //bezpośredni adres do plików
ponieważ błędne wprowadzenie adresu uniemożliwi wyświetlenie galerii.
Aby zmienić wygląd szablomu można modyfikować plik styl.css.
System MSGaleria występuje w dwóch wersjach językowych: polskiej i angielskiej, jednakże wszystkie dane wyświetlane mieszczą się w plikach jezyk.xml - dla programu oraz config.php dla szablonu i bez problemu mągą zostać przetłumaczone na inne języki.
System może być wykorzystywany do użytku niekomercyjnego bez ograniczeń oraz komercyjnego (po uprzednim poinformowaniu autora o zaistniałej potrzebie) pod warunkiem istnienia w kodzie strony znacznika meta keywords z wartością zawierającą "msGallery 1.0" (np. meta http-equiv="Keywords" content="msGallery 1.0"). Szablon systemu można dowolnie modyfikować pod warunkiem widocznego w kodzie strony zaznaczenia iż jest to modyfikacja szablonu MSGallery.
Wygląd programu:
