Guía de migración

Tabla de contenidos

Hooks
- Referencia
Cambios
Instalación
Ajustes

Esta guía de migración está diseñada para ayudar en la transición de SearchWP 3.x (y versiones anteriores) a SearchWP 4.

Nota: su clave de licencia es la misma para SearchWP 3.x y SearchWP 4

Nota: SearchWP 4 es una versión principal que rompe la compatibilidad con versiones anteriores

(excepto SWP_Query, que no ha cambiado)

Dado que se trata de una versión principal que ha roto la compatibilidad con versiones anteriores, se recomienda encarecidamente que la migración se realice primero en un servidor de staging para garantizar que el proceso se desarrolle sin problemas antes de que la migración se realice en un servidor de producción.

Nota: los motores, la configuración, las palabras vacías y los sinónimos de SearchWP 3 se migrarán al activar SearchWP 4.

El proceso de migración se puede desglosar en los siguientes pasos que deberá seguir:

Revisar esta guía de migración en su totalidad.
Asegurarse de que todas las extensiones instaladas se hayan actualizado a sus últimas versiones.
Auditing all hooks in use both in your theme and any custom plugins.
- Updating all existing hooks to SearchWP 4 equivalents, reaching out to support if any problems arise.
  Nota: ¡Revise la documentación de todos los hooks ya que algunos parámetros han cambiado!
Descargar SearchWP 4 desde su Cuenta.
Desactivar y eliminar* (¡ver nota abajo!) SearchWP 3.x de su instalación de WordPress.
Instalar y activar SearchWP 4.
Automatic migration of settings from SearchWP 3.x to SearchWP 4 upon activation.
Nota: los pesos de relevancia de atributos ahora tienen tres segmentos, y el control deslizante de peso mostrará el segmento de peso más cercano. Esto puede parecerle diferente si ha personalizado los pesos, pero los pesos reales de la v3 se conservarán hasta que se cambien y se vuelvan a guardar los motores.
Crear el índice inicial de SearchWP 4.
Probar la funcionalidad.

* Si ha marcado la casilla para eliminar todos los datos de SearchWP al desinstalar, sus datos se eliminarán. Desmarque la casilla si es necesario.

Si la casilla no está marcada y no está utilizando el hook searchwp_nuke_on_delete para habilitar la función, todos sus datos de SearchWP permanecerán intactos y utilizables si decide reinstalar SearchWP 3.x en cualquier momento.

Hooks

Uno de los cambios importantes de SearchWP 3.x a SearchWP 4 es que todos los hooks se han reetiquetado. Algunos hooks han sido renombrados pero funcionan igual. Otros hooks han sido eliminados por completo.

Por favor, revise todos sus hooks mientras actualiza las etiquetas revisando la documentación de cada uno. Algunos pueden ser un simple cambio de etiqueta, otros un simple cambio de parámetro, pero algunos hooks superfluos en la v3 han sido eliminados en favor de un hook nuevo y más adecuado. Por favor, pruebe cada uno de sus hooks individualmente. ?

Hay una tabla de referencia de hooks disponible abajo.

Cambios de SearchWP 3

El índice y el indexador de SearchWP se han reconstruido por completo, incluido el proceso en segundo plano. Dicho esto, existe paridad de funciones entre ambas versiones. Operan de manera similar en general, pero hay algunos cambios (significativos) que debe tener en cuenta.

Media Parents

En SearchWP, cuando la transferencia/atribución de peso de los padres estaba habilitada, los medios sin padre se omitían de los resultados. SearchWP 4 ahora devuelve esos resultados para que no se pierdan.

Si prefiere que los medios sin padre (cuando la transferencia de peso de los padres está habilitada) se eliminen del conjunto de resultados, puede usar este hook:

	<?php

	// Tell SearchWP to drop Media with no parent when Parent Attribution has been enabled.
	// This was the default behavior in SearchWP 3 but has changed in SearchWP 4.
	add_filter( 'searchwp\source\post\attachment\parent_attribution\strict', '__return_true' );

view raw searchwp-customizations.php hosted with ❤ by GitHub

