I Tuts + Guida ai tag dei modelli Ottavo lotto

Nell'ottava parte della serie, abbiamo esaminato il settimo lotto di tag modello WordPress. In questa nona parte, esamineremo l'ultimo gruppo di quasi 200 tag modello. Durante il tutorial, vedremo i tag del modello sui segnalibri e altri tag del modello "vari".

Avviso sui segnalibri: A partire da WordPress 3.5, i "segnalibri" sono nascosti dal pannello di amministrazione per impostazione predefinita. Per lavorare con i segnalibri, è necessario installare il plug-in Link Manager.

Ottenere e visualizzare un elenco di segnalibri: wp_list_bookmarks ()

Questo tag template restituisce o echeggia un elenco di segnalibri, una vecchia funzionalità di WordPress.

parametri

Questo tag modello accetta solo un parametro:

• $ args (Opzionale-array):
  Una matrice dei seguenti argomenti:
  • 'ordinato da' (stringa): come ordinare i segnalibri. Accetta "nome", "link_id", "url", "destinazione", "descrizione", "proprietario" (l'utente che ha aggiunto il segnalibro), "valutazione", "aggiornato" (date di aggiornamento), "rel" (XFN) relazione segnalibro), 'note', 'rss', 'lunghezza' (lunghezza del nome del segnalibro), 'rand' (casuale).
    (Predefinito: 'nome')
  • 'ordine' (stringa): se ordinare gli articoli in ordine crescente ("ASC") o decrescente ("DESC").
    (Predefinito: 'ASC')
  • 'limite' (numero intero): numero di elementi da visualizzare.
    (Predefinito: -1 che significa tutti i segnalibri)
  • 'categoria' (stringa): ID di categoria separati da virgole per ottenere elementi da.
    (Predefinito: "che significa tutte le categorie)
  • 'Exclude_category' (stringa): ID di categorie di segnalibri da escludere.
    (Predefinito:")
  • 'Nome della categoria' (stringa): un nome di categoria per mostrare i segnalibri da (sovrascrive 'categoria').
    (Predefinito:")
  • 'Hide_invisible' (numero intero): se nascondere i collegamenti invisibili o mostrarli.
    (Predefinito: 1)
  • 'Show_updated' (numero intero): se l'ultimo timestamp aggiornato debba essere visualizzato o meno.
    (Predefinito: 0)
  • 'eco' (numero intero): se eseguire l'eco dell'output (1) o restituirlo (0).
    (Predefinito: 1)
  • 'classificare' (numero intero): se raggruppare i segnalibri in base alle categorie (1) o meno (0).
    (Predefinito: 1)
  • 'Title_li' (stringa): avvolge l'output con a
  • etichetta e visualizza un titolo prima dell'elenco dei segnalibri. Probabilmente vorrai impostarlo su una stringa vuota e disabilitare il wrapping.
    (Predefinito: "Segnalibri")
  • 'Title_before' (stringa): codice HTML da aggiungere prima di ogni titolo.
    (Predefinito: '

    ')

  • 'Title_after' (stringa): codice HTML da aggiungere dopo ogni titolo.
    (Predefinito: '')
  • 'classe' (stringa): nomi di classi CSS da aggiungere a ciascuna categoria.
    (Predefinito: 'linkcat')
  • 'Category_before' (stringa): codice HTML da aggiungere prima di ogni categoria.
    (Predefinito: '
  • ')
  • 'Category_after' (stringa): codice HTML da aggiungere dopo ogni categoria.
    (Predefinito: '
  ')
  • 'Category_orderby' (stringa): come ordinare le categorie. Accetta "nome", "id", "slug" e "count".
    (Predefinito: 'nome')
  • 'Category_order' (stringa): se ordinare le categorie in ordine crescente ("ASC") o discendente ("DESC").
    (Predefinito: 'ASC')

uso

 'Rand', // Prendi solo 5 segnalibri. 'limit' => 5, // Scatta i segnalibri da una categoria specifica. 'category_name' => 'Friends', // Do not echo. 'echo' => 0, // Classe personalizzata. 'class' => 'friends-bookmark-list'); $ bookmarks_list = wp_list_bookmarks ($ args); ?>

Ottenere una matrice di tutti i segnalibri: get_bookmarks ()

Questo tag template restituisce una serie di segnalibri WordPress.

parametri

Questo tag modello accetta solo un parametro:

• $ args (Opzionale-array):
  Una matrice dei seguenti argomenti:
  • 'ordinato da' (stringa): come ordinare i collegamenti. Accetta campi come "nome", "ID", "titolo", "data" ecc.
    (Predefinito: 'nome')
  • 'ordine' (stringa): se ordinare gli articoli in ordine crescente ("ASC") o decrescente ("DESC").
    (Predefinito: 'ASC')
  • 'limite' (numero intero): numero di elementi da visualizzare.
    (Predefinito: -1 che significa tutto)
  • 'categoria' (stringa): ID di categoria separati da virgole per ottenere elementi da.
    (Predefinito: vuoto)
  • 'Nome della categoria' (stringa): nome della categoria per ottenere elementi da.
    (Predefinito: vuoto)
  • 'Hide_invisible' (intero o booleano): se mostrare o nascondere i collegamenti contrassegnati come "invisibili".
    (Predefinito: 1 | VERO)
  • 'Show_updated' (intero o booleano): se visualizzare l'ora dell'ultimo aggiornamento del segnalibro.
    (Predefinito: 0 | FALSE)
  • 'includere' (stringa): elenco di ID separati da virgola da includere.
    (Predefinito: vuoto)
  • 'escludere' (stringa): elenco di ID separati da virgola da escludere.
    (Predefinito: vuoto)

uso

 'title', 'order' => 'ASC', 'limit' => 15, 'hide_invisible' => false, 'exclude' => '12, 16,23 '); $ bookmarks_array = get_bookmarks ($ args); ?>

Ottenere i dati dei segnalibri: get_bookmark ()

Questo tag modello restituisce tutti i dati di un determinato segnalibro.

parametri

Questo tag modello accetta tre parametri:

• $ segnalibro (Obbligatorio-misto):
  L'ID del segnalibro o oggetto.
  (Predefinito: NULLO)
• $ uscita (Optional-string):
  Costante OBJECT, ARRAY_N o ARRAY_A.
  (Predefinito: OGGETTO)
• Filtro $ (Optional-string):
  Se sfuggire all'output o meno. Se si desidera filtrare l'output, impostarlo su 'display'.
  (Predefinito: 'raw')

uso

Ottenere un singolo segnalibro Dati del campo: get_bookmark_field ()

Questo tag modello ti consente di recuperare i dati del campo di un singolo segnalibro.

parametri

Questo tag modello accetta tre parametri:

• $ campo (Obbligatorio-stringa):
  Il nome del campo.
  (Predefinito: NULLO)
• $ segnalibro (Obbligatorio-intero):
  L'ID del segnalibro.
  (Predefinito: NULLO)
• $ contesto (Optional-string):
  Come filtrare il valore del campo: "raw", "edit", "attribute", "js", "db" o "display".
  (Predefinito: 'display')

uso

Ottenere e visualizzare il link "Modifica segnalibro": get_edit_bookmark_link () & edit_bookmark_link ()

Questi tag modello ti consentono di ottenere o echo un link "modifica questo segnalibro" da utilizzare nei tuoi modelli.

parametri

get_edit_bookmark_link () accetta solo un parametro:

• $ bookmark_id (Obbligatorio-intero):
  L'ID del segnalibro.
  (Predefinito: 0)

E edit_bookmark_link () accetta quattro parametri:

• $ testo (Optional-string):
  Testo per visualizzare il collegamento.
  (Predefinito: "Modifica questo")
• $ prima (Optional-string):
  Il testo o il codice HTML da visualizzare prima dell'output.
  (Predefinito: vuoto)
• $ dopo (Optional-string):
  Il testo o il codice HTML da visualizzare dopo l'output.
  (Predefinito: vuoto)
• $ bookmark_id (Obbligatorio-intero):
  L'ID del segnalibro.
  (Predefinito: NULLO)

uso

',''); // Visualizza il link "modifica segnalibro" di un segnalibro specifico. edit_bookmark_link (__ ('Edit', 'translation-domain'), ",", 98); ?>

Ottenere e visualizzare le informazioni del tuo sito: get_bloginfo () & bloginfo ()

Questi tag template estremamente popolari restituiscono e visualizzano le informazioni generali del tuo sito.

parametri

get_ bloginfo () accetta due parametri:

• $ spettacolo (Optional-string):
  Il bit di informazioni da recuperare. Uno dei seguenti valori:
  • 'Url' (stringa): l'home URL.
  • 'Wpurl' (stringa): l'URL in cui è installato WordPress.
  • 'descrizione' (stringa): descrizione del sito.
  • 'Rdf_url' (stringa): l'URL del feed RDF / RSS 1.0.
  • 'Rss_url' (stringa): l'URL del feed RSS 0.92.
  • 'Rss2_url' (stringa): l'URL del feed RSS 2.0.
  • 'Atom_url' (stringa): l'URL del feed Atom.
  • 'Comments_rss2_url' (stringa): l'URL del feed RSS 2.0 per i commenti.
  • 'Comments_atom_url' (stringa): l'URL del feed Atom per i commenti.
  • 'Pingback_url' (stringa): l'URL del file XML-RPC di pingback.
  • 'Stylesheet_url' (stringa): l'URL del file CSS principale del tema.
  • 'Stylesheet_directory' (stringa): l'URL della directory del file CSS principale del tema.
  • 'Template_directory' o 'Template_url' (stringa): l'URL della directory del tema attivo.
  • 'Admin_email' (stringa): l'indirizzo email inserito quando è stato installato WordPress.
  • 'Charset' (stringa): set di caratteri del sito.
  • 'Html_type' (stringa): il Content-Type delle pagine HTML di WordPress.
  • 'versione' (stringa): versione di WordPress.
  • 'linguaggio' (stringa): lingua dell'installazione di WordPress.
  • 'Text_direction' (stringa): direzione del testo della lingua.
  • 'nome' (stringa): nome del sito.
  (Predefinito: 'nome')
• Filtro $ (Optional-string):
  Impostalo su 'filtro' per filtrare l'URL restituito da questo tag modello.
  (Predefinito: 'raw')

E bloginfo () accetta solo un parametro:

• $ spettacolo (Optional-string):
  Stessi dettagli come sopra.
  (Predefinito: 'blogname')

uso

Ottenere e visualizzare automaticamente Classi: get_body_class () & body_class ()

Questi tag template molto popolari generano classi semantiche e ci consentono di echo o di restituirli. Ci permettono anche di aggiungere nomi di classe aggiuntivi.

parametri

Entrambi i tag modello accettano solo un parametro:

• $ classe (stringa opzionale o array):
  Nomi di classi CSS aggiuntivi da aggiungere.
  (Predefinito: vuoto)

uso

Ottenere e visualizzare un menu di navigazione: wp_nav_menu ()

Questo tag modello restituisce o visualizza i menu di navigazione, una caratteristica fondamentale di WordPress. Puoi vedere questo tag modello in probabilmente tutti i nuovi temi di WordPress pubblicati nel 2013 o successivi.

parametri

Questo tag modello accetta solo un parametro:

• $ args (Opzionale-array):
  Una matrice dei seguenti argomenti:
  • 'menu' (stringa): ID, slug o nome del menu.
    (Predefinito: vuoto)
  • 'Menu_class' (stringa): classe CSS del UL elemento del menu.
    (Predefinito: 'menu')
  • 'Menu_id' (stringa): l'ID del UL elemento del menu.
    (Predefinito: menu slug, incrementato)
  • 'contenitore' (stringa): se avvolgere il UL, e con cosa avvolgerlo.
    (Predefinito: DIV)
  • 'Container_class' (stringa): classe CSS dell'elemento wrapper.
    (Predefinito: 'menu- menu slug -container')
  • 'Container_id' (stringa): l'ID dell'elemento wrapper.
    (Predefinito: vuoto)
  • 'Fallback_cb' (callback o booleano): nome di una funzione di fallback da eseguire se il menu non esiste. Impostato su false per nessun fallback.
    (Predefinito: 'Wp_page_menu')
  • 'prima' (stringa): testo prima del testo del collegamento.
    (Predefinito: vuoto)
  • 'dopo' (stringa): testo dopo il testo del collegamento.
    (Predefinito: vuoto)
  • 'Link_before' (stringa): testo prima del collegamento.
    (Predefinito: vuoto)
  • 'Link_after' (stringa): testo dopo il collegamento.
    (Predefinito: vuoto)
  • 'eco' (booleano): se eseguire o meno il tag del modello o meno.
    (Predefinito: VERO)
  • 'profondità' (numero intero): quanti livelli della gerarchia devono essere inclusi.
    (Predefinito: 0, che significa tutti i livelli)
  • 'camminatore' (oggetto): istanza di una classe di walker personalizzata.
    (Predefinito: vuoto)
  • 'Theme_location' (stringa): posizione del tema da utilizzare. Deve essere registrato con register_nav_menu () per poter essere selezionato dall'utente.
    (Predefinito: vuoto)
  • 'Items_wrap' (stringa): come devono essere avvolti gli elementi dell'elenco.
    (Predefinito:
    % 3 $ s
    )

uso

 "primary-nav", "link_before" => "',' theme_location '=>' primario '); wp_nav_menu ($ args); ?>

Ottenere e visualizzare titoli di pagina: wp_title ()

Questo tag modello restituisce o echeggia il titolo della pagina delle tue pagine.

parametri

Questo tag modello accetta tre parametri:

• $ settembre (Optional-string):
  Il testo da utilizzare come separatore.
  (Predefinito: '"')
• $ echo (Optional-booleano):
  Sia per echo (VERO) o ritorno (FALSE) il tag.
  (Predefinito: VERO)
• $ seplocation (Optional-string):
  Posizione del separatore e direzione del pangrattato. Impostalo su 'right' per invertire il breadcrumb.
  (Predefinito: vuoto)

uso

Ottenere e visualizzare l'URL della home page: get_home_url () & HOME_URL ()

Questi tag modello restituiscono semplicemente l'URL principale.

parametri

get_home_url () accetta tre parametri:

• $ blog_id (Opzionale-intero):
  L'ID del blog.
  (Predefinito: NULLO)
• $ path (Optional-string):
  Percorso facoltativo da aggiungere all'URL.
  (Predefinito: vuoto)
• schema di $ (Optional-string):
  Schema per fornire il contesto dell'URL di casa ("http", "https" o "relativo").
  (Predefinito: NULLO)

E HOME_URL () accetta due parametri:

• $ path (Optional-string):
  Percorso facoltativo da aggiungere all'URL.
  (Predefinito: vuoto)
• schema di $ (Optional-string):
  Schema per fornire il contesto dell'URL di casa ("http", "https" o "relativo").
  (Predefinito: NULLO)

Non confondere queste due funzioni come "uno restituisce l'output e l'altro lo visualizza" -So che l'ho fatto. La differenza è un po 'strana: mentre il get_home_url () funzione restituisce l'URL della home page di un blog specifico, il HOME_URL () funzione restituisce l'URL della home di sito attuale. Ricorda: nessuno di loro fa eco a nulla!

uso

Ottenere e visualizzare l'URL del sito: get_site_url () & indirizzo del sito()

Questi tag di modello ottengono ed echo "l'URL del sito", l'indirizzo in cui è installato WordPress.

parametri

get_site_url () accetta tre parametri:

• $ blog_id (Opzionale-intero):
  L'ID del blog.
  (Predefinito: sito corrente)
• $ path (Optional-string):
  Percorso facoltativo da aggiungere all'URL.
  (Predefinito: vuoto)
• schema di $ (Optional-string):
  Schema per fornire il contesto dell'URL di casa ("http", "https" o "relativo").
  (Predefinito: connessione normale o sicura, a seconda di is_ssl ())

E indirizzo del sito() accetta due parametri:

• $ path (Optional-string):
  Percorso facoltativo da aggiungere all'URL.
  (Predefinito: vuoto)
• schema di $ (Optional-string):
  Schema per fornire il contesto dell'URL di casa ("http", "https" o "relativo").
  (Predefinito: connessione normale o sicura, a seconda di is_ssl ())

Come con HOME_URL () e get_home_url (), non confondere queste due funzioni come "uno restituisce l'output e l'altro lo visualizza". Mentre il get_site_url () funzione restituisce URL del sito di un blog specifico, il indirizzo del sito() funzione restituisce l'URL del sito del sito attuale. Ricorda: nessuno di loro fa eco a nulla!

uso

Ottenere l'ID del sito attuale: get_current_blog_id ()

Questo tag template restituisce semplicemente l'ID del sito corrente in una rete Multisite.

parametri

Questo tag modello non accetta alcun parametro.

uso

Ottenere e visualizzare l'URL del pannello di amministrazione: get_admin_url () & ADMIN_URL ()

Questi tag modello restituiscono e visualizzano un URL della Dashboard del tuo sito web.

parametri

get_admin_url () accetta tre parametri:

• $ blog_ID (Opzionale-intero):
  L'ID del blog.
  (Predefinito: sito corrente)
• $ path (Optional-string):
  Percorso facoltativo da aggiungere all'URL.
  (Predefinito: vuoto)
• schema di $ (Optional-string):
  Lo schema da usare. 'admin' rispetta lo schema definito (con il is_ssl () funzione) ma puoi sovrascriverlo impostando questo parametro. Accetta "http", "https", "admin", "rpc", "login" e "login_post".
  (Predefinito: 'admin')

E ADMIN_URL () accetta due parametri:

• $ path (Optional-string):
  Percorso facoltativo da aggiungere all'URL.
  (Predefinito: vuoto)
• schema di $ (Optional-string):
  Lo schema da usare. 'admin' rispetta lo schema definito (con il is_ssl () funzione) ma puoi sovrascriverlo impostando questo parametro su "http" o "https".
  (Predefinito: 'admin')

uso

Ottenere e visualizzare il collegamento permanente di un tipo di alimentazione: get_feed_link () & the_feed_link ()

Questi tag modello restituiscono e restituiscono il permalink di un feed.

parametri

get_feed_link () accetta solo un parametro:

• $ feed_type (Optional-string):
  Tipo di mangime.
  (Predefinito: tipo di feed predefinito)

E the_feed_link () accetta due parametri:

• $ ancoraggio (Obbligatorio-stringa):
  Testo da visualizzare per il collegamento.
  (Predefinito: NULLO)
• $ feed_type (Optional-string):
  Tipo di mangime.
  (Predefinito: tipo di feed predefinito)

uso

Rendere lo String End With o Without a Trailing Slash: user_trailingslashit ()

Questo tag modello controlla la struttura del permalink e aggiunge una barra finale o rimuove la barra finale esistente alla fine dell'URL specificato.

parametri

Questo tag modello accetta due parametri:

• $ string (Obbligatorio-stringa):
  L'URL con o senza una barra finale.
  (Predefinito: NULLO)
• $ type_of_url (Deprecato-string):
  Questo non è tecnicamente deprecato, ma non è usato nella funzione, quindi non ha alcun effetto.

uso

Ottenere il numero di giorni dall'inizio della settimana: calendar_week_mod ()

Questo strano tag modello ottiene il numero di giorni dall'inizio della settimana. È fondamentalmente una "operazione modulo".

Onestamente non so come usare questo o perché per usare questo. Se sai perché esiste questo tag modello, scatta un commento per informare me e i nostri lettori!

parametri

Questo tag modello accetta solo un parametro:

• numero di $ (Obbligatorio-intero):
  Giorni dall'inizio della settimana.
  (Predefinito: 0)

uso

Ottenere e visualizzare il calendario: get_calendar ()

Ricorda quei calendari che usavamo inserire nelle barre laterali dei nostri blog? Questo tag modello fa esattamente questo: restituisce o visualizza il calendario.

parametri

Questo tag modello accetta due parametri:

• $ iniziale (Optional-booleano):
  Usa nomi di calendario iniziali (VERO) o no (FALSE).
  (Predefinito: VERO)
• $ echo (Optional-booleano):
  Sia per echo (VERO) o ritorno (FALSE) L'output.
  (Predefinito: VERO)

uso

Conclusione

Spero ti sia piaciuta questa ultima serie di tag modello. Nella parte successiva, il finale della serie, esamineremo ciò che abbiamo imparato e termineremo la serie.

Se hai domande, commenti o correzioni, puoi condividere i tuoi pensieri con noi nella sezione Commenti. E se ti è piaciuto l'articolo, non dimenticare di condividerlo con i tuoi amici!