De Tuts + gids voor sjabloontags achtste batch

In het achtste deel van de serie hebben we de zevende reeks WordPress-sjabloonlabels doorgenomen. In dit negende deel gaan we door de laatste batch van de bijna 200 sjabloontags. Gedurende de zelfstudie zien we sjabloontags over bladwijzers en andere, 'diverse' sjabloontags.

Waarschuwing over bladwijzers: Vanaf WordPress 3.5 zijn "bladwijzers" standaard verborgen in het admin-paneel. Om met bladwijzers te werken, moet u de Link Manager-plug-in installeren.

Een lijst met bladwijzers krijgen & weergeven: wp_list_bookmarks ()

Deze sjabloon tag retourneert of echoot een lijst met bladwijzers, een oude functie van WordPress.

parameters

Deze sjabloontag accepteert slechts één parameter:

  • $ args (Optioneel array):
    Een array van de volgende argumenten:
    • 'Orderby' (string): Hoe de bladwijzers te bestellen. Accepteert 'name', 'link_id', 'url', 'target', 'description', 'owner' (de gebruiker die de bladwijzer heeft toegevoegd), 'rating', 'updated' (update dates), 'rel' (XFN bladwijzerverhouding), 'opmerkingen', 'rss', 'lengte' (naam van de bladwijzer), 'rand' (willekeurig).
      (Standaard: 'naam')
    • 'bestellen' (string): Of items in oplopende ('ASC') of aflopende ('DESC') volgorde moeten worden besteld.
      (Standaard: 'ASC')
    • 'begrenzing' (integer): aantal weer te geven items.
      (Standaard: -1 wat alle bladwijzers betekent)
    • 'categorie' (string): Door komma's gescheiden categorie-ID's om items van te ontvangen.
      (Standaard: "wat alle categorieën betekent)
    • 'Exclude_category' (tekenreeks): hiermee kunt u categorieën van bladwijzerscategorieën uitsluiten.
      (Standaard:")
    • 'categorie naam' (string): een categorienaam om bladwijzers van te tonen (overschrijft 'categorie').
      (Standaard:")
    • 'Hide_invisible' (integer): of onzichtbare links moeten worden verborgen of weergegeven.
      (Standaard: 1)
    • 'Show_updated' (geheel getal): of de laatst bijgewerkte tijdstempel moet worden weergegeven of niet.
      (Standaard: 0)
    • 'echo' (integer): Of echo van de uitvoer (1) of retourneer het (0).
      (Standaard: 1)
    • 'Categoriseren' (geheel getal): of bladwijzers moeten worden gegroepeerd op categorie (1) of niet (0).
      (Standaard: 1)
    • 'Title_li' (string): Wraps de uitvoer met een
    • label en geeft een titel weer voor de bladwijzerlijst. U zou dit waarschijnlijk op een lege string willen instellen en wrapping uitschakelen.
      (Standaard: 'Bladwijzers')
    • 'Title_before' (string): HTML-code die vóór elke titel moet worden toegevoegd.
      (Standaard: '

      ')

    • 'Title_after' (string): HTML-code die na elke titel moet worden toegevoegd.
      (Standaard: '')
    • 'klasse' (string): CSS-klassenamen om aan elke categorie toe te voegen.
      (Standaard: 'linkcat')
    • 'Category_before' (string): HTML-code die vóór elke categorie moet worden toegevoegd.
      (Standaard: '
    • ')
    • 'Category_after' (string): HTML-code die na elke categorie moet worden toegevoegd.
      (Standaard: '
    • ')
    • 'Category_orderby' (string): Hoe de categorieën te bestellen. Accepteert 'name', 'id', 'slug' en 'count'.
      (Standaard: 'naam')
    • 'Category_order' (string): Of de categorieën in oplopende ('ASC') of aflopende ('DESC') volgorde moeten worden gesorteerd.
      (Standaard: 'ASC')

Gebruik

 'rand', // Neem slechts 5 bladwijzers. 'limit' => 5, // Neem bladwijzers van een specifieke categorie. 'category_name' => 'Vrienden', // niet echo. 'echo' => 0, // Aangepaste klasse. 'class' => 'vrienden-bladwijzer-lijst'); $ bookmarks_list = wp_list_bookmarks ($ args); ?>

Een matrix van alle bladwijzers krijgen: get_bookmarks ()

Deze sjabloontag retourneert een array van uw WordPress-bladwijzers.

parameters

Deze sjabloontag accepteert slechts één parameter:

  • $ args (Optioneel array):
    Een array van de volgende argumenten:
    • 'Orderby' (string): Hoe de links te bestellen. Accepteert postvelden zoals 'naam', 'ID', 'titel', 'datum', enz.
      (Standaard: 'naam')
    • 'bestellen' (string): Of items in oplopende ('ASC') of aflopende ('DESC') volgorde moeten worden besteld.
      (Standaard: 'ASC')
    • 'begrenzing' (integer): aantal weer te geven items.
      (Standaard: -1 wat allemaal betekent)
    • 'categorie' (string): Door komma's gescheiden categorie-ID's om items van te ontvangen.
      (Standaard: leeg)
    • 'categorie naam' (string): Categorienaam om items van te ontvangen.
      (Standaard: leeg)
    • 'Hide_invisible' (integer of boolean): Of koppelingen gemarkeerd als "onzichtbaar" worden weergegeven of verborgen.
      (Standaard: 1 | TRUE)
    • 'Show_updated' (integer of Boolean): Geeft aan of de bladwijzer voor het laatst is bijgewerkt.
      (Standaard: 0 | VALSE)
    • 'Onder meer' (string): door komma's gescheiden lijst van ID's die moeten worden opgenomen.
      (Standaard: leeg)
    • 'uitsluiten' (string): door komma's gescheiden lijst van ID's om uit te sluiten.
      (Standaard: leeg)

Gebruik

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

Bookmark-gegevens verkrijgen: get_bookmark ()

Deze sjabloon tag retourneert alle gegevens van een bepaalde bladwijzer.

parameters

Deze sjabloontag accepteert drie parameters:

  • $ bookmark (Verplicht gemengd):
    De bladwijzer-ID of het object.
    (Standaard: NUL)
  • $ uitgang (Optioneel-string):
    Ofwel OBJECT, ARRAY_N, of ARRAY_A constant.
    (Standaard: VOORWERP)
  • $ filter (Optioneel-string):
    Of je aan de uitgang ontsnapt of niet. Als u de uitvoer wilt filteren, stelt u deze in op 'weergeven'.
    (Standaard: 'onbewerkt')

Gebruik

Gegevens van een enkele bladwijzer opvragen: get_bookmark_field ()

Met deze sjabloontag kunt u de gegevens van het veld van een enkele bladwijzer ophalen.

parameters

Deze sjabloontag accepteert drie parameters:

  • $ veld (Required-string):
    De naam van het veld.
    (Standaard: NUL)
  • $ bookmark (Required-integer):
    De bladwijzer-ID.
    (Standaard: NUL)
  • $ context (Optioneel-string):
    Hoe de veldwaarde te filteren-hetzij 'onbewerkt', 'bewerken', 'attribuut', 'js', 'db' of 'weergave'.
    (Standaard: 'display')

Gebruik

De link 'Link bewerken' weergeven en weergeven: get_edit_bookmark_link () & edit_bookmark_link ()

Met behulp van deze sjabloonlabels kunt u een link 'bewerken van deze bladwijzer' weergeven of herhalen voor gebruik in uw sjablonen.

parameters

get_edit_bookmark_link () accepteert slechts één parameter:

  • $ bookmark_id (Required-integer):
    De ID van de bladwijzer.
    (Standaard: 0)

En edit_bookmark_link () accepteert vier parameters:

  • $ text (Optioneel-string):
    Tekst om de link weer te geven.
    (Standaard: 'Bewerk dit')
  • $ vóór (Optioneel-string):
    De tekst- of HTML-code die vóór de uitvoer wordt weergegeven.
    (Standaard: leeg)
  • $ na (Optioneel-string):
    De tekst- of HTML-code die na de uitvoer wordt weergegeven.
    (Standaard: leeg)
  • $ bookmark_id (Required-integer):
    De ID van de bladwijzer.
    (Standaard: NUL)

Gebruik

',''); // Geef de link 'bladwijzer bewerken' van een specifieke bladwijzer weer. edit_bookmark_link (__ ('Bewerken', 'vertaaldomein'), ",", 98); ?>

Informatie over uw site verkrijgen en weergeven: get_bloginfo () & bloginfo ()

Deze extreem populaire sjabloontags retourneren en geven de algemene informatie van uw site weer.

parameters

get_ bloginfo () accepteert twee parameters:

  • $ tonen (Optioneel-string):
    Het beetje informatie dat moet worden opgehaald. Een van de volgende waarden:
    • 'Url' (string): de thuis-URL.
    • 'Wpurl' (string): de URL waar WordPress is geïnstalleerd.
    • 'Omschrijving' (string): Sitebeschrijving.
    • 'Rdf_url' (string): de RDF / RSS 1.0-feed-URL.
    • 'Rss_url' (string): de RSS 0.92 feed-URL.
    • 'Rss2_url' (string): de RSS 2.0-feed-URL.
    • 'Atom_url' (string): de Atom-feed-URL.
    • 'Comments_rss2_url' (string): de RSS 2.0-feed-URL voor opmerkingen.
    • 'Comments_atom_url' (string): de Atom-feed-URL voor opmerkingen.
    • 'Pingback_url' (string): de URL van het pingback XML-RPC-bestand.
    • 'Stylesheet_url' (string): de URL van het belangrijkste CSS-bestand van het thema.
    • 'Stylesheet_directory' (string): de URL van de directory van het hoofd-CSS-bestand van het thema.
    • 'Template_directory' of 'Template_url' (string): de URL van de directory van het actieve thema.
    • 'ADMIN_EMAIL' (string): het e-mailadres dat is ingevoerd toen WordPress werd geïnstalleerd.
    • 'Charset' (string): tekenset van site.
    • 'Html_type' (string): het inhoudstype van WordPress HTML-pagina's.
    • 'versie' (string): WordPress-versie.
    • 'taal' (string): Taal van de WordPress-installatie.
    • 'tekstrichting' (string): tekstrichting van de taal.
    • 'naam' (string): Sitenaam.
    (Standaard: 'naam')
  • $ filter (Optioneel-string):
    Zet het op 'filter' om de URL te filteren die wordt geretourneerd van deze sjabloontag.
    (Standaard: 'onbewerkt')

En bloginfo () accepteert slechts één parameter:

  • $ tonen (Optioneel-string):
    Dezelfde details als hierboven.
    (Standaard: 'blognaam')

Gebruik

Automatisch ophalen en weergeven Klassen: get_body_class () & body_class ()

Deze zeer populaire sjabloonlabels genereren semantische klassen en laten ons echoën of retourneren. Ze laten ons ook extra klassenamen toevoegen.

parameters

Beide sjabloontags accepteren slechts één parameter:

  • $ klasse (optioneel-string of array):
    Extra CSS-klassenamen om toe te voegen.
    (Standaard: leeg)

Gebruik

Een navigatiemenu weergeven en weergeven: wp_nav_menu ()

Deze sjabloontag retourneert of geeft navigatiemenu's weer, een hoofdkenmerk van WordPress. U kunt deze sjabloontag zien in - waarschijnlijk - alle nieuwe WordPress-thema's die in 2013 of later zijn uitgebracht.

parameters

Deze sjabloontag accepteert slechts één parameter:

  • $ args (Optioneel array):
    Een array van de volgende argumenten:
    • 'menu' (string): De ID, slug of naam van het menu.
      (Standaard: leeg)
    • 'Menu_class' (string): CSS-klasse van de UL element van het menu.
      (Standaard: 'menu')
    • 'Menu_id' (string): De ID van de UL element van het menu.
      (Standaard: menu slug, opgehoogd)
    • 'houder' (string): Of de UL, en wat te verpakken.
      (Standaard: DIV)
    • 'Container_class' (string): CSS-klasse van het wrapper-element.
      (Standaard: 'menu- menu slug -container')
    • 'Container_id' (string): De ID van het wrapper-element.
      (Standaard: leeg)
    • 'Fallback_cb' (callback of boolean): Naam van een fallback-functie die moet worden uitgevoerd als het menu niet bestaat. Stel in op false voor geen fallback.
      (Standaard: 'Wp_page_menu')
    • 'voor' (string): tekst vóór de linktekst.
      (Standaard: leeg)
    • 'na' (string): tekst na de koppelingstekst.
      (Standaard: leeg)
    • 'Link_before' (string): tekst vóór de link.
      (Standaard: leeg)
    • 'Link_after' (string): tekst na de link.
      (Standaard: leeg)
    • 'echo' (boolean): Of de sjabloontag moet worden geëchayd of niet.
      (Standaard: TRUE)
    • 'diepte' (integer): Hoeveel niveaus van de hiërarchie moeten worden opgenomen.
      (Standaard: 0, wat alle niveaus betekent)
    • 'Walker' (object): Exemplaar van een aangepaste Walker-klasse.
      (Standaard: leeg)
    • 'Theme_location' (string): te gebruiken themapositie. Moet worden geregistreerd met register_nav_menu () om door de gebruiker te kunnen worden geselecteerd.
      (Standaard: leeg)
    • 'Items_wrap' (string): hoe de lijstitems moeten worden ingepakt.
      (Standaard:
        % 3 $ s
      )

Gebruik

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

Paginatitels verkrijgen en weergeven: wp_title ()

Deze sjabloontag retourneert of echoot de paginatitel van uw pagina's.

parameters

Deze sjabloontag accepteert drie parameters:

  • $ september (Optioneel-string):
    De tekst die als scheidingsteken moet worden gebruikt.
    (Standaard: '"')
  • $ echo (Optionele booleaanse):
    Of echo (TRUE) of terugkeren (VALSE) het etiket.
    (Standaard: TRUE)
  • $ seplocation (Optioneel-string):
    Positie van de scheider en richting van het broodkruim. Zet het op 'rechts' om de broodkruimel om te keren.
    (Standaard: leeg)

Gebruik

De start-URL verkrijgen en weergeven: get_home_url () & HOME_URL ()

Met deze sjabloontags wordt gewoon de thuis-URL geretourneerd.

parameters

get_home_url () accepteert drie parameters:

  • $ blog_id (Optioneel geheel getal):
    De ID van de blog.
    (Standaard: NUL)
  • $ path (Optioneel-string):
    Optioneel pad om toe te voegen aan de URL.
    (Standaard: leeg)
  • $ regeling (Optioneel-string):
    Regeling om de context van de home-url te geven ('http', 'https' of 'relative').
    (Standaard: NUL)

En HOME_URL () accepteert twee parameters:

  • $ path (Optioneel-string):
    Optioneel pad om toe te voegen aan de URL.
    (Standaard: leeg)
  • $ regeling (Optioneel-string):
    Regeling om de context van de home-url te geven ('http', 'https' of 'relative').
    (Standaard: NUL)

Vergis je niet aan deze twee functies als "de ene geeft de uitvoer en de andere geeft deze weer" - ik weet het wel. Het verschil is een beetje raar: hoewel het get_home_url () functie retourneert de URL van een specifieke blog, de HOME_URL () functie retourneert de persoonlijke URL van de huidige site. Onthoud: geen van beiden echoot iets!

Gebruik

De site-URL ophalen en weergeven: get_site_url () & SITE_URL ()

Deze sjabloontags krijgen en geven de echo van de "site-URL", het adres waar WordPress is geïnstalleerd.

parameters

get_site_url () accepteert drie parameters:

  • $ blog_id (Optioneel geheel getal):
    De ID van de blog.
    (Standaard: Huidige site)
  • $ path (Optioneel-string):
    Optioneel pad om toe te voegen aan de URL.
    (Standaard: leeg)
  • $ regeling (Optioneel-string):
    Regeling om de context van de home-url te geven ('http', 'https' of 'relative').
    (Standaard: normale of beveiligde verbinding, afhankelijk van is_ssl ())

En SITE_URL () accepteert twee parameters:

  • $ path (Optioneel-string):
    Optioneel pad om toe te voegen aan de URL.
    (Standaard: leeg)
  • $ regeling (Optioneel-string):
    Regeling om de context van de home-url te geven ('http', 'https' of 'relative').
    (Standaard: normale of beveiligde verbinding, afhankelijk van is_ssl ())

Zoals met HOME_URL () en get_home_url (), verwar deze twee functies niet als "men retourneert de uitvoer en de ander geeft het weer". Terwijl de get_site_url () functie retourneert de site-URL van een specifieke blog, de SITE_URL () functie retourneert de site-URL van de huidige site. Onthoud: geen van beiden echoot iets!

Gebruik

De ID van de huidige site ophalen: get_current_blog_id ()

Deze sjabloontag retourneert eenvoudig de ID van de huidige site in een multisite-netwerk.

parameters

Deze sjabloontag accepteert geen parameters.

Gebruik

De URL van het beheerdersdashboard ophalen en weergeven: get_admin_url () & admin_url ()

Deze sjabloontags worden geretourneerd en geven een URL van het dashboard van uw website weer.

parameters

get_admin_url () accepteert drie parameters:

  • $ blog_ID (Optioneel geheel getal):
    De ID van de blog.
    (Standaard: Huidige site)
  • $ path (Optioneel-string):
    Optioneel pad om toe te voegen aan de URL.
    (Standaard: leeg)
  • $ regeling (Optioneel-string):
    Het schema om te gebruiken. 'admin' respecteert de gedefinieerde regeling (met de is_ssl () functie) maar u kunt dit overschrijven door deze parameter in te stellen. Accepteert 'http', 'https', 'admin', 'rpc', 'login' en 'login_post'.
    (Standaard: 'admin')

En admin_url () accepteert twee parameters:

  • $ path (Optioneel-string):
    Optioneel pad om toe te voegen aan de URL.
    (Standaard: leeg)
  • $ regeling (Optioneel-string):
    Het schema om te gebruiken. 'admin' respecteert de gedefinieerde regeling (met de is_ssl () functie) maar u kunt dit overschrijven door deze parameter in te stellen op 'http' of 'https'.
    (Standaard: 'admin')

Gebruik

De Permalink van een Feed Type verkrijgen en weergeven: get_feed_link () & the_feed_link ()

Deze sjabloontags retourneren en voeren de permalink van een feed uit.

parameters

get_feed_link () accepteert slechts één parameter:

  • $ feed_type (Optioneel-string):
    Type van de feed.
    (Standaard: standaard feedtype)

En the_feed_link () accepteert twee parameters:

  • $ anker (Required-string):
    Tekst die moet worden weergegeven voor de link.
    (Standaard: NUL)
  • $ feed_type (Optioneel-string):
    Type van de feed.
    (Standaard: standaard feedtype)

Gebruik

De snaar laten eindigen met of zonder een slepende Slash: user_trailingslashit ()

Deze sjabloontag controleert uw permalink-structuur en voegt een slash toe of verwijdert de bestaande slash aan het einde van de gegeven URL.

parameters

Deze sjabloontag accepteert twee parameters:

  • $ string (Required-string):
    De URL met of zonder een schuine streep.
    (Standaard: NUL)
  • $ type_of_url (Verouderd-string):
    Dit is het niet technisch gezien verouderd, maar het wordt niet gebruikt in de functie, dus het heeft helemaal geen effect.

Gebruik

Aantal dagen krijgen sinds het begin van de week: calendar_week_mod ()

Deze vreemde sjabloontag krijgt een aantal dagen sinds het begin van de week. Het is eigenlijk een "modulo-operatie".

Ik weet eerlijk gezegd niet hoe ik dit moet gebruiken of waarom om dit te gebruiken. Als u weet waarom deze sjabloontag bestaat, maakt u een opmerking om mij en onze lezers hiervan op de hoogte te stellen!

parameters

Deze sjabloontag accepteert slechts één parameter:

  • $ number (Required-integer):
    Dagen sinds het begin van de week.
    (Standaard: 0)

Gebruik

De kalender ophalen en weergeven: get_calendar ()

Weet je nog die agenda's die we in de zijbalken van onze blogs hebben geplaatst? Deze sjabloontoets doet precies dat: het retourneert of geeft de kalender weer.

parameters

Deze sjabloontag accepteert twee parameters:

  • $ aanvankelijke (Optionele booleaanse):
    Gebruik de oorspronkelijke kalendernamen (TRUE) of niet (VALSE).
    (Standaard: TRUE)
  • $ echo (Optionele booleaanse):
    Of echo (TRUE) of terugkeren (VALSE) het resultaat.
    (Standaard: TRUE)

Gebruik

Conclusie

Ik hoop dat je deze laatste batch met sjabloontags leuk vond. In het volgende deel, de seriefinale, gaan we bekijken wat we hebben geleerd en de serie beëindigen.

Als u vragen, opmerkingen of correcties hebt, kunt u uw mening met ons delen in het gedeelte Opmerkingen. En als je het artikel leuk vond, vergeet dan niet om het met je vrienden te delen!