<?php

[0] Fix | Delete

/**

[1] Fix | Delete

* WordPress Bookmark Administration API

[2] Fix | Delete

*

[3] Fix | Delete

* @package WordPress

[4] Fix | Delete

* @subpackage Administration

[5] Fix | Delete

*/

[6] Fix | Delete

[7] Fix | Delete

/**

[8] Fix | Delete

* Adds a link using values provided in $_POST.

[9] Fix | Delete

*

[10] Fix | Delete

* @since 2.0.0

[11] Fix | Delete

*

[12] Fix | Delete

* @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.

[13] Fix | Delete

*/

[14] Fix | Delete

function add_link() {

[15] Fix | Delete

return edit_link();

[16] Fix | Delete

}

[17] Fix | Delete

[18] Fix | Delete

/**

[19] Fix | Delete

* Updates or inserts a link using values provided in $_POST.

[20] Fix | Delete

*

[21] Fix | Delete

* @since 2.0.0

[22] Fix | Delete

*

[23] Fix | Delete

* @param int $link_id Optional. ID of the link to edit. Default 0.

[24] Fix | Delete

* @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.

[25] Fix | Delete

*/

[26] Fix | Delete

function edit_link( $link_id = 0 ) {

[27] Fix | Delete

if ( ! current_user_can( 'manage_links' ) ) {

[28] Fix | Delete

wp_die(

[29] Fix | Delete

'<h1>' . __( 'You need a higher level of permission.' ) . '</h1>' .

[30] Fix | Delete

'<p>' . __( 'Sorry, you are not allowed to edit the links for this site.' ) . '</p>',

[31] Fix | Delete

403

[32] Fix | Delete

);

[33] Fix | Delete

}

[34] Fix | Delete

[35] Fix | Delete

$_POST['link_url'] = esc_url( $_POST['link_url'] );

[36] Fix | Delete

$_POST['link_name'] = esc_html( $_POST['link_name'] );

[37] Fix | Delete

$_POST['link_image'] = esc_html( $_POST['link_image'] );

[38] Fix | Delete

$_POST['link_rss'] = esc_url( $_POST['link_rss'] );

[39] Fix | Delete

if ( ! isset( $_POST['link_visible'] ) || 'N' !== $_POST['link_visible'] ) {

[40] Fix | Delete

$_POST['link_visible'] = 'Y';

[41] Fix | Delete

}

[42] Fix | Delete

[43] Fix | Delete

if ( ! empty( $link_id ) ) {

[44] Fix | Delete

$_POST['link_id'] = $link_id;

[45] Fix | Delete

return wp_update_link( $_POST );

[46] Fix | Delete

} else {

[47] Fix | Delete

return wp_insert_link( $_POST );

[48] Fix | Delete

}

[49] Fix | Delete

}

[50] Fix | Delete

[51] Fix | Delete

/**

[52] Fix | Delete

* Retrieves the default link for editing.

[53] Fix | Delete

*

[54] Fix | Delete

* @since 2.0.0

[55] Fix | Delete

*

[56] Fix | Delete

* @return stdClass Default link object.

[57] Fix | Delete

*/

[58] Fix | Delete

function get_default_link_to_edit() {

[59] Fix | Delete

$link = new stdClass();

[60] Fix | Delete

if ( isset( $_GET['linkurl'] ) ) {

[61] Fix | Delete

$link->link_url = esc_url( wp_unslash( $_GET['linkurl'] ) );

[62] Fix | Delete

} else {

[63] Fix | Delete

$link->link_url = '';

[64] Fix | Delete

}

[65] Fix | Delete

[66] Fix | Delete

if ( isset( $_GET['name'] ) ) {

[67] Fix | Delete

$link->link_name = esc_attr( wp_unslash( $_GET['name'] ) );

[68] Fix | Delete

} else {

[69] Fix | Delete

$link->link_name = '';

[70] Fix | Delete

}

[71] Fix | Delete

[72] Fix | Delete

$link->link_visible = 'Y';

[73] Fix | Delete

[74] Fix | Delete

return $link;

[75] Fix | Delete

}

[76] Fix | Delete

[77] Fix | Delete

/**

[78] Fix | Delete

* Deletes a specified link from the database.

[79] Fix | Delete

*

[80] Fix | Delete

* @since 2.0.0

[81] Fix | Delete

*

[82] Fix | Delete

* @global wpdb $wpdb WordPress database abstraction object.

[83] Fix | Delete

*

[84] Fix | Delete

* @param int $link_id ID of the link to delete.

[85] Fix | Delete

* @return true Always true.

[86] Fix | Delete

*/

[87] Fix | Delete

function wp_delete_link( $link_id ) {

[88] Fix | Delete

global $wpdb;

[89] Fix | Delete

/**

[90] Fix | Delete

* Fires before a link is deleted.

[91] Fix | Delete

*

[92] Fix | Delete

* @since 2.0.0

[93] Fix | Delete

*

[94] Fix | Delete

* @param int $link_id ID of the link to delete.

[95] Fix | Delete

*/

[96] Fix | Delete

do_action( 'delete_link', $link_id );

[97] Fix | Delete

[98] Fix | Delete

wp_delete_object_term_relationships( $link_id, 'link_category' );

[99] Fix | Delete

[100] Fix | Delete

$wpdb->delete( $wpdb->links, array( 'link_id' => $link_id ) );

[101] Fix | Delete

[102] Fix | Delete

/**

[103] Fix | Delete

* Fires after a link has been deleted.

[104] Fix | Delete

*

[105] Fix | Delete

* @since 2.2.0

[106] Fix | Delete

*

[107] Fix | Delete

* @param int $link_id ID of the deleted link.

[108] Fix | Delete

*/

[109] Fix | Delete

do_action( 'deleted_link', $link_id );

[110] Fix | Delete

[111] Fix | Delete

clean_bookmark_cache( $link_id );

[112] Fix | Delete

[113] Fix | Delete

return true;

[114] Fix | Delete

}

[115] Fix | Delete

[116] Fix | Delete

/**

[117] Fix | Delete

* Retrieves the link category IDs associated with the link specified.

[118] Fix | Delete

*

[119] Fix | Delete

* @since 2.1.0

[120] Fix | Delete

*

[121] Fix | Delete

* @param int $link_id Link ID to look up.

[122] Fix | Delete

* @return int[] The IDs of the requested link's categories.

[123] Fix | Delete

*/

[124] Fix | Delete

function wp_get_link_cats( $link_id = 0 ) {

[125] Fix | Delete

$cats = wp_get_object_terms( $link_id, 'link_category', array( 'fields' => 'ids' ) );

[126] Fix | Delete

return array_unique( $cats );

[127] Fix | Delete

}

[128] Fix | Delete

[129] Fix | Delete

/**

[130] Fix | Delete

* Retrieves link data based on its ID.

[131] Fix | Delete

*

[132] Fix | Delete

* @since 2.0.0

[133] Fix | Delete

*

[134] Fix | Delete

* @param int|stdClass $link Link ID or object to retrieve.

[135] Fix | Delete

* @return object Link object for editing.

[136] Fix | Delete

*/

[137] Fix | Delete

function get_link_to_edit( $link ) {

[138] Fix | Delete

return get_bookmark( $link, OBJECT, 'edit' );

[139] Fix | Delete

}

[140] Fix | Delete

[141] Fix | Delete

/**

[142] Fix | Delete

* Inserts a link into the database, or updates an existing link.

[143] Fix | Delete

*

[144] Fix | Delete

* Runs all the necessary sanitizing, provides default values if arguments are missing,

[145] Fix | Delete

* and finally saves the link.

[146] Fix | Delete

*

[147] Fix | Delete

* @since 2.0.0

[148] Fix | Delete

*

[149] Fix | Delete

* @global wpdb $wpdb WordPress database abstraction object.

[150] Fix | Delete

*

[151] Fix | Delete

* @param array $linkdata {

[152] Fix | Delete

* Elements that make up the link to insert.

[153] Fix | Delete

*

[154] Fix | Delete

* @type int $link_id Optional. The ID of the existing link if updating.

[155] Fix | Delete

* @type string $link_url The URL the link points to.

[156] Fix | Delete

* @type string $link_name The title of the link.

[157] Fix | Delete

* @type string $link_image Optional. A URL of an image.

[158] Fix | Delete

* @type string $link_target Optional. The target element for the anchor tag.

[159] Fix | Delete

* @type string $link_description Optional. A short description of the link.

[160] Fix | Delete

* @type string $link_visible Optional. 'Y' means visible, anything else means not.

[161] Fix | Delete

* @type int $link_owner Optional. A user ID.

[162] Fix | Delete

* @type int $link_rating Optional. A rating for the link.

[163] Fix | Delete

* @type string $link_rel Optional. A relationship of the link to you.

[164] Fix | Delete

* @type string $link_notes Optional. An extended description of or notes on the link.

[165] Fix | Delete

* @type string $link_rss Optional. A URL of an associated RSS feed.

[166] Fix | Delete

* @type int $link_category Optional. The term ID of the link category.

[167] Fix | Delete

* If empty, uses default link category.

[168] Fix | Delete

* }

[169] Fix | Delete

* @param bool $wp_error Optional. Whether to return a WP_Error object on failure. Default false.

[170] Fix | Delete

* @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.

[171] Fix | Delete

*/

