编辑“Gallery:如何在缩略图旁显示自定义字段”

Gallery提供的外观主题设定允许显示单个相册或项目的自定义字段区块。如果你想在某相册中缩略图旁显示某项目的自定义字段的话，可以尝试一下下面的外观主题修改方法。 

== 自定义字段模板Callback ==
如果你只需显示少量字段的话，可以使用[[Gallery:Themes:Reference:Callbacks|customfield.LoadCustomFields]] callback。此方法的达成需要对外观主题的album.tpl文件做修改。

'''重要：''' 如果你在编辑某个Gallery的现有外观主题，请先明确[[Gallery:Themes:How_to_Edit_an_Existing_Theme|如何编辑已有的外观主题]]。

# 打开外观主题的相册模板文件（如themes/matrix/templates/album.tpl）
# 确认album.tp中项目缩略图，标题和描述的显示位置（查找$child.title）。
# 将下面的内容复制并粘贴到缩略图，标题或描述处
  {* 使用customfield.LoadCustomFields callback来获取字段的字串 *}
  {g->callback type="customfield.LoadCustomFields" itemId=$child.id}
  {if !empty($block.customfield.LoadCustomFields.fields.Item)}
    &lt;ul&gt;
      {foreach from=$block.customfield.LoadCustomFields.fields item=customField}
      &lt;li&gt;{$customField}&lt;/li&gt;
      {/foreach}
    &lt;/ul&gt;
  {/if}

保存album.tpl之后，应能在相册页面的项目旁看到自定义字段了。Callback的安置和运行都很简单。如果你的网站容量很大并且要考虑性能表现的话，请在你外观主题的theme.inc 文件中载入自定义字段数据。

== 载入Theme.inc中的自定义字段数据 ==

显示大量项目的繁忙站点通过载入theme.inc 中的自定义字段而不是用callback的话，会得到很好的效果。 

# 打开外观主题的theme.inc文件（如themes/matrix/theme.inc）
# 在showAlbumPage()中添加以下内容，就在函数返回行之上，return array (null, 'theme.tpl').
  /* 获取自定义字段 */
  list ($ret, $children) = GalleryCoreApi::loadEntitiesById($childIds);
  if ($ret) {
    return array($ret, null);
  }
  
  list ($ret, $theme['customFieldValues']) =
    CustomFieldHelper::fetchFieldValues($children, 'detail');
  if ($ret) {
    return array($ret, null);
  }

接着，在album.tpl中显示自定义字段

# 打开外观主题的相册模板文件（如themes/matrix/templates/album.tpl）
# 确认album.tp中项目缩略图，标题和描述的显示位置（查找$child.title）。
# 将下面的内容复制并粘贴到缩略图，标题或描述处
  {* 显示某child的自定义字段 *}
  {if isset($theme.customFieldValues[$child.id])}
  &lt;ul&gt;
    {foreach from=$theme.customFieldValues[$child.id] key=name item=value}
    &lt;li&gt;{$name}: {$value}&lt;/li&gt;
    {/foreach}
  &lt;/ul&gt;
  {/if}