Дневник “Идущего к Цели”

Shashin — плагин для отображения фотографий Picasa

Достаточно длительное время на своем сайте я пользовался плагином NextgGen Gallery очень хороший и удобный плагин. Но у меня к нему было два вопроса. Во-первых он создавал порядка 30 запросов, что на мой взгляд не есть хорошо, во-вторых создавал трафик, поскольку графика имеет значительный размер. Поэтому я поставил себе задачу найти плагин, который бы интегрировал на сайт галереи Google Picasa. Оказалось, что плагинов, в той или иной степени выполняющих данную функцию, порядка десятка. В результате экспериментов я остановил свой выбор на плагине Shashin от Michael Toppa.
Поскольку плагин не был русифицирован и даже не был подготовлен к локализации, пришлось мне это сделать. Вот версия плагина подготовленная к локализации:

  Плагин Shashin (128,1 KiB, скачиваний: 479)

а вот, собственно, файлы локализации:

  Русификатор плагина Shashin (12,9 KiB, скачиваний: 390)

Ну и заодно перевел инструкции по установке и использованию плагина с сайта автора.

Shashin — плагин WordPress для отображения фотографий Picasa.

Он позволяет Вам:

• Внедрить галерею своих альбомов Picasa, и все фотографии в этих альбомах на Ваш сайт.
• Показывать фотографии с использование скрипта Highslide.
• Использовать любой размер, поддерживаемый Picasa, для отображения Ваших фотографий.
• Указать любую комбинацию альбомов, для отображения в группах миниатюр.
• Отображать миниатюры Ваших самых новых фотографий из одного или нескольких альбомов.
• Отображать миниатюры альбома для альбомов, которые Вы выберите или все Ваши альбомы, отсортированные, как Вам нравится.
• Включить ссылки на карты Google.
• Показывать любое количество случайных фотографий, из одного или нескольких альбомов. Вы можете также исключить определенные фотографии или альбомы из случайного показа.
• Настроить таблицу стилей Shashin, в соответствии с темой Вашего сайта.

Коммерческое Использование Highslide

Shashin использует Highslide. Хотя автор ничего не требует за использование Shashin на коммерческом сайте, Highslide является бесплатным только для некоммерческого использования. Поэтому если Вы используете Shashin в коммерческих целях, Вы должны либо:

1. не использовать Highslide в плагине Shashin;
2. внести соответствующую плату за использование Highslide ее создателю.

Техподдержка осуществляется на сайте разработчика, путем использования комментариев в посте, объявляющем о Shashin 2.1 для вопросов.

Руководство по использованию

• Установка и конфигурирование Shashin
• Синхронизация Shashin с Picasa
• Использование Shashin с Highslide
• Использование тэгов Shashin
  • Поддерживаемые размеры изображения
  • Отображение единственного изображения — тэг [simage] и виджет
  • Отображение миниатюр альбома и фотографий альбома — простой вариант, с тэгом [salbumphotos]
  • Отображение миниатюр альбомов, но более сложный вариант с изменяемой конфигурацией, с тэгами [salbum], [salbumthumbs], [salbumlist] и графическими фрагментами
  • Отображение миниатюр всех фотографий в альбоме, но более сложный вариант с изменяемой конфигурацией, с тэгом [salbumphotos]
  • Отображение миниатюр изображений — тэг [sthumbs] и виджет
  • Отображение случайных изображений — тэг [srandom] и виджет
  • Отображение последних загруженных изображений — тэг [snewest] и виджет
• Shashin и таблицы стилей Highslide

Установка и конфигурирование Shashin

Загрузите плагин Shashin, разархивируйте, и скопируйте папку “shashin” в Ваш каталог plugins. Активизируйте его в панели управления плагинами. После успешной активации Shashin появится в меню “Manage” и “Options”.