Términos de taxonomía

En SearchWP 3, solo se indexaba term_name por defecto. Según los comentarios de los clientes, este comportamiento ha cambiado para incluir el objeto WP_Term completo, que incluye el slug, la description y otros datos adjuntos a cada WP_Term que SearchWP indexa.

Si desea revertir este comportamiento, este fragmento hará exactamente eso: https://gist.github.com/jchristopher/0ecc4c6ed172f64e7a97748026266e32

Instalación

SearchWP 4 es una versión importante que también es una reescritura completa de SearchWP 3.x. Los cambios asociados requieren que SearchWP 3.x se desactive y se elimine antes de instalar SearchWP 4.

Se recomienda eliminar SearchWP 3.x utilizando la página de Plugins en su instalación de WordPress después de que se desactive.

Nota: Hay una configuración en la pestaña Avanzado de la pantalla de configuración de SearchWP 3.x que, al marcarla, eliminará permanentemente todos los datos de SearchWP al instalar. También hay un hook: searchwp_nuke_on_delete.

Si no desea que sus datos se eliminen al desinstalar, asegúrese de que tanto la casilla de verificación no esté marcada como de que el hook esté ausente.

A menos que haya optado por que sus datos de SearchWP 3.x se eliminen permanentemente al eliminar el plugin, su índice y configuración de SearchWP 3.x permanecerán intactos durante este proceso y estarán disponibles si decide volver a SearchWP 3.x en cualquier momento.

Si después de actualizar desea eliminar permanentemente los datos de SearchWP 3.x (manteniendo sus datos de SearchWP 4), puede usar esta Extensión: Eliminación de datos heredados.

Ajustes

Cuando se active, SearchWP 4 detectará, migrará e importará toda su configuración existente, por ejemplo, la configuración del motor.

Su índice existente no se migrará directamente, ya que el formato ha cambiado significativamente. Al activarse, SearchWP 4 comenzará a reconstruir su índice utilizando sus motores migrados. ¡Una vez que el índice se haya construido, su migración estará completa!

Debería probar algunas búsquedas para asegurar la funcionalidad y, si encuentra algún problema, abra un ticket de soporte a la mayor brevedad.

Tenga en cuenta que a menos que haya optado por eliminar sus datos de SearchWP 3.x, estos todavía están disponibles al eliminar SearchWP 4 por completo y reinstalar SearchWP 3.x. Siempre habrá un enlace de descarga disponible dentro de su Cuenta.

Referencia de migración de hooks

SearchWP 3.x	SearchWP 4
Acciones
`searchwp_after_query_index`	`searchwp\query\after`
`searchwp_before_query_index`	`searchwp\query\before`
`searchwp_index_initial_complete`	`searchwp\indexer\complete`
`searchwp_index_pdf_metadata`	`searchwp\document\pdf_metadata\skip`
`searchwp_index_post`	`searchwp\index\add`
`searchwp_index_up_to_date`	N/A
`searchwp_indexer_loopback`	N/A
`searchwp_indexer_post_chunk`	`searchwp\indexer\batch`
`searchwp_indexer_posts`	`searchwp\indexer\has_updates`
`searchwp_indexer_pre`	`searchwp\indexer\init`
`searchwp_indexer_pre_chunk`	`searchwp\indexer\batch`
`searchwp_indexer_pre_get_comments`	N/A
`searchwp_indexer_running`	`searchwp\process\begin`
`searchwp_load`	`searchwp\init`
`searchwp_loaded`	`searchwp\loaded`
`searchwp_log`	`searchwp\debug\log`
`searchwp_revised_search_query`	`searchwp\query\ran`
`searchwp_settings_after_header`	`searchwp\settings\header\after`
`searchwp_settings_after\{$view}`	`searchwp\settings\after\{$view}`
`searchwp_settings_before_header`	`searchwp\settings\header\before`
`searchwp_settings_before\{$view}`	`searchwp\settings\before\{$view}`
`searchwp_settings_engines`	`searchwp\settings\view\default`
`searchwp_settings_footer`	`searchwp\settings\footer`
`searchwp_settings_init`	`searchwp\settings\init`
`searchwp_settings_nav_tab`	`searchwp\settings\nav\tab`
`searchwp_settings_view\{$view}`	`searchwp\settings\view\{$view}`
`searchwp_dashboard_widget`	`searchwp\admin\dashboard_widgets\statistics`
`searchwp_swp_query_shutdown`	`searchwp\swp_query\shutdown`

