编辑“Gallery:模块:imageblock”

=Image Block模块=
使得区块可用做外观主题显示随机/最近/访问量最高的图片或相册。

==描述==
显示随机的图片或访问量最高的图片的突出，或从一堆其他图片区块类型中进行选择来在某特定相册或所有Gallery页面上显示。或者使用外部图片区块来在其他网站上显示这些图片。

==特点==
* 选择不同类型的图片区块（image block）：随机图片，最近访问的图片，访问量最高的图片，随机相册高亮，最近访问的相册高亮，访问量最高的相册，每日图片（每日改变一次），每周图片（每周改变一次），每月图片（每月改变一次），每日相册高亮，每周相册高亮以及每月相册高亮
* 添加多个图片区块
* 为每个图片区块设置是否显示标题，日期，访问计数器
* 另外，如果在外观主题模板（theme.tpl，album.tpl，photo.tpl）中手动添加了区块或者你使用外部图片区块的话，就可以选择显示某个itemID所定义的特定项目
* 使用'''外部图片区块（external imageblock）'''在其他网站或你网站的其他页面上显示Gallery（随机）图片
* 限制给定id相册下Gallery子树的项目选择（仅对模板中或外部图片区块中手动添加的图片区块可用）
* 为区块选择一个最大显示尺寸
* 显示全尺寸的图片

==用法==
* 如果需要的话在下载页面中下载此模块。G2的最小安装包及典型安装包中没有包括进此模块。
* 在''站点管理（site admin）'' -> ''模块（modules）''中安装并激活此模块。
* 在''站点管理（site admin）'' -> ''图片区块（Image Blocks）''中进行'''配置'''。
* 在''站点管理（site admin）'' -> ''外观主题（themes）'' -> ''matrix''（或其他某个激活或被使用的外观主题）的边栏中'''添加图片区块（Add image blocks）'''。
* 你可以单独地对每个图片区块进行配置：参见[[Gallery:How_To_Setup_Image_Blocks|如何安装图片区块（Image Blocks）]]
* 现在你以及站点访问者就可以在所有相册或相片页面的边栏中看到'''图片区块（image blocks）'''了。

另见：
* [[Gallery:GalleryEmbed:getImageBlock|如何在嵌入的G2中使用图片区块或将其作为外部图片区块的一个备用选择]]
* [[Gallery:How_To_Use_The_External_Image_Block_When_url_fopen_Is_Disabled|在url_fopen禁用的情况下如何使用外部图片区块]]
* [[Gallery:Themes:Reference:Blocks|如何在某个外观主题模板中手动添加一个图片区块（Image Block）]]

== 外部选项 ==
以下选项可用：
<pre>
blocks       竖直分隔线（|）分隔列表：
               randomImage, recentImage, viewedImage, randomAlbum, recentAlbum,
               viewedAlbum, dailyImage, weeklyImage, monthlyImage, dailyAlbum,
               weeklyAlbum, monthlyAlbum, specificItem; default is randomImage
show         竖直分隔线（|）分隔列表：
               title, date, views, owner, heading, fullSize, rawImage, none
itemId       限制给定id相册下Gallery子树的项目选择；
               或当使用specificItem区块类型时，对要显示的项目id进行限制
maxSize      将图片按比例扩大到最大尺寸。如果单独使用的话，Gallery将会定位尺寸设定最接近的
               图片为定义数值 – 更大的图片则会在你的浏览器中根据需要按比例缩小。
               如果与g2_show=fullSize一起定义的话，那么全尺寸的图片将总是被使用并根据需要按比例缩小。
exactSize    除了不会替换小于所选尺寸的图片之外，它跟g2_maxSize几乎是一样的，
               因此你会获取最接近某特定尺寸的图片。注意如果更大的图片要在浏览器中按比例缩小的话，
               将会占用很多带宽。
link         Href为图片上的链接；无数值即为无链接；默认为链接到Gallery中的项目
linkTarget   添加一个链接目标（例如在新的浏览器窗口中打开链接）
</pre>


