Yskin's Blog

2006年7月低，K2 r16版里加入了SBM，从此以后，K2模版用户可以很方便地控制自己的sidebar，而不用再辛苦地修改sidebar.php文件了。

一直没研究SBM，这两天抽空研究了一下，发现还是蛮好玩的。

Sidebar Modules，简称SBM。从名字里就可以看出，这是一个sidebar控制插件，可以在后台很方便地控制sidebar的显示内容以及显示顺序。SBM比WordPress官方提供的WordPress Widgets更好一些，同时也兼容WordPress Widgets插件的API，支持为它所写的"Widget"。K2内置了SBM插件，因为SBM的作者也在K2开发组里。所以，所有K2模板的用户就不用再很辛苦地安装SBM插件了，只要在K2后台的SBM设置页面添加了模块，K2自身的sidebar.php文件即被自动禁用，sidebar转由SBM控制，非常方便。

由于K2已经集成了SBM，所以SBM的安装过程我也就没研究。进入后台->外观->K2 SBM页面，即可看到漂亮的，大量运用AJAX的SBM设置页面。输入要添加的模块名称，选择模块类型以及要添加的列表，点添加。由于SBM使用了AJAX技术，模块会立刻出现在sidebar列表中。K2模版只有一个sidebar，所以只有一个sidebar1和一个禁用列表。三栏K2有两个sidebar，所以他有sidebar1，sidebar2和禁用列表三个列表，使用三栏K2时要注意选择列表啊。至于“禁用列表”的作用，那是为了临时禁用某个模块时临时停放模块的。因为模块如果被删除了，模块所有的配置信息都会丢失，所以如果只是临时禁用某个模块的话，把它拖到“禁用列表”就可以了。

添加完后模块就已经生效了，到Blog的sidebar就可以看到新添加的模块了。接下来还要对模块进行进一步配置。回到K2 SBM页面，点击模块名称，右边会出现模块的选项页。除了模块的类型禁止修改以外，其他的选项均可调整，比如模块的名称，名称是否显示，以及允许在哪些页面显示。你可以详细地设置此模块是否显示在首页、存档页、搜索页、404页、文章页和page页，甚至可以设置模块只显示在某几篇文章或是某几个页面里。

选项页里还有一个少用的选项——“相关CSS”。如果模块需要一个CSS协同工作，可以在这里填入CSS文件地址，当模块启用时，SBM会在显示模块的页面里调用这个CSS。这个功能本身很少用到，不过我们可以利用他来实现只在某些页面调用CSS的功能。假如有比较少用的插件，只在几篇文章内用到了，可以添加一个空的模块，只在这几篇文章里输出插件的CSS，这样可以使得其他的页面显示得更快些。

选项页的下方是各个模块特有的选项，模块可以自行在这里添加一些需要的选项，用户可以自行设置。大多数模块是没有自带选项的，像搜索模块，关于模块都是没有的，而HTML模块和PHP模块就有自带选项，用户可以在这里设置想要插入的HTML和PHP代码。

K2自带了很多模块，下面一一说明：

About module

显示本页说明信息，比如首页显示K2里设置的About Me，存档页显示“这是×××存档页...”一类的。

Asides module

提供对Matt的那个Asides插件的支持。

Calendar module

WordPress自带的日历

Category list module

分类列表

Flickr module

flickr图片展示

HTML module

html模块，可以插入一段html代码

Latest posts module

最新文章模块

Links module

链接模块

Meta module

Meta模块

Month list module

按月存档

Navigation module

按名称翻译是“导航条模块”，不过他是为page页服务的。当一个page有子page的时候，在该page中会显示子page列表。

PHP module

PHP模块，可以插入一段PHP代码，记得要加<?php ... ?>哦。

Recent comments module

最新评论模块，可以显示10条最新评论，支持BLC。

Related posts module

相关文章模块，需要Related Posts插件。

RSS module

RSS模块，可以显示一个RSS feed中的文章。

Search module

搜索模块

