edit_link

The timeline below displays how wordpress function edit_link has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 6.3

/**
 * Updates or inserts a link using values provided in $_POST.
 *
 * @since 2.0.0
 *
 * @param int $link_id Optional. ID of the link to edit. Default 0.
 * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
 */
function edit_link($link_id = 0)
{
    if (!current_user_can('manage_links')) {
        wp_die('<h1>' . __('You need a higher level of permission.') . '</h1>' . '<p>' . __('Sorry, you are not allowed to edit the links for this site.') . '</p>', 403);
    }
    $_POST['link_url'] = esc_url($_POST['link_url']);
    $_POST['link_name'] = esc_html($_POST['link_name']);
    $_POST['link_image'] = esc_html($_POST['link_image']);
    $_POST['link_rss'] = esc_url($_POST['link_rss']);
    if (!isset($_POST['link_visible']) || 'N' !== $_POST['link_visible']) {
        $_POST['link_visible'] = 'Y';
    }
    if (!empty($link_id)) {
        $_POST['link_id'] = $link_id;
        return wp_update_link($_POST);
    } else {
        return wp_insert_link($_POST);
    }
}

WordPress Version: 5.5

/**
 * Updates or inserts a link using values provided in $_POST.
 *
 * @since 2.0.0
 *
 * @param int $link_id Optional. ID of the link to edit. Default 0.
 * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
 */
function edit_link($link_id = 0)
{
    if (!current_user_can('manage_links')) {
        wp_die('<h1>' . __('You need a higher level of permission.') . '</h1>' . '<p>' . __('Sorry, you are not allowed to edit the links for this site.') . '</p>', 403);
    }
    $_POST['link_url'] = esc_html($_POST['link_url']);
    $_POST['link_url'] = esc_url($_POST['link_url']);
    $_POST['link_name'] = esc_html($_POST['link_name']);
    $_POST['link_image'] = esc_html($_POST['link_image']);
    $_POST['link_rss'] = esc_url($_POST['link_rss']);
    if (!isset($_POST['link_visible']) || 'N' !== $_POST['link_visible']) {
        $_POST['link_visible'] = 'Y';
    }
    if (!empty($link_id)) {
        $_POST['link_id'] = $link_id;
        return wp_update_link($_POST);
    } else {
        return wp_insert_link($_POST);
    }
}

WordPress Version: 9.5

/**
 * Updates or inserts a link using values provided in $_POST.
 *
 * @since 2.0.0
 *
 * @param int $link_id Optional. ID of the link to edit. Default 0.
 * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
 */
function edit_link($link_id = 0)
{
    if (!current_user_can('manage_links')) {
        wp_die('<h1>' . __('You need a higher level of permission.') . '</h1>' . '<p>' . __('Sorry, you are not allowed to edit the links for this site.') . '</p>', 403);
    }
    $_POST['link_url'] = esc_html($_POST['link_url']);
    $_POST['link_url'] = esc_url($_POST['link_url']);
    $_POST['link_name'] = esc_html($_POST['link_name']);
    $_POST['link_image'] = esc_html($_POST['link_image']);
    $_POST['link_rss'] = esc_url($_POST['link_rss']);
    if (!isset($_POST['link_visible']) || 'N' != $_POST['link_visible']) {
        $_POST['link_visible'] = 'Y';
    }
    if (!empty($link_id)) {
        $_POST['link_id'] = $link_id;
        return wp_update_link($_POST);
    } else {
        return wp_insert_link($_POST);
    }
}

WordPress Version: 9.3

/**
 * Updates or inserts a link using values provided in $_POST.
 *
 * @since 2.0.0
 *
 * @param int $link_id Optional. ID of the link to edit. Default 0.
 * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
 */
function edit_link($link_id = 0)
{
    if (!current_user_can('manage_links')) {
        wp_die('<h1>' . __('Cheatin&#8217; uh?') . '</h1>' . '<p>' . __('Sorry, you are not allowed to edit the links for this site.') . '</p>', 403);
    }
    $_POST['link_url'] = esc_html($_POST['link_url']);
    $_POST['link_url'] = esc_url($_POST['link_url']);
    $_POST['link_name'] = esc_html($_POST['link_name']);
    $_POST['link_image'] = esc_html($_POST['link_image']);
    $_POST['link_rss'] = esc_url($_POST['link_rss']);
    if (!isset($_POST['link_visible']) || 'N' != $_POST['link_visible']) {
        $_POST['link_visible'] = 'Y';
    }
    if (!empty($link_id)) {
        $_POST['link_id'] = $link_id;
        return wp_update_link($_POST);
    } else {
        return wp_insert_link($_POST);
    }
}

