Share
Egendefinerte felt i Wordpress gjør det enkelt å tilpasse temaet ditt på en rekke måter; pluss, de er enkle å implementere for innlegg og sider. Vedlegg, derimot, tar litt mer arbeid å implementere, og krever at du leser og deklarer kjernekode for å få dem til å fungere. Vi går gjennom bruk av et par uokumenterte Wordpress-kroker i denne opplæringen for å gjøre denne prosessen mye lettere.
Begge disse krokene har eksistert siden Wordpress 2.5, og brukes i wp-admin / includes / media.php, men forblir underutnyttet i samfunnet mest sannsynlig fordi de er utokumenterte i Codex. Nedenfor er hvor krokene brukes i kjernekoden, og lar oss få vite hva som skal sendes til de funksjonene vi legger til hver krok.
Accentsconagua
funksjon get_attachment_fields_to_edit ($ post, $ errors = null) // ... $ form_fields = apply_filters ("attachment_fields_to_edit", $ form_fields, $ post); // ... funksjon media_upload_form_handler () // ... $ post = apply_filters ("attachment_fields_to_save", $ post, $ vedlegg); // ... Merk: Vær forsiktig i koden din, som $ post Sendes til en funksjon som en gjenstand og til den andre som en matrise.
De nye feltene som legges til, blir lagret som post-meta, akkurat som de egendefinerte feltene på skjermbildet for innlegg / side. Felt prefiks med underskrift (_my_custom_field) vil ikke bli oppført i nedtrekk av tilgjengelige egendefinerte felt på post / side skjermen; alle andre eksisterende postmetafelt vil bli oppført. Vi kan bruke denne kunnskapen til å skjule feltene vi legger til medieformularen, siden de ikke er relevante for innlegg / sider.
Det er en lignende regel å huske når du velger $ form_fields matrise-nøkkel for bruk for det nye feltet. Her, hvis du bruker en understreking ($ form_fields [ '_ my_custom_field']) feltet ditt vil bli hoppet over og vil ikke bli lagt til skjemaet.
For å kunne vise feltene i medieformen, men ikke liste dem i siden / legge inn egendefinerte felt, må vi kombinere begge metodene. Dette vil omfatte både redigerings- og lagringsfunksjonene vi skal skape. For 'attachment_fields_to_edit'krok vi setter $ form_fields tastene opp til ikke å ha understreket prefiks, og for 'attachment_fields_to_save'krok vi prefixer feltene våre med en understreking før du lagrer dem som postmeta. Dette er en løsning som er verdt å gjøre for ikke å slamle brukerens grensesnitt med unødvendig info.
Nedenfor er et eksempel på hvordan du legger til dine egne tilpassede felt i vedleggsskjemaet.
/ ** * Legge til våre egendefinerte felt til $ form_fields array * * @param array $ form_fields * @param object $ post * @return array * / funksjon my_image_attachment_fields_to_edit ($ form_fields, $ post) // $ form_fields er et spesielt utvalg av felt som skal inkluderes i vedlegget // $ post er vedlegget i databasen // $ post-> post_type == 'vedlegg' // (vedleggene behandles som innlegg i Wordpress) // legg til vårt egendefinerte felt til $ form_fields array // input type = "text" navn / id = "vedlegg [$ vedlegg-> ID] [custom1]" $ form_fields ["custom1"] = array ("label" => __ ("Custom Text Field" ), "input" => "tekst", // dette er standard hvis "input" er utelatt "value" => get_post_meta ($ post-> ID, "_custom1", true)); // hvis du vil legge til feilmeldinger for ditt felt, // så for ikke å overskrive dem, slik de er forhåndsbestemt // til dette arrayet, må du sette feltet opp slik: $ form_fields [" custom1 "] [" label "] = __ (" Egendefinert tekstfelt "); $ form_fields ["custom1"] ["input"] = "text"; $ form_fields ["custom1"] ["value"] = get_post_meta ($ post-> ID, "_custom1", true); returner $ form_fields; // fester vår funksjon til riktig krok add_filter ("attachment_fields_to_edit", "my_image_attachment_fields_to_edit", null, 2); De $ form_fields array har flere alternativer for å inkludere ulike typer innganger og tilpasset innhold. Jeg har samlet de forskjellige metodene nedenfor med notater og skjermbilder av hvordan de gjengis i skjemaet.
// input type = "text" $ form_fields ["custom1"] ["label"] = __ ("Egendefinert tekstfelt"); $ form_fields ["custom1"] ["input"] = "text"; // dette er standard hvis "input" utelates $ form_fields ["custom1"] ["value"] = get_post_meta ($ post-> ID, "_custom1", true); Gjengis i skjemaet som:
// textarea $ form_fields ["custom2"] ["label"] = __ ("Custom Textarea"); $ form_fields ["custom2"] ["input"] = "textarea"; $ form_fields ["custom2"] ["value"] = get_post_meta ($ post-> ID, "_custom2", true); Gjengis i skjemaet som:
Skjulte felt er samlet sammen og utdata på slutten av skjemaet.
// input type = "hidden" // ikke behov for en etikett $ form_fields ["custom3"] ["input"] = "hidden"; $ form_fields ["custom3"] ["value"] = get_post_meta ($ post-> ID, "_custom3", true);
Hvis du trenger en annen inntasting enn 'tekst', 'textarea' eller 'skjult', bruk deretter 'html' som lar deg passere ditt eget tilpassede innhold for å bruke for innspillingselementet du ønsker. Når du oppretter din egen inntasting html, er det viktig å sette «navn» attributtet på elementet riktig, for at feltet skal sendes til lagringsfunksjonen senere. Du vil ha noe slikt: navn = "vedlegg [$ post-> ID] [my_custom_key]" .
$ form_fields ["custom4"] ["label"] = __ ("Custom Select"); $ form_fields ["custom4"] ["input"] = "html"; $ form_fields ["custom4"] ["html"] = " "; // et annet eksempel $ form_fields [" custom5 "] [" label "] = __ (" Custom Checkbox "); $ form_fields [" custom5 "] [" input "] =" html "; $ form_fields [" custom5 " ] ["html"] = "HTML-utgangen går her, som en avkrysningsboks: "; Gjengis i skjemaet som:
Det er flere spesielle attributter du kan legge til i egendefinerte felt for å forbedre dem.
hjelper - Dette attributtet legger til en hjelpestreng i ditt egendefinerte felt.
$ form_fields ["custom6"] ["label"] = __ ("Tilpasset felt med nyttig tekst"); $ form_fields ["custom6"] ["value"] = get_post_meta ($ post-> ID, "_custom6", true); $ form_fields ["custom6"] ["helps"] = "Sett nyttig tekst her."; Dette gjøres i form som:
nødvendig - Denne attributtet vil markere feltet etter behov men det er bare en visuell referanse. Vi må skrive kode senere i lagringsfunksjonen for å håndheve den.
$ form_fields ["custom7"] ["label"] = __ ("Obligatorisk felt"); $ form_fields ["custom7"] ["value"] = get_post_meta ($ post-> ID, "_custom7", true); $ form_fields ["custom7"] ["required"] = TRUE; // standard er FALSK Gjengis i skjemaet som:
extra_rows - Dette attributtet lar deg legge til en rekke rader rett etter det tilpassede feltet. Markeringen for hvert array element er vist nedenfor: array-nøkkelen vil bli klassen av td, og verdien er innholdet:
