2008年11月18日 (二) 13:47的最新版本

使用模板的可视化嵌入[ ]

介绍[ ]

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

网站设计规划[ ]

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

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

Gallery[ ]

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

阅读Gallery文档资料[ ]

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

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

创建本地模板[ ]

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

slider外观主题的问题[ ]

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

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。现在开始入眼了。

解决布局问题[ ]

还没有完全结束呢。首先我想做更多的细小视觉上的修改，但更重要的是，布局方面还存在bug。在IE中，目前的CSS无法正确运作，可以看出图片现在被缩略图条所覆盖，这无疑是由图片显示区下移50px所导致的。还有在我的页面向gallery外观主题页面转换时会看到导航条呈现出不佳的跳转现象。在我自己的页面中我需要利用一些CSS小技巧来避免此类事故的发生。我需要将这些变通手段用于theme.css文件上。

要修复IE中不当覆盖的问题，光是修改CSS还是不够的。slider外观主题广泛使用Javascript，针对其所在的JS我们还需解决另一问题。它会计算图片区域的尺寸，而我们将图片区域下移了50px，因此会导致计算上的误差。被修改的slider.js可在此进行查看。修改位于186行左右。我还做的修改是在右侧添加一个永久性的滚动条，这可以解决导航条跳转的问题。可能还有更好的解决办法，这里给出的仅仅是我的方法。

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);

这没效果。经修改的javascript没有被执行。我很快发现我还需要修改模板目录下的header.tpl。将其复制到本地dir并使其由本地dir载入slider.js。这是我的header.tpl。我还需要在theme.tpl中做另一小修改，因为其中有一行隐藏了滚动条，而我希望该滚动条可以遏制屏幕的跳转。但此方法的使用与否取决于你。我对相应语句做了批注：

{*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。

被修改的外观主题文件[ ]

这就完成了所有的修改。我还对gallery外观主题配置做了一些mirror方面的修改。我特别限制了非管理员用户查看图片时的最大可见尺寸。

所有我做修改的文件可以在此查看。修改常常都加上了批注，但也许你会做一些自己的修改。某些修改我可能也没有印象了，因为到实际完成已隔了很长一段时间。如果你有什么问题的话，请尽管发短消息给我。但请记住，此份资料并不一定完全适用于你的网站的修改，这仅仅是我对自己网站所作修改的一个记录。你肯定要对此文档做一些取舍和修改才能符合你的网站需要。而且我也可能使用了不妥的方法来处理问题。但对我来说，以上的这些都没问题。

额外的嵌入[ ]

除了修改外观主题，我还做了其他形式的嵌入。你可以从任何PHP文件内部呼叫gallery函数。这使得你可以在gallery之外做一些有趣的尝试。我的站点就含有一些类似的附加..

首页有两张随机图片。我使用2个gallery内的特殊相册来达到此目的，其中一个相册是我的，另一个则是我妻子的。我们都可以分别向gallery中放入图片，并让它们自动为此随机图片所利用。下面是代码。你可以将常规的php文件中的Include()修改为符合你所需的任何东西。

不要不做修改就使用此代码，因为这只是示例。红色部分是肯定要修改为正确的相册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();
?>

旅游（travel）页面在右侧有一列缩略图。这些是自动生成的！如果我添加一个travel相册，就会被自动显示在这里。我通过额外手法让其在我准备好时才可见。这里的所有相册是1个特定相册的子相册；这里指的特定相册允许我对其进行纵览以获取所有这些travel相关的gallery。

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

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

/*按项目id获取所有相册*/
list ($error,$albums) = GalleryCoreApi::fetchAlbumTree(69);
/* fetch all thumbnails for these albums */
if(!$error) {
  /*获取所有相册的相册信息*/
  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。代码：