SearchWP Documentation

Visualizza la guida all'installazione, sfoglia la Knowledge Base, scopri i numerosi hook di SearchWP

Hook

SearchWP include una serie di hook per consentire personalizzazioni uniche senza compromettere il codice del plugin stesso. L'integrazione con SearchWP tramite hook consentirà alle tue modifiche di rimanere in vigore anche durante gli aggiornamenti di SearchWP nel tempo.

Se non hai mai utilizzato gli hook di WordPress prima segui questa guida alla creazione di plugin di personalizzazione di SearchWP.

Query

searchwp\query
Utilizzando questo hook è possibile manipolare direttamente la query di ricerca.
searchwp\query\args
Personalizza gli argomenti per un \SearchWP\Query che viene utilizzato per eseguire tutte le query di ricerca.
searchwp\query\before
Viene attivato immediatamente prima che una query \SearchWP\Query venga eseguita, prima che i Mod(s) siano stati configurati.
searchwp\query\do_source_db_where
Controlla se SearchWP considera i criteri db_where() per le Origini. Questa funzionalità aggiunge un livello di protezione contro le modifiche ai contenuti effettuate in modo tale che l'indicizzatore di SearchWP non sia stato in grado di catturare. Se sei sicuro che le modifiche ai tuoi contenuti avvengano tramite API come catturate dalle Origini che stai utilizzando [...]
searchwp\query\logic\{$type}\strict
Influenza il modo in cui SearchWP funziona attraverso le sue varie passate logiche durante l'esecuzione delle ricerche. Per impostazione predefinita, SearchWP eseguirà una serie di passate logiche durante l'esecuzione delle ricerche in questo ordine: frase (cioè "virgolette", ricerche di frasi) e (cioè tutti i termini di ricerca presenti in tutti i risultati) o (cioè qualsiasi termine di ricerca presente in qualsiasi risultato) Dopo ogni passata, [...]
searchwp\query\logic\and
Controlla se viene eseguita la logica AND. Nota: per impostazione predefinita, la logica AND verrà saltata se viene superata la soglia dei token. La soglia predefinita è 5 ma può essere personalizzata con l'hook searchwp\query\logic\and\token_threshold.
searchwp\query\logic\and\token_threshold
Controlla la soglia che SearchWP considera quando decide se eseguire una passata logica AND. La logica AND può essere problematica in termini di risorse e in alcuni casi comportare lunghi tempi di query. A causa dell'algoritmo di pertinenza di SearchWP, saltare la logica AND perché ci sono troppi termini di ricerca non degraderà la qualità dei risultati poiché i più [...]
searchwp\query\logic\phrase
Controlla se SearchWP supporta le frasi tra virgolette.
searchwp\query\mods
Personalizza le \SearchWP\Mods applicate durante una ricerca. Nota: ci sono alcune \SearchWP\Mods interne che potrebbero essere presenti per la query. Questo hook non consente il filtraggio di quelle \SearchWP\Mods critiche per la missione, solo le \SearchWP\Mods definite dall'utente. Vedi anche searchwp\query\do_source_db_where per gli interni.
searchwp\query\output_suggested_search
Controlla se SearchWP suggerisce automaticamente correzioni di ricerca.
searchwp\query\partial_matches
Controlla se SearchWP applica la sua logica di corrispondenza parziale quando necessario.
searchwp\query\partial_matches\buoy
Controlla se le corrispondenze esatte ricevono un peso di pertinenza aggiuntivo durante l'esecuzione della logica di corrispondenza parziale.
searchwp\query\partial_matches\did_you_mean
Controlla se SearchWP esegue correzioni in stile "Intendevi?" alle ricerche che applicano la logica di corrispondenza parziale.
searchwp\query\partial_matches\force
Forza SearchWP a eseguire la sua logica di corrispondenza parziale nonostante siano stati trovati risultati.
searchwp\query\partial_matches\fuzzy
Controlla se la logica di corrispondenza parziale utilizza la corrispondenza fuzzy. Per impostazione predefinita (quando abilitato), SearchWP utilizzerà due livelli di logica di corrispondenza parziale. Trova corrispondenze parziali che contengono la stringa di ricerca Se non vengono trovate corrispondenze parziali, tenta di trovare token che suonano come termini di ricerca
searchwp\query\partial_matches\fuzzy\force
Per impostazione predefinita (quando la corrispondenza parziale è abilitata) SearchWP applicherà due livelli di logica di corrispondenza parziale. Il primo sarà l'applicazione di corrispondenze parziali dirette e, se non vengono trovate corrispondenze parziali, verrà applicato un altro livello di logica fuzzy. Questo hook può forzare l'applicazione di tale logica fuzzy anche se le corrispondenze parziali […]
searchwp\query\partial_matches\fuzzy\minimum_length
Controlla la lunghezza minima per le corrispondenze fuzzy.
searchwp\query\partial_matches\fuzzy\threshold
Controlla la soglia che determina se una potenziale corrispondenza parziale fuzzy è considerata una corrispondenza.
searchwp\query\partial_matches\minimum_length
Controlla la lunghezza minima per le corrispondenze parziali.
searchwp\query\partial_matches\tokens
Manipola i token di corrispondenza parziale durante l'applicazione della logica di corrispondenza parziale.
searchwp\query\partial_matches\wildcard_after
Controlla se un carattere jolly viene aggiunto dopo una query di ricerca durante l'applicazione della logica di corrispondenza parziale.
searchwp\query\partial_matches\wildcard_before
Controlla se un carattere jolly viene aggiunto prima di una query di ricerca durante l'applicazione della logica di corrispondenza parziale.
searchwp\query\per_page
Personalizza quanti risultati vengono restituiti per pagina.
searchwp\query\result\load_data
Controlla se SearchWP carica i dati degli attributi delle voci applicabili per i risultati della ricerca. Nota: quando questa funzionalità è abilitata, verranno caricati solo i dati degli attributi aggiunti al motore. Vedi anche searchwp\query\result\load_data\all_attributes
searchwp\query\result\load_data\all_attributes
Controlla se SearchWP carica tutti i dati degli attributi delle voci per i risultati della ricerca. Nota: quando questa funzionalità è abilitata, verranno caricati tutti i dati degli attributi registrati. Vedi anche searchwp\query\result\load_data
searchwp\query\results
Modifica i risultati trovati da SearchWP.
searchwp\query\search_string
Personalizza la stringa di ricerca per una query.
searchwp\query\tokens\limit
Controlla il numero massimo di token di ricerca accettati.
searchwp\query\tokens\use_stems
Controlla se vengono utilizzati gli steli delle parole chiave dei token per una query.

Post

searchwp\source\post\{$post_type}\attribution
Controlla se i risultati di un tipo di post possono essere configurati per attribuire tutto il peso a un altro ID di post.
searchwp\source\post\{$post_type}\parent_attribution
Controlla se i risultati di un tipo di post possono essere configurati per attribuire un peso di rilevanza ai loro genitori.
searchwp\source\post\{$post_type}\parent_attribution\strict
Controlla come i Post senza un genitore vengono restituiti quando l'attribuzione del genitore è stata abilitata.
searchwp\source\post\attributes\comment
Personalizza un Commento prima che venga indicizzato.
searchwp\source\post\attributes\comments\args
Controlla gli argomenti utilizzati per recuperare i Commenti di un post durante l'indicizzazione.
searchwp\source\post\attributes\comments\author
Quando i Commenti sono stati aggiunti a una Sorgente basata su WP_Post, controlla se l'Autore del Commento viene indicizzato.
searchwp\source\post\attributes\comments\email
Quando i Commenti sono stati aggiunti a una Sorgente basata su WP_Post, controlla se l'Email del Commento viene indicizzato.
searchwp\source\post\attributes\content
Personalizza il contenuto del post prima che venga indicizzato.
searchwp\source\post\attributes\content\do_blocks
Controlla se SearchWP elabora i blocchi dell'editor a blocchi (Gutenberg) prima dell'indicizzazione.
searchwp\source\post\attributes\meta
Manipola i dati dei Campi Personalizzati (postmeta) prima che vengano indicizzati. Vedi anche searchwp\source\post\attributes\meta\${meta_key} per un singolo Campo Personalizzato.
searchwp\source\post\attributes\meta\{$meta_key}
Manipola i dati dei Campi Personalizzati (postmeta) per un singolo Campo Personalizzato prima che vengano indicizzati. Vedi anche searchwp\source\post\attributes\meta\${meta_key} per tutti i Campi Personalizzati.
searchwp\source\post\attributes\meta\ignored
Per impostazione predefinita, SearchWP ignora le chiavi meta che non contengono contenuti degni di ricerca. Puoi personalizzare quali chiavi vengono ignorate con questo hook.
searchwp\source\post\attributes\taxonomy\term
Manipola i termini della tassonomia per un post prima dell'indicizzazione. Si applica solo quando la Tassonomia è stata inclusa in un Motore. Vedi anche searchwp\source\post\attributes\taxonomy\terms per filtrare tutti i termini contemporaneamente.
searchwp\source\post\attributes\taxonomy\terms
Manipola i termini della tassonomia per un post prima dell'indicizzazione. Si applica solo quando la Tassonomia è stata inclusa in un Motore. Vedi anche searchwp\source\post\attributes\taxonomy\term per filtrare i singoli termini.
searchwp\source\post\global_excerpt
Controlla se SearchWP trova un estratto 'globale' da tutto il contenuto del post, non solo da post_content.
searchwp\source\post\global_excerpt\{$post_type}
Controlla se SearchWP trova un estratto 'globale' da tutto il contenuto del post, non solo da post_content per un singolo tipo di post.

Token

searchwp\tokens
Manipola i token sia durante l'indicizzazione che durante la ricerca.
searchwp\tokens\apply_rules_to_pattern_matches
Controlla se SearchWP applica le sue regole di convalida (ad es. lunghezza minima) alle corrispondenze di pattern di espressioni regolari (regex).
searchwp\tokens\minimum_length
Controlla quale SearchWP utilizza come lunghezza minima del token (termine di ricerca).
searchwp\tokens\regex_patterns
SearchWP cerca corrispondenze di pattern di espressioni regolari per mantenere intatte determinate stringhe ed evitare la tokenizzazione che potrebbe ridurne l'utilità durante la ricerca. Per impostazione predefinita, sono presenti diversi pattern di espressioni regolari comuni per estrarre stringhe di SKU, date, iniziali, nomi di funzioni, numeri di versione e altro ancora. Puoi usare questo hook per aggiungere i tuoi […]
searchwp\tokens\regex_patterns\only_full_matches
Per impostazione predefinita, SearchWP elaborerà solo le corrispondenze complete per i suoi pattern di espressioni regolari. Se desideri che SearchWP consideri anche le corrispondenze parziali, puoi abilitare tale comportamento con questo hook.
searchwp\tokens\strict
Controlla se SearchWP è rigoroso con i token. Quando disabilitato (che è il comportamento predefinito), SearchWP rimuoverà gli accenti dai caratteri.
searchwp\tokens\tokenize_pattern_matches
Controlla se le corrispondenze dei pattern regex vengono tokenizzate in parti individuali.

Indice

searchwp\background_process\http_basic_auth_credentials
Insegna all'Indicizzatore le credenziali di autenticazione HTTP Basic. Nota: queste credenziali sono per l'autenticazione HTTP Basic, non per le credenziali di accesso a WordPress.
searchwp\index\aggressive_delta
Per impostazione predefinita, SearchWP utilizza il suo processo in background durante la gestione degli aggiornamenti delta. Ciò aiuta a ridurre al minimo i tempi di caricamento della pagina. Se invece preferisci che SearchWP applichi gli aggiornamenti delta inline con le modifiche ai contenuti, puoi usare questo hook.
searchwp\index\process\enabled
Controlla se il processo di gestione delta dell'indice è abilitato.
searchwp\index\rebuild
Questa azione viene attivata ogni volta che l'indice viene resettato, poco prima che venga attivato il processo di ricostruzione.
searchwp\index\tokens_max
Per impostazione predefinita, SearchWP genererà token in batch di massimo 500. Se ritieni che il tuo server sia in grado di gestirne di più, aumentare questo limite potrebbe migliorare le prestazioni del processo di indicizzazione. Questo hook può anche essere utilizzato per ridurre il numero di token generati per patch nel caso in cui tu stia avendo problemi con […]

Indicizzatore

searchwp\background_process\http_basic_auth_credentials
Insegna all'Indicizzatore le credenziali di autenticazione HTTP Basic. Nota: queste credenziali sono per l'autenticazione HTTP Basic, non per le credenziali di accesso a WordPress.
searchwp\indexer\alternate
Controlla se SearchWP utilizza il suo indicizzatore alternativo. SearchWP rileva automaticamente quando l'indicizzatore alternativo è necessario, ma questo hook sovrascrive tale rilevamento. Vedi anche: Indicizzatore Alternativo
searchwp\indexer\batch_size
Controlla quante voci vengono indicizzate durante ogni batch dell'indicizzatore.
searchwp\indexer\http_basic_auth_credentials
Insegna all'Indicizzatore le credenziali di autenticazione HTTP Basic. Nota: queste credenziali sono per l'autenticazione HTTP Basic, non per le credenziali di accesso a WordPress.

