Changeset 5896 for trunk/wp-includes/bookmark.php

Timestamp:

08/17/2007 09:22:37 PM (19 years ago)

Author:

ryan

Message:

First cut of taxonomy API phpdoc from darkdragon. see #4742

File:

• trunk/wp-includes/bookmark.php (modified) (3 diffs)

trunk/wp-includes/bookmark.php

@@ -1 +1 @@
 <?php
 
-function get_bookmark($bookmark_id, $output = OBJECT) {
+function get_bookmark($bookmark_id, $output = OBJECT, $filter = 'raw') {
         global $wpdb;
 
@@ -8 +8 @@
         $link->link_category = wp_get_link_cats($bookmark_id);
 
+        $link = sanitize_bookmark($link, $filter);
+        
         if ( $output == OBJECT ) {
                 return $link;
@@ -143 +145 @@
 }
 
+function sanitize_bookmark($bookmark, $context = 'display') {
+        $fields = array('link_id', 'link_url', 'link_name', 'link_image', 'link_target', 'link_category',
+                'link_description', 'link_visible', 'link_owner', 'link_rating', 'link_updated',
+                'link_rel', 'link_', 'link_notes', 'link_rss', );
+
+        $do_object = false;
+        if ( is_object($bookmark) )
+                $do_object = true;
+
+        foreach ( $fields as $field ) {
+                if ( $do_object )
+                        $bookmark->$field = sanitize_bookmark_field($field, $bookmark->$field, $bookmark->link_id, $context);
+                else
+                        $bookmark[$field] = sanitize_bookmark_field($field, $bookmark[$field], $bookmark['link_id'], $context); 
+        }
+
+        return $bookmark;
+}
+
+function sanitize_bookmark_field($field, $value, $bookmark_id, $context) {
+        $int_fields = array('ID', 'bookmark_parent', 'menu_order');
+        if ( in_array($field, $int_fields) )
+                $value = (int) $value;
+
+        if ( 'raw' == $context )
+                return $value;
+
+        $prefixed = false;
+        if ( false !== strpos($field, 'bookmark_') ) {
+                $prefixed = true;
+                $field_no_prefix = str_replace('bookmark_', '', $field);
+        }
+
+        if ( 'edit' == $context ) {
+                $format_to_edit = array('bookmark_content', 'bookmark_excerpt', 'bookmark_title', 'bookmark_password');
+
+                if ( $prefixed ) {
+                        $value = apply_filters("edit_$field", $value, $bookmark_id);
+                        // Old school
+                        $value = apply_filters("${field_no_prefix}_edit_pre", $value, $bookmark_id);
+                } else {
+                        $value = apply_filters("edit_bookmark_$field", $value, $bookmark_id);
+                }
+
+                if ( in_array($field, $format_to_edit) ) {
+                        if ( 'bookmark_content' == $field )
+                                $value = format_to_edit($value, user_can_richedit());
+                        else
+                                $value = format_to_edit($value);
+                } else {
+                        $value = attribute_escape($value);
+                }
+        } else if ( 'db' == $context ) {
+                if ( $prefixed ) {
+                        $value = apply_filters("pre_$field", $value);
+                        $value = apply_filters("${field_no_prefix}_save_pre", $value);
+                } else {
+                        $value = apply_filters("pre_bookmark_$field", $value);
+                        $value = apply_filters("${field}_pre", $value);
+                }
+        } else {
+                // Use display filters by default.
+                $value = apply_filters("bookmark_$field", $value, $bookmark_id, $context);
+        }
+
+        if ( 'attribute' == $context )
+                $value = attribute_escape($value);
+        else if ( 'js' == $context )
+                $value = js_escape($value);
+
+        return $value;
+}
+
 function delete_get_bookmark_cache() {
         wp_cache_delete( 'get_bookmarks', 'bookmark' );