Функция EDIT_POST_LINK() в WordPress

Функция EDIT_POST_LINK() позволяет вывести ссылку для редактирования поста, если у пользователя есть на это разрешение. Убедитесь, что используете эту функцию внутри цикла WordPress.

Использование функции

Для того чтобы использовать EDIT_POST_LINK(), нужно обратиться к следующему синтаксису:

edit_post_link( $text, $before, $after, $post, $css_class );

Параметры функции

• $text (string) — Текст ссылки. Если не указан, используется значение по умолчанию: "Редактировать".
• $before (string) — HTML, который будет добавлен перед ссылкой на редактирование. По умолчанию пустая строка.
• $after (string) — HTML, который будет добавлен после ссылки на редактирование. По умолчанию пустая строка.
• $post (int|WP_Post) — ID поста или объект поста. По умолчанию используется глобальная переменная $post.
• $css_class (string) — Пользовательский класс для ссылки. По умолчанию "post-edit-link".

Возвращаемое значение

Функция ничего не возвращает (null).

Примеры использования

Пример 1: Вывод ссылки на редактирование поста

Эта ссылка будет отображаться только для пользователей, имеющих разрешение на редактирование поста.

Результат:

Редактировать

Пример 2: Изменение текста ссылки и обрамление его в HTML-тег <p>

Если хотите изменить текст ссылки и поместить его в тег <p>, используйте следующее:

', '
'); ?>

Код функции

Вот как реализована данная функция в WordPress:

function edit_post_link( $text = null, $before = '', $after = '', $post = 0, $css_class = 'post-edit-link' ) {
    $post = get_post( $post );

    if ( ! $post ) {
        return;
    }

    $url = get_edit_post_link( $post->ID );

    if ( ! $url ) {
        return;
    }

    if ( null === $text ) {
        $text = __( 'Редактировать' );
    }

    $link = '' . $text . '';

    echo $before . apply_filters( 'edit_post_link', $link, $post->ID, $text ) . $after;
}

Изменения в версии

• С версии 1.0.0 — функция введена в WordPress.
• С версии 4.4.0 — добавлен параметр $css_class.

Связанные функции

Существует несколько связанных функций, которые могут быть полезны в контексте работы с постами в WordPress:

• edit_bookmark_link()
• edit_comment_link()
• edit_tag_link()
• get_delete_post_link()
• get_edit_post_link()
• get_edit_user_link()

Эти функции помогут вам управлять различными аспектами с контентом на вашем сайте.

Теперь вы знаете, как использовать функцию EDIT_POST_LINK() в WordPress, и можете выводить ссылки для редактирования ваших постов с учетом всех необходимых настроек. Эта функция делает управление контентом более удобным и эффективным.