getFacebookPhotos

Сниппет getFacebookPhotos формирует списки альбомов и фото профиля Facebook (пользователя или страницы). В текущей версии работает только с публичными данными. Всё активно кэшируется ради производительности. Для более свежих данных настройте свойства кэша.

getFacebookPhotos использует собственный кэш, поэтому его можно вызывать без кэша MODX.

Доступные свойства¶

Список актуален для версии 1.0.0. Обязательные свойства выделены жирным.

Кэш альбомов загружает все альбомы и все их фото одним оптимизированным запросом. Если внезапно истечёт только кэш фото, все видимые альбомы начнут делать мелкие запросы к Facebook, и производительность проседает. Свойство cacheExpiresPhotosVariation сглаживает это, разносит моменты истечения кэша фото.

Допустим, getFacebookPhotos показывает три альбома с cacheExpires 2 дня и cacheExpiresPhotos 12 часов. Каждые 12 часов Facebook получит 3 запроса фото для этих альбомов. Без cacheExpiresPhotosVariation срок истечения у каждого альбома совпадал бы, и одному посетителю пришлось бы ждать 3 ответа от Facebook (это не всегда быстро). Тогда включается cacheExpiresPhotosVariation. При значении 1 час (по умолчанию) срок кэша фото для каждого альбома случайно попадает в диапазон ±1 час от cacheExpiresPhotos: в нашем примере между 11 и 13 часами. Один посетитель не ждёт 3 запроса подряд, нагрузка распределяется на трёх. Win-win-win-win! | 3600 ( = 1 hour) |

Шаблоны¶

Для ленты фото Facebook доступны три чанка: photoTpl для каждого фото, albumTpl для обёртки альбомов при включённом perAlbum и outerTpl для всего вывода.

Ниже значения по умолчанию и доступные плейсхолдеры.

photoTpl¶

Чанк по умолчанию:

<li>
    <img src="[[+src_small]]" width="[[+src_small_width]]" height="[[+src_small_height]]" />
</li>

Плейсхолдеры для photoTpl. Часть может быть недоступна из-за прав.

albumTpl¶

Чанк albumTpl по умолчанию. Для использования нужен включённый perAlbum.

 <h2><a href="[[+link]]">[[+name]]</a> <span>([[+photo_count]] photos, created on [[+created:date=`%d/%m/%Y`]])</span></h2>
<div>
    <ul>
        [[+photos]]
    </ul>
</div>

Доступные плейсхолдеры. Часть может быть недоступна из-за прав:

outerTpl¶

outerTpl по умолчанию:

 <ul>
    [[+photos]]
</ul>

В этом шаблоне доступен только плейсхолдер "photos".

Примеры¶

Вариантов много!

Простой пример: группировка фото по альбомам с шаблонами по умолчанию¶

Вызов сниппета:

[[!getFacebookPhotos?
    &user=`modxcms`
    &perAlbum=`1`
]]

без настройки даёт такой вывод:

<h2><a href="http://www.facebook.com/album.php?fbid=437577137979&id=19110642979&aid=235059">Profile Pictures</a> <span class="smalldate">(1 photos, created on 12/09/2010)</span></h2>
<div class="gfp-photos-wrapper">
    <ul>
        <li class="gfp-photo">
    <img src="http://photos-a.ak.fbcdn.net/hphotos-ak-snc6/179529_10150898281902980_465676445_t.jpg" width="75" height="75" />
</li>

    </ul>
</div>
<br />


<h2><a href="http://www.facebook.com/album.php?fbid=10150883337702980&id=19110642979&aid=434455">CMS Expo 2012</a> <span class="smalldate">(33 photos, created on 12/05/2012)</span></h2>
<div class="gfp-photos-wrapper">
    <ul>
        <li class="gfp-photo">
    <img src="http://photos-c.ak.fbcdn.net/hphotos-ak-ash3/529915_10150883341757980_1041537877_t.jpg" width="75" height="56" />
</li>

<li class="gfp-photo">
    <img src="http://photos-d.ak.fbcdn.net/hphotos-ak-ash3/537753_10150883341637980_1323647473_t.jpg" width="75" height="56" />
</li>
<!-- ... -->
<li class="gfp-photo">
    <img src="http://photos-c.ak.fbcdn.net/hphotos-ak-ash3/534903_10150883337842980_1414876671_t.jpg" width="75" height="50" />
</li>

    </ul>
</div>
<!-- ... -->