advanced-customfields

Transcript

1 advanced-customfields #advanced- custom- fields

2 Sommario Di 1 Capitolo 1: Iniziare con i campi personalizzati avanzati 2 Osservazioni 2 Versioni 2 Examples 2 Installazione / Configurazione 2 Capitolo 2: Data Time Picker 4 introduzione 4 Examples 4 Ouput valore data-ora 4 Utilizza due campi data-ora per mostrare un campo 4 Capitolo 3: get_field () 5 Sintassi 5 Parametri 5 Osservazioni 5 Examples 5 Semplice esempio 5 Ottieni il valore del campo da un altro post 5 Ottieni il valore del campo da una pagina delle opzioni 6 Controlla se il campo esiste 6 Sanitizza l'output get_field () 6 Ottieni il campo con i pulsanti di scelta 7 Capitolo 4: il campo() 8 Sintassi 8 Parametri 8 Osservazioni 8 Examples 8 Controlla se il campo esiste 8 Capitolo 5: Pagina Opzioni personalizzate 9 Sintassi 9

3 Parametri 9 Examples 9 La pagina delle opzioni più semplice 9 Pagina Opzioni avanzate 9 Titoli di coda 12

4 Di You can share this PDF with anyone you feel could benefit from it, downloaded the latest version from: advanced-custom-fields It is an unofficial and free advanced-custom-fields ebook created for educational purposes. All the content is extracted from Stack Overflow Documentation, which is written by many hardworking individuals at Stack Overflow. It is neither affiliated with Stack Overflow nor official advancedcustom-fields. The content is released under Creative Commons BY-SA, and the list of contributors to each chapter are provided in the credits section at the end of this book. Images may be copyright of their respective owners unless otherwise specified. All trademarks and registered trademarks are the property of their respective company owners. Use the content presented in this book at your own risk; it is not guaranteed to be correct nor accurate, please send your feedback and corrections to 1

5 Capitolo 1: Iniziare con i campi personalizzati avanzati Osservazioni Questa sezione fornisce una panoramica dei campi personalizzati avanzati e del motivo per cui uno sviluppatore potrebbe volerlo utilizzare. Dovrebbe anche menzionare soggetti di grandi dimensioni all'interno di campi personalizzati avanzati e collegarsi agli argomenti correlati. Poiché la Documentazione per campi personalizzati avanzati è nuova, potrebbe essere necessario creare versioni iniziali di tali argomenti correlati. Versioni Versione standard (SV): versione ( ) SV include i seguenti tipi di campo: Testo, area di testo, numero, , password, editor WYSIWYG, caricamento immagini, caricamento file, selezione, checkbox, pulsanti radio, vero / falso, collegamento pagina, oggetto post, relazione, tassonomia, utente, google maps, selezione data, colore picker, scheda, messaggio e la possibilità di creare il proprio tipo di campo personalizzato. Versione Pro (PRO): Versione ( ) PRO include tutto in SV, con l'aggiunta dei seguenti tipi di campo: Repeater, Galleria, Contenuto flessibile, Clona e Pagine delle opzioni PRO unisce la versione SV dei componenti aggiuntivi premium in un unico plug-in. Poiché contiene lo stesso code-base, l'aggiornamento da SV a PRO è noto per avere una compatibilità al 100% nei dati. Examples Installazione / Configurazione Versione standard Per installare la versione standard, vai alla sezione Plugin della tua installazione di WordPress. Cerca "Campi personalizzati avanzati" e installa / attiva. Ora avrai accesso a una nuova area nell'area amministrativa di WordPress denominata "Campi personalizzati" in cui puoi creare il tuo primo gruppo di campi personalizzato. Versione Pro 2

6 Per installare la versione pro, scaricare dall'area "Licenze e download" della sezione Account personale del sito Web di ACF. Quindi vai alla sezione Plugin della tua installazione di WordPress. Carica il file, quindi installa / attivo. Ora avrai accesso a una nuova area nell'area amministrativa di WordPress denominata "Campi personalizzati" in cui puoi creare il tuo primo gruppo di campi personalizzato. Per registrare la tua copia di ACF, utilizza il codice di licenza (disponibile anche nell'area "Licenze e download" dell'area del tuo account ACF) e incollalo nel campo della licenza nella seguente area di menu nella tua installazione di WordPress: Campi personalizzati> Aggiornamenti. È possibile aggiornare una licenza esistente in qualsiasi momento accedendo al proprio account ACF e seguendo le istruzioni. Leggi Iniziare con i campi personalizzati avanzati online: 3