Filtros Generales
`searchwp_admin_bar`	`searchwp\admin_bar`
`searchwp_dashboard_widget_cap`	`searchwp\statistics\capability`
`searchwp_debug`	`searchwp\debug`
`searchwp_debug_detailed`	N/A
`searchwp_debug_include_pid`	N/A
`searchwp_extensions`	`searchwp\extensions`
`searchwp_failed_index_notice`	N/A
`searchwp_init`	`searchwp\loaded`
`searchwp_initial_engine_settings`	`searchwp\install\engine\settings`
`searchwp_license_key`	`searchwp\license\key`
`searchwp_locale_override`	`locale`
`searchwp_missing_integration_notices`	`searchwp\missing_integration_notices`
`searchwp_nuke_on_delete`	`searchwp\nuke_on_delete`
`searchwp_settings_cap`	`searchwp\settings\capability`
`searchwp_show_conflict_notices`	N/A
`searchwp_show_filter_conflict_notices`	N/A
`searchwp_skip_vendor_libs`	N/A
`searchwp_statistics_cap`	`searchwp\statistics\capability`
`searchwp_statistics_popular_days_{$days}`	`searchwp\statistics\popular\days_{$days}`

Indexador
`searchwp_aggressive_delta_update`	`searchwp\index\aggressive_delta`
`searchwp_alternate_indexer`	`searchwp\indexer\alternate`
`searchwp_auto_reindex`	`searchwp\index\process\enabled` y `searchwp\indexer\paused`
`searchwp_background_deltas`	`searchwp\index\process\enabled`
`searchwp_basic_auth_creds`	`searchwp\indexer\http_basic_auth_credentials`
`searchwp_custom_field_{$key}`	`searchwp\source\post\attributes\meta\{$key}`
`searchwp_custom_fields`	`searchwp\source\post\attributes\meta`
`searchwp_custom_stemmer`	`searchwp\stemmer\custom`
`searchwp_do_blocks`	`searchwp\source\post\attributes\content\do_blocks`
`searchwp_do_shortcode`	`searchwp\source\post\attributes\content\do_shortcodes`
`searchwp_endpoint`	N/A
`searchwp_exclude_common`	N/A
`searchwp_excluded_custom_fields`	`searchwp\source\post\attributes\meta\ignored`
`searchwp_exclusive_regex_matches`	`searchwp\tokens\tokenize_pattern_matches`
`searchwp_external_pdf_processing`	`searchwp\parser\pdf`
`searchwp_extra_metadata`	N/A véase Artículo de la base de conocimientos
`searchwp_get_custom_fields`	N/A
`searchwp_include_comment_author`	`searchwp\source\post\attributes\comments\author`
`searchwp_include_comment_email`	`searchwp\source\post\attributes\comments\email`
`searchwp_index_attachments`	N/A
`searchwp_index_chunk_size`	`searchwp\indexer\batch_size`
`searchwp_index_comments`	N/A
`searchwp_index_emoji`	`searchwp\allow_emoji`
`searchwp_indexed_post_types`	Equivalente parcial: `searchwp\sources`
`searchwp_indexer_additional_meta_exclusions`	N/A
`searchwp_indexer_apply_engines_rules`	N/A
`searchwp_indexer_comment`	`searchwp\source\post\attributes\comment`
`searchwp_indexer_comments_args`	`searchwp\source\post\attributes\comments\args`
`searchwp_indexer_enabled`	N/A
`searchwp_indexer_excluded_by_rules`	N/A
`searchwp_indexer_load_monitoring`	N/A
`searchwp_indexer_loopback_args`	`searchwp\indexer\loopback\args`
`searchwp_indexer_max_attempts`	N/A
`searchwp_indexer_paused`	N/A
`searchwp_indexer_pre_process_content`	`searchwp\source\post\attributes\content`
`searchwp_indexer_tag_attributes`	`searchwp\valid_html_tags`
`searchwp_indexer_taxonomies`	N/A
`searchwp_indexer_taxonomy_term`	`searchwp\source\post\attributes\taxonomy\term`
`searchwp_indexer_taxonomy_term_index_slug`	N/A
`searchwp_indexer_taxonomy_terms`	`searchwp\source\post\attributes\taxonomy\terms`
`searchwp_indexer_throttle`	N/A
`searchwp_indexer_unindexed_args`	`searchwp\post__in` `searchwp\post__not_in`
`searchwp_indexer_unindexed_media_args`	`searchwp\post__in` `searchwp\post__not_in`
`searchwp_is_attribute_used`	N/A
`searchwp_is_used_meta_key`	N/A
`searchwp_is_used_taxonomy`	N/A
`searchwp_keyword_stem_locale`	N/A
`searchwp_lenient_accents`	`searchwp\tokens\strict`
`searchwp_lenient_accent_result`	`searchwp\tokens\removed_accents`
`searchwp_lenient_accents_conversions`	N/A
`searchwp_load_maximum`	N/A
`searchwp_max_delta_attempts`	N/A
`searchwp_max_index_attempts`	N/A
`searchwp_mimes_{$mime_type_group}`	N/A
`searchwp_minimum_word_length`	`searchwp\tokens\minimum_length`
`searchwp_omit_document_processing`	N/A
`searchwp_omit_meta_key`	N/A
`searchwp_omit_meta_key_{$custom_field_key}`	N/A
`searchwp_omit_wp_metadata`	N/A
`searchwp_pdf_metadata`	N/A
`searchwp_pdf_spaces_to_content_percentage`	N/A
`searchwp_post_statuses`	`searchwp\post_stati`
`searchwp_pre_set_post`	N/A
`searchwp_prevent_indexing`	`searchwp\post__not_in`
`searchwp_process_term_limit`	`searchwp\index\tokens_max`
`searchwp_remove_pre_get_posts`	N/A
`searchwp_sanitize_terms`	N/A
`searchwp_set_post`	N/A
`searchwp_stopwords`	`searchwp\stopwords`
`searchwp_term_count_limit`	`searchwp\index\tokens_max`
`searchwp_term_pattern_whitelist`	`searchwp\tokens\regex_patterns`
`searchwp_timeout`	`searchwp\indexer\loopback\args`