[172] Fix | Delete

function wp_insert_link( $linkdata, $wp_error = false ) {

[173] Fix | Delete

global $wpdb;

[174] Fix | Delete

[175] Fix | Delete

$defaults = array(

[176] Fix | Delete

'link_id' => 0,

[177] Fix | Delete

'link_name' => '',

[178] Fix | Delete

'link_url' => '',

[179] Fix | Delete

'link_rating' => 0,

[180] Fix | Delete

);

[181] Fix | Delete

[182] Fix | Delete

$parsed_args = wp_parse_args( $linkdata, $defaults );

[183] Fix | Delete

$parsed_args = wp_unslash( sanitize_bookmark( $parsed_args, 'db' ) );

[184] Fix | Delete

[185] Fix | Delete

$link_id = $parsed_args['link_id'];

[186] Fix | Delete

$link_name = $parsed_args['link_name'];

[187] Fix | Delete

$link_url = $parsed_args['link_url'];

[188] Fix | Delete

[189] Fix | Delete

$update = false;

[190] Fix | Delete

if ( ! empty( $link_id ) ) {

[191] Fix | Delete

$update = true;

[192] Fix | Delete

}

[193] Fix | Delete

[194] Fix | Delete

if ( '' === trim( $link_name ) ) {

[195] Fix | Delete

if ( '' !== trim( $link_url ) ) {

[196] Fix | Delete

$link_name = $link_url;

[197] Fix | Delete

} else {

[198] Fix | Delete

return 0;

[199] Fix | Delete

}

[200] Fix | Delete

}

[201] Fix | Delete

[202] Fix | Delete

if ( '' === trim( $link_url ) ) {

[203] Fix | Delete

return 0;

[204] Fix | Delete

}

[205] Fix | Delete

[206] Fix | Delete

$link_rating = ( ! empty( $parsed_args['link_rating'] ) ) ? $parsed_args['link_rating'] : 0;

[207] Fix | Delete

$link_image = ( ! empty( $parsed_args['link_image'] ) ) ? $parsed_args['link_image'] : '';

[208] Fix | Delete

$link_target = ( ! empty( $parsed_args['link_target'] ) ) ? $parsed_args['link_target'] : '';

[209] Fix | Delete

$link_visible = ( ! empty( $parsed_args['link_visible'] ) ) ? $parsed_args['link_visible'] : 'Y';

[210] Fix | Delete

$link_owner = ( ! empty( $parsed_args['link_owner'] ) ) ? $parsed_args['link_owner'] : get_current_user_id();

[211] Fix | Delete

$link_notes = ( ! empty( $parsed_args['link_notes'] ) ) ? $parsed_args['link_notes'] : '';

[212] Fix | Delete

$link_description = ( ! empty( $parsed_args['link_description'] ) ) ? $parsed_args['link_description'] : '';

[213] Fix | Delete

$link_rss = ( ! empty( $parsed_args['link_rss'] ) ) ? $parsed_args['link_rss'] : '';

[214] Fix | Delete

$link_rel = ( ! empty( $parsed_args['link_rel'] ) ) ? $parsed_args['link_rel'] : '';

[215] Fix | Delete

$link_category = ( ! empty( $parsed_args['link_category'] ) ) ? $parsed_args['link_category'] : array();

[216] Fix | Delete

[217] Fix | Delete

// Make sure we set a valid category.

[218] Fix | Delete

if ( ! is_array( $link_category ) || 0 === count( $link_category ) ) {

[219] Fix | Delete

$link_category = array( get_option( 'default_link_category' ) );

[220] Fix | Delete

}

[221] Fix | Delete

[222] Fix | Delete

if ( $update ) {

[223] Fix | Delete

if ( false === $wpdb->update( $wpdb->links, compact( 'link_url', 'link_name', 'link_image', 'link_target', 'link_description', 'link_visible', 'link_owner', 'link_rating', 'link_rel', 'link_notes', 'link_rss' ), compact( 'link_id' ) ) ) {

[224] Fix | Delete

if ( $wp_error ) {

[225] Fix | Delete

return new WP_Error( 'db_update_error', __( 'Could not update link in the database.' ), $wpdb->last_error );

[226] Fix | Delete

} else {

[227] Fix | Delete

return 0;

[228] Fix | Delete

}

[229] Fix | Delete

}

[230] Fix | Delete

} else {

[231] Fix | Delete

if ( false === $wpdb->insert( $wpdb->links, compact( 'link_url', 'link_name', 'link_image', 'link_target', 'link_description', 'link_visible', 'link_owner', 'link_rating', 'link_rel', 'link_notes', 'link_rss' ) ) ) {

[232] Fix | Delete

if ( $wp_error ) {

[233] Fix | Delete

return new WP_Error( 'db_insert_error', __( 'Could not insert link into the database.' ), $wpdb->last_error );

[234] Fix | Delete

} else {

[235] Fix | Delete

return 0;

[236] Fix | Delete

}

[237] Fix | Delete

}

[238] Fix | Delete

$link_id = (int) $wpdb->insert_id;

[239] Fix | Delete

}

[240] Fix | Delete

[241] Fix | Delete

wp_set_link_cats( $link_id, $link_category );

[242] Fix | Delete

[243] Fix | Delete

if ( $update ) {

[244] Fix | Delete

/**

[245] Fix | Delete

* Fires after a link was updated in the database.

[246] Fix | Delete

*

[247] Fix | Delete

* @since 2.0.0

[248] Fix | Delete

*

[249] Fix | Delete

* @param int $link_id ID of the link that was updated.

[250] Fix | Delete

*/

[251] Fix | Delete

do_action( 'edit_link', $link_id );

[252] Fix | Delete

} else {

[253] Fix | Delete

/**

[254] Fix | Delete

* Fires after a link was added to the database.

[255] Fix | Delete

*

[256] Fix | Delete

* @since 2.0.0

[257] Fix | Delete

*

[258] Fix | Delete

* @param int $link_id ID of the link that was added.

[259] Fix | Delete

*/

[260] Fix | Delete

do_action( 'add_link', $link_id );

[261] Fix | Delete

}

[262] Fix | Delete

clean_bookmark_cache( $link_id );

[263] Fix | Delete

[264] Fix | Delete

return $link_id;

[265] Fix | Delete

}

