现在的位置: 首页 > 互联网络 > WP相关 > 正文

WordPress中的其它函数集锦

2010-08-05 09:53 WP相关 ⁄ 共 12654字 ⁄ 字号 暂无评论
current_time <?php current_time($type, $gmt = 0); ?>
函数current_time(“mysql”, $gmt)返回格式为“年-月-日 时:分:秒”的时间。如果$gmt=1,返回的时间为GMT时间;如果$gmt=0,返回的时间为浏览器客户端本地时间(由WordPress选项 gmt_offset决定,在“常规”菜单下的“时区”选项中进行设置)。
date_i18n <?php date_i18n( $dateformatstring, $unixtimestamp, $gmt ) ?>
根据时间标记检索本地格式的日期。如果本地设置表明了本地月份和星期,那么本地时间即采用该日期格式。如果未标明本地月份和星期,使用日期格式字符串。i18n是国际化(Internationalization)的缩写形式。Internationalization的首字母“i”和尾字母 “n”之间有18个字母。
get_calendar <?php get_calendar( $initial ); ?>
输出日历。$initial 默认为true,显示星期的大写首字母,false时显示缩写。
get_date_from_gmt <?php get_date_from_gmt( $string ) ?>
将GMT格式的日期转换成符合当前博客时间格式的日期。返回的日期格式为 Y-m-d H:i:s(年-月-日 小时:分:秒)。该函数加上’gmt_offset’ 的选项值。
get_lastpostdate <?php get_lastpostdate( $timezone ) ?>
检索最后一篇日志的发表日期。默认值是服务器的时区,即GMT和服务器时间的差别。’blog’的值就是最后一篇日志的发表日期。’gmt’则是最后一篇日志发表时的GMT格式日期。
get_lastpostmodified <?php get_lastpostmodified( $timezone ) ?>
根据时区检索最后一篇日志的最后修改时间。默认值是服务器的时区,即GMT和服务器时间的差别。’blog’的值就是最后一篇日志的修改日期。’gmt’则是最后一篇日志修改时的GMT格式日期。
get_day_link <?php get_day_link( $year, $month, $day ); ?>
返回某日的归档链接。
get_gmt_from_date <?php get_gmt_from_date( $string ) ?>
返回GTM格式的时间,所返回格式为 Y-m-d H:i:s (年-月-日 小时:分:秒)。减去’gmt_offset’选项值。
get_month_link <?php get_month_link( $year, $month ); ?>
返回某月的归档链接。
get_the_time <?php get_the_time( $d, $post ); ?>
返回指定日志的日期。$d是日期格式,$post是文章ID。
get_weekstartend <?php get_weekstartend( $mysqlstring, $start_of_week ) ?>
从MySQL日期时间或日期字符串中获取一周的开始或结束时间。
get_year_link <?php get_year_link( $year ); ?>
获取某年的归档链接。
human_time_diff <?php human_time_diff( $from, $to ) ?>
判断两个时间标记的差异。以人类可阅读的格式,如“1小时”、“5分钟”、“两天”,返回时间标记的差异。
is_new_day <?php is_new_day(); ?>
该条件标签判断“今天”是不是新的一天。这是一个布尔型函数,如果是新的一天,返回TRUE,如果不是,返回FALSE。
iso8601_timezone_to_offset <?php iso8601_timezone_to_offset( $timezone ) ?>
根据ISO 8601日期表示法以秒数计算时区偏移量。
iso8601_to_datetime <?php iso8601_to_datetime( $date_string, $timezone ) ?>
将ISO8601格式的日期转换为post_date[_gmt]所用的MySQL日期格式
mysql2date <?php mysql2date($dateformatstring, $mysqlstring, $translate = true); ?>
将mysql格式的日期翻译成php函数date()可接收的格式。