7 Capitolo 2: Data Time Picker introduzione Il selettore di data e ora consente all'utente di scegliere sia una data (mese / data / anno) che un'ora del giorno (ore / minuti / secondi). Un utente può quindi stampare il formato della data e restituire il formato basato su [PHP date ()] [1] metodi accettabili. Questo è utile per interrogare tipi di messaggi personalizzati come eventi, date del tour o persino un singolo campo personalizzato. [1]: Examples Ouput valore data-ora Mostra la data da sola (il campo personalizzato è tour_date ): <p>tour Date <?php the_field('tour_date');?></p> Utilizza due campi data-ora per mostrare un campo Supponiamo che tu voglia mostrare un campo di testo ( announcement ) in base all'ora (un messaggio di notifica pianificato per esempio). Sono necessari due campi di data e ora. Nel nostro esempio, uno è chiamato start_date e l'altro end_date. <?php $DateNow = date('y-m-d H:i:s'); $DateStart = get_field('start_date', false, false); $DateEnd = get_field('end_date', false, false); if($datenow > $DateStart && $DateNow < $DateEnd) { echo the_field('announcement'); }?> Leggi Data Time Picker online: 4

8 Capitolo 3: get_field () Sintassi get_field($field_name, $post_id, $format_value); Parametri Parametro $ field_name $ post_id $ format_value Dettagli (stringa) Il nome del campo che stai richiedendo. Quando si imposta il proprio gruppo di campi, questa è l'impostazione "Nome campo". (intero) Questo è l'id del post da cui si richiede il nome del campo. Questo può anche essere "opzioni" o riferimenti di tassonomia. Questo può essere lasciato vuoto quando si trova all'interno del ciclo WordPress, se si richiede l'id del post / pagina corrente. Determina se vuoi formattare il valore caricato dal database. Il valore predefinito è true. Non richiesto. Osservazioni get_field () vs. the_field () the_field () visualizza automaticamente il valore del campo sulla tua pagina, dove get_field () no. Usa get_field () quando assegni valori di campo alle variabili o quando manipoli il contenuto restituito nel tuo codice. Examples Semplice esempio <?php echo get_field('my_field_name');?> Questo farà eco al valore del campo "my_field_name" dal post corrente. Ottieni il valore del campo da un altro post <?php echo get_field('my_field_name', 123);?> Questo farà eco al valore di "my_field_name" dal post con 123 come ID. 5

9 Ottieni il valore del campo da una pagina delle opzioni <?php echo get_field('my_field_name', 'option');?> Questo farà eco al valore di "my_field_name" dalla pagina delle opzioni creata tramite ACF. Controlla se il campo esiste <?php if( get_field('my_field_name') ){?> <?php echo get_field('my_field_name');?> <?php };?> Questo mostrerà il campo solo se il contenuto esiste a seconda del tipo di contenuto (cioè, un'immagine viene caricata sul campo, il testo è inserito, è selezionato, ecc.). Sanitizza l'output get_field () È una buona idea disinfettare l'output get_field (), specialmente quando si utilizzano i campi Campi personalizzati avanzati front-end (con acf_form ()). In caso contrario, il tuo sito è probabilmente vulnerabile agli attacchi di cross-site scripting (XSS). La seguente funzione ti consente di utilizzare echo get_field_escaped('my_custom_field', $post_id, true); invece di echo get_field('my_custom_field', $post_id, true); La funzione utilizza esc_html come impostazione predefinita, ma è possibile cambiarla come un quarto parametro echo get_field_escaped('url', $post_id, true, 'esc_url'); Aggiungi quanto segue a functions.php per abilitare la funzione: /** * Helper function to get escaped field from ACF * and also normalize values. * $field_key bool $post_id bool $format_value string $escape_method esc_html / esc_attr or NULL for none array bool string */ function get_field_escaped($field_key, $post_id = false, $format_value = true, $escape_method = 'esc_html') { $field = get_field($field_key, $post_id, $format_value); 6

10 /* Check for null and falsy values and always return space */ if($field === NULL $field === FALSE) $field = ''; /* Handle arrays */ if(is_array($field)) { $field_escaped = array(); foreach($field as $key => $value) { $field_escaped[$key] = ($escape_method === NULL)? $value : $escape_method($value); } return $field_escaped; } else return ($escape_method === NULL)? $field : $escape_method($field); } Fonte: Ulteriori informazioni sulle diverse opzioni di sanitizzazione nel codice WordPress: Ottieni il campo con i pulsanti di scelta Ecco un esempio su come utilizzare ACF per l'output in modo diverso in base alle opzioni (selezioni di colore in questo caso). Mentre puoi usare <?php echo get_field('color_options');?> per emettere direttamente il valore, è inoltre possibile modificare il markup in base alla selezione. <?php $option = get_field('color_options');?> <?php if( $option == 'red' ){?> <?php } else if( $option == 'blue' ){?> <?php } else if( $option == 'green' ){?> <?php } else if( $option == 'yellow' ){?> <?php }?> Leggi get_field () online: 7

