2008年10月13日 (一) 11:15的版本

使用模板的可视化嵌入

介绍

我曾多次被问到我的网站的样子是如何实现的。Gallery在我的网站 http://underwa.ter.net中融合地很好，机关我所使用的外观主题自身无法适用于这样的整合方式。但是我喜欢这样的哇你管主题，因此我根据自己的需要做了修改。我认为如果你真的希望gallery成为自己网站规划中不可或缺的一部分的话，某些形式的修改总是必要的。下面我就分享一下我在整合时的一些心得。

网站设计规划

首先在开始之前应当做一个网站设计规划。要使用什么样的布局？网站的导航方式？使用什么样的色彩？我想要的是一个非常简单的设计样式，简洁明快，这样就不会喧宾夺主了。我选择使用顶部导航条，这将我的站点分成了一些主要部分：文件夹，旅游报告和新闻以及关于。在整合gallery之前应当做好此步。我认为你应当让gallery来融入到你的设计中而不是反过来让你的设计来适应gallery。

除了PHP部分和gallery之外，我使用Dreamweaver进行站点的组建。对我来说，Dreamweaver在设计开发中表现得很不错，尤其是在CSS处理方面极为优秀。Dreamweaver允许我创建模板的特定部分，如导航条，因此如果我做出一些修改那么整个站点的对应部分就会改变（除了gallery不受影响，我会对此做解释的）。就我个人而言，我尝试使用某些形式的软件来做此事，因为维护起来较容易许多。

Gallery

现在我有了自己的设计方案。我喜欢滑动式的外观主题，因此我希望将其作为图片显示的基本方案。当你在box外使用gallery时，它就会变成一个独立的网页，并且具有自己的外观效果。你可以选用某个外观主题和颜色包，但它看起来仍和原来一样。网站往往不是这个样子，因此我开始逛论坛来看看如何修改gallery以更好地融入整合到我自己的网站中。

阅读Gallery文档资料

Gallery有不少关于嵌入和整合的信息。这里给出我用过的一些链接：

由于我不在使用现有的CMS，因此我想我可以使用gallery整合的'编辑外观主题模板'这个方法。一般说来就是修改外观主题所提供的模板来符合你的设计意图。这使得gallery成为了最具吸引力的工具，它允许你从设计之中分离出各种功能。

创建本地模板

Gallery修改模板的方法很棒。打开'slider'外观主题目录，并在希望修改的文件所在目录创建一个'local'目录。我一开始是编辑theme.tpl的，因此我在'templates'目录中创建了一个'local'目录，并将'theme.tpl'复制到了该新建目录之中。现在我开始编辑此模板以使其具有一导航条。这就意味着要在模板顶部添加一些HTML代码。你可在此查看一下结果文件。查询标记有COR字串的评注。

滑动外观主题的问题

不巧的是，这样做看不到导航条！也许我该重新载入一下模板吧？因为这是编辑模板时常做的操作。打开站点管理（Site Admin）链接，维护（Maintenance），找到模板缓存清除链接。但还是没能解决我的问题。我检查了一下源代码，导航条确实存在于其中。但为何我看不到它呢？我更进一步查看了一下slider外观主题并且注意到它使用的是绝对定位。通常说来，它将图片覆盖于导航条之上，因此就看不到了。

滑动外观主题的修改

在此我是不会对CSS或HTML做讲解的，这些都可以在书本中学到。我发现必须修改css来解决此绝对定位问题。所以我在同目录下做了一个'local'目录并将theme.css复制其中。在css文件的顶部你可以看到问题所在。它将图片区定位在了评论的左顶角处。那么如果我对其做修改让顶部不为0而是50 px呢？好像有点效果。图片区被下移了50 px，接着导航条就能在顶部看到了。

水平导航条

在继续之前，我需要对导航条做个解释，因为某些人可能不了解。就我迄今所作操作得到的结果看来，导航条看起来不太美观。其实它根本不是一个水平的导航条，而是一个突兀的列表样式。我并不打算娓娓道来如何将竖直列表转为一个水平导航条。因为这可以在网上找到。它使用的是CSS，而我将其风格信息由站点CSS文件复制到外观主题CSS文件。你可以在此看一下结果theme.css。有了这个CSS文件，我的导航条就在顶部了，但gallery其余部分看起来还是如老版普通的silder外观主题一样。