Filtros de consulta
`searchwp_allow_quoted_phrase_search`	`searchwp\query\logic\phrase`
`searchwp_and_fields`	N/A
`searchwp_and_fields_{$post_type}`	N/A
`searchwp_and_logic`	`searchwp\query\logic\and`
`searchwp_and_logic_only`	`searchwp\query\logic\and\strict`
`searchwp_auto_output_revised_search_query`	`searchwp\query\output_suggested_search`
`searchwp_big_selects`	N/A
`searchwp_custom_field_keys`	`searchwp\source\attribute\options`
`searchwp_debug_append_weights_to_titles`	N/A
`searchwp_disable_impose_engine_config`	N/A
`searchwp_do_suggestions`	`searchwp\query\partial_matches\did_you_mean`
`searchwp_enable_attribution_{post_type}`	`searchwp\source\post\{$post_type}\attribution`
`searchwp_enable_parent_attribution_{post_type}`	`searchwp\source\post\{$post_type}\parent_attribution`
`searchwp_engine_settings_{engine}`	N/A
`searchwp_exclude`	`searchwp\post__not_in`
`searchwp_exclude_common`	N/A
`searchwp_force_run`	N/A
`searchwp_force_wp_query`	N/A
`searchwp_force_wpquery_order`	N/A
`searchwp_found_post_objects`	N/A
`searchwp_fuzzy_digit_threshold`	N/A
`searchwp_fuzzy_min_length`	`searchwp\query\partial_matches\fuzzy\minimum_length`
`searchwp_fuzzy_threshold`	`searchwp\query\partial_matches\fuzzy\threshold`
`searchwp_in_admin`	N/A
`searchwp_include`	`searchwp\post__in`
`searchwp_like_min_length`	`searchwp\query\partial_matches\minimum_length`
`searchwp_like_stem`	N/A
`searchwp_like_wildcard_after`	`searchwp\query\partial_matches\wildcard_after`
`searchwp_like_wildcard_before`	`searchwp\query\partial_matches\wildcard_before`
`searchwp_load_posts`	N/A
`searchwp_log_search`	`searchwp\statistics\log`
`searchwp_max_and_results`	N/A
`searchwp_max_search_terms`	`searchwp\query\tokens\limit`
`searchwp_max_search_terms_{$engine}`	N/A
`searchwp_max_search_terms_supplemental`	N/A
`searchwp_partial_matches_force_fuzzy`	`searchwp\query\partial_matches\force_fuzzy`
`searchwp_partial_matches_lenient`	`searchwp\query\partial_matches\force`
`searchwp_partial_matching_{$engine}`	N/A
`searchwp_persist_extra_metadata`	N/A
`searchwp_posts_per_page`	`searchwp\query\per_page`
`searchwp_pre_search_terms`	`searchwp\query\tokens`
`searchwp_query_allow_query_string_override_order`	`searchwp\query\mods`
`searchwp_query_allow_query_string_override_orderby`	`searchwp\query\mods`
`searchwp_query_conditions`	`searchwp\query\mods`
`searchwp_query_join`	`searchwp\query\mods`
`searchwp_query_limit_start`	`searchwp\query\mods`
`searchwp_query_limit_total`	`searchwp\query\mods`
`searchwp_query_main_join`	`searchwp\query\mods`
`searchwp_query_offset`	`searchwp\query\mods`
`searchwp_query_orderby`	`searchwp\query\mods`
`searchwp_query_results`	`searchwp\query\results`
`searchwp_query_select_inject`	`searchwp\query\mods`
`searchwp_refine_and_results`	N/A
`searchwp_remove_pre_get_posts_during_search`	N/A
`searchwp_results`	`searchwp\query\results`
`searchwp_return_orderby_date`	`searchwp\query\mods`
`searchwp_return_orderby_random`	`searchwp\query\mods`
`searchwp_search_args`	`searchwp\query\args`
`searchwp_search_query_order`	`searchwp\query\mods`
`searchwp_short_circuit`	`searchwp\native\short_circuit`
`searchwp_swp_query_post__in_explicit`	N/A
`searchwp_swp_query_post__not_in_explicit`	N/A
`searchwp_term_in`	`searchwp\query\tokens`
`searchwp_terms`	`searchwp\query\search_string`
`searchwp_weight_max`	N/A
`searchwp_weight_mods`	`searchwp\query\mods`
`searchwp_weight_threshold`	`searchwp\query\min_relevance`
`searchwp_where`	`searchwp\query\mods`

Procesamiento de documentos
`searchwp_file_content_limit`	`searchwp\source\attachment\attribute\document_content\display_limit`
`searchwp_purge_document_content`	Ver fragmento

Resaltado
`searchwp_term_highlight_break_on_first_match`	N/A
`searchwp_term_highlight_occurrence`	N/A
`searchwp_th_auto_filter_excerpt`	N/A
`searchwp_th_auto_highlight_content`	N/A
`searchwp_th_do_shortcode`	N/A
`searchwp_th_excluded_engines`	N/A
`searchwp_th_num_words`	N/A
`searchwp_th_partial_matches`	N/A
`searchwp_th_password_required_message`	N/A
`searchwp_th_pre_process_content`	N/A
`searchwp_th_pre_process_meta_value`	N/A
`searchwp_th_strip_shortcodes`	N/A
`searchwp_th_use_span`	N/A

Interfaz de usuario de configuración
`searchwp_engine_content_type_label`	`searchwp\source\attribute\label`