sanitize_bookmark_field [ WordPress Function ]
| Parameters: |
|
| Returns: |
|
| Defined at: |
|
Sanitizes a bookmark field
Sanitizes the bookmark fields based on what the field name is. If the field has a strict value set, then it will be tested for that, else a more generic filtering is applied. After the more strict filter is applied, if the $context is 'raw' then the value is immediately return.
Hooks exist for the more generic cases. With the 'edit' context, the 'edit_$field' filter will be called and passed the $value and $bookmark_id respectively. With the 'db' context, the 'pre_$field' filter is called and passed the value. The 'display' context is the final context and has the $field has the filter name and is passed the $value, $bookmark_id, and $context respectively.
Source
<?php
function sanitize_bookmark_field($field, $value, $bookmark_id, $context) {
switch ( $field ) {
case 'link_id' : // ints
case 'link_rating' :
$value = (int) $value;
break;
case 'link_category' : // array( ints )
$value = array_map('absint', (array) $value);
// We return here so that the categories aren't filtered.
// The 'link_category' filter is for the name of a link category, not an array of a link's link categories
return $value;
break;
case 'link_visible' : // bool stored as Y|N
$value = preg_replace('/[^YNyn]/', '', $value);
break;
case 'link_target' : // "enum"
$targets = array('_top', '_blank');
if ( ! in_array($value, $targets) )
$value = '';
break;
}
if ( 'raw' == $context )
return $value;
if ( 'edit' == $context ) {
$value = apply_filters("edit_$field", $value, $bookmark_id);
if ( 'link_notes' == $field ) {
$value = esc_html( $value ); // textarea_escaped
} else {
$value = esc_attr($value);
}
} else if ( 'db' == $context ) {
$value = apply_filters("pre_$field", $value);
} else {
// Use display filters by default.
$value = apply_filters($field, $value, $bookmark_id, $context);
if ( 'attribute' == $context )
$value = esc_attr($value);
else if ( 'js' == $context )
$value = esc_js($value);
}
return $value;
}
?>
Examples [ wp-snippets.com ]
Top Google zoekresultaten
- sanitize_bookmark_field
Function and Method Cross Reference. sanitize_bookmark_field(). Defined at: / wp-includes/bookmark.php -> line 300. Referenced 10 times: ...
phpxref.ftwr.co.uk - Docs for page bookmark.php
since: 2.3.0; uses: sanitize_bookmark_field() - Sanitizes Bookmark field based on $context. uses: get_bookmark() - Gets bookmark object using $bookmark as ID ...
phpdoc.wordpress.org - sanitize_bookmark_field (WordPress Function) - WPSeek.com
WordPress lookup for sanitize_bookmark_field, a WordPress Function. wpseek. com is a WordPress-centric search tool for developers and theme authors.
wpseek.com - sanitize_bookmark_field:WordPress私的マニュアル
2011年11月2日 ... sanitize_bookmark_field - リンク情報の要素値をサニタイズする.
elearn.jp