调整色彩

接着我想到必须修改slider外观主题的色彩来配合我自己的色彩。这意味着要贼此修改CSS信息。我需要将所有'背景色'的元素修改为自己的背景色。这里是结果 theme.css文件。查看color #282828。现在开始入眼了。

解决布局问题

Things arent quite finished though. First of all I wanted to do some more minor visual changes, but more importantly, there are some layout bugs. In IE (what else is new) the current CSS is not working correctly as the image is now being overlapped by the thumbnail bar, no doubt caused by lowering the image display area 50 pixels. Im also seeing some ugly jumping of the navbar when switching from my own pages to the gallery theme pages. In my own pages I needed to do some CSS tricks to avoid that from happening. It's basically working around CSS implementation differences. I need to add these workarounds to the theme.css file.

To fix the overlapping layout in IE, it wasnt enough to change the CSS. The slider theme extensively uses Javascript, and it's in this JS that we have to fix another problem. It computes the size of the image area, and because we lowered the image area 50px, this computation is now wrong. The changed slider.js can be seen here. The changes are around line 186. I also made another minor change to add a permanent scrollbar on the right. This fixes the jumping navbar problem. There may be better fixes for this, but this is what I did.

if (!getstr && !document.slide) return;
var w = data_iw[image_index], h = data_ih[image_index],
aw = image_area.offsetWidth, ah = image_area.offsetHeight, a=0;
  ah = ah - 6;
  aw = aw - 6;
  if(app_is_ie) {
    ah = ah - 80;
  }
if (w > aw || h > ah) {
if ((a = h/w) < ah/aw) {
w = aw; h = Math.round(aw*a);

Argh, this didnt work. The changed javascript wasnt being executed. I quickly noticed that I also need to change header.tpl in the templates directory. Copy it to the local dir and make it load slider.js from the local dir. Here's my header.tpl. I also had to make another small change in theme.tpl, as it has a line to hide the scrollbar, and I wanted to force the scrollbar to avoid jumping of the screen. You can decide for yourself if you want or need this. I commented out the line:

{*body.gallery { overflow: hidden; }*}

额外的修改

我们还没有完成呢。我还想要更多的视觉效果修改。我会一一道来的。

首先我希望图片周围有边界。这可以通过CSS来达成。在theme.css 文件的顶部某处加入下面的语句。

div#image img {
  border: 3px solid #ffffff;
}

我希望gallery的明朝位于导航条的左侧。这就意味着要修改theme.tpl，也就是导航条添加之处。我加入了以下语句行。如果你是管理员的话，它还会添加一个下拉框。请别忘了清除模板缓存:)

{if !empty($theme.item.title)}
  {$theme.item.title|markup}
  {if $user.isRegisteredUser}
    {g->block type="core.ItemLinks"}
  {/if}
{/if}

修改了CSS文件中的一些字体属性。这并非很重要的。

我不想让普通读者看到维护菜单的扳手图标。所以我修改了slider.tpl，这样一来只有管理员可以看到。参见slider.tpl。

被修改的外观主题文件

That concludes all the changes. I also changed some minor things in the theme configuration inside gallery. Specifically, I limited the max size each image could be viewed at by non-administrators. Experiment with it.

All the files that I changed can be viewed here. Changes are usually commented, but you may want to do a diff between the original and my version. I may have also forgotten some changes, as Im doing a long time after the actual work. If you have any questions, feel free to send me a message. Remember though, this doc is not meant to fix your own site. It is merely a diary of how I changed my site. You'll almost certainly have to deviate from this document for your own site. And I may also not have chosen the right way to do things, I dont know. But it works for me, so im happy.

额外的嵌入

Besides changing the theme I also did some other forms of embedding. You can call gallery functions from within any PHP file which allows you to do interesting tricks outside of gallery itself. My site contains several such additions..

