Beschreibung
*** Uusi ominaisuus lisätty: Custom Post ID Slugs ***
Tämä on lisälaite Advanced Custom Fields (ACF) 5 + Options Page Add On (tai ACF Pro).
Tämä lisäosa ei tarjoa mitään toimintoja, ellei ACF 5 ja Options Page Add On (tai ACF5 Pro)
ole asennettu
Tämä lisäosa tarjoaa ylläpitäjän käyttöliittymän valintasivujen lisäämiseen ACF:ssä, mukaan lukien kaikki ACF
valintasivujen vaihtoehdot. Useimmat vaihtoehdot ovat valittavissa, esimerkiksi valikon sijainti, kyky ja mihin tallennetaan
kentän arvot.
Katso
Muut huomautukset ja
Screenshotit
Github Repository
Tämä lisäosa on myös GitHubissa
https://github.com/Hube2/acf-options-page-adder
Muutoskyvykkyys
Vaihtoehtosivujen asetusten lisäämiseen/muokkaamiseen tarvittava kyvykkyys on ”manage_options”. Tätä kyvykkyyttä voidaan muuttaa lisäämällä suodatin.
add_filter('acf-options-page-adder/capability', 'my_acf_options_page_adder_cap');function my_acf_options_page_adder_cap($cap) { $cap = 'edit_published_posts'; return $cap;}
Valintojen tallentaminen optiosivun viestiin
ACF v5.2.7 lisäsi mahdollisuuden tallentaa optiosivun kentät viestin ID:hen. Tämän lisäosan avulla voit tallentaa vaihtoehdot samaan post ID:hen, joka on luotu, kun lisäät optiosivun tämän lisäosan avulla. Voit jopa käyttää get_fields($options_page_id) -toimintoa ilman, että sinun tarvitsee huolehtia siitä, että saat kentät itse optiosivulle. Miksi? koska kaikki valintasivun luomiseen käytetyt kentät alkavat alaviivalla _, eikä get_fields() palauta niitä. Ainoa asia, jota sinun on varottava, on se, ettet käytä mitään tämän laajennuksen käyttämiä kenttien nimiä, minkä pitäisi olla erittäin helppoa, koska ne kaikki alkavat kirjaimella acfop.
Tallenna arvot käyttämällä mukautettua post ID slugia
Vaihtoehtosivun arvojen tallentamiseen on mahdollista käyttää mukautettua slugia. Jos esimerkiksi haluat tallentaa optiosivun arvot käyttäjälle, voit antaa optiosivun $post_id-arvoksi ”user_1”. Tällä on myös toinen sivuvaikutus. Normaalisti, kun ACF tallentaa arvoja optiotaulukon ”options” -kenttiin, löydät kentät, joissa on etuliite ”options_”. Jos siis esimerkiksi kentän nimi on ”my_field”, optiotaulukossa on optioiden nimenä ”options_my_field”. Voit antaa tätä varten mukautetun slugin, sanotaan, että asetat optiosivun post ID -asetukseksi ”my-custom-slug”. tämä aiheuttaisi sen, että sama kenttä optiosivulla olisi nimeltään ”my-custom-slug_my_field”. 2 Tähän lisäosaan on lisätty uusia vaihtoehtoja, ja voit valita, käytetäänkö post ID:nä optiosivun slugia vai voitko määrittää sen sijaan käytettävän mukautetun slugin.
Post ID:n hakeminen optiosivua varten
Funktio ja suodatin ovat käytettävissä oikean ACF $post_id -arvon saamiseksi, jota voidaan käyttää
arvojen saamiseksi optiosivulta. Tämä funktio/suodatin palauttaa
optioihin tallennetuille optiosivuille ’options’ tai palauttaa oikean postin ID:n, jos optiot on tallennettu postiin. Oikea ID palautetaan
optiosivun ”menu_slug”-arvon perusteella.
/ example 1: function get_options_page_id()// get the post_id of an options page$post_id = get_options_page_id('my_options_page_slug');// get a value using $post_id$value = get_field('my_option_field', $post_id);// or it can be combined like this$value = get_field('my_option_field', get_options_page_id('my_options_page_slug'));// example 2: by filter$default = 'option',$slug = 'my_options_page_slug';$post_id = apply_filters('get_option_page_id_filter', $default, $slug);$value = get_field('my_option_field', $post_id);// or it can be combined like this$value = get_field('my_option_field', apply_filters('get_option_page_id_filter', $default, $slug));
On olemassa ehto, jossa saat väärän post id:n. Tämä ehto syntyy, kun käytössä on ylimmän tason uudelleenohjaussivu, joka on asetettu ohjaamaan ensimmäiselle alavaihtoehtosivulle. Jos alavaihtoehtosivua ei ole olemassa, se palauttaa ylimmän tason vaihtoehtosivun arvon. Jos myöhemmin luodaan alivaihtoehtosivu, se palauttaa alivaihtoehtosivun uuden arvon. Siksi olen nähnyt uudelleenohjauksen oletusarvon olevan false. Jos haluat, että ylimmän tason sivu ohjaa uudelleen, sinun on oltava tietoinen siitä, että se voi aiheuttaa ongelmia myöhemmin, jos et ole luonut alivaihtoehtosivua. Kannattaa myös erityisesti asettaa alivaihtoehtosivujen järjestys niin, että ne eivät muutu jossain vaiheessa tulevaisuudessa, koska uuden vaihtoehtosivun lisääminen samalla järjestyksellä kuin olemassa oleva ylimmän tason sivu muuttaa tallennus- ja hakupaikkaa uudelle vaihtoehtosivulle. En voi tehdä asialle mitään, se toimii näin. Kun määrität ACF-optiosivuja tallentamaan postiin vaihtoehtojen sijasta, sinun on oltava tarkempi optiosivun argumenttien kanssa.
Font Awesome Support
Huomaa, että tämä lisäosa ei ota käyttöön tai sisällytä Font Awswsomea sivustosi ylläpitojärjestelmään.
Jos sisällytät Font Awsomen ylläpitojärjestelmään, voit käyttää Font Awesome -kuvakkeita yläpuolen optiosivun kuvakkeisiin
. Esimerkiksi jos haluat käyttää osoitekirjan kuvaketta, sinun tarvitsee vain lisätä fa fa-address-book
kuvake-kenttään, kun lisäät tai muokkaat valintasivua.
Suodatinasetussivun otsikko/jalkatunniste/sisältö
Tämän laajennuksen versio 3.8.0 lisäsi mahdollisuuden muokata ACF-valintasivua lisäämällä otsikon ja alatunnisteen sisältöä. Vaihtoehtosivun ylläpitoeditoriin lisättyjen WYSIWYG-kenttien lisäksi voit myös muokata näitä osioita tai koko vaihtoehtosivua suodattimien avulla.
Tämän laajennuksen versio 3.8.2 lisää vaihtoehdon, jolla voit ottaa tämän ominaisuuden käyttöön. Tämä ominaisuus voi aiheuttaa
muistin loppuminen kohtalokkaan virheen optiosivuilla, joilla on suuri määrä kenttiä. Jos sisältö syötettiin tähän kenttään ennen kytkimen kytkemistä päälle, kytkin kytkeytyy automaattisesti päälle. Muussa tapauksessa tämän vaihtoehdon oletusarvo on pois päältä.
Header Content
add_filter('acf-options-page-adder/page-header', 'my_custom_options_page_header', 10, 2);function my_custom_options_page_header($content, $hook) { // $content = content, by default it is '' or the value of the WYSIWYG editor // $hook = the current options page hook that is being called $content = '<p>My Custom Header Content</p>'; return $content;}
Footer Content
add_filter('acf-options-page-adder/page-footer', 'my_custom_options_page_footer', 10, 2);function my_custom_options_page_footer($content, $hook) { // $content = content, by default it is '' or the value of the WYSIWYG editor // $hook = the current options page hook that is being called $content = '<p>My Custom Footer Content</p>'; return $content;}
Filter Entire Options Page
add_filter('acf-options-page-adder/page-content', 'my_custom_options_page_filter', 10, 2);function my_custom_options_page_filter($content, $hook) { // $content = entire content or options page, including all ACF fields // $hook = the current options page hook that is being called // caution should be taken when making modification to the page content return $content;}
Remove Nag
Jos haluat poistaa pienen nalkutukseni, joka ilmestyy joillakin ylläpitäjäsivuilla, lisää seuraavat funktiot files.php-tiedostoosi
add_filter('remove_hube2_nag', '__return_true');