Correlati

Questa estensione richiede una licenza Pro

Versione attuale: 1.5.5

Usa SearchWP per potenziare i contenuti correlati sul tuo sito!

L'estensione Correlati di SearchWP è progettata per operare con un overhead minimo, fornendo al contempo ampie opzioni di personalizzazione per soddisfare i requisiti di design e funzionalità del tuo sito. La visualizzazione di contenuti correlati ai visitatori è una strategia efficace per mantenere il coinvolgimento e incoraggiare gli utenti a esplorare ulteriori pagine sul tuo sito. Se stai attualmente utilizzando un altro sistema di contenuti correlati, Correlati di SearchWP probabilmente ridurrà l'overhead del server utilizzando l'indice di contenuto che SearchWP ha già creato.

Nota: L'algoritmo Correlati di SearchWP utilizza i titoli delle voci dei post come origine predefinita delle parole chiave per identificare e visualizzare contenuti correlati sul tuo sito, garantendo suggerimenti pertinenti e contestualmente appropriati per i tuoi visitatori.

Configurazione e integrazione

Come tutte le estensioni SearchWP, Correlati è un plugin WordPress autonomo che funziona insieme a SearchWP. Una volta installata, l'estensione Correlati rimane inattiva per impostazione predefinita finché non la configuri secondo le tue preferenze. Puoi accedere a tutte le opzioni di configurazione e personalizzare come i contenuti correlati appaiono nelle tue pagine di post navigando su Impostazioni SearchWP → Correlati nella tua area di amministrazione di WordPress.

Temi del layout

La sezione dei temi del layout fornisce stili predefiniti multipli per visualizzare il tuo blocco di contenuti correlati sul frontend del tuo sito web. Puoi passare facilmente tra diversi temi del layout e visualizzare in anteprima ogni opzione prima di salvare le modifiche per assicurarti che il design corrisponda all'estetica del tuo sito.

Minimale: Questo tema presenta un layout di elenco pulito e semplice che visualizza solo i titoli dei post disposti in un formato a griglia organizzato.

Colonne: Questo layout a griglia visualizza i risultati su più colonne, con titoli e descrizioni dei post per fornire ai visitatori maggiori informazioni su ciascun elemento correlato.

Miniatura: Questo layout combina una struttura a griglia con immagini in primo piano di grandi dimensioni accanto ai titoli dei post, creando una visualizzazione accattivante che enfatizza i contenuti visivi.

Ricco: Questa opzione di layout completa offre la presentazione più coinvolgente visivamente, con immagini di grandi dimensioni, titoli dei post e descrizioni in un attraente formato a griglia che massimizza l'attrattiva visiva e la densità delle informazioni.

Personalizzato: Questa opzione flessibile ti consente di creare un layout completamente personalizzato combinando e regolando varie impostazioni dalla sezione di configurazione dei contenuti correlati per soddisfare i tuoi specifici requisiti di design.

Stile del layout

L'impostazione dello stile del layout ti consente di scegliere tra i formati di visualizzazione a griglia e a elenco per mostrare i tuoi contenuti correlati. Inoltre, puoi specificare il numero esatto di risultati correlati da visualizzare all'interno di ciascun blocco di contenuti correlati, offrendoti un controllo preciso sulla quantità di contenuti presentati ai visitatori.

Titolo del Blocco

L'impostazione del titolo del blocco determina il testo dell'intestazione che appare sopra la sezione dei contenuti correlati nel frontend. Il valore predefinito è "Contenuti Correlati", ma puoi modificarlo in base ai contenuti del tuo sito.

Immagini

Scegli la dimensione dell'immagine visualizzata con ciascun post correlato. Le opzioni di dimensione disponibili sono piccola, media e grande.

Descrizioni:
Un interruttore per mostrare o nascondere le descrizioni per i contenuti del blocco correlato.

Motore

L'impostazione del motore definisce quale motore SearchWP verrà utilizzato per determinare i tipi di post inclusi nei suggerimenti dei contenuti correlati. Solo le origini post che sono state aggiunte alle impostazioni del tuo motore selezionato saranno idonee per la visualizzazione nel blocco di contenuti correlati.

Funzionalità di Auto-Aggiunta

La funzionalità di auto-aggiunta ti consente di selezionare tipi di post specifici in cui il blocco di contenuti correlati apparirà automaticamente nelle pagine dei post senza richiedere un posizionamento manuale. Solo i tipi di post che sono stati aggiunti al tuo motore SearchWP saranno disponibili per la selezione in questa impostazione.

Puoi anche specificare la posizione esatta in cui i contenuti correlati dovrebbero apparire nelle tue pagine, con opzioni per visualizzare il blocco in fondo al tuo contenuto o dopo un paragrafo specifico all'interno del contenuto del tuo post.

Escludi Voci

