Obținerea permalink-ului în bucla WordPress
Am o temă (bazată pe Roots/Sage) cu o suprascriere a șablonului home.php
și pe acea pagină afișez fragmente și imaginea reprezentativă pentru fiecare postare.
<?php while (have_posts()) : the_post(); ?>
<div class=".container-fluid">
<?php if (get_post_type() == 'instruments') {?>
<div class="col-md-3">
<h1><?php the_ID(); ?></h1>
<a href="<?php get_post_permalink(the_permalink()) ?>"><?php the_post_thumbnail( 'medium' ); ?></a>
<?php get_template_part('templates/content', get_post_type() != 'post' ? get_post_type() : get_post_format()); ?>
</div>
</div>
<?php } ?>
<?php endwhile; ?>
Pare relativ simplu și funcționează, dar am ajuns să generez link-ul prin:
get_post_permalink(the_permalink())
Și deoarece există atât de multe modalități greșite de a face lucrurile în PHP (și WordPress), aș dori niște feedback.

După cum a fost sugerat, am mers la referința de funcții și de acolo la Fișierul Sursă (aflat în wp_includes/link-template.php
) unde există patru funcții care fiecare returnează rezultate similare.
<?php echo get_post_permalink() ?>
http://newdep.localhost/instruments/jester/
<?php echo post_permalink() ?>
http://newdep.localhost/instruments/jester/
<?php the_permalink() ?>
/instruments/jester/
<?php echo get_the_permalink() ?>
http://newdep.localhost/instruments/jester/
În acest caz, deoarece acesta este un tip de postare personalizat, funcția pe care documentația o descrie ca fiind concepută pentru acesta, este get_post_permalink()
, care, ca majoritatea funcțiilor get_*()
, returnează în loc să afișeze un rezultat, necesită să fie folosită cu echo
.
/**
* Obține permalink-ul pentru o postare cu un tip de postare personalizat.
*
* @since 3.0.0
*
* @param int $id Opțional. ID-ul postării.
* @param bool $leavename Opțional, implicit false. Dacă să păstreze numele postării.
* @param bool $sample Opțional, implicit false. Dacă este un permalink demonstrativ.
* @return string Permalink-ul postării.
*/
function get_post_permalink( $id = 0, $leavename = false, $sample = false ) {
global $wp_rewrite;
$post = get_post($id);
if ( is_wp_error( $post ) )
return $post;
$post_link = $wp_rewrite->get_extra_permastruct($post->post_type);
$slug = $post->post_name;
$draft_or_pending = isset( $post->post_status ) && in_array( $post->post_status, array( 'draft', 'pending', 'auto-draft', 'future' ) );
$post_type = get_post_type_object($post->post_type);
if ( $post_type->hierarchical ) {
$slug = get_page_uri( $id );
}
if ( !empty($post_link) && ( !$draft_or_pending || $sample ) ) {
if ( ! $leavename ) {
$post_link = str_replace("%$post->post_type%", $slug, $post_link);
}
$post_link = home_url( user_trailingslashit($post_link) );
} else {
if ( $post_type->query_var && ( isset($post->post_status) && !$draft_or_pending ) )
$post_link = add_query_arg($post_type->query_var, $slug, '');
else
$post_link = add_query_arg(array('post_type' => $post->post_type, 'p' => $post->ID), '');
$post_link = home_url($post_link);
}
/**
* Filtrează permalink-ul pentru o postare cu un tip de postare personalizat.
*
* @since 3.0.0
*
* @param string $post_link Permalink-ul postării.
* @param WP_Post $post Postarea în cauză.
* @param bool $leavename Dacă să păstreze numele postării.
* @param bool $sample Dacă este un permalink demonstrativ.
*/
return apply_filters( 'post_type_link', $post_link, $post, $leavename, $sample );
}

După cum a menționat Nilambar, funcția corectă este <?php the_permalink(); ?>
.
Cu toate acestea, dacă încerci prin încercare și eroare - consultă Codex-ul WordPress, în special the_permalink
pentru mai multe informații, exemple și funcții înrudite.