The homepage has two randomized images. I did that by making two special albums inside gallery, one for me, one for my wife. We can each drop images in that gallery and have them automatically be used for this random image. The code for it. Include() it in your regular php file, and change whatever you have to change to make it work for you.

不要不做修改就使用此代码，因为这只是示例。红色部分是肯定要修改为正确的相册ID的

<?php
require_once(dirname(__FILE__) . "/../gallery2/embed.php");
$ret = GalleryEmbed::init(array('embedUri' => '/gallery2','g2Uri' => '/gallery2/','fullInit' => true));
list ($ret, $imageBlockCor) = GalleryEmbed::getImageBlock(array('blocks' => 'randomImage', 'show' => 'none', 'itemId' => '120' ));
list ($ret, $imageBlockJulie) = GalleryEmbed::getImageBlock(array('blocks' => 'randomImage', 'show' => 'none', 'itemId' => '121' ));
$url = $_SERVER['REQUEST_URI'];
if(preg_match('/(<img.*\\>)/', $imageBlockCor, $matches)) {
  $cor = $matches[1];
}
if(preg_match('/(<img.*\\>)/', $imageBlockJulie, $matches)) {
  $julie = $matches[1];
}

echo "<a href=\"/gallery2/main.php?g2_view=core.ShowItem&g2_itemId=147\">$cor</a>\n"; echo "<a href=\"/gallery2/main.php?g2_view=core.ShowItem&g2_itemId=148\">$julie</a>\n";

GalleryEmbed::done();
?>

The travel page has a list of thumbnails on the right. These are auto-generated! If I add a travel album, it automatically gets displayed there. I do some extra tricks to allow me to only make it visible when im ready. All the albums here are children of 1 specific album, which allows me to traverse that album to fetch all these travel galleries.

不要不做修改就使用此代码，因为这只是示例。红色部分是肯定要修改为正确的相册ID和输出HTML的

<?php
require_once(dirname(__FILE__) . "/../gallery2/embed.php");
/* connect to embed library */
$ret = GalleryEmbed::init(array('embedUri' => '/gallery2/index.php','embedPath' => '/gallery2','relativeG2Path' => ,'fullInit' => true));

/* fetch all albums by item id */
list ($error,$albums) = GalleryCoreApi::fetchAlbumTree(69);
/* fetch all thumbnails for these albums */
if(!$error) {
  /* fetch album info for all albums */
  list ($error,$items) = GalleryCoreApi::loadEntitiesById(GalleryUtilities::arrayKeysRecursive($albums));
  if(!$error) {
    $urlGenerator =& $gallery->getUrlGenerator();
    foreach ($items as $item) {
      $title = $item->getTitle();
      $description = $item->getDescription();
      $keywords = $item->getKeywords();
      if(strstr($keywords, "visible")) {
        list($ret, $thumbnails) = GalleryCoreApi::fetchThumbnailsByItemIds(array($item->getid()));
        foreach($thumbnails as $thumbnail) {
          $thumbnailImg = $urlGenerator->generateUrl(array('view' => 'core.DownloadItem', 'href' => "/gallery2/main.php", 'itemId' => $thumbnail->getid()));
          $thumbnailUrl = $urlGenerator->generateUrl(array('view' => 'core.ShowItem', 'itemId' => $item->getid()));
        }
        echo "<div class=\"travelgalleriesgallery\">\n";
        echo "<p><a href=\"$thumbnailUrl\"><img src=\"$thumbnailImg\" /></a></p>\n";
        echo "<p>$title</p>\n";
        $description = unhtmlspecialchars($description);
        echo "<p>$description</p>\n";
        echo "</div> <!-- travelgalleriesgallery -->\n";
      }
    }
  }
}
function unhtmlspecialchars( $string )
{
  $string = str_replace ( '&', '&', $string );
  $string = str_replace ( ''', '\, $string );
  $string = str_replace ( '"', '"', $string );
  $string = str_replace ( '<', '<', $string );
  $string = str_replace ( '>', '>', $string );

  return $string;
}
?>

在文件夹区域中的下拉列表显示所有可查看的文件夹。这些同样都是一特定相册的子，这样我就可以进行traverse。代码：