Text module

插入一段纯文本。

对一些模块做了修改：按月存档没有显示每个月的文章数，分类列表没有树状排列，这两个都做了修正。另外我在以前做了对K2 menu的修改，把一部分page作为menu，另一部分显示在sidebar。现在开始用SBM了，就把代码移出来，修改了一下，成为一个模块。最新文章和最新评论都是通过修改插件，增加对SBM的支持来显示在sidebar的。其他部分可以通过HTML、PHP、Text三个模块很方便的添加。

Navigation module有一个小bug，已经报上去了，等待更新中。Update：K2 r263已经修正了这个bug。

今天更新了K2，r248解决了升级Prototype后SBM不能添加模块的问题，r262说解决了IE7下的问题。我一直只关心Blog在我的Firefox 1.5.0.6下的显示，偶尔，比如写插件的时候，在IE下测试效果，顺便会看一下整个Blog在IE下的显示，看是否有错误。听alonefly大大说，我的Blog在IE7下有问题，在safari也有显示问题。唉，浏览器多了，才会发现W3C的重要啊。

K2开发组最近也懒了，更新变得很少，很多bug都没有及时解决。而且，K2下的rolling archive, Live Comment, Live search都使用了AJAX，互相之间经常起一些莫名其妙的冲突。想来K2开发组也真是辛苦，要研究PHP、html、JavaScript，还要注意兼容各个浏览器，真是不容易啊。而且，这么辛苦写出来的K2，在以貌取“模版”的环境里，竟然比不上一些小模版，嘿嘿。这不，最近升级了一下Prototype，结果SBM出问题了，伤脑筋啊。最近一个星期，K2开发组好像又活过来了，正在抓紧升级K2，并开始写K2的Wiki。Google Code真是个好东西，K2现在有了Wiki页，用来做K2文档。还有了Download页面，用来做下载页。假如Google Code再包含WordPress项目所使用的Trac的代码管理功能，可以很方便地查看svn里各个版本的代码，并对不同版本进行比较。那就完美了啊。

我在Blog的footer里给K2添加了版本号，现在可以很方便地查看我的Blog的K2当前版本，而且点击它就可以进入K2的nightly下载页了。

顺便更新了True Blue。新版的True Blue 1.3.4_svn对于最新的K2 svn支持的很好，上面的trimer已经能正确显示了。嗯，steveo真是个勤奋的人啊。

Update：另外，其他插件也可以内置对SBM的支持，就像对WordPress Widgets的支持一样。插件只有使用SBM提供的API，向SBM注册即可。SBM之所以被设计出来，就是为了提供比WPW更多的功能。WPW里很多事情都更麻烦点，比如，每个widget必须被设计成一个独立的插件，必须安装好后在WordPress后台激活。还有，WPW不能控制每个widget的在哪些页面中显示，而SBM可以精确控制到在某个页面显示与否。另外，widget只能使用WordPress提供的选项设置保存功能，而SBM自己提供了这样的功能，并把设置内容和module的其他信息一起保存在wp-options表的一行里，这样，当module被删除的时候，信息也随之丢弃，不怕占用数据库。

作为用户，在选用侧边栏控制插件的时候应该首选SBM，毕竟基本上所有为WordPress Widgets设计的widget都可以直接运用于SBM中，而SBM提供了比WPW更强的功能。

而作为插件作者，在写插件的过程中，如果需要提供对侧边栏控制插件的支持，恐怕WPW和SBM都要考虑。正如SBM主页所说，设计SBM的module时可以直接使用WPW的API，但是如果想用SBM特有的功能还是只考虑SBM的好。我最近在更新Yskin's wp-statistics插件2.3版的时候，就考虑了半天选项的问题，使用SBM提供的选项保存功能比起用WordPress的要省点事啊。

WPW的网站上给出了一些API的说明，而一些具体的细节则直接要求插件开发者查看WPW源代码。SBM网站上则没给出任何文档。唉，有空我再来谢谢两个插件的API文档吧。