[266] Fix | Delete

[267] Fix | Delete

/**

[268] Fix | Delete

* Updates link with the specified link categories.

[269] Fix | Delete

*

[270] Fix | Delete

* @since 2.1.0

[271] Fix | Delete

*

[272] Fix | Delete

* @param int $link_id ID of the link to update.

[273] Fix | Delete

* @param int[] $link_categories Array of link category IDs to add the link to.

[274] Fix | Delete

*/

[275] Fix | Delete

function wp_set_link_cats( $link_id = 0, $link_categories = array() ) {

[276] Fix | Delete

// If $link_categories isn't already an array, make it one:

[277] Fix | Delete

if ( ! is_array( $link_categories ) || 0 === count( $link_categories ) ) {

[278] Fix | Delete

$link_categories = array( get_option( 'default_link_category' ) );

[279] Fix | Delete

}

[280] Fix | Delete

[281] Fix | Delete

$link_categories = array_map( 'intval', $link_categories );

[282] Fix | Delete

$link_categories = array_unique( $link_categories );

[283] Fix | Delete

[284] Fix | Delete

wp_set_object_terms( $link_id, $link_categories, 'link_category' );

[285] Fix | Delete

[286] Fix | Delete

clean_bookmark_cache( $link_id );

[287] Fix | Delete

}

[288] Fix | Delete

[289] Fix | Delete

/**

[290] Fix | Delete

* Updates a link in the database.

[291] Fix | Delete

*

[292] Fix | Delete

* @since 2.0.0

[293] Fix | Delete

*

[294] Fix | Delete

* @param array $linkdata Link data to update. See wp_insert_link() for accepted arguments.

[295] Fix | Delete

* @return int|WP_Error Value 0 or WP_Error on failure. The updated link ID on success.

[296] Fix | Delete

*/

[297] Fix | Delete