11 Capitolo 4: il campo() Sintassi the_field ($ field_name, $ post_id); Parametri paramenter $ field_name $ post_id Dettagli il nome del campo da recuperare. ad esempio "page_content" (richiesto) ID post specifico in cui è stato inserito il valore. Predefinito all'id corrente (non richiesto). Questo può anche essere opzioni / tassonomie / utenti / ecc Osservazioni Usa get_field () quando assegni valori di campo alle variabili o quando manipoli il contenuto restituito nel tuo codice. the_field () è lo stesso di echo get_field($field_name); Examples Controlla se il campo esiste <?php if( get_field('text_field') ):?> <?php the_field('text_field');?> <?php endif;?> Qui usiamo get_field () per determinare se esiste un valore e the_field () per farlo eco. Leggi il campo() online: 8

12 Capitolo 5: Pagina Opzioni personalizzate Sintassi acf_add_options_page ($ args); acf_add_options_sub_page ($ page); Parametri Parametro $ args $ page Dettagli (mista) Una stringa per il titolo della pagina o una serie di impostazioni. Se lasciato vuoto, verranno utilizzate le impostazioni predefinite. (mista) Una stringa per il titolo della pagina o una serie di impostazioni. Se lasciato vuoto, verranno utilizzate le impostazioni predefinite. Examples La pagina delle opzioni più semplice if( function_exists('acf_add_options_page') ) { acf_add_options_page(); } Aggiungi il codice sopra a functions.php e una pagina di opzioni denominata "Opzioni" apparirà nell'area di amministrazione di Wordpress. Ora è necessario assegnare alcuni campi personalizzati alla pagina. Pagina Opzioni avanzate if( function_exists('acf_add_options_page') ) { acf_add_options_page(array( 'page_title' => 'Theme General Settings', 'menu_title' => 'Theme Settings', 'menu_slug' => 'theme-general-settings', 'capability' => 'edit_posts', 'redirect' => false )); acf_add_options_sub_page(array( 'page_title' => 'Theme Header Settings', 'menu_title' => 'Header', 'parent_slug' => 'theme-general-settings', )); 9

13 } Aggiungi il codice sopra a functions.php e una pagina delle opzioni denominata "Impostazioni tema" apparirà nell'area di amministrazione di Wordpress. Così sarà una sotto pagina chiamata 'Intestazione'. Ora è necessario assegnare alcuni campi personalizzati a tali pagine. Tutti gli argomenti supportati di entrambe le funzioni: $args [or $page] = array( /* (string) The title displayed on the options page. Required. */ 'page_title' => 'Options', /* (string) The title displayed in the wp-admin sidebar. Defaults to page_title */ 'menu_title' => '', /* (string) The slug name to refer to this menu by (should be unique for this menu). Defaults to a url friendly version of menu_slug */ 'menu_slug' => '', /* (string) The capability required for this menu to be displayed to the user. Defaults to edit_posts. Read more about capability here: */ 'capability' => 'edit_posts', /* (int string) The position in the menu order this menu should appear. WARNING: if two menu items use the same position attribute, one of the items may be overwritten so that only one item displays! Risk of conflict can be reduced by using decimal instead of integer values, e.g. '63.3' instead of 63 (must use quotes). Defaults to bottom of utility menu items */ 'position' => false, /* (string) The slug of another WP admin page. if set, this will become a child page. */ 'parent_slug' => '', /* (string) The icon class for this menu. Defaults to default WordPress gear. Read more about dashicons here: */ 'icon_url' => false, /* (boolean) If set to true, this options page will redirect to the first child page (if a child page exists). If set to false, this parent page will appear alongside any child pages. Defaults to true */ 'redirect' => true, /* (int string) The '$post_id' to save/load data to/from. Can be set to a numeric post ID (123), or a string ('user_2'). Defaults to 'options'. Added in v5.2.7 */ 'post_id' => 'options', /* (boolean) Whether to load the option (values saved from this options page) when WordPress starts up. Defaults to false. Added in v */ 'autoload' => false, ); 10

14 Leggi Pagina Opzioni personalizzate online:

15 Titoli di coda S. No Capitoli Contributors 1 Iniziare con i campi personalizzati avanzati Aibrean, Community 2 Data Time Picker Aibrean 3 get_field () Aibrean, danjah, Joe 4 il campo() danjah 5 Pagina Opzioni personalizzate danjah 12