Discuz! 开发者教室之二【“页面嵌入” 模块具体写法[下]】

1，前言 % t0 t* f$ v5 e" Z6 Z
, i8 s  @* s+ b% M* ?
希望大家整理好每次的课堂笔记，建议把整理后的内容发到自己的Blog或者 帖子中，分享给更多的开发爱好者。 6 p) K; s  D) X8 S, N* ~
2，课前回顾 * D8 [7 u+ K7 M, ?
% Z( A0 _! c) i7 e- d
页面嵌入模块是 Discuz! 新增的 插件拓展模块，它可以让你插件直接显示在页面中的某位置，而无须再修改 模版。同时也可以做到在特定脚本执行特定 代码的作用。开发新内核插件，我们推荐您的每一个插件都在 plugins/ 目录下新建一个子目录，通常来说子目录名和插件的唯一标示符是一致的，插件的所有脚本包括模版都可以放在这个目录下（如：./plugins/ABC/ templates/……）。这样便于打包，也是诸多插件作者都喜欢做的。上节课，我们大致的介绍了讲解了一下新插件内核之“页面嵌入” 模块基础理论知识，这节课我们将进一步讲解新插件内核之“页面嵌入” 模块范例和技巧。 $ U: H3 ^  Y  p: |4 g8 B- B) p
/ C. R+ Q2 H$ g( G# G8 a6 C+ |
3，本节课内容摘要
! ?, q5 t& G6 T$ C+ ?
9 B+ o: c6 |% p4 n9 r7 S5 Y9 U课前，说一些关于 7.1 的事情,7.1 昨晚已经在官网公开测试，近期官方也将发布7.1测试版供大家 下载测试。发布之后，如果以前写过7.0NC的插件作者，希望你们好好在7.1里测试下，看看兼容性。 ! t* e+ `/ l2 V( A$ h: C

0 T, d4 W& v5 w我相信会有兼容问题,完全没有是不可能的。要让NC插件打上 for 7.1 最好好好测试下。 当然，在7.1发布后的一课，本教室将讲解 7.0 -> 7.1 的插件兼容课程， 讲解 7.0 -> 7.1 中插件开发中变动的内容。 因此，真有写过7.0插件的人，相信他们会爱听。当然，那个课程呢，希望有更多的人来听，我相信真正开发插件的作者还很多，不会就在坐的几个。那个课的课程时间发布后，也希望DPS配合宣传下，我相信要把插件拓展到7.1平台的所有插件作者都会喜欢那一课。那个课程具体时间现在没法决定，因为7.1测试版发布时间现在无法决定。 6 v. W2 F& i" ]% h+ Z$ A) Y2 V( M, e9 I
那么回到课程中来，说说上回的作业“猪头术” 大家说说自己有什么自己的方法。
1 \# e. x/ a: f7 g: r6 m
( l7 L0 t$ W! I" z. f$ N5 m讨论中。。。
8 T- U2 {1 R' l/ d8 D7 @: ]
( w$ h' f8 n, O5 m7 g, p% [2 M( Z上节课讲的方法里，有一种 _output 结尾的函数，谁说下？
3 `& }* m2 H  s( z' U , b! F4 J5 X3 h
。。。 ; r( m3 |7 q! g" j

" e0 y2 ]9 l+ Z! G; a" P5 ]这个结尾的函数有什么特点？
6 Y. B9 p( I; `/ f6 V   b2 U9 y( N. R& Z
_output 结尾的嵌入点函数是在代码已经执行完毕，变量都已赋值，只等输出的时候执行。那么这时候，我们可以做的事情很简单，去更改变量的值即可。
8 P. ^2 D% j  N1 A; e
! l. ~6 K1 C$ }7 B5 V/ |+ n那么~~~~ 对于 viewthread 头像的变量在哪里呢？

1. $postlist['avatar']

复制代码

嗯 就是它 对他进行循环，我们可以看到 $postlist 里面的数组里有 ['avatar']。 那么，我们 _output 函数就做一件事情——更改数组的这个变量即可实现改头像。当然猪头术就不必深入那么深了吧，给人家留一个源头像吧，否则 用户该抱怨 程序有bug了。
! A- M6 q; H/ m7 o& _6 R
) A2 c5 X' f  I, W& c) ]3 |* R以上，是新内核 _output 类嵌入函数的技巧之一，此技巧的要求你非常熟悉discuz里的变量，任何变量你都可以自己去替换，不用担心效率，$postlist  20个记录循环，for 20 的循环 不需要你担心效率。
8 o8 K5 M$ }1 H* G; K& z' P6 u   q0 B8 R: o6 O) |3 V1 `
问：如果要在 注册页面下面再加一个选项 怎么办？ 有嵌入点么？
0 P0 g# h% V5 F: i- _2 {. _, Y6 Z
" i- B" o) T: p猴：注册页面增加选项 那是自 定义个人资料的 功能。正好你说到这个，我可以举例子——如何巧妙的利用变量。刚才我说的方法是 替换，但有时你可以不替换，以下方法很阴：但很灵。 / N9 T+ U# w; ^
问：嗯 怎样做？
+ w  F8 g$ w3 R1 R' X) o猴：打开 login. htm

1. <input type="hidden" name="referer" value="$referer" />

复制代码

有这么一条
1 c( A9 H3 |8 R看似很普通 + w) o7 Q( H4 a( \; |7 \

6 ?$ c) E1 u- A  Z" M3 i5 h但如果

1. $referer .= '" />哈哈';

复制代码

会怎样

1. <input type="hidden" name="referer" value="" />哈哈" />

复制代码

这样 哈哈 就输出到页面中了
' N" D. `* I5 Q2 O  f ( B. S( P3 a0 A% j
问：那后面的/>怎么办
0 ^  Q1 @% G$ P$ H/ S. P猴：不哦那个担心 />

1. $referer .= '" />哈哈<x "';

复制代码

根据html自身的特点
! ?" W7 I: ^+ O/ _* e . l) ]" a0 P! E7 f
自定义标签是不显示的

1. <input type="hidden" name="referer" value="" />哈哈<x " />

复制代码

这样 哈哈2个字就完美了
4 ~2 {) l( @% A- s7 W& S   c2 S- j. s* q
页面中有更多类似这样的地方
, ~8 |, L# f+ p等待你去挖掘
0 ]( d' R0 m4 Z% ~- R8 V . p' O2 T3 v% u- ?
刚才说的几点都可以在   http://bbs.7dps.com/thread-773-1-1.html 这个帖子里找到范例  
' b8 L7 j. e, y7 V代码都输出了 你岂不是要输出什么都可以嘛
, [" p: i; A0 L9 b: x
; b/ ~+ m% d4 o) J2 w# n很多页面都可以
9 `- a; E6 g, R: N! n% } * r. ^1 t3 e' n9 Q+ F
forumdisplay viewthread 6 |* T- n" J( Q1 Q

& \7 z8 ]) D/ i! G) |' N多多挖掘类似的可用变量
; @7 ?- W- h- L" u
  N) i2 Q: i* w6 V: J8 k6 s问：除了 forumdisplay viewthread外.还有哪些呢? + @: U: U0 f9 J& x# `; r
猴：看你插件需求了，类似可以附加方式输出自己内容的地方很多，这是一个技巧，具体要看自己动脑筋。当然，只限做合法的事情哦。类似的地方再举例： 8 e! J9 W, d* e5 A) z& s
更改个人资料页有一个

1. var allowsigimgcode = parseInt('$allowsigimgcode');
   
2. 
   
3. $allowsigimgcode = "');alert(1);('";

复制代码

就可以加入自己的脚本
4 W$ m# x+ Y  j. Z! O, D% Q 4 D- t1 e+ D  [. Z3 X0 e
对于有嵌入点的地方
9 R7 J! X% \, H' x2 k当然很省事 ; ?6 ~% s) |0 j0 l$ b9 r
% W" r' P: ^3 D/ a/ d3 r& j7 p
上节课也说过了，viewthread_top_output() 函数的返回结果直接可在 viewthread_top 嵌入点输出内容，只要注意返回值类型 是 字串函数数组，是数组的一定要输出数组。
, A+ T# m7 o0 X
* `  v5 ?% q- H& h: n3 C: S问：如果为空 也要返回空数组吧 7 o1 E( K/ [4 \6 r  ]* h7 B
猴：是。我继续说，下面的内容有部分涉及7.1新增内容
9 v4 [, i! {" {( b& y1 Y
; b5 G7 q( y$ |9 v. n+ J9 F* E0 J猴问：嵌入点函数中如何调用模版？ 4 ]" t- G; ^$ \8 B: y
答：block。 2 x; ]0 w+ [5 t% s0 h
9 B+ z& K- R5 {; L% j) V; z* }5 a
由于嵌入点函数都是返回值
9 w1 I$ s2 k: h* l) D/ r0 I1 L  h所以嵌入点函数专用的模版必须要用 模版的 {block}

1. <!--{block return}-->
   
2. 
   
3. <!--{/block}-->

复制代码

所有内容都要写在这里
$ Q7 r# X8 }" l1 rblock的含义很容易理解
9 h, E$ d) d. h0 n* H. g" |$return = '.................';就是这个含义 ; d, I4 }2 u: {- |
{block} 里面的所有模版内容都会赋值给变量 $return ' W6 i2 B' Y: C; ]  Y* p
3 e1 E5 t' R" Y+ y, e4 J
在脚本中， include template('jscss', 'ifsbookmark', './plugins/ifsbookmark/templates');也用这种方式 调用即可，也许你会说，这么写太长了，放心在未来的 discuz 7.1 测试包里，你可以写成include template('ifsbookmark:jscss');因此~~~plugins/xxxxx/templates 这个目录 已经正式成为插件的标准模版目录。 1 J- K+ {+ c( c9 F3 M, p! j
8 ^: G: B+ r) a. `
问：include plugintemplate('jscss');这样行不行   p% U+ ?  B+ s# |6 v! l  z( [
猴：plugintemplate 只有是plugin. php 用的。虽然含义和template('ifsbookmark:jscss'); 基本一致。但只有是plugin.php 才能用的。
) r: h+ k3 ~; Z8 x2 _2 J
* C$ n; f: ^$ ?问：老师.问个问题..ifsbookmark.这是做什么的呢?
1 y* n0 p7 p8 u猴：ifsbookmark 是他插件的标示符，唯一标示符。
3 D& `$ R$ H8 K% s) x. ]4 u
' E$ m! Q; E7 Z4 |) Q推荐新核心插件的模版都在 /plugins/xxxx/templates 目录下
& a# y7 S+ x- L0 w
& p( S' y5 P, T! X- ~8 _脚本中 include template('ifsbookmark:jscss'); 可以用。同样，在模版的语法中 {template ifsbookmark:jscss} 一样可用，这是7.1里支持的写法。
. @/ @, Z' c! K1 R! b: h问：7.0 NC 不行? ) a7 S0 c  x9 a
猴：嗯 不行。 ; q3 \( `3 q2 }( M

4 O; e2 |8 Z' e* e# a- S- v" c% Zshow message
; D6 j* X+ s6 i! X showmessage 在新核心里 也是支持 这种冒号格式的showmessage('xxx:yyy'); - i' ^& h' d. f: T# M

; Q: n3 q4 c% @9 s7 Exxx:yyy表示xxx 插件的yyy语言
: R3 E) d, W. _2 D7 H9 ^  s, B' T8 N
+ s+ X. s; ^4 X% c( j对于 7.1 后台的showmessage函数，cpmsg('xxx:yyy'); 也支持这种语法，方便大家书写后台插件。
. y, u3 v- O( ^ : [6 F9 h6 U1 S0 B
语言包 模版 在7.1 都转正了，插件 真正成为一个软件一样 - A4 Q) }" S/ J6 `" `
' \4 `5 U* G; ~! o+ E! \
问：转正 是什么意思? 改了? - D# n# }5 a: p5 \/ U0 \, [" p; Q

& }) w1 _. j3 k, Q+ e. Y: g7 ~猴：以前你插件模版都是往templates/ default 里复制，导致里面有一堆插件的模版，现在可以放到插件目录了，以前语言包使用方法千奇百怪 甚至有的插件只支持gbk，现在也自由了。 9 S8 V3 G, G' }6 G7 ^
问：嗯 这样绿色 - I( x% U' x( o) ^
猴: 嗯.
1 O5 p  e7 a, M: N. H$ F5 { 6 E6 W% M3 t/ R! u* z8 `: p7 z
希望大家多熟悉下嵌入点
2 n6 u: a6 s8 O1 u" G& b, Z$ j) A $ X4 d9 M/ G. z2 Q$ H& [' e
7.1 增加了一些嵌入点,明显的是 post 页面的嵌入点。测试版发布后， 我会发布 hooksmodule 插件——嵌入点模型，方便大家熟悉所有的嵌入点。

1. class plugin_hooksmodule {
   
2. function plugin_hooksmodule() {
   
3. include_once DISCUZ_ROOT . './forumdata/cache/plugin_hooksmodule.php';
   
4. $this->vars = $_DPLUGIN['hooksmodule']['vars'];
   
5. }
   
6. 
   
7. function index_header() {return $this->vars['index_header'];}
   
8. function index_top() {return $this->vars['index_top'];}
   
9. function index_middle() {return $this->vars['index_middle'];}
   
10. function index_bottom() {return $this->vars['index_bottom'];}
    
11. 
    
12. function forumdisplay_header() {return $this->vars['forumdisplay_header'];}//此嵌入点体验包中不包含
    
13. function forumdisplay_top() {return $this->vars['forumdisplay_top'];}
    
14. function forumdisplay_middle() {return $this->vars['forumdisplay_middle'];}
    
15. function forumdisplay_thread() {return array($this->vars['forumdisplay_thread']);}
    
16. function forumdisplay_bottom() {return $this->vars['forumdisplay_bottom'];}
    
17. 
    
18. function memcp_side() {return $this->vars['memcp_side'];}
    
19. 
    
20. function profile_baseinfo_top() {return $this->vars['profile_baseinfo_top'];}
    
21. function profile_baseinfo_bottom() {return $this->vars['profile_baseinfo_bottom'];}
    
22. function profile_extrainfo() {return $this->vars['profile_extrainfo'];}
    
23. function profile_side_top() {return $this->vars['profile_side_top'];}
    
24. function profile_side_bottom() {return $this->vars['profile_side_bottom'];}
    
25. 
    
26. function viewthread_top() {return $this->vars['viewthread_top'];}
    
27. function viewthread_fastpost_side() {return $this->vars['viewthread_fastpost_side'];}
    
28. function viewthread_fastpost_content() {return $this->vars['viewthread_fastpost_content'];}
    
29. function viewthread_profileside() {return array($this->vars['viewthread_profileside']);}
    
30. function viewthread_imicons() {return array($this->vars['viewthread_imicons']);}
    
31. function viewthread_sidetop() {return array($this->vars['viewthread_sidetop']);}
    
32. function viewthread_sidebottom() {return array($this->vars['viewthread_sidebottom']);}
    
33. function viewthread_postheader() {return array($this->vars['viewthread_postheader']);}
    
34. function viewthread_posttop() {return array($this->vars['viewthread_posttop']);}
    
35. function viewthread_postbottom() {return array($this->vars['viewthread_postbottom']);}
    
36. function viewthread_postfooter() {return array($this->vars['viewthread_postfooter']);}
    
37. function viewthread_endline() {return array($this->vars['viewthread_endline']);}
    
38. function viewthread_middle() {return $this->vars['viewthread_middle'];}
    
39. function viewthread_bottom() {return $this->vars['viewthread_bottom'];}
    
40. 
    
41. function global_header() {return $this->vars['global_header'];}
    
42. function global_footer() {return $this->vars['global_footer'];}
    
43. function global_footerlink() {return $this->vars['global_footerlink'];}
    
44. 
    
45. }

复制代码

当然！！这个插件也涵盖了所有嵌入点函数名。 * ]; r8 U6 B3 B

8 g+ Y# W. M: @+ k一目了然
* |! [$ L$ Y$ l2 t: o0 E7 j 3 \3 @1 C3 [9 m5 Y: ^
虽然discuz的手册很少有人看，但还是要更新的。插件开发方法部分 在未来新的手册中更新了。
" w1 c7 x/ @  b* [$ [ ! d% B/ J( i/ c+ \+ M
基本内容到此！！
% r: b+ I4 K" O$ M5 B, e& a ( N' B& n, w2 L1 q4 [8 F, U
简单了解下 7.0 大家熟悉的函数
& L+ D7 ]2 w8 @, {- D : s8 E8 r: ]) R$ W: v; p
调查：ajaxmenu 函数何用 有谁知道
7 Q7 y& f, r; r7 g1 ?* h提醒是可以随意拓展的 动态也是 dz7.1增加了uch那样的动态 + C( V. J* I+ f8 i) y, G
扩展中心 不会公开说 毕竟不是所有开发者都有条件 + ]9 L2 |$ j" H( ]
7.1里 大家注意哦 7.1里理论取消了发送 系统消息的功能。因为系统消息已经变成提醒 虽然兼容 但是以前插件写的sendpm发送系统消息 都会 自动变成 提醒里的系统消息分类 sendpm还可应用啦 不会让sendpm发出空消息的 放心啦。