function wp_update_link( $linkdata ) {

[298] Fix | Delete

$link_id = (int) $linkdata['link_id'];

[299] Fix | Delete

[300] Fix | Delete

$link = get_bookmark( $link_id, ARRAY_A );

[301] Fix | Delete

[302] Fix | Delete

// Escape data pulled from DB.

[303] Fix | Delete

$link = wp_slash( $link );

[304] Fix | Delete

[305] Fix | Delete

// Passed link category list overwrites existing category list if not empty.

[306] Fix | Delete

if ( isset( $linkdata['link_category'] ) && is_array( $linkdata['link_category'] )

[307] Fix | Delete

&& count( $linkdata['link_category'] ) > 0

[308] Fix | Delete

) {

[309] Fix | Delete

$link_cats = $linkdata['link_category'];

[310] Fix | Delete

} else {

[311] Fix | Delete

$link_cats = $link['link_category'];

[312] Fix | Delete

}

[313] Fix | Delete

[314] Fix | Delete

// Merge old and new fields with new fields overwriting old ones.

[315] Fix | Delete

$linkdata = array_merge( $link, $linkdata );

[316] Fix | Delete

$linkdata['link_category'] = $link_cats;

[317] Fix | Delete

[318] Fix | Delete

return wp_insert_link( $linkdata );

[319] Fix | Delete

}

[320] Fix | Delete

[321] Fix | Delete

/**

[322] Fix | Delete

* Outputs the 'disabled' message for the WordPress Link Manager.

[323] Fix | Delete

*

[324] Fix | Delete

* @since 3.5.0

[325] Fix | Delete

* @access private

[326] Fix | Delete

*

[327] Fix | Delete

* @global string $pagenow The filename of the current screen.

[328] Fix | Delete

*/

[329] Fix | Delete

function wp_link_manager_disabled_message() {

[330] Fix | Delete

global $pagenow;

[331] Fix | Delete

[332] Fix | Delete

if ( ! in_array( $pagenow, array( 'link-manager.php', 'link-add.php', 'link.php' ), true ) ) {

[333] Fix | Delete

return;

[334] Fix | Delete

}

[335] Fix | Delete

[336] Fix | Delete

add_filter( 'pre_option_link_manager_enabled', '__return_true', 100 );

[337] Fix | Delete

$really_can_manage_links = current_user_can( 'manage_links' );

[338] Fix | Delete

remove_filter( 'pre_option_link_manager_enabled', '__return_true', 100 );

[339] Fix | Delete

[340] Fix | Delete

if ( $really_can_manage_links ) {

[341] Fix | Delete

$plugins = get_plugins();

[342] Fix | Delete

[343] Fix | Delete

if ( empty( $plugins['link-manager/link-manager.php'] ) ) {

[344] Fix | Delete

if ( current_user_can( 'install_plugins' ) ) {

[345] Fix | Delete

$install_url = wp_nonce_url(

[346] Fix | Delete

self_admin_url( 'update.php?action=install-plugin&plugin=link-manager' ),

[347] Fix | Delete

'install-plugin_link-manager'

[348] Fix | Delete

);

[349] Fix | Delete

[350] Fix | Delete

wp_die(

[351] Fix | Delete

sprintf(

[352] Fix | Delete

/* translators: %s: A link to install the Link Manager plugin. */

[353] Fix | Delete

__( 'If you are looking to use the link manager, please install the <a href="%s">Link Manager plugin</a>.' ),

[354] Fix | Delete

esc_url( $install_url )

[355] Fix | Delete

)

[356] Fix | Delete

);

[357] Fix | Delete

}

[358] Fix | Delete

} elseif ( is_plugin_inactive( 'link-manager/link-manager.php' ) ) {

[359] Fix | Delete

if ( current_user_can( 'activate_plugins' ) ) {

[360] Fix | Delete

$activate_url = wp_nonce_url(

[361] Fix | Delete

self_admin_url( 'plugins.php?action=activate&plugin=link-manager/link-manager.php' ),

[362] Fix | Delete

'activate-plugin_link-manager/link-manager.php'

[363] Fix | Delete

);

[364] Fix | Delete

[365] Fix | Delete

wp_die(

[366] Fix | Delete

sprintf(

[367] Fix | Delete

/* translators: %s: A link to activate the Link Manager plugin. */

[368] Fix | Delete

__( 'Please activate the <a href="%s">Link Manager plugin</a> to use the link manager.' ),

[369] Fix | Delete

esc_url( $activate_url )

[370] Fix | Delete

)

[371] Fix | Delete

);

[372] Fix | Delete

}

[373] Fix | Delete

}

[374] Fix | Delete

}

[375] Fix | Delete

[376] Fix | Delete

wp_die( __( 'Sorry, you are not allowed to edit the links for this site.' ) );

[377] Fix | Delete

}

[378] Fix | Delete