1. Заливаем на сервер
2. Устанавливаем на папки "/ajax/cache", "/thumbs" и "/photos" и файл "/ajax/inc/config.php" права 777
3. Папки с фотографиями складывать в photos
4. Важно! Не использовать в именах папок c фотографиями символы _ ' "
5. Зайти на страничку конфигурации http://yoursite.ru/?config под логином "root" и паролем "toor", сменить пароль по умолчанию на СВОЙ
6. Изменить текст на главной можно через конфигурационную страницу, в шаблоне этого текста НЕТУ
Файлы для редактирования
основной шаблон "/ajax/templates/main.tpl"
файл стилей "/assets/css/main.css"
Если будете менять дизайн, то это ОБЯЗАТЕЛЬНО должно присутствовать в main.tpl:
1. Контейнер с классом "top" - в него складываются названия галерей при загрузке страницы
2. Контейнер с id "about" - текст внутри выводится на главной и по ссылке about
3. Контейнер с id "imglist" - в него складываются фотографии
4. Контейнер с классом "floatfix" - это убирает косяки с css, что б пагинатор был на своём месте
5. Контейнер с id "paginator" - в него складываются ссылки постраничной навигации
Использование заливки архивов
1. Только zip!
2. Внутри ахива структура должна состоять из папок (названий галлерей), пример ниже:
photos.zip/
/gallery1/
—— photo.jpg
—— photo2.jpg
/gallery2/
—— /subgallery1/
———— photo1.jpg
———— photo2.jpg
—— photo1.jpg
—— photo2.jpg
1. Идём по этой ссылке http://www.flickr.com/services/api/keys/apply/
2. Выбирем не комерческое использование
3. Пишем зачем нужен api ключ
4. Получив api key прописываем его в /ajax/callback.php
$flickr_api = "тут api key";
5. Свой фликровский %username% прописываем
$flickr_uname = "тут";
6. Заливаем на сервер
7. Устанавливаем на папку ajax/cache права 777
8. Кэш обновляется раз в 20 минут
Настройка в файле /ajax/callback.php:
Количество фотографий на страницу
$per_page = 4;
Минимальный размер шрифта для тэгов
$min_font = 9;
Максимальный размер шрифта для тэгов
$max_font = 16;
Сколько тэгов выводить
$tags_count = 150;
Размер превьюшки - "thumbnail" = 100px, "small" = 240px
$th_size = "small";
Размер фото по клику - "medium" = 500px, "large" = 1024px
$la_size = "medium";
Если будете менять дизайн, то это ОБЯЗАТЕЛЬНО должно присутствовать в index.html:
1. Контейнер с классом "top" - в него складываются названия галерей при загрузке страницы
2. Контейнер с id "about" - текст внутри выводится на главной и по ссылке about
3. Контейнер с id "imglist" - в него складываются фотографии
4. Контейнер с классом "floatfix" - это убирает косяки с css
5. Контейнер с id "tags" - туда складываются тэги
6. Контейнер с id "paginator" - в него складываются ссылки постраничной навигации
2. Выбирем не комерческое использование
3. Пишем зачем нужен api ключ
4. Получив api key прописываем его в /ajax/callback.php
$flickr_api = "тут api key";
5. Свой фликровский %username% прописываем
$flickr_uname = "тут";
6. Заливаем на сервер
7. Устанавливаем на папку ajax/cache права 777
8. Кэш обновляется раз в 20 минут
Настройка в файле /ajax/callback.php:
Количество фотографий на страницу
$per_page = 4;
Минимальный размер шрифта для тэгов
$min_font = 9;
Максимальный размер шрифта для тэгов
$max_font = 16;
Сколько тэгов выводить
$tags_count = 150;
Размер превьюшки - "thumbnail" = 100px, "small" = 240px
$th_size = "small";
Размер фото по клику - "medium" = 500px, "large" = 1024px
$la_size = "medium";
Если будете менять дизайн, то это ОБЯЗАТЕЛЬНО должно присутствовать в index.html:
1. Контейнер с классом "top" - в него складываются названия галерей при загрузке страницы
2. Контейнер с id "about" - текст внутри выводится на главной и по ссылке about
3. Контейнер с id "imglist" - в него складываются фотографии
4. Контейнер с классом "floatfix" - это убирает косяки с css
5. Контейнер с id "tags" - туда складываются тэги
6. Контейнер с id "paginator" - в него складываются ссылки постраничной навигации
Если возникают проблемы с кодировкой (отображается кракозябрами):
Создайте в папке с "mini gallery" файл .htaccess (да с точкой и да без расширения) в котором будут такие буквы:
"AddDefaultCharset UTF–8" (без кавычек)
mini gallery не показывает уменьшенные копии картинок:
У php должен быть включён модуль GD2
Если всё ок, то проверьте выставили ли chmod 777 на папки "/thumbs/" и "/ajax/cache"
mini gallery нормально работала, но после добавления новых фотографий их нету в списке:
Скорей всего время жизни кэша ещё не истекло, поэтому нужно либо самостоятельно удалить всё из папки "/ajax/cache", либо через конфигурационную страницу в разделе "полезные штучки"
mini gallery не показывает разделы после установки:
Нужно либо самостоятельно удалить всё из папки "/ajax/cache", либо через конфигурационную страницу в разделе "полезные штучки". В ближайшей версии это недоразумение будет исрпавлено
Flickr версия не желает показываеть картинки:
Проверьте выставили ли chmod 777 на папку "/ajax/cache", если же не помогло то стоит обратиться в службу поддержки вашего хостера, важно чтобы php скрипты пускало за пределы сервера
Обе версии mini gallery не показывают разделы:
Версия php должна быть 5 и выше, к сожалению на 4 версии не работает.
Создайте в папке с "mini gallery" файл .htaccess (да с точкой и да без расширения) в котором будут такие буквы:
"AddDefaultCharset UTF–8" (без кавычек)
mini gallery не показывает уменьшенные копии картинок:
У php должен быть включён модуль GD2
Если всё ок, то проверьте выставили ли chmod 777 на папки "/thumbs/" и "/ajax/cache"
mini gallery нормально работала, но после добавления новых фотографий их нету в списке:
Скорей всего время жизни кэша ещё не истекло, поэтому нужно либо самостоятельно удалить всё из папки "/ajax/cache", либо через конфигурационную страницу в разделе "полезные штучки"
mini gallery не показывает разделы после установки:
Нужно либо самостоятельно удалить всё из папки "/ajax/cache", либо через конфигурационную страницу в разделе "полезные штучки". В ближайшей версии это недоразумение будет исрпавлено
Flickr версия не желает показываеть картинки:
Проверьте выставили ли chmod 777 на папку "/ajax/cache", если же не помогло то стоит обратиться в службу поддержки вашего хостера, важно чтобы php скрипты пускало за пределы сервера
Обе версии mini gallery не показывают разделы:
Версия php должна быть 5 и выше, к сожалению на 4 версии не работает.
Если вы хотите переписать backend на свой лад, или перевести его на ruby, python, asp, важно чтобы данные отдавались в json формате. При начальной загрузке страницы javascript обращается к скрипту с запросом
/ajax/callback.php?list=yes
Данные о списке категорий отдаются в таком формате
{"gallerys": [{"id": "1", "name": "firstcategory", "count": "19"}, {"id": "2", "name": "secondcategory", "count": "89"}] }
"gallerys" - "id" идентификатор или просто порядковый номер папки, "name" собственно назваие папки, важно чтобы этот параметр передавался правильно, потому как запрос будет идти по нему, "count" количество фотографий в папке
Далее если кликнуть на ссылку категории идёт запрос к скрипту в формате
/ajax/callback.php?category={id}_{categoryname}&page={pagenumber}"
где "id" это фэйковый идентификатор, роли не играет, но важен для javascripta, помогает избавится от проблем с одинаковыми именами папок, category это имя папки и "page" отсчёт страниц начинается с нуля
Ответные данные приходят в таком виде:
{"photos": [{"img": "00005.jpg", "thumb": "th_00005.jpg"}, {"img": "00007.jpg", "thumb": "th_00007.jpg"}], "support": [{"olocation": "photos/city/", "tlocation": "photos/city/thumbs/", "style": "width: 170; height: 113"}], "paginator": [{"prev": "", "next": "1"}]}
"photos" - "img" это имя файла в оригинальном размере, "thumb" уменьшенная копия
"support"- "olocation" где находится папка с оригинальными изображениями, "tlocation" - с уменьшенными копиями
"style" - передаёт "width" ширину и "height" высоту уменьшенной копии
"paginator" - передаёт номер "prev" предущей и "next" следующей страницы
/ajax/callback.php?list=yes
Данные о списке категорий отдаются в таком формате
{"gallerys": [{"id": "1", "name": "firstcategory", "count": "19"}, {"id": "2", "name": "secondcategory", "count": "89"}] }
"gallerys" - "id" идентификатор или просто порядковый номер папки, "name" собственно назваие папки, важно чтобы этот параметр передавался правильно, потому как запрос будет идти по нему, "count" количество фотографий в папке
Далее если кликнуть на ссылку категории идёт запрос к скрипту в формате
/ajax/callback.php?category={id}_{categoryname}&page={pagenumber}"
где "id" это фэйковый идентификатор, роли не играет, но важен для javascripta, помогает избавится от проблем с одинаковыми именами папок, category это имя папки и "page" отсчёт страниц начинается с нуля
Ответные данные приходят в таком виде:
{"photos": [{"img": "00005.jpg", "thumb": "th_00005.jpg"}, {"img": "00007.jpg", "thumb": "th_00007.jpg"}], "support": [{"olocation": "photos/city/", "tlocation": "photos/city/thumbs/", "style": "width: 170; height: 113"}], "paginator": [{"prev": "", "next": "1"}]}
"photos" - "img" это имя файла в оригинальном размере, "thumb" уменьшенная копия
"support"- "olocation" где находится папка с оригинальными изображениями, "tlocation" - с уменьшенными копиями
"style" - передаёт "width" ширину и "height" высоту уменьшенной копии
"paginator" - передаёт номер "prev" предущей и "next" следующей страницы