Guia de Migração

Sumário

Hooks
- Referência
Alterações
Instalação
Configurações

Este guia de migração foi projetado para ajudar na transição de SearchWP 3.x (e anteriores) para SearchWP 4.

Observação: sua chave de licença é a mesma para SearchWP 3.x e SearchWP 4

Observação: SearchWP 4 é um lançamento principal que quebra a compatibilidade com versões anteriores

(exceto para SWP_Query, que não foi alterado)

Como esta é uma versão principal que quebrou a compatibilidade com versões anteriores, é altamente recomendado que uma migração seja realizada primeiro em um servidor de staging para garantir que o processo ocorra sem problemas antes que a migração seja realizada em um servidor de produção.

Observação: Motores, configurações, Stopwords e Sinônimos do SearchWP 3 serão migrados ao ativar o SearchWP 4.

O processo de migração pode ser dividido nas seguintes etapas que você precisará seguir:

Revisar este guia de migração na íntegra.
Garantir que todas as Extensões instaladas foram atualizadas para suas versões mais recentes.
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.
  Observação: Por favor, revise a documentação para todos os hooks, pois alguns parâmetros foram alterados!
Baixando o SearchWP 4 da sua Conta.
Desativando e excluindo* (veja a nota abaixo!) o SearchWP 3.x da sua instalação do WordPress.
Instalando e ativando o SearchWP 4.
Automatic migration of settings from SearchWP 3.x to SearchWP 4 upon activation.
Observação: os pesos de relevância de atributos agora têm três segmentos, e o controle deslizante de peso exibirá o segmento de peso mais próximo. Isso pode parecer diferente para você se você personalizou pesos, mas os pesos reais da v3 serão retidos até que sejam alterados e os Motores sejam salvos novamente.
Construindo o índice inicial do SearchWP 4.
Testando a funcionalidade.

* Se você marcou a caixa de seleção para remover todos os dados do SearchWP na desinstalação, seus dados serão excluídos. Desmarque a caixa de seleção, se necessário.

Se a caixa de seleção não estiver marcada e você não estiver usando o hook searchwp_nuke_on_delete para habilitar o recurso, todos os seus dados do SearchWP permanecerão intactos e utilizáveis caso você decida reinstalar o SearchWP 3.x a qualquer momento.

Hooks

Uma das alterações que quebram a compatibilidade do SearchWP 3.x para o SearchWP 4 é que todos os hooks foram re-etiquetados. Alguns hooks foram renomeados, mas funcionam da mesma forma. Outros hooks foram completamente removidos.

Por favor, revise todos os seus hooks ao atualizar as etiquetas revisando a documentação de cada um. Algumas podem ser uma simples alteração de etiqueta, outras uma simples alteração de parâmetro, mas alguns hooks supérfluos na v3 foram removidos em favor de um hook novo e mais adequado. Por favor, teste cada um dos seus hooks individualmente. ?

Há uma tabela de referência de hooks disponível abaixo.

Alterações do SearchWP 3

O índice e o indexador do SearchWP foram completamente reconstruídos, incluindo o processo em segundo plano. Dito isso, há paridade de recursos entre ambas as versões. Elas operam de maneiras semelhantes no geral, mas há algumas alterações (significativas) que você deve estar ciente.

Mídia Pais

No SearchWP, quando a transferência/atribuição de peso do pai estava habilitada, a Mídia sem pai era omitida dos resultados. O SearchWP 4 agora retorna esses resultados para que não sejam perdidos.

Se você prefere que a Mídia sem pai (quando a transferência de peso do pai está habilitada) seja descartada do conjunto de resultados, você pode 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

Termos de Taxonomia

No SearchWP 3, apenas term_name era indexado por padrão. Com base no feedback dos clientes, esse comportamento mudou para incluir todo o objeto WP_Term, que inclui o slug, description e outros dados anexados a cada WP_Term que o SearchWP indexa.

Se você quiser reverter esse comportamento, este snippet fará exatamente isso: https://gist.github.com/jchristopher/0ecc4c6ed172f64e7a97748026266e32

Instalação

O SearchWP 4 é uma versão principal que também é uma reescrita completa do SearchWP 3.x. As alterações associadas exigem que o SearchWP 3.x seja desativado e excluído antes de instalar o SearchWP 4.

Recomenda-se que o SearchWP 3.x seja excluído usando a página de Plugins na sua instalação do WordPress após ser desativado.

Nota: Há uma configuração na aba Avançado da tela de configurações do SearchWP 3.x que, quando marcada, removerá permanentemente todos os dados do SearchWP na instalação. Há também um hook: searchwp_nuke_on_delete.

Se você não quiser que seus dados sejam excluídos na desinstalação, por favor, certifique-se de que tanto a caixa de seleção esteja desmarcada quanto o hook ausente.

A menos que você tenha optado por ter seus dados do SearchWP 3.x removidos permanentemente na exclusão do plugin, seu índice e configurações do SearchWP 3.x permanecerão intactos durante todo esse processo e estarão disponíveis caso você decida reverter para o SearchWP 3.x a qualquer momento.

Se após a atualização você quiser remover permanentemente os dados do SearchWP 3.x (mantendo seus dados do SearchWP 4), você pode usar esta Extensão: Remoção de Dados Legados.

Configurações

Quando ativado, o SearchWP 4 detectará, migrará e importará todas as suas configurações existentes, por exemplo, configuração de Engine.

Seu índice existente não será migrado diretamente, pois o formato mudou significativamente. Após a ativação, o SearchWP 4 começará a reconstruir seu índice usando seus engines migrados. Assim que o índice for construído, sua migração estará completa!

Você deve testar algumas pesquisas para garantir a funcionalidade e, se encontrar algum problema, abra um ticket de suporte o mais rápido possível.

Por favor, note que, a menos que você tenha optado por remover seus dados do SearchWP 3.x, eles ainda estarão disponíveis removendo completamente o SearchWP 4 e reinstalando o SearchWP 3.x. Um link de download estará sempre disponível em sua Conta.

Referência de Migração de Hooks

SearchWP 3.x	SearchWP 4
Ações
`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 Gerais
`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` e `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 ver Artigo da Base de Conhecimento
`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`	Partial equivalent: `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`

Processamento de Documentos
`searchwp_file_content_limit`	`searchwp\source\attachment\attribute\document_content\display_limit`
`searchwp_purge_document_content`	Ver trecho

Realce
`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

Configurações UI
`searchwp_engine_content_type_label`	`searchwp\source\attribute\label`