L'opzione escludi voci fornisce un controllo granulare su quali post appaiono nei tuoi suggerimenti di contenuti correlati. Puoi escludere ID di post specifici dall'apparire in qualsiasi blocco di contenuti correlati sul tuo sito.

In alternativa, selezionando l'opzione "Cerca solo ID selezionati", puoi limitare i contenuti correlati a un elenco definito di post.

Incorporamento del Tuo Blocco

Oltre all'opzione di auto-aggiunta, puoi incorporare il blocco Contenuti Correlati manualmente in vari modi:

Integrazione Blocco Gutenberg

Il metodo del blocco Gutenberg fornisce un'integrazione perfetta con l'editor di blocchi moderno di WordPress, consentendoti di incorporare contenuti correlati di SearchWP direttamente in qualsiasi post o pagina. Mentre modifichi qualsiasi post o pagina nell'editor di Gutenberg, cerca semplicemente il blocco "Correlati" e aggiungilo nella posizione desiderata.

Implementazione Shortcode

Puoi utilizzare lo shortcode [searchwp_related] per visualizzare contenuti correlati in qualsiasi area del tuo sito compatibile con gli shortcode.

Integrazione Widget

Per i temi che utilizzano aree sidebar con funzionalità widget, SearchWP Related fornisce un'opzione widget dedicata che ti consente di visualizzare contenuti correlati nelle aree sidebar delle tue pagine post.

Integrazione Codice PHP

Se stai lavorando con modelli di post personalizzati o file di tema, puoi implementare contenuti correlati utilizzando l'integrazione diretta del codice PHP. Questo metodo fornisce il controllo più tecnico e consente agli sviluppatori di posizionare blocchi di contenuti correlati precisamente all'interno del codice del modello di tema personalizzato e dei framework di stile.

Configurazione specifica per post

Quando selezioni tipi di post specifici nell'opzione di aggiunta automatica, impostazioni aggiuntive dell'estensione SearchWP Related diventano disponibili sotto l'intestazione “Contenuti correlati di SearchWP” nella schermata di modifica del post per quei tipi di post.

Parole chiave personalizzate

Per impostazione predefinita, l'algoritmo dei contenuti correlati analizza le parole chiave trovate nei titoli dei post per identificare suggerimenti di contenuti correlati per ciascun post. Tuttavia, l'opzione parole chiave personalizzate ti consente di specificare parole chiave alternative per trovare contenuti correlati per post specifici.

Questa funzionalità include un'anteprima “Campione dei risultati” che mostra quali post appariranno nel blocco dei contenuti correlati in base alle tue selezioni di parole chiave personalizzate, permettendoti di verificare la pertinenza dei contenuti suggeriti prima della pubblicazione.

Impostazioni di inclusione sempre

Il pulsante delle impostazioni situato a destra della sezione parole chiave personalizzate, rivela opzioni di configurazione aggiuntive, inclusa la funzionalità “Includi sempre”.

Questa potente opzione ti consente di selezionare manualmente titoli di post specifici che desideri garantire appariranno nel blocco dei contenuti correlati per il post corrente, indipendentemente dall'abbinamento algoritmico. Ciò garantisce che contenuti importanti o strategicamente correlati appaiano sempre nei tuoi suggerimenti di contenuti correlati, fornendo controllo editoriale sulle raccomandazioni automatizzate.

Personalizzazione dell'output: il caricatore di template

Come nel caso di Ricerca Live, Related utilizza un caricatore di template per consentire la piena personalizzazione dei risultati Correlati. Esiste un template predefinito che assomiglia a questo:

Screen Shot 2017-04-14 at 10.10.33 AM - SearchWP — Il template predefinito di Related corrisponderà in parte al font e ai colori del tuo tema

Nella cartella del plugin Related c'è un'altra cartella chiamata templates contenente questo template predefinito di Related (related.php) utilizzato per visualizzare i contenuti Correlati.

~/wp-content/plugins/searchwp-related/templates/related.php

Il contenuto di questo file è il seguente: related.php

Non modificare questo file direttamente. Se installi un aggiornamento di Related, qualsiasi personalizzazione apportata a questo file verrà sovrascritta!

Invece, puoi utilizzare il caricatore di template integrato in Related per aggiungere il tuo template personalizzato all'interno del tuo tema.

Per personalizzare l'output dei contenuti Correlati, crea una nuova cartella all'interno del tuo tema e incolla una copia del template predefinito di Related in quella cartella, mantenendo lo stesso nome del file:

~/wp-content/themes/my-theme/searchwp-related/related.php

Puoi personalizzare completamente questo template per soddisfare le tue esigenze. Si basa su The Loop e puoi fare qualsiasi cosa all'interno del template come faresti in qualsiasi altro template del tema.

Opzioni del template

