站长百科 | 数字化技能提升教程 数字化时代生存宝典
首页
数字化百科
电子书
▼
建站程序
开发
服务器
办公软件
开发教程
▼
服务器教程
软件使用教程
运营教程
热门电子书
▼
CSS教程
WordPress教程
导航
程序频道
推广频道
网赚频道
人物频道
网站程序
网页制作
云计算
服务器
CMS
论坛
网店
虚拟主机
cPanel
网址导航
WIKI使用导航
WIKI首页
热点词条
最新资讯
网站程序
站长人物
页面分类
使用帮助
编辑测试
创建条目
网站地图
站长百科导航
站长百科
主机侦探
IDCtalk云说
跨境电商导航
WordPress啦
站长专题
网站推广
网站程序
网站赚钱
虚拟主机
cPanel
网址导航专题
云计算
微博营销
虚拟主机管理系统
开放平台
WIKI程序与应用
美国十大主机
编辑“
Gallery:如何创建区块
”(章节)
人物百科
|
营销百科
|
网赚百科
|
站长工具
|
网站程序
|
域名主机
|
互联网公司
|
分类索引
跳转至:
导航
、
搜索
警告:
您没有登录。如果您做出任意编辑,您的IP地址将会公开可见。如果您
登录
或
创建
一个账户,您的编辑将归属于您的用户名,且将享受其他好处。
反垃圾检查。
不要
加入这个!
= 区块的新建 = 模块提供的区块可以被放置在Gallery布局的任意位置。想想[http://en.wikipedia.org/wiki/Lego 乐高(Lego)]砖吧,通过任意布置区块,你可以创建自己的布局样式。 请参看[[Gallery:Themes:Reference:Blocks|外观主题中的区块]],以获取现有的所有区块列表。. * 最小化,模块区块由modules/'''moduleid'''/templates/blocks/'''blocks.inc'''中的入口点和'''modules/moduleid/templates/blocks/'''上的对应模板文件所构成。 * CSS链接,JavaScript源码及任何HTML <head>内容都可以使用'''Preloads'''进行添加。 * 一些标准数据(默认项目,用户)已加载并随时可通过模板变量进行访问。参见:[[Gallery:Themes:Reference:Variables|模板变量]] * 数据可通过'''[[Gallery:Themes:Reference:Callbacks#新Callback的创建|Callbacks]]'''载入。 * 区块可被参量化,区块可为某特定项目进行显示。itemId可作为参量传输。 * 推荐从现有区块开始进行学习。可在modules/*/templates/blocks/,modules/*/Preloads.inc和modules/*/Callbacks.inc中找例子。 == 最小化区块示例== 在'''测试'''模块中创建一个名为'''Example'''的区块: * 使用如下内容在''modules/test/templates/blocks/blocks.inc''中创建一个'''blocks.inc'''文件: <pre> <?php $blocks = array( 'Example' => array( 'description' => $gallery->i18n('Example block'))); ?> </pre> * 使用如下内容在''modules/test/templates/blocks/Example.tpl''(文件名必须为'blockname.tpl')中创建一个'''区块模板''': <div class="{$class}"> <pre> {if $user.isRegisteredUser} {g->text text="Hello %s" arg1=$user.userName} {else} {g->text text="Welcome! Login to see more photos!"} {/if} </pre> </div> == 区块参量示例 == * 见'''[[Gallery:Themes:Reference:Blocks#区块参量|区块参量相关]]''' === Blocks.inc === 区块参量需要在blocks.inc文件中指定: <pre> <?php $blocks = array( 'Example' => array( 'description' => $gallery->i18n('Example block'), 'vars' => array( 'someNumber' => array( 'description' => $gallery->i18n('介于1和5之间的一个数字'), 'type' => 'choice', 'default' => '5', 'choices' => array( '1' => 1, '2' => 2, '3' => 3, '4' => 4, '5' => 5)), 'textToShow' => array( 'description' => $gallery->i18n('要显示的文本'), 'type' => 'text', 'default' => ''), ))); ?> </pre> === 区块模板 === * 区块参量可用在模板中。 * 应为各参量分派默认值。 * $item是一很常见的区块参量,一般默认为$theme.item。你无需在blocks.inc中将此参量列出。 <pre> {assign var=someNumber value=$someNumber|default:5} {if empty($item)} {assign var=item value=$theme.item} {/if} {capture assign="defaultMessage"}{g->text text="This is an example block"}{/capture} {assign var=textToShow value=$textToShow|default:$defaultMessage} <div class="{$class}"> <p>{$textToShow}</p> <p>{g->text text="You chose number %s!" arg1=$someNumber} {if $item.canContainChildren} {g->text text="This is an album!"} {/if} </div> </pre> == 预加载(Preload)== * 如果你的区块依靠CSS文件或想在HTML <head>部分包括进Javascript文件而不是在区块中的话,可以使用区块预加载。 * preload的命名惯例很严格,,而入某区块是某外观主题区块列表一部分的话,preload就会自动被呼叫。 * 如果你是手动包括区块的话(使用{g->block ...}),那么preload就不会被呼叫。你还需要手动包括CSS/JavaScript。 要为'''测试'''模块的'''Example'''区块创建preload的话,使用如下内容在''modules/test/Preloads.inc''中创建一个Preloads.inc文件: <pre> <?php class TestPreloads { function preload(&$template, $preload, $paramSet) { static $loaded; if (!empty($loaded[$preload])) { return null; } $loaded[$preload] = 1; switch($preload) { case 'Example': /* To include a CSS file... */ $template->style('modules/test/MyCssFile.css'); /* To include a JavaScript file... */ $template->javascript('modules/test/MyJavaScriptFile.js'); return null; case 'ExampleTwo': // Put here the preloads for another block of your module } return GalleryCoreApi::error(ERROR_BAD_PARAMETER); } } ?> </pre> '''注:''' * 类别名称必须符合模块id.的格式,"${moduleid}Preloads" * 在preload文件的分支语句中列出所有模块的区块。 == 参量和callback示例 == * 有关callback的资料,请见'''[[Gallery:Themes:Reference:Callbacks#新Callback的创建|Callbacks]]'''。 * 针对参量,我们使用前面例子中相同的blocks.inc。 === 区块模板 === <pre> {assign var=someNumber value=$someNumber|default:5} {if empty($item)} {assign var=item value=$theme.item} {/if} {capture assign="defaultMessage"}{g->text text="This is an example block"}{/capture} {assign var=textToShow value=$textToShow|default:$defaultMessage} {* Load some data *} {g->callback type="test.LoadItemData" itemId=$item.id myLimit=$someNumber} {if !empty($block.test.LoadItemData)} <div class="{$class}"> <p>{$textToShow}</p> <ul> {foreach from=$block.test.LoadItemData.items item=photo} <li>{g->text text="Photo name:"}{$photo.title}, {g->text text="Owner: %s" arg1=$photo.owner}</li> {/foreach} </ul> </div> {/if} </pre> 注: * 在此例中,我们假设''测试''模块具有一名为''LoadItemData''的callback,它会读取项目及相关数据(所有者名称)。如$itemId为某相册的id,它就能读至该相册的$someNumber子项目。它还能过滤子项目而仅返回图片(而不包括视频,mp3或其他媒体)。 [[Category:Gallery 2:Development]]
摘要:
请注意,您对站长百科的所有贡献都可能被其他贡献者编辑,修改或删除。如果您不希望您的文字被任意修改和再散布,请不要提交。
您同时也要向我们保证您所提交的内容是您自己所作,或得自一个不受版权保护或相似自由的来源(参阅
Wordpress-mediawiki:版权
的细节)。
未经许可,请勿提交受版权保护的作品!
取消
编辑帮助
(在新窗口中打开)