WordPress
Dodaj krótki kod
Szukaj…
Składnia
add_shortcode( $tag , $func );
Parametry
| Parametr | Detale |
|---|---|
| Tag $ | (ciąg) (wymagane) Znacznik shortcode do przeszukania w treści postu |
| $ func | (wywoływalny) (wymagany) Zaczep, aby uruchomić po znalezieniu krótkiego kodu |
Uwagi
- Do wywołania zwrotnego shortcode zostaną przekazane trzy argumenty: atrybuty shortcode, treść shortcode (jeśli istnieje) i nazwa shortcode.
- Może być tylko jeden haczyk dla każdego skrótu. Co oznacza, że jeśli inna wtyczka ma podobny kod skrótu, zastąpi on twój lub twój zastąpi ich w zależności od kolejności, w jakiej wtyczki są włączone i / lub uruchomione.
- Nazwy atrybutów shortcode są zawsze konwertowane na małe litery, zanim zostaną przekazane do funkcji modułu obsługi. Wartości pozostają nietknięte.
- Zauważ, że funkcja wywoływana przez shortcode nigdy nie powinna generować żadnego wyniku. Funkcje shortcode powinny zwracać tekst, który ma zostać użyty do zastąpienia shortcode. Bezpośrednie wygenerowanie wyniku doprowadzi do nieoczekiwanych rezultatów. Jest to podobne do zachowania filtrów, ponieważ nie powinny one wywoływać oczekiwanych skutków ubocznych wywołania, ponieważ nie można kontrolować, kiedy i skąd są wywoływane.
Prosty shortcode dla ostatniego postu
add_shortcode jest słowem kluczowym wp.
// recent-posts is going to be our shortcode.
add_shortcode('recent-posts', 'recent_posts_function');
// This function is taking action when recent post shortcode is called.
function recent_posts_function() {
query_posts(array('orderby' => 'date', 'order' => 'DESC' , 'showposts' => 1));
if (have_posts()) :
while (have_posts()) : the_post();
$return_string = '<a href="'.get_permalink().'">'.get_the_title().'</a>';
endwhile;
endif;
wp_reset_query();
return $return_string;
}
Ten fragment kodu można umieścić w functions.php kompozycji. functions.php .
[recent-posts] To jest krótki kod dla ostatniego postu. Możemy zastosować ten krótki kod w backendzie (np. Strony, posty, widżety).
Możemy również użyć tego samego krótkiego kodu w naszym kodzie. za pomocą do_shortcode .
Na przykład. echo do_shortcode( '[recent-posts]' );
Zaawansowany shortcode dla najnowszych postów
Ta funkcja przyjmuje parametr określający, ile ostatnich postów chcesz wyświetlić.
Np .: chcesz wyświetlić tylko pięć ostatnich postów. Właśnie przekazałem argumenty z postami = "5" (możesz przekazać dowolną liczbę ostatnich postów, które chcesz wyświetlić).
Funkcja pobiera tylko pięć ostatnich postów z bazy danych.
// recent-posts is going to be our shortcode.
add_shortcode('recent-posts', 'recent_posts_function');
// Functions takes parameter such as posts="5".
function recent_posts_function($atts){
extract(shortcode_atts(array(
'posts' => 1,
), $atts));
$return_string = '<ul>';
query_posts(array('orderby' => 'date', 'order' => 'DESC' , 'showposts' => $posts));
if (have_posts()) :
while (have_posts()) : the_post();
$return_string .= '<li><a href="'.get_permalink().'">'.get_the_title().'</a></li>';
endwhile;
endif;
$return_string .= '</ul>';
wp_reset_query();
return $return_string;
}
Na przykład. echo do_shortcode( '[recent-posts posts="5"]' );