有必要对maxSize和exactSize参量做一个阐述：
* maxSize – 为外部图片区块定义maxSize参量试图智能化地确定尺寸最为合适的图片以填充区块。此特点的加入将帮助用户及管理者有效地降低带宽消耗，并返回与所请求尺寸''相近''的图片。之前（而目前已此方式定义时），maxSize的唯一用处就是与fullSize视图选项一起使用。返回了庞大尺寸的图片，但按maxSize所定义的尺寸被浏览器缩小了。现在maxSize参量可以单独使用了，无需再跟fullSize视图选项一起使用。
<pre>
示例图片：
    100px 缩略图
    500px 重设尺寸的图片
    1024px 原始尺寸的图片

maxSize参量：
    maxSize=299 返回100px的缩略图，因为这是与
       所请求的maxSize"最接近"的尺寸。（约199px，然而
       500px的图片约为201px）

    maxSize=300 返回500px的重设尺寸图片，因为在这种情况下，
       一个图片具有两种尺寸，而这两种尺寸都同等接近时
       （都约为200px），那么其中稍大的尺寸将应质量需要被选中并返回

    maxSize=800 返回1024px的原始尺寸图片
</pre>

* exactSize – 正如maxSize，但除此之外返回的图片会被保证由下一较大尺寸进行向下采样。这意味着你永远不会得到比所定义尺寸稍小的图片，不过定义的尺寸大于原始尺寸图片的情况除外。
<pre>
示例图片：
    100px 缩略图
    500px 重设尺寸的图片
    1024px 原始尺寸的图片

exactSize参量：
    exactSize=299 返回500px的重设尺寸图片，因为这是
       最接近的稍大尺寸图片。

    exactSize=500 返回500px 的重设尺寸图片，因为这是
       最符合的。

    exactSize=800 （或更大）返回1024px的原始尺寸图片
</pre>



注：在此模块最新版之前的版本中，"exactSize"参量是不存在的而"maxSize"参量的功能不是如上所述。

我并不确定，但我认为以上的资料适用于1.0.11版（与Gallery 2.2 RC1兼容）而不适用于Gallery2.1.2所带模块的版本。

== 举例 ==
按水平方向显示图片。添加：
     .one-image {
          display: inline;
     }
到正在使用的外观主题的css。

----
在模板中以4x4格显示最近访问的图片，图片最大尺寸设定为50：
   {literal}
   <style>
   .one-image {
      display: inline;
   }
   .g2imageblock {
      width: 106px;
   }
   </style>
   {/literal}
<pre>
   &lt;div class="g2imageblock"&gt;
   {g->block type="imageblock.ImageBlock" blocks="recentImage|recentImage|recentImage|recentImage" maxSize=50}
   &lt;/div&gt;
</pre>

如果你使用更大的maxSize的话，就对.g2imageblock css的宽度进行调整。

----
==权限，授权以及密码加密的项目==
图片区块（image block）模块首先检查权限。这意味着用户拥有足够的权限才能浏览图片区块中的相册和图片。如果某相册使用[[Gallery:Modules:password|password]]模块进行了密码加密的话，相册内部的项目就不会显示在图片区块中（相册拥有者除外）。但相册本身还是会被显示在图片区块之中。直接受密码加密保护的图片或其它项目也会在图片区块中以缩略图的形式显示出来。如果用户浏览这些受密码保护的相册或项目之一时，就会被要求输入密码。
为了从图片区块中将密码保护的相册或项目完全排除，以下代码要加载文件gallery2/modules/imageblock/classes/ImageBlockHelper.class中此行语句之前。
 list ($ret, $owner) = GalleryCoreApi::loadEntitiesById($item->getOwnerId());

要添加的代码：
 //检查项目是否直接受密码保护。
 //如果是这样的话，不要将其显示在图片区块中，预览也不行：
 if( $item->hasOnLoadHandler('Password') ){
   continue;
 }

==被请求的特点==
目前尚无有关此模块的特点请求。

==Bugs==
目前尚无有关此模块的已知问题。

[[Category:Gallery 2:Modules]]