Share
WordPress tilbyr Quick Edit-skjemaet for å administrere informasjon om taksonomikonfigurasjon? som er flott, men hva om du vil redigere mer enn bare ditt termnavn og slug? Denne opplæringen vil forklare hvordan du utvider denne fantastiske WordPress-funksjonen for å oppdatere mer enn det grunnleggende.
Hurtigredigeringsfunksjonen i WordPress er et enkelt verktøy som brukes til å tillate brukere å redigere datastyper tilknyttet innlegg, sider og vilkår uten å måtte gå til en egen side før du redigerer dataene. Bruken av Quick Edit er allestedsnærværende gjennom WordPress, og denne opplæringen vil lære leserne hvordan du kan utnytte kraften til denne funksjonen til bruk med taksonomi. Etter at du har arbeidet gjennom de følgende fem trinnene, vil du kunne legge til mettdata for taksonomiderminalen via Quick Edit-panelet i WordPress.
For å demonstrere hvordan man legger til meta-data for taksonomi med Quick Edit, vil jeg jobbe gjennom et eksempel på å legge metadata til vilkår i en "president" -tariff i sammenheng med et plugin. For dette eksempelet vil hovedmålet være å knytte to stykker metadata til hver presidentens taksonomi: startdato og sluttdato. En president-taksonomi kan være nyttig for en politisk blogger som ønsker å kategorisere innlegg fra presidenter som diskuteres.
For dette eksempelet vil jeg opprette et plugin som bruker følgende katalog- og filstruktur:
Hovedmappen "rask redigering" skal plasseres i plugin-mappen som skal brukes som et plugin. Lag denne filstrukturen for å forberede resten av opplæringen. Hvis det gjøres riktig, bør filstrukturen se ut som følgende bilde.
For å sikre at WordPress gjenkjenner pluginet som et plugin, må informasjonen om standard plugin header bli lagt til. Hvis du legger til følgende kommentar øverst på "quick-edit.php", tillater pluginet å bli gjenkjent av WordPress.
Etter at du har lagt til headerinformasjonen, aktiver pluginet via WordPress Plugins-siden. Eksemplet plugin er alt oppsett og klar til å gå for resten av opplæringen.
Før du hopper til å legge til Quick Edit-skjemaet, må president-taksonomien registreres, og WordPress må være forberedt på å håndtere termen metadata. Registrering av egendefinerte taksonomier vil ikke bli dekket i denne opplæringen i dybden ettersom den har blitt omhyggelig behandlet på andre steder. For det nåværende eksempelet må en "president" taksonomi registreres. Denne operasjonen vil bli fullført med "register_taxonomy" -funksjonen.
Accentsconagua
funksjon my_taxonomies () // Legg til ny taksonomi, gjør den hierarkisk (som kategorier) $ labels = array ('name' => _x ('Presidents', 'taxonomy generell navn', 'my_plugin'), 'singular_name' => _x ('President', 'Taxonomy singular name', 'my_plugin'), 'search_items' => __ ('Search Presidents', 'my_plugin'), 'all_items' => __ ('Alle presidenter', 'my_plugin') , 'parent_item' => __ ('Foreldrepresident', 'my_plugin'), 'parent_item_colon' => __ ('Foreldrepresident:', 'my_plugin'), 'edit_item' => __ ('Rediger President', 'my_plugin '),' update_item '=> __ (' Oppdater president ',' my_plugin '),' add_new_item '=> __ (' Legg til ny president ',' my_plugin '),' new_item_name '=> __ , 'my_plugin'), 'menu_name' => __ ('Presidents', 'my_plugin')); register_taxonomy ('president', array ('post'), array ('hierarkisk' => sant, 'etiketter' => $ etiketter, 'show_ui' => true, 'query_var' => true, 'rewrite' => array ('slug' => 'president'))); add_action ('init', 'my_taxonomies', 10, 1); Denne kodestykket oppretter en ny egendefinert taksonomi av typen "president". Taksonomien er spesifisert for å arbeide med posttype "post" og er en hierarkisk taksonomi som ligner den innebygde "kategorien" taksonomi. For å få ting startet, fylle presidens taksonomi med de tre siste amerikanske presidenter:
Hvis alt har gått riktig på dette punktet, bør du ha en lenke for "Presidents" under "Posts" -menyen, og du bør ha et termelliste tabell som ser ut som følgende bilde.
Selv om dette arbeidet ikke har gjort noe i forhold til oppgaven med å aktivere Quick Edit for term meta data, har den oppsett en taksonomi for å jobbe med i dette eksemplet.
Den neste oppgaven er å forberede WordPress til å håndtere begrepet metadata. I WordPress 2.9 ble et sett med nyttige funksjoner lagt til i WordPress-kjerne som lagde det meste av grunnlaget for meta-metoden. Funksjonene "add_metadata", "update_metadata" og "get_metadata" aktiverte en enkel metode for å administrere term meta; Disse funksjonene gir imidlertid bare en del av løsningen. For å legge til term meta må man først legge til et bord i WordPress-databasen for disse funksjonene for å administrere dataene.
Heldigvis har Jacob Goldman skrevet et flott plugin, Simple Term Meta, som håndterer denne oppgaven, og gir utviklere nyttige funksjoner (for eksempel "add_term_meta", "update_term_meta", "get_term_meta") for å håndtere term meta management. I hovedsak legger dette plugin en meta-data API til taksonomi med WordPress-systemet. Som Mr. Goldman sier det:
"WordPress tilbyr metadatastøtte for innlegg, brukere og kommentarer ut av boksen. Men det mangler meta-støtte for taksonomi-vilkårene (en tag, kategori eller egendefinerte taksonomiske vilkår)! Denne plugin-modulen legger til full, effektiv støtte for term meta basert på postmeta-rammeverket som er innebygd i WordPress. Legger til et "postmeta" -bord, og legger til meta-funksjoner som skal være kjent for alle som har jobbet med WordPress post-meta. "
For dette eksempelet må dette pluginet installeres for å kunne arbeide med term meta. Før du fortsetter, sørg for å laste ned og installere Simple Term Meta. Med dette pluginet installert, er det på tide å begynne å kode hurtigreparasjonsskjemaet.
"For en utvidet diskusjon om hvordan man administrerer begrepet meta ved hjelp av Simple Term Meta og opprette et brukergrensesnitt for å legge til og redigere metonomiske data for metoden for taksonomi, vennligst se artikkelen 'Legge til metadata i taksonomiske vilkår'."
I det forrige bildet av presidentens taksonomi-side, merk at det er fire kolonner i begrepet listetabell: Navn, Beskrivelse, Slug og Innlegg. Til slutt vil vår plugin legge til en startdato og sluttdato for hver president. Som med andre terminsdata, bør startdato og sluttdato vises i denne tabellen. Dette målet kan enkelt oppnås med noen få WordPress-filtre.
Først av alt blir overskriftene lagt til
funksjon my_column_header ($ kolonner) $ kolonner ['start-date'] = __ ('Startdato', 'my_plugin'); $ kolonner ['sluttdato'] = __ ('sluttdato', 'my_plugin'); returnere $ kolonner; add_filter ('manage_edit-president_columns', 'my_column_header', 10, 1); Bruker administrere _ $ skjermen-> id _columns filter, to ekstra kolonner blir lagt til termen listetabellen. De administrere _ $ skjermen-> id _columns filteret sender ett argument til tilbakeringingsfunksjonen my_column_header. Dette argumentet $ kolonner er en rekke kolonner for den nåværende skjermen.
Ved å legge til elementer i matrisen, og returnere det, vil nye kolonner bli lagt til begrepet listetabellen. Filteret administrere _ $ skjermen-> id _columns er et variabelt filter ved at det faktiske navnet på filteret endres avhengig av hvilken skjerm som vises. Når man ser på en taksonomistyringsside, begynner den variable delen av filteret med "rediger" og slutter med navnet på den aktuelle taksonomien. Siden vi legger til presidentens taksonomi, er denne verdien "president", som ble angitt når taksonomien ble opprinnelig definert. Bruk følgende filtre for standard WordPress-taksonomier:
Nå som kolonnene er lagt til, må kolonnene være forberedt på å vise termen meta for de enkelte vilkårene, som oppnås med neste kodestykke.
funksjon my_column_value ($ empty = ", $ custom_column, $ term_id) return esc_html (get_term_meta ($ term_id, $ custom_column, true)); add_filter ('manage_president_custom_column', 'my_column_value', 10, 3); Begrepet meta verdier er lagt til av administrere _ $ screen> taksonomi _custom_column filter. Den variable delen av dette filteret refererer til dagens taksonomi, som i dette tilfellet er "president". De administrere _ $ screen> taksonomi _custom_column filter aksepterer tre argumenter:
$ tom: Et utdatert argument som skal stå tomt$ custom_column: navnet på den nåværende kolonnen (f.eks. "startdato", "sluttdato")$ term_id: ID for dagens taksonomiDe to siste argumentene brukes til å finne verdien av termen meta verdi av interesse. Senere i opplæringen vil "startdato" og "sluttdato" bli lagt til databasen ved hjelp av add_term_meta Funksjon fra termen meta API levert av Simple Term Meta plugin. Verdiene lagres med tastene "startdato" og "sluttdato". De get_term_meta funksjonen tar nøkkelen og termen id som argumenter for å finne riktig meta verdi.
Åpenbart har $ term_id sendt til my_column_value funksjon er begrepet id nødvendig og brukes dermed til $ term_id argumentet i get_term_meta funksjon. Heldigvis, i dette tilfellet, $ kolonne variabel er identisk med nøkkelen for begrepet meta. Som sådan blir den brukt som det andre argumentet i get_term_meta funksjon.
Til slutt, anropet til get_term_meta funksjonen er pakket inn i esc_html funksjon, som er en grunnleggende WordPress formatering funksjon som rømmer HTML på skjermen.
På dette tidspunktet i opplæringen vil denne koden returnere en tom streng fordi ingen term meta ennå ikke er angitt. Når disse datoene er lagt til, vises de i riktig rekkefølge og kolonne i begrepet listetabellen. Med de to foregående snittene legges begrepet listetabellen i gang.
Nå som kolonnene er angitt, er det på tide å legge til Quick Edit-skjemaet i forberedelse for å legge til termen meta til vilkårene.
Å legge til innhold i Quick Edit-skjemaet er den enkleste delen av denne opplæringen; Det er imidlertid noen mulige fallgruver hvis du ikke er forsiktig. De quick_edit_custom_box handling gjør det enkelt å legge til flere felt i Quick Edit-skjemaet. Følgende funksjon legger til de egendefinerte feltene i Quick Edit-skjemaet
funksjon my_quick_edit_custom_box ($ column_name, $ skjerm, $ navn) if ($ name! = 'president' && ($ column_name! = 'startdato' || $ column_name! = 'sluttdato')) returnere false; ?>
Før du hopper inn i forklaringen av denne funksjonen, klikker du på en av "Quick Edit" -linkene på presidens taksonomi-side. Du bør se noe som ligner på følgende bilde.
Det grunnleggende konseptet med denne funksjonen og handlingen er ganske enkelt. For hver kolonne som legges til via administrere _ $ skjermen-> id _columns filter, quick_edit_custom_box er kalt. Dette tillater at egendefinerte skjemafelter (eller noe innhold for den saks skyld) blir lagt til for hver kolonne som er definert.
Det er viktig å merke seg at hvis du ikke har lagt til noen kolonner i begrepet listetabellen, ville du ikke kunne legge til noe via quick_edit_custom_box handling.
De quick_edit_custom_box aksepterer tre argumenter:
$ kolonne: nøkkelen for verdien (e) lagt til i my_column_header funksjon$ skjermen: den nåværende skjermen$ name: Navn på dagens taksonomiI my_quick_edit_custom_box, bare den $ kolonne og $ name Argumenter benyttes. Først blir det sjekket for at feltene skal skrives ut bare i riktig sammenheng. Hvis den nåværende taksonomien ikke er "president", bør feltene ikke vises.
Deretter skal feltene bare vises når quick_edit_custom_box Handlingen utføres for enten «startdato» eller «sluttdato» -kolonnen. Som sådan kontrollerer den betingede setningen at kolonnen er en av disse to verdiene. Dette trinnet er viktig for å garantere at feltene ikke genereres for uventede kolonner. For eksempel har den innebygde "link_category" taksonomien en ekstra kolonne kalt "lenker". Når du bruker dette filteret på denne taksonomien og ikke sjekker for de spesifikke kolonnene som ble lagt til kolonnelisten, vil et ekstra felt bli skrevet ut. Merk at standardnavnet "navn", "beskrivelse" og "slug" ikke ringer til quick_edit_custom_box.
Nå som riktig kontekst er bekreftet, skrives skjemafeltet ut. Verdien av $ kolonne variabel tillater oss å bestemme sammenhengen mellom gjeldende bruk av quick_edit_custom_box handling.
Som sådan kan det brukes til å sette etiketten og navnefeltet. Siden vår kolonneknapp vil "startdato" og "sluttdato" være det samme som nøklene som brukes for termen meta, $ kolonne
variabel brukes til navnetattributtet i tekstfeltfeltet. Merk at denne funksjonen utføres en gang for hver kolonne som er definert. Første gang det kalles, vil feltet "Startdato" bli generert med riktig etikett. Ved den andre kjøringen blir feltet "Sluttdato" generert med riktig etikett.
For å holde markeringen i samsvar med eksisterende skjema, kopierte jeg bare HTML-koden som ble brukt for standard WordPress-feltene og limte det inn i my_quick_edit_custom_box funksjon. Dette vil gi den resulterende formen et konsekvent utseende. Verdien for feltet er ikke satt til dette punktet.
Dette skjemaet genereres som et "dummy" -skjema som vil bli klonet og plassert hver gang "Quick Edit" -linken klikkes. Når en "Quick Edit" -link er klikket, vil en javascript-funksjon fylle feltet med gjeldende verdi hvis en er satt. Hvis du ser kildekoden for Presidents taksonomi-siden, er Quick Edit-skjemaet nær ved avslutningen Med feltene alle klare til å gå, er neste trinn å lagre verdiene til databasen. Ved å lagre startdato og sluttdato for presidentens vilkår vil det være nødvendig å benytte en funksjon levert av Simple Term Meta, Følgende funksjon lagrer både startdato og sluttdato når termen er oppdatert. Noen ting bør noteres med denne funksjonen. Først av alt, før du sender dataene, kontrollerer funksjonen for å sikre at De Jeg gjør bare veldig grunnleggende data sanitering for å minne leserne om at data sanitisering og validering er svært viktig; Jeg adresserer imidlertid ikke dette problemet her for å fortsette å oppgave og ikke forveksle problemet med komplekse valideringsrutiner. Som sådan anbefaler jeg at du leser noen artikler om problemet hvis du ikke er kjent med validering og sanitisering av data. Bare å legge denne funksjonen til filen, vil ikke fullføre oppgaven med å lagre disse dataene. funksjonen må utføres ved hjelp av en WordPress-krok. Siden ideen er å kjøre denne funksjonen når et begrep er oppdatert, vil Med Før du tar seiersjellet for denne oppgaven, er det viktig å legge merke til at løsningen, som den står, mangler en kritisk bruksfunksjon. Mer spesifikt, for et begrep som har startdato og sluttdato lagt til, blir verdiene ikke fylt i formfeltet når Quick Edit er påkalt. Jeg refererte til dette tidligere i Trinn 3 da jeg uttalt at verdiene for skjemafeltet ikke blir lagt til når skjemaet er opprettet; heller, de er befolket ved hjelp av Javascript når Quick Edit er påkalt. Forutfylling av disse skjemafeltene er et viktig tillegg for brukere som gjør det enklere å oppdatere dataene, spesielt når de skrives ut. For å pre-fylle feltene, vil jQuery bli brukt for å bestemme hvilke verdier som går i hvilke felt. For å få en følelse av hvordan WordPress håndterer standard kolonnene, anbefaler jeg at du tar en titt på "rediger" -metoden i filen "inline-edit-tax-dev.js" som ligger i "wp-admin / js /" WordPress kjerne. Ved å bruke denne koden som en guide utviklet jeg følgende funksjon for å sette inn eksisterende verdier i formfeltene når Quick Edit er påkalt. Legg til denne funksjonen i filen "js / quick-edit.js" som du opprettet i første trinn i opplæringen. La oss gå gjennom denne koden for å forstå hva som skjer. Innenfor anropet til jQuery Når du ser tilbake på den tredje linjen i jQuery-funksjonen, kan man se at når den nåværende forekomsten av Quick Edit-lenken, som har "editinline" -kategorien, klikkes, forsøker funksjonen å finne foreldre tabellraden ( Teksten til det matchede elementet returneres og tilordnes til Hvis du ser tilbake på HTML skrevet for Quick Edit-skjemaet som ble lagt til ved hjelp av Nå som denne funksjonen er skrevet og lagt til i "quick-edit.js" -filen, må den bli avkalket ved hjelp av Denne funksjonen kontrollerer først gjeldende kontekst for å avgjøre om Javascript er nødvendig. Hvis siden er "edit-tags.php", er dagens taksonomi "president", og "handling" -parameteren er ikke angitt (dvs. siden er ikke redigeringssiden), blir Javascript-filen lagt til i skriptene kø. En av de største kjærlighetene blant WordPress-utviklingssamfunnet er ikke oppmerksom på hvor Javascript og CSS-filer blir lagt til. Siden dette skriptet bare er nødvendig når brukeren er på presidents taksonomi siden, blir den bare lagt til da. Resten av funksjonen registrerer skriptet og legger til det ved hjelp av Den nåværende opplæringen lærte deg hvordan du bruker Quick Edit-funksjonen i begrepet listetabellen for å legge til innhold for å redigere termen metadata. Med denne strategien kan du legge til dine egne elementer i Quick Edit-området i ditt neste plugin eller tema. Det bør bemerkes at hvis du bruker Quick Edit, bør du også ha en måte å legge til og redigere felt normalt via sidene for tillegg og redigering av taksonomi. Du kan finne noen gode opplæringsprogrammer om dette emnet, og kombinere din kunnskap som er oppnådd i denne opplæringen, for å skape en utmerket og brukbar måte for brukerne å administrere taksonomi term meta data. Til slutt vil jeg gi en spesiell takk til Rarst for å se på koden min for denne opplæringen før du publiserer den!
Trinn 4 Lagre skjemadata
update_term_meta. Denne funksjonen fungerer på samme måte som funksjonen som brukes til å lagre postmeta, update_post_meta. Den største forskjellen er selvsagt at update_term_meta funksjon lagrer data for vilkår, i motsetning til innlegg. Denne funksjonen tar fire argumenter, hvorav tre vil bli brukt i den nåværende implementeringen av funksjonen:
$ term_id: id av termen som metadataene er knyttet til$ meta_key: navn på metadataverdien$ meta_value: verdi for metadataene$ prev_value: tidligere verdi av metadata; hjelper å skille mellom to stykker metadata med identisk term_id og meta_key funksjon my_save_term_meta ($ term_id) $ allowed_html = array ('b' => array (), 'em' => array (), 'i' => array (), 'strike' => array '=> array (),); hvis (isset ($ _ POST ['startdato'])) update_term_meta ($ term_id, 'startdato', wp_kses ($ _ POST ['startdato'], $ allowed_html)); hvis (isset ($ _ POST ['sluttdato'])) update_term_meta ($ term_id, 'sluttdato', wp_kses ($ _ POST ['sluttdato'], $ allowed_html)); $ _POST array inneholder forventet verdi. Hvis det eksisterer, oppdateres metadataene. Hvis det ikke finnes noen termen metadata for termen med den angitte nøkkelen, opprettes en ny verdi. De update_term_meta vil håndtere å avgjøre om en oppføring i tabellen må legges til eller oppdateres. $ term_id Verdien som sendes til funksjonen, er ID for gjeldende sikt og sendes derfor til update_term_meta funksjon sammen med meta-nøkkelen ("startdato"), og meta-verdien ('$ _POST [ 'start-date']'). Som en side ville det være en dødelig synd å ikke validere disse dataene før du sendte den til databasen. I dette eksemplet bruker jeg wp_kses med de mest grunnleggende HTML-kodene tillatt å desinfisere HTML-koder når de lagres i databasen. edited_ $ taksonomi krok er riktig krok for jobben. De $ taksonomi En del av kroken er en variabel som tar navnet på taksonomien som blir redigert. For dette eksempelet vil denne kroken bli utnyttet ved bruk av edited_president. Følgende utdrag vil ringe til my_save_term_meta på riktig tidspunkt. add_action ('edited_president', 'my_save_term_meta', 10, 1); my_save_term_meta skrevet og utført på edited_president krok, dataene skal lagres i databasen og den skal vises i de riktige kolonnene. Hvis alt fungerer som det skal, bør resultatene se ut som det følgende bildet.
Trinn 5 Pre-Populere Form Fields
jQuery (dokument) .ready (funksjon () jQuery ('. editinline'). live ('klikk', funksjon () var tag_id = jQuery (dette) .parents ('tr'). attr ('id') ; var start_date = jQuery ('. startdato', '#' + tag_id) .text (); var end_date = jQuery ('sluttdato', '#' + tag_id) .text (); jQuery : input [name = "start-date"] ',' .inline-edit-row ') .val (start_date); jQuery (': input [name = "sluttdato"] ',' .inline-edit- rad ') .val (end_date); return false;);); klar funksjon, tilordner den andre linjen en "klikk" -hendelse til hver Quick Edit-kobling. Den tredje linjen forsøker å finne ID for den nåværende tabellraden i begrepet listetabellen. Denne ID-verdien er nødvendig for kontekstuelle jQuery-valgere senere i funksjonen. Ekstrahering av HTML fra begrepet listetabell ser ut som følgende (Merk: mange linjer er fjernet for lesbarhet og for å illustrere konseptet):
? ? ? 20. januar 1993 20. januar 2001 foreldre ( 'st')), og når den er plassert, få sin id. I dette tilfellet er det tag_id variabel vil være "tag-33". Med den id-verdien i hånden søker den fjerde linjen i jQuery-funksjonen etter klassen "startdato" i sammenheng med tabellraden som har et id som tilsvarer tag_id variabel. startdato variabel. I dette tilfellet er teksten i tabellcellen med klassen "startdato" som ligger inne i tabellraden med id "tag-33", "20. januar 1993", startdatoen som vi prøver å finne. Den neste koden sprer denne prosessen for sluttdatoen. Siden disse verdiene er plassert, er neste trinn å bruke dem til å fylle de aktuelle feltene. Den sjette linjen i jQuery-funksjonen gjør det bare. Det forsøker å finne en inngang med navnattributt "startdato" som er en del av elementet som har klasse "inline-edit-row" (jQuery (': input [name = "start-date"]', '.inline-edit-row')). quick_edit_custom_box krok, du vil se at det ble opprettet en inngang med navn "startdato" som var inne i a div med klassen "inline-edit-row". Denne linjen av jQuery vil matche dette innspillet og angi verdien av attributten "verdi" til tekststrengen som holdes i startdato variabel. I dette tilfellet vil inngangen med navn lik "startdato" ha sin "verdi" attributt satt til "20. januar 1993". De samme trinnene blir deretter utført for "sluttdato", og at inntastingsfeltet vil bli fylt opp på samme måte.wp_enqueue_script. Følgende funksjon og handling legger til skriptet til hode del av HTML-koden når presidens taksonomi siden er lastet inn. fungere my_add_admin_scripts () global $ pagenow; hvis ($ pagenow == 'edit-tags.php' && (isset ($ _ GET ['taksonomi']) && $ _GET ['taxonomy'] == 'president') &&! isset ($ _ GET ['action'] )) wp_register_script ('quick-edit-js', plugins_url ('/ js / quick-edit.js', __FILE__), array ('jquery')); wp_enqueue_script ( 'quick-redigerings js'); add_action ('admin_enqueue_scripts', 'my_add_admin_scripts', 10, 1); wp_enqueue_script. Endelig blir denne funksjonen utført på "admin_init" -aksjonen, som kjøres tidlig i prosessen med å laste sider i WordPress-administrasjonspanelet. Hvis alt er utført korrekt, bør skjemafeltene fylles når koblingen "Quick Edit" klikkes.
Konklusjon
