如何让Wordpress模板支持Sidebar Widgets(侧边栏插件) | Digg...

昨天研究了一下Wordpress的模板修改,主要是为了给一个不支持自定义侧边栏的三栏模板加入这个简单方便的功能.其实我是一个PHP文盲,对Wordpress模板的修改也并没有深刻的了解,下面是作为一个门外汉研究心得,只讨论实现方法,并不深究原因,没有多大的技术含量,希望高手不要见笑.

一.有关侧边栏的两个重要文件

侧边栏所涉及到的主要集中在这两个文件上,我的理解是,sidebar.php负责侧边栏的显示内容,fuctions.php在这里则负责侧边栏如何显示.一个不支持侧边栏插件的模板没有functions.php这个文件,sidebar.php中也没有调用语句.

二.Functions.php文件修改.

为了让模板支持侧边栏插件,首先需要新建一个functions.php文件,然后添加一些代码.我参考了一些文章和许多模板代码之后,发现三栏和两栏的fuctions.php代码在细节上有些区别,为了更加清除地说明,下面分两种情况讨论(我靠,怎么像做数学啊):

1.两栏模板(侧栏只有一列)

view plaincopy to clipboardprint

1. < ?php if ( function_exists('register_sidebar') ) register_sidebar(array( 'before_widget' => ‘   
2. <ul>   
3. <li>‘, // #1   
4. ‘after_widget’ => ‘</li>   
5. </ul>   
6. ‘, // #2   
7. ‘before_title’ => ‘   
8. <h2>‘, // #3   
9. ‘after_title’ => ‘</h2>   
10. ‘, // #4   
11. ));   
12. ?>   

 

 其中#1和#2是定义Widget内容前后标识符的语句,#3和#4是定义Widget标题的标识符的语句.根据模板的具体情况而定,你可以参考sidebar.php中已经定义过的侧边栏来决定应该采用哪种标识符.比如我修改的那个模板的sidebar.php中:

view plaincopy to clipboardprint

1. <div id="sidebar_r">//右栏模块   
2. <ul>   
3. <li>//Widgets前标识   
4. <h2>< ?php _e('Archives'); ?></h2>   
5. //Widgets标题   
6. <div style="margin-left: 2em">< ?php wp_get_archives('type=monthly'); ?></div>   
7. </li>   
8. <li style="list-style: none">   
9. // widgets后标识   
10. ……   
11. </li>   
12. </ul>   
13. </div>   

 

所以我应该在#1和#2语句中的’ ‘内填入分别填入<li>和</li>,#3和#4语句中的’ ‘内填入<h2>和</h2>.

2.三栏模板(侧栏有两列)

通常情况下,三栏模板的functions.php可以按照如下代码定义:

view plaincopy to clipboardprint

1. < ?php if ( function_exists('register_sidebar') ) register_sidebar(array( 'name' => ‘Left Sidebar’, //#5   
2. ‘before_widget’ => ‘   
3. <ul>   
4. <li>‘,   
5. ‘after_widget’ => ‘</li>   
6. </ul>   
7. ‘,   
8. ‘before_title’ => ‘   
9. <h2>‘,   
10. ‘after_title’ => ‘</h2>   
11. ‘,   
12. ));   
13. if ( function_exists(’register_sidebar’) )   
14. register_sidebar(array(   
15. ‘name’ => ‘Right Sidebar’, //#6   
16. ‘before_widget’ => ‘   
17. <ul>   
18. <li>‘,   
19. ‘after_widget’ => ‘</li>   
20. </ul>   
21. ‘,   
22. ‘before_title’ => ‘   
23. <h2>‘,   
24. ‘after_title’ => ‘</h2>   
25. ‘,   
26. ));   
27. ?>   

 

不要看代码很长,其实还是很简单.因为侧栏有两列,所以代码自然比单列的两栏模板多出一段,而且几乎一样.区别只在#5和#6两处的name,所谓name就是给widget指定各自的名称,以便在sidebar.php中分别调用.所以你只需要给这两个widget取两个自己认得的名字就好了.

三.Sidebar.php文件的修改.

functions.php改好之后,sidebar.php就非常之简单了.我们只需在合适的地方加上下面这段代码:

view plaincopy to clipboardprint

1. < ?php if ( function_exists('dynamic_sidebar') && dynamic_sidebar('#7') ) : else : ?>   
2. < ?php endif; ?>   

其中#7为widgets的名称,对应name属性的值(#5和#6).

 

以我的右栏为例:

view plaincopy to clipboardprint

1. <div id="sidebar_r">//右栏模块   
2. <ul>   
3. <li style="list-style: none">#8</li>   
4. <li>//Widgets前标识   
5. <h2>< ?php _e('Archives'); ?></h2>   
6. //Widgets标题   
7. <div style="margin-left: 2em">< ?php wp_get_archives('type=monthly'); ?></div>   
8. </li>   
9. <li style="list-style: none">   
10. // widgets后标识   
11. ……(更多模板默认的widgets)   
12. #9   
13. </li>   
14. </ul>   
15. </div>   

 

如果你想保留默认的sidebar定义,在#8处加上上述代码的第一行,在#9处添加第二行即可.如果你不再需要默认的sidebar定义,可以将他们全部删除,直接加上上面的代码(推荐).

两栏模板只需添加一次,三栏模板需要给左右两列各添加一次,当然要对应functions.php中各自的name.

四.总结

1.模板不同,代码会有差别,请根据模板的情况决定代码.

2.上面这些我试验过多次,证明是可行的而且也是简单的,如果有什么错误的地方,请在留言中指出,谢谢. 

3.参考:Crystown的WordPress Widget研究(一)