Tuts + Guide til Template Tags Åttende Batch

I den åttende delen av serien gikk vi gjennom den syvende batchen av WordPress-skabeloner. I denne niende delen skal vi gå gjennom den siste batchen av de nesten 200 malene. Gjennom opplæringen ser vi maltekoder om bokmerker og andre "diverse" maltekoder.

Advarsel om bokmerker: Som i WordPress 3.5, er "bokmerker" gjemt fra administrasjonspanelet som standard. For å jobbe med bokmerker må du installere plugin for koblingsadministrator.

Få og vise en liste med bokmerker: wp_list_bookmarks ()

Denne mal-taggen returnerer eller ekkoer en liste over bokmerker, en gammel funksjon av WordPress.

parametere

Denne mal-taggen aksepterer kun én parameter:

  • $ args (Valgfri-array):
    En rekke av følgende argumenter:
    • 'rekkefølge etter' (streng): Slik bestiller du bokmerkene. Godtar navnet ',' link_id ',' url ',' mål ',' beskrivelse ',' eier '(brukeren som la bokmerket),' rating ',' updated '(oppdateringsdatoer),' rel ' bokmerkeforhold), 'notater', 'rss', 'lengde' (lengden på bokmerkens navn), 'rand' (tilfeldig).
      (Standard: 'navn')
    • 'rekkefølge' (streng): Om du vil bestille varer i stigende ('ASC') eller nedadgående ('DESC') rekkefølge.
      (Standard: 'ASC')
    • 'grense' (heltall): Antall elementer som skal vises.
      (Standard: -1 som betyr alle bokmerker)
    • 'kategori' (streng): Kommaseparerte kategori ID-er for å få elementer fra.
      (Standard: "som betyr alle kategorier)
    • 'Exclude_category' (streng): Bokmerke kategorier 'IDer å ekskludere.
      (Misligholde:")
    • 'kategori navn' (streng): Et kategorinavn for å vise bokmerker fra (overrides 'kategori').
      (Misligholde:")
    • 'Hide_invisible' (heltall): Enten å skjule usynlige koblinger eller vise dem.
      (Standard: 1)
    • 'Show_updated' (heltall): Om siste oppdaterte tidsstempel skal vises eller ikke.
      (Standard: 0)
    • 'ekko' (heltall): Enten å ekko utgangen (1) eller returnere den (0).
      (Standard: 1)
    • 'Kategorisere' (heltall): Om du vil gruppere bokmerker etter kategorier (1) eller ikke (0).
      (Standard: 1)
    • 'Title_li' (streng): Wraps utgangen med a
    • tag og viser en tittel før bokmerkelisten. Du vil sannsynligvis ønske å sette dette til en tom streng og deaktivere innpakning.
      (Standard: 'Bokmerker')
    • 'Title_before' (streng): HTML kode å legge til før hver tittel.
      (Standard: '

      ')

    • 'Title_after' (streng): HTML kode å legge til etter hver tittel.
      (Standard: '')
    • 'klasse' (streng): CSS klassenavn å legge til i hver kategori.
      (Standard: 'Linkcat')
    • 'Category_before' (streng): HTML kode å legge til før hver kategori.
      (Standard: '
    • ')
    • 'Category_after' (streng): HTML kode å legge til etter hver kategori.
      (Standard: '
    • ')
    • 'Category_orderby' (streng): Slik bestiller du kategoriene. Godtar 'navn', 'id', 'slug' og 'count'.
      (Standard: 'navn')
    • 'Category_order' (streng): Om å bestille kategorier i stigende ('ASC') eller nedadgående ('DESC') rekkefølge.
      (Standard: 'ASC')

bruk

 'rand', // Ta bare 5 bokmerker. 'limit' => 5, // Ta bokmerker fra en bestemt kategori. 'category_name' => 'Venner', // Ikke ekko. 'echo' => 0, // Tilpasset klasse. 'class' => 'venner-bokmerke-liste'); $ bookmarks_list = wp_list_bookmarks ($ args); ?>

Å få et utvalg av alle bokmerker: get_bookmarks ()

Denne mal-taggen returnerer en rekke WordPress-bokmerker.

parametere

Denne mal-taggen aksepterer kun én parameter:

  • $ args (Valgfri-array):
    En rekke av følgende argumenter:
    • 'rekkefølge etter' (streng): Slik bestiller du linkene. Godtar postfelt som navn, ID, tittel, dato og lignende.
      (Standard: 'navn')
    • 'rekkefølge' (streng): Om du vil bestille varer i stigende ('ASC') eller nedadgående ('DESC') rekkefølge.
      (Standard: 'ASC')
    • 'grense' (heltall): Antall elementer som skal vises.
      (Standard: -1 som betyr alt)
    • 'kategori' (streng): Kommaseparerte kategori ID-er for å få elementer fra.
      (Standard: Tom)
    • 'kategori navn' (streng): Kategori navn for å få elementer fra.
      (Standard: Tom)
    • 'Hide_invisible' (heltall eller booleansk): Enten å vise eller skjule koblet merket som "usynlig".
      (Misligholde: 1 | TRUE)
    • 'Show_updated' (heltall eller booleansk): Om du vil vise tiden bokmerket sist ble oppdatert.
      (Misligholde: 0 | FALSE)
    • 'inkludere' (streng): Kommaseparert liste over ID som skal inkluderes.
      (Standard: Tom)
    • 'utelukke' (streng): Kommaseparert liste over IDer som skal utelukkes.
      (Standard: Tom)

bruk

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

Få bokmerke data: get_bookmark ()

Denne mal-taggen returnerer alle dataene i et gitt bokmerke.

parametere

Denne mal-taggen aksepterer tre parametere:

  • $ bokmerke (Påkrevd-blandet):
    Bokmerket ID eller objekt.
    (Misligholde: NULL)
  • $ utgang (Valgfri streng):
    Enten OBJECT, ARRAY_N eller ARRAY_A konstant.
    (Misligholde: GJENSTAND)
  • $ filter (Valgfri streng):
    Enten å unnslippe utgangen eller ikke. Hvis du vil filtrere utgangen, sett dette til 'vise'.
    (Standard: 'rå')

bruk

Å få et enkelt bokmerkefelts data: get_bookmark_field ()

Med denne maltappen kan du hente dataene i et enkelt bokmerkefelt.

parametere

Denne mal-taggen aksepterer tre parametere:

  • $ felt (Kreves streng):
    Navnet på feltet.
    (Misligholde: NULL)
  • $ bokmerke (Påkrevd-heltall):
    Bokmerket ID.
    (Misligholde: NULL)
  • $ sammenheng (Valgfri streng):
    Slik filtrerer du feltverdien - enten 'raw', 'edit', 'attributt', 'js', 'db' eller 'display'.
    (Standard: 'skjerm')

bruk

Å få og vise koblingen "Rediger bokmerke": get_edit_bookmark_link () & edit_bookmark_link ()

Disse malteknappene lar deg få eller ekko et "rediger dette bokmerket" -linken for å bruke i maler.

parametere

get_edit_bookmark_link () aksepterer bare én parameter:

  • $ bookmark_id (Påkrevd-heltall):
    IDen til bokmerket.
    (Standard: 0)

Og edit_bookmark_link () aksepterer fire parametere:

  • $ tekst (Valgfri streng):
    Tekst for å vise linken.
    (Standard: 'Rediger dette')
  • $ før (Valgfri streng):
    Teksten eller HTML-koden som skal vises før utgangen.
    (Standard: Tom)
  • $ etter (Valgfri streng):
    Teksten eller HTML-koden som skal vises etter utgangen.
    (Standard: Tom)
  • $ bookmark_id (Påkrevd-heltall):
    IDen til bokmerket.
    (Misligholde: NULL)

bruk

',''); // Vis et bestemt bokmerke til "rediger bokmerke" -linken. edit_bookmark_link (__ ('Rediger', 'oversettelse-domene'), ",", 98); ?>

Få og vise nettstedet ditt: get_bloginfo () & bloginfo ()

Disse ekstremt populære maltekoder returnerer og viser nettstedets generelle informasjon.

parametere

get_ bloginfo () aksepterer to parametere:

  • $ showet (Valgfri streng):
    Bitt av informasjon for å hente. En av følgende verdier:
    • 'Url' (streng): Hjemmesiden URL.
    • 'Wpurl' (streng): URL-adressen der WordPress er installert.
    • 'beskrivelse' (streng): Nettstedbeskrivelse.
    • 'Rdf_url' (streng): RDF / RSS 1.0 feed URL.
    • 'Rss_url' (streng): RSS 0,92 feed URL.
    • 'Rss2_url' (streng): RSS Feed-nettadressen.
    • 'Atom_url' (streng): Atom-feed-nettadressen.
    • 'Comments_rss2_url' (streng): RSS Feed-nettadressen for kommentarer.
    • 'Comments_atom_url' (streng): Atom-feed-URLen for kommentarer.
    • 'Pingback_url' (streng): URL-adressen til XML-RPC-filen for pingback.
    • 'Stylesheet_url' (streng): Nettadressen til temaets viktigste CSS-fil.
    • 'Stylesheet_directory' (streng): Nettadressen til temaets viktigste CSS-fils katalog.
    • 'Template_directory' eller 'Template_url' (streng): Nettadressen til det aktive temaets katalog.
    • 'Admin_email' (streng): E-postadressen som ble angitt da WordPress ble installert.
    • 'Charset' (streng): Nettstedets tegnsett.
    • 'Html_type' (streng): Innholdstypen for WordPress HTML-sider.
    • 'versjon' (streng): WordPress versjon.
    • 'Språk' (streng): Språk av WordPress-installasjonen.
    • 'Text_direction' (streng): Tekstretning av språket.
    • 'Navn' (streng): Nettstedets navn.
    (Standard: 'navn')
  • $ filter (Valgfri streng):
    Sett den til 'filter' å filtrere nettadressen som returneres fra denne maltappen.
    (Standard: 'rå')

Og bloginfo () aksepterer bare én parameter:

  • $ showet (Valgfri streng):
    Samme detaljer som ovenfor.
    (Standard: 'blomenavn')

bruk

Komme og vise automatisk klasser: get_body_class () & body_class ()

Disse svært populære malmerkene genererer semantiske klasser og lar oss ekko eller returnere dem. De lar oss også legge til flere klassenavn.

parametere

Begge maletikettene godtar bare én parameter:

  • $ class (valgfri streng eller array):
    Ekstra CSS-klassenavn å legge til.
    (Standard: Tom)

bruk

Få og vise en navigasjonsmeny: wp_nav_menu ()

Denne malemerken returnerer eller viser navigasjonsmenyer, en kjernefunksjon i WordPress. Du kan se denne maltappen i sannsynligvis alle nye WordPress-temaer som ble utgitt i 2013 eller senere.

parametere

Denne mal-taggen aksepterer kun én parameter:

  • $ args (Valgfri-array):
    En rekke av følgende argumenter:
    • 'Meny' (streng): ID, slug eller navn på menyen.
      (Standard: Tom)
    • 'Menu_class' (streng): CSS klasse av UL element i menyen.
      (Standard: 'Meny')
    • 'Menu_id' (streng): ID av UL element i menyen.
      (Standard: menysløyfe, økt)
    • 'container' (streng): Enten å pakke inn UL, og hva å pakke det med.
      (Misligholde: DIV)
    • 'Container_class' (streng): CSS klasse av innpakningselementet.
      (Standard: 'meny- menysnakk -container')
    • 'Container_id' (streng): Innpakningselementets ID.
      (Standard: Tom)
    • 'Fallback_cb' (tilbakering eller boolean): Navn på en tilbakekallingsfunksjon for å kjøre hvis menyen ikke eksisterer. Sett til falsk for ingen tilbakebetaling.
      (Misligholde: 'Wp_page_menu')
    • 'før' (streng): Tekst før linkteksten.
      (Standard: Tom)
    • 'etter' (streng): Tekst etter lenketeksten.
      (Standard: Tom)
    • 'Link_before' (streng): Tekst før lenken.
      (Standard: Tom)
    • 'Link_after' (streng): Tekst etter lenken.
      (Standard: Tom)
    • 'ekko' (boolsk): Enten å ekko maltekoden eller ikke.
      (Misligholde: EKTE)
    • 'dybde' (heltall): Hvor mange nivåer av hierarkiet skal inkluderes.
      (Standard: 0, som betyr alle nivåer)
    • 'Walker' (objekt): Tilstedeværelse av en tilpasset walker klasse.
      (Standard: Tom)
    • 'Theme_location' (streng): Temaområde som skal brukes. Må registreres med register_nav_menu () for å kunne velges av brukeren.
      (Standard: Tom)
    • 'Items_wrap' (streng): Hvordan listen elementene skal pakkes inn.
      (Misligholde:
        % 3 $ s
      )

bruk

 'primary-nav', 'link_before' => '',' theme_location '=>' primær '); wp_nav_menu ($ args); ?>

Få og vise sidetitler: wp_title ()

Denne malemerken returnerer eller ekkoer sidetittelen på sidene dine.

parametere

Denne mal-taggen aksepterer tre parametere:

  • $ september (Valgfri streng):
    Teksten som skal brukes som separator.
    (Standard: '' ')
  • $ echo (Valgfri-boolean):
    Enten å ekko (EKTE) eller returnere (FALSK) taggen.
    (Misligholde: EKTE)
  • $ seplocation (Valgfri streng):
    Plassering av separatoren og retningen av breadcrumb. Sett den til "høyre" for å reversere breadcrumb.
    (Standard: Tom)

bruk

Få og vise hjemmesiden URL: get_home_url () & HOME_URL ()

Disse maletikettene returnerer bare hjemmeadressen.

parametere

get_home_url () aksepterer tre parametere:

  • $ blog_id (Valgfri-heltall):
    IDen til bloggen.
    (Misligholde: NULL)
  • $ path (Valgfri streng):
    Valgfri bane for å legge til URL-adressen.
    (Standard: Tom)
  • $ ordningen (Valgfri streng):
    Ordning for å gi hjemmeadressekonteksten ('http', 'https' eller 'relativ').
    (Misligholde: NULL)

Og HOME_URL () aksepterer to parametere:

  • $ path (Valgfri streng):
    Valgfri bane for å legge til URL-adressen.
    (Standard: Tom)
  • $ ordningen (Valgfri streng):
    Ordning for å gi hjemmeadressekonteksten ('http', 'https' eller 'relativ').
    (Misligholde: NULL)

Ikke misforstå disse to funksjonene som "en returnerer utgangen og den andre viser den" -Jeg vet jeg gjorde. Forskjellen er litt rar: Mens get_home_url () funksjon returnerer en bestemt blogg hjemmeadresse, de HOME_URL () funksjonen returnerer hjemmesiden til nåværende nettsted. Husk: Ingen av dem ekko noe!

bruk

Komme og vise nettstedets URL: get_site_url () & site_url ()

Disse malesignalene får og ekko "webadressen", adressen der WordPress er installert.

parametere

get_site_url () aksepterer tre parametere:

  • $ blog_id (Valgfri-heltall):
    IDen til bloggen.
    (Standard: Nåværende side)
  • $ path (Valgfri streng):
    Valgfri bane for å legge til URL-adressen.
    (Standard: Tom)
  • $ ordningen (Valgfri streng):
    Ordning for å gi hjemmeadressekonteksten ('http', 'https' eller 'relativ').
    (Standard: Normal eller sikker tilkobling, avhengig av is_ssl ())

Og site_url () aksepterer to parametere:

  • $ path (Valgfri streng):
    Valgfri bane for å legge til URL-adressen.
    (Standard: Tom)
  • $ ordningen (Valgfri streng):
    Ordning for å gi hjemmeadressekonteksten ('http', 'https' eller 'relativ').
    (Standard: Normal eller sikker tilkobling, avhengig av is_ssl ())

Som med HOME_URL () og get_home_url (), Ikke ta feil i disse to funksjonene som "en returnerer utgangen og den andre viser den". Mens get_site_url () funksjon returnerer en spesifikk blogg nettstedadresse, de site_url () funksjonen returnerer nettstedets URL til nåværende nettsted. Husk: Ingen av dem ekko noe!

bruk

Få gjeldende nettstedets ID: get_current_blog_id ()

Denne malemerken returnerer bare gjeldende nettstedets ID i et Multisite-nettverk.

parametere

Denne mal-taggen aksepterer ikke noen parametere.

bruk

Få og vise nettadressen til administrasjonspanelet: get_admin_url () & admin_url ()

Disse malesignalene returnerer og viser en URL til oversikten på nettstedet ditt.

parametere

get_admin_url () aksepterer tre parametere:

  • $ blog_ID (Valgfri-heltall):
    IDen til bloggen.
    (Standard: Nåværende side)
  • $ path (Valgfri streng):
    Valgfri bane for å legge til URL-adressen.
    (Standard: Tom)
  • $ ordningen (Valgfri streng):
    Ordningen som skal brukes. 'admin' respekterer den definerte ordningen (med is_ssl () funksjon), men du kan overstyre den ved å sette denne parameteren. Godtar 'http', 'https', 'admin', 'rpc', 'login' og 'login_post'.
    (Standard: 'admin')

Og admin_url () aksepterer to parametere:

  • $ path (Valgfri streng):
    Valgfri bane for å legge til URL-adressen.
    (Standard: Tom)
  • $ ordningen (Valgfri streng):
    Ordningen som skal brukes. 'admin' respekterer den definerte ordningen (med is_ssl () funksjon), men du kan overstyre den ved å sette denne parameteren til "http" eller "https".
    (Standard: 'admin')

bruk

Komme og vise på Permalink av en feedtype: get_feed_link () & the_feed_link ()

Disse malesignalene returnerer og utfører permalinken til en feed.

parametere

get_feed_link () aksepterer bare én parameter:

  • $ feed_type (Valgfri streng):
    Type av fôret.
    (Standard: Standard feed type)

Og the_feed_link () aksepterer to parametere:

  • $ anker (Kreves streng):
    Tekst som skal vises for linken.
    (Misligholde: NULL)
  • $ feed_type (Valgfri streng):
    Type av fôret.
    (Standard: Standard feed type)

bruk

Gjør strengen til slutt med eller uten en slash: user_trailingslashit ()

Denne malemerken kontrollerer permalinkstrukturen din, og legger til et slash eller fjerner det eksisterende slashet på slutten av den oppgitte URL-adressen.

parametere

Denne mal-taggen aksepterer to parametere:

  • $ string (Kreves streng):
    Nettadressen med eller uten et skråstrek.
    (Misligholde: NULL)
  • $ type_of_url (Avviklet streng):
    Dette er ikke teknisk sett deprecated, men det er ikke brukt i funksjonen, så det har ingen effekt overhodet.

bruk

Få antall dager siden begynnelsen av uken: calendar_week_mod ()

Denne rare sjablonen får antall dager siden begynnelsen av uken. Det er i utgangspunktet en "modulo operasjon".

Jeg vet ærlig ikke hvordan jeg bruker dette eller Hvorfor å bruke dette. Hvis du vet hvorfor denne mal-taggen eksisterer, skyt en kommentar for å informere meg og våre lesere!

parametere

Denne mal-taggen aksepterer kun én parameter:

  • $ nummer (Påkrevd-heltall):
    Dager siden begynnelsen av uken.
    (Standard: 0)

bruk

Komme og vise kalenderen: get_calendar ()

Husk de kalendere vi pleide å plassere i sidebjørene i våre blogger? Denne malemerken gjør akkurat det: Den returnerer eller viser kalenderen.

parametere

Denne mal-taggen aksepterer to parametere:

  • $ innledende (Valgfri-boolean):
    Bruk innledende kalenderenavn (EKTE) eller ikke (FALSK).
    (Misligholde: EKTE)
  • $ echo (Valgfri-boolean):
    Enten å ekko (EKTE) eller returnere (FALSK) utgangen.
    (Misligholde: EKTE)

bruk

Konklusjon

Håper du likte dette siste partiet med malteiketter. I neste del, seriens finale, skal vi se gjennom hva vi lærte og avslutte serien.

Hvis du har spørsmål, kommentarer eller rettelser, kan du dele tankene dine med oss ​​i kommentarfeltet. Og hvis du likte artikkelen, ikke glem å dele den med vennene dine!