WordPress Version: .20

/**
 * Updates or inserts a link using values provided in $_POST.
 *
 * @since 2.0.0
 *
 * @param int $link_id Optional. ID of the link to edit. Default 0.
 * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
 */
function edit_link($link_id = 0)
{
    if (!current_user_can('manage_links')) {
        wp_die('<h1>' . __('You need a higher level of permission.') . '</h1>' . '<p>' . __('Sorry, you are not allowed to edit the links for this site.') . '</p>', 403);
    }
    $_POST['link_url'] = esc_html($_POST['link_url']);
    $_POST['link_url'] = esc_url($_POST['link_url']);
    $_POST['link_name'] = esc_html($_POST['link_name']);
    $_POST['link_image'] = esc_html($_POST['link_image']);
    $_POST['link_rss'] = esc_url($_POST['link_rss']);
    if (!isset($_POST['link_visible']) || 'N' != $_POST['link_visible']) {
        $_POST['link_visible'] = 'Y';
    }
    if (!empty($link_id)) {
        $_POST['link_id'] = $link_id;
        return wp_update_link($_POST);
    } else {
        return wp_insert_link($_POST);
    }
}

WordPress Version: 9.2

/**
 * Updates or inserts a link using values provided in $_POST.
 *
 * @since 2.0.0
 *
 * @param int $link_id Optional. ID of the link to edit. Default 0.
 * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
 */
function edit_link($link_id = 0)
{
    if (!current_user_can('manage_links')) {
        wp_die('<h1>' . __('Cheatin&#8217; uh?') . '</h1>' . '<p>' . __('Sorry, you are not allowed to edit the links for this site.') . '</p>', 403);
    }
    $_POST['link_url'] = esc_html($_POST['link_url']);
    $_POST['link_url'] = esc_url($_POST['link_url']);
    $_POST['link_name'] = esc_html($_POST['link_name']);
    $_POST['link_image'] = esc_html($_POST['link_image']);
    $_POST['link_rss'] = esc_url($_POST['link_rss']);
    if (!isset($_POST['link_visible']) || 'N' != $_POST['link_visible']) {
        $_POST['link_visible'] = 'Y';
    }
    if (!empty($link_id)) {
        $_POST['link_id'] = $link_id;
        return wp_update_link($_POST);
    } else {
        return wp_insert_link($_POST);
    }
}

WordPress Version: .10

/**
 * Updates or inserts a link using values provided in $_POST.
 *
 * @since 2.0.0
 *
 * @param int $link_id Optional. ID of the link to edit. Default 0.
 * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
 */
function edit_link($link_id = 0)
{
    if (!current_user_can('manage_links')) {
        wp_die('<h1>' . __('You need a higher level of permission.') . '</h1>' . '<p>' . __('Sorry, you are not allowed to edit the links for this site.') . '</p>', 403);
    }
    $_POST['link_url'] = esc_html($_POST['link_url']);
    $_POST['link_url'] = esc_url($_POST['link_url']);
    $_POST['link_name'] = esc_html($_POST['link_name']);
    $_POST['link_image'] = esc_html($_POST['link_image']);
    $_POST['link_rss'] = esc_url($_POST['link_rss']);
    if (!isset($_POST['link_visible']) || 'N' != $_POST['link_visible']) {
        $_POST['link_visible'] = 'Y';
    }
    if (!empty($link_id)) {
        $_POST['link_id'] = $link_id;
        return wp_update_link($_POST);
    } else {
        return wp_insert_link($_POST);
    }
}

WordPress Version: 4.6

/**
 * Updates or inserts a link using values provided in $_POST.
 *
 * @since 2.0.0
 *
 * @param int $link_id Optional. ID of the link to edit. Default 0.
 * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
 */
