WP-DOC

Pisanie motywu

06.02 Autor postu

Ostatnia modyfikacja: 19.01.2021

Funkcja get_the_author_meta() oraz the_author_meta()

Funkcje get_the_author_meta() i the_author_meta() przyjmują dokładnie te same argumenty. Funkcję get_the_author_meta() wykorzystujemy do użycia przy programowaniu PHP. Używamy jej wtedy kiedy chcemy pobrać dane i poddać je dalszej obróbce. Natomiast funkcja the_author_meta() służy tylko do wyświetlania pobranych danych.

Argumenty funkcji

Oprócz samego imienia lub pseudonimu autora postu, można uzyskać znacznie więcej informacji. Warunkiem jest uzupełnienie profilu w ustawieniach Użytkownicy - Profil. Wszystkie te informacje możemy wyświetlić w motywie za pomocą funkcji get_the_author_meta() lub the_author_meta(). Poniżej lista argumentów przyjmowanych przez funkcję.

  • admin_color
  • aim
  • comment_shortcuts
  • description
  • display_name
  • first_name
  • ID
  • jabber
  • last_name
  • nickname
  • plugins_last_view plugins_per_page
  • syntax_highlighting
  • rich_editing
  • user_activation_key
  • user_description
  • user_email
  • user_firstname
  • user_lastname
  • user_leveluser_login
  • user_nicename
  • user_pass
  • user_registered
  • user_status
  • user_urlyim

Poniżej przykład zastosowania funkcji get_the_author_meta() oraz get_the_author_meta() z argumentami.

Przykład funkcji get_the_autor_meta() oraz the_autor_meta()

<h1><?php the_author_meta('display_name'); ?></h1>
<p><?php echo get_the_author_meta('ID'); ?></p>

Jeżeli funkcja get_the_author_meta() lub the_author_meta() jest użyta w pętli WordPress, nie ma konieczności podawania ID użytkownika, gdyż domyślnie jest to aktualny autor postu.

Jeżeli dane, które chcemy wyświetlić nie będą istnieć, na przykład z powodu nie uzupełnienia ich w panelu administratora, wówczas nie zostaną zwrócone żadne dane.

Jeżeli używamy funkcji get_the_author_meta() lub the_author_meta() po za pętlą WordPress, koniecznie należy podać ID użytkownika. Poniższy listing wyświetli nazwę użytkownika o numerze ID 5, o ile taki będzie istniał.

Przykład funkcji the_author_meta() oraz get_the_author_meta() z numerem ID użytkownika.

<p><?php the_author_meta('display_name',5); ?></p>
<p><?php echo get_the_author_meta('ID',5); ?></p>

Link do postów autora

Do utworzenia linku autora wpisów należy skorzystać z funkcji get_author_posts_url(). Jako argument przyjmuje ona ID użytkownika, i dla niego generuje link. Wówczas posty dla danego autor zostaną wyświetlone w pliku author-[nickname].phpauthor-[id].phpauthor.phparchive.php lub index.php w zależności od budowy motywu. Natomiast ID użytkownika uzyskamy dzięki funkcji get_the_author_meta() z argumentem ID, jak pokazano na listingu niżej.

Przykład linku do postów autora.

// Jeżeli poniższy przykład jest użyty w pętli to w funkcji the_autor_meta() nie musimy podawać id użytkownika.
<a href="<?php echo get_author_posts_url(get_the_author_meta('ID')); ?>" ><?php the_author_meta('display_name'); ?></a>

Przy tworzeniu linku warto skorzystać z funkcji esc_url(), która oczyszcza link. Koduje znaki jako encje, na przykład znak & zamieni na postać &#038. Link do wpisów autora powinien wyglądać jak na listingu niżej.

Przykład linku do postów autora – czyszczenie linku

<a href="<?php echo esc_url(get_author_posts_url(get_the_author_meta('ID'))); ?>" ><?php the_author_meta('display_name'); ?></a>

KOMENTARZE

Jeżeli masz pytanie lub sugestie dotyczącą artykułu to napisz komentarz. Wartościowe komentarze zostaną umieszczone jako opinie warte uwagi.

Napisz komentarz

Wszystkie pola są obowiązkowe. E-mail nie będzie udostępniony, ani wykorzystywany do rozsyłania wiadomości reklamowych.

Jeszcze nikt nie napisał komentarza.