Mentre il template utilizzato per mostrare i contenuti Correlati è per lo più un template standard del tema, puoi influenzare il comportamento di Related modificando il blocco commenti opzionale in cima al file:

/** * SearchWP Engine: default * Maximum Results: 3 */<code></code>

Puoi personalizzare il motore SearchWP utilizzato e il numero massimo di voci Correlate visualizzate modificando la riga appropriata in cima al template.

Puoi anche personalizzare i template dei risultati per tipo di post aggiungendo un trattino e il tipo di post al nome del file. Ad esempio, se creassi un template con questo nome file:

~/wp-content/themes/my-theme/searchwp-related/related-page.php

Sarebbe utilizzato solo per le Pagine. Tutti gli altri tipi di post utilizzerebbero il template di base.

Recupera programmaticamente contenuti Correlati

Se vuoi usare il caricatore di template ma in un punto diverso da quello utilizzato dalla casella di controllo di auto-aggiunta, lascia deselezionata quella casella e modifica il tuo file di template per includere quanto segue dove desideri l'output Correlato:

	<?php

	// This should be within your single.php or other applicable template that has the $post defined
	$related = new SearchWP_Related\Template();
	echo $related->get_template();

view raw single.php hosted with ❤ by GitHub

Puoi anche saltare completamente il caricatore di template e invece recuperare i contenuti Correlati direttamente nel codice del tuo tema. Ecco come puoi farlo:

	<?php

	/*
	* Programmatically find Related content from SearchWP Related
	*/

	// Instantiate SearchWP Related
	$searchwp_related = new SearchWP_Related();

	// Use the keywords as defined in the SearchWP Related meta box
	$keywords = get_post_meta( get_the_ID(), $searchwp_related->meta_key, true );

	$args = array(
	's' => $keywords, // The stored keywords to use
	'engine' => 'default', // the SearchWP engine to use
	'posts_per_page' => 3, // how many entries to find
	);

	// Retrieve Related content for the current post
	$related_content = $searchwp_related->get( $args );

	// Returns an array of Post objects for you to loop through
	print_r( $related_content );

view raw functions.php hosted with ❤ by GitHub

Ci sono una serie di argomenti che puoi passare per personalizzare come Correlati troverà i contenuti correlati, ecco una ripartizione completa degli argomenti possibili:

	<?php

	// Use the saved keywords from the meta box
	$keywords = get_post_meta( get_the_ID(), $searchwp_related->meta_key, true );

	$defaults = array(
	'engine' => 'default', // Engine to use
	's' => $keywords, // Terms to search
	'fields' => 'all', // Return post objects, use 'ids' to return IDs
	'posts_per_page' => 3, // How many results to return
	'log' => false, // Log the search?
	'post__in' => array(), // Limit results pool?
	'post__not_in' => array() // Exclude posts from results?
	);

view raw functions.php hosted with ❤ by GitHub

Si suggerisce di impostare una qualche forma di caching (ad es. tramite Transient) per ridurre l'utilizzo delle risorse.

Personalizzazione dell'input: definizione dei contenuti Correlati

Correlati per impostazione predefinita costruirà un elenco di parole chiave dal titolo delle tue voci. Le parole comuni vengono rimosse per aumentare la pertinenza dei risultati Correlati. Su ogni schermata di modifica della voce, Correlati visualizzerà una meta box che ti permetterà di personalizzare quali parole chiave vengono utilizzate per determinare i contenuti Correlati:

searchwp-related - SearchWP — Campioni di risultati in tempo reale durante la personalizzazione delle parole chiave

Viene visualizzato un set di tre risultati di esempio, che ti consente di personalizzare le parole chiave che stai utilizzando, se lo desideri. Questo è solo un esempio, il caricatore di template controlla come vengono visualizzati i risultati sul front-end e SearchWP determina quali voci visualizzare al runtime.

I campioni di risultati includeranno tutti i motori disponibili. Se desideri limitare i campioni visualizzati solo ad alcuni motori, puoi utilizzare questo filtro:

	<?php

	// Define the engines to use for the metabox samples.
	add_filter( 'searchwp_related_meta_box_sample_engines', function( $engines ) {
	return [ 'default', 'products' ];
	} );

view raw functions.php hosted with ❤ by GitHub

Registro Modifiche

1.5.5

[Aggiornamento] Compatibilità aggiornata con WP 6.9.
[Correzione] Rimossa riga vuota extra negli elementi del menu a discesa.

1.5.4

[Correzione] Bozze, post in attesa elencati nell'opzione "Includi sempre" e potenzialmente visualizzati sul frontend.
[Aggiornamento] Aggiornatore aggiornato.

1.5.3

[Nuovo] Aggiunto hook searchwp_related_meta_box_sample_engines per filtrare i motori visualizzati nei campioni della meta box.
[Modifica] I risultati di esempio sono ora responsive.