Statistiche

searchwp\admin\dashboard_widgets\statistics
Come parte della funzionalità Statistiche di SearchWP, viene fornito un Widget Bacheca per consentire una rapida panoramica delle tue statistiche di ricerca quando accedi alla tua Bacheca di WordPress.
searchwp\admin\dashboard_widgets\statistics\days
Per impostazione predefinita, il widget Statistiche della dashboard mostra le ricerche più popolari degli ultimi 30 giorni. Usa questo hook per modificare tale impostazione predefinita.
searchwp\statistics\capability
Controlla la capacità necessaria per visualizzare le statistiche di SearchWP.
searchwp\statistics\log
Controlla se SearchWP registra questa ricerca.

Stopwords

searchwp\stopwords
SearchWP utilizza le parole d'arresto (stopwords) sia per ottimizzare l'indice sia per aumentare la pertinenza dei risultati di ricerca. Il metodo principale per personalizzare l'elenco delle parole d'arresto è tramite la scheda Impostazioni della schermata delle impostazioni di SearchWP. È tuttavia possibile filtrare le parole d'arresto anche a livello programmatico.
searchwp\stopwords\suggestions
Controlla se SearchWP suggerisce parole d'arresto.
searchwp\stopwords\suggestions\limit
Controlla il numero di suggerimenti di parole d'arresto mostrati da SearchWP.
searchwp\stopwords\suggestions\threshold
Controlla la soglia utilizzata per determinare le parole d'arresto suggerite.

BackgroundProcess

searchwp\background_process\http_basic_auth_credentials
Insegna all'Indicizzatore le credenziali di autenticazione HTTP Basic. Nota: queste credenziali sono per l'autenticazione HTTP Basic, non per le credenziali di accesso a WordPress.
searchwp\background_process\load_maximum
Quando SearchWP monitora il carico della CPU, controlla una soglia massima di carico. Quando questa soglia viene superata, SearchWP ridurrà il processo di indicizzazione per non aumentare ulteriormente il carico della CPU. Se il tuo server dispone di molti core, è probabile che questo carico massimo possa essere aumentato per eguagliare la capacità del tuo server.
searchwp\background_process\load_monitoring
SearchWP monitorerà il carico della CPU del sistema quando possibile e ridurrà il processo di indicizzazione per evitare interruzioni del servizio per i visitatori del sito. Utilizzando questo hook puoi disabilitare il monitoraggio del carico di SearchWP.
searchwp\background_process\load_throttle
Quando il monitoraggio del carico di SearchWP rileva che la soglia di carico della CPU è stata superata, viene inserito un timeout nel processo di indicizzazione. Puoi usare questo hook per personalizzare la durata di tale timeout.

Documento

searchwp\document\content
Personalizza il contenuto del documento estratto.
searchwp\document\pdf_metadata\skip
Se i metadati PDF debbano essere saltati durante l'indicizzazione.
searchwp\document\skip
Controlla se SearchWP debba saltare l'elaborazione di un documento.

Parser

searchwp\parser\pdf
Utilizza un parser PDF esterno per estrarre il contenuto PDF invece di quello di SearchWP.
searchwp\parser\richtext
Utilizza un parser di rich text esterno per estrarre il contenuto rich text invece di quello di SearchWP.
searchwp\parser\text
Utilizza un parser di testo esterno per estrarre il contenuto testuale invece di quello di SearchWP.

Debug

searchwp\debug
Controlla se il debug è abilitato.
searchwp\debug\dir
Modifica dove vengono archiviati i log di debug.

Fonte

searchwp\source\attribute\options
Modifica le Opzioni Attributo per una Sorgente.
searchwp\source\check_db
Controlla se SearchWP valida le proprietà del database di una Sorgente.

Voce

searchwp\entry\data
Personalizza un \SearchWP\Entry prima che venga indicizzato.
searchwp\entry\native
Personalizza l'oggetto nativo di un \SearchWP\Entry.

Evidenziatore

searchwp\highlighter\case_insensitive
Controlla la sensibilità alle maiuscole/minuscole durante l'evidenziazione.
searchwp\highlighter\partial_matches
Controlla se l'evidenziazione considera le corrispondenze parziali.

Modelli

