函数文档.docx
- 文档编号:3429448
- 上传时间:2022-11-23
- 格式:DOCX
- 页数:21
- 大小:25.42KB
函数文档.docx
《函数文档.docx》由会员分享,可在线阅读,更多相关《函数文档.docx(21页珍藏版)》请在冰豆网上搜索。
函数文档
v2.0.4函数文档
===============================================================================================
提示:
下列所有的assign都代表是传递给smarty的赋值标志且都是必须的
所有带有动态缓存的都代表可能局部数据不是很准确,最长缓存更新时间36000's(10个小时)若需要调整修改php188.config.php的缓存周期
做模板时出现空白时代表模板里参数写错了可以修改php188.config.php开启全局调试
define('DEBUG',false);改false为true
若如果不清楚返回值的,可以使用{$new_goods|@print_r}其中$new_goods是要查看的变量(smartyassign的值)!
切记:
所有参数均为小写
===============================================================================================================
Smarty函数文档清单
===============================================================================================================
building_link自定义构造连接(2.0.+调整废弃assign参数)2
get_goods获得商品数据2
get_brands提取品牌数据2
get_category_bind_brand获取指定分类所绑定的品牌数据addv2.0.43
get_category提取商品分类3
get_goods_category_parent提取某个商品分类的父级分类(顶上一级或最顶上的分类)addv2.0.45
get_one_category提取一个商品分类数据6
get_goods_tags获取商品标签6
get_goods_sales_rank获取销售排行(动态缓存)7
get_goods_cart获得购物车数据(实时)7
get_goods_sales_log获取某个商品的销售日志(动态缓存)7
get_goods_next_last获得某个指定商品的上一页下一页(动态缓存)7
get_rands_goods获得随机商品(直接查询数据库)8
get_my_visted_goods获得用户访问的商品日志addinv2.0.38
get_goods_relative_article获得某个商品的关联文章(采用动态缓存)addinv2.0.38
get_goods_relative_goods获得某个商品的关联商品addinv2.0.38
get_ads提取广告8
get_friend_link提取友情链接9
get_ads_by_tag根据商品分类ID或商品品牌ID获取广告数据9
get_article按照文章分类提取9
get_article_category得到文章的分类不包括帮助中心的分类v2.0.3中调整9
get_help_category获得帮助中心分类9
get_flash得幻灯片flash数据10
debug_info获取调试信息10
select_db查询数据库只支持查询10
get_order提取已发货的订单10
get_comment提取网站评论(动态缓存)10
get_specfication提取商品规格(具体使用在商品搜索处体现)11
get_search_keys获得搜索热门关键词(动态缓存)addinv2.0.311
get_login_member_info_for_smarty获取登陆后的会员信息addinv2.0.311
程序对应模板清单11
系统全局赋值变量12
building_link自定义构造连接(2.0.+调整废弃assign参数)
接受参数:
assign(必写)
model所属模型
action调用的action
http只接受true或false默认为truefalse为返回不带http的url
param传递的参数格式必须为:
type=new&limit=20中间用&连接然后用=连接
返回:
String
使用
结果:
//站点地址/goods/type/type-new-limit-20.html">更多 [不加http参数] 结果: get_goods获得商品数据 (此函数每个分类下提取的数据最大值为50条) 接受参数: goods_id商品ID号(选填)默认为空若传递了此参数下面的所有参数的控制将不起作用同时采用直接查询数据库的方 limit提取的条数若不写默认提取10条 assign->需要赋值的名字 type->提取的类型(可为空)可选参数: hot(热销),new(新品),recommend(推荐),com(精品),special特价商品默认为Allcate_id->商品分类ID可为空若组合使用则是提取这个分类下(包括子分类)指定的类型的数据 brand_id商品品牌ID(选填) cate_sign商品分类标志(选填) brand_sign品牌标志(选填) 返回: array 使用: 上面的参数可以组合使用 同上面get_brands类似 get_brands提取品牌数据 接受参数: assign(必写) brand_id品牌的ID号可以不写若不写返回所有brand数据 brand_sign品牌标志位 limit默认为0须要提取的条数 cate_id获取指定分类下的品牌若无数据返回空v2.0.4增加 返回: Array(二维数组) 类似: Array ( [0]=>Array ( [brand_id]=>1 [brand_name]=>摩托罗拉 [brand_short_desc]=>官方咨询电话: 4008105050 售后网点: [brand_content]=> [sort]=>0 [brand_url]=> [brand_logo]=> [create_time]=> [show_in_nav]=>0 [ads_space]=> [brand_sign]=> [template_file]=> [seo]=> [link]=> ) ) 使用: {get_brandsassign="one_brands_data"brand_id="{$id}"} {foreachfrom=$one_brands_dataitem='item'} *****代码 {/foreach} get_category_bind_brand获取指定分类所绑定的品牌数据addv2.0.4 接受参数: assign赋值(必填) cate_sign cate_id分类ID必填若不写返回array 返回array get_category提取商品分类 接受参数: assign(必写) cate_id(选填)->分类ID若传递则会把当前分类下的所有子分类提取出来 show_children_tag是否返回children为键值的数组默认为true若添加则返回的数据结构不同 level(选填)->处理等级默认为0传递数字返回控制的级数 check_children(选填)是否检查子分类默认为true(true,false)为可选参数 building_url(选填)是否生成url默认为true(true,false)为可选参 返回: array(数据较多,不清楚可以用{$aaa|@print_r})输出查看$aaa为要输出的变量名 使用: 若绑定了品牌会返回品牌的数组(参数: brands_bind_data) 返回结构类似: Array ( [0]=>Array ( [cate_name]=>数码影像 [view_category]=> [cate_sort]=>0 [cate_id]=>1 [level]=>1 [spacer]=>|- [brands_bind_data]=>Array ( [0]=>Array ( [brand_id]=>1 [brand_name]=>佳能 [brand_short_desc]=> [brand_content]=> [sort]=>0 [brand_url]=> [brand_logo]=> [create_time]=> [show_in_nav]=>0 [ads_space]=> [brand_sign]=> [template_file]=> [seo]=>a: 4: {s: 11: "brand_title";s: 4: "佳能";s: 10: "meta_title";s: 0: "";s: 14: "brand_keywords";s: 4: "佳能";s: 17: "brand_description";s: 4: "佳能";} [link]=> [brand_search_link]=> [brand_site_link]=> ) ) [childrens]=>Array ( [2]=>Array ( [cate_name]=>数码相机 [view_category]=> [cate_sort]=>0 [cate_id]=>2 [level]=>2 [spacer]=> |- [brands_bind_data]=>Array ( [0]=>Array ( [brand_id]=>2 [brand_name]=>尼康 [brand_short_desc]=> [brand_content]=> [sort]=>0 [brand_url]=> [brand_logo]=> [create_time]=> [show_in_nav]=>0 [ads_space]=> [brand_sign]=> [template_file]=> [seo]=>a: 4: {s: 11: "brand_title";s: 0: "";s: 10: "meta_title";s: 0: "";s: 14: "brand_keywords";s: 0: "";s: 17: "brand_description";s: 0: "";} [link]=> [brand_search_link]=> [brand_site_link]=> ) ) ) [5]=>Array ( [cate_name]=>镜头 [view_category]=> [cate_sort]=>0 [cate_id]=>5 [level]=>2 [spacer]=> |- [brands_bind_data]=>Array ( ) ) ) ) get_goods_category_parent提取某个商品分类的父级分类(顶上一级或最顶上的分类)addv2.0.4 接受参数: assign(必填) cate_id分类ID(必填)若不写直接退出 only_load_curent_son(提取指定分类里的子分类)默认为false此参数和building_tree组合使用 only_one_parent默认为flase在only_load_curent_son为false的情况下此参数为true时带树形结构否则获取当前分类下的所有分类不带结构 only_one_son默认为false提取子分类下的第一层分类(此参数仅在only_load_curent_son为true时起作用) building_tree(是否构造树-接受参数true,false)默认为false若为true时会构造树返回的结果不一样(若传递的参数不同,此参数可能不起作用) 返回: array 特别注意: 若传递的参数不同返回的数据结构有部分不相同only_one_parent和only_load_curent_son同时使用时返回的结构可能会不同 此函数和get_category函数有部分相同地方但是返回的结构不近相同 使用: {if$is_goods_category}/*若是分类*/http: //yousite.cm/? goods/category/id-3.html在此model里能找到此参数addv2.0.4 获得当前分类所在顶级分类下的所有分类 {get_goods_category_parentassign="php188_goods_category_main"building_tree='true'cate_id=$category_id} {assignvar='php188_goods_category'value=$php188_goods_category_main.childrens} {elseif$is_goods_detail}/*若是详情*/http: //yousite.cm/? goods/detail/id-11.html在此model里能找到此参数addv2.0.4 获得当前分类下所在父一级分类下的的所有子分类若是最顶级分类直接返回顶级分类下的所有分类 {get_goods_category_parentassign="php188_goods_category_main"only_one_parent='true'cate_id=$category_id} {assignvar="php188_goods_category"value=$php188_goods_category_main.childrens} {else} {get_categoryassign="php188_goods_category"check_children='true'cate_id=$category_id} {/if} get_one_category提取一个商品分类数据 接受参数: assign->需要赋值的名字 cate_id->分类ID可为空 cate_sign分类标志(可为空) 返回结构: Array ( [cate_id]=>1 [cate_name]=>数码影像 [parent_id]=>0 [cate_desc]=> [cate_extension]=> [cate_sort]=>0 [cate_outlink]=> [show_in_nav]=>1 [ads_space]=> [cate_brands]=>1,2,3,4,5,6 [cate_sign]=> [show_in_category]=>0 [seo]=>a: 4: {s: 10: "cate_title";s: 0: "";s: 10: "meta_title";s: 0: "";s: 13: "cate_keywords";s: 0: "";s: 16: "cate_description";s: 0: "";} [template_file]=> [view_category]=> [cate_more_link]=> ) get_goods_tags获取商品标签 接受参数: assign->必填 返回数据: array所有的标签参数 使用: {get_goods_tagsassign='test_assign'} {foreachfrom=$test_assignitem='test'} {/foreach} get_goods_sales_rank获取销售排行(动态缓存) 接收参数 assign->必填 limit(可选)提取条数默认10 cate_id(可选)分类ID必须是INT类型 brand_id(可选)品牌ID sort_item(可选)排序方式可选参数(buyer,money,id,)参数说明(需结合sort参数使用): buyer->按购买者总数排序,money按购买总价钱排序id按商品ID排序默认按购买量总数排序 brand_sign(可选)品牌标志位 cate_sign(可选)分类标志位 sort(可选)默认为desc可选参数(desc,asc)排序方式 返回数据: array 使用: {get_goods_sales_rankassign="sale_rank"limit=9cate_id='1'brand_id='4'sort_item='buyer'sort='asc'limit='5'} get_goods_cart获得购物车数据(实时) 接收参数: assign->必填 返回结果: 一个二维数组 (数组局部参数说明) list=>array(), total_goods_count=>1购买的商品总数 total_shop_price=>5400 total_goods_price一个商品的购买后的总金额 total_goods_price_fromat一个商品的购买后的总金额(格式化后的数据) get_goods_sales_log获取某个商品的销售日志(动态缓存) 接收参数: goods_id(必填) 商品ID号 limit提取条数 get_goods_next_last获得某个指定商品的上一页下一页(动态缓存) (由于采用动态随机缓存,频繁修改商品数据可能会导致数据显示不正常,清除缓存即可)缓存周期按系统默认缓存时间加随机时间操作1-1000之间若随机数为500时就自动删缓存 接受参数: assign(必填) id->商品ID号若为空或不是>0的INT数字返回array否则返回类似 返回数据: array array('next'=>array('name'=>'name','link'=>''),'last'=>array('name'=>'name','link'=>'')); 使用: {get_goods_next_lastid=$goods_idassign=page} get_rands_goods获得随机商品(直接查询数据库) 接收参数: assign标志位 goods_cate_id商品分类ID brand_id品牌ID号 limit默认为5条提取的条数 返回: array 使用: 同上面使用方式类似 get_all_goods_types获得商品搜索的类型最新热门等 接受参数: assign 返回 array get_my_visted_goods获得用户访问的商品日志addinv2.0.3 接收参数: assign必填 limit默认为5接收INT类型数据 goods_id商品ID可为空 返回: array get_goods_relative_article获得某个商品的关联文章(采用动态缓存)addinv2.0.3 接收参数: goods_id(商品ID) assign(smartyassign值) limit(默认10条) 返回: array get_goods_relative_goods获得某个商品的关联商品addinv2.0.3 接收参数: assign limit(默认5条)必须在商品详情页中使用 返回: array
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 函数 文档