1.5.2

[Correzione] Errore JavaScript se l'opzione "Nascondi annuncio" di SearchWP è abilitata.

1.5.1

[Modifica] Aggiunta la dicitura "Testato fino a" per indicare la compatibilità con l'ultima versione di WP
[Modifica] Rimossi file di build per evitare di attivare automazioni su alcuni sistemi
[Correzione] Errore PHP quando il plugin SearchWP non è attivo

1.5.0

[Nuovo] L'area delle impostazioni è stata rinnovata, offrendo un maggiore controllo sul contenuto e sull'aspetto visivo del blocco Correlati
[Nuovo] Aggiunti nuovo blocco Gutenberg e Shortcode per l'incorporamento manuale
[Modifica] La versione minima richiesta di SearchWP per l'estensione Related è la 4.2.6
[Modifica] Funzioni e metodi ridondanti/inutilizzati rimossi

1.4.8

[Correzione] Errore nelle versioni PHP precedenti alla 7.3 causato da una virgola finale nella chiamata di funzione
[Correzione] L'elenco dei suggerimenti non viene re-renderizzato al cambio del campo Keywords nella metabox del post
[Correzione] Avvisi di deprecazione su PHP 8.2

1.4.7

[Correzione] Errore di parsing per PHP 7.2 e versioni inferiori
[Correzione] Compatibilità con SearchWP 4.2.0 e versioni successive

1.4.6

[Nuovo] Aggiunto array di contesto a searchwp_related_default_keywords
[Correzione] Avviso PHP
[Correzione] Post esclusi nell'anteprima in alcuni casi

1.4.5

[Correzione] Render iniziale dell'anteprima

1.4.4

[Correzione] Avviso PHP, Errore in alcuni casi
[Aggiornamento] Aggiornatore aggiornato

1.4.3

[Correzione] Impedisce il logging in SearchWP Metrics quando applicabile

1.4.2

[Correzione] Corregge l'errore durante l'uso di SearchWP 4

1.4.0

[Nuovo] Aggiunge il supporto per SearchWP 4

1.3

[Nuovo] Forza voci Related specifiche per ogni voce
[Nuovo] I contenuti correlati sono ora memorizzati nella cache per 12 ore
[Nuovo] Hook per controllare la TTL della cache delle query in secondi searchwp_related_cache_length
[Nuovo] Hook per controllare se la cache viene utilizzata searchwp_related_cache_enabled
[Correzione] Auto-append non funzionante in alcuni casi
[Correzione] Paginazione non rispettata in alcuni casi
[Correzione] Parole chiave predefinite non popolate in alcuni casi
[Correzione] Link alla documentazione
[Modifica] La meta box non appare più sui tipi di post non pubblici per impostazione predefinita
[Modifica] Risultati aggiuntivi trovati se il set di risultati iniziale è troppo limitato da SearchWP
[Aggiornamento] Origine della traduzione
[Aggiornamento] Aggiornatore aggiornato

1.1.1

[Modifica] Il set di parole chiave di fallback ora è definito quando si salvano le bozze (in precedenza avveniva alla pubblicazione)

1.1

[Nuovo] Aggiunge Widget
[Nuovo] Nuovi hook per controllare il posizionamento della meta box searchwp_related_meta_box_context e searchwp_related_meta_box_priority

1.0.4

[Correzione] Risolto un problema con enqueues eccessivamente zelanti

1.0.3

[Correzione] Risolto un problema per cui le voci correlate non venivano trovate in determinate circostanze
[Aggiornamento] Aggiornatore aggiornato

1.0.2

[Correzione] Le voci appena pubblicate non vengono più saltate automaticamente se non vengono inserite parole chiave, verranno utilizzati i fallback per impostazione predefinita
[Correzione] L'implementazione del filtro searchwp_related_excluded_post_types viene ora applicata correttamente e funziona

1.0.1

[Correzione] Impedisce l'errore fatale PHP(<5.5) Impossibile usare il valore restituito dalla funzione nel contesto di scrittura

1.0.0

Rilascio iniziale

Correlati

Configurazione e integrazione

Temi del layout

Stile del layout

Incorporamento del Tuo Blocco

Configurazione specifica per post

Personalizzazione dell'output: il caricatore di template

Opzioni del template

Recupera programmaticamente contenuti Correlati

Personalizzazione dell'input: definizione dei contenuti Correlati

Registro Modifiche

1.5.5

1.5.4

1.5.3

1.5.2

1.5.1

1.5.0

1.4.8

1.4.7

1.4.6

1.4.5

1.4.4

1.4.3

1.4.2

1.4.0

1.3

1.1.1

1.1

1.0.4

1.0.3

1.0.2

1.0.1

1.0.0

Crea Oggi Stesso una Migliore Esperienza di Ricerca WordPress