searchwp_live_search_results_entry_data
Questo hook di filtro consente di personalizzare i dati per ogni voce di risultato di SearchWP prima che venga visualizzata nel modello dei risultati di ricerca live di SearchWP. È specificamente pensato per l'output della ricerca live e consente agli sviluppatori di modificare le proprietà del risultato come il titolo, il permalink, il markup dell'immagine e il contenuto dell'estratto. 
searchwp\results\entry\data
Questo hook di filtro consente la personalizzazione dei dati di output per ogni voce di risultato di SearchWP prima che venga passata al modello di SearchWP. Può essere utilizzato per modificare il titolo visualizzato, il permalink, l'immagine o il contenuto, nonché per regolare il markup per tipi di oggetti specifici come post, termini di tassonomia o utenti.

AdminBar

searchwp\admin_bar
Controlla se la voce della barra di amministrazione di SearchWP è abilitata.

Sinonimi

searchwp\synonyms
SearchWP utilizza i sinonimi sia per ottimizzare l'indice che per aumentare la pertinenza dei risultati di ricerca. Il metodo principale per personalizzare l'elenco dei sinonimi è tramite la scheda Impostazioni della schermata delle impostazioni di SearchWP. È tuttavia possibile filtrare programmaticamente anche i sinonimi.

Attributo

searchwp\source\attribute\label
Personalizza l'etichetta dell'attributo della sorgente

Licenza

searchwp\license\key
Definisci programmaticamente la tua chiave di licenza.

Nativo

searchwp\native\short_circuit
Controlla se SearchWP sovrascrive le ricerche native di WordPress.

Impostazioni

searchwp\settings\capability
Controlla la capability necessaria per modificare le impostazioni di SearchWP.

SWP_Query

searchwp\swp_query\args
Modifica gli argomenti utilizzati durante l'istanziazione di SWP_Query.

Varie

searchwp\auto_update_providers
Nota: Questo hook è applicabile solo quando si cambiano manualmente i siti in un ambiente Multisite. SearchWP è in grado di eseguire ricerche Multisite ma se stai cambiando manualmente i siti usando switch_to_blog() devi informare SearchWP. Questo non avviene automaticamente ed è un requisito opt-in quando si usa switch_to_blog()! Senza questo hook, SearchWP […]
searchwp\extensions
Registra un'estensione da utilizzare in SearchWP, specificamente nel menu Estensioni dell'interfaccia utente delle impostazioni di SearchWP.
searchwp\integration\wp-all-import
Per impostazione predefinita, SearchWP gestirà automaticamente i processi eseguiti da WP All Import secondo il metodo discusso qui: Come integrare con importazioni/migrazioni di contenuti. Puoi usare questo hook per impedire a SearchWP di integrarsi automaticamente con i processi di WP All Import se preferisci implementare qualcosa da solo.
searchwp\missing_integration_notices
Per impostazione predefinita, SearchWP verificherà la presenza di estensioni di integrazione mancanti. Puoi disabilitare questo comportamento con questo hook.
searchwp\nuke_on_delete
Se SearchWP elimina tutti i dati alla disinstallazione
searchwp\options\dashboard_stats_link
Controlla se appare il link alle Statistiche di SearchWP.
searchwp\options\settings_screen
Controlla se appare la pagina delle opzioni di SearchWP.
searchwp\post__in
Controlla un limitatore globale per gli ID di \WP_Post considerati durante l'indicizzazione e la ricerca.
searchwp\post__not_in
Controlla un'esclusione globale degli ID di \WP_Post da considerare durante l'indicizzazione e la ricerca.
searchwp\post_stati
Controlla gli stati dei post considerati per le Fonti basate su \WP_Post. Nota che affinché questo hook abbia effetto, devi comprendere come funziona l'Indice di SearchWP. L'Indice rappresenta il pool 'massimo' di potenziali risultati e le Query vengono eseguite contro questo Indice per limitare le voci restituite. Detto questo, per personalizzare quali post […]
searchwp\sources
Controlla quale contenuto può essere indicizzato e cercato da SearchWP.
searchwp\valid_html_tags
Controlla quali tag HTML SearchWP considererà durante l'estrazione del contenuto da indicizzare.
searchwp\weights
Personalizza gli intervalli di peso disponibili durante la configurazione degli attributi di origine del motore SearchWP.

Crea Oggi Stesso una Migliore Esperienza di Ricerca WordPress

Non perdere mai più visitatori a causa di risultati di ricerca inutili. SearchWP rende la creazione della tua ricerca intelligente WordPress veloce e facile.

Get SearchWP Now
Icona di motori di ricerca multipli