Determina se un termine della tassonomia esiste.

Descrizione

Precedentemente is_term(), introdotto nella versione 2.3.0.

Per ulteriori informazioni su questa e altre funzioni tematiche simili, consultare la sezione Tag condizionali nel Manuale dello sviluppatore di temi.

Parametri

$termine

(int|stringa)(Richiesto)Il termine da controllare. Accetta l'ID del termine, lo slug o il nome.

$tassonomia

(stringa)(Opzionale) Il nome della tassonomia da utilizzare.

Valore predefinito: ''

$parent

(int)(Opzionale) ID del termine padre sotto il quale circoscrivere la ricerca delle esistenze.

Valore predefinito: null

Ritorno

(misto) Restituisce null se il termine non esiste. Restituisce l'ID del termine se non è specificata la tassonomia e l'ID del termine esiste. Restituisce una matrice dell'ID del termine e dell'ID della tassonomia del termine se la tassonomia è specificata e l'abbinamento esiste. Restituisce 0 se l'ID del termine 0 viene passato alla funzione.

Fonte

File: wp-includes/taxonomy.php

functionterm_exists($term,$taxonomy='',$parent=null){global$wpdb;$select="SELECT term_id FROM $wpdb->terms as t WHERE ";$tax_select="SELECT tt.term_id, tt.term_taxonomy_id FROM $wpdb->terms AS t INNER JOIN $wpdb->term_taxonomy as tt ON tt.term_id = t.term_id WHERE ";if(is_int($term)){if(0===$term){return0;}$where='t.term_id = %d';if(!empty($taxonomy)){// phpcs:ignore WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumberreturn$wpdb->get_row($wpdb->prepare($tax_select$where' AND tt.taxonomy = %s',$term,$taxonomy),ARRAY_A);}else{return$wpdb->get_var($wpdb->prepare($select$where,$term));}}$term=trim(wp_unslash($term));$slug=sanitize_title($term);$where='t.slug = %s';$else_where='t.name = %s';$where_fields=array($slug);$else_where_fields=array($term);$orderby='ORDER BY t.term_id ASC';$limit='LIMIT 1';if(!empty($taxonomy)){if(is_numeric($parent)){$parent=(int)$parent;$where_fields[]=$parent;$else_where_fields[]=$parent;$where.=' AND tt.parent = %d';$else_where.=' AND tt.parent = %d';}$where_fields[]=$taxonomy;$else_where_fields[]=$taxonomy;$result=$wpdb->get_row($wpdb->prepare("SELECT tt.term_id, tt.term_taxonomy_id FROM $wpdb->terms AS t INNER JOIN $wpdb->term_taxonomy as tt ON tt.term_id = t.term_id WHERE $where AND tt.taxonomy = %s $orderby$limit",$where_fields),ARRAY_A);if($result){return$result;}return$wpdb->get_row($wpdb->prepare("SELECT tt.term_id, tt.term_taxonomy_id FROM $wpdb->terms AS t INNER JOIN $wpdb->term_taxonomy as tt ON tt.term_id = t.term_id WHERE $else_where AND tt.taxonomy = %s $orderby$limit",$else_where_fields),ARRAY_A);}// phpcs:ignore WordPress.DB.PreparedSQLPlaceholders.UnfinishedPrepare$result=$wpdb->get_var($wpdb->prepare("SELECT term_id FROM $wpdb->terms as t WHERE $where$orderby$limit",$where_fields));if($result){return$result;}// phpcs:ignore WordPress.DB.PreparedSQLPlaceholders.UnfinishedPreparereturn$wpdb->get_var($wpdb->prepare("SELECT term_id FROM $wpdb->terms as t WHERE $else_where$orderby$limit",$else_where_fields));}

Correlato

Utilizzi

Usi Descrizione
wp-includes/formatting.php: wp_unslash()

Rimuove gli slash da una stringa o rimuove ricorsivamente gli slash dalle stringhe all'interno di un array.

wp-includes/formatting.php: sanitize_title()

Sanifica una stringa in uno slug, che può essere usato negli URL o negli attributi HTML.

wp-includes/wp-db.php: wpdb::get_row()

Recupera una riga dal database.

wp-includes/wp-db.php: wpdb::get_var()

Recupera una variabile dal database.

wp-includes/wp-db.php: wpdb::prepare()

Prepara una query SQL per un'esecuzione sicura.

Utilizzato da

Usato da Descrizione
wp-admin/includes/export.php: export_wp()

Genera il file di esportazione WXR per il download.

wp-admin/includes/taxonomy.php: categoria_esiste()

Controlla se una categoria esiste.

wp-admin/includes/taxonomy.php: wp_insert_category()

Aggiorna una categoria esistente o crea una nuova categoria.

wp-admin/includes/taxonomy.php: tag_exists()

Controlla se esiste un tag del post con un dato nome.

wp-admin/includes/taxonomy.php: wp_create_term()

Aggiunge un nuovo termine al database, se non esiste già.

wp-includes/deprecated.php: is_term()

Controlla se il termine esiste.

wp-includes/taxonomy.php: wp_unique_term_slug()

Rende unico lo slug, se non lo è già.

wp-includes/taxonomy.php: wp_update_term()

Aggiorna il termine in base agli argomenti forniti.

wp-includes/taxonomy.php: wp_insert_term()

Aggiunge un nuovo termine al database.

wp-includes/taxonomy.php: wp_set_object_terms()

Creare relazioni tra termini e tassonomie.

wp-includes/taxonomy.php: wp_remove_object_terms()

Rimuove i termini associati a un dato oggetto.

wp-includes/taxonomy.php: wp_delete_term()

Rimuove un termine dal database.

wp-includes/taxonomy.php: register_taxonomy()

Crea o modifica un oggetto tassonomia.

Changelog

Versione Descrizione
3.0.0 Introdotto.