Зайдите в меню “Options” для настроек опций по умолчанию. Обратите внимание, что Highslide по умолчанию не активизирован — Вы должны активизировать его, если хотите его использовать. Если Ваш сервер Picasa вне США, измените URL сервера (например: http://picasaweb.google.com).

Теперь зайдите в меню “Manage” и следуйте подсказкам, чтобы добавить Ваш первый альбом!

Обратите внимание, что Shashin добавляет две таблицы к Вашей базе данных WordPress, которые называются wp_shashin_album и wp_shashin_photo. Вы должны включить эти таблицы, при сохранении резервных копий Ваших таблиц WordPress.

Особое примечание для обновления с версии младше 2.0: Дезактивируйте и удалите свою старую версию плагина, скопируйте новую версию, затем активизируйте. Это необходимо для обновления таблиц Shashin.

Особое примечание для инсталляций WordPress, которые находятся в подкаталоге: В большинстве случаев Shashin может самостоятельно обнаружить местоположения файлов, но если Ваша инсталляция WordPress находится в подкаталоге Вашего сайта, то Вы должны будете самостоятельно отредактировать 5 путей URL, перечисленных в shashin/display/highslide.css, чтобы правильно отразить местоположение Вашей инсталляции WordPress.

Синхронизация Shashin с Picasa

В панели администрирования Shashin Вы должны будете синхронизировать альбом всякий раз, когда Вы обновляете его в Picasa. Или, Вы можете использовать опцию «Синхронизировать все», чтобы синхронизировать все Ваши альбомы сразу. Это позволяет синхронизировать Ваши таблицы Shashin с Picasa RSS. Заметьте, что, если Вы удаляете фотографию из Picasa, они также будут удалены из таблиц Shashin, когда Вы синхронизируете альбом.

Использование Shashin с Highslide

Shashin использует специально сконфигурированную версию Highslide, таким образом Вам не надо загружать Highslide отдельно. Чтобы активизировать Highslide, перейдите в меню Настройки Shashin и выберите Highslide для опции «Полноразмерное изображение:». Вы можете также указать максимальный размер для изображений, отображаемых Highslide. Для фотографий, которые Вы отображаете в группах (используя тэги Shashin [snewest], [sthumbs], и т.д.) на экране Highslide появится навигационное меню. Для изображений, отображаемых индивидуально (с тэгом [simage]) навигационное меню не появится.

Не изменяйте Highslide, поскольку это может привести к прекращению его работы с Shashin. Заметьте, что Highslide является бесплатным только для некоммерческого использования.

Использование тэгов Shashin

Есть множество опций, доступных в тэгах Shashin’s. Самый лучший способ работы, откройте два окна в Вашем браузере и переключайтесь между ними — одно для того, чтобы писать Ваш пост и другое для страницы администрирования Shashin. На странице администрирования есть разметка для тэгов Shashin, которые Вы можете скопировать и вставить в свой пост. После вставки Вы можете редактировать опции как Вам необходимо.

Важно отметить, что Shashin назначает собственные номера для альбомов и фотографий Picasa. В документации ниже они упоминаются как номер альбома и номер фотографии. Это должно избавить Вас от необходимости указывать идентификаторы Picasa, которые могут оказаться очень длинными, когда Вы используете тэги Shashin.

Тэг Shashin будет оттранслирован в xhtml контейнер <div>. Всегда указывайте включение тэга Shashin на отдельной строке в Вашем посте или на странице. Это важно, так как WordPress автоматически форматирует Ваши посты. Если Вы включаете тэг Shashin, вместе с другим текстом, то это может привести к тому, что WordPress добавит тэг к тексту. Это неверный xhtml (хотя в большинстве случаев браузеры все же отобразят его правильно).

У всех тэгов Shashin есть опции, которые позволяют, Вам установить свойство css float и свойство css clear. Оба являются дополнительными. Если Вы устанавливаете свойство float, хотя обычно нет никакой необходимости устанавливать явное значение (например: типичное использование float — это обтекание текстом слева или справа, и затем очистка отступов). Помните, что цель float состоит в том, чтобы установить обтекание контейнерного потока вокруг других контейнеров. Если Вы размещаете float изображение близко к концу Вашего поста, это может привести к тому, что оно выйдет за пределы поста. Чтобы избежать этого, поместите <br clear=»all» /> тэг в конец Вашего поста.

Поддерживаемые размеры изображения

Picasa поддерживает только определенный набор размеров изображения. Если Вы попытаетесь использовать размер, не перечисленный, то Ваше изображение не будет отображаться вообще. Размеры:

32, 48, 64, 72, 144, 160, 200, 288, 320, 400, 512, 576, 640, 720, 800

Обратите внимание, что эти размеры представляют из себя “максимальную размерность.” Это означает, что если Вы выбираете размер 640 и у Вашего изображения ландшафтная ориентация, тогда это будет ширина 640 пикселей. Если у Вашего изображения будет вертикальная ориентация, то это будет высота 640 пикселей. Shashin автоматически вычисляет правильный размер для другой размерности.

Обратите внимание, что 32, 48, 64, и 160 специальные размеры. Picasa подрежет их к квадратной форме. Это делает их полезными для того, чтобы отображать таблицы миниатюр.

Отображение единственного изображения — тэг [simage] и виджет

В посте или на странице, используйте тэг [simage]:

[simage=photo_key,max_size,caption_yn,float,clear]

Пример: [simage=268,200,n,left]

Для боковой панели Вы можете выбрать виджет “Shashin: Одиночное изображение” на странице администрирования виджетов, или использовать этот код с желаемыми значениями:


< ?php echo Shashin::getSingle(photo_key, max_size, 'caption_yn', 'float', 'clear'); ?>


• photo_key: (обязательный) номер Фотографии, указан для изображения на странице администрирования Shashin
• max_size: (обязательный) размер, Вы должны выбрать из списка приведенного выше
• caption_yn: (дополнительный, значение по умолчанию “n”), используйте “y” или “n”, чтобы указать, хотите ли Вы, чтобы заголовок появился под изображением
• float: (дополнительный) свойство CSS float
• clear: (дополнительный) свойство CSS clear

Отображение миниатюр альбома и фотографий альбома — простой вариант, с тэгом [salbumphotos]

Если Вы хотите создать страницу, на которой будут отображаться миниатюры для всех Ваших альбомов, при нажатии на которые будут отображены миниатюры всех фотографий в альбоме, следуйте этим инструкциям.

1. Создайте страницу, содержащую тэг [salbumphotos]. Вы можете, также, если хотите, включить дополнительный текст на странице. Эта страница автоматически отобразит миниатюры для всех альбомов, которые Вы загрузили в Shashin, отсортированные по году опубликования (если Вы хотите сортировать их по-другому, или отобразить только определенные альбомы, тогда Вы должны следовать инструкциям ниже для изменения конфигурации). Если Вы нажимаете на миниатюру альбома, то должны быть отображены миниатюры для всех фотографий в этом альбоме. Заголовок альбома появится как заголовок для таблицы, отображающей миниатюры.

2. Тэг [Salbumphotos] имеет следующие опции:

[salbumphotos=max_size,max_cols,caption_yn,description_yn,order_by,float,clear]

Пример: [salbumphotos=160,3,n,y]

• max_size: (обязательный) размер, Вы должны выбрать из списка приведенного выше
• max_cols: (обязательный) количество столбцов миниатюр
• caption_yn: (дополнительный, значение по умолчанию “n”), используйте “y” или “n”, чтобы указать, хотите ли Вы, чтобы заголовок появился под изображением
• description_yn: (дополнительный, значение по умолчанию “n”), используйте “y” или “n”, чтобы указать, хотите ли Вы выводить описание альбома в заголовке таблицы
• order_by: (дополнительный, значение по умолчанию “taken_timestamp”) поле, указывающее порядок сортировки фотографий. Возможные значения — “taken_timestamp”, “title” (здесь имя файла), и “uploaded_timestamp”.
• float: (дополнительный) свойство CSS float
• clear: (дополнительный) свойство CSS clear

3. В меню Настроки Shashin, введите URL для страницы, содержащей тэг [salbumphotos], которую Вы только что создали.

Отображение миниатюр альбома, но более сложный вариант с изменяемой конфигурацией, с тэгами [salbum], [salbumthumbs], [salbumlist] и графическими фрагментами

Для миниатюры альбома размер установлен Picasa в 160×160, изменение размера в опциях тэгов на него не влияет. Shashin автоматически отображает заголовок альбома ниже миниатюры. Если Вы захотите отображать местоположение, то оно появится под заголовком, связанный значок Карт Google появится рядом с заголовком.

1. Отображение миниатюры одиночного альбома:

В посте или на странице, используйте тэг [salbum]:

[salbum=album_key,location_yn,pubdate_yn,float,clear]

Пример: [salbum=2,y,n,left]

Для боковой панели Вы можете выбрать виджет “Shashin: Миниатюра одиночного альбома” на странице администрирования виджетов, или использовать этот код с желаемыми значениями:


< ?php echo Shashin::getAlbum(album_key, 'location_yn', 'pubdate_yn', 'float', 'clear'); ?>


• album_key: (обязательный) номер альбома, указан для альбомов на странице администрирования Shashin
• location_yn: (дополнительный, значения по умолчанию “n”), используйте “y” или “n”, чтобы указать, хотите ли Вы, чтобы местоположение появилось под заголовком. Значок Карт Google также будет добавлен
• pubdate_yn: (дополнительный, значения по умолчанию “n”), используйте “y” или “n”, чтобы указать, хотите ли Вы, чтобы дата публикации альбома появилась под заголовком
• float: (дополнительный) свойство CSS float
• clear: (дополнительный) свойство CSS clear

2. Отображение миниатюр нескольких альбомов:

Есть два различных способа это реализовать. Если нужно отобразить миниатюры для всех Ваших альбомов, в порядке, который Вы определите. Опции сортировки — “pub_date”, “title”, или “last_updated”. Вы можете также добавить “desc”, если Вы хотите использовать сортировку по убыванию.

[salbumthumbs=order_option,max_cols,location_yn,pubdate_yn,float,clear]

Пример: [salbumthumbs=pub_date desc,2,y,n,left]

Другой вариант, Вы должны перечислить номера определенных альбомов, если Вы не хотите отобразить все:

[salbumthumbs=album_key1|album_key2|etc,max_cols,location_yn,pubdate_yn,float,clear]

Пример: [salbumthumbs=2|24|33,2,y,n]

Для боковой панели Вы можете выбрать виджет “Shashin: Миниатюра альбома” на странице администрирования виджетов, или использовать этот код с желаемыми значениями:


< ?php echo Shashin::getAlbumThumbs('to_show', max_cols, 'location_yn', 'pubdate_yn', 'float', 'clear'); ?>


• to_show: (обязательный) смотрите опции выше (Вы можете указать номера альбомов или порядок сортировки)
• max_cols: (обязательный) количество столбцов миниатюр
• location_yn: (дополнительный, значения по умолчанию “n”), используйте “y” или “n”, чтобы указать, хотите ли Вы, чтобы местоположение появилось под заголовком. Значок Карт Google также будет добавлен
• pubdate_yn: (дополнительный, значения по умолчанию “n”), используйте “y” или “n”, чтобы указать, хотите ли Вы, чтобы дата публикации альбома появилась под заголовком
• float: (дополнительный) свойство CSS float
• clear: (дополнительный) свойство CSS clear

3. Отображение альбомов с описаниями:

Тоже самое, что и предыдущая опция, но отображает, также, заголовок альбома и описание рядом с каждой миниатюрой. С заданным по умолчанию CSS — схема отображения в два столбца, с заголовками и описаниями справа от миниатюр. Вы можете изменить shashin_album_list* в shashin.css, если хотите иную схему отображения.

[salbumlist=order_option,max_cols,info_yn]

Пример: [salbumlist=pub_date desc,n]

Как и в [salbumthumbs], Вы можете перечислить номера определенных альбомов, если Вы не хотите отобразить все:

[salbumlist=album_key1|album_key2|etc,info_yn]

Пример: [salbumlist=2|24|33,y]

Для любой опции в PHP, Вы можете использовать этот код с желаемыми значениями.


< ?php echo Shashin::getAlbumList('to_show', 'info_yn'); ?>


Для [salbumlist] виджета нет.

• to_show: (обязательный) смотрите опции выше (Вы можете указать номера альбомов или порядок сортировки)
• info_yn: (дополнительный, значения по умолчанию “n”), если “y”, то будет отображено количество фотографий в альбоме, дата публикации, и местоположение между заголовком и описанием.

Отображение миниатюр всех фотографий в альбоме, но более сложный вариант с изменяемой конфигурацией, с тэгом [salbumphotos]

Если Вы используете тэги [salbum], [salbumthumbs] или [salbumlist], для отображения миниатюр альбомов, и Вы хотите связать их со страницей на Вашем сайте, отображающей все фотографии в каждом альбоме, Вы, также, можете использовать тэг [salbumphotos], но при этом добавляются еще несколько шагов, в отличии от «простой» установки, описанной выше.

1. Для Ваших желаемых альбомов, используйте тэги [salbum], [salbumthumbs] или [salbumlist] на странице или в посте.

2. Создайте страницу, содержащую тэг [salbumphotos]. Эта страница будет отображать фотографии для любого требуемого альбома. Не стесняйтесь помещать что-нибудь еще, что Вам нравится, на странице — кроме того включите ссылку назад на страницу, которая отображает Ваши миниатюры альбомов. См. выше для тэга [salbumphotos] и как активизировать страницу в Вашем меню Настройки Shashin.

Отображение миниатюр изображений — тэг [sthumbs] и виджет

Shashin может генерировать таблицу миниатюр, содержащую изображения, которые Вы указали. Вы можете также указать, количество столбцов таблицы и отображать ли заголовки. Обратите внимание, что этот тэг стандартно используется для миниатюр, но так как Вы можете определить размер изображения, то можете использовать его, также, для отображения больших изображений.

В посте или на странице, используйте тэг [sthumbs]:

[sthumbs=photo_key1|photo_key2|etc,max_size,max_cols,caption_yn,float,clear]

Пример: [sthumbs=5|202|115|84|33|189,160,3,n,none,both]

Для боковой панели Вы можете выбрать виджет “Shashin: Миниатюра изображения” на странице администрирования виджетов, или использовать этот код с желаемыми значениями:


< ?php echo Shashin::getThumbs('photo_key1|photo_key2|etc', max_size,max_cols, 'caption_yn', 'float', 'clear'); ?>


• photo_key1|photo_key2|etc: (обязательный) номера Фотографий, сколькоы Вы хотите, разделенные символом |
• max_size: (обязательный) размер, Вы должны выбрать из списка приведенного выше
• max_cols: (обязательный) количество столбцов миниатюр
• caption_yn: (дополнительный, значение по умолчанию “n”), используйте “y” или “n”, чтобы указать, хотите ли Вы, чтобы заголовок появился под изображением
• float: (дополнительный) свойство CSS float
• clear: (дополнительный) свойство CSS clear

Отображение случайных изображений — тэг [srandom] и виджет

Вы можете отобразить таблицу случайных изображений. Вы можете указать, сколько изображений включить в таблицу и количество столбцов таблицы. Вы можете указать, должны ли случайные изображения быть из определенного альбома или из всех альбомов. Если Вы хотите отобразить единственное случайное изображение, просто укажите 1 изображение и 1 столбец для таблицы. Обратите внимание, что, если на странице администрирования Вы измените в свойствах альбома, «Включать в Случайный” флажок на «Нет», тогда его фотографии не будут появляться в отображении случайных изображений. То же самое — для одиночных изображений, где Вы устанавливаете флажок в «Нет».

В посте или на странице, используйте тэг [srandom]:

[srandom=album_key,max_size,max_cols,how_many,caption_yn,float,clear]

Пример: [srandom=any,288,2,6,n,none,both]

Для боковой панели Вы можете выбрать виджет “Shashin: Случайные изображения” на странице администрирования виджетов, или использовать этот код с желаемыми значениями:


< ?php echo Shashin::getRandom(album_key, max_size, max_cols, how_many, 'caption_yn', 'float', 'clear'); ?>


• album_key: (обязательный) “any” для всех альбомов или номер альбома, указан для альбомов на странице администрирования Shashin
• max_size: (обязательный) размер, Вы должны выбрать из списка приведенного выше
• max_cols: (обязательный) количество столбцов миниатюр
• how_many: (обязательный) количество случайных изображений для отображения в таблице
• caption_yn: (дополнительный, значение по умолчанию “n”), используйте “y” или “n”, чтобы указать, хотите ли Вы, чтобы заголовок появился под изображением
• float: (дополнительный) свойство CSS float
• clear: (дополнительный) свойство CSS clear

Отображение последних загруженных изображений — тэг [snewest] и виджет

Вы можете отобразить таблицу своих последних загруженных изображений. Вы можете указать, сколько изображений включить в таблицу, и количество столбцов таблицы. Вы можете указать, должны ли изображения быть из определенного альбома или из всех альбомов. Если Вы хотите отобразить только самое новое изображение, просто укажите 1 изображение и 1 столбец для таблицы.

В посте или на странице, используйте тэг [snewest]:

[snewest=album_key,max_size,max_cols,how_many,caption_yn,float,clear]

Пример: [snewest=any,288,2,6,n,none,both]

Для боковой панели Вы можете выбрать виджет “Shashin: Новые изображения” на странице администрирования виджетов, или использовать этот код с желаемыми значениями:


< ?php echo Shashin::getNewest(album_key, max_size, max_cols, how_many, 'caption_yn', 'float', 'clear'); ?>


• album_key: (обязательный) “any” для всех альбомов или номер альбома, указан для альбомов на странице администрирования Shashin
• max_size: (обязательный) размер, Вы должны выбрать из списка приведенного выше
• max_cols: (обязательный) количество столбцов миниатюр
• how_many: (обязательный) количество случайных изображений для отображения в таблице
• caption_yn: (дополнительный, значение по умолчанию ‘n’), используйте ‘y’ или ‘n’, чтобы указать, хотите ли Вы, чтобы заголовок появился под изображением
• float: (дополнительный) свойство CSS float
• clear: (дополнительный) свойство CSS clear

Shashin и таблицы стилей Highslide

В каталоге плагина shashin/display/shashin.css Вы можете редактировать CSS для определения того, как Shashin будет отображать изображения. Комментарии в этом файле объясняет, какие классы где применены. Важное примечание: если Вы измените значения свойства padding для “.shashin_image img” или “.shashin_thumb img” то, Вы должны будете войти в меню Настройки для Shashin и изменить значения для “Отступы тега div для изображения:” или “Отступы тега div для миниатюр изображения:”.

Существует, также, таблица стилей для Highslide shashin/display/highslide.css. Заметьте, что она содержит жестко прописанные пути для некоторых URL — Вы должны будете изменить их, если у Вас WordPress, установленный в подкаталоге. Вы можете найти документацию по Highslide CSS правилам здесь.