SearchWP Documentation

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

Shortcode

Versione attuale: 1.8.5

Questa estensione fornisce Shortcode che generano sia moduli di ricerca che pagine dei risultati per i motori di ricerca SearchWP. È utile se non ti senti a tuo agio (o non sei in grado) di modificare direttamente i file del tema per implementare i tuoi moduli di ricerca e i loop dei risultati.

Dopo aver attivato Shortcode, saranno disponibili i seguenti:

ShortcodeAttributo/i
searchwp_search_form

Genera un modulo di ricerca per un motore di ricerca specifico
target — L'azione del modulo (Predefinito è il permalink esistente)
engine — Nome del motore di ricerca (Predefinito è default)
var — Il nome della variabile della query di ricerca (Predefinito è swpquery)
button_text — Testo del pulsante del modulo (Predefinito è Search)
hide_button — "true" o "false", nasconde il pulsante di invio del modulo di ricerca
placeholder — Testo segnaposto per l'input del modulo (Predefinito è Search)
live_search — "true" o "false", forza l'attivazione/disattivazione della Ricerca Live Ajax per questo modulo, ignorando il valore dell'impostazione globale "Abilita Ricerca Live"
searchwp_search_results

Genera l'elenco dei risultati di ricerca una volta inviata una ricerca
engine — Nome del motore di ricerca (Predefinito è default)
var — Il nome della variabile della query di ricerca (Predefinito è swpquery)
posts_per_page — Quanti post per pagina visualizzare

Nota che questo non è uno Shortcode auto-chiudente, il markup per ogni risultato di ricerca dovrebbe essere annidato all'interno, vedi l'esempio qui sotto per un esempio
searchwp_search_result_link

Genera un link al risultato di ricerca corrente con il testo del titolo del risultato
direct — "true" o "false", quando true collega direttamente al permalink, se è un allegato collega direttamente al suo URL, non alla pagina genitore
searchwp_search_result_excerpt

Genera l'estratto per il risultato di ricerca corrente
Nessuno
searchwp_search_results_none

Output se non sono stati trovati risultati di ricerca
Nessuno

Nota che questo non è uno Shortcode auto-chiudente, il markup per ogni risultato di ricerca dovrebbe essere annidato all'interno, vedi l'esempio qui sotto per un esempio
searchwp_search_results_pagination

Genera la paginazione dei risultati di ricerca
engine — Nome del motore di ricerca (Predefinito è default)
direction — "prev" o "next"
link_text — Il testo da utilizzare nel link
var — Il nome della variabile della query di ricerca (Predefinito è swpquery)
searchwp_search_results_paginate_links

Genera i link paginati per i risultati di ricerca
engine — Nome del motore di ricerca (predefinito: default)
var — Il nome della variabile della query di ricerca (predefinito: swpquery)
Oltre a quanto sopra, sono supportati anche gli argomenti di paginate_links.
searchwp_search_result_image

Mostra l'immagine in evidenza per il risultato corrente
size — Dimensione dell'immagine (predefinita: thumb)
searchwp_search_result_permalink

Mostra il permalink per il risultato corrente con il testo del permalink del risultato
direct — Se collegarsi direttamente ai file multimediali (predefinito: 'true')
searchwp_total_results

Mostra il numero totale di risultati per la ricerca corrente
engine — Nome del motore di ricerca (predefinito: default)
var — Il nome della variabile della query di ricerca (predefinito: swpquery)
text — Il testo da utilizzare accanto al numero di risultati. Supporta i segnaposto %total% e %query% per una formattazione precisa.[searchwp_total_results text="Trovati %total% risultati per %query%"] si converte in “Trovati 0 risultati per esempio di ricerca”.

Ecco un esempio di implementazione completa degli Shortcode che cerca in un motore supplementare chiamato my_test_engine:

<h3>Search Form</h3>
[searchwp_search_form engine="my_test_engine" target="http://example.com/supplemental-search/" var="swpquery" button_text="Find Results"]
<div class="search-results-wrapper">
[searchwp_total_results text="Found %total% results for %query%" engine="my_test_engine" var="swpquery"]
[searchwp_search_results engine="my_test_engine" var="swpquery" posts_per_page=10]
<h2>[searchwp_search_result_link direct="true"]</h2>
[searchwp_search_result_excerpt]
[/searchwp_search_results]
</div>
<div class="no-search-results-found">
[searchwp_search_results_none]
No results found, please search again.
[/searchwp_search_results_none]
</div>
<div class="search-results-pagination">
[searchwp_search_results_pagination direction="prev" link_text="Previous" var="swpquery" engine="my_test_engine"]
[searchwp_search_results_pagination direction="next" link_text="Next" var="swpquery" engine="my_test_engine"]
</div>
view raw gistfile1.html hosted with ❤ by GitHub

Puoi personalizzare gli attributi secondo la tabella sopra.

Registro Modifiche

1.8.5

  • [Correzione] Attributo FOR dell'etichetta non corrispondente all'ID dell'input quando viene utilizzata una variabile di ricerca personalizzata.

1.8.4

  • [Nuovo] Aggiunta opzione per nascondere il pulsante di invio.

1.8.3

  • [Nuovo] Compatibilità con la Ricerca Ajax Live.
  • [Miglioramento] Lo shortcode searchwp_total_results supporta personalizzazioni del testo.

1.8.2

  • [Correzione] Prevenzione di errori dovuti a ricorsione di Shortcode.
  • [Aggiornamento] Aggiornatore aggiornato.

1.8.1

  • [Correzione] Attributo posts_per_page non riflesso quando si utilizza SearchWP 4.

1.8.0

  • [Nuovo] Nuovo Shortcode searchwp_search_results_paginate_links per i link paginati.
  • [Nuovo] Nuovo Shortcode searchwp_search_result_image per l'output dell'immagine in evidenza del risultato.
  • [Nuovo] Nuovo Shortcode searchwp_search_result_permalink per l'output del permalink del risultato.
  • [Aggiornamento] Aggiornatore aggiornato.

1.7.0

  • [Nuovo] Compatibilità con SearchWP 4.

1.6.1

  • [Correzione] Problema nella gestione delle virgolette.

1.6

  • [Nuovo] Nuovo Shortcode: searchwp_total_results per mostrare il numero totale di risultati di ricerca.
  • [Nuovo] Aggiunge l'argomento placeholder allo Shortcode searchwp_search_form.
  • [Aggiornamento] Aggiornatore aggiornato.

1.5.4

  • [Correzione] Controlli aggiuntivi per prevenire la rideclarazione di funzioni in casi limite.
  • [Aggiornamento] Aggiornatore aggiornato.

1.5.3

  • [Nuovo] Nuovo filtro: searchwp_shortcodes_engine.
  • [Nuovo] Nuovo filtro: searchwp_shortcodes_paginate_links.
  • [Nuovo] Nuovo filtro: searchwp_shortcodes_pagination_prev.
  • [Nuovo] Nuovo filtro: searchwp_shortcodes_pagination_next.
  • [Aggiornamento] Aggiornato updater.

1.5.1

  • [Nuovo] Nuovo Shortcode [searchwp_search_result_excerpt_global].
  • [Nuovo] Nuovo Shortcode [searchwp_search_result_excerpt_document].
  • [Miglioramento] Escaping raffinato per abbinarsi meglio a Term Highlight.

1.5

  • [Miglioramento] Supporto per aggiornamenti automatici basati sulla tua chiave di licenza SearchWP.

1.2.1

  • [Nuovo] Aggiunto un numero di azioni durante l'output.

1.2

  • [Modifica] Consenti l'impostazione della variabile GET nell'attributo Shortcode, tra le altre cose.

1.1

  • [Correzione] Corretto un problema per cui gli attributi non venivano passati alla callback dello Shortcode.

1.0

  • Rilascio iniziale.

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