is_serialized <?php is_serialized( $data ) ?>
检查值是否被序列化。如果$data不是字符串,返回的值将是错误的。序列化的数据都是字符串。
is_serialized_string <?php is_serialized_string( $data ) ?>
查看序列化的数据是否为字符串类型。
maybe_serialize <?php maybe_serialize( $data ); ?>
必要时序列化数据.
maybe_unserialize <?php maybe_unserialize( $original ) ?>
对数据进行反序列化(如果数据已经被序列化).

add_option <?php add_option($name, $value = ”, $deprecated = ”, $autoload = ‘yes’); ?>
这是一种向选项数据库表中添加有名称的选项/值对的安全方法。如果所需选项已存在,add_option()不添加内容。选项被保存后,可通过get_option()来访问选项,通过update_option()来修改选项,还可以通过delete_option()删除该选项。在INSERT语句前,add_option的值被$wpdb->escape 跳过。
delete_option <?php delete_option($name); ?>
这是一种从选项数据库表中删除某一有名称的选项/值对的安全方法。
form_option <?php form_option( $option ) ?>
过滤选项格式后重复选项值。
get_alloptions <?php get_alloptions() ?>
如果没有自动加载的选项,该函数检索所有可自动加载的选项或所有选项。该函数与wp_load_alloptions()的不同之处在于,该函数不缓存返回的结果,且每次调用该函数时,该函数都会从数据库中检索所有选项。
get_user_option <?php get_user_option( $option, $user, $check_blog_options ) ?>
检索用户选项,包括global、user或blog。如果未给出用户ID,使用当前用户ID。如果给出用户ID,检索该用户相关数据。函数结果的过滤器将原始选项名称和最终用户数据库对象作为第三个参数传递。该选项函数首先查找非全局名称,然后查找全局名称,如果仍然没有找到,函数会查找博客选项。可通过插件设置或修改选项。
get_option <?php echo get_option( $show, $default ); ?>
这是一种从选项数据库表中获取有名称的选项的值的安全方法。如果所需选项不存在,或选项无相关值,函数返回FALSE。
update_option <?php update_option( $option_name, $newvalue ); ?>
利用该函数在选项数据库表中更新一个有名称的选项/值对。在INSERT语句前,option_name的值被$wpdb->escape 跳过。该函数可取代add_option,但不及add_option灵活。update_option会检查并判断选项是否已经存在。如果不存在,用add_option (’option_name’, ‘option_value’)添加选项。除非用户需要指定add_option的选项参数,否则update_option()是一个可同时添加和更新选项的两用函数。注意:wp_load_alloptions将要加载(或不加载)某个选项时,update_option() 无法更新。在这种情况下,应在使用update_option()函数后使用delete_option。
update_user_option <?php update_user_option( $user_id, $option_name, $newvalue, $global ) ?>
利用全局博客权限更新用户选项。用户选项类似于用户元数据,唯一的不同之处在于用户选项支持全局博客选项。如果’global’参数为False(默认情况下),update_user_option会预先将WordPress表前缀改成选项名称。

xmlrpc_getpostcategory <?php xmlrpc_getpostcategory( $content ) ?>
从 XMLRPC XML中检索日志所属分类。若未找到分类元素,可用默认日志分类来代替。返回的类型可能是$post_default_category。若找到分类元素,则为数组。
xmlrpc_getposttitle <?php xmlrpc_getposttitle( $content ) ?>
从 XMLRPC XML中检索日志标题。如果标题元素不属于XML,可用$post_default_title中的默认日志标题代替。
xmlrpc_removepostdata <?php xmlrpc_removepostdata( $content ) ?>
不含有标题和分类元素的XMLRPC XML内容。
user_pass_ok <?php user_pass_ok( $user_login, $user_pass ) ?>
检查用户登录名称和密码是否正确。

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