function edit_link($link_id = 0)
{
    if (!current_user_can('manage_links')) {
        wp_die('<h1>' . __('Cheatin&#8217; uh?') . '</h1>' . '<p>' . __('Sorry, you are not allowed to edit the links for this site.') . '</p>', 403);
    }
    $_POST['link_url'] = esc_html($_POST['link_url']);
    $_POST['link_url'] = esc_url($_POST['link_url']);
    $_POST['link_name'] = esc_html($_POST['link_name']);
    $_POST['link_image'] = esc_html($_POST['link_image']);
    $_POST['link_rss'] = esc_url($_POST['link_rss']);
    if (!isset($_POST['link_visible']) || 'N' != $_POST['link_visible']) {
        $_POST['link_visible'] = 'Y';
    }
    if (!empty($link_id)) {
        $_POST['link_id'] = $link_id;
        return wp_update_link($_POST);
    } else {
        return wp_insert_link($_POST);
    }
}

WordPress Version: 4.4

/**
 * Updates or inserts a link using values provided in $_POST.
 *
 * @since 2.0.0
 *
 * @param int $link_id Optional. ID of the link to edit. Default 0.
 * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
 */
function edit_link($link_id = 0)
{
    if (!current_user_can('manage_links')) {
        wp_die('<h1>' . __('Cheatin&#8217; uh?') . '</h1>' . '<p>' . __('You do not have sufficient permissions to edit the links for this site.') . '</p>', 403);
    }
    $_POST['link_url'] = esc_html($_POST['link_url']);
    $_POST['link_url'] = esc_url($_POST['link_url']);
    $_POST['link_name'] = esc_html($_POST['link_name']);
    $_POST['link_image'] = esc_html($_POST['link_image']);
    $_POST['link_rss'] = esc_url($_POST['link_rss']);
    if (!isset($_POST['link_visible']) || 'N' != $_POST['link_visible']) {
        $_POST['link_visible'] = 'Y';
    }
    if (!empty($link_id)) {
        $_POST['link_id'] = $link_id;
        return wp_update_link($_POST);
    } else {
        return wp_insert_link($_POST);
    }
}

WordPress Version: 4.1

/**
 * Update or insert a link using values provided in $_POST.
 *
 * @since 2.0.0
 *
 * @param int $link_id Optional. ID of the link to edit.
 * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
 */
function edit_link($link_id = 0)
{
    if (!current_user_can('manage_links')) {
        wp_die(__('Cheatin&#8217; uh?'), 403);
    }
    $_POST['link_url'] = esc_html($_POST['link_url']);
    $_POST['link_url'] = esc_url($_POST['link_url']);
    $_POST['link_name'] = esc_html($_POST['link_name']);
    $_POST['link_image'] = esc_html($_POST['link_image']);
    $_POST['link_rss'] = esc_url($_POST['link_rss']);
    if (!isset($_POST['link_visible']) || 'N' != $_POST['link_visible']) {
        $_POST['link_visible'] = 'Y';
    }
    if (!empty($link_id)) {
        $_POST['link_id'] = $link_id;
        return wp_update_link($_POST);
    } else {
        return wp_insert_link($_POST);
    }
}

WordPress Version: 3.7

/**
 * Update or insert a link using values provided in $_POST.
 *
 * @since 2.0.0
 *
 * @param int $link_id Optional. ID of the link to edit.
 * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
 */
function edit_link($link_id = 0)
{
    if (!current_user_can('manage_links')) {
        wp_die(__('Cheatin&#8217; uh?'));
    }
    $_POST['link_url'] = esc_html($_POST['link_url']);
    $_POST['link_url'] = esc_url($_POST['link_url']);
    $_POST['link_name'] = esc_html($_POST['link_name']);
    $_POST['link_image'] = esc_html($_POST['link_image']);
    $_POST['link_rss'] = esc_url($_POST['link_rss']);
    if (!isset($_POST['link_visible']) || 'N' != $_POST['link_visible']) {
        $_POST['link_visible'] = 'Y';
    }
    if (!empty($link_id)) {
        $_POST['link_id'] = $link_id;
        return wp_update_link($_POST);
    } else {
        return wp_insert_link($_POST);
    }
}