← Back to branch summary

~canonical-sysadmins/wordpress/3.9.x

« back to all changes in this revision

Viewing changes to wp-admin/includes/bookmark.php

  • Committer: Andrew Glen-Young
  • Date: 2011-03-08 14:47:51 UTC
  • Revision ID: andrew.glen-young@canonical.com-20110308144751-1n6spqgayztf9h77
[AGY] import 3.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
wp-admin/includes/bookmark.php
7
7
 */
8
8
 
9
9
/**
10
 
 * {@internal Missing Short Description}}
11
 
 *
12
 
 * @since unknown
13
 
 *
14
 
 * @return unknown
 
10
 * Add a link to using values provided in $_POST.
 
11
 *
 
12
 * @since 2.0.0
 
13
 *
 
14
 * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
15
15
 */
16
16
function add_link() {
17
17
        return edit_link();
18
18
}
19
19
 
20
20
/**
21
 
 * {@internal Missing Short Description}}
22
 
 *
23
 
 * @since unknown
24
 
 *
25
 
 * @param unknown_type $link_id
26
 
 * @return unknown
 
21
 * Update or insert a link using values provided in $_POST.
 
22
 *
 
23
 * @since 2.0.0
 
24
 *
 
25
 * @param int $link_id Optional. ID of the link to edit.
 
26
 * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
27
27
 */
28
 
function edit_link( $link_id = '' ) {
29
 
        if (!current_user_can( 'manage_links' ))
30
 
                wp_die( __( 'Cheatin’ uh?' ));
 
28
function edit_link( $link_id = 0 ) {
 
29
        if ( !current_user_can( 'manage_links' ) )
 
30
                wp_die( __( 'Cheatin’ uh?' ) );
31
31
 
32
32
        $_POST['link_url'] = esc_html( $_POST['link_url'] );
33
33
        $_POST['link_url'] = esc_url($_POST['link_url']);
39
39
 
40
40
        if ( !empty( $link_id ) ) {
41
41
                $_POST['link_id'] = $link_id;
42
 
                return wp_update_link( $_POST);
 
42
                return wp_update_link( $_POST );
43
43
        } else {
44
 
                return wp_insert_link( $_POST);
 
44
                return wp_insert_link( $_POST );
45
45
        }
46
46
}
47
47
 
48
48
/**
49
 
 * {@internal Missing Short Description}}
50
 
 *
51
 
 * @since unknown
52
 
 *
53
 
 * @return unknown
 
49
 * Retrieve the default link for editing.
 
50
 *
 
51
 * @since 2.0.0
 
52
 *
 
53
 * @return object Default link
54
54
 */
55
55
function get_default_link_to_edit() {
56
56
        if ( isset( $_GET['linkurl'] ) )
57
 
                $link->link_url = esc_url( $_GET['linkurl']);
 
57
                $link->link_url = esc_url( $_GET['linkurl'] );
58
58
        else
59
59
                $link->link_url = '';
60
60
 
61
61
        if ( isset( $_GET['name'] ) )
62
 
                $link->link_name = esc_attr( $_GET['name']);
 
62
                $link->link_name = esc_attr( $_GET['name'] );
63
63
        else
64
64
                $link->link_name = '';
65
65
 
69
69
}
70
70
 
71
71
/**
72
 
 * {@internal Missing Short Description}}
73
 
 *
74
 
 * @since unknown
75
 
 *
76
 
 * @param unknown_type $link_id
77
 
 * @return unknown
 
72
 * Delete link specified from database
 
73
 *
 
74
 * @since 2.0.0
 
75
 *
 
76
 * @param int $link_id ID of the link to delete
 
77
 * @return bool True
78
78
 */
79
79
function wp_delete_link( $link_id ) {
80
80
        global $wpdb;
93
93
}
94
94
 
95
95
/**
96
 
 * {@internal Missing Short Description}}
97
 
 *
98
 
 * @since unknown
99
 
 *
100
 
 * @param unknown_type $link_id
101
 
 * @return unknown
 
96
 * Retrieves the link categories associated with the link specified.
 
97
 *
 
98
 * @since 2.1.0
 
99
 *
 
100
 * @param int $link_id Link ID to look up
 
101
 * @return array The requested link's categories
102
102
 */
103
103
function wp_get_link_cats( $link_id = 0 ) {
104
104
 
108
108
}
109
109
 
110
110
/**
111
 
 * {@internal Missing Short Description}}
112
 
 *
113
 
 * @since unknown
114
 
 *
115
 
 * @param unknown_type $link_id
116
 
 * @return unknown
 
111
 * Retrieve link data based on ID.
 
112
 *
 
113
 * @since 2.0.0
 
114
 *
 
115
 * @param int $link_id ID of link to retrieve
 
116
 * @return object Link for editing
117
117
 */
118
118
function get_link_to_edit( $link_id ) {
119
119
        return get_bookmark( $link_id, OBJECT, 'edit' );
120
120
}
121
121
 
122
122
/**
123
 
 * {@internal Missing Short Description}}
124
 
 *
125
 
 * @since unknown
126
 
 *
127
 
 * @param unknown_type $linkdata
128
 
 * @return unknown
 
123
 * This function inserts/updates links into/in the database.
 
124
 *
 
125
 * @since 2.0.0
 
126
 *
 
127
 * @param array $linkdata Elements that make up the link to insert.
 
128
 * @param bool $wp_error Optional. If true return WP_Error object on failure.
 
129
 * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
129
130
 */
130
131
function wp_insert_link( $linkdata, $wp_error = false ) {
131
132
        global $wpdb;
181
182
                $link_rel = '';
182
183
 
183
184
        // Make sure we set a valid category
184
 
        if ( ! isset( $link_category ) ||0 == count( $link_category ) || !is_array( $link_category ) ) {
 
185
        if ( ! isset( $link_category ) || 0 == count( $link_category ) || !is_array( $link_category ) ) {
185
186
                $link_category = array( get_option( 'default_link_category' ) );
186
187
        }
187
188
 
215
216
}
216
217
 
217
218
/**
218
 
 * {@internal Missing Short Description}}
219
 
 *
220
 
 * @since unknown
221
 
 *
222
 
 * @param unknown_type $link_id
223
 
 * @param unknown_type $link_categories
 
219
 * Update link with the specified link categories.
 
220
 *
 
221
 * @since 2.1.0
 
222
 *
 
223
 * @param int $link_id ID of link to update
 
224
 * @param array $link_categories Array of categories to
224
225
 */
225
226
function wp_set_link_cats( $link_id = 0, $link_categories = array() ) {
226
227
        // If $link_categories isn't already an array, make it one:
233
234
        wp_set_object_terms( $link_id, $link_categories, 'link_category' );
234
235
 
235
236
        clean_bookmark_cache( $link_id );
236
 
}       // wp_set_link_cats()
 
237
}
237
238
 
238
239
/**
239
 
 * {@internal Missing Short Description}}
240
 
 *
241
 
 * @since unknown
242
 
 *
243
 
 * @param unknown_type $linkdata
244
 
 * @return unknown
 
240
 * Update a link in the database.
 
241
 *
 
242
 * @since 2.0.0
 
243
 *
 
244
 * @param array $linkdata Link data to update.
 
245
 * @return int|WP_Error Value 0 or WP_Error on failure. The updated link ID on success.
245
246
 */
246
247
function wp_update_link( $linkdata ) {
247
248
        $link_id = (int) $linkdata['link_id'];