__ <?php __( $text, $domain ) ?>
检索来自 translate()的被翻译过的字符串。
_e <?php _e( $text, $domain ) ?>
显示 translate()返回的被翻译过的内容。
__ngettext <?php __ngettext( $single, $plural, $number, $domain ) ?>
根据总数检查单复数形式。如果域名不在$110n列表中,会做出一个比较,返回$plural或$single参数。如果域名存在,$single、$plural与$number会首先被传递到域名的ngettext方法。之后域名与这些参数会被传递到 ‘ngettext’过滤器钩子中。预计返回类型是字符串。
_x <?php string   _x( $single, string $context, [string $domain  = 'default'], string $text); ?>
从获取的文本中返回翻译的字符串。
esc_attr__ <?php esc_attr__( $text, $domain = ‘default’ ) ?>
Retrieves the translation of $text and escapes it for safe use in an attribute. If there is no translation, or the domain isn’t loaded the original text is returned.
esc_attr_e <?php esc_attr_e( $text ) ?>
翻译,编码并响应。
get_locale <?php get_locale() ?>
获取当前的本地区域设置,如果本地区域已设定,该函数会过滤‘locale’过滤器中的区域设置并返回值。如果本地区域未设定且WPLANG常量已定义,可使用WPLANG常量。本地区域设置会被’locale’过滤过滤,返回本地全局设置以及区域设置的值。获取本地区域设置的过程只能一次性完成,但区域设置总由’locale’过滤器过滤。
load_default_textdomain <?php load_default_textdomain() ?>
加载默认、经过翻译的本地字符串。从WordPress根目录下的WP_LANG_DIR绝对路径中加载.mo文件。根据本地情况为翻译后的(.mo)文件命名。
load_plugin_textdomain <?php load_plugin_textdomain( $domain, $abs_rel_path, $plugin_rel_path ) ?>
加载翻译后的插件字符串。如果未给出路径,默认路径为插件根目录。.mo文件路径基于带有破折号的域名命名,域名后应跟有一个破折号,破折号后为本地路径。
load_textdomain <?php load_textdomain( $domain, $mofile ) ?>
将MO文件加载到域名列表中。如果域名已经存在,则加载失败。如果MO文件不可读,加载也以失败告终。加载成功后,MO文件会被$domain存储在全局变量$110n中,并成为gettext_reader的一个对象。
load_theme_textdomain <?php load_theme_textdomain( $domain, $path ) ?>
加载翻译后的主题字符串。如果本地主题根目录下有一个.mo文件,该文件会被包括在$domain的被翻译字符串中。.mo文件必须根据本地设置命名。

spawn_cron <?php spawn_cron( $local_time ) ?>
发送请求,在不停止页面加载的HTTP请求上执行定时事件。
wp_clear_scheduled_hook <?php wp_clear_scheduled_hook(‘my_schedule_hook’); ?>
清除某预订的定时事件的钩子(hook)。.
wp_cron <?php wp_cron() ?>
为所有预定事件运行预定回调或批量生产定时任务。
wp_get_schedule <?php wp_get_schedule( $hook, $args ) ?>
利用参数检索用于钩子(hook)的定时事件。
wp_get_schedules <?php wp_get_schedules() ?>
检索受支持和被过滤的定时任务的执行周期。有效周期值包括’hourly’和’daily’。可以用插件连接到’cron_schedules’过滤器。过滤器接收一个包含多个数组的数组。外部数组的键值是预定事件的周期,如’weekly’。函数的值是一个带有两个键值的数字,一个键值是’interval’,另一个则是 ‘display’。’internal’表示定时任务运行的周期,以秒数表示。因此’hourly(每小时)’的时间表示法是3600或60*60。而 ‘weekly(每周)’的时间表示法则是60*60*24*7 或604800,’interval’的值就是604800。
wp_next_scheduled <?php $timestamp = wp_next_scheduled( $hook, $args ); ?>
返回一个定时时间的下一个时间标记。
wp_reschedule_event <?php wp_reschedule_event( timestamp, recurrence, hook, args (optional));
WordPress内部使用该函数来重新安排某个已发生事件。用户可能永远都不需要手动使用这个函数。将函数列在这里是为了保证手册的完整性。
wp_schedule_event <?php wp_schedule_event(time(), ‘hourly’, ‘my_schedule_hook’); ?>
计划某个钩子(hook)的运行周期,用户指定时间周期后,WordPress动作(action)函数每一周期内执行一次该钩子。预定时间过去后,如果有人访问用户的WordPress网站,动作函数钩子会被触发。插件API中有一份钩子(hook)列表。
wp_schedule_single_event <?php wp_schedule_single_event(time(), ‘my_schedule_hook’); ?>
计划某个钩子(hook)的使用时间,用户指定时间后,WordPress动作(action)函数执行一次该钩子。预定时间过去后,如果有人访问用户的 WordPress网站,动作函数会停止运行。
wp_unschedule_event <?php wp_unschedule_event(next_scheduled_time, ‘my_schedule_hook’, original_args ); ?>
注销一个以前预约的定时事件。

add_query_arg <?php add_query_arg( $param1, $param2, $old_query_or_uri ) ?>
检索修改后的URL查询字符串。用户可利用该函数重建URL并为URL查询语句添加新的查询变量。还可以用查询数据检索完整URL。添加单键、单一值或一个关联数组。为空字符串设置键值可移除该键。用$_SERVER['REQUEST_URI']的值来忽略 ‘oldquery_or_uri’ 。该函数帮助性较强。利用该函数,在添加额外的GET变量时,用户不必担心是否需要将?符号或&符号加入到URL中。
bool_from_yn <?php bool_from_yn( $yn ) ?>
判断输入内容为“yes”或“No”。仅当为“y”时返回true。
cache_javascript_headers <?php cache_javascript_headers() ?>
设置页头,将有JavaScript类型的页头保存十天。
check_admin_referer <?php check_admin_referer( $action, $query_arg ) ?>
Tests if the current request was referred from an admin page, or (given $action  parameter) if the current request carries a valid nonce. Used to avoid security exploits.
check_ajax_referer <?php check_ajax_referer( $action, $query_arg, $die ) ?>
该函数可由插件代替。若插件无法重新定义函数,则使用该函数。该函数验证AJAX请求以阻止执行来自博客外部的请求。
do_robots <?php do_robots() ?>
显示robot.txt文件内容。回应的内容应该用于永久链接或用于创建robot.txt文件。
get_bloginfo <?php $bloginfo = get_bloginfo( $show ); ?>
该函数返回用户博客的相关信息,可将返回的信息用在PHP代码中。该函数与bloginfo()均可以显示博客相关信息。
get_num_queries <?php echo get_num_queries();?>
计划某个钩子(hook)的运行周期,用户指定时间周期后,WordPress动作(action)函数每一周期内执行一次该钩子。预定时间过去后,如果有人访问用户的WordPress网站,动作函数钩子会被触发。插件API中有一份钩子(hook)列表。
get_num_queries <?php echo get_num_queries();?>
检索执行WordPress时的数据库查询次数。
is_blog_installed <?php is_blog_installed() ?>
检查博客是否已经安装完毕。首先检查缓存。如果有保存了缓存值的缓存插件,这时缓存插件会开始运行。如果使用WordPress的默认缓存功能,数据库会无法作用,然后可能就会出错。检查网站地址选项,查看WordPress是否已经安装完毕。
is_ssl <?php is_ssl() ?>
检查ssl是否可用。
make_url_footnote <?php make_url_footnote( $content ) ?>
在已剥离文本最下方除去HTML 代码并添加链接。查找所有链接,除去链接中的文字,然后将链接以编号形式放置在文本最下方。
nocache_headers <?php nocache_headers() ?>
设置页头,使之阻止不同浏览器的缓存。不同浏览器支持不同的nocache页头,因此必须要发送多个页头才能保证所有浏览器都 不进行缓存。
remove_query_arg <?php remove_query_arg( $key, $query ) ?>
从查询字符串中删除某个条目或列表项。
status_header <?php status_header( $header ) ?>
设定HTTP状态页头。
wp <?php wp( $query_vars ) ?>
设置WordPress查询。
wp_check_filetype <?php wp_check_filetype( $filename, $mimes ) ?>
从文件名中检索文件类型。必要时用户可以选择定义MIME数组。
wp_clearcookie <?php wp_clearcookie() ?>
该函数可由插件代替。若插件无法重新定义函数,则使用该函数。该函数清除身份验证cookie,退出用户的登录状态。可用 wp_set_auth_cookie()函数代替该函数。(已弃用)
wp_create_nonce <?php $nonce= wp_create_nonce( $action ); ?>
生成一个随机的、一次性的令牌。
wp_die <?php wp_die( $message, $title, $args ) ?>
终断WordPress执行并显示错误HTML信息。一个该函数的调用与PHP函数 die()互为补充。区别在于,HTML是显示给用户看的。推荐仅在进程不能再继续时,再使用该函数。不推荐经常调用该函数,尽量低调处理各种错误。
wp_explain_nonce <?php wp_explain_nonce( $action ) ?>
检索随机数动作函数“Are you sure”信息。
该动作函数分裂为动词和名词。动作函数格式为verb(动词)-action(名词)_extra。破折号前是动作名称,动作名称均为字母,不包括空格和数字。破折号后、下划线(如果有下划线)前是名词,名词也由字母组成。
动作函数需要调用过滤器,而WordPress并未定义过滤器。用户可用插件的过滤器来解释访问者看到“Are you sure”时的随机数动作函数。过滤器格式为“explain_nonce_$verb-$noun”,用所找到的动词代替其中的$verb,所找到的名次代替其中的$noun。这两个参数来源于带有额外文本(动作函数下划线后的内容)的’Are you sure you want to do this?’信息。
wp_footer <?php wp_footer(); ?>
激活 ‘wp_foter’ 动作。
wp_get_cookie_login <?php wp_get_cookie_login() ?>
该函数可由插件代替。若插件无法重新定义函数,则使用该函数。该函数获取用户登录的cookie。用户不能继续在WordPress中使用该函数。也不可以用插件来代替该函数。(已弃用)
wp_get_http_headers <?php wp_get_http_headers( $url, $deprecated ) ?>
从URL中检索HTTP信息头
wp_get_original_referer <?php wp_get_original_referer() ?>
检索原始引用页(若引用页存在)。
wp_get_referer <?php wp_get_referer() ?>
分别从 ‘_wp_http_referer’、HTTP引用页或当前页面检索引用页。
wp_hash <?php wp_hash( $data, $scheme ) ?>
该函数可由插件代替。若插件无法重新定义函数,则使用该函数。该函数获取已知字符串的hash值。
wp_head <?php wp_head(); ?>
激活 ‘wp_head’ 动作。
wp_mail <?php wp_mail( $to, $subject, $message, $headers, $attachments ); ?>
发送一封邮件。
wp_mkdir_p <?php wp_mkdir_p( $target ) ?>
新建绝对路径的递归式文件夹。试图设置文件夹的访问权限。
wp_new_user_notification <?php wp_new_user_notification( $user_id, $plaintext_pass ) ?>
该函数通知博客管理者有新用户注册,通常通过E-mail通知。该函数可由插件代替。若插件无法重新定义函数,则使用该函数。
wp_nonce_ays <?php wp_nonce_ays( $action ) ?>
显示“Are You Sure”信息以使用户确认当前进行的操作。如果动作有随机数解释信息,解释信息会随“Are you suire?”信息一同展现。
wp_nonce_field <?php wp_nonce_field( $action, $name, $referer, $echo ) ?>
为输入框检索或显示随机数隐藏字段。
随机数字段用来验证输入框中、来自当前网站位置而非其他区域的内容。随机数不能提供完全绝对的安全保护,但可以有效阻止大多数不安全情况。
如果将$echo和$referer都设为true,需要检索wp_referer_field()。如果将$referer设为true且回应随机字段,那么它也会回应referer字段。
$action和$name参数都是可选的,但如果希望进一步提高安全措施,强烈推荐设置这两个参数。调用一个没有参数的 wp_nonce_field函数虽然方便(验证随机字段不要求参数的参与),但一旦黑客掌握了随机数的规律,很容易就可以找到方法破解随机验证,使网站安全受到威胁。
input名称即用户赋予$name的值。input的值则是随机数值。
wp_nonce_url <?php wp_nonce_url( $actionurl, $action ) ?>
检索在查询中添加了随机数的URL。
wp_notify_moderator <?php wp_notify_moderator( $comment_id ) ?>
该函数可由插件代替。若插件无法重新定义函数,则使用该函数。该函数通知博客审核者有新评论正等待审核。
wp_notify_postauthor <?php wp_notify_postauthor( $comment_id, $comment_type ) ?>
该函数可由插件代替。若插件无法重新定义函数,则使用该函数。该函数过滤用于重定向的URL。
wp_original_referer_field <?php wp_original_referer_field( $echo, $jump_back_to ) ?>
为表格检索或显示初始引用页隐藏字段。若字段已显示,则输入名称为’_wp_original_http_referer’且值与wp_referer_field() 相同,如果字段不存在,则输入名为当前页面。
wp_parse_args <?php $args = wp_parse_args( $args, $defaults ); ?>
wp_parse_args is a generic utility for merging together an array of arguments and an array of default values. It can also be given a URL query type string which will be converted into an array (i.e. “id=5&status=draft”).
wp_redirect <?php wp_redirect($location, $status); ?>
将用户重定向到一个预先制定的绝对URI。
wp_referer_field <?php wp_referer_field( $echo ) ?>
为表格检索或显示引用页隐藏字段。引用页链接即来自服务器超级全局变量的当前请求URI。如果希望手动检索,请使用输入名称’_wp_http_referer’。
wp_remote_fopen <?php $contents = wp_remote_fopen($uri); ?>
返回某个远程URI的内容。先尝试用fopen函数检索HTTP内容,若fopen无效则用cURL继续尝试。
wp_salt <?php wp_salt( $scheme ) ?>
该函数可由插件代替。若插件无法重新定义函数,则使用该函数。
该函数获取salt值并添加到哈希列表中,以预防攻击。
密钥位于两个位置:一是数据库(防止另一处没有定义密钥),二是wp-config.php文件。如果需要设置密钥,需要在wp- config.php文件中完成。
数据库中的密钥是随机生成的,有时会被赋值给wp-config.php文件中的密钥。记住,要在wp-config.php文件中定义或修改密钥。
如果你安装的是WordPress 2.5及更高版本,那么wp-config.php文件中已经定义了SECRET_KEY。但你需要更改它的值,因为黑客可能已经知道这个值。如果你从 WP 2.5之前的版本升级到WP 2.5或者更高版本,需要在wp-config.php中添加常量SECRET_KEY。
有一种解密工具中存储了常用字典字符串的哈希值,为密码添加salt值可以防止这种解密工具破解你的密码。如果添加的值强度够高,密码就更不容易被破解。
wp_set_auth_cookie <?php wp_set_auth_cookie( $user_id, $remember, $secure ) ?>
该函数可由插件代替。若插件无法重新定义函数,则使用该函数。
设置基于User ID身份证明的cookie。
wp_upload_bits <?php wp_upload_bits( $name, $deprecated, $bits, $time ) ?>
用所给内容在上传文件夹中新建一个文件。
如果发生错误,错误信息中会出现关键字’key’。如果文件新建成功,则关键字’file’会被赋予唯一的文件路径,而’url’关键字则被赋予新文件的链接。’error’键值被设为false。
该函数不会将已经上传的文件再次上传到上传文件夹中。该函数会用$bits参数中的内容新建一个文件。如果用户移动上传文件,读取已上传文件中的内容,就可以将文件名和文件内容赋值给该函数,函数再将文件名和内容添加到上传文件夹。
该函数会自动设置新文件的访问权限。
wp_upload_dir <?php $upload_dir = wp_upload_dir(); ?>
返回当前上传目录配置的信息数组。
wp_verify_nonce <?php wp_verify_nonce($nonce, $action); ?>
检查是否在时间范围内使用了正确的随机数。

给我留言

留言无头像?