`get_permalink` în WordPress

get_permalink() întoarce adresa permanentă a unui articol sau a unei pagini; the_permalink() o afișează escapată.

Sintaxă

get_permalink( int|WP_Post $post = 0, bool $leavename = false ): string|false
the_permalink( int|WP_Post $post = 0 )

Ce face `get_permalink`

get_permalink() construiește adresa publică a unui conținut după structura aleasă în Setări → Legături permanente (de exemplu https://exemplu.ro/meniu-de-toamna/). Primește un ID sau un obiect, implicit articolul curent, și funcționează pentru articole, pagini, atașamente și tipuri personalizate.

the_permalink() (din WordPress 1.2) afișează adresa articolului curent: o trece prin filtrul the_permalink și apoi prin esc_url(), deci e sigură direct în href. Parametrul $post la the_permalink() există din WordPress 4.4.

get_permalink() NU escapează rezultatul: când îl pui în HTML folosește esc_url( get_permalink( $id ) ). Cu $leavename = true primești adresa cu marcajul %postname% în loc de slug (folosit intern de editor).

Parametri

Parametru	Descriere
`$post`	ID-ul sau obiectul articolului. Implicit articolul global `$post`.
`$leavename`	`get_permalink()`: dacă păstrează marcajul pentru numele articolului/paginii în loc de slug. Implicit `false`.

Ce returnează

get_permalink(): adresa ca șir, sau false dacă articolul nu există. the_permalink() afișează adresa și nu întoarce nimic.

Exemple

Exemplul 1: Link către articol în buclă

the_permalink() escapează deja adresa, deci nu mai e nevoie de esc_url().

<?php while ( have_posts() ) : the_post(); ?>
    <a class="citeste" href="<?php the_permalink(); ?>">Citește articolul</a>
<?php endwhile; ?>

Ce afișează pagina

<a class="citeste" href="https://exemplu.ro/meniu-de-toamna/">Citește articolul</a>

Exemplul 2: Adresa unei pagini după ID, din terminal

Verifici rapid ce adresă are pagina cu ID 64 (structura de legături: „Numele articolului”).

wp eval 'echo get_permalink( 64 );'

Ieșire în terminal

https://exemplu.ro/contact/

Exemplul 3: Link escapat în afara buclei

Cu get_permalink() escapezi tu adresa; verifici și false, pentru cazul în care pagina a fost ștearsă.

<?php
$url = get_permalink( 64 );
if ( $url ) {
    echo '<a href="' . esc_url( $url ) . '">